npm - @camera.ui/rust-postprocessor - Versions diffs - 0.0.8 → 0.1.0 - Mend

@camera.ui/rust-postprocessor 0.0.8 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/.gitmodules CHANGED Viewed

@@ -1,3 +1,6 @@
 [submodule "externals/norfair-rs"]
 	path = externals/norfair-rs
 	url = https://github.com/seydx/norfair-rs
+[submodule "externals/trackforge"]
+	path = externals/trackforge
+	url = https://github.com/seydx/trackforge

package/index.d.ts CHANGED Viewed

@@ -1,60 +1,13 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
-/**
- * Multi-class IoU + Kalman tracker (norfair-rs, one sub-tracker per label).
- * Track ids are stable and globally unique; feed normalized coordinates.
- */
-export declare class ObjectTracker {
-  constructor(options?: ObjectTrackerOptions | undefined | null)
-  /**
-   * Process one frame's detections and return active tracks plus any
-   * crossing events. `timestampMs` is forwarded onto crossing events.
-   * `cameraMotion` (optional) stabilizes Kalman predictions across pans.
-   */
-  update(detections: Array<Detection>, timestampMs: number, frame?: Buffer | undefined | null, frameWidth?: number | undefined | null, frameHeight?: number | undefined | null, cameraMotion?: CameraMotion | undefined | null): UpdateResult
-  /**
-   * Replace the configured crossing lines (empty array disables them).
-   * `aspectRatio` is `width / height` so the line renders perpendicular to
-   * the drawn handle. Crossing memory is cleared on every call.
-   */
+export declare class CameraWorld {
+  constructor()
+  ingest(timestampMs: number, detections: Array<Detection>, cameraMotion?: CameraMotion | undefined | null): WorldIngestResult
   setLines(lines: Array<DetectionLine>, aspectRatio: number): void
-  /**
-   * Replace the configured detection zones (empty array disables filtering).
-   * Coordinates are in `[0, 100]` UI space; normalized and auto-closed
-   * internally. Applied at the start of every `update()`.
-   */
+  notifyCameraMove(): void
   setZones(zones: Array<DetectionZone>): void
-  /**
-   * Drop detections below this score at the start of every `update()`,
-   * before zone filtering or tracking. Default 0.0 (no threshold).
-   */
   setMinConfidence(minConfidence: number): void
-  /**
-   * How many frames a dead track stays available for ReID re-matching;
-   * the old id is preserved on merge. Pass 0 to disable.
-   */
-  setReidHitCounterMax(frames: number): void
-  /**
-   * Refresh the ReID counter for all dead tracks back to max. Call each
-   * frame while a cascade is active so dead tracks don't expire mid-window.
-   */
-  refreshReid(): void
-  /**
-   * Apply zones + confidence threshold without advancing tracker state,
-   * returning the surviving input indices. Used by the external-sensor-write
-   * path that needs zone filtering without running the full tracker.
-   */
   filterIndices(detections: Array<Detection>): Array<number>
-  /** Drop every active track; the next `update()` restarts ids from 1. */
-  reset(): void
-  /**
-   * Drop everything except the established tracks with the given ids and
-   * return the ids that actually survived. Lets the caller keep its
-   * known-stationary tracks (e.g. parked cars) across events so they can
-   * stay suppressed.
-   */
-  retainTracks(trackIds: Array<number>): Array<number>
-  get trackCount(): number
 }
 export interface BoundingBox {
@@ -64,13 +17,8 @@ export interface BoundingBox {
   height: number
 }
-/** IoU between two normalized `[x, y, width, height]` boxes. */
 export declare function boxIou(a: BoundingBox, b: BoundingBox): number
-/**
- * Camera ego-motion for one frame step in normalized coords; when supplied
- * to `update()`, Kalman predictions are transformed to survive pans.
- */
 export interface CameraMotion {
   x: number
   y: number
@@ -85,10 +33,6 @@ export interface Detection {
   label: string
 }
-/**
- * `points` are the two handle endpoints in `[0, 100]` UI coordinates;
- * empty `labels` means "any label".
- */
 export interface DetectionLine {
   name: string
   direction: LineDirection
@@ -96,11 +40,9 @@ export interface DetectionLine {
   points: Array<Array<number>>
 }
-/** `points` are polygon vertices in `[0, 100]` UI coordinates; auto-closed. */
 export interface DetectionZone {
   labels: Array<string>
   filter: ZoneFilterMode
-  /** Mapped to `type` on the JS side of the SDK. */
   matchType: ZoneMatchType
   isPrivacyMask: boolean
   points: Array<Array<number>>
@@ -125,65 +67,42 @@ export declare const enum LineDirection {
   BToA = 'b-to-a'
 }
-/**
- * Cluster nearby/overlapping same-label detections into union boxes. Boxes
- * join when their top-left corners are within `closeThreshold` on both axes
- * or their IoU exceeds `iouThreshold`; the cluster keeps the max confidence.
- */
 export declare function merge(detections: Array<Detection>, iouThreshold: number, closeThreshold: number): Array<Detection>
-/**
- * Greedy NMS, suppressing only against higher-confidence boxes of the same
- * `label`. Output sorted by confidence descending.
- */
 export declare function nms(detections: Array<Detection>, iouThreshold: number, maxDetections?: number | undefined | null): Array<Detection>
-/**
- * Like [`nms`] but returns the surviving input indices, so callers can keep
- * extra fields that the Detection round-trip would drop.
- */
 export declare function nmsIndices(detections: Array<Detection>, iouThreshold: number): Array<number>
-export interface ObjectTrackerOptions {
-  /** Default 0.3. */
-  iouThreshold?: number
-  /** Frames a track survives without a fresh detection. Default 15. */
-  hitCounterMax?: number
-  /** Frames a new track must be matched before getting a permanent id. Default 3. */
-  initializationDelay?: number
-  /** Frames a dead track stays available for ReID re-matching. Default: disabled. */
-  reidHitCounterMax?: number
+export interface WorldEvent {
   /**
-   * Cosine distance threshold for appearance ReID; only used when a frame
-   * buffer is passed to `update()`. Default 0.4.
+   * One of: objectEntered, objectLost, objectRecovered, objectSettled,
+   * objectWoke, objectDeparted, bestShotUpdated.
    */
-  reidEmbeddingThreshold?: number
+  eventType: string
+  object: WorldObject
+}
+export interface WorldIngestResult {
+  tracked: Array<WorldObject>
+  created: Array<number>
+  removed: Array<number>
+  events: Array<WorldEvent>
+  crossings: Array<LineCrossingEvent>
 }
-export interface TrackedDetection {
+export interface WorldObject {
+  trackId: number
+  label: string
   x: number
   y: number
   width: number
   height: number
   confidence: number
-  label: string
-  trackId: number
-  trackAge: number
-  /** True when the box is kept alive by Kalman extrapolation, not a fresh match. */
-  trackLost: boolean
-  /** `sqrt(vx² + vy²)` in normalized units per frame; 0 with only one sample. */
-  trackSpeed: number
-  trackVelocityX: number
-  trackVelocityY: number
-}
-export interface UpdateResult {
-  tracked: Array<TrackedDetection>
-  crossings: Array<LineCrossingEvent>
-  /** Track ids that got their permanent id this frame. */
-  created: Array<number>
-  /** Track ids the tracker dropped this frame (hit counter exhausted). */
-  removed: Array<number>
+  speed: number
+  velocityX: number
+  velocityY: number
+  /** One of: tentative, active, stationary, lost, departed. */
+  state: string
 }
 export declare const enum ZoneFilterMode {
@@ -192,8 +111,6 @@ export declare const enum ZoneFilterMode {
 }
 export declare const enum ZoneMatchType {
-  /** Any overlap with the polygon counts. */
   Intersect = 'intersect',
-  /** All four corners must be inside the polygon. */
   Contain = 'contain'
 }

package/index.js CHANGED Viewed

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-android-arm64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-android-arm-eabi')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-win32-x64-gnu')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-win32-x64-msvc')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-win32-ia32-msvc')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-win32-arm64-msvc')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@camera.ui/rust-postprocessor-darwin-universal')
       const bindingPackageVersion = require('@camera.ui/rust-postprocessor-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-darwin-x64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-darwin-arm64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-freebsd-x64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-freebsd-arm64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-x64-musl')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-x64-gnu')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-arm64-musl')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-arm64-gnu')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-arm-musleabihf')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-loong64-musl')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-loong64-gnu')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-riscv64-musl')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@camera.ui/rust-postprocessor-linux-riscv64-gnu')
           const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-linux-ppc64-gnu')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-linux-s390x-gnu')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-openharmony-arm64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-openharmony-x64')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@camera.ui/rust-postprocessor-openharmony-arm')
         const bindingPackageVersion = require('@camera.ui/rust-postprocessor-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.0.8' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.0.8 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.1.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -523,47 +523,163 @@ function requireNative() {
   }
 }
