@drop-ai/core 0.2.0 → 0.3.1

package/dist/storage/SessionTemplate.js

@@ -1,76 +1,270 @@
 import { Session } from '../domain/Session';
 import { TrackType } from '../domain/Track';
+import { Signal } from '../lib/Signal';
+// ─── SessionTemplateManager ──────────────────────────────────────────────────
 /**
- * Built-in session templates.
+ * Manages session templates — predefined track / routing configurations
+ * that users can instantiate to quickly bootstrap new sessions.
+ *
+ * Includes a set of built-in factory templates (recording, podcast,
+ * mixing, mastering, production) and supports user-created custom
+ * 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,
-    },
-];
+export class SessionTemplateManager {
+    constructor() {
+        this._templates = new Map();
+        this.templatesChanged = new Signal();
+        // Seed with default templates
+        for (const t of SessionTemplateManager.getDefaultTemplates()) {
+            this._templates.set(t.id, t);
+        }
+    }
+    // ─── CRUD ─────────────────────────────────────────────────────────────────
+    /**
+     * Add a new template. An `id`, `createdAt`, and `updatedAt` are generated
+     * automatically.
+     */
+    addTemplate(template) {
+        const now = new Date().toISOString();
+        const full = Object.assign(Object.assign({}, template), { id: crypto.randomUUID(), createdAt: now, updatedAt: now });
+        this._templates.set(full.id, full);
+        this.templatesChanged.emit();
+        return full;
+    }
+    /**
+     * Update an existing template. Only the supplied fields are merged; the
+     * `updatedAt` timestamp is refreshed automatically.
+     */
+    updateTemplate(id, updates) {
+        const existing = this._templates.get(id);
+        if (!existing) {
+            throw new Error(`SessionTemplate not found: ${id}`);
+        }
+        const updated = Object.assign(Object.assign(Object.assign({}, existing), updates), { id, updatedAt: new Date().toISOString() });
+        this._templates.set(id, updated);
+        this.templatesChanged.emit();
+    }
+    /**
+     * Remove a template by ID.
+     */
+    removeTemplate(id) {
+        if (this._templates.delete(id)) {
+            this.templatesChanged.emit();
+        }
+    }
+    /**
+     * Get a single template by ID.
+     */
+    getTemplate(id) {
+        return this._templates.get(id);
+    }
+    /**
+     * Get all registered templates.
+     */
+    getAllTemplates() {
+        return Array.from(this._templates.values());
+    }
+    /**
+     * Get templates filtered by category.
+     */
+    getTemplatesByCategory(category) {
+        return this.getAllTemplates().filter(t => t.category === category);
+    }
+    // ─── Create template from a live Session ──────────────────────────────────
+    /**
+     * Snapshot a Session into a reusable template.
+     */
+    static createFromSession(session, name, description) {
+        const trackTemplates = session.tracks.map((track) => ({
+            name: track.name,
+            type: track.type,
+            color: track.color,
+            armed: track.armed,
+            monitorMode: track.monitorMode,
+        }));
+        const now = new Date().toISOString();
+        return {
+            id: crypto.randomUUID(),
+            name,
+            description,
+            category: 'custom',
+            sampleRate: session.sampleRate,
+            tempo: session.tempo,
+            timeSignature: [...session.timeSignature],
+            tracks: trackTemplates,
+            createdAt: now,
+            updatedAt: now,
+        };
+    }
+    // ─── Built-in default templates ──────────────────────────────────────────
+    static getDefaultTemplates() {
+        const now = new Date().toISOString();
+        return [
+            // 1. Empty Session
+            {
+                id: 'tpl-empty',
+                name: 'Empty Session',
+                description: 'A blank slate with no tracks — start from scratch.',
+                category: 'custom',
+                sampleRate: 44100,
+                tempo: 120,
+                timeSignature: [4, 4],
+                tracks: [],
+                createdAt: now,
+                updatedAt: now,
+            },
+            // 2. Basic Recording (8 audio tracks)
+            {
+                id: 'tpl-basic-recording',
+                name: 'Basic Recording',
+                description: '8 audio tracks pre-named for a typical drum/bass/vocal recording session.',
+                category: 'recording',
+                sampleRate: 48000,
+                tempo: 120,
+                timeSignature: [4, 4],
+                tracks: [
+                    { name: 'Kick', type: TrackType.AUDIO, color: '#ff6b6b', armed: true },
+                    { name: 'Snare', type: TrackType.AUDIO, color: '#ff922b', armed: true },
+                    { name: 'HiHat', type: TrackType.AUDIO, color: '#ffd43b', armed: true },
+                    { name: 'Toms', type: TrackType.AUDIO, color: '#51cf66', armed: true },
+                    { name: 'OHL', type: TrackType.AUDIO, color: '#20c997', armed: true },
+                    { name: 'OHR', type: TrackType.AUDIO, color: '#4a9eff', armed: true },
+                    { name: 'Bass DI', type: TrackType.AUDIO, color: '#cc5de8', armed: true },
+                    { name: 'Vocal', type: TrackType.AUDIO, color: '#f06595', armed: true },
+                ],
+                createdAt: now,
+                updatedAt: now,
+            },
+            // 3. Podcast (2 audio + 1 music bed)
+            {
+                id: 'tpl-podcast',
+                name: 'Podcast',
+                description: '2 voice tracks (Host, Guest) and a music-bed audio track for podcast production.',
+                category: 'podcast',
+                sampleRate: 48000,
+                tempo: 120,
+                timeSignature: [4, 4],
+                tracks: [
+                    { name: 'Host', type: TrackType.AUDIO, color: '#4a9eff', armed: true, monitorMode: 'auto' },
+                    { name: 'Guest', type: TrackType.AUDIO, color: '#51cf66', armed: true, monitorMode: 'auto' },
+                    { name: 'Music Bed', type: TrackType.AUDIO, color: '#cc5de8', armed: false },
+                ],
+                createdAt: now,
+                updatedAt: now,
+            },
+            // 4. Song Production (4 audio + 2 MIDI + 1 bus)
+            {
+                id: 'tpl-song-production',
+                name: 'Song Production',
+                description: '4 audio tracks, 2 MIDI tracks, and a Drums bus for modern song production.',
+                category: 'production',
+                sampleRate: 48000,
+                tempo: 128,
+                timeSignature: [4, 4],
+                tracks: [
+                    { name: 'Kick', type: TrackType.AUDIO, color: '#ff6b6b' },
+                    { name: 'Snare', type: TrackType.AUDIO, color: '#ff922b' },
+                    { name: 'HiHat', type: TrackType.AUDIO, color: '#ffd43b' },
+                    { name: 'Vocal', type: TrackType.AUDIO, color: '#f06595', armed: true },
+                    { name: 'Synth Lead', type: TrackType.MIDI, color: '#4a9eff' },
+                    { name: 'Synth Pad', type: TrackType.MIDI, color: '#cc5de8' },
+                    { name: 'Drums Bus', type: TrackType.BUS, color: '#868e96' },
+                ],
+                createdAt: now,
+                updatedAt: now,
+            },
+            // 5. Mixing (pre-configured bus structure)
+            {
+                id: 'tpl-mixing',
+                name: 'Mixing',
+                description: 'Pre-configured bus structure for mixing: Drums, Bass, Keys, Vocals, and FX buses.',
+                category: 'mixing',
+                sampleRate: 48000,
+                tempo: 120,
+                timeSignature: [4, 4],
+                tracks: [
+                    { name: 'Drums Bus', type: TrackType.BUS, color: '#ff6b6b' },
+                    { name: 'Bass Bus', type: TrackType.BUS, color: '#ff922b' },
+                    { name: 'Keys Bus', type: TrackType.BUS, color: '#ffd43b' },
+                    { name: 'Vocals Bus', type: TrackType.BUS, color: '#4a9eff' },
+                    { name: 'FX Bus', type: TrackType.BUS, color: '#cc5de8' },
+                ],
+                createdAt: now,
+                updatedAt: now,
+            },
+            // 6. Mastering (1 stereo audio + 1 reference)
+            {
+                id: 'tpl-mastering',
+                name: 'Mastering',
+                description: '1 stereo audio track for the mix and a reference track for A/B comparison.',
+                category: 'mastering',
+                sampleRate: 96000,
+                tempo: 120,
+                timeSignature: [4, 4],
+                tracks: [
+                    { name: 'Mix', type: TrackType.AUDIO, color: '#4a9eff' },
+                    { name: 'Reference', type: TrackType.AUDIO, color: '#868e96' },
+                ],
+                createdAt: now,
+                updatedAt: now,
+            },
+        ];
+    }
+    // ─── Serialization ────────────────────────────────────────────────────────
+    /**
+     * Serialize all templates to a JSON string.
+     */
+    serialize() {
+        const snapshot = {
+            templates: this.getAllTemplates(),
+        };
+        return JSON.stringify(snapshot, null, 2);
+    }
+    /**
+     * Restore a SessionTemplateManager from a JSON string produced by
+     * `serialize()`.
+     */
+    static deserialize(json) {
+        const snapshot = JSON.parse(json);
+        const manager = new SessionTemplateManager();
+        // Clear the defaults that the constructor seeded
+        manager._templates.clear();
+        for (const t of snapshot.templates) {
+            manager._templates.set(t.id, t);
+        }
+        return manager;
+    }
+}
+// ─── Convenience helpers (backward-compatible with old API) ──────────────────
 /**
  * Returns the list of available session templates.
  */
 export function getTemplates() {
-    return [...TEMPLATES];
+    return SessionTemplateManager.getDefaultTemplates();
 }
 /**
  * Create a new Session from a template.
  *
  * Each template pre-configures tracks with default names, colors,
- * and routing through the master bus.
+ * armed state, and routing through the master bus.
  */
 export function createFromTemplate(templateId) {
-    const template = TEMPLATES.find(t => t.id === templateId);
+    const templates = SessionTemplateManager.getDefaultTemplates();
+    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;
+    const session = new Session(template.name, undefined, template.sampleRate);
+    session.tempo = template.tempo;
+    session.timeSignature = [...template.timeSignature];
+    for (const tt of template.tracks) {
+        const track = session.addTrack(tt.name, tt.type);
+        if (tt.color) {
+            track.color = tt.color;
         }
-        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;
+        if (tt.armed) {
+            track.armed = true;
         }
-        default:
-            throw new Error(`Template factory not implemented: ${templateId}`);
     }
     return session;
 }

