@hbdlzy/ui-core 0.1.6 → 0.1.8

package/README.md

@@ -8,6 +8,7 @@
 - `BaseCard`
 - `BaseEChart`
 - `BaseExportButton`
+- `SvgIcon`
 - `OutlinedInput`
 - `OutlinedSelect`
 - `OutlinedDatePicker`
@@ -17,16 +18,32 @@
 - `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,
   BaseCard,
   BaseEChart,
   BaseExportButton,
+  SvgIcon,
   OutlinedInput,
   OutlinedSelect,
   OutlinedDatePicker,
@@ -34,6 +51,7 @@ import {
   OutlinedTimePicker,
   OutlinedCascader,
   OutlinedTreeSelect,
+  Ripple,
   installRipple,
   uninstallRipple,
   echarts,
@@ -41,14 +59,26 @@ 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)
 - `BaseExportButton`: [src/components/BaseExportButton/README.md](./src/components/BaseExportButton/README.md)
+- `SvgIcon`: [src/components/SvgIcon/README.md](./src/components/SvgIcon/README.md)
 - `OutlinedInput`: [src/components/OutlinedInput/README.md](./src/components/OutlinedInput/README.md)
 - `OutlinedSelect`: [src/components/OutlinedSelect/README.md](./src/components/OutlinedSelect/README.md)
 - `OutlinedDatePicker`: [src/components/OutlinedDatePicker/README.md](./src/components/OutlinedDatePicker/README.md)
@@ -65,6 +95,7 @@ import {
   - `BaseCard`
   - `BaseEChart`
   - `BaseExportButton`
+  - `SvgIcon`
   - `OutlinedInput`
   - `OutlinedSelect`
   - `OutlinedDatePicker`
@@ -75,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 | { paramKey?: string; placeholder?: string; width?: string | number; searchText?: string; resetText?: string }",
+          "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 }",
           "required": false
         },
         { "name": "hasSelection", "type": "boolean", "default": false },
@@ -94,6 +100,21 @@
       ],
       "emits": ["start", "success", "error"]
     },
+    {
+      "name": "SvgIcon",
+      "category": "ui-core",
+      "entry": "@hbdlzy/ui-core",
+      "importName": "SvgIcon",
+      "docs": "packages/ui-core/src/components/SvgIcon/README.md",
+      "description": "统一展示 SVG symbol sprite 和外链 SVG 图标，兼容旧项目 icon-class、class-name 写法。",
+      "props": [
+        { "name": "iconClass", "type": "string", "required": true },
+        { "name": "className", "type": "string", "default": "" },
+        { "name": "prefix", "type": "string", "default": "icon" },
+        { "name": "ariaLabel", "type": "string", "default": "" }
+      ],
+      "emits": []
+    },
     {
       "name": "OutlinedInput",
       "category": "ui-core",
@@ -290,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,18 +3,33 @@ 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 BaseTableHeaderSearchPrimitiveValue = string | number | boolean;
+export type BaseTableHeaderSearchPathValue = BaseTableHeaderSearchPrimitiveValue[];
+export type BaseTableHeaderSearchValue = BaseTableHeaderSearchPrimitiveValue | BaseTableHeaderSearchPrimitiveValue[];
 export interface BaseTableHeaderSearchConfig {
+    type?: BaseTableHeaderSearchType;
     paramKey?: string;
     placeholder?: string;
     width?: BaseTableCssValue;
     searchText?: string;
     resetText?: string;
+    options?: BaseTableOption[];
+    multiple?: boolean;
+    clearable?: boolean;
+    filterable?: boolean;
+    optionValueKey?: string;
+    optionLabelKey?: string;
+    optionDisabledKey?: string;
+    optionChildrenKey?: string;
 }
 export interface BaseTableOption {
     label: string;
     value: string | number | boolean;
     tagType?: '' | 'success' | 'warning' | 'info' | 'danger' | 'primary';
     color?: string;
+    disabled?: boolean;
+    children?: BaseTableOption[];
 }
 export interface BaseTableAction<Row = Record<string, any>> {
     label: string;
@@ -153,9 +168,9 @@ export interface BaseTableExpose<Row = Record<string, any>> {
     refresh: () => Promise<void>;
     setData: (data: Row[]) => void;
     resetPage: () => Promise<void>;
-    setHeaderSearchValue: (key: string, value: string, shouldReload?: boolean) => Promise<void>;
+    setHeaderSearchValue: (key: string, value: BaseTableHeaderSearchValue, shouldReload?: boolean) => Promise<void>;
     resetHeaderSearch: (key?: string) => Promise<void>;
-    getHeaderSearchValues: () => Record<string, string>;
+    getHeaderSearchValues: () => Record<string, BaseTableHeaderSearchValue>;
     clearSelection: () => void;
     toggleRowSelection: (row: Row, selected?: boolean) => void;
     getSelectionRows: () => Row[];

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

@@ -1,4 +1,4 @@
-import type { BaseTableCellPayload, BaseTableColumn, BaseTableCssValue, BaseTableLoadedPayload, BaseTablePagination, BaseTableProps, BaseTableRowActionPayload, BaseTableSortPayload } from './BaseTable.types';
+import type { BaseTableCellPayload, BaseTableColumn, BaseTableCssValue, BaseTableHeaderSearchValue, BaseTableLoadedPayload, BaseTablePagination, BaseTableProps, BaseTableRowActionPayload, BaseTableSortPayload } from './BaseTable.types';
 type BaseTableRow = Record<string, any>;
 declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BaseTableProps<Record<string, any>>>, {
     data: () => never[];
@@ -37,9 +37,9 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     refresh: () => Promise<void>;
     setData: (data: Record<string, any>[]) => void;
     resetPage: () => Promise<void>;
-    setHeaderSearchValue: (key: string, value: string, shouldReload?: boolean | undefined) => Promise<void>;
+    setHeaderSearchValue: (key: string, value: BaseTableHeaderSearchValue, shouldReload?: boolean | undefined) => Promise<void>;
     resetHeaderSearch: (key?: string | undefined) => Promise<void>;
-    getHeaderSearchValues: () => Record<string, string>;
+    getHeaderSearchValues: () => Record<string, BaseTableHeaderSearchValue>;
     clearSelection: () => void;
     toggleRowSelection: (row: Record<string, any>, selected?: boolean | undefined) => void;
     getSelectionRows: () => Record<string, any>[];
@@ -100,13 +100,13 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     "onRequest-error"?: ((error: unknown) => any) | undefined;
 }>, {
     data: Record<string, any>[];
+    border: boolean;
     requestParams: Record<string, unknown>;
     autoLoad: boolean;
     reloadOnParamsChange: boolean;
     reloadOnSortChange: boolean;
     rowKey: string;
     height: BaseTableCssValue;
-    border: boolean;
     stripe: boolean;
     showToolbar: boolean;
     showPagination: boolean;

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

@@ -1,3 +1,3 @@
 import BaseTable from './BaseTable.vue';
 export default BaseTable;
-export type { BaseTableAction, BaseTableAlign, BaseTableCellPayload, BaseTableColumn, BaseTableColumnKind, BaseTableCssValue, BaseTableExpose, BaseTableLoadedPayload, BaseTableNormalizedResult, BaseTableOption, BaseTablePagination, BaseTableProps, BaseTableResultAdapter, BaseTableRequestHandler, BaseTableRequestParams, BaseTableRequestResult, BaseTableRowActionPayload, BaseTableSortOrder, BaseTableSortPayload } from './BaseTable.types';
+export type { BaseTableAction, BaseTableAlign, BaseTableCellPayload, BaseTableColumn, BaseTableColumnKind, BaseTableCssValue, BaseTableExpose, BaseTableHeaderSearchConfig, BaseTableHeaderSearchPathValue, BaseTableHeaderSearchPrimitiveValue, BaseTableHeaderSearchType, BaseTableHeaderSearchValue, BaseTableLoadedPayload, BaseTableNormalizedResult, BaseTableOption, BaseTablePagination, BaseTableProps, BaseTableResultAdapter, BaseTableRequestHandler, BaseTableRequestParams, BaseTableRequestResult, BaseTableRowActionPayload, BaseTableSortOrder, BaseTableSortPayload } from './BaseTable.types';

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

@@ -91,8 +91,8 @@ declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<im
     disabled: boolean;
     value: OutlinedTreeSelectValue;
     errorMessage: string;
-    defaultExpandAll: boolean;
     required: boolean;
+    defaultExpandAll: boolean;
     popperClass: string;
     placeholder: string;
     clearable: boolean;

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

@@ -0,0 +1,6 @@
+export interface SvgIconProps {
+    iconClass: string;
+    className?: string;
+    prefix?: string;
+    ariaLabel?: string;
+}

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

@@ -0,0 +1,32 @@
+import type { SvgIconProps } from './SvgIcon.types';
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<SvgIconProps>, {
+    className: string;
+    prefix: string;
+    ariaLabel: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<SvgIconProps>, {
+    className: string;
+    prefix: string;
+    ariaLabel: string;
+}>>> & Readonly<{}>, {
+    className: string;
+    prefix: string;
+    ariaLabel: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;
+type __VLS_NonUndefinedable<T> = T extends undefined ? never : T;
+type __VLS_TypePropsToRuntimeProps<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? {
+        type: import('vue').PropType<__VLS_NonUndefinedable<T[K]>>;
+    } : {
+        type: import('vue').PropType<T[K]>;
+        required: true;
+    };
+};
+type __VLS_WithDefaults<P, D> = {
+    [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_Prettify<P[K] & {
+        default: D[K];
+    }> : P[K];
+};
+type __VLS_Prettify<T> = {
+    [K in keyof T]: T[K];
+} & {};

package/dist/components/SvgIcon/index.d.ts

@@ -0,0 +1,3 @@
+import SvgIcon from './SvgIcon.vue';
+export default SvgIcon;
+export type { SvgIconProps } from './SvgIcon.types';