@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/core/SceneComponents.d.ts

@@ -1,67 +0,0 @@
-import type { Scene } from './Scene.ts';
-/**
- * One self-contained section of a scene - map logic, encounter logic, UI wiring - with its
- * own slice of `core.Scene`'s lifecycle, registered by name into a `SceneComponentHost`
- * instead of folded into one growing scene class.
- *
- * Every hook is optional and receives the owning scene, so a component reads whatever the
- * scene exposes (a `two-d.Scene2D`'s `stage`, a game's own fields) without the host needing
- * to know what a scene actually is beyond `core.Scene`'s lifecycle shape.
- */
-export interface SceneComponent<TScene extends Scene = Scene> {
-    readonly name: string;
-    create?(scene: TScene): void;
-    update?(scene: TScene, dt: number): void;
-    resize?(scene: TScene, width: number, height: number): void;
-    onSuspend?(scene: TScene): void;
-    onResume?(scene: TScene, result: unknown): void;
-    destroy?(scene: TScene): void;
-}
-/**
- * Composes a scene out of named `SceneComponent`s instead of one class accreting every
- * responsibility a scene ends up needing - a factory assembling named sections (map,
- * encounters, UI) at scene-creation time, each a separate module with its own lifecycle.
- *
- * A composition helper, not a base class: a scene owns one `SceneComponentHost` and forwards
- * `core.Scene`'s lifecycle methods to it, the same few lines regardless of whether that scene
- * extends `core.Scene` directly or `two-d.Scene2D` - inheritance would have to pick one of
- * those to sit above, composition does not.
- *
- * @example
- * ```ts
- * import { Scene, SceneComponentHost, type SceneComponent } from '@datamoc/mw_games/core';
- *
- * class MapSection implements SceneComponent<DungeonScene> {
- *   readonly name = 'map';
- *   create(scene: DungeonScene): void { console.log('map ready for', scene.floor); }
- *   update(_scene: DungeonScene, dt: number): void { }
- * }
- *
- * class DungeonScene extends Scene {
- *   floor = 1;
- *   private components = new SceneComponentHost<DungeonScene>();
- *
- *   create(): void {
- *     this.components.add(new MapSection(), this);
- *   }
- *   override update(dt: number): void { this.components.update(this, dt); }
- *   protected override teardown(): void { this.components.destroy(this); }
- * }
- * ```
- */
-export declare class SceneComponentHost<TScene extends Scene = Scene> {
-    private order;
-    private registry;
-    /** registers `component` and immediately runs its `create`, if it has one */
-    add(component: SceneComponent<TScene>, scene: TScene): void;
-    has(name: string): boolean;
-    /** the component registered under `name`; throws if none was */
-    get<T extends SceneComponent<TScene> = SceneComponent<TScene>>(name: string): T;
-    update(scene: TScene, dt: number): void;
-    resize(scene: TScene, width: number, height: number): void;
-    onSuspend(scene: TScene): void;
-    onResume(scene: TScene, result: unknown): void;
-    /** destroys every component in reverse registration order, then forgets them all */
-    destroy(scene: TScene): void;
-}
-//# sourceMappingURL=SceneComponents.d.ts.map

package/dist/core/SceneComponents.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SceneComponents.d.ts","sourceRoot":"","sources":["../../src/core/SceneComponents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,SAAS,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,kBAAkB,CAAC,MAAM,SAAS,KAAK,GAAG,KAAK;IAC3D,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,QAAQ,CAA0C;IAE1D,6EAA6E;IAC7E,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAI1D;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED,gEAAgE;IAChE,GAAG,CAAC,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAE9E;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtC;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEzD;IAED,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAE7B;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAE7C;IAED,oFAAoF;IACpF,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI3B;CACD"}

package/dist/core/SceneComponents.js

