开始
安装
三个包都以 AGPL-3.0-only 公开发布,版本锁步。模块包依赖 Vue 包,Vue 包依赖 core——三个都显式安装,能让版本在你的 manifest 里保持可见。
安装命令
按你的项目类型选一边。Nuxt 项目多出来的那几个包,是 KunUI 的 Nuxt 层与它需要的图标集。
Nuxt 项目
pnpm add @nextmoe/edit-ui-nuxt @nextmoe/edit-ui-vue @nextmoe/edit-ui-core
pnpm add @kungal/ui-nuxt @kungal/ui-tokens @kungal/ui-vue
pnpm add -D tailwindcss @tailwindcss/vite @iconify-json/lucideVue + Vite 项目
pnpm add @nextmoe/edit-ui-vue @nextmoe/edit-ui-core
pnpm add @kungal/ui-vue @kungal/ui-tokens
pnpm add @iconify/vue # 原因见「在 Vue 中使用」的图标一节
pnpm add -D tailwindcss @tailwindcss/vitepeer 依赖
KunUI 与 Vue 都是 peer 依赖,由你的项目提供,包本身不会再装一份——否则 KunUI 会出现两个 provide/inject 身份。
| 包 | peer 依赖 | 说明 |
|---|---|---|
| @nextmoe/edit-ui-core | 无 | 自带 diff ^9。依赖闭包里没有任何 Vue,Node 脚本、SSR 或测试里都能直接引。 |
| @nextmoe/edit-ui-vue | vue ^3.5.0 · @kungal/ui-vue ^2.26.2 | 另外以普通依赖引入 @vueuse/core、@vueuse/integrations 与 sortablejs。 |
| @nextmoe/edit-ui-nuxt | vue ^3.5.0 · nuxt ^4.0.0 · @kungal/ui-vue ^2.26.2 | 交给 Nuxt 的 jiti 直接加载原始 TS,没有构建产物。 |
KunUI 的下限是 2.26.2,不是 ^2
低于这个版本有两个会真实咬到人的上游 bug:2.25.0 之前 KunDatePicker 在 SSR 下必然 hydration mismatch(日期字段一出现整页就是 mismatch),2.26.2 之前输入法组合期的回车会被 KunAutocomplete / 可搜索的 KunSelect 抢走——中文输入下,在实体选择器里打拼音按回车确认候选词,回车会变成「选中当前高亮项」。两处都在 KunUI 侧修好了,这里只是把下限写进 peer 范围。
下一步
装完之后还差两件事:把组件接进项目,以及让 Tailwind 扫到它们的类名。
别跳过 Tailwind 那一步
这些包不含任何 CSS。少了一行 @source 配置,组件会以完全没有样式的形态渲染出来——没有报错,没有警告,只有一个塌掉的表单。