@drop-ai/core 0.2.0 → 0.3.0

package/dist/domain/VideoExportStatus.js

@@ -0,0 +1,192 @@
+import { Signal } from '../lib/Signal';
+import { ExportStatus, ExportProgress } from './ExportStatus';
+/**
+ * Video Export Progress Stages
+ * Extends base export progress with video-specific stages
+ */
+export var VideoExportStage;
+(function (VideoExportStage) {
+    VideoExportStage["IDLE"] = "idle";
+    VideoExportStage["RENDERING_AUDIO"] = "rendering_audio";
+    VideoExportStage["RENDERING_VIDEO"] = "rendering_video";
+    VideoExportStage["MUXING"] = "muxing";
+    VideoExportStage["COMPLETED"] = "completed";
+    VideoExportStage["FAILED"] = "failed";
+    VideoExportStage["ABORTED"] = "aborted";
+})(VideoExportStage || (VideoExportStage = {}));
+/**
+ * Video Export Status
+ * Extends ExportStatus to track multi-phase video export:
+ * - Phase 1: Audio rendering (40%)
+ * - Phase 2: Video frame rendering (40%)
+ * - Phase 3: FFmpeg muxing (20%)
+ */
+export class VideoExportStatus extends ExportStatus {
+    constructor() {
+        super();
+        // Video-specific progress tracking
+        this.totalFrames = 0; // Total video frames to render
+        this.processedFrames = 0; // Video frames processed
+        this.ffmpegProgress = 0; // FFmpeg muxing progress (0-100)
+        // Phase-specific progress
+        this.audioProgress = 0; // 0-100
+        this.videoProgress = 0; // 0-100
+        this.muxingProgress = 0; // 0-100
+        // Current stage
+        this._currentStage = VideoExportStage.IDLE;
+        // Video-specific signals
+        this.videoFrameProcessed = new Signal();
+        this.ffmpegProgressChanged = new Signal();
+        this.stageChanged = new Signal();
+    }
+    /**
+     * Get current video export stage
+     */
+    get currentStage() {
+        return this._currentStage;
+    }
+    /**
+     * Get overall progress (weighted across all phases)
+     * Audio: 40%, Video: 40%, Muxing: 20%
+     */
+    get overallProgress() {
+        return (this.audioProgress * 0.4 +
+            this.videoProgress * 0.4 +
+            this.muxingProgress * 0.2);
+    }
+    /**
+     * Initialize video export
+     */
+    initVideoExport(totalAudioFrames, totalVideoFrames, filename) {
+        // Initialize base export status
+        this.init(totalAudioFrames, filename);
+        // Initialize video-specific fields
+        this.totalFrames = totalVideoFrames;
+        this.processedFrames = 0;
+        this.ffmpegProgress = 0;
+        this.audioProgress = 0;
+        this.videoProgress = 0;
+        this.muxingProgress = 0;
+        this._currentStage = VideoExportStage.RENDERING_AUDIO;
+        this.stageChanged.emit(this._currentStage);
+    }
+    /**
+     * Update audio rendering progress
+     */
+    updateAudioProgress(processedAudioFrames, totalAudioFrames) {
+        this.processedFrames = processedAudioFrames;
+        this.audioProgress = totalAudioFrames > 0
+            ? Math.min(100, (processedAudioFrames / totalAudioFrames) * 100)
+            : 0;
+        this.frameProcessed.emit(processedAudioFrames);
+    }
+    /**
+     * Start video frame rendering phase
+     */
+    startVideoRendering() {
+        this._currentStage = VideoExportStage.RENDERING_VIDEO;
+        this.audioProgress = 100; // Audio is complete
+        this.setProgress(ExportProgress.RENDERING);
+        this.stageChanged.emit(this._currentStage);
+    }
+    /**
+     * Update video frame rendering progress
+     */
+    updateVideoFrameProgress(processedFrames) {
+        this.processedFrames = processedFrames;
+        this.videoProgress = this.totalFrames > 0
+            ? Math.min(100, (processedFrames / this.totalFrames) * 100)
+            : 0;
+        this.videoFrameProcessed.emit(processedFrames);
+    }
+    /**
+     * Start FFmpeg muxing phase
+     */
+    startMuxing() {
+        this._currentStage = VideoExportStage.MUXING;
+        this.videoProgress = 100; // Video rendering is complete
+        this.setProgress(ExportProgress.ENCODING);
+        this.stageChanged.emit(this._currentStage);
+    }
+    /**
+     * Update FFmpeg muxing progress
+     */
+    updateFFmpegProgress(progress) {
+        this.ffmpegProgress = Math.min(100, Math.max(0, progress));
+        this.muxingProgress = this.ffmpegProgress;
+        this.ffmpegProgressChanged.emit(this.ffmpegProgress);
+    }
+    /**
+     * Complete video export
+     */
+    completeVideoExport(blob, url) {
+        this._currentStage = VideoExportStage.COMPLETED;
+        this.audioProgress = 100;
+        this.videoProgress = 100;
+        this.muxingProgress = 100;
+        this.ffmpegProgress = 100;
+        this.complete(blob, url);
+        this.stageChanged.emit(this._currentStage);
+    }
+    /**
+     * Fail video export with error
+     */
+    failVideoExport(message) {
+        this._currentStage = VideoExportStage.FAILED;
+        this.setError(message);
+        this.stageChanged.emit(this._currentStage);
+    }
+    /**
+     * Abort video export
+     */
+    abortVideoExport(errorOccurred = false) {
+        this._currentStage = VideoExportStage.ABORTED;
+        this.abort(errorOccurred);
+        this.stageChanged.emit(this._currentStage);
+    }
+    /**
+     * Get stage display name
+     */
+    getStageName() {
+        switch (this._currentStage) {
+            case VideoExportStage.IDLE:
+                return 'Idle';
+            case VideoExportStage.RENDERING_AUDIO:
+                return 'Rendering Audio';
+            case VideoExportStage.RENDERING_VIDEO:
+                return 'Rendering Video Frames';
+            case VideoExportStage.MUXING:
+                return 'Muxing Audio & Video';
+            case VideoExportStage.COMPLETED:
+                return 'Completed';
+            case VideoExportStage.FAILED:
+                return 'Failed';
+            case VideoExportStage.ABORTED:
+                return 'Aborted';
+            default:
+                return 'Processing';
+        }
+    }
+    /**
+     * Get progress message for current stage
+     */
+    getProgressMessage() {
+        switch (this._currentStage) {
+            case VideoExportStage.RENDERING_AUDIO:
+                return `Rendering audio... ${Math.round(this.audioProgress)}%`;
+            case VideoExportStage.RENDERING_VIDEO:
+                return `Rendering video frames (${this.processedFrames}/${this.totalFrames})... ${Math.round(this.videoProgress)}%`;
+            case VideoExportStage.MUXING:
+                return `Encoding video with FFmpeg... ${Math.round(this.muxingProgress)}%`;
+            case VideoExportStage.COMPLETED:
+                return 'Export completed successfully';
+            case VideoExportStage.FAILED:
+                return `Export failed: ${this.errorMessage}`;
+            case VideoExportStage.ABORTED:
+                return 'Export was aborted';
+            default:
+                return 'Processing...';
+        }
+    }
+}
+//# sourceMappingURL=VideoExportStatus.js.map

