easy-ep-ui 0.1.0 → 0.1.2

package/lib/components/ee-form-table/src/components/TableToolbar.vue.d.ts

@@ -0,0 +1,43 @@
+import { ToolbarConfig } from '../../types';
+type __VLS_Props = {
+    show: boolean;
+    toolbarCfg: ToolbarConfig;
+    size?: 'large' | 'default' | 'small';
+    refreshing?: boolean;
+    deps: {
+        authPass: (auth?: string) => boolean;
+        selectionCount: number;
+        showColumnSetting: boolean;
+    };
+};
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        'toolbar-right'?(_: {}): any;
+    };
+    refs: {};
+    rootEl: any;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    add: () => any;
+    "batch-delete": () => any;
+    import: () => any;
+    export: () => any;
+    refresh: () => any;
+    "column-setting": () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onAdd?: (() => any) | undefined;
+    "onBatch-delete"?: (() => any) | undefined;
+    onImport?: (() => any) | undefined;
+    onExport?: (() => any) | undefined;
+    onRefresh?: (() => any) | undefined;
+    "onColumn-setting"?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/lib/components/ee-form-table/src/constants.d.ts

@@ -0,0 +1,31 @@
+import { SearchConfig, PaginationConfig, ActionConfig, ToolbarConfig, DrawerConfig, TableColumn } from '../types';
+/** 默认行唯一标识字段名 */
+export declare const DEFAULT_ROW_KEY = "id";
+/** 默认空数据提示文字（兜底，locale 优先） */
+export declare const DEFAULT_EMPTY_TEXT = "";
+/** 每页条数选项 */
+export declare const DEFAULT_PAGE_SIZES: number[];
+/** 分页布局字符串 */
+export declare const DEFAULT_PAGINATION_LAYOUT = "total, sizes, prev, pager, next, jumper";
+/** 搜索区域默认配置 */
+export declare const DEFAULT_SEARCH_CONFIG: SearchConfig;
+/** 搜索区域隐藏时的空配置 */
+export declare const SEARCH_CONFIG_HIDDEN: SearchConfig;
+/** 分页默认配置 */
+export declare const DEFAULT_PAGINATION_CONFIG: PaginationConfig;
+/** 分页隐藏时的空配置 */
+export declare const PAGINATION_CONFIG_HIDDEN: PaginationConfig;
+/** 操作列默认配置 */
+export declare const DEFAULT_ACTION_CONFIG: ActionConfig;
+/** 操作列隐藏时的空配置 */
+export declare const ACTION_CONFIG_HIDDEN: ActionConfig;
+/** 工具栏默认配置 */
+export declare const DEFAULT_TOOLBAR_CONFIG: ToolbarConfig;
+/** 工具栏隐藏时的空配置 */
+export declare const TOOLBAR_CONFIG_HIDDEN: ToolbarConfig;
+/** 表单抽屉/弹窗默认配置 */
+export declare const DEFAULT_DRAWER_CONFIG: DrawerConfig;
+/** el-table 透传时需要跳过的属性名列表 */
+export declare const OMIT_TABLE_ATTRS: string[];
+/** el-table-column 透传时需要跳过的属性名列表 */
+export declare const OMIT_COLUMN_ATTRS: (keyof TableColumn)[];

package/lib/components/ee-form-table/src/hooks/useAuth.d.ts

@@ -0,0 +1,14 @@
+import { ComputedRef } from 'vue';
+/**
+ * @param props.authChecker - 外部传入的权限判断函数，接收 auth 标识返回 boolean
+ * @param props.authMode - 权限不足时的处理模式：hide 隐藏 / disabled 禁用
+ * @returns authPass - 判断指定 auth 是否有权限的函数
+ * @returns authEnabled - 是否启用了权限检查
+ */
+export declare function useAuth(props: {
+    authChecker?: (auth: string) => boolean;
+    authMode?: 'hide' | 'disabled';
+}): {
+    authPass: (auth?: string) => boolean;
+    authEnabled: ComputedRef<boolean>;
+};

