@nodetool-ai/game-renderer 0.8.1

package/dist/.nodetool-build-stamp

@@ -0,0 +1 @@
+2026-09-28T09:19:04.696Z

package/dist/audio.d.ts

@@ -0,0 +1,39 @@
+import type { GameAssetBinding, GameDocument, GameEvent, GameSnapshot } from "@nodetool-ai/protocol";
+export interface GameAudioOptions {
+    readonly assets: GameDocument["assets"];
+    readonly tickRate: number;
+    readonly resolveAsset: (binding: GameAssetBinding) => Promise<string | null>;
+    readonly status: (message: string) => void;
+    readonly context?: AudioContext;
+}
+/** Shares Web Audio voice, decoding, and lifecycle behavior across browser players. */
+export declare class GameAudioPlayer {
+    private readonly options;
+    private readonly context;
+    private readonly buffers;
+    private readonly voices;
+    private readonly fading;
+    private readonly pending;
+    private desiredMusic;
+    private sceneId;
+    private tick;
+    private generation;
+    private legacySequence;
+    private disposed;
+    private paused;
+    constructor(options: GameAudioOptions);
+    private buffer;
+    preload(): void;
+    unlock(): Promise<void>;
+    pause(): void;
+    resume(): void;
+    sync(snapshot: GameSnapshot): void;
+    private startDesiredMusic;
+    handle(event: GameEvent): void;
+    private start;
+    private playBuiltin;
+    private stop;
+    reset(snapshot: GameSnapshot): void;
+    dispose(): void;
+}
+//# sourceMappingURL=audio.d.ts.map

package/dist/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../src/audio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAYrG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7E,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC;AAED,uFAAuF;AACvF,qBAAa,eAAe;IAcd,OAAO,CAAC,QAAQ,CAAC,OAAO;IAbpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IAEvB,YAA6B,OAAO,EAAE,gBAAgB,EAErD;IAED,OAAO,CAAC,MAAM;IAqBd,OAAO,IAAI,IAAI,CAId;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ5B;IAED,KAAK,IAAI,IAAI,CAIZ;IAED,MAAM,IAAI,IAAI,CAGb;IAED,IAAI,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAoBjC;IAED,OAAO,CAAC,iBAAiB;IAWzB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAc7B;YAEa,KAAK;IA2CnB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,IAAI;IAeZ,KAAK,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAQlC;IAED,OAAO,IAAI,IAAI,CAUd;CACF"}

package/dist/audio.js

