@unif/react-native-hms-scan 0.6.2 → 1.0.0

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

@@ -1,13 +1,3 @@
-import { type DecodeImageOptions, type ScanResult } from './types';
-/**
- * 从本地图片解码条码 / 二维码（华为 Bitmap 模式）。
- *
- * @param uri 本地图片。iOS 支持 file://、绝对路径、data:；Android 支持
- *            file://、绝对路径、content://、android.resource://。
- *            两端都不下载远程 URL，也不支持 ph:// / assets-library://。
- * @param options 可选；formats 限定码制，不传 = 全部。
- * @returns 命中的结果数组（可能为空）。
- * @throws HmsScanError 图片加载失败 / 读权限缺失等。
- */
-export declare function decodeImage(uri: string, options?: DecodeImageOptions): Promise<ScanResult[]>;
+import type { DecodeScanImageInput, ScanResult } from './types';
+export declare function decodeImage(input: Readonly<DecodeScanImageInput>): Promise<readonly ScanResult[]>;
 //# sourceMappingURL=decodeImage.d.ts.map

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;;;;;;;;;GASG;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":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhE,wBAAsB,WAAW,CAC/B,KAAK,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GACpC,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAkChC"}

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

@@ -0,0 +1,3 @@
+import type { DecodeScanImageInput, ScanResult } from './types';
+export declare function decodeImage(_input: Readonly<DecodeScanImageInput>): Promise<readonly ScanResult[]>;
+//# sourceMappingURL=decodeImage.web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decodeImage.web.d.ts","sourceRoot":"","sources":["../../../src/decodeImage.web.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEhE,wBAAsB,WAAW,CAC/B,MAAM,EAAE,QAAQ,CAAC,oBAAoB,CAAC,GACrC,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAEhC"}

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

@@ -0,0 +1,6 @@
+import { ScanError } from './ScanError';
+import type { ScanFailure } from './types';
+/** Native boundary normalization; Scanner only uses this for its external picker. */
+export declare function scanError(error: unknown, fallback: Readonly<ScanFailure>): ScanError;
+export declare function unsupportedScanError(): ScanError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,KAAK,EAAqB,WAAW,EAAE,MAAM,SAAS,CAAC;AAE9D,qFAAqF;AACrF,wBAAgB,SAAS,CACvB,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC9B,SAAS,CAUX;AAED,wBAAgB,oBAAoB,IAAI,SAAS,CAKhD"}

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

@@ -1,13 +1,16 @@
-import { type BarcodeContentType, type BarcodeFormat, type ScanResult } from './types';
-/** 把任意字符串安全收敛成 BarcodeFormat（未知归 UNKNOWN）。 */
-export declare function coerceFormat(value: unknown): BarcodeFormat;
-/** 把任意字符串安全收敛成 BarcodeContentType（未知/缺省 → undefined）。 */
-export declare function coerceContentType(value: unknown): BarcodeContentType | undefined;
-/** formats[] → 逗号分隔 CSV（传给原生）；空/未传 → ''（= 全部码制）。 */
-export declare function formatsToCsv(formats?: readonly BarcodeFormat[]): string;
-/**
- * 解析原生回传的 JSON 字符串 → 强类型 ScanResult[]。
- * 任何脏数据都被安全过滤；解析失败返回空数组而非抛错。
- */
-export declare function parseResultsJson(json: string): ScanResult[];
+import { ScanError } from './ScanError';
+import type { RequestedScanFormat, ScanContentType, ScanFormat, ScanResult } from './types';
+export declare function coerceFormat(value: unknown): ScanFormat;
+export declare function coerceContentType(value: unknown): ScanContentType | undefined;
+/** Empty means no extra filter. Order and duplicates do not change the filter. */
+export declare function formatsToCsv(value?: readonly RequestedScanFormat[]): string;
+export declare function formatConfiguration(value?: readonly RequestedScanFormat[]): {
+    csv: string;
+    error: undefined;
+} | {
+    csv: string;
+    error: ScanError;
+};
+/** Malformed bridge data is distinct from a successfully decoded empty batch. */
+export declare function parseResultsJson(json: unknown): readonly ScanResult[];
 //# sourceMappingURL=format.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAElB,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AAqBjB,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAI1D;AAED,yDAAyD;AACzD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAIhF;AAED,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,OAAO,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAEvE;AA6BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAe3D"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/format.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EACf,UAAU,EAEV,UAAU,EACX,MAAM,SAAS,CAAC;AACjB,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAIvD;AACD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,GAAG,SAAS,CAI7E;AACD,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,SAAS,mBAAmB,EAAE,GAAG,MAAM,CAiB3E;AACD,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,EAAE,SAAS,mBAAmB,EAAE;;;;;WAIpC,SAAS;EAE9C;AAqBD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,UAAU,EAAE,CA2BrE"}

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

