tempest-react-sdk 0.22.0 → 0.24.0

package/dist/vision/tasks/segmenter.js

@@ -0,0 +1,144 @@
+import { Mask as e, RGBImage as t } from "../types.js";
+import { Boxes as n, Masks as r, SegmentationResults as i } from "../results.js";
+import { resolveLabels as a } from "../labels.js";
+import { OrtSession as o } from "../core/session.js";
+import { loadImage as s } from "../io/image.js";
+import { letterbox as c, toCHW as l, toFloat32 as u, toFloat32Tensor as d } from "../preprocess/image.js";
+import { decodeYoloSeg as f } from "../postprocess/segmentation.js";
+import { VisionTask as p } from "./base.js";
+//#region src/vision/tasks/segmenter.ts
+var m = class m extends p {
+	_head;
+	_labels;
+	_names;
+	_inputSize;
+	_confThreshold;
+	_iouThreshold;
+	_maxDetections;
+	_maskThreshold;
+	constructor(e, t, n, r, i, a, o, s, c) {
+		super(e), this._head = t, this._labels = n, this._names = r, this._inputSize = i, this._confThreshold = a, this._iouThreshold = o, this._maxDetections = s, this._maskThreshold = c;
+	}
+	static async create(e, t = {}) {
+		let n = t.head ?? "yolo-seg";
+		if (n !== "yolo-seg") throw Error(`Unsupported segmenter head '${n}'. Supported: 'yolo-seg'.`);
+		let r = await o.create(e, t), i = a(t.labels ?? "coco", { numClasses: t.numClasses }), s = {};
+		for (let e = 0; e < i.length; e++) s[e] = i[e];
+		return new m(r, n, i, s, t.inputSize ?? [640, 640], t.confThreshold ?? .25, t.iouThreshold ?? .45, t.maxDetections ?? 300, t.maskThreshold ?? .5);
+	}
+	get head() {
+		return this._head;
+	}
+	get labels() {
+		return this._labels;
+	}
+	get names() {
+		return this._names;
+	}
+	get numClasses() {
+		return this._labels.length;
+	}
+	async call(e, t = {}) {
+		return this.predict(e, t);
+	}
+	async predict(e, t = {}) {
+		let n = typeof e == "string" ? e : null, r = await s(e), { tensor: a, scale: o, padLeft: c, padTop: l } = this._preprocess(r), u = await this._session.run({ [this._session.inputName]: a }), { perAnchor: d, prototypes: p } = this._splitOutputs(u), m = f(d.data, d.dims, p.data, p.dims, {
+			numClasses: this._labels.length,
+			inputWidth: this._inputSize[0],
+			inputHeight: this._inputSize[1],
+			originalWidth: r.width,
+			originalHeight: r.height,
+			padLeft: c,
+			padTop: l,
+			scale: o,
+			confThreshold: t.confThreshold ?? this._confThreshold,
+			iouThreshold: t.iouThreshold ?? this._iouThreshold,
+			maxDetections: this._maxDetections,
+			maskThreshold: this._maskThreshold
+		}), h = (t.classes === void 0 ? m : (() => {
+			let e = new Set(t.classes);
+			return m.filter((t) => e.has(t.classId));
+		})()).map((e) => this._buildResult(r, e.bbox, e.classId, e.confidence, e.mask)), g = [r.height, r.width];
+		return [new i(this._buildBoxes(h, g), this._buildMasks(h, g), h, this._names, r, g, n)];
+	}
+	_preprocess(e) {
+		let [t, n] = this._inputSize, r = c(e, t, n);
+		return {
+			tensor: d(l(u(r.image), r.image.width, r.image.height, 3), [
+				1,
+				3,
+				r.image.height,
+				r.image.width
+			]),
+			scale: r.scale,
+			padLeft: r.padLeft,
+			padTop: r.padTop
+		};
+	}
+	_splitOutputs(e) {
+		let t, n;
+		for (let r of this._session.outputNames) {
+			let i = e[r];
+			i !== void 0 && (i.dims.length === 3 && t === void 0 ? t = i : i.dims.length === 4 && n === void 0 && (n = i));
+		}
+		if (t === void 0 || n === void 0) {
+			let t = this._session.outputNames.map((t) => `${t}: ${JSON.stringify(e[t]?.dims ?? [])}`);
+			throw Error(`Segmenter expected one 3-D and one 4-D output, got [${t.join(", ")}].`);
+		}
+		return {
+			perAnchor: t,
+			prototypes: n
+		};
+	}
+	_buildResult(n, r, i, a, o) {
+		let [s, c, l, u] = r.asIntXyxy(), d = Math.max(0, s), f = Math.max(0, c), p = Math.min(n.width, l), m = Math.min(n.height, u), h, g = o;
+		if (p > d && m > f && o.data.length > 0) {
+			let r = p - d, i = m - f, a = Math.min(o.width, r), s = Math.min(o.height, i), c = new Uint8Array(a * s * 3);
+			for (let e = 0; e < s; e++) {
+				let t = ((f + e) * n.width + d) * 3, r = e * a * 3, i = e * o.width;
+				for (let e = 0; e < a; e++) if (o.data[i + e] !== 0) {
+					let i = t + e * 3, a = r + e * 3;
+					c[a] = n.data[i], c[a + 1] = n.data[i + 1], c[a + 2] = n.data[i + 2];
+				}
+			}
+			if (h = new t(c, a, s), a !== o.width || s !== o.height) {
+				let t = new Uint8Array(a * s);
+				for (let e = 0; e < s; e++) t.set(o.data.subarray(e * o.width, e * o.width + a), e * a);
+				g = new e(t, a, s);
+			}
+		} else g = new e(/* @__PURE__ */ new Uint8Array(), 0, 0), h = new t(/* @__PURE__ */ new Uint8Array(), 0, 0);
+		let _ = this._names[i] ?? `class_${i}`;
+		return {
+			classId: i,
+			className: _,
+			confidence: a,
+			bbox: r,
+			cls: i,
+			name: _,
+			conf: a,
+			box: r,
+			mask: g,
+			segmentedImage: h
+		};
+	}
+	_buildBoxes(e, t) {
+		let r = e.length, i = new Float32Array(r * 4), a = new Int32Array(r), o = new Float32Array(r);
+		for (let t = 0; t < r; t++) {
+			let n = e[t];
+			i[t * 4] = n.bbox.x1, i[t * 4 + 1] = n.bbox.y1, i[t * 4 + 2] = n.bbox.x2, i[t * 4 + 3] = n.bbox.y2, a[t] = n.classId, o[t] = n.confidence;
+		}
+		return new n(i, a, o, t);
+	}
+	_buildMasks(e, t) {
+		let n = new Float32Array(e.length * 4);
+		for (let t = 0; t < e.length; t++) {
+			let r = e[t];
+			n[t * 4] = r.bbox.x1, n[t * 4 + 1] = r.bbox.y1, n[t * 4 + 2] = r.bbox.x2, n[t * 4 + 3] = r.bbox.y2;
+		}
+		return new r(e.map((e) => e.mask), n, t);
+	}
+};
+//#endregion
+export { m as Segmenter };
+
+//# sourceMappingURL=segmenter.js.map

