supervision 0.0.9000 → 0.1.0

package/dist/types/media-session.d.ts

@@ -0,0 +1,242 @@
+import type { ColdDetectionFrameStore, ColdDetectionFrameStoreWriteSummary, DetectionBufferOptions, DetectionFrameRetentionOptions, DetectionFrameSelectionOptions, DetectionPlaybackGateOptions, DetectionFrameSource, MediaSessionLifecycleState, MediaSessionMode, MediaSessionStateListener as CoreMediaSessionStateListener, MediaSessionStateUnsubscribe, WritableDetectionFrameSource } from "supervision-js-core";
+import type { DetectionFrame } from "supervision-js-core";
+import type { MediaInteractionOptions } from "supervision-js-core";
+import type { MediaNormalizationInputMetadata, MediaNormalizationProgress, MediaNormalizationOptions, NormalizedMedia, ProgressiveNormalizedMedia } from "#types/media-normalization";
+import type { DetectionTimelineOrigin, MediaFrameDiagnostics, MediaRenderer, MediaRendererFit, MediaRendererPresentation, MediaRendererQuality, MediaRendererOptions, MediaRendererSource, MediaRendererState, MediaSourceState } from "#types/media-renderer";
+import type { RenderPreparationDiagnostics } from "#types/render-preparation";
+export { MediaSessionActivityKind, MediaSessionActivityStatus, MediaSessionMode, MediaSessionStatus, } from "supervision-js-core";
+export type { MediaSessionActivity, MediaSessionStateUnsubscribe, } from "supervision-js-core";
+/**
+ * Media input accepted by `createMediaSession`.
+ *
+ * Use a `Blob` for uploaded files, a URL string for already hosted media, or a
+ * custom renderer source when integrating a lower-level media adapter.
+ */
+export type MediaSessionMedia = string | URL | Request | Blob | MediaRendererSource;
+export interface MediaSessionNormalizationOptions extends MediaNormalizationOptions {
+    /**
+     * When true, media normalization may expose progressive output before the
+     * entire input has finished normalizing.
+     */
+    readonly stream?: boolean;
+}
+/**
+ * Options for session-owned streaming detection ingestion.
+ */
+export interface MediaSessionAppendableDetectionOptions {
+    /**
+     * Optional cold store. If omitted, the session creates an in-memory store.
+     * `MemoryOnly` retention always uses an in-memory store.
+     */
+    readonly store?: ColdDetectionFrameStore;
+    readonly datasetId: string;
+    readonly chunkDurationSeconds?: number;
+    readonly clearOnCreate?: boolean;
+    readonly retention?: DetectionFrameRetentionOptions;
+}
+/**
+ * @deprecated Use `MediaSessionAppendableDetectionOptions`.
+ */
+export type MediaSessionWritableDetectionOptions = MediaSessionAppendableDetectionOptions;
+export type MediaSessionDetectionSyncOptions = DetectionFrameSelectionOptions;
+export type MediaSessionDetectionSourcePresentation = Pick<MediaRendererPresentation, "boxStyle" | "keypointStyle" | "labelStyle" | "maskStyle" | "polygonStyle" | "polylineStyle">;
+export interface MediaSessionDetectionSourceOptions {
+    /**
+     * Renderer-neutral source identity copied into composed detections.
+     */
+    readonly id: string;
+    /**
+     * Static detection frames known at session creation time.
+     */
+    readonly frames?: readonly DetectionFrame[];
+    /**
+     * Caller-owned source for loading detection frames by media-time range.
+     */
+    readonly source?: DetectionFrameSource;
+    /**
+     * Session-owned writable source for streaming detections into cold storage.
+     */
+    readonly appendable?: MediaSessionAppendableDetectionOptions;
+    /**
+     * Lower order sources are composed first. Later detections render on top.
+     */
+    readonly order?: number;
+    /**
+     * Optional geometry presentation overrides for this source.
+     *
+     * `undefined` falls back to the global presentation. `null` disables that
+     * layer for this source.
+     */
+    readonly presentation?: MediaSessionDetectionSourcePresentation;
+    /**
+     * Detection-frame selection options for this source.
+     */
+    readonly sync?: MediaSessionDetectionSyncOptions;
+    /**
+     * When false, playback gates skip this source's readiness checks.
+     */
+    readonly requiredForPlayback?: boolean;
+}
+export interface MediaSessionDetectionOptions {
+    /**
+     * Multiple detection sources composed into one active semantic frame.
+     */
+    readonly sources?: readonly MediaSessionDetectionSourceOptions[];
+    /**
+     * Static detection frames known at session creation time.
+     */
+    readonly frames?: readonly DetectionFrame[];
+    /**
+     * Caller-owned source for loading detection frames by media-time range.
+     */
+    readonly source?: DetectionFrameSource;
+    /**
+     * Session-owned writable source for streaming detections into cold storage.
+     * Prefer this name for new code.
+     */
+    readonly appendable?: MediaSessionAppendableDetectionOptions;
+    /**
+     * Backward-compatible alias for `appendable`.
+     *
+     * @deprecated Use `appendable`.
+     */
+    readonly writable?: MediaSessionWritableDetectionOptions;
+    /**
+     * Detection-frame selection options shared by the hot buffer and renderer.
+     */
+    readonly sync?: MediaSessionDetectionSyncOptions;
+    /**
+     * Hot detection-window loading options.
+     */
+    readonly buffer?: DetectionBufferOptions;
+    /**
+     * Optional playback gate that treats detection coverage as part of media
+     * readiness.
+     */
+    readonly playbackGate?: DetectionPlaybackGateOptions;
+    /**
+     * Clock used by supplied detection frames. Use `MediaStart` when inference
+     * timestamps begin at zero independently of the file's encoded PTS.
+     */
+    readonly timelineOrigin?: DetectionTimelineOrigin;
+}
+export interface MediaSessionRendererOptions {
+    readonly autoPlay?: boolean;
+    readonly loop?: boolean;
+    readonly playbackRate?: number;
+    readonly muted?: boolean;
+    readonly fit?: MediaRendererFit;
+    readonly maxDevicePixelRatio?: MediaRendererOptions["maxDevicePixelRatio"];
+    readonly interaction?: MediaInteractionOptions;
+    readonly renderPreparation?: MediaRendererOptions["renderPreparation"];
+    readonly diagnostics?: MediaRendererOptions["diagnostics"];
+    /**
+     * Caller-owned editing engine. The host persists committed edits and owns
+     * undo; the session only routes renderer gestures and previews.
+     */
+    readonly editingEngine?: MediaRendererOptions["editingEngine"];
+    /** Optional browser mask-brush preview rendered with the editing engine. */
+    readonly maskBrush?: MediaRendererOptions["maskBrush"];
+    readonly createMaskBrush?: MediaRendererOptions["createMaskBrush"];
+    /** Optional host-owned external preview rendered above annotations. */
+    readonly previewOverlay?: MediaRendererOptions["previewOverlay"];
+    readonly onFrame?: (diagnostics: MediaFrameDiagnostics) => void;
+    readonly onSource?: (state: MediaSourceState) => void;
+    readonly onState?: (state: MediaRendererState) => void;
+}
+/**
+ * Options for creating one renderer-owned media session.
+ */
+export interface MediaSessionOptions {
+    /**
+     * DOM element where the renderer should mount its canvas.
+     */
+    readonly container: HTMLElement;
+    /**
+     * Media to prepare and render. This can be a URL, an uploaded file/blob, or a
+     * lower-level renderer source.
+     */
+    readonly media: MediaSessionMedia;
+    /**
+     * File mode is bounded media. Stream mode tunes defaults for live or
+     * append-only detection sources.
+     */
+    readonly mode?: MediaSessionMode;
+    /**
+     * Optional browser media normalization before rendering.
+     */
+    readonly normalize?: false | MediaSessionNormalizationOptions;
+    /**
+     * Detection frames or sources to render with the media.
+     */
+    readonly detections?: MediaSessionDetectionOptions;
+    /**
+     * Aggregate loading, playback, buffering, processing, and error state.
+     */
+    readonly onState?: (state: MediaSessionState) => void;
+    /**
+     * Box, mask, label, interaction, and focus presentation styles.
+     */
+    readonly presentation?: MediaRendererPresentation;
+    /**
+     * Renderer playback, interaction, diagnostics, and render-preparation options.
+     */
+    readonly renderer?: MediaSessionRendererOptions;
+}
+/**
+ * Prepared media state visible to host applications.
+ */
+export interface MediaSessionMediaState {
+    readonly inputMetadata: MediaNormalizationInputMetadata | null;
+    readonly normalizedMedia: NormalizedMedia | ProgressiveNormalizedMedia | null;
+    readonly objectUrl: string | null;
+}
+export interface MediaSessionNormalizationState {
+    readonly active: boolean;
+    readonly progress: MediaNormalizationProgress | null;
+}
+/**
+ * Current aggregate browser-session state for media, renderer, detections,
+ * render preparation, loading activities, and errors.
+ */
+export type MediaSessionState = MediaSessionLifecycleState<MediaSessionMediaState, MediaRendererState, MediaSessionNormalizationState, RenderPreparationDiagnostics>;
+export type MediaSessionStateListener = CoreMediaSessionStateListener<MediaSessionState>;
+export interface MediaSessionDetectionWriteOptions {
+    readonly sourceId?: string;
+}
+/**
+ * Public controller for one renderer-owned media item.
+ */
+export interface MediaSession {
+    /**
+     * Detection source used by the renderer. Present when the session was created
+     * with static frames, a source, or an appendable source.
+     */
+    readonly detectionSource?: DetectionFrameSource | WritableDetectionFrameSource;
+    readonly media: MediaSessionMediaState;
+    readonly renderer: MediaRenderer;
+    /**
+     * Append semantic detection frames to a session-owned appendable source.
+     */
+    appendDetectionFrames(frames: readonly DetectionFrame[], options?: MediaSessionDetectionWriteOptions): Promise<ColdDetectionFrameStoreWriteSummary>;
+    replaceDetectionFrames(frames: readonly DetectionFrame[], options?: MediaSessionDetectionWriteOptions): Promise<ColdDetectionFrameStoreWriteSummary>;
+    clearDetectionFrames(options?: MediaSessionDetectionWriteOptions): Promise<void>;
+    /**
+     * Summary of frames written through `appendDetectionFrames`, when available.
+     */
+    getDetectionSummary(options?: MediaSessionDetectionWriteOptions): ColdDetectionFrameStoreWriteSummary | null;
+    play(): Promise<void>;
+    pause(): void;
+    seek(mediaTime: number): Promise<void>;
+    stepForward(): Promise<void>;
+    stepBackward(): Promise<void>;
+    setPlaybackRate(playbackRate: number): void;
+    /** Re-read semantic detections and redraw the current presentation. */
+    refresh(): Promise<void>;
+    setPresentation(presentation: MediaRendererPresentation): void;
+    setRenderQuality(quality: MediaRendererQuality): void;
+    subscribe(listener: MediaSessionStateListener): MediaSessionStateUnsubscribe;
+    getState(): MediaSessionState;
+    destroy(): void;
+}
+//# sourceMappingURL=media-session.d.ts.map

