supervision 0.0.9000 → 0.1.0

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

@@ -0,0 +1,38 @@
+export interface DecodedVideoSample {
+    readonly timestamp: number;
+    readonly duration: number;
+    draw(context: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, dx: number, dy: number, dWidth?: number, dHeight?: number): void;
+    close(): void;
+}
+export interface DecodedVideoSampleSink {
+    getSample(timestamp: number, options?: {
+        skipLiveWait?: boolean;
+    }): Promise<DecodedVideoSample | null>;
+    samples(startTimestamp?: number, endTimestamp?: number, options?: {
+        skipLiveWait?: boolean;
+    }): AsyncGenerator<DecodedVideoSample, void, unknown>;
+}
+export interface DisposableMediaInput {
+    dispose(): void;
+}
+export interface DecodedMediaSourceMetadata {
+    readonly canRead: boolean;
+    readonly formatName: string | null;
+    readonly formatMimeType: string | null;
+    readonly mimeType: string | null;
+    readonly duration: number | null;
+    readonly trackCount: number;
+    readonly videoTrackCount: number;
+    readonly audioTrackCount: number;
+    readonly primaryVideoWidth: number;
+    readonly primaryVideoHeight: number;
+    readonly firstTimestamp: number;
+    readonly estimatedFrameRate?: number | null;
+    readonly estimatedFrameCount?: number | null;
+}
+export interface DecodedMediaSource {
+    readonly input: DisposableMediaInput;
+    readonly metadata: DecodedMediaSourceMetadata;
+    readonly sampleSink: DecodedVideoSampleSink;
+}
+//# sourceMappingURL=media-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-source.d.ts","sourceRoot":"","sources":["../../src/media/media-source.ts"],"names":[],"mappings":"AAAA,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;CACtD;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,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,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;CAC7C"}

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

@@ -0,0 +1,27 @@
+import type { MediaRendererSource } from "#types/media-renderer";
+export type MediaStreamRendererSourceOptions = {
+    /** Maximum decoded snapshots retained while the renderer is catching up. */
+    readonly maxBufferedFrames?: number;
+    /**
+     * Timestamp origin exposed to the renderer. `"media"` preserves the browser
+     * MediaStream clock. `"first-frame"` starts the visible timeline at zero so
+     * an independently transported detection stream can apply the same origin.
+     * Defaults to `"media"`.
+     */
+    readonly timestampOrigin?: "first-frame" | "media";
+    /**
+     * Stop the caller-supplied MediaStream tracks when the session is destroyed.
+     * Defaults to false because WebRTC connection ownership normally stays with
+     * the host application.
+     */
+    readonly stopTracksOnDispose?: boolean;
+};
+/**
+ * Adapts a browser MediaStream to the renderer-owned decoded-media boundary.
+ *
+ * The HTMLVideoElement is an internal decode clock only. Every presented frame
+ * is snapshotted before it enters the bounded queue, so Pixi remains the sole
+ * visible composition surface and annotations use the exact sample timestamp.
+ */
+export declare function createMediaStreamRendererSource(stream: MediaStream, options?: MediaStreamRendererSourceOptions): MediaRendererSource;
+//# sourceMappingURL=media-stream-media-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-stream-media-source.d.ts","sourceRoot":"","sources":["../../src/media/media-stream-media-source.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAMjE,MAAM,MAAM,gCAAgC,GAAG;IAC7C,4EAA4E;IAC5E,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IACnD;;;;OAIG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CACxC,CAAC;AAaF;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,gCAAqC,GAC7C,mBAAmB,CAMrB"}

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

@@ -0,0 +1,13 @@
+import type { DecodedMediaSource } from "./media-source";
+import type { MediaRendererSource } from "#types/media-renderer";
+import type { InputFormat, Source } from "mediabunny";
+export interface MediabunnyMediaSourceInput {
+    readonly formats?: readonly InputFormat[];
+    readonly metadata?: {
+        readonly duration?: number | null;
+    };
+    readonly source: Source;
+}
+export declare function openMediabunnyMediaSource(sourceInput: string | URL | Request | MediabunnyMediaSourceInput): Promise<DecodedMediaSource>;
+export declare function createMediabunnyMediaRendererSource(sourceInput: MediabunnyMediaSourceInput): MediaRendererSource;
+//# sourceMappingURL=mediabunny-media-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mediabunny-media-source.d.ts","sourceRoot":"","sources":["../../src/media/mediabunny-media-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,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,CA+F7B;AAYD,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,0BAA0B,GACtC,mBAAmB,CAMrB"}

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

