@joydle/ui 0.1.0

package/dist/controls/index.d.ts

@@ -0,0 +1,6 @@
+export { TouchDPad, type TouchDPadProps } from './TouchDPad.js';
+export { Joystick, type JoystickProps } from './Joystick.js';
+export { ActionButton, type ActionButtonProps, type ActionButtonSize, } from './ActionButton.js';
+export { ActionButtonGroup, type ActionButtonGroupProps, type ActionButtonConfig, } from './ActionButtonGroup.js';
+export { SwipeZone, type SwipeZoneProps, type SwipeDirection, } from './SwipeZone.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/controls/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/controls/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,GACxB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/controls/index.js

@@ -0,0 +1,9 @@
+// ---------------------------------------------------------------------------
+//  @joydle/ui/controls — barrel export
+// ---------------------------------------------------------------------------
+export { TouchDPad } from './TouchDPad.js';
+export { Joystick } from './Joystick.js';
+export { ActionButton, } from './ActionButton.js';
+export { ActionButtonGroup, } from './ActionButtonGroup.js';
+export { SwipeZone, } from './SwipeZone.js';
+//# sourceMappingURL=index.js.map

package/dist/controls/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/controls/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E,OAAO,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAsB,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,YAAY,GAGb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,iBAAiB,GAGlB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,SAAS,GAGV,MAAM,gBAAgB,CAAC"}

package/dist/core/GameShell.d.ts

@@ -0,0 +1,43 @@
+import type { ComponentChildren } from 'preact';
+import { InputManager } from './InputManager';
+import { ScaleManager, type ScaleMode } from './ScaleManager';
+import { GameState } from './GameState';
+import type { BridgeInstance, ThemeConfig, GameStateShape } from './types';
+export interface GameContextValue {
+    inputManager: InputManager;
+    scaleManager: ScaleManager;
+    gameState: GameState<GameStateShape>;
+    bridge: BridgeInstance;
+}
+/**
+ * Context shared with all descendant components.
+ * Access via `useContext(GameContext)` or the `useGame()` hook.
+ */
+export declare const GameContext: import("preact").Context<GameContextValue | null>;
+export interface GameShellProps {
+    /** Logical game width in pixels. */
+    width: number;
+    /** Logical game height in pixels. */
+    height: number;
+    /** The renderer bridge instance. */
+    renderer: BridgeInstance;
+    /** Optional theme configuration. */
+    theme?: ThemeConfig;
+    /** Canvas scale mode (default: `"letterbox"`). */
+    scaleMode?: ScaleMode;
+    /** Overlay UI rendered on top of the canvas. */
+    children?: ComponentChildren;
+}
+/**
+ * Root shell that wires up a renderer bridge, input manager, and scale
+ * manager.  Renders an overlay `<div>` on top of the canvas for HUD /
+ * screen components.
+ *
+ * ```tsx
+ * <GameShell width={800} height={600} renderer={bridge}>
+ *   <HUD />
+ * </GameShell>
+ * ```
+ */
+export declare function GameShell({ width, height, renderer, theme, scaleMode, children, }: GameShellProps): import("preact").JSX.Element;
+//# sourceMappingURL=GameShell.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GameShell.d.ts","sourceRoot":"","sources":["../../src/core/GameShell.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI3E,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IACrC,MAAM,EAAE,cAAc,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,mDAA+C,CAAC;AAIxE,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,EAAE,cAAc,CAAC;IACzB,oCAAoC;IACpC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,kDAAkD;IAClD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAsBD;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,MAAM,EACN,QAAQ,EACR,KAAK,EACL,SAAuB,EACvB,QAAQ,GACT,EAAE,cAAc,gCA+EhB"}

