@codexo/exojs 0.6.12 → 0.7.11

package/dist/esm/audio/AudioBus.d.ts

@@ -0,0 +1,45 @@
+import type { AudioFilter } from './AudioFilter';
+export interface AudioBusOptions {
+    parent?: AudioBus | null;
+    volume?: number;
+    muted?: boolean;
+    pan?: number;
+    filters?: ReadonlyArray<AudioFilter>;
+}
+export declare class AudioBus {
+    readonly name: string;
+    private _parent;
+    private _volume;
+    private _muted;
+    private _pan;
+    private readonly _filters;
+    private _setup;
+    private _scheduledStopId;
+    constructor(name: string, options?: AudioBusOptions);
+    get parent(): AudioBus | null;
+    get volume(): number;
+    set volume(value: number);
+    get muted(): boolean;
+    set muted(value: boolean);
+    get pan(): number;
+    set pan(value: number);
+    get inputNode(): GainNode | null;
+    addFilter(filter: AudioFilter): this;
+    removeFilter(filter: AudioFilter): this;
+    fadeIn(durationMs: number): this;
+    fadeOut(durationMs: number, options?: {
+        stopAfter?: boolean;
+    }): this;
+    destroy(): void;
+    /** Internal: returns the input GainNode where children should connect. */
+    _getInputNode(): GainNode | null;
+    /** Internal: returns the output GainNode that connects upstream. */
+    _getOutputNode(): GainNode | null;
+    private _setupAudio;
+    private _connectUpstream;
+    /** Subscribe to the moment this bus's audio nodes are ready. Internal use. */
+    onceSetup(callback: () => void): void;
+    private _rebuildFilterChain;
+    private _applyVolume;
+    private _clearScheduledStop;
+}

package/dist/esm/audio/AudioBus.js

