@robot-admin/naive-ui-components 0.17.6 → 0.19.0

package/dist/useDraggableLayout.d.ts

@@ -1,4 +1,5 @@
 import * as vue from "vue";
+import { DeepReadonly, VNodeChild } from "vue";
 import { DraggableEvent } from "vue-draggable-plus";
 
 //#region src/components/C_Draggable/types.d.ts
@@ -8,12 +9,12 @@ interface DraggableItem {
   name?: string;
   label?: string;
   description?: string;
-  [key: string]: any;
+  [key: string]: unknown;
 }
-interface DragEvent {
+interface DragEvent<T extends object = DraggableItem> {
   oldIndex: number;
   newIndex: number;
-  item: DraggableItem;
+  item: T;
 }
 interface GroupOptions {
   name: string;
@@ -21,11 +22,11 @@ interface GroupOptions {
   put?: boolean | string | string[];
   revertClone?: boolean;
 }
-type LayoutMode = "vertical" | "horizontal" | "grid" | "flex-wrap";
-type JustifyContent = "flex-start" | "flex-end" | "center" | "space-between" | "space-around" | "space-evenly";
-type AlignItems = "flex-start" | "flex-end" | "center" | "stretch" | "baseline";
-interface DraggableProps {
-  modelValue?: DraggableItem[];
+type LayoutMode = 'vertical' | 'horizontal' | 'grid' | 'flex-wrap';
+type JustifyContent = 'flex-start' | 'flex-end' | 'center' | 'space-between' | 'space-around' | 'space-evenly';
+type AlignItems = 'flex-start' | 'flex-end' | 'center' | 'stretch' | 'baseline';
+interface DraggableProps<T extends object = DraggableItem> {
+  modelValue?: T[];
   disabled?: boolean;
   group?: string | GroupOptions;
   sort?: boolean;
@@ -41,12 +42,12 @@ interface DraggableProps {
   itemClass?: string;
   showEmptyState?: boolean;
   emptyText?: string;
-  itemKey?: (item: DraggableItem, index: number) => string | number;
-  itemTitle?: (item: DraggableItem) => string;
-  itemDescription?: (item: DraggableItem) => string;
+  itemKey?: (item: T, index: number) => string | number;
+  itemTitle?: (item: T) => string;
+  itemDescription?: (item: T) => string;
   swapThreshold?: number;
   invertSwap?: boolean;
-  direction?: "vertical" | "horizontal";
+  direction?: 'vertical' | 'horizontal';
   layout?: LayoutMode;
   gridColumns?: number;
   gridRows?: number;
@@ -56,143 +57,111 @@ interface DraggableProps {
   alignItems?: AlignItems;
   customStyles?: Record<string, string | number>;
 }
-interface DraggableEmits {
-  "update:modelValue": [value: DraggableItem[]];
-  "drag-start": [event: DragEvent];
-  "drag-end": [event: DragEvent];
-  "item-add": [item: DraggableItem, index: number];
-  "item-remove": [item: DraggableItem, index: number];
-  "list-change": [list: DraggableItem[]];
+interface DraggableEmits<T extends object = DraggableItem> {
+  'update:modelValue': [value: T[]];
+  'drag-start': [event: DragEvent<T>];
+  'drag-end': [event: DragEvent<T>];
+  'item-add': [item: T, index: number];
+  'item-remove': [item: T, index: number];
+  'list-change': [list: T[]];
 }
-//#endregion
-//#region src/components/C_Draggable/index.vue.d.ts
-declare var __VLS_13: {
-    item: DraggableItem;
+/** 插槽直接保留 v-model 的业务项类型。 */
+interface DraggableSlots<T extends object = DraggableItem> {
+  default?: (context: {
+    item: T;
     index: number;
     isDragging: boolean;
     isDisabled: boolean;
-  }, __VLS_15: {};
-type __VLS_Slots = {} & {
-  default?: (props: typeof __VLS_13) => any;
-} & {
-  empty?: (props: typeof __VLS_15) => any;
-};
-declare const __VLS_base: vue.DefineComponent<DraggableProps, {
-  isDragging: Readonly<vue.Ref<boolean, boolean>>;
-  list: Readonly<vue.Ref<readonly {
-    readonly [x: string]: any;
-    readonly id: string | number;
-    readonly title?: string | undefined;
-    readonly name?: string | undefined;
-    readonly label?: string | undefined;
-    readonly description?: string | undefined;
-  }[], readonly {
-    readonly [x: string]: any;
-    readonly id: string | number;
-    readonly title?: string | undefined;
-    readonly name?: string | undefined;
-    readonly label?: string | undefined;
-    readonly description?: string | undefined;
-  }[]>>;
-  isEmpty: Readonly<vue.Ref<boolean, boolean>>;
-  addItem: (item: DraggableItem, index?: number) => void;
-  removeItem: (index: number) => DraggableItem | null;
+  }) => VNodeChild;
+  empty?: () => VNodeChild;
+}
+/** Vue 公开实例中的状态已经解包；列表只读，修改统一通过方法。 */
+interface DraggableExpose<T extends object = DraggableItem> {
+  isDragging: boolean;
+  list: readonly DeepReadonly<T>[];
+  isEmpty: boolean;
+  addItem: (item: T, index?: number) => void;
+  removeItem: (index: number) => T | null;
   moveItem: (fromIndex: number, toIndex: number) => boolean;
-  updateList: (newList: DraggableItem[]) => void;
+  updateList: (list: T[]) => void;
   clear: () => void;
-  getItem: (index: number) => DraggableItem | undefined;
-  findIndex: (predicate: (item: DraggableItem) => boolean) => number;
-}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  "update:modelValue": (value: DraggableItem[]) => any;
-  "drag-start": (event: DragEvent) => any;
-  "drag-end": (event: DragEvent) => any;
-  "item-add": (item: DraggableItem, index: number) => any;
-  "item-remove": (item: DraggableItem, index: number) => any;
-  "list-change": (list: DraggableItem[]) => any;
-}, string, vue.PublicProps, Readonly<DraggableProps> & Readonly<{
-  "onUpdate:modelValue"?: ((value: DraggableItem[]) => any) | undefined;
-  "onDrag-start"?: ((event: DragEvent) => any) | undefined;
-  "onDrag-end"?: ((event: DragEvent) => any) | undefined;
-  "onItem-add"?: ((item: DraggableItem, index: number) => any) | undefined;
-  "onItem-remove"?: ((item: DraggableItem, index: number) => any) | undefined;
-  "onList-change"?: ((list: DraggableItem[]) => any) | undefined;
-}>, {
-  modelValue: DraggableItem[];
-  disabled: boolean;
-  sort: boolean;
-  delay: number;
-  justifyContent: JustifyContent;
-  animation: number;
-  emptyText: string;
-  direction: "vertical" | "horizontal";
-  layout: LayoutMode;
-  group: string | GroupOptions;
-  handle: string;
-  showHandle: boolean;
-  ghostClass: string;
-  chosenClass: string;
-  dragClass: string;
-  wrapperClass: string;
-  listClass: string;
-  itemClass: string;
-  showEmptyState: boolean;
-  swapThreshold: number;
-  invertSwap: boolean;
-  gridColumns: number;
-  gridRows: number;
-  gap: string | number;
-  flexWrap: boolean;
-  alignItems: AlignItems;
-  customStyles: Record<string, string | number>;
-}, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
-declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
-declare const _default: typeof __VLS_export;
-type __VLS_WithSlots<T, S> = T & {
-  new (): {
-    $slots: S;
-  };
+  getItem: (index: number) => T | undefined;
+  findIndex: (predicate: (item: T) => boolean) => number;
+}
+//#endregion
+//#region src/components/C_Draggable/index.vue.d.ts
+declare const __VLS_export: <T extends object = DraggableItem>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+  props: vue.PublicProps & __VLS_PrettifyLocal<DraggableProps<T> & {
+    "onUpdate:modelValue"?: ((value: T[]) => any) | undefined;
+    "onDrag-start"?: ((event: DragEvent<T>) => any) | undefined;
+    "onDrag-end"?: ((event: DragEvent<T>) => any) | undefined;
+    "onItem-add"?: ((item: T, index: number) => any) | undefined;
+    "onItem-remove"?: ((item: T, index: number) => any) | undefined;
+    "onList-change"?: ((list: T[]) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: vue.ShallowUnwrapRef<{
+    isDragging: Readonly<vue.Ref<boolean, boolean>>;
+    list: Readonly<vue.Ref<readonly vue.DeepReadonly<T>[], readonly vue.DeepReadonly<T>[]>>;
+    isEmpty: Readonly<vue.Ref<boolean, boolean>>;
+    addItem: (item: T, index?: number) => void;
+    removeItem: (index: number) => T | null;
+    moveItem: (fromIndex: number, toIndex: number) => boolean;
+    updateList: (newList: T[]) => void;
+    clear: () => void;
+    getItem: (index: number) => T | undefined;
+    findIndex: (predicate: (item: T) => boolean) => number;
+  }>) => void;
+  attrs: any;
+  slots: DraggableSlots<T>;
+  emit: ((evt: "update:modelValue", value: T[]) => void) & ((evt: "drag-start", event: DragEvent<T>) => void) & ((evt: "drag-end", event: DragEvent<T>) => void) & ((evt: "item-add", item: T, index: number) => void) & ((evt: "item-remove", item: T, index: number) => void) & ((evt: "list-change", list: T[]) => void);
+}>) => vue.VNode & {
+  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };
+declare const _default: typeof __VLS_export;
+type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K] } : { [K in keyof T as K]: T[K] }) & {};
 //#endregion
 //#region src/components/C_Draggable/composables/useDraggableLayout.d.ts
-type LayoutDragEvent = Partial<Pick<DraggableEvent<DraggableItem>, 'data' | 'clonedData' | 'oldIndex' | 'newIndex' | 'oldDraggableIndex' | 'newDraggableIndex' | 'from' | 'to' | 'pullMode'>>;
-type EmitFn = {
-  (event: 'update:modelValue', value: DraggableItem[]): void;
-  (event: 'drag-start', dragEvent: DragEvent): void;
-  (event: 'drag-end', dragEvent: DragEvent): void;
-  (event: 'item-add', item: DraggableItem, index: number): void;
-  (event: 'item-remove', item: DraggableItem, index: number): void;
-  (event: 'list-change', list: DraggableItem[]): void;
+type LayoutDragEvent<T extends object> = Partial<Pick<DraggableEvent<T>, 'data' | 'clonedData' | 'oldIndex' | 'newIndex' | 'oldDraggableIndex' | 'newDraggableIndex' | 'from' | 'to' | 'pullMode'>>;
+type EmitFn$1<T extends object> = {
+  (event: 'update:modelValue', value: T[]): void;
+  (event: 'drag-start', dragEvent: DragEvent<T>): void;
+  (event: 'drag-end', dragEvent: DragEvent<T>): void;
+  (event: 'item-add', item: T, index: number): void;
+  (event: 'item-remove', item: T, index: number): void;
+  (event: 'list-change', list: T[]): void;
 };
 /**
  *
  */
-declare function useDraggableLayout(props: DraggableProps, emit: EmitFn): {
+declare function useDraggableLayout<T extends object = DraggableItem>(props: DraggableProps<T>, emit: EmitFn$1<T>): {
   isDragging: vue.Ref<boolean, boolean>;
-  internalList: vue.WritableComputedRef<DraggableItem[], DraggableItem[]>;
+  internalList: vue.WritableComputedRef<T[], T[]>;
   isEmpty: vue.ComputedRef<boolean>;
   listClasses: vue.ComputedRef<(string | {
     'flex-wrap': boolean | undefined;
   } | undefined)[]>;
   listStyles: vue.ComputedRef<Record<string, string | number>>;
-  draggableOptions: vue.ComputedRef<Record<string, any>>;
-  getItemKey: (item: DraggableItem, index: number) => string | number;
-  getItemTitle: (item: DraggableItem) => string;
-  getItemDescription: (item: DraggableItem) => string;
+  draggableOptions: vue.ComputedRef<Record<string, unknown>>;
+  getItemKey: (item: T, index: number) => string | number;
+  getItemTitle: (item: T) => string;
+  getItemDescription: (item: T) => string;
   getItemClass: () => (string | {
     'is-disabled': boolean | undefined;
   } | undefined)[];
-  handleStart: (event: LayoutDragEvent) => void;
-  handleEnd: (event: LayoutDragEvent) => void;
-  handleAdd: (event: LayoutDragEvent) => void;
-  handleRemove: (event: LayoutDragEvent) => void;
+  handleStart: (event: LayoutDragEvent<T>) => void;
+  handleEnd: (event: LayoutDragEvent<T>) => void;
+  handleAdd: (event: LayoutDragEvent<T>) => void;
+  handleRemove: (event: LayoutDragEvent<T>) => void;
   handleUpdate: () => void;
-  addItem: (item: DraggableItem, index?: number) => void;
-  removeItem: (index: number) => DraggableItem | null;
+  addItem: (item: T, index?: number) => void;
+  removeItem: (index: number) => T | null;
   moveItem: (fromIndex: number, toIndex: number) => boolean;
-  updateList: (newList: DraggableItem[]) => void;
+  updateList: (newList: T[]) => void;
   clear: () => void;
-  getItem: (index: number) => DraggableItem | undefined;
-  findIndex: (predicate: (item: DraggableItem) => boolean) => number;
+  getItem: (index: number) => T | undefined;
+  findIndex: (predicate: (item: T) => boolean) => number;
 };
 //#endregion
-export { DraggableEmits as a, GroupOptions as c, DragEvent as i, JustifyContent as l, _default as n, DraggableItem as o, AlignItems as r, DraggableProps as s, useDraggableLayout as t, LayoutMode as u };
+export { DraggableEmits as a, DraggableProps as c, JustifyContent as d, LayoutMode as f, DragEvent as i, DraggableSlots as l, _default as n, DraggableExpose as o, AlignItems as r, DraggableItem as s, useDraggableLayout as t, GroupOptions as u };

package/dist/useDynamicFormState.d.cts

@@ -8,18 +8,24 @@ import { NAIVE_COMBOS, NaiveRule, PRESET_RULES, RuleSpec, RuleSpec as RuleSpec$1
 //#region src/components/C_Form/utils/formValidation.d.ts
 /** 原生规则、验证库规则和框架无关规则均可直接作为字段配置。 */
 type FormValidationRule = FormItemRule | NaiveRule | RuleSpec;
-type NativePresetRule = FormItemRule & Pick<NaiveRule, 'trigger' | 'validator' | 'required' | 'message'>;
-type NativeRuleFactories<T> = { readonly [Key in keyof T]: T[Key] extends ((...args: infer Args) => infer Result) ? (...args: Args) => Result extends readonly NaiveRule[] ? NativePresetRule[] : Result extends NaiveRule ? NativePresetRule : Result : T[Key] };
-/** 运行时保持验证库的工厂对象，只有公开类型在组件包内统一适配。 */
-declare const PRESET_RULES$1: NativeRuleFactories<typeof PRESET_RULES>;
-declare const NAIVE_COMBOS$1: NativeRuleFactories<typeof NAIVE_COMBOS>;
 //#endregion
 //#region src/components/C_Form/types.d.ts
 type MaybePromise<T> = T | Promise<T>;
 type FormRecord = Record<string, unknown>;
 type AtomicFormValue = string | number | boolean | bigint | symbol | null | undefined | Date | RegExp | File | Blob;
-type NestedFieldPath<T extends object> = { [K in Extract<keyof T, string>]: NonNullable<T[K]> extends AtomicFormValue ? K : NonNullable<T[K]> extends readonly (infer Item)[] ? NonNullable<Item> extends AtomicFormValue ? K | `${K}.${number}` : NonNullable<Item> extends object ? K | `${K}.${number}` | `${K}.${number}.${NestedFieldPath<NonNullable<Item>>}` : K : NonNullable<T[K]> extends object ? K | `${K}.${NestedFieldPath<NonNullable<T[K]>>}` : K }[Extract<keyof T, string>];
-type FieldPath<T extends object = FormRecord> = string extends keyof T ? string : NestedFieldPath<T>;
+/**
+ * 最多展开五次子模型，保留六层字段路径及递归业务模型支持。
+ * 每层引用独立别名，避免 TypeScript 5.8 方差检查递归路径自身时栈溢出。
+ */
+type FieldPathChild<T> = NonNullable<T> extends AtomicFormValue ? never : NonNullable<T> extends readonly (infer Item)[] ? NonNullable<Item> extends AtomicFormValue ? never : NonNullable<Item> extends object ? NonNullable<Item> : never : NonNullable<T> extends object ? NonNullable<T> : never;
+type FieldPathStep<T extends object, Children extends { [K in keyof T]: string }> = { [K in Extract<keyof T, string>]: NonNullable<T[K]> extends AtomicFormValue ? K : NonNullable<T[K]> extends readonly (infer Item)[] ? NonNullable<Item> extends AtomicFormValue ? K | `${K}.${number}` : NonNullable<Item> extends object ? K | `${K}.${number}` | `${K}.${number}.${Children[K]}` : K : NonNullable<T[K]> extends object ? K | `${K}.${Children[K]}` : K }[Extract<keyof T, string>];
+type NestedFieldPath0<T extends object> = Extract<keyof T, string>;
+type NestedFieldPath1<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath0<FieldPathChild<T[K]>> }>;
+type NestedFieldPath2<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath1<FieldPathChild<T[K]>> }>;
+type NestedFieldPath3<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath2<FieldPathChild<T[K]>> }>;
+type NestedFieldPath4<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath3<FieldPathChild<T[K]>> }>;
+type NestedFieldPath5<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath4<FieldPathChild<T[K]>> }>;
+type FieldPath<T extends object = FormRecord> = keyof T extends never ? string : string extends keyof T ? string : NestedFieldPath5<T>;
 type NestedFieldPathValue<T, P extends string> = T extends readonly (infer Item)[] ? P extends `${number}.${infer Rest}` ? NestedFieldPathValue<NonNullable<Item>, Rest> : P extends `${number}` ? Item : unknown : P extends keyof T ? T[P] : P extends `${infer K}.${infer Rest}` ? K extends keyof T ? NestedFieldPathValue<NonNullable<T[K]>, Rest> : unknown : unknown;
 type FieldPathValue<T extends object, P extends string> = NestedFieldPathValue<T, P>;
 /**
@@ -273,12 +279,10 @@ interface LayoutConfig {
  * 表单配置项接口
  * @description 单个表单项的完整配置
  */