@@ -0,0 +1,13 @@
+import type { MediaRendererSource } from "#types/media-renderer";
+export type StaticImageSource = HTMLImageElement | ImageBitmap | HTMLCanvasElement | OffscreenCanvas | VideoFrame;
+export interface HostFrameSource {
+    readonly width: number;
+    readonly height: number;
+    draw(context: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, dx: number, dy: number, dWidth: number, dHeight: number): void;
+}
+/** Creates an image-first renderer source without routing through Mediabunny. */
+export declare function createStaticImageMediaSource(source: StaticImageSource | HostFrameSource): MediaRendererSource;
+export declare function createImageUrlMediaSource(src: string, options?: {
+    readonly crossOrigin?: string;
+}): MediaRendererSource;
+//# sourceMappingURL=static-image-media-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"static-image-media-source.d.ts","sourceRoot":"","sources":["../../src/media/static-image-media-source.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,WAAW,GACX,iBAAiB,GACjB,eAAe,GACf,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,IAAI,CACF,OAAO,EAAE,wBAAwB,GAAG,iCAAiC,EACrE,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,IAAI,CAAC;CACT;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,iBAAiB,GAAG,eAAe,GAC1C,mBAAmB,CAkBrB;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAC9C,mBAAmB,CAMrB"}

package/dist/playback/media-playback-controller.d.ts

@@ -0,0 +1,24 @@
+import type { DecodedVideoSample, DecodedVideoSampleSink } from "#media/media-source";
+export interface MediaPlaybackController {
+    play(): void;
+    pause(): void;
+    seek(mediaTime: number): void;
+    setPlaybackRate(playbackRate: number): void;
+    destroy(): void;
+}
+export declare function createMediaPlaybackController(options: {
+    readonly sampleSink: DecodedVideoSampleSink;
+    readonly firstTimestamp: number;
+    readonly duration: number | null;
+    readonly loop: boolean;
+    readonly initialMediaTime: number;
+    readonly playbackRate?: number;
+    readonly presentSample: (sample: DecodedVideoSample) => void;
+    readonly waitForSample?: (sample: DecodedVideoSample) => Promise<void>;
+    readonly onCurrentTimeChange: (currentTime: number) => void;
+    readonly onEnded: () => void;
+    readonly onError: (error: unknown) => void;
+    readonly onWaiting?: () => void;
+    readonly onResume?: () => void;
+}): MediaPlaybackController;
+//# sourceMappingURL=media-playback-controller.d.ts.map

package/dist/playback/media-playback-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-playback-controller.d.ts","sourceRoot":"","sources":["../../src/playback/media-playback-controller.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAU7B,MAAM,WAAW,uBAAuB;IACtC,IAAI,IAAI,IAAI,CAAC;IACb,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,QAAQ,CAAC,mBAAmB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CAChC,GAAG,uBAAuB,CA8c1B"}

package/dist/render-preparation/default-render-preparation-worker.d.ts

@@ -0,0 +1,8 @@
+import type { RenderPreparationWorkerFactory } from "#types/render-preparation";
+/**
+ * Creates workers from the self-contained source embedded in the browser
+ * package. The shared object URL is intentionally retained for the lifetime of
+ * the module so every session and every member of a worker pool can reuse it.
+ */
+export declare function createDefaultRenderPreparationWorkerFactory(): RenderPreparationWorkerFactory;
+//# sourceMappingURL=default-render-preparation-worker.d.ts.map

package/dist/render-preparation/default-render-preparation-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-render-preparation-worker.d.ts","sourceRoot":"","sources":["../../src/render-preparation/default-render-preparation-worker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAKhF;;;;GAIG;AACH,wBAAgB,2CAA2C,IAAI,8BAA8B,CAc5F"}

package/dist/render-preparation/embedded-mask-preparation-worker.d.ts

@@ -0,0 +1,2 @@
+export declare const EMBEDDED_MASK_PREPARATION_WORKER_SOURCE = "__SUPERVISION_JS_EMBEDDED_MASK_PREPARATION_WORKER_SOURCE__";
+//# sourceMappingURL=embedded-mask-preparation-worker.d.ts.map

package/dist/render-preparation/embedded-mask-preparation-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-mask-preparation-worker.d.ts","sourceRoot":"","sources":["../../src/render-preparation/embedded-mask-preparation-worker.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uCAAuC,+DACU,CAAC"}

package/dist/render-preparation/mask-frame-artifact.d.ts