-nativeBinding = requireNative()
+function createLoadErrorChain(errors) {
+  return errors.reduce((previous, current) => {
+    let message
+    try {
+      message =
+        current && typeof current.message === 'string'
+          ? current.message
+          : String(current)
+    } catch {
+      message = 'Unknown error'
+    }
+    const error = new Error(message)
+    error.cause = previous
+    return error
+  }, null)
+}
 // NAPI_RS_FORCE_WASI is a tri-state flag:
 //   unset / any other value → native binding preferred, WASI is only a fallback
-//   'true'                   → force WASI fallback even if native loaded
-//   'error'                  → force WASI and throw if no WASI binding is found
+//   'true'                   → prefer WASI, but retain native as a lazy fallback
+//   'error'                  → require WASI without initializing a native fallback
 // Treating any non-empty string as truthy (the historical behavior) meant
 // NAPI_RS_FORCE_WASI=false, NAPI_RS_FORCE_WASI=0, etc. inadvertently triggered
 // the WASI path, causing ENOENT for packages shipped without a .wasi.cjs file.
+//
+// NAPI_RS_WASI_FLAVOR selects one exact generated flavor and implies strict
+// WASI loading. It never crosses into another flavor or falls back to native.
+const __napiWasiFlavors = ["wasm32-wasi"]
+const __napiWasiFlavor = process.env.NAPI_RS_WASI_FLAVOR
+const __napiWasiFlavorRequested =
+  typeof __napiWasiFlavor === 'string' && __napiWasiFlavor.length > 0
+if (
+  __napiWasiFlavorRequested &&
+  __napiWasiFlavors.indexOf(__napiWasiFlavor) === -1
+) {
+  throw new Error(
+    'Unsupported WASI flavor "' +
+      __napiWasiFlavor +
+      '". Available flavors: ' +
+      __napiWasiFlavors.join(', '),
+  )
+}
+const forceWasiError = process.env.NAPI_RS_FORCE_WASI === 'error'
 const forceWasi =
