@drop-ai/core 0.2.0

package/dist/plugins/impl/PhaserPlugin.d.ts

@@ -0,0 +1,29 @@
+import { Plugin, PluginId, PluginType, PluginParameter, ParameterId } from '../Plugin';
+import { Signal } from '../../lib/Signal';
+/**
+ * Phaser modulation effect plugin.
+ *
+ * Parameters:
+ *  - rate:          LFO speed (0.1 – 10 Hz)
+ *  - depth:         modulation depth (0 – 1)
+ *  - baseFrequency: centre frequency of the allpass chain (200 – 5000 Hz)
+ *  - wet:           dry/wet mix (0 – 1)
+ */
+export declare class PhaserPlugin implements Plugin {
+    readonly id: PluginId;
+    name: string;
+    readonly type: PluginType;
+    readonly parameterChanged: Signal<{
+        id: ParameterId;
+        value: number;
+    }>;
+    private parameters;
+    constructor(id: PluginId, name: string, type: PluginType);
+    addParameter(param: PluginParameter): void;
+    getParameters(): ReadonlyArray<PluginParameter>;
+    getParameter(id: ParameterId): PluginParameter | undefined;
+    setParameter(id: ParameterId, value: number): void;
+    getState(): Record<string, number>;
+    setState(state: Record<string, number>): void;
+}
+//# sourceMappingURL=PhaserPlugin.d.ts.map

package/dist/plugins/impl/PhaserPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhaserPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/impl/PhaserPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;;;;GAQG;AACH,qBAAa,YAAa,YAAW,MAAM;IACvC,SAAgB,EAAE,EAAE,QAAQ,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACpB,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC,SAAgB,gBAAgB;YAAoB,WAAW;eAAS,MAAM;OAAM;IAEpF,OAAO,CAAC,UAAU,CAAgD;gBAEtD,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU;IAWjD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI1C,aAAa,IAAI,aAAa,CAAC,eAAe,CAAC;IAI/C,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS;IAI1D,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQlD,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMlC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAKvD"}

package/dist/plugins/impl/PhaserPlugin.js

@@ -0,0 +1,50 @@
+import { Signal } from '../../lib/Signal';
+/**
+ * Phaser modulation effect plugin.
+ *
+ * Parameters:
+ *  - rate:          LFO speed (0.1 – 10 Hz)
+ *  - depth:         modulation depth (0 – 1)
+ *  - baseFrequency: centre frequency of the allpass chain (200 – 5000 Hz)
+ *  - wet:           dry/wet mix (0 – 1)
+ */
+export class PhaserPlugin {
+    constructor(id, name, type) {
+        this.parameterChanged = new Signal();
+        this.parameters = new Map();
+        this.id = id;
+        this.name = name;
+        this.type = type;
+        this.addParameter({ id: 'rate', name: 'Rate', value: 1.0, min: 0.1, max: 10, step: 0.1 });
+        this.addParameter({ id: 'depth', name: 'Depth', value: 0.5, min: 0, max: 1, step: 0.01 });
+        this.addParameter({ id: 'baseFrequency', name: 'Base Frequency', value: 1000, min: 200, max: 5000, step: 1 });
+        this.addParameter({ id: 'wet', name: 'Wet', value: 0.5, min: 0, max: 1, step: 0.01 });
+    }
+    addParameter(param) {
+        this.parameters.set(param.id, param);
+    }
+    getParameters() {
+        return Array.from(this.parameters.values());
+    }
+    getParameter(id) {
+        return this.parameters.get(id);
+    }
+    setParameter(id, value) {
+        const param = this.parameters.get(id);
+        if (param) {
+            param.value = Math.max(param.min, Math.min(param.max, value));
+            this.parameterChanged.emit({ id, value: param.value });
+        }
+    }
+    getState() {
+        const state = {};
+        this.parameters.forEach((p, k) => (state[k] = p.value));
+        return state;
+    }
+    setState(state) {
+        for (const key in state) {
+            this.setParameter(key, state[key]);
+        }
+    }
+}
+//# sourceMappingURL=PhaserPlugin.js.map

