@drop-ai/core 0.2.0

package/dist/storage/SessionStorage.d.ts

@@ -0,0 +1,74 @@
+import { SessionSnapshot } from '../domain/Session';
+/**
+ * Metadata stored alongside each session entry.
+ */
+export interface SessionMeta {
+    id: string;
+    name: string;
+    modified: Date;
+}
+/**
+ * A named snapshot of a session (like Ardour snapshots).
+ */
+export interface SnapshotEntry {
+    id: string;
+    sessionId: string;
+    name: string;
+    created: Date;
+    snapshot: SessionSnapshot;
+}
+/**
+ * IndexedDB-based session storage.
+ *
+ * Stores full session snapshots and named snapshots (point-in-time saves)
+ * in the browser's IndexedDB.
+ */
+export declare class SessionStorage {
+    private static instance;
+    private dbPromise;
+    private constructor();
+    static getInstance(): SessionStorage;
+    private openDB;
+    /**
+     * Save (insert or update) a session snapshot to IndexedDB.
+     */
+    saveSession(session: {
+        id: string;
+        name: string;
+        toJSON(): SessionSnapshot;
+    }): Promise<void>;
+    /**
+     * Load a session snapshot by ID.
+     */
+    loadSession(id: string): Promise<SessionSnapshot | null>;
+    /**
+     * List all saved sessions (lightweight metadata only).
+     */
+    listSessions(): Promise<SessionMeta[]>;
+    /**
+     * Delete a session and all its snapshots.
+     */
+    deleteSession(id: string): Promise<void>;
+    /**
+     * Save a named snapshot of the given session.
+     * Returns the snapshot ID.
+     */
+    saveSnapshot(sessionId: string, name: string, snapshot: SessionSnapshot): Promise<string>;
+    /**
+     * List all snapshots for a given session.
+     */
+    listSnapshots(sessionId: string): Promise<{
+        id: string;
+        name: string;
+        created: Date;
+    }[]>;
+    /**
+     * Load a specific snapshot by ID.
+     */
+    loadSnapshot(snapshotId: string): Promise<SessionSnapshot | null>;
+    /**
+     * Delete a specific snapshot.
+     */
+    deleteSnapshot(snapshotId: string): Promise<void>;
+}
+//# sourceMappingURL=SessionStorage.d.ts.map

package/dist/storage/SessionStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStorage.d.ts","sourceRoot":"","sources":["../../src/storage/SessionStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOpD;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,eAAe,CAAC;CAC7B;AAED;;;;;GAKG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiB;IACxC,OAAO,CAAC,SAAS,CAAqC;IAEtD,OAAO;WAEO,WAAW,IAAI,cAAc;IAS3C,OAAO,CAAC,MAAM;IAkCd;;OAEG;IACU,WAAW,CAAC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,IAAI,eAAe,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBzG;;OAEG;IACU,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAarE;;OAEG;IACU,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAmBnD;;OAEG;IACU,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBrD;;;OAGG;IACU,YAAY,CACrB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,eAAe,GAC1B,OAAO,CAAC,MAAM,CAAC;IAuBlB;;OAEG;IACU,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,IAAI,CAAA;KAAE,EAAE,CAAC;IAoBrG;;OAEG;IACU,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAa9E;;OAEG;IACU,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CASjE"}

package/dist/storage/SessionStorage.js