@@ -0,0 +1,28 @@
+export declare enum PreparedMaskFrameKind {
+    PngIdMask = "pngIdMask",
+    RgbaImage = "rgbaImage"
+}
+export interface PreparedRgbaMaskFrame {
+    readonly height: number;
+    readonly key: string;
+    readonly kind: PreparedMaskFrameKind.RgbaImage;
+    readonly source: HTMLCanvasElement | ImageBitmap;
+    readonly width: number;
+    close(): void;
+}
+export interface PreparedPngIdMaskFrame {
+    readonly fillPalette: Float32Array<ArrayBuffer>;
+    readonly hasStroke: boolean;
+    readonly height: number;
+    readonly key: string;
+    readonly kind: PreparedMaskFrameKind.PngIdMask;
+    readonly maxStrokeWidth: number;
+    readonly png: Uint8Array<ArrayBuffer>;
+    readonly source: ImageBitmap;
+    readonly strokePalette: Float32Array<ArrayBuffer>;
+    readonly strokeWidths: Float32Array<ArrayBuffer>;
+    readonly width: number;
+    close(): void;
+}
+export type PreparedMaskFrame = PreparedPngIdMaskFrame | PreparedRgbaMaskFrame;
+//# sourceMappingURL=mask-frame-artifact.d.ts.map

package/dist/render-preparation/mask-frame-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-frame-artifact.d.ts","sourceRoot":"","sources":["../../src/render-preparation/mask-frame-artifact.ts"],"names":[],"mappings":"AAAA,oBAAY,qBAAqB;IAC/B,SAAS,cAAc;IACvB,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IAClD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,GAAG,qBAAqB,CAAC"}

package/dist/render-preparation/mask-frame-compositor.d.ts

@@ -0,0 +1,14 @@
+import type { SerializableMaskInstruction } from "#render-preparation/mask-preparation-worker-protocol";
+import { type IdMaskFrame } from "supervision-js-core";
+export { MAX_ID_MASK_PALETTE_ENTRIES, MAX_ID_MASK_STROKE_WIDTH, createIdMaskFrame, type IdMaskFrame, } from "supervision-js-core";
+export interface CompositedMaskFrame {
+    readonly data: Uint8ClampedArray<ArrayBuffer>;
+    readonly height: number;
+    readonly width: number;
+}
+export interface PngIdMaskFrame extends IdMaskFrame {
+    readonly png: Uint8Array<ArrayBuffer>;
+}
+export declare function compositeMaskFrame(instructions: readonly SerializableMaskInstruction[]): CompositedMaskFrame | undefined;
+export declare function createPngIdMaskFrame(instructions: readonly SerializableMaskInstruction[]): Promise<PngIdMaskFrame | undefined>;
+//# sourceMappingURL=mask-frame-compositor.d.ts.map

package/dist/render-preparation/mask-frame-compositor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-frame-compositor.d.ts","sourceRoot":"","sources":["../../src/render-preparation/mask-frame-compositor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AAExG,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAmB7B,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;CACvC;AAED,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,SAAS,2BAA2B,EAAE,GACnD,mBAAmB,GAAG,SAAS,CAgBjC;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,SAAS,2BAA2B,EAAE,GACnD,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAerC"}

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

@@ -0,0 +1,19 @@
+import { PreparedMaskFrameKind, type PreparedMaskFrame } from "#render-preparation/mask-frame-artifact";
+import { type MaskFramePreparationJob } from "#render-preparation/mask-preparation-worker-protocol";
+import { RenderPreparationExecutionMode, RenderPreparationWorkerStatus, type RenderPreparationOptions } from "#types/render-preparation";
+export { PreparedMaskFrameKind, type PreparedMaskFrame };
+export interface MaskFramePreparerStatus {
+    readonly executionMode: RenderPreparationExecutionMode;
+    readonly message: string | null;
+    readonly workerStatus: RenderPreparationWorkerStatus;
+}
+export interface MaskFramePreparer {
+    getStatus(): MaskFramePreparerStatus;
+    prepare(job: MaskFramePreparationJob): Promise<PreparedMaskFrame | undefined>;
+    destroy(): void;
+}
+export declare function createMaskFramePreparer(options?: {
+    readonly renderPreparation?: RenderPreparationOptions;
+    readonly onStatusChange?: () => void;
+}): MaskFramePreparer;
+//# sourceMappingURL=mask-frame-preparer.d.ts.map

