@sadhaka/loom-engine 0.13.0 → 0.15.0

package/dist/audio/audio-asset-cache.d.ts

@@ -0,0 +1,12 @@
+export declare class AudioAssetCache {
+    private buffers;
+    get(name: string): AudioBuffer | null;
+    has(name: string): boolean;
+    set(name: string, buffer: AudioBuffer): void;
+    drop(name: string): void;
+    clear(): void;
+    list(): ReadonlyArray<string>;
+}
+export declare const RESOURCE_AUDIO_ASSET_CACHE = "audio_asset_cache";
+export declare function createAudioAssetCache(): AudioAssetCache;
+//# sourceMappingURL=audio-asset-cache.d.ts.map

package/dist/audio/audio-asset-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-asset-cache.d.ts","sourceRoot":"","sources":["../../src/audio/audio-asset-cache.ts"],"names":[],"mappings":"AAYA,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAuC;IAGtD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAMrC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAO1B,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAO5C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,aAAa,CAAC,MAAM,CAAC;CAG9B;AAKD,eAAO,MAAM,0BAA0B,sBAAsB,CAAC;AAI9D,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD"}

package/dist/audio/audio-asset-cache.js

@@ -0,0 +1,53 @@
+// AudioAssetCache - in-memory store of decoded AudioBuffers keyed by name.
+//
+// Per LOOM-AUDIO-SPEC §4.1. The cache is a thin Map<string, AudioBuffer>
+// wrapper. AudioAssetLoader writes into it; CueCatalog and MusicDirector
+// read from it. Lifetime is the AudioContext's lifetime; clear() is the
+// hard reset for tests / scene transitions.
+//
+// Naming: callers choose name on load(). Defaults to URL basename without
+// extension when omitted (the loader handles that derivation; the cache
+// just stores whatever name it's handed). Re-loading the same name
+// overwrites silently.
+export class AudioAssetCache {
+    buffers = new Map();
+    // Get a previously-loaded buffer. Returns null if not in the cache.
+    get(name) {
+        return this.buffers.get(name) ?? null;
+    }
+    // True once a buffer has been placed under name (via the loader's
+    // store path; tests can also call set directly through factory init).
+    has(name) {
+        return this.buffers.has(name);
+    }
+    // Internal entry point used by AudioAssetLoader after decode resolves.
+    // Exposed publicly so consumers can pre-seed buffers from another
+    // source (synthesized OfflineAudioContext output, for instance).
+    set(name, buffer) {
+        this.buffers.set(name, buffer);
+    }
+    // Remove a single asset. Future get() returns null. The buffer object
+    // is GC'd if no live source still references it (any AudioBufferSource
+    // already started keeps a reference until it ends).
+    drop(name) {
+        this.buffers.delete(name);
+    }
+    // Clear the whole cache. Useful for tests + scene-boundary teardown.
+    clear() {
+        this.buffers.clear();
+    }
+    // Active entry names (for debug + tests).
+    list() {
+        return Array.from(this.buffers.keys());
+    }
+}
+// Resource key for the world's resource registry. Engine consumers
+// register an AudioAssetCache instance under this key alongside
+// RESOURCE_AUDIO_BUS so cues + music can resolve named assets.
+export const RESOURCE_AUDIO_ASSET_CACHE = 'audio_asset_cache';
+// Factory mirrors createTimeResource / createVeilBudgetResource so
+// engine.create wiring is uniform.
+export function createAudioAssetCache() {
+    return new AudioAssetCache();
+}
+//# sourceMappingURL=audio-asset-cache.js.map