package/dist/domain/VideoExportStatus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoExportStatus.js","sourceRoot":"","sources":["../../src/domain/VideoExportStatus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE9D;;;GAGG;AACH,MAAM,CAAN,IAAY,gBAQX;AARD,WAAY,gBAAgB;IACxB,iCAAa,CAAA;IACb,uDAAmC,CAAA;IACnC,uDAAmC,CAAA;IACnC,qCAAiB,CAAA;IACjB,2CAAuB,CAAA;IACvB,qCAAiB,CAAA;IACjB,uCAAmB,CAAA;AACvB,CAAC,EARW,gBAAgB,KAAhB,gBAAgB,QAQ3B;AAED;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IAmB/C;QACI,KAAK,EAAE,CAAC;QAnBZ,mCAAmC;QAC5B,gBAAW,GAAW,CAAC,CAAC,CAAO,+BAA+B;QAC9D,oBAAe,GAAW,CAAC,CAAC,CAAG,yBAAyB;QACxD,mBAAc,GAAW,CAAC,CAAC,CAAI,iCAAiC;QAEvE,0BAA0B;QAClB,kBAAa,GAAW,CAAC,CAAC,CAAK,QAAQ;QACvC,kBAAa,GAAW,CAAC,CAAC,CAAK,QAAQ;QACvC,mBAAc,GAAW,CAAC,CAAC,CAAI,QAAQ;QAE/C,gBAAgB;QACR,kBAAa,GAAqB,gBAAgB,CAAC,IAAI,CAAC;QAEhE,yBAAyB;QACT,wBAAmB,GAAG,IAAI,MAAM,EAAU,CAAC;QAC3C,0BAAqB,GAAG,IAAI,MAAM,EAAU,CAAC;QAC7C,iBAAY,GAAG,IAAI,MAAM,EAAoB,CAAC;IAI9D,CAAC;IAED;;OAEG;IACH,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,IAAW,eAAe;QACtB,OAAO,CACH,IAAI,CAAC,aAAa,GAAG,GAAG;YACxB,IAAI,CAAC,aAAa,GAAG,GAAG;YACxB,IAAI,CAAC,cAAc,GAAG,GAAG,CAC5B,CAAC;IACN,CAAC;IAED;;OAEG;IACI,eAAe,CAClB,gBAAwB,EACxB,gBAAwB,EACxB,QAAgB;QAEhB,gCAAgC;QAChC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC;QAEtC,mCAAmC;QACnC,IAAI,CAAC,WAAW,GAAG,gBAAgB,CAAC;QACpC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QAExB,IAAI,CAAC,aAAa,GAAG,gBAAgB,CAAC,eAAe,CAAC;QACtD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,mBAAmB,CAAC,oBAA4B,EAAE,gBAAwB;QAC7E,IAAI,CAAC,eAAe,GAAG,oBAAoB,CAAC;QAC5C,IAAI,CAAC,aAAa,GAAG,gBAAgB,GAAG,CAAC;YACrC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,oBAAoB,GAAG,gBAAgB,CAAC,GAAG,GAAG,CAAC;YAChE,CAAC,CAAC,CAAC,CAAC;QAER,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACI,mBAAmB;QACtB,IAAI,CAAC,aAAa,GAAG,gBAAgB,CAAC,eAAe,CAAC;QACtD,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,oBAAoB;QAC9C,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,wBAAwB,CAAC,eAAuB;QACnD,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,GAAG,CAAC;YACrC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,GAAG,CAAC;YAC3D,CAAC,CAAC,CAAC,CAAC;QAER,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACI,WAAW;QACd,IAAI,CAAC,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAC7C,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC,8BAA8B;QACxD,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,oBAAoB,CAAC,QAAgB;QACxC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAC1C,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACI,mBAAmB,CAAC,IAAU,EAAE,GAAW;QAC9C,IAAI,CAAC,aAAa,GAAG,gBAAgB,CAAC,SAAS,CAAC;QAChD,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC;QAE1B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,OAAe;QAClC,IAAI,CAAC,aAAa,GAAG,gBAAgB,CAAC,MAAM,CAAC;QAC7C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,gBAAgB,CAAC,gBAAyB,KAAK;QAClD,IAAI,CAAC,aAAa,GAAG,gBAAgB,CAAC,OAAO,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC1B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACI,YAAY;QACf,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;YACzB,KAAK,gBAAgB,CAAC,IAAI;gBACtB,OAAO,MAAM,CAAC;YAClB,KAAK,gBAAgB,CAAC,eAAe;gBACjC,OAAO,iBAAiB,CAAC;YAC7B,KAAK,gBAAgB,CAAC,eAAe;gBACjC,OAAO,wBAAwB,CAAC;YACpC,KAAK,gBAAgB,CAAC,MAAM;gBACxB,OAAO,sBAAsB,CAAC;YAClC,KAAK,gBAAgB,CAAC,SAAS;gBAC3B,OAAO,WAAW,CAAC;YACvB,KAAK,gBAAgB,CAAC,MAAM;gBACxB,OAAO,QAAQ,CAAC;YACpB,KAAK,gBAAgB,CAAC,OAAO;gBACzB,OAAO,SAAS,CAAC;YACrB;gBACI,OAAO,YAAY,CAAC;QAC5B,CAAC;IACL,CAAC;IAED;;OAEG;IACI,kBAAkB;QACrB,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;YACzB,KAAK,gBAAgB,CAAC,eAAe;gBACjC,OAAO,sBAAsB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YACnE,KAAK,gBAAgB,CAAC,eAAe;gBACjC,OAAO,2BAA2B,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,WAAW,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YACxH,KAAK,gBAAgB,CAAC,MAAM;gBACxB,OAAO,iCAAiC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC;YAC/E,KAAK,gBAAgB,CAAC,SAAS;gBAC3B,OAAO,+BAA+B,CAAC;YAC3C,KAAK,gBAAgB,CAAC,MAAM;gBACxB,OAAO,kBAAkB,IAAI,CAAC,YAAY,EAAE,CAAC;YACjD,KAAK,gBAAgB,CAAC,OAAO;gBACzB,OAAO,oBAAoB,CAAC;YAChC;gBACI,OAAO,eAAe,CAAC;QAC/B,CAAC;IACL,CAAC;CACJ"}