-interface FormOption<T extends object = FormRecord> {
+interface FormOptionBase<T extends object> {
   id?: string;
   type: ComponentType | string;
-  prop: FieldPath<T>;
   label?: string;
-  value?: unknown;
   placeholder?: string;
   rules?: readonly FormValidationRule[];
   attrs?: Record<string, unknown>;
@@ -293,8 +297,6 @@ interface FormOption<T extends object = FormRecord> {
   disabled?: boolean | ((formModel: FormModel<T>) => boolean);
   /** 字段级只读（优先级高于全局 config.readonly） */
   readonly?: boolean | ((formModel: FormModel<T>) => boolean);
-  /** 联动赋值：其他字段变化时自动计算本字段的值 */
-  valueWhen?: (formModel: FormModel<T>) => unknown;
   /** 异步数据源：select / cascader / checkbox / radio 的远程选项加载 */
   asyncOptions?: (formModel: FormModel<T>, context?: AsyncOptionsContext) => Promise<readonly OptionItem[]>;
   /** 联动校验规则：根据表单数据动态返回校验规则 */
@@ -302,6 +304,12 @@ interface FormOption<T extends object = FormRecord> {
   /** 跨字段校验：需要引用多个字段值的验证函数，返回错误消息或 null */
   crossFieldValidator?: (formModel: FormModel<T>) => MaybePromise<string | null>;
 }
+/** 字段名与初值、联动返回值关联；未声明业务模型时保持动态表单的宽松契约。 */
+type FormOption<T extends object = FormRecord> = FormOptionBase<T> & { [P in FieldPath<T>]: {
+  prop: P;
+  value?: FieldPathValue<T, P>; /** 联动赋值：其他字段变化时自动计算本字段的值。 */
+  valueWhen?: (formModel: FormModel<T>) => FieldPathValue<T, P>;
+} }[FieldPath<T>];
 /**
  * 表单提交事件参数
  */
@@ -467,7 +475,7 @@ interface LayoutCallbacks<T extends object = FormRecord> {
   onGroupToggle?: (groupKey: string, collapsed: boolean) => void;
   onGroupReset?: (groupKey: string) => void;
   onFieldsChange?: (fields: FormOption<T>[]) => void;
-  onSubmit?: (payload: SubmitEventPayload<T>, context?: FormSubmitContext) => MaybePromise<void>;
+  onSubmit?: (payload: SubmitEventPayload<T>, context?: FormSubmitContext) => unknown;
   onError?: (error: unknown, context: FormErrorContext) => void;
 }
 /**
@@ -722,7 +730,7 @@ type FormEmit = {
 declare function useFormState(options: ComputedRef<FormOption[]>, config: ComputedRef<ResolvedFormConfig>, formRef: Ref<FormInst | null>, emit: FormEmit, externalModel?: ComputedRef<FormModel | undefined>, validationReady?: ComputedRef<boolean>): {
   formModel: FormRecord;
   formRules: FormRules;
-  visibleOptions: ComputedRef<FormOption<FormRecord>[]>;
+  visibleOptions: ComputedRef<FormOption[]>;
   initialize: () => void;
   handleFieldChange: (field: string) => void;
   setFormItemRef: (field: string, instance: FormItemInst | null) => void;
@@ -809,4 +817,4 @@ type DynamicFormStateType = DynamicFormController;
  */
 declare const DYNAMIC_FORM_STATE_KEY: unique symbol;
 //#endregion
-export { FormStepActionsSlotProps as $, ResolvedFormConfig as A, DynamicFormConfig as B, unregisterRenderer as C, FormConfig as D, FORM_GLOBAL_CONFIG_KEY as E, AsyncOptionsContext as F, FormActionSlotProps as G, DynamicFormState as H, CardLayoutConfig as I, FormMode as J, FormErrorContext as K, ComponentType as L, resolveFormConfig as M, shouldShowActions as N, LAYOUTS_WITH_OWN_CONTROLS as O, useFormGlobalConfig as P, FormSlots as Q, CustomLayoutConfig as R, registerRenderer as S, FORM_DEFAULTS as T, FieldPath as U, DynamicFormController as V, FieldPathValue as W, FormOption as X, FormModel as Y, FormRecord as Z, FormRendererContext as _, UseFormDirtyReturn as a, LayoutConfig as at, UseFormRendererOptions as b, UseCFormOptions as c, OptionItem as ct, defineFormOptions as d, TabsLayoutConfig as dt, FormSubmitContext as et, useCForm as f, FormValidationRule as ft, FormRenderer as g, SPEC_RULES as gt, FORM_RENDERER_REGISTRY_KEY as h, RuleSpec$1 as ht, useDynamicFormState as i, LabelPlacement as it, mergeFormConfig as j, LayoutCallbacks as k, UseCFormReturn as l, StepsLayoutConfig as lt, ComponentMap as m, PRESET_RULES$1 as mt, DynamicFormStateType as n, GridLayoutConfig as nt, useFormDirty as o, LayoutType as ot, _default as p, NAIVE_COMBOS$1 as pt, FormInstance as q, FIELD_TYPE_OPTIONS as r, InlineLayoutConfig as rt, useFormState as s, MaybePromise as st, DYNAMIC_FORM_STATE_KEY as t, FormTabActionsSlotProps as tt, defineFormConfig as u, SubmitEventPayload as ut, FormRendererRegistry as v, useFormRenderer as w, createFormRendererRegistry as x, RendererProps as y, DynamicFieldConfig as z };
+export { FormStepActionsSlotProps as $, ResolvedFormConfig as A, DynamicFormConfig as B, unregisterRenderer as C, FormConfig as D, FORM_GLOBAL_CONFIG_KEY as E, AsyncOptionsContext as F, FormActionSlotProps as G, DynamicFormState as H, CardLayoutConfig as I, FormMode as J, FormErrorContext as K, ComponentType as L, resolveFormConfig as M, shouldShowActions as N, LAYOUTS_WITH_OWN_CONTROLS as O, useFormGlobalConfig as P, FormSlots as Q, CustomLayoutConfig as R, registerRenderer as S, FORM_DEFAULTS as T, FieldPath as U, DynamicFormController as V, FieldPathValue as W, FormOption as X, FormModel as Y, FormRecord as Z, FormRendererContext as _, UseFormDirtyReturn as a, LayoutConfig as at, UseFormRendererOptions as b, UseCFormOptions as c, OptionItem as ct, defineFormOptions as d, TabsLayoutConfig as dt, FormSubmitContext as et, useCForm as f, FormValidationRule as ft, FormRenderer as g, SPEC_RULES as gt, FORM_RENDERER_REGISTRY_KEY as h, RuleSpec$1 as ht, useDynamicFormState as i, LabelPlacement as it, mergeFormConfig as j, LayoutCallbacks as k, UseCFormReturn as l, StepsLayoutConfig as lt, ComponentMap as m, PRESET_RULES as mt, DynamicFormStateType as n, GridLayoutConfig as nt, useFormDirty as o, LayoutType as ot, _default as p, NAIVE_COMBOS as pt, FormInstance as q, FIELD_TYPE_OPTIONS as r, InlineLayoutConfig as rt, useFormState as s, MaybePromise as st, DYNAMIC_FORM_STATE_KEY as t, FormTabActionsSlotProps as tt, defineFormConfig as u, SubmitEventPayload as ut, FormRendererRegistry as v, useFormRenderer as w, createFormRendererRegistry as x, RendererProps as y, DynamicFieldConfig as z };

package/dist/useDynamicFormState.d.ts

@@ -8,18 +8,24 @@ import { NAIVE_COMBOS, NaiveRule, PRESET_RULES, RuleSpec, RuleSpec as RuleSpec$1
 //#region src/components/C_Form/utils/formValidation.d.ts
 /** 原生规则、验证库规则和框架无关规则均可直接作为字段配置。 */
 type FormValidationRule = FormItemRule | NaiveRule | RuleSpec;
-type NativePresetRule = FormItemRule & Pick<NaiveRule, 'trigger' | 'validator' | 'required' | 'message'>;
-type NativeRuleFactories<T> = { readonly [Key in keyof T]: T[Key] extends ((...args: infer Args) => infer Result) ? (...args: Args) => Result extends readonly NaiveRule[] ? NativePresetRule[] : Result extends NaiveRule ? NativePresetRule : Result : T[Key] };
-/** 运行时保持验证库的工厂对象，只有公开类型在组件包内统一适配。 */
-declare const PRESET_RULES$1: NativeRuleFactories<typeof PRESET_RULES>;
-declare const NAIVE_COMBOS$1: NativeRuleFactories<typeof NAIVE_COMBOS>;
 //#endregion
 //#region src/components/C_Form/types.d.ts
 type MaybePromise<T> = T | Promise<T>;
 type FormRecord = Record<string, unknown>;
 type AtomicFormValue = string | number | boolean | bigint | symbol | null | undefined | Date | RegExp | File | Blob;
-type NestedFieldPath<T extends object> = { [K in Extract<keyof T, string>]: NonNullable<T[K]> extends AtomicFormValue ? K : NonNullable<T[K]> extends readonly (infer Item)[] ? NonNullable<Item> extends AtomicFormValue ? K | `${K}.${number}` : NonNullable<Item> extends object ? K | `${K}.${number}` | `${K}.${number}.${NestedFieldPath<NonNullable<Item>>}` : K : NonNullable<T[K]> extends object ? K | `${K}.${NestedFieldPath<NonNullable<T[K]>>}` : K }[Extract<keyof T, string>];
-type FieldPath<T extends object = FormRecord> = string extends keyof T ? string : NestedFieldPath<T>;
+/**
+ * 最多展开五次子模型，保留六层字段路径及递归业务模型支持。
+ * 每层引用独立别名，避免 TypeScript 5.8 方差检查递归路径自身时栈溢出。
+ */
+type FieldPathChild<T> = NonNullable<T> extends AtomicFormValue ? never : NonNullable<T> extends readonly (infer Item)[] ? NonNullable<Item> extends AtomicFormValue ? never : NonNullable<Item> extends object ? NonNullable<Item> : never : NonNullable<T> extends object ? NonNullable<T> : never;
+type FieldPathStep<T extends object, Children extends { [K in keyof T]: string }> = { [K in Extract<keyof T, string>]: NonNullable<T[K]> extends AtomicFormValue ? K : NonNullable<T[K]> extends readonly (infer Item)[] ? NonNullable<Item> extends AtomicFormValue ? K | `${K}.${number}` : NonNullable<Item> extends object ? K | `${K}.${number}` | `${K}.${number}.${Children[K]}` : K : NonNullable<T[K]> extends object ? K | `${K}.${Children[K]}` : K }[Extract<keyof T, string>];
+type NestedFieldPath0<T extends object> = Extract<keyof T, string>;
+type NestedFieldPath1<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath0<FieldPathChild<T[K]>> }>;
+type NestedFieldPath2<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath1<FieldPathChild<T[K]>> }>;
+type NestedFieldPath3<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath2<FieldPathChild<T[K]>> }>;
+type NestedFieldPath4<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath3<FieldPathChild<T[K]>> }>;
+type NestedFieldPath5<T extends object> = FieldPathStep<T, { [K in keyof T]: NestedFieldPath4<FieldPathChild<T[K]>> }>;
+type FieldPath<T extends object = FormRecord> = keyof T extends never ? string : string extends keyof T ? string : NestedFieldPath5<T>;
 type NestedFieldPathValue<T, P extends string> = T extends readonly (infer Item)[] ? P extends `${number}.${infer Rest}` ? NestedFieldPathValue<NonNullable<Item>, Rest> : P extends `${number}` ? Item : unknown : P extends keyof T ? T[P] : P extends `${infer K}.${infer Rest}` ? K extends keyof T ? NestedFieldPathValue<NonNullable<T[K]>, Rest> : unknown : unknown;
 type FieldPathValue<T extends object, P extends string> = NestedFieldPathValue<T, P>;
 /**
@@ -273,12 +279,10 @@ interface LayoutConfig {
  * 表单配置项接口
  * @description 单个表单项的完整配置
  */