@@ -0,0 +1,192 @@
+const DB_NAME = 'drop-ai-daw';
+const DB_VERSION = 1;
+const SESSIONS_STORE = 'sessions';
+const SNAPSHOTS_STORE = 'snapshots';
+/**
+ * IndexedDB-based session storage.
+ *
+ * Stores full session snapshots and named snapshots (point-in-time saves)
+ * in the browser's IndexedDB.
+ */
+export class SessionStorage {
+    constructor() {
+        this.dbPromise = null;
+    }
+    static getInstance() {
+        if (!SessionStorage.instance) {
+            SessionStorage.instance = new SessionStorage();
+        }
+        return SessionStorage.instance;
+    }
+    // ─── Database Initialisation ─────────────────────────────────────────────
+    openDB() {
+        if (this.dbPromise)
+            return this.dbPromise;
+        this.dbPromise = new Promise((resolve, reject) => {
+            const request = indexedDB.open(DB_NAME, DB_VERSION);
+            request.onupgradeneeded = () => {
+                const db = request.result;
+                if (!db.objectStoreNames.contains(SESSIONS_STORE)) {
+                    const sessionsStore = db.createObjectStore(SESSIONS_STORE, { keyPath: 'id' });
+                    sessionsStore.createIndex('name', 'name', { unique: false });
+                    sessionsStore.createIndex('modified', 'modified', { unique: false });
+                }
+                if (!db.objectStoreNames.contains(SNAPSHOTS_STORE)) {
+                    const snapshotsStore = db.createObjectStore(SNAPSHOTS_STORE, { keyPath: 'id' });
+                    snapshotsStore.createIndex('sessionId', 'sessionId', { unique: false });
+                    snapshotsStore.createIndex('created', 'created', { unique: false });
+                }
+            };
+            request.onsuccess = () => resolve(request.result);
+            request.onerror = () => {
+                this.dbPromise = null;
+                reject(request.error);
+            };
+        });
+        return this.dbPromise;
+    }
+    // ─── Session CRUD ────────────────────────────────────────────────────────
+    /**
+     * Save (insert or update) a session snapshot to IndexedDB.
+     */
+    async saveSession(session) {
+        const db = await this.openDB();
+        const snapshot = session.toJSON();
+        const record = {
+            id: snapshot.id,
+            name: snapshot.name,
+            modified: new Date().toISOString(),
+            snapshot,
+        };
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(SESSIONS_STORE, 'readwrite');
+            tx.objectStore(SESSIONS_STORE).put(record);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    /**
+     * Load a session snapshot by ID.
+     */
+    async loadSession(id) {
+        const db = await this.openDB();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(SESSIONS_STORE, 'readonly');
+            const request = tx.objectStore(SESSIONS_STORE).get(id);
+            request.onsuccess = () => {
+                const record = request.result;
+                resolve(record ? record.snapshot : null);
+            };
+            request.onerror = () => reject(request.error);
+        });
+    }
+    /**
+     * List all saved sessions (lightweight metadata only).
+     */
+    async listSessions() {
+        const db = await this.openDB();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(SESSIONS_STORE, 'readonly');
+            const request = tx.objectStore(SESSIONS_STORE).getAll();
+            request.onsuccess = () => {
+                var _a;
+                const records = (_a = request.result) !== null && _a !== void 0 ? _a : [];
+                resolve(records.map((r) => ({
+                    id: r.id,
+                    name: r.name,
+                    modified: new Date(r.modified),
+                })));
+            };
+            request.onerror = () => reject(request.error);
+        });
+    }
+    /**
+     * Delete a session and all its snapshots.
+     */
+    async deleteSession(id) {
+        const db = await this.openDB();
+        // Delete associated snapshots first
+        const snapshots = await this.listSnapshots(id);
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction([SESSIONS_STORE, SNAPSHOTS_STORE], 'readwrite');
+            tx.objectStore(SESSIONS_STORE).delete(id);
+            for (const snap of snapshots) {
+                tx.objectStore(SNAPSHOTS_STORE).delete(snap.id);
+            }
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    // ─── Named Snapshots ─────────────────────────────────────────────────────
+    /**
+     * Save a named snapshot of the given session.
+     * Returns the snapshot ID.
+     */
+    async saveSnapshot(sessionId, name, snapshot) {
+        const db = await this.openDB();
+        const id = crypto.randomUUID();
+        const entry = {
+            id,
+            sessionId,
+            name,
+            created: new Date(),
+            snapshot,
+        };
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(SNAPSHOTS_STORE, 'readwrite');
+            // Store with ISO date string for serialisation safety
+            tx.objectStore(SNAPSHOTS_STORE).put(Object.assign(Object.assign({}, entry), { created: entry.created.toISOString() }));
+            tx.oncomplete = () => resolve(id);
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+    /**
+     * List all snapshots for a given session.
+     */
+    async listSnapshots(sessionId) {
+        const db = await this.openDB();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(SNAPSHOTS_STORE, 'readonly');
+            const index = tx.objectStore(SNAPSHOTS_STORE).index('sessionId');
+            const request = index.getAll(sessionId);
+            request.onsuccess = () => {
+                var _a;
+                const records = (_a = request.result) !== null && _a !== void 0 ? _a : [];
+                resolve(records.map((r) => ({
+                    id: r.id,
+                    name: r.name,
+                    created: new Date(r.created),
+                })));
+            };
+            request.onerror = () => reject(request.error);
+        });
+    }
+    /**
+     * Load a specific snapshot by ID.
+     */
+    async loadSnapshot(snapshotId) {
+        const db = await this.openDB();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(SNAPSHOTS_STORE, 'readonly');
+            const request = tx.objectStore(SNAPSHOTS_STORE).get(snapshotId);
+            request.onsuccess = () => {
+                const record = request.result;
+                resolve(record ? record.snapshot : null);
+            };
+            request.onerror = () => reject(request.error);
+        });
+    }
+    /**
+     * Delete a specific snapshot.
+     */
+    async deleteSnapshot(snapshotId) {
+        const db = await this.openDB();
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(SNAPSHOTS_STORE, 'readwrite');
+            tx.objectStore(SNAPSHOTS_STORE).delete(snapshotId);
+            tx.oncomplete = () => resolve();
+            tx.onerror = () => reject(tx.error);
+        });
+    }
+}
+//# sourceMappingURL=SessionStorage.js.map

