@drop-ai/core 0.2.0 → 0.3.1

package/dist/domain/Source.d.ts

@@ -1,4 +1,57 @@
 import { SourceId, FrameCount } from './types';
+import type { VideoMetadata } from './VideoMetadata';
+import { Signal } from '../lib/Signal';
+/**
+ * Pre-computed peak data for waveform rendering at a given resolution.
+ *
+ * Each entry represents one "pixel column" of the waveform and stores
+ * the minimum, maximum, and RMS sample values within that column's
+ * frame range.
+ */
+export interface PeakData {
+    /** Minimum sample values per peak pixel. */
+    min: Float32Array;
+    /** Maximum sample values per peak pixel. */
+    max: Float32Array;
+    /** RMS (root mean square) values per peak pixel. */
+    rms: Float32Array;
+    /** Number of peak entries. */
+    length: number;
+    /** Number of source frames represented by each peak entry. */
+    resolution: number;
+}
+/**
+ * Aggregated analysis results computed by the AudioAnalyzer.
+ *
+ * Fields are populated lazily — not all analysis passes produce
+ * every metric, so most values are optional.
+ */
+export interface SourceAnalysisData {
+    /** Detected transient positions in frames. */
+    transients: number[];
+    /** Estimated tempo in beats per minute. */
+    bpm?: number;
+    /** Confidence of the BPM estimate (0..1). */
+    bpmConfidence?: number;
+    /** Integrated loudness in LUFS. */
+    lufs?: number;
+    /** True peak level in dBFS. */
+    truePeak?: number;
+    /** Zero crossing rate (crossings per second). */
+    zeroCrossingRate?: number;
+    /** Spectral centroid in Hz. */
+    spectralCentroid?: number;
+}
+/**
+ * Bitflags for source metadata properties.
+ */
+export declare enum SourceFlags {
+    WRITABLE = 1,// 1
+    CAN_RENAME = 2,// 2
+    REMOVABLE = 4,// 4
+    MISSING = 8,// 8
+    RF64_RIFF = 16
+}
 export declare class Source {
     readonly id: SourceId;
     readonly name: string;
@@ -6,6 +59,97 @@ export declare class Source {
     readonly duration: FrameCount;
     readonly sampleRate: number;
     readonly channelCount: number;
-    constructor(id: SourceId, name: string, url: string, duration: FrameCount, sampleRate?: number, channelCount?: number);
+    /**
+     * Optional video metadata if this source originated from a video file.
+     * When present, indicates that audio was extracted from a video file.
+     */
+    readonly videoMetadata?: VideoMetadata;
+    /** Bitflags describing source properties (see SourceFlags). */
+    flags: number;
+    /** Identifier linking this source to a specific take. */
+    takeId?: string;
+    /** Name of the ancestor source (e.g. the original file before edits). */
+    ancestorName?: string;
+    /** Reference count tracking how many regions/clips use this source. */
+    private _useCount;
+    /** Cached peak data for waveform display at various zoom levels. */
+    private _peakCache;
+    /** Analysis results (populated lazily by AudioAnalyzer). */
+    private _analysisData;
+    /** Emitted when peak data for a given resolution is added or updated. */
+    readonly peakCacheUpdated: Signal<number>;
+    /** Emitted when analysis data is set or replaced. */
+    readonly analysisCompleted: Signal<SourceAnalysisData>;
+    /** Natural timeline position in frames (where the source was originally recorded). */
+    naturalPosition?: number;
+    /** Detected transient positions in frames. */
+    transients: number[];
+    /** Cue markers mapping frame positions to names. */
+    cueMarkers: Map<number, string>;
+    /** Positions (in frames) where xruns / buffer underruns occurred during capture. */
+    xrunPositions: number[];
+    /** The track name this source was originally captured for. */
+    capturedFor?: string;
+    constructor(id: SourceId, name: string, url: string, duration: FrameCount, sampleRate?: number, channelCount?: number, videoMetadata?: VideoMetadata);
+    /**
+     * Check if this source originated from a video file
+     */
+    isVideoSource(): boolean;
+    get useCount(): number;
+    addUse(): void;
+    removeUse(): void;
+    /**
+     * Check whether a specific flag is set.
+     */
+    hasFlag(flag: SourceFlags): boolean;
+    /**
+     * Set a specific flag.
+     */
+    setFlag(flag: SourceFlags): void;
+    /**
+     * Clear a specific flag.
+     */
+    clearFlag(flag: SourceFlags): void;
+    /**
+     * Store peak data for a given resolution (frames per peak entry).
+     *
+     * Replaces any previously cached data at the same resolution.
+     * Emits {@link peakCacheUpdated} with the resolution key.
+     */
+    setPeakData(resolution: number, data: PeakData): void;
+    /**
+     * Retrieve cached peak data for a given resolution.
+     *
+     * @returns The peak data, or `undefined` if not yet computed.
+     */
+    getPeakData(resolution: number): PeakData | undefined;
+    /**
+     * Check whether peak data exists for a given resolution.
+     */
+    hasPeakData(resolution: number): boolean;
+    /**
+     * Clear all cached peak data for this source.
+     */
+    clearPeakCache(): void;
+    /**
+     * Set or replace analysis data for this source.
+     *
+     * This also updates the legacy {@link transients} array from the
+     * analysis results for backward compatibility.
+     * Emits {@link analysisCompleted} with the new data.
+     */
+    setAnalysisData(data: SourceAnalysisData): void;
+    /**
+     * Retrieve the analysis data, or `null` if no analysis has been run.
+     */
+    getAnalysisData(): SourceAnalysisData | null;
+    /**
+     * Release resources held by this source.
+     *
+     * Revokes the blob URL (if applicable), clears the peak cache, and
+     * disconnects all signal listeners. After disposal the source should
+     * not be used.
+     */
+    dispose(): void;
 }
 //# sourceMappingURL=Source.d.ts.map

package/dist/domain/Source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Source.d.ts","sourceRoot":"","sources":["../../src/domain/Source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE/C,qBAAa,MAAM;IACf,SAAgB,EAAE,EAAE,QAAQ,CAAC;IAC7B,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,GAAG,EAAE,MAAM,CAAC;IAC5B,SAAgB,QAAQ,EAAE,UAAU,CAAC;IACrC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,YAAY,EAAE,MAAM,CAAC;gBAGjC,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,UAAU,EACpB,UAAU,GAAE,MAAc,EAC1B,YAAY,GAAE,MAAU;CAS/B"}
+{"version":3,"file":"Source.d.ts","sourceRoot":"","sources":["../../src/domain/Source.ts"],"names":[],"mappings":"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"}

package/dist/domain/Source.js

@@ -1,11 +1,154 @@
+import { Signal } from '../lib/Signal';
+/**
+ * Bitflags for source metadata properties.
+ */
+export var SourceFlags;
+(function (SourceFlags) {
+    SourceFlags[SourceFlags["WRITABLE"] = 1] = "WRITABLE";
+    SourceFlags[SourceFlags["CAN_RENAME"] = 2] = "CAN_RENAME";
+    SourceFlags[SourceFlags["REMOVABLE"] = 4] = "REMOVABLE";
+    SourceFlags[SourceFlags["MISSING"] = 8] = "MISSING";
+    SourceFlags[SourceFlags["RF64_RIFF"] = 16] = "RF64_RIFF";
+})(SourceFlags || (SourceFlags = {}));
 export class Source {
-    constructor(id, name, url, duration, sampleRate = 44100, channelCount = 2) {
+    constructor(id, name, url, duration, sampleRate = 44100, channelCount = 2, videoMetadata) {
+        /** Bitflags describing source properties (see SourceFlags). */
+        this.flags = 0;
+        /** Reference count tracking how many regions/clips use this source. */
+        this._useCount = 0;
+        /** Cached peak data for waveform display at various zoom levels. */
+        this._peakCache = new Map();
+        /** Analysis results (populated lazily by AudioAnalyzer). */
+        this._analysisData = null;
+        /** Emitted when peak data for a given resolution is added or updated. */
+        this.peakCacheUpdated = new Signal();
+        /** Emitted when analysis data is set or replaced. */
+        this.analysisCompleted = new Signal();
+        /** Detected transient positions in frames. */
+        this.transients = [];
+        /** Cue markers mapping frame positions to names. */
+        this.cueMarkers = new Map();
+        /** Positions (in frames) where xruns / buffer underruns occurred during capture. */
+        this.xrunPositions = [];
         this.id = id;
         this.name = name;
         this.url = url;
         this.duration = duration;
         this.sampleRate = sampleRate;
         this.channelCount = channelCount;
+        this.videoMetadata = videoMetadata;
+    }
+    /**
+     * Check if this source originated from a video file
+     */
+    isVideoSource() {
+        return this.videoMetadata !== undefined;
+    }
+    // --- Use count ---
+    get useCount() {
+        return this._useCount;
+    }
+    addUse() {
+        this._useCount++;
+    }
+    removeUse() {
+        if (this._useCount > 0) {
+            this._useCount--;
+        }
+    }
+    // --- Flag helpers ---
+    /**
+     * Check whether a specific flag is set.
+     */
+    hasFlag(flag) {
+        return (this.flags & flag) !== 0;
+    }
+    /**
+     * Set a specific flag.
+     */
+    setFlag(flag) {
+        this.flags |= flag;
+    }
+    /**
+     * Clear a specific flag.
+     */
+    clearFlag(flag) {
+        this.flags &= ~flag;
+    }
+    // --- Peak cache ---
+    /**
+     * Store peak data for a given resolution (frames per peak entry).
+     *
+     * Replaces any previously cached data at the same resolution.
+     * Emits {@link peakCacheUpdated} with the resolution key.
+     */
+    setPeakData(resolution, data) {
+        this._peakCache.set(resolution, data);
+        this.peakCacheUpdated.emit(resolution);
+    }
+    /**
+     * Retrieve cached peak data for a given resolution.
+     *
+     * @returns The peak data, or `undefined` if not yet computed.
+     */
+    getPeakData(resolution) {
+        return this._peakCache.get(resolution);
+    }
+    /**
+     * Check whether peak data exists for a given resolution.
+     */
+    hasPeakData(resolution) {
+        return this._peakCache.has(resolution);
+    }
+    /**
+     * Clear all cached peak data for this source.
+     */
+    clearPeakCache() {
+        this._peakCache.clear();
+    }
+    // --- Analysis data ---
+    /**
+     * Set or replace analysis data for this source.
+     *
+     * This also updates the legacy {@link transients} array from the
+     * analysis results for backward compatibility.
+     * Emits {@link analysisCompleted} with the new data.
+     */
+    setAnalysisData(data) {
+        this._analysisData = data;
+        // Keep legacy transients array in sync
+        this.transients = data.transients;
+        this.analysisCompleted.emit(data);
+    }
+    /**
+     * Retrieve the analysis data, or `null` if no analysis has been run.
+     */
+    getAnalysisData() {
+        return this._analysisData;
+    }
+    // --- Cleanup ---
+    /**
+     * Release resources held by this source.
+     *
+     * Revokes the blob URL (if applicable), clears the peak cache, and
+     * disconnects all signal listeners. After disposal the source should
+     * not be used.
+     */
+    dispose() {
+        // Revoke blob URLs to free browser memory
+        if (this.url && this.url.startsWith('blob:')) {
+            try {
+                URL.revokeObjectURL(this.url);
+            }
+            catch (_a) {
+                // Best-effort; URL may already be revoked
+            }
+        }
+        this.clearPeakCache();
+        this._analysisData = null;
+        // Disconnect all signal listeners
+        this.peakCacheUpdated.clear();
+        this.analysisCompleted.clear();
     }
 }
 //# sourceMappingURL=Source.js.map

package/dist/domain/Source.js.map

@@ -1 +1 @@
-{"version":3,"file":"Source.js","sourceRoot":"","sources":["../../src/domain/Source.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,MAAM;IAQf,YACI,EAAY,EACZ,IAAY,EACZ,GAAW,EACX,QAAoB,EACpB,aAAqB,KAAK,EAC1B,eAAuB,CAAC;QAExB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACrC,CAAC;CACJ"}
+{"version":3,"file":"Source.js","sourceRoot":"","sources":["../../src/domain/Source.ts"],"names":[],"mappings":"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"}

package/dist/domain/Take.d.ts

@@ -2,7 +2,6 @@ import { Signal } from '../lib/Signal';
 import { RegionId, FrameCount, TrackId } from './types';
 /**
  * Take
- * Ardour 참조: libs/ardour/playlist.cc (take/layer management)
  *
  * A Take represents one recording pass during loop recording.
  * Multiple takes are stacked in a take lane for comping.

package/dist/domain/Take.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Take.d.ts","sourceRoot":"","sources":["../../src/domain/Take.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;;GAMG;AACH,qBAAa,IAAI;IACb,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,UAAU,EAAE,UAAU,CAAC;IACvC,SAAgB,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAS;IACjC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,SAAgB,gBAAgB,kBAAyB;gBAGrD,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,UAAU;IAWxB,IAAW,QAAQ,IAAI,UAAU,CAEhC;IAEM,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAOpC,MAAM,IAAI,YAAY;WAaf,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;CAYnD;AAED,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,QAAQ;IACjB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,MAAM,CAAc;IAE5B,SAAgB,SAAS,eAAsB;IAC/C,SAAgB,WAAW,iBAAwB;IACnD,SAAgB,aAAa,sBAA6B;gBAE9C,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAKjC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAKzB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIhD,IAAW,KAAK,IAAI,aAAa,CAAC,IAAI,CAAC,CAEtC;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUvC;;OAEG;IACI,aAAa,IAAI,IAAI,GAAG,SAAS;IAIxC;;;OAGG;IACI,wBAAwB,IAAI,QAAQ,EAAE;CAKhD"}
+{"version":3,"file":"Take.d.ts","sourceRoot":"","sources":["../../src/domain/Take.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;GAKG;AACH,qBAAa,IAAI;IACb,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IACnC,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,UAAU,EAAE,UAAU,CAAC;IACvC,SAAgB,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAS;IACjC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,SAAgB,gBAAgB,kBAAyB;gBAGrD,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,UAAU;IAWxB,IAAW,QAAQ,IAAI,UAAU,CAEhC;IAEM,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAOpC,MAAM,IAAI,YAAY;WAaf,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;CAYnD;AAED,MAAM,WAAW,YAAY;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,QAAQ;IACjB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,OAAO,CAAC,MAAM,CAAc;IAE5B,SAAgB,SAAS,eAAsB;IAC/C,SAAgB,WAAW,iBAAwB;IACnD,SAAgB,aAAa,sBAA6B;gBAE9C,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;IAKjC,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAKzB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIhD,IAAW,KAAK,IAAI,aAAa,CAAC,IAAI,CAAC,CAEtC;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAUvC;;OAEG;IACI,aAAa,IAAI,IAAI,GAAG,SAAS;IAIxC;;;OAGG;IACI,wBAAwB,IAAI,QAAQ,EAAE;CAKhD"}

package/dist/domain/Take.js

@@ -1,7 +1,6 @@
 import { Signal } from '../lib/Signal';
 /**
  * Take
- * Ardour 참조: libs/ardour/playlist.cc (take/layer management)
  *
  * A Take represents one recording pass during loop recording.
  * Multiple takes are stacked in a take lane for comping.

package/dist/domain/Take.js.map

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

package/dist/domain/ThawList.d.ts

@@ -0,0 +1,36 @@
+import { Signal } from '../lib/Signal';
+/**
+ * ThawList - Defers signal emissions during batch operations.
+ * Collects change notifications and emits them all at once when thawed.
+ */
+export declare class ThawList {
+    private _frozen;
+    private _pendingEmissions;
+    private _changeCount;
+    /** Freeze: begin collecting emissions instead of firing them immediately. */
+    freeze(): void;
+    /**
+     * Thaw: emit all pending signals that were queued while frozen,
+     * then reset to the unfrozen state.
+     */
+    thaw(): void;
+    /** Whether the ThawList is currently frozen. */
+    isFrozen(): boolean;
+    /**
+     * Queue an emission. If frozen, the emission is stored and will be
+     * fired when {@link thaw} is called. If not frozen, the signal is
+     * emitted immediately.
+     */
+    queueEmission<T>(signal: Signal<T>, data: T): void;
+    /** Get the number of pending emissions queued while frozen. */
+    getPendingCount(): number;
+    /** Discard all pending emissions without firing them. */
+    discard(): void;
+    /**
+     * Execute a callback within a freeze/thaw block.
+     * The thawList is frozen before fn() runs and thawed after it completes,
+     * even if fn() throws.
+     */
+    static batch(fn: () => void, thawList: ThawList): void;
+}
+//# sourceMappingURL=ThawList.d.ts.map

package/dist/domain/ThawList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThawList.d.ts","sourceRoot":"","sources":["../../src/domain/ThawList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC;;;GAGG;AACH,qBAAa,QAAQ;IACjB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,iBAAiB,CAAiD;IAC1E,OAAO,CAAC,YAAY,CAAa;IAIjC,6EAA6E;IACtE,MAAM,IAAI,IAAI;IAIrB;;;OAGG;IACI,IAAI,IAAI,IAAI;IASnB,gDAAgD;IACzC,QAAQ,IAAI,OAAO;IAM1B;;;;OAIG;IACI,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI;IAWzD,+DAA+D;IACxD,eAAe,IAAI,MAAM;IAIhC,yDAAyD;IAClD,OAAO,IAAI,IAAI;IAMtB;;;;OAIG;WACW,KAAK,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAQhE"}

package/dist/domain/ThawList.js

@@ -0,0 +1,72 @@
+/**
+ * ThawList - Defers signal emissions during batch operations.
+ * Collects change notifications and emits them all at once when thawed.
+ */
+export class ThawList {
+    constructor() {
+        this._frozen = false;
+        this._pendingEmissions = [];
+        this._changeCount = 0;
+    }
+    // ─── Freeze / Thaw ──────────────────────────────────────────────────────
+    /** Freeze: begin collecting emissions instead of firing them immediately. */
+    freeze() {
+        this._frozen = true;
+    }
+    /**
+     * Thaw: emit all pending signals that were queued while frozen,
+     * then reset to the unfrozen state.
+     */
+    thaw() {
+        this._frozen = false;
+        const pending = [...this._pendingEmissions];
+        this._pendingEmissions = [];
+        for (const { signal, data } of pending) {
+            signal.emit(data);
+        }
+    }
+    /** Whether the ThawList is currently frozen. */
+    isFrozen() {
+        return this._frozen;
+    }
+    // ─── Emission Queuing ───────────────────────────────────────────────────
+    /**
+     * Queue an emission. If frozen, the emission is stored and will be
+     * fired when {@link thaw} is called. If not frozen, the signal is
+     * emitted immediately.
+     */
+    queueEmission(signal, data) {
+        this._changeCount++;
+        if (this._frozen) {
+            this._pendingEmissions.push({ signal, data });
+        }
+        else {
+            signal.emit(data);
+        }
+    }
+    // ─── Inspection ─────────────────────────────────────────────────────────
+    /** Get the number of pending emissions queued while frozen. */
+    getPendingCount() {
+        return this._pendingEmissions.length;
+    }
+    /** Discard all pending emissions without firing them. */
+    discard() {
+        this._pendingEmissions = [];
+    }
+    // ─── Batch Helper ───────────────────────────────────────────────────────
+    /**
+     * Execute a callback within a freeze/thaw block.
+     * The thawList is frozen before fn() runs and thawed after it completes,
+     * even if fn() throws.
+     */
+    static batch(fn, thawList) {
+        thawList.freeze();
+        try {
+            fn();
+        }
+        finally {
+            thawList.thaw();
+        }
+    }
+}
+//# sourceMappingURL=ThawList.js.map

package/dist/domain/ThawList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThawList.js","sourceRoot":"","sources":["../../src/domain/ThawList.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,QAAQ;IAArB;QACY,YAAO,GAAY,KAAK,CAAC;QACzB,sBAAiB,GAA8C,EAAE,CAAC;QAClE,iBAAY,GAAW,CAAC,CAAC;IAsErC,CAAC;IApEG,2EAA2E;IAE3E,6EAA6E;IACtE,MAAM;QACT,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACxB,CAAC;IAED;;;OAGG;IACI,IAAI;QACP,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC5C,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;QAC5B,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IAED,gDAAgD;IACzC,QAAQ;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,2EAA2E;IAE3E;;;;OAIG;IACI,aAAa,CAAI,MAAiB,EAAE,IAAO;QAC9C,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IAED,2EAA2E;IAE3E,+DAA+D;IACxD,eAAe;QAClB,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;IACzC,CAAC;IAED,yDAAyD;IAClD,OAAO;QACV,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,2EAA2E;IAE3E;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,EAAc,EAAE,QAAkB;QAClD,QAAQ,CAAC,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC;YACD,EAAE,EAAE,CAAC;QACT,CAAC;gBAAS,CAAC;YACP,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;IACL,CAAC;CACJ"}

package/dist/domain/Track.d.ts

@@ -1,7 +1,7 @@
 import { Route } from './Route';
 import { Playlist } from './Playlist';
 import { Signal } from '../lib/Signal';
-import { TrackId } from './types';
+import { TrackId, FrameCount } from './types';
 import { MonitorMode } from './MonitorMode';
 export declare enum TrackType {
     AUDIO = "AUDIO",
@@ -11,6 +11,23 @@ export declare enum TrackType {
     FOLDER = "FOLDER",
     VCA = "VCA"
 }
+export interface BounceConfig {
+    startFrame?: number;
+    endFrame?: number;
+    includePlugins: boolean;
+    includeAutomation: boolean;
+}
+/**
+ * Track mode determines recording and playback behavior.
+ *
+ * - 'normal': standard layered playback (default) -- all overlapping regions
+ *   play simultaneously, respecting layer ordering.
+ * - 'non_layered': only the top-most region at any given time position is
+ *   audible; lower layers are silenced.
+ * - 'tape': destructive recording mode -- new audio physically replaces
+ *   existing audio in the source file rather than creating new regions.
+ */
+export type TrackMode = 'normal' | 'non_layered' | 'tape';
 export declare class Track {
     readonly id: TrackId;
     name: string;
@@ -32,6 +49,9 @@ export declare class Track {
     parentTrackId: TrackId | null;
     groupId: string | null;
     isCollapsed: boolean;
+    private _alignStyle;
+    private _trackMode;
+    private _bounceProgress;
     readonly armChanged: Signal<boolean>;
     readonly monitorChanged: Signal<boolean>;
     readonly muteChanged: Signal<boolean>;
@@ -42,6 +62,12 @@ export declare class Track {
     readonly trimGainChanged: Signal<number>;
     readonly colorChanged: Signal<string>;
     readonly frozenChanged: Signal<boolean>;
+    readonly alignStyleChanged: Signal<string>;
+    readonly trackModeChanged: Signal<string>;
+    readonly bounceProgressChanged: Signal<number>;
+    readonly bounceCompleted: Signal<{
+        sourceId: string;
+    }>;
     constructor(id: TrackId, name: string, type: TrackType);
     rename(newName: string): void;
     setArmed(armed: boolean): void;
@@ -54,5 +80,71 @@ export declare class Track {
     setSoloSafe(safe: boolean): void;
     setMonitorMode(mode: MonitorMode): void;
     setTrimGain(db: number): void;
+    /**
+     * Whether the track can be frozen. Returns false if already frozen.
+     */
+    canFreeze(): boolean;
+    /**
+     * Whether the track can be bounced.
+     * Audio and MIDI tracks can be bounced; AUX, BUS, FOLDER, and VCA cannot.
+     */
+    canBounce(): boolean;
+    /**
+     * Get the default bounce configuration for this track.
+     */
+    getBounceConfig(): BounceConfig;
+    /**
+     * Get a bounce configuration for a specific frame range.
+     *
+     * @param startFrame The start frame of the bounce range.
+     * @param endFrame   The end frame of the bounce range.
+     * @returns A BounceConfig with the specified range.
+     */
+    getBounceRangeConfig(startFrame: FrameCount, endFrame: FrameCount): BounceConfig;
+    /**
+     * Freeze the track, storing a reference to the rendered source.
+     *
+     * Freezing renders the track's output (including all plugins and
+     * automation) to a new audio source. The original playlist is preserved
+     * so it can be restored on unfreeze. While frozen, the track plays
+     * back from the rendered source and plugins are bypassed.
+     *
+     * @param sourceId Identifier of the rendered audio source.
+     */
+    freeze(sourceId: string): void;
+    /**
+     * Unfreeze the track, restoring the original playlist and plugins.
+     * Discards the frozen source reference.
+     */
+    unfreeze(): void;
+    /**
+     * Update the bounce progress.
+     * Used by the engine to report rendering progress to the UI.
+     *
+     * @param progress A value between 0 (not started) and 1 (complete).
+     */
+    setBounceProgress(progress: number): void;
+    /** Current bounce progress (0 to 1). */
+    get bounceProgress(): number;
+    /**
+     * Signal that a bounce operation has completed.
+     * Resets bounce progress to 0 and emits the bounceCompleted signal.
+     *
+     * @param sourceId Identifier of the newly created audio source.
+     */
+    completeBounce(sourceId: string): void;
+    /** Get the current alignment style for recording. */
+    getAlignStyle(): string;
+    /** Set the alignment style for recording. */
+    setAlignStyle(style: 'existing_material' | 'capture_time'): void;
+    /** Get the current track mode. */
+    getTrackMode(): string;
+    /**
+     * Set the track mode.
+     * - 'normal': standard layered playback (default)
+     * - 'non_layered': only one region plays at a time (highest layer wins)
+     * - 'tape': destructive recording, new audio replaces old
+     */
+    setTrackMode(mode: TrackMode): void;
 }
 //# sourceMappingURL=Track.d.ts.map

package/dist/domain/Track.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Track.d.ts","sourceRoot":"","sources":["../../src/domain/Track.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,OAAO,EAAW,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,oBAAY,SAAS;IACjB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,GAAG,QAAQ;CACd;AAED,qBAAa,KAAK;IACd,SAAgB,EAAE,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACpB,SAAgB,IAAI,EAAE,SAAS,CAAC;IAEhC,SAAgB,KAAK,EAAE,KAAK,CAAC;IAC7B,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAE5B,KAAK,EAAE,OAAO,CAAS;IACvB,OAAO,EAAE,OAAO,CAAS;IACzB,IAAI,EAAE,OAAO,CAAS;IACtB,IAAI,EAAE,OAAO,CAAS;IACtB,KAAK,EAAE,MAAM,CAAa;IAG1B,WAAW,EAAE,OAAO,CAAS;IAC7B,QAAQ,EAAE,OAAO,CAAS;IAG1B,WAAW,EAAE,WAAW,CAAoB;IAG5C,QAAQ,EAAE,MAAM,CAAK;IAGrB,OAAO,EAAE,MAAM,CAAM;IAGrB,MAAM,EAAE,OAAO,CAAS;IACxB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGrC,aAAa,EAAE,OAAO,GAAG,IAAI,CAAQ;IACrC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC9B,WAAW,EAAE,OAAO,CAAS;IAGpC,SAAgB,UAAU,kBAAyB;IACnD,SAAgB,cAAc,kBAAyB;IACvD,SAAgB,WAAW,kBAAyB;IACpD,SAAgB,WAAW,kBAAyB;IACpD,SAAgB,kBAAkB,kBAAyB;IAC3D,SAAgB,eAAe,kBAAyB;IACxD,SAAgB,kBAAkB,sBAA6B;IAC/D,SAAgB,eAAe,iBAAwB;IACvD,SAAgB,YAAY,iBAAwB;IACpD,SAAgB,aAAa,kBAAyB;gBAE1C,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS;IAW/C,MAAM,CAAC,OAAO,EAAE,MAAM;IAMtB,QAAQ,CAAC,KAAK,EAAE,OAAO;IAOvB,UAAU,CAAC,OAAO,EAAE,OAAO;IAO3B,OAAO,CAAC,IAAI,EAAE,OAAO;IAOrB,OAAO,CAAC,IAAI,EAAE,OAAO;IAOrB,QAAQ,CAAC,KAAK,EAAE,MAAM;IAOtB,SAAS,CAAC,MAAM,EAAE,OAAO;IAOzB,cAAc,CAAC,OAAO,EAAE,OAAO;IAO/B,WAAW,CAAC,IAAI,EAAE,OAAO;IAOzB,cAAc,CAAC,IAAI,EAAE,WAAW;IAOhC,WAAW,CAAC,EAAE,EAAE,MAAM;CAQhC"}
+{"version":3,"file":"Track.d.ts","sourceRoot":"","sources":["../../src/domain/Track.ts"],"names":[],"mappings":"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"}