enginedata.h

/* ScummVM - Graphic Adventure Engine
 *
 * ScummVM is the legal property of its developers, whose names
 * are too numerous to list here. Please refer to the COPYRIGHT
 * file distributed with this source distribution.
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.

 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.

 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 *
 */

#ifndef NANCY_ENGINEDATA_H
#define NANCY_ENGINEDATA_H

#include "engines/nancy/commontypes.h"
#include "engines/nancy/util.h"

#include "common/hash-str.h"
#include "common/path.h"

namespace Nancy {

// Data types corresponding to chunks found inside BOOT

struct EngineData {
    EngineData(Common::SeekableReadStream *chunkStream);
    virtual ~EngineData() {}
};

// Boot summary. Contains data for the UI, game clock, starting a new game.
struct BSUM : public EngineData {
    BSUM(Common::SeekableReadStream *chunkStream);

    byte header[90];

    Common::Path conversationTextsFilename;
    Common::Path autotextFilename;

    // Nancy12+
    Common::Path fontFilename;
    Common::Path flagsFilename;

    // Game start section
    SceneChangeDescription firstScene;
    uint16 startTimeHours;
    uint16 startTimeMinutes;

    // Nancy11-13: on the day after the game starts, once the clock reaches
    // lateNightHour, lateNightFlag gets raised
    uint16 lateNightHour = 0;
    int16 lateNightFlag = kEvNoEvent;

    // Nancy14-15 end of day. Once the clock reaches endOfDayHour, endOfDayFlag
    // is raised so the scripts can send the player to bed. Writing to the value
    // at dayValueIndex puts the player to sleep: the next day starts at
    // wakeUpHour, and the new day number gets copied into that value.
    byte dayValueIndex = 0;
    int16 endOfDayFlag = kEvNoEvent;
    uint16 endOfDayHour = 0;
    uint16 wakeUpHour = 0;

    // More Nancy Drew! scene
    SceneChangeDescription adScene;

    // UI
    Common::Rect extraButtonHotspot;    // Extra button is map in tvd, clock in nancy2 and up
    Common::Rect extraButtonHighlightDest;
    Common::Rect textboxScreenPosition;
    Common::Rect inventoryBoxScreenPosition;
    Common::Rect menuButtonSrc;
    Common::Rect helpButtonSrc;
    Common::Rect menuButtonDest;
    Common::Rect helpButtonDest;
    Common::Rect menuButtonHighlightSrc;
    Common::Rect helpButtonHighlightSrc;
    Common::Rect clockHighlightSrc;

    // Transparent color
    byte paletteTrans = 0;
    byte rTrans = 0;
    byte gTrans = 0;
    byte bTrans = 0;

    uint16 horizontalEdgesSize;
    uint16 verticalEdgesSize;

    // Nancy16 switched to system fonts, and no longer stores a count here
    uint16 numFonts = 0;

    uint16 playerTimeMinuteLength;
    uint16 buttonPressTimeDelay;
    uint16 dayStartMinutes = 0;
    uint16 dayEndMinutes = 0;
    byte overrideMovementTimeDeltas;
    uint16 slowMovementTimeDelta;
    uint16 fastMovementTimeDelta;

    // Nancy9-11: timer dependencies with a seconds value of kTimerDurationIndexBase
    // or above take their seconds from this table instead. Nancy12+ timer
    // triggers (AR 104) use it for seconds values above kTimerDurationIndexBase
    Common::Array<uint16> timerDurations;
};

// Contains rects defining the in-game viewport
struct VIEW : public EngineData {
    VIEW(Common::SeekableReadStream *chunkStream);

    Common::Rect screenPosition;
    Common::Rect bounds;
};

// Contains a list of .cal filenames, which are to be loaded at startup.
// .cal files themselves are just collections of image files used in dialogue.
// First introduced in nancy2.
struct PCAL : public EngineData {
    PCAL(Common::SeekableReadStream *chunkStream);

    Common::Array<Common::String> calNames;
};

// Contains definitions for all in-game items, as well as data for the
// inventory box at the bottom right of the game screen.
struct INV : public EngineData {
    struct ItemDescription {
        Common::String name;
        byte keepItem = kInvItemKeepAlways;
        uint16 sceneID = kNoScene;
        uint16 sceneSoundFlag = kContinueSceneSound;
        Common::Rect sourceRect;
        Common::Rect highlightedSourceRect;

        Common::String cantText;
        Common::String cantTextNotHolding; // nancy2 only
        Common::String cantTexts[3];       // Nancy9 and newer
        SoundDescription cantSound;
        SoundDescription cantSoundNotHolding; // nancy2 only
        SoundDescription cantSounds[3];       // Nancy9 and newer
    };

