@meframe/core 0.2.4 → 0.2.6

package/dist/stages/compose/OfflineAudioMixer.js

@@ -1,4 +1,5 @@
-import { hasAudioConfig } from "../../model/types.js";
+import { hasResourceId, hasAudioConfig } from "../../model/types.js";
+import { buildLoopedResourceSegments } from "../../utils/loop-utils.js";
 class OfflineAudioMixer {
   constructor(cacheManager, getModel) {
     this.cacheManager = cacheManager;
@@ -13,6 +14,14 @@ class OfflineAudioMixer {
       Math.ceil(Math.max(0, durationUs) / 1e6 * this.sampleRate)
     );
     const ctx = new OfflineAudioContext(this.numberOfChannels, frameCount, this.sampleRate);
+    const silent = ctx.createBuffer(1, frameCount, this.sampleRate);
+    const silentSource = ctx.createBufferSource();
+    silentSource.buffer = silent;
+    const silentGain = ctx.createGain();
+    silentGain.gain.value = 0;
+    silentSource.connect(silentGain);
+    silentGain.connect(ctx.destination);
+    silentSource.start(0);
     const clips = this.getClipsInWindow(windowStartUs, windowEndUs);
     for (const clip of clips) {
       const clipIntersectStartUs = Math.max(windowStartUs, clip.startUs);
@@ -21,36 +30,54 @@ class OfflineAudioMixer {
       const clipRelativeEndUs = clipIntersectEndUs - clip.startUs;
       const clipModel = this.getModel()?.findClip(clip.clipId);
       const trimStartUs = clipModel?.trimStartUs ?? 0;
-      const resourceStartUs = clipRelativeStartUs + trimStartUs;
-      const resourceEndUs = clipRelativeEndUs + trimStartUs;
-      const pcmData = this.cacheManager.getClipPCMWithMetadata(
-        clip.clipId,
-        resourceStartUs,
-        resourceEndUs
-      );
-      if (!pcmData || pcmData.planes.length === 0) {
-        continue;
+      const loop = clipModel?.trackKind === "audio" && clipModel.loop === true;
+      const resourceDurationUs = clipModel && hasResourceId(clipModel) ? this.cacheManager.audioSampleCache.get(clipModel.resourceId)?.durationUs ?? 0 : 0;
+      let segments = buildLoopedResourceSegments({
+        clipRelativeStartUs,
+        clipRelativeEndUs,
+        trimStartUs,
+        resourceDurationUs,
+        loop
+      });
+      if (segments.length === 0 && clipRelativeEndUs > clipRelativeStartUs) {
+        segments = buildLoopedResourceSegments({
+          clipRelativeStartUs,
+          clipRelativeEndUs,
+          trimStartUs,
+          resourceDurationUs,
+          loop: false
+        });
       }
-      const intersectFrames = pcmData.planes[0]?.length ?? 0;
-      if (intersectFrames === 0) {
-        continue;
-      }
-      const buffer = ctx.createBuffer(pcmData.planes.length, intersectFrames, pcmData.sampleRate);
-      for (let channel = 0; channel < pcmData.planes.length; channel++) {
-        const plane = pcmData.planes[channel];
-        if (plane) {
-          buffer.copyToChannel(new Float32Array(plane), channel);
+      for (const seg of segments) {
+        const pcmData = this.cacheManager.getClipPCMWithMetadata(
+          clip.clipId,
+          seg.resourceStartUs,
+          seg.resourceEndUs
+        );
+        if (!pcmData || pcmData.planes.length === 0) {
+          continue;
+        }
+        const intersectFrames = pcmData.planes[0]?.length ?? 0;
+        if (intersectFrames === 0) {
+          continue;
+        }
+        const buffer = ctx.createBuffer(pcmData.planes.length, intersectFrames, pcmData.sampleRate);
+        for (let channel = 0; channel < pcmData.planes.length; channel++) {
+          const plane = pcmData.planes[channel];
+          if (plane) {
+            buffer.copyToChannel(new Float32Array(plane), channel);
+          }
         }
+        const source = ctx.createBufferSource();
+        source.buffer = buffer;
+        const gainNode = ctx.createGain();
+        gainNode.gain.value = clip.volume;
+        source.connect(gainNode);
+        gainNode.connect(ctx.destination);
+        const segmentStartUs = clip.startUs + seg.clipRelativeStartUs;
+        const startTime = (segmentStartUs - windowStartUs) / 1e6;
+        source.start(startTime);
       }
-      const source = ctx.createBufferSource();
-      source.buffer = buffer;
-      const gainNode = ctx.createGain();
-      gainNode.gain.value = clip.volume;
-      source.connect(gainNode);
-      gainNode.connect(ctx.destination);
-      const relativeStartUs = clipIntersectStartUs - windowStartUs;
-      const startTime = relativeStartUs / 1e6;
-      source.start(startTime);
     }
     const mixedBuffer = await ctx.startRendering();
     return mixedBuffer;

package/dist/stages/compose/OfflineAudioMixer.js.map

@@ -1 +1 @@
-{"version":3,"file":"OfflineAudioMixer.js","sources":["../../../src/stages/compose/OfflineAudioMixer.ts"],"sourcesContent":["import type { TimeUs } from '../../model/types';\nimport { hasAudioConfig } from '../../model/types';\nimport type { CompositionModel } from '../../model';\nimport type { CacheManager } from '../../cache/CacheManager';\n\ninterface MixClipInfo {\n  clipId: string;\n  startUs: TimeUs;\n  durationUs: TimeUs;\n  volume: number;\n}\n\nexport class OfflineAudioMixer {\n  private sampleRate = 48_000;\n  private numberOfChannels = 2;\n\n  constructor(\n    private cacheManager: CacheManager,\n    private getModel: () => CompositionModel | null\n  ) {}\n\n  async mix(windowStartUs: TimeUs, windowEndUs: TimeUs): Promise<AudioBuffer> {\n    const durationUs = windowEndUs - windowStartUs;\n    // Guard against invalid/empty ranges (can happen near timeline end or after clamping).\n    // OfflineAudioContext requires length >= 1.\n    const frameCount = Math.max(\n      1,\n      Math.ceil((Math.max(0, durationUs) / 1_000_000) * this.sampleRate)\n    );\n\n    const ctx = new OfflineAudioContext(this.numberOfChannels, frameCount, this.sampleRate);\n\n    const clips = this.getClipsInWindow(windowStartUs, windowEndUs);\n\n    for (const clip of clips) {\n      // Calculate clip-relative time range\n      const clipIntersectStartUs = Math.max(windowStartUs, clip.startUs);\n      const clipIntersectEndUs = Math.min(windowEndUs, clip.startUs + clip.durationUs);\n      const clipRelativeStartUs = clipIntersectStartUs - clip.startUs;\n      const clipRelativeEndUs = clipIntersectEndUs - clip.startUs;\n\n      // Convert to resource time (aligned with video architecture)\n      const clipModel = this.getModel()?.findClip(clip.clipId);\n      const trimStartUs = clipModel?.trimStartUs ?? 0;\n      const resourceStartUs = clipRelativeStartUs + trimStartUs;\n      const resourceEndUs = clipRelativeEndUs + trimStartUs;\n\n      // Get PCM data using resource time coordinates\n      const pcmData = this.cacheManager.getClipPCMWithMetadata(\n        clip.clipId,\n        resourceStartUs,\n        resourceEndUs\n      );\n\n      if (!pcmData || pcmData.planes.length === 0) {\n        // console.warn(\n        //   `[OfflineAudioMixer] No PCM data for clip ${clip.clipId} at ${(clipRelativeStartUs / 1000).toFixed(1)}-${(clipRelativeEndUs / 1000).toFixed(1)}ms`\n        // );\n        continue;\n      }\n\n      const intersectFrames = pcmData.planes[0]?.length ?? 0;\n      if (intersectFrames === 0) {\n        // console.warn(\n        //   `[OfflineAudioMixer] Empty PCM data for clip ${clip.clipId} at ${(clipRelativeStartUs / 1000).toFixed(1)}-${(clipRelativeEndUs / 1000).toFixed(1)}ms`\n        // );\n        continue;\n      }\n\n      // Create AudioBuffer\n      const buffer = ctx.createBuffer(pcmData.planes.length, intersectFrames, pcmData.sampleRate);\n\n      for (let channel = 0; channel < pcmData.planes.length; channel++) {\n        const plane = pcmData.planes[channel];\n        if (plane) {\n          // Create new Float32Array to ensure correct type (ArrayBuffer, not SharedArrayBuffer)\n          buffer.copyToChannel(new Float32Array(plane), channel);\n        }\n      }\n\n      const source = ctx.createBufferSource();\n      source.buffer = buffer;\n\n      const gainNode = ctx.createGain();\n      gainNode.gain.value = clip.volume;\n\n      source.connect(gainNode);\n      gainNode.connect(ctx.destination);\n\n      const relativeStartUs = clipIntersectStartUs - windowStartUs;\n      const startTime = relativeStartUs / 1_000_000;\n      source.start(startTime);\n    }\n\n    const mixedBuffer = await ctx.startRendering();\n    return mixedBuffer;\n  }\n\n  private getClipsInWindow(windowStartUs: TimeUs, windowEndUs: TimeUs): MixClipInfo[] {\n    const clips: MixClipInfo[] = [];\n    const model = this.getModel();\n    if (!model) {\n      return clips;\n    }\n\n    for (const track of model.tracks) {\n      for (const clip of track.clips) {\n        const clipEndUs = clip.startUs + clip.durationUs;\n        if (clip.startUs < windowEndUs && clipEndUs > windowStartUs) {\n          // Read audio config (only video/audio clips have audioConfig)\n          if (hasAudioConfig(clip)) {\n            const muted = clip.audioConfig?.muted ?? false;\n\n            // Skip muted clips in export (performance optimization)\n            if (muted) {\n              continue;\n            }\n\n            const volume = clip.audioConfig?.volume ?? 1.0;\n\n            clips.push({\n              clipId: clip.id,\n              startUs: clip.startUs,\n              durationUs: clip.durationUs,\n              volume,\n            });\n          } else {\n            // Caption/Fx clips in audio track should not happen, but handle gracefully\n            clips.push({\n              clipId: clip.id,\n              startUs: clip.startUs,\n              durationUs: clip.durationUs,\n              volume: 1.0,\n            });\n          }\n        }\n      }\n    }\n\n    return clips;\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"OfflineAudioMixer.js","sources":["../../../src/stages/compose/OfflineAudioMixer.ts"],"sourcesContent":["import type { TimeUs } from '../../model/types';\nimport { hasAudioConfig, hasResourceId } from '../../model/types';\nimport type { CompositionModel } from '../../model';\nimport type { CacheManager } from '../../cache/CacheManager';\nimport { buildLoopedResourceSegments } from '../../utils/loop-utils';\n\ninterface MixClipInfo {\n  clipId: string;\n  startUs: TimeUs;\n  durationUs: TimeUs;\n  volume: number;\n}\n\nexport class OfflineAudioMixer {\n  private sampleRate = 48_000;\n  private numberOfChannels = 2;\n\n  constructor(\n    private cacheManager: CacheManager,\n    private getModel: () => CompositionModel | null\n  ) {}\n\n  async mix(windowStartUs: TimeUs, windowEndUs: TimeUs): Promise<AudioBuffer> {\n    const durationUs = windowEndUs - windowStartUs;\n    // Guard against invalid/empty ranges (can happen near timeline end or after clamping).\n    // OfflineAudioContext requires length >= 1.\n    const frameCount = Math.max(\n      1,\n      Math.ceil((Math.max(0, durationUs) / 1_000_000) * this.sampleRate)\n    );\n\n    const ctx = new OfflineAudioContext(this.numberOfChannels, frameCount, this.sampleRate);\n\n    // Ensure the OfflineAudioContext renders the full requested length.\n    // Some implementations may stop early if no sources are scheduled near the tail,\n    // which would truncate trailing silence and make export audio shorter than video.\n    const silent = ctx.createBuffer(1, frameCount, this.sampleRate);\n    const silentSource = ctx.createBufferSource();\n    silentSource.buffer = silent;\n    const silentGain = ctx.createGain();\n    silentGain.gain.value = 0;\n    silentSource.connect(silentGain);\n    silentGain.connect(ctx.destination);\n    silentSource.start(0);\n\n    const clips = this.getClipsInWindow(windowStartUs, windowEndUs);\n\n    for (const clip of clips) {\n      // Calculate clip-relative time range\n      const clipIntersectStartUs = Math.max(windowStartUs, clip.startUs);\n      const clipIntersectEndUs = Math.min(windowEndUs, clip.startUs + clip.durationUs);\n      const clipRelativeStartUs = clipIntersectStartUs - clip.startUs;\n      const clipRelativeEndUs = clipIntersectEndUs - clip.startUs;\n\n      // Convert to resource time (aligned with video architecture)\n      const clipModel = this.getModel()?.findClip(clip.clipId);\n      const trimStartUs = clipModel?.trimStartUs ?? 0;\n      const loop = clipModel?.trackKind === 'audio' && clipModel.loop === true;\n      const resourceDurationUs =\n        clipModel && hasResourceId(clipModel)\n          ? (this.cacheManager.audioSampleCache.get(clipModel.resourceId)?.durationUs ?? 0)\n          : 0;\n\n      let segments = buildLoopedResourceSegments({\n        clipRelativeStartUs,\n        clipRelativeEndUs,\n        trimStartUs,\n        resourceDurationUs,\n        loop,\n      });\n      if (segments.length === 0 && clipRelativeEndUs > clipRelativeStartUs) {\n        segments = buildLoopedResourceSegments({\n          clipRelativeStartUs,\n          clipRelativeEndUs,\n          trimStartUs,\n          resourceDurationUs,\n          loop: false,\n        });\n      }\n\n      for (const seg of segments) {\n        // Get PCM data using resource time coordinates\n        const pcmData = this.cacheManager.getClipPCMWithMetadata(\n          clip.clipId,\n          seg.resourceStartUs,\n          seg.resourceEndUs\n        );\n\n        if (!pcmData || pcmData.planes.length === 0) {\n          continue;\n        }\n\n        const intersectFrames = pcmData.planes[0]?.length ?? 0;\n        if (intersectFrames === 0) {\n          continue;\n        }\n\n        // Create AudioBuffer\n        const buffer = ctx.createBuffer(pcmData.planes.length, intersectFrames, pcmData.sampleRate);\n\n        for (let channel = 0; channel < pcmData.planes.length; channel++) {\n          const plane = pcmData.planes[channel];\n          if (plane) {\n            // Create new Float32Array to ensure correct type (ArrayBuffer, not SharedArrayBuffer)\n            buffer.copyToChannel(new Float32Array(plane), channel);\n          }\n        }\n\n        const source = ctx.createBufferSource();\n        source.buffer = buffer;\n\n        const gainNode = ctx.createGain();\n        gainNode.gain.value = clip.volume;\n\n        source.connect(gainNode);\n        gainNode.connect(ctx.destination);\n\n        const segmentStartUs = clip.startUs + seg.clipRelativeStartUs;\n        const startTime = (segmentStartUs - windowStartUs) / 1_000_000;\n        source.start(startTime);\n      }\n    }\n\n    const mixedBuffer = await ctx.startRendering();\n    return mixedBuffer;\n  }\n\n  private getClipsInWindow(windowStartUs: TimeUs, windowEndUs: TimeUs): MixClipInfo[] {\n    const clips: MixClipInfo[] = [];\n    const model = this.getModel();\n    if (!model) {\n      return clips;\n    }\n\n    for (const track of model.tracks) {\n      for (const clip of track.clips) {\n        const clipEndUs = clip.startUs + clip.durationUs;\n        if (clip.startUs < windowEndUs && clipEndUs > windowStartUs) {\n          // Read audio config (only video/audio clips have audioConfig)\n          if (hasAudioConfig(clip)) {\n            const muted = clip.audioConfig?.muted ?? false;\n\n            // Skip muted clips in export (performance optimization)\n            if (muted) {\n              continue;\n            }\n\n            const volume = clip.audioConfig?.volume ?? 1.0;\n\n            clips.push({\n              clipId: clip.id,\n              startUs: clip.startUs,\n              durationUs: clip.durationUs,\n              volume,\n            });\n          } else {\n            // Caption/Fx clips in audio track should not happen, but handle gracefully\n            clips.push({\n              clipId: clip.id,\n              startUs: clip.startUs,\n              durationUs: clip.durationUs,\n              volume: 1.0,\n            });\n          }\n        }\n      }\n    }\n\n    return clips;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/stages/mux/MP4Muxer.d.ts

@@ -1,3 +1,11 @@
+export type MuxOutputConfig = {
+    kind: 'blob';
+} | {
+    kind: 'stream';
+    onData: (data: Uint8Array, position: number) => void;
+    chunked?: boolean;
+    chunkSize?: number;
+};
 /**
  * MP4Muxer - MP4 container multiplexer using mp4-muxer library
  * Supports video and audio track export
@@ -8,6 +16,7 @@ export declare class MP4Muxer {
     private firstAudioChunk;
     private videoChunkMeta;
     private audioChunkMeta;
+    private lastAudioDurationUs;
     constructor(config: {
         width: number;
         height: number;
@@ -15,11 +24,11 @@ export declare class MP4Muxer {
         fastStart?: false | 'in-memory' | 'fragmented';
         videoChunkMeta?: any;
         audioChunkMeta?: any;
-    });
+    }, output?: MuxOutputConfig);
     private videoChunkCount;
     writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata): void;
     private audioChunkCount;
     writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata): void;
-    finalize(): Blob;
+    finalize(): Blob | null;
 }
 //# sourceMappingURL=MP4Muxer.d.ts.map

package/dist/stages/mux/MP4Muxer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MP4Muxer.d.ts","sourceRoot":"","sources":["../../../src/stages/mux/MP4Muxer.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAa;gBAEvB,MAAM,EAAE;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,YAAY,CAAC;QAC/C,cAAc,CAAC,EAAE,GAAG,CAAC;QACrB,cAAc,CAAC,EAAE,GAAG,CAAC;KACtB;IA2CD,OAAO,CAAC,eAAe,CAAK;IAE5B,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB,GAAG,IAAI;IAwBrF,OAAO,CAAC,eAAe,CAAK;IAE5B,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB,GAAG,IAAI;IA0BrF,QAAQ,IAAI,IAAI;CAKjB"}
+{"version":3,"file":"MP4Muxer.d.ts","sourceRoot":"","sources":["../../../src/stages/mux/MP4Muxer.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEN;;;GAGG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,mBAAmB,CAAuB;gBAGhD,MAAM,EAAE;QACN,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,YAAY,CAAC;QAC/C,cAAc,CAAC,EAAE,GAAG,CAAC;QACrB,cAAc,CAAC,EAAE,GAAG,CAAC;KACtB,EACD,MAAM,GAAE,eAAkC;IAqD5C,OAAO,CAAC,eAAe,CAAK;IAE5B,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB,GAAG,IAAI;IAwBrF,OAAO,CAAC,eAAe,CAAK;IAE5B,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB,GAAG,IAAI;IAmDrF,QAAQ,IAAI,IAAI,GAAG,IAAI;CASxB"}

package/dist/stages/mux/MP4Muxer.js

@@ -1,15 +1,22 @@
-import { ArrayBufferTarget, Muxer } from "../../medeo-fe/node_modules/.pnpm/mp4-muxer@5.2.2/node_modules/mp4-muxer/build/mp4-muxer.js";
+import { StreamTarget, ArrayBufferTarget, Muxer } from "../../medeo-fe/node_modules/.pnpm/mp4-muxer@5.2.2/node_modules/mp4-muxer/build/mp4-muxer.js";
 class MP4Muxer {
   muxer;
   firstVideoChunk = true;
   firstAudioChunk = true;
   videoChunkMeta = null;
   audioChunkMeta = null;
-  constructor(config) {
+  lastAudioDurationUs = null;
+  constructor(config, output = { kind: "blob" }) {
     this.videoChunkMeta = config.videoChunkMeta;
     this.audioChunkMeta = config.audioChunkMeta;
+    const target = output.kind === "stream" ? new StreamTarget({
+      onData: output.onData,
+      chunked: output.chunked ?? true,
+      chunkSize: output.chunkSize ?? 16 * 1024 * 1024
+      // 16 MiB default to reduce writes
+    }) : new ArrayBufferTarget();
     const muxerConfig = {
-      target: new ArrayBufferTarget(),
+      target,
       video: {
         codec: "avc",
         width: config.width,
@@ -46,7 +53,7 @@ class MP4Muxer {
   }
   audioChunkCount = 0;
   writeAudioChunk(chunk, metadata) {
-    if (chunk.byteLength <= 16) {
+    if (chunk.byteLength <= 16 && (!chunk.duration || chunk.duration <= 0)) {
       return;
     }
     let meta;
@@ -59,13 +66,32 @@ class MP4Muxer {
       }
       this.firstAudioChunk = false;
     }
+    const hasValidDuration = !!chunk.duration && chunk.duration > 0;
+    if (!hasValidDuration) {
+      const sampleRate = metadata?.decoderConfig?.sampleRate ?? this.audioChunkMeta?.sampleRate ?? 48e3;
+      const inferredDurationUs = this.lastAudioDurationUs ?? Math.max(1, Math.round(1024 / sampleRate * 1e6));
+      const buffer = new ArrayBuffer(chunk.byteLength);
+      chunk.copyTo(buffer);
+      chunk = new EncodedAudioChunk({
+        type: chunk.type,
+        timestamp: chunk.timestamp,
+        duration: inferredDurationUs,
+        data: buffer
+      });
+      this.lastAudioDurationUs = inferredDurationUs;
+    } else {
+      this.lastAudioDurationUs = chunk.duration;
+    }
     this.audioChunkCount++;
     this.muxer.addAudioChunk(chunk, meta);
   }
   finalize() {
     this.muxer.finalize();
-    const buffer = this.muxer.target.buffer;
-    return new Blob([buffer], { type: "video/mp4" });
+    if (this.muxer.target instanceof ArrayBufferTarget) {
+      const buffer = this.muxer.target.buffer;
+      return new Blob([buffer], { type: "video/mp4" });
+    }
+    return null;
   }
 }
 export {

package/dist/stages/mux/MP4Muxer.js.map

@@ -1 +1 @@
-{"version":3,"file":"MP4Muxer.js","sources":["../../../src/stages/mux/MP4Muxer.ts"],"sourcesContent":["import { Muxer, ArrayBufferTarget } from 'mp4-muxer';\n\n/**\n * MP4Muxer - MP4 container multiplexer using mp4-muxer library\n * Supports video and audio track export\n */\nexport class MP4Muxer {\n  private muxer: Muxer<ArrayBufferTarget>;\n  private firstVideoChunk = true;\n  private firstAudioChunk = true;\n  private videoChunkMeta: any = null;\n  private audioChunkMeta: any = null;\n\n  constructor(config: {\n    width: number;\n    height: number;\n    fps: number;\n    fastStart?: false | 'in-memory' | 'fragmented';\n    videoChunkMeta?: any;\n    audioChunkMeta?: any;\n  }) {\n    this.videoChunkMeta = config.videoChunkMeta;\n    this.audioChunkMeta = config.audioChunkMeta;\n\n    const muxerConfig: any = {\n      target: new ArrayBufferTarget(),\n      video: {\n        codec: 'avc',\n        width: config.width,\n        height: config.height,\n        frameRate: config.fps,\n      },\n      fastStart: config.fastStart ?? 'in-memory',\n      firstTimestampBehavior: 'offset',\n    };\n\n    // Add audio configuration if provided\n    // If not provided initially, we assume AAC (standard for web)\n    // but mp4-muxer might need it.\n    // Actually mp4-muxer allows adding track configuration later?\n    // No, it requires it in constructor or inferred?\n    // If audioChunkMeta is missing, we can't configure audio fully here.\n    // But mp4-muxer docs say: \"If you don't provide options.audio, no audio track will be created.\"\n    // So we MUST provide options.audio if we want audio.\n    // If we don't have meta yet, we guess?\n    // Or we rely on audio export always providing AAC 48k?\n    // Let's assume AAC 48k 2ch as default if we want audio support.\n    // Or better: if audioChunkMeta is null, we enable audio with defaults.\n\n    // However, for robustness, we should probably wait for first chunk to configure muxer?\n    // But MuxManager calls `start` then `writeVideoChunk` then `writeAudioChunk`.\n    // Audio might come later.\n    //\n    // Let's assume we always want audio track capability.\n    muxerConfig.audio = {\n      codec: 'aac',\n      sampleRate: this.audioChunkMeta?.sampleRate || 48000,\n      numberOfChannels: this.audioChunkMeta?.numberOfChannels || 2,\n    };\n\n    this.muxer = new Muxer(muxerConfig);\n  }\n\n  private videoChunkCount = 0;\n\n  writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata): void {\n    let meta: EncodedVideoChunkMetadata | undefined;\n\n    if (this.firstVideoChunk) {\n      if (metadata && metadata.decoderConfig) {\n        this.videoChunkMeta = metadata.decoderConfig;\n      }\n\n      if (this.videoChunkMeta) {\n        meta = { decoderConfig: this.videoChunkMeta };\n      }\n\n      // Ensure we have metadata for first chunk if it's a keyframe\n      if (chunk.type === 'key' && !meta) {\n        console.warn('[MP4Muxer] First video chunk is keyframe but missing decoderConfig');\n      }\n\n      this.firstVideoChunk = false;\n    }\n\n    this.videoChunkCount++;\n    this.muxer.addVideoChunk(chunk, meta);\n  }\n\n  private audioChunkCount = 0;\n\n  writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata): void {\n    // Safari (and sometimes Chromium) may emit tiny (e.g. 6 bytes) \"audio\" chunks that are not valid AAC frames.\n    // Keeping them may cause players to treat the whole audio track as undecodable/silent.\n    // Drop tiny chunks and DO NOT trust their metadata.\n    if (chunk.byteLength <= 16) {\n      return;\n    }\n\n    let meta: EncodedAudioChunkMetadata | undefined;\n\n    if (this.firstAudioChunk) {\n      if (metadata && metadata.decoderConfig) {\n        this.audioChunkMeta = metadata.decoderConfig;\n      }\n\n      if (this.audioChunkMeta) {\n        meta = { decoderConfig: this.audioChunkMeta };\n      }\n\n      this.firstAudioChunk = false;\n    }\n\n    this.audioChunkCount++;\n    this.muxer.addAudioChunk(chunk, meta);\n  }\n\n  finalize(): Blob {\n    this.muxer.finalize();\n    const buffer = (this.muxer.target as ArrayBufferTarget).buffer;\n    return new Blob([buffer], { type: 'video/mp4' });\n  }\n}\n"],"names":[],"mappings":";AAMO,MAAM,SAAS;AAAA,EACZ;AAAA,EACA,kBAAkB;AAAA,EAClB,kBAAkB;AAAA,EAClB,iBAAsB;AAAA,EACtB,iBAAsB;AAAA,EAE9B,YAAY,QAOT;AACD,SAAK,iBAAiB,OAAO;AAC7B,SAAK,iBAAiB,OAAO;AAE7B,UAAM,cAAmB;AAAA,MACvB,QAAQ,IAAI,kBAAA;AAAA,MACZ,OAAO;AAAA,QACL,OAAO;AAAA,QACP,OAAO,OAAO;AAAA,QACd,QAAQ,OAAO;AAAA,QACf,WAAW,OAAO;AAAA,MAAA;AAAA,MAEpB,WAAW,OAAO,aAAa;AAAA,MAC/B,wBAAwB;AAAA,IAAA;AAqB1B,gBAAY,QAAQ;AAAA,MAClB,OAAO;AAAA,MACP,YAAY,KAAK,gBAAgB,cAAc;AAAA,MAC/C,kBAAkB,KAAK,gBAAgB,oBAAoB;AAAA,IAAA;AAG7D,SAAK,QAAQ,IAAI,MAAM,WAAW;AAAA,EACpC;AAAA,EAEQ,kBAAkB;AAAA,EAE1B,gBAAgB,OAA0B,UAA4C;AACpF,QAAI;AAEJ,QAAI,KAAK,iBAAiB;AACxB,UAAI,YAAY,SAAS,eAAe;AACtC,aAAK,iBAAiB,SAAS;AAAA,MACjC;AAEA,UAAI,KAAK,gBAAgB;AACvB,eAAO,EAAE,eAAe,KAAK,eAAA;AAAA,MAC/B;AAGA,UAAI,MAAM,SAAS,SAAS,CAAC,MAAM;AACjC,gBAAQ,KAAK,oEAAoE;AAAA,MACnF;AAEA,WAAK,kBAAkB;AAAA,IACzB;AAEA,SAAK;AACL,SAAK,MAAM,cAAc,OAAO,IAAI;AAAA,EACtC;AAAA,EAEQ,kBAAkB;AAAA,EAE1B,gBAAgB,OAA0B,UAA4C;AAIpF,QAAI,MAAM,cAAc,IAAI;AAC1B;AAAA,IACF;AAEA,QAAI;AAEJ,QAAI,KAAK,iBAAiB;AACxB,UAAI,YAAY,SAAS,eAAe;AACtC,aAAK,iBAAiB,SAAS;AAAA,MACjC;AAEA,UAAI,KAAK,gBAAgB;AACvB,eAAO,EAAE,eAAe,KAAK,eAAA;AAAA,MAC/B;AAEA,WAAK,kBAAkB;AAAA,IACzB;AAEA,SAAK;AACL,SAAK,MAAM,cAAc,OAAO,IAAI;AAAA,EACtC;AAAA,EAEA,WAAiB;AACf,SAAK,MAAM,SAAA;AACX,UAAM,SAAU,KAAK,MAAM,OAA6B;AACxD,WAAO,IAAI,KAAK,CAAC,MAAM,GAAG,EAAE,MAAM,aAAa;AAAA,EACjD;AACF;"}
+{"version":3,"file":"MP4Muxer.js","sources":["../../../src/stages/mux/MP4Muxer.ts"],"sourcesContent":["import { Muxer, ArrayBufferTarget, StreamTarget } from 'mp4-muxer';\n\nexport type MuxOutputConfig =\n  | { kind: 'blob' }\n  | {\n      kind: 'stream';\n      onData: (data: Uint8Array, position: number) => void;\n      chunked?: boolean;\n      chunkSize?: number;\n    };\n\n/**\n * MP4Muxer - MP4 container multiplexer using mp4-muxer library\n * Supports video and audio track export\n */\nexport class MP4Muxer {\n  private muxer: Muxer<ArrayBufferTarget | StreamTarget>;\n  private firstVideoChunk = true;\n  private firstAudioChunk = true;\n  private videoChunkMeta: any = null;\n  private audioChunkMeta: any = null;\n  private lastAudioDurationUs: number | null = null;\n\n  constructor(\n    config: {\n      width: number;\n      height: number;\n      fps: number;\n      fastStart?: false | 'in-memory' | 'fragmented';\n      videoChunkMeta?: any;\n      audioChunkMeta?: any;\n    },\n    output: MuxOutputConfig = { kind: 'blob' }\n  ) {\n    this.videoChunkMeta = config.videoChunkMeta;\n    this.audioChunkMeta = config.audioChunkMeta;\n\n    const target =\n      output.kind === 'stream'\n        ? new StreamTarget({\n            onData: output.onData,\n            chunked: output.chunked ?? true,\n            chunkSize: output.chunkSize ?? 16 * 1024 * 1024, // 16 MiB default to reduce writes\n          })\n        : new ArrayBufferTarget();\n\n    const muxerConfig: any = {\n      target,\n      video: {\n        codec: 'avc',\n        width: config.width,\n        height: config.height,\n        frameRate: config.fps,\n      },\n      fastStart: config.fastStart ?? 'in-memory',\n      firstTimestampBehavior: 'offset',\n    };\n\n    // Add audio configuration if provided\n    // If not provided initially, we assume AAC (standard for web)\n    // but mp4-muxer might need it.\n    // Actually mp4-muxer allows adding track configuration later?\n    // No, it requires it in constructor or inferred?\n    // If audioChunkMeta is missing, we can't configure audio fully here.\n    // But mp4-muxer docs say: \"If you don't provide options.audio, no audio track will be created.\"\n    // So we MUST provide options.audio if we want audio.\n    // If we don't have meta yet, we guess?\n    // Or we rely on audio export always providing AAC 48k?\n    // Let's assume AAC 48k 2ch as default if we want audio support.\n    // Or better: if audioChunkMeta is null, we enable audio with defaults.\n\n    // However, for robustness, we should probably wait for first chunk to configure muxer?\n    // But MuxManager calls `start` then `writeVideoChunk` then `writeAudioChunk`.\n    // Audio might come later.\n    //\n    // Let's assume we always want audio track capability.\n    muxerConfig.audio = {\n      codec: 'aac',\n      sampleRate: this.audioChunkMeta?.sampleRate || 48000,\n      numberOfChannels: this.audioChunkMeta?.numberOfChannels || 2,\n    };\n\n    this.muxer = new Muxer(muxerConfig);\n  }\n\n  private videoChunkCount = 0;\n\n  writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata): void {\n    let meta: EncodedVideoChunkMetadata | undefined;\n\n    if (this.firstVideoChunk) {\n      if (metadata && metadata.decoderConfig) {\n        this.videoChunkMeta = metadata.decoderConfig;\n      }\n\n      if (this.videoChunkMeta) {\n        meta = { decoderConfig: this.videoChunkMeta };\n      }\n\n      // Ensure we have metadata for first chunk if it's a keyframe\n      if (chunk.type === 'key' && !meta) {\n        console.warn('[MP4Muxer] First video chunk is keyframe but missing decoderConfig');\n      }\n\n      this.firstVideoChunk = false;\n    }\n\n    this.videoChunkCount++;\n    this.muxer.addVideoChunk(chunk, meta);\n  }\n\n  private audioChunkCount = 0;\n\n  writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata): void {\n    // Safari (and sometimes Chromium) may emit tiny (e.g. 6 bytes) \"audio\" chunks that are not valid AAC frames.\n    // mp4-muxer treats durations as authoritative; dropping *valid* small chunks can collapse silence gaps and cause stutter.\n    // So only drop tiny chunks when they are clearly invalid (duration missing/<=0).\n    if (chunk.byteLength <= 16 && (!chunk.duration || chunk.duration <= 0)) {\n      return;\n    }\n\n    let meta: EncodedAudioChunkMetadata | undefined;\n\n    if (this.firstAudioChunk) {\n      if (metadata && metadata.decoderConfig) {\n        this.audioChunkMeta = metadata.decoderConfig;\n      }\n\n      if (this.audioChunkMeta) {\n        meta = { decoderConfig: this.audioChunkMeta };\n      }\n\n      this.firstAudioChunk = false;\n    }\n\n    // Some platforms output duration=0/undefined for audio chunks.\n    // mp4-muxer uses duration to build the timeline; 0 duration can collapse time and remove intended gaps.\n    // Try to synthesize a sane duration:\n    // - Prefer the chunk's own duration when >0\n    // - Otherwise use AAC-LC frame duration (1024 samples) inferred from decoderConfig sampleRate if known\n    const hasValidDuration = !!chunk.duration && chunk.duration > 0;\n    if (!hasValidDuration) {\n      const sampleRate =\n        (metadata as any)?.decoderConfig?.sampleRate ?? this.audioChunkMeta?.sampleRate ?? 48_000;\n      const inferredDurationUs =\n        this.lastAudioDurationUs ?? Math.max(1, Math.round((1024 / sampleRate) * 1_000_000));\n\n      const buffer = new ArrayBuffer(chunk.byteLength);\n      chunk.copyTo(buffer);\n      chunk = new EncodedAudioChunk({\n        type: chunk.type,\n        timestamp: chunk.timestamp,\n        duration: inferredDurationUs,\n        data: buffer,\n      });\n      this.lastAudioDurationUs = inferredDurationUs;\n    } else {\n      this.lastAudioDurationUs = chunk.duration!;\n    }\n\n    this.audioChunkCount++;\n    this.muxer.addAudioChunk(chunk, meta);\n  }\n\n  finalize(): Blob | null {\n    this.muxer.finalize();\n    if (this.muxer.target instanceof ArrayBufferTarget) {\n      const buffer = this.muxer.target.buffer;\n      return new Blob([buffer], { type: 'video/mp4' });\n    }\n    // Stream target has already delivered data via onData callback.\n    return null;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/stages/mux/MuxManager.d.ts

@@ -1,13 +1,17 @@
+import { MuxOutputConfig } from './MP4Muxer';
+
 export declare class MuxManager {
     private muxer;
+    private output;
     constructor();
     start(config: {
         width: number;
         height: number;
         fps: number;
+        output?: MuxOutputConfig;
     }): void;
     writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata): void;
     writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata): void;
-    finalize(): Blob;
+    finalize(): Blob | null;
 }
 //# sourceMappingURL=MuxManager.d.ts.map

package/dist/stages/mux/MuxManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MuxManager.d.ts","sourceRoot":"","sources":["../../../src/stages/mux/MuxManager.ts"],"names":[],"mappings":"AAEA,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAyB;;IAItC,KAAK,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAU5D,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB;IAK9E,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB;IAS9E,QAAQ,IAAI,IAAI;CAMjB"}
+{"version":3,"file":"MuxManager.d.ts","sourceRoot":"","sources":["../../../src/stages/mux/MuxManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5D,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,MAAM,CAAgC;;IAI9C,KAAK,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,eAAe,CAAA;KAAE;IAgBtF,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB;IAK9E,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,yBAAyB;IAS9E,QAAQ,IAAI,IAAI,GAAG,IAAI;CAOxB"}

package/dist/stages/mux/MuxManager.js

@@ -1,16 +1,23 @@
 import { MP4Muxer } from "./MP4Muxer.js";
 class MuxManager {
   muxer = null;
+  output = null;
   constructor() {
   }
   start(config) {
-    this.muxer = new MP4Muxer({
-      width: config.width,
-      height: config.height,
-      fps: config.fps,
-      fastStart: "in-memory"
-      // Metadata will be handled by first chunks
-    });
+    this.output = config.output ?? { kind: "blob" };
+    this.muxer = new MP4Muxer(
+      {
+        width: config.width,
+        height: config.height,
+        fps: config.fps,
+        // For blob output, prefer fast start by keeping chunks in memory.
+        // For stream output, prefer minimal memory usage: metadata at end (non-fMP4).
+        fastStart: this.output.kind === "stream" ? false : "in-memory"
+        // Metadata will be handled by first chunks
+      },
+      this.output
+    );
   }
   writeVideoChunk(chunk, metadata) {
     if (!this.muxer) throw new Error("Muxer not started");
@@ -27,6 +34,7 @@ class MuxManager {
     if (!this.muxer) throw new Error("Muxer not started");
     const blob = this.muxer.finalize();
     this.muxer = null;
+    this.output = null;
     return blob;
   }
 }

package/dist/stages/mux/MuxManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"MuxManager.js","sources":["../../../src/stages/mux/MuxManager.ts"],"sourcesContent":["import { MP4Muxer } from './MP4Muxer';\n\nexport class MuxManager {\n  private muxer: MP4Muxer | null = null;\n\n  constructor() {}\n\n  start(config: { width: number; height: number; fps: number }) {\n    this.muxer = new MP4Muxer({\n      width: config.width,\n      height: config.height,\n      fps: config.fps,\n      fastStart: 'in-memory',\n      // Metadata will be handled by first chunks\n    });\n  }\n\n  writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata) {\n    if (!this.muxer) throw new Error('Muxer not started');\n    this.muxer.writeVideoChunk(chunk, metadata);\n  }\n\n  writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata) {\n    // Check if muxer is available (it might have been finalized already if audio is late)\n    if (!this.muxer) {\n      console.warn('[MuxManager] writeAudioChunk called after finalization, dropping chunk');\n      return;\n    }\n    this.muxer.writeAudioChunk(chunk, metadata);\n  }\n\n  finalize(): Blob {\n    if (!this.muxer) throw new Error('Muxer not started');\n    const blob = this.muxer.finalize();\n    this.muxer = null;\n    return blob;\n  }\n}\n"],"names":[],"mappings":";AAEO,MAAM,WAAW;AAAA,EACd,QAAyB;AAAA,EAEjC,cAAc;AAAA,EAAC;AAAA,EAEf,MAAM,QAAwD;AAC5D,SAAK,QAAQ,IAAI,SAAS;AAAA,MACxB,OAAO,OAAO;AAAA,MACd,QAAQ,OAAO;AAAA,MACf,KAAK,OAAO;AAAA,MACZ,WAAW;AAAA;AAAA,IAAA,CAEZ;AAAA,EACH;AAAA,EAEA,gBAAgB,OAA0B,UAAsC;AAC9E,QAAI,CAAC,KAAK,MAAO,OAAM,IAAI,MAAM,mBAAmB;AACpD,SAAK,MAAM,gBAAgB,OAAO,QAAQ;AAAA,EAC5C;AAAA,EAEA,gBAAgB,OAA0B,UAAsC;AAE9E,QAAI,CAAC,KAAK,OAAO;AACf,cAAQ,KAAK,wEAAwE;AACrF;AAAA,IACF;AACA,SAAK,MAAM,gBAAgB,OAAO,QAAQ;AAAA,EAC5C;AAAA,EAEA,WAAiB;AACf,QAAI,CAAC,KAAK,MAAO,OAAM,IAAI,MAAM,mBAAmB;AACpD,UAAM,OAAO,KAAK,MAAM,SAAA;AACxB,SAAK,QAAQ;AACb,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"MuxManager.js","sources":["../../../src/stages/mux/MuxManager.ts"],"sourcesContent":["import { MP4Muxer, type MuxOutputConfig } from './MP4Muxer';\n\nexport class MuxManager {\n  private muxer: MP4Muxer | null = null;\n  private output: MuxOutputConfig | null = null;\n\n  constructor() {}\n\n  start(config: { width: number; height: number; fps: number; output?: MuxOutputConfig }) {\n    this.output = config.output ?? { kind: 'blob' };\n    this.muxer = new MP4Muxer(\n      {\n        width: config.width,\n        height: config.height,\n        fps: config.fps,\n        // For blob output, prefer fast start by keeping chunks in memory.\n        // For stream output, prefer minimal memory usage: metadata at end (non-fMP4).\n        fastStart: this.output.kind === 'stream' ? false : 'in-memory',\n        // Metadata will be handled by first chunks\n      },\n      this.output\n    );\n  }\n\n  writeVideoChunk(chunk: EncodedVideoChunk, metadata?: EncodedVideoChunkMetadata) {\n    if (!this.muxer) throw new Error('Muxer not started');\n    this.muxer.writeVideoChunk(chunk, metadata);\n  }\n\n  writeAudioChunk(chunk: EncodedAudioChunk, metadata?: EncodedAudioChunkMetadata) {\n    // Check if muxer is available (it might have been finalized already if audio is late)\n    if (!this.muxer) {\n      console.warn('[MuxManager] writeAudioChunk called after finalization, dropping chunk');\n      return;\n    }\n    this.muxer.writeAudioChunk(chunk, metadata);\n  }\n\n  finalize(): Blob | null {\n    if (!this.muxer) throw new Error('Muxer not started');\n    const blob = this.muxer.finalize();\n    this.muxer = null;\n    this.output = null;\n    return blob;\n  }\n}\n"],"names":[],"mappings":";AAEO,MAAM,WAAW;AAAA,EACd,QAAyB;AAAA,EACzB,SAAiC;AAAA,EAEzC,cAAc;AAAA,EAAC;AAAA,EAEf,MAAM,QAAkF;AACtF,SAAK,SAAS,OAAO,UAAU,EAAE,MAAM,OAAA;AACvC,SAAK,QAAQ,IAAI;AAAA,MACf;AAAA,QACE,OAAO,OAAO;AAAA,QACd,QAAQ,OAAO;AAAA,QACf,KAAK,OAAO;AAAA;AAAA;AAAA,QAGZ,WAAW,KAAK,OAAO,SAAS,WAAW,QAAQ;AAAA;AAAA,MAAA;AAAA,MAGrD,KAAK;AAAA,IAAA;AAAA,EAET;AAAA,EAEA,gBAAgB,OAA0B,UAAsC;AAC9E,QAAI,CAAC,KAAK,MAAO,OAAM,IAAI,MAAM,mBAAmB;AACpD,SAAK,MAAM,gBAAgB,OAAO,QAAQ;AAAA,EAC5C;AAAA,EAEA,gBAAgB,OAA0B,UAAsC;AAE9E,QAAI,CAAC,KAAK,OAAO;AACf,cAAQ,KAAK,wEAAwE;AACrF;AAAA,IACF;AACA,SAAK,MAAM,gBAAgB,OAAO,QAAQ;AAAA,EAC5C;AAAA,EAEA,WAAwB;AACtB,QAAI,CAAC,KAAK,MAAO,OAAM,IAAI,MAAM,mBAAmB;AACpD,UAAM,OAAO,KAAK,MAAM,SAAA;AACxB,SAAK,QAAQ;AACb,SAAK,SAAS;AACd,WAAO;AAAA,EACT;AACF;"}

package/dist/types.d.ts

@@ -21,5 +21,13 @@ export interface ExportOptions {
     fps?: number;
     /** Quality preset */
     quality?: 'low' | 'medium' | 'high' | 'highest';
+    /** Export output mode (default blob). */
+    exportMode?: 'blob' | 'stream';
+    /** Streaming mux callback, required when exportMode is 'stream'. */
+    onMuxData?: (data: Uint8Array, position: number) => void;
+    /** Optional chunk sizing hint for streaming mux output. */
+    muxChunkSizeBytes?: number;
+    /** Whether to enable mp4-muxer chunked StreamTarget (default true). */
+    muxChunked?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,OAAO,GACP,WAAW,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAExB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAE7C,kBAAkB;IAClB,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAE5B,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;CACjD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,OAAO,GACP,WAAW,CAAC;AAEhB,MAAM,WAAW,aAAa;IAC5B,oBAAoB;IACpB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAExB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAE7C,kBAAkB;IAClB,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAE5B,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iBAAiB;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAEhD,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC/B,oEAAoE;IACpE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,2DAA2D;IAC3D,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/dist/utils/loop-utils.d.ts

@@ -0,0 +1,16 @@
+import { TimeUs } from '../model/types';
+
+export interface LoopSegment {
+    clipRelativeStartUs: TimeUs;
+    durationUs: TimeUs;
+    resourceStartUs: TimeUs;
+    resourceEndUs: TimeUs;
+}
+export declare function buildLoopedResourceSegments(params: {
+    clipRelativeStartUs: TimeUs;
+    clipRelativeEndUs: TimeUs;
+    trimStartUs: TimeUs;
+    resourceDurationUs: TimeUs;
+    loop: boolean;
+}): LoopSegment[];
+//# sourceMappingURL=loop-utils.d.ts.map

package/dist/utils/loop-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-utils.d.ts","sourceRoot":"","sources":["../../src/utils/loop-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,WAAW,EAAE,CA+ChB"}

package/dist/utils/loop-utils.js

@@ -0,0 +1,44 @@
+function buildLoopedResourceSegments(params) {
+  const rangeStartUs = Math.max(0, params.clipRelativeStartUs);
+  const rangeEndUs = Math.max(rangeStartUs, params.clipRelativeEndUs);
+  const requestedDurationUs = rangeEndUs - rangeStartUs;
+  if (requestedDurationUs <= 0) {
+    return [];
+  }
+  if (!params.loop) {
+    return [
+      {
+        clipRelativeStartUs: rangeStartUs,
+        durationUs: requestedDurationUs,
+        resourceStartUs: rangeStartUs + (params.trimStartUs ?? 0),
+        resourceEndUs: rangeEndUs + (params.trimStartUs ?? 0)
+      }
+    ];
+  }
+  const trimStartUs = params.trimStartUs ?? 0;
+  const periodUs = params.resourceDurationUs - trimStartUs;
+  if (periodUs <= 0) {
+    return [];
+  }
+  const segments = [];
+  let tUs = rangeStartUs;
+  while (tUs < rangeEndUs) {
+    const offsetInPeriodUs = tUs % periodUs;
+    const maxLenUs = periodUs - offsetInPeriodUs;
+    const lenUs = Math.min(rangeEndUs - tUs, maxLenUs);
+    if (lenUs <= 0) break;
+    const resourceStartUs = trimStartUs + offsetInPeriodUs;
+    segments.push({
+      clipRelativeStartUs: tUs,
+      durationUs: lenUs,
+      resourceStartUs,
+      resourceEndUs: resourceStartUs + lenUs
+    });
+    tUs += lenUs;
+  }
+  return segments;
+}
+export {
+  buildLoopedResourceSegments
+};
+//# sourceMappingURL=loop-utils.js.map

package/dist/utils/loop-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-utils.js","sources":["../../src/utils/loop-utils.ts"],"sourcesContent":["import type { TimeUs } from '../model/types';\n\nexport interface LoopSegment {\n  clipRelativeStartUs: TimeUs;\n  durationUs: TimeUs;\n  resourceStartUs: TimeUs;\n  resourceEndUs: TimeUs;\n}\n\nexport function buildLoopedResourceSegments(params: {\n  clipRelativeStartUs: TimeUs;\n  clipRelativeEndUs: TimeUs;\n  trimStartUs: TimeUs;\n  resourceDurationUs: TimeUs;\n  loop: boolean;\n}): LoopSegment[] {\n  const rangeStartUs = Math.max(0, params.clipRelativeStartUs);\n  const rangeEndUs = Math.max(rangeStartUs, params.clipRelativeEndUs);\n\n  const requestedDurationUs = rangeEndUs - rangeStartUs;\n  if (requestedDurationUs <= 0) {\n    return [];\n  }\n\n  if (!params.loop) {\n    return [\n      {\n        clipRelativeStartUs: rangeStartUs,\n        durationUs: requestedDurationUs,\n        resourceStartUs: rangeStartUs + (params.trimStartUs ?? 0),\n        resourceEndUs: rangeEndUs + (params.trimStartUs ?? 0),\n      },\n    ];\n  }\n\n  const trimStartUs = params.trimStartUs ?? 0;\n  const periodUs = params.resourceDurationUs - trimStartUs;\n  if (periodUs <= 0) {\n    return [];\n  }\n\n  const segments: LoopSegment[] = [];\n  let tUs = rangeStartUs;\n\n  while (tUs < rangeEndUs) {\n    const offsetInPeriodUs = tUs % periodUs;\n    const maxLenUs = periodUs - offsetInPeriodUs;\n    const lenUs = Math.min(rangeEndUs - tUs, maxLenUs);\n    if (lenUs <= 0) break;\n\n    const resourceStartUs = trimStartUs + offsetInPeriodUs;\n    segments.push({\n      clipRelativeStartUs: tUs,\n      durationUs: lenUs,\n      resourceStartUs,\n      resourceEndUs: resourceStartUs + lenUs,\n    });\n\n    tUs += lenUs;\n  }\n\n  return segments;\n}\n"],"names":[],"mappings":"AASO,SAAS,4BAA4B,QAM1B;AAChB,QAAM,eAAe,KAAK,IAAI,GAAG,OAAO,mBAAmB;AAC3D,QAAM,aAAa,KAAK,IAAI,cAAc,OAAO,iBAAiB;AAElE,QAAM,sBAAsB,aAAa;AACzC,MAAI,uBAAuB,GAAG;AAC5B,WAAO,CAAA;AAAA,EACT;AAEA,MAAI,CAAC,OAAO,MAAM;AAChB,WAAO;AAAA,MACL;AAAA,QACE,qBAAqB;AAAA,QACrB,YAAY;AAAA,QACZ,iBAAiB,gBAAgB,OAAO,eAAe;AAAA,QACvD,eAAe,cAAc,OAAO,eAAe;AAAA,MAAA;AAAA,IACrD;AAAA,EAEJ;AAEA,QAAM,cAAc,OAAO,eAAe;AAC1C,QAAM,WAAW,OAAO,qBAAqB;AAC7C,MAAI,YAAY,GAAG;AACjB,WAAO,CAAA;AAAA,EACT;AAEA,QAAM,WAA0B,CAAA;AAChC,MAAI,MAAM;AAEV,SAAO,MAAM,YAAY;AACvB,UAAM,mBAAmB,MAAM;AAC/B,UAAM,WAAW,WAAW;AAC5B,UAAM,QAAQ,KAAK,IAAI,aAAa,KAAK,QAAQ;AACjD,QAAI,SAAS,EAAG;AAEhB,UAAM,kBAAkB,cAAc;AACtC,aAAS,KAAK;AAAA,MACZ,qBAAqB;AAAA,MACrB,YAAY;AAAA,MACZ;AAAA,MACA,eAAe,kBAAkB;AAAA,IAAA,CAClC;AAED,WAAO;AAAA,EACT;AAEA,SAAO;AACT;"}

package/dist/workers/stages/compose/{video-compose.worker.CA2_Kpg-.js → video-compose.worker.KMZjuJuY.js}

@@ -1828,10 +1828,12 @@ class FrameRateConverter {
   clipDurationUs;
   frameDurationUs;
   trimStartUs;
+  totalFrameCount;
   // State for frame processing
   targetFrameIndex = 0;
   targetFrameTimeUs = 0;
   sourceFrameBuffer = [];
+  maxSourceTimestampUs = null;
   constructor(targetFps, clipDurationUs, trimStartUs = 0) {
     if (targetFps <= 0) {
       throw new Error(`Invalid target fps: ${targetFps}`);
@@ -1842,6 +1844,7 @@ class FrameRateConverter {
     this.clipDurationUs = clipDurationUs;
     this.frameDurationUs = Math.round(1e6 / targetFps);
     this.trimStartUs = trimStartUs;
+    this.totalFrameCount = Number.isFinite(clipDurationUs) ? Math.max(1, Math.round(clipDurationUs / this.frameDurationUs)) : null;
   }
   /**
    * Create a TransformStream that converts VFR frames to CFR frames
@@ -1854,6 +1857,7 @@ class FrameRateConverter {
         this.sourceFrameBuffer = [];
         this.sourceFrameCount = 0;
         this.outputFrameCount = 0;
+        this.maxSourceTimestampUs = null;
       },
       transform: (sourceFrame, controller) => {
         this.processSourceFrame(sourceFrame, controller);
@@ -1887,7 +1891,12 @@ class FrameRateConverter {
     }
     this.sourceFrameBuffer.push(frameToBuffer);
     this.sourceFrameCount++;
-    while (this.targetFrameTimeUs < this.clipDurationUs) {
+    const bufferedTs = frameToBuffer.timestamp ?? 0;
+    this.maxSourceTimestampUs = this.maxSourceTimestampUs === null ? bufferedTs : Math.max(this.maxSourceTimestampUs, bufferedTs);
+    while (this.shouldContinueOutput()) {
+      if (this.maxSourceTimestampUs !== null && this.targetFrameTimeUs > this.maxSourceTimestampUs) {
+        break;
+      }
       const closestFrame = this.findClosestFrame(this.targetFrameTimeUs);
       if (!closestFrame) {
         break;
@@ -1916,12 +1925,33 @@ class FrameRateConverter {
    * Flush remaining target frames at end of stream
    */
   flushRemainingFrames(controller) {
-    while (this.sourceFrameBuffer.length > 0 && this.targetFrameTimeUs < this.clipDurationUs) {
+    while (this.sourceFrameBuffer.length > 0 && this.shouldContinueOutput()) {
+      if (this.maxSourceTimestampUs !== null && this.targetFrameTimeUs > this.maxSourceTimestampUs) {
+        break;
+      }
       const closestFrame = this.findClosestFrame(this.targetFrameTimeUs);
       if (!closestFrame) break;
       if (!this.outputTargetFrame(closestFrame, controller)) break;
     }
-    this.cleanupAllFrames(null);
+    if (!Number.isFinite(this.clipDurationUs) || this.totalFrameCount === null) {
+      this.cleanupAllFrames(null);
+      return;
+    }
+    const padFrame = this.getPadFrame();
+    if (!padFrame) {
+      this.cleanupAllFrames(null);
+      return;
+    }
+    while (this.shouldContinueOutput()) {
+      if (!this.outputTargetFrame(padFrame, controller)) {
+        break;
+      }
+    }
+    this.cleanupAllFrames(padFrame);
+    try {
+      padFrame.close();
+    } catch {
+    }
   }
   /**
    * Output a single target frame
@@ -1941,6 +1971,19 @@ class FrameRateConverter {
       return false;
     }
   }
+  getPadFrame() {
+    if (this.sourceFrameBuffer.length === 0) {
+      return null;
+    }
+    const last = this.sourceFrameBuffer[this.sourceFrameBuffer.length - 1] ?? null;
+    return last;
+  }
+  shouldContinueOutput() {
+    if (this.totalFrameCount === null) {
+      return this.targetFrameTimeUs < this.clipDurationUs;
+    }
+    return this.targetFrameIndex < this.totalFrameCount;
+  }
   /**
    * Clean up all buffered frames (except the specified frame to keep)
    */
@@ -2511,4 +2554,4 @@ export {
   VideoComposeWorker,
   videoCompose_worker as default
 };
-//# sourceMappingURL=video-compose.worker.CA2_Kpg-.js.map
+//# sourceMappingURL=video-compose.worker.KMZjuJuY.js.map