supervision 0.1.4 → 0.1.5

package/node_modules/supervision-js-core/dist/post-processing/byte-track-tracker.d.ts

@@ -0,0 +1,4 @@
+import type { ByteTrackTracker, ByteTrackTrackingOptions } from "#types/post-processing";
+/** Public core facade for the internal tracker engine workspace. */
+export declare function createByteTrackTracker(options?: ByteTrackTrackingOptions): ByteTrackTracker;
+//# sourceMappingURL=byte-track-tracker.d.ts.map

package/node_modules/supervision-js-core/dist/post-processing/byte-track-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"byte-track-tracker.d.ts","sourceRoot":"","sources":["../../src/post-processing/byte-track-tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,wBAAwB,CAAC;AAEhC,oEAAoE;AACpE,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,wBAA6B,GACrC,gBAAgB,CAElB"}

package/node_modules/supervision-js-core/dist/post-processing/cbiou-tracker.d.ts

@@ -0,0 +1,4 @@
+import type { CBIoUTracker, CBIoUTrackingOptions } from "#types/post-processing";
+/** Public core facade for the internal tracker engine workspace. */
+export declare function createCBIoUTracker(options?: CBIoUTrackingOptions): CBIoUTracker;
+//# sourceMappingURL=cbiou-tracker.d.ts.map

package/node_modules/supervision-js-core/dist/post-processing/cbiou-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cbiou-tracker.d.ts","sourceRoot":"","sources":["../../src/post-processing/cbiou-tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC,oEAAoE;AACpE,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,oBAAyB,GACjC,YAAY,CAEd"}

package/node_modules/supervision-js-core/dist/post-processing/oc-sort-tracker.d.ts

@@ -0,0 +1,4 @@
+import type { OCSortTracker, OCSortTrackingOptions } from "#types/post-processing";
+/** Public core facade for the internal tracker engine workspace. */
+export declare function createOCSortTracker(options?: OCSortTrackingOptions): OCSortTracker;
+//# sourceMappingURL=oc-sort-tracker.d.ts.map

package/node_modules/supervision-js-core/dist/post-processing/oc-sort-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oc-sort-tracker.d.ts","sourceRoot":"","sources":["../../src/post-processing/oc-sort-tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,oEAAoE;AACpE,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,qBAA0B,GAClC,aAAa,CAEf"}

package/node_modules/supervision-js-core/dist/post-processing/sort-tracker.d.ts

@@ -0,0 +1,4 @@
+import type { SortTracker, SortTrackingOptions } from "#types/post-processing";
+/** Public core facade for the internal tracker engine workspace. */
+export declare function createSortTracker(options?: SortTrackingOptions): SortTracker;
+//# sourceMappingURL=sort-tracker.d.ts.map

package/node_modules/supervision-js-core/dist/post-processing/sort-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-tracker.d.ts","sourceRoot":"","sources":["../../src/post-processing/sort-tracker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,oEAAoE;AACpE,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,mBAAwB,GAChC,WAAW,CAEb"}

package/node_modules/supervision-js-core/dist/post-processing/tracking.d.ts

@@ -0,0 +1,9 @@
+import type { DetectionFrame } from "#types/detections";
+import { TrackingGeometry, type DetectionPostProcessorFactory, type TrackingProjection } from "#types/post-processing";
+export declare const detectionPostProcessors: DetectionPostProcessorFactory;
+/**
+ * Creates the lightweight projection sent to a tracker or tracking worker.
+ * Masks and keypoint arrays never cross the worker boundary.
+ */
+export declare function projectDetectionFrameForTracking(frame: DetectionFrame, geometry: TrackingGeometry): readonly TrackingProjection[];
+//# sourceMappingURL=tracking.d.ts.map

package/node_modules/supervision-js-core/dist/post-processing/tracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking.d.ts","sourceRoot":"","sources":["../../src/post-processing/tracking.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,cAAc,EAAQ,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,gBAAgB,EAGhB,KAAK,6BAA6B,EAIlC,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAqBhC,eAAO,MAAM,uBAAuB,EAAE,6BA2KrC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,gBAAgB,GACzB,SAAS,kBAAkB,EAAE,CAkB/B"}

package/node_modules/supervision-js-core/dist/types/detections.d.ts