package/lib/components/ee-form-table/src/hooks/useCrud.d.ts

@@ -0,0 +1,41 @@
+import { Ref, ComputedRef } from 'vue';
+import { CrudConfig } from '../../types';
+/**
+ * @param props.crudConfig - CRUD 接口配置（list/add/edit/delete/batchDelete）
+ * @param props.rowKey - 数据行唯一标识字段名，默认为 id
+ * @param deps.searchParams - 搜索参数字典（响应式对象）
+ * @param deps.getActiveSearchParams - 获取当前有效的搜索参数
+ * @param deps.pageState - 分页状态（current / pageSize / total）
+ * @param deps.resetPage - 重置到第一页的函数
+ * @param deps.setTotal - 设置总记录数的函数
+ * @param deps.selection - 选中的行数据列表（Ref）
+ * @param deps.emit - 对外触发事件的函数
+ * @param deps.t - 国际化翻译函数，接收 (section, key, args?) 返回本地化文字
+ */
+export declare function useCrud(props: {
+    crudConfig?: CrudConfig;
+    rowKey?: string;
+}, deps: {
+    searchParams: Record<string, unknown>;
+    getActiveSearchParams: () => Record<string, unknown>;
+    pageState: {
+        current: number;
+        pageSize: number;
+        total: number;
+    };
+    resetPage: () => void;
+    setTotal: (total: number) => void;
+    selection: Ref<Record<string, unknown>[]>;
+    emit: (event: string, ...args: unknown[]) => void;
+    t: (section: string, key: string, args?: Record<string, string | number>) => string;
+}): {
+    internalData: Ref<Record<string, unknown>[], Record<string, unknown>[]>;
+    loadingState: Ref<boolean, boolean>;
+    hasCrud: ComputedRef<boolean>;
+    fetchData: () => Promise<void>;
+    refreshTable: () => Promise<void>;
+    doDelete: (row: Record<string, unknown>) => Promise<void>;
+    handleDelete: (row: Record<string, unknown>, confirmDelete: boolean, confirmTitle?: string, confirmMessage?: string) => Promise<void>;
+    doBatchDelete: (ids: (string | number)[]) => Promise<void>;
+    handleBatchDelete: () => Promise<void>;
+};

package/lib/components/ee-form-table/src/hooks/useDict.d.ts

@@ -0,0 +1,12 @@
+import { DictOption } from '../../types';
+/**
+ * @param props.dictMap - 字典映射表，如 { statusDict: [{ value: 1, label: '启用' }, ...] }
+ * @returns resolvedDict - 合并内联 options 和字典映射的解析函数
+ * @returns dictLabel - 根据字段值和字典 key 获取显示文本
+ */
+export declare function useDict(props: {
+    dictMap?: Record<string, DictOption[]>;
+}): {
+    resolvedDict: (options?: DictOption[], dictKey?: string) => DictOption[];
+    dictLabel: (dictKey: string | undefined, value: unknown) => string;
+};

package/lib/components/ee-form-table/src/hooks/useExport.d.ts