package/dist/core/GameShell.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+// ---------------------------------------------------------------------------
+//  @joydle/ui — Root container component (Preact)
+// ---------------------------------------------------------------------------
+import { createContext } from 'preact';
+import { useEffect, useRef, useMemo } from 'preact/hooks';
+import { InputManager } from './InputManager';
+import { ScaleManager } from './ScaleManager';
+import { GameState } from './GameState';
+/**
+ * Context shared with all descendant components.
+ * Access via `useContext(GameContext)` or the `useGame()` hook.
+ */
+export const GameContext = createContext(null);
+// ---- Styles ---------------------------------------------------------------
+const SHELL_STYLE = {
+    position: 'relative',
+    overflow: 'hidden',
+    width: '100%',
+    height: '100%',
+};
+const OVERLAY_STYLE = {
+    position: 'absolute',
+    top: '0',
+    left: '0',
+    width: '100%',
+    height: '100%',
+    pointerEvents: 'none',
+};
+// ---- Component ------------------------------------------------------------
+/**
+ * Root shell that wires up a renderer bridge, input manager, and scale
+ * manager.  Renders an overlay `<div>` on top of the canvas for HUD /
+ * screen components.
+ *
+ * ```tsx
+ * <GameShell width={800} height={600} renderer={bridge}>
+ *   <HUD />
+ * </GameShell>
+ * ```
+ */
+export function GameShell({ width, height, renderer, theme, scaleMode = 'letterbox', children, }) {
+    const containerRef = useRef(null);
+    // Stable managers created once per mount.
+    const inputManager = useMemo(() => new InputManager(), []);
+    const scaleManager = useMemo(() => new ScaleManager(renderer.canvas, width, height, scaleMode), 
+    // Intentionally only depends on renderer identity.
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [renderer]);
+    const gameState = useMemo(() => new GameState({ screen: '' }), []);
+    // Mount the renderer canvas into our container.
+    useEffect(() => {
+        const container = containerRef.current;
+        if (!container)
+            return;
+        renderer.mount(container);
+        // Attach the renderer's input adapter to our InputManager.
+        const adapter = renderer.getInputAdapter();
+        adapter.attach(inputManager, renderer.canvas);
+        // Notify the renderer of the logical size.
+        renderer.resize(width, height);
+        return () => {
+            adapter.detach();
+            renderer.dispose();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [renderer]);
+    // Tear down managers on unmount.
+    useEffect(() => {
+        return () => {
+            inputManager.destroy();
+            scaleManager.destroy();
+        };
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, []);
+    // Apply theme CSS custom properties to the shell element.
+    // When a full ThemeConfig is provided the ThemeProvider is the canonical
+    // source of CSS vars, so we only set a minimal subset here as a fallback.
+    const shellStyle = useMemo(() => {
+        const base = { ...SHELL_STYLE };
+        if (theme) {
+            base['--joydle-primary'] = theme.primary;
+            base['--joydle-bg'] = theme.bg;
+            base['--joydle-font'] = theme.font;
+        }
+        return base;
+    }, [theme]);
+    const ctxValue = useMemo(() => ({ inputManager, scaleManager, gameState, bridge: renderer }), [inputManager, scaleManager, gameState, renderer]);
+    return (_jsx(GameContext.Provider, { value: ctxValue, children: _jsxs("div", { class: "joydle-shell", style: shellStyle, children: [_jsx("div", { ref: containerRef, style: { width: '100%', height: '100%' } }), _jsx("div", { class: "joydle-overlay", style: OVERLAY_STYLE, children: children })] }) }));
+}
+//# sourceMappingURL=GameShell.js.map

package/dist/core/GameShell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameShell.js","sourceRoot":"","sources":["../../src/core/GameShell.tsx"],"names":[],"mappings":"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"}

package/dist/core/GameState.d.ts

@@ -0,0 +1,35 @@
+import type { GameStateShape } from './types';
+/**
+ * Minimal reactive state container for game UI.
+ *
+ * - `set()` merges partial updates into the state object.
+ * - Multiple `set()` calls within the same microtask are coalesced into a
+ *   single subscriber notification (via `queueMicrotask`).
+ * - Built-in `screen` management for menu / gameplay / pause flow.
+ */
+export declare class GameState<T extends GameStateShape> {
+    private state;
+    private listeners;
+    private notifyScheduled;
+    constructor(initial: T);
+    /** Read a single key from the state. */
+    get<K extends keyof T>(key: K): T[K];
+    /** Return the entire state as a readonly shallow clone. */
+    getAll(): Readonly<T>;
+    /**
+     * Merge `partial` into the state.  Multiple calls within the same
+     * microtask are batched — subscribers fire at most once per microtask.
+     */
+    set(partial: Partial<T>): void;
+    /** Convenience getter for the `screen` key (defaults to `""`). */
+    get screen(): string;
+    /** Convenience setter — equivalent to `set({ screen: name })`. */
+    setScreen(name: string): void;
+    /**
+     * Register a listener that fires whenever state changes.
+     * Returns an unsubscribe function.
+     */
+    subscribe(listener: (state: T) => void): () => void;
+    private scheduleNotify;
+}
+//# sourceMappingURL=GameState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GameState.d.ts","sourceRoot":"","sources":["../../src/core/GameState.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;GAOG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,cAAc;IAC7C,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,EAAE,CAAC;IAOtB,wCAAwC;IACxC,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAIpC,2DAA2D;IAC3D,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC;IAMrB;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAS9B,kEAAkE;IAClE,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,kEAAkE;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM7B;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IASnD,OAAO,CAAC,cAAc;CAWvB"}

package/dist/core/GameState.js

@@ -0,0 +1,74 @@
+// ---------------------------------------------------------------------------
+//  @joydle/ui — Pub/sub state store with batched notifications
+// ---------------------------------------------------------------------------
+/**
+ * Minimal reactive state container for game UI.
+ *
+ * - `set()` merges partial updates into the state object.
+ * - Multiple `set()` calls within the same microtask are coalesced into a
+ *   single subscriber notification (via `queueMicrotask`).
+ * - Built-in `screen` management for menu / gameplay / pause flow.
+ */
+export class GameState {
+    state;
+    listeners = new Set();
+    notifyScheduled = false;
+    constructor(initial) {
+        // Shallow-clone so we own the object.
+        this.state = { ...initial };
+    }
+    // -- Read -----------------------------------------------------------------
+    /** Read a single key from the state. */
+    get(key) {
+        return this.state[key];
+    }
+    /** Return the entire state as a readonly shallow clone. */
+    getAll() {
+        return { ...this.state };
+    }
+    // -- Write ----------------------------------------------------------------
+    /**
+     * Merge `partial` into the state.  Multiple calls within the same
+     * microtask are batched — subscribers fire at most once per microtask.
+     */
+    set(partial) {
+        // Apply the update immediately so subsequent `get()` calls within the
+        // same synchronous block see the new value.
+        Object.assign(this.state, partial);
+        this.scheduleNotify();
+    }
+    // -- Screen shorthand -----------------------------------------------------
+    /** Convenience getter for the `screen` key (defaults to `""`). */
+    get screen() {
+        return this.state['screen'] ?? '';
+    }
+    /** Convenience setter — equivalent to `set({ screen: name })`. */
+    setScreen(name) {
+        this.set({ screen: name });
+    }
+    // -- Subscriptions --------------------------------------------------------
+    /**
+     * Register a listener that fires whenever state changes.
+     * Returns an unsubscribe function.
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    // -- Internal -------------------------------------------------------------
+    scheduleNotify() {
+        if (this.notifyScheduled)
+            return;
+        this.notifyScheduled = true;
+        queueMicrotask(() => {
+            this.notifyScheduled = false;
+            const snapshot = { ...this.state };
+            for (const fn of this.listeners) {
+                fn(snapshot);
+            }
+        });
+    }
+}
+//# sourceMappingURL=GameState.js.map

package/dist/core/GameState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameState.js","sourceRoot":"","sources":["../../src/core/GameState.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAI9E;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IACZ,KAAK,CAAI;IACT,SAAS,GAA4B,IAAI,GAAG,EAAE,CAAC;IAC/C,eAAe,GAAG,KAAK,CAAC;IAEhC,YAAY,OAAU;QACpB,sCAAsC;QACtC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;IAC9B,CAAC;IAED,4EAA4E;IAE5E,wCAAwC;IACxC,GAAG,CAAoB,GAAM;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,2DAA2D;IAC3D,MAAM;QACJ,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,4EAA4E;IAE5E;;;OAGG;IACH,GAAG,CAAC,OAAmB;QACrB,sEAAsE;QACtE,4CAA4C;QAC5C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,4EAA4E;IAE5E,kEAAkE;IAClE,IAAI,MAAM;QACR,OAAQ,IAAI,CAAC,KAAiC,CAAC,QAAQ,CAAW,IAAI,EAAE,CAAC;IAC3E,CAAC;IAED,kEAAkE;IAClE,SAAS,CAAC,IAAY;QACpB,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,EAA2B,CAAC,CAAC;IACtD,CAAC;IAED,4EAA4E;IAE5E;;;OAGG;IACH,SAAS,CAAC,QAA4B;QACpC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,4EAA4E;IAEpE,cAAc;QACpB,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO;QACjC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5B,cAAc,CAAC,GAAG,EAAE;YAClB,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;YAC7B,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACnC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChC,EAAE,CAAC,QAAQ,CAAC,CAAC;YACf,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/core/InputManager.d.ts

@@ -0,0 +1,39 @@
+import type { InputState } from './types';
+/**
+ * Maintains a frame-stable snapshot of all input axes and buttons.
+ *
+ * - Keyboard events are captured on `document`.
+ * - Pointer state and action overrides can be injected by external adapters
+ *   (touch controls, bridge input adapters) via `setPointer` / `setAction`.
+ * - `consume(action)` implements one-shot detection: returns `true` on the
+ *   first call after the action goes down, then `false` until released and
+ *   re-pressed.
+ */
+export declare class InputManager {
+    private held;
+    private consumed;
+    private _pointerX;
+    private _pointerY;
+    private _pointerDown;
+    private _pointerActive;
+    private onKeyDown;
+    private onKeyUp;
+    constructor();
+    /** Return a readonly snapshot of the current input state. */
+    getState(): Readonly<InputState>;
+    /**
+     * Returns `true` exactly once per press of the given action.
+     * Subsequent calls return `false` until the action is released and
+     * re-pressed.
+     */
+    consume(action: string): boolean;
+    /** Inject pointer state (e.g. from touch controls or bridge adapter). */
+    setPointer(x: number, y: number, down: boolean): void;
+    /** Inject an action value (e.g. from on-screen touch buttons). */
+    setAction(name: string, value: boolean): void;
+    /** Remove all event listeners. Call when the game shell unmounts. */
+    destroy(): void;
+    private handleKeyDown;
+    private handleKeyUp;
+}
+//# sourceMappingURL=InputManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InputManager.d.ts","sourceRoot":"","sources":["../../src/core/InputManager.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAoC1C;;;;;;;;;GASG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,IAAI,CAA+B;IAG3C,OAAO,CAAC,QAAQ,CAA0B;IAG1C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,cAAc,CAAS;IAG/B,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,OAAO,CAA6B;;IAY5C,6DAA6D;IAC7D,QAAQ,IAAI,QAAQ,CAAC,UAAU,CAAC;IA6BhC;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAShC,yEAAyE;IACzE,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI;IAOrD,kEAAkE;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAa7C,qEAAqE;IACrE,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,WAAW;CAOpB"}

package/dist/core/InputManager.js

@@ -0,0 +1,149 @@
+// ---------------------------------------------------------------------------
+//  @joydle/ui — Unified keyboard + pointer input manager
+// ---------------------------------------------------------------------------
+// ---- Key mappings ---------------------------------------------------------
+/** Sets of physical keys that map to each logical action. */
+const KEY_MAP = {
+    left: ['ArrowLeft', 'a', 'A'],
+    right: ['ArrowRight', 'd', 'D'],
+    up: ['ArrowUp', 'w', 'W'],
+    down: ['ArrowDown', 's', 'S'],
+    action: [' ', 'Enter'], // Space = ' '
+    action2: ['z', 'Z', 'j', 'J'],
+    action3: ['x', 'X', 'k', 'K'],
+    pause: ['Escape'],
+};
+/**
+ * Reverse lookup: physical key -> logical action name.
+ * Built once at module load time.
+ */
+const KEY_TO_ACTION = new Map();
+for (const [action, keys] of Object.entries(KEY_MAP)) {
+    for (const k of keys) {
+        KEY_TO_ACTION.set(k, action);
+    }
+}
+// ---- Action names that support `consume()` --------------------------------
+const CONSUMABLE = new Set([
+    'action', 'action2', 'action3', 'pause',
+    'left', 'right', 'up', 'down',
+]);
+// ---- InputManager ---------------------------------------------------------
+/**
+ * Maintains a frame-stable snapshot of all input axes and buttons.
+ *
+ * - Keyboard events are captured on `document`.
+ * - Pointer state and action overrides can be injected by external adapters
+ *   (touch controls, bridge input adapters) via `setPointer` / `setAction`.
+ * - `consume(action)` implements one-shot detection: returns `true` on the
+ *   first call after the action goes down, then `false` until released and
+ *   re-pressed.
+ */
+export class InputManager {
+    // Raw held-down state for keyboard-driven actions.
+    held = {};
+    // Tracks which actions have already been consumed this press.
+    consumed = new Set();
+    // Pointer state (written by setPointer or bridge adapter).
+    _pointerX = 0;
+    _pointerY = 0;
+    _pointerDown = false;
+    _pointerActive = false;
+    // Bound handlers kept for removeEventListener.
+    onKeyDown;
+    onKeyUp;
+    constructor() {
+        this.onKeyDown = this.handleKeyDown.bind(this);
+        this.onKeyUp = this.handleKeyUp.bind(this);
+        document.addEventListener('keydown', this.onKeyDown);
+        document.addEventListener('keyup', this.onKeyUp);
+    }
+    // -- Public: read state ---------------------------------------------------
+    /** Return a readonly snapshot of the current input state. */
+    getState() {
+        const left = !!this.held['left'];
+        const right = !!this.held['right'];
+        const up = !!this.held['up'];
+        const down = !!this.held['down'];
+        const dirX = left && !right ? -1 : right && !left ? 1 : 0;
+        const dirY = up && !down ? -1 : down && !up ? 1 : 0;
+        return {
+            left,
+            right,
+            up,
+            down,
+            dirX,
+            dirY,
+            action: !!this.held['action'],
+            action2: !!this.held['action2'],
+            action3: !!this.held['action3'],
+            pause: !!this.held['pause'],
+            pointerX: this._pointerX,
+            pointerY: this._pointerY,
+            pointerDown: this._pointerDown,
+            pointerActive: this._pointerActive,
+        };
+    }
+    // -- Public: consume (one-shot) -------------------------------------------
+    /**
+     * Returns `true` exactly once per press of the given action.
+     * Subsequent calls return `false` until the action is released and
+     * re-pressed.
+     */
+    consume(action) {
+        if (!this.held[action])
+            return false;
+        if (this.consumed.has(action))
+            return false;
+        this.consumed.add(action);
+        return true;
+    }
+    // -- Public: external writers ---------------------------------------------
+    /** Inject pointer state (e.g. from touch controls or bridge adapter). */
+    setPointer(x, y, down) {
+        this._pointerX = x;
+        this._pointerY = y;
+        this._pointerDown = down;
+        this._pointerActive = true;
+    }
+    /** Inject an action value (e.g. from on-screen touch buttons). */
+    setAction(name, value) {
+        const wasDown = !!this.held[name];
+        this.held[name] = value;
+        // Reset consumed flag when the action is released so the next press
+        // can be consumed again.
+        if (wasDown && !value) {
+            this.consumed.delete(name);
+        }
+    }
+    // -- Lifecycle ------------------------------------------------------------
+    /** Remove all event listeners. Call when the game shell unmounts. */
+    destroy() {
+        document.removeEventListener('keydown', this.onKeyDown);
+        document.removeEventListener('keyup', this.onKeyUp);
+    }
+    // -- Internal: keyboard ---------------------------------------------------
+    handleKeyDown(e) {
+        const action = KEY_TO_ACTION.get(e.key);
+        if (!action)
+            return;
+        // Prevent browser defaults for mapped keys (e.g. scrolling with arrows).
+        if (CONSUMABLE.has(action)) {
+            e.preventDefault();
+        }
+        const wasDown = !!this.held[action];
+        this.held[action] = true;
+        // Only clear consumed when transitioning from up -> down.
+        if (!wasDown) {
+            this.consumed.delete(action);
+        }
+    }
+    handleKeyUp(e) {
+        const action = KEY_TO_ACTION.get(e.key);
+        if (!action)
+            return;
+        this.held[action] = false;
+        this.consumed.delete(action);
+    }
+}
+//# sourceMappingURL=InputManager.js.map

package/dist/core/InputManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputManager.js","sourceRoot":"","sources":["../../src/core/InputManager.ts"],"names":[],"mappings":"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"}

package/dist/core/ScaleManager.d.ts

@@ -0,0 +1,38 @@
+export type ScaleMode = 'letterbox' | 'fill' | 'stretch';
+/**
+ * Keeps the renderer canvas sized correctly within its container.
+ *
+ * Supports three modes:
+ * - **letterbox** — uniform scale, centred, with bars on the short axis.
+ * - **fill** — uniform scale, cropped so no bars appear.
+ * - **stretch** — non-uniform, stretches to fill container exactly.
+ *
+ * The manager listens to `window.resize` and `orientationchange` and
+ * automatically recalculates.
+ */
+export declare class ScaleManager {
+    private canvas;
+    private gameWidth;
+    private gameHeight;
+    private mode;
+    private currentScale;
+    private offsetX;
+    private offsetY;
+    private onResize;
+    constructor(canvas: HTMLCanvasElement, gameWidth: number, gameHeight: number, mode?: ScaleMode);
+    /** Recalculate scale and update the canvas CSS dimensions. */
+    resize(): void;
+    /**
+     * Convert a DOM client coordinate (e.g. from a mouse event) into
+     * game-space coordinates (0..gameWidth, 0..gameHeight).
+     */
+    toGameCoords(clientX: number, clientY: number): {
+        x: number;
+        y: number;
+    };
+    /** Return the current uniform scale factor. */
+    getScale(): number;
+    /** Remove event listeners. */
+    destroy(): void;
+}
+//# sourceMappingURL=ScaleManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScaleManager.d.ts","sourceRoot":"","sources":["../../src/core/ScaleManager.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,IAAI,CAAY;IAExB,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,OAAO,CAAK;IAEpB,OAAO,CAAC,QAAQ,CAAa;gBAG3B,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,SAAuB;IAiB/B,8DAA8D;IAC9D,MAAM,IAAI,IAAI;IAiDd;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAexE,+CAA+C;IAC/C,QAAQ,IAAI,MAAM;IAIlB,8BAA8B;IAC9B,OAAO,IAAI,IAAI;CAIhB"}

package/dist/core/ScaleManager.js

@@ -0,0 +1,106 @@
+// ---------------------------------------------------------------------------
+//  @joydle/ui — Responsive canvas scaling
+// ---------------------------------------------------------------------------
+/**
+ * Keeps the renderer canvas sized correctly within its container.
+ *
+ * Supports three modes:
+ * - **letterbox** — uniform scale, centred, with bars on the short axis.
+ * - **fill** — uniform scale, cropped so no bars appear.
+ * - **stretch** — non-uniform, stretches to fill container exactly.
+ *
+ * The manager listens to `window.resize` and `orientationchange` and
+ * automatically recalculates.
+ */
+export class ScaleManager {
+    canvas;
+    gameWidth;
+    gameHeight;
+    mode;
+    currentScale = 1;
+    offsetX = 0;
+    offsetY = 0;
+    onResize;
+    constructor(canvas, gameWidth, gameHeight, mode = 'letterbox') {
+        this.canvas = canvas;
+        this.gameWidth = gameWidth;
+        this.gameHeight = gameHeight;
+        this.mode = mode;
+        this.onResize = this.resize.bind(this);
+        window.addEventListener('resize', this.onResize);
+        window.addEventListener('orientationchange', this.onResize);
+        // Initial sizing.
+        this.resize();
+    }
+    // -- Public ---------------------------------------------------------------
+    /** Recalculate scale and update the canvas CSS dimensions. */
+    resize() {
+        const parent = this.canvas.parentElement;
+        if (!parent)
+            return;
+        const containerW = parent.clientWidth;
+        const containerH = parent.clientHeight;
+        if (containerW === 0 || containerH === 0)
+            return;
+        const ratioX = containerW / this.gameWidth;
+        const ratioY = containerH / this.gameHeight;
+        let cssW;
+        let cssH;
+        switch (this.mode) {
+            case 'letterbox': {
+                const scale = Math.min(ratioX, ratioY);
+                this.currentScale = scale;
+                cssW = this.gameWidth * scale;
+                cssH = this.gameHeight * scale;
+                break;
+            }
+            case 'fill': {
+                const scale = Math.max(ratioX, ratioY);
+                this.currentScale = scale;
+                cssW = this.gameWidth * scale;
+                cssH = this.gameHeight * scale;
+                break;
+            }
+            case 'stretch': {
+                this.currentScale = ratioX; // arbitrary — stretch means non-uniform
+                cssW = containerW;
+                cssH = containerH;
+                break;
+            }
+        }
+        // Centre the canvas within the container.
+        this.offsetX = (containerW - cssW) / 2;
+        this.offsetY = (containerH - cssH) / 2;
+        this.canvas.style.width = `${cssW}px`;
+        this.canvas.style.height = `${cssH}px`;
+        this.canvas.style.position = 'absolute';
+        this.canvas.style.left = `${this.offsetX}px`;
+        this.canvas.style.top = `${this.offsetY}px`;
+    }
+    /**
+     * Convert a DOM client coordinate (e.g. from a mouse event) into
+     * game-space coordinates (0..gameWidth, 0..gameHeight).
+     */
+    toGameCoords(clientX, clientY) {
+        const rect = this.canvas.getBoundingClientRect();
+        const cssW = rect.width;
+        const cssH = rect.height;
+        // Normalise to 0..1 within the canvas element.
+        const normX = (clientX - rect.left) / cssW;
+        const normY = (clientY - rect.top) / cssH;
+        return {
+            x: normX * this.gameWidth,
+            y: normY * this.gameHeight,
+        };
+    }
+    /** Return the current uniform scale factor. */
+    getScale() {
+        return this.currentScale;
+    }
+    /** Remove event listeners. */
+    destroy() {
+        window.removeEventListener('resize', this.onResize);
+        window.removeEventListener('orientationchange', this.onResize);
+    }
+}
+//# sourceMappingURL=ScaleManager.js.map

package/dist/core/ScaleManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScaleManager.js","sourceRoot":"","sources":["../../src/core/ScaleManager.ts"],"names":[],"mappings":"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"}