supervision 0.2.5 → 0.2.7

package/dist/media/decoder-deadline.d.ts

@@ -0,0 +1,18 @@
+export interface DecoderDeadlinePage {
+    readonly visibilityState: DocumentVisibilityState;
+    addEventListener(type: "visibilitychange", listener: () => void): void;
+    removeEventListener(type: "visibilitychange", listener: () => void): void;
+}
+/**
+ * Waits for one step of a video decoder, which answers in milliseconds when
+ * it works and may never answer when it does not. Rejects with a
+ * `TimeoutError` naming the step once `milliseconds` pass; the step itself
+ * carries on, and its owner closes the decoder.
+ *
+ * The budget runs only while the page is visible: a browser may hold a
+ * hidden page's decoder work back, and a step that waited on that is no
+ * broken decoder.
+ */
+export declare function withinDecoderDeadline<T>(step: Promise<T>, milliseconds: number, what: string, page?: DecoderDeadlinePage | undefined): Promise<T>;
+export declare function formatSeconds(milliseconds: number): string;
+//# sourceMappingURL=decoder-deadline.d.ts.map

package/dist/media/decoder-deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoder-deadline.d.ts","sourceRoot":"","sources":["../../src/media/decoder-deadline.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAC;IAClD,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IACvE,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAC3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAChB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,mBAAmB,GAAG,SAElB,GACT,OAAO,CAAC,CAAC,CAAC,CAkDZ;AAED,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/media/depth-preview-probe.d.ts

@@ -0,0 +1,65 @@
+import type { DepthPreviewLevels } from "supervision-js-core";
+import { type DepthPreviewLumaPath, type DepthPreviewTrackReader, type DepthPreviewTrackInput } from "./depth-preview-track";
+/**
+ * How long one decoder may take to return the probe's first frame. The clip
+ * is in memory, so this is decoder time alone; a decoder that works takes a
+ * few milliseconds.
+ */
+export declare const PROBE_DECODE_MILLISECONDS = 5000;
+/** What a browser's decoder did to the codes a producer wrote. */
+export interface DepthPreviewCodeProbe {
+    /** Every judged code came back exactly as written. */
+    readonly exact: boolean;
+    /** Codes judged: 256 at full levels, the 220 from 16 to 235 at TV levels. */
+    readonly judgedCodes: number;
+    readonly mismatchedCodes: number;
+    readonly maxError: number;
+    /** The code read back for each written code, indexed by the written one. */
+    readonly decoded: Uint8Array;
+    readonly lumaPath: DepthPreviewLumaPath | null;
+}
+export interface DepthPreviewDecoderVerdict {
+    readonly hardwareAcceleration: HardwareAcceleration;
+    readonly supported: boolean;
+    readonly probe: DepthPreviewCodeProbe | null;
+    readonly error?: string;
+}
+/** How this page decodes depth previews, chosen once by probing. */
+export interface DepthPreviewDecoding {
+    readonly hardwareAcceleration: HardwareAcceleration;
+    /**
+     * The probe through the chosen decoder, before any correction; null when
+     * no decoder returned a frame of it, and a preview would not decode either.
+     */
+    readonly probe: DepthPreviewCodeProbe | null;
+    /**
+     * Maps a code read back to the code written, when the chosen decoder
+     * changes codes and the table brings them closer; null when it does not.
+     */
+    readonly correction: Uint8Array | null;
+    /** Largest error left after the correction, in codes. */
+    readonly residualError: number;
+    readonly verdicts: readonly DepthPreviewDecoderVerdict[];
+}
+type OpenTrack = (input: DepthPreviewTrackInput, options?: {
+    readonly hardwareAcceleration?: HardwareAcceleration;
+}) => Promise<DepthPreviewTrackReader>;
+/**
+ * Decodes a clip of known codes, written at the preview's levels, through
+ * each decoder the page offers in the same path a depth preview takes, and
+ * keeps the first that returns them as written, directly or through a
+ * table that undoes a conversion it makes. Without one, it picks the
+ * closest. Run once per page and level: the answer is a property of the
+ * browser, not of any one preview. Probes run one after another, so the
+ * page never holds two of their decoders.
+ */
+export declare function chooseDepthPreviewDecoding(levels?: DepthPreviewLevels, open?: OpenTrack, isSupported?: (preference: HardwareAcceleration) => Promise<boolean>): Promise<DepthPreviewDecoding>;
+export declare function depthPreviewProbeBytes(levels?: DepthPreviewLevels): Uint8Array;
+/**
+ * For each code a decoder can return, the written code from `firstCode` to
+ * `lastCode` it most likely came from: the one whose read-back value is
+ * nearest, the nearest written code on a tie.
+ */
+export declare function createCodeCorrection(decoded: Uint8Array, firstCode?: number, lastCode?: number): Uint8Array;
+export {};
+//# sourceMappingURL=depth-preview-probe.d.ts.map

