@futdevpro/fsm-dynamo 1.20.102 → 1.20.104

package/build/_modules/game/_models/guided-onboarding.interface.d.ts

@@ -0,0 +1,102 @@
+/**
+ * BFR-WARFACTORY-014 — a DECLARATIVE reference to a game-supplied command or predicate. It is plain data (a name and
+ * one JSON argument), so a catalog can cross a package boundary — a closure over the game's services cannot.
+ */
+export interface DyFM_OnboardingRef {
+    name: string;
+    args?: unknown;
+}
+/** One onboarding step. `stepId` is stable and unique across the WHOLE catalog (saves point at it, not at an index). */
+export interface DyFM_OnboardingStep_Definition {
+    stepId: string;
+    /** Run once when the step is entered (e.g. open a panel, pre-select a building). */
+    command?: DyFM_OnboardingRef;
+    /** The step is done when this predicate holds. Without it the step is MANUAL — the player acknowledges it (`next`). */
+    completion?: DyFM_OnboardingRef;
+    /** Must keep holding while the step is active; when it breaks, the runtime regresses to a `fallbackStepIds` step. */
+    stateValidator?: DyFM_OnboardingRef;
+    /** Recovery steps in priority order; the first one whose own `stateValidator` holds is entered. */
+    fallbackStepIds?: string[];
+    /** Bounded recovery: after this long without completion the step is recorded as timed out and left. */
+    timeoutMs?: number;
+    /** Highlight target for the UI layer (the runtime never touches the DOM); alternates are tried in order. */
+    highlight?: {
+        targetId: string;
+        alternateTargetIds?: string[];
+        anchorId?: string;
+    };
+    /** Opaque, content-side data (text key, narration asset id, world position …) — carried, never interpreted. */
+    payload?: unknown;
+}
+export interface DyFM_OnboardingChapter_Definition {
+    chapterId: string;
+    steps: DyFM_OnboardingStep_Definition[];
+    payload?: unknown;
+}
+export interface DyFM_OnboardingCatalog {
+    /** Bump it when steps change — a save made with another version is migrated on import. */
+    catalogVersion: string | number;
+    chapters: DyFM_OnboardingChapter_Definition[];
+    /** Removed / renamed step id → its replacement (chains are followed; cycles are a catalog error). */
+    migrations?: Record<string, string>;
+}
+/** The game's capability surface the declarative refs resolve against. */
+export interface DyFM_OnboardingCapabilities<TContext> {
+    commands?: Record<string, (context: TContext, args: unknown) => void | Promise<void>>;
+    predicates?: Record<string, (context: TContext, args: unknown) => boolean>;
+}
+/** Lifecycle of an onboarding run. */
+export type DyFM_OnboardingStatus_Type = 'not-started' | 'active' | 'completed' | 'skipped';
+/** The serialisable progress — `dyfm-onboarding/1`. */
+export interface DyFM_OnboardingState {
+    schema: 'dyfm-onboarding/1';
+    catalogVersion: string | number;
+    status: DyFM_OnboardingStatus_Type;
+    /** The active step (only while `active`). */
+    stepId?: string;
+    completedStepIds: string[];
+    skippedStepIds: string[];
+}
+/** What `importState` did to fit an older save onto the current catalog. */
+export interface DyFM_OnboardingMigrationReport {
+    migrated: boolean;
+    /** Old id → new id, for every id a migration rule rewrote. */
+    renamed: Record<string, string>;
+    /** Ids that no longer exist and had no migration rule (dropped from the progress). */
+    dropped: string[];
+    /** The active step could not be kept: where the player continues instead. */
+    resumedAt?: string;
+}
+/** What one `evaluate()` did. */
+export type DyFM_OnboardingEvaluation_Type = 'inactive' | 'waiting' | 'advanced' | 'regressed' | 'timed-out';
+export interface DyFM_OnboardingEvent {
+    type: 'step-entered' | 'step-completed' | 'step-skipped' | 'step-timed-out' | 'regressed' | 'chapter-completed' | 'completed' | 'skipped' | 'restarted' | 'command-failed';
+    stepId?: string;
+    chapterId?: string;
+    /** `regressed`: the step that lost its state. */
+    fromStepId?: string;
+    /** `step-entered` after `importState` + `resume`. */
+    resumed?: boolean;
+    /** `command-failed`. */
+    error?: unknown;
+}
+/** Where the player is — everything a UI needs to render "Chapter 2 · step 3 of 5". */
+export interface DyFM_OnboardingPosition {
+    chapterId: string;
+    chapterIndex: number;
+    chapterCount: number;
+    step: DyFM_OnboardingStep_Definition;
+    stepIndexInChapter: number;
+    chapterStepCount: number;
+    /** Completed + skipped steps over all steps of the catalog. */
+    doneCount: number;
+    totalCount: number;
+    /** True when the step has no completion predicate — the UI shows a "Next" button. */
+    manual: boolean;
+}
+export interface DyFM_OnboardingFinding {
+    code: string;
+    path: string;
+    message: string;
+}
+//# sourceMappingURL=guided-onboarding.interface.d.ts.map

