pi-kiosk-shared 2.2.98 → 2.3.0

package/dist/hooks/scannerPlatformProfile.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Platform-specific scanner engine ordering and UX hints.
+ * Firefox: ZBar WASM + @zxing only — no @undecaf/barcode-detector-polyfill package.
+ */
+export type ScannerPlatformProfileId = 'chrome-android' | 'chrome-desktop' | 'ios-safari' | 'crios-ios' | 'firefox-desktop' | 'generic';
+export interface ScannerPlatformProfile {
+    readonly id: ScannerPlatformProfileId;
+    /** Prefer preview snap CTA over live-only decode (PC webcams). */
+    readonly preferPreviewSnap: boolean;
+    /** Run Chromium BarcodeDetector when probe succeeds. */
+    readonly nativeEnabled: boolean;
+    /** ZBar full pass every frame (desktop); mobile uses budget backoff in hook. */
+    readonly zbarFullPassEveryFrame: boolean;
+    /** @zxing assist starts on frame 0 (always true in v2.2). */
+    readonly zxingFrameZero: boolean;
+}
+/**
+ * Resolve scanner platform profile from UA + feature hints.
+ * Safe in SSR (returns `generic`).
+ */
+export declare function resolveScannerPlatformProfile(): ScannerPlatformProfile;
+export { resolveScannerPlatformProfile as getScannerPlatformProfile };
+//# sourceMappingURL=scannerPlatformProfile.d.ts.map

package/dist/hooks/scannerPlatformProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scannerPlatformProfile.d.ts","sourceRoot":"","sources":["../../src/hooks/scannerPlatformProfile.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,gBAAgB,GAChB,YAAY,GACZ,WAAW,GACX,iBAAiB,GACjB,SAAS,CAAC;AAEd,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,wBAAwB,CAAC;IACtC,kEAAkE;IAClE,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,wDAAwD;IACxD,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,gFAAgF;IAChF,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAsBD;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,sBAAsB,CAyDtE;AAYD,OAAO,EAAE,6BAA6B,IAAI,yBAAyB,EAAE,CAAC"}

package/dist/hooks/scannerPlatformProfile.js

@@ -0,0 +1,86 @@
+/**
+ * Platform-specific scanner engine ordering and UX hints.
+ * Firefox: ZBar WASM + @zxing only — no @undecaf/barcode-detector-polyfill package.
+ */
+function isIosDevice(ua) {
+    return /iPad|iPhone|iPod/.test(ua) || (ua.includes('Mac') && typeof document !== 'undefined' && 'ontouchend' in document);
+}
+function isCriOs(ua) {
+    return /CriOS/.test(ua);
+}
+function isFirefox(ua) {
+    return /Firefox\//.test(ua) && !/Seamonkey|Waterfox/.test(ua);
+}
+function isChromeDesktop(ua) {
+    return /Chrome\//.test(ua) && !/Edg\/|OPR\/|CriOS|Mobile/.test(ua);
+}
+function isChromeAndroid(ua) {
+    return /Android/.test(ua) && /Chrome\//.test(ua) && !/Edg\//.test(ua);
+}
+/**
+ * Resolve scanner platform profile from UA + feature hints.
+ * Safe in SSR (returns `generic`).
+ */
+export function resolveScannerPlatformProfile() {
+    if (typeof navigator === 'undefined') {
+        return genericProfile();
+    }
+    const ua = navigator.userAgent;
+    if (isFirefox(ua)) {
+        return {
+            id: 'firefox-desktop',
+            preferPreviewSnap: true,
+            nativeEnabled: false,
+            zbarFullPassEveryFrame: true,
+            zxingFrameZero: true,
+        };
+    }
+    if (isCriOs(ua) && isIosDevice(ua)) {
+        return {
+            id: 'crios-ios',
+            preferPreviewSnap: false,
+            nativeEnabled: false,
+            zbarFullPassEveryFrame: false,
+            zxingFrameZero: true,
+        };
+    }
+    if (isIosDevice(ua)) {
+        return {
+            id: 'ios-safari',
+            preferPreviewSnap: false,
+            nativeEnabled: false,
+            zbarFullPassEveryFrame: false,
+            zxingFrameZero: true,
+        };
+    }
+    if (isChromeDesktop(ua)) {
+        return {
+            id: 'chrome-desktop',
+            preferPreviewSnap: true,
+            nativeEnabled: true,
+            zbarFullPassEveryFrame: true,
+            zxingFrameZero: true,
+        };
+    }
+    if (isChromeAndroid(ua)) {
+        return {
+            id: 'chrome-android',
+            preferPreviewSnap: false,
+            nativeEnabled: true,
+            zbarFullPassEveryFrame: true,
+            zxingFrameZero: true,
+        };
+    }
+    return genericProfile();
+}
+function genericProfile() {
+    return {
+        id: 'generic',
+        preferPreviewSnap: false,
+        nativeEnabled: typeof window !== 'undefined' && window.BarcodeDetector !== undefined,
+        zbarFullPassEveryFrame: false,
+        zxingFrameZero: true,
+    };
+}
+export { resolveScannerPlatformProfile as getScannerPlatformProfile };
+//# sourceMappingURL=scannerPlatformProfile.js.map

