@hbdlzy/ui-core 0.1.4 → 0.1.6

package/README.md

@@ -17,6 +17,7 @@
 - `OutlinedTreeSelect`
 - `echarts`
 - `exportExcel`
+- 全局按钮 ripple：导入包入口后自动启用，覆盖原生 `button`、Element Plus `el-button` 以及 radio/checkbox button 形态
 
 ## 使用方式
 
@@ -33,11 +34,15 @@ import {
   OutlinedTimePicker,
   OutlinedCascader,
   OutlinedTreeSelect,
+  installRipple,
+  uninstallRipple,
   echarts,
   exportExcel
 } from '@hbdlzy/ui-core'
 ```
 
+全局 ripple 会在导入 `@hbdlzy/ui-core` 时自动安装；如某个按钮不需要水波纹，可在按钮或父级元素上添加 `data-hbdl-ripple="false"`。
+
 ## 详细文档
 
 - `BaseTable`: [src/components/BaseTable/README.md](./src/components/BaseTable/README.md)
@@ -70,6 +75,8 @@ import {
 - 工具
   - `echarts`
   - `exportExcel`
+  - `installRipple`
+  - `uninstallRipple`
 
 ## 设计原则
 

package/components.manifest.json

@@ -1,7 +1,7 @@
 {
   "package": "@hbdlzy/ui-core",
   "version": 1,
-  "updatedAt": "2026-04-28",
+  "updatedAt": "2026-04-21",
   "components": [
     {
       "name": "BaseTable",
@@ -60,40 +60,6 @@
       ],
       "emits": ["export"]
     },
-    {
-      "name": "BaseSearchForm",
-      "category": "ui-core",
-      "entry": "@hbdlzy/ui-core",
-      "importName": "BaseSearchForm",
-      "docs": "packages/ui-core/src/components/BaseSearchForm/README.md",
-      "description": "统一封装列表页查询表单，支持输入框、下拉框、日期、日期范围、插槽字段、查询重置和展开收起。",
-      "props": [
-        { "name": "modelValue", "type": "Record<string, unknown>", "required": false },
-        { "name": "fields", "type": "BaseSearchFormField[]", "required": true },
-        { "name": "collapsed", "type": "boolean", "default": true },
-        { "name": "showCollapse", "type": "boolean", "default": true },
-        { "name": "columns", "type": "number", "default": 4 },
-        { "name": "labelWidth", "type": "string | number", "default": 80 }
-      ],
-      "emits": ["update:modelValue", "search", "reset", "field-change"]
-    },
-    {
-      "name": "BaseDialog",
-      "category": "ui-core",
-      "entry": "@hbdlzy/ui-core",
-      "importName": "BaseDialog",
-      "docs": "packages/ui-core/src/components/BaseDialog/README.md",
-      "description": "统一封装新增、编辑、确认类弹窗，支持默认页脚、异步确认、确认 loading 和自定义头尾插槽。",
-      "props": [
-        { "name": "modelValue", "type": "boolean", "default": false },
-        { "name": "title", "type": "string", "default": "" },
-        { "name": "width", "type": "string | number", "default": "560px" },
-        { "name": "showFooter", "type": "boolean", "default": true },
-        { "name": "confirmLoading", "type": "boolean", "default": false },
-        { "name": "beforeConfirm", "type": "() => boolean | void | Promise<boolean | void>", "required": false }
-      ],
-      "emits": ["update:modelValue", "open", "opened", "close", "closed", "cancel", "confirm"]
-    },
     {
       "name": "BaseEChart",
       "category": "ui-core",
@@ -139,6 +105,9 @@
         { "name": "value", "type": "string | number", "required": false },
         { "name": "placeholder", "type": "string", "default": "" },
         { "name": "label", "type": "string", "default": "" },
+        { "name": "required", "type": "boolean", "default": false },
+        { "name": "error", "type": "boolean", "default": false },
+        { "name": "errorMessage", "type": "string", "default": "" },
         { "name": "typeInput", "type": "string", "default": "text" },
         { "name": "isNumber", "type": "boolean", "default": false },
         { "name": "regex", "type": "RegExp", "required": false },
@@ -162,6 +131,9 @@
         { "name": "options", "type": "OutlinedSelectOption[]", "required": false },
         { "name": "placeholder", "type": "string", "default": "" },
         { "name": "label", "type": "string", "default": "" },
+        { "name": "required", "type": "boolean", "default": false },
+        { "name": "error", "type": "boolean", "default": false },
+        { "name": "errorMessage", "type": "string", "default": "" },
         { "name": "multiple", "type": "boolean", "default": false },
         { "name": "filterable", "type": "boolean", "default": true },
         { "name": "clearable", "type": "boolean", "default": true },
@@ -184,6 +156,9 @@
         { "name": "value", "type": "string | number | Date | Array<string | number | Date>", "required": false },
         { "name": "placeholder", "type": "string", "default": "" },
         { "name": "label", "type": "string", "default": "" },
+        { "name": "required", "type": "boolean", "default": false },
+        { "name": "error", "type": "boolean", "default": false },
+        { "name": "errorMessage", "type": "string", "default": "" },
         { "name": "typeDate", "type": "string", "default": "date" },
         { "name": "format", "type": "string", "default": "YYYY-MM-DD" },
         { "name": "valueFormat", "type": "string", "required": false },
@@ -205,6 +180,9 @@
         { "name": "value", "type": "string", "required": false },
         { "name": "placeholder", "type": "string", "default": "" },
         { "name": "label", "type": "string", "default": "" },
+        { "name": "required", "type": "boolean", "default": false },
+        { "name": "error", "type": "boolean", "default": false },
+        { "name": "errorMessage", "type": "string", "default": "" },
         { "name": "inputHeight", "type": "number", "default": 40 },
         { "name": "isBorder", "type": "boolean", "default": false },
         { "name": "disabledDate", "type": "string | number | Date | ((date: Date) => boolean)", "required": false },
@@ -225,6 +203,9 @@
         { "name": "value", "type": "string | number | Date | Array<string | number | Date> | null", "required": false },
         { "name": "placeholder", "type": "string", "default": "" },
         { "name": "label", "type": "string", "default": "" },
+        { "name": "required", "type": "boolean", "default": false },
+        { "name": "error", "type": "boolean", "default": false },
+        { "name": "errorMessage", "type": "string", "default": "" },
         { "name": "disabled", "type": "boolean", "default": false },
         { "name": "clearable", "type": "boolean", "default": true },
         { "name": "isRange", "type": "boolean", "default": false },
@@ -253,6 +234,9 @@
         { "name": "propsValue", "type": "Record<string, unknown>", "required": false },
         { "name": "placeholder", "type": "string", "default": "" },
         { "name": "label", "type": "string", "default": "" },
+        { "name": "required", "type": "boolean", "default": false },
+        { "name": "error", "type": "boolean", "default": false },
+        { "name": "errorMessage", "type": "string", "default": "" },
         { "name": "popperClass", "type": "string", "default": "" },
         { "name": "disabled", "type": "boolean", "default": false },
         { "name": "inputHeight", "type": "number", "default": 40 },
@@ -275,6 +259,9 @@
         { "name": "propsValue", "type": "Record<string, unknown>", "required": false },
         { "name": "placeholder", "type": "string", "default": "" },
         { "name": "label", "type": "string", "default": "" },
+        { "name": "required", "type": "boolean", "default": false },
+        { "name": "error", "type": "boolean", "default": false },
+        { "name": "errorMessage", "type": "string", "default": "" },
         { "name": "disabled", "type": "boolean", "default": false },
         { "name": "clearable", "type": "boolean", "default": true },
         { "name": "filterable", "type": "boolean", "default": true },
@@ -299,6 +286,16 @@
       "name": "exportExcel",
       "entry": "@hbdlzy/ui-core",
       "description": "支持多级表头和自动列宽的纯前端 Excel 导出工具。"
+    },
+    {
+      "name": "installRipple",
+      "entry": "@hbdlzy/ui-core",
+      "description": "安装全局按钮 ripple 效果；包入口会自动调用，可用于手动恢复。"
+    },
+    {
+      "name": "uninstallRipple",
+      "entry": "@hbdlzy/ui-core",
+      "description": "卸载全局按钮 ripple 事件监听。"
     }
   ]
 }

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

@@ -1,36 +1,36 @@
-export type BaseCardCssValue = string | number;
-export interface BaseCardDefaultExportPayload {
-    title?: string;
-    metaText?: string;
-}
-export interface BaseCardProps {
-    title?: string;
-    metaText?: string;
-    showHeader?: boolean;
-    showRight?: boolean;
-    showTitleMarker?: boolean;
-    showExport?: boolean;
-    exportText?: string;
-    exportDisabled?: boolean;
-    exportPayload?: unknown;
-    padding?: BaseCardCssValue;
-    radius?: BaseCardCssValue;
-    borderColor?: string;
-    backgroundColor?: string;
-    shadowColor?: string;
-    headerGap?: BaseCardCssValue;
-    headerMarginBottom?: BaseCardCssValue;
-    leftGap?: BaseCardCssValue;
-    rightGap?: BaseCardCssValue;
-    titleColor?: string;
-    titleSize?: BaseCardCssValue;
-    titleWeight?: string | number;
-    markerColor?: string;
-    markerWidth?: BaseCardCssValue;
-    markerHeight?: BaseCardCssValue;
-    markerRadius?: BaseCardCssValue;
-    markerGap?: BaseCardCssValue;
-    metaColor?: string;
-    metaSize?: BaseCardCssValue;
-    exportColor?: string;
-}
+export type BaseCardCssValue = string | number;
+export interface BaseCardDefaultExportPayload {
+    title?: string;
+    metaText?: string;
+}
+export interface BaseCardProps {
+    title?: string;
+    metaText?: string;
+    showHeader?: boolean;
+    showRight?: boolean;
+    showTitleMarker?: boolean;
+    showExport?: boolean;
+    exportText?: string;
+    exportDisabled?: boolean;
+    exportPayload?: unknown;
+    padding?: BaseCardCssValue;
+    radius?: BaseCardCssValue;
+    borderColor?: string;
+    backgroundColor?: string;
+    shadowColor?: string;
+    headerGap?: BaseCardCssValue;
+    headerMarginBottom?: BaseCardCssValue;
+    leftGap?: BaseCardCssValue;
+    rightGap?: BaseCardCssValue;
+    titleColor?: string;
+    titleSize?: BaseCardCssValue;
+    titleWeight?: string | number;
+    markerColor?: string;
+    markerWidth?: BaseCardCssValue;
+    markerHeight?: BaseCardCssValue;
+    markerRadius?: BaseCardCssValue;
+    markerGap?: BaseCardCssValue;
+    metaColor?: string;
+    metaSize?: BaseCardCssValue;
+    exportColor?: string;
+}

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

@@ -1,122 +1,122 @@
-import type { BaseCardCssValue, BaseCardProps } from './BaseCard.types';
-declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BaseCardProps>, {
-    title: string;
-    metaText: string;
-    showHeader: boolean;
-    showRight: boolean;
-    showTitleMarker: boolean;
-    showExport: boolean;
-    exportText: string;
-    exportDisabled: boolean;
-    padding: number;
-    radius: number;
-    borderColor: string;
-    backgroundColor: string;
-    shadowColor: string;
-    headerGap: number;
-    headerMarginBottom: number;
-    leftGap: number;
-    rightGap: number;
-    titleColor: string;
-    titleSize: number;
-    titleWeight: number;
-    markerColor: string;
-    markerWidth: number;
-    markerHeight: number;
-    markerRadius: string;
-    markerGap: number;
-    metaColor: string;
-    metaSize: number;
-    exportColor: string;
-}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    export: (payload?: unknown) => void;
-}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BaseCardProps>, {
-    title: string;
-    metaText: string;
-    showHeader: boolean;
-    showRight: boolean;
-    showTitleMarker: boolean;
-    showExport: boolean;
-    exportText: string;
-    exportDisabled: boolean;
-    padding: number;
-    radius: number;
-    borderColor: string;
-    backgroundColor: string;
-    shadowColor: string;
-    headerGap: number;
-    headerMarginBottom: number;
-    leftGap: number;
-    rightGap: number;
-    titleColor: string;
-    titleSize: number;
-    titleWeight: number;
-    markerColor: string;
-    markerWidth: number;
-    markerHeight: number;
-    markerRadius: string;
-    markerGap: number;
-    metaColor: string;
-    metaSize: number;
-    exportColor: string;
-}>>> & Readonly<{
-    onExport?: ((payload?: unknown) => any) | undefined;
-}>, {
-    title: string;
-    metaText: string;
-    showHeader: boolean;
-    showRight: boolean;
-    showTitleMarker: boolean;
-    showExport: boolean;
-    exportText: string;
-    exportDisabled: boolean;
-    padding: BaseCardCssValue;
-    radius: BaseCardCssValue;
-    borderColor: string;
-    backgroundColor: string;
-    shadowColor: string;
-    headerGap: BaseCardCssValue;
-    headerMarginBottom: BaseCardCssValue;
-    leftGap: BaseCardCssValue;
-    rightGap: BaseCardCssValue;
-    titleColor: string;
-    titleSize: BaseCardCssValue;
-    titleWeight: string | number;
-    markerColor: string;
-    markerWidth: BaseCardCssValue;
-    markerHeight: BaseCardCssValue;
-    markerRadius: BaseCardCssValue;
-    markerGap: BaseCardCssValue;
-    metaColor: string;
-    metaSize: BaseCardCssValue;
-    exportColor: string;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
-    "title-label"?(_: {}): any;
-    title?(_: {}): any;
-    "header-right"?(_: {}): any;
-    tip?(_: {}): any;
-    default?(_: {}): 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];
-} & {};
-type __VLS_WithTemplateSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
+import type { BaseCardCssValue, BaseCardProps } from './BaseCard.types';
+declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BaseCardProps>, {
+    title: string;
+    metaText: string;
+    showHeader: boolean;
+    showRight: boolean;
+    showTitleMarker: boolean;
+    showExport: boolean;
+    exportText: string;
+    exportDisabled: boolean;
+    padding: number;
+    radius: number;
+    borderColor: string;
+    backgroundColor: string;
+    shadowColor: string;
+    headerGap: number;
+    headerMarginBottom: number;
+    leftGap: number;
+    rightGap: number;
+    titleColor: string;
+    titleSize: number;
+    titleWeight: number;
+    markerColor: string;
+    markerWidth: number;
+    markerHeight: number;
+    markerRadius: string;
+    markerGap: number;
+    metaColor: string;
+    metaSize: number;
+    exportColor: string;
+}>>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    export: (payload?: unknown) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BaseCardProps>, {
+    title: string;
+    metaText: string;
+    showHeader: boolean;
+    showRight: boolean;
+    showTitleMarker: boolean;
+    showExport: boolean;
+    exportText: string;
+    exportDisabled: boolean;
+    padding: number;
+    radius: number;
+    borderColor: string;
+    backgroundColor: string;
+    shadowColor: string;
+    headerGap: number;
+    headerMarginBottom: number;
+    leftGap: number;
+    rightGap: number;
+    titleColor: string;
+    titleSize: number;
+    titleWeight: number;
+    markerColor: string;
+    markerWidth: number;
+    markerHeight: number;
+    markerRadius: string;
+    markerGap: number;
+    metaColor: string;
+    metaSize: number;
+    exportColor: string;
+}>>> & Readonly<{
+    onExport?: ((payload?: unknown) => any) | undefined;
+}>, {
+    title: string;
+    metaText: string;
+    showHeader: boolean;
+    showRight: boolean;
+    showTitleMarker: boolean;
+    showExport: boolean;
+    exportText: string;
+    exportDisabled: boolean;
+    padding: BaseCardCssValue;
+    radius: BaseCardCssValue;
+    borderColor: string;
+    backgroundColor: string;
+    shadowColor: string;
+    headerGap: BaseCardCssValue;
+    headerMarginBottom: BaseCardCssValue;
+    leftGap: BaseCardCssValue;
+    rightGap: BaseCardCssValue;
+    titleColor: string;
+    titleSize: BaseCardCssValue;
+    titleWeight: string | number;
+    markerColor: string;
+    markerWidth: BaseCardCssValue;
+    markerHeight: BaseCardCssValue;
+    markerRadius: BaseCardCssValue;
+    markerGap: BaseCardCssValue;
+    metaColor: string;
+    metaSize: BaseCardCssValue;
+    exportColor: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
+    "title-label"?(_: {}): any;
+    title?(_: {}): any;
+    "header-right"?(_: {}): any;
+    tip?(_: {}): any;
+    default?(_: {}): 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];
+} & {};
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

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

@@ -1,3 +1,3 @@
-import BaseCard from './BaseCard.vue';
-export default BaseCard;
-export type { BaseCardCssValue, BaseCardDefaultExportPayload, BaseCardProps } from './BaseCard.types';
+import BaseCard from './BaseCard.vue';
+export default BaseCard;
+export type { BaseCardCssValue, BaseCardDefaultExportPayload, BaseCardProps } from './BaseCard.types';

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

@@ -1,26 +1,26 @@
-import type { EChartInitOptions, EChartInstance, EChartLoadingOptions, EChartOption, EChartResizeOptions, EChartSetOptionOptions } from '../../echarts';
-export interface BaseEChartProps {
-    option?: EChartOption;
-    theme?: string | Record<string, unknown>;
-    initOptions?: EChartInitOptions;
-    setOptionOptions?: boolean | EChartSetOptionOptions;
-    loading?: boolean;
-    loadingOptions?: EChartLoadingOptions;
-    autoResize?: boolean;
-    useDefaultColors?: boolean;
-    colorStorageKey?: string;
-    defaultColors?: string[];
-    group?: string;
-}
-export interface BaseEChartExpose {
-    getInstance: () => EChartInstance | null;
-    setOption: (option: EChartOption, setOptionOptions?: boolean | EChartSetOptionOptions) => EChartInstance | null;
-    resize: (resizeOptions?: EChartResizeOptions) => void;
-    dispatchAction: (payload: Record<string, unknown>) => void;
-    showLoading: (type?: string, loadingOptions?: EChartLoadingOptions) => void;
-    hideLoading: () => void;
-    clear: () => void;
-    dispose: () => void;
-    on: (eventName: string, handler: (...args: any[]) => void, context?: unknown) => void;
-    off: (eventName?: string, handler?: (...args: any[]) => void) => void;
-}
+import type { EChartInitOptions, EChartInstance, EChartLoadingOptions, EChartOption, EChartResizeOptions, EChartSetOptionOptions } from '../../echarts';
+export interface BaseEChartProps {
+    option?: EChartOption;
+    theme?: string | Record<string, unknown>;
+    initOptions?: EChartInitOptions;
+    setOptionOptions?: boolean | EChartSetOptionOptions;
+    loading?: boolean;
+    loadingOptions?: EChartLoadingOptions;
+    autoResize?: boolean;
+    useDefaultColors?: boolean;
+    colorStorageKey?: string;
+    defaultColors?: string[];
+    group?: string;
+}
+export interface BaseEChartExpose {
+    getInstance: () => EChartInstance | null;
+    setOption: (option: EChartOption, setOptionOptions?: boolean | EChartSetOptionOptions) => EChartInstance | null;
+    resize: (resizeOptions?: EChartResizeOptions) => void;
+    dispatchAction: (payload: Record<string, unknown>) => void;
+    showLoading: (type?: string, loadingOptions?: EChartLoadingOptions) => void;
+    hideLoading: () => void;
+    clear: () => void;
+    dispose: () => void;
+    on: (eventName: string, handler: (...args: any[]) => void, context?: unknown) => void;
+    off: (eventName?: string, handler?: (...args: any[]) => void) => void;
+}