@codexo/exojs 0.13.0 → 0.15.0

package/dist/esm/audio/filters/PitchShiftFilter.js

@@ -1,66 +0,0 @@
-import { pitchShiftWorkletSource } from '../worklets/pitch-shift.worklet.js';
-import { WorkletFilter } from './WorkletFilter.js';
-
-/**
- * Real-time pitch shifter via granular synthesis (WorkletFilter).
- *
- * Quality: good for ±1 octave (pitch 0.5x-2.0x). Beyond that, audible
- * artifacts (graininess, phase issues). For high-quality pitch shift,
- * a phase-vocoder approach is required and not available in V1.
- *
- * Latency: ~half-grain-size = ~10ms at default 1024-sample grains
- * (at 48kHz sample rate). Not suitable for live monitoring; fine for
- * games / playback.
- *
- * Use cases:
- *   - Sound variation: random ±200 cent pitch on each footstep / bullet
- *   - Voice effects: chipmunk (1.5x) or demon (0.7x) for game NPCs
- *   - Detune layering: stack 0.99x and 1.01x for thick chorused sound
- */
-class PitchShiftFilter extends WorkletFilter {
-    _pitch;
-    _wet;
-    _grainSize;
-    constructor(options = {}) {
-        super();
-        this._pitch = Math.max(0.25, Math.min(4, options.pitch ?? 1));
-        this._wet = Math.max(0, Math.min(1, options.wet ?? 1));
-        this._grainSize = options.grainSize ?? 1024;
-    }
-    get _workletName() {
-        return 'exojs-pitch-shift';
-    }
-    get _workletSource() {
-        return pitchShiftWorkletSource;
-    }
-    get _workletOptions() {
-        return {
-            numberOfInputs: 1,
-            numberOfOutputs: 1,
-            processorOptions: { grainSize: this._grainSize },
-        };
-    }
-    _onWorkletReady() {
-        this._setAudioParam('pitch', this._pitch);
-        this._setAudioParam('wet', this._wet);
-    }
-    /** Pitch ratio relative to the original. 1.0 = no change, 0.5 = one octave down, 2.0 = one octave up. Range 0.25..4.0, default 1.0. */
-    get pitch() {
-        return this._pitch;
-    }
-    set pitch(value) {
-        this._pitch = Math.max(0.25, Math.min(4, value));
-        this._setAudioParam('pitch', this._pitch);
-    }
-    /** Wet (pitch-shifted) mix level, 0..1. Default 1.0 (full wet). */
-    get wet() {
-        return this._wet;
-    }
-    set wet(value) {
-        this._wet = Math.max(0, Math.min(1, value));
-        this._setAudioParam('wet', this._wet);
-    }
-}
-
-export { PitchShiftFilter };
-//# sourceMappingURL=PitchShiftFilter.js.map

package/dist/esm/audio/filters/PitchShiftFilter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"PitchShiftFilter.js","sources":["../../../../../src/audio/filters/PitchShiftFilter.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAgBA;;;;;;;;;;;;;;;AAeG;AACG,MAAO,gBAAiB,SAAQ,aAAa,CAAA;AACzC,IAAA,MAAM;AACN,IAAA,IAAI;AACK,IAAA,UAAU;AAE3B,IAAA,WAAA,CAAmB,UAAmC,EAAE,EAAA;AACtD,QAAA,KAAK,EAAE;QACP,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI;IAC7C;AAEA,IAAA,IAAc,YAAY,GAAA;AACxB,QAAA,OAAO,mBAAmB;IAC5B;AAEA,IAAA,IAAc,cAAc,GAAA;AAC1B,QAAA,OAAO,uBAAuB;IAChC;AAEA,IAAA,IAAuB,eAAe,GAAA;QACpC,OAAO;AACL,YAAA,cAAc,EAAE,CAAC;AACjB,YAAA,eAAe,EAAE,CAAC;AAClB,YAAA,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE;SACjD;IACH;IAEmB,eAAe,GAAA;QAChC,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;QACzC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;IACvC;;AAGA,IAAA,IAAW,KAAK,GAAA;QACd,OAAO,IAAI,CAAC,MAAM;IACpB;IACA,IAAW,KAAK,CAAC,KAAa,EAAA;AAC5B,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAChD,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;IAC3C;;AAGA,IAAA,IAAW,GAAG,GAAA;QACZ,OAAO,IAAI,CAAC,IAAI;IAClB;IACA,IAAW,GAAG,CAAC,KAAa,EAAA;AAC1B,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;IACvC;AACD;;;;"}

package/dist/esm/audio/filters/ReverbFilter.d.ts

@@ -1,38 +0,0 @@
-import { AudioFilter } from '#audio/AudioFilter';
-/** Construction options for {@link ReverbFilter}. */
-export interface ReverbFilterOptions {
-    durationSeconds?: number;
-    decay?: number;
-    wet?: number;
-}
-/**
- * Convolution reverb using a procedurally-generated impulse response loaded
- * into a `ConvolverNode`. The impulse response is a stereo noise burst whose
- * amplitude decays exponentially, simulating room reflections. Adjusting
- * `durationSeconds` or `decay` rebuilds the impulse response immediately, so
- * avoid animating these properties at audio rate — use `wet` for real-time
- * mix control instead.
- */
-export declare class ReverbFilter extends AudioFilter {
-    private _setup;
-    private _duration;
-    private readonly _onAudioContextReady;
-    private _decay;
-    private _wet;
-    constructor(options?: ReverbFilterOptions);
-    get inputNode(): AudioNode;
-    get outputNode(): AudioNode;
-    /** Length of the generated impulse response in seconds. Range 0.1..5, default 2. Changing this rebuilds the IR buffer. */
-    get durationSeconds(): number;
-    set durationSeconds(value: number);
-    /** Exponential decay rate of the impulse response. Higher values produce a tighter, drier reverb tail. Range 0.5..10, default 2. Changing this rebuilds the IR buffer. */
-    get decay(): number;
-    set decay(value: number);
-    /** Wet (reverberated) mix level, 0..1. The dry level is automatically `1 - wet`. Default 0.4. */
-    get wet(): number;
-    set wet(value: number);
-    destroy(): void;
-    private _generateImpulseResponse;
-    private _setupNodes;
-}
-//# sourceMappingURL=ReverbFilter.d.ts.map

package/dist/esm/audio/filters/ReverbFilter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ReverbFilter.d.ts","sourceRoot":"","sources":["../../../../src/audio/filters/ReverbFilter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAUD;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAGnC;IACF,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAS;gBAEF,OAAO,GAAE,mBAAwB;IAYpD,IAAW,SAAS,IAAI,SAAS,CAGhC;IAED,IAAW,UAAU,IAAI,SAAS,CAGjC;IAED,0HAA0H;IAC1H,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED,IAAW,eAAe,CAAC,KAAK,EAAE,MAAM,EAKvC;IAED,0KAA0K;IAC1K,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAK7B;IAED,iGAAiG;IACjG,IAAW,GAAG,IAAI,MAAM,CAEvB;IAED,IAAW,GAAG,CAAC,KAAK,EAAE,MAAM,EAO3B;IAEe,OAAO,IAAI,IAAI;IAY/B,OAAO,CAAC,wBAAwB;IAchC,OAAO,CAAC,WAAW;CAyBpB"}