package/dist/storage/SessionTemplate.js.map

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

package/dist/utils/BwfMetadataWriter.d.ts

@@ -0,0 +1,41 @@
+/**
+ * BWF (Broadcast WAV) Metadata Writer
+ *
+ * Adds a 'bext' chunk to a WAV file for broadcast metadata (EBU Tech 3285).
+ *
+ * BWF extends WAV by adding a 'bext' chunk with:
+ *   - Description (256 chars)
+ *   - Originator (32 chars)
+ *   - OriginatorReference (32 chars)
+ *   - OriginationDate (10 chars: YYYY-MM-DD)
+ *   - OriginationTime (8 chars: HH:MM:SS)
+ *   - TimeReference (64-bit sample count since midnight)
+ *   - Version (2 bytes)
+ *   - UMID (64 bytes)
+ *   - LoudnessValue (2 bytes)
+ *   - LoudnessRange (2 bytes)
+ *   - MaxTruePeakLevel (2 bytes)
+ *   - MaxMomentaryLoudness (2 bytes)
+ *   - MaxShortTermLoudness (2 bytes)
+ */
+export interface BwfChunkData {
+    description?: string;
+    originator?: string;
+    originatorReference?: string;
+    originationDate?: string;
+    originationTime?: string;
+    timeReference?: number;
+    loudnessValue?: number;
+    loudnessRange?: number;
+    maxTruePeakLevel?: number;
+}
+/**
+ * Build a BWF 'bext' chunk as a Uint8Array.
+ */
+export declare function buildBextChunk(data: BwfChunkData): Uint8Array;
+/**
+ * Insert a bext chunk into a WAV blob, creating a BWF file.
+ * Inserts after the 'fmt ' chunk and before the 'data' chunk.
+ */
+export declare function insertBextIntoWav(wavBlob: Blob, bextData: BwfChunkData): Promise<Blob>;
+//# sourceMappingURL=BwfMetadataWriter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BwfMetadataWriter.d.ts","sourceRoot":"","sources":["../../src/utils/BwfMetadataWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,YAAY;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,CAsE7D;AAQD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDtF"}