@@ -98,10 +98,12 @@ export interface CompressedRleDetectionMask {
 }
 export type DetectionMask = CompressedRleDetectionMask;
 /**
- * One model output for a media frame.
+ * One semantic detection for a media frame.
  *
- * A detection stores model data only: identity, class, confidence, geometry,
- * mask, and caller metadata. It intentionally does not carry render styling.
+ * A detection may come directly from a model or from a semantic
+ * post-processor such as tracking. It stores identity, class, confidence,
+ * geometry, mask, and caller metadata, but intentionally does not carry render
+ * styling.
  * Styling is resolved through presentation styles so the same detections can be
  * rendered as boxes, masks, labels, or future layers without mutating the
  * underlying annotation data.
@@ -111,6 +113,12 @@ export interface Detection {
      * Optional stable identity for picking, interaction, and host app metadata.
      */
     readonly id?: string | number;
+    /**
+     * Optional temporal identity assigned by a tracking post-processor.
+     * This is separate from `id`, which remains the annotation/picking identity.
+     * Post-processors may update this derived field in place.
+     */
+    trackerId?: number;
     /**
      * Optional provenance for detections copied from a composed source.
      *

package/node_modules/supervision-js-core/dist/types/detections.d.ts.map

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

package/node_modules/supervision-js-core/dist/types/post-processing.d.ts

@@ -0,0 +1,148 @@
+import type { DetectionFrame, Rect } from "#types/detections";
+/** Built-in semantic detection post-processors. */
+export type DetectionPostProcessor = TrackingDetectionPostProcessor;
+/** Geometry projected into a tracker. The original detection payload is retained. */
+export declare enum TrackingGeometry {
+    Box = "box",
+    Mask = "mask",
+    Keypoints = "keypoints"
+}
+export interface SortTrackingOptions {
+    /** Missing-track buffer expressed in 30 FPS frames. Zero removes on the first miss. */
+    readonly lostTrackBuffer?: number;
+    /** Source frame rate used to scale `lostTrackBuffer`. */
+    readonly frameRate?: number;
+    /** Minimum confidence required to create a new track. Missing confidence is 1. */
+    readonly trackActivationThreshold?: number;
+    /** Successful observations required before a track receives an ID. */
+    readonly minimumConsecutiveFrames?: number;
+    /** Minimum intersection-over-union accepted by assignment. */
+    readonly minimumIouThreshold?: number;
+}
+export interface ByteTrackTrackingOptions {
+    /** Missing-track buffer expressed in 30 FPS frames. Zero removes on the first miss. */
+    readonly lostTrackBuffer?: number;
+    /** Source frame rate used to scale `lostTrackBuffer`. */
+    readonly frameRate?: number;
+    /** Minimum confidence required to create a new track. Missing confidence is 1. */
+    readonly trackActivationThreshold?: number;
+    /** Consecutive observations required before a track receives an ID. */
+    readonly minimumConsecutiveFrames?: number;
+    /** Minimum intersection-over-union accepted by either association stage. */
+    readonly minimumIouThreshold?: number;
+    /** Confidence boundary between the first and second association stages. */
+    readonly highConfidenceDetectionThreshold?: number;
+}
+export interface CBIoUTrackingOptions {
+    /** Missing-track buffer expressed in 30 FPS frames. */
+    readonly lostTrackBuffer?: number;
+    /** Source frame rate used to scale `lostTrackBuffer`. */
+    readonly frameRate?: number;
+    /** Minimum confidence required to create a new track. */
+    readonly trackActivationThreshold?: number;
+    /** Successful observations required before a track receives an ID. */
+    readonly minimumConsecutiveFrames?: number;
+    /** Minimum fused buffered-IoU score in the high-confidence pass. */
+    readonly minimumIouThresholdFirstAssociation?: number;
+    /** Minimum buffered IoU in the low-confidence recovery pass. */
+    readonly minimumIouThresholdSecondAssociation?: number;
+    /** Minimum fused buffered-IoU score for tentative tracks. */
+    readonly minimumIouThresholdUnconfirmedAssociation?: number;
+    /** Confidence boundary between the first and second association stages. */
+    readonly highConfidenceDetectionThreshold?: number;
+    /** Whether eligible detections on the first frame receive IDs immediately. */
+    readonly instantFirstFrameActivation?: boolean;
+    /** Proportional box expansion used by the first association stage. */
+    readonly bufferRatioFirst?: number;
+    /** Proportional box expansion used by the second association stage. */
+    readonly bufferRatioSecond?: number;
+}
+export interface OCSortTrackingOptions {
+    /** Missing-track buffer expressed in 30 FPS frames. */
+    readonly lostTrackBuffer?: number;
+    /** Source frame rate used to scale `lostTrackBuffer`. */
+    readonly frameRate?: number;
+    /** Consecutive observations required before a recovered track emits its ID. */
+    readonly minimumConsecutiveFrames?: number;
+    /** Minimum IoU accepted by primary and last-observation association. */
+    readonly minimumIouThreshold?: number;
+    /** Weight applied to observation-centric motion-direction consistency. */
+    readonly directionConsistencyWeight?: number;
+    /** Minimum confidence eligible for association and track creation. */
+    readonly highConfidenceDetectionThreshold?: number;
+    /** Observation-history lookback used to estimate motion direction. */
+    readonly deltaT?: number;
+}
+export interface SortTrackingDetectionPostProcessor {
+    readonly kind: "tracking";
+    readonly algorithm: "sort";
+    readonly geometry: TrackingGeometry;
+    readonly options: Required<SortTrackingOptions>;
+}
+export interface ByteTrackTrackingDetectionPostProcessor {
+    readonly kind: "tracking";
+    readonly algorithm: "bytetrack";
+    readonly geometry: TrackingGeometry;
+    readonly options: Required<ByteTrackTrackingOptions>;
+}
+export interface CBIoUTrackingDetectionPostProcessor {
+    readonly kind: "tracking";
+    readonly algorithm: "cbiou";
+    readonly geometry: TrackingGeometry;
+    readonly options: Required<CBIoUTrackingOptions>;
+}
+export interface OCSortTrackingDetectionPostProcessor {
+    readonly kind: "tracking";
+    readonly algorithm: "ocsort";
+    readonly geometry: TrackingGeometry;
+    readonly options: Required<OCSortTrackingOptions>;
+}
+export type TrackingDetectionPostProcessor = SortTrackingDetectionPostProcessor | ByteTrackTrackingDetectionPostProcessor | CBIoUTrackingDetectionPostProcessor | OCSortTrackingDetectionPostProcessor;
+export interface TrackingProjection {
+    readonly confidence?: number;
+    readonly detectionIndex: number;
+    readonly rect: Rect;
+}
+export interface TrackingAssignment {
+    readonly detectionIndex: number;
+    readonly trackerId: number;
+}
+export interface SortTrackerUpdate {
+    readonly assignments: readonly TrackingAssignment[];
+    readonly activeTrackCount: number;
+    readonly confirmedTrackCount: number;
+}
+export interface SortTracker {
+    reset(): void;
+    update(detections: readonly TrackingProjection[], frameIndex?: number): SortTrackerUpdate;
+}
+export type ByteTrackTrackerUpdate = SortTrackerUpdate;
+export interface ByteTrackTracker {
+    reset(): void;
+    update(detections: readonly TrackingProjection[], frameIndex?: number): ByteTrackTrackerUpdate;
+}
+export type CBIoUTrackerUpdate = SortTrackerUpdate;
+export type CBIoUTracker = SortTracker;
+export type OCSortTrackerUpdate = SortTrackerUpdate;
+export type OCSortTracker = SortTracker;
+export type TrackingTracker = SortTracker | ByteTrackTracker | CBIoUTracker | OCSortTracker;
+export interface DetectionPostProcessorFactory {
+    tracking(options: CBIoUTrackingOptions & {
+        readonly algorithm: "cbiou";
+        readonly geometry?: TrackingGeometry;
+    }): CBIoUTrackingDetectionPostProcessor;
+    tracking(options: OCSortTrackingOptions & {
+        readonly algorithm: "ocsort";
+        readonly geometry?: TrackingGeometry;
+    }): OCSortTrackingDetectionPostProcessor;
+    tracking(options: ByteTrackTrackingOptions & {
+        readonly algorithm: "bytetrack";
+        readonly geometry?: TrackingGeometry;
+    }): ByteTrackTrackingDetectionPostProcessor;
+    tracking(options?: SortTrackingOptions & {
+        readonly algorithm?: "sort";
+        readonly geometry?: TrackingGeometry;
+    }): SortTrackingDetectionPostProcessor;
+}
+export type TrackingFrameProjector = (frame: DetectionFrame, geometry: TrackingGeometry) => readonly TrackingProjection[];
+//# sourceMappingURL=post-processing.d.ts.map

