supervision 0.1.7 → 0.2.0-next.0

package/dist/media/display-pixel-ratio.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The pixel ratio a host's display box rasterizes at, for every grid that lands
+ * in that box: the presentation surface, the mask rasters drawn onto it, and the
+ * decode under both. The ceiling is what keeps a 3x display from costing nine
+ * times the texels of a 1x one for sharpness nobody resolves on a moving
+ * picture. An id raster carries a detection per pixel and can only be sampled
+ * nearest, so a grid it does not share ragged its edges.
+ *
+ * A ceiling that is not a usable number states nothing, and takes the default.
+ */
+export declare function resolveDisplayPixelRatio(display: {
+    readonly devicePixelRatio: number;
+    readonly maxDevicePixelRatio?: number;
+}): number;
+//# sourceMappingURL=display-pixel-ratio.d.ts.map

package/dist/media/display-pixel-ratio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-pixel-ratio.d.ts","sourceRoot":"","sources":["../../src/media/display-pixel-ratio.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC,GAAG,MAAM,CAeT"}

package/dist/media/engine-import-failure.d.ts

@@ -0,0 +1,16 @@
+export declare const VIDEO_ENGINE_ENTRY = "supervision/web-video-engine";
+export declare const VIDEO_ENGINE_ANALYSIS_ENTRY = "supervision/web-video-engine/analysis";
+/**
+ * The engine is a chunk of this package that the browser fetches on demand, so
+ * the raw failure names a URL nobody wrote and reads like a bug in the caller's
+ * own code.
+ */
+export declare function rethrowEngineImportFailure(error: unknown, entry: string): never;
+/**
+ * An engine that never loaded and an engine that loaded and then threw arrive
+ * at the same catch, and only the first is a deployment problem. Loaders that
+ * wrap what they caught put the load failure under the error they raise, so the
+ * whole cause chain is read, bounded because a chain can be cyclic.
+ */
+export declare function isEngineResolutionFailure(error: unknown): boolean;
+//# sourceMappingURL=engine-import-failure.d.ts.map

package/dist/media/engine-import-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-import-failure.d.ts","sourceRoot":"","sources":["../../src/media/engine-import-failure.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AACjE,eAAO,MAAM,2BAA2B,0CAAmC,CAAC;AAkB5E;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,KAAK,CAWP;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAUjE"}

package/dist/media/media-condition-probe.d.ts

@@ -0,0 +1,51 @@
+import { MediaIndexPlacement, type MediaConditionPolicy, type MediaConditionReport, type MediaTimingFacts } from "#types/media-conditions";
+/** Bytes at `[start, end)`, however the caller gets them. */
+export type MediaByteReader = (start: number, end: number) => Promise<Uint8Array>;
+export interface MediaConditionProbeOptions extends MediaConditionPolicy {
+    /**
+     * How many packets of the track to measure timing over. The walk reads
+     * metadata only: on an ISO base media file the sample table is already in
+     * memory once the file opens, so raising this costs processing rather than
+     * bytes; on Matroska and MPEG-TS there is no such table and every packet
+     * costs a read of the media data itself.
+     */
+    readonly samplePackets?: number;
+    /**
+     * Whether the bytes stand for a file that will be opened over a link. It is
+     * what makes a trailing index cost anything, and a probe run against a
+     * downloaded copy of a remote file has to be told.
+     */
+    readonly remote?: boolean;
+}
+/**
+ * Measures a source once and says which conversion conditions hold.
+ *
+ * Deliberately cheap, because "convert only when necessary" is worth nothing if
+ * finding out costs what converting would. Nothing here decodes a frame or
+ * reads a byte of media data on an indexed container: the container's own box
+ * headers answer where the index sits, and the packet walk runs metadata-only
+ * over a bounded prefix.
+ */
+export declare function probeMediaConditions(source: Blob, options?: MediaConditionProbeOptions): Promise<MediaConditionReport>;
+/**
+ * Where an ISO base media file keeps its frame index, read from the top-level
+ * box headers alone.
+ *
+ * Each header states the size of its own box, so the walk hops from one to the
+ * next and never reads a box's contents: eight to sixteen bytes per box, and no
+ * more boxes than it takes to see `moov` or `moof`. Over a link that is a
+ * handful of range requests whatever the file weighs.
+ */
+export declare function readIndexPlacement(read: MediaByteReader, size: number): Promise<MediaIndexPlacement>;
+/**
+ * Turns a walk of packet timestamps into the timing facts, in ticks.
+ *
+ * Decode order is not presentation order, so the table is sorted before its
+ * gaps are read. A walk that stopped at the cap has read every packet up to a
+ * decode position and no further, which leaves the tail of the sorted table
+ * missing frames that sit between ones it did read; the deepest reordering seen
+ * bounds how much of that tail is untrustworthy, and it is dropped. A walk that
+ * ran to the end of the track has no such tail.
+ */
+export declare function summarizeTiming(decodeOrderTicks: readonly number[], tickRate: number, sampleComplete: boolean): MediaTimingFacts;
+//# sourceMappingURL=media-condition-probe.d.ts.map

