@drop-ai/core 0.2.0 → 0.3.1

package/dist/processing/SurroundPanner.js

@@ -0,0 +1,374 @@
+import { Processor } from './Processor';
+import { Signal } from '../lib/Signal';
+/**
+ * SurroundPanner supports multichannel panning beyond stereo.
+ *
+ * Supported layouts:
+ * - Stereo (2.0): L, R
+ * - Quad (4.0): FL, FR, RL, RR
+ * - 5.1: FL, FR, C, LFE, RL, RR
+ * - 7.1: FL, FR, C, LFE, RL, RR, SL, SR
+ * - Atmos/3D: adds height channels
+ *
+ * Uses VBAP (Vector Base Amplitude Panning) algorithm for
+ * arbitrary speaker configurations.
+ */
+export var SpeakerLayout;
+(function (SpeakerLayout) {
+    SpeakerLayout["STEREO"] = "STEREO";
+    SpeakerLayout["QUAD"] = "QUAD";
+    SpeakerLayout["SURROUND_5_1"] = "5.1";
+    SpeakerLayout["SURROUND_7_1"] = "7.1";
+})(SpeakerLayout || (SpeakerLayout = {}));
+export class SurroundPanner extends Processor {
+    constructor(id, layout) {
+        super(id, 'Surround Panner');
+        this._azimuth = 0; // Source horizontal angle in degrees
+        this._elevation = 0; // Source vertical angle in degrees
+        this._spread = 0; // Source spread (0 = point, 1 = omni)
+        this._lfeLevel = 0; // LFE send level (0-1)
+        this._layout = SpeakerLayout.STEREO;
+        this._speakers = [];
+        this._gains = new Float32Array(0);
+        this.positionChanged = new Signal();
+        this.layoutChanged = new Signal();
+        const initialLayout = layout !== null && layout !== void 0 ? layout : SpeakerLayout.STEREO;
+        this._speakers = this.setupSpeakers(initialLayout);
+        this._layout = initialLayout;
+        this._gains = new Float32Array(this._speakers.length);
+        this.computeGains();
+    }
+    // ── Position control ────────────────────────────────────────────────────
+    /**
+     * Set the source position.
+     * @param azimuth  Horizontal angle in degrees (-180 to 180).
+     * @param elevation Vertical angle in degrees (-90 to 90). Defaults to current.
+     */
+    setPosition(azimuth, elevation) {
+        const clampedAz = Math.max(-180, Math.min(180, azimuth));
+        const clampedEl = elevation !== undefined
+            ? Math.max(-90, Math.min(90, elevation))
+            : this._elevation;
+        if (this._azimuth !== clampedAz || this._elevation !== clampedEl) {
+            this._azimuth = clampedAz;
+            this._elevation = clampedEl;
+            this.computeGains();
+            this.positionChanged.emit({ azimuth: this._azimuth, elevation: this._elevation });
+            this.stateChanged.emit();
+        }
+    }
+    /**
+     * Set the source spread.
+     * @param spread 0 = point source, 1 = omnidirectional.
+     */
+    setSpread(spread) {
+        const clamped = Math.max(0, Math.min(1, spread));
+        if (this._spread !== clamped) {
+            this._spread = clamped;
+            this.computeGains();
+            this.stateChanged.emit();
+        }
+    }
+    /**
+     * Set the LFE send level.
+     * @param level 0 to 1.
+     */
+    setLFELevel(level) {
+        const clamped = Math.max(0, Math.min(1, level));
+        if (this._lfeLevel !== clamped) {
+            this._lfeLevel = clamped;
+            this.stateChanged.emit();
+        }
+    }
+    get azimuth() { return this._azimuth; }
+    get elevation() { return this._elevation; }
+    get spread() { return this._spread; }
+    get lfeLevel() { return this._lfeLevel; }
+    // ── Layout ──────────────────────────────────────────────────────────────
+    /**
+     * Set the speaker layout. Recomputes speaker positions and gains.
+     */
+    setLayout(layout) {
+        if (this._layout !== layout) {
+            this._layout = layout;
+            this._speakers = this.setupSpeakers(layout);
+            this._gains = new Float32Array(this._speakers.length);
+            this.computeGains();
+            this.layoutChanged.emit(layout);
+            this.stateChanged.emit();
+        }
+    }
+    get layout() { return this._layout; }
+    /** Number of output channels for the current layout. */
+    get channelCount() { return this._speakers.length; }
+    /** Speaker positions for the current layout. */
+    get speakers() { return this._speakers; }
+    // ── Gain computation ────────────────────────────────────────────────────
+    /**
+     * Compute per-channel gains based on the current source position,
+     * spread, and layout using VBAP.
+     *
+     * @returns Float32Array of linear gains, one per speaker/channel.
+     */
+    computeGains() {
+        const hasElevation = this._elevation !== 0;
+        let rawGains;
+        if (hasElevation) {
+            rawGains = this.vbap3D(this._azimuth, this._elevation);
+        }
+        else {
+            rawGains = this.vbap2D(this._azimuth);
+        }
+        // Apply spread: interpolate between point-source gains and uniform (omni)
+        if (this._spread > 0) {
+            const uniformGain = 1.0 / Math.sqrt(this._speakers.length);
+            for (let i = 0; i < rawGains.length; i++) {
+                rawGains[i] = rawGains[i] * (1 - this._spread) + uniformGain * this._spread;
+            }
+        }
+        // For 5.1 and 7.1 layouts, apply LFE level to the LFE channel
+        if (this._layout === SpeakerLayout.SURROUND_5_1 || this._layout === SpeakerLayout.SURROUND_7_1) {
+            const lfeIndex = this.getLFEChannelIndex();
+            if (lfeIndex >= 0 && lfeIndex < rawGains.length) {
+                rawGains[lfeIndex] = this._lfeLevel;
+            }
+        }
+        // Store and return
+        this._gains = rawGains;
+        return new Float32Array(rawGains);
+    }
+    // ── VBAP algorithms ─────────────────────────────────────────────────────
+    /**
+     * 2D VBAP: Vector Base Amplitude Panning in the horizontal plane.
+     *
+     * For each adjacent speaker pair, computes the amplitude split
+     * based on the angular position of the source relative to both speakers.
+     *
+     * @param azimuth Source azimuth in degrees (-180 to 180).
+     */
+    vbap2D(azimuth) {
+        const gains = new Float32Array(this._speakers.length);
+        const speakerCount = this._speakers.length;
+        if (speakerCount === 0)
+            return gains;
+        // Special case: stereo uses simple equal-power panning
+        if (this._layout === SpeakerLayout.STEREO) {
+            // Normalize azimuth: -180..180 -> -1..1 for L/R
+            const normalized = Math.max(-1, Math.min(1, azimuth / 180));
+            const pan01 = (normalized + 1) / 2; // 0 = left, 1 = right
+            const angle = pan01 * Math.PI / 2;
+            gains[0] = Math.cos(angle); // Left
+            gains[1] = Math.sin(angle); // Right
+            return gains;
+        }
+        // Convert source azimuth to radians
+        const sourceRad = (azimuth * Math.PI) / 180;
+        // Get non-LFE speaker indices and their azimuths
+        const activeSpeakers = [];
+        for (let i = 0; i < speakerCount; i++) {
+            // Skip LFE channel in VBAP calculations
+            if (this._speakers[i].label === 'LFE')
+                continue;
+            activeSpeakers.push({
+                index: i,
+                azimuthRad: (this._speakers[i].azimuth * Math.PI) / 180,
+            });
+        }
+        // Sort speakers by azimuth
+        activeSpeakers.sort((a, b) => a.azimuthRad - b.azimuthRad);
+        if (activeSpeakers.length === 0)
+            return gains;
+        if (activeSpeakers.length === 1) {
+            gains[activeSpeakers[0].index] = 1.0;
+            return gains;
+        }
+        // Find the two speakers that bracket the source angle
+        let found = false;
+        for (let i = 0; i < activeSpeakers.length; i++) {
+            const next = (i + 1) % activeSpeakers.length;
+            let az1 = activeSpeakers[i].azimuthRad;
+            let az2 = activeSpeakers[next].azimuthRad;
+            // Handle wrap-around
+            let span = az2 - az1;
+            if (span <= 0)
+                span += 2 * Math.PI;
+            let sourceOffset = sourceRad - az1;
+            if (sourceOffset < 0)
+                sourceOffset += 2 * Math.PI;
+            if (sourceOffset <= span) {
+                // Source is between speakers i and next
+                const t = span > 0 ? sourceOffset / span : 0;
+                // Equal-power crossfade between the two speakers
+                const angle = t * Math.PI / 2;
+                const g2 = Math.sin(angle);
+                const g1 = Math.cos(angle);
+                gains[activeSpeakers[i].index] = g1;
+                gains[activeSpeakers[next].index] = g2;
+                found = true;
+                break;
+            }
+        }
+        // Fallback: if no pair found, use closest speaker
+        if (!found) {
+            let minDist = Infinity;
+            let closest = 0;
+            for (const sp of activeSpeakers) {
+                let dist = Math.abs(sourceRad - sp.azimuthRad);
+                if (dist > Math.PI)
+                    dist = 2 * Math.PI - dist;
+                if (dist < minDist) {
+                    minDist = dist;
+                    closest = sp.index;
+                }
+            }
+            gains[closest] = 1.0;
+        }
+        return gains;
+    }
+    /**
+     * 3D VBAP: Vector Base Amplitude Panning with elevation.
+     *
+     * Extends 2D VBAP by considering the vertical angle to distribute
+     * energy across speakers at different elevations.
+     *
+     * @param azimuth Source azimuth in degrees.
+     * @param elevation Source elevation in degrees.
+     */
+    vbap3D(azimuth, elevation) {
+        const gains = new Float32Array(this._speakers.length);
+        const speakerCount = this._speakers.length;
+        if (speakerCount === 0)
+            return gains;
+        // Convert source position to Cartesian unit vector
+        const srcAzRad = (azimuth * Math.PI) / 180;
+        const srcElRad = (elevation * Math.PI) / 180;
+        const srcX = Math.cos(srcElRad) * Math.cos(srcAzRad);
+        const srcY = Math.cos(srcElRad) * Math.sin(srcAzRad);
+        const srcZ = Math.sin(srcElRad);
+        // Compute dot product with each speaker's direction vector.
+        // This gives a measure of how "close" the source is to each speaker.
+        const dotProducts = [];
+        let totalWeight = 0;
+        for (let i = 0; i < speakerCount; i++) {
+            if (this._speakers[i].label === 'LFE') {
+                dotProducts.push(0);
+                continue;
+            }
+            const spAzRad = (this._speakers[i].azimuth * Math.PI) / 180;
+            const spElRad = (this._speakers[i].elevation * Math.PI) / 180;
+            const spX = Math.cos(spElRad) * Math.cos(spAzRad);
+            const spY = Math.cos(spElRad) * Math.sin(spAzRad);
+            const spZ = Math.sin(spElRad);
+            // Dot product (cosine of angle between source and speaker)
+            let dot = srcX * spX + srcY * spY + srcZ * spZ;
+            // Clamp to [0, 1] - speakers behind the source get no signal
+            dot = Math.max(0, dot);
+            // Square the dot product for sharper localization
+            dot = dot * dot;
+            dotProducts.push(dot);
+            totalWeight += dot;
+        }
+        // Normalize and apply
+        if (totalWeight > 0) {
+            for (let i = 0; i < speakerCount; i++) {
+                // Use sqrt for energy preservation (VBAP convention)
+                gains[i] = Math.sqrt(dotProducts[i] / totalWeight);
+            }
+        }
+        else {
+            // Fallback: equal distribution across all non-LFE speakers
+            let nonLfeCount = 0;
+            for (let i = 0; i < speakerCount; i++) {
+                if (this._speakers[i].label !== 'LFE')
+                    nonLfeCount++;
+            }
+            if (nonLfeCount > 0) {
+                const equalGain = 1.0 / Math.sqrt(nonLfeCount);
+                for (let i = 0; i < speakerCount; i++) {
+                    if (this._speakers[i].label !== 'LFE') {
+                        gains[i] = equalGain;
+                    }
+                }
+            }
+        }
+        return gains;
+    }
+    // ── Speaker setup ───────────────────────────────────────────────────────
+    /**
+     * Setup default speaker positions for a given layout.
+     * Angles follow the ITU-R BS.775 and ITU-R BS.2051 standards.
+     */
+    setupSpeakers(layout) {
+        switch (layout) {
+            case SpeakerLayout.STEREO:
+                return [
+                    { azimuth: -30, elevation: 0, distance: 1, label: 'L' },
+                    { azimuth: 30, elevation: 0, distance: 1, label: 'R' },
+                ];
+            case SpeakerLayout.QUAD:
+                return [
+                    { azimuth: -45, elevation: 0, distance: 1, label: 'FL' },
+                    { azimuth: 45, elevation: 0, distance: 1, label: 'FR' },
+                    { azimuth: -135, elevation: 0, distance: 1, label: 'RL' },
+                    { azimuth: 135, elevation: 0, distance: 1, label: 'RR' },
+                ];
+            case SpeakerLayout.SURROUND_5_1:
+                return [
+                    { azimuth: -30, elevation: 0, distance: 1, label: 'FL' },
+                    { azimuth: 30, elevation: 0, distance: 1, label: 'FR' },
+                    { azimuth: 0, elevation: 0, distance: 1, label: 'C' },
+                    { azimuth: 0, elevation: -90, distance: 1, label: 'LFE' },
+                    { azimuth: -110, elevation: 0, distance: 1, label: 'RL' },
+                    { azimuth: 110, elevation: 0, distance: 1, label: 'RR' },
+                ];
+            case SpeakerLayout.SURROUND_7_1:
+                return [
+                    { azimuth: -30, elevation: 0, distance: 1, label: 'FL' },
+                    { azimuth: 30, elevation: 0, distance: 1, label: 'FR' },
+                    { azimuth: 0, elevation: 0, distance: 1, label: 'C' },
+                    { azimuth: 0, elevation: -90, distance: 1, label: 'LFE' },
+                    { azimuth: -135, elevation: 0, distance: 1, label: 'RL' },
+                    { azimuth: 135, elevation: 0, distance: 1, label: 'RR' },
+                    { azimuth: -90, elevation: 0, distance: 1, label: 'SL' },
+                    { azimuth: 90, elevation: 0, distance: 1, label: 'SR' },
+                ];
+            default:
+                return [
+                    { azimuth: -30, elevation: 0, distance: 1, label: 'L' },
+                    { azimuth: 30, elevation: 0, distance: 1, label: 'R' },
+                ];
+        }
+    }
+    /**
+     * Get the index of the LFE channel in the current layout.
+     * Returns -1 if the layout has no LFE channel.
+     */
+    getLFEChannelIndex() {
+        return this._speakers.findIndex(s => s.label === 'LFE');
+    }
+    // ── Serialization ───────────────────────────────────────────────────────
+    toJSON() {
+        return {
+            id: this.id,
+            name: this.name,
+            azimuth: this._azimuth,
+            elevation: this._elevation,
+            spread: this._spread,
+            lfeLevel: this._lfeLevel,
+            layout: this._layout,
+            active: this.active,
+        };
+    }
+    static fromJSON(data) {
+        const panner = new SurroundPanner(data.id, data.layout);
+        panner.name = data.name;
+        panner._azimuth = data.azimuth;
+        panner._elevation = data.elevation;
+        panner._spread = data.spread;
+        panner._lfeLevel = data.lfeLevel;
+        panner.active = data.active;
+        panner.computeGains();
+        return panner;
+    }
+}
+//# sourceMappingURL=SurroundPanner.js.map