@@ -1,76 +0,0 @@
-import { Registry } from './Registry.js';
-/**
- * Composes a scene out of named `SceneComponent`s instead of one class accreting every
- * responsibility a scene ends up needing - a factory assembling named sections (map,
- * encounters, UI) at scene-creation time, each a separate module with its own lifecycle.
- *
- * A composition helper, not a base class: a scene owns one `SceneComponentHost` and forwards
- * `core.Scene`'s lifecycle methods to it, the same few lines regardless of whether that scene
- * extends `core.Scene` directly or `two-d.Scene2D` - inheritance would have to pick one of
- * those to sit above, composition does not.
- *
- * @example
- * ```ts
- * import { Scene, SceneComponentHost, type SceneComponent } from '@datamoc/mw_games/core';
- *
- * class MapSection implements SceneComponent<DungeonScene> {
- *   readonly name = 'map';
- *   create(scene: DungeonScene): void { console.log('map ready for', scene.floor); }
- *   update(_scene: DungeonScene, dt: number): void { }
- * }
- *
- * class DungeonScene extends Scene {
- *   floor = 1;
- *   private components = new SceneComponentHost<DungeonScene>();
- *
- *   create(): void {
- *     this.components.add(new MapSection(), this);
- *   }
- *   override update(dt: number): void { this.components.update(this, dt); }
- *   protected override teardown(): void { this.components.destroy(this); }
- * }
- * ```
- */
-export class SceneComponentHost {
-    constructor() {
-        this.order = [];
-        this.registry = new Registry();
-    }
-    /** registers `component` and immediately runs its `create`, if it has one */
-    add(component, scene) {
-        this.registry.register(component.name, component);
-        this.order.push(component);
-        component.create?.(scene);
-    }
-    has(name) {
-        return this.registry.has(name);
-    }
-    /** the component registered under `name`; throws if none was */
-    get(name) {
-        return this.registry.get(name);
-    }
-    update(scene, dt) {
-        for (const c of this.order)
-            c.update?.(scene, dt);
-    }
-    resize(scene, width, height) {
-        for (const c of this.order)
-            c.resize?.(scene, width, height);
-    }
-    onSuspend(scene) {
-        for (const c of this.order)
-            c.onSuspend?.(scene);
-    }
-    onResume(scene, result) {
-        for (const c of this.order)
-            c.onResume?.(scene, result);
-    }
-    /** destroys every component in reverse registration order, then forgets them all */
-    destroy(scene) {
-        for (let i = this.order.length - 1; i >= 0; i--)
-            this.order[i].destroy?.(scene);
-        this.order = [];
-        this.registry = new Registry();
-    }
-}
-//# sourceMappingURL=SceneComponents.js.map

package/dist/core/SceneComponents.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SceneComponents.js","sourceRoot":"","sources":["../../src/core/SceneComponents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAqBzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,OAAO,kBAAkB;IAA/B;QACS,UAAK,GAA6B,EAAE,CAAC;QACrC,aAAQ,GAAG,IAAI,QAAQ,EAA0B,CAAC;IAwC3D,CAAC;IAtCA,6EAA6E;IAC7E,GAAG,CAAC,SAAiC,EAAE,KAAa;QACnD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,gEAAgE;IAChE,GAAG,CAA4D,IAAY;QAC1E,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAM,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,EAAU;QAC/B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,CAAC,KAAa,EAAE,KAAa,EAAE,MAAc;QAClD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,SAAS,CAAC,KAAa;QACtB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,CAAC,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,QAAQ,CAAC,KAAa,EAAE,MAAe;QACtC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,oFAAoF;IACpF,OAAO,CAAC,KAAa;QACpB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QAChF,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,EAA0B,CAAC;IACxD,CAAC;CACD"}

package/dist/core/SceneStack.d.ts

