@tu-design/vue 0.5.7 → 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 +363 -175
  2. package/dist/index.mjs +1953 -569
  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 +3 -3
  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 +2 -2
  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 +3 -3
  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 +14 -14
  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 +3 -3
  29. package/dist/registry/vue/overlay-shared.json +5 -5
  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 +2 -2
  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 +2 -2
  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 +26 -13
  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 +2 -2
  48. package/dist/registry/vue/toast.json +2 -2
  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 +9 -9
  53. package/dist/registry/vue/utils.json +2 -2
  54. package/dist/registry/vue/week-picker.json +2 -2
  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";
@@ -12,6 +12,11 @@ import { Table } from "@tanstack/vue-table";
12
12
  import { Toast, ToastOptions as ToastOptions$1, ToastPlacement as ToastPlacement$1, ToastPromiseOptions as ToastPromiseOptions$1 } from "@ark-ui/vue/toast";
13
13
  import { PositioningOptions } from "@zag-js/popper";
14
14
  //#region src/lib/utils.d.ts
15
+ /**
16
+ * 合并 Tailwind CSS 类名:clsx 组合条件类名,tailwind-merge 消解冲突规则。
17
+ * @param inputs - 任意数量的类名值(字符串、数组或对象)
18
+ * @returns 消解冲突后的类名字符串
19
+ */
15
20
  export declare function cn(...inputs: ClassValue[]): string;
16
21
  //#endregion
17
22
  //#region src/resolver.d.ts
@@ -30,6 +35,12 @@ export interface ComponentResolveResult {
30
35
  from: string;
31
36
  }
32
37
  export type ComponentResolver = (name: string) => ComponentResolveResult | undefined;
38
+ /**
39
+ * 创建 unplugin-vue-components 的自动导入 Resolver:T 前缀(PascalCase)且命中
40
+ * 白名单的组件名(如 TButton)被解析为对应库导出;其余名称返回 undefined
41
+ * 交由后续 Resolver 或默认流程处理。
42
+ * @returns Resolver 函数(组件名到导入描述的映射)
43
+ */
33
44
  export declare function TuDesignResolver(): ComponentResolver;
34
45
  //#endregion
35
46
  //#region src/components/checkbox/Checkbox.vue.d.ts