package/dist/hooks/scannerPlatformProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scannerPlatformProfile.js","sourceRoot":"","sources":["../../src/hooks/scannerPlatformProfile.ts"],"names":[],"mappings":"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"}

package/dist/hooks/selectEngine.d.ts

@@ -1,11 +1,13 @@
 /**
  * Decode engines used by {@link useBarcodeScanner}:
  * - `zbar-wasm` — ZBar C/C++ WASM (primary when boot succeeds; retail EAN/UPC + QR)
- * - `zxing` — pure-JS @zxing/browser timed parallel assist (G4) when ZBar runs but
- *   does not decode within the assist delay; not a boot fallback
- * - `native-detector` — Chromium BarcodeDetector parallel assist; never the sole engine
+ * - `zxing` — pure-JS @zxing/browser parallel assist starting on **frame 0** (v2.2)
+ * - `native-detector` — Chromium BarcodeDetector parallel assist when probe succeeds
+ *
+ * Boot failure (missing WASM URL / ZBar init error) → **degraded boot**: `degradedMode: true`,
+ * `@zxing` + native (if available) run without hard error. Surfaces must read
+ * `UseBarcodeScannerReturn.degradedMode`, not infer from `engine === 'zxing'` alone.
  *
- * Boot failure (missing WASM URL / ZBar init error) → `status: 'error'`, not `@zxing`.
  * Engine selection lives only in `useBarcodeScanner`.
  */
 export type ScannerEngine = 'zbar-wasm' | 'zxing' | 'native-detector';