-  process.env.NAPI_RS_FORCE_WASI === 'true' || process.env.NAPI_RS_FORCE_WASI === 'error'
+  process.env.NAPI_RS_FORCE_WASI === 'true' ||
+  forceWasiError ||
+  __napiWasiFlavorRequested
+if (!forceWasi) {
+  nativeBinding = requireNative()
+}
 if (!nativeBinding || forceWasi) {
   let wasiBinding = null
-  let wasiBindingError = null
-  try {
-    wasiBinding = require('./rust-postprocessor.wasi.cjs')
-    nativeBinding = wasiBinding
-  } catch (err) {
-    if (forceWasi) {
-      wasiBindingError = err
+  let wasiBindingLoaded = false
+  const wasiBindingErrors = []
+  const __napiWasiResolveCandidate = (specifier, isPackage, localArtifacts) => {
+    try {
+      require.resolve(specifier)
+    } catch (resolveError) {
+      if (!resolveError || resolveError.code !== 'MODULE_NOT_FOUND') {
+        throw resolveError
+      }
+      if (isPackage) {
+        try {
+          require.resolve(specifier + '/package.json')
+        } catch (packageError) {
+          if (packageError && packageError.code === 'MODULE_NOT_FOUND') {
+            return resolveError
+          }
+          // An exports restriction proves the package exists even when its
+          // package.json is not public. Preserve the root resolution failure.
+          throw resolveError
+        }
+        // The package exists but its main/export target is broken.
+        throw resolveError
+      }
+      return resolveError
+    }
+    if (localArtifacts) {
+      let artifactError = null
+      for (let i = 0; i < localArtifacts.length; i++) {
+        try {
+          require.resolve(localArtifacts[i])
+          return null
+        } catch (resolveError) {
+          if (!resolveError || resolveError.code !== 'MODULE_NOT_FOUND') {
+            throw resolveError
+          }
+          artifactError = resolveError
+        }
+      }
+      return artifactError
     }
+    return null
   }
-  if (!nativeBinding || forceWasi) {
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === "wasm32-wasi")) {
+    let candidateError = null
+    let candidateFailed = false
     try {
-      wasiBinding = require('@camera.ui/rust-postprocessor-wasm32-wasi')
-      nativeBinding = wasiBinding
+      candidateError = __napiWasiResolveCandidate('./rust-postprocessor.wasi.cjs', false, ["./rust-postprocessor.wasm32-wasi.debug.wasm","./rust-postprocessor.wasm32-wasi.wasm"])
+      candidateFailed = candidateError !== null
+      if (!candidateFailed) {
+        wasiBinding = require('./rust-postprocessor.wasi.cjs')
+        nativeBinding = wasiBinding
+        wasiBindingLoaded = true
+      }
     } catch (err) {
-      if (forceWasi) {
-        if (!wasiBindingError) {
-          wasiBindingError = err
-        } else {
-          wasiBindingError.cause = err
+      candidateError = err
+      candidateFailed = true
+    }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError)
+      loadErrors.push(candidateError)
+    }
+  }
+  if (!wasiBindingLoaded && (!__napiWasiFlavorRequested || __napiWasiFlavor === "wasm32-wasi")) {
+    let candidateError = null
+    let candidateFailed = false
+    try {
+      candidateError = __napiWasiResolveCandidate('@camera.ui/rust-postprocessor-wasm32-wasi', true, undefined)
+      candidateFailed = candidateError !== null
+      if (!candidateFailed) {
+        if (process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          const bindingPackageVersion = require('@camera.ui/rust-postprocessor-wasm32-wasi/package.json').version
+          if (bindingPackageVersion !== '0.1.0') {
+            throw new Error(`WASI binding package version mismatch, expected 0.1.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          }
         }
-        loadErrors.push(err)
+        wasiBinding = require('@camera.ui/rust-postprocessor-wasm32-wasi')
+        nativeBinding = wasiBinding
+        wasiBindingLoaded = true
       }
+    } catch (err) {
+      candidateError = err
+      candidateFailed = true
+    }
+    if (candidateFailed) {
+      wasiBindingErrors.push(candidateError)
+      loadErrors.push(candidateError)
     }
   }
-  if (process.env.NAPI_RS_FORCE_WASI === 'error' && !wasiBinding) {
-    const error = new Error('WASI binding not found and NAPI_RS_FORCE_WASI is set to error')
-    error.cause = wasiBindingError
+  if (
+    !wasiBindingLoaded &&
+    forceWasi &&
+    !forceWasiError &&
+    !__napiWasiFlavorRequested
+  ) {
+    nativeBinding = requireNative()
+  }
+  if ((forceWasiError || __napiWasiFlavorRequested) && !wasiBindingLoaded) {
+    const error = new Error(
+      __napiWasiFlavorRequested
+        ? 'WASI binding for flavor "' + __napiWasiFlavor + '" not found'
+        : 'WASI binding not found and NAPI_RS_FORCE_WASI is set to error',
+    )
+    error.cause = createLoadErrorChain(wasiBindingErrors)
     throw error
   }
 }
@@ -577,17 +693,14 @@ if (!nativeBinding) {
     )
     // assign instead of the `new Error(message, { cause })` options form,
     // which Node < 16.9 silently ignores
-    error.cause = loadErrors.reduce((err, cur) => {
-      cur.cause = err
-      return cur
-    })
+    error.cause = createLoadErrorChain(loadErrors)
     throw error
   }
   throw new Error(`Failed to load native binding`)
 }
 module.exports = nativeBinding
-module.exports.ObjectTracker = nativeBinding.ObjectTracker
+module.exports.CameraWorld = nativeBinding.CameraWorld
 module.exports.boxIou = nativeBinding.boxIou
 module.exports.LineDirection = nativeBinding.LineDirection
 module.exports.merge = nativeBinding.merge

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@camera.ui/rust-postprocessor",
-  "version": "0.0.8",
+  "version": "0.1.0",
   "description": "Native Rust detection post-processing (NMS, IoU, merge, object tracking, line crossing & zone filtering) for the camera.ui ecosystem",
   "author": "seydx (https://github.com/seydx)",
   "main": "index.js",
@@ -39,20 +39,20 @@
     "version": "napi version"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^3.7.3",
+    "@napi-rs/cli": "^3.8.2",
     "@stylistic/eslint-plugin": "^5.10.0",
-    "@typescript-eslint/parser": "^8.64.0",
-    "concurrently": "^10.0.3",
+    "@typescript-eslint/parser": "^8.65.0",
+    "concurrently": "^10.0.4",
     "cross-env": "^10.1.0",
     "eslint": "9.39.2",
-    "globals": "^17.7.0",
-    "prettier": "^3.9.5",
+    "globals": "^17.9.0",
+    "prettier": "^3.9.6",
     "rimraf": "^6.1.3",
     "set-interval-async": "^3.0.3",
     "sharp": "^0.35.3",
     "typescript": "5.9.3",
-    "typescript-eslint": "^8.64.0",
-    "updates": "^17.18.2"
+    "typescript-eslint": "^8.65.0",
+    "updates": "^17.20.2"
   },
   "bugs": {
     "url": "https://github.com/cameraui/rust-postprocessor/issues"
@@ -72,15 +72,15 @@
     "node": ">= 10"
   },
   "optionalDependencies": {
-    "@camera.ui/rust-postprocessor-darwin-x64": "0.0.8",
-    "@camera.ui/rust-postprocessor-win32-x64-msvc": "0.0.8",
-    "@camera.ui/rust-postprocessor-linux-x64-gnu": "0.0.8",
-    "@camera.ui/rust-postprocessor-linux-x64-musl": "0.0.8",
-    "@camera.ui/rust-postprocessor-freebsd-x64": "0.0.8",
-    "@camera.ui/rust-postprocessor-darwin-arm64": "0.0.8",
-    "@camera.ui/rust-postprocessor-win32-arm64-msvc": "0.0.8",
-    "@camera.ui/rust-postprocessor-linux-arm64-gnu": "0.0.8",
-    "@camera.ui/rust-postprocessor-linux-arm64-musl": "0.0.8",
-    "@camera.ui/rust-postprocessor-linux-riscv64-gnu": "0.0.8"
+    "@camera.ui/rust-postprocessor-darwin-x64": "0.1.0",
+    "@camera.ui/rust-postprocessor-win32-x64-msvc": "0.1.0",
+    "@camera.ui/rust-postprocessor-linux-x64-gnu": "0.1.0",
+    "@camera.ui/rust-postprocessor-linux-x64-musl": "0.1.0",
+    "@camera.ui/rust-postprocessor-freebsd-x64": "0.1.0",
+    "@camera.ui/rust-postprocessor-darwin-arm64": "0.1.0",
+    "@camera.ui/rust-postprocessor-win32-arm64-msvc": "0.1.0",
+    "@camera.ui/rust-postprocessor-linux-arm64-gnu": "0.1.0",
+    "@camera.ui/rust-postprocessor-linux-arm64-musl": "0.1.0",
+    "@camera.ui/rust-postprocessor-linux-riscv64-gnu": "0.1.0"
   }
 }