@drop-ai/core 0.2.0

package/dist/domain/Region.js

@@ -0,0 +1,219 @@
+import { TimeDomain } from './temporal/types';
+import { Signal } from '../lib/Signal';
+import { OverlapType } from './OverlapType';
+import { FadeShape } from './FadeEnvelope';
+export class Region {
+    constructor(id, sourceId, start, length, sourceStart, name, layer = 0) {
+        // Source usage
+        this.sourceStart = 0;
+        // Playback properties
+        this.gain = 1.0;
+        this.muted = false;
+        this.layer = 0;
+        this.fadeIn = 0;
+        this.fadeOut = 0;
+        this.fadeInShape = FadeShape.EQUAL_POWER;
+        this.fadeOutShape = FadeShape.EQUAL_POWER;
+        this.playbackRate = 1.0;
+        /** Pitch-preserving time stretch ratio (1.0 = normal, 0.5 = half speed, 2.0 = double speed) */
+        this.stretch = 1.0;
+        /** Pitch shift in semitones (0 = no shift, positive = higher, negative = lower) */
+        this.pitchSemitones = 0;
+        // Sync point (offset from region start, used for snap alignment)
+        this.syncPosition = null;
+        // Transient positions (frame offsets from region start / source)
+        this.transients = [];
+        // Lock state
+        this.locked = false;
+        /** Time domain for this region (default: AudioTime for backward compatibility) */
+        this.timeDomain = TimeDomain.AudioTime;
+        // Signals
+        this.lockedChanged = new Signal();
+        this.id = id;
+        this.sourceId = sourceId;
+        this.start = start;
+        this.length = length;
+        this.sourceStart = sourceStart;
+        this.name = name;
+        this.layer = layer;
+    }
+    get end() {
+        return this.start + this.length;
+    }
+    /** Get position as TimePosition */
+    getPosition() {
+        return { domain: this.timeDomain, value: this.start };
+    }
+    /** Get duration as TimePosition */
+    getDuration() {
+        return { domain: this.timeDomain, value: this.length };
+    }
+    /** Set position from TimePosition (converts if needed) */
+    setPosition(pos, tempoMap, bpm) {
+        this.start = tempoMap.toFrames(pos, bpm);
+        this.timeDomain = pos.domain;
+    }
+    /** Set duration from TimePosition (converts if needed) */
+    setDuration(duration, tempoMap, bpm) {
+        this.length = tempoMap.toFrames(duration, bpm);
+        // Duration should match position's domain
+        this.timeDomain = duration.domain;
+    }
+    setLocked(locked) {
+        if (this.locked === locked)
+            return;
+        this.locked = locked;
+        this.lockedChanged.emit(locked);
+    }
+    resize(newLength) {
+        if (newLength < 0)
+            return;
+        this.length = newLength;
+    }
+    move(newStart) {
+        if (newStart < 0)
+            newStart = 0;
+        this.start = newStart;
+    }
+    trimFront(amount) {
+        if (amount >= this.length)
+            return; // Prevent full deletion via trim
+        this.start += amount;
+        this.sourceStart += amount;
+        this.length -= amount;
+    }
+    trimBack(amount) {
+        if (-amount >= this.length)
+            return; // Prevent full deletion via trim
+        this.length += amount; // amount can be negative for trimming, positive for extending
+    }
+    setFadeIn(amount) {
+        if (amount < 0)
+            amount = 0;
+        if (amount + this.fadeOut > this.length) {
+            amount = this.length - this.fadeOut;
+        }
+        this.fadeIn = amount;
+    }
+    setFadeOut(amount) {
+        if (amount < 0)
+            amount = 0;
+        if (this.fadeIn + amount > this.length) {
+            amount = this.length - this.fadeIn;
+        }
+        this.fadeOut = amount;
+    }
+    // ─── C-2: Advanced Fade System ────────────────────────────────────────────
+    /** Set the fade-in curve shape. */
+    setFadeInShape(shape) {
+        this.fadeInShape = shape;
+    }
+    /** Set the fade-out curve shape. */
+    setFadeOutShape(shape) {
+        this.fadeOutShape = shape;
+    }
+    // ─── C-1: Region Overlap & Coverage Detection ────────────────────────────
+    /**
+     * Determine how a query range [start, end) relates to this region.
+     */
+    coverage(start, end) {
+        const rStart = this.start;
+        const rEnd = this.end;
+        // No overlap at all
+        if (start >= rEnd || end <= rStart) {
+            return OverlapType.NONE;
+        }
+        // Region is fully inside the query range
+        if (start <= rStart && end >= rEnd) {
+            return OverlapType.EXTERNAL;
+        }
+        // Query is fully inside the region
+        if (start >= rStart && end <= rEnd) {
+            return OverlapType.INTERNAL;
+        }
+        // Query overlaps the region's start (query starts before region)
+        if (start < rStart) {
+            return OverlapType.START;
+        }
+        // Query overlaps the region's end (query ends after region)
+        return OverlapType.END;
+    }
+    /**
+     * Does this region cover the given frame position?
+     */
+    covers(frame) {
+        return frame >= this.start && frame < this.end;
+    }
+    // ─── C-3: Sync Point ─────────────────────────────────────────────────────
+    /** Set the sync point as an offset from the region start. */
+    setSyncPosition(offset) {
+        this.syncPosition = offset;
+    }
+    /** Clear the sync point. */
+    clearSyncPosition() {
+        this.syncPosition = null;
+    }
+    /**
+     * Get the sync offset. Returns 0 if no sync point is set.
+     */
+    getSyncOffset() {
+        var _a;
+        return (_a = this.syncPosition) !== null && _a !== void 0 ? _a : 0;
+    }
+    /**
+     * Adjust a frame position by the sync offset.
+     * Useful for snap-to-grid alignment: if the region has a sync point,
+     * the snap target should account for this offset.
+     */
+    adjustToSync(frame) {
+        return frame - this.getSyncOffset();
+    }
+    // ─── C-4: Region Equivalence & Grouping ──────────────────────────────────
+    /**
+     * True if both regions reference the same source, have the same position,
+     * length, and source start.
+     */
+    exactEquivalent(other) {
+        return (this.sourceId === other.sourceId &&
+            this.start === other.start &&
+            this.length === other.length &&
+            this.sourceStart === other.sourceStart);
+    }
+    /** True if both regions reference the same source file. */
+    sourceEquivalent(other) {
+        return this.sourceId === other.sourceId;
+    }
+    /** True if the two regions overlap in time. */
+    overlapEquivalent(other) {
+        return this.start < other.end && other.start < this.end;
+    }
+    /** True if the two regions share the same layer and overlap in time. */
+    layerAndTimeEquivalent(other) {
+        return this.layer === other.layer && this.overlapEquivalent(other);
+    }
+    // ─── C-6: Transient helpers ──────────────────────────────────────────────
+    /** Add a transient at the given frame position. Keeps the list sorted. */
+    addTransient(frame) {
+        // Avoid duplicates
+        if (this.transients.includes(frame))
+            return;
+        this.transients.push(frame);
+        this.transients.sort((a, b) => a - b);
+    }
+    /** Remove the transient at the given frame position (if present). */
+    removeTransient(frame) {
+        const idx = this.transients.indexOf(frame);
+        if (idx !== -1) {
+            this.transients.splice(idx, 1);
+        }
+    }
+    /** Get a readonly copy of the transient positions. */
+    getTransients() {
+        return this.transients;
+    }
+    /** Whether this region has any detected/manual transients. */
+    hasTransients() {
+        return this.transients.length > 0;
+    }
+}
+//# sourceMappingURL=Region.js.map