package/dist/plugins/impl/PhaserPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhaserPlugin.js","sourceRoot":"","sources":["../../../src/plugins/impl/PhaserPlugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,OAAO,YAAY;IASrB,YAAY,EAAY,EAAE,IAAY,EAAE,IAAgB;QAJxC,qBAAgB,GAAG,IAAI,MAAM,EAAsC,CAAC;QAE5E,eAAU,GAAsC,IAAI,GAAG,EAAE,CAAC;QAG9D,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9G,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC;IAEM,YAAY,CAAC,KAAsB;QACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAEM,aAAa;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAEM,YAAY,CAAC,EAAe;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAEM,YAAY,CAAC,EAAe,EAAE,KAAa;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACR,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC;IAEM,QAAQ;QACX,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACjB,CAAC;IAEM,QAAQ,CAAC,KAA6B;QACzC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;CACJ"}

package/dist/plugins/impl/SyncDelayPlugin.d.ts

@@ -0,0 +1,52 @@
+import { Plugin, PluginId, PluginType, PluginParameter, ParameterId } from '../Plugin';
+import { Signal } from '../../lib/Signal';
+/**
+ * Tempo-sync delay effect plugin.
+ *
+ * When sync is enabled (sync = 1), the effective delay time is calculated from BPM
+ * and the selected note divisor:
+ *   delayTime = (60 / bpm) * divisorValue
+ *
+ * Divisor mapping:
+ *   0 = 1/4 note  (1.0)
+ *   1 = 1/8 note  (0.5)
+ *   2 = 1/16 note (0.25)
+ *   3 = dotted    (base * 1.5)  – uses 1/8 as base
+ *   4 = triplet   (base * 2/3)  – uses 1/4 as base
+ *
+ * When sync is off (sync = 0), the raw delayTime parameter is used.
+ *
+ * Parameters:
+ *  - sync:      tempo sync toggle (0 = off, 1 = on)
+ *  - divisor:   note value selector (0–4, see mapping above)
+ *  - feedback:  feedback amount (0 – 0.95)
+ *  - lpf:       low-pass filter cutoff in the feedback path (200 – 20000 Hz)
+ *  - wet:       dry/wet mix (0 – 1)
+ *  - delayTime: manual delay time in seconds (0.01 – 2.0, used when sync = off)
+ */
+export declare class SyncDelayPlugin implements Plugin {
+    readonly id: PluginId;
+    name: string;
+    readonly type: PluginType;
+    readonly parameterChanged: Signal<{
+        id: ParameterId;
+        value: number;
+    }>;
+    private parameters;
+    constructor(id: PluginId, name: string, type: PluginType);
+    /**
+     * Get the divisor multiplier for the currently selected divisor value.
+     */
+    static divisorMultiplier(divisor: number): number;
+    /**
+     * Compute the effective delay time in seconds.
+     */
+    getEffectiveDelayTime(bpm: number): number;
+    addParameter(param: PluginParameter): void;
+    getParameters(): ReadonlyArray<PluginParameter>;
+    getParameter(id: ParameterId): PluginParameter | undefined;
+    setParameter(id: ParameterId, value: number): void;
+    getState(): Record<string, number>;
+    setState(state: Record<string, number>): void;
+}
+//# sourceMappingURL=SyncDelayPlugin.d.ts.map

package/dist/plugins/impl/SyncDelayPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncDelayPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/impl/SyncDelayPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAgB,YAAW,MAAM;IAC1C,SAAgB,EAAE,EAAE,QAAQ,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACpB,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC,SAAgB,gBAAgB;YAAoB,WAAW;eAAS,MAAM;OAAM;IAEpF,OAAO,CAAC,UAAU,CAAgD;gBAEtD,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU;IAexD;;OAEG;WACW,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAWxD;;OAEG;IACI,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAY1C,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI1C,aAAa,IAAI,aAAa,CAAC,eAAe,CAAC;IAI/C,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS;IAI1D,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQlD,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMlC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAKvD"}

package/dist/plugins/impl/SyncDelayPlugin.js

