@camstack/types 0.1.38 → 0.1.40

package/dist/utils/privacy-grid-raster.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Privacy-mask rect ↔ cell rasterizer.
+ *
+ * Converts between a list of normalized axis-aligned rectangles
+ * (the native camera representation) and a row-major boolean cell grid
+ * (the cap model). All coordinates are in [0, 1] normalized space
+ * where (0, 0) is top-left.
+ *
+ * These utilities are pure functions with no side effects — safe to use
+ * in any addon without cross-process concerns.
+ */
+/** Normalized axis-aligned rect: origin (x, y), size (w, h). All values in [0, 1]. */
+export interface NormRect {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+/**
+ * Rasterize a list of normalized rects into a row-major boolean cell grid.
+ *
+ * Each cell at grid position (col, row) has its centre at:
+ *   cx = (col + 0.5) / gridWidth
+ *   cy = (row + 0.5) / gridHeight
+ *
+ * A cell is `true` when its centre falls inside any rect (closed interval
+ * on all four edges so single-pixel-wide rects always activate the cell
+ * whose centre is nearest the edge).
+ *
+ * Returns an array of length `gridWidth * gridHeight` in row-major order.
+ * Returns all-false when `rects` is empty or grid dimensions are ≤ 0.
+ */
+export declare function rectsToCells(rects: readonly NormRect[], gridWidth: number, gridHeight: number): boolean[];
+/**
+ * Convert a row-major boolean cell grid back into normalized rects, capped at
+ * `maxRegions`.
+ *
+ * The algorithm performs a greedy maximal-rectangle cover:
+ * 1. Scans row by row to identify horizontal runs of `true` cells.
+ * 2. Merges vertically adjacent runs with the same column span.
+ * 3. Returns each resulting block as a normalized `NormRect`.
+ * 4. When more than `maxRegions` blocks result, keeps the `maxRegions`
+ *    largest (by cell area).
+ *
+ * Returns an empty array for an empty grid or all-false cells.
+ */
+export declare function cellsToRects(cells: readonly boolean[], gridWidth: number, gridHeight: number, maxRegions: number): NormRect[];
+//# sourceMappingURL=privacy-grid-raster.d.ts.map

package/dist/utils/privacy-grid-raster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-grid-raster.d.ts","sourceRoot":"","sources":["../../src/utils/privacy-grid-raster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,sFAAsF;AACtF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,EAAE,CA2BX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,QAAQ,EAAE,CAsFZ"}

package/package.json

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