package/dist/render-preparation/mask-frame-preparer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-frame-preparer.d.ts","sourceRoot":"","sources":["../../src/render-preparation/mask-frame-preparer.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,qBAAqB,EACrB,KAAK,iBAAiB,EACvB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAEL,KAAK,uBAAuB,EAG7B,MAAM,sDAAsD,CAAC;AAC9D,OAAO,EACL,8BAA8B,EAE9B,6BAA6B,EAC7B,KAAK,wBAAwB,EAE9B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,CAAC;AAEzD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,8BAA8B,CAAC;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,6BAA6B,CAAC;CACtD;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,IAAI,uBAAuB,CAAC;IACrC,OAAO,CAAC,GAAG,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IAC9E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,GAAE;IACP,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CACjC,GACL,iBAAiB,CAsGnB"}

package/dist/render-preparation/mask-preparation-worker-count.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Automatic mask preparation intentionally uses a small pool. RLE decode and
+ * PNG ID-mask creation are CPU-heavy enough to benefit from parallelism, but
+ * worker count also increases memory pressure and can compete with media
+ * decode. Explicit caller requests are allowed higher, but still bounded.
+ */
+export declare const AUTO_MASK_PREPARATION_WORKER_LIMIT = 4;
+export declare const REQUESTED_MASK_PREPARATION_WORKER_LIMIT = 8;
+export declare const MIN_MASK_PREPARATION_WORKER_COUNT = 1;
+export declare function resolveMaskPreparationWorkerCount(options?: {
+    readonly hardwareConcurrency?: number;
+    readonly requestedWorkerCount?: number;
+}): number;
+export declare function getBrowserMaskPreparationWorkerCount(requestedWorkerCount: number | undefined): number;
+//# sourceMappingURL=mask-preparation-worker-count.d.ts.map

package/dist/render-preparation/mask-preparation-worker-count.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-preparation-worker-count.d.ts","sourceRoot":"","sources":["../../src/render-preparation/mask-preparation-worker-count.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,IAAI,CAAC;AACpD,eAAO,MAAM,uCAAuC,IAAI,CAAC;AACzD,eAAO,MAAM,iCAAiC,IAAI,CAAC;AAEnD,wBAAgB,iCAAiC,CAC/C,OAAO,GAAE;IACP,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACnC,UAkBP;AAED,wBAAgB,oCAAoC,CAClD,oBAAoB,EAAE,MAAM,GAAG,SAAS,UASzC"}

package/dist/render-preparation/mask-preparation-worker-protocol.d.ts

@@ -0,0 +1,64 @@
+import type { DetectionMask, Point } from "supervision-js-core";
+import type { MaskStrokeStyle } from "supervision-js-core";
+import type { PreparedMaskFrameKind } from "./mask-frame-artifact";
+export declare enum MaskPreparationWorkerMessageType {
+    Complete = "complete",
+    Empty = "empty",
+    Error = "error",
+    Prepare = "prepare"
+}
+interface SerializableRasterInstructionBase {
+    readonly alpha: number;
+    readonly color: number;
+    readonly detectionIndex: number;
+    readonly stroke?: MaskStrokeStyle;
+}
+export type SerializableMaskInstruction = (SerializableRasterInstructionBase & {
+    readonly mask: DetectionMask;
+    readonly polygon?: never;
+}) | (SerializableRasterInstructionBase & {
+    readonly mask?: never;
+    readonly polygon: {
+        readonly height: number;
+        readonly points: readonly Point[];
+        readonly width: number;
+    };
+});
+export interface MaskFramePreparationJob {
+    readonly instructions: readonly SerializableMaskInstruction[];
+    readonly key: string;
+}
+export interface MaskPreparationWorkerPrepareMessage {
+    readonly job: MaskFramePreparationJob;
+    readonly requestId: number;
+    readonly type: MaskPreparationWorkerMessageType.Prepare;
+}
+export interface MaskPreparationWorkerCompleteMessage {
+    readonly artifactKind?: PreparedMaskFrameKind;
+    readonly fillPalette?: Float32Array<ArrayBuffer>;
+    readonly hasStroke?: boolean;
+    readonly imageBitmap?: ImageBitmap;
+    readonly imageData?: ImageData;
+    readonly key: string;
+    readonly maxStrokeWidth?: number;
+    readonly png?: Uint8Array<ArrayBuffer>;
+    readonly requestId: number;
+    readonly strokePalette?: Float32Array<ArrayBuffer>;
+    readonly strokeWidths?: Float32Array<ArrayBuffer>;
+    readonly type: MaskPreparationWorkerMessageType.Complete;
+}
+export interface MaskPreparationWorkerEmptyMessage {
+    readonly key: string;
+    readonly requestId: number;
+    readonly type: MaskPreparationWorkerMessageType.Empty;
+}
+export interface MaskPreparationWorkerErrorMessage {
+    readonly error: string;
+    readonly key: string;
+    readonly requestId: number;
+    readonly type: MaskPreparationWorkerMessageType.Error;
+}
+export type MaskPreparationWorkerRequest = MaskPreparationWorkerPrepareMessage;
+export type MaskPreparationWorkerResponse = MaskPreparationWorkerCompleteMessage | MaskPreparationWorkerEmptyMessage | MaskPreparationWorkerErrorMessage;
+export {};
+//# sourceMappingURL=mask-preparation-worker-protocol.d.ts.map

