cursedbelt 0.0.0

package/dist/game/core/drawBudget.js

@@ -0,0 +1,55 @@
+// Drop ~this fraction of `level` per frame, per multiple of target frame time over
+// budget. Recover this much per frame when comfortable. Asymmetric on purpose —
+// shed load fast, restore it gently — so quality doesn't oscillate.
+const DROP_COEFFICIENT = 0.05;
+const RECOVER_PER_FRAME = 0.01;
+/**
+ * Adaptive draw-quality governor. Tracks a rolling average of frame times and exposes
+ * a `level` games use to scale render cost so a struggling device stays responsive.
+ * Replaces the duplicated per-game copies.
+ */
+export function drawBudget(opts = {}) {
+    const { targetFps = 60, windowSize = 30 } = opts;
+    const targetMs = 1000 / targetFps;
+    const samples = [];
+    let sum = 0;
+    let avgMs = targetMs;
+    let level = 1;
+    return {
+        record(frameMs) {
+            if (!Number.isFinite(frameMs) || frameMs < 0)
+                return;
+            samples.push(frameMs);
+            sum += frameMs;
+            if (samples.length > windowSize)
+                sum -= samples.shift();
+            avgMs = sum / samples.length;
+            // headroom > 0 → comfortably under budget; < 0 → behind.
+            const headroom = targetMs - avgMs;
+            if (headroom < 0) {
+                // How many target-frames behind we are scales the drop; far behind drops fast.
+                level += (headroom / targetMs) * DROP_COEFFICIENT;
+            }
+            else {
+                level += RECOVER_PER_FRAME;
+            }
+            level = clamp01(level);
+        },
+        get level() {
+            return level;
+        },
+        get fps() {
+            if (samples.length === 0)
+                return targetFps; // nothing recorded yet → report the target
+            return avgMs > 0 ? 1000 / avgMs : targetFps;
+        },
+    };
+}
+function clamp01(value) {
+    if (value < 0)
+        return 0;
+    if (value > 1)
+        return 1;
+    return value;
+}
+//# sourceMappingURL=drawBudget.js.map

package/dist/game/core/drawBudget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawBudget.js","sourceRoot":"","sources":["../../../src/game/core/drawBudget.ts"],"names":[],"mappings":"AAqBA,mFAAmF;AACnF,gFAAgF;AAChF,oEAAoE;AACpE,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAA0B,EAAE;IACrD,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;IAElC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,QAAQ,CAAC;IACrB,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,OAAO;QACL,MAAM,CAAC,OAAe;YACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;gBAAE,OAAO;YAErD,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,GAAG,IAAI,OAAO,CAAC;YACf,IAAI,OAAO,CAAC,MAAM,GAAG,UAAU;gBAAE,GAAG,IAAI,OAAO,CAAC,KAAK,EAAY,CAAC;YAClE,KAAK,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;YAE7B,yDAAyD;YACzD,MAAM,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;YAClC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACjB,+EAA+E;gBAC/E,KAAK,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,gBAAgB,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,iBAAiB,CAAC;YAC7B,CAAC;YACD,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,IAAI,KAAK;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,GAAG;YACL,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,SAAS,CAAC,CAAC,2CAA2C;YACvF,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/game/core/fixedTimestep.d.ts