package/dist/types/media-session.d.ts.map

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

package/dist/types/render-preparation.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Where renderer-owned artifact preparation should run.
+ */
+export declare enum RenderPreparationMode {
+    /**
+     * Prefer workers when available, with a main-thread fallback.
+     */
+    Auto = "auto",
+    /**
+     * Prepare artifacts on the main thread.
+     */
+    MainThread = "mainThread",
+    /**
+     * Require preparation through the configured/default worker factory.
+     * Worker creation and runtime failures reject instead of falling back.
+     */
+    Worker = "worker"
+}
+/**
+ * Actual execution mode selected after worker availability is resolved.
+ */
+export declare enum RenderPreparationExecutionMode {
+    MainThread = "mainThread",
+    Worker = "worker"
+}
+/**
+ * Worker lifecycle state for render-preparation diagnostics.
+ */
+export declare enum RenderPreparationWorkerStatus {
+    Disabled = "disabled",
+    Ready = "ready",
+    Unavailable = "unavailable",
+    Error = "error"
+}
+/**
+ * Prepared artifact family.
+ */
+export declare enum RenderPreparationArtifactKind {
+    /** Frame-level ID-mask artifact prepared from semantic masks. */
+    MaskFrame = "maskFrame",
+    /** Frame-level ID-mask artifact rasterized from semantic polygons. */
+    PolygonFrame = "polygonFrame"
+}
+/**
+ * Preparation status for the active artifact frame.
+ */
+export declare enum RenderPreparationArtifactFrameStatus {
+    Disabled = "disabled",
+    Empty = "empty",
+    Pending = "pending",
+    Prepared = "prepared"
+}
+/**
+ * Worker creation hook for hosts that need custom CSP or deployment handling.
+ */
+export interface RenderPreparationWorkerFactory {
+    createWorker(): Worker;
+}
+/**
+ * Options for preparing frame-level raster artifacts. Polygon frames reuse
+ * this bounded worker/cache policy so both dense geometry paths stay ahead of
+ * playback without duplicating scheduling controls.
+ */
+export interface RenderPreparationMaskFrameOptions {
+    /**
+     * Maximum number of prepared mask frames retained in memory.
+     */
+    readonly maxCacheFrameCount?: number;
+    /**
+     * Maximum number of mask frames queued for preparation.
+     */
+    readonly maxPendingFrameCount?: number;
+    /**
+     * Target number of frames to prepare ahead of playback.
+     */
+    readonly prefetchFrameCount?: number;
+    /**
+     * Number of frames scheduled per preparation scan.
+     */
+    readonly scheduleBatchSize?: number;
+    /**
+     * How often the prepared window scans for refill work.
+     */
+    readonly scanIntervalSeconds?: number;
+    /**
+     * Worker count for mask artifact preparation.
+     */
+    readonly workerCount?: number;
+}
+/**
+ * Playback gate for prepared render artifacts.
+ */
+export interface RenderPreparationPlaybackGateOptions {
+    /**
+     * Pause playback while required artifacts are not prepared.
+     */
+    readonly enabled?: boolean;
+    /**
+     * Soft target ahead of the active frame.
+     */
+    readonly minimumAheadSeconds?: number;
+    /**
+     * Required ahead time before playback can continue.
+     */
+    readonly requiredAheadSeconds?: number;
+}
+/**
+ * Diagnostics for the currently selected artifact frame.
+ */
+export interface RenderPreparationActiveFrameDiagnostics {
+    readonly key: string;
+    readonly mediaTime: number;
+    readonly status: RenderPreparationArtifactFrameStatus;
+}
+/**
+ * Diagnostics for one prepared artifact window.
+ */
+export interface RenderPreparationArtifactWindowDiagnostics {
+    readonly availableFrameCount: number;
+    readonly refillThresholdFrameCount: number;
+    readonly targetFrameCount: number;
+}
+/**
+ * Diagnostics for one prepared artifact family.
+ */
+export interface RenderPreparationArtifactDiagnostics {
+    readonly activeFrame?: RenderPreparationActiveFrameDiagnostics | null;
+    readonly inFlightCount?: number;
+    readonly kind: RenderPreparationArtifactKind;
+    readonly maxInFlightCount?: number;
+    readonly maxPendingCount?: number;
+    readonly maxPreparedCount?: number;
+    readonly pendingCount: number;
+    readonly preparedAheadFrameCount?: number;
+    readonly preparedAheadSeconds?: number;
+    readonly prefetchCount?: number;
+    readonly preparedCount: number;
+    readonly refillThresholdCount?: number;
+    readonly scheduleBatchSize?: number;
+    readonly window?: RenderPreparationArtifactWindowDiagnostics;
+}
+/**
+ * Renderer-owned render-preparation diagnostics.
+ */
+export interface RenderPreparationDiagnostics {
+    readonly artifacts: readonly RenderPreparationArtifactDiagnostics[];
+    readonly executionMode: RenderPreparationExecutionMode;
+    readonly message: string | null;
+    readonly workerStatus: RenderPreparationWorkerStatus;
+}
+/**
+ * Render-preparation configuration.
+ *
+ * Most applications can use the session defaults. Tune this when dense masks,
+ * long videos, worker policy, or playback gating need explicit behavior.
+ */
+export interface RenderPreparationOptions {
+    readonly maskFrame?: RenderPreparationMaskFrameOptions;
+    readonly mode?: RenderPreparationMode;
+    readonly onDiagnostics?: (diagnostics: RenderPreparationDiagnostics) => void;
+    readonly playbackGate?: RenderPreparationPlaybackGateOptions;
+    readonly workerFactory?: RenderPreparationWorkerFactory;
+}
+//# sourceMappingURL=render-preparation.d.ts.map

