@codexo/exojs 0.6.11 → 0.7.11

package/dist/esm/audio/dsp/mel.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Mel-scale filterbank generator.
+ *
+ * Generates `numBands` triangular filters log-spaced from `fMin` to `fMax` Hz
+ * on the mel scale. Each filter is a typed array of weights for the FFT
+ * magnitude bins.
+ *
+ * These helpers are also inlined inside the beat-detector worklet source
+ * string (worklets cannot import modules).
+ */
+/** Convert Hz to mel. */
+export declare function hzToMel(hz: number): number;
+/** Convert mel to Hz. */
+export declare function melToHz(mel: number): number;
+export interface MelBand {
+    /** Index of the FFT bin where this filter starts (weight 0). */
+    readonly startBin: number;
+    /** Index of the peak FFT bin (weight 1). */
+    readonly peakBin: number;
+    /** Index of the FFT bin where this filter ends (weight 0). */
+    readonly endBin: number;
+    /** Pre-computed triangular weights, indexed from startBin..endBin (inclusive). */
+    readonly weights: Float32Array;
+}
+/**
+ * Build a mel filterbank.
+ *
+ * @param numBands   Number of mel bands (default 24).
+ * @param fMin       Lowest frequency in Hz (default 80).
+ * @param fMax       Highest frequency in Hz (default 8000).
+ * @param fftSize    Number of FFT points (e.g., 2048).
+ * @param sampleRate Audio sample rate in Hz (e.g., 48000).
+ */
+export declare function buildMelFilterbank(numBands: number, fMin: number, fMax: number, fftSize: number, sampleRate: number): Array<MelBand>;
+/**
+ * Compute mel band energies from a magnitude spectrum.
+ *
+ * @param mag     FFT magnitude spectrum (length = fftSize/2).
+ * @param bands   Filterbank from `buildMelFilterbank`.
+ * @param out     Optional pre-allocated output array of length `bands.length`.
+ * @returns       Log-compressed mel band energies.
+ */
+export declare function computeMelBands(mag: Float32Array, bands: Array<MelBand>, out?: Float32Array): Float32Array;

package/dist/esm/audio/dsp/tempogram.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Autocorrelation-based tempogram.
+ *
+ * Given a novelty (onset-strength) curve sampled at rate `hopRate = sampleRate / hopSize`,
+ * this module computes the autocorrelation function (ACF) over a sliding window
+ * and returns the top tempo candidates.
+ *
+ * These helpers are also inlined inside the beat-detector worklet source string
+ * (worklets cannot import modules).
+ */
+export interface TempoCandidateResult {
+    /** BPM value. */
+    bpm: number;
+    /** Normalised peak score (0..1). */
+    score: number;
+    /** ACF lag in hops that produced this peak. */
+    lag: number;
+}
+/**
+ * Compute the normalised autocorrelation function over a novelty curve.
+ *
+ * @param flux       Recent novelty values (ring-buffer contents, oldest first).
+ * @param minLag     Minimum lag in samples (inclusive).
+ * @param maxLag     Maximum lag in samples (inclusive).
+ * @returns          ACF array indexed by lag (index 0 = lag minLag).
+ */
+export declare function computeAcf(flux: Float32Array, minLag: number, maxLag: number): Float32Array;
+/**
+ * Find the top-K peaks in the ACF and convert lags to BPM candidates.
+ *
+ * @param acf        Normalised ACF from `computeACF`.
+ * @param minLag     The lag (in hops) corresponding to acf[0].
+ * @param hopSize    Number of audio samples per hop.
+ * @param sampleRate Audio sample rate in Hz.
+ * @param topK       Number of peaks to return (default 3).
+ * @returns          Up to `topK` tempo candidates sorted by score descending.
+ */
+export declare function findTempoPeaks(acf: Float32Array, minLag: number, hopSize: number, sampleRate: number, topK?: number): Array<TempoCandidateResult>;
+/**
+ * Apply hysteresis to tempo candidate selection.
+ *
+ * Prevents rapid switching between tempo estimates:
+ * - Only switches to a new best if its score is > currentBestScore * 1.15.
+ * - Octave-related candidates (2x or 0.5x) require a score > 1.5x to switch.
+ *
+ * @param candidates   Sorted candidates from `findTempoPeaks`.
+ * @param currentBpm   Currently tracked BPM.
+ * @param currentScore Currently tracked best score.
+ * @returns            The selected best BPM.
+ */
+export declare function applyTempoHysteresis(candidates: Array<TempoCandidateResult>, currentBpm: number, currentScore: number): number;

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