@@ -1,61 +0,0 @@
-import type { Scene } from './Scene.ts';
-/**
- * The stack of scenes a `Game` runs: exactly one updates, all render.
- *
- * Generic over the scene type, and typed against `core.Scene`'s lifecycle rather than any
- * display node, so a Pixi game uses `SceneStack<Scene2D>` and a Babylon game its own - this
- * class only ever calls `create`, `destroy`, `resize`, `update`, `onSuspend` and `onResume`.
- *
- * `switchScene` replaces the whole stack, for moving between screens.
- * `pushScene` suspends the current scene and starts another on top of it - a
- * minigame over the dungeon, a pause menu over play - and `popScene` destroys
- * the top and resumes whatever was underneath, reporting back a result. Only
- * the top scene updates; every scene in the stack stays in the display list, so
- * a pushed scene can be translucent (layered *over*) or opaque (*instead of*).
- *
- * Takes instances, never classes: constructing scenes is the `Game`'s job, and
- * keeping it out is what keeps this testable without a browser.
- *
- * @example
- * ```ts
- * import { SceneStack, Scene } from '@datamoc/mw_games/core';
- *
- * class DungeonScene extends Scene {
- *   create(): void {}
- *   onResume(result: unknown): void {
- *     console.log('the pushed scene reported back', result);
- *   }
- * }
- * class PauseMenu extends Scene {
- *   create(): void {}
- * }
- *
- * const stack = new SceneStack();
- * stack.replace(new DungeonScene());
- * stack.push(new PauseMenu()); // dungeon suspends, pause menu draws over it
- * stack.pop('resumed'); // pause menu destroyed, DungeonScene.onResume('resumed') fires
- * ```
- */
-export declare class SceneStack<T extends Scene = Scene> {
-    private scenes;
-    /** the scene that updates, or null when the stack is empty */
-    get current(): T | null;
-    get depth(): number;
-    /** replaces everything with one scene, destroying what was there */
-    replace(scene: T): void;
-    /** suspends the current scene and starts another above it */
-    push(scene: T): void;
-    /**
-     * Destroys the top scene and resumes the one below with `result`.
-     *
-     * Throws when only one scene is left: popping it would leave the game with
-     * nothing to run, which is always an authoring error rather than intent.
-     */
-    pop(result?: unknown): void;
-    /** only the top scene runs; the suspended ones wait underneath */
-    update(dt: number): void;
-    /** every scene relayouts, including the suspended ones waiting underneath */
-    resize(width: number, height: number): void;
-    destroy(): void;
-}
-//# sourceMappingURL=SceneStack.d.ts.map

package/dist/core/SceneStack.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SceneStack.d.ts","sourceRoot":"","sources":["../../src/core/SceneStack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,UAAU,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK;IAC9C,OAAO,CAAC,MAAM,CAAW;IAEzB,8DAA8D;IAC9D,IAAI,OAAO,IAAI,CAAC,GAAG,IAAI,CAEtB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,oEAAoE;IACpE,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAItB;IAED,6DAA6D;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAInB;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAO1B;IAED,kEAAkE;IAClE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvB;IAED,6EAA6E;IAC7E,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1C;IAED,OAAO,IAAI,IAAI,CAGd;CACD"}

package/dist/core/SceneStack.js

