@drop-ai/core 0.2.0 → 0.3.0

package/dist/midi/MidiFileParser.js

@@ -0,0 +1,246 @@
+/**
+ * Standard MIDI File (SMF) Parser
+ * Ardour reference: libs/evoral/SMF.cc
+ *
+ * Parses SMF Type 0 (single track) and Type 1 (multi-track) files.
+ * Converts MIDI ticks to frames based on tempo.
+ */
+/**
+ * Parse a Standard MIDI File from an ArrayBuffer.
+ */
+export function parseMidiFile(data, sampleRate = 44100) {
+    const view = new DataView(data);
+    let offset = 0;
+    // Read header chunk "MThd"
+    const headerTag = readString(view, offset, 4);
+    if (headerTag !== 'MThd') {
+        throw new Error('Not a valid MIDI file: missing MThd header');
+    }
+    offset += 4;
+    const headerLength = view.getUint32(offset, false);
+    offset += 4;
+    const format = view.getUint16(offset, false);
+    offset += 2;
+    const numTracks = view.getUint16(offset, false);
+    offset += 2;
+    const division = view.getUint16(offset, false);
+    offset += 2;
+    // Skip any remaining header bytes
+    offset += headerLength - 6;
+    let ticksPerBeat;
+    if (division & 0x8000) {
+        // SMPTE-based: frames per second + ticks per frame
+        const fps = -(((division >> 8) & 0xFF) << 24 >> 24); // sign-extend
+        const tpf = division & 0xFF;
+        ticksPerBeat = fps * tpf; // approximate
+    }
+    else {
+        ticksPerBeat = division;
+    }
+    // Parse track chunks
+    let globalTempo = 120; // Default BPM
+    const tracks = [];
+    for (let t = 0; t < numTracks && offset < data.byteLength; t++) {
+        const trackTag = readString(view, offset, 4);
+        if (trackTag !== 'MTrk') {
+            throw new Error(`Expected MTrk at offset ${offset}, got ${trackTag}`);
+        }
+        offset += 4;
+        const trackLength = view.getUint32(offset, false);
+        offset += 4;
+        const trackEnd = offset + trackLength;
+        const track = parseTrack(view, offset, trackEnd, ticksPerBeat, sampleRate);
+        // Extract tempo if present (first track in Type 1)
+        if (track.tempo > 0) {
+            globalTempo = track.tempo;
+        }
+        tracks.push({
+            name: track.name || `Track ${t + 1}`,
+            notes: track.notes,
+            channel: track.channel,
+        });
+        offset = trackEnd;
+    }
+    // Apply tempo to convert ticks to frames
+    const secondsPerTick = 60 / (globalTempo * ticksPerBeat);
+    for (const track of tracks) {
+        for (const note of track.notes) {
+            note.startFrame = Math.round(note.startTick * secondsPerTick * sampleRate);
+            note.durationFrames = Math.round(note.durationTicks * secondsPerTick * sampleRate);
+        }
+    }
+    return {
+        format,
+        numTracks,
+        ticksPerBeat,
+        tempo: globalTempo,
+        tracks,
+    };
+}
+function parseTrack(view, start, end, ticksPerBeat, sampleRate) {
+    let offset = start;
+    let tick = 0;
+    let name = '';
+    let tempo = 0;
+    let primaryChannel = 0;
+    // Track active notes for Note-On/Note-Off pairing
+    const activeNotes = new Map();
+    const notes = [];
+    let prevStatus = 0;
+    while (offset < end) {
+        // Read delta time (variable-length quantity)
+        const [deltaTime, bytesRead] = readVLQ(view, offset);
+        offset += bytesRead;
+        tick += deltaTime;
+        if (offset >= end)
+            break;
+        let statusByte = view.getUint8(offset);
+        // Running status
+        if (statusByte < 0x80) {
+            statusByte = prevStatus;
+        }
+        else {
+            offset++;
+            prevStatus = statusByte;
+        }
+        const type = statusByte & 0xF0;
+        const channel = statusByte & 0x0F;
+        switch (type) {
+            case 0x90: { // Note On
+                const pitch = view.getUint8(offset++);
+                const velocity = view.getUint8(offset++);
+                if (velocity === 0) {
+                    // Note On with velocity 0 = Note Off
+                    finishNote(activeNotes, notes, channel, pitch, tick);
+                }
+                else {
+                    const key = `${channel}-${pitch}`;
+                    // End any existing note on same key
+                    finishNote(activeNotes, notes, channel, pitch, tick);
+                    activeNotes.set(key, { pitch, velocity, channel, startTick: tick });
+                    primaryChannel = channel;
+                }
+                break;
+            }
+            case 0x80: { // Note Off
+                const pitch = view.getUint8(offset++);
+                offset++; // velocity (ignored)
+                finishNote(activeNotes, notes, channel, pitch, tick);
+                break;
+            }
+            case 0xA0: // Aftertouch
+            case 0xB0: // Control Change
+            case 0xE0: // Pitch Bend
+                offset += 2;
+                break;
+            case 0xC0: // Program Change
+            case 0xD0: // Channel Pressure
+                offset += 1;
+                break;
+            case 0xF0: {
+                if (statusByte === 0xFF) {
+                    // Meta event
+                    const metaType = view.getUint8(offset++);
+                    const [metaLength, metaLenBytes] = readVLQ(view, offset);
+                    offset += metaLenBytes;
+                    if (metaType === 0x03) {
+                        // Track Name
+                        name = readString(view, offset, metaLength);
+                    }
+                    else if (metaType === 0x51) {
+                        // Tempo (microseconds per quarter note)
+                        if (metaLength >= 3) {
+                            const uspqn = (view.getUint8(offset) << 16) |
+                                (view.getUint8(offset + 1) << 8) |
+                                view.getUint8(offset + 2);
+                            tempo = 60000000 / uspqn;
+                        }
+                    }
+                    else if (metaType === 0x2F) {
+                        // End of Track
+                        offset += metaLength;
+                        // Close any remaining active notes
+                        for (const [key, note] of activeNotes) {
+                            notes.push({
+                                pitch: note.pitch,
+                                velocity: note.velocity,
+                                channel: note.channel,
+                                startTick: note.startTick,
+                                durationTicks: tick - note.startTick,
+                                startFrame: 0,
+                                durationFrames: 0,
+                            });
+                        }
+                        activeNotes.clear();
+                        return { name, notes, channel: primaryChannel, tempo };
+                    }
+                    offset += metaLength;
+                }
+                else if (statusByte === 0xF0 || statusByte === 0xF7) {
+                    // SysEx
+                    const [sysexLen, sysexLenBytes] = readVLQ(view, offset);
+                    offset += sysexLenBytes + sysexLen;
+                }
+                else {
+                    // Other system messages
+                    break;
+                }
+                break;
+            }
+            default:
+                // Unknown — skip
+                break;
+        }
+    }
+    // Close remaining notes
+    for (const [key, note] of activeNotes) {
+        notes.push({
+            pitch: note.pitch,
+            velocity: note.velocity,
+            channel: note.channel,
+            startTick: note.startTick,
+            durationTicks: tick - note.startTick,
+            startFrame: 0,
+            durationFrames: 0,
+        });
+    }
+    return { name, notes, channel: primaryChannel, tempo };
+}
+function finishNote(activeNotes, notes, channel, pitch, tick) {
+    const key = `${channel}-${pitch}`;
+    const active = activeNotes.get(key);
+    if (active) {
+        notes.push({
+            pitch: active.pitch,
+            velocity: active.velocity,
+            channel: active.channel,
+            startTick: active.startTick,
+            durationTicks: tick - active.startTick,
+            startFrame: 0,
+            durationFrames: 0,
+        });
+        activeNotes.delete(key);
+    }
+}
+function readVLQ(view, offset) {
+    let value = 0;
+    let bytesRead = 0;
+    while (offset + bytesRead < view.byteLength) {
+        const byte = view.getUint8(offset + bytesRead);
+        value = (value << 7) | (byte & 0x7F);
+        bytesRead++;
+        if ((byte & 0x80) === 0)
+            break;
+        if (bytesRead > 4)
+            break; // VLQ can't be more than 4 bytes
+    }
+    return [value, bytesRead];
+}
+function readString(view, offset, length) {
+    let str = '';
+    for (let i = 0; i < length && offset + i < view.byteLength; i++) {
+        str += String.fromCharCode(view.getUint8(offset + i));
+    }
+    return str;
+}
+//# sourceMappingURL=MidiFileParser.js.map