@@ -0,0 +1,47 @@
+import { AudioFilter } from '../AudioFilter';
+export interface ChorusFilterOptions {
+    /** Base delay in ms. Typical 15-30ms. Default 25. */
+    delayMs?: number;
+    /** Modulation depth in ms (peak deviation from base). Default 5. */
+    depthMs?: number;
+    /** LFO rate in Hz. Typical 0.1-5Hz for chorus, 5-15Hz for vibrato. Default 1.5. */
+    rateHz?: number;
+    /** Dry/wet mix, 0..1. Default 0.5 (equal mix). */
+    wet?: number;
+}
+/**
+ * Chorus effect using native WebAudio nodes (no worklet required).
+ *
+ * The signal splits into a dry path and a wet path. The wet path passes
+ * through a DelayNode whose delay time is modulated by a sine-wave LFO,
+ * producing the characteristic pitch-wobble / thickening of chorus.
+ *
+ * Node graph:
+ * ```
+ * inputGain ┬── dryGain ────────────────┐
+ *           │                            ├── outputGain
+ *           └── delayNode ── wetGain ────┘
+ *
+ * lfoOscillator ── lfoGain (depth) ── delayNode.delayTime
+ * ```
+ */
+export declare class ChorusFilter extends AudioFilter {
+    private _nodes;
+    private _delayMs;
+    private _depthMs;
+    private _rateHz;
+    private _wet;
+    constructor(options?: ChorusFilterOptions);
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    get delayMs(): number;
+    set delayMs(value: number);
+    get depthMs(): number;
+    set depthMs(value: number);
+    get rateHz(): number;
+    set rateHz(value: number);
+    get wet(): number;
+    set wet(value: number);
+    destroy(): void;
+    private _setupNodes;
+}

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