package/build/_modules/game/_models/guided-onboarding.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guided-onboarding.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/guided-onboarding.interface.ts"],"names":[],"mappings":"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"}

package/build/_modules/game/_models/guided-onboarding.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=guided-onboarding.interface.js.map

package/build/_modules/game/_models/guided-onboarding.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guided-onboarding.interface.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/guided-onboarding.interface.ts"],"names":[],"mappings":""}

package/build/_modules/game/_models/narration-player.control-model.d.ts

@@ -0,0 +1,53 @@
+import { DyFM_NarrationLine, DyFM_NarrationPlayer_Options, DyFM_NarrationState } from './narration-player.interface';
+/**
+ * BFR-WARFACTORY-014 — the narration adapter canon (war-factory `Tutorial_Narration_Service` + portalhold voice lines):
+ *
+ * - **asset-id core**, catalog as an optional layer (`playLine` / `playCatalog`);
+ * - `Promise<boolean>` — a refusal is REPORTED, with its reason in `lastRefusal` (disabled · muted · no-gesture ·
+ *   autoplay-blocked · error · unknown-line) — a narration that silently does not play is undiagnosable;
+ * - optional **gesture gate with exposed state** (`sessionActivated`);
+ * - **exactly one active line** — every play stops the previous one;
+ * - a **staleness guard** (revision counter): a late `ended` / `error` / `play()` rejection of a replaced line never
+ *   touches the current one;
+ * - **`blocked` ≠ `failed`**: a `NotAllowedError` (browser autoplay block) is the case the player must be told about;
+ * - `replay()`; optional settings persistence; the subtitle stays available while blocked / failed (text fallback).
+ *
+ * Framework-agnostic: the audio comes from a factory (`(src) => new Audio(src)` in a browser); a UI layer mirrors
+ * `getState()` via `onChange`.
+ */
+export declare class DyFM_NarrationPlayer_ControlModel {
+    private readonly options;
+    private readonly listeners;
+    private audio;
+    private revision;
+    private lastLine;
+    private state;
+    constructor(options: DyFM_NarrationPlayer_Options);
+    /** A copy of the current state. */
+    getState(): DyFM_NarrationState;
+    /** Subscribe to state changes; returns the unsubscribe. A throwing listener is logged and isolated. */
+    onChange(listener: (state: DyFM_NarrationState) => void): () => void;
+    /** Marks a user gesture — from now on automatic narration may play. */
+    activate(): void;
+    /** Plays a line (automatic path: respects the gesture gate). */
+    playLine(line: DyFM_NarrationLine): Promise<boolean>;
+    /** Plays a catalog entry; an unknown key refuses with `unknown-line`. */
+    playCatalog(key: string): Promise<boolean>;
+    /** From a user gesture: activates the session, then plays. */
+    activateAndPlay(line: DyFM_NarrationLine): Promise<boolean>;
+    /** Replays the last requested line (a replay button is a gesture). */
+    replay(): Promise<boolean>;
+    /** Stops the active line (or clears a blocked / failed one). */
+    stop(): void;
+    setEnabled(enabled: boolean): void;
+    setVolume(volume: number): void;
+    /** Re-applies the effective volume (call it when the game's master volume / mute changes); 0 stops the line. */
+    applyVolume(): void;
+    private play;
+    private detach;
+    private effectiveVolume;
+    private set;
+    private loadSettings;
+    private saveSettings;
+}
+//# sourceMappingURL=narration-player.control-model.d.ts.map

