@tu-design/vue 0.5.8 → 0.5.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/dist/index.d.mts +221 -137
  2. package/dist/index.mjs +1278 -498
  3. package/dist/registry/vue/alert-dialog.json +1 -1
  4. package/dist/registry/vue/alert.json +1 -1
  5. package/dist/registry/vue/avatar-group.json +1 -1
  6. package/dist/registry/vue/avatar.json +1 -1
  7. package/dist/registry/vue/badge.json +1 -1
  8. package/dist/registry/vue/button.json +1 -1
  9. package/dist/registry/vue/calendar.json +1 -1
  10. package/dist/registry/vue/card.json +1 -1
  11. package/dist/registry/vue/cascader.json +1 -1
  12. package/dist/registry/vue/checkbox.json +2 -2
  13. package/dist/registry/vue/context-menu.json +1 -1
  14. package/dist/registry/vue/currency-input.json +1 -1
  15. package/dist/registry/vue/date-picker.json +1 -1
  16. package/dist/registry/vue/date-range-picker.json +1 -1
  17. package/dist/registry/vue/date-shared.json +1 -1
  18. package/dist/registry/vue/dialog.json +1 -1
  19. package/dist/registry/vue/drawer.json +1 -1
  20. package/dist/registry/vue/dropdown-menu.json +1 -1
  21. package/dist/registry/vue/empty.json +1 -1
  22. package/dist/registry/vue/form-render.json +9 -9
  23. package/dist/registry/vue/form.json +2 -2
  24. package/dist/registry/vue/icon-shared.json +8 -2
  25. package/dist/registry/vue/input.json +2 -2
  26. package/dist/registry/vue/label.json +1 -1
  27. package/dist/registry/vue/month-picker.json +1 -1
  28. package/dist/registry/vue/number-input.json +1 -1
  29. package/dist/registry/vue/overlay-shared.json +1 -1
  30. package/dist/registry/vue/password-input.json +1 -1
  31. package/dist/registry/vue/pin-input.json +1 -1
  32. package/dist/registry/vue/popconfirm.json +1 -1
  33. package/dist/registry/vue/popover.json +1 -1
  34. package/dist/registry/vue/progress.json +1 -1
  35. package/dist/registry/vue/radio-group.json +1 -1
  36. package/dist/registry/vue/registry.json +54 -54
  37. package/dist/registry/vue/select.json +1 -1
  38. package/dist/registry/vue/separator.json +1 -1
  39. package/dist/registry/vue/skeleton.json +1 -1
  40. package/dist/registry/vue/slider.json +1 -1
  41. package/dist/registry/vue/slot.json +1 -1
  42. package/dist/registry/vue/spin.json +1 -1
  43. package/dist/registry/vue/switch.json +1 -1
  44. package/dist/registry/vue/table-render.json +24 -11
  45. package/dist/registry/vue/tabs.json +1 -1
  46. package/dist/registry/vue/textarea.json +2 -2
  47. package/dist/registry/vue/timeline.json +1 -1
  48. package/dist/registry/vue/toast.json +1 -1
  49. package/dist/registry/vue/tokens.json +1 -1
  50. package/dist/registry/vue/tooltip.json +1 -1
  51. package/dist/registry/vue/tree-select.json +1 -1
  52. package/dist/registry/vue/tree-shared.json +1 -1
  53. package/dist/registry/vue/utils.json +1 -1
  54. package/dist/registry/vue/week-picker.json +1 -1
  55. package/dist/registry/vue/year-picker.json +1 -1
  56. package/package.json +1 -1
package/dist/index.d.mts CHANGED
@@ -1,5 +1,5 @@
1
1
  import { ClassValue } from "clsx";
2
- import { ImgHTMLAttributes, InjectionKey, MaybeRefOrGetter, PropType, Ref, VNode, VNodeChild } from "vue";
2
+ import { ImgHTMLAttributes, InjectionKey, MaybeRefOrGetter, PropType, Ref, SlotsType, VNode, VNodeChild } from "vue";
3
3
  import { VariantProps } from "class-variance-authority";
4
4
  import { DateValue } from "@ark-ui/vue/date-picker";
5
5
  import { SelectRootProps } from "@ark-ui/vue/select";
@@ -108,10 +108,10 @@ declare const __VLS_base$34: import("vue").DefineComponent<import("vue").Extract
108
108
  "onUpdate:checked"?: (checked: boolean) => any;
