@drop-ai/core 0.2.0

package/dist/domain/TrackGroup.d.ts

@@ -0,0 +1,39 @@
+import { Signal } from '../lib/Signal';
+import { TrackId } from './types';
+/**
+ * Track Group
+ * Ardour 참조: libs/ardour/route_group.cc
+ *
+ * Groups multiple tracks so they share linked controls (gain, mute, solo, etc.).
+ */
+export declare class TrackGroup {
+    readonly id: string;
+    name: string;
+    private _memberTrackIds;
+    gainLinked: boolean;
+    muteLinked: boolean;
+    soloLinked: boolean;
+    colorLinked: boolean;
+    readonly memberAdded: Signal<string>;
+    readonly memberRemoved: Signal<string>;
+    readonly changed: Signal<void>;
+    constructor(id: string, name: string);
+    addMember(trackId: TrackId): void;
+    removeMember(trackId: TrackId): void;
+    hasMember(trackId: TrackId): boolean;
+    get memberTrackIds(): ReadonlyArray<TrackId>;
+    get size(): number;
+    setLinked(property: 'gain' | 'mute' | 'solo' | 'color', linked: boolean): void;
+    toJSON(): TrackGroupSnapshot;
+    static fromJSON(data: TrackGroupSnapshot): TrackGroup;
+}
+export interface TrackGroupSnapshot {
+    id: string;
+    name: string;
+    memberTrackIds: string[];
+    gainLinked: boolean;
+    muteLinked: boolean;
+    soloLinked: boolean;
+    colorLinked: boolean;
+}
+//# sourceMappingURL=TrackGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TrackGroup.d.ts","sourceRoot":"","sources":["../../src/domain/TrackGroup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;;;;GAKG;AACH,qBAAa,UAAU;IACnB,SAAgB,EAAE,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,eAAe,CAA2B;IAG3C,UAAU,EAAE,OAAO,CAAQ;IAC3B,UAAU,EAAE,OAAO,CAAQ;IAC3B,UAAU,EAAE,OAAO,CAAQ;IAC3B,WAAW,EAAE,OAAO,CAAS;IAGpC,SAAgB,WAAW,iBAAyB;IACpD,SAAgB,aAAa,iBAAyB;IACtD,SAAgB,OAAO,eAAsB;gBAEjC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAK7B,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQjC,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQpC,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IAI3C,IAAW,cAAc,IAAI,aAAa,CAAC,OAAO,CAAC,CAElD;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAU9E,MAAM,IAAI,kBAAkB;WAYrB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,UAAU;CAW/D;AAED,MAAM,WAAW,kBAAkB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;CACxB"}

package/dist/domain/TrackGroup.js

@@ -0,0 +1,86 @@
+import { Signal } from '../lib/Signal';
+/**
+ * Track Group
+ * Ardour 참조: libs/ardour/route_group.cc
+ *
+ * Groups multiple tracks so they share linked controls (gain, mute, solo, etc.).
+ */
+export class TrackGroup {
+    constructor(id, name) {
+        this._memberTrackIds = new Set();
+        // Linked properties
+        this.gainLinked = true;
+        this.muteLinked = true;
+        this.soloLinked = true;
+        this.colorLinked = false;
+        // Signals
+        this.memberAdded = new Signal();
+        this.memberRemoved = new Signal();
+        this.changed = new Signal();
+        this.id = id;
+        this.name = name;
+    }
+    addMember(trackId) {
+        if (!this._memberTrackIds.has(trackId)) {
+            this._memberTrackIds.add(trackId);
+            this.memberAdded.emit(trackId);
+            this.changed.emit();
+        }
+    }
+    removeMember(trackId) {
+        if (this._memberTrackIds.has(trackId)) {
+            this._memberTrackIds.delete(trackId);
+            this.memberRemoved.emit(trackId);
+            this.changed.emit();
+        }
+    }
+    hasMember(trackId) {
+        return this._memberTrackIds.has(trackId);
+    }
+    get memberTrackIds() {
+        return Array.from(this._memberTrackIds);
+    }
+    get size() {
+        return this._memberTrackIds.size;
+    }
+    setLinked(property, linked) {
+        switch (property) {
+            case 'gain':
+                this.gainLinked = linked;
+                break;
+            case 'mute':
+                this.muteLinked = linked;
+                break;
+            case 'solo':
+                this.soloLinked = linked;
+                break;
+            case 'color':
+                this.colorLinked = linked;
+                break;
+        }
+        this.changed.emit();
+    }
+    toJSON() {
+        return {
+            id: this.id,
+            name: this.name,
+            memberTrackIds: Array.from(this._memberTrackIds),
+            gainLinked: this.gainLinked,
+            muteLinked: this.muteLinked,
+            soloLinked: this.soloLinked,
+            colorLinked: this.colorLinked,
+        };
+    }
+    static fromJSON(data) {
+        const group = new TrackGroup(data.id, data.name);
+        for (const trackId of data.memberTrackIds) {
+            group._memberTrackIds.add(trackId);
+        }
+        group.gainLinked = data.gainLinked;
+        group.muteLinked = data.muteLinked;
+        group.soloLinked = data.soloLinked;
+        group.colorLinked = data.colorLinked;
+        return group;
+    }
+}
+//# sourceMappingURL=TrackGroup.js.map