package/build/_modules/game/_models/narration-player.control-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration-player.control-model.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/narration-player.control-model.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,kBAAkB,EAClB,4BAA4B,EAE5B,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iCAAiC;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgD;IAC1E,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,KAAK,CAGX;gBAEU,OAAO,EAAE,4BAA4B;IAKjD,mCAAmC;IACnC,QAAQ,IAAI,mBAAmB;IAI/B,uGAAuG;IACvG,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAAG,MAAM,IAAI;IAYpE,uEAAuE;IACvE,QAAQ,IAAI,IAAI;IAMhB,gEAAgE;IAC1D,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D,yEAAyE;IACnE,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYhD,8DAA8D;IACxD,eAAe,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAMjE,sEAAsE;IAChE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAShC,gEAAgE;IAChE,IAAI,IAAI,IAAI;IAMZ,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM/B,gHAAgH;IAChH,WAAW,IAAI,IAAI;YAWL,IAAI;IA4DlB,OAAO,CAAC,MAAM;IAgBd,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,GAAG;IAcX,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,YAAY;CAYrB"}

package/build/_modules/game/_models/narration-player.control-model.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_NarrationPlayer_ControlModel = void 0;
+const log_util_1 = require("../../../_collections/utils/log.util");
+/**
+ * BFR-WARFACTORY-014 — the narration adapter canon (war-factory `Tutorial_Narration_Service` + portalhold voice lines):
+ *
+ * - **asset-id core**, catalog as an optional layer (`playLine` / `playCatalog`);
+ * - `Promise<boolean>` — a refusal is REPORTED, with its reason in `lastRefusal` (disabled · muted · no-gesture ·
+ *   autoplay-blocked · error · unknown-line) — a narration that silently does not play is undiagnosable;
+ * - optional **gesture gate with exposed state** (`sessionActivated`);
+ * - **exactly one active line** — every play stops the previous one;
+ * - a **staleness guard** (revision counter): a late `ended` / `error` / `play()` rejection of a replaced line never
+ *   touches the current one;
+ * - **`blocked` ≠ `failed`**: a `NotAllowedError` (browser autoplay block) is the case the player must be told about;
+ * - `replay()`; optional settings persistence; the subtitle stays available while blocked / failed (text fallback).
+ *
+ * Framework-agnostic: the audio comes from a factory (`(src) => new Audio(src)` in a browser); a UI layer mirrors
+ * `getState()` via `onChange`.
+ */
+class DyFM_NarrationPlayer_ControlModel {
+    options;
+    listeners = [];
+    audio = null;
+    revision = 0;
+    lastLine = null;
+    state = {
+        playback: 'idle', activeLineId: null, subtitle: null, enabled: true, volume: 0.85, sessionActivated: false,
+        lastRefusal: null,
+    };
+    constructor(options) {
+        this.options = options;
+        this.loadSettings();
+    }
+    /** A copy of the current state. */
+    getState() {
+        return { ...this.state };
+    }
+    /** Subscribe to state changes; returns the unsubscribe. A throwing listener is logged and isolated. */
+    onChange(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const index = this.listeners.indexOf(listener);
+            if (index >= 0) {
+                this.listeners.splice(index, 1);
+            }
+        };
+    }
+    /** Marks a user gesture — from now on automatic narration may play. */
+    activate() {
+        if (!this.state.sessionActivated) {
+            this.set({ sessionActivated: true });
+        }
+    }
+    /** Plays a line (automatic path: respects the gesture gate). */
+    async playLine(line) {
+        return this.play(line);
+    }
+    /** Plays a catalog entry; an unknown key refuses with `unknown-line`. */
+    async playCatalog(key) {
+        const line = this.options.catalog?.[key];
+        if (!line) {
+            this.set({ lastRefusal: 'unknown-line' });
+            return false;
+        }
+        return this.play(line);
+    }
+    /** From a user gesture: activates the session, then plays. */
+    async activateAndPlay(line) {
+        this.activate();
+        return this.play(line);
+    }
+    /** Replays the last requested line (a replay button is a gesture). */
+    async replay() {
+        if (!this.lastLine) {
+            return false;
+        }
+        this.activate();
+        return this.play(this.lastLine);
+    }
+    /** Stops the active line (or clears a blocked / failed one). */
+    stop() {
+        this.revision++;
+        this.detach();
+        this.set({ playback: 'idle', activeLineId: null, subtitle: null });
+    }
+    setEnabled(enabled) {
+        this.set({ enabled: enabled });
+        this.saveSettings();
+        if (!enabled && this.audio) {
+            this.stop();
+        }
+    }
+    setVolume(volume) {
+        this.set({ volume: Math.min(1, Math.max(0, Number.isFinite(volume) ? volume : 0)) });
+        this.saveSettings();
+        this.applyVolume();
+    }
+    /** Re-applies the effective volume (call it when the game's master volume / mute changes); 0 stops the line. */
+    applyVolume() {
+        const effective = this.effectiveVolume();
+        if (this.audio) {
+            this.audio.volume = effective;
+            if (effective <= 0) {
+                this.stop();
+            }
+        }
+    }
+    async play(line) {
+        this.lastLine = line;
+        const refusal = !this.state.enabled
+            ? 'disabled'
+            : this.effectiveVolume() <= 0
+                ? 'muted'
+                : this.options.requireGesture && !this.state.sessionActivated ? 'no-gesture' : null;
+        if (refusal) {
+            this.set({ lastRefusal: refusal });
+            return false;
+        }
+        // exactly one active line: the previous one is stopped and its late callbacks become stale
+        const revision = ++this.revision;
+        this.detach();
+        let audio;
+        try {
+            audio = this.options.audioFactory(line.src);
+            audio.volume = this.effectiveVolume();
+            audio.onended = () => {
+                if (revision === this.revision) {
+                    this.audio = null;
+                    this.set({ playback: 'idle', activeLineId: null, subtitle: null });
+                }
+            };
+            audio.onerror = () => {
+                if (revision === this.revision) {
+                    this.audio = null;
+                    this.set({ playback: 'failed', lastRefusal: 'error' });
+                }
+            };
+            this.audio = audio;
+            this.set({ activeLineId: line.lineId, subtitle: line.subtitle ?? null, lastRefusal: null });
+            await audio.play();
+        }
+        catch (error) {
+            if (revision !== this.revision) {
+                return false; // a newer line replaced this one while play() was pending
+            }
+            this.audio = null;
+            const blocked = error?.name === 'NotAllowedError';
+            this.set({ playback: blocked ? 'blocked' : 'failed', lastRefusal: blocked ? 'autoplay-blocked' : 'error' });
+            return false;
+        }
+        if (revision !== this.revision) {
+            return false;
+        }
+        this.set({ playback: 'playing' });
+        return true;
+    }
+    detach() {
+        if (this.audio) {
+            const audio = this.audio;
+            this.audio = null;
+            audio.onended = null;
+            audio.onerror = null;
+            try {
+                audio.pause();
+                audio.currentTime = 0;
+            }
+            catch (error) {
+                log_util_1.DyFM_Log.error('DyFM_NarrationPlayer: stopping the previous line failed', error);
+            }
+        }
+    }
+    effectiveVolume() {
+        const master = this.options.masterVolume ? this.options.masterVolume() : 1;
+        return Math.min(1, Math.max(0, this.state.volume * (Number.isFinite(master) ? master : 0)));
+    }
+    set(patch) {
+        this.state = { ...this.state, ...patch };
+        const snapshot = this.getState();
+        for (const listener of [...this.listeners]) {
+            try {
+                listener(snapshot);
+            }
+            catch (error) {
+                log_util_1.DyFM_Log.error('DyFM_NarrationPlayer: an onChange listener threw', error);
+            }
+        }
+    }
+    loadSettings() {
+        const settings = this.options.settings;
+        if (!settings) {
+            return;
+        }
+        try {
+            const stored = settings.store.getItem(settings.key);
+            const parsed = stored ? JSON.parse(stored) : {};
+            if (typeof parsed.enabled === 'boolean') {
+                this.state.enabled = parsed.enabled;
+            }
+            if (typeof parsed.volume === 'number' && Number.isFinite(parsed.volume)) {
+                this.state.volume = Math.min(1, Math.max(0, parsed.volume));
+            }
+        }
+        catch (error) {
+            // a broken stored value falls back to the defaults (the session still works)
+            log_util_1.DyFM_Log.error(`DyFM_NarrationPlayer: unreadable settings under '${settings.key}' — defaults used`, error);
+        }
+    }
+    saveSettings() {
+        const settings = this.options.settings;
+        if (!settings) {
+            return;
+        }
+        try {
+            settings.store.setItem(settings.key, JSON.stringify({ enabled: this.state.enabled, volume: this.state.volume }));
+        }
+        catch (error) {
+            log_util_1.DyFM_Log.error(`DyFM_NarrationPlayer: settings could not be saved under '${settings.key}'`, error);
+        }
+    }
+}
+exports.DyFM_NarrationPlayer_ControlModel = DyFM_NarrationPlayer_ControlModel;
+//# sourceMappingURL=narration-player.control-model.js.map