@@ -0,0 +1,38 @@
+export interface FixedTimestepOptions {
+    /** Update rate in Hz (e.g. 60 → a fixed 1/60 s simulation step). */
+    hz: number;
+    /**
+     * Called zero or more times per frame with the fixed timestep in **seconds**
+     * (e.g. `1/60 ≈ 0.0167`). Drive all simulation/physics from this `dt` so behaviour
+     * is frame-rate independent.
+     */
+    onUpdate: (dt: number) => void;
+    /**
+     * Called exactly once per frame with the interpolation factor `alpha` in `[0, 1)`
+     * — the fraction of a step the accumulator is into the next update. Render the
+     * visual state as `lerp(prev, current, alpha)` for smooth motion between updates.
+     */
+    onRender: (alpha: number) => void;
+    /**
+     * Maximum simulation steps per frame (default `5`). The "spiral of death" guard:
+     * without it, a tab backgrounded for 5 s would try to simulate hundreds of steps
+     * in one frame and lock the thread. When the cap is hit the leftover backlog is
+     * dropped (time is sacrificed to keep the frame responsive).
+     */
+    maxCatchup?: number;
+}
+export interface FixedTimestep {
+    /** Advance by the wall-clock delta since the previous frame, in **milliseconds**. */
+    step: (deltaMs: number) => void;
+    /** Clear the accumulator — call after a pause/resume so the gap isn't simulated. */
+    reset: () => void;
+}
+/**
+ * Creates a fixed-timestep accumulator: the canonical decoupling of a fixed-rate
+ * simulation from a variable-rate render. Call {@link FixedTimestep.step} once per
+ * animation frame with the wall-clock delta; it invokes `onUpdate(dt)` zero or more
+ * times with the fixed `dt`, then `onRender(alpha)` once with the interpolation
+ * factor. Replaces the verbatim copies the apps each carried per game.
+ */
+export declare function createFixedTimestep(opts: FixedTimestepOptions): FixedTimestep;
+//# sourceMappingURL=fixedTimestep.d.ts.map

package/dist/game/core/fixedTimestep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixedTimestep.d.ts","sourceRoot":"","sources":["../../../src/game/core/fixedTimestep.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,qFAAqF;IACrF,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,oFAAoF;IACpF,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CAwC7E"}

package/dist/game/core/fixedTimestep.js

@@ -0,0 +1,47 @@
+/**
+ * Creates a fixed-timestep accumulator: the canonical decoupling of a fixed-rate
+ * simulation from a variable-rate render. Call {@link FixedTimestep.step} once per
+ * animation frame with the wall-clock delta; it invokes `onUpdate(dt)` zero or more
+ * times with the fixed `dt`, then `onRender(alpha)` once with the interpolation
+ * factor. Replaces the verbatim copies the apps each carried per game.
+ */
+export function createFixedTimestep(opts) {
+    const { hz, onUpdate, onRender, maxCatchup = 5 } = opts;
+    if (!(hz > 0))
+        throw new Error(`createFixedTimestep: hz must be > 0 (got ${hz})`);
+    const stepMs = 1000 / hz;
+    const stepSeconds = stepMs / 1000;
+    // Repeated `accumulator -= stepMs` accrues float error, so an exact integer multiple
+    // (e.g. 100ms at 60hz = 6 steps) can fall a rounding-bit short of the final step.
+    // A tiny epsilon recovers the mathematically-correct count without ever firing a
+    // spurious step (a real sub-step delta is never within 1e-9 ms of the boundary).
+    const threshold = stepMs - 1e-9;
+    let accumulator = 0;
+    return {
+        step(deltaMs) {
+            // Guard against NaN, negatives, and the huge delta after a backgrounded tab.
+            if (!Number.isFinite(deltaMs) || deltaMs < 0)
+                deltaMs = 0;
+            accumulator += deltaMs;
+            let steps = 0;
+            while (accumulator >= threshold && steps < maxCatchup) {
+                onUpdate(stepSeconds);
+                accumulator -= stepMs;
+                steps++;
+            }
+            // Hit the catch-up cap with backlog remaining → drop it (spiral-of-death guard).
+            if (steps >= maxCatchup && accumulator >= threshold) {
+                accumulator = 0;
+            }
+            else if (accumulator < 0) {
+                // Epsilon stepping can leave a sub-femtosecond negative residue; floor it.
+                accumulator = 0;
+            }
+            onRender(accumulator / stepMs);
+        },
+        reset() {
+            accumulator = 0;
+        },
+    };
+}
+//# sourceMappingURL=fixedTimestep.js.map

