@dazhicheng/ui 1.5.42 → 1.5.43

package/dist/components/tt-form/index.d.ts

@@ -12,4 +12,4 @@ type TtExtendedFormApi = ExtendedFormApi;
 export type { BaseFormComponentMap, BaseFormComponentType, FormSlotSchema, InferredComponentPropsType, TtExtendedFormApi, TtFormProps, TtFormRenderProps, TtFormSchema, };
 export * as z from 'zod';
 export { useGroupForm } from './src/group-form';
-export type { FormGroupSchema, GroupFormSchema, UseGroupFormOptions } from './src/group-form';
+export type { FormGroupSchema, GroupFormNavAnchorProps, GroupFormSchema, UseGroupFormNavAnchorProps, UseGroupFormOptions, } from './src/group-form';

package/dist/components/tt-form/src/group-form/GroupForm.vue.d.ts

@@ -1,4 +1,4 @@
-import { GroupFormSchema, GroupFormSectionProps } from './types';
+import { GroupFormSectionProps } from './types';
 /**
  * @description 滚动到指定分组（通过 data-group-key 定位 DOM）。
  *   滚动期间暂停 LazyFormField 渲染，滚动结束后才恢复，
@@ -22,21 +22,7 @@ declare const __VLS_component: import('vue').DefineComponent<GroupFormSectionPro
         title: string;
     }[]>;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<GroupFormSectionProps> & Readonly<{}>, {
-    scrollToFirstError: boolean;
     commonConfig: import('../types').FormCommonConfig;
-    compact: boolean;
-    layout: import('../types').FormLayout;
-    virtual: boolean;
-    containerHeight: number | string;
-    rootMargin: string;
-    estimateFieldHeight: number;
-    showNav: boolean;
-    navTitle: string;
-    autoScrollToGroup: import('./types').AutoScrollPosition;
-    groupSchema: GroupFormSchema[];
-    errorCacheMap: Map<string, string>;
-    resetSignal: import('vue').Ref<number>;
-    navErrorCounts: Record<string, number>;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
     scrollRef: HTMLDivElement;
 }, any>;

package/dist/components/tt-form/src/group-form/groupFormApi.d.ts

@@ -1,7 +1,7 @@
 import { FormState, GenericObject, ResetFormOpts, ValidationOptions } from 'vee-validate';
 import { FormApi } from '../formApi';
 import { TtFormProps } from '../types';
-import { GroupFormApiOptions, GroupFormSchema } from './types';
+import { AutoScrollPosition, GroupFormApiOptions, GroupFormSchema, UseGroupFormNavAnchorProps } from './types';
 import { InsertPosition } from './utils';
 /**
  * @description 分组表单 API 类，继承 {@link FormApi}，封装分组场景下的校验、导航错误计数、
@@ -9,10 +9,18 @@ import { InsertPosition } from './utils';
 export declare class GroupFormApi extends FormApi {
     /** 是否启用虚拟化（IntersectionObserver 懒渲染） */
     readonly enableVirtual: boolean;
-    /** 是否显示悬浮导航锚点 */
-    readonly showNav: boolean;
+    /** 导航锚点配置（含 show、title 等），由构造参数合并默认值后保存 */
+    readonly navAnchorProps: Required<Pick<UseGroupFormNavAnchorProps, "show">> & UseGroupFormNavAnchorProps;
     /** 校验失败时是否自动滚动到第一个有错误的分组 */
     readonly enableScrollToFirstError: boolean;
+    /** 滚动容器高度 */
+    readonly containerHeight: number | string;
+    /** IntersectionObserver rootMargin */
+    readonly rootMargin: string;
+    /** 预估每个表单项高度（px） */
+    readonly estimateFieldHeight: number;
+    /** 初始化后自动滚动到的分组位置 */
+    readonly autoScrollToGroup: AutoScrollPosition;
     /** 各分组折叠状态（key → 是否折叠） */
     readonly collapseStates: Record<string, boolean>;
     /** 导航各分组的错误数量，validate 后自动更新 */

package/dist/components/tt-form/src/group-form/index.d.ts

@@ -1,4 +1,4 @@
 export { GroupFormApi } from './groupFormApi';
 export { useGroupForm } from './useGroupForm';
-export type { FormGroupSchema, FormRowSchema, GroupFormApiOptions, GroupFormSchema, UseGroupFormOptions, } from './types';
+export type { FormGroupSchema, FormRowSchema, GroupFormApiOptions, GroupFormNavAnchorProps, GroupFormSchema, UseGroupFormNavAnchorProps, UseGroupFormOptions, } from './types';
 export { isGroupSchema, isRowSchema, isSlotSchema, extractFlatSchemas } from './utils';

