conorg-vab-plus-sit 1.0.0

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 ADDED
@@ -0,0 +1,153 @@
1
+ # Craft-X 组件库项目依赖解析
2
+
3
+ ## **📌 项目描述**
4
+
5
+ - **名称**: Craft-X
6
+ - **类型**: Vue 3 组件库
7
+ - **构建工具**: Vite
8
+ - **文档**: VitePress
9
+ - **模块格式**: ESM & UMD
10
+ - **目标**: 让使用者可以直接使用,不需要额外安装相同的依赖
11
+
12
+ ---
13
+
14
+ ## **📌 依赖优化**
15
+
16
+ - **将 `dependencies` 中仅用于开发的依赖移动到 `devDependencies`**
17
+ - **组件库核心功能所需的依赖保留在 `dependencies`**
18
+ - **确保使用者不需要重复安装组件库的核心依赖**
19
+
20
+ ---
21
+
22
+ ## **📌 dependencies(运行时依赖 - 用户安装组件库后仍需要)**
23
+
24
+ 这些依赖 **会被打包到组件库的最终产物中**,使用者无需再次安装。
25
+
26
+ ### **🚀 1. Vue 相关**
27
+
28
+ | 依赖 | 作用 |
29
+ | ----- | ------------------------------------------- |
30
+ | `vue` | **Vue 3 核心库**,组件库必须依赖 Vue 运行。 |
31
+
32
+ ---
33
+
34
+ ### **🚀 2. 核心功能**
35
+
36
+ | 依赖 | 作用 |
37
+ | ------------------ | ---------------------------------------------------------------------------------------------------------- |
38
+ | `tinycolor2` | **颜色处理库**,用于计算颜色渐变、转换颜色格式等。 |
39
+ | `autoprefixer` | **CSS 预处理工具**,根据 目标浏览器列表 自动添加 浏览器前缀(如 -webkit-、-moz-、-ms-)以提高 CSS 兼容性。 |
40
+ | `crypto-js` | **加密库**,提供 MD5、SHA256、AES 等加密功能。 |
41
+ | `dayjs` | **轻量级日期处理库**,代替 Moment.js,处理时间格式化等。 |
42
+ | `lodash-es` | **Lodash 的 ES 模块版本**,提供高性能的工具函数。 |
43
+ | `mitt` | **轻量级事件总线**(Event Bus),用于组件间通信。 |
44
+ | `sass` | **SASS/SCSS 预处理器**,用于样式管理。 |
45
+ | `semver` | **语义化版本管理工具**,用于解析版本号。 |
46
+ | `ssh2-sftp-client` | **SSH/SFTP 客户端库**,用于自动化文件上传等。 |
47
+
48
+ ---
49
+
50
+ ## **📌 devDependencies(开发依赖 - 仅用于开发,不会被打包)**
51
+
52
+ 这些依赖 **仅在开发时使用**,不会包含在最终的组件库中,因此 **使用者无需安装它们**。
53
+
54
+ ### **🚀 1. Vite & 构建工具**
55
+
56
+ | 依赖 | 作用 |
57
+ | ------------------------ | ---------------------------------------------------------- |
58
+ | `vite` | **前端构建工具**,用于本地开发和打包组件库。 |
59
+ | `vitepress` | **Vite 官方的文档生成工具**,用于编写组件库文档。 |
60
+ | `@vitejs/plugin-vue` | **Vue 3 的官方 Vite 插件**,让 Vite 正确编译 `.vue` 组件。 |
61
+ | `@vitejs/plugin-vue-jsx` | **Vue 3 JSX 支持**,让 Vue 组件可以使用 JSX 语法。 |
62
+
63
+ ---
64
+
65
+ ### **🚀 2. TypeScript & 类型支持**
66
+
67
+ | 依赖 | 作用 |
68
+ | ------------------ | ------------------------------------------------------------------- |
69
+ | `typescript` | **TypeScript 编译器**,让组件库支持 TS。 |
70
+ | `@types/crypto-js` | **CryptoJS 的 TypeScript 类型**,保证 `crypto-js` 代码有类型提示。 |
71
+ | `@types/lodash-es` | **Lodash-ES 的 TypeScript 类型**。 |
72
+ | `@types/node` | **Node.js API 的类型定义**,确保 `fs`、`path` 这些 API 有类型提示。 |
73
+
74
+ ---
75
+
76
+ ### **🚀 3. Vue 生态 & 组件增强**
77
+
78
+ | 依赖 | 作用 |
79
+ | ------------------------- | ------------------------------------------------------------------------------------------- |
80
+ | `@vueuse/core` | **VueUse 核心库**,提供丰富的 Vue 组合式 API(如 `useDark()`、`useLocalStorage()`)。 |
81
+ | `@vueuse/head` | **VueUse 的 `useHead()` 插件**,用于动态修改 `<head>` 标签,如 `<title>` 和 `<meta>` 信息。 |
82
+ | `unplugin-auto-import` | **自动导入 Vue API**(如 `ref`、`computed`,无需手动 `import`)。 |
83
+ | `unplugin-vue-components` | **自动注册 Vue 组件**,不需要手动 `import` 组件。 |
84
+
85
+ ---
86
+
87
+ ### **🚀 4. CLI & 开发工具**
88
+
89
+ | 依赖 | 作用 |
90
+ | ----------------------- | ------------------------------------------------- |
91
+ | `inquirer` | **CLI 交互工具**,用于创建 CLI 命令交互。 |
92
+ | `markdown-it-container` | **Markdown 解析扩展**,用于解析 Markdown 代码块。 |
93
+
94
+ ---
95
+
96
+ ## **📌 修正后的 `package.json`**
97
+
98
+ ```json
99
+ {
100
+ "name": "craft-x",
101
+ "private": true,
102
+ "version": "0.0.0",
103
+ "author": "conorg@162.com",
104
+ "description": "",
105
+ "type": "module",
106
+ "main": "lib/index.umd.js",
107
+ "scripts": {
108
+ "dev": "vite",
109
+ "docs:dev": "vitepress dev docs",
110
+ "docs:build": "vitepress build docs",
111
+ "build": "node scripts/build-lib.js"
112
+ },
113
+ "exports": {
114
+ ".": {
115
+ "import": "./lib/index.es.js",
116
+ "require": "./lib/index.umd.js"
117
+ },
118
+ "./styles": {
119
+ "import": "./lib/index.css",
120
+ "require": "./lib/index.css"
121
+ }
122
+ },
123
+ "files": ["lib", "README.md", "LICENSE"],
124
+ "dependencies": {
125
+ "tinycolor2": "^1.6.0",
126
+ "crypto-js": "^4.2.0",
127
+ "dayjs": "^1.11.13",
128
+ "lodash-es": "^4.17.21",
129
+ "mitt": "^3.0.1",
130
+ "sass": "^1.77.8",
131
+ "semver": "^7.7.1",
132
+ "ssh2-sftp-client": "^11.0.0",
133
+ "vue": "^3.4.29"
134
+ },
135
+ "devDependencies": {
136
+ "autoprefixer": "^10.4.21",
137
+ "vite": "^6.0.2",
138
+ "vitepress": "^1.6.3",
139
+ "@vitejs/plugin-vue": "^5.1.2",
140
+ "@vitejs/plugin-vue-jsx": "^4.0.1",
141
+ "typescript": "^5.2.2",
142
+ "@types/crypto-js": "^4.2.2",
143
+ "@types/lodash-es": "^4.17.12",
144
+ "@types/node": "^20.16.5",
145
+ "@vueuse/core": "^11.0.3",
146
+ "@vueuse/head": "^2.0.0",
147
+ "unplugin-auto-import": "^0.18.0",
148
+ "unplugin-vue-components": "^0.27.3",
149
+ "inquirer": "^12.4.2",
150
+ "markdown-it-container": "^4.0.0"
151
+ }
152
+ }
153
+ ```
package/lib/index.css ADDED
@@ -0,0 +1 @@
1
+ .vab-button{display:inline-block;background:#000;color:#fff;border-radius:4px;padding:6px 10px;font-size:14px;line-height:1.5rem;box-sizing:border-box}.vab-text{display:inline-block;background:#cbaaaa;color:#fff;border-radius:4px;padding:6px 10px;font-size:14px;line-height:1.5rem;box-sizing:border-box}