package/dist/esm/audio/filters/ReverbFilter.js

@@ -1,122 +0,0 @@
-import { onAudioContextReady, isAudioContextReady, getAudioContext } from '../audio-context.js';
-import { AudioFilter } from '../AudioFilter.js';
-
-/**
- * Convolution reverb using a procedurally-generated impulse response loaded
- * into a `ConvolverNode`. The impulse response is a stereo noise burst whose
- * amplitude decays exponentially, simulating room reflections. Adjusting
- * `durationSeconds` or `decay` rebuilds the impulse response immediately, so
- * avoid animating these properties at audio rate — use `wet` for real-time
- * mix control instead.
- */
-class ReverbFilter extends AudioFilter {
-    _setup = null;
-    _duration;
-    _onAudioContextReady = (ctx) => {
-        onAudioContextReady.remove(this._onAudioContextReady);
-        this._setupNodes(ctx);
-    };
-    _decay;
-    _wet;
-    constructor(options = {}) {
-        super();
-        this._duration = Math.max(0.1, Math.min(5, options.durationSeconds ?? 2));
-        this._decay = Math.max(0.5, Math.min(10, options.decay ?? 2));
-        this._wet = Math.max(0, Math.min(1, options.wet ?? 0.4));
-        if (isAudioContextReady()) {
-            this._setupNodes(getAudioContext());
-        }
-        else {
-            onAudioContextReady.add(this._onAudioContextReady);
-        }
-    }
-    get inputNode() {
-        if (!this._setup)
-            throw new Error('ReverbFilter not yet initialized.');
-        return this._setup.inputGain;
-    }
-    get outputNode() {
-        if (!this._setup)
-            throw new Error('ReverbFilter not yet initialized.');
-        return this._setup.outputGain;
-    }
-    /** Length of the generated impulse response in seconds. Range 0.1..5, default 2. Changing this rebuilds the IR buffer. */
-    get durationSeconds() {
-        return this._duration;
-    }
-    set durationSeconds(value) {
-        this._duration = Math.max(0.1, Math.min(5, value));
-        if (this._setup) {
-            this._setup.convolver.buffer = this._generateImpulseResponse(this._setup.convolver.context);
-        }
-    }
-    /** Exponential decay rate of the impulse response. Higher values produce a tighter, drier reverb tail. Range 0.5..10, default 2. Changing this rebuilds the IR buffer. */
-    get decay() {
-        return this._decay;
-    }
-    set decay(value) {
-        this._decay = Math.max(0.5, Math.min(10, value));
-        if (this._setup) {
-            this._setup.convolver.buffer = this._generateImpulseResponse(this._setup.convolver.context);
-        }
-    }
-    /** Wet (reverberated) mix level, 0..1. The dry level is automatically `1 - wet`. Default 0.4. */
-    get wet() {
-        return this._wet;
-    }
-    set wet(value) {
-        this._wet = Math.max(0, Math.min(1, value));
-        if (this._setup) {
-            const ctx = this._setup.wetGain.context;
-            this._setup.wetGain.gain.setTargetAtTime(this._wet, ctx.currentTime, 0.01);
-            this._setup.dryGain.gain.setTargetAtTime(1 - this._wet, ctx.currentTime, 0.01);
-        }
-    }
-    destroy() {
-        onAudioContextReady.remove(this._onAudioContextReady);
-        if (this._setup) {
-            this._setup.inputGain.disconnect();
-            this._setup.convolver.disconnect();
-            this._setup.dryGain.disconnect();
-            this._setup.wetGain.disconnect();
-            this._setup.outputGain.disconnect();
-            this._setup = null;
-        }
-    }
-    _generateImpulseResponse(ctx) {
-        const length = Math.floor(ctx.sampleRate * this._duration);
-        const buffer = ctx.createBuffer(2, length, ctx.sampleRate);
-        for (let channel = 0; channel < 2; channel++) {
-            const data = buffer.getChannelData(channel);
-            for (let i = 0; i < length; i++) {
-                const t = i / length;
-                const decayFactor = Math.pow(1 - t, this._decay);
-                data[i] = (Math.random() * 2 - 1) * decayFactor;
-            }
-        }
-        return buffer;
-    }
-    _setupNodes(ctx) {
-        const inputGain = ctx.createGain();
-        const outputGain = ctx.createGain();
-        const convolver = ctx.createConvolver();
-        const dryGain = ctx.createGain();
-        const wetGain = ctx.createGain();
-        inputGain.gain.setValueAtTime(1, ctx.currentTime);
-        outputGain.gain.setValueAtTime(1, ctx.currentTime);
-        dryGain.gain.setValueAtTime(1 - this._wet, ctx.currentTime);
-        wetGain.gain.setValueAtTime(this._wet, ctx.currentTime);
-        convolver.buffer = this._generateImpulseResponse(ctx);
-        // Dry path: input → dryGain → output
-        inputGain.connect(dryGain);
-        dryGain.connect(outputGain);
-        // Wet path: input → convolver → wetGain → output
-        inputGain.connect(convolver);
-        convolver.connect(wetGain);
-        wetGain.connect(outputGain);
-        this._setup = { inputGain, outputGain, convolver, dryGain, wetGain };
-    }
-}
-
-export { ReverbFilter };
-//# sourceMappingURL=ReverbFilter.js.map

package/dist/esm/audio/filters/ReverbFilter.js.map

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

package/dist/esm/audio/filters/VocoderFilter.d.ts