package/dist/types/render-preparation.d.ts.map

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

package/dist/workers/worker-rpc-client.d.ts

@@ -0,0 +1,15 @@
+export interface WorkerRpcMessage {
+    readonly requestId: number;
+}
+export interface WorkerRpcClient<Request extends WorkerRpcMessage, Response extends WorkerRpcMessage> {
+    destroy(): void;
+    getFailureMessage(): string | null;
+    request(message: Omit<Request, "requestId">): Promise<Response>;
+}
+export declare function createWorkerRpcClient<Request extends WorkerRpcMessage, Response extends WorkerRpcMessage>(options: {
+    readonly defaultErrorMessage: string;
+    readonly isResponse: (value: unknown) => value is Response;
+    readonly onOrphanedResponse?: (response: Response) => void;
+    readonly worker: Worker;
+}): WorkerRpcClient<Request, Response>;
+//# sourceMappingURL=worker-rpc-client.d.ts.map

package/dist/workers/worker-rpc-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-rpc-client.d.ts","sourceRoot":"","sources":["../../src/workers/worker-rpc-client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAOD,MAAM,WAAW,eAAe,CAC9B,OAAO,SAAS,gBAAgB,EAChC,QAAQ,SAAS,gBAAgB;IAEjC,OAAO,IAAI,IAAI,CAAC;IAChB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAAC;IACnC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACjE;AAED,wBAAgB,qBAAqB,CACnC,OAAO,SAAS,gBAAgB,EAChC,QAAQ,SAAS,gBAAgB,EACjC,OAAO,EAAE;IACT,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,KAAK,IAAI,QAAQ,CAAC;IAC3D,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CA+FrC"}