@@ -0,0 +1,95 @@
+import { Signal } from '../../lib/Signal';
+/**
+ * Tempo-sync delay effect plugin.
+ *
+ * When sync is enabled (sync = 1), the effective delay time is calculated from BPM
+ * and the selected note divisor:
+ *   delayTime = (60 / bpm) * divisorValue
+ *
+ * Divisor mapping:
+ *   0 = 1/4 note  (1.0)
+ *   1 = 1/8 note  (0.5)
+ *   2 = 1/16 note (0.25)
+ *   3 = dotted    (base * 1.5)  – uses 1/8 as base
+ *   4 = triplet   (base * 2/3)  – uses 1/4 as base
+ *
+ * When sync is off (sync = 0), the raw delayTime parameter is used.
+ *
+ * Parameters:
+ *  - sync:      tempo sync toggle (0 = off, 1 = on)
+ *  - divisor:   note value selector (0–4, see mapping above)
+ *  - feedback:  feedback amount (0 – 0.95)
+ *  - lpf:       low-pass filter cutoff in the feedback path (200 – 20000 Hz)
+ *  - wet:       dry/wet mix (0 – 1)
+ *  - delayTime: manual delay time in seconds (0.01 – 2.0, used when sync = off)
+ */
+export class SyncDelayPlugin {
+    constructor(id, name, type) {
+        this.parameterChanged = new Signal();
+        this.parameters = new Map();
+        this.id = id;
+        this.name = name;
+        this.type = type;
+        this.addParameter({ id: 'sync', name: 'Sync', value: 1, min: 0, max: 1, step: 1 });
+        this.addParameter({ id: 'divisor', name: 'Divisor', value: 0, min: 0, max: 4, step: 1 });
+        this.addParameter({ id: 'feedback', name: 'Feedback', value: 0.35, min: 0, max: 0.95, step: 0.01 });
+        this.addParameter({ id: 'lpf', name: 'LPF', value: 8000, min: 200, max: 20000, step: 1 });
+        this.addParameter({ id: 'wet', name: 'Wet', value: 0.4, min: 0, max: 1, step: 0.01 });
+        this.addParameter({ id: 'delayTime', name: 'Delay Time', value: 0.5, min: 0.01, max: 2.0, step: 0.01 });
+    }
+    // ── Tempo helpers ──────────────────────────────────────────────────────────
+    /**
+     * Get the divisor multiplier for the currently selected divisor value.
+     */
+    static divisorMultiplier(divisor) {
+        switch (Math.round(divisor)) {
+            case 0: return 1.0; // 1/4
+            case 1: return 0.5; // 1/8
+            case 2: return 0.25; // 1/16
+            case 3: return 0.5 * 1.5; // dotted 1/8
+            case 4: return 1.0 * (2 / 3); // triplet 1/4
+            default: return 1.0;
+        }
+    }
+    /**
+     * Compute the effective delay time in seconds.
+     */
+    getEffectiveDelayTime(bpm) {
+        var _a, _b, _c, _d, _e, _f;
+        const sync = (_b = (_a = this.getParameter('sync')) === null || _a === void 0 ? void 0 : _a.value) !== null && _b !== void 0 ? _b : 0;
+        if (sync < 0.5) {
+            return (_d = (_c = this.getParameter('delayTime')) === null || _c === void 0 ? void 0 : _c.value) !== null && _d !== void 0 ? _d : 0.5;
+        }
+        const divisor = (_f = (_e = this.getParameter('divisor')) === null || _e === void 0 ? void 0 : _e.value) !== null && _f !== void 0 ? _f : 0;
+        const quarterNote = 60 / bpm;
+        return quarterNote * SyncDelayPlugin.divisorMultiplier(divisor);
+    }
+    // ── Plugin interface ───────────────────────────────────────────────────────
+    addParameter(param) {
+        this.parameters.set(param.id, param);
+    }
+    getParameters() {
+        return Array.from(this.parameters.values());
+    }
+    getParameter(id) {
+        return this.parameters.get(id);
+    }
+    setParameter(id, value) {
+        const param = this.parameters.get(id);
+        if (param) {
+            param.value = Math.max(param.min, Math.min(param.max, value));
+            this.parameterChanged.emit({ id, value: param.value });
+        }
+    }
+    getState() {
+        const state = {};
+        this.parameters.forEach((p, k) => (state[k] = p.value));
+        return state;
+    }
+    setState(state) {
+        for (const key in state) {
+            this.setParameter(key, state[key]);
+        }
+    }
+}
+//# sourceMappingURL=SyncDelayPlugin.js.map

package/dist/plugins/impl/SyncDelayPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncDelayPlugin.js","sourceRoot":"","sources":["../../../src/plugins/impl/SyncDelayPlugin.ts"],"names":[],"mappings":"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"}