package/dist/game/core/fixedTimestep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixedTimestep.js","sourceRoot":"","sources":["../../../src/game/core/fixedTimestep.ts"],"names":[],"mappings":"AA+BA;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA0B;IAC5D,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,4CAA4C,EAAE,GAAG,CAAC,CAAC;IAElF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,qFAAqF;IACrF,kFAAkF;IAClF,iFAAiF;IACjF,iFAAiF;IACjF,MAAM,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,OAAO;QACL,IAAI,CAAC,OAAe;YAClB,6EAA6E;YAC7E,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAC,CAAC;YAC1D,WAAW,IAAI,OAAO,CAAC;YAEvB,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,OAAO,WAAW,IAAI,SAAS,IAAI,KAAK,GAAG,UAAU,EAAE,CAAC;gBACtD,QAAQ,CAAC,WAAW,CAAC,CAAC;gBACtB,WAAW,IAAI,MAAM,CAAC;gBACtB,KAAK,EAAE,CAAC;YACV,CAAC;YAED,iFAAiF;YACjF,IAAI,KAAK,IAAI,UAAU,IAAI,WAAW,IAAI,SAAS,EAAE,CAAC;gBACpD,WAAW,GAAG,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;gBAC3B,2EAA2E;gBAC3E,WAAW,GAAG,CAAC,CAAC;YAClB,CAAC;YAED,QAAQ,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,KAAK;YACH,WAAW,GAAG,CAAC,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/game/core/index.d.ts

@@ -0,0 +1,9 @@
+export { DisposeRegistry } from './DisposeRegistry';
+export type { DrawBudget, DrawBudgetOptions } from './drawBudget';
+export { drawBudget } from './drawBudget';
+export type { FixedTimestep, FixedTimestepOptions } from './fixedTimestep';
+export { createFixedTimestep } from './fixedTimestep';
+export type { GamepadSnapshot, InputCollector, InputCollectorOptions, InputSnapshot, PointerSnapshot, } from './inputCollector';
+export { createInputCollector, deadzone } from './inputCollector';
+export { resizeCanvasToDisplaySize } from './resizeCanvas';
+//# sourceMappingURL=index.d.ts.map

package/dist/game/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/game/core/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EACV,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/game/core/index.js

@@ -0,0 +1,8 @@
+// cursedbelt/game core — engine-agnostic, zero React, browser-safe to import from a
+// Bun server test. The React host hook lives in `cursedbelt/game/react`.
+export { DisposeRegistry } from './DisposeRegistry';
+export { drawBudget } from './drawBudget';
+export { createFixedTimestep } from './fixedTimestep';
+export { createInputCollector, deadzone } from './inputCollector';
+export { resizeCanvasToDisplaySize } from './resizeCanvas';
+//# sourceMappingURL=index.js.map

package/dist/game/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/game/core/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,yEAAyE;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAQtD,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/game/core/inputCollector.d.ts