@@ -0,0 +1,219 @@
+import { clamp } from '../math/utils.js';
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from './audio-context.js';
+
+class AudioBus {
+    name;
+    _parent;
+    _volume;
+    _muted;
+    _pan;
+    _filters = [];
+    _setup = null;
+    _scheduledStopId = null;
+    constructor(name, options = {}) {
+        if (!name || typeof name !== 'string') {
+            throw new Error('AudioBus requires a non-empty string name.');
+        }
+        this.name = name;
+        this._parent = options.parent ?? null;
+        this._volume = clamp(options.volume ?? 1, 0, 2);
+        this._muted = options.muted ?? false;
+        this._pan = clamp(options.pan ?? 0, -1, 1);
+        if (options.filters) {
+            this._filters.push(...options.filters);
+        }
+        if (isAudioContextReady()) {
+            this._setupAudio(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setupAudio, this);
+        }
+    }
+    get parent() {
+        return this._parent;
+    }
+    get volume() {
+        return this._volume;
+    }
+    set volume(value) {
+        const clamped = clamp(value, 0, 2);
+        if (this._volume === clamped)
+            return;
+        this._volume = clamped;
+        this._applyVolume();
+    }
+    get muted() {
+        return this._muted;
+    }
+    set muted(value) {
+        if (this._muted === value)
+            return;
+        this._muted = value;
+        this._applyVolume();
+    }
+    get pan() {
+        return this._pan;
+    }
+    set pan(value) {
+        const clamped = clamp(value, -1, 1);
+        if (this._pan === clamped)
+            return;
+        this._pan = clamped;
+        if (this._setup) {
+            this._setup.panNode.pan.setTargetAtTime(clamped, this._setup.audioContext.currentTime, 0.01);
+        }
+    }
+    get inputNode() {
+        return this._setup?.inputNode ?? null;
+    }
+    addFilter(filter) {
+        this._filters.push(filter);
+        this._rebuildFilterChain();
+        return this;
+    }
+    removeFilter(filter) {
+        const index = this._filters.indexOf(filter);
+        if (index !== -1) {
+            this._filters.splice(index, 1);
+            this._rebuildFilterChain();
+        }
+        return this;
+    }
+    fadeIn(durationMs) {
+        this._clearScheduledStop();
+        if (durationMs <= 0 || !this._setup) {
+            return this;
+        }
+        const ctx = this._setup.audioContext;
+        const node = this._setup.outputNode;
+        const target = this._muted ? 0 : this._volume;
+        node.gain.cancelScheduledValues(ctx.currentTime);
+        node.gain.setValueAtTime(0, ctx.currentTime);
+        node.gain.linearRampToValueAtTime(target, ctx.currentTime + durationMs / 1000);
+        return this;
+    }
+    fadeOut(durationMs, options = {}) {
+        const stopAfter = options.stopAfter ?? true;
+        this._clearScheduledStop();
+        if (durationMs <= 0 || !this._setup) {
+            if (stopAfter)
+                this.muted = true;
+            return this;
+        }
+        const ctx = this._setup.audioContext;
+        const node = this._setup.outputNode;
+        node.gain.cancelScheduledValues(ctx.currentTime);
+        node.gain.setValueAtTime(node.gain.value, ctx.currentTime);
+        node.gain.linearRampToValueAtTime(0, ctx.currentTime + durationMs / 1000);
+        if (stopAfter) {
+            this._scheduledStopId = setTimeout(() => {
+                this._scheduledStopId = null;
+                this.muted = true;
+            }, durationMs);
+        }
+        return this;
+    }
+    destroy() {
+        onAudioContextReady.clearByContext(this);
+        this._clearScheduledStop();
+        for (const filter of this._filters) {
+            filter.destroy();
+        }
+        this._filters.length = 0;
+        if (this._setup) {
+            this._setup.inputNode.disconnect();
+            this._setup.outputNode.disconnect();
+            this._setup.panNode.disconnect();
+            this._setup = null;
+        }
+    }
+    /** Internal: returns the input GainNode where children should connect. */
+    _getInputNode() {
+        return this._setup?.inputNode ?? null;
+    }
+    /** Internal: returns the output GainNode that connects upstream. */
+    _getOutputNode() {
+        return this._setup?.outputNode ?? null;
+    }
+    _setupAudio(audioContext) {
+        const inputNode = audioContext.createGain();
+        const panNode = audioContext.createStereoPanner();
+        const outputNode = audioContext.createGain();
+        // Internal chain: input → [filters...] → pan → output
+        outputNode.gain.setTargetAtTime(this._muted ? 0 : this._volume, audioContext.currentTime, 0.01);
+        panNode.pan.setTargetAtTime(this._pan, audioContext.currentTime, 0.01);
+        this._setup = { audioContext, inputNode, outputNode, panNode };
+        this._rebuildFilterChain();
+        this._connectUpstream();
+    }
+    _connectUpstream() {
+        if (!this._setup)
+            return;
+        if (this._parent) {
+            const parentInput = this._parent._getInputNode();
+            if (parentInput) {
+                this._setup.outputNode.connect(parentInput);
+            }
+            else {
+                // Parent not yet ready — subscribe to parent's setup
+                this._parent.onceSetup(() => {
+                    if (this._setup && this._parent) {
+                        const node = this._parent._getInputNode();
+                        if (node)
+                            this._setup.outputNode.connect(node);
+                    }
+                });
+            }
+        }
+        else {
+            this._setup.outputNode.connect(this._setup.audioContext.destination);
+        }
+    }
+    /** Subscribe to the moment this bus's audio nodes are ready. Internal use. */
+    onceSetup(callback) {
+        if (this._setup) {
+            callback();
+        }
+        else {
+            onAudioContextReady.once(() => {
+                if (this._setup)
+                    callback();
+            }, this);
+        }
+    }
+    _rebuildFilterChain() {
+        if (!this._setup)
+            return;
+        const { inputNode, panNode } = this._setup;
+        // Disconnect current chain
+        inputNode.disconnect();
+        for (const filter of this._filters) {
+            filter.inputNode.disconnect();
+            filter.outputNode.disconnect();
+        }
+        panNode.disconnect();
+        // Rebuild: input → filter[0].input → filter[0].output → filter[1].input → ... → pan → output
+        let prev = inputNode;
+        for (const filter of this._filters) {
+            prev.connect(filter.inputNode);
+            prev = filter.outputNode;
+        }
+        prev.connect(panNode);
+        panNode.connect(this._setup.outputNode);
+    }
+    _applyVolume() {
+        if (!this._setup)
+            return;
+        const target = this._muted ? 0 : this._volume;
+        this._setup.outputNode.gain.setTargetAtTime(target, this._setup.audioContext.currentTime, 0.01);
+    }
+    _clearScheduledStop() {
+        if (this._scheduledStopId !== null) {
+            clearTimeout(this._scheduledStopId);
+            this._scheduledStopId = null;
+        }
+    }
+}
+
+export { AudioBus };
+//# sourceMappingURL=AudioBus.js.map

package/dist/esm/audio/AudioBus.js.map

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

package/dist/esm/audio/AudioFilter.d.ts

