@drop-ai/core 0.2.0 → 0.3.0

package/dist/domain/Track.js

@@ -34,6 +34,12 @@ export class Track {
         this.parentTrackId = null;
         this.groupId = null;
         this.isCollapsed = false;
+        // Alignment style (for recording)
+        this._alignStyle = 'existing_material';
+        // Track mode
+        this._trackMode = 'normal';
+        // Enhanced bounce/freeze state
+        this._bounceProgress = 0;
         // Signals
         this.armChanged = new Signal();
         this.monitorChanged = new Signal();
@@ -45,6 +51,10 @@ export class Track {
         this.trimGainChanged = new Signal();
         this.colorChanged = new Signal();
         this.frozenChanged = new Signal();
+        this.alignStyleChanged = new Signal();
+        this.trackModeChanged = new Signal();
+        this.bounceProgressChanged = new Signal();
+        this.bounceCompleted = new Signal();
         this.id = id;
         this.name = name;
         this.type = type;
@@ -120,5 +130,131 @@ export class Track {
             this.trimGainChanged.emit(clamped);
         }
     }
+    // ─── Bounce / Freeze Configuration ──────────────────────────────────────
+    /**
+     * Whether the track can be frozen. Returns false if already frozen.
+     */
+    canFreeze() {
+        return !this.frozen;
+    }
+    /**
+     * Whether the track can be bounced.
+     * Audio and MIDI tracks can be bounced; AUX, BUS, FOLDER, and VCA cannot.
+     */
+    canBounce() {
+        return this.type === TrackType.AUDIO || this.type === TrackType.MIDI;
+    }
+    /**
+     * Get the default bounce configuration for this track.
+     */
+    getBounceConfig() {
+        const extent = this.playlist.getExtent();
+        return {
+            startFrame: extent.start,
+            endFrame: extent.end,
+            includePlugins: true,
+            includeAutomation: true,
+        };
+    }
+    /**
+     * 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, endFrame) {
+        return {
+            startFrame,
+            endFrame,
+            includePlugins: true,
+            includeAutomation: true,
+        };
+    }
+    /**
+     * 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) {
+        if (this.frozen)
+            return;
+        this.frozen = true;
+        this.frozenSourceId = sourceId;
+        this.frozenChanged.emit(true);
+    }
+    /**
+     * Unfreeze the track, restoring the original playlist and plugins.
+     * Discards the frozen source reference.
+     */
+    unfreeze() {
+        if (!this.frozen)
+            return;
+        this.frozen = false;
+        this.frozenSourceId = null;
+        this.frozenChanged.emit(false);
+    }
+    /**
+     * 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) {
+        const clamped = Math.max(0, Math.min(1, progress));
+        if (this._bounceProgress !== clamped) {
+            this._bounceProgress = clamped;
+            this.bounceProgressChanged.emit(clamped);
+        }
+    }
+    /** Current bounce progress (0 to 1). */
+    get bounceProgress() {
+        return this._bounceProgress;
+    }
+    /**
+     * 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) {
+        this._bounceProgress = 0;
+        this.bounceProgressChanged.emit(0);
+        this.bounceCompleted.emit({ sourceId });
+    }
+    // ─── Alignment Style ────────────────────────────────────────────────────
+    /** Get the current alignment style for recording. */
+    getAlignStyle() {
+        return this._alignStyle;
+    }
+    /** Set the alignment style for recording. */
+    setAlignStyle(style) {
+        if (this._alignStyle !== style) {
+            this._alignStyle = style;
+            this.alignStyleChanged.emit(style);
+        }
+    }
+    // ─── Track Mode ─────────────────────────────────────────────────────────
+    /** Get the current track mode. */
+    getTrackMode() {
+        return this._trackMode;
+    }
+    /**
+     * 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) {
+        if (this._trackMode !== mode) {
+            this._trackMode = mode;
+            this.trackModeChanged.emit(mode);
+        }
+    }
 }
 //# sourceMappingURL=Track.js.map

package/dist/domain/Track.js.map

@@ -1 +1 @@
-{"version":3,"file":"Track.js","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;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACjB,4BAAe,CAAA;IACf,0BAAa,CAAA;IACb,wBAAW,CAAA;IACX,wBAAW,CAAA;IACX,8BAAiB,CAAA;IACjB,wBAAW,CAAA;AACf,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAED,MAAM,OAAO,KAAK;IAgDd,YAAY,EAAW,EAAE,IAAY,EAAE,IAAe;QAxC/C,UAAK,GAAY,KAAK,CAAC;QACvB,YAAO,GAAY,KAAK,CAAC;QACzB,SAAI,GAAY,KAAK,CAAC;QACtB,SAAI,GAAY,KAAK,CAAC;QACtB,UAAK,GAAW,SAAS,CAAC,CAAC,sBAAsB;QAExD,oCAAoC;QAC7B,gBAAW,GAAY,KAAK,CAAC;QAC7B,aAAQ,GAAY,KAAK,CAAC;QAEjC,yBAAyB;QAClB,gBAAW,GAAgB,WAAW,CAAC,IAAI,CAAC;QAEnD,6DAA6D;QACtD,aAAQ,GAAW,CAAC,CAAC;QAE5B,0BAA0B;QACnB,YAAO,GAAW,EAAE,CAAC;QAE5B,eAAe;QACR,WAAM,GAAY,KAAK,CAAC;QACxB,mBAAc,GAAkB,IAAI,CAAC;QAE5C,oCAAoC;QAC7B,kBAAa,GAAmB,IAAI,CAAC;QACrC,YAAO,GAAkB,IAAI,CAAC;QAC9B,gBAAW,GAAY,KAAK,CAAC;QAEpC,UAAU;QACM,eAAU,GAAG,IAAI,MAAM,EAAW,CAAC;QACnC,mBAAc,GAAG,IAAI,MAAM,EAAW,CAAC;QACvC,gBAAW,GAAG,IAAI,MAAM,EAAW,CAAC;QACpC,gBAAW,GAAG,IAAI,MAAM,EAAW,CAAC;QACpC,uBAAkB,GAAG,IAAI,MAAM,EAAW,CAAC;QAC3C,oBAAe,GAAG,IAAI,MAAM,EAAW,CAAC;QACxC,uBAAkB,GAAG,IAAI,MAAM,EAAe,CAAC;QAC/C,oBAAe,GAAG,IAAI,MAAM,EAAU,CAAC;QACvC,iBAAY,GAAG,IAAI,MAAM,EAAU,CAAC;QACpC,kBAAa,GAAG,IAAI,MAAM,EAAW,CAAC;QAGlD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,uCAAuC;QACvC,8DAA8D;QAC9D,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,UAAU,EAAa,EAAE,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC;IAEM,MAAM,CAAC,OAAe;QACzB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC;QAC1B,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAC;IACjC,CAAC;IAEM,QAAQ,CAAC,KAAc;QAC1B,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;IACL,CAAC;IAEM,UAAU,CAAC,OAAgB;QAC9B,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAEM,OAAO,CAAC,IAAa;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACL,CAAC;IAEM,OAAO,CAAC,IAAa;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;IACL,CAAC;IAEM,QAAQ,CAAC,KAAa;QACzB,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,CAAC;IACL,CAAC;IAEM,SAAS,CAAC,MAAe;QAC5B,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;IAEM,cAAc,CAAC,OAAgB;QAClC,IAAI,IAAI,CAAC,WAAW,KAAK,OAAO,EAAE,CAAC;YAC/B,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;YAC3B,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;IACL,CAAC;IAEM,WAAW,CAAC,IAAa;QAC5B,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;IAEM,cAAc,CAAC,IAAiB;QACnC,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;YACxB,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;IAEM,WAAW,CAAC,EAAU;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,kCAAkC;YAC7D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;CACJ"}
+{"version":3,"file":"Track.js","sourceRoot":"","sources":["../../src/domain/Track.ts"],"names":[],"mappings":"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"}

package/dist/domain/TriggerBox.d.ts

@@ -0,0 +1,123 @@
+import { Signal } from '../lib/Signal';
+import { FrameCount, SourceId, TrackId } from './types';
+/**
+ * TriggerBox implements Ableton-style clip/slot-based playback.
+ *
+ * Ardour reference: libs/ardour/triggerbox.cc
+ *
+ * A TriggerBox contains multiple slots (triggers), each holding a clip.
+ * Only one trigger per box is active at a time. Triggers can be launched
+ * quantized to musical grid positions.
+ */
+export declare enum TriggerState {
+    STOPPED = "STOPPED",
+    WAITING_TO_START = "WAITING_TO_START",
+    RUNNING = "RUNNING",
+    WAITING_TO_STOP = "WAITING_TO_STOP",
+    WAITING_TO_RETRIGGER = "WAITING_TO_RETRIGGER"
+}
+export declare enum LaunchQuantize {
+    NONE = "NONE",// Immediate
+    BAR = "BAR",// Next bar boundary
+    BEAT = "BEAT",// Next beat boundary
+    HALF_BAR = "HALF_BAR"
+}
+export declare enum FollowAction {
+    NONE = "NONE",// Stop after playing
+    AGAIN = "AGAIN",// Loop (play again)
+    NEXT = "NEXT",// Play next slot
+    PREV = "PREV",// Play previous slot
+    RANDOM = "RANDOM",// Play random slot
+    STOP = "STOP"
+}
+export interface TriggerSlot {
+    id: string;
+    index: number;
+    name: string;
+    sourceId: SourceId | null;
+    state: TriggerState;
+    gain: number;
+    color: string;
+    launchQuantize: LaunchQuantize;
+    followAction: FollowAction;
+    followCount: number;
+    followProbability: number;
+    stretchMode: 'timestretch' | 'resample' | 'none';
+    loopStart: FrameCount;
+    loopEnd: FrameCount;
+    playCount: number;
+    playbackPosition: FrameCount;
+}
+export interface TriggerPlaybackInfo {
+    sourceId: SourceId;
+    startInSource: FrameCount;
+    blockSize: number;
+    gain: number;
+}
+export interface TriggerBoxSnapshot {
+    id: string;
+    trackId: string;
+    slots: Array<{
+        name: string;
+        sourceId: string | null;
+        gain: number;
+        color: string;
+        launchQuantize: string;
+        followAction: string;
+        followCount: number;
+        followProbability: number;
+    }>;
+}
+export declare class TriggerBox {
+    readonly id: string;
+    readonly trackId: TrackId;
+    private _slots;
+    private _activeSlotIndex;
+    private _defaultSlotCount;
+    readonly slotTriggered: Signal<{
+        index: number;
+        slot: TriggerSlot;
+    }>;
+    readonly slotStopped: Signal<{
+        index: number;
+    }>;
+    readonly activeSlotChanged: Signal<number>;
+    readonly slotStateChanged: Signal<{
+        index: number;
+        state: TriggerState;
+    }>;
+    constructor(id: string, trackId: TrackId, slotCount?: number);
+    getSlot(index: number): TriggerSlot | undefined;
+    get slots(): ReadonlyArray<TriggerSlot>;
+    get slotCount(): number;
+    get activeSlotIndex(): number;
+    loadClip(slotIndex: number, sourceId: SourceId, name?: string): void;
+    clearSlot(slotIndex: number): void;
+    launchSlot(slotIndex: number): void;
+    stopSlot(slotIndex: number): void;
+    stopAll(): void;
+    /**
+     * Called by the transport for each audio processing block.
+     * Handles state transitions (quantized launch, follow actions) and
+     * returns the playback information for the currently active clip.
+     */
+    processBlock(currentFrame: FrameCount, blockSize: number, bpm: number, beatsPerBar: number): TriggerPlaybackInfo | null;
+    /**
+     * Calculate the next quantize boundary based on the launch quantize
+     * setting of the slot that is currently transitioning.
+     */
+    getNextQuantizePoint(currentFrame: FrameCount, bpm: number, beatsPerBar: number, sampleRate: number): FrameCount;
+    private processFollowAction;
+    toJSON(): TriggerBoxSnapshot;
+    static fromJSON(data: TriggerBoxSnapshot): TriggerBox;
+    private createEmptySlot;
+    private activateSlot;
+    private deactivateSlot;
+    private setSlotState;
+    /**
+     * Find the next slot (in the given direction) that has a loaded clip.
+     * Wraps around the slot list.
+     */
+    private findNextLoadedSlot;
+}
+//# sourceMappingURL=TriggerBox.d.ts.map

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

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