@@ -0,0 +1,34 @@
+import { ComputedRef, Ref } from 'vue';
+import { ExportConfig, TableColumn } from '../../types';
+/**
+ * @param props.exportConfig - 导出配置（模式、文件名、忽略列等）
+ * @param props.columns - 原始列配置（用于字典映射）
+ * @param deps.visibleColumns - 当前可见列列表
+ * @param deps.getActiveSearchParams - 获取当前搜索参数
+ * @param deps.dictLabel - 字典值转文本函数
+ * @param deps.setLoading - 设置加载状态
+ * @param deps.getCurrentData - 获取当前数据列表的函数
+ * @param deps.t - 国际化翻译函数，接收 (section, key, args?) 返回本地化文字
+ */
+export declare function useExport(props: {
+    exportConfig?: ExportConfig;
+    columns: TableColumn[];
+    crudConfig?: {
+        api?: {
+            list?: Function;
+        };
+        baseParams?: Record<string, unknown>;
+    } | null;
+}, deps: {
+    visibleColumns: ComputedRef<TableColumn[]>;
+    getActiveSearchParams: () => Record<string, unknown>;
+    dictLabel: (dictKey: string | undefined, value: unknown) => string;
+    internalData: ComputedRef<Record<string, unknown>[]> | Ref<Record<string, unknown>[]> | Record<string, unknown>[];
+    fetchData: () => Promise<void>;
+    setLoading: (v: boolean) => void;
+    getCurrentData: () => Record<string, unknown>[];
+    t: (section: string, key: string, args?: Record<string, string | number>) => string;
+}): {
+    handleExport: () => Promise<void>;
+    exporting: Ref<boolean, boolean>;
+};

package/lib/components/ee-form-table/src/hooks/useForm.d.ts

@@ -0,0 +1,33 @@
+import { ref } from 'vue';
+import { DrawerConfig } from '../../types';
+/**
+ * @param props.drawerConfig - 抽屉/弹窗的外观配置
+ * @param props.rowKey - 数据行的唯一键（用于编辑时取 ID）
+ * @returns formVisible - 表单是否显示
+ * @returns formMode - 表单模式：add | edit | view
+ * @returns editingRow - 当前编辑的行数据（新增时为 null）
+ * @returns formData - 表单绑定的数据对象
+ * @returns saving - 是否正在保存（加载状态）
+ * @returns drawerMode - 展示模式：drawer / dialog
+ * @returns drawerCfg - 合并默认值后的配置
+ * @returns openAdd - 打开新增表单
+ * @returns openEdit - 打开编辑表单
+ * @returns openView - 打开查看表单
+ * @returns closeForm - 关闭表单
+ */
+export declare function useForm(props: {
+    drawerConfig?: DrawerConfig;
+    rowKey?: string;
+}): {
+    formVisible: ReturnType<typeof ref<boolean>>;
+    formMode: ReturnType<typeof ref<'add' | 'edit' | 'view'>>;
+    editingRow: ReturnType<typeof ref<Record<string, unknown> | null>>;
+    formData: ReturnType<typeof ref<Record<string, unknown>>>;
+    saving: ReturnType<typeof ref<boolean>>;
+    drawerMode: string;
+    drawerCfg: DrawerConfig;
+    openAdd: () => void;
+    openEdit: (row: Record<string, unknown>) => void;
+    openView: (row: Record<string, unknown>) => void;
+    closeForm: () => void;
+};

package/lib/components/ee-form-table/src/hooks/usePagination.d.ts

@@ -0,0 +1,22 @@
+import { ComputedRef } from 'vue';
+import { PaginationConfig } from '../../types';
+/**
+ * @param props.pagination - 分页配置（boolean 或 PaginationConfig 对象）
+ */
+export declare function usePagination(props: {
+    pagination?: PaginationConfig | boolean;
+}): {
+    pageState: {
+        current: number;
+        pageSize: number;
+        total: number;
+    };
+    paginationCfg: ComputedRef<PaginationConfig>;
+    showPagination: ComputedRef<boolean>;
+    pageSizesComputed: ComputedRef<number[]>;
+    paginationLayoutComputed: ComputedRef<string>;
+    paginationBgComputed: ComputedRef<boolean>;
+    setPage: (page: number) => void;
+    setPageSize: (size: number) => void;
+    resetPage: () => void;
+};

package/lib/components/ee-form-table/src/hooks/useSearch.d.ts

