supervision 0.1.7 → 0.2.0-next.0

package/dist/renderers/pixi-mask-layer.d.ts

@@ -1,11 +1,13 @@
 import { type PreparedRenderTimelineContext } from "#render-preparation/prepared-render-window";
-import { type PreparedPngIdMaskFrame } from "#render-preparation/mask-frame-artifact";
+import { IdMaskTextureFormat, type PreparedIdMaskFrame, type PreparedRegionMaskCoverageEntry, type PreparedRegionMaskCoverageFrame } from "#render-preparation/mask-frame-artifact";
 import type { BufferedDetectionTimeline } from "supervision-js-core";
 import type { DetectionPickPoint, DetectionPickResult } from "supervision-js-core";
 import type { MaskHaloStyle, MaskStyle } from "supervision-js-core";
-import type { RenderPreparationOptions, RenderPreparationArtifactKind, RenderPreparationPlaybackGateOptions } from "#types/render-preparation";
+import { RenderPreparationArtifactKind } from "#types/render-preparation";
+import type { RenderPreparationMaskFrameOptions, RenderPreparationOptions, RenderPreparationPlaybackGateOptions } from "#types/render-preparation";
+import type { PresentedFrameId } from "./presented-frame-channel";
 import type { SerializableMaskInstruction } from "#render-preparation/mask-preparation-worker-protocol";