    INV(Common::SeekableReadStream *chunkStream);
    void readNancy15(Common::SeekableReadStream &stream);

    Common::Rect scrollbarSrcBounds;
    Common::Point scrollbarDefaultPos;
    uint16 scrollbarMaxScroll;

    Common::Array<Common::Rect> ornamentSrcs;
    Common::Array<Common::Rect> ornamentDests;

    Common::Array<Common::Rect> curtainAnimationSrcs;
    Common::Rect curtainsScreenPosition;
    uint16 curtainsFrameTime;

    uint16 captionAutoClearTime = 3000;

    Common::Path inventoryBoxIconsImageName;
    Common::Path inventoryCursorsImageName;

    SoundDescription cantSound;
    Common::String cantText;

    Common::Array<ItemDescription> itemDescriptions;
};

// Contains data about the textbox at the bottom left of the game screen
struct TBOX : public EngineData {
    TBOX(Common::SeekableReadStream *chunkStream);

    Common::Rect scrollbarSrcBounds;
    Common::Rect innerBoundingBox;
    Common::Point scrollbarDefaultPos;
    uint16 scrollbarMaxScroll;

    uint16 upOffset;
    uint16 downOffset;
    uint16 leftOffset;
    uint16 rightOffset;

    Common::Array<Common::Rect> ornamentSrcs;
    Common::Array<Common::Rect> ornamentDests;

    uint16 defaultFontID;
    uint16 defaultTextColor;
    uint16 conversationFontID;
    uint16 highlightConversationFontID;
    uint16 tabWidth;
    uint16 pageScrollPercent;

    uint32 textBackground;
    uint32 highlightTextBackground;

    // Nancy 10+ extra layout variables.
    int32 maxScrollWidth = 0;
    int32 firstLineY = 0; // added to the y-cursor when starting a new line
    uint16 lineStartXCursor = 0; // left inset of the text within the text area
    uint16 stripRightMargin = 0; // subtracted from contentWidth for the strip's text width
    int32 unknown1 = 0;
    int32 unknown2 = 0;
    int32 contentWidth = 0;
    int32 contentHeight = 0;
};

// Contains data about the map state. Only used in TVD and nancy1
struct MAP : public EngineData {
    struct Location {
        Common::String description;
        Common::Rect hotspot;
        SceneChangeDescription scenes[2];

        Common::Rect labelSrc;
    };

    MAP(Common::SeekableReadStream *chunkStream);

    Common::Array<Common::Path> mapNames;
    Common::Array<Common::Path> mapPaletteNames;
    Common::Array<SoundDescription> sounds;

    // Globe section, TVD only
    uint16 globeFrameTime;
    Common::Array<Common::Rect> globeSrcs;
    Common::Rect globeDest;
    Common::Rect globeGargoyleSrc;
    Common::Rect globeGargoyleDest;

    // Button section, nancy1 only
    Common::Rect buttonSrc;
    Common::Rect buttonDest;

    Common::Rect closedLabelSrc;

    Common::Array<Location> locations;

    Common::Point cursorPosition;
};

// Contains data for the help screen.
struct HELP : public EngineData {
    HELP(Common::SeekableReadStream *chunkStream);

    Common::Path imageName;
    Common::Rect buttonDest;
    Common::Rect buttonSrc;
    Common::Rect buttonHoverSrc;
};

// Contains data for the credits screen.
struct CRED : public EngineData {
    CRED(Common::SeekableReadStream *chunkStream);

    Common::Path imageName;
    Common::Array<Common::Path> textNames;
    Common::String textKey;
    Common::Rect textScreenPosition;
    uint16 updateTime;
    uint16 pixelsToScroll;
    SoundDescription sound;
};

// Contains data for the main menu.
struct MENU : public EngineData {
    MENU(Common::SeekableReadStream *chunkStream);

    Common::Path _imageName;
    Common::Array<Common::Rect> _buttonDests;
    Common::Array<Common::Rect> _buttonDownSrcs;
    Common::Array<Common::Rect> _buttonHighlightSrcs;
    Common::Array<Common::Rect> _buttonDisabledSrcs;
};

// Contains data for the Setup screen (a.k.a settings menu)
struct SET : public EngineData {
    SET(Common::SeekableReadStream *chunkStream);

    Common::Path _imageName;
    // Common::Rect _scrollbarsBounds
    Common::Array<Common::Rect> _scrollbarBounds;
    Common::Array<Common::Rect> _buttonDests;
    Common::Array<Common::Rect> _buttonDownSrcs;
    Common::Rect _doneButtonHighlightSrc;
    // Nancy15's extra (Design Select) button has a highlight of its own
    Common::Rect _extraButtonHighlightSrc;
    Common::Array<Common::Rect> _scrollbarSrcs;