@@ -1,91 +0,0 @@
-/**
- * The stack of scenes a `Game` runs: exactly one updates, all render.
- *
- * Generic over the scene type, and typed against `core.Scene`'s lifecycle rather than any
- * display node, so a Pixi game uses `SceneStack<Scene2D>` and a Babylon game its own - this
- * class only ever calls `create`, `destroy`, `resize`, `update`, `onSuspend` and `onResume`.
- *
- * `switchScene` replaces the whole stack, for moving between screens.
- * `pushScene` suspends the current scene and starts another on top of it - a
- * minigame over the dungeon, a pause menu over play - and `popScene` destroys
- * the top and resumes whatever was underneath, reporting back a result. Only
- * the top scene updates; every scene in the stack stays in the display list, so
- * a pushed scene can be translucent (layered *over*) or opaque (*instead of*).
- *
- * Takes instances, never classes: constructing scenes is the `Game`'s job, and
- * keeping it out is what keeps this testable without a browser.
- *
- * @example
- * ```ts
- * import { SceneStack, Scene } from '@datamoc/mw_games/core';
- *
- * class DungeonScene extends Scene {
- *   create(): void {}
- *   onResume(result: unknown): void {
- *     console.log('the pushed scene reported back', result);
- *   }
- * }
- * class PauseMenu extends Scene {
- *   create(): void {}
- * }
- *
- * const stack = new SceneStack();
- * stack.replace(new DungeonScene());
- * stack.push(new PauseMenu()); // dungeon suspends, pause menu draws over it
- * stack.pop('resumed'); // pause menu destroyed, DungeonScene.onResume('resumed') fires
- * ```
- */
-export class SceneStack {
-    constructor() {
-        this.scenes = [];
-    }
-    /** the scene that updates, or null when the stack is empty */
-    get current() {
-        return this.scenes.length === 0 ? null : this.scenes[this.scenes.length - 1];
-    }
-    get depth() {
-        return this.scenes.length;
-    }
-    /** replaces everything with one scene, destroying what was there */
-    replace(scene) {
-        for (const old of this.scenes)
-            old.destroy();
-        this.scenes = [scene];
-        scene.create();
-    }
-    /** suspends the current scene and starts another above it */
-    push(scene) {
-        this.current?.onSuspend();
-        this.scenes.push(scene);
-        scene.create();
-    }
-    /**
-     * Destroys the top scene and resumes the one below with `result`.
-     *
-     * Throws when only one scene is left: popping it would leave the game with
-     * nothing to run, which is always an authoring error rather than intent.
-     */
-    pop(result) {
-        if (this.scenes.length <= 1) {
-            throw new Error('cannot pop the last scene off the stack - switchScene somewhere instead');
-        }
-        const top = this.scenes.pop();
-        top?.destroy();
-        this.current?.onResume(result);
-    }
-    /** only the top scene runs; the suspended ones wait underneath */
-    update(dt) {
-        this.current?.update(dt);
-    }
-    /** every scene relayouts, including the suspended ones waiting underneath */
-    resize(width, height) {
-        for (const scene of this.scenes)
-            scene.resize(width, height);
-    }
-    destroy() {
-        for (const scene of this.scenes)
-            scene.destroy();
-        this.scenes = [];
-    }
-}
-//# sourceMappingURL=SceneStack.js.map

package/dist/core/SceneStack.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"SceneStack.js","sourceRoot":"","sources":["../../src/core/SceneStack.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,UAAU;IAAvB;QACS,WAAM,GAAQ,EAAE,CAAC;IAsD1B,CAAC;IApDA,8DAA8D;IAC9D,IAAI,OAAO;QACV,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,oEAAoE;IACpE,OAAO,CAAC,KAAQ;QACf,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM;YAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,KAAK,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,6DAA6D;IAC7D,IAAI,CAAC,KAAQ;QACZ,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,KAAK,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,MAAgB;QACnB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAC9B,GAAG,EAAE,OAAO,EAAE,CAAC;QACf,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,kEAAkE;IAClE,MAAM,CAAC,EAAU;QAChB,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,6EAA6E;IAC7E,MAAM,CAAC,KAAa,EAAE,MAAc;QACnC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO;QACN,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IAClB,CAAC;CACD"}

package/dist/core/Scramble.d.ts