-import type { Container as PixiContainer, ImageSource as PixiImageSource, Mesh as PixiMesh, MeshGeometry as PixiMeshGeometry, Shader as PixiShader, Sprite as PixiSprite, Texture as PixiTexture, UniformGroup as PixiUniformGroup } from "pixi.js";
+import type { BufferImageSource as PixiBufferImageSource, Container as PixiContainer, ImageSource as PixiImageSource, Mesh as PixiMesh, MeshGeometry as PixiMeshGeometry, Shader as PixiShader, Sprite as PixiSprite, Texture as PixiTexture, UniformGroup as PixiUniformGroup } from "pixi.js";
 type ImageSourceConstructor = new (options: {
     autoGenerateMipmaps?: boolean;
     dynamic: boolean;
@@ -14,9 +16,18 @@ type ImageSourceConstructor = new (options: {
     scaleMode?: "linear" | "nearest";
     width: number;
 }) => PixiImageSource;
+export type BufferImageSourceConstructor = new (options: {
+    autoGenerateMipmaps?: boolean;
+    dynamic: boolean;
+    format: IdMaskTextureFormat;
+    height: number;
+    resource: Uint8Array;
+    scaleMode?: "linear" | "nearest";
+    width: number;
+}) => PixiBufferImageSource;
 type TextureConstructor = new (options: {
     dynamic: boolean;
-    source: PixiImageSource;
+    source: PixiImageSource | PixiBufferImageSource;
 }) => PixiTexture;
 type TextureConstructorWithEmpty = TextureConstructor & {
     readonly EMPTY: PixiTexture;
@@ -57,26 +68,72 @@ type UniformGroupConstructor = new (uniforms: Record<string, {
     type: "vec2<f32>" | "vec4<f32>";
     value: Float32Array;
 }>) => PixiUniformGroup;
+/**
+ * What the mask layer has on screen after its last draw.
+ *
+ * `drawnFrameTime` is the detection frame the visible raster belongs to. It is
+ * the frame the rest of the present drew, or the frame beside it while that
+ * frame's own cook is owed, or the layer draws nothing.
+ * `drawnFrameId` names the producer frame that raster was accepted for, and is
+ * null on a draw the producer did not drive: a pull-path sample and a redraw at
+ * a resting playhead both carry a media time and no frame identity.
+ */
+export interface PixiMaskLayerState {
+    readonly drawnFrameTime: number | null;
+    readonly drawnFrameKey: string | null;
+    readonly drawnFrameId: PresentedFrameId | null;
+}
 export interface PixiMaskLayer {
     createSprite(dimensions: {
         width: number;
         height: number;
     }): PixiContainer | PixiSprite;
-    drawFrame(mediaTime: number): void;
+    drawFrame(mediaTime: number, presentedFrameId?: PresentedFrameId | null): void;
+    /** The state the last drawFrame or clearFrame left on screen. */
+    getDrawnState(): PixiMaskLayerState;
+    /** Puts the media time in front of the cook without drawing it. */
+    prepareFrame(mediaTime: number): void;
+    clearFrame(): void;
+    isArtifactPrepared(mediaTime: number): boolean;
     waitForRenderPreparation(mediaTime: number, options: RenderPreparationPlaybackGateOptions): Promise<void>;
     pickDetectionAtPoint(point: DetectionPickPoint, mediaTime: number): DetectionPickResult | null;
-    getActiveIdMaskFrameTexture(): PixiActiveIdMaskFrameTexture | null;
+    /**
+     * The raster on screen, for a caller drawing the same detection frame it
+     * belongs to. Both of these are read by layers that pair the raster to
+     * detections by position, so a raster from any other frame pairs one frame's
+     * silhouettes to another frame's detections.
+     */
+    getActiveIdMaskFrameTexture(detectionFrameTime: number | null): PixiActiveIdMaskFrameTexture | null;
+    getActiveRegionMaskCoverage(detectionFrameTime: number | null): PixiActiveRegionMaskCoverage | null;
+    setPlaybackActive(active: boolean): void;
     setTimelineContext(context: PreparedRenderTimelineContext): void;
     setMaskStyle(maskStyle: MaskStyle | null | undefined): void;
     setMaskHaloStyle(maskHaloStyle: MaskHaloStyle | null | undefined): void;
+    /**
+     * Whether the mask fill reaches the screen. Preparation runs either way, so
+     * consumers of the id raster still get an artifact while the fill is off.
+     */
+    setFillVisible(visible: boolean): void;
     destroy(): void;
 }
+/**
+ * Cook-only style for consumers that read detection ids out of the raster
+ * instead of drawing the fill. Ids come from the detection index, so the colour
+ * and alpha here never reach the screen.
+ */
+export declare const ID_MASK_PREPARATION_STYLE: MaskStyle;
+export type IdMaskDisplayBox = NonNullable<RenderPreparationMaskFrameOptions["display"]>;
 export interface PixiActiveIdMaskFrameTexture {
-    readonly frame: PreparedPngIdMaskFrame;
+    readonly frame: PreparedIdMaskFrame;
     readonly texture: PixiTexture;
 }
+export interface PixiActiveRegionMaskCoverage {
+    readonly frame: PreparedRegionMaskCoverageFrame;
+    getTexture(entry: PreparedRegionMaskCoverageEntry): PixiTexture | undefined;
+}
 export declare function createPixiMaskLayer(options: {
     readonly artifactKind?: RenderPreparationArtifactKind;
+    readonly BufferImageSource?: BufferImageSourceConstructor;
     readonly Container?: ContainerConstructor;
     readonly ImageSource: ImageSourceConstructor;
     readonly Mesh?: MeshConstructor;
@@ -95,7 +152,13 @@ export declare function createPixiMaskLayer(options: {
     readonly detectionTimeline: BufferedDetectionTimeline;
     readonly maskHaloStyle?: MaskHaloStyle | null;
     readonly maskStyle: MaskStyle;
-    readonly onActiveIdMaskFramePresented?: () => void;
+    readonly onPreparedWindowChange?: () => void;
+    /**
+     * Whether the renderer takes a single-channel upload whose rows are not on a
+     * four-byte boundary. Answered when the first raster is uploaded, since the
+     * renderer this scene ends up with is not known when the layer is built.
+     */
+    readonly acceptsUnalignedTextureRows?: () => boolean;
     readonly renderPreparation?: RenderPreparationOptions;
     readonly resolveInstructions?: (options: {
         readonly frame: import("supervision-js-core").DetectionFrame;

package/dist/renderers/pixi-mask-layer.d.ts.map

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

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

@@ -1,6 +1,73 @@
 import type { AnnotationVisibility } from "supervision-js-core";
 import type { MediaRendererScene, MediaRendererSceneOptions } from "./media-renderer-scene";
 export declare function observePixiContainerResize(container: HTMLElement, resize: () => void): () => void;
+type MediaCompositor = {
+    upload(frame: VideoFrame): void;
+    destroy(): void;
+};
+/** The binding a compositor points at whichever texture holds the last frame. */
+export interface MediaGpuTextureSource {
+    resize(width: number, height: number, resolution: number): void;
+    updateGPUTexture(texture: GPUTexture): void;
+}
+export interface MediaCompositorOptions {
+    readonly device: GPUDevice;
+    readonly height: number;
+    readonly width: number;
+    /**
+     * Puts the compositor's first texture on screen and returns the binding every
+     * later texture replaces it through.
+     */
+    readonly attach: (texture: GPUTexture) => MediaGpuTextureSource;
+    /** Runs after a decode of a new size swapped the texture underneath. */
+    readonly onTextureReplaced: () => void;
+}
+/**
+ * Two ways to drive the same layer stack.
+ *
+ * Pull presentation is the default: the renderer asks the media source for the
+ * sample it wants, hands it to `presentSample`, and Pixi's ticker paints the
+ * scene every frame.
+ *
+ * Push presentation engages when the opened source carries a presented-frame
+ * channel. The producer then decides which frame is on screen and announces it,
+ * so the ticker paints nothing and every render is an explicit answer to a
+ * change: a presented frame, a layer turned on or off, restyling, hover or
+ * selection, a viewport move, a resize, or the swapchain coming back after the
+ * tab was hidden. A notification that describes what is already drawn renders
+ * nothing, so a paused scene nobody touches renders nothing at all.
+ *
+ * The focus layer's fade is not an exception to that. It advances with the
+ * presented media time, so it fades during playback and is applied at once when
+ * a hover or selection arrives with no frame behind it: paused focus is static,
+ * and no animation keeps the scene rendering on its own.
+ */
 export declare function createPixiMediaScene(options: MediaRendererSceneOptions): Promise<MediaRendererScene>;
 export declare function canReuseMaskVisibilityArtifacts(previous: AnnotationVisibility | undefined, next: AnnotationVisibility | undefined): boolean;
+/**
+ * Copies presented frames into a GPU texture Pixi samples, with no CPU readback
+ * in between. A decode whose size changed gets a new texture, and the swap is
+ * all-or-nothing: exactly one of the two textures survives it.
+ */
+export declare function createMediaCompositor(options: MediaCompositorOptions): MediaCompositor;
+/**
+ * Whether this device's queue takes a decoded frame as a copy source.
+ *
+ * Chrome converts a VideoFrame. Firefox's converter accepts only ImageBitmap,
+ * HTMLImageElement, HTMLCanvasElement and OffscreenCanvas, and rejects the
+ * frame with a TypeError thrown from inside the present. The present abandons
+ * the steps after the upload, so the media sprite keeps a texture nothing ever
+ * wrote to while the redraw at the resting playhead keeps putting annotations
+ * over it: the scene then reads as a working library over a broken video,
+ * which is worse than an error. Answering here instead routes those frames
+ * through the staging canvas, which every non-WebGPU scene already uses.
+ *
+ * The answer is a property of the browser rather than of the decode, so it is
+ * asked once when the compositor is built and never per frame: a browser that
+ * takes the frame pays one one-pixel copy each time media is opened, and
+ * nothing at all while it plays.
+ */
+export declare function acceptsVideoFrameUpload(device: GPUDevice): boolean;
+export declare function resolvePixiResolution(maxDevicePixelRatio: number | undefined): number;
+export {};
 //# sourceMappingURL=pixi-media-scene.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pixi-media-scene.d.ts","sourceRoot":"","sources":["../../src/renderers/pixi-media-scene.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAQhE,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EAG1B,MAAM,wBAAwB,CAAC;AAmChC,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,MAAM,IAAI,GACjB,MAAM,IAAI,CASZ;AAUD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,CAAC,CA44C7B;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAC1C,IAAI,EAAE,oBAAoB,GAAG,SAAS,WAoBvC"}
+{"version":3,"file":"pixi-media-scene.d.ts","sourceRoot":"","sources":["../../src/renderers/pixi-media-scene.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EAG1B,MAAM,wBAAwB,CAAC;AAuHhC,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,MAAM,IAAI,GACjB,MAAM,IAAI,CASZ;AAMD,KAAK,eAAe,GAAG;IACrB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,OAAO,IAAI,IAAI,CAAC;CACjB,CAAC;AAEF,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,qBAAqB,CAAC;IAChE,wEAAwE;IACxE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,CAAC,CAmyE7B;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,oBAAoB,GAAG,SAAS,EAC1C,IAAI,EAAE,oBAAoB,GAAG,SAAS,WAoBvC;AAmBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,GAC9B,eAAe,CAqDjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAgClE;AAmED,wBAAgB,qBAAqB,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,UAK5E"}

package/dist/renderers/pixi-polygon-layer.d.ts

@@ -1,6 +1,6 @@
 import type { SerializableMaskInstruction } from "#render-preparation/mask-preparation-worker-protocol";
 import { type AnnotationStyleContext, type Detection, type DetectionFrame, type PolygonDrawInstruction, type PolygonStyle } from "supervision-js-core";
-import { createPixiMaskLayer, type PixiMaskLayer } from "./pixi-mask-layer";
+import { createPixiMaskLayer, type BufferImageSourceConstructor, type PixiMaskLayer } from "./pixi-mask-layer";
 type PixiMaskLayerOptions = Parameters<typeof createPixiMaskLayer>[0];
 export interface PixiPolygonLayer {
     createDisplay(dimensions: {
@@ -8,13 +8,18 @@ export interface PixiPolygonLayer {
         readonly width: number;
     }): ReturnType<PixiMaskLayer["createSprite"]>;
     drawFrame(mediaTime: number, viewportScale?: number): void;
+    prepareFrame(mediaTime: number, viewportScale?: number): void;
+    clearFrame: PixiMaskLayer["clearFrame"];
+    isArtifactPrepared: PixiMaskLayer["isArtifactPrepared"];
     getVectorFallbackStyle(): PolygonStyle;
     setPolygonStyle(polygonStyle: PolygonStyle | null | undefined): void;
     setTimelineContext: PixiMaskLayer["setTimelineContext"];
     waitForRenderPreparation: PixiMaskLayer["waitForRenderPreparation"];
     destroy(): void;
 }
-export declare function createPixiPolygonLayer(options: Omit<PixiMaskLayerOptions, "artifactKind" | "maskStyle" | "resolveInstructions"> & {
+export declare function createPixiPolygonLayer(options: Omit<PixiMaskLayerOptions, "BufferImageSource" | "artifactKind" | "maskStyle" | "resolveInstructions"> & {
+    /** Without it a frame that cooked to an id raster reaches no texture. */
+    readonly BufferImageSource: BufferImageSourceConstructor;
     readonly polygonStyle: PolygonStyle;
     readonly resolveContextState?: (detection: Detection) => Partial<AnnotationStyleContext>;
 }): PixiPolygonLayer;

package/dist/renderers/pixi-polygon-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pixi-polygon-layer.d.ts","sourceRoot":"","sources":["../../src/renderers/pixi-polygon-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AAExG,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,KAAK,cAAc,EAEnB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE5E,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,UAAU,EAAE;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,GAAG,UAAU,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAC9C,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,sBAAsB,IAAI,YAAY,CAAC;IACvC,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IACrE,kBAAkB,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACxD,wBAAwB,EAAE,aAAa,CAAC,0BAA0B,CAAC,CAAC;IACpE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,IAAI,CACX,oBAAoB,EACpB,cAAc,GAAG,WAAW,GAAG,qBAAqB,CACrD,GAAG;IACF,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAC7B,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtC,GACA,gBAAgB,CA6FlB;AAED,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,sBAAsB,WAcpC;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE;IAC1D,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAC7B,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GAAG,SAAS,2BAA2B,EAAE,CAkDzC"}
+{"version":3,"file":"pixi-polygon-layer.d.ts","sourceRoot":"","sources":["../../src/renderers/pixi-polygon-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AAExG,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,SAAS,EACd,KAAK,cAAc,EAEnB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,KAAK,4BAA4B,EACjC,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAE3B,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,UAAU,EAAE;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,GAAG,UAAU,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC,CAAC;IAC9C,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9D,UAAU,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACxC,kBAAkB,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACxD,sBAAsB,IAAI,YAAY,CAAC;IACvC,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IACrE,kBAAkB,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;IACxD,wBAAwB,EAAE,aAAa,CAAC,0BAA0B,CAAC,CAAC;IACpE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,IAAI,CACX,oBAAoB,EACpB,mBAAmB,GAAG,cAAc,GAAG,WAAW,GAAG,qBAAqB,CAC3E,GAAG;IACF,yEAAyE;IACzE,QAAQ,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;IACzD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAC7B,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtC,GACA,gBAAgB,CAwGlB;AAED,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,sBAAsB,WAcpC;AAED,wBAAgB,kCAAkC,CAAC,OAAO,EAAE;IAC1D,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAC7B,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GAAG,SAAS,2BAA2B,EAAE,CAkDzC"}

package/dist/renderers/pixi-region-coverage-mask.d.ts

@@ -0,0 +1,91 @@
+import type { PreparedRegionMaskCoverageEntry } from "#render-preparation/mask-frame-artifact";
+import type { AlphaMask as PixiAlphaMask, ImageSource as PixiImageSource, Mesh as PixiMesh, MeshGeometry as PixiMeshGeometry, Shader as PixiShader, Texture as PixiTexture, UniformGroup as PixiUniformGroup } from "pixi.js";
+type RegionCoverageMaskMesh = PixiMesh<PixiMeshGeometry, PixiShader>;
+type AlphaMaskConstructor = new (options: {
+    mask: RegionCoverageMaskMesh;
+}) => PixiAlphaMask;
+type ImageSourceConstructor = new (options: {
+    autoGenerateMipmaps?: boolean;
+    dynamic: boolean;
+    height: number;
+    resource: HTMLCanvasElement;
+    scaleMode?: "linear" | "nearest";
+    width: number;
+}) => PixiImageSource;
+type MeshConstructor = new (options: {
+    geometry: PixiMeshGeometry;
+    shader: PixiShader;
+}) => RegionCoverageMaskMesh;
+type MeshGeometryConstructor = new (options: {
+    indices: Uint32Array;
+    positions: Float32Array;
+    shrinkBuffersToFit: boolean;
+    topology: "triangle-list";
+    uvs: Float32Array;
+}) => PixiMeshGeometry;
+type ShaderFactory = {
+    from(options: {
+        gl: {
+            fragment: string;
+            vertex: string;
+        };
+        gpu: {
+            fragment: {
+                entryPoint: string;
+                source: string;
+            };
+            vertex: {
+                entryPoint: string;
+                source: string;
+            };
+        };
+        resources: Record<string, unknown>;
+    }): PixiShader;
+};
+type UniformGroupConstructor = new (uniforms: Record<string, {
+    type: "f32";
+    value: number;
+} | {
+    type: "vec4<f32>";
+    value: Float32Array;
+}>) => PixiUniformGroup;
+export interface PixiRegionCoverageMaskArtifact {
+    readonly texture: PixiTexture;
+}
+export interface PixiRegionCoverageMask {
+    readonly display: RegionCoverageMaskMesh;
+    readonly effect: PixiAlphaMask;
+    render(options: {
+        readonly artifact: PixiRegionCoverageMaskArtifact;
+        readonly coverage: PreparedRegionMaskCoverageEntry;
+        readonly crop: {
+            readonly height: number;
+            readonly width: number;
+            readonly x: number;
+            readonly y: number;
+        };
+        readonly flipHorizontal: boolean;
+        readonly flipVertical: boolean;
+        readonly height: number;
+        readonly rotation: number;
+        readonly width: number;
+        readonly x: number;
+        readonly y: number;
+    }): void;
+    destroy(): void;
+}
+/**
+ * Produces a per-detection alpha mask from a compact prepared coverage crop.
+ * The crop is sampled and transformed entirely on the GPU; semantic RLE masks
+ * never enter the playback hot path.
+ */
+export declare function createPixiRegionCoverageMask(options: {
+    readonly AlphaMask: AlphaMaskConstructor;
+    readonly ImageSource: ImageSourceConstructor;
+    readonly Mesh: MeshConstructor;
+    readonly MeshGeometry: MeshGeometryConstructor;
+    readonly Shader: ShaderFactory;
+    readonly UniformGroup: UniformGroupConstructor;
+}): PixiRegionCoverageMask;
+export {};
+//# sourceMappingURL=pixi-region-coverage-mask.d.ts.map

package/dist/renderers/pixi-region-coverage-mask.d.ts.map

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

package/dist/renderers/pixi-region-effect.d.ts

@@ -0,0 +1,42 @@
+import { type RegionRendererMediaEffect } from "supervision-js-core";
+import type { Filter as PixiFilterClass } from "pixi.js";
+type PixiFilter = {
+    destroy?(): void;
+    padding?: number;
+};
+type PixiFilterDisplay = {
+    filters?: readonly PixiFilter[] | null;
+};
+type BlurFilterConstructor = new (options: {
+    kernelSize?: number;
+    quality?: number;
+    repeatEdgePixels?: boolean;
+    strength?: number;
+}) => PixiFilter;
+type FilterFactory = Pick<typeof PixiFilterClass, "from">;
+export interface PixiRegionEffect {
+    /**
+     * Applies the effect at the current media-to-viewport scale.
+     *
+     * Public effect sizes are expressed in media pixels, while Pixi evaluates a
+     * filter over the scaled display texture. Rebuild only when that scale
+     * changes so the filter's rendered-pixel inputs remain semantically stable.
+     */
+    apply(display: PixiFilterDisplay, viewportScale?: number): void;
+    destroy(): void;
+}
+/**
+ * Creates one filter for one pooled region display.
+ *
+ * The public descriptor stays semantic. This browser-only primitive owns the
+ * Pixi filter and is deliberately kept beneath the region layer so no filter,
+ * shader, texture, or render target appears in the package API.
+ */
+export declare function createPixiRegionEffect(options: {
+    readonly BlurFilter?: BlurFilterConstructor;
+    readonly defaultFilterVert?: string;
+    readonly Filter?: FilterFactory;
+    readonly effect: RegionRendererMediaEffect;
+}): PixiRegionEffect | undefined;
+export {};
+//# sourceMappingURL=pixi-region-effect.d.ts.map

package/dist/renderers/pixi-region-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixi-region-effect.d.ts","sourceRoot":"","sources":["../../src/renderers/pixi-region-effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,SAAS,CAAC;AAEzD,KAAK,UAAU,GAAG;IAChB,OAAO,CAAC,IAAI,IAAI,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAAC;CACxC,CAAC;AAEF,KAAK,qBAAqB,GAAG,KAAK,OAAO,EAAE;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,KAAK,UAAU,CAAC;AAEjB,KAAK,aAAa,GAAG,IAAI,CAAC,OAAO,eAAe,EAAE,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;CAC5C,GAAG,gBAAgB,GAAG,SAAS,CAuD/B"}

package/dist/renderers/pixi-region-layer.d.ts

@@ -1,6 +1,7 @@
 import type { AnnotationStyleContext, BufferedDetectionTimeline, Detection, RegionAnnotationRenderer } from "supervision-js-core";
-import type { Container as PixiContainer, Sprite as PixiSprite, Texture as PixiTexture } from "pixi.js";
+import type { AlphaMask as PixiAlphaMask, BlurFilter as PixiBlurFilter, Container as PixiContainer, Filter as PixiFilter, Graphics as PixiGraphics, ImageSource as PixiImageSource, Mesh as PixiMesh, MeshGeometry as PixiMeshGeometry, Rectangle as PixiRectangle, Shader as PixiShader, Sprite as PixiSprite, Texture as PixiTexture, UniformGroup as PixiUniformGroup } from "pixi.js";
 import type { GifSource as PixiGifSource, GifSprite as PixiGifSprite } from "pixi.js/gif";
+import type { PixiActiveRegionMaskCoverage } from "./pixi-mask-layer";
 type RegionAsset = PixiTexture | PixiGifSource;
 interface RegionAssetLoader {
     load<T = RegionAsset>(src: string): Promise<T>;
@@ -16,8 +17,18 @@ export interface PixiRegionLayer {
     translateDetection(id: string | number, x: number, y: number): boolean;
     destroy(): void;
 }
-/** Browser implementation for asset-backed region renderer descriptors. */
+/** Browser implementation for asset- and media-backed region descriptors. */
 export declare function createPixiRegionLayer(options: {
+    readonly AlphaMask: new (options: {
+        mask: PixiMesh<PixiMeshGeometry, PixiShader>;
+    }) => PixiAlphaMask;
+    readonly BlurFilter?: new (options: {
+        kernelSize?: number;
+        quality?: number;
+        repeatEdgePixels?: boolean;
+        strength?: number;
+    }) => PixiBlurFilter;
+    readonly defaultFilterVert?: string;
     readonly Assets: RegionAssetLoader;
     readonly Container: new () => PixiContainer;
     readonly GifSprite: new (options: {
@@ -25,10 +36,65 @@ export declare function createPixiRegionLayer(options: {
         readonly loop?: boolean;
         readonly source: PixiGifSource;
     }) => PixiGifSprite;
+    readonly Filter?: typeof PixiFilter;
+    readonly Graphics: new () => PixiGraphics;
+    readonly ImageSource: new (options: {
+        autoGenerateMipmaps?: boolean;
+        dynamic: boolean;
+        height: number;
+        resource: HTMLCanvasElement;
+        scaleMode?: "linear" | "nearest";
+        width: number;
+    }) => PixiImageSource;
+    readonly Mesh: new (options: {
+        geometry: PixiMeshGeometry;
+        shader: PixiShader;
+    }) => PixiMesh<PixiMeshGeometry, PixiShader>;
+    readonly MeshGeometry: new (options: {
+        indices: Uint32Array;
+        positions: Float32Array;
+        shrinkBuffersToFit: boolean;
+        topology: "triangle-list";
+        uvs: Float32Array;
+    }) => PixiMeshGeometry;
+    readonly Rectangle: new (x?: number, y?: number, width?: number, height?: number) => PixiRectangle;
     readonly Sprite: new (options: {
         texture: PixiTexture;
     }) => PixiSprite;
+    readonly Shader: {
+        from(options: {
+            gl: {
+                fragment: string;
+                vertex: string;
+            };
+            gpu: {
+                fragment: {
+                    entryPoint: string;
+                    source: string;
+                };
+                vertex: {
+                    entryPoint: string;
+                    source: string;
+                };
+            };
+            resources: Record<string, unknown>;
+        }): PixiShader;
+    };
+    readonly Texture: new (options: {
+        readonly dynamic?: boolean;
+        readonly frame?: PixiRectangle;
+        readonly source: PixiTexture["source"];
+    }) => PixiTexture;
+    readonly UniformGroup: new (uniforms: Record<string, {
+        type: "f32";
+        value: number;
+    } | {
+        type: "vec4<f32>";
+        value: Float32Array;
+    }>) => PixiUniformGroup;
     readonly detectionTimeline: BufferedDetectionTimeline;
+    readonly getActiveRegionMaskCoverage: (detectionFrameTime: number | null) => PixiActiveRegionMaskCoverage | null;
+    readonly getMediaTexture: () => PixiTexture | undefined;
     readonly onInvalidate?: () => void;
     readonly onAssetError?: (options: {
         readonly error: unknown;

package/dist/renderers/pixi-region-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pixi-region-layer.d.ts","sourceRoot":"","sources":["../../src/renderers/pixi-region-layer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EACzB,SAAS,EAGT,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,SAAS,IAAI,aAAa,EAC1B,MAAM,IAAI,UAAU,EACpB,OAAO,IAAI,WAAW,EACvB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EACV,SAAS,IAAI,aAAa,EAC1B,SAAS,IAAI,aAAa,EAC3B,MAAM,aAAa,CAAC;AAErB,KAAK,WAAW,GAAG,WAAW,GAAG,aAAa,CAAC;AAG/C,UAAU,iBAAiB;IACzB,IAAI,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAwBD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;CACpD;AAED,MAAM,WAAW,eAAe;IAC9B,eAAe,IAAI,aAAa,CAAC;IACjC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAAC;IAC3E,YAAY,CAAC,SAAS,EAAE,SAAS,wBAAwB,EAAE,GAAG,IAAI,CAAC;IACnE,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,UAAU,aAAa,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,KAAK,OAAO,EAAE;QAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;KAChC,KAAK,aAAa,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,KAAK,OAAO,EAAE;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,KAAK,UAAU,CAAC;IACvE,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE;QAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;KACtB,KAAK,IAAI,CAAC;IACX,QAAQ,CAAC,eAAe,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC9D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAC7B,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtC,GAAG,eAAe,CA0OlB"}
+{"version":3,"file":"pixi-region-layer.d.ts","sourceRoot":"","sources":["../../src/renderers/pixi-region-layer.ts"],"names":[],"mappings":"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"}

package/dist/renderers/pixi-vector-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pixi-vector-layer.d.ts","sourceRoot":"","sources":["../../src/renderers/pixi-vector-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAWL,KAAK,yBAAyB,EAC9B,KAAK,SAAS,EAEd,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAIlB,KAAK,YAAY,EAEjB,KAAK,aAAa,EAElB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,SAAS,IAAI,aAAa,EAC1B,QAAQ,IAAI,YAAY,EACzB,MAAM,SAAS,CAAC;AAiBjB,MAAM,WAAW,eAAe;IAC9B,eAAe,IAAI,aAAa,CAAC;IACjC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/C,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvE,SAAS,CAAC,MAAM,EAAE;QAChB,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;QACnC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QACrC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QACrC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;KAChC,GAAG,IAAI,CAAC;IACT,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,SAAS,EAAE,UAAU,aAAa,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,UAAU,YAAY,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAC7B,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtC,GAAG,eAAe,CA2OlB;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,uBAAuB,EACpC,aAAa,EAAE,MAAM,QAoDtB"}
+{"version":3,"file":"pixi-vector-layer.d.ts","sourceRoot":"","sources":["../../src/renderers/pixi-vector-layer.ts"],"names":[],"mappings":"AAAA,OAAO,EAWL,KAAK,yBAAyB,EAC9B,KAAK,SAAS,EAEd,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAIlB,KAAK,YAAY,EAEjB,KAAK,aAAa,EAElB,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,SAAS,IAAI,aAAa,EAC1B,QAAQ,IAAI,YAAY,EACzB,MAAM,SAAS,CAAC;AAiBjB,MAAM,WAAW,eAAe;IAC9B,eAAe,IAAI,aAAa,CAAC;IACjC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3D,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/C,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACvE,SAAS,CAAC,MAAM,EAAE;QAChB,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;QACnC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QACrC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;QACrC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;KAChC,GAAG,IAAI,CAAC;IACT,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,SAAS,EAAE,UAAU,aAAa,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,UAAU,YAAY,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAC7B,SAAS,EAAE,SAAS,KACjB,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACtC,GAAG,eAAe,CAoPlB;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,uBAAuB,EACpC,aAAa,EAAE,MAAM,QAoDtB"}

package/dist/renderers/prepared-annotation-window.d.ts

@@ -0,0 +1,47 @@
+import type { RenderPreparationOptions } from "#types/render-preparation";
+import type { BufferedDetectionTimeline, DetectionFrame } from "supervision-js-core";
+/** One frame of the window, and whether every enabled layer's data for it is cooked. */
+export interface PreparedAnnotationWindowFrame {
+    readonly frameIndex: number | null;
+    readonly mediaTime: number;
+    readonly prepared: boolean;
+}
+export interface PreparedAnnotationWindowSnapshot {
+    readonly frames: readonly PreparedAnnotationWindowFrame[];
+    readonly playheadMediaTime: number;
+    readonly playheadPrepared: boolean;
+    readonly preparedFrameCount: number;
+    /** Frames ahead of the playhead the cooks aim to cover. */
+    readonly spanFrameCount: number;
+}
+/** A layer that cooks per-frame data ahead of the playhead. */
+export interface PreparedAnnotationLayer {
+    isArtifactPrepared(mediaTime: number): boolean;
+}
+export interface PreparedAnnotationWindow {
+    /**
+     * The detection frame a media time may draw, or null where the timeline holds
+     * none. A layer still cooking its artifact for that frame skips its own draw;
+     * it does not withhold the frame from the layers with nothing to cook.
+     */
+    getPreparedFrame(mediaTime: number): DetectionFrame | null;
+    /**
+     * What a draw of a media time would find: its frame and each layer's cook. A
+     * caller holding the token of what is on screen knows a redraw would change
+     * it, which is how a cook that lands late reaches the screen at all.
+     */
+    getReadinessToken(mediaTime: number): string;
+    getSnapshot(): PreparedAnnotationWindowSnapshot;
+}
+/**
+ * Which frame a media time draws and how much of it is cooked, as two separate
+ * facts. Reporting readiness is what the snapshot and the token are for; a
+ * layer owing an artifact costs that layer its draw, not the whole frame.
+ */
+export declare function createPreparedAnnotationWindow(options: {
+    readonly detectionTimeline: BufferedDetectionTimeline;
+    readonly getLayers: () => readonly PreparedAnnotationLayer[];
+    readonly getPlayheadMediaTime: () => number;
+    readonly renderPreparation?: RenderPreparationOptions;
+}): PreparedAnnotationWindow;
+//# sourceMappingURL=prepared-annotation-window.d.ts.map

package/dist/renderers/prepared-annotation-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared-annotation-window.d.ts","sourceRoot":"","sources":["../../src/renderers/prepared-annotation-window.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAE1E,OAAO,KAAK,EACV,yBAAyB,EACzB,cAAc,EACf,MAAM,qBAAqB,CAAC;AAE7B,wFAAwF;AACxF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,6BAA6B,EAAE,CAAC;IAC1D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CAChD;AAED,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAAC;IAC3D;;;;OAIG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7C,WAAW,IAAI,gCAAgC,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,SAAS,uBAAuB,EAAE,CAAC;IAC7D,QAAQ,CAAC,oBAAoB,EAAE,MAAM,MAAM,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;CACvD,GAAG,wBAAwB,CAmD3B"}