package/dist/render-preparation/mask-preparation-worker-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-preparation-worker-protocol.d.ts","sourceRoot":"","sources":["../../src/render-preparation/mask-preparation-worker-protocol.ts"],"names":[],"mappings":"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"}

package/dist/render-preparation/mask-preparation.worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mask-preparation.worker.d.ts.map

package/dist/render-preparation/mask-preparation.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-preparation.worker.d.ts","sourceRoot":"","sources":["../../src/render-preparation/mask-preparation.worker.ts"],"names":[],"mappings":""}

package/dist/render-preparation/prepared-render-window.d.ts

@@ -0,0 +1,46 @@
+import { type PreparedMaskFrame } from "#render-preparation/mask-frame-preparer";
+import type { SerializableMaskInstruction } from "#render-preparation/mask-preparation-worker-protocol";
+import { type PreparedRenderTimelineContext } from "#render-preparation/prepared-window-timeline";
+import { type BufferedDetectionTimeline } from "supervision-js-core";
+import type { DetectionFrame } from "supervision-js-core";
+import type { MaskStyle } from "supervision-js-core";
+import { RenderPreparationArtifactKind, type RenderPreparationOptions, type RenderPreparationPlaybackGateOptions } from "#types/render-preparation";
+export interface PreparedRenderFrame {
+    readonly detectionFrame: DetectionFrame;
+    readonly key: string;
+    readonly maskFrame?: PreparedMaskFrame;
+    readonly maskStatus: PreparedRenderFrameMaskStatus;
+}
+export declare enum PreparedRenderFrameMaskStatus {
+    Disabled = "disabled",
+    Empty = "empty",
+    Pending = "pending",
+    Prepared = "prepared"
+}
+export interface PreparedRenderWindow {
+    getFrame(mediaTime: number): PreparedRenderFrame | undefined;
+    waitForReady(mediaTime: number, options: RenderPreparationPlaybackGateOptions): Promise<void>;
+    setTimelineContext(context: PreparedRenderTimelineContext): void;
+    setMaskStyle(maskStyle: MaskStyle | null | undefined): void;
+    destroy(): void;
+}
+export type { PreparedMaskFrame } from "./mask-frame-preparer";
+export type { PreparedRenderTimelineContext } from "./prepared-window-timeline";
+export declare function createPreparedRenderWindow(options: {
+    readonly artifactKind?: RenderPreparationArtifactKind;
+    readonly detectionTimeline: BufferedDetectionTimeline;
+    readonly maskStyle?: MaskStyle | null;
+    readonly maxMaskFrameCacheSize?: number;
+    readonly onMaskFrameEvicted?: (key: string) => void;
+    readonly onMaskFramePrepared?: (maskFrame: PreparedMaskFrame) => void;
+    readonly onMaskFramesCleared?: () => void;
+    readonly prefetchFrameCount?: number;
+    readonly preparedWindowScanIntervalSeconds?: number;
+    readonly renderPreparation?: RenderPreparationOptions;
+    readonly resolveInstructions?: (options: {
+        readonly frame: DetectionFrame;
+        readonly maskStyle: MaskStyle;
+        readonly mediaTime: number;
+    }) => readonly SerializableMaskInstruction[];
+}): PreparedRenderWindow;
+//# sourceMappingURL=prepared-render-window.d.ts.map

package/dist/render-preparation/prepared-render-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared-render-window.d.ts","sourceRoot":"","sources":["../../src/render-preparation/prepared-render-window.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AACxG,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAGL,6BAA6B,EAE7B,KAAK,wBAAwB,EAC7B,KAAK,oCAAoC,EAC1C,MAAM,2BAA2B,CAAC;AAyBnC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,CAAC,EAAE,iBAAiB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,6BAA6B,CAAC;CACpD;AAED,oBAAY,6BAA6B;IACvC,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC7D,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oCAAoC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,kBAAkB,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACjE,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IAC5D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,YAAY,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAEhF,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,QAAQ,CAAC,YAAY,CAAC,EAAE,6BAA6B,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,iCAAiC,CAAC,EAAE,MAAM,CAAC;IACpD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE;QACvC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;QAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,KAAK,SAAS,2BAA2B,EAAE,CAAC;CAC9C,GAAG,oBAAoB,CAg9BvB"}