@@ -1,10 +1,9 @@
-export { ALL_BARCODE_FORMATS, HmsScanError, } 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';
+export { ScanError } from './ScanError';
+export type { ScanFormat, RequestedScanFormat, ScanContentType, ScanPoint, ScanResult, ScanFailure, DecodeScanImageInput, ScanCameraPermission, ScanTorchState, ScannerImage, } from './types';
+export { HmsScanView } from './HmsScanView/HmsScanView';
+export type { HmsScanViewProps } from './HmsScanView/types';
 export { decodeImage } from './decodeImage';
-export { getCameraPermissionStatus, requestCameraPermission } from './permissions';
+export { getCameraPermissionStatus, requestCameraPermission, } from './permissions';
 export { Scanner } from './Scanner/Scanner';
-export type { ScannerProps } from './Scanner/Scanner';
+export type { ScannerProps } from './Scanner/types';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,9 @@
+export { ScanError } from './ScanError';
+export type { ScanFormat, RequestedScanFormat, ScanContentType, ScanPoint, ScanResult, ScanFailure, DecodeScanImageInput, ScanCameraPermission, ScanTorchState, ScannerImage, } from './types';
+export { HmsScanView } from './HmsScanView/HmsScanView.web';
+export type { HmsScanViewProps } from './HmsScanView/types';
+export { decodeImage } from './decodeImage.web';
+export { getCameraPermissionStatus, requestCameraPermission, } from './permissions.web';
+export { Scanner } from './Scanner/Scanner.web';
+export type { ScannerProps } from './Scanner/types';
+//# sourceMappingURL=index.web.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.web.d.ts","sourceRoot":"","sources":["../../../src/index.web.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -1,12 +1,13 @@
 import type { FC } from 'react';
-import type { CameraPermissionStatus, DecodeImageOptions, ScanResult } from './types';
-import type { HmsScanViewProps } from './HmsScanView';
-import type { ScannerProps } from './Scanner/Scanner';
-export * from './types';
-export { coerceFormat, coerceContentType, formatsToCsv } from './format';
-export declare const decodeImage: jest.Mock<Promise<ScanResult[]>, [_uri: string, _options?: DecodeImageOptions | undefined], any>;
-export declare const getCameraPermissionStatus: jest.Mock<Promise<CameraPermissionStatus>, [], any>;
-export declare const requestCameraPermission: jest.Mock<Promise<CameraPermissionStatus>, [], any>;
+import type { DecodeScanImageInput, ScanCameraPermission, ScanResult } from './types';
+import type { HmsScanViewProps } from './HmsScanView/types';
+import type { ScannerProps } from './Scanner/types';
+export { ScanError } from './ScanError';
+export type { ScanFormat, RequestedScanFormat, ScanContentType, ScanPoint, ScanResult, ScanFailure, DecodeScanImageInput, ScanCameraPermission, ScanTorchState, ScannerImage, } from './types';
+export type { HmsScanViewProps, ScannerProps };
+export declare const decodeImage: jest.Mock<Promise<readonly ScanResult[]>, [_input: Readonly<DecodeScanImageInput>], any>;
+export declare const getCameraPermissionStatus: jest.Mock<Promise<ScanCameraPermission>, [], any>;
+export declare const requestCameraPermission: jest.Mock<Promise<ScanCameraPermission>, [], any>;
 export declare const HmsScanView: FC<HmsScanViewProps>;
 export declare const Scanner: FC<ScannerProps>;
 //# sourceMappingURL=mock.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/mock.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EACV,sBAAsB,EACtB,kBAAkB,EAClB,UAAU,EACX,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGzE,eAAO,MAAM,WAAW,kGAGvB,CAAC;AAGF,eAAO,MAAM,yBAAyB,qDAErC,CAAC;AACF,eAAO,MAAM,uBAAuB,qDAEnC,CAAC;AAGF,eAAO,MAAM,WAAW,EAAE,EAAE,CAAC,gBAAgB,CAAc,CAAC;AAC5D,eAAO,MAAM,OAAO,EAAE,EAAE,CAAC,YAAY,CAAc,CAAC"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,UAAU,EACX,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EACV,UAAU,EACV,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,UAAU,EACV,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,CAAC;AAC/C,eAAO,MAAM,WAAW,0FAGvB,CAAC;AACF,eAAO,MAAM,yBAAyB,mDAErC,CAAC;AACF,eAAO,MAAM,uBAAuB,mDAEnC,CAAC;AACF,eAAO,MAAM,WAAW,EAAE,EAAE,CAAC,gBAAgB,CAAc,CAAC;AAC5D,eAAO,MAAM,OAAO,EAAE,EAAE,CAAC,YAAY,CAAc,CAAC"}

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

