@robot-admin/naive-ui-components 0.17.6 → 0.18.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

@@ -18,8 +18,19 @@ declare const NAIVE_COMBOS$1: NativeRuleFactories<typeof NAIVE_COMBOS>;
 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 +284,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 +302,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 +309,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>];
 /**
  * 表单提交事件参数
  */
@@ -722,7 +735,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;

package/dist/useDynamicFormState.d.ts

@@ -18,8 +18,19 @@ declare const NAIVE_COMBOS$1: NativeRuleFactories<typeof NAIVE_COMBOS>;
 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 +284,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 +302,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 +309,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>];
 /**
  * 表单提交事件参数
  */
@@ -722,7 +735,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;

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,11 +264,11 @@ declare const __VLS_export: vue.DefineComponent<Props, {
   onReady?: ((graph: Graph) => any) | undefined;
   "onData-change"?: ((data: DiagramData) => any) | undefined;
 }>, {
+  readonly: boolean;
   height: string | number;
-  showToolbar: boolean;
   theme: "light" | "dark";
   width: string | number;
-  readonly: boolean;
+  showToolbar: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
@@ -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,11 +264,11 @@ declare const __VLS_export: vue.DefineComponent<Props, {
   onReady?: ((graph: Graph) => any) | undefined;
   "onData-change"?: ((data: DiagramData) => any) | undefined;
 }>, {
+  readonly: boolean;
   height: string | number;
-  showToolbar: boolean;
   theme: "light" | "dark";
   width: string | number;
-  readonly: boolean;
+  showToolbar: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
@@ -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;
 }>, {

package/dist/useInfiniteScroll.d.ts

@@ -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;
 }>, {

package/dist/useQRCode.d.cts

@@ -50,16 +50,16 @@ declare const __VLS_export: vue.DefineComponent<Props, QRCodeExpose, {}, {}, {},
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
   onError?: ((error: Error) => any) | undefined;
 }>, {
-  mode: RenderMode;
+  size: number;
   label: string;
   color: string;
-  size: number;
-  showBorder: boolean;
-  showLabel: boolean;
+  mode: RenderMode;
   margin: number;
   bgColor: string;
   errorCorrectionLevel: ErrorCorrectionLevel;
   logo: LogoOptions;
+  showBorder: boolean;
+  showLabel: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion

package/dist/useQRCode.d.ts

@@ -50,16 +50,16 @@ declare const __VLS_export: vue.DefineComponent<Props, QRCodeExpose, {}, {}, {},
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
   onError?: ((error: Error) => any) | undefined;
 }>, {
-  mode: RenderMode;
+  size: number;
   label: string;
   color: string;
-  size: number;
-  showBorder: boolean;
-  showLabel: boolean;
+  mode: RenderMode;
   margin: number;
   bgColor: string;
   errorCorrectionLevel: ErrorCorrectionLevel;
   logo: LogoOptions;
+  showBorder: boolean;
+  showLabel: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion