@exige/web-scanner-sdk 0.2.26 → 0.2.27

package/README.md

@@ -138,7 +138,7 @@ The demo hosts a trained checkpoint at `/models/id-fields-yolox-nano.onnx`. **Se
 
 `detectDocument` runs DocAligner and returns an ordered `DocumentQuad` with `topLeft`, `topRight`, `bottomRight`, `bottomLeft`, plus typed `top`, `right`, `bottom`, and `left` line segments. Outcomes are `success`, `no-document`, `low-confidence`, or `low-quality`. `scanDocument` uses that same quad for a projective perspective warp and includes the quad in its result.
 
-On touch/mobile-class devices, analysis defaults to a 560px working image (1280px on the long edge when the page is tall) and runs in a module Worker when supported. Perspective output is capped at 4096px by default, the same long-edge memory cap as `capturePhoto()`. Override `maxAnalysisDimension`, `maxOutputDimension`, or `useWorker` in `ScanOptions` when needed. Chrome `takePhoto()` cannot match the Android Camera app (no HDR+ / OEM ISP). On Android, `ScannerProvider` `captureMode="auto"` (the default) opens that Camera app through `pickNativeCameraStill()`, then `scanSystemCameraStill()` crops the most prominent document. Hosts that want the live overlay on Android pass `captureMode="live"`. Force the picker on any platform with `captureMode="system-camera"`.
+On touch/mobile-class devices, analysis defaults to a 560px working image (1280px on the long edge when the page is tall) and runs in a module Worker when supported. Perspective output is capped at 4096px by default, the same long-edge memory cap as `capturePhoto()`. Override `maxAnalysisDimension`, `maxOutputDimension`, or `useWorker` in `ScanOptions` when needed. Chrome `takePhoto()` cannot match the Android Camera app (no HDR+ / OEM ISP). On Android, `ScannerProvider` `captureMode="auto"` (the default) opens that Camera app through `pickNativeCameraStill()` as soon as `open` becomes true from a user gesture — no in-app shutter. Then `scanSystemCameraStill()` crops the most prominent document. Set `open` in the same click as the host button. Hosts that want the live overlay on Android pass `captureMode="live"`. Force the picker on any platform with `captureMode="system-camera"`.
 
 ## Live finder and auto-capture
 