package/dist/midi/MidiFileParser.js.map

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

package/dist/midi/MidiFileWriter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Standard MIDI File (SMF) Writer
+ * Ardour reference: libs/ardour/smf_source.cc / export_smf_writer.cc
+ *
+ * Generates SMF Type 1 files from MidiRegion/MidiNote data.
+ */
+export interface MidiWriteNote {
+    pitch: number;
+    velocity: number;
+    channel: number;
+    startFrame: number;
+    durationFrames: number;
+}
+export interface MidiWriteTrack {
+    name: string;
+    notes: MidiWriteNote[];
+}
+export interface MidiWriteOptions {
+    ticksPerBeat?: number;
+    tempo?: number;
+    sampleRate?: number;
+}
+/**
+ * Write a Standard MIDI File (Type 1) to an ArrayBuffer.
+ */
+export declare function writeMidiFile(tracks: MidiWriteTrack[], options?: MidiWriteOptions): ArrayBuffer;
+/**
+ * Convenience: create a MIDI file Blob from tracks.
+ */
+export declare function createMidiBlob(tracks: MidiWriteTrack[], options?: MidiWriteOptions): Blob;
+//# sourceMappingURL=MidiFileWriter.d.ts.map

package/dist/midi/MidiFileWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MidiFileWriter.d.ts","sourceRoot":"","sources":["../../src/midi/MidiFileWriter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,aAAa,CACzB,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,GAAE,gBAAqB,GAC/B,WAAW,CA0Cb;AAqJD;;GAEG;AACH,wBAAgB,cAAc,CAC1B,MAAM,EAAE,cAAc,EAAE,EACxB,OAAO,CAAC,EAAE,gBAAgB,GAC3B,IAAI,CAGN"}