package/dist/domain/Region.js.map

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

package/dist/domain/RegionClipboard.d.ts

@@ -0,0 +1,56 @@
+import { Region } from './Region';
+import { TrackId, SourceId, FrameCount } from './types';
+/**
+ * Region Clipboard Data
+ *
+ * Copy된 Region의 정보를 저장합니다.
+ * Ardour 참조: gtk2_ardour/editor.h (RegionSelection)
+ */
+export interface ClipboardRegionData {
+    sourceId: SourceId;
+    start: FrameCount;
+    length: FrameCount;
+    originalTrackId: TrackId;
+    name: string;
+}
+/**
+ * Region Clipboard
+ *
+ * Region copy/paste 기능을 위한 클립보드입니다.
+ * Singleton 패턴으로 구현됩니다.
+ */
+export declare class RegionClipboard {
+    private static instance;
+    private _clipboardData;
+    private _pasteCount;
+    private constructor();
+    static getInstance(): RegionClipboard;
+    /**
+     * Region을 클립보드에 복사
+     */
+    copy(regions: Region[], trackIds: TrackId[]): void;
+    /**
+     * 클립보드에서 Region 데이터 가져오기
+     */
+    getClipboardData(): ReadonlyArray<ClipboardRegionData>;
+    /**
+     * 클립보드가 비어있는지 확인
+     */
+    isEmpty(): boolean;
+    /**
+     * 클립보드 비우기
+     */
+    clear(): void;
+    /**
+     * Paste count for offset tracking.
+     * Ardour: paste_count in editor.h
+     */
+    get pasteCount(): number;
+    incrementPasteCount(): void;
+    /**
+     * Reset paste count.
+     * Called on undo/redo (Ardour: paste_count = 0 in do_undo/do_redo).
+     */
+    resetPasteCount(): void;
+}
+//# sourceMappingURL=RegionClipboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RegionClipboard.d.ts","sourceRoot":"","sources":["../../src/domain/RegionClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkB;IACzC,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,WAAW,CAAa;IAEhC,OAAO;WAEO,WAAW,IAAI,eAAe;IAO5C;;OAEG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;IAczD;;OAEG;IACI,gBAAgB,IAAI,aAAa,CAAC,mBAAmB,CAAC;IAI7D;;OAEG;IACI,OAAO,IAAI,OAAO;IAIzB;;OAEG;IACI,KAAK,IAAI,IAAI;IAKpB;;;OAGG;IACH,IAAW,UAAU,IAAI,MAAM,CAE9B;IAEM,mBAAmB,IAAI,IAAI;IAIlC;;;OAGG;IACI,eAAe,IAAI,IAAI;CAGjC"}