package/dist/components/tt-form/src/group-form/types.d.ts

@@ -1,5 +1,5 @@
 import { ExtendedFormApi, FormActions, FormCommonConfig, FormLayout, FormSchema, FormSlotSchema, TtFormProps, WrapperClassType } from '../types';
-import { Ref } from 'vue';
+import { TtNavAnchorProps } from '../../../tt-nav-anchor';
 export type CollapsibleType = boolean | ((values: Record<string, any>, actions: FormActions) => boolean | PromiseLike<boolean>);
 /** 控制 group / row / slot 是否显示，支持布尔值或函数（接收表单值与 formActions，可返回 Promise） */
 export type IfShowConditionType = boolean | ((values: Record<string, any>, actions: FormActions) => boolean | PromiseLike<boolean>);
@@ -41,10 +41,25 @@ export interface FormRowSchema {
     ifShow?: IfShowConditionType;
 }
 export type GroupFormSchema = FormGroupSchema | FormRowSchema | FormSlotSchema | FormSchema;
+/**
+ * 导航锚点基础配置：排除由内部维护的 `items` 与 `modelValue`，增加 `show` 控制是否渲染。
+ * @property {boolean} [show] - 是否显示悬浮导航，默认 true
+ */
+type NavAnchorPropsBase = Omit<Partial<TtNavAnchorProps>, "items" | "modelValue"> & {
+    show?: boolean;
+};
+/**
+ * useGroupForm 调用方传入的导航配置；`badgeCounts` 由 formApi 内部注入，调用方无需传入。
+ */
+export type UseGroupFormNavAnchorProps = Omit<NavAnchorPropsBase, "badgeCounts">;
+/**
+ * VirtualGroupForm 组件接收的导航配置；`badgeCounts` 由 useGroupForm 绑定 `api.navErrorCounts` 注入。
+ */
+export type GroupFormNavAnchorProps = NavAnchorPropsBase;
 /** 分组表单组件选项 */
 export interface UseGroupFormOptions extends Omit<TtFormProps, "schema" | "showDefaultActions"> {
     schema: GroupFormSchema[];
-    /** 是否启用表单项级别的虚拟化（IntersectionObserver 懒渲染），默认 true */
+    /** 是否启用虚拟化，默认 true */
     virtual?: boolean;
     /** 滚动容器高度，默认 '100%' */
     containerHeight?: number | string;
@@ -52,10 +67,11 @@ export interface UseGroupFormOptions extends Omit<TtFormProps, "schema" | "showD
     rootMargin?: string;
     /** 预估每个表单项高度（px），用于占位，默认 52（仅 virtual 为 true 时生效） */
     estimateFieldHeight?: number;
-    /** 是否显示悬浮导航锚点，默认 true */
-    showNav?: boolean;
-    /** 导航栏标题，默认 '导航' */
-    navTitle?: string;
+    /**
+     * 悬浮导航锚点：是否显示、标题、定位等；默认 `{ show: true, title: '导航' }`。
+     * `badgeCounts` 由 formApi 维护，无需在此传入。
+     */
+    navAnchorProps?: UseGroupFormNavAnchorProps;
     /** 自动滚动到指定分组，默认 'top' */
     autoScrollToGroup?: AutoScrollPosition;
     /** 校验失败时是否自动滚动到第一个有错误的分组，默认 true */
@@ -80,44 +96,21 @@ export interface LazyFormFieldProps {
     /** 骨架屏是否开启动画，默认 true */
     skeletonAnimated?: boolean;
 }
-/** 分组表单组件 props */
+/**
+ * 分组表单组件 props：仅保留 `formApi`（数据入口）和少量模板侧可覆盖项。
+ * 其余内部数据（collapseStates、errorCacheMap、resetSignal、virtual 等）均从 `formApi`（GroupFormApi 实例）读取。
+ */
 export interface GroupFormSectionProps {
-    /** 分组表单定义（可选，优先从 store 读取） */
-    groupSchema?: GroupFormSchema[];
-    /** 表单 API */
+    /** 表单 API（必传，所有内部数据的入口） */
     formApi: ExtendedFormApi;
-    /** 分组折叠状态 */
-    collapseStates: Record<string, boolean>;
-    /** 滚动容器高度 */
-    containerHeight?: number | string;
-    /** 通用配置 */
-    commonConfig?: FormCommonConfig;
-    /** 布局 */
+    /** 模板侧覆盖：导航锚点配置（与 api.navAnchorProps 合并，模板优先） */
+    navAnchorProps?: GroupFormNavAnchorProps;
+    /** 模板侧覆盖：布局方向 */
     layout?: FormLayout;
-    /** 紧凑模式 */
+    /** 模板侧覆盖：紧凑模式 */
     compact?: boolean;
-    /** IntersectionObserver rootMargin，控制提前渲染距离 */
-    rootMargin?: string;
-    /** 预估每个表单项高度（px） */
-    estimateFieldHeight?: number;
-    /** 是否启用表单项级别的虚拟化，默认 true */
-    virtual?: boolean;
-    /** 共享的字段错误缓存，由 useGroupForm 创建 */
-    errorCacheMap?: Map<string, string>;
-    /** 重置信号，由 useGroupForm 创建 */
-    resetSignal?: Ref<number>;
-    /** 是否显示悬浮导航 */
-    showNav?: boolean;
-    /** 导航标题 */
-    navTitle?: string;
-    /** 导航各分组错误数量 */
-    navErrorCounts?: Record<string, number>;
-    /** 自动滚动到指定分组 */
-    autoScrollToGroup?: AutoScrollPosition;
-    /** 校验失败时是否自动滚动到第一个有错误的分组，默认 true */
-    scrollToFirstError?: boolean;
-    /** 切换分组折叠状态 */
-    toggleCollapse?: (key: string) => void;
+    /** 模板侧覆盖：通用配置（与 store.commonConfig 合并） */
+    commonConfig?: FormCommonConfig;
 }
 /** GroupSection 递归组件 props */
 export interface GroupSectionProps {
@@ -149,16 +142,29 @@ export type AutoScrollPosition = "top" | "bottom";
  * @description GroupFormApi 构造函数的分组配置选项
  * @property {GroupFormSchema[]} groupSchema - 分组 schema 树形结构
  * @property {boolean} [enableVirtual] - 是否启用虚拟化（IntersectionObserver 懒渲染），默认 true
- * @property {boolean} [showNav] - 是否显示悬浮导航锚点，默认 true
+ * @property {UseGroupFormNavAnchorProps} [navAnchorProps] - 导航锚点配置（含 show、title 等），默认 `{ show: true }`
  * @property {boolean} [enableScrollToFirstError] - 校验失败时是否自动滚动到第一个有错误的分组，默认 true
+ * @property {number | string} [containerHeight] - 滚动容器高度，默认 '100%'
+ * @property {string} [rootMargin] - IntersectionObserver rootMargin，默认 '400px 0px'
+ * @property {number} [estimateFieldHeight] - 预估每个表单项高度（px），默认 52
+ * @property {AutoScrollPosition} [autoScrollToGroup] - 初始化后自动滚动到的分组位置，默认 'top'
  */
 export interface GroupFormApiOptions {
     /** 分组 schema 树形结构 */
     groupSchema: GroupFormSchema[];
     /** 是否启用虚拟化（IntersectionObserver 懒渲染），默认 true */
     enableVirtual?: boolean;
-    /** 是否显示悬浮导航锚点，默认 true */
-    showNav?: boolean;
+    /** 导航锚点配置（含 show、title 等），默认 `{ show: true }`；`items`、`modelValue`、`badgeCounts` 由内部注入 */
+    navAnchorProps?: UseGroupFormNavAnchorProps;
     /** 校验失败时是否自动滚动到第一个有错误的分组，默认 true */
     enableScrollToFirstError?: boolean;
+    /** 滚动容器高度，默认 '100%' */
+    containerHeight?: number | string;
+    /** IntersectionObserver rootMargin，控制提前渲染的距离，默认 '400px 0px' */
+    rootMargin?: string;
+    /** 预估每个表单项高度（px），用于占位，默认 52 */
+    estimateFieldHeight?: number;
+    /** 初始化后自动滚动到的分组位置，默认 'top' */
+    autoScrollToGroup?: AutoScrollPosition;
 }
+export {};

package/dist/components/tt-form/src/group-form/useGroupForm.d.ts

@@ -1,15 +1,7 @@
+import { DefineComponent } from 'vue';
 import { ExtendedFormApi } from '../types';
 import { UseGroupFormOptions } from './types';
 /**
- * @description 创建分组表单：返回可渲染的包装组件、扩展后的表单 API，以及分组折叠状态对象。
- * @param {UseGroupFormOptions} options - 分组 schema 与表单配置；`schema` 为树形结构，内部会展平后写入底层 store
- * @returns {readonly [import("vue").DefineComponent, ExtendedFormApi, Record<string, boolean>]} 元组：`[GroupForm, formApi, collapseStates]`
- * @example
- * const [GroupForm, formApi] = useGroupForm({
- *   schema: [{ type: "group", key: "basic", title: "基础", children: [{ fieldName: "name", component: "ElInput", label: "姓名" }] }],
- *   layout: "horizontal",
- * });
+ * @description 返回可渲染的包装组件、扩展后的表单 API，以及分组折叠状态对象。
  */
-export declare function useGroupForm(options: UseGroupFormOptions): readonly [import('vue').DefineComponent<{}, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
-    [key: string]: any;
-}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, ExtendedFormApi, Record<string, boolean>];
+export declare function useGroupForm(options: UseGroupFormOptions): readonly [DefineComponent<Partial<Omit<UseGroupFormOptions, "schema">>>, ExtendedFormApi];

package/dist/components/tt-nav-anchor/index.d.ts

@@ -1,7 +1,7 @@
-export declare const TtNavAnchor: import('../../../../utils/src').SFCWithInstall<import('vue').DefineComponent<import('./src/types').TtNavAnchorProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+export declare const TtNavAnchor: import('../../../../utils/src').SFCWithInstall<import('vue').DefineComponent<import('.').TtNavAnchorProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     change: (key: string) => any;
     "update:modelValue": (key: string) => any;
-}, string, import('vue').PublicProps, Readonly<import('./src/types').TtNavAnchorProps> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<import('.').TtNavAnchorProps> & Readonly<{
     onChange?: ((key: string) => any) | undefined;
     "onUpdate:modelValue"?: ((key: string) => any) | undefined;
 }>, {
@@ -15,5 +15,5 @@ export declare const TtNavAnchor: import('../../../../utils/src').SFCWithInstall
     navRef: HTMLDivElement;
     headerRef: HTMLDivElement;
 }, any>> & Record<string, any>;
