supervision 0.2.0-next.2 → 0.2.0-next.3

package/dist/web-video-engine/engine.worker.js

@@ -27770,12 +27770,16 @@
          * lands on that frame and no other. Nothing here walks, compares or skips,
          * so a step across a frame boundary needs no epsilon.
          */
-        async seekToFrame(frame) {
+        async seekToFrame(frame, isPresentationCurrent) {
             if (this.closed)
                 return null;
+            this.outputGeneration += 1;
             const outputGeneration = this.outputGeneration;
             const decoded = await this.trackOutputRead(this.provider.getFrame(this.trackInfo.timeline.timeAt(frame.index)));
-            if (this.closed || outputGeneration !== this.outputGeneration || !decoded) {
+            if (this.closed ||
+                outputGeneration !== this.outputGeneration ||
+                isPresentationCurrent?.() === false ||
+                !decoded) {
                 if (decoded?.kind === "sample")
                     decoded.sample.close();
                 return null;
@@ -29194,14 +29198,18 @@
          * reuses whatever decode position the session already holds, with no
          * iterator opened per press.
          */
-        async seekToFrame(frame) {
+        async seekToFrame(frame, isPresentationCurrent) {
             if (this.closed)
                 return null;
+            this.outputGeneration += 1;
             this.enterMode(AccessMode.Stepping);
             this.abandonPrefetch();
             const outputGeneration = this.outputGeneration;
             const decoded = await this.withDecodeWatchdog(this.provider.getFrame(this.trackInfo.timeline.timeAt(frame.index)));
-            if (this.closed || outputGeneration !== this.outputGeneration || !decoded) {
+            if (this.closed ||
+                outputGeneration !== this.outputGeneration ||
+                isPresentationCurrent?.() === false ||
+                !decoded) {
                 if (decoded?.kind === "sample")
                     decoded.sample.close();
                 return null;
@@ -32650,6 +32658,7 @@ ${VERTEX_STAGE}
          *  flight and publishes itself as the playhead. */
         awaitedSeek = null;
         seekGeneration = 0;
+        stepCommandGeneration = 0;
         /** Wall stamp of a seek being served by re-anchoring the playback walk, or
          *  null when no such seek is waiting on its crisp frame. */
         playSeekStartedAtMs = null;
@@ -32947,6 +32956,7 @@ ${VERTEX_STAGE}
                 this.playing = true;
                 return;
             }
+            this.stepCommandGeneration += 1;
             // Resume-from-end: a play after the clock crossed duration would tick
             // straight to Ended. Snap back to 0 first.
             const durS = this.durationMs / 1000;
@@ -32994,6 +33004,7 @@ ${VERTEX_STAGE}
                     });
                 }
             }
+            this.stepCommandGeneration += 1;
             this.controller?.endPlay();
             if (wasPlaying && !this.displayResize)
                 this.abandonAwaitedSeek();
@@ -33247,9 +33258,14 @@ ${VERTEX_STAGE}
             const target = timeline.landingAt(base.index + direction);
             if (target.frame.index === base.index)
                 return null;
-            this.beginPresentationGeneration();
-            const next = await this.cursor.seekToFrame(target.frame);
-            if (!next)
+            this.abandonAwaitedSeek();
+            const commandGeneration = ++this.stepCommandGeneration;
+            const generation = this.beginPresentationGeneration();
+            const next = await this.cursor.seekToFrame(target.frame, () => this.isCurrentSeek(generation) &&
+                commandGeneration === this.stepCommandGeneration);
+            if (!next ||
+                !this.isCurrentSeek(generation) ||
+                commandGeneration !== this.stepCommandGeneration)
                 return null;
             this.lastStepLanded = target.frame;
             this.clock.seek(target.mediaTimeS);

package/dist/web-video-engine/scrub-cursor.d.ts

@@ -301,12 +301,10 @@ export interface ScrubCursor {
     /** Detach the forward-playback iterator. */
     detachPlay(): void;
     /**
-     * Decode the named frame of the source and emit it through the listener
-     * chain. Returns the emitted ScrubFrame, or null at a boundary or once
-     * closed. Steps are index arithmetic on the frame table, so a caller names
-     * the frame it wants and not a time near it.
+     * Pending output is released without listener delivery when
+     * isPresentationCurrent returns false after decode.
      */
-    seekToFrame(frame: FrameId): Promise<ScrubFrame | null>;
+    seekToFrame(frame: FrameId, isPresentationCurrent?: () => boolean): Promise<ScrubFrame | null>;
     idle(): Promise<void>;
     /**
      * Resolves at the seek drain's next settle: whichever target it is servicing

package/dist/web-video-engine/video-engine.d.ts

@@ -133,6 +133,8 @@ export declare class WebVideoEngine {
     private timeline;
     private transferredCanvas;
     private presentedFrameHandler;
+    private navigationIntent;
+    private stepIntent;
     /** Deliveries counted toward the one frame-ownership check, frozen past it,
      *  and the frame that check reads. Weak, so watching costs the frame no
      *  lifetime: a host that closes and drops it leaves nothing to find, which is
@@ -226,6 +228,8 @@ export declare class WebVideoEngine {
      */
     step: (direction: 1 | -1) => Promise<void>;
     private runStep;
+    private beginNavigationIntent;
+    private beginStepIntent;
     /**
      * Settled iff the engine is between operations. Derived from mirror state
      * rather than the cursor (which lives in the worker): Idle/Loading read as

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supervision",
-  "version": "0.2.0-next.2",
+  "version": "0.2.0-next.3",
   "description": "Browser-native computer vision media rendering and annotation engine.",
   "repository": {
     "type": "git",