package/node_modules/supervision-js-core/dist/types/post-processing.d.ts.map

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

package/node_modules/supervision-js-core/dist/utils/detection-frames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"detection-frames.d.ts","sourceRoot":"","sources":["../../src/utils/detection-frames.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAOD,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,GACrD,cAAc,EAAE,CA0ClB;AAmCD,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,SAAS,cAAc,EAAE,GACzC,IAAI,CAuHN;AAsDD,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,cAAc,EAAE,CAIlB;AAED,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,8BAAmC,GAC3C,cAAc,GAAG,SAAS,CAe5B;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,aAAa,GAClB,oBAAoB,CAkCtB;AAoFD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,WAOhB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,YA4BvD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,UA0BlE"}
+{"version":3,"file":"detection-frames.d.ts","sourceRoot":"","sources":["../../src/utils/detection-frames.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC3B;AAOD,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,SAAS,cAAc,EAAE,GAAG,SAAS,GACrD,cAAc,EAAE,CA0ClB;AAmCD,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,SAAS,cAAc,EAAE,GACzC,IAAI,CA8HN;AAsDD,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,cAAc,EAAE,CAIlB;AAED,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,8BAAmC,GAC3C,cAAc,GAAG,SAAS,CAe5B;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,aAAa,GAClB,oBAAoB,CAkCtB;AAoFD,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,cAAc,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,WAOhB;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,YA4BvD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,UA0BlE"}

package/node_modules/supervision-js-core/package.json

@@ -23,6 +23,10 @@
       "types": "./dist/interactions/*.d.ts",
       "import": "./dist/interactions/*.js"
     },