package/dist/domain/VideoMetadata.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Video metadata attached to audio sources that originated from video files.
+ * This allows the DAW to track video-specific information and support video export.
+ */
+export interface VideoMetadata {
+    /**
+     * Frames per second of the source video
+     */
+    readonly fps: number;
+    /**
+     * Video frame width in pixels
+     */
+    readonly width: number;
+    /**
+     * Video frame height in pixels
+     */
+    readonly height: number;
+    /**
+     * Video codec used in the source file (e.g., "h264", "vp9")
+     */
+    readonly codec: string;
+    /**
+     * Container format of the source file (e.g., "mp4", "webm", "mov")
+     */
+    readonly format: string;
+    /**
+     * Total number of frames in the source video
+     */
+    readonly frameCount: number;
+    /**
+     * Whether the source video file contained audio
+     * (audio will have been extracted to the Source's AudioBuffer)
+     */
+    readonly hasAudio: boolean;
+    /**
+     * Optional data URL for a thumbnail image of the video
+     * Used for timeline preview
+     */
+    readonly thumbnailUrl?: string;
+    /**
+     * Original video file URL (blob URL or file path)
+     * Used for video export and frame extraction
+     */
+    readonly originalVideoUrl: string;
+}
+//# sourceMappingURL=VideoMetadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VideoMetadata.d.ts","sourceRoot":"","sources":["../../src/domain/VideoMetadata.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC"}