package/build/_modules/game/_models/narration-player.control-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration-player.control-model.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/narration-player.control-model.ts"],"names":[],"mappings":";;;AAAA,mEAAgE;AAShE;;;;;;;;;;;;;;;GAeG;AACH,MAAa,iCAAiC;IAC3B,OAAO,CAA+B;IACtC,SAAS,GAA6C,EAAE,CAAC;IAClE,KAAK,GAAyC,IAAI,CAAC;IACnD,QAAQ,GAAW,CAAC,CAAC;IACrB,QAAQ,GAA8B,IAAI,CAAC;IAC3C,KAAK,GAAwB;QACnC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK;QAC1G,WAAW,EAAE,IAAI;KAClB,CAAC;IAEF,YAAY,OAAqC;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,mCAAmC;IACnC,QAAQ;QACN,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,uGAAuG;IACvG,QAAQ,CAAC,QAA8C;QACrD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE9B,OAAO,GAAS,EAAE;YAChB,MAAM,KAAK,GAAW,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAEvD,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,QAAQ,CAAC,IAAwB;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,MAAM,IAAI,GAAmC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;QAEzE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC,CAAC;YAE1C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,eAAe,CAAC,IAAwB;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEhB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,sEAAsE;IACtE,KAAK,CAAC,MAAM;QACV,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEhB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,gEAAgE;IAChE,IAAI;QACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,UAAU,CAAC,OAAgB;QACzB,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/B,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrF,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,WAAW,EAAE,CAAC;IACrB,CAAC;IAED,gHAAgH;IAChH,WAAW;QACT,MAAM,SAAS,GAAW,IAAI,CAAC,eAAe,EAAE,CAAC;QAEjD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;YAC9B,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI,CAAC,IAAwB;QACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QAErB,MAAM,OAAO,GAAsC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;YACpE,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC;gBAC3B,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;QAExF,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;YAEnC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,2FAA2F;QAC3F,MAAM,QAAQ,GAAW,EAAE,IAAI,CAAC,QAAQ,CAAC;QAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;QAEd,IAAI,KAAoC,CAAC;QAEzC,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5C,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;YACtC,KAAK,CAAC,OAAO,GAAG,GAAS,EAAE;gBACzB,IAAI,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;oBAClB,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC,CAAC;YACF,KAAK,CAAC,OAAO,GAAG,GAAS,EAAE;gBACzB,IAAI,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAC/B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;oBAClB,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC,CAAC;YACF,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5F,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC/B,OAAO,KAAK,CAAC,CAAC,0DAA0D;YAC1E,CAAC;YACD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAElB,MAAM,OAAO,GAAa,KAA4B,EAAE,IAAI,KAAK,iBAAiB,CAAC;YAEnF,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAE5G,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;QAElC,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,MAAM;QACZ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,GAAkC,IAAI,CAAC,KAAK,CAAC;YAExD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;YAClB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC;gBACH,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC;YACxB,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,mBAAQ,CAAC,KAAK,CAAC,yDAAyD,EAAE,KAAK,CAAC,CAAC;YACnF,CAAC;QACH,CAAC;IACH,CAAC;IAEO,eAAe;QACrB,MAAM,MAAM,GAAW,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,CAAC;IAEO,GAAG,CAAC,KAAmC;QAC7C,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;QAEzC,MAAM,QAAQ,GAAwB,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEtD,KAAK,MAAM,QAAQ,IAAI,CAAE,GAAG,IAAI,CAAC,SAAS,CAAE,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACrB,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,mBAAQ,CAAC,KAAK,CAAC,kDAAkD,EAAE,KAAK,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,MAAM,QAAQ,GAA6C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QAEjF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAkB,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACnE,MAAM,MAAM,GAA4C,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEzF,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACxC,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YACtC,CAAC;YACD,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,6EAA6E;YAC7E,mBAAQ,CAAC,KAAK,CAAC,oDAAoD,QAAQ,CAAC,GAAG,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAC7G,CAAC;IACH,CAAC;IAEO,YAAY;QAClB,MAAM,QAAQ,GAA6C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;QAEjF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACnH,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,mBAAQ,CAAC,KAAK,CAAC,4DAA4D,QAAQ,CAAC,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;CACF;AA/OD,8EA+OC"}

