@nodetool-ai/game-renderer 0.8.1 → 0.8.3

package/dist/standalone-player3d.js

@@ -0,0 +1,255 @@
+import { createGameSession3D, decodePreparedGameCollider3D } from "@nodetool-ai/game-runtime";
+import { z } from "zod";
+import { gameDocument3D, resolveGameInputBindings } from "@nodetool-ai/protocol";
+import { createGameRenderer3D } from "./browser3d.js";
+import { GameInput3D } from "./input3d.js";
+import { browserGamepads } from "./input-bindings.js";
+import { mountTouchControls, touchLayout } from "./touch-controls.js";
+import { GameAudioPlayer, gameAudioSpatialView3D } from "./audio.js";
+import { FixedTickClock } from "./fixed-tick-host.js";
+import { GameFrameBudgetMonitor, gameAudioVoiceCount } from "./frame-budget.js";
+function status(message) {
+    const element = document.getElementById("status");
+    if (element) {
+        element.textContent = message;
+    }
+}
+async function start() {
+    const controller = new AbortController();
+    const response = await fetch("./game.json", { signal: controller.signal });
+    if (!response.ok) {
+        throw new Error("Game document could not load");
+    }
+    const game = gameDocument3D.parse(await response.json());
+    const manifestResponse = await fetch("./manifest.json", { signal: controller.signal });
+    if (!manifestResponse.ok) {
+        throw new Error("Export manifest could not load");
+    }
+    const manifest = z.object({ assets: z.record(z.string(), z.string().regex(/^\.\/assets\/[0-9a-f]{64}\.[a-z0-9]+$/)) }).parse(await manifestResponse.json());
+    const canvas = document.getElementById("game");
+    if (!(canvas instanceof HTMLCanvasElement)) {
+        throw new Error("Game viewport is missing");
+    }
+    const localAssets = new Map();
+    for (const [logicalId, binding] of Object.entries(game.assets)) {
+        const path = manifest.assets[logicalId];
+        if (!path || !path.startsWith(`./assets/${binding.digest}.`)) {
+            throw new Error(`Export asset ${logicalId} has no verified local path`);
+        }
+        const asset = await fetch(path, { signal: controller.signal });
+        if (!asset.ok) {
+            throw new Error(`Export asset ${logicalId} could not load`);
+        }
+        const bytes = new Uint8Array(await asset.arrayBuffer());
+        const hash = await crypto.subtle.digest("SHA-256", bytes);
+        const digest = Array.from(new Uint8Array(hash), (byte) => byte.toString(16).padStart(2, "0")).join("");
+        if (digest !== binding.digest) {
+            throw new Error(`Export asset ${logicalId} failed its digest check`);
+        }
+        localAssets.set(logicalId, bytes);
+    }
+    const open = () => createGameSession3D(game, 1, undefined, { signal: controller.signal,
+        resolveCollider: async (binding) => {
+            const bytes = localAssets.get(Object.entries(game.assets).find(([, entry]) => entry.assetId === binding.assetId)?.[0] ?? "");
+            if (!bytes) {
+                throw new Error("Export collider is missing");
+            }
+            return decodePreparedGameCollider3D(bytes, binding);
+        } });
+    let session = await open();
+    let paused = false;
+    let contextPaused = false;
+    const renderer = await createGameRenderer3D({ canvas, signal: controller.signal,
+        resolveFont: async (logicalId) => { const bytes = localAssets.get(logicalId); return bytes ? { bytes, digest: game.assets[logicalId]?.digest } : null; },
+        resolveModel: async (logicalId) => {
+            const bytes = localAssets.get(logicalId);
+            return bytes ? { bytes, digest: game.assets[logicalId]?.digest } : null;
+        },
+        onContextState: (state) => {
+            contextPaused = state === "lost";
+            status(state === "lost" ? "Graphics context lost. Play is paused until recovery." : "Graphics recovered");
+        } });
+    renderer.resize(game.presentation.hudWidth, game.presentation.hudWidth / game.presentation.aspectRatio);
+    let frame = session.frame();
+    const audio = new GameAudioPlayer({ assets: game.assets, tickRate: game.tickRate,
+        resolveAsset: async (binding) => manifest.assets[Object.entries(game.assets).find(([, entry]) => entry.assetId === binding.assetId && entry.digest === binding.digest)?.[0] ?? ""] ?? null,
+        status, mixer: game.audio?.mixer });
+    audio.preload();
+    audio.sync(session.snapshot());
+    const budget = new GameFrameBudgetMonitor(game.performance?.budgets);
+    for (const event of ["pointerdown", "keydown"]) {
+        window.addEventListener(event, () => { void audio.unlock(); }, { signal: controller.signal });
+    }
+    const step = (nextInput) => {
+        const result = session.step(nextInput);
+        frame = result.frame;
+        for (const event of result.events) {
+            audio.handle(event);
+        }
+        audio.sync(session.snapshot());
+    };
+    const input = new GameInput3D();
+    let dragging = false;
+    const release = () => { input.release(); dragging = false; };
+    window.addEventListener("keydown", (event) => {
+        input.keyDown(event.code, event.key);
+        if (input.handlesKey(game, event.code, event.key)) {
+            event.preventDefault();
+        }
+    }, { signal: controller.signal });
+    window.addEventListener("keyup", (event) => { input.keyUp(event.code); }, { signal: controller.signal });
+    const mouseFire = game.inputActions.includes("fire");
+    const bindings = resolveGameInputBindings(game);
+    const mouseLook = bindings.look.some((binding) => binding.kind === "mouse");
+    let unmountTouch;
+    // The touch layer is styled by the staged style.css, because the export CSP blocks inline styles.
+    const enableTouch = () => {
+        if (unmountTouch) {
+            return;
+        }
+        const layer = document.createElement("div");
+        layer.className = "touch-layer";
+        document.body.append(layer);
+        const unmount = mountTouchControls(layer, { layout: touchLayout(bindings), onChange: (state) => input.setTouch(state), onLook: (x, y) => input.touchLook(x, y) });
+        unmountTouch = () => { unmount(); layer.remove(); };
+    };
+    if (window.matchMedia("(pointer: coarse)").matches) {
+        enableTouch();
+    }
+    window.addEventListener("touchstart", enableTouch, { passive: true, signal: controller.signal });
+    // A touch that reaches the canvas, outside the touch zones or before they appear, fires on tap and turns the camera on drag.
+    canvas.addEventListener("pointerdown", (event) => {
+        dragging = true;
+        canvas.setPointerCapture(event.pointerId);
+        input.mouseDown(event.button);
+        if (event.pointerType !== "touch" && (mouseFire || mouseLook) && document.pointerLockElement !== canvas) {
+            void canvas.requestPointerLock().catch(() => { status(mouseFire ? "Mouse capture unavailable. Hold and drag to aim, or press F to fire." : "Mouse capture unavailable. Drag to turn the camera."); });
+        }
+    }, { signal: controller.signal });
+    window.addEventListener("pointerup", (event) => { dragging = false; input.mouseUp(event.button); }, { signal: controller.signal });
+    canvas.addEventListener("pointercancel", release, { signal: controller.signal });
+    document.addEventListener("pointerlockchange", () => { if (document.pointerLockElement !== canvas) {
+        release();
+    } }, { signal: controller.signal });
+    canvas.addEventListener("pointermove", (event) => { if (dragging || document.pointerLockElement === canvas) {
+        input.look(event.movementX, event.movementY);
+    } }, { signal: controller.signal });
+    window.addEventListener("blur", release, { signal: controller.signal });
+    const clock = new FixedTickClock(game.tickRate);
+    let animationId = 0;
+    let rendering = false;
+    let disposed = false;
+    const render = async (interpolation) => {
+        if (rendering || disposed) {
+            return;
+        }
+        rendering = true;
+        try {
+            audio.updateSpatial(gameAudioSpatialView3D(frame, interpolation));
+            const stats = await renderer.render(frame, interpolation);
+            budget.observe({ drawCalls: stats.drawCalls, triangles: stats.triangles, voices: gameAudioVoiceCount(audio.mixerState()) });
+        }
+        catch (error) {
+            if (renderer.capabilities.deviceStatus !== "lost") {
+                paused = true;
+            }
+            status(error instanceof Error ? error.message : "Rendering failed");
+        }
+        finally {
+            rendering = false;
+        }
+    };
+    document.addEventListener("visibilitychange", () => { release(); clock.reset(); }, { signal: controller.signal });
+    const tick = (now) => {
+        if (disposed) {
+            return;
+        }
+        if (!paused && !contextPaused && !document.hidden) {
+            try {
+                const interpolation = clock.advance(now, () => { input.pollGamepads(browserGamepads()); step(input.sample(game)); });
+                void render(interpolation);
+            }
+            catch (error) {
+                paused = true;
+                clock.reset();
+                status(error instanceof Error ? error.message : "Game script failed");
+            }
+        }
+        else if (contextPaused && renderer.capabilities.deviceStatus === "ready") {
+            void render(1);
+        }
+        if (paused || contextPaused || document.hidden) {
+            clock.reset();
+        }
+        animationId = requestAnimationFrame(tick);
+    };
+    document.getElementById("pause")?.addEventListener("click", (event) => {
+        paused = !paused;
+        // Input pressed while paused is dropped rather than delivered on resume (F23).
+        input.setEnabled(!paused);
+        if (event.currentTarget instanceof HTMLButtonElement) {
+            event.currentTarget.textContent = paused ? "Resume" : "Pause";
+        }
+        release();
+        clock.reset();
+        if (paused) {
+            audio.pause();
+        }
+        else {
+            audio.resume();
+        }
+    }, { signal: controller.signal });
+    document.getElementById("reset")?.addEventListener("click", () => {
+        paused = true;
+        void open().then((replacement) => {
+            session.dispose();
+            session = replacement;
+            audio.reset(session.snapshot());
+            frame = session.frame();
+            clock.reset();
+            release();
+            // Reset resumes play, so input dropped by an earlier pause is accepted again.
+            paused = false;
+            input.setEnabled(true);
+            const pause = document.getElementById("pause");
+            if (pause) {
+                pause.textContent = "Pause";
+            }
+            void render(1);
+        })
+            .catch((error) => status(error instanceof Error ? error.message : "Reset failed"));
+    }, { signal: controller.signal });
+    window.addEventListener("beforeunload", () => {
+        disposed = true;
+        cancelAnimationFrame(animationId);
+        controller.abort();
+        unmountTouch?.();
+        session.dispose();
+        renderer.dispose();
+        audio.dispose();
+    }, { once: true });
+    window.nativeGame3DPlayer = Object.freeze({
+        pause: () => { paused = true; release(); clock.reset(); },
+        step: async (nextInput) => { paused = true; step(nextInput); await render(1); },
+        reset: async () => { paused = true; const replacement = await open(); session.dispose(); session = replacement; audio.reset(session.snapshot()); frame = session.frame(); release(); clock.reset(); await render(1); },
+        advance: async (inputs) => {
+            if (inputs.length > 10_000) {
+                throw new Error("Recorded route exceeds 10000 ticks");
+            }
+            paused = true;
+            for (const nextInput of inputs) {
+                step(nextInput);
+            }
+            await render(1);
+        },
+        snapshot: () => session.snapshot(),
+        inspect: () => session.inspect()
+    });
+    // A static HTTP host is required for browser modules and WASM.
+    status(mouseFire ? "Ready. Click to capture the mouse and fire. WASD moves, F fires, Space jumps, Escape releases the mouse."
+        : "Ready. Move with WASD, arrows or a gamepad, jump with Space. Click to capture the mouse for looking, Escape releases it.");
+    await render(1);
+    animationId = requestAnimationFrame(tick);
+}
+void start().catch((error) => status(error instanceof Error ? error.message : "Game could not start"));
+//# sourceMappingURL=standalone-player3d.js.map