package/dist/utils/BwfMetadataWriter.js

@@ -0,0 +1,130 @@
+/**
+ * BWF (Broadcast WAV) Metadata Writer
+ *
+ * Adds a 'bext' chunk to a WAV file for broadcast metadata (EBU Tech 3285).
+ *
+ * BWF extends WAV by adding a 'bext' chunk with:
+ *   - Description (256 chars)
+ *   - Originator (32 chars)
+ *   - OriginatorReference (32 chars)
+ *   - OriginationDate (10 chars: YYYY-MM-DD)
+ *   - OriginationTime (8 chars: HH:MM:SS)
+ *   - TimeReference (64-bit sample count since midnight)
+ *   - Version (2 bytes)
+ *   - UMID (64 bytes)
+ *   - LoudnessValue (2 bytes)
+ *   - LoudnessRange (2 bytes)
+ *   - MaxTruePeakLevel (2 bytes)
+ *   - MaxMomentaryLoudness (2 bytes)
+ *   - MaxShortTermLoudness (2 bytes)
+ */
+/**
+ * Build a BWF 'bext' chunk as a Uint8Array.
+ */
+export function buildBextChunk(data) {
+    var _a;
+    // Fixed-size bext chunk (version 2): 602 bytes minimum
+    const BEXT_SIZE = 602;
+    const chunk = new Uint8Array(8 + BEXT_SIZE); // 8 for chunk ID + size
+    const view = new DataView(chunk.buffer);
+    // Chunk ID: "bext"
+    chunk[0] = 0x62; // b
+    chunk[1] = 0x65; // e
+    chunk[2] = 0x78; // x
+    chunk[3] = 0x74; // t
+    // Chunk size
+    view.setUint32(4, BEXT_SIZE, true);
+    const encoder = new TextEncoder();
+    // All data offsets below are relative to chunk start (includes 8-byte header)
+    const H = 8; // chunk header size (ID + size)
+    // Description (256 bytes, data offset 0)
+    writeFixedString(chunk, H + 0, data.description || '', 256);
+    // Originator (32 bytes, data offset 256)
+    writeFixedString(chunk, H + 256, data.originator || 'drop.ai Web DAW', 32);
+    // OriginatorReference (32 bytes, data offset 288)
+    writeFixedString(chunk, H + 288, data.originatorReference || '', 32);
+    // OriginationDate (10 bytes, data offset 320)
+    const now = new Date();
+    const dateStr = data.originationDate || `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, '0')}-${String(now.getDate()).padStart(2, '0')}`;
+    writeFixedString(chunk, H + 320, dateStr, 10);
+    // OriginationTime (8 bytes, data offset 330)
+    const timeStr = data.originationTime || `${String(now.getHours()).padStart(2, '0')}:${String(now.getMinutes()).padStart(2, '0')}:${String(now.getSeconds()).padStart(2, '0')}`;
+    writeFixedString(chunk, H + 330, timeStr, 8);
+    // TimeReference (64-bit, data offset 338)
+    const timeRef = (_a = data.timeReference) !== null && _a !== void 0 ? _a : 0;
+    view.setUint32(H + 338, timeRef & 0xFFFFFFFF, true);
+    view.setUint32(H + 342, Math.floor(timeRef / 0x100000000) & 0xFFFFFFFF, true);
+    // Version (2 bytes, data offset 346) — BWF version 2
+    view.setUint16(H + 346, 2, true);
+    // UMID (64 bytes, data offset 348) — zeros (no UMID)
+    // Already zeros
+    // LoudnessValue (2 bytes, data offset 412)
+    if (data.loudnessValue !== undefined) {
+        view.setInt16(H + 412, Math.round(data.loudnessValue * 100), true);
+    }
+    // LoudnessRange (2 bytes, data offset 414)
+    if (data.loudnessRange !== undefined) {
+        view.setInt16(H + 414, Math.round(data.loudnessRange * 100), true);
+    }
+    // MaxTruePeakLevel (2 bytes, data offset 416)
+    if (data.maxTruePeakLevel !== undefined) {
+        view.setInt16(H + 416, Math.round(data.maxTruePeakLevel * 100), true);
+    }
+    // MaxMomentaryLoudness (2 bytes, data offset 418) — skip
+    // MaxShortTermLoudness (2 bytes, data offset 420) — skip
+    // Reserved (180 bytes, data offset 422) — already zeros
+    return chunk;
+}
+function writeFixedString(target, offset, str, maxLen) {
+    for (let i = 0; i < maxLen; i++) {
+        target[offset + i] = i < str.length ? str.charCodeAt(i) & 0xFF : 0;
+    }
+}
+/**
+ * Insert a bext chunk into a WAV blob, creating a BWF file.
+ * Inserts after the 'fmt ' chunk and before the 'data' chunk.
+ */
+export function insertBextIntoWav(wavBlob, bextData) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => {
+            try {
+                const wavBuffer = reader.result;
+                const wavBytes = new Uint8Array(wavBuffer);
+                const bextChunk = buildBextChunk(bextData);
+                // Find 'data' chunk position
+                let dataOffset = 12; // skip RIFF header
+                while (dataOffset < wavBytes.length - 8) {
+                    const chunkId = String.fromCharCode(wavBytes[dataOffset], wavBytes[dataOffset + 1], wavBytes[dataOffset + 2], wavBytes[dataOffset + 3]);
+                    const chunkSize = new DataView(wavBuffer).getUint32(dataOffset + 4, true);
+                    if (chunkId === 'data') {
+                        break;
+                    }
+                    dataOffset += 8 + chunkSize;
+                    // Align to even boundary
+                    if (dataOffset % 2 !== 0)
+                        dataOffset++;
+                }
+                // Insert bext chunk before 'data'
+                const before = wavBytes.slice(0, dataOffset);
+                const after = wavBytes.slice(dataOffset);
+                // Update RIFF size
+                const newSize = wavBytes.length + bextChunk.length;
+                const result = new Uint8Array(newSize);
+                result.set(before, 0);
+                result.set(bextChunk, dataOffset);
+                result.set(after, dataOffset + bextChunk.length);
+                // Update RIFF chunk size (offset 4)
+                const resultView = new DataView(result.buffer);
+                resultView.setUint32(4, newSize - 8, true);
+                resolve(new Blob([result], { type: 'audio/wav' }));
+            }
+            catch (e) {
+                reject(e);
+            }
+        };
+        reader.onerror = () => reject(reader.error);
+        reader.readAsArrayBuffer(wavBlob);
+    });
+}
+//# sourceMappingURL=BwfMetadataWriter.js.map