package/dist/plugins/impl/TapeSaturationPlugin.d.ts

@@ -0,0 +1,35 @@
+import { Plugin, PluginId, PluginType, PluginParameter, ParameterId } from '../Plugin';
+import { Signal } from '../../lib/Signal';
+/**
+ * Tape Saturation Plugin (I-3)
+ *
+ * Emulates the warm, non-linear characteristics of analog tape recording.
+ * Uses a WaveShaperNode concept with soft clipping and high-frequency rolloff.
+ *
+ * Parameters:
+ * - drive: Input gain / saturation amount (0-1)
+ * - warmth: High-frequency rolloff amount (0-1), simulates tape head response
+ * - saturation: Harmonic saturation intensity (0-1), controls the clipping curve
+ * - wet: Dry/wet mix (0-1)
+ *
+ * Registered as: internal-tape-sat
+ */
+export declare class TapeSaturationPlugin implements Plugin {
+    readonly id: PluginId;
+    name: string;
+    readonly type: PluginType;
+    readonly parameterChanged: Signal<{
+        id: ParameterId;
+        value: number;
+    }>;
+    private parameters;
+    constructor(id: PluginId, name?: string, type?: PluginType);
+    private initParameters;
+    addParameter(param: PluginParameter): void;
+    getParameters(): ReadonlyArray<PluginParameter>;
+    getParameter(id: ParameterId): PluginParameter | undefined;
+    setParameter(id: ParameterId, value: number): void;
+    getState(): Record<string, number>;
+    setState(state: Record<string, number>): void;
+}
+//# sourceMappingURL=TapeSaturationPlugin.d.ts.map

package/dist/plugins/impl/TapeSaturationPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TapeSaturationPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/impl/TapeSaturationPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,YAAW,MAAM;IAC/C,SAAgB,EAAE,EAAE,QAAQ,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACpB,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC,SAAgB,gBAAgB;YAAoB,WAAW;eAAS,MAAM;OAAM;IAEpF,OAAO,CAAC,UAAU,CAAgD;gBAEtD,EAAE,EAAE,QAAQ,EAAE,IAAI,GAAE,MAA0B,EAAE,IAAI,GAAE,UAA8B;IAQhG,OAAO,CAAC,cAAc;IAmCf,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI1C,aAAa,IAAI,aAAa,CAAC,eAAe,CAAC;IAI/C,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS;IAI1D,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQlD,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMlC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAKvD"}

package/dist/plugins/impl/TapeSaturationPlugin.js

@@ -0,0 +1,87 @@
+import { PluginType } from '../Plugin';
+import { Signal } from '../../lib/Signal';
+/**
+ * Tape Saturation Plugin (I-3)
+ *
+ * Emulates the warm, non-linear characteristics of analog tape recording.
+ * Uses a WaveShaperNode concept with soft clipping and high-frequency rolloff.
+ *
+ * Parameters:
+ * - drive: Input gain / saturation amount (0-1)
+ * - warmth: High-frequency rolloff amount (0-1), simulates tape head response
+ * - saturation: Harmonic saturation intensity (0-1), controls the clipping curve
+ * - wet: Dry/wet mix (0-1)
+ *
+ * Registered as: internal-tape-sat
+ */
+export class TapeSaturationPlugin {
+    constructor(id, name = 'Tape Saturation', type = PluginType.EFFECT) {
+        this.parameterChanged = new Signal();
+        this.parameters = new Map();
+        this.id = id;
+        this.name = name;
+        this.type = type;
+        this.initParameters();
+    }
+    initParameters() {
+        this.addParameter({
+            id: 'drive',
+            name: 'Drive',
+            value: 0.3,
+            min: 0,
+            max: 1,
+            step: 0.01,
+        });
+        this.addParameter({
+            id: 'warmth',
+            name: 'Warmth',
+            value: 0.4,
+            min: 0,
+            max: 1,
+            step: 0.01,
+        });
+        this.addParameter({
+            id: 'saturation',
+            name: 'Saturation',
+            value: 0.3,
+            min: 0,
+            max: 1,
+            step: 0.01,
+        });
+        this.addParameter({
+            id: 'wet',
+            name: 'Wet',
+            value: 0.5,
+            min: 0,
+            max: 1,
+            step: 0.01,
+        });
+    }
+    addParameter(param) {
+        this.parameters.set(param.id, param);
+    }
+    getParameters() {
+        return Array.from(this.parameters.values());
+    }
+    getParameter(id) {
+        return this.parameters.get(id);
+    }
+    setParameter(id, value) {
+        const param = this.parameters.get(id);
+        if (param) {
+            param.value = Math.max(param.min, Math.min(param.max, value));
+            this.parameterChanged.emit({ id, value: param.value });
+        }
+    }
+    getState() {
+        const state = {};
+        this.parameters.forEach((p, k) => (state[k] = p.value));
+        return state;
+    }
+    setState(state) {
+        for (const key in state) {
+            this.setParameter(key, state[key]);
+        }
+    }
+}
+//# sourceMappingURL=TapeSaturationPlugin.js.map

