@codexo/exojs 0.8.4 → 0.9.0

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

@@ -1,20 +1,25 @@
-export * from './AbstractMedia';
-export * from './audio-context';
-export * from './AudioAnalyser';
-export * from './AudioBus';
+export type { AbstractMediaInitialState } from './AbstractMedia';
+export { AbstractMedia } from './AbstractMedia';
+export { decodeAudioData, getAudioContext, getOfflineAudioContext, isAudioContextReady, onAudioContextReady } from './audio-context';
+export type { AudioAnalyserOptions, AudioAnalyserSource, SpectrumMappingOptions } from './AudioAnalyser';
+export { AudioAnalyser } from './AudioAnalyser';
+export type { AudioBusOptions } from './AudioBus';
+export { AudioBus } from './AudioBus';
 export { AudioFilter } from './AudioFilter';
 export { AudioListener, type AudioListenerTarget } from './AudioListener';
-export { AudioManager, getAudioManager } from './AudioManager';
-export * from './BeatDetector';
+export { AudioManager, disposeAudioManager, getAudioManager } from './AudioManager';
+export type { BandEnergy, BarInfo, BeatDetectorOptions, BeatDetectorSource, BeatInfo, TempoCandidate, TimeSignature, UpcomingBeat } from './BeatDetector';
+export { BeatDetector } from './BeatDetector';
 export type { CrossFadeOptions } from './crossFade';
 export { crossFade } from './crossFade';
 export type { EnvelopeOptions } from './Envelope';
 export { Envelope } from './Envelope';
-export * from './filters';
-export * from './Media';
-export * from './Music';
+export type { ChorusFilterOptions, CompressorFilterOptions, DelayFilterOptions, DuckingFilterOptions, EqualizerFilterOptions, GranularFilterOptions, HighpassFilterOptions, LowpassFilterOptions, PitchShiftFilterOptions, ReverbFilterOptions, VocoderFilterOptions, } from './filters';
+export { ChorusFilter, CompressorFilter, DelayFilter, DuckingFilter, EqualizerFilter, GranularFilter, HighpassFilter, LowpassFilter, PitchShiftFilter, ReverbFilter, VocoderFilter, WorkletFilter, } from './filters';
+export type { Media } from './Media';
+export { Music } from './Music';
 export type { OscillatorPlayOptions, OscillatorSoundOptions, OscillatorType } from './OscillatorSound';
 export { OscillatorSound } from './OscillatorSound';
 export type { AudioSpriteClip, PlayOptions, SoundOptions } from './Sound';
 export { Sound, SoundPoolStrategy } from './Sound';
-export { registerWorkletProcessor } from './worklet/registerWorklet';
+export { registerAudioWorkletProcessor } from './worklet/registerWorklet';

package/dist/esm/audio/worklet/registerWorklet.d.ts

@@ -7,4 +7,4 @@
  * Source is bundled at build time as a JavaScript string and turned into a
  * Blob URL at runtime — no separate worklet asset file is shipped.
  */
-export declare function registerWorkletProcessor(audioContext: BaseAudioContext, processorName: string, source: string): Promise<void>;
+export declare function registerAudioWorkletProcessor(audioContext: BaseAudioContext, processorName: string, source: string): Promise<void>;

package/dist/esm/audio/worklet/registerWorklet.js

@@ -9,7 +9,7 @@ const _pending = new WeakMap();
  * Source is bundled at build time as a JavaScript string and turned into a
  * Blob URL at runtime — no separate worklet asset file is shipped.
  */
-async function registerWorkletProcessor(audioContext, processorName, source) {
+async function registerAudioWorkletProcessor(audioContext, processorName, source) {
     let registered = _registered.get(audioContext);
     if (!registered) {
         registered = new Set();
@@ -44,5 +44,5 @@ async function registerWorkletProcessor(audioContext, processorName, source) {
     return promise;
 }
 
-export { registerWorkletProcessor };
+export { registerAudioWorkletProcessor };
 //# sourceMappingURL=registerWorklet.js.map

package/dist/esm/audio/worklet/registerWorklet.js.map

@@ -1 +1 @@
-{"version":3,"file":"registerWorklet.js","sources":["../../../../../src/audio/worklet/registerWorklet.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,IAAI,OAAO,EAAiC;AAChE,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAgD;AAE5E;;;;;;;;AAQG;AACI,eAAe,wBAAwB,CAAC,YAA8B,EAAE,aAAqB,EAAE,MAAc,EAAA;IAClH,IAAI,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC;IAC9C,IAAI,CAAC,UAAU,EAAE;AACf,QAAA,UAAU,GAAG,IAAI,GAAG,EAAE;AACtB,QAAA,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC;IAC3C;AACA,IAAA,IAAI,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC;QAAE;IAEnC,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE;AACZ,QAAA,OAAO,GAAG,IAAI,GAAG,EAAE;AACnB,QAAA,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC;IACrC;IACA,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;AAC3C,IAAA,IAAI,QAAQ;AAAE,QAAA,OAAO,QAAQ;AAE7B,IAAA,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC;IACnE,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC;AAErC,IAAA,MAAM,OAAO,GAAG,YAAY,CAAC;SAC1B,SAAS,CAAC,GAAG;SACb,OAAO,CAAC,MAAK;AACZ,QAAA,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC;AAC1B,IAAA,CAAC;SACA,IAAI,CAAC,MAAK;AACT,QAAA,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC;AAC7B,QAAA,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;AAC/B,IAAA,CAAC;SACA,KAAK,CAAC,KAAK,IAAG;AACb,QAAA,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;AAC7B,QAAA,MAAM,KAAK;AACb,IAAA,CAAC,CAAC;AAEJ,IAAA,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC;AACnC,IAAA,OAAO,OAAO;AAChB;;;;"}
+{"version":3,"file":"registerWorklet.js","sources":["../../../../../src/audio/worklet/registerWorklet.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,IAAI,OAAO,EAAiC;AAChE,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAgD;AAE5E;;;;;;;;AAQG;AACI,eAAe,6BAA6B,CAAC,YAA8B,EAAE,aAAqB,EAAE,MAAc,EAAA;IACvH,IAAI,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,YAAY,CAAC;IAC9C,IAAI,CAAC,UAAU,EAAE;AACf,QAAA,UAAU,GAAG,IAAI,GAAG,EAAE;AACtB,QAAA,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC;IAC3C;AACA,IAAA,IAAI,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC;QAAE;IAEnC,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE;AACZ,QAAA,OAAO,GAAG,IAAI,GAAG,EAAE;AACnB,QAAA,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC;IACrC;IACA,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;AAC3C,IAAA,IAAI,QAAQ;AAAE,QAAA,OAAO,QAAQ;AAE7B,IAAA,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC;IACnE,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC;AAErC,IAAA,MAAM,OAAO,GAAG,YAAY,CAAC;SAC1B,SAAS,CAAC,GAAG;SACb,OAAO,CAAC,MAAK;AACZ,QAAA,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC;AAC1B,IAAA,CAAC;SACA,IAAI,CAAC,MAAK;AACT,QAAA,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC;AAC7B,QAAA,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;AAC/B,IAAA,CAAC;SACA,KAAK,CAAC,KAAK,IAAG;AACb,QAAA,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;AAC7B,QAAA,MAAM,KAAK;AACb,IAAA,CAAC,CAAC;AAEJ,IAAA,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC;AACnC,IAAA,OAAO,OAAO;AAChB;;;;"}

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

@@ -0,0 +1 @@
+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";