package/build/_modules/game/_models/narration-player.interface.d.ts

@@ -0,0 +1,64 @@
+/** BFR-WARFACTORY-014 — one narration line: the asset is the core address, the subtitle the always-available fallback. */
+export interface DyFM_NarrationLine {
+    /** Stable id (a catalog key or an asset id). */
+    lineId: string;
+    /** The audio source (URL / path) — resolved by the audio factory. */
+    src: string;
+    /** Shown while it plays AND when it cannot play (blocked / failed): the text is never lost. */
+    subtitle?: string;
+}
+/**
+ * The audio element surface the player uses — structural, so an `HTMLAudioElement` fits it and specs can use a fake.
+ * `play()` rejects with a `NotAllowedError`-named error when the browser blocks autoplay.
+ */
+export interface DyFM_NarrationAudio_Interface {
+    volume: number;
+    currentTime: number;
+    onended: (() => void) | null;
+    onerror: (() => void) | null;
+    play(): Promise<void>;
+    pause(): void;
+}
+/** A persisted-settings store (e.g. `localStorage`); optional. */
+export interface DyFM_NarrationSettingsStore_Interface {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+}
+export interface DyFM_NarrationPlayer_Options {
+    /** Creates the audio for a source — in a browser: `(src) => new Audio(src)`. */
+    audioFactory: (src: string) => DyFM_NarrationAudio_Interface;
+    /**
+     * When true, `play()` only plays after `activate()` (a user gesture) — automatic narration then refuses with
+     * `no-gesture` instead of hitting the browser's autoplay block. `activateAndPlay()` / `replay()` count as a gesture.
+     */
+    requireGesture?: boolean;
+    /** The game's master volume 0..1 (and mute as 0) — multiplied into the narration volume. Default: 1. */
+    masterVolume?: () => number;
+    /** Optional catalog: `playCatalog(key)` resolves through it (an asset-id layer on top of the core). */
+    catalog?: Record<string, DyFM_NarrationLine>;
+    /** Optional settings persistence (enabled + volume). */
+    settings?: {
+        store: DyFM_NarrationSettingsStore_Interface;
+        key: string;
+    };
+}
+export type DyFM_NarrationPlayback_Type = 'idle' | 'playing' | 'blocked' | 'failed';
+/**
+ * Why the last `play` did not play — the diagnosis a silent narration otherwise lacks.
+ * `autoplay-blocked` is the one the UI must tell the player about ("click to enable sound").
+ */
+export type DyFM_NarrationRefusal_Type = 'disabled' | 'muted' | 'no-gesture' | 'autoplay-blocked' | 'error' | 'unknown-line';
+/** Everything a UI needs (the five WF signals + the subtitle + the refusal reason). */
+export interface DyFM_NarrationState {
+    playback: DyFM_NarrationPlayback_Type;
+    /** The line playing, or the one that could not play (blocked / failed) — null when idle. */
+    activeLineId: string | null;
+    /** The active line's subtitle (also while blocked / failed — the text fallback). */
+    subtitle: string | null;
+    enabled: boolean;
+    /** The narration's own volume 0..1 (before the master volume). */
+    volume: number;
+    sessionActivated: boolean;
+    lastRefusal: DyFM_NarrationRefusal_Type | null;
+}
+//# sourceMappingURL=narration-player.interface.d.ts.map

