@drop-ai/core 0.2.0

package/dist/preferences/KeyBindings.js

@@ -0,0 +1,83 @@
+import { Signal } from '../lib/Signal';
+const STORAGE_KEY = 'drop-ai-keybindings';
+/**
+ * Manages custom keyboard shortcut bindings that override defaults.
+ * Persists to localStorage.
+ */
+export class KeyBindings {
+    constructor() {
+        this.customBindings = new Map();
+        this.bindingsChanged = new Signal();
+        this.loadFromStorage();
+    }
+    static getInstance() {
+        if (!KeyBindings.instance) {
+            KeyBindings.instance = new KeyBindings();
+        }
+        return KeyBindings.instance;
+    }
+    /**
+     * Set a custom key binding for an action, overriding the default.
+     */
+    setBinding(actionId, keyCombo) {
+        this.customBindings.set(actionId, keyCombo);
+        this.saveToStorage();
+        this.bindingsChanged.emit({ actionId, keyCombo });
+    }
+    /**
+     * Get the custom key binding for an action (undefined if using default).
+     */
+    getBinding(actionId) {
+        return this.customBindings.get(actionId);
+    }
+    /**
+     * Remove a custom binding, reverting to default.
+     */
+    removeBinding(actionId) {
+        this.customBindings.delete(actionId);
+        this.saveToStorage();
+        this.bindingsChanged.emit({ actionId, keyCombo: undefined });
+    }
+    /**
+     * Clear all custom bindings, reverting everything to defaults.
+     */
+    resetToDefaults() {
+        this.customBindings.clear();
+        this.saveToStorage();
+        this.bindingsChanged.emit({ actionId: '*', keyCombo: undefined });
+    }
+    /**
+     * Get all custom bindings as a Map of actionId -> keyCombo.
+     */
+    getAllBindings() {
+        return new Map(this.customBindings);
+    }
+    saveToStorage() {
+        try {
+            if (typeof localStorage === 'undefined')
+                return;
+            const data = Object.fromEntries(this.customBindings);
+            localStorage.setItem(STORAGE_KEY, JSON.stringify(data));
+        }
+        catch (_a) {
+            // localStorage may be unavailable (SSR, private browsing)
+            console.warn('[KeyBindings] Failed to save to localStorage');
+        }
+    }
+    loadFromStorage() {
+        try {
+            if (typeof localStorage === 'undefined')
+                return;
+            const raw = localStorage.getItem(STORAGE_KEY);
+            if (raw) {
+                const data = JSON.parse(raw);
+                this.customBindings = new Map(Object.entries(data));
+            }
+        }
+        catch (_a) {
+            // localStorage may be unavailable (SSR, private browsing)
+            console.warn('[KeyBindings] Failed to load from localStorage');
+        }
+    }
+}
+//# sourceMappingURL=KeyBindings.js.map

package/dist/preferences/KeyBindings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyBindings.js","sourceRoot":"","sources":["../../src/preferences/KeyBindings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAE1C;;;GAGG;AACH,MAAM,OAAO,WAAW;IAKpB;QAHQ,mBAAc,GAAwB,IAAI,GAAG,EAAE,CAAC;QACxC,oBAAe,GAAG,IAAI,MAAM,EAAsD,CAAC;QAG/F,IAAI,CAAC,eAAe,EAAE,CAAC;IAC3B,CAAC;IAEM,MAAM,CAAC,WAAW;QACrB,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;YACxB,WAAW,CAAC,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,WAAW,CAAC,QAAQ,CAAC;IAChC,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,QAAgB,EAAE,QAAgB;QAChD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACI,UAAU,CAAC,QAAgB;QAC9B,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACI,aAAa,CAAC,QAAgB;QACjC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACI,eAAe;QAClB,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACI,cAAc;QACjB,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACxC,CAAC;IAEO,aAAa;QACjB,IAAI,CAAC;YACD,IAAI,OAAO,YAAY,KAAK,WAAW;gBAAE,OAAO;YAChD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACrD,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;QAAC,WAAM,CAAC;YACL,0DAA0D;YAC1D,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QACjE,CAAC;IACL,CAAC;IAEO,eAAe;QACnB,IAAI,CAAC;YACD,IAAI,OAAO,YAAY,KAAK,WAAW;gBAAE,OAAO;YAChD,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;YAC9C,IAAI,GAAG,EAAE,CAAC;gBACN,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2B,CAAC;gBACvD,IAAI,CAAC,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;YACxD,CAAC;QACL,CAAC;QAAC,WAAM,CAAC;YACL,0DAA0D;YAC1D,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QACnE,CAAC;IACL,CAAC;CACJ"}

