@dazhicheng/ui 1.5.149 → 1.5.151

package/dist/components/tt-form/src/formApi.d.ts

@@ -1,9 +1,11 @@
 import { FormState, GenericObject, ResetFormOpts, ValidationOptions } from 'vee-validate';
 import { ComponentPublicInstance } from 'vue';
 import { Recordable, StateHandler } from '../../../../../utils/src';
-import { FormActions, FormSchema, TtFormProps } from './types';
+import { FormActions, FormArrayActions, FormSchema, NestedArrayHandle, TtFormProps } from './types';
 import { FieldArrayContext } from './types/forms';
 import { Store } from './shared/store';
+export type { ArrayPathSegment } from './utils/array-path';
+export { buildArrayFieldPath } from './utils/array-path';
 export declare class FormApi {
     form: FormActions;
     isMounted: boolean;
@@ -208,22 +210,19 @@ export declare class FormApi {
         swap: (name: string, indexA: number, indexB: number) => void | undefined;
         /**
          * @description 获取嵌套数组路径下的操作器
-         * @param parentPath 父数组路径（如 actions.data）
+         * @param parentPath 父数组路径（如 actions.data），或完整路径（仅传 path）
          * @param index 父数组索引
          * @param childField 子数组字段名（如 skills）
          */
-        at: <TValue = unknown>(parentPath: string, index: number, childField: string) => {
-            path: string;
-            get: () => Readonly<FieldArrayContext<TValue>> | undefined;
-            push: (value: TValue) => void | undefined;
-            remove: (idx: number) => void | undefined;
-            replace: (values: TValue[]) => void | undefined;
-            update: (idx: number, value: TValue) => void | undefined;
-            insert: (idx: number, value: TValue) => void | undefined;
-            prepend: (value: TValue) => void | undefined;
-            move: (oldIdx: number, newIdx: number) => void | undefined;
-            swap: (indexA: number, indexB: number) => void | undefined;
-        };
+        at: FormArrayActions["at"];
     };
     private _getArrayFieldActions;
+    /**
+     * @description 创建嵌套数组操作器（在原 inline 实现基础上支持链式 `.at`）
+     */
+    private _createNestedArrayHandle;
+    /**
+     * @description 包装嵌套操作器，变更后执行回调（供 GroupFormApi 同步导航错误）
+     */
+    protected _wrapNestedArrayHandle<TValue = unknown>(nested: NestedArrayHandle<TValue>, afterMutate: () => void): NestedArrayHandle<TValue>;
 }

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