@@ -0,0 +1,82 @@
+import type { DisposeRegistry } from './DisposeRegistry';
+export interface PointerSnapshot {
+    /** Canvas-relative X in CSS pixels. */
+    x: number;
+    /** Canvas-relative Y in CSS pixels. */
+    y: number;
+    /** Bitmask of currently-pressed buttons (`PointerEvent.buttons`). */
+    buttons: number;
+    /** The originating `PointerEvent.pointerId`. */
+    id: number;
+    /** `'mouse' | 'pen' | 'touch'`. */
+    type: string;
+}
+export interface GamepadSnapshot {
+    index: number;
+    /** Axes with the deadzone already applied. Even indices = X, odd = Y, by convention. */
+    axes: number[];
+    /** Per-button analogue value in `[0, 1]`. */
+    buttons: number[];
+    /** Per-button pressed flag. */
+    pressed: boolean[];
+}
+export interface InputSnapshot {
+    /** The primary (most-recently-active) pointer. */
+    pointer: {
+        x: number;
+        y: number;
+        buttons: number;
+    };
+    /** `KeyboardEvent.code` → held. Cleared on window blur to avoid stuck keys. */
+    keys: Record<string, boolean>;
+    /** One entry per active touch contact, canvas-relative. */
+    touch: {
+        x: number;
+        y: number;
+    }[];
+    /** The first connected gamepad with deadzone-corrected axes, or `null`. */
+    gamepad: GamepadSnapshot | null;
+}
+export interface InputCollectorOptions {
+    /**
+     * Where keyboard listeners attach. Defaults to `window` so the game receives keys
+     * without the canvas needing focus. Pass the canvas to scope keys to focus instead.
+     */
+    keyboardTarget?: Window | HTMLElement;
+    /** Gamepad axis deadzone (default `0.15`). */
+    gamepadDeadzone?: number;
+    /**
+     * Set `canvas.style.touchAction = 'none'` so dragging on a touch device doesn't
+     * scroll/zoom the page (default `true`). Restored on dispose.
+     */
+    preventTouchScroll?: boolean;
+}
+export interface InputCollector {
+    /** A point-in-time copy of all input state — call once per frame. */
+    snapshot: () => InputSnapshot;
+    /** Subscribe to pointer-down events (mouse/pen/touch unified). */
+    onPointerDown: (fn: (e: PointerSnapshot) => void) => void;
+    /** Subscribe to pointer-up events. */
+    onPointerUp: (fn: (e: PointerSnapshot) => void) => void;
+    /** Subscribe to a specific `KeyboardEvent.code`; `down` is `true` on press, `false` on release. */
+    onKey: (code: string, fn: (down: boolean) => void) => void;
+}
+/**
+ * Applies a radial deadzone to a normalized axis value in `[-1, 1]` and rescales the
+ * remainder so output still spans the full range past the threshold (no sudden jump
+ * at the deadzone edge). Use for gamepad sticks / analogue inputs.
+ */
+export declare function deadzone(value: number, threshold?: number): number;
+/**
+ * Collects raw input state from pointer, keyboard, touch, and gamepad into a single
+ * snapshot-able object. Pointer events unify mouse/pen/touch; touch contacts are also
+ * surfaced individually in `snapshot().touch`. All listeners attach via the supplied
+ * {@link DisposeRegistry}, so they're torn down automatically on engine dispose.
+ *
+ * Per-game `computeIntent(snapshot)` (mapping raw input → a game-specific action enum)
+ * stays in the game — this layer only handles the common collection + deadzone.
+ *
+ * Browser-only: reads `document`/`window`/`navigator`. Never call from a server file.
+ */
+export declare function createInputCollector(canvas: HTMLCanvasElement, registry: DisposeRegistry, opts?: InputCollectorOptions): InputCollector;
+//# sourceMappingURL=inputCollector.d.ts.map

package/dist/game/core/inputCollector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputCollector.d.ts","sourceRoot":"","sources":["../../../src/game/core/inputCollector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,uCAAuC;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,wFAAwF;IACxF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,6CAA6C;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+BAA+B;IAC/B,OAAO,EAAE,OAAO,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,OAAO,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,2DAA2D;IAC3D,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClC,2EAA2E;IAC3E,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACtC,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,QAAQ,EAAE,MAAM,aAAa,CAAC;IAC9B,kEAAkE;IAClE,aAAa,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,IAAI,KAAK,IAAI,CAAC;IAC1D,sCAAsC;IACtC,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,IAAI,KAAK,IAAI,CAAC;IACxD,mGAAmG;IACnG,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,KAAK,IAAI,CAAC;CAC5D;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,SAAO,GAAG,MAAM,CAKhE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,eAAe,EACzB,IAAI,GAAE,qBAA0B,GAC/B,cAAc,CA2JhB"}