package/dist/domain/RegionClipboard.js

@@ -0,0 +1,70 @@
+/**
+ * Region Clipboard
+ *
+ * Region copy/paste 기능을 위한 클립보드입니다.
+ * Singleton 패턴으로 구현됩니다.
+ */
+export class RegionClipboard {
+    constructor() {
+        this._clipboardData = [];
+        this._pasteCount = 0;
+    }
+    static getInstance() {
+        if (!RegionClipboard.instance) {
+            RegionClipboard.instance = new RegionClipboard();
+        }
+        return RegionClipboard.instance;
+    }
+    /**
+     * Region을 클립보드에 복사
+     */
+    copy(regions, trackIds) {
+        if (regions.length !== trackIds.length) {
+            throw new Error('Regions and trackIds length mismatch');
+        }
+        this._clipboardData = regions.map((region, index) => ({
+            sourceId: region.sourceId,
+            start: region.start,
+            length: region.length,
+            originalTrackId: trackIds[index],
+            name: region.name || 'Region'
+        }));
+    }
+    /**
+     * 클립보드에서 Region 데이터 가져오기
+     */
+    getClipboardData() {
+        return this._clipboardData;
+    }
+    /**
+     * 클립보드가 비어있는지 확인
+     */
+    isEmpty() {
+        return this._clipboardData.length === 0;
+    }
+    /**
+     * 클립보드 비우기
+     */
+    clear() {
+        this._clipboardData = [];
+        this._pasteCount = 0;
+    }
+    /**
+     * Paste count for offset tracking.
+     * Ardour: paste_count in editor.h
+     */
+    get pasteCount() {
+        return this._pasteCount;
+    }
+    incrementPasteCount() {
+        this._pasteCount++;
+    }
+    /**
+     * Reset paste count.
+     * Called on undo/redo (Ardour: paste_count = 0 in do_undo/do_redo).
+     */
+    resetPasteCount() {
+        this._pasteCount = 0;
+    }
+}
+//# sourceMappingURL=RegionClipboard.js.map