@@ -0,0 +1,227 @@
+const MAX_VOICES = 32;
+/** Shares Web Audio voice, decoding, and lifecycle behavior across browser players. */
+export class GameAudioPlayer {
+    options;
+    context;
+    buffers = new Map();
+    voices = new Map();
+    fading = new Set();
+    pending = new Map();
+    desiredMusic = null;
+    sceneId = null;
+    tick = 0;
+    generation = 0;
+    legacySequence = 0;
+    disposed = false;
+    paused = false;
+    constructor(options) {
+        this.options = options;
+        this.context = options.context ?? new AudioContext();
+    }
+    buffer(assetId) {
+        const cached = this.buffers.get(assetId);
+        if (cached)
+            return cached;
+        const binding = this.options.assets[assetId];
+        if (!binding) {
+            this.options.status(`Audio asset ${assetId} is missing`);
+            return Promise.resolve(null);
+        }
+        const pending = this.options.resolveAsset(binding).then(async (url) => {
+            if (!url)
+                throw new Error("asset URL is unavailable");
+            const response = await fetch(url, { cache: "force-cache" });
+            if (!response.ok)
+                throw new Error(`HTTP ${response.status}`);
+            return this.context.decodeAudioData(await response.arrayBuffer());
+        }).catch((error) => {
+            this.options.status(`Audio ${assetId} could not be decoded: ${error instanceof Error ? error.message : String(error)}`);
+            return null;
+        });
+        this.buffers.set(assetId, pending);
+        return pending;
+    }
+    preload() {
+        for (const [id, binding] of Object.entries(this.options.assets)) {
+            if (binding.mediaKind === "audio" && !binding.assetId.startsWith("builtin:"))
+                void this.buffer(id);
+        }
+    }
+    async unlock() {
+        if (this.disposed || this.paused)
+            return;
+        try {
+            await this.context.resume();
+            this.startDesiredMusic();
+        }
+        catch {
+            this.options.status("Audio is blocked. Tap Play to enable sound in this browser.");
+        }
+    }
+    pause() {
+        if (this.disposed || this.paused)
+            return;
+        this.paused = true;
+        void this.context.suspend().catch(() => this.options.status("Audio could not pause"));
+    }
+    resume() {
+        this.paused = false;
+        void this.unlock();
+    }
+    sync(snapshot) {
+        if (this.disposed)
+            return;
+        this.tick = snapshot.tick;
+        if (this.sceneId && this.sceneId !== snapshot.sceneId) {
+            for (const id of this.pending.keys()) {
+                if (!id.startsWith(`effect:${snapshot.sceneId}:`))
+                    this.pending.delete(id);
+            }
+            for (const id of this.voices.keys()) {
+                if (id.startsWith(`effect:${this.sceneId}:`))
+                    this.stop(id, 0);
+            }
+        }
+        this.sceneId = snapshot.sceneId;
+        const next = snapshot.music;
+        if (this.desiredMusic?.voiceId !== next?.voiceId || this.desiredMusic?.startTick !== next?.startTick ||
+            this.desiredMusic?.assetId !== next?.assetId || this.desiredMusic?.volume !== next?.volume ||
+            this.desiredMusic?.fadeInTicks !== next?.fadeInTicks || this.desiredMusic?.fadeOutTicks !== next?.fadeOutTicks) {
+            if (this.desiredMusic)
+                this.stop(this.desiredMusic.voiceId, this.desiredMusic.fadeOutTicks);
+            this.desiredMusic = next;
+        }
+        this.startDesiredMusic();
+    }
+    startDesiredMusic() {
+        const music = this.desiredMusic;
+        if (!music || this.paused || this.context.state !== "running" || this.voices.has(music.voiceId) || this.pending.has(music.voiceId))
+            return;
+        const token = Symbol();
+        this.pending.set(music.voiceId, token);
+        void this.start(music.voiceId, music.assetId, true, music.volume, music.fadeInTicks, music.fadeOutTicks, token, music.startTick)
+            .catch((error) => this.options.status(`Music could not start: ${error instanceof Error ? error.message : String(error)}`))
+            .finally(() => { if (this.pending.get(music.voiceId) === token)
+            this.pending.delete(music.voiceId); });
+    }
+    handle(event) {
+        if (this.disposed || event.kind !== "audio")
+            return;
+        if (event.action === "stop") {
+            if (event.voiceId)
+                this.stop(event.voiceId, event.fadeOutTicks);
+            return;
+        }
+        if (this.paused || this.context.state !== "running")
+            return;
+        const voiceId = event.voiceId ?? `legacy:${this.tick}:${this.legacySequence++}`;
+        if (this.pending.has(voiceId))
+            return;
+        const token = Symbol();
+        this.pending.set(voiceId, token);
+        void this.start(voiceId, event.assetId, event.loop, event.volume, event.fadeInTicks, event.fadeOutTicks, token)
+            .catch((error) => this.options.status(`Audio effect could not start: ${error instanceof Error ? error.message : String(error)}`))
+            .finally(() => { if (this.pending.get(voiceId) === token)
+            this.pending.delete(voiceId); });
+    }
+    async start(id, assetId, loop, volume, fadeInTicks, fadeOutTicks, token, logicalStartTick) {
+        const generation = this.generation;
+        const binding = this.options.assets[assetId];
+        if (binding?.assetId.startsWith("builtin:")) {
+            if (loop)
+                this.options.status(`Audio ${assetId} cannot loop a built-in effect`);
+            else
+                this.playBuiltin(volume);
+            return;
+        }
+        const buffer = await this.buffer(assetId);
+        if (!buffer || this.disposed || this.paused || this.context.state !== "running" || generation !== this.generation ||
+            this.pending.get(id) !== token || this.voices.has(id))
+            return;
+        if (this.voices.size + this.fading.size >= MAX_VOICES && this.fading.size > 0) {
+            const fading = this.fading.values().next().value;
+            if (fading) {
+                fading.source.stop();
+                this.fading.delete(fading);
+            }
+        }
+        if (this.voices.size + this.fading.size >= MAX_VOICES) {
+            const oldestEffect = [...this.voices.values()].find((voice) => !voice.loop);
+            if (!oldestEffect)
+                return;
+            this.stop(oldestEffect.id, 0);
+        }
+        const source = this.context.createBufferSource();
+        const gain = this.context.createGain();
+        source.buffer = buffer;
+        source.loop = loop;
+        source.connect(gain).connect(this.context.destination);
+        const now = this.context.currentTime;
+        gain.gain.setValueAtTime(fadeInTicks > 0 ? 0 : volume, now);
+        if (fadeInTicks > 0)
+            gain.gain.linearRampToValueAtTime(volume, now + fadeInTicks / this.options.tickRate);
+        const voice = { id, source, gain, loop, fadeOutTicks };
+        this.voices.set(id, voice);
+        source.onended = () => {
+            if (this.voices.get(id) === voice)
+                this.voices.delete(id);
+            this.fading.delete(voice);
+            source.disconnect();
+            gain.disconnect();
+        };
+        const offset = logicalStartTick === undefined ? 0 : Math.max(0, this.tick - logicalStartTick) / this.options.tickRate;
+        source.start(0, loop && buffer.duration > 0 ? offset % buffer.duration : 0);
+    }
+    playBuiltin(volume) {
+        const oscillator = this.context.createOscillator();
+        const gain = this.context.createGain();
+        oscillator.frequency.value = 660;
+        gain.gain.setValueAtTime(volume * 0.08, this.context.currentTime);
+        gain.gain.exponentialRampToValueAtTime(0.001, this.context.currentTime + 0.12);
+        oscillator.connect(gain).connect(this.context.destination);
+        oscillator.onended = () => { oscillator.disconnect(); gain.disconnect(); };
+        oscillator.start();
+        oscillator.stop(this.context.currentTime + 0.12);
+    }
+    stop(id, fadeTicks) {
+        this.pending.delete(id);
+        const voice = this.voices.get(id);
+        if (!voice)
+            return;
+        this.voices.delete(id);
+        const now = this.context.currentTime;
+        voice.gain.gain.cancelScheduledValues(now);
+        if (fadeTicks > 0) {
+            this.fading.add(voice);
+            voice.gain.gain.setValueAtTime(voice.gain.gain.value, now);
+            voice.gain.gain.linearRampToValueAtTime(0, now + fadeTicks / this.options.tickRate);
+        }
+        voice.source.stop(now + fadeTicks / this.options.tickRate);
+    }
+    reset(snapshot) {
+        this.generation += 1;
+        this.pending.clear();
+        for (const id of this.voices.keys())
+            this.stop(id, 0);
+        for (const voice of this.fading)
+            voice.source.stop();
+        this.fading.clear();
+        this.desiredMusic = null;
+        this.sync(snapshot);
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.generation += 1;
+        this.pending.clear();
+        for (const id of this.voices.keys())
+            this.stop(id, 0);
+        for (const voice of this.fading)
+            voice.source.stop();
+        this.fading.clear();
+        this.buffers.clear();
+        void this.context.close();
+    }
+}
+//# sourceMappingURL=audio.js.map

