@react-text-game/core 0.1.0

package/dist/hooks/useGameEntity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameEntity.js","sourceRoot":"","sources":["../../src/hooks/useGameEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAGxC,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAE7B,MAAM,eAAe,GAAG,CAAC,EAAU,EAAE,EAAE,CACnC;IACI,EAAE;IACF,0DAA0D;IAC1D,+BAA+B;IAC/B,0DAA0D;IAC1D,EAAE;IACF,WAAW,EAAE,2CAA2C;IACxD,EAAE;IACF,oBAAoB;IACpB,qEAAqE;IACrE,iEAAiE;IACjE,EAAE;IACF,aAAa;IACb,2DAA2D;IAC3D,+BAA+B;IAC/B,EAAE;IACF,SAAS,EAAE,8CAA8C;IACzD,2EAA2E;IAC3E,EAAE;IACF,YAAY;IACZ,0BAA0B;IAC1B,kDAAkD;IAClD,OAAO;IACP,EAAE;IACF,kBAAkB;IAClB,kBAAkB,EAAE,0BAA0B;IAC9C,sDAAsD;IACtD,kEAAkE;IAClE,EAAE;IACF,0DAA0D;IAC1D,EAAE;CACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEjB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,aAAa,CAA2B,UAAa;IACjE,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAEzD,IAAI,CAAC;QACD,OAAO,QAAQ,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,iEAAiE;QACjE,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,eAAe,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,YAAY,CAAC,CAAC;QAClC,CAAC;aAAM,CAAC;YACJ,MAAM,KAAK,CAAC,CAAC,gCAAgC;QACjD,CAAC;IACL,CAAC;AACL,CAAC"}

package/dist/hooks/useGameIsStarted.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Determines whether the game has started.
+ *
+ * @function
+ * @returns {boolean} True if the game has started; false otherwise.
+ *
+ * This function checks the current passage ID within the game's reactive state to infer
+ * whether the game has progressed beyond the starting point. If the current passage ID
+ * does not match the system-defined starting passage ID, the game is considered to have started.
+ */
+export declare const useGameIsStarted: () => boolean;
+//# sourceMappingURL=useGameIsStarted.d.ts.map

package/dist/hooks/useGameIsStarted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameIsStarted.d.ts","sourceRoot":"","sources":["../../src/hooks/useGameIsStarted.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,QAAO,OAInC,CAAC"}

package/dist/hooks/useGameIsStarted.js

@@ -0,0 +1,18 @@
+import { useProxy } from "valtio/utils";
+import { SYSTEM_PASSAGE_NAMES } from "../constants";
+import { Game } from "../game";
+/**
+ * Determines whether the game has started.
+ *
+ * @function
+ * @returns {boolean} True if the game has started; false otherwise.
+ *
+ * This function checks the current passage ID within the game's reactive state to infer
+ * whether the game has progressed beyond the starting point. If the current passage ID
+ * does not match the system-defined starting passage ID, the game is considered to have started.
+ */
+export const useGameIsStarted = () => {
+    const reactiveGameState = useProxy(Game.selfState);
+    return reactiveGameState.currentPassageId !== SYSTEM_PASSAGE_NAMES.START_MENU;
+};
+//# sourceMappingURL=useGameIsStarted.js.map

