@unif/react-native-hms-scan 0.5.3 → 0.5.5

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["ALL_BARCODE_FORMATS","HmsScanError","coerceFormat","coerceContentType","formatsToCsv","HmsScanView","decodeImage","getCameraPermissionStatus","requestCameraPermission","Scanner"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA;AACA,SACEA,mBAAmB,EACnBC,YAAY,QACP,YAAS;AAYhB;AACA,SAASC,YAAY,EAAEC,iBAAiB,EAAEC,YAAY,QAAQ,aAAU;;AAExE;AACA,SAASC,WAAW,QAAQ,kBAAe;AAG3C;AACA,SAASC,WAAW,QAAQ,kBAAe;;AAE3C;AACA,SAASC,yBAAyB,EAAEC,uBAAuB,QAAQ,kBAAe;;AAElF;AACA,SAASC,OAAO,QAAQ,sBAAmB","ignoreList":[]}
+{"version":3,"names":["ALL_BARCODE_FORMATS","HmsScanError","coerceFormat","coerceContentType","formatsToCsv","HmsScanView","decodeImage","getCameraPermissionStatus","requestCameraPermission","Scanner"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA;AACA;AACA;;AAEA;AACA,SACEA,mBAAmB,EACnBC,YAAY,QACP,YAAS;AAahB;AACA,SAASC,YAAY,EAAEC,iBAAiB,EAAEC,YAAY,QAAQ,aAAU;;AAExE;AACA,SAASC,WAAW,QAAQ,kBAAe;AAG3C;AACA,SAASC,WAAW,QAAQ,kBAAe;;AAE3C;AACA,SAASC,yBAAyB,EAAEC,uBAAuB,QAAQ,kBAAe;;AAElF;AACA,SAASC,OAAO,QAAQ,sBAAmB","ignoreList":[]}

package/lib/module/types.js

@@ -24,6 +24,8 @@ export const ALL_BARCODE_FORMATS = ['QR_CODE', 'AZTEC', 'DATA_MATRIX', 'PDF417',
 
 /** decodeImage 选项。 */
 
+/** `<HmsScanView>` / `<Scanner>` 通过回调上报的普通错误对象。 */
+
 /** 相机权限状态。 */
 
 /** 错误码。 */

package/lib/module/types.js.map

@@ -1 +1 @@
-{"version":3,"names":["ALL_BARCODE_FORMATS","HmsScanError","Error","constructor","code","message","name","Object","setPrototypeOf","prototype"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAkBA;AACA,OAAO,MAAMA,mBAA6C,GAAG,CAC3D,SAAS,EACT,OAAO,EACP,aAAa,EACb,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EACP,kBAAkB,CACV;;AAEV;AACA;AACA;AACA;;AAgBA;;AAMA;;AAYA;;AAMA;;AAOA;;AAUA;AACA,OAAO,MAAMC,YAAY,SAASC,KAAK,CAAC;EAEtCC,WAAWA,CAACC,IAAsB,EAAEC,OAAgB,EAAE;IACpD,KAAK,CAACA,OAAO,IAAID,IAAI,CAAC;IACtB,IAAI,CAACE,IAAI,GAAG,cAAc;IAC1B,IAAI,CAACF,IAAI,GAAGA,IAAI;IAChB;IACAG,MAAM,CAACC,cAAc,CAAC,IAAI,EAAEP,YAAY,CAACQ,SAAS,CAAC;EACrD;AACF;;AAEA;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["ALL_BARCODE_FORMATS","HmsScanError","Error","constructor","code","message","name","Object","setPrototypeOf","prototype"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;;AAkBA;AACA,OAAO,MAAMA,mBAA6C,GAAG,CAC3D,SAAS,EACT,OAAO,EACP,aAAa,EACb,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,OAAO,EACP,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EACP,kBAAkB,CACV;;AAEV;AACA;AACA;AACA;;AAgBA;;AAMA;;AAYA;;AAMA;;AAMA;;AAOA;;AAUA;AACA,OAAO,MAAMC,YAAY,SAASC,KAAK,CAAC;EAEtCC,WAAWA,CAACC,IAAsB,EAAEC,OAAgB,EAAE;IACpD,KAAK,CAACA,OAAO,IAAID,IAAI,CAAC;IACtB,IAAI,CAACE,IAAI,GAAG,cAAc;IAC1B,IAAI,CAACF,IAAI,GAAGA,IAAI;IAChB;IACAG,MAAM,CAACC,cAAc,CAAC,IAAI,EAAEP,YAAY,CAACQ,SAAS,CAAC;EACrD;AACF;;AAEA;AACA;AACA;AACA","ignoreList":[]}

package/lib/typescript/src/HmsScanView.d.ts

@@ -1,5 +1,5 @@
 import type { ViewProps } from 'react-native';
-import type { BarcodeFormat, ScanResult } from './types';
+import type { BarcodeFormat, ScanError, ScanResult } from './types';
 /** 平台相关的暗光提示 / 手电状态。 */
 export interface TorchStatus {
     /** Android:环境暗光提示；iOS:设备是否有手电硬件。 */
@@ -9,7 +9,7 @@ export interface TorchStatus {
 }
 export interface HmsScanViewProps extends ViewProps {
     /** 限定码制；不传 = 全部。 */
-    formats?: BarcodeFormat[];
+    formats?: readonly BarcodeFormat[];
     /** 连续扫码，默认 true。 */
     continuous?: boolean;
     /** 暂停/恢复扫码，默认 false。 */
@@ -19,10 +19,7 @@ export interface HmsScanViewProps extends ViewProps {
     /** 命中一个或多个码时回调（已解析为强类型）。 */
     onScanResult?: (results: ScanResult[]) => void;
     /** 相机/解码出错时回调。 */
-    onScanError?: (error: {
-        code: string;
-        message: string;
-    }) => void;
+    onScanError?: (error: ScanError) => void;
     /** Android 暗光提示或 iOS 手电硬件 / 点亮状态变化时回调。 */
     onTorchStatus?: (status: TorchStatus) => void;
 }

package/lib/typescript/src/HmsScanView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HmsScanView.d.ts","sourceRoot":"","sources":["../../../src/HmsScanView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEzD,wBAAwB;AACxB,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB;IAChB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,oBAAoB;IACpB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,oBAAoB;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wBAAwB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC;IAC/C,kBAAkB;IAClB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,0CAA0C;IAC1C,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,iOAiDtB,CAAC"}
+{"version":3,"file":"HmsScanView.d.ts","sourceRoot":"","sources":["../../../src/HmsScanView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE,wBAAwB;AACxB,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,gBAAgB;IAChB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,MAAM,WAAW,gBAAiB,SAAQ,SAAS;IACjD,oBAAoB;IACpB,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,oBAAoB;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wBAAwB;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC;IAC/C,kBAAkB;IAClB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC,0CAA0C;IAC1C,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CAC/C;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,iOAiDtB,CAAC"}

package/lib/typescript/src/NativeHmsScan.d.ts

@@ -2,7 +2,9 @@ import type { TurboModule } from 'react-native';
 export interface Spec extends TurboModule {
     /**
      * 解码本地图片里的条码 / 二维码。
-     * @param uri 本地图片：file:// / content:// / ph:// / 绝对路径（不下载远程 URL）。
+     * @param uri 本地图片。iOS 支持 file://、绝对路径、data:；Android 支持
+     *            file://、绝对路径、content://、android.resource://。
+     *            两端都不下载远程 URL，也不支持 ph:// / assets-library://。
      * @param formatsCsv 限定码制（逗号分隔的 BarcodeFormat），空串 = 全部。
      * @returns JSON 编码的 ScanResult[]（可能为空数组）。
      */

package/lib/typescript/src/NativeHmsScan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeHmsScan.d.ts","sourceRoot":"","sources":["../../../src/NativeHmsScan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;;OAKG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9D,gEAAgE;IAChE,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7C,4BAA4B;IAC5B,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5C;;AAED,wBAAiE"}
+{"version":3,"file":"NativeHmsScan.d.ts","sourceRoot":"","sources":["../../../src/NativeHmsScan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAOhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;;;;OAOG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE9D,gEAAgE;IAChE,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAE7C,4BAA4B;IAC5B,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5C;;AAED,wBAAiE"}

package/lib/typescript/src/Scanner/ScanErrorOverlay.d.ts

@@ -0,0 +1,7 @@
+interface ScanErrorOverlayProps {
+    onClose?: () => void;
+    onRetry: () => void;
+}
+export declare function ScanErrorOverlay({ onClose, onRetry }: ScanErrorOverlayProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=ScanErrorOverlay.d.ts.map

package/lib/typescript/src/Scanner/ScanErrorOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScanErrorOverlay.d.ts","sourceRoot":"","sources":["../../../../src/Scanner/ScanErrorOverlay.tsx"],"names":[],"mappings":"AASA,UAAU,qBAAqB;IAC7B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,qBAAqB,2CAe3E"}

package/lib/typescript/src/Scanner/Scanner.d.ts

@@ -1,9 +1,9 @@
-import type { BarcodeFormat, ScanProduct, ScanResult } from '../types';
+import type { BarcodeFormat, ScanError, ScanProduct, ScanResult } from '../types';
 export interface ScannerProps {
     /** 顶栏标题，默认 "扫一扫"。 */
     title?: string;
     /** 限定识别码制；不传 = 全部。 */
-    formats?: BarcodeFormat[];
+    formats?: readonly BarcodeFormat[];
     /** 取景态提示文案。 */
     hintText?: string;
     /** 顶部安全区（默认 54）。用 react-native-safe-area-context 时可传 insets.top。 */
@@ -14,6 +14,8 @@ export interface ScannerProps {
     showTorch?: boolean;
     /** 返回回调（退出扫码页，回到上一级）；按钮在底部工具栏，与手电筒并排。 */
     onClose?: () => void;
+    /** 扫码相机或权限检查出错时上报。 */
+    onScanError?: (error: ScanError) => void;
     /**
      * 扫到条码后由宿主解析商品信息（用于浮层确认卡）。
      * 返回 null/undefined 视为"未识别"，抛错亦然。不传则默认用扫到的原文当商品名。
@@ -22,8 +24,9 @@ export interface ScannerProps {
     /** 用户点"确认"：把结果带回上一级（宿主通常在此导航返回）。 */
     onConfirm?: (product: ScanProduct, result: ScanResult) => void;
     /**
-     * 自动确认：扫到并解析成功后**不显示结果卡**，直接触发 `onConfirm(product, result)`。
-     * 默认 `false`（显示结果卡，由用户点"确定"）。
+     * 自动确认：传 `onConfirm` 时，扫到并解析成功后**不显示结果卡**，直接触发
+     * `onConfirm(product, result)`；未传回调时仍显示结果卡。默认 `false`（显示结果卡，
+     * 由用户点"确定"）。
      * 适合"扫到即用、不需要二次确认"的场景。回调后相机暂停、不自动重扫——宿主通常在
      * `onConfirm` 里导航离开；若需再扫由宿主控制（如重新挂载 `<Scanner>`）。
      * 注：未识别（`resolveProduct` 返回 `null`/抛错）仍走失败态可重扫，不会误触发。
@@ -37,8 +40,8 @@ export interface ScannerProps {
 }
 /**
  * 成品「扫一扫」界面（聚焦款）。底层 <HmsScanView> 出相机画面，取景框 / 工具栏 / 结果卡
- * 全用 @unif/react-native-design 的主题令牌与组件绘制（统一风格）。自带 ThemeProvider +
- * ToastHost，可直接整屏接入；放进宿主已有的 ThemeProvider 里也兼容。
+ * 全用 @unif/react-native-design 的主题令牌与组件绘制（统一风格）。自带 ThemeProvider，
+ * 可直接整屏接入；放进宿主已有的 ThemeProvider 里也兼容。
  */
 export declare function Scanner(props: ScannerProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=Scanner.d.ts.map

package/lib/typescript/src/Scanner/Scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Scanner.d.ts","sourceRoot":"","sources":["../../../../src/Scanner/Scanner.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAevE,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,UAAU,KACf,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC9E,oCAAoC;IACpC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAC/D;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,2CAO1C"}
+{"version":3,"file":"Scanner.d.ts","sourceRoot":"","sources":["../../../../src/Scanner/Scanner.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,aAAa,EACb,SAAS,EACT,WAAW,EACX,UAAU,EACX,MAAM,UAAU,CAAC;AAoClB,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,eAAe;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,sBAAsB;IACtB,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACzC;;;OAGG;IACH,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,UAAU,KACf,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC9E,oCAAoC;IACpC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;IAC/D;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,2CAM1C"}

package/lib/typescript/src/decodeImage.d.ts

@@ -2,8 +2,9 @@ import { type DecodeImageOptions, type ScanResult } from './types';
 /**
  * 从本地图片解码条码 / 二维码（华为 Bitmap 模式）。
  *
- * @param uri 本地图片：file:// / content:// / ph:// / 绝对路径。**不下载远程 URL**，
- *            如需识别网络图请宿主先下载到本地再传入。
+ * @param uri 本地图片。iOS 支持 file://、绝对路径、data:；Android 支持
+ *            file://、绝对路径、content://、android.resource://。
+ *            两端都不下载远程 URL，也不支持 ph:// / assets-library://。
  * @param options 可选；formats 限定码制，不传 = 全部。
  * @returns 命中的结果数组（可能为空）。
  * @throws HmsScanError 图片加载失败 / 读权限缺失等。

package/lib/typescript/src/decodeImage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decodeImage.d.ts","sourceRoot":"","sources":["../../../src/decodeImage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjF;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAmBvB"}
+{"version":3,"file":"decodeImage.d.ts","sourceRoot":"","sources":["../../../src/decodeImage.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgB,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjF;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAmBvB"}

package/lib/typescript/src/index.d.ts

@@ -1,5 +1,5 @@
 export { ALL_BARCODE_FORMATS, HmsScanError, } from './types';
-export type { BarcodeFormat, BarcodeContentType, ScanCornerPoint, ScanResult, DecodeImageOptions, CameraPermissionStatus, HmsScanErrorCode, ScanProduct, } from './types';
+export type { BarcodeFormat, BarcodeContentType, ScanCornerPoint, ScanResult, ScanError, DecodeImageOptions, CameraPermissionStatus, HmsScanErrorCode, ScanProduct, } from './types';
 export { coerceFormat, coerceContentType, formatsToCsv } from './format';
 export { HmsScanView } from './HmsScanView';
 export type { HmsScanViewProps, TorchStatus } from './HmsScanView';

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAMA,OAAO,EACL,mBAAmB,EACnB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGzE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGnF,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAKA,OAAO,EACL,mBAAmB,EACnB,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,SAAS,EACT,kBAAkB,EAClB,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,GACZ,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGzE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGnE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGnF,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/typescript/src/types.d.ts

@@ -26,7 +26,12 @@ export interface ScanResult {
 /** decodeImage 选项。 */
 export interface DecodeImageOptions {
     /** 限定识别码制；不传 = 全部。 */
-    formats?: BarcodeFormat[];
+    formats?: readonly BarcodeFormat[];
+}
+/** `<HmsScanView>` / `<Scanner>` 通过回调上报的普通错误对象。 */
+export interface ScanError {
+    code: string;
+    message: string;
 }
 /** 相机权限状态。 */
 export type CameraPermissionStatus = 'granted' | 'denied' | 'blocked' | 'undetermined';

package/lib/typescript/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAQA,oBAAoB;AACpB,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,OAAO,GACP,aAAa,GACb,QAAQ,GACR,SAAS,GACT,SAAS,GACT,SAAS,GACT,UAAU,GACV,OAAO,GACP,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,GACP,kBAAkB,GAClB,SAAS,CAAC;AAEd,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,EAAE,SAAS,aAAa,EAe9C,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,KAAK,GACL,OAAO,GACP,OAAO,GACP,KAAK,GACL,MAAM,GACN,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,MAAM,GACN,SAAS,GACT,OAAO,CAAC;AAEZ,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,oBAAoB;AACpB,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU;IACV,MAAM,EAAE,aAAa,CAAC;IACtB,oBAAoB;IACpB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,mBAAmB;IACnB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;CAClC;AAED,sBAAsB;AACtB,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,cAAc;AACd,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,QAAQ,GACR,SAAS,GACT,cAAc,CAAC;AAEnB,WAAW;AACX,MAAM,MAAM,gBAAgB,GACxB,wBAAwB,GACxB,sBAAsB,GACtB,eAAe,GACf,iBAAiB,GACjB,qBAAqB,GACrB,aAAa,GACb,WAAW,CAAC;AAEhB,kBAAkB;AAClB,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;gBACpB,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,MAAM;CAOrD;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAQA,oBAAoB;AACpB,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,OAAO,GACP,aAAa,GACb,QAAQ,GACR,SAAS,GACT,SAAS,GACT,SAAS,GACT,UAAU,GACV,OAAO,GACP,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,GACP,kBAAkB,GAClB,SAAS,CAAC;AAEd,wCAAwC;AACxC,eAAO,MAAM,mBAAmB,EAAE,SAAS,aAAa,EAe9C,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,MAAM,GACN,KAAK,GACL,OAAO,GACP,OAAO,GACP,KAAK,GACL,MAAM,GACN,SAAS,GACT,OAAO,GACP,UAAU,GACV,QAAQ,GACR,MAAM,GACN,SAAS,GACT,OAAO,CAAC;AAEZ,gCAAgC;AAChC,MAAM,WAAW,eAAe;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,oBAAoB;AACpB,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU;IACV,MAAM,EAAE,aAAa,CAAC;IACtB,oBAAoB;IACpB,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,mBAAmB;IACnB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;CAClC;AAED,sBAAsB;AACtB,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;CACpC;AAED,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,cAAc;AACd,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,QAAQ,GACR,SAAS,GACT,cAAc,CAAC;AAEnB,WAAW;AACX,MAAM,MAAM,gBAAgB,GACxB,wBAAwB,GACxB,sBAAsB,GACtB,eAAe,GACf,iBAAiB,GACjB,qBAAqB,GACrB,aAAa,GACb,WAAW,CAAC;AAEhB,kBAAkB;AAClB,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;gBACpB,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,MAAM;CAOrD;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unif/react-native-hms-scan",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "华为 HMS 统一扫码服务 React Native bridge：定制视图扫码 + 图片识别 (Scan SDK-Plus / ScanKitFrameWork，@unif 私有)",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -24,7 +24,6 @@
     "ios",
     "*.podspec",
     "react-native.config.js",
-    "scripts",
     "!ios/build",
     "!android/build",
     "!android/gradle",
@@ -41,7 +40,9 @@
     "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
     "prepare": "bob build",
     "typecheck": "tsc",
-    "test": "jest",
+    "test": "yarn verify:android-integration && yarn verify:ios-integration && jest",
+    "verify:android-integration": "node scripts/verify-android-integration.mjs",
+    "verify:ios-integration": "node scripts/verify-ios-integration.mjs",
     "lint": "eslint \"**/*.{js,ts,tsx}\""
   },
   "keywords": [

package/src/HmsScanView.tsx

@@ -2,7 +2,7 @@ import { forwardRef, type ComponentRef } from 'react';
 import type { ViewProps } from 'react-native';
 import NativeHmsScanView from './HmsScanViewNativeComponent';
 import { formatsToCsv, parseResultsJson } from './format';
-import type { BarcodeFormat, ScanResult } from './types';
+import type { BarcodeFormat, ScanError, ScanResult } from './types';
 
 /** 平台相关的暗光提示 / 手电状态。 */
 export interface TorchStatus {
@@ -14,7 +14,7 @@ export interface TorchStatus {
 
 export interface HmsScanViewProps extends ViewProps {
   /** 限定码制；不传 = 全部。 */
-  formats?: BarcodeFormat[];
+  formats?: readonly BarcodeFormat[];
   /** 连续扫码，默认 true。 */
   continuous?: boolean;
   /** 暂停/恢复扫码，默认 false。 */
@@ -24,7 +24,7 @@ export interface HmsScanViewProps extends ViewProps {
   /** 命中一个或多个码时回调（已解析为强类型）。 */
   onScanResult?: (results: ScanResult[]) => void;
   /** 相机/解码出错时回调。 */
-  onScanError?: (error: { code: string; message: string }) => void;
+  onScanError?: (error: ScanError) => void;
   /** Android 暗光提示或 iOS 手电硬件 / 点亮状态变化时回调。 */
   onTorchStatus?: (status: TorchStatus) => void;
 }

package/src/NativeHmsScan.ts

@@ -8,7 +8,9 @@ import { TurboModuleRegistry } from 'react-native';
 export interface Spec extends TurboModule {
   /**
    * 解码本地图片里的条码 / 二维码。
-   * @param uri 本地图片：file:// / content:// / ph:// / 绝对路径（不下载远程 URL）。
+   * @param uri 本地图片。iOS 支持 file://、绝对路径、data:；Android 支持
+   *            file://、绝对路径、content://、android.resource://。
+   *            两端都不下载远程 URL，也不支持 ph:// / assets-library://。
    * @param formatsCsv 限定码制（逗号分隔的 BarcodeFormat），空串 = 全部。
    * @returns JSON 编码的 ScanResult[]（可能为空数组）。
    */

package/src/Scanner/ScanErrorOverlay.tsx

@@ -0,0 +1,51 @@
+import { StyleSheet, View } from 'react-native';
+import {
+  Button,
+  Empty,
+  useThemedStyles,
+  r,
+  type ColorTokens,
+} from '@unif/react-native-design';
+
+interface ScanErrorOverlayProps {
+  onClose?: () => void;
+  onRetry: () => void;
+}
+
+export function ScanErrorOverlay({ onClose, onRetry }: ScanErrorOverlayProps) {
+  const s = useThemedStyles(makeStyles);
+  return (
+    <View style={s.overlay}>
+      <Empty
+        icon="error-alert"
+        title="相机启动失败"
+        desc="无法启动扫码相机，请确认权限与设备状态后重试。"
+      />
+      <View style={styles.row}>
+        {onClose && <Button label="取消" variant="ghost" block onPress={onClose} />}
+        <Button label="重试" variant="primary" block onPress={onRetry} />
+      </View>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  row: { flexDirection: 'row', columnGap: r(12), marginTop: r(8) },
+});
+
+const makeStyles = (c: ColorTokens) =>
+  StyleSheet.create({
+    overlay: {
+      position: 'absolute',
+      top: 0,
+      left: 0,
+      right: 0,
+      bottom: 0,
+      zIndex: 40,
+      backgroundColor: c.background,
+      alignItems: 'center',
+      justifyContent: 'center',
+      paddingHorizontal: r(40),
+      rowGap: r(8),
+    },
+  });