package/dist/audio.js.map

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

package/dist/browser-fonts.d.ts

@@ -0,0 +1,8 @@
+import type { GameDocument } from "@nodetool-ai/protocol";
+export interface LoadedGameFonts {
+    readonly diagnostics: readonly string[];
+    dispose(): void;
+}
+/** Load every font before the first frame so optional fallback is deterministic. */
+export declare function loadBrowserGameFonts(document: GameDocument, resolveFont: (assetId: string) => Promise<string | null>): Promise<LoadedGameFonts>;
+//# sourceMappingURL=browser-fonts.d.ts.map

package/dist/browser-fonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-fonts.d.ts","sourceRoot":"","sources":["../src/browser-fonts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,oFAAoF;AACpF,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GACvD,OAAO,CAAC,eAAe,CAAC,CA2B1B"}

package/dist/browser-fonts.js

@@ -0,0 +1,39 @@
+import { fontBindings, gameFontFamily } from "./fonts.js";
+/** Load every font before the first frame so optional fallback is deterministic. */
+export async function loadBrowserGameFonts(document, resolveFont) {
+    const loaded = [];
+    const diagnostics = [];
+    try {
+        for (const [fontId, binding] of fontBindings(document)) {
+            const family = gameFontFamily(document.id, fontId);
+            try {
+                const url = await resolveFont(binding.assetId);
+                if (!url)
+                    throw new Error("asset is missing");
+                const response = await fetch(url);
+                if (!response.ok)
+                    throw new Error(`HTTP ${response.status}`);
+                const bytes = await response.arrayBuffer();
+                const face = new FontFace(family, bytes);
+                await face.load();
+                documentGlobalFonts().add(face);
+                loaded.push(face);
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error);
+                if (binding.required !== false)
+                    throw new Error(`Required font ${fontId} could not load: ${detail}`);
+                diagnostics.push(`Optional font ${fontId} could not load; using system font`);
+            }
+        }
+    }
+    catch (error) {
+        loaded.forEach((face) => documentGlobalFonts().delete(face));
+        throw error;
+    }
+    return { diagnostics, dispose: () => loaded.forEach((face) => documentGlobalFonts().delete(face)) };
+}
+function documentGlobalFonts() {
+    return document.fonts;
+}
+//# sourceMappingURL=browser-fonts.js.map

