@meframe/server 0.0.9 → 0.1.0

package/dist/runner-browser/runner.mjs

@@ -1296,7 +1296,7 @@ class Qs {
     this.port.onmessage = h;
   }
 }
-var z = /* @__PURE__ */ ((a) => (a.ModelSet = "model:set", a.ResourceAdd = "resource:add", a.ResourceUpdate = "resource:update", a.ResourceRemove = "resource:remove", a.ResourceStageChange = "resource:state", a.ResourceFirstFrameReady = "resource:firstFrameReady", a.LoadStart = "load:start", a.LoadProgress = "load:progress", a.LoadComplete = "load:complete", a.LoadError = "load:error", a.DemuxStart = "demux:start", a.DemuxProgress = "demux:progress", a.DemuxComplete = "demux:complete", a.DemuxError = "demux:error", a.DecodeStart = "decode:start", a.DecodeProgress = "decode:progress", a.DecodeComplete = "decode:complete", a.DecodeError = "decode:error", a.ComposeStart = "compose:start", a.ComposeProgress = "compose:progress", a.ComposeComplete = "compose:complete", a.ComposeFrameReady = "compose:frameReady", a.ComposeFrameDropped = "compose:frameDropped", a.EncodeChunkReady = "encode:chunkReady", a.EncodeChunkError = "encode:chunkError", a.CacheHit = "cache:hit", a.CacheMiss = "cache:miss", a.CacheEvict = "cache:evict", a.CacheWrite = "cache:write", a.CacheCover = "cache:cover", a.ExportPreparing = "export:preparing", a.ExportStart = "export:start", a.ExportProgress = "export:progress", a.ExportComplete = "export:complete", a.ExportError = "export:error", a.CompositionUpdated = "composition:updated", a.PatchApplied = "patch:applied", a.Ready = "ready", a.WorkerStarted = "worker:started", a.WorkerReady = "worker:ready", a.WorkerError = "worker:error", a.WorkerRestarted = "worker:restarted", a.PlaybackBuffering = "playback:buffering", a.PlaybackPlay = "playback:play", a.PlaybackPause = "playback:pause", a.PlaybackStop = "playback:stop", a.PlaybackSeek = "playback:seek", a.PlaybackEnded = "playback:ended", a.PlaybackTimeUpdate = "playback:timeupdate", a.PlaybackRateChange = "playback:ratechange", a.PlaybackVolumeChange = "playback:volumechange", a.PlaybackError = "playback:error", a.PlaybackStarted = "playback:started", a.PlaybackPaused = "playback:paused", a.PlaybackSeeked = "playback:seeked", a.Error = "error", a.PluginLoaded = "plugin:loaded", a.PluginError = "plugin:error", a.PluginUnloaded = "plugin:unloaded", a.ClipActivated = "clip:activated", a.ClipDeactivated = "clip:deactivated", a))(z || {});
+var O = /* @__PURE__ */ ((a) => (a.ModelSet = "model:set", a.ResourceAdd = "resource:add", a.ResourceUpdate = "resource:update", a.ResourceRemove = "resource:remove", a.ResourceStageChange = "resource:state", a.ResourceFirstFrameReady = "resource:firstFrameReady", a.LoadStart = "load:start", a.LoadProgress = "load:progress", a.LoadComplete = "load:complete", a.LoadError = "load:error", a.DemuxStart = "demux:start", a.DemuxProgress = "demux:progress", a.DemuxComplete = "demux:complete", a.DemuxError = "demux:error", a.DecodeStart = "decode:start", a.DecodeProgress = "decode:progress", a.DecodeComplete = "decode:complete", a.DecodeError = "decode:error", a.ComposeStart = "compose:start", a.ComposeProgress = "compose:progress", a.ComposeComplete = "compose:complete", a.ComposeFrameReady = "compose:frameReady", a.ComposeFrameDropped = "compose:frameDropped", a.EncodeChunkReady = "encode:chunkReady", a.EncodeChunkError = "encode:chunkError", a.CacheHit = "cache:hit", a.CacheMiss = "cache:miss", a.CacheEvict = "cache:evict", a.CacheWrite = "cache:write", a.CacheCover = "cache:cover", a.ExportPreparing = "export:preparing", a.ExportStart = "export:start", a.ExportProgress = "export:progress", a.ExportComplete = "export:complete", a.ExportError = "export:error", a.CompositionUpdated = "composition:updated", a.PatchApplied = "patch:applied", a.Ready = "ready", a.WorkerStarted = "worker:started", a.WorkerReady = "worker:ready", a.WorkerError = "worker:error", a.WorkerRestarted = "worker:restarted", a.PlaybackBuffering = "playback:buffering", a.PlaybackPlay = "playback:play", a.PlaybackPause = "playback:pause", a.PlaybackStop = "playback:stop", a.PlaybackSeek = "playback:seek", a.PlaybackEnded = "playback:ended", a.PlaybackTimeUpdate = "playback:timeupdate", a.PlaybackRateChange = "playback:ratechange", a.PlaybackVolumeChange = "playback:volumechange", a.PlaybackError = "playback:error", a.PlaybackStarted = "playback:started", a.PlaybackPaused = "playback:paused", a.PlaybackSeeked = "playback:seeked", a.Error = "error", a.PluginLoaded = "plugin:loaded", a.PluginError = "plugin:error", a.PluginUnloaded = "plugin:unloaded", a.ClipActivated = "clip:activated", a.ClipDeactivated = "clip:deactivated", a))(O || {});
 class Xs {
   worker;
   channel;
@@ -1314,7 +1314,7 @@ class Xs {
   }
   setupErrorHandling() {
     this.worker.onerror = (e) => {
-      this.state = "error", this.lastError = new Error(e.message || "Worker error"), this.onError?.(this.lastError), this.eventBus.emit(z.WorkerError, {
+      this.state = "error", this.lastError = new Error(e.message || "Worker error"), this.onError?.(this.lastError), this.eventBus.emit(O.WorkerError, {
         type: this.type,
         workerId: this.getWorkerId(),
         error: this.lastError
@@ -1322,13 +1322,13 @@ class Xs {
     };
   }
   async initialize(e) {
-    this.eventBus.emit(z.WorkerStarted, {
+    this.eventBus.emit(O.WorkerStarted, {
       type: this.type,
       workerId: this.getWorkerId()
     }), await this.channel.send(mt.Configure, {
       config: e,
       initial: !0
-    }), this.eventBus.emit(z.WorkerReady, {
+    }), this.eventBus.emit(O.WorkerReady, {
       type: this.type,
       workerId: this.getWorkerId()
     });
@@ -6166,7 +6166,7 @@ class Ir {
       const l = new kr(), u = h ? this.shouldExtractCover(h) : !1, o = await l.parseFromStream(s, {
         resourceId: r,
         onFirstFrameReady: u ? async (p, m) => {
-          p.resourceId = r, this.cacheManager.mp4IndexCache.set(r, p), this.eventBus?.emit(z.ResourceFirstFrameReady, {
+          p.resourceId = r, this.cacheManager.mp4IndexCache.set(r, p), this.eventBus?.emit(O.ResourceFirstFrameReady, {
             resourceId: r,
             clipId: h,
             index: p,
@@ -6224,8 +6224,8 @@ class Ir {
     const h = this.model?.resources.get(e);
     if (h) {
       const l = h.state;
-      h.state = s, s === "error" ? h.error = r : h.error = void 0, this.eventBus?.emit(z.ResourceStageChange, {
-        type: z.ResourceStageChange,
+      h.state = s, s === "error" ? h.error = r : h.error = void 0, this.eventBus?.emit(O.ResourceStageChange, {
+        type: O.ResourceStageChange,
         resourceId: e,
         oldState: l,
         newState: s
@@ -7365,12 +7365,12 @@ class Nr {
    */
   addFrame(e, s, r, h, l) {
     const u = this.videoL1Cache.addFrame(e, s, r, h, l), o = e.timestamp ?? 0;
-    return this.checkAndNotifyClipReady(s, o), l === 0 && this.eventBus?.emit(z.CacheCover, {
+    return this.checkAndNotifyClipReady(s, o), l === 0 && this.eventBus?.emit(O.CacheCover, {
       timeUs: l,
       clipId: s,
       level: "L1",
       size: u.sizeEstimate ?? 0
-    }), this.eventBus?.emit(z.ComposeFrameReady, {
+    }), this.eventBus?.emit(O.ComposeFrameReady, {
       timeUs: l,
       frameNumber: Math.floor(l / r),
       renderTimeMs: 0,
@@ -8448,7 +8448,7 @@ class vn {
           if (!ei(u))
             throw new Error(`Clip ${u.id} in audio track is not an audio clip`);
           if (this.deps.cacheManager.audioSampleCache.has(u.resourceId)) {
-            this.activeClips.add(u.id), this.deps.eventBus.emit(z.ClipActivated, { clipId: u.id });
+            this.activeClips.add(u.id), this.deps.eventBus.emit(O.ClipActivated, { clipId: u.id });
             continue;
           }
           try {
@@ -8462,7 +8462,7 @@ class vn {
               continue;
             throw o;
           }
-          this.activeClips.add(u.id), this.deps.eventBus.emit(z.ClipActivated, { clipId: u.id });
+          this.activeClips.add(u.id), this.deps.eventBus.emit(O.ClipActivated, { clipId: u.id });
         }
       }
   }
@@ -11442,7 +11442,7 @@ class zo {
           await new Promise((T) => setTimeout(T, 100));
         }
     }, x = s.width || e.renderConfig?.width || 720, C = s.height || e.renderConfig?.height || 1280, v = s.fps || e.fps || 30;
-    l.emit(z.ExportStart, {
+    l.emit(O.ExportStart, {
       format: s.format || "mp4",
       width: x,
       height: C,
@@ -11456,7 +11456,7 @@ class zo {
         requestedFormat: s.format ?? "mp4",
         requestedAudioCodec: s.audioCodec ?? "aac"
       });
-      n && l.emit(z.ExportProgress, {
+      n && l.emit(O.ExportProgress, {
         progress: 0.4,
         stage: "encoding",
         message: n
@@ -11481,7 +11481,7 @@ class zo {
         try {
           await f;
         } catch (y) {
-          l.emit(z.ExportProgress, {
+          l.emit(O.ExportProgress, {
             progress: 0.95,
             stage: "encoding",
             message: `Audio skipped (runtime failure): ${y instanceof Error ? y.message : String(y)}`
@@ -11492,16 +11492,16 @@ class zo {
       if (await h.finalizeExportAudio(), o?.aborted)
         throw new DOMException("Export aborted", "AbortError");
       const d = await r.finalize();
-      return l.emit(z.ExportComplete, {
+      return l.emit(O.ExportComplete, {
         size: d?.size ?? g,
         durationMs: e.durationUs / 1e3,
         format: s.format || "mp4"
-      }), l.emit(z.ExportProgress, {
+      }), l.emit(O.ExportProgress, {
         progress: 1,
         stage: "muxing"
       }), d;
     } catch (T) {
-      throw l.emit(z.ExportError, {
+      throw l.emit(O.ExportError, {
         error: T instanceof Error ? T : new Error(String(T)),
         stage: "export"
       }), T;
@@ -11513,7 +11513,7 @@ class zo {
    * Preload all resources (0-40% progress)
    */
   async preloadResources(e, s, r, h) {
-    r.emit(z.ExportProgress, {
+    r.emit(O.ExportProgress, {
       progress: 0,
       stage: "preparing",
       message: "Loading and parsing resources..."
@@ -11538,7 +11538,7 @@ class zo {
         }
         g++;
         const C = m > 0 ? g / m * 0.4 : 0.4;
-        r.emit(z.ExportProgress, {
+        r.emit(O.ExportProgress, {
           progress: C,
           stage: "preparing",
           message: `Loading resources... (${g}/${m})`
@@ -11601,7 +11601,7 @@ class zo {
                     });
                     s.writeVideoChunk(U, y), u = k + _;
                     const I = 0.4 + k / r.durationUs * 0.6;
-                    this.deps.eventBus.emit(z.ExportProgress, {
+                    this.deps.eventBus.emit(O.ExportProgress, {
                       progress: Math.min(1, I),
                       stage: "encoding",
                       timeUs: k
@@ -11709,7 +11709,7 @@ class Oo {
     }), this.setupResourceFirstFrameHandler();
   }
   setupResourceFirstFrameHandler() {
-    this.eventBus.on(z.ResourceFirstFrameReady, async (e) => {
+    this.eventBus.on(O.ResourceFirstFrameReady, async (e) => {
       const { resourceId: s, clipId: r, index: h, chunks: l } = e;
       if (!this.compositionModel) return;
       const u = this.compositionModel.findClip(r);
@@ -11745,7 +11745,7 @@ class Oo {
   async setCompositionModel(e) {
     this.cacheManager.clear(), this.cancelActiveDecoding(), this.audio.preview.stopPlayback(), this.audio.preview.invalidatePreviewMixCache(), this.modelToken++, this.compositionModel = e, this.planner.setModel(e);
     const s = this.resourceLoader.setModel(e);
-    this.audio.prepare.setModel(e), await s, this.eventBus.emit(z.ModelSet, e), this.eventBus.emit(z.CompositionUpdated, {
+    this.audio.prepare.setModel(e), await s, this.eventBus.emit(O.ModelSet, e), this.eventBus.emit(O.CompositionUpdated, {
       trackCount: e.tracks.length,
       clipCount: e.tracks.reduce((r, h) => r + h.clips.length, 0),
       durationUs: e.durationUs
@@ -11755,7 +11755,7 @@ class Oo {
     if (!this.compositionModel)
       throw new Error("No composition model set");
     const s = tr(this.compositionModel, e);
-    this.planner.applyPatch(e, s), this.eventBus.emit(z.PatchApplied, {
+    this.planner.applyPatch(e, s), this.eventBus.emit(O.PatchApplied, {
       operations: e.operations.length,
       affectedClips: Array.from(s)
     });
@@ -12083,7 +12083,7 @@ class Oo {
     return l;
   }
 }
-var O = /* @__PURE__ */ ((a) => (a.Idle = "idle", a.Buffering = "buffering", a.Playing = "playing", a.Paused = "paused", a.Seeking = "seeking", a.Ended = "ended", a))(O || {});
+var z = /* @__PURE__ */ ((a) => (a.Idle = "idle", a.Buffering = "buffering", a.Playing = "playing", a.Paused = "paused", a.Seeking = "seeking", a.Ended = "ended", a))(z || {});
 const j = {
   Play: "play",
   Pause: "pause",
@@ -13282,7 +13282,7 @@ class Jo {
   }
 }
 class ea {
-  state = O.Idle;
+  state = z.Idle;
   wantsPlay = !1;
   frozenTimeUs = null;
   token = 0;
@@ -13309,13 +13309,13 @@ class ea {
     };
     switch (e.type) {
       case j.ModelSet:
-        return h(), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), o(null), (this.state === O.Playing || this.state === O.Buffering || this.state === O.Seeking) && l(O.Paused), { token: this.token, commands: r };
+        return h(), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), o(null), (this.state === z.Playing || this.state === z.Buffering || this.state === z.Seeking) && l(z.Paused), { token: this.token, commands: r };
       case j.Play: {
         const g = h(), w = this.state;
-        if (u(!0), this.state === O.Ended && p(0), this.state === O.Playing)
+        if (u(!0), this.state === z.Ended && p(0), this.state === z.Playing)
           return { token: g, commands: r };
-        l(O.Playing), o(null), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), r.push({ type: P.CancelRaf });
-        const x = w === O.Idle || w === O.Ended ? O.Idle : O.Paused;
+        l(z.Playing), o(null), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), r.push({ type: P.CancelRaf });
+        const x = w === z.Idle || w === z.Ended ? z.Idle : z.Paused;
         return r.push({
           type: P.Try,
           logPrefix: "[PlaybackController] Failed to start playback:",
@@ -13335,7 +13335,7 @@ class ea {
               { type: P.StartAudioPlayback, timeUs: s.currentTimeUs },
               { type: P.SyncTimeBaseToAudioClock, timeUs: s.currentTimeUs },
               { type: P.StartRafLoop },
-              { type: P.Emit, event: z.PlaybackPlay }
+              { type: P.Emit, event: O.PlaybackPlay }
             ]
           }
         }), { token: g, commands: r };
@@ -13343,13 +13343,13 @@ class ea {
       case j.Pause: {
         h();
         const g = this.state;
-        return u(!1), o(null), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), g !== O.Idle && g !== O.Ended && l(O.Paused), (g === O.Playing || g === O.Buffering || g === O.Seeking) && r.push({ type: P.Emit, event: z.PlaybackPause }), { token: this.token, commands: r };
+        return u(!1), o(null), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), g !== z.Idle && g !== z.Ended && l(z.Paused), (g === z.Playing || g === z.Buffering || g === z.Seeking) && r.push({ type: P.Emit, event: O.PlaybackPause }), { token: this.token, commands: r };
       }
       case j.Stop:
-        return h(), u(!1), o(null), l(O.Idle), p(0), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), r.push({ type: P.ClearCanvas }), r.push({ type: P.ResetAudioSession }), r.push({ type: P.ResetAudioPlaybackStates }), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), r.push({ type: P.Emit, event: z.PlaybackStop }), { token: this.token, commands: r };
+        return h(), u(!1), o(null), l(z.Idle), p(0), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), r.push({ type: P.ClearCanvas }), r.push({ type: P.ResetAudioSession }), r.push({ type: P.ResetAudioPlaybackStates }), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), r.push({ type: P.Emit, event: O.PlaybackStop }), { token: this.token, commands: r };
       case j.Seek: {
         const g = h(), w = this.state, x = m(e.timeUs, e.durationUs);
-        return p(x), o(x), l(O.Seeking), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), r.push({
+        return p(x), o(x), l(z.Seeking), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), r.push({
           type: P.Try,
           logPrefix: "[PlaybackController] Seek error:",
           emitPlaybackError: !0,
@@ -13380,7 +13380,7 @@ class ea {
         }), { token: g, commands: r };
       }
       case j.EnterBuffering:
-        return (e.bumpToken ?? !1) && h(), this.state !== O.Playing ? { token: this.token, commands: r } : (o(e.timeUs), l(O.Buffering), r.push({ type: P.Emit, event: z.PlaybackBuffering }), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), r.push({
+        return (e.bumpToken ?? !1) && h(), this.state !== z.Playing ? { token: this.token, commands: r } : (o(e.timeUs), l(z.Buffering), r.push({ type: P.Emit, event: O.PlaybackBuffering }), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), r.push({
           type: P.Try,
           logPrefix: "[PlaybackController] Buffering error:",
           emitPlaybackError: !0,
@@ -13409,11 +13409,11 @@ class ea {
           }
         }), { token: this.token, commands: r });
       case j.BufferingResolved:
-        return this.state !== O.Buffering ? { token: this.token, commands: r } : (o(null), this.wantsPlay ? (l(O.Playing), r.push({
+        return this.state !== z.Buffering ? { token: this.token, commands: r } : (o(null), this.wantsPlay ? (l(z.Playing), r.push({
           type: P.Try,
           logPrefix: "[PlaybackController] Failed to start playback:",
           emitPlaybackError: !0,
-          onError: { type: j.StartFailed, fallbackState: O.Paused },
+          onError: { type: j.StartFailed, fallbackState: z.Paused },
           command: {
             type: P.Seq,
             commands: [
@@ -13422,20 +13422,20 @@ class ea {
               { type: P.StartAudioPlayback, timeUs: e.timeUs },
               { type: P.SyncTimeBaseToAudioClock, timeUs: e.timeUs },
               { type: P.StartRafLoop },
-              { type: P.Emit, event: z.PlaybackPlay }
+              { type: P.Emit, event: O.PlaybackPlay }
             ]
           }
-        })) : l(O.Paused), { token: this.token, commands: r });
+        })) : l(z.Paused), { token: this.token, commands: r });
       case j.SeekResolved:
-        return this.state !== O.Seeking ? { token: this.token, commands: r } : (o(null), r.push({
+        return this.state !== z.Seeking ? { token: this.token, commands: r } : (o(null), r.push({
           type: P.Emit,
-          event: z.PlaybackSeek,
+          event: O.PlaybackSeek,
           payload: { timeUs: s.currentTimeUs }
-        }), this.wantsPlay ? (l(O.Playing), r.push({
+        }), this.wantsPlay ? (l(z.Playing), r.push({
           type: P.Try,
           logPrefix: "[PlaybackController] Failed to start playback:",
           emitPlaybackError: !0,
-          onError: { type: j.StartFailed, fallbackState: O.Paused },
+          onError: { type: j.StartFailed, fallbackState: z.Paused },
           command: {
             type: P.Seq,
             commands: [
@@ -13448,16 +13448,16 @@ class ea {
               { type: P.StartAudioPlayback, timeUs: s.currentTimeUs },
               { type: P.SyncTimeBaseToAudioClock, timeUs: s.currentTimeUs },
               { type: P.StartRafLoop },
-              { type: P.Emit, event: z.PlaybackPlay }
+              { type: P.Emit, event: O.PlaybackPlay }
             ]
           }
         })) : l(
-          e.previousState === O.Idle ? O.Idle : O.Paused
+          e.previousState === z.Idle ? z.Idle : z.Paused
         ), { token: this.token, commands: r });
       case j.StartFailed:
         return u(!1), o(null), l(e.fallbackState), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), { token: this.token, commands: r };
       case j.ClockTick: {
-        if (this.state !== O.Playing)
+        if (this.state !== z.Playing)
           return { token: this.token, commands: r };
         if (this.frozenTimeUs !== null)
           return { token: this.token, commands: r };
@@ -13465,13 +13465,13 @@ class ea {
         return g >= e.durationUs ? (e.loop ? (p(0), r.push({
           type: P.SetStartTimeBase,
           startTimeUs: e.audioNowUs
-        }), r.push({ type: P.ResetAudioPlaybackStates }), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), r.push({ type: P.InitWindow, timeUs: 0 })) : (u(!1), l(O.Ended), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), p(0), r.push({
+        }), r.push({ type: P.ResetAudioPlaybackStates }), r.push({ type: P.SetLastAudioScheduleTime, timeUs: 0 }), r.push({ type: P.InitWindow, timeUs: 0 })) : (u(!1), l(z.Ended), r.push({ type: P.CancelRaf }), r.push({ type: P.StopAudio }), p(0), r.push({
           type: P.Emit,
-          event: z.PlaybackEnded,
+          event: O.PlaybackEnded,
           payload: { timeUs: e.durationUs }
         })), { token: this.token, commands: r }) : (p(g), r.push({
           type: P.Emit,
-          event: z.PlaybackTimeUpdate,
+          event: O.PlaybackTimeUpdate,
           payload: { timeUs: g }
         }), { token: this.token, commands: r });
       }
@@ -13511,8 +13511,11 @@ class ta {
   seekFlushRafId = null;
   seekInFlight = null;
   // If user drags far away while a seek is decoding, cancel it to avoid visible lag.
-  SEEK_CANCEL_DISTANCE_US = 5e5;
-  // 500ms
+  SEEK_CANCEL_DISTANCE_US = 5e6;
+  // 5s
+  isSeekActive() {
+    return this.pendingSeekTimeUs !== null || this.seekInFlight !== null || this.fsm.snapshot.state === z.Seeking;
+  }
   // Unified window management for both video and audio
   windowEnd = 0;
   WINDOW_DURATION = 3e6;
@@ -13575,25 +13578,25 @@ class ta {
     this.seekInFlight = { targetUs: e, done: s }, s.finally(() => {
       const r = this.pendingSeekWaiters;
       this.pendingSeekWaiters = [];
-      for (const h of r) h();
-      this.seekInFlight?.targetUs === e && (this.seekInFlight = null), this.pendingSeekTimeUs === null && !this.orchestrator.cacheManager.isExporting && this.preheatNextWindow(), this.pendingSeekTimeUs !== null && this.seekFlushRafId === null && (this.seekFlushRafId = requestAnimationFrame(() => {
+      for (const l of r) l();
+      this.seekInFlight?.targetUs === e && (this.seekInFlight = null), this.pendingSeekTimeUs === null && !this.orchestrator.cacheManager.isExporting && this.fsm.snapshot.state === z.Playing && this.preheatNextWindow(), this.pendingSeekTimeUs !== null && this.seekFlushRafId === null && (this.seekFlushRafId = requestAnimationFrame(() => {
         this.seekFlushRafId = null, this.flushCoalescedSeek();
       }));
     });
   }
   setRate(e) {
     const s = this.currentTimeUs;
-    this.playbackRate = e, this.startTimeUs = this.audioContext.currentTime * 1e6 - s / e, this.audioSession.setPlaybackRate(this.playbackRate), this.eventBus.emit(z.PlaybackRateChange, { rate: e });
+    this.playbackRate = e, this.startTimeUs = this.audioContext.currentTime * 1e6 - s / e, this.audioSession.setPlaybackRate(this.playbackRate), this.eventBus.emit(O.PlaybackRateChange, { rate: e });
   }
   setVolume(e) {
-    this.volume = Math.max(0, Math.min(1, e)), this.audioSession.setVolume(this.volume), this.eventBus.emit(z.PlaybackVolumeChange, { volume: this.volume });
+    this.volume = Math.max(0, Math.min(1, e)), this.audioSession.setVolume(this.volume), this.eventBus.emit(O.PlaybackVolumeChange, { volume: this.volume });
   }
   setMute(e) {
     if (e) {
       this.audioSession.stopPlayback();
       return;
     }
-    this.fsm.snapshot.state === O.Playing && this.audioSession.startPlayback(this.currentTimeUs, this.audioContext);
+    this.fsm.snapshot.state === z.Playing && this.audioSession.startPlayback(this.currentTimeUs, this.audioContext);
   }
   setLoop(e) {
     this.loop = e;
@@ -13602,7 +13605,7 @@ class ta {
     return this.orchestrator.compositionModel?.durationUs ?? 0;
   }
   get isPlaying() {
-    return this.fsm.snapshot.state === O.Playing;
+    return this.fsm.snapshot.state === z.Playing;
   }
   resume() {
     this.play();
@@ -13657,7 +13660,7 @@ class ta {
                   p instanceof Nt || // Missing moov may be caused by incomplete/corrupted cache and can be retried via recovery.
                   p instanceof Le
                 );
-                this.eventBus.emit(z.PlaybackError, p), this.eventBus.emit(z.Error, {
+                this.eventBus.emit(O.PlaybackError, p), this.eventBus.emit(O.Error, {
                   source: "playback",
                   error: p,
                   context: {
@@ -13764,7 +13767,7 @@ class ta {
           return;
         }
         case P.StartRafLoop: {
-          this.startPlaybackLoop(s);
+          this.startPlaybackLoop(s), !this.orchestrator.cacheManager.isExporting && this.fsm.snapshot.state === z.Playing && this.preheatNextWindow();
           return;
         }
       }
@@ -13781,7 +13784,7 @@ class ta {
     });
   }
   async onRafTick(e) {
-    if (!this.isCurrentToken(e) || this.fsm.snapshot.state !== O.Playing)
+    if (!this.isCurrentToken(e) || this.fsm.snapshot.state !== z.Playing)
       return;
     const s = (this.audioContext.currentTime * 1e6 - this.startTimeUs) * this.playbackRate;
     if (this.dispatch({
@@ -13790,7 +13793,7 @@ class ta {
       durationUs: this.duration,
       loop: this.loop,
       audioNowUs: this.audioContext.currentTime * 1e6
-    }), !this.isCurrentToken(e) || this.fsm.snapshot.state !== O.Playing)
+    }), !this.isCurrentToken(e) || this.fsm.snapshot.state !== z.Playing)
       return;
     if (this.currentTimeUs - this.lastAudioScheduleTime >= this.AUDIO_SCHEDULE_INTERVAL && (this.audioSession.scheduleAudio(this.currentTimeUs, this.audioContext), this.lastAudioScheduleTime = this.currentTimeUs), this.audioSession.shouldEnterBufferingForUpcomingPreviewAudio(this.currentTimeUs)) {
       this.audioSession.ensureAudioForTime(this.currentTimeUs, { mode: "probe" }), this.dispatch({
@@ -13803,7 +13806,7 @@ class ta {
     const r = await this.orchestrator.getRenderState(this.currentTimeUs, {
       mode: "probe"
     });
-    if (!(!this.isCurrentToken(e) || this.fsm.snapshot.state !== O.Playing)) {
+    if (!(!this.isCurrentToken(e) || this.fsm.snapshot.state !== z.Playing)) {
       if (!r) {
         if (this.isTerminalVideoErrorAtTime(this.currentTimeUs)) {
           this.clearCanvas(), this.finalizeFrameAndContinue(e);
@@ -13812,11 +13815,11 @@ class ta {
         this.dispatch({ type: j.EnterBuffering, timeUs: this.currentTimeUs });
         return;
       }
-      await this.compose(this.currentTimeUs, r), !(!this.isCurrentToken(e) || this.fsm.snapshot.state !== O.Playing) && this.finalizeFrameAndContinue(e);
+      await this.compose(this.currentTimeUs, r), !(!this.isCurrentToken(e) || this.fsm.snapshot.state !== z.Playing) && this.finalizeFrameAndContinue(e);
     }
   }
   finalizeFrameAndContinue(e) {
-    this.updateFps(), this.frameCount++, this.orchestrator.cacheManager.setWindow(this.currentTimeUs), this.checkAndPreheatWindow(), !(!this.isCurrentToken(e) || this.fsm.snapshot.state !== O.Playing) && this.startPlaybackLoop(e);
+    this.updateFps(), this.frameCount++, this.orchestrator.cacheManager.setWindow(this.currentTimeUs), this.checkAndPreheatWindow(), !(!this.isCurrentToken(e) || this.fsm.snapshot.state !== z.Playing) && this.startPlaybackLoop(e);
   }
   updateFps() {
     const e = performance.now();
@@ -13830,30 +13833,30 @@ class ta {
     this.windowEnd = e + this.WINDOW_DURATION, this.preheatInProgress = !1, this.orchestrator.cacheManager.setWindow(e);
   }
   checkAndPreheatWindow() {
-    if (this.orchestrator.cacheManager.isExporting || this.preheatInProgress || this.fsm.snapshot.state !== O.Playing)
-      return;
-    const e = this.windowEnd - this.currentTimeUs;
-    if (e < 0) {
+    const e = this.orchestrator.cacheManager.isExporting, s = this.preheatInProgress, r = this.fsm.snapshot.state === z.Playing, h = this.windowEnd - this.currentTimeUs;
+    if (h < 0) {
       this.initWindow(this.currentTimeUs);
       return;
     }
-    e > 0 && e <= this.PREHEAT_DISTANCE && this.preheatNextWindow();
+    const l = h > 0 && h <= this.PREHEAT_DISTANCE;
+    e || s || !r || !l || this.isSeekActive() || this.preheatNextWindow();
   }
   async preheatNextWindow() {
-    if (!this.orchestrator.cacheManager.isExporting && !this.preheatInProgress) {
+    const e = this.orchestrator.cacheManager.isExporting, s = this.preheatInProgress;
+    if (!(e || s || this.isSeekActive())) {
       this.preheatInProgress = !0;
       try {
-        const e = this.currentTimeUs, s = e + this.WINDOW_DURATION, r = this.orchestrator.compositionModel?.getClipsInRange(e, s) ?? [], h = [];
-        for (const l of r) {
-          if (!Ut(l)) continue;
-          const u = Math.max(0, e - l.startUs), o = Math.min(l.durationUs, s - l.startUs);
-          u >= o || h.push(
-            this.orchestrator.preheatClipWindow(l.id, u, o, e)
+        const h = this.currentTimeUs, l = h + this.WINDOW_DURATION, u = this.orchestrator.compositionModel?.getClipsInRange(h, l) ?? [], o = [];
+        for (const p of u) {
+          if (!Ut(p)) continue;
+          const m = Math.max(0, h - p.startUs), g = Math.min(p.durationUs, l - p.startUs);
+          m >= g || o.push(
+            this.orchestrator.preheatClipWindow(p.id, m, g, h)
           );
         }
-        await Promise.all(h), this.windowEnd = s;
-      } catch (e) {
-        console.warn("[PlaybackController] Preheat failed:", e);
+        await Promise.all(o), this.windowEnd = l;
+      } catch (h) {
+        console.warn("[PlaybackController] Preheat failed:", h);
       } finally {
         this.preheatInProgress = !1;
       }
@@ -13891,10 +13894,10 @@ class ta {
     const e = this.pendingSeekWaiters;
     this.pendingSeekWaiters = [];
     for (const s of e) s();
-    this.eventBus.off(z.CacheCover, this.onCacheCover), this.eventBus.off(z.ModelSet, this.onModelSet), this.videoComposer && (this.videoComposer.dispose(), this.videoComposer = null);
+    this.eventBus.off(O.CacheCover, this.onCacheCover), this.eventBus.off(O.ModelSet, this.onModelSet), this.videoComposer && (this.videoComposer.dispose(), this.videoComposer = null);
   }
   onCacheCover = () => {
-    this.fsm.snapshot.state === O.Idle && this.currentTimeUs === 0 && this.renderCurrentFrame(0, { mode: "blocking" });
+    this.fsm.snapshot.state === z.Idle && this.currentTimeUs === 0 && this.renderCurrentFrame(0, { mode: "blocking" });
   };
   onModelSet = () => {
     if (!this.videoComposer || !this.orchestrator.compositionModel) return;
@@ -13908,7 +13911,7 @@ class ta {
     }), this.orchestrator.cacheManager.isExporting || this.audioSession.ensureAudioForTime(this.currentTimeUs, { mode: "probe" }), this.renderCurrentFrame(this.currentTimeUs, { mode: "blocking" });
   };
   setupEventListeners() {
-    this.eventBus.on(z.CacheCover, this.onCacheCover), this.eventBus.on(z.ModelSet, this.onModelSet);
+    this.eventBus.on(O.CacheCover, this.onCacheCover), this.eventBus.on(O.ModelSet, this.onModelSet);
   }
   isVideoResourceReadyAtTime(e) {
     const s = this.orchestrator.compositionModel;
@@ -14081,7 +14084,7 @@ class ki {
   async setCompositionModel(e) {
     this.ensureNotDestroyed(), this.playbackController?.pause();
     const s = e instanceof Ui ? e : new Ui(e);
-    await this.orchestrator.setCompositionModel(s), this.model = s, this.setState("ready"), this.eventBus.emit(z.Ready, {
+    await this.orchestrator.setCompositionModel(s), this.model = s, this.setState("ready"), this.eventBus.emit(O.Ready, {
       trackCount: e.tracks.length,
       clipCount: e.tracks.reduce(
         (r, h) => r + h.clips?.length || 0,
@@ -14322,13 +14325,13 @@ async function ra() {
     }
   };
   let _ = 0;
-  if (o.events.on(z.ExportProgress, (b) => {
+  if (o.events.on(O.ExportProgress, (b) => {
     window.runnerReportProgress(b);
     const U = Date.now();
     U - _ >= 1e3 && (_ = U, console.log("[meframe-runner] progress", b));
-  }), o.events.on(z.ExportStart, (b) => {
+  }), o.events.on(O.ExportStart, (b) => {
     console.log("[meframe-runner] export:start", b);
-  }), o.events.on(z.ExportComplete, (b) => {
+  }), o.events.on(O.ExportComplete, (b) => {
     console.log("[meframe-runner] export:complete", b);
   }), console.log("[meframe-runner] export()..."), await o.export({
     ...s,

package/docs/INTEGRATION.md

@@ -71,6 +71,13 @@ WebCodecs 等 API 需要 secure/trustworthy origin。`exportToStore({ pageUrl })
 
 > 核心原则：`CompositionModelData.resources[*].uri`、`workerPath` 指向的文件，都必须能在 Chromium 里直接 `fetch()`/加载到。
 
+新增（默认行为）：
+
+- 若 `exportToStore({ workerPath })` **未提供**，`@meframe/server` 会临时启动一个本地 HTTP 服务，
+  自动托管 `@meframe/core/dist/workers` 并把它的 base URL 作为 `workerPath` 注入到 runner。
+- 你可以通过 `ServerExporterOptions.workerServer.enabled = false` 关闭该行为，或用
+  `ServerExporterOptions.workerServer.workerDir` 指向自定义目录。
+
 #### 2.4 音频（AAC）能力说明（强烈建议阅读）
 
 当前 `mp4` 输出的音频轨 **只能是 AAC**（对应 WebCodecs `AudioEncoder` 的 `codec: 'mp4a.40.2'`）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meframe/server",
-  "version": "0.0.9",
+  "version": "0.1.0",
   "description": "Server-side exporter for @meframe/core (browser-driven, multipart upload via injected store)",
   "type": "module",
   "main": "./dist/esm/index.js",
@@ -20,7 +20,7 @@
   ],
   "dependencies": {
     "puppeteer-core": "^23.5.0",
-    "@meframe/core": "0.3.1"
+    "@meframe/core": "0.3.2"
   },
   "devDependencies": {
     "@aws-sdk/client-s3": "^3.758.0",