@exige/web-scanner-sdk 0.2.25 → 0.2.27

package/dist/react.js

@@ -1,9 +1,9 @@
 "use client";
-import { M as e, g as t, h as n, o as r, s as i, x as a } from "./finder-B3t_3g6Z.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 { C as e, L as t, S as n, _ as r, b as i, g as a, h as o, j as s, o as c, s as l, w as u } from "./finder-BlN89ZeT.js";
+import { createContext as d, useCallback as f, useContext as p, useEffect as m, useLayoutEffect as ee, useMemo as te, useRef as h, useState as g } from "react";
+import { Fragment as _, jsx as v, jsxs as y } from "react/jsx-runtime";
 //#region src/sdk/display-quad.ts
-function g(e) {
+function b(e) {
 	return [
 		e.topLeft,
 		e.topRight,
@@ -11,7 +11,7 @@ function g(e) {
 		e.bottomLeft
 	];
 }
-function _(e) {
+function x(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 S(e) {
+	return x(b(e).map((e) => ({ ...e })));
 }
-var ee = class {
+var ne = 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 || b(e).some((e, t) => {
+			let n = b(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 = S(e), i && (this.current = S(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 = x(b(this.current).map((e, n) => {
+			let r = b(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);
+}, re = d(null);
 //#endregion
 //#region src/react/context.tsx
-function b(e) {
+function ie(e) {
 	e?.startsWith("blob:") && URL.revokeObjectURL(e);
 }
-function te(e) {
+function ae(e) {
 	try {
 		let t = e.toDataURL("image/jpeg", .92);
 		return t.startsWith("data:image/") ? t : void 0;
@@ -90,127 +90,127 @@ 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 C({ open: o, autoCapture: d = "defaultOn", captureMode: p = "auto", torch: _ = "defaultOff", onCapture: y, onCancel: b, onError: x, onSettings: S, onFinderStatus: C, modelUrl: w, ortWasmPaths: T, detectionIntervalMs: oe, apiRef: E, children: se }) {
+	let D = e(p), O = h(void 0), k = h(void 0), A = h(void 0), j = h(void 0), M = h({}), N = h(new ne()), P = h(!1), F = h(!1), I = h({
+		onCapture: y,
+		onCancel: b,
+		onError: x,
+		onSettings: S,
+		onFinderStatus: C
+	}), L = h(null), [R, ce] = g(null), [le, z] = g(D && o ? "capturing" : D ? "ready" : "starting"), [B, V] = g(), [ue, H] = g(), [de, fe] = g({
 		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({
+	}), [pe, me] = g(), [he, U] = g(), [ge, W] = g(""), [_e, ve] = g(0), [ye, G] = g(), [be, K] = g(), [xe, q] = g("idle"), [Se, Ce] = g(), J = h(void 0), [we, Te] = g({
 		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();
+	}), Y = f(() => {
+		ie(J.current), J.current = void 0, Ce(void 0);
+	}, []), X = f((e, t) => {
+		let n = ae(e);
+		ie(J.current), J.current = n, Ce(n), t?.pause();
 	}, []);
-	l(() => {
-		N.current = {
-			onCapture: p,
-			onCancel: h,
-			onError: g,
-			onSettings: _,
-			onFinderStatus: v
+	m(() => {
+		I.current = {
+			onCapture: y,
+			onCancel: b,
+			onError: x,
+			onSettings: S,
+			onFinderStatus: C
 		};
 	}, [
-		p,
-		h,
-		g,
-		_,
-		v
-	]), l(() => e(ge), []);
-	let _e = s((e) => {
-		I(e);
+		y,
+		b,
+		x,
+		S,
+		C
+	]), m(() => t(Te), []);
+	let Ee = f((e) => {
+		ce(e);
 	}, []);
-	l(() => {
-		if (!n || !F) return;
+	m(() => {
+		if (!o || !R) return;
 		let e = () => {
-			let e = F.getBoundingClientRect();
-			ae({
+			let e = R.getBoundingClientRect();
+			fe({
 				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();
+	}, [o, R]), m(() => {
+		if (!o) return;
 		let e = window.setInterval(() => {
-			let e = E.current?.getDiagnostics();
-			e && W(e);
+			let e = O.current?.getDiagnostics();
+			e && G(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);
+	}, [o, _e]), m(() => {
+		if (!o) 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;
+		return e = requestAnimationFrame(n), () => cancelAnimationFrame(e);
+	}, [o]), m(() => {
+		if (!o || D || !R) return;
 		let e = !1, t = () => {
-			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();
+			k.current?.stop(), k.current = void 0, O.current?.stop(), O.current = void 0, j.current = void 0, A.current = void 0, M.current = {}, Y();
 		};
 		return (async () => {
-			t(), M.current = !1, L("starting"), H(""), z(void 0), V(void 0), G(void 0), K("idle"), Y();
+			t(), P.current = !1, z("starting"), W(""), V(void 0), U(void 0), K(void 0), q("idle"), Y();
 			try {
-				let t = await a(F, { torch: c });
+				let t = await u(R, { torch: _ });
 				if (e) {
 					t.stop();
 					return;
 				}
-				E.current = t;
+				O.current = t;
 				let n = t.getSettings();
-				se(n), N.current.onSettings?.(n), console.info("[ScannerProvider] camera settings", n), D.current = await i({
-					source: F,
-					autoCapture: o,
-					intervalMs: C,
+				me(n), I.current.onSettings?.(n), console.info("[ScannerProvider] camera settings", n), k.current = await l({
+					source: R,
+					autoCapture: d,
+					intervalMs: oe,
 					detection: {
-						modelUrl: x,
-						ortWasmPaths: S
+						modelUrl: w,
+						ortWasmPaths: T
 					},
 					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 t.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, U(e.method), K(e.diagnostics), G(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, 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"), W(e.message);
+						let t = O.current?.getDiagnostics();
+						t && G(t), I.current.onError?.(e);
 					},
 					onCapture: async (e) => {
-						let n = k.current;
-						await new Promise((e) => window.setTimeout(e, 140)), await N.current.onCapture({
+						let n = j.current;
+						await new Promise((e) => window.setTimeout(e, 140)), await I.current.onCapture({
 							...e,
 							method: n?.method ?? "video-frame",
 							settings: n?.settings ?? t.getSettings(),
 							fallbackReason: n?.fallbackReason,
 							luminance: n?.luminance,
 							diagnostics: n?.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
 						});
 					}
 				});
@@ -218,144 +218,240 @@ function x({ open: n, autoCapture: o = "defaultOn", torch: c = "defaultOff", onC
 				if (e) return;
 				t();
 				let r = n instanceof Error ? n : /* @__PURE__ */ Error("Camera access failed.");
-				H(r.message), L("error"), N.current.onError?.(r);
+				W(r.message), z("error"), I.current.onError?.(r);
 			}
 		})(), () => {
 			e = !0, t();
 		};
 	}, [
-		n,
-		F,
 		o,
-		c,
-		x,
-		S,
-		C,
-		U,
+		R,
+		D,
+		d,
+		_,
+		w,
+		T,
+		oe,
+		_e,
 		Y,
 		X
 	]);
-	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 ? r(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 De = {
+		open: o,
+		phase: le,
+		autoCapture: d,
+		captureMode: p,
+		usingSystemCamera: D,
+		finderStatus: B,
+		displayQuad: ue,
+		previewSize: de,
+		settings: pe,
+		captureMethod: he,
+		error: ge,
+		diagnostics: ye,
+		shutterDiagnostics: be,
+		copyState: xe,
+		guidanceHint: B ? c(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: we,
+		frozenPreviewUrl: Se
 	};
-	l(() => {
-		P.current = Z;
+	m(() => {
+		L.current = De;
 	});
-	let ve = s(() => {
-		N.current.onCancel();
-	}, []), ye = s(async () => {
+	let Oe = f(() => {
+		I.current.onCancel();
+	}, []), Z = f(async () => {
+		if (!F.current) {
+			F.current = !0, P.current = !1, W(""), H(void 0), N.current.clear(), z("capturing");
+			try {
+				let e = await n();
+				X(e);
+				let t = {
+					width: e.width,
+					height: e.height
+				};
+				me(t), I.current.onSettings?.(t), U("system-camera");
+				let r;
+				try {
+					let t = e.getContext("2d", { willReadFrequently: !0 })?.getImageData(0, 0, e.width, e.height).data;
+					t && (r = i(t));
+				} catch {
+					r = void 0;
+				}
+				let a = await s(e, {
+					modelUrl: w,
+					ortWasmPaths: T
+				});
+				if (a.status !== "success" || !a.corners || !a.quad) {
+					P.current = !0, z("error"), W(a.message), I.current.onError?.(Error(a.message));
+					return;
+				}
+				M.current = {
+					quad: a.quad,
+					sourceWidth: a.sourceWidth,
+					sourceHeight: a.sourceHeight
+				}, H(a.quad), z("captured"), await I.current.onCapture({
+					frame: e,
+					detection: a,
+					reason: "manual",
+					method: "system-camera",
+					settings: t,
+					luminance: r,
+					displayedQuad: a.quad,
+					displaySourceWidth: a.sourceWidth,
+					displaySourceHeight: a.sourceHeight
+				});
+			} catch (e) {
+				let t = e instanceof Error ? e : /* @__PURE__ */ Error("Could not take a photo.");
+				if (t.message === "No photo was selected.") {
+					if (J.current) {
+						z("error");
+						return;
+					}
+					I.current.onCancel();
+					return;
+				}
+				P.current = !0, W(t.message), z("error"), I.current.onError?.(t);
+			} finally {
+				F.current = !1;
+			}
+		}
+	}, [
+		X,
+		w,
+		T
+	]), ke = f(async () => {
+		if (D) {
+			await Z();
+			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, W(t.message);
+			let n = O.current?.getDiagnostics();
+			n && G(n), j.current?.diagnostics && K(j.current.diagnostics), z("error"), I.current.onError?.(t);
+		}
+	}, [Z, D]), Ae = h(Z);
+	Ae.current = Z;
+	let Q = h(!1);
+	ee(() => {
+		if (!o || !D) {
+			Q.current = !1;
+			return;
+		}
+		if (!Q.current) {
+			if (Q.current = !0, P.current = !1, W(""), V(void 0), U(void 0), K(void 0), q("idle"), H(void 0), N.current.clear(), Y(), !r()) {
+				z("ready");
+				return;
+			}
+			Ae.current();
 		}
-	}, []), 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({
+	}, [
+		o,
+		D,
+		Y
+	]);
+	let je = f(() => {
+		if (P.current = !1, W(""), K(void 0), q("idle"), H(void 0), N.current.clear(), D) {
+			Z();
+			return;
+		}
+		Y();
+		let e = O.current;
+		R?.paused && R.play(), z(e ? "ready" : "starting"), e || ve((e) => e + 1);
+	}, [
+		Z,
+		Y,
+		R,
+		D
+	]), Me = f(async (e) => {
+		let t = O.current;
+		t && (await t.setTorch(e), G(t.getDiagnostics()));
+	}, []), Ne = f((e) => {
+		k.current?.setAutoCapture(e);
+	}, []), Pe = f(async () => {
+		let e = L.current, t = O.current?.getDiagnostics() ?? e.diagnostics, n = e.finderStatus, r = a({
 			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");
+			q("copied");
 		} catch {
-			K("failed");
+			q("failed");
 		}
-	}, []), Q = s(() => P.current, []), $ = u(() => ({
-		capture: ye,
-		cancel: ve,
-		retry: be,
-		setTorch: xe,
-		setAutoCapture: Se,
-		copyReport: Ce,
-		getState: Q
+	}, []), Fe = f(() => L.current, []), $ = te(() => ({
+		capture: ke,
+		cancel: Oe,
+		retry: je,
+		setTorch: Me,
+		setAutoCapture: Ne,
+		copyReport: Pe,
+		getState: Fe
 	}), [
-		ye,
-		ve,
-		be,
-		xe,
-		Se,
-		Ce,
-		Q
+		ke,
+		Oe,
+		je,
+		Me,
+		Ne,
+		Pe,
+		Fe
 	]);
-	l(() => {
-		if (w) return w.current = $, () => {
-			w.current = null;
+	m(() => {
+		if (E) return E.current = $, () => {
+			E.current = null;
 		};
-	}, [$, w]);
-	let we = {
-		...Z,
+	}, [$, E]);
+	let Ie = {
+		...De,
 		...$,
-		bindPreview: _e
+		bindPreview: Ee
 	};
-	return /* @__PURE__ */ m(y.Provider, {
-		value: we,
-		children: T
+	return /* @__PURE__ */ v(re.Provider, {
+		value: Ie,
+		children: se
 	});
 }
 //#endregion
 //#region src/react/hooks.ts
-function S() {
-	return d(null);
+function w() {
+	return h(null);
 }
-function C() {
-	let e = c(y);
+function T() {
+	let e = p(re);
 	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 oe(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 +460,9 @@ function w(e, t, n, r, i) {
 		offsetX: f,
 		offsetY: p
 	};
-	let m = s / d, h = c / d;
+	let m = s / d, ee = c / d;
 	return {
-		viewBox: `${-f / d} ${-p / d} ${m} ${h}`,
+		viewBox: `${-f / d} ${-p / d} ${m} ${ee}`,
 		preserveAspectRatio: "none",
 		scale: d,
 		offsetX: f,
@@ -375,10 +471,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__ */ y("div", {
 		className: `model-download-ring${t === null ? " is-indeterminate" : ""}`,
 		role: "progressbar",
 		"aria-label": "Model download",
@@ -387,15 +483,15 @@ function T({ snapshot: e }) {
 		"aria-valuenow": n ?? void 0,
 		"data-loaded": e.loaded,
 		"data-total": e.total ?? "",
-		children: [/* @__PURE__ */ h("svg", {
+		children: [/* @__PURE__ */ y("svg", {
 			viewBox: "0 0 72 72",
 			"aria-hidden": "true",
-			children: [/* @__PURE__ */ m("circle", {
+			children: [/* @__PURE__ */ v("circle", {
 				className: "track",
 				cx: "36",
 				cy: "36",
 				r: 28
-			}), /* @__PURE__ */ m("circle", {
+			}), /* @__PURE__ */ v("circle", {
 				className: "value",
 				cx: "36",
 				cy: "36",
@@ -403,15 +499,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__ */ v("strong", {
 			className: "model-download-ring__pending",
 			children: "…"
-		}) : /* @__PURE__ */ h("strong", { children: [n, "%"] })]
+		}) : /* @__PURE__ */ y("strong", { children: [n, "%"] })]
 	});
 }
 //#endregion
 //#region src/react/parts.tsx
-var E = {
+var se = {
 	primaryColorHex: "--scanner-overlay-primary",
 	seekingColorHex: "--scanner-overlay-seeking",
 	detectingColorHex: "--scanner-overlay-detecting",
@@ -422,36 +518,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(se)) {
 		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 = T();
 	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__ */ y("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__ */ v(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 } = T(), r = h(null), i = f((t) => {
+		r.current = t, e(t);
 	}, [e]);
-	return l(() => {
-		t && n.current?.pause();
-	}, [t]), /* @__PURE__ */ h(p, { children: [/* @__PURE__ */ m("video", {
-		ref: r,
+	return m(() => {
+		t && r.current?.pause();
+	}, [t]), n ? t ? /* @__PURE__ */ v("img", {
+		src: t,
+		className: "scanner-camera-overlay__video scanner-camera-overlay__still",
+		alt: "",
+		"aria-label": "Captured document"
+	}) : /* @__PURE__ */ v("div", {
+		className: "scanner-camera-overlay__video",
+		"aria-hidden": "true"
+	}) : /* @__PURE__ */ y(_, { children: [/* @__PURE__ */ v("video", {
+		ref: i,
 		className: "scanner-camera-overlay__video",
 		muted: !0,
 		autoPlay: !0,
@@ -459,7 +563,7 @@ function k() {
 		style: { objectFit: "cover" },
 		"aria-hidden": !!t,
 		"aria-label": "Rear camera preview"
-	}), t ? /* @__PURE__ */ m("img", {
+	}), t ? /* @__PURE__ */ v("img", {
 		src: t,
 		className: "scanner-camera-overlay__video scanner-camera-overlay__still",
 		alt: "",
@@ -467,31 +571,37 @@ function k() {
 	}) : null] });
 }
 function A() {
-	let { finderStatus: e, displayQuad: t, previewSize: n } = C();
+	let { finderStatus: e, displayQuad: t, previewSize: n } = T();
 	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 = oe(e.sourceWidth, e.sourceHeight, n.width, n.height, "cover");
+	return /* @__PURE__ */ v("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__ */ v("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 } = T();
+	return /* @__PURE__ */ y("div", {
 		className: "scanner-camera-overlay__topbar",
-		children: [/* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("strong", { children: e }), /* @__PURE__ */ h("span", {
+		children: [/* @__PURE__ */ y("div", { children: [/* @__PURE__ */ v("strong", { children: e }), /* @__PURE__ */ v("span", {
 			"aria-live": "polite",
-			children: [
+			children: i ? /* @__PURE__ */ y(_, { 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__ */ y(_, { 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__ */ v("button", {
 			type: "button",
 			onClick: r,
 			"aria-label": "Close camera",
@@ -500,115 +610,138 @@ 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 } = T();
+	return e === "error" ? /* @__PURE__ */ y("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__ */ v("strong", { children: s ? c ? "No document found" : "Could not take a photo" : n ? "Capture failed" : "Could not open the camera" }),
+			/* @__PURE__ */ v("p", { children: t }),
+			/* @__PURE__ */ y("div", { children: [
+				/* @__PURE__ */ v("button", {
 					type: "button",
 					onClick: i,
 					children: "Try again"
 				}),
-				/* @__PURE__ */ m("button", {
+				/* @__PURE__ */ v("button", {
 					type: "button",
 					onClick: () => void a(),
 					children: r === "copied" ? "Copied" : r === "failed" ? "Copy failed" : "Copy report"
 				}),
-				/* @__PURE__ */ m("button", {
+				/* @__PURE__ */ v("button", {
 					type: "button",
 					onClick: o,
 					children: "Cancel"
 				})
 			] })
 		]
-	}) : e === "starting" ? /* @__PURE__ */ h("div", {
+	}) : s && e === "capturing" && !c ? /* @__PURE__ */ y("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__ */ v("span", { className: "scanner-camera-overlay__spinner" }),
+			/* @__PURE__ */ v("strong", { children: "Opening the system camera" }),
+			/* @__PURE__ */ v("p", { children: "There is no live document guide. We find the page after you take the photo." })
+		]
+	}) : s && e === "ready" && !c ? /* @__PURE__ */ y("div", {
+		className: "scanner-camera-overlay__message",
+		"aria-live": "polite",
+		children: [/* @__PURE__ */ v("strong", { children: "System camera" }), /* @__PURE__ */ v("p", { children: "Tap the shutter to open the Camera app. There is no live document guide." })]
+	}) : e === "starting" && !s ? /* @__PURE__ */ y("div", {
+		className: "scanner-camera-overlay__message",
+		"aria-live": "polite",
+		children: [
+			/* @__PURE__ */ v("span", { className: "scanner-camera-overlay__spinner" }),
+			/* @__PURE__ */ v("strong", { children: "Requesting the highest practical resolution" }),
+			/* @__PURE__ */ v("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 } = T(), o = n?.width, s = n?.height;
+	return r ? /* @__PURE__ */ v("div", {
+		className: "scanner-camera-overlay__status",
+		"aria-live": "polite",
+		children: /* @__PURE__ */ y("div", {
+			className: "scanner-camera-overlay__status-line",
+			children: [
+				/* @__PURE__ */ v("span", { className: a === "captured" ? "ready" : a === "error" ? "seeking" : "detecting" }),
+				i === "system-camera" ? "system camera" : "system camera · waiting",
+				o && s ? ` · ${o}×${s}` : ""
+			]
+		})
+	}) : /* @__PURE__ */ v("div", {
 		className: "scanner-camera-overlay__status",
 		"aria-live": "polite",
-		children: /* @__PURE__ */ h("div", {
+		children: /* @__PURE__ */ y("div", {
 			className: "scanner-camera-overlay__status-line",
 			children: [
-				/* @__PURE__ */ m("span", { className: e?.state ?? "detecting" }),
+				/* @__PURE__ */ v("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 } = T(), a = e?.engine ?? o();
+	return /* @__PURE__ */ y("dl", {
 		className: "scanner-camera-overlay__diagnostics",
 		"aria-label": "Camera diagnostics",
 		children: [
-			/* @__PURE__ */ h("div", { children: [/* @__PURE__ */ m("dt", { children: "engine" }), /* @__PURE__ */ h("dd", { children: [
-				o.engine,
+			/* @__PURE__ */ y("div", { children: [/* @__PURE__ */ v("dt", { children: "engine" }), /* @__PURE__ */ y("dd", { children: [
+				a.engine,
 				"/",
-				o.browser,
-				o.iosWebKit ? " ios" : ""
+				a.browser,
+				a.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__ */ y("div", { children: [/* @__PURE__ */ v("dt", { children: "video" }), /* @__PURE__ */ v("dd", { children: e ? `${e.videoWidth}×${e.videoHeight} rs${e.readyState}${e.paused ? " paused" : ""}${e.rendered ? "" : " hidden"}` : "starting" })] }),
+			/* @__PURE__ */ y("div", { children: [/* @__PURE__ */ v("dt", { children: "track" }), /* @__PURE__ */ v("dd", { children: e ? `${e.trackReadyState}${e.trackMuted ? " muted" : ""}${e.trackEnabled ? "" : " disabled"}` : "—" })] }),
+			/* @__PURE__ */ y("div", { children: [/* @__PURE__ */ v("dt", { children: "torch" }), /* @__PURE__ */ v("dd", { children: e ? `${e.torch.mode} · ${e.torch.supported ? e.torch.on ? "on" : "off" : "unsupported"}` : "starting" })] }),
+			/* @__PURE__ */ y("div", { children: [/* @__PURE__ */ v("dt", { children: "luma" }), /* @__PURE__ */ v("dd", { children: e ? `live ${e.liveLuminance.toFixed(1)} · mirror ${e.mirrorLuminance.toFixed(1)}${Number.isFinite(e.mirrorAgeMs) ? ` (${Math.round(e.mirrorAgeMs)}ms)` : " (none)"}` : "—" })] }),
+			/* @__PURE__ */ y("div", { children: [/* @__PURE__ */ v("dt", { children: "path" }), /* @__PURE__ */ v("dd", { children: n ?? "video-frame / live-mirror" })] }),
+			t ? /* @__PURE__ */ y("div", { children: [/* @__PURE__ */ v("dt", { children: "shutter" }), /* @__PURE__ */ v("dd", { children: `live ${t.liveLuminance.toFixed(1)} · mirror ${t.mirrorLuminance.toFixed(1)}${Number.isFinite(t.mirrorAgeMs) ? ` (${Math.round(t.mirrorAgeMs)}ms)` : " (none)"}` })] }) : null,
+			/* @__PURE__ */ y("div", { children: [/* @__PURE__ */ v("dt", { children: "share" }), /* @__PURE__ */ v("dd", { children: /* @__PURE__ */ v("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 } = T(), d = a?.width, f = a?.height;
+	return /* @__PURE__ */ y("div", {
 		className: "scanner-camera-overlay__controls",
 		children: [
-			/* @__PURE__ */ m("button", {
+			/* @__PURE__ */ v("button", {
 				type: "button",
 				className: "scanner-camera-overlay__cancel",
 				onClick: o,
 				children: "Cancel"
 			}),
-			/* @__PURE__ */ h("div", {
+			/* @__PURE__ */ y("div", {
 				className: "scanner-camera-overlay__capture",
-				children: [e !== "only" && /* @__PURE__ */ m("button", {
+				children: [(u ? t === "ready" : e !== "only") && /* @__PURE__ */ v("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__ */ v("span", {})
+				}), !u && /* @__PURE__ */ y("div", {
 					className: "scanner-camera-overlay__toggles",
-					children: [n?.autoCapture.visible && /* @__PURE__ */ h("label", { children: [/* @__PURE__ */ m("input", {
+					children: [n?.autoCapture.visible && /* @__PURE__ */ y("label", { children: [/* @__PURE__ */ v("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__ */ y("label", {
 						title: r.torch.automatic ? "Torch is controlled automatically from scene brightness" : void 0,
-						children: [/* @__PURE__ */ m("input", {
+						children: [/* @__PURE__ */ v("input", {
 							type: "checkbox",
 							checked: r.torch.on,
 							disabled: !r.torch.mutable,
@@ -617,18 +750,18 @@ function F() {
 					})]
 				})]
 			}),
-			/* @__PURE__ */ h("div", {
+			/* @__PURE__ */ y("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__ */ v("span", { children: u ? "System camera" : i === "live-mirror" ? "Mirror" : "Camera" }), /* @__PURE__ */ v("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 } = T();
+	return /* @__PURE__ */ v(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, C as ScannerProvider, A as ScannerQuad, N as ScannerStatus, j as ScannerTopBar, T as useScanner, w as useScannerRef };
 
 //# sourceMappingURL=react.js.map