package/dist/vision/tasks/segmenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"segmenter.js","names":[],"sources":["../../../src/vision/tasks/segmenter.ts"],"sourcesContent":["/**\n * Instance-segmentation task using YOLO seg ONNX models (v8-seg / v11-seg / ...).\n */\n\nimport type * as ort from \"onnxruntime-web\";\n\nimport { type ModelSource, type OrtSessionOptions, OrtSession } from \"../core/session\";\nimport { type ImageInput, loadImage } from \"../io/image\";\nimport { type LabelSpec, resolveLabels } from \"../labels\";\nimport { decodeYoloSeg } from \"../postprocess/segmentation\";\nimport { letterbox, toCHW, toFloat32, toFloat32Tensor } from \"../preprocess/image\";\nimport { Boxes, Masks, SegmentationResults } from \"../results\";\nimport { VisionTask } from \"./base\";\nimport { type BoundingBox, type SegmentationResult, Mask, RGBImage } from \"../types\";\n\n/**\n * Decoder family for the segmentation head.\n *\n * - `\"yolo-seg\"`: YOLO instance-segmentation head with two outputs —\n *   `[1, 4 + nc + nm, N]` per-anchor predictions plus `[1, nm, mh, mw]`\n *   prototype masks. Covers YOLOv8-seg, v11-seg, v26-seg.\n *\n * The SDK does **not** auto-detect this — the caller is responsible for\n * picking a head that matches their export.\n */\nexport type SegmenterHead = \"yolo-seg\";\n\nexport interface SegmenterOptions extends OrtSessionOptions {\n    /**\n     * Decoder family for the segmentation head. Default `\"yolo-seg\"` covers\n     * YOLOv8-seg/v11-seg/v26-seg.\n     */\n    readonly head?: SegmenterHead;\n    /** Class label spec — see {@link resolveLabels}. Defaults to the COCO 80-class preset. */\n    readonly labels?: LabelSpec;\n    /** Number of classes — used to validate the supplied labels. */\n    readonly numClasses?: number;\n    /** Model input `[width, height]` for letterboxing. Defaults to `[640, 640]`. */\n    readonly inputSize?: readonly [number, number];\n    /** Default minimum class score to keep a candidate. */\n    readonly confThreshold?: number;\n    /** Default IoU threshold for non-maximum suppression. */\n    readonly iouThreshold?: number;\n    /** Maximum number of instances per image. */\n    readonly maxDetections?: number;\n    /** Probability cutoff applied to soft masks. Defaults to `0.5`. */\n    readonly maskThreshold?: number;\n}\n\nexport interface SegmenterPredictOptions {\n    readonly confThreshold?: number;\n    readonly iouThreshold?: number;\n    /**\n     * If set, keep only instances whose `classId` is in this list.\n     * Mirrors Ultralytics' `model.predict(img, classes=[0, 16])`.\n     */\n    readonly classes?: readonly number[];\n}\n\n/**\n * Instance segmenter for YOLO seg ONNX models (v8-seg / v11-seg / ...).\n *\n * The model is expected to expose two outputs:\n *\n * 1. `output0`: `(1, 4 + numClasses + numMaskCoefs, numAnchors)` — per-anchor\n *    predictions (boxes, class scores, mask coefficients).\n * 2. `output1`: `(1, numMaskCoefs, maskH, maskW)` — prototype masks.\n *\n * `predict()` returns `Promise<SegmentationResults[]>` (length 1 for a\n * single image), mirroring Ultralytics' API. The envelope exposes:\n *\n * - `boxes`: bulk numpy view (`xyxy`, `xywh`, `xyxyn`, `xywhn`, `cls`, `conf`).\n * - `masks`: per-instance binary masks cropped to each box.\n * - per-instance {@link SegmentationResult} via iteration.\n *\n * @example\n * ```typescript\n * const seg = await Segmenter.create(\"/models/yolov8n-seg.onnx\");\n * const r = (await seg.predict(\"/images/street.jpg\"))[0];\n * for (const inst of r) {\n *   console.log(inst.cls, inst.conf, inst.box.xyxy);\n * }\n * ```\n */\nexport class Segmenter extends VisionTask {\n    private constructor(\n        session: OrtSession,\n        private readonly _head: SegmenterHead,\n        private readonly _labels: readonly string[],\n        private readonly _names: Readonly<Record<number, string>>,\n        private readonly _inputSize: readonly [number, number],\n        private readonly _confThreshold: number,\n        private readonly _iouThreshold: number,\n        private readonly _maxDetections: number,\n        private readonly _maskThreshold: number,\n    ) {\n        super(session);\n    }\n\n    /** Load the model and resolve labels. */\n    static async create(model: ModelSource, options: SegmenterOptions = {}): Promise<Segmenter> {\n        const head: SegmenterHead = options.head ?? \"yolo-seg\";\n        if (head !== \"yolo-seg\") {\n            throw new Error(`Unsupported segmenter head '${head}'. Supported: 'yolo-seg'.`);\n        }\n        const session = await OrtSession.create(model, options);\n        const labels = resolveLabels(options.labels ?? \"coco\", {\n            numClasses: options.numClasses,\n        });\n        const names: Record<number, string> = {};\n        for (let i = 0; i < labels.length; i++) {\n            names[i] = labels[i] as string;\n        }\n        return new Segmenter(\n            session,\n            head,\n            labels,\n            names,\n            options.inputSize ?? [640, 640],\n            options.confThreshold ?? 0.25,\n            options.iouThreshold ?? 0.45,\n            options.maxDetections ?? 300,\n            options.maskThreshold ?? 0.5,\n        );\n    }\n\n    /** The decoder family used to interpret the model's output. */\n    get head(): SegmenterHead {\n        return this._head;\n    }\n\n    /** Class labels indexed by class id. */\n    get labels(): readonly string[] {\n        return this._labels;\n    }\n\n    /** Class id → class name dict (matches Ultralytics' `model.names`). */\n    get names(): Readonly<Record<number, string>> {\n        return this._names;\n    }\n\n    /** Number of classes the model predicts. */\n    get numClasses(): number {\n        return this._labels.length;\n    }\n\n    /** Alias for {@link predict} (parity with PyTorch `nn.Module.__call__`). */\n    async call(\n        image: ImageInput,\n        options: SegmenterPredictOptions = {},\n    ): Promise<SegmentationResults[]> {\n        return this.predict(image, options);\n    }\n\n    /** Run instance segmentation on a single image. */\n    async predict(\n        image: ImageInput,\n        options: SegmenterPredictOptions = {},\n    ): Promise<SegmentationResults[]> {\n        const path = typeof image === \"string\" ? image : null;\n        const original = await loadImage(image);\n        const { tensor, scale, padLeft, padTop } = this._preprocess(original);\n        const outputs = await this._session.run({ [this._session.inputName]: tensor });\n\n        const { perAnchor, prototypes } = this._splitOutputs(outputs);\n\n        const decodedAll = decodeYoloSeg(\n            perAnchor.data as Float32Array,\n            perAnchor.dims,\n            prototypes.data as Float32Array,\n            prototypes.dims,\n            {\n                numClasses: this._labels.length,\n                inputWidth: this._inputSize[0],\n                inputHeight: this._inputSize[1],\n                originalWidth: original.width,\n                originalHeight: original.height,\n                padLeft,\n                padTop,\n                scale,\n                confThreshold: options.confThreshold ?? this._confThreshold,\n                iouThreshold: options.iouThreshold ?? this._iouThreshold,\n                maxDetections: this._maxDetections,\n                maskThreshold: this._maskThreshold,\n            },\n        );\n\n        const decoded =\n            options.classes !== undefined\n                ? (() => {\n                      const allowed = new Set(options.classes);\n                      return decodedAll.filter((d) => allowed.has(d.classId));\n                  })()\n                : decodedAll;\n\n        const detections = decoded.map((d) =>\n            this._buildResult(original, d.bbox, d.classId, d.confidence, d.mask),\n        );\n\n        const orig: readonly [number, number] = [original.height, original.width];\n        return [\n            new SegmentationResults(\n                this._buildBoxes(detections, orig),\n                this._buildMasks(detections, orig),\n                detections,\n                this._names,\n                original,\n                orig,\n                path,\n            ),\n        ];\n    }\n\n    private _preprocess(image: RGBImage): {\n        tensor: ort.Tensor;\n        scale: number;\n        padLeft: number;\n        padTop: number;\n    } {\n        const [tw, th] = this._inputSize;\n        const lb = letterbox(image, tw, th);\n        const f32 = toFloat32(lb.image);\n        const chw = toCHW(f32, lb.image.width, lb.image.height, 3);\n        return {\n            tensor: toFloat32Tensor(chw, [1, 3, lb.image.height, lb.image.width]),\n            scale: lb.scale,\n            padLeft: lb.padLeft,\n            padTop: lb.padTop,\n        };\n    }\n\n    private _splitOutputs(outputs: Record<string, ort.Tensor>): {\n        perAnchor: ort.Tensor;\n        prototypes: ort.Tensor;\n    } {\n        let perAnchor: ort.Tensor | undefined;\n        let prototypes: ort.Tensor | undefined;\n        for (const name of this._session.outputNames) {\n            const t = outputs[name];\n            if (t === undefined) continue;\n            if (t.dims.length === 3 && perAnchor === undefined) {\n                perAnchor = t;\n            } else if (t.dims.length === 4 && prototypes === undefined) {\n                prototypes = t;\n            }\n        }\n        if (perAnchor === undefined || prototypes === undefined) {\n            const shapes = this._session.outputNames.map(\n                (n) => `${n}: ${JSON.stringify(outputs[n]?.dims ?? [])}`,\n            );\n            throw new Error(\n                `Segmenter expected one 3-D and one 4-D output, got [${shapes.join(\", \")}].`,\n            );\n        }\n        return { perAnchor, prototypes };\n    }\n\n    private _buildResult(\n        original: RGBImage,\n        bbox: BoundingBox,\n        classId: number,\n        confidence: number,\n        mask: Mask,\n    ): SegmentationResult {\n        const [x1, y1, x2, y2] = bbox.asIntXyxy();\n        const cx1 = Math.max(0, x1);\n        const cy1 = Math.max(0, y1);\n        const cx2 = Math.min(original.width, x2);\n        const cy2 = Math.min(original.height, y2);\n\n        let segmentedImage: RGBImage;\n        let finalMask = mask;\n        if (cx2 > cx1 && cy2 > cy1 && mask.data.length > 0) {\n            const cropW = cx2 - cx1;\n            const cropH = cy2 - cy1;\n            const mw = Math.min(mask.width, cropW);\n            const mh = Math.min(mask.height, cropH);\n            const segData = new Uint8Array(mw * mh * 3);\n            for (let row = 0; row < mh; row++) {\n                const srcRowOffset = ((cy1 + row) * original.width + cx1) * 3;\n                const dstRowOffset = row * mw * 3;\n                const maskRowOffset = row * mask.width;\n                for (let col = 0; col < mw; col++) {\n                    const m = mask.data[maskRowOffset + col];\n                    if (m !== 0) {\n                        const s = srcRowOffset + col * 3;\n                        const d = dstRowOffset + col * 3;\n                        segData[d] = original.data[s];\n                        segData[d + 1] = original.data[s + 1];\n                        segData[d + 2] = original.data[s + 2];\n                    }\n                }\n            }\n            segmentedImage = new RGBImage(segData, mw, mh);\n            if (mw !== mask.width || mh !== mask.height) {\n                const trimmed = new Uint8Array(mw * mh);\n                for (let row = 0; row < mh; row++) {\n                    trimmed.set(\n                        mask.data.subarray(row * mask.width, row * mask.width + mw),\n                        row * mw,\n                    );\n                }\n                finalMask = new Mask(trimmed, mw, mh);\n            }\n        } else {\n            finalMask = new Mask(new Uint8Array(0), 0, 0);\n            segmentedImage = new RGBImage(new Uint8Array(0), 0, 0);\n        }\n\n        const className = this._names[classId] ?? `class_${classId}`;\n\n        return {\n            classId,\n            className,\n            confidence,\n            bbox,\n            cls: classId,\n            name: className,\n            conf: confidence,\n            box: bbox,\n            mask: finalMask,\n            segmentedImage,\n        };\n    }\n\n    private _buildBoxes(\n        detections: readonly SegmentationResult[],\n        origShape: readonly [number, number],\n    ): Boxes {\n        const n = detections.length;\n        const xyxy = new Float32Array(n * 4);\n        const cls = new Int32Array(n);\n        const conf = new Float32Array(n);\n        for (let i = 0; i < n; i++) {\n            const d = detections[i] as SegmentationResult;\n            xyxy[i * 4] = d.bbox.x1;\n            xyxy[i * 4 + 1] = d.bbox.y1;\n            xyxy[i * 4 + 2] = d.bbox.x2;\n            xyxy[i * 4 + 3] = d.bbox.y2;\n            cls[i] = d.classId;\n            conf[i] = d.confidence;\n        }\n        return new Boxes(xyxy, cls, conf, origShape);\n    }\n\n    private _buildMasks(\n        detections: readonly SegmentationResult[],\n        origShape: readonly [number, number],\n    ): Masks {\n        const xyxy = new Float32Array(detections.length * 4);\n        for (let i = 0; i < detections.length; i++) {\n            const d = detections[i] as SegmentationResult;\n            xyxy[i * 4] = d.bbox.x1;\n            xyxy[i * 4 + 1] = d.bbox.y1;\n            xyxy[i * 4 + 2] = d.bbox.x2;\n            xyxy[i * 4 + 3] = d.bbox.y2;\n        }\n        return new Masks(\n            detections.map((d) => d.mask),\n            xyxy,\n            origShape,\n        );\n    }\n}\n"],"mappings":"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"}

package/dist/vision/types.cjs

@@ -0,0 +1,2 @@
+const e=require("./core/exceptions.cjs");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.ImageLoadError(`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.ImageLoadError(`Mask data length ${t.length} does not match width * height = ${n*r}.`)}};exports.BoundingBox=n,exports.Mask=r,exports.RGBImage=t;
+//# sourceMappingURL=types.cjs.map

package/dist/vision/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","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":"yCAqBA,IAAa,EAAb,KAAsB,CAEE,KACA,MACA,OAHpB,YACI,EACA,EACA,EACF,CACE,GAJgB,KAAA,KAAA,EACA,KAAA,MAAA,EACA,KAAA,OAAA,EAEZ,EAAK,SAAW,EAAQ,EAAS,EACjC,MAAM,IAAI,EAAA,eACN,wBAAwB,EAAK,OAAO,uCAChC,EAAQ,EAAS,EACpB,EACL,CAER,CACJ,EASa,EAAb,KAAyB,CAED,GACA,GACA,GACA,GAJpB,YACI,EACA,EACA,EACA,EACF,CAJkB,KAAA,GAAA,EACA,KAAA,GAAA,EACA,KAAA,GAAA,EACA,KAAA,GAAA,CACjB,CAGH,IAAI,OAAgB,CAChB,OAAO,KAAK,IAAI,EAAG,KAAK,GAAK,KAAK,EAAE,CACxC,CAGA,IAAI,QAAiB,CACjB,OAAO,KAAK,IAAI,EAAG,KAAK,GAAK,KAAK,EAAE,CACxC,CAGA,IAAI,MAAe,CACf,OAAO,KAAK,MAAQ,KAAK,MAC7B,CAGA,IAAI,MAAkD,CAClD,MAAO,CAAC,KAAK,GAAI,KAAK,GAAI,KAAK,GAAI,KAAK,EAAE,CAC9C,CAQA,IAAI,MAAkD,CAClD,MAAO,EAAE,KAAK,GAAK,KAAK,IAAM,GAAI,KAAK,GAAK,KAAK,IAAM,EAAG,KAAK,MAAO,KAAK,MAAM,CACrF,CAOA,MAAM,EAAiF,CACnF,GAAM,CAAC,EAAG,GAAK,EAEf,OADI,GAAK,GAAK,GAAK,EAAU,CAAC,EAAG,EAAG,EAAG,CAAC,EACjC,CAAC,KAAK,GAAK,EAAG,KAAK,GAAK,EAAG,KAAK,GAAK,EAAG,KAAK,GAAK,CAAC,CAC9D,CAOA,MAAM,EAAiF,CACnF,GAAM,CAAC,EAAG,GAAK,EACf,GAAI,GAAK,GAAK,GAAK,EAAG,MAAO,CAAC,EAAG,EAAG,EAAG,CAAC,EACxC,GAAM,CAAC,EAAI,EAAI,EAAI,GAAM,KAAK,KAC9B,MAAO,CAAC,EAAK,EAAG,EAAK,EAAG,EAAK,EAAG,EAAK,CAAC,CAC1C,CAGA,QAAoD,CAChD,MAAO,CAAC,KAAK,GAAI,KAAK,GAAI,KAAK,GAAI,KAAK,EAAE,CAC9C,CAQA,QAAoD,CAChD,MAAO,CAAC,KAAK,GAAI,KAAK,GAAI,KAAK,MAAO,KAAK,MAAM,CACrD,CAGA,WAAuD,CACnD,MAAO,CAAC,KAAK,MAAM,KAAK,EAAE,EAAG,KAAK,MAAM,KAAK,EAAE,EAAG,KAAK,MAAM,KAAK,EAAE,EAAG,KAAK,MAAM,KAAK,EAAE,CAAC,CAC9F,CACJ,EAyEa,EAAb,KAAkB,CAEM,KACA,MACA,OAHpB,YACI,EACA,EACA,EACF,CACE,GAJgB,KAAA,KAAA,EACA,KAAA,MAAA,EACA,KAAA,OAAA,EAEZ,EAAK,SAAW,EAAQ,EACxB,MAAM,IAAI,EAAA,eACN,oBAAoB,EAAK,OAAO,mCAC5B,EAAQ,EACX,EACL,CAER,CACJ"}

package/dist/vision/types.js

@@ -0,0 +1,108 @@
+import { ImageLoadError as e } from "./core/exceptions.js";
+//#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}.`);
+	}
+};
+//#endregion
+export { n as BoundingBox, r as Mask, t as RGBImage };
+
+//# sourceMappingURL=types.js.map

package/dist/vision/types.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,82 @@
+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 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 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)
+	};
+}
+//#endregion
+export { a as useCameraStream };
+
+//# sourceMappingURL=use-camera-stream.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,27 @@
+import { computeImageLuminance as e } from "./luminance.js";
+import { useEffect as t, useRef as n, useState as r } from "react";
+//#region src/vision/use-live-luminance.ts
+function i(i, { enabled: a = !0, intervalMs: o = 160 } = {}) {
+	let [s, c] = r(0), l = n(null);
+	return t(() => {
+		if (!a || typeof window > "u") return;
+		l.current ||= document.createElement("canvas");
+		let t = 0, n = 0, r = (a) => {
+			let s = i.current;
+			if (!s || s.readyState < 2 || s.videoWidth === 0) {
+				t = window.requestAnimationFrame(r);
+				return;
+			}
+			a - n >= o && (n = a, c(e(s, l.current ?? void 0))), t = window.requestAnimationFrame(r);
+		};
+		return t = window.requestAnimationFrame(r), () => window.cancelAnimationFrame(t);
+	}, [
+		i,
+		a,
+		o
+	]), s;
+}
+//#endregion
+export { i as useLiveLuminance };
+
+//# sourceMappingURL=use-live-luminance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-live-luminance.js","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":";;;AAwBA,SAAgB,EACZ,GACA,EAAE,aAAU,IAAM,gBAAa,QAAiC,CAAC,GAC3D;CACN,IAAM,CAAC,GAAW,KAAgB,EAAS,CAAC,GACtC,IAAY,EAAiC,IAAI;CA2BvD,OAzBA,QAAgB;EAEZ,IADI,CAAC,KACD,OAAO,SAAW,KAAa;EACnC,AAAwB,EAAU,YAAU,SAAS,cAAc,QAAQ;EAE3E,IAAI,IAAQ,GACR,IAAgB,GAEd,KAAQ,MAA4B;GACtC,IAAM,IAAQ,EAAS;GACvB,IAAI,CAAC,KAAS,EAAM,aAAa,KAAK,EAAM,eAAe,GAAG;IAC1D,IAAQ,OAAO,sBAAsB,CAAI;IACzC;GACJ;GAKA,AAJI,IAAY,KAAiB,MAC7B,IAAgB,GAChB,EAAa,EAAsB,GAAO,EAAU,WAAW,KAAA,CAAS,CAAC,IAE7E,IAAQ,OAAO,sBAAsB,CAAI;EAC7C;EAGA,OADA,IAAQ,OAAO,sBAAsB,CAAI,SAC5B,OAAO,qBAAqB,CAAK;CAClD,GAAG;EAAC;EAAU;EAAS;CAAU,CAAC,GAE3B;AACX"}