package/dist/storage/SessionStorage.js.map

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

package/dist/storage/SessionTemplate.d.ts

@@ -0,0 +1,22 @@
+import { Session } from '../domain/Session';
+/**
+ * Describes a session template.
+ */
+export interface SessionTemplate {
+    id: string;
+    name: string;
+    description: string;
+    trackCount: number;
+}
+/**
+ * Returns the list of available session templates.
+ */
+export declare function getTemplates(): SessionTemplate[];
+/**
+ * Create a new Session from a template.
+ *
+ * Each template pre-configures tracks with default names, colors,
+ * and routing through the master bus.
+ */
+export declare function createFromTemplate(templateId: string): Session;
+//# sourceMappingURL=SessionTemplate.d.ts.map

package/dist/storage/SessionTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTemplate.d.ts","sourceRoot":"","sources":["../../src/storage/SessionTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAG5C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AA0BD;;GAEG;AACH,wBAAgB,YAAY,IAAI,eAAe,EAAE,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CA4C9D"}

package/dist/storage/SessionTemplate.js

@@ -0,0 +1,77 @@
+import { Session } from '../domain/Session';
+import { TrackType } from '../domain/Track';
+/**
+ * Built-in session templates.
+ */
+const TEMPLATES = [
+    {
+        id: 'empty',
+        name: 'Empty Session',
+        description: 'A blank session with no tracks.',
+        trackCount: 0,
+    },
+    {
+        id: '4-track-recording',
+        name: '4-Track Recording',
+        description: 'Four audio tracks ready for recording.',
+        trackCount: 4,
+    },
+    {
+        id: 'mixing-8-tracks',
+        name: 'Mixing Template (8 tracks)',
+        description: 'Eight audio tracks pre-configured for mixing.',
+        trackCount: 8,
+    },
+];
+/**
+ * Returns the list of available session templates.
+ */
+export function getTemplates() {
+    return [...TEMPLATES];
+}
+/**
+ * Create a new Session from a template.
+ *
+ * Each template pre-configures tracks with default names, colors,
+ * and routing through the master bus.
+ */
+export function createFromTemplate(templateId) {
+    const template = TEMPLATES.find(t => t.id === templateId);
+    if (!template) {
+        throw new Error(`Unknown template: ${templateId}`);
+    }
+    const session = new Session(template.name);
+    switch (templateId) {
+        case 'empty':
+            // No tracks
+            break;
+        case '4-track-recording': {
+            const colors = ['#4a9eff', '#ff6b6b', '#51cf66', '#ffd43b'];
+            for (let i = 0; i < 4; i++) {
+                const track = session.addTrack(`Track ${i + 1}`, TrackType.AUDIO);
+                track.color = colors[i];
+                track.armed = true;
+            }
+            break;
+        }
+        case 'mixing-8-tracks': {
+            const mixColors = [
+                '#4a9eff', '#ff6b6b', '#51cf66', '#ffd43b',
+                '#cc5de8', '#ff922b', '#20c997', '#868e96',
+            ];
+            const trackNames = [
+                'Drums', 'Bass', 'Guitar L', 'Guitar R',
+                'Keys', 'Vocals', 'FX', 'Aux',
+            ];
+            for (let i = 0; i < 8; i++) {
+                const track = session.addTrack(trackNames[i], TrackType.AUDIO);
+                track.color = mixColors[i];
+            }
+            break;
+        }
+        default:
+            throw new Error(`Template factory not implemented: ${templateId}`);
+    }
+    return session;
+}
+//# sourceMappingURL=SessionTemplate.js.map