    Common::Array<uint16> _scrollbarsCenterYPos;
    Common::Array<uint16> _scrollbarsCenterXPosL;
    Common::Array<uint16> _scrollbarsCenterXPosR;

    Common::Array<SoundDescription> _sounds;
};

// Contains data for the Save/Load screen. Used up to nancy7
struct LOAD : public EngineData {
    LOAD(Common::SeekableReadStream *chunkStream);

    Common::Path _image1Name;

    int16 _mainFontID;
    int16 _highlightFontID;
    int16 _disabledFontID;
    int16 _fontXOffset;
    int16 _fontYOffset;

    Common::Array<Common::Rect> _saveButtonDests;
    Common::Array<Common::Rect> _loadButtonDests;
    Common::Array<Common::Rect> _textboxBounds;
    Common::Rect _inputTextboxBounds;
    Common::Rect _doneButtonDest;
    Common::Array<Common::Rect> _saveButtonDownSrcs;
    Common::Array<Common::Rect> _loadButtonDownSrcs;

    Common::Rect _doneButtonDownSrc;
    Common::Array<Common::Rect> _saveButtonHighlightSrcs;
    Common::Array<Common::Rect> _loadButtonHighlightSrcs;

    Common::Rect _doneButtonHighlightSrc;
    Common::Array<Common::Rect> _saveButtonDisabledSrcs;
    Common::Array<Common::Rect> _loadButtonDisabledSrcs;

    Common::Rect _doneButtonDisabledSrc;
    Common::Rect _blinkingCursorSrc;
    uint16 _blinkingTimeDelay;
    Common::Array<Common::Rect> _cancelButtonSrcs;
    Common::Array<Common::Rect> _cancelButtonDests;
    Common::Rect _cancelButtonDownSrc;
    Common::Rect _cancelButtonHighlightSrc;
    Common::Rect _cancelButtonDisabledSrc;

    Common::Path _gameSavedPopup;
    Common::String _emptySaveText;
    Common::String _defaultSaveNamePrefix;
    // Common::Rect _gameSavedBounds

    // v2 members
    Common::Path _image2Name;
    Common::Path _imageButtonsName;

    Common::Array<Common::Rect> _unpressedButtonSrcs;
    Common::Array<Common::Rect> _pressedButtonSrcs;
    Common::Array<Common::Rect> _highlightedButtonSrcs;
    Common::Array<Common::Rect> _disabledButtonSrcs;

    Common::Array<Common::Rect> _buttonDests;
};

// Contains data for the prompt that appears when exiting the game
// without saving first. Introduced in nancy3.
struct SDLG : public EngineData {
    struct Dialog {
        Dialog(Common::SeekableReadStream *chunkStream);

        Common::Path imageName;

        Common::Rect yesDest;
        Common::Rect noDest;
        Common::Rect cancelDest;

        Common::Rect yesHighlightSrc;
        Common::Rect noHighlightSrc;
        Common::Rect cancelHighlightSrc;

        Common::Rect yesDownSrc;
        Common::Rect noDownSrc;
        Common::Rect cancelDownSrc;
    };

    SDLG(Common::SeekableReadStream *chunkStream);

    Common::Array<Dialog> dialogs;
};

// Contains data for the hint system. Only used in nancy1.
struct HINT : public EngineData {
    HINT(Common::SeekableReadStream *chunkStream);

    Common::Array<uint16> numHints;
};

// Contains data for the slider puzzle. First used in nancy1
struct SPUZ : public EngineData {
    SPUZ(Common::SeekableReadStream *chunkStream);

    Common::Array<Common::Array<Common::Array<int16>>> tileOrder;
};

// Contains data for the clock UI that appears at the bottom left of the screen (top left in TVD)
// Not used in nancy1 but still present in the data.
struct CLOK : public EngineData {
    CLOK(Common::SeekableReadStream *chunkStream);

    Common::Array<Common::Rect> animSrcs;
    Common::Array<Common::Rect> animDests;

    Common::Array<Common::Rect> hoursHandSrcs;
    Common::Array<Common::Rect> minutesHandSrcs;
    Common::Rect screenPosition;
    Common::Array<Common::Rect> hoursHandDests;
    Common::Array<Common::Rect> minutesHandDests;

    Common::Rect staticImageSrc;
    Common::Rect staticImageDest;

    uint32 timeToKeepOpen = 0;
    uint16 frameTime = 0;

    bool clockIsDisabled = false;
    bool clockIsDay = false; // nancy5 clock