package/dist/audio/audio-asset-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-asset-cache.js","sourceRoot":"","sources":["../../src/audio/audio-asset-cache.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,wEAAwE;AACxE,4CAA4C;AAC5C,EAAE;AACF,0EAA0E;AAC1E,wEAAwE;AACxE,mEAAmE;AACnE,uBAAuB;AAEvB,MAAM,OAAO,eAAe;IAClB,OAAO,GAA6B,IAAI,GAAG,EAAE,CAAC;IAEtD,oEAAoE;IACpE,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IACxC,CAAC;IAED,kEAAkE;IAClE,sEAAsE;IACtE,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAED,uEAAuE;IACvE,kEAAkE;IAClE,iEAAiE;IACjE,GAAG,CAAC,IAAY,EAAE,MAAmB;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,sEAAsE;IACtE,uEAAuE;IACvE,oDAAoD;IACpD,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,qEAAqE;IACrE,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,0CAA0C;IAC1C,IAAI;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;CACF;AAED,mEAAmE;AACnE,gEAAgE;AAChE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAE9D,mEAAmE;AACnE,mCAAmC;AACnC,MAAM,UAAU,qBAAqB;IACnC,OAAO,IAAI,eAAe,EAAE,CAAC;AAC/B,CAAC"}

package/dist/audio/audio-asset-loader.d.ts

@@ -0,0 +1,16 @@
+import type { AudioBus } from './audio-bus.js';
+import type { AudioAssetCache } from './audio-asset-cache.js';
+export interface AudioAssetManifest {
+    [name: string]: string;
+}
+export declare class AudioAssetLoader {
+    private audioBus;
+    private cache;
+    private inflight;
+    private constructor();
+    static create(audioBus: AudioBus, cache: AudioAssetCache): AudioAssetLoader;
+    load(url: string, name?: string): Promise<AudioBuffer>;
+    preload(manifest: AudioAssetManifest): Promise<void>;
+    inflightCount(): number;
+}
+//# sourceMappingURL=audio-asset-loader.d.ts.map

package/dist/audio/audio-asset-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-asset-loader.d.ts","sourceRoot":"","sources":["../../src/audio/audio-asset-loader.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,WAAW,kBAAkB;IAEjC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAyBD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAa;IAE7B,OAAO;IAKP,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,GAAG,gBAAgB;IAQrE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA6BtD,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1D,aAAa,IAAI,MAAM;CAGxB"}

package/dist/audio/audio-asset-loader.js

@@ -0,0 +1,100 @@
+// AudioAssetLoader - URL fetch + decode pipeline for audio assets.
+//
+// Per LOOM-AUDIO-SPEC §4.1. Two responsibilities:
+//   1. fetch a URL via the Fetch API, decode the response into an
+//      AudioBuffer through audioBus.ctx.decodeAudioData, and store it
+//      in the AudioAssetCache under a caller-chosen name (or the URL
+//      basename without extension if name omitted).
+//   2. preload a manifest of {name -> URL} entries, resolving once all
+//      load. Reject on the first load failure (consumer can wrap in
+//      Promise.allSettled if they want partial success).
+//
+// Failure semantics: if fetch or decode rejects, the cache is NOT
+// touched - prior values under the same name survive a failed reload.
+// Inflight counter increments on fetch start and decrements after the
+// decode resolves OR rejects (regardless of cache write outcome) so a
+// "still loading" UI can drive off it without sticking on errors.
+// Derive a fallback asset name from a URL. Strips the query string and
+// fragment, keeps the last path segment, then drops a trailing
+// extension (.mp3, .ogg, .wav, .aac, .opus, etc.). Returns the URL as-is
+// if no segments or no recognizable extension boundary - the cache will
+// still accept any string as a key.
+function basenameFromUrl(url) {
+    // Strip query + hash.
+    var clean = url.split('?')[0].split('#')[0];
+    // Take the last path segment.
+    var segments = clean.split('/');
+    var last = segments[segments.length - 1] ?? clean;
+    if (last.length === 0) {
+        // Trailing slash; fall back to the whole stripped URL.
+        return clean;
+    }
+    // Drop trailing extension (last dot, if any).
+    var dot = last.lastIndexOf('.');
+    if (dot > 0) {
+        return last.substring(0, dot);
+    }
+    return last;
+}
+export class AudioAssetLoader {
+    audioBus;
+    cache;
+    inflight = 0;
+    constructor(audioBus, cache) {
+        this.audioBus = audioBus;
+        this.cache = cache;
+    }
+    static create(audioBus, cache) {
+        return new AudioAssetLoader(audioBus, cache);
+    }
+    // Fetch + decode one URL. On success, stores the decoded AudioBuffer
+    // in the cache under `name` (or basename of URL when name is omitted)
+    // and returns the buffer. On failure (fetch reject, non-OK status, or
+    // decode reject), the promise rejects and the cache is left untouched.
+    async load(url, name) {
+        var assetName = name !== undefined ? name : basenameFromUrl(url);
+        this.inflight++;
+        try {
+            var response = await fetch(url);
+            if (!response.ok) {
+                throw new Error('AudioAssetLoader.load: fetch failed for "' + url + '": HTTP ' +
+                    String(response.status));
+            }
+            var arrayBuf = await response.arrayBuffer();
+            // decodeAudioData returns a Promise in modern browsers (deprecated
+            // callback signature still works but Promise is canonical).
+            var buffer = await this.audioBus.ctx.decodeAudioData(arrayBuf);
+            this.cache.set(assetName, buffer);
+            return buffer;
+        }
+        finally {
+            // Always decrement, even on failure - the inflight counter tracks
+            // pending operations, not successful outcomes.
+            this.inflight--;
+        }
+    }
+    // Bulk preload. Resolves when ALL loads complete; rejects with the
+    // first underlying error if any single load rejects. Manifest entries
+    // run concurrently (Promise.all). Successfully-loaded entries land in
+    // the cache regardless of whether siblings later failed - this matches
+    // the "partial success allowed downstream" semantics of fetch+decode.
+    async preload(manifest) {
+        var entries = Object.keys(manifest);
+        if (entries.length === 0)
+            return;
+        var loads = [];
+        for (var i = 0; i < entries.length; i++) {
+            var n = entries[i];
+            var u = manifest[n];
+            loads.push(this.load(u, n));
+        }
+        await Promise.all(loads);
+    }
+    // Number of load() calls in flight. Useful for "X assets still
+    // loading" UI; not a throttle. Increments on fetch start, decrements
+    // when the inner pipeline resolves or rejects.
+    inflightCount() {
+        return this.inflight;
+    }
+}
+//# sourceMappingURL=audio-asset-loader.js.map