package/dist/preferences/Preferences.d.ts

@@ -0,0 +1,49 @@
+import { Signal } from '../lib/Signal';
+export interface PreferenceValues {
+    audioBufferSize: 128 | 256 | 512 | 1024 | 2048;
+    sampleRate: 44100 | 48000 | 96000;
+    theme: 'dark' | 'light';
+    autoSaveInterval: number;
+    snapToGrid: boolean;
+    gridSubdivision: number;
+    meterType: 'peak' | 'rms' | 'vu';
+    showMinimap: boolean;
+    followPlayhead: boolean;
+    countInBars: number;
+    historyDepth: number;
+    saveHistory: boolean;
+    saveHistoryDepth: number;
+}
+/**
+ * Singleton preferences system with Signal-based change notification.
+ * Persists to localStorage.
+ */
+export declare class Preferences {
+    private static instance;
+    private values;
+    readonly preferenceChanged: Signal<{
+        key: keyof PreferenceValues;
+        value: unknown;
+    }>;
+    private constructor();
+    static getInstance(): Preferences;
+    /**
+     * Get a preference value by key.
+     */
+    get<K extends keyof PreferenceValues>(key: K): PreferenceValues[K];
+    /**
+     * Set a preference value.
+     */
+    set<K extends keyof PreferenceValues>(key: K, value: PreferenceValues[K]): void;
+    /**
+     * Get all preferences as a plain object.
+     */
+    getAll(): Readonly<PreferenceValues>;
+    /**
+     * Reset all preferences to defaults.
+     */
+    resetToDefaults(): void;
+    private saveToStorage;
+    private loadFromStorage;
+}
+//# sourceMappingURL=Preferences.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Preferences.d.ts","sourceRoot":"","sources":["../../src/preferences/Preferences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIvC,MAAM,WAAW,gBAAgB;IAC7B,eAAe,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IAC/C,UAAU,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;IAClC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IAEpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAkBD;;;GAGG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAc;IACrC,OAAO,CAAC,MAAM,CAAmB;IACjC,SAAgB,iBAAiB;aAAqB,MAAM,gBAAgB;eAAS,OAAO;OAAM;IAElG,OAAO;WAKO,WAAW,IAAI,WAAW;IAOxC;;OAEG;IACI,GAAG,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAIzE;;OAEG;IACI,GAAG,CAAC,CAAC,SAAS,MAAM,gBAAgB,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAOtF;;OAEG;IACI,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC;IAI3C;;OAEG;IACI,eAAe,IAAI,IAAI;IAS9B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;CAa1B"}

package/dist/preferences/Preferences.js

@@ -0,0 +1,93 @@
+import { Signal } from '../lib/Signal';
+const STORAGE_KEY = 'drop-ai-preferences';
+const DEFAULT_PREFERENCES = {
+    audioBufferSize: 512,
+    sampleRate: 44100,
+    theme: 'dark',
+    autoSaveInterval: 60000,
+    snapToGrid: true,
+    gridSubdivision: 4,
+    meterType: 'peak',
+    showMinimap: true,
+    followPlayhead: true,
+    countInBars: 0,
+    historyDepth: 0,
+    saveHistory: true,
+    saveHistoryDepth: 0,
+};
+/**
+ * Singleton preferences system with Signal-based change notification.
+ * Persists to localStorage.
+ */
+export class Preferences {
+    constructor() {
+        this.preferenceChanged = new Signal();
+        this.values = Object.assign({}, DEFAULT_PREFERENCES);
+        this.loadFromStorage();
+    }
+    static getInstance() {
+        if (!Preferences.instance) {
+            Preferences.instance = new Preferences();
+        }
+        return Preferences.instance;
+    }
+    /**
+     * Get a preference value by key.
+     */
+    get(key) {
+        return this.values[key];
+    }
+    /**
+     * Set a preference value.
+     */
+    set(key, value) {
+        if (this.values[key] === value)
+            return;
+        this.values[key] = value;
+        this.saveToStorage();
+        this.preferenceChanged.emit({ key, value });
+    }
+    /**
+     * Get all preferences as a plain object.
+     */
+    getAll() {
+        return Object.assign({}, this.values);
+    }
+    /**
+     * Reset all preferences to defaults.
+     */
+    resetToDefaults() {
+        const keys = Object.keys(DEFAULT_PREFERENCES);
+        this.values = Object.assign({}, DEFAULT_PREFERENCES);
+        this.saveToStorage();
+        keys.forEach(key => {
+            this.preferenceChanged.emit({ key, value: this.values[key] });
+        });
+    }
+    saveToStorage() {
+        try {
+            if (typeof localStorage === 'undefined')
+                return;
+            localStorage.setItem(STORAGE_KEY, JSON.stringify(this.values));
+        }
+        catch (_a) {
+            console.warn('[Preferences] Failed to save to localStorage');
+        }
+    }
+    loadFromStorage() {
+        try {
+            if (typeof localStorage === 'undefined')
+                return;
+            const raw = localStorage.getItem(STORAGE_KEY);
+            if (raw) {
+                const data = JSON.parse(raw);
+                // Merge loaded values with defaults (in case new prefs were added)
+                this.values = Object.assign(Object.assign({}, DEFAULT_PREFERENCES), data);
+            }
+        }
+        catch (_a) {
+            console.warn('[Preferences] Failed to load from localStorage');
+        }
+    }
+}
+//# sourceMappingURL=Preferences.js.map

package/dist/preferences/Preferences.js.map

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

package/dist/preferences/index.d.ts

@@ -0,0 +1,4 @@
+export { KeyBindings } from './KeyBindings';
+export { Preferences } from './Preferences';
+export type { PreferenceValues } from './Preferences';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/preferences/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/preferences/index.js

@@ -0,0 +1,3 @@
+export { KeyBindings } from './KeyBindings';
+export { Preferences } from './Preferences';
+//# sourceMappingURL=index.js.map

package/dist/preferences/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/preferences/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/processing/GainProcessor.d.ts

@@ -0,0 +1,10 @@
+import { Processor, ProcessorId } from './Processor';
+import { Signal } from '../lib/Signal';
+export declare class GainProcessor extends Processor {
+    private _gain;
+    readonly gainChanged: Signal<number>;
+    constructor(id: ProcessorId, name?: string);
+    get gain(): number;
+    set gain(db: number);
+}
+//# sourceMappingURL=GainProcessor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GainProcessor.d.ts","sourceRoot":"","sources":["../../src/processing/GainProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,qBAAa,aAAc,SAAQ,SAAS;IACxC,OAAO,CAAC,KAAK,CAAa;IAE1B,SAAgB,WAAW,iBAAwB;gBAEvC,EAAE,EAAE,WAAW,EAAE,IAAI,GAAE,MAAgB;IAInD,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,CAAC,EAAE,EAAE,MAAM,EAOzB;CACJ"}

package/dist/processing/GainProcessor.js

@@ -0,0 +1,21 @@
+import { Processor } from './Processor';
+import { Signal } from '../lib/Signal';
+export class GainProcessor extends Processor {
+    constructor(id, name = 'Fader') {
+        super(id, name);
+        this._gain = 0; // dB, default 0dB unity gain
+        this.gainChanged = new Signal();
+    }
+    get gain() {
+        return this._gain;
+    }
+    set gain(db) {
+        // Clamp or validate if needed
+        if (this._gain !== db) {
+            this._gain = db;
+            this.gainChanged.emit(db);
+            this.stateChanged.emit();
+        }
+    }
+}
+//# sourceMappingURL=GainProcessor.js.map

package/dist/processing/GainProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GainProcessor.js","sourceRoot":"","sources":["../../src/processing/GainProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,OAAO,aAAc,SAAQ,SAAS;IAKxC,YAAY,EAAe,EAAE,OAAe,OAAO;QAC/C,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QALZ,UAAK,GAAW,CAAC,CAAC,CAAC,6BAA6B;QAExC,gBAAW,GAAG,IAAI,MAAM,EAAU,CAAC;IAInD,CAAC;IAED,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,IAAW,IAAI,CAAC,EAAU;QACtB,8BAA8B;QAC9B,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,EAAE,CAAC;YACpB,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC7B,CAAC;IACL,CAAC;CACJ"}

package/dist/processing/IO.d.ts

@@ -0,0 +1,15 @@
+import { Signal } from '../lib/Signal';
+export type IOId = string;
+export declare class IO {
+    readonly id: IOId;
+    name: string;
+    private _connections;
+    readonly connected: Signal<string>;
+    readonly disconnected: Signal<string>;
+    constructor(id: IOId, name: string);
+    connect(targetId: IOId): void;
+    disconnect(targetId: IOId): void;
+    get connections(): ReadonlyArray<IOId>;
+    isConnectedTo(targetId: IOId): boolean;
+}
+//# sourceMappingURL=IO.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IO.d.ts","sourceRoot":"","sources":["../../src/processing/IO.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC;AAE1B,qBAAa,EAAE;IACX,SAAgB,EAAE,EAAE,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IAMpB,OAAO,CAAC,YAAY,CAAc;IAElC,SAAgB,SAAS,iBAAsB;IAC/C,SAAgB,YAAY,iBAAsB;gBAEtC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM;IAK3B,OAAO,CAAC,QAAQ,EAAE,IAAI;IAOtB,UAAU,CAAC,QAAQ,EAAE,IAAI;IAQhC,IAAW,WAAW,IAAI,aAAa,CAAC,IAAI,CAAC,CAE5C;IAEM,aAAa,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO;CAGhD"}

package/dist/processing/IO.js

@@ -0,0 +1,34 @@
+import { Signal } from '../lib/Signal';
+export class IO {
+    constructor(id, name) {
+        // Connected IOs (Output -> Input)
+        // If this is an Output, `connections` lists the Inputs it feeds.
+        // If this is an Input, `connections` implies source Outputs (though usually tracked by Output).
+        // For simplicity, we model: Output knows its destinations.
+        this._connections = [];
+        this.connected = new Signal();
+        this.disconnected = new Signal();
+        this.id = id;
+        this.name = name;
+    }
+    connect(targetId) {
+        if (!this._connections.includes(targetId)) {
+            this._connections.push(targetId);
+            this.connected.emit(targetId);
+        }
+    }
+    disconnect(targetId) {
+        const index = this._connections.indexOf(targetId);
+        if (index !== -1) {
+            this._connections.splice(index, 1);
+            this.disconnected.emit(targetId);
+        }
+    }
+    get connections() {
+        return this._connections;
+    }
+    isConnectedTo(targetId) {
+        return this._connections.includes(targetId);
+    }
+}
+//# sourceMappingURL=IO.js.map

package/dist/processing/IO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IO.js","sourceRoot":"","sources":["../../src/processing/IO.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIvC,MAAM,OAAO,EAAE;IAaX,YAAY,EAAQ,EAAE,IAAY;QATlC,kCAAkC;QAClC,iEAAiE;QACjE,gGAAgG;QAChG,2DAA2D;QACnD,iBAAY,GAAW,EAAE,CAAC;QAElB,cAAS,GAAG,IAAI,MAAM,EAAQ,CAAC;QAC/B,iBAAY,GAAG,IAAI,MAAM,EAAQ,CAAC;QAG9C,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACrB,CAAC;IAEM,OAAO,CAAC,QAAc;QACzB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;IAEM,UAAU,CAAC,QAAc;QAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACnC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;IACL,CAAC;IAED,IAAW,WAAW;QAClB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAEM,aAAa,CAAC,QAAc;QAC/B,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;CACJ"}

package/dist/processing/MeterProcessor.d.ts

