@hbdlzy/ui-core 0.1.7 → 0.1.8

package/README.md

@@ -18,10 +18,25 @@
 - `OutlinedTreeSelect`
 - `echarts`
 - `exportExcel`
-- 全局按钮 ripple：导入包入口后自动启用，覆盖原生 `button`、Element Plus `el-button` 以及 radio/checkbox button 形态
+- `Ripple`
+- 全局点击涟漪：导入包入口后自动启用，覆盖原生 `button`、Element Plus `el-button` 以及 radio/checkbox button 形态
 
 ## 使用方式
 
+### 全局注册
+
+只使用核心包时，可以按 Vue 插件注册所有 `ui-core` 组件：
+
+```ts
+import { createApp } from 'vue'
+import HbdlUICore from '@hbdlzy/ui-core'
+import App from './App.vue'
+
+createApp(App).use(HbdlUICore).mount('#app')
+```
+
+### 按需导入
+
 ```ts
 import {
   BaseTable,
@@ -36,6 +51,7 @@ import {
   OutlinedTimePicker,
   OutlinedCascader,
   OutlinedTreeSelect,
+  Ripple,
   installRipple,
   uninstallRipple,
   echarts,
@@ -43,10 +59,21 @@ import {
 } from '@hbdlzy/ui-core'
 ```
 
-全局 ripple 会在导入 `@hbdlzy/ui-core` 时自动安装；如某个按钮不需要水波纹，可在按钮或父级元素上添加 `data-hbdl-ripple="false"`。
+全局点击涟漪会在导入 `@hbdlzy/ui-core` 时自动安装；如某个按钮不需要水波纹，可在按钮或父级元素上添加 `data-hbdl-ripple="false"`。
+
+如果业务项目希望显式控制安装时机，也可以使用插件或细粒度入口：
+
+```ts
+import { createApp } from 'vue'
+import { Ripple } from '@hbdlzy/ui-core/ripple'
+import App from './App.vue'
+
+createApp(App).use(Ripple).mount('#app')
+```
 
 ## 详细文档
 
+- `Ripple`: [src/ripple/README.md](./src/ripple/README.md)
 - `BaseTable`: [src/components/BaseTable/README.md](./src/components/BaseTable/README.md)
 - `BaseCard`: [src/components/BaseCard/README.md](./src/components/BaseCard/README.md)
 - `BaseEChart`: [src/components/BaseEChart/README.md](./src/components/BaseEChart/README.md)
@@ -79,6 +106,7 @@ import {
 - 工具
   - `echarts`
   - `exportExcel`
+  - `Ripple`
   - `installRipple`
   - `uninstallRipple`
 

package/components.manifest.json

@@ -2,6 +2,12 @@
   "package": "@hbdlzy/ui-core",
   "version": 1,
   "updatedAt": "2026-04-21",
+  "plugin": {
+    "name": "HbdlUICore",
+    "importName": "default",
+    "entry": "@hbdlzy/ui-core",
+    "description": "Vue 插件入口，调用 app.use(HbdlUICore) 可全局注册 ui-core 组件并启用全局点击涟漪。"
+  },
   "components": [
     {
       "name": "BaseTable",
@@ -305,11 +311,19 @@
     {
       "name": "installRipple",
       "entry": "@hbdlzy/ui-core",
-      "description": "安装全局按钮 ripple 效果；包入口会自动调用，可用于手动恢复。"
+      "docs": "packages/ui-core/src/ripple/README.md",
+      "description": "安装全局点击涟漪效果；包入口会自动调用，可用于手动恢复。"
+    },
+    {
+      "name": "Ripple",
+      "entry": "@hbdlzy/ui-core",
+      "docs": "packages/ui-core/src/ripple/README.md",
+      "description": "Vue 插件形式的全局点击涟漪能力，可通过 app.use(Ripple) 显式安装。"
     },
     {
       "name": "uninstallRipple",
       "entry": "@hbdlzy/ui-core",
+      "docs": "packages/ui-core/src/ripple/README.md",
       "description": "卸载全局按钮 ripple 事件监听。"
     }
   ]