@@ -98,10 +109,10 @@ declare const __VLS_base$34: import("vue").DefineComponent<import("vue").Extract
98
109
  }>, {
99
110
  class: string;
100
111
  name: string;
101
- form: string;
102
- disabled: boolean;
103
112
  checked: boolean | "indeterminate";
104
113
  defaultChecked: boolean;
114
+ disabled: boolean;
115
+ form: string;
105
116
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
106
117
  declare const __VLS_export$52: __VLS_WithSlots$34<typeof __VLS_base$34, __VLS_Slots$34>;
107
118
  declare const _default$9: typeof __VLS_export$52;
@@ -118,11 +129,19 @@ type CurrencyUnit = "万" | "元" | "角" | "分";
118
129
  * 解析输入文本为 valueUnit 单位的数值(number|null)。
119
130
  * 全程十进制字符串移位(BigInt),仅在超出整数分精度时一次四舍五入;
120
131
  * 白名单 ^\d*(\.\d*)?$,负号/非法字符/无数字一律 null。
132
+ * @param raw - 用户键入的数字文本(labelUnit 单位)
133
+ * @param labelUnit - 输入文本的货币单位
134
+ * @param valueUnit - 输出数值的目标货币单位
135
+ * @returns valueUnit 单位的数值;格式非法或不含数字时返回 null
121
136
  */
122
137
  export declare function parseCurrency(raw: string, labelUnit: CurrencyUnit, valueUnit: CurrencyUnit): number | null;
123
138
  /**
124
139
  * 受控值(valueUnit 单位)反算为 labelUnit 单位的回显文本。
125
140
  * 值先取整到整数分(吸收浮点噪声),再做十进制移位并去尾零。
141
+ * @param value - 受控值(valueUnit 单位)
142
+ * @param valueUnit - 受控值的货币单位
143
+ * @param labelUnit - 回显文本的目标货币单位
144
+ * @returns labelUnit 单位的回显文本(已去尾零);非有限值返回空串
126
145
  */
127
146
  export declare function formatCurrency(value: number, valueUnit: CurrencyUnit, labelUnit: CurrencyUnit): string;
128
147
  //#endregion
@@ -197,10 +216,10 @@ declare const __VLS_export$51: import("vue").DefineComponent<import("vue").Extra
197
216
  "onUpdate:modelValue"?: (value: number) => any;
198
217
  }>, {
199
218
  class: string;
200
- invalid: boolean;
201
219
  modelValue: number;
202
- placeholder: string;
203
220
  disabled: boolean;
221
+ placeholder: string;
222
+ invalid: boolean;
204
223
  labelUnit: CurrencyUnit;
205
224
  valueUnit: CurrencyUnit;
206
225
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -370,20 +389,20 @@ declare const __VLS_export$50: import("vue").DefineComponent<import("vue").Extra
370
389
  "onUpdate:open"?: (open: boolean) => any;
371
390
  }>, {
372
391
  class: string;
373
- invalid: boolean;
374
392
  max: string;
375
393
  modelValue: string;
376
394
  defaultValue: string;
395
+ min: string;
396
+ isDateUnavailable: (date: DateValue) => boolean;
397
+ locale: string;
398
+ disabled: boolean;
377
399
  open: boolean;
378
400
  defaultOpen: boolean;
379
401
  placeholder: string;
380
- disabled: boolean;
402
+ invalid: boolean;
381
403
  readOnly: boolean;
382
- min: string;
383
404
  closeOnSelect: boolean;
384
- locale: string;
385
405
  positioning: import("@zag-js/popper").PositioningOptions;
386
- isDateUnavailable: (date: DateValue) => boolean;
387
406
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
388
407
  declare const _default$12: typeof __VLS_export$50;
389
408
  //#endregion
@@ -546,21 +565,21 @@ declare const __VLS_export$49: import("vue").DefineComponent<import("vue").Extra
546
565
  "onUpdate:open"?: (open: boolean) => any;
547
566
  }>, {
548
567
  class: string;
549
- invalid: boolean;
550
568
  max: string;
569
+ numOfMonths: number;
551
570
  modelValue: [string, string];
552
571
  defaultValue: [string, string];
572
+ min: string;
573
+ isDateUnavailable: (date: DateValue) => boolean;
574
+ locale: string;
575
+ disabled: boolean;
553
576
  open: boolean;
554
577
  defaultOpen: boolean;
555
578
  placeholder: string;
556
- disabled: boolean;
579
+ invalid: boolean;
557
580
  readOnly: boolean;
558
- min: string;
559
581
  closeOnSelect: boolean;
560
- locale: string;
561
582
  positioning: import("@zag-js/popper").PositioningOptions;
562
- numOfMonths: number;
563
- isDateUnavailable: (date: DateValue) => boolean;
564
583
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
565
584
  declare const _default$13: typeof __VLS_export$49;
566
585
  //#endregion
@@ -723,18 +742,18 @@ declare const __VLS_export$47: import("vue").DefineComponent<import("vue").Extra
723
742
  "onUpdate:open"?: (open: boolean) => any;
724
743
  }>, {
725
744
  class: string;
726
- invalid: boolean;
727
745
  max: string;
728
746
  modelValue: string;
729
747
  defaultValue: string;
748
+ min: string;
749
+ locale: string;
750
+ disabled: boolean;
730
751
  open: boolean;
731
752
  defaultOpen: boolean;
732
753
  placeholder: string;
733
- disabled: boolean;
754
+ invalid: boolean;
734
755
  readOnly: boolean;
735
- min: string;
736
756
  closeOnSelect: boolean;
737
- locale: string;
738
757
  positioning: import("@zag-js/popper").PositioningOptions;
739
758
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
740
759
  declare const _default$29: typeof __VLS_export$47;
@@ -892,20 +911,20 @@ declare const __VLS_export$46: import("vue").DefineComponent<import("vue").Extra
892
911
  "onUpdate:open"?: (open: boolean) => any;
893
912
  }>, {
894
913
  class: string;
895
- invalid: boolean;
896
914
  max: string;
897
915
  modelValue: string;
898
916
  defaultValue: string;
917
+ min: string;
918
+ isDateUnavailable: (date: DateValue) => boolean;
919
+ locale: string;
920
+ disabled: boolean;
899
921
  open: boolean;
900
922
  defaultOpen: boolean;
901
923
  placeholder: string;
902
- disabled: boolean;
924
+ invalid: boolean;
903
925
  readOnly: boolean;
904
- min: string;
905
926
  closeOnSelect: boolean;
906
- locale: string;
907
927
  positioning: import("@zag-js/popper").PositioningOptions;
908
- isDateUnavailable: (date: DateValue) => boolean;
909
928
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
910
929
  declare const _default$51: typeof __VLS_export$46;
911
930
  //#endregion
@@ -990,11 +1009,11 @@ declare const __VLS_base$33: import("vue").DefineComponent<import("vue").Extract
990
1009
  "onUpdate:modelValue"?: (value: number) => any;
991
1010
  }>, {
992
1011
  class: string;
993
- invalid: boolean;
994
1012
  max: number;
995
1013
  modelValue: number;
996
- disabled: boolean;
997
1014
  min: number;
1015
+ disabled: boolean;
1016
+ invalid: boolean;
998
1017
  step: number;
999
1018
  formatOptions: Intl.NumberFormatOptions;
1000
1019
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -1007,7 +1026,11 @@ type __VLS_WithSlots$33<T, S> = T & {
1007
1026
  };
1008
1027
  //#endregion
1009
1028
  //#region src/components/number-input/utils.d.ts
1010
- /** Ark ValueChangeDetails → number|null(空串/NaN 归一 null,numberOrNull 为可单测的纯函数) */
1029
+ /**
1030
+ * Ark ValueChangeDetails → number|null(空串/NaN 归一 null,numberOrNull 为可单测的纯函数)
1031
+ * @param details - Ark NumberInput 的 ValueChangeDetails
1032
+ * @returns 有效数字;空串或 NaN 时返回 null
1033
+ */
1011
1034
  export declare function numberOrNull(details: {
1012
1035
  value: string;
1013
1036
  valueAsNumber: number;
@@ -1090,10 +1113,10 @@ declare const __VLS_base$32: import("vue").DefineComponent<import("vue").Extract
1090
1113
  "onUpdate:visible"?: (visible: boolean) => any;
1091
1114
  }>, {
1092
1115
  class: string;
1093
- invalid: boolean;
1094
1116
  modelValue: string;
1095
- placeholder: string;
1096
1117
  disabled: boolean;
1118
+ placeholder: string;
1119
+ invalid: boolean;
1097
1120
  visible: boolean;
1098
1121
  autoComplete: "current-password" | "new-password";
1099
1122
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -1363,10 +1386,10 @@ declare const __VLS_export$42: import("vue").DefineComponent<import("vue").Extra
1363
1386
  class: string;
1364
1387
  modelValue: Key | Key[];
1365
1388
  defaultValue: Key | Key[];
1389
+ disabled: boolean;
1366
1390
  open: boolean;
1367
1391
  defaultOpen: boolean;
1368
1392
  placeholder: string;
1369
- disabled: boolean;
1370
1393
  positioning: import("@zag-js/popper").PositioningOptions;
1371
1394
  multiple: boolean;
1372
1395
  checkable: boolean;
@@ -1577,10 +1600,10 @@ declare const __VLS_export$41: import("vue").DefineComponent<import("vue").Extra
1577
1600
  class: string;
1578
1601
  modelValue: Key | Key[];
1579
1602
  defaultValue: Key | Key[];
1603
+ disabled: boolean;
1580
1604
  open: boolean;
1581
1605
  defaultOpen: boolean;
1582
1606
  placeholder: string;
1583
- disabled: boolean;
1584
1607
  positioning: import("@zag-js/popper").PositioningOptions;
1585
1608
  multiple: boolean;
1586
1609
  checkable: boolean;
@@ -1798,9 +1821,9 @@ declare const __VLS_base$29: import("vue").DefineComponent<import("vue").Extract
1798
1821
  "onUpdate:checked"?: (checked: boolean) => any;
1799
1822
  }>, {
1800
1823
  class: string;
1801
- disabled: boolean;
1802
1824
  checked: boolean;
1803
1825
  defaultChecked: boolean;
1826
+ disabled: boolean;
1804
1827
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
1805
1828
  declare const __VLS_export$38: __VLS_WithSlots$29<typeof __VLS_base$29, __VLS_Slots$29>;
1806
1829
  declare const _default$42: typeof __VLS_export$38;
@@ -1969,18 +1992,18 @@ declare const __VLS_export$36: import("vue").DefineComponent<import("vue").Extra
1969
1992
  "onUpdate:open"?: (open: boolean) => any;
1970
1993
  }>, {
1971
1994
  class: string;
1972
- invalid: boolean;
1973
1995
  max: string;
1974
1996
  modelValue: string;
1975
1997
  defaultValue: string;
1998
+ min: string;
1999
+ locale: string;
2000
+ disabled: boolean;
1976
2001
  open: boolean;
1977
2002
  defaultOpen: boolean;
1978
2003
  placeholder: string;
1979
- disabled: boolean;
2004
+ invalid: boolean;
1980
2005
  readOnly: boolean;
1981
- min: string;
1982
2006
  closeOnSelect: boolean;
1983
- locale: string;
1984
2007
  positioning: import("@zag-js/popper").PositioningOptions;
1985
2008
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
1986
2009
  declare const _default$52: typeof __VLS_export$36;
@@ -2025,7 +2048,7 @@ type TextareaWidgetOptions = SfcOptions<typeof _default$46> & {
2025
2048
  /**
2026
2049
  * v3 命名穿透:选项字段即组件 prop 名 `items`——显式必填(Partial 化会退化为可选,
2027
2050
  * 缺失时 Select.vue collection 计算在首渲染崩溃);placeholder 已是 Select 单组件
2028
- * 的正式 prop,不再 Omit,渲染时做 item 级缺省回退(I1)。
2051
+ * 的正式 prop,不再 Omit,渲染时做 item 级缺省回退。
2029
2052
  */
2030
2053
  type SelectWidgetOptions = Omit<SfcOptions<typeof _default$37>, "items"> & {
2031
2054
  items: WidgetItemOption[];
@@ -2087,7 +2110,7 @@ interface FormRenderItem<T extends object> {
2087
2110
  placeholder?: string;
2088
2111
  /**
2089
2112
  * 默认值(值或同步工厂);defineForm 据此派生 defaultValues。
2090
- * 类型为 T 值域联合 T[keyof T](无 per-item 精确联动,强于 x-render 的 any)。
2113
+ * 类型为 T 值域联合 T[keyof T](无 per-item 精确联动)。
2091
2114
  */
2092
2115
  default?: T[keyof T] | (() => T[keyof T]);
2093
2116
  /** 栅格跨度:数字 = 占 n 列(须 ≤ 实际列数);"full" = 整行 */
@@ -2103,15 +2126,15 @@ interface FormRenderItem<T extends object> {
2103
2126
  /** 逃逸口:原样合并到控件 vnode 的 props */
2104
2127
  componentProps?: Record<string, unknown>;
2105
2128
  }
2106
- /** 按钮预设(A1 块级互斥:actions 存在时 <FormRender> 组件按钮 props 全量忽略) */
2129
+ /** 按钮预设(块级互斥:actions 存在时 <FormRender> 组件按钮 props 全量忽略) */
2107
2130
  interface FormActionsConfig {
2108
2131
  /** 搜索按钮,缺省 false */
2109
2132
  searchable?: boolean;
2110
2133
  /** 提交按钮,缺省 false */
2111
2134
  submitable?: boolean;
2112
- /** 重置按钮;缺省跟随 searchable(A2,域内解析) */
2135
+ /** 重置按钮;缺省跟随 searchable(域内解析) */
2113
2136
  resetable?: boolean;
2114
- /** 取消按钮;缺省跟随 submitable(A2,域内解析) */
2137
+ /** 取消按钮;缺省跟随 submitable(域内解析) */
2115
2138
  cancelable?: boolean;
2116
2139
  searchText?: string;
2117
2140
  submitText?: string;
@@ -2122,7 +2145,7 @@ interface FormRenderDefinition<T extends object> {
2122
2145
  form: FormRenderFormApi;
2123
2146
  /** 重置到 items.default(搜索表单"重置"语义) */
2124
2147
  resetToDefaults: () => void;
2125
- /** 全量校验并返回是否通过(R30);不触发 FormRender 的 search/submit 事件。
2148
+ /** 全量校验并返回是否通过;不触发 FormRender 的 search/submit 事件。
2126
2149
  * 组合式外部查询标准链路:`if (await table.search.submit()) table.reload(true)` */
2127
2150
  submit: () => Promise<boolean>;
2128
2151
  /** 按钮预设投影(引擎从 options 七项直传;未配置为 undefined——此时组件按钮 props 全量生效) */
@@ -2256,7 +2279,7 @@ interface DefineFormOptions<T extends object> {
2256
2279
  onSubmit?: (ctx: {
2257
2280
  value: T;
2258
2281
  }) => void | Promise<void>;
2259
- /** 按钮预设七项(A1 块级互斥):显式传任一项即投影为 definition.actions,组件按钮 props 全量忽略 */
2282
+ /** 按钮预设七项(块级互斥):显式传任一项即投影为 definition.actions,组件按钮 props 全量忽略 */
2260
2283
  searchable?: boolean;
2261
2284
  submitable?: boolean;
2262
2285
  resetable?: boolean;
@@ -2274,10 +2297,12 @@ interface DefineFormOptions<T extends object> {
2274
2297
  * - `items` / `form` 传给 `<FormRender>`(支持 `:definition` 单 prop 或 `:form` + `:items` 拆分);
2275
2298
  * - `form` 可直接 `reset()` / `validate()` / `handleSubmit()`;
2276
2299
  * - `resetToDefaults()` 重置到 `items.default`(搜索表单"重置"语义);
2277
- * - `submit()` 全量校验并返回是否通过(R30,组合式查询链路);
2278
- * - `actions` 按钮预设(searchable 等七项直传):存在时 `<FormRender>` 组件按钮 props 全量忽略(A1 块级互斥)。
2300
+ * - `submit()` 全量校验并返回是否通过(组合式查询链路);
2301
+ * - `actions` 按钮预设(searchable 等七项直传):存在时 `<FormRender>` 组件按钮 props 全量忽略(块级互斥)。
2279
2302
  *
2280
2303
  * 须在组件 setup 中调用(TanStack useForm 约束)。
2304
+ * @param config - 表单配置:字段定义、校验 schema、提交回调、按钮预设七项与 TanStack 透传项
2305
+ * @returns 表单渲染 definition(items + form + resetToDefaults + submit + actions?),直接传给 <FormRender>
2281
2306
  */
2282
2307
  export declare function defineForm<T extends object>(config: DefineFormOptions<T>): FormRenderDefinition<T>;
2283
2308
  //#endregion
@@ -2289,7 +2314,7 @@ interface UseFormRenderOptions<T extends object> {
2289
2314
  onSubmit?: (ctx: {
2290
2315
  value: T;
2291
2316
  }) => void | Promise<void>;
2292
- /** 按钮预设七项(A1):显式传任一项即投影为 actions(definition 域,组件按钮 props 全量忽略) */
2317
+ /** 按钮预设七项:显式传任一项即投影为 actions(definition 域,组件按钮 props 全量忽略) */
2293
2318
  searchable?: boolean;
2294
2319
  submitable?: boolean;
2295
2320
  resetable?: boolean;
@@ -2306,6 +2331,8 @@ interface UseFormRenderOptions<T extends object> {
2306
2331
  * - `defaultValues` 从 `items[].default` 派生(值或同步工厂,缺省 null)——单一真相源;
2307
2332
  * - 显式泛型 `useForm<T>`,保住 onSubmit `{ value: T }` 全链路推断;
2308
2333
  * - 须在组件 setup 中调用(TanStack useForm 内部 `onMounted(formApi.mount)`)。
2334
+ * @param options - 表单选项:字段定义、校验 schema、提交回调、按钮预设七项与 TanStack 透传项
2335
+ * @returns 表单渲染 definition(items + form + resetToDefaults + submit + actions?)
2309
2336
  */
2310
2337
  export declare function useFormRender<T extends object>(options: UseFormRenderOptions<T>): FormRenderDefinition<T>;
2311
2338
  //#endregion
@@ -2314,6 +2341,7 @@ export declare function useFormRender<T extends object>(options: UseFormRenderOp
2314
2341
  * widget 注册表:`r.input({...})` 等柯里化工厂的运行时对象。
2315
2342
  * 文件按绑定形态聚合:input / model-value(modelValue 系)/ boolean(checked 系)/
2316
2343
  * value(radioGroup/slider)/ select(多子组件组装)。
2344
+ * @returns 各 widget 类型的柯里化工厂映射(render 为恒等直通),供 FormRender 渲染时调用
2317
2345
  */
2318
2346
  export declare function widgetRenders<T extends object>(): WidgetRenders<T>;
2319
2347
  //#endregion
@@ -2340,6 +2368,9 @@ export declare const SLIDER: BindingSpec;
2340
2368
  /**
2341
2369
  * TanStack field → 控件 props 的统一绑定:
2342
2370
  * 值回显(field.state.value)+ 写回(handleChange)+ 失焦(handleBlur)。
2371
+ * @param field - TanStack 表单字段实例,提供值读取与变更/失焦句柄
2372
+ * @param spec - 绑定形态描述,决定值 prop 名、事件名与可选的双向转换
2373
+ * @returns 可展开到组件 props 上的对象(值 prop、onUpdate:<event>、onBlur)
2343
2374
  */
2344
2375
  export declare function bindField(field: AnyFieldApi, spec: BindingSpec): {
2345
2376
  [x: string]: any;
@@ -2595,12 +2626,12 @@ declare const __VLS_base$23: import("vue").DefineComponent<import("vue").Extract
2595
2626
  }>, {
2596
2627
  mode: "day" | "month" | "year";
2597
2628
  max: string;
2629
+ numOfMonths: number;
2598
2630
  modelValue: string;
2599
2631
  defaultValue: string;
2600
2632
  min: string;
2601
- locale: string;
2602
- numOfMonths: number;
2603
2633
  isDateUnavailable: (date: DateValue) => boolean;
2634
+ locale: string;
2604
2635
  week: boolean;
2605
2636
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
2606
2637
  declare const __VLS_export$30: __VLS_WithSlots$23<typeof __VLS_base$23, __VLS_Slots$23>;
@@ -2784,14 +2815,14 @@ declare const __VLS_base$21: import("vue").DefineComponent<import("vue").Extract
2784
2815
  }>> & Readonly<{
2785
2816
  "onUpdate:open"?: (open: boolean) => any;
2786
2817
  }>, {
2787
- title: string;
2788
2818
  open: boolean;
2789
2819
  defaultOpen: boolean;
2790
2820
  lazyMount: boolean;
2791
2821
  unmountOnExit: boolean;
2792
- contentClass: string;
2822
+ title: string;
2793
2823
  description: string;
2794
2824
  showCloseButton: boolean;
2825
+ contentClass: string;
2795
2826
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
2796
2827
  declare const __VLS_export$28: __VLS_WithSlots$21<typeof __VLS_base$21, __VLS_Slots$21>;
2797
2828
  declare const _default$14: typeof __VLS_export$28;
@@ -2875,10 +2906,10 @@ declare const __VLS_base$20: import("vue").DefineComponent<import("vue").Extract
2875
2906
  default: any;
2876
2907
  };
2877
2908
  }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
2909
+ "update:open": (open: boolean) => any;
2878
2910
  select: (details: {
2879
2911
  value: string;
2880
2912
  }) => any;
2881
- "update:open": (open: boolean) => any;
2882
2913
  }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
2883
2914
  /** 菜单项描述列表(item/label/separator/group 四种形态,group 可嵌套) */
2884
2915
  items: {
@@ -2920,10 +2951,10 @@ declare const __VLS_base$20: import("vue").DefineComponent<import("vue").Extract
2920
2951
  default: any;
2921
2952
  };
2922
2953
  }>> & Readonly<{
2954
+ "onUpdate:open"?: (open: boolean) => any;
2923
2955
  onSelect?: (details: {
2924
2956
  value: string;
2925
2957
  }) => any;
2926
- "onUpdate:open"?: (open: boolean) => any;
2927
2958
  }>, {
2928
2959
  open: boolean;
2929
2960
  defaultOpen: boolean;
@@ -3004,52 +3035,20 @@ type __VLS_WithSlots$18<T, S> = T & {
3004
3035
  };
3005
3036
  //#endregion
3006
3037
  //#region src/components/form/FormField.vue.d.ts
3007
- /**
3008
- * 渲染 TanStack `form.Field` 并经 provide 下发 field 上下文。
3009
- * field 实例只能在 form.Field 的插槽执行期取得(时序早于子组件 setup),
3010
- * 故用 defineComponent + render function 在插槽回调中写入 ShallowRef。
3011
- */
3012
- declare const _default$21: typeof __VLS_export$23;
3013
- declare const __VLS_export$23: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
3038
+ interface FormFieldProps {
3014
3039
  /** 字段名(TanStack 深层 key 的运行时形态) */
3015
- name: {
3016
- type: StringConstructor;
3017
- required: true;
3018
- };
3019
- /** 校验器配置,原样透传(值可为函数或 Standard Schema,如 valibot) */
3020
- validators: {
3021
- type: PropType<Record<string, unknown>>;
3022
- default: any;
3023
- };
3024
- /** 字段模式:value 单值(默认);array 数组字段,解锁 pushValue/removeValue 等行操作 */
3025
- mode: {
3026
- type: PropType<"value" | "array">;
3027
- default: string;
3028
- };
3029
- }>, (() => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
3030
- [key: string]: any;
3031
- }>[]) | (() => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
3032
- [key: string]: any;
3033
- }>), {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
3034
- /** 字段名(TanStack 深层 key 的运行时形态) */
3035
- name: {
3036
- type: StringConstructor;
3037
- required: true;
3038
- };
3040
+ name: string;
3039
3041
  /** 校验器配置,原样透传(值可为函数或 Standard Schema,如 valibot) */
3040
- validators: {
3041
- type: PropType<Record<string, unknown>>;
3042
- default: any;
3043
- };
3042
+ validators?: Record<string, unknown>;
3044
3043
  /** 字段模式:value 单值(默认);array 数组字段,解锁 pushValue/removeValue 等行操作 */
3045
- mode: {
3046
- type: PropType<"value" | "array">;
3047
- default: string;
3048
- };
3049
- }>> & Readonly<{}>, {
3050
- mode: "value" | "array";
3051
- validators: Record<string, unknown>;
3052
- }, {}, {}, {}, 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>;
3053
3052
  //#endregion
3054
3053
  //#region src/components/form/FormItem.vue.d.ts
3055
3054
  declare var __VLS_1$6: {};
@@ -3235,11 +3234,11 @@ declare const __VLS_base$13: import("vue").DefineComponent<import("vue").Extract
3235
3234
  }>, {
3236
3235
  class: string;
3237
3236
  length: number;
3238
- invalid: boolean;
3239
3237
  type: "numeric" | "alphanumeric";
3240
3238
  modelValue: string[];
3241
- placeholder: string;
3242
3239
  disabled: boolean;
3240
+ placeholder: string;
3241
+ invalid: boolean;
3243
3242
  otp: boolean;
3244
3243
  mask: boolean;
3245
3244
  autoSubmit: boolean;
@@ -3471,11 +3470,12 @@ declare const __VLS_base$12: import("vue").DefineComponent<import("vue").Extract
3471
3470
  }>> & Readonly<{
3472
3471
  "onUpdate:open"?: (open: boolean) => any;
3473
3472
  }>, {
3473
+ disabled: boolean;
3474
3474
  open: boolean;
3475
3475
  defaultOpen: boolean;
3476
- disabled: boolean;
3477
3476
  lazyMount: boolean;
3478
3477
  unmountOnExit: boolean;
3478
+ contentClass: string;
3479
3479
  trigger: TriggerMode;
3480
3480
  openDelay: number;
3481
3481
  closeDelay: number;
@@ -3488,7 +3488,6 @@ declare const __VLS_base$12: import("vue").DefineComponent<import("vue").Extract
3488
3488
  to: string | HTMLElement;
3489
3489
  matchTriggerWidth: boolean;
3490
3490
  zIndex: number;
3491
- contentClass: string;
3492
3491
  contentProps: Record<string, unknown>;
3493
3492
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
3494
3493
  declare const __VLS_export$16: __VLS_WithSlots$12<typeof __VLS_base$12, __VLS_Slots$12>;
@@ -3552,25 +3551,58 @@ interface SerialColumnOptions {
3552
3551
  /** 起始序号,默认 1 */
3553
3552
  base?: number;
3554
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
+ }
3555
3567
  interface TableActionButton<T extends DataRecord> {
3556
3568
  text: string | ((record: T, index: number) => string);
3557
- onClick?: (record: T, index: number) => void;
3569
+ /** 点击回调;有 confirm 时仅在气泡确认后触发。返回 Promise 时确认钮 loading 并锁定关闭通道,resolve 自动关闭、reject 保持打开(其余返回值忽略) */
3570
+ onClick?: (record: T, index: number) => unknown;
3558
3571
  variant?: ButtonVariants["variant"];
3559
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);
3560
3588
  }
3561
3589
  interface ColumnRenders<T extends DataRecord> {
3562
- /** 逃逸口:自定义渲染器与内置同一范式(对齐 x-render renderRenderColumn) */
3590
+ /** 逃逸口:自定义渲染器与内置同一范式 */
3563
3591
  render: (fn: ColumnRender<T>) => ColumnRender<T>;
3564
3592
  dict: (mapping: DictColumnMapping, options?: DictColumnOptions) => ColumnRender<T>;
3565
3593
  date: (pattern?: DateColumnPattern) => ColumnRender<T>;
3566
3594
  currency: (currency?: string, locale?: string) => ColumnRender<T>;
3567
3595
  serial: (base?: number) => ColumnRender<T>;
3596
+ /** 操作列按钮组;按钮组为行内级(inline-flex),随单元格 align 对齐(默认居中) */
3568
3597
  button: (items: Array<TableActionButton<T> | string>) => ColumnRender<T>;
3598
+ /** 图片缩略图列;原生 img + loading="lazy",失败切 fallback、再失败占位盒 */
3599
+ image: (options?: ImageColumnOptions<T>) => ColumnRender<T>;
3569
3600
  }
3570
3601
  /**
3571
- * 内置列渲染器工厂(对标 x-render table-columns,v1:dict/date/currency/serial/button)。
3602
+ * 内置列渲染器工厂:dict/date/currency/serial/button/image。
3572
3603
  * 返回值直接填入 TableColumnOptions.render;column 参数用于读取字段值。
3573
- * 与 FormRender widget 的 r.xxx() 范式共词根(D10)。
3604
+ * 与 FormRender widget 的 r.xxx() 范式共词根。
3605
+ * @returns 各内置渲染器集合(render/dict/date/currency/serial/button/image)
3574
3606
  */
3575
3607
  export declare function columnRenders<T extends DataRecord>(): ColumnRenders<T>;
3576
3608
  //#endregion
@@ -3582,30 +3614,47 @@ interface DataRecord {
3582
3614
  /**
3583
3615
  * 列配置。
3584
3616
  *
3585
- * 命名总纲(D10):能力/性质用 `-able` 形容词(sortable/ellipsis),
3617
+ * 命名总纲:能力/性质用 `-able` 形容词(sortable/ellipsis),
3586
3618
  * 配置值用名词(title/align/width),无 `allow-*`。
3587
3619
  */
3588
3620
  interface TableColumnOptions<T extends DataRecord = DataRecord> {
3589
3621
  /** 列标识,同时作为默认取值字段 */
3590
3622
  key: string;
3591
3623
  title: string;
3624
+ /** 单元格水平对齐;未配置默认居中(表头/表体一致),显式 "left" 退出默认 */
3592
3625
  align?: "left" | "center" | "right";
3593
- /** 列宽(R32)。数字(px):布局硬约束 —— 参与表格 min-width 求和与 fixed 列 sticky 偏移推算;
3626
+ /** 列宽。数字(px):布局硬约束 —— 参与表格 min-width 求和与 fixed 列 sticky 偏移推算;
3594
3627
  * 字符串(如 "10rem"):仅渲染提示值,不参与求和与 sticky。 */
3595
3628
  width?: number | string;
3596
- /** 自定义单元格渲染,取值链 render > formatter > record[key](R17) */
3629
+ /** 自定义单元格渲染,取值链 render > formatter > record[key] */
3597
3630
  render?: (r: ColumnRenders<T>) => ColumnRender<T>;
3598
3631
  /** 纯数据格式化;render 存在时被忽略 */
3599
3632
  formatter?: (record: T) => string | number | Date | undefined;
3600
- /** 超宽截断 + 原生 title 提示(R15);"tooltip" 形态改用库内 Tooltip(不设原生 title) */
3633
+ /** 超宽截断 + 原生 title 提示;"tooltip" 形态改用库内 Tooltip(不设原生 title) */
3601
3634
  ellipsis?: boolean | "tooltip";
3602
3635
  /** 是否可排序(能力开关) */
3603
3636
  sortable?: boolean;
3604
- /** 初始排序方向;需 sortable: true,否则 DEV 警告并忽略(R7) */
3637
+ /** 初始排序方向;需 sortable: true,否则 DEV 警告并忽略 */
3605
3638
  defaultSort?: "asc" | "desc";
3606
3639
  /** 固定列:横向滚动时 sticky 在左/右;须同时提供数字 width,否则 DEV 警告并按普通列渲染 */
3607
3640
  fixed?: "left" | "right";
3608
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>;
3609
3658
  interface PageableOptions {
3610
3659
  /** 1-based 页码(对外 API 唯一口径) */
3611
3660
  pageIndex: number;
@@ -3625,12 +3674,13 @@ interface TableLoadParams<T extends DataRecord = DataRecord> {
3625
3674
  page: PageableOptions;
3626
3675
  /** 无排序或已取消排序时为 undefined */
3627
3676
  sort?: SortableOptions;
3628
- /** 回写数据;total 缺省时保留旧值(R10) */
3677
+ /** 回写数据;total 缺省时保留旧值 */
3629
3678
  update: (data: T[], total?: number) => void;
3630
3679
  }
3631
3680
  /** defineTable 的声明式配置 */
3632
3681
  interface DefineTableOptions<T extends DataRecord = DataRecord> {
3633
- columns: TableColumnOptions<T>[];
3682
+ /** 列节点树:叶子列或分组(多级表头),任意层级;扁平数组天然合法 */
3683
+ columns: TableColumnNode<T>[];
3634
3684
  /** 服务端模式数据源;与 data 二选一,onLoad 优先 */
3635
3685
  onLoad?: (params: TableLoadParams<T>) => void | Promise<unknown>;
3636
3686
  /** 静态模式数据源(本地分页/排序) */
@@ -3638,15 +3688,15 @@ interface DefineTableOptions<T extends DataRecord = DataRecord> {
3638
3688
  /** 是否在挂载后自动加载,默认 true;仅服务端模式生效 */
3639
3689
  autoLoad?: boolean;
3640
3690
  /**
3641
- * 每页条数 / 受控每页条数(D11)。约定:传入(非 undefined)即受控,缺省(undefined)时
3642
- * 以默认 10 行运行;R9 归位:pageIndex 未受控时内部归位第 1 页并经 update:page-index 通知,
3691
+ * 每页条数 / 受控每页条数。约定:传入(非 undefined)即受控,缺省(undefined)时
3692
+ * 以默认 10 行运行;页码归位:pageIndex 未受控时内部归位第 1 页并经 update:page-index 通知,
3643
3693
  * 两个都受控时由父层自行联动。支持传 ref/getter(聚合式受控)
3644
3694
  */
3645
3695
  pageSize?: MaybeRefOrGetter<number | undefined>;
3646
3696
  pageSizeOpts?: number[];
3647
- /** 行选择:radio 单选 / checkbox 多选;字符串为简写(S2) */
3697
+ /** 行选择:radio 单选 / checkbox 多选;字符串为简写 */
3648
3698
  rowSelection?: "radio" | "checkbox" | TableSelectionOptions<T>;
3649
- /** 行主键字段;rowSelection 启用且此值无效时禁用选择(S1) */
3699
+ /** 行主键字段;rowSelection 启用且此值无效时禁用选择 */
3650
3700
  rowKey?: string;
3651
3701
  /**
3652
3702
  * 搜索表单(defineForm 返回值):仅服务端模式生效,每次 onLoad 的 form 参数
@@ -3662,30 +3712,52 @@ interface DefineTableOptions<T extends DataRecord = DataRecord> {
3662
3712
  /** 树形数据:子行展开/收起(展开按钮在首个业务列内);配置无效时 DEV 警告并忽略 */
3663
3713
  tree?: TreeOptions;
3664
3714
  /**
3665
- * 受控页码(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)即受控,缺省保持非受控;
3666
3724
  * 内部翻页经 update:page-index 通知,外部变更经受控 watch 同步(语义等值跳过,防回弹循环)
3667
3725
  */
3668
3726
  pageIndex?: MaybeRefOrGetter<number | undefined>;
3669
3727
  /** 受控排序。内部/外部变化均经 sort-change 通知;指向不可排序列时 DEV 警告并忽略 */
3670
3728
  sort?: MaybeRefOrGetter<SortableOptions | undefined>;
3671
- /** 受控选中集(数组,与 update:selected-keys 载荷同构)。经 setSelection 写入(S5 过滤/S12 待定 key 继承) */
3729
+ /** 受控选中集(数组,与 update:selected-keys 载荷同构)。经 setSelection 写入(selectable 过滤、待定 key 继承) */
3672
3730
  selectedKeys?: MaybeRefOrGetter<Array<string | number> | undefined>;
3673
3731
  /**
3674
- * 列显隐:默认可见列集(R21「重置」基准;未知 key 静默忽略;未传 = 全部可见)。
3675
- * 列显隐不触发 onLoad、不重置 pageIndex/sort/selectedKeys(R25)
3732
+ * 列显隐:默认可见列集(「重置」基准;未知 key 静默忽略;未传 = 全部可见)。
3733
+ * 列显隐不触发 onLoad、不重置 pageIndex/sort/selectedKeys
3676
3734
  */
3677
3735
  columnVisibility?: ColumnVisibilityOptions;
3678
3736
  /**
3679
3737
  * 受控可见列 key(columns 原序子集)。约定:传入(非 undefined)即受控;
3680
- * 内部显隐经 update:visible-keys 通知;空数组钳制为首列可见(R24,warn 一次)
3738
+ * 内部显隐经 update:visible-keys 通知;空数组钳制为首列可见(warn 一次)
3681
3739
  */
3682
3740
  visibleKeys?: MaybeRefOrGetter<string[] | undefined>;
3683
3741
  /**
3684
3742
  * 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时
3685
- * DEV 警告 definition 优先(R26)
3743
+ * DEV 警告 definition 优先
3686
3744
  */
3687
3745
  defaultVisibleKeys?: MaybeRefOrGetter<string[] | undefined>;
3688
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
+ }
3689
3761
  /** 树形数据配置(T 系列) */
3690
3762
  interface TreeOptions {
3691
3763
  /** 子行字段名,默认 "children" */
@@ -3695,9 +3767,9 @@ interface TreeOptions {
3695
3767
  /** 每层缩进 px,默认 16 */
3696
3768
  indentSize?: number;
3697
3769
  }
3698
- /** 列显隐配置(R20–R24) */
3770
+ /** 列显隐配置 */
3699
3771
  interface ColumnVisibilityOptions {
3700
- /** 默认可见列 key 列表(R21「重置」基准);未知 key 静默忽略;未传 = 全部可见 */
3772
+ /** 默认可见列 key 列表(「重置」基准);未知 key 静默忽略;未传 = 全部可见 */
3701
3773
  defaultVisibleKeys?: string[];
3702
3774
  }
3703
3775
  /** 行选择配置(S 系列) */
@@ -3705,11 +3777,11 @@ interface TableSelectionOptions<T extends DataRecord = DataRecord> {
3705
3777
  type: "radio" | "checkbox";
3706
3778
  /** 选择列宽,默认 48 */
3707
3779
  width?: number;
3708
- /** 行级可选过滤;false 的行选择控件置灰且被全选跳过(S5) */
3780
+ /** 行级可选过滤;false 的行选择控件置灰且被全选跳过 */
3709
3781
  selectable?: (record: T) => boolean;
3710
- /** radio 再点已选中行是否取消,默认 true(S4) */
3782
+ /** radio 再点已选中行是否取消,默认 true */
3711
3783
  cancelable?: boolean;
3712
- /** 翻页/重载后是否保留选中,默认 true(S6) */
3784
+ /** 翻页/重载后是否保留选中,默认 true */
3713
3785
  reserveOnPageChange?: boolean;
3714
3786
  }
3715
3787
  /** useTableRender 的入参:data 额外支持 ref/getter(拆分模式下 props 天然响应式) */
@@ -3719,6 +3791,11 @@ interface UseTableRenderOptions<T extends DataRecord = DataRecord> extends Omit<
3719
3791
  /** defineTable / useTableRender 的返回物:列配置 + 引擎实例 + 只读状态 + 实例动作 */
3720
3792
  interface TableRenderDefinition<T extends DataRecord = DataRecord> {
3721
3793
  columns: TableColumnOptions<T>[];
3794
+ /**
3795
+ * 原始列节点树(表头矩阵与列设置面板的树形结构来源)。
3796
+ * 可选:手工构造定义对象时缺省,组件侧回退为扁平的 `columns`(单级表头)。
3797
+ */
3798
+ columnTree?: TableColumnNode<T>[];
3722
3799
  /** TanStack 表格实例(逃逸舱口) */
3723
3800
  table: Table<T>;
3724
3801
  page: Readonly<PageableOptions>;
@@ -3728,26 +3805,26 @@ interface TableRenderDefinition<T extends DataRecord = DataRecord> {
3728
3805
  loading: Readonly<{
3729
3806
  value: boolean;
3730
3807
  }>;
3731
- /** 重新加载;resetPage 为 true 时先回到第 1 页(R12) */
3808
+ /** 重新加载;resetPage 为 true 时先回到第 1 页 */
3732
3809
  reload: (resetPage?: boolean) => void;
3733
- /** 排序三态切换:无 → asc → desc → 取消(R8) */
3810
+ /** 排序三态切换:无 → asc → desc → 取消 */
3734
3811
  toggleSort: (key: string) => void;
3735
3812
  setPageIndex: (pageIndex: number) => void;
3736
3813
  setPageSize: (pageSize: number) => void;
3737
- /** 选中行快照(含跨页保留行;跨页行可能为过期数据,见 S6) */
3814
+ /** 选中行快照(含跨页保留行;跨页行可能为过期数据) */
3738
3815
  selection: Readonly<{
3739
3816
  value: T[];
3740
- /** rowSelection 配置有效(含 rowKey 就绪)时为 true(S1) */
3817
+ /** rowSelection 配置有效(含 rowKey 就绪)时为 true */
3741
3818
  enabled: boolean;
3742
3819
  type: "radio" | "checkbox";
3743
3820
  width: number;
3744
3821
  }>;
3745
- /** 选中主键集合;每次选中集变化替换为新 Set(S7) */
3822
+ /** 选中主键集合;每次选中集变化替换为新 Set */
3746
3823
  selectedKeys: Readonly<Ref<Set<string | number>>>;
3747
- /** 程序化设置选中集;不存在的 key 保留(S12) */
3824
+ /** 程序化设置选中集;不存在的 key 保留 */
3748
3825
  setSelection: (keys: Array<string | number>) => void;
3749
3826
  clearSelection: () => void;
3750
- /** 行控件切换:checked 为 false 时移除(radio 受 cancelable 约束,S4) */
3827
+ /** 行控件切换:checked 为 false 时移除(radio 受 cancelable 约束) */
3751
3828
  toggleRowSelected: (key: string, checked: boolean) => void;
3752
3829
  /** 搜索表单定义(options.search 校验后的回传,供 TableRender 渲染搜索区;被忽略时为 undefined) */
3753
3830
  search: FormRenderDefinition<any> | undefined;
@@ -3759,24 +3836,31 @@ interface TableRenderDefinition<T extends DataRecord = DataRecord> {
3759
3836
  height: number | string | undefined;
3760
3837
  /** 树形配置(引擎校验后的回传,供组件读取 indentSize;无效配置被忽略时为 undefined) */
3761
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;
3762
3846
  /** 最近一次 onLoad 失败的 Error(仅服务端模式产生);下一次 load 开始时清除 */
3763
3847
  error: Readonly<Ref<Error | undefined>>;
3764
3848
  /** 可见列 key(columns 原序子集);受控/非受控统一投影 */
3765
3849
  visibleKeys: Readonly<Ref<readonly string[]>>;
3766
- /** 列显隐动作:规范化(未知忽略、columns 原序、空钳制为首列 R24)后更新 */
3850
+ /** 列显隐动作:规范化(未知忽略、columns 原序、空钳制为首列)后更新 */
3767
3851
  setVisibleKeys: (keys: string[]) => void;
3768
- /** 解析后的默认可见集(R21 重置基准;未配置为 undefined = 全部可见) */
3852
+ /** 解析后的默认可见集(重置基准;未配置为 undefined = 全部可见) */
3769
3853
  defaultVisibleKeys: string[] | undefined;
3770
3854
  /** 聚合式列显隐配置回传(拆分式为 undefined) */
3771
3855
  columnVisibility: ColumnVisibilityOptions | undefined;
3772
- /** 内部装配口:拆分式由 TableRender 在 setup 时回填 rowKey(S1) */
3856
+ /** 内部装配口:拆分式由 TableRender 在 setup 时回填 rowKey */
3773
3857
  setRowKey: (rowKey: string | undefined) => void;
3774
3858
  }
3775
3859
  //#endregion
3776
3860
  //#region src/components/table-render/TablePagination.vue.d.ts
3777
3861
  declare const __VLS_export$13: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
3778
- /** 组合式:传 defineTable 返回值,自动接线 page/动作并按 R13 单页自隐藏;
3779
- * 与手动分页 props 同传时以 definition 为准(DEV 警告,R29/R4 对齐) */
3862
+ /** 组合式:传 defineTable 返回值,自动接线 page/动作并单页自隐藏;
3863
+ * 与手动分页 props 同传时以 definition 为准(DEV 警告) */
3780
3864
  definition: {
3781
3865
  type: PropType<TableRenderDefinition<any>>;
3782
3866
  };
@@ -3816,8 +3900,8 @@ declare const __VLS_export$13: import("vue").DefineComponent<import("vue").Extra
3816
3900
  "update:pageIndex": (pageIndex: number) => any;
3817
3901
  "update:pageSize": (pageSize: number) => any;
3818
3902
  }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
3819
- /** 组合式:传 defineTable 返回值,自动接线 page/动作并按 R13 单页自隐藏;
3820
- * 与手动分页 props 同传时以 definition 为准(DEV 警告,R29/R4 对齐) */
3903
+ /** 组合式:传 defineTable 返回值,自动接线 page/动作并单页自隐藏;
3904
+ * 与手动分页 props 同传时以 definition 为准(DEV 警告) */
3821
3905
  definition: {
3822
3906
  type: PropType<TableRenderDefinition<any>>;
3823
3907
  };
@@ -3889,9 +3973,9 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
3889
3973
  type: StringConstructor;
3890
3974
  required: true;
3891
3975
  };
3892
- /** 拆分式:与 definition 二选一,definition 优先 */
3976
+ /** 拆分式:与 definition 二选一,definition 优先(支持分组列节点) */
3893
3977
  columns: {
3894
- type: PropType<TableColumnOptions[]>;
3978
+ type: PropType<TableColumnNode[]>;
3895
3979
  };
3896
3980
  onLoad: {
3897
3981
  type: PropType<(params: TableLoadParams) => void | Promise<unknown>>;
@@ -3903,7 +3987,7 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
3903
3987
  type: PropType<boolean | undefined>;
3904
3988
  default: any;
3905
3989
  };
3906
- /** 每页条数 / 受控每页条数(D11):传入即受控(pageIndex 未受控时 R9 归位内部处理并通知) */
3990
+ /** 每页条数 / 受控每页条数:传入即受控(pageIndex 未受控时页码归位内部处理并通知) */
3907
3991
  pageSize: {
3908
3992
  type: NumberConstructor;
3909
3993
  };
@@ -3939,6 +4023,11 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
3939
4023
  tree: {
3940
4024
  type: PropType<TreeOptions>;
3941
4025
  };
4026
+ /** 行拖拽排序(仅拆分式生效;聚合式请在 defineTable 配置):true 或对象配置;与 tree/virtual 互斥 */
4027
+ draggable: {
4028
+ type: PropType<boolean | TableDraggableOptions>;
4029
+ default: any;
4030
+ };
3942
4031
  /** 受控页码(1-based):传入即受控,缺省非受控;内部翻页经 update:page-index 通知 */
3943
4032
  pageIndex: {
3944
4033
  type: NumberConstructor;
@@ -3955,7 +4044,7 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
3955
4044
  visibleKeys: {
3956
4045
  type: PropType<string[]>;
3957
4046
  };
3958
- /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(R26,definition 优先) */
4047
+ /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(definition 优先) */
3959
4048
  defaultVisibleKeys: {
3960
4049
  type: PropType<string[]>;
3961
4050
  };
@@ -3964,12 +4053,12 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
3964
4053
  type: PropType<boolean | undefined>;
3965
4054
  default: any;
3966
4055
  };
3967
- /** 搜索区渲染开关(R27):false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */
4056
+ /** 搜索区渲染开关:false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */
3968
4057
  showSearch: {
3969
4058
  type: PropType<boolean | undefined>;
3970
4059
  default: any;
3971
4060
  };
3972
- /** 分页条渲染开关(R28):false 关闭内置分页条(组合式外置 TablePagination);缺省模式 R13 不变 */
4061
+ /** 分页条渲染开关:false 关闭内置分页条(组合式外置 TablePagination);缺省模式单页自隐藏不变 */
3973
4062
  showPagination: {
3974
4063
  type: PropType<boolean | undefined>;
3975
4064
  default: any;
@@ -4027,6 +4116,7 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4027
4116
  "load-error": (error: Error) => any;
4028
4117
  "update:visible-keys": (keys: string[]) => any;
4029
4118
  "column-visibility-change": (keys: string[]) => any;
4119
+ "drag-sort": (payload: TableDragSortPayload<DataRecord>) => any;
4030
4120
  }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
4031
4121
  /** 聚合式(推荐):defineTable 返回的定义对象 */
4032
4122
  definition: {
@@ -4037,9 +4127,9 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4037
4127
  type: StringConstructor;
4038
4128
  required: true;
4039
4129
  };
4040
- /** 拆分式:与 definition 二选一,definition 优先 */
4130
+ /** 拆分式:与 definition 二选一,definition 优先(支持分组列节点) */
4041
4131
  columns: {
4042
- type: PropType<TableColumnOptions[]>;
4132
+ type: PropType<TableColumnNode[]>;
4043
4133
  };
4044
4134
  onLoad: {
4045
4135
  type: PropType<(params: TableLoadParams) => void | Promise<unknown>>;
@@ -4051,7 +4141,7 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4051
4141
  type: PropType<boolean | undefined>;
4052
4142
  default: any;
4053
4143
  };
4054
- /** 每页条数 / 受控每页条数(D11):传入即受控(pageIndex 未受控时 R9 归位内部处理并通知) */
4144
+ /** 每页条数 / 受控每页条数:传入即受控(pageIndex 未受控时页码归位内部处理并通知) */
4055
4145
  pageSize: {
4056
4146
  type: NumberConstructor;
4057
4147
  };
@@ -4087,6 +4177,11 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4087
4177
  tree: {
4088
4178
  type: PropType<TreeOptions>;
4089
4179
  };
4180
+ /** 行拖拽排序(仅拆分式生效;聚合式请在 defineTable 配置):true 或对象配置;与 tree/virtual 互斥 */
4181
+ draggable: {
4182
+ type: PropType<boolean | TableDraggableOptions>;
4183
+ default: any;
4184
+ };
4090
4185
  /** 受控页码(1-based):传入即受控,缺省非受控;内部翻页经 update:page-index 通知 */
4091
4186
  pageIndex: {
4092
4187
  type: NumberConstructor;
@@ -4103,7 +4198,7 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4103
4198
  visibleKeys: {
4104
4199
  type: PropType<string[]>;
4105
4200
  };
4106
- /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(R26,definition 优先) */
4201
+ /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(definition 优先) */
4107
4202
  defaultVisibleKeys: {
4108
4203
  type: PropType<string[]>;
4109
4204
  };
@@ -4112,12 +4207,12 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4112
4207
  type: PropType<boolean | undefined>;
4113
4208
  default: any;
4114
4209
  };
4115
- /** 搜索区渲染开关(R27):false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */
4210
+ /** 搜索区渲染开关:false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */
4116
4211
  showSearch: {
4117
4212
  type: PropType<boolean | undefined>;
4118
4213
  default: any;
4119
4214
  };
4120
- /** 分页条渲染开关(R28):false 关闭内置分页条(组合式外置 TablePagination);缺省模式 R13 不变 */
4215
+ /** 分页条渲染开关:false 关闭内置分页条(组合式外置 TablePagination);缺省模式单页自隐藏不变 */
4121
4216
  showPagination: {
4122
4217
  type: PropType<boolean | undefined>;
4123
4218
  default: any;
@@ -4145,7 +4240,9 @@ declare const __VLS_base$11: import("vue").DefineComponent<import("vue").Extract
4145
4240
  "onLoad-error"?: (error: Error) => any;
4146
4241
  "onUpdate:visible-keys"?: (keys: string[]) => any;
4147
4242
  "onColumn-visibility-change"?: (keys: string[]) => any;
4243
+ "onDrag-sort"?: (payload: TableDragSortPayload<DataRecord>) => any;
4148
4244
  }>, {
4245
+ draggable: boolean | TableDraggableOptions<DataRecord>;
4149
4246
  loading: boolean;
4150
4247
  autoLoad: boolean;
4151
4248
  rowSelection: "radio" | "checkbox" | TableSelectionOptions<DataRecord>;
@@ -4172,8 +4269,10 @@ export declare const PAGE_TABLE_FILL_KEY = "tu-design:page-table-fill";
4172
4269
  * 列定义辅助:补全泛型推导,便于把列配置抽到独立文件。
4173
4270
  *
4174
4271
  * 纯类型辅助,原样返回入参——裸数组同样可直接传给 defineTable(无需此函数)。
4272
+ * @param columns - 列节点树(叶子列或分组)
4273
+ * @returns 原样返回的列节点树
4175
4274
  */
4176
- 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>[];
4177
4276
  //#endregion
4178
4277
  //#region src/components/table-render/define-table.d.ts
4179
4278
  /**
@@ -4181,15 +4280,41 @@ export declare function defineColumns<T extends DataRecord = DataRecord>(columns
4181
4280
  *
4182
4281
  * 返回值直接传给 `<TableRender :definition="def" />`;
4183
4282
  * 须在组件 setup 中调用(TanStack useVueTable 约束)。
4283
+ * @param config - 表格配置:列定义、数据源(静态 data 或服务端 onLoad)、分页排序、行选择等
4284
+ * @returns 表格渲染定义,直接传给 TableRender 组件的 definition prop
4184
4285
  */
4185
4286
  export declare function defineTable<T extends DataRecord>(config: DefineTableOptions<T>): TableRenderDefinition<T>;
4186
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
4187
4309
  //#region src/components/table-render/useTableRender.d.ts
4188
4310
  /**
4189
4311
  * 表格数据内核:TanStack 无头引擎组装 + 1-based 对外投影 + 实例动作。
4190
4312
  *
4191
4313
  * 状态真相源是 TanStack 引擎(pageIndex 为 0-based),
4192
4314
  * `page`/`sort` 是对外的 1-based 只读投影,由 watch 同步。
4315
+ * @param options - 表格配置:列定义、数据源(静态 data 或服务端 onLoad)、分页排序、
4316
+ * 行选择、树形、列显隐、搜索表单等
4317
+ * @returns 表格渲染定义(含只读投影与实例动作),供 TableRender 组件消费
4193
4318
  */
4194
4319
  export declare function useTableRender<T extends DataRecord>(options: UseTableRenderOptions<T>): TableRenderDefinition<T>;
4195
4320
  //#endregion
@@ -4425,11 +4550,11 @@ type __VLS_Slots$8 = {} & {
4425
4550
  close?: (props: typeof __VLS_7) => any;
4426
4551
  };
4427
4552
  declare const __VLS_base$8: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
4428
- close: () => any;
4429
4553
  "update:modelValue": (value: boolean) => any;
4554
+ close: () => any;
4430
4555
  }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
4431
- onClose?: () => any;
4432
4556
  "onUpdate:modelValue"?: (value: boolean) => any;
4557
+ onClose?: () => any;
4433
4558
  }>, {
4434
4559
  variant: AlertVariants["variant"];
4435
4560
  class: string;
@@ -4551,41 +4676,104 @@ type ToastOptions = ToastOptions$1;
4551
4676
  type ToastPlacement = ToastPlacement$1;
4552
4677
  type ToastPromiseOptions<T> = ToastPromiseOptions$1<T>;
4553
4678
  declare const toastApi: {
4554
- /** 成功提示 */
4679
+ /**
4680
+ * 成功提示。
4681
+ * @param options - toast 配置(标题、描述、时长等)
4682
+ * @returns 该条 toast 的创建结果,可用于后续控制
4683
+ */
4555
4684
  success: (options: ToastOptions) => string;
4556
- /** 错误提示 */
4685
+ /**
4686
+ * 错误提示。
4687
+ * @param options - toast 配置(标题、描述、时长等)
4688
+ * @returns 该条 toast 的创建结果,可用于后续控制
4689
+ */
4557
4690
  error: (options: ToastOptions) => string;
4558
- /** 信息提示 */
4691
+ /**
4692
+ * 信息提示。
4693
+ * @param options - toast 配置(标题、描述、时长等)
4694
+ * @returns 该条 toast 的创建结果,可用于后续控制
4695
+ */
4559
4696
  info: (options: ToastOptions) => string;
4560
- /** 警告提示 */
4697
+ /**
4698
+ * 警告提示。
4699
+ * @param options - toast 配置(标题、描述、时长等)
4700
+ * @returns 该条 toast 的创建结果,可用于后续控制
4701
+ */
4561
4702
  warning: (options: ToastOptions) => string;
4562
- /** 加载中提示 */
4703
+ /**
4704
+ * 加载中提示。
4705
+ * @param options - toast 配置(标题、描述、时长等)
4706
+ * @returns 该条 toast 的创建结果,可用于后续控制
4707
+ */
4563
4708
  loading: (options: ToastOptions) => string;
4564
- /** 跟踪 Promise 状态的提示 */
4709
+ /**
4710
+ * 跟踪 Promise 状态的提示。
4711
+ * @param promise - 待跟踪的 Promise 或返回 Promise 的工厂函数
4712
+ * @param options - Promise 各阶段(loading/success/error)的 toast 配置
4713
+ * @param shared - 各阶段共享的基础配置(不含 type)
4714
+ * @returns 该条 toast 的创建结果,可用于后续控制
4715
+ */
4565
4716
  promise: <T>(promise: Promise<T> | (() => Promise<T>), options: ToastPromiseOptions$1<T>, shared?: Omit<ToastOptions, "type">) => {
4566
4717
  id: string | undefined;
4567
4718
  unwrap: () => Promise<T>;
4568
4719
  };
4569
- /** 关闭指定 toast;不传 id 时关闭全部 */
4720
+ /**
4721
+ * 关闭指定 toast;不传 id 时关闭全部。
4722
+ * @param id - 目标 toast 的 id;缺省时关闭全部
4723
+ */
4570
4724
  dismiss: (id?: string) => void;
4571
4725
  };
4726
+ /**
4727
+ * 获取 toast API。模块级单例外观对象,任意位置调用返回同一引用(引用稳定);
4728
+ * 内部转发到 Provider 挂载后重建的 store,调用前须在应用根部挂载 <ToastProvider>。
4729
+ * @returns toast 操作 API(success/error/info/warning/loading/promise/dismiss)
4730
+ */
4572
4731
  export declare function useToast(): {
4573
- /** 成功提示 */
4732
+ /**
4733
+ * 成功提示。
4734
+ * @param options - toast 配置(标题、描述、时长等)
4735
+ * @returns 该条 toast 的创建结果,可用于后续控制
4736
+ */
4574
4737
  success: (options: ToastOptions) => string;
4575
- /** 错误提示 */
4738
+ /**
4739
+ * 错误提示。
4740
+ * @param options - toast 配置(标题、描述、时长等)
4741
+ * @returns 该条 toast 的创建结果,可用于后续控制
4742
+ */
4576
4743
  error: (options: ToastOptions) => string;
4577
- /** 信息提示 */
4744
+ /**
4745
+ * 信息提示。
4746
+ * @param options - toast 配置(标题、描述、时长等)
4747
+ * @returns 该条 toast 的创建结果,可用于后续控制
4748
+ */
4578
4749
  info: (options: ToastOptions) => string;
4579
- /** 警告提示 */
4750
+ /**
4751
+ * 警告提示。
4752
+ * @param options - toast 配置(标题、描述、时长等)
4753
+ * @returns 该条 toast 的创建结果,可用于后续控制
4754
+ */
4580
4755
  warning: (options: ToastOptions) => string;
4581
- /** 加载中提示 */
4756
+ /**
4757
+ * 加载中提示。
4758
+ * @param options - toast 配置(标题、描述、时长等)
4759
+ * @returns 该条 toast 的创建结果,可用于后续控制
4760
+ */
4582
4761
  loading: (options: ToastOptions) => string;
4583
- /** 跟踪 Promise 状态的提示 */
4762
+ /**
4763
+ * 跟踪 Promise 状态的提示。
4764
+ * @param promise - 待跟踪的 Promise 或返回 Promise 的工厂函数
4765
+ * @param options - Promise 各阶段(loading/success/error)的 toast 配置
4766
+ * @param shared - 各阶段共享的基础配置(不含 type)
4767
+ * @returns 该条 toast 的创建结果,可用于后续控制
4768
+ */
4584
4769
  promise: <T>(promise: Promise<T> | (() => Promise<T>), options: ToastPromiseOptions$1<T>, shared?: Omit<ToastOptions, "type">) => {
4585
4770
  id: string | undefined;
4586
4771
  unwrap: () => Promise<T>;
4587
4772
  };
4588
- /** 关闭指定 toast;不传 id 时关闭全部 */
4773
+ /**
4774
+ * 关闭指定 toast;不传 id 时关闭全部。
4775
+ * @param id - 目标 toast 的 id;缺省时关闭全部
4776
+ */
4589
4777
  dismiss: (id?: string) => void;
4590
4778
  };
4591
4779
  type ToastApi = typeof toastApi;
@@ -4683,8 +4871,8 @@ declare const __VLS_base$4: import("vue").DefineComponent<import("vue").ExtractP
4683
4871
  default: boolean;
4684
4872
  };
4685
4873
  }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
4686
- cancel: () => any;
4687
4874
  "update:open": (open: boolean) => any;
4875
+ cancel: () => any;
4688
4876
  confirm: () => any;
4689
4877
  }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
4690
4878
  /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */
@@ -4718,8 +4906,8 @@ declare const __VLS_base$4: import("vue").DefineComponent<import("vue").ExtractP
4718
4906
  default: boolean;
4719
4907
  };
4720
4908
  }>> & Readonly<{
4721
- onCancel?: () => any;
4722
4909
  "onUpdate:open"?: (open: boolean) => any;
4910
+ onCancel?: () => any;
4723
4911
  onConfirm?: () => any;
4724
4912
  }>, {
4725
4913
  destructive: boolean;
@@ -4905,12 +5093,12 @@ declare const __VLS_base$2: import("vue").DefineComponent<import("vue").ExtractP
4905
5093
  "onUpdate:open"?: (open: boolean) => any;
4906
5094
  }>, {
4907
5095
  size: Size;
4908
- title: string;
4909
5096
  open: boolean;
4910
5097
  defaultOpen: boolean;
4911
5098
  placement: Placement;
4912
5099
  lazyMount: boolean;
4913
5100
  unmountOnExit: boolean;
5101
+ title: string;
4914
5102
  description: string;
4915
5103
  showCloseButton: boolean;
4916
5104
  }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
@@ -4959,8 +5147,8 @@ declare const __VLS_base$1: import("vue").DefineComponent<import("vue").ExtractP
4959
5147
  default: any;
4960
5148
  };
4961
5149
  }>, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
4962
- cancel: () => any;
4963
5150
  "update:open": (open: boolean) => any;
5151
+ cancel: () => any;
4964
5152
  confirm: () => any;
4965
5153
  }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
4966
5154
  /** 气泡标题(渲染为 Ark Popover.Title,content 自动接线 aria-labelledby) */
@@ -4994,8 +5182,8 @@ declare const __VLS_base$1: import("vue").DefineComponent<import("vue").ExtractP
4994
5182
  default: any;
4995
5183
  };
4996
5184
  }>> & Readonly<{
4997
- onCancel?: () => any;
4998
5185
  "onUpdate:open"?: (open: boolean) => any;
5186
+ onCancel?: () => any;
4999
5187
  onConfirm?: () => any;
5000
5188
  }>, {
5001
5189
  variant: "default" | "destructive";
@@ -5078,4 +5266,4 @@ export declare const timelineDotVariants: (props?: {
5078
5266
  } & import("class-variance-authority/types").ClassProp) => string;
5079
5267
  export type TimelineDotVariants = VariantProps<typeof timelineDotVariants>;
5080
5268
  //#endregion
5081
- 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 };