package/dist/plugins/impl/TapeSaturationPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TapeSaturationPlugin.js","sourceRoot":"","sources":["../../../src/plugins/impl/TapeSaturationPlugin.ts"],"names":[],"mappings":"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"}

package/dist/plugins/impl/TremoloPlugin.d.ts

@@ -0,0 +1,29 @@
+import { Plugin, PluginId, PluginType, PluginParameter, ParameterId } from '../Plugin';
+import { Signal } from '../../lib/Signal';
+/**
+ * Tremolo modulation effect plugin.
+ *
+ * Parameters:
+ *  - rate:  LFO speed (0.1 – 20 Hz)
+ *  - depth: modulation depth (0 – 1)
+ *  - type:  LFO waveform (0 = sine, 1 = square, 2 = triangle)
+ *  - wet:   dry/wet mix (0 – 1)
+ */
+export declare class TremoloPlugin implements Plugin {
+    readonly id: PluginId;
+    name: string;
+    readonly type: PluginType;
+    readonly parameterChanged: Signal<{
+        id: ParameterId;
+        value: number;
+    }>;
+    private parameters;
+    constructor(id: PluginId, name: string, type: PluginType);
+    addParameter(param: PluginParameter): void;
+    getParameters(): ReadonlyArray<PluginParameter>;
+    getParameter(id: ParameterId): PluginParameter | undefined;
+    setParameter(id: ParameterId, value: number): void;
+    getState(): Record<string, number>;
+    setState(state: Record<string, number>): void;
+}
+//# sourceMappingURL=TremoloPlugin.d.ts.map

package/dist/plugins/impl/TremoloPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TremoloPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/impl/TremoloPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,MAAM;IACxC,SAAgB,EAAE,EAAE,QAAQ,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACpB,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC,SAAgB,gBAAgB;YAAoB,WAAW;eAAS,MAAM;OAAM;IAEpF,OAAO,CAAC,UAAU,CAAgD;gBAEtD,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU;IAWjD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI1C,aAAa,IAAI,aAAa,CAAC,eAAe,CAAC;IAI/C,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS;IAI1D,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQlD,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMlC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAKvD"}

package/dist/plugins/impl/TremoloPlugin.js

@@ -0,0 +1,50 @@
+import { Signal } from '../../lib/Signal';
+/**
+ * Tremolo modulation effect plugin.
+ *
+ * Parameters:
+ *  - rate:  LFO speed (0.1 – 20 Hz)
+ *  - depth: modulation depth (0 – 1)
+ *  - type:  LFO waveform (0 = sine, 1 = square, 2 = triangle)
+ *  - wet:   dry/wet mix (0 – 1)
+ */
+export class TremoloPlugin {
+    constructor(id, name, type) {
+        this.parameterChanged = new Signal();
+        this.parameters = new Map();
+        this.id = id;
+        this.name = name;
+        this.type = type;
+        this.addParameter({ id: 'rate', name: 'Rate', value: 4.0, min: 0.1, max: 20, step: 0.1 });
+        this.addParameter({ id: 'depth', name: 'Depth', value: 0.5, min: 0, max: 1, step: 0.01 });
+        this.addParameter({ id: 'type', name: 'Type', value: 0, min: 0, max: 2, step: 1 });
+        this.addParameter({ id: 'wet', name: 'Wet', value: 1.0, min: 0, max: 1, step: 0.01 });
+    }
+    addParameter(param) {
+        this.parameters.set(param.id, param);
+    }
+    getParameters() {
+        return Array.from(this.parameters.values());
+    }
+    getParameter(id) {
+        return this.parameters.get(id);
+    }
+    setParameter(id, value) {
+        const param = this.parameters.get(id);
+        if (param) {
+            param.value = Math.max(param.min, Math.min(param.max, value));
+            this.parameterChanged.emit({ id, value: param.value });
+        }
+    }
+    getState() {
+        const state = {};
+        this.parameters.forEach((p, k) => (state[k] = p.value));
+        return state;
+    }
+    setState(state) {
+        for (const key in state) {
+            this.setParameter(key, state[key]);
+        }
+    }
+}
+//# sourceMappingURL=TremoloPlugin.js.map

