cursedbelt 1.0.0 → 2.3.0

package/dist/game/core/inputCollector.js

@@ -1,176 +0,0 @@
-/**
- * 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 / analog 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

@@ -1 +0,0 @@
-{"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

@@ -1,19 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,29 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1 +0,0 @@
-{"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

@@ -1,5 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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

@@ -1,64 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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,CAoD9B"}

package/dist/game/react/useGameEngine.js

@@ -1,78 +0,0 @@
-import { useEffect, useRef, useState } from 'react';
-import { DisposeRegistry } from '../core/DisposeRegistry';
-/**
- * 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 function useGameEngine(factory, deps = []) {
-    const canvasRef = useRef(null);
-    const factoryRef = useRef(factory); // ← intentionally never an effect dependency
-    const handleRef = useRef(null);
-    const [isReady, setIsReady] = useState(false);
-    // Keep the factory ref fresh on every render WITHOUT re-running the engine effect.
-    // (Same pattern as a `useEvent` / event-handler ref.)
-    useEffect(() => {
-        factoryRef.current = factory;
-    });
-    // NOTE (the freeze fix): `factory` is intentionally NOT a dependency of this effect —
-    // it is read through the stable `factoryRef`, so AuthContext churn (or any re-render)
-    // can never tear down and restart the live engine. Only `deps` (true restart triggers
-    // like a room id) re-create it. The exhaustive-deps lint has nothing to flag precisely
-    // because `factory` is never referenced directly here.
-    useEffect(() => {
-        const canvas = canvasRef.current;
-        if (!canvas)
-            return;
-        const registry = new DisposeRegistry();
-        let active = true;
-        Promise.resolve(factoryRef.current(canvas, registry)).then((handle) => {
-            if (!active) {
-                // Unmounted before the (possibly async) factory resolved — dispose immediately.
-                handle.dispose();
-                return;
-            }
-            handleRef.current = handle;
-            setIsReady(true);
-            const onVisibility = () => {
-                if (document.hidden)
-                    handle.pause?.();
-                else
-                    handle.resume?.();
-            };
-            document.addEventListener('visibilitychange', onVisibility);
-            registry.add(() => document.removeEventListener('visibilitychange', onVisibility));
-        });
-        return () => {
-            active = false;
-            registry.disposeAll();
-            handleRef.current?.dispose();
-            handleRef.current = null;
-            setIsReady(false);
-        };
-        // biome-ignore lint/correctness/useExhaustiveDependencies: `deps` is this hook's own pass-through dependency-list parameter (same shape as useEffect's own deps arg), inherently caller-supplied rather than an inline literal; `factory` is intentionally excluded per the freeze-fix note above.
-    }, deps);
-    return { canvasRef, handle: handleRef.current, isReady };
-}
-//# sourceMappingURL=useGameEngine.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"useGameEngine.js","sourceRoot":"","sources":["../../../src/game/react/useGameEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AA0C1D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,aAAa,CAC3B,OAA6B,EAC7B,OAAuB,EAAE;IAEzB,MAAM,SAAS,GAAG,MAAM,CAA2B,IAAI,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,6CAA6C;IACjF,MAAM,SAAS,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAE9C,mFAAmF;IACnF,sDAAsD;IACtD,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,sFAAsF;IACtF,sFAAsF;IACtF,sFAAsF;IACtF,uFAAuF;IACvF,uDAAuD;IACvD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACvC,IAAI,MAAM,GAAG,IAAI,CAAC;QAElB,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACpE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,gFAAgF;gBAChF,MAAM,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO;YACT,CAAC;YACD,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;YAC3B,UAAU,CAAC,IAAI,CAAC,CAAC;YAEjB,MAAM,YAAY,GAAG,GAAG,EAAE;gBACxB,IAAI,QAAQ,CAAC,MAAM;oBAAE,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;;oBACjC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACzB,CAAC,CAAC;YACF,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;YAC5D,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC,CAAC;QACrF,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,KAAK,CAAC;YACf,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;YAC7B,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YACzB,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC;QACF,mSAAmS;IACrS,CAAC,EAAE,IAAI,CAAC,CAAC;IAET,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;AAC3D,CAAC"}

package/dist/react/canvas/CanvasNavHUD.d.ts

@@ -1,64 +0,0 @@
-export interface CanvasRect {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-}
-export interface CanvasMinimapPoint {
-    x: number;
-    y: number;
-    /** A `--tone-*`/`--chart-*` CSS value. Defaults to the muted foreground. */
-    color?: string;
-    /** The focus node is drawn larger and on top. */
-    focus?: boolean;
-}
-export interface CanvasNavHUDProps {
-    /** "Fit to canvas size" — frame the whole graph. Required: it is the escape
-     *  hatch from being lost, and a canvas without one is the reported defect. */
-    onFit: () => void;
-    /** "Centre on the active focus node". Omit only if the canvas has no focus. */
-    onCenterFocus?: () => void;
-    /** Named in the centre control's hint, so it says WHAT it will centre on. */
-    focusLabel?: string;
-    /** Current zoom (1 = 100%). Renders the zoom cluster when `onZoomChange` is set. */
-    zoom?: number;
-    onZoomChange?: (zoom: number) => void;
-    /** Zoom bounds for the +/- controls. Default 0.1 – 4. */
-    zoomRange?: [number, number];
-    /** The whole graph's bounds, in world units. */
-    world?: CanvasRect;
-    /** What the user can currently see, in the same units. */
-    viewport?: CanvasRect;
-    /** Optional node dots for the radar. Keep it cheap — sample, don't map 10k nodes. */
-    points?: CanvasMinimapPoint[];
-    /** Click/drag the radar to jump. Receives world coordinates. */
-    onMinimapJump?: (point: {
-        x: number;
-        y: number;
-    }) => void;
-    /** Which corner the HUD floats in. Default `bottom-right`. */
-    corner?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
-    className?: string;
-}
-/**
- * The floating navigation HUD every infinite canvas must have.
- *
- * `DESIGN.md` §7: *"Every infinite panning or zooming canvas must include an
- * explicit floating Navigation HUD. The HUD must pack three essential controls: a
- * 'Fit to Canvas Size' trigger, a 'Center Canvas on Active Focus Node' tracking
- * action, and a low-opacity Radar Mini-Map positioned in a viewport corner
- * indicating active coordinate bounds."*
- *
- * Nothing shared implemented any of the three — `HudPill` is a pill, not a HUD —
- * so the family tree, the atlas, the orch lanes and fractals each had a different
- * partial answer or none. This is the one implementation.
- *
- * It is deliberately presentational: it owns no camera. The canvas keeps its own
- * transform and passes `world`/`viewport` in the SAME units, which is the only
- * contract the radar needs and the reason this works for an SVG tree and a WebGL
- * field alike. The controls sit in a `Surface` at `--z-sticky`, above the canvas
- * and below every overlay (`DESIGN.md` §5's containment rule), and every one of
- * them is a real 44×44 target on a coarse pointer via `IconButton`.
- */
-export declare function CanvasNavHUD({ onFit, onCenterFocus, focusLabel, zoom, onZoomChange, zoomRange, world, viewport, points, onMinimapJump, corner, className, }: CanvasNavHUDProps): import("react").JSX.Element;
-//# sourceMappingURL=CanvasNavHUD.d.ts.map