package/dist/domain/RegionClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegionClipboard.js","sourceRoot":"","sources":["../../src/domain/RegionClipboard.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAKxB;QAHQ,mBAAc,GAA0B,EAAE,CAAC;QAC3C,gBAAW,GAAW,CAAC,CAAC;IAET,CAAC;IAEjB,MAAM,CAAC,WAAW;QACrB,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,CAAC;YAC5B,eAAe,CAAC,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,eAAe,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED;;OAEG;IACI,IAAI,CAAC,OAAiB,EAAE,QAAmB;QAC9C,IAAI,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC5D,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YAClD,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,eAAe,EAAE,QAAQ,CAAC,KAAK,CAAC;YAChC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,QAAQ;SAChC,CAAC,CAAC,CAAC;IACR,CAAC;IAED;;OAEG;IACI,gBAAgB;QACnB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,OAAO;QACV,OAAO,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACI,KAAK;QACR,IAAI,CAAC,cAAc,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IAEM,mBAAmB;QACtB,IAAI,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;IAED;;;OAGG;IACI,eAAe;QAClB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACzB,CAAC;CACJ"}

package/dist/domain/RegionGroup.d.ts

@@ -0,0 +1,16 @@
+import { Signal } from '../lib/Signal';
+export type RegionGroupId = string;
+export declare class RegionGroup {
+    readonly id: RegionGroupId;
+    name: string;
+    private _regionIds;
+    readonly changed: Signal<RegionGroup>;
+    constructor(id: RegionGroupId, name: string, regionIds?: string[]);
+    get regionIds(): ReadonlySet<string>;
+    addRegion(regionId: string): void;
+    removeRegion(regionId: string): void;
+    hasRegion(regionId: string): boolean;
+    get size(): number;
+    getRegionIds(): string[];
+}
+//# sourceMappingURL=RegionGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RegionGroup.d.ts","sourceRoot":"","sources":["../../src/domain/RegionGroup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,qBAAa,WAAW;IACpB,SAAgB,EAAE,EAAE,aAAa,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,UAAU,CAA0B;IAG5C,SAAgB,OAAO,sBAA6B;gBAExC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE;IAUjE,IAAW,SAAS,IAAI,WAAW,CAAC,MAAM,CAAC,CAE1C;IAEM,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKjC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI3C,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,YAAY,IAAI,MAAM,EAAE;CAGlC"}

package/dist/domain/RegionGroup.js

@@ -0,0 +1,36 @@
+import { Signal } from '../lib/Signal';
+export class RegionGroup {
+    constructor(id, name, regionIds) {
+        this._regionIds = new Set();
+        // Signals
+        this.changed = new Signal();
+        this.id = id;
+        this.name = name;
+        if (regionIds) {
+            for (const rid of regionIds) {
+                this._regionIds.add(rid);
+            }
+        }
+    }
+    get regionIds() {
+        return this._regionIds;
+    }
+    addRegion(regionId) {
+        this._regionIds.add(regionId);
+        this.changed.emit(this);
+    }
+    removeRegion(regionId) {
+        this._regionIds.delete(regionId);
+        this.changed.emit(this);
+    }
+    hasRegion(regionId) {
+        return this._regionIds.has(regionId);
+    }
+    get size() {
+        return this._regionIds.size;
+    }
+    getRegionIds() {
+        return Array.from(this._regionIds);
+    }
+}
+//# sourceMappingURL=RegionGroup.js.map

