workdesktop-ai 1.0.0

package/dist/types/src/components/upload/ImageUpload.vue.d.ts

@@ -0,0 +1,176 @@
+import type { UploadInstance } from 'element-plus';
+import type { PropType } from 'vue';
+declare function clearFiles(): void;
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** 上传地址 */
+    api: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 后端删除地址 */
+    deleteApi: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 删除请求方法 */
+    deleteMethod: {
+        type: PropType<"get" | "post" | "put" | "delete">;
+        default: string;
+    };
+    /** 删除主键字段 */
+    primaryKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 最大图片数量，超限隐藏加号 */
+    maxCount: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 缩略图尺寸（px） */
+    thumbnailSize: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 是否点击缩略图大图预览（集成 Viewer） */
+    preview: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 接收类型，默认 image/* */
+    accept: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 单图大小限制（MB） */
+    maxSize: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 提示文案 */
+    tip: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** v-model：已上传图片地址数组 */
+    modelValue: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    headRefreshDatagrid: {
+        type: PropType<boolean | string>;
+        default: boolean;
+    };
+    filter: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, {
+    clearFiles: typeof clearFiles;
+    uploadRef: import("vue").Ref<UploadInstance | undefined, UploadInstance | undefined>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    success: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    apiBefore: (...args: any[]) => void;
+    apiSuccess: (...args: any[]) => void;
+    apiFail: (...args: any[]) => void;
+    apiException: (...args: any[]) => void;
+    apiAfter: (...args: any[]) => void;
+    "update:modelValue": (...args: any[]) => void;
+    change: (...args: any[]) => void;
+    "delete-success": (...args: any[]) => void;
+    preview: (...args: any[]) => void;
+    exceed: (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** 上传地址 */
+    api: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 后端删除地址 */
+    deleteApi: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 删除请求方法 */
+    deleteMethod: {
+        type: PropType<"get" | "post" | "put" | "delete">;
+        default: string;
+    };
+    /** 删除主键字段 */
+    primaryKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 最大图片数量，超限隐藏加号 */
+    maxCount: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 缩略图尺寸（px） */
+    thumbnailSize: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 是否点击缩略图大图预览（集成 Viewer） */
+    preview: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 接收类型，默认 image/* */
+    accept: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 单图大小限制（MB） */
+    maxSize: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 提示文案 */
+    tip: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** v-model：已上传图片地址数组 */
+    modelValue: {
+        type: PropType<string[]>;
+        default: () => never[];
+    };
+    headRefreshDatagrid: {
+        type: PropType<boolean | string>;
+        default: boolean;
+    };
+    filter: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{
+    onSuccess?: ((...args: any[]) => any) | undefined;
+    onError?: ((...args: any[]) => any) | undefined;
+    onApiBefore?: ((...args: any[]) => any) | undefined;
+    onApiSuccess?: ((...args: any[]) => any) | undefined;
+    onApiFail?: ((...args: any[]) => any) | undefined;
+    onApiException?: ((...args: any[]) => any) | undefined;
+    onApiAfter?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    onChange?: ((...args: any[]) => any) | undefined;
+    "onDelete-success"?: ((...args: any[]) => any) | undefined;
+    onPreview?: ((...args: any[]) => any) | undefined;
+    onExceed?: ((...args: any[]) => any) | undefined;
+}>, {
+    filter: string;
+    api: string;
+    modelValue: string[];
+    headRefreshDatagrid: string | boolean;
+    deleteApi: string;
+    deleteMethod: "delete" | "get" | "post" | "put";
+    primaryKey: string;
+    accept: string;
+    maxSize: number;
+    preview: boolean;
+    tip: string;
+    maxCount: number;
+    thumbnailSize: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/src/components/upload/Upload.vue.d.ts

@@ -0,0 +1,235 @@
+import type { UploadInstance, UploadUserFile } from 'element-plus';
+import type { PropType } from 'vue';
+/** 手动触发上传（auto-upload=false） */
+declare function submitUpload(): void;
+declare function clearFiles(): void;
+/** 追加外部文件记录（如表单回显） */
+declare function addFile(file: UploadUserFile): void;
+declare var __VLS_7: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_7) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** 上传地址（走全局 urlPrefix 拼接；为空则 el-upload 不真正提交，由外部接管） */
+    api: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 后端删除地址 */
+    deleteApi: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 删除请求方法 */
+    deleteMethod: {
+        type: PropType<"get" | "post" | "put" | "delete">;
+        default: string;
+    };
+    /** 删除时取文件记录的主键字段名 */
+    primaryKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 手动提交按钮文案（auto-upload=false 时显示） */
+    submitButtonText: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 选择按钮文案（默认插槽未提供时） */
+    buttonText: {
+        type: StringConstructor;
+        default: string;
+    };
+    accept: {
+        type: StringConstructor;
+        default: string;
+    };
+    limit: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    multiple: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    autoUpload: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 上传字段名 */
+    name: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 附加表单数据 */
+    data: {
+        type: PropType<Record<string, any>>;
+        default: () => {};
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showFileList: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 文件大小限制（MB），0 不限制 */
+    maxSize: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** v-model 绑定的已上传文件列表（含后端返回记录） */
+    modelValue: {
+        type: PropType<UploadUserFile[]>;
+        default: () => never[];
+    };
+    headRefreshDatagrid: {
+        type: PropType<boolean | string>;
+        default: boolean;
+    };
+    filter: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, {
+    submitUpload: typeof submitUpload;
+    clearFiles: typeof clearFiles;
+    addFile: typeof addFile;
+    uploadRef: import("vue").Ref<UploadInstance | undefined, UploadInstance | undefined>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    success: (...args: any[]) => void;
+    error: (...args: any[]) => void;
+    apiBefore: (...args: any[]) => void;
+    apiSuccess: (...args: any[]) => void;
+    apiFail: (...args: any[]) => void;
+    apiException: (...args: any[]) => void;
+    apiAfter: (...args: any[]) => void;
+    "update:modelValue": (...args: any[]) => void;
+    change: (...args: any[]) => void;
+    "delete-success": (...args: any[]) => void;
+    preview: (...args: any[]) => void;
+    exceed: (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** 上传地址（走全局 urlPrefix 拼接；为空则 el-upload 不真正提交，由外部接管） */
+    api: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 后端删除地址 */
+    deleteApi: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 删除请求方法 */
+    deleteMethod: {
+        type: PropType<"get" | "post" | "put" | "delete">;
+        default: string;
+    };
+    /** 删除时取文件记录的主键字段名 */
+    primaryKey: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 手动提交按钮文案（auto-upload=false 时显示） */
+    submitButtonText: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 选择按钮文案（默认插槽未提供时） */
+    buttonText: {
+        type: StringConstructor;
+        default: string;
+    };
+    accept: {
+        type: StringConstructor;
+        default: string;
+    };
+    limit: {
+        type: NumberConstructor;
+        default: undefined;
+    };
+    multiple: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    autoUpload: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 上传字段名 */
+    name: {
+        type: StringConstructor;
+        default: string;
+    };
+    /** 附加表单数据 */
+    data: {
+        type: PropType<Record<string, any>>;
+        default: () => {};
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    showFileList: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 文件大小限制（MB），0 不限制 */
+    maxSize: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** v-model 绑定的已上传文件列表（含后端返回记录） */
+    modelValue: {
+        type: PropType<UploadUserFile[]>;
+        default: () => never[];
+    };
+    headRefreshDatagrid: {
+        type: PropType<boolean | string>;
+        default: boolean;
+    };
+    filter: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{
+    onSuccess?: ((...args: any[]) => any) | undefined;
+    onError?: ((...args: any[]) => any) | undefined;
+    onApiBefore?: ((...args: any[]) => any) | undefined;
+    onApiSuccess?: ((...args: any[]) => any) | undefined;
+    onApiFail?: ((...args: any[]) => any) | undefined;
+    onApiException?: ((...args: any[]) => any) | undefined;
+    onApiAfter?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    onChange?: ((...args: any[]) => any) | undefined;
+    "onDelete-success"?: ((...args: any[]) => any) | undefined;
+    onPreview?: ((...args: any[]) => any) | undefined;
+    onExceed?: ((...args: any[]) => any) | undefined;
+}>, {
+    data: Record<string, any>;
+    disabled: boolean;
+    name: string;
+    filter: string;
+    api: string;
+    modelValue: UploadUserFile[];
+    headRefreshDatagrid: string | boolean;
+    multiple: boolean;
+    deleteApi: string;
+    deleteMethod: "delete" | "get" | "post" | "put";
+    primaryKey: string;
+    submitButtonText: string;
+    buttonText: string;
+    accept: string;
+    limit: number;
+    autoUpload: boolean;
+    showFileList: boolean;
+    maxSize: number;
+}, {}, {}, {}, 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/utils/Viewer.vue.d.ts

@@ -0,0 +1,131 @@
+import type { PropType } from 'vue';
+declare function zoomIn(): void;
+declare function zoomOut(): void;
+declare function rotateLeft(): void;
+declare function rotateRight(): void;
+declare function close(): void;
+/** 外部打开（与 v-model 等价的命令式入口） */
+declare function open(src?: string | string[]): void;
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** 预览源：单个地址或地址数组（图片数组支持轮播） */
+    src: {
+        type: PropType<string | string[]>;
+        default: string;
+    };
+    /** 内容类型；缺省按 src 后缀推断 */
+    type: {
+        type: PropType<"image" | "pdf" | "doc">;
+        default: undefined;
+    };
+    /** 是否显示（v-model） */
+    modelValue: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 初始缩放比例 */
+    zoom: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 初始旋转角度 */
+    rotate: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 初始页码/图片索引（从 1 开始） */
+    page: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 缩放步长 */
+    zoomStep: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 最小/最大缩放 */
+    minZoom: {
+        type: NumberConstructor;
+        default: number;
+    };
+    maxZoom: {
+        type: NumberConstructor;
+        default: number;
+    };
+}>, {
+    open: typeof open;
+    close: typeof close;
+    zoomIn: typeof zoomIn;
+    zoomOut: typeof zoomOut;
+    rotateLeft: typeof rotateLeft;
+    rotateRight: typeof rotateRight;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    close: (...args: any[]) => void;
+    "page-change": (...args: any[]) => void;
+    "update:modelValue": (...args: any[]) => void;
+    open: (...args: any[]) => void;
+    "zoom-change": (...args: any[]) => void;
+    "rotate-change": (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** 预览源：单个地址或地址数组（图片数组支持轮播） */
+    src: {
+        type: PropType<string | string[]>;
+        default: string;
+    };
+    /** 内容类型；缺省按 src 后缀推断 */
+    type: {
+        type: PropType<"image" | "pdf" | "doc">;
+        default: undefined;
+    };
+    /** 是否显示（v-model） */
+    modelValue: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** 初始缩放比例 */
+    zoom: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 初始旋转角度 */
+    rotate: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 初始页码/图片索引（从 1 开始） */
+    page: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 缩放步长 */
+    zoomStep: {
+        type: NumberConstructor;
+        default: number;
+    };
+    /** 最小/最大缩放 */
+    minZoom: {
+        type: NumberConstructor;
+        default: number;
+    };
+    maxZoom: {
+        type: NumberConstructor;
+        default: number;
+    };
+}>> & Readonly<{
+    onClose?: ((...args: any[]) => any) | undefined;
+    "onPage-change"?: ((...args: any[]) => any) | undefined;
+    "onUpdate:modelValue"?: ((...args: any[]) => any) | undefined;
+    onOpen?: ((...args: any[]) => any) | undefined;
+    "onZoom-change"?: ((...args: any[]) => any) | undefined;
+    "onRotate-change"?: ((...args: any[]) => any) | undefined;
+}>, {
+    type: "image" | "pdf" | "doc";
+    page: number;
+    modelValue: boolean;
+    src: string | string[];
+    zoom: number;
+    rotate: number;
+    zoomStep: number;
+    minZoom: number;
+    maxZoom: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/src/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * WorkDesktop 组件库主入口
+ *
+ * ESM：import WorkDesktop from 'workdesktop-ai'
+ * UMD：window.WorkDesktop（script 标签，配合 window.workDesktopConfig）
+ */
+import './styles/index.css';
+export { default as WorkDesktop, default } from './lib/install';
+export * from './components';
+export { initConfig, setGlobalConfig, getGlobalConfig, resetConfig, mergeConfig, getComponentDefault } from './lib/core/config';
+export { request, default as http } from './lib/core/http';
+export type { ApiResult, ApiEventPayload, ApiEventType, ApiEventHandler } from './lib/core/http';
+export { registerDataGrid, refreshDataGrid, searchDataGrid, resetSearchDataGrid, getDataGrids, clearLinkageRegistry } from './lib/core/linkage';
+export { useRequest } from './lib/composables/useRequest';
+export { useDataGrid } from './lib/composables/useDataGrid';
+export { useConfig, useGlobalConfig } from './lib/composables/useConfig';
+export { useEventBus } from './lib/composables/useEventBus';
+export { useGlobalState } from './lib/composables/useGlobalState';
+export { deepMerge } from './lib/core/utils';
+export type * from './types';

package/dist/types/src/lib/composables/useConfig.d.ts

@@ -0,0 +1,19 @@
+import type { WorkDesktopConfig } from '../../types/config';
+/**
+ * useConfig（PRD 5.3 / 5.2）
+ *
+ * 组件内合并三级配置：全局 componentDefault[组件名] → 本地 props。
+ * 全局配置在组件 onMounted 时读取一次并缓存（运行中改配置只影响新挂载组件）。
+ *
+ * 返回一个响应式 ref，merge 后的组件配置对象：
+ *   componentDefault 的值作为默认，props 中非 undefined 的值覆盖。
+ *
+ * @example
+ * const cfg = useConfig('WdDatagrid', props)
+ * cfg.value.withPager
+ */
+export declare function useConfig<T extends Record<string, any> = Record<string, any>>(componentName?: string, props?: T): import("vue").Ref<any, any> extends T ? T extends T & import("vue").Ref<any, any> ? import("@vue/shared").IfAny<T, import("vue").ShallowRef<T, T>, T> : import("vue").ShallowRef<T, T> : import("vue").ShallowRef<T, T>;
+/**
+ * 非响应式：直接取当前全局 WorkDesktopConfig
+ */
+export declare function useGlobalConfig(): WorkDesktopConfig;

package/dist/types/src/lib/composables/useDataGrid.d.ts

@@ -0,0 +1,54 @@
+/**
+ * useDataGrid（PRD 5.3）
+ * DataGrid 状态管理：分页 / 搜索 / 选中 / 请求
+ *
+ * @example
+ * const grid = useDataGrid({ pageSize: 20 })
+ * grid.fetchData()
+ */
+export interface UseDataGridOptions {
+    /** 数据接口地址 */
+    api?: string;
+    /** 请求方法，默认 post */
+    apiMethod?: 'get' | 'post' | 'put' | 'delete';
+    /** 固定请求参数 */
+    apiParam?: Record<string, any>;
+    /** 初始每页条数 */
+    pageSize?: number;
+    /** 是否自动请求 */
+    immediate?: boolean;
+    /** 请求级覆盖 */
+    reqOptions?: import('../../types/config').ReqOptions;
+    /** 请求成功回调（解封后的列表结果） */
+    onLoaded?: (result: {
+        list: any[];
+        total: number;
+    }) => void;
+}
+export interface ListData {
+    list: any[];
+    total: number;
+    pageSize: number;
+    currentPage: number;
+}
+export declare function useDataGrid(options?: UseDataGridOptions): {
+    currentPage: import("vue").Ref<number, number>;
+    page: import("vue").Ref<number, number>;
+    pageSize: import("vue").Ref<number, number>;
+    total: import("vue").Ref<number, number>;
+    list: import("vue").ShallowRef<any[], any[]>;
+    loading: import("vue").Ref<boolean, boolean>;
+    searchParams: Record<string, any>;
+    selection: import("vue").Ref<any[], any[]>;
+    fetchData: (extra?: Record<string, any>) => Promise<ListData>;
+    refresh: () => Promise<ListData>;
+    reset: () => Promise<ListData>;
+    search: (params?: Record<string, any>) => Promise<ListData>;
+    onChangeCurrentpage: (value: number) => Promise<ListData>;
+    onChangePagesize: (value: number) => Promise<ListData>;
+    setSelection: (rows: any[]) => void;
+    getSelection: () => any[];
+    clearSelection: () => void;
+    buildParams: (extra?: Record<string, any>) => Record<string, any>;
+};
+export type DataGridController = ReturnType<typeof useDataGrid>;

package/dist/types/src/lib/composables/useEventBus.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 轻量事件总线（PRD 5.3 / 6.3）
+ * 跨组件事件联动。组件卸载自动 off。
+ */
+type Handler = (payload?: any) => void;
+declare function emit(event: string, payload?: any): void;
+declare function off(event: string, handler: Handler): void;
+declare function clear(event?: string): void;
+export declare function useEventBus(): {
+    emit: typeof emit;
+    on: (event: string, handler: Handler) => () => void;
+    off: typeof off;
+    clear: typeof clear;
+};
+export type EventBus = ReturnType<typeof useEventBus>;
+export {};

package/dist/types/src/lib/composables/useGlobalState.d.ts

@@ -0,0 +1,5 @@
+export declare function useGlobalState<T extends object = Record<string, any>>(key: string, initial?: T): {
+    state: T;
+    set: (partial: Partial<T> | ((prev: T) => Partial<T>)) => void;
+    reset: () => void;
+};