package/dist/plugins/impl/TremoloPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TremoloPlugin.js","sourceRoot":"","sources":["../../../src/plugins/impl/TremoloPlugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,OAAO,aAAa;IAStB,YAAY,EAAY,EAAE,IAAY,EAAE,IAAgB;QAJxC,qBAAgB,GAAG,IAAI,MAAM,EAAsC,CAAC;QAE5E,eAAU,GAAsC,IAAI,GAAG,EAAE,CAAC;QAG9D,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC;IAEM,YAAY,CAAC,KAAsB;QACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAEM,aAAa;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAEM,YAAY,CAAC,EAAe;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAEM,YAAY,CAAC,EAAe,EAAE,KAAa;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACR,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC;IAEM,QAAQ;QACX,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACjB,CAAC;IAEM,QAAQ,CAAC,KAA6B;QACzC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;CACJ"}

package/dist/plugins/impl/VibratoPlugin.d.ts

@@ -0,0 +1,28 @@
+import { Plugin, PluginId, PluginType, PluginParameter, ParameterId } from '../Plugin';
+import { Signal } from '../../lib/Signal';
+/**
+ * Vibrato modulation effect plugin.
+ *
+ * Parameters:
+ *  - rate:  LFO speed (0.1 – 10 Hz)
+ *  - depth: modulation depth (0 – 1)
+ *  - wet:   dry/wet mix (0 – 1)
+ */
+export declare class VibratoPlugin implements Plugin {
+    readonly id: PluginId;
+    name: string;
+    readonly type: PluginType;
+    readonly parameterChanged: Signal<{
+        id: ParameterId;
+        value: number;
+    }>;
+    private parameters;
+    constructor(id: PluginId, name: string, type: PluginType);
+    addParameter(param: PluginParameter): void;
+    getParameters(): ReadonlyArray<PluginParameter>;
+    getParameter(id: ParameterId): PluginParameter | undefined;
+    setParameter(id: ParameterId, value: number): void;
+    getState(): Record<string, number>;
+    setState(state: Record<string, number>): void;
+}
+//# sourceMappingURL=VibratoPlugin.d.ts.map

package/dist/plugins/impl/VibratoPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VibratoPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/impl/VibratoPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;;;GAOG;AACH,qBAAa,aAAc,YAAW,MAAM;IACxC,SAAgB,EAAE,EAAE,QAAQ,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACpB,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC,SAAgB,gBAAgB;YAAoB,WAAW;eAAS,MAAM;OAAM;IAEpF,OAAO,CAAC,UAAU,CAAgD;gBAEtD,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU;IAUjD,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAI1C,aAAa,IAAI,aAAa,CAAC,eAAe,CAAC;IAI/C,YAAY,CAAC,EAAE,EAAE,WAAW,GAAG,eAAe,GAAG,SAAS;IAI1D,YAAY,CAAC,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQlD,QAAQ,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAMlC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAKvD"}

package/dist/plugins/impl/VibratoPlugin.js

