@exige/web-scanner-sdk 0.2.30 → 0.2.33

package/dist/react.js

@@ -1,9 +1,9 @@
 "use client";
-import { B as e, I as t, M as n, N as r, R as i, T as a, U as o, V as s, i as c, j as l, n as u, v as d, y as f } from "./driver-license-DpjQqOKx.js";
-import { createContext as p, useCallback as m, useContext as h, useEffect as g, useLayoutEffect as ee, useMemo as te, useRef as _, useState as v } from "react";
-import { Fragment as y, jsx as b, jsxs as x } from "react/jsx-runtime";
+import { A as e, C as t, G as n, I as r, J as i, K as a, L as o, R as s, U as c, V as l, a as u, f as d, o as f, r as p, v as m, w as ee } from "./driver-license-DBrWpI9w.js";
+import { createContext as h, useCallback as g, useContext as te, useEffect as _, useLayoutEffect as v, useMemo as ne, useRef as y, useState as b } from "react";
+import { Fragment as x, jsx as S, jsxs as C } from "react/jsx-runtime";
 //#region src/sdk/display-quad.ts
-function S(e) {
+function w(e) {
 	return [
 		e.topLeft,
 		e.topRight,
@@ -11,7 +11,7 @@ function S(e) {
 		e.bottomLeft
 	];
 }
-function C(e) {
+function T(e) {
 	let [t, n, r, i] = e;
 	return {
 		topLeft: t,
@@ -38,10 +38,10 @@ function C(e) {
 		}
 	};
 }
-function w(e) {
-	return C(S(e).map((e) => ({ ...e })));
+function re(e) {
+	return T(w(e).map((e) => ({ ...e })));
 }
-var ne = class {
+var ie = class {
 	current;
 	target;
 	response;
@@ -50,11 +50,11 @@ var ne = 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 || S(e).some((e, t) => {
-			let n = S(this.current)[t];
+		let r = Math.max(1, Math.hypot(t, n)), i = !this.current || w(e).some((e, t) => {
+			let n = w(this.current)[t];
 			return Math.hypot(e.x - n.x, e.y - n.y) / r > this.snapDistance;
 		});
-		return this.target = w(e), i && (this.current = w(e)), {
+		return this.target = re(e), i && (this.current = re(e)), {
 			quad: this.current,
 			snapped: i
 		};
@@ -62,8 +62,8 @@ var ne = 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 = C(S(this.current).map((e, n) => {
-			let r = S(this.target)[n];
+		return this.current = T(w(this.current).map((e, n) => {
+			let r = w(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 ne = class {
 	getCurrent() {
 		return this.current;
 	}
-}, re = p(null);
+}, ae = h(null);
 //#endregion
 //#region src/react/context.tsx
-function ie(e) {
+function oe(e) {
 	e?.startsWith("blob:") && URL.revokeObjectURL(e);
 }
-function ae(e) {
+function se(e) {
 	try {
 		let t = e.toDataURL("image/jpeg", .92);
 		return t.startsWith("data:image/") ? t : void 0;
@@ -90,449 +90,516 @@ function ae(e) {
 		return;
 	}
 }
-function oe(e, t) {
+function ce(e, t) {
 	if (typeof e == "function") return e(t);
 }
-function T({ open: l, useCase: u = "document", autoCapture: p = "defaultOn", captureMode: h = "auto", torch: y = "defaultOff", onCapture: x, onDriverLicense: S, onCancel: C, onError: w, onSettings: T, onFinderStatus: E, modelUrl: D, ortWasmPaths: O, detectionIntervalMs: se, apiRef: k, children: ce }) {
-	let A = e(h), j = _(void 0), M = _(void 0), N = _(void 0), P = _(void 0), F = _({}), I = _(new ne()), L = _(!1), R = _(!1), z = _({
+function le({ open: r, useCase: p = "document", autoCapture: m = "defaultOn", captureMode: h = "auto", torch: te = "defaultOff", onCapture: x, onDriverLicense: C, onCancel: w, onError: T, onSettings: re, onFinderStatus: le, modelUrl: E, ortWasmPaths: D, detectionIntervalMs: ue, apiRef: O, children: de }) {
+	let k = n(h), A = y(void 0), j = y(void 0), M = y(void 0), N = y(void 0), P = y({}), F = y(new ie()), I = y(!1), fe = y(!1), L = y({
 		onCapture: x,
-		onDriverLicense: S,
-		onCancel: C,
-		onError: w,
-		onSettings: T,
-		onFinderStatus: E,
-		useCase: u
-	}), le = _(void 0), B = _(void 0), ue = _(async () => void 0), de = _(null), [V, fe] = v(null), [pe, H] = v(A && l ? "capturing" : A ? "ready" : "starting"), [U, me] = v(), [he, W] = v(), [ge, _e] = v({
+		onDriverLicense: C,
+		onCancel: w,
+		onError: T,
+		onSettings: re,
+		onFinderStatus: le,
+		useCase: p
+	}), R = y(void 0), pe = y(void 0), z = y(async () => void 0), B = y(!1), V = y(void 0), me = y(null), [H, he] = b(null), [ge, U] = b(k && r ? "capturing" : k ? "ready" : "starting"), [W, G] = b(), [_e, K] = b(), [ve, ye] = b({
 		width: 1,
 		height: 1
-	}), [ve, ye] = v(), [be, G] = v(), [xe, K] = v(""), [Se, Ce] = v(0), [we, q] = v(), [Te, J] = v(), [Ee, Y] = v("idle"), [De, Oe] = v(), X = _(void 0), [ke, Ae] = v("front"), je = _("front"), [Me, Ne] = v(!1), [Pe, Fe] = v({
+	}), [be, xe] = b(), [Se, q] = b(), [Ce, J] = b(""), [we, Te] = b(0), [Ee, Y] = b(), [De, X] = b(), [Oe, ke] = b("idle"), [Ae, je] = b(), Me = y(void 0), [Ne, Pe] = b("front"), Fe = y("front"), [Ie, Le] = b(!1), [Re, ze] = b({
 		downloading: !1,
 		loaded: 0,
 		total: null
-	}), Z = m(() => {
-		ie(X.current), X.current = void 0, Oe(void 0);
-	}, []), Q = m((e, t) => {
-		let n = ae(e);
-		ie(X.current), X.current = n, Oe(n), t?.pause();
+	}), Z = g(() => {
+		oe(Me.current), Me.current = void 0, je(void 0);
+	}, []), Q = g((e, t) => {
+		let n = se(e);
+		oe(Me.current), Me.current = n, je(n), t?.pause();
 	}, []);
-	ee(() => {
-		z.current = {
+	v(() => {
+		L.current = {
 			onCapture: x,
-			onDriverLicense: S,
-			onCancel: C,
-			onError: w,
-			onSettings: T,
-			onFinderStatus: E,
-			useCase: u
+			onDriverLicense: C,
+			onCancel: w,
+			onError: T,
+			onSettings: re,
+			onFinderStatus: le,
+			useCase: p
 		};
 	}, [
 		x,
-		S,
 		C,
 		w,
 		T,
-		E,
-		u
-	]), g(() => o(Fe), []), g(() => {
-		if (!l || u !== "drivers-license") {
-			B.current = void 0, le.current = void 0, Ae("front"), Ne(!1);
+		re,
+		le,
+		p
+	]), _(() => i(ze), []), _(() => {
+		if (!r || p !== "drivers-license") {
+			pe.current = void 0, R.current = void 0, B.current = !1, Pe("front"), Le(!1);
 			return;
 		}
-		let e = c({ scan: {
-			modelUrl: D,
-			ortWasmPaths: O
+		let e = u({ scan: {
+			modelUrl: E,
+			ortWasmPaths: D
 		} });
-		return B.current = e, e.then((e) => {
-			le.current = e;
+		return pe.current = e, e.then((e) => {
+			R.current = e;
 		}), () => {
-			e.then((e) => e.cancel()), le.current &&= void 0, B.current = void 0;
+			e.then((e) => e.cancel()), R.current &&= void 0, pe.current = void 0;
 		};
 	}, [
-		l,
-		u,
-		D,
-		O
+		r,
+		p,
+		E,
+		D
 	]);
-	let Ie = m((e) => {
-		fe(e);
+	let Be = g((e) => {
+		he(e);
 	}, []);
-	g(() => {
-		if (!l || !V) return;
+	_(() => {
+		if (!r || !H) return;
 		let e = () => {
-			let e = V.getBoundingClientRect();
-			_e({
+			let e = H.getBoundingClientRect();
+			ye({
 				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(V), () => t.disconnect();
-	}, [l, V]), g(() => {
-		if (!l) return;
+		return t.observe(H), () => t.disconnect();
+	}, [r, H]), _(() => {
+		if (!r) return;
 		let e = window.setInterval(() => {
-			let e = j.current?.getDiagnostics();
-			e && q(e);
+			let e = A.current?.getDiagnostics();
+			e && Y(e);
 		}, 500);
 		return () => window.clearInterval(e);
-	}, [l, Se]), g(() => {
-		if (!l) return;
+	}, [r, we]), _(() => {
+		if (!r) return;
 		let e = 0, t = performance.now(), n = (r) => {
-			let i = I.current.step(r - t);
-			t = r, i && W(i), e = requestAnimationFrame(n);
+			let i = F.current.step(r - t);
+			t = r, i && K(i), e = requestAnimationFrame(n);
 		};
 		return e = requestAnimationFrame(n), () => cancelAnimationFrame(e);
-	}, [l]), g(() => {
-		if (!l || A || !V) return;
-		let e = !1, t = () => {
-			M.current?.stop(), M.current = void 0, j.current?.stop(), j.current = void 0, P.current = void 0, N.current = void 0, F.current = {}, Z();
+	}, [r]), _(() => {
+		if (!r || k || !H) return;
+		let e = !1, t = new AbortController();
+		V.current = t;
+		let n = () => {
+			t.abort(), V.current === t && (V.current = void 0), j.current?.stop(), j.current = void 0, A.current?.stop(), A.current = void 0, N.current = void 0, M.current = void 0, P.current = {}, Z();
 		};
 		return (async () => {
-			t(), L.current = !1, H("starting"), K(""), me(void 0), G(void 0), J(void 0), Y("idle"), Z();
+			n(), t = new AbortController(), V.current = t, I.current = !1, U("starting"), J(""), G(void 0), q(void 0), X(void 0), ke("idle"), Z();
 			try {
-				let t = await s(V, { torch: y });
+				let n = await a(H, { torch: te });
 				if (e) {
-					t.stop();
+					n.stop();
+					return;
+				}
+				A.current = n;
+				let r = n.getSettings();
+				if (xe(r), L.current.onSettings?.(r), console.info("[ScannerProvider] camera settings", r), L.current.useCase === "drivers-license" && Fe.current === "back") {
+					G(void 0), K(void 0), F.current.clear(), U("ready"), (async () => {
+						try {
+							let r = await f(() => {
+								try {
+									return n.capture();
+								} catch {
+									return;
+								}
+							}, {
+								intervalMs: ue ?? 140,
+								signal: t.signal
+							});
+							if (e || t.signal.aborted || B.current) return;
+							B.current = !0, Q(r, H), q("video-frame"), U("captured"), await z.current({
+								frame: r,
+								reason: "auto",
+								method: "video-frame",
+								settings: n.getSettings()
+							});
+						} catch (n) {
+							if (e || t.signal.aborted || n instanceof DOMException && n.name === "AbortError") return;
+							let r = n instanceof Error ? n : /* @__PURE__ */ Error("Could not read the barcode.");
+							I.current = !0, J(r.message), U("error"), L.current.onError?.(r);
+						}
+					})();
 					return;
 				}
-				j.current = t;
-				let n = t.getSettings();
-				ye(n), z.current.onSettings?.(n), console.info("[ScannerProvider] camera settings", n), M.current = await f({
-					source: V,
-					autoCapture: p,
-					intervalMs: se,
+				j.current = await ee({
+					source: H,
+					autoCapture: m,
+					intervalMs: ue,
 					detection: {
-						modelUrl: D,
-						ortWasmPaths: O
+						modelUrl: E,
+						ortWasmPaths: D
 					},
 					onStatus: (e) => {
-						if (N.current = e, me(e), z.current.onFinderStatus?.(e), e.quad && e.sourceWidth && e.sourceHeight) {
-							let t = I.current.setTarget(e.quad, e.sourceWidth, e.sourceHeight);
-							W(t.quad);
-						} else I.current.clear(), W(void 0);
-						e.state !== "captured" && !L.current && H("ready");
+						if (M.current = e, G(e), L.current.onFinderStatus?.(e), e.quad && e.sourceWidth && e.sourceHeight) {
+							let t = F.current.setTarget(e.quad, e.sourceWidth, e.sourceHeight);
+							K(t.quad);
+						} else F.current.clear(), K(void 0);
+						e.state !== "captured" && !I.current && U("ready");
 					},
 					captureFrame: async () => {
-						H("capturing"), F.current = {
-							quad: I.current.getCurrent(),
-							sourceWidth: N.current?.sourceWidth,
-							sourceHeight: N.current?.sourceHeight
+						U("capturing"), P.current = {
+							quad: F.current.getCurrent(),
+							sourceWidth: M.current?.sourceWidth,
+							sourceHeight: M.current?.sourceHeight
 						};
-						let e = await t.capturePhoto();
-						if (P.current = e, G(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, V), H("captured"), e.frame;
+						let e = await n.capturePhoto();
+						if (N.current = e, q(e.method), X(e.diagnostics), Y(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, H), U("captured"), e.frame;
 					},
 					onCaptureError: (e) => {
-						L.current = !0, H("error"), K(e.message);
-						let t = j.current?.getDiagnostics();
-						t && q(t), z.current.onError?.(e);
+						I.current = !0, U("error"), J(e.message);
+						let t = A.current?.getDiagnostics();
+						t && Y(t), L.current.onError?.(e);
 					},
 					onCapture: async (e) => {
-						let n = P.current;
+						let t = N.current;
 						await new Promise((e) => window.setTimeout(e, 140));
 						let r = {
 							...e,
-							method: n?.method ?? "video-frame",
-							settings: n?.settings ?? t.getSettings(),
-							fallbackReason: n?.fallbackReason,
-							luminance: n?.luminance,
-							diagnostics: n?.diagnostics,
-							displayedQuad: F.current.quad,
-							displaySourceWidth: F.current.sourceWidth,
-							displaySourceHeight: F.current.sourceHeight
+							method: t?.method ?? "video-frame",
+							settings: t?.settings ?? n.getSettings(),
+							fallbackReason: t?.fallbackReason,
+							luminance: t?.luminance,
+							diagnostics: t?.diagnostics,
+							displayedQuad: P.current.quad,
+							displaySourceWidth: P.current.sourceWidth,
+							displaySourceHeight: P.current.sourceHeight
 						};
-						if (z.current.useCase === "drivers-license") {
-							await ue.current(r);
+						if (L.current.useCase === "drivers-license") {
+							await z.current(r);
 							return;
 						}
-						await oe(z.current.onCapture, r);
+						await ce(L.current.onCapture, r);
 					}
 				});
-			} catch (n) {
+			} catch (t) {
 				if (e) return;
-				t();
-				let r = n instanceof Error ? n : /* @__PURE__ */ Error("Camera access failed.");
-				K(r.message), H("error"), z.current.onError?.(r);
+				n();
+				let r = t instanceof Error ? t : /* @__PURE__ */ Error("Camera access failed.");
+				J(r.message), U("error"), L.current.onError?.(r);
 			}
 		})(), () => {
-			e = !0, t();
+			e = !0, n();
 		};
 	}, [
-		l,
-		V,
-		A,
-		p,
-		y,
+		r,
+		H,
+		k,
+		m,
+		te,
+		E,
 		D,
-		O,
-		se,
-		Se,
+		ue,
+		we,
 		Z,
 		Q
 	]);
-	let Le = {
-		open: l,
-		phase: pe,
-		autoCapture: p,
+	let Ve = {
+		open: r,
+		phase: ge,
+		autoCapture: m,
 		captureMode: h,
-		usingSystemCamera: A,
-		finderStatus: U,
-		displayQuad: he,
-		previewSize: ge,
-		settings: ve,
-		captureMethod: be,
-		error: xe,
-		diagnostics: we,
-		shutterDiagnostics: Te,
-		copyState: Ee,
-		guidanceHint: U ? d(U.guidance, U.lighting) : void 0,
-		detectorStatus: U?.modelStatus === "failed" ? `ML failed${U.modelError ? `: ${U.modelError}` : ""}` : U?.detector === "ml" ? `ML ${U.modelProvider ?? ""}`.trim() : "ML loading",
-		modelDownload: Pe,
-		frozenPreviewUrl: De,
-		useCase: u,
-		licenseSide: u === "drivers-license" ? ke : void 0,
-		licenseBusy: u === "drivers-license" ? Me : void 0
+		usingSystemCamera: k,
+		finderStatus: W,
+		displayQuad: _e,
+		previewSize: ve,
+		settings: be,
+		captureMethod: Se,
+		error: Ce,
+		diagnostics: Ee,
+		shutterDiagnostics: De,
+		copyState: Oe,
+		guidanceHint: W ? t(W.guidance, W.lighting) : void 0,
+		detectorStatus: W?.modelStatus === "failed" ? `ML failed${W.modelError ? `: ${W.modelError}` : ""}` : W?.detector === "ml" ? `ML ${W.modelProvider ?? ""}`.trim() : "ML loading",
+		modelDownload: Re,
+		frozenPreviewUrl: Ae,
+		useCase: p,
+		licenseSide: p === "drivers-license" ? Ne : void 0,
+		licenseBusy: p === "drivers-license" ? Ie : void 0
 	};
-	g(() => {
-		de.current = Le;
+	_(() => {
+		me.current = Ve;
 	});
-	let Re = m(() => {
-		z.current.onCancel();
-	}, []), $ = m(async () => {
-		if (!R.current) {
-			R.current = !0, L.current = !1, K(""), W(void 0), I.current.clear(), H("capturing");
+	let He = g(() => {
+		L.current.onCancel();
+	}, []), $ = g(async () => {
+		if (!fe.current) {
+			fe.current = !0, I.current = !1, J(""), K(void 0), F.current.clear(), U("capturing");
 			try {
-				let e = await i();
-				Q(e);
+				let t = await c();
+				Q(t);
 				let n = {
-					width: e.width,
-					height: e.height
+					width: t.width,
+					height: t.height
 				};
-				ye(n), z.current.onSettings?.(n), G("system-camera");
+				xe(n), L.current.onSettings?.(n), q("system-camera");
 				let r;
 				try {
-					let n = e.getContext("2d", { willReadFrequently: !0 })?.getImageData(0, 0, e.width, e.height).data;
-					n && (r = t(n));
+					let e = t.getContext("2d", { willReadFrequently: !0 })?.getImageData(0, 0, t.width, t.height).data;
+					e && (r = l(e));
 				} catch {
 					r = void 0;
 				}
-				let o = await a(e, {
-					modelUrl: D,
-					ortWasmPaths: O
+				if (L.current.useCase === "drivers-license" && Fe.current === "back") {
+					K(void 0), F.current.clear(), P.current = {}, U("captured"), await z.current({
+						frame: t,
+						reason: "manual",
+						method: "system-camera",
+						settings: n,
+						luminance: r
+					});
+					return;
+				}
+				let i = await e(t, {
+					modelUrl: E,
+					ortWasmPaths: D
 				});
-				if ((z.current.useCase !== "drivers-license" || je.current !== "back") && (o.status !== "success" || !o.corners || !o.quad)) {
-					L.current = !0, H("error"), K(o.message), z.current.onError?.(Error(o.message));
+				if (i.status !== "success" || !i.corners || !i.quad) {
+					I.current = !0, U("error"), J(i.message), L.current.onError?.(Error(i.message));
 					return;
 				}
-				F.current = {
-					quad: o.quad,
-					sourceWidth: o.sourceWidth,
-					sourceHeight: o.sourceHeight
-				}, o.quad && W(o.quad), H("captured");
-				let s = {
-					frame: e,
-					detection: o,
+				P.current = {
+					quad: i.quad,
+					sourceWidth: i.sourceWidth,
+					sourceHeight: i.sourceHeight
+				}, i.quad && K(i.quad), U("captured");
+				let a = {
+					frame: t,
+					detection: i,
 					reason: "manual",
 					method: "system-camera",
 					settings: n,
 					luminance: r,
-					displayedQuad: o.quad,
-					displaySourceWidth: o.sourceWidth,
-					displaySourceHeight: o.sourceHeight
+					displayedQuad: i.quad,
+					displaySourceWidth: i.sourceWidth,
+					displaySourceHeight: i.sourceHeight
 				};
-				if (z.current.useCase === "drivers-license") {
-					await ue.current(s);
+				if (L.current.useCase === "drivers-license") {
+					await z.current(a);
 					return;
 				}
-				await oe(z.current.onCapture, s);
+				await ce(L.current.onCapture, a);
 			} catch (e) {
 				let t = e instanceof Error ? e : /* @__PURE__ */ Error("Could not take a photo.");
 				if (t.message === "No photo was selected.") {
-					if (X.current) {
-						H("error");
+					if (Me.current) {
+						U("error");
 						return;
 					}
-					z.current.onCancel();
+					L.current.onCancel();
 					return;
 				}
-				L.current = !0, K(t.message), H("error"), z.current.onError?.(t);
+				I.current = !0, J(t.message), U("error"), L.current.onError?.(t);
 			} finally {
-				R.current = !1;
+				fe.current = !1;
 			}
 		}
 	}, [
 		Q,
-		D,
-		O
-	]), ze = m(async (e) => {
-		let t = await B.current;
+		E,
+		D
+	]), Ue = g(async (e) => {
+		let t = await pe.current;
 		if (t) {
-			Ne(!0);
+			Le(!0);
 			try {
 				let n = await t.submitStill(e.frame, e.detection);
 				if (n.kind === "need-back") {
-					if (je.current = "back", Ae("back"), L.current = !1, K(""), W(void 0), I.current.clear(), Z(), A) {
-						H("ready");
+					if (Fe.current = "back", B.current = !1, Pe("back"), I.current = !1, J(""), G(void 0), K(void 0), F.current.clear(), Z(), k) {
+						U("ready");
 						return;
 					}
-					V?.paused && V.play(), H("starting"), Ce((e) => e + 1);
+					H?.paused && H.play(), U("starting"), Te((e) => e + 1);
 					return;
 				}
 				if (n.kind === "retry") {
-					L.current = !0, K(n.message), H("error");
+					I.current = !0, J(n.message), U("error");
 					return;
 				}
-				await oe(z.current.onDriverLicense, n.result);
+				await ce(L.current.onDriverLicense, n.result);
 			} catch (e) {
 				let t = e instanceof Error ? e : /* @__PURE__ */ Error("Driver’s license scan failed.");
-				L.current = !0, K(t.message), H("error"), z.current.onError?.(t);
+				I.current = !0, J(t.message), U("error"), L.current.onError?.(t);
 			} finally {
-				Ne(!1);
+				Le(!1);
 			}
 		}
 	}, [
 		Z,
-		V,
-		A
+		H,
+		k
 	]);
-	ee(() => {
-		ue.current = ze;
-	}, [ze]);
-	let Be = m(async () => {
-		if (A) {
+	v(() => {
+		z.current = Ue;
+	}, [Ue]);
+	let We = g(async () => {
+		if (k) {
 			await $();
 			return;
 		}
+		let e = A.current;
+		if (e && L.current.useCase === "drivers-license" && Fe.current === "back") {
+			try {
+				let t = await e.capturePhoto();
+				if (!(await d(t.frame))?.text || B.current) return;
+				B.current = !0, V.current?.abort(), N.current = t, q(t.method), X(t.diagnostics), Y(t.diagnostics), Q(t.frame, H), U("captured"), await z.current({
+					frame: t.frame,
+					reason: "manual",
+					method: t.method,
+					settings: t.settings,
+					fallbackReason: t.fallbackReason,
+					luminance: t.luminance,
+					diagnostics: t.diagnostics
+				});
+			} catch (e) {
+				let t = e instanceof Error ? e : /* @__PURE__ */ Error("Could not capture the camera frame.");
+				I.current = !0, J(t.message);
+				let n = A.current?.getDiagnostics();
+				n && Y(n), N.current?.diagnostics && X(N.current.diagnostics), U("error"), L.current.onError?.(t);
+			}
+			return;
+		}
 		try {
-			await M.current?.capture();
+			await j.current?.capture();
 		} catch (e) {
 			let t = e instanceof Error ? e : /* @__PURE__ */ Error("Could not capture the camera frame.");
-			L.current = !0, K(t.message);
-			let n = j.current?.getDiagnostics();
-			n && q(n), P.current?.diagnostics && J(P.current.diagnostics), H("error"), z.current.onError?.(t);
+			I.current = !0, J(t.message);
+			let n = A.current?.getDiagnostics();
+			n && Y(n), N.current?.diagnostics && X(N.current.diagnostics), U("error"), L.current.onError?.(t);
 		}
-	}, [$, A]), Ve = _($);
-	Ve.current = $;
-	let He = _(!1);
-	ee(() => {
-		if (!l || !A) {
-			He.current = !1;
+	}, [
+		$,
+		Q,
+		H,
+		k
+	]), Ge = y($);
+	Ge.current = $;
+	let Ke = y(!1);
+	v(() => {
+		if (!r || !k) {
+			Ke.current = !1;
 			return;
 		}
-		if (!He.current) {
-			if (He.current = !0, L.current = !1, K(""), me(void 0), G(void 0), J(void 0), Y("idle"), W(void 0), I.current.clear(), Z(), !r()) {
-				H("ready");
+		if (!Ke.current) {
+			if (Ke.current = !0, I.current = !1, J(""), G(void 0), q(void 0), X(void 0), ke("idle"), K(void 0), F.current.clear(), Z(), !s()) {
+				U("ready");
 				return;
 			}
-			Ve.current();
+			Ge.current();
 		}
 	}, [
-		l,
-		A,
+		r,
+		k,
 		Z
 	]);
-	let Ue = m(() => {
-		if (L.current = !1, K(""), J(void 0), Y("idle"), W(void 0), I.current.clear(), A) {
+	let qe = g(() => {
+		if (I.current = !1, B.current = !1, J(""), X(void 0), ke("idle"), G(void 0), K(void 0), F.current.clear(), k) {
 			$();
 			return;
 		}
-		if (Z(), u === "drivers-license") {
-			H("starting"), Ce((e) => e + 1);
+		if (Z(), p === "drivers-license") {
+			U("starting"), Te((e) => e + 1);
 			return;
 		}
-		let e = j.current;
-		V?.paused && V.play(), H(e ? "ready" : "starting"), e || Ce((e) => e + 1);
+		let e = A.current;
+		H?.paused && H.play(), U(e ? "ready" : "starting"), e || Te((e) => e + 1);
 	}, [
 		$,
 		Z,
-		V,
-		u,
-		A
-	]), We = m(async (e) => {
-		let t = j.current;
-		t && (await t.setTorch(e), q(t.getDiagnostics()));
-	}, []), Ge = m((e) => {
-		M.current?.setAutoCapture(e);
-	}, []), Ke = m(async () => {
-		let e = de.current, t = j.current?.getDiagnostics() ?? e.diagnostics, r = e.finderStatus, i = n({
+		H,
+		p,
+		k
+	]), Je = g(async (e) => {
+		let t = A.current;
+		t && (await t.setTorch(e), Y(t.getDiagnostics()));
+	}, []), Ye = g((e) => {
+		j.current?.setAutoCapture(e);
+	}, []), Xe = g(async () => {
+		let e = me.current, t = A.current?.getDiagnostics() ?? e.diagnostics, n = e.finderStatus, r = o({
 			error: e.error || void 0,
 			captureMethod: e.captureMethod,
-			luminance: P.current?.luminance,
-			fallbackReason: P.current?.fallbackReason,
-			shutter: e.shutterDiagnostics ?? P.current?.diagnostics,
+			luminance: N.current?.luminance,
+			fallbackReason: N.current?.fallbackReason,
+			shutter: e.shutterDiagnostics ?? N.current?.diagnostics,
 			live: t,
-			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
+			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.");
 			}
-			Y("copied");
+			ke("copied");
 		} catch {
-			Y("failed");
+			ke("failed");
 		}
-	}, []), qe = m(() => de.current, []), Je = te(() => ({
-		capture: Be,
-		cancel: Re,
-		retry: Ue,
-		setTorch: We,
-		setAutoCapture: Ge,
-		copyReport: Ke,
-		getState: qe
+	}, []), Ze = g(() => me.current, []), Qe = ne(() => ({
+		capture: We,
+		cancel: He,
+		retry: qe,
+		setTorch: Je,
+		setAutoCapture: Ye,
+		copyReport: Xe,
+		getState: Ze
 	}), [
-		Be,
-		Re,
-		Ue,
 		We,
-		Ge,
-		Ke,
-		qe
+		He,
+		qe,
+		Je,
+		Ye,
+		Xe,
+		Ze
 	]);
-	g(() => {
-		if (k) return k.current = Je, () => {
-			k.current = null;
+	_(() => {
+		if (O) return O.current = Qe, () => {
+			O.current = null;
 		};
-	}, [Je, k]);
-	let Ye = {
-		...Le,
-		...Je,
-		bindPreview: Ie
+	}, [Qe, O]);
+	let $e = {
+		...Ve,
+		...Qe,
+		bindPreview: Be
 	};
-	return /* @__PURE__ */ b(re.Provider, {
-		value: Ye,
-		children: ce
+	return /* @__PURE__ */ S(ae.Provider, {
+		value: $e,
+		children: de
 	});
 }
 //#endregion
 //#region src/react/hooks.ts
 function E() {
-	return _(null);
+	return y(null);
 }
 function D() {
-	let e = h(re);
+	let e = te(ae);
 	if (!e) throw Error("useScanner must be used within ScannerProvider.");
 	return e;
 }
 //#endregion
 //#region src/live-overlay-geometry.ts
-function O(e, t, n, r, i) {
+function ue(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}`,
@@ -541,9 +608,9 @@ function O(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,
@@ -552,10 +619,10 @@ function O(e, t, n, r, i) {
 }
 //#endregion
 //#region src/components/ModelDownloadRing.tsx
-function se({ snapshot: e }) {
+function O({ 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__ */ x("div", {
+	return /* @__PURE__ */ C("div", {
 		className: `model-download-ring${t === null ? " is-indeterminate" : ""}`,
 		role: "progressbar",
 		"aria-label": "Model download",
@@ -564,15 +631,15 @@ function se({ snapshot: e }) {
 		"aria-valuenow": n ?? void 0,
 		"data-loaded": e.loaded,
 		"data-total": e.total ?? "",
-		children: [/* @__PURE__ */ x("svg", {
+		children: [/* @__PURE__ */ C("svg", {
 			viewBox: "0 0 72 72",
 			"aria-hidden": "true",
-			children: [/* @__PURE__ */ b("circle", {
+			children: [/* @__PURE__ */ S("circle", {
 				className: "track",
 				cx: "36",
 				cy: "36",
 				r: 28
-			}), /* @__PURE__ */ b("circle", {
+			}), /* @__PURE__ */ S("circle", {
 				className: "value",
 				cx: "36",
 				cy: "36",
@@ -580,13 +647,18 @@ function se({ snapshot: e }) {
 				strokeDasharray: t === null ? void 0 : `${r} ${r}`,
 				strokeDashoffset: t === null ? void 0 : r * (1 - t)
 			})]
-		}), n === null ? /* @__PURE__ */ b("strong", {
+		}), n === null ? /* @__PURE__ */ S("strong", {
 			className: "model-download-ring__pending",
 			children: "…"
-		}) : /* @__PURE__ */ x("strong", { children: [n, "%"] })]
+		}) : /* @__PURE__ */ C("strong", { children: [n, "%"] })]
 	});
 }
 //#endregion
+//#region src/react/guidance.ts
+function de(e) {
+	if (!(e.usingSystemCamera || e.licenseBusy) && e.phase !== "error") return e.phase === "starting" ? e.licenseHeadline : e.phase === "capturing" ? "Capturing full resolution…" : e.phase === "captured" ? "Document captured" : e.holdStillSeconds && e.holdStillSeconds > 0 ? m(e.holdStillSeconds) : e.guidanceHint && e.guidanceReason && e.guidanceReason !== "place-document" ? e.guidanceHint : e.licenseHeadline ?? e.guidanceHint ?? "Place the document in the frame";
+}
+//#endregion
 //#region src/react/parts.tsx
 var k = {
 	primaryColorHex: "--scanner-overlay-primary",
@@ -596,7 +668,7 @@ var k = {
 	readyColorHex: "--scanner-overlay-ready",
 	capturedColorHex: "--scanner-overlay-captured"
 };
-function ce(e) {
+function A(e) {
 	if (!e) return;
 	let t = {};
 	for (let [n, r] of Object.entries(k)) {
@@ -605,37 +677,37 @@ function ce(e) {
 	}
 	return Object.keys(t).length > 0 ? t : void 0;
 }
-function A({ theme: e, style: t, title: n, children: r }) {
+function j({ theme: e, style: t, title: n, children: r }) {
 	let i = D();
 	if (!i.open) return null;
-	let a = n ?? (i.useCase === "drivers-license" ? "Scan a driver’s license" : "Scan a document"), o = ce(e), s = o ? {
+	let a = n ?? (i.useCase === "drivers-license" ? "Scan a driver’s license" : "Scan a document"), o = A(e), s = o ? {
 		...t,
 		...o
 	} : t;
-	return /* @__PURE__ */ x("div", {
+	return /* @__PURE__ */ C("div", {
 		className: `scanner-camera-overlay ${i.phase === "captured" || i.finderStatus?.state === "captured" ? "is-captured" : ""} ${i.usingSystemCamera ? "is-system-camera" : ""}`.trim(),
 		style: s,
 		role: "dialog",
 		"aria-modal": "true",
 		"aria-label": a,
-		children: [r, /* @__PURE__ */ b(R, {})]
+		children: [r, /* @__PURE__ */ S(R, {})]
 	});
 }
-function j() {
-	let { bindPreview: e, frozenPreviewUrl: t, usingSystemCamera: n } = D(), r = _(null), i = m((t) => {
+function M() {
+	let { bindPreview: e, frozenPreviewUrl: t, usingSystemCamera: n } = D(), r = y(null), i = g((t) => {
 		r.current = t, e(t);
 	}, [e]);
-	return g(() => {
+	return _(() => {
 		t && r.current?.pause();
-	}, [t]), n ? t ? /* @__PURE__ */ b("img", {
+	}, [t]), n ? t ? /* @__PURE__ */ S("img", {
 		src: t,
 		className: "scanner-camera-overlay__video scanner-camera-overlay__still",
 		alt: "",
 		"aria-label": "Captured document"
-	}) : /* @__PURE__ */ b("div", {
+	}) : /* @__PURE__ */ S("div", {
 		className: "scanner-camera-overlay__video",
 		"aria-hidden": "true"
-	}) : /* @__PURE__ */ x(y, { children: [/* @__PURE__ */ b("video", {
+	}) : /* @__PURE__ */ C(x, { children: [/* @__PURE__ */ S("video", {
 		ref: i,
 		className: "scanner-camera-overlay__video",
 		muted: !0,
@@ -644,134 +716,128 @@ function j() {
 		style: { objectFit: "cover" },
 		"aria-hidden": !!t,
 		"aria-label": "Rear camera preview"
-	}), t ? /* @__PURE__ */ b("img", {
+	}), t ? /* @__PURE__ */ S("img", {
 		src: t,
 		className: "scanner-camera-overlay__video scanner-camera-overlay__still",
 		alt: "",
 		"aria-label": "Captured document"
 	}) : null] });
 }
-function M() {
+function N() {
 	let { finderStatus: e, displayQuad: t, previewSize: n } = D();
 	if (!t || !e?.sourceWidth || !e.sourceHeight) return null;
-	let r = O(e.sourceWidth, e.sourceHeight, n.width, n.height, "cover");
-	return /* @__PURE__ */ b("svg", {
+	let r = ue(e.sourceWidth, e.sourceHeight, n.width, n.height, "cover");
+	return /* @__PURE__ */ S("svg", {
 		className: `scanner-camera-overlay__quad ${e.state}`,
 		viewBox: r.viewBox,
 		preserveAspectRatio: r.preserveAspectRatio,
 		"aria-label": `${e.state} document boundary`,
-		children: /* @__PURE__ */ b("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__ */ S("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 N({ title: e }) {
-	let { phase: t, guidanceHint: n, cancel: r, usingSystemCamera: i, useCase: a, licenseSide: o, licenseBusy: s } = D(), c = a === "drivers-license" ? u(o ?? "front", i) : void 0, l = e ?? c?.title ?? "Scan a document";
-	return /* @__PURE__ */ x("div", {
+function P({ title: e }) {
+	let { phase: t, cancel: n, usingSystemCamera: r, useCase: i, licenseSide: a, licenseBusy: o } = D(), s = i === "drivers-license" ? p(a ?? "front", r) : void 0, c = e ?? s?.title ?? "Scan a document";
+	return /* @__PURE__ */ C("div", {
 		className: "scanner-camera-overlay__topbar",
-		children: [/* @__PURE__ */ x("div", { children: [/* @__PURE__ */ b("strong", { children: l }), /* @__PURE__ */ x("span", {
+		children: [/* @__PURE__ */ C("div", { children: [/* @__PURE__ */ S("strong", { children: c }), /* @__PURE__ */ C("span", {
 			"aria-live": "polite",
 			children: [
-				s && (o === "back" ? "Reading the barcode…" : "Reading the front…"),
-				!s && c && /* @__PURE__ */ x(y, { children: [t === "error" && (o === "back" ? "Could not read the back" : "Could not read the front"), t !== "error" && c.headline] }),
-				!s && !c && i && /* @__PURE__ */ x(y, { children: [
+				o && (a === "back" ? "Reading the barcode…" : "Reading the front…"),
+				!o && s && t === "error" && (a === "back" ? "Could not read the back" : "Could not read the front"),
+				!o && !s && r && /* @__PURE__ */ C(x, { 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"
 				] }),
-				!s && !c && !i && /* @__PURE__ */ x(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"
-				] })
+				!o && !s && !r && t === "error" && "Camera unavailable"
 			]
-		})] }), /* @__PURE__ */ b("button", {
+		})] }), /* @__PURE__ */ S("button", {
 			type: "button",
-			onClick: r,
+			onClick: n,
 			"aria-label": "Close camera",
 			children: "×"
 		})]
 	});
 }
-function P() {
-	let { phase: e, error: t, diagnostics: n, copyState: r, retry: i, copyReport: a, cancel: o, usingSystemCamera: s, frozenPreviewUrl: c, useCase: l, licenseSide: d, licenseBusy: f } = D(), p = l === "drivers-license" ? u(d ?? "front", s) : void 0;
-	return e === "error" ? /* @__PURE__ */ x("div", {
+function F() {
+	let { phase: e, error: t, diagnostics: n, copyState: r, retry: i, copyReport: a, cancel: o, usingSystemCamera: s, frozenPreviewUrl: c, useCase: l, licenseSide: u, licenseBusy: d } = D(), f = l === "drivers-license" ? p(u ?? "front", s) : void 0;
+	return e === "error" ? /* @__PURE__ */ C("div", {
 		className: "scanner-camera-overlay__message",
 		role: "alert",
 		children: [
-			/* @__PURE__ */ b("strong", { children: p ? d === "back" ? "Could not read the back" : "Could not read the front" : s ? c ? "No document found" : "Could not take a photo" : n ? "Capture failed" : "Could not open the camera" }),
-			/* @__PURE__ */ b("p", { children: t }),
-			/* @__PURE__ */ x("div", { children: [
-				/* @__PURE__ */ b("button", {
+			/* @__PURE__ */ S("strong", { children: f ? u === "back" ? "Could not read the back" : "Could not read the front" : s ? c ? "No document found" : "Could not take a photo" : n ? "Capture failed" : "Could not open the camera" }),
+			/* @__PURE__ */ S("p", { children: t }),
+			/* @__PURE__ */ C("div", { children: [
+				/* @__PURE__ */ S("button", {
 					type: "button",
 					onClick: i,
 					children: "Try again"
 				}),
-				/* @__PURE__ */ b("button", {
+				/* @__PURE__ */ S("button", {
 					type: "button",
 					onClick: () => void a(),
 					children: r === "copied" ? "Copied" : r === "failed" ? "Copy failed" : "Copy report"
 				}),
-				/* @__PURE__ */ b("button", {
+				/* @__PURE__ */ S("button", {
 					type: "button",
 					onClick: o,
 					children: "Cancel"
 				})
 			] })
 		]
-	}) : f ? /* @__PURE__ */ x("div", {
+	}) : d ? /* @__PURE__ */ C("div", {
 		className: "scanner-camera-overlay__message",
 		"aria-live": "polite",
 		children: [
-			/* @__PURE__ */ b("span", { className: "scanner-camera-overlay__spinner" }),
-			/* @__PURE__ */ b("strong", { children: d === "back" ? "Reading the barcode" : "Reading the front" }),
-			/* @__PURE__ */ b("p", { children: d === "back" ? "Decoding the AAMVA PDF417 on the back." : "Finding the card and reading the front with OCR." })
+			/* @__PURE__ */ S("span", { className: "scanner-camera-overlay__spinner" }),
+			/* @__PURE__ */ S("strong", { children: u === "back" ? "Reading the barcode" : "Reading the front" }),
+			/* @__PURE__ */ S("p", { children: u === "back" ? "Decoding the AAMVA PDF417 on the back." : "Finding the card and reading the front with OCR." })
 		]
-	}) : s && e === "capturing" && !c ? /* @__PURE__ */ x("div", {
+	}) : s && e === "capturing" && !c ? /* @__PURE__ */ C("div", {
 		className: "scanner-camera-overlay__message",
 		"aria-live": "polite",
 		children: [
-			/* @__PURE__ */ b("span", { className: "scanner-camera-overlay__spinner" }),
-			/* @__PURE__ */ b("strong", { children: p ? p.headline : "Opening the system camera" }),
-			/* @__PURE__ */ b("p", { children: p ? p.detail : "There is no live document guide. We find the page after you take the photo." })
+			/* @__PURE__ */ S("span", { className: "scanner-camera-overlay__spinner" }),
+			/* @__PURE__ */ S("strong", { children: f ? f.headline : "Opening the system camera" }),
+			/* @__PURE__ */ S("p", { children: f ? f.detail : "There is no live document guide. We find the page after you take the photo." })
 		]
-	}) : s && e === "ready" && !c ? /* @__PURE__ */ x("div", {
+	}) : s && e === "ready" && !c ? /* @__PURE__ */ C("div", {
 		className: "scanner-camera-overlay__message",
 		"aria-live": "polite",
-		children: [/* @__PURE__ */ b("strong", { children: p ? p.headline : "System camera" }), /* @__PURE__ */ b("p", { children: p ? p.detail : "Tap the shutter to open the Camera app. There is no live document guide." })]
-	}) : e === "starting" && !s ? /* @__PURE__ */ x("div", {
+		children: [/* @__PURE__ */ S("strong", { children: f ? f.headline : "System camera" }), /* @__PURE__ */ S("p", { children: f ? f.detail : "Tap the shutter to open the Camera app. There is no live document guide." })]
+	}) : e === "starting" && !s ? /* @__PURE__ */ C("div", {
 		className: "scanner-camera-overlay__message",
 		"aria-live": "polite",
 		children: [
-			/* @__PURE__ */ b("span", { className: "scanner-camera-overlay__spinner" }),
-			/* @__PURE__ */ b("strong", { children: "Requesting the highest practical resolution" }),
-			/* @__PURE__ */ b("p", { children: "Allow camera access to continue." })
+			/* @__PURE__ */ S("span", { className: "scanner-camera-overlay__spinner" }),
+			/* @__PURE__ */ S("strong", { children: "Requesting the highest practical resolution" }),
+			/* @__PURE__ */ S("p", { children: "Allow camera access to continue." })
 		]
 	}) : null;
 }
-function F() {
+function I() {
 	let { finderStatus: e, detectorStatus: t, settings: n, usingSystemCamera: r, captureMethod: i, phase: a, useCase: o, licenseSide: s } = D(), c = n?.width, l = n?.height, u = o === "drivers-license" ? ` · ${s === "back" ? "back" : "front"}` : "";
-	return r ? /* @__PURE__ */ b("div", {
+	return r ? /* @__PURE__ */ S("div", {
 		className: "scanner-camera-overlay__status",
 		"aria-live": "polite",
-		children: /* @__PURE__ */ x("div", {
+		children: /* @__PURE__ */ C("div", {
 			className: "scanner-camera-overlay__status-line",
 			children: [
-				/* @__PURE__ */ b("span", { className: a === "captured" ? "ready" : a === "error" ? "seeking" : "detecting" }),
+				/* @__PURE__ */ S("span", { className: a === "captured" ? "ready" : a === "error" ? "seeking" : "detecting" }),
 				i === "system-camera" ? "system camera" : "system camera · waiting",
 				u,
 				c && l ? ` · ${c}×${l}` : ""
 			]
 		})
-	}) : /* @__PURE__ */ b("div", {
+	}) : /* @__PURE__ */ S("div", {
 		className: "scanner-camera-overlay__status",
 		"aria-live": "polite",
-		children: /* @__PURE__ */ x("div", {
+		children: /* @__PURE__ */ C("div", {
 			className: "scanner-camera-overlay__status-line",
 			children: [
-				/* @__PURE__ */ b("span", { className: e?.state ?? "detecting" }),
+				/* @__PURE__ */ S("span", { className: e?.state ?? "detecting" }),
 				e?.state ?? "detecting",
 				u,
 				e ? ` · ${Math.round(e.confidence * 100)}% · ${e.stableFrames}/${e.requiredStableFrames}` : "",
@@ -782,82 +848,98 @@ function F() {
 		})
 	});
 }
-function I() {
-	let { diagnostics: e, shutterDiagnostics: t, captureMethod: n, copyState: r, copyReport: i } = D(), a = e?.engine ?? l();
-	return /* @__PURE__ */ x("dl", {
+function fe() {
+	let { diagnostics: e, shutterDiagnostics: t, captureMethod: n, copyState: i, copyReport: a } = D(), o = e?.engine ?? r();
+	return /* @__PURE__ */ C("dl", {
 		className: "scanner-camera-overlay__diagnostics",
 		"aria-label": "Camera diagnostics",
 		children: [
-			/* @__PURE__ */ x("div", { children: [/* @__PURE__ */ b("dt", { children: "engine" }), /* @__PURE__ */ x("dd", { children: [
-				a.engine,
+			/* @__PURE__ */ C("div", { children: [/* @__PURE__ */ S("dt", { children: "engine" }), /* @__PURE__ */ C("dd", { children: [
+				o.engine,
 				"/",
-				a.browser,
-				a.iosWebKit ? " ios" : ""
+				o.browser,
+				o.iosWebKit ? " ios" : ""
 			] })] }),
-			/* @__PURE__ */ x("div", { children: [/* @__PURE__ */ b("dt", { children: "video" }), /* @__PURE__ */ b("dd", { children: e ? `${e.videoWidth}×${e.videoHeight} rs${e.readyState}${e.paused ? " paused" : ""}${e.rendered ? "" : " hidden"}` : "starting" })] }),
-			/* @__PURE__ */ x("div", { children: [/* @__PURE__ */ b("dt", { children: "track" }), /* @__PURE__ */ b("dd", { children: e ? `${e.trackReadyState}${e.trackMuted ? " muted" : ""}${e.trackEnabled ? "" : " disabled"}` : "—" })] }),
-			/* @__PURE__ */ x("div", { children: [/* @__PURE__ */ b("dt", { children: "torch" }), /* @__PURE__ */ b("dd", { children: e ? `${e.torch.mode} · ${e.torch.supported ? e.torch.on ? "on" : "off" : "unsupported"}` : "starting" })] }),
-			/* @__PURE__ */ x("div", { children: [/* @__PURE__ */ b("dt", { children: "luma" }), /* @__PURE__ */ b("dd", { children: e ? `live ${e.liveLuminance.toFixed(1)} · mirror ${e.mirrorLuminance.toFixed(1)}${Number.isFinite(e.mirrorAgeMs) ? ` (${Math.round(e.mirrorAgeMs)}ms)` : " (none)"}` : "—" })] }),
-			/* @__PURE__ */ x("div", { children: [/* @__PURE__ */ b("dt", { children: "path" }), /* @__PURE__ */ b("dd", { children: n ?? "video-frame / live-mirror" })] }),
-			t ? /* @__PURE__ */ x("div", { children: [/* @__PURE__ */ b("dt", { children: "shutter" }), /* @__PURE__ */ b("dd", { children: `live ${t.liveLuminance.toFixed(1)} · mirror ${t.mirrorLuminance.toFixed(1)}${Number.isFinite(t.mirrorAgeMs) ? ` (${Math.round(t.mirrorAgeMs)}ms)` : " (none)"}` })] }) : null,
-			/* @__PURE__ */ x("div", { children: [/* @__PURE__ */ b("dt", { children: "share" }), /* @__PURE__ */ b("dd", { children: /* @__PURE__ */ b("button", {
+			/* @__PURE__ */ C("div", { children: [/* @__PURE__ */ S("dt", { children: "video" }), /* @__PURE__ */ S("dd", { children: e ? `${e.videoWidth}×${e.videoHeight} rs${e.readyState}${e.paused ? " paused" : ""}${e.rendered ? "" : " hidden"}` : "starting" })] }),
+			/* @__PURE__ */ C("div", { children: [/* @__PURE__ */ S("dt", { children: "track" }), /* @__PURE__ */ S("dd", { children: e ? `${e.trackReadyState}${e.trackMuted ? " muted" : ""}${e.trackEnabled ? "" : " disabled"}` : "—" })] }),
+			/* @__PURE__ */ C("div", { children: [/* @__PURE__ */ S("dt", { children: "torch" }), /* @__PURE__ */ S("dd", { children: e ? `${e.torch.mode} · ${e.torch.supported ? e.torch.on ? "on" : "off" : "unsupported"}` : "starting" })] }),
+			/* @__PURE__ */ C("div", { children: [/* @__PURE__ */ S("dt", { children: "luma" }), /* @__PURE__ */ S("dd", { children: e ? `live ${e.liveLuminance.toFixed(1)} · mirror ${e.mirrorLuminance.toFixed(1)}${Number.isFinite(e.mirrorAgeMs) ? ` (${Math.round(e.mirrorAgeMs)}ms)` : " (none)"}` : "—" })] }),
+			/* @__PURE__ */ C("div", { children: [/* @__PURE__ */ S("dt", { children: "path" }), /* @__PURE__ */ S("dd", { children: n ?? "video-frame / live-mirror" })] }),
+			t ? /* @__PURE__ */ C("div", { children: [/* @__PURE__ */ S("dt", { children: "shutter" }), /* @__PURE__ */ S("dd", { children: `live ${t.liveLuminance.toFixed(1)} · mirror ${t.mirrorLuminance.toFixed(1)}${Number.isFinite(t.mirrorAgeMs) ? ` (${Math.round(t.mirrorAgeMs)}ms)` : " (none)"}` })] }) : null,
+			/* @__PURE__ */ C("div", { children: [/* @__PURE__ */ S("dt", { children: "share" }), /* @__PURE__ */ S("dd", { children: /* @__PURE__ */ S("button", {
 				type: "button",
 				className: "scanner-camera-overlay__copy",
-				onClick: () => void i(),
-				children: r === "copied" ? "Copied report" : r === "failed" ? "Copy failed" : "Copy report"
+				onClick: () => void a(),
+				children: i === "copied" ? "Copied report" : i === "failed" ? "Copy failed" : "Copy report"
 			}) })] })
 		]
 	});
 }
 function L() {
-	let { autoCapture: e, phase: t, finderStatus: n, diagnostics: r, captureMethod: i, settings: a, cancel: o, capture: s, setAutoCapture: c, setTorch: l, usingSystemCamera: u, licenseBusy: d } = D(), f = a?.width, p = a?.height;
-	return /* @__PURE__ */ x("div", {
+	let { autoCapture: e, phase: t, finderStatus: n, diagnostics: r, captureMethod: i, settings: a, cancel: o, capture: s, setAutoCapture: c, setTorch: l, usingSystemCamera: u, licenseBusy: d, useCase: f, licenseSide: m, guidanceHint: ee } = D(), h = a?.width, g = a?.height, te = u ? t === "ready" : e !== "only", _ = f === "drivers-license" ? p(m ?? "front", u) : void 0, v = de({
+		usingSystemCamera: u,
+		phase: t,
+		licenseBusy: d,
+		holdStillSeconds: n?.holdStillSeconds,
+		guidanceHint: ee,
+		guidanceReason: n?.guidance.reason,
+		licenseHeadline: _?.headline
+	}), ne = !!n?.holdStillSeconds;
+	return /* @__PURE__ */ C("div", {
 		className: "scanner-camera-overlay__controls",
 		children: [
-			/* @__PURE__ */ b("button", {
+			/* @__PURE__ */ S("button", {
 				type: "button",
 				className: "scanner-camera-overlay__cancel",
 				onClick: o,
 				children: "Cancel"
 			}),
-			/* @__PURE__ */ x("div", {
+			/* @__PURE__ */ C("div", {
 				className: "scanner-camera-overlay__capture",
-				children: [(u ? t === "ready" : e !== "only") && /* @__PURE__ */ b("button", {
-					type: "button",
-					className: "scanner-camera-overlay__shutter",
-					onClick: () => void s(),
-					disabled: t !== "ready" || !!d,
-					"aria-label": u ? "Take a photo with the system camera" : "Capture full-resolution photo",
-					children: /* @__PURE__ */ b("span", {})
-				}), !u && /* @__PURE__ */ x("div", {
-					className: "scanner-camera-overlay__toggles",
-					children: [n?.autoCapture.visible && /* @__PURE__ */ x("label", { children: [/* @__PURE__ */ b("input", {
-						type: "checkbox",
-						checked: n.autoCapture.checked,
-						onChange: (e) => c(e.target.checked)
-					}), "Auto-capture"] }), r?.torch.visible && /* @__PURE__ */ x("label", {
-						title: r.torch.automatic ? "Torch is controlled automatically from scene brightness" : void 0,
-						children: [/* @__PURE__ */ b("input", {
+				children: [
+					v && /* @__PURE__ */ S("p", {
+						className: `scanner-camera-overlay__guidance${ne ? " is-ready" : ""}`,
+						"aria-live": "polite",
+						children: v
+					}),
+					te && /* @__PURE__ */ S("button", {
+						type: "button",
+						className: "scanner-camera-overlay__shutter",
+						onClick: () => void s(),
+						disabled: t !== "ready" || !!d,
+						"aria-label": u ? "Take a photo with the system camera" : "Capture full-resolution photo",
+						children: /* @__PURE__ */ S("span", {})
+					}),
+					!u && /* @__PURE__ */ C("div", {
+						className: "scanner-camera-overlay__toggles",
+						children: [n?.autoCapture.visible && /* @__PURE__ */ C("label", { children: [/* @__PURE__ */ S("input", {
 							type: "checkbox",
-							checked: r.torch.on,
-							disabled: !r.torch.mutable,
-							onChange: (e) => void l(e.target.checked)
-						}), r.torch.automatic ? "Auto torch" : "Torch"]
-					})]
-				})]
+							checked: n.autoCapture.checked,
+							onChange: (e) => c(e.target.checked)
+						}), "Auto-capture"] }), r?.torch.visible && /* @__PURE__ */ C("label", {
+							title: r.torch.automatic ? "Torch is controlled automatically from scene brightness" : void 0,
+							children: [/* @__PURE__ */ S("input", {
+								type: "checkbox",
+								checked: r.torch.on,
+								disabled: !r.torch.mutable,
+								onChange: (e) => void l(e.target.checked)
+							}), r.torch.automatic ? "Auto torch" : "Torch"]
+						})]
+					})
+				]
 			}),
-			/* @__PURE__ */ x("div", {
+			/* @__PURE__ */ C("div", {
 				className: "scanner-camera-overlay__quality",
-				children: [/* @__PURE__ */ b("span", { children: u ? "System camera" : i === "live-mirror" ? "Mirror" : "Camera" }), /* @__PURE__ */ b("strong", { children: f && p ? `${f} × ${p}` : u ? "Tap to photograph" : "Measuring…" })]
+				children: [/* @__PURE__ */ S("span", { children: u ? "System camera" : i === "live-mirror" ? "Mirror" : "Camera" }), /* @__PURE__ */ S("strong", { children: h && g ? `${h} × ${g}` : u ? "Tap to photograph" : "Measuring…" })]
 			})
 		]
 	});
 }
 function R({ snapshot: e }) {
 	let { modelDownload: t } = D();
-	return /* @__PURE__ */ b(se, { snapshot: e ?? t });
+	return /* @__PURE__ */ S(O, { snapshot: e ?? t });
 }
 //#endregion
-export { L as ScannerControls, I as ScannerDiagnostics, A as ScannerFrame, R as ScannerModelDownload, P as ScannerNotice, j as ScannerPreview, T as ScannerProvider, M as ScannerQuad, F as ScannerStatus, N as ScannerTopBar, D as useScanner, E as useScannerRef };
+export { L as ScannerControls, fe as ScannerDiagnostics, j as ScannerFrame, R as ScannerModelDownload, F as ScannerNotice, M as ScannerPreview, le as ScannerProvider, N as ScannerQuad, I as ScannerStatus, P as ScannerTopBar, D as useScanner, E as useScannerRef };
 
 //# sourceMappingURL=react.js.map