@@ -215,7 +215,7 @@ await setLicenseKey(licenseKey)
 </ScannerProvider>
 ```
 
-`useScanner()` reads the session inside the provider. `useScannerRef()` gives the parent an imperative handle, passed as `apiRef`, the same idea as MUI's `useGridApiRef`. The camera covers the viewport, respects safe areas, shows finder/permission/error states, and keeps the existing auto-capture policies. On Android, `captureMode="auto"` skips the live preview and opens the system Camera app; DocAligner then finds the most prominent document on that JPEG. A miss stays on screen with **Try again**. iOS keeps the live overlay and auto-capture. The live path requests an ideal 4K rear-camera stream (no 1080×1920 Android cap), shows that stream in the preview, and continuously mirrors the last non-black frame. Outside WebKit, live capture uses `ImageCapture.takePhoto()` at max photo size and keeps the still even when its aspect differs from the preview; a still longer than 4096px is scaled with high-quality smoothing. WebKit `takePhoto()` returns black stills, so iOS copies the live preview or the mirrored frame. A genuinely blank capture fails loudly instead of exporting black pixels. Finder analysis stays on a 520–1600 working copy. Render `ScannerDiagnostics` for a live diagnostics panel with engine/browser, video and track state, luminance, and the chosen capture path; **Copy report** pastes a shutter-time dump for support. Pass `theme` to `ScannerFrame` to recolor the camera. `primaryColorHex` replaces the yellowish-green accents (`#c8ff45`). `seekingColorHex` and `detectingColorHex` are the waiting box colors (both `#ef6a5b` unless set apart), `unstableColorHex` is `#ffbe40`, `readyColorHex` is `#8af25a`, and `capturedColorHex` is `#ffffff`. Omit `theme` or any field to keep that default. The [React camera guide](site/guide/react-camera-overlay.md#theme) lists what each field paints. The demo source screen chooses Default, Ocean, Violet, or Signal before the camera starts and passes that palette as `theme` on `ScannerFrame`. Capture results include the displayed quad and its bounded-analysis dimensions; use `mapDocumentCornersToFrame()` plus `cropDocument()` so the final crop matches what was on screen. The framework-free imperative APIs remain available from the root package.
+`useScanner()` reads the session inside the provider. `useScannerRef()` gives the parent an imperative handle, passed as `apiRef`, the same idea as MUI's `useGridApiRef`. The camera covers the viewport, respects safe areas, shows finder/permission/error states, and keeps the existing auto-capture policies. On Android, `captureMode="auto"` skips the live preview and opens the system Camera app as soon as `open` becomes true from a user gesture; DocAligner then finds the most prominent document on that JPEG. A miss stays on screen with **Try again**. iOS keeps the live overlay and auto-capture. The live path requests an ideal 4K rear-camera stream (no 1080×1920 Android cap), shows that stream in the preview, and continuously mirrors the last non-black frame. Outside WebKit, live capture uses `ImageCapture.takePhoto()` at max photo size and keeps the still even when its aspect differs from the preview; a still longer than 4096px is scaled with high-quality smoothing. WebKit `takePhoto()` returns black stills, so iOS copies the live preview or the mirrored frame. A genuinely blank capture fails loudly instead of exporting black pixels. Finder analysis stays on a 520–1600 working copy. Render `ScannerDiagnostics` for a live diagnostics panel with engine/browser, video and track state, luminance, and the chosen capture path; **Copy report** pastes a shutter-time dump for support. Pass `theme` to `ScannerFrame` to recolor the camera. `primaryColorHex` replaces the yellowish-green accents (`#c8ff45`). `seekingColorHex` and `detectingColorHex` are the waiting box colors (both `#ef6a5b` unless set apart), `unstableColorHex` is `#ffbe40`, `readyColorHex` is `#8af25a`, and `capturedColorHex` is `#ffffff`. Omit `theme` or any field to keep that default. The [React camera guide](site/guide/react-camera-overlay.md#theme) lists what each field paints. The demo source screen chooses Default, Ocean, Violet, or Signal before the camera starts and passes that palette as `theme` on `ScannerFrame`. Capture results include the displayed quad and its bounded-analysis dimensions; use `mapDocumentCornersToFrame()` plus `cropDocument()` so the final crop matches what was on screen. The framework-free imperative APIs remain available from the root package.
 
 ## Run the demo
 

package/dist/{finder-Dcg3mVJM.js → finder-BlN89ZeT.js}

@@ -984,7 +984,11 @@ async function qe(t, n = {}) {
 		}
 	};
 }