package/dist/audio/audio-asset-loader.js.map

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

package/dist/audio/audio-listener-resource.d.ts

@@ -0,0 +1,19 @@
+import type { AudioListenerPose } from './spatial-audio-bus.js';
+export type { AudioListenerPose } from './spatial-audio-bus.js';
+export interface AudioListenerResource {
+    pose: AudioListenerPose;
+    lastUpdateFrame: number;
+}
+export declare const DEFAULT_LISTENER_FORWARD: {
+    x: number;
+    y: number;
+    z: number;
+};
+export declare const DEFAULT_LISTENER_UP: {
+    x: number;
+    y: number;
+    z: number;
+};
+export declare function createAudioListenerResource(): AudioListenerResource;
+export declare const RESOURCE_AUDIO_LISTENER = "audio_listener";
+//# sourceMappingURL=audio-listener-resource.d.ts.map

package/dist/audio/audio-listener-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-listener-resource.d.ts","sourceRoot":"","sources":["../../src/audio/audio-listener-resource.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,YAAY,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAMhE,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,iBAAiB,CAAC;IAGxB,eAAe,EAAE,MAAM,CAAC;CACzB;AAID,eAAO,MAAM,wBAAwB,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAEvE,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAElE,CAAC;AAWF,wBAAgB,2BAA2B,IAAI,qBAAqB,CAWnE;AAKD,eAAO,MAAM,uBAAuB,mBAAmB,CAAC"}

package/dist/audio/audio-listener-resource.js