package/dist/media/depth-preview-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depth-preview-probe.d.ts","sourceRoot":"","sources":["../../src/media/depth-preview-probe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAgI/B;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACpD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC7C;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC,yDAAyD;IACzD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC1D;AAED,KAAK,SAAS,GAAG,CACf,KAAK,EAAE,sBAAsB,EAC7B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,oBAAoB,CAAC,EAAE,oBAAoB,CAAA;CAAE,KAC/D,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAOtC;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,GAAE,kBAA2B,EACnC,IAAI,GAAE,SAAiC,EACvC,WAAW,GAAE,CACX,UAAU,EAAE,oBAAoB,KAC7B,OAAO,CAAC,OAAO,CAA0B,GAC7C,OAAO,CAAC,oBAAoB,CAAC,CAY/B;AAED,wBAAgB,sBAAsB,CACpC,MAAM,GAAE,kBAA2B,GAClC,UAAU,CASZ;AAkID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,UAAU,EACnB,SAAS,SAAI,EACb,QAAQ,SAAM,GACb,UAAU,CAuBZ"}

package/dist/media/depth-preview-track.d.ts

@@ -0,0 +1,96 @@
+import type { EncodedPacket } from "mediabunny";
+import { type DepthPreviewLumaCopier, type DepthPreviewLumaPath } from "#render-preparation/depth/preview-luma";
+import { type TrackFrameIndex } from "./track-frame-index";
+/** How long the browser may take to say whether it decodes the preview. */
+export declare const DECODER_SUPPORT_MILLISECONDS = 3000;
+export type DepthPreviewTrackInput = string | URL | ArrayBuffer | Uint8Array;
+export interface DepthPreviewTrackOptions {
+    /** Defaults to the browser's own choice. */
+    readonly hardwareAcceleration?: HardwareAcceleration;
+    /**
+     * Maps each code the decoder returns to the code written, for a decoder
+     * known to change them.
+     */
+    readonly correction?: Uint8Array | null;
+    /**
+     * Copies decoded frames' luma out: the render-preparation worker's, to
+     * keep the copies off the page. Defaults to copying on the page.
+     */
+    readonly copier?: DepthPreviewLumaCopier;
+    /** Stops opening: the container's reads are cancelled. */
+    readonly signal?: AbortSignal;
+}
+export type { DepthPreviewLumaPath };
+/** One decoded preview frame's luma, one byte per map pixel. */
+export interface DepthPreviewLumaFrame {
+    /** Frame index on the preview's own timeline, in presentation order. */
+    readonly index: number;
+    readonly luma: Uint8Array;
+    readonly width: number;
+    readonly height: number;
+}
+/** One pass of decoding, from a key frame forward. */
+export interface DepthPreviewDecodeRun {
+    /**
+     * The next decoded frame, or null once the track has ended or the run was
+     * cancelled. Frames arrive in the decoder's output order, which is
+     * presentation order except on browsers that reorder late.
+     */
+    next(): Promise<DepthPreviewLumaFrame | null>;
+    cancel(): void;
+}
+export interface DepthPreviewDecodeOptions {
+    /** Frames this answers false for are closed without copying their pixels. */
+    readonly keep?: (index: number) => boolean;
+}
+/**
+ * The 8-bit preview video of a depth clip, decoded to luma codes.
+ *
+ * It holds one `VideoDecoder` for its whole life and resets it for each new
+ * run, so a seek or a drag never has two of its decoders alive at once,
+ * however slowly the browser tears an old one down.
+ */
+export interface DepthPreviewTrackReader {
+    readonly width: number;
+    readonly height: number;
+    readonly frameCount: number;
+    /** Frame start times, in seconds from the preview's first frame. */
+    readonly times: Float64Array;
+    keyIndexAtOrBefore(index: number): number;
+    /**
+     * Starts decoding at the key frame at or before `fromIndex`. The run
+     * replaces the previous one, whose `next` answers null from then on.
+     */
+    decode(fromIndex: number, options?: DepthPreviewDecodeOptions): DepthPreviewDecodeRun;
+    /** How decoded frames reached their codes; null before the first. */
+    lumaPath(): DepthPreviewLumaPath | null;
+    dispose(): void;
+}
+/**
+ * Opens a depth preview video: an 8-bit grayscale H.264 whose luma codes are
+ * depth. Mediabunny is loaded on first use, so a page without a preview never
+ * downloads it.
+ */
+export declare function openDepthPreviewTrack(input: DepthPreviewTrackInput, options?: DepthPreviewTrackOptions): Promise<DepthPreviewTrackReader>;
+interface PacketReader {
+    getKeyPacket(timestamp: number, options: {
+        verifyKeyPackets: boolean;
+    }): Promise<EncodedPacket | null>;
+    getFirstKeyPacket(options: {
+        verifyKeyPackets: boolean;
+    }): Promise<EncodedPacket | null>;
+    packets(start?: EncodedPacket, end?: EncodedPacket): AsyncGenerator<EncodedPacket, void, unknown>;
+}
+/** The decoding half, apart from the container so it can be driven directly. */
+export declare function createDepthPreviewTrackReader(options: {
+    readonly config: VideoDecoderConfig;
+    readonly copier?: DepthPreviewLumaCopier;
+    readonly correction?: Uint8Array | null;
+    readonly packetSink: PacketReader;
+    readonly timeline: TrackFrameIndex;
+    readonly width: number;
+    readonly height: number;
+    readonly dispose?: () => void;
+    readonly VideoDecoder?: typeof VideoDecoder;
+}): DepthPreviewTrackReader;
+//# sourceMappingURL=depth-preview-track.d.ts.map