@@ -0,0 +1,101 @@
+import { Processor, ProcessorId } from './Processor';
+import { Signal } from '../lib/Signal';
+import { MeterData } from '../domain/MeterData';
+import { MeterPoint } from '../domain/MeterType';
+/**
+ * Metering DSP processor.
+ *
+ * Modelled after Ardour's PeakMeter (libs/ardour/meter.cc).
+ * Provides multi-channel peak, RMS, and peak-hold values along with
+ * K-metering and VU calculation helpers.
+ *
+ * The meter can be positioned at different points in the signal chain
+ * via the {@link MeterPoint} enum (input, pre-fader, post-fader, output).
+ */
+export declare class MeterProcessor extends Processor {
+    /** Per-channel instantaneous peak levels in dBFS. */
+    private peakValues;
+    /** Per-channel RMS levels in dBFS. */
+    private rmsValues;
+    /** Per-channel peak-hold values in dBFS (decays slowly). */
+    private peakHold;
+    /** Peak-hold decay rate in dB per frame callback. */
+    private decayRate;
+    /** Number of audio channels this meter tracks. */
+    private channelCount;
+    /** Where in the signal chain this meter is placed. */
+    private _meterPoint;
+    /** Emitted when meter data is updated. */
+    readonly meterUpdated: Signal<MeterData>;
+    /** Emitted when the meter point changes. */
+    readonly meterPointChanged: Signal<MeterPoint>;
+    /**
+     * @param id          Unique processor identifier.
+     * @param meterPoint  Initial placement in the signal chain.
+     * @param channels    Number of audio channels (default 2 for stereo).
+     */
+    constructor(id: ProcessorId, meterPoint?: MeterPoint, channels?: number);
+    /**
+     * Set the meter position in the signal chain.
+     * @param point The new meter point.
+     */
+    setMeterPoint(point: MeterPoint): void;
+    /** Get the current meter point. */
+    getMeterPoint(): MeterPoint;
+    /**
+     * Calculate a K-meter value from raw samples.
+     *
+     * K-metering (Bob Katz) applies a reference offset so that the meter's
+     * 0 dB mark corresponds to the chosen reference level (e.g. -14 dBFS
+     * for K-14, -20 dBFS for K-20).
+     *
+     * @param samples   Raw audio samples for a single channel.
+     * @param reference Reference level in dBFS (e.g. -14 for K-14, -20 for K-20).
+     * @returns The K-meter value in dB (relative to the reference).
+     */
+    calculateKMeter(samples: Float32Array, reference: number): number;
+    /**
+     * Calculate a VU meter value from raw samples.
+     *
+     * A traditional VU meter has a 300 ms integration time (ballistic).
+     * This method computes the RMS over the provided sample block, which
+     * should ideally represent ~300 ms of audio for authentic behaviour.
+     *
+     * @param samples Raw audio samples for a single channel.
+     * @returns VU level in dB (0 VU ~ -14 dBFS by convention, but we return
+     *          raw dBFS here -- the UI layer can apply the VU offset).
+     */
+    calculateVUMeter(samples: Float32Array): number;
+    /**
+     * Feed new sample data into the meter.
+     *
+     * Intended to be called by the audio backend once per process cycle.
+     * Updates peak, RMS, and peak-hold values for each channel.
+     *
+     * @param channelData Array of Float32Array, one per channel.
+     */
+    process(channelData: Float32Array[]): void;
+    /**
+     * Get the current aggregated meter data (stereo or mono).
+     *
+     * Returns the maximum peak/RMS across all channels, matching the
+     * existing {@link MeterData} interface used throughout the application.
+     */
+    getMeterData(): MeterData;
+    /**
+     * Get per-channel meter data.
+     *
+     * @returns An array of MeterData, one per channel.
+     */
+    getChannelMeterData(): MeterData[];
+    /**
+     * Reset all peak-hold values to -Infinity.
+     */
+    resetPeakHold(): void;
+    /**
+     * Set the peak-hold decay rate.
+     * @param rate Decay rate in dB per frame callback.
+     */
+    setDecayRate(rate: number): void;
+}
+//# sourceMappingURL=MeterProcessor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MeterProcessor.d.ts","sourceRoot":"","sources":["../../src/processing/MeterProcessor.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;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,SAAS;IACzC,qDAAqD;IACrD,OAAO,CAAC,UAAU,CAAW;IAC7B,sCAAsC;IACtC,OAAO,CAAC,SAAS,CAAW;IAC5B,4DAA4D;IAC5D,OAAO,CAAC,QAAQ,CAAW;IAC3B,qDAAqD;IACrD,OAAO,CAAC,SAAS,CAAe;IAChC,kDAAkD;IAClD,OAAO,CAAC,YAAY,CAAS;IAE7B,sDAAsD;IACtD,OAAO,CAAC,WAAW,CAAa;IAEhC,0CAA0C;IAC1C,SAAgB,YAAY,oBAA2B;IACvD,4CAA4C;IAC5C,SAAgB,iBAAiB,qBAA4B;IAE7D;;;;OAIG;gBAEC,EAAE,EAAE,WAAW,EACf,UAAU,GAAE,UAAkC,EAC9C,QAAQ,GAAE,MAAU;IAYxB;;;OAGG;IACI,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAQ7C,mCAAmC;IAC5B,aAAa,IAAI,UAAU;IAMlC;;;;;;;;;;OAUG;IACI,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAgBxE;;;;;;;;;;OAUG;IACI,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;IAgBtD;;;;;;;OAOG;IACI,OAAO,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI;IAsCjD;;;;;OAKG;IACI,YAAY,IAAI,SAAS;IAmBhC;;;;OAIG;IACI,mBAAmB,IAAI,SAAS,EAAE;IAazC;;OAEG;IACI,aAAa,IAAI,IAAI;IAI5B;;;OAGG;IACI,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG1C"}