+    "#post-processing/*": {
+      "types": "./dist/post-processing/*.d.ts",
+      "import": "./dist/post-processing/*.js"
+    },
     "#styles/*": {
       "types": "./dist/styles/*.d.ts",
       "import": "./dist/styles/*.js"
@@ -41,11 +45,14 @@
   ],
   "sideEffects": false,
   "scripts": {
-    "build": "npm run clean && npm run build:types && npm run build:js",
-    "build:js": "rollup -c",
-    "build:types": "tsc --emitDeclarationOnly -p tsconfig.json",
+    "build": "npm run build -w supervision-js-trackers && npm run clean && npm run build:types:local && npm run build:js:local",
+    "build:js": "npm run build -w supervision-js-trackers && npm run build:js:local",
+    "build:js:local": "rollup -c",
+    "build:types": "npm run build:types -w supervision-js-trackers && npm run build:types:local",
+    "build:types:local": "tsc --emitDeclarationOnly -p tsconfig.json",
     "clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
-    "dev": "rollup -c -w",
-    "typecheck": "tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.test.json"
+    "dev": "npm run build -w supervision-js-trackers && npm run dev:local",
+    "dev:local": "rollup -c -w",
+    "typecheck": "npm run build:types -w supervision-js-trackers && tsc --noEmit -p tsconfig.json && tsc --noEmit -p tsconfig.test.json"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supervision",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Browser-native computer vision media rendering and annotation engine.",
   "repository": {
     "type": "git",
@@ -36,7 +36,8 @@
       "types": "./dist/editing.d.ts",
       "import": "./dist/editing.js"
     },
-    "./render-preparation-worker": "./dist/mask-preparation.worker.js"
+    "./render-preparation-worker": "./dist/mask-preparation.worker.js",
+    "./detection-post-processing-worker": "./dist/tracking.worker.js"
   },
   "imports": {
     "#editing/*": {
@@ -59,6 +60,10 @@
       "types": "./dist/playback/*.d.ts",
       "import": "./dist/playback/*.js"
     },
+    "#post-processing/*": {
+      "types": "./dist/post-processing/*.d.ts",
+      "import": "./dist/post-processing/*.js"
+    },
     "#render-preparation/*": {
       "types": "./dist/render-preparation/*.d.ts",
       "import": "./dist/render-preparation/*.js"