package/dist/browser-fonts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-fonts.js","sourceRoot":"","sources":["../src/browser-fonts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAO1D,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,QAAsB,EACtB,WAAwD;IAExD,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YACnD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAC/C,IAAI,CAAC,GAAG;oBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;gBAC9C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;gBAClC,IAAI,CAAC,QAAQ,CAAC,EAAE;oBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC7D,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;gBAC3C,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;gBACzC,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;gBAClB,mBAAmB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAChC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACtE,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,oBAAoB,MAAM,EAAE,CAAC,CAAC;gBACrG,WAAW,CAAC,IAAI,CAAC,iBAAiB,MAAM,oCAAoC,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7D,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AACtG,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO,QAAQ,CAAC,KAAK,CAAC;AACxB,CAAC"}

package/dist/browser.d.ts

@@ -0,0 +1,31 @@
+import type { GameRenderFrame } from "@nodetool-ai/protocol";
+import { type GameAssetResolver } from "./canvas2d.js";
+import type { GameHudEffectOrder, GameRenderer, GameRendererBackend, GameRendererCapabilities, GameRendererEffect, GameRendererStats } from "./index.js";
+export { loadBrowserGameFonts } from "./browser-fonts.js";
+export interface CreateGameRendererOptions {
+    readonly canvas: HTMLCanvasElement;
+    readonly assets: GameAssetResolver;
+    readonly backend?: "auto" | GameRendererBackend;
+}
+export declare class RecoveringGameRenderer implements GameRenderer {
+    private current;
+    private readonly assets;
+    private effects;
+    private deviceLossCount;
+    private fallbackReason;
+    private renderTail;
+    constructor(current: GameRenderer, assets: GameAssetResolver);
+    get backend(): GameRendererBackend;
+    get canvas(): HTMLCanvasElement;
+    get capabilities(): GameRendererCapabilities;
+    setEffects(effects: readonly GameRendererEffect[], hudOrder?: GameHudEffectOrder): void;
+    render(frame: GameRenderFrame, interpolation: number): Promise<GameRendererStats>;
+    private renderCurrent;
+    resize(width: number, height: number): void;
+    invalidateAsset(assetId: string): void;
+    dispose(): void;
+}
+/** Creates a browser game renderer, falling back to Canvas2D when WebGPU is unavailable. */
+export declare function createGameRenderer(options: CreateGameRendererOptions): Promise<GameRenderer>;
+export type { GameAssetResolver, GameImage } from "./canvas2d.js";
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAoC,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEzJ,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;CACjD;AAaD,qBAAa,sBAAuB,YAAW,YAAY;IAK7C,OAAO,CAAC,OAAO;IAAgB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAJlE,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,UAAU,CAAoC;IACtD,YAAoB,OAAO,EAAE,YAAY,EAAmB,MAAM,EAAE,iBAAiB,EAAI;IAEzF,IAAI,OAAO,IAAI,mBAAmB,CAAiC;IACnE,IAAI,MAAM,IAAI,iBAAiB,CAAgC;IAC/D,IAAI,YAAY,IAAI,wBAAwB,CAG3C;IACD,UAAU,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,EAAE,QAAQ,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAGtF;IAED,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAKhF;YAEa,aAAa;IAwB3B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAwC;IACnF,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAA2C;IACjF,OAAO,IAAI,IAAI,CAA4B;CAC5C;AAED,4FAA4F;AAC5F,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,YAAY,CAAC,CAqClG;AAED,YAAY,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC"}

package/dist/browser.js