@@ -1,9 +1,5 @@
-import type { CameraPermissionStatus } from './types';
-/** 查询当前相机权限状态（不弹窗）。 */
-export declare function getCameraPermissionStatus(): Promise<CameraPermissionStatus>;
-/**
- * 发起相机权限请求（必要时弹系统授权框），返回请求后的状态。
- * 若用户已永久拒绝（blocked），需引导去系统设置开启。
- */
-export declare function requestCameraPermission(): Promise<CameraPermissionStatus>;
+import type { ScanCameraPermission } from './types';
+/** Reads the actual status without presenting a system permission prompt. */
+export declare function getCameraPermissionStatus(): Promise<ScanCameraPermission>;
+export declare function requestCameraPermission(): Promise<ScanCameraPermission>;
 //# sourceMappingURL=permissions.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/permissions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AActD,uBAAuB;AACvB,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAEjF;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAE/E"}
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/permissions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AA8BpD,6EAA6E;AAC7E,wBAAgB,yBAAyB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAEzE;AACD,wBAAgB,uBAAuB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAEvE"}

package/lib/typescript/src/permissions.web.d.ts

@@ -0,0 +1,4 @@
+import type { ScanCameraPermission } from './types';
+export declare function getCameraPermissionStatus(): Promise<ScanCameraPermission>;
+export declare function requestCameraPermission(): Promise<ScanCameraPermission>;
+//# sourceMappingURL=permissions.web.d.ts.map

package/lib/typescript/src/permissions.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.web.d.ts","sourceRoot":"","sources":["../../../src/permissions.web.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAE/E;AACD,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAE7E"}

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