package/dist/domain/RegionGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegionGroup.js","sourceRoot":"","sources":["../../src/domain/RegionGroup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAIvC,MAAM,OAAO,WAAW;IAQpB,YAAY,EAAiB,EAAE,IAAY,EAAE,SAAoB;QALzD,eAAU,GAAgB,IAAI,GAAG,EAAE,CAAC;QAE5C,UAAU;QACM,YAAO,GAAG,IAAI,MAAM,EAAe,CAAC;QAGhD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,SAAS,EAAE,CAAC;YACZ,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC;IACL,CAAC;IAED,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAEM,SAAS,CAAC,QAAgB;QAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEM,YAAY,CAAC,QAAgB;QAChC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEM,SAAS,CAAC,QAAgB;QAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAChC,CAAC;IAEM,YAAY;QACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;CACJ"}

package/dist/domain/Route.d.ts

@@ -0,0 +1,104 @@
+import { RouteId, ProcessorId } from './types';
+import { Processor } from '../processing/Processor';
+import { GainProcessor } from '../processing/GainProcessor';
+import { PanProcessor } from '../processing/PanProcessor';
+import { PolarityProcessor } from '../processing/PolarityProcessor';
+import { IO } from '../processing/IO';
+import { Signal } from '../lib/Signal';
+export declare class Route {
+    readonly id: RouteId;
+    name: string;
+    readonly input: IO;
+    readonly output: IO;
+    private _preFaderProcessors;
+    private _postFaderProcessors;
+    readonly processorAdded: Signal<Processor>;
+    readonly processorRemoved: Signal<string>;
+    /** Input gain correction (pre-fader). */
+    private _trim;
+    /** Main channel fader. */
+    private _fader;
+    /** Phase inversion processor (post-fader, before post-fader plugins). */
+    private _polarity;
+    /** Channel panner. */
+    private _panner;
+    private _active;
+    /**
+     * Auto-computed compensation delay (in samples) applied to this route
+     * so that all routes in the session are time-aligned.
+     */
+    private _compensationDelay;
+    constructor(id: RouteId, name: string);
+    /**
+     * Adds a processor to the chain.
+     * @param processor The processor to add
+     * @param position 'pre' (before fader) or 'post' (after fader)
+     * @param index Index within the specific chain (not global index)
+     */
+    addProcessor(processor: Processor, position?: 'pre' | 'post', index?: number): void;
+    removeProcessor(id: ProcessorId): void;
+    /**
+     * Reorder a processor within the same chain (pre or post fader).
+     */
+    reorderProcessor(id: ProcessorId, newIndex: number): void;
+    /**
+     * Full ordered processor chain.
+     *
+     * Order: Trim -> [Pre-fader] -> Fader -> Polarity -> [Post-fader] -> Panner
+     */
+    get processors(): ReadonlyArray<Processor>;
+    get preFaderProcessors(): ReadonlyArray<Processor>;
+    get postFaderProcessors(): ReadonlyArray<Processor>;
+    get volume(): number;
+    set volume(db: number);
+    get pan(): number;
+    set pan(val: number);
+    /**
+     * Input trim gain in dB.
+     * Used for pre-fader level correction (e.g. mic preamp adjustment).
+     */
+    get trim(): number;
+    set trim(db: number);
+    get active(): boolean;
+    set active(value: boolean);
+    /** Input trim gain processor. */
+    get trimProcessor(): GainProcessor;
+    /** Main channel fader. */
+    get fader(): GainProcessor;
+    /** Polarity (phase inversion) processor. */
+    get polarity(): PolarityProcessor;
+    /** Channel panner. */
+    get panner(): PanProcessor;
+    /**
+     * Sum of latencies (in samples) introduced by all processors in this route.
+     *
+     * This represents the total processing delay that audio experiences as it
+     * passes through the signal chain.  Used by the session to compute
+     * per-route compensation delays so that all routes stay time-aligned.
+     */
+    getProcessorLatency(): number;
+    /**
+     * The current compensation delay applied to this route (in samples).
+     *
+     * The value is set by the session / engine after evaluating all routes.
+     * A route with lower inherent latency gets a larger compensation delay
+     * so that every route's effective latency equals the session maximum.
+     */
+    get compensationDelay(): number;
+    /**
+     * Directly set the compensation delay for this route.
+     * @param samples Delay in samples (>= 0).
+     */
+    setCompensationDelay(samples: number): void;
+    /**
+     * Compute the compensation delay needed for this route given the
+     * maximum latency across the entire session.
+     *
+     * Call this once per route after determining `maxLatency` via
+     * `Math.max(...routes.map(r => r.getProcessorLatency()))`.
+     *
+     * @param maxLatency The highest processor latency among all routes (in samples).
+     */
+    computeLatencyCompensation(maxLatency: number): void;
+}
+//# sourceMappingURL=Route.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Route.d.ts","sourceRoot":"","sources":["../../src/domain/Route.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,qBAAa,KAAK;IACd,SAAgB,EAAE,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IAGpB,SAAgB,KAAK,EAAE,EAAE,CAAC;IAC1B,SAAgB,MAAM,EAAE,EAAE,CAAC;IAE3B,OAAO,CAAC,mBAAmB,CAAmB;IAC9C,OAAO,CAAC,oBAAoB,CAAmB;IAE/C,SAAgB,cAAc,oBAA2B;IACzD,SAAgB,gBAAgB,iBAA6B;IAO7D,yCAAyC;IACzC,OAAO,CAAC,KAAK,CAAgB;IAC7B,0BAA0B;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,yEAAyE;IACzE,OAAO,CAAC,SAAS,CAAoB;IACrC,sBAAsB;IACtB,OAAO,CAAC,OAAO,CAAe;IAE9B,OAAO,CAAC,OAAO,CAAiB;IAGhC;;;OAGG;IACH,OAAO,CAAC,kBAAkB,CAAa;gBAE3B,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM;IAkBrC;;;;;OAKG;IACI,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,GAAE,KAAK,GAAG,MAAc,EAAE,KAAK,CAAC,EAAE,MAAM;IAcnF,eAAe,CAAC,EAAE,EAAE,WAAW;IAkBtC;;OAEG;IACI,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM;IAmBzD;;;;OAIG;IACH,IAAW,UAAU,IAAI,aAAa,CAAC,SAAS,CAAC,CAShD;IAED,IAAW,kBAAkB,IAAI,aAAa,CAAC,SAAS,CAAC,CAExD;IAED,IAAW,mBAAmB,IAAI,aAAa,CAAC,SAAS,CAAC,CAEzD;IAID,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,EAAE,EAAE,MAAM,EAE3B;IAED,IAAW,GAAG,IAAI,MAAM,CAEvB;IAED,IAAW,GAAG,CAAC,GAAG,EAAE,MAAM,EAEzB;IAED;;;OAGG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,CAAC,EAAE,EAAE,MAAM,EAEzB;IAED,IAAW,MAAM,IAAI,OAAO,CAE3B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,OAAO,EAE/B;IAID,iCAAiC;IACjC,IAAW,aAAa,IAAI,aAAa,CAAuB;IAChE,0BAA0B;IAC1B,IAAW,KAAK,IAAI,aAAa,CAAwB;IACzD,4CAA4C;IAC5C,IAAW,QAAQ,IAAI,iBAAiB,CAA2B;IACnE,sBAAsB;IACtB,IAAW,MAAM,IAAI,YAAY,CAAyB;IAI1D;;;;;;OAMG;IACI,mBAAmB,IAAI,MAAM;IAQpC;;;;;;OAMG;IACH,IAAW,iBAAiB,IAAI,MAAM,CAErC;IAED;;;OAGG;IACI,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIlD;;;;;;;;OAQG;IACI,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAI9D"}