tempest-react-sdk 0.23.0 → 0.24.0

package/dist/vision/types.js

@@ -1,100 +1,108 @@
 import { ImageLoadError as e } from "./core/exceptions.js";
-class o {
-  constructor(s, t, h) {
-    if (this.data = s, this.width = t, this.height = h, s.length !== t * h * 3)
-      throw new e(
-        `RGBImage data length ${s.length} does not match width * height * 3 = ${t * h * 3}.`
-      );
-  }
-  data;
-  width;
-  height;
-}
-class g {
-  constructor(s, t, h, i) {
-    this.x1 = s, this.y1 = t, this.x2 = h, this.y2 = i;
-  }
-  x1;
-  y1;
-  x2;
-  y2;
-  /** Box width in pixels (clamped to non-negative). */
-  get width() {
-    return Math.max(0, this.x2 - this.x1);
-  }
-  /** Box height in pixels (clamped to non-negative). */
-  get height() {
-    return Math.max(0, this.y2 - this.y1);
-  }
-  /** Box area in pixels squared. */
-  get area() {
-    return this.width * this.height;
-  }
-  /** The box as `[x1, y1, x2, y2]` in absolute pixels (Ultralytics-style). */
-  get xyxy() {
-    return [this.x1, this.y1, this.x2, this.y2];
-  }
-  /**
-   * The box as `[cx, cy, w, h]` with `(cx, cy)` at the center.
-   *
-   * Matches Ultralytics' `boxes.xywh` and YOLO's native head format. For the
-   * top-left `[x, y, w, h]` convention, use {@link asXywh}.
-   */
-  get xywh() {
-    return [(this.x1 + this.x2) / 2, (this.y1 + this.y2) / 2, this.width, this.height];
-  }
-  /**
-   * The box as `[x1, y1, x2, y2]` normalized to `[0, 1]`.
-   *
-   * @param origShape `[height, width]` of the source image, in pixels.
-   */
-  xyxyn(s) {
-    const [t, h] = s;
-    return h <= 0 || t <= 0 ? [0, 0, 0, 0] : [this.x1 / h, this.y1 / t, this.x2 / h, this.y2 / t];
-  }
-  /**
-   * The box as `[cx, cy, w, h]` normalized to `[0, 1]`.
-   *
-   * @param origShape `[height, width]` of the source image, in pixels.
-   */
-  xywhn(s) {
-    const [t, h] = s;
-    if (h <= 0 || t <= 0) return [0, 0, 0, 0];
-    const [i, n, x, y] = this.xywh;
-    return [i / h, n / t, x / h, y / t];
-  }
-  /** Returns `[x1, y1, x2, y2]`. */
-  asXyxy() {
-    return [this.x1, this.y1, this.x2, this.y2];
-  }
-  /**
-   * Returns `[x, y, width, height]` with `(x, y)` at the **top-left**.
-   *
-   * Note: this is the top-left convention. Ultralytics' `xywh` getter uses
-   * **center** coordinates — for that, read {@link xywh}.
-   */
-  asXywh() {
-    return [this.x1, this.y1, this.width, this.height];
-  }
-  /** Returns `[x1, y1, x2, y2]` truncated to integers, useful for slicing arrays. */
-  asIntXyxy() {
-    return [Math.trunc(this.x1), Math.trunc(this.y1), Math.trunc(this.x2), Math.trunc(this.y2)];
-  }
-}
-class c {
-  constructor(s, t, h) {
-    if (this.data = s, this.width = t, this.height = h, s.length !== t * h)
-      throw new e(
-        `Mask data length ${s.length} does not match width * height = ${t * h}.`
-      );
-  }
-  data;
-  width;
-  height;
-}
-export {
-  g as BoundingBox,
-  c as Mask,
-  o as RGBImage
+//#region src/vision/types.ts
+var t = class {
+	data;
+	width;
+	height;
+	constructor(t, n, r) {
+		if (this.data = t, this.width = n, this.height = r, t.length !== n * r * 3) throw new e(`RGBImage data length ${t.length} does not match width * height * 3 = ${n * r * 3}.`);
+	}
+}, n = class {
+	x1;
+	y1;
+	x2;
+	y2;
+	constructor(e, t, n, r) {
+		this.x1 = e, this.y1 = t, this.x2 = n, this.y2 = r;
+	}
+	get width() {
+		return Math.max(0, this.x2 - this.x1);
+	}
+	get height() {
+		return Math.max(0, this.y2 - this.y1);
+	}
+	get area() {
+		return this.width * this.height;
+	}
+	get xyxy() {
+		return [
+			this.x1,
+			this.y1,
+			this.x2,
+			this.y2
+		];
+	}
+	get xywh() {
+		return [
+			(this.x1 + this.x2) / 2,
+			(this.y1 + this.y2) / 2,
+			this.width,
+			this.height
+		];
+	}
+	xyxyn(e) {
+		let [t, n] = e;
+		return n <= 0 || t <= 0 ? [
+			0,
+			0,
+			0,
+			0
+		] : [
+			this.x1 / n,
+			this.y1 / t,
+			this.x2 / n,
+			this.y2 / t
+		];
+	}
+	xywhn(e) {
+		let [t, n] = e;
+		if (n <= 0 || t <= 0) return [
+			0,
+			0,
+			0,
+			0
+		];
+		let [r, i, a, o] = this.xywh;
+		return [
+			r / n,
+			i / t,
+			a / n,
+			o / t
+		];
+	}
+	asXyxy() {
+		return [
+			this.x1,
+			this.y1,
+			this.x2,
+			this.y2
+		];
+	}
+	asXywh() {
+		return [
+			this.x1,
+			this.y1,
+			this.width,
+			this.height
+		];
+	}
+	asIntXyxy() {
+		return [
+			Math.trunc(this.x1),
+			Math.trunc(this.y1),
+			Math.trunc(this.x2),
+			Math.trunc(this.y2)
+		];
+	}
+}, r = class {
+	data;
+	width;
+	height;
+	constructor(t, n, r) {
+		if (this.data = t, this.width = n, this.height = r, t.length !== n * r) throw new e(`Mask data length ${t.length} does not match width * height = ${n * r}.`);
+	}
 };
-//# sourceMappingURL=types.js.map
+//#endregion
+export { n as BoundingBox, r as Mask, t as RGBImage };
+
+//# sourceMappingURL=types.js.map

package/dist/vision/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/vision/types.ts"],"sourcesContent":["/**\n * Public output types returned by the SDK's vision tasks.\n *\n * These types form the contract between the SDK and its callers. They mirror\n * the Python `ort-vision-sdk` output dataclasses 1-to-1.\n *\n * Naming is intentionally compatible with the Ultralytics / torchvision idiom\n * (`cls`, `conf`, `box`, `xyxy`, `xywh`, normalized variants) so code ported\n * from those projects keeps working with minimal edits. The original verbose\n * names (`classId`, `className`, `confidence`, `bbox`) are still populated for\n * backwards compatibility.\n */\n\nimport { ImageLoadError } from \"./core/exceptions\";\n\n/**\n * HWC RGB uint8 image — the canonical image format used across the SDK.\n *\n * `data.length` must equal `width * height * 3`. The buffer is laid out row\n * by row, top-to-bottom, with each pixel as `[R, G, B]`.\n */\nexport class RGBImage {\n    constructor(\n        public readonly data: Uint8Array,\n        public readonly width: number,\n        public readonly height: number,\n    ) {\n        if (data.length !== width * height * 3) {\n            throw new ImageLoadError(\n                `RGBImage data length ${data.length} does not match width * height * 3 = ${\n                    width * height * 3\n                }.`,\n            );\n        }\n    }\n}\n\n/**\n * Axis-aligned bounding box in absolute pixel coordinates (xyxy format).\n *\n * Coordinates refer to the original input image (before any internal resize),\n * so callers can map detections back onto their source image without any\n * additional bookkeeping.\n */\nexport class BoundingBox {\n    constructor(\n        public readonly x1: number,\n        public readonly y1: number,\n        public readonly x2: number,\n        public readonly y2: number,\n    ) {}\n\n    /** Box width in pixels (clamped to non-negative). */\n    get width(): number {\n        return Math.max(0, this.x2 - this.x1);\n    }\n\n    /** Box height in pixels (clamped to non-negative). */\n    get height(): number {\n        return Math.max(0, this.y2 - this.y1);\n    }\n\n    /** Box area in pixels squared. */\n    get area(): number {\n        return this.width * this.height;\n    }\n\n    /** The box as `[x1, y1, x2, y2]` in absolute pixels (Ultralytics-style). */\n    get xyxy(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.x2, this.y2];\n    }\n\n    /**\n     * The box as `[cx, cy, w, h]` with `(cx, cy)` at the center.\n     *\n     * Matches Ultralytics' `boxes.xywh` and YOLO's native head format. For the\n     * top-left `[x, y, w, h]` convention, use {@link asXywh}.\n     */\n    get xywh(): readonly [number, number, number, number] {\n        return [(this.x1 + this.x2) / 2, (this.y1 + this.y2) / 2, this.width, this.height];\n    }\n\n    /**\n     * The box as `[x1, y1, x2, y2]` normalized to `[0, 1]`.\n     *\n     * @param origShape `[height, width]` of the source image, in pixels.\n     */\n    xyxyn(origShape: readonly [number, number]): readonly [number, number, number, number] {\n        const [h, w] = origShape;\n        if (w <= 0 || h <= 0) return [0, 0, 0, 0];\n        return [this.x1 / w, this.y1 / h, this.x2 / w, this.y2 / h];\n    }\n\n    /**\n     * The box as `[cx, cy, w, h]` normalized to `[0, 1]`.\n     *\n     * @param origShape `[height, width]` of the source image, in pixels.\n     */\n    xywhn(origShape: readonly [number, number]): readonly [number, number, number, number] {\n        const [h, w] = origShape;\n        if (w <= 0 || h <= 0) return [0, 0, 0, 0];\n        const [cx, cy, bw, bh] = this.xywh;\n        return [cx / w, cy / h, bw / w, bh / h];\n    }\n\n    /** Returns `[x1, y1, x2, y2]`. */\n    asXyxy(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.x2, this.y2];\n    }\n\n    /**\n     * Returns `[x, y, width, height]` with `(x, y)` at the **top-left**.\n     *\n     * Note: this is the top-left convention. Ultralytics' `xywh` getter uses\n     * **center** coordinates — for that, read {@link xywh}.\n     */\n    asXywh(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.width, this.height];\n    }\n\n    /** Returns `[x1, y1, x2, y2]` truncated to integers, useful for slicing arrays. */\n    asIntXyxy(): readonly [number, number, number, number] {\n        return [Math.trunc(this.x1), Math.trunc(this.y1), Math.trunc(this.x2), Math.trunc(this.y2)];\n    }\n}\n\n/**\n * Probability assigned to a single class for a classification prediction.\n *\n * `cls` / `name` / `conf` are Ultralytics-style aliases populated alongside\n * the verbose `classId` / `className` / `probability` fields.\n */\nexport interface ClassProbability {\n    readonly classId: number;\n    readonly className: string;\n    readonly probability: number;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `probability` (Ultralytics-style). */\n    readonly conf: number;\n}\n\n/**\n * Output of an image classification inference.\n */\nexport interface ClassificationResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** The original input image as an HWC RGB uint8 array. */\n    readonly image: RGBImage;\n    /**\n     * Probabilities per class, sorted in descending order. The first entry\n     * mirrors `classId`, `className`, and `confidence`. When `topK` was passed\n     * to `predict`, the array is truncated to that length.\n     */\n    readonly probabilities: readonly ClassProbability[];\n}\n\n/**\n * Single detected object produced by an object-detection model.\n */\nexport interface DetectionResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    readonly bbox: BoundingBox;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** Alias for `bbox` (Ultralytics-style). */\n    readonly box: BoundingBox;\n    /**\n     * The original image cropped to `bbox`, HWC RGB uint8. Empty boxes\n     * (zero area) yield a zero-sized `RGBImage`.\n     */\n    readonly croppedImage: RGBImage;\n}\n\n/**\n * Single-channel binary or grayscale mask, laid out row-major.\n *\n * `data.length` must equal `width * height`. For binary masks, values are\n * `0` (background) or `255` (foreground); soft masks may use the full\n * `[0, 255]` range.\n */\nexport class Mask {\n    constructor(\n        public readonly data: Uint8Array,\n        public readonly width: number,\n        public readonly height: number,\n    ) {\n        if (data.length !== width * height) {\n            throw new ImageLoadError(\n                `Mask data length ${data.length} does not match width * height = ${\n                    width * height\n                }.`,\n            );\n        }\n    }\n}\n\n/**\n * Single segmented instance produced by an instance-segmentation model.\n *\n * Mirrors {@link DetectionResult} and adds the per-instance binary mask\n * plus a \"ready-to-display\" background-removed crop.\n */\nexport interface SegmentationResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    readonly bbox: BoundingBox;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** Alias for `bbox` (Ultralytics-style). */\n    readonly box: BoundingBox;\n    /**\n     * Binary mask cropped to `bbox`. Values are `0` (background) or `255`\n     * (foreground). Empty boxes yield a zero-sized `Mask`.\n     */\n    readonly mask: Mask;\n    /**\n     * The original image cropped to `bbox` with background pixels (where\n     * `mask.data[i] === 0`) zeroed out. Empty boxes yield a zero-sized\n     * `RGBImage`.\n     */\n    readonly segmentedImage: RGBImage;\n}\n"],"names":["RGBImage","data","width","height","ImageLoadError","BoundingBox","x1","y1","x2","y2","origShape","h","w","cx","cy","bw","bh","Mask"],"mappings":";AAqBO,MAAMA,EAAS;AAAA,EAClB,YACoBC,GACAC,GACAC,GAClB;AACE,QAJgB,KAAA,OAAAF,GACA,KAAA,QAAAC,GACA,KAAA,SAAAC,GAEZF,EAAK,WAAWC,IAAQC,IAAS;AACjC,YAAM,IAAIC;AAAA,QACN,wBAAwBH,EAAK,MAAM,wCAC/BC,IAAQC,IAAS,CACrB;AAAA,MAAA;AAAA,EAGZ;AAAA,EAXoB;AAAA,EACA;AAAA,EACA;AAUxB;AASO,MAAME,EAAY;AAAA,EACrB,YACoBC,GACAC,GACAC,GACAC,GAClB;AAJkB,SAAA,KAAAH,GACA,KAAA,KAAAC,GACA,KAAA,KAAAC,GACA,KAAA,KAAAC;AAAA,EACjB;AAAA,EAJiB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAIpB,IAAI,QAAgB;AAChB,WAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,EAAE;AAAA,EACxC;AAAA;AAAA,EAGA,IAAI,SAAiB;AACjB,WAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,EAAE;AAAA,EACxC;AAAA;AAAA,EAGA,IAAI,OAAe;AACf,WAAO,KAAK,QAAQ,KAAK;AAAA,EAC7B;AAAA;AAAA,EAGA,IAAI,OAAkD;AAClD,WAAO,CAAC,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,OAAkD;AAClD,WAAO,EAAE,KAAK,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,KAAK,MAAM,GAAG,KAAK,OAAO,KAAK,MAAM;AAAA,EACrF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAMC,GAAiF;AACnF,UAAM,CAACC,GAAGC,CAAC,IAAIF;AACf,WAAIE,KAAK,KAAKD,KAAK,IAAU,CAAC,GAAG,GAAG,GAAG,CAAC,IACjC,CAAC,KAAK,KAAKC,GAAG,KAAK,KAAKD,GAAG,KAAK,KAAKC,GAAG,KAAK,KAAKD,CAAC;AAAA,EAC9D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAMD,GAAiF;AACnF,UAAM,CAACC,GAAGC,CAAC,IAAIF;AACf,QAAIE,KAAK,KAAKD,KAAK,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC;AACxC,UAAM,CAACE,GAAIC,GAAIC,GAAIC,CAAE,IAAI,KAAK;AAC9B,WAAO,CAACH,IAAKD,GAAGE,IAAKH,GAAGI,IAAKH,GAAGI,IAAKL,CAAC;AAAA,EAC1C;AAAA;AAAA,EAGA,SAAoD;AAChD,WAAO,CAAC,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,EAAE;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,SAAoD;AAChD,WAAO,CAAC,KAAK,IAAI,KAAK,IAAI,KAAK,OAAO,KAAK,MAAM;AAAA,EACrD;AAAA;AAAA,EAGA,YAAuD;AACnD,WAAO,CAAC,KAAK,MAAM,KAAK,EAAE,GAAG,KAAK,MAAM,KAAK,EAAE,GAAG,KAAK,MAAM,KAAK,EAAE,GAAG,KAAK,MAAM,KAAK,EAAE,CAAC;AAAA,EAC9F;AACJ;AAyEO,MAAMM,EAAK;AAAA,EACd,YACoBhB,GACAC,GACAC,GAClB;AACE,QAJgB,KAAA,OAAAF,GACA,KAAA,QAAAC,GACA,KAAA,SAAAC,GAEZF,EAAK,WAAWC,IAAQC;AACxB,YAAM,IAAIC;AAAA,QACN,oBAAoBH,EAAK,MAAM,oCAC3BC,IAAQC,CACZ;AAAA,MAAA;AAAA,EAGZ;AAAA,EAXoB;AAAA,EACA;AAAA,EACA;AAUxB;"}
+{"version":3,"file":"types.js","names":[],"sources":["../../src/vision/types.ts"],"sourcesContent":["/**\n * Public output types returned by the SDK's vision tasks.\n *\n * These types form the contract between the SDK and its callers. They mirror\n * the Python `ort-vision-sdk` output dataclasses 1-to-1.\n *\n * Naming is intentionally compatible with the Ultralytics / torchvision idiom\n * (`cls`, `conf`, `box`, `xyxy`, `xywh`, normalized variants) so code ported\n * from those projects keeps working with minimal edits. The original verbose\n * names (`classId`, `className`, `confidence`, `bbox`) are still populated for\n * backwards compatibility.\n */\n\nimport { ImageLoadError } from \"./core/exceptions\";\n\n/**\n * HWC RGB uint8 image — the canonical image format used across the SDK.\n *\n * `data.length` must equal `width * height * 3`. The buffer is laid out row\n * by row, top-to-bottom, with each pixel as `[R, G, B]`.\n */\nexport class RGBImage {\n    constructor(\n        public readonly data: Uint8Array,\n        public readonly width: number,\n        public readonly height: number,\n    ) {\n        if (data.length !== width * height * 3) {\n            throw new ImageLoadError(\n                `RGBImage data length ${data.length} does not match width * height * 3 = ${\n                    width * height * 3\n                }.`,\n            );\n        }\n    }\n}\n\n/**\n * Axis-aligned bounding box in absolute pixel coordinates (xyxy format).\n *\n * Coordinates refer to the original input image (before any internal resize),\n * so callers can map detections back onto their source image without any\n * additional bookkeeping.\n */\nexport class BoundingBox {\n    constructor(\n        public readonly x1: number,\n        public readonly y1: number,\n        public readonly x2: number,\n        public readonly y2: number,\n    ) {}\n\n    /** Box width in pixels (clamped to non-negative). */\n    get width(): number {\n        return Math.max(0, this.x2 - this.x1);\n    }\n\n    /** Box height in pixels (clamped to non-negative). */\n    get height(): number {\n        return Math.max(0, this.y2 - this.y1);\n    }\n\n    /** Box area in pixels squared. */\n    get area(): number {\n        return this.width * this.height;\n    }\n\n    /** The box as `[x1, y1, x2, y2]` in absolute pixels (Ultralytics-style). */\n    get xyxy(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.x2, this.y2];\n    }\n\n    /**\n     * The box as `[cx, cy, w, h]` with `(cx, cy)` at the center.\n     *\n     * Matches Ultralytics' `boxes.xywh` and YOLO's native head format. For the\n     * top-left `[x, y, w, h]` convention, use {@link asXywh}.\n     */\n    get xywh(): readonly [number, number, number, number] {\n        return [(this.x1 + this.x2) / 2, (this.y1 + this.y2) / 2, this.width, this.height];\n    }\n\n    /**\n     * The box as `[x1, y1, x2, y2]` normalized to `[0, 1]`.\n     *\n     * @param origShape `[height, width]` of the source image, in pixels.\n     */\n    xyxyn(origShape: readonly [number, number]): readonly [number, number, number, number] {\n        const [h, w] = origShape;\n        if (w <= 0 || h <= 0) return [0, 0, 0, 0];\n        return [this.x1 / w, this.y1 / h, this.x2 / w, this.y2 / h];\n    }\n\n    /**\n     * The box as `[cx, cy, w, h]` normalized to `[0, 1]`.\n     *\n     * @param origShape `[height, width]` of the source image, in pixels.\n     */\n    xywhn(origShape: readonly [number, number]): readonly [number, number, number, number] {\n        const [h, w] = origShape;\n        if (w <= 0 || h <= 0) return [0, 0, 0, 0];\n        const [cx, cy, bw, bh] = this.xywh;\n        return [cx / w, cy / h, bw / w, bh / h];\n    }\n\n    /** Returns `[x1, y1, x2, y2]`. */\n    asXyxy(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.x2, this.y2];\n    }\n\n    /**\n     * Returns `[x, y, width, height]` with `(x, y)` at the **top-left**.\n     *\n     * Note: this is the top-left convention. Ultralytics' `xywh` getter uses\n     * **center** coordinates — for that, read {@link xywh}.\n     */\n    asXywh(): readonly [number, number, number, number] {\n        return [this.x1, this.y1, this.width, this.height];\n    }\n\n    /** Returns `[x1, y1, x2, y2]` truncated to integers, useful for slicing arrays. */\n    asIntXyxy(): readonly [number, number, number, number] {\n        return [Math.trunc(this.x1), Math.trunc(this.y1), Math.trunc(this.x2), Math.trunc(this.y2)];\n    }\n}\n\n/**\n * Probability assigned to a single class for a classification prediction.\n *\n * `cls` / `name` / `conf` are Ultralytics-style aliases populated alongside\n * the verbose `classId` / `className` / `probability` fields.\n */\nexport interface ClassProbability {\n    readonly classId: number;\n    readonly className: string;\n    readonly probability: number;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `probability` (Ultralytics-style). */\n    readonly conf: number;\n}\n\n/**\n * Output of an image classification inference.\n */\nexport interface ClassificationResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** The original input image as an HWC RGB uint8 array. */\n    readonly image: RGBImage;\n    /**\n     * Probabilities per class, sorted in descending order. The first entry\n     * mirrors `classId`, `className`, and `confidence`. When `topK` was passed\n     * to `predict`, the array is truncated to that length.\n     */\n    readonly probabilities: readonly ClassProbability[];\n}\n\n/**\n * Single detected object produced by an object-detection model.\n */\nexport interface DetectionResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    readonly bbox: BoundingBox;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** Alias for `bbox` (Ultralytics-style). */\n    readonly box: BoundingBox;\n    /**\n     * The original image cropped to `bbox`, HWC RGB uint8. Empty boxes\n     * (zero area) yield a zero-sized `RGBImage`.\n     */\n    readonly croppedImage: RGBImage;\n}\n\n/**\n * Single-channel binary or grayscale mask, laid out row-major.\n *\n * `data.length` must equal `width * height`. For binary masks, values are\n * `0` (background) or `255` (foreground); soft masks may use the full\n * `[0, 255]` range.\n */\nexport class Mask {\n    constructor(\n        public readonly data: Uint8Array,\n        public readonly width: number,\n        public readonly height: number,\n    ) {\n        if (data.length !== width * height) {\n            throw new ImageLoadError(\n                `Mask data length ${data.length} does not match width * height = ${\n                    width * height\n                }.`,\n            );\n        }\n    }\n}\n\n/**\n * Single segmented instance produced by an instance-segmentation model.\n *\n * Mirrors {@link DetectionResult} and adds the per-instance binary mask\n * plus a \"ready-to-display\" background-removed crop.\n */\nexport interface SegmentationResult {\n    readonly classId: number;\n    readonly className: string;\n    readonly confidence: number;\n    readonly bbox: BoundingBox;\n    /** Alias for `classId` (Ultralytics-style). */\n    readonly cls: number;\n    /** Alias for `className`. */\n    readonly name: string;\n    /** Alias for `confidence` (Ultralytics-style). */\n    readonly conf: number;\n    /** Alias for `bbox` (Ultralytics-style). */\n    readonly box: BoundingBox;\n    /**\n     * Binary mask cropped to `bbox`. Values are `0` (background) or `255`\n     * (foreground). Empty boxes yield a zero-sized `Mask`.\n     */\n    readonly mask: Mask;\n    /**\n     * The original image cropped to `bbox` with background pixels (where\n     * `mask.data[i] === 0`) zeroed out. Empty boxes yield a zero-sized\n     * `RGBImage`.\n     */\n    readonly segmentedImage: RGBImage;\n}\n"],"mappings":";;AAqBA,IAAa,IAAb,MAAsB;CAEE;CACA;CACA;CAHpB,YACI,GACA,GACA,GACF;EACE,IAJgB,KAAA,OAAA,GACA,KAAA,QAAA,GACA,KAAA,SAAA,GAEZ,EAAK,WAAW,IAAQ,IAAS,GACjC,MAAM,IAAI,EACN,wBAAwB,EAAK,OAAO,uCAChC,IAAQ,IAAS,EACpB,EACL;CAER;AACJ,GASa,IAAb,MAAyB;CAED;CACA;CACA;CACA;CAJpB,YACI,GACA,GACA,GACA,GACF;EADkB,AAHA,KAAA,KAAA,GACA,KAAA,KAAA,GACA,KAAA,KAAA,GACA,KAAA,KAAA;CACjB;CAGH,IAAI,QAAgB;EAChB,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,EAAE;CACxC;CAGA,IAAI,SAAiB;EACjB,OAAO,KAAK,IAAI,GAAG,KAAK,KAAK,KAAK,EAAE;CACxC;CAGA,IAAI,OAAe;EACf,OAAO,KAAK,QAAQ,KAAK;CAC7B;CAGA,IAAI,OAAkD;EAClD,OAAO;GAAC,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;EAAE;CAC9C;CAQA,IAAI,OAAkD;EAClD,OAAO;IAAE,KAAK,KAAK,KAAK,MAAM;IAAI,KAAK,KAAK,KAAK,MAAM;GAAG,KAAK;GAAO,KAAK;EAAM;CACrF;CAOA,MAAM,GAAiF;EACnF,IAAM,CAAC,GAAG,KAAK;EAEf,OADI,KAAK,KAAK,KAAK,IAAU;GAAC;GAAG;GAAG;GAAG;EAAC,IACjC;GAAC,KAAK,KAAK;GAAG,KAAK,KAAK;GAAG,KAAK,KAAK;GAAG,KAAK,KAAK;EAAC;CAC9D;CAOA,MAAM,GAAiF;EACnF,IAAM,CAAC,GAAG,KAAK;EACf,IAAI,KAAK,KAAK,KAAK,GAAG,OAAO;GAAC;GAAG;GAAG;GAAG;EAAC;EACxC,IAAM,CAAC,GAAI,GAAI,GAAI,KAAM,KAAK;EAC9B,OAAO;GAAC,IAAK;GAAG,IAAK;GAAG,IAAK;GAAG,IAAK;EAAC;CAC1C;CAGA,SAAoD;EAChD,OAAO;GAAC,KAAK;GAAI,KAAK;GAAI,KAAK;GAAI,KAAK;EAAE;CAC9C;CAQA,SAAoD;EAChD,OAAO;GAAC,KAAK;GAAI,KAAK;GAAI,KAAK;GAAO,KAAK;EAAM;CACrD;CAGA,YAAuD;EACnD,OAAO;GAAC,KAAK,MAAM,KAAK,EAAE;GAAG,KAAK,MAAM,KAAK,EAAE;GAAG,KAAK,MAAM,KAAK,EAAE;GAAG,KAAK,MAAM,KAAK,EAAE;EAAC;CAC9F;AACJ,GAyEa,IAAb,MAAkB;CAEM;CACA;CACA;CAHpB,YACI,GACA,GACA,GACF;EACE,IAJgB,KAAA,OAAA,GACA,KAAA,QAAA,GACA,KAAA,SAAA,GAEZ,EAAK,WAAW,IAAQ,GACxB,MAAM,IAAI,EACN,oBAAoB,EAAK,OAAO,mCAC5B,IAAQ,EACX,EACL;CAER;AACJ"}

