erp-plus 1.0.168 → 1.0.170

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,32 @@ 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;
41
+ /** 行类名(与 yw-table 同签名):string | ({ row, rowIndex }) => string。
42
+ * 落点:TableV2 官方 rowClass getter —— row 渲染器里业务值被合入 kls 数组
43
+ * (不会像 rowProps.class 那样被内部 class 覆盖),软删除/悬浮/选中类照常共存。 */
44
+ rowClassName?: string | ((data: {
45
+ row: any;
46
+ rowIndex: number;
47
+ }) => string);
48
+ /** 行样式(与 yw-table 同签名):CSSProperties | ({ row, rowIndex }) => CSSProperties。
49
+ * 落点:表格级 cellProps 的 style(⚠️ 不能走 rowProps.style —— EP row 渲染器里是
50
+ * 对象 spread,业务 style 会被内部布局 style 直接覆盖;cell 渲染器里 extraCellProps
51
+ * 排在 mergeProps 尾部,style 是合并语义:布局 width/height 保留、业务属性叠加)。
52
+ * 单元格默认透明,视觉与 yw-table 的 tr 背景一致;左固定/主表体/右固定三个滚动段
53
+ * 都走 Cell 渲染器,固定列也能一起染色。 */
54
+ rowStyle?: CSSProperties | ((data: {
55
+ row: any;
56
+ rowIndex: number;
57
+ }) => CSSProperties);
32
58
  }
