@camstack/addon-vision 0.1.0

package/dist/chunk-PDSHDDPV.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalogs/plate-recognition-models.ts","../src/shared/postprocess/paddleocr.ts","../src/addons/plate-recognition/index.ts"],"sourcesContent":["import type { ModelCatalogEntry, LabelDefinition } from '@camstack/types'\nimport { hfModelUrl } from '@camstack/types'\n\nconst HF_REPO = 'camstack/camstack-models'\n\nconst PLATE_TEXT_LABELS: readonly LabelDefinition[] = [\n  { id: 'text', name: 'Plate Text' },\n] as const\n\nexport const PLATE_RECOGNITION_MODELS: readonly ModelCatalogEntry[] = [\n  {\n    id: 'paddleocr-latin',\n    name: 'PaddleOCR Latin',\n    description: 'PaddleOCR recognition model for Latin-script license plates',\n    inputSize: { width: 320, height: 48 },\n    labels: PLATE_TEXT_LABELS,\n    formats: {\n      onnx: {\n        url: hfModelUrl(HF_REPO, 'plateRecognition/paddleocr/onnx/camstack-paddleocr-latin-rec.onnx'),\n        sizeMB: 7.5,\n      },\n      openvino: {\n        url: hfModelUrl(HF_REPO, 'plateRecognition/paddleocr/openvino/camstack-paddleocr-latin.xml'),\n        sizeMB: 4,\n      },\n    },\n  },\n  {\n    id: 'paddleocr-en',\n    name: 'PaddleOCR English',\n    description: 'PaddleOCR recognition model optimized for English license plates',\n    inputSize: { width: 320, height: 48 },\n    labels: PLATE_TEXT_LABELS,\n    formats: {\n      onnx: {\n        url: hfModelUrl(HF_REPO, 'plateRecognition/paddleocr/onnx/camstack-paddleocr-en-rec.onnx'),\n        sizeMB: 7.5,\n      },\n      openvino: {\n        url: hfModelUrl(HF_REPO, 'plateRecognition/paddleocr/openvino/camstack-paddleocr-en.xml'),\n        sizeMB: 4,\n      },\n    },\n  },\n] as const\n","/** Decode CTC output to text.\n *\n * Output shape: [1, seqLen, numChars]\n * Algorithm: argmax per timestep → collapse consecutive duplicates → remove blank (index 0) → join\n */\nexport function ctcDecode(\n  output: Float32Array,\n  seqLen: number,\n  numChars: number,\n  charset: readonly string[], // index 0 = blank token\n): { text: string; confidence: number } {\n  // Step 1: argmax per timestep + track confidence as mean of selected scores\n  let totalLogScore = 0\n  const rawIndices: number[] = []\n\n  for (let t = 0; t < seqLen; t++) {\n    const offset = t * numChars\n    let bestIdx = 0\n    let bestVal = output[offset]!\n\n    for (let c = 1; c < numChars; c++) {\n      const val = output[offset + c]!\n      if (val > bestVal) {\n        bestVal = val\n        bestIdx = c\n      }\n    }\n\n    rawIndices.push(bestIdx)\n    totalLogScore += bestVal\n  }\n\n  // Step 2: collapse consecutive duplicates\n  const collapsed: number[] = []\n  for (let i = 0; i < rawIndices.length; i++) {\n    const cur = rawIndices[i]!\n    if (i === 0 || cur !== rawIndices[i - 1]) {\n      collapsed.push(cur)\n    }\n  }\n\n  // Step 3: remove blank (index 0)\n  const filtered = collapsed.filter((idx) => idx !== 0)\n\n  // Step 4: join characters\n  const text = filtered.map((idx) => charset[idx] ?? '').join('')\n\n  const confidence = seqLen > 0 ? totalLogScore / seqLen : 0\n\n  return { text, confidence }\n}\n","import type {\n  IClassifierProvider,\n  IDetectionAddon,\n  AddonManifest,\n  AddonContext,\n  CropInput,\n  ClassifierOutput,\n  ConfigUISchema,\n  ClassMapDefinition,\n  ProbeResult,\n  ModelCatalogEntry,\n  DetectionModel,\n  LabelDefinition,\n  IInferenceEngine,\n  RequiredStep,\n} from '@camstack/types'\nimport { PLATE_RECOGNITION_MODELS } from '../../catalogs/plate-recognition-models.js'\nimport { cropRegion, resizeAndNormalize } from '../../shared/image-utils.js'\nimport { ctcDecode } from '../../shared/postprocess/paddleocr.js'\nimport { resolveEngine } from '../../shared/engine-resolver.js'\n\nconst PLATE_TEXT_LABEL: LabelDefinition = { id: 'plate-text', name: 'Plate Text' }\nconst PLATE_TEXT_LABELS: readonly LabelDefinition[] = [PLATE_TEXT_LABEL]\nconst PLATE_REC_CLASS_MAP: ClassMapDefinition = { mapping: {}, preserveOriginal: true }\n\nimport * as fs from 'node:fs'\nimport * as path from 'node:path'\n\n/** Load charset from dict.txt file — index 0 is the CTC blank token */\nfunction loadCharset(modelsDir: string, modelId: string): readonly string[] {\n  // Try to find the dict file next to the model\n  const dictNames = [\n    `camstack-${modelId}-dict.txt`,\n    `camstack-paddleocr-latin-dict.txt`,\n    `camstack-paddleocr-en-dict.txt`,\n  ]\n  for (const name of dictNames) {\n    const dictPath = path.join(modelsDir, name)\n    if (fs.existsSync(dictPath)) {\n      const lines = fs.readFileSync(dictPath, 'utf-8').split('\\n').filter((l) => l.length > 0)\n      // PaddleOCR convention: blank token at index 0, then dict chars, then a space token at end\n      return ['', ...lines, ' ']\n    }\n  }\n  throw new Error(`PlateRecognitionAddon: dict.txt not found in ${modelsDir}`)\n}\n\n// Will be loaded during initialize()\nlet CHARSET: readonly string[] = []\n\nconst REQUIRED_STEPS: readonly RequiredStep[] = [\n  { slot: 'cropper', outputClasses: ['plate'], description: 'Requires a plate detector' },\n]\n\nexport default class PlateRecognitionAddon implements IClassifierProvider, IDetectionAddon {\n  readonly id = 'plate-recognition'\n  readonly slot = 'classifier' as const\n  readonly inputClasses = ['plate'] as const\n  readonly outputClasses = ['plate-text:*'] as const\n  readonly slotPriority = 0\n  readonly requiredSteps = REQUIRED_STEPS\n  readonly manifest: AddonManifest = {\n    id: 'plate-recognition',\n    name: 'License Plate Recognition (OCR)',\n    version: '0.1.0',\n    description: 'PaddleOCR-based license plate text recognition',\n    packageName: '@camstack/addon-vision',\n    slot: 'classifier',\n    inputClasses: ['plate'],\n    outputClasses: ['plate-text:*'],\n    requiredSteps: REQUIRED_STEPS,\n    supportsCustomModels: false,\n    mayRequirePython: false,\n    defaultConfig: {\n      modelId: 'paddleocr-latin',\n      runtime: 'auto',\n      backend: 'cpu',\n      minConfidence: 0.5,\n    },\n  }\n\n  private engine!: IInferenceEngine\n  private modelEntry!: ModelCatalogEntry\n  private minConfidence = 0.5\n\n  async initialize(ctx: AddonContext): Promise<void> {\n    const cfg = ctx.addonConfig\n    const modelId = (cfg['modelId'] as string | undefined) ?? 'paddleocr-latin'\n    const runtime = (cfg['runtime'] as string | undefined) ?? 'auto'\n    const backend = (cfg['backend'] as string | undefined) ?? 'cpu'\n    this.minConfidence = (cfg['minConfidence'] as number | undefined) ?? 0.5\n\n    const entry = PLATE_RECOGNITION_MODELS.find((m) => m.id === modelId)\n    if (!entry) {\n      throw new Error(`PlateRecognitionAddon: unknown modelId \"${modelId}\"`)\n    }\n    this.modelEntry = entry\n\n    // Load charset from dict.txt\n    CHARSET = loadCharset(ctx.locationPaths.models, modelId)\n\n    const resolved = await resolveEngine({\n      runtime: runtime as 'auto',\n      backend,\n      modelEntry: entry,\n      modelsDir: ctx.locationPaths.models,\n    })\n    this.engine = resolved.engine\n  }\n\n  async classify(input: CropInput): Promise<ClassifierOutput> {\n    const start = Date.now()\n    const { width: inputW, height: inputH } = this.modelEntry.inputSize\n\n    // Crop the plate region\n    const plateCrop = await cropRegion(input.frame.data, input.roi)\n\n    // Resize to 320x48, normalize to [0,1], NCHW\n    const normalized = await resizeAndNormalize(plateCrop, inputW, inputH, 'zero-one', 'nchw')\n\n    const output = await this.engine.run(normalized, [1, 3, inputH, inputW])\n\n    // PaddleOCR CTC output shape: [1, seqLen, numChars]\n    const numChars = CHARSET.length\n    const seqLen = output.length / numChars\n    const { text, confidence } = ctcDecode(output, seqLen, numChars, CHARSET)\n\n    if (confidence < this.minConfidence || text.trim().length === 0) {\n      return {\n        classifications: [],\n        inferenceMs: Date.now() - start,\n        modelId: this.modelEntry.id,\n      }\n    }\n\n    return {\n      classifications: [\n        {\n          class: 'plate-text',\n          score: confidence,\n          text,\n        },\n      ],\n      inferenceMs: Date.now() - start,\n      modelId: this.modelEntry.id,\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    await this.engine?.dispose()\n  }\n\n  getConfigSchema(): ConfigUISchema {\n    return {\n      sections: [\n        {\n          id: 'model',\n          title: 'Model',\n          columns: 1,\n          fields: [\n            {\n              key: 'modelId',\n              label: 'Model',\n              type: 'model-selector',\n              catalog: [...PLATE_RECOGNITION_MODELS],\n              allowCustom: false,\n              allowConversion: false,\n              acceptFormats: ['onnx', 'openvino'],\n              requiredMetadata: ['inputSize', 'labels', 'outputFormat'],\n              outputFormatHint: 'ocr',\n            },\n          ],\n        },\n        {\n          id: 'thresholds',\n          title: 'Recognition Settings',\n          columns: 1,\n          fields: [\n            {\n              key: 'minConfidence',\n              label: 'Minimum Confidence',\n              type: 'slider',\n              min: 0.1,\n              max: 1.0,\n              step: 0.05,\n              default: 0.5,\n            },\n          ],\n        },\n      ],\n    }\n  }\n\n  getClassMap(): ClassMapDefinition {\n    return PLATE_REC_CLASS_MAP\n  }\n\n  getModelCatalog(): ModelCatalogEntry[] {\n    return [...PLATE_RECOGNITION_MODELS]\n  }\n\n  getAvailableModels(): DetectionModel[] {\n    return []\n  }\n\n  getActiveLabels(): readonly LabelDefinition[] {\n    return PLATE_TEXT_LABELS\n  }\n\n  async probe(): Promise<ProbeResult> {\n    return {\n      available: true,\n      runtime: this.engine?.runtime ?? 'onnx',\n      device: this.engine?.device ?? 'cpu',\n      capabilities: ['fp32'],\n    }\n  }\n}\n"],"mappings":"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","names":["PLATE_TEXT_LABELS"]}

package/dist/chunk-Q3SQOYG6.mjs

@@ -0,0 +1,218 @@
+import {
+  BIRD_SPECIES_MODELS
+} from "./chunk-ISOIDU4U.mjs";
+import {
+  cropRegion,
+  resizeAndNormalize
+} from "./chunk-6OR5TE7A.mjs";
+import {
+  resolveEngine
+} from "./chunk-LPI42WL6.mjs";
+
+// src/addons/bird-global-classifier/index.ts
+import * as fs from "fs";
+import * as path from "path";
+var SPECIES_LABEL = { id: "species", name: "Bird Species" };
+var SPECIES_LABELS = [SPECIES_LABEL];
+var BIRD_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+function loadLabels(modelsDir, modelId) {
+  const labelNames = [
+    `camstack-${modelId}-labels.json`,
+    `camstack-bird-species-525-labels.json`
+  ];
+  for (const name of labelNames) {
+    const labelPath = path.join(modelsDir, name);
+    if (fs.existsSync(labelPath)) {
+      const raw = fs.readFileSync(labelPath, "utf-8");
+      return JSON.parse(raw);
+    }
+  }
+  throw new Error(`BirdGlobalClassifierAddon: labels JSON not found in ${modelsDir}`);
+}
+function softmax(logits) {
+  const max = logits.reduce((a, b) => Math.max(a, b), -Infinity);
+  const exps = logits.map((v) => Math.exp(v - max));
+  const sum = exps.reduce((a, b) => a + b, 0);
+  return exps.map((v) => v / sum);
+}
+var BirdGlobalClassifierAddon = class {
+  id = "bird-global-classifier";
+  slot = "classifier";
+  inputClasses = ["animal"];
+  outputClasses = ["species:*"];
+  slotPriority = 0;
+  requiredSteps = [];
+  manifest = {
+    id: "bird-global-classifier",
+    name: "Bird Classifier (Global, 525 species)",
+    version: "0.1.0",
+    description: "EfficientNet \u2014 525 worldwide bird species (MIT license, ONNX only)",
+    packageName: "@camstack/addon-vision",
+    slot: "classifier",
+    inputClasses: ["animal"],
+    outputClasses: ["species:*"],
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      modelId: "bird-species-525",
+      runtime: "auto",
+      backend: "cpu",
+      minConfidence: 0.3
+    }
+  };
+  engine;
+  modelEntry;
+  labels = [];
+  minConfidence = 0.3;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    const modelId = cfg["modelId"] ?? "bird-species-525";
+    const runtime = cfg["runtime"] ?? "auto";
+    const backend = cfg["backend"] ?? "cpu";
+    this.minConfidence = cfg["minConfidence"] ?? 0.3;
+    const entry = BIRD_SPECIES_MODELS.find((m) => m.id === modelId);
+    if (!entry) {
+      throw new Error(`BirdGlobalClassifierAddon: unknown modelId "${modelId}"`);
+    }
+    this.modelEntry = entry;
+    this.labels = loadLabels(ctx.locationPaths.models, modelId);
+    const resolved = await resolveEngine({
+      runtime,
+      backend,
+      modelEntry: entry,
+      modelsDir: ctx.locationPaths.models
+    });
+    this.engine = resolved.engine;
+  }
+  async classify(input) {
+    const start = Date.now();
+    const { width: inputW, height: inputH } = this.modelEntry.inputSize;
+    const animalCrop = await cropRegion(input.frame.data, input.roi);
+    const normalized = await resizeAndNormalize(animalCrop, inputW, inputH, "imagenet", "nchw");
+    const rawOutput = await this.engine.run(normalized, [1, 3, inputH, inputW]);
+    const probs = softmax(rawOutput);
+    let maxIdx = 0;
+    let maxScore = probs[0] ?? 0;
+    for (let i = 1; i < probs.length; i++) {
+      const score = probs[i] ?? 0;
+      if (score > maxScore) {
+        maxScore = score;
+        maxIdx = i;
+      }
+    }
+    if (maxScore < this.minConfidence) {
+      return {
+        classifications: [],
+        inferenceMs: Date.now() - start,
+        modelId: this.modelEntry.id
+      };
+    }
+    const label = this.labels[maxIdx] ?? `species_${maxIdx}`;
+    return {
+      classifications: [
+        {
+          class: label,
+          score: maxScore
+        }
+      ],
+      inferenceMs: Date.now() - start,
+      modelId: this.modelEntry.id
+    };
+  }
+  async shutdown() {
+    await this.engine?.dispose();
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "model",
+          title: "Model",
+          columns: 1,
+          fields: [
+            {
+              key: "modelId",
+              label: "Model",
+              type: "model-selector",
+              catalog: [...BIRD_SPECIES_MODELS],
+              allowCustom: false,
+              allowConversion: false,
+              acceptFormats: ["onnx", "coreml", "openvino"],
+              requiredMetadata: ["inputSize", "labels"],
+              outputFormatHint: "classification"
+            }
+          ]
+        },
+        {
+          id: "thresholds",
+          title: "Classification Settings",
+          columns: 1,
+          fields: [
+            {
+              key: "minConfidence",
+              label: "Minimum Confidence",
+              type: "slider",
+              min: 0.05,
+              max: 1,
+              step: 0.05,
+              default: 0.3
+            }
+          ]
+        },
+        {
+          id: "runtime",
+          title: "Runtime",
+          columns: 2,
+          fields: [
+            {
+              key: "runtime",
+              label: "Runtime",
+              type: "select",
+              options: [
+                { value: "auto", label: "Auto (recommended)" },
+                { value: "onnx", label: "ONNX Runtime" },
+                { value: "coreml", label: "CoreML (Apple)" }
+              ]
+            },
+            {
+              key: "backend",
+              label: "Backend",
+              type: "select",
+              dependsOn: { runtime: "onnx" },
+              options: [
+                { value: "cpu", label: "CPU" },
+                { value: "coreml", label: "CoreML" },
+                { value: "cuda", label: "CUDA (NVIDIA)" }
+              ]
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return BIRD_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [...BIRD_SPECIES_MODELS];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return SPECIES_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: this.engine?.runtime ?? "onnx",
+      device: this.engine?.device ?? "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+export {
+  BirdGlobalClassifierAddon
+};
+//# sourceMappingURL=chunk-Q3SQOYG6.mjs.map

package/dist/chunk-Q3SQOYG6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/addons/bird-global-classifier/index.ts"],"sourcesContent":["import type {\n  IClassifierProvider,\n  IDetectionAddon,\n  AddonManifest,\n  AddonContext,\n  CropInput,\n  ClassifierOutput,\n  ConfigUISchema,\n  ClassMapDefinition,\n  ProbeResult,\n  ModelCatalogEntry,\n  DetectionModel,\n  LabelDefinition,\n  IInferenceEngine,\n} from '@camstack/types'\nimport { BIRD_SPECIES_MODELS } from '../../catalogs/animal-classification-models.js'\nimport { cropRegion, resizeAndNormalize } from '../../shared/image-utils.js'\nimport { resolveEngine } from '../../shared/engine-resolver.js'\n\nimport * as fs from 'node:fs'\nimport * as path from 'node:path'\n\nconst SPECIES_LABEL: LabelDefinition = { id: 'species', name: 'Bird Species' }\nconst SPECIES_LABELS: readonly LabelDefinition[] = [SPECIES_LABEL]\nconst BIRD_CLASS_MAP: ClassMapDefinition = { mapping: {}, preserveOriginal: true }\n\n/** Load bird species labels from JSON file in modelsDir */\nfunction loadLabels(modelsDir: string, modelId: string): readonly string[] {\n  const labelNames = [\n    `camstack-${modelId}-labels.json`,\n    `camstack-bird-species-525-labels.json`,\n  ]\n  for (const name of labelNames) {\n    const labelPath = path.join(modelsDir, name)\n    if (fs.existsSync(labelPath)) {\n      const raw = fs.readFileSync(labelPath, 'utf-8')\n      return JSON.parse(raw) as string[]\n    }\n  }\n  throw new Error(`BirdGlobalClassifierAddon: labels JSON not found in ${modelsDir}`)\n}\n\nfunction softmax(logits: Float32Array): Float32Array {\n  const max = logits.reduce((a, b) => Math.max(a, b), -Infinity)\n  const exps = logits.map((v) => Math.exp(v - max))\n  const sum = exps.reduce((a, b) => a + b, 0)\n  return exps.map((v) => v / sum) as unknown as Float32Array\n}\n\nexport default class BirdGlobalClassifierAddon implements IClassifierProvider, IDetectionAddon {\n  readonly id = 'bird-global-classifier'\n  readonly slot = 'classifier' as const\n  readonly inputClasses = ['animal'] as const\n  readonly outputClasses = ['species:*'] as const\n  readonly slotPriority = 0\n  readonly requiredSteps = [] as const\n  readonly manifest: AddonManifest = {\n    id: 'bird-global-classifier',\n    name: 'Bird Classifier (Global, 525 species)',\n    version: '0.1.0',\n    description: 'EfficientNet — 525 worldwide bird species (MIT license, ONNX only)',\n    packageName: '@camstack/addon-vision',\n    slot: 'classifier',\n    inputClasses: ['animal'],\n    outputClasses: ['species:*'],\n    supportsCustomModels: false,\n    mayRequirePython: false,\n    defaultConfig: {\n      modelId: 'bird-species-525',\n      runtime: 'auto',\n      backend: 'cpu',\n      minConfidence: 0.3,\n    },\n  }\n\n  private engine!: IInferenceEngine\n  private modelEntry!: ModelCatalogEntry\n  private labels: readonly string[] = []\n  private minConfidence = 0.3\n\n  async initialize(ctx: AddonContext): Promise<void> {\n    const cfg = ctx.addonConfig\n    const modelId = (cfg['modelId'] as string | undefined) ?? 'bird-species-525'\n    const runtime = (cfg['runtime'] as string | undefined) ?? 'auto'\n    const backend = (cfg['backend'] as string | undefined) ?? 'cpu'\n    this.minConfidence = (cfg['minConfidence'] as number | undefined) ?? 0.3\n\n    const entry = BIRD_SPECIES_MODELS.find((m) => m.id === modelId)\n    if (!entry) {\n      throw new Error(`BirdGlobalClassifierAddon: unknown modelId \"${modelId}\"`)\n    }\n    this.modelEntry = entry\n\n    // Load labels from JSON file\n    this.labels = loadLabels(ctx.locationPaths.models, modelId)\n\n    const resolved = await resolveEngine({\n      runtime: runtime as 'auto',\n      backend,\n      modelEntry: entry,\n      modelsDir: ctx.locationPaths.models,\n    })\n    this.engine = resolved.engine\n  }\n\n  async classify(input: CropInput): Promise<ClassifierOutput> {\n    const start = Date.now()\n    const { width: inputW, height: inputH } = this.modelEntry.inputSize\n\n    // Crop the animal region\n    const animalCrop = await cropRegion(input.frame.data, input.roi)\n\n    // Resize to 224x224, ImageNet normalization, NCHW\n    const normalized = await resizeAndNormalize(animalCrop, inputW, inputH, 'imagenet', 'nchw')\n\n    // Run inference — output shape: [1, 525]\n    const rawOutput = await this.engine.run(normalized, [1, 3, inputH, inputW])\n\n    // Softmax to get probabilities\n    const probs = softmax(rawOutput)\n\n    // Find argmax\n    let maxIdx = 0\n    let maxScore = probs[0] ?? 0\n    for (let i = 1; i < probs.length; i++) {\n      const score = probs[i] ?? 0\n      if (score > maxScore) {\n        maxScore = score\n        maxIdx = i\n      }\n    }\n\n    if (maxScore < this.minConfidence) {\n      return {\n        classifications: [],\n        inferenceMs: Date.now() - start,\n        modelId: this.modelEntry.id,\n      }\n    }\n\n    const label = this.labels[maxIdx] ?? `species_${maxIdx}`\n\n    return {\n      classifications: [\n        {\n          class: label,\n          score: maxScore,\n        },\n      ],\n      inferenceMs: Date.now() - start,\n      modelId: this.modelEntry.id,\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    await this.engine?.dispose()\n  }\n\n  getConfigSchema(): ConfigUISchema {\n    return {\n      sections: [\n        {\n          id: 'model',\n          title: 'Model',\n          columns: 1,\n          fields: [\n            {\n              key: 'modelId',\n              label: 'Model',\n              type: 'model-selector',\n              catalog: [...BIRD_SPECIES_MODELS],\n              allowCustom: false,\n              allowConversion: false,\n              acceptFormats: ['onnx', 'coreml', 'openvino'],\n              requiredMetadata: ['inputSize', 'labels'],\n              outputFormatHint: 'classification',\n            },\n          ],\n        },\n        {\n          id: 'thresholds',\n          title: 'Classification Settings',\n          columns: 1,\n          fields: [\n            {\n              key: 'minConfidence',\n              label: 'Minimum Confidence',\n              type: 'slider',\n              min: 0.05,\n              max: 1.0,\n              step: 0.05,\n              default: 0.3,\n            },\n          ],\n        },\n        {\n          id: 'runtime',\n          title: 'Runtime',\n          columns: 2,\n          fields: [\n            {\n              key: 'runtime',\n              label: 'Runtime',\n              type: 'select',\n              options: [\n                { value: 'auto', label: 'Auto (recommended)' },\n                { value: 'onnx', label: 'ONNX Runtime' },\n                { value: 'coreml', label: 'CoreML (Apple)' },\n              ],\n            },\n            {\n              key: 'backend',\n              label: 'Backend',\n              type: 'select',\n              dependsOn: { runtime: 'onnx' },\n              options: [\n                { value: 'cpu', label: 'CPU' },\n                { value: 'coreml', label: 'CoreML' },\n                { value: 'cuda', label: 'CUDA (NVIDIA)' },\n              ],\n            },\n          ],\n        },\n      ],\n    }\n  }\n\n  getClassMap(): ClassMapDefinition {\n    return BIRD_CLASS_MAP\n  }\n\n  getModelCatalog(): ModelCatalogEntry[] {\n    return [...BIRD_SPECIES_MODELS]\n  }\n\n  getAvailableModels(): DetectionModel[] {\n    return []\n  }\n\n  getActiveLabels(): readonly LabelDefinition[] {\n    return SPECIES_LABELS\n  }\n\n  async probe(): Promise<ProbeResult> {\n    return {\n      available: true,\n      runtime: this.engine?.runtime ?? 'onnx',\n      device: this.engine?.device ?? 'cpu',\n      capabilities: ['fp32'],\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-QIMDG34B.mjs

@@ -0,0 +1,229 @@
+import {
+  jpegToRgb,
+  rgbToGrayscale
+} from "./chunk-6OR5TE7A.mjs";
+
+// src/addons/motion-detection/frame-diff.ts
+function detectMotion(current, previous, width, height, threshold, minArea) {
+  const numPixels = width * height;
+  const mask = new Uint8Array(numPixels);
+  for (let i = 0; i < numPixels; i++) {
+    mask[i] = Math.abs((current[i] ?? 0) - (previous[i] ?? 0)) > threshold ? 1 : 0;
+  }
+  const labels = new Int32Array(numPixels).fill(0);
+  const parent = new Int32Array(numPixels + 1).fill(0);
+  let nextLabel = 1;
+  function findRoot(x) {
+    while (parent[x] !== x) {
+      parent[x] = parent[parent[x]];
+      x = parent[x];
+    }
+    return x;
+  }
+  function union(a, b) {
+    const ra = findRoot(a);
+    const rb = findRoot(b);
+    if (ra !== rb) parent[rb] = ra;
+    return ra;
+  }
+  for (let i = 0; i <= numPixels; i++) {
+    parent[i] = i;
+  }
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const idx = y * width + x;
+      if (!mask[idx]) continue;
+      const above = y > 0 ? labels[(y - 1) * width + x] ?? 0 : 0;
+      const left = x > 0 ? labels[y * width + (x - 1)] ?? 0 : 0;
+      if (above === 0 && left === 0) {
+        labels[idx] = nextLabel;
+        parent[nextLabel] = nextLabel;
+        nextLabel++;
+      } else if (above !== 0 && left === 0) {
+        labels[idx] = above;
+      } else if (above === 0 && left !== 0) {
+        labels[idx] = left;
+      } else {
+        labels[idx] = union(above, left);
+      }
+    }
+  }
+  for (let i = 0; i < numPixels; i++) {
+    if (labels[i]) {
+      labels[i] = findRoot(labels[i]);
+    }
+  }
+  const bboxMap = /* @__PURE__ */ new Map();
+  for (let y = 0; y < height; y++) {
+    for (let x = 0; x < width; x++) {
+      const idx = y * width + x;
+      const label = labels[idx];
+      if (!label) continue;
+      const diff = Math.abs((current[idx] ?? 0) - (previous[idx] ?? 0));
+      const existing = bboxMap.get(label);
+      if (existing) {
+        existing.minX = Math.min(existing.minX, x);
+        existing.minY = Math.min(existing.minY, y);
+        existing.maxX = Math.max(existing.maxX, x);
+        existing.maxY = Math.max(existing.maxY, y);
+        existing.count++;
+        existing.intensitySum += diff;
+      } else {
+        bboxMap.set(label, {
+          minX: x,
+          minY: y,
+          maxX: x,
+          maxY: y,
+          count: 1,
+          intensitySum: diff
+        });
+      }
+    }
+  }
+  const regions = [];
+  for (const [, info] of bboxMap) {
+    if (info.count < minArea) continue;
+    regions.push({
+      bbox: {
+        x: info.minX,
+        y: info.minY,
+        w: info.maxX - info.minX + 1,
+        h: info.maxY - info.minY + 1
+      },
+      pixelCount: info.count,
+      intensity: info.intensitySum / info.count
+    });
+  }
+  return regions;
+}
+
+// src/addons/motion-detection/index.ts
+var MOTION_LABEL = { id: "motion", name: "Motion" };
+var MOTION_LABELS = [MOTION_LABEL];
+var EMPTY_CLASS_MAP = { mapping: {}, preserveOriginal: true };
+var MotionDetectionAddon = class {
+  id = "motion-detection";
+  slot = "detector";
+  inputClasses = null;
+  outputClasses = ["motion"];
+  slotPriority = 10;
+  // runs first — feeds other detectors
+  manifest = {
+    id: "motion-detection",
+    name: "Motion Detection",
+    version: "0.1.0",
+    description: "Frame-differencing motion detector \u2014 no inference engine required",
+    packageName: "@camstack/addon-vision",
+    slot: "detector",
+    inputClasses: void 0,
+    outputClasses: ["motion"],
+    supportsCustomModels: false,
+    mayRequirePython: false,
+    defaultConfig: {
+      threshold: 25,
+      minArea: 500
+    }
+  };
+  previousGray = null;
+  previousWidth = 0;
+  previousHeight = 0;
+  threshold = 25;
+  minArea = 500;
+  async initialize(ctx) {
+    const cfg = ctx.addonConfig;
+    this.threshold = cfg["threshold"] ?? 25;
+    this.minArea = cfg["minArea"] ?? 500;
+  }
+  async detect(frame) {
+    const start = Date.now();
+    const { data, width, height } = await jpegToRgb(frame.data);
+    const currentGray = rgbToGrayscale(data, width, height);
+    if (!this.previousGray || this.previousWidth !== width || this.previousHeight !== height) {
+      this.previousGray = currentGray;
+      this.previousWidth = width;
+      this.previousHeight = height;
+      return { detections: [], inferenceMs: Date.now() - start, modelId: "frame-diff" };
+    }
+    const regions = detectMotion(
+      currentGray,
+      this.previousGray,
+      width,
+      height,
+      this.threshold,
+      this.minArea
+    );
+    this.previousGray = currentGray;
+    const detections = regions.map((r) => ({
+      class: "motion",
+      originalClass: "motion",
+      score: Math.min(1, r.intensity / 255),
+      bbox: r.bbox
+    }));
+    return {
+      detections,
+      inferenceMs: Date.now() - start,
+      modelId: "frame-diff"
+    };
+  }
+  async shutdown() {
+    this.previousGray = null;
+  }
+  getConfigSchema() {
+    return {
+      sections: [
+        {
+          id: "motion",
+          title: "Motion Detection",
+          columns: 2,
+          fields: [
+            {
+              key: "threshold",
+              label: "Pixel Difference Threshold",
+              description: "Minimum per-pixel intensity change to count as motion (0-255)",
+              type: "slider",
+              min: 5,
+              max: 100,
+              step: 5,
+              default: 25
+            },
+            {
+              key: "minArea",
+              label: "Minimum Region Area (px)",
+              description: "Minimum number of changed pixels to report a motion region",
+              type: "number",
+              min: 50,
+              max: 1e4
+            }
+          ]
+        }
+      ]
+    };
+  }
+  getClassMap() {
+    return EMPTY_CLASS_MAP;
+  }
+  getModelCatalog() {
+    return [];
+  }
+  getAvailableModels() {
+    return [];
+  }
+  getActiveLabels() {
+    return MOTION_LABELS;
+  }
+  async probe() {
+    return {
+      available: true,
+      runtime: "onnx",
+      // no inference; satisfies the type (any runtime works)
+      device: "cpu",
+      capabilities: ["fp32"]
+    };
+  }
+};
+
+export {
+  detectMotion,
+  MotionDetectionAddon
+};
+//# sourceMappingURL=chunk-QIMDG34B.mjs.map

package/dist/chunk-QIMDG34B.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/addons/motion-detection/frame-diff.ts","../src/addons/motion-detection/index.ts"],"sourcesContent":["import type { BoundingBox } from '@camstack/types'\n\nexport interface MotionRegion {\n  readonly bbox: BoundingBox\n  readonly pixelCount: number\n  readonly intensity: number\n}\n\n/**\n * Detect motion by frame differencing.\n *\n * @param current   - Grayscale pixel array for the current frame (Uint8Array, length = width * height)\n * @param previous  - Grayscale pixel array for the previous frame\n * @param width     - Frame width in pixels\n * @param height    - Frame height in pixels\n * @param threshold - Pixel diff threshold 0-255; differences below this are ignored\n * @param minArea   - Minimum number of changed pixels for a region to be reported\n */\nexport function detectMotion(\n  current: Uint8Array,\n  previous: Uint8Array,\n  width: number,\n  height: number,\n  threshold: number,\n  minArea: number,\n): MotionRegion[] {\n  const numPixels = width * height\n\n  // Step 1: Compute binary mask — 1 where abs(current - previous) > threshold\n  const mask = new Uint8Array(numPixels)\n  for (let i = 0; i < numPixels; i++) {\n    mask[i] = Math.abs((current[i] ?? 0) - (previous[i] ?? 0)) > threshold ? 1 : 0\n  }\n\n  // Step 2: Two-pass connected component labeling\n  const labels = new Int32Array(numPixels).fill(0)\n  const parent = new Int32Array(numPixels + 1).fill(0)\n  let nextLabel = 1\n\n  // Union-Find helpers\n  function findRoot(x: number): number {\n    while (parent[x] !== x) {\n      parent[x] = parent[parent[x]!]! // path compression\n      x = parent[x]!\n    }\n    return x\n  }\n\n  function union(a: number, b: number): number {\n    const ra = findRoot(a)\n    const rb = findRoot(b)\n    if (ra !== rb) parent[rb] = ra\n    return ra\n  }\n\n  // Initialize parent array as identity\n  for (let i = 0; i <= numPixels; i++) {\n    parent[i] = i\n  }\n\n  // First pass: assign provisional labels\n  for (let y = 0; y < height; y++) {\n    for (let x = 0; x < width; x++) {\n      const idx = y * width + x\n      if (!mask[idx]) continue\n\n      const above = y > 0 ? labels[(y - 1) * width + x] ?? 0 : 0\n      const left = x > 0 ? labels[y * width + (x - 1)] ?? 0 : 0\n\n      if (above === 0 && left === 0) {\n        labels[idx] = nextLabel\n        parent[nextLabel] = nextLabel\n        nextLabel++\n      } else if (above !== 0 && left === 0) {\n        labels[idx] = above\n      } else if (above === 0 && left !== 0) {\n        labels[idx] = left\n      } else {\n        // Both neighbors — merge\n        labels[idx] = union(above, left)\n      }\n    }\n  }\n\n  // Second pass: resolve all labels to roots\n  for (let i = 0; i < numPixels; i++) {\n    if (labels[i]) {\n      labels[i] = findRoot(labels[i]!)\n    }\n  }\n\n  // Step 3: Collect bounding boxes and pixel counts per root label\n  const bboxMap = new Map<\n    number,\n    { minX: number; minY: number; maxX: number; maxY: number; count: number; intensitySum: number }\n  >()\n\n  for (let y = 0; y < height; y++) {\n    for (let x = 0; x < width; x++) {\n      const idx = y * width + x\n      const label = labels[idx]\n      if (!label) continue\n\n      const diff = Math.abs((current[idx] ?? 0) - (previous[idx] ?? 0))\n      const existing = bboxMap.get(label)\n      if (existing) {\n        existing.minX = Math.min(existing.minX, x)\n        existing.minY = Math.min(existing.minY, y)\n        existing.maxX = Math.max(existing.maxX, x)\n        existing.maxY = Math.max(existing.maxY, y)\n        existing.count++\n        existing.intensitySum += diff\n      } else {\n        bboxMap.set(label, {\n          minX: x,\n          minY: y,\n          maxX: x,\n          maxY: y,\n          count: 1,\n          intensitySum: diff,\n        })\n      }\n    }\n  }\n\n  // Step 4: Filter by minimum area and build result\n  const regions: MotionRegion[] = []\n  for (const [, info] of bboxMap) {\n    if (info.count < minArea) continue\n    regions.push({\n      bbox: {\n        x: info.minX,\n        y: info.minY,\n        w: info.maxX - info.minX + 1,\n        h: info.maxY - info.minY + 1,\n      },\n      pixelCount: info.count,\n      intensity: info.intensitySum / info.count,\n    })\n  }\n\n  return regions\n}\n","import type {\n  IDetectorProvider,\n  IDetectionAddon,\n  AddonManifest,\n  AddonContext,\n  FrameInput,\n  DetectorOutput,\n  ConfigUISchema,\n  ClassMapDefinition,\n  ProbeResult,\n  ModelCatalogEntry,\n  DetectionModel,\n  LabelDefinition,\n  SpatialDetection,\n} from '@camstack/types'\nimport { jpegToRgb, rgbToGrayscale } from '../../shared/image-utils.js'\nimport { detectMotion } from './frame-diff.js'\n\nconst MOTION_LABEL: LabelDefinition = { id: 'motion', name: 'Motion' }\nconst MOTION_LABELS: readonly LabelDefinition[] = [MOTION_LABEL]\nconst EMPTY_CLASS_MAP: ClassMapDefinition = { mapping: {}, preserveOriginal: true }\n\nexport default class MotionDetectionAddon implements IDetectorProvider, IDetectionAddon {\n  readonly id = 'motion-detection'\n  readonly slot = 'detector' as const\n  readonly inputClasses: readonly string[] | null = null\n  readonly outputClasses = ['motion'] as const\n  readonly slotPriority = 10 // runs first — feeds other detectors\n  readonly manifest: AddonManifest = {\n    id: 'motion-detection',\n    name: 'Motion Detection',\n    version: '0.1.0',\n    description: 'Frame-differencing motion detector — no inference engine required',\n    packageName: '@camstack/addon-vision',\n    slot: 'detector',\n    inputClasses: undefined,\n    outputClasses: ['motion'],\n    supportsCustomModels: false,\n    mayRequirePython: false,\n    defaultConfig: {\n      threshold: 25,\n      minArea: 500,\n    },\n  }\n\n  private previousGray: Uint8Array | null = null\n  private previousWidth = 0\n  private previousHeight = 0\n  private threshold = 25\n  private minArea = 500\n\n  async initialize(ctx: AddonContext): Promise<void> {\n    const cfg = ctx.addonConfig\n    this.threshold = (cfg['threshold'] as number | undefined) ?? 25\n    this.minArea = (cfg['minArea'] as number | undefined) ?? 500\n  }\n\n  async detect(frame: FrameInput): Promise<DetectorOutput> {\n    const start = Date.now()\n\n    const { data, width, height } = await jpegToRgb(frame.data)\n    const currentGray = rgbToGrayscale(data, width, height)\n\n    if (!this.previousGray || this.previousWidth !== width || this.previousHeight !== height) {\n      // Store first frame and return empty — no previous to diff against\n      this.previousGray = currentGray\n      this.previousWidth = width\n      this.previousHeight = height\n      return { detections: [], inferenceMs: Date.now() - start, modelId: 'frame-diff' }\n    }\n\n    const regions = detectMotion(\n      currentGray,\n      this.previousGray,\n      width,\n      height,\n      this.threshold,\n      this.minArea,\n    )\n\n    this.previousGray = currentGray\n\n    const detections: SpatialDetection[] = regions.map((r) => ({\n      class: 'motion',\n      originalClass: 'motion',\n      score: Math.min(1, r.intensity / 255),\n      bbox: r.bbox,\n    }))\n\n    return {\n      detections,\n      inferenceMs: Date.now() - start,\n      modelId: 'frame-diff',\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    this.previousGray = null\n  }\n\n  getConfigSchema(): ConfigUISchema {\n    return {\n      sections: [\n        {\n          id: 'motion',\n          title: 'Motion Detection',\n          columns: 2,\n          fields: [\n            {\n              key: 'threshold',\n              label: 'Pixel Difference Threshold',\n              description: 'Minimum per-pixel intensity change to count as motion (0-255)',\n              type: 'slider',\n              min: 5,\n              max: 100,\n              step: 5,\n              default: 25,\n            },\n            {\n              key: 'minArea',\n              label: 'Minimum Region Area (px)',\n              description: 'Minimum number of changed pixels to report a motion region',\n              type: 'number',\n              min: 50,\n              max: 10000,\n            },\n          ],\n        },\n      ],\n    }\n  }\n\n  getClassMap(): ClassMapDefinition {\n    return EMPTY_CLASS_MAP\n  }\n\n  getModelCatalog(): ModelCatalogEntry[] {\n    return []\n  }\n\n  getAvailableModels(): DetectionModel[] {\n    return []\n  }\n\n  getActiveLabels(): readonly LabelDefinition[] {\n    return MOTION_LABELS\n  }\n\n  async probe(): Promise<ProbeResult> {\n    return {\n      available: true,\n      runtime: 'onnx', // no inference; satisfies the type (any runtime works)\n      device: 'cpu',\n      capabilities: ['fp32'],\n    }\n  }\n}\n"],"mappings":"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","names":[]}