@nodetool-ai/game-renderer 0.8.1 → 0.8.3

package/README.md

@@ -0,0 +1,46 @@
+# Native game rendering and export
+
+Legacy games keep their WebGPU and Canvas 2D renderers. Import the 3D browser
+renderer from `@nodetool-ai/game-renderer/browser3d`, capture from `node3d`, and
+static export from `build3d`. The package's default entry does not import Three.js
+or Rapier. A 3D player requires WebGL2 and reports capability failures explicitly.
+
+Model import normalizes owned GLB or glTF input and its declared dependencies
+into self-contained GLB bytes. Preparation rejects remote runtime dependencies,
+unsupported required extensions, malformed geometry and over-budget resources.
+Bindings record a digest, stable node and clip selectors, bounds and import
+settings. Use meters, Y up and forward `-Z` after preparation. Primitive or convex
+colliders belong to gameplay definitions. A model hierarchy cannot add scripts
+or physics components.
+
+Each instance owns its skeleton and animation mixer. Cosmetic clip sampling
+uses the committed tick, which permits pause, rewind, restore and capture without
+wall-clock drift. Geometry and textures share immutable caches. Renderer disposal
+releases model instances, GPU resources and outstanding loads. Context loss
+pauses the host before rebuilding rendering resources.
+
+Captures run the same Three.js renderer in Chromium with a closed set of staged
+bytes, cancellation and bounded time. Reports include the committed state hash,
+capabilities, render statistics and projected entity bounds. Capture needs a
+Playwright runtime and installed Chromium. Desktop packaging stages Playwright
+and the capture bundle. The server profile intentionally omits browser automation
+and reports unavailable capture capability.
+
+Static export validates every asset digest and stages files atomically before
+returning the output directory. It includes the game document, pinned runtime
+code, QuickJS WASM, models, colliders, audio and fonts. Serve it over static HTTP
+for browser module and WASM loading. Use HTTPS or loopback HTTP because asset
+verification requires Web Crypto. The export needs no provider credentials.
+
+Run `npm run test --workspace=packages/game-renderer` for model preparation,
+skinning, animation sampling, shadows, lifecycle, capture and offline replay.
+Hardware frame-rate targets in the [3D design](../../docs/plans/native-game-3d-upgrade.md)
+remain separate from software-rendered correctness fixtures.
+
+Run `npm run verify:electron3d --workspace=packages/game-renderer` after building
+packages to render the registered capture bundle in the installed Electron
+binary. It writes a PNG and backend/load statistics under
+`nodetool-game3d-electron` in the operating system's temporary directory. The
+Chromium lifecycle test writes `game3d-renderer-spike.json` in that directory's
+parent. Both commands honor `TMPDIR` and report the tested resolution and GPU.
+Their software-rendered timings do not establish the hardware target.

package/dist/.nodetool-build-stamp

@@ -1 +1 @@
-2026-09-28T09:19:04.696Z
+2026-10-12T12:30:00.497Z

package/dist/audio/mixer.d.ts