package/dist/processing/MeterProcessor.js

@@ -0,0 +1,195 @@
+import { Processor } from './Processor';
+import { Signal } from '../lib/Signal';
+import { MeterPoint } from '../domain/MeterType';
+/**
+ * Metering DSP processor.
+ *
+ * Modelled after Ardour's PeakMeter (libs/ardour/meter.cc).
+ * Provides multi-channel peak, RMS, and peak-hold values along with
+ * K-metering and VU calculation helpers.
+ *
+ * The meter can be positioned at different points in the signal chain
+ * via the {@link MeterPoint} enum (input, pre-fader, post-fader, output).
+ */
+export class MeterProcessor extends Processor {
+    /**
+     * @param id          Unique processor identifier.
+     * @param meterPoint  Initial placement in the signal chain.
+     * @param channels    Number of audio channels (default 2 for stereo).
+     */
+    constructor(id, meterPoint = MeterPoint.POST_FADER, channels = 2) {
+        super(id, 'Meter');
+        /** Peak-hold decay rate in dB per frame callback. */
+        this.decayRate = 0.3;
+        /** Emitted when meter data is updated. */
+        this.meterUpdated = new Signal();
+        /** Emitted when the meter point changes. */
+        this.meterPointChanged = new Signal();
+        this._meterPoint = meterPoint;
+        this.channelCount = channels;
+        this.peakValues = new Array(channels).fill(-Infinity);
+        this.rmsValues = new Array(channels).fill(-Infinity);
+        this.peakHold = new Array(channels).fill(-Infinity);
+    }
+    // ── Meter Point ──────────────────────────────────────────────────────────
+    /**
+     * Set the meter position in the signal chain.
+     * @param point The new meter point.
+     */
+    setMeterPoint(point) {
+        if (this._meterPoint !== point) {
+            this._meterPoint = point;
+            this.meterPointChanged.emit(point);
+            this.stateChanged.emit();
+        }
+    }
+    /** Get the current meter point. */
+    getMeterPoint() {
+        return this._meterPoint;
+    }
+    // ── DSP Helpers ──────────────────────────────────────────────────────────
+    /**
+     * Calculate a K-meter value from raw samples.
+     *
+     * K-metering (Bob Katz) applies a reference offset so that the meter's
+     * 0 dB mark corresponds to the chosen reference level (e.g. -14 dBFS
+     * for K-14, -20 dBFS for K-20).
+     *
+     * @param samples   Raw audio samples for a single channel.
+     * @param reference Reference level in dBFS (e.g. -14 for K-14, -20 for K-20).
+     * @returns The K-meter value in dB (relative to the reference).
+     */
+    calculateKMeter(samples, reference) {
+        if (samples.length === 0)
+            return -Infinity;
+        let sumOfSquares = 0;
+        for (let i = 0; i < samples.length; i++) {
+            sumOfSquares += samples[i] * samples[i];
+        }
+        const rmsLinear = Math.sqrt(sumOfSquares / samples.length);
+        if (rmsLinear === 0)
+            return -Infinity;
+        const rmsDb = 20 * Math.log10(rmsLinear);
+        // K-meter: shift so that `reference` dBFS reads as 0 on the scale
+        return rmsDb - reference;
+    }
+    /**
+     * Calculate a VU meter value from raw samples.
+     *
+     * A traditional VU meter has a 300 ms integration time (ballistic).
+     * This method computes the RMS over the provided sample block, which
+     * should ideally represent ~300 ms of audio for authentic behaviour.
+     *
+     * @param samples Raw audio samples for a single channel.
+     * @returns VU level in dB (0 VU ~ -14 dBFS by convention, but we return
+     *          raw dBFS here -- the UI layer can apply the VU offset).
+     */
+    calculateVUMeter(samples) {
+        if (samples.length === 0)
+            return -Infinity;
+        let sumOfSquares = 0;
+        for (let i = 0; i < samples.length; i++) {
+            sumOfSquares += samples[i] * samples[i];
+        }
+        const rmsLinear = Math.sqrt(sumOfSquares / samples.length);
+        if (rmsLinear === 0)
+            return -Infinity;
+        return 20 * Math.log10(rmsLinear);
+    }
+    // ── State Update ─────────────────────────────────────────────────────────
+    /**
+     * Feed new sample data into the meter.
+     *
+     * Intended to be called by the audio backend once per process cycle.
+     * Updates peak, RMS, and peak-hold values for each channel.
+     *
+     * @param channelData Array of Float32Array, one per channel.
+     */
+    process(channelData) {
+        for (let ch = 0; ch < Math.min(channelData.length, this.channelCount); ch++) {
+            const samples = channelData[ch];
+            // Peak
+            let peak = 0;
+            for (let i = 0; i < samples.length; i++) {
+                const abs = Math.abs(samples[i]);
+                if (abs > peak)
+                    peak = abs;
+            }
+            const peakDb = peak > 0 ? 20 * Math.log10(peak) : -Infinity;
+            this.peakValues[ch] = peakDb;
+            // RMS
+            let sumOfSquares = 0;
+            for (let i = 0; i < samples.length; i++) {
+                sumOfSquares += samples[i] * samples[i];
+            }
+            const rmsLinear = Math.sqrt(sumOfSquares / samples.length);
+            const rmsDb = rmsLinear > 0 ? 20 * Math.log10(rmsLinear) : -Infinity;
+            this.rmsValues[ch] = rmsDb;
+            // Peak hold with decay
+            if (peakDb > this.peakHold[ch]) {
+                this.peakHold[ch] = peakDb;
+            }
+            else {
+                this.peakHold[ch] = Math.max(this.peakHold[ch] - this.decayRate, -Infinity);
+            }
+        }
+        this.meterUpdated.emit(this.getMeterData());
+    }
+    // ── Output ───────────────────────────────────────────────────────────────
+    /**
+     * Get the current aggregated meter data (stereo or mono).
+     *
+     * Returns the maximum peak/RMS across all channels, matching the
+     * existing {@link MeterData} interface used throughout the application.
+     */
+    getMeterData() {
+        let maxPeak = -Infinity;
+        let maxRms = -Infinity;
+        let maxPeakHold = -Infinity;
+        for (let ch = 0; ch < this.channelCount; ch++) {
+            if (this.peakValues[ch] > maxPeak)
+                maxPeak = this.peakValues[ch];
+            if (this.rmsValues[ch] > maxRms)
+                maxRms = this.rmsValues[ch];
+            if (this.peakHold[ch] > maxPeakHold)
+                maxPeakHold = this.peakHold[ch];
+        }
+        return {
+            peak: maxPeak,
+            rms: maxRms,
+            peakHold: maxPeakHold,
+            clipping: maxPeak >= 0,
+        };
+    }
+    /**
+     * Get per-channel meter data.
+     *
+     * @returns An array of MeterData, one per channel.
+     */
+    getChannelMeterData() {
+        const result = [];
+        for (let ch = 0; ch < this.channelCount; ch++) {
+            result.push({
+                peak: this.peakValues[ch],
+                rms: this.rmsValues[ch],
+                peakHold: this.peakHold[ch],
+                clipping: this.peakValues[ch] >= 0,
+            });
+        }
+        return result;
+    }
+    /**
+     * Reset all peak-hold values to -Infinity.
+     */
+    resetPeakHold() {
+        this.peakHold.fill(-Infinity);
+    }
+    /**
+     * Set the peak-hold decay rate.
+     * @param rate Decay rate in dB per frame callback.
+     */
+    setDecayRate(rate) {
+        this.decayRate = Math.max(0, rate);
+    }
+}
+//# sourceMappingURL=MeterProcessor.js.map