-export type { NavAnchorItem } from './src/types';
+export type { NavAnchorItem, TtNavAnchorProps } from './src/types';
 export default TtNavAnchor;

package/dist/components/tt-nav-anchor/src/constants.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 导航锚点根节点宽度（px）。
+ */
+export declare const TT_NAV_ANCHOR_ROOT_WIDTH_PX = 164;

package/dist/components/tt-upload/index.d.ts

@@ -29,6 +29,10 @@ export declare const TtUpload: import('../../../../utils/src').SFCWithInstall<im
         readonly type: import('vue').PropType<(file: File) => Promise<import('.').OssSignatureResult>>;
         readonly default: undefined;
     };
+    readonly uploadOssViewApi: {
+        readonly type: import('vue').PropType<(key: string) => Promise<string>>;
+        readonly default: undefined;
+    };
     readonly uploadTip: {
         readonly type: import('vue').PropType<string>;
         readonly default: "可以上传pdf、excel、word、图片格式";
@@ -211,6 +215,10 @@ export declare const TtUpload: import('../../../../utils/src').SFCWithInstall<im
         readonly type: import('vue').PropType<(file: File) => Promise<import('.').OssSignatureResult>>;
         readonly default: undefined;
     };
+    readonly uploadOssViewApi: {
+        readonly type: import('vue').PropType<(key: string) => Promise<string>>;
+        readonly default: undefined;
+    };
     readonly uploadTip: {
         readonly type: import('vue').PropType<string>;
         readonly default: "可以上传pdf、excel、word、图片格式";
@@ -390,6 +398,7 @@ export declare const TtUpload: import('../../../../utils/src').SFCWithInstall<im
     readonly accept: string;
     readonly modal: boolean;
     readonly uploadOssApi: (file: File) => Promise<import('.').OssSignatureResult>;
+    readonly uploadOssViewApi: (key: string) => Promise<string>;
     readonly uploadTip: string;
     readonly maxSize: number;
     readonly showFileList: boolean;

package/dist/components/tt-upload/src/TtUpload.d.ts

@@ -1,4 +1,3 @@
-import { UploadFile, UploadFiles } from 'element-plus';
 import { SlotsType, VNode } from 'vue';
 import { OssSignatureResult, TtUploadFileItem } from './typing';
 declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
@@ -30,6 +29,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly type: import('vue').PropType<(file: File) => Promise<OssSignatureResult>>;
         readonly default: undefined;
     };
