@exige/web-scanner-sdk 0.2.24 → 0.2.26

package/dist/react.js

@@ -1,9 +1,9 @@
 "use client";
-import { b as e, g as t, h as n, j as r, o as i, s as a } from "./finder-B3kHQ2Jh.js";
-import { createContext as o, useCallback as s, useContext as c, useEffect as l, useMemo as u, useRef as d, useState as f } from "react";
-import { Fragment as p, jsx as m, jsxs as h } from "react/jsx-runtime";
+import { A as e, C as t, I as n, S as r, g as i, h as a, o, s, x as c, y as l } from "./finder-Dcg3mVJM.js";
+import { createContext as u, useCallback as d, useContext as f, useEffect as p, useMemo as ee, useRef as m, useState as h } from "react";
+import { Fragment as g, jsx as _, jsxs as v } from "react/jsx-runtime";
 //#region src/sdk/display-quad.ts
-function g(e) {
+function y(e) {
 	return [
 		e.topLeft,
 		e.topRight,
@@ -11,7 +11,7 @@ function g(e) {
 		e.bottomLeft
 	];
 }
-function _(e) {
+function b(e) {
 	let [t, n, r, i] = e;
 	return {
 		topLeft: t,
@@ -38,10 +38,10 @@ function _(e) {
 		}
 	};
 }
-function v(e) {
-	return _(g(e).map((e) => ({ ...e })));
+function x(e) {
+	return b(y(e).map((e) => ({ ...e })));
 }
-var ee = class {
+var te = class {
 	current;
 	target;
 	response;
@@ -50,11 +50,11 @@ var ee = class {
 		this.response = e.response ?? 14, this.snapDistance = e.snapDistance ?? .1;
 	}
 	setTarget(e, t, n) {
-		let r = Math.max(1, Math.hypot(t, n)), i = !this.current || g(e).some((e, t) => {
-			let n = g(this.current)[t];
+		let r = Math.max(1, Math.hypot(t, n)), i = !this.current || y(e).some((e, t) => {
+			let n = y(this.current)[t];
 			return Math.hypot(e.x - n.x, e.y - n.y) / r > this.snapDistance;
 		});
-		return this.target = v(e), i && (this.current = v(e)), {
+		return this.target = x(e), i && (this.current = x(e)), {
 			quad: this.current,
 			snapped: i
 		};
@@ -62,8 +62,8 @@ var ee = class {
 	step(e) {
 		if (!this.current || !this.target) return this.current;
 		let t = 1 - Math.exp(-this.response * Math.max(0, e) / 1e3);
-		return this.current = _(g(this.current).map((e, n) => {
-			let r = g(this.target)[n];
+		return this.current = b(y(this.current).map((e, n) => {
+			let r = y(this.target)[n];
 			return {
 				x: e.x + (r.x - e.x) * t,
 				y: e.y + (r.y - e.y) * t
@@ -76,13 +76,13 @@ var ee = class {
 	getCurrent() {
 		return this.current;
 	}
-}, y = o(null);
+}, ne = u(null);
 //#endregion
 //#region src/react/context.tsx
-function b(e) {
+function re(e) {
 	e?.startsWith("blob:") && URL.revokeObjectURL(e);
 }
-function te(e) {
+function ie(e) {
 	try {
 		let t = e.toDataURL("image/jpeg", .92);
 		return t.startsWith("data:image/") ? t : void 0;
@@ -90,272 +90,350 @@ function te(e) {
 		return;
 	}
 }
-function x({ open: n, autoCapture: o = "defaultOn", torch: c = "defaultOff", onCapture: p, onCancel: h, onError: g, onSettings: _, onFinderStatus: v, modelUrl: x, ortWasmPaths: S, detectionIntervalMs: C, apiRef: w, children: T }) {
-	let E = d(void 0), D = d(void 0), O = d(void 0), k = d(void 0), A = d({}), j = d(new ee()), M = d(!1), N = d({
-		onCapture: p,
-		onCancel: h,
-		onError: g,
-		onSettings: _,
-		onFinderStatus: v
-	}), P = d(null), [F, I] = f(null), [ne, L] = f("starting"), [R, z] = f(), [re, B] = f(), [ie, ae] = f({
+function S({ open: a, autoCapture: u = "defaultOn", captureMode: f = "auto", torch: g = "defaultOff", onCapture: v, onCancel: y, onError: b, onSettings: x, onFinderStatus: S, modelUrl: C, ortWasmPaths: w, detectionIntervalMs: T, apiRef: E, children: ae }) {
+	let D = r(f), O = m(void 0), k = m(void 0), A = m(void 0), j = m(void 0), M = m({}), N = m(new te()), P = m(!1), F = m(!1), I = m({
+		onCapture: v,
+		onCancel: y,
+		onError: b,
+		onSettings: x,
+		onFinderStatus: S
+	}), L = m(null), [R, oe] = h(null), [se, z] = h(D ? "ready" : "starting"), [B, V] = h(), [ce, H] = h(), [le, ue] = h({
 		width: 1,
 		height: 1
-	}), [oe, se] = f(), [ce, V] = f(), [le, H] = f(""), [U, ue] = f(0), [de, W] = f(), [fe, G] = f(), [pe, K] = f("idle"), [me, q] = f(), J = d(void 0), [he, ge] = f({
+	}), [de, U] = h(), [fe, W] = h(), [pe, G] = h(""), [K, me] = h(0), [he, q] = h(), [ge, J] = h(), [_e, Y] = h("idle"), [ve, ye] = h(), X = m(void 0), [be, xe] = h({
 		downloading: !1,
 		loaded: 0,
 		total: null
-	}), Y = s(() => {
-		b(J.current), J.current = void 0, q(void 0);
-	}, []), X = s((e, t) => {
-		let n = te(e);
-		b(J.current), J.current = n, q(n), t?.pause();
+	}), Z = d(() => {
+		re(X.current), X.current = void 0, ye(void 0);
+	}, []), Q = d((e, t) => {
+		let n = ie(e);
+		re(X.current), X.current = n, ye(n), t?.pause();
 	}, []);
-	l(() => {
-		N.current = {
-			onCapture: p,
-			onCancel: h,
-			onError: g,
-			onSettings: _,
-			onFinderStatus: v
+	p(() => {
+		I.current = {
+			onCapture: v,
+			onCancel: y,
+			onError: b,
+			onSettings: x,
+			onFinderStatus: S
 		};
 	}, [
-		p,
-		h,
-		g,
-		_,
-		v
-	]), l(() => r(ge), []);
-	let _e = s((e) => {
-		I(e);
+		v,
+		y,
+		b,
+		x,
+		S
+	]), p(() => n(xe), []);
+	let Se = d((e) => {
+		oe(e);
 	}, []);
-	l(() => {
-		if (!n || !F) return;
+	p(() => {
+		if (!a || !R) return;
 		let e = () => {
-			let e = F.getBoundingClientRect();
-			ae({
+			let e = R.getBoundingClientRect();
+			ue({
 				width: e.width,
 				height: e.height
 			});
 		};
 		if (e(), typeof ResizeObserver > "u") return window.addEventListener("resize", e), () => window.removeEventListener("resize", e);
 		let t = new ResizeObserver(e);
-		return t.observe(F), () => t.disconnect();
-	}, [n, F]), l(() => {
-		if (!n) return;
+		return t.observe(R), () => t.disconnect();
+	}, [a, R]), p(() => {
+		if (!a) return;
 		let e = window.setInterval(() => {
-			let e = E.current?.getDiagnostics();
-			e && W(e);
+			let e = O.current?.getDiagnostics();
+			e && q(e);
 		}, 500);
 		return () => window.clearInterval(e);
-	}, [n, U]), l(() => {
-		if (!n) return;
-		let e = 0, t = performance.now(), r = (n) => {
-			let i = j.current.step(n - t);
-			t = n, i && B(i), e = requestAnimationFrame(r);
+	}, [a, K]), p(() => {
+		if (!a) return;
+		let e = 0, t = performance.now(), n = (r) => {
+			let i = N.current.step(r - t);
+			t = r, i && H(i), e = requestAnimationFrame(n);
 		};
-		return e = requestAnimationFrame(r), () => cancelAnimationFrame(e);
-	}, [n]), l(() => {
-		if (!n || !F) return;
-		let t = !1, r = () => {
-			D.current?.stop(), D.current = void 0, E.current?.stop(), E.current = void 0, k.current = void 0, O.current = void 0, A.current = {}, Y();
+		return e = requestAnimationFrame(n), () => cancelAnimationFrame(e);
+	}, [a]), p(() => {
+		if (!a || D || !R) return;
+		let e = !1, n = () => {
+			k.current?.stop(), k.current = void 0, O.current?.stop(), O.current = void 0, j.current = void 0, A.current = void 0, M.current = {}, Z();
 		};
 		return (async () => {
-			r(), M.current = !1, L("starting"), H(""), z(void 0), V(void 0), G(void 0), K("idle"), Y();
+			n(), P.current = !1, z("starting"), G(""), V(void 0), W(void 0), J(void 0), Y("idle"), Z();
 			try {
-				let n = await e(F, { torch: c });
-				if (t) {
+				let n = await t(R, { torch: g });
+				if (e) {
 					n.stop();
 					return;
 				}
-				E.current = n;
+				O.current = n;
 				let r = n.getSettings();
-				se(r), N.current.onSettings?.(r), console.info("[ScannerProvider] camera settings", r), D.current = await a({
-					source: F,
-					autoCapture: o,
-					intervalMs: C,
+				U(r), I.current.onSettings?.(r), console.info("[ScannerProvider] camera settings", r), k.current = await s({
+					source: R,
+					autoCapture: u,
+					intervalMs: T,
 					detection: {
-						modelUrl: x,
-						ortWasmPaths: S
+						modelUrl: C,
+						ortWasmPaths: w
 					},
 					onStatus: (e) => {
-						if (O.current = e, z(e), N.current.onFinderStatus?.(e), e.quad && e.sourceWidth && e.sourceHeight) {
-							let t = j.current.setTarget(e.quad, e.sourceWidth, e.sourceHeight);
-							B(t.quad);
-						} else j.current.clear(), B(void 0);
-						e.state !== "captured" && !M.current && L("ready");
+						if (A.current = e, V(e), I.current.onFinderStatus?.(e), e.quad && e.sourceWidth && e.sourceHeight) {
+							let t = N.current.setTarget(e.quad, e.sourceWidth, e.sourceHeight);
+							H(t.quad);
+						} else N.current.clear(), H(void 0);
+						e.state !== "captured" && !P.current && z("ready");
 					},
 					captureFrame: async () => {
-						L("capturing"), A.current = {
-							quad: j.current.getCurrent(),
-							sourceWidth: O.current?.sourceWidth,
-							sourceHeight: O.current?.sourceHeight
+						z("capturing"), M.current = {
+							quad: N.current.getCurrent(),
+							sourceWidth: A.current?.sourceWidth,
+							sourceHeight: A.current?.sourceHeight
 						};
 						let e = await n.capturePhoto();
-						if (k.current = e, V(e.method), G(e.diagnostics), W(e.diagnostics), e.luminance <= 10) throw Error(`The captured frame was blank (luminance ${e.luminance.toFixed(1)} via ${e.method}). Keep the scanner visible while capturing and retake.`);
-						return X(e.frame, F), L("captured"), e.frame;
+						if (j.current = e, W(e.method), J(e.diagnostics), q(e.diagnostics), e.luminance <= 10) throw Error(`The captured frame was blank (luminance ${e.luminance.toFixed(1)} via ${e.method}). Keep the scanner visible while capturing and retake.`);
+						return Q(e.frame, R), z("captured"), e.frame;
 					},
 					onCaptureError: (e) => {
-						M.current = !0, L("error"), H(e.message);
-						let t = E.current?.getDiagnostics();
-						t && W(t), N.current.onError?.(e);
+						P.current = !0, z("error"), G(e.message);
+						let t = O.current?.getDiagnostics();
+						t && q(t), I.current.onError?.(e);
 					},
 					onCapture: async (e) => {
-						let t = k.current;
-						await new Promise((e) => window.setTimeout(e, 140)), await N.current.onCapture({
+						let t = j.current;
+						await new Promise((e) => window.setTimeout(e, 140)), await I.current.onCapture({
 							...e,
 							method: t?.method ?? "video-frame",
 							settings: t?.settings ?? n.getSettings(),
 							fallbackReason: t?.fallbackReason,
 							luminance: t?.luminance,
 							diagnostics: t?.diagnostics,
-							displayedQuad: A.current.quad,
-							displaySourceWidth: A.current.sourceWidth,
-							displaySourceHeight: A.current.sourceHeight
+							displayedQuad: M.current.quad,
+							displaySourceWidth: M.current.sourceWidth,
+							displaySourceHeight: M.current.sourceHeight
 						});
 					}
 				});
-			} catch (e) {
-				if (t) return;
-				r();
-				let n = e instanceof Error ? e : /* @__PURE__ */ Error("Camera access failed.");
-				H(n.message), L("error"), N.current.onError?.(n);
+			} catch (t) {
+				if (e) return;
+				n();
+				let r = t instanceof Error ? t : /* @__PURE__ */ Error("Camera access failed.");
+				G(r.message), z("error"), I.current.onError?.(r);
 			}
 		})(), () => {
-			t = !0, r();
+			e = !0, n();
 		};
 	}, [
-		n,
-		F,
-		o,
-		c,
-		x,
-		S,
+		a,
+		R,
+		D,
+		u,
+		g,
 		C,
-		U,
-		Y,
-		X
+		w,
+		T,
+		K,
+		Z,
+		Q
+	]), p(() => {
+		a && D && (P.current = !1, F.current = !1, z("ready"), G(""), V(void 0), W(void 0), J(void 0), Y("idle"), U(void 0), H(void 0), N.current.clear(), Z());
+	}, [
+		a,
+		D,
+		K,
+		Z
 	]);
-	let Z = {
-		open: n,
-		phase: ne,
-		autoCapture: o,
-		finderStatus: R,
-		displayQuad: re,
-		previewSize: ie,
-		settings: oe,
-		captureMethod: ce,
-		error: le,
-		diagnostics: de,
-		shutterDiagnostics: fe,
-		copyState: pe,
-		guidanceHint: R ? i(R.guidance, R.lighting) : void 0,
-		detectorStatus: R?.modelStatus === "failed" ? `ML failed${R.modelError ? `: ${R.modelError}` : ""}` : R?.detector === "ml" ? `ML ${R.modelProvider ?? ""}`.trim() : "ML loading",
-		modelDownload: he,
-		frozenPreviewUrl: me
+	let Ce = {
+		open: a,
+		phase: se,
+		autoCapture: u,
+		captureMode: f,
+		usingSystemCamera: D,
+		finderStatus: B,
+		displayQuad: ce,
+		previewSize: le,
+		settings: de,
+		captureMethod: fe,
+		error: pe,
+		diagnostics: he,
+		shutterDiagnostics: ge,
+		copyState: _e,
+		guidanceHint: B ? o(B.guidance, B.lighting) : void 0,
+		detectorStatus: B?.modelStatus === "failed" ? `ML failed${B.modelError ? `: ${B.modelError}` : ""}` : B?.detector === "ml" ? `ML ${B.modelProvider ?? ""}`.trim() : "ML loading",
+		modelDownload: be,
+		frozenPreviewUrl: ve
 	};
-	l(() => {
-		P.current = Z;
+	p(() => {
+		L.current = Ce;
 	});
-	let ve = s(() => {
-		N.current.onCancel();
-	}, []), ye = s(async () => {
+	let we = d(() => {
+		I.current.onCancel();
+	}, []), $ = d(async () => {
+		if (!F.current) {
+			F.current = !0, P.current = !1, G(""), H(void 0), N.current.clear(), z("capturing");
+			try {
+				let t = await c();
+				Q(t);
+				let n = {
+					width: t.width,
+					height: t.height
+				};
+				U(n), I.current.onSettings?.(n), W("system-camera");
+				let r;
+				try {
+					let e = t.getContext("2d", { willReadFrequently: !0 })?.getImageData(0, 0, t.width, t.height).data;
+					e && (r = l(e));
+				} catch {
+					r = void 0;
+				}
+				let i = await e(t, {
+					modelUrl: C,
+					ortWasmPaths: w
+				});
+				if (i.status !== "success" || !i.corners || !i.quad) {
+					P.current = !0, z("error"), G(i.message), I.current.onError?.(Error(i.message));
+					return;
+				}
+				M.current = {
+					quad: i.quad,
+					sourceWidth: i.sourceWidth,
+					sourceHeight: i.sourceHeight
+				}, H(i.quad), z("captured"), await I.current.onCapture({
+					frame: t,
+					detection: i,
+					reason: "manual",
+					method: "system-camera",
+					settings: n,
+					luminance: r,
+					displayedQuad: i.quad,
+					displaySourceWidth: i.sourceWidth,
+					displaySourceHeight: i.sourceHeight
+				});
+			} catch (e) {
+				let t = e instanceof Error ? e : /* @__PURE__ */ Error("Could not take a photo.");
+				if (t.message === "No photo was selected.") {
+					z("ready");
+					return;
+				}
+				P.current = !0, G(t.message), z("error"), I.current.onError?.(t);
+			} finally {
+				F.current = !1;
+			}
+		}
+	}, [
+		Q,
+		C,
+		w
+	]), Te = d(async () => {
+		if (D) {
+			await $();
+			return;
+		}
 		try {
-			await D.current?.capture();
+			await k.current?.capture();
 		} catch (e) {
 			let t = e instanceof Error ? e : /* @__PURE__ */ Error("Could not capture the camera frame.");
-			M.current = !0, H(t.message);
-			let n = E.current?.getDiagnostics();
-			n && W(n), k.current?.diagnostics && G(k.current.diagnostics), L("error"), N.current.onError?.(t);
+			P.current = !0, G(t.message);
+			let n = O.current?.getDiagnostics();
+			n && q(n), j.current?.diagnostics && J(j.current.diagnostics), z("error"), I.current.onError?.(t);
 		}
-	}, []), be = s(() => {
-		M.current = !1, H(""), G(void 0), K("idle"), Y();
-		let e = E.current;
-		F?.paused && F.play(), L(e ? "ready" : "starting"), e || ue((e) => e + 1);
-	}, [Y, F]), xe = s(async (e) => {
-		let t = E.current;
-		t && (await t.setTorch(e), W(t.getDiagnostics()));
-	}, []), Se = s((e) => {
-		D.current?.setAutoCapture(e);
-	}, []), Ce = s(async () => {
-		let e = P.current, n = E.current?.getDiagnostics() ?? e.diagnostics, r = e.finderStatus, i = t({
+	}, [$, D]), Ee = d(() => {
+		if (P.current = !1, G(""), J(void 0), Y("idle"), Z(), H(void 0), N.current.clear(), D) {
+			z("ready"), $();
+			return;
+		}
+		let e = O.current;
+		R?.paused && R.play(), z(e ? "ready" : "starting"), e || me((e) => e + 1);
+	}, [
+		$,
+		Z,
+		R,
+		D
+	]), De = d(async (e) => {
+		let t = O.current;
+		t && (await t.setTorch(e), q(t.getDiagnostics()));
+	}, []), Oe = d((e) => {
+		k.current?.setAutoCapture(e);
+	}, []), ke = d(async () => {
+		let e = L.current, t = O.current?.getDiagnostics() ?? e.diagnostics, n = e.finderStatus, r = i({
 			error: e.error || void 0,
 			captureMethod: e.captureMethod,
-			luminance: k.current?.luminance,
-			fallbackReason: k.current?.fallbackReason,
-			shutter: e.shutterDiagnostics ?? k.current?.diagnostics,
-			live: n,
-			finder: r ? {
-				state: r.state,
-				confidence: r.confidence,
-				stableFrames: r.stableFrames,
-				requiredStableFrames: r.requiredStableFrames,
-				detector: r.detector,
-				modelStatus: r.modelStatus,
-				modelError: r.modelError,
-				modelProvider: r.modelProvider,
-				modelNote: r.modelNote,
-				inferenceMs: r.inferenceMs,
-				sourceWidth: r.sourceWidth,
-				sourceHeight: r.sourceHeight
+			luminance: j.current?.luminance,
+			fallbackReason: j.current?.fallbackReason,
+			shutter: e.shutterDiagnostics ?? j.current?.diagnostics,
+			live: t,
+			finder: n ? {
+				state: n.state,
+				confidence: n.confidence,
+				stableFrames: n.stableFrames,
+				requiredStableFrames: n.requiredStableFrames,
+				detector: n.detector,
+				modelStatus: n.modelStatus,
+				modelError: n.modelError,
+				modelProvider: n.modelProvider,
+				modelNote: n.modelNote,
+				inferenceMs: n.inferenceMs,
+				sourceWidth: n.sourceWidth,
+				sourceHeight: n.sourceHeight
 			} : void 0
 		});
 		try {
-			if (navigator.clipboard?.writeText) await navigator.clipboard.writeText(i);
+			if (navigator.clipboard?.writeText) await navigator.clipboard.writeText(r);
 			else {
 				let e = document.createElement("textarea");
-				e.value = i, e.setAttribute("readonly", ""), e.style.position = "fixed", e.style.left = "-9999px", document.body.append(e), e.select();
+				e.value = r, e.setAttribute("readonly", ""), e.style.position = "fixed", e.style.left = "-9999px", document.body.append(e), e.select();
 				let t = document.execCommand("copy");
 				if (e.remove(), !t) throw Error("Clipboard copy is unavailable.");
 			}
-			K("copied");
+			Y("copied");
 		} catch {
-			K("failed");
+			Y("failed");
 		}
-	}, []), Q = s(() => P.current, []), $ = u(() => ({
-		capture: ye,
-		cancel: ve,
-		retry: be,
-		setTorch: xe,
-		setAutoCapture: Se,
-		copyReport: Ce,
-		getState: Q
+	}, []), Ae = d(() => L.current, []), je = ee(() => ({
+		capture: Te,
+		cancel: we,
+		retry: Ee,
+		setTorch: De,
+		setAutoCapture: Oe,
+		copyReport: ke,
+		getState: Ae
 	}), [
-		ye,
-		ve,
-		be,
-		xe,
-		Se,
-		Ce,
-		Q
+		Te,
+		we,
+		Ee,
+		De,
+		Oe,
+		ke,
+		Ae
 	]);
-	l(() => {
-		if (w) return w.current = $, () => {
-			w.current = null;
+	p(() => {
+		if (E) return E.current = je, () => {
+			E.current = null;
 		};
-	}, [$, w]);
-	let we = {
-		...Z,
-		...$,
-		bindPreview: _e
+	}, [je, E]);
+	let Me = {
+		...Ce,
+		...je,
+		bindPreview: Se
 	};
-	return /* @__PURE__ */ m(y.Provider, {
-		value: we,
-		children: T
+	return /* @__PURE__ */ _(ne.Provider, {
+		value: Me,
+		children: ae
 	});
 }
 //#endregion
 //#region src/react/hooks.ts
-function S() {
-	return d(null);
-}
 function C() {
-	let e = c(y);
+	return m(null);
+}
+function w() {
+	let e = f(ne);
 	if (!e) throw Error("useScanner must be used within ScannerProvider.");
 	return e;
 }
 //#endregion
 //#region src/live-overlay-geometry.ts
-function w(e, t, n, r, i) {
+function T(e, t, n, r, i) {
 	let a = Math.max(1, e), o = Math.max(1, t), s = Math.max(1, n), c = Math.max(1, r), l = s / a, u = c / o, d = i === "cover" ? Math.max(l, u) : Math.min(l, u), f = (s - a * d) / 2, p = (c - o * d) / 2;
 	if (i === "contain") return {
 		viewBox: `0 0 ${a} ${o}`,
@@ -364,9 +442,9 @@ function w(e, t, n, r, i) {
 		offsetX: f,
 		offsetY: p
 	};
-	let m = s / d, h = c / d;
+	let ee = s / d, m = c / d;
 	return {
-		viewBox: `${-f / d} ${-p / d} ${m} ${h}`,
+		viewBox: `${-f / d} ${-p / d} ${ee} ${m}`,
 		preserveAspectRatio: "none",
 		scale: d,
 		offsetX: f,
@@ -375,10 +453,10 @@ function w(e, t, n, r, i) {
 }
 //#endregion
 //#region src/components/ModelDownloadRing.tsx
-function T({ snapshot: e }) {
+function E({ snapshot: e }) {
 	if (!e.downloading) return null;
 	let t = e.total && e.total > 0 ? Math.min(1, e.loaded / e.total) : null, n = t === null ? null : Math.round(t * 100), r = 2 * Math.PI * 28;
-	return /* @__PURE__ */ h("div", {
+	return /* @__PURE__ */ v("div", {
 		className: `model-download-ring${t === null ? " is-indeterminate" : ""}`,
 		role: "progressbar",
 		"aria-label": "Model download",
@@ -387,15 +465,15 @@ function T({ snapshot: e }) {
 		"aria-valuenow": n ?? void 0,
 		"data-loaded": e.loaded,
 		"data-total": e.total ?? "",
-		children: [/* @__PURE__ */ h("svg", {
+		children: [/* @__PURE__ */ v("svg", {
 			viewBox: "0 0 72 72",
 			"aria-hidden": "true",
-			children: [/* @__PURE__ */ m("circle", {
+			children: [/* @__PURE__ */ _("circle", {
 				className: "track",
 				cx: "36",
 				cy: "36",
 				r: 28
-			}), /* @__PURE__ */ m("circle", {
+			}), /* @__PURE__ */ _("circle", {
 				className: "value",
 				cx: "36",
 				cy: "36",
@@ -403,15 +481,15 @@ function T({ snapshot: e }) {
 				strokeDasharray: t === null ? void 0 : `${r} ${r}`,
 				strokeDashoffset: t === null ? void 0 : r * (1 - t)
 			})]
-		}), n === null ? /* @__PURE__ */ m("strong", {
+		}), n === null ? /* @__PURE__ */ _("strong", {
 			className: "model-download-ring__pending",
 			children: "…"
-		}) : /* @__PURE__ */ h("strong", { children: [n, "%"] })]
+		}) : /* @__PURE__ */ v("strong", { children: [n, "%"] })]
 	});
 }
 //#endregion
 //#region src/react/parts.tsx
-var E = {
+var ae = {
 	primaryColorHex: "--scanner-overlay-primary",
 	seekingColorHex: "--scanner-overlay-seeking",
 	detectingColorHex: "--scanner-overlay-detecting",
@@ -422,36 +500,44 @@ var E = {
 function D(e) {
 	if (!e) return;
 	let t = {};
-	for (let [n, r] of Object.entries(E)) {
+	for (let [n, r] of Object.entries(ae)) {
 		let i = e[n]?.trim();
 		i && (t[r] = i);
 	}
 	return Object.keys(t).length > 0 ? t : void 0;
 }
 function O({ theme: e, style: t, title: n = "Scan a document", children: r }) {
-	let i = C();
+	let i = w();
 	if (!i.open) return null;
 	let a = D(e), o = a ? {
 		...t,
 		...a
 	} : t;
-	return /* @__PURE__ */ h("div", {
-		className: `scanner-camera-overlay ${i.finderStatus?.state === "captured" ? "is-captured" : ""}`.trim(),
+	return /* @__PURE__ */ v("div", {
+		className: `scanner-camera-overlay ${i.phase === "captured" || i.finderStatus?.state === "captured" ? "is-captured" : ""} ${i.usingSystemCamera ? "is-system-camera" : ""}`.trim(),
 		style: o,
 		role: "dialog",
 		"aria-modal": "true",
 		"aria-label": n,
-		children: [r, /* @__PURE__ */ m(I, {})]
+		children: [r, /* @__PURE__ */ _(I, {})]
 	});
 }
 function k() {
-	let { bindPreview: e, frozenPreviewUrl: t } = C(), n = d(null), r = s((t) => {
-		n.current = t, e(t);
+	let { bindPreview: e, frozenPreviewUrl: t, usingSystemCamera: n } = w(), r = m(null), i = d((t) => {
+		r.current = t, e(t);
 	}, [e]);
-	return l(() => {
-		t && n.current?.pause();
-	}, [t]), /* @__PURE__ */ h(p, { children: [/* @__PURE__ */ m("video", {
-		ref: r,
+	return p(() => {
+		t && r.current?.pause();
+	}, [t]), n ? t ? /* @__PURE__ */ _("img", {
+		src: t,
+		className: "scanner-camera-overlay__video scanner-camera-overlay__still",
+		alt: "",
+		"aria-label": "Captured document"
+	}) : /* @__PURE__ */ _("div", {
+		className: "scanner-camera-overlay__video",
+		"aria-hidden": "true"
+	}) : /* @__PURE__ */ v(g, { children: [/* @__PURE__ */ _("video", {
+		ref: i,
 		className: "scanner-camera-overlay__video",
 		muted: !0,
 		autoPlay: !0,
@@ -459,7 +545,7 @@ function k() {
 		style: { objectFit: "cover" },
 		"aria-hidden": !!t,
 		"aria-label": "Rear camera preview"
-	}), t ? /* @__PURE__ */ m("img", {
+	}), t ? /* @__PURE__ */ _("img", {
 		src: t,
 		className: "scanner-camera-overlay__video scanner-camera-overlay__still",
 		alt: "",
@@ -467,31 +553,37 @@ function k() {
 	}) : null] });
 }
 function A() {
-	let { finderStatus: e, displayQuad: t, previewSize: n } = C();
+	let { finderStatus: e, displayQuad: t, previewSize: n } = w();
 	if (!t || !e?.sourceWidth || !e.sourceHeight) return null;
-	let r = w(e.sourceWidth, e.sourceHeight, n.width, n.height, "cover");
-	return /* @__PURE__ */ m("svg", {
+	let r = T(e.sourceWidth, e.sourceHeight, n.width, n.height, "cover");
+	return /* @__PURE__ */ _("svg", {
 		className: `scanner-camera-overlay__quad ${e.state}`,
 		viewBox: r.viewBox,
 		preserveAspectRatio: r.preserveAspectRatio,
 		"aria-label": `${e.state} document boundary`,
-		children: /* @__PURE__ */ m("polygon", { points: `${t.topLeft.x},${t.topLeft.y} ${t.topRight.x},${t.topRight.y} ${t.bottomRight.x},${t.bottomRight.y} ${t.bottomLeft.x},${t.bottomLeft.y}` })
+		children: /* @__PURE__ */ _("polygon", { points: `${t.topLeft.x},${t.topLeft.y} ${t.topRight.x},${t.topRight.y} ${t.bottomRight.x},${t.bottomRight.y} ${t.bottomLeft.x},${t.bottomLeft.y}` })
 	});
 }
 function j({ title: e = "Scan a document" }) {
-	let { phase: t, guidanceHint: n, cancel: r } = C();
-	return /* @__PURE__ */ h("div", {
+	let { phase: t, guidanceHint: n, cancel: r, usingSystemCamera: i } = w();
+	return /* @__PURE__ */ v("div", {
 		className: "scanner-camera-overlay__topbar",
-		children: [/* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("strong", { children: e }), /* @__PURE__ */ h("span", {
+		children: [/* @__PURE__ */ v("div", { children: [/* @__PURE__ */ _("strong", { children: e }), /* @__PURE__ */ _("span", {
 			"aria-live": "polite",
-			children: [
+			children: i ? /* @__PURE__ */ v(g, { children: [
+				t === "starting" && "Preparing the system camera…",
+				t === "ready" && "Take a photo. There is no live document guide.",
+				t === "capturing" && "Looking for a document…",
+				t === "captured" && "Document captured",
+				t === "error" && "No document found"
+			] }) : /* @__PURE__ */ v(g, { children: [
 				t === "starting" && "Starting rear camera…",
 				t === "ready" && (n ?? "Place the document in the frame"),
 				t === "capturing" && "Capturing full resolution…",
 				t === "captured" && "Document captured",
 				t === "error" && "Camera unavailable"
-			]
-		})] }), /* @__PURE__ */ m("button", {
+			] })
+		})] }), /* @__PURE__ */ _("button", {
 			type: "button",
 			onClick: r,
 			"aria-label": "Close camera",
@@ -500,115 +592,130 @@ function j({ title: e = "Scan a document" }) {
 	});
 }
 function M() {
-	let { phase: e, error: t, diagnostics: n, copyState: r, retry: i, copyReport: a, cancel: o } = C();
-	return e === "error" ? /* @__PURE__ */ h("div", {
+	let { phase: e, error: t, diagnostics: n, copyState: r, retry: i, copyReport: a, cancel: o, usingSystemCamera: s, frozenPreviewUrl: c } = w();
+	return e === "error" ? /* @__PURE__ */ v("div", {
 		className: "scanner-camera-overlay__message",
 		role: "alert",
 		children: [
-			/* @__PURE__ */ m("strong", { children: n ? "Capture failed" : "Could not open the camera" }),
-			/* @__PURE__ */ m("p", { children: t }),
-			/* @__PURE__ */ h("div", { children: [
-				/* @__PURE__ */ m("button", {
+			/* @__PURE__ */ _("strong", { children: s ? c ? "No document found" : "Could not take a photo" : n ? "Capture failed" : "Could not open the camera" }),
+			/* @__PURE__ */ _("p", { children: t }),
+			/* @__PURE__ */ v("div", { children: [
+				/* @__PURE__ */ _("button", {
 					type: "button",
 					onClick: i,
 					children: "Try again"
 				}),
-				/* @__PURE__ */ m("button", {
+				/* @__PURE__ */ _("button", {
 					type: "button",
 					onClick: () => void a(),
 					children: r === "copied" ? "Copied" : r === "failed" ? "Copy failed" : "Copy report"
 				}),
-				/* @__PURE__ */ m("button", {
+				/* @__PURE__ */ _("button", {
 					type: "button",
 					onClick: o,
 					children: "Cancel"
 				})
 			] })
 		]
-	}) : e === "starting" ? /* @__PURE__ */ h("div", {
+	}) : s && e === "ready" && !c ? /* @__PURE__ */ v("div", {
+		className: "scanner-camera-overlay__message",
+		"aria-live": "polite",
+		children: [/* @__PURE__ */ _("strong", { children: "System camera" }), /* @__PURE__ */ _("p", { children: "Chrome cannot match Camera-app quality in a live preview. Take a photo, then we find the page in that JPEG. There is no live document guide." })]
+	}) : e === "starting" && !s ? /* @__PURE__ */ v("div", {
 		className: "scanner-camera-overlay__message",
 		"aria-live": "polite",
 		children: [
-			/* @__PURE__ */ m("span", { className: "scanner-camera-overlay__spinner" }),
-			/* @__PURE__ */ m("strong", { children: "Requesting the highest practical resolution" }),
-			/* @__PURE__ */ m("p", { children: "Allow camera access to continue." })
+			/* @__PURE__ */ _("span", { className: "scanner-camera-overlay__spinner" }),
+			/* @__PURE__ */ _("strong", { children: "Requesting the highest practical resolution" }),
+			/* @__PURE__ */ _("p", { children: "Allow camera access to continue." })
 		]
 	}) : null;
 }
 function N() {
-	let { finderStatus: e, detectorStatus: t, settings: n } = C(), r = n?.width, i = n?.height;
-	return /* @__PURE__ */ m("div", {
+	let { finderStatus: e, detectorStatus: t, settings: n, usingSystemCamera: r, captureMethod: i, phase: a } = w(), o = n?.width, s = n?.height;
+	return r ? /* @__PURE__ */ _("div", {
+		className: "scanner-camera-overlay__status",
+		"aria-live": "polite",
+		children: /* @__PURE__ */ v("div", {
+			className: "scanner-camera-overlay__status-line",
+			children: [
+				/* @__PURE__ */ _("span", { className: a === "captured" ? "ready" : a === "error" ? "seeking" : "detecting" }),
+				i === "system-camera" ? "system camera" : "system camera · waiting",
+				o && s ? ` · ${o}×${s}` : ""
+			]
+		})
+	}) : /* @__PURE__ */ _("div", {
 		className: "scanner-camera-overlay__status",
 		"aria-live": "polite",
-		children: /* @__PURE__ */ h("div", {
+		children: /* @__PURE__ */ v("div", {
 			className: "scanner-camera-overlay__status-line",
 			children: [
-				/* @__PURE__ */ m("span", { className: e?.state ?? "detecting" }),
+				/* @__PURE__ */ _("span", { className: e?.state ?? "detecting" }),
 				e?.state ?? "detecting",
 				e ? ` · ${Math.round(e.confidence * 100)}% · ${e.stableFrames}/${e.requiredStableFrames}` : "",
 				` · ${t}`,
 				e?.inferenceMs === void 0 ? "" : ` · ${Math.round(e.inferenceMs)}ms`,
-				r && i ? ` · ${r}×${i}` : ""
+				o && s ? ` · ${o}×${s}` : ""
 			]
 		})
 	});
 }
 function P() {
-	let { diagnostics: e, shutterDiagnostics: t, captureMethod: r, copyState: i, copyReport: a } = C(), o = e?.engine ?? n();
-	return /* @__PURE__ */ h("dl", {
+	let { diagnostics: e, shutterDiagnostics: t, captureMethod: n, copyState: r, copyReport: i } = w(), o = e?.engine ?? a();
+	return /* @__PURE__ */ v("dl", {
 		className: "scanner-camera-overlay__diagnostics",
 		"aria-label": "Camera diagnostics",
 		children: [
-			/* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("dt", { children: "engine" }), /* @__PURE__ */ h("dd", { children: [
+			/* @__PURE__ */ v("div", { children: [/* @__PURE__ */ _("dt", { children: "engine" }), /* @__PURE__ */ v("dd", { children: [
 				o.engine,
 				"/",
 				o.browser,
 				o.iosWebKit ? " ios" : ""
 			] })] }),
-			/* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("dt", { children: "video" }), /* @__PURE__ */ m("dd", { children: e ? `${e.videoWidth}×${e.videoHeight} rs${e.readyState}${e.paused ? " paused" : ""}${e.rendered ? "" : " hidden"}` : "starting" })] }),
-			/* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("dt", { children: "track" }), /* @__PURE__ */ m("dd", { children: e ? `${e.trackReadyState}${e.trackMuted ? " muted" : ""}${e.trackEnabled ? "" : " disabled"}` : "—" })] }),
-			/* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("dt", { children: "torch" }), /* @__PURE__ */ m("dd", { children: e ? `${e.torch.mode} · ${e.torch.supported ? e.torch.on ? "on" : "off" : "unsupported"}` : "starting" })] }),
-			/* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("dt", { children: "luma" }), /* @__PURE__ */ m("dd", { children: e ? `live ${e.liveLuminance.toFixed(1)} · mirror ${e.mirrorLuminance.toFixed(1)}${Number.isFinite(e.mirrorAgeMs) ? ` (${Math.round(e.mirrorAgeMs)}ms)` : " (none)"}` : "—" })] }),
-			/* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("dt", { children: "path" }), /* @__PURE__ */ m("dd", { children: r ?? "video-frame / live-mirror" })] }),
-			t ? /* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("dt", { children: "shutter" }), /* @__PURE__ */ m("dd", { children: `live ${t.liveLuminance.toFixed(1)} · mirror ${t.mirrorLuminance.toFixed(1)}${Number.isFinite(t.mirrorAgeMs) ? ` (${Math.round(t.mirrorAgeMs)}ms)` : " (none)"}` })] }) : null,
-			/* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("dt", { children: "share" }), /* @__PURE__ */ m("dd", { children: /* @__PURE__ */ m("button", {
+			/* @__PURE__ */ v("div", { children: [/* @__PURE__ */ _("dt", { children: "video" }), /* @__PURE__ */ _("dd", { children: e ? `${e.videoWidth}×${e.videoHeight} rs${e.readyState}${e.paused ? " paused" : ""}${e.rendered ? "" : " hidden"}` : "starting" })] }),
+			/* @__PURE__ */ v("div", { children: [/* @__PURE__ */ _("dt", { children: "track" }), /* @__PURE__ */ _("dd", { children: e ? `${e.trackReadyState}${e.trackMuted ? " muted" : ""}${e.trackEnabled ? "" : " disabled"}` : "—" })] }),
+			/* @__PURE__ */ v("div", { children: [/* @__PURE__ */ _("dt", { children: "torch" }), /* @__PURE__ */ _("dd", { children: e ? `${e.torch.mode} · ${e.torch.supported ? e.torch.on ? "on" : "off" : "unsupported"}` : "starting" })] }),
+			/* @__PURE__ */ v("div", { children: [/* @__PURE__ */ _("dt", { children: "luma" }), /* @__PURE__ */ _("dd", { children: e ? `live ${e.liveLuminance.toFixed(1)} · mirror ${e.mirrorLuminance.toFixed(1)}${Number.isFinite(e.mirrorAgeMs) ? ` (${Math.round(e.mirrorAgeMs)}ms)` : " (none)"}` : "—" })] }),
+			/* @__PURE__ */ v("div", { children: [/* @__PURE__ */ _("dt", { children: "path" }), /* @__PURE__ */ _("dd", { children: n ?? "video-frame / live-mirror" })] }),
+			t ? /* @__PURE__ */ v("div", { children: [/* @__PURE__ */ _("dt", { children: "shutter" }), /* @__PURE__ */ _("dd", { children: `live ${t.liveLuminance.toFixed(1)} · mirror ${t.mirrorLuminance.toFixed(1)}${Number.isFinite(t.mirrorAgeMs) ? ` (${Math.round(t.mirrorAgeMs)}ms)` : " (none)"}` })] }) : null,
+			/* @__PURE__ */ v("div", { children: [/* @__PURE__ */ _("dt", { children: "share" }), /* @__PURE__ */ _("dd", { children: /* @__PURE__ */ _("button", {
 				type: "button",
 				className: "scanner-camera-overlay__copy",
-				onClick: () => void a(),
-				children: i === "copied" ? "Copied report" : i === "failed" ? "Copy failed" : "Copy report"
+				onClick: () => void i(),
+				children: r === "copied" ? "Copied report" : r === "failed" ? "Copy failed" : "Copy report"
 			}) })] })
 		]
 	});
 }
 function F() {
-	let { autoCapture: e, phase: t, finderStatus: n, diagnostics: r, captureMethod: i, settings: a, cancel: o, capture: s, setAutoCapture: c, setTorch: l } = C(), u = a?.width, d = a?.height;
-	return /* @__PURE__ */ h("div", {
+	let { autoCapture: e, phase: t, finderStatus: n, diagnostics: r, captureMethod: i, settings: a, cancel: o, capture: s, setAutoCapture: c, setTorch: l, usingSystemCamera: u } = w(), d = a?.width, f = a?.height;
+	return /* @__PURE__ */ v("div", {
 		className: "scanner-camera-overlay__controls",
 		children: [
-			/* @__PURE__ */ m("button", {
+			/* @__PURE__ */ _("button", {
 				type: "button",
 				className: "scanner-camera-overlay__cancel",
 				onClick: o,
 				children: "Cancel"
 			}),
-			/* @__PURE__ */ h("div", {
+			/* @__PURE__ */ v("div", {
 				className: "scanner-camera-overlay__capture",
-				children: [e !== "only" && /* @__PURE__ */ m("button", {
+				children: [(u || e !== "only") && /* @__PURE__ */ _("button", {
 					type: "button",
 					className: "scanner-camera-overlay__shutter",
 					onClick: () => void s(),
 					disabled: t !== "ready",
-					"aria-label": "Capture full-resolution photo",
-					children: /* @__PURE__ */ m("span", {})
-				}), /* @__PURE__ */ h("div", {
+					"aria-label": u ? "Take a photo with the system camera" : "Capture full-resolution photo",
+					children: /* @__PURE__ */ _("span", {})
+				}), !u && /* @__PURE__ */ v("div", {
 					className: "scanner-camera-overlay__toggles",
-					children: [n?.autoCapture.visible && /* @__PURE__ */ h("label", { children: [/* @__PURE__ */ m("input", {
+					children: [n?.autoCapture.visible && /* @__PURE__ */ v("label", { children: [/* @__PURE__ */ _("input", {
 						type: "checkbox",
 						checked: n.autoCapture.checked,
 						onChange: (e) => c(e.target.checked)
-					}), "Auto-capture"] }), r?.torch.visible && /* @__PURE__ */ h("label", {
+					}), "Auto-capture"] }), r?.torch.visible && /* @__PURE__ */ v("label", {
 						title: r.torch.automatic ? "Torch is controlled automatically from scene brightness" : void 0,
-						children: [/* @__PURE__ */ m("input", {
+						children: [/* @__PURE__ */ _("input", {
 							type: "checkbox",
 							checked: r.torch.on,
 							disabled: !r.torch.mutable,
@@ -617,18 +724,18 @@ function F() {
 					})]
 				})]
 			}),
-			/* @__PURE__ */ h("div", {
+			/* @__PURE__ */ v("div", {
 				className: "scanner-camera-overlay__quality",
-				children: [/* @__PURE__ */ m("span", { children: i === "live-mirror" ? "Mirror" : "Camera" }), /* @__PURE__ */ m("strong", { children: u && d ? `${u} × ${d}` : "Measuring…" })]
+				children: [/* @__PURE__ */ _("span", { children: u ? "System camera" : i === "live-mirror" ? "Mirror" : "Camera" }), /* @__PURE__ */ _("strong", { children: d && f ? `${d} × ${f}` : u ? "Tap to photograph" : "Measuring…" })]
 			})
 		]
 	});
 }
 function I({ snapshot: e }) {
-	let { modelDownload: t } = C();
-	return /* @__PURE__ */ m(T, { snapshot: e ?? t });
+	let { modelDownload: t } = w();
+	return /* @__PURE__ */ _(E, { snapshot: e ?? t });
 }
 //#endregion
-export { F as ScannerControls, P as ScannerDiagnostics, O as ScannerFrame, I as ScannerModelDownload, M as ScannerNotice, k as ScannerPreview, x as ScannerProvider, A as ScannerQuad, N as ScannerStatus, j as ScannerTopBar, C as useScanner, S as useScannerRef };
+export { F as ScannerControls, P as ScannerDiagnostics, O as ScannerFrame, I as ScannerModelDownload, M as ScannerNotice, k as ScannerPreview, S as ScannerProvider, A as ScannerQuad, N as ScannerStatus, j as ScannerTopBar, w as useScanner, C as useScannerRef };
 
 //# sourceMappingURL=react.js.map