@@ -0,0 +1,106 @@
+import { AssetCache, Canvas2DGameRenderer } from "./canvas2d.js";
+import { WebGPUGameRenderer } from "./webgpu.js";
+export { loadBrowserGameFonts } from "./browser-fonts.js";
+function replacementCanvas(canvas) {
+    const replacement = document.createElement("canvas");
+    replacement.width = canvas.width;
+    replacement.height = canvas.height;
+    replacement.id = canvas.id;
+    replacement.className = canvas.className;
+    replacement.style.cssText = canvas.style.cssText;
+    canvas.parentNode?.replaceChild(replacement, canvas);
+    return replacement;
+}
+export class RecoveringGameRenderer {
+    current;
+    assets;
+    effects = [];
+    deviceLossCount = 0;
+    fallbackReason = null;
+    renderTail = Promise.resolve();
+    constructor(current, assets) {
+        this.current = current;
+        this.assets = assets;
+    }
+    get backend() { return this.current.backend; }
+    get canvas() { return this.current.canvas; }
+    get capabilities() {
+        return { ...this.current.capabilities, deviceLossCount: this.deviceLossCount,
+            fallbackReason: this.fallbackReason };
+    }
+    setEffects(effects, hudOrder) {
+        this.current.setEffects(effects, hudOrder);
+        this.effects = effects;
+    }
+    render(frame, interpolation) {
+        // A later frame can replace HUD textures while an earlier frame is still being encoded.
+        const result = this.renderTail.then(() => this.renderCurrent(frame, interpolation));
+        this.renderTail = result.then(() => undefined, () => undefined);
+        return result;
+    }
+    async renderCurrent(frame, interpolation) {
+        if (this.effects.some((effect) => effect.required) && !this.current.capabilities.gpuEffects) {
+            throw new Error("Required GPU effect is unavailable after WebGPU failure");
+        }
+        try {
+            return await this.current.render(frame, interpolation);
+        }
+        catch (error) {
+            if (this.current.backend !== "webgpu" || !(error instanceof Error) ||
+                (error.message !== "WebGPU device was lost" && !error.message.startsWith("WebGPU game render failed"))) {
+                throw error;
+            }
+            const canvas = replacementCanvas(this.current.canvas);
+            this.current.dispose();
+            this.current = new Canvas2DGameRenderer(canvas, new AssetCache(this.assets));
+            this.deviceLossCount++;
+            this.fallbackReason = error.message;
+            if (this.effects.some((effect) => effect.required)) {
+                throw new Error("Required GPU effect is unavailable after WebGPU failure");
+            }
+            this.effects = [];
+            return this.current.render(frame, interpolation);
+        }
+    }
+    resize(width, height) { this.current.resize(width, height); }
+    invalidateAsset(assetId) { this.current.invalidateAsset(assetId); }
+    dispose() { this.current.dispose(); }
+}
+/** Creates a browser game renderer, falling back to Canvas2D when WebGPU is unavailable. */
+export async function createGameRenderer(options) {
+    const backend = options.backend ?? "auto";
+    if (backend !== "canvas2d" && typeof navigator !== "undefined" && navigator.gpu) {
+        let device;
+        let context = null;
+        try {
+            const adapter = await navigator.gpu.requestAdapter();
+            if (adapter) {
+                device = await adapter.requestDevice();
+                context = options.canvas.getContext("webgpu");
+                if (context) {
+                    const format = navigator.gpu.getPreferredCanvasFormat();
+                    context.configure({ device, format, alphaMode: "premultiplied" });
+                    const info = adapter.info;
+                    const adapterType = info?.device?.toLowerCase().includes("software") ||
+                        info?.architecture?.toLowerCase().includes("swiftshader") ||
+                        info?.architecture?.toLowerCase().includes("llvmpipe") ? "software" : "unknown";
+                    return new RecoveringGameRenderer(new WebGPUGameRenderer(options.canvas, device, context, format, new AssetCache(options.assets), adapterType), options.assets);
+                }
+                device.destroy();
+            }
+        }
+        catch (error) {
+            context?.unconfigure();
+            device?.destroy();
+            if (backend === "webgpu") {
+                throw error;
+            }
+            return new Canvas2DGameRenderer(replacementCanvas(options.canvas), new AssetCache(options.assets));
+        }
+    }
+    if (backend === "webgpu") {
+        throw new Error("WebGPU is unavailable on this device");
+    }
+    return new Canvas2DGameRenderer(options.canvas, new AssetCache(options.assets));
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

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

package/dist/build.d.ts

@@ -0,0 +1,19 @@
+import type { GameDocument } from "@nodetool-ai/protocol";
+export interface StandaloneAsset {
+    readonly bytes: Uint8Array;
+    readonly mimeType: string;
+}
+export interface BuildStandaloneGameOptions {
+    readonly document: GameDocument;
+    readonly outputDir: string;
+    readonly resolveAsset: (sourceAssetId: string) => Promise<StandaloneAsset | null>;
+}
+export interface StandaloneGameBuild {
+    readonly outputDir: string;
+    readonly gamePath: string;
+    readonly playerPath: string;
+    readonly assetPaths: Readonly<Record<string, string>>;
+}
+/** Builds a self-contained web player with local content-addressed media. */
+export declare function buildStandaloneGame(options: BuildStandaloneGameOptions): Promise<StandaloneGameBuild>;
+//# sourceMappingURL=build.d.ts.map

package/dist/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../src/build.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAK1D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;CACnF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAiGD,6EAA6E;AAC7E,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA+H3G"}