@@ -0,0 +1,139 @@
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from '../audio-context.js';
+import { AudioFilter } from '../AudioFilter.js';
+
+/**
+ * Chorus effect using native WebAudio nodes (no worklet required).
+ *
+ * The signal splits into a dry path and a wet path. The wet path passes
+ * through a DelayNode whose delay time is modulated by a sine-wave LFO,
+ * producing the characteristic pitch-wobble / thickening of chorus.
+ *
+ * Node graph:
+ * ```
+ * inputGain ┬── dryGain ────────────────┐
+ *           │                            ├── outputGain
+ *           └── delayNode ── wetGain ────┘
+ *
+ * lfoOscillator ── lfoGain (depth) ── delayNode.delayTime
+ * ```
+ */
+class ChorusFilter extends AudioFilter {
+    _nodes = null;
+    _delayMs;
+    _depthMs;
+    _rateHz;
+    _wet;
+    constructor(options = {}) {
+        super();
+        this._delayMs = Math.max(0, options.delayMs ?? 25);
+        this._depthMs = Math.max(0, options.depthMs ?? 5);
+        this._rateHz = Math.max(0, options.rateHz ?? 1.5);
+        this._wet = Math.max(0, Math.min(1, options.wet ?? 0.5));
+        if (isAudioContextReady()) {
+            this._setupNodes(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setupNodes, this);
+        }
+    }
+    get inputNode() {
+        if (!this._nodes)
+            throw new Error('ChorusFilter not yet initialized.');
+        return this._nodes.inputGain;
+    }
+    get outputNode() {
+        if (!this._nodes)
+            throw new Error('ChorusFilter not yet initialized.');
+        return this._nodes.outputGain;
+    }
+    // -------------------------------------------------------------------------
+    // Getters / setters
+    // -------------------------------------------------------------------------
+    get delayMs() { return this._delayMs; }
+    set delayMs(value) {
+        this._delayMs = Math.max(0, value);
+        if (this._nodes) {
+            this._nodes.delayNode.delayTime.setTargetAtTime(this._delayMs / 1000, this._nodes.delayNode.context.currentTime, 0.01);
+        }
+    }
+    get depthMs() { return this._depthMs; }
+    set depthMs(value) {
+        this._depthMs = Math.max(0, value);
+        if (this._nodes) {
+            this._nodes.lfoGain.gain.setTargetAtTime(this._depthMs / 1000, this._nodes.lfoGain.context.currentTime, 0.01);
+        }
+    }
+    get rateHz() { return this._rateHz; }
+    set rateHz(value) {
+        this._rateHz = Math.max(0, value);
+        if (this._nodes) {
+            this._nodes.lfoOscillator.frequency.setTargetAtTime(this._rateHz, this._nodes.inputGain.context.currentTime, 0.01);
+        }
+    }
+    get wet() { return this._wet; }
+    set wet(value) {
+        this._wet = Math.max(0, Math.min(1, value));
+        if (this._nodes) {
+            const ctx = this._nodes.wetGain.context;
+            this._nodes.wetGain.gain.setTargetAtTime(this._wet, ctx.currentTime, 0.01);
+            this._nodes.dryGain.gain.setTargetAtTime(1 - this._wet, ctx.currentTime, 0.01);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    destroy() {
+        onAudioContextReady.clearByContext(this);
+        if (this._nodes) {
+            this._nodes.lfoOscillator.stop();
+            this._nodes.lfoOscillator.disconnect();
+            this._nodes.lfoGain.disconnect();
+            this._nodes.delayNode.disconnect();
+            this._nodes.dryGain.disconnect();
+            this._nodes.wetGain.disconnect();
+            this._nodes.inputGain.disconnect();
+            this._nodes.outputGain.disconnect();
+            this._nodes = null;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Private
+    // -------------------------------------------------------------------------
+    _setupNodes(ctx) {
+        const inputGain = ctx.createGain();
+        const outputGain = ctx.createGain();
+        const dryGain = ctx.createGain();
+        const wetGain = ctx.createGain();
+        // maxDelayTime must be larger than base + peak depth, with a small buffer.
+        const maxDelay = (this._delayMs + this._depthMs) / 1000 + 0.05;
+        const delayNode = ctx.createDelay(maxDelay);
+        const lfoGain = ctx.createGain();
+        // Initial values
+        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);
+        delayNode.delayTime.setValueAtTime(this._delayMs / 1000, ctx.currentTime);
+        lfoGain.gain.setValueAtTime(this._depthMs / 1000, ctx.currentTime);
+        // LFO
+        const lfoOscillator = ctx.createOscillator();
+        lfoOscillator.type = 'sine';
+        lfoOscillator.frequency.value = this._rateHz;
+        // Wiring
+        // LFO → lfoGain → delayNode.delayTime (AudioParam)
+        lfoOscillator.connect(lfoGain);
+        lfoGain.connect(delayNode.delayTime);
+        // Dry path: inputGain → dryGain → outputGain
+        inputGain.connect(dryGain);
+        dryGain.connect(outputGain);
+        // Wet path: inputGain → delayNode → wetGain → outputGain
+        inputGain.connect(delayNode);
+        delayNode.connect(wetGain);
+        wetGain.connect(outputGain);
+        lfoOscillator.start();
+        this._nodes = { inputGain, outputGain, dryGain, wetGain, delayNode, lfoOscillator, lfoGain };
+    }
+}
+
+export { ChorusFilter };
+//# sourceMappingURL=ChorusFilter.js.map

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

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

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

@@ -0,0 +1,31 @@
+import { AudioFilter } from '../AudioFilter';
+export interface CompressorFilterOptions {
+    threshold?: number;
+    knee?: number;
+    ratio?: number;
+    attack?: number;
+    release?: number;
+}
+export declare class CompressorFilter extends AudioFilter {
+    private _node;
+    private _threshold;
+    private _knee;
+    private _ratio;
+    private _attack;
+    private _release;
+    constructor(options?: CompressorFilterOptions);
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    get threshold(): number;
+    set threshold(value: number);
+    get knee(): number;
+    set knee(value: number);
+    get ratio(): number;
+    set ratio(value: number);
+    get attack(): number;
+    set attack(value: number);
+    get release(): number;
+    set release(value: number);
+    destroy(): void;
+    private _setup;
+}

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

@@ -0,0 +1,97 @@
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from '../audio-context.js';
+import { AudioFilter } from '../AudioFilter.js';
+
+class CompressorFilter extends AudioFilter {
+    _node = null;
+    _threshold;
+    _knee;
+    _ratio;
+    _attack;
+    _release;
+    constructor(options = {}) {
+        super();
+        this._threshold = Math.max(-100, Math.min(0, options.threshold ?? -24));
+        this._knee = Math.max(0, Math.min(40, options.knee ?? 30));
+        this._ratio = Math.max(1, Math.min(20, options.ratio ?? 12));
+        this._attack = Math.max(0, Math.min(1, options.attack ?? 0.003));
+        this._release = Math.max(0, Math.min(1, options.release ?? 0.25));
+        if (isAudioContextReady()) {
+            this._setup(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setup, this);
+        }
+    }
+    get inputNode() {
+        if (!this._node)
+            throw new Error('CompressorFilter not yet initialized.');
+        return this._node;
+    }
+    get outputNode() {
+        if (!this._node)
+            throw new Error('CompressorFilter not yet initialized.');
+        return this._node;
+    }
+    get threshold() {
+        return this._threshold;
+    }
+    set threshold(value) {
+        this._threshold = Math.max(-100, Math.min(0, value));
+        if (this._node) {
+            this._node.threshold.setTargetAtTime(this._threshold, this._node.context.currentTime, 0.01);
+        }
+    }
+    get knee() {
+        return this._knee;
+    }
+    set knee(value) {
+        this._knee = Math.max(0, Math.min(40, value));
+        if (this._node) {
+            this._node.knee.setTargetAtTime(this._knee, this._node.context.currentTime, 0.01);
+        }
+    }
+    get ratio() {
+        return this._ratio;
+    }
+    set ratio(value) {
+        this._ratio = Math.max(1, Math.min(20, value));
+        if (this._node) {
+            this._node.ratio.setTargetAtTime(this._ratio, this._node.context.currentTime, 0.01);
+        }
+    }
+    get attack() {
+        return this._attack;
+    }
+    set attack(value) {
+        this._attack = Math.max(0, Math.min(1, value));
+        if (this._node) {
+            this._node.attack.setTargetAtTime(this._attack, this._node.context.currentTime, 0.01);
+        }
+    }
+    get release() {
+        return this._release;
+    }
+    set release(value) {
+        this._release = Math.max(0, Math.min(1, value));
+        if (this._node) {
+            this._node.release.setTargetAtTime(this._release, this._node.context.currentTime, 0.01);
+        }
+    }
+    destroy() {
+        onAudioContextReady.clearByContext(this);
+        this._node?.disconnect();
+        this._node = null;
+    }
+    _setup(ctx) {
+        const node = ctx.createDynamicsCompressor();
+        node.threshold.setValueAtTime(this._threshold, ctx.currentTime);
+        node.knee.setValueAtTime(this._knee, ctx.currentTime);
+        node.ratio.setValueAtTime(this._ratio, ctx.currentTime);
+        node.attack.setValueAtTime(this._attack, ctx.currentTime);
+        node.release.setValueAtTime(this._release, ctx.currentTime);
+        this._node = node;
+    }
+}
+
+export { CompressorFilter };
+//# sourceMappingURL=CompressorFilter.js.map

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

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

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

@@ -0,0 +1,23 @@
+import { AudioFilter } from '../AudioFilter';
+export interface DelayFilterOptions {
+    delaySeconds?: number;
+    feedback?: number;
+    wet?: number;
+}
+export declare class DelayFilter extends AudioFilter {
+    private _setup;
+    private _delaySeconds;
+    private _feedback;
+    private _wet;
+    constructor(options?: DelayFilterOptions);
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    get delaySeconds(): number;
+    set delaySeconds(value: number);
+    get feedback(): number;
+    set feedback(value: number);
+    get wet(): number;
+    set wet(value: number);
+    destroy(): void;
+    private _setupNodes;
+}

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

@@ -0,0 +1,100 @@
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from '../audio-context.js';
+import { AudioFilter } from '../AudioFilter.js';
+
+class DelayFilter extends AudioFilter {
+    _setup = null;
+    _delaySeconds;
+    _feedback;
+    _wet;
+    constructor(options = {}) {
+        super();
+        this._delaySeconds = Math.max(0, Math.min(5, options.delaySeconds ?? 0.3));
+        this._feedback = Math.max(0, Math.min(0.95, options.feedback ?? 0.4));
+        this._wet = Math.max(0, Math.min(1, options.wet ?? 0.5));
+        if (isAudioContextReady()) {
+            this._setupNodes(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setupNodes, this);
+        }
+    }
+    get inputNode() {
+        if (!this._setup)
+            throw new Error('DelayFilter not yet initialized.');
+        return this._setup.inputGain;
+    }
+    get outputNode() {
+        if (!this._setup)
+            throw new Error('DelayFilter not yet initialized.');
+        return this._setup.outputGain;
+    }
+    get delaySeconds() {
+        return this._delaySeconds;
+    }
+    set delaySeconds(value) {
+        this._delaySeconds = Math.max(0, Math.min(5, value));
+        if (this._setup) {
+            this._setup.delayNode.delayTime.setTargetAtTime(this._delaySeconds, this._setup.delayNode.context.currentTime, 0.01);
+        }
+    }
+    get feedback() {
+        return this._feedback;
+    }
+    set feedback(value) {
+        this._feedback = Math.max(0, Math.min(0.95, value));
+        if (this._setup) {
+            this._setup.feedbackGain.gain.setTargetAtTime(this._feedback, this._setup.feedbackGain.context.currentTime, 0.01);
+        }
+    }
+    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.clearByContext(this);
+        if (this._setup) {
+            this._setup.inputGain.disconnect();
+            this._setup.delayNode.disconnect();
+            this._setup.feedbackGain.disconnect();
+            this._setup.dryGain.disconnect();
+            this._setup.wetGain.disconnect();
+            this._setup.outputGain.disconnect();
+            this._setup = null;
+        }
+    }
+    _setupNodes(ctx) {
+        const inputGain = ctx.createGain();
+        const outputGain = ctx.createGain();
+        const delayNode = ctx.createDelay(5);
+        const feedbackGain = ctx.createGain();
+        const dryGain = ctx.createGain();
+        const wetGain = ctx.createGain();
+        inputGain.gain.setValueAtTime(1, ctx.currentTime);
+        outputGain.gain.setValueAtTime(1, ctx.currentTime);
+        delayNode.delayTime.setValueAtTime(this._delaySeconds, ctx.currentTime);
+        feedbackGain.gain.setValueAtTime(this._feedback, ctx.currentTime);
+        dryGain.gain.setValueAtTime(1 - this._wet, ctx.currentTime);
+        wetGain.gain.setValueAtTime(this._wet, ctx.currentTime);
+        // Dry path: input → dryGain → output
+        inputGain.connect(dryGain);
+        dryGain.connect(outputGain);
+        // Wet path: input → delay → wetGain → output
+        inputGain.connect(delayNode);
+        delayNode.connect(wetGain);
+        wetGain.connect(outputGain);
+        // Feedback loop: delay → feedbackGain → delay
+        delayNode.connect(feedbackGain);
+        feedbackGain.connect(delayNode);
+        this._setup = { inputGain, outputGain, delayNode, feedbackGain, dryGain, wetGain };
+    }
+}
+
+export { DelayFilter };
+//# sourceMappingURL=DelayFilter.js.map

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

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

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

@@ -0,0 +1,31 @@
+import { WorkletFilter } from './WorkletFilter';
+import type { AudioBus } from '../AudioBus';
+export interface DuckingFilterOptions {
+    sidechain: AudioBus;
+    threshold?: number;
+    ratio?: number;
+    attackMs?: number;
+    releaseMs?: number;
+}
+export declare class DuckingFilter extends WorkletFilter {
+    private readonly _sidechain;
+    private _threshold;
+    private _ratio;
+    private _attackMs;
+    private _releaseMs;
+    constructor(options: DuckingFilterOptions);
+    protected get _workletName(): string;
+    protected get _workletSource(): string;
+    protected get _workletOptions(): AudioWorkletNodeOptions;
+    protected _onWorkletReady(audioContext: AudioContext): void;
+    /** Convert ms time-constant to one-pole filter coefficient at given sample rate. */
+    private _msToCoeff;
+    get threshold(): number;
+    set threshold(value: number);
+    get ratio(): number;
+    set ratio(value: number);
+    get attackMs(): number;
+    set attackMs(value: number);
+    get releaseMs(): number;
+    set releaseMs(value: number);
+}