    uint32 countdownTime = 0;
    Common::Array<Common::Rect> daySrcs;
    Common::Array<Common::Rect> countdownSrcs;
    Common::Rect disabledSrc; // possibly useless
};

// Contains data for special effects (fades between scenes/fades to black).
// Introduced in nancy2.
struct SPEC : public EngineData {
    SPEC(Common::SeekableReadStream *chunkStream);

    byte fadeToBlackNumFrames;
    uint16 fadeToBlackFrameTime;
    byte crossDissolveNumFrames;
};

// Contains data for the raycast puzzle in nancy3. Specifically, this is the
// data for the different "themes" that appear in the 3D space.
struct RCLB : public EngineData {
    struct Theme {
        Common::String themeName;

        Common::Array<uint32> wallIDs;

        Common::Array<uint16> exitFloorIDs;
        Common::Array<uint16> floorIDs;
        Common::Array<uint16> ceilingIDs;

        Common::Array<uint32> doorIDs;
        Common::Array<uint32> transparentwallIDs;
        Common::Array<uint32> objectwallIDs;
        Common::Array<uint16> objectWallHeights;

        uint16 generalLighting;
        uint16 hasLightSwitch;

        int16 transparentWallDensity;
        int16 objectWallDensity;
        int16 doorDensity;
    };

    RCLB(Common::SeekableReadStream *chunkStream);

    uint16 lightSwitchID;
    uint16 unk2;
    Common::Array<Theme> themes;
};

// Contains data about the raycast puzzle in nancy3. Specifically, this is the
// data for the debug map and the names of the textures to be used when rendering.
struct RCPR : public EngineData {
    RCPR(Common::SeekableReadStream *chunkStream);

    Common::Array<Common::Rect> screenViewportSizes;
    uint16 viewportSizeUsed;

    byte wallColor[3];
    byte playerColor[3];
    byte doorColor[3];
    byte lightSwitchColor[3];
    byte exitColor[3];
    byte uColor6[3];
    byte uColor7[3];
    byte uColor8[3];
    byte transparentWallColor[3];
    byte uColor10[3];

    Common::Array<Common::Path> wallNames;
    Common::Array<Common::Path> specialWallNames;
    Common::Array<Common::Path> ceilingNames;
    Common::Array<Common::Path> floorNames;
};

// Contains the name and dimensions of an image.
struct ImageChunk : public EngineData {
    ImageChunk(Common::SeekableReadStream *chunkStream);

    Common::Path imageName;
    uint16 width;
    uint16 height;
};

// Contains text data. Every string is tagged with a key via which
// it can be accessed. Used to store dialogue and journal (autotext) strings.
// NOT found inside BOOT; these are stored in their own cifs, the names of which
// can be found inside BSUM. Introduced in nancy6.
struct CVTX : public EngineData {
    CVTX(Common::SeekableReadStream *chunkStream);

    Common::HashMap<Common::String, Common::String, Common::IgnoreCase_Hash, Common::IgnoreCase_EqualTo> texts;
};

struct TABL : public EngineData {
    TABL(Common::SeekableReadStream *chunkStream);

    Common::String soundBaseName;
    Common::Array<uint16> startIDs;
    Common::Array<uint16> correctIDs;
    Common::Array<Common::Rect> srcRects;
    Common::Array<Common::String> strings;
};

struct MARK : public EngineData {
    MARK(Common::SeekableReadStream *chunkStream);

    Common::Array<Common::Rect> _markSrcs;
};

// Shared UI elements. Introduced in Nancy 10
struct SHUI : public EngineData {
    SHUI(Common::SeekableReadStream *chunkStream);

    Common::Array<Common::Rect> _closeRects;    // Close/"X" button rects
    Common::Array<Common::Rect> _sliderRects;   // Slider rects
};

// ScrollTextBox - introduced in Nancy 11. Standard UI popup header,
// followed by the rect to restore when the text box is closed.
struct SCTB : public EngineData {
    SCTB(Common::SeekableReadStream *chunkStream);

    UIPopupHeader header;
    Common::Rect restoreSrcRect;
};

enum TaskButton {
    kTaskButtonMenu = 0,
    kTaskButtonInventory = 1,
    kTaskButtonNotebook = 2,
    kTaskButtonCellphone = 3,
    // Nancy12, Nancy14 and Nancy15: a non-clickable coin purse (a wallet for
    // the Hardy boys) that shows the played character's money on hover,
    // inserted before HELP. HELP is therefore always the last taskbar button
    // (index 4 in games without the coin purse, index 5 in the others) and has
    // no fixed constant.
    kTaskButtonCoinPurse = 4
};

// Taskbar (the always-on strip at the bottom of the screen with MENU /
// inventory / notebook / cellphone / HELP buttons). Introduced in Nancy 10.
struct TASK : public EngineData {
    struct ButtonRecord {
        UIButtonRecord button;
        // Source rect for the notification sprite (the badge shown on
        // the middle three buttons when the popup has new content).
        // Empty for buttons that don't carry a notification.
        Common::Rect notificationSrcRect;
        Common::String clickSoundName[3];
    };