package/dist/standalone-player3d.js.map

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

package/dist/touch-controls.d.ts

@@ -1,15 +1,29 @@
+import type { ResolvedGameInputBindings } from "@nodetool-ai/protocol";
+import type { TouchInputState } from "./input-bindings.js";
 /** Maps a stick offset in screen pixels (y grows downward) to the direction actions it presses. */
 export declare function stickActions(dx: number, dy: number, deadZone: number): string[];
-/** Splits a game's input actions into the stick's directions and one button per other action. */
-export declare function touchLayout(inputActions: readonly string[]): {
-    stick: string[];
-    buttons: string[];
-};
+export interface TouchLayout {
+    /** Whether any action or axis reads the floating stick. */
+    readonly stick: boolean;
+    /** One button per action with a touch button binding, in action order. */
+    readonly buttons: readonly {
+        readonly action: string;
+        readonly label: string;
+    }[];
+    /** Whether a drag on the right half turns the camera. */
+    readonly look: boolean;
+}
+/** Derives the on-screen controls from a document's resolved input bindings. */
+export declare function touchLayout(bindings: ResolvedGameInputBindings): TouchLayout;
 export interface TouchControlsOptions {
-    readonly inputActions: readonly string[];
-    /** Called with the full set of actions touch currently holds. */
-    readonly onChange: (pressed: ReadonlySet<string>) => void;
+    readonly layout: TouchLayout;
+    /** Called with everything touch currently holds. */
+    readonly onChange: (state: TouchInputState) => void;
+    /** Called with drag movement in pixels on the look zone. */
+    readonly onLook?: (x: number, y: number) => void;
 }