package/dist/media/media-condition-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-condition-probe.d.ts","sourceRoot":"","sources":["../../src/media/media-condition-probe.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EAEnB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAEjC,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,CAC5B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,KACR,OAAO,CAAC,UAAU,CAAC,CAAC;AAEzB,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACtE;;;;;;OAMG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAWD;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,IAAI,EACZ,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,oBAAoB,CAAC,CAyB/B;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,mBAAmB,CAAC,CAiE9B;AAkGD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,gBAAgB,EAAE,SAAS,MAAM,EAAE,EACnC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,OAAO,GACtB,gBAAgB,CA2BlB"}

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

@@ -0,0 +1,28 @@
+import { type ConversionFrameEffectReport, type MediaConditionFacts, type MediaConditionPolicy, type MediaConditionReport, type MediaTimingFacts } from "#types/media-conditions";
+import { type MediaNormalizationVideoOptions } from "#types/media-normalization";
+/**
+ * Which conditions a source's measured facts hold, and what to do about each.
+ *
+ * Pure: everything it reasons over was measured once by the probe. The two
+ * verdicts are separate because the conditions are: a source whose frames do
+ * not arrive on a steady grid plays perfectly and cannot be addressed by frame
+ * index, and answering that with one verdict would either refuse a clip that
+ * plays or hand out indices that name the wrong picture.
+ */
+export declare function evaluateMediaConditions(facts: MediaConditionFacts, policy?: MediaConditionPolicy): MediaConditionReport;
+/**
+ * What a conversion would do to the frame sequence, judged against the options
+ * as {@link normalizeMedia} will actually run them rather than as they were
+ * written: leaving the rate unstated does not keep the source's timing here,
+ * it takes the 30 hertz default.
+ *
+ * A stated rate is only safe on a source that already runs at exactly that
+ * rate. On anything else the conversion writes a different number of pictures
+ * at different times, and a detection carrying a source frame index then names
+ * a picture that was never at that position.
+ */
+export declare function describeConversionFrameEffect(options: {
+    readonly video?: MediaNormalizationVideoOptions;
+    readonly timing?: MediaTimingFacts | null;
+}): ConversionFrameEffectReport;
+//# sourceMappingURL=media-conditions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"media-conditions.d.ts","sourceRoot":"","sources":["../../src/media/media-conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,2BAA2B,EAEhC,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,4BAA4B,CAAC;AAoBpC;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,mBAAmB,EAC1B,MAAM,GAAE,oBAAyB,GAChC,oBAAoB,CA2FtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,8BAA8B,CAAC;IAChD,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC3C,GAAG,2BAA2B,CA4C9B"}

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

@@ -1,4 +1,10 @@
 import { MediaErrorKind } from "supervision-js-core";