@@ -1,50 +0,0 @@
-import type { AudioBus } from '#audio/AudioBus';
-import { WorkletFilter } from './WorkletFilter';
-export interface VocoderFilterOptions {
-    /** Modulator AudioBus — its output drives the spectral envelope.
-     *  Typically routed from a microphone or voice sample. */
-    modulator: AudioBus;
-    /** Number of frequency bands. More bands = better resolution, more CPU. Default 16. */
-    numBands?: number;
-    /** Lowest band center frequency in Hz. Default 80. */
-    minHz?: number;
-    /** Highest band center frequency in Hz. Default 8000. */
-    maxHz?: number;
-    /** Bandpass Q factor. Higher = narrower bands. Default 4. */
-    bandQ?: number;
-    /** Dry/wet mix, 0..1. Default 1.0. */
-    wet?: number;
-    /** Envelope follower smoothing factor (one-pole coefficient).
-     *  Smaller = smoother / slower. Default 0.005. */
-    envelopeSmoothing?: number;
-}
-/**
- * Phase-vocoder-style effect implemented as a {@link WorkletFilter}. Analyzes
- * the spectral envelope of a `modulator` {@link AudioBus} across a bank of
- * log-spaced bandpass filters and applies that envelope to the carrier signal
- * (the main input). The result is the classic "robot voice" or talking-synth
- * effect. Band count, frequency range, and Q are compile-time parameters set
- * at construction; only `wet` and `envelopeSmoothing` are adjustable at
- * runtime.
- */
-export declare class VocoderFilter extends WorkletFilter {
-    private readonly _modulator;
-    private readonly _numBands;
-    private readonly _minHz;
-    private readonly _maxHz;
-    private readonly _bandQ;
-    private _wet;
-    private _envelopeSmoothing;
-    constructor(options: VocoderFilterOptions);
-    protected get _workletName(): string;
-    protected get _workletSource(): string;
-    protected get _workletOptions(): AudioWorkletNodeOptions;
-    protected _onWorkletReady(_audioContext: AudioContext): void;
-    /** Wet (vocoded) mix level, 0..1. Default 1.0. */
-    get wet(): number;
-    set wet(value: number);
-    /** One-pole envelope follower coefficient. Smaller values produce slower, smoother envelope tracking. Range 0.0001..0.1, default 0.005. */
-    get envelopeSmoothing(): number;
-    set envelopeSmoothing(value: number);
-}
-//# sourceMappingURL=VocoderFilter.d.ts.map

package/dist/esm/audio/filters/VocoderFilter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"VocoderFilter.d.ts","sourceRoot":"","sources":["../../../../src/audio/filters/VocoderFilter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,WAAW,oBAAoB;IACnC;8DAC0D;IAC1D,SAAS,EAAE,QAAQ,CAAC;IACpB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;sDACkD;IAClD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,aAAa;IAG9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,kBAAkB,CAAS;gBAEhB,OAAO,EAAE,oBAAoB;IAchD,SAAS,KAAK,YAAY,IAAI,MAAM,CAEnC;IACD,SAAS,KAAK,cAAc,IAAI,MAAM,CAErC;IACD,cAAuB,eAAe,IAAI,uBAAuB,CAWhE;cAEkB,eAAe,CAAC,aAAa,EAAE,YAAY,GAAG,IAAI;IAsBrE,kDAAkD;IAClD,IAAW,GAAG,IAAI,MAAM,CAEvB;IACD,IAAW,GAAG,CAAC,KAAK,EAAE,MAAM,EAG3B;IAED,2IAA2I;IAC3I,IAAW,iBAAiB,IAAI,MAAM,CAErC;IACD,IAAW,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAGzC;CACF"}

package/dist/esm/audio/filters/VocoderFilter.js

@@ -1,94 +0,0 @@
-import { vocoderWorkletSource } from '../worklets/vocoder.worklet.js';
-import { WorkletFilter } from './WorkletFilter.js';
-
-/**
- * Phase-vocoder-style effect implemented as a {@link WorkletFilter}. Analyzes
- * the spectral envelope of a `modulator` {@link AudioBus} across a bank of
- * log-spaced bandpass filters and applies that envelope to the carrier signal
- * (the main input). The result is the classic "robot voice" or talking-synth
- * effect. Band count, frequency range, and Q are compile-time parameters set
- * at construction; only `wet` and `envelopeSmoothing` are adjustable at
- * runtime.
- */
-class VocoderFilter extends WorkletFilter {
-    // Declared nullable because super() may trigger _onWorkletReady before the
-    // subclass constructor body runs (if construction is aborted by a throw).
-    _modulator = null;
-    _numBands;
-    _minHz;
-    _maxHz;
-    _bandQ;
-    _wet;
-    _envelopeSmoothing;
-    constructor(options) {
-        super();
-        if (!options.modulator) {
-            throw new Error('VocoderFilter requires a modulator AudioBus.');
-        }
-        this._modulator = options.modulator;
-        this._numBands = options.numBands ?? 16;
-        this._minHz = options.minHz ?? 80;
-        this._maxHz = options.maxHz ?? 8000;
-        this._bandQ = options.bandQ ?? 4;
-        this._wet = Math.max(0, Math.min(1, options.wet ?? 1));
-        this._envelopeSmoothing = Math.max(0.0001, Math.min(0.1, options.envelopeSmoothing ?? 0.005));
-    }
-    get _workletName() {
-        return 'exojs-vocoder';
-    }
-    get _workletSource() {
-        return vocoderWorkletSource;
-    }
-    get _workletOptions() {
-        return {
-            numberOfInputs: 2,
-            numberOfOutputs: 1,
-            processorOptions: {
-                numBands: this._numBands,
-                minHz: this._minHz,
-                maxHz: this._maxHz,
-                bandQ: this._bandQ,
-            },
-        };
-    }
-    _onWorkletReady(_audioContext) {
-        // Guard against partially-constructed instances (constructor threw after super()).
-        if (!this._modulator)
-            return;
-        this._setAudioParam('wet', this._wet);
-        this._setAudioParam('envelopeSmoothing', this._envelopeSmoothing);
-        // Wire modulator bus output to input 1 of the worklet
-        const modulator = this._modulator;
-        const modOutput = modulator._getOutputNode();
-        if (modOutput && this._workletNode) {
-            modOutput.connect(this._workletNode, 0, 1);
-        }
-        else {
-            modulator.onceSetup(() => {
-                const node = modulator._getOutputNode();
-                if (node && this._workletNode) {
-                    node.connect(this._workletNode, 0, 1);
-                }
-            });
-        }
-    }
-    /** Wet (vocoded) mix level, 0..1. Default 1.0. */
-    get wet() {
-        return this._wet;
-    }
-    set wet(value) {
-        this._wet = Math.max(0, Math.min(1, value));
-        this._setAudioParam('wet', this._wet);
-    }
-    /** One-pole envelope follower coefficient. Smaller values produce slower, smoother envelope tracking. Range 0.0001..0.1, default 0.005. */
-    get envelopeSmoothing() {
-        return this._envelopeSmoothing;
-    }
-    set envelopeSmoothing(value) {
-        this._envelopeSmoothing = Math.max(0.0001, Math.min(0.1, value));
-        this._setAudioParam('envelopeSmoothing', this._envelopeSmoothing);
-    }
-}
-
-export { VocoderFilter };
-//# sourceMappingURL=VocoderFilter.js.map

package/dist/esm/audio/filters/VocoderFilter.js.map

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

package/dist/esm/audio/filters/WorkletFilter.d.ts

