erp-plus 1.0.168 → 1.0.169

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.
@@ -29,6 +29,15 @@ interface Props {
29
29
  /** 视口外缓冲行数(TableV2 cache) */
30
30
  overscan?: number;
31
31
  scrollbarAlwaysOn?: boolean;
32
+ /** 合计行(底部 footer;列配置 summary: true 的数值列自动求和) */
33
+ showSummary?: boolean;
34
+ /** 合计行文案(落在序号列并居中;无序号列时落在第一个非选择列) */
35
+ summaryText?: string;
36
+ /** 自定义合计:(data) => Record<prop, value>,返回的键渲染到对应列 */
37
+ summaryMethod?: (data: any[]) => Record<string, string | number>;
38
+ /** 合计数值千分位(默认开):内置求和结果与 summaryMethod 返回的 number 都加千分位,
39
+ * 字符串值视为业务已格式化、原样渲染。关掉传 :summary-thousands="false"。 */
40
+ summaryThousands?: boolean;
32
41
  }
33
42
  declare const _default: DefineComponent<Props, {
34
43
  validate: () => boolean;
@@ -36,6 +45,13 @@ declare const _default: DefineComponent<Props, {
36
45
  clearValidate: () => void;
37
46
  clearSelection: () => void;
38
47
  getSelectedIds: () => KeyType[];
48
+ /** 行软删除:disableRow/Rows 置灰,restoreRow/Rows 还原,getDisabledIds 取已删行键 */
49
+ disableRow: (row: any) => void;
50
+ restoreRow: (row: any) => void;
51
+ disableRows: (rows: any[]) => void;
52
+ restoreRows: (rows: any[]) => void;
53
+ getDisabledIds: () => KeyType[];
54
+ isRowDisabled: (row: any) => boolean;
39
55
  /** TableV2 实例:scrollTo / scrollToRow / scrollToTop / scrollToLeft */
40
56
  tableRef: globalThis.Ref<any, any>;
41
57
  }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
@@ -61,9 +77,12 @@ declare const _default: DefineComponent<Props, {
61
77
  arraySeparator: string;
62
78
  columns: VtTableColumn[];
63
79
  rowKey: string;
80
+ showSummary: boolean;
64
81
  scrollbarAlwaysOn: boolean;
65
82
  minHeight: string | number;
66
83
  overscan: number;
84
+ summaryText: string;
85
+ summaryThousands: boolean;
67
86
  }, {}, {}, {}, string, ComponentProvideOptions, false, {
68
87
  containerRef: HTMLDivElement;
69
88
  tableRef: CreateComponentPublicInstanceWithMixins<Readonly<globalThis.ExtractPropTypes<{
@@ -87,7 +106,7 @@ declare const _default: DefineComponent<Props, {
87
106
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
88
107
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
89
108
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
90
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
109
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
91
110
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
92
111
  */
93
112
  ...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (
@@ -102,7 +121,7 @@ declare const _default: DefineComponent<Props, {
102
121
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
103
122
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
104
123
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
105
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
124
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
106
125
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
107
126
  */
108
127
  ...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown, "id", boolean>;
@@ -119,7 +138,7 @@ declare const _default: DefineComponent<Props, {
119
138
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
120
139
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
121
140
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
122
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
141
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
123
142
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
124
143
  */
125
144
  ...args: any[]) => string | HeaderClassNameGetter<any>) | (() => string | HeaderClassNameGetter<any>) | ((new (
@@ -134,7 +153,7 @@ declare const _default: DefineComponent<Props, {
134
153
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
135
154
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
136
155
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
137
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
156
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
138
157
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
139
158
  */
140
159
  ...args: any[]) => string | HeaderClassNameGetter<any>) | (() => string | HeaderClassNameGetter<any>))[], unknown, unknown>>;
@@ -166,7 +185,7 @@ declare const _default: DefineComponent<Props, {
166
185
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
167
186
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
168
187
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
169
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
188
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
170
189
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
171
190
  */
172
191
  ...args: any[]) => number | number[]) | (() => number | number[]) | ((new (
@@ -181,7 +200,7 @@ declare const _default: DefineComponent<Props, {
181
200
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
182
201
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
183
202
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
184
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
203
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
185
204
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
186
205
  */
187
206
  ...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown, 50, boolean>;
@@ -199,7 +218,7 @@ declare const _default: DefineComponent<Props, {
199
218
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
200
219
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
201
220
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
202
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
221
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
203
222
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
204
223
  */
205
224
  ...args: any[]) => string | RowClassNameGetter<any>) | (() => string | RowClassNameGetter<any>) | ((new (
@@ -214,7 +233,7 @@ declare const _default: DefineComponent<Props, {
214
233
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
215
234
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
216
235
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
217
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
236
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
218
237
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
219
238
  */
220
239
  ...args: any[]) => string | RowClassNameGetter<any>) | (() => string | RowClassNameGetter<any>))[], unknown, unknown>>;
@@ -242,7 +261,7 @@ declare const _default: DefineComponent<Props, {
242
261
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
243
262
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
244
263
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
245
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
264
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
246
265
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
247
266
  */
248
267
  ...args: any[]) => Record<string, any> | ExtraCellPropGetter<any>) | (() => Record<string, any> | ExtraCellPropGetter<any>) | ((new (
@@ -257,7 +276,7 @@ declare const _default: DefineComponent<Props, {
257
276
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
258
277
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
259
278
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
260
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
279
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
261
280
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
262
281
  */
263
282
  ...args: any[]) => Record<string, any> | ExtraCellPropGetter<any>) | (() => Record<string, any> | ExtraCellPropGetter<any>))[], unknown, unknown>>;
@@ -290,8 +309,68 @@ declare const _default: DefineComponent<Props, {
290
309
  __epPropKey: true;
291
310
  };
292
311
  readonly expandColumnKey: StringConstructor;
293
- readonly expandedRowKeys: EpPropFinalized<(new (...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
294
- readonly defaultExpandedRowKeys: EpPropFinalized<(new (...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
312
+ readonly expandedRowKeys: EpPropFinalized<(new (
313
+ /**
314
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
315
+ *
316
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
317
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
318
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
319
+ *
320
+ * 性能纪律(与方案文档 §5 对应):
321
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
322
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
323
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
324
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
325
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
326
+ */
327
+ ...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (
328
+ /**
329
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
330
+ *
331
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
332
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
333
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
334
+ *
335
+ * 性能纪律(与方案文档 §5 对应):
336
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
337
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
338
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
339
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
340
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
341
+ */
342
+ ...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
343
+ readonly defaultExpandedRowKeys: EpPropFinalized<(new (
344
+ /**
345
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
346
+ *
347
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
348
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
349
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
350
+ *
351
+ * 性能纪律(与方案文档 §5 对应):
352
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
353
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
354
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
355
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
356
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
357
+ */
358
+ ...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (
359
+ /**
360
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
361
+ *
362
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
363
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
364
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
365
+ *
366
+ * 性能纪律(与方案文档 §5 对应):
367
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
368
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
369
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
370
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
371
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
372
+ */
373
+ ...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
295
374
  readonly class: StringConstructor;
296
375
  readonly fixed: BooleanConstructor;
297
376
  readonly style: {
@@ -319,11 +398,71 @@ declare const _default: DefineComponent<Props, {
319
398
  readonly hScrollbarSize: EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
320
399
  readonly vScrollbarSize: EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
321
400
  readonly scrollbarAlwaysOn: BooleanConstructor;
322
- readonly sortBy: EpPropFinalized<(new (...args: any[]) => SortBy) | (() => SortBy) | ((new (...args: any[]) => SortBy) | (() => SortBy))[], unknown, unknown, () => {
401
+ readonly sortBy: EpPropFinalized<(new (
402
+ /**
403
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
404
+ *
405
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
406
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
407
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
408
+ *
409
+ * 性能纪律(与方案文档 §5 对应):
410
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
411
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
412
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
413
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
414
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
415
+ */
416
+ ...args: any[]) => SortBy) | (() => SortBy) | ((new (
417
+ /**
418
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
419
+ *
420
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
421
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
422
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
423
+ *
424
+ * 性能纪律(与方案文档 §5 对应):
425
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
426
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
427
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
428
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
429
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
430
+ */
431
+ ...args: any[]) => SortBy) | (() => SortBy))[], unknown, unknown, () => {
323
432
  key: KeyType;
324
433
  order: TableV2SortOrder;
325
434
  }, boolean>;
326
- readonly sortState: EpPropFinalized<(new (...args: any[]) => SortState) | (() => SortState) | ((new (...args: any[]) => SortState) | (() => SortState))[], unknown, unknown, undefined, boolean>;
435
+ readonly sortState: EpPropFinalized<(new (
436
+ /**
437
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
438
+ *
439
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
440
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
441
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
442
+ *
443
+ * 性能纪律(与方案文档 §5 对应):
444
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
445
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
446
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
447
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
448
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
449
+ */
450
+ ...args: any[]) => SortState) | (() => SortState) | ((new (
451
+ /**
452
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
453
+ *
454
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
455
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
456
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
457
+ *
458
+ * 性能纪律(与方案文档 §5 对应):
459
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
460
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
461
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
462
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
463
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
464
+ */
465
+ ...args: any[]) => SortState) | (() => SortState))[], unknown, unknown, undefined, boolean>;
327
466
  readonly onColumnSort: {
328
467
  readonly type: PropType<ColumnSortHandler<any>>;
329
468
  readonly required: false;
@@ -349,7 +488,22 @@ declare const _default: DefineComponent<Props, {
349
488
  __epPropKey: true;
350
489
  };
351
490
  readonly onScroll: {
352
- readonly type: PropType<(...args: any[]) => void>;
491
+ readonly type: PropType<(
492
+ /**
493
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
494
+ *
495
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
496
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
497
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
498
+ *
499
+ * 性能纪律(与方案文档 §5 对应):
500
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
501
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
502
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
503
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
504
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
505
+ */
506
+ ...args: any[]) => void>;
353
507
  readonly required: false;
354
508
  readonly validator: ((val: unknown) => boolean) | undefined;
355
509
  __epPropKey: true;
@@ -378,7 +532,7 @@ declare const _default: DefineComponent<Props, {
378
532
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
379
533
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
380
534
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
381
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
535
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
382
536
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
383
537
  */
384
538
  JSX.
@@ -393,12 +547,42 @@ declare const _default: DefineComponent<Props, {
393
547
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
394
548
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
395
549
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
396
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
550
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
397
551
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
398
552
  */
399
553
  Element, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, Record<string, any>, VNodeProps & AllowedComponentProps & ComponentCustomProps, {
400
554
  readonly fixed: boolean;
401
- readonly rowKey: EpPropMergeType<(new (...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown>;
555
+ readonly rowKey: EpPropMergeType<(new (
556
+ /**
557
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
558
+ *
559
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
560
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
561
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
562
+ *
563
+ * 性能纪律(与方案文档 §5 对应):
564
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
565
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
566
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
567
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
568
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
569
+ */
570
+ ...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (
571
+ /**
572
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
573
+ *
574
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
575
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
576
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
577
+ *
578
+ * 性能纪律(与方案文档 §5 对应):
579
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
580
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
581
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
582
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
583
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
584
+ */
585
+ ...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown>;
402
586
  readonly useIsScrolling: boolean;
403
587
  readonly scrollbarAlwaysOn: boolean;
404
588
  readonly cache: number;
@@ -407,7 +591,37 @@ declare const _default: DefineComponent<Props, {
407
591
  readonly hScrollbarSize: number;
408
592
  readonly vScrollbarSize: number;
409
593
  readonly sortBy: SortBy;
410
- readonly headerHeight: EpPropMergeType<(new (...args: any[]) => number | number[]) | (() => number | number[]) | ((new (...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown>;
594
+ readonly headerHeight: EpPropMergeType<(new (
595
+ /**
596
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
597
+ *
598
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
599
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
600
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
601
+ *
602
+ * 性能纪律(与方案文档 §5 对应):
603
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
604
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
605
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
606
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
607
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
608
+ */
609
+ ...args: any[]) => number | number[]) | (() => number | number[]) | ((new (
610
+ /**
611
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
612
+ *
613
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
614
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
615
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
616
+ *
617
+ * 性能纪律(与方案文档 §5 对应):
618
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
619
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
620
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
621
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
622
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
623
+ */
624
+ ...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown>;
411
625
  readonly footerHeight: number;
412
626
  readonly indentSize: number;
413
627
  readonly iconSize: number;
@@ -442,7 +656,7 @@ declare const _default: DefineComponent<Props, {
442
656
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
443
657
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
444
658
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
445
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
659
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
446
660
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
447
661
  */
448
662
  ...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (
@@ -457,7 +671,7 @@ declare const _default: DefineComponent<Props, {
457
671
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
458
672
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
459
673
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
460
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
674
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
461
675
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
462
676
  */
463
677
  ...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown, "id", boolean>;
@@ -474,7 +688,7 @@ declare const _default: DefineComponent<Props, {
474
688
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
475
689
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
476
690
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
477
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
691
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
478
692
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
479
693
  */
480
694
  ...args: any[]) => string | HeaderClassNameGetter<any>) | (() => string | HeaderClassNameGetter<any>) | ((new (
@@ -489,7 +703,7 @@ declare const _default: DefineComponent<Props, {
489
703
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
490
704
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
491
705
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
492
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
706
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
493
707
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
494
708
  */
495
709
  ...args: any[]) => string | HeaderClassNameGetter<any>) | (() => string | HeaderClassNameGetter<any>))[], unknown, unknown>>;
@@ -521,7 +735,7 @@ declare const _default: DefineComponent<Props, {
521
735
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
522
736
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
523
737
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
524
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
738
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
525
739
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
526
740
  */
527
741
  ...args: any[]) => number | number[]) | (() => number | number[]) | ((new (
@@ -536,7 +750,7 @@ declare const _default: DefineComponent<Props, {
536
750
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
537
751
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
538
752
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
539
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
753
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
540
754
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
541
755
  */
542
756
  ...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown, 50, boolean>;
@@ -554,7 +768,7 @@ declare const _default: DefineComponent<Props, {
554
768
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
555
769
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
556
770
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
557
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
771
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
558
772
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
559
773
  */
560
774
  ...args: any[]) => string | RowClassNameGetter<any>) | (() => string | RowClassNameGetter<any>) | ((new (
@@ -569,7 +783,7 @@ declare const _default: DefineComponent<Props, {
569
783
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
570
784
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
571
785
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
572
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
786
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
573
787
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
574
788
  */
575
789
  ...args: any[]) => string | RowClassNameGetter<any>) | (() => string | RowClassNameGetter<any>))[], unknown, unknown>>;
@@ -597,7 +811,7 @@ declare const _default: DefineComponent<Props, {
597
811
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
598
812
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
599
813
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
600
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
814
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
601
815
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
602
816
  */
603
817
  ...args: any[]) => Record<string, any> | ExtraCellPropGetter<any>) | (() => Record<string, any> | ExtraCellPropGetter<any>) | ((new (
@@ -612,7 +826,7 @@ declare const _default: DefineComponent<Props, {
612
826
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
613
827
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
614
828
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
615
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
829
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
616
830
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
617
831
  */
618
832
  ...args: any[]) => Record<string, any> | ExtraCellPropGetter<any>) | (() => Record<string, any> | ExtraCellPropGetter<any>))[], unknown, unknown>>;
@@ -645,8 +859,68 @@ declare const _default: DefineComponent<Props, {
645
859
  __epPropKey: true;
646
860
  };
647
861
  readonly expandColumnKey: StringConstructor;
648
- readonly expandedRowKeys: EpPropFinalized<(new (...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
649
- readonly defaultExpandedRowKeys: EpPropFinalized<(new (...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
862
+ readonly expandedRowKeys: EpPropFinalized<(new (
863
+ /**
864
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
865
+ *
866
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
867
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
868
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
869
+ *
870
+ * 性能纪律(与方案文档 §5 对应):
871
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
872
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
873
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
874
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
875
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
876
+ */
877
+ ...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (
878
+ /**
879
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
880
+ *
881
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
882
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
883
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
884
+ *
885
+ * 性能纪律(与方案文档 §5 对应):
886
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
887
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
888
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
889
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
890
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
891
+ */
892
+ ...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
893
+ readonly defaultExpandedRowKeys: EpPropFinalized<(new (
894
+ /**
895
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
896
+ *
897
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
898
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
899
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
900
+ *
901
+ * 性能纪律(与方案文档 §5 对应):
902
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
903
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
904
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
905
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
906
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
907
+ */
908
+ ...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (
909
+ /**
910
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
911
+ *
912
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
913
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
914
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
915
+ *
916
+ * 性能纪律(与方案文档 §5 对应):
917
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
918
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
919
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
920
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
921
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
922
+ */
923
+ ...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
650
924
  readonly class: StringConstructor;
651
925
  readonly fixed: BooleanConstructor;
652
926
  readonly style: {
@@ -674,11 +948,71 @@ declare const _default: DefineComponent<Props, {
674
948
  readonly hScrollbarSize: EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
675
949
  readonly vScrollbarSize: EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
676
950
  readonly scrollbarAlwaysOn: BooleanConstructor;
677
- readonly sortBy: EpPropFinalized<(new (...args: any[]) => SortBy) | (() => SortBy) | ((new (...args: any[]) => SortBy) | (() => SortBy))[], unknown, unknown, () => {
951
+ readonly sortBy: EpPropFinalized<(new (
952
+ /**
953
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
954
+ *
955
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
956
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
957
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
958
+ *
959
+ * 性能纪律(与方案文档 §5 对应):
960
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
961
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
962
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
963
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
964
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
965
+ */
966
+ ...args: any[]) => SortBy) | (() => SortBy) | ((new (
967
+ /**
968
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
969
+ *
970
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
971
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
972
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
973
+ *
974
+ * 性能纪律(与方案文档 §5 对应):
975
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
976
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
977
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
978
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
979
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
980
+ */
981
+ ...args: any[]) => SortBy) | (() => SortBy))[], unknown, unknown, () => {
678
982
  key: KeyType;
679
983
  order: TableV2SortOrder;
680
984
  }, boolean>;
681
- readonly sortState: EpPropFinalized<(new (...args: any[]) => SortState) | (() => SortState) | ((new (...args: any[]) => SortState) | (() => SortState))[], unknown, unknown, undefined, boolean>;
985
+ readonly sortState: EpPropFinalized<(new (
986
+ /**
987
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
988
+ *
989
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
990
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
991
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
992
+ *
993
+ * 性能纪律(与方案文档 §5 对应):
994
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
995
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
996
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
997
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
998
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
999
+ */
1000
+ ...args: any[]) => SortState) | (() => SortState) | ((new (
1001
+ /**
1002
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1003
+ *
1004
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1005
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1006
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1007
+ *
1008
+ * 性能纪律(与方案文档 §5 对应):
1009
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1010
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1011
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1012
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1013
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1014
+ */
1015
+ ...args: any[]) => SortState) | (() => SortState))[], unknown, unknown, undefined, boolean>;
682
1016
  readonly onColumnSort: {
683
1017
  readonly type: PropType<ColumnSortHandler<any>>;
684
1018
  readonly required: false;
@@ -704,7 +1038,22 @@ declare const _default: DefineComponent<Props, {
704
1038
  __epPropKey: true;
705
1039
  };
706
1040
  readonly onScroll: {
707
- readonly type: PropType<(...args: any[]) => void>;
1041
+ readonly type: PropType<(
1042
+ /**
1043
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1044
+ *
1045
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1046
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1047
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1048
+ *
1049
+ * 性能纪律(与方案文档 §5 对应):
1050
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1051
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1052
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1053
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1054
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1055
+ */
1056
+ ...args: any[]) => void>;
708
1057
  readonly required: false;
709
1058
  readonly validator: ((val: unknown) => boolean) | undefined;
710
1059
  __epPropKey: true;
@@ -733,7 +1082,7 @@ declare const _default: DefineComponent<Props, {
733
1082
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
734
1083
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
735
1084
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
736
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
1085
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
737
1086
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
738
1087
  */
739
1088
  JSX.
@@ -748,12 +1097,42 @@ declare const _default: DefineComponent<Props, {
748
1097
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
749
1098
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
750
1099
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
751
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
1100
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
752
1101
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
753
1102
  */
754
1103
  Element, {}, {}, {}, {
755
1104
  readonly fixed: boolean;
756
- readonly rowKey: EpPropMergeType<(new (...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown>;
1105
+ readonly rowKey: EpPropMergeType<(new (
1106
+ /**
1107
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1108
+ *
1109
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1110
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1111
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1112
+ *
1113
+ * 性能纪律(与方案文档 §5 对应):
1114
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1115
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1116
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1117
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1118
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1119
+ */
1120
+ ...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (
1121
+ /**
1122
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1123
+ *
1124
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1125
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1126
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1127
+ *
1128
+ * 性能纪律(与方案文档 §5 对应):
1129
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1130
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1131
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1132
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1133
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1134
+ */
1135
+ ...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown>;
757
1136
  readonly useIsScrolling: boolean;
758
1137
  readonly scrollbarAlwaysOn: boolean;
759
1138
  readonly cache: number;
@@ -762,7 +1141,37 @@ declare const _default: DefineComponent<Props, {
762
1141
  readonly hScrollbarSize: number;
763
1142
  readonly vScrollbarSize: number;
764
1143
  readonly sortBy: SortBy;
765
- readonly headerHeight: EpPropMergeType<(new (...args: any[]) => number | number[]) | (() => number | number[]) | ((new (...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown>;
1144
+ readonly headerHeight: EpPropMergeType<(new (
1145
+ /**
1146
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1147
+ *
1148
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1149
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1150
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1151
+ *
1152
+ * 性能纪律(与方案文档 §5 对应):
1153
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1154
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1155
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1156
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1157
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1158
+ */
1159
+ ...args: any[]) => number | number[]) | (() => number | number[]) | ((new (
1160
+ /**
1161
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1162
+ *
1163
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1164
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1165
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1166
+ *
1167
+ * 性能纪律(与方案文档 §5 对应):
1168
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1169
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1170
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1171
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1172
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1173
+ */
1174
+ ...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown>;
766
1175
  readonly footerHeight: number;
767
1176
  readonly indentSize: number;
768
1177
  readonly iconSize: number;
@@ -770,5 +1179,6 @@ declare const _default: DefineComponent<Props, {
770
1179
  readonly expandedRowKeys: KeyType[];
771
1180
  readonly defaultExpandedRowKeys: KeyType[];
772
1181
  }> | null;
1182
+ footerInnerRef: HTMLDivElement;
773
1183
  }, HTMLDivElement>;
774
1184
  export default _default;