pi-kiosk-shared 2.3.3 → 2.3.5

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

@@ -0,0 +1 @@
+{"version":3,"file":"scannerScanPasses.d.ts","sourceRoot":"","sources":["../../src/hooks/scannerScanPasses.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,EAAE,CAKtF;AAED,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,EAAE,CA0DjG"}

package/dist/hooks/scannerScanPasses.js

@@ -0,0 +1,66 @@
+/**
+ * Full frame + center zooms + mid-band (1D) + four corner crops + optional tight center.
+ * Covers off-center / distant codes that are not in the viewfinder center.
+ *
+ * CPU bound: at most 10 passes (1 full + 3 center + 1 mid-band + 4 corners + 1 tight center).
+ * Do not add more regions without raising this documented ceiling (~10–12 max).
+ */
+/** Full-frame only — cheap first pass (~1 crop per tick; G9 CPU bound). */
+export function buildQuickScanPass(videoWidth, videoHeight) {
+    if (videoWidth < 2 || videoHeight < 2) {
+        return [];
+    }
+    return [{ sx: 0, sy: 0, sw: videoWidth, sh: videoHeight, scale: 1 }];
+}
+export function buildMaxSensitivityScanPasses(videoWidth, videoHeight) {
+    const vw = videoWidth;
+    const vh = videoHeight;
+    if (vw < 2 || vh < 2) {
+        return [];
+    }
+    const center = (frac, scale) => {
+        const sw = Math.max(2, Math.floor(vw * frac));
+        const sh = Math.max(2, Math.floor(vh * frac));
+        return {
+            sx: Math.floor((vw - sw) / 2),
+            sy: Math.floor((vh - sh) / 2),
+            sw,
+            sh,
+            scale,
+        };
+    };
+    /** Corner crop: `frac`×`frac` of the frame anchored at a corner (off-center). */
+    const corner = (anchor, frac, scale) => {
+        const sw = Math.max(2, Math.floor(vw * frac));
+        const sh = Math.max(2, Math.floor(vh * frac));
+        const sx = anchor === 'tr' || anchor === 'br' ? vw - sw : 0;
+        const sy = anchor === 'bl' || anchor === 'br' ? vh - sh : 0;
+        return { sx, sy, sw, sh, scale };
+    };
+    const bandH = Math.max(2, Math.floor(vh * 0.28));
+    const midBand = {
+        sx: 0,
+        sy: Math.floor((vh - bandH) / 2),
+        sw: vw,
+        sh: bandH,
+        scale: 2,
+    };
+    return [
+        // 1. full frame
+        { sx: 0, sy: 0, sw: vw, sh: vh, scale: 1 },
+        // 2–4. center zooms
+        center(0.7, 1.75),
+        center(0.5, 2.25),
+        center(0.35, 3),
+        // 5. mid-band 1D
+        midBand,
+        // 6–9. four corner crops (off-center distant codes)
+        corner('tl', 0.4, 2.75),
+        corner('tr', 0.4, 2.75),
+        corner('bl', 0.4, 2.75),
+        corner('br', 0.4, 2.75),
+        // 10. stronger tight center
+        center(0.25, 3.5),
+    ];
+}
+//# sourceMappingURL=scannerScanPasses.js.map

package/dist/hooks/scannerScanPasses.js.map

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

package/dist/hooks/selectEngine.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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 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.
+ *
+ * Engine selection lives only in `useBarcodeScanner`.
+ */
+export type ScannerEngine = 'zbar-wasm' | 'zxing' | 'native-detector';
+//# sourceMappingURL=selectEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"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/selectEngine.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=selectEngine.js.map

package/dist/hooks/selectEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectEngine.js","sourceRoot":"","sources":["../../src/hooks/selectEngine.ts"],"names":[],"mappings":""}

package/dist/hooks/zxingJsSensitiveDecode.d.ts

@@ -0,0 +1,13 @@
+/**
+ * High-sensitivity pure-JS @zxing decode (the library that previously worked).
+ * Multi-pass digital zoom + TRY_HARDER for distant / small codes.
+ */
+import { BrowserMultiFormatReader } from '@zxing/browser';
+import { BarcodeFormat } from '@zxing/library';
+export declare function createSensitiveZxingReader(formats: readonly BarcodeFormat[]): BrowserMultiFormatReader;
+/**
+ * Decode one video frame via multi-pass canvas crops → @zxing decodeFromCanvas.
+ * Returns the first payload or null when nothing is found.
+ */
+export declare function decodeVideoFrameWithZxingJs(video: HTMLVideoElement, canvas: HTMLCanvasElement, reader: BrowserMultiFormatReader): string | null;
+//# sourceMappingURL=zxingJsSensitiveDecode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"zxingJsSensitiveDecode.d.ts","sourceRoot":"","sources":["../../src/hooks/zxingJsSensitiveDecode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAG/D,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,SAAS,aAAa,EAAE,GAChC,wBAAwB,CAK1B;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,wBAAwB,GAC/B,MAAM,GAAG,IAAI,CAwCf"}

package/dist/hooks/zxingJsSensitiveDecode.js

@@ -0,0 +1,54 @@
+/**
+ * High-sensitivity pure-JS @zxing decode (the library that previously worked).
+ * Multi-pass digital zoom + TRY_HARDER for distant / small codes.
+ */
+import { BrowserMultiFormatReader } from '@zxing/browser';
+import { DecodeHintType } from '@zxing/library';
+import { buildMaxSensitivityScanPasses } from './scannerScanPasses.js';
+export function createSensitiveZxingReader(formats) {
+    const hints = new Map();
+    hints.set(DecodeHintType.POSSIBLE_FORMATS, [...formats]);
+    hints.set(DecodeHintType.TRY_HARDER, true);
+    return new BrowserMultiFormatReader(hints);
+}
+/**
+ * Decode one video frame via multi-pass canvas crops → @zxing decodeFromCanvas.
+ * Returns the first payload or null when nothing is found.
+ */
+export function decodeVideoFrameWithZxingJs(video, canvas, reader) {
+    const width = video.videoWidth;
+    const height = video.videoHeight;
+    if (width < 2 || height < 2) {
+        return null;
+    }
+    const ctx = canvas.getContext('2d', { willReadFrequently: true });
+    if (ctx === null) {
+        return null;
+    }
+    ctx.imageSmoothingEnabled = false;
+    const passes = buildMaxSensitivityScanPasses(width, height);
+    for (const pass of passes) {
+        const outW = Math.max(2, Math.floor(pass.sw * pass.scale));
+        const outH = Math.max(2, Math.floor(pass.sh * pass.scale));
+        if (canvas.width !== outW) {
+            canvas.width = outW;
+        }
+        if (canvas.height !== outH) {
+            canvas.height = outH;
+        }
+        ctx.clearRect(0, 0, outW, outH);
+        ctx.drawImage(video, pass.sx, pass.sy, pass.sw, pass.sh, 0, 0, outW, outH);
+        try {
+            const result = reader.decodeFromCanvas(canvas);
+            const text = result.getText();
+            if (text.length > 0) {
+                return text;
+            }
+        }
+        catch {
+            // NotFoundException / checksum — try next pass
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=zxingJsSensitiveDecode.js.map

package/dist/hooks/zxingJsSensitiveDecode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zxingJsSensitiveDecode.js","sourceRoot":"","sources":["../../src/hooks/zxingJsSensitiveDecode.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAiB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AAEvE,MAAM,UAAU,0BAA0B,CACxC,OAAiC;IAEjC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACxB,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACzD,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,IAAI,wBAAwB,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAuB,EACvB,MAAyB,EACzB,MAAgC;IAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,qBAAqB,GAAG,KAAK,CAAC;IAElC,MAAM,MAAM,GAAG,6BAA6B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5D,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3B,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;QACvB,CAAC;QAED,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAE3E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/labels/localizedNameMap.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Optional per-locale display-name overrides for catalog entities
+ * (products, categories, etc.) that also have a universal `name`.
+ *
+ * Distinct from {@link LocalizedLabel} (required cs/en UI copy maps).
+ */
+export type NameLocale = 'cs' | 'en' | 'sk';
+export type LocalizedNameMap = {
+    cs?: string;
+    en?: string;
+    sk?: string;
+};
+/** Keys accepted on {@link LocalizedNameMap}; useful for Zod / form iteration. */
+export declare const LOCALIZED_NAME_MAP_KEYS: readonly ["cs", "en", "sk"];
+/**
+ * Zod-friendly plain shape description (shared has no zod dependency).
+ * Backend can build:
+ * `z.object({ cs: z.string(), en: z.string(), sk: z.string() }).partial().optional().nullable()`
+ * then `.transform((v) => normalizeNameLocales(v, universalName))`.
+ */
+export declare const NAME_LOCALES_PLAIN_SHAPE: {
+    readonly cs: "string";
+    readonly en: "string";
+    readonly sk: "string";
+};
+/** Map an i18n language / BCP-47 tag (or exact NameLocale) to a NameLocale. */
+export declare function toNameLocale(locale: NameLocale | string): NameLocale | null;
+/**
+ * Trim, drop empties, omit locale values that equal the universal name.
+ * Returns `null` when nothing remains (including null/undefined input).
+ */
+export declare function normalizeNameLocales(nameLocales: LocalizedNameMap | null | undefined, universalName: string): LocalizedNameMap | null;
+/**
+ * Prefer a non-empty locale override from `nameLocales`; otherwise the universal `name`.
+ */
+export declare function resolveLocalizedName(name: string, nameLocales: LocalizedNameMap | null | undefined, locale: NameLocale | string): string;
+//# sourceMappingURL=localizedNameMap.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pi-kiosk-shared",
-    "version": "2.3.3",
+    "version": "2.3.5",
     "type": "module",
     "private": false,
     "description": "Shared types, API contracts, and error classes for Pi Kiosk system",
@@ -338,7 +338,8 @@
         "gate:inventory-ops-slo-drift": "node scripts/check-inventory-ops-slo-drift.mjs",
         "check:inventory-ops-slo-drift": "node scripts/check-inventory-ops-slo-drift.mjs",
         "publish:local": "npm run build:clean && npm pack --pack-destination .",
-        "prepublishOnly": "npm run build:clean",
+        "gate:publish-dist-declarations": "node scripts/gate-publish-dist-declarations.mjs",
+        "prepublishOnly": "npm run build:clean && npm run gate:publish-dist-declarations",
         "preversion": "npm run test -- --passWithNoTests",
         "postversion": "echo 'Version updated. Run git push && git push --tags manually if needed.'",
         "audit:deps": "npm audit --audit-level=high",