@twick/2d 0.15.17 → 0.15.18

package/dist/index.cjs

@@ -5502,6 +5502,8 @@ var Media = class extends Rect {
     super(props);
     this.lastTime = -1;
     this.isSchedulingPlay = false;
+    /** Used with clipStart for sync (trim offset in source). */
+    this.trimStart = 0;
     if (!this.awaitCanPlay()) {
       setTimeout(() => this.scheduleSeek(this.time()), 0);
     }
@@ -5509,6 +5511,8 @@ var Media = class extends Rect {
       this.play();
     }
     this.volume = props.volume ?? 1;
+    this.clipStart = props.clipStart;
+    this.trimStart = props.trimStart ?? 0;
     if (!this.awaitCanPlay()) {
       this.setVolume(this.volume);
     }
@@ -5550,14 +5554,27 @@ var Media = class extends Rect {
   }
   /**
    * Sync the underlying media element to the given time (e.g. draw/playback time).
-   * When `time` is passed (e.g. from Scene2D.draw), that value is used so sync
-   * does not depend on the node's time signal (which may only update on projectData change).
+   * Used for both Video and Audio. When `time` is passed (e.g. from Scene2D.draw), that
+   * value is used so sync does not depend on the node's time signal.
+   * If this node has clipStart set, global time is converted to clip-relative time:
+   * syncTime = trimStart + (time - clipStart) * playbackRate.
    * When omitted, falls back to this.time().
-   * Uses skipCollectPromise so we don't leave a promise in DependencyContext.
+   * When waitForSeek is true, returns a promise that resolves when the seek completes so
+   * the draw can wait and show the correct frame/sample when paused.
    */
-  syncToCurrentTime(time) {
-    const syncTime = time ?? this.time();
-    this.setCurrentTime(syncTime, { skipCollectPromise: true });
+  syncToCurrentTime(time, options) {
+    let syncTime;
+    if (time !== void 0 && this.clipStart !== void 0) {
+      syncTime = this.trimStart + (time - this.clipStart) * this.playbackRate();
+    } else {
+      syncTime = time ?? this.time();
+    }
+    const promise = this.setCurrentTime(syncTime, {
+      skipCollectPromise: options?.waitForSeek ?? true
+    });
+    if (options?.waitForSeek) {
+      return promise;
+    }
   }
   setCurrentTime(value, options) {
     try {
@@ -5566,30 +5583,41 @@ var Media = class extends Rect {
       if (media.readyState < 2) {
         this.lastTime = value;
         this.time(value);
-        this.waitForCanPlay(media, () => {
-          media.currentTime = value;
-          this.lastTime = value;
-          this.time(value);
+        return new Promise((resolve) => {
+          this.waitForCanPlay(media, () => {
+            media.currentTime = value;
+            this.lastTime = value;
+            this.time(value);
+            const onSeeked = () => {
+              media.removeEventListener("seeked", onSeeked);
+              resolve();
+            };
+            if (media.seeking) {
+              media.addEventListener("seeked", onSeeked);
+            } else {
+              resolve();
+            }
+          });
         });
-        return;
       }
       media.currentTime = value;
       this.lastTime = value;
       this.time(value);
+      const seekPromise = media.seeking ? new Promise((resolve) => {
+        const listener = () => {
+          resolve();
+          media.removeEventListener("seeked", listener);
+        };
+        media.addEventListener("seeked", listener);
+      }) : Promise.resolve();
       if (media.seeking && !options?.skipCollectPromise) {
-        import_core32.DependencyContext.collectPromise(
-          new Promise((resolve) => {
-            const listener = () => {
-              resolve();
-              media.removeEventListener("seeked", listener);
-            };
-            media.addEventListener("seeked", listener);
-          })
-        );
+        import_core32.DependencyContext.collectPromise(seekPromise);
       }
+      return seekPromise;
     } catch (error) {
       this.lastTime = value;
       this.time(value);
+      return Promise.resolve();
     }
   }
   setVolume(volume) {
@@ -10729,7 +10757,7 @@ var Scene2D = class extends import_core60.GeneratorScene {
     this.renderLifecycle.dispatch([import_core60.SceneRenderEvent.BeginRender, context]);
     this.getView().playbackState(this.playback.state).globalTime(this.playback.time).fps(this.playback.fps);
     if (this.playback.state === import_core60.PlaybackState.Paused) {
-      this.syncAllMediaToCurrentTime();
+      await this.syncAllMediaToCurrentTime(true);
     }
     await this.getView().render(context);
     this.renderLifecycle.dispatch([import_core60.SceneRenderEvent.FinishRender, context]);
@@ -10862,23 +10890,31 @@ var Scene2D = class extends import_core60.GeneratorScene {
     return returnObjects;
   }
   /**
-   * Seek all registered Media nodes to the current playback time.
-   * Passes draw time (playback.time) so media sync does not depend on node time signal.
+   * Seek all registered Media nodes (Video and Audio) to the current playback time.
+   * Passes draw time; nodes with clipStart convert it to clip-relative time.
+   * When waitForSeek is true, waits for each media seek to complete so the next draw shows the correct frame/sample.
    */
-  syncAllMediaToCurrentTime() {
+  async syncAllMediaToCurrentTime(waitForSeek) {
     const drawTime = this.playback.time;
     const mediaNodes = Array.from(this.registeredNodes.values()).filter(
       (node) => node instanceof Media
     );
-    for (const media of mediaNodes) {
+    const results = mediaNodes.map((media) => {
       try {
-        media.syncToCurrentTime(drawTime);
+        return media.syncToCurrentTime(drawTime, { waitForSeek });
       } catch (e) {
         this.logger.warn({
           message: `syncAllMediaToCurrentTime: skipped node ${media.key ?? "unknown"}`,
           object: e
         });
+        return void 0;
       }
+    });
+    if (waitForSeek) {
+      const promises = results.filter(
+        (p) => p !== void 0
+      );
+      await Promise.all(promises);
     }
   }
   stopAllMedia() {