@@ -0,0 +1,9 @@
+export declare abstract class AudioFilter {
+    /** The node where audio enters this filter. */
+    abstract get inputNode(): AudioNode;
+    /** The node where audio exits this filter. */
+    abstract get outputNode(): AudioNode;
+    /** Resolves when the filter is fully initialized. Defaults to immediately-resolved for sync filters. */
+    get ready(): Promise<void>;
+    abstract destroy(): void;
+}

package/dist/esm/audio/AudioFilter.js

@@ -0,0 +1,7 @@
+class AudioFilter {
+    /** Resolves when the filter is fully initialized. Defaults to immediately-resolved for sync filters. */
+    get ready() { return Promise.resolve(); }
+}
+
+export { AudioFilter };
+//# sourceMappingURL=AudioFilter.js.map

package/dist/esm/audio/AudioFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioFilter.js","sources":["../../../../src/audio/AudioFilter.ts"],"sourcesContent":[null],"names":[],"mappings":"MAAsB,WAAW,CAAA;;IAM7B,IAAW,KAAK,KAAoB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAEjE;;;;"}

package/dist/esm/audio/AudioListener.d.ts

@@ -0,0 +1,20 @@
+import { Vector } from '@/math/Vector';
+import type { SceneNode } from '@/core/SceneNode';
+import type { View } from '@/rendering/View';
+export type AudioListenerTarget = SceneNode | View | {
+    x: number;
+    y: number;
+} | null;
+export declare class AudioListener {
+    readonly position: Vector;
+    readonly velocity: Vector;
+    target: AudioListenerTarget;
+    private _audioListener;
+    private _ctx;
+    constructor();
+    /** Internal: called by AudioManager.update() once per frame. */
+    _tick(): void;
+    destroy(): void;
+    private _readTargetPosition;
+    private _setup;
+}

package/dist/esm/audio/AudioListener.js

@@ -0,0 +1,86 @@
+import { Vector } from '../math/Vector.js';
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from './audio-context.js';
+
+class AudioListener {
+    position = new Vector(0, 0);
+    velocity = new Vector(0, 0);
+    target = null;
+    _audioListener = null;
+    _ctx = null;
+    constructor() {
+        if (isAudioContextReady()) {
+            this._setup(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setup, this);
+        }
+    }
+    /** Internal: called by AudioManager.update() once per frame. */
+    _tick() {
+        if (this.target !== null) {
+            this._readTargetPosition();
+        }
+        if (this._audioListener !== null && this._ctx !== null) {
+            const t = this._ctx.currentTime;
+            const listener = this._audioListener;
+            if (listener.positionX) {
+                listener.positionX.setValueAtTime(this.position.x, t);
+                listener.positionY.setValueAtTime(this.position.y, t);
+                listener.positionZ.setValueAtTime(0, t);
+            }
+            else if (listener.setPosition) {
+                listener.setPosition(this.position.x, this.position.y, 0);
+            }
+        }
+    }
+    destroy() {
+        onAudioContextReady.clearByContext(this);
+        this.position.destroy();
+        this.velocity.destroy();
+        this.target = null;
+        this._audioListener = null;
+        this._ctx = null;
+    }
+    _readTargetPosition() {
+        const target = this.target;
+        if (target === null)
+            return;
+        // Check for SceneNode (has getGlobalTransform)
+        const asSceneNode = target;
+        if (typeof asSceneNode.getGlobalTransform === 'function') {
+            const m = asSceneNode.getGlobalTransform();
+            this.position.set(m.x, m.y);
+            return;
+        }
+        // Check for View (has center with x/y)
+        const asView = target;
+        if (asView.center !== undefined && typeof asView.center === 'object') {
+            this.position.set(asView.center.x, asView.center.y);
+            return;
+        }
+        // Plain { x, y } object
+        const plain = target;
+        this.position.set(plain.x, plain.y);
+    }
+    _setup(ctx) {
+        this._ctx = ctx;
+        this._audioListener = ctx.listener;
+        const t = ctx.currentTime;
+        const listener = ctx.listener;
+        // Set 2D orientation: forward = -Z (into screen), up = +Y (screen up)
+        if (listener.forwardX) {
+            listener.forwardX.setValueAtTime(0, t);
+            listener.forwardY.setValueAtTime(0, t);
+            listener.forwardZ.setValueAtTime(-1, t);
+            listener.upX.setValueAtTime(0, t);
+            listener.upY.setValueAtTime(1, t);
+            listener.upZ.setValueAtTime(0, t);
+        }
+        else if (listener.setOrientation) {
+            listener.setOrientation(0, 0, -1, 0, 1, 0);
+        }
+    }
+}
+
+export { AudioListener };
+//# sourceMappingURL=AudioListener.js.map

package/dist/esm/audio/AudioListener.js.map

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