@@ -0,0 +1,48 @@
+import { Signal } from '../../lib/Signal';
+/**
+ * Vibrato modulation effect plugin.
+ *
+ * Parameters:
+ *  - rate:  LFO speed (0.1 – 10 Hz)
+ *  - depth: modulation depth (0 – 1)
+ *  - wet:   dry/wet mix (0 – 1)
+ */
+export class VibratoPlugin {
+    constructor(id, name, type) {
+        this.parameterChanged = new Signal();
+        this.parameters = new Map();
+        this.id = id;
+        this.name = name;
+        this.type = type;
+        this.addParameter({ id: 'rate', name: 'Rate', value: 5.0, min: 0.1, max: 10, step: 0.1 });
+        this.addParameter({ id: 'depth', name: 'Depth', value: 0.3, min: 0, max: 1, step: 0.01 });
+        this.addParameter({ id: 'wet', name: 'Wet', value: 1.0, min: 0, max: 1, step: 0.01 });
+    }
+    addParameter(param) {
+        this.parameters.set(param.id, param);
+    }
+    getParameters() {
+        return Array.from(this.parameters.values());
+    }
+    getParameter(id) {
+        return this.parameters.get(id);
+    }
+    setParameter(id, value) {
+        const param = this.parameters.get(id);
+        if (param) {
+            param.value = Math.max(param.min, Math.min(param.max, value));
+            this.parameterChanged.emit({ id, value: param.value });
+        }
+    }
+    getState() {
+        const state = {};
+        this.parameters.forEach((p, k) => (state[k] = p.value));
+        return state;
+    }
+    setState(state) {
+        for (const key in state) {
+            this.setParameter(key, state[key]);
+        }
+    }
+}
+//# sourceMappingURL=VibratoPlugin.js.map

package/dist/plugins/impl/VibratoPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VibratoPlugin.js","sourceRoot":"","sources":["../../../src/plugins/impl/VibratoPlugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;;;GAOG;AACH,MAAM,OAAO,aAAa;IAStB,YAAY,EAAY,EAAE,IAAY,EAAE,IAAgB;QAJxC,qBAAgB,GAAG,IAAI,MAAM,EAAsC,CAAC;QAE5E,eAAU,GAAsC,IAAI,GAAG,EAAE,CAAC;QAG9D,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1F,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1F,CAAC;IAEM,YAAY,CAAC,KAAsB;QACtC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAEM,aAAa;QAChB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAEM,YAAY,CAAC,EAAe;QAC/B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAEM,YAAY,CAAC,EAAe,EAAE,KAAa;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,KAAK,EAAE,CAAC;YACR,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9D,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC;IAEM,QAAQ;QACX,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACjB,CAAC;IAEM,QAAQ,CAAC,KAA6B;QACzC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;CACJ"}

package/dist/preferences/KeyBindings.d.ts

@@ -0,0 +1,38 @@
+import { Signal } from '../lib/Signal';
+/**
+ * Manages custom keyboard shortcut bindings that override defaults.
+ * Persists to localStorage.
+ */
+export declare class KeyBindings {
+    private static instance;
+    private customBindings;
+    readonly bindingsChanged: Signal<{
+        actionId: string;
+        keyCombo: string | undefined;
+    }>;
+    private constructor();
+    static getInstance(): KeyBindings;
+    /**
+     * Set a custom key binding for an action, overriding the default.
+     */
+    setBinding(actionId: string, keyCombo: string): void;
+    /**
+     * Get the custom key binding for an action (undefined if using default).
+     */
+    getBinding(actionId: string): string | undefined;
+    /**
+     * Remove a custom binding, reverting to default.
+     */
+    removeBinding(actionId: string): void;
+    /**
+     * Clear all custom bindings, reverting everything to defaults.
+     */
+    resetToDefaults(): void;
+    /**
+     * Get all custom bindings as a Map of actionId -> keyCombo.
+     */
+    getAllBindings(): Map<string, string>;
+    private saveToStorage;
+    private loadFromStorage;
+}
+//# sourceMappingURL=KeyBindings.d.ts.map

package/dist/preferences/KeyBindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyBindings.d.ts","sourceRoot":"","sources":["../../src/preferences/KeyBindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIvC;;;GAGG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,cAAc,CAAkC;IACxD,SAAgB,eAAe;kBAA0B,MAAM;kBAAY,MAAM,GAAG,SAAS;OAAM;IAEnG,OAAO;WAIO,WAAW,IAAI,WAAW;IAOxC;;OAEG;IACI,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM3D;;OAEG;IACI,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvD;;OAEG;IACI,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM5C;;OAEG;IACI,eAAe,IAAI,IAAI;IAM9B;;OAEG;IACI,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAI5C,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,eAAe;CAa1B"}