package/dist/vision/use-camera-stream.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react"),l={video:{facingMode:{ideal:"environment"},width:{ideal:1920},height:{ideal:1080}},audio:!1};function f(r){if(typeof window>"u")return{kind:"unsupported",message:"Camera is unavailable in this environment."};if(!window.isSecureContext)return{kind:"insecure",message:"Camera access requires a secure (HTTPS) connection."};if(r instanceof DOMException)switch(r.name){case"NotAllowedError":case"SecurityError":return{kind:"permission-denied",message:"Camera permission denied. Enable access in your browser settings."};case"NotFoundError":case"OverconstrainedError":return{kind:"no-camera",message:"No camera available on this device."};case"NotReadableError":case"AbortError":return{kind:"in-use",message:"The camera is in use by another app. Close it and try again."}}return{kind:"unknown",message:r instanceof Error?r.message:"Unexpected error while accessing the camera."}}function h(r={}){const[m,s]=a.useState("loading"),[g,i]=a.useState(null),[p,v]=a.useState(0),u=a.useRef(null),d=a.useRef(r.constraints??l);return d.current=r.constraints??l,a.useEffect(()=>{let t=!1,n=null,o=null;async function y(){if(s("loading"),i(null),typeof navigator>"u"||!navigator.mediaDevices||typeof navigator.mediaDevices.getUserMedia!="function"){t||(i(typeof window<"u"&&!window.isSecureContext?f(null):{kind:"unsupported",message:"Camera capture is not supported in this browser."}),s("error"));return}try{if(n=await navigator.mediaDevices.getUserMedia(d.current),t){n.getTracks().forEach(c=>c.stop());return}const e=u.current;if(!e){n.getTracks().forEach(c=>c.stop());return}o=e,e.srcObject=n,await e.play().catch(()=>{}),t||s("ready")}catch(e){t||(i(f(e)),s("error"))}}return y(),()=>{t=!0,n&&n.getTracks().forEach(e=>e.stop()),o&&(o.srcObject=null)}},[p]),{status:m,error:g,videoRef:u,retry:()=>v(t=>t+1)}}exports.useCameraStream=h;
-//# sourceMappingURL=use-camera-stream.cjs.map
+let e=require("react");var t={video:{facingMode:{ideal:`environment`},width:{ideal:1920},height:{ideal:1080}},audio:!1};function n(e){if(typeof window>`u`)return{kind:`unsupported`,message:`Camera is unavailable in this environment.`};if(!window.isSecureContext)return{kind:`insecure`,message:`Camera access requires a secure (HTTPS) connection.`};if(e instanceof DOMException)switch(e.name){case`NotAllowedError`:case`SecurityError`:return{kind:`permission-denied`,message:`Camera permission denied. Enable access in your browser settings.`};case`NotFoundError`:case`OverconstrainedError`:return{kind:`no-camera`,message:`No camera available on this device.`};case`NotReadableError`:case`AbortError`:return{kind:`in-use`,message:`The camera is in use by another app. Close it and try again.`}}return{kind:`unknown`,message:e instanceof Error?e.message:`Unexpected error while accessing the camera.`}}function r(r={}){let[i,a]=(0,e.useState)(`loading`),[o,s]=(0,e.useState)(null),[c,l]=(0,e.useState)(0),u=(0,e.useRef)(null),d=(0,e.useRef)(r.constraints??t);return d.current=r.constraints??t,(0,e.useEffect)(()=>{let e=!1,t=null,r=null;async function i(){if(a(`loading`),s(null),typeof navigator>`u`||!navigator.mediaDevices||typeof navigator.mediaDevices.getUserMedia!=`function`){e||(s(typeof window<`u`&&!window.isSecureContext?n(null):{kind:`unsupported`,message:`Camera capture is not supported in this browser.`}),a(`error`));return}try{if(t=await navigator.mediaDevices.getUserMedia(d.current),e){t.getTracks().forEach(e=>e.stop());return}let n=u.current;if(!n){t.getTracks().forEach(e=>e.stop());return}r=n,n.srcObject=t,await n.play().catch(()=>void 0),e||a(`ready`)}catch(t){e||(s(n(t)),a(`error`))}}return i(),()=>{e=!0,t&&t.getTracks().forEach(e=>e.stop()),r&&(r.srcObject=null)}},[c]),{status:i,error:o,videoRef:u,retry:()=>l(e=>e+1)}}exports.useCameraStream=r;
+//# sourceMappingURL=use-camera-stream.cjs.map