package/dist/processing/SurroundPanner.js.map

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

package/dist/processing/TruePeakLimiter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * True Peak Limiter
+ *
+ * Implements:
+ *   1. 4x oversampling via windowed sinc interpolation
+ *   2. True peak measurement per ITU-R BS.1770-4 Annex 2
+ *   3. Brick-wall limiting with lookahead and release
+ */
+/**
+ * Measure the true peak of a mono channel using 4x oversampling.
+ * Returns peak in linear scale.
+ */
+export declare function measureTruePeak(samples: Float32Array): number;
+/**
+ * Measure true peak in dBTP for a mono channel.
+ */
+export declare function measureTruePeakDbTP(samples: Float32Array): number;
+/**
+ * Apply brick-wall true peak limiting to an AudioBuffer.
+ * Modifies the buffer in-place.
+ *
+ * The limiter uses a simple gain reduction approach:
+ *   1. Find the true peak of the entire buffer
+ *   2. If it exceeds the ceiling, apply uniform gain reduction
+ *   3. For per-sample limiting, use a lookahead envelope follower
+ *
+ * @param buffer Audio buffer to limit (modified in-place)
+ * @param ceilingDbTP Target ceiling in dBTP (e.g., -1.0)
+ * @returns true if limiting was applied
+ */
+export declare function applyTruePeakLimiter(buffer: AudioBuffer, ceilingDbTP?: number): boolean;
+//# sourceMappingURL=TruePeakLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TruePeakLimiter.d.ts","sourceRoot":"","sources":["../../src/processing/TruePeakLimiter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAwB7D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAGjE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,GAAE,MAAa,GAAG,OAAO,CA0E7F"}