package/dist/game/core/inputCollector.js

@@ -0,0 +1,176 @@
+/**
+ * Applies a radial deadzone to a normalized axis value in `[-1, 1]` and rescales the
+ * remainder so output still spans the full range past the threshold (no sudden jump
+ * at the deadzone edge). Use for gamepad sticks / analogue inputs.
+ */
+export function deadzone(value, threshold = 0.15) {
+    const magnitude = Math.abs(value);
+    if (magnitude <= threshold)
+        return 0;
+    const sign = value < 0 ? -1 : 1;
+    return sign * ((magnitude - threshold) / (1 - threshold));
+}
+/**
+ * Collects raw input state from pointer, keyboard, touch, and gamepad into a single
+ * snapshot-able object. Pointer events unify mouse/pen/touch; touch contacts are also
+ * surfaced individually in `snapshot().touch`. All listeners attach via the supplied
+ * {@link DisposeRegistry}, so they're torn down automatically on engine dispose.
+ *
+ * Per-game `computeIntent(snapshot)` (mapping raw input → a game-specific action enum)
+ * stays in the game — this layer only handles the common collection + deadzone.
+ *
+ * Browser-only: reads `document`/`window`/`navigator`. Never call from a server file.
+ */
+export function createInputCollector(canvas, registry, opts = {}) {
+    const { keyboardTarget = typeof window !== 'undefined' ? window : canvas, gamepadDeadzone = 0.15, preventTouchScroll = true, } = opts;
+    const keys = {};
+    const activePointers = new Map();
+    let primary = { x: 0, y: 0, buttons: 0, id: -1, type: 'mouse' };
+    let gamepadIndex = null;
+    const pointerDownHandlers = [];
+    const pointerUpHandlers = [];
+    const keyHandlers = new Map();
+    function toLocal(e) {
+        const rect = canvas.getBoundingClientRect();
+        return {
+            x: e.clientX - rect.left,
+            y: e.clientY - rect.top,
+            buttons: e.buttons,
+            id: e.pointerId,
+            type: e.pointerType,
+        };
+    }
+    // --- Pointer (unifies mouse, pen, touch) ---
+    const onPointerMove = (e) => {
+        const p = toLocal(e);
+        if (activePointers.has(p.id) || p.type !== 'touch')
+            primary = p;
+        if (activePointers.has(p.id))
+            activePointers.set(p.id, p);
+    };
+    const onPointerDown = (e) => {
+        const p = toLocal(e);
+        activePointers.set(p.id, p);
+        primary = p;
+        for (const fn of pointerDownHandlers)
+            fn(p);
+    };
+    const onPointerUp = (e) => {
+        const p = toLocal(e);
+        activePointers.delete(p.id);
+        primary = { ...p, buttons: 0 };
+        for (const fn of pointerUpHandlers)
+            fn(p);
+    };
+    const onPointerCancel = (e) => {
+        activePointers.delete(e.pointerId);
+    };
+    addCanvasListener('pointermove', onPointerMove);
+    addCanvasListener('pointerdown', onPointerDown);
+    addCanvasListener('pointerup', onPointerUp);
+    addCanvasListener('pointercancel', onPointerCancel);
+    if (preventTouchScroll) {
+        const prev = canvas.style.touchAction;
+        canvas.style.touchAction = 'none';
+        registry.add(() => {
+            canvas.style.touchAction = prev;
+        });
+    }
+    // --- Keyboard (window by default; cleared on blur) ---
+    const onKeyDown = (e) => {
+        if (keys[e.code])
+            return; // ignore auto-repeat
+        keys[e.code] = true;
+        const handlers = keyHandlers.get(e.code);
+        if (handlers)
+            for (const fn of handlers)
+                fn(true);
+    };
+    const onKeyUp = (e) => {
+        if (!keys[e.code])
+            return;
+        keys[e.code] = false;
+        const handlers = keyHandlers.get(e.code);
+        if (handlers)
+            for (const fn of handlers)
+                fn(false);
+    };
+    const onBlur = () => {
+        for (const code of Object.keys(keys)) {
+            if (keys[code]) {
+                keys[code] = false;
+                const handlers = keyHandlers.get(code);
+                if (handlers)
+                    for (const fn of handlers)
+                        fn(false);
+            }
+        }
+    };
+    addTargetListener(keyboardTarget, 'keydown', onKeyDown);
+    addTargetListener(keyboardTarget, 'keyup', onKeyUp);
+    if (typeof window !== 'undefined')
+        addTargetListener(window, 'blur', onBlur);
+    // --- Gamepad (connection is evented; state is polled in snapshot) ---
+    if (typeof window !== 'undefined') {
+        const onConnect = (e) => {
+            gamepadIndex = e.gamepad.index;
+        };
+        const onDisconnect = (e) => {
+            if (e.gamepad.index === gamepadIndex)
+                gamepadIndex = null;
+        };
+        addTargetListener(window, 'gamepadconnected', onConnect);
+        addTargetListener(window, 'gamepaddisconnected', onDisconnect);
+    }
+    function readGamepad() {
+        if (typeof navigator === 'undefined' || !navigator.getGamepads)
+            return null;
+        const pads = navigator.getGamepads();
+        const pad = gamepadIndex !== null ? pads[gamepadIndex] : pads.find((p) => p != null);
+        if (!pad)
+            return null;
+        return {
+            index: pad.index,
+            axes: pad.axes.map((a) => deadzone(a, gamepadDeadzone)),
+            buttons: pad.buttons.map((b) => b.value),
+            pressed: pad.buttons.map((b) => b.pressed),
+        };
+    }
+    return {
+        snapshot() {
+            const touch = [];
+            for (const p of activePointers.values()) {
+                if (p.type === 'touch')
+                    touch.push({ x: p.x, y: p.y });
+            }
+            return {
+                pointer: { x: primary.x, y: primary.y, buttons: primary.buttons },
+                keys: { ...keys },
+                touch,
+                gamepad: readGamepad(),
+            };
+        },
+        onPointerDown(fn) {
+            pointerDownHandlers.push(fn);
+        },
+        onPointerUp(fn) {
+            pointerUpHandlers.push(fn);
+        },
+        onKey(code, fn) {
+            const handlers = keyHandlers.get(code);
+            if (handlers)
+                handlers.push(fn);
+            else
+                keyHandlers.set(code, [fn]);
+        },
+    };
+    function addCanvasListener(type, handler) {
+        canvas.addEventListener(type, handler);
+        registry.add(() => canvas.removeEventListener(type, handler));
+    }
+    function addTargetListener(target, type, handler) {
+        target.addEventListener(type, handler);
+        registry.add(() => target.removeEventListener(type, handler));
+    }
+}
+//# sourceMappingURL=inputCollector.js.map