@@ -0,0 +1,57 @@
+// AudioListenerResource - the world's snapshot of where the player is
+// hearing from.
+//
+// SpatialAudioBus.setListener writes the AudioContext.listener
+// directly, but engine consumers also want a queryable resource so a
+// secondary system (minimap, debug HUD, deterministic recording) can
+// read the same pose without round-tripping through the AudioContext
+// (which is synchronous in Web Audio but opaque in Node tests).
+//
+// SpatialAudioSystem (PHASE_RENDER) updates this each tick from the
+// local character's transform and pushes the same pose into
+// SpatialAudioBus.setListener. Renderer code that needs to gate work
+// on "did the listener move this frame?" can compare lastUpdateFrame
+// against the TimeResource frame counter.
+//
+// Default orientation per LOOM-AUDIO-SPEC.md §8.4:
+//   forward = (0, 0, -1)  - camera looks down -Z (top-down 2D)
+//   up      = (0, 1, 0)
+// These are fixed in v1; only position changes per frame.
+//
+// Re-exports the AudioListenerPose type from spatial-audio-bus.ts for
+// import convenience so consumers wiring just the resource don't need
+// to pull in the bus module too.
+// Default forward / up vectors per spec §8.4. Exported for tests and
+// for consumers that want to compare against the canonical defaults.
+export const DEFAULT_LISTENER_FORWARD = {
+    x: 0, y: 0, z: -1,
+};
+export const DEFAULT_LISTENER_UP = {
+    x: 0, y: 1, z: 0,
+};
+// Factory: returns a fresh AudioListenerResource at the world origin
+// with the canonical default orientation. The resource is the same
+// shape used by SpatialAudioBus.setListener, so engine consumers can
+// pipe it straight through:
+//   var listener = createAudioListenerResource();
+//   spatialBus.setListener(listener.pose);
+//
+// lastUpdateFrame starts at 0 (never updated yet); SpatialAudioSystem
+// stamps it on the first tick.
+export function createAudioListenerResource() {
+    return {
+        pose: {
+            x: 0,
+            y: 0,
+            z: 0,
+            forward: { x: DEFAULT_LISTENER_FORWARD.x, y: DEFAULT_LISTENER_FORWARD.y, z: DEFAULT_LISTENER_FORWARD.z },
+            up: { x: DEFAULT_LISTENER_UP.x, y: DEFAULT_LISTENER_UP.y, z: DEFAULT_LISTENER_UP.z },
+        },
+        lastUpdateFrame: 0,
+    };
+}
+// Resource key for the world's resource registry. Engine consumers
+// register an AudioListenerResource under this key; SpatialAudioSystem
+// reads + writes it.
+export const RESOURCE_AUDIO_LISTENER = 'audio_listener';
+//# sourceMappingURL=audio-listener-resource.js.map

package/dist/audio/audio-listener-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-listener-resource.js","sourceRoot":"","sources":["../../src/audio/audio-listener-resource.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,gBAAgB;AAChB,EAAE;AACF,+DAA+D;AAC/D,qEAAqE;AACrE,qEAAqE;AACrE,qEAAqE;AACrE,gEAAgE;AAChE,EAAE;AACF,oEAAoE;AACpE,4DAA4D;AAC5D,qEAAqE;AACrE,qEAAqE;AACrE,0CAA0C;AAC1C,EAAE;AACF,mDAAmD;AACnD,+DAA+D;AAC/D,wBAAwB;AACxB,0DAA0D;AAC1D,EAAE;AACF,sEAAsE;AACtE,sEAAsE;AACtE,iCAAiC;AAiBjC,qEAAqE;AACrE,qEAAqE;AACrE,MAAM,CAAC,MAAM,wBAAwB,GAAwC;IAC3E,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CAClB,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAwC;IACtE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;CACjB,CAAC;AAEF,qEAAqE;AACrE,mEAAmE;AACnE,qEAAqE;AACrE,4BAA4B;AAC5B,kDAAkD;AAClD,2CAA2C;AAC3C,EAAE;AACF,sEAAsE;AACtE,+BAA+B;AAC/B,MAAM,UAAU,2BAA2B;IACzC,OAAO;QACL,IAAI,EAAE;YACJ,CAAC,EAAE,CAAC;YACJ,CAAC,EAAE,CAAC;YACJ,CAAC,EAAE,CAAC;YACJ,OAAO,EAAE,EAAE,CAAC,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,EAAE,wBAAwB,CAAC,CAAC,EAAE,CAAC,EAAE,wBAAwB,CAAC,CAAC,EAAE;YACxG,EAAE,EAAE,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,EAAE;SACrF;QACD,eAAe,EAAE,CAAC;KACnB,CAAC;AACJ,CAAC;AAED,mEAAmE;AACnE,uEAAuE;AACvE,qBAAqB;AACrB,MAAM,CAAC,MAAM,uBAAuB,GAAG,gBAAgB,CAAC"}

