@hbdlzy/ui-core 0.1.7 → 0.1.9

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",
@@ -30,7 +36,7 @@
         },
         {
           "name": "headerSearch",
-          "type": "boolean | { type?: 'input' | 'select' | 'cascader'; paramKey?: string; placeholder?: string; width?: string | number; searchText?: string; resetText?: string; options?: BaseTableOption[]; multiple?: boolean; clearable?: boolean; filterable?: boolean; optionChildrenKey?: string }",
+          "type": "boolean | { type?: 'input' | 'select' | 'cascader' | 'date' | 'daterange' | 'datetime' | 'datetimerange' | 'time' | 'timerange'; paramKey?: string; placeholder?: string; startPlaceholder?: string; endPlaceholder?: string; rangeSeparator?: string; format?: string; valueFormat?: string; width?: string | number; searchText?: string; resetText?: string; options?: BaseTableOption[]; multiple?: boolean; clearable?: boolean; filterable?: boolean; optionChildrenKey?: string }",
           "required": false
         },
         { "name": "hasSelection", "type": "boolean", "default": false },
@@ -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 事件监听。"
     }
   ]

package/dist/components/BaseTable/BaseTable.types.d.ts

@@ -3,7 +3,7 @@ export type BaseTableAlign = 'left' | 'center' | 'right';
 export type BaseTableColumnKind = 'text' | 'link' | 'actions' | 'image' | 'tag' | 'html' | 'input';
 export type BaseTableSortOrder = 'ascending' | 'descending' | null;
 export type BaseTableSortDirection = string | null;
-export type BaseTableHeaderSearchType = 'input' | 'select' | 'cascader';
+export type BaseTableHeaderSearchType = 'input' | 'select' | 'cascader' | 'date' | 'daterange' | 'datetime' | 'datetimerange' | 'time' | 'timerange';
 export type BaseTableHeaderSearchPrimitiveValue = string | number | boolean;
 export type BaseTableHeaderSearchPathValue = BaseTableHeaderSearchPrimitiveValue[];
 export type BaseTableHeaderSearchValue = BaseTableHeaderSearchPrimitiveValue | BaseTableHeaderSearchPrimitiveValue[];
@@ -11,6 +11,11 @@ export interface BaseTableHeaderSearchConfig {
     type?: BaseTableHeaderSearchType;
     paramKey?: string;
     placeholder?: string;
+    startPlaceholder?: string;
+    endPlaceholder?: string;
+    rangeSeparator?: string;
+    format?: string;
+    valueFormat?: string;
     width?: BaseTableCssValue;
     searchText?: string;
     resetText?: string;

package/dist/components/OutlinedCascader/OutlinedCascader.vue.d.ts

@@ -65,11 +65,11 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     required: boolean;
     popperClass: string;
     placeholder: string;
+    filterable: boolean;
     clearable: boolean;
     propsValue: Record<string, unknown>;
     inputHeight: number;
     isBorder: boolean;
-    filterable: boolean;
     levels: boolean;
     marginBottom: OutlinedCascaderCssValue;
     paddingTop: OutlinedCascaderCssValue;

package/dist/components/OutlinedDatePicker/OutlinedDatePicker.vue.d.ts

@@ -64,16 +64,16 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     value: OutlinedDatePickerValue;
     errorMessage: string;
     required: boolean;
+    format: string;
     placeholder: string;
+    multiple: boolean;
+    valueFormat: string;
     inputHeight: number;
     isBorder: boolean;
     marginBottom: OutlinedDatePickerCssValue;
     paddingTop: OutlinedDatePickerCssValue;
-    multiple: boolean;
     timeValue: boolean;
     typeDate: string;
-    format: string;
-    valueFormat: string;
     showPassword: boolean;
     disabledDate: OutlinedDatePickerDisabledDate;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/OutlinedSelect/OutlinedSelect.vue.d.ts

@@ -78,17 +78,17 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     errorMessage: string;
     required: boolean;
     placeholder: string;
+    multiple: boolean;
+    filterable: boolean;
     clearable: boolean;
+    collapseTags: boolean;
+    collapseTagsTooltip: boolean;
     inputHeight: number;
     isBorder: boolean;
-    filterable: boolean;
     marginBottom: OutlinedSelectCssValue;
     paddingTop: OutlinedSelectCssValue;
-    multiple: boolean;
     showPassword: boolean;
     typeInput: string;
-    collapseTags: boolean;
-    collapseTagsTooltip: boolean;
     keyValue: string;
     labelValue: string;
     noCheck: boolean;

package/dist/components/OutlinedTimePicker/OutlinedTimePicker.vue.d.ts

@@ -69,18 +69,18 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
     value: OutlinedTimePickerValue;
     errorMessage: string;
     required: boolean;
+    format: string;
     placeholder: string;
     clearable: boolean;
+    startPlaceholder: string;
+    endPlaceholder: string;
+    rangeSeparator: string;
+    valueFormat: string;
+    isRange: boolean;
     inputHeight: number;
     isBorder: boolean;
     marginBottom: OutlinedTimePickerCssValue;
     paddingTop: OutlinedTimePickerCssValue;
-    format: string;
-    valueFormat: string;
-    isRange: boolean;
-    startPlaceholder: string;
-    endPlaceholder: string;
-    rangeSeparator: string;
     arrowControl: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/components/OutlinedTreeSelect/OutlinedTreeSelect.vue.d.ts

@@ -95,16 +95,16 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     defaultExpandAll: boolean;
     popperClass: string;
     placeholder: string;
+    multiple: boolean;
+    filterable: boolean;
     clearable: boolean;
+    collapseTags: boolean;
+    collapseTagsTooltip: boolean;
     propsValue: Record<string, unknown>;
     inputHeight: number;
     isBorder: boolean;
-    filterable: boolean;
     marginBottom: OutlinedTreeSelectCssValue;
     paddingTop: OutlinedTreeSelectCssValue;
-    multiple: boolean;
-    collapseTags: boolean;
-    collapseTagsTooltip: boolean;
     keyValue: string;
     labelValue: string;
     maxCollapseTags: number;