package/dist/render-preparation/prepared-window-timeline.d.ts

@@ -0,0 +1,16 @@
+import type { DetectionFrame } from "supervision-js-core";
+export interface PreparedRenderTimelineContext {
+    readonly duration: number | null;
+    readonly loop: boolean;
+}
+export interface PreparedWindowTimeline {
+    clear(): void;
+    getFrameDistance(frameTime: number, mediaTime: number): number;
+    getWindowFrames(bufferedFrames: readonly DetectionFrame[], mediaTime: number): readonly DetectionFrame[];
+    rememberFrames(frames: readonly DetectionFrame[], retainedKeys: ReadonlySet<string>): void;
+    setContext(context: PreparedRenderTimelineContext): void;
+}
+export declare function createPreparedWindowTimeline(options: {
+    readonly getFrameKey: (frame: DetectionFrame) => string;
+}): PreparedWindowTimeline;
+//# sourceMappingURL=prepared-window-timeline.d.ts.map

package/dist/render-preparation/prepared-window-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared-window-timeline.d.ts","sourceRoot":"","sources":["../../src/render-preparation/prepared-window-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,IAAI,IAAI,CAAC;IACd,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/D,eAAe,CACb,cAAc,EAAE,SAAS,cAAc,EAAE,EACzC,SAAS,EAAE,MAAM,GAChB,SAAS,cAAc,EAAE,CAAC;IAC7B,cAAc,CACZ,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAChC,IAAI,CAAC;IACR,UAAU,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAAC;CAC1D;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,MAAM,CAAC;CACzD,GAAG,sBAAsB,CAqEzB"}

package/dist/renderers/media-renderer-core.d.ts

@@ -0,0 +1,9 @@
+import type { DecodedMediaSource } from "#media/media-source";
+import { type MediaRenderer, type MediaRendererOptions } from "#types/media-renderer";
+import type { MediaRendererScene, MediaRendererSceneOptions } from "./media-renderer-scene";
+export interface MediaRendererCoreProviders {
+    openMediaSource(src: string | URL | Request): Promise<DecodedMediaSource>;
+    createScene(options: MediaRendererSceneOptions): Promise<MediaRendererScene>;
+}
+export declare function createMediaRendererCore(options: MediaRendererOptions, providers: MediaRendererCoreProviders): Promise<MediaRenderer>;
+//# sourceMappingURL=media-renderer-core.d.ts.map

package/dist/renderers/media-renderer-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-renderer-core.d.ts","sourceRoot":"","sources":["../../src/renderers/media-renderer-core.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAE1B,MAAM,uBAAuB,CAAC;AAU/B,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,0BAA0B;IACzC,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC1E,WAAW,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC9E;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,0BAA0B,GACpC,OAAO,CAAC,aAAa,CAAC,CAykBxB"}

package/dist/renderers/media-renderer-scene.d.ts