package/dist/domain/VideoMetadata.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=VideoMetadata.js.map

package/dist/domain/VideoMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoMetadata.js","sourceRoot":"","sources":["../../src/domain/VideoMetadata.ts"],"names":[],"mappings":""}

package/dist/domain/index.d.ts

@@ -3,9 +3,14 @@ export * from './Track';
 export * from './Region';
 export * from './Route';
 export * from './Source';
+export * from './Crossfade';
+export * from './VideoMetadata';
 export * from './Range';
 export * from './GridSettings';
 export * from './ExportConfig';
+export * from './VideoExportConfig';
 export * from './ExportStatus';
+export * from './VideoExportStatus';
+export * from './ThawList';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/dist/domain/index.js

@@ -4,9 +4,14 @@ export * from './Track';
 export * from './Region';
 export * from './Route';
 export * from './Source';
+export * from './Crossfade';
+export * from './VideoMetadata';
 export * from './Range';
 export * from './GridSettings';
 export * from './ExportConfig';
+export * from './VideoExportConfig';
 export * from './ExportStatus';
+export * from './VideoExportStatus';
+export * from './ThawList';
 export * from './types';
 //# sourceMappingURL=index.js.map

package/dist/domain/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/domain/index.ts"],"names":[],"mappings":"AAAA,iBAAiB;AACjB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/dist/domain/temporal/TempoMap.d.ts