@@ -1,21 +0,0 @@
-/**
- * XOR-with-a-key text scrambling. This is explicitly **not encryption** and must never be
- * presented to a player or a game's own documentation as one: it stops a save being
- * hand-edited by someone opening it in a text editor, and deliberately nothing stronger -
- * the key is recoverable from the scrambled text plus any known plaintext fragment, the
- * classic XOR weakness, accepted on purpose rather than overlooked. Reach for this only
- * where "not trivially editable" is the actual requirement, per `SaveSystem.exportSlot`'s
- * own use of it.
- *
- * @example
- * ```ts
- * import { scramble, unscramble } from '@datamoc/mw_games/core';
- *
- * const scrambled = scramble('{"depth":3}', 'a-per-game-key');
- * const restored = unscramble(scrambled, 'a-per-game-key'); // '{"depth":3}'
- * ```
- */
-export declare function scramble(text: string, key: string): string;
-/** reverses `scramble`; throws if `key` does not match the one it was scrambled with (garbled UTF-8 rather than a silent wrong answer) */
-export declare function unscramble(payload: string, key: string): string;
-//# sourceMappingURL=Scramble.d.ts.map

package/dist/core/Scramble.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Scramble.d.ts","sourceRoot":"","sources":["../../src/core/Scramble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED,0IAA0I;AAC1I,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO/D"}

package/dist/core/Scramble.js

@@ -1,52 +0,0 @@
-/**
- * XOR-with-a-key text scrambling. This is explicitly **not encryption** and must never be
- * presented to a player or a game's own documentation as one: it stops a save being
- * hand-edited by someone opening it in a text editor, and deliberately nothing stronger -
- * the key is recoverable from the scrambled text plus any known plaintext fragment, the
- * classic XOR weakness, accepted on purpose rather than overlooked. Reach for this only
- * where "not trivially editable" is the actual requirement, per `SaveSystem.exportSlot`'s
- * own use of it.
- *
- * @example
- * ```ts
- * import { scramble, unscramble } from '@datamoc/mw_games/core';
- *
- * const scrambled = scramble('{"depth":3}', 'a-per-game-key');
- * const restored = unscramble(scrambled, 'a-per-game-key'); // '{"depth":3}'
- * ```
- */
-export function scramble(text, key) {
-    if (!key)
-        throw new Error('scramble needs a non-empty key');
-    const bytes = new TextEncoder().encode(text);
-    const keyBytes = new TextEncoder().encode(key);
-    const out = new Uint8Array(bytes.length);
-    for (let i = 0; i < bytes.length; i++)
-        out[i] = bytes[i] ^ keyBytes[i % keyBytes.length];
-    return toBase64(out);
-}
-/** reverses `scramble`; throws if `key` does not match the one it was scrambled with (garbled UTF-8 rather than a silent wrong answer) */
-export function unscramble(payload, key) {
-    if (!key)
-        throw new Error('scramble needs a non-empty key');
-    const bytes = fromBase64(payload);
-    const keyBytes = new TextEncoder().encode(key);
-    const out = new Uint8Array(bytes.length);
-    for (let i = 0; i < bytes.length; i++)
-        out[i] = bytes[i] ^ keyBytes[i % keyBytes.length];
-    return new TextDecoder('utf-8', { fatal: true }).decode(out);
-}
-function toBase64(bytes) {
-    let binary = '';
-    for (const byte of bytes)
-        binary += String.fromCharCode(byte);
-    return btoa(binary);
-}
-function fromBase64(text) {
-    const binary = atob(text);
-    const bytes = new Uint8Array(binary.length);
-    for (let i = 0; i < binary.length; i++)
-        bytes[i] = binary.charCodeAt(i);
-    return bytes;
-}
-//# sourceMappingURL=Scramble.js.map

package/dist/core/Scramble.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Scramble.js","sourceRoot":"","sources":["../../src/core/Scramble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,GAAW;IACjD,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzF,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACtB,CAAC;AAED,0IAA0I;AAC1I,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,GAAW;IACtD,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACzF,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAiB;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/core/Session.d.ts