package/dist/audio/cue-catalog.d.ts

@@ -0,0 +1,39 @@
+import type { AudioBus } from './audio-bus.js';
+import type { AudioAssetCache } from './audio-asset-cache.js';
+import type { PositionalPlayOptions, SpatialAudioBus, SpatialSourceHandle } from './spatial-audio-bus.js';
+export type { PositionalPlayOptions, SpatialAudioBus, SpatialSourceHandle, };
+export interface CueDefinition {
+    asset: string;
+    bus?: 'sfx' | 'music' | 'voice' | 'ui' | string;
+    spatial?: boolean;
+    defaults?: Partial<PositionalPlayOptions> & {
+        gain?: number;
+        rate?: number;
+    };
+    cooldownMs?: number;
+}
+export type CuePlayOptions = Partial<PositionalPlayOptions> & {
+    gain?: number;
+    rate?: number;
+    x?: number;
+    y?: number;
+};
+export declare class CueCatalog {
+    private audioBus;
+    private spatialBus;
+    private cache;
+    private cues;
+    private cooldowns;
+    private liveHandles;
+    private constructor();
+    static create(audioBus: AudioBus, spatialBus: SpatialAudioBus, cache: AudioAssetCache): CueCatalog;
+    register(name: string, def: CueDefinition): void;
+    unregister(name: string): void;
+    has(name: string): boolean;
+    list(): ReadonlyArray<string>;
+    play(name: string, options?: CuePlayOptions): SpatialSourceHandle | null;
+    stopAll(name: string): void;
+    private markPlayed;
+}
+export declare const RESOURCE_CUE_CATALOG = "cue_catalog";
+//# sourceMappingURL=cue-catalog.d.ts.map

package/dist/audio/cue-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cue-catalog.d.ts","sourceRoot":"","sources":["../../src/audio/cue-catalog.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAMhC,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,mBAAmB,GACpB,CAAC;AAEF,MAAM,WAAW,aAAa;IAE5B,KAAK,EAAE,MAAM,CAAC;IAEd,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC;IAIhD,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,QAAQ,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE7E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GACxB,OAAO,CAAC,qBAAqB,CAAC,GAC5B;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAiB7D,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,IAAI,CAAyC;IACrD,OAAO,CAAC,SAAS,CAAyC;IAG1D,OAAO,CAAC,WAAW,CAAoD;IAEvE,OAAO;IAMP,MAAM,CAAC,MAAM,CACX,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,eAAe,EAC3B,KAAK,EAAE,eAAe,GACrB,UAAU;IAIb,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI;IAOhD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,IAAI,IAAI,aAAa,CAAC,MAAM,CAAC;IAQ7B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,mBAAmB,GAAG,IAAI;IA2FxE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAc3B,OAAO,CAAC,UAAU;CAGnB;AAKD,eAAO,MAAM,oBAAoB,gBAAgB,CAAC"}

package/dist/audio/cue-catalog.js