@@ -0,0 +1,77 @@
+import type { DecodedVideoSample } from "#media/media-source";
+import type { BoxStyle } from "supervision-js-core";
+import type { BufferedDetectionTimeline, DetectionBufferState } from "supervision-js-core";
+import type { DetectionLabelBounds, MediaRendererDiagnosticsOptions, MediaFrameRenderTimings, MediaRendererFit, MediaRendererPresentation } from "#types/media-renderer";
+import type { DetectionPickResult, DetectionSelectionOptions, MediaInteractionOptions } from "supervision-js-core";
+import type { FocusStyle } from "supervision-js-core";
+import type { InteractionStyle } from "supervision-js-core";
+import type { LabelStyle } from "supervision-js-core";
+import type { MaskStyle } from "supervision-js-core";
+import type { PolygonStyle, PolylineStyle, KeypointStyle } from "supervision-js-core";
+import type { MediaDisplayAdjustments } from "supervision-js-core";
+import type { Point, ViewportTransform } from "supervision-js-core";
+import type { AnnotationEditingEngine, AnnotationOverlayStyle, PreviewOverlayData } from "supervision-js-core";
+import type { RenderPreparationOptions, RenderPreparationPlaybackGateOptions } from "#types/render-preparation";
+import type { MaskBrushPreviewOptions } from "#editing/mask-brush-editor";
+export interface MediaRendererSceneOptions {
+    readonly container: HTMLElement;
+    readonly backgroundColor: MediaRendererPresentation["backgroundColor"];
+    readonly fit: MediaRendererFit;
+    readonly maxDevicePixelRatio: number | undefined;
+    readonly detectionTimeline: BufferedDetectionTimeline;
+    readonly boxStyle: BoxStyle | null | undefined;
+    readonly focusStyle: FocusStyle | null | undefined;
+    readonly labelStyle: LabelStyle | null | undefined;
+    readonly maskStyle: MaskStyle | null | undefined;
+    readonly polygonStyle: PolygonStyle | null | undefined;
+    readonly polylineStyle: PolylineStyle | null | undefined;
+    readonly keypointStyle: KeypointStyle | null | undefined;
+    readonly interaction: MediaInteractionOptions | undefined;
+    readonly interactionStyle: InteractionStyle | null | undefined;
+    readonly canInteract: () => boolean;
+    readonly renderPreparation: RenderPreparationOptions | undefined;
+    readonly diagnostics: MediaRendererDiagnosticsOptions | undefined;
+    readonly visibility: MediaRendererPresentation["visibility"];
+    readonly editingEngine: AnnotationEditingEngine | undefined;
+    readonly annotationOverlayStyle: AnnotationOverlayStyle | null | undefined;
+    readonly maskBrush: MaskBrushPreviewOptions | undefined;
+    readonly previewOverlay: (() => PreviewOverlayData | null) | undefined;
+}
+export interface PresentedMediaSample {
+    readonly mediaTime: number;
+    readonly duration?: number;
+    readonly activeDetectionFrameTime: number | null;
+    readonly activeDetectionFrameIndex: number | null;
+    readonly activeDetectionCount: number;
+    readonly detectionBuffer: DetectionBufferState;
+    readonly renderTimings?: MediaFrameRenderTimings;
+}
+export interface MediaRendererScene {
+    readonly rendererBackend: string;
+    initializeMedia(dimensions: {
+        width: number;
+        height: number;
+    }): void;
+    setTimelineContext?(context: MediaRendererSceneTimelineContext): void;
+    presentSample(sample: DecodedVideoSample): PresentedMediaSample;
+    waitForRenderPreparation?(mediaTime: number, options: RenderPreparationPlaybackGateOptions): Promise<void>;
+    setRenderQuality(maxDevicePixelRatio: number | undefined): void;
+    setDisplayAdjustments?(adjustments: MediaDisplayAdjustments): void;
+    getViewportTransform?(): ViewportTransform;
+    setViewportTransform?(transform: Partial<Omit<ViewportTransform, "locked">>): void;
+    setViewportLocked?(locked: boolean): void;
+    screenToMedia?(point: Point): Point;
+    mediaToScreen?(point: Point): Point;
+    getDetectionLabelBounds?(detectionId: string | number): DetectionLabelBounds | null;
+    panViewportBy?(dx: number, dy: number): void;
+    zoomViewportAt?(point: Point, factor: number): void;
+    zoomViewportFromWheel?(point: Point, deltaY: number): void;
+    setPresentation(presentation: MediaRendererPresentation, mediaTime: number): PresentedMediaSample | void;
+    setSelectedDetection?(selection: DetectionSelectionOptions | null, mediaTime: number): DetectionPickResult | null;
+    destroy(): void;
+}
+export interface MediaRendererSceneTimelineContext {
+    readonly duration: number | null;
+    readonly loop: boolean;
+}
+//# sourceMappingURL=media-renderer-scene.d.ts.map

package/dist/renderers/media-renderer-scene.d.ts.map

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

package/dist/renderers/media-renderer-state.d.ts

@@ -0,0 +1,44 @@
+import type { DecodedMediaSourceMetadata } from "#media/media-source";
+import type { DetectionBufferState } from "supervision-js-core";
+import { type MediaFrameDiagnostics, type MediaRendererFit, type MediaRendererState, type MediaSourceState } from "#types/media-renderer";
+import type { PresentedMediaSample } from "./media-renderer-scene";
+interface MediaRendererRuntimeStateOptions {
+    readonly fit: MediaRendererFit;
+    readonly playbackRate: number;
+    readonly getDetectionBufferState: () => DetectionBufferState;
+    readonly onFrame?: (diagnostics: MediaFrameDiagnostics) => void;
+    readonly onSource?: (state: MediaSourceState) => void;
+    readonly onState?: (state: MediaRendererState) => void;
+}
+export interface MediaRendererRuntimeState {
+    currentTime(): number;
+    duration(): number | null;
+    errorMessage(): string | null;
+    isDestroyed(): boolean;
+    isError(): boolean;
+    isPlaybackActive(): boolean;
+    isBuffering(): boolean;
+    isPlaying(): boolean;
+    emitSourceState(): void;
+    recordMediaMetadata(metadata: DecodedMediaSourceMetadata): {
+        height: number;
+        width: number;
+    };
+    setSourceReady(metadata: DecodedMediaSourceMetadata): void;
+    setCurrentTime(currentTime: number): void;
+    setPlaybackRate(playbackRate: number): void;
+    setRendererBackend(rendererBackend: string | null): void;
+    recordPresentedSample(sample: PresentedMediaSample): void;
+    recordPresentationUpdate(sample: PresentedMediaSample): void;
+    setReady(): void;
+    setPlaying(): void;
+    setBuffering(): void;
+    setPaused(): void;
+    setRenderError(error: unknown): void;
+    markDestroyed(): void;
+    setSourceDestroyed(): void;
+    snapshot(): MediaRendererState;
+}
+export declare function createMediaRendererRuntimeState(options: MediaRendererRuntimeStateOptions): MediaRendererRuntimeState;
+export {};
+//# sourceMappingURL=media-renderer-state.d.ts.map