+    readonly uploadOssViewApi: {
+        readonly type: import('vue').PropType<(key: string) => Promise<string>>;
+        readonly default: undefined;
+    };
     readonly uploadTip: {
         readonly type: import('vue').PropType<string>;
         readonly default: "可以上传pdf、excel、word、图片格式";
@@ -84,62 +87,62 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
     readonly beforeRemove: {
-        readonly type: import('vue').PropType<(uploadFile: UploadFile, uploadFiles: UploadFiles) => import('element-plus/es/utils/typescript.mjs').Awaitable<boolean>>;
+        readonly type: import('vue').PropType<(uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => import('element-plus/es/utils/typescript.mjs').Awaitable<boolean>>;
         readonly required: false;
         readonly validator: ((val: unknown) => boolean) | undefined;
         __epPropKey: true;
     };
-    readonly onRemove: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onRemove: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    } | ((new (...args: any[]) => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
-    readonly onChange: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onChange: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    } | ((new (...args: any[]) => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
-    readonly onPreview: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: UploadFile) => void) | (() => (uploadFile: UploadFile) => void) | {
-        (): (uploadFile: UploadFile) => void;
+    readonly onPreview: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: import('element-plus').UploadFile) => void) | (() => (uploadFile: import('element-plus').UploadFile) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (uploadFile: UploadFile) => void) | (() => (uploadFile: UploadFile) => void) | {
-        (): (uploadFile: UploadFile) => void;
+    } | ((new (...args: any[]) => (uploadFile: import('element-plus').UploadFile) => void) | (() => (uploadFile: import('element-plus').UploadFile) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
-    readonly onSuccess: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onSuccess: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    } | ((new (...args: any[]) => (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
-    readonly onProgress: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onProgress: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    } | ((new (...args: any[]) => (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
-    readonly onError: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onError: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    } | ((new (...args: any[]) => (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
@@ -212,6 +215,10 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly type: import('vue').PropType<(file: File) => Promise<OssSignatureResult>>;
         readonly default: undefined;
     };
+    readonly uploadOssViewApi: {
+        readonly type: import('vue').PropType<(key: string) => Promise<string>>;
+        readonly default: undefined;
+    };
     readonly uploadTip: {
         readonly type: import('vue').PropType<string>;
         readonly default: "可以上传pdf、excel、word、图片格式";
@@ -266,62 +273,62 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
     readonly beforeRemove: {
-        readonly type: import('vue').PropType<(uploadFile: UploadFile, uploadFiles: UploadFiles) => import('element-plus/es/utils/typescript.mjs').Awaitable<boolean>>;
+        readonly type: import('vue').PropType<(uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => import('element-plus/es/utils/typescript.mjs').Awaitable<boolean>>;
         readonly required: false;
         readonly validator: ((val: unknown) => boolean) | undefined;
         __epPropKey: true;
     };
-    readonly onRemove: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onRemove: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    } | ((new (...args: any[]) => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
-    readonly onChange: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onChange: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    } | ((new (...args: any[]) => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
-    readonly onPreview: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: UploadFile) => void) | (() => (uploadFile: UploadFile) => void) | {
-        (): (uploadFile: UploadFile) => void;
+    readonly onPreview: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (uploadFile: import('element-plus').UploadFile) => void) | (() => (uploadFile: import('element-plus').UploadFile) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (uploadFile: UploadFile) => void) | (() => (uploadFile: UploadFile) => void) | {
-        (): (uploadFile: UploadFile) => void;
+    } | ((new (...args: any[]) => (uploadFile: import('element-plus').UploadFile) => void) | (() => (uploadFile: import('element-plus').UploadFile) => void) | {
+        (): (uploadFile: import('element-plus').UploadFile) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
-    readonly onSuccess: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onSuccess: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    } | ((new (...args: any[]) => (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
-    readonly onProgress: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onProgress: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    } | ((new (...args: any[]) => (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
-    readonly onError: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onError: import('element-plus/es/utils/index.mjs').EpPropFinalized<(new (...args: any[]) => (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
-    } | ((new (...args: any[]) => (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | (() => (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void) | {
-        (): (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    } | ((new (...args: any[]) => (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | (() => (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void) | {
+        (): (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
         new (): any;
         readonly prototype: any;
     })[], unknown, unknown, () => void, boolean>;
@@ -379,9 +386,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     readonly method: string;
     readonly withCredentials: boolean;
     readonly drag: boolean;
-    readonly onError: (error: Error, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
-    readonly onProgress: (evt: import('element-plus').UploadProgressEvent, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
-    readonly onChange: (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onError: (error: Error, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
+    readonly onProgress: (evt: import('element-plus').UploadProgressEvent, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
+    readonly onChange: (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
     readonly disabled: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;
     readonly name: string;
     readonly modelValue: TtUploadFileItem[];
@@ -391,6 +398,7 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     readonly accept: string;
     readonly modal: boolean;
     readonly uploadOssApi: (file: File) => Promise<OssSignatureResult>;
+    readonly uploadOssViewApi: (key: string) => Promise<string>;
     readonly uploadTip: string;
     readonly maxSize: number;
     readonly showFileList: boolean;
@@ -402,9 +410,9 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     readonly gridColumns: number;
     readonly showCount: boolean;
     readonly beforeUpload: (rawFile: import('element-plus').UploadRawFile) => import('element-plus/es/utils/typescript.mjs').Awaitable<void | undefined | null | boolean | File | Blob>;
-    readonly onRemove: (uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
-    readonly onPreview: (uploadFile: UploadFile) => void;
-    readonly onSuccess: (response: any, uploadFile: UploadFile, uploadFiles: UploadFiles) => void;
+    readonly onRemove: (uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
+    readonly onPreview: (uploadFile: import('element-plus').UploadFile) => void;
+    readonly onSuccess: (response: any, uploadFile: import('element-plus').UploadFile, uploadFiles: import('element-plus').UploadFiles) => void;
     readonly onExceed: (files: File[], uploadFiles: import('element-plus').UploadUserFile[]) => void;
     readonly fileList: import('element-plus').UploadUserFile[];
     readonly autoUpload: import('element-plus/es/utils/index.mjs').EpPropMergeType<BooleanConstructor, unknown, unknown>;

package/dist/components/tt-upload/src/typing.d.ts

@@ -1,6 +1,5 @@
 import { ExtractPropTypes, PropType } from 'vue';
 import { UploadRawFile } from 'element-plus';
-/** 后端返回的阿里云 OSS V4 签名信息（服务端签名直传） */
 export interface OssSignatureResult {
     /** HMAC-SHA256 签名 */
     signature: string;
@@ -22,20 +21,20 @@ export interface OssSignatureResult {
     policy: string;
 }
 export interface TtUploadFileItem {
-    /** 文件唯一标识 */
-    id: string | number;
     /** 文件名 */
-    name: string;
-    /** 文件URL（用于预览/下载） */
-    url?: string;
+    fileName: string;
+    /** 后端存储到oss的文件目录名称 */
+    ossUploadBaseDir?: string;
+    /** 后端存储到 OSS 的文件 key*/
+    ossKey?: string;
     /** 文件大小（字节） */
-    size?: number;
-    /** 文件类型 */
-    type?: string;
-    /** 上传时间 */
-    uploadTime?: string;
+    fileSize?: number;
+    /** 文件后缀 */
+    fileSuffix?: string;
     /** 原始文件对象 */
-    raw?: UploadRawFile;
+    file?: UploadRawFile;
+    /** 文件唯一标识 */
+    uid?: number;
     /** 扩展数据 */
     [key: string]: unknown;
 }
@@ -78,6 +77,11 @@ export declare const ttUploadProps: {
         readonly type: PropType<(file: File) => Promise<OssSignatureResult>>;
         readonly default: undefined;
     };
+    /** 根据 ossKey 获取文件预览/下载 URL 的接口，不传则使用全局 setup 的 uploadOssViewApi */
+    readonly uploadOssViewApi: {
+        readonly type: PropType<(key: string) => Promise<string>>;
+        readonly default: undefined;
+    };
     /** 上传提示文字 */
     readonly uploadTip: {
         readonly type: PropType<string>;

package/dist/components/types.d.ts

@@ -11,6 +11,8 @@ export type TtUiGlobalConfig = {
     userId?: string | number;
     /** 获取 OSS 签名信息的接口（服务端签名直传） */
     uploadOssApi?: (file: File) => Promise<OssSignatureResult>;
+    /** 根据 ossKey 获取文件预览/下载 URL 的接口 */
+    uploadOssViewApi?: (key: string) => Promise<string>;
     table?: {
         /** 自定义列服务端配置的key，支持函数动态获取 */
         columnsKey?: string | (() => string);