supervision 0.2.0-next.0 → 0.2.0-next.1

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

@@ -1,5 +1,5 @@
 import { type MediaClock } from "./clock";
-import type { FrameLanding } from "./frame-timeline";
+import type { FrameId, FrameLanding } from "./frame-timeline";
 import { type EngineDiagnostics } from "./diagnostics";
 import { type SeekIntent } from "./scrub-cursor";
 import { type EngineTrace } from "./trace-recorder";
@@ -82,6 +82,7 @@ export declare class EngineCore {
      *  so without the target on it any leftover frame answers for the seek in
      *  flight and publishes itself as the playhead. */
     private awaitedSeek;
+    private seekGeneration;
     /** 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. */
     private playSeekStartedAtMs;
@@ -91,7 +92,11 @@ export declare class EngineCore {
     private playSeekMaxMs;
     /** The frame the last paint put up, for the diagnostics screen readout. */
     private lastPaintedId;
-    /** Mirrors VideoEngine's interactive-seek latch: true when a drag paused a
+    /** Last frame the host confirmed reached its display surface. */
+    private lastHostFrame;
+    /** Rejects an older refresh that completes after a newer one in one epoch. */
+    private lastHostPaintSeq;
+    /** Mirrors WebVideoEngine's interactive-seek latch: true when a drag paused a
      *  playing engine, so endInteractiveSeek knows to resume. */
     private resumeAfterInteractiveSeek;
     /** Worker-realm broadcast timer handle, or null when diagnostics are off. */
@@ -160,13 +165,11 @@ export declare class EngineCore {
      *  exported trace shows the playback-state timeline alongside paints/seeks. */
     private emitStatus;
     /**
-     * The decoder cannot decode this source, and nothing else was going to say
-     * so: a stalled decoder keeps accepting commands and the clock keeps
-     * running, so playback reads as healthy over a canvas that will never change
-     * again. Stop the transport first, then report, so the status a consumer
-     * sees and what the engine is doing agree.
+     * The runtime can no longer deliver pixels, whether decoding stopped or the
+     * frames handoff failed. Stop the transport first, then report, so the status
+     * a consumer sees and what the engine is doing agree.
      */
-    private handleDecodeFailure;
+    private handleTerminalFailure;
     /** Says the failure again for whoever just asked the transport to move. A
      *  consumer that only listens for changes has already been told; one that
      *  reads the status after its own command has to find the same answer. */
@@ -175,7 +178,7 @@ export declare class EngineCore {
     endInteractiveSeek(): void;
     dispose(): Promise<void>;
     /** True only when the cursor exists and reports settled. Mirrors
-     *  VideoEngine.isIdle for tests; the facade derives its own from state. */
+     *  WebVideoEngine.isIdle for tests; the facade derives its own from state. */
     isIdle(): boolean;
     /** Engine diagnostics snapshot (renderer, track facts, scheduler stats), or
      *  null before load. The scheduler field is null on the uncached cursor. */
@@ -183,7 +186,12 @@ export declare class EngineCore {
     private observeSeekIdle;
     private handleEnded;
     private awaitSeekLanding;
+    private isCurrentSeek;
     private forgetSeekLanding;
+    private abandonAwaitedSeek;
+    /** Ends an impossible landing. Awaitable movement rejects with the engine's
+     *  terminal error; a scrub has no consumer, so it is released quietly. */
+    private failAwaitedSeek;
     /** Releases the latch of a seek that has already answered its caller. The
      *  landing rode back on the return value, so a paint arriving after it would
      *  move the playhead to somewhere the caller was never told about. */
@@ -200,7 +208,6 @@ export declare class EngineCore {
     /** The frame table of the loaded source. Reached only from paths that have
      *  already established a cursor, which is what carries it. */
     private timeline;
-    private landingOf;
     /**
      * Points the background walk at where the viewer is, as a byte offset. The
      * file's own byte layout is not exposed, so this reads position as a share of
@@ -209,6 +216,11 @@ export declare class EngineCore {
      */
     private aimResidency;
     private onPaint;
+    /** Makes only a frame the host actually rendered authoritative for playback
+     *  time and pause settlement. An older navigation or refresh cannot move the
+     *  clock backward after a newer frame has won. */
+    acknowledgePresentedFrame(paintSeq: number, frameId: FrameId, navigationGeneration: number): void;
+    private beginPresentationGeneration;
     /**
      * Posts one frame with the identity of the paint it came from, in the same
      * message. With no sink wired there is no receiver, so the frame is closed
@@ -255,4 +267,3 @@ export declare class EngineCore {
     private devicePixelRatio;
     private traceEnvironment;
 }
-//# sourceMappingURL=engine-core.d.ts.map

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

@@ -1,5 +1,5 @@
-export { VideoEngine } from "./video-engine";
-export type { VideoEngineHandle, VideoEngineOptions } from "./video-engine";
+export { WebVideoEngine } from "./video-engine";
+export type { WebVideoEngineHandle, WebVideoEngineOptions, } from "./video-engine";
 export { SourceKind } from "./types";
 export type { BlobVideoSource, StreamVideoSource, UrlSourceReadConfig, UrlVideoSource, VideoMetadata, VideoSource, } from "./types";
 export { PlaybackStatus } from "./types";
@@ -18,9 +18,8 @@ export { asFps, asPaintSeq, asSec } from "./types";
 export type { Fps, Sec } from "./types";
 export { cappedResolution, displayBoxResolution, nativeResolution, viewportResolution, } from "./decode-resolution";
 export type { DecodeResolutionStrategy, DisplayBoxResolutionOptions, ViewportResolutionOptions, } from "./decode-resolution";
-export { VideoEngineError, VideoEngineErrorCode } from "./types";
+export { WebVideoEngineError, WebVideoEngineErrorCode } from "./types";
 export type { Warning, WarningSeverity } from "./diagnostics";
 export type { DiagnosticsSnapshot, SourceResidencyDiagnostics, } from "./diagnostics";
 export type { SourceResidencyConfig } from "./worker-protocol";
 export { DIAGNOSTICS, TRACE_RING_BOUNDS } from "./constants";
-//# sourceMappingURL=engine.d.ts.map