@camstack/addon-motion-wasm 0.1.1

package/dist/chunk-FXGWBT3O.mjs

@@ -0,0 +1,34 @@
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
+var __commonJS = (cb, mod) => function __require2() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+
+// ../../node_modules/tsup/assets/esm_shims.js
+import path from "path";
+import { fileURLToPath } from "url";
+var getFilename, getDirname, __dirname;
+var init_esm_shims = __esm({
+  "../../node_modules/tsup/assets/esm_shims.js"() {
+    "use strict";
+    getFilename = () => fileURLToPath(import.meta.url);
+    getDirname = () => path.dirname(getFilename());
+    __dirname = /* @__PURE__ */ getDirname();
+  }
+});
+
+export {
+  __require,
+  __commonJS,
+  __dirname,
+  init_esm_shims
+};
+//# sourceMappingURL=chunk-FXGWBT3O.mjs.map

package/dist/chunk-FXGWBT3O.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../node_modules/tsup/assets/esm_shims.js"],"sourcesContent":["// Shim globals in esm bundle\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst getFilename = () => fileURLToPath(import.meta.url)\nconst getDirname = () => path.dirname(getFilename())\n\nexport const __dirname = /* @__PURE__ */ getDirname()\nexport const __filename = /* @__PURE__ */ getFilename()\n"],"mappings":";;;;;;;;;;;;;;;AACA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAF9B,IAIM,aACA,YAEO;AAPb;AAAA;AAAA;AAIA,IAAM,cAAc,MAAM,cAAc,YAAY,GAAG;AACvD,IAAM,aAAa,MAAM,KAAK,QAAQ,YAAY,CAAC;AAE5C,IAAM,YAA4B,2BAAW;AAAA;AAAA;","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,129 @@
+import { BaseAddon, IMotionDetectionProvider, ProviderRegistration, FrameInput, DetectorOutput, SpatialDetection, MotionAnalysisResult, ConfigUISchema, ConfigUISchemaWithValues } from '@camstack/types';
+
+declare class MotionWasmAddon extends BaseAddon implements IMotionDetectionProvider {
+    private detector;
+    private readonly cameras;
+    private readonly deviceConfigCache;
+    private static readonly DEVICE_CONFIG_TTL_MS;
+    /**
+     * Per-device {@link DeviceProxy} used for zone gating. Built lazily
+     * on first analyze() for a device; the proxy's reactive state
+     * handles (`state.zones`, `state.zoneRules`) keep their `.value`
+     * fresh via the kernel's runtime-state mirror, so the gate reads
+     * are sync and free of bus plumbing inside this addon.
+     */
+    private readonly proxies;
+    /** Unsubscribe pins kept so the slice handles stay subscribed for
+     *  the camera's lifetime — `.value` only flows through the cache
+     *  when at least one watcher is active. */
+    private readonly proxyUnsubs;
+    constructor();
+    protected onInitialize(): Promise<ProviderRegistration[]>;
+    private static readonly PIPELINE_STEP_KEY;
+    /**
+     * Pipeline step interface — called by PipelineRunner.
+     * Uses single-camera state (one instance per camera via AddonEngineManager).
+     */
+    process(input: FrameInput): Promise<DetectorOutput & {
+        rawDetections: ReadonlyArray<SpatialDetection>;
+    }>;
+    /**
+     * motion-detection cap: analyze a frame, return regions + stats.
+     * Per-device state keyed by the numeric deviceId (stringified internally
+     * so the pipeline-step sentinel shares the same Map).
+     */
+    analyze({ deviceId, frame }: {
+        deviceId: number;
+        frame: FrameInput;
+    }): Promise<MotionAnalysisResult>;
+    private analyzeInternal;
+    /**
+     * Resolve (and cache) a {@link DeviceProxy} for the given device.
+     * Pins the `state.zones` + `state.zoneRules` slice handles so the
+     * kernel runtime-state mirror keeps `.value` warm — subsequent
+     * analyze() calls read both slices synchronously without any bus
+     * plumbing or per-frame cap query. Returns null on first-call
+     * failure (logged) so motion analysis never blocks on zone
+     * resolution.
+     */
+    private ensureProxy;
+    /** Drop the proxy + slice subscriptions for a device. */
+    private releaseProxy;
+    /**
+     * Resolve the effective per-device config for a camera. Reads the raw
+     * device store and overlays it on top of the schema defaults via
+     * `hydrateSchema()`, then narrows to the typed `WasmMotionConfig` shape.
+     * Cached with a TTL to avoid hammering the settings store on every frame.
+     */
+    private getDeviceConfig;
+    removeCamera({ deviceId }: {
+        deviceId: number;
+    }): Promise<void>;
+    reset(): Promise<void>;
+    protected onShutdown(): Promise<void>;
+    protected deviceSettingsSchema(): ConfigUISchema;
+    getDeviceSettings(deviceId: number): Promise<ConfigUISchemaWithValues>;
+    updateDeviceSettings(deviceId: number, patch: Record<string, unknown>): Promise<void>;
+    getDeviceSettingsContribution(input: {
+        deviceId: number;
+    }): Promise<ConfigUISchemaWithValues | null>;
+    getDeviceLiveContribution(_input: {
+        deviceId: number;
+    }): Promise<ConfigUISchemaWithValues | null>;
+    applyDeviceSettingsPatch(input: {
+        deviceId: number;
+        patch: Record<string, unknown>;
+    }): Promise<{
+        success: true;
+    }>;
+    /**
+     * Best-effort camera-type check. Used by the settings/live contribution
+     * methods to short-circuit on non-camera devices (Lights, Switches,
+     * Sensors, Buttons). Returns `true` on lookup failure so a transient
+     * device-manager hiccup never silently hides legitimate camera
+     * sections.
+     */
+    private isCameraDevice;
+}
+
+interface WasmMotionConfig {
+    readonly threshold: number;
+    readonly blurRadius: number;
+    readonly dilateRadius: number;
+    readonly minArea: number;
+}
+interface WasmMotionRegion {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+    readonly pixels: number;
+}
+/** Result containing both all regions and those passing minArea filter. */
+interface WasmMotionResult {
+    /** All regions from CCL (unfiltered). */
+    readonly raw: ReadonlyArray<WasmMotionRegion>;
+    /** Regions passing the minArea threshold. */
+    readonly filtered: ReadonlyArray<WasmMotionRegion>;
+}
+declare class WasmMotionDetector {
+    private wasm;
+    private prevOffset;
+    private currOffset;
+    private regionOffset;
+    /** Load the WASM module. Call once before detect(). */
+    load(): Promise<void>;
+    /** Initialize for given frame dimensions. Call when resolution changes. */
+    init(w: number, h: number): void;
+    /**
+     * Detect motion between previous and current grayscale frames.
+     *
+     * @param prevGray - previous frame (Uint8Array, width×height)
+     * @param currGray - current frame (Uint8Array, width×height)
+     * @param config - detection parameters (optional, uses defaults)
+     * @returns raw (all CCL regions) + filtered (passing minArea) regions
+     */
+    detect(prevGray: Uint8Array | Buffer, currGray: Uint8Array | Buffer, config?: Partial<WasmMotionConfig>): WasmMotionResult;
+}
+
+export { MotionWasmAddon, type WasmMotionConfig, WasmMotionDetector, type WasmMotionRegion };