package/dist/hooks/selectEngine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"selectEngine.d.ts","sourceRoot":"","sources":["../../src/hooks/selectEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,OAAO,GAAG,iBAAiB,CAAC"}
+{"version":3,"file":"selectEngine.d.ts","sourceRoot":"","sources":["../../src/hooks/selectEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,OAAO,GAAG,iBAAiB,CAAC"}

package/dist/hooks/useBarcodeScanner.d.ts

@@ -2,20 +2,12 @@ import './scannerNativeTypes.js';
 import type { ScannerEngine } from './selectEngine.js';
 import { type BarcodeScannerFormatProfile } from './scannerFormats.js';
 export type ScannerStatus = 'idle' | 'starting' | 'running' | 'denied' | 'error';
-/**
- * Optical zoom on ZBar primary path (focus/torch only on open).
- */
 export declare const SCANNER_DISTANCE_ASSIST_DELAY_MS = 1500;
-/**
- * After ZBar is running with no decode, start @zxing stream + multi-pass in
- * parallel (does not stop ZBar — G4 safety net for close EANs ZBar misses).
- */
+/** @deprecated Distance-zoom assist delay only — @zxing assist starts on frame 0 (v2.2). */
 export declare const SCANNER_ZBAR_ZXING_ASSIST_DELAY_MS = 1500;
-/**
- * Extra wait after @zxing multi-pass starts before optical zoom on the rare
- * legacy @zxing-only path (unused when G3 hard-fail is active).
- */
 export declare const SCANNER_DISTANCE_ZOOM_DELAY_MS = 1500;
+/** Minimum gap after a successful decode before another emit (G30 post-decode UX). */
+export declare const SCANNER_POST_DECODE_COOLDOWN_MS = 600;
 export interface UseBarcodeScannerMessages {
     permissionDenied: string;
     noCamera: string;
@@ -24,15 +16,10 @@ export interface UseBarcodeScannerMessages {
     runningZxing: string;
     error: string;
     scannerOff: string;
-    /**
-     * ZBar WASM URL missing or scanner boot failed — hard error (G3).
-     * Falls back to `error` when omitted.
-     */
     zbarBootstrapFailed?: string;
-    /**
-     * Shown while `engine === 'zbar-wasm'` (G10). Falls back to `runningZxing`.
-     */
     runningZbar?: string;
+    /** Shown when `degradedMode === true` (ZBar unavailable, @zxing/native running). */
+    runningDegraded?: string;
     insecureContext?: string;
     cameraInUse?: string;
     policyBlocked?: string;
@@ -44,26 +31,19 @@ export interface UseBarcodeScannerOptions {
     messages: UseBarcodeScannerMessages;
     formatProfile?: BarcodeScannerFormatProfile;
     onBackgroundStop?: () => void;
-    /**
-     * Bump from a user-gesture retry handler to restart getUserMedia without
-     * toggling `enabled` (mobile Safari keeps the permission prompt in-gesture).
-     */
     sessionKey?: number;
+    preAcquiredStreamRef?: React.MutableRefObject<MediaStream | null>;
 }
 export interface UseBarcodeScannerReturn {
     status: ScannerStatus;
     engine: ScannerEngine | null;
-    /** True while G4 parallel @zxing stream or multi-pass assist is active (ZBar may still run). */
     zxingAssistActive: boolean;
+    /** True when ZBar WASM failed to boot and @zxing/native degraded path is active. */
+    degradedMode: boolean;
     errorMessage: string | null;
 }
 /**
- * Live camera barcode/QR decode.
- *
- * Primary: ZBar WASM multi-pass (immediate) + Chromium BarcodeDetector in parallel.
- * G3: hard-fail when WASM URL unset or ZBar boot fails — no silent @zxing fallback.
- * G4: after {@link SCANNER_ZBAR_ZXING_ASSIST_DELAY_MS} with no lock, @zxing assist
- * runs in parallel without stopping ZBar.
+ * Live camera barcode/QR decode — multi-engine parallel (ZBar + native + @zxing).
  */
 export declare function useBarcodeScanner(options: UseBarcodeScannerOptions): UseBarcodeScannerReturn;
 //# sourceMappingURL=useBarcodeScanner.d.ts.map

package/dist/hooks/useBarcodeScanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBarcodeScanner.d.ts","sourceRoot":"","sources":["../../src/hooks/useBarcodeScanner.ts"],"names":[],"mappings":"AAGA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,qBAAqB,CAAC;AAgB7B,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,kCAAkC,OAAmC,CAAC;AAEnF;;;GAGG;AACH,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAEnD,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwBD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,aAAa,CAAC,EAAE,2BAA2B,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,gGAAgG;IAChG,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAKD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CA4iB5F"}
+{"version":3,"file":"useBarcodeScanner.d.ts","sourceRoot":"","sources":["../../src/hooks/useBarcodeScanner.ts"],"names":[],"mappings":"AAIA,OAAO,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAEL,KAAK,2BAA2B,EACjC,MAAM,qBAAqB,CAAC;AAiB7B,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEjF,eAAO,MAAM,gCAAgC,OAAO,CAAC;AAErD,4FAA4F;AAC5F,eAAO,MAAM,kCAAkC,OAAmC,CAAC;AAEnF,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAInD,sFAAsF;AACtF,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAInD,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oFAAoF;IACpF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAuGD,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,aAAa,CAAC,EAAE,2BAA2B,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,KAAK,CAAC,gBAAgB,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACnE;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oFAAoF;IACpF,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,uBAAuB,CA4mB5F"}