@@ -0,0 +1,186 @@
+// CueCatalog - named sound events with predefined wiring.
+//
+// Per LOOM-AUDIO-SPEC §4.2. Gameplay code calls cues.play('boss_spawn',
+// {x, y}) and the catalog handles AudioBus / SpatialAudioBus routing,
+// asset lookup, gain/rate defaults, and per-cue cooldowns. Spatial cues
+// route through SpatialAudioBus.playPositional and require x + y in
+// the play options; non-spatial cues route through AudioBus.playOneShot
+// on the named bus (default 'sfx').
+//
+// Cooldown enforcement: each cue tracks its last-play timestamp; play()
+// invocations within cooldownMs of the prior play return null without
+// touching the audio graph. Useful for "boss_hit" so rapid-fire hits
+// don't stack into clipping.
+//
+// stopAll(name): for spatial cues that loop (boss combat ambience), the
+// catalog tracks live SpatialSourceHandles per cue name and exposes
+// stopAll to kill them on a single command (e.g. "boss died, stop the
+// loop"). Non-spatial one-shots are not tracked - they end on their own.
+// Time source. Real implementation uses performance.now(); tests can
+// inject a deterministic clock by overriding this through the public
+// constructor seam later. v1 uses the global clock for simplicity.
+function nowMs() {
+    if (typeof performance !== 'undefined' && typeof performance.now === 'function') {
+        return performance.now();
+    }
+    return Date.now();
+}
+export class CueCatalog {
+    audioBus;
+    spatialBus;
+    cache;
+    cues = new Map();
+    cooldowns = new Map();
+    // Live spatial source handles per cue name. Cleared on stopAll(name).
+    // Non-spatial one-shots are NOT tracked - they end naturally.
+    liveHandles = new Map();
+    constructor(audioBus, spatialBus, cache) {
+        this.audioBus = audioBus;
+        this.spatialBus = spatialBus;
+        this.cache = cache;
+    }
+    static create(audioBus, spatialBus, cache) {
+        return new CueCatalog(audioBus, spatialBus, cache);
+    }
+    register(name, def) {
+        this.cues.set(name, def);
+        // Re-registering resets cooldown state so a fresh definition starts
+        // from a clean slate (avoids stale lastPlay timestamps on overwrite).
+        this.cooldowns.set(name, { lastPlayMs: -Infinity });
+    }
+    unregister(name) {
+        this.cues.delete(name);
+        this.cooldowns.delete(name);
+        // Stop any live handles for this cue so they don't outlive the
+        // definition.
+        this.stopAll(name);
+        this.liveHandles.delete(name);
+    }
+    has(name) {
+        return this.cues.has(name);
+    }
+    list() {
+        return Array.from(this.cues.keys());
+    }
+    // Play a registered cue. Spatial cues require x + y in options.
+    // Returns a handle for spatial cues; null for non-spatial cues, for
+    // unknown cues, for cues whose asset is not in the cache, or when
+    // cooldown is active.
+    play(name, options) {
+        var def = this.cues.get(name);
+        if (!def)
+            return null;
+        // Cooldown gate. Suppress play and leave lastPlay untouched if too
+        // soon after the prior successful play.
+        if (def.cooldownMs !== undefined && def.cooldownMs > 0) {
+            var entry = this.cooldowns.get(name) ?? { lastPlayMs: -Infinity };
+            var t = nowMs();
+            if (t - entry.lastPlayMs < def.cooldownMs) {
+                return null;
+            }
+        }
+        // Asset must be in cache.
+        var buffer = this.cache.get(def.asset);
+        if (!buffer)
+            return null;
+        // Merge defaults under the explicit options. The intent is "options
+        // override defaults"; we copy each key path explicitly for the
+        // strict-mode-friendly subset the spec uses.
+        var merged = {};
+        if (def.defaults) {
+            for (var k in def.defaults) {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                merged[k] = def.defaults[k];
+            }
+        }
+        if (options) {
+            for (var k2 in options) {
+                var v = options[k2];
+                if (v !== undefined) {
+                    merged[k2] = v;
+                }
+            }
+        }
+        var spatial = def.spatial === true;
+        if (spatial) {
+            if (typeof merged.x !== 'number' || typeof merged.y !== 'number') {
+                // Spatial cue requires position. Drop silently rather than throwing -
+                // matches "Returns null for ... failure" contract.
+                return null;
+            }
+            // Build a complete PositionalPlayOptions. We carry all merged
+            // fields into the spatial bus call.
+            var posOpts = {
+                x: merged.x,
+                y: merged.y,
+            };
+            if (typeof merged.z === 'number')
+                posOpts.z = merged.z;
+            if (merged.distanceModel !== undefined)
+                posOpts.distanceModel = merged.distanceModel;
+            if (typeof merged.refDistance === 'number')
+                posOpts.refDistance = merged.refDistance;
+            if (typeof merged.maxDistance === 'number')
+                posOpts.maxDistance = merged.maxDistance;
+            if (typeof merged.rolloffFactor === 'number')
+                posOpts.rolloffFactor = merged.rolloffFactor;
+            if (typeof merged.gain === 'number')
+                posOpts.gain = merged.gain;
+            if (typeof merged.rate === 'number')
+                posOpts.rate = merged.rate;
+            if (typeof merged.loop === 'boolean')
+                posOpts.loop = merged.loop;
+            var handle = this.spatialBus.playPositional(buffer, posOpts);
+            if (!handle)
+                return null;
+            // Track for stopAll. We DO NOT auto-cleanup non-loop one-shots
+            // here - the SpatialAudioBus is the source of truth on lifetime.
+            // stopAll is the primary cleanup path; if a cue is a one-shot the
+            // tracked handle just becomes a no-op stop later.
+            var setForName = this.liveHandles.get(name);
+            if (!setForName) {
+                setForName = new Set();
+                this.liveHandles.set(name, setForName);
+            }
+            setForName.add(handle);
+            this.markPlayed(name);
+            return handle;
+        }
+        // Non-spatial: route through AudioBus.playOneShot on the named bus.
+        var busName = def.bus ?? 'sfx';
+        var oneShotOpts = {};
+        if (typeof merged.rate === 'number')
+            oneShotOpts.rate = merged.rate;
+        if (typeof merged.gain === 'number')
+            oneShotOpts.gain = merged.gain;
+        this.audioBus.playOneShot(busName, buffer, oneShotOpts);
+        this.markPlayed(name);
+        return null;
+    }
+    // Stop all live spatial sources for this cue. Non-spatial one-shots
+    // are not tracked; this is a no-op for cues that have never produced
+    // a spatial handle.
+    stopAll(name) {
+        var setForName = this.liveHandles.get(name);
+        if (!setForName)
+            return;
+        setForName.forEach(function (h) {
+            try {
+                h.stop();
+            }
+            catch {
+                // Best-effort cleanup; never let a misbehaving handle take down
+                // sibling cues.
+            }
+        });
+        setForName.clear();
+    }
+    markPlayed(name) {
+        this.cooldowns.set(name, { lastPlayMs: nowMs() });
+    }
+}
+// Resource key for the world's resource registry. Engine consumers
+// register a CueCatalog instance under this key alongside the audio
+// bus + spatial bus + cache.
+export const RESOURCE_CUE_CATALOG = 'cue_catalog';
+//# sourceMappingURL=cue-catalog.js.map