-interface FormOption<T extends object = FormRecord> {
+interface FormOptionBase<T extends object> {
   id?: string;
   type: ComponentType | string;
-  prop: FieldPath<T>;
   label?: string;
-  value?: unknown;
   placeholder?: string;
   rules?: readonly FormValidationRule[];
   attrs?: Record<string, unknown>;
@@ -293,8 +297,6 @@ interface FormOption<T extends object = FormRecord> {
   disabled?: boolean | ((formModel: FormModel<T>) => boolean);
   /** 字段级只读（优先级高于全局 config.readonly） */
   readonly?: boolean | ((formModel: FormModel<T>) => boolean);
-  /** 联动赋值：其他字段变化时自动计算本字段的值 */
-  valueWhen?: (formModel: FormModel<T>) => unknown;
   /** 异步数据源：select / cascader / checkbox / radio 的远程选项加载 */
   asyncOptions?: (formModel: FormModel<T>, context?: AsyncOptionsContext) => Promise<readonly OptionItem[]>;
   /** 联动校验规则：根据表单数据动态返回校验规则 */
@@ -302,6 +304,12 @@ interface FormOption<T extends object = FormRecord> {
   /** 跨字段校验：需要引用多个字段值的验证函数，返回错误消息或 null */
   crossFieldValidator?: (formModel: FormModel<T>) => MaybePromise<string | null>;
 }
+/** 字段名与初值、联动返回值关联；未声明业务模型时保持动态表单的宽松契约。 */
+type FormOption<T extends object = FormRecord> = FormOptionBase<T> & { [P in FieldPath<T>]: {
+  prop: P;
+  value?: FieldPathValue<T, P>; /** 联动赋值：其他字段变化时自动计算本字段的值。 */
+  valueWhen?: (formModel: FormModel<T>) => FieldPathValue<T, P>;
+} }[FieldPath<T>];
 /**
  * 表单提交事件参数
  */
@@ -467,7 +475,7 @@ interface LayoutCallbacks<T extends object = FormRecord> {
   onGroupToggle?: (groupKey: string, collapsed: boolean) => void;
   onGroupReset?: (groupKey: string) => void;
   onFieldsChange?: (fields: FormOption<T>[]) => void;
-  onSubmit?: (payload: SubmitEventPayload<T>, context?: FormSubmitContext) => MaybePromise<void>;
+  onSubmit?: (payload: SubmitEventPayload<T>, context?: FormSubmitContext) => unknown;
   onError?: (error: unknown, context: FormErrorContext) => void;
 }
 /**
@@ -722,7 +730,7 @@ type FormEmit = {
 declare function useFormState(options: ComputedRef<FormOption[]>, config: ComputedRef<ResolvedFormConfig>, formRef: Ref<FormInst | null>, emit: FormEmit, externalModel?: ComputedRef<FormModel | undefined>, validationReady?: ComputedRef<boolean>): {
   formModel: FormRecord;
   formRules: FormRules;
-  visibleOptions: ComputedRef<FormOption<FormRecord>[]>;
+  visibleOptions: ComputedRef<FormOption[]>;
   initialize: () => void;
   handleFieldChange: (field: string) => void;
   setFormItemRef: (field: string, instance: FormItemInst | null) => void;
@@ -809,4 +817,4 @@ type DynamicFormStateType = DynamicFormController;
  */
 declare const DYNAMIC_FORM_STATE_KEY: unique symbol;
 //#endregion
-export { FormStepActionsSlotProps as $, ResolvedFormConfig as A, DynamicFormConfig as B, unregisterRenderer as C, FormConfig as D, FORM_GLOBAL_CONFIG_KEY as E, AsyncOptionsContext as F, FormActionSlotProps as G, DynamicFormState as H, CardLayoutConfig as I, FormMode as J, FormErrorContext as K, ComponentType as L, resolveFormConfig as M, shouldShowActions as N, LAYOUTS_WITH_OWN_CONTROLS as O, useFormGlobalConfig as P, FormSlots as Q, CustomLayoutConfig as R, registerRenderer as S, FORM_DEFAULTS as T, FieldPath as U, DynamicFormController as V, FieldPathValue as W, FormOption as X, FormModel as Y, FormRecord as Z, FormRendererContext as _, UseFormDirtyReturn as a, LayoutConfig as at, UseFormRendererOptions as b, UseCFormOptions as c, OptionItem as ct, defineFormOptions as d, TabsLayoutConfig as dt, FormSubmitContext as et, useCForm as f, FormValidationRule as ft, FormRenderer as g, SPEC_RULES as gt, FORM_RENDERER_REGISTRY_KEY as h, RuleSpec$1 as ht, useDynamicFormState as i, LabelPlacement as it, mergeFormConfig as j, LayoutCallbacks as k, UseCFormReturn as l, StepsLayoutConfig as lt, ComponentMap as m, PRESET_RULES$1 as mt, DynamicFormStateType as n, GridLayoutConfig as nt, useFormDirty as o, LayoutType as ot, _default as p, NAIVE_COMBOS$1 as pt, FormInstance as q, FIELD_TYPE_OPTIONS as r, InlineLayoutConfig as rt, useFormState as s, MaybePromise as st, DYNAMIC_FORM_STATE_KEY as t, FormTabActionsSlotProps as tt, defineFormConfig as u, SubmitEventPayload as ut, FormRendererRegistry as v, useFormRenderer as w, createFormRendererRegistry as x, RendererProps as y, DynamicFieldConfig as z };
+export { FormStepActionsSlotProps as $, ResolvedFormConfig as A, DynamicFormConfig as B, unregisterRenderer as C, FormConfig as D, FORM_GLOBAL_CONFIG_KEY as E, AsyncOptionsContext as F, FormActionSlotProps as G, DynamicFormState as H, CardLayoutConfig as I, FormMode as J, FormErrorContext as K, ComponentType as L, resolveFormConfig as M, shouldShowActions as N, LAYOUTS_WITH_OWN_CONTROLS as O, useFormGlobalConfig as P, FormSlots as Q, CustomLayoutConfig as R, registerRenderer as S, FORM_DEFAULTS as T, FieldPath as U, DynamicFormController as V, FieldPathValue as W, FormOption as X, FormModel as Y, FormRecord as Z, FormRendererContext as _, UseFormDirtyReturn as a, LayoutConfig as at, UseFormRendererOptions as b, UseCFormOptions as c, OptionItem as ct, defineFormOptions as d, TabsLayoutConfig as dt, FormSubmitContext as et, useCForm as f, FormValidationRule as ft, FormRenderer as g, SPEC_RULES as gt, FORM_RENDERER_REGISTRY_KEY as h, RuleSpec$1 as ht, useDynamicFormState as i, LabelPlacement as it, mergeFormConfig as j, LayoutCallbacks as k, UseCFormReturn as l, StepsLayoutConfig as lt, ComponentMap as m, PRESET_RULES as mt, DynamicFormStateType as n, GridLayoutConfig as nt, useFormDirty as o, LayoutType as ot, _default as p, NAIVE_COMBOS as pt, FormInstance as q, FIELD_TYPE_OPTIONS as r, InlineLayoutConfig as rt, useFormState as s, MaybePromise as st, DYNAMIC_FORM_STATE_KEY as t, FormTabActionsSlotProps as tt, defineFormConfig as u, SubmitEventPayload as ut, FormRendererRegistry as v, useFormRenderer as w, createFormRendererRegistry as x, RendererProps as y, DynamicFieldConfig as z };

package/dist/useEdgeInteraction.d.cts

@@ -238,6 +238,11 @@ interface GraphConfig {
   history?: HistoryConfig;
   clipboard?: ClipboardConfig;
 }
+/** 公开图实例；初始化和布局切换期间尚无实例时返回 undefined。 */
+interface DiagramExpose {
+  getGraph: () => Graph | undefined;
+  getData: () => DiagramData | undefined;
+}
 //#endregion
 //#region src/components/C_AntV/index.vue.d.ts
 interface Props extends DiagramConfig {
@@ -250,8 +255,8 @@ interface Props extends DiagramConfig {
   theme?: 'light' | 'dark';
 }
 declare const __VLS_export: vue.DefineComponent<Props, {
-  getGraph: () => any;
-  getData: () => any;
+  getGraph: () => Graph | undefined;
+  getData: () => DiagramData | undefined;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
   ready: (graph: Graph) => any;
   "data-change": (data: DiagramData) => any;
@@ -259,10 +264,10 @@ declare const __VLS_export: vue.DefineComponent<Props, {
   onReady?: ((graph: Graph) => any) | undefined;
   "onData-change"?: ((data: DiagramData) => any) | undefined;
 }>, {
+  width: string | number;
   height: string | number;
-  showToolbar: boolean;
   theme: "light" | "dark";
-  width: string | number;
+  showToolbar: boolean;
   readonly: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
@@ -324,4 +329,4 @@ declare function useEdgeInteraction(graph: Ref<Graph | null>, options?: EdgeInte
   bindInteractions: () => void;
 };
 //#endregion
-export { SelectionConfig as A, KeyboardConfig as C, MouseWheelConfig as D, MinimapConfig as E, UMLClass as F, UMLDiagramData as I, UMLMethod as L, ThemeConfig as M, ToolbarAction as N, Position as O, UMLAttribute as P, UMLRelation as R, HistoryConfig as S, MenuItem as T, ExportFormat as _, BPMNDiagramData as a, GraphExportOptions as b, ClipboardConfig as c, DiagramData as d, DiagramType as f, ERTable as g, ERRelation as h, _default as i, SnapshotConfig as j, ScrollerConfig as k, ConnectionConfig as l, ERField as m, useGraphExport as n, BPMNFlow as o, ERDiagramData as p, useGraphBase as r, BPMNNode as s, useEdgeInteraction as t, DiagramConfig as u, GraphConfig as v, LayoutOptions as w, GridConfig as x, GraphEvents as y, ValidationResult as z };
+export { ScrollerConfig as A, ValidationResult as B, HistoryConfig as C, MinimapConfig as D, MenuItem as E, UMLAttribute as F, UMLClass as I, UMLDiagramData as L, SnapshotConfig as M, ThemeConfig as N, MouseWheelConfig as O, ToolbarAction as P, UMLMethod as R, GridConfig as S, LayoutOptions as T, ERTable as _, BPMNDiagramData as a, GraphEvents as b, ClipboardConfig as c, DiagramData as d, DiagramExpose as f, ERRelation as g, ERField as h, _default as i, SelectionConfig as j, Position as k, ConnectionConfig as l, ERDiagramData as m, useGraphExport as n, BPMNFlow as o, DiagramType as p, useGraphBase as r, BPMNNode as s, useEdgeInteraction as t, DiagramConfig as u, ExportFormat as v, KeyboardConfig as w, GraphExportOptions as x, GraphConfig as y, UMLRelation as z };

package/dist/useEdgeInteraction.d.ts

@@ -238,6 +238,11 @@ interface GraphConfig {
   history?: HistoryConfig;
   clipboard?: ClipboardConfig;
 }
+/** 公开图实例；初始化和布局切换期间尚无实例时返回 undefined。 */
+interface DiagramExpose {
+  getGraph: () => Graph | undefined;
+  getData: () => DiagramData | undefined;
+}
 //#endregion
 //#region src/components/C_AntV/index.vue.d.ts
 interface Props extends DiagramConfig {
@@ -250,8 +255,8 @@ interface Props extends DiagramConfig {
   theme?: 'light' | 'dark';
 }
 declare const __VLS_export: vue.DefineComponent<Props, {
-  getGraph: () => any;
-  getData: () => any;
+  getGraph: () => Graph | undefined;
+  getData: () => DiagramData | undefined;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
   ready: (graph: Graph) => any;
   "data-change": (data: DiagramData) => any;
@@ -259,10 +264,10 @@ declare const __VLS_export: vue.DefineComponent<Props, {
   onReady?: ((graph: Graph) => any) | undefined;
   "onData-change"?: ((data: DiagramData) => any) | undefined;
 }>, {
+  width: string | number;
   height: string | number;
-  showToolbar: boolean;
   theme: "light" | "dark";
-  width: string | number;
+  showToolbar: boolean;
   readonly: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
@@ -324,4 +329,4 @@ declare function useEdgeInteraction(graph: Ref<Graph | null>, options?: EdgeInte
   bindInteractions: () => void;
 };
 //#endregion
-export { SelectionConfig as A, KeyboardConfig as C, MouseWheelConfig as D, MinimapConfig as E, UMLClass as F, UMLDiagramData as I, UMLMethod as L, ThemeConfig as M, ToolbarAction as N, Position as O, UMLAttribute as P, UMLRelation as R, HistoryConfig as S, MenuItem as T, ExportFormat as _, BPMNDiagramData as a, GraphExportOptions as b, ClipboardConfig as c, DiagramData as d, DiagramType as f, ERTable as g, ERRelation as h, _default as i, SnapshotConfig as j, ScrollerConfig as k, ConnectionConfig as l, ERField as m, useGraphExport as n, BPMNFlow as o, ERDiagramData as p, useGraphBase as r, BPMNNode as s, useEdgeInteraction as t, DiagramConfig as u, GraphConfig as v, LayoutOptions as w, GridConfig as x, GraphEvents as y, ValidationResult as z };
+export { ScrollerConfig as A, ValidationResult as B, HistoryConfig as C, MinimapConfig as D, MenuItem as E, UMLAttribute as F, UMLClass as I, UMLDiagramData as L, SnapshotConfig as M, ThemeConfig as N, MouseWheelConfig as O, ToolbarAction as P, UMLMethod as R, GridConfig as S, LayoutOptions as T, ERTable as _, BPMNDiagramData as a, GraphEvents as b, ClipboardConfig as c, DiagramData as d, DiagramExpose as f, ERRelation as g, ERField as h, _default as i, SelectionConfig as j, Position as k, ConnectionConfig as l, ERDiagramData as m, useGraphExport as n, BPMNFlow as o, DiagramType as p, useGraphBase as r, BPMNNode as s, useEdgeInteraction as t, DiagramConfig as u, ExportFormat as v, KeyboardConfig as w, GraphExportOptions as x, GraphConfig as y, UMLRelation as z };

package/dist/useFullscreen.d.cts

@@ -10,15 +10,15 @@ type __VLS_Props = {
   inline?: boolean;
 };
 declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  preview: (file: string | File) => any;
   download: (file: string | File) => any;
+  preview: (file: string | File) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
-  onPreview?: ((file: string | File) => any) | undefined;
   onDownload?: ((file: string | File) => any) | undefined;
+  onPreview?: ((file: string | File) => any) | undefined;
 }>, {
-  inline: boolean;
   fileName: string;
   autoPreview: boolean;
+  inline: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion

package/dist/useFullscreen.d.ts

@@ -10,15 +10,15 @@ type __VLS_Props = {
   inline?: boolean;
 };
 declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  preview: (file: string | File) => any;
   download: (file: string | File) => any;
+  preview: (file: string | File) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
-  onPreview?: ((file: string | File) => any) | undefined;
   onDownload?: ((file: string | File) => any) | undefined;
+  onPreview?: ((file: string | File) => any) | undefined;
 }>, {
-  inline: boolean;
   fileName: string;
   autoPreview: boolean;
+  inline: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion

package/dist/useInfiniteScroll.d.cts

@@ -79,13 +79,13 @@ type __VLS_Slots = {} & {
   footer?: (props: typeof __VLS_5) => any;
 };
 declare const __VLS_base: vue.DefineComponent<WaterFallProps, WaterFallExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  "item-click": (item: WaterFallItem, index: number) => any;
   "load-more": () => any;
+  "item-click": (item: WaterFallItem, index: number) => any;
   "image-loaded": (item: WaterFallItem) => any;
   "image-error": (item: WaterFallItem) => any;
 }, string, vue.PublicProps, Readonly<WaterFallProps> & Readonly<{
-  "onItem-click"?: ((item: WaterFallItem, index: number) => any) | undefined;
   "onLoad-more"?: (() => any) | undefined;
+  "onItem-click"?: ((item: WaterFallItem, index: number) => any) | undefined;
   "onImage-loaded"?: ((item: WaterFallItem) => any) | undefined;
   "onImage-error"?: ((item: WaterFallItem) => any) | undefined;
 }>, {