package/dist/midi/MidiFileWriter.js

@@ -0,0 +1,160 @@
+/**
+ * Standard MIDI File (SMF) Writer
+ * Ardour reference: libs/ardour/smf_source.cc / export_smf_writer.cc
+ *
+ * Generates SMF Type 1 files from MidiRegion/MidiNote data.
+ */
+/**
+ * Write a Standard MIDI File (Type 1) to an ArrayBuffer.
+ */
+export function writeMidiFile(tracks, options = {}) {
+    var _a, _b, _c;
+    const ticksPerBeat = (_a = options.ticksPerBeat) !== null && _a !== void 0 ? _a : 480;
+    const tempo = (_b = options.tempo) !== null && _b !== void 0 ? _b : 120;
+    const sampleRate = (_c = options.sampleRate) !== null && _c !== void 0 ? _c : 44100;
+    // Convert frames to ticks
+    const secondsPerTick = 60 / (tempo * ticksPerBeat);
+    const framesToTicks = (frames) => Math.round(frames / (secondsPerTick * sampleRate));
+    const trackChunks = [];
+    // Track 0: tempo track
+    trackChunks.push(buildTempoTrack(tempo, ticksPerBeat));
+    // Subsequent tracks: note data
+    for (const track of tracks) {
+        trackChunks.push(buildNoteTrack(track, framesToTicks));
+    }
+    // Build file header
+    const numTracks = trackChunks.length;
+    const headerChunk = buildHeaderChunk(1, numTracks, ticksPerBeat);
+    // Calculate total size
+    let totalSize = headerChunk.byteLength;
+    for (const chunk of trackChunks) {
+        totalSize += chunk.byteLength;
+    }
+    // Combine all chunks
+    const result = new Uint8Array(totalSize);
+    let offset = 0;
+    result.set(new Uint8Array(headerChunk), offset);
+    offset += headerChunk.byteLength;
+    for (const chunk of trackChunks) {
+        result.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return result.buffer;
+}
+function buildHeaderChunk(format, numTracks, ticksPerBeat) {
+    const buffer = new ArrayBuffer(14);
+    const view = new DataView(buffer);
+    // "MThd"
+    view.setUint8(0, 0x4D);
+    view.setUint8(1, 0x54);
+    view.setUint8(2, 0x68);
+    view.setUint8(3, 0x64);
+    // Header length (always 6)
+    view.setUint32(4, 6, false);
+    // Format
+    view.setUint16(8, format, false);
+    // Number of tracks
+    view.setUint16(10, numTracks, false);
+    // Division (ticks per beat)
+    view.setUint16(12, ticksPerBeat, false);
+    return buffer;
+}
+function buildTempoTrack(tempo, ticksPerBeat) {
+    const events = [];
+    // Delta time 0
+    events.push(0x00);
+    // Set Tempo meta event (FF 51 03 tt tt tt)
+    const uspqn = Math.round(60000000 / tempo);
+    events.push(0xFF, 0x51, 0x03);
+    events.push((uspqn >> 16) & 0xFF);
+    events.push((uspqn >> 8) & 0xFF);
+    events.push(uspqn & 0xFF);
+    // End of Track (delta=0)
+    events.push(0x00, 0xFF, 0x2F, 0x00);
+    return wrapTrackChunk(new Uint8Array(events));
+}
+function buildNoteTrack(track, framesToTicks) {
+    const events = [];
+    // Track Name meta event
+    if (track.name) {
+        const nameBytes = new TextEncoder().encode(track.name);
+        events.push({
+            tick: 0,
+            data: [0xFF, 0x03, ...writeVLQ(nameBytes.length), ...nameBytes],
+        });
+    }
+    // Note events
+    for (const note of track.notes) {
+        const startTick = framesToTicks(note.startFrame);
+        const endTick = framesToTicks(note.startFrame + note.durationFrames);
+        const channel = Math.max(0, Math.min(15, note.channel));
+        // Note On
+        events.push({
+            tick: startTick,
+            data: [0x90 | channel, note.pitch & 0x7F, note.velocity & 0x7F],
+        });
+        // Note Off
+        events.push({
+            tick: endTick,
+            data: [0x80 | channel, note.pitch & 0x7F, 0x40], // release velocity 64
+        });
+    }
+    // Sort by tick, Note Off before Note On at same tick
+    events.sort((a, b) => {
+        if (a.tick !== b.tick)
+            return a.tick - b.tick;
+        // Note Off (0x80) should come before Note On (0x90)
+        const aIsOff = (a.data[0] & 0xF0) === 0x80 ? 0 : 1;
+        const bIsOff = (b.data[0] & 0xF0) === 0x80 ? 0 : 1;
+        return aIsOff - bIsOff;
+    });
+    // Convert to byte stream with delta times
+    const bytes = [];
+    let prevTick = 0;
+    for (const event of events) {
+        const delta = Math.max(0, event.tick - prevTick);
+        bytes.push(...writeVLQ(delta));
+        bytes.push(...event.data);
+        prevTick = event.tick;
+    }
+    // End of Track
+    bytes.push(0x00, 0xFF, 0x2F, 0x00);
+    return wrapTrackChunk(new Uint8Array(bytes));
+}
+function wrapTrackChunk(trackData) {
+    const chunk = new Uint8Array(8 + trackData.length);
+    const view = new DataView(chunk.buffer);
+    // "MTrk"
+    chunk[0] = 0x4D;
+    chunk[1] = 0x54;
+    chunk[2] = 0x72;
+    chunk[3] = 0x6B;
+    // Track length
+    view.setUint32(4, trackData.length, false);
+    // Track data
+    chunk.set(trackData, 8);
+    return chunk;
+}
+function writeVLQ(value) {
+    if (value < 0)
+        value = 0;
+    if (value < 0x80)
+        return [value];
+    const bytes = [];
+    let v = value;
+    bytes.unshift(v & 0x7F);
+    v >>= 7;
+    while (v > 0) {
+        bytes.unshift((v & 0x7F) | 0x80);
+        v >>= 7;
+    }
+    return bytes;
+}
+/**
+ * Convenience: create a MIDI file Blob from tracks.
+ */
+export function createMidiBlob(tracks, options) {
+    const buffer = writeMidiFile(tracks, options);
+    return new Blob([buffer], { type: 'audio/midi' });
+}
+//# sourceMappingURL=MidiFileWriter.js.map

package/dist/midi/MidiFileWriter.js.map

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

package/dist/midi/MidiImporter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * MIDI Importer — bridges MidiFileParser output to domain models.
+ * Creates MidiClip/MidiRegion/Track from parsed MIDI file data.
+ */
+import { MidiFileData } from './MidiFileParser';
+import { MidiClip } from '../domain/MidiClip';
+import { MidiRegion } from '../domain/MidiRegion';
+export interface MidiImportResult {
+    /** Parsed file metadata */
+    fileData: MidiFileData;
+    /** One MidiClip per track in the file */
+    clips: MidiClip[];
+    /** One MidiRegion per track, positioned at startFrame */
+    regions: MidiRegion[];
+}
+/**
+ * Import a MIDI file from an ArrayBuffer.
+ *
+ * @param data Raw .mid file bytes
+ * @param sampleRate Session sample rate (for tick-to-frame conversion)
+ * @param startFrame Where to place the imported regions on the timeline
+ */
+export declare function importMidiFile(data: ArrayBuffer, sampleRate?: number, startFrame?: number): MidiImportResult;
+/**
+ * Export MidiRegions to MIDI file data for the writer.
+ */
+export declare function exportMidiRegions(regions: MidiRegion[], sampleRate?: number): {
+    name: string;
+    notes: Array<{
+        pitch: number;
+        velocity: number;
+        channel: number;
+        startFrame: number;
+        durationFrames: number;
+    }>;
+}[];
+//# sourceMappingURL=MidiImporter.d.ts.map

package/dist/midi/MidiImporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MidiImporter.d.ts","sourceRoot":"","sources":["../../src/midi/MidiImporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAgC,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC7B,2BAA2B;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,yCAAyC;IACzC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,UAAU,EAAE,CAAC;CACzB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC1B,IAAI,EAAE,WAAW,EACjB,UAAU,GAAE,MAAc,EAC1B,UAAU,GAAE,MAAU,GACvB,gBAAgB,CA0DlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC7B,OAAO,EAAE,UAAU,EAAE,EACrB,UAAU,GAAE,MAAc,GAC3B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EAAE,CAWpI"}

package/dist/midi/MidiImporter.js

@@ -0,0 +1,62 @@
+/**
+ * MIDI Importer — bridges MidiFileParser output to domain models.
+ * Creates MidiClip/MidiRegion/Track from parsed MIDI file data.
+ */
+import { parseMidiFile } from './MidiFileParser';
+import { MidiClip } from '../domain/MidiClip';
+import { MidiNote } from '../domain/MidiNote';
+import { MidiRegion } from '../domain/MidiRegion';
+/**
+ * Import a MIDI file from an ArrayBuffer.
+ *
+ * @param data Raw .mid file bytes
+ * @param sampleRate Session sample rate (for tick-to-frame conversion)
+ * @param startFrame Where to place the imported regions on the timeline
+ */
+export function importMidiFile(data, sampleRate = 44100, startFrame = 0) {
+    const fileData = parseMidiFile(data, sampleRate);
+    const clips = [];
+    const regions = [];
+    for (let i = 0; i < fileData.tracks.length; i++) {
+        const track = fileData.tracks[i];
+        // Skip empty tracks (common in Type 1 — track 0 is often tempo-only)
+        if (track.notes.length === 0)
+            continue;
+        const clipId = crypto.randomUUID();
+        const regionId = crypto.randomUUID();
+        // Create MidiNotes from parsed data
+        const midiNotes = track.notes.map(n => {
+            return new MidiNote(crypto.randomUUID(), n.pitch, n.velocity, n.startFrame, n.durationFrames, n.channel);
+        });
+        // Create MidiClip
+        const clip = new MidiClip(clipId, track.name, midiNotes);
+        clips.push(clip);
+        // Create MidiRegion
+        const clipDuration = clip.getDuration();
+        const region = new MidiRegion(regionId, track.name, startFrame, clipDuration);
+        // Add notes to region
+        for (const note of midiNotes) {
+            // Clone notes for the region (they're separate from clip notes)
+            const regionNote = new MidiNote(crypto.randomUUID(), note.pitch, note.velocity, note.startFrame, note.durationFrames, note.channel);
+            region.addNote(regionNote);
+        }
+        regions.push(region);
+    }
+    return { fileData, clips, regions };
+}
+/**
+ * Export MidiRegions to MIDI file data for the writer.
+ */
+export function exportMidiRegions(regions, sampleRate = 44100) {
+    return regions.map(region => ({
+        name: region.name,
+        notes: region.getNotes().map(n => ({
+            pitch: n.pitch,
+            velocity: n.velocity,
+            channel: n.channel,
+            startFrame: n.startFrame,
+            durationFrames: n.durationFrames,
+        })),
+    }));
+}
+//# sourceMappingURL=MidiImporter.js.map

package/dist/midi/MidiImporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MidiImporter.js","sourceRoot":"","sources":["../../src/midi/MidiImporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA+B,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAWlD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC1B,IAAiB,EACjB,aAAqB,KAAK,EAC1B,aAAqB,CAAC;IAEtB,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAEjD,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAiB,EAAE,CAAC;IAEjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAEjC,qEAAqE;QACrE,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAEvC,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAErC,oCAAoC;QACpC,MAAM,SAAS,GAAe,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;YAC9C,OAAO,IAAI,QAAQ,CACf,MAAM,CAAC,UAAU,EAAE,EACnB,CAAC,CAAC,KAAK,EACP,CAAC,CAAC,QAAQ,EACV,CAAC,CAAC,UAAU,EACZ,CAAC,CAAC,cAAc,EAChB,CAAC,CAAC,OAAO,CACZ,CAAC;QACN,CAAC,CAAC,CAAC;QAEH,kBAAkB;QAClB,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEjB,oBAAoB;QACpB,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,IAAI,UAAU,CACzB,QAAQ,EACR,KAAK,CAAC,IAAI,EACV,UAAU,EACV,YAAY,CACf,CAAC;QAEF,sBAAsB;QACtB,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC3B,gEAAgE;YAChE,MAAM,UAAU,GAAG,IAAI,QAAQ,CAC3B,MAAM,CAAC,UAAU,EAAE,EACnB,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,cAAc,EACnB,IAAI,CAAC,OAAO,CACf,CAAC;YACF,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC/B,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC7B,OAAqB,EACrB,aAAqB,KAAK;IAE1B,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/B,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,cAAc,EAAE,CAAC,CAAC,cAAc;SACnC,CAAC,CAAC;KACN,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/plugins/PluginPresetManager.d.ts

@@ -0,0 +1,86 @@
+import { Signal } from '../lib/Signal';
+import { Plugin } from './Plugin';
+/**
+ * A named snapshot of plugin parameter values that can be saved, recalled,
+ * and applied to a compatible plugin instance.
+ */
+export interface PluginPreset {
+    /** Unique preset identifier. */
+    id: string;
+    /** Human-readable preset name. */
+    name: string;
+    /** Descriptor ID of the plugin this preset targets (e.g. 'internal-reverb'). */
+    pluginId: string;
+    /** Optional version string the preset was created against. */
+    pluginVersion?: string;
+    /** Parameter name -> value map. */
+    parameters: Record<string, number>;
+    /** Arbitrary key/value metadata (author, notes, tags, etc.). */
+    metadata?: Record<string, string>;
+    /** Whether this preset ships with the application (factory) or was
+     *  created by the user. */
+    isFactory: boolean;
+    /** ISO-8601 creation timestamp. */
+    createdAt: string;
+}
+/**
+ * Manages plugin presets across all plugin types.
+ *
+ * Presets are organized by `pluginId` so they can be quickly looked up when
+ * a user opens a plugin UI.  The manager distinguishes between factory
+ * presets (read-only, shipped with the application) and user presets.
+ *
+ * Signal-based notification is provided via `presetsChanged`, which emits
+ * the affected `pluginId` whenever presets are added, removed, or updated.
+ */
+export declare class PluginPresetManager {
+    /** pluginId -> ordered array of presets */
+    private _presets;
+    /**
+     * Emitted whenever presets change for a given plugin. The payload is the
+     * affected `pluginId`.
+     */
+    readonly presetsChanged: Signal<string>;
+    /**
+     * Save a new user preset for the specified plugin.
+     *
+     * @returns The newly created preset (with generated `id` and timestamp).
+     */
+    savePreset(pluginId: string, name: string, parameters: Record<string, number>, metadata?: Record<string, string>, pluginVersion?: string): PluginPreset;
+    /**
+     * Delete a preset by its unique ID. Factory presets cannot be deleted.
+     *
+     * @returns `true` if the preset was found and deleted.
+     */
+    deletePreset(presetId: string): boolean;
+    /**
+     * Get all presets (factory + user) for a given plugin type.
+     */
+    getPresetsForPlugin(pluginId: string): PluginPreset[];
+    /**
+     * Get a single preset by its unique ID, searching across all plugins.
+     */
+    getPreset(presetId: string): PluginPreset | undefined;
+    /**
+     * Apply a preset to a live Plugin instance by calling `setParameter()`
+     * for each stored parameter value.
+     */
+    applyPreset(presetId: string, plugin: Plugin): void;
+    /**
+     * Register one or more factory presets for a plugin type.
+     *
+     * Factory presets are read-only and are prepended to the preset list so
+     * they appear before user presets in UIs.
+     */
+    registerFactoryPresets(pluginId: string, presets: Omit<PluginPreset, 'id' | 'createdAt' | 'isFactory'>[]): void;
+    /**
+     * Serialize all presets (factory + user) to a JSON string.
+     */
+    serialize(): string;
+    /**
+     * Restore a PluginPresetManager from a JSON string produced by
+     * `serialize()`.
+     */
+    static deserialize(json: string): PluginPresetManager;
+}
+//# sourceMappingURL=PluginPresetManager.d.ts.map