package/dist/storage/SessionTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionTemplate.js","sourceRoot":"","sources":["../../src/storage/SessionTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C;;GAEG;AACH,MAAM,SAAS,GAAsB;IACjC;QACI,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,eAAe;QACrB,WAAW,EAAE,iCAAiC;QAC9C,UAAU,EAAE,CAAC;KAChB;IACD;QACI,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,wCAAwC;QACrD,UAAU,EAAE,CAAC;KAChB;IACD;QACI,EAAE,EAAE,iBAAiB;QACrB,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,+CAA+C;QAC5D,UAAU,EAAE,CAAC;KAChB;CACJ,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY;IACxB,OAAO,CAAC,GAAG,SAAS,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACjD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;IAC1D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE3C,QAAQ,UAAU,EAAE,CAAC;QACjB,KAAK,OAAO;YACR,YAAY;YACZ,MAAM;QAEV,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACvB,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YAC5D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;gBAClE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;gBACxB,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;YACvB,CAAC;YACD,MAAM;QACV,CAAC;QAED,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACrB,MAAM,SAAS,GAAG;gBACd,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;gBAC1C,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS;aAC7C,CAAC;YACF,MAAM,UAAU,GAAG;gBACf,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;gBACvC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK;aAChC,CAAC;YACF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;gBAC/D,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC;YACD,MAAM;QACV,CAAC;QAED;YACI,MAAM,IAAI,KAAK,CAAC,qCAAqC,UAAU,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/utils/AudioBufferToWav.d.ts

@@ -0,0 +1,28 @@
+export declare class AudioBufferToWav {
+    /**
+     * Encode to WAV format
+     * Reference: https://gist.github.com/meziantou/edb7217fddfbb70e899e
+     */
+    static encode(buffer: AudioBuffer, format?: 'int16' | 'int24' | 'float32'): Blob;
+    /**
+     * Interleave multi-channel audio buffer
+     */
+    private static interleave;
+    /**
+     * Convert Float32 to Int16
+     */
+    private static float32ToInt16;
+    /**
+     * Convert Float32 to Int24 (stored as 3 bytes per sample)
+     */
+    private static float32ToInt24;
+    /**
+     * Create WAV file header
+     */
+    private static createWAVHeader;
+    /**
+     * Write string to DataView
+     */
+    private static writeString;
+}
+//# sourceMappingURL=AudioBufferToWav.d.ts.map

package/dist/utils/AudioBufferToWav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioBufferToWav.d.ts","sourceRoot":"","sources":["../../src/utils/AudioBufferToWav.ts"],"names":[],"mappings":"AAAA,qBAAa,gBAAgB;IACzB;;;OAGG;WACW,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,GAAE,OAAO,GAAG,OAAO,GAAG,SAAqB,GAAG,IAAI;IAmClG;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAezB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAS7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAY7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAiC9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAK7B"}

package/dist/utils/AudioBufferToWav.js