109
109
  }>, {
110
110
  class: string;
111
+ name: string;
111
112
  checked: boolean | "indeterminate";
112
113
  defaultChecked: boolean;
113
114
  disabled: boolean;
114
- name: string;
115
115
  form: string;
116
116
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
117
117
  declare const __VLS_export$52: __VLS_WithSlots$34<typeof __VLS_base$34, __VLS_Slots$34>;
@@ -216,8 +216,8 @@ declare const __VLS_export$51: import("vue").DefineComponent<import("vue").Extra
216
216
  "onUpdate:modelValue"?: (value: number) => any;
217
217
  }>, {
218
218
  class: string;
219
- disabled: boolean;
220
219
  modelValue: number;
220
+ disabled: boolean;
221
221
  placeholder: string;
222
222
  invalid: boolean;
223
223
  labelUnit: CurrencyUnit;
@@ -389,13 +389,13 @@ declare const __VLS_export$50: import("vue").DefineComponent<import("vue").Extra
389
389
  "onUpdate:open"?: (open: boolean) => any;
390
390
  }>, {
391
391
  class: string;
392
- disabled: boolean;
392
+ max: string;
393
393
  modelValue: string;
394
394
  defaultValue: string;
395
395
  min: string;
396
- max: string;
397
396
  isDateUnavailable: (date: DateValue) => boolean;
398
397
  locale: string;
398
+ disabled: boolean;
399
399
  open: boolean;
400
400
  defaultOpen: boolean;
401
401
  placeholder: string;
@@ -565,14 +565,14 @@ declare const __VLS_export$49: import("vue").DefineComponent<import("vue").Extra
565
565
  "onUpdate:open"?: (open: boolean) => any;
566
566
  }>, {
567
567
  class: string;
568
- disabled: boolean;
568
+ max: string;
569
569
  numOfMonths: number;
570
570
  modelValue: [string, string];
571
571
  defaultValue: [string, string];
572
572
  min: string;
573
- max: string;
574
573
  isDateUnavailable: (date: DateValue) => boolean;
575
574
  locale: string;
575
+ disabled: boolean;
576
576
  open: boolean;
577
577
  defaultOpen: boolean;
578
578
  placeholder: string;
@@ -742,12 +742,12 @@ declare const __VLS_export$47: import("vue").DefineComponent<import("vue").Extra
742
742
  "onUpdate:open"?: (open: boolean) => any;
743
743
  }>, {
744
744
  class: string;
745
- disabled: boolean;
745
+ max: string;
746
746
  modelValue: string;
747
747
  defaultValue: string;
748
748
  min: string;
749
- max: string;
750
749
  locale: string;
750
+ disabled: boolean;
751
751
  open: boolean;
752
752
  defaultOpen: boolean;
753
753
  placeholder: string;
@@ -911,13 +911,13 @@ declare const __VLS_export$46: import("vue").DefineComponent<import("vue").Extra
911
911
  "onUpdate:open"?: (open: boolean) => any;
912
912
  }>, {
913
913
  class: string;
914
- disabled: boolean;
914
+ max: string;
915
915
  modelValue: string;
916
916
  defaultValue: string;
917
917
  min: string;
918
- max: string;
919
918
  isDateUnavailable: (date: DateValue) => boolean;
920
919
  locale: string;
920
+ disabled: boolean;
921
921
  open: boolean;
922
922
  defaultOpen: boolean;
923
923
  placeholder: string;
@@ -1009,10 +1009,10 @@ declare const __VLS_base$33: import("vue").DefineComponent<import("vue").Extract
1009
1009
  "onUpdate:modelValue"?: (value: number) => any;
1010
1010
  }>, {
1011
1011
  class: string;
1012
- disabled: boolean;
1012
+ max: number;
1013
1013
  modelValue: number;
1014
1014
  min: number;
1015
- max: number;
1015
+ disabled: boolean;
1016
1016
  invalid: boolean;
1017
1017
  step: number;
1018
1018
  formatOptions: Intl.NumberFormatOptions;
@@ -1113,8 +1113,8 @@ declare const __VLS_base$32: import("vue").DefineComponent<import("vue").Extract
1113
1113
  "onUpdate:visible"?: (visible: boolean) => any;
1114
1114
  }>, {
1115
1115
  class: string;
1116
- disabled: boolean;
1117
1116
  modelValue: string;
1117
+ disabled: boolean;
1118
1118
  placeholder: string;
1119
1119
  invalid: boolean;
1120
1120
  visible: boolean;
@@ -1384,9 +1384,9 @@ declare const __VLS_export$42: import("vue").DefineComponent<import("vue").Extra
1384
1384
  "onUpdate:show"?: (open: boolean) => any;
1385
1385
  }>, {
1386
1386
  class: string;
1387
- disabled: boolean;
1388
1387
  modelValue: Key | Key[];
1389
1388
  defaultValue: Key | Key[];
1389
+ disabled: boolean;
1390
1390
  open: boolean;
1391
1391
  defaultOpen: boolean;
1392
1392
  placeholder: string;
@@ -1598,9 +1598,9 @@ declare const __VLS_export$41: import("vue").DefineComponent<import("vue").Extra
1598
1598
  "onUpdate:expandedKeys"?: (keys: Key[]) => any;
1599
1599
  }>, {
1600
1600
  class: string;
1601
- disabled: boolean;
1602
1601
  modelValue: Key | Key[];
1603
1602
  defaultValue: Key | Key[];
1603
+ disabled: boolean;
1604
1604
  open: boolean;
1605
1605
  defaultOpen: boolean;
1606
1606
  placeholder: string;
@@ -1770,8 +1770,8 @@ declare const __VLS_export$39: import("vue").DefineComponent<__VLS_Props$11, {},
1770
1770
  }, string, import("vue").PublicProps, Readonly<__VLS_Props$11> & Readonly<{
1771
1771
  "onUpdate:modelValue"?: (value: number[]) => any;
1772
1772
  }>, {
1773
- min: number;
1774
1773
  max: number;
1774
+ min: number;
1775
1775
  step: number;
1776
1776
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
1777
1777
  declare const _default$40: typeof __VLS_export$39;
@@ -1992,12 +1992,12 @@ declare const __VLS_export$36: import("vue").DefineComponent<import("vue").Extra
1992
1992
  "onUpdate:open"?: (open: boolean) => any;
1993
1993
  }>, {
1994
1994
  class: string;
1995
- disabled: boolean;
1995
+ max: string;
1996
1996
  modelValue: string;
1997
1997
  defaultValue: string;
1998
1998
  min: string;
1999
- max: string;
2000
1999
  locale: string;
2000
+ disabled: boolean;
2001
2001
  open: boolean;
2002
2002
  defaultOpen: boolean;
2003
2003
  placeholder: string;
@@ -2048,7 +2048,7 @@ type TextareaWidgetOptions = SfcOptions<typeof _default$46> & {
2048
2048
  /**
2049
2049
  * v3 命名穿透:选项字段即组件 prop 名 `items`——显式必填(Partial 化会退化为可选,
2050
2050
  * 缺失时 Select.vue collection 计算在首渲染崩溃);placeholder 已是 Select 单组件
2051
- * 的正式 prop,不再 Omit,渲染时做 item 级缺省回退(I1)。
2051
+ * 的正式 prop,不再 Omit,渲染时做 item 级缺省回退。
2052
2052
  */
2053
2053
  type SelectWidgetOptions = Omit<SfcOptions<typeof _default$37>, "items"> & {
2054
2054
  items: WidgetItemOption[];
@@ -2110,7 +2110,7 @@ interface FormRenderItem<T extends object> {
2110
2110
  placeholder?: string;
2111
2111
  /**
2112
2112
  * 默认值(值或同步工厂);defineForm 据此派生 defaultValues。
2113
- * 类型为 T 值域联合 T[keyof T](无 per-item 精确联动,强于 x-render 的 any)。
2113
+ * 类型为 T 值域联合 T[keyof T](无 per-item 精确联动)。
2114
2114
  */
2115
2115
  default?: T[keyof T] | (() => T[keyof T]);
2116
2116
  /** 栅格跨度:数字 = 占 n 列(须 ≤ 实际列数);"full" = 整行 */
@@ -2126,15 +2126,15 @@ interface FormRenderItem<T extends object> {
2126
2126
  /** 逃逸口:原样合并到控件 vnode 的 props */
2127
2127
  componentProps?: Record<string, unknown>;
2128
2128
  }
2129
- /** 按钮预设(A1 块级互斥:actions 存在时 <FormRender> 组件按钮 props 全量忽略) */
2129
+ /** 按钮预设(块级互斥:actions 存在时 <FormRender> 组件按钮 props 全量忽略) */
2130
2130
  interface FormActionsConfig {
2131
2131
  /** 搜索按钮,缺省 false */
2132
2132
  searchable?: boolean;
2133
2133
  /** 提交按钮,缺省 false */
2134
2134
  submitable?: boolean;
2135
- /** 重置按钮;缺省跟随 searchable(A2,域内解析) */
2135
+ /** 重置按钮;缺省跟随 searchable(域内解析) */
2136
2136
  resetable?: boolean;
2137
- /** 取消按钮;缺省跟随 submitable(A2,域内解析) */
2137
+ /** 取消按钮;缺省跟随 submitable(域内解析) */
2138
2138
  cancelable?: boolean;
2139
2139
  searchText?: string;
2140
2140
  submitText?: string;
@@ -2145,7 +2145,7 @@ interface FormRenderDefinition<T extends object> {
2145
2145
  form: FormRenderFormApi;
2146
2146
  /** 重置到 items.default(搜索表单"重置"语义) */
2147
2147
  resetToDefaults: () => void;
2148
- /** 全量校验并返回是否通过(R30);不触发 FormRender 的 search/submit 事件。
2148
+ /** 全量校验并返回是否通过;不触发 FormRender 的 search/submit 事件。
2149
2149
  * 组合式外部查询标准链路:`if (await table.search.submit()) table.reload(true)` */
2150
2150
  submit: () => Promise<boolean>;
2151
2151
  /** 按钮预设投影(引擎从 options 七项直传;未配置为 undefined——此时组件按钮 props 全量生效) */
@@ -2279,7 +2279,7 @@ interface DefineFormOptions<T extends object> {
2279
2279
  onSubmit?: (ctx: {
2280
2280
  value: T;
2281
2281
  }) => void | Promise<void>;
2282
- /** 按钮预设七项(A1 块级互斥):显式传任一项即投影为 definition.actions,组件按钮 props 全量忽略 */
2282
+ /** 按钮预设七项(块级互斥):显式传任一项即投影为 definition.actions,组件按钮 props 全量忽略 */
2283
2283
  searchable?: boolean;
2284
2284
  submitable?: boolean;
2285
2285
  resetable?: boolean;
@@ -2297,8 +2297,8 @@ interface DefineFormOptions<T extends object> {
2297
2297
  * - `items` / `form` 传给 `<FormRender>`(支持 `:definition` 单 prop 或 `:form` + `:items` 拆分);
2298
2298
  * - `form` 可直接 `reset()` / `validate()` / `handleSubmit()`;
2299
2299
  * - `resetToDefaults()` 重置到 `items.default`(搜索表单"重置"语义);
2300
- * - `submit()` 全量校验并返回是否通过(R30,组合式查询链路);
2301
- * - `actions` 按钮预设(searchable 等七项直传):存在时 `<FormRender>` 组件按钮 props 全量忽略(A1 块级互斥)。
2300
+ * - `submit()` 全量校验并返回是否通过(组合式查询链路);
2301
+ * - `actions` 按钮预设(searchable 等七项直传):存在时 `<FormRender>` 组件按钮 props 全量忽略(块级互斥)。
2302
2302
  *
2303
2303
  * 须在组件 setup 中调用(TanStack useForm 约束)。
2304
2304
  * @param config - 表单配置:字段定义、校验 schema、提交回调、按钮预设七项与 TanStack 透传项
@@ -2314,7 +2314,7 @@ interface UseFormRenderOptions<T extends object> {
2314
2314
  onSubmit?: (ctx: {
2315
2315
  value: T;
2316
2316
  }) => void | Promise<void>;
2317
- /** 按钮预设七项(A1):显式传任一项即投影为 actions(definition 域,组件按钮 props 全量忽略) */
2317
+ /** 按钮预设七项:显式传任一项即投影为 actions(definition 域,组件按钮 props 全量忽略) */
2318
2318
  searchable?: boolean;
2319
2319
  submitable?: boolean;
2320
2320
  resetable?: boolean;
@@ -2625,11 +2625,11 @@ declare const __VLS_base$23: import("vue").DefineComponent<import("vue").Extract
2625
2625
  "onUpdate:modelValue"?: (value: string) => any;
2626
2626
  }>, {
2627
2627
  mode: "day" | "month" | "year";
2628
+ max: string;
2628
2629
  numOfMonths: number;
2629
2630
  modelValue: string;
2630
2631
  defaultValue: string;
2631
2632
  min: string;
2632
- max: string;
2633
2633
  isDateUnavailable: (date: DateValue) => boolean;
2634
2634
  locale: string;
2635
2635
  week: boolean;
@@ -3035,52 +3035,20 @@ type __VLS_WithSlots$18<T, S> = T & {
3035
3035
  };
3036
3036
  //#endregion
3037
3037
  //#region src/components/form/FormField.vue.d.ts
3038
- /**
3039
- * 渲染 TanStack `form.Field` 并经 provide 下发 field 上下文。
3040
- * field 实例只能在 form.Field 的插槽执行期取得(时序早于子组件 setup),
3041
- * 故用 defineComponent + render function 在插槽回调中写入 ShallowRef。
3042
- */
3043
- declare const _default$21: typeof __VLS_export$23;
3044
- declare const __VLS_export$23: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
3045
- /** 字段名(TanStack 深层 key 的运行时形态) */
3046
- name: {
3047
- type: StringConstructor;
3048
- required: true;
3049
- };
3050
- /** 校验器配置,原样透传(值可为函数或 Standard Schema,如 valibot) */
3051
- validators: {
3052
- type: PropType<Record<string, unknown>>;
3053
- default: any;
3054
- };
3055
- /** 字段模式:value 单值(默认);array 数组字段,解锁 pushValue/removeValue 等行操作 */
3056
- mode: {
3057
- type: PropType<"value" | "array">;
3058
- default: string;
3059
- };
3060
- }>, (() => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
3061
- [key: string]: any;
3062
- }>[]) | (() => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
3063
- [key: string]: any;
3064
- }>), {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
3038
+ interface FormFieldProps {
3065
3039
  /** 字段名(TanStack 深层 key 的运行时形态) */
3066
- name: {
3067
- type: StringConstructor;
3068
- required: true;
3069
- };
3040
+ name: string;
3070
3041
  /** 校验器配置,原样透传(值可为函数或 Standard Schema,如 valibot) */
3071
- validators: {
3072
- type: PropType<Record<string, unknown>>;
3073
- default: any;
3074
- };
3042
+ validators?: Record<string, unknown>;
3075
3043
  /** 字段模式:value 单值(默认);array 数组字段,解锁 pushValue/removeValue 等行操作 */
3076
- mode: {
3077
- type: PropType<"value" | "array">;
3078
- default: string;
3079
- };
3080
- }>> & Readonly<{}>, {
3081
- mode: "value" | "array";
3082
- validators: Record<string, unknown>;
3083
- }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
3044
+ mode?: "value" | "array";
3045
+ }
3046
+ declare const _default$21: typeof __VLS_export$23;
3047
+ declare const __VLS_export$23: import("vue").DefineSetupFnComponent<FormFieldProps, {}, SlotsType<{
3048
+ default?: (props: {
3049
+ field: AnyFieldApi | undefined;
3050
+ }) => VNodeChild;
3051
+ }>, FormFieldProps & {}, import("vue").PublicProps>;
3084
3052
  //#endregion
3085
3053
  //#region src/components/form/FormItem.vue.d.ts
3086
3054
  declare var __VLS_1$6: {};
@@ -3267,8 +3235,8 @@ declare const __VLS_base$13: import("vue").DefineComponent<import("vue").Extract
3267
3235
  class: string;
3268
3236
  length: number;
3269
3237
  type: "numeric" | "alphanumeric";
3270
- disabled: boolean;
3271
3238
  modelValue: string[];
3239
+ disabled: boolean;
3272
3240
  placeholder: string;
3273
3241
  invalid: boolean;
3274
3242
  otp: boolean;
@@ -3508,7 +3476,6 @@ declare const __VLS_base$12: import("vue").DefineComponent<import("vue").Extract
3508
3476
  lazyMount: boolean;
3509
3477
  unmountOnExit: boolean;
3510
3478
  contentClass: string;
3511
- contentProps: Record<string, unknown>;
3512
3479
  trigger: TriggerMode;
3513
3480
  openDelay: number;
3514
3481
  closeDelay: number;
@@ -3521,6 +3488,7 @@ declare const __VLS_base$12: import("vue").DefineComponent<import("vue").Extract
3521
3488
  to: string | HTMLElement;
3522
3489
  matchTriggerWidth: boolean;
3523
3490
  zIndex: number;
3491
+ contentProps: Record<string, unknown>;
3524
3492
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
3525
3493
  declare const __VLS_export$16: __VLS_WithSlots$12<typeof __VLS_base$12, __VLS_Slots$12>;
3526
3494
  declare const _default$34: typeof __VLS_export$16;
@@ -3583,14 +3551,43 @@ interface SerialColumnOptions {
3583
3551
  /** 起始序号,默认 1 */
3584
3552
  base?: number;
3585
3553
  }
3554
+ /** 操作按钮二次确认配置(气泡形态,复用 Popconfirm);title/description 支持按行求值 */
3555
+ interface TableActionConfirm<T extends DataRecord> {
3556
+ /** 气泡标题(必填) */
3557
+ title: string | ((record: T, index: number) => string);
3558
+ /** 气泡描述(可选) */
3559
+ description?: string | ((record: T, index: number) => string);
3560
+ /** 确认按钮文案,默认 "确定" */
3561
+ confirmText?: string;
3562
+ /** 取消按钮文案,默认 "取消" */
3563
+ cancelText?: string;
3564
+ /** 确认按钮风格;缺省时按钮 variant 为 destructive 则推断 destructive,否则 default */
3565
+ variant?: "default" | "destructive";
3566
+ }
3586
3567
  interface TableActionButton<T extends DataRecord> {
3587
3568
  text: string | ((record: T, index: number) => string);
3588
- onClick?: (record: T, index: number) => void;
3569
+ /** 点击回调;有 confirm 时仅在气泡确认后触发。返回 Promise 时确认钮 loading 并锁定关闭通道,resolve 自动关闭、reject 保持打开(其余返回值忽略) */
3570
+ onClick?: (record: T, index: number) => unknown;
3589
3571
  variant?: ButtonVariants["variant"];
3590
3572
  disabled?: (record: T, index: number) => boolean;
3573
+ /** 二次确认:字符串简写 = 气泡标题;对象形态全字段可配。不传则点击直接执行 onClick */
3574
+ confirm?: string | TableActionConfirm<T>;
3575
+ }
3576
+ /** 图片列配置;单元格值取自 record[column.key],须为非空字符串 URL(其余值渲染为空) */
3577
+ interface ImageColumnOptions<T extends DataRecord> {
3578
+ /** 方形边长 px,默认 40(inline style,不占用 Tailwind 类) */
3579
+ size?: number;
3580
+ /** 图片适应方式,默认 cover */
3581
+ fit?: "cover" | "contain" | "fill" | "none" | "scale-down";
3582
+ /** 外形,默认 rounded(rounded-md) */
3583
+ shape?: "rounded" | "square" | "circle";
3584
+ /** 替代文本,默认 ""(装饰图语义);建议按行传入有意义的描述 */
3585
+ alt?: string | ((record: T, index: number) => string);
3586
+ /** 加载失败时的备用图 URL(仅切换一次,备用也失败则显示占位盒);支持按行求值 */
3587
+ fallback?: string | ((record: T, index: number) => string);
3591
3588
  }
3592
3589
  interface ColumnRenders<T extends DataRecord> {
3593
- /** 逃逸口:自定义渲染器与内置同一范式(对齐 x-render renderRenderColumn) */
3590
+ /** 逃逸口:自定义渲染器与内置同一范式 */
3594
3591
  render: (fn: ColumnRender<T>) => ColumnRender<T>;
3595
3592
  dict: (mapping: DictColumnMapping, options?: DictColumnOptions) => ColumnRender<T>;
3596
3593
  date: (pattern?: DateColumnPattern) => ColumnRender<T>;
@@ -3598,12 +3595,14 @@ interface ColumnRenders<T extends DataRecord> {
3598
3595
  serial: (base?: number) => ColumnRender<T>;
3599
3596
  /** 操作列按钮组;按钮组为行内级(inline-flex),随单元格 align 对齐(默认居中) */
3600
3597
  button: (items: Array<TableActionButton<T> | string>) => ColumnRender<T>;
3598
+ /** 图片缩略图列;原生 img + loading="lazy",失败切 fallback、再失败占位盒 */
3599
+ image: (options?: ImageColumnOptions<T>) => ColumnRender<T>;
3601
3600
  }
3602
3601
  /**
3603
- * 内置列渲染器工厂(对标 x-render table-columns,v1:dict/date/currency/serial/button)。
3602
+ * 内置列渲染器工厂:dict/date/currency/serial/button/image。
3604
3603
  * 返回值直接填入 TableColumnOptions.render;column 参数用于读取字段值。
3605
- * 与 FormRender widget 的 r.xxx() 范式共词根(D10)。
3606
- * @returns 各内置渲染器集合(render/dict/date/currency/serial/button)
3604
+ * 与 FormRender widget 的 r.xxx() 范式共词根。
3605
+ * @returns 各内置渲染器集合(render/dict/date/currency/serial/button/image)
3607
3606
  */
3608
3607
  export declare function columnRenders<T extends DataRecord>(): ColumnRenders<T>;
3609
3608
  //#endregion
@@ -3615,7 +3614,7 @@ interface DataRecord {
3615
3614
  /**
3616
3615
  * 列配置。
3617
3616
  *
3618
- * 命名总纲(D10):能力/性质用 `-able` 形容词(sortable/ellipsis),
3617
+ * 命名总纲:能力/性质用 `-able` 形容词(sortable/ellipsis),
3619
3618
  * 配置值用名词(title/align/width),无 `allow-*`。
3620
3619
  */
3621
3620
  interface TableColumnOptions<T extends DataRecord = DataRecord> {
@@ -3624,22 +3623,38 @@ interface TableColumnOptions<T extends DataRecord = DataRecord> {
3624
3623
  title: string;
3625
3624
  /** 单元格水平对齐;未配置默认居中(表头/表体一致),显式 "left" 退出默认 */
3626
3625
  align?: "left" | "center" | "right";
3627
- /** 列宽(R32)。数字(px):布局硬约束 —— 参与表格 min-width 求和与 fixed 列 sticky 偏移推算;
3626
+ /** 列宽。数字(px):布局硬约束 —— 参与表格 min-width 求和与 fixed 列 sticky 偏移推算;
3628
3627
  * 字符串(如 "10rem"):仅渲染提示值,不参与求和与 sticky。 */
3629
3628
  width?: number | string;
3630
- /** 自定义单元格渲染,取值链 render > formatter > record[key](R17) */
3629
+ /** 自定义单元格渲染,取值链 render > formatter > record[key] */
3631
3630
  render?: (r: ColumnRenders<T>) => ColumnRender<T>;
3632
3631
  /** 纯数据格式化;render 存在时被忽略 */
3633
3632
  formatter?: (record: T) => string | number | Date | undefined;
3634
- /** 超宽截断 + 原生 title 提示(R15);"tooltip" 形态改用库内 Tooltip(不设原生 title) */
3633
+ /** 超宽截断 + 原生 title 提示;"tooltip" 形态改用库内 Tooltip(不设原生 title) */
3635
3634
  ellipsis?: boolean | "tooltip";
3636
3635
  /** 是否可排序(能力开关) */
3637
3636
  sortable?: boolean;
3638
- /** 初始排序方向;需 sortable: true,否则 DEV 警告并忽略(R7) */
3637
+ /** 初始排序方向;需 sortable: true,否则 DEV 警告并忽略 */
3639
3638
  defaultSort?: "asc" | "desc";
3640
3639
  /** 固定列:横向滚动时 sticky 在左/右;须同时提供数字 width,否则 DEV 警告并按普通列渲染 */
3641
3640
  fixed?: "left" | "right";
3642
3641
  }
3642
+ /**
3643
+ * 表头分组成员(多级表头)。
3644
+ *
3645
+ * 仅承载展示语义(title/align);排序、宽度、固定等能力全部下沉到叶子列,
3646
+ * 分组不参与 sortable/fixed/width(配置时 DEV 警告并忽略)。
3647
+ */
3648
+ interface TableColumnGroupOptions<T extends DataRecord = DataRecord> {
3649
+ /** 分组标题(表头单元格文本) */
3650
+ title: string;
3651
+ /** 分组单元格水平对齐;未配置默认居中 */
3652
+ align?: "left" | "center" | "right";
3653
+ /** 子列节点(叶子列或更深分组),任意层级 */
3654
+ children: TableColumnNode<T>[];
3655
+ }
3656
+ /** 列节点:叶子列或分组(递归),defineTable/defineColumns 的入参元素类型 */
3657
+ type TableColumnNode<T extends DataRecord = DataRecord> = TableColumnOptions<T> | TableColumnGroupOptions<T>;
3643
3658
  interface PageableOptions {
3644
3659
  /** 1-based 页码(对外 API 唯一口径) */
3645
3660
  pageIndex: number;
@@ -3659,12 +3674,13 @@ interface TableLoadParams<T extends DataRecord = DataRecord> {
3659
3674
  page: PageableOptions;
3660
3675
  /** 无排序或已取消排序时为 undefined */
3661
3676
  sort?: SortableOptions;
3662
- /** 回写数据;total 缺省时保留旧值(R10) */
3677
+ /** 回写数据;total 缺省时保留旧值 */
3663
3678
  update: (data: T[], total?: number) => void;
3664
3679
  }
3665
3680
  /** defineTable 的声明式配置 */
3666
3681
  interface DefineTableOptions<T extends DataRecord = DataRecord> {
3667
- columns: TableColumnOptions<T>[];
3682
+ /** 列节点树:叶子列或分组(多级表头),任意层级;扁平数组天然合法 */
3683
+ columns: TableColumnNode<T>[];
3668
3684
  /** 服务端模式数据源;与 data 二选一,onLoad 优先 */
3669
3685
  onLoad?: (params: TableLoadParams<T>) => void | Promise<unknown>;
3670
3686
  /** 静态模式数据源(本地分页/排序) */
@@ -3672,15 +3688,15 @@ interface DefineTableOptions<T extends DataRecord = DataRecord> {
3672
3688
  /** 是否在挂载后自动加载,默认 true;仅服务端模式生效 */
3673
3689
  autoLoad?: boolean;
3674
3690
  /**
3675
- * 每页条数 / 受控每页条数(D11)。约定:传入(非 undefined)即受控,缺省(undefined)时
3676
- * 以默认 10 行运行;R9 归位:pageIndex 未受控时内部归位第 1 页并经 update:page-index 通知,
3691
+ * 每页条数 / 受控每页条数。约定:传入(非 undefined)即受控,缺省(undefined)时
3692
+ * 以默认 10 行运行;页码归位:pageIndex 未受控时内部归位第 1 页并经 update:page-index 通知,
3677
3693
  * 两个都受控时由父层自行联动。支持传 ref/getter(聚合式受控)
3678
3694
  */
3679
3695
  pageSize?: MaybeRefOrGetter<number | undefined>;
3680
3696
  pageSizeOpts?: number[];
3681
- /** 行选择:radio 单选 / checkbox 多选;字符串为简写(S2) */
3697
+ /** 行选择:radio 单选 / checkbox 多选;字符串为简写 */
3682
3698
  rowSelection?: "radio" | "checkbox" | TableSelectionOptions<T>;
3683
- /** 行主键字段;rowSelection 启用且此值无效时禁用选择(S1) */
3699
+ /** 行主键字段;rowSelection 启用且此值无效时禁用选择 */
3684
3700
  rowKey?: string;
3685
3701
  /**
3686
3702
  * 搜索表单(defineForm 返回值):仅服务端模式生效,每次 onLoad 的 form 参数
@@ -3696,30 +3712,52 @@ interface DefineTableOptions<T extends DataRecord = DataRecord> {
3696
3712
  /** 树形数据:子行展开/收起(展开按钮在首个业务列内);配置无效时 DEV 警告并忽略 */
3697
3713
  tree?: TreeOptions;
3698
3714
  /**
3699
- * 受控页码(1-based,D11)。约定:传入(非 undefined)即受控,缺省保持非受控;
3715
+ * 行拖拽排序(仅当前页内,把手列触发):true 或对象配置。
3716
+ * 与 tree/virtual 互斥(DEV 警告并忽略);列排序激活期间把手置灰;
3717
+ * 当前页存在缺 rowKey 字段的记录时禁用(DEV 警告一次)。
3718
+ * 静态模式引擎先行重排内部数据并经 drag-sort 通知(调用方应回写自身数据源);
3719
+ * 服务端模式只发 drag-sort,由调用方持久化后 reload
3720
+ */
3721
+ draggable?: boolean | TableDraggableOptions<T>;
3722
+ /**
3723
+ * 受控页码(1-based)。约定:传入(非 undefined)即受控,缺省保持非受控;
3700
3724
  * 内部翻页经 update:page-index 通知,外部变更经受控 watch 同步(语义等值跳过,防回弹循环)
3701
3725
  */
3702
3726
  pageIndex?: MaybeRefOrGetter<number | undefined>;
3703
3727
  /** 受控排序。内部/外部变化均经 sort-change 通知;指向不可排序列时 DEV 警告并忽略 */
3704
3728
  sort?: MaybeRefOrGetter<SortableOptions | undefined>;
3705
- /** 受控选中集(数组,与 update:selected-keys 载荷同构)。经 setSelection 写入(S5 过滤/S12 待定 key 继承) */
3729
+ /** 受控选中集(数组,与 update:selected-keys 载荷同构)。经 setSelection 写入(selectable 过滤、待定 key 继承) */
3706
3730
  selectedKeys?: MaybeRefOrGetter<Array<string | number> | undefined>;
3707
3731
  /**
3708
- * 列显隐:默认可见列集(R21「重置」基准;未知 key 静默忽略;未传 = 全部可见)。
3709
- * 列显隐不触发 onLoad、不重置 pageIndex/sort/selectedKeys(R25)
3732
+ * 列显隐:默认可见列集(「重置」基准;未知 key 静默忽略;未传 = 全部可见)。
3733
+ * 列显隐不触发 onLoad、不重置 pageIndex/sort/selectedKeys
3710
3734
  */
3711
3735
  columnVisibility?: ColumnVisibilityOptions;
3712
3736
  /**
3713
3737
  * 受控可见列 key(columns 原序子集)。约定:传入(非 undefined)即受控;
3714
- * 内部显隐经 update:visible-keys 通知;空数组钳制为首列可见(R24,warn 一次)
3738
+ * 内部显隐经 update:visible-keys 通知;空数组钳制为首列可见(warn 一次)
3715
3739
  */
3716
3740
  visibleKeys?: MaybeRefOrGetter<string[] | undefined>;
3717
3741
  /**
3718
3742
  * 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时
3719
- * DEV 警告 definition 优先(R26)
3743
+ * DEV 警告 definition 优先
3720
3744
  */
3721
3745
  defaultVisibleKeys?: MaybeRefOrGetter<string[] | undefined>;
3722
3746
  }
3747
+ /** 行拖拽排序配置(draggable 对象形态;true 等价 {}) */
3748
+ interface TableDraggableOptions<T extends DataRecord = DataRecord> {
3749
+ /** 行级可拖过滤(对齐 selectable 范式);返回 false 的行把手置灰 */
3750
+ draggable?: (record: T) => boolean;
3751
+ /** 把手列宽,默认 32(对齐 selection.width 范式) */
3752
+ width?: number;
3753
+ }
3754
+ /** drag-sort 事件载荷:from/to 为页内索引(0-based,与 rows 同口径);rows = 当前页新行序 */
3755
+ interface TableDragSortPayload<T extends DataRecord = DataRecord> {
3756
+ from: number;
3757
+ to: number;
3758
+ record: T;
3759
+ rows: T[];
3760
+ }
3723
3761
  /** 树形数据配置(T 系列) */
3724
3762
  interface TreeOptions {
3725
3763
  /** 子行字段名,默认 "children" */
@@ -3729,9 +3767,9 @@ interface TreeOptions {
3729
3767
  /** 每层缩进 px,默认 16 */
3730
3768
  indentSize?: number;
3731
3769
  }
3732
- /** 列显隐配置(R20–R24) */
3770
+ /** 列显隐配置 */
3733
3771
  interface ColumnVisibilityOptions {
3734
- /** 默认可见列 key 列表(R21「重置」基准);未知 key 静默忽略;未传 = 全部可见 */
3772
+ /** 默认可见列 key 列表(「重置」基准);未知 key 静默忽略;未传 = 全部可见 */
3735
3773
  defaultVisibleKeys?: string[];
3736
3774
  }
3737
3775
  /** 行选择配置(S 系列) */
@@ -3739,11 +3777,11 @@ interface TableSelectionOptions<T extends DataRecord = DataRecord> {
3739
3777
  type: "radio" | "checkbox";
3740
3778
  /** 选择列宽,默认 48 */
3741
3779
  width?: number;
3742
- /** 行级可选过滤;false 的行选择控件置灰且被全选跳过(S5) */
3780
+ /** 行级可选过滤;false 的行选择控件置灰且被全选跳过 */
3743
3781
  selectable?: (record: T) => boolean;
3744
- /** radio 再点已选中行是否取消,默认 true(S4) */
3782
+ /** radio 再点已选中行是否取消,默认 true */
3745
3783
  cancelable?: boolean;
3746
- /** 翻页/重载后是否保留选中,默认 true(S6) */
3784
+ /** 翻页/重载后是否保留选中,默认 true */
3747
3785
  reserveOnPageChange?: boolean;
3748
3786
  }
3749
3787
  /** useTableRender 的入参:data 额外支持 ref/getter(拆分模式下 props 天然响应式) */
@@ -3753,6 +3791,11 @@ interface UseTableRenderOptions<T extends DataRecord = DataRecord> extends Omit<
3753
3791
  /** defineTable / useTableRender 的返回物:列配置 + 引擎实例 + 只读状态 + 实例动作 */
3754
3792
  interface TableRenderDefinition<T extends DataRecord = DataRecord> {
3755
3793
  columns: TableColumnOptions<T>[];
3794
+ /**
3795
+ * 原始列节点树(表头矩阵与列设置面板的树形结构来源)。
3796
+ * 可选:手工构造定义对象时缺省,组件侧回退为扁平的 `columns`(单级表头)。
3797
+ */
3798
+ columnTree?: TableColumnNode<T>[];
3756
3799
  /** TanStack 表格实例(逃逸舱口) */
3757
3800
  table: Table<T>;
3758
3801
  page: Readonly<PageableOptions>;
@@ -3762,26 +3805,26 @@ interface TableRenderDefinition<T extends DataRecord = DataRecord> {
3762
3805
  loading: Readonly<{
3763
3806
  value: boolean;
3764
3807
  }>;
3765
- /** 重新加载;resetPage 为 true 时先回到第 1 页(R12) */
3808
+ /** 重新加载;resetPage 为 true 时先回到第 1 页 */
3766
3809
  reload: (resetPage?: boolean) => void;
3767
- /** 排序三态切换:无 → asc → desc → 取消(R8) */
3810
+ /** 排序三态切换:无 → asc → desc → 取消 */
3768
3811
  toggleSort: (key: string) => void;
3769
3812
  setPageIndex: (pageIndex: number) => void;
3770
3813
  setPageSize: (pageSize: number) => void;
3771
- /** 选中行快照(含跨页保留行;跨页行可能为过期数据,见 S6) */
3814
+ /** 选中行快照(含跨页保留行;跨页行可能为过期数据) */
3772
3815
  selection: Readonly<{
3773
3816
  value: T[];
3774
- /** rowSelection 配置有效(含 rowKey 就绪)时为 true(S1) */
3817
+ /** rowSelection 配置有效(含 rowKey 就绪)时为 true */
3775
3818
  enabled: boolean;
3776
3819
  type: "radio" | "checkbox";
3777
3820
  width: number;
3778
3821
  }>;
3779
- /** 选中主键集合;每次选中集变化替换为新 Set(S7) */
3822
+ /** 选中主键集合;每次选中集变化替换为新 Set */
3780
3823
  selectedKeys: Readonly<Ref<Set<string | number>>>;
3781
- /** 程序化设置选中集;不存在的 key 保留(S12) */
3824
+ /** 程序化设置选中集;不存在的 key 保留 */
3782
3825
  setSelection: (keys: Array<string | number>) => void;
3783
3826
  clearSelection: () => void;
3784
- /** 行控件切换:checked 为 false 时移除(radio 受 cancelable 约束,S4) */
3827
+ /** 行控件切换:checked 为 false 时移除(radio 受 cancelable 约束) */
3785
3828
  toggleRowSelected: (key: string, checked: boolean) => void;
3786
3829
  /** 搜索表单定义(options.search 校验后的回传,供 TableRender 渲染搜索区;被忽略时为 undefined) */
3787
3830
  search: FormRenderDefinition<any> | undefined;
@@ -3793,24 +3836,31 @@ interface TableRenderDefinition<T extends DataRecord = DataRecord> {
3793
3836
  height: number | string | undefined;
3794
3837
  /** 树形配置(引擎校验后的回传,供组件读取 indentSize;无效配置被忽略时为 undefined) */
3795
3838
  tree: TreeOptions | undefined;
3839
+ /** 行拖拽配置(引擎校验后的回传;与 tree/virtual 冲突被忽略时为 undefined) */
3840
+ draggable: TableDraggableOptions<T> | undefined;
3841
+ /**
3842
+ * 页内重排(from/to 为页内 0-based 索引):静态模式先行重排内部全量数据,
3843
+ * 服务端模式不改内部数据;返回 drag-sort 载荷(守卫不通过/无效索引时为 undefined)
3844
+ */
3845
+ reorderRows: (from: number, to: number) => TableDragSortPayload<T> | undefined;
3796
3846
  /** 最近一次 onLoad 失败的 Error(仅服务端模式产生);下一次 load 开始时清除 */
3797
3847
  error: Readonly<Ref<Error | undefined>>;
3798
3848
  /** 可见列 key(columns 原序子集);受控/非受控统一投影 */
3799
3849
  visibleKeys: Readonly<Ref<readonly string[]>>;
3800
- /** 列显隐动作:规范化(未知忽略、columns 原序、空钳制为首列 R24)后更新 */
3850
+ /** 列显隐动作:规范化(未知忽略、columns 原序、空钳制为首列)后更新 */
3801
3851
  setVisibleKeys: (keys: string[]) => void;
3802
- /** 解析后的默认可见集(R21 重置基准;未配置为 undefined = 全部可见) */
3852
+ /** 解析后的默认可见集(重置基准;未配置为 undefined = 全部可见) */
3803
3853
  defaultVisibleKeys: string[] | undefined;
3804
3854
  /** 聚合式列显隐配置回传(拆分式为 undefined) */
3805
3855
  columnVisibility: ColumnVisibilityOptions | undefined;
3806
- /** 内部装配口:拆分式由 TableRender 在 setup 时回填 rowKey(S1) */
3856
+ /** 内部装配口:拆分式由 TableRender 在 setup 时回填 rowKey */
3807
3857
  setRowKey: (rowKey: string | undefined) => void;
3808
3858
  }
3809
3859
  //#endregion
3810
3860
  //#region src/components/table-render/TablePagination.vue.d.ts
3811
3861
  declare const __VLS_export$13: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
3812
- /** 组合式:传 defineTable 返回值,自动接线 page/动作并按 R13 单页自隐藏;
3813
- * 与手动分页 props 同传时以 definition 为准(DEV 警告,R29/R4 对齐) */
3862
+ /** 组合式:传 defineTable 返回值,自动接线 page/动作并单页自隐藏;
3863
+ * 与手动分页 props 同传时以 definition 为准(DEV 警告) */
3814
3864
  definition: {
3815
3865
  type: PropType<TableRenderDefinition<any>>;
3816
3866
  };
@@ -3850,8 +3900,8 @@ declare const __VLS_export$13: import("vue").DefineComponent<import("vue").Extra
3850
3900
  "update:pageIndex": (pageIndex: number) => any;
3851
3901
  "update:pageSize": (pageSize: number) => any;
3852
3902
  }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
3853
- /** 组合式:传 defineTable 返回值,自动接线 page/动作并按 R13 单页自隐藏;
3854
- * 与手动分页 props 同传时以 definition 为准(DEV 警告,R29/R4 对齐) */
3903
+ /** 组合式:传 defineTable 返回值,自动接线 page/动作并单页自隐藏;
3904
+ * 与手动分页 props 同传时以 definition 为准(DEV 警告) */
3855
3905
  definition: {
3856
3906
  type: PropType<TableRenderDefinition<any>>;
3857
3907
  };
@@ -3923,9 +3973,9 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
3923
3973
  type: StringConstructor;
3924
3974
  required: true;
3925
3975
  };
3926
- /** 拆分式:与 definition 二选一,definition 优先 */
3976
+ /** 拆分式:与 definition 二选一,definition 优先(支持分组列节点) */
3927
3977
  columns: {
3928
- type: PropType<TableColumnOptions[]>;
3978
+ type: PropType<TableColumnNode[]>;
3929
3979
  };
3930
3980
  onLoad: {
3931
3981
  type: PropType<(params: TableLoadParams) => void | Promise<unknown>>;
@@ -3937,7 +3987,7 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
3937
3987
  type: PropType<boolean | undefined>;
3938
3988
  default: any;
3939
3989
  };
3940
- /** 每页条数 / 受控每页条数(D11):传入即受控(pageIndex 未受控时 R9 归位内部处理并通知) */
3990
+ /** 每页条数 / 受控每页条数:传入即受控(pageIndex 未受控时页码归位内部处理并通知) */
3941
3991
  pageSize: {
3942
3992
  type: NumberConstructor;
3943
3993
  };
@@ -3973,6 +4023,11 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
3973
4023
  tree: {
3974
4024
  type: PropType<TreeOptions>;
3975
4025
  };
4026
+ /** 行拖拽排序(仅拆分式生效;聚合式请在 defineTable 配置):true 或对象配置;与 tree/virtual 互斥 */
4027
+ draggable: {
4028
+ type: PropType<boolean | TableDraggableOptions>;
4029
+ default: any;
4030
+ };
3976
4031
  /** 受控页码(1-based):传入即受控,缺省非受控;内部翻页经 update:page-index 通知 */
3977
4032
  pageIndex: {
3978
4033
  type: NumberConstructor;
@@ -3989,7 +4044,7 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
3989
4044
  visibleKeys: {
3990
4045
  type: PropType<string[]>;
3991
4046
  };
3992
- /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(R26,definition 优先) */
4047
+ /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(definition 优先) */
3993
4048
  defaultVisibleKeys: {
3994
4049
  type: PropType<string[]>;
3995
4050
  };
@@ -3998,12 +4053,12 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
3998
4053
  type: PropType<boolean | undefined>;
3999
4054
  default: any;
4000
4055
  };
4001
- /** 搜索区渲染开关(R27):false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */
4056
+ /** 搜索区渲染开关:false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */
4002
4057
  showSearch: {
4003
4058
  type: PropType<boolean | undefined>;
4004
4059
  default: any;
4005
4060
  };
4006
- /** 分页条渲染开关(R28):false 关闭内置分页条(组合式外置 TablePagination);缺省模式 R13 不变 */
4061
+ /** 分页条渲染开关:false 关闭内置分页条(组合式外置 TablePagination);缺省模式单页自隐藏不变 */
4007
4062
  showPagination: {
4008
4063
  type: PropType<boolean | undefined>;
4009
4064
  default: any;
@@ -4061,6 +4116,7 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4061
4116
  "load-error": (error: Error) => any;
4062
4117
  "update:visible-keys": (keys: string[]) => any;
4063
4118
  "column-visibility-change": (keys: string[]) => any;
4119
+ "drag-sort": (payload: TableDragSortPayload<DataRecord>) => any;
4064
4120
  }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
4065
4121
  /** 聚合式(推荐):defineTable 返回的定义对象 */
4066
4122
  definition: {
@@ -4071,9 +4127,9 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4071
4127
  type: StringConstructor;
4072
4128
  required: true;
4073
4129
  };
4074
- /** 拆分式:与 definition 二选一,definition 优先 */
4130
+ /** 拆分式:与 definition 二选一,definition 优先(支持分组列节点) */
4075
4131
  columns: {
4076
- type: PropType<TableColumnOptions[]>;
4132
+ type: PropType<TableColumnNode[]>;
4077
4133
  };
4078
4134
  onLoad: {
4079
4135
  type: PropType<(params: TableLoadParams) => void | Promise<unknown>>;
@@ -4085,7 +4141,7 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4085
4141
  type: PropType<boolean | undefined>;
4086
4142
  default: any;
4087
4143
  };
4088
- /** 每页条数 / 受控每页条数(D11):传入即受控(pageIndex 未受控时 R9 归位内部处理并通知) */
4144
+ /** 每页条数 / 受控每页条数:传入即受控(pageIndex 未受控时页码归位内部处理并通知) */
4089
4145
  pageSize: {
4090
4146
  type: NumberConstructor;
4091
4147
  };
@@ -4121,6 +4177,11 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4121
4177
  tree: {
4122
4178
  type: PropType<TreeOptions>;
4123
4179
  };
4180
+ /** 行拖拽排序(仅拆分式生效;聚合式请在 defineTable 配置):true 或对象配置;与 tree/virtual 互斥 */
4181
+ draggable: {
4182
+ type: PropType<boolean | TableDraggableOptions>;
4183
+ default: any;
4184
+ };
4124
4185
  /** 受控页码(1-based):传入即受控,缺省非受控;内部翻页经 update:page-index 通知 */
4125
4186
  pageIndex: {
4126
4187
  type: NumberConstructor;
@@ -4137,7 +4198,7 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4137
4198
  visibleKeys: {
4138
4199
  type: PropType<string[]>;
4139
4200
  };
4140
- /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(R26,definition 优先) */
4201
+ /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(definition 优先) */
4141
4202
  defaultVisibleKeys: {
4142
4203
  type: PropType<string[]>;
4143
4204
  };
@@ -4146,12 +4207,12 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4146
4207
  type: PropType<boolean | undefined>;
4147
4208
  default: any;
4148
4209
  };
4149
- /** 搜索区渲染开关(R27):false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */
4210
+ /** 搜索区渲染开关:false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */
4150
4211
  showSearch: {
4151
4212
  type: PropType<boolean | undefined>;
4152
4213
  default: any;
4153
4214
  };
4154
- /** 分页条渲染开关(R28):false 关闭内置分页条(组合式外置 TablePagination);缺省模式 R13 不变 */
4215
+ /** 分页条渲染开关:false 关闭内置分页条(组合式外置 TablePagination);缺省模式单页自隐藏不变 */
4155
4216
  showPagination: {
4156
4217
  type: PropType<boolean | undefined>;
4157
4218
  default: any;
@@ -4179,7 +4240,9 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4179
4240
  "onLoad-error"?: (error: Error) => any;
4180
4241
  "onUpdate:visible-keys"?: (keys: string[]) => any;
4181
4242
  "onColumn-visibility-change"?: (keys: string[]) => any;
4243
+ "onDrag-sort"?: (payload: TableDragSortPayload<DataRecord>) => any;
4182
4244
  }>, {
4245
+ draggable: boolean | TableDraggableOptions<DataRecord>;
4183
4246
  loading: boolean;
4184
4247
  autoLoad: boolean;
4185
4248
  rowSelection: "radio" | "checkbox" | TableSelectionOptions<DataRecord>;
@@ -4206,10 +4269,10 @@ export declare const PAGE_TABLE_FILL_KEY = "tu-design:page-table-fill";
4206
4269
  * 列定义辅助:补全泛型推导,便于把列配置抽到独立文件。
4207
4270
  *
4208
4271
  * 纯类型辅助,原样返回入参——裸数组同样可直接传给 defineTable(无需此函数)。
4209
- * @param columns - 列配置数组
4210
- * @returns 原样返回的列配置数组
4272
+ * @param columns - 列节点树(叶子列或分组)
4273
+ * @returns 原样返回的列节点树
4211
4274
  */
4212
- export declare function defineColumns<T extends DataRecord = DataRecord>(columns: TableColumnOptions<T>[]): TableColumnOptions<T>[];
4275
+ export declare function defineColumns<T extends DataRecord = DataRecord>(columns: TableColumnNode<T>[]): TableColumnNode<T>[];
4213
4276
  //#endregion
4214
4277
  //#region src/components/table-render/define-table.d.ts
4215
4278
  /**
@@ -4222,6 +4285,27 @@ export declare function defineColumns<T extends DataRecord = DataRecord>(columns
4222
4285
  */
4223
4286
  export declare function defineTable<T extends DataRecord>(config: DefineTableOptions<T>): TableRenderDefinition<T>;
4224
4287
  //#endregion
4288
+ //#region src/components/table-render/columns.d.ts
4289
+ /**
4290
+ * 列节点工具:分组判别与叶子扁平化(多级表头支撑)。
4291
+ *
4292
+ * 设计取向:叶子口径全局不变 —— 引擎(TanStack 列定义)、列显隐、sticky 偏移、
4293
+ * min-width 求和、体单元格矩阵全部继续消费「扁平叶子」,分组能力只叠加在
4294
+ * 表头渲染与列设置面板两处。故此处是唯一的结构归一入口。
4295
+ */
4296
+ /**
4297
+ * 判别节点是否为分组(含 children)。
4298
+ * @param node - 列节点(叶子或分组)
4299
+ * @returns 该节点是否为分组
4300
+ */
4301
+ export declare function isColumnGroup<T extends DataRecord>(node: TableColumnNode<T>): node is TableColumnGroupOptions<T>;
4302
+ /**
4303
+ * 扁平化列节点树为叶子列数组(深度优先,保持声明顺序)。
4304
+ * @param nodes - 列节点树
4305
+ * @returns 深度优先展开的叶子列数组(下游全部消费此层)
4306
+ */
4307
+ export declare function flattenColumns<T extends DataRecord>(nodes: TableColumnNode<T>[]): TableColumnOptions<T>[];
4308
+ //#endregion
4225
4309
  //#region src/components/table-render/useTableRender.d.ts
4226
4310
  /**
4227
4311
  * 表格数据内核:TanStack 无头引擎组装 + 1-based 对外投影 + 实例动作。
@@ -4428,10 +4512,10 @@ declare const __VLS_base$9: import("vue").DefineComponent<import("vue").ExtractP
4428
4512
  lazyMount: boolean;
4429
4513
  unmountOnExit: boolean;
4430
4514
  contentClass: string;
4515
+ contentProps: Record<string, unknown>;
4431
4516
  content: string;
4432
4517
  delayDuration: number;
4433
4518
  closeDuration: number;
4434
- contentProps: Record<string, unknown>;
4435
4519
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
4436
4520
  declare const __VLS_export$10: __VLS_WithSlots$9<typeof __VLS_base$9, __VLS_Slots$9>;
4437
4521
  declare const _default$49: typeof __VLS_export$10;
@@ -4489,11 +4573,11 @@ type __VLS_WithSlots$8<T, S> = T & {
4489
4573
  //#endregion
4490
4574
  //#region src/components/alert/index.d.ts
4491
4575
  export declare const alertVariants: (props?: {
4492
- variant?: "default" | "info" | "success" | "warning" | "error";
4576
+ variant?: "default" | "success" | "warning" | "info" | "error";
4493
4577
  } & import("class-variance-authority/types").ClassProp) => string;
4494
4578
  export type AlertVariants = VariantProps<typeof alertVariants>;
4495
4579
  export declare const alertIconVariants: (props?: {
4496
- variant?: "default" | "info" | "success" | "warning" | "error";
4580
+ variant?: "default" | "success" | "warning" | "info" | "error";
4497
4581
  } & import("class-variance-authority/types").ClassProp) => string;
4498
4582
  /**
4499
4583
  * 内置图标路径(按 variant 形状差异化,保证色弱用户可辨别):
@@ -4552,8 +4636,8 @@ declare const __VLS_export$7: import("vue").DefineComponent<__VLS_Props$1, {}, {
4552
4636
  "onUpdate:value"?: (value: number) => any;
4553
4637
  }>, {
4554
4638
  variant: ProgressVariant;
4555
- indeterminate: boolean;
4556
4639
  max: number;
4640
+ indeterminate: boolean;
4557
4641
  showValue: boolean;
4558
4642
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
4559
4643
  declare const _default$35: typeof __VLS_export$7;
@@ -5177,9 +5261,9 @@ export type TimelineItemVariants = VariantProps<typeof timelineItemVariants>;
5177
5261
  export declare const timelineDotVariants: (props?: {
5178
5262
  mode?: "right" | "alternate";
5179
5263
  size?: "sm" | "default";
5180
- color?: "destructive" | "success" | "warning" | "primary" | "muted";
5264
+ color?: "destructive" | "primary" | "success" | "warning" | "muted";
5181
5265
  hollow?: boolean;
5182
5266
  } & import("class-variance-authority/types").ClassProp) => string;
5183
5267
  export type TimelineDotVariants = VariantProps<typeof timelineDotVariants>;
5184
5268
  //#endregion
5185
- export { _default as Alert, _default$1 as AlertDialog, _default$2 as Avatar, _default$3 as AvatarGroup, _default$4 as Badge, type BindingSpec, _default$5 as Button, _default$6 as Calendar, _default$7 as Card, _default$8 as Cascader, type CheckStrategy, _default$9 as Checkbox, type CheckboxWidgetOptions, type ColumnRenders, _default$10 as ContextMenu, _default$11 as CurrencyInput, type CurrencyUnit, type CurrencyWidgetOptions, type DataRecord, _default$12 as DatePicker, type DatePickerWidgetOptions, _default$13 as DateRangePicker, type DateRangeWidgetOptions, type DefineFormOptions, type DefineTableOptions, _default$14 as Dialog, type DictColumnMapping, type DictColumnOptions, type DictEntryVariant, _default$15 as Drawer, _default$16 as DropdownMenu, _default$17 as Empty, _default$18 as Form, type FormActionsConfig, _default$19 as FormControl, _default$20 as FormDescription, _default$21 as FormField, _default$22 as FormItem, _default$23 as FormLabel, _default$24 as FormMessage, _default$25 as FormRender, type FormRenderDefinition, type FormRenderFormApi, type FormRenderItem, _default$26 as FormSubscribe, _default$27 as Input, type InputWidgetOptions, type Key, _default$28 as Label, type MenuItemOption, _default$29 as MonthPicker, type MonthPickerWidgetOptions, _default$30 as NumberInput, type NumberWidgetOptions, type PageableOptions, _default$31 as PasswordInput, type PasswordWidgetOptions, _default$32 as PinInput, _default$33 as Popconfirm, _default$34 as Popover, _default$35 as Progress, _default$36 as RadioGroup, type RadioGroupWidgetOptions, _default$37 as Select, type SelectItemOption, type SelectWidgetOptions, _default$38 as Separator, type SerialColumnOptions, type SfcOptions, _default$39 as Skeleton, _default$40 as Slider, type SliderWidgetOptions, type SortableOptions, _default$41 as Spin, _default$42 as Switch, type SwitchWidgetOptions, type TabItem, type TableActionButton, type TableColumnOptions, type TableLoadParams, _default$43 as TablePagination, _default$44 as TableRender, type TableRenderDefinition, _default$45 as Tabs, _default$46 as Textarea, type TextareaWidgetOptions, _default$47 as Timeline, type ToastApi, type ToastOptions, type ToastPlacement, type ToastPromiseOptions, _default$48 as ToastProvider, _default$49 as Tooltip, type TreeOption, type TreeOptions, _default$50 as TreeSelect, type UseFormRenderOptions, type UseTableRenderOptions, _default$51 as WeekPicker, type WidgetContext, type WidgetItemOption, type WidgetRenderReturn, type WidgetRenders, _default$52 as YearPicker, type YearPickerWidgetOptions };
5269
+ export { _default as Alert, _default$1 as AlertDialog, _default$2 as Avatar, _default$3 as AvatarGroup, _default$4 as Badge, type BindingSpec, _default$5 as Button, _default$6 as Calendar, _default$7 as Card, _default$8 as Cascader, type CheckStrategy, _default$9 as Checkbox, type CheckboxWidgetOptions, type ColumnRenders, _default$10 as ContextMenu, _default$11 as CurrencyInput, type CurrencyUnit, type CurrencyWidgetOptions, type DataRecord, _default$12 as DatePicker, type DatePickerWidgetOptions, _default$13 as DateRangePicker, type DateRangeWidgetOptions, type DefineFormOptions, type DefineTableOptions, _default$14 as Dialog, type DictColumnMapping, type DictColumnOptions, type DictEntryVariant, _default$15 as Drawer, _default$16 as DropdownMenu, _default$17 as Empty, _default$18 as Form, type FormActionsConfig, _default$19 as FormControl, _default$20 as FormDescription, _default$21 as FormField, _default$22 as FormItem, _default$23 as FormLabel, _default$24 as FormMessage, _default$25 as FormRender, type FormRenderDefinition, type FormRenderFormApi, type FormRenderItem, _default$26 as FormSubscribe, type ImageColumnOptions, _default$27 as Input, type InputWidgetOptions, type Key, _default$28 as Label, type MenuItemOption, _default$29 as MonthPicker, type MonthPickerWidgetOptions, _default$30 as NumberInput, type NumberWidgetOptions, type PageableOptions, _default$31 as PasswordInput, type PasswordWidgetOptions, _default$32 as PinInput, _default$33 as Popconfirm, _default$34 as Popover, _default$35 as Progress, _default$36 as RadioGroup, type RadioGroupWidgetOptions, _default$37 as Select, type SelectItemOption, type SelectWidgetOptions, _default$38 as Separator, type SerialColumnOptions, type SfcOptions, _default$39 as Skeleton, _default$40 as Slider, type SliderWidgetOptions, type SortableOptions, _default$41 as Spin, _default$42 as Switch, type SwitchWidgetOptions, type TabItem, type TableActionButton, type TableActionConfirm, type TableColumnGroupOptions, type TableColumnNode, type TableColumnOptions, type TableDragSortPayload, type TableDraggableOptions, type TableLoadParams, _default$43 as TablePagination, _default$44 as TableRender, type TableRenderDefinition, _default$45 as Tabs, _default$46 as Textarea, type TextareaWidgetOptions, _default$47 as Timeline, type ToastApi, type ToastOptions, type ToastPlacement, type ToastPromiseOptions, _default$48 as ToastProvider, _default$49 as Tooltip, type TreeOption, type TreeOptions, _default$50 as TreeSelect, type UseFormRenderOptions, type UseTableRenderOptions, _default$51 as WeekPicker, type WidgetContext, type WidgetItemOption, type WidgetRenderReturn, type WidgetRenders, _default$52 as YearPicker, type YearPickerWidgetOptions };