package/dist/game/core/inputCollector.js.map

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

package/dist/game/core/resizeCanvas.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resize a canvas's backing-store resolution to match its CSS display size times the
+ * device pixel ratio, so rendering is crisp on HiDPI screens without stretching.
+ *
+ * Call this at the top of the render loop. It only writes `canvas.width/height` when
+ * they actually changed (writing them is destructive — it clears the canvas and resets
+ * the 2D context state), and returns whether a resize happened so the game can update
+ * its viewport/projection only when needed.
+ *
+ * This is deliberately NOT inside `useGameEngine`: backing-store sizing is game-specific
+ * (a WebGL game also calls `gl.viewport`, a 2D game may re-scale the context), so the
+ * hook stays renderer-agnostic and the game owns its resize policy.
+ *
+ * @param canvas - The target canvas.
+ * @param dpr - Device pixel ratio (defaults to `window.devicePixelRatio`, min 1).
+ * @returns `true` if the backing store was resized this call.
+ */
+export declare function resizeCanvasToDisplaySize(canvas: HTMLCanvasElement, dpr?: number): boolean;
+//# sourceMappingURL=resizeCanvas.d.ts.map

package/dist/game/core/resizeCanvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resizeCanvas.d.ts","sourceRoot":"","sources":["../../../src/game/core/resizeCanvas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,iBAAiB,EACzB,GAAG,GAAE,MAAyE,GAC7E,OAAO,CAUT"}