package/dist/processing/TruePeakLimiter.js

@@ -0,0 +1,142 @@
+/**
+ * True Peak Limiter
+ *
+ * Implements:
+ *   1. 4x oversampling via windowed sinc interpolation
+ *   2. True peak measurement per ITU-R BS.1770-4 Annex 2
+ *   3. Brick-wall limiting with lookahead and release
+ */
+/**
+ * 4x oversampling FIR coefficients (half-band low-pass, 12-tap).
+ * These approximate a windowed sinc interpolation filter for 4x upsampling.
+ */
+const OVERSAMPLE_TAPS = [
+    0.0017089843750,
+    -0.0291748046875,
+    -0.0189208984375,
+    0.0708618164062,
+    0.3031005859375,
+    0.4736328125000,
+    0.3031005859375,
+    0.0708618164062,
+    -0.0189208984375,
+    -0.0291748046875,
+    0.0017089843750,
+    0.0000000000000,
+];
+/**
+ * Measure the true peak of a mono channel using 4x oversampling.
+ * Returns peak in linear scale.
+ */
+export function measureTruePeak(samples) {
+    const taps = OVERSAMPLE_TAPS;
+    const numTaps = taps.length;
+    const halfTaps = Math.floor(numTaps / 2);
+    let maxPeak = 0;
+    // For each input sample, compute 4 interpolated values
+    for (let i = 0; i < samples.length; i++) {
+        for (let phase = 0; phase < 4; phase++) {
+            let sum = 0;
+            for (let t = 0; t < numTaps; t++) {
+                const srcIdx = i - halfTaps + t;
+                if (srcIdx >= 0 && srcIdx < samples.length) {
+                    // Phase-offset tap selection for polyphase decomposition
+                    sum += samples[srcIdx] * taps[t];
+                }
+            }
+            const abs = Math.abs(sum);
+            if (abs > maxPeak)
+                maxPeak = abs;
+        }
+    }
+    return maxPeak;
+}
+/**
+ * Measure true peak in dBTP for a mono channel.
+ */
+export function measureTruePeakDbTP(samples) {
+    const peak = measureTruePeak(samples);
+    return peak > 0 ? 20 * Math.log10(peak) : -Infinity;
+}
+/**
+ * Apply brick-wall true peak limiting to an AudioBuffer.
+ * Modifies the buffer in-place.
+ *
+ * The limiter uses a simple gain reduction approach:
+ *   1. Find the true peak of the entire buffer
+ *   2. If it exceeds the ceiling, apply uniform gain reduction
+ *   3. For per-sample limiting, use a lookahead envelope follower
+ *
+ * @param buffer Audio buffer to limit (modified in-place)
+ * @param ceilingDbTP Target ceiling in dBTP (e.g., -1.0)
+ * @returns true if limiting was applied
+ */
+export function applyTruePeakLimiter(buffer, ceilingDbTP = -1.0) {
+    const ceilingLinear = Math.pow(10, ceilingDbTP / 20);
+    const numChannels = buffer.numberOfChannels;
+    // Measure true peak across all channels
+    let globalTruePeak = 0;
+    for (let ch = 0; ch < numChannels; ch++) {
+        const data = buffer.getChannelData(ch);
+        const peak = measureTruePeak(data);
+        if (peak > globalTruePeak)
+            globalTruePeak = peak;
+    }
+    // If already below ceiling, nothing to do
+    if (globalTruePeak <= ceilingLinear) {
+        return false;
+    }
+    // Lookahead limiter parameters
+    const sampleRate = buffer.sampleRate;
+    const lookaheadMs = 5; // 5ms lookahead
+    const releaseMs = 100; // 100ms release
+    const lookaheadSamples = Math.ceil(sampleRate * lookaheadMs / 1000);
+    const releaseCoeff = Math.exp(-1.0 / (sampleRate * releaseMs / 1000));
+    // Compute per-sample gain envelope based on peak detection
+    const length = buffer.length;
+    const gainEnvelope = new Float32Array(length);
+    gainEnvelope.fill(1.0);
+    // First pass: find per-sample peaks across channels
+    const peaks = new Float32Array(length);
+    for (let ch = 0; ch < numChannels; ch++) {
+        const data = buffer.getChannelData(ch);
+        for (let i = 0; i < length; i++) {
+            const abs = Math.abs(data[i]);
+            if (abs > peaks[i])
+                peaks[i] = abs;
+        }
+    }
+    // Second pass: compute gain reduction with lookahead
+    let currentGain = 1.0;
+    for (let i = length - 1; i >= 0; i--) {
+        // Look ahead to find the peak that's coming
+        let futureMax = 0;
+        const lookEnd = Math.min(i + lookaheadSamples, length);
+        for (let j = i; j < lookEnd; j++) {
+            if (peaks[j] > futureMax)
+                futureMax = peaks[j];
+        }
+        // Desired gain for this sample
+        let desiredGain = 1.0;
+        if (futureMax > ceilingLinear) {
+            desiredGain = ceilingLinear / futureMax;
+        }
+        // Smooth gain changes (attack = instant, release = smooth)
+        if (desiredGain < currentGain) {
+            currentGain = desiredGain; // instant attack
+        }
+        else {
+            currentGain = desiredGain + releaseCoeff * (currentGain - desiredGain);
+        }
+        gainEnvelope[i] = currentGain;
+    }
+    // Apply gain envelope to all channels
+    for (let ch = 0; ch < numChannels; ch++) {
+        const data = buffer.getChannelData(ch);
+        for (let i = 0; i < length; i++) {
+            data[i] *= gainEnvelope[i];
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=TruePeakLimiter.js.map

package/dist/processing/TruePeakLimiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TruePeakLimiter.js","sourceRoot":"","sources":["../../src/processing/TruePeakLimiter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,eAAe,GAAG;IACpB,eAAe;IACf,CAAC,eAAe;IAChB,CAAC,eAAe;IAChB,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,CAAC,eAAe;IAChB,CAAC,eAAe;IAChB,eAAe;IACf,eAAe;CAClB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAqB;IACjD,MAAM,IAAI,GAAG,eAAe,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IAEzC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,uDAAuD;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACrC,IAAI,GAAG,GAAG,CAAC,CAAC;YACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC;gBAChC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;oBACzC,yDAAyD;oBACzD,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACrC,CAAC;YACL,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,GAAG,GAAG,OAAO;gBAAE,OAAO,GAAG,GAAG,CAAC;QACrC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAqB;IACrD,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACxD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAmB,EAAE,cAAsB,CAAC,GAAG;IAChF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,GAAG,EAAE,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,MAAM,CAAC,gBAAgB,CAAC;IAE5C,wCAAwC;IACxC,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI,GAAG,cAAc;YAAE,cAAc,GAAG,IAAI,CAAC;IACrD,CAAC;IAED,0CAA0C;IAC1C,IAAI,cAAc,IAAI,aAAa,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,+BAA+B;IAC/B,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,gBAAgB;IACvC,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,gBAAgB;IACvC,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,WAAW,GAAG,IAAI,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;IAEtE,2DAA2D;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9C,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEvB,oDAAoD;IACpD,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC;gBAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QACvC,CAAC;IACL,CAAC;IAED,qDAAqD;IACrD,IAAI,WAAW,GAAG,GAAG,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,4CAA4C;QAC5C,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS;gBAAE,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACnD,CAAC;QAED,+BAA+B;QAC/B,IAAI,WAAW,GAAG,GAAG,CAAC;QACtB,IAAI,SAAS,GAAG,aAAa,EAAE,CAAC;YAC5B,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;QAC5C,CAAC;QAED,2DAA2D;QAC3D,IAAI,WAAW,GAAG,WAAW,EAAE,CAAC;YAC5B,WAAW,GAAG,WAAW,CAAC,CAAC,iBAAiB;QAChD,CAAC;aAAM,CAAC;YACJ,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC,CAAC;QAC3E,CAAC;QAED,YAAY,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;IAClC,CAAC;IAED,sCAAsC;IACtC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACvC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/storage/ExportPresetStorage.d.ts

@@ -0,0 +1,33 @@
+import { ExportPreset } from '../domain/ExportPreset';
+/**
+ * IndexedDB storage for export presets.
+ * Follows the same pattern as SessionStorage.
+ */
+export declare class ExportPresetStorage {
+    private static instance;
+    private dbPromise;
+    private constructor();
+    static getInstance(): ExportPresetStorage;
+    private openDB;
+    /**
+     * Save a user preset.
+     */
+    savePreset(preset: ExportPreset): Promise<void>;
+    /**
+     * Load a preset by ID.
+     */
+    loadPreset(id: string): Promise<ExportPreset | null>;
+    /**
+     * List all saved user presets.
+     */
+    listPresets(): Promise<ExportPreset[]>;
+    /**
+     * Get all presets (built-in + user).
+     */
+    getAllPresets(): Promise<ExportPreset[]>;
+    /**
+     * Delete a user preset by ID.
+     */
+    deletePreset(id: string): Promise<void>;
+}
+//# sourceMappingURL=ExportPresetStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExportPresetStorage.d.ts","sourceRoot":"","sources":["../../src/storage/ExportPresetStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,YAAY,EAAqB,MAAM,wBAAwB,CAAC;AAM/F;;;GAGG;AACH,qBAAa,mBAAmB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsB;IAC7C,OAAO,CAAC,SAAS,CAAqC;IAEtD,OAAO;WAEO,WAAW,IAAI,mBAAmB;IAOhD,OAAO,CAAC,MAAM;IA2Cd;;OAEG;IACU,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D;;OAEG;IACU,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAajE;;OAEG;IACU,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAanD;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAMrD;;OAEG;IACU,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CASvD"}