    TASK(Common::SeekableReadStream *chunkStream);

    // Maximum taskbar button slots: menu / inventory / notebook / cell phone /
    // help, plus Nancy12's extra coin purse. Earlier games fill only the first 5.
    static const uint kNumButtons = 6;
    static const uint kButtonRecordSize = 354;
    static const uint kNumAltSounds = 3;

    Common::Path imageName;

    Common::Rect srcRect;
    Common::Rect dstRect;
    Common::Rect unkRect1;
    // Screen rect of the closed-caption text strip the taskbar draws (the
    // ScrollTextBox's mini strip is positioned to it).
    Common::Rect ccTextboxScreenRect;

    ButtonRecord buttons[kNumButtons];
};

// Web browser popup UI (used from the cell phone to view in-game "web
// pages"). Introduced in Nancy 10
struct UIBW : public EngineData {
    struct Hotspot {
        uint16 id = 0;
        Common::Rect rect;
    };

    struct UrlPage {
        Common::Path imageName;
        Common::Array<Hotspot> hotspots;
    };

    UIBW(Common::SeekableReadStream *chunkStream);

    static const uint kUrlRecordSize = 215;
    static const uint kMaxHotspotsPerPage = 10;

    Common::Path imageName;
    Common::Array<UrlPage> pages;
};

// Cell-phone popup UI. Introduced in Nancy 10.
struct UICL : public EngineData {
    struct DialPadSlot {
        Common::Rect srcRect;
        Common::Rect destRect;
        Common::String soundName;
    };

    struct ThreeRectWidget {
        Common::Rect srcRectIdle;
        Common::Rect srcRectPressed;
        Common::Rect destRect;
    };

    // One phonebook entry, 41 bytes. A person can own several, one per number
    // they are reachable on; `visibility` picks which is listed.
    struct Contact {
        static const uint kDialPatternLength = 11;

        enum {
            kAlwaysListed = 10,
            kNeverListed = 11
        };

        // kAlwaysListed, kNeverListed, or the event flag that reveals the entry.
        uint16 visibility = kNeverListed;
        // Dial-pad slot indices (0..9), newline-terminated unless all 11 are used.
        byte dialPattern[kDialPatternLength] = {};
        Common::String name;                     // 20-byte field
        // Calling the contact changes to this scene and fires the flag.
        uint16 sceneID = kNoScene;
        uint16 frameID = 0;
        FlagDescription flag;
    };

    struct SrcDestRectPair {
        Common::Rect srcRect;
        Common::Rect destRect;
    };

    static const uint kNumDialPadSlots = 15;

    // The last three are soft keys. Nancy 13 relabels them per screen (Cam or
    // Dial, Del or Yes, Send or No); the ribbon label says which.
    enum DialPadKey {
        kDialKeyStar = 10,
        kDialKeyHash = 11,
        kDialKeyTalk = 12,
        kDialKeyMenu = 13,
        kDialKeyDirectory = 14
    };

    // Nancy 10-12 have 10 online sub-buttons; Nancy 13 added an 11th (the Back
    // button, Ghidra widget 0x10) at the front of the array.
    static const uint kNumSubButtons = 10;
    static const uint kNumSubButtonsNancy13 = 11;
    static const uint kNumStatusLabels = 3;        // No Signal / No Access / Old Email Only

    UICL(Common::SeekableReadStream *chunkStream);

    UIPopupHeader header;
    Common::Path overlayImageName;

    // Template the call-flow sounds (ring / pickup / invalid) are played
    // through. Only the name is swapped per call; channel / volume /
    // loops come from here.
    SoundDescription callSoundTemplate;

    DialPadSlot dialPadSlots[kNumDialPadSlots];

    // Screen-frame and label rects
    SrcDestRectPair dialHilite;
    Common::Rect screenOutSrcRect;
    int32 statusTextX = 0;                    // text X-baseline
    int32 statusTextY = 0;                    // text Y-baseline
    SrcDestRectPair welcomeScreen;
    Common::String statusLabels[kNumStatusLabels]; // "No Signal", "No Access", "Old Email Only"
    // Ribbon labels above the top-row buttons. In Nancy 13 the top row is
    // Cam/Menu/Dir, and the review / delete screens reuse the same three columns
    // with the Del/Send and Yes/No variants (all read from the 8-label block).
    SrcDestRectPair dialLabel;  // Nancy 13: "CAM"
    SrcDestRectPair webLabel;   // Nancy 13: "MENU"
    SrcDestRectPair dirLabel;   // Nancy 13: "DIR"
    SrcDestRectPair dialingLabel; // Nancy 13: "DIAL"
    SrcDestRectPair delLabel;     // Nancy 13: "DEL"
    SrcDestRectPair sendLabel;    // Nancy 13: "SEND"
    SrcDestRectPair yesLabel;     // Nancy 13: "YES"
    SrcDestRectPair noLabel;      // Nancy 13: "NO"

