@hbdlzy/ui-core 0.1.2 → 0.1.3

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

@@ -0,0 +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;
+    };
+};

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

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

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

@@ -0,0 +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;
+}

package/src/components/BaseEChart/BaseEChart.vue.d.ts

@@ -0,0 +1,66 @@
+import { echarts } from '../../echarts';
+import type { BaseEChartProps } from './BaseEChart.types';
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BaseEChartProps>, {
+    option: () => {};
+    initOptions: () => echarts.EChartsInitOpts;
+    setOptionOptions: () => echarts.SetOptionOpts;
+    loading: boolean;
+    autoResize: boolean;
+    useDefaultColors: boolean;
+    colorStorageKey: string;
+    defaultColors: () => never[];
+    group: undefined;
+}>>, {
+    getInstance: () => echarts.ECharts | null;
+    setOption: (option: echarts.EChartsOption, setOptionOptions?: boolean | echarts.SetOptionOpts | undefined) => echarts.ECharts | null;
+    resize: (resizeOptions?: echarts.ResizeOpts | undefined) => void;
+    dispatchAction: (payload: Record<string, unknown>) => void;
+    showLoading: (type?: string | undefined, loadingOptions?: object | undefined) => void;
+    hideLoading: () => void;
+    clear: () => void;
+    dispose: () => void;
+    on: (eventName: string, handler: (...args: any[]) => void, context?: unknown) => void;
+    off: (eventName?: string | undefined, handler?: ((...args: any[]) => void) | undefined) => void;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    ready: (chart: echarts.ECharts) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToRuntimeProps<BaseEChartProps>, {
+    option: () => {};
+    initOptions: () => echarts.EChartsInitOpts;
+    setOptionOptions: () => echarts.SetOptionOpts;
+    loading: boolean;
+    autoResize: boolean;
+    useDefaultColors: boolean;
+    colorStorageKey: string;
+    defaultColors: () => never[];
+    group: undefined;
+}>>> & Readonly<{
+    onReady?: ((chart: echarts.ECharts) => any) | undefined;
+}>, {
+    option: echarts.EChartsOption;
+    loading: boolean;
+    initOptions: echarts.EChartsInitOpts;
+    setOptionOptions: boolean | echarts.SetOptionOpts;
+    autoResize: boolean;
+    useDefaultColors: boolean;
+    colorStorageKey: string;
+    defaultColors: string[];
+    group: 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/src/components/BaseEChart/index.d.ts

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

package/src/components/BaseExportButton/BaseExportButton.types.d.ts

@@ -0,0 +1,21 @@
+import type { ExcelExportOptions } from '../../excel/exportExcel';
+export interface ExportResponseHeaders {
+    [key: string]: string | undefined;
+}
+export interface ExportResponseLike {
+    data: Blob | BlobPart | ArrayBuffer;
+    headers?: ExportResponseHeaders;
+}
+export type ExportRequestHandler = () => Promise<ExportResponseLike>;
+export type ExportMode = 'excel' | 'request' | 'none' | 'invalid';
+export type ExportBeforeHandler = () => boolean | void | Promise<boolean | void>;
+export interface ExportSuccessPayload {
+    mode: Exclude<ExportMode, 'none' | 'invalid'>;
+    fileName?: string;
+}
+export interface BaseExportExcelConfig<Row = Record<string, any>> {
+    excelOptions: ExcelExportOptions<Row>;
+}
+export interface BaseExportRequestConfig {
+    requestHandler: ExportRequestHandler;
+}

package/src/components/BaseExportButton/BaseExportButton.utils.d.ts

@@ -0,0 +1,4 @@
+import type { ExportResponseLike } from './BaseExportButton.types';
+export declare function extractFileNameFromDisposition(contentDisposition?: string): string;
+export declare function normalizeExportFileName(fileName?: string): string;
+export declare function downloadExportResponse(response: ExportResponseLike, fallbackFileName?: string): string;

package/src/components/BaseExportButton/BaseExportButton.vue.d.ts

@@ -0,0 +1,128 @@
+import type { PropType } from 'vue';
+import { type ExcelExportOptions } from '../../excel/exportExcel';
+import type { ExportBeforeHandler, ExportRequestHandler, ExportSuccessPayload } from './BaseExportButton.types';
+declare const _default: __VLS_WithTemplateSlots<import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    label: {
+        type: StringConstructor;
+        default: string;
+    };
+    type: {
+        type: PropType<"" | "success" | "warning" | "info" | "danger" | "primary">;
+        default: string;
+    };
+    size: {
+        type: PropType<"default" | "small" | "large">;
+        default: string;
+    };
+    plain: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    link: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    text: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    fileName: {
+        type: StringConstructor;
+        default: string;
+    };
+    excelOptions: PropType<ExcelExportOptions<Record<string, any>>>;
+    requestHandler: PropType<ExportRequestHandler>;
+    beforeExport: PropType<ExportBeforeHandler>;
+    successMessage: {
+        type: StringConstructor;
+        default: string;
+    };
+    errorMessage: {
+        type: StringConstructor;
+        default: string;
+    };
+    autoMessage: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    start: () => void;
+    success: (payload: ExportSuccessPayload) => void;
+    error: (error: unknown) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    label: {
+        type: StringConstructor;
+        default: string;
+    };
+    type: {
+        type: PropType<"" | "success" | "warning" | "info" | "danger" | "primary">;
+        default: string;
+    };
+    size: {
+        type: PropType<"default" | "small" | "large">;
+        default: string;
+    };
+    plain: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    link: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    text: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    fileName: {
+        type: StringConstructor;
+        default: string;
+    };
+    excelOptions: PropType<ExcelExportOptions<Record<string, any>>>;
+    requestHandler: PropType<ExportRequestHandler>;
+    beforeExport: PropType<ExportBeforeHandler>;
+    successMessage: {
+        type: StringConstructor;
+        default: string;
+    };
+    errorMessage: {
+        type: StringConstructor;
+        default: string;
+    };
+    autoMessage: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{
+    onError?: ((error: unknown) => any) | undefined;
+    onSuccess?: ((payload: ExportSuccessPayload) => any) | undefined;
+    onStart?: (() => any) | undefined;
+}>, {
+    type: "" | "success" | "warning" | "info" | "danger" | "primary";
+    label: string;
+    link: boolean;
+    text: boolean;
+    disabled: boolean;
+    size: "default" | "small" | "large";
+    fileName: string;
+    plain: boolean;
+    successMessage: string;
+    errorMessage: string;
+    autoMessage: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>, {
+    default?(_: {}): any;
+}>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/src/components/BaseExportButton/index.d.ts

@@ -0,0 +1,5 @@
+import BaseExportButton from './BaseExportButton.vue';
+export { BaseExportButton };
+export { downloadExportResponse, extractFileNameFromDisposition, normalizeExportFileName } from './BaseExportButton.utils';
+export type { BaseExportExcelConfig, BaseExportRequestConfig, ExportBeforeHandler, ExportMode, ExportRequestHandler, ExportResponseHeaders, ExportResponseLike, ExportSuccessPayload } from './BaseExportButton.types';
+export default BaseExportButton;

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

@@ -0,0 +1,163 @@
+export type BaseTableCssValue = string | number;
+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 interface BaseTableHeaderSearchConfig {
+    paramKey?: string;
+    placeholder?: string;
+    width?: BaseTableCssValue;
+    searchText?: string;
+    resetText?: string;
+}
+export interface BaseTableOption {
+    label: string;
+    value: string | number | boolean;
+    tagType?: '' | 'success' | 'warning' | 'info' | 'danger' | 'primary';
+    color?: string;
+}
+export interface BaseTableAction<Row = Record<string, any>> {
+    label: string;
+    type: string;
+    buttonType?: '' | 'primary' | 'success' | 'warning' | 'info' | 'danger';
+    disabled?: boolean | ((row: Row) => boolean);
+    visible?: boolean | ((row: Row) => boolean);
+}
+export interface BaseTableColumn<Row = Record<string, any>> {
+    label: string;
+    prop?: keyof Row | string;
+    kind?: BaseTableColumnKind;
+    type?: string;
+    width?: BaseTableCssValue;
+    minWidth?: BaseTableCssValue;
+    align?: BaseTableAlign;
+    headerAlign?: BaseTableAlign;
+    fixed?: boolean | 'left' | 'right';
+    sortable?: boolean | 'custom';
+    sortField?: string;
+    headerSearch?: boolean | BaseTableHeaderSearchConfig;
+    showOverflowTooltip?: boolean;
+    className?: string;
+    headerClassName?: string;
+    actions?: BaseTableAction<Row>[];
+    clickable?: boolean;
+    options?: BaseTableOption[];
+    optionValueKey?: string;
+    optionLabelKey?: string;
+    optionTagTypeKey?: string;
+    emptyText?: string;
+    inputType?: string;
+    imageFit?: '' | 'fill' | 'contain' | 'cover' | 'none' | 'scale-down';
+    imageWidth?: BaseTableCssValue;
+    imageHeight?: BaseTableCssValue;
+    slotName?: string;
+    headerSlotName?: string;
+    formatter?: (row: Row, column: BaseTableColumn<Row>) => unknown;
+    html?: (row: Row, column: BaseTableColumn<Row>) => string;
+    clickHandler?: (row: Row, column: BaseTableColumn<Row>) => void;
+    inputHandler?: (value: string, row: Row, column: BaseTableColumn<Row>) => void;
+}
+export interface BaseTablePagination {
+    currentPage: number;
+    pageSize: number;
+    total: number;
+    pageSizes: number[];
+}
+export interface BaseTableRequestParams {
+    currentPage: number;
+    pageSize: number;
+    [key: string]: unknown;
+}
+export interface BaseTableSortState {
+    prop?: string;
+    order: BaseTableSortOrder;
+}
+export interface BaseTableSortOrderMap {
+    ascending: string;
+    descending: string;
+}
+export interface BaseTableRequestResult<Row = Record<string, any>> {
+    records?: Row[];
+    list?: Row[];
+    items?: Row[];
+    total?: number;
+    data?: {
+        records?: Row[];
+        list?: Row[];
+        items?: Row[];
+        total?: number;
+    };
+}
+export interface BaseTableNormalizedResult<Row = Record<string, any>> {
+    rows?: Row[];
+    total?: number;
+}
+export type BaseTableRequestHandler<Row = Record<string, any>> = (params: BaseTableRequestParams) => Promise<BaseTableRequestResult<Row> | Row[]>;
+export type BaseTableResultAdapter<Row = Record<string, any>> = (result: unknown, params: BaseTableRequestParams) => BaseTableNormalizedResult<Row>;
+export interface BaseTableProps<Row = Record<string, any>> {
+    columns: BaseTableColumn<Row>[];
+    data?: Row[];
+    request?: BaseTableRequestHandler<Row>;
+    requestParams?: Record<string, unknown>;
+    resultAdapter?: BaseTableResultAdapter<Row>;
+    autoLoad?: boolean;
+    reloadOnParamsChange?: boolean;
+    reloadOnSortChange?: boolean;
+    rowKey?: string;
+    height?: BaseTableCssValue;
+    border?: boolean;
+    stripe?: boolean;
+    showToolbar?: boolean;
+    showPagination?: boolean;
+    hasSelection?: boolean;
+    hasIndex?: boolean;
+    indexLabel?: string;
+    indexWidth?: BaseTableCssValue;
+    selectionWidth?: BaseTableCssValue;
+    rowSelectable?: (row: Row, index: number) => boolean;
+    pagination?: Partial<BaseTablePagination>;
+    currentPageKey?: string;
+    pageSizeKey?: string;
+    defaultSort?: BaseTableSortState;
+    sortFieldKey?: string;
+    sortOrderKey?: string;
+    sortOrderMap?: BaseTableSortOrderMap;
+    sortMapper?: (payload: BaseTableSortPayload<Row>) => Record<string, unknown> | void;
+    emptyText?: string;
+    loadingText?: string;
+}
+export interface BaseTableSortPayload<Row = Record<string, any>> {
+    column: BaseTableColumn<Row> | undefined;
+    prop?: string;
+    order: BaseTableSortOrder;
+    field?: string;
+    direction: BaseTableSortDirection;
+}
+export interface BaseTableRowActionPayload<Row = Record<string, any>> {
+    row: Row;
+    action: BaseTableAction<Row>;
+    column: BaseTableColumn<Row>;
+}
+export interface BaseTableCellPayload<Row = Record<string, any>> {
+    row: Row;
+    column: BaseTableColumn<Row>;
+    value: unknown;
+}
+export interface BaseTableLoadedPayload<Row = Record<string, any>> {
+    rows: Row[];
+    total: number;
+    params: BaseTableRequestParams;
+}
+export interface BaseTableExpose<Row = Record<string, any>> {
+    load: (data?: Row[]) => Promise<void>;
+    refresh: () => Promise<void>;
+    setData: (data: Row[]) => void;
+    resetPage: () => Promise<void>;
+    setHeaderSearchValue: (key: string, value: string, shouldReload?: boolean) => Promise<void>;
+    resetHeaderSearch: (key?: string) => Promise<void>;
+    getHeaderSearchValues: () => Record<string, string>;
+    clearSelection: () => void;
+    toggleRowSelection: (row: Row, selected?: boolean) => void;
+    getSelectionRows: () => Row[];
+    getRows: () => Row[];
+}

package/src/components/BaseTable/BaseTable.types.ts

@@ -4,6 +4,14 @@ export type BaseTableColumnKind = 'text' | 'link' | 'actions' | 'image' | 'tag'
 export type BaseTableSortOrder = 'ascending' | 'descending' | null
 export type BaseTableSortDirection = string | null
 
+export interface BaseTableHeaderSearchConfig {
+  paramKey?: string
+  placeholder?: string
+  width?: BaseTableCssValue
+  searchText?: string
+  resetText?: string
+}
+
 export interface BaseTableOption {
   label: string
   value: string | number | boolean
@@ -31,6 +39,7 @@ export interface BaseTableColumn<Row = Record<string, any>> {
   fixed?: boolean | 'left' | 'right'
   sortable?: boolean | 'custom'
   sortField?: string
+  headerSearch?: boolean | BaseTableHeaderSearchConfig
   showOverflowTooltip?: boolean
   className?: string
   headerClassName?: string
@@ -167,6 +176,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>
+  resetHeaderSearch: (key?: string) => Promise<void>
+  getHeaderSearchValues: () => Record<string, string>
   clearSelection: () => void
   toggleRowSelection: (row: Row, selected?: boolean) => void
   getSelectionRows: () => Row[]