package/dist/audio/cue-catalog.js.map

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

package/dist/audio/music-director.d.ts

@@ -0,0 +1,18 @@
+import type { AudioBus } from './audio-bus.js';
+import type { AudioAssetCache } from './audio-asset-cache.js';
+export declare class MusicDirector {
+    private audioBus;
+    private cache;
+    private current;
+    private constructor();
+    static create(audioBus: AudioBus, cache: AudioAssetCache): MusicDirector;
+    playMusic(name: string, fadeInMs?: number): void;
+    stopMusic(fadeOutMs?: number): Promise<void>;
+    crossfadeMusic(name: string, fadeMs?: number): void;
+    currentMusic(): string | null;
+    private startTrack;
+    private fadeOutAndStop;
+    private hardStop;
+}
+export declare const RESOURCE_MUSIC_DIRECTOR = "music_director";
+//# sourceMappingURL=music-director.d.ts.map

package/dist/audio/music-director.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"music-director.d.ts","sourceRoot":"","sources":["../../src/audio/music-director.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAY9D,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,OAAO,CAA4B;IAE3C,OAAO;IAKP,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,GAAG,aAAa;IAOxE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBhD,SAAS,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa5C,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBnD,YAAY,IAAI,MAAM,GAAG,IAAI;IAM7B,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,cAAc;IAoCtB,OAAO,CAAC,QAAQ;CAmBjB;AAKD,eAAO,MAAM,uBAAuB,mBAAmB,CAAC"}