    // Help "?" button (original button index 15). The visible Talk/Call key
    // is dial-pad slot 12, not a separate widget.
    ThreeRectWidget helpButton;

    // Screen-content sprite block
    Common::String helpTextKey;               // CVTX key for the help page text
    Common::Rect signalSpriteSrc;
    Common::Rect signalSpriteSrcAlt;
    Common::Rect signalSpriteDest;
    Common::Rect batterySpriteSrc;
    Common::Rect batterySpriteSrcAlt;
    Common::Rect batterySpriteDest;
    SrcDestRectPair typeMessage;
    SrcDestRectPair connectedLabel;
    Common::Rect connectingSpriteSrc;
    Common::Rect connectingSpriteSrcAlt;      // state-8 variant
    Common::Rect connectingSpriteDest;
    SrcDestRectPair onlineHeading;
    Common::Rect fullEmptyScreenSrc;
    Common::Rect emailListContainer;          // scrollbar/list container
    Common::Rect dirArrowSrc;
    Common::Rect dirCursorSrc;
    SrcDestRectPair dirHeading;

    ThreeRectWidget subButtons[kNumSubButtonsNancy13];

    // Heading/icon SRC+DEST pairs
    SrcDestRectPair searchHeading;
    Common::Rect emailIconUnread;
    Common::Rect emailIconSelected;
    SrcDestRectPair emailHeading;
    SrcDestRectPair helpHeading;
    SrcDestRectPair browserHeading;

    // One initial email entry and one initial web-search entry can be baked
    // into the UICL chunk itself; the original seeds them at new-game init
    // (its cellphone reset). An empty key means the game ships that list empty.
    SearchLink initialEmail;
    SearchLink initialSearch;

    uint16 fontId1 = 0;
    uint16 fontId2 = 0;

    Common::Path outgoingRingSound;           // post-dial ring
    Common::Path pickupSound;                 // call connect
    Common::Path invalidNumberSound;          // try again

    uint16 contactCount = 0;
    Common::Array<Contact> contacts;

    // Nancy 13 added a camera / pictures sub-UI to the cell phone, which
    // reorganized the chunk body. The fields below are only populated for
    // Nancy 13 and later.

    // A photographable subject. Framing coords in sceneID sets captureFlag;
    // sending that snapshot to contact recipientIndex sets sendFlag.
    struct CameraSubject {
        int16 sceneID = -1;
        Common::Rect coords;
        int16 captureFlag = -1;
        int16 sendFlag = -1;
        int16 recipientIndex = -1;
    };

    // The LCD screen area: cleared through, and bounds the directory list.
    // Earlier games keep it in screenOutSrcRect.
    Common::Rect cameraViewSrcRect;
    int32 cameraTextX = 0;
    int32 cameraTextY = 0;
    Common::Path cameraViewImageName;         // "UI_CellCamView_OVL"
    Common::Path cameraClickSound;
    Common::Rect pictureDisplayRect;          // where a captured picture is shown
    Common::Rect noPictureScreenRect;         // "no pictures" placeholder
    Common::Path helpTextKey2;                // second CVTX key (phone-use help)
    byte screenColors[9] = {};                // 3 RGB colors for the phone screen
    Common::Array<CameraSubject> cameraSubjects;  // up to 50
};

// Shared by the UICL chunk and ChangeCellPhoneInfo (AR 130).
void readContact(Common::SeekableReadStream &stream, UICL::Contact &c);

// Standalone camera UI, added in Nancy14. While it is active a viewfinder sits at
// the centre of the viewport and the scene's own hotspots are suppressed.
struct UICM : public EngineData {
    UICM(Common::SeekableReadStream *chunkStream);

    // A photographable region. Taking a picture captures every subject in the
    // current scene lying wholly inside the viewfinder.
    struct CameraSubject {
        HotspotDescription hotspot;   // sceneID + region that can be photographed
        int16 subjectID = -1;         // event flag raised while photographed
        FlagDescription flag;         // second event flag (unset in every record)
    };

    Common::Path overlayImageName;            // "PHO_CameraView"
    Common::Rect viewRect;                    // captured-picture bounds
    uint16 maxPictures = 0;                   // most pictures the camera can hold
    byte pictureCount = 0;                    // current picture count (0xff = none)
    RandomSoundBlock shutterSound;            // picture-capture cue