@@ -0,0 +1,110 @@
+export class AudioBufferToWav {
+    /**
+     * Encode to WAV format
+     * Reference: https://gist.github.com/meziantou/edb7217fddfbb70e899e
+     */
+    static encode(buffer, format = 'float32') {
+        const numChannels = buffer.numberOfChannels;
+        const sampleRate = buffer.sampleRate;
+        // Interleave channels
+        const interleaved = this.interleave(buffer);
+        // Convert to target format
+        let samples;
+        let bitsPerSample;
+        switch (format) {
+            case 'int16':
+                samples = this.float32ToInt16(interleaved);
+                bitsPerSample = 16;
+                break;
+            case 'int24':
+                samples = this.float32ToInt24(interleaved);
+                bitsPerSample = 24;
+                break;
+            case 'float32':
+            default:
+                samples = interleaved.buffer;
+                bitsPerSample = 32;
+                break;
+        }
+        // Create WAV header
+        const dataSize = samples.byteLength;
+        const header = this.createWAVHeader(numChannels, sampleRate, bitsPerSample, dataSize);
+        // Combine header and data
+        return new Blob([header, samples], { type: 'audio/wav' });
+    }
+    /**
+     * Interleave multi-channel audio buffer
+     */
+    static interleave(buffer) {
+        const numChannels = buffer.numberOfChannels;
+        const length = buffer.length * numChannels;
+        const result = new Float32Array(length);
+        for (let ch = 0; ch < numChannels; ch++) {
+            const channelData = buffer.getChannelData(ch);
+            for (let i = 0; i < buffer.length; i++) {
+                result[i * numChannels + ch] = channelData[i];
+            }
+        }
+        return result;
+    }
+    /**
+     * Convert Float32 to Int16
+     */
+    static float32ToInt16(buffer) {
+        const result = new Int16Array(buffer.length);
+        for (let i = 0; i < buffer.length; i++) {
+            const s = Math.max(-1, Math.min(1, buffer[i]));
+            result[i] = s < 0 ? s * 0x8000 : s * 0x7FFF;
+        }
+        return result.buffer;
+    }
+    /**
+     * Convert Float32 to Int24 (stored as 3 bytes per sample)
+     */
+    static float32ToInt24(buffer) {
+        const result = new Uint8Array(buffer.length * 3);
+        for (let i = 0; i < buffer.length; i++) {
+            const s = Math.max(-1, Math.min(1, buffer[i]));
+            const val = Math.floor((s < 0 ? s * 0x800000 : s * 0x7FFFFF));
+            result[i * 3 + 0] = (val >> 0) & 0xFF;
+            result[i * 3 + 1] = (val >> 8) & 0xFF;
+            result[i * 3 + 2] = (val >> 16) & 0xFF;
+        }
+        return result.buffer;
+    }
+    /**
+     * Create WAV file header
+     */
+    static createWAVHeader(numChannels, sampleRate, bitsPerSample, dataSize) {
+        const blockAlign = numChannels * (bitsPerSample / 8);
+        const byteRate = sampleRate * blockAlign;
+        const header = new ArrayBuffer(44);
+        const view = new DataView(header);
+        // RIFF chunk descriptor
+        this.writeString(view, 0, 'RIFF');
+        view.setUint32(4, 36 + dataSize, true);
+        this.writeString(view, 8, 'WAVE');
+        // fmt sub-chunk
+        this.writeString(view, 12, 'fmt ');
+        view.setUint32(16, 16, true); // subchunk1 size (16 for PCM)
+        view.setUint16(20, bitsPerSample === 32 ? 3 : 1, true); // audio format (1=PCM, 3=IEEE float)
+        view.setUint16(22, numChannels, true);
+        view.setUint32(24, sampleRate, true);
+        view.setUint32(28, byteRate, true);
+        view.setUint16(32, blockAlign, true);
+        view.setUint16(34, bitsPerSample, true);
+        // data sub-chunk
+        this.writeString(view, 36, 'data');
+        view.setUint32(40, dataSize, true);
+        return header;
+    }
+    /**
+     * Write string to DataView
+     */
+    static writeString(view, offset, string) {
+        for (let i = 0; i < string.length; i++) {
+            view.setUint8(offset + i, string.charCodeAt(i));
+        }
+    }
+}
+//# sourceMappingURL=AudioBufferToWav.js.map