package/build/_modules/game/_models/narration-player.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration-player.interface.d.ts","sourceRoot":"","sources":["../../../../src/_modules/game/_models/narration-player.interface.ts"],"names":[],"mappings":"AAAA,0HAA0H;AAC1H,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;IACZ,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,kEAAkE;AAClE,MAAM,WAAW,qCAAqC;IACpD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,4BAA4B;IAC3C,gFAAgF;IAChF,YAAY,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,6BAA6B,CAAC;IAC7D;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,wGAAwG;IACxG,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,uGAAuG;IACvG,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,qCAAqC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E;AAED,MAAM,MAAM,2BAA2B,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpF;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG,UAAU,GAAG,OAAO,GAAG,YAAY,GAAG,kBAAkB,GAAG,OAAO,GAAG,cAAc,CAAC;AAE7H,uFAAuF;AACvF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,2BAA2B,CAAC;IACtC,4FAA4F;IAC5F,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAChD"}

package/build/_modules/game/_models/narration-player.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=narration-player.interface.js.map

package/build/_modules/game/_models/narration-player.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"narration-player.interface.js","sourceRoot":"","sources":["../../../../src/_modules/game/_models/narration-player.interface.ts"],"names":[],"mappings":""}

package/build/_modules/game/index.d.ts