package/dist/esm/audio/AudioManager.d.ts

@@ -0,0 +1,31 @@
+import { AudioBus } from './AudioBus';
+import { AudioListener } from './AudioListener';
+import type { Sound } from './Sound';
+export declare class AudioManager {
+    readonly master: AudioBus;
+    readonly music: AudioBus;
+    readonly sound: AudioBus;
+    readonly listener: AudioListener;
+    private readonly _registered;
+    private readonly _spatialSounds;
+    private _muteOnHidden;
+    constructor();
+    get muteOnHidden(): boolean;
+    set muteOnHidden(value: boolean);
+    /** Called once per frame from Application.update(). */
+    update(): void;
+    /** Internal: called by Sound when it becomes spatial. */
+    _registerSpatialSound(sound: Sound): void;
+    /** Internal: called by Sound when it stops being spatial. */
+    _unregisterSpatialSound(sound: Sound): void;
+    /** Internal: called by Application when visibility changes. */
+    _applyVisibility(visible: boolean): void;
+    registerBus(bus: AudioBus): this;
+    unregisterBus(bus: AudioBus): this;
+    getBus(name: string): AudioBus;
+    hasBus(name: string): boolean;
+    destroy(): void;
+}
+export declare function getAudioManager(): AudioManager;
+/** For tests: reset the singleton so fresh instances can be created. */
+export declare function _resetAudioManagerForTesting(): void;

package/dist/esm/audio/AudioManager.js

@@ -0,0 +1,102 @@
+import { AudioBus } from './AudioBus.js';
+import { AudioListener } from './AudioListener.js';
+
+class AudioManager {
+    master;
+    music;
+    sound;
+    listener;
+    _registered = new Map();
+    _spatialSounds = new Set();
+    _muteOnHidden = false;
+    constructor() {
+        this.master = new AudioBus('master', { parent: null });
+        this.music = new AudioBus('music', { parent: this.master });
+        this.sound = new AudioBus('sound', { parent: this.master });
+        this.listener = new AudioListener();
+        // Built-ins are also lookup-able via getBus.
+        this._registered.set('master', this.master);
+        this._registered.set('music', this.music);
+        this._registered.set('sound', this.sound);
+    }
+    get muteOnHidden() {
+        return this._muteOnHidden;
+    }
+    set muteOnHidden(value) {
+        this._muteOnHidden = value;
+        // Wiring to app.onVisibilityChange happens externally — the
+        // Application is responsible for calling _applyVisibility() when
+        // visibility changes.
+    }
+    /** Called once per frame from Application.update(). */
+    update() {
+        this.listener._tick();
+        for (const sound of this._spatialSounds) {
+            sound._tickSpatial();
+        }
+    }
+    /** Internal: called by Sound when it becomes spatial. */
+    _registerSpatialSound(sound) {
+        this._spatialSounds.add(sound);
+    }
+    /** Internal: called by Sound when it stops being spatial. */
+    _unregisterSpatialSound(sound) {
+        this._spatialSounds.delete(sound);
+    }
+    /** Internal: called by Application when visibility changes. */
+    _applyVisibility(visible) {
+        if (this._muteOnHidden) {
+            this.master.muted = !visible;
+        }
+    }
+    registerBus(bus) {
+        if (this._registered.has(bus.name)) {
+            throw new Error(`Audio bus "${bus.name}" is already registered.`);
+        }
+        this._registered.set(bus.name, bus);
+        return this;
+    }
+    unregisterBus(bus) {
+        if (bus === this.master || bus === this.music || bus === this.sound) {
+            throw new Error(`Cannot unregister built-in bus "${bus.name}".`);
+        }
+        const existing = this._registered.get(bus.name);
+        if (existing !== bus) {
+            // Either not registered, or different instance with same name.
+            return this;
+        }
+        this._registered.delete(bus.name);
+        bus.destroy();
+        return this;
+    }
+    getBus(name) {
+        const bus = this._registered.get(name);
+        if (!bus) {
+            throw new Error(`Audio bus "${name}" is not registered.`);
+        }
+        return bus;
+    }
+    hasBus(name) {
+        return this._registered.has(name);
+    }
+    destroy() {
+        this.listener.destroy();
+        this._spatialSounds.clear();
+        for (const bus of this._registered.values()) {
+            // Note: destroying built-ins too — AudioManager is destroyed only when app shuts down.
+            bus.destroy();
+        }
+        this._registered.clear();
+    }
+}
+// Module-level singleton (lazy)
+let _manager = null;
+function getAudioManager() {
+    if (_manager === null) {
+        _manager = new AudioManager();
+    }
+    return _manager;
+}
+
+export { AudioManager, getAudioManager };
+//# sourceMappingURL=AudioManager.js.map