package/dist/media/depth-preview-track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depth-preview-track.d.ts","sourceRoot":"","sources":["../../src/media/depth-preview-track.ts"],"names":[],"mappings":"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"}

package/dist/media/media-normalization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-normalization.d.ts","sourceRoot":"","sources":["../../src/media/media-normalization.ts"],"names":[],"mappings":"AAUA,OAAO,EAML,KAAK,yBAAyB,EAE9B,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,0BAA0B,GAChC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAUhD,wBAAsB,cAAc,CAClC,MAAM,EAAE,IAAI,EACZ,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,eAAe,CAAC,CAkG1B;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,IAAI,EACZ,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,0BAA0B,CAAC,CA8IrC"}
+{"version":3,"file":"media-normalization.d.ts","sourceRoot":"","sources":["../../src/media/media-normalization.ts"],"names":[],"mappings":"AAUA,OAAO,EAML,KAAK,yBAAyB,EAE9B,KAAK,eAAe,EACpB,KAAK,0BAA0B,EAChC,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,EAC3B,qBAAqB,EACrB,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,8BAA8B,EACnC,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,EAC9B,KAAK,gCAAgC,EACrC,KAAK,0BAA0B,EAC/B,KAAK,8BAA8B,EACnC,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,0BAA0B,GAChC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAUhD,wBAAsB,cAAc,CAClC,MAAM,EAAE,IAAI,EACZ,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,eAAe,CAAC,CAkG1B;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,IAAI,EACZ,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,0BAA0B,CAAC,CAgJrC"}

package/dist/media/media-source.d.ts

@@ -59,5 +59,12 @@ export interface DecodedMediaSource {
     readonly engine?: PresentedFrameChannel;
     /** Exact timing when the source already owns a presentation frame index. */
     readonly frameClock?: MediaFrameClock;
+    /**
+     * Reads the frame index on first call and reuses it after, for a source
+     * that can read one but does not keep it.
+     */
+    readonly readFrameClock?: () => Promise<MediaFrameClock>;
+    /** Why this source has no frame index, for whatever asked for one. */
+    readonly frameClockUnavailableReason?: string;
 }
 //# sourceMappingURL=media-source.d.ts.map

package/dist/media/media-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"media-source.d.ts","sourceRoot":"","sources":["../../src/media/media-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,IAAI,CACF,OAAO,EAAE,wBAAwB,GAAG,iCAAiC,EACrE,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,GACf,IAAI,CAAC;IACR,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACtC,OAAO,CACL,cAAc,CAAC,EAAE,MAAM,EACvB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,cAAc,CAAC,kBAAkB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACrD;;;;;OAKG;IACH,mBAAmB,CAAC,CAClB,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,EAC5B,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,cAAc,CAAC,kBAAkB,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,yCAAyC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,kGAAkG;IAClG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;CACvC"}
+{"version":3,"file":"media-source.d.ts","sourceRoot":"","sources":["../../src/media/media-source.ts"],"names":[],"mappings":"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"}

package/dist/media/mediabunny-frame-clock.d.ts