package/dist/game/core/resizeCanvas.js

@@ -0,0 +1,29 @@
+/**
+ * Resize a canvas's backing-store resolution to match its CSS display size times the
+ * device pixel ratio, so rendering is crisp on HiDPI screens without stretching.
+ *
+ * Call this at the top of the render loop. It only writes `canvas.width/height` when
+ * they actually changed (writing them is destructive — it clears the canvas and resets
+ * the 2D context state), and returns whether a resize happened so the game can update
+ * its viewport/projection only when needed.
+ *
+ * This is deliberately NOT inside `useGameEngine`: backing-store sizing is game-specific
+ * (a WebGL game also calls `gl.viewport`, a 2D game may re-scale the context), so the
+ * hook stays renderer-agnostic and the game owns its resize policy.
+ *
+ * @param canvas - The target canvas.
+ * @param dpr - Device pixel ratio (defaults to `window.devicePixelRatio`, min 1).
+ * @returns `true` if the backing store was resized this call.
+ */
+export function resizeCanvasToDisplaySize(canvas, dpr = typeof window !== 'undefined' ? window.devicePixelRatio || 1 : 1) {
+    const ratio = dpr > 0 ? dpr : 1;
+    const width = Math.max(1, Math.round(canvas.clientWidth * ratio));
+    const height = Math.max(1, Math.round(canvas.clientHeight * ratio));
+    if (canvas.width !== width || canvas.height !== height) {
+        canvas.width = width;
+        canvas.height = height;
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=resizeCanvas.js.map

package/dist/game/core/resizeCanvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resizeCanvas.js","sourceRoot":"","sources":["../../../src/game/core/resizeCanvas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAyB,EACzB,MAAc,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9E,MAAM,KAAK,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACvD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/game/react/index.d.ts

@@ -0,0 +1,3 @@
+export type { GameFactory, GameHandle, UseGameEngineResult, } from './useGameEngine';
+export { useGameEngine } from './useGameEngine';
+//# sourceMappingURL=index.d.ts.map

package/dist/game/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/game/react/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,WAAW,EACX,UAAU,EACV,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/game/react/index.js

@@ -0,0 +1,5 @@
+// cursedbelt/game/react — the browser-only React host hook. Reads `document`/`window`;
+// never import this subpath from a Bun server file. The engine-agnostic core (no React,
+// Bun-safe) lives in `cursedbelt/game`.
+export { useGameEngine } from './useGameEngine';
+//# sourceMappingURL=index.js.map

package/dist/game/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/game/react/index.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,wFAAwF;AACxF,wCAAwC;AAOxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/game/react/useGameEngine.d.ts

@@ -0,0 +1,64 @@
+import { type DependencyList, type RefObject } from 'react';
+import { DisposeRegistry } from '../core/DisposeRegistry';
+/**
+ * The handle a {@link GameFactory} returns. The host hook owns its lifecycle:
+ * `dispose` runs on true unmount; `pause`/`resume` run on tab hide/show.
+ */
+export interface GameHandle {
+    /** Tear down the engine. Called exactly once, on true unmount. */
+    dispose(): void;
+    /** Optional: called when the tab is hidden (Page Visibility). Cancel your rAF here. */
+    pause?(): void;
+    /** Optional: called when the tab becomes visible again. Restart your rAF here. */
+    resume?(): void;
+}
+/**
+ * Creates the engine for a freshly-mounted canvas. Receives a {@link DisposeRegistry}
+ * for RAII cleanup — register every listener / rAF id / resource you allocate.
+ *
+ * MUST be referentially stable: define it at module level or wrap it in `useCallback`.
+ * (It's read through a ref, so an unstable identity won't restart the engine — but a
+ * stale closure could capture old props. Prefer reading live values through refs.)
+ *
+ * @returns the handle, or a promise of it (async setup — e.g. loading WASM — is fine).
+ */
+export type GameFactory<THandle extends GameHandle> = (canvas: HTMLCanvasElement, registry: DisposeRegistry) => THandle | Promise<THandle>;
+export interface UseGameEngineResult<THandle extends GameHandle> {
+    /** Attach to your `<canvas ref={canvasRef} />`. */
+    canvasRef: RefObject<HTMLCanvasElement | null>;
+    /**
+     * The live handle, available after mount (`null` during SSR/init). This is a ref
+     * value, NOT reactive — gate UI that needs it on {@link UseGameEngineResult.isReady}.
+     */
+    handle: THandle | null;
+    /** `true` once the factory has resolved and the engine is running. */
+    isReady: boolean;
+}
+/**
+ * Stable game-engine host hook — the architectural fix for the "game froze, can't
+ * click out" bug.
+ *
+ * The bug: a game's lifecycle `useEffect` listed a context-derived value (typically
+ * `authRequest` / `saveNow` from `AuthContext`) in its dep array. When that value's
+ * identity churned on an unrelated re-render, React tore down and re-ran the effect —
+ * disposing the *live* engine mid-session. A guarded setup (`if (engine) return`) then
+ * refused to recreate it, leaving a dead canvas with no way out.
+ *
+ * The fix, by construction: the `factory` is held in a ref and is **never** an effect
+ * dependency. The engine starts once on mount and is disposed once on true unmount.
+ * AuthContext can re-render as much as it likes — the engine lifecycle is fully
+ * decoupled from React's render cycle. Only the explicit `deps` (true restart triggers
+ * like a room id or game mode) re-create the engine.
+ *
+ * Notes:
+ * - **Canvas sizing / DPR is game-specific** and intentionally NOT handled here. Call
+ *   `resizeCanvasToDisplaySize(canvas)` (from `cursedbelt/game`) in your render loop.
+ * - **Page Visibility**: the hook calls `handle.pause?()` on hide and `handle.resume?()`
+ *   on show. Cancel your rAF in `pause` and restart it in `resume`; pair with
+ *   `createFixedTimestep`'s `maxCatchup` guard so the post-resume delta can't spiral.
+ *
+ * @param factory Stable engine constructor (module-level or `useCallback`).
+ * @param deps    True restart triggers (keep small + stable). Default `[]` = mount-once.
+ */
+export declare function useGameEngine<THandle extends GameHandle>(factory: GameFactory<THandle>, deps?: DependencyList): UseGameEngineResult<THandle>;
+//# sourceMappingURL=useGameEngine.d.ts.map

package/dist/game/react/useGameEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGameEngine.d.ts","sourceRoot":"","sources":["../../../src/game/react/useGameEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,OAAO,IAAI,IAAI,CAAC;IAChB,uFAAuF;IACvF,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,kFAAkF;IAClF,MAAM,CAAC,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,UAAU,IAAI,CACpD,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,eAAe,KACtB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhC,MAAM,WAAW,mBAAmB,CAAC,OAAO,SAAS,UAAU;IAC7D,mDAAmD;IACnD,SAAS,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC/C;;;OAGG;IACH,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,sEAAsE;IACtE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,OAAO,SAAS,UAAU,EACtD,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,EAC7B,IAAI,GAAE,cAAmB,GACxB,mBAAmB,CAAC,OAAO,CAAC,CAmD9B"}