    Common::Array<CameraSubject> subjects;
};

// New conversation popup UI (the text strip that appears above the taskbar
// when a character is speaking). Introduced in Nancy 10.
// Note: response hotspots are NOT in this chunk — they live in a separate
// TextBoxSummaryChunk, each carrying a response-sound filename referenced
// by ProcessConversation when STOP_VIDEO transitions to PLAYER_RESPONSE_SOUND.
struct UICO : public EngineData {
    UICO(Common::SeekableReadStream *chunkStream);

    UIPopupHeader header;
    Common::Rect textRect;      // Text-drawing rect inside the popup overlay
};

// New inventory popup UI (4x4 item grid with paging slider and category
// filter tabs along the right edge). Introduced in Nancy 10.
struct UIIV : public EngineData {
    UIIV(Common::SeekableReadStream *chunkStream);

    static const uint kNumFilters = 6;

    UIPopupHeader header;
    Common::Array<Common::Rect> slotSrcRects;       // 16 entries (image coords)
    Common::Array<Common::Rect> slotDestRects;      // 16 entries (screen coords)
    Common::Rect slotsHotspot;                      // Nancy13+: clickable region of the item slots
    // When nonzero, items added while the popup is open are appended to the end
    // of the inventory order instead of being inserted at the front (so the most
    // recently dropped item ends up last). See Scene::addItemToInventory.
    byte appendItemsWhileOpen = 0;
    // When nonzero, picking up an item closes the popup so it can be used on the scene.
    byte closeOnPickup = 0;
    UIButtonSlot filters[kNumFilters];              // 6 entries
    Common::Array<Common::Rect> tabCaptionSrcRects; // 6 entries
    Common::Rect tabCaptionDestRect;                // on-screen target
};

// New notebook UI. Introduced in Nancy 10.
struct UINB : public EngineData {
    UINB(Common::SeekableReadStream *chunkStream);

    static const uint kNumTabs = 2;
    static const uint kNumPageSoundsPerSet = 3;

    UIPopupHeader header;
    UIButtonSlot tabs[kNumTabs];
    Common::Rect textRect;
    byte primaryTextColor[3] = {};    // RGB, Nancy 13+
    byte secondaryTextColor[3] = {};  // RGB, Nancy 13+
    uint16 primaryFontID = 0;
    uint16 secondaryFontAttr = 0;
    uint16 useFilenameTextFlag = 0;
    Common::Path conditionalTextFilename;
    Common::Path actionableClickSounds[kNumPageSoundsPerSet];
    Common::Path noActionClickSounds[kNumPageSoundsPerSet];
    Common::Array<Common::Rect> tabCaptionSrcRects;             // 2 entries
    Common::Rect tabCaptionDestRect;                            // on-screen target
};

// Event flags table. Introduced in Nancy 12, and replaces the event flag names
// that were hardcoded in the executable. Each record is a name followed by an id.
struct EVNT : public EngineData {
    EVNT(Common::SeekableReadStream *chunkStream);

    static const uint kEventRecordSize = 35;

    // The first flag listed in the chunk; the lower ids are the engine's own flags
    static const uint16 kFirstEventFlag = 2000;

    uint16 numRecords = 0;

    // Indexed by flag id, counting from kFirstEventFlag, since the records don't
    // always follow the ids: Nancy13 and up list some flags twice or out of order,
    // and Nancy16 starts with the inventory items, which have ids of their own.
    Common::Array<Common::String> eventFlagNames;
};

// UI overlay element table. Introduced in Nancy 12. Each record describes one UI
// element: its starting value, the shared overlay image it belongs to, its
// on-screen rect and up to six associated sound cues. Unused slots use the name
// "NO_UI_ITEM", and slots without a given sound use "NO SOUND".
struct UIRC : public EngineData {
    struct ItemRecord {
        uint16 startingValue = 0;
        // Nancy 14 added an upper bound: a value that goes above it is reset to 0
        uint16 maxValue = 0;
        Common::Path overlayName;
        Common::Rect rect;
        int16 fontID = 0;
        int16 numDecimals = 0;
        int16 soundChannel = 0;
        int16 soundVolume = 0;
        Common::String soundNames[6];
    };

    UIRC(Common::SeekableReadStream *chunkStream);

    static const uint kNumSounds = 6;