+/** Styles for the touch layer, for players whose page does not already define them. */
+export declare const TOUCH_CONTROLS_CSS: string;
 /**
  * A floating stick on the left half of the screen and action buttons on the right.
  * The stick appears where the thumb lands, so it works for any hand position.

package/dist/touch-controls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"touch-controls.d.ts","sourceRoot":"","sources":["../src/touch-controls.ts"],"names":[],"mappings":"AAIA,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAa/E;AAED,iGAAiG;AACjG,wBAAgB,WAAW,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAGnG;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;CAC3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAqG/F"}
+{"version":3,"file":"touch-controls.d.ts","sourceRoot":"","sources":["../src/touch-controls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAK3D,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAa/E;AAED,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACjF,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,QAAQ,EAAE,yBAAyB,GAAG,WAAW,CAY5E;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;IACpD,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED,uFAAuF;AACvF,eAAO,MAAM,kBAAkB,QAU4B,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,GAAG,MAAM,IAAI,CA4I/F"}

package/dist/touch-controls.js

@@ -1,4 +1,3 @@
-const DIRECTIONS = ["left", "right", "up", "down"];
 // sin(22.5°): an axis turns on once the stick leans past the edge of its 45° sector, which gives 8-way input.
 const AXIS_THRESHOLD = 0.38;
 /** Maps a stick offset in screen pixels (y grows downward) to the direction actions it presses. */