package/dist/domain/TrackGroup.js.map

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

package/dist/domain/TransportFSM.d.ts

@@ -0,0 +1,188 @@
+/**
+ * Transport Finite State Machine
+ *
+ * Modelled after Ardour's TransportFSM (libs/ardour/transport_fsm.cc).
+ * Manages transport motion state with proper declick handling and
+ * variable-speed playback including direction reversal.
+ *
+ * State machine overview:
+ *
+ *   STOPPED ──StartTransport──> ROLLING
+ *   ROLLING ──StopTransport───> DECLICK_TO_STOP ──DeclickDone──> STOPPED
+ *   ROLLING ──Locate──────────> DECLICK_TO_LOCATE ──DeclickDone──> WAITING_FOR_LOCATE ──LocateComplete──> ROLLING | STOPPED
+ *   ROLLING ──SetSpeed(sign change)──> DECLICK_TO_STOP ──DeclickDone──> (apply reversal) ──> ROLLING
+ *
+ * Deferred events: events that arrive during a declick phase are queued
+ * and replayed once the declick completes.
+ */
+import { Signal } from '../lib/Signal';
+import { FrameCount } from './types';
+/**
+ * The motion state of the transport.
+ */
+export declare enum MotionState {
+    /** Transport is stopped; playhead is stationary. */
+    STOPPED = "STOPPED",
+    /** Transport is rolling (playing forward or backward). */
+    ROLLING = "ROLLING",
+    /** Rolling -> Stopped transition: declick ramp-down in progress. */
+    DECLICK_TO_STOP = "DECLICK_TO_STOP",
+    /** Rolling -> Locate transition: declick ramp-down before relocating. */
+    DECLICK_TO_LOCATE = "DECLICK_TO_LOCATE",
+    /** Waiting for the locate operation to complete after declick. */
+    WAITING_FOR_LOCATE = "WAITING_FOR_LOCATE"
+}
+/**
+ * The playback direction of the transport.
+ */
+export declare enum DirectionState {
+    /** Normal forward playback. */
+    FORWARDS = "FORWARDS",
+    /** Reverse playback (negative speed). */
+    BACKWARDS = "BACKWARDS",
+    /** Transitioning between directions (during declick). */
+    REVERSING = "REVERSING"
+}
+export interface StartTransportEvent {
+    type: 'StartTransport';
+}
+export interface StopTransportEvent {
+    type: 'StopTransport';
+}
+export interface LocateEvent {
+    type: 'Locate';
+    /** Target frame to locate to. */
+    target: FrameCount;
+    /** Whether to resume rolling after the locate completes. */
+    rollAfterLocate: boolean;
+}
+export interface DeclickDoneEvent {
+    type: 'DeclickDone';
+}
+export interface SetSpeedEvent {
+    type: 'SetSpeed';
+    /** Desired playback speed. Negative values = reverse. */
+    speed: number;
+}
+export interface LocateCompleteEvent {
+    type: 'LocateComplete';
+}
+/**
+ * Union of all transport events the FSM can process.
+ */
+export type TransportEvent = StartTransportEvent | StopTransportEvent | LocateEvent | DeclickDoneEvent | SetSpeedEvent | LocateCompleteEvent;
+export declare class TransportFSM {
+    private _motionState;
+    private _directionState;
+    private _speed;
+    /**
+     * Frame to locate to when a Locate event is being processed through declick.
+     * Only valid when motionState is DECLICK_TO_LOCATE or WAITING_FOR_LOCATE.
+     */
+    private _pendingLocateTarget;
+    /**
+     * Whether the transport should resume rolling after a pending locate completes.
+     */
+    private _rollAfterLocate;
+    /**
+     * Speed to apply after a direction-reversal declick completes.
+     * Only valid when _directionState is REVERSING.
+     */
+    private _pendingSpeed;
+    /**
+     * Events that arrive during a declick phase. They are stored and
+     * replayed (in order) once the declick completes.
+     */
+    private _deferredEvents;
+    /**
+     * Emitted whenever the motion state changes.
+     * Payload is the new MotionState.
+     */
+    readonly stateChanged: Signal<MotionState>;
+    /**
+     * Emitted when the FSM determines a locate operation should be performed.
+     * The audio engine should reposition the playhead to the given frame.
+     */
+    readonly locateRequested: Signal<number>;
+    /**
+     * Emitted when the playback speed changes.
+     * Payload is the new speed value (can be negative for reverse).
+     */
+    readonly speedChanged: Signal<number>;
+    /**
+     * Emitted when the direction changes.
+     * Payload is the new DirectionState.
+     */
+    readonly directionChanged: Signal<DirectionState>;
+    /** Current motion state of the transport. */
+    get motionState(): MotionState;
+    /** Current direction state of the transport. */
+    get directionState(): DirectionState;
+    /**
+     * Current playback speed.
+     * Positive = forward, negative = reverse.
+     * Range: -8.0 to +8.0 (absolute minimum 0.0625).
+     * Default: 1.0.
+     */
+    get speed(): number;
+    /** Whether the transport is currently rolling (playing). */
+    isRolling(): boolean;
+    /** Whether the transport is fully stopped. */
+    isStopped(): boolean;
+    /** Whether the transport is in a declick transition. */
+    isDeclicking(): boolean;
+    /** Whether the transport is waiting for a locate to complete. */
+    isWaitingForLocate(): boolean;
+    /**
+     * Enqueue a transport event for processing.
+     *
+     * If the FSM is in a declick state, events are deferred and replayed
+     * after the declick completes. Otherwise, events are processed immediately.
+     */
+    enqueue(event: TransportEvent): void;
+    /**
+     * Process a single transport event based on the current state.
+     * Implements the full state transition logic.
+     */
+    processEvent(event: TransportEvent): void;
+    /**
+     * Set the playback speed.
+     *
+     * - Clamps to [-MAX_SPEED, +MAX_SPEED] range.
+     * - Absolute values below MIN_SPEED are snapped to zero (effectively stop).
+     * - If the sign changes while rolling, a declick + direction reversal is initiated.
+     *
+     * @param newSpeed The desired playback speed.
+     */
+    setSpeed(newSpeed: number): void;
+    /**
+     * Get the current playback speed.
+     */
+    getSpeed(): number;
+    private handleStartTransport;
+    private handleStopTransport;
+    private handleLocate;
+    private handleDeclickDone;
+    private handleSetSpeed;
+    private handleLocateComplete;
+    /**
+     * Transition to a new motion state and emit the stateChanged signal.
+     */
+    private setMotionState;
+    /**
+     * Apply a speed value, updating direction state and emitting signals.
+     */
+    private applySpeed;
+    /**
+     * Clamp a speed value to the valid range.
+     * Absolute values below MIN_SPEED are snapped to zero.
+     * Absolute values above MAX_SPEED are clamped.
+     */
+    private clampSpeed;
+    /**
+     * Process all deferred events that accumulated during a declick phase.
+     * Events are processed in FIFO order.
+     */
+    private processDeferredEvents;
+}
+//# sourceMappingURL=TransportFSM.d.ts.map

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

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