package/dist/vision/use-camera-stream.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-camera-stream.cjs","sources":["../../src/vision/use-camera-stream.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\n\n/** Lifecycle status of the camera stream. */\nexport type CameraStreamStatus = \"idle\" | \"loading\" | \"ready\" | \"error\";\n\n/** Classified reason a camera stream could not be acquired. */\nexport type CameraStreamErrorKind =\n    | \"unsupported\"\n    | \"permission-denied\"\n    | \"no-camera\"\n    | \"in-use\"\n    | \"insecure\"\n    | \"unknown\";\n\n/** A classified camera error with a human-readable, English message. */\nexport interface CameraStreamError {\n    kind: CameraStreamErrorKind;\n    message: string;\n}\n\n/** Options for {@link useCameraStream}. */\nexport interface UseCameraStreamOptions {\n    /**\n     * Constraints passed to `getUserMedia`. Defaults to the rear\n     * (\"environment\") camera at Full-HD ideal resolution with audio off.\n     * Read when the stream (re)starts — change it and call `retry()` to apply.\n     */\n    constraints?: MediaStreamConstraints;\n}\n\n/** Value returned by {@link useCameraStream}. */\nexport interface UseCameraStreamApi {\n    /** Current lifecycle status. */\n    status: CameraStreamStatus;\n    /** The classified error, or `null` while not in the `error` status. */\n    error: CameraStreamError | null;\n    /** Attach to a `<video ref={…} />`. The stream is wired to it once ready. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /** Manually re-attempt after an error (e.g. the user changed permissions). */\n    retry: () => void;\n}\n\n/** Rear-camera Full-HD defaults used when no `constraints` are supplied. */\nconst DEFAULT_CONSTRAINTS: MediaStreamConstraints = {\n    video: {\n        facingMode: { ideal: \"environment\" },\n        width: { ideal: 1920 },\n        height: { ideal: 1080 },\n    },\n    audio: false,\n};\n\n/**\n * Map an unknown failure into a {@link CameraStreamError}. Secure-context and\n * environment checks run first (they are the reason `getUserMedia` is missing\n * or rejects), then the `DOMException.name` is mapped to a stable `kind`.\n */\nfunction classifyError(err: unknown): CameraStreamError {\n    if (typeof window === \"undefined\") {\n        return { kind: \"unsupported\", message: \"Camera is unavailable in this environment.\" };\n    }\n    if (!window.isSecureContext) {\n        return {\n            kind: \"insecure\",\n            message: \"Camera access requires a secure (HTTPS) connection.\",\n        };\n    }\n    if (err instanceof DOMException) {\n        switch (err.name) {\n            case \"NotAllowedError\":\n            case \"SecurityError\":\n                return {\n                    kind: \"permission-denied\",\n                    message: \"Camera permission denied. Enable access in your browser settings.\",\n                };\n            case \"NotFoundError\":\n            case \"OverconstrainedError\":\n                return {\n                    kind: \"no-camera\",\n                    message: \"No camera available on this device.\",\n                };\n            case \"NotReadableError\":\n            case \"AbortError\":\n                return {\n                    kind: \"in-use\",\n                    message: \"The camera is in use by another app. Close it and try again.\",\n                };\n        }\n    }\n    return {\n        kind: \"unknown\",\n        message:\n            err instanceof Error ? err.message : \"Unexpected error while accessing the camera.\",\n    };\n}\n\n/**\n * Acquire a `MediaStream` via `getUserMedia`, attach it to a `<video>` element,\n * and expose status/error so the page can render permission and error states.\n * The stream is automatically released on unmount or retry.\n *\n * Defaults to the rear (\"environment\") camera; desktops fall back to whatever\n * single camera they expose. Pass `options.constraints` to override.\n *\n * Implementation notes:\n * - Cleanup detaches the stream from a *snapshotted* video node, so it releases\n *   the same element it attached to even if the page remounts the `<video>`.\n * - When `getUserMedia` is missing, an insecure context is the usual cause, so\n *   the hook prefers that (actionable) error; otherwise it reports `unsupported`.\n * - `video.play()` rejections are swallowed: autoplay may be blocked, but the\n *   user gesture that opened the camera usually counts and playback resumes on\n *   the next interaction.\n *\n * @param options - optional configuration (see {@link UseCameraStreamOptions}).\n * @returns The stream status, classified error, a `videoRef` to attach, and a\n *   `retry()` to re-attempt acquisition.\n */\nexport function useCameraStream(options: UseCameraStreamOptions = {}): UseCameraStreamApi {\n    const [status, setStatus] = useState<CameraStreamStatus>(\"loading\");\n    const [error, setError] = useState<CameraStreamError | null>(null);\n    const [retryToken, setRetryToken] = useState(0);\n    const videoRef = useRef<HTMLVideoElement | null>(null);\n    const constraintsRef = useRef<MediaStreamConstraints>(\n        options.constraints ?? DEFAULT_CONSTRAINTS,\n    );\n    constraintsRef.current = options.constraints ?? DEFAULT_CONSTRAINTS;\n\n    useEffect(() => {\n        let cancelled = false;\n        let stream: MediaStream | null = null;\n        let attachedVideo: HTMLVideoElement | null = null;\n\n        async function start(): Promise<void> {\n            setStatus(\"loading\");\n            setError(null);\n\n            if (\n                typeof navigator === \"undefined\" ||\n                !navigator.mediaDevices ||\n                typeof navigator.mediaDevices.getUserMedia !== \"function\"\n            ) {\n                if (!cancelled) {\n                    setError(\n                        typeof window !== \"undefined\" && !window.isSecureContext\n                            ? classifyError(null)\n                            : {\n                                  kind: \"unsupported\",\n                                  message: \"Camera capture is not supported in this browser.\",\n                              },\n                    );\n                    setStatus(\"error\");\n                }\n                return;\n            }\n\n            try {\n                stream = await navigator.mediaDevices.getUserMedia(constraintsRef.current);\n                if (cancelled) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                const video = videoRef.current;\n                if (!video) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                attachedVideo = video;\n                video.srcObject = stream;\n                await video.play().catch(() => undefined);\n                if (!cancelled) setStatus(\"ready\");\n            } catch (err) {\n                if (!cancelled) {\n                    setError(classifyError(err));\n                    setStatus(\"error\");\n                }\n            }\n        }\n\n        void start();\n\n        return () => {\n            cancelled = true;\n            if (stream) {\n                stream.getTracks().forEach((track) => track.stop());\n            }\n            if (attachedVideo) {\n                attachedVideo.srcObject = null;\n            }\n        };\n    }, [retryToken]);\n\n    return {\n        status,\n        error,\n        videoRef,\n        retry: () => setRetryToken((n) => n + 1),\n    };\n}\n"],"names":["DEFAULT_CONSTRAINTS","classifyError","err","useCameraStream","options","status","setStatus","useState","error","setError","retryToken","setRetryToken","videoRef","useRef","constraintsRef","useEffect","cancelled","stream","attachedVideo","start","track","video","n"],"mappings":"yGA2CMA,EAA8C,CAChD,MAAO,CACH,WAAY,CAAE,MAAO,aAAA,EACrB,MAAO,CAAE,MAAO,IAAA,EAChB,OAAQ,CAAE,MAAO,IAAA,CAAK,EAE1B,MAAO,EACX,EAOA,SAASC,EAAcC,EAAiC,CACpD,GAAI,OAAO,OAAW,IAClB,MAAO,CAAE,KAAM,cAAe,QAAS,4CAAA,EAE3C,GAAI,CAAC,OAAO,gBACR,MAAO,CACH,KAAM,WACN,QAAS,qDAAA,EAGjB,GAAIA,aAAe,aACf,OAAQA,EAAI,KAAA,CACR,IAAK,kBACL,IAAK,gBACD,MAAO,CACH,KAAM,oBACN,QAAS,mEAAA,EAEjB,IAAK,gBACL,IAAK,uBACD,MAAO,CACH,KAAM,YACN,QAAS,qCAAA,EAEjB,IAAK,mBACL,IAAK,aACD,MAAO,CACH,KAAM,SACN,QAAS,8DAAA,CACb,CAGZ,MAAO,CACH,KAAM,UACN,QACIA,aAAe,MAAQA,EAAI,QAAU,8CAAA,CAEjD,CAuBO,SAASC,EAAgBC,EAAkC,GAAwB,CACtF,KAAM,CAACC,EAAQC,CAAS,EAAIC,EAAAA,SAA6B,SAAS,EAC5D,CAACC,EAAOC,CAAQ,EAAIF,EAAAA,SAAmC,IAAI,EAC3D,CAACG,EAAYC,CAAa,EAAIJ,EAAAA,SAAS,CAAC,EACxCK,EAAWC,EAAAA,OAAgC,IAAI,EAC/CC,EAAiBD,EAAAA,OACnBT,EAAQ,aAAeJ,CAAA,EAE3B,OAAAc,EAAe,QAAUV,EAAQ,aAAeJ,EAEhDe,EAAAA,UAAU,IAAM,CACZ,IAAIC,EAAY,GACZC,EAA6B,KAC7BC,EAAyC,KAE7C,eAAeC,GAAuB,CAIlC,GAHAb,EAAU,SAAS,EACnBG,EAAS,IAAI,EAGT,OAAO,UAAc,KACrB,CAAC,UAAU,cACX,OAAO,UAAU,aAAa,cAAiB,WACjD,CACOO,IACDP,EACI,OAAO,OAAW,KAAe,CAAC,OAAO,gBACnCR,EAAc,IAAI,EAClB,CACI,KAAM,cACN,QAAS,kDAAA,CACb,EAEVK,EAAU,OAAO,GAErB,MACJ,CAEA,GAAI,CAEA,GADAW,EAAS,MAAM,UAAU,aAAa,aAAaH,EAAe,OAAO,EACrEE,EAAW,CACXC,EAAO,YAAY,QAASG,GAAUA,EAAM,MAAM,EAClD,MACJ,CACA,MAAMC,EAAQT,EAAS,QACvB,GAAI,CAACS,EAAO,CACRJ,EAAO,YAAY,QAASG,GAAUA,EAAM,MAAM,EAClD,MACJ,CACAF,EAAgBG,EAChBA,EAAM,UAAYJ,EAClB,MAAMI,EAAM,KAAA,EAAO,MAAM,IAAA,EAAe,EACnCL,GAAWV,EAAU,OAAO,CACrC,OAASJ,EAAK,CACLc,IACDP,EAASR,EAAcC,CAAG,CAAC,EAC3BI,EAAU,OAAO,EAEzB,CACJ,CAEA,OAAKa,EAAA,EAEE,IAAM,CACTH,EAAY,GACRC,GACAA,EAAO,YAAY,QAASG,GAAUA,EAAM,MAAM,EAElDF,IACAA,EAAc,UAAY,KAElC,CACJ,EAAG,CAACR,CAAU,CAAC,EAER,CACH,OAAAL,EACA,MAAAG,EACA,SAAAI,EACA,MAAO,IAAMD,EAAeW,GAAMA,EAAI,CAAC,CAAA,CAE/C"}
+{"version":3,"file":"use-camera-stream.cjs","names":[],"sources":["../../src/vision/use-camera-stream.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\n\n/** Lifecycle status of the camera stream. */\nexport type CameraStreamStatus = \"idle\" | \"loading\" | \"ready\" | \"error\";\n\n/** Classified reason a camera stream could not be acquired. */\nexport type CameraStreamErrorKind =\n    \"unsupported\" | \"permission-denied\" | \"no-camera\" | \"in-use\" | \"insecure\" | \"unknown\";\n\n/** A classified camera error with a human-readable, English message. */\nexport interface CameraStreamError {\n    kind: CameraStreamErrorKind;\n    message: string;\n}\n\n/** Options for {@link useCameraStream}. */\nexport interface UseCameraStreamOptions {\n    /**\n     * Constraints passed to `getUserMedia`. Defaults to the rear\n     * (\"environment\") camera at Full-HD ideal resolution with audio off.\n     * Read when the stream (re)starts — change it and call `retry()` to apply.\n     */\n    constraints?: MediaStreamConstraints;\n}\n\n/** Value returned by {@link useCameraStream}. */\nexport interface UseCameraStreamApi {\n    /** Current lifecycle status. */\n    status: CameraStreamStatus;\n    /** The classified error, or `null` while not in the `error` status. */\n    error: CameraStreamError | null;\n    /** Attach to a `<video ref={…} />`. The stream is wired to it once ready. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /** Manually re-attempt after an error (e.g. the user changed permissions). */\n    retry: () => void;\n}\n\n/** Rear-camera Full-HD defaults used when no `constraints` are supplied. */\nconst DEFAULT_CONSTRAINTS: MediaStreamConstraints = {\n    video: {\n        facingMode: { ideal: \"environment\" },\n        width: { ideal: 1920 },\n        height: { ideal: 1080 },\n    },\n    audio: false,\n};\n\n/**\n * Map an unknown failure into a {@link CameraStreamError}. Secure-context and\n * environment checks run first (they are the reason `getUserMedia` is missing\n * or rejects), then the `DOMException.name` is mapped to a stable `kind`.\n */\nfunction classifyError(err: unknown): CameraStreamError {\n    if (typeof window === \"undefined\") {\n        return { kind: \"unsupported\", message: \"Camera is unavailable in this environment.\" };\n    }\n    if (!window.isSecureContext) {\n        return {\n            kind: \"insecure\",\n            message: \"Camera access requires a secure (HTTPS) connection.\",\n        };\n    }\n    if (err instanceof DOMException) {\n        switch (err.name) {\n            case \"NotAllowedError\":\n            case \"SecurityError\":\n                return {\n                    kind: \"permission-denied\",\n                    message: \"Camera permission denied. Enable access in your browser settings.\",\n                };\n            case \"NotFoundError\":\n            case \"OverconstrainedError\":\n                return {\n                    kind: \"no-camera\",\n                    message: \"No camera available on this device.\",\n                };\n            case \"NotReadableError\":\n            case \"AbortError\":\n                return {\n                    kind: \"in-use\",\n                    message: \"The camera is in use by another app. Close it and try again.\",\n                };\n        }\n    }\n    return {\n        kind: \"unknown\",\n        message:\n            err instanceof Error ? err.message : \"Unexpected error while accessing the camera.\",\n    };\n}\n\n/**\n * Acquire a `MediaStream` via `getUserMedia`, attach it to a `<video>` element,\n * and expose status/error so the page can render permission and error states.\n * The stream is automatically released on unmount or retry.\n *\n * Defaults to the rear (\"environment\") camera; desktops fall back to whatever\n * single camera they expose. Pass `options.constraints` to override.\n *\n * Implementation notes:\n * - Cleanup detaches the stream from a *snapshotted* video node, so it releases\n *   the same element it attached to even if the page remounts the `<video>`.\n * - When `getUserMedia` is missing, an insecure context is the usual cause, so\n *   the hook prefers that (actionable) error; otherwise it reports `unsupported`.\n * - `video.play()` rejections are swallowed: autoplay may be blocked, but the\n *   user gesture that opened the camera usually counts and playback resumes on\n *   the next interaction.\n *\n * @param options - optional configuration (see {@link UseCameraStreamOptions}).\n * @returns The stream status, classified error, a `videoRef` to attach, and a\n *   `retry()` to re-attempt acquisition.\n */\nexport function useCameraStream(options: UseCameraStreamOptions = {}): UseCameraStreamApi {\n    const [status, setStatus] = useState<CameraStreamStatus>(\"loading\");\n    const [error, setError] = useState<CameraStreamError | null>(null);\n    const [retryToken, setRetryToken] = useState(0);\n    const videoRef = useRef<HTMLVideoElement | null>(null);\n    const constraintsRef = useRef<MediaStreamConstraints>(\n        options.constraints ?? DEFAULT_CONSTRAINTS,\n    );\n    constraintsRef.current = options.constraints ?? DEFAULT_CONSTRAINTS;\n\n    useEffect(() => {\n        let cancelled = false;\n        let stream: MediaStream | null = null;\n        let attachedVideo: HTMLVideoElement | null = null;\n\n        async function start(): Promise<void> {\n            setStatus(\"loading\");\n            setError(null);\n\n            if (\n                typeof navigator === \"undefined\" ||\n                !navigator.mediaDevices ||\n                typeof navigator.mediaDevices.getUserMedia !== \"function\"\n            ) {\n                if (!cancelled) {\n                    setError(\n                        typeof window !== \"undefined\" && !window.isSecureContext\n                            ? classifyError(null)\n                            : {\n                                  kind: \"unsupported\",\n                                  message: \"Camera capture is not supported in this browser.\",\n                              },\n                    );\n                    setStatus(\"error\");\n                }\n                return;\n            }\n\n            try {\n                stream = await navigator.mediaDevices.getUserMedia(constraintsRef.current);\n                if (cancelled) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                const video = videoRef.current;\n                if (!video) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                attachedVideo = video;\n                video.srcObject = stream;\n                await video.play().catch(() => undefined);\n                if (!cancelled) setStatus(\"ready\");\n            } catch (err) {\n                if (!cancelled) {\n                    setError(classifyError(err));\n                    setStatus(\"error\");\n                }\n            }\n        }\n\n        void start();\n\n        return () => {\n            cancelled = true;\n            if (stream) {\n                stream.getTracks().forEach((track) => track.stop());\n            }\n            if (attachedVideo) {\n                attachedVideo.srcObject = null;\n            }\n        };\n    }, [retryToken]);\n\n    return {\n        status,\n        error,\n        videoRef,\n        retry: () => setRetryToken((n) => n + 1),\n    };\n}\n"],"mappings":"uBAsCA,IAAM,EAA8C,CAChD,MAAO,CACH,WAAY,CAAE,MAAO,aAAc,EACnC,MAAO,CAAE,MAAO,IAAK,EACrB,OAAQ,CAAE,MAAO,IAAK,CAC1B,EACA,MAAO,EACX,EAOA,SAAS,EAAc,EAAiC,CACpD,GAAI,OAAO,OAAW,IAClB,MAAO,CAAE,KAAM,cAAe,QAAS,4CAA6C,EAExF,GAAI,CAAC,OAAO,gBACR,MAAO,CACH,KAAM,WACN,QAAS,qDACb,EAEJ,GAAI,aAAe,aACf,OAAQ,EAAI,KAAZ,CACI,IAAK,kBACL,IAAK,gBACD,MAAO,CACH,KAAM,oBACN,QAAS,mEACb,EACJ,IAAK,gBACL,IAAK,uBACD,MAAO,CACH,KAAM,YACN,QAAS,qCACb,EACJ,IAAK,mBACL,IAAK,aACD,MAAO,CACH,KAAM,SACN,QAAS,8DACb,CACR,CAEJ,MAAO,CACH,KAAM,UACN,QACI,aAAe,MAAQ,EAAI,QAAU,8CAC7C,CACJ,CAuBA,SAAgB,EAAgB,EAAkC,CAAC,EAAuB,CACtF,GAAM,CAAC,EAAQ,IAAA,EAAA,EAAA,SAAA,CAA0C,SAAS,EAC5D,CAAC,EAAO,IAAA,EAAA,EAAA,SAAA,CAA+C,IAAI,EAC3D,CAAC,EAAY,IAAA,EAAA,EAAA,SAAA,CAA0B,CAAC,EACxC,GAAA,EAAA,EAAA,OAAA,CAA2C,IAAI,EAC/C,GAAA,EAAA,EAAA,OAAA,CACF,EAAQ,aAAe,CAC3B,EAmEA,MAlEA,GAAe,QAAU,EAAQ,aAAe,GAEhD,EAAA,EAAA,UAAA,KAAgB,CACZ,IAAI,EAAY,GACZ,EAA6B,KAC7B,EAAyC,KAE7C,eAAe,GAAuB,CAIlC,GAHA,EAAU,SAAS,EACnB,EAAS,IAAI,EAGT,OAAO,UAAc,KACrB,CAAC,UAAU,cACX,OAAO,UAAU,aAAa,cAAiB,WACjD,CACO,IACD,EACI,OAAO,OAAW,KAAe,CAAC,OAAO,gBACnC,EAAc,IAAI,EAClB,CACI,KAAM,cACN,QAAS,kDACb,CACV,EACA,EAAU,OAAO,GAErB,MACJ,CAEA,GAAI,CAEA,GADA,EAAS,MAAM,UAAU,aAAa,aAAa,EAAe,OAAO,EACrE,EAAW,CACX,EAAO,UAAU,CAAC,CAAC,QAAS,GAAU,EAAM,KAAK,CAAC,EAClD,MACJ,CACA,IAAM,EAAQ,EAAS,QACvB,GAAI,CAAC,EAAO,CACR,EAAO,UAAU,CAAC,CAAC,QAAS,GAAU,EAAM,KAAK,CAAC,EAClD,MACJ,CACA,EAAgB,EAChB,EAAM,UAAY,EAClB,MAAM,EAAM,KAAK,CAAC,CAAC,UAAY,IAAA,EAAS,EACnC,GAAW,EAAU,OAAO,CACrC,OAAS,EAAK,CACL,IACD,EAAS,EAAc,CAAG,CAAC,EAC3B,EAAU,OAAO,EAEzB,CACJ,CAIA,OAFA,EAAW,MAEE,CACT,EAAY,GACR,GACA,EAAO,UAAU,CAAC,CAAC,QAAS,GAAU,EAAM,KAAK,CAAC,EAElD,IACA,EAAc,UAAY,KAElC,CACJ,EAAG,CAAC,CAAU,CAAC,EAER,CACH,SACA,QACA,WACA,UAAa,EAAe,GAAM,EAAI,CAAC,CAC3C,CACJ"}