    Common::Array<ItemRecord> items;
};

// Renders a UI resource's value the way the games' UI does: a currency symbol
// followed by the value, split into whole units and decimals as the record asks.
Common::String formatUIResourceValue(const UIRC::ItemRecord &item, int32 value);

// True in the games that keep the played character's money in UI resource 0 and
// show it on the taskbar's coin purse (a wallet for the Hardy boys).
bool hasMoneyResource();

// Music mix table. Introduced in Nancy 13. Each record maps a short location
// code (e.g. "BRI", "CAM", "TUT") to the set of music / ambience tracks that
// may play there ("TacitA"/"TacitB" are the silence variants).
struct MMIX : public EngineData {
    struct Record {
        Common::String name;
        Common::Array<Common::String> musicNames;
    };

    MMIX(Common::SeekableReadStream *chunkStream);

    Common::Array<Record> records;
};

// Level name table. Introduced in Nancy 15. Maps a short scene-prefix
// code (e.g. "KAP") to its human-readable level name (e.g. "Kapu Cave").
struct LVLN : public EngineData {
    LVLN(Common::SeekableReadStream *chunkStream);

    Common::Array<Common::String> levelCodes;   // e.g. "KAP"
    Common::Array<Common::String> levelNames;   // e.g. "Kapu Cave"
};

// Player-character selector UI. Introduced in Nancy 15, where the player
// alternates between Nancy and the Hardy Boys.
// Each entry supplies the image names for one selectable character.
struct PCUI : public EngineData {
    struct Character {
        Common::String imageName;           // e.g. "PUI_CRE_Nancy"
        Common::String defaultImageName;    // e.g. "PUI_CRE_Nancy_Default"
        uint16 id = 0;
    };

    PCUI(Common::SeekableReadStream *chunkStream);

    byte flag = 0;
    Common::Path uiName;                    // Nancy 16+, e.g. "UI_Main"
    Common::Array<Character> characters;    // indexed by the on-disk slot byte
};

// Fixed 314-byte layout block for the Nancy 15 "Design Select" screen, which
// picks the look (outfit) the player character's UI and cutscenes use. Reached
// from the in-game setup menu. Companion to PCUI.
struct LDSN : public EngineData {
    static const uint kNumButtons = 2;
    // The screen lists the available designs in a fixed column of rows
    static const uint kNumDesignRows = 9;

    LDSN(Common::SeekableReadStream *chunkStream);

    Common::Path backgroundImageName;   // "UI_DesignSelectBG", fills the screen
    Common::Path overlayImageName;      // "UI_DesignSelect_OVL", the buttons' sprite sheet

    // The two buttons' artwork, cut from the overlay image. [0] applies the
    // highlighted design, [1] leaves without applying.
    Common::Array<Common::Rect> buttonDownSrcs;
    Common::Array<Common::Rect> buttonHighlightSrcs;
    Common::Array<Common::Rect> buttonDests;

    Common::Array<Common::Rect> designRowDests; // where each design's name is drawn
    int16 fontID = 0;                           // design names
    int16 highlightFontID = 0;                  // ...and the selected one
};

// Player-UI header. Introduced in Nancy 15, first chunk of each character's
// PUI_CRE_<char>_DEFAULT_BOOT file. Names the UI theme and its swatch image.
struct PUIH : public EngineData {
    PUIH(Common::SeekableReadStream *chunkStream);

    byte flag = 0;
    Common::String themeName;   // e.g. "Nancy Classic Look (Default)"
    Common::String swatchImageName; // e.g. "UI_Swatch_ND"

    // Nancy 16+. Names of the IFFs describing the journal and task list popups
    Common::Path journalPrepName;   // e.g. "Journal_Prep"
    Common::Path tasklistPrepName;  // e.g. "Tasklist_Prep"
};

// Task list sounds. Introduced in Nancy 16 (per-character boot). Holds two
// banks of interchangeable sound names, sharing a channel, loop count and volume.
struct TSKL : public EngineData {
    struct SoundBank {
        Common::Array<Common::Path> soundNames;
        uint16 channelID = 0;
        uint32 numLoops = 0;
        uint16 volume = 0;
    };

    TSKL(Common::SeekableReadStream *chunkStream);

    SoundBank soundBanks[2];
};

// Player-UI random-sound bank. Introduced in Nancy 15 (per-character boot).
// Holds a base name plus a channel/volume and a list of sound groups, each
// group being a set of interchangeable (randomly-picked) sound variants -
// e.g. the character's "can't do that" response cues.
struct PUIV : public EngineData {
    struct SoundGroup {
        byte tag = 0;
        Common::Array<Common::String> variants;
    };

    PUIV(Common::SeekableReadStream *chunkStream);

    Common::String name;        // e.g. "DEF_ND_CANT"
    uint16 channelID = 0;       // shared playback channel (inferred)
    uint32 unknown = 0;
    uint16 volume = 0;          // shared volume (inferred)
    Common::Array<SoundGroup> soundGroups;
};
} // End of namespace Nancy

#endif // NANCY_ENGINEDATA_H