package/dist/vision.cjs

@@ -1,2 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const O=require("react"),qt=require("onnxruntime-web");function Qt(o){const t=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(o){for(const e in o)if(e!=="default"){const s=Object.getOwnPropertyDescriptor(o,e);Object.defineProperty(t,e,s.get?s:{enumerable:!0,get:()=>o[e]})}}return t.default=o,Object.freeze(t)}const Q=Qt(qt);class B extends Error{constructor(t,e){super(t,e),this.name=new.target.name}}class Ct extends B{}class at extends B{}class Wt extends B{}class T extends B{}class j extends B{}class F{constructor(t,e,s){if(this.data=t,this.width=e,this.height=s,t.length!==e*s*3)throw new T(`RGBImage data length ${t.length} does not match width * height * 3 = ${e*s*3}.`)}data;width;height}class ht{constructor(t,e,s,n){this.x1=t,this.y1=e,this.x2=s,this.y2=n}x1;y1;x2;y2;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(t){const[e,s]=t;return s<=0||e<=0?[0,0,0,0]:[this.x1/s,this.y1/e,this.x2/s,this.y2/e]}xywhn(t){const[e,s]=t;if(s<=0||e<=0)return[0,0,0,0];const[n,r,a,i]=this.xywh;return[n/s,r/e,a/s,i/e]}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)]}}class U{constructor(t,e,s){if(this.data=t,this.width=e,this.height=s,t.length!==e*s)throw new T(`Mask data length ${t.length} does not match width * height = ${e*s}.`)}data;width;height}class dt{constructor(t,e,s,n){this.xyxy=t,this.cls=e,this.conf=s,this.origShape=n}xyxy;cls;conf;origShape;get length(){return this.cls.length}get shape(){return[this.length,4]}get xywh(){const t=new Float32Array(this.xyxy.length);for(let e=0;e<this.length;e++){const s=this.xyxy[e*4],n=this.xyxy[e*4+1],r=this.xyxy[e*4+2],a=this.xyxy[e*4+3];t[e*4]=(s+r)/2,t[e*4+1]=(n+a)/2,t[e*4+2]=r-s,t[e*4+3]=a-n}return t}get xyxyn(){const[t,e]=this.origShape,s=new Float32Array(this.xyxy.length);if(this.length===0||e<=0||t<=0)return s;for(let n=0;n<this.length;n++)s[n*4]=this.xyxy[n*4]/e,s[n*4+1]=this.xyxy[n*4+1]/t,s[n*4+2]=this.xyxy[n*4+2]/e,s[n*4+3]=this.xyxy[n*4+3]/t;return s}get xywhn(){const t=this.xywh,[e,s]=this.origShape;if(this.length===0||s<=0||e<=0)return t;for(let n=0;n<this.length;n++)t[n*4]=t[n*4]/s,t[n*4+1]=t[n*4+1]/e,t[n*4+2]=t[n*4+2]/s,t[n*4+3]=t[n*4+3]/e;return t}get data(){const t=new Float32Array(this.length*6);for(let e=0;e<this.length;e++)t[e*6]=this.xyxy[e*4],t[e*6+1]=this.xyxy[e*4+1],t[e*6+2]=this.xyxy[e*4+2],t[e*6+3]=this.xyxy[e*4+3],t[e*6+4]=this.conf[e],t[e*6+5]=this.cls[e];return t}}class kt{constructor(t){this.data=t}data;get length(){return this.data.length}get shape(){return[this.length]}get top1(){if(this.data.length===0)return 0;let t=0,e=this.data[0];for(let s=1;s<this.data.length;s++){const n=this.data[s];n>e&&(t=s,e=n)}return t}get top1conf(){return this.data.length===0?0:this.data[this.top1]}get top5(){return this._topK(5).indices}get top5conf(){return this._topK(5).values}_topK(t){const e=Math.min(t,this.data.length),s=[];for(let a=0;a<this.data.length;a++)s.push(a);s.sort((a,i)=>this.data[i]-this.data[a]);const n=new Int32Array(e),r=new Float32Array(e);for(let a=0;a<e;a++)n[a]=s[a],r[a]=this.data[s[a]];return{indices:n,values:r}}}class $t{constructor(t,e,s){this.data=t,this.xyxy=e,this.origShape=s}data;xyxy;origShape;get length(){return this.data.length}get shape(){return[this.length]}[Symbol.iterator](){return this.data[Symbol.iterator]()}}class Lt{constructor(t,e,s,n,r,a=null,i={}){this.boxes=t,this.detections=e,this.names=s,this.origImg=n,this.origShape=r,this.path=a,this.speed=i}boxes;detections;names;origImg;origShape;path;speed;get length(){return this.detections.length}get(t){return this.detections[t]}[Symbol.iterator](){return this.detections[Symbol.iterator]()}}class Nt{constructor(t,e,s,n,r,a=null,i={}){this.probs=t,this.result=e,this.names=s,this.origImg=n,this.origShape=r,this.path=a,this.speed=i}probs;result;names;origImg;origShape;path;speed;get cls(){return this.probs.top1}get conf(){return this.probs.top1conf}get name(){return this.names[this.cls]??`class_${this.cls}`}get probabilities(){return this.result.probabilities}}class Ot{constructor(t,e,s,n,r,a,i=null,c={}){this.boxes=t,this.masks=e,this.detections=s,this.names=n,this.origImg=r,this.origShape=a,this.path=i,this.speed=c}boxes;masks;detections;names;origImg;origShape;path;speed;get length(){return this.detections.length}get(t){return this.detections[t]}[Symbol.iterator](){return this.detections[Symbol.iterator]()}}const Ft=Object.freeze(["person","bicycle","car","motorcycle","airplane","bus","train","truck","boat","traffic light","fire hydrant","stop sign","parking meter","bench","bird","cat","dog","horse","sheep","cow","elephant","bear","zebra","giraffe","backpack","umbrella","handbag","tie","suitcase","frisbee","skis","snowboard","sports ball","kite","baseball bat","baseball glove","skateboard","surfboard","tennis racket","bottle","wine glass","cup","fork","knife","spoon","bowl","banana","apple","sandwich","orange","broccoli","carrot","hot dog","pizza","donut","cake","chair","couch","potted plant","bed","dining table","toilet","tv","laptop","mouse","remote","keyboard","cell phone","microwave","oven","toaster","sink","refrigerator","book","clock","vase","scissors","teddy bear","hair drier","toothbrush"]),vt={coco:Ft};function W(o,t={}){const e=Zt(o,t.numClasses);if(t.numClasses!==void 0&&e.length!==t.numClasses)throw new j(`Resolved ${e.length} labels but the model has ${t.numClasses} classes.`);return e}function Zt(o,t){if(o==null){if(t===void 0)throw new j("Cannot auto-generate labels without numClasses. Pass an explicit labels spec or numClasses.");return Array.from({length:t},(e,s)=>`class_${s}`)}if(Array.isArray(o))return[...o];if(typeof o=="string"){const e=vt[o];if(e!==void 0)return e;throw new j(`Unknown labels preset: ${JSON.stringify(o)}. Known presets: ${Object.keys(vt).join(", ")}.`)}if(typeof o=="object"){const e=o,s=Object.keys(e).map(r=>Number(r));if(s.length===0)return[];const n=Math.max(...s);return Array.from({length:n+1},(r,a)=>e[a]??`class_${a}`)}throw new j(`Unsupported labels spec type: ${typeof o}.`)}const it=["webgpu","wasm"];function Dt(o){return o===void 0?[...it]:o.length===0?[...it]:[...o]}class V{constructor(t,e){this._session=t,this.providers=e}_session;providers;static async create(t,e={}){const s=Dt(e.providers),n={...e.sessionOptions??{},executionProviders:s};let r;try{typeof t=="string"?r=await Q.InferenceSession.create(t,n):t instanceof Uint8Array?r=await Q.InferenceSession.create(t,n):r=await Q.InferenceSession.create(t,n)}catch(a){throw new Ct(`Failed to load ONNX model: ${a.message}`,{cause:a})}return new V(r,s)}get inputNames(){return this._session.inputNames}get inputName(){const t=this._session.inputNames[0];if(t===void 0)throw new at("Model has no inputs.");return t}get outputNames(){return this._session.outputNames}get raw(){return this._session}async run(t){try{return await this._session.run(t)}catch(e){throw new at(`Inference failed: ${e.message}`,{cause:e})}}}function ct(o,t){if(typeof OffscreenCanvas<"u")return new OffscreenCanvas(o,t);if(typeof document<"u"){const e=document.createElement("canvas");return e.width=o,e.height=t,e}throw new T("No canvas implementation available in this environment.")}function lt(o){const t=o.getContext("2d");if(t===null)throw new T("Failed to obtain 2D rendering context.");return t}function ut(o){const{data:t,width:e,height:s}=o;if(t.length!==e*s*4)throw new T(`Unexpected ImageData length ${t.length} for ${e}x${s} (expected ${e*s*4}).`);const n=new Uint8Array(e*s*3);for(let r=0,a=0;r<t.length;r+=4,a+=3)n[a]=t[r],n[a+1]=t[r+1],n[a+2]=t[r+2];return new F(n,e,s)}function te(o){const t=new Uint8ClampedArray(o.width*o.height*4);for(let e=0,s=0;e<o.data.length;e+=3,s+=4)t[s]=o.data[e],t[s+1]=o.data[e+1],t[s+2]=o.data[e+2],t[s+3]=255;return new ImageData(t,o.width,o.height)}async function Z(o){if(o instanceof F)return o;if(typeof ImageData<"u"&&o instanceof ImageData)return ut(o);if(typeof o=="string")return ee(o);if(typeof Blob<"u"&&o instanceof Blob)return Rt(o);if(typeof HTMLImageElement<"u"&&o instanceof HTMLImageElement)return await ne(o),P(o,o.naturalWidth,o.naturalHeight);if(typeof HTMLCanvasElement<"u"&&o instanceof HTMLCanvasElement||typeof OffscreenCanvas<"u"&&o instanceof OffscreenCanvas||typeof ImageBitmap<"u"&&o instanceof ImageBitmap)return P(o,o.width,o.height);throw new T(`Unsupported image source type: ${Object.prototype.toString.call(o)}`)}async function ee(o){let t;try{t=await fetch(o)}catch(s){throw new T(`Failed to fetch image from ${o}: ${s.message}`,{cause:s})}if(!t.ok)throw new T(`Failed to fetch image from ${o}: HTTP ${t.status} ${t.statusText}`);const e=await t.blob();return Rt(e)}async function Rt(o){let t;try{t=await createImageBitmap(o)}catch(e){throw new T(`Failed to decode image blob: ${e.message}`,{cause:e})}try{return P(t,t.width,t.height)}finally{t.close()}}function ne(o){return o.complete&&o.naturalWidth>0?Promise.resolve():new Promise((t,e)=>{const s=()=>{r(),t()},n=()=>{r(),e(new T("Failed to load HTMLImageElement (load event errored)"))},r=()=>{o.removeEventListener("load",s),o.removeEventListener("error",n)};o.addEventListener("load",s,{once:!0}),o.addEventListener("error",n,{once:!0})})}function P(o,t,e){if(t===0||e===0)throw new T(`Cannot load image with zero dimension (${t}x${e}).`);const s=ct(t,e),n=lt(s);n.drawImage(o,0,0);const r=n.getImageData(0,0,t,e);return ut(r)}function ft(o,t,e){if(t<=0||e<=0)throw new Error(`Invalid resize target ${t}x${e}.`);if(t===o.width&&e===o.height)return o;const s=ct(o.width,o.height);lt(s).putImageData(te(o),0,0);const r=ct(t,e),a=lt(r);a.imageSmoothingEnabled=!0,a.imageSmoothingQuality="high",a.drawImage(s,0,0,t,e);const i=a.getImageData(0,0,t,e);return ut(i)}function zt(o,t,e,s=1/255){const n=new Float32Array(o.data.length),r=o.data,a=t[0],i=t[1],c=t[2],l=e[0],u=e[1],d=e[2];for(let h=0;h<r.length;h+=3)n[h]=(r[h]*s-a)/l,n[h+1]=(r[h+1]*s-i)/u,n[h+2]=(r[h+2]*s-c)/d;return n}function tt(o,t=1/255){const e=new Float32Array(o.data.length),s=o.data;for(let n=0;n<s.length;n++)e[n]=s[n]*t;return e}function X(o,t,e,s=3){const n=t*e*s;if(o.length!==n)throw new Error(`toCHW: expected length ${n} for ${t}x${e}x${s}, got ${o.length}.`);const r=new Float32Array(n),a=t*e;for(let i=0;i<e;i++)for(let c=0;c<t;c++){const l=(i*t+c)*s,u=i*t+c;for(let d=0;d<s;d++)r[d*a+u]=o[l+d]}return r}function et(o,t){return new Q.Tensor("float32",o,t)}function se(o){const t=tt(o);return X(t,o.width,o.height,3)}function oe(o,t,e){if(o.length!==t*e*3)throw new Error(`fromCv2: data length ${o.length} does not match width * height * 3 = ${t*e*3}.`);const s=new Uint8Array(o.length);for(let n=0;n<o.length;n+=3)s[n]=o[n+2],s[n+1]=o[n+1],s[n+2]=o[n];return new F(s,t,e)}function re(o){const t=o.data,e=new Uint8Array(t.length);for(let s=0;s<t.length;s+=3)e[s]=t[s+2],e[s+1]=t[s+1],e[s+2]=t[s];return e}function mt(o,t,e,s=[114,114,114]){const n=Math.min(t/o.width,e/o.height),r=Math.round(o.width*n),a=Math.round(o.height*n),i=ft(o,r,a),c=new Uint8Array(t*e*3),l=s[0],u=s[1],d=s[2];for(let f=0;f<c.length;f+=3)c[f]=l,c[f+1]=u,c[f+2]=d;const h=Math.floor((t-r)/2),w=Math.floor((e-a)/2),g=r*3;for(let f=0;f<a;f++){const m=f*g,x=((w+f)*t+h)*3;c.set(i.data.subarray(m,m+g),x)}return{image:new F(c,t,e),scale:n,padLeft:h,padTop:w}}function Yt(o){const t=o.length,e=new Float32Array(t);let s=-1/0;for(let r=0;r<t;r++){const a=o[r];a>s&&(s=a)}let n=0;for(let r=0;r<t;r++){const a=Math.exp(o[r]-s);e[r]=a,n+=a}for(let r=0;r<t;r++)e[r]=e[r]/n;return e}function Ut(o,t){const e=o.length,s=t===null?e:Math.min(Math.max(0,t),e),n=new Array(e);for(let i=0;i<e;i++)n[i]=i;n.sort((i,c)=>o[c]-o[i]);const r=new Int32Array(s),a=new Float32Array(s);for(let i=0;i<s;i++){const c=n[i];r[i]=c,a[i]=o[c]}return{indices:r,values:a}}function Bt(o,t,e){const s=t.length;if(s===0)return new Int32Array(0);const n=new Float32Array(s);for(let c=0;c<s;c++){const l=o[c*4],u=o[c*4+1],d=o[c*4+2],h=o[c*4+3];n[c]=Math.max(0,d-l)*Math.max(0,h-u)}const r=new Array(s);for(let c=0;c<s;c++)r[c]=c;r.sort((c,l)=>t[l]-t[c]);const a=new Uint8Array(s),i=[];for(let c=0;c<r.length;c++){const l=r[c];if(a[l])continue;i.push(l);const u=o[l*4],d=o[l*4+1],h=o[l*4+2],w=o[l*4+3],g=n[l];for(let f=c+1;f<r.length;f++){const m=r[f];if(a[m])continue;const x=o[m*4],_=o[m*4+1],p=o[m*4+2],E=o[m*4+3],S=Math.max(u,x),M=Math.max(d,_),v=Math.min(h,p),C=Math.min(w,E),k=Math.max(0,v-S),y=Math.max(0,C-M),b=k*y,A=g+n[m]-b;(A>0?b/A:0)>e&&(a[m]=1)}}return Int32Array.from(i)}function Vt(o,t,e,s){if(t.length===0)return new Int32Array(0);const n=new Map;for(let a=0;a<e.length;a++){const i=e[a],c=n.get(i);c===void 0?n.set(i,[a]):c.push(a)}const r=[];for(const a of n.values()){const i=a.length,c=new Float32Array(i*4),l=new Float32Array(i);for(let d=0;d<i;d++){const h=a[d];c[d*4]=o[h*4],c[d*4+1]=o[h*4+1],c[d*4+2]=o[h*4+2],c[d*4+3]=o[h*4+3],l[d]=t[h]}const u=Bt(c,l,s);for(let d=0;d<u.length;d++)r.push(a[u[d]])}return r.sort((a,i)=>t[i]-t[a]),Int32Array.from(r)}function nt(o,t,e){let s=t;if(s.length===3){if(s[0]!==1)throw new Error(`decodeYoloAnchors: expected batch size 1, got ${s[0]}.`);s=[s[1],s[2]]}if(s.length!==2)throw new Error(`decodeYoloAnchors: expected 2-D output after batch removal, got dims=${JSON.stringify(t)}.`);const n=s[0],r=s[1],{numClasses:a,originalWidth:i,originalHeight:c,padLeft:l,padTop:u,scale:d,confThreshold:h,iouThreshold:w,maxDetections:g}=e;if(a<1||a+4>n)throw new Error(`decodeYoloAnchors: invalid numClasses=${a} for channels=${n}.`);if(o.length!==n*r)throw new Error(`decodeYoloAnchors: data length ${o.length} does not match channels*numAnchors=${n*r}.`);const f=[];for(let y=0;y<r;y++){let b=0,A=-1/0;for(let Y=0;Y<a;Y++){const R=o[(4+Y)*r+y];R!==void 0&&R>A&&(A=R,b=Y)}if(A<h)continue;const I=o[y],H=o[r+y],G=o[2*r+y],K=o[3*r+y];let z=I-G/2,$=H-K/2,L=I+G/2,D=H+K/2;z=(z-l)/d,$=($-u)/d,L=(L-l)/d,D=(D-u)/d,z=Math.max(0,Math.min(i,z)),$=Math.max(0,Math.min(c,$)),L=Math.max(0,Math.min(i,L)),D=Math.max(0,Math.min(c,D)),f.push({anchorIdx:y,x1:z,y1:$,x2:L,y2:D,classId:b,confidence:A})}if(f.length===0)return Mt();const m=new Float32Array(f.length*4),x=new Float32Array(f.length),_=new Int32Array(f.length);for(let y=0;y<f.length;y++){const b=f[y];m[y*4]=b.x1,m[y*4+1]=b.y1,m[y*4+2]=b.x2,m[y*4+3]=b.y2,x[y]=b.confidence,_[y]=b.classId}const p=Vt(m,x,_,w);if(p.length===0)return Mt();const E=Array.from(p).slice(0,g),S=E.length,M=new Int32Array(S),v=new Float32Array(S*4),C=new Int32Array(S),k=new Float32Array(S);for(let y=0;y<S;y++){const b=f[E[y]];M[y]=b.anchorIdx,v[y*4]=b.x1,v[y*4+1]=b.y1,v[y*4+2]=b.x2,v[y*4+3]=b.y2,C[y]=b.classId,k[y]=b.confidence}return{anchorIndices:M,boxesXyxy:v,classIds:C,confidences:k}}function Mt(){return{anchorIndices:new Int32Array(0),boxesXyxy:new Float32Array(0),classIds:new Int32Array(0),confidences:new Float32Array(0)}}function yt(o,t,e){const s=t.length===3?t[1]:t[0];if(s===void 0||s<5)throw new Error(`decodeYolo: invalid output channel count ${s} (expected >= 5).`);const n=s-4,r=nt(o,t,{numClasses:n,...e}),a=[];for(let i=0;i<r.classIds.length;i++)a.push({bbox:new ht(r.boxesXyxy[i*4],r.boxesXyxy[i*4+1],r.boxesXyxy[i*4+2],r.boxesXyxy[i*4+3]),classId:r.classIds[i],confidence:r.confidences[i]});return a}let St=!1,At=!1;function ae(o,t,e){return St||(St=!0,console.warn("[@ort-vision-sdk/web] decodeYoloV8 is deprecated since 0.2.0; use decodeYolo. The alias will be removed in 0.3.0.")),yt(o,t,e)}function ie(o,t,e){return At||(At=!0,console.warn("[@ort-vision-sdk/web] decodeYoloV8Anchors is deprecated since 0.2.0; use decodeYoloAnchors. The alias will be removed in 0.3.0.")),nt(o,t,e)}function wt(o,t,e,s,n){let r=s;if(r.length===4){if(r[0]!==1)throw new Error(`decodeYoloSeg: expected batch size 1 in prototypes, got ${r[0]}.`);r=[r[1],r[2],r[3]]}if(r.length!==3)throw new Error(`decodeYoloSeg: expected 3-D prototypes after batch removal, got dims=${JSON.stringify(s)}.`);const a=r[0],i=r[1],c=r[2],l=t.length===3?t[1]:t[0],u=t.length===3?t[2]:t[1];if(l===void 0||u===void 0)throw new Error(`decodeYoloSeg: cannot read channels/numAnchors from dims=${JSON.stringify(t)}.`);const d=4+n.numClasses+a;if(l!==d)throw new Error(`decodeYoloSeg: channels=${l} does not match 4 + numClasses(${n.numClasses}) + numMaskCoefs(${a}) = ${d}.`);if(e.length!==a*i*c)throw new Error(`decodeYoloSeg: prototype length ${e.length} does not match dims=${JSON.stringify(s)}.`);const h=nt(o,t,{numClasses:n.numClasses,originalWidth:n.originalWidth,originalHeight:n.originalHeight,padLeft:n.padLeft,padTop:n.padTop,scale:n.scale,confThreshold:n.confThreshold,iouThreshold:n.iouThreshold,maxDetections:n.maxDetections});if(h.anchorIndices.length===0)return[];const w=n.maskThreshold??.5,g=c/n.inputWidth,f=i/n.inputHeight,m=i*c,x=(4+n.numClasses)*u,_=[];for(let p=0;p<h.anchorIndices.length;p++){const E=h.anchorIndices[p],S=h.boxesXyxy[p*4],M=h.boxesXyxy[p*4+1],v=h.boxesXyxy[p*4+2],C=h.boxesXyxy[p*4+3],k=new ht(S,M,v,C),y=h.classIds[p],b=h.confidences[p],A=Math.max(0,Math.trunc(v)-Math.trunc(S)),I=Math.max(0,Math.trunc(C)-Math.trunc(M));if(A===0||I===0){_.push({bbox:k,classId:y,confidence:b,mask:new U(new Uint8Array(0),0,0)});continue}const H=S*n.scale+n.padLeft,G=M*n.scale+n.padTop,K=v*n.scale+n.padLeft,z=C*n.scale+n.padTop,$=Math.max(0,Math.floor(H*g)),L=Math.max(0,Math.floor(G*f)),D=Math.min(c,Math.ceil(K*g)),Y=Math.min(i,Math.ceil(z*f));if(D<=$||Y<=L){_.push({bbox:k,classId:y,confidence:b,mask:new U(new Uint8Array(A*I),A,I)});continue}const R=D-$,ot=Y-L,bt=new Float32Array(R*ot);for(let N=0;N<ot;N++){const Ht=L+N;for(let J=0;J<R;J++){const Gt=$+J;let _t=0;for(let q=0;q<a;q++){const Kt=o[x+q*u+E],Jt=e[q*m+Ht*c+Gt];_t+=Kt*Jt}bt[N*R+J]=ce(_t)}}const Xt=he(bt,R,ot,A,I),rt=new Uint8Array(A*I);for(let N=0;N<rt.length;N++)rt[N]=Xt[N]>=w?255:0;_.push({bbox:k,classId:y,confidence:b,mask:new U(rt,A,I)})}return _}function ce(o){if(o>=0)return 1/(1+Math.exp(-o));const t=Math.exp(o);return t/(1+t)}let Et=!1;function le(o,t,e,s,n){return Et||(Et=!0,console.warn("[@ort-vision-sdk/web] decodeYoloV8Seg is deprecated since 0.2.0; use decodeYoloSeg. The alias will be removed in 0.3.0.")),wt(o,t,e,s,n)}function he(o,t,e,s,n){const r=new Float32Array(s*n);if(s===0||n===0||t===0||e===0)return r;if(s===t&&n===e)return r.set(o),r;const a=t/s,i=e/n;for(let c=0;c<n;c++){const l=(c+.5)*i-.5,u=Math.max(0,Math.floor(l)),d=Math.min(e-1,u+1),h=Math.max(0,Math.min(1,l-u));for(let w=0;w<s;w++){const g=(w+.5)*a-.5,f=Math.max(0,Math.floor(g)),m=Math.min(t-1,f+1),x=Math.max(0,Math.min(1,g-f)),_=o[u*t+f],p=o[u*t+m],E=o[d*t+f],S=o[d*t+m],M=_*(1-x)+p*x,v=E*(1-x)+S*x;r[c*s+w]=M*(1-h)+v*h}}return r}class st{constructor(t){this._session=t}_session;get session(){return this._session}}const de=[.485,.456,.406],ue=[.229,.224,.225];class gt extends st{constructor(t,e,s,n,r,a,i){super(t),this._labels=e,this._names=s,this._inputSize=n,this._mean=r,this._std=a,this._applySoftmax=i}_labels;_names;_inputSize;_mean;_std;_applySoftmax;static async create(t,e){const s=await V.create(t,e),n=W(e.labels,{numClasses:e.numClasses}),r={};for(let a=0;a<n.length;a++)r[a]=n[a];return new gt(s,n,r,e.inputSize??[224,224],e.mean??de,e.std??ue,e.applySoftmax??!0)}get labels(){return this._labels}get names(){return this._names}get numClasses(){return this._labels.length}async call(t,e={}){return this.predict(t,e)}async predict(t,e={}){const s=typeof t=="string"?t:null,n=await Z(t),r=this._preprocess(n),a=await this._session.run({[this._session.inputName]:r}),i=this._session.outputNames[0];if(i===void 0)throw new Error("Classifier model has no outputs.");const c=a[i];if(c===void 0)throw new Error(`Classifier model output ${i} missing from run() result.`);const l=this._postprocess(c.data),{indices:u,values:d}=Ut(l,e.topK??null),h=[];for(let m=0;m<u.length;m++){const x=u[m],_=this._labels[x]??`class_${x}`;h.push({classId:x,className:_,probability:d[m],cls:x,name:_,conf:d[m]})}if(h.length===0)throw new Error("Classifier produced no probabilities (empty output).");const w=h[0],g={classId:w.classId,className:w.className,confidence:w.probability,cls:w.classId,name:w.className,conf:w.probability,image:n,probabilities:h},f=[n.height,n.width];return[new Nt(new kt(l),g,this._names,n,f,s)]}_preprocess(t){const[e,s]=this._inputSize,n=ft(t,e,s),r=zt(n,this._mean,this._std),a=X(r,n.width,n.height,3);return et(a,[1,3,n.height,n.width])}_postprocess(t){return this._applySoftmax?Yt(t):new Float32Array(t)}}class pt extends st{constructor(t,e,s,n,r,a,i,c){super(t),this._head=e,this._labels=s,this._names=n,this._inputSize=r,this._confThreshold=a,this._iouThreshold=i,this._maxDetections=c}_head;_labels;_names;_inputSize;_confThreshold;_iouThreshold;_maxDetections;static async create(t,e={}){const s=e.head??"yolo";if(s!=="yolo")throw new Error(`Unsupported detector head '${s}'. Supported: 'yolo'.`);const n=await V.create(t,e),r=W(e.labels??"coco",{numClasses:e.numClasses}),a={};for(let i=0;i<r.length;i++)a[i]=r[i];return new pt(n,s,r,a,e.inputSize??[640,640],e.confThreshold??.25,e.iouThreshold??.45,e.maxDetections??300)}get head(){return this._head}get labels(){return this._labels}get names(){return this._names}get numClasses(){return this._labels.length}async call(t,e={}){return this.predict(t,e)}async predict(t,e={}){const s=typeof t=="string"?t:null,n=await Z(t),{tensor:r,scale:a,padLeft:i,padTop:c}=this._preprocess(n),l=await this._session.run({[this._session.inputName]:r}),u=this._session.outputNames[0];if(u===void 0)throw new Error("Detector model has no outputs.");const d=l[u];if(d===void 0)throw new Error(`Detector model output ${u} missing from run() result.`);const h=yt(d.data,d.dims,{originalWidth:n.width,originalHeight:n.height,padLeft:i,padTop:c,scale:a,confThreshold:e.confThreshold??this._confThreshold,iouThreshold:e.iouThreshold??this._iouThreshold,maxDetections:this._maxDetections}),g=(e.classes!==void 0?(()=>{const m=new Set(e.classes);return h.filter(x=>m.has(x.classId))})():h).map(m=>this._buildResult(n,m.bbox,m.classId,m.confidence)),f=[n.height,n.width];return[new Lt(this._buildBoxes(g,f),g,this._names,n,f,s)]}_preprocess(t){const[e,s]=this._inputSize,n=mt(t,e,s),r=tt(n.image),a=X(r,n.image.width,n.image.height,3);return{tensor:et(a,[1,3,n.image.height,n.image.width]),scale:n.scale,padLeft:n.padLeft,padTop:n.padTop}}_buildResult(t,e,s,n){const[r,a,i,c]=e.asIntXyxy(),l=Math.max(0,r),u=Math.max(0,a),d=Math.min(t.width,i),h=Math.min(t.height,c);let w;if(d>l&&h>u){const f=d-l,m=h-u,x=new Uint8Array(f*m*3);for(let _=0;_<m;_++){const p=((u+_)*t.width+l)*3;x.set(t.data.subarray(p,p+f*3),_*f*3)}w=new F(x,f,m)}else w=new F(new Uint8Array(0),0,0);const g=this._names[s]??`class_${s}`;return{classId:s,className:g,confidence:n,bbox:e,cls:s,name:g,conf:n,box:e,croppedImage:w}}_buildBoxes(t,e){const s=t.length,n=new Float32Array(s*4),r=new Int32Array(s),a=new Float32Array(s);for(let i=0;i<s;i++){const c=t[i];n[i*4]=c.bbox.x1,n[i*4+1]=c.bbox.y1,n[i*4+2]=c.bbox.x2,n[i*4+3]=c.bbox.y2,r[i]=c.classId,a[i]=c.confidence}return new dt(n,r,a,e)}}class xt extends st{constructor(t,e,s,n,r,a,i,c,l){super(t),this._head=e,this._labels=s,this._names=n,this._inputSize=r,this._confThreshold=a,this._iouThreshold=i,this._maxDetections=c,this._maskThreshold=l}_head;_labels;_names;_inputSize;_confThreshold;_iouThreshold;_maxDetections;_maskThreshold;static async create(t,e={}){const s=e.head??"yolo-seg";if(s!=="yolo-seg")throw new Error(`Unsupported segmenter head '${s}'. Supported: 'yolo-seg'.`);const n=await V.create(t,e),r=W(e.labels??"coco",{numClasses:e.numClasses}),a={};for(let i=0;i<r.length;i++)a[i]=r[i];return new xt(n,s,r,a,e.inputSize??[640,640],e.confThreshold??.25,e.iouThreshold??.45,e.maxDetections??300,e.maskThreshold??.5)}get head(){return this._head}get labels(){return this._labels}get names(){return this._names}get numClasses(){return this._labels.length}async call(t,e={}){return this.predict(t,e)}async predict(t,e={}){const s=typeof t=="string"?t:null,n=await Z(t),{tensor:r,scale:a,padLeft:i,padTop:c}=this._preprocess(n),l=await this._session.run({[this._session.inputName]:r}),{perAnchor:u,prototypes:d}=this._splitOutputs(l),h=wt(u.data,u.dims,d.data,d.dims,{numClasses:this._labels.length,inputWidth:this._inputSize[0],inputHeight:this._inputSize[1],originalWidth:n.width,originalHeight:n.height,padLeft:i,padTop:c,scale:a,confThreshold:e.confThreshold??this._confThreshold,iouThreshold:e.iouThreshold??this._iouThreshold,maxDetections:this._maxDetections,maskThreshold:this._maskThreshold}),g=(e.classes!==void 0?(()=>{const m=new Set(e.classes);return h.filter(x=>m.has(x.classId))})():h).map(m=>this._buildResult(n,m.bbox,m.classId,m.confidence,m.mask)),f=[n.height,n.width];return[new Ot(this._buildBoxes(g,f),this._buildMasks(g,f),g,this._names,n,f,s)]}_preprocess(t){const[e,s]=this._inputSize,n=mt(t,e,s),r=tt(n.image),a=X(r,n.image.width,n.image.height,3);return{tensor:et(a,[1,3,n.image.height,n.image.width]),scale:n.scale,padLeft:n.padLeft,padTop:n.padTop}}_splitOutputs(t){let e,s;for(const n of this._session.outputNames){const r=t[n];r!==void 0&&(r.dims.length===3&&e===void 0?e=r:r.dims.length===4&&s===void 0&&(s=r))}if(e===void 0||s===void 0){const n=this._session.outputNames.map(r=>`${r}: ${JSON.stringify(t[r]?.dims??[])}`);throw new Error(`Segmenter expected one 3-D and one 4-D output, got [${n.join(", ")}].`)}return{perAnchor:e,prototypes:s}}_buildResult(t,e,s,n,r){const[a,i,c,l]=e.asIntXyxy(),u=Math.max(0,a),d=Math.max(0,i),h=Math.min(t.width,c),w=Math.min(t.height,l);let g,f=r;if(h>u&&w>d&&r.data.length>0){const x=h-u,_=w-d,p=Math.min(r.width,x),E=Math.min(r.height,_),S=new Uint8Array(p*E*3);for(let M=0;M<E;M++){const v=((d+M)*t.width+u)*3,C=M*p*3,k=M*r.width;for(let y=0;y<p;y++)if(r.data[k+y]!==0){const A=v+y*3,I=C+y*3;S[I]=t.data[A],S[I+1]=t.data[A+1],S[I+2]=t.data[A+2]}}if(g=new F(S,p,E),p!==r.width||E!==r.height){const M=new Uint8Array(p*E);for(let v=0;v<E;v++)M.set(r.data.subarray(v*r.width,v*r.width+p),v*p);f=new U(M,p,E)}}else f=new U(new Uint8Array(0),0,0),g=new F(new Uint8Array(0),0,0);const m=this._names[s]??`class_${s}`;return{classId:s,className:m,confidence:n,bbox:e,cls:s,name:m,conf:n,box:e,mask:f,segmentedImage:g}}_buildBoxes(t,e){const s=t.length,n=new Float32Array(s*4),r=new Int32Array(s),a=new Float32Array(s);for(let i=0;i<s;i++){const c=t[i];n[i*4]=c.bbox.x1,n[i*4+1]=c.bbox.y1,n[i*4+2]=c.bbox.x2,n[i*4+3]=c.bbox.y2,r[i]=c.classId,a[i]=c.confidence}return new dt(n,r,a,e)}_buildMasks(t,e){const s=new Float32Array(t.length*4);for(let n=0;n<t.length;n++){const r=t[n];s[n*4]=r.bbox.x1,s[n*4+1]=r.bbox.y1,s[n*4+2]=r.bbox.x2,s[n*4+3]=r.bbox.y2}return new $t(t.map(n=>n.mask),s,e)}}const fe="0.2.1",It={video:{facingMode:{ideal:"environment"},width:{ideal:1920},height:{ideal:1080}},audio:!1};function Tt(o){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(o instanceof DOMException)switch(o.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:o instanceof Error?o.message:"Unexpected error while accessing the camera."}}function me(o={}){const[t,e]=O.useState("loading"),[s,n]=O.useState(null),[r,a]=O.useState(0),i=O.useRef(null),c=O.useRef(o.constraints??It);return c.current=o.constraints??It,O.useEffect(()=>{let l=!1,u=null,d=null;async function h(){if(e("loading"),n(null),typeof navigator>"u"||!navigator.mediaDevices||typeof navigator.mediaDevices.getUserMedia!="function"){l||(n(typeof window<"u"&&!window.isSecureContext?Tt(null):{kind:"unsupported",message:"Camera capture is not supported in this browser."}),e("error"));return}try{if(u=await navigator.mediaDevices.getUserMedia(c.current),l){u.getTracks().forEach(g=>g.stop());return}const w=i.current;if(!w){u.getTracks().forEach(g=>g.stop());return}d=w,w.srcObject=u,await w.play().catch(()=>{}),l||e("ready")}catch(w){l||(n(Tt(w)),e("error"))}}return h(),()=>{l=!0,u&&u.getTracks().forEach(w=>w.stop()),d&&(d.srcObject=null)}},[r]),{status:t,error:s,videoRef:i,retry:()=>a(l=>l+1)}}const Pt=256;function ye(o){return o instanceof HTMLVideoElement?{width:o.videoWidth,height:o.videoHeight}:o instanceof HTMLCanvasElement?{width:o.width,height:o.height}:{width:o.naturalWidth||o.width,height:o.naturalHeight||o.height}}function jt(o,t){const{width:e,height:s}=ye(o);if(e===0||s===0)return 0;const n=Math.min(1,Pt/Math.max(e,s)),r=Math.max(1,Math.round(e*n)),a=Math.max(1,Math.round(s*n)),i=t??document.createElement("canvas");i.width=r,i.height=a;const c=i.getContext("2d",{willReadFrequently:!0});if(!c)return 0;c.drawImage(o,0,0,r,a);const l=c.getImageData(0,0,r,a).data;let u=0;const d=r*a;for(let h=0;h<l.length;h+=4)u+=.2126*l[h]+.7152*l[h+1]+.0722*l[h+2];return u/d}function we(o,t){return o>=t}class ge extends Error{luminance;threshold;constructor(t,e){super("Image is too dark to analyse. Capture again in a brighter environment."),this.name="LowLuminanceError",this.luminance=t,this.threshold=e}}function pe(o,{enabled:t=!0,intervalMs:e=160}={}){const[s,n]=O.useState(0),r=O.useRef(null);return O.useEffect(()=>{if(!t||typeof window>"u")return;r.current||(r.current=document.createElement("canvas"));let a=0,i=0;const c=l=>{const u=o.current;if(!u||u.readyState<2||u.videoWidth===0){a=window.requestAnimationFrame(c);return}l-i>=e&&(i=l,n(jt(u,r.current??void 0))),a=window.requestAnimationFrame(c)};return a=window.requestAnimationFrame(c),()=>window.cancelAnimationFrame(a)},[o,t,e]),s}exports.BoundingBox=ht;exports.Boxes=dt;exports.COCO_CLASSES=Ft;exports.ClassificationResults=Nt;exports.Classifier=gt;exports.DEFAULT_PROVIDERS=it;exports.DetectionResults=Lt;exports.Detector=pt;exports.ImageLoadError=T;exports.InferenceError=at;exports.LUMINANCE_SAMPLE_MAX_EDGE=Pt;exports.LabelMapError=j;exports.LowLuminanceError=ge;exports.Mask=U;exports.Masks=$t;exports.ModelLoadError=Ct;exports.OrtSession=V;exports.OrtVisionError=B;exports.Probs=kt;exports.ProviderNotAvailableError=Wt;exports.RGBImage=F;exports.SegmentationResults=Ot;exports.Segmenter=xt;exports.VERSION=fe;exports.VisionTask=st;exports.batchedNms=Vt;exports.computeImageLuminance=jt;exports.decodeYolo=yt;exports.decodeYoloAnchors=nt;exports.decodeYoloSeg=wt;exports.decodeYoloV8=ae;exports.decodeYoloV8Anchors=ie;exports.decodeYoloV8Seg=le;exports.fromCv2=oe;exports.isLuminanceAcceptable=we;exports.letterbox=mt;exports.loadImage=Z;exports.nms=Bt;exports.normalize=zt;exports.resize=ft;exports.resolveLabels=W;exports.resolveProviders=Dt;exports.softmax=Yt;exports.toCHW=X;exports.toCv2=re;exports.toFloat32=tt;exports.toFloat32Tensor=et;exports.toTensor=se;exports.topK=Ut;exports.useCameraStream=me;exports.useLiveLuminance=pe;
-//# sourceMappingURL=vision.cjs.map
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./vision/core/exceptions.cjs"),t=require("./vision/types.cjs"),n=require("./vision/results.cjs"),r=require("./vision/labels.cjs"),i=require("./vision/core/providers.cjs"),a=require("./vision/core/session.cjs"),o=require("./vision/io/image.cjs"),s=require("./vision/preprocess/image.cjs"),c=require("./vision/postprocess/classification.cjs"),l=require("./vision/postprocess/detection.cjs"),u=require("./vision/postprocess/segmentation.cjs"),d=require("./vision/tasks/base.cjs"),f=require("./vision/tasks/classifier.cjs"),p=require("./vision/tasks/detector.cjs"),m=require("./vision/tasks/segmenter.cjs"),h=require("./vision/index.cjs"),g=require("./vision/use-camera-stream.cjs"),_=require("./vision/luminance.cjs"),v=require("./vision/use-live-luminance.cjs");exports.BoundingBox=t.BoundingBox,exports.Boxes=n.Boxes,exports.COCO_CLASSES=r.COCO_CLASSES,exports.ClassificationResults=n.ClassificationResults,exports.Classifier=f.Classifier,exports.DEFAULT_PROVIDERS=i.DEFAULT_PROVIDERS,exports.DetectionResults=n.DetectionResults,exports.Detector=p.Detector,exports.ImageLoadError=e.ImageLoadError,exports.InferenceError=e.InferenceError,exports.LUMINANCE_SAMPLE_MAX_EDGE=_.LUMINANCE_SAMPLE_MAX_EDGE,exports.LabelMapError=e.LabelMapError,exports.LowLuminanceError=_.LowLuminanceError,exports.Mask=t.Mask,exports.Masks=n.Masks,exports.ModelLoadError=e.ModelLoadError,exports.OrtSession=a.OrtSession,exports.OrtVisionError=e.OrtVisionError,exports.Probs=n.Probs,exports.ProviderNotAvailableError=e.ProviderNotAvailableError,exports.RGBImage=t.RGBImage,exports.SegmentationResults=n.SegmentationResults,exports.Segmenter=m.Segmenter,exports.VERSION=h.VERSION,exports.VisionTask=d.VisionTask,exports.batchedNms=l.batchedNms,exports.computeImageLuminance=_.computeImageLuminance,exports.decodeYolo=l.decodeYolo,exports.decodeYoloAnchors=l.decodeYoloAnchors,exports.decodeYoloSeg=u.decodeYoloSeg,exports.decodeYoloV8=l.decodeYoloV8,exports.decodeYoloV8Anchors=l.decodeYoloV8Anchors,exports.decodeYoloV8Seg=u.decodeYoloV8Seg,exports.fromCv2=s.fromCv2,exports.isLuminanceAcceptable=_.isLuminanceAcceptable,exports.letterbox=s.letterbox,exports.loadImage=o.loadImage,exports.nms=l.nms,exports.normalize=s.normalize,exports.resize=s.resize,exports.resolveLabels=r.resolveLabels,exports.resolveProviders=i.resolveProviders,exports.softmax=c.softmax,exports.toCHW=s.toCHW,exports.toCv2=s.toCv2,exports.toFloat32=s.toFloat32,exports.toFloat32Tensor=s.toFloat32Tensor,exports.toTensor=s.toTensor,exports.topK=c.topK,exports.useCameraStream=g.useCameraStream,exports.useLiveLuminance=v.useLiveLuminance;