package/dist/utils/BwfMetadataWriter.js.map

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

package/dist/utils/DitherProcessor.d.ts

@@ -1,6 +1,5 @@
 /**
  * Dither Processor
- * Ardour 참조: libs/ardour/dither.cc
  *
  * Applies TPDF (Triangular Probability Density Function) dithering
  * when converting from higher to lower bit depths.

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

@@ -1 +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"}
+{"version":3,"file":"DitherProcessor.d.ts","sourceRoot":"","sources":["../../src/utils/DitherProcessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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"}

package/dist/utils/DitherProcessor.js

@@ -1,6 +1,5 @@
 /**
  * Dither Processor
- * Ardour 참조: libs/ardour/dither.cc
  *
  * Applies TPDF (Triangular Probability Density Function) dithering
  * when converting from higher to lower bit depths.

package/dist/utils/DitherProcessor.js.map

@@ -1 +1 @@
-{"version":3,"file":"DitherProcessor.js","sourceRoot":"","sources":["../../src/utils/DitherProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IAClB,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,+BAAiB,CAAA;AACrB,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AAED,MAAM,OAAO,eAAe;IACxB;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CACf,OAAqB,EACrB,UAAkB,EAClB,aAAyB,UAAU,CAAC,IAAI;QAExC,IAAI,UAAU,KAAK,UAAU,CAAC,IAAI;YAAE,OAAO;QAE3C,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;QAE3D,IAAI,UAAU,KAAK,UAAU,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAC9C,CAAC;aAAM,IAAI,UAAU,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;YAC1C,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACK,MAAM,CAAC,SAAS,CAAC,OAAqB,EAAE,gBAAwB;QACpE,MAAM,KAAK,GAAG,GAAG,GAAG,gBAAgB,CAAC,CAAC,qBAAqB;QAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,uEAAuE;YACvE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC;YAE5C,2EAA2E;YAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;YACpE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QAC3B,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,WAAW,CAAC,OAAqB,EAAE,gBAAwB;QACtE,MAAM,KAAK,GAAG,GAAG,GAAG,gBAAgB,CAAC,CAAC,qBAAqB;QAC3D,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,iBAAiB;YACjB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC;YAE5C,iDAAiD;YACjD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,aAAa,GAAG,GAAG,CAAC;YAEzD,+BAA+B;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;YACrD,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAEvC,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QAC3B,CAAC;IACL,CAAC;CACJ"}
+{"version":3,"file":"DitherProcessor.js","sourceRoot":"","sources":["../../src/utils/DitherProcessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,UAIX;AAJD,WAAY,UAAU;IAClB,2BAAa,CAAA;IACb,2BAAa,CAAA;IACb,+BAAiB,CAAA;AACrB,CAAC,EAJW,UAAU,KAAV,UAAU,QAIrB;AAED,MAAM,OAAO,eAAe;IACxB;;;;;;;OAOG;IACI,MAAM,CAAC,KAAK,CACf,OAAqB,EACrB,UAAkB,EAClB,aAAyB,UAAU,CAAC,IAAI;QAExC,IAAI,UAAU,KAAK,UAAU,CAAC,IAAI;YAAE,OAAO;QAE3C,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;QAE3D,IAAI,UAAU,KAAK,UAAU,CAAC,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAC9C,CAAC;aAAM,IAAI,UAAU,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;YAC1C,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;QAChD,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACK,MAAM,CAAC,SAAS,CAAC,OAAqB,EAAE,gBAAwB;QACpE,MAAM,KAAK,GAAG,GAAG,GAAG,gBAAgB,CAAC,CAAC,qBAAqB;QAC3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,uEAAuE;YACvE,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC;YAE5C,2EAA2E;YAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;YACpE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QAC3B,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,WAAW,CAAC,OAAqB,EAAE,gBAAwB;QACtE,MAAM,KAAK,GAAG,GAAG,GAAG,gBAAgB,CAAC,CAAC,qBAAqB;QAC3D,IAAI,aAAa,GAAG,CAAC,CAAC;QAEtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,iBAAiB;YACjB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,MAAM,MAAM,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,gBAAgB,CAAC;YAE5C,iDAAiD;YACjD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,aAAa,GAAG,GAAG,CAAC;YAEzD,+BAA+B;YAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC;YACrD,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAEvC,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QAC3B,CAAC;IACL,CAAC;CACJ"}

package/dist/utils/FilenameTemplate.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Filename Template Parser
+ *
+ * Supported tokens:
+ *   %s - Session name
+ *   %n - Timespan name (range/region name)
+ *   %d - Date (YYYY-MM-DD)
+ *   %t - Time (HH-MM-SS)
+ *   %f - Format (wav/mp3/ogg/flac)
+ *   %r - Revision number (auto-increment)
+ *   %b - Bit depth / bitrate
+ *   %c - Channel config (stereo/mono)
+ *   %T - Track name (for stem export)
+ */
+export interface FilenameTemplateContext {
+    sessionName?: string;
+    timespanName?: string;
+    format?: string;
+    revision?: number;
+    bitDepthOrRate?: string;
+    channelConfig?: string;
+    trackName?: string;
+}
+/**
+ * Resolve a filename template string into an actual filename.
+ */
+export declare function resolveFilenameTemplate(template: string, context: FilenameTemplateContext): string;
+/**
+ * Get a human-readable preview of what tokens will resolve to.
+ */
+export declare function previewFilenameTemplate(template: string, context: FilenameTemplateContext): string;
+/**
+ * List all supported tokens with descriptions.
+ */
+export declare function getTemplateTokens(): Array<{
+    token: string;
+    description: string;
+}>;
+//# sourceMappingURL=FilenameTemplate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FilenameTemplate.d.ts","sourceRoot":"","sources":["../../src/utils/FilenameTemplate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,uBAAuB;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uBAAuB,GACjC,MAAM,CAiCR;AASD;;GAEG;AACH,wBAAgB,uBAAuB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,uBAAuB,GACjC,MAAM,CAIR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAYjF"}