@@ -0,0 +1,75 @@
+import { type GameAudioMixerInput, type GameEvent, type GameEvent3D } from "@nodetool-ai/protocol";
+/** The values a bus is moving to: the base settings with the active mixer snapshot applied. */
+export interface GameAudioBusState {
+    readonly parent: string | null;
+    readonly volume: number;
+    readonly muted: boolean;
+    readonly lowpassHz: number | null;
+    readonly reverbSend: number;
+    readonly userVolume: number;
+    readonly userMuted: boolean;
+    readonly duckGain: number;
+    readonly activeVoices: number;
+}
+export interface GameAudioMixerState {
+    readonly snapshot: string;
+    readonly buses: Readonly<Record<string, GameAudioBusState>>;
+}
+/**
+ * The game's bus graph: voices feed a bus input, buses feed their parent, and master feeds the limiter.
+ * Mixer state is presentation only. It reads simulation events and never writes back to a session.
+ */
+export declare class GameAudioMixer {
+    private readonly context;
+    private readonly tickRate;
+    private settings;
+    private readonly buses;
+    private readonly activeVoices;
+    private readonly limiter;
+    private readonly makeup;
+    private readonly makeupParam;
+    private reverb;
+    private snapshotId;
+    private sceneId;
+    private readonly destination;
+    private readonly clock;
+    /**
+     * `options.clock` returns the context time at which mixer changes are scheduled. It defaults to the context's current time.
+     * Offline renders pass a clock to schedule changes at chosen render times.
+     */
+    constructor(context: BaseAudioContext, settings: GameAudioMixerInput | undefined, tickRate: number, options?: {
+        readonly destination?: AudioNode;
+        readonly clock?: () => number;
+    });
+    /** Replaces the mixer settings. Values jump to the new mix; the active snapshot stays when it still exists. */
+    update(settings: GameAudioMixerInput | undefined): void;
+    /** The node a voice on `busId` connects to. Unknown buses play on sfx. */
+    input(busId: string): AudioNode;
+    /** The bus for a voice of an asset slot: the author's assignment, else music for scene music and sfx for everything else. */
+    busFor(assetSlot: string, music: boolean): string;
+    voiceStarted(busId: string): void;
+    voiceEnded(busId: string): void;
+    /** Reads a simulation event and moves to the snapshot its transition rule names. */
+    observe(event: GameEvent | GameEvent3D): void;
+    /** Applies the scene's transition rule when the scene changes. */
+    enterScene(sceneId: string): void;
+    /** Returns to the base mix, or the scene's snapshot, without fading. Used when a session restarts or restores. */
+    reset(sceneId: string): void;
+    /** Moves to a mixer snapshot over `fadeTicks`. */
+    transition(snapshotId: string, fadeTicks: number): void;
+    /** Player-facing volume, for example from a settings screen. Multiplies the authored fader. */
+    setUserVolume(busId: string, volume: number): void;
+    setUserMuted(busId: string, muted: boolean): void;
+    state(): GameAudioMixerState;
+    dispose(): void;
+    private bus;
+    private openLowpass;
+    private values;
+    private needsReverb;
+    /** Builds missing buses, wires parents, and moves every parameter to the current mix over `seconds`. */
+    private apply;
+    private applyBus;
+    private voicesOnBranch;
+    private applyDucking;
+}
+//# sourceMappingURL=mixer.d.ts.map

package/dist/audio/mixer.d.ts.map

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

package/dist/audio/mixer.js