@@ -1,31 +0,0 @@
-import { type SaveStorage } from './Save.ts';
-/**
- * Counts how many times a game has been launched, persisted across page loads.
- *
- * Not an achievement, a quest counter, or anything a game reads to change its own
- * behaviour: the one thing this exists for is the signal a native wrapper (Capacitor,
- * Tauri, whatever a game ships through) needs to decide whether a player has used the
- * game enough to plausibly be worth asking for a rating. `mwg` only counts; it never
- * prompts, and has no opinion on what "enough" means.
- *
- * @example
- * ```ts
- * import { Session } from '@datamoc/mw_games/core';
- *
- * const session = new Session({ namespace: 'my-game' });
- * if (session.launches === 5) {
- *   // a native wrapper's own moment to ask for a rating - mwg never prompts itself
- * }
- * ```
- */
-export interface SessionOptions {
-    /** namespaces the count, so two games sharing an origin never collide */
-    namespace?: string;
-    storage?: SaveStorage;
-}
-export declare class Session {
-    /** how many times this game has been launched, including this one */
-    readonly launches: number;
-    constructor(options?: SessionOptions);
-}
-//# sourceMappingURL=Session.d.ts.map

package/dist/core/Session.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../src/core/Session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7D;;;;;;;;;;;;;;;;;;GAkBG;AAEH,MAAM,WAAW,cAAc;IAC9B,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,OAAO;IACnB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,YAAY,OAAO,GAAE,cAAmB,EAOvC;CACD"}

package/dist/core/Session.js

@@ -1,11 +0,0 @@
-import { defaultStorage } from './Save.js';
-export class Session {
-    constructor(options = {}) {
-        const storage = options.storage ?? defaultStorage();
-        const key = `mwg-session:${options.namespace ?? 'default'}`;
-        const previous = Number(storage.read(key) ?? '0');
-        this.launches = (Number.isFinite(previous) ? previous : 0) + 1;
-        storage.write(key, String(this.launches));
-    }
-}
-//# sourceMappingURL=Session.js.map

package/dist/core/Session.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Session.js","sourceRoot":"","sources":["../../src/core/Session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAoB,MAAM,WAAW,CAAC;AA4B7D,MAAM,OAAO,OAAO;IAInB,YAAY,OAAO,GAAmB,EAAE;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,eAAe,OAAO,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;QAE5D,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC/D,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,CAAC;CACD"}

package/dist/core/Settings.d.ts