@@ -14,14 +14,69 @@ export interface TempoEvent {
     /** Time signature denominator (optional, inherits previous if unset) */
     timeSigDen?: number;
 }
+/**
+ * A meter (time signature) change event, stored independently from tempo events.
+ * Inspired by Ardour's temporal::MeterPoint.
+ */
+export interface MeterEvent {
+    /** Position in frames */
+    frame: number;
+    /** Number of beats per bar (time signature numerator) */
+    beatsPerBar: number;
+    /** Beat value that gets one beat (time signature denominator, e.g. 4 = quarter note) */
+    beatValue: number;
+}
+/**
+ * Bar/Beat/Tick representation of a musical position.
+ * Tick resolution is 1920 ticks per beat (matching Ardour).
+ */
+export interface BBT {
+    /** Bar number (1-based) */
+    bar: number;
+    /** Beat within bar (1-based) */
+    beat: number;
+    /** Tick within beat (0-based, 0..1919) */
+    tick: number;
+}
+/**
+ * Subdivision types for grid calculations.
+ */
+export type SubdivisionType = 'bar' | 'beat' | 'half' | 'quarter' | 'eighth' | 'sixteenth' | 'triplet' | 'dotted';
+/**
+ * Combined tempo and meter information at a point in time.
+ */
+export interface TempoAndMeter {
+    bpm: number;
+    beatsPerBar: number;
+    beatValue: number;
+}
 /**
  * TempoMap handles conversion between AudioTime (samples/frames) and BeatTime (beats/ticks).
- * Supports multiple tempo changes over the timeline (Ardour-style tempo map).
+ * Supports multiple tempo and meter changes over the timeline (Ardour-style tempo map).
+ *
+ * Features:
+ * - Dual domain support (AudioTime / BeatTime)
+ * - Independent tempo and meter event lists
+ * - Bar/Beat/Tick (BBT) conversions with 1920 ticks-per-beat resolution
+ * - Grid point generation with subdivision and swing support
+ * - Region repositioning on tempo change
+ * - Binary search for efficient segment lookup
  */
 export declare class TempoMap {
     private sampleRate;
     private events;
+    private _meterEvents;
+    /** Fires after any modification to the tempo map (add/remove tempo or meter changes). */
     readonly changed: Signal<void>;
+    /**
+     * Fires after a tempo value has been modified, providing the frame at which the change occurred.
+     * Useful for repositioning regions or cursors after a tempo edit.
+     */
+    readonly onTempoChanged: Signal<{
+        frame: number;
+        oldBpm: number;
+        newBpm: number;
+    }>;
     constructor(sampleRate?: number);
     /**
      * Add or update a tempo change at the given frame position.
@@ -35,18 +90,55 @@ export declare class TempoMap {
     removeTempoChange(frame: number): void;
     /**
      * Get the tempo (BPM) at a given frame position.
-     * Returns the BPM of the most recent tempo event at or before the frame.
+     * Uses binary search for efficient lookup.
      */
     getTempoAtFrame(frame: number): number;
     /**
      * Get the time signature at a given frame position.
      * Returns [numerator, denominator].
+     * Walks through tempo events that carry time signature overrides.
      */
     getTimeSignatureAtFrame(frame: number): [number, number];
     /**
      * Get all tempo events, sorted by frame.
      */
     getAllEvents(): ReadonlyArray<TempoEvent>;
+    /**
+     * Add or update a meter (time signature) change at the given frame position.
+     * If a meter change already exists at the exact frame, it is updated.
+     *
+     * @param frame - Frame position of the meter change
+     * @param beatsPerBar - Number of beats per bar (time signature numerator)
+     * @param beatValue - Note value that gets one beat (time signature denominator, e.g. 4 = quarter)
+     */
+    addMeterChange(frame: number, beatsPerBar: number, beatValue: number): void;
+    /**
+     * Remove a meter change at the given frame.
+     * The initial meter event at frame 0 cannot be removed.
+     *
+     * @param frame - Frame position of the meter change to remove
+     */
+    removeMeterChange(frame: number): void;
+    /**
+     * Get the meter (time signature) at a given frame position.
+     * Uses binary search for efficient lookup.
+     *
+     * @param frame - Frame position to query
+     * @returns The active MeterEvent at the given frame
+     */
+    getMeterAt(frame: number): MeterEvent;
+    /**
+     * Get all meter events, sorted by frame.
+     */
+    getAllMeterEvents(): ReadonlyArray<MeterEvent>;
+    /**
+     * Get combined tempo and meter information at a given frame position.
+     * Convenience method that returns both BPM and time signature data.
+     *
+     * @param frame - Frame position to query
+     * @returns Combined tempo and meter data
+     */
+    getTempoAndMeterAt(frame: number): TempoAndMeter;
     /**
      * Convert frames to seconds, accounting for tempo changes across the timeline.
      * Integrates the duration of each tempo segment.
@@ -56,6 +148,111 @@ export declare class TempoMap {
      * Convert seconds to frames, accounting for tempo changes across the timeline.
      */
     secondsToFrames(seconds: number, sampleRate?: number): FrameCount;
+    /**
+     * Convert a frame position to an absolute beat count from the start of the timeline,
+     * accounting for ALL tempo changes along the way.
+     *
+     * For each tempo segment, the number of beats is calculated as:
+     *   beats = (segmentFrames / sampleRate) * (bpm / 60)
+     *
+     * @param frame - Frame position to convert
+     * @param sampleRate - Sample rate override (defaults to constructor value)
+     * @returns Absolute beat count from frame 0
+     */
+    framesToBeatsAbsolute(frame: number, sampleRate?: number): number;
+    /**
+     * Convert an absolute beat count from the start of the timeline to a frame position,
+     * accounting for ALL tempo changes along the way.
+     *
+     * Inverse of `framesToBeatsAbsolute`.
+     *
+     * @param beats - Absolute beat count from the start
+     * @param sampleRate - Sample rate override (defaults to constructor value)
+     * @returns Frame position
+     */
+    beatsToFramesAbsolute(beats: number, sampleRate?: number): number;
+    /**
+     * Convert a frame position to Bar/Beat/Tick notation.
+     *
+     * Walks through tempo and meter segments to calculate the cumulative
+     * bar, beat, and tick position. Uses 1920 ticks per beat (matching Ardour).
+     *
+     * @param frame - Frame position to convert
+     * @param sampleRate - Sample rate override (defaults to constructor value)
+     * @returns BBT position (bars and beats are 1-based, ticks are 0-based)
+     */
+    framesToBBT(frame: number, sampleRate?: number): BBT;
+    /**
+     * Convert Bar/Beat/Tick notation to a frame position.
+     *
+     * @param bar - Bar number (1-based)
+     * @param beat - Beat within bar (1-based)
+     * @param tick - Tick within beat (0-based, 0..1919)
+     * @param sampleRate - Sample rate override (defaults to constructor value)
+     * @returns Frame position
+     */
+    bbtToFrames(bar: number, beat: number, tick: number, sampleRate?: number): number;
+    /**
+     * Compute the absolute beat position at which each meter event begins.
+     * This integrates tempo across the timeline to find beat offsets for each meter point.
+     */
+    private _computeMeterBeatStarts;
+    /**
+     * Returns the number of quarter-note beats per subdivision unit.
+     * For example, 'eighth' = 0.5 beats, 'bar' depends on current meter.
+     */
+    private _subdivisionToBeats;
+    /**
+     * Generate grid points between two frame positions for a given subdivision type.
+     *
+     * Walks through tempo and meter segments, generating evenly spaced grid points
+     * according to the active tempo and subdivision at each point.
+     *
+     * @param startFrame - Start of the range (inclusive)
+     * @param endFrame - End of the range (inclusive)
+     * @param subdivisionType - Grid subdivision type
+     * @param sampleRate - Sample rate override (defaults to constructor value)
+     * @returns Array of frame positions for grid points within the range
+     */
+    getGridPoints(startFrame: number, endFrame: number, subdivisionType: SubdivisionType, sampleRate?: number): number[];
+    /**
+     * Snap a frame position to the nearest grid point for the given subdivision type.
+     *
+     * @param frame - Frame position to snap
+     * @param subdivisionType - Grid subdivision type
+     * @param sampleRate - Sample rate override (defaults to constructor value)
+     * @returns The nearest grid-aligned frame position
+     */
+    snapToGrid(frame: number, subdivisionType: SubdivisionType, sampleRate?: number): number;
+    /**
+     * Generate a swing grid between two frame positions.
+     *
+     * Swing offsets every other grid point by shifting it forward in time.
+     * A `swingAmount` of 0 produces a straight grid; 1 pushes the off-beat
+     * to the maximum position (the next grid point).
+     *
+     * @param startFrame - Start of the range (inclusive)
+     * @param endFrame - End of the range (inclusive)
+     * @param subdivision - Grid subdivision type
+     * @param swingAmount - Swing amount between 0 (straight) and 1 (max swing)
+     * @param sampleRate - Sample rate override (defaults to constructor value)
+     * @returns Array of frame positions for the swing-adjusted grid
+     */
+    getSwingGrid(startFrame: number, endFrame: number, subdivision: SubdivisionType, swingAmount: number, sampleRate?: number): number[];
+    /**
+     * Recalculate a frame position after a tempo change, preserving its musical position.
+     *
+     * When tempo changes from `oldTempo` to `newTempo`, a region that was at a certain
+     * beat position should move to maintain the same musical position. This method
+     * calculates the new frame position.
+     *
+     * @param frame - Original frame position
+     * @param oldTempo - Previous tempo in BPM
+     * @param newTempo - New tempo in BPM
+     * @param sampleRate - Sample rate override (defaults to constructor value)
+     * @returns Recalculated frame position
+     */
+    repositionFrameForTempoChange(frame: number, oldTempo: number, newTempo: number, sampleRate?: number): number;
     /** Convert beats to frames at given BPM */
     beatsToFrames(beats: Beats, bpm: number): FrameCount;
     /** Convert frames to beats at given BPM */

package/dist/domain/temporal/TempoMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TempoMap.d.ts","sourceRoot":"","sources":["../../../src/domain/temporal/TempoMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAc,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,QAAQ;IAKb,OAAO,CAAC,UAAU;IAJtB,OAAO,CAAC,MAAM,CAAoB;IAClC,SAAgB,OAAO,eAAsB;gBAGjC,UAAU,GAAE,MAAc;IAMtC;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI;IAe1F;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAStC;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAYtC;;;OAGG;IACH,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAcxD;;OAEG;IACH,YAAY,IAAI,aAAa,CAAC,UAAU,CAAC;IAIzC;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM;IAuBhE;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU;IAOjE,2CAA2C;IAC3C,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU;IAKpD,2CAA2C;IAC3C,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK;IAMrD,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU;IAQpD,oCAAoC;IACpC,OAAO,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK;CAOjD"}
+{"version":3,"file":"TempoMap.d.ts","sourceRoot":"","sources":["../../../src/domain/temporal/TempoMap.ts"],"names":[],"mappings":"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"}