@exige/web-scanner-sdk 0.2.39 → 0.2.42

package/README.md

@@ -167,7 +167,7 @@ const finder = await startFinder({
 })
 ```
 
-Auto-capture modes are exactly `defaultOn`, `defaultOff`, `alwaysOn`, `alwaysOff`, and `only`. Default modes expose a mutable end-user checkbox; always modes hide it. `only` forces auto-capture on, hides that checkbox, and hides the manual capture button. `alwaysOn` still shows the manual capture button. `setAutoCapture()` returns false for `only`. High confidence, stable raw corners, 72% fill on the limiting axis, 1.5% edge clearance, and acceptable perspective are required before an automatic snap. After that the finder still waits a 3–2–1 hold-still (`holdStillMs`, default 3000ms) so a just-found page is not captured while the user is still adjusting. Lost or unstable quads reset the countdown. The overlay chip above the shutter shows that instruction; the box uses `readyColorHex` during the hold. Manual capture does not wait. The Android system-camera path has no live box. Fill is the larger of the quad's width and height fill, so a tall receipt or wide boarding pass that already fills its long axis is ready instead of being told to move closer; high-aspect documents are asked for 80% of that long side. Separate, lower exit thresholds keep ready stable through ordinary hand motion. `FinderStatus.guidance` exposes one end-user hint—place the document, move closer, move farther away, hold the camera straight, or hold still—plus its typed reason, limiting-axis fill ratio, and the per-axis `fill` breakdown. Manual capture is always available through `finder.capture()`.
+Auto-capture modes are exactly `defaultOn`, `defaultOff`, `alwaysOn`, `alwaysOff`, and `only`. Default modes expose a mutable end-user checkbox; always modes hide it. `only` forces auto-capture on, hides that checkbox, and hides the manual capture button. `alwaysOn` still shows the manual capture button. `setAutoCapture()` returns false for `only`. High confidence, stable raw corners, 72% fill on the limiting axis, 1.5% edge clearance, and acceptable perspective are required before an automatic snap. After that the finder still waits one second (`holdStillMs`, default 1000ms) so a just-found page is not captured while the user is still adjusting. Lost or unstable quads reset the timer. The overlay chip above the shutter says **Hold still** (no 3–2–1); the box uses `readyColorHex` during the hold. Manual capture does not wait. The Android system-camera path has no live box. Fill is the larger of the quad's width and height fill, so a tall receipt or wide boarding pass that already fills its long axis is ready instead of being told to move closer; high-aspect documents are asked for 80% of that long side. Separate, lower exit thresholds keep ready stable through ordinary hand motion. `FinderStatus.guidance` exposes one end-user hint—place the document, move closer, move farther away, hold the camera straight, or hold still—plus its typed reason, limiting-axis fill ratio, and the per-axis `fill` breakdown. Manual capture is always available through `finder.capture()`.
 
 ### ML corner detection
 

package/dist/components/scanner-camera-overlay.css

@@ -1,2 +1,2 @@
-.scanner-camera-overlay{color:#fff;isolation:isolate;overscroll-behavior:none;touch-action:none;--scanner-overlay-primary:#c8ff45;--scanner-overlay-seeking:#ef6a5b;--scanner-overlay-detecting:#ef6a5b;--scanner-overlay-unstable:#ffbe40;--scanner-overlay-ready:#8af25a;--scanner-overlay-captured:#fff;background:#050806;width:100%;height:100%;font-family:Manrope,ui-sans-serif,system-ui,sans-serif;position:relative;overflow:hidden}.scanner-camera-overlay.is-captured:after{content:"";z-index:10;pointer-events:none;background:#fff;animation:.14s ease-out forwards scanner-camera-flash;position:absolute;inset:0}@keyframes scanner-camera-flash{0%{opacity:.92}to{opacity:0}}.scanner-camera-overlay__video,.scanner-camera-overlay__quad{width:100%;height:100%;position:absolute;inset:0}.scanner-camera-overlay__video{object-fit:cover;background:#050806;display:block}.scanner-camera-overlay__still{z-index:0;pointer-events:none}.model-download-ring{z-index:6;color:#fff;pointer-events:none;background:#080d0ac7;border-radius:50%;place-items:center;width:96px;height:96px;display:grid;position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);box-shadow:0 10px 30px #00000047}.model-download-ring svg{width:100%;height:100%;position:absolute;inset:0;transform:rotate(-90deg)}.model-download-ring circle{fill:none;stroke-width:6px}.model-download-ring .track{stroke:#ffffff47}.model-download-ring .value{stroke:var(--scanner-overlay-primary,#c8ff45);stroke-linecap:round}.model-download-ring.is-indeterminate svg{animation:.9s linear infinite model-download-spin}.model-download-ring.is-indeterminate .value{stroke-dasharray:48 128}.model-download-ring strong{z-index:1;font:600 13px/1 ui-monospace,SFMono-Regular,Menlo,monospace;position:relative}@keyframes model-download-spin{to{transform:rotate(270deg)}}.scanner-camera-overlay__quad.seeking polygon{fill:color-mix(in srgb, var(--scanner-overlay-seeking,#ef6a5b) 8%, transparent);stroke:var(--scanner-overlay-seeking,#ef6a5b)}.scanner-camera-overlay__quad.detecting polygon{fill:color-mix(in srgb, var(--scanner-overlay-detecting,#ef6a5b) 8%, transparent);stroke:var(--scanner-overlay-detecting,#ef6a5b)}.scanner-camera-overlay__quad{z-index:1;pointer-events:none}.scanner-camera-overlay__quad polygon{fill:color-mix(in srgb, var(--scanner-overlay-detecting,#ef6a5b) 8%, transparent);stroke:var(--scanner-overlay-detecting,#ef6a5b);stroke-width:6px;vector-effect:non-scaling-stroke;transition:stroke .15s,fill .15s}.scanner-camera-overlay__quad.unstable polygon{fill:color-mix(in srgb, var(--scanner-overlay-unstable,#ffbe40) 10%, transparent);stroke:var(--scanner-overlay-unstable,#ffbe40)}.scanner-camera-overlay__quad.ready polygon{fill:color-mix(in srgb, var(--scanner-overlay-ready,#8af25a) 10%, transparent);stroke:var(--scanner-overlay-ready,#8af25a)}.scanner-camera-overlay__quad.captured polygon{fill:color-mix(in srgb, var(--scanner-overlay-captured,#fff) 18%, transparent);stroke:var(--scanner-overlay-captured,#fff)}.scanner-camera-overlay__topbar{z-index:3;padding:max(18px, env(safe-area-inset-top)) max(18px, env(safe-area-inset-right)) 48px max(18px, env(safe-area-inset-left));background:linear-gradient(#030704db,#0000);justify-content:space-between;align-items:flex-start;gap:20px;display:flex;position:absolute;top:0;left:0;right:0}.scanner-camera-overlay__topbar div{gap:5px;display:grid}.scanner-camera-overlay__topbar strong{font-size:clamp(18px,4vw,26px)}.scanner-camera-overlay__topbar span{color:#ffffffb8;font-size:12px}.scanner-camera-overlay__topbar button{color:#fff;background:#050a0799;border:1px solid #ffffff61;border-radius:50%;flex:none;width:46px;height:46px;font-size:28px;line-height:1}.scanner-camera-overlay__message{z-index:4;text-align:center;background:#0a100ceb;border:1px solid #fff3;border-radius:14px;justify-items:center;gap:12px;width:min(420px,100% - 40px);padding:26px;display:grid;position:absolute;top:50%;left:50%;translate:-50% -50%}.scanner-camera-overlay__message p{color:#ffffffb3;margin:0;font-size:13px;line-height:1.5}.scanner-camera-overlay__message div{gap:10px;display:flex}.scanner-camera-overlay__message button{color:#fff;background:0 0;border:1px solid #ffffff6b;border-radius:7px;min-height:44px;padding:0 16px}.scanner-camera-overlay__spinner{border:3px solid #fff3;border-top-color:var(--scanner-overlay-primary,#c8ff45);border-radius:50%;width:28px;height:28px;animation:.8s linear infinite scanner-camera-spin}@keyframes scanner-camera-spin{to{rotate:1turn}}.scanner-camera-overlay__readout{z-index:3;top:max(94px, calc(env(safe-area-inset-top) + 72px));left:max(18px, env(safe-area-inset-left));gap:8px;max-width:calc(100% - 36px);display:grid;position:absolute}.scanner-camera-overlay__status{text-transform:uppercase;background:#050a07c2;border-radius:6px;flex-direction:column;align-items:flex-start;gap:4px;max-width:100%;padding:8px 10px;font:9px/1.2 ui-monospace,SFMono-Regular,Menlo,monospace;display:flex}.scanner-camera-overlay__status-line{flex-wrap:wrap;align-items:center;gap:7px;max-width:100%;display:flex}.scanner-camera-overlay__status-line>span{background:var(--scanner-overlay-detecting,#ef6a5b);border-radius:50%;flex:none;width:7px;height:7px}.scanner-camera-overlay__status-line>span.seeking{background:var(--scanner-overlay-seeking,#ef6a5b)}.scanner-camera-overlay__status-line>span.detecting{background:var(--scanner-overlay-detecting,#ef6a5b)}.scanner-camera-overlay__status-line>span.unstable{background:var(--scanner-overlay-unstable,#ffbe40)}.scanner-camera-overlay__status-line>span.ready{background:var(--scanner-overlay-ready,#8af25a)}.scanner-camera-overlay__status-line>span.captured{background:var(--scanner-overlay-captured,#fff)}.scanner-camera-overlay__decoder{color:#d9f7c4;text-transform:none;font-size:12px;line-height:1.2}.scanner-camera-overlay__diagnostics{background:#050a07b8;border-radius:6px;gap:2px;max-width:100%;margin:0;padding:8px 10px;font:9px/1.35 ui-monospace,SFMono-Regular,Menlo,monospace;display:grid}.scanner-camera-overlay__diagnostics>div{gap:6px;display:flex}.scanner-camera-overlay__diagnostics dt{color:#ffffff8c;text-transform:uppercase;min-width:44px}.scanner-camera-overlay__diagnostics dd{color:#d9f7c4;margin:0}.scanner-camera-overlay__copy{color:#fff;font:inherit;text-underline-offset:2px;background:0 0;border:0;margin:0;padding:0;text-decoration:underline}.scanner-camera-overlay__copy:focus-visible{outline:2px solid var(--scanner-overlay-ready,#8af25a);outline-offset:2px}.scanner-camera-overlay__controls{z-index:3;padding:60px max(18px, env(safe-area-inset-right)) max(22px, env(safe-area-inset-bottom)) max(18px, env(safe-area-inset-left));background:linear-gradient(#0000,#030704eb);grid-template-columns:minmax(90px,1fr) minmax(140px,auto) minmax(90px,1fr);align-items:end;gap:18px;display:grid;position:absolute;bottom:0;left:0;right:0}.scanner-camera-overlay__cancel{color:#fff;background:#050a0766;border:1px solid #ffffff6b;border-radius:8px;min-height:46px}.scanner-camera-overlay__capture{justify-items:center;gap:10px;display:grid;position:relative}.scanner-camera-overlay__guidance{z-index:4;color:#fff;text-align:center;background:#111;border:2px solid #fff;border-radius:999px;width:max-content;max-width:min(22rem,100vw - 36px);margin:0;padding:8px 14px;font-size:14px;font-weight:650;line-height:1.3;position:absolute;bottom:calc(100% + 14px);left:50%;transform:translate(-50%);box-shadow:0 0 0 2px #111,0 8px 22px #00000080}.scanner-camera-overlay__guidance.is-ready{border-color:var(--scanner-overlay-ready,#8af25a)}.scanner-camera-overlay__toggles{flex-wrap:wrap;justify-content:center;align-items:center;gap:8px 14px;display:flex}.scanner-camera-overlay__toggles label{white-space:nowrap;align-items:center;gap:7px;min-height:34px;font-size:11px;display:flex}.scanner-camera-overlay__toggles input{width:22px;height:22px;accent-color:var(--scanner-overlay-primary,#c8ff45)}.scanner-camera-overlay__toggles input:disabled{opacity:.85}.scanner-camera-overlay__shutter{background:0 0;border:3px solid #fff;border-radius:50%;place-items:center;width:74px;height:74px;padding:6px;display:grid}.scanner-camera-overlay__shutter span{background:#fff;border-radius:50%;width:100%;height:100%;display:block}.scanner-camera-overlay__shutter:disabled{opacity:.42}.scanner-camera-overlay__quality{justify-items:end;gap:4px;padding-bottom:8px;font-size:10px;display:grid}.scanner-camera-overlay__quality span{color:#ffffff94;text-transform:uppercase}.scanner-camera-overlay__quality strong{font:10px ui-monospace,SFMono-Regular,Menlo,monospace}@media (width<=560px){.scanner-camera-overlay__controls{grid-template-columns:72px 1fr 72px;gap:10px}.scanner-camera-overlay__quality strong{text-align:right;max-width:72px}}@media (orientation:landscape) and (height<=560px){.scanner-camera-overlay__controls{padding-top:20px}.scanner-camera-overlay__shutter{width:60px;height:60px}}
+.scanner-camera-overlay{color:#fff;isolation:isolate;overscroll-behavior:none;touch-action:none;--scanner-overlay-primary:#c8ff45;--scanner-overlay-seeking:#ef6a5b;--scanner-overlay-detecting:#ef6a5b;--scanner-overlay-unstable:#ffbe40;--scanner-overlay-ready:#8af25a;--scanner-overlay-captured:#fff;background:#050806;width:100%;height:100%;font-family:Manrope,ui-sans-serif,system-ui,sans-serif;position:relative;overflow:hidden}.scanner-camera-overlay.is-captured:after{content:"";z-index:10;pointer-events:none;background:#fff;animation:.14s ease-out forwards scanner-camera-flash;position:absolute;inset:0}@keyframes scanner-camera-flash{0%{opacity:.92}to{opacity:0}}.scanner-camera-overlay__video,.scanner-camera-overlay__quad{width:100%;height:100%;position:absolute;inset:0}.scanner-camera-overlay__video{object-fit:cover;background:#050806;display:block}.scanner-camera-overlay__still{z-index:0;pointer-events:none}.model-download-ring{z-index:6;color:#fff;pointer-events:none;background:#080d0ac7;border-radius:50%;place-items:center;width:96px;height:96px;display:grid;position:absolute;top:50%;left:50%;transform:translate(-50%,-50%);box-shadow:0 10px 30px #00000047}.model-download-ring svg{width:100%;height:100%;position:absolute;inset:0;transform:rotate(-90deg)}.model-download-ring circle{fill:none;stroke-width:6px}.model-download-ring .track{stroke:#ffffff47}.model-download-ring .value{stroke:var(--scanner-overlay-primary,#c8ff45);stroke-linecap:round}.model-download-ring.is-indeterminate svg{animation:.9s linear infinite model-download-spin}.model-download-ring.is-indeterminate .value{stroke-dasharray:48 128}.model-download-ring strong{z-index:1;font:600 13px/1 ui-monospace,SFMono-Regular,Menlo,monospace;position:relative}@keyframes model-download-spin{to{transform:rotate(270deg)}}.scanner-camera-overlay__quad.seeking polygon{fill:color-mix(in srgb, var(--scanner-overlay-seeking,#ef6a5b) 8%, transparent);stroke:var(--scanner-overlay-seeking,#ef6a5b)}.scanner-camera-overlay__quad.detecting polygon{fill:color-mix(in srgb, var(--scanner-overlay-detecting,#ef6a5b) 8%, transparent);stroke:var(--scanner-overlay-detecting,#ef6a5b)}.scanner-camera-overlay__quad{z-index:1;pointer-events:none}.scanner-camera-overlay__quad polygon{fill:color-mix(in srgb, var(--scanner-overlay-detecting,#ef6a5b) 8%, transparent);stroke:var(--scanner-overlay-detecting,#ef6a5b);stroke-width:6px;vector-effect:non-scaling-stroke;transition:stroke .15s,fill .15s}.scanner-camera-overlay__quad.unstable polygon{fill:color-mix(in srgb, var(--scanner-overlay-unstable,#ffbe40) 10%, transparent);stroke:var(--scanner-overlay-unstable,#ffbe40)}.scanner-camera-overlay__quad.ready polygon{fill:color-mix(in srgb, var(--scanner-overlay-ready,#8af25a) 10%, transparent);stroke:var(--scanner-overlay-ready,#8af25a)}.scanner-camera-overlay__quad.captured polygon{fill:color-mix(in srgb, var(--scanner-overlay-captured,#fff) 18%, transparent);stroke:var(--scanner-overlay-captured,#fff)}.scanner-camera-overlay__topbar{z-index:3;padding:max(18px, env(safe-area-inset-top)) max(18px, env(safe-area-inset-right)) 48px max(18px, env(safe-area-inset-left));background:linear-gradient(#030704db,#0000);justify-content:space-between;align-items:flex-start;gap:20px;display:flex;position:absolute;top:0;left:0;right:0}.scanner-camera-overlay__topbar div{gap:5px;display:grid}.scanner-camera-overlay__topbar strong{font-size:clamp(18px,4vw,26px)}.scanner-camera-overlay__topbar span{color:#ffffffb8;font-size:12px}.scanner-camera-overlay__topbar button{color:#fff;background:#050a0799;border:1px solid #ffffff61;border-radius:50%;flex:none;width:46px;height:46px;font-size:28px;line-height:1}.scanner-camera-overlay__flip{z-index:8;padding:max(20px, env(safe-area-inset-top)) max(20px, env(safe-area-inset-right)) max(20px, env(safe-area-inset-bottom)) max(20px, env(safe-area-inset-left));color:#fff;background:#050806d1;place-items:center;display:grid;position:absolute;inset:0}.scanner-camera-overlay__flip .scanner-camera-overlay__message{color:#fff;background:#101810;border-color:#ffffff47;width:min(420px,100%);position:relative;top:auto;left:auto;translate:none}.scanner-camera-overlay__flip .scanner-camera-overlay__message p{color:#ffffffc7}.scanner-camera-overlay__flip .scanner-camera-overlay__message button{background:var(--scanner-overlay-primary,#c8ff45);color:#0a100c;border-color:#0000;min-width:148px;font-weight:600}@media (prefers-color-scheme:light){.scanner-camera-overlay__flip{color:#102016;background:#f8faf7e0}.scanner-camera-overlay__flip .scanner-camera-overlay__message{color:#102016;background:#fff;border-color:#10201624;box-shadow:0 16px 40px #1020161f}.scanner-camera-overlay__flip .scanner-camera-overlay__message p{color:#102016b8}.scanner-camera-overlay__flip .scanner-camera-overlay__message button{color:#fff;background:#122016}}.scanner-camera-overlay:has(.scanner-camera-overlay__flip) .scanner-camera-overlay__topbar{z-index:9}.scanner-camera-overlay__message{z-index:4;color:#fff;text-align:center;background:#0a100ceb;border:1px solid #fff3;border-radius:14px;justify-items:center;gap:12px;width:min(420px,100% - 40px);padding:26px;display:grid;position:absolute;top:50%;left:50%;translate:-50% -50%}.scanner-camera-overlay__message p{color:#ffffffb3;margin:0;font-size:13px;line-height:1.5}.scanner-camera-overlay__message div{gap:10px;display:flex}.scanner-camera-overlay__message button{color:#fff;background:0 0;border:1px solid #ffffff6b;border-radius:7px;min-height:44px;padding:0 16px}.scanner-camera-overlay__spinner{border:3px solid #fff3;border-top-color:var(--scanner-overlay-primary,#c8ff45);border-radius:50%;width:28px;height:28px;animation:.8s linear infinite scanner-camera-spin}@keyframes scanner-camera-spin{to{rotate:1turn}}.scanner-camera-overlay__readout{z-index:3;top:max(94px, calc(env(safe-area-inset-top) + 72px));left:max(18px, env(safe-area-inset-left));gap:8px;max-width:calc(100% - 36px);display:grid;position:absolute}.scanner-camera-overlay__status{text-transform:uppercase;background:#050a07c2;border-radius:6px;flex-direction:column;align-items:flex-start;gap:4px;max-width:100%;padding:8px 10px;font:9px/1.2 ui-monospace,SFMono-Regular,Menlo,monospace;display:flex}.scanner-camera-overlay__status-line{flex-wrap:wrap;align-items:center;gap:7px;max-width:100%;display:flex}.scanner-camera-overlay__status-line>span{background:var(--scanner-overlay-detecting,#ef6a5b);border-radius:50%;flex:none;width:7px;height:7px}.scanner-camera-overlay__status-line>span.seeking{background:var(--scanner-overlay-seeking,#ef6a5b)}.scanner-camera-overlay__status-line>span.detecting{background:var(--scanner-overlay-detecting,#ef6a5b)}.scanner-camera-overlay__status-line>span.unstable{background:var(--scanner-overlay-unstable,#ffbe40)}.scanner-camera-overlay__status-line>span.ready{background:var(--scanner-overlay-ready,#8af25a)}.scanner-camera-overlay__status-line>span.captured{background:var(--scanner-overlay-captured,#fff)}.scanner-camera-overlay__decoder{color:#d9f7c4;text-transform:none;font-size:12px;line-height:1.2}.scanner-camera-overlay__diagnostics{background:#050a07b8;border-radius:6px;gap:2px;max-width:100%;margin:0;padding:8px 10px;font:9px/1.35 ui-monospace,SFMono-Regular,Menlo,monospace;display:grid}.scanner-camera-overlay__diagnostics>div{gap:6px;display:flex}.scanner-camera-overlay__diagnostics dt{color:#ffffff8c;text-transform:uppercase;min-width:44px}.scanner-camera-overlay__diagnostics dd{color:#d9f7c4;margin:0}.scanner-camera-overlay__copy{color:#fff;font:inherit;text-underline-offset:2px;background:0 0;border:0;margin:0;padding:0;text-decoration:underline}.scanner-camera-overlay__copy:focus-visible{outline:2px solid var(--scanner-overlay-ready,#8af25a);outline-offset:2px}.scanner-camera-overlay__controls{z-index:3;padding:60px max(18px, env(safe-area-inset-right)) max(22px, env(safe-area-inset-bottom)) max(18px, env(safe-area-inset-left));background:linear-gradient(#0000,#030704eb);grid-template-columns:minmax(90px,1fr) minmax(140px,auto) minmax(90px,1fr);align-items:end;gap:18px;display:grid;position:absolute;bottom:0;left:0;right:0}.scanner-camera-overlay__cancel{color:#fff;background:#050a0766;border:1px solid #ffffff6b;border-radius:8px;min-height:46px}.scanner-camera-overlay__capture{justify-items:center;gap:10px;display:grid;position:relative}.scanner-camera-overlay__guidance{z-index:4;color:#fff;text-align:center;background:#111;border:2px solid #fff;border-radius:999px;width:max-content;max-width:min(22rem,100vw - 36px);margin:0;padding:8px 14px;font-size:14px;font-weight:650;line-height:1.3;position:absolute;bottom:calc(100% + 14px);left:50%;transform:translate(-50%);box-shadow:0 0 0 2px #111,0 8px 22px #00000080}.scanner-camera-overlay__guidance.is-ready{border-color:var(--scanner-overlay-ready,#8af25a)}.scanner-camera-overlay__toggles{flex-wrap:wrap;justify-content:center;align-items:center;gap:8px 14px;display:flex}.scanner-camera-overlay__toggles label{white-space:nowrap;align-items:center;gap:7px;min-height:34px;font-size:11px;display:flex}.scanner-camera-overlay__toggles input{width:22px;height:22px;accent-color:var(--scanner-overlay-primary,#c8ff45)}.scanner-camera-overlay__toggles input:disabled{opacity:.85}.scanner-camera-overlay__shutter{background:0 0;border:3px solid #fff;border-radius:50%;place-items:center;width:74px;height:74px;padding:6px;display:grid}.scanner-camera-overlay__shutter span{background:#fff;border-radius:50%;width:100%;height:100%;display:block}.scanner-camera-overlay__shutter:disabled{opacity:.42}.scanner-camera-overlay__quality{justify-items:end;gap:4px;padding-bottom:8px;font-size:10px;display:grid}.scanner-camera-overlay__quality span{color:#ffffff94;text-transform:uppercase}.scanner-camera-overlay__quality strong{font:10px ui-monospace,SFMono-Regular,Menlo,monospace}@media (width<=560px){.scanner-camera-overlay__controls{grid-template-columns:72px 1fr 72px;gap:10px}.scanner-camera-overlay__quality strong{text-align:right;max-width:72px}}@media (orientation:landscape) and (height<=560px){.scanner-camera-overlay__controls{padding-top:20px}.scanner-camera-overlay__shutter{width:60px;height:60px}}
 /*$vite$:1*/