package/dist/renderers/media-renderer-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-renderer-state.d.ts","sourceRoot":"","sources":["../../src/renderers/media-renderer-state.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAGL,KAAK,qBAAqB,EAE1B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACtB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,UAAU,gCAAgC;IACxC,QAAQ,CAAC,GAAG,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,yBAAyB;IACxC,WAAW,IAAI,MAAM,CAAC;IACtB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,IAAI,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,IAAI,OAAO,CAAC;IACvB,OAAO,IAAI,OAAO,CAAC;IACnB,gBAAgB,IAAI,OAAO,CAAC;IAC5B,WAAW,IAAI,OAAO,CAAC;IACvB,SAAS,IAAI,OAAO,CAAC;IACrB,eAAe,IAAI,IAAI,CAAC;IACxB,mBAAmB,CAAC,QAAQ,EAAE,0BAA0B,GAAG;QACzD,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,cAAc,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC3D,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,kBAAkB,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACzD,qBAAqB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC1D,wBAAwB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC7D,QAAQ,IAAI,IAAI,CAAC;IACjB,UAAU,IAAI,IAAI,CAAC;IACnB,YAAY,IAAI,IAAI,CAAC;IACrB,SAAS,IAAI,IAAI,CAAC;IAClB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC,aAAa,IAAI,IAAI,CAAC;IACtB,kBAAkB,IAAI,IAAI,CAAC;IAC3B,QAAQ,IAAI,kBAAkB,CAAC;CAChC;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,gCAAgC,GACxC,yBAAyB,CAmN3B"}

package/dist/renderers/media-renderer.d.ts

@@ -0,0 +1,8 @@
+import type { MediaRenderer, MediaRendererOptions } from "#types/media-renderer";
+/**
+ * Mediabunny owns media reading and video decode; Pixi owns the visible
+ * default scene adapter. Renderer orchestration stays in the provider-agnostic
+ * core.
+ */
+export declare function createMediaRenderer(options: MediaRendererOptions): Promise<MediaRenderer>;
+//# sourceMappingURL=media-renderer.d.ts.map

package/dist/renderers/media-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-renderer.d.ts","sourceRoot":"","sources":["../../src/renderers/media-renderer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAI/B;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,aAAa,CAAC,CAKxB"}

package/dist/renderers/pixi-annotation-overlay-layer.d.ts

@@ -0,0 +1,25 @@
+import { type AnnotationEditingEngine, type AnnotationOverlayStyle, type AnnotationVisibility, type DetectionFrame, type Point, type PreviewOverlayData } from "supervision-js-core";
+import type { Graphics as PixiGraphics } from "pixi.js";
+export interface PixiAnnotationOverlayLayer {
+    attachGraphics(graphics: PixiGraphics): void;
+    setStyle(style: AnnotationOverlayStyle | null | undefined): void;
+    draw(context: {
+        frame: DetectionFrame | undefined;
+        selectedDetectionIds: readonly (string | number)[];
+        pointer: Point | null;
+        marquee: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        } | null;
+        viewportScale: number;
+        mediaWidth: number;
+        mediaHeight: number;
+        visibility?: AnnotationVisibility;
+        previewOverlay?: PreviewOverlayData | null;
+        now: number;
+    }): void;
+}
+export declare function createPixiAnnotationOverlayLayer(editingEngine?: AnnotationEditingEngine, initialStyle?: AnnotationOverlayStyle | null): PixiAnnotationOverlayLayer;
+//# sourceMappingURL=pixi-annotation-overlay-layer.d.ts.map