package/dist/vision/use-camera-stream.js

@@ -1,89 +1,82 @@
-import { useState as c, useRef as l, useEffect as y } from "react";
-const f = {
-  video: {
-    facingMode: { ideal: "environment" },
-    width: { ideal: 1920 },
-    height: { ideal: 1080 }
-  },
-  audio: !1
+import { useEffect as e, useRef as t, useState as n } from "react";
+//#region src/vision/use-camera-stream.ts
+var r = {
+	video: {
+		facingMode: { ideal: "environment" },
+		width: { ideal: 1920 },
+		height: { ideal: 1080 }
+	},
+	audio: !1
 };
-function m(r) {
-  if (typeof window > "u")
-    return { kind: "unsupported", message: "Camera is unavailable in this environment." };
-  if (!window.isSecureContext)
-    return {
-      kind: "insecure",
-      message: "Camera access requires a secure (HTTPS) connection."
-    };
-  if (r instanceof DOMException)
-    switch (r.name) {
-      case "NotAllowedError":
-      case "SecurityError":
-        return {
-          kind: "permission-denied",
-          message: "Camera permission denied. Enable access in your browser settings."
-        };
-      case "NotFoundError":
-      case "OverconstrainedError":
-        return {
-          kind: "no-camera",
-          message: "No camera available on this device."
-        };
-      case "NotReadableError":
-      case "AbortError":
-        return {
-          kind: "in-use",
-          message: "The camera is in use by another app. Close it and try again."
-        };
-    }
-  return {
-    kind: "unknown",
-    message: r instanceof Error ? r.message : "Unexpected error while accessing the camera."
-  };
+function i(e) {
+	if (typeof window > "u") return {
+		kind: "unsupported",
+		message: "Camera is unavailable in this environment."
+	};
+	if (!window.isSecureContext) return {
+		kind: "insecure",
+		message: "Camera access requires a secure (HTTPS) connection."
+	};
+	if (e instanceof DOMException) switch (e.name) {
+		case "NotAllowedError":
+		case "SecurityError": return {
+			kind: "permission-denied",
+			message: "Camera permission denied. Enable access in your browser settings."
+		};
+		case "NotFoundError":
+		case "OverconstrainedError": return {
+			kind: "no-camera",
+			message: "No camera available on this device."
+		};
+		case "NotReadableError":
+		case "AbortError": return {
+			kind: "in-use",
+			message: "The camera is in use by another app. Close it and try again."
+		};
+	}
+	return {
+		kind: "unknown",
+		message: e instanceof Error ? e.message : "Unexpected error while accessing the camera."
+	};
 }
-function k(r = {}) {
-  const [g, a] = c("loading"), [p, i] = c(null), [v, h] = c(0), u = l(null), d = l(
-    r.constraints ?? f
-  );
-  return d.current = r.constraints ?? f, y(() => {
-    let n = !1, t = null, s = null;
-    async function w() {
-      if (a("loading"), i(null), typeof navigator > "u" || !navigator.mediaDevices || typeof navigator.mediaDevices.getUserMedia != "function") {
-        n || (i(
-          typeof window < "u" && !window.isSecureContext ? m(null) : {
-            kind: "unsupported",
-            message: "Camera capture is not supported in this browser."
-          }
-        ), a("error"));
-        return;
-      }
-      try {
-        if (t = await navigator.mediaDevices.getUserMedia(d.current), n) {
-          t.getTracks().forEach((o) => o.stop());
-          return;
-        }
-        const e = u.current;
-        if (!e) {
-          t.getTracks().forEach((o) => o.stop());
-          return;
-        }
-        s = e, e.srcObject = t, await e.play().catch(() => {
-        }), n || a("ready");
-      } catch (e) {
-        n || (i(m(e)), a("error"));
-      }
-    }
-    return w(), () => {
-      n = !0, t && t.getTracks().forEach((e) => e.stop()), s && (s.srcObject = null);
-    };
-  }, [v]), {
-    status: g,
-    error: p,
-    videoRef: u,
-    retry: () => h((n) => n + 1)
-  };
+function a(a = {}) {
+	let [o, s] = n("loading"), [c, l] = n(null), [u, d] = n(0), f = t(null), p = t(a.constraints ?? r);
+	return p.current = a.constraints ?? r, e(() => {
+		let e = !1, t = null, n = null;
+		async function r() {
+			if (s("loading"), l(null), typeof navigator > "u" || !navigator.mediaDevices || typeof navigator.mediaDevices.getUserMedia != "function") {
+				e || (l(typeof window < "u" && !window.isSecureContext ? i(null) : {
+					kind: "unsupported",
+					message: "Camera capture is not supported in this browser."
+				}), s("error"));
+				return;
+			}
+			try {
+				if (t = await navigator.mediaDevices.getUserMedia(p.current), e) {
+					t.getTracks().forEach((e) => e.stop());
+					return;
+				}
+				let r = f.current;
+				if (!r) {
+					t.getTracks().forEach((e) => e.stop());
+					return;
+				}
+				n = r, r.srcObject = t, await r.play().catch(() => void 0), e || s("ready");
+			} catch (t) {
+				e || (l(i(t)), s("error"));
+			}
+		}
+		return r(), () => {
+			e = !0, t && t.getTracks().forEach((e) => e.stop()), n && (n.srcObject = null);
+		};
+	}, [u]), {
+		status: o,
+		error: c,
+		videoRef: f,
+		retry: () => d((e) => e + 1)
+	};
 }
-export {
-  k as useCameraStream
-};
-//# sourceMappingURL=use-camera-stream.js.map
+//#endregion
+export { a as useCameraStream };
+
+//# sourceMappingURL=use-camera-stream.js.map

package/dist/vision/use-camera-stream.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-camera-stream.js","sources":["../../src/vision/use-camera-stream.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\n\n/** Lifecycle status of the camera stream. */\nexport type CameraStreamStatus = \"idle\" | \"loading\" | \"ready\" | \"error\";\n\n/** Classified reason a camera stream could not be acquired. */\nexport type CameraStreamErrorKind =\n    | \"unsupported\"\n    | \"permission-denied\"\n    | \"no-camera\"\n    | \"in-use\"\n    | \"insecure\"\n    | \"unknown\";\n\n/** A classified camera error with a human-readable, English message. */\nexport interface CameraStreamError {\n    kind: CameraStreamErrorKind;\n    message: string;\n}\n\n/** Options for {@link useCameraStream}. */\nexport interface UseCameraStreamOptions {\n    /**\n     * Constraints passed to `getUserMedia`. Defaults to the rear\n     * (\"environment\") camera at Full-HD ideal resolution with audio off.\n     * Read when the stream (re)starts — change it and call `retry()` to apply.\n     */\n    constraints?: MediaStreamConstraints;\n}\n\n/** Value returned by {@link useCameraStream}. */\nexport interface UseCameraStreamApi {\n    /** Current lifecycle status. */\n    status: CameraStreamStatus;\n    /** The classified error, or `null` while not in the `error` status. */\n    error: CameraStreamError | null;\n    /** Attach to a `<video ref={…} />`. The stream is wired to it once ready. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /** Manually re-attempt after an error (e.g. the user changed permissions). */\n    retry: () => void;\n}\n\n/** Rear-camera Full-HD defaults used when no `constraints` are supplied. */\nconst DEFAULT_CONSTRAINTS: MediaStreamConstraints = {\n    video: {\n        facingMode: { ideal: \"environment\" },\n        width: { ideal: 1920 },\n        height: { ideal: 1080 },\n    },\n    audio: false,\n};\n\n/**\n * Map an unknown failure into a {@link CameraStreamError}. Secure-context and\n * environment checks run first (they are the reason `getUserMedia` is missing\n * or rejects), then the `DOMException.name` is mapped to a stable `kind`.\n */\nfunction classifyError(err: unknown): CameraStreamError {\n    if (typeof window === \"undefined\") {\n        return { kind: \"unsupported\", message: \"Camera is unavailable in this environment.\" };\n    }\n    if (!window.isSecureContext) {\n        return {\n            kind: \"insecure\",\n            message: \"Camera access requires a secure (HTTPS) connection.\",\n        };\n    }\n    if (err instanceof DOMException) {\n        switch (err.name) {\n            case \"NotAllowedError\":\n            case \"SecurityError\":\n                return {\n                    kind: \"permission-denied\",\n                    message: \"Camera permission denied. Enable access in your browser settings.\",\n                };\n            case \"NotFoundError\":\n            case \"OverconstrainedError\":\n                return {\n                    kind: \"no-camera\",\n                    message: \"No camera available on this device.\",\n                };\n            case \"NotReadableError\":\n            case \"AbortError\":\n                return {\n                    kind: \"in-use\",\n                    message: \"The camera is in use by another app. Close it and try again.\",\n                };\n        }\n    }\n    return {\n        kind: \"unknown\",\n        message:\n            err instanceof Error ? err.message : \"Unexpected error while accessing the camera.\",\n    };\n}\n\n/**\n * Acquire a `MediaStream` via `getUserMedia`, attach it to a `<video>` element,\n * and expose status/error so the page can render permission and error states.\n * The stream is automatically released on unmount or retry.\n *\n * Defaults to the rear (\"environment\") camera; desktops fall back to whatever\n * single camera they expose. Pass `options.constraints` to override.\n *\n * Implementation notes:\n * - Cleanup detaches the stream from a *snapshotted* video node, so it releases\n *   the same element it attached to even if the page remounts the `<video>`.\n * - When `getUserMedia` is missing, an insecure context is the usual cause, so\n *   the hook prefers that (actionable) error; otherwise it reports `unsupported`.\n * - `video.play()` rejections are swallowed: autoplay may be blocked, but the\n *   user gesture that opened the camera usually counts and playback resumes on\n *   the next interaction.\n *\n * @param options - optional configuration (see {@link UseCameraStreamOptions}).\n * @returns The stream status, classified error, a `videoRef` to attach, and a\n *   `retry()` to re-attempt acquisition.\n */\nexport function useCameraStream(options: UseCameraStreamOptions = {}): UseCameraStreamApi {\n    const [status, setStatus] = useState<CameraStreamStatus>(\"loading\");\n    const [error, setError] = useState<CameraStreamError | null>(null);\n    const [retryToken, setRetryToken] = useState(0);\n    const videoRef = useRef<HTMLVideoElement | null>(null);\n    const constraintsRef = useRef<MediaStreamConstraints>(\n        options.constraints ?? DEFAULT_CONSTRAINTS,\n    );\n    constraintsRef.current = options.constraints ?? DEFAULT_CONSTRAINTS;\n\n    useEffect(() => {\n        let cancelled = false;\n        let stream: MediaStream | null = null;\n        let attachedVideo: HTMLVideoElement | null = null;\n\n        async function start(): Promise<void> {\n            setStatus(\"loading\");\n            setError(null);\n\n            if (\n                typeof navigator === \"undefined\" ||\n                !navigator.mediaDevices ||\n                typeof navigator.mediaDevices.getUserMedia !== \"function\"\n            ) {\n                if (!cancelled) {\n                    setError(\n                        typeof window !== \"undefined\" && !window.isSecureContext\n                            ? classifyError(null)\n                            : {\n                                  kind: \"unsupported\",\n                                  message: \"Camera capture is not supported in this browser.\",\n                              },\n                    );\n                    setStatus(\"error\");\n                }\n                return;\n            }\n\n            try {\n                stream = await navigator.mediaDevices.getUserMedia(constraintsRef.current);\n                if (cancelled) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                const video = videoRef.current;\n                if (!video) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                attachedVideo = video;\n                video.srcObject = stream;\n                await video.play().catch(() => undefined);\n                if (!cancelled) setStatus(\"ready\");\n            } catch (err) {\n                if (!cancelled) {\n                    setError(classifyError(err));\n                    setStatus(\"error\");\n                }\n            }\n        }\n\n        void start();\n\n        return () => {\n            cancelled = true;\n            if (stream) {\n                stream.getTracks().forEach((track) => track.stop());\n            }\n            if (attachedVideo) {\n                attachedVideo.srcObject = null;\n            }\n        };\n    }, [retryToken]);\n\n    return {\n        status,\n        error,\n        videoRef,\n        retry: () => setRetryToken((n) => n + 1),\n    };\n}\n"],"names":["DEFAULT_CONSTRAINTS","classifyError","err","useCameraStream","options","status","setStatus","useState","error","setError","retryToken","setRetryToken","videoRef","useRef","constraintsRef","useEffect","cancelled","stream","attachedVideo","start","track","video"],"mappings":";AA2CA,MAAMA,IAA8C;AAAA,EAChD,OAAO;AAAA,IACH,YAAY,EAAE,OAAO,cAAA;AAAA,IACrB,OAAO,EAAE,OAAO,KAAA;AAAA,IAChB,QAAQ,EAAE,OAAO,KAAA;AAAA,EAAK;AAAA,EAE1B,OAAO;AACX;AAOA,SAASC,EAAcC,GAAiC;AACpD,MAAI,OAAO,SAAW;AAClB,WAAO,EAAE,MAAM,eAAe,SAAS,6CAAA;AAE3C,MAAI,CAAC,OAAO;AACR,WAAO;AAAA,MACH,MAAM;AAAA,MACN,SAAS;AAAA,IAAA;AAGjB,MAAIA,aAAe;AACf,YAAQA,EAAI,MAAA;AAAA,MACR,KAAK;AAAA,MACL,KAAK;AACD,eAAO;AAAA,UACH,MAAM;AAAA,UACN,SAAS;AAAA,QAAA;AAAA,MAEjB,KAAK;AAAA,MACL,KAAK;AACD,eAAO;AAAA,UACH,MAAM;AAAA,UACN,SAAS;AAAA,QAAA;AAAA,MAEjB,KAAK;AAAA,MACL,KAAK;AACD,eAAO;AAAA,UACH,MAAM;AAAA,UACN,SAAS;AAAA,QAAA;AAAA,IACb;AAGZ,SAAO;AAAA,IACH,MAAM;AAAA,IACN,SACIA,aAAe,QAAQA,EAAI,UAAU;AAAA,EAAA;AAEjD;AAuBO,SAASC,EAAgBC,IAAkC,IAAwB;AACtF,QAAM,CAACC,GAAQC,CAAS,IAAIC,EAA6B,SAAS,GAC5D,CAACC,GAAOC,CAAQ,IAAIF,EAAmC,IAAI,GAC3D,CAACG,GAAYC,CAAa,IAAIJ,EAAS,CAAC,GACxCK,IAAWC,EAAgC,IAAI,GAC/CC,IAAiBD;AAAA,IACnBT,EAAQ,eAAeJ;AAAA,EAAA;AAE3B,SAAAc,EAAe,UAAUV,EAAQ,eAAeJ,GAEhDe,EAAU,MAAM;AACZ,QAAIC,IAAY,IACZC,IAA6B,MAC7BC,IAAyC;AAE7C,mBAAeC,IAAuB;AAIlC,UAHAb,EAAU,SAAS,GACnBG,EAAS,IAAI,GAGT,OAAO,YAAc,OACrB,CAAC,UAAU,gBACX,OAAO,UAAU,aAAa,gBAAiB,YACjD;AACE,QAAKO,MACDP;AAAA,UACI,OAAO,SAAW,OAAe,CAAC,OAAO,kBACnCR,EAAc,IAAI,IAClB;AAAA,YACI,MAAM;AAAA,YACN,SAAS;AAAA,UAAA;AAAA,QACb,GAEVK,EAAU,OAAO;AAErB;AAAA,MACJ;AAEA,UAAI;AAEA,YADAW,IAAS,MAAM,UAAU,aAAa,aAAaH,EAAe,OAAO,GACrEE,GAAW;AACX,UAAAC,EAAO,YAAY,QAAQ,CAACG,MAAUA,EAAM,MAAM;AAClD;AAAA,QACJ;AACA,cAAMC,IAAQT,EAAS;AACvB,YAAI,CAACS,GAAO;AACR,UAAAJ,EAAO,YAAY,QAAQ,CAACG,MAAUA,EAAM,MAAM;AAClD;AAAA,QACJ;AACA,QAAAF,IAAgBG,GAChBA,EAAM,YAAYJ,GAClB,MAAMI,EAAM,KAAA,EAAO,MAAM,MAAA;AAAA,SAAe,GACnCL,KAAWV,EAAU,OAAO;AAAA,MACrC,SAASJ,GAAK;AACV,QAAKc,MACDP,EAASR,EAAcC,CAAG,CAAC,GAC3BI,EAAU,OAAO;AAAA,MAEzB;AAAA,IACJ;AAEA,WAAKa,EAAA,GAEE,MAAM;AACT,MAAAH,IAAY,IACRC,KACAA,EAAO,YAAY,QAAQ,CAACG,MAAUA,EAAM,MAAM,GAElDF,MACAA,EAAc,YAAY;AAAA,IAElC;AAAA,EACJ,GAAG,CAACR,CAAU,CAAC,GAER;AAAA,IACH,QAAAL;AAAA,IACA,OAAAG;AAAA,IACA,UAAAI;AAAA,IACA,OAAO,MAAMD,EAAc,CAAC,MAAM,IAAI,CAAC;AAAA,EAAA;AAE/C;"}
+{"version":3,"file":"use-camera-stream.js","names":[],"sources":["../../src/vision/use-camera-stream.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\n\n/** Lifecycle status of the camera stream. */\nexport type CameraStreamStatus = \"idle\" | \"loading\" | \"ready\" | \"error\";\n\n/** Classified reason a camera stream could not be acquired. */\nexport type CameraStreamErrorKind =\n    \"unsupported\" | \"permission-denied\" | \"no-camera\" | \"in-use\" | \"insecure\" | \"unknown\";\n\n/** A classified camera error with a human-readable, English message. */\nexport interface CameraStreamError {\n    kind: CameraStreamErrorKind;\n    message: string;\n}\n\n/** Options for {@link useCameraStream}. */\nexport interface UseCameraStreamOptions {\n    /**\n     * Constraints passed to `getUserMedia`. Defaults to the rear\n     * (\"environment\") camera at Full-HD ideal resolution with audio off.\n     * Read when the stream (re)starts — change it and call `retry()` to apply.\n     */\n    constraints?: MediaStreamConstraints;\n}\n\n/** Value returned by {@link useCameraStream}. */\nexport interface UseCameraStreamApi {\n    /** Current lifecycle status. */\n    status: CameraStreamStatus;\n    /** The classified error, or `null` while not in the `error` status. */\n    error: CameraStreamError | null;\n    /** Attach to a `<video ref={…} />`. The stream is wired to it once ready. */\n    videoRef: RefObject<HTMLVideoElement | null>;\n    /** Manually re-attempt after an error (e.g. the user changed permissions). */\n    retry: () => void;\n}\n\n/** Rear-camera Full-HD defaults used when no `constraints` are supplied. */\nconst DEFAULT_CONSTRAINTS: MediaStreamConstraints = {\n    video: {\n        facingMode: { ideal: \"environment\" },\n        width: { ideal: 1920 },\n        height: { ideal: 1080 },\n    },\n    audio: false,\n};\n\n/**\n * Map an unknown failure into a {@link CameraStreamError}. Secure-context and\n * environment checks run first (they are the reason `getUserMedia` is missing\n * or rejects), then the `DOMException.name` is mapped to a stable `kind`.\n */\nfunction classifyError(err: unknown): CameraStreamError {\n    if (typeof window === \"undefined\") {\n        return { kind: \"unsupported\", message: \"Camera is unavailable in this environment.\" };\n    }\n    if (!window.isSecureContext) {\n        return {\n            kind: \"insecure\",\n            message: \"Camera access requires a secure (HTTPS) connection.\",\n        };\n    }\n    if (err instanceof DOMException) {\n        switch (err.name) {\n            case \"NotAllowedError\":\n            case \"SecurityError\":\n                return {\n                    kind: \"permission-denied\",\n                    message: \"Camera permission denied. Enable access in your browser settings.\",\n                };\n            case \"NotFoundError\":\n            case \"OverconstrainedError\":\n                return {\n                    kind: \"no-camera\",\n                    message: \"No camera available on this device.\",\n                };\n            case \"NotReadableError\":\n            case \"AbortError\":\n                return {\n                    kind: \"in-use\",\n                    message: \"The camera is in use by another app. Close it and try again.\",\n                };\n        }\n    }\n    return {\n        kind: \"unknown\",\n        message:\n            err instanceof Error ? err.message : \"Unexpected error while accessing the camera.\",\n    };\n}\n\n/**\n * Acquire a `MediaStream` via `getUserMedia`, attach it to a `<video>` element,\n * and expose status/error so the page can render permission and error states.\n * The stream is automatically released on unmount or retry.\n *\n * Defaults to the rear (\"environment\") camera; desktops fall back to whatever\n * single camera they expose. Pass `options.constraints` to override.\n *\n * Implementation notes:\n * - Cleanup detaches the stream from a *snapshotted* video node, so it releases\n *   the same element it attached to even if the page remounts the `<video>`.\n * - When `getUserMedia` is missing, an insecure context is the usual cause, so\n *   the hook prefers that (actionable) error; otherwise it reports `unsupported`.\n * - `video.play()` rejections are swallowed: autoplay may be blocked, but the\n *   user gesture that opened the camera usually counts and playback resumes on\n *   the next interaction.\n *\n * @param options - optional configuration (see {@link UseCameraStreamOptions}).\n * @returns The stream status, classified error, a `videoRef` to attach, and a\n *   `retry()` to re-attempt acquisition.\n */\nexport function useCameraStream(options: UseCameraStreamOptions = {}): UseCameraStreamApi {\n    const [status, setStatus] = useState<CameraStreamStatus>(\"loading\");\n    const [error, setError] = useState<CameraStreamError | null>(null);\n    const [retryToken, setRetryToken] = useState(0);\n    const videoRef = useRef<HTMLVideoElement | null>(null);\n    const constraintsRef = useRef<MediaStreamConstraints>(\n        options.constraints ?? DEFAULT_CONSTRAINTS,\n    );\n    constraintsRef.current = options.constraints ?? DEFAULT_CONSTRAINTS;\n\n    useEffect(() => {\n        let cancelled = false;\n        let stream: MediaStream | null = null;\n        let attachedVideo: HTMLVideoElement | null = null;\n\n        async function start(): Promise<void> {\n            setStatus(\"loading\");\n            setError(null);\n\n            if (\n                typeof navigator === \"undefined\" ||\n                !navigator.mediaDevices ||\n                typeof navigator.mediaDevices.getUserMedia !== \"function\"\n            ) {\n                if (!cancelled) {\n                    setError(\n                        typeof window !== \"undefined\" && !window.isSecureContext\n                            ? classifyError(null)\n                            : {\n                                  kind: \"unsupported\",\n                                  message: \"Camera capture is not supported in this browser.\",\n                              },\n                    );\n                    setStatus(\"error\");\n                }\n                return;\n            }\n\n            try {\n                stream = await navigator.mediaDevices.getUserMedia(constraintsRef.current);\n                if (cancelled) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                const video = videoRef.current;\n                if (!video) {\n                    stream.getTracks().forEach((track) => track.stop());\n                    return;\n                }\n                attachedVideo = video;\n                video.srcObject = stream;\n                await video.play().catch(() => undefined);\n                if (!cancelled) setStatus(\"ready\");\n            } catch (err) {\n                if (!cancelled) {\n                    setError(classifyError(err));\n                    setStatus(\"error\");\n                }\n            }\n        }\n\n        void start();\n\n        return () => {\n            cancelled = true;\n            if (stream) {\n                stream.getTracks().forEach((track) => track.stop());\n            }\n            if (attachedVideo) {\n                attachedVideo.srcObject = null;\n            }\n        };\n    }, [retryToken]);\n\n    return {\n        status,\n        error,\n        videoRef,\n        retry: () => setRetryToken((n) => n + 1),\n    };\n}\n"],"mappings":";;AAsCA,IAAM,IAA8C;CAChD,OAAO;EACH,YAAY,EAAE,OAAO,cAAc;EACnC,OAAO,EAAE,OAAO,KAAK;EACrB,QAAQ,EAAE,OAAO,KAAK;CAC1B;CACA,OAAO;AACX;AAOA,SAAS,EAAc,GAAiC;CACpD,IAAI,OAAO,SAAW,KAClB,OAAO;EAAE,MAAM;EAAe,SAAS;CAA6C;CAExF,IAAI,CAAC,OAAO,iBACR,OAAO;EACH,MAAM;EACN,SAAS;CACb;CAEJ,IAAI,aAAe,cACf,QAAQ,EAAI,MAAZ;EACI,KAAK;EACL,KAAK,iBACD,OAAO;GACH,MAAM;GACN,SAAS;EACb;EACJ,KAAK;EACL,KAAK,wBACD,OAAO;GACH,MAAM;GACN,SAAS;EACb;EACJ,KAAK;EACL,KAAK,cACD,OAAO;GACH,MAAM;GACN,SAAS;EACb;CACR;CAEJ,OAAO;EACH,MAAM;EACN,SACI,aAAe,QAAQ,EAAI,UAAU;CAC7C;AACJ;AAuBA,SAAgB,EAAgB,IAAkC,CAAC,GAAuB;CACtF,IAAM,CAAC,GAAQ,KAAa,EAA6B,SAAS,GAC5D,CAAC,GAAO,KAAY,EAAmC,IAAI,GAC3D,CAAC,GAAY,KAAiB,EAAS,CAAC,GACxC,IAAW,EAAgC,IAAI,GAC/C,IAAiB,EACnB,EAAQ,eAAe,CAC3B;CAmEA,OAlEA,EAAe,UAAU,EAAQ,eAAe,GAEhD,QAAgB;EACZ,IAAI,IAAY,IACZ,IAA6B,MAC7B,IAAyC;EAE7C,eAAe,IAAuB;GAIlC,IAHA,EAAU,SAAS,GACnB,EAAS,IAAI,GAGT,OAAO,YAAc,OACrB,CAAC,UAAU,gBACX,OAAO,UAAU,aAAa,gBAAiB,YACjD;IACE,AAAK,MACD,EACI,OAAO,SAAW,OAAe,CAAC,OAAO,kBACnC,EAAc,IAAI,IAClB;KACI,MAAM;KACN,SAAS;IACb,CACV,GACA,EAAU,OAAO;IAErB;GACJ;GAEA,IAAI;IAEA,IADA,IAAS,MAAM,UAAU,aAAa,aAAa,EAAe,OAAO,GACrE,GAAW;KACX,EAAO,UAAU,CAAC,CAAC,SAAS,MAAU,EAAM,KAAK,CAAC;KAClD;IACJ;IACA,IAAM,IAAQ,EAAS;IACvB,IAAI,CAAC,GAAO;KACR,EAAO,UAAU,CAAC,CAAC,SAAS,MAAU,EAAM,KAAK,CAAC;KAClD;IACJ;IAIA,AAHA,IAAgB,GAChB,EAAM,YAAY,GAClB,MAAM,EAAM,KAAK,CAAC,CAAC,YAAY,KAAA,CAAS,GACnC,KAAW,EAAU,OAAO;GACrC,SAAS,GAAK;IACV,AAAK,MACD,EAAS,EAAc,CAAG,CAAC,GAC3B,EAAU,OAAO;GAEzB;EACJ;EAIA,OAFA,EAAW,SAEE;GAKT,AAJA,IAAY,IACR,KACA,EAAO,UAAU,CAAC,CAAC,SAAS,MAAU,EAAM,KAAK,CAAC,GAElD,MACA,EAAc,YAAY;EAElC;CACJ,GAAG,CAAC,CAAU,CAAC,GAER;EACH;EACA;EACA;EACA,aAAa,GAAe,MAAM,IAAI,CAAC;CAC3C;AACJ"}

package/dist/vision/use-live-luminance.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("react"),f=require("./luminance.cjs");function l(u,{enabled:c=!0,intervalMs:a=160}={}){const[s,d]=i.useState(0),t=i.useRef(null);return i.useEffect(()=>{if(!c||typeof window>"u")return;t.current||(t.current=document.createElement("canvas"));let e=0,o=0;const r=m=>{const n=u.current;if(!n||n.readyState<2||n.videoWidth===0){e=window.requestAnimationFrame(r);return}m-o>=a&&(o=m,d(f.computeImageLuminance(n,t.current??void 0))),e=window.requestAnimationFrame(r)};return e=window.requestAnimationFrame(r),()=>window.cancelAnimationFrame(e)},[u,c,a]),s}exports.useLiveLuminance=l;
-//# sourceMappingURL=use-live-luminance.cjs.map
+const e=require("./luminance.cjs");let t=require("react");function n(n,{enabled:r=!0,intervalMs:i=160}={}){let[a,o]=(0,t.useState)(0),s=(0,t.useRef)(null);return(0,t.useEffect)(()=>{if(!r||typeof window>`u`)return;s.current||=document.createElement(`canvas`);let t=0,a=0,c=r=>{let l=n.current;if(!l||l.readyState<2||l.videoWidth===0){t=window.requestAnimationFrame(c);return}r-a>=i&&(a=r,o(e.computeImageLuminance(l,s.current??void 0))),t=window.requestAnimationFrame(c)};return t=window.requestAnimationFrame(c),()=>window.cancelAnimationFrame(t)},[n,r,i]),a}exports.useLiveLuminance=n;
+//# sourceMappingURL=use-live-luminance.cjs.map

package/dist/vision/use-live-luminance.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"use-live-luminance.cjs","sources":["../../src/vision/use-live-luminance.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { computeImageLuminance } from \"./luminance\";\n\n/** Options for {@link useLiveLuminance}. */\nexport interface UseLiveLuminanceOptions {\n    /** When `false` the loop is paused (e.g. while a capture is in flight). Default: `true`. */\n    enabled?: boolean;\n    /** Throttle measurements in milliseconds. Default: `160` (~6 fps), plenty for UX. */\n    intervalMs?: number;\n}\n\n/**\n * Sample mean luminance from a `<video>` source on a `requestAnimationFrame`\n * loop and expose the rolling value. Sampling is throttled by `intervalMs` and\n * paused whenever `enabled` is `false` or the video is not ready yet\n * (`readyState < 2` or `videoWidth === 0`).\n *\n * One offscreen canvas is reused across frames to avoid GC pressure. Designed\n * to feed a live brightness bar / border color on a camera page.\n *\n * @param videoRef - ref to the `<video>` element to sample.\n * @param options - optional configuration (see {@link UseLiveLuminanceOptions}).\n * @returns The rolling mean luminance in `0..255` (`0` until the first sample).\n */\nexport function useLiveLuminance(\n    videoRef: RefObject<HTMLVideoElement | null>,\n    { enabled = true, intervalMs = 160 }: UseLiveLuminanceOptions = {},\n): number {\n    const [luminance, setLuminance] = useState(0);\n    const canvasRef = useRef<HTMLCanvasElement | null>(null);\n\n    useEffect(() => {\n        if (!enabled) return;\n        if (typeof window === \"undefined\") return;\n        if (!canvasRef.current) canvasRef.current = document.createElement(\"canvas\");\n\n        let rafId = 0;\n        let lastSampledAt = 0;\n\n        const tick = (timestamp: number): void => {\n            const video = videoRef.current;\n            if (!video || video.readyState < 2 || video.videoWidth === 0) {\n                rafId = window.requestAnimationFrame(tick);\n                return;\n            }\n            if (timestamp - lastSampledAt >= intervalMs) {\n                lastSampledAt = timestamp;\n                setLuminance(computeImageLuminance(video, canvasRef.current ?? undefined));\n            }\n            rafId = window.requestAnimationFrame(tick);\n        };\n\n        rafId = window.requestAnimationFrame(tick);\n        return () => window.cancelAnimationFrame(rafId);\n    }, [videoRef, enabled, intervalMs]);\n\n    return luminance;\n}\n"],"names":["useLiveLuminance","videoRef","enabled","intervalMs","luminance","setLuminance","useState","canvasRef","useRef","useEffect","rafId","lastSampledAt","tick","timestamp","video","computeImageLuminance"],"mappings":"sIAwBO,SAASA,EACZC,EACA,CAAE,QAAAC,EAAU,GAAM,WAAAC,EAAa,GAAA,EAAiC,GAC1D,CACN,KAAM,CAACC,EAAWC,CAAY,EAAIC,EAAAA,SAAS,CAAC,EACtCC,EAAYC,EAAAA,OAAiC,IAAI,EAEvDC,OAAAA,EAAAA,UAAU,IAAM,CAEZ,GADI,CAACP,GACD,OAAO,OAAW,IAAa,OAC9BK,EAAU,YAAmB,QAAU,SAAS,cAAc,QAAQ,GAE3E,IAAIG,EAAQ,EACRC,EAAgB,EAEpB,MAAMC,EAAQC,GAA4B,CACtC,MAAMC,EAAQb,EAAS,QACvB,GAAI,CAACa,GAASA,EAAM,WAAa,GAAKA,EAAM,aAAe,EAAG,CAC1DJ,EAAQ,OAAO,sBAAsBE,CAAI,EACzC,MACJ,CACIC,EAAYF,GAAiBR,IAC7BQ,EAAgBE,EAChBR,EAAaU,EAAAA,sBAAsBD,EAAOP,EAAU,SAAW,MAAS,CAAC,GAE7EG,EAAQ,OAAO,sBAAsBE,CAAI,CAC7C,EAEA,OAAAF,EAAQ,OAAO,sBAAsBE,CAAI,EAClC,IAAM,OAAO,qBAAqBF,CAAK,CAClD,EAAG,CAACT,EAAUC,EAASC,CAAU,CAAC,EAE3BC,CACX"}
+{"version":3,"file":"use-live-luminance.cjs","names":[],"sources":["../../src/vision/use-live-luminance.ts"],"sourcesContent":["import { useEffect, useRef, useState, type RefObject } from \"react\";\nimport { computeImageLuminance } from \"./luminance\";\n\n/** Options for {@link useLiveLuminance}. */\nexport interface UseLiveLuminanceOptions {\n    /** When `false` the loop is paused (e.g. while a capture is in flight). Default: `true`. */\n    enabled?: boolean;\n    /** Throttle measurements in milliseconds. Default: `160` (~6 fps), plenty for UX. */\n    intervalMs?: number;\n}\n\n/**\n * Sample mean luminance from a `<video>` source on a `requestAnimationFrame`\n * loop and expose the rolling value. Sampling is throttled by `intervalMs` and\n * paused whenever `enabled` is `false` or the video is not ready yet\n * (`readyState < 2` or `videoWidth === 0`).\n *\n * One offscreen canvas is reused across frames to avoid GC pressure. Designed\n * to feed a live brightness bar / border color on a camera page.\n *\n * @param videoRef - ref to the `<video>` element to sample.\n * @param options - optional configuration (see {@link UseLiveLuminanceOptions}).\n * @returns The rolling mean luminance in `0..255` (`0` until the first sample).\n */\nexport function useLiveLuminance(\n    videoRef: RefObject<HTMLVideoElement | null>,\n    { enabled = true, intervalMs = 160 }: UseLiveLuminanceOptions = {},\n): number {\n    const [luminance, setLuminance] = useState(0);\n    const canvasRef = useRef<HTMLCanvasElement | null>(null);\n\n    useEffect(() => {\n        if (!enabled) return;\n        if (typeof window === \"undefined\") return;\n        if (!canvasRef.current) canvasRef.current = document.createElement(\"canvas\");\n\n        let rafId = 0;\n        let lastSampledAt = 0;\n\n        const tick = (timestamp: number): void => {\n            const video = videoRef.current;\n            if (!video || video.readyState < 2 || video.videoWidth === 0) {\n                rafId = window.requestAnimationFrame(tick);\n                return;\n            }\n            if (timestamp - lastSampledAt >= intervalMs) {\n                lastSampledAt = timestamp;\n                setLuminance(computeImageLuminance(video, canvasRef.current ?? undefined));\n            }\n            rafId = window.requestAnimationFrame(tick);\n        };\n\n        rafId = window.requestAnimationFrame(tick);\n        return () => window.cancelAnimationFrame(rafId);\n    }, [videoRef, enabled, intervalMs]);\n\n    return luminance;\n}\n"],"mappings":"0DAwBA,SAAgB,EACZ,EACA,CAAE,UAAU,GAAM,aAAa,KAAiC,CAAC,EAC3D,CACN,GAAM,CAAC,EAAW,IAAA,EAAA,EAAA,SAAA,CAAyB,CAAC,EACtC,GAAA,EAAA,EAAA,OAAA,CAA6C,IAAI,EA2BvD,OAzBA,EAAA,EAAA,UAAA,KAAgB,CAEZ,GADI,CAAC,GACD,OAAO,OAAW,IAAa,OACnC,AAAwB,EAAU,UAAU,SAAS,cAAc,QAAQ,EAE3E,IAAI,EAAQ,EACR,EAAgB,EAEd,EAAQ,GAA4B,CACtC,IAAM,EAAQ,EAAS,QACvB,GAAI,CAAC,GAAS,EAAM,WAAa,GAAK,EAAM,aAAe,EAAG,CAC1D,EAAQ,OAAO,sBAAsB,CAAI,EACzC,MACJ,CACI,EAAY,GAAiB,IAC7B,EAAgB,EAChB,EAAa,EAAA,sBAAsB,EAAO,EAAU,SAAW,IAAA,EAAS,CAAC,GAE7E,EAAQ,OAAO,sBAAsB,CAAI,CAC7C,EAGA,MADA,GAAQ,OAAO,sBAAsB,CAAI,MAC5B,OAAO,qBAAqB,CAAK,CAClD,EAAG,CAAC,EAAU,EAAS,CAAU,CAAC,EAE3B,CACX"}