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

package/README.md

@@ -5,7 +5,7 @@
 [![License](https://img.shields.io/npm/l/@unif/react-native-hms-scan.svg?color=blue)](LICENSE)
 [![Docs](https://img.shields.io/badge/docs-unif--design.github.io-orange.svg)](https://unif-design.github.io/react-native-hms-scan/)
 
-华为 **HMS 统一扫码(HUAWEI Scan Kit)** 的 React Native 封装,面向 RN 0.85 新架构(Fabric + TurboModule):成品扫一扫页、headless 自定义扫码 UI、从图片识别条码 / 二维码。
+华为 **HMS 统一扫码(HUAWEI Scan Kit)** 的 React Native 封装,面向 RN 0.86.2 新架构(Fabric + TurboModule):成品扫一扫页、headless 自定义扫码 UI、从图片识别条码 / 二维码。
 
 ## 特性
 
@@ -61,6 +61,16 @@ function ScanScreen({ navigation }) {
 
 headless `<HmsScanView>`(完全自定义 UI)、图片识别 `decodeImage`、权限、平台差异 —— 见[文档站](https://unif-design.github.io/react-native-hms-scan/)。
 
+## Example 能力展厅
+
+仓库内的 [`example/`](example/) 是可直接运行的三能力展示应用，而非 library API 的一部分：
+
+- **Scanner 成品页** — 配置码制、`autoConfirm`、相册选图与商品确认流。
+- **HmsScanView 自定义页** — 展示由宿主管理的权限、`paused` / `continuous` / `torch`、结果和错误状态。
+- **decodeImage 图片识别** — 从设备上的本地图片选择并离线解码，展示成功、空数组和 `HmsScanError`。
+
+运行、原生配置、平台边界和测试矩阵见 [example/README.md](example/README.md)。示例的 image-picker 与本地商品表仅用于演示，接入应用应替换为自己的选择器和业务数据。
+
 ## 文档
 
 - **完整文档**(安装 · 平台配置 · API · 平台差异 · 故障排查):https://unif-design.github.io/react-native-hms-scan/
@@ -71,7 +81,7 @@ headless `<HmsScanView>`(完全自定义 UI)、图片识别 `decodeImage`、权
 
 | 平台 | 支持 |
 | --- | --- |
-| React Native | 新架构(Fabric + TurboModule)**必须开启**;在 RN 0.85 上开发与验证 |
+| React Native | 新架构(Fabric + TurboModule)**必须开启**;在 RN 0.86.2 / React 19.2.3 上开发与验证 |
 | Android | ✅ minSdkVersion ≥ 24(Android 7.0) |
 | iOS | ✅ 官方 CocoaPod `ScanKitFrameWork 1.1.2.305` + 真机 |
 | iOS Simulator | ❌ 不支持;无硬件逻辑测试使用随包 Jest mock |

package/lib/typescript/jest.setup.d.ts

@@ -1 +1,2 @@
+export {};
 //# sourceMappingURL=jest.setup.d.ts.map

package/lib/typescript/jest.setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jest.setup.d.ts","sourceRoot":"","sources":["../../jest.setup.ts"],"names":[],"mappings":""}
+{"version":3,"file":"jest.setup.d.ts","sourceRoot":"","sources":["../../jest.setup.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unif/react-native-hms-scan",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "description": "华为 HMS 统一扫码服务 React Native bridge：定制视图扫码 + 图片识别 (Scan SDK-Plus / ScanKitFrameWork，@unif 私有)",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -40,7 +40,8 @@
     "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
     "prepare": "bob build",
     "typecheck": "tsc",
-    "test": "yarn verify:android-integration && yarn verify:ios-integration && jest",
+    "test": "yarn verify:integration-contracts && yarn verify:android-integration && yarn verify:ios-integration && jest",
+    "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",
     "lint": "eslint \"**/*.{js,ts,tsx}\""
@@ -71,34 +72,36 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
+    "@babel/core": "^7.25.2",
     "@commitlint/config-conventional": "^20.5.0",
-    "@eslint/js": "^9.39.0",
-    "@react-native/babel-preset": "0.85.3",
-    "@react-native/eslint-config": "0.85.0",
-    "@react-native/jest-preset": "0.85.3",
+    "@eslint/js": "^8.57.1",
+    "@react-native/babel-preset": "0.86.2",
+    "@react-native/eslint-config": "0.86.2",
+    "@react-native/jest-preset": "0.86.2",
+    "@react-native/metro-config": "0.86.2",
     "@release-it/conventional-changelog": "^11.0.0",
     "@sbaiahmed1/react-native-blur": "^4.6.2",
     "@testing-library/react-native": "^13.3.3",
     "@types/jest": "^29.5.0",
     "@types/react": "^19.2.0",
     "@types/react-test-renderer": "^19",
-    "@unif/react-native-design": "0.8.1",
+    "@unif/react-native-design": "0.24.0",
     "commitlint": "^20.5.0",
     "del-cli": "^7.0.0",
-    "eslint": "^9.39.4",
+    "eslint": "^8.57.1",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.5",
     "jest": "^29.7.0",
     "prettier": "^3.8.1",
     "react": "19.2.3",
-    "react-native": "0.85.3",
+    "react-native": "0.86.2",
     "react-native-builder-bob": "^0.41.0",
-    "react-native-gesture-handler": "^2.21.0",
-    "react-native-reanimated": "^4.0.0",
-    "react-native-reanimated-carousel": "^5.0.0-beta.5",
-    "react-native-safe-area-context": "^5.0.0",
+    "react-native-gesture-handler": "^3.1.0",
+    "react-native-reanimated": "^4.5.3",
+    "react-native-reanimated-carousel": "^5.0.0",
+    "react-native-safe-area-context": "^5.7.0",
     "react-native-svg": "^15.15.5",
-    "react-native-worklets": "*",
+    "react-native-worklets": "^0.11.3",
     "react-test-renderer": "19.2.3",
     "release-it": "^20.0.1",
     "turbo": "^2.8.21",
@@ -181,7 +184,18 @@
     ]
   },
   "jest": {
-    "preset": "@react-native/jest-preset",
+    "preset": "@unif/react-native-design/jest-preset",
+    "moduleNameMapper": {
+      "^@unif/react-native-hms-scan$": "<rootDir>/src/index.tsx",
+      "^@unif/react-native-hms-scan/mock$": "<rootDir>/src/mock.ts",
+      "^react$": "<rootDir>/node_modules/react",
+      "^react/(.*)$": "<rootDir>/node_modules/react/$1",
+      "^@unif/react-native-design$": "<rootDir>/node_modules/@unif/react-native-design",
+      "^react-native-gesture-handler$": "<rootDir>/node_modules/react-native-gesture-handler",
+      "^react-native-safe-area-context$": "<rootDir>/node_modules/react-native-safe-area-context",
+      "^react-native-reanimated$": "<rootDir>/node_modules/react-native-reanimated",
+      "^react-native-worklets$": "<rootDir>/node_modules/react-native-worklets"
+    },
     "modulePathIgnorePatterns": [
       "<rootDir>/example/node_modules",
       "<rootDir>/lib/"