package/dist/react/canvas/CanvasNavHUD.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"CanvasNavHUD.d.ts","sourceRoot":"","sources":["../../../src/react/canvas/CanvasNavHUD.tsx"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC;kFAC8E;IAC9E,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,yDAAyD;IACzD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,gDAAgD;IAChD,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,qFAAqF;IACrF,MAAM,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC9B,gEAAgE;IAChE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1D,8DAA8D;IAC9D,MAAM,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,cAAc,CAAC;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAYD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,aAAa,EACb,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,SAAoB,EACpB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,aAAa,EACb,MAAuB,EACvB,SAAS,GACV,EAAE,iBAAiB,+BAsHnB"}

package/dist/react/canvas/CanvasNavHUD.js

@@ -1,58 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Crosshair, Maximize2, Minus, Plus } from 'lucide-react';
-import { useCallback, useRef } from 'react';
-import { IconButton } from '../components/IconButton';
-import { Surface } from '../components/Surface';
-import { cn } from '../lib/cn';
-const CORNER_CLASS = {
-    'top-left': 'top-3 left-3',
-    'top-right': 'top-3 right-3',
-    'bottom-left': 'bottom-3 left-3',
-    'bottom-right': 'bottom-3 right-3',
-};
-const MINIMAP_W = 132;
-const MINIMAP_H = 88;
-/**
- * The floating navigation HUD every infinite canvas must have.
- *
- * `DESIGN.md` §7: *"Every infinite panning or zooming canvas must include an
- * explicit floating Navigation HUD. The HUD must pack three essential controls: a
- * 'Fit to Canvas Size' trigger, a 'Center Canvas on Active Focus Node' tracking
- * action, and a low-opacity Radar Mini-Map positioned in a viewport corner
- * indicating active coordinate bounds."*
- *
- * Nothing shared implemented any of the three — `HudPill` is a pill, not a HUD —
- * so the family tree, the atlas, the orch lanes and fractals each had a different
- * partial answer or none. This is the one implementation.
- *
- * It is deliberately presentational: it owns no camera. The canvas keeps its own
- * transform and passes `world`/`viewport` in the SAME units, which is the only
- * contract the radar needs and the reason this works for an SVG tree and a WebGL
- * field alike. The controls sit in a `Surface` at `--z-sticky`, above the canvas
- * and below every overlay (`DESIGN.md` §5's containment rule), and every one of
- * them is a real 44×44 target on a coarse pointer via `IconButton`.
- */
-export function CanvasNavHUD({ onFit, onCenterFocus, focusLabel, zoom, onZoomChange, zoomRange = [0.1, 4], world, viewport, points, onMinimapJump, corner = 'bottom-right', className, }) {
-    const svgRef = useRef(null);
-    const [minZoom, maxZoom] = zoomRange;
-    const jump = useCallback((e) => {
-        if (!onMinimapJump || !world)
-            return;
-        const box = svgRef.current?.getBoundingClientRect();
-        if (!box || box.width === 0 || box.height === 0)
-            return;
-        const fx = (e.clientX - box.left) / box.width;
-        const fy = (e.clientY - box.top) / box.height;
-        onMinimapJump({ x: world.x + fx * world.width, y: world.y + fy * world.height });
-    }, [onMinimapJump, world]);
-    const showRadar = Boolean(world && world.width > 0 && world.height > 0);
-    const scaleX = showRadar ? MINIMAP_W / world.width : 0;
-    const scaleY = showRadar ? MINIMAP_H / world.height : 0;
-    const toX = (x) => (x - world.x) * scaleX;
-    const toY = (y) => (y - world.y) * scaleY;
-    return (_jsxs(Surface, { level: 'overlay', pad: 'none', className: cn('pointer-events-auto absolute z-[var(--z-sticky)] flex flex-col gap-2 rounded-lg p-2', 
-        // Low-opacity by default so it never competes with the graph, full presence
-        // the moment the pointer or the keyboard is anywhere near it.
-        'opacity-70 transition-opacity duration-[var(--duration-fast)] hover:opacity-100 focus-within:opacity-100', CORNER_CLASS[corner], className), "data-cb-canvas-hud": '', children: [_jsxs("div", { className: 'flex items-center gap-1', children: [_jsx(IconButton, { size: 'sm', label: 'Fit to canvas', onClick: onFit, children: _jsx(Maximize2, {}) }), onCenterFocus ? (_jsx(IconButton, { size: 'sm', label: focusLabel ? `Centre on ${focusLabel}` : 'Centre on the focused item', onClick: onCenterFocus, children: _jsx(Crosshair, {}) })) : null, onZoomChange ? (_jsxs(_Fragment, { children: [_jsx(IconButton, { size: 'sm', label: 'Zoom out', disabled: zoom !== undefined && zoom <= minZoom, onClick: () => onZoomChange(Math.max(minZoom, (zoom ?? 1) / 1.25)), children: _jsx(Minus, {}) }), _jsxs("span", { className: 'min-w-10 text-center text-caption tabular-nums text-muted-foreground', children: [Math.round((zoom ?? 1) * 100), "%"] }), _jsx(IconButton, { size: 'sm', label: 'Zoom in', disabled: zoom !== undefined && zoom >= maxZoom, onClick: () => onZoomChange(Math.min(maxZoom, (zoom ?? 1) * 1.25)), children: _jsx(Plus, {}) })] })) : null] }), showRadar ? (_jsxs("svg", { ref: svgRef, role: onMinimapJump ? 'button' : 'img', "aria-label": onMinimapJump ? 'Radar — click to jump' : 'Radar', tabIndex: onMinimapJump ? 0 : undefined, width: MINIMAP_W, height: MINIMAP_H, viewBox: `0 0 ${MINIMAP_W} ${MINIMAP_H}`, onPointerDown: jump, className: cn('rounded border border-border bg-surface-sunken', onMinimapJump && 'cursor-pointer'), children: [_jsx("title", { children: "Radar" }), (points ?? []).map((p, i) => (_jsx("circle", { cx: toX(p.x), cy: toY(p.y), r: p.focus ? 2.5 : 1.4, fill: p.color ?? 'var(--muted-foreground)', opacity: p.focus ? 1 : 0.55 }, i))), viewport ? (_jsx("rect", { x: toX(viewport.x), y: toY(viewport.y), width: Math.max(2, viewport.width * scaleX), height: Math.max(2, viewport.height * scaleY), fill: 'var(--accent)', fillOpacity: 0.12, stroke: 'var(--accent)', strokeWidth: 1, "data-cb-hud-viewport": '' })) : null] })) : null] }));
-}
-//# sourceMappingURL=CanvasNavHUD.js.map

