@exige/web-scanner-sdk 0.2.29 → 0.2.31

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-CKMrW8dP.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 { F as e, I as t, K as n, O as r, P as i, S as a, U as o, V as s, W as c, g as l, i as u, n as d, x as f, z as p } from "./driver-license-yM6pBkNk.js";
+import { createContext as m, useCallback as h, useContext as g, useEffect as _, useLayoutEffect as v, useMemo as ee, 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 E(e) {
+	return T(w(e).map((e) => ({ ...e })));
 }
-var ne = class {
+var te = 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 = E(e), i && (this.current = E(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);
+}, ne = m(null);
 //#endregion
 //#region src/react/context.tsx
-function ie(e) {
+function re(e) {
 	e?.startsWith("blob:") && URL.revokeObjectURL(e);
 }
-function ae(e) {
+function ie(e) {
 	try {
 		let t = e.toDataURL("image/jpeg", .92);
 		return t.startsWith("data:image/") ? t : void 0;
@@ -90,73 +90,76 @@ function ae(e) {
 		return;
 	}
 }
-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: oe, apiRef: k, children: se }) {
-	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 ae(e, t) {
+	if (typeof e == "function") return e(t);
+}
+function D({ open: i, useCase: l = "document", autoCapture: d = "defaultOn", captureMode: m = "auto", torch: g = "defaultOff", onCapture: x, onDriverLicense: C, onCancel: w, onError: T, onSettings: E, onFinderStatus: D, modelUrl: O, ortWasmPaths: k, detectionIntervalMs: oe, apiRef: A, children: se }) {
+	let j = o(m), M = y(void 0), N = y(void 0), P = y(void 0), F = y(void 0), I = y({}), L = y(new te()), R = y(!1), ce = y(!1), z = y({
 		onCapture: x,
-		onDriverLicense: S,
-		onCancel: C,
-		onError: w,
-		onSettings: T,
-		onFinderStatus: E,
-		useCase: u
-	}), ce = _(void 0), B = _(void 0), le = _(async () => void 0), ue = _(null), [V, de] = v(null), [fe, H] = v(A && l ? "capturing" : A ? "ready" : "starting"), [U, pe] = v(), [me, W] = v(), [he, ge] = v({
+		onDriverLicense: C,
+		onCancel: w,
+		onError: T,
+		onSettings: E,
+		onFinderStatus: D,
+		useCase: l
+	}), B = y(void 0), V = y(void 0), le = y(async () => void 0), ue = y(null), [H, de] = b(null), [fe, U] = b(j && i ? "capturing" : j ? "ready" : "starting"), [W, pe] = b(), [me, G] = b(), [he, ge] = b({
 		width: 1,
 		height: 1
-	}), [_e, ve] = v(), [ye, G] = v(), [be, K] = v(""), [xe, Se] = v(0), [Ce, q] = v(), [we, J] = v(), [Te, Y] = v("idle"), [Ee, De] = v(), X = _(void 0), [Oe, ke] = v("front"), Ae = _("front"), [je, Me] = v(!1), [Ne, Pe] = v({
+	}), [_e, ve] = b(), [ye, K] = b(), [be, q] = b(""), [xe, Se] = b(0), [Ce, J] = b(), [we, Y] = b(), [Te, X] = b("idle"), [Ee, De] = b(), Z = y(void 0), [Oe, ke] = b("front"), Ae = y("front"), [je, Me] = b(!1), [Ne, Pe] = b({
 		downloading: !1,
 		loaded: 0,
 		total: null
-	}), Z = m(() => {
-		ie(X.current), X.current = void 0, De(void 0);
-	}, []), Q = m((e, t) => {
-		let n = ae(e);
-		ie(X.current), X.current = n, De(n), t?.pause();
+	}), Q = h(() => {
+		re(Z.current), Z.current = void 0, De(void 0);
+	}, []), Fe = h((e, t) => {
+		let n = ie(e);
+		re(Z.current), Z.current = n, De(n), t?.pause();
 	}, []);
-	g(() => {
+	v(() => {
 		z.current = {
 			onCapture: x,
-			onDriverLicense: S,
-			onCancel: C,
-			onError: w,
-			onSettings: T,
-			onFinderStatus: E,
-			useCase: u
+			onDriverLicense: C,
+			onCancel: w,
+			onError: T,
+			onSettings: E,
+			onFinderStatus: D,
+			useCase: l
 		};
 	}, [
 		x,
-		S,
 		C,
 		w,
 		T,
 		E,
-		u
-	]), g(() => o(Pe), []), g(() => {
-		if (!l || u !== "drivers-license") {
-			B.current = void 0, ce.current = void 0, ke("front"), Me(!1);
+		D,
+		l
+	]), _(() => n(Pe), []), _(() => {
+		if (!i || l !== "drivers-license") {
+			V.current = void 0, B.current = void 0, ke("front"), Me(!1);
 			return;
 		}
-		let e = c({ scan: {
-			modelUrl: D,
-			ortWasmPaths: O
+		let e = u({ scan: {
+			modelUrl: O,
+			ortWasmPaths: k
 		} });
-		return B.current = e, e.then((e) => {
-			ce.current = e;
+		return V.current = e, e.then((e) => {
+			B.current = e;
 		}), () => {
-			e.then((e) => e.cancel()), ce.current &&= void 0, B.current = void 0;
+			e.then((e) => e.cancel()), B.current &&= void 0, V.current = void 0;
 		};
 	}, [
+		i,
 		l,
-		u,
-		D,
-		O
+		O,
+		k
 	]);
-	let Fe = m((e) => {
+	let Ie = h((e) => {
 		de(e);
 	}, []);
-	g(() => {
-		if (!l || !V) return;
+	_(() => {
+		if (!i || !H) return;
 		let e = () => {
-			let e = V.getBoundingClientRect();
+			let e = H.getBoundingClientRect();
 			ge({
 				width: e.width,
 				height: e.height
@@ -164,68 +167,68 @@ function T({ open: l, useCase: u = "document", autoCapture: p = "defaultOn", cap
 		};
 		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();
+	}, [i, H]), _(() => {
+		if (!i) return;
 		let e = window.setInterval(() => {
-			let e = j.current?.getDiagnostics();
-			e && q(e);
+			let e = M.current?.getDiagnostics();
+			e && J(e);
 		}, 500);
 		return () => window.clearInterval(e);
-	}, [l, xe]), g(() => {
-		if (!l) return;
+	}, [i, xe]), _(() => {
+		if (!i) 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 = L.current.step(r - t);
+			t = r, i && G(i), e = requestAnimationFrame(n);
 		};
 		return e = requestAnimationFrame(n), () => cancelAnimationFrame(e);
-	}, [l]), g(() => {
-		if (!l || A || !V) return;
+	}, [i]), _(() => {
+		if (!i || j || !H) 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();
+			N.current?.stop(), N.current = void 0, M.current?.stop(), M.current = void 0, F.current = void 0, P.current = void 0, I.current = {}, Q();
 		};
 		return (async () => {
-			t(), L.current = !1, H("starting"), K(""), pe(void 0), G(void 0), J(void 0), Y("idle"), Z();
+			t(), R.current = !1, U("starting"), q(""), pe(void 0), K(void 0), Y(void 0), X("idle"), Q();
 			try {
-				let t = await s(V, { torch: y });
+				let t = await c(H, { torch: g });
 				if (e) {
 					t.stop();
 					return;
 				}
-				j.current = t;
+				M.current = t;
 				let n = t.getSettings();
-				ve(n), z.current.onSettings?.(n), console.info("[ScannerProvider] camera settings", n), M.current = await f({
-					source: V,
-					autoCapture: p,
+				ve(n), z.current.onSettings?.(n), console.info("[ScannerProvider] camera settings", n), N.current = await a({
+					source: H,
+					autoCapture: d,
 					intervalMs: oe,
 					detection: {
-						modelUrl: D,
-						ortWasmPaths: O
+						modelUrl: O,
+						ortWasmPaths: k
 					},
 					onStatus: (e) => {
-						if (N.current = e, pe(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 (P.current = e, pe(e), z.current.onFinderStatus?.(e), e.quad && e.sourceWidth && e.sourceHeight) {
+							let t = L.current.setTarget(e.quad, e.sourceWidth, e.sourceHeight);
+							G(t.quad);
+						} else L.current.clear(), G(void 0);
+						e.state !== "captured" && !R.current && U("ready");
 					},
 					captureFrame: async () => {
-						H("capturing"), F.current = {
-							quad: I.current.getCurrent(),
-							sourceWidth: N.current?.sourceWidth,
-							sourceHeight: N.current?.sourceHeight
+						U("capturing"), I.current = {
+							quad: L.current.getCurrent(),
+							sourceWidth: P.current?.sourceWidth,
+							sourceHeight: P.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;
+						if (F.current = e, K(e.method), Y(e.diagnostics), J(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 Fe(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);
+						R.current = !0, U("error"), q(e.message);
+						let t = M.current?.getDiagnostics();
+						t && J(t), z.current.onError?.(e);
 					},
 					onCapture: async (e) => {
-						let n = P.current;
+						let n = F.current;
 						await new Promise((e) => window.setTimeout(e, 140));
 						let r = {
 							...e,
@@ -234,46 +237,46 @@ function T({ open: l, useCase: u = "document", autoCapture: p = "defaultOn", cap
 							fallbackReason: n?.fallbackReason,
 							luminance: n?.luminance,
 							diagnostics: n?.diagnostics,
-							displayedQuad: F.current.quad,
-							displaySourceWidth: F.current.sourceWidth,
-							displaySourceHeight: F.current.sourceHeight
+							displayedQuad: I.current.quad,
+							displaySourceWidth: I.current.sourceWidth,
+							displaySourceHeight: I.current.sourceHeight
 						};
 						if (z.current.useCase === "drivers-license") {
 							await le.current(r);
 							return;
 						}
-						await z.current.onCapture?.(r);
+						await ae(z.current.onCapture, r);
 					}
 				});
 			} catch (n) {
 				if (e) return;
 				t();
 				let r = n instanceof Error ? n : /* @__PURE__ */ Error("Camera access failed.");
-				K(r.message), H("error"), z.current.onError?.(r);
+				q(r.message), U("error"), z.current.onError?.(r);
 			}
 		})(), () => {
 			e = !0, t();
 		};
 	}, [
-		l,
-		V,
-		A,
-		p,
-		y,
-		D,
+		i,
+		H,
+		j,
+		d,
+		g,
 		O,
+		k,
 		oe,
 		xe,
-		Z,
-		Q
+		Q,
+		Fe
 	]);
-	let Ie = {
-		open: l,
+	let Le = {
+		open: i,
 		phase: fe,
-		autoCapture: p,
-		captureMode: h,
-		usingSystemCamera: A,
-		finderStatus: U,
+		autoCapture: d,
+		captureMode: m,
+		usingSystemCamera: j,
+		finderStatus: W,
 		displayQuad: me,
 		previewSize: he,
 		settings: _e,
@@ -282,182 +285,182 @@ function T({ open: l, useCase: u = "document", autoCapture: p = "defaultOn", cap
 		diagnostics: Ce,
 		shutterDiagnostics: we,
 		copyState: Te,
-		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",
+		guidanceHint: W ? f(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: Ne,
 		frozenPreviewUrl: Ee,
-		useCase: u,
-		licenseSide: u === "drivers-license" ? Oe : void 0,
-		licenseBusy: u === "drivers-license" ? je : void 0
+		useCase: l,
+		licenseSide: l === "drivers-license" ? Oe : void 0,
+		licenseBusy: l === "drivers-license" ? je : void 0
 	};
-	g(() => {
-		ue.current = Ie;
+	_(() => {
+		ue.current = Le;
 	});
-	let Le = m(() => {
+	let Re = h(() => {
 		z.current.onCancel();
-	}, []), $ = m(async () => {
-		if (!R.current) {
-			R.current = !0, L.current = !1, K(""), W(void 0), I.current.clear(), H("capturing");
+	}, []), $ = h(async () => {
+		if (!ce.current) {
+			ce.current = !0, R.current = !1, q(""), G(void 0), L.current.clear(), U("capturing");
 			try {
-				let e = await i();
-				Q(e);
-				let n = {
+				let e = await s();
+				Fe(e);
+				let t = {
 					width: e.width,
 					height: e.height
 				};
-				ve(n), z.current.onSettings?.(n), G("system-camera");
-				let r;
+				ve(t), z.current.onSettings?.(t), K("system-camera");
+				let n;
 				try {
-					let n = e.getContext("2d", { willReadFrequently: !0 })?.getImageData(0, 0, e.width, e.height).data;
-					n && (r = t(n));
+					let t = e.getContext("2d", { willReadFrequently: !0 })?.getImageData(0, 0, e.width, e.height).data;
+					t && (n = p(t));
 				} catch {
-					r = void 0;
+					n = void 0;
 				}
-				let o = await a(e, {
-					modelUrl: D,
-					ortWasmPaths: O
+				let i = await r(e, {
+					modelUrl: O,
+					ortWasmPaths: k
 				});
-				if ((z.current.useCase !== "drivers-license" || Ae.current !== "back") && (o.status !== "success" || !o.corners || !o.quad)) {
-					L.current = !0, H("error"), K(o.message), z.current.onError?.(Error(o.message));
+				if ((z.current.useCase !== "drivers-license" || Ae.current !== "back") && (i.status !== "success" || !i.corners || !i.quad)) {
+					R.current = !0, U("error"), q(i.message), z.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 = {
+				I.current = {
+					quad: i.quad,
+					sourceWidth: i.sourceWidth,
+					sourceHeight: i.sourceHeight
+				}, i.quad && G(i.quad), U("captured");
+				let a = {
 					frame: e,
-					detection: o,
+					detection: i,
 					reason: "manual",
 					method: "system-camera",
-					settings: n,
-					luminance: r,
-					displayedQuad: o.quad,
-					displaySourceWidth: o.sourceWidth,
-					displaySourceHeight: o.sourceHeight
+					settings: t,
+					luminance: n,
+					displayedQuad: i.quad,
+					displaySourceWidth: i.sourceWidth,
+					displaySourceHeight: i.sourceHeight
 				};
 				if (z.current.useCase === "drivers-license") {
-					await le.current(s);
+					await le.current(a);
 					return;
 				}
-				await z.current.onCapture?.(s);
+				await ae(z.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 (Z.current) {
+						U("error");
 						return;
 					}
 					z.current.onCancel();
 					return;
 				}
-				L.current = !0, K(t.message), H("error"), z.current.onError?.(t);
+				R.current = !0, q(t.message), U("error"), z.current.onError?.(t);
 			} finally {
-				R.current = !1;
+				ce.current = !1;
 			}
 		}
 	}, [
-		Q,
-		D,
-		O
-	]), Re = m(async (e) => {
-		let t = await B.current;
+		Fe,
+		O,
+		k
+	]), ze = h(async (e) => {
+		let t = await V.current;
 		if (t) {
 			Me(!0);
 			try {
 				let n = await t.submitStill(e.frame, e.detection);
 				if (n.kind === "need-back") {
-					if (Ae.current = "back", ke("back"), L.current = !1, K(""), W(void 0), I.current.clear(), Z(), A) {
-						H("ready");
+					if (Ae.current = "back", ke("back"), R.current = !1, q(""), G(void 0), L.current.clear(), Q(), j) {
+						U("ready");
 						return;
 					}
-					V?.paused && V.play(), H("starting"), Se((e) => e + 1);
+					H?.paused && H.play(), U("starting"), Se((e) => e + 1);
 					return;
 				}
 				if (n.kind === "retry") {
-					L.current = !0, K(n.message), H("error");
+					R.current = !0, q(n.message), U("error");
 					return;
 				}
-				await z.current.onDriverLicense?.(n.result);
+				await ae(z.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);
+				R.current = !0, q(t.message), U("error"), z.current.onError?.(t);
 			} finally {
 				Me(!1);
 			}
 		}
 	}, [
-		Z,
-		V,
-		A
+		Q,
+		H,
+		j
 	]);
-	ee(() => {
-		le.current = Re;
-	}, [Re]);
-	let ze = m(async () => {
-		if (A) {
+	v(() => {
+		le.current = ze;
+	}, [ze]);
+	let Be = h(async () => {
+		if (j) {
 			await $();
 			return;
 		}
 		try {
-			await M.current?.capture();
+			await N.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);
+			R.current = !0, q(t.message);
+			let n = M.current?.getDiagnostics();
+			n && J(n), F.current?.diagnostics && Y(F.current.diagnostics), U("error"), z.current.onError?.(t);
 		}
-	}, [$, A]), Be = _($);
-	Be.current = $;
-	let Ve = _(!1);
-	ee(() => {
-		if (!l || !A) {
-			Ve.current = !1;
+	}, [$, j]), Ve = y($);
+	Ve.current = $;
+	let He = y(!1);
+	v(() => {
+		if (!i || !j) {
+			He.current = !1;
 			return;
 		}
-		if (!Ve.current) {
-			if (Ve.current = !0, L.current = !1, K(""), pe(void 0), G(void 0), J(void 0), Y("idle"), W(void 0), I.current.clear(), Z(), !r()) {
-				H("ready");
+		if (!He.current) {
+			if (He.current = !0, R.current = !1, q(""), pe(void 0), K(void 0), Y(void 0), X("idle"), G(void 0), L.current.clear(), Q(), !t()) {
+				U("ready");
 				return;
 			}
-			Be.current();
+			Ve.current();
 		}
 	}, [
-		l,
-		A,
-		Z
+		i,
+		j,
+		Q
 	]);
-	let He = m(() => {
-		if (L.current = !1, K(""), J(void 0), Y("idle"), W(void 0), I.current.clear(), A) {
+	let Ue = h(() => {
+		if (R.current = !1, q(""), Y(void 0), X("idle"), G(void 0), L.current.clear(), j) {
 			$();
 			return;
 		}
-		if (Z(), u === "drivers-license") {
-			H("starting"), Se((e) => e + 1);
+		if (Q(), l === "drivers-license") {
+			U("starting"), Se((e) => e + 1);
 			return;
 		}
-		let e = j.current;
-		V?.paused && V.play(), H(e ? "ready" : "starting"), e || Se((e) => e + 1);
+		let e = M.current;
+		H?.paused && H.play(), U(e ? "ready" : "starting"), e || Se((e) => e + 1);
 	}, [
 		$,
-		Z,
-		V,
-		u,
-		A
-	]), Ue = m(async (e) => {
-		let t = j.current;
-		t && (await t.setTorch(e), q(t.getDiagnostics()));
-	}, []), We = m((e) => {
-		M.current?.setAutoCapture(e);
-	}, []), Ge = m(async () => {
-		let e = ue.current, t = j.current?.getDiagnostics() ?? e.diagnostics, r = e.finderStatus, i = n({
-			error: e.error || void 0,
-			captureMethod: e.captureMethod,
-			luminance: P.current?.luminance,
-			fallbackReason: P.current?.fallbackReason,
-			shutter: e.shutterDiagnostics ?? P.current?.diagnostics,
-			live: t,
+		Q,
+		H,
+		l,
+		j
+	]), We = h(async (e) => {
+		let t = M.current;
+		t && (await t.setTorch(e), J(t.getDiagnostics()));
+	}, []), Ge = h((e) => {
+		N.current?.setAutoCapture(e);
+	}, []), Ke = h(async () => {
+		let t = ue.current, n = M.current?.getDiagnostics() ?? t.diagnostics, r = t.finderStatus, i = e({
+			error: t.error || void 0,
+			captureMethod: t.captureMethod,
+			luminance: F.current?.luminance,
+			fallbackReason: F.current?.fallbackReason,
+			shutter: t.shutterDiagnostics ?? F.current?.diagnostics,
+			live: n,
 			finder: r ? {
 				state: r.state,
 				confidence: r.confidence,
@@ -481,55 +484,55 @@ function T({ open: l, useCase: u = "document", autoCapture: p = "defaultOn", cap
 				let t = document.execCommand("copy");
 				if (e.remove(), !t) throw Error("Clipboard copy is unavailable.");
 			}
-			Y("copied");
+			X("copied");
 		} catch {
-			Y("failed");
+			X("failed");
 		}
-	}, []), Ke = m(() => ue.current, []), qe = te(() => ({
-		capture: ze,
-		cancel: Le,
-		retry: He,
-		setTorch: Ue,
-		setAutoCapture: We,
-		copyReport: Ge,
-		getState: Ke
+	}, []), qe = h(() => ue.current, []), Je = ee(() => ({
+		capture: Be,
+		cancel: Re,
+		retry: Ue,
+		setTorch: We,
+		setAutoCapture: Ge,
+		copyReport: Ke,
+		getState: qe
 	}), [
-		ze,
-		Le,
-		He,
+		Be,
+		Re,
 		Ue,
 		We,
 		Ge,
-		Ke
+		Ke,
+		qe
 	]);
-	g(() => {
-		if (k) return k.current = qe, () => {
-			k.current = null;
+	_(() => {
+		if (A) return A.current = Je, () => {
+			A.current = null;
 		};
-	}, [qe, k]);
-	let Je = {
-		...Ie,
-		...qe,
-		bindPreview: Fe
+	}, [Je, A]);
+	let Ye = {
+		...Le,
+		...Je,
+		bindPreview: Ie
 	};
-	return /* @__PURE__ */ b(re.Provider, {
-		value: Je,
+	return /* @__PURE__ */ S(ne.Provider, {
+		value: Ye,
 		children: se
 	});
 }
 //#endregion
 //#region src/react/hooks.ts
-function E() {
-	return _(null);
+function O() {
+	return y(null);
 }
-function D() {
-	let e = h(re);
+function k() {
+	let e = g(ne);
 	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 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}`,
@@ -549,10 +552,10 @@ function O(e, t, n, r, i) {
 }
 //#endregion
 //#region src/components/ModelDownloadRing.tsx
-function oe({ snapshot: e }) {
+function A({ 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",
@@ -561,15 +564,15 @@ function oe({ 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",
@@ -577,15 +580,20 @@ function oe({ 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 se(e) {
+	if (!(e.usingSystemCamera || e.licenseBusy) && e.phase !== "starting" && e.phase !== "error") return e.phase === "capturing" ? "Capturing full resolution…" : e.phase === "captured" ? "Document captured" : e.holdStillSeconds && e.holdStillSeconds > 0 ? l(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 = {
+var j = {
 	primaryColorHex: "--scanner-overlay-primary",
 	seekingColorHex: "--scanner-overlay-seeking",
 	detectingColorHex: "--scanner-overlay-detecting",
@@ -593,46 +601,46 @@ var k = {
 	readyColorHex: "--scanner-overlay-ready",
 	capturedColorHex: "--scanner-overlay-captured"
 };
-function se(e) {
+function M(e) {
 	if (!e) return;
 	let t = {};
-	for (let [n, r] of Object.entries(k)) {
+	for (let [n, r] of Object.entries(j)) {
 		let i = e[n]?.trim();
 		i && (t[r] = i);
 	}
 	return Object.keys(t).length > 0 ? t : void 0;
 }
-function A({ theme: e, style: t, title: n, children: r }) {
-	let i = D();
+function N({ theme: e, style: t, title: n, children: r }) {
+	let i = k();
 	if (!i.open) return null;
-	let a = n ?? (i.useCase === "drivers-license" ? "Scan a driver’s license" : "Scan a document"), o = se(e), s = o ? {
+	let a = n ?? (i.useCase === "drivers-license" ? "Scan a driver’s license" : "Scan a document"), o = M(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(B, {})]
 	});
 }
-function j() {
-	let { bindPreview: e, frozenPreviewUrl: t, usingSystemCamera: n } = D(), r = _(null), i = m((t) => {
+function P() {
+	let { bindPreview: e, frozenPreviewUrl: t, usingSystemCamera: n } = k(), r = y(null), i = h((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,
@@ -641,134 +649,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() {
-	let { finderStatus: e, displayQuad: t, previewSize: n } = D();
+function F() {
+	let { finderStatus: e, displayQuad: t, previewSize: n } = k();
 	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 = oe(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 I({ title: e }) {
+	let { phase: t, cancel: n, usingSystemCamera: r, useCase: i, licenseSide: a, licenseBusy: o } = k(), s = i === "drivers-license" ? d(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 L() {
+	let { phase: e, error: t, diagnostics: n, copyState: r, retry: i, copyReport: a, cancel: o, usingSystemCamera: s, frozenPreviewUrl: c, useCase: l, licenseSide: u, licenseBusy: f } = k(), p = l === "drivers-license" ? d(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: p ? 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", {
+	}) : f ? /* @__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: p ? p.headline : "Opening the system camera" }),
+			/* @__PURE__ */ S("p", { children: p ? p.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: p ? p.headline : "System camera" }), /* @__PURE__ */ S("p", { children: p ? p.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() {
-	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", {
+function R() {
+	let { finderStatus: e, detectorStatus: t, settings: n, usingSystemCamera: r, captureMethod: i, phase: a, useCase: o, licenseSide: s } = k(), c = n?.width, l = n?.height, u = o === "drivers-license" ? ` · ${s === "back" ? "back" : "front"}` : "";
+	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}` : "",
@@ -779,82 +781,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 ce() {
+	let { diagnostics: e, shutterDiagnostics: t, captureMethod: n, copyState: r, copyReport: a } = k(), o = e?.engine ?? i();
+	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(),
+				onClick: () => void a(),
 				children: r === "copied" ? "Copied report" : r === "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", {
+function z() {
+	let { autoCapture: e, phase: t, finderStatus: n, diagnostics: r, captureMethod: i, settings: a, cancel: o, capture: s, setAutoCapture: c, setTorch: l, usingSystemCamera: u, licenseBusy: f, useCase: p, licenseSide: m, guidanceHint: h } = k(), g = a?.width, _ = a?.height, v = u ? t === "ready" : e !== "only", ee = p === "drivers-license" ? d(m ?? "front", u) : void 0, y = se({
+		usingSystemCamera: u,
+		phase: t,
+		licenseBusy: f,
+		holdStillSeconds: n?.holdStillSeconds,
+		guidanceHint: h,
+		guidanceReason: n?.guidance.reason,
+		licenseHeadline: ee?.headline
+	}), b = !!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: [
+					y && /* @__PURE__ */ S("p", {
+						className: `scanner-camera-overlay__guidance${b ? " is-ready" : ""}`,
+						"aria-live": "polite",
+						children: y
+					}),
+					v && /* @__PURE__ */ S("button", {
+						type: "button",
+						className: "scanner-camera-overlay__shutter",
+						onClick: () => void s(),
+						disabled: t !== "ready" || !!f,
+						"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: g && _ ? `${g} × ${_}` : u ? "Tap to photograph" : "Measuring…" })]
 			})
 		]
 	});
 }
-function R({ snapshot: e }) {
-	let { modelDownload: t } = D();
-	return /* @__PURE__ */ b(oe, { snapshot: e ?? t });
+function B({ snapshot: e }) {
+	let { modelDownload: t } = k();
+	return /* @__PURE__ */ S(A, { 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 { z as ScannerControls, ce as ScannerDiagnostics, N as ScannerFrame, B as ScannerModelDownload, L as ScannerNotice, P as ScannerPreview, D as ScannerProvider, F as ScannerQuad, R as ScannerStatus, I as ScannerTopBar, k as useScanner, O as useScannerRef };
 
 //# sourceMappingURL=react.js.map