@unif/react-native-camera 2.1.0 → 2.4.0

package/README.md

@@ -1,5 +1,9 @@
 # @unif/react-native-camera
 
+[![npm](https://img.shields.io/npm/v/@unif/react-native-camera.svg?color=cb3837&logo=npm)](https://www.npmjs.com/package/@unif/react-native-camera)
+[![CI](https://github.com/unif-design/react-native-camera/actions/workflows/ci.yml/badge.svg)](https://github.com/unif-design/react-native-camera/actions/workflows/ci.yml)
+[![License](https://img.shields.io/npm/l/@unif/react-native-camera.svg?color=blue)](LICENSE)
+
 基于 [react-native-vision-camera](https://github.com/mrousavy/react-native-vision-camera) 5.x 构建的 React Native 相机库，提供模态化相机界面，支持单拍 / 连拍 / 视频录制 / 捏合变焦 / 镜头切换 / 点击对焦。
 
 ## 安装
@@ -95,6 +99,29 @@ const App = () => {
 | `data` | `CustomPhotoFile[]` | 拍摄的文件列表 |
 | `message` | `string` | 描述信息 |
 
+## 测试 (Mock)
+
+本库依赖 `react-native-vision-camera` 等 native 模块，jest 环境无法直接加载。消费者在测试里 mock 本库：
+
+```js
+jest.mock('@unif/react-native-camera', () =>
+  require('@unif/react-native-camera/mock')
+);
+```
+
+mock 后 `useCamera()` 返回 `[api, null]`，`api.open` / `api.close` 是 `jest.fn`，`open` 默认 resolve `{ code: 0, data: [], message: 'cancelled' }`。按需覆盖单次返回：
+
+```ts
+const [api] = useCamera();
+(api.open as jest.Mock).mockResolvedValueOnce({
+  code: 200,
+  data: [{ path: '/x.jpg', uri: 'file:///x.jpg', width: 1, height: 1, mime: 'image/jpeg', mode: 'single' }],
+  message: 'ok',
+});
+```
+
+工具函数（`toFileUri` / `buildPhotoFile` 等）与所有类型在 mock 中保留真实实现。
+
 ## 从 v1.x 升级
 
 `v2.0.0` 的破坏性变更：

package/lib/module/mock.js

@@ -0,0 +1,40 @@
+"use strict";
+
+// Jest mock for @unif/react-native-camera —— 供消费者在测试中替换本库,
+// 避免 jest 环境加载不到 vision-camera 等 native 模块而崩溃。
+//
+// 用法(消费者 jest setup 或单个测试文件):
+//
+//   jest.mock('@unif/react-native-camera', () =>
+//     require('@unif/react-native-camera/mock')
+//   );
+//
+// 替换后 useCamera() 返回 [api, null]:api.open / api.close 是 jest.fn,
+// open 默认 resolve { code: 0, data: [], message: 'cancelled' }。
+// 消费者可按需覆盖单次返回:
+//
+//   const [api] = useCamera();
+//   (api.open as jest.Mock).mockResolvedValueOnce({
+//     code: 200, data: [{ path: '/x.jpg', uri: 'file:///x.jpg', width: 1, height: 1,
+//                         mime: 'image/jpeg', mode: 'single' }], message: 'ok',
+//   });
+
+// 类型 + 纯工具函数(toFileUri / buildPhotoFile / depsAreSame / pxToDp)保留真实实现 ——
+// 它们不碰 native,消费者测试里跑真实逻辑比 mock 更有意义。
+export * from "./utils/index.js";
+
+// 与 src/index.tsx 保持一致;mock 不能 import index(会触发 native 依赖链,失去 mock 意义)。
+export const VERSION = '2.0.0';
+const cancelled = {
+  code: 0,
+  data: [],
+  message: 'cancelled'
+};
+export function useCamera() {
+  const api = {
+    open: jest.fn(async () => cancelled),
+    close: jest.fn()
+  };
+  return [api, null];
+}
+//# sourceMappingURL=mock.js.map

package/lib/module/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["VERSION","cancelled","code","data","message","useCamera","api","open","jest","fn","close"],"sourceRoot":"../../src","sources":["mock.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;AACA;AACA,cAAc,kBAAS;;AAEvB;AACA,OAAO,MAAMA,OAAO,GAAG,OAAO;AAE9B,MAAMC,SAAuB,GAAG;EAAEC,IAAI,EAAE,CAAC;EAAEC,IAAI,EAAE,EAAE;EAAEC,OAAO,EAAE;AAAY,CAAC;AAE3E,OAAO,SAASC,SAASA,CAAA,EAAsB;EAC7C,MAAMC,GAAc,GAAG;IACrBC,IAAI,EAAEC,IAAI,CAACC,EAAE,CAAC,YAAYR,SAAS,CAAsB;IACzDS,KAAK,EAAEF,IAAI,CAACC,EAAE,CAAC;EACjB,CAAC;EACD,OAAO,CAACH,GAAG,EAAE,IAAI,CAAC;AACpB","ignoreList":[]}

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

@@ -0,0 +1,5 @@
+import type { CameraApi } from './utils';
+export * from './utils';
+export declare const VERSION = "2.0.0";
+export declare function useCamera(): [CameraApi, null];
+//# sourceMappingURL=mock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/mock.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,SAAS,CAAC;AAIvD,cAAc,SAAS,CAAC;AAGxB,eAAO,MAAM,OAAO,UAAU,CAAC;AAI/B,wBAAgB,SAAS,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAM7C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unif/react-native-camera",
-  "version": "2.1.0",
+  "version": "2.4.0",
   "description": "基于 react-native-vision-camera 的相机库（单拍/连拍/视频+水印+预览）",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
@@ -10,6 +10,11 @@
       "types": "./lib/typescript/src/index.d.ts",
       "default": "./lib/module/index.js"
     },
+    "./mock": {
+      "source": "./src/mock.ts",
+      "types": "./lib/typescript/src/mock.d.ts",
+      "default": "./lib/module/mock.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -78,7 +83,7 @@
     "@types/jest": "^29.5.0",
     "@types/react": "^19.2.0",
     "@types/react-test-renderer": "^19",
-    "@unif/react-native-design": "^0.3.0",
+    "@unif/react-native-design": "^0.4.0",
     "commitlint": "^20.5.0",
     "del-cli": "^7.0.0",
     "eslint": "^9.39.4",
@@ -109,7 +114,7 @@
   "peerDependencies": {
     "@gorhom/bottom-sheet": ">=5",
     "@sbaiahmed1/react-native-blur": ">=4",
-    "@unif/react-native-design": ">=0.3.0",
+    "@unif/react-native-design": ">=0.4.0",
     "react": ">=19.0.0",
     "react-native": ">=0.85.0",
     "react-native-gesture-handler": ">=2.21.0",
@@ -152,8 +157,9 @@
   },
   "release-it": {
     "git": {
-      "commitMessage": "chore: release ${version}",
-      "tagName": "v${version}"
+      "commitMessage": "chore: release ${version} [skip ci]",
+      "tagName": "v${version}",
+      "requireCommits": true
     },
     "npm": {
       "publish": true,

package/src/mock.ts

@@ -0,0 +1,37 @@
+// Jest mock for @unif/react-native-camera —— 供消费者在测试中替换本库,
+// 避免 jest 环境加载不到 vision-camera 等 native 模块而崩溃。
+//
+// 用法(消费者 jest setup 或单个测试文件):
+//
+//   jest.mock('@unif/react-native-camera', () =>
+//     require('@unif/react-native-camera/mock')
+//   );
+//
+// 替换后 useCamera() 返回 [api, null]:api.open / api.close 是 jest.fn,
+// open 默认 resolve { code: 0, data: [], message: 'cancelled' }。
+// 消费者可按需覆盖单次返回:
+//
+//   const [api] = useCamera();
+//   (api.open as jest.Mock).mockResolvedValueOnce({
+//     code: 200, data: [{ path: '/x.jpg', uri: 'file:///x.jpg', width: 1, height: 1,
+//                         mime: 'image/jpeg', mode: 'single' }], message: 'ok',
+//   });
+
+import type { CameraApi, CameraResult } from './utils';
+
+// 类型 + 纯工具函数(toFileUri / buildPhotoFile / depsAreSame / pxToDp)保留真实实现 ——
+// 它们不碰 native,消费者测试里跑真实逻辑比 mock 更有意义。
+export * from './utils';
+
+// 与 src/index.tsx 保持一致;mock 不能 import index(会触发 native 依赖链,失去 mock 意义)。
+export const VERSION = '2.0.0';
+
+const cancelled: CameraResult = { code: 0, data: [], message: 'cancelled' };
+
+export function useCamera(): [CameraApi, null] {
+  const api: CameraApi = {
+    open: jest.fn(async () => cancelled) as CameraApi['open'],
+    close: jest.fn() as CameraApi['close'],
+  };
+  return [api, null];
+}