@@ -0,0 +1,7 @@
+import type { MediaFrameClock } from "#types/media-frame-clock";
+/**
+ * Read by the same packet walk the web video engine uses, so a depth clip
+ * pairs frames on this path exactly as it does on the engine's.
+ */
+export declare function readMediabunnyFrameClock(track: unknown): Promise<MediaFrameClock>;
+//# sourceMappingURL=mediabunny-frame-clock.d.ts.map

package/dist/media/mediabunny-frame-clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediabunny-frame-clock.d.ts","sourceRoot":"","sources":["../../src/media/mediabunny-frame-clock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,eAAe,CAAC,CAI1B"}

package/dist/media/mediabunny-media-source.d.ts

@@ -7,6 +7,9 @@ export interface MediabunnyMediaSourceInput {
         readonly duration?: number | null;
     };
     readonly source: Source;
+    /** Set when the source cannot be indexed yet, such as a file still being
+     *  written. */
+    readonly frameClockUnavailableReason?: string;
 }
 export declare function openMediabunnyMediaSource(sourceInput: string | URL | Request | MediabunnyMediaSourceInput): Promise<DecodedMediaSource>;
 export declare function createMediabunnyMediaRendererSource(sourceInput: MediabunnyMediaSourceInput): MediaRendererSource;

