@iswangh/element-plus-kit 0.1.0 → 0.1.1

package/README.md

@@ -41,7 +41,8 @@ import { createApp } from 'vue'
 import ElementPlus from 'element-plus'
 import zhCn from 'element-plus/es/locale/lang/zh-cn'
 import ElementPlusKit from '@iswangh/element-plus-kit'
-import 'element-plus/dist/index.css'
+import App from './App.vue'
+// 注意：WForm 组件已按需导入了所有内部使用的 Element Plus 组件样式，无需导入全局样式
 
 const app = createApp(App)
 
@@ -99,9 +100,11 @@ import App from './App.vue'
 ```typescript
 import { createApp } from 'vue'
 import ElementPlusKit from '@iswangh/element-plus-kit'
+import App from './App.vue'
 
 const app = createApp(App)
 app.use(ElementPlusKit)
+app.mount('#app')
 ```
 
 ```vue
@@ -114,8 +117,9 @@ app.use(ElementPlusKit)
 
 ```vue
 <script setup lang="ts">
+import { ref } from 'vue'
 import { WForm } from '@iswangh/element-plus-kit'
-import type { FormItems } from '@iswangh/element-plus-kit-form'
+import type { FormItems } from '@iswangh/element-plus-kit'
 
 const formItems: FormItems = [
   {
@@ -154,22 +158,26 @@ import vue from '@vitejs/plugin-vue'
 import AutoImport from 'unplugin-auto-import/vite'
 import Components from 'unplugin-vue-components/vite'
 import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
-import { ElementPlusKitResolver, ElementPlusKitAutoImportResolver } from '@iswangh/element-plus-kit/resolver'
+import { ElementPlusKitResolver } from '@iswangh/element-plus-kit/resolver'
 
 export default defineConfig({
   plugins: [
     vue(),
     AutoImport({
       resolvers: [
+        // ElementPlusResolver 默认 importStyle 为 'css'，会自动导入模板中直接使用的 Element Plus 组件样式
+        // 注意：WForm 组件内部使用的 Element Plus 组件样式已在组件包内按需导入，无需额外配置
         ElementPlusResolver(),
-        ElementPlusKitAutoImportResolver(),
+        ElementPlusKitResolver(), // ElementPlusKitResolver 同时支持 AutoImport 和 Components
       ],
       imports: ['vue'],
     }),
     Components({
       resolvers: [
+        // ElementPlusResolver 默认 importStyle 为 'css'，会自动导入模板中直接使用的 Element Plus 组件样式
+        // 注意：WForm 组件内部使用的 Element Plus 组件样式已在组件包内按需导入，无需额外配置
         ElementPlusResolver(),
-        ElementPlusKitResolver(),
+        ElementPlusKitResolver(), // ElementPlusKitResolver 同时支持 AutoImport 和 Components
       ],
     }),
   ],
@@ -181,7 +189,7 @@ export default defineConfig({
 ```vue
 <script setup lang="ts">
 // 无需手动导入，组件会自动导入
-import type { FormItems } from '@iswangh/element-plus-kit-form'
+import type { FormItems } from '@iswangh/element-plus-kit'
 
 const formItems: FormItems = [
   {
@@ -216,7 +224,9 @@ const form = ref({
 
 ### ElementPlusKitResolver
 
-用于 `unplugin-vue-components` 的组件自动导入。
+统一解析器，同时支持 `unplugin-vue-components` 和 `unplugin-auto-import`。
+
+**用于组件自动导入**（`unplugin-vue-components`）：
 
 ```typescript
 import { ElementPlusKitResolver } from '@iswangh/element-plus-kit/resolver'
@@ -229,21 +239,35 @@ Components({
 })
 ```
 
-### ElementPlusKitAutoImportResolver
-
-用于 `unplugin-auto-import` 的 API 自动导入。
+**用于 API 自动导入**（`unplugin-auto-import`）：
 
 ```typescript
-import { ElementPlusKitAutoImportResolver } from '@iswangh/element-plus-kit/resolver'
+import { ElementPlusKitResolver } from '@iswangh/element-plus-kit/resolver'
 import AutoImport from 'unplugin-auto-import/vite'
 
 AutoImport({
   resolvers: [
-    ElementPlusKitAutoImportResolver(),
+    ElementPlusKitResolver(), // 同一个解析器可以同时用于两种插件
   ],
 })
 ```
 
+**同时使用**（推荐）：
+
+```typescript
+import { ElementPlusKitResolver } from '@iswangh/element-plus-kit/resolver'
+import AutoImport from 'unplugin-auto-import/vite'
+import Components from 'unplugin-vue-components/vite'
+
+AutoImport({
+  resolvers: [ElementPlusKitResolver()],
+})
+
+Components({
+  resolvers: [ElementPlusKitResolver()],
+})
+```
+
 ## 📖 API 文档
 
 ### 全局安装函数
@@ -283,8 +307,9 @@ import type {
 
 ```vue
 <script setup lang="ts">
+import { ref } from 'vue'
 import { WForm } from '@iswangh/element-plus-kit'
-import type { FormItems } from '@iswangh/element-plus-kit-form'
+import type { FormItems } from '@iswangh/element-plus-kit'
 
 const formItems: FormItems = [
   {
@@ -324,8 +349,9 @@ const form = ref({
 
 ```vue
 <script setup lang="ts">
+import { ref } from 'vue'
 import { WForm } from '@iswangh/element-plus-kit'
-import type { FormItems, ActionConfig } from '@iswangh/element-plus-kit-form'
+import type { FormItems, ActionConfig } from '@iswangh/element-plus-kit'
 
 const formItems: FormItems = [
   {
@@ -360,6 +386,7 @@ const form = ref({
 - [Form 组件文档](../form/README.md)
 - [核心工具包文档](../core/README.md)
 - [Element Plus 文档](https://element-plus.org/zh-CN/)
+- [Gitee 仓库](https://gitee.com/iswangh/element-plus-kit)
 - [GitHub 仓库](https://github.com/iswangh/element-plus-kit)
 
 ## 📄 许可证

package/dist/resolver.js

@@ -18,6 +18,9 @@ function c() {
         return {
           name: o,
           from: `@iswangh/${e}`,
+          // sideEffects 配置：确保样式文件在 Tree Shaking 时不被移除
+          // 注意：packages/form/src/index.ts 中已按需导入了所有 Element Plus 组件样式，
+          // 当组件被导入时，样式会自动被导入，无需额外配置
           sideEffects: `@iswangh/${e}/style.css`
         };
     }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@iswangh/element-plus-kit",
   "type": "module",
-  "version": "0.1.0",
-  "description": "Element Plus Kit - A collection of Vue 3 components based on Element Plus",
+  "version": "0.1.1",
+  "description": "Element Plus Kit - 基于 Element Plus 的 Vue 3 组件集合",
   "author": "iswangh",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/iswangh/element-plus-kit.git"
+    "url": "https://gitee.com/iswangh/element-plus-kit.git"
   },
   "keywords": [
     "vue",
@@ -39,7 +39,7 @@
     "vue": "^3.5.23"
   },
   "dependencies": {
-    "@iswangh/element-plus-kit-form": "0.1.0"
+    "@iswangh/element-plus-kit-form": "0.1.1"
   },
   "devDependencies": {
     "@vitejs/plugin-vue": "^6.0.1",