-async function Je() {
+function Je() {
+	let e = typeof navigator > "u" ? void 0 : navigator.userActivation;
+	return !e || e.isActive;
+}
+async function Ye() {
 	let e = document.createElement("input");
 	return e.type = "file", e.accept = "image/*", e.capture = "environment", e.setAttribute("capture", "environment"), We(await new Promise((t, n) => {
 		e.addEventListener("change", () => {
@@ -997,12 +1001,12 @@ async function Je() {
 }
 //#endregion
 //#region src/sdk/lighting.ts
-function Ye(e, t) {
+function Xe(e, t) {
 	if (!e.length) return 0;
 	let n = [...e].sort((e, t) => e - t);
 	return n[Math.min(n.length - 1, Math.floor(n.length * t))];
 }
-function Xe(e, t, n, r = 12) {
+function Ze(e, t, n, r = 12) {
 	if (!t || !n || e.length < t * n) return {
 		strong: !1,
 		strength: 0,
@@ -1025,7 +1029,7 @@ function Xe(e, t, n, r = 12) {
 			});
 		}
 	}
-	let s = Ye(o.map((e) => e.mean), .8), c = o.map((e) => s - e.mean >= 24 && e.mean >= 35), l = new Uint8Array(o.length), u = [];
+	let s = Xe(o.map((e) => e.mean), .8), c = o.map((e) => s - e.mean >= 24 && e.mean >= 35), l = new Uint8Array(o.length), u = [];
 	for (let e = 0; e < o.length; e += 1) {
 		if (!c[e] || l[e]) continue;
 		let t = [], n = [e];
@@ -1073,11 +1077,11 @@ function Xe(e, t, n, r = 12) {
 	}
 	return d;
 }
-function Ze(e, t, n, r, i, a, o) {
+function Qe(e, t, n, r, i, a, o) {
 	let s = Math.max(0, a - o), c = Math.min(r, a + o + 1), l = Math.max(0, i - o), u = Math.min(n, i + o + 1), d = Math.max(1, (u - l) * (c - s));
 	return (e[c * t + u] - e[s * t + u] - e[c * t + l] + e[s * t + l]) / d;
 }
-function Qe(e, t, n) {
+function $e(e, t, n) {
 	let r = t + 1, i = new Uint32Array((t + 1) * (n + 1));
 	for (let a = 1; a <= n; a += 1) {
 		let n = 0;
@@ -1088,23 +1092,23 @@ function Qe(e, t, n) {
 		stride: r
 	};
 }
-function $e(e, t, n, r = Math.max(12, Math.round(Math.max(t, n) / 32))) {
-	let { integral: i, stride: a } = Qe(e, t, n), o = new Uint8Array(e.length);
+function et(e, t, n, r = Math.max(12, Math.round(Math.max(t, n) / 32))) {
+	let { integral: i, stride: a } = $e(e, t, n), o = new Uint8Array(e.length);
 	for (let s = 0; s < n; s += 1) for (let c = 0; c < t; c += 1) {
-		let l = Ze(i, a, t, n, c, s, r);
+		let l = Qe(i, a, t, n, c, s, r);
 		o[s * t + c] = Math.max(0, Math.min(255, Math.round(e[s * t + c] * 235 / Math.max(24, l))));
 	}
 	return o;
 }
-function et(e, t, n, r = Math.max(8, Math.round(Math.max(t, n) / 64)), i = .12) {
-	let { integral: a, stride: o } = Qe(e, t, n), s = new Uint8Array(e.length), c = 1 - i;
+function tt(e, t, n, r = Math.max(8, Math.round(Math.max(t, n) / 64)), i = .12) {
+	let { integral: a, stride: o } = $e(e, t, n), s = new Uint8Array(e.length), c = 1 - i;
 	for (let i = 0; i < n; i += 1) for (let l = 0; l < t; l += 1) {
-		let u = Ze(a, o, t, n, l, i, r);
+		let u = Qe(a, o, t, n, l, i, r);
 		s[i * t + l] = e[i * t + l] < u * c ? 0 : 255;
 	}
 	return s;
 }
-function tt(e, t, n) {
+function nt(e, t, n) {
 	let r = [
 		e.topLeft,
 		e.topRight,
@@ -1118,8 +1122,8 @@ function tt(e, t, n) {
 		height: s - a
 	};
 }
-function nt(e, t) {
-	let n = tt(t, e.width, e.height);
+function rt(e, t) {
+	let n = nt(t, e.width, e.height);
 	if (n.width <= 0 || n.height <= 0) return {
 		strong: !1,
 		strength: 0,
@@ -1138,18 +1142,18 @@ function nt(e, t) {
 	i.drawImage(e, n.left, n.top, n.width, n.height, 0, 0, r.width, r.height);
 	let a = i.getImageData(0, 0, r.width, r.height).data, o = new Uint8Array(r.width * r.height);
 	for (let e = 0, t = 0; e < o.length; e += 1, t += 4) o[e] = Math.round(a[t] * .299 + a[t + 1] * .587 + a[t + 2] * .114);
-	return Xe(o, r.width, r.height);
+	return Ze(o, r.width, r.height);
 }
 //#endregion
 //#region src/sdk/finder.ts
-function rt(e, t) {
+function it(e, t) {
 	return t.castShadow && (e.reason === "hold-still" || e.reason === "ready") ? t.hint ?? e.hint : e.hint;
 }
-async function it(e, t) {
+async function at(e, t) {
 	let n = await e();
 	return t(), n;
 }
-function at(e) {
+function ot(e) {
 	return e === "alwaysOn" || e === "only" ? {
 		visible: !1,
 		checked: !0,
@@ -1172,7 +1176,7 @@ function X(e) {
 		e.bottomLeft
 	];
 }
-function ot(e, t) {
+function st(e, t) {
 	let n = e.status === "success" && e.modelStatus !== "failed", r = {
 		status: e.status,
 		confidence: Number(e.confidence.toFixed(3)),
@@ -1195,7 +1199,7 @@ function ot(e, t) {
 		detail: r
 	};
 }
-function st(e) {
+function ct(e) {
 	let t = 0;
 	for (let n = 0; n < e.length; n += 1) {
 		let r = e[n], i = e[(n + 1) % e.length];
@@ -1213,23 +1217,23 @@ var Q = {
 	areaFill: 0,
 	aspectRatio: 1
 };
-function ct(e, t, n) {
+function lt(e, t, n) {
 	let r = X(e), i = r.map(({ x: e }) => e), a = r.map(({ y: e }) => e), o = (Math.max(...i) - Math.min(...i)) / Math.max(1, t), s = (Math.max(...a) - Math.min(...a)) / Math.max(1, n), [c, l, u, d] = r, f = Math.max(Z(c, l), Z(d, u)), p = Math.max(Z(c, d), Z(l, u));
 	return {
 		widthFill: o,
 		heightFill: s,
 		limitingFill: Math.max(o, s),
-		areaFill: st(r) / Math.max(1, t * n),
+		areaFill: ct(r) / Math.max(1, t * n),
 		aspectRatio: Math.max(f, p) / Math.max(1, Math.min(f, p))
 	};
 }
-function lt(e, t, n, r = {}) {
+function ut(e, t, n, r = {}) {
 	let i = t ? r.exitFillRatio ?? .64 : r.minFillRatio ?? .72, a = r.highAspectRatio ?? 2.2;
 	if (e.aspectRatio < a) return i;
 	let o = t ? r.highAspectExitFillRatio : r.highAspectFillRatio;
 	return Math.min(o ?? i + .08, 1 - n * 2);
 }
-function ut(e, t, n = {}) {
+function dt(e, t, n = {}) {
 	let r = n.confidenceThreshold ?? .72;
 	if (e.status !== "success" || !e.quad || e.confidence < r || !e.sourceWidth || !e.sourceHeight) return {
 		hint: "Place the document in the frame",
@@ -1238,7 +1242,7 @@ function ut(e, t, n = {}) {
 		fill: Q,
 		readyForAutoCapture: !1
 	};
-	let i = X(e.quad), a = ct(e.quad, e.sourceWidth, e.sourceHeight), o = a.limitingFill, s = t.previouslyReady ? n.exitEdgeMarginRatio ?? .005 : n.edgeMarginRatio ?? .015, c = e.sourceWidth * s, l = e.sourceHeight * s;
+	let i = X(e.quad), a = lt(e.quad, e.sourceWidth, e.sourceHeight), o = a.limitingFill, s = t.previouslyReady ? n.exitEdgeMarginRatio ?? .005 : n.edgeMarginRatio ?? .015, c = e.sourceWidth * s, l = e.sourceHeight * s;
 	if (i.some(({ x: t, y: n }) => t <= c || t >= e.sourceWidth - c || n <= l || n >= e.sourceHeight - l)) return {
 		hint: "Move farther away",
 		reason: "move-farther-away",
@@ -1253,7 +1257,7 @@ function ut(e, t, n = {}) {
 		fillRatio: o,
 		fill: a,
 		readyForAutoCapture: !1
-	} : o < lt(a, t.previouslyReady === !0, s, n) ? {
+	} : o < ut(a, t.previouslyReady === !0, s, n) ? {
 		hint: "Move closer",
 		reason: "move-closer",
 		fillRatio: o,
@@ -1295,14 +1299,14 @@ var $ = class {
 		};
 	}
 };
-function dt(e, n) {
+function ft(e, n) {
 	let r = Math.min(1, n / Math.max(e.width, e.height)), i = document.createElement("canvas");
 	i.width = Math.max(1, Math.round(e.width * r)), i.height = Math.max(1, Math.round(e.height * r));
 	let a = i.getContext("2d");
 	if (!a) throw t();
 	return a.drawImage(e, 0, 0, i.width, i.height), i;
 }
-function ft() {
+function pt() {
 	let e = window.AudioContext ?? window.webkitAudioContext;
 	if (!e) return;
 	let t = new e(), n = Math.round(t.sampleRate * .09), r = t.createBuffer(1, n, t.sampleRate), i = r.getChannelData(0);
@@ -1313,13 +1317,13 @@ function ft() {
 	let a = t.createBufferSource(), o = t.createBiquadFilter(), s = t.createGain();
 	o.type = "bandpass", o.frequency.value = 1400, s.gain.value = .42, a.buffer = r, a.connect(o).connect(s).connect(t.destination), a.start(), a.onended = () => void t.close();
 }
-async function pt(e) {
+async function mt(e) {
 	let t = document.createElement("video");
 	return t.muted = !0, t.autoplay = !0, t.playsInline = !0, t.srcObject = e, await t.play(), t;
 }
-async function mt(t) {
+async function ht(t) {
 	await x("scan");
-	let n = at(t.autoCapture), r = new $({
+	let n = ot(t.autoCapture), r = new $({
 		stableFrames: t.stableFrames ?? 4,
 		confidenceThreshold: t.confidenceThreshold ?? .72,
 		cornerTolerance: t.cornerTolerance ?? .024,
@@ -1328,7 +1332,7 @@ async function mt(t) {
 		minDimension: 220,
 		maxAnalysisDimension: 520,
 		...t.detection
-	}, s = typeof MediaStream < "u" && t.source instanceof MediaStream ? await pt(t.source) : t.source, c = !0, l = !1, u = !1, d = 0, f, p = "", m = 0, h = {
+	}, s = typeof MediaStream < "u" && t.source instanceof MediaStream ? await mt(t.source) : t.source, c = !0, l = !1, u = !1, d = 0, f, p = "", m = 0, h = {
 		state: "detecting",
 		confidence: 0,
 		guidance: {
@@ -1345,10 +1349,10 @@ async function mt(t) {
 		stableFrames: 0,
 		requiredStableFrames: t.stableFrames ?? 4,
 		autoCapture: { ...n }
-	}, g = () => s instanceof HTMLCanvasElement ? dt(s, i) : Y(s, i), _ = (e) => {
+	}, g = () => s instanceof HTMLCanvasElement ? ft(s, i) : Y(s, i), _ = (e) => {
 		h = e, t.onStatus?.(e);
 	}, v = (e) => {
-		let t = ot(e, s instanceof HTMLVideoElement ? {
+		let t = st(e, s instanceof HTMLVideoElement ? {
 			width: s.videoWidth,
 			height: s.videoHeight
 		} : {
@@ -1363,11 +1367,11 @@ async function mt(t) {
 		l = !0;
 		let n;
 		try {
-			n = await it(t.captureFrame ?? g, () => {
+			n = await at(t.captureFrame ?? g, () => {
 				_({
 					...h,
 					state: "captured"
-				}), t.playShutterSound !== !1 && ft(), y();
+				}), t.playShutterSound !== !1 && pt(), y();
 			});
 		} catch (e) {
 			throw l = !1, e instanceof Error ? e : /* @__PURE__ */ Error("The camera frame could not be captured.");
@@ -1383,7 +1387,7 @@ async function mt(t) {
 			try {
 				let e = g(), i = await R(e, o);
 				f = i, v(i);
-				let a = i.quad ? nt(e, i.quad) : {
+				let a = i.quad ? rt(e, i.quad) : {
 					strong: !1,
 					strength: 0
 				}, s = a.strong ? {
@@ -1393,7 +1397,7 @@ async function mt(t) {
 				} : {
 					castShadow: !1,
 					strength: a.strength
-				}, c = r.update(i), l = ut(i, {
+				}, c = r.update(i), l = dt(i, {
 					...c,
 					previouslyReady: u
 				}, {
@@ -1475,6 +1479,6 @@ async function mt(t) {
 	};
 }
 //#endregion
-export { we as A, b as B, qe as C, R as D, Ce as E, ie as F, e as H, ne as I, a as L, de as M, fe as N, j as O, A as P, o as R, Ee as S, pe as T, t as U, y as V, U as _, ut as a, J as b, et as c, G as d, je as f, Te as g, H as h, ct as i, B as j, z as k, Xe as l, Y as m, at as n, rt as o, ze as p, lt as r, mt as s, $ as t, $e as u, Me as v, K as w, Je as x, q as y, x as z };
+export { z as A, x as B, Ee as C, Ce as D, pe as E, A as F, y as H, ie as I, ne as L, B as M, de as N, R as O, fe as P, a as R, Ye as S, K as T, e as U, b as V, t as W, Je as _, dt as a, q as b, tt as c, G as d, je as f, Te as g, H as h, lt as i, we as j, j as k, Ze as l, Y as m, ot as n, it as o, ze as p, ut as r, ht as s, $ as t, et as u, U as v, qe as w, J as x, Me as y, o as z };
 
-//# sourceMappingURL=finder-Dcg3mVJM.js.map
+//# sourceMappingURL=finder-BlN89ZeT.js.map