@@ -1,54 +0,0 @@
-import { AudioFilter } from '#audio/AudioFilter';
-/**
- * Base class for filters implemented as AudioWorkletProcessors. Subclasses
- * declare the worklet's name, source code, and node options; this class
- * handles the async lifecycle.
- *
- * Stable input/output nodes (GainNodes) are created immediately on setup.
- * While the worklet loads asynchronously, audio passes through directly
- * (effectively bypassing the filter for ~10-50ms during initial load).
- * Once the worklet loads, it's inserted into the chain and audio routes
- * through it.
- *
- * Subclasses can override `_onWorkletReady` to perform additional wiring
- * (e.g., sidechain inputs).
- * @advanced
- */
-export declare abstract class WorkletFilter extends AudioFilter {
-    protected _inputGain: GainNode | null;
-    protected _outputGain: GainNode | null;
-    protected _workletNode: AudioWorkletNode | null;
-    protected _ready: Promise<void> | null;
-    private readonly _onAudioContextReady;
-    /** The processor name registered via `registerProcessor()` in the worklet source. */
-    protected abstract get _workletName(): string;
-    /** The full worklet source code as a JavaScript string. */
-    protected abstract get _workletSource(): string;
-    /** AudioWorkletNode constructor options. Default: 1 input, 1 output. */
-    protected get _workletOptions(): AudioWorkletNodeOptions;
-    constructor();
-    get inputNode(): AudioNode;
-    get outputNode(): AudioNode;
-    /**
-     * Resolves once the underlying worklet is loaded and inserted into the
-     * audio chain. Use this if you need to wait before applying parameters
-     * that depend on the worklet node.
-     */
-    get ready(): Promise<void>;
-    /** Disconnects all nodes, cancels any pending worklet load, and releases resources. */
-    destroy(): void;
-    /**
-     * Subclass hook — called once when the worklet has loaded and the
-     * AudioWorkletNode is inserted into the chain. Use this for additional
-     * wiring (e.g., connecting a sidechain input).
-     */
-    protected _onWorkletReady?(audioContext: AudioContext): void;
-    /**
-     * Ramps an `AudioParam` on the underlying `AudioWorkletNode` to `value`
-     * using a short exponential ramp. No-ops if the worklet is not yet loaded.
-     * @internal
-     */
-    protected _setAudioParam(name: string, value: number): void;
-    private _setup;
-}
-//# sourceMappingURL=WorkletFilter.d.ts.map

package/dist/esm/audio/filters/WorkletFilter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"WorkletFilter.d.ts","sourceRoot":"","sources":["../../../../src/audio/filters/WorkletFilter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;;;;;;;;;;;;GAcG;AACH,8BAAsB,aAAc,SAAQ,WAAW;IACrD,SAAS,CAAC,UAAU,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAC7C,SAAS,CAAC,WAAW,EAAE,QAAQ,GAAG,IAAI,CAAQ;IAC9C,SAAS,CAAC,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IACvD,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAQ;IAC9C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAGnC;IAEF,qFAAqF;IACrF,SAAS,CAAC,QAAQ,KAAK,YAAY,IAAI,MAAM,CAAC;IAC9C,2DAA2D;IAC3D,SAAS,CAAC,QAAQ,KAAK,cAAc,IAAI,MAAM,CAAC;IAChD,wEAAwE;IACxE,SAAS,KAAK,eAAe,IAAI,uBAAuB,CAEvD;;IAWD,IAAW,SAAS,IAAI,SAAS,CAKhC;IAED,IAAW,UAAU,IAAI,SAAS,CAKjC;IAED;;;;OAIG;IACH,IAAoB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzC;IAED,uFAAuF;IACvE,OAAO,IAAI,IAAI;IAW/B;;;;OAIG;IACH,SAAS,CAAC,eAAe,CAAC,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAE5D;;;;OAIG;IACH,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ3D,OAAO,CAAC,MAAM;CAyBf"}

package/dist/esm/audio/filters/WorkletFilter.js

@@ -1,110 +0,0 @@
-import { onAudioContextReady, isAudioContextReady, getAudioContext } from '../audio-context.js';
-import { AudioFilter } from '../AudioFilter.js';
-import { registerAudioWorkletProcessor } from '../worklet/registerWorklet.js';
-
-/**
- * Base class for filters implemented as AudioWorkletProcessors. Subclasses
- * declare the worklet's name, source code, and node options; this class
- * handles the async lifecycle.
- *
- * Stable input/output nodes (GainNodes) are created immediately on setup.
- * While the worklet loads asynchronously, audio passes through directly
- * (effectively bypassing the filter for ~10-50ms during initial load).
- * Once the worklet loads, it's inserted into the chain and audio routes
- * through it.
- *
- * Subclasses can override `_onWorkletReady` to perform additional wiring
- * (e.g., sidechain inputs).
- * @advanced
- */
-class WorkletFilter extends AudioFilter {
-    _inputGain = null;
-    _outputGain = null;
-    _workletNode = null;
-    _ready = null;
-    _onAudioContextReady = (ctx) => {
-        onAudioContextReady.remove(this._onAudioContextReady);
-        this._setup(ctx);
-    };
-    /** AudioWorkletNode constructor options. Default: 1 input, 1 output. */
-    get _workletOptions() {
-        return { numberOfInputs: 1, numberOfOutputs: 1 };
-    }
-    constructor() {
-        super();
-        if (isAudioContextReady()) {
-            this._setup(getAudioContext());
-        }
-        else {
-            onAudioContextReady.add(this._onAudioContextReady);
-        }
-    }
-    get inputNode() {
-        if (!this._inputGain) {
-            throw new Error(`${this.constructor.name}: input node accessed before audio context is ready.`);
-        }
-        return this._inputGain;
-    }
-    get outputNode() {
-        if (!this._outputGain) {
-            throw new Error(`${this.constructor.name}: output node accessed before audio context is ready.`);
-        }
-        return this._outputGain;
-    }
-    /**
-     * Resolves once the underlying worklet is loaded and inserted into the
-     * audio chain. Use this if you need to wait before applying parameters
-     * that depend on the worklet node.
-     */
-    get ready() {
-        return this._ready ?? Promise.resolve();
-    }
-    /** Disconnects all nodes, cancels any pending worklet load, and releases resources. */
-    destroy() {
-        onAudioContextReady.remove(this._onAudioContextReady);
-        this._workletNode?.disconnect();
-        this._inputGain?.disconnect();
-        this._outputGain?.disconnect();
-        this._workletNode = null;
-        this._inputGain = null;
-        this._outputGain = null;
-        this._ready = null;
-    }
-    /**
-     * Ramps an `AudioParam` on the underlying `AudioWorkletNode` to `value`
-     * using a short exponential ramp. No-ops if the worklet is not yet loaded.
-     * @internal
-     */
-    _setAudioParam(name, value) {
-        if (!this._workletNode)
-            return;
-        const audioParam = this._workletNode.parameters.get(name);
-        if (audioParam) {
-            audioParam.setTargetAtTime(value, this._workletNode.context.currentTime, 0.01);
-        }
-    }
-    _setup(audioContext) {
-        // Create stable input/output gains immediately (bus can wire them now).
-        const inputGain = audioContext.createGain();
-        const outputGain = audioContext.createGain();
-        // Bypass: input → output until worklet loads.
-        inputGain.connect(outputGain);
-        this._inputGain = inputGain;
-        this._outputGain = outputGain;
-        // Async-load the worklet, then re-route through it.
-        this._ready = registerAudioWorkletProcessor(audioContext, this._workletName, this._workletSource).then(() => {
-            if (!this._inputGain || !this._outputGain)
-                return; // destroyed during load
-            const node = new AudioWorkletNode(audioContext, this._workletName, this._workletOptions);
-            this._workletNode = node;
-            // Re-route: input → worklet → output
-            this._inputGain.disconnect();
-            this._inputGain.connect(node);
-            node.connect(this._outputGain);
-            this._onWorkletReady?.(audioContext);
-        });
-    }
-}
-
-export { WorkletFilter };
-//# sourceMappingURL=WorkletFilter.js.map