package/dist/hooks/useGameIsStarted.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameIsStarted.js","sourceRoot":"","sources":["../../src/hooks/useGameIsStarted.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAExC,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAY,EAAE;IAC1C,MAAM,iBAAiB,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEnD,OAAO,iBAAiB,CAAC,gBAAgB,KAAK,oBAAoB,CAAC,UAAU,CAAC;AAClF,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { BaseGameObject } from "./baseGameObject";
+import { Game } from "./game";
+import type { NewOptions, Options } from "./options";
+import { InteractiveMap, newInteractiveMap } from "./passages/interactiveMap";
+import { Passage } from "./passages/passage";
+import { newStory, Story } from "./passages/story";
+import { newWidget, Widget } from "./passages/widget";
+export * from "./constants";
+export * from "./hooks";
+export type * from "./types";
+export { BaseGameObject, Game, InteractiveMap, newInteractiveMap, NewOptions, newStory, newWidget, Options, Passage, Story, Widget, };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAErD,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,mBAAmB,QAAQ,CAAC;AAE5B,OAAO,EACH,cAAc,EACd,IAAI,EACJ,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,QAAQ,EACR,SAAS,EACT,OAAO,EACP,OAAO,EACP,KAAK,EACL,MAAM,GACT,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+import { BaseGameObject } from "./baseGameObject";
+import { Game } from "./game";
+import { InteractiveMap, newInteractiveMap } from "./passages/interactiveMap";
+import { Passage } from "./passages/passage";
+import { newStory, Story } from "./passages/story";
+import { newWidget, Widget } from "./passages/widget";
+export * from "./constants";
+export * from "./hooks";
+export { BaseGameObject, Game, InteractiveMap, newInteractiveMap, newStory, newWidget, Passage, Story, Widget, };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAE7B,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAErD,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AAGxB,OAAO,EACH,cAAc,EACd,IAAI,EACJ,cAAc,EACd,iBAAiB,EAEjB,QAAQ,EACR,SAAS,EAET,OAAO,EACP,KAAK,EACL,MAAM,GACT,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,8 @@
+export declare const logger: {
+    readonly level: 0 | 2;
+    debug(...what: unknown[]): void;
+    log(...what: unknown[]): void;
+    warn(...what: unknown[]): void;
+    error(...what: unknown[]): void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,MAAM;;mBAKA,OAAO,EAAE;iBAKX,OAAO,EAAE;kBAKR,OAAO,EAAE;mBAKR,OAAO,EAAE;CAK3B,CAAC"}

package/dist/logger.js

@@ -0,0 +1,36 @@
+import { consola } from "consola/browser";
+import { colors } from 'consola/utils';
+import { _getOptions } from "./options";
+const LEVELS = {
+    DEBUG: 0,
+    INFO: 1,
+    WARN: 2,
+    ERROR: 3,
+};
+export const logger = {
+    get level() {
+        const { isDevMode } = _getOptions();
+        return isDevMode ? LEVELS.DEBUG : LEVELS.WARN;
+    },
+    debug(...what) {
+        if (this.level <= LEVELS.DEBUG) {
+            consola.debug(colors.green("[DEBUG]"), ...what);
+        }
+    },
+    log(...what) {
+        if (this.level <= LEVELS.INFO) {
+            consola.log(colors.blue("[INFO]"), ...what);
+        }
+    },
+    warn(...what) {
+        if (this.level <= LEVELS.WARN) {
+            consola.warn(colors.yellow("[WARN]"), ...what);
+        }
+    },
+    error(...what) {
+        if (this.level <= LEVELS.ERROR) {
+            consola.error(colors.red("[ERROR]"), ...what);
+        }
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,MAAM,GAAG;IACX,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,MAAM,GAAG;IAClB,IAAI,KAAK;QACL,MAAM,EAAE,SAAS,EAAE,GAAG,WAAW,EAAE,CAAC;QACpC,OAAO,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAClD,CAAC;IACD,KAAK,CAAC,GAAG,IAAe;QACpB,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;IACD,GAAG,CAAC,GAAG,IAAe;QAClB,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IACD,IAAI,CAAC,GAAG,IAAe;QACnB,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QACnD,CAAC;IACL,CAAC;IACD,KAAK,CAAC,GAAG,IAAe;QACpB,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC;IACL,CAAC;CACJ,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,13 @@
+export type Options = {
+    gameName: string;
+    gameId: string;
+    description: string;
+    gameVersion: string;
+    startPassage: string;
+    author: string;
+    isDevMode: boolean;
+};
+export type NewOptions = Pick<Options, "gameName"> & Partial<Omit<Options, "gameName">>;
+export declare const newOptions: (opts: NewOptions) => void;
+export declare const _getOptions: () => Options;
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GAAG;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;AAYxF,eAAO,MAAM,UAAU,GAAI,MAAM,UAAU,SAE1C,CAAC;AAEF,eAAO,MAAM,WAAW,eAAgB,CAAC"}

package/dist/options.js

@@ -0,0 +1,15 @@
+import { SYSTEM_PASSAGE_NAMES } from "./constants";
+const options = {
+    gameName: "",
+    gameId: "",
+    description: "",
+    startPassage: SYSTEM_PASSAGE_NAMES.START,
+    gameVersion: "1.0.0",
+    author: "",
+    isDevMode: false,
+};
+export const newOptions = (opts) => {
+    Object.assign(options, opts);
+};
+export const _getOptions = () => options;
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAclD,MAAM,OAAO,GAAY;IACrB,QAAQ,EAAE,EAAE;IACZ,MAAM,EAAE,EAAE;IACV,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,oBAAoB,CAAC,KAAK;IACxC,WAAW,EAAE,OAAO;IACpB,MAAM,EAAE,EAAE;IACV,SAAS,EAAE,KAAK;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAgB,EAAE,EAAE;IAC3C,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC"}

package/dist/passages/interactiveMap/fabric.d.ts

@@ -0,0 +1,4 @@
+import { InteractiveMap } from "./interactiveMap";
+import { InteractiveMapOptions } from "./types";
+export declare const newInteractiveMap: (id: string, options: InteractiveMapOptions) => InteractiveMap;
+//# sourceMappingURL=fabric.d.ts.map

package/dist/passages/interactiveMap/fabric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fabric.d.ts","sourceRoot":"","sources":["../../../src/passages/interactiveMap/fabric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAEhD,eAAO,MAAM,iBAAiB,GAC1B,IAAI,MAAM,EACV,SAAS,qBAAqB,KAC/B,cAAiD,CAAC"}

package/dist/passages/interactiveMap/fabric.js

@@ -0,0 +1,3 @@
+import { InteractiveMap } from "./interactiveMap";
+export const newInteractiveMap = (id, options) => new InteractiveMap(id, options);
+//# sourceMappingURL=fabric.js.map

package/dist/passages/interactiveMap/fabric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fabric.js","sourceRoot":"","sources":["../../../src/passages/interactiveMap/fabric.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC7B,EAAU,EACV,OAA8B,EAChB,EAAE,CAAC,IAAI,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC"}

package/dist/passages/interactiveMap/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./fabric";
+export * from "./interactiveMap";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/passages/interactiveMap/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/passages/interactiveMap/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/dist/passages/interactiveMap/index.js

@@ -0,0 +1,4 @@
+export * from "./fabric";
+export * from "./interactiveMap";
+export * from "./types";
+//# sourceMappingURL=index.js.map

package/dist/passages/interactiveMap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/passages/interactiveMap/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC"}

package/dist/passages/interactiveMap/interactiveMap.d.ts

@@ -0,0 +1,89 @@
+import { Passage } from "../../passages/passage";
+import { EmptyObject, InitVarsType } from "../../types";
+import { InteractiveMapOptions, InteractiveMapType } from "./types";
+/**
+ * Map-based interactive passage with clickable hotspots.
+ *
+ * Interactive maps display an image with interactive hotspots (buttons/images) that
+ * can be positioned on the map or on its sides. Hotspots can be labels, images, or menus.
+ * Both the map image and hotspots can be dynamic based on game state.
+ *
+ * @example
+ * ```typescript
+ * import { newInteractiveMap } from '@react-text-game/core';
+ *
+ * const worldMap = newInteractiveMap('world-map', {
+ *   image: '/maps/world.jpg',
+ *   bgImage: '/maps/world-bg.jpg',
+ *   hotspots: [
+ *     {
+ *       type: 'label',
+ *       content: 'Village',
+ *       position: { x: 30, y: 40 },
+ *       action: () => Game.jumpTo('village')
+ *     },
+ *     {
+ *       type: 'image',
+ *       content: {
+ *         idle: '/icons/chest.png',
+ *         hover: '/icons/chest-glow.png'
+ *       },
+ *       position: { x: 60, y: 70 },
+ *       action: () => openChest()
+ *     },
+ *     () => player.hasKey ? {
+ *       type: 'label',
+ *       content: 'Secret Door',
+ *       position: 'top',
+ *       action: () => Game.jumpTo('secret')
+ *     } : undefined
+ *   ]
+ * });
+ * ```
+ *
+ * @see newInteractiveMap - Factory function for creating InteractiveMap instances
+ */
+export declare class InteractiveMap extends Passage {
+    /**
+     * Configuration for the interactive map including images and hotspots.
+     */
+    private readonly options;
+    /**
+     * Creates a new InteractiveMap passage.
+     *
+     * @param id - Unique identifier for this map
+     * @param options - Configuration including image, hotspots, and styling
+     */
+    constructor(id: string, options: InteractiveMapOptions);
+    /**
+     * Renders the interactive map by resolving dynamic values and filtering hotspots.
+     *
+     * Processes all hotspots by:
+     * 1. Calling hotspot functions with props (if they are functions)
+     * 2. Filtering out undefined hotspots (useful for conditional hotspots)
+     * 3. Resolving image URLs (if they are functions)
+     *
+     * @template T - Type of props to pass when resolving dynamic content
+     * @param props - Properties used when evaluating dynamic hotspots/images
+     * @returns Processed map configuration ready for rendering
+     *
+     * @example
+     * ```typescript
+     * const map = newInteractiveMap('map', {
+     *   image: () => `/maps/${currentSeason}.jpg`,
+     *   hotspots: [
+     *     () => isNight ? undefined : {
+     *       type: 'label',
+     *       content: 'Shop',
+     *       position: { x: 50, y: 50 },
+     *       action: () => openShop()
+     *     }
+     *   ]
+     * });
+     *
+     * const { image, hotspots } = map.display({ currentSeason: 'winter', isNight: false });
+     * ```
+     */
+    display<T extends InitVarsType = EmptyObject>(props?: T): InteractiveMapType;
+}
+//# sourceMappingURL=interactiveMap.d.ts.map

package/dist/passages/interactiveMap/interactiveMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactiveMap.d.ts","sourceRoot":"","sources":["../../../src/passages/interactiveMap/interactiveMap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEnD,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,cAAe,SAAQ,OAAO;IACvC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAEhD;;;;;OAKG;gBACS,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB;IAKtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,OAAO,CAAC,CAAC,SAAS,YAAY,GAAG,WAAW,EACxC,KAAK,GAAE,CAAW,GACnB,kBAAkB;CAgBxB"}

package/dist/passages/interactiveMap/interactiveMap.js

@@ -0,0 +1,103 @@
+import { callIfFunction } from "../../helpers";
+import { Passage } from "../../passages/passage";
+/**
+ * Map-based interactive passage with clickable hotspots.
+ *
+ * Interactive maps display an image with interactive hotspots (buttons/images) that
+ * can be positioned on the map or on its sides. Hotspots can be labels, images, or menus.
+ * Both the map image and hotspots can be dynamic based on game state.
+ *
+ * @example
+ * ```typescript
+ * import { newInteractiveMap } from '@react-text-game/core';
+ *
+ * const worldMap = newInteractiveMap('world-map', {
+ *   image: '/maps/world.jpg',
+ *   bgImage: '/maps/world-bg.jpg',
+ *   hotspots: [
+ *     {
+ *       type: 'label',
+ *       content: 'Village',
+ *       position: { x: 30, y: 40 },
+ *       action: () => Game.jumpTo('village')
+ *     },
+ *     {
+ *       type: 'image',
+ *       content: {
+ *         idle: '/icons/chest.png',
+ *         hover: '/icons/chest-glow.png'
+ *       },
+ *       position: { x: 60, y: 70 },
+ *       action: () => openChest()
+ *     },
+ *     () => player.hasKey ? {
+ *       type: 'label',
+ *       content: 'Secret Door',
+ *       position: 'top',
+ *       action: () => Game.jumpTo('secret')
+ *     } : undefined
+ *   ]
+ * });
+ * ```
+ *
+ * @see newInteractiveMap - Factory function for creating InteractiveMap instances
+ */
+export class InteractiveMap extends Passage {
+    /**
+     * Configuration for the interactive map including images and hotspots.
+     */
+    options;
+    /**
+     * Creates a new InteractiveMap passage.
+     *
+     * @param id - Unique identifier for this map
+     * @param options - Configuration including image, hotspots, and styling
+     */
+    constructor(id, options) {
+        super(id, "interactiveMap");
+        this.options = options;
+    }
+    /**
+     * Renders the interactive map by resolving dynamic values and filtering hotspots.
+     *
+     * Processes all hotspots by:
+     * 1. Calling hotspot functions with props (if they are functions)
+     * 2. Filtering out undefined hotspots (useful for conditional hotspots)
+     * 3. Resolving image URLs (if they are functions)
+     *
+     * @template T - Type of props to pass when resolving dynamic content
+     * @param props - Properties used when evaluating dynamic hotspots/images
+     * @returns Processed map configuration ready for rendering
+     *
+     * @example
+     * ```typescript
+     * const map = newInteractiveMap('map', {
+     *   image: () => `/maps/${currentSeason}.jpg`,
+     *   hotspots: [
+     *     () => isNight ? undefined : {
+     *       type: 'label',
+     *       content: 'Shop',
+     *       position: { x: 50, y: 50 },
+     *       action: () => openShop()
+     *     }
+     *   ]
+     * });
+     *
+     * const { image, hotspots } = map.display({ currentSeason: 'winter', isNight: false });
+     * ```
+     */
+    display(props = {}) {
+        const hotspots = this.options.hotspots
+            .map((callback) => callIfFunction(callback, props))
+            .filter((hotspot) => hotspot !== undefined);
+        const image = callIfFunction(this.options.image);
+        const bgImage = callIfFunction(this.options.bgImage);
+        return {
+            ...this.options,
+            image,
+            bgImage,
+            hotspots,
+        };
+    }
+}
+//# sourceMappingURL=interactiveMap.js.map

package/dist/passages/interactiveMap/interactiveMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactiveMap.js","sourceRoot":"","sources":["../../../src/passages/interactiveMap/interactiveMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAK5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,OAAO,cAAe,SAAQ,OAAO;IACvC;;OAEG;IACc,OAAO,CAAwB;IAEhD;;;;;OAKG;IACH,YAAY,EAAU,EAAE,OAA8B;QAClD,KAAK,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,OAAO,CACH,QAAW,EAAO;QAElB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ;aACjC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;aAClD,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;QAEhD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAE,CAAC;QAEtD,OAAO;YACH,GAAG,IAAI,CAAC,OAAO;YACf,KAAK;YACL,OAAO;YACP,QAAQ;SACX,CAAC;IACN,CAAC;CACJ"}