@@ -282,22 +282,13 @@ export declare class GroupFormApi extends FormApi {
         swap: (name: string, indexA: number, indexB: number) => void;
         /**
          * @description 获取嵌套数组路径下的操作器
-         * @param parentPath 父数组路径
+         * @param parentPath 父数组路径，或完整路径（仅传 path）
          * @param index 父数组索引
          * @param childField 子数组字段名
-         * @returns 嵌套数组操作器
          */
-        at: <TValue = unknown>(parentPath: string, index: number, childField: string) => {
-            path: string;
-            get: () => Readonly<import('../types').FieldArrayContext<TValue>> | undefined;
-            push: (value: TValue) => void;
-            remove: (idx: number) => void;
-            replace: (values: TValue[]) => void;
-            update: (idx: number, value: TValue) => void;
-            insert: (idx: number, value: TValue) => void;
-            prepend: (value: TValue) => void;
-            move: (oldIdx: number, newIdx: number) => void;
-            swap: (indexA: number, indexB: number) => void;
+        at: {
+            <TValue = unknown>(fullPath: string): import('../types').NestedArrayHandle<TValue>;
+            <TValue = unknown>(parentPath: string, index: number, childField: string): import('../types').NestedArrayHandle<TValue>;
         };
     };
     unmount(): void;

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

@@ -52,11 +52,16 @@ type NavAnchorPropsBase = Omit<Partial<TtNavAnchorProps>, "items" | "modelValue"
 /**
  * useGroupForm 调用方传入的导航配置；`badgeCounts` 由 formApi 内部注入，调用方无需传入。
  */
-export type UseGroupFormNavAnchorProps = Omit<NavAnchorPropsBase, "badgeCounts">;
+export type UseGroupFormNavAnchorProps = Omit<NavAnchorPropsBase, "badgeCounts"> & {
+    /**
+     * 额外错误徽标数（如自定义插槽内的校验错误），按分组 key 与 {@link GroupFormApi.navErrorCounts} 累加后展示在导航栏
+     */
+    extraBadgeCounts?: Record<string, number>;
+};
 /**
- * VirtualGroupForm 组件接收的导航配置；`badgeCounts` 由 useGroupForm 绑定 `api.navErrorCounts` 注入。
+ * VirtualGroupForm 组件接收的导航配置；`badgeCounts` 由组件内合并 `navErrorCounts` 与 `extraBadgeCounts` 注入。
  */
-export type GroupFormNavAnchorProps = NavAnchorPropsBase;
+export type GroupFormNavAnchorProps = UseGroupFormNavAnchorProps;
 /** 分组表单组件选项 */
 export interface UseGroupFormOptions extends Omit<TtFormProps, "schema" | "showDefaultActions"> {
     schema: GroupFormSchema[];
@@ -70,7 +75,7 @@ export interface UseGroupFormOptions extends Omit<TtFormProps, "schema" | "showD
     estimateFieldHeight?: number;
     /**
      * 悬浮导航锚点：是否显示、标题、定位等；默认 `{ show: true, title: '导航' }`。
-     * `badgeCounts` 由 formApi 维护，无需在此传入。
+     * `badgeCounts` 由 formApi 维护；自定义插槽等额外错误可通过 `extraBadgeCounts` 按分组 key 传入。
      */
     navAnchorProps?: UseGroupFormNavAnchorProps;
     /** 滚动到分组时的顶部偏移量（px），用于补偿页面顶部固定元素（如 header）的遮挡，默认 0 */

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

@@ -72,7 +72,34 @@ export interface FormArrayActions {
     prepend: <TValue = unknown>(name: string, value: TValue) => void;
     move: (name: string, oldIdx: number, newIdx: number) => void;
     swap: (name: string, indexA: number, indexB: number) => void;
+    /**
+     * 嵌套数组操作器
+     * - 三参数：与原先一致 `at(parentPath, index, childField)`
+     * - 单参数：完整路径 `at('actions.data[0].skills')`
+     * - 返回值可链式 `.at(index, field)` 进入更深层
+     */
+    at: {
+        <TValue = unknown>(fullPath: string): NestedArrayHandle<TValue>;
+        <TValue = unknown>(parentPath: string, index: number, childField: string): NestedArrayHandle<TValue>;
+    };
 }
+/** `arrayAction.at` 返回值，多层嵌套可链式 `.at(index, field)` */
+export type NestedArrayHandle<TValue = unknown> = {
+    path: string;
+    get: () => Readonly<FieldArrayContext<TValue>> | undefined;
+    push: (value: TValue) => void;
+    remove: (idx: number) => void;
+    replace: (values: TValue[]) => void;
+    update: (idx: number, value: TValue) => void;
+    insert: (idx: number, value: TValue) => void;
+    prepend: (value: TValue) => void;
+    move: (oldIdx: number, newIdx: number) => void;
+    swap: (indexA: number, indexB: number) => void;
+    /** 进入下一层嵌套数组，如 `.at(0, 'skills').at(1, 'items')` */
+    at: (index: number, childField: string) => NestedArrayHandle<TValue>;
+};
+export type { ArrayPathSegment } from './utils/array-path';
+export { buildArrayFieldPath } from './utils/array-path';
 export type FormActions = FormContext<GenericObject> & {
     arrayAction?: FormArrayActions;
 };
@@ -495,4 +522,3 @@ export interface TtFormAdapterOptions<T extends BaseFormComponentType = BaseForm
  * @template P - 自定义组件的 Props 类型（可选，用于自定义组件类型推断）
  */
 export type InferredComponentPropsType<T extends BaseFormComponentType | Component, P = never> = T extends BaseFormComponentType ? Partial<BaseFormComponentMap[T]> & MaybeComponentProps : [P] extends [never] ? MaybeComponentProps : Partial<P> & MaybeComponentProps;
-export {};

package/dist/components/tt-form/src/utils/array-path.d.ts

@@ -1,8 +1,16 @@
+/** 一层嵌套：父路径 + 行索引 + 子字段名 */
+export type ArrayPathSegment = readonly [index: number, field: string];
 /**
- * 拼接数组子路径
- * @param parentPath 父数组路径
- * @param index 父数组索引
- * @param childField 子数组字段名
- * @returns 嵌套数组完整路径
+ * 拼接数组子路径；仅传 parentPath 时原样返回（完整路径）
+ * @returns 如 `actions.data[0].skills`
  */
-export declare function childArrayPath(parentPath: string, index: number, childField: string): string;
+export declare function childArrayPath(parentPath: string, index?: number, childField?: string): string;
+/**
+ * 从根数组路径连续拼接多层嵌套路径
+ * @param rootPath 根数组 fieldName，如 `actions.data`
+ * @param segments 每层 `[行索引, 子数组字段名]`
+ * @example
+ * buildArrayFieldPath('actions.data', [0, 'skills'], [1, 'items'])
+ * // => 'actions.data[0].skills[1].items'
+ */
+export declare function buildArrayFieldPath(rootPath: string, ...segments: ArrayPathSegment[]): string;

package/dist/hooks/useScreenshotOss.d.ts

@@ -0,0 +1,37 @@
+import { Component, VNode, MaybeRefOrGetter } from 'vue';
+import { ComponentCaptureOptions, ElementScreenshotOptions, ScreenshotTarget } from '../../../hooks/src';
+import { OssSignatureResult } from '../components/tt-upload/src/typing';
+export interface ScreenshotOssOptions extends ElementScreenshotOptions {
+    /** OSS 目录前缀，不传则使用签名接口返回的 dir 或 notice */
+    ossDir?: string;
+    /** 上传文件名，默认 screenshot-{timestamp}.png / .jpg */
+    fileName?: string;
+    /** 获取 OSS 签名，不传则使用全局 setup 的 uploadOssApi */
+    uploadOssApi?: (file: File) => Promise<OssSignatureResult>;
+}
+export interface ScreenshotOssResult {
+    blob: Blob;
+    file: File;
+    ossKey: string;
+}
+export interface ScreenshotOssDataUrlResult extends ScreenshotOssResult {
+    dataUrl: string;
+}
+/** 离屏组件截图 + OSS 上传配置 */
+export type ScreenshotOssComponentOptions = ScreenshotOssOptions & ComponentCaptureOptions;
+/**
+ * @description 元素截图并上传 OSS，依赖全局 setup 的 uploadOssApi
+ */
+export declare function useScreenshotOss(): {
+    captureToBlob: (target: MaybeRefOrGetter<ScreenshotTarget>, options?: ScreenshotOssOptions) => Promise<ScreenshotOssResult>;
+    captureToDataUrl: (target: MaybeRefOrGetter<ScreenshotTarget>, options?: ScreenshotOssOptions) => Promise<ScreenshotOssDataUrlResult>;
+    captureComponent: {
+        (component: Component | VNode, options: ScreenshotOssComponentOptions & {
+            output?: "dataUrl";
+        }): Promise<ScreenshotOssDataUrlResult>;
+        (component: Component | VNode, options: ScreenshotOssComponentOptions & {
+            output: "blob";
+        }): Promise<ScreenshotOssResult>;
+    };
+    isCapturing: import('vue').Ref<boolean, boolean>;
+};

package/dist/index.d.ts

@@ -26,6 +26,7 @@ export { useFormSchemasLink } from './hooks/useFormSchemasLink';
 export { useDataPermissionOptions } from './hooks/useDataPermissionOptions';
 export { useFormat } from './hooks/useFormat';
 export { useLoading } from './hooks/useLoading';
+export { useScreenshotOss, type ScreenshotOssComponentOptions, type ScreenshotOssDataUrlResult, type ScreenshotOssOptions, type ScreenshotOssResult, } from './hooks/useScreenshotOss';
 export { setXHR };
 /**
  * 表单组件适配器