supervision 0.1.7 → 0.2.0-next.1

package/dist/renderers/pixi-interaction-presentation-layer.d.ts.map

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

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

@@ -1,10 +1,8 @@
+import type { InjectedMeshConstructor, InjectedMeshGeometryConstructor, InjectedShaderFactory } from "#renderers/injected-pixi";
+import type { Detection, MaskHaloDrawInstruction, MaskHaloStyle, MaskHaloStyleContext, MaskStyle } from "supervision-js-core";
 import type { Container as PixiContainer, ImageSource as PixiImageSource, Mesh as PixiMesh, MeshGeometry as PixiMeshGeometry, Shader as PixiShader, Texture as PixiTexture, UniformGroup as PixiUniformGroup } from "pixi.js";
 type PixiMaskHaloMesh = PixiMesh<PixiMeshGeometry, PixiShader>;
 type ContainerConstructor = new () => PixiContainer;
-type MeshConstructor = new (options: {
-    geometry: PixiMeshGeometry;
-    shader: PixiShader;
-}) => PixiMaskHaloMesh;
 type ImageSourceConstructor = new (options: {
     autoGenerateMipmaps?: boolean;
     dynamic: boolean;
@@ -13,22 +11,6 @@ type ImageSourceConstructor = new (options: {
     scaleMode?: "linear" | "nearest";
     width: number;
 }) => PixiImageSource;
-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;
-        };
-        resources: Record<string, unknown>;
-    }): PixiShader;
-};
 type UniformGroupConstructor = new (uniforms: Record<string, {
     type: "f32";
     value: number;
@@ -37,6 +19,19 @@ type UniformGroupConstructor = new (uniforms: Record<string, {
     type: "vec4<f32>";
     value: Float32Array;
 }>) => PixiUniformGroup;
+/**
+ * The halo a detection actually paints, or `undefined`. A style may answer an
+ * instruction that draws nothing, and both the coverage the halo prepares and
+ * the passes it renders have to read that the same way: the raster carries one
+ * detection id per pixel, so a detection admitted into the coverage but never
+ * painted still claims its pixels and buries the ids the glow is drawn from.
+ */
+export declare function resolvePaintedMaskHalo(haloStyle: MaskHaloStyle, detection: Detection, context: MaskHaloStyleContext): MaskHaloDrawInstruction | undefined;
+/**
+ * The mask coverage a halo-only presentation prepares. Nothing here reaches the
+ * screen, so the fill colour and alpha are arbitrary.
+ */
+export declare function createMaskHaloPreparationStyle(haloStyle: MaskHaloStyle, artifactKey: string): MaskStyle;
 export interface PixiBlurFilterLike {
     strength: number;
 }
@@ -75,9 +70,9 @@ export declare function createPixiMaskHaloRenderer(options: {
     readonly Container: ContainerConstructor;
     readonly Rectangle: RectangleConstructor;
     readonly ImageSource: ImageSourceConstructor;
-    readonly Mesh: MeshConstructor;
-    readonly MeshGeometry: MeshGeometryConstructor;
-    readonly Shader: ShaderFactory;
+    readonly Mesh: InjectedMeshConstructor<PixiMaskHaloMesh>;
+    readonly MeshGeometry: InjectedMeshGeometryConstructor;
+    readonly Shader: InjectedShaderFactory;
     readonly UniformGroup: UniformGroupConstructor;
     readonly mediaHeight: number;
     readonly mediaWidth: number;

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

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

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

@@ -1,11 +1,14 @@
 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, ResolvedRenderPreparationGateThresholds } from "#types/render-preparation";
+import type { InjectedMeshConstructor, InjectedMeshGeometryConstructor, InjectedShaderFactory } from "#renderers/injected-pixi";
+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, Sprite as PixiSprite, Texture as PixiTexture, UniformGroup as PixiUniformGroup } from "pixi.js";
 type ImageSourceConstructor = new (options: {
     autoGenerateMipmaps?: boolean;
     dynamic: boolean;
@@ -14,9 +17,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;
@@ -25,26 +37,6 @@ type SpriteConstructor = new (options?: {
     texture?: PixiTexture;
 }) => PixiSprite;
 type ContainerConstructor = new () => PixiContainer;
-type MeshConstructor = new (options: {
-    geometry: PixiMeshGeometry;
-    shader: PixiShader;
-}) => PixiMesh;
-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;
-        };
-        resources: Record<string, unknown>;
-    }): PixiShader;
-};
 type UniformGroupConstructor = new (uniforms: Record<string, {
     type: "f32";
     value: number;
@@ -57,31 +49,95 @@ type UniformGroupConstructor = new (uniforms: Record<string, {
     type: "vec2<f32>" | "vec4<f32>";
     value: Float32Array;
 }>) => PixiUniformGroup;
+/**
+ * Whether the frame on screen can answer for detection ids. Hover, selection
+ * and focus highlighting all cut their shapes out of the id raster, so a frame
+ * that reaches the screen without one draws its whole picture while those three
+ * have nothing to cut from.
+ */
+export declare enum PixiMaskLayerIdMaskStatus {
+    /** A mask frame is on screen and carries no id raster. */
+    Absent = "absent",
+    /** No mask frame is on screen. */
+    None = "none",
+    /** The id raster is on screen. */
+    Present = "present"
+}
+/**
+ * What the mask layer has on screen after its last draw.
+ *
+ * `drawnFrameTime` is the detection frame the visible raster belongs to, and it
+ * is the frame the rest of the present drew 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;
+    readonly idMaskStatus: PixiMaskLayerIdMaskStatus;
+}
 export interface PixiMaskLayer {
     createSprite(dimensions: {
         width: number;
         height: number;
     }): PixiContainer | PixiSprite;
-    drawFrame(mediaTime: number): void;
-    waitForRenderPreparation(mediaTime: number, options: RenderPreparationPlaybackGateOptions): Promise<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;
+    /** Frames this layer's preparation has finished, counted up over its life. */
+    getPreparationProgress(): number;
+    /** Whether `waitForRenderPreparation` would wait, scheduling nothing. */
+    needsRenderPreparationWait(mediaTime: number, options: ResolvedRenderPreparationGateThresholds): boolean;
+    waitForRenderPreparation(mediaTime: number, options: ResolvedRenderPreparationGateThresholds, signal?: AbortSignal): 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;
-    readonly MeshGeometry?: MeshGeometryConstructor;
-    readonly Shader?: ShaderFactory;
+    readonly Mesh?: InjectedMeshConstructor<PixiMesh>;
+    readonly MeshGeometry?: InjectedMeshGeometryConstructor;
+    readonly Shader?: InjectedShaderFactory;
     readonly Sprite: SpriteConstructor;
     readonly Texture: TextureConstructorWithEmpty;
     readonly UniformGroup?: UniformGroupConstructor;
@@ -95,7 +151,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":"AAIA,OAAO,EAIL,KAAK,6BAA6B,EACnC,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,oCAAoC,EACrC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AAQxG,OAAO,KAAK,EACV,SAAS,IAAI,aAAa,EAC1B,WAAW,IAAI,eAAe,EAC9B,IAAI,IAAI,QAAQ,EAChB,YAAY,IAAI,gBAAgB,EAChC,MAAM,IAAI,UAAU,EACpB,MAAM,IAAI,UAAU,EACpB,OAAO,IAAI,WAAW,EACtB,YAAY,IAAI,gBAAgB,EACjC,MAAM,SAAS,CAAC;AAIjB,KAAK,sBAAsB,GAAG,KAAK,OAAO,EAAE;IAC1C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,GAAG,WAAW,CAAC;IAC1C,SAAS,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf,KAAK,eAAe,CAAC;AAEtB,KAAK,kBAAkB,GAAG,KAAK,OAAO,EAAE;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;CACzB,KAAK,WAAW,CAAC;AAClB,KAAK,2BAA2B,GAAG,kBAAkB,GAAG;IACtD,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B,CAAC;AAEF,KAAK,iBAAiB,GAAG,KAAK,OAAO,CAAC,EAAE;IACtC,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB,KAAK,UAAU,CAAC;AAEjB,KAAK,oBAAoB,GAAG,UAAU,aAAa,CAAC;AAEpD,KAAK,eAAe,GAAG,KAAK,OAAO,EAAE;IACnC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,UAAU,CAAC;CACpB,KAAK,QAAQ,CAAC;AAEf,KAAK,uBAAuB,GAAG,KAAK,OAAO,EAAE;IAC3C,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,YAAY,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,QAAQ,EAAE,eAAe,CAAC;IAC1B,GAAG,EAAE,YAAY,CAAC;CACnB,KAAK,gBAAgB,CAAC;AAEvB,KAAK,aAAa,GAAG;IACnB,IAAI,CAAC,OAAO,EAAE;QACZ,EAAE,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACzC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,GAAG,UAAU,CAAC;CAChB,CAAC;AAEF,KAAK,uBAAuB,GAAG,KAC7B,QAAQ,EAAE,MAAM,CACd,MAAM,EACJ;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACnD;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAC1E,KACE,gBAAgB,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,YAAY,CAAC,UAAU,EAAE;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,aAAa,GAAG,UAAU,CAAC;IAC/B,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oCAAoC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,oBAAoB,CAClB,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,GAChB,mBAAmB,GAAG,IAAI,CAAC;IAC9B,2BAA2B,IAAI,4BAA4B,GAAG,IAAI,CAAC;IACnE,kBAAkB,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACjE,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IAC5D,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IACxE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,QAAQ,CAAC,YAAY,CAAC,EAAE,6BAA6B,CAAC;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,2BAA2B,CAAC;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,KACnB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,KACX,OAAO,CAAC;IACb,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,OAAO,EAAE;QAClC,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,KAAK;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,yBAAyB,CAAC;IACtD,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,4BAA4B,CAAC,EAAE,MAAM,IAAI,CAAC;IACnD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC,OAAO,EAAE;QACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,qBAAqB,EAAE,cAAc,CAAC;QAC7D,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;QAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;KAC5B,KAAK,SAAS,2BAA2B,EAAE,CAAC;CAC9C,GAAG,aAAa,CAgoBhB"}
+{"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":"AA2BA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EAG1B,MAAM,wBAAwB,CAAC;AA4IhC,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,CAs0E7B;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,20 @@ 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"];
+    getPreparationProgress: PixiMaskLayer["getPreparationProgress"];
+    needsRenderPreparationWait: PixiMaskLayer["needsRenderPreparationWait"];
     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,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;IAChE,0BAA0B,EAAE,aAAa,CAAC,4BAA4B,CAAC,CAAC;IACxE,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,CA2GlB;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,62 @@
+import type { InjectedMeshConstructor, InjectedMeshGeometryConstructor, InjectedShaderFactory } from "#renderers/injected-pixi";
+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 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: InjectedMeshConstructor<RegionCoverageMaskMesh>;
+    readonly MeshGeometry: InjectedMeshGeometryConstructor;
+    readonly Shader: InjectedShaderFactory;
+    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":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,+BAA+B,EAC/B,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAMlC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,yCAAyC,CAAC;AAC/F,OAAO,KAAK,EACV,SAAS,IAAI,aAAa,EAC1B,WAAW,IAAI,eAAe,EAC9B,IAAI,IAAI,QAAQ,EAChB,YAAY,IAAI,gBAAgB,EAChC,MAAM,IAAI,UAAU,EACpB,OAAO,IAAI,WAAW,EACtB,YAAY,IAAI,gBAAgB,EACjC,MAAM,SAAS,CAAC;AAEjB,KAAK,sBAAsB,GAAG,QAAQ,CAAC,gBAAgB,EAAE,UAAU,CAAC,CAAC;AAErE,KAAK,oBAAoB,GAAG,KAAK,OAAO,EAAE;IACxC,IAAI,EAAE,sBAAsB,CAAC;CAC9B,KAAK,aAAa,CAAC;AAEpB,KAAK,sBAAsB,GAAG,KAAK,OAAO,EAAE;IAC1C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf,KAAK,eAAe,CAAC;AAEtB,KAAK,uBAAuB,GAAG,KAC7B,QAAQ,EAAE,MAAM,CACd,MAAM,EACN;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAC5E,KACE,gBAAgB,CAAC;AAEtB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,MAAM,CAAC,OAAO,EAAE;QACd,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;QAClD,QAAQ,CAAC,QAAQ,EAAE,+BAA+B,CAAC;QACnD,QAAQ,CAAC,IAAI,EAAE;YACb,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;YACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;QACjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;QAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE;IACpD,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAC,sBAAsB,CAAC,CAAC;IAC/D,QAAQ,CAAC,YAAY,EAAE,+BAA+B,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;CAChD,GAAG,sBAAsB,CAsGzB"}

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,8 @@
+import type { InjectedMeshConstructor, InjectedMeshGeometryConstructor, InjectedShaderFactory } from "#renderers/injected-pixi";
 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 +18,19 @@ export interface PixiRegionLayer {
     translateDetection(id: string | number, x: number, y: number): boolean;
     destroy(): void;
 }
-/** Browser implementation for asset-backed region renderer descriptors. */
+type RegionMesh = PixiMesh<PixiMeshGeometry, PixiShader>;
+/** Browser implementation for asset- and media-backed region descriptors. */
 export declare function createPixiRegionLayer(options: {
+    readonly AlphaMask: new (options: {
+        mask: RegionMesh;
+    }) => 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 +38,38 @@ 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: InjectedMeshConstructor<RegionMesh>;
+    readonly MeshGeometry: InjectedMeshGeometryConstructor;
+    readonly Rectangle: new (x?: number, y?: number, width?: number, height?: number) => PixiRectangle;
     readonly Sprite: new (options: {
         texture: PixiTexture;
     }) => PixiSprite;
+    readonly Shader: InjectedShaderFactory;
+    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;