supervision 0.1.3 → 0.1.5

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

@@ -0,0 +1,112 @@
+import type { Detection, Point } from "#types/detections";
+import type { FillStyle, OpenStrokeStyle, StrokeStyle } from "#types/paint-style";
+import type { AnnotationStyleContext } from "#types/style";
+/**
+ * Discriminator for renderer-neutral shape draw instructions.
+ */
+export declare enum ShapeInstructionKind {
+    Ellipse = "ellipse",
+    Marker = "marker",
+    Path = "path"
+}
+export declare enum MarkerShape {
+    Circle = "circle",
+    Cross = "cross",
+    Square = "square",
+    Triangle = "triangle"
+}
+/**
+ * Coordinate space for marker sizing. Media sizes scale with the viewport;
+ * screen sizes stay constant on screen, matching stroke-width semantics.
+ */
+export declare enum MarkerSizeSpace {
+    Media = "media",
+    Screen = "screen"
+}
+/**
+ * Ellipse or elliptical arc in media coordinates.
+ *
+ * Omitting both angles draws a closed ellipse. Angles are radians measured
+ * from the positive x axis before `rotation` is applied.
+ */
+interface EllipseShapeInstructionBase {
+    readonly kind: ShapeInstructionKind.Ellipse;
+    readonly center: Point;
+    readonly radiusX: number;
+    readonly radiusY: number;
+    /** Rotation in radians around the center. */
+    readonly rotation?: number;
+}
+export interface ClosedEllipseShapeInstruction extends EllipseShapeInstructionBase {
+    readonly startAngle?: never;
+    readonly endAngle?: never;
+    readonly fill?: FillStyle;
+    readonly stroke?: StrokeStyle;
+}
+export interface EllipseArcShapeInstruction extends EllipseShapeInstructionBase {
+    readonly startAngle: number;
+    readonly endAngle: number;
+    readonly fill?: never;
+    readonly stroke?: OpenStrokeStyle;
+}
+export type EllipseShapeInstruction = ClosedEllipseShapeInstruction | EllipseArcShapeInstruction;
+/**
+ * Anchored marker at a media-space point.
+ *
+ * At rotation `0` a triangle points toward positive y (down in media space).
+ * `center` is always the geometric center; semantic anchoring belongs to the
+ * renderer that creates this lower-level instruction.
+ */
+interface MarkerShapeInstructionBase {
+    readonly kind: ShapeInstructionKind.Marker;
+    readonly center: Point;
+    /** Marker diameter in the declared size space. */
+    readonly size: number;
+    readonly sizeSpace: MarkerSizeSpace;
+    /** Rotation in radians around the center. */
+    readonly rotation?: number;
+}
+export interface ClosedMarkerShapeInstruction extends MarkerShapeInstructionBase {
+    readonly shape: MarkerShape.Circle | MarkerShape.Square | MarkerShape.Triangle;
+    readonly fill?: FillStyle;
+    readonly stroke?: StrokeStyle;
+}
+export interface CrossMarkerShapeInstruction extends MarkerShapeInstructionBase {
+    readonly shape: MarkerShape.Cross;
+    readonly fill?: never;
+    readonly stroke?: OpenStrokeStyle;
+}
+export type MarkerShapeInstruction = ClosedMarkerShapeInstruction | CrossMarkerShapeInstruction;
+/**
+ * One or more disconnected subpaths sharing a single style.
+ */
+interface PathShapeInstructionBase {
+    readonly kind: ShapeInstructionKind.Path;
+    readonly segments: readonly (readonly Point[])[];
+}
+export interface ClosedPathShapeInstruction extends PathShapeInstructionBase {
+    readonly closed: true;
+    readonly fill?: FillStyle;
+    readonly stroke: StrokeStyle;
+}
+export interface OpenPathShapeInstruction extends PathShapeInstructionBase {
+    readonly closed: false;
+    readonly fill?: never;
+    readonly stroke: OpenStrokeStyle;
+}
+export type PathShapeInstruction = ClosedPathShapeInstruction | OpenPathShapeInstruction;
+export type ShapeDrawInstruction = EllipseShapeInstruction | MarkerShapeInstruction | PathShapeInstruction;
+export type ShapeStyleContext = AnnotationStyleContext;
+/**
+ * Shape decoration contract.
+ *
+ * A style receives semantic detections and returns renderer-neutral shape
+ * instructions derived from them. Shape decorations are presentation only:
+ * they are not pickable and never become editable annotations. Return
+ * `undefined` or an empty array to skip a detection.
+ */
+export interface ShapeStyle {
+    resolve(detection: Detection, context: ShapeStyleContext): readonly ShapeDrawInstruction[] | undefined;
+}
+export {};
+//# sourceMappingURL=shape-style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shape-style.d.ts","sourceRoot":"","sources":["../../src/types/shape-style.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/dist/utils/shape-geometry.d.ts

@@ -0,0 +1,50 @@
+import type { Point } from "#types/detections";
+import { MarkerShape, MarkerSizeSpace } from "#types/shape-style";
+export interface EllipseGeometry {
+    readonly center: Point;
+    readonly radiusX: number;
+    readonly radiusY: number;
+    readonly rotation?: number;
+    readonly startAngle?: number;
+    readonly endAngle?: number;
+}
+export interface MarkerGeometryInput {
+    readonly center: Point;
+    readonly shape: MarkerShape;
+    readonly size: number;
+    readonly sizeSpace: MarkerSizeSpace;
+    readonly rotation?: number;
+}
+export interface SampledShapePath {
+    readonly closed: boolean;
+    readonly points: readonly Point[];
+}
+/**
+ * Samples an ellipse or elliptical arc into a deterministic polyline so every
+ * backend rasterizes the same structural geometry, including dashed strokes.
+ *
+ * A closed ellipse returns `segmentCount` points without repeating the first
+ * point; an open arc returns `segmentCount + 1` points including both
+ * endpoints.
+ */
+export declare function sampleEllipseArc(ellipse: EllipseGeometry, segmentCount?: number): SampledShapePath;
+/**
+ * Chooses a bounded segment count from the ellipse's on-screen radius. The
+ * result targets sub-pixel chord error without making tiny markers expensive.
+ */
+export declare function resolveEllipseSegmentCount(ellipse: EllipseGeometry, viewportScale?: number, maxErrorPixels?: number): number;
+export type MarkerGeometry = {
+    readonly kind: "circle";
+    readonly center: Point;
+    readonly radius: number;
+} | {
+    readonly kind: "subpaths";
+    readonly closed: boolean;
+    readonly subpaths: readonly (readonly Point[])[];
+};
+/**
+ * Resolves a marker instruction into media-space geometry. Screen-space sizes
+ * are divided by the viewport scale, matching stroke-width semantics.
+ */
+export declare function resolveMarkerGeometry(marker: MarkerGeometryInput, viewportScale?: number): MarkerGeometry;
+//# sourceMappingURL=shape-geometry.d.ts.map

package/node_modules/supervision-js-core/dist/utils/shape-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape-geometry.d.ts","sourceRoot":"","sources":["../../src/utils/shape-geometry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQlE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,eAAe,EACxB,YAAY,SAAgC,GAC3C,gBAAgB,CA0BlB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,eAAe,EACxB,aAAa,SAAI,EACjB,cAAc,SAAM,GACnB,MAAM,CAsBR;AAED,MAAM,MAAM,cAAc,GACtB;IACE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,KAAK,EAAE,CAAC,EAAE,CAAC;CAClD,CAAC;AAEN;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,aAAa,SAAI,GAChB,cAAc,CAmEhB"}

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.3",
+  "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"