package/dist/esm/audio/filters/WorkletFilter.js.map

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

package/dist/esm/audio/worklets/beat-detector.worklet.d.ts

@@ -1,2 +0,0 @@
-export declare const beatDetectorWorkletSource = "\n// ---- Hann window + FFT (radix-2 Cooley-Tukey) ----\nfunction applyHannWindow(real, imag) {\n    var n = real.length;\n    for (var i = 0; i < n; i++) {\n        var w = 0.5 * (1 - Math.cos(2 * Math.PI * i / (n - 1)));\n        real[i] *= w;\n        imag[i] = 0;\n    }\n}\n\nfunction bitReversePermute(real, imag) {\n    var n = real.length;\n    var j = 0;\n    for (var i = 1; i < n; i++) {\n        var bit = n >> 1;\n        for (; j & bit; bit >>= 1) { j ^= bit; }\n        j ^= bit;\n        if (i < j) {\n            var t = real[i]; real[i] = real[j]; real[j] = t;\n            t = imag[i]; imag[i] = imag[j]; imag[j] = t;\n        }\n    }\n}\n\nfunction fftInPlace(real, imag) {\n    applyHannWindow(real, imag);\n    bitReversePermute(real, imag);\n    var n = real.length;\n    for (var len = 2; len <= n; len <<= 1) {\n        var halfLen = len >> 1;\n        var step = -2 * Math.PI / len;\n        for (var i = 0; i < n; i += len) {\n            for (var k = 0; k < halfLen; k++) {\n                var angle = step * k;\n                var cos = Math.cos(angle);\n                var sin = Math.sin(angle);\n                var re = real[i+k+halfLen]*cos - imag[i+k+halfLen]*sin;\n                var im = real[i+k+halfLen]*sin + imag[i+k+halfLen]*cos;\n                real[i+k+halfLen] = real[i+k] - re;\n                imag[i+k+halfLen] = imag[i+k] - im;\n                real[i+k] += re;\n                imag[i+k] += im;\n            }\n        }\n    }\n}\n\n// ---- Mel filterbank ----\nfunction buildMelFilterbank(numBands, fMin, fMax, fftSize, sampleRate) {\n    var numBins = fftSize >> 1;\n    var nyquist = sampleRate / 2;\n    var melMin = 2595 * Math.log10(1 + fMin / 700);\n    var melMax = 2595 * Math.log10(1 + fMax / 700);\n    var melPoints = new Float32Array(numBands + 2);\n    for (var i = 0; i < numBands + 2; i++) {\n        melPoints[i] = melMin + (melMax - melMin) * i / (numBands + 1);\n    }\n    var binPoints = new Float32Array(numBands + 2);\n    for (var i = 0; i < numBands + 2; i++) {\n        var hz = 700 * (Math.pow(10, melPoints[i] / 2595) - 1);\n        binPoints[i] = Math.round(hz / nyquist * (numBins - 1));\n    }\n    var bands = [];\n    for (var b = 0; b < numBands; b++) {\n        var startBin = Math.max(0, Math.min(numBins - 1, binPoints[b]));\n        var peakBin  = Math.max(0, Math.min(numBins - 1, binPoints[b+1]));\n        var endBin   = Math.max(0, Math.min(numBins - 1, binPoints[b+2]));\n        var len = endBin - startBin + 1;\n        var weights = new Float32Array(len);\n        for (var i = 0; i < len; i++) {\n            var bin = startBin + i;\n            if (bin <= peakBin && peakBin > startBin) {\n                weights[i] = (bin - startBin) / (peakBin - startBin);\n            } else if (bin > peakBin && endBin > peakBin) {\n                weights[i] = (endBin - bin) / (endBin - peakBin);\n            } else {\n                weights[i] = 1;\n            }\n        }\n        bands.push({ startBin: startBin, peakBin: peakBin, endBin: endBin, weights: weights });\n    }\n    return bands;\n}\n\nfunction computeMelBands(mag, bands, out) {\n    for (var b = 0; b < bands.length; b++) {\n        var band = bands[b];\n        var energy = 0;\n        for (var i = 0; i < band.weights.length; i++) {\n            energy += mag[band.startBin + i] * band.weights[i];\n        }\n        out[b] = Math.log(1 + energy);\n    }\n}\n\n// ---- Processor ----\nclass BeatDetectorProcessor extends AudioWorkletProcessor {\n    constructor(options) {\n        super();\n        var opts = (options && options.processorOptions) || {};\n        this._sampleRate = sampleRate;\n        this._fftSize    = opts.fftSize    || 2048;\n        this._hopSize    = opts.hopSize    || 512;\n        this._minBpm     = opts.minBpm     || 50;\n        this._maxBpm     = opts.maxBpm     || 250;\n        this._melBands   = opts.melBands   || 24;\n        this._settlingMs = opts.settlingMs !== undefined ? opts.settlingMs : 1500;\n        this._tempoWindowSec = opts.tempoWindowSec || 6;\n        this._enableTsDetection = opts.enableTimeSignatureDetection !== false;\n\n        var numBins = this._fftSize >> 1;\n        this._real = new Float32Array(this._fftSize);\n        this._imag = new Float32Array(this._fftSize);\n        this._mag  = new Float32Array(numBins);\n        this._ringBuffer  = new Float32Array(this._fftSize);\n        this._ringWritePos = 0;\n        this._sampleCount  = 0;\n        this._hopAccum     = 0;\n\n        this._melBandFilters = buildMelFilterbank(this._melBands, 80, 8000, this._fftSize, this._sampleRate);\n        this._melOut         = new Float32Array(this._melBands);\n        var fluxWindowLen    = Math.ceil(this._tempoWindowSec * this._sampleRate / this._hopSize);\n        this._fluxWindow     = new Float32Array(fluxWindowLen);\n        this._fluxWritePos   = 0;\n        this._fluxCount      = 0;\n        var LAG_K = 3;\n        this._prevMelFrames  = [];\n        for (var i = 0; i < LAG_K; i++) {\n            this._prevMelFrames.push(new Float32Array(this._melBands));\n        }\n        this._prevMelFrameIdx = 0;\n\n        // Lag range in hops for BPM range\n        this._minLag = Math.max(1, Math.round(60 / this._maxBpm * this._sampleRate / this._hopSize));\n        this._maxLag = Math.round(60 / this._minBpm * this._sampleRate / this._hopSize);\n\n        this._hopsSinceACF = 0;\n        var ACF_INTERVAL = 15;\n        this._acfInterval = ACF_INTERVAL;\n\n        // Tempo state\n        this._bestBpm    = 0;\n        this._bestScore  = 0;\n        this._candidates = [];\n\n        // Phase state\n        this._lastBeatSample = -1;\n        this._ibiHistory     = new Float32Array(4); // last 4 inter-beat intervals\n        this._ibiIdx         = 0;\n\n        // Bar position state \u2014 parallel posteriors for 4/4 and 3/4\n        this._posterior4    = new Float32Array([0.25, 0.25, 0.25, 0.25]);\n        this._posterior3    = new Float32Array([1/3, 1/3, 1/3]);\n        this._ts4Confidence = 0.5;\n        this._ts3Confidence = 0.5;\n        this._activeTs      = '4/4';\n        this._sustainCounter = 0;\n        this._barPosition   = 1; // 1-indexed\n        this._barNumber     = 0;\n        this._beatsSinceStart = 0;\n\n        // Confidence\n        this._confidence = 0;\n\n        // State snapshot cadence (~20 Hz)\n        var STATE_INTERVAL_HOPS = Math.round(this._sampleRate / this._hopSize / 20);\n        this._stateInterval = Math.max(1, STATE_INTERVAL_HOPS);\n        this._hopsSinceState = 0;\n\n        // Settling\n        this._startSample   = currentFrame;\n        this._settledSamples = Math.round(this._settlingMs * 0.001 * this._sampleRate);\n\n        // Lookahead\n        this._lookahead = [];\n\n        // RMS / onset state\n        this._rms = 0;\n        this._onsetStrength = 0;\n\n        // Band energy (for state messages)\n        var LOW_BANDS  = Math.round(this._melBands * 0.25);\n        var MID_BANDS  = Math.round(this._melBands * 0.6);\n        this._lowBandEnd  = LOW_BANDS;\n        this._midBandEnd  = MID_BANDS;\n    }\n\n    process(inputs, _outputs, _parameters) {\n        var input = inputs[0];\n        if (!input || input.length === 0) return true;\n\n        var left  = input[0] || [];\n        var right = input[1] || left;\n        var blockLen = left.length;\n\n        for (var s = 0; s < blockLen; s++) {\n            // Mono downmix\n            var mono = (left[s] + right[s]) * 0.5;\n\n            // Accumulate RMS\n            this._rms += mono * mono;\n\n            // Fill ring buffer\n            this._ringBuffer[this._ringWritePos] = mono;\n            this._ringWritePos = (this._ringWritePos + 1) & (this._fftSize - 1);\n\n            this._hopAccum++;\n            this._sampleCount++;\n\n            if (this._hopAccum >= this._hopSize) {\n                this._hopAccum = 0;\n                this._processHop();\n            }\n        }\n\n        return true;\n    }\n\n    _processHop() {\n        // Read ring buffer into real[] (oldest first)\n        var rb = this._ringBuffer;\n        var wp = this._ringWritePos;\n        var n  = this._fftSize;\n        for (var i = 0; i < n; i++) {\n            this._real[i] = rb[(wp + i) & (n - 1)];\n        }\n\n        // FFT\n        fftInPlace(this._real, this._imag);\n\n        // Magnitude spectrum\n        var bins = n >> 1;\n        for (var i = 0; i < bins; i++) {\n            this._mag[i] = Math.sqrt(this._real[i]*this._real[i] + this._imag[i]*this._imag[i]);\n        }\n\n        // RMS (from time domain, using ring buffer)\n        var rmsAccum = 0;\n        for (var i = 0; i < n; i++) {\n            rmsAccum += rb[(wp + i) & (n - 1)] * rb[(wp + i) & (n - 1)];\n        }\n        this._rms = Math.sqrt(rmsAccum / n);\n\n        // Mel bands\n        computeMelBands(this._mag, this._melBandFilters, this._melOut);\n\n        // Spectral flux (SuperFlux-lite, lag k=3)\n        var K = this._prevMelFrames.length;\n        var flux = 0;\n        for (var b = 0; b < this._melBands; b++) {\n            var localMax = -Infinity;\n            for (var k = 0; k < K; k++) {\n                var prevVal = this._prevMelFrames[k][b];\n                if (prevVal > localMax) localMax = prevVal;\n            }\n            var diff = this._melOut[b] - localMax;\n            if (diff > 0) flux += diff;\n        }\n        this._onsetStrength = flux;\n\n        // Store current mel frame in circular buffer\n        var prevFrame = this._prevMelFrames[this._prevMelFrameIdx];\n        for (var b = 0; b < this._melBands; b++) {\n            prevFrame[b] = this._melOut[b];\n        }\n        this._prevMelFrameIdx = (this._prevMelFrameIdx + 1) % K;\n\n        // Add flux to sliding window\n        this._fluxWindow[this._fluxWritePos] = flux;\n        this._fluxWritePos = (this._fluxWritePos + 1) % this._fluxWindow.length;\n        if (this._fluxCount < this._fluxWindow.length) this._fluxCount++;\n\n        // Tempogram: compute ACF periodically\n        this._hopsSinceACF++;\n        if (this._hopsSinceACF >= this._acfInterval && this._fluxCount >= this._maxLag + 1) {\n            this._hopsSinceACF = 0;\n            this._computeACFAndCandidates();\n        }\n\n        // Phase tracker\n        var settled = (this._sampleCount - this._settledSamples) > 0;\n        if (this._bestBpm > 0 && settled) {\n            this._tickPhase(flux);\n        }\n\n        // State snapshot\n        this._hopsSinceState++;\n        if (this._hopsSinceState >= this._stateInterval) {\n            this._hopsSinceState = 0;\n            this._sendStateMessage();\n        }\n    }\n\n    _computeACFAndCandidates() {\n        var n   = this._fluxCount;\n        var buf = this._fluxWindow;\n        var wp  = this._fluxWritePos;\n        var len = buf.length;\n\n        // Compute ACF for lags in [minLag, maxLag]\n        var numLags = this._maxLag - this._minLag + 1;\n        var acf = new Float32Array(numLags);\n        for (var lagIdx = 0; lagIdx < numLags; lagIdx++) {\n            var lag = this._minLag + lagIdx;\n            var sum = 0, count = 0;\n            for (var t = lag; t < n; t++) {\n                var idxT   = (wp - 1 - (n - 1 - t) + len) % len;\n                var idxTL  = (wp - 1 - (n - 1 - (t - lag)) + len) % len;\n                sum += buf[idxT] * buf[idxTL];\n                count++;\n            }\n            acf[lagIdx] = count > 0 ? sum / count : 0;\n        }\n\n        // Normalise\n        var norm = 0;\n        for (var i = 0; i < numLags; i++) { if (acf[i] > norm) norm = acf[i]; }\n        if (norm > 0) {\n            for (var i = 0; i < numLags; i++) acf[i] /= norm;\n        }\n\n        // Find top peaks\n        var peaks = [];\n        for (var i = 1; i < numLags - 1; i++) {\n            if (acf[i] > acf[i-1] && acf[i] > acf[i+1] && acf[i] > 0) {\n                var lag2 = this._minLag + i;\n                var bpm = 60 * this._sampleRate / (lag2 * this._hopSize);\n                if (bpm >= this._minBpm && bpm <= this._maxBpm) {\n                    peaks.push({ bpm: bpm, score: acf[i], lag: lag2 });\n                }\n            }\n        }\n        peaks.sort(function(a, b) { return b.score - a.score; });\n        this._candidates = peaks.slice(0, 3);\n\n        if (this._candidates.length === 0) return;\n\n        var top = this._candidates[0];\n\n        // Hysteresis\n        if (this._bestBpm <= 0) {\n            // First lock\n            this._bestBpm   = top.bpm;\n            this._bestScore = top.score;\n        } else {\n            var isOctave = (Math.abs(top.bpm / this._bestBpm - 2) < 0.1) ||\n                           (Math.abs(top.bpm / this._bestBpm - 0.5) < 0.05);\n            var margin = isOctave ? 1.5 : 1.15;\n            if (top.score > this._bestScore * margin) {\n                var oldBpm = this._bestBpm;\n                this._bestBpm   = top.bpm;\n                this._bestScore = top.score;\n                // Only fire tempoChange if > 5% different\n                if (Math.abs(this._bestBpm - oldBpm) / oldBpm > 0.05) {\n                    this.port.postMessage({ type: 'tempoChange', newTempo: this._bestBpm, oldTempo: oldBpm });\n                }\n            } else {\n                this._bestScore = this._bestScore * 0.99 + top.score * 0.01; // slowly decay\n            }\n        }\n\n        this._updateConfidence();\n    }\n\n    _tickPhase(flux) {\n        if (this._lastBeatSample < 0) {\n            // Bootstrap: set first beat at current sample\n            this._lastBeatSample = this._sampleCount;\n            return;\n        }\n\n        var beatIntervalSamples = 60 / this._bestBpm * this._sampleRate;\n        var phase = (this._sampleCount - this._lastBeatSample) / beatIntervalSamples;\n\n        // Snap correction: if novelty peak is strong and phase is 0.7..1.3, snap\n        if (phase >= 0.7 && phase <= 1.3 && flux > 0) {\n            // Compute mean recent flux\n            var recentMean = 0;\n            var count = Math.min(this._fluxCount, 16);\n            var wp = this._fluxWritePos;\n            var len = this._fluxWindow.length;\n            for (var i = 0; i < count; i++) {\n                recentMean += this._fluxWindow[(wp - 1 - i + len) % len];\n            }\n            recentMean /= count || 1;\n            if (flux > 1.5 * recentMean && recentMean > 0) {\n                // Snap to this sample\n                this._lastBeatSample = this._sampleCount;\n                phase = 1.0;\n            }\n        }\n\n        if (phase >= 1.0) {\n            var beatTime = (this._lastBeatSample + beatIntervalSamples) / this._sampleRate;\n            this._lastBeatSample += beatIntervalSamples;\n\n            // Update IBI history\n            this._ibiHistory[this._ibiIdx] = beatIntervalSamples;\n            this._ibiIdx = (this._ibiIdx + 1) & 3;\n\n            this._beatsSinceStart++;\n\n            // Update bar position\n            this._updateBarPosition(flux);\n\n            // Compute confidence\n            this._updateConfidence();\n\n            // Lookahead\n            this._updateLookahead(beatTime);\n\n            var isDownbeat = this._barPosition === 1;\n            var beatInfo = {\n                type: 'beat',\n                audioTime: beatTime,\n                tempo: this._bestBpm,\n                confidence: this._confidence,\n                beatPhase: 0,\n                energy: flux,\n                isDownbeat: isDownbeat,\n                beatInBar: this._barPosition,\n            };\n            this.port.postMessage(beatInfo);\n\n            if (isDownbeat) {\n                this.port.postMessage({\n                    type: 'barStart',\n                    audioTime: beatTime,\n                    tempo: this._bestBpm,\n                    confidence: this._confidence,\n                    barNumber: this._barNumber,\n                });\n            }\n        }\n    }\n\n    _computeBeatLikelihood(flux) {\n        var count = Math.min(this._fluxCount, 32);\n        var wp = this._fluxWritePos;\n        var len = this._fluxWindow.length;\n        var totalFlux = 0;\n        for (var i = 0; i < count; i++) {\n            totalFlux += this._fluxWindow[(wp - 1 - i + len) % len];\n        }\n        var mean = count > 0 ? totalFlux / count : 1;\n        return Math.max(0.5, Math.min(1.5, mean > 0 ? flux / mean : 1));\n    }\n\n    _updateBarPosition(flux) {\n        var likelihood = this._computeBeatLikelihood(flux);\n\n        // --- 4/4 posterior ---\n        var p4 = this._posterior4;\n        var s4 = new Float32Array(4);\n        s4[0] = p4[3]; s4[1] = p4[0]; s4[2] = p4[1]; s4[3] = p4[2];\n        var sum4 = 0;\n        for (var i = 0; i < 4; i++) {\n            p4[i] = s4[i] * (likelihood + (i === 0 ? 0.3 : 0));\n            sum4 += p4[i];\n        }\n        if (sum4 > 0) { for (var i = 0; i < 4; i++) p4[i] /= sum4; }\n\n        // --- 3/4 posterior ---\n        var p3 = this._posterior3;\n        var s3 = new Float32Array(3);\n        s3[0] = p3[2]; s3[1] = p3[0]; s3[2] = p3[1];\n        var sum3 = 0;\n        for (var i = 0; i < 3; i++) {\n            p3[i] = s3[i] * (likelihood + (i === 0 ? 0.3 : 0));\n            sum3 += p3[i];\n        }\n        if (sum3 > 0) { for (var i = 0; i < 3; i++) p3[i] /= sum3; }\n\n        // --- Update TS confidences (EMA) ---\n        var max4 = 0;\n        for (var i = 0; i < 4; i++) { if (p4[i] > max4) max4 = p4[i]; }\n        var max3 = 0;\n        for (var i = 0; i < 3; i++) { if (p3[i] > max3) max3 = p3[i]; }\n        var alpha = 0.1;\n        this._ts4Confidence = (1 - alpha) * this._ts4Confidence + alpha * max4;\n        this._ts3Confidence = (1 - alpha) * this._ts3Confidence + alpha * max3;\n\n        // --- Hysteresis switching ---\n        if (this._enableTsDetection && this._beatsSinceStart > 8) {\n            var minSwitchMargin = 1.4;\n            var minSustainBeats = 12; // ~4 bars * 3 beats\n            var threeFavored = this._ts3Confidence > this._ts4Confidence * minSwitchMargin;\n            var fourFavored  = this._ts4Confidence > this._ts3Confidence * minSwitchMargin;\n\n            if (this._activeTs === '4/4' && threeFavored) {\n                this._sustainCounter++;\n                if (this._sustainCounter >= minSustainBeats) {\n                    this._activeTs = '3/4';\n                    this._sustainCounter = 0;\n                }\n            } else if (this._activeTs === '3/4' && fourFavored) {\n                this._sustainCounter++;\n                if (this._sustainCounter >= minSustainBeats + 4) { // 16 beats for 4/4\n                    this._activeTs = '4/4';\n                    this._sustainCounter = 0;\n                }\n            } else {\n                this._sustainCounter = 0;\n            }\n        }\n\n        // --- Determine bar position from active TS ---\n        var barLen = this._activeTs === '3/4' ? 3 : 4;\n        var posterior = this._activeTs === '3/4' ? p3 : p4;\n\n        if (this._beatsSinceStart >= barLen) {\n            var maxP = -1, maxI = 0;\n            for (var i = 0; i < barLen; i++) {\n                if (posterior[i] > maxP) { maxP = posterior[i]; maxI = i; }\n            }\n            var newPos = maxI + 1; // 1-indexed\n            if (newPos === 1 && this._barPosition !== 1) {\n                this._barNumber++;\n            }\n            this._barPosition = newPos;\n        } else {\n            // Just advance sequentially\n            this._barPosition = ((this._barPosition) % barLen) + 1;\n            if (this._barPosition === 1) this._barNumber++;\n        }\n    }\n\n    _updateConfidence() {\n        if (this._candidates.length === 0) {\n            this._confidence = 0;\n            return;\n        }\n\n        // Peak contrast\n        var top1 = this._candidates[0] ? this._candidates[0].score : 0;\n        var top2 = this._candidates[1] ? this._candidates[1].score : top1;\n        var top3 = this._candidates[2] ? this._candidates[2].score : top2;\n        var peakContrast = (top2 + top3) > 0 ? top1 / ((top2 + top3) / 2) : 1;\n\n        // Phase consistency from IBI variance\n        var ibiMean = 0;\n        for (var i = 0; i < 4; i++) ibiMean += this._ibiHistory[i];\n        ibiMean /= 4;\n        var ibiVar = 0;\n        for (var i = 0; i < 4; i++) {\n            var d = this._ibiHistory[i] - ibiMean;\n            ibiVar += d * d;\n        }\n        ibiVar /= 4;\n        var phaseConsistency = ibiMean > 0 ? Math.max(0, 1 - ibiVar / (ibiMean * ibiMean)) : 0;\n\n        // Bar consistency (use the active posterior)\n        var activePosterior = this._activeTs === '3/4' ? this._posterior3 : this._posterior4;\n        var activeLen = this._activeTs === '3/4' ? 3 : 4;\n        var maxP = 0;\n        for (var i = 0; i < activeLen; i++) {\n            if (activePosterior[i] > maxP) maxP = activePosterior[i];\n        }\n        var barConsistency = maxP;\n\n        var c = Math.sqrt(Math.max(0, peakContrast / 2)) *\n                Math.sqrt(Math.max(0, phaseConsistency)) *\n                (0.5 + 0.5 * barConsistency);\n        this._confidence = Math.max(0, Math.min(1, c));\n    }\n\n    _updateLookahead(lastBeatTime) {\n        var lookahead = [];\n        var beatInterval = 60 / this._bestBpm;\n        var barPos = this._barPosition;\n        var barLen = this._activeTs === '3/4' ? 3 : 4;\n        for (var i = 0; i < 8; i++) {\n            var t = lastBeatTime + (i + 1) * beatInterval;\n            var bp = ((barPos - 1 + i) % barLen) + 1;\n            lookahead.push({\n                audioTime: t,\n                tempo: this._bestBpm,\n                isDownbeat: bp === 1,\n                beatInBar: bp,\n            });\n        }\n        this._lookahead = lookahead;\n    }\n\n    _computeBandEnergy() {\n        var low = 0, mid = 0, high = 0;\n        for (var b = 0; b < this._lowBandEnd; b++) low += this._melOut[b];\n        for (var b = this._lowBandEnd; b < this._midBandEnd; b++) mid += this._melOut[b];\n        for (var b = this._midBandEnd; b < this._melBands; b++) high += this._melOut[b];\n        var denom = this._lowBandEnd || 1;\n        return {\n            low:  low  / denom,\n            mid:  mid  / Math.max(1, this._midBandEnd - this._lowBandEnd),\n            high: high / Math.max(1, this._melBands - this._midBandEnd),\n        };\n    }\n\n    _sendStateMessage() {\n        var settled = (this._sampleCount - this._settledSamples) > 0;\n        var beatInterval = this._bestBpm > 0 ? 60 / this._bestBpm : 0;\n        var currentTime = this._sampleCount / this._sampleRate;\n        var lastBeatTime = this._lastBeatSample >= 0 ? this._lastBeatSample / this._sampleRate : 0;\n        var beatPhase = beatInterval > 0\n            ? Math.min(1, (currentTime - lastBeatTime) / beatInterval)\n            : 0;\n        var nextBeatTime = lastBeatTime + beatInterval;\n\n        var nextDownbeatTime = nextBeatTime;\n        for (var i = 0; i < this._lookahead.length; i++) {\n            if (this._lookahead[i].isDownbeat) {\n                nextDownbeatTime = this._lookahead[i].audioTime;\n                break;\n            }\n        }\n\n        var be = this._computeBandEnergy();\n\n        this.port.postMessage({\n            type: 'state',\n            tempo: settled ? this._bestBpm : 0,\n            beatPhase: beatPhase,\n            confidence: settled ? this._confidence : 0,\n            gridStability: settled ? this._confidence : 0,\n            tempoCandidates: settled ? this._candidates.map(function(c) {\n                return { bpm: c.bpm, score: c.score };\n            }) : [],\n            rms: this._rms,\n            onsetStrength: this._onsetStrength,\n            bandEnergy: be,\n            barPosition: this._barPosition,\n            barLength: this._activeTs === '3/4' ? 3 : 4,\n            timeSignature: this._activeTs === '3/4'\n                ? { numerator: 3, denominator: 4 }\n                : { numerator: 4, denominator: 4 },\n            lookahead: this._lookahead,\n            nextBeatTime: settled ? nextBeatTime : 0,\n            nextDownbeatTime: settled ? nextDownbeatTime : 0,\n        });\n    }\n}\n\nregisterProcessor('exojs-beat-detector', BeatDetectorProcessor);\n";
-//# sourceMappingURL=beat-detector.worklet.d.ts.map

package/dist/esm/audio/worklets/beat-detector.worklet.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"beat-detector.worklet.d.ts","sourceRoot":"","sources":["../../../../src/audio/worklets/beat-detector.worklet.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,+wvBAmoBrC,CAAC"}