package/dist/index.d.ts

@@ -0,0 +1,129 @@
+import { BaseAddon, IMotionDetectionProvider, ProviderRegistration, FrameInput, DetectorOutput, SpatialDetection, MotionAnalysisResult, ConfigUISchema, ConfigUISchemaWithValues } from '@camstack/types';
+
+declare class MotionWasmAddon extends BaseAddon implements IMotionDetectionProvider {
+    private detector;
+    private readonly cameras;
+    private readonly deviceConfigCache;
+    private static readonly DEVICE_CONFIG_TTL_MS;
+    /**
+     * Per-device {@link DeviceProxy} used for zone gating. Built lazily
+     * on first analyze() for a device; the proxy's reactive state
+     * handles (`state.zones`, `state.zoneRules`) keep their `.value`
+     * fresh via the kernel's runtime-state mirror, so the gate reads
+     * are sync and free of bus plumbing inside this addon.
+     */
+    private readonly proxies;
+    /** Unsubscribe pins kept so the slice handles stay subscribed for
+     *  the camera's lifetime — `.value` only flows through the cache
+     *  when at least one watcher is active. */
+    private readonly proxyUnsubs;
+    constructor();
+    protected onInitialize(): Promise<ProviderRegistration[]>;
+    private static readonly PIPELINE_STEP_KEY;
+    /**
+     * Pipeline step interface — called by PipelineRunner.
+     * Uses single-camera state (one instance per camera via AddonEngineManager).
+     */
+    process(input: FrameInput): Promise<DetectorOutput & {
+        rawDetections: ReadonlyArray<SpatialDetection>;
+    }>;
+    /**
+     * motion-detection cap: analyze a frame, return regions + stats.
+     * Per-device state keyed by the numeric deviceId (stringified internally
+     * so the pipeline-step sentinel shares the same Map).
+     */
+    analyze({ deviceId, frame }: {
+        deviceId: number;
+        frame: FrameInput;
+    }): Promise<MotionAnalysisResult>;
+    private analyzeInternal;
+    /**
+     * Resolve (and cache) a {@link DeviceProxy} for the given device.
+     * Pins the `state.zones` + `state.zoneRules` slice handles so the
+     * kernel runtime-state mirror keeps `.value` warm — subsequent
+     * analyze() calls read both slices synchronously without any bus
+     * plumbing or per-frame cap query. Returns null on first-call
+     * failure (logged) so motion analysis never blocks on zone
+     * resolution.
+     */
+    private ensureProxy;
+    /** Drop the proxy + slice subscriptions for a device. */
+    private releaseProxy;
+    /**
+     * Resolve the effective per-device config for a camera. Reads the raw
+     * device store and overlays it on top of the schema defaults via
+     * `hydrateSchema()`, then narrows to the typed `WasmMotionConfig` shape.
+     * Cached with a TTL to avoid hammering the settings store on every frame.
+     */
+    private getDeviceConfig;
+    removeCamera({ deviceId }: {
+        deviceId: number;
+    }): Promise<void>;
+    reset(): Promise<void>;
+    protected onShutdown(): Promise<void>;
+    protected deviceSettingsSchema(): ConfigUISchema;
+    getDeviceSettings(deviceId: number): Promise<ConfigUISchemaWithValues>;
+    updateDeviceSettings(deviceId: number, patch: Record<string, unknown>): Promise<void>;
+    getDeviceSettingsContribution(input: {
+        deviceId: number;
+    }): Promise<ConfigUISchemaWithValues | null>;
+    getDeviceLiveContribution(_input: {
+        deviceId: number;
+    }): Promise<ConfigUISchemaWithValues | null>;
+    applyDeviceSettingsPatch(input: {
+        deviceId: number;
+        patch: Record<string, unknown>;
+    }): Promise<{
+        success: true;
+    }>;
+    /**
+     * Best-effort camera-type check. Used by the settings/live contribution
+     * methods to short-circuit on non-camera devices (Lights, Switches,
+     * Sensors, Buttons). Returns `true` on lookup failure so a transient
+     * device-manager hiccup never silently hides legitimate camera
+     * sections.
+     */
+    private isCameraDevice;
+}
+
+interface WasmMotionConfig {
+    readonly threshold: number;
+    readonly blurRadius: number;
+    readonly dilateRadius: number;
+    readonly minArea: number;
+}
+interface WasmMotionRegion {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+    readonly pixels: number;
+}
+/** Result containing both all regions and those passing minArea filter. */
+interface WasmMotionResult {
+    /** All regions from CCL (unfiltered). */
+    readonly raw: ReadonlyArray<WasmMotionRegion>;
+    /** Regions passing the minArea threshold. */
+    readonly filtered: ReadonlyArray<WasmMotionRegion>;
+}
+declare class WasmMotionDetector {
+    private wasm;
+    private prevOffset;
+    private currOffset;
+    private regionOffset;
+    /** Load the WASM module. Call once before detect(). */
+    load(): Promise<void>;
+    /** Initialize for given frame dimensions. Call when resolution changes. */
+    init(w: number, h: number): void;
+    /**
+     * Detect motion between previous and current grayscale frames.
+     *
+     * @param prevGray - previous frame (Uint8Array, width×height)
+     * @param currGray - current frame (Uint8Array, width×height)
+     * @param config - detection parameters (optional, uses defaults)
+     * @returns raw (all CCL regions) + filtered (passing minArea) regions
+     */
+    detect(prevGray: Uint8Array | Buffer, currGray: Uint8Array | Buffer, config?: Partial<WasmMotionConfig>): WasmMotionResult;
+}
+
+export { MotionWasmAddon, type WasmMotionConfig, WasmMotionDetector, type WasmMotionRegion };