@@ -20,6 +20,10 @@ export * from './_models/viewport.interface';
 export * from './_models/viewport.control-model';
 export * from './_models/input-action.interface';
 export * from './_models/input-action-registry.control-model';
+export * from './_models/guided-onboarding.interface';
+export * from './_models/guided-onboarding.control-model';
+export * from './_models/narration-player.interface';
+export * from './_models/narration-player.control-model';
 export * from './_collections/audio-mixer.util';
 export * from './_collections/audio-scale.util';
 export * from './_collections/game-save.util';

package/build/_modules/game/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAG5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+CAA+C,CAAC;AAG9D,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAG5C,cAAc,wCAAwC,CAAC;AACvD,cAAc,0CAA0C,CAAC;AACzD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,iCAAiC,CAAC;AAChD,cAAc,yCAAyC,CAAC;AACxD,cAAc,uCAAuC,CAAC;AACtD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AACzD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,uCAAuC,CAAC;AACtD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,uCAAuC,CAAC;AACtD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AAGzD,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,uCAAuC,CAAC"}

package/build/_modules/game/index.js

@@ -25,6 +25,10 @@ tslib_1.__exportStar(require("./_models/viewport.interface"), exports);
 tslib_1.__exportStar(require("./_models/viewport.control-model"), exports);
 tslib_1.__exportStar(require("./_models/input-action.interface"), exports);
 tslib_1.__exportStar(require("./_models/input-action-registry.control-model"), exports);
+tslib_1.__exportStar(require("./_models/guided-onboarding.interface"), exports);
+tslib_1.__exportStar(require("./_models/guided-onboarding.control-model"), exports);
+tslib_1.__exportStar(require("./_models/narration-player.interface"), exports);
+tslib_1.__exportStar(require("./_models/narration-player.control-model"), exports);
 // COLLECTIONS
 tslib_1.__exportStar(require("./_collections/audio-mixer.util"), exports);
 tslib_1.__exportStar(require("./_collections/audio-scale.util"), exports);

package/build/_modules/game/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":";;;AAAA,QAAQ;AACR,sEAA4C;AAE5C,SAAS;AACT,iFAAuD;AACvD,mFAAyD;AACzD,gFAAsD;AACtD,8EAAoD;AACpD,0EAAgD;AAChD,kFAAwD;AACxD,gFAAsD;AACtD,qFAA2D;AAC3D,yFAA+D;AAC/D,4EAAkD;AAClD,gFAAsD;AACtD,+EAAqD;AACrD,mFAAyD;AACzD,wEAA8C;AAC9C,mFAAyD;AACzD,uFAA6D;AAC7D,gFAAsD;AACtD,uEAA6C;AAC7C,2EAAiD;AACjD,2EAAiD;AACjD,wFAA8D;AAE9D,cAAc;AACd,0EAAgD;AAChD,0EAAgD;AAChD,wEAA8C;AAC9C,gFAAsD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/game/index.ts"],"names":[],"mappings":";;;AAAA,QAAQ;AACR,sEAA4C;AAE5C,SAAS;AACT,iFAAuD;AACvD,mFAAyD;AACzD,gFAAsD;AACtD,8EAAoD;AACpD,0EAAgD;AAChD,kFAAwD;AACxD,gFAAsD;AACtD,qFAA2D;AAC3D,yFAA+D;AAC/D,4EAAkD;AAClD,gFAAsD;AACtD,+EAAqD;AACrD,mFAAyD;AACzD,wEAA8C;AAC9C,mFAAyD;AACzD,uFAA6D;AAC7D,gFAAsD;AACtD,uEAA6C;AAC7C,2EAAiD;AACjD,2EAAiD;AACjD,wFAA8D;AAC9D,gFAAsD;AACtD,oFAA0D;AAC1D,+EAAqD;AACrD,mFAAyD;AAEzD,cAAc;AACd,0EAAgD;AAChD,0EAAgD;AAChD,wEAA8C;AAC9C,gFAAsD"}