+/**
+ * The vocabulary a media producer may name its own failure in. A producer that
+ * states its cause as one of these on `code` is classified by that name; any
+ * other code is classified from the message like an uncoded failure.
+ */
+export declare const MEDIA_PRODUCER_ERROR_CODES: readonly ["ABORTED", "BACKEND_CRASHED", "CONTAINER_UNREADABLE", "DECODER_STALLED", "DECODE_UNSUPPORTED", "NO_VIDEO_TRACK", "PRESENTATION_MISMATCH", "RATE_UNSUPPORTED", "SOURCE_UNREADABLE", "VIDEO_TRACK_UNREADABLE"];
 /**
  * A media failure with a stable, documented kind.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"media-errors.d.ts","sourceRoot":"","sources":["../../src/media/media-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAQrD;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAG5B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAMzC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,eAAe,SAAyB,GACvC,gBAAgB,CAUlB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAEhE"}
+{"version":3,"file":"media-errors.d.ts","sourceRoot":"","sources":["../../src/media/media-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,wNAW7B,CAAC;AA8BX;;;;;;GAMG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;gBAG5B,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAMzC;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,eAAe,SAAyB,GACvC,gBAAgB,CASlB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAEhE"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"media-probe.d.ts","sourceRoot":"","sources":["../../src/media/media-probe.ts"],"names":[],"mappings":"AAGA,OAAO,EAOL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAGtB,MAAM,4BAA4B,CAAC;AAiBpC,wBAAsB,UAAU,CAC9B,MAAM,EAAE,IAAI,EACZ,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA0F3B"}
+{"version":3,"file":"media-probe.d.ts","sourceRoot":"","sources":["../../src/media/media-probe.ts"],"names":[],"mappings":"AAGA,OAAO,EAQL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAGtB,MAAM,4BAA4B,CAAC;AAgBpC,wBAAsB,UAAU,CAC9B,MAAM,EAAE,IAAI,EACZ,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CA0F3B"}

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

@@ -1,3 +1,4 @@
+import type { PresentedFrameChannel } from "#renderers/presented-frame-channel";
 export interface DecodedVideoSample {
     readonly timestamp: number;
     readonly duration: number;
@@ -11,6 +12,15 @@ export interface DecodedVideoSampleSink {
     samples(startTimestamp?: number, endTimestamp?: number, options?: {
         skipLiveWait?: boolean;
     }): AsyncGenerator<DecodedVideoSample, void, unknown>;
+    /**
+     * A sample per timestamp, in the order asked for, `null` where no frame
+     * covers it, over a single pass across the track. Optional: a caller with a
+     * whole set in hand takes this where a source offers it, and otherwise pays
+     * a seek per {@link DecodedVideoSampleSink.getSample}.
+     */
+    samplesAtTimestamps?(timestamps: Iterable<number>, options?: {
+        skipLiveWait?: boolean;
+    }): AsyncGenerator<DecodedVideoSample | null, void, unknown>;
 }
 export interface DisposableMediaInput {
     dispose(): void;
@@ -34,5 +44,12 @@ export interface DecodedMediaSource {
     readonly input: DisposableMediaInput;
     readonly metadata: DecodedMediaSourceMetadata;
     readonly sampleSink: DecodedVideoSampleSink;
+    /**
+     * A source that owns its own decode clock publishes one, and the renderer
+     * composites the frames it announces rather than asking `sampleSink` for a
+     * frame at a time the renderer chose. `sampleSink` stays required, and still
+     * serves thumbnails and one-off grabs.
+     */
+    readonly engine?: PresentedFrameChannel;
 }
 //# sourceMappingURL=media-source.d.ts.map

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

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

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

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

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

@@ -0,0 +1,44 @@
+import type { DecodedMediaSource } from "#media/media-source";
+import type { PresentedFrameChannel } from "#renderers/presented-frame-channel";
+import type { MediaRendererSource } from "#types/media-renderer";
+import type { DecodeResolutionStrategy, DisplayBoxResolutionOptions, VideoEngine, VideoEngineOptions } from "#web-video-engine";
+export interface VideoEngineMediaSourceOptions extends Omit<VideoEngineOptions, "presentation"> {
+    /**
+     * The box a compositor paints these frames into, in CSS pixels, with the
+     * viewer's device pixel ratio.
+     *
+     * This source runs the engine canvas-less, so nothing on the engine side ever
+     * measures a display box and its viewport strategy has nothing to read: left
+     * unsaid, frames decode at the source's full resolution however small the box
+     * is. Saying it here decodes at the size the frames are actually shown at,
+     * which cuts per-frame paint work and buys the scrub cache more slots at the
+     * cost of preview sharpness while scrubbing. An explicit `decodeStrategy`
+     * wins over this.
+     */
+    readonly display?: DisplayBoxResolutionOptions;
+    /**
+     * Sizes the frames the pull path decodes. The inherited `decodeStrategy`
+     * sizes what the engine decodes for its own presentation.
+     */
+    readonly frameDecodeStrategy?: DecodeResolutionStrategy;
+}
+export interface VideoEngineMediaSource extends DecodedMediaSource {
+    /**
+     * The loaded engine. Naming the renderer's channel in the type is what fails
+     * the build if the engine's transport stops answering that seam.
+     */
+    readonly engine: VideoEngine & PresentedFrameChannel;
+}
+/**
+ * Adapts Roboflow's video engine to the decoded-media source seam.
+ *
+ * The pull path, `sampleSink`, serves one-off reads such as thumbnails and
+ * single frame grabs, decoding each request from scratch through the engine's
+ * batch analysis entry. The push path serves playback and scrub presentation:
+ * the engine holds no canvas, paints nothing, and announces every frame that
+ * earns the screen, so a compositor subscribes to `engine` and never pulls
+ * samples here.
+ */
+export declare function openVideoEngineMediaSource(options: VideoEngineMediaSourceOptions): Promise<VideoEngineMediaSource>;
+export declare function createVideoEngineMediaRendererSource(options: VideoEngineMediaSourceOptions): MediaRendererSource;
+//# sourceMappingURL=video-engine-media-source.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"video-engine-media-source.d.ts","sourceRoot":"","sources":["../../src/media/video-engine-media-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EACV,wBAAwB,EACxB,2BAA2B,EAE3B,WAAW,EACX,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AAkB3B,MAAM,WAAW,6BAA8B,SAAQ,IAAI,CACzD,kBAAkB,EAClB,cAAc,CACf;IACC;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;CACzD;AAED,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,qBAAqB,CAAC;CACtD;AAED;;;;;;;;;GASG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,sBAAsB,CAAC,CAiCjC;AAED,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,6BAA6B,GACrC,mBAAmB,CAMrB"}

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

@@ -1,34 +1,68 @@
 export declare enum PreparedMaskFrameKind {
-    PngIdMask = "pngIdMask",
+    IdMask = "idMask",
     RgbaImage = "rgbaImage"
 }
+/**
+ * How an id raster is laid out for the texture it is uploaded into. WebGPU
+ * takes any bytesPerRow, so ids go up one byte per pixel. WebGL aligns every
+ * uploaded row to four bytes and rejects a single-channel upload whose width
+ * is not a multiple of four, which is what the four-channel layout is for.
+ */
+export declare enum IdMaskTextureFormat {
+    R8 = "r8unorm",
+    Rgba8 = "rgba8unorm"
+}
+export interface PreparedRegionMaskCoverageEntry {
+    readonly data: Uint8Array<ArrayBuffer>;
+    readonly detectionIndex: number;
+    readonly height: number;
+    readonly width: number;
+    readonly x: number;
+    readonly y: number;
+}
+/**
+ * Overlap-preserving membership planes for exact region crops. Every target
+ * owns an alpha crop, so masks remain independent where their pixels overlap.
+ */
+export interface PreparedRegionMaskCoverageFrame {
+    readonly entries: readonly PreparedRegionMaskCoverageEntry[];
+}
+/**
+ * The uncomposited detection-id plane carried alongside the RGBA composite, so
+ * id-keyed effects such as the mask halo still have a plane to read when the id
+ * raster could not be cooked. It carries its own size because it honors the
+ * same raster cap as the id raster while the composite is cooked at the
+ * instructions' own resolution.
+ */
+export interface PreparedIdMaskPlane {
+    readonly data: Uint8Array<ArrayBuffer>;
+    readonly height: number;
+    readonly width: number;
+}
 export interface PreparedRgbaMaskFrame {
     readonly height: number;
-    /**
-     * The uncomposited detection-id plane when preparation falls back to an
-     * RGBA image. This keeps id-based effects available without requiring PNG
-     * encoding or ImageBitmap support.
-     */
-    readonly idMaskData?: Uint8Array<ArrayBuffer>;
+    readonly idMaskPlane?: PreparedIdMaskPlane;
     readonly key: string;
     readonly kind: PreparedMaskFrameKind.RgbaImage;
+    readonly regionMaskCoverage?: PreparedRegionMaskCoverageFrame;
     readonly source: HTMLCanvasElement | ImageBitmap;
     readonly width: number;
     close(): void;
 }
-export interface PreparedPngIdMaskFrame {
+export interface PreparedIdMaskFrame {
     readonly fillPalette: Float32Array<ArrayBuffer>;
     readonly hasStroke: boolean;
     readonly height: number;
     readonly key: string;
-    readonly kind: PreparedMaskFrameKind.PngIdMask;
+    readonly kind: PreparedMaskFrameKind.IdMask;
     readonly maxStrokeWidth: number;
-    readonly png: Uint8Array<ArrayBuffer>;
-    readonly source: ImageBitmap;
+    readonly raster: Uint8Array<ArrayBuffer>;
+    readonly regionMaskCoverage?: PreparedRegionMaskCoverageFrame;
     readonly strokePalette: Float32Array<ArrayBuffer>;
     readonly strokeWidths: Float32Array<ArrayBuffer>;
     readonly width: number;
     close(): void;
 }
-export type PreparedMaskFrame = PreparedPngIdMaskFrame | PreparedRgbaMaskFrame;
+export type PreparedMaskFrame = PreparedIdMaskFrame | PreparedRgbaMaskFrame;
+export declare function readIdMaskRasterValue(frame: PreparedIdMaskFrame, x: number, y: number): number;
 //# sourceMappingURL=mask-frame-artifact.d.ts.map

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

@@ -1 +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;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IAC9C,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"}
+{"version":3,"file":"mask-frame-artifact.d.ts","sourceRoot":"","sources":["../../src/render-preparation/mask-frame-artifact.ts"],"names":[],"mappings":"AAAA,oBAAY,qBAAqB;IAC/B,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED;;;;;GAKG;AACH,oBAAY,mBAAmB;IAC7B,EAAE,YAAY;IACd,KAAK,eAAe;CACrB;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,EAAE,SAAS,+BAA+B,EAAE,CAAC;CAC9D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC;IAC/C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,+BAA+B,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,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,MAAM,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACzC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,+BAA+B,CAAC;IAC9D,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,mBAAmB,GAAG,qBAAqB,CAAC;AAE5E,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,mBAAmB,EAC1B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,UAGV"}

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

@@ -1,4 +1,5 @@
 import type { SerializableMaskInstruction } from "#render-preparation/mask-preparation-worker-protocol";
+import type { PreparedIdMaskPlane, PreparedRegionMaskCoverageFrame } from "#render-preparation/mask-frame-artifact";
 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 {
@@ -6,10 +7,9 @@ export interface CompositedMaskFrame {
     readonly height: number;
     readonly width: number;
 }
-export interface PngIdMaskFrame extends IdMaskFrame {
-    readonly png: Uint8Array<ArrayBuffer>;
-}
+/** Builds compact, independent alpha crops so overlapping masks stay exact. */
+export declare function createRegionMaskCoverageFrame(instructions: readonly SerializableMaskInstruction[]): PreparedRegionMaskCoverageFrame | undefined;
 export declare function compositeMaskFrame(instructions: readonly SerializableMaskInstruction[]): CompositedMaskFrame | undefined;
-export declare function createMaskIdFrame(instructions: readonly SerializableMaskInstruction[]): IdMaskFrame | undefined;
-export declare function createPngIdMaskFrame(instructions: readonly SerializableMaskInstruction[]): Promise<PngIdMaskFrame | undefined>;
+export declare function createIdMaskRasterFrame(instructions: readonly SerializableMaskInstruction[], maxRasterWidth?: number): IdMaskFrame | undefined;
+export declare function createIdMaskPlane(instructions: readonly SerializableMaskInstruction[], maxRasterWidth?: number): PreparedIdMaskPlane | undefined;
 //# sourceMappingURL=mask-frame-compositor.d.ts.map

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

@@ -1 +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,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,SAAS,2BAA2B,EAAE,2BAGrD;AAED,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,SAAS,2BAA2B,EAAE,GACnD,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAerC"}
+{"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;AACxG,OAAO,KAAK,EACV,mBAAmB,EAEnB,+BAA+B,EAChC,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAe7B,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,+EAA+E;AAC/E,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,SAAS,2BAA2B,EAAE,GACnD,+BAA+B,GAAG,SAAS,CAmB7C;AA6CD,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,SAAS,2BAA2B,EAAE,GACnD,mBAAmB,GAAG,SAAS,CAgBjC;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,SAAS,2BAA2B,EAAE,EACpD,cAAc,CAAC,EAAE,MAAM,GACtB,WAAW,GAAG,SAAS,CAUzB;AAED,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,SAAS,2BAA2B,EAAE,EACpD,cAAc,CAAC,EAAE,MAAM,GACtB,mBAAmB,GAAG,SAAS,CAMjC"}

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

@@ -1 +1 @@
-{"version":3,"file":"mask-frame-preparer.d.ts","sourceRoot":"","sources":["../../src/render-preparation/mask-frame-preparer.ts"],"names":[],"mappings":"AAMA,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"}
+{"version":3,"file":"mask-frame-preparer.d.ts","sourceRoot":"","sources":["../../src/render-preparation/mask-frame-preparer.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,qBAAqB,EACrB,KAAK,iBAAiB,EAEvB,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

@@ -1,8 +1,8 @@
 /**
- * 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.
+ * Automatic mask preparation intentionally uses a small pool. Worker count
+ * increases memory pressure and competes with media decode, and every prepared
+ * frame crosses back to the main thread as a full-resolution raster. 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;

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

@@ -1,6 +1,6 @@
 import type { DetectionMask, Point } from "supervision-js-core";
 import type { MaskStrokeStyle } from "supervision-js-core";
-import type { PreparedMaskFrameKind } from "./mask-frame-artifact";
+import type { PreparedIdMaskPlane, PreparedMaskFrameKind, PreparedRegionMaskCoverageFrame } from "./mask-frame-artifact";
 export declare enum MaskPreparationWorkerMessageType {
     Complete = "complete",
     Empty = "empty",
@@ -11,7 +11,11 @@ interface SerializableRasterInstructionBase {
     readonly alpha: number;
     readonly color: number;
     readonly detectionIndex: number;
+    /** Semantic mask used only by exact Region renderer coverage. */
+    readonly regionCoverageMask?: DetectionMask;
     readonly stroke?: MaskStrokeStyle;
+    /** False when this instruction only carries Region coverage. */
+    readonly visible?: boolean;
 }
 export type SerializableMaskInstruction = (SerializableRasterInstructionBase & {
     readonly mask: DetectionMask;
@@ -27,6 +31,8 @@ export type SerializableMaskInstruction = (SerializableRasterInstructionBase & {
 export interface MaskFramePreparationJob {
     readonly instructions: readonly SerializableMaskInstruction[];
     readonly key: string;
+    /** Widest id raster to cook; absent, the instructions' own resolution. */
+    readonly maxRasterWidth?: number;
 }
 export interface MaskPreparationWorkerPrepareMessage {
     readonly job: MaskFramePreparationJob;
@@ -37,16 +43,19 @@ export interface MaskPreparationWorkerCompleteMessage {
     readonly artifactKind?: PreparedMaskFrameKind;
     readonly fillPalette?: Float32Array<ArrayBuffer>;
     readonly hasStroke?: boolean;
-    readonly idMaskData?: Uint8Array<ArrayBuffer>;
+    readonly height?: number;
+    readonly idMaskPlane?: PreparedIdMaskPlane;
     readonly imageBitmap?: ImageBitmap;
     readonly imageData?: ImageData;
     readonly key: string;
     readonly maxStrokeWidth?: number;
-    readonly png?: Uint8Array<ArrayBuffer>;
+    readonly raster?: Uint8Array<ArrayBuffer>;
+    readonly regionMaskCoverage?: PreparedRegionMaskCoverageFrame;
     readonly requestId: number;
     readonly strokePalette?: Float32Array<ArrayBuffer>;
     readonly strokeWidths?: Float32Array<ArrayBuffer>;
     readonly type: MaskPreparationWorkerMessageType.Complete;
+    readonly width?: number;
 }
 export interface MaskPreparationWorkerEmptyMessage {
     readonly key: string;

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

@@ -1 +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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"}
+{"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/prepared-render-window.d.ts

@@ -19,13 +19,28 @@ export declare enum PreparedRenderFrameMaskStatus {
 }
 export interface PreparedRenderWindow {
     getFrame(mediaTime: number): PreparedRenderFrame | undefined;
+    /**
+     * Whether this window's artifact for a media time is cooked, scheduling
+     * nothing. True when there is nothing to cook: no style, no frame there.
+     */
+    isArtifactPrepared(mediaTime: number): boolean;
     waitForReady(mediaTime: number, options: RenderPreparationPlaybackGateOptions): Promise<void>;
+    /**
+     * Whether the playhead is moving. A window over a resting playhead covers a
+     * paused margin instead of the full prefetch span.
+     */
+    setPlaybackActive(active: boolean): 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";
+/** How many frames ahead of the playhead a prepared window aims to cover. */
+export declare function resolvePreparedWindowFrameCount(options: {
+    readonly prefetchFrameCount?: number;
+    readonly renderPreparation?: RenderPreparationOptions;
+}): number;
 export declare function createPreparedRenderWindow(options: {
     readonly artifactKind?: RenderPreparationArtifactKind;
     readonly detectionTimeline: BufferedDetectionTimeline;
@@ -34,6 +49,8 @@ export declare function createPreparedRenderWindow(options: {
     readonly onMaskFrameEvicted?: (key: string) => void;
     readonly onMaskFramePrepared?: (maskFrame: PreparedMaskFrame) => void;
     readonly onMaskFramesCleared?: () => void;
+    /** Fires whenever what the window covers may have changed. */
+    readonly onPreparedWindowChange?: () => void;
     readonly prefetchFrameCount?: number;
     readonly preparedWindowScanIntervalSeconds?: number;
     readonly renderPreparation?: RenderPreparationOptions;
@@ -42,5 +59,11 @@ export declare function createPreparedRenderWindow(options: {
         readonly maskStyle: MaskStyle;
         readonly mediaTime: number;
     }) => readonly SerializableMaskInstruction[];
+    /**
+     * The widest id raster a cook may produce. A function because the raster is
+     * sized against media dimensions the caller only learns once its display
+     * exists, which is after this window does.
+     */
+    readonly resolveMaxRasterWidth?: () => number | undefined;
 }): PreparedRenderWindow;
 //# sourceMappingURL=prepared-render-window.d.ts.map

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

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

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

@@ -4,13 +4,9 @@ export interface PreparedRenderTimelineContext {
     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;
+    getWindowFrames(bufferedFrames: readonly DetectionFrame[], mediaTime: number, bufferEndTime: number | null): readonly DetectionFrame[];
     setContext(context: PreparedRenderTimelineContext): void;
 }
-export declare function createPreparedWindowTimeline(options: {
-    readonly getFrameKey: (frame: DetectionFrame) => string;
-}): PreparedWindowTimeline;
+export declare function createPreparedWindowTimeline(): PreparedWindowTimeline;
 //# sourceMappingURL=prepared-window-timeline.d.ts.map

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

@@ -1 +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"}
+{"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,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,EACjB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,SAAS,cAAc,EAAE,CAAC;IAC7B,UAAU,CAAC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAAC;CAC1D;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CA6ErE"}

package/dist/renderers/mask-palette.d.ts

@@ -0,0 +1,14 @@
+/**
+ * GLSL charges a uniform array of scalars one uniform vector per element, the
+ * same as an array of vec4, so the stroke widths ride four to a vector and an
+ * entry costs 2.25 vectors instead of 3. The lanes only line up while the entry
+ * count stays a multiple of four.
+ */
+export declare const ID_MASK_STROKE_WIDTH_LANES: number;
+export declare const idMaskPaletteGlsl = "\nuniform vec4 uFillPalette[80];\nuniform vec4 uStrokePalette[80];\nuniform vec4 uStrokeWidths[20];\n\nint paletteIndex(float maskId) {\n  return int(clamp(maskId, 0.0, float(79)));\n}\n\nvec4 readFill(float maskId) {\n  return uFillPalette[paletteIndex(maskId)];\n}\n\nvec4 readStroke(float maskId) {\n  return uStrokePalette[paletteIndex(maskId)];\n}\n\nfloat readStrokeWidth(float maskId) {\n  int index = paletteIndex(maskId);\n\n  return uStrokeWidths[index / 4][index % 4];\n}\n";
+export declare const idMaskFillPaletteWgslField = "uFillPalette: array<vec4<f32>, 80>,";
+export declare const idMaskStrokePaletteWgslField = "uStrokePalette: array<vec4<f32>, 80>,";
+export declare const idMaskStrokeWidthsWgslField = "uStrokeWidths: array<vec4<f32>, 20>,";
+/** Reads the uniform group a fragment stage must bind under the name maskUniforms. */
+export declare const idMaskPaletteWgsl = "\nfn paletteIndex(maskId: f32) -> i32 {\n  return i32(clamp(maskId, 0.0, 79.0));\n}\n\nfn readFill(maskId: f32) -> vec4<f32> {\n  return maskUniforms.uFillPalette[paletteIndex(maskId)];\n}\n\nfn readStroke(maskId: f32) -> vec4<f32> {\n  return maskUniforms.uStrokePalette[paletteIndex(maskId)];\n}\n\nfn readStrokeWidth(maskId: f32) -> f32 {\n  let index = paletteIndex(maskId);\n\n  return maskUniforms.uStrokeWidths[index / 4][index % 4];\n}\n";
+//# sourceMappingURL=mask-palette.d.ts.map

package/dist/renderers/mask-palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-palette.d.ts","sourceRoot":"","sources":["../../src/renderers/mask-palette.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAkC,CAAC;AAE1E,eAAO,MAAM,iBAAiB,yeAsB7B,CAAC;AAEF,eAAO,MAAM,0BAA0B,wCAAoE,CAAC;AAE5G,eAAO,MAAM,4BAA4B,0CAAsE,CAAC;AAEhH,eAAO,MAAM,2BAA2B,yCAAoE,CAAC;AAE7G,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,kcAkB7B,CAAC"}

package/dist/renderers/mask-vertex.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The vertex stage every mask shader draws with. Only the tint varies: a
+ * fragment stage that multiplies the mask by the world color reads vColor,
+ * one that samples the mask alone takes no such input.
+ */
+export declare const tintedMaskVertexWgsl = "\nstruct GlobalUniforms {\n  uProjectionMatrix: mat3x3<f32>,\n  uWorldTransformMatrix: mat3x3<f32>,\n  uWorldColorAlpha: vec4<f32>,\n  uResolution: vec2<f32>,\n}\n\nstruct LocalUniforms {\n  uTransformMatrix: mat3x3<f32>,\n  uColor: vec4<f32>,\n  uRound: f32,\n}\n\n@group(0) @binding(0) var<uniform> globalUniforms: GlobalUniforms;\n@group(1) @binding(0) var<uniform> localUniforms: LocalUniforms;\n\nstruct VertexOutput {\n  @builtin(position) position: vec4<f32>,\n  @location(0) vUV: vec2<f32>,\n  @location(1) vColor: vec4<f32>,\n}\n\n@vertex\nfn mainVertex(\n  @location(0) aPosition: vec2<f32>,\n  @location(1) aUV: vec2<f32>,\n) -> VertexOutput {\n  let modelViewProjectionMatrix =\n    globalUniforms.uProjectionMatrix *\n    globalUniforms.uWorldTransformMatrix *\n    localUniforms.uTransformMatrix;\n\n  var output: VertexOutput;\n\n  output.position = vec4<f32>(\n    (modelViewProjectionMatrix * vec3<f32>(aPosition, 1.0)).xy,\n    0.0,\n    1.0\n  );\n  output.vUV = aUV;\n  output.vColor = globalUniforms.uWorldColorAlpha * localUniforms.uColor;\n\n  return output;\n}\n";
+export declare const untintedMaskVertexWgsl = "\nstruct GlobalUniforms {\n  uProjectionMatrix: mat3x3<f32>,\n  uWorldTransformMatrix: mat3x3<f32>,\n  uWorldColorAlpha: vec4<f32>,\n  uResolution: vec2<f32>,\n}\n\nstruct LocalUniforms {\n  uTransformMatrix: mat3x3<f32>,\n  uColor: vec4<f32>,\n  uRound: f32,\n}\n\n@group(0) @binding(0) var<uniform> globalUniforms: GlobalUniforms;\n@group(1) @binding(0) var<uniform> localUniforms: LocalUniforms;\n\nstruct VertexOutput {\n  @builtin(position) position: vec4<f32>,\n  @location(0) vUV: vec2<f32>,\n}\n\n@vertex\nfn mainVertex(\n  @location(0) aPosition: vec2<f32>,\n  @location(1) aUV: vec2<f32>,\n) -> VertexOutput {\n  let modelViewProjectionMatrix =\n    globalUniforms.uProjectionMatrix *\n    globalUniforms.uWorldTransformMatrix *\n    localUniforms.uTransformMatrix;\n\n  var output: VertexOutput;\n\n  output.position = vec4<f32>(\n    (modelViewProjectionMatrix * vec3<f32>(aPosition, 1.0)).xy,\n    0.0,\n    1.0\n  );\n  output.vUV = aUV;\n\n  return output;\n}\n";
+/**
+ * The GL counterpart of the tinted vertex stage. Pixi caches a program under
+ * both of its stages' source text, so shaders that share this one still get a
+ * program each from their own fragment stage.
+ */
+export declare const tintedMaskVertexGlsl = "#version 300 es\nprecision highp float;\n\nin vec2 aPosition;\nin vec2 aUV;\n\nuniform mat3 uProjectionMatrix;\nuniform mat3 uWorldTransformMatrix;\nuniform vec4 uWorldColorAlpha;\nuniform mat3 uTransformMatrix;\nuniform vec4 uColor;\n\nout vec2 vUV;\nout vec4 vColor;\n\nvoid main(void) {\n  mat3 modelViewProjectionMatrix =\n    uProjectionMatrix * uWorldTransformMatrix * uTransformMatrix;\n\n  gl_Position =\n    vec4((modelViewProjectionMatrix * vec3(aPosition, 1.0)).xy, 0.0, 1.0);\n  vUV = aUV;\n  vColor = uWorldColorAlpha * uColor;\n}\n";
+//# sourceMappingURL=mask-vertex.d.ts.map

package/dist/renderers/mask-vertex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mask-vertex.d.ts","sourceRoot":"","sources":["../../src/renderers/mask-vertex.ts"],"names":[],"mappings":"AAuDA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,mkCAA+F,CAAC;AAEjI,eAAO,MAAM,sBAAsB,q9BAAgE,CAAC;AAEpG;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,siBAwBhC,CAAC"}