@camstack/types 0.1.2 → 0.1.4

package/dist/types/io.d.ts

@@ -0,0 +1,25 @@
+export interface BoundingBox {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+export interface Landmark {
+    readonly x: number;
+    readonly y: number;
+    readonly label?: string;
+}
+export interface FrameInput {
+    readonly data: Buffer;
+    readonly format: 'jpeg' | 'rgb' | 'yuv420';
+    readonly width: number;
+    readonly height: number;
+    readonly timestamp: number;
+}
+export interface AudioChunkInput {
+    readonly data: Float32Array;
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly timestamp: number;
+}
+//# sourceMappingURL=io.d.ts.map

package/dist/types/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/types/io.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B"}

package/dist/types/labels.d.ts

@@ -0,0 +1,12 @@
+export interface LabelDefinition {
+    readonly id: string;
+    readonly name: string;
+    readonly category?: string;
+    readonly description?: string;
+    readonly icon?: string;
+}
+export interface ClassMapDefinition {
+    readonly mapping: Readonly<Record<string, string>>;
+    readonly preserveOriginal: boolean;
+}
+//# sourceMappingURL=labels.d.ts.map

package/dist/types/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../src/types/labels.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAA;CACnC"}

package/dist/types/live-state.d.ts

@@ -0,0 +1,47 @@
+import type { BoundingBox } from './io.js';
+import type { ObjectState } from './tracked.js';
+import type { DetectionEvent } from './events.js';
+import type { PipelineStatus } from './pipeline.js';
+export interface TrackedObjectSummary {
+    readonly trackId: string;
+    readonly class: string;
+    readonly originalClass: string;
+    readonly state: ObjectState;
+    readonly bbox: BoundingBox;
+    readonly velocity: {
+        readonly dx: number;
+        readonly dy: number;
+    };
+    readonly dwellTimeMs: number;
+    readonly inZones: readonly string[];
+    readonly identity?: string;
+    readonly plateText?: string;
+    readonly subClass?: string;
+}
+export interface ZoneLiveState {
+    readonly zoneId: string;
+    readonly zoneName: string;
+    readonly occupied: boolean;
+    readonly objectCount: number;
+    readonly objectsByClass: Readonly<Record<string, number>>;
+    readonly trackIds: readonly string[];
+    readonly avgDwellTimeMs: number;
+    readonly totalEntrancesToday: number;
+    readonly totalExitsToday: number;
+    readonly loiteringTracks: readonly string[];
+}
+export interface CameraLiveState {
+    readonly deviceId: string;
+    readonly lastFrameTimestamp: number;
+    readonly activeObjects: number;
+    readonly movingObjects: number;
+    readonly stationaryObjects: number;
+    readonly objectCounts: Readonly<Record<string, number>>;
+    readonly tracks: readonly TrackedObjectSummary[];
+    readonly zones: readonly ZoneLiveState[];
+    readonly lastEvent?: DetectionEvent;
+    readonly pipelineStatus: readonly PipelineStatus[];
+    readonly avgPipelineMs: number;
+    readonly currentFps: number;
+}
+//# sourceMappingURL=live-state.d.ts.map

package/dist/types/live-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-state.d.ts","sourceRoot":"","sources":["../../src/types/live-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEnD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACzD,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACvD,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAA;IAChD,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAA;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAA;IACnC,QAAQ,CAAC,cAAc,EAAE,SAAS,cAAc,EAAE,CAAA;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B"}

package/dist/types/models.d.ts

@@ -0,0 +1,79 @@
+import type { LabelDefinition, ClassMapDefinition } from './labels.js';
+export type ModelFormat = 'onnx' | 'coreml' | 'openvino' | 'tflite' | 'pt';
+export type ModelOutputFormat = 'yolo' | 'ssd' | 'embedding' | 'classification' | 'ocr' | 'segmentation';
+export interface ModelFormatEntry {
+    readonly url: string;
+    readonly sizeMB: number;
+    /** Whether this format is a directory bundle (e.g., .mlpackage) rather than a single file */
+    readonly isDirectory?: boolean;
+    /**
+     * For directory formats: list of files relative to the directory root.
+     * The downloader fetches each file from `{url}/{file}` and saves to `{modelDir}/{file}`.
+     * If omitted for a directory format, the downloader probes HuggingFace API (slower).
+     */
+    readonly files?: readonly string[];
+    /** Runtime(s) that can use this format. If omitted, inferred from ModelFormat key */
+    readonly runtimes?: readonly ('node' | 'python')[];
+}
+/**
+ * Extra file that must be downloaded alongside the model (e.g., labels JSON, dict.txt).
+ * The downloader fetches from `url` and saves to `{modelsDir}/{filename}`.
+ */
+export interface ModelExtraFile {
+    readonly url: string;
+    readonly filename: string;
+    readonly sizeMB: number;
+}
+export interface ModelCatalogEntry {
+    readonly id: string;
+    readonly name: string;
+    readonly description: string;
+    readonly formats: Partial<Readonly<Record<ModelFormat, ModelFormatEntry>>>;
+    readonly inputSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly labels: readonly LabelDefinition[];
+    readonly inputLayout?: 'nchw' | 'nhwc';
+    readonly inputNormalization?: 'zero-one' | 'imagenet' | 'none';
+    /**
+     * Auxiliary files required at runtime (labels JSON, charset dict, etc.).
+     * Downloaded into the same modelsDir alongside the model file.
+     */
+    readonly extraFiles?: readonly ModelExtraFile[];
+}
+export interface DetectionModel {
+    readonly id: string;
+    readonly name: string;
+    readonly labels: readonly string[];
+    readonly inputSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+}
+export interface ModelDownloadOptions {
+    readonly url: string;
+    readonly fallbackUrls?: readonly string[];
+    readonly destDir: string;
+    readonly filename?: string;
+    readonly expectedSha256?: string;
+    readonly onProgress?: (downloaded: number, total: number) => void;
+}
+export interface ModelDownloadResult {
+    readonly filePath: string;
+    readonly downloadedBytes: number;
+    readonly fromCache: boolean;
+}
+export interface CustomModelMetadata {
+    readonly name: string;
+    readonly inputSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly labels: readonly LabelDefinition[];
+    readonly classMap?: ClassMapDefinition;
+    readonly inputLayout?: 'nchw' | 'nhwc';
+    readonly inputNormalization?: 'zero-one' | 'imagenet' | 'none';
+    readonly outputFormat: ModelOutputFormat;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/types/models.d.ts.map

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

package/dist/types/pipeline-schema.d.ts

@@ -0,0 +1,78 @@
+import type { PipelineSlot } from './pipeline.js';
+import type { ModelFormat } from './models.js';
+export interface PipelineAddonSchema {
+    readonly id: string;
+    readonly name: string;
+    readonly slot: PipelineSlot;
+    readonly inputClasses: readonly string[];
+    readonly outputClasses: readonly string[];
+    /** Which child slots this addon can host (e.g. detector hosts cropper/classifier) */
+    readonly childSlots: readonly PipelineSlot[];
+    /** Available models with download status per format */
+    readonly models: readonly PipelineModelOption[];
+    readonly defaultModelId: string;
+    readonly defaultConfidence: number;
+    /** Best runtime for this addon on this agent — resolved by PlatformScorer */
+    readonly defaultRuntime: string;
+    /** Best backend for this addon on this agent — resolved by PlatformScorer */
+    readonly defaultBackend: string;
+}
+export interface PipelineModelOption {
+    readonly id: string;
+    readonly name: string;
+    readonly formats: Partial<Readonly<Record<ModelFormat, {
+        downloaded: boolean;
+        sizeMB: number;
+    }>>>;
+}
+export interface PipelineSlotSchema {
+    readonly id: PipelineSlot;
+    readonly label: string;
+    readonly priority: number;
+    /** Which slot is the parent (null for root detectors) */
+    readonly parentSlot: PipelineSlot | null;
+    readonly addons: readonly PipelineAddonSchema[];
+}
+export interface PipelineSchema {
+    readonly slots: readonly PipelineSlotSchema[];
+}
+/** A fully-resolved pipeline step with all defaults from PlatformScorer */
+export interface PipelineDefaultStep {
+    readonly addonId: string;
+    readonly addonName: string;
+    readonly slot: PipelineSlot;
+    readonly inputClasses: readonly string[];
+    readonly outputClasses: readonly string[];
+    readonly enabled: boolean;
+    readonly agentId: string;
+    readonly runtime: string;
+    readonly backend: string;
+    readonly modelId: string;
+    readonly confidence: number;
+    readonly classFilters: readonly string[];
+    readonly children: readonly PipelineDefaultStep[];
+}
+export interface PipelineTemplateStep {
+    readonly addonId: string;
+    readonly enabled: boolean;
+    readonly agentId: string;
+    readonly runtime: string;
+    readonly backend: string;
+    readonly modelId: string;
+    readonly confidence: number;
+    readonly classFilters: readonly string[];
+    readonly children: readonly PipelineTemplateStep[];
+}
+export interface PipelineTemplate {
+    readonly id: string;
+    readonly name: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly steps: readonly PipelineTemplateStep[];
+}
+export interface TemplateValidationResult {
+    readonly valid: boolean;
+    readonly steps: readonly PipelineTemplateStep[];
+    readonly warnings: readonly string[];
+}
+//# sourceMappingURL=pipeline-schema.d.ts.map

package/dist/types/pipeline-schema.d.ts.map

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

package/dist/types/pipeline.d.ts

@@ -0,0 +1,42 @@
+import type { DetectorOutput, CropperOutput, ClassifierOutput, RefinerOutput } from './detection.js';
+export type PipelineSlot = 'detector' | 'cropper' | 'classifier' | 'refiner';
+export interface PipelineNode {
+    readonly step: string;
+    readonly addon: string;
+    readonly configOverride?: Readonly<Record<string, unknown>>;
+    readonly children?: readonly PipelineNode[];
+}
+export interface PipelineConfig {
+    readonly video: readonly PipelineNode[];
+    readonly audio?: PipelineNode;
+}
+export interface PipelineStatus {
+    readonly addon: string;
+    readonly slot: PipelineSlot;
+    readonly state: 'initializing' | 'ready' | 'running' | 'error';
+    readonly error?: string;
+    readonly lastRunMs?: number;
+}
+export interface StepError {
+    readonly code: string;
+    readonly message: string;
+    readonly childrenSkipped: boolean;
+}
+export interface StepResult {
+    readonly addon: string;
+    readonly slot: PipelineSlot;
+    readonly output: DetectorOutput | CropperOutput | ClassifierOutput | RefinerOutput;
+    readonly parentResultId?: string;
+    readonly resultId: string;
+    readonly inferenceMs: number;
+    readonly preprocessMs: number;
+    readonly totalMs: number;
+    readonly error?: StepError;
+}
+export interface PipelineResult {
+    readonly results: readonly StepResult[];
+    readonly totalMs: number;
+    readonly timings: Readonly<Record<string, number>>;
+    readonly frameTimestamp: number;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/types/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/types/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEpG,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,GAAG,SAAS,CAAA;AAE5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAA;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;IAC3B,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,GAAG,gBAAgB,GAAG,aAAa,CAAA;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAClD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC"}

package/dist/types/tracked.d.ts

@@ -0,0 +1,21 @@
+import type { BoundingBox } from './io.js';
+import type { SpatialDetection } from './detection.js';
+export type ObjectState = 'entering' | 'moving' | 'stationary' | 'leaving' | 'loitering';
+export interface TrackedDetection extends SpatialDetection {
+    readonly trackId: string;
+    readonly trackAge: number;
+    readonly velocity?: {
+        readonly dx: number;
+        readonly dy: number;
+    };
+    readonly path: readonly BoundingBox[];
+}
+export interface TrackedObjectState {
+    readonly trackId: string;
+    readonly state: ObjectState;
+    readonly stationarySince?: number;
+    readonly enteredAt: number;
+    readonly totalDistancePx: number;
+    readonly dwellTimeMs: number;
+}
+//# sourceMappingURL=tracked.d.ts.map

package/dist/types/tracked.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracked.d.ts","sourceRoot":"","sources":["../../src/types/tracked.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEtD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,CAAA;AAExF,MAAM,WAAW,gBAAiB,SAAQ,gBAAgB;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAA;IAChE,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAA;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B"}

package/dist/types/zones.d.ts

@@ -0,0 +1,48 @@
+/** Zone purpose per pipeline stage */
+export type ZoneMode = 'include' | 'exclude' | 'monitor';
+/** Motion event source for a camera */
+export type MotionSource = 'sensor' | 'stream' | 'smart';
+/** A polygon zone with independent motion/detection behavior */
+export interface CameraZone {
+    readonly id: string;
+    readonly name: string;
+    /** Polygon vertices as fraction of frame (0–1) */
+    readonly polygon: readonly {
+        readonly x: number;
+        readonly y: number;
+    }[];
+    /** Zone purpose for motion detection stage */
+    readonly motionMode: ZoneMode;
+    /** Zone purpose for pipeline detection stage */
+    readonly detectionMode: ZoneMode;
+    /** Minimum overlap fraction (0–1) for bbox/mask to count as "in zone" */
+    readonly overlapThreshold: number;
+    /** Use segmentation mask for overlap when available (vs bbox only) */
+    readonly preferMask: boolean;
+    /** Only apply to these detection classes (empty/undefined = all) */
+    readonly classFilter?: readonly string[];
+    /** Seconds of no movement before emitting stationary alert for this zone */
+    readonly stationaryAlertSeconds?: number;
+    /** Visual color for UI rendering */
+    readonly color: string;
+}
+/** Per-camera zone configuration */
+export interface CameraZoneConfig {
+    readonly deviceId: string;
+    readonly zones: readonly CameraZone[];
+    /** Auto-generate rectangular border exclusion zone */
+    readonly autoBorderExclude: {
+        readonly enabled: boolean;
+        /** Fraction of frame edge to exclude (0–0.2 typical) */
+        readonly percent: number;
+    };
+}
+/** Zone membership annotation on a detection */
+export interface DetectionZoneMembership {
+    readonly zoneId: string;
+    readonly zoneName: string;
+    /** Overlap fraction 0–1 */
+    readonly overlap: number;
+    readonly mode: ZoneMode;
+}
+//# sourceMappingURL=zones.d.ts.map

package/dist/types/zones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zones.d.ts","sourceRoot":"","sources":["../../src/types/zones.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAExD,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;AAExD,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACvE,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAA;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAA;IAChC,yEAAyE;IACzE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,sEAAsE;IACtE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IACxC,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;IACrC,sDAAsD;IACtD,QAAQ,CAAC,iBAAiB,EAAE;QAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;QACzB,wDAAwD;QACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KACzB,CAAA;CACF;AAED,gDAAgD;AAChD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CACxB"}

package/dist/utils/cosine-similarity.d.ts

@@ -0,0 +1,3 @@
+/** Cosine similarity between two embedding vectors */
+export declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+//# sourceMappingURL=cosine-similarity.d.ts.map

package/dist/utils/cosine-similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosine-similarity.d.ts","sourceRoot":"","sources":["../../src/utils/cosine-similarity.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAYzE"}

package/dist/utils/hf-url.d.ts

@@ -0,0 +1,2 @@
+export declare function hfModelUrl(repo: string, path: string): string;
+//# sourceMappingURL=hf-url.d.ts.map

package/dist/utils/hf-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hf-url.d.ts","sourceRoot":"","sources":["../../src/utils/hf-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",
@@ -35,13 +35,14 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsc --declaration --emitDeclarationOnly --outDir dist --skipLibCheck",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:watch": "vitest"
   },
   "devDependencies": {
+    "@trpc/server": "^11.16.0",
     "tsup": "^8.0.0",
     "typescript": "~5.9.0",
     "vitest": "^3.0.0"