package/node_modules/supervision-js-core/dist/detections/array-detection-frame-source.d.ts

@@ -0,0 +1,4 @@
+import type { DetectionFrameSource } from "#types/detection-timeline";
+import type { DetectionFrame } from "#types/detections";
+export declare function createArrayDetectionFrameSource(frames: readonly DetectionFrame[] | undefined): DetectionFrameSource;
+//# sourceMappingURL=array-detection-frame-source.d.ts.map

package/node_modules/supervision-js-core/dist/detections/array-detection-frame-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-detection-frame-source.d.ts","sourceRoot":"","sources":["../../src/detections/array-detection-frame-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAMxD,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,GAC5C,oBAAoB,CAUtB"}

package/node_modules/supervision-js-core/dist/detections/buffered-detection-timeline.d.ts

@@ -0,0 +1,14 @@
+import { type BufferedDetectionTimeline, type DetectionBufferOptions, type DetectionBufferState, type DetectionFrameSource } from "#types/detection-timeline";
+import type { DetectionFrame } from "#types/detections";
+/**
+ * Returns the timeline-owned hot-buffer snapshot without copying it.
+ *
+ * This is an internal platform-adapter fast path. Public callers should use
+ * `getBufferedFrames()`, which preserves the existing defensive-copy contract.
+ */
+export declare function getBufferedDetectionTimelineFrameSnapshot(timeline: BufferedDetectionTimeline): readonly DetectionFrame[];
+export declare function createBufferedDetectionTimeline(options: {
+    readonly source: DetectionFrameSource;
+} & DetectionBufferOptions): BufferedDetectionTimeline;
+export declare function createIdleDetectionBufferState(): DetectionBufferState;
+//# sourceMappingURL=buffered-detection-timeline.d.ts.map

