@dazhicheng/ui 1.5.188 → 1.5.193

package/dist/components/tt-form/src/form-render/array-register/FormArrayRegister.d.ts

@@ -26,7 +26,9 @@ export declare const FormArrayRegister: import('vue').DefineComponent<{
 }> & Readonly<{}>, {
     readonly disabled: boolean | undefined;
     readonly hide: boolean | undefined;
+    readonly defaultValue: any;
     readonly wrapperClass: string;
+    readonly useArraySchema: boolean | undefined;
     readonly arraySchema: import('./props').ArraySchemaProp;
     readonly dependencies: import('./types').ArrayRegisterDependencies | undefined;
     readonly rules: import('../../types').FormSchemaRuleType | undefined;

package/dist/components/tt-form/src/form-render/array-register/props.d.ts

@@ -24,6 +24,14 @@ export declare const formArrayRegisterProps: {
         readonly type: PropType<ArraySchemaProp>;
         readonly default: () => FormSchema[];
     };
+    readonly useArraySchema: {
+        readonly type: PropType<boolean | undefined>;
+        readonly default: undefined;
+    };
+    readonly defaultValue: {
+        readonly type: PropType<FormSchema["defaultValue"]>;
+        readonly default: undefined;
+    };
     readonly formItemClass: {
         readonly type: PropType<NonNullable<FormSchema["formItemClass"]>>;
         readonly default: undefined;

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

@@ -147,7 +147,7 @@ export declare class FormApi {
      * @param name 需要注册的数组字段
      * @param actions 操作方法
      */
-    registerArrayField(name: string, actions: ResolvedFieldArrayContext): void;
+    registerArrayField(name: string, actions: ResolvedFieldArrayContext, schema?: FormSchema): void;
     unregisterArrayField(name: string, actions?: ResolvedFieldArrayContext): void;
     /** @description 数组字段操作集合 */
     get arrayAction(): {
@@ -162,7 +162,7 @@ export declare class FormApi {
          * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
          * @param value 要追加的数组项值
          */
-        push: <TValue = unknown>(name: string, value: TValue) => void;
+        push: <TValue = unknown>(name: string, value?: TValue) => void;
         /**
          * @description 删除指定索引的项
          * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
@@ -190,14 +190,14 @@ export declare class FormApi {
          * @param idx 插入位置索引
          * @param value 要插入的数组项值
          */
-        insert: <TValue = unknown>(name: string, idx: number, value: TValue) => void;
+        insert: <TValue = unknown>(name: string, idx: number, value?: TValue) => void;
         /**
          * @description 在数组头部新增一项
          * @template TValue 数组项类型
          * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
          * @param value 要插入到头部的数组项值
          */
-        prepend: <TValue = unknown>(name: string, value: TValue) => void;
+        prepend: <TValue = unknown>(name: string, value?: TValue) => void;
         /**
          * @description 将项从旧索引移动到新索引
          * @param name 数组字段名（例如 `fieldName的值 数组下才生效`）
@@ -224,8 +224,31 @@ export declare class FormApi {
      * @description 将业务传入路径规范化为数组注册表键
      */
     protected _resolveArrayFieldPath(name: string): string;
+    private _getRegisteredArrayFieldItem;
     private _getRegisteredArrayField;
     private _getArrayFieldActions;
+    /**
+     * @description 获取数组字段 schema
+     */
+    protected _getArrayFieldSchema(name: string): FormSchema | undefined;
+    /**
+     * @description 解析数组新增项默认值
+     */
+    protected _resolveArrayDefaultItemValue(name: string): unknown;
+    /**
+     * @description 按新增操作场景解析数组新增项默认值
+     */
+    protected _resolveArrayDefaultItemValueByMutation(name: string, value?: unknown, options?: {
+        index?: number;
+        arrayLength?: number;
+    }): unknown;
+    /**
+     * @description 合并数组新增项值，优先使用 schema 默认值补齐
+     */
+    protected _resolveArrayItemValue<TValue = unknown>(name: string, value?: TValue, options?: {
+        index?: number;
+        arrayLength?: number;
+    }): TValue;
     /**
      * @description 开发环境：数组字段未注册时输出告警与相近路径提示
      */

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

@@ -339,12 +339,12 @@ export declare class GroupFormApi extends FormApi {
      */
     get arrayAction(): {
         get: <TValue = unknown>(name: string) => Readonly<import('../..').FieldArrayContext<TValue>> | undefined;
-        push: <TValue = unknown>(name: string, value: TValue) => void;
+        push: <TValue = unknown>(name: string, value?: TValue) => void;
         remove: (name: string, idx: number) => void;
         replace: <TValue = unknown>(name: string, values: TValue[]) => void;
         update: <TValue = unknown>(name: string, idx: number, value: TValue) => void;
-        insert: <TValue = unknown>(name: string, idx: number, value: TValue) => void;
-        prepend: <TValue = unknown>(name: string, value: TValue) => void;
+        insert: <TValue = unknown>(name: string, idx: number, value?: TValue) => void;
+        prepend: <TValue = unknown>(name: string, value?: TValue) => void;
         move: (name: string, oldIdx: number, newIdx: number) => void;
         swap: (name: string, indexA: number, indexB: number) => void;
         /**

package/dist/components/tt-form/src/hooks/useArrayRegistry.d.ts

@@ -1,2 +1,3 @@
+import { FormSchema } from '../types';
 import { ResolvedFieldArrayContext } from '../types/forms';
-export declare function useArrayRegistry(name: string): readonly [(actions?: ResolvedFieldArrayContext) => void, () => void];
+export declare function useArrayRegistry(name: string, schema?: FormSchema): readonly [(actions?: ResolvedFieldArrayContext) => void, () => void];

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

@@ -64,12 +64,12 @@ export type MaybeComponentProps = {
 /** 数组操作方法 */
 export interface FormArrayActions {
     get: <TValue = unknown>(name: string) => Readonly<FieldArrayContext<TValue>> | undefined;
-    push: <TValue = unknown>(name: string, value: TValue) => void;
+    push: <TValue = unknown>(name: string, value?: TValue) => void;
     remove: (name: string, idx: number) => void;
     replace: <TValue = unknown>(name: string, values: TValue[]) => void;
     update: <TValue = unknown>(name: string, idx: number, value: TValue) => void;
-    insert: <TValue = unknown>(name: string, idx: number, value: TValue) => void;
-    prepend: <TValue = unknown>(name: string, value: TValue) => void;
+    insert: <TValue = unknown>(name: string, idx: number, value?: TValue) => void;
+    prepend: <TValue = unknown>(name: string, value?: TValue) => void;
     move: (name: string, oldIdx: number, newIdx: number) => void;
     swap: (name: string, indexA: number, indexB: number) => void;
     /**
@@ -87,12 +87,12 @@ export interface FormArrayActions {
 export type NestedArrayHandle<TValue = unknown> = {
     path: string;
     get: () => Readonly<FieldArrayContext<TValue>> | undefined;
-    push: (value: TValue) => void;
+    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;
+    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')` */

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

@@ -1,5 +1,5 @@
 import { ComputedRef } from 'vue';
-import { FormSchema, ExtendedFormApi, FormActions, TtFormProps } from './types';
+import { ArraySchemaContext, FormArrayActions, FormSchema, NestedArrayHandle, ExtendedFormApi, FormActions, TtFormProps } from './types';
 type ExtendFormProps = TtFormProps & {
     formApi?: ExtendedFormApi;
 };
@@ -8,6 +8,65 @@ export declare const injectFormProps: <T extends [ExtendFormProps | ComputedRef<
 export declare const injectComponentRefMap: <T extends Map<string, unknown> | null | undefined = Map<string, unknown>>(fallback?: T | undefined) => T extends null ? Map<string, unknown> | null : Map<string, unknown>, provideComponentRefMap: (contextValue: Map<string, unknown>) => Map<string, unknown>;
 /** 提取单个字段默认值：defaultValue 优先，其次 Zod rules */
 export declare function resolveSchemaItemDefaultValue(item: FormSchema): unknown | undefined;
+/** 数组 schema 运行时上下文参数 */
+type ArraySchemaRuntimeOptions = {
+    /**
+     * 当前数组字段 schema
+     */
+    item: FormSchema;
+    /**
+     * 当前数组完整路径
+     */
+    arrayPath: string;
+    /**
+     * 当前行完整路径
+     */
+    itemPath: string;
+    /**
+     * 当前行值
+     */
+    row: Record<string, unknown>;
+    /**
+     * 当前行索引
+     */
+    index: number;
+    /**
+     * 当前数组长度
+     */
+    arrayLength: number;
+    /**
+     * 父行路径
+     */
+    parentItemPath?: string;
+    /**
+     * 表单值代理
+     */
+    form?: Record<string, unknown>;
+    /**
+     * 表单数组操作器
+     */
+    arrayAction?: FormArrayActions;
+    /**
+     * 当前数组句柄
+     */
+    arrayHandle?: NestedArrayHandle;
+    /**
+     * 是否禁用运行时变更
+     */
+    safeMutations?: boolean;
+};
+type PublicArraySchemaRuntimeOptions = Omit<ArraySchemaRuntimeOptions, "safeMutations">;
+/** 从数组路径提取父行路径 */
+export declare function resolveParentItemPathFromArrayPath(arrayPath: string): string | undefined;
+/** 创建数组 schema 运行时上下文 */
+export declare function createArraySchemaContext(options: PublicArraySchemaRuntimeOptions): ArraySchemaContext;
+/** 统一解析数组字段的 schema（支持静态数组和函数） */
+export declare function resolveArraySchemasForRuntime(options: PublicArraySchemaRuntimeOptions): FormSchema[];
+export declare function resolveArrayFieldInitialValueWithRuntime(item: FormSchema, options: Omit<PublicArraySchemaRuntimeOptions, "item" | "row" | "index" | "arrayLength" | "itemPath"> & {
+    row?: Record<string, unknown>;
+    index?: number;
+    arrayLength?: number;
+}): unknown;
 /**
  * 解析 useArraySchema 字段的 initialValues
  * - 有 defaultValue 数组：沿用并在每行合并静态 arraySchema 嵌套默认值

package/dist/components/tt-modal/src/utils/modal-stack.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 弹窗 ESC 栈管理器
+ *
+ * 解决 element-plus ElDialog 两个问题：
+ * 1. 多个弹窗同时打开时，按 ESC 会一次性关闭所有弹窗。
+ *    期望：按一次 ESC 只关闭最顶层（最后打开）的弹窗，逐个关闭。
+ * 2. 弹窗内表单元素（input / select 等）聚焦时按 ESC 也会关闭弹窗。
+ *    vue2 的 element-ui 不存在该问题。
+ *    期望：焦点位于表单交互元素上时，ESC 交给该元素处理（如关闭下拉），不关闭弹窗。
+ *
+ * 实现方式：在 ElDialog 上禁用原生 close-on-press-escape，由本管理器统一处理。
+ */
+export interface ModalStackItem {
+    /** 弹窗实例 uid */
+    uid: number;
+    /** 关闭弹窗的回调 */
+    close: () => void;
+}
+/**
+ * 弹窗打开时入栈，并确保全局监听已绑定。
+ */
+export declare function pushModal(item: ModalStackItem): void;
+/**
+ * 弹窗关闭时出栈，栈为空时解绑全局监听。
+ */
+export declare function removeModal(uid: number): void;

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

@@ -14,7 +14,9 @@ export declare const TtNavAnchor: import('../../../../utils/src').SFCWithInstall
         modelValue: string;
         position: "fixed" | "static" | "sticky";
         badgeCounts: Record<string, number>;
+        teleportTo: string | HTMLElement;
     }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {
+        sourceRef: HTMLSpanElement;
         navRef: HTMLDivElement;
         headerRef: HTMLDivElement;
     }, any, import('vue').ComponentProvideOptions, {
@@ -36,6 +38,7 @@ export declare const TtNavAnchor: import('../../../../utils/src').SFCWithInstall
         modelValue: string;
         position: "fixed" | "static" | "sticky";
         badgeCounts: Record<string, number>;
+        teleportTo: string | HTMLElement;
     }>;
     __isFragment?: never;
     __isTeleport?: never;
@@ -55,6 +58,7 @@ export declare const TtNavAnchor: import('../../../../utils/src').SFCWithInstall
     modelValue: string;
     position: "fixed" | "static" | "sticky";
     badgeCounts: Record<string, number>;
+    teleportTo: string | HTMLElement;
 }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
     $slots: Readonly<{
         description?: (scope: import('.').NavAnchorItemScope) => import('vue').VNodeChild;

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

@@ -10,6 +10,7 @@ declare function __VLS_template(): {
         description?: (scope: NavAnchorItemScope) => VNodeChild;
     };
     refs: {
+        sourceRef: HTMLSpanElement;
         navRef: HTMLDivElement;
         headerRef: HTMLDivElement;
     };
@@ -31,7 +32,9 @@ declare const __VLS_component: import('vue').DefineComponent<TtNavAnchorProps, {
     modelValue: string;
     position: "fixed" | "static" | "sticky";
     badgeCounts: Record<string, number>;
+    teleportTo: string | HTMLElement;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    sourceRef: HTMLSpanElement;
     navRef: HTMLDivElement;
     headerRef: HTMLDivElement;
 }, any>;

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

@@ -37,4 +37,6 @@ export interface TtNavAnchorProps {
     left?: number | string;
     /** fixed/sticky 时距底部的距离 */
     bottom?: number | string;
+    /** Teleport 挂载目标，未传时默认使用组件内置策略 */
+    teleportTo?: string | HTMLElement;
 }