@@ -1,67 +1,42 @@
-/** 统一码制枚举（两端归一）。 */
-export type BarcodeFormat = 'QR_CODE' | 'AZTEC' | 'DATA_MATRIX' | 'PDF417' | 'CODABAR' | 'CODE_39' | 'CODE_93' | 'CODE_128' | 'EAN_8' | 'EAN_13' | 'UPC_A' | 'UPC_E' | 'ITF14' | 'MULTI_FUNCTIONAL' | 'UNKNOWN';
-/** 所有可用码制（不含 UNKNOWN）。传给原生即"识别全部码制"。 */
-export declare const ALL_BARCODE_FORMATS: readonly BarcodeFormat[];
-/**
- * 码内容语义类型（尽力归一）。
- * Android 来自 HmsScan.getScanTypeForm()，iOS 来自 sceneType（精度有限，未知归 OTHER）。
- */
-export type BarcodeContentType = 'TEXT' | 'URL' | 'EMAIL' | 'PHONE' | 'SMS' | 'WIFI' | 'CONTACT' | 'EVENT' | 'LOCATION' | 'DRIVER' | 'ISBN' | 'ARTICLE' | 'OTHER';
-/** 取景框/解码命中的角点（图像坐标系，单位 px）。 */
-export interface ScanCornerPoint {
+import type { SCAN_FORMATS, SCAN_CONTENT_TYPES } from './constants';
+export type ScanFormat = (typeof SCAN_FORMATS)[number];
+export type RequestedScanFormat = Exclude<ScanFormat, 'UNKNOWN'>;
+export type ScanContentType = (typeof SCAN_CONTENT_TYPES)[number];
+export interface ScanPoint {
     x: number;
     y: number;
 }
-/** 一次扫码/解码命中的结果。 */
 export interface ScanResult {
-    /** 原始解码文本（Android getOriginalValue / iOS text）。 */
+    /** Unmodified decoded text. */
     value: string;
-    /** 码制。 */
-    format: BarcodeFormat;
-    /** 内容语义类型（可能缺省）。 */
-    contentType?: BarcodeContentType;
-    /** 条码四角点（可能缺省）。 */
-    cornerPoints?: ScanCornerPoint[];
+    format: ScanFormat;
+    contentType?: ScanContentType;
+    /** Coordinates in the recognition image, not screen coordinates. */
+    cornerPoints?: readonly ScanPoint[];
 }
-/** decodeImage 选项。 */
-export interface DecodeImageOptions {
-    /** 限定识别码制；不传 = 全部。 */
-    formats?: readonly BarcodeFormat[];
-}
-/** `<HmsScanView>` / `<Scanner>` 通过回调上报的普通错误对象。 */
-export interface ScanError {
-    code: string;
+export interface ScanFailure {
+    reason: 'invalid_input' | 'permission_denied' | 'image_unavailable' | 'decode_failed' | 'invalid_response' | 'unavailable' | 'unsupported';
     message: string;
+    sourceCode?: string;
+}
+export interface DecodeScanImageInput {
+    /** A readable local file URI, borrowed until this operation settles. */
+    uri: string;
+    formats?: readonly RequestedScanFormat[];
+}
+export type ScanCameraPermission = 'granted' | 'denied' | 'blocked' | 'undetermined';
+export interface ScanTorchState {
+    on: boolean;
+    available?: boolean;
+    lowLight?: boolean;
 }
-/** 相机权限状态。 */
-export type CameraPermissionStatus = 'granted' | 'denied' | 'blocked' | 'undetermined';
-/** 错误码。 */
-export type HmsScanErrorCode = 'E_NO_CAMERA_PERMISSION' | 'E_NO_READ_PERMISSION' | 'E_CAMERA_INIT' | 'E_DECODE_FAILED' | 'E_IMAGE_LOAD_FAILED' | 'E_NO_RESULT' | 'E_UNKNOWN';
-/** 库统一抛出的错误类型。 */
-export declare class HmsScanError extends Error {
-    readonly code: HmsScanErrorCode;
-    constructor(code: HmsScanErrorCode, message?: string);
+export interface ScannerImage {
+    uri: string;
+    onSourceReleased?(): void;
 }
-/**
- * 业务层商品信息——`<Scanner>` 扫到条码后，由宿主通过 resolveProduct 解析返回，
- * 用于聚焦款"浮层确认卡"展示。仅 name 必填，其余可缺省。
- */
-export interface ScanProduct {
-    /** 商品名（必填）。 */
-    name: string;
-    /** 品牌（如 "统一"）。 */
-    brand?: string;
-    /** 字母牌字符；缺省时取 brand 或 name 的首字。 */
-    brandChar?: string;
-    /** 条码；缺省时取扫到的 value。 */
-    barcode?: string;
-    /** 规格（如 "500ml × 15 瓶/箱"）。 */
-    spec?: string;
-    /** 库存短描述（如 "充足"）。 */
-    stockShort?: string;
-    /** 价格展示串（如 "¥5.50"）。 */
-    price?: string;
-    /** 价格下方副标题，默认 "建议零售"。 */
-    priceCaption?: string;
+/** Native rejection payload; internal to the capability boundary. */
+export interface NativeScanFailure {
+    code?: unknown;
+    message?: unknown;
 }
 //# sourceMappingURL=types.d.ts.map

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,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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEpE,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AACvD,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE,MAAM,WAAW,SAAS;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AACD,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,oEAAoE;IACpE,YAAY,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CACrC;AACD,MAAM,WAAW,WAAW;IAC1B,MAAM,EACF,eAAe,GACf,mBAAmB,GACnB,mBAAmB,GACnB,eAAe,GACf,kBAAkB,GAClB,aAAa,GACb,aAAa,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AACD,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC1C;AACD,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,QAAQ,GACR,SAAS,GACT,cAAc,CAAC;AACnB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AACD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,IAAI,IAAI,CAAC;CAC3B;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}

package/package.json

@@ -1,11 +1,16 @@
 {
   "name": "@unif/react-native-hms-scan",
-  "version": "0.6.2",
+  "version": "1.0.0",
   "description": "Unif React Native 扫码：实时预览、二维码、条码和本地图片识别",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {
     ".": {
+      "browser": {
+        "source": "./src/index.web.tsx",
+        "types": "./lib/typescript/src/index.web.d.ts",
+        "default": "./lib/module/index.web.js"
+      },
       "source": "./src/index.tsx",
       "types": "./lib/typescript/src/index.d.ts",
       "default": "./lib/module/index.js"
@@ -41,6 +46,8 @@
     "prepare": "bob build",
     "typecheck": "tsc",
     "test": "yarn verify:integration-contracts && yarn verify:android-integration && yarn verify:ios-integration && jest",
+    "test:native:android": "python3 scripts/test-android-native.py",
+    "test:native:ios": "bash scripts/test-ios-native.sh",
     "verify:integration-contracts": "node --test scripts/__tests__/integration-contract.test.mjs",
     "verify:android-integration": "node scripts/verify-android-integration.mjs",
     "verify:ios-integration": "node scripts/verify-ios-integration.mjs",

package/src/HmsScanView/HmsScanView.tsx

@@ -0,0 +1,67 @@
+import { useEffect, useRef } from 'react';
+import { View } from 'react-native';
+import NativeHmsScanView from '../HmsScanViewNativeComponent';
+import { formatConfiguration, parseResultsJson } from '../format';
+import { scanError } from '../errors';
+import type { ScanResult } from '../types';
+import type { HmsScanViewProps } from './types';
+
+export function HmsScanView({
+  formats,
+  continuous = true,
+  paused = false,
+  torch = false,
+  onScanResult,
+  onScanError,
+  onTorchState,
+  ...viewProps
+}: HmsScanViewProps) {
+  const config = formatConfiguration(formats);
+  const invalid = config.error;
+  const errorRef = useRef(onScanError);
+  errorRef.current = onScanError;
+  useEffect(() => {
+    if (invalid) errorRef.current?.(invalid);
+  }, [invalid?.message]);
+  if (invalid) return <View {...viewProps} />;
+  return (
+    <NativeHmsScanView
+      {...viewProps}
+      formatsCsv={config.csv}
+      continuous={continuous}
+      paused={paused}
+      torch={torch}
+      onScanResult={(event) => {
+        let results: readonly ScanResult[];
+        try {
+          results = parseResultsJson(event.nativeEvent.resultsJson);
+        } catch (error) {
+          onScanError?.(
+            scanError(error, {
+              reason: 'invalid_response',
+              message: '扫码结果无法识别',
+            })
+          );
+          return;
+        }
+        onScanResult?.(results);
+      }}
+      onScanError={(event) =>
+        onScanError?.(
+          scanError(event.nativeEvent, {
+            reason: 'unavailable',
+            message: '扫码相机不可用',
+          })
+        )
+      }
+      onTorchState={(event) => {
+        const state = event.nativeEvent;
+        onTorchState?.({
+          on: state.on,
+          ...(state.hasAvailable ? { available: state.available } : {}),
+          ...(state.hasLowLight ? { lowLight: state.lowLight } : {}),
+        });
+      }}
+    />
+  );
+}

package/src/HmsScanView/HmsScanView.web.tsx

@@ -0,0 +1,22 @@
+import { useEffect, useRef } from 'react';
+import { View } from 'react-native';
+import { unsupportedScanError } from '../errors';
+import type { HmsScanViewProps } from './types';
+
+export function HmsScanView({
+  onScanError,
+  formats: _formats,
+  paused: _paused,
+  torch: _torch,
+  continuous: _continuous,
+  onScanResult: _onScanResult,
+  onTorchState: _onTorchState,
+  ...props
+}: HmsScanViewProps) {
+  const callback = useRef(onScanError);
+  callback.current = onScanError;
+  useEffect(() => {
+    callback.current?.(unsupportedScanError());
+  }, []);
+  return <View {...props} />;
+}

package/src/HmsScanView/types.ts

@@ -0,0 +1,17 @@
+import type { ViewProps } from 'react-native';
+import type {
+  RequestedScanFormat,
+  ScanFailure,
+  ScanResult,
+  ScanTorchState,
+} from '../types';
+
+export interface HmsScanViewProps extends ViewProps {
+  formats?: readonly RequestedScanFormat[];
+  continuous?: boolean;
+  paused?: boolean;
+  torch?: boolean;
+  onScanResult?(results: readonly ScanResult[]): void;
+  onScanError?(error: Readonly<ScanFailure>): void;
+  onTorchState?(state: Readonly<ScanTorchState>): void;
+}

package/src/HmsScanViewNativeComponent.ts

@@ -7,7 +7,7 @@ import codegenNativeComponent from 'react-native/Libraries/Utilities/codegenNati
 
 // RN codegen Fabric 组件规范（注册名 "HmsScanView"）。
 // 事件 payload 都用基础类型 / 单字符串，绕开 codegen 对复杂事件结构的限制：
-// 扫码结果以 JSON 字符串回传（由 src/HmsScanView.tsx 解析成 ScanResult[]）。
+// 扫码结果以 JSON 字符串回传（由 HmsScanView/HmsScanView.tsx 解析成 ScanResult[]）。
 
 type ScanResultEvent = Readonly<{
   /** JSON 编码的 ScanResult[]。 */
@@ -19,15 +19,17 @@ type ScanErrorEvent = Readonly<{
   message: string;
 }>;
 
-type TorchStatusEvent = Readonly<{
-  /** 环境是否暗到建议显示手电按钮（Android OnLightVisibleCallBack）。 */
+type TorchStateEvent = Readonly<{
   available: boolean;
+  hasAvailable: boolean;
+  lowLight: boolean;
+  hasLowLight: boolean;
   /** 手电当前是否点亮。 */
   on: boolean;
 }>;
 
 export interface NativeProps extends ViewProps {
-  /** 限定码制（逗号分隔的 BarcodeFormat），空串 = 全部。 */
+  /** 限定码制（逗号分隔的 ScanFormat），空串 = 全部。 */
   formatsCsv?: WithDefault<string, ''>;
   /** 连续扫码（命中后继续，不自动停）。 */
   continuous?: WithDefault<boolean, true>;
@@ -38,7 +40,7 @@ export interface NativeProps extends ViewProps {
 
   onScanResult?: DirectEventHandler<ScanResultEvent>;
   onScanError?: DirectEventHandler<ScanErrorEvent>;
-  onTorchStatus?: DirectEventHandler<TorchStatusEvent>;
+  onTorchState?: DirectEventHandler<TorchStateEvent>;
 }
 
 export default codegenNativeComponent<NativeProps>('HmsScanView');

package/src/NativeHmsScan.ts

@@ -8,10 +8,8 @@ import { TurboModuleRegistry } from 'react-native';
 export interface Spec extends TurboModule {
   /**
    * 解码本地图片里的条码 / 二维码。
-   * @param uri 本地图片。iOS 支持 file://、绝对路径、data:；Android 支持
-   *            file://、绝对路径、content://、android.resource://。
-   *            两端都不下载远程 URL，也不支持 ph:// / assets-library://。
-   * @param formatsCsv 限定码制（逗号分隔的 BarcodeFormat），空串 = 全部。
+   * @param uri 本地图片 file URI，由公共能力边界校验。
+   * @param formatsCsv 限定码制（逗号分隔的 ScanFormat），空串 = 全部。
    * @returns JSON 编码的 ScanResult[]（可能为空数组）。
    */
   decodeImage(uri: string, formatsCsv: string): Promise<string>;
@@ -23,4 +21,4 @@ export interface Spec extends TurboModule {
   requestCameraPermission(): Promise<string>;
 }
 
-export default TurboModuleRegistry.getEnforcing<Spec>('HmsScan');
+export default TurboModuleRegistry.get<Spec>('HmsScan');

package/src/ScanError.ts

@@ -0,0 +1,13 @@
+import type { ScanFailure } from './types';
+
+export class ScanError extends Error implements ScanFailure {
+  readonly reason: ScanFailure['reason'];
+  readonly sourceCode?: string;
+  constructor(error: Readonly<ScanFailure>) {
+    super(error.message);
+    this.name = 'ScanError';
+    this.reason = error.reason;
+    this.sourceCode = error.sourceCode;
+    Object.setPrototypeOf(this, ScanError.prototype);
+  }
+}

package/src/Scanner/DeniedOverlay.tsx

@@ -20,12 +20,14 @@ export function DeniedOverlay({ onClose, onSettings }: DeniedOverlayProps) {
       <Empty
         icon="permission-denied"
         title="需要相机权限"
-        desc="开启相机后，才能扫描商品条码与门店二维码。请前往系统设置授权。"
+        desc="开启相机后，才能扫描条码与二维码。请前往系统设置授权。"
       />
       {/* block(flexGrow:1)而非 flex:1：ButtonBase 非 block 时硬编码 flexGrow:0,
           会压过 style 里的 flex:1 → 按钮塌成 padding 宽、label 被裁(同 ResultFocus)。 */}
       <View style={styles.row}>
-        {onClose && <Button label="取消" variant="ghost" block onPress={onClose} />}
+        {onClose && (
+          <Button label="取消" variant="ghost" block onPress={onClose} />
+        )}
         <Button
           label="去设置开启"
           variant="primary"

package/src/Scanner/ResultFail.tsx

@@ -11,32 +11,50 @@ import {
 
 interface ResultFailProps {
   bottomInset: number;
+  failed?: boolean;
   /** 重扫：回到取景重新扫描。（退出扫码页是外层工具栏「返回」的事。） */
   onRescan: () => void;
 }
 
 // 未识别失败的底部弹层：design 的 Empty（error-alert）+ Button（重扫）。
 // 聚焦款不加背景遮罩，与浮层确认卡保持一致。
-export function ResultFail({ bottomInset, onRescan }: ResultFailProps) {
+export function ResultFail({ bottomInset, failed, onRescan }: ResultFailProps) {
   const s = useThemedStyles(makeStyles);
   const anim = useRef(new Animated.Value(0)).current;
   useEffect(() => {
-    Animated.timing(anim, { toValue: 1, duration: 320, useNativeDriver: true }).start();
+    Animated.timing(anim, {
+      toValue: 1,
+      duration: 320,
+      useNativeDriver: true,
+    }).start();
   }, [anim]);
 
   return (
     <Animated.View
       style={[
         s.sheet,
-        { transform: [{ translateY: anim.interpolate({ inputRange: [0, 1], outputRange: [r(320), 0] }) }] },
+        {
+          transform: [
+            {
+              translateY: anim.interpolate({
+                inputRange: [0, 1],
+                outputRange: [r(320), 0],
+              }),
+            },
+          ],
+        },
       ]}
     >
       <View style={s.grabber} />
       <View style={[styles.inner, { paddingBottom: bottomInset + r(14) }]}>
         <Empty
           icon="error-alert"
-          title="未识别到条码"
-          desc="请将条码完整置于框内、保持平整并对准光线后重试。"
+          title={failed ? '图片识别失败' : '未识别到条码'}
+          desc={
+            failed
+              ? '无法读取或解码图片，请重试。'
+              : '请将条码完整置于框内、保持平整并对准光线后重试。'
+          }
         />
         <Button label="重扫" variant="primary" block onPress={onRescan} />
       </View>