workdesktop-ai 1.2.1 → 1.2.2

package/dist/types/src/components/data/datagrid/DataGrid.vue.d.ts

@@ -0,0 +1,542 @@
+import { type PropType } from 'vue';
+/** 移除购物车中某行；若该行在当前页，同时取消勾选（经 selection 同步移除） */
+declare function removeCartRow(row: any): void;
+/** 清空购物车（计数归零，面板同步；当前页勾选一并清空） */
+declare function clearCart(): void;
+/** 获取购物车暂存数组（跨页累计、已去重） */
+declare function getCartList(): any[];
+declare function onChangeCurrentpage(val: number): void;
+declare function onChangePagesize(val: number): void;
+declare function requestApi(options?: {
+    apiParam?: Record<string, any>;
+}): Promise<void>;
+declare function refresh(): Promise<void>;
+declare function getSelection(): any[];
+declare function clearSelection(): void;
+/** 搜索面板联动：带搜索参数查询（重置到第一页） */
+declare function search(params?: Record<string, any>): Promise<void>;
+/** 重置搜索并刷新 */
+declare function resetSearch(): Promise<import("../../../lib/composables/useDataGrid").ListData>;
+declare var __VLS_1: {
+    selection: any[];
+    list: any[];
+}, __VLS_198: {}, __VLS_208: {
+    row: any;
+    index: number;
+}, __VLS_210: {
+    selection: any[];
+    list: any[];
+}, __VLS_421: {
+    list: any[];
+    remove: typeof removeCartRow;
+    clear: typeof clearCart;
+};
+type __VLS_Slots = {} & {
+    toolbar?: (props: typeof __VLS_1) => any;
+} & {
+    empty?: (props: typeof __VLS_198) => any;
+} & {
+    'card-item'?: (props: typeof __VLS_208) => any;
+} & {
+    toolbar?: (props: typeof __VLS_210) => any;
+} & {
+    'cart-content'?: (props: typeof __VLS_421) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    api: {
+        type: StringConstructor;
+        default: string;
+    };
+    apiMethod: {
+        type: PropType<"get" | "post" | "put" | "delete">;
+        default: string;
+    };
+    apiParam: {
+        type: PropType<Record<string, any>>;
+        default: () => {};
+    };
+    active: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 静态数据（数组） */
+    dataSource: {
+        type: PropType<any[] | any>;
+        default: undefined;
+    };
+    withPager: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    withSearch: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    modeSwitch: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    dynamicColumn: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    columnStorageKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    fix: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    border: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    stripe: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 高度模式：缺省内容自适应（数据多少就多高）；
+     * 'fix' —— 贴合最近一个有确定高度 / 可滚动的祖先容器（顶部取自身位置、底部贴其内容区底），
+     *          数据超出在行区内滚动、表头固定；祖先无定高 / 滚动约束时退化为内容自适应；
+     * 数字 / CSS 长度（如 '520px'）—— 表格固定高度，行区内滚动。
+     */
+    height: {
+        type: PropType<string | number>;
+        default: undefined;
+    };
+    autoHeight: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    rowKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    tableSize: {
+        type: PropType<"large" | "default" | "small">;
+        default: string;
+    };
+    pagerStyle: {
+        type: PropType<"simple" | "normal" | "full">;
+        default: string;
+    };
+    /** 分页在底栏的水平位置：left/center/right；缺省走全局配置 page.pager.position（默认 right） */
+    pagerPosition: {
+        type: PropType<"left" | "center" | "right">;
+        default: string;
+    };
+    withIndex: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    withSelection: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    rowspanKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    rowspanColumn: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    treeProps: {
+        type: ObjectConstructor;
+        default: () => {
+            children: string;
+            hasChildren: string;
+        };
+    };
+    defaultExpandAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    modelValue: {
+        type: PropType<any[]>;
+        default: () => never[];
+    };
+    /**
+     * 选中项返回：默认返回完整行对象数组；如果设置 selectionKey，则返回对应字段值数组
+     */
+    selectionKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    tools: {
+        type: PropType<{
+            refresh?: boolean;
+            columnSetting?: boolean;
+            modeSwitch?: boolean;
+            size?: boolean;
+            /** 显示内置「新增」按钮（点击 emit add） */
+            add?: boolean;
+            /** 显示内置「导出」按钮（点击 emit export） */
+            export?: boolean;
+            /** 右侧工具按钮形态：round 圆角（默认）/ square 方角 / group 按钮组 */
+            mode?: "round" | "square" | "group";
+            /** 工具按钮尺寸：large / default（默认）/ small，与 el-button 一致 */
+            buttonSize?: "large" | "default" | "small";
+        }>;
+        default: () => {};
+    };
+    /**
+     * 内置工具按钮组（刷新 / 大小 / 模式切换 / 列设置 / 购物车）位置：
+     * left 右上左区 / right 右上右区（默认）/ bottom 底栏（与分页同一行）
+     */
+    toolsPosition: {
+        type: PropType<"left" | "right" | "bottom">;
+        default: string;
+    };
+    /**
+     * 自定义工具栏（toolbar 插槽 + 新增/导出按钮）位置：
+     * left 左上左区（默认）/ right 左上右区 / bottom 底栏（与分页同一行）
+     */
+    toolbarPosition: {
+        type: PropType<"left" | "right" | "bottom">;
+        default: string;
+    };
+    /** 内置操作列配置（渲染行操作按钮，点击 emit row-action） */
+    rowActions: {
+        type: PropType<Array<{
+            text: string;
+            command?: string;
+            type?: string;
+        }>>;
+        default: () => never[];
+    };
+    withSelectionCart: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 购物车去重/自动回勾的唯一键字段，缺省复用 rowKey，均未配置时退化为按行对象引用比较 */
+    cartRowKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 购物车按钮与查看面板配置 */
+    cartConfig: {
+        type: PropType<{
+            type?: "dialog" | "drawer";
+            title?: string;
+            buttonText?: string;
+            size?: number | string;
+            showClear?: boolean;
+            showRemove?: boolean;
+        }>;
+        default: () => {
+            type: string;
+            title: string;
+            buttonText: string;
+            size: number;
+            showClear: boolean;
+            showRemove: boolean;
+        };
+    };
+    filter: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, {
+    requestApi: typeof requestApi;
+    refresh: typeof refresh;
+    onChangePagesize: typeof onChangePagesize;
+    onChangeCurrentpage: typeof onChangeCurrentpage;
+    getSelection: typeof getSelection;
+    clearSelection: typeof clearSelection;
+    search: typeof search;
+    resetSearch: typeof resetSearch;
+    getCartList: typeof getCartList;
+    clearCart: typeof clearCart;
+    tableRef: import("vue").Ref<any, any>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    apiBefore: (...args: any[]) => void;
+    apiAfter: (...args: any[]) => void;
+    add: (...args: any[]) => void;
+    export: (...args: any[]) => void;
+    "row-action": (...args: any[]) => void;
+    "page-change": (...args: any[]) => void;
+    "selection-change": (...args: any[]) => void;
+    "mode-change": (...args: any[]) => void;
+    loaded: (...args: any[]) => void;
+    "update:modelValue": (...args: any[]) => void;
+    "cart-change": (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    api: {
+        type: StringConstructor;
+        default: string;
+    };
+    apiMethod: {
+        type: PropType<"get" | "post" | "put" | "delete">;
+        default: string;
+    };
+    apiParam: {
+        type: PropType<Record<string, any>>;
+        default: () => {};
+    };
+    active: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 静态数据（数组） */
+    dataSource: {
+        type: PropType<any[] | any>;
+        default: undefined;
+    };
+    withPager: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    withSearch: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    modeSwitch: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    dynamicColumn: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    columnStorageKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    fix: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    border: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    stripe: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /**
+     * 高度模式：缺省内容自适应（数据多少就多高）；
+     * 'fix' —— 贴合最近一个有确定高度 / 可滚动的祖先容器（顶部取自身位置、底部贴其内容区底），
+     *          数据超出在行区内滚动、表头固定；祖先无定高 / 滚动约束时退化为内容自适应；
+     * 数字 / CSS 长度（如 '520px'）—— 表格固定高度，行区内滚动。
+     */
+    height: {
+        type: PropType<string | number>;
+        default: undefined;
+    };
+    autoHeight: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    rowKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    tableSize: {
+        type: PropType<"large" | "default" | "small">;
+        default: string;
+    };
+    pagerStyle: {
+        type: PropType<"simple" | "normal" | "full">;
+        default: string;
+    };
+    /** 分页在底栏的水平位置：left/center/right；缺省走全局配置 page.pager.position（默认 right） */
+    pagerPosition: {
+        type: PropType<"left" | "center" | "right">;
+        default: string;
+    };
+    withIndex: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    withSelection: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    rowspanKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    rowspanColumn: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    treeProps: {
+        type: ObjectConstructor;
+        default: () => {
+            children: string;
+            hasChildren: string;
+        };
+    };
+    defaultExpandAll: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    modelValue: {
+        type: PropType<any[]>;
+        default: () => never[];
+    };
+    /**
+     * 选中项返回：默认返回完整行对象数组；如果设置 selectionKey，则返回对应字段值数组
+     */
+    selectionKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    tools: {
+        type: PropType<{
+            refresh?: boolean;
+            columnSetting?: boolean;
+            modeSwitch?: boolean;
+            size?: boolean;
+            /** 显示内置「新增」按钮（点击 emit add） */
+            add?: boolean;
+            /** 显示内置「导出」按钮（点击 emit export） */
+            export?: boolean;
+            /** 右侧工具按钮形态：round 圆角（默认）/ square 方角 / group 按钮组 */
+            mode?: "round" | "square" | "group";
+            /** 工具按钮尺寸：large / default（默认）/ small，与 el-button 一致 */
+            buttonSize?: "large" | "default" | "small";
+        }>;
+        default: () => {};
+    };
+    /**
+     * 内置工具按钮组（刷新 / 大小 / 模式切换 / 列设置 / 购物车）位置：
+     * left 右上左区 / right 右上右区（默认）/ bottom 底栏（与分页同一行）
+     */
+    toolsPosition: {
+        type: PropType<"left" | "right" | "bottom">;
+        default: string;
+    };
+    /**
+     * 自定义工具栏（toolbar 插槽 + 新增/导出按钮）位置：
+     * left 左上左区（默认）/ right 左上右区 / bottom 底栏（与分页同一行）
+     */
+    toolbarPosition: {
+        type: PropType<"left" | "right" | "bottom">;
+        default: string;
+    };
+    /** 内置操作列配置（渲染行操作按钮，点击 emit row-action） */
+    rowActions: {
+        type: PropType<Array<{
+            text: string;
+            command?: string;
+            type?: string;
+        }>>;
+        default: () => never[];
+    };
+    withSelectionCart: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 购物车去重/自动回勾的唯一键字段，缺省复用 rowKey，均未配置时退化为按行对象引用比较 */
+    cartRowKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 购物车按钮与查看面板配置 */
+    cartConfig: {
+        type: PropType<{
+            type?: "dialog" | "drawer";
+            title?: string;
+            buttonText?: string;
+            size?: number | string;
+            showClear?: boolean;
+            showRemove?: boolean;
+        }>;
+        default: () => {
+            type: string;
+            title: string;
+            buttonText: string;
+            size: number;
+            showClear: boolean;
+            showRemove: boolean;
+        };
+    };
+    filter: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{
+    onApiBefore?: ((...args: any[]) => any) | undefined;
+    onApiAfter?: ((...args: any[]) => any) | undefined;
+    onAdd?: ((...args: any[]) => any) | undefined;
+    onExport?: ((...args: any[]) => any) | undefined;
+    "onRow-action"?: ((...args: any[]) => any) | undefined;
+    "onPage-change"?: ((...args: any[]) => any) | undefined;
+    "onSelection-change"?: ((...args: any[]) => any) | undefined;
+    "onMode-change"?: ((...args: any[]) => any) | undefined;
+    onLoaded?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    "onCart-change"?: ((...args: any[]) => any) | undefined;
+}>, {
+    filter: string;
+    api: string;
+    apiMethod: "post" | "delete" | "get" | "put";
+    apiParam: Record<string, any>;
+    active: boolean;
+    dataSource: any;
+    withPager: boolean;
+    withSearch: boolean;
+    modeSwitch: boolean;
+    dynamicColumn: boolean;
+    columnStorageKey: string;
+    fix: boolean;
+    border: boolean;
+    stripe: boolean;
+    height: string | number;
+    autoHeight: boolean;
+    rowKey: string;
+    tableSize: "default" | "small" | "large";
+    pagerStyle: "simple" | "normal" | "full";
+    pagerPosition: "left" | "center" | "right";
+    withIndex: boolean;
+    withSelection: boolean;
+    rowspanKey: string;
+    rowspanColumn: string[];
+    treeProps: Record<string, any>;
+    defaultExpandAll: boolean;
+    modelValue: any[];
+    selectionKey: string;
+    tools: {
+        refresh?: boolean;
+        columnSetting?: boolean;
+        modeSwitch?: boolean;
+        size?: boolean;
+        /** 显示内置「新增」按钮（点击 emit add） */
+        add?: boolean;
+        /** 显示内置「导出」按钮（点击 emit export） */
+        export?: boolean;
+        /** 右侧工具按钮形态：round 圆角（默认）/ square 方角 / group 按钮组 */
+        mode?: "round" | "square" | "group";
+        /** 工具按钮尺寸：large / default（默认）/ small，与 el-button 一致 */
+        buttonSize?: "large" | "default" | "small";
+    };
+    toolsPosition: "left" | "right" | "bottom";
+    toolbarPosition: "left" | "right" | "bottom";
+    rowActions: {
+        text: string;
+        command?: string;
+        type?: string;
+    }[];
+    withSelectionCart: boolean;
+    cartRowKey: string;
+    cartConfig: {
+        type?: "dialog" | "drawer";
+        title?: string;
+        buttonText?: string;
+        size?: number | string;
+        showClear?: boolean;
+        showRemove?: boolean;
+    };
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/src/components/data/datagrid/useColumnSettings.d.ts

@@ -0,0 +1,62 @@
+import { nextTick } from 'vue';
+import type { VNode } from 'vue';
+/**
+ * 动态列：从默认插槽的 el-table-column vnode 中提取列元信息，
+ * 支持显示/隐藏/排序，状态可持久化到 localStorage（PRD 4.2）。
+ */
+export interface ColumnMeta {
+    /** el-table-column 的 key（prop 或自动 id） */
+    key: string;
+    label: string;
+    /** 用户可控制的业务列（selection/index 等内置列不可控） */
+    controllable: boolean;
+    visible: boolean;
+    order: number;
+}
+/**
+ * 从插槽 vnode 数组中解析列
+ */
+export declare function extractColumns(vnodes: VNode[]): ColumnMeta[];
+/**
+ * 按列设置中的 order 重排业务列 vnode。
+ * key 解析规则必须与 extractColumns 完全一致（含自动编号计数），
+ * 未匹配到列设置的 vnode 保持原相对顺序排在末尾。
+ */
+export declare function orderColumnVnodes(vnodes: VNode[], orderMap: Map<string, number>): VNode[];
+export declare function useColumnSettings(storageKey?: string): {
+    columns: import("vue").Ref<{
+        key: string;
+        label: string;
+        controllable: boolean;
+        visible: boolean;
+        order: number;
+    }[], ColumnMeta[] | {
+        key: string;
+        label: string;
+        controllable: boolean;
+        visible: boolean;
+        order: number;
+    }[]>;
+    controllableColumns: import("vue").ComputedRef<{
+        key: string;
+        label: string;
+        controllable: boolean;
+        visible: boolean;
+        order: number;
+    }[]>;
+    hiddenKeys: import("vue").ComputedRef<Set<string>>;
+    columnOrderMap: import("vue").ComputedRef<Map<string, number>>;
+    settingVisible: import("vue").Ref<boolean, boolean>;
+    init: (vnodes: VNode[]) => void;
+    initMetas: (metas: Array<{
+        key: string;
+        label: string;
+        controllable?: boolean;
+        visible?: boolean;
+    }>) => void;
+    setVisible: (key: string, visible: boolean) => void;
+    move: (key: string, direction: -1 | 1) => void;
+    reorder: (fromKey: string, toKey: string, position?: "before" | "after") => void;
+    reset: () => void;
+    nextTick: typeof nextTick;
+};