@melt-js/comps-art 2026.11.8 → 2026.11.16-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 +21 -12
- package/hel_dist/assets/index-Dab8WMf5.js +1 -0
- package/hel_dist/assets/index-Dab8WMf5.js.gz +0 -0
- package/hel_dist/assets/preload-helper-VtCg8-4b.js +1 -0
- package/hel_dist/assets/shared-runtime-u88-9G6Q.js +1 -0
- package/hel_dist/assets/shared-runtime-u88-9G6Q.js.gz +0 -0
- package/hel_dist/assets/style-ChCm0n5J.css +1 -0
- package/hel_dist/assets/style-ChCm0n5J.css.gz +0 -0
- package/hel_dist/assets/vendor-VheH_XYQ.js +1 -0
- package/hel_dist/assets/vendor-VheH_XYQ.js.gz +0 -0
- package/hel_dist/cdn/example-esm.html +1 -0
- package/hel_dist/cdn/example-umd.html +1 -0
- package/hel_dist/cdn/index.esm.mjs +86 -0
- package/hel_dist/cdn/index.umd.cjs +164 -0
- package/hel_dist/cdn/manifest.json +100 -0
- package/hel_dist/entry.js +141 -18
- package/hel_dist/hel-meta.json +48 -16
- package/hel_dist/index.html +5 -2
- package/hel_proxy/entry.js +141 -18
- package/hel_proxy_es/entry.js +73 -19
- package/hel_proxy_es/types/index.d.ts +162 -0
- package/package.json +42 -23
- package/hel_dist/assets/index-B72ebjhv.js +0 -1
- package/hel_dist/assets/style-D3nkBDaE.css +0 -1
- package/hel_proxy/entry.js.map +0 -1
- package/hel_proxy_es/entry.js.map +0 -1
- package/scripts/check-tdz.mjs +0 -20
- package/scripts/check.mjs +0 -18
- package/scripts/gen-components-index.mjs +0 -129
- package/scripts/meta.mjs +0 -28
- package/scripts/prepublishOnly.mjs +0 -42
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
从 [art-design-pro](https://github.com/Daymychen/art-design-pro) 抽出的 **Vue 3 + Element Plus 公共组件远程包**(hel-micro),
|
|
4
4
|
共 **61 个组件**,供 [`tpl-vue3-admin-ele-art`](../tpl-vue3-admin-ele-art) 以
|
|
5
|
-
`
|
|
5
|
+
`preloadHelLibs` 的方式预加载,业务从包根具名引入。
|
|
6
6
|
|
|
7
7
|
- hel 组名:`comps-art`(`appGroupName` / `LIB_NAME`)
|
|
8
8
|
- 本地联调端口:**20080**(全局端口表见仓库根目录 [`ports.json`](../ports.json),comps = 200xx)
|
|
@@ -10,6 +10,18 @@
|
|
|
10
10
|
|
|
11
11
|
## 导出的组件
|
|
12
12
|
|
|
13
|
+
包根 `exports.import` 指向 `hel_proxy_es/entry.js`,`types` 指向自包含的 `types/index.d.ts`。
|
|
14
|
+
代理具名导出全部 61 个组件及集合、安装器、运行时注入 / 查询 API 和组名;`dtlib` / default 保留兼容。
|
|
15
|
+
代理只依赖 `hel-lib-proxy` 与组名,组件实现不会混入宿主构建。
|
|
16
|
+
|
|
17
|
+
```ts
|
|
18
|
+
// main 先共享运行时并预加载,再动态进入含此 import 的 loadApp / 业务模块。
|
|
19
|
+
import { ArtTable, ArtButtonTable, setupArtRuntime, installArtComponents } from '@melt-js/comps-art'
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
具名 import 不会自动下载实现,必须遵循 `main → preload → import('./loadApp')`。
|
|
23
|
+
模板在 `plugins/art.ts` 注入真实宿主能力,无需本地 remote 访问器。源码与独立构建配置也随包交付,排除 local / 部署环境。
|
|
24
|
+
|
|
13
25
|
| 分类 | 组件 |
|
|
14
26
|
| --- | --- |
|
|
15
27
|
| 基础 | `ArtSvgIcon` `ArtLogo` `ArtBackToTop` `ArtIconButton` |
|
|
@@ -85,14 +97,9 @@ pnpm preview
|
|
|
85
97
|
> 独立调试页只演示不依赖宿主状态的组件(图标、数字滚动、滑块验证、卡片横幅);
|
|
86
98
|
> 依赖 store / hooks / 配置 的组件请通过本体模板 `tpl-vue3-admin-ele-art` 查看。
|
|
87
99
|
|
|
88
|
-
###
|
|
89
|
-
|
|
90
|
-
`pnpm build` **默认不混淆**,只做压缩,理由是 2.6MB 的 UMD 单线程混淆一次要 8 分钟、产物还会 +70%:
|
|
100
|
+
### 构建期压缩与适度混淆
|
|
91
101
|
|
|
92
|
-
|
|
93
|
-
| --- | --- | --- | --- |
|
|
94
|
-
| 默认(terser 压缩 + xlsx mini) | 2.27MB | 777KB | ~30s |
|
|
95
|
-
| `HEL_OBFUSCATE=1`(terser + javascript-obfuscator) | 4.44MB | 1.33MB | ~8min |
|
|
102
|
+
`pnpm build` 默认先压缩,再使用 `vite-plugin-bundle-obfuscator` 适度混淆,与仓库内其它参与统一构建配置的 comps 保持一致。参数统一维护于 `@melt-js/libs-core/scripts/comps-obfuscator-options.cjs`;混淆会增加构建耗时和产物体积。
|
|
96
103
|
|
|
97
104
|
体积相关的几个开关:
|
|
98
105
|
|
|
@@ -102,10 +109,10 @@ pnpm preview
|
|
|
102
109
|
- `xlsx` 别名到官方 `xlsx/dist/xlsx.mini.min.js`(861KB → 245KB,Excel 组件只做 xlsx/csv 读写);
|
|
103
110
|
- 组件里引用的图片在 `assetsInlineLimit` 内内联进 JS,避免 hel 只加载 js 时丢资源。
|
|
104
111
|
|
|
105
|
-
|
|
112
|
+
仅在排查产物问题时关闭混淆(仍不生成 sourcemap):
|
|
106
113
|
|
|
107
114
|
```bash
|
|
108
|
-
HEL_OBFUSCATE=
|
|
115
|
+
HEL_OBFUSCATE=0 pnpm build # 临时关闭混淆;默认构建无需设置该变量
|
|
109
116
|
```
|
|
110
117
|
|
|
111
118
|
混淆参数(与其它 comps 包同一套):`renameGlobals: false`(`window.Vue` / `window.ElementPlus` 等 UMD 约定不能改)、
|
|
@@ -114,7 +121,7 @@ HEL_OBFUSCATE=1 pnpm build # 打开 javascript-obfuscator(参数与 comps-vu
|
|
|
114
121
|
|
|
115
122
|
> 仓库内其它 `comps-*` 包:`comps-vue3-ele` / `comps-vue3-antd` / `comps-pure` 用 Vite 混淆插件,
|
|
116
123
|
> `comps-vue2` / `comps-vue2-ele` / `comps-vue2-antd` / `comps-vue3` 用 `webpack-obfuscator`,
|
|
117
|
-
> `comps-bag-shop` / `comps-bag-sys`
|
|
124
|
+
> `comps-bag-shop` / `comps-bag-sys` 暂不参与本次统一调整,保留原配置。
|
|
118
125
|
|
|
119
126
|
## 目录结构
|
|
120
127
|
|
|
@@ -147,9 +154,11 @@ src/
|
|
|
147
154
|
playground/ 独立调试页
|
|
148
155
|
scripts/
|
|
149
156
|
gen-components-index.mjs 扫描 components 目录生成导出清单
|
|
150
|
-
check.mjs / meta.mjs / prepublishOnly.mjs
|
|
157
|
+
check.mjs / meta.mjs / prepublishOnly.mjs
|
|
151
158
|
```
|
|
152
159
|
|
|
160
|
+
TDZ 检查通过 `pnpm run check:tdz` 调用 `@melt-js/libs-core` 提供的 `hel-check-tdz`,不再保留本地转发脚本。
|
|
161
|
+
|
|
153
162
|
## 与上游源码的差异
|
|
154
163
|
|
|
155
164
|
- 组件源码保持原样,只改了三处 `import.meta.env`:`VITE_API_URL`(wangEditor 上传地址)、
|