@@ -20,30 +19,94 @@ export function stickActions(dx, dy, deadZone) {
         actions.push("down");
     return actions;
 }
-/** Splits a game's input actions into the stick's directions and one button per other action. */
-export function touchLayout(inputActions) {
-    const stick = DIRECTIONS.filter((action) => inputActions.includes(action));
-    return { stick, buttons: inputActions.filter((action) => !stick.includes(action)) };
+/** Derives the on-screen controls from a document's resolved input bindings. */
+export function touchLayout(bindings) {
+    const buttons = [];
+    for (const { action, bindings: list } of bindings.actions) {
+        const button = list.find((binding) => binding.kind === "touchButton");
+        if (button) {
+            buttons.push({ action, label: button.label ?? action.toUpperCase() });
+        }
+    }
+    return {
+        stick: bindings.actions.some(({ bindings: list }) => list.some((binding) => binding.kind === "touchStick")) ||
+            bindings.axes.some(({ bindings: list }) => list.some((binding) => binding.kind === "touchStick")),
+        buttons,
+        look: bindings.look.some((binding) => binding.kind === "touchDrag")
+    };
 }
+/** Styles for the touch layer, for players whose page does not already define them. */
+export const TOUCH_CONTROLS_CSS = ".touch-layer{position:fixed;inset:0;z-index:2;pointer-events:none}" +
+    ".touch-stick-zone{position:absolute;left:0;top:0;bottom:0;width:50%;pointer-events:auto;touch-action:none}" +
+    ".touch-look-zone{position:absolute;right:0;top:0;bottom:0;width:50%;pointer-events:auto;touch-action:none}" +
+    ".touch-stick{position:absolute;left:25%;top:70%;width:7.5rem;height:7.5rem;margin:-3.75rem 0 0 -3.75rem;border-radius:50%;border:2px solid #fff5;background:#fff1;opacity:.35;transition:opacity .15s}" +
+    ".touch-stick.active{opacity:.9}" +
+    ".touch-knob{position:absolute;left:50%;top:50%;width:3.25rem;height:3.25rem;margin:-1.625rem 0 0 -1.625rem;border-radius:50%;background:#fff8;box-shadow:0 0 1rem #fff6}" +
+    ".touch-buttons{position:absolute;right:max(1.25rem,env(safe-area-inset-right));bottom:max(1.25rem,env(safe-area-inset-bottom));display:flex;flex-direction:column-reverse;gap:1rem;pointer-events:auto}" +
+    ".touch-button{width:5.25rem;height:5.25rem;border-radius:50%;border:2px solid #fff6;background:#ffffff1f;color:#fff;font:600 .8rem system-ui,sans-serif;letter-spacing:.05em;touch-action:none;box-shadow:0 0 1.25rem #0008}" +
+    ".touch-button.active{background:#ffffff59;transform:scale(.94)}" +
+    // After mouse movement the layer lets clicks through, so a mouse on a touchscreen laptop reaches the game.
+    ".touch-layer[data-pointer=mouse] *{pointer-events:none}";
 /**
  * A floating stick on the left half of the screen and action buttons on the right.
  * The stick appears where the thumb lands, so it works for any hand position.
  */
 export function mountTouchControls(root, options) {
-    const layout = touchLayout(options.inputActions);
-    const held = new Map();
-    const emit = () => {
-        const pressed = new Set();
-        for (const actions of held.values())
-            actions.forEach((action) => pressed.add(action));
-        options.onChange(pressed);
-    };
+    const { layout } = options;
+    let stick;
+    const held = new Set();
+    const emit = () => { options.onChange({ stick, buttons: new Set(held) }); };
     const cleanups = [];
+    // A mouse that moves over the page switches the layer to pass-through. The next touch or pen switches it back.
+    const pointerMode = (event) => {
+        const mode = event.pointerType === "mouse" ? "mouse" : "touch";
+        if (root.dataset.pointer !== mode) {
+            root.dataset.pointer = mode;
+        }
+    };
+    window.addEventListener("pointermove", pointerMode, { capture: true, passive: true });
+    window.addEventListener("pointerdown", pointerMode, { capture: true, passive: true });
+    cleanups.push(() => {
+        window.removeEventListener("pointermove", pointerMode, { capture: true });
+        window.removeEventListener("pointerdown", pointerMode, { capture: true });
+        delete root.dataset.pointer;
+    });
     const listen = (target, type, handler) => {
         target.addEventListener(type, handler, { passive: false });
         cleanups.push(() => target.removeEventListener(type, handler));
     };
-    if (layout.stick.length > 0) {
+    if (layout.look && options.onLook) {
+        const onLook = options.onLook;
+        const zone = document.createElement("div");
+        zone.className = "touch-look-zone";
+        root.append(zone);
+        let pointerId;
+        let lastX = 0;
+        let lastY = 0;
+        const end = (event) => { if (event.pointerId === pointerId)
+            pointerId = undefined; };
+        listen(zone, "pointerdown", (event) => {
+            if (event.pointerType === "mouse")
+                return;
+            event.preventDefault();
+            if (pointerId !== undefined)
+                return;
+            pointerId = event.pointerId;
+            zone.setPointerCapture(event.pointerId);
+            lastX = event.clientX;
+            lastY = event.clientY;
+        });
+        listen(zone, "pointermove", (event) => {
+            if (event.pointerId !== pointerId)
+                return;
+            onLook(event.clientX - lastX, event.clientY - lastY);
+            lastX = event.clientX;
+            lastY = event.clientY;
+        });
+        listen(zone, "pointerup", end);
+        listen(zone, "pointercancel", end);
+    }
+    if (layout.stick) {
         const zone = document.createElement("div");
         zone.className = "touch-stick-zone";
         const base = document.createElement("div");
@@ -67,7 +130,7 @@ export function mountTouchControls(root, options) {
                 dy = (dy / length) * limit;
             }
             knob.style.transform = `translate(${dx}px, ${dy}px)`;
-            held.set("stick", new Set(stickActions(dx, dy, limit * 0.25).filter((action) => layout.stick.includes(action))));
+            stick = { x: dx / limit, y: dy / limit };
             emit();
         };
         const release = (event) => {
@@ -76,10 +139,12 @@ export function mountTouchControls(root, options) {
             pointerId = undefined;
             base.classList.remove("active");
             knob.style.transform = "";
-            held.delete("stick");
+            stick = undefined;
             emit();
         };
         listen(zone, "pointerdown", (event) => {
+            if (event.pointerType === "mouse")
+                return;
             event.preventDefault();
             if (pointerId !== undefined)
                 return;
@@ -102,23 +167,24 @@ export function mountTouchControls(root, options) {
     }
     const buttons = document.createElement("div");
     buttons.className = "touch-buttons";
-    for (const action of layout.buttons) {
+    for (const { action, label } of layout.buttons) {
         const button = document.createElement("button");
         button.type = "button";
         button.className = "touch-button";
-        button.textContent = action.toUpperCase();
+        button.textContent = label;
         button.setAttribute("aria-label", action);
-        const key = `button:${action}`;
         const up = () => {
             button.classList.remove("active");
-            held.delete(key);
+            held.delete(action);
             emit();
         };
         listen(button, "pointerdown", (event) => {
+            if (event.pointerType === "mouse")
+                return;
             event.preventDefault();
             button.setPointerCapture(event.pointerId);
             button.classList.add("active");
-            held.set(key, new Set([action]));
+            held.add(action);
             emit();
         });
         listen(button, "pointerup", up);
@@ -131,6 +197,7 @@ export function mountTouchControls(root, options) {
         cleanups.forEach((cleanup) => cleanup());
         root.replaceChildren();
         held.clear();
+        stick = undefined;
     };
 }
 //# sourceMappingURL=touch-controls.js.map

package/dist/touch-controls.js.map

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

package/dist/ui/controller.d.ts

@@ -0,0 +1,59 @@
+import type { GameUiFrame } from "@nodetool-ai/protocol";
+import type { GamepadLike } from "../input-bindings.js";
+import { type GameUiInsets, type GameUiMeasureText, type GameUiViewport } from "./layout.js";
+/** Where HUD button presses go: `GameInput` holds the button's action like a bound control. */
+export interface GameUiActionSink {
+    pressUiAction(action: string): void;
+    releaseUiAction(action: string): void;
+}
+/**
+ * Turns pointer, touch and gamepad input on the HUD into presses of the buttons' input actions.
+ * A pressed button holds its action until the pointer lifts or the confirm button is released, so a button
+ * reaches the simulation as ordinary input and replays exactly. Focus is presentation and never enters a snapshot.
+ */
+export declare class GameUiController {
+    private readonly sink;
+    private readonly measure;
+    private boxes;
+    private ui;
+    private focusId;
+    private readonly held;
+    private readonly padButtons;
+    private insets;
+    constructor(sink: GameUiActionSink, measure: GameUiMeasureText);
+    /** Lays out the frame's HUD tree in the HUD rectangle, for hit tests and focus moves until the next frame. */
+    update(ui: GameUiFrame | undefined, viewport: GameUiViewport, insets?: GameUiInsets): void;
+    /** The frame's HUD tree with the focused button and safe-area insets, for the renderer. */
+    annotate<F extends {
+        ui?: GameUiFrame;
+    }>(frame: F): F;
+    get focusedId(): string | undefined;
+    /** A pointer went down at a HUD point. Returns true when it landed on a button, which then holds its action. */
+    pointerDown(pointerId: number, x: number, y: number): boolean;
+    pointerUp(pointerId: number): void;
+    /** Whether the D-pad and confirm button drive the HUD this frame. */
+    get navigating(): boolean;
+    /**
+     * Moves focus with the D-pad and presses the focused button with the confirm button, then returns the pads
+     * with those buttons released, so the game's own bindings do not also see them. Without focus navigation the
+     * pads pass through unchanged.
+     */
+    pollGamepads(pads: readonly (GamepadLike | null)[] | null | undefined): readonly (GamepadLike | null)[];
+    /** Releases everything the HUD holds, as when play pauses or stops. */
+    release(): void;
+    private hold;
+    private releaseKey;
+}
+/**
+ * Forwards pointer events on `element` that land on HUD buttons to the controller, in HUD pixels.
+ * Events that hit a button stop there, so they do not also reach touch look or canvas focus handlers.
+ */
+export declare function attachGameUiPointer(element: HTMLElement, controller: GameUiController, viewport: () => GameUiViewport | undefined, active?: () => boolean): () => void;
+/**
+ * The device safe area where it overlaps `element`, in HUD pixels. Reads the CSS `env(safe-area-inset-*)`
+ * values through a probe element, so it is zero on devices without a notch or rounded corners.
+ */
+export declare function browserGameUiInsets(element: HTMLElement, viewport: GameUiViewport): GameUiInsets;
+/** Measures HUD text with an offscreen browser canvas. Without a 2D context, text measures zero wide. */
+export declare function browserGameUiMeasure(gameId: string | undefined): GameUiMeasureText;
+//# sourceMappingURL=controller.d.ts.map

package/dist/ui/controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../src/ui/controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAwF,KAAK,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAEnL,+FAA+F;AAC/F,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAOD;;;;GAIG;AACH,qBAAa,gBAAgB;IAQf,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAoB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP7E,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAC3D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,MAAM,CAA2B;IAEzC,YAA6B,IAAI,EAAE,gBAAgB,EAAmB,OAAO,EAAE,iBAAiB,EAAI;IAEpG,8GAA8G;IAC9G,MAAM,CAAC,EAAE,EAAE,WAAW,GAAG,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAOzF;IAED,2FAA2F;IAC3F,QAAQ,CAAC,CAAC,SAAS;QAAE,EAAE,CAAC,EAAE,WAAW,CAAA;KAAE,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMpD;IAED,IAAI,SAAS,IAAI,MAAM,GAAG,SAAS,CAAyB;IAE5D,gHAAgH;IAChH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAK5D;IAED,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEjC;IAED,qEAAqE;IACrE,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CA4BtG;IAED,uEAAuE;IACvE,OAAO,IAAI,IAAI,CAGd;IAED,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,UAAU;CAMnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,cAAc,GAAG,SAAS,EAChI,MAAM,GAAE,MAAM,OAAoB,GAAG,MAAM,IAAI,CAsBhD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,cAAc,GAAG,YAAY,CAmBhG;AAED,yGAAyG;AACzG,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,CAOlF"}