@drop-ai/core 0.2.0 → 0.3.1

package/dist/processing/PluginInsert.js

@@ -1,16 +1,194 @@
 import { Processor } from './Processor';
+/**
+ * Default sample rate assumption for tail-time estimation when the actual
+ * session sample rate is not available.
+ */
+const DEFAULT_SAMPLE_RATE = 44100;
+/**
+ * PluginInsert wraps a Plugin instance inside the Processor graph, bridging
+ * the plugin parameter world with the route's latency-compensation and
+ * tail-length bookkeeping.
+ *
+ * It automatically estimates processing latency and tail time based on the
+ * plugin type and name, and re-evaluates those estimates whenever a plugin
+ * parameter changes.
+ */
 export class PluginInsert extends Processor {
-    constructor(id, plugin) {
+    constructor(id, plugin, sampleRate = DEFAULT_SAMPLE_RATE) {
         super(id, `Insert: ${plugin.name}`);
         this._plugin = plugin;
+        this._sampleRate = sampleRate;
+        // Initial latency / tail estimation based on the plugin's current state.
+        this.updateLatencyFromPlugin();
+        this.updateTailFromPlugin();
+        // Re-estimate whenever a plugin parameter changes.
+        this._parameterSubscription = this._plugin.parameterChanged.connect((_change) => {
+            this.updateLatencyFromPlugin();
+            this.updateTailFromPlugin();
+        });
     }
     get plugin() {
         return this._plugin;
     }
+    /** The sample rate used for time-to-sample conversions in tail estimation. */
+    get sampleRate() {
+        return this._sampleRate;
+    }
+    set sampleRate(rate) {
+        if (rate > 0 && rate !== this._sampleRate) {
+            this._sampleRate = rate;
+            // Re-estimate with the new sample rate.
+            this.updateLatencyFromPlugin();
+            this.updateTailFromPlugin();
+        }
+    }
     // Proxy active state to plugin bypass if supported
     set active(value) {
         super.active = value;
-        // Logic to bypass plugin in backend
+        // When bypassed, the processor introduces no latency or tail.
+        if (!value) {
+            this.setLatency(0);
+            this.setTailLength(0);
+        }
+        else {
+            this.updateLatencyFromPlugin();
+            this.updateTailFromPlugin();
+        }
+    }
+    get active() {
+        return super.active;
+    }
+    // ── Latency Estimation ──────────────────────────────────────────────────
+    /**
+     * Estimate latency (in samples) based on plugin name / type heuristics.
+     *
+     * Real-world plugins would report their exact latency; here we use
+     * conservative estimates for common processor categories:
+     *
+     * - Linear-phase EQ: ~512 samples (FIR filter latency)
+     * - Compressor / Limiter: ~64-256 samples (look-ahead)
+     * - De-esser: ~64 samples
+     * - Other effects / instruments / analyzers: 0
+     */
+    updateLatencyFromPlugin() {
+        if (!this.active)
+            return;
+        const nameLower = this._plugin.name.toLowerCase();
+        let latency = 0;
+        if (nameLower.includes('linear')) {
+            // Linear-phase EQ – significant FIR latency
+            latency = 512;
+        }
+        else if (nameLower.includes('comp') || nameLower.includes('limit')) {
+            // Compressor / Limiter – look-ahead buffer
+            // Scale with a "lookahead" parameter if available, otherwise default.
+            const lookaheadParam = this._plugin.getParameter('lookahead');
+            if (lookaheadParam) {
+                // Parameter value is a 0-1 normalised range; scale to 64-256 samples.
+                latency = Math.round(64 + lookaheadParam.value * (256 - 64));
+            }
+            else {
+                latency = 64;
+            }
+        }
+        else if (nameLower.includes('de-ess') || nameLower.includes('deess')) {
+            latency = 64;
+        }
+        this.setLatency(latency);
+    }
+    // ── Tail Time Estimation ────────────────────────────────────────────────
+    /**
+     * Estimate the tail length (in frames / samples) based on plugin name and
+     * parameter state.
+     *
+     * - Reverb / convolution: 2-5 seconds, scaled by decay / wet parameters.
+     * - Delay: delay-time * estimated feedback-loop count.
+     * - Everything else: 0.
+     */
+    updateTailFromPlugin() {
+        if (!this.active)
+            return;
+        const nameLower = this._plugin.name.toLowerCase();
+        let tailSeconds = 0;
+        if (nameLower.includes('reverb') || nameLower.includes('convol')) {
+            tailSeconds = this._estimateReverbTail();
+        }
+        else if (nameLower.includes('delay')) {
+            tailSeconds = this._estimateDelayTail();
+        }
+        const tailFrames = Math.ceil(tailSeconds * this._sampleRate);
+        this.setTailLength(tailFrames);
+    }
+    // ── Private helpers ─────────────────────────────────────────────────────
+    /**
+     * Estimate reverb tail between 2 and 5 seconds.
+     * Uses 'decay' or 'time' parameters for the base, and 'wet' / 'mix' to
+     * scale down when the effect is barely audible.
+     */
+    _estimateReverbTail() {
+        var _a, _b;
+        const baseTail = 2; // minimum tail in seconds
+        const maxTail = 5;
+        // Look for a decay / time parameter.
+        const decayParam = (_a = this._plugin.getParameter('decay')) !== null && _a !== void 0 ? _a : this._plugin.getParameter('time');
+        let tail;
+        if (decayParam) {
+            // Normalised 0-1 → 2-5 seconds.
+            const norm = (decayParam.value - decayParam.min) / (decayParam.max - decayParam.min || 1);
+            tail = baseTail + norm * (maxTail - baseTail);
+        }
+        else {
+            tail = baseTail;
+        }
+        // Scale by wet/mix level – if wet is near zero the audible tail is negligible.
+        const wetParam = (_b = this._plugin.getParameter('wet')) !== null && _b !== void 0 ? _b : this._plugin.getParameter('mix');
+        if (wetParam) {
+            const wetNorm = (wetParam.value - wetParam.min) / (wetParam.max - wetParam.min || 1);
+            tail *= wetNorm;
+        }
+        return tail;
+    }
+    /**
+     * Estimate delay tail based on delay-time and feedback.
+     *
+     * The effective tail is roughly `delayTime * loops` where loops is
+     * derived from the feedback amount:  loops ≈ log(threshold) / log(feedback).
+     * We cap at a sensible maximum (10 s).
+     */
+    _estimateDelayTail() {
+        var _a;
+        const MAX_TAIL = 10; // seconds
+        const timeParam = (_a = this._plugin.getParameter('time')) !== null && _a !== void 0 ? _a : this._plugin.getParameter('delay');
+        const feedbackParam = this._plugin.getParameter('feedback');
+        // Default delay time 0.5 s if not found.
+        let delayTime = 0.5;
+        if (timeParam) {
+            // Assume parameter value is already in seconds, or normalised 0-1 → 0-2 s.
+            if (timeParam.max <= 1) {
+                delayTime = timeParam.value * 2;
+            }
+            else {
+                delayTime = timeParam.value;
+            }
+        }
+        let loops = 1;
+        if (feedbackParam) {
+            const fbNorm = (feedbackParam.value - feedbackParam.min) / (feedbackParam.max - feedbackParam.min || 1);
+            const fb = Math.min(fbNorm, 0.99); // clamp to avoid infinite loops
+            if (fb > 0.01) {
+                // Number of iterations until signal drops below -60 dB.
+                const threshold = 0.001; // -60 dB
+                loops = Math.ceil(Math.log(threshold) / Math.log(fb));
+            }
+        }
+        return Math.min(delayTime * loops, MAX_TAIL);
+    }
+    /**
+     * Dispose of internal subscriptions.  Call when removing the insert from
+     * the processing chain.
+     */
+    dispose() {
+        this._parameterSubscription.dispose();
     }
 }
 //# sourceMappingURL=PluginInsert.js.map

package/dist/processing/PluginInsert.js.map

@@ -1 +1 @@
-{"version":3,"file":"PluginInsert.js","sourceRoot":"","sources":["../../src/processing/PluginInsert.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAGrD,MAAM,OAAO,YAAa,SAAQ,SAAS;IAGvC,YAAY,EAAe,EAAE,MAAc;QACvC,KAAK,CAAC,EAAE,EAAE,WAAW,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IAC1B,CAAC;IAED,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,mDAAmD;IACnD,IAAW,MAAM,CAAC,KAAc;QAC5B,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QACrB,oCAAoC;IACxC,CAAC;CACJ"}
+{"version":3,"file":"PluginInsert.js","sourceRoot":"","sources":["../../src/processing/PluginInsert.ts"],"names":[],"mappings":"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"}

package/dist/processing/PolarityProcessor.d.ts

@@ -4,7 +4,7 @@ import { Signal } from '../lib/Signal';
  * Phase inversion (polarity) processor.
  *
  * When inverted, all samples are multiplied by -1.  This is the standard
- * "phase flip" found on every DAW channel strip (Ardour: libs/ardour/polarity.cc).
+ * "phase flip" found on every DAW channel strip.
  *
  * Placed in the signal chain after the main fader and before post-fader plugins:
  *   Input -> Trim -> [Pre-fader] -> Fader -> Polarity -> [Post-fader] -> Panner -> Output

package/dist/processing/PolarityProcessor.js

@@ -4,7 +4,7 @@ import { Signal } from '../lib/Signal';
  * Phase inversion (polarity) processor.
  *
  * When inverted, all samples are multiplied by -1.  This is the standard
- * "phase flip" found on every DAW channel strip (Ardour: libs/ardour/polarity.cc).
+ * "phase flip" found on every DAW channel strip.
  *
  * Placed in the signal chain after the main fader and before post-fader plugins:
  *   Input -> Trim -> [Pre-fader] -> Fader -> Polarity -> [Post-fader] -> Panner -> Output

package/dist/processing/Processor.d.ts

@@ -12,10 +12,33 @@ export declare abstract class Processor {
         paramName: string;
         list: AutomationList;
     }>;
+    /**
+     * The number of frames of audio "tail" this processor produces after
+     * input ceases (e.g. reverb decay, delay feedback).  Used by the engine
+     * to know how long to keep processing after playback stops.
+     */
+    private _tailLength;
+    readonly tailLengthChanged: Signal<number>;
+    /**
+     * Processing latency in samples.  Subclasses that introduce latency
+     * (e.g. look-ahead limiters, linear-phase EQs) should call
+     * {@link setLatency} rather than overriding {@link getLatency}.
+     */
+    private _latency;
+    readonly latencyChanged: Signal<number>;
     constructor(id: ProcessorId, name: string);
     getAutomation(paramName: string): AutomationList;
     get active(): boolean;
     set active(value: boolean);
+    /**
+     * Returns the tail length in frames.
+     */
+    getTailLength(): number;
+    /**
+     * Set the tail length in frames.
+     * @param frames Number of frames (>= 0).
+     */
+    setTailLength(frames: number): void;
     /**
      * Returns the processing latency introduced by this processor, in samples.
      *
@@ -27,5 +50,20 @@ export declare abstract class Processor {
      * @returns Latency in samples (default 0).
      */
     getLatency(): number;
+    /**
+     * Set the processing latency in samples.
+     * @param samples Latency in samples (>= 0).
+     */
+    setLatency(samples: number): void;
+    /**
+     * Returns the effective tail length, which is the maximum of this
+     * processor's own tail length and any child processor tail lengths.
+     *
+     * Subclasses that contain child processors (e.g. processor chains,
+     * plugin wrappers) should override this to include their children.
+     *
+     * @returns Effective tail length in frames.
+     */
+    getEffectiveTailLength(): number;
 }
 //# sourceMappingURL=Processor.d.ts.map

package/dist/processing/Processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Processor.d.ts","sourceRoot":"","sources":["../../src/processing/Processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,8BAAsB,SAAS;IAC3B,SAAgB,EAAE,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IAGb,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IAE5D,SAAS,CAAC,OAAO,EAAE,OAAO,CAAQ;IAClC,SAAgB,aAAa,kBAAyB;IACtD,SAAgB,YAAY,eAAsB;IAClD,SAAgB,eAAe;mBAA2B,MAAM;cAAQ,cAAc;OAAM;gBAEhF,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM;IAKlC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc;IASvD,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,OAAO,EAK/B;IAED;;;;;;;;;OASG;IACI,UAAU,IAAI,MAAM;CAG9B"}
+{"version":3,"file":"Processor.d.ts","sourceRoot":"","sources":["../../src/processing/Processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,8BAAsB,SAAS;IAC3B,SAAgB,EAAE,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IAGb,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAa;IAE5D,SAAS,CAAC,OAAO,EAAE,OAAO,CAAQ;IAClC,SAAgB,aAAa,kBAAyB;IACtD,SAAgB,YAAY,eAAsB;IAClD,SAAgB,eAAe;mBAA2B,MAAM;cAAQ,cAAc;OAAM;IAG5F;;;;OAIG;IACH,OAAO,CAAC,WAAW,CAAa;IAChC,SAAgB,iBAAiB,iBAAwB;IAGzD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAa;IAC7B,SAAgB,cAAc,iBAAwB;gBAE1C,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM;IAKlC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc;IASvD,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,OAAO,EAK/B;IAID;;OAEG;IACI,aAAa,IAAI,MAAM;IAI9B;;;OAGG;IACI,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAU1C;;;;;;;;;OASG;IACI,UAAU,IAAI,MAAM;IAI3B;;;OAGG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUxC;;;;;;;;OAQG;IACI,sBAAsB,IAAI,MAAM;CAG1C"}

package/dist/processing/Processor.js

@@ -8,6 +8,22 @@ export class Processor {
         this.activeChanged = new Signal();
         this.stateChanged = new Signal();
         this.automationAdded = new Signal();
+        // ── Tail length ─────────────────────────────────────────────────────────
+        /**
+         * The number of frames of audio "tail" this processor produces after
+         * input ceases (e.g. reverb decay, delay feedback).  Used by the engine
+         * to know how long to keep processing after playback stops.
+         */
+        this._tailLength = 0;
+        this.tailLengthChanged = new Signal();
+        // ── Latency ─────────────────────────────────────────────────────────────
+        /**
+         * Processing latency in samples.  Subclasses that introduce latency
+         * (e.g. look-ahead limiters, linear-phase EQs) should call
+         * {@link setLatency} rather than overriding {@link getLatency}.
+         */
+        this._latency = 0;
+        this.latencyChanged = new Signal();
         this.id = id;
         this.name = name;
     }
@@ -28,6 +44,25 @@ export class Processor {
             this.activeChanged.emit(value);
         }
     }
+    // ── Tail length API ─────────────────────────────────────────────────────
+    /**
+     * Returns the tail length in frames.
+     */
+    getTailLength() {
+        return this._tailLength;
+    }
+    /**
+     * Set the tail length in frames.
+     * @param frames Number of frames (>= 0).
+     */
+    setTailLength(frames) {
+        const clamped = Math.max(0, frames);
+        if (this._tailLength !== clamped) {
+            this._tailLength = clamped;
+            this.tailLengthChanged.emit(clamped);
+        }
+    }
+    // ── Latency API ─────────────────────────────────────────────────────────
     /**
      * Returns the processing latency introduced by this processor, in samples.
      *
@@ -39,7 +74,31 @@ export class Processor {
      * @returns Latency in samples (default 0).
      */
     getLatency() {
-        return 0;
+        return this._latency;
+    }
+    /**
+     * Set the processing latency in samples.
+     * @param samples Latency in samples (>= 0).
+     */
+    setLatency(samples) {
+        const clamped = Math.max(0, samples);
+        if (this._latency !== clamped) {
+            this._latency = clamped;
+            this.latencyChanged.emit(clamped);
+        }
+    }
+    // ── Effective tail length ───────────────────────────────────────────────
+    /**
+     * Returns the effective tail length, which is the maximum of this
+     * processor's own tail length and any child processor tail lengths.
+     *
+     * Subclasses that contain child processors (e.g. processor chains,
+     * plugin wrappers) should override this to include their children.
+     *
+     * @returns Effective tail length in frames.
+     */
+    getEffectiveTailLength() {
+        return this._tailLength;
     }
 }
 //# sourceMappingURL=Processor.js.map