package/node_modules/supervision-js-core/dist/detections/buffered-detection-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffered-detection-timeline.d.ts","sourceRoot":"","sources":["../../src/detections/buffered-detection-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,sBAAsB,EAE3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAG1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAqBxD;;;;;GAKG;AACH,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,yBAAyB,GAClC,SAAS,cAAc,EAAE,CAI3B;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE;IACP,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;CACvC,GAAG,sBAAsB,GACzB,yBAAyB,CA4kB3B;AAED,wBAAgB,8BAA8B,IAAI,oBAAoB,CAWrE"}

package/node_modules/supervision-js-core/dist/detections/cold-detection-frame-source.d.ts

@@ -0,0 +1,6 @@
+import type { ColdDetectionFrameStore, DetectionFrameSource } from "#types/detection-timeline";
+export declare function createColdDetectionFrameSource(options: {
+    readonly store: ColdDetectionFrameStore;
+    readonly datasetId: string;
+}): DetectionFrameSource;
+//# sourceMappingURL=cold-detection-frame-source.d.ts.map

package/node_modules/supervision-js-core/dist/detections/cold-detection-frame-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cold-detection-frame-source.d.ts","sourceRoot":"","sources":["../../src/detections/cold-detection-frame-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AAEnC,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,GAAG,oBAAoB,CAUvB"}

package/node_modules/supervision-js-core/dist/detections/composite-detection-frame-source.d.ts

@@ -0,0 +1,3 @@
+import { type CompositeDetectionFrameSourceOptions, type DetectionFrameSource } from "#types/detection-timeline";
+export declare function createCompositeDetectionFrameSource(options: CompositeDetectionFrameSourceOptions): DetectionFrameSource;
+//# sourceMappingURL=composite-detection-frame-source.d.ts.map

package/node_modules/supervision-js-core/dist/detections/composite-detection-frame-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-detection-frame-source.d.ts","sourceRoot":"","sources":["../../src/detections/composite-detection-frame-source.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oCAAoC,EACzC,KAAK,oBAAoB,EAG1B,MAAM,2BAA2B,CAAC;AAoBnC,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,oCAAoC,GAC5C,oBAAoB,CA2DtB"}

package/node_modules/supervision-js-core/dist/detections/editable-annotation-frame-session.d.ts

@@ -0,0 +1,35 @@
+import type { Detection, DetectionFrame } from "#types/detections";
+export type DetectionId = string | number;
+export type EditableDetection = DeepMutable<Detection>;
+export declare enum AnnotationFrameMutationKind {
+    Add = "add",
+    Remove = "remove",
+    Replace = "replace",
+    Transact = "transact",
+    Update = "update"
+}
+export interface AnnotationFrameMutation {
+    readonly kind: AnnotationFrameMutationKind;
+    readonly detectionIds: readonly DetectionId[];
+    readonly previous: DetectionFrame;
+    readonly current: DetectionFrame;
+}
+export type AnnotationFrameMutationListener = (mutation: AnnotationFrameMutation) => void;
+export interface EditableAnnotationFrameSession {
+    getSnapshot(): DetectionFrame;
+    add(detection: Detection, index?: number): DetectionFrame;
+    update(id: DetectionId, update: Partial<Detection> | ((current: Detection) => Detection)): DetectionFrame;
+    remove(id: DetectionId): DetectionFrame;
+    replace(frame: DetectionFrame): DetectionFrame;
+    transact(mutate: (detections: EditableDetection[]) => void, detectionIds?: readonly DetectionId[]): DetectionFrame;
+    subscribe(listener: AnnotationFrameMutationListener): () => void;
+    destroy(): void;
+}
+export declare function createEditableAnnotationFrameSession(initialFrame: DetectionFrame): EditableAnnotationFrameSession;
+type DeepMutable<T> = T extends (...args: never[]) => unknown ? T : T extends readonly [unknown, ...unknown[]] ? {
+    -readonly [TKey in keyof T]: DeepMutable<T[TKey]>;
+} : T extends readonly (infer TValue)[] ? DeepMutable<TValue>[] : T extends object ? {
+    -readonly [TKey in keyof T]: DeepMutable<T[TKey]>;
+} : T;
+export {};
+//# sourceMappingURL=editable-annotation-frame-session.d.ts.map

