@gup-fe/js-sdk 2.1.0 → 2.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -2
- package/package.json +13 -15
package/README.md
CHANGED
|
@@ -18,6 +18,13 @@ npm install @gup-fe/js-sdk
|
|
|
18
18
|
pnpm add @gup-fe/js-sdk
|
|
19
19
|
```
|
|
20
20
|
|
|
21
|
+
> **⚠️ 特别注意（针对 Vue 3 或非 React 项目）：**
|
|
22
|
+
> 本 SDK 的底层 UI 是基于 React 渲染的，但为了避免在 React 宿主项目中产生冲突（导致 Invalid Hook Call 等报错），SDK **没有将 React 打包进源码中**。
|
|
23
|
+
> 因此，如果您在 **Vue 3** 等其他非 React 环境中使用，必须手动在您的项目中安装 `react` 和 `react-dom` 作为运行时依赖，打包工具（如 Vite/Webpack）才能正常为您编译：
|
|
24
|
+
> ```bash
|
|
25
|
+
> npm install react react-dom
|
|
26
|
+
> ```
|
|
27
|
+
|
|
21
28
|
## 快速上手
|
|
22
29
|
|
|
23
30
|
### 方式一：命令式调用（推荐，适用于任意框架）
|
|
@@ -82,8 +89,12 @@ function App() {
|
|
|
82
89
|
<title>JS SDK Demo</title>
|
|
83
90
|
</head>
|
|
84
91
|
<body>
|
|
85
|
-
<!--
|
|
86
|
-
<script src="https://unpkg.com
|
|
92
|
+
<!-- 1. 必须先引入 React 运行时库 -->
|
|
93
|
+
<script src="https://unpkg.com/react@18/umd/react.production.min.js"></script>
|
|
94
|
+
<script src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>
|
|
95
|
+
|
|
96
|
+
<!-- 2. 引入 SDK 的 UMD 产物 -->
|
|
97
|
+
<script src="https://unpkg.com/@gup-fe/js-sdk@2.1.0/dist/js-sdk.umd.js"></script>
|
|
87
98
|
|
|
88
99
|
<script>
|
|
89
100
|
// 直接使用全局变量 SDK 调用
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gup-fe/js-sdk",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "2.1.
|
|
4
|
+
"version": "2.1.1",
|
|
5
5
|
"publishConfig": {
|
|
6
6
|
"access": "public",
|
|
7
7
|
"registry": "https://registry.npmjs.org/"
|
|
@@ -23,37 +23,35 @@
|
|
|
23
23
|
"react": "^19.0.0",
|
|
24
24
|
"react-dom": "^19.0.0"
|
|
25
25
|
},
|
|
26
|
-
"
|
|
26
|
+
"devDependencies": {
|
|
27
27
|
"@base-ui/react": "^1.1.0",
|
|
28
28
|
"@fingerprintjs/fingerprintjs": "^4.6.2",
|
|
29
29
|
"@tanstack/react-query": "^5.81.5",
|
|
30
|
-
"@types/uuid": "^11.0.0",
|
|
31
|
-
"ahooks": "^3.9.7",
|
|
32
|
-
"clsx": "^2.1.1",
|
|
33
|
-
"lucide-react": "0.577.0",
|
|
34
|
-
"tailwind-merge": "^2.6.0",
|
|
35
|
-
"usehooks-ts": "^3.1.1",
|
|
36
|
-
"uuid": "13.0.0",
|
|
37
|
-
"zod": "^3.24.2",
|
|
38
|
-
"@gup-fe/lib": "0.0.0",
|
|
39
|
-
"@gup-fe/ui": "0.0.0"
|
|
40
|
-
},
|
|
41
|
-
"devDependencies": {
|
|
42
30
|
"@testing-library/jest-dom": "6.9.1",
|
|
43
31
|
"@types/node": "25.5.0",
|
|
44
32
|
"@types/react": "^19.2.7",
|
|
45
33
|
"@types/react-dom": "^19.0.3",
|
|
34
|
+
"@types/uuid": "^11.0.0",
|
|
46
35
|
"@vitejs/plugin-react-swc": "4.3.0",
|
|
36
|
+
"ahooks": "^3.9.7",
|
|
47
37
|
"autoprefixer": "^10.4.27",
|
|
38
|
+
"clsx": "^2.1.1",
|
|
39
|
+
"lucide-react": "0.577.0",
|
|
48
40
|
"postcss": "^8.5.8",
|
|
41
|
+
"tailwind-merge": "^2.6.0",
|
|
49
42
|
"tailwindcss": "^3.4.17",
|
|
50
43
|
"typescript": "5.9.3",
|
|
44
|
+
"usehooks-ts": "^3.1.1",
|
|
45
|
+
"uuid": "13.0.0",
|
|
51
46
|
"vite": "^7.3.1",
|
|
52
47
|
"vite-plugin-css-injected-by-js": "^5.0.1",
|
|
53
48
|
"vite-plugin-dts": "^4.5.4",
|
|
49
|
+
"zod": "^3.24.2",
|
|
54
50
|
"@gup-fe/eslint-config": "0.0.0",
|
|
55
51
|
"@gup-fe/typescript-config": "0.0.0",
|
|
56
|
-
"@gup-fe/tailwind-config": "0.0.0"
|
|
52
|
+
"@gup-fe/tailwind-config": "0.0.0",
|
|
53
|
+
"@gup-fe/ui": "0.0.0",
|
|
54
|
+
"@gup-fe/lib": "0.0.0"
|
|
57
55
|
},
|
|
58
56
|
"scripts": {
|
|
59
57
|
"dev": "vite",
|