package/dist/react/canvas/CanvasNavHUD.js.map

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

package/dist/react/canvas/fitLabel.d.ts

@@ -1,53 +0,0 @@
-/**
- * Fitting a human name into a node box without a harsh cut.
- *
- * `DESIGN.md` §5: *"Node diagrams, map elements, or tree visualizations displaying
- * user identities must never truncate names with harsh, broken text string cuts.
- * Use responsive font scaling, wrap long strings onto a clean second line, or
- * optimize middle-initial stripping to keep names human-readable."*
- *
- * That is three strategies in a stated order, and every canvas in the fleet was
- * improvising one of them (family's `TreeCanvas` does its own; the atlas does
- * none). This is the shared ladder, as a pure function with no DOM, so a `<text>`
- * in SVG, a 2D canvas and an absolutely-positioned `<div>` all fit labels the same
- * way and it can be tested without a browser.
- *
- * @see lodForZoom — below ~50% zoom the answer is not a smaller label, it is a glyph.
- */
-export type FitStrategy = 'as-is' | 'stripped' | 'wrapped' | 'scaled' | 'initials' | 'overflow';
-export interface FitLabelOptions {
-    /** Usable width of the node box, in px. */
-    width: number;
-    /** The size the label would like to be, in px. */
-    fontSize: number;
-    /** How many lines the box can hold. Default 2 — the "clean second line". */
-    maxLines?: number;
-    /** Never scale below this. Default 10px, which is `DESIGN.md` §4's floor minus
-     *  the two px a canvas label is allowed as a non-body-text glyph label. */
-    minFontSize?: number;
-    /**
-     * Width of `text` at `fontSize`. The default is a linear approximation
-     * (0.52em average advance, which is close for a UI sans at these sizes); a
-     * caller holding a real `CanvasRenderingContext2D` should pass `measureText`
-     * so the fit is exact.
-     */
-    measure?: (text: string, fontSize: number) => number;
-}
-export interface FittedLabel {
-    /** One entry per rendered line. Never empty. */
-    lines: string[];
-    /** The size to actually draw at. */
-    fontSize: number;
-    /** What the ladder had to do — surfaced so a caller can offer the full name in a
-     *  hint exactly when something was dropped, rather than always or never. */
-    strategy: FitStrategy;
-    /** True when even the last rung does not fit. Draw a glyph, not an ellipsis. */
-    overflow: boolean;
-}
-/**
- * Fit `text` into `width`, in `DESIGN.md` §5's stated order: as-is → drop middle
- * names → wrap onto a second line → scale the type down → first name + last
- * initial → give up and tell the caller to draw a glyph.
- */
-export declare function fitLabel(text: string, options: FitLabelOptions): FittedLabel;
-//# sourceMappingURL=fitLabel.d.ts.map

package/dist/react/canvas/fitLabel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fitLabel.d.ts","sourceRoot":"","sources":["../../../src/react/canvas/fitLabel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAEhG,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;+EAC2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACtD;AAED,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB;gFAC4E;IAC5E,QAAQ,EAAE,WAAW,CAAC;IACtB,gFAAgF;IAChF,QAAQ,EAAE,OAAO,CAAC;CACnB;AA4CD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,WAAW,CAoD5E"}