package/node_modules/supervision-js-core/dist/detections/editable-annotation-frame-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable-annotation-frame-session.d.ts","sourceRoot":"","sources":["../../src/detections/editable-annotation-frame-session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGnE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,CAAC;AAC1C,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;AAEvD,oBAAY,2BAA2B;IACrC,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC;IAC3C,QAAQ,CAAC,YAAY,EAAE,SAAS,WAAW,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAED,MAAM,MAAM,+BAA+B,GAAG,CAC5C,QAAQ,EAAE,uBAAuB,KAC9B,IAAI,CAAC;AAEV,MAAM,WAAW,8BAA8B;IAC7C,WAAW,IAAI,cAAc,CAAC;IAC9B,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;IAC1D,MAAM,CACJ,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,GAC/D,cAAc,CAAC;IAClB,MAAM,CAAC,EAAE,EAAE,WAAW,GAAG,cAAc,CAAC;IACxC,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAAC;IAC/C,QAAQ,CACN,MAAM,EAAE,CAAC,UAAU,EAAE,iBAAiB,EAAE,KAAK,IAAI,EACjD,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,GACpC,cAAc,CAAC;IAClB,SAAS,CAAC,QAAQ,EAAE,+BAA+B,GAAG,MAAM,IAAI,CAAC;IACjE,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,oCAAoC,CAClD,YAAY,EAAE,cAAc,GAC3B,8BAA8B,CA+IhC;AAED,KAAK,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GACzD,CAAC,GACD,CAAC,SAAS,SAAS,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,GACxC;IAAE,CAAC,UAAU,IAAI,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;CAAE,GACrD,CAAC,SAAS,SAAS,CAAC,MAAM,MAAM,CAAC,EAAE,GACjC,WAAW,CAAC,MAAM,CAAC,EAAE,GACrB,CAAC,SAAS,MAAM,GACd;IAAE,CAAC,UAAU,IAAI,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;CAAE,GACrD,CAAC,CAAC"}

package/node_modules/supervision-js-core/dist/detections/memory-cold-detection-frame-store.d.ts

@@ -0,0 +1,3 @@
+import type { ColdDetectionFrameStore } from "#types/detection-timeline";
+export declare function createMemoryColdDetectionFrameStore(): ColdDetectionFrameStore;
+//# sourceMappingURL=memory-cold-detection-frame-store.d.ts.map

package/node_modules/supervision-js-core/dist/detections/memory-cold-detection-frame-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-cold-detection-frame-store.d.ts","sourceRoot":"","sources":["../../src/detections/memory-cold-detection-frame-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAIxB,MAAM,2BAA2B,CAAC;AAuBnC,wBAAgB,mCAAmC,IAAI,uBAAuB,CA0F7E"}

package/node_modules/supervision-js-core/dist/detections/writable-detection-frame-source.d.ts

@@ -0,0 +1,8 @@
+import type { ColdDetectionFrameStore, DetectionFrameRetentionOptions, WritableDetectionFrameSource } from "#types/detection-timeline";
+export declare function createWritableDetectionFrameSource(options: {
+    readonly store: ColdDetectionFrameStore;
+    readonly datasetId: string;
+    readonly chunkDurationSeconds?: number;
+    readonly retention?: DetectionFrameRetentionOptions;
+}): WritableDetectionFrameSource;
+//# sourceMappingURL=writable-detection-frame-source.d.ts.map

package/node_modules/supervision-js-core/dist/detections/writable-detection-frame-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writable-detection-frame-source.d.ts","sourceRoot":"","sources":["../../src/detections/writable-detection-frame-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EAEvB,8BAA8B,EAE9B,4BAA4B,EAC7B,MAAM,2BAA2B,CAAC;AAsBnC,wBAAgB,kCAAkC,CAAC,OAAO,EAAE;IAC1D,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,8BAA8B,CAAC;CACrD,GAAG,4BAA4B,CA6S/B"}

package/node_modules/supervision-js-core/dist/index.d.ts