@@ -0,0 +1,345 @@
+import { GAME_AUDIO_BASE_SNAPSHOT, GAME_AUDIO_BUILTIN_BUSES, gameAudioMixer } from "@nodetool-ai/protocol";
+const OPEN_LOWPASS_HZ = 20000;
+const LIMITER_RATIO = 20;
+const BUTTERWORTH_Q_DB = 20 * Math.log10(Math.SQRT1_2);
+/** An AudioParam whose scheduled ramp is tracked so a new ramp can start from the exact current value. */
+class TrackedParam {
+    param;
+    from;
+    to;
+    start = 0;
+    end = 0;
+    curve = "linear";
+    constructor(param, value, now) {
+        this.param = param;
+        this.from = value;
+        this.to = value;
+        param.setValueAtTime(value, now);
+    }
+    get target() { return this.to; }
+    valueAt(time) {
+        if (time >= this.end || this.end <= this.start) {
+            return this.to;
+        }
+        if (time <= this.start) {
+            return this.from;
+        }
+        const progress = (time - this.start) / (this.end - this.start);
+        return this.curve === "exponential" ? this.from * (this.to / this.from) ** progress : this.from + (this.to - this.from) * progress;
+    }
+    rampTo(value, now, seconds, curve = "linear") {
+        if (value === this.to && now >= this.end) {
+            return;
+        }
+        const current = this.valueAt(now);
+        this.param.cancelScheduledValues(now);
+        this.param.setValueAtTime(current, now);
+        if (seconds > 0 && current !== value) {
+            if (curve === "exponential") {
+                this.param.exponentialRampToValueAtTime(value, now + seconds);
+            }
+            else {
+                this.param.linearRampToValueAtTime(value, now + seconds);
+            }
+        }
+        else {
+            this.param.setValueAtTime(value, now);
+        }
+        this.from = current;
+        this.to = value;
+        this.start = now;
+        this.end = seconds > 0 ? now + seconds : now;
+        this.curve = curve;
+    }
+}
+/** Deterministic noise so every player builds the same impulse response. */
+function impulseResponse(context, decaySeconds) {
+    const length = Math.max(1, Math.round(decaySeconds * context.sampleRate));
+    const buffer = context.createBuffer(2, length, context.sampleRate);
+    let seed = 0x9e3779b9;
+    for (let channel = 0; channel < buffer.numberOfChannels; channel++) {
+        const data = buffer.getChannelData(channel);
+        for (let index = 0; index < length; index++) {
+            seed = (seed + 0x6d2b79f5) >>> 0;
+            let mixed = Math.imul(seed ^ (seed >>> 15), seed | 1);
+            mixed ^= mixed + Math.imul(mixed ^ (mixed >>> 7), mixed | 61);
+            const noise = (((mixed ^ (mixed >>> 14)) >>> 0) / 0xffffffff) * 2 - 1;
+            data[index] = noise * Math.exp(-6.9 * index / length);
+        }
+    }
+    return buffer;
+}
+/**
+ * The game's bus graph: voices feed a bus input, buses feed their parent, and master feeds the limiter.
+ * Mixer state is presentation only. It reads simulation events and never writes back to a session.
+ */
+export class GameAudioMixer {
+    context;
+    tickRate;
+    settings;
+    buses = new Map();
+    activeVoices = new Map();
+    limiter;
+    makeup;
+    makeupParam;
+    reverb = null;
+    snapshotId = GAME_AUDIO_BASE_SNAPSHOT;
+    sceneId = null;
+    destination;
+    clock;
+    /**
+     * `options.clock` returns the context time at which mixer changes are scheduled. It defaults to the context's current time.
+     * Offline renders pass a clock to schedule changes at chosen render times.
+     */
+    constructor(context, settings, tickRate, options = {}) {
+        this.context = context;
+        this.tickRate = tickRate;
+        this.destination = options.destination ?? context.destination;
+        this.clock = options.clock ?? (() => context.currentTime);
+        this.settings = gameAudioMixer.parse(settings ?? {});
+        const now = this.clock();
+        this.limiter = context.createDynamicsCompressor();
+        this.limiter.knee.value = 0;
+        this.limiter.ratio.value = LIMITER_RATIO;
+        this.limiter.attack.value = 0.003;
+        this.limiter.release.value = 0.1;
+        this.makeup = context.createGain();
+        this.makeupParam = new TrackedParam(this.makeup.gain, 1, now);
+        this.limiter.connect(this.makeup).connect(this.destination);
+        this.apply(0, true);
+    }
+    /** Replaces the mixer settings. Values jump to the new mix; the active snapshot stays when it still exists. */
+    update(settings) {
+        this.settings = gameAudioMixer.parse(settings ?? {});
+        if (this.snapshotId !== GAME_AUDIO_BASE_SNAPSHOT && !(this.snapshotId in this.settings.snapshots)) {
+            this.snapshotId = GAME_AUDIO_BASE_SNAPSHOT;
+        }
+        this.apply(0, true);
+    }
+    /** The node a voice on `busId` connects to. Unknown buses play on sfx. */
+    input(busId) {
+        return (this.buses.get(busId) ?? this.bus("sfx")).input;
+    }
+    /** The bus for a voice of an asset slot: the author's assignment, else music for scene music and sfx for everything else. */
+    busFor(assetSlot, music) {
+        const assigned = this.settings.assetBuses[assetSlot];
+        if (assigned !== undefined && this.buses.has(assigned)) {
+            return assigned;
+        }
+        return music ? "music" : "sfx";
+    }
+    voiceStarted(busId) {
+        const id = this.buses.has(busId) ? busId : "sfx";
+        this.activeVoices.set(id, (this.activeVoices.get(id) ?? 0) + 1);
+        this.applyDucking();
+    }
+    voiceEnded(busId) {
+        const id = this.buses.has(busId) ? busId : "sfx";
+        const count = (this.activeVoices.get(id) ?? 0) - 1;
+        if (count > 0) {
+            this.activeVoices.set(id, count);
+        }
+        else {
+            this.activeVoices.delete(id);
+        }
+        this.applyDucking();
+    }
+    /** Reads a simulation event and moves to the snapshot its transition rule names. */
+    observe(event) {
+        for (const transition of this.settings.transitions) {
+            const on = transition.on;
+            if ((on.kind === "trigger" && event.kind === "trigger" && event.event === on.event) ||
+                (on.kind === "win" && event.kind === "win")) {
+                this.transition(transition.snapshot, transition.fadeTicks);
+            }
+        }
+    }
+    /** Applies the scene's transition rule when the scene changes. */
+    enterScene(sceneId) {
+        if (this.sceneId === sceneId) {
+            return;
+        }
+        this.sceneId = sceneId;
+        const rule = this.settings.transitions.find((transition) => transition.on.kind === "scene" && transition.on.sceneId === sceneId);
+        if (rule) {
+            this.transition(rule.snapshot, rule.fadeTicks);
+        }
+    }
+    /** Returns to the base mix, or the scene's snapshot, without fading. Used when a session restarts or restores. */
+    reset(sceneId) {
+        const rule = this.settings.transitions.find((transition) => transition.on.kind === "scene" && transition.on.sceneId === sceneId);
+        this.sceneId = sceneId;
+        this.snapshotId = rule?.snapshot ?? GAME_AUDIO_BASE_SNAPSHOT;
+        this.apply(0, false);
+    }
+    /** Moves to a mixer snapshot over `fadeTicks`. */
+    transition(snapshotId, fadeTicks) {
+        if (snapshotId !== GAME_AUDIO_BASE_SNAPSHOT && !(snapshotId in this.settings.snapshots)) {
+            return;
+        }
+        if (snapshotId === this.snapshotId) {
+            return;
+        }
+        this.snapshotId = snapshotId;
+        this.apply(fadeTicks / this.tickRate, false);
+    }
+    /** Player-facing volume, for example from a settings screen. Multiplies the authored fader. */
+    setUserVolume(busId, volume) {
+        const bus = this.buses.get(busId);
+        if (!bus || !Number.isFinite(volume)) {
+            return;
+        }
+        bus.userVolume = Math.min(2, Math.max(0, volume));
+        this.applyBus(bus, 0);
+    }
+    setUserMuted(busId, muted) {
+        const bus = this.buses.get(busId);
+        if (!bus) {
+            return;
+        }
+        bus.userMuted = muted;
+        this.applyBus(bus, 0);
+    }
+    state() {
+        const buses = {};
+        for (const bus of this.buses.values()) {
+            const values = this.values(bus.id);
+            buses[bus.id] = { parent: bus.parent, volume: values.volume, muted: values.muted, lowpassHz: values.lowpassHz ?? null,
+                reverbSend: values.reverbSend, userVolume: bus.userVolume, userMuted: bus.userMuted, duckGain: bus.duckParam.target,
+                activeVoices: this.activeVoices.get(bus.id) ?? 0 };
+        }
+        return { snapshot: this.snapshotId, buses };
+    }
+    dispose() {
+        for (const bus of this.buses.values()) {
+            for (const node of [bus.input, bus.filter, bus.fader, bus.duck, bus.send]) {
+                node.disconnect();
+            }
+        }
+        this.buses.clear();
+        this.reverb?.convolver.disconnect();
+        this.reverb?.output.disconnect();
+        this.limiter.disconnect();
+        this.makeup.disconnect();
+    }
+    bus(id) {
+        const existing = this.buses.get(id);
+        if (existing) {
+            return existing;
+        }
+        const now = this.clock();
+        const input = this.context.createGain();
+        const filter = this.context.createBiquadFilter();
+        const fader = this.context.createGain();
+        const duck = this.context.createGain();
+        const send = this.context.createGain();
+        filter.type = "lowpass";
+        filter.Q.setValueAtTime(BUTTERWORTH_Q_DB, now);
+        input.connect(filter).connect(fader).connect(duck);
+        const bus = { id, input, filter, fader, duck, send, parent: null, userVolume: 1, userMuted: false,
+            faderParam: new TrackedParam(fader.gain, 1, now), filterParam: new TrackedParam(filter.frequency, this.openLowpass(), now),
+            duckParam: new TrackedParam(duck.gain, 1, now), sendParam: new TrackedParam(send.gain, 0, now) };
+        this.buses.set(id, bus);
+        return bus;
+    }
+    openLowpass() { return Math.min(OPEN_LOWPASS_HZ, this.context.sampleRate / 2); }
+    values(id) {
+        const base = this.settings.buses[id] ?? { volume: 1, muted: false, reverbSend: 0 };
+        const override = this.snapshotId === GAME_AUDIO_BASE_SNAPSHOT ? undefined : this.settings.snapshots[this.snapshotId]?.buses[id];
+        return { volume: override?.volume ?? base.volume, muted: override?.muted ?? base.muted,
+            lowpassHz: override?.lowpassHz ?? base.lowpassHz, reverbSend: override?.reverbSend ?? base.reverbSend };
+    }
+    needsReverb() {
+        return Object.values(this.settings.buses).some((bus) => bus.reverbSend > 0) ||
+            Object.values(this.settings.snapshots).some((snapshot) => Object.values(snapshot.buses).some((bus) => (bus.reverbSend ?? 0) > 0));
+    }
+    /** Builds missing buses, wires parents, and moves every parameter to the current mix over `seconds`. */
+    apply(seconds, rewire) {
+        const ids = [...GAME_AUDIO_BUILTIN_BUSES, ...Object.keys(this.settings.buses)];
+        for (const id of ids) {
+            this.bus(id);
+        }
+        if (rewire) {
+            const decaySeconds = this.settings.reverb.decaySeconds;
+            if (this.needsReverb() && (!this.reverb || this.reverb.decaySeconds !== decaySeconds)) {
+                this.reverb?.convolver.disconnect();
+                this.reverb?.output.disconnect();
+                const convolver = this.context.createConvolver();
+                convolver.buffer = impulseResponse(this.context, decaySeconds);
+                const output = this.context.createGain();
+                convolver.connect(output).connect(this.bus("master").input);
+                this.reverb = { convolver, output, decaySeconds };
+            }
+            for (const bus of this.buses.values()) {
+                const parent = bus.id === "master" ? null : this.settings.buses[bus.id]?.parent ?? "master";
+                bus.duck.disconnect();
+                bus.send.disconnect();
+                if (parent === null) {
+                    bus.duck.connect(this.settings.limiter.enabled ? this.limiter : this.destination);
+                }
+                else {
+                    bus.duck.connect(this.bus(parent).input);
+                    bus.duck.connect(bus.send);
+                    if (this.reverb) {
+                        bus.send.connect(this.reverb.convolver);
+                    }
+                }
+                bus.parent = parent;
+            }
+            const now = this.clock();
+            const thresholdDb = this.settings.limiter.thresholdDb;
+            this.limiter.threshold.value = thresholdDb;
+            // Web Audio adds automatic makeup gain of 0.6 times the full-range gain reduction. Undo it so the limiter is transparent below threshold.
+            this.makeupParam.rampTo(10 ** (0.6 * thresholdDb * (1 - 1 / LIMITER_RATIO) / 20), now, 0);
+        }
+        for (const bus of this.buses.values()) {
+            this.applyBus(bus, seconds);
+        }
+        this.applyDucking();
+    }
+    applyBus(bus, seconds) {
+        const now = this.clock();
+        const values = this.values(bus.id);
+        const silent = values.muted || bus.userMuted;
+        bus.faderParam.rampTo(silent ? 0 : values.volume * bus.userVolume, now, seconds);
+        bus.filterParam.rampTo(Math.min(values.lowpassHz ?? OPEN_LOWPASS_HZ, this.openLowpass()), now, seconds, "exponential");
+        bus.sendParam.rampTo(bus.parent === null ? 0 : values.reverbSend, now, seconds);
+    }
+    voicesOnBranch(id) {
+        let count = 0;
+        for (const [busId, voices] of this.activeVoices) {
+            let current = busId;
+            while (current !== null) {
+                if (current === id) {
+                    count += voices;
+                    break;
+                }
+                current = this.buses.get(current)?.parent ?? null;
+            }
+        }
+        return count;
+    }
+    applyDucking() {
+        const now = this.clock();
+        const targets = new Map();
+        for (const rule of this.settings.ducking) {
+            if (!this.buses.has(rule.bus)) {
+                continue;
+            }
+            const active = this.voicesOnBranch(rule.when) > 0;
+            const current = targets.get(rule.bus) ?? { gain: 1, attackTicks: rule.attackTicks, releaseTicks: rule.releaseTicks };
+            targets.set(rule.bus, active && rule.gain < current.gain ? { ...current, gain: rule.gain, attackTicks: rule.attackTicks } : current);
+        }
+        for (const bus of this.buses.values()) {
+            const target = targets.get(bus.id);
+            const gain = target?.gain ?? 1;
+            const previous = bus.duckParam.target;
+            if (gain === previous) {
+                continue;
+            }
+            const ticks = gain < previous ? target?.attackTicks ?? 0 : target?.releaseTicks ?? 0;
+            bus.duckParam.rampTo(gain, now, ticks / this.tickRate);
+        }
+    }
+}
+//# sourceMappingURL=mixer.js.map