package/dist/esm/audio/AudioManager.js.map

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

package/dist/esm/audio/BeatDetector.d.ts

@@ -0,0 +1,121 @@
+import { Signal } from '@/core/Signal';
+import type { AudioBus } from '@/audio/AudioBus';
+import type { Sound } from '@/audio/Sound';
+import type { Music } from '@/audio/Music';
+export type BeatDetectorSource = AudioBus | Sound | Music | MediaStream | AudioNode | null;
+export interface BeatDetectorOptions {
+    /** Minimum detectable BPM. Default 50. */
+    minBpm?: number;
+    /** Maximum detectable BPM. Default 250. */
+    maxBpm?: number;
+    /** FFT size for onset detection. Default 2048. */
+    fftSize?: number;
+    /** Hop size in samples between successive FFTs. Default 512. */
+    hopSize?: number;
+    /** Sliding window duration for tempogram (seconds). Default 6. */
+    tempoWindowSec?: number;
+    /** Initial suppression period before beats are emitted (ms). Default 1500. */
+    settlingMs?: number;
+    /** Number of mel filterbank bands. Default 24. */
+    melBands?: number;
+    /**
+     * When true (default), the worklet runs parallel 3/4 and 4/4 posteriors and
+     * switches active time signature via hysteresis. Set false to lock to 4/4.
+     */
+    enableTimeSignatureDetection?: boolean;
+}
+export interface BeatInfo {
+    /** audioContext.currentTime when the beat occurred. */
+    audioTime: number;
+    /** BPM at this beat. */
+    tempo: number;
+    /** Confidence 0..1. */
+    confidence: number;
+    /** Phase within beat (0 = start). */
+    beatPhase: number;
+    /** Novelty/onset strength at the beat. */
+    energy: number;
+    /** Is this beat the first in a bar? */
+    isDownbeat: boolean;
+    /** Beat position within the bar (1..N). */
+    beatInBar: number;
+}
+export interface UpcomingBeat {
+    audioTime: number;
+    tempo: number;
+    isDownbeat: boolean;
+    beatInBar: number;
+}
+export interface BarInfo {
+    audioTime: number;
+    tempo: number;
+    confidence: number;
+    /** Monotonically increasing bar counter since detector start. */
+    barNumber: number;
+}
+export interface TimeSignature {
+    numerator: number;
+    denominator: number;
+}
+export interface TempoCandidate {
+    bpm: number;
+    /** Peak strength 0..1. */
+    score: number;
+}
+export interface BandEnergy {
+    low: number;
+    mid: number;
+    high: number;
+}
+export declare class BeatDetector {
+    readonly onBeat: Signal<[BeatInfo]>;
+    readonly onTempoChange: Signal<[number, number]>;
+    readonly onDownbeat: Signal<[BeatInfo]>;
+    readonly onBarStart: Signal<[BarInfo]>;
+    readonly onBeatPredicted: Signal<[UpcomingBeat]>;
+    private readonly _options;
+    private _workletNode;
+    private _source;
+    private _tapSource;
+    private _streamSource;
+    private _ready;
+    private _tempo;
+    private _beatPhase;
+    private _nextBeatTime;
+    private _confidence;
+    private _gridStability;
+    private _tempoCandidates;
+    private _rms;
+    private _onsetStrength;
+    private _bandEnergy;
+    private _barPosition;
+    private _barLength;
+    private _timeSignature;
+    private _nextDownbeatTime;
+    private _lookahead;
+    constructor(options?: BeatDetectorOptions);
+    get source(): BeatDetectorSource;
+    set source(value: BeatDetectorSource);
+    get ready(): Promise<void>;
+    get tempo(): number;
+    get beatPhase(): number;
+    get nextBeatTime(): number;
+    get confidence(): number;
+    get gridStability(): number;
+    get rms(): number;
+    get onsetStrength(): number;
+    get bandEnergy(): BandEnergy;
+    get tempoCandidates(): ReadonlyArray<TempoCandidate>;
+    get barPosition(): number;
+    get barLength(): number;
+    get timeSignature(): TimeSignature;
+    get nextDownbeatTime(): number;
+    get lookahead(): ReadonlyArray<UpcomingBeat>;
+    destroy(): void;
+    private _setup;
+    private _onWorkletMessage;
+    private _connectSource;
+    private _resolveToAudioNode;
+    private _deferConnectionViaBus;
+    private _disconnectTap;
+}