@@ -0,0 +1,65 @@
+export { createArrayDetectionFrameSource } from "#detections/array-detection-frame-source";
+export { createBufferedDetectionTimeline, createIdleDetectionBufferState, getBufferedDetectionTimelineFrameSnapshot, } from "#detections/buffered-detection-timeline";
+export { createColdDetectionFrameSource } from "#detections/cold-detection-frame-source";
+export { createCompositeDetectionFrameSource } from "#detections/composite-detection-frame-source";
+export { AnnotationFrameMutationKind, createEditableAnnotationFrameSession, type AnnotationFrameMutation, type AnnotationFrameMutationListener, type DetectionId, type EditableDetection, type EditableAnnotationFrameSession, } from "#detections/editable-annotation-frame-session";
+export { createMemoryColdDetectionFrameStore } from "#detections/memory-cold-detection-frame-store";
+export { createWritableDetectionFrameSource } from "#detections/writable-detection-frame-source";
+export { createDetectionPickKey, pickDetectionAtPoint, pickDetectionByMaskId, rebaseDetectionPickToFrame, } from "#interactions/detection-picker";
+export { createViewportController, mediaToScreen, screenToMedia, } from "#interactions/viewport-controller";
+export { createAnnotationEditingEngine } from "#interactions/annotation-editing-engine";
+export { applyAnnotationHandleDrag, deleteAnnotationVertex, findClosestAnnotationSegment, getAnnotationHandles, offsetDetection, pickAnnotationHandle, } from "#interactions/annotation-handles";
+export { BaseBoxStyle } from "#styles/box-style";
+export type { BaseBoxStyleOptions } from "#styles/box-style";
+export { BaseFocusStyle } from "#styles/focus-style";
+export type { BaseFocusStyleOptions } from "#styles/focus-style";
+export { BaseInteractionStyle } from "#styles/interaction-style";
+export type { BaseInteractionStyleOptions } from "#styles/interaction-style";
+export { BaseLabelStyle } from "#styles/label-style";
+export type { BaseLabelStyleOptions } from "#styles/label-style";
+export { BaseMaskStyle } from "#styles/mask-style";
+export type { BaseMaskStyleOptions } from "#styles/mask-style";
+export { BasePolygonStyle } from "#styles/polygon-style";
+export type { BasePolygonStyleOptions } from "#styles/polygon-style";
+export { BasePolylineStyle } from "#styles/polyline-style";
+export type { BasePolylineStyleOptions } from "#styles/polyline-style";
+export { BaseKeypointStyle } from "#styles/keypoint-style";
+export type { BaseKeypointStyleOptions } from "#styles/keypoint-style";
+export { createDefaultAnnotationPresentation, type DefaultAnnotationPresentationOptions, } from "#styles/default-annotation-presentation";
+export { createSourceAwarePresentation, type PresentationStyleSet, type SourcePresentation, type SourcePresentationEntry, } from "#styles/source-presentation";
+export { resolveStyleValue } from "#styles/style-value";
+export { copySortedDetectionFrames, decodeCompressedRleMask, decodeCompressedRleCounts, detectionFrameOverlapsRange, encodeCompressedRleCounts, filterDetectionFramesForRange, selectDetectionFrame, validateDetectionFrames, type DecodedDetectionMask, } from "#utils/detection-frames";
+export { convertDetectionBoxToMask, convertDetectionBoxToPolygon, convertDetectionMaskToBox, convertDetectionMaskToPolygon, convertDetectionPolygonToBox, convertDetectionPolygonToMask, mergeDetectionMasks, mergeDetectionPolygonsByClass, polygonToRect, rasterizePolygonToMask, rasterizeRectToMask, rectToPolygon, type MediaDimensions, } from "#utils/detection-conversions";
+export { DetectionMaskPayloadFormat, computeDetectionMaskRect, computeMaskBounds, decodeDetectionMaskPayload, detectMaskBorders, encodeBinaryMask, encodeBinaryMaskWithBounds, encodeDetectionMaskPayload, extractMaskContour, extractMaskRectRuns, isDeflatedBase64DetectionMaskPayload, type DetectionMaskCompressionCodec, type EncodedBinaryMask, type MaskRectRun, } from "#utils/detection-masks";
+export { centerRectToTopLeftRect, containsPoint, distanceToSegment, getDetectionRect, getPointsRect, pointInPolygon, polygonArea, rectArea, topLeftRectToCenterRect, } from "#utils/geometry";
+export { canReuseMaskStyleArtifacts, resolveMaskStyleOpacity, } from "#utils/mask-style";
+export { DEFAULT_DETECTION_CLASS_STYLES, DEFAULT_DETECTION_COLOR_SEQUENCE, SUPERVISION_ROBOFLOW_COLOR, normalizeDetectionClassName, resolveDetectionClassColorStyle, type DetectionClassColorStyle, } from "#utils/color-palette";
+export { MAX_ID_MASK_PALETTE_ENTRIES, MAX_ID_MASK_STROKE_WIDTH, createIdMaskFrame, type IdMaskFrame, type IdMaskInstruction, } from "#utils/id-mask-frame";
+export { includeDefined } from "#utils/object";
+export { lightenColor, resolveContrastTextColor } from "#utils/color";
+export { resolveAnnotationStyleState } from "#utils/annotation-visibility";
+export { BoxShape, BoxStrokeAlignment } from "#types/box-style";
+export type { ViewportController, ViewportTransform } from "#types/viewport";
+export { AnnotationGeometryKind, AnnotationGestureStateKind, AnnotationHandleKind, type AnnotationCreationTool, type AnnotationEditingEngine, type AnnotationEditingEngineOptions, type AnnotationEditingPreviewStyleContext, type AnnotationEditingState, type AnnotationHandleDefinition, type AnnotationOverlayStyle, type AnnotationPointerInput, type PreviewOverlayData, type PreviewOverlayPoint, } from "#types/editing";
+export type { BoxDrawInstruction, BoxFillStyle, BoxStrokeStyle, BoxStyle, BoxStyleContext, } from "#types/box-style";
+export { DetectionBufferStatus, DetectionFrameRetentionMode, DetectionFrameSelectionMode, type BufferedDetectionTimeline, type ColdDetectionFrameStore, type ColdDetectionFrameStoreLoadOptions, type ColdDetectionFrameStoreWriteOptions, type ColdDetectionFrameStoreWriteSummary, type ChunkedDetectionFrameSourceOptions, type CompositeDetectionFrameSourceEntry, type CompositeDetectionFrameSourceOptions, type DetectionBufferOptions, type DetectionBufferPrepareOptions, type DetectionBufferState, type DetectionFrameChunk, type DetectionFrameChunkDescriptor, type DetectionFrameChunkFetch, type DetectionFrameChunkManifest, type DetectionFrameRetentionOptions, type DetectionFrameSelectionOptions, type DetectionFrameSource, type DetectionFrameSourceChanges, type DetectionFrameSourceVersionRange, type DetectionPlaybackGateOptions, type DetectionTimelineContext, type WritableDetectionFrameSource, } from "#types/detection-timeline";
+export { DetectionMaskEncoding, KeypointVisibility, type CompressedRleDetectionMask, type Detection, type DetectionFrame, type DetectionMask, type KeypointEdge, type KeypointGeometry, type Point, type PolygonGeometry, type PolylineGeometry, type Rect, type SkeletonDefinition, type SkeletonDefinitions, type SkeletonEdgeDefinition, type SkeletonVertexDefinition, type TopLeftRect, } from "#types/detections";
+export type { MediaFrameMetadata, MediaTimelineMetadata, PlatformMediaFrame, PlatformMediaFrameSource, } from "#types/media";
+export { MediaRendererFit, MediaRendererPlaybackState, MediaSourceStatus, } from "#types/media-rendering";
+export type { MediaFrameDiagnostics, MediaFrameRenderTimings, MediaRendererDiagnosticsOptions, MediaRendererPresentation, AnnotationVisibility, MediaDisplayAdjustments, MediaRendererQuality, MediaRendererState, MediaRendererStateController, MediaSourceState, } from "#types/media-rendering";
+export { MediaSessionActivityKind, MediaSessionActivityStatus, MediaSessionMode, MediaSessionStatus, } from "#types/session-lifecycle";
+export type { MediaSessionActivity, MediaSessionLifecycleState, MediaSessionStateListener, MediaSessionStateUnsubscribe, } from "#types/session-lifecycle";
+export type { FocusDrawInstruction, FocusFallbackStyle, FocusFillStyle, FocusStyle, FocusStyleContext, FocusStyleValue, } from "#types/focus-style";
+export { FocusTargetMode } from "#types/focus-style";
+export { DetectionPickTarget, MediaInteractionMode, type DetectionPickOptions, type DetectionPickPoint, type DetectionPickResult, type DetectionSelectionOptions, type MediaInteractionOptions, } from "#types/interaction";
+export { DetectionInteractionState, type InteractionPresentation, type InteractionStyle, type InteractionStyleContext, } from "#types/interaction-style";
+export type { LabelBackgroundStyle, LabelDrawInstruction, LabelOffsetStyle, LabelStyle, LabelStyleContext, LabelTextStyle, } from "#types/label-style";
+export { LabelPlacement, LabelVisibilityMode } from "#types/label-style";
+export type { MaskDrawInstruction, MaskStrokeStyle, MaskStrokeStyleOptions, MaskStyle, MaskStyleContext, } from "#types/mask-style";
+export { MaskRenderMode } from "#types/mask-style";
+export type { PolygonDrawInstruction, PolygonStyle, PolygonStyleContext, } from "#types/polygon-style";
+export type { PolylineDrawInstruction, PolylineStyle, PolylineStyleContext, } from "#types/polyline-style";
+export { KeypointMarkerShape } from "#types/keypoint-style";
+export type { KeypointDrawInstruction, KeypointEdgeDrawInstruction, KeypointMarkerDrawInstruction, KeypointStyle, KeypointStyleContext, } from "#types/keypoint-style";
+export type { AnnotationStyleContext, DetectionStylePredicate, DetectionStyleValue, } from "#types/style";
+//# sourceMappingURL=index.d.ts.map