@camstack/types 1.2.98 → 1.2.100

package/dist/types/frame-view.d.ts

@@ -0,0 +1,52 @@
+import type { FrameFormat } from './io.js';
+export interface FrameViewCrop {
+    readonly left: number;
+    readonly top: number;
+    readonly width: number;
+    readonly height: number;
+}
+export interface FrameViewSpec {
+    readonly crop?: FrameViewCrop;
+    readonly content: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly fit: 'stretch' | 'contain';
+    readonly format: 'rgb' | 'gray' | 'jpeg';
+}
+export interface FrameViewGeometry {
+    readonly source: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly sourceCrop: FrameViewCrop;
+    readonly output: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly scale: {
+        readonly x: number;
+        readonly y: number;
+    };
+}
+/**
+ * Process-local frame identity. It is serializable so it can ride an in-process
+ * capability call, but `registryId` deliberately prevents resolution in any
+ * other process or execution group.
+ */
+export interface FrameRef {
+    readonly registryId: string;
+    readonly id: string;
+    readonly width: number;
+    readonly height: number;
+    readonly format: Extract<FrameFormat, 'rgb' | 'gray'>;
+    readonly timestamp: number;
+    readonly capturedAt?: number;
+}
+export interface MaterializedFrameView {
+    readonly data: Uint8Array;
+    readonly width: number;
+    readonly height: number;
+    readonly format: FrameViewSpec['format'];
+    readonly geometry: FrameViewGeometry;
+}

package/dist/types/io.d.ts

@@ -1,3 +1,4 @@
+import type { FrameRef } from './frame-view.js';
 export interface BoundingBox {
     readonly x: number;
     readonly y: number;
@@ -31,6 +32,8 @@ export interface FrameInput {
     readonly width: number;
     readonly height: number;
     readonly timestamp: number;
+    /** Local lazy source; `data` is empty until an inline fallback is selected. */
+    readonly frameRef?: FrameRef;
 }
 /**
  * Wire-safe audio chunk passed to the audio-analyzer and detection-pipeline

package/dist/types/labels.d.ts

@@ -11,3 +11,14 @@ export interface ClassMapDefinition {
     readonly mapping: Readonly<Record<string, string>>;
     readonly preserveOriginal: boolean;
 }
+/** Detection-macro targets a catalog `classMap` may resolve to. */
+export declare const CLASS_MAP_MACRO_TARGETS: readonly ["person", "vehicle", "animal", "package"];
+export declare const ClassMapDefinitionSchema: z.ZodObject<{
+    mapping: z.ZodRecord<z.ZodString, z.ZodEnum<{
+        person: "person";
+        vehicle: "vehicle";
+        animal: "animal";
+        package: "package";
+    }>>;
+    preserveOriginal: z.ZodBoolean;
+}, z.core.$strip>;

package/dist/types/models.d.ts

@@ -245,6 +245,15 @@ export declare const ModelCatalogEntrySchema: z.ZodObject<{
         }>>;
         resolution: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
+    classMap: z.ZodOptional<z.ZodObject<{
+        mapping: z.ZodRecord<z.ZodString, z.ZodEnum<{
+            person: "person";
+            vehicle: "vehicle";
+            animal: "animal";
+            package: "package";
+        }>>;
+        preserveOriginal: z.ZodBoolean;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ModelCatalogEntry = z.infer<typeof ModelCatalogEntrySchema>;
 export interface DetectionModel {
@@ -327,6 +336,15 @@ export declare const ModelConvertMetadataSchema: z.ZodObject<{
         segmentation: "segmentation";
     }>;
     faceAlignment: z.ZodOptional<z.ZodBoolean>;
+    classMap: z.ZodOptional<z.ZodObject<{
+        mapping: z.ZodRecord<z.ZodString, z.ZodEnum<{
+            person: "person";
+            vehicle: "vehicle";
+            animal: "animal";
+            package: "package";
+        }>>;
+        preserveOriginal: z.ZodBoolean;
+    }, z.core.$strip>>;
 }, z.core.$strip>;
 export type ModelConvertMetadata = z.infer<typeof ModelConvertMetadataSchema>;
 export declare const ConvertArtifactSchema: z.ZodObject<{
@@ -466,6 +484,15 @@ export declare const ConvertResultSchema: z.ZodObject<{
             }>>;
             resolution: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
+        classMap: z.ZodOptional<z.ZodObject<{
+            mapping: z.ZodRecord<z.ZodString, z.ZodEnum<{
+                person: "person";
+                vehicle: "vehicle";
+                animal: "animal";
+                package: "package";
+            }>>;
+            preserveOriginal: z.ZodBoolean;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
     artifacts: z.ZodReadonly<z.ZodArray<z.ZodObject<{
         format: z.ZodEnum<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.98",
+  "version": "1.2.100",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",