package/dist/media/mediabunny-media-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mediabunny-media-source.d.ts","sourceRoot":"","sources":["../../src/media/mediabunny-media-source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAID,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,0BAA0B,GAC/D,OAAO,CAAC,kBAAkB,CAAC,CA6G7B;AAkCD,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,0BAA0B,GACtC,mBAAmB,CAMrB"}
+{"version":3,"file":"mediabunny-media-source.d.ts","sourceRoot":"","sources":["../../src/media/mediabunny-media-source.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAClB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB;mBACe;IACf,QAAQ,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC;CAC/C;AAID,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,0BAA0B,GAC/D,OAAO,CAAC,kBAAkB,CAAC,CA+H7B;AAkCD,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,0BAA0B,GACtC,mBAAmB,CAMrB"}

package/dist/media/track-frame-index.d.ts

@@ -0,0 +1,14 @@
+export interface TrackFrameIndex {
+    /** Seconds from the first presented frame. */
+    readonly times: Float64Array;
+    /** Container presentation times in seconds, which packets are found by. */
+    readonly sourceTimes: Float64Array;
+    /** Presentation indices of key frames, ascending. */
+    readonly keyIndices: Int32Array;
+}
+/**
+ * Read by the same packet walk the web video engine uses, so a track decoded
+ * beside the media and the media itself agree on every frame.
+ */
+export declare function readTrackFrameIndex(track: unknown): Promise<TrackFrameIndex>;
+//# sourceMappingURL=track-frame-index.d.ts.map

package/dist/media/track-frame-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-frame-index.d.ts","sourceRoot":"","sources":["../../src/media/track-frame-index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IACnC,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,eAAe,CAAC,CAgB1B"}

package/dist/media/video-engine-media-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"video-engine-media-source.d.ts","sourceRoot":"","sources":["../../src/media/video-engine-media-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAE3B,cAAc,EACd,cAAc,EACd,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAqB3B,MAAM,WAAW,gCAAiC,SAAQ,IAAI,CAC5D,qBAAqB,EACrB,cAAc,GAAG,QAAQ,CAC1B;IACC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAAC;IAClD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;CACzD;AAED,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAAC;CACzD;AAED;;;;;;;;;GASG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,yBAAyB,CAAC,CAoDpC;AAwDD,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,gCAAgC,GACxC,mBAAmB,CAMrB"}
+{"version":3,"file":"video-engine-media-source.d.ts","sourceRoot":"","sources":["../../src/media/video-engine-media-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EACV,eAAe,EACf,wBAAwB,EACxB,2BAA2B,EAE3B,cAAc,EACd,cAAc,EACd,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAqB3B,MAAM,WAAW,gCAAiC,SAAQ,IAAI,CAC5D,qBAAqB,EACrB,cAAc,GAAG,QAAQ,CAC1B;IACC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CAAC;IAClD;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;CACzD;AAED,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IACnE;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CAAC;CACzD;AAED;;;;;;;;;GASG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,gCAAgC,GACxC,OAAO,CAAC,yBAAyB,CAAC,CA6DpC;AAwDD,wBAAgB,uCAAuC,CACrD,OAAO,EAAE,gCAAgC,GACxC,mBAAmB,CAMrB"}

package/dist/media/video-engine-media-source.js

@@ -1,3 +1,3 @@
-export { c as createWebVideoEngineMediaRendererSource, o as openWebVideoEngineMediaSource } from '../video-engine-media-source-DR-x1UfK.js';
+export { a as createWebVideoEngineMediaRendererSource, o as openWebVideoEngineMediaSource } from '../video-engine-media-source-DOFsuGS4.js';
 import 'supervision-js-core';
 //# sourceMappingURL=video-engine-media-source.js.map

package/dist/render-preparation/depth/clip-preview.d.ts

@@ -0,0 +1,41 @@
+import { type DepthManifest } from "supervision-js-core";
+import type { DepthPreviewDecoding } from "#media/depth-preview-probe";
+import type { DepthPreviewTrackReader } from "#media/depth-preview-track";
+import type { DepthPreviewLumaCopier } from "./preview-luma";
+import type { DepthSourceContext } from "./source";
+export interface OpenedClipPreview {
+    readonly reader: DepthPreviewTrackReader;
+    /** What copies decoded frames' codes out, when not the page itself. */
+    readonly copier: DepthPreviewLumaCopier | undefined;
+    readonly track: NonNullable<DepthManifest["preview"]>;
+    /** What diagnostics say about the preview, such as altered codes. */
+    readonly message: string | null;
+}
+export interface ClipPreview {
+    readonly preview: OpenedClipPreview | null;
+    /** Why a clip with a preview draws none; else null. */
+    readonly unavailable: string | null;
+}
+/**
+ * Opens the clip's preview video and checks it against the media it is
+ * drawn over: one preview frame per depth frame, each at its video frame's
+ * time. A preview that disagrees is refused with a `RangeError`. One this
+ * browser cannot open or decode leaves the clip without it, and says why
+ * once in the console and in diagnostics.
+ */
+export declare function openClipPreview(manifest: DepthManifest, base: string | URL | undefined, context: DepthSourceContext, frameCount: number, timeAt: (index: number) => number): Promise<ClipPreview>;
+/**
+ * What diagnostics say about the page's preview decoder: nothing when its
+ * codes come back as written, directly or through the probe's table.
+ */
+export declare function describePreviewDecoding(decoding: DepthPreviewDecoding | null): string | null;
+/**
+ * Refuses a preview whose frames are not the depth frames, one for one, at
+ * the same times. Each timeline is measured from its own first frame, so a
+ * preview that starts its clock elsewhere still lines up.
+ */
+export declare function assertDepthPreviewTimeline(preview: {
+    readonly frameCount: number;
+    readonly times: Float64Array;
+}, count: number, expectedTime: (index: number) => number): void;
+//# sourceMappingURL=clip-preview.d.ts.map

package/dist/render-preparation/depth/clip-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clip-preview.d.ts","sourceRoot":"","sources":["../../../src/render-preparation/depth/clip-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAEV,oBAAoB,EACrB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,uEAAuE;IACvE,QAAQ,CAAC,MAAM,EAAE,sBAAsB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IACtD,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,EAC9B,OAAO,EAAE,kBAAkB,EAC3B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAChC,OAAO,CAAC,WAAW,CAAC,CA2EtB;AAYD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GACpC,MAAM,GAAG,IAAI,CAUf;AAkBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;CAAE,EACtE,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACtC,IAAI,CAoBN"}

package/dist/render-preparation/depth/clip-timing.d.ts

@@ -0,0 +1,18 @@
+import { type DepthClipFrames } from "supervision-js-core";
+import type { MediaFrameClock } from "#types/media-frame-clock";
+/** Where each depth frame of a clip sits on the media timeline. */
+export interface DepthClipTiming {
+    readonly frameCount: number;
+    /** Depth frames per second, over the whole clip. */
+    readonly frameRate: number;
+    /** The depth frame drawn over `mediaTime`, or null before the first. */
+    indexAt(mediaTime: number): number | null;
+    timeAt(index: number): number;
+    endAt(index: number): number;
+}
+/**
+ * Pairs depth frames with the media's frames: one for one by index, or by
+ * `frames.times_s` when depth covers only some of them.
+ */
+export declare function createDepthClipTiming(clock: MediaFrameClock, frames: DepthClipFrames): DepthClipTiming;
+//# sourceMappingURL=clip-timing.d.ts.map

package/dist/render-preparation/depth/clip-timing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clip-timing.d.ts","sourceRoot":"","sources":["../../../src/render-preparation/depth/clip-timing.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,eAAe,GACtB,eAAe,CAuCjB"}

package/dist/render-preparation/depth/clip.d.ts

@@ -0,0 +1,14 @@
+import type { DepthClipFrames, DepthManifest } from "supervision-js-core";
+import type { DepthFrameProvider, DepthSourceContext } from "./source";
+/**
+ * A clip's depth: exact 16-bit PNGs, one per frame, and an optional 8-bit
+ * preview video.
+ *
+ * While playback runs, the preview or the exact frame for the video frame on
+ * screen is drawn, loaded ahead of the playhead; a frame not loaded yet draws
+ * no depth, never another frame's. Once playback has rested, the exact frame
+ * on screen replaces it. A frame that lands for the frame on screen asks for
+ * one redraw.
+ */
+export declare function openDepthClip(manifest: DepthManifest, frames: DepthClipFrames, base: string | URL | undefined, context: DepthSourceContext): Promise<DepthFrameProvider>;
+//# sourceMappingURL=clip.d.ts.map

package/dist/render-preparation/depth/clip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clip.d.ts","sourceRoot":"","sources":["../../../src/render-preparation/depth/clip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EAEd,MAAM,qBAAqB,CAAC;AAY7B,OAAO,KAAK,EAEV,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAIlB;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,EAC9B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAic7B"}

package/dist/render-preparation/depth/exact-at-rest.d.ts

@@ -0,0 +1,44 @@
+import type { DepthMap } from "supervision-js-core";
+import { type RenderPreparationArtifactDiagnostics } from "#types/render-preparation";
+import type { DepthClipOptions } from "./options";
+/** A clip's exact frames around the frame at rest. */
+export interface ExactFramesAtRest {
+    get(index: number): DepthMap | undefined;
+    /**
+     * The playhead rests on `center`: once it has for `settleSeconds`, that
+     * frame loads, then its neighbours nearest first, most of them the way the
+     * playhead last moved, so a step lands on a frame already loaded. A later
+     * call or `cancel` starts none of the frames not yet asked for; a frame
+     * already loading finishes and is kept.
+     */
+    settleOn(center: number): void;
+    cancel(): void;
+    /** Resolves once frame `index` is in, or `signal` aborts. */
+    landing(index: number, signal?: AbortSignal): Promise<void>;
+    diagnostics(): RenderPreparationArtifactDiagnostics;
+    destroy(): void;
+}
+/**
+ * Loads each frame once; a second ask shares the first. Frames are kept up
+ * to `maxCacheBytes`, dropping the ones farthest from the frame on screen
+ * first.
+ */
+export declare function createExactFramesAtRest(options: {
+    readonly frameCount: number;
+    readonly exactFrameBytes: number;
+    readonly options: DepthClipOptions["exact"];
+    readonly load: (index: number, signal: AbortSignal) => Promise<DepthMap>;
+    /** A frame exact playback already holds, kept here without a second load. */
+    readonly loadedAhead: (index: number) => DepthMap | null;
+    /** Loads run at once: one per decode worker. */
+    readonly concurrency: () => number;
+    readonly onScreen: () => number | null;
+    /** Which way the playhead last moved. */
+    readonly heading: () => -1 | 0 | 1;
+    readonly timeAt: (index: number) => number;
+    readonly onLanded: (index: number) => void;
+    readonly onChange: () => void;
+    /** What a frame that does not load leaves on screen, for its warning. */
+    readonly stillDrawn: string;
+}): ExactFramesAtRest;
+//# sourceMappingURL=exact-at-rest.d.ts.map

package/dist/render-preparation/depth/exact-at-rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact-at-rest.d.ts","sourceRoot":"","sources":["../../../src/render-preparation/depth/exact-at-rest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAGL,KAAK,oCAAoC,EAC1C,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,IAAI,IAAI,CAAC;IACf,6DAA6D;IAC7D,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,WAAW,IAAI,oCAAoC,CAAC;IACpD,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE;IAC/C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzE,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,IAAI,CAAC;IACzD,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACvC,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,GAAG,iBAAiB,CA0KpB"}

package/dist/render-preparation/depth/exact-playback.d.ts

@@ -0,0 +1,40 @@
+import type { DepthMap } from "supervision-js-core";
+import type { DepthPlaybackSource } from "#types/render-preparation";
+import type { DepthClipTiming } from "./clip-timing";
+import { type DepthFrameWindow } from "./frame-window";
+import type { DepthClipOptions } from "./options";
+/** Exact frames loaded ahead of playback, and whether they are what plays. */
+export interface ExactPlayback {
+    readonly window: DepthFrameWindow;
+    /** Whether exact depth plays now. */
+    readonly drawn: boolean;
+    /**
+     * Whether exact depth plays the frame at `index`. In "auto" this is where
+     * it takes over once its lead reaches three quarters of what it loads
+     * ahead, and hands back to the preview when that lead falls under a
+     * quarter or the frame is missing, waiting longer each time before it
+     * tries again; a stretch of steady exact playback earns the short wait
+     * back.
+     */
+    playsAt(index: number): boolean;
+    /** Playback starts, or resumes after a drag: "auto" opens on the preview. */
+    restart(): void;
+}
+export declare function createExactPlayback(options: {
+    readonly source: Exclude<DepthPlaybackSource, "preview">;
+    /**
+     * Whether a preview can stand in for exact depth; false once its decoder
+     * stops.
+     */
+    readonly hasPreview: () => boolean;
+    readonly timing: DepthClipTiming;
+    readonly exactFrameBytes: number;
+    readonly budgets: DepthClipOptions;
+    readonly load: (index: number, signal: AbortSignal) => Promise<DepthMap>;
+    readonly concurrency: () => number;
+    readonly looping: () => boolean;
+    /** A frame landed for `index`, while exact depth plays. */
+    readonly onFrame: (index: number) => void;
+    readonly onChange: () => void;
+}): ExactPlayback;
+//# sourceMappingURL=exact-playback.d.ts.map

package/dist/render-preparation/depth/exact-playback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact-playback.d.ts","sourceRoot":"","sources":["../../../src/render-preparation/depth/exact-playback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAYlD,8EAA8E;AAC9E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,6EAA6E;IAC7E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IACzD;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;CAC/B,GAAG,aAAa,CA4GhB"}

package/dist/render-preparation/depth/files.d.ts

@@ -0,0 +1,55 @@
+import { type DepthClipFrames, type DepthManifest, type DepthMap } from "supervision-js-core";
+import type { MediaRendererDepthInput } from "#types/media-depth";
+import type { DepthSourceContext } from "./source";
+/** The files of one depth map: the 16-bit depth PNG and its confidence. */
+export interface DepthMapFiles {
+    readonly file: string;
+    readonly confidenceFile?: string;
+}
+type ManifestInput = Extract<MediaRendererDepthInput, {
+    manifest: unknown;
+}>;
+/**
+ * Fetches and parses a manifest URL, or checks one passed parsed. Relative
+ * files resolve against the manifest's URL, or against `baseUrl` for a
+ * manifest passed already parsed.
+ */
+export declare function loadDepthManifest(input: ManifestInput, context: DepthSourceContext): Promise<{
+    manifest: DepthManifest;
+    base: string | URL | undefined;
+}>;
+export declare function clipFrameFiles(frames: DepthClipFrames, index: number): DepthMapFiles;
+/** Bytes a decoded exact map holds, its confidence plane included. */
+export declare function exactMapBytes(map: DepthMap): number;
+/**
+ * Fetches and decodes one depth PNG, and its confidence plane, into a map.
+ * The decode runs in the render-preparation worker when there is one.
+ */
+export declare function loadDepthMap(manifest: DepthManifest, files: DepthMapFiles, base: string | URL | undefined, context: DepthSourceContext, signal: AbortSignal | undefined): Promise<DepthMap>;
+/**
+ * The whole factor a map can shrink by for upload and still have a texel
+ * for every pixel of the box it is shown in, at the box's pixel ratio; 1
+ * without a box.
+ */
+export declare function displayDecimation(map: {
+    readonly width: number;
+    readonly height: number;
+}, context: Pick<DepthSourceContext, "display" | "media">): number;
+/**
+ * Resolves `file` against `base`, itself resolved against the page. Without
+ * a page (a worker, a test), a relative base still joins by path.
+ */
+export declare function resolveUrl(file: string, base: string | URL | undefined): string;
+/**
+ * The map is stretched over the media rectangle, so a map of another shape
+ * would put depth beside the pixels it measures.
+ */
+export declare function assertMediaAspect(map: {
+    readonly width: number;
+    readonly height: number;
+}, media: {
+    readonly width: number;
+    readonly height: number;
+}): void;
+export {};
+//# sourceMappingURL=files.d.ts.map

package/dist/render-preparation/depth/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../../src/render-preparation/depth/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAKnD,2EAA2E;AAC3E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,KAAK,aAAa,GAAG,OAAO,CAAC,uBAAuB,EAAE;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE7E;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAAA;CAAE,CAAC,CAmBtE;AAuBD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,GACZ,aAAa,CAQf;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,EAC9B,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,QAAQ,CAAC,CA+DnB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACxD,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,OAAO,CAAC,GACrD,MAAM,CAkBR;AA8BD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,GAC7B,MAAM,CAiBR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACxD,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACzD,IAAI,CAgBN"}

package/dist/render-preparation/depth/frame-decode.d.ts

@@ -0,0 +1,20 @@
+import { type DecimatedDepthUpload, type DepthPreparationWorkerRequest, type DepthPreparationWorkerResponse } from "./worker-protocol";
+/**
+ * Answers one decode request, in the worker or on the main thread: the reply
+ * and the buffers it can transfer. A file that does not decode is an error
+ * reply, never a thrown exception, so the caller can tell a bad file from a
+ * broken worker.
+ */
+export declare function decodeDepthPreparationRequest(request: Omit<DepthPreparationWorkerRequest, "requestId"> & {
+    readonly requestId?: number;
+}): Promise<{
+    readonly response: DepthPreparationWorkerResponse;
+    readonly transfer: Transferable[];
+}>;
+/**
+ * Depth for a texture `factor` times smaller on each side, each texel the
+ * sample at its block's centre, as the renderer decimates a map larger than
+ * the GPU allows.
+ */
+export declare function decimateDepthUpload(values: Uint16Array, width: number, height: number, factor: number, padRowsForWebGl: boolean): DecimatedDepthUpload<Uint8Array> | null;
+//# sourceMappingURL=frame-decode.d.ts.map

package/dist/render-preparation/depth/frame-decode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-decode.d.ts","sourceRoot":"","sources":["../../../src/render-preparation/depth/frame-decode.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,6BAA6B,EAClC,KAAK,8BAA8B,EACpC,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,IAAI,CAAC,6BAA6B,EAAE,WAAW,CAAC,GAAG;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B,GACA,OAAO,CAAC;IACT,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC;CACnC,CAAC,CAsED;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,OAAO,GACvB,oBAAoB,CAAC,UAAU,CAAC,GAAG,IAAI,CAmCzC"}

package/dist/render-preparation/depth/frame-preparer.d.ts

@@ -0,0 +1,51 @@
+import { type DecimatedDepthUpload } from "./worker-protocol";
+import { type RenderPreparationOptions } from "#types/render-preparation";
+/** A decoded depth PNG: host-order samples, or bytes for a confidence plane. */
+export interface DecodedDepthImage<Values extends Uint16Array | Uint8Array> {
+    readonly width: number;
+    readonly height: number;
+    readonly values: Values;
+    /** Odd-width depth rows padded for WebGL, when asked for. */
+    readonly paddedUpload?: {
+        readonly bytes: Uint8Array;
+        readonly textureWidth: number;
+    };
+    /** Depth decimated for upload, when `decimateBy` asked for it. */
+    readonly decimatedUpload?: DecimatedDepthUpload<Uint8Array>;
+}
+export interface DepthDecodeOptions {
+    readonly padRowsForWebGl?: boolean;
+    /** Also decimate depth by this whole factor for upload, from 2 up. */
+    readonly decimateBy?: number;
+    /** Drops the result; the decode itself runs to the end in the worker. */
+    readonly signal?: AbortSignal;
+}
+export interface DepthFramePreparer {
+    /**
+     * Decodes worth running at once: one per worker in the pool, sized as the
+     * mask workers are, or 1 on the main thread.
+     */
+    readonly concurrency: number;
+    /** Decodes a 16-bit depth PNG. The bytes are the preparer's from here on. */
+    decodeDepth(bytes: ArrayBuffer, options?: DepthDecodeOptions): Promise<DecodedDepthImage<Uint16Array>>;
+    decodeConfidence(bytes: ArrayBuffer, options?: Pick<DepthDecodeOptions, "signal">): Promise<DecodedDepthImage<Uint8Array>>;
+    destroy(): void;
+}
+/**
+ * Decodes depth and confidence PNGs in a pool of render-preparation workers,
+ * sized the way the mask pool is (`maskFrame.workerCount`, by default half
+ * the cores up to 4), or on the main thread when the mode asks for it or
+ * `Auto` finds no working worker. The first worker starts at once, so a
+ * factory that throws fails `Worker` mode here; the others start only when
+ * every running one is busy, so a still map never spawns a pool.
+ *
+ * Until a worker has answered once, `Auto` posts a copy of the bytes, so a
+ * worker that fails to start (a CSP that blocks blob workers, say) leaves the
+ * original to decode here. After that the bytes are transferred. Nothing ever
+ * terminates a worker to cancel a decode: an aborted request's reply is
+ * dropped when it arrives.
+ */
+export declare function createDepthFramePreparer(options: RenderPreparationOptions | undefined): DepthFramePreparer;
+/** Rejects when the signal aborts; the work itself carries on unobserved. */
+export declare function abortable<T>(work: Promise<T>, signal: AbortSignal | undefined): Promise<T>;
+//# sourceMappingURL=frame-preparer.d.ts.map