package/dist/audio/mixer.js.map

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

package/dist/audio/player.d.ts

@@ -0,0 +1,67 @@
+import { type GameAssetBinding, type GameAssetBinding3D, type GameAudioMixerInput, type GameEvent, type GameEvent3D, type GameSnapshot } from "@nodetool-ai/protocol";
+import { type GameAudioMixerState } from "./mixer.js";
+import { type GameAudioSpatialQuality, type GameAudioSpatialView } from "./spatial.js";
+export interface GameAudioOptions {
+    readonly assets: Readonly<Record<string, GameAssetBinding | GameAssetBinding3D>>;
+    readonly tickRate: number;
+    readonly resolveAsset: (binding: GameAssetBinding | GameAssetBinding3D) => Promise<string | null>;
+    readonly status: (message: string) => void;
+    readonly context?: AudioContext;
+    /** The document's `audio.mixer`. Omitted means the default bus graph. */
+    readonly mixer?: GameAudioMixerInput;
+    /** Panning quality for spatial voices. Default `high` (HRTF). */
+    readonly spatialQuality?: GameAudioSpatialQuality;
+}
+/** Shares Web Audio voice, decoding, and lifecycle behavior across browser players. */
+export declare class GameAudioPlayer {
+    private options;
+    private readonly context;
+    private readonly mixer;
+    private readonly buffers;
+    private readonly voices;
+    private readonly fading;
+    private readonly pending;
+    private readonly voiceAssets;
+    private readonly spatialVoices;
+    private view;
+    private listenerSample;
+    private listenerVelocity;
+    private desiredMusic;
+    private sceneId;
+    private tick;
+    private generation;
+    private legacySequence;
+    private disposed;
+    private paused;
+    constructor(options: GameAudioOptions);
+    private mixerSettings;
+    /** Applies edited mixer settings. Playing voices keep playing on their buses. */
+    updateMixer(settings: GameAudioMixerInput | undefined): void;
+    /** Player-facing bus volume, for example from a settings screen. */
+    setBusVolume(busId: string, volume: number): void;
+    setBusMuted(busId: string, muted: boolean): void;
+    mixerState(): GameAudioMixerState;
+    private buffer;
+    /** Keeps decoded audio for unchanged bindings when the editor document changes. */
+    updateAssets(assets: GameAudioOptions["assets"]): void;
+    preload(): void;
+    unlock(): Promise<void>;
+    pause(): void;
+    resume(): void;
+    sync(snapshot: Pick<GameSnapshot, "tick" | "music" | "sceneId">): void;
+    private startDesiredMusic;
+    /**
+     * Moves the listener and every spatial voice to a rendered frame. Players call it once per rendered frame with the view
+     * built from the interpolated frame, so positions follow what is on screen. Emitters missing from the view keep their last position.
+     */
+    updateSpatial(view: GameAudioSpatialView): void;
+    /** Creates the panner for a voice and connects it to the bus. The voice connects to the returned node. */
+    private spatialOutput;
+    /** Plays audio events and lets other simulation events drive mixer snapshot transitions. */
+    handle(event: GameEvent | GameEvent3D): void;
+    private start;
+    private stop;
+    reset(snapshot: Pick<GameSnapshot, "tick" | "music" | "sceneId">): void;
+    dispose(): void;
+}
+//# sourceMappingURL=player.d.ts.map

package/dist/audio/player.d.ts.map

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