package/dist/utils/AudioBufferToWav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioBufferToWav.js","sourceRoot":"","sources":["../../src/utils/AudioBufferToWav.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,gBAAgB;IACzB;;;OAGG;IACI,MAAM,CAAC,MAAM,CAAC,MAAmB,EAAE,SAAwC,SAAS;QACvF,MAAM,WAAW,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QAErC,sBAAsB;QACtB,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAE5C,2BAA2B;QAC3B,IAAI,OAAoB,CAAC;QACzB,IAAI,aAAqB,CAAC;QAE1B,QAAQ,MAAM,EAAE,CAAC;YACb,KAAK,OAAO;gBACR,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;gBAC3C,aAAa,GAAG,EAAE,CAAC;gBACnB,MAAM;YACV,KAAK,OAAO;gBACR,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;gBAC3C,aAAa,GAAG,EAAE,CAAC;gBACnB,MAAM;YACV,KAAK,SAAS,CAAC;YACf;gBACI,OAAO,GAAG,WAAW,CAAC,MAAqB,CAAC;gBAC5C,aAAa,GAAG,EAAE,CAAC;gBACnB,MAAM;QACd,CAAC;QAED,oBAAoB;QACpB,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC;QAEtF,0BAA0B;QAC1B,OAAO,IAAI,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,UAAU,CAAC,MAAmB;QACzC,MAAM,WAAW,GAAG,MAAM,CAAC,gBAAgB,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;QAC3C,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAExC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC;YACtC,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;YAC9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,MAAM,CAAC,CAAC,GAAG,WAAW,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;YAClD,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,cAAc,CAAC,MAAoB;QAC9C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;QAChD,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,cAAc,CAAC,MAAoB;QAC9C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACjD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;YAC9D,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;YACtC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;YACtC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;QAC3C,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;IACzB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,eAAe,CAC1B,WAAmB,EACnB,UAAkB,EAClB,aAAqB,EACrB,QAAgB;QAEhB,MAAM,UAAU,GAAG,WAAW,GAAG,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;QAElC,wBAAwB;QACxB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAClC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,GAAG,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;QAElC,gBAAgB;QAChB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,8BAA8B;QAC5D,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,qCAAqC;QAC7F,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;QAExC,iBAAiB;QACjB,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;QACnC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAEnC,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,WAAW,CAAC,IAAc,EAAE,MAAc,EAAE,MAAc;QACrE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;IACL,CAAC;CACJ"}

package/dist/utils/DitherProcessor.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Dither Processor
+ * Ardour 참조: libs/ardour/dither.cc
+ *
+ * Applies TPDF (Triangular Probability Density Function) dithering
+ * when converting from higher to lower bit depths.
+ */
+export declare enum DitherType {
+    NONE = "none",
+    TPDF = "tpdf",// Triangular PDF - standard for audio
+    SHAPED = "shaped"
+}
+export declare class DitherProcessor {
+    /**
+     * Apply dithering to Float32 samples before quantization.
+     * Should be called before converting to lower bit depth (e.g., float32 -> int16).
+     *
+     * @param samples Float32 audio data (modified in-place)
+     * @param targetBits Target bit depth (16 or 24)
+     * @param ditherType Type of dithering to apply
+     */
+    static apply(samples: Float32Array, targetBits: number, ditherType?: DitherType): void;
+    /**
+     * TPDF dithering: add triangular-distributed random noise at +-1 LSB
+     * and quantize to the target bit depth in a single step.
+     * This is the standard method used in professional audio mastering.
+     *
+     * The dither noise must be applied immediately before truncation to integer
+     * to correctly decorrelate the quantization error. Adding dither without
+     * quantizing would leave the samples in float space with no actual
+     * bit-depth reduction.
+     */
+    private static applyTPDF;
+    /**
+     * Noise-shaped dithering: error feedback filter for psychoacoustic masking.
+     * Uses a simple first-order high-pass error feedback filter.
+     * Like TPDF, dither is applied and quantization happens in a single step.
+     */
+    private static applyShaped;
+}
+//# sourceMappingURL=DitherProcessor.d.ts.map

package/dist/utils/DitherProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DitherProcessor.d.ts","sourceRoot":"","sources":["../../src/utils/DitherProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,UAAU;IAClB,IAAI,SAAS;IACb,IAAI,SAAS,CAAU,sCAAsC;IAC7D,MAAM,WAAW;CACpB;AAED,qBAAa,eAAe;IACxB;;;;;;;OAOG;WACW,KAAK,CACf,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,UAA4B,GACzC,IAAI;IAYP;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAcxB;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAoB7B"}