33
59
  declare const _default: DefineComponent<Props, {
34
60
  validate: () => boolean;
@@ -36,6 +62,13 @@ declare const _default: DefineComponent<Props, {
36
62
  clearValidate: () => void;
37
63
  clearSelection: () => void;
38
64
  getSelectedIds: () => KeyType[];
65
+ /** 行软删除:disableRow/Rows 置灰,restoreRow/Rows 还原,getDisabledIds 取已删行键 */
66
+ disableRow: (row: any) => void;
67
+ restoreRow: (row: any) => void;
68
+ disableRows: (rows: any[]) => void;
69
+ restoreRows: (rows: any[]) => void;
70
+ getDisabledIds: () => KeyType[];
71
+ isRowDisabled: (row: any) => boolean;
39
72
  /** TableV2 实例:scrollTo / scrollToRow / scrollToTop / scrollToLeft */
40
73
  tableRef: globalThis.Ref<any, any>;
41
74
  }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
@@ -61,9 +94,12 @@ declare const _default: DefineComponent<Props, {
61
94
  arraySeparator: string;
62
95
  columns: VtTableColumn[];
63
96
  rowKey: string;
97
+ showSummary: boolean;
64
98
  scrollbarAlwaysOn: boolean;
65
99
  minHeight: string | number;
66
100
  overscan: number;
101
+ summaryText: string;
102
+ summaryThousands: boolean;
67
103
  }, {}, {}, {}, string, ComponentProvideOptions, false, {
68
104
  containerRef: HTMLDivElement;
69
105
  tableRef: CreateComponentPublicInstanceWithMixins<Readonly<globalThis.ExtractPropTypes<{
@@ -87,7 +123,7 @@ declare const _default: DefineComponent<Props, {
87
123
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
88
124
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
89
125
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
90
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
126
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
91
127
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
92
128
  */
93
129
  ...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (
@@ -102,7 +138,7 @@ declare const _default: DefineComponent<Props, {
102
138
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
103
139
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
104
140
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
105
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
141
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
106
142
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
107
143
  */
108
144
  ...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown, "id", boolean>;
@@ -119,7 +155,7 @@ declare const _default: DefineComponent<Props, {
119
155
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
120
156
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
121
157
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
122
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
158
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
123
159
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
124
160
  */
125
161
  ...args: any[]) => string | HeaderClassNameGetter<any>) | (() => string | HeaderClassNameGetter<any>) | ((new (
@@ -134,7 +170,7 @@ declare const _default: DefineComponent<Props, {
134
170
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
135
171
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
136
172
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
137
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
173
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
138
174
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
139
175
  */
140
176
  ...args: any[]) => string | HeaderClassNameGetter<any>) | (() => string | HeaderClassNameGetter<any>))[], unknown, unknown>>;
@@ -166,7 +202,7 @@ declare const _default: DefineComponent<Props, {
166
202
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
167
203
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
168
204
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
169
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
205
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
170
206
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
171
207
  */
172
208
  ...args: any[]) => number | number[]) | (() => number | number[]) | ((new (
@@ -181,7 +217,7 @@ declare const _default: DefineComponent<Props, {
181
217
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
182
218
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
183
219
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
184
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
220
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
185
221
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
186
222
  */
187
223
  ...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown, 50, boolean>;
@@ -199,7 +235,7 @@ declare const _default: DefineComponent<Props, {
199
235
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
200
236
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
201
237
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
202
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
238
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
203
239
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
204
240
  */
205
241
  ...args: any[]) => string | RowClassNameGetter<any>) | (() => string | RowClassNameGetter<any>) | ((new (
@@ -214,7 +250,7 @@ declare const _default: DefineComponent<Props, {
214
250
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
215
251
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
216
252
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
217
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
253
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
218
254
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
219
255
  */
220
256
  ...args: any[]) => string | RowClassNameGetter<any>) | (() => string | RowClassNameGetter<any>))[], unknown, unknown>>;
@@ -242,7 +278,7 @@ declare const _default: DefineComponent<Props, {
242
278
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
243
279
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
244
280
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
245
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
281
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
246
282
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
247
283
  */
248
284
  ...args: any[]) => Record<string, any> | ExtraCellPropGetter<any>) | (() => Record<string, any> | ExtraCellPropGetter<any>) | ((new (
@@ -257,7 +293,7 @@ declare const _default: DefineComponent<Props, {
257
293
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
258
294
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
259
295
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
260
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
296
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
261
297
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
262
298
  */
263
299
  ...args: any[]) => Record<string, any> | ExtraCellPropGetter<any>) | (() => Record<string, any> | ExtraCellPropGetter<any>))[], unknown, unknown>>;
@@ -290,8 +326,68 @@ declare const _default: DefineComponent<Props, {
290
326
  __epPropKey: true;
291
327
  };
292
328
  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>;
329
+ readonly expandedRowKeys: EpPropFinalized<(new (
330
+ /**
331
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
332
+ *
333
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
334
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
335
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
336
+ *
337
+ * 性能纪律(与方案文档 §5 对应):
338
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
339
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
340
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
341
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
342
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
343
+ */
344
+ ...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (
345
+ /**
346
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
347
+ *
348
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
349
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
350
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
351
+ *
352
+ * 性能纪律(与方案文档 §5 对应):
353
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
354
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
355
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
356
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
357
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
358
+ */
359
+ ...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
360
+ readonly defaultExpandedRowKeys: EpPropFinalized<(new (
361
+ /**
362
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
363
+ *
364
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
365
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
366
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
367
+ *
368
+ * 性能纪律(与方案文档 §5 对应):
369
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
370
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
371
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
372
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
373
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
374
+ */
375
+ ...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (
376
+ /**
377
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
378
+ *
379
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
380
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
381
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
382
+ *
383
+ * 性能纪律(与方案文档 §5 对应):
384
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
385
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
386
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
387
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
388
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
389
+ */
390
+ ...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
295
391
  readonly class: StringConstructor;
296
392
  readonly fixed: BooleanConstructor;
297
393
  readonly style: {
@@ -319,11 +415,71 @@ declare const _default: DefineComponent<Props, {
319
415
  readonly hScrollbarSize: EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
320
416
  readonly vScrollbarSize: EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
321
417
  readonly scrollbarAlwaysOn: BooleanConstructor;
322
- readonly sortBy: EpPropFinalized<(new (...args: any[]) => SortBy) | (() => SortBy) | ((new (...args: any[]) => SortBy) | (() => SortBy))[], unknown, unknown, () => {
418
+ readonly sortBy: EpPropFinalized<(new (
419
+ /**
420
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
421
+ *
422
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
423
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
424
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
425
+ *
426
+ * 性能纪律(与方案文档 §5 对应):
427
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
428
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
429
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
430
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
431
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
432
+ */
433
+ ...args: any[]) => SortBy) | (() => SortBy) | ((new (
434
+ /**
435
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
436
+ *
437
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
438
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
439
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
440
+ *
441
+ * 性能纪律(与方案文档 §5 对应):
442
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
443
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
444
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
445
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
446
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
447
+ */
448
+ ...args: any[]) => SortBy) | (() => SortBy))[], unknown, unknown, () => {
323
449
  key: KeyType;
324
450
  order: TableV2SortOrder;
325
451
  }, boolean>;
326
- readonly sortState: EpPropFinalized<(new (...args: any[]) => SortState) | (() => SortState) | ((new (...args: any[]) => SortState) | (() => SortState))[], unknown, unknown, undefined, boolean>;
452
+ readonly sortState: EpPropFinalized<(new (
453
+ /**
454
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
455
+ *
456
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
457
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
458
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
459
+ *
460
+ * 性能纪律(与方案文档 §5 对应):
461
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
462
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
463
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
464
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
465
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
466
+ */
467
+ ...args: any[]) => SortState) | (() => SortState) | ((new (
468
+ /**
469
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
470
+ *
471
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
472
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
473
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
474
+ *
475
+ * 性能纪律(与方案文档 §5 对应):
476
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
477
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
478
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
479
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
480
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
481
+ */
482
+ ...args: any[]) => SortState) | (() => SortState))[], unknown, unknown, undefined, boolean>;
327
483
  readonly onColumnSort: {
328
484
  readonly type: PropType<ColumnSortHandler<any>>;
329
485
  readonly required: false;
@@ -349,7 +505,22 @@ declare const _default: DefineComponent<Props, {
349
505
  __epPropKey: true;
350
506
  };
351
507
  readonly onScroll: {
352
- readonly type: PropType<(...args: any[]) => void>;
508
+ readonly type: PropType<(
509
+ /**
510
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
511
+ *
512
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
513
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
514
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
515
+ *
516
+ * 性能纪律(与方案文档 §5 对应):
517
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
518
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
519
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
520
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
521
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
522
+ */
523
+ ...args: any[]) => void>;
353
524
  readonly required: false;
354
525
  readonly validator: ((val: unknown) => boolean) | undefined;
355
526
  __epPropKey: true;
@@ -378,7 +549,7 @@ declare const _default: DefineComponent<Props, {
378
549
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
379
550
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
380
551
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
381
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
552
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
382
553
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
383
554
  */
384
555
  JSX.
@@ -393,12 +564,42 @@ declare const _default: DefineComponent<Props, {
393
564
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
394
565
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
395
566
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
396
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
567
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
397
568
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
398
569
  */
399
570
  Element, unknown, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, Record<string, any>, VNodeProps & AllowedComponentProps & ComponentCustomProps, {
400
571
  readonly fixed: boolean;
401
- readonly rowKey: EpPropMergeType<(new (...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown>;
572
+ readonly rowKey: EpPropMergeType<(new (
573
+ /**
574
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
575
+ *
576
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
577
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
578
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
579
+ *
580
+ * 性能纪律(与方案文档 §5 对应):
581
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
582
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
583
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
584
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
585
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
586
+ */
587
+ ...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (
588
+ /**
589
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
590
+ *
591
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
592
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
593
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
594
+ *
595
+ * 性能纪律(与方案文档 §5 对应):
596
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
597
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
598
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
599
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
600
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
601
+ */
602
+ ...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown>;
402
603
  readonly useIsScrolling: boolean;
403
604
  readonly scrollbarAlwaysOn: boolean;
404
605
  readonly cache: number;
@@ -407,7 +608,37 @@ declare const _default: DefineComponent<Props, {
407
608
  readonly hScrollbarSize: number;
408
609
  readonly vScrollbarSize: number;
409
610
  readonly sortBy: SortBy;
410
- readonly headerHeight: EpPropMergeType<(new (...args: any[]) => number | number[]) | (() => number | number[]) | ((new (...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown>;
611
+ readonly headerHeight: EpPropMergeType<(new (
612
+ /**
613
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
614
+ *
615
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
616
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
617
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
618
+ *
619
+ * 性能纪律(与方案文档 §5 对应):
620
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
621
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
622
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
623
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
624
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
625
+ */
626
+ ...args: any[]) => number | number[]) | (() => number | number[]) | ((new (
627
+ /**
628
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
629
+ *
630
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
631
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
632
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
633
+ *
634
+ * 性能纪律(与方案文档 §5 对应):
635
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
636
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
637
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
638
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
639
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
640
+ */
641
+ ...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown>;
411
642
  readonly footerHeight: number;
412
643
  readonly indentSize: number;
413
644
  readonly iconSize: number;
@@ -442,7 +673,7 @@ declare const _default: DefineComponent<Props, {
442
673
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
443
674
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
444
675
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
445
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
676
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
446
677
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
447
678
  */
448
679
  ...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (
@@ -457,7 +688,7 @@ declare const _default: DefineComponent<Props, {
457
688
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
458
689
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
459
690
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
460
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
691
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
461
692
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
462
693
  */
463
694
  ...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown, "id", boolean>;
@@ -474,7 +705,7 @@ declare const _default: DefineComponent<Props, {
474
705
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
475
706
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
476
707
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
477
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
708
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
478
709
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
479
710
  */
480
711
  ...args: any[]) => string | HeaderClassNameGetter<any>) | (() => string | HeaderClassNameGetter<any>) | ((new (
@@ -489,7 +720,7 @@ declare const _default: DefineComponent<Props, {
489
720
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
490
721
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
491
722
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
492
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
723
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
493
724
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
494
725
  */
495
726
  ...args: any[]) => string | HeaderClassNameGetter<any>) | (() => string | HeaderClassNameGetter<any>))[], unknown, unknown>>;
@@ -521,7 +752,7 @@ declare const _default: DefineComponent<Props, {
521
752
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
522
753
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
523
754
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
524
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
755
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
525
756
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
526
757
  */
527
758
  ...args: any[]) => number | number[]) | (() => number | number[]) | ((new (
@@ -536,7 +767,7 @@ declare const _default: DefineComponent<Props, {
536
767
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
537
768
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
538
769
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
539
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
770
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
540
771
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
541
772
  */
542
773
  ...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown, 50, boolean>;
@@ -554,7 +785,7 @@ declare const _default: DefineComponent<Props, {
554
785
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
555
786
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
556
787
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
557
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
788
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
558
789
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
559
790
  */
560
791
  ...args: any[]) => string | RowClassNameGetter<any>) | (() => string | RowClassNameGetter<any>) | ((new (
@@ -569,7 +800,7 @@ declare const _default: DefineComponent<Props, {
569
800
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
570
801
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
571
802
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
572
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
803
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
573
804
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
574
805
  */
575
806
  ...args: any[]) => string | RowClassNameGetter<any>) | (() => string | RowClassNameGetter<any>))[], unknown, unknown>>;
@@ -597,7 +828,7 @@ declare const _default: DefineComponent<Props, {
597
828
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
598
829
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
599
830
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
600
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
831
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
601
832
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
602
833
  */
603
834
  ...args: any[]) => Record<string, any> | ExtraCellPropGetter<any>) | (() => Record<string, any> | ExtraCellPropGetter<any>) | ((new (
@@ -612,7 +843,7 @@ declare const _default: DefineComponent<Props, {
612
843
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
613
844
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
614
845
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
615
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
846
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
616
847
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
617
848
  */
618
849
  ...args: any[]) => Record<string, any> | ExtraCellPropGetter<any>) | (() => Record<string, any> | ExtraCellPropGetter<any>))[], unknown, unknown>>;
@@ -645,8 +876,68 @@ declare const _default: DefineComponent<Props, {
645
876
  __epPropKey: true;
646
877
  };
647
878
  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>;
879
+ readonly expandedRowKeys: EpPropFinalized<(new (
880
+ /**
881
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
882
+ *
883
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
884
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
885
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
886
+ *
887
+ * 性能纪律(与方案文档 §5 对应):
888
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
889
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
890
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
891
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
892
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
893
+ */
894
+ ...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (
895
+ /**
896
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
897
+ *
898
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
899
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
900
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
901
+ *
902
+ * 性能纪律(与方案文档 §5 对应):
903
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
904
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
905
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
906
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
907
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
908
+ */
909
+ ...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
910
+ readonly defaultExpandedRowKeys: EpPropFinalized<(new (
911
+ /**
912
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
913
+ *
914
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
915
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
916
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
917
+ *
918
+ * 性能纪律(与方案文档 §5 对应):
919
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
920
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
921
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
922
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
923
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
924
+ */
925
+ ...args: any[]) => KeyType[]) | (() => KeyType[]) | ((new (
926
+ /**
927
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
928
+ *
929
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
930
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
931
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
932
+ *
933
+ * 性能纪律(与方案文档 §5 对应):
934
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
935
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
936
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
937
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
938
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
939
+ */
940
+ ...args: any[]) => KeyType[]) | (() => KeyType[]))[], unknown, unknown, () => never[], boolean>;
650
941
  readonly class: StringConstructor;
651
942
  readonly fixed: BooleanConstructor;
652
943
  readonly style: {
@@ -674,11 +965,71 @@ declare const _default: DefineComponent<Props, {
674
965
  readonly hScrollbarSize: EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
675
966
  readonly vScrollbarSize: EpPropFinalized<NumberConstructor, unknown, unknown, 6, boolean>;
676
967
  readonly scrollbarAlwaysOn: BooleanConstructor;
677
- readonly sortBy: EpPropFinalized<(new (...args: any[]) => SortBy) | (() => SortBy) | ((new (...args: any[]) => SortBy) | (() => SortBy))[], unknown, unknown, () => {
968
+ readonly sortBy: EpPropFinalized<(new (
969
+ /**
970
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
971
+ *
972
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
973
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
974
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
975
+ *
976
+ * 性能纪律(与方案文档 §5 对应):
977
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
978
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
979
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
980
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
981
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
982
+ */
983
+ ...args: any[]) => SortBy) | (() => SortBy) | ((new (
984
+ /**
985
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
986
+ *
987
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
988
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
989
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
990
+ *
991
+ * 性能纪律(与方案文档 §5 对应):
992
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
993
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
994
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
995
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
996
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
997
+ */
998
+ ...args: any[]) => SortBy) | (() => SortBy))[], unknown, unknown, () => {
678
999
  key: KeyType;
679
1000
  order: TableV2SortOrder;
680
1001
  }, boolean>;
681
- readonly sortState: EpPropFinalized<(new (...args: any[]) => SortState) | (() => SortState) | ((new (...args: any[]) => SortState) | (() => SortState))[], unknown, unknown, undefined, boolean>;
1002
+ readonly sortState: EpPropFinalized<(new (
1003
+ /**
1004
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1005
+ *
1006
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1007
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1008
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1009
+ *
1010
+ * 性能纪律(与方案文档 §5 对应):
1011
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1012
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1013
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1014
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1015
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1016
+ */
1017
+ ...args: any[]) => SortState) | (() => SortState) | ((new (
1018
+ /**
1019
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1020
+ *
1021
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1022
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1023
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1024
+ *
1025
+ * 性能纪律(与方案文档 §5 对应):
1026
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1027
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1028
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1029
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1030
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1031
+ */
1032
+ ...args: any[]) => SortState) | (() => SortState))[], unknown, unknown, undefined, boolean>;
682
1033
  readonly onColumnSort: {
683
1034
  readonly type: PropType<ColumnSortHandler<any>>;
684
1035
  readonly required: false;
@@ -704,7 +1055,22 @@ declare const _default: DefineComponent<Props, {
704
1055
  __epPropKey: true;
705
1056
  };
706
1057
  readonly onScroll: {
707
- readonly type: PropType<(...args: any[]) => void>;
1058
+ readonly type: PropType<(
1059
+ /**
1060
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1061
+ *
1062
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1063
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1064
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1065
+ *
1066
+ * 性能纪律(与方案文档 §5 对应):
1067
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1068
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1069
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1070
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1071
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1072
+ */
1073
+ ...args: any[]) => void>;
708
1074
  readonly required: false;
709
1075
  readonly validator: ((val: unknown) => boolean) | undefined;
710
1076
  __epPropKey: true;
@@ -733,7 +1099,7 @@ declare const _default: DefineComponent<Props, {
733
1099
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
734
1100
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
735
1101
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
736
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
1102
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
737
1103
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
738
1104
  */
739
1105
  JSX.
@@ -748,12 +1114,42 @@ declare const _default: DefineComponent<Props, {
748
1114
  * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
749
1115
  * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
750
1116
  * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
751
- * 3. 行选中高亮 O(1):直接给行 DOM 打类(同 yw-table 2026-11-10 方案),不走响应式状态;
1117
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
752
1118
  * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
753
1119
  */
754
1120
  Element, {}, {}, {}, {
755
1121
  readonly fixed: boolean;
756
- readonly rowKey: EpPropMergeType<(new (...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown>;
1122
+ readonly rowKey: EpPropMergeType<(new (
1123
+ /**
1124
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1125
+ *
1126
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1127
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1128
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1129
+ *
1130
+ * 性能纪律(与方案文档 §5 对应):
1131
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1132
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1133
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1134
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1135
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1136
+ */
1137
+ ...args: any[]) => string | number | symbol) | (() => KeyType) | ((new (
1138
+ /**
1139
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1140
+ *
1141
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1142
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1143
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1144
+ *
1145
+ * 性能纪律(与方案文档 §5 对应):
1146
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1147
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1148
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1149
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1150
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1151
+ */
1152
+ ...args: any[]) => string | number | symbol) | (() => KeyType))[], unknown, unknown>;
757
1153
  readonly useIsScrolling: boolean;
758
1154
  readonly scrollbarAlwaysOn: boolean;
759
1155
  readonly cache: number;
@@ -762,7 +1158,37 @@ declare const _default: DefineComponent<Props, {
762
1158
  readonly hScrollbarSize: number;
763
1159
  readonly vScrollbarSize: number;
764
1160
  readonly sortBy: SortBy;
765
- readonly headerHeight: EpPropMergeType<(new (...args: any[]) => number | number[]) | (() => number | number[]) | ((new (...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown>;
1161
+ readonly headerHeight: EpPropMergeType<(new (
1162
+ /**
1163
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1164
+ *
1165
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1166
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1167
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1168
+ *
1169
+ * 性能纪律(与方案文档 §5 对应):
1170
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1171
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1172
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1173
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1174
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1175
+ */
1176
+ ...args: any[]) => number | number[]) | (() => number | number[]) | ((new (
1177
+ /**
1178
+ * YwVirtualTable —— 虚拟化表格(1000+ 行滚动场景)。
1179
+ *
1180
+ * 方案:封装 Element Plus TableV2(el-table-v2),虚拟滚动由 TableV2 内置实现,
1181
+ * 只渲染可视区 ± overscan 行。视觉对齐 yw-table(CSS 变量同源,见非 scoped 样式块)。
1182
+ * API 对齐 yw-table:columns 配置式 + slotName 插槽;差异点见 ./types.ts 头注释。
1183
+ *
1184
+ * 性能纪律(与方案文档 §5 对应):
1185
+ * 1. data 不做 deep watch —— 只浅监听引用变化做 errorMap 孤儿清理;
1186
+ * 单元格校验由业务在编辑事件里调 validateCell(O(1)),提交前调 validate 全量;
1187
+ * 2. 滚动事件只透传,组件内部不在滚动路径上做任何渲染状态更新;
1188
+ * 3. 行选中/悬浮高亮按 rowKey 走 rowClass(固定列是独立 DOM 段,只有 rowKey 能三段同步);
1189
+ * 4. 选中集合用 Set(yw-table 的数组 includes 在 1000 行全选时是 O(n²))。
1190
+ */
1191
+ ...args: any[]) => number | number[]) | (() => number | number[]))[], unknown, unknown>;
766
1192
  readonly footerHeight: number;
767
1193
  readonly indentSize: number;
768
1194
  readonly iconSize: number;
@@ -770,5 +1196,6 @@ declare const _default: DefineComponent<Props, {
770
1196
  readonly expandedRowKeys: KeyType[];
771
1197
  readonly defaultExpandedRowKeys: KeyType[];
772
1198
  }> | null;
1199
+ footerInnerRef: HTMLDivElement;
773
1200
  }, HTMLDivElement>;
774
1201
  export default _default;