@exige/web-scanner-sdk 0.2.9

package/dist/react.js

@@ -0,0 +1,594 @@
+"use client";
+import { m as e, o as t, p as n, s as r, v as i } from "./finder-DFueuWuS.js";
+import { createContext as a, useCallback as o, useContext as s, useEffect as c, useMemo as l, useRef as u, useState as d } from "react";
+import { jsx as f, jsxs as p } from "react/jsx-runtime";
+//#region src/sdk/display-quad.ts
+function m(e) {
+	return [
+		e.topLeft,
+		e.topRight,
+		e.bottomRight,
+		e.bottomLeft
+	];
+}
+function h(e) {
+	let [t, n, r, i] = e;
+	return {
+		topLeft: t,
+		topRight: n,
+		bottomRight: r,
+		bottomLeft: i,
+		edges: {
+			top: {
+				start: t,
+				end: n
+			},
+			right: {
+				start: n,
+				end: r
+			},
+			bottom: {
+				start: r,
+				end: i
+			},
+			left: {
+				start: i,
+				end: t
+			}
+		}
+	};
+}
+function g(e) {
+	return h(m(e).map((e) => ({ ...e })));
+}
+var ee = class {
+	current;
+	target;
+	response;
+	snapDistance;
+	constructor(e = {}) {
+		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 || m(e).some((e, t) => {
+			let n = m(this.current)[t];
+			return Math.hypot(e.x - n.x, e.y - n.y) / r > this.snapDistance;
+		});
+		return this.target = g(e), i && (this.current = g(e)), {
+			quad: this.current,
+			snapped: i
+		};
+	}
+	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 = h(m(this.current).map((e, n) => {
+			let r = m(this.target)[n];
+			return {
+				x: e.x + (r.x - e.x) * t,
+				y: e.y + (r.y - e.y) * t
+			};
+		})), this.current;
+	}
+	clear() {
+		this.current = void 0, this.target = void 0;
+	}
+	getCurrent() {
+		return this.current;
+	}
+}, _ = a(null);
+//#endregion
+//#region src/react/context.tsx
+function v({ open: n, autoCapture: a = "defaultOn", torch: s = "defaultOff", onCapture: p, onCancel: m, onError: h, onSettings: g, onFinderStatus: v, modelUrl: y, ortWasmPaths: b, detectionIntervalMs: x, apiRef: S, children: C }) {
+	let w = u(void 0), T = u(void 0), E = u(void 0), D = u(void 0), O = u({}), k = u(new ee()), A = u(!1), j = u({
+		onCapture: p,
+		onCancel: m,
+		onError: h,
+		onSettings: g,
+		onFinderStatus: v
+	}), M = u(null), [N, te] = d(null), [ne, P] = d("starting"), [F, I] = d(), [re, L] = d(), [R, ie] = d({
+		width: 1,
+		height: 1
+	}), [ae, oe] = d(), [se, z] = d(), [ce, B] = d(""), [V, le] = d(0), [ue, H] = d(), [de, U] = d(), [fe, W] = d("idle");
+	c(() => {
+		j.current = {
+			onCapture: p,
+			onCancel: m,
+			onError: h,
+			onSettings: g,
+			onFinderStatus: v
+		};
+	}, [
+		p,
+		m,
+		h,
+		g,
+		v
+	]);
+	let pe = o((e) => {
+		te(e);
+	}, []);
+	c(() => {
+		if (!n || !N) return;
+		let e = () => {
+			let e = N.getBoundingClientRect();
+			ie({
+				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(N), () => t.disconnect();
+	}, [n, N]), c(() => {
+		if (!n) return;
+		let e = window.setInterval(() => {
+			let e = w.current?.getDiagnostics();
+			e && H(e);
+		}, 500);
+		return () => window.clearInterval(e);
+	}, [n, V]), c(() => {
+		if (!n) return;
+		let e = 0, t = performance.now(), r = (n) => {
+			let i = k.current.step(n - t);
+			t = n, i && L(i), e = requestAnimationFrame(r);
+		};
+		return e = requestAnimationFrame(r), () => cancelAnimationFrame(e);
+	}, [n]), c(() => {
+		if (!n || !N) return;
+		let e = !1, t = () => {
+			T.current?.stop(), T.current = void 0, w.current?.stop(), w.current = void 0, D.current = void 0, E.current = void 0, O.current = {};
+		};
+		return (async () => {
+			t(), A.current = !1, P("starting"), B(""), I(void 0), z(void 0), U(void 0), W("idle");
+			try {
+				let t = await i(N, { torch: s });
+				if (e) {
+					t.stop();
+					return;
+				}
+				w.current = t;
+				let n = t.getSettings();
+				oe(n), j.current.onSettings?.(n), console.info("[ScannerProvider] camera settings", n), T.current = await r({
+					source: N,
+					autoCapture: a,
+					intervalMs: x,
+					detection: {
+						modelUrl: y,
+						ortWasmPaths: b
+					},
+					onStatus: (e) => {
+						if (E.current = e, I(e), j.current.onFinderStatus?.(e), e.quad && e.sourceWidth && e.sourceHeight) {
+							let t = k.current.setTarget(e.quad, e.sourceWidth, e.sourceHeight);
+							L(t.quad);
+						} else k.current.clear(), L(void 0);
+						e.state !== "captured" && !A.current && P("ready");
+					},
+					captureFrame: async () => {
+						P("capturing"), O.current = {
+							quad: k.current.getCurrent(),
+							sourceWidth: E.current?.sourceWidth,
+							sourceHeight: E.current?.sourceHeight
+						};
+						let e = await t.capturePhoto();
+						if (D.current = e, z(e.method), U(e.diagnostics), H(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 e.frame;
+					},
+					onCaptureError: (e) => {
+						A.current = !0, P("error"), B(e.message);
+						let t = w.current?.getDiagnostics();
+						t && H(t), j.current.onError?.(e);
+					},
+					onCapture: async (e) => {
+						let n = D.current;
+						await new Promise((e) => window.setTimeout(e, 140)), await j.current.onCapture({
+							...e,
+							method: n?.method ?? "video-frame",
+							settings: n?.settings ?? t.getSettings(),
+							fallbackReason: n?.fallbackReason,
+							luminance: n?.luminance,
+							diagnostics: n?.diagnostics,
+							displayedQuad: O.current.quad,
+							displaySourceWidth: O.current.sourceWidth,
+							displaySourceHeight: O.current.sourceHeight
+						});
+					}
+				});
+			} catch (n) {
+				if (e) return;
+				t();
+				let r = n instanceof Error ? n : /* @__PURE__ */ Error("Camera access failed.");
+				B(r.message), P("error"), j.current.onError?.(r);
+			}
+		})(), () => {
+			e = !0, t();
+		};
+	}, [
+		n,
+		N,
+		a,
+		s,
+		y,
+		b,
+		x,
+		V
+	]);
+	let G = {
+		open: n,
+		phase: ne,
+		autoCapture: a,
+		finderStatus: F,
+		displayQuad: re,
+		previewSize: R,
+		settings: ae,
+		captureMethod: se,
+		error: ce,
+		diagnostics: ue,
+		shutterDiagnostics: de,
+		copyState: fe,
+		guidanceHint: F ? t(F.guidance, F.lighting) : void 0,
+		detectorStatus: F?.modelStatus === "failed" ? "ML failed" : F?.detector === "ml" ? `ML ${F.modelProvider ?? ""}`.trim() : "ML loading"
+	};
+	c(() => {
+		M.current = G;
+	});
+	let K = o(() => {
+		j.current.onCancel();
+	}, []), q = o(async () => {
+		try {
+			await T.current?.capture();
+		} catch (e) {
+			let t = e instanceof Error ? e : /* @__PURE__ */ Error("Could not capture the camera frame.");
+			A.current = !0, B(t.message);
+			let n = w.current?.getDiagnostics();
+			n && H(n), D.current?.diagnostics && U(D.current.diagnostics), P("error"), j.current.onError?.(t);
+		}
+	}, []), J = o(() => {
+		A.current = !1, B(""), U(void 0), W("idle");
+		let e = w.current;
+		P(e ? "ready" : "starting"), e || le((e) => e + 1);
+	}, []), Y = o(async (e) => {
+		let t = w.current;
+		t && (await t.setTorch(e), H(t.getDiagnostics()));
+	}, []), X = o((e) => {
+		T.current?.setAutoCapture(e);
+	}, []), Z = o(async () => {
+		let t = M.current, n = w.current?.getDiagnostics() ?? t.diagnostics, r = t.finderStatus, i = e({
+			error: t.error || void 0,
+			captureMethod: t.captureMethod,
+			luminance: D.current?.luminance,
+			fallbackReason: D.current?.fallbackReason,
+			shutter: t.shutterDiagnostics ?? D.current?.diagnostics,
+			live: n,
+			finder: r ? {
+				state: r.state,
+				confidence: r.confidence,
+				stableFrames: r.stableFrames,
+				requiredStableFrames: r.requiredStableFrames,
+				detector: r.detector,
+				modelStatus: r.modelStatus,
+				sourceWidth: r.sourceWidth,
+				sourceHeight: r.sourceHeight
+			} : void 0
+		});
+		try {
+			if (navigator.clipboard?.writeText) await navigator.clipboard.writeText(i);
+			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();
+				let t = document.execCommand("copy");
+				if (e.remove(), !t) throw Error("Clipboard copy is unavailable.");
+			}
+			W("copied");
+		} catch {
+			W("failed");
+		}
+	}, []), Q = o(() => M.current, []), $ = l(() => ({
+		capture: q,
+		cancel: K,
+		retry: J,
+		setTorch: Y,
+		setAutoCapture: X,
+		copyReport: Z,
+		getState: Q
+	}), [
+		q,
+		K,
+		J,
+		Y,
+		X,
+		Z,
+		Q
+	]);
+	c(() => {
+		if (S) return S.current = $, () => {
+			S.current = null;
+		};
+	}, [$, S]);
+	let me = {
+		...G,
+		...$,
+		bindPreview: pe
+	};
+	return /* @__PURE__ */ f(_.Provider, {
+		value: me,
+		children: C
+	});
+}
+//#endregion
+//#region src/react/hooks.ts
+function y() {
+	return u(null);
+}
+function b() {
+	let e = s(_);
+	if (!e) throw Error("useScanner must be used within ScannerProvider.");
+	return e;
+}
+//#endregion
+//#region src/live-overlay-geometry.ts
+function x(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}`,
+		preserveAspectRatio: "xMidYMid meet",
+		scale: d,
+		offsetX: f,
+		offsetY: p
+	};
+	let m = s / d, h = c / d;
+	return {
+		viewBox: `${-f / d} ${-p / d} ${m} ${h}`,
+		preserveAspectRatio: "none",
+		scale: d,
+		offsetX: f,
+		offsetY: p
+	};
+}
+//#endregion
+//#region src/components/ModelDownloadRing.tsx
+function S({ 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__ */ p("div", {
+		className: `model-download-ring${t === null ? " is-indeterminate" : ""}`,
+		role: "progressbar",
+		"aria-label": "Model download",
+		"aria-valuemin": 0,
+		"aria-valuemax": 100,
+		"aria-valuenow": n ?? void 0,
+		"data-loaded": e.loaded,
+		"data-total": e.total ?? "",
+		children: [/* @__PURE__ */ p("svg", {
+			viewBox: "0 0 72 72",
+			"aria-hidden": "true",
+			children: [/* @__PURE__ */ f("circle", {
+				className: "track",
+				cx: "36",
+				cy: "36",
+				r: 28
+			}), /* @__PURE__ */ f("circle", {
+				className: "value",
+				cx: "36",
+				cy: "36",
+				r: 28,
+				strokeDasharray: t === null ? void 0 : `${r} ${r}`,
+				strokeDashoffset: t === null ? void 0 : r * (1 - t)
+			})]
+		}), n === null ? /* @__PURE__ */ f("strong", {
+			className: "model-download-ring__pending",
+			children: "…"
+		}) : /* @__PURE__ */ p("strong", { children: [n, "%"] })]
+	});
+}
+//#endregion
+//#region src/react/parts.tsx
+var C = {
+	primaryColorHex: "--scanner-overlay-primary",
+	seekingColorHex: "--scanner-overlay-seeking",
+	detectingColorHex: "--scanner-overlay-detecting",
+	unstableColorHex: "--scanner-overlay-unstable",
+	readyColorHex: "--scanner-overlay-ready",
+	capturedColorHex: "--scanner-overlay-captured"
+};
+function w(e) {
+	if (!e) return;
+	let t = {};
+	for (let [n, r] of Object.entries(C)) {
+		let i = e[n]?.trim();
+		i && (t[r] = i);
+	}
+	return Object.keys(t).length > 0 ? t : void 0;
+}
+function T({ theme: e, style: t, title: n = "Scan a document", children: r }) {
+	let i = b();
+	if (!i.open) return null;
+	let a = w(e), o = a ? {
+		...t,
+		...a
+	} : t;
+	return /* @__PURE__ */ f("div", {
+		className: `scanner-camera-overlay ${i.finderStatus?.state === "captured" ? "is-captured" : ""}`.trim(),
+		style: o,
+		role: "dialog",
+		"aria-modal": "true",
+		"aria-label": n,
+		children: r
+	});
+}
+function E() {
+	let { bindPreview: e } = b();
+	return /* @__PURE__ */ f("video", {
+		ref: e,
+		className: "scanner-camera-overlay__video",
+		muted: !0,
+		autoPlay: !0,
+		playsInline: !0,
+		style: { objectFit: "cover" },
+		"aria-label": "Rear camera preview"
+	});
+}
+function D() {
+	let { finderStatus: e, displayQuad: t, previewSize: n } = b();
+	if (!t || !e?.sourceWidth || !e.sourceHeight) return null;
+	let r = x(e.sourceWidth, e.sourceHeight, n.width, n.height, "cover");
+	return /* @__PURE__ */ f("svg", {
+		className: `scanner-camera-overlay__quad ${e.state}`,
+		viewBox: r.viewBox,
+		preserveAspectRatio: r.preserveAspectRatio,
+		"aria-label": `${e.state} document boundary`,
+		children: /* @__PURE__ */ f("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 O({ title: e = "Scan a document" }) {
+	let { phase: t, guidanceHint: n, cancel: r } = b();
+	return /* @__PURE__ */ p("div", {
+		className: "scanner-camera-overlay__topbar",
+		children: [/* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("strong", { children: e }), /* @__PURE__ */ p("span", {
+			"aria-live": "polite",
+			children: [
+				t === "starting" && "Starting rear camera…",
+				t === "ready" && (n ?? "Place the document in the frame"),
+				t === "capturing" && "Capturing full resolution…",
+				t === "error" && "Camera unavailable"
+			]
+		})] }), /* @__PURE__ */ f("button", {
+			type: "button",
+			onClick: r,
+			"aria-label": "Close camera",
+			children: "×"
+		})]
+	});
+}
+function k() {
+	let { phase: e, error: t, diagnostics: n, copyState: r, retry: i, copyReport: a, cancel: o } = b();
+	return e === "error" ? /* @__PURE__ */ p("div", {
+		className: "scanner-camera-overlay__message",
+		role: "alert",
+		children: [
+			/* @__PURE__ */ f("strong", { children: n ? "Capture failed" : "Could not open the camera" }),
+			/* @__PURE__ */ f("p", { children: t }),
+			/* @__PURE__ */ p("div", { children: [
+				/* @__PURE__ */ f("button", {
+					type: "button",
+					onClick: i,
+					children: "Try again"
+				}),
+				/* @__PURE__ */ f("button", {
+					type: "button",
+					onClick: () => void a(),
+					children: r === "copied" ? "Copied" : r === "failed" ? "Copy failed" : "Copy report"
+				}),
+				/* @__PURE__ */ f("button", {
+					type: "button",
+					onClick: o,
+					children: "Cancel"
+				})
+			] })
+		]
+	}) : e === "starting" ? /* @__PURE__ */ p("div", {
+		className: "scanner-camera-overlay__message",
+		"aria-live": "polite",
+		children: [
+			/* @__PURE__ */ f("span", { className: "scanner-camera-overlay__spinner" }),
+			/* @__PURE__ */ f("strong", { children: "Requesting the highest practical resolution" }),
+			/* @__PURE__ */ f("p", { children: "Allow camera access to continue." })
+		]
+	}) : null;
+}
+function A() {
+	let { finderStatus: e, detectorStatus: t, settings: n } = b(), r = n?.width, i = n?.height;
+	return /* @__PURE__ */ f("div", {
+		className: "scanner-camera-overlay__status",
+		"aria-live": "polite",
+		children: /* @__PURE__ */ p("div", {
+			className: "scanner-camera-overlay__status-line",
+			children: [
+				/* @__PURE__ */ f("span", { className: e?.state ?? "detecting" }),
+				e?.state ?? "detecting",
+				e ? ` · ${Math.round(e.confidence * 100)}% · ${e.stableFrames}/${e.requiredStableFrames}` : "",
+				` · ${t}`,
+				e?.inferenceMs === void 0 ? "" : ` · ${Math.round(e.inferenceMs)}ms`,
+				r && i ? ` · ${r}×${i}` : ""
+			]
+		})
+	});
+}
+function j() {
+	let { diagnostics: e, shutterDiagnostics: t, captureMethod: r, copyState: i, copyReport: a } = b(), o = e?.engine ?? n();
+	return /* @__PURE__ */ p("dl", {
+		className: "scanner-camera-overlay__diagnostics",
+		"aria-label": "Camera diagnostics",
+		children: [
+			/* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("dt", { children: "engine" }), /* @__PURE__ */ p("dd", { children: [
+				o.engine,
+				"/",
+				o.browser,
+				o.iosWebKit ? " ios" : ""
+			] })] }),
+			/* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("dt", { children: "video" }), /* @__PURE__ */ f("dd", { children: e ? `${e.videoWidth}×${e.videoHeight} rs${e.readyState}${e.paused ? " paused" : ""}${e.rendered ? "" : " hidden"}` : "starting" })] }),
+			/* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("dt", { children: "track" }), /* @__PURE__ */ f("dd", { children: e ? `${e.trackReadyState}${e.trackMuted ? " muted" : ""}${e.trackEnabled ? "" : " disabled"}` : "—" })] }),
+			/* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("dt", { children: "torch" }), /* @__PURE__ */ f("dd", { children: e ? `${e.torch.mode} · ${e.torch.supported ? e.torch.on ? "on" : "off" : "unsupported"}` : "starting" })] }),
+			/* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("dt", { children: "luma" }), /* @__PURE__ */ f("dd", { children: e ? `live ${e.liveLuminance.toFixed(1)} · mirror ${e.mirrorLuminance.toFixed(1)}${Number.isFinite(e.mirrorAgeMs) ? ` (${Math.round(e.mirrorAgeMs)}ms)` : " (none)"}` : "—" })] }),
+			/* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("dt", { children: "path" }), /* @__PURE__ */ f("dd", { children: r ?? "video-frame / live-mirror" })] }),
+			t ? /* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("dt", { children: "shutter" }), /* @__PURE__ */ f("dd", { children: `live ${t.liveLuminance.toFixed(1)} · mirror ${t.mirrorLuminance.toFixed(1)}${Number.isFinite(t.mirrorAgeMs) ? ` (${Math.round(t.mirrorAgeMs)}ms)` : " (none)"}` })] }) : null,
+			/* @__PURE__ */ p("div", { children: [/* @__PURE__ */ f("dt", { children: "share" }), /* @__PURE__ */ f("dd", { children: /* @__PURE__ */ f("button", {
+				type: "button",
+				className: "scanner-camera-overlay__copy",
+				onClick: () => void a(),
+				children: i === "copied" ? "Copied report" : i === "failed" ? "Copy failed" : "Copy report"
+			}) })] })
+		]
+	});
+}
+function M() {
+	let { autoCapture: e, phase: t, finderStatus: n, diagnostics: r, captureMethod: i, settings: a, cancel: o, capture: s, setAutoCapture: c, setTorch: l } = b(), u = a?.width, d = a?.height;
+	return /* @__PURE__ */ p("div", {
+		className: "scanner-camera-overlay__controls",
+		children: [
+			/* @__PURE__ */ f("button", {
+				type: "button",
+				className: "scanner-camera-overlay__cancel",
+				onClick: o,
+				children: "Cancel"
+			}),
+			/* @__PURE__ */ p("div", {
+				className: "scanner-camera-overlay__capture",
+				children: [e !== "only" && /* @__PURE__ */ f("button", {
+					type: "button",
+					className: "scanner-camera-overlay__shutter",
+					onClick: () => void s(),
+					disabled: t !== "ready",
+					"aria-label": "Capture full-resolution photo",
+					children: /* @__PURE__ */ f("span", {})
+				}), /* @__PURE__ */ p("div", {
+					className: "scanner-camera-overlay__toggles",
+					children: [n?.autoCapture.visible && /* @__PURE__ */ p("label", { children: [/* @__PURE__ */ f("input", {
+						type: "checkbox",
+						checked: n.autoCapture.checked,
+						onChange: (e) => c(e.target.checked)
+					}), "Auto-capture"] }), r?.torch.visible && /* @__PURE__ */ p("label", {
+						title: r.torch.automatic ? "Torch is controlled automatically from scene brightness" : void 0,
+						children: [/* @__PURE__ */ f("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__ */ p("div", {
+				className: "scanner-camera-overlay__quality",
+				children: [/* @__PURE__ */ f("span", { children: i === "live-mirror" ? "Mirror" : "Camera" }), /* @__PURE__ */ f("strong", { children: u && d ? `${u} × ${d}` : "Measuring…" })]
+			})
+		]
+	});
+}
+function N({ snapshot: e }) {
+	return b(), e ? /* @__PURE__ */ f(S, { snapshot: e }) : null;
+}
+//#endregion
+export { M as ScannerControls, j as ScannerDiagnostics, T as ScannerFrame, N as ScannerModelDownload, k as ScannerNotice, E as ScannerPreview, v as ScannerProvider, D as ScannerQuad, A as ScannerStatus, O as ScannerTopBar, b as useScanner, y as useScannerRef };
+
+//# sourceMappingURL=react.js.map