@@ -1,96 +0,0 @@
-import { type SaveStorage } from './Save.ts';
-import { type Action } from './Input.ts';
-/** a game-defined value: hints on/off, a violence level, anything JSON-flat */
-export type CustomSettingValue = string | number | boolean;
-/** the player-facing values `Settings` persists; everything is renderer-free on purpose */
-export interface GameSettings {
-    /** background-music level, 0 to 1 */
-    musicVolume: number;
-    /** sound-effect level, 0 to 1 */
-    sfxVolume: number;
-    /** master mute: both effective volumes read 0 while true, levels are kept */
-    muted: boolean;
-    /** the zoom a game applies to its own `Camera`; never below 0.01, like `Camera` itself */
-    zoom: number;
-    /** key bindings, in the shape `Input.exportBindings` writes and `importBindings` reads */
-    bindings: Record<Action, string[]>;
-    /** game-defined values beyond the built-ins above (`hints`, `violence`, ...), keyed by name */
-    custom: Record<string, CustomSettingValue>;
-}
-export interface SettingsOptions {
-    /** namespaces the storage key, so two games sharing an origin never collide */
-    namespace?: string;
-    storage?: SaveStorage;
-}
-/**
- * The values a fresh game starts with: full volume, unmuted, zoom 1, default bindings.
- *
- * @example
- * ```ts
- * import { defaultSettings } from '@datamoc/mw_games/core';
- *
- * console.log(defaultSettings().zoom); // 1
- * ```
- */
-export declare function defaultSettings(): GameSettings;
-/** what a game hands its own audio objects: 0 while muted, the stored level otherwise */
-export declare function effectiveMusicVolume(settings: Pick<GameSettings, 'musicVolume' | 'muted'>): number;
-/** what a game hands its own sound effects: 0 while muted, the stored level otherwise */
-export declare function effectiveSfxVolume(settings: Pick<GameSettings, 'sfxVolume' | 'muted'>): number;
-/**
- * Persisted player settings: music and sound-effect levels, master mute, zoom preference,
- * and key bindings, read back on the next launch.
- *
- * The values live in `core` so they stay renderer-free; the wiring stays with the game,
- * which assigns them onto its own `Music`/`Sound`/`Camera` (see the example). Bindings are
- * the exception: they are applied to `Input` on load and on every bindings mutation,
- * since persisted keys that a game must remember to apply would silently do nothing.
- *
- * Corrupt storage reads as defaults rather than throwing: a settings screen should show
- * the defaults, not a crash.
- *
- * @example
- * ```ts
- * import { Settings, effectiveMusicVolume, effectiveSfxVolume } from '@datamoc/mw_games/core';
- *
- * const settings = new Settings({ namespace: 'my-game' });
- * settings.update({ musicVolume: 0.7, zoom: 2 });
- * settings.setCustom('hints', true);
- *
- * const music = { volume: 1 };
- * const camera = { zoom: 1 };
- * music.volume = effectiveMusicVolume(settings.current);
- * camera.zoom = settings.current.zoom;
- * console.log(effectiveSfxVolume(settings.current), settings.getCustom('hints', false));
- * ```
- */
-export declare class Settings {
-    private readonly storage;
-    private readonly key;
-    private value;
-    constructor(options?: SettingsOptions);
-    /** a copy of the current values; mutating it writes nothing back, use the setters */
-    get current(): GameSettings;
-    /** a game-defined value (`hints`, `violence`, ...), or `fallback` when never set */
-    getCustom(key: string, fallback: CustomSettingValue): CustomSettingValue;
-    /** stores a game-defined value and persists it */
-    setCustom(key: string, value: CustomSettingValue): void;
-    setMusicVolume(volume: number): void;
-    setSfxVolume(volume: number): void;
-    setMuted(muted: boolean): void;
-    setZoom(zoom: number): void;
-    setBindings(bindings: Readonly<Record<Action, readonly string[]>>): void;
-    update(patch: {
-        musicVolume?: number;
-        sfxVolume?: number;
-        muted?: boolean;
-        zoom?: number;
-        bindings?: Readonly<Record<Action, readonly string[]>>;
-        custom?: Readonly<Record<string, CustomSettingValue>>;
-    }): void;
-    /** re-applies the stored bindings to `Input`, for a game that installed its own after this was built */
-    applyBindings(): void;
-    /** back to full volume, unmuted, zoom 1 and the default bindings, persisted */
-    reset(): void;
-}
-//# sourceMappingURL=Settings.d.ts.map

package/dist/core/Settings.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Settings.d.ts","sourceRoot":"","sources":["../../src/core/Settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAoC,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAG3E,+EAA+E;AAC/E,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IAC5B,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,KAAK,EAAE,OAAO,CAAC;IACf,0FAA0F;IAC1F,IAAI,EAAE,MAAM,CAAC;IACb,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnC,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,eAAe;IAC/B,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAS9C;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,MAAM,CAElG;AAED,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,MAAM,CAE9F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,QAAQ;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,KAAK,CAAe;IAE5B,YAAY,OAAO,GAAE,eAAoB,EAKxC;IAED,qFAAqF;IACrF,IAAI,OAAO,IAAI,YAAY,CAE1B;IAED,oFAAoF;IACpF,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,kBAAkB,CAEvE;IAED,kDAAkD;IAClD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAGtD;IAED,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEnC;IAED,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEjC;IAED,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE7B;IAED,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE1B;IAED,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,CAEvE;IAED,MAAM,CAAC,KAAK,EAAE;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC;KACtD,GAAG,IAAI,CAWP;IAED,wGAAwG;IACxG,aAAa,IAAI,IAAI,CAEpB;IAED,+EAA+E;IAC/E,KAAK,IAAI,IAAI,CAIZ;CACD"}