package/dist/processing/Processor.js.map

@@ -1 +1 @@
-{"version":3,"file":"Processor.js","sourceRoot":"","sources":["../../src/processing/Processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAI9D,MAAM,OAAgB,SAAS;IAY3B,YAAY,EAAe,EAAE,IAAY;QARzC,mCAAmC;QAC5B,gBAAW,GAAgC,IAAI,GAAG,EAAE,CAAC;QAElD,YAAO,GAAY,IAAI,CAAC;QAClB,kBAAa,GAAG,IAAI,MAAM,EAAW,CAAC;QACtC,iBAAY,GAAG,IAAI,MAAM,EAAQ,CAAC;QAClC,oBAAe,GAAG,IAAI,MAAM,EAA+C,CAAC;QAGxF,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,aAAa,CAAC,SAAiB;QAClC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,cAAc,EAAE,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;IAC5C,CAAC;IAED,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAW,MAAM,CAAC,KAAc;QAC5B,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACI,UAAU;QACb,OAAO,CAAC,CAAC;IACb,CAAC;CACJ"}
+{"version":3,"file":"Processor.js","sourceRoot":"","sources":["../../src/processing/Processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAI9D,MAAM,OAAgB,SAAS;IA8B3B,YAAY,EAAe,EAAE,IAAY;QA1BzC,mCAAmC;QAC5B,gBAAW,GAAgC,IAAI,GAAG,EAAE,CAAC;QAElD,YAAO,GAAY,IAAI,CAAC;QAClB,kBAAa,GAAG,IAAI,MAAM,EAAW,CAAC;QACtC,iBAAY,GAAG,IAAI,MAAM,EAAQ,CAAC;QAClC,oBAAe,GAAG,IAAI,MAAM,EAA+C,CAAC;QAE5F,2EAA2E;QAC3E;;;;WAIG;QACK,gBAAW,GAAW,CAAC,CAAC;QAChB,sBAAiB,GAAG,IAAI,MAAM,EAAU,CAAC;QAEzD,2EAA2E;QAC3E;;;;WAIG;QACK,aAAQ,GAAW,CAAC,CAAC;QACb,mBAAc,GAAG,IAAI,MAAM,EAAU,CAAC;QAGlD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,aAAa,CAAC,SAAiB;QAClC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,IAAI,cAAc,EAAE,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC;IAC5C,CAAC;IAED,IAAW,MAAM;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,IAAW,MAAM,CAAC,KAAc;QAC5B,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YACrB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;IACL,CAAC;IAED,2EAA2E;IAE3E;;OAEG;IACI,aAAa;QAChB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACI,aAAa,CAAC,MAAc;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;YAC/B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;YAC3B,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzC,CAAC;IACL,CAAC;IAED,2EAA2E;IAE3E;;;;;;;;;OASG;IACI,UAAU;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;OAGG;IACI,UAAU,CAAC,OAAe;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED,2EAA2E;IAE3E;;;;;;;;OAQG;IACI,sBAAsB;QACzB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;CACJ"}

package/dist/processing/SendProcessor.d.ts

@@ -4,7 +4,6 @@ import { MeterData } from '../domain/MeterData';
 /**
  * Send processor -- routes a copy of the signal to a destination track or bus.
  *
- * Modelled after Ardour's InternalSend / Send (libs/ardour/send.cc).
  * A send can be placed either pre-fader or post-fader in the processor chain.
  * It has its own independent level (in dB) and mute state.
  *

package/dist/processing/SendProcessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SendProcessor.d.ts","sourceRoot":"","sources":["../../src/processing/SendProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,SAAS;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAEhC,2CAA2C;IAC3C,SAAgB,YAAY,iBAAwB;IACpD,yDAAyD;IACzD,SAAgB,eAAe,kBAAyB;IACxD,2CAA2C;IAC3C,SAAgB,WAAW,kBAAyB;IAEpD;;;;;;OAMG;gBAEC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAU,EACjB,QAAQ,GAAE,OAAe,EACzB,QAAQ,GAAE,OAAe;IAW7B,wBAAwB;IACxB,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAM7B;IAID,kEAAkE;IAClE,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAMjC;IAID,uCAAuC;IACvC,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAID,qDAAqD;IACrD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAID,kCAAkC;IAClC,IAAW,KAAK,IAAI,OAAO,CAE1B;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,OAAO,EAM9B;IAID;;;;OAIG;IACI,YAAY,IAAI,SAAS;CAQnC"}
+{"version":3,"file":"SendProcessor.d.ts","sourceRoot":"","sources":["../../src/processing/SendProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD;;;;;;;;;GASG;AACH,qBAAa,aAAc,SAAQ,SAAS;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAEhC,2CAA2C;IAC3C,SAAgB,YAAY,iBAAwB;IACpD,yDAAyD;IACzD,SAAgB,eAAe,kBAAyB;IACxD,2CAA2C;IAC3C,SAAgB,WAAW,kBAAyB;IAEpD;;;;;;OAMG;gBAEC,EAAE,EAAE,WAAW,EACf,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAAU,EACjB,QAAQ,GAAE,OAAe,EACzB,QAAQ,GAAE,OAAe;IAW7B,wBAAwB;IACxB,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAM7B;IAID,kEAAkE;IAClE,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAMjC;IAID,uCAAuC;IACvC,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAID,qDAAqD;IACrD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAID,kCAAkC;IAClC,IAAW,KAAK,IAAI,OAAO,CAE1B;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,OAAO,EAM9B;IAID;;;;OAIG;IACI,YAAY,IAAI,SAAS;CAQnC"}

package/dist/processing/SendProcessor.js

@@ -3,7 +3,6 @@ import { Signal } from '../lib/Signal';
 /**
  * Send processor -- routes a copy of the signal to a destination track or bus.
  *
- * Modelled after Ardour's InternalSend / Send (libs/ardour/send.cc).
  * A send can be placed either pre-fader or post-fader in the processor chain.
  * It has its own independent level (in dB) and mute state.
  *

package/dist/processing/SendProcessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"SendProcessor.js","sourceRoot":"","sources":["../../src/processing/SendProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAcxC;;;;;;OAMG;IACH,YACI,EAAe,EACf,QAAgB,EAChB,QAAgB,CAAC,EACjB,WAAoB,KAAK,EACzB,WAAoB,KAAK;QAEzB,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAvBd,WAAM,GAAY,KAAK,CAAC;QAEhC,2CAA2C;QAC3B,iBAAY,GAAG,IAAI,MAAM,EAAU,CAAC;QACpD,yDAAyD;QACzC,oBAAe,GAAG,IAAI,MAAM,EAAW,CAAC;QACxD,2CAA2C;QAC3B,gBAAW,GAAG,IAAI,MAAM,EAAW,CAAC;QAiBhD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED,4EAA4E;IAE5E,wBAAwB;IACxB,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAW,KAAK,CAAC,KAAa;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,4EAA4E;IAE5E,kEAAkE;IAClE,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,IAAW,QAAQ,CAAC,KAAc;QAC9B,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,4EAA4E;IAE5E,uCAAuC;IACvC,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAE5E,qDAAqD;IACrD,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAE5E,kCAAkC;IAClC,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAW,KAAK,CAAC,KAAc;QAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,4EAA4E;IAE5E;;;;OAIG;IACI,YAAY;QACf,OAAO;YACH,IAAI,EAAE,CAAC,QAAQ;YACf,GAAG,EAAE,CAAC,QAAQ;YACd,QAAQ,EAAE,CAAC,QAAQ;YACnB,QAAQ,EAAE,KAAK;SAClB,CAAC;IACN,CAAC;CACJ"}
+{"version":3,"file":"SendProcessor.js","sourceRoot":"","sources":["../../src/processing/SendProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC;;;;;;;;;GASG;AACH,MAAM,OAAO,aAAc,SAAQ,SAAS;IAcxC;;;;;;OAMG;IACH,YACI,EAAe,EACf,QAAgB,EAChB,QAAgB,CAAC,EACjB,WAAoB,KAAK,EACzB,WAAoB,KAAK;QAEzB,KAAK,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAvBd,WAAM,GAAY,KAAK,CAAC;QAEhC,2CAA2C;QAC3B,iBAAY,GAAG,IAAI,MAAM,EAAU,CAAC;QACpD,yDAAyD;QACzC,oBAAe,GAAG,IAAI,MAAM,EAAW,CAAC;QACxD,2CAA2C;QAC3B,gBAAW,GAAG,IAAI,MAAM,EAAW,CAAC;QAiBhD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;IAED,4EAA4E;IAE5E,wBAAwB;IACxB,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAW,KAAK,CAAC,KAAa;QAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9B,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,4EAA4E;IAE5E,kEAAkE;IAClE,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,IAAW,QAAQ,CAAC,KAAc;QAC9B,IAAI,IAAI,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,4EAA4E;IAE5E,uCAAuC;IACvC,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAE5E,qDAAqD;IACrD,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,4EAA4E;IAE5E,kCAAkC;IAClC,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAED,IAAW,KAAK,CAAC,KAAc;QAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YACpB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;IAED,4EAA4E;IAE5E;;;;OAIG;IACI,YAAY;QACf,OAAO;YACH,IAAI,EAAE,CAAC,QAAQ;YACf,GAAG,EAAE,CAAC,QAAQ;YACd,QAAQ,EAAE,CAAC,QAAQ;YACnB,QAAQ,EAAE,KAAK;SAClB,CAAC;IACN,CAAC;CACJ"}

package/dist/processing/SurroundPanner.d.ts

@@ -0,0 +1,120 @@
+import { Processor, ProcessorId } from './Processor';
+import { Signal } from '../lib/Signal';
+/**
+ * SurroundPanner supports multichannel panning beyond stereo.
+ *
+ * Supported layouts:
+ * - Stereo (2.0): L, R
+ * - Quad (4.0): FL, FR, RL, RR
+ * - 5.1: FL, FR, C, LFE, RL, RR
+ * - 7.1: FL, FR, C, LFE, RL, RR, SL, SR
+ * - Atmos/3D: adds height channels
+ *
+ * Uses VBAP (Vector Base Amplitude Panning) algorithm for
+ * arbitrary speaker configurations.
+ */
+export declare enum SpeakerLayout {
+    STEREO = "STEREO",
+    QUAD = "QUAD",
+    SURROUND_5_1 = "5.1",
+    SURROUND_7_1 = "7.1"
+}
+export interface SpeakerPosition {
+    azimuth: number;
+    elevation: number;
+    distance: number;
+    label: string;
+}
+export interface SurroundPannerSnapshot {
+    id: ProcessorId;
+    name: string;
+    azimuth: number;
+    elevation: number;
+    spread: number;
+    lfeLevel: number;
+    layout: SpeakerLayout;
+    active: boolean;
+}
+export declare class SurroundPanner extends Processor {
+    private _azimuth;
+    private _elevation;
+    private _spread;
+    private _lfeLevel;
+    private _layout;
+    private _speakers;
+    private _gains;
+    readonly positionChanged: Signal<{
+        azimuth: number;
+        elevation: number;
+    }>;
+    readonly layoutChanged: Signal<SpeakerLayout>;
+    constructor(id: ProcessorId, layout?: SpeakerLayout);
+    /**
+     * Set the source position.
+     * @param azimuth  Horizontal angle in degrees (-180 to 180).
+     * @param elevation Vertical angle in degrees (-90 to 90). Defaults to current.
+     */
+    setPosition(azimuth: number, elevation?: number): void;
+    /**
+     * Set the source spread.
+     * @param spread 0 = point source, 1 = omnidirectional.
+     */
+    setSpread(spread: number): void;
+    /**
+     * Set the LFE send level.
+     * @param level 0 to 1.
+     */
+    setLFELevel(level: number): void;
+    get azimuth(): number;
+    get elevation(): number;
+    get spread(): number;
+    get lfeLevel(): number;
+    /**
+     * Set the speaker layout. Recomputes speaker positions and gains.
+     */
+    setLayout(layout: SpeakerLayout): void;
+    get layout(): SpeakerLayout;
+    /** Number of output channels for the current layout. */
+    get channelCount(): number;
+    /** Speaker positions for the current layout. */
+    get speakers(): ReadonlyArray<SpeakerPosition>;
+    /**
+     * Compute per-channel gains based on the current source position,
+     * spread, and layout using VBAP.
+     *
+     * @returns Float32Array of linear gains, one per speaker/channel.
+     */
+    computeGains(): Float32Array;
+    /**
+     * 2D VBAP: Vector Base Amplitude Panning in the horizontal plane.
+     *
+     * For each adjacent speaker pair, computes the amplitude split
+     * based on the angular position of the source relative to both speakers.
+     *
+     * @param azimuth Source azimuth in degrees (-180 to 180).
+     */
+    private vbap2D;
+    /**
+     * 3D VBAP: Vector Base Amplitude Panning with elevation.
+     *
+     * Extends 2D VBAP by considering the vertical angle to distribute
+     * energy across speakers at different elevations.
+     *
+     * @param azimuth Source azimuth in degrees.
+     * @param elevation Source elevation in degrees.
+     */
+    private vbap3D;
+    /**
+     * Setup default speaker positions for a given layout.
+     * Angles follow the ITU-R BS.775 and ITU-R BS.2051 standards.
+     */
+    private setupSpeakers;
+    /**
+     * Get the index of the LFE channel in the current layout.
+     * Returns -1 if the layout has no LFE channel.
+     */
+    private getLFEChannelIndex;
+    toJSON(): SurroundPannerSnapshot;
+    static fromJSON(data: SurroundPannerSnapshot): SurroundPanner;
+}
+//# sourceMappingURL=SurroundPanner.d.ts.map

package/dist/processing/SurroundPanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurroundPanner.d.ts","sourceRoot":"","sources":["../../src/processing/SurroundPanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC;;;;;;;;;;;;GAYG;AAEH,oBAAY,aAAa;IACrB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,YAAY,QAAQ;IACpB,YAAY,QAAQ;CACvB;AAED,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,cAAe,SAAQ,SAAS;IACzC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,MAAM,CAAqC;IAEnD,SAAgB,eAAe;iBAAyB,MAAM;mBAAa,MAAM;OAAM;IACvF,SAAgB,aAAa,wBAA+B;gBAEhD,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,aAAa;IAWnD;;;;OAIG;IACI,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAe7D;;;OAGG;IACI,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAStC;;;OAGG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQvC,IAAW,OAAO,IAAI,MAAM,CAA0B;IACtD,IAAW,SAAS,IAAI,MAAM,CAA4B;IAC1D,IAAW,MAAM,IAAI,MAAM,CAAyB;IACpD,IAAW,QAAQ,IAAI,MAAM,CAA2B;IAIxD;;OAEG;IACI,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAW7C,IAAW,MAAM,IAAI,aAAa,CAAyB;IAE3D,wDAAwD;IACxD,IAAW,YAAY,IAAI,MAAM,CAAkC;IAEnE,gDAAgD;IAChD,IAAW,QAAQ,IAAI,aAAa,CAAC,eAAe,CAAC,CAA2B;IAIhF;;;;;OAKG;IACI,YAAY,IAAI,YAAY;IAiCnC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM;IAwFd;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM;IAsEd;;;OAGG;IACH,OAAO,CAAC,aAAa;IA8CrB;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAMnB,MAAM,IAAI,sBAAsB;WAazB,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,cAAc;CAWvE"}