@@ -0,0 +1,39 @@
+import { ComputedRef } from 'vue';
+import { TableColumn, SearchConfig, ColumnSearchItem } from '../../types';
+/**
+ * @param props.columns - 表格列配置（从中提取 search.enable = true 的字段）
+ * @param props.searchConfig - 搜索区域配置（列数、折叠行数等）
+ */
+export declare function useSearch(props: {
+    columns: TableColumn[];
+    searchConfig?: SearchConfig | boolean;
+}): {
+    searchExpanded: import('vue').Ref<boolean, boolean>;
+    searchParams: Record<string, unknown>;
+    searchCfg: ComputedRef<SearchConfig>;
+    showSearch: ComputedRef<boolean | undefined>;
+    searchCols: ComputedRef<number>;
+    allSearchFields: ComputedRef<(ColumnSearchItem & {
+        prop: string;
+        label: string;
+        field: string;
+        placeholder: string;
+        dictKey?: string;
+        props: Record<string, unknown>;
+    })[]>;
+    visibleSearchFields: ComputedRef<(ColumnSearchItem & {
+        prop: string;
+        label: string;
+        field: string;
+        placeholder: string;
+        dictKey?: string;
+        props: Record<string, unknown>;
+    })[]>;
+    showFoldBtn: ComputedRef<boolean>;
+    actionColSpan: ComputedRef<number>;
+    initSearchParams: () => void;
+    getDefaultSearchParams: () => Record<string, unknown>;
+    getActiveSearchParams: () => Record<string, unknown>;
+    resetSearchParams: () => void;
+    toggleFold: () => void;
+};

package/lib/components/ee-form-table/src/hooks/useTable.d.ts

@@ -0,0 +1,49 @@
+import { ComputedRef } from 'vue';
+import { TableColumn, SelectionConfig, ColumnSettingConfig, AutoHeightConfig } from '../../types';
+/**
+ * @param props.columns - 表格列配置
+ * @param props.selectionConfig - 选择列配置
+ * @param props.columnSetting - 列设置配置
+ * @param props.rowKey - 数据行唯一标识字段名
+ * @param props.tableHeight - 固定表格高度
+ * @param props.tableMaxHeight - 表格最大高度
+ * @param props.autoHeight - 自适应高度配置
+ * @param deps.authPass - 权限判断函数（用于按权限过滤列）
+ */
+export declare function useTable(props: {
+    columns: TableColumn[];
+    data?: Record<string, unknown>[];
+    loading?: boolean;
+    selectionConfig?: SelectionConfig;
+    columnSetting?: ColumnSettingConfig;
+    rowKey?: string;
+    tableHeight?: string | number;
+    tableMaxHeight?: string | number;
+    autoHeight?: AutoHeightConfig | boolean;
+    stripe?: boolean;
+    border?: boolean;
+    highlightCurrentRow?: boolean;
+    size?: string;
+}, deps: {
+    authPass: (auth?: string) => boolean;
+}): {
+    tableRef: import('vue').Ref<any, any>;
+    selection: import('vue').Ref<Record<string, unknown>[], Record<string, unknown>[]>;
+    singleSelection: import('vue').Ref<string | number | null, string | number | null>;
+    columnSettingVisible: import('vue').Ref<boolean, boolean>;
+    checkedColumns: import('vue').Ref<string[], string[]>;
+    selectionCfg: ComputedRef<SelectionConfig>;
+    columnSettingCfg: ComputedRef<ColumnSettingConfig>;
+    showColumnSetting: ComputedRef<boolean | undefined>;
+    allColumns: ComputedRef<TableColumn[]>;
+    visibleColumns: ComputedRef<TableColumn[]>;
+    tableComputedHeight: ComputedRef<string | number | undefined>;
+    tableMaxHeightProp: ComputedRef<string | number | undefined>;
+    tableWrapperStyle: ComputedRef<{
+        minHeight: string;
+    } | {
+        minHeight?: undefined;
+    }>;
+    handleSelectionChange: (val: Record<string, unknown>[]) => void;
+    handleSingleSelect: (row: Record<string, unknown>) => void;
+};