@tu-design/vue 0.5.14 → 0.5.15

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 (57) hide show
  1. package/dist/index.d.mts +92 -37
  2. package/dist/index.mjs +146 -36
  3. package/dist/registry/vue/alert-dialog.json +1 -1
  4. package/dist/registry/vue/alert.json +1 -1
  5. package/dist/registry/vue/avatar-group.json +1 -1
  6. package/dist/registry/vue/avatar.json +1 -1
  7. package/dist/registry/vue/badge.json +1 -1
  8. package/dist/registry/vue/button.json +1 -1
  9. package/dist/registry/vue/calendar.json +1 -1
  10. package/dist/registry/vue/card.json +1 -1
  11. package/dist/registry/vue/cascader.json +1 -1
  12. package/dist/registry/vue/checkbox.json +1 -1
  13. package/dist/registry/vue/context-menu.json +1 -1
  14. package/dist/registry/vue/currency-input.json +1 -1
  15. package/dist/registry/vue/date-picker.json +1 -1
  16. package/dist/registry/vue/date-range-picker.json +1 -1
  17. package/dist/registry/vue/date-shared.json +1 -1
  18. package/dist/registry/vue/dialog.json +1 -1
  19. package/dist/registry/vue/drawer.json +1 -1
  20. package/dist/registry/vue/dropdown-menu.json +1 -1
  21. package/dist/registry/vue/empty.json +1 -1
  22. package/dist/registry/vue/form-render.json +1 -1
  23. package/dist/registry/vue/form.json +1 -1
  24. package/dist/registry/vue/icon-shared.json +1 -1
  25. package/dist/registry/vue/input.json +1 -1
  26. package/dist/registry/vue/label.json +1 -1
  27. package/dist/registry/vue/month-picker.json +1 -1
  28. package/dist/registry/vue/number-input.json +1 -1
  29. package/dist/registry/vue/overlay-shared.json +1 -1
  30. package/dist/registry/vue/password-input.json +1 -1
  31. package/dist/registry/vue/pin-input.json +1 -1
  32. package/dist/registry/vue/popconfirm.json +1 -1
  33. package/dist/registry/vue/popover.json +1 -1
  34. package/dist/registry/vue/progress.json +1 -1
  35. package/dist/registry/vue/provider.json +1 -1
  36. package/dist/registry/vue/radio-group.json +1 -1
  37. package/dist/registry/vue/registry.json +53 -53
  38. package/dist/registry/vue/select.json +1 -1
  39. package/dist/registry/vue/separator.json +1 -1
  40. package/dist/registry/vue/skeleton.json +1 -1
  41. package/dist/registry/vue/slider.json +1 -1
  42. package/dist/registry/vue/slot.json +1 -1
  43. package/dist/registry/vue/spin.json +1 -1
  44. package/dist/registry/vue/switch.json +1 -1
  45. package/dist/registry/vue/table-render.json +5 -5
  46. package/dist/registry/vue/tabs.json +1 -1
  47. package/dist/registry/vue/textarea.json +1 -1
  48. package/dist/registry/vue/timeline.json +1 -1
  49. package/dist/registry/vue/toast.json +1 -1
  50. package/dist/registry/vue/tokens.json +1 -1
  51. package/dist/registry/vue/tooltip.json +1 -1
  52. package/dist/registry/vue/tree-select.json +1 -1
  53. package/dist/registry/vue/tree-shared.json +1 -1
  54. package/dist/registry/vue/utils.json +1 -1
  55. package/dist/registry/vue/week-picker.json +1 -1
  56. package/dist/registry/vue/year-picker.json +1 -1
  57. package/package.json +1 -1
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "table-render",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:ui",
6
6
  "description": "配置驱动表格渲染器:defineTable 聚合 TanStack Table 实例与列配置,静态/服务端双模式(onLoad 回写分页排序),搜索表单联动(search 接 FormRender),左右固定列 sticky 横向滚动,表体虚拟滚动(virtual + height,TanStack Virtual 动态测量行高),树形数据(tree:子行展开/收起、depth 缩进、caret 位于首列),行拖拽排序(draggable:把手列页内 DnD + drag-sort 事件,静态模式引擎先行重排、服务端模式只发事件;与 tree/virtual 互斥,排序激活/rowKey 缺失时把手置灰),列显隐(columnSettings 面板 + visibleKeys 受控,面板树形三态),表头分组(任意层级多级表头,分组列/固定列/多行 sticky 全兼容),错误态占位与重试(#error 插槽 + load-error),ellipsis 支持 tooltip 形态,v-model 受控(pageIndex/pageSize/sort/selectedKeys),Ark Pagination 分页条 + 原生 select 每页条数,排序表头 aria-sort、加载骨架与空态插槽,语义化 table + Tailwind tokens。",
7
7
  "registryDependencies": [
@@ -27,19 +27,19 @@
27
27
  "path": "table-render/TableBodyRow.vue",
28
28
  "type": "registry:component",
29
29
  "target": "components/ui/table-render/TableBodyRow.vue",
30
- "content": "<script setup lang=\"ts\">\nimport type { PropType, VNodeChild } from \"vue\";\nimport { cloneVNode, h, isVNode } from \"vue\";\nimport { Checkbox } from \"@/components/ui/checkbox\";\nimport { Tooltip } from \"@/components/ui/tooltip\";\nimport { DRAG_CELL, SELECTION_CELL } from \"./constants\";\nimport ChevronIcon from \"../icon-shared/ChevronIcon.vue\";\nimport GripIcon from \"../icon-shared/GripIcon.vue\";\nimport { stickyClass, stickyStyle, type StickyMap } from \"./sticky\";\nimport type { TableBodyLine, TableColumnOptions } from \"./types\";\n\nconst props = defineProps({\n /** 表体行数据(cells 值矩阵已由父层按可见列计算) */\n line: { type: Object as PropType<TableBodyLine>, required: true },\n /** 可见业务列(与 line.cells 同序) */\n columns: { type: Array as PropType<TableColumnOptions[]>, required: true },\n /** 选择列形态;undefined 不渲染选择单元格 */\n selection: {\n type: String as PropType<\"radio\" | \"checkbox\" | undefined>,\n default: undefined,\n },\n selected: { type: Boolean, default: false },\n sticky: { type: Object as PropType<StickyMap>, required: true },\n /** 树形缩进基准 px;undefined 表示未启用树形(不渲染 depth 缩进与 caret) */\n treeIndent: { type: Number, default: undefined },\n /** 是否渲染拖拽把手列(draggable 启用且未被守卫降级) */\n dragColumn: { type: Boolean, default: false },\n /** 本行把手禁用(排序激活 / rowKey 缺失 / 行级谓词 false) */\n dragDisabled: { type: Boolean, default: false },\n /** 本行正在被拖拽(占位态:半透明 + 虚线描边,实时让位预览中即落点提示) */\n dragging: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{\n select: [checked: boolean];\n \"row-click\": [event: MouseEvent];\n \"row-dblclick\": [event: MouseEvent];\n \"row-contextmenu\": [event: MouseEvent];\n \"cell-click\": [columnKey: string, event: MouseEvent];\n /** 把手 dragstart(仅把手可起拖,整行不可拖) */\n \"drag-start\": [event: DragEvent];\n /** 行 dragover(实时让位预览判定) */\n \"drag-over\": [event: DragEvent];\n /** 行 drop(成功落位) */\n drop: [event: DragEvent];\n /** 把手 dragend(含取消路径,仅清理状态) */\n \"drag-end\": [event: DragEvent];\n}>();\n\nfunction cellText(line: TableBodyLine, index: number): string {\n const value = line.cells[index];\n return isVNode(value) ? \"\" : String(value ?? \"\");\n}\n\n/**\n * ellipsis: \"tooltip\" 的单元格内容:默认插槽承载截断内容(触发元素本体,不额外包裹),content 显示完整文本。\n * VNode(render 工厂)单元格经 cloneVNode 复制进触发位(VNode 不可二次挂载)。\n * @param value - 单元格原始内容(VNode 或文本)\n * @param text - 用于 tooltip content 与纯文本兜底的完整文本\n * @returns 包裹 Tooltip 后的渲染结果\n */\nfunction tooltipCell(value: VNodeChild, text: string): VNodeChild {\n const trigger = isVNode(value) ? cloneVNode(value) : h(\"span\", { class: \"block truncate\" }, text);\n return h(Tooltip, { delayDuration: 0, content: text }, { default: () => [trigger] });\n}\n</script>\n\n<template>\n <tr\n class=\"border-b transition-colors hover:bg-muted/50\"\n :class=\"{\n 'opacity-50 [&>td]:outline-2 [&>td]:outline-dashed [&>td]:-outline-offset-2 [&>td]:outline-primary/40':\n props.dragging,\n }\"\n @click=\"emit('row-click', $event)\"\n @dblclick=\"emit('row-dblclick', $event)\"\n @contextmenu=\"emit('row-contextmenu', $event)\"\n @dragover=\"emit('drag-over', $event)\"\n @drop=\"emit('drop', $event)\"\n >\n <!-- 选择单元格:阻断冒泡避免触发行 row-click;radio 为原生控件 -->\n <td\n v-if=\"props.selection\"\n class=\"w-12 p-2 text-center align-middle\"\n :class=\"stickyClass(props.sticky, SELECTION_CELL)\"\n :style=\"stickyStyle(props.sticky, SELECTION_CELL, false)\"\n @click.stop\n >\n <input\n v-if=\"props.selection === 'radio'\"\n type=\"radio\"\n class=\"accent-primary size-4 cursor-pointer disabled:cursor-not-allowed disabled:opacity-50\"\n :checked=\"props.selected\"\n :disabled=\"!props.line.canSelect\"\n :aria-label=\"`选择第 ${props.line.index + 1} 行`\"\n @click=\"emit('select', !props.selected)\"\n />\n <Checkbox\n v-else\n :checked=\"props.selected\"\n :disabled=\"!props.line.canSelect\"\n :aria-label=\"`选择第 ${props.line.index + 1} 行`\"\n @update:checked=\"(checked: boolean) => emit('select', checked)\"\n />\n </td>\n <!-- 拖拽把手单元格:仅把手可起拖(draggable 在按钮上,整行不可拖);阻断冒泡避免触发行 row-click -->\n <td\n v-if=\"props.dragColumn\"\n class=\"p-1 text-center align-middle\"\n :class=\"stickyClass(props.sticky, DRAG_CELL)\"\n :style=\"stickyStyle(props.sticky, DRAG_CELL, false)\"\n @click.stop\n >\n <button\n type=\"button\"\n data-drag-handle\n class=\"text-muted-foreground inline-flex size-6 cursor-grab items-center justify-center rounded-sm active:cursor-grabbing disabled:cursor-not-allowed disabled:opacity-50\"\n :disabled=\"props.dragDisabled\"\n :draggable=\"!props.dragDisabled\"\n :aria-label=\"`拖拽排序第 ${props.line.index + 1} 行`\"\n @dragstart=\"emit('drag-start', $event)\"\n @dragend=\"emit('drag-end', $event)\"\n >\n <GripIcon class=\"size-4\" />\n </button>\n </td>\n <td\n v-for=\"(value, index) in props.line.cells\"\n :key=\"props.columns[index].key\"\n class=\"p-2 align-middle\"\n :class=\"[\n stickyClass(props.sticky, props.columns[index].key),\n { truncate: props.columns[index].ellipsis === true },\n ]\"\n :title=\"props.columns[index].ellipsis === true ? cellText(props.line, index) : undefined\"\n :style=\"[\n { textAlign: props.columns[index].align ?? 'center' },\n stickyStyle(props.sticky, props.columns[index].key, false),\n ]\"\n @click=\"emit('cell-click', props.columns[index].key, $event)\"\n >\n <!-- 首列(tree 启用时):depth 缩进 + 展开 caret(点击 stop 避免误触发行点击) -->\n <span\n v-if=\"props.treeIndent !== undefined && index === 0\"\n class=\"inline-flex max-w-full items-center gap-1\"\n :style=\"{ marginLeft: `${props.line.row.depth * props.treeIndent}px` }\"\n >\n <button\n v-if=\"props.line.row.getCanExpand()\"\n type=\"button\"\n class=\"hover:bg-muted text-muted-foreground inline-flex size-4 shrink-0 cursor-pointer items-center justify-center rounded-sm\"\n :aria-expanded=\"props.line.row.getIsExpanded()\"\n :aria-label=\"props.line.row.getIsExpanded() ? '收起' : '展开'\"\n @click.stop=\"props.line.row.toggleExpanded()\"\n >\n <ChevronIcon\n class=\"size-3.5 transition-transform\"\n :class=\"{ 'rotate-90': props.line.row.getIsExpanded() }\"\n />\n </button>\n <!-- VNode 必须走子节点渲染;文本插值会序列化 vnode 导致循环引用 -->\n <component :is=\"value\" v-if=\"isVNode(value)\" />\n <span v-else class=\"min-w-0 truncate\">{{ value }}</span>\n </span>\n <!-- ellipsis: \"tooltip\":Tooltip 包装(VNode 经 cloneVNode 复制,避免二次挂载) -->\n <component\n :is=\"tooltipCell(value, cellText(props.line, index))\"\n v-else-if=\"props.columns[index].ellipsis === 'tooltip'\"\n />\n <template v-else>\n <!-- VNode 必须走子节点渲染;文本插值会序列化 vnode 导致循环引用 -->\n <component :is=\"value\" v-if=\"isVNode(value)\" />\n <template v-else>{{ value }}</template>\n </template>\n </td>\n </tr>\n</template>\n"
30
+ "content": "<script setup lang=\"ts\">\nimport type { PropType, VNodeChild } from \"vue\";\nimport { cloneVNode, computed, h, isVNode } from \"vue\";\nimport { Checkbox } from \"@/components/ui/checkbox\";\nimport { Tooltip } from \"@/components/ui/tooltip\";\nimport { DRAG_CELL, SELECTION_CELL } from \"./constants\";\nimport ChevronIcon from \"../icon-shared/ChevronIcon.vue\";\nimport GripIcon from \"../icon-shared/GripIcon.vue\";\nimport { stickyClass, stickyStyle, type StickyMap } from \"./sticky\";\nimport type { TableBodyLine, TableColumnOptions } from \"./types\";\n\nconst props = defineProps({\n /** 表体行数据(cells 值矩阵已由父层按可见列计算) */\n line: { type: Object as PropType<TableBodyLine>, required: true },\n /** 可见业务列(与 line.cells 同序) */\n columns: { type: Array as PropType<TableColumnOptions[]>, required: true },\n /** 选择列形态;undefined 不渲染选择单元格 */\n selection: {\n type: String as PropType<\"radio\" | \"checkbox\" | undefined>,\n default: undefined,\n },\n selected: { type: Boolean, default: false },\n sticky: { type: Object as PropType<StickyMap>, required: true },\n /** 树形缩进基准 px;undefined 表示未启用树形(不渲染 depth 缩进与 caret) */\n treeIndent: { type: Number, default: undefined },\n /** 是否渲染拖拽把手列(draggable 启用且未被守卫降级) */\n dragColumn: { type: Boolean, default: false },\n /** 本行把手禁用(排序激活 / rowKey 缺失 / 行级谓词 false) */\n dragDisabled: { type: Boolean, default: false },\n /** 本行正在被拖拽(占位态:半透明 + 虚线描边,实时让位预览中即落点提示) */\n dragging: { type: Boolean, default: false },\n /** 行分割线开关(single-column 关闭):td 的 border-b(末行由 tbody 选择器置 0) */\n rowLines: { type: Boolean, default: true },\n /** 列分割线开关(single-line: false 开启):非行末 td 的 border-r(选择/把手列恒非行末) */\n columnLines: { type: Boolean, default: false },\n /** 斑马纹开关(父层传入;奇偶按行模型索引在内部收敛,供 sticky 单元格换不透明固色) */\n striped: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{\n select: [checked: boolean];\n \"row-click\": [event: MouseEvent];\n \"row-dblclick\": [event: MouseEvent];\n \"row-contextmenu\": [event: MouseEvent];\n \"cell-click\": [columnKey: string, event: MouseEvent];\n /** 把手 dragstart(仅把手可起拖,整行不可拖) */\n \"drag-start\": [event: DragEvent];\n /** 行 dragover(实时让位预览判定) */\n \"drag-over\": [event: DragEvent];\n /** 行 drop(成功落位) */\n drop: [event: DragEvent];\n /** 把手 dragend(含取消路径,仅清理状态) */\n \"drag-end\": [event: DragEvent];\n}>();\n\nfunction cellText(line: TableBodyLine, index: number): string {\n const value = line.cells[index];\n return isVNode(value) ? \"\" : String(value ?? \"\");\n}\n\n/** stickyClass 行为开关:列线抑制 + 奇数条纹固色(与父层 tr 条纹同一奇偶口径,行模型索引) */\nconst stickyOpts = computed(() => ({\n columnLines: props.columnLines,\n striped: props.striped && props.line.index % 2 === 1,\n}));\n\n/**\n * ellipsis: \"tooltip\" 的单元格内容:默认插槽承载截断内容(触发元素本体,不额外包裹),content 显示完整文本。\n * VNode(render 工厂)单元格经 cloneVNode 复制进触发位(VNode 不可二次挂载)。\n * @param value - 单元格原始内容(VNode 或文本)\n * @param text - 用于 tooltip content 与纯文本兜底的完整文本\n * @returns 包裹 Tooltip 后的渲染结果\n */\nfunction tooltipCell(value: VNodeChild, text: string): VNodeChild {\n const trigger = isVNode(value) ? cloneVNode(value) : h(\"span\", { class: \"block truncate\" }, text);\n return h(Tooltip, { delayDuration: 0, content: text }, { default: () => [trigger] });\n}\n</script>\n\n<template>\n <tr\n class=\"transition-colors hover:bg-muted/50\"\n :class=\"{\n 'opacity-50 [&>td]:outline-2 [&>td]:outline-dashed [&>td]:-outline-offset-2 [&>td]:outline-primary/40':\n props.dragging,\n }\"\n @click=\"emit('row-click', $event)\"\n @dblclick=\"emit('row-dblclick', $event)\"\n @contextmenu=\"emit('row-contextmenu', $event)\"\n @dragover=\"emit('drag-over', $event)\"\n @drop=\"emit('drop', $event)\"\n >\n <!-- 选择单元格:阻断冒泡避免触发行 row-click;radio 为原生控件 -->\n <td\n v-if=\"props.selection\"\n class=\"w-12 p-2 text-center align-middle\"\n :class=\"[\n props.rowLines ? 'border-b border-border' : '',\n props.columnLines ? 'border-r border-border' : '',\n stickyClass(props.sticky, SELECTION_CELL, stickyOpts),\n ]\"\n :style=\"stickyStyle(props.sticky, SELECTION_CELL, false)\"\n @click.stop\n >\n <input\n v-if=\"props.selection === 'radio'\"\n type=\"radio\"\n class=\"accent-primary size-4 cursor-pointer disabled:cursor-not-allowed disabled:opacity-50\"\n :checked=\"props.selected\"\n :disabled=\"!props.line.canSelect\"\n :aria-label=\"`选择第 ${props.line.index + 1} 行`\"\n @click=\"emit('select', !props.selected)\"\n />\n <Checkbox\n v-else\n :checked=\"props.selected\"\n :disabled=\"!props.line.canSelect\"\n :aria-label=\"`选择第 ${props.line.index + 1} 行`\"\n @update:checked=\"(checked: boolean) => emit('select', checked)\"\n />\n </td>\n <!-- 拖拽把手单元格:仅把手可起拖(draggable 在按钮上,整行不可拖);阻断冒泡避免触发行 row-click -->\n <td\n v-if=\"props.dragColumn\"\n class=\"p-1 text-center align-middle\"\n :class=\"[\n props.rowLines ? 'border-b border-border' : '',\n props.columnLines ? 'border-r border-border' : '',\n stickyClass(props.sticky, DRAG_CELL, stickyOpts),\n ]\"\n :style=\"stickyStyle(props.sticky, DRAG_CELL, false)\"\n @click.stop\n >\n <button\n type=\"button\"\n data-drag-handle\n class=\"text-muted-foreground inline-flex size-6 cursor-grab items-center justify-center rounded-sm active:cursor-grabbing disabled:cursor-not-allowed disabled:opacity-50\"\n :disabled=\"props.dragDisabled\"\n :draggable=\"!props.dragDisabled\"\n :aria-label=\"`拖拽排序第 ${props.line.index + 1} 行`\"\n @dragstart=\"emit('drag-start', $event)\"\n @dragend=\"emit('drag-end', $event)\"\n >\n <GripIcon class=\"size-4\" />\n </button>\n </td>\n <td\n v-for=\"(value, index) in props.line.cells\"\n :key=\"props.columns[index].key\"\n class=\"p-2 align-middle\"\n :class=\"[\n props.rowLines ? 'border-b border-border' : '',\n props.columnLines && index < props.line.cells.length - 1 ? 'border-r border-border' : '',\n stickyClass(props.sticky, props.columns[index].key, stickyOpts),\n { truncate: props.columns[index].ellipsis === true },\n ]\"\n :title=\"props.columns[index].ellipsis === true ? cellText(props.line, index) : undefined\"\n :style=\"[\n { textAlign: props.columns[index].align ?? 'center' },\n stickyStyle(props.sticky, props.columns[index].key, false),\n ]\"\n @click=\"emit('cell-click', props.columns[index].key, $event)\"\n >\n <!-- 首列(tree 启用时):depth 缩进 + 展开 caret(点击 stop 避免误触发行点击) -->\n <span\n v-if=\"props.treeIndent !== undefined && index === 0\"\n class=\"inline-flex max-w-full items-center gap-1\"\n :style=\"{ marginLeft: `${props.line.row.depth * props.treeIndent}px` }\"\n >\n <button\n v-if=\"props.line.row.getCanExpand()\"\n type=\"button\"\n class=\"hover:bg-muted text-muted-foreground inline-flex size-4 shrink-0 cursor-pointer items-center justify-center rounded-sm\"\n :aria-expanded=\"props.line.row.getIsExpanded()\"\n :aria-label=\"props.line.row.getIsExpanded() ? '收起' : '展开'\"\n @click.stop=\"props.line.row.toggleExpanded()\"\n >\n <ChevronIcon\n class=\"size-3.5 transition-transform\"\n :class=\"{ 'rotate-90': props.line.row.getIsExpanded() }\"\n />\n </button>\n <!-- VNode 必须走子节点渲染;文本插值会序列化 vnode 导致循环引用 -->\n <component :is=\"value\" v-if=\"isVNode(value)\" />\n <span v-else class=\"min-w-0 truncate\">{{ value }}</span>\n </span>\n <!-- ellipsis: \"tooltip\":Tooltip 包装(VNode 经 cloneVNode 复制,避免二次挂载) -->\n <component\n :is=\"tooltipCell(value, cellText(props.line, index))\"\n v-else-if=\"props.columns[index].ellipsis === 'tooltip'\"\n />\n <template v-else>\n <!-- VNode 必须走子节点渲染;文本插值会序列化 vnode 导致循环引用 -->\n <component :is=\"value\" v-if=\"isVNode(value)\" />\n <template v-else>{{ value }}</template>\n </template>\n </td>\n </tr>\n</template>\n"
31
31
  },
32
32
  {
33
33
  "path": "table-render/TablePagination.vue",
34
34
  "type": "registry:component",
35
35
  "target": "components/ui/table-render/TablePagination.vue",
36
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport type { TableRenderDefinition } from \"./types\";\nimport {\n PaginationEllipsis as ArkPaginationEllipsis,\n PaginationItem as ArkPaginationItem,\n PaginationNextTrigger as ArkPaginationNextTrigger,\n PaginationPrevTrigger as ArkPaginationPrevTrigger,\n PaginationRoot as ArkPaginationRoot,\n} from \"@ark-ui/vue/pagination\";\nimport { computed } from \"vue\";\nimport { cn } from \"@/lib/utils\";\n\n// boolean props 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false;TableRender/FormRender 同款约定)\nconst props = defineProps({\n /** 组合式:传 defineTable 返回值,自动接线 page/动作并单页自隐藏;\n * 与手动分页 props 同传时以 definition 为准(DEV 警告) */\n definition: { type: Object as PropType<TableRenderDefinition<any>> },\n /** 1-based 当前页码(手动模式) */\n pageIndex: { type: Number, default: undefined },\n pageSize: { type: Number, default: undefined },\n pageSizeOpts: { type: Array as PropType<readonly number[]>, default: undefined },\n total: { type: Number, default: undefined },\n /** 「共 N 条」,缺省 true */\n showTotal: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 条/页 select,缺省 false(组合式简形分页条可保持关闭) */\n showSizeSelect: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 上一页/下一页形态:text 文字(缺省)/ icon 图标 */\n navMode: { type: String as PropType<\"text\" | \"icon\">, default: \"text\" },\n});\n\nconst emit = defineEmits<{\n \"update:pageIndex\": [pageIndex: number];\n \"update:pageSize\": [pageSize: number];\n}>();\n\n// 输入解析在 setup 期定版(definition/手动模式不支持运行时切换,同 TableRender 约定):\n// ① definition 与手动分页 props 同传 → 以 definition 为准(DEV 警告);\n// ② 仅手动且缺 pageIndex/pageSize/total 任一 → DEV 警告 + 不渲染\nif (import.meta.env.DEV) {\n if (\n props.definition &&\n (props.pageIndex !== undefined ||\n props.pageSize !== undefined ||\n props.pageSizeOpts !== undefined ||\n props.total !== undefined)\n ) {\n console.warn(\n \"[tu-design] <TablePagination> definition 与手动分页 props 同传,已按 definition 渲染。\",\n );\n }\n if (\n !props.definition &&\n (props.pageIndex === undefined || props.pageSize === undefined || props.total === undefined)\n ) {\n console.warn(\n \"[tu-design] <TablePagination> 缺少 definition 或 pageIndex/pageSize/total,组件不渲染。\",\n );\n }\n}\n\n// definition 优先投影;手动模式直读 props(缺省 undefined 走 visible 兜底)\nconst pageIndex = computed(() => props.definition?.page.pageIndex ?? props.pageIndex);\nconst pageSize = computed(() => props.definition?.page.pageSize ?? props.pageSize);\nconst pageSizeOpts = computed(() => props.definition?.page.pageSizeOpts ?? props.pageSizeOpts);\nconst total = computed(() => props.definition?.page.total ?? props.total);\nconst totalPages = computed(() =>\n Math.max(1, Math.ceil((total.value ?? 0) / (pageSize.value ?? 1))),\n);\n\n/** 可见性:definition 模式单页自隐藏;手动模式须 pageIndex/pageSize/total 齐备(缺项 DEV 警告 + 不渲染) */\nconst visible = computed(() => {\n if (props.definition !== undefined) {\n return Math.ceil((total.value ?? 0) / (pageSize.value ?? 1)) > 1;\n }\n return props.pageIndex !== undefined && props.pageSize !== undefined && props.total !== undefined;\n});\n\nconst showTotalBar = computed(() => props.showTotal ?? true);\nconst showSelect = computed(() => props.showSizeSelect ?? false);\nconst iconMode = computed(() => props.navMode === \"icon\");\nconst hasLeft = computed(() => showTotalBar.value || showSelect.value);\n\n// definition 模式经实例动作接线;事件恒 emit(幂等:同值重复设置无害),便于本地联动\nfunction onPageIndex(value: number) {\n props.definition?.setPageIndex(value);\n emit(\"update:pageIndex\", value);\n}\n\nfunction onPageSize(value: number) {\n props.definition?.setPageSize(value);\n emit(\"update:pageSize\", value);\n}\n\n/** 页码窗口:首页/尾页 + 当前页 ±1,跳过段用省略号 */\nconst pages = computed<(number | string)[]>(() => {\n const count = totalPages.value;\n const current = pageIndex.value ?? 1;\n const window = [...new Set([1, count, current - 1, current, current + 1])]\n .filter((page) => page >= 1 && page <= count)\n .sort((a, b) => a - b);\n\n const items: (number | string)[] = [];\n let previous = 0;\n for (const page of window) {\n if (previous && page - previous > 1) items.push(\"…\");\n items.push(page);\n previous = page;\n }\n return items;\n});\n</script>\n\n<template>\n <!-- 不带 border-t(布局归使用方,TableRender 内置使用处显式补);左区缺省时页码靠右 -->\n <div\n v-if=\"visible\"\n :class=\"\n cn(\n 'flex w-full items-center gap-4 p-2 text-sm',\n hasLeft ? 'justify-between' : 'justify-end',\n $attrs.class,\n )\n \"\n >\n <div v-if=\"hasLeft\" class=\"flex items-center gap-2 text-muted-foreground\">\n <span v-if=\"showTotalBar\">共 {{ total }} 条</span>\n <select\n v-if=\"showSelect\"\n class=\"h-8 rounded-md border bg-transparent px-2 text-sm\"\n :value=\"pageSize\"\n @change=\"onPageSize(Number(($event.target as HTMLSelectElement).value))\"\n >\n <option v-for=\"size in pageSizeOpts\" :key=\"size\" :value=\"size\">{{ size }} 条/页</option>\n </select>\n </div>\n\n <!-- Root 渲染为裸 nav 且 Ellipsis 是块级 div,必须显式 flex 才不会断行 -->\n <ArkPaginationRoot\n class=\"flex items-center gap-1\"\n :count=\"total ?? 0\"\n :page=\"pageIndex ?? 1\"\n :page-size=\"pageSize ?? 1\"\n :sibling-count=\"1\"\n @page-change=\"onPageIndex($event.page)\"\n >\n <ArkPaginationPrevTrigger\n class=\"h-8 rounded-md border px-2 disabled:opacity-50\"\n :class=\"{ 'px-3': !iconMode }\"\n :disabled=\"(pageIndex ?? 1) <= 1\"\n :aria-label=\"iconMode ? '上一页' : undefined\"\n >\n <svg\n v-if=\"iconMode\"\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"m15 18-6-6 6-6\" />\n </svg>\n <template v-else>上一页</template>\n </ArkPaginationPrevTrigger>\n\n <template\n v-for=\"(item, index) in pages\"\n :key=\"typeof item === 'number' ? item : `gap-${index}`\"\n >\n <ArkPaginationEllipsis v-if=\"typeof item === 'string'\" :index=\"index\" />\n <ArkPaginationItem\n v-else\n type=\"page\"\n class=\"h-8 min-w-8 rounded-md border px-2 data-[selected]:bg-primary data-[selected]:text-primary-foreground\"\n :value=\"item\"\n >\n {{ item }}\n </ArkPaginationItem>\n </template>\n\n <ArkPaginationNextTrigger\n class=\"h-8 rounded-md border px-2 disabled:opacity-50\"\n :class=\"{ 'px-3': !iconMode }\"\n :disabled=\"(pageIndex ?? 1) >= totalPages\"\n :aria-label=\"iconMode ? '下一页' : undefined\"\n >\n <svg\n v-if=\"iconMode\"\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"m9 18 6-6-6-6\" />\n </svg>\n <template v-else>下一页</template>\n </ArkPaginationNextTrigger>\n </ArkPaginationRoot>\n </div>\n</template>\n"
36
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport type { TableRenderDefinition } from \"./types\";\nimport {\n PaginationEllipsis as ArkPaginationEllipsis,\n PaginationItem as ArkPaginationItem,\n PaginationNextTrigger as ArkPaginationNextTrigger,\n PaginationPrevTrigger as ArkPaginationPrevTrigger,\n PaginationRoot as ArkPaginationRoot,\n} from \"@ark-ui/vue/pagination\";\nimport { computed } from \"vue\";\nimport { cn } from \"@/lib/utils\";\n\n// boolean props 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false;TableRender/FormRender 同款约定)\nconst props = defineProps({\n /** 组合式:传 defineTable 返回值,自动接线 page/动作并单页自隐藏;\n * 与手动分页 props 同传时以 definition 为准(DEV 警告) */\n definition: { type: Object as PropType<TableRenderDefinition<any>> },\n /** 1-based 当前页码(手动模式) */\n pageIndex: { type: Number, default: undefined },\n pageSize: { type: Number, default: undefined },\n pageSizeOpts: { type: Array as PropType<readonly number[]>, default: undefined },\n total: { type: Number, default: undefined },\n /** 「共 N 条」,缺省 true */\n showTotal: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 条/页 select,缺省 false(组合式简形分页条可保持关闭) */\n showSizeSelect: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 上一页/下一页形态:text 文字(缺省)/ icon 图标 */\n navMode: { type: String as PropType<\"text\" | \"icon\">, default: \"text\" },\n});\n\nconst emit = defineEmits<{\n \"update:pageIndex\": [pageIndex: number];\n \"update:pageSize\": [pageSize: number];\n}>();\n\n// 输入解析在 setup 期定版(definition/手动模式不支持运行时切换,同 TableRender 约定):\n// ① definition 与手动分页 props 同传 → 以 definition 为准(DEV 警告);\n// ② 仅手动且缺 pageIndex/pageSize/total 任一 → DEV 警告 + 不渲染\nif (import.meta.env.DEV) {\n if (\n props.definition &&\n (props.pageIndex !== undefined ||\n props.pageSize !== undefined ||\n props.pageSizeOpts !== undefined ||\n props.total !== undefined)\n ) {\n console.warn(\n \"[tu-design] <TablePagination> definition 与手动分页 props 同传,已按 definition 渲染。\",\n );\n }\n if (\n !props.definition &&\n (props.pageIndex === undefined || props.pageSize === undefined || props.total === undefined)\n ) {\n console.warn(\n \"[tu-design] <TablePagination> 缺少 definition 或 pageIndex/pageSize/total,组件不渲染。\",\n );\n }\n}\n\n// definition 优先投影;手动模式直读 props(缺省 undefined 走 visible 兜底)\nconst pageIndex = computed(() => props.definition?.page.pageIndex ?? props.pageIndex);\nconst pageSize = computed(() => props.definition?.page.pageSize ?? props.pageSize);\nconst pageSizeOpts = computed(() => props.definition?.page.pageSizeOpts ?? props.pageSizeOpts);\nconst total = computed(() => props.definition?.page.total ?? props.total);\nconst totalPages = computed(() =>\n Math.max(1, Math.ceil((total.value ?? 0) / (pageSize.value ?? 1))),\n);\n\n/** 可见性:definition 模式单页自隐藏;手动模式须 pageIndex/pageSize/total 齐备(缺项 DEV 警告 + 不渲染) */\nconst visible = computed(() => {\n if (props.definition !== undefined) {\n return Math.ceil((total.value ?? 0) / (pageSize.value ?? 1)) > 1;\n }\n return props.pageIndex !== undefined && props.pageSize !== undefined && props.total !== undefined;\n});\n\nconst showTotalBar = computed(() => props.showTotal ?? true);\nconst showSelect = computed(() => props.showSizeSelect ?? false);\nconst iconMode = computed(() => props.navMode === \"icon\");\nconst hasLeft = computed(() => showTotalBar.value || showSelect.value);\n\n// definition 模式经实例动作接线;事件恒 emit(幂等:同值重复设置无害),便于本地联动\nfunction onPageIndex(value: number) {\n props.definition?.setPageIndex(value);\n emit(\"update:pageIndex\", value);\n}\n\nfunction onPageSize(value: number) {\n props.definition?.setPageSize(value);\n emit(\"update:pageSize\", value);\n}\n\n/** 页码窗口:首页/尾页 + 当前页 ±1,跳过段用省略号 */\nconst pages = computed<(number | string)[]>(() => {\n const count = totalPages.value;\n const current = pageIndex.value ?? 1;\n const window = [...new Set([1, count, current - 1, current, current + 1])]\n .filter((page) => page >= 1 && page <= count)\n .sort((a, b) => a - b);\n\n const items: (number | string)[] = [];\n let previous = 0;\n for (const page of window) {\n if (previous && page - previous > 1) items.push(\"…\");\n items.push(page);\n previous = page;\n }\n return items;\n});\n</script>\n\n<template>\n <!-- 不带 border-t(布局归使用方;表格与分页条之间的分隔线由表格底线承担:bordered 外框 / bottom-bordered);左区缺省时页码靠右 -->\n <div\n v-if=\"visible\"\n :class=\"\n cn(\n 'flex w-full items-center gap-4 p-2 text-sm',\n hasLeft ? 'justify-between' : 'justify-end',\n $attrs.class,\n )\n \"\n >\n <div v-if=\"hasLeft\" class=\"flex items-center gap-2 text-muted-foreground\">\n <span v-if=\"showTotalBar\">共 {{ total }} 条</span>\n <select\n v-if=\"showSelect\"\n class=\"h-8 rounded-md border bg-transparent px-2 text-sm\"\n :value=\"pageSize\"\n @change=\"onPageSize(Number(($event.target as HTMLSelectElement).value))\"\n >\n <option v-for=\"size in pageSizeOpts\" :key=\"size\" :value=\"size\">{{ size }} 条/页</option>\n </select>\n </div>\n\n <!-- Root 渲染为裸 nav 且 Ellipsis 是块级 div,必须显式 flex 才不会断行 -->\n <ArkPaginationRoot\n class=\"flex items-center gap-1\"\n :count=\"total ?? 0\"\n :page=\"pageIndex ?? 1\"\n :page-size=\"pageSize ?? 1\"\n :sibling-count=\"1\"\n @page-change=\"onPageIndex($event.page)\"\n >\n <ArkPaginationPrevTrigger\n class=\"h-8 rounded-md border px-2 disabled:opacity-50\"\n :class=\"{ 'px-3': !iconMode }\"\n :disabled=\"(pageIndex ?? 1) <= 1\"\n :aria-label=\"iconMode ? '上一页' : undefined\"\n >\n <svg\n v-if=\"iconMode\"\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"m15 18-6-6 6-6\" />\n </svg>\n <template v-else>上一页</template>\n </ArkPaginationPrevTrigger>\n\n <template\n v-for=\"(item, index) in pages\"\n :key=\"typeof item === 'number' ? item : `gap-${index}`\"\n >\n <ArkPaginationEllipsis v-if=\"typeof item === 'string'\" :index=\"index\" />\n <ArkPaginationItem\n v-else\n type=\"page\"\n class=\"h-8 min-w-8 rounded-md border px-2 data-[selected]:bg-primary data-[selected]:text-primary-foreground\"\n :value=\"item\"\n >\n {{ item }}\n </ArkPaginationItem>\n </template>\n\n <ArkPaginationNextTrigger\n class=\"h-8 rounded-md border px-2 disabled:opacity-50\"\n :class=\"{ 'px-3': !iconMode }\"\n :disabled=\"(pageIndex ?? 1) >= totalPages\"\n :aria-label=\"iconMode ? '下一页' : undefined\"\n >\n <svg\n v-if=\"iconMode\"\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"m9 18 6-6-6-6\" />\n </svg>\n <template v-else>下一页</template>\n </ArkPaginationNextTrigger>\n </ArkPaginationRoot>\n </div>\n</template>\n"
37
37
  },
38
38
  {
39
39
  "path": "table-render/TableRender.vue",
40
40
  "type": "registry:component",
41
41
  "target": "components/ui/table-render/TableRender.vue",
42
- "content": "<script setup lang=\"ts\">\nimport type { ComponentPublicInstance, PropType, VNodeChild } from \"vue\";\nimport { useVirtualizer } from \"@tanstack/vue-virtual\";\nimport { columnRenders } from \"./column-renders\";\nimport { computed, inject, nextTick, onMounted, ref, watch } from \"vue\";\nimport { Button } from \"@/components/ui/button\";\nimport { Checkbox } from \"@/components/ui/checkbox\";\nimport { FormRender, type FormRenderDefinition } from \"@/components/ui/form-render\";\nimport { Popover } from \"@/components/ui/popover\";\nimport { Separator } from \"@/components/ui/separator\";\nimport { Skeleton } from \"@/components/ui/skeleton\";\nimport { Tooltip } from \"@/components/ui/tooltip\";\nimport { cn } from \"@/lib/utils\";\nimport { isColumnGroup } from \"./columns\";\nimport { PAGE_TABLE_FILL_KEY, DRAG_CELL, SELECTION_CELL } from \"./constants\";\nimport { stickyClass, stickyStyle, type StickyMap } from \"./sticky\";\nimport TableBodyRow from \"./TableBodyRow.vue\";\nimport TablePagination from \"./TablePagination.vue\";\nimport type {\n ColumnVisibilityOptions,\n DataRecord,\n SortableOptions,\n TableBodyLine,\n TableColumnGroupOptions,\n TableColumnNode,\n TableColumnOptions,\n TableDraggableOptions,\n TableDragSortPayload,\n TableLoadParams,\n TableRenderDefinition,\n TableSelectionOptions,\n TreeOptions,\n} from \"./types\";\nimport { useTableRender } from \"./useTableRender\";\nimport { createRowSnapshot, useRowDrag } from \"./useRowDrag\";\n\n// boolean flags 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false;Checkbox/Dialog/FormRender 同款约定)\nconst props = defineProps({\n /** 聚合式(推荐):defineTable 返回的定义对象 */\n definition: { type: Object as PropType<TableRenderDefinition<any>> },\n /** 数据主键(记录缺字段时以行索引兜底) */\n rowKey: { type: String, required: true },\n /** 拆分式:与 definition 二选一,definition 优先(支持分组列节点;列泛型不约束记录形态) */\n columns: { type: Array as PropType<TableColumnNode<any>[]> },\n onLoad: {\n type: Function as PropType<(params: TableLoadParams) => void | Promise<unknown>>,\n },\n data: { type: Array as PropType<DataRecord[]> },\n autoLoad: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 每页条数 / 受控每页条数:传入即受控(pageIndex 未受控时页码归位内部处理并通知) */\n pageSize: { type: Number },\n pageSizeOpts: { type: Array as PropType<number[]> },\n loading: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n emptyText: { type: String },\n /** 行选择(仅拆分式生效;聚合式请在 defineTable 配置):\"radio\" | \"checkbox\" | 对象 */\n rowSelection: {\n type: [String, Object] as PropType<\"radio\" | \"checkbox\" | TableSelectionOptions>,\n default: undefined,\n },\n /** 搜索表单(defineForm 返回值):拆分式直接传;聚合式请在 defineTable 配置(definition 优先,同传 DEV 警告) */\n search: { type: Object as PropType<FormRenderDefinition<any>> },\n /** 虚拟滚动:开启后表体行虚拟化渲染;聚合式请在 defineTable 配置(definition 优先);须同时给 height */\n virtual: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 虚拟滚动容器高度(数字 px 或 CSS 高度);仅 virtual: true 时生效 */\n height: { type: [Number, String] as PropType<number | string> },\n /** 树形数据(子行展开/收起);拆分式直接传,聚合式请在 defineTable 配置 */\n tree: { type: Object as PropType<TreeOptions> },\n /** 行拖拽排序(仅拆分式生效;聚合式请在 defineTable 配置):true 或对象配置;与 tree/virtual 互斥 */\n draggable: {\n type: [Boolean, Object] as PropType<boolean | TableDraggableOptions>,\n default: undefined,\n },\n /** 受控页码(1-based):传入即受控,缺省非受控;内部翻页经 update:page-index 通知 */\n pageIndex: { type: Number },\n /** 受控排序:传入即受控;内部/外部变化均经 sort-change 通知 */\n sort: { type: Object as PropType<SortableOptions> },\n /** 受控选中集(数组,与 update:selected-keys 载荷同构):传入即受控 */\n selectedKeys: { type: Array as PropType<Array<string | number>> },\n /** 受控可见列 key(columns 原序子集):传入即受控;内部显隐经 update:visible-keys 通知 */\n visibleKeys: { type: Array as PropType<string[]> },\n /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(definition 优先) */\n defaultVisibleKeys: { type: Array as PropType<string[]> },\n /** 列设置触发器/面板开关(默认 true);false 时不渲染 UI,受控 API 不受影响 */\n columnSettings: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 搜索区渲染开关:false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */\n showSearch: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 分页条渲染开关:false 关闭内置分页条(组合式外置 TablePagination);缺省模式单页自隐藏不变 */\n showPagination: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 填充模式:根容器 h-full 纵向 flex,滚动区 flex-1 内滚;表头 sticky 钉住。\n * 父链需有确定高度(如页面布局的 .table-body);无确定高度时安全退化为自然高度。\n * 显式 prop 优先于布局 provide(key: \"tu-design:page-table-fill\");显式传 false 可强制关闭。\n * 纯布局属性,不进 defineTable/definition(virtual/height 例外),setup 期定版不支持运行时切换。 */\n fillHeight: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n});\n\n// ---- 填充模式(fillHeight)---------------------------------------------------\n// 布局上下文:页面布局容器 provide 同名 key,slot 内 TableRender 自动 fill。\n// 字符串 key 跨包约定(常量 PAGE_TABLE_FILL_KEY 已导出,消费方零依赖时按字符串值 provide),\n// setup 期定版,不支持运行时切换(与 virtual/search 同约定)。\nconst pageTableFill = inject<boolean>(PAGE_TABLE_FILL_KEY, false);\nconst fill = props.fillHeight ?? pageTableFill;\n\nconst emit = defineEmits<{\n \"update:page-index\": [pageIndex: number];\n \"update:page-size\": [pageSize: number];\n \"sort-change\": [sort: SortableOptions | undefined];\n \"row-click\": [record: DataRecord, index: number, event: MouseEvent];\n /** 行双击(与 row-click 独立,双击会先后触发 click 两次,属预期) */\n \"row-dblclick\": [record: DataRecord, index: number, event: MouseEvent];\n /** 行右键;不主动 preventDefault */\n \"row-contextmenu\": [record: DataRecord, index: number, event: MouseEvent];\n /** 单元格点击(columnKey 定位列);冒泡并存——cell-click 触发时 row-click 也会触发 */\n \"cell-click\": [record: DataRecord, columnKey: string, index: number, event: MouseEvent];\n \"selection-change\": [rows: DataRecord[]];\n \"update:selected-keys\": [keys: Array<string | number>];\n /** 搜索:FormRender 校验通过后触发;载荷为当前表单值 */\n search: [values: DataRecord];\n /** 重置:FormRender 已重置为 defaults 后触发;载荷为重置后的表单值 */\n reset: [values: DataRecord];\n /** 服务端模式 onLoad 抛错/ rejects 时触发;下一次 load 开始时 error 投影清除 */\n \"load-error\": [error: Error];\n /** 可见列变化(受控回写通知 / v-model:visible-keys) */\n \"update:visible-keys\": [keys: string[]];\n /** 列显隐变化(受控/非受控均触发,供业务持久化;载荷 = 可见列 key 有序数组,columns 原序) */\n \"column-visibility-change\": [keys: string[]];\n /** 行拖拽落位(仅成功 drop 触发,取消路径不发):from/to 为页内索引,rows = 当前页新行序。\n * 静态模式引擎已先行重排,调用方应回写自身数据源;服务端模式需持久化后 reload */\n \"drag-sort\": [payload: TableDragSortPayload];\n}>();\n\ndefineSlots<{\n empty?: () => VNodeChild;\n /** 错误态占位(服务端模式 onLoad 失败时渲染,优先于数据区) */\n error?: (props: { error: Error | undefined; retry: () => void }) => VNodeChild;\n}>();\n\n/** 加载态骨架行数 */\nconst SKELETON_ROWS = [1, 2, 3, 4, 5];\n\n/** 内置渲染器单例:render 工厂按列求值时复用(工厂本身轻量,仅为整洁) */\nconst RENDERS = columnRenders();\n\n// 聚合式直接复用 defineTable 建好的内核;拆分式在本组件 setup 内建内核\n// (TanStack useVueTable 只能在 setup 调用,故不能放进条件分支深处)\nif (props.definition && props.columns && import.meta.env.DEV) {\n console.warn(\"[tu-design] <TableRender> definition 与 columns 同时传入,已按 definition 渲染。\");\n}\nif (props.definition && props.rowSelection && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 rowSelection 请在 defineTable 配置,组件 prop 已忽略。\",\n );\n}\nif (props.definition && props.draggable !== undefined && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 draggable 请在 defineTable 配置,组件 prop 已忽略。\",\n );\n}\n// 显式 any 泛型:Row 的泛型为 in out(不变),拆分式推断出的 DataRecord 具型与\n// definition<any> 逃逸舱口互不相容(TS6 getParentRow 递归比对报 unrelated)\nconst instance: TableRenderDefinition<any> =\n props.definition ??\n useTableRender({\n columns: props.columns ?? [],\n onLoad: props.onLoad,\n data: () => props.data,\n autoLoad: props.autoLoad,\n pageSizeOpts: props.pageSizeOpts,\n rowKey: props.rowKey,\n rowSelection: props.rowSelection,\n search: props.search,\n virtual: props.virtual,\n height: props.height,\n tree: props.tree,\n draggable: props.draggable,\n pageIndex: () => props.pageIndex,\n pageSize: () => props.pageSize,\n sort: () => props.sort,\n selectedKeys: () => props.selectedKeys,\n // 聚合式 columnVisibility 由 definition 自带路径承载;拆分式此处恒空(TS6 下 ?? 右侧收窄坐实)\n defaultVisibleKeys: () => props.defaultVisibleKeys,\n visibleKeys: () => props.visibleKeys,\n });\n// 拆分式已传 rowKey;聚合式由组件回填(选择引擎依赖 rowKey 就绪)\ninstance.setRowKey(props.rowKey);\n\n// ---- 搜索表单(FormRender 联动) --------------------------------------------\n// 与 rowSelection 不同:聚合式下 prop 未被 definition 覆盖时回填引擎(不做聚合式忽略限制);\n// definition 与 prop 二选一,definition 优先,同传 DEV 警告\nif (props.definition && props.search) {\n if (instance.search && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 search 已在 defineTable 配置,组件 prop 已忽略。\",\n );\n } else {\n instance.setSearch(props.search);\n }\n}\n// search 不支持运行时切换(与 FormRender definition/form 同款约定),setup 期定版即可\nconst search = instance.search;\n\n// 列设置触发器的 Tooltip 受控开合(Tooltip 与 Popover 触发器嵌套会吞点击,故手动控制、不嵌套触发器)\nconst settingsTipOpen = ref(false);\n\n// ---- 列显隐(column visibility) ------------------------------------\n// 聚合式(columnVisibility.defaultVisibleKeys 经引擎解析回传)与拆分式 prop 同传 → definition 优先。\n// 引擎是唯一解析点;聚合式受控回填经 setVisibleKeys(normalize 等值守卫防回弹);\n// 拆分式由引擎受控 watch 直接同步(源 = props getter)\nif (\n props.definition &&\n instance.defaultVisibleKeys !== undefined &&\n props.defaultVisibleKeys !== undefined &&\n import.meta.env.DEV\n) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 defaultVisibleKeys 已在 columnVisibility 配置,组件 prop 已忽略。\",\n );\n}\nwatch(\n () => props.visibleKeys,\n (next) => {\n if (props.definition && next !== undefined) instance.setVisibleKeys(next);\n },\n { immediate: true },\n);\n\n/**\n * 当前搜索表单值快照(浅拷贝;无 search 时为空对象)\n * @returns 表单值快照\n */\nfunction searchValues(): DataRecord {\n return search ? { ...search.form.state.values } : {};\n}\n\n/** 搜索:校验已由 FormRender 完成;归位第 1 页重载,分页/排序取数自动携带最新表单值 */\nfunction onSearch() {\n emit(\"search\", searchValues());\n instance.reload(true);\n}\n\n/** 重置:FormRender 已同步重置为 defaults(TanStack reset 为同步 setState),此刻读取即 defaults */\nfunction onReset() {\n emit(\"reset\", searchValues());\n instance.reload(true);\n}\n\nconst columns = computed(() => instance.columns);\nconst rows = computed(() => instance.table.getRowModel().rows);\n/** 内部加载态 ∪ 外部受控加载态 */\nconst loading = computed(() => props.loading === true || instance.loading.value);\nconst showPagination = computed(() => Math.ceil(instance.page.total / instance.page.pageSize) > 1);\n/** 内置分页条开关:showPagination=false 关闭;单页自隐藏仅作用于缺省模式 */\nconst showPaginationBar = computed(() => showPagination.value && props.showPagination !== false);\n/** 内置搜索区开关:配置了 search 且未被 showSearch=false 关闭;列设置触发器不受影响 */\nconst showSearchArea = computed(() => search !== undefined && props.showSearch !== false);\n\n// ---- 错误态(服务端模式 onLoad 失败) ----------------------------------------\n// loading 判定优先;error 优先于正常数据(load 开始时引擎已清除旧错误,loading 期间 error 恒空)\nconst loadError = computed(() => instance.error.value);\nconst showError = computed(() => !loading.value && loadError.value !== undefined);\n\nwatch(loadError, (err) => {\n if (err) emit(\"load-error\", err);\n});\n\nfunction retry() {\n instance.reload();\n}\n\n// ---- 行选择(S 系列) -------------------------------------------------------\nconst selection = computed(() => instance.selection);\nconst selectedKeys = instance.selectedKeys;\nconst hasSelection = computed(() => selection.value.enabled);\n\n// ---- 列显隐(column visibility) -------------------------------------\nconst visibleKeySet = computed(() => new Set(instance.visibleKeys.value));\n/** 可见业务列(columns 原序子集):header/body/骨架/colspan/sticky 全部基于此渲染 */\nconst visibleColumns = computed(() =>\n columns.value.filter((column) => visibleKeySet.value.has(column.key)),\n);\n\n// ---- 表头分组(多级表头) -------------------------------------------\n// 原始列节点树(definition.columnTree 缺省时回退扁平列 = 单级表头)\nconst columnsTree = computed<TableColumnNode<DataRecord>[]>(\n () => (instance.columnTree as TableColumnNode<DataRecord>[]) ?? columns.value,\n);\n\n/** 可见表头树节点:按 visibleKeySet 剪枝后的结构(空分组已被剔除) */\ninterface HeaderNodeView {\n node: TableColumnNode<DataRecord>;\n isGroup: boolean;\n /** DFS 索引路径(如 \"0-1\"):分组单元格 key 的唯一来源,与 title 解耦 */\n path: string;\n children: HeaderNodeView[];\n}\n\n/**\n * 按可见集递归构建表头树:分组子树可见叶子为 0 时整支剔除(与列显隐同口径)。\n * @param nodes - 列节点树(或其子树)\n * @param parentPath - 父级 DFS 索引路径(根为 \"\")\n * @returns 剪枝后的可见表头树\n */\nfunction buildVisibleHeaderTree(\n nodes: TableColumnNode<DataRecord>[],\n parentPath: string,\n): HeaderNodeView[] {\n const views: HeaderNodeView[] = [];\n nodes.forEach((node, index) => {\n const path = parentPath === \"\" ? `${index}` : `${parentPath}-${index}`;\n if (isColumnGroup(node)) {\n const children = buildVisibleHeaderTree(node.children, path);\n if (children.length > 0) views.push({ node, isGroup: true, path, children });\n } else if (visibleKeySet.value.has(node.key)) {\n views.push({ node, isGroup: false, path, children: [] });\n }\n });\n return views;\n}\n\n/** 唯一派生源:可见表头树(maxDepth 与表头矩阵同源于此,杜绝口径漂移) */\nconst visibleHeaderTree = computed(() => buildVisibleHeaderTree(columnsTree.value, \"\"));\n\n/** 表头深度(可见树):无分组时为 1 */\nconst maxDepth = computed(() => {\n const depthOf = (view: HeaderNodeView): number =>\n view.children.length > 0 ? 1 + Math.max(...view.children.map(depthOf)) : 1;\n return visibleHeaderTree.value.length > 0 ? Math.max(...visibleHeaderTree.value.map(depthOf)) : 1;\n});\n\n/** 表头单元格:分组跨列、叶子下沉贴底 */\ninterface HeaderCell {\n node: TableColumnNode<DataRecord>;\n /** Vue 列表 key:叶子用列 key,分组用 DFS 路径(唯一稳定) */\n key: string;\n path: string;\n depth: number;\n colSpan: number;\n rowSpan: number;\n isGroup: boolean;\n /** 该单元格覆盖的可见叶子列 key(分组为子树全部,叶子为自身) */\n leafKeys: string[];\n}\n\n/** 表头矩阵:行 × 单元格(叶子 rowSpan = maxDepth - depth,分组 colSpan = 子树可见叶子数) */\nconst headerRows = computed<HeaderCell[][]>(() => {\n const rows: HeaderCell[][] = Array.from({ length: maxDepth.value }, () => []);\n const collectLeaves = (view: HeaderNodeView): string[] =>\n view.isGroup\n ? view.children.flatMap(collectLeaves)\n : [(view.node as TableColumnOptions<DataRecord>).key];\n\n const walk = (views: HeaderNodeView[], depth: number) => {\n for (const view of views) {\n const leafKeys = collectLeaves(view);\n if (view.isGroup) {\n rows[depth]!.push({\n node: view.node,\n key: `g:${view.path}`,\n path: view.path,\n depth,\n colSpan: leafKeys.length,\n rowSpan: 1,\n isGroup: true,\n leafKeys,\n });\n } else {\n rows[depth]!.push({\n node: view.node,\n key: (view.node as TableColumnOptions<DataRecord>).key,\n path: view.path,\n depth,\n colSpan: 1,\n rowSpan: maxDepth.value - depth,\n isGroup: false,\n leafKeys,\n });\n }\n walk(view.children, depth + 1);\n }\n };\n walk(visibleHeaderTree.value, 0);\n return rows;\n});\n\n/** 列设置触发器/面板开关(默认 true);false 时不渲染 UI,受控 API 不受影响 */\nconst showColumnSettings = computed(() => props.columnSettings ?? true);\n\nfunction isColumnVisible(key: string): boolean {\n return visibleKeySet.value.has(key);\n}\n\n/**\n * 最少一列:唯一可见列不可隐藏\n * @param key - 列 key\n * @returns 是否允许隐藏该列\n */\nfunction canHideColumn(key: string): boolean {\n return !(instance.visibleKeys.value.length <= 1 && visibleKeySet.value.has(key));\n}\n\nfunction toggleColumnVisible(key: string) {\n if (!canHideColumn(key)) return;\n instance.setVisibleKeys(\n isColumnVisible(key)\n ? instance.visibleKeys.value.filter((k) => k !== key)\n : [...instance.visibleKeys.value, key],\n );\n}\n\nconst allColumnsVisible = computed(\n () => columns.value.length > 0 && visibleColumns.value.length === columns.value.length,\n);\n\nfunction selectAllColumns() {\n if (allColumnsVisible.value) return;\n instance.setVisibleKeys(columns.value.map((column) => column.key));\n}\n\nfunction resetColumns() {\n // 恢复 defaultVisibleKeys;未配置 = 全部可见\n instance.setVisibleKeys(instance.defaultVisibleKeys ?? columns.value.map((column) => column.key));\n}\n\n// ---- 列设置面板:树形行 ------------------------------------------------\n/** 面板行(全树扁平化,避免模板递归):分组行为父级三态,叶子行为勾选项 */\ninterface PanelRow {\n node: TableColumnNode<DataRecord>;\n depth: number;\n isGroup: boolean;\n /** 该节点覆盖的叶子 key(分组为子树全部) */\n leafKeys: string[];\n path: string;\n key: string;\n}\n\n/** 面板行派生:以原始列节点树(非可见剪枝)为准,保证隐藏后仍可恢复 */\nconst panelRows = computed<PanelRow[]>(() => {\n const rows: PanelRow[] = [];\n const collectLeaves = (node: TableColumnNode<DataRecord>): string[] =>\n isColumnGroup(node) ? node.children.flatMap(collectLeaves) : [node.key];\n const walk = (nodes: TableColumnNode<DataRecord>[], depth: number, parentPath: string) => {\n nodes.forEach((node, index) => {\n const path = parentPath === \"\" ? `${index}` : `${parentPath}-${index}`;\n const isGroup = isColumnGroup(node);\n rows.push({\n node,\n depth,\n isGroup,\n leafKeys: collectLeaves(node),\n path,\n key: isGroup ? `g:${path}` : node.key,\n });\n if (isGroup) walk(node.children, depth + 1, path);\n });\n };\n walk(columnsTree.value, 0, \"\");\n return rows;\n});\n\n/**\n * 分组勾选三态:全部可见 = true,部分可见 = \"indeterminate\",全隐 = false\n * @param row - 面板分组行\n * @returns 该分组的三态勾选值\n */\nfunction groupCheckedState(row: PanelRow): boolean | \"indeterminate\" {\n const visibleCount = row.leafKeys.filter((key) => visibleKeySet.value.has(key)).length;\n if (visibleCount === 0) return false;\n if (visibleCount === row.leafKeys.length) return true;\n return \"indeterminate\";\n}\n\n/**\n * 分组批量显隐(最少一列恒按叶子口径):\n * 隐藏整组会导致 0 列可见时,保留该组最后一枚可见叶子(父级呈 indeterminate)。\n * @param row - 面板分组行\n */\nfunction toggleGroupVisible(row: PanelRow) {\n const leafSet = new Set(row.leafKeys);\n const allVisible = row.leafKeys.every((key) => visibleKeySet.value.has(key));\n if (!allVisible) {\n // 显示整组:与当前可见集按 columns 原序合并(normalize 会纠正顺序)\n instance.setVisibleKeys(\n columns.value\n .map((column) => column.key)\n .filter((key) => visibleKeySet.value.has(key) || leafSet.has(key)),\n );\n return;\n }\n const remaining = instance.visibleKeys.value.filter((key) => !leafSet.has(key));\n if (remaining.length === 0) {\n // 钳制:不得清空可见集,保留最后一枚叶子\n instance.setVisibleKeys([row.leafKeys[row.leafKeys.length - 1]!]);\n return;\n }\n instance.setVisibleKeys(remaining);\n}\n\n/**\n * 面板行点击(分组批量显隐 / 叶子单列切换)\n * @param row - 面板行(分组或叶子)\n */\nfunction onPanelRowClick(row: PanelRow) {\n if (row.isGroup) toggleGroupVisible(row);\n else toggleColumnVisible(row.key);\n}\n\n// 受控/非受控均通知:统一投影变化 → 双事件(载荷 = columns 原序可见 key)\nwatch(instance.visibleKeys, (keys) => {\n emit(\"update:visible-keys\", [...keys]);\n emit(\"column-visibility-change\", [...keys]);\n});\n\n/** 总列数 = 可见业务列 + 选择列(空态 colspan 与骨架行) */\nconst columnCount = computed(\n () => visibleColumns.value.length + (hasSelection.value ? 1 : 0) + (dragEnabled.value ? 1 : 0),\n);\n\n// ---- 固定列(sticky) --------------------------------------------------------\n\n// DEV 校验:sticky 偏移只能从数字 width(px)推算,否则降级普通列(columns setup 期定版,只查一次)\nfor (const column of columns.value) {\n if (column.fixed !== undefined && typeof column.width !== \"number\") {\n console.warn(\n `[tu-design] <TableRender> fixed 列 \"${column.key}\" 需要数字 width,已忽略 fixed。`,\n );\n }\n}\n\n// DEV 校验(一次性):分组节点误配 key/sortable/fixed/width、空 children(列节点树定版)\nif (import.meta.env.DEV) {\n const validateNodes = (nodes: TableColumnNode<DataRecord>[], depth: number) => {\n for (const node of nodes) {\n if (isColumnGroup(node)) {\n if (\"key\" in node && (node as { key?: unknown }).key !== undefined) {\n console.warn(\n \"[tu-design] <TableRender> 分组节点不应配置 key(分组不是数据列),已忽略。\",\n );\n }\n if ((node as { sortable?: unknown }).sortable !== undefined) {\n console.warn(\n `[tu-design] <TableRender> 分组「${node.title}」不支持 sortable(仅叶子列可排序),已忽略。`,\n );\n }\n if ((node as { fixed?: unknown }).fixed !== undefined) {\n console.warn(\n `[tu-design] <TableRender> 分组「${node.title}」不支持 fixed(请配置到叶子列),已忽略。`,\n );\n }\n if (node.children.length === 0) {\n console.warn(`[tu-design] <TableRender> 分组「${node.title}」children 为空,将被忽略。`);\n }\n validateNodes(node.children, depth + 1);\n } else if (\"children\" in node && (node as { children?: unknown }).children !== undefined) {\n console.warn(\n `[tu-design] <TableRender> 叶子列 \"${node.key}\" 不应配置 children,已按叶子渲染。`,\n );\n }\n }\n };\n validateNodes(columnsTree.value, 0);\n}\n\n// DEV 提示(一次性,columns setup 期定版):多列宽表全列无数字 width 时,\n// min-width 横滚不可达 —— 宽表请为列声明数字 width(px)。\nif (columns.value.length >= 10 && !columns.value.some((c) => typeof c.width === \"number\")) {\n console.warn(\n `[tu-design] <TableRender> ${columns.value.length} 列均无数字 width,` +\n `窄容器下不会出现横向滚动;宽表请为列声明数字 width(px)。`,\n );\n}\n\n/** sticky 单元格映射(纯渲染层 computed,不进 TanStack pinning state):\n * 选择列视作最左 fixed 列参与累计(offset 0);fixed-left 按列序累加,\n * fixed-right 从最右列反向累计。edge = 该 sticky 组朝滚动方向的交界列(加分隔边框)。\n * 全部基于**可见集**:sticky 组因隐藏变空则无该组输出(不输出边框)。\n */\nconst stickyOf = computed<StickyMap>(() => {\n const map: StickyMap = new Map();\n // instance.columns 是联合数组(聚合式 any / 拆分式 DataRecord),联合上的 filter\n // 类型谓词重载解析不可靠,故 map 提取时以断言收窄 width(条件已含 typeof 守卫)\n const lefts = visibleColumns.value\n .filter((column) => column.fixed === \"left\" && typeof column.width === \"number\")\n .map((column) => ({ key: column.key, width: column.width as number }));\n const rights = visibleColumns.value\n .filter((column) => column.fixed === \"right\" && typeof column.width === \"number\")\n .map((column) => ({ key: column.key, width: column.width as number }));\n\n let acc = 0;\n if (hasSelection.value) {\n map.set(SELECTION_CELL, {\n side: \"left\",\n offset: 0,\n edge: lefts.length === 0 && !dragEnabled.value,\n });\n acc = selection.value.width;\n }\n // 把手列紧随选择列(选择列保持 offset 0 视觉锚点),同视作最左固定列参与累计\n if (dragEnabled.value) {\n map.set(DRAG_CELL, { side: \"left\", offset: acc, edge: lefts.length === 0 });\n acc += dragWidth;\n }\n lefts.forEach((left, index) => {\n map.set(left.key, { side: \"left\", offset: acc, edge: index === lefts.length - 1 });\n acc += left.width;\n });\n\n let racc = 0;\n for (let index = rights.length - 1; index >= 0; index--) {\n const right = rights[index]!;\n map.set(right.key, { side: \"right\", offset: racc, edge: index === 0 });\n racc += right.width;\n }\n return map;\n});\n\n// ---- 表格 min-width(列宽硬约束) ----------------------------------------\n// 可见业务列数字 width 之和(含选择列)作为 <table> min-width 下限:\n// 容器不足 → 表格被顶到 Σwidth,auto 布局下列渲染宽度 == 指定宽度,stickyOf 偏移精确成立,\n// 滚动区 overflow-x-auto 横滚;容器充足 → 表格仍 100% 拉伸(有宽列可能被拉伸,\n// sticky 偏移按指定值累计的漂移为既有限制)。\n// 字符串 width 仅渲染提示值,不参与求和(与 stickyOf 口径一致);和为 0 不挂 style(零回归)。\nconst tableMinWidth = computed(() => {\n let sum = 0;\n for (const column of visibleColumns.value) {\n if (typeof column.width === \"number\" && column.width > 0) sum += column.width;\n }\n if (hasSelection.value && selection.value.width > 0) sum += selection.value.width;\n if (dragEnabled.value && dragWidth > 0) sum += dragWidth;\n return sum;\n});\n\n/** 列宽 inline style 值:数字补 px 单位——Vue :style 不自动加单位,\n * 裸数字会被浏览器当非法 CSS 值丢弃,列宽即失效;字符串视为已带单位原样输出。\n * @param width - 列宽配置\n * @returns 可直接用于 :style 的 CSS 宽度值;未配置返回 undefined\n */\nfunction widthOf(width?: number | string) {\n return typeof width === \"number\" ? `${width}px` : width;\n}\n\n// ---- 分组表头单元格 ------------------------------------------------\n\n/** 混合固定组警告去重(同名分组仅警告一次) */\nconst warnedMixedFixedGroups = new Set<string>();\n\n/**\n * 分组单元格的 sticky 样式:子树可见叶子同侧且连续固定时整格 sticky,\n * 偏移取首个可见叶子;混合侧 → 返回 undefined(降级普通格)并 DEV 警告一次。\n * @param cell - 表头单元格(分组)\n * @returns 分组单元格的 sticky inline style;不适用时返回 undefined\n */\nfunction groupStickyStyle(cell: HeaderCell) {\n const sides = new Set(\n cell.leafKeys\n .map((key) => columns.value.find((column) => column.key === key)?.fixed)\n .filter((side): side is \"left\" | \"right\" => side !== undefined),\n );\n // 混合侧(同时含 left 与 right):单元格无法部分固定 → 降级普通格\n if (sides.size > 1) {\n if (!warnedMixedFixedGroups.has(cell.key)) {\n warnedMixedFixedGroups.add(cell.key);\n if (import.meta.env.DEV) {\n console.warn(\n `[tu-design] <TableRender> 分组「${(cell.node as TableColumnGroupOptions).title}」内固定方向混合,已降级为普通表头格。`,\n );\n }\n }\n return undefined;\n }\n if (sides.size === 0) return undefined;\n // 组内固定列不连续(中间夹普通列)时,分组格跨过非固定列会遮挡滚动内容 → 同样降级\n const fixedLeaves = cell.leafKeys.filter((key) => {\n const column = columns.value.find((c) => c.key === key);\n return column?.fixed !== undefined && typeof column.width === \"number\";\n });\n if (fixedLeaves.length !== cell.leafKeys.length) return undefined;\n const side = [...sides][0]!;\n const first = stickyOf.value.get(cell.leafKeys[0]!);\n if (!first) return undefined;\n return {\n position: \"sticky\" as const,\n [side]: `${first.offset}px`,\n zIndex: \"var(--z-sticky-head)\",\n };\n}\n\n/**\n * 表头行的行级样式:sticky 模式下逐行累积 top 偏移(多行表头),避免顶边重叠。\n * @param rowIndex - 表头行下标\n * @returns 行级 inline style;非 sticky 模式返回 undefined\n */\nfunction headerRowStyle(rowIndex: number) {\n if (!theadSticky) return undefined;\n return { top: `${rowTop.value[rowIndex] ?? rowIndex * HEADER_ROW_FALLBACK}px` };\n}\n\n/**\n * 表头单元格的视觉规约:分组格与其后单元格之间加竖向分隔线。\n *\n * 横向底边线沿用既有机制(非 sticky 走 thead 行级 `[&_tr]:border-b`;\n * sticky 走 `theadThClass` 的 `border-b`),此处**不重复绘制**;\n * 单级表头(无分组)直接返回空,保证扁平列 DOM 零变化。\n * @param cell - 表头单元格\n * @param isLastInRow - 是否为本行最后一个单元格\n * @returns class 列表\n */\nfunction headerCellClass(cell: HeaderCell, isLastInRow: boolean) {\n if (maxDepth.value === 1) return [];\n return cell.isGroup && !isLastInRow ? [\"border-r border-border\"] : [];\n}\n\n/**\n * 分组单元格水平对齐(分组无 align 以外的能力)\n * @param cell - 表头单元格\n * @returns 对齐值,默认居中\n */\nfunction headerCellAlign(cell: HeaderCell) {\n return cell.isGroup\n ? ((cell.node as TableColumnGroupOptions).align ?? \"center\")\n : ((cell.node as TableColumnOptions).align ?? \"center\");\n}\n\n/** 分组无需排序能力标记(sortable 仅叶子生效,对分组 sortable 警告) */\n\n/** 表头全选三态:本页可选行与选中集求交派生(TanStack getter 追踪不稳,自算) */\nconst selectableKeys = computed(() =>\n rows.value.filter((row) => row.getCanSelect()).map((row) => rowKeyOf(row.original, row.index)),\n);\nconst headerChecked = computed(\n () =>\n hasSelection.value &&\n selection.value.type === \"checkbox\" &&\n selectableKeys.value.length > 0 &&\n selectableKeys.value.every((key) => selectedKeys.value.has(key)),\n);\nconst headerIndeterminate = computed(\n () =>\n hasSelection.value &&\n !headerChecked.value &&\n selectableKeys.value.some((key) => selectedKeys.value.has(key)),\n);\n\nfunction onHeaderSelect(checked: boolean) {\n instance.table.toggleAllPageRowsSelected(checked);\n}\n\n/**\n * 行选择控件切换;radio 不可取消由引擎守卫,不选中态点击传 checked=true\n * @param line - 行数据(含行 key)\n * @param checked - 目标选中态\n */\nfunction onRowSelect(line: { key: string }, checked: boolean) {\n instance.toggleRowSelected(line.key, checked);\n}\n\n// 选中集变化 → 对外事件:排序/翻页不改变选中集,故不会误发\nwatch(instance.selectedKeys, (keys) => {\n emit(\"selection-change\", [...selection.value.value]);\n emit(\"update:selected-keys\", [...keys]);\n});\n\n/** 行 → 单元格值矩阵:render > formatter > record[key] */\nconst body = computed<TableBodyLine[]>(() => {\n // 渲染器工厂按列求值一次(而非每单元格),避免用户工厂内的重分配被放大\n const renderFns = new Map(\n columns.value.filter((c) => c.render).map((c) => [c, c.render!(RENDERS)]),\n );\n return rows.value.map((row) => ({\n /** TanStack Row:树形渲染读 depth / getCanExpand / getIsExpanded / toggleExpanded */\n row,\n key: rowKeyOf(row.original, row.index),\n index: row.index,\n record: row.original,\n /** 行级可选过滤:selectable 谓词交由引擎 enableRowSelection 判定 */\n canSelect: row.getCanSelect(),\n // 可见列的值矩阵(列显隐只裁剪列;状态不受影响)\n cells: visibleColumns.value.map((column): VNodeChild => {\n const render = renderFns.get(column);\n if (render) return render(row.original, row.index, column);\n if (column.formatter) return column.formatter(row.original) as VNodeChild;\n return String(row.original[column.key] ?? \"\");\n }),\n }));\n});\n\n// ---- 树形数据(T 系列) ------------------------------------------------------\n// 引擎是唯一解析点(无效配置已 warn 并忽略,回传 undefined);tree 为 undefined 时不渲染缩进与 caret\nconst tree = instance.tree;\nconst treeIndent = tree?.indentSize ?? 16;\n\nlet missingRowKeyWarned = false;\n\n/**\n * 行主键:rowKey 字段缺失时以行索引兜底\n * @param record - 行记录\n * @param index - 行索引(兜底来源)\n * @returns 稳定的行主键字符串\n */\nfunction rowKeyOf(record: DataRecord, index: number): string {\n const value = record[props.rowKey];\n if (value === undefined || value === null) {\n if (!missingRowKeyWarned && import.meta.env.DEV) {\n missingRowKeyWarned = true;\n console.warn(\n `[tu-design] <TableRender> 部分记录缺少 rowKey 字段 \"${props.rowKey}\",已退化为按行索引标识。`,\n );\n }\n return `index-${index}`;\n }\n return String(value);\n}\n\n// ---- 虚拟滚动 / 填充模式 ------------------------------------------------------\n// definition 优先于 prop(配置定版,不支持运行时切换)\nconst virtualRaw = instance.virtual ?? props.virtual;\nconst heightRaw = instance.height ?? props.height;\n// fill 模式自带真实滚动盒(flex-1 实测高度),virtual 无需显式 height\nif (virtualRaw === true && heightRaw === undefined && !fill) {\n console.warn(\"[tu-design] <TableRender> virtual 需要配置 height,已降级普通渲染。\");\n}\nconst virtualEnabled = virtualRaw === true && (heightRaw !== undefined || fill);\n\n// ---- 行拖拽排序(draggable) --------------------------------------------------\n// 引擎是唯一配置解析点(tree/virtual 冲突已 warn 并忽略);此处兜底聚合式 definition\n// 与组件 prop virtual 同传的边界(引擎解析时看不到 prop)。配置 setup 期定版。\nconst dragConfig = instance.draggable;\nconst dragEnabled = computed(() => dragConfig !== undefined && !virtualEnabled);\nconst dragWidth = dragConfig?.width ?? 32;\nconst drag = useRowDrag();\n\n// rowKey 记录级守卫:当前页任一记录缺 rowKey 字段 → 禁用拖拽(索引兜底态下行身份不稳定)\nconst dragKeysValid = computed(\n () => !dragEnabled.value || body.value.every((line) => line.record[props.rowKey] != null),\n);\nlet dragRowKeyWarned = false;\nwatch(\n dragKeysValid,\n (valid) => {\n if (!valid && !dragRowKeyWarned && import.meta.env.DEV) {\n dragRowKeyWarned = true;\n console.warn(\n `[tu-design] <TableRender> 部分记录缺少 rowKey 字段 \"${props.rowKey}\",已禁用行拖拽排序。`,\n );\n }\n },\n { immediate: true },\n);\n\n/**\n * 本行把手禁用判定:排序激活(动态守卫,取消排序恢复)/ rowKey 缺失 / 行级谓词 false\n * @param line - 行数据\n * @returns 是否禁用本行把手\n */\nfunction rowDragDisabled(line: TableBodyLine): boolean {\n if (instance.sort.value !== undefined || !dragKeysValid.value) return true;\n return dragConfig?.draggable ? !dragConfig.draggable(line.record) : false;\n}\n\n// ---- 实时让位预览(组件层 overlay:引擎零改动、预览期间零事件) ----------------\n// 只有被拖行在预览序中移动,其他行相对序恒定 → 让位后被拖行恰落在光标下,\n// 后续 dragover 命中自身被忽略,天然不振荡(无需几何测量)。\nconst previewKeys = ref<string[] | undefined>(undefined);\n\n/** 显示序:拖拽中按预览序重排(失效 key 过滤、新增行追加,防中途外部 data 变更);平时即引擎序 */\nconst displayBody = computed<TableBodyLine[]>(() => {\n const keys = previewKeys.value;\n if (!keys) return body.value;\n const byKey = new Map(body.value.map((line) => [line.key, line]));\n const ordered: TableBodyLine[] = [];\n for (const key of keys) {\n const line = byKey.get(key);\n if (line) {\n ordered.push(line);\n byKey.delete(key);\n }\n }\n return ordered.concat([...byKey.values()]);\n});\n\n/** 离屏整行快照(仅真实浏览器 dataTransfer 存在时创建);drop/dragend 时移除 */\nlet dragSnapshot: HTMLElement | undefined;\n\nfunction removeDragSnapshot() {\n dragSnapshot?.remove();\n dragSnapshot = undefined;\n}\n\n/**\n * 起拖(把手 dragstart):禁用行不接收;离屏克隆整行作为拖拽快照(幽灵影 = 带边框整行截图)\n * @param line - 源行数据\n * @param event - 原生 dragstart 事件\n */\nfunction onRowDragStart(line: TableBodyLine, event: DragEvent) {\n if (rowDragDisabled(line)) return;\n const tr = (event.target as HTMLElement | null)?.closest?.(\"tr\");\n let image: { el: Element; offsetX: number; offsetY: number } | undefined;\n if (event.dataTransfer && tr) {\n const rect = tr.getBoundingClientRect();\n dragSnapshot = createRowSnapshot(tr);\n image = {\n el: dragSnapshot,\n offsetX: event.clientX - rect.left,\n offsetY: event.clientY - rect.top,\n };\n }\n drag.start(line.key, event, image);\n}\n\n/**\n * 悬停让位:把被拖行移到悬停行在当前预览序中的位置(仅被拖行移动)\n * @param line - 悬停行数据\n * @param event - 原生 dragover 事件\n */\nfunction onRowDragOver(line: TableBodyLine, event: DragEvent) {\n if (!drag.over(line.key, event)) return;\n const dragging = drag.draggingKey.value!;\n const keys = [...(previewKeys.value ?? body.value.map((item) => item.key))];\n const fromIndex = keys.indexOf(dragging);\n const toIndex = keys.indexOf(line.key);\n if (fromIndex < 0 || toIndex < 0 || fromIndex === toIndex) return;\n keys.splice(fromIndex, 1);\n keys.splice(toIndex, 0, dragging);\n previewKeys.value = keys;\n}\n\n/**\n * 成功落位:提交预览序。多跳预览的复合结果 ≡ 单次「源行原位移 → 最终预览位」,\n * 故 from = 原 body 索引、to = 预览序中被拖行最终索引,直接复用引擎 reorderRows。\n * @param line - 落位行数据\n * @param event - 原生 drop 事件\n */\nfunction onRowDrop(line: TableBodyLine, event: DragEvent) {\n const preview = previewKeys.value;\n const result = drag.drop(line.key, event);\n previewKeys.value = undefined;\n removeDragSnapshot();\n if (!result) return;\n const from = body.value.findIndex((item) => item.key === result.fromKey);\n // 有预览:提交最终预览位(含落在自身占位);无预览:落在自身 = 无操作(from === to 引擎守卫)\n const to = preview\n ? preview.indexOf(result.fromKey)\n : body.value.findIndex((item) => item.key === result.toKey);\n if (from < 0 || to < 0) return;\n const payload = instance.reorderRows(from, to);\n if (payload) emit(\"drag-sort\", payload);\n}\n\n/** 拖拽结束(含取消路径):清理状态 + 预览序弹回引擎原序 + 移除离屏快照 */\nfunction onRowDragEnd() {\n drag.end();\n previewKeys.value = undefined;\n removeDragSnapshot();\n}\n\nconst scrollHeight = computed(() => (typeof heightRaw === \"number\" ? `${heightRaw}px` : heightRaw));\n/** 表头 sticky 仅在组件内存在真实纵向滚动盒时生效(fill / virtual),普通模式不挂载,行为不变 */\nconst theadSticky = fill || virtualEnabled;\n/** 滚动区样式:virtual 用固定 height;fill 交给 flex 分配(二者同传以 fill 优先) */\nconst scrollStyle = computed(() => {\n if (fill || !virtualEnabled) return undefined;\n return { height: scrollHeight.value, overflowY: \"auto\" as const };\n});\n/** sticky 表头普通列类:不透明底防行内容透出;分隔线归 th(thead 行级 border 会随行滚走);\n * z-20 高于表体 fixed 列(--z-sticky: 10),纵向滚动行滑过表头时不穿透;\n * 表头 fixed 列的 z 由 stickyStyle inline style(var(--z-sticky-head))提供,inline 优先级天然覆盖此处 class */\nconst theadThClass = theadSticky ? \"sticky top-0 z-20 border-b border-border bg-background\" : \"\";\n/** sticky 态 table 改分离边框:preflight 为 border-collapse: collapse,\n * 折叠边框几何归属 table,Chrome 下 sticky th 粘住后自身 border-b 渲染丢失;\n * separate + spacing-0 恢复单元格边框。普通模式保持 collapse,零回归。 */\nconst tableClass = theadSticky ? \"border-separate border-spacing-0\" : \"\";\n\nconst scrollEl = ref<HTMLElement | null>(null);\nconst theadEl = ref<HTMLElement | null>(null);\n/** 滚动容器内 thead 占据的前缀高度(scrollMargin);表头内容静态,挂载后测量一次 */\nconst theadOffset = ref(0);\n\n// ---- 多行表头测量 --------------------------------------------------\n/** 表头行元素(模板 ref 收集,逐行求高度) */\nconst headerRowEls = ref<(HTMLElement | null)[]>([]);\n/** 各行顶部偏移(前缀和):多行 sticky 表头逐行钉住,避免顶边重叠 */\nconst rowTop = ref<number[]>([]);\n/** 行高兜底:表头行 class 为 h-10(2.5rem = 40px);happy-dom 下 offsetHeight 恒 0 */\nconst HEADER_ROW_FALLBACK = 40;\n\n/**\n * 测量所有表头行高度并派生行顶偏移与 thead 总高(唯一测量源)。\n *\n * 两处口径有意区分:\n * - `rowTop`(多行 sticky 逐行 top)用兜底 h-10(40px)——测量不可用时避免表头行重叠;\n * - `theadOffset`(virtual 的 scrollMargin)用**实测原值**,与既有行为一致\n * (happy-dom 无布局 → 0;真实浏览器 → 真实高度)。\n */\nfunction measureHeaderRows() {\n const raw = headerRowEls.value.map((el) => el?.offsetHeight ?? 0);\n const heights = raw.map((height) => height || HEADER_ROW_FALLBACK);\n rowTop.value = heights.map((_, index) => heights.slice(0, index).reduce((a, h) => a + h, 0));\n if (virtualEnabled) theadOffset.value = raw.reduce((a, h) => a + h, 0);\n}\n\n// 仅 virtual: true 且 height 就绪时创建(配置 setup 期定版,顶层条件分支可安全注册生命周期)\nconst virtualizerRef = virtualEnabled\n ? useVirtualizer(\n computed(() => ({\n count: rows.value.length, // 翻页/重载后行窗口变化 → options 更新(setOptions 自动生效)\n getScrollElement: () => scrollEl.value,\n estimateSize: () => 40,\n overscan: 8,\n getItemKey: (index: number) => rowKeyOf(rows.value[index]!, index), // rowKey 作为虚拟行 key\n scrollMargin: theadOffset.value, // thead 在滚动容器内的 offset 前缀\n })),\n )\n : null;\n\nonMounted(measureHeaderRows);\n// 可见表头树变化(列显隐)→ 行数/单元格可能变化,DOM 更新后重测\nwatch(headerRows, () => void nextTick(measureHeaderRows), { flush: \"post\" });\n\nconst virtualRows = computed(() => (virtualizerRef ? virtualizerRef.value.getVirtualItems() : []));\nconst virtualTotal = computed(() => (virtualizerRef ? virtualizerRef.value.getTotalSize() : 0));\n/** 窗口行 + 对应全量行数据(cells 矩阵已由 body computed 缓存,虚拟化只裁剪 DOM 节点) */\nconst virtualLines = computed(() =>\n virtualRows.value.map((row) => ({ row, line: body.value[row.index]! })),\n);\nconst padTop = computed(() => virtualRows.value[0]?.start ?? 0);\nconst padBottom = computed(() => {\n const items = virtualRows.value;\n return items.length === 0 ? 0 : Math.max(0, virtualTotal.value - items[items.length - 1]!.end);\n});\n\n/** 行高动态测量:measureElement 读 data-index 把实测高度写回(行内容高度可变,不假设固定行高)。\n * 行组件为函数 ref,拿到的是组件实例,需经 $el 取真实 tr。\n * @param node - 函数 ref 收到的行元素或组件实例\n */\nfunction measureRow(node: Element | ComponentPublicInstance | null) {\n const el = node instanceof Element ? node : (node?.$el as Element | undefined);\n if (el instanceof Element) virtualizerRef?.value.measureElement(el);\n}\n\n/**\n * aria-sort 仅在该列当前被排序时标注\n * @param column - 列配置\n * @returns 当前排序方向对应的 aria-sort 值;未排序返回 undefined\n */\nfunction ariaSort(column: TableColumnOptions): \"ascending\" | \"descending\" | undefined {\n if (instance.sort.value?.key !== column.key) return undefined;\n return instance.sort.value.direction === \"asc\" ? \"ascending\" : \"descending\";\n}\n\nfunction sortMark(column: TableColumnOptions): string {\n const direction = instance.sort.value?.key === column.key ? instance.sort.value.direction : \"\";\n return direction === \"asc\" ? \"↑\" : direction === \"desc\" ? \"↓\" : \"\";\n}\n\nfunction onSort(key: string) {\n instance.toggleSort(key);\n emit(\"sort-change\", instance.sort.value);\n}\n\nfunction onPageIndex(pageIndex: number) {\n instance.setPageIndex(pageIndex);\n lastEmittedPage.pageIndex = pageIndex;\n emit(\"update:page-index\", pageIndex);\n}\n\nfunction onPageSize(pageSize: number) {\n instance.setPageSize(pageSize);\n lastEmittedPage.pageSize = pageSize;\n emit(\"update:page-size\", pageSize);\n}\n\n// ---- 受控模式(v-model):page 投影 → update:* 通知 ---------------------------\n// 仅 page-index/page-size 至少一方受控时安装;lastEmittedPage 去重——\n// 动作路径已 emit 过的值不再重复发(受控回写/内部归位只通知「未通知过的」变化)\nconst pageControlled = () => props.pageIndex !== undefined || props.pageSize !== undefined;\nconst lastEmittedPage = {\n pageIndex: undefined as number | undefined,\n pageSize: undefined as number | undefined,\n};\n\nif (pageControlled()) {\n watch(\n () => [instance.page.pageIndex, instance.page.pageSize] as const,\n ([pageIndex, pageSize]) => {\n if (pageIndex !== lastEmittedPage.pageIndex) {\n lastEmittedPage.pageIndex = pageIndex;\n emit(\"update:page-index\", pageIndex);\n }\n if (pageSize !== lastEmittedPage.pageSize) {\n lastEmittedPage.pageSize = pageSize;\n emit(\"update:page-size\", pageSize);\n }\n },\n );\n}\n\nfunction onRowClick(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-click\", record, index, event);\n}\n\nfunction onRowDblclick(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-dblclick\", record, index, event);\n}\n\nfunction onRowContextmenu(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-contextmenu\", record, index, event);\n}\n\nfunction onCellClick(record: DataRecord, columnKey: string, index: number, event: MouseEvent) {\n emit(\"cell-click\", record, columnKey, index, event);\n}\n\ndefineExpose({\n table: instance.table,\n page: instance.page,\n // 不暴露 sort:与受控 sort prop 同名,实例上互相遮蔽(TS6 起 h()/mount 类型检查拒绝该组件);\n // 排序状态经 sort-change 事件与 definition.sort 投影获取\n loading: instance.loading,\n error: instance.error,\n visibleKeys: instance.visibleKeys,\n setVisibleKeys: instance.setVisibleKeys,\n reload: instance.reload,\n toggleSort: onSort,\n setPageIndex: onPageIndex,\n setPageSize: onPageSize,\n selection: instance.selection,\n selectedKeys: instance.selectedKeys,\n setSelection: instance.setSelection,\n clearSelection: instance.clearSelection,\n});\n</script>\n\n<template>\n <div :class=\"cn('w-full', fill && 'flex h-full min-h-0 flex-col', $attrs.class)\">\n <!-- 搜索区 + 列设置触发器:同行右对齐(items-end);无搜索时触发器位于表格上方(showSearch=false 关闭搜索区) -->\n <div\n v-if=\"showSearchArea || showColumnSettings\"\n :class=\"cn('mb-2 flex items-end justify-between gap-2', fill && 'shrink-0')\"\n >\n <FormRender\n v-if=\"showSearchArea\"\n class=\"min-w-0 flex-1\"\n :definition=\"search\"\n :searchable=\"search?.actions ? undefined : true\"\n @search=\"onSearch\"\n @reset=\"onReset\"\n />\n\n <!-- 列设置:Popover 面板(最少一列 / 重置 / 不含选择列);\n 触发钮 Tooltip 手动受控开合(Tooltip 与 Popover 触发器嵌套会吞点击,故并列渲染、不走 hover 自动触发) -->\n <template v-if=\"showColumnSettings\">\n <Popover align=\"end\" content-class=\"w-56 p-0\">\n <Button\n variant=\"ghost\"\n size=\"icon\"\n aria-label=\"列设置\"\n aria-haspopup=\"true\"\n @pointerenter=\"settingsTipOpen = true\"\n @pointerleave=\"settingsTipOpen = false\"\n >\n <!-- lucide Settings2(内联 SVG,跟随项目图标现状) -->\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M20 7h-9\" />\n <path d=\"M14 17H5\" />\n <circle cx=\"17\" cy=\"17\" r=\"3\" />\n <circle cx=\"7\" cy=\"7\" r=\"3\" />\n </svg>\n </Button>\n <template #content>\n <div class=\"flex items-center justify-end gap-3 px-3 py-2\">\n <button\n type=\"button\"\n class=\"text-muted-foreground hover:text-foreground cursor-pointer text-xs disabled:cursor-not-allowed disabled:opacity-50\"\n :disabled=\"allColumnsVisible\"\n @click=\"selectAllColumns\"\n >\n 全选\n </button>\n <button\n type=\"button\"\n class=\"text-muted-foreground hover:text-foreground cursor-pointer text-xs\"\n @click=\"resetColumns\"\n >\n 重置\n </button>\n </div>\n <Separator />\n <div class=\"max-h-64 overflow-y-auto py-1\">\n <div\n v-for=\"row in panelRows\"\n :key=\"row.key\"\n data-column-item\n :data-column-key=\"row.isGroup ? undefined : row.key\"\n :data-column-group=\"row.isGroup ? row.path : undefined\"\n class=\"hover:bg-accent/50 flex h-8 cursor-pointer items-center gap-2 px-3\"\n :style=\"{ paddingLeft: `${12 + row.depth * 12}px` }\"\n @click=\"onPanelRowClick(row)\"\n >\n <Checkbox\n :checked=\"row.isGroup ? groupCheckedState(row) : isColumnVisible(row.key)\"\n :disabled=\"row.isGroup ? false : !canHideColumn(row.key)\"\n @update:checked=\"onPanelRowClick(row)\"\n @click.stop\n />\n <span class=\"min-w-0 flex-1 truncate\">{{ row.node.title }}</span>\n <!-- 有效 fixed 列(数字 width)标识:仅叶子 -->\n <svg\n v-if=\"\n !row.isGroup &&\n (row.node as TableColumnOptions).fixed !== undefined &&\n typeof (row.node as TableColumnOptions).width === 'number'\n \"\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"text-muted-foreground size-3 shrink-0\"\n aria-hidden=\"true\"\n >\n <path d=\"M12 17v5\" />\n <path\n d=\"M9 10.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V7h1a2 2 0 0 0 0-4H8a2 2 0 0 0 0 4h1z\"\n />\n </svg>\n </div>\n </div>\n </template>\n </Popover>\n <!-- 纯受控气泡(无默认插槽,不渲染触发器):开合由触发钮 pointerenter/leave 驱动 -->\n <Tooltip :open=\"settingsTipOpen\" content=\"列设置\" />\n </template>\n </div>\n\n <!-- 滚动容器:横向滚动时 fixed 列 sticky 生效;virtual/fill 模式兼任纵向滚动(分页条不参与滚动) -->\n <div\n ref=\"scrollEl\"\n :class=\"cn('overflow-x-auto', fill && 'min-h-0 flex-1 overflow-y-auto')\"\n :style=\"scrollStyle\"\n >\n <table\n class=\"w-full caption-bottom text-sm\"\n :class=\"tableClass\"\n :style=\"tableMinWidth > 0 ? { minWidth: `${tableMinWidth}px` } : undefined\"\n >\n <thead ref=\"theadEl\" :class=\"theadSticky ? undefined : '[&_tr]:border-b'\">\n <tr\n v-for=\"(cells, rowIndex) in headerRows\"\n :key=\"rowIndex\"\n :ref=\"(el) => (headerRowEls[rowIndex] = el as HTMLElement | null)\"\n :style=\"headerRowStyle(rowIndex)\"\n >\n <!-- 选择列:checkbox 型表头为本页全选三态;radio 型占位;视作最左固定列 -->\n <th\n v-if=\"hasSelection && rowIndex === 0\"\n scope=\"col\"\n :rowspan=\"headerRows.length\"\n class=\"h-10 w-12 px-2 text-center align-middle font-medium text-muted-foreground\"\n :class=\"[stickyClass(stickyOf, SELECTION_CELL), theadThClass]\"\n :style=\"[\n { width: `${selection.width}px` },\n stickyStyle(stickyOf, SELECTION_CELL, true),\n ]\"\n >\n <Checkbox\n v-if=\"selection.type === 'checkbox'\"\n :checked=\"headerIndeterminate ? 'indeterminate' : headerChecked\"\n :aria-label=\"'全选本页'\"\n @update:checked=\"onHeaderSelect\"\n />\n </th>\n <!-- 拖拽把手列表头:占位(对齐 radio 选择列范式);视作最左固定列(紧随选择列) -->\n <th\n v-if=\"dragEnabled && rowIndex === 0\"\n scope=\"col\"\n :rowspan=\"headerRows.length\"\n class=\"h-10 px-1 text-center align-middle font-medium text-muted-foreground\"\n :class=\"[stickyClass(stickyOf, DRAG_CELL), theadThClass]\"\n :style=\"[{ width: `${dragWidth}px` }, stickyStyle(stickyOf, DRAG_CELL, true)]\"\n >\n <span class=\"sr-only\">拖拽排序</span>\n </th>\n <th\n v-for=\"(cell, cellIndex) in cells\"\n :key=\"cell.key\"\n :scope=\"cell.isGroup ? 'colgroup' : 'col'\"\n :colspan=\"cell.colSpan > 1 ? cell.colSpan : undefined\"\n :rowspan=\"cell.rowSpan > 1 ? cell.rowSpan : undefined\"\n class=\"h-10 px-2 align-middle font-medium text-muted-foreground\"\n :class=\"[\n cell.isGroup ? undefined : stickyClass(stickyOf, cell.key),\n theadThClass,\n headerCellClass(cell, cellIndex === cells.length - 1),\n ]\"\n :style=\"[\n cell.isGroup\n ? { textAlign: headerCellAlign(cell) }\n : {\n width: widthOf((cell.node as TableColumnOptions).width),\n textAlign: headerCellAlign(cell),\n },\n cell.isGroup ? groupStickyStyle(cell) : stickyStyle(stickyOf, cell.key, true),\n ]\"\n :aria-sort=\"cell.isGroup ? undefined : ariaSort(cell.node as TableColumnOptions)\"\n >\n <button\n v-if=\"!cell.isGroup && (cell.node as TableColumnOptions).sortable\"\n type=\"button\"\n class=\"inline-flex items-center gap-1 hover:text-foreground\"\n @click=\"onSort((cell.node as TableColumnOptions).key)\"\n >\n {{ (cell.node as TableColumnOptions).title }}\n <span aria-hidden=\"true\" class=\"text-xs\">{{\n sortMark(cell.node as TableColumnOptions)\n }}</span>\n </button>\n <template v-else>{{ cell.node.title }}</template>\n </th>\n </tr>\n </thead>\n\n <tbody class=\"[&_tr:last-child]:border-0\">\n <!-- 加载态:固定 5 行骨架;选择列一并占位;骨架不虚拟化;loading 判定优先 -->\n <template v-if=\"loading\">\n <tr v-for=\"row in SKELETON_ROWS\" :key=\"row\" data-skeleton>\n <td\n v-if=\"hasSelection\"\n class=\"p-2 text-center align-middle\"\n :class=\"stickyClass(stickyOf, SELECTION_CELL)\"\n :style=\"stickyStyle(stickyOf, SELECTION_CELL, false)\"\n >\n <Skeleton class=\"size-4\" />\n </td>\n <td\n v-if=\"dragEnabled\"\n class=\"p-1 text-center align-middle\"\n :class=\"stickyClass(stickyOf, DRAG_CELL)\"\n :style=\"stickyStyle(stickyOf, DRAG_CELL, false)\"\n >\n <Skeleton class=\"size-4\" />\n </td>\n <td\n v-for=\"column in visibleColumns\"\n :key=\"column.key\"\n class=\"p-2 align-middle\"\n :class=\"stickyClass(stickyOf, column.key)\"\n :style=\"[\n { textAlign: column.align ?? 'center' },\n stickyStyle(stickyOf, column.key, false),\n ]\"\n >\n <Skeleton class=\"h-4 w-full\" />\n </td>\n </tr>\n </template>\n\n <!-- 错误态:error 优先于正常数据;插槽可自定义(slot props { error, retry }) -->\n <template v-else-if=\"showError\">\n <tr data-error>\n <td :colspan=\"columnCount\" class=\"p-8 text-center text-muted-foreground\">\n <slot name=\"error\" :error=\"loadError\" :retry=\"retry\">\n <div class=\"flex flex-col items-center gap-3\">\n <p>{{ loadError?.message ?? \"加载失败\" }}</p>\n <Button variant=\"outline\" size=\"sm\" @click=\"retry\">重试</Button>\n </div>\n </slot>\n </td>\n </tr>\n </template>\n\n <!-- 虚拟滚动:窗口行 + 前后占位行(总高撑开滚动区间;行高经 measureElement 动态测量) -->\n <template v-else-if=\"virtualEnabled\">\n <tr aria-hidden=\"true\" data-virtual-pad :style=\"{ height: `${padTop}px` }\">\n <td :colspan=\"columnCount\" class=\"border-0 p-0\"></td>\n </tr>\n <TableBodyRow\n v-for=\"item in virtualLines\"\n :key=\"item.line.key\"\n :ref=\"measureRow\"\n :data-index=\"item.row.index\"\n :line=\"item.line\"\n :columns=\"visibleColumns\"\n :selection=\"hasSelection ? selection.type : undefined\"\n :selected=\"selectedKeys.has(item.line.key)\"\n :sticky=\"stickyOf\"\n :tree-indent=\"tree ? treeIndent : undefined\"\n :drag-column=\"dragEnabled\"\n :drag-disabled=\"rowDragDisabled(item.line)\"\n :dragging=\"drag.draggingKey.value === item.line.key\"\n @select=\"(checked: boolean) => onRowSelect(item.line, checked)\"\n @row-click=\"onRowClick(item.line.record, item.line.index, $event)\"\n @row-dblclick=\"onRowDblclick(item.line.record, item.line.index, $event)\"\n @row-contextmenu=\"onRowContextmenu(item.line.record, item.line.index, $event)\"\n @cell-click=\"\n (columnKey: string, event: MouseEvent) =>\n onCellClick(item.line.record, columnKey, item.line.index, event)\n \"\n @drag-start=\"onRowDragStart(item.line, $event)\"\n @drag-over=\"onRowDragOver(item.line, $event)\"\n @drop=\"onRowDrop(item.line, $event)\"\n @drag-end=\"onRowDragEnd()\"\n />\n <tr aria-hidden=\"true\" data-virtual-pad :style=\"{ height: `${padBottom}px` }\">\n <td :colspan=\"columnCount\" class=\"border-0 p-0\"></td>\n </tr>\n </template>\n\n <template v-else>\n <TableBodyRow\n v-for=\"line in displayBody\"\n :key=\"line.key\"\n :line=\"line\"\n :columns=\"visibleColumns\"\n :selection=\"hasSelection ? selection.type : undefined\"\n :selected=\"selectedKeys.has(line.key)\"\n :sticky=\"stickyOf\"\n :tree-indent=\"tree ? treeIndent : undefined\"\n :drag-column=\"dragEnabled\"\n :drag-disabled=\"rowDragDisabled(line)\"\n :dragging=\"drag.draggingKey.value === line.key\"\n @select=\"(checked: boolean) => onRowSelect(line, checked)\"\n @row-click=\"onRowClick(line.record, line.index, $event)\"\n @row-dblclick=\"onRowDblclick(line.record, line.index, $event)\"\n @row-contextmenu=\"onRowContextmenu(line.record, line.index, $event)\"\n @cell-click=\"\n (columnKey: string, event: MouseEvent) =>\n onCellClick(line.record, columnKey, line.index, event)\n \"\n @drag-start=\"onRowDragStart(line, $event)\"\n @drag-over=\"onRowDragOver(line, $event)\"\n @drop=\"onRowDrop(line, $event)\"\n @drag-end=\"onRowDragEnd()\"\n />\n </template>\n\n <!-- 空态:横跨全列的单单元格,不虚拟化;错误态优先 -->\n <tr v-if=\"!loading && !showError && body.length === 0\" data-empty>\n <td :colspan=\"columnCount\" class=\"p-8 text-center text-muted-foreground\">\n <slot name=\"empty\">{{ emptyText ?? \"暂无数据\" }}</slot>\n </td>\n </tr>\n </tbody>\n </table>\n </div>\n\n <!-- 手动接线(须经 onPageIndex/onPageSize 包装器保留受控去重);显式补 border-t 与 size select 保持现状 -->\n <TablePagination\n v-if=\"showPaginationBar\"\n :class=\"cn('border-t', fill && 'shrink-0')\"\n :page-index=\"instance.page.pageIndex\"\n :page-size=\"instance.page.pageSize\"\n :page-size-opts=\"instance.page.pageSizeOpts\"\n :total=\"instance.page.total\"\n :show-size-select=\"true\"\n @update:page-index=\"onPageIndex\"\n @update:page-size=\"onPageSize\"\n />\n </div>\n</template>\n"
42
+ "content": "<script setup lang=\"ts\">\nimport type { ComponentPublicInstance, PropType, VNodeChild } from \"vue\";\nimport { useVirtualizer } from \"@tanstack/vue-virtual\";\nimport { columnRenders } from \"./column-renders\";\nimport { computed, inject, nextTick, onMounted, ref, watch } from \"vue\";\nimport { Button } from \"@/components/ui/button\";\nimport { Checkbox } from \"@/components/ui/checkbox\";\nimport { FormRender, type FormRenderDefinition } from \"@/components/ui/form-render\";\nimport { Popover } from \"@/components/ui/popover\";\nimport { Separator } from \"@/components/ui/separator\";\nimport { Skeleton } from \"@/components/ui/skeleton\";\nimport { Tooltip } from \"@/components/ui/tooltip\";\nimport { cn } from \"@/lib/utils\";\nimport { isColumnGroup } from \"./columns\";\nimport { PAGE_TABLE_FILL_KEY, DRAG_CELL, SELECTION_CELL } from \"./constants\";\nimport { stickyClass, stickyStyle, type StickyMap } from \"./sticky\";\nimport TableBodyRow from \"./TableBodyRow.vue\";\nimport TablePagination from \"./TablePagination.vue\";\nimport type {\n ColumnVisibilityOptions,\n DataRecord,\n SortableOptions,\n TableBodyLine,\n TableColumnGroupOptions,\n TableColumnNode,\n TableColumnOptions,\n TableDraggableOptions,\n TableDragSortPayload,\n TableLoadParams,\n TableRenderDefinition,\n TableSelectionOptions,\n TreeOptions,\n} from \"./types\";\nimport { useTableRender } from \"./useTableRender\";\nimport { createRowSnapshot, useRowDrag } from \"./useRowDrag\";\n\n// boolean flags 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false;Checkbox/Dialog/FormRender 同款约定)\nconst props = defineProps({\n /** 聚合式(推荐):defineTable 返回的定义对象 */\n definition: { type: Object as PropType<TableRenderDefinition<any>> },\n /** 数据主键(记录缺字段时以行索引兜底) */\n rowKey: { type: String, required: true },\n /** 拆分式:与 definition 二选一,definition 优先(支持分组列节点;列泛型不约束记录形态) */\n columns: { type: Array as PropType<TableColumnNode<any>[]> },\n onLoad: {\n type: Function as PropType<(params: TableLoadParams) => void | Promise<unknown>>,\n },\n data: { type: Array as PropType<DataRecord[]> },\n autoLoad: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 每页条数 / 受控每页条数:传入即受控(pageIndex 未受控时页码归位内部处理并通知) */\n pageSize: { type: Number },\n pageSizeOpts: { type: Array as PropType<number[]> },\n loading: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n emptyText: { type: String },\n /** 行选择(仅拆分式生效;聚合式请在 defineTable 配置):\"radio\" | \"checkbox\" | 对象 */\n rowSelection: {\n type: [String, Object] as PropType<\"radio\" | \"checkbox\" | TableSelectionOptions>,\n default: undefined,\n },\n /** 搜索表单(defineForm 返回值):拆分式直接传;聚合式请在 defineTable 配置(definition 优先,同传 DEV 警告) */\n search: { type: Object as PropType<FormRenderDefinition<any>> },\n /** 虚拟滚动:开启后表体行虚拟化渲染;聚合式请在 defineTable 配置(definition 优先);须同时给 height */\n virtual: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 虚拟滚动容器高度(数字 px 或 CSS 高度);仅 virtual: true 时生效 */\n height: { type: [Number, String] as PropType<number | string> },\n /** 树形数据(子行展开/收起);拆分式直接传,聚合式请在 defineTable 配置 */\n tree: { type: Object as PropType<TreeOptions> },\n /** 行拖拽排序(仅拆分式生效;聚合式请在 defineTable 配置):true 或对象配置;与 tree/virtual 互斥 */\n draggable: {\n type: [Boolean, Object] as PropType<boolean | TableDraggableOptions>,\n default: undefined,\n },\n /** 受控页码(1-based):传入即受控,缺省非受控;内部翻页经 update:page-index 通知 */\n pageIndex: { type: Number },\n /** 受控排序:传入即受控;内部/外部变化均经 sort-change 通知 */\n sort: { type: Object as PropType<SortableOptions> },\n /** 受控选中集(数组,与 update:selected-keys 载荷同构):传入即受控 */\n selectedKeys: { type: Array as PropType<Array<string | number>> },\n /** 受控可见列 key(columns 原序子集):传入即受控;内部显隐经 update:visible-keys 通知 */\n visibleKeys: { type: Array as PropType<string[]> },\n /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(definition 优先) */\n defaultVisibleKeys: { type: Array as PropType<string[]> },\n /** 列设置触发器/面板开关(默认 true);false 时不渲染 UI,受控 API 不受影响 */\n columnSettings: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 搜索区渲染开关:false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */\n showSearch: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 分页条渲染开关:false 关闭内置分页条(组合式外置 TablePagination);缺省模式单页自隐藏不变 */\n showPagination: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 填充模式:根容器 h-full 纵向 flex,滚动区 flex-1 内滚;表头 sticky 钉住。\n * 父链需有确定高度(如页面布局的 .table-body);无确定高度时安全退化为自然高度。\n * 显式 prop 优先于布局 provide(key: \"tu-design:page-table-fill\");显式传 false 可强制关闭。\n * 纯布局属性,不进 defineTable/definition(virtual/height 例外),setup 期定版不支持运行时切换。 */\n fillHeight: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 是否显示表格边框(仅外框);网格线由 single-column / single-line 独立控制(正交模型,词汇对齐 naive-ui) */\n bordered: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 表格底部是否有边框;bordered: true 时外框已含底边,此参数冗余无害 */\n bottomBordered: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 是否不设定行的分割线;true 时单元格没有下边线 */\n singleColumn: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 是否不设定列的分割线;true 时单元格没有右边线 */\n singleLine: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 斑马线条纹(按行模型索引奇偶,虚拟滚动窗口安全);纯样式属性,setup 期定版不支持运行时切换 */\n striped: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n});\n\n// ---- 填充模式(fillHeight)---------------------------------------------------\n// 布局上下文:页面布局容器 provide 同名 key,slot 内 TableRender 自动 fill。\n// 字符串 key 跨包约定(常量 PAGE_TABLE_FILL_KEY 已导出,消费方零依赖时按字符串值 provide),\n// setup 期定版,不支持运行时切换(与 virtual/search 同约定)。\nconst pageTableFill = inject<boolean>(PAGE_TABLE_FILL_KEY, false);\nconst fill = props.fillHeight ?? pageTableFill;\n\nconst emit = defineEmits<{\n \"update:page-index\": [pageIndex: number];\n \"update:page-size\": [pageSize: number];\n \"sort-change\": [sort: SortableOptions | undefined];\n \"row-click\": [record: DataRecord, index: number, event: MouseEvent];\n /** 行双击(与 row-click 独立,双击会先后触发 click 两次,属预期) */\n \"row-dblclick\": [record: DataRecord, index: number, event: MouseEvent];\n /** 行右键;不主动 preventDefault */\n \"row-contextmenu\": [record: DataRecord, index: number, event: MouseEvent];\n /** 单元格点击(columnKey 定位列);冒泡并存——cell-click 触发时 row-click 也会触发 */\n \"cell-click\": [record: DataRecord, columnKey: string, index: number, event: MouseEvent];\n \"selection-change\": [rows: DataRecord[]];\n \"update:selected-keys\": [keys: Array<string | number>];\n /** 搜索:FormRender 校验通过后触发;载荷为当前表单值 */\n search: [values: DataRecord];\n /** 重置:FormRender 已重置为 defaults 后触发;载荷为重置后的表单值 */\n reset: [values: DataRecord];\n /** 服务端模式 onLoad 抛错/ rejects 时触发;下一次 load 开始时 error 投影清除 */\n \"load-error\": [error: Error];\n /** 可见列变化(受控回写通知 / v-model:visible-keys) */\n \"update:visible-keys\": [keys: string[]];\n /** 列显隐变化(受控/非受控均触发,供业务持久化;载荷 = 可见列 key 有序数组,columns 原序) */\n \"column-visibility-change\": [keys: string[]];\n /** 行拖拽落位(仅成功 drop 触发,取消路径不发):from/to 为页内索引,rows = 当前页新行序。\n * 静态模式引擎已先行重排,调用方应回写自身数据源;服务端模式需持久化后 reload */\n \"drag-sort\": [payload: TableDragSortPayload];\n}>();\n\ndefineSlots<{\n empty?: () => VNodeChild;\n /** 错误态占位(服务端模式 onLoad 失败时渲染,优先于数据区) */\n error?: (props: { error: Error | undefined; retry: () => void }) => VNodeChild;\n}>();\n\n/** 加载态骨架行数 */\nconst SKELETON_ROWS = [1, 2, 3, 4, 5];\n\n/** 内置渲染器单例:render 工厂按列求值时复用(工厂本身轻量,仅为整洁) */\nconst RENDERS = columnRenders();\n\n// 聚合式直接复用 defineTable 建好的内核;拆分式在本组件 setup 内建内核\n// (TanStack useVueTable 只能在 setup 调用,故不能放进条件分支深处)\nif (props.definition && props.columns && import.meta.env.DEV) {\n console.warn(\"[tu-design] <TableRender> definition 与 columns 同时传入,已按 definition 渲染。\");\n}\nif (props.definition && props.rowSelection && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 rowSelection 请在 defineTable 配置,组件 prop 已忽略。\",\n );\n}\nif (props.definition && props.draggable !== undefined && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 draggable 请在 defineTable 配置,组件 prop 已忽略。\",\n );\n}\n// 显式 any 泛型:Row 的泛型为 in out(不变),拆分式推断出的 DataRecord 具型与\n// definition<any> 逃逸舱口互不相容(TS6 getParentRow 递归比对报 unrelated)\nconst instance: TableRenderDefinition<any> =\n props.definition ??\n useTableRender({\n columns: props.columns ?? [],\n onLoad: props.onLoad,\n data: () => props.data,\n autoLoad: props.autoLoad,\n pageSizeOpts: props.pageSizeOpts,\n rowKey: props.rowKey,\n rowSelection: props.rowSelection,\n search: props.search,\n virtual: props.virtual,\n height: props.height,\n tree: props.tree,\n draggable: props.draggable,\n pageIndex: () => props.pageIndex,\n pageSize: () => props.pageSize,\n sort: () => props.sort,\n selectedKeys: () => props.selectedKeys,\n // 聚合式 columnVisibility 由 definition 自带路径承载;拆分式此处恒空(TS6 下 ?? 右侧收窄坐实)\n defaultVisibleKeys: () => props.defaultVisibleKeys,\n visibleKeys: () => props.visibleKeys,\n });\n// 拆分式已传 rowKey;聚合式由组件回填(选择引擎依赖 rowKey 就绪)\ninstance.setRowKey(props.rowKey);\n\n// ---- 搜索表单(FormRender 联动) --------------------------------------------\n// 与 rowSelection 不同:聚合式下 prop 未被 definition 覆盖时回填引擎(不做聚合式忽略限制);\n// definition 与 prop 二选一,definition 优先,同传 DEV 警告\nif (props.definition && props.search) {\n if (instance.search && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 search 已在 defineTable 配置,组件 prop 已忽略。\",\n );\n } else {\n instance.setSearch(props.search);\n }\n}\n// search 不支持运行时切换(与 FormRender definition/form 同款约定),setup 期定版即可\nconst search = instance.search;\n\n// 列设置触发器的 Tooltip 受控开合(Tooltip 与 Popover 触发器嵌套会吞点击,故手动控制、不嵌套触发器)\nconst settingsTipOpen = ref(false);\n\n// ---- 列显隐(column visibility) ------------------------------------\n// 聚合式(columnVisibility.defaultVisibleKeys 经引擎解析回传)与拆分式 prop 同传 → definition 优先。\n// 引擎是唯一解析点;聚合式受控回填经 setVisibleKeys(normalize 等值守卫防回弹);\n// 拆分式由引擎受控 watch 直接同步(源 = props getter)\nif (\n props.definition &&\n instance.defaultVisibleKeys !== undefined &&\n props.defaultVisibleKeys !== undefined &&\n import.meta.env.DEV\n) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 defaultVisibleKeys 已在 columnVisibility 配置,组件 prop 已忽略。\",\n );\n}\nwatch(\n () => props.visibleKeys,\n (next) => {\n if (props.definition && next !== undefined) instance.setVisibleKeys(next);\n },\n { immediate: true },\n);\n\n/**\n * 当前搜索表单值快照(浅拷贝;无 search 时为空对象)\n * @returns 表单值快照\n */\nfunction searchValues(): DataRecord {\n return search ? { ...search.form.state.values } : {};\n}\n\n/** 搜索:校验已由 FormRender 完成;归位第 1 页重载,分页/排序取数自动携带最新表单值 */\nfunction onSearch() {\n emit(\"search\", searchValues());\n instance.reload(true);\n}\n\n/** 重置:FormRender 已同步重置为 defaults(TanStack reset 为同步 setState),此刻读取即 defaults */\nfunction onReset() {\n emit(\"reset\", searchValues());\n instance.reload(true);\n}\n\nconst columns = computed(() => instance.columns);\nconst rows = computed(() => instance.table.getRowModel().rows);\n/** 内部加载态 ∪ 外部受控加载态 */\nconst loading = computed(() => props.loading === true || instance.loading.value);\nconst showPagination = computed(() => Math.ceil(instance.page.total / instance.page.pageSize) > 1);\n/** 内置分页条开关:showPagination=false 关闭;单页自隐藏仅作用于缺省模式 */\nconst showPaginationBar = computed(() => showPagination.value && props.showPagination !== false);\n/** 内置搜索区开关:配置了 search 且未被 showSearch=false 关闭;列设置触发器不受影响 */\nconst showSearchArea = computed(() => search !== undefined && props.showSearch !== false);\n\n// ---- 错误态(服务端模式 onLoad 失败) ----------------------------------------\n// loading 判定优先;error 优先于正常数据(load 开始时引擎已清除旧错误,loading 期间 error 恒空)\nconst loadError = computed(() => instance.error.value);\nconst showError = computed(() => !loading.value && loadError.value !== undefined);\n\nwatch(loadError, (err) => {\n if (err) emit(\"load-error\", err);\n});\n\nfunction retry() {\n instance.reload();\n}\n\n// ---- 行选择(S 系列) -------------------------------------------------------\nconst selection = computed(() => instance.selection);\nconst selectedKeys = instance.selectedKeys;\nconst hasSelection = computed(() => selection.value.enabled);\n\n// ---- 列显隐(column visibility) -------------------------------------\nconst visibleKeySet = computed(() => new Set(instance.visibleKeys.value));\n/** 可见业务列(columns 原序子集):header/body/骨架/colspan/sticky 全部基于此渲染 */\nconst visibleColumns = computed(() =>\n columns.value.filter((column) => visibleKeySet.value.has(column.key)),\n);\n\n// ---- 表头分组(多级表头) -------------------------------------------\n// 原始列节点树(definition.columnTree 缺省时回退扁平列 = 单级表头)\nconst columnsTree = computed<TableColumnNode<DataRecord>[]>(\n () => (instance.columnTree as TableColumnNode<DataRecord>[]) ?? columns.value,\n);\n\n/** 可见表头树节点:按 visibleKeySet 剪枝后的结构(空分组已被剔除) */\ninterface HeaderNodeView {\n node: TableColumnNode<DataRecord>;\n isGroup: boolean;\n /** DFS 索引路径(如 \"0-1\"):分组单元格 key 的唯一来源,与 title 解耦 */\n path: string;\n children: HeaderNodeView[];\n}\n\n/**\n * 按可见集递归构建表头树:分组子树可见叶子为 0 时整支剔除(与列显隐同口径)。\n * @param nodes - 列节点树(或其子树)\n * @param parentPath - 父级 DFS 索引路径(根为 \"\")\n * @returns 剪枝后的可见表头树\n */\nfunction buildVisibleHeaderTree(\n nodes: TableColumnNode<DataRecord>[],\n parentPath: string,\n): HeaderNodeView[] {\n const views: HeaderNodeView[] = [];\n nodes.forEach((node, index) => {\n const path = parentPath === \"\" ? `${index}` : `${parentPath}-${index}`;\n if (isColumnGroup(node)) {\n const children = buildVisibleHeaderTree(node.children, path);\n if (children.length > 0) views.push({ node, isGroup: true, path, children });\n } else if (visibleKeySet.value.has(node.key)) {\n views.push({ node, isGroup: false, path, children: [] });\n }\n });\n return views;\n}\n\n/** 唯一派生源:可见表头树(maxDepth 与表头矩阵同源于此,杜绝口径漂移) */\nconst visibleHeaderTree = computed(() => buildVisibleHeaderTree(columnsTree.value, \"\"));\n\n/** 表头深度(可见树):无分组时为 1 */\nconst maxDepth = computed(() => {\n const depthOf = (view: HeaderNodeView): number =>\n view.children.length > 0 ? 1 + Math.max(...view.children.map(depthOf)) : 1;\n return visibleHeaderTree.value.length > 0 ? Math.max(...visibleHeaderTree.value.map(depthOf)) : 1;\n});\n\n/** 表头单元格:分组跨列、叶子下沉贴底 */\ninterface HeaderCell {\n node: TableColumnNode<DataRecord>;\n /** Vue 列表 key:叶子用列 key,分组用 DFS 路径(唯一稳定) */\n key: string;\n path: string;\n depth: number;\n colSpan: number;\n rowSpan: number;\n isGroup: boolean;\n /** 该单元格覆盖的可见叶子列 key(分组为子树全部,叶子为自身) */\n leafKeys: string[];\n}\n\n/** 表头矩阵:行 × 单元格(叶子 rowSpan = maxDepth - depth,分组 colSpan = 子树可见叶子数) */\nconst headerRows = computed<HeaderCell[][]>(() => {\n const rows: HeaderCell[][] = Array.from({ length: maxDepth.value }, () => []);\n const collectLeaves = (view: HeaderNodeView): string[] =>\n view.isGroup\n ? view.children.flatMap(collectLeaves)\n : [(view.node as TableColumnOptions<DataRecord>).key];\n\n const walk = (views: HeaderNodeView[], depth: number) => {\n for (const view of views) {\n const leafKeys = collectLeaves(view);\n if (view.isGroup) {\n rows[depth]!.push({\n node: view.node,\n key: `g:${view.path}`,\n path: view.path,\n depth,\n colSpan: leafKeys.length,\n rowSpan: 1,\n isGroup: true,\n leafKeys,\n });\n } else {\n rows[depth]!.push({\n node: view.node,\n key: (view.node as TableColumnOptions<DataRecord>).key,\n path: view.path,\n depth,\n colSpan: 1,\n rowSpan: maxDepth.value - depth,\n isGroup: false,\n leafKeys,\n });\n }\n walk(view.children, depth + 1);\n }\n };\n walk(visibleHeaderTree.value, 0);\n return rows;\n});\n\n/** 列设置触发器/面板开关(默认 true);false 时不渲染 UI,受控 API 不受影响 */\nconst showColumnSettings = computed(() => props.columnSettings ?? true);\n\nfunction isColumnVisible(key: string): boolean {\n return visibleKeySet.value.has(key);\n}\n\n/**\n * 最少一列:唯一可见列不可隐藏\n * @param key - 列 key\n * @returns 是否允许隐藏该列\n */\nfunction canHideColumn(key: string): boolean {\n return !(instance.visibleKeys.value.length <= 1 && visibleKeySet.value.has(key));\n}\n\nfunction toggleColumnVisible(key: string) {\n if (!canHideColumn(key)) return;\n instance.setVisibleKeys(\n isColumnVisible(key)\n ? instance.visibleKeys.value.filter((k) => k !== key)\n : [...instance.visibleKeys.value, key],\n );\n}\n\nconst allColumnsVisible = computed(\n () => columns.value.length > 0 && visibleColumns.value.length === columns.value.length,\n);\n\nfunction selectAllColumns() {\n if (allColumnsVisible.value) return;\n instance.setVisibleKeys(columns.value.map((column) => column.key));\n}\n\nfunction resetColumns() {\n // 恢复 defaultVisibleKeys;未配置 = 全部可见\n instance.setVisibleKeys(instance.defaultVisibleKeys ?? columns.value.map((column) => column.key));\n}\n\n// ---- 列设置面板:树形行 ------------------------------------------------\n/** 面板行(全树扁平化,避免模板递归):分组行为父级三态,叶子行为勾选项 */\ninterface PanelRow {\n node: TableColumnNode<DataRecord>;\n depth: number;\n isGroup: boolean;\n /** 该节点覆盖的叶子 key(分组为子树全部) */\n leafKeys: string[];\n path: string;\n key: string;\n}\n\n/** 面板行派生:以原始列节点树(非可见剪枝)为准,保证隐藏后仍可恢复 */\nconst panelRows = computed<PanelRow[]>(() => {\n const rows: PanelRow[] = [];\n const collectLeaves = (node: TableColumnNode<DataRecord>): string[] =>\n isColumnGroup(node) ? node.children.flatMap(collectLeaves) : [node.key];\n const walk = (nodes: TableColumnNode<DataRecord>[], depth: number, parentPath: string) => {\n nodes.forEach((node, index) => {\n const path = parentPath === \"\" ? `${index}` : `${parentPath}-${index}`;\n const isGroup = isColumnGroup(node);\n rows.push({\n node,\n depth,\n isGroup,\n leafKeys: collectLeaves(node),\n path,\n key: isGroup ? `g:${path}` : node.key,\n });\n if (isGroup) walk(node.children, depth + 1, path);\n });\n };\n walk(columnsTree.value, 0, \"\");\n return rows;\n});\n\n/**\n * 分组勾选三态:全部可见 = true,部分可见 = \"indeterminate\",全隐 = false\n * @param row - 面板分组行\n * @returns 该分组的三态勾选值\n */\nfunction groupCheckedState(row: PanelRow): boolean | \"indeterminate\" {\n const visibleCount = row.leafKeys.filter((key) => visibleKeySet.value.has(key)).length;\n if (visibleCount === 0) return false;\n if (visibleCount === row.leafKeys.length) return true;\n return \"indeterminate\";\n}\n\n/**\n * 分组批量显隐(最少一列恒按叶子口径):\n * 隐藏整组会导致 0 列可见时,保留该组最后一枚可见叶子(父级呈 indeterminate)。\n * @param row - 面板分组行\n */\nfunction toggleGroupVisible(row: PanelRow) {\n const leafSet = new Set(row.leafKeys);\n const allVisible = row.leafKeys.every((key) => visibleKeySet.value.has(key));\n if (!allVisible) {\n // 显示整组:与当前可见集按 columns 原序合并(normalize 会纠正顺序)\n instance.setVisibleKeys(\n columns.value\n .map((column) => column.key)\n .filter((key) => visibleKeySet.value.has(key) || leafSet.has(key)),\n );\n return;\n }\n const remaining = instance.visibleKeys.value.filter((key) => !leafSet.has(key));\n if (remaining.length === 0) {\n // 钳制:不得清空可见集,保留最后一枚叶子\n instance.setVisibleKeys([row.leafKeys[row.leafKeys.length - 1]!]);\n return;\n }\n instance.setVisibleKeys(remaining);\n}\n\n/**\n * 面板行点击(分组批量显隐 / 叶子单列切换)\n * @param row - 面板行(分组或叶子)\n */\nfunction onPanelRowClick(row: PanelRow) {\n if (row.isGroup) toggleGroupVisible(row);\n else toggleColumnVisible(row.key);\n}\n\n// 受控/非受控均通知:统一投影变化 → 双事件(载荷 = columns 原序可见 key)\nwatch(instance.visibleKeys, (keys) => {\n emit(\"update:visible-keys\", [...keys]);\n emit(\"column-visibility-change\", [...keys]);\n});\n\n/** 总列数 = 可见业务列 + 选择列(空态 colspan 与骨架行) */\nconst columnCount = computed(\n () => visibleColumns.value.length + (hasSelection.value ? 1 : 0) + (dragEnabled.value ? 1 : 0),\n);\n\n// ---- 固定列(sticky) --------------------------------------------------------\n\n// DEV 校验:sticky 偏移只能从数字 width(px)推算,否则降级普通列(columns setup 期定版,只查一次)\nfor (const column of columns.value) {\n if (column.fixed !== undefined && typeof column.width !== \"number\") {\n console.warn(\n `[tu-design] <TableRender> fixed 列 \"${column.key}\" 需要数字 width,已忽略 fixed。`,\n );\n }\n}\n\n// DEV 校验(一次性):分组节点误配 key/sortable/fixed/width、空 children(列节点树定版)\nif (import.meta.env.DEV) {\n const validateNodes = (nodes: TableColumnNode<DataRecord>[], depth: number) => {\n for (const node of nodes) {\n if (isColumnGroup(node)) {\n if (\"key\" in node && (node as { key?: unknown }).key !== undefined) {\n console.warn(\n \"[tu-design] <TableRender> 分组节点不应配置 key(分组不是数据列),已忽略。\",\n );\n }\n if ((node as { sortable?: unknown }).sortable !== undefined) {\n console.warn(\n `[tu-design] <TableRender> 分组「${node.title}」不支持 sortable(仅叶子列可排序),已忽略。`,\n );\n }\n if ((node as { fixed?: unknown }).fixed !== undefined) {\n console.warn(\n `[tu-design] <TableRender> 分组「${node.title}」不支持 fixed(请配置到叶子列),已忽略。`,\n );\n }\n if (node.children.length === 0) {\n console.warn(`[tu-design] <TableRender> 分组「${node.title}」children 为空,将被忽略。`);\n }\n validateNodes(node.children, depth + 1);\n } else if (\"children\" in node && (node as { children?: unknown }).children !== undefined) {\n console.warn(\n `[tu-design] <TableRender> 叶子列 \"${node.key}\" 不应配置 children,已按叶子渲染。`,\n );\n }\n }\n };\n validateNodes(columnsTree.value, 0);\n}\n\n// DEV 提示(一次性,columns setup 期定版):多列宽表全列无数字 width 时,\n// min-width 横滚不可达 —— 宽表请为列声明数字 width(px)。\nif (columns.value.length >= 10 && !columns.value.some((c) => typeof c.width === \"number\")) {\n console.warn(\n `[tu-design] <TableRender> ${columns.value.length} 列均无数字 width,` +\n `窄容器下不会出现横向滚动;宽表请为列声明数字 width(px)。`,\n );\n}\n\n/** sticky 单元格映射(纯渲染层 computed,不进 TanStack pinning state):\n * 选择列视作最左 fixed 列参与累计(offset 0);fixed-left 按列序累加,\n * fixed-right 从最右列反向累计。edge = 该 sticky 组朝滚动方向的交界列(加分隔边框)。\n * 全部基于**可见集**:sticky 组因隐藏变空则无该组输出(不输出边框)。\n */\nconst stickyOf = computed<StickyMap>(() => {\n const map: StickyMap = new Map();\n // instance.columns 是联合数组(聚合式 any / 拆分式 DataRecord),联合上的 filter\n // 类型谓词重载解析不可靠,故 map 提取时以断言收窄 width(条件已含 typeof 守卫)\n const lefts = visibleColumns.value\n .filter((column) => column.fixed === \"left\" && typeof column.width === \"number\")\n .map((column) => ({ key: column.key, width: column.width as number }));\n const rights = visibleColumns.value\n .filter((column) => column.fixed === \"right\" && typeof column.width === \"number\")\n .map((column) => ({ key: column.key, width: column.width as number }));\n\n let acc = 0;\n if (hasSelection.value) {\n map.set(SELECTION_CELL, {\n side: \"left\",\n offset: 0,\n edge: lefts.length === 0 && !dragEnabled.value,\n });\n acc = selection.value.width;\n }\n // 把手列紧随选择列(选择列保持 offset 0 视觉锚点),同视作最左固定列参与累计\n if (dragEnabled.value) {\n map.set(DRAG_CELL, { side: \"left\", offset: acc, edge: lefts.length === 0 });\n acc += dragWidth;\n }\n lefts.forEach((left, index) => {\n map.set(left.key, { side: \"left\", offset: acc, edge: index === lefts.length - 1 });\n acc += left.width;\n });\n\n let racc = 0;\n for (let index = rights.length - 1; index >= 0; index--) {\n const right = rights[index]!;\n map.set(right.key, { side: \"right\", offset: racc, edge: index === 0 });\n racc += right.width;\n }\n return map;\n});\n\n// ---- 表格 min-width(列宽硬约束) ----------------------------------------\n// 可见业务列数字 width 之和(含选择列)作为 <table> min-width 下限:\n// 容器不足 → 表格被顶到 Σwidth,auto 布局下列渲染宽度 == 指定宽度,stickyOf 偏移精确成立,\n// 滚动区 overflow-x-auto 横滚;容器充足 → 表格仍 100% 拉伸(有宽列可能被拉伸,\n// sticky 偏移按指定值累计的漂移为既有限制)。\n// 字符串 width 仅渲染提示值,不参与求和(与 stickyOf 口径一致);和为 0 不挂 style(零回归)。\nconst tableMinWidth = computed(() => {\n let sum = 0;\n for (const column of visibleColumns.value) {\n if (typeof column.width === \"number\" && column.width > 0) sum += column.width;\n }\n if (hasSelection.value && selection.value.width > 0) sum += selection.value.width;\n if (dragEnabled.value && dragWidth > 0) sum += dragWidth;\n return sum;\n});\n\n/** 列宽 inline style 值:数字补 px 单位——Vue :style 不自动加单位,\n * 裸数字会被浏览器当非法 CSS 值丢弃,列宽即失效;字符串视为已带单位原样输出。\n * @param width - 列宽配置\n * @returns 可直接用于 :style 的 CSS 宽度值;未配置返回 undefined\n */\nfunction widthOf(width?: number | string) {\n return typeof width === \"number\" ? `${width}px` : width;\n}\n\n// ---- 分组表头单元格 ------------------------------------------------\n\n/** 混合固定组警告去重(同名分组仅警告一次) */\nconst warnedMixedFixedGroups = new Set<string>();\n\n/**\n * 分组单元格的 sticky 样式:子树可见叶子同侧且连续固定时整格 sticky,\n * 偏移取首个可见叶子;混合侧 → 返回 undefined(降级普通格)并 DEV 警告一次。\n * @param cell - 表头单元格(分组)\n * @returns 分组单元格的 sticky inline style;不适用时返回 undefined\n */\nfunction groupStickyStyle(cell: HeaderCell) {\n const sides = new Set(\n cell.leafKeys\n .map((key) => columns.value.find((column) => column.key === key)?.fixed)\n .filter((side): side is \"left\" | \"right\" => side !== undefined),\n );\n // 混合侧(同时含 left 与 right):单元格无法部分固定 → 降级普通格\n if (sides.size > 1) {\n if (!warnedMixedFixedGroups.has(cell.key)) {\n warnedMixedFixedGroups.add(cell.key);\n if (import.meta.env.DEV) {\n console.warn(\n `[tu-design] <TableRender> 分组「${(cell.node as TableColumnGroupOptions).title}」内固定方向混合,已降级为普通表头格。`,\n );\n }\n }\n return undefined;\n }\n if (sides.size === 0) return undefined;\n // 组内固定列不连续(中间夹普通列)时,分组格跨过非固定列会遮挡滚动内容 → 同样降级\n const fixedLeaves = cell.leafKeys.filter((key) => {\n const column = columns.value.find((c) => c.key === key);\n return column?.fixed !== undefined && typeof column.width === \"number\";\n });\n if (fixedLeaves.length !== cell.leafKeys.length) return undefined;\n const side = [...sides][0]!;\n const first = stickyOf.value.get(cell.leafKeys[0]!);\n if (!first) return undefined;\n return {\n position: \"sticky\" as const,\n [side]: `${first.offset}px`,\n zIndex: \"var(--z-sticky-head)\",\n };\n}\n\n/**\n * 表头行的行级样式:sticky 模式下逐行累积 top 偏移(多行表头),避免顶边重叠。\n * @param rowIndex - 表头行下标\n * @returns 行级 inline style;非 sticky 模式返回 undefined\n */\nfunction headerRowStyle(rowIndex: number) {\n if (!theadSticky) return undefined;\n return { top: `${rowTop.value[rowIndex] ?? rowIndex * HEADER_ROW_FALLBACK}px` };\n}\n\n/**\n * 表头列线:分组格分隔线是结构性硬边界(多行表头分组界恒画,不受列线开关影响);\n * 叶子格受列线开关控制(single-line: false 时开启)。行末排除,右缘归外框。\n * 横向底线不在此绘制(恒挂 theadLineClass 承担,thead 行级 border 已退役)。\n * @param cell - 表头单元格\n * @param isLastInRow - 是否为本行最后一个单元格\n * @returns class 列表\n */\nfunction headerCellClass(cell: HeaderCell, isLastInRow: boolean) {\n if (cell.isGroup) return isLastInRow ? [] : [\"border-r border-border\"];\n return columnLinesOn && !isLastInRow ? [\"border-r border-border\"] : [];\n}\n\n/**\n * 分组单元格水平对齐(分组无 align 以外的能力)\n * @param cell - 表头单元格\n * @returns 对齐值,默认居中\n */\nfunction headerCellAlign(cell: HeaderCell) {\n return cell.isGroup\n ? ((cell.node as TableColumnGroupOptions).align ?? \"center\")\n : ((cell.node as TableColumnOptions).align ?? \"center\");\n}\n\n/** 分组无需排序能力标记(sortable 仅叶子生效,对分组 sortable 警告) */\n\n/** 表头全选三态:本页可选行与选中集求交派生(TanStack getter 追踪不稳,自算) */\nconst selectableKeys = computed(() =>\n rows.value.filter((row) => row.getCanSelect()).map((row) => rowKeyOf(row.original, row.index)),\n);\nconst headerChecked = computed(\n () =>\n hasSelection.value &&\n selection.value.type === \"checkbox\" &&\n selectableKeys.value.length > 0 &&\n selectableKeys.value.every((key) => selectedKeys.value.has(key)),\n);\nconst headerIndeterminate = computed(\n () =>\n hasSelection.value &&\n !headerChecked.value &&\n selectableKeys.value.some((key) => selectedKeys.value.has(key)),\n);\n\nfunction onHeaderSelect(checked: boolean) {\n instance.table.toggleAllPageRowsSelected(checked);\n}\n\n/**\n * 行选择控件切换;radio 不可取消由引擎守卫,不选中态点击传 checked=true\n * @param line - 行数据(含行 key)\n * @param checked - 目标选中态\n */\nfunction onRowSelect(line: { key: string }, checked: boolean) {\n instance.toggleRowSelected(line.key, checked);\n}\n\n// 选中集变化 → 对外事件:排序/翻页不改变选中集,故不会误发\nwatch(instance.selectedKeys, (keys) => {\n emit(\"selection-change\", [...selection.value.value]);\n emit(\"update:selected-keys\", [...keys]);\n});\n\n/** 行 → 单元格值矩阵:render > formatter > record[key] */\nconst body = computed<TableBodyLine[]>(() => {\n // 渲染器工厂按列求值一次(而非每单元格),避免用户工厂内的重分配被放大\n const renderFns = new Map(\n columns.value.filter((c) => c.render).map((c) => [c, c.render!(RENDERS)]),\n );\n return rows.value.map((row) => ({\n /** TanStack Row:树形渲染读 depth / getCanExpand / getIsExpanded / toggleExpanded */\n row,\n key: rowKeyOf(row.original, row.index),\n index: row.index,\n record: row.original,\n /** 行级可选过滤:selectable 谓词交由引擎 enableRowSelection 判定 */\n canSelect: row.getCanSelect(),\n // 可见列的值矩阵(列显隐只裁剪列;状态不受影响)\n cells: visibleColumns.value.map((column): VNodeChild => {\n const render = renderFns.get(column);\n if (render) return render(row.original, row.index, column);\n if (column.formatter) return column.formatter(row.original) as VNodeChild;\n return String(row.original[column.key] ?? \"\");\n }),\n }));\n});\n\n// ---- 树形数据(T 系列) ------------------------------------------------------\n// 引擎是唯一解析点(无效配置已 warn 并忽略,回传 undefined);tree 为 undefined 时不渲染缩进与 caret\nconst tree = instance.tree;\nconst treeIndent = tree?.indentSize ?? 16;\n\nlet missingRowKeyWarned = false;\n\n/**\n * 行主键:rowKey 字段缺失时以行索引兜底\n * @param record - 行记录\n * @param index - 行索引(兜底来源)\n * @returns 稳定的行主键字符串\n */\nfunction rowKeyOf(record: DataRecord, index: number): string {\n const value = record[props.rowKey];\n if (value === undefined || value === null) {\n if (!missingRowKeyWarned && import.meta.env.DEV) {\n missingRowKeyWarned = true;\n console.warn(\n `[tu-design] <TableRender> 部分记录缺少 rowKey 字段 \"${props.rowKey}\",已退化为按行索引标识。`,\n );\n }\n return `index-${index}`;\n }\n return String(value);\n}\n\n// ---- 虚拟滚动 / 填充模式 ------------------------------------------------------\n// definition 优先于 prop(配置定版,不支持运行时切换)\nconst virtualRaw = instance.virtual ?? props.virtual;\nconst heightRaw = instance.height ?? props.height;\n// fill 模式自带真实滚动盒(flex-1 实测高度),virtual 无需显式 height\nif (virtualRaw === true && heightRaw === undefined && !fill) {\n console.warn(\"[tu-design] <TableRender> virtual 需要配置 height,已降级普通渲染。\");\n}\nconst virtualEnabled = virtualRaw === true && (heightRaw !== undefined || fill);\n\n// ---- 行拖拽排序(draggable) --------------------------------------------------\n// 引擎是唯一配置解析点(tree/virtual 冲突已 warn 并忽略);此处兜底聚合式 definition\n// 与组件 prop virtual 同传的边界(引擎解析时看不到 prop)。配置 setup 期定版。\nconst dragConfig = instance.draggable;\nconst dragEnabled = computed(() => dragConfig !== undefined && !virtualEnabled);\nconst dragWidth = dragConfig?.width ?? 32;\nconst drag = useRowDrag();\n\n// rowKey 记录级守卫:当前页任一记录缺 rowKey 字段 → 禁用拖拽(索引兜底态下行身份不稳定)\nconst dragKeysValid = computed(\n () => !dragEnabled.value || body.value.every((line) => line.record[props.rowKey] != null),\n);\nlet dragRowKeyWarned = false;\nwatch(\n dragKeysValid,\n (valid) => {\n if (!valid && !dragRowKeyWarned && import.meta.env.DEV) {\n dragRowKeyWarned = true;\n console.warn(\n `[tu-design] <TableRender> 部分记录缺少 rowKey 字段 \"${props.rowKey}\",已禁用行拖拽排序。`,\n );\n }\n },\n { immediate: true },\n);\n\n/**\n * 本行把手禁用判定:排序激活(动态守卫,取消排序恢复)/ rowKey 缺失 / 行级谓词 false\n * @param line - 行数据\n * @returns 是否禁用本行把手\n */\nfunction rowDragDisabled(line: TableBodyLine): boolean {\n if (instance.sort.value !== undefined || !dragKeysValid.value) return true;\n return dragConfig?.draggable ? !dragConfig.draggable(line.record) : false;\n}\n\n// ---- 实时让位预览(组件层 overlay:引擎零改动、预览期间零事件) ----------------\n// 只有被拖行在预览序中移动,其他行相对序恒定 → 让位后被拖行恰落在光标下,\n// 后续 dragover 命中自身被忽略,天然不振荡(无需几何测量)。\nconst previewKeys = ref<string[] | undefined>(undefined);\n\n/** 显示序:拖拽中按预览序重排(失效 key 过滤、新增行追加,防中途外部 data 变更);平时即引擎序 */\nconst displayBody = computed<TableBodyLine[]>(() => {\n const keys = previewKeys.value;\n if (!keys) return body.value;\n const byKey = new Map(body.value.map((line) => [line.key, line]));\n const ordered: TableBodyLine[] = [];\n for (const key of keys) {\n const line = byKey.get(key);\n if (line) {\n ordered.push(line);\n byKey.delete(key);\n }\n }\n return ordered.concat([...byKey.values()]);\n});\n\n/** 离屏整行快照(仅真实浏览器 dataTransfer 存在时创建);drop/dragend 时移除 */\nlet dragSnapshot: HTMLElement | undefined;\n\nfunction removeDragSnapshot() {\n dragSnapshot?.remove();\n dragSnapshot = undefined;\n}\n\n/**\n * 起拖(把手 dragstart):禁用行不接收;离屏克隆整行作为拖拽快照(幽灵影 = 带边框整行截图)\n * @param line - 源行数据\n * @param event - 原生 dragstart 事件\n */\nfunction onRowDragStart(line: TableBodyLine, event: DragEvent) {\n if (rowDragDisabled(line)) return;\n const tr = (event.target as HTMLElement | null)?.closest?.(\"tr\");\n let image: { el: Element; offsetX: number; offsetY: number } | undefined;\n if (event.dataTransfer && tr) {\n const rect = tr.getBoundingClientRect();\n dragSnapshot = createRowSnapshot(tr);\n image = {\n el: dragSnapshot,\n offsetX: event.clientX - rect.left,\n offsetY: event.clientY - rect.top,\n };\n }\n drag.start(line.key, event, image);\n}\n\n/**\n * 悬停让位:把被拖行移到悬停行在当前预览序中的位置(仅被拖行移动)\n * @param line - 悬停行数据\n * @param event - 原生 dragover 事件\n */\nfunction onRowDragOver(line: TableBodyLine, event: DragEvent) {\n if (!drag.over(line.key, event)) return;\n const dragging = drag.draggingKey.value!;\n const keys = [...(previewKeys.value ?? body.value.map((item) => item.key))];\n const fromIndex = keys.indexOf(dragging);\n const toIndex = keys.indexOf(line.key);\n if (fromIndex < 0 || toIndex < 0 || fromIndex === toIndex) return;\n keys.splice(fromIndex, 1);\n keys.splice(toIndex, 0, dragging);\n previewKeys.value = keys;\n}\n\n/**\n * 成功落位:提交预览序。多跳预览的复合结果 ≡ 单次「源行原位移 → 最终预览位」,\n * 故 from = 原 body 索引、to = 预览序中被拖行最终索引,直接复用引擎 reorderRows。\n * @param line - 落位行数据\n * @param event - 原生 drop 事件\n */\nfunction onRowDrop(line: TableBodyLine, event: DragEvent) {\n const preview = previewKeys.value;\n const result = drag.drop(line.key, event);\n previewKeys.value = undefined;\n removeDragSnapshot();\n if (!result) return;\n const from = body.value.findIndex((item) => item.key === result.fromKey);\n // 有预览:提交最终预览位(含落在自身占位);无预览:落在自身 = 无操作(from === to 引擎守卫)\n const to = preview\n ? preview.indexOf(result.fromKey)\n : body.value.findIndex((item) => item.key === result.toKey);\n if (from < 0 || to < 0) return;\n const payload = instance.reorderRows(from, to);\n if (payload) emit(\"drag-sort\", payload);\n}\n\n/** 拖拽结束(含取消路径):清理状态 + 预览序弹回引擎原序 + 移除离屏快照 */\nfunction onRowDragEnd() {\n drag.end();\n previewKeys.value = undefined;\n removeDragSnapshot();\n}\n\nconst scrollHeight = computed(() => (typeof heightRaw === \"number\" ? `${heightRaw}px` : heightRaw));\n/** 表头 sticky 仅在组件内存在真实纵向滚动盒时生效(fill / virtual),普通模式不挂载,行为不变 */\nconst theadSticky = fill || virtualEnabled;\n/** 滚动区样式:virtual 用固定 height;fill 交给 flex 分配(二者同传以 fill 优先) */\nconst scrollStyle = computed(() => {\n if (fill || !virtualEnabled) return undefined;\n return { height: scrollHeight.value, overflowY: \"auto\" as const };\n});\n\n// ---- 边框与条纹(正交模型)---------------------------------------------------\n// 词汇与语义对齐 naive-ui data-table:bordered 仅控制外框,网格线由 single-* 独立开关,\n// 属性间零耦合、零优先级规则;网格线全部落在单元格/table(#8 纪律),collapse/separate 均渲染。\nconst bordered = props.bordered ?? true;\nconst bottomBordered = props.bottomBordered ?? true;\nconst singleColumn = props.singleColumn ?? false;\nconst singleLine = props.singleLine ?? true;\nconst striped = props.striped ?? false;\n/** 行分割线开关(single-column 关闭) */\nconst rowLinesOn = !singleColumn;\n/** 列分割线开关(single-line 关闭;bordered 不隐含列线,全网格 = :single-line=\"false\") */\nconst columnLinesOn = !singleLine;\n/** 表头/骨架 stickyClass 开关:仅列线抑制(条纹语义仅在表体行,按行奇偶在 TableBodyRow 收敛) */\nconst stickyOpts = { columnLines: columnLinesOn };\n\n/** sticky 表头普通列类:不透明底防行内容透出;分隔线归 th(thead 行级 border 会随行滚走);\n * z-20 高于表体 fixed 列(--z-sticky: 10),纵向滚动行滑过表头时不穿透;\n * 表头 fixed 列的 z 由 stickyStyle inline style(var(--z-sticky-head))提供,inline 优先级天然覆盖此处 class */\nconst theadThClass = theadSticky ? \"sticky top-0 z-20 bg-background\" : \"\";\n/** 表头底线恒挂 th:两种边框模型均渲染(thead 行级 border 已退役);不受任何开关作用——\n * 表头/表体分隔线是可读性硬底线,与行分割线(single-column)语义无关 */\nconst theadLineClass = \"border-b border-border\";\n/** sticky 态 table 改分离边框:preflight 为 border-collapse: collapse,\n * 折叠边框几何归属 table,Chrome 下 sticky th 粘住后自身 border-b 渲染丢失;\n * separate + spacing-0 恢复单元格边框。普通模式保持 collapse,零回归。\n * 外框(bordered)与底线(非 bordered 且 bottom-bordered)画在 table 元素,两种边框模型均渲染。 */\nconst tableClass = [\n theadSticky ? \"border-separate border-spacing-0\" : \"\",\n bordered ? \"border border-border\" : \"\",\n !bordered && bottomBordered ? \"border-b border-border\" : \"\",\n];\n\nconst scrollEl = ref<HTMLElement | null>(null);\nconst theadEl = ref<HTMLElement | null>(null);\n/** 滚动容器内 thead 占据的前缀高度(scrollMargin);表头内容静态,挂载后测量一次 */\nconst theadOffset = ref(0);\n\n// ---- 多行表头测量 --------------------------------------------------\n/** 表头行元素(模板 ref 收集,逐行求高度) */\nconst headerRowEls = ref<(HTMLElement | null)[]>([]);\n/** 各行顶部偏移(前缀和):多行 sticky 表头逐行钉住,避免顶边重叠 */\nconst rowTop = ref<number[]>([]);\n/** 行高兜底:表头行 class 为 h-10(2.5rem = 40px);happy-dom 下 offsetHeight 恒 0 */\nconst HEADER_ROW_FALLBACK = 40;\n\n/**\n * 测量所有表头行高度并派生行顶偏移与 thead 总高(唯一测量源)。\n *\n * 两处口径有意区分:\n * - `rowTop`(多行 sticky 逐行 top)用兜底 h-10(40px)——测量不可用时避免表头行重叠;\n * - `theadOffset`(virtual 的 scrollMargin)用**实测原值**,与既有行为一致\n * (happy-dom 无布局 → 0;真实浏览器 → 真实高度)。\n */\nfunction measureHeaderRows() {\n const raw = headerRowEls.value.map((el) => el?.offsetHeight ?? 0);\n const heights = raw.map((height) => height || HEADER_ROW_FALLBACK);\n rowTop.value = heights.map((_, index) => heights.slice(0, index).reduce((a, h) => a + h, 0));\n if (virtualEnabled) theadOffset.value = raw.reduce((a, h) => a + h, 0);\n}\n\n// 仅 virtual: true 且 height 就绪时创建(配置 setup 期定版,顶层条件分支可安全注册生命周期)\nconst virtualizerRef = virtualEnabled\n ? useVirtualizer(\n computed(() => ({\n count: rows.value.length, // 翻页/重载后行窗口变化 → options 更新(setOptions 自动生效)\n getScrollElement: () => scrollEl.value,\n estimateSize: () => 40,\n overscan: 8,\n getItemKey: (index: number) => rowKeyOf(rows.value[index]!, index), // rowKey 作为虚拟行 key\n scrollMargin: theadOffset.value, // thead 在滚动容器内的 offset 前缀\n })),\n )\n : null;\n\nonMounted(measureHeaderRows);\n// 可见表头树变化(列显隐)→ 行数/单元格可能变化,DOM 更新后重测\nwatch(headerRows, () => void nextTick(measureHeaderRows), { flush: \"post\" });\n\nconst virtualRows = computed(() => (virtualizerRef ? virtualizerRef.value.getVirtualItems() : []));\nconst virtualTotal = computed(() => (virtualizerRef ? virtualizerRef.value.getTotalSize() : 0));\n/** 窗口行 + 对应全量行数据(cells 矩阵已由 body computed 缓存,虚拟化只裁剪 DOM 节点) */\nconst virtualLines = computed(() =>\n virtualRows.value.map((row) => ({ row, line: body.value[row.index]! })),\n);\nconst padTop = computed(() => virtualRows.value[0]?.start ?? 0);\nconst padBottom = computed(() => {\n const items = virtualRows.value;\n return items.length === 0 ? 0 : Math.max(0, virtualTotal.value - items[items.length - 1]!.end);\n});\n\n/** 行高动态测量:measureElement 读 data-index 把实测高度写回(行内容高度可变,不假设固定行高)。\n * 行组件为函数 ref,拿到的是组件实例,需经 $el 取真实 tr。\n * @param node - 函数 ref 收到的行元素或组件实例\n */\nfunction measureRow(node: Element | ComponentPublicInstance | null) {\n const el = node instanceof Element ? node : (node?.$el as Element | undefined);\n if (el instanceof Element) virtualizerRef?.value.measureElement(el);\n}\n\n/**\n * aria-sort 仅在该列当前被排序时标注\n * @param column - 列配置\n * @returns 当前排序方向对应的 aria-sort 值;未排序返回 undefined\n */\nfunction ariaSort(column: TableColumnOptions): \"ascending\" | \"descending\" | undefined {\n if (instance.sort.value?.key !== column.key) return undefined;\n return instance.sort.value.direction === \"asc\" ? \"ascending\" : \"descending\";\n}\n\nfunction sortMark(column: TableColumnOptions): string {\n const direction = instance.sort.value?.key === column.key ? instance.sort.value.direction : \"\";\n return direction === \"asc\" ? \"↑\" : direction === \"desc\" ? \"↓\" : \"\";\n}\n\nfunction onSort(key: string) {\n instance.toggleSort(key);\n emit(\"sort-change\", instance.sort.value);\n}\n\nfunction onPageIndex(pageIndex: number) {\n instance.setPageIndex(pageIndex);\n lastEmittedPage.pageIndex = pageIndex;\n emit(\"update:page-index\", pageIndex);\n}\n\nfunction onPageSize(pageSize: number) {\n instance.setPageSize(pageSize);\n lastEmittedPage.pageSize = pageSize;\n emit(\"update:page-size\", pageSize);\n}\n\n// ---- 受控模式(v-model):page 投影 → update:* 通知 ---------------------------\n// 仅 page-index/page-size 至少一方受控时安装;lastEmittedPage 去重——\n// 动作路径已 emit 过的值不再重复发(受控回写/内部归位只通知「未通知过的」变化)\nconst pageControlled = () => props.pageIndex !== undefined || props.pageSize !== undefined;\nconst lastEmittedPage = {\n pageIndex: undefined as number | undefined,\n pageSize: undefined as number | undefined,\n};\n\nif (pageControlled()) {\n watch(\n () => [instance.page.pageIndex, instance.page.pageSize] as const,\n ([pageIndex, pageSize]) => {\n if (pageIndex !== lastEmittedPage.pageIndex) {\n lastEmittedPage.pageIndex = pageIndex;\n emit(\"update:page-index\", pageIndex);\n }\n if (pageSize !== lastEmittedPage.pageSize) {\n lastEmittedPage.pageSize = pageSize;\n emit(\"update:page-size\", pageSize);\n }\n },\n );\n}\n\nfunction onRowClick(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-click\", record, index, event);\n}\n\nfunction onRowDblclick(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-dblclick\", record, index, event);\n}\n\nfunction onRowContextmenu(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-contextmenu\", record, index, event);\n}\n\nfunction onCellClick(record: DataRecord, columnKey: string, index: number, event: MouseEvent) {\n emit(\"cell-click\", record, columnKey, index, event);\n}\n\ndefineExpose({\n table: instance.table,\n page: instance.page,\n // 不暴露 sort:与受控 sort prop 同名,实例上互相遮蔽(TS6 起 h()/mount 类型检查拒绝该组件);\n // 排序状态经 sort-change 事件与 definition.sort 投影获取\n loading: instance.loading,\n error: instance.error,\n visibleKeys: instance.visibleKeys,\n setVisibleKeys: instance.setVisibleKeys,\n reload: instance.reload,\n toggleSort: onSort,\n setPageIndex: onPageIndex,\n setPageSize: onPageSize,\n selection: instance.selection,\n selectedKeys: instance.selectedKeys,\n setSelection: instance.setSelection,\n clearSelection: instance.clearSelection,\n});\n</script>\n\n<template>\n <div :class=\"cn('w-full', fill && 'flex h-full min-h-0 flex-col', $attrs.class)\">\n <!-- 搜索区 + 列设置触发器:同行右对齐(items-end);无搜索时触发器位于表格上方(showSearch=false 关闭搜索区) -->\n <div\n v-if=\"showSearchArea || showColumnSettings\"\n :class=\"cn('mb-2 flex items-end justify-between gap-2', fill && 'shrink-0')\"\n >\n <FormRender\n v-if=\"showSearchArea\"\n class=\"min-w-0 flex-1\"\n :definition=\"search\"\n :searchable=\"search?.actions ? undefined : true\"\n @search=\"onSearch\"\n @reset=\"onReset\"\n />\n\n <!-- 列设置:Popover 面板(最少一列 / 重置 / 不含选择列);\n 触发钮 Tooltip 手动受控开合(Tooltip 与 Popover 触发器嵌套会吞点击,故并列渲染、不走 hover 自动触发) -->\n <template v-if=\"showColumnSettings\">\n <Popover align=\"end\" content-class=\"w-56 p-0\">\n <Button\n variant=\"ghost\"\n size=\"icon\"\n aria-label=\"列设置\"\n aria-haspopup=\"true\"\n @pointerenter=\"settingsTipOpen = true\"\n @pointerleave=\"settingsTipOpen = false\"\n >\n <!-- lucide Settings2(内联 SVG,跟随项目图标现状) -->\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M20 7h-9\" />\n <path d=\"M14 17H5\" />\n <circle cx=\"17\" cy=\"17\" r=\"3\" />\n <circle cx=\"7\" cy=\"7\" r=\"3\" />\n </svg>\n </Button>\n <template #content>\n <div class=\"flex items-center justify-end gap-3 px-3 py-2\">\n <button\n type=\"button\"\n class=\"text-muted-foreground hover:text-foreground cursor-pointer text-xs disabled:cursor-not-allowed disabled:opacity-50\"\n :disabled=\"allColumnsVisible\"\n @click=\"selectAllColumns\"\n >\n 全选\n </button>\n <button\n type=\"button\"\n class=\"text-muted-foreground hover:text-foreground cursor-pointer text-xs\"\n @click=\"resetColumns\"\n >\n 重置\n </button>\n </div>\n <Separator />\n <div class=\"max-h-64 overflow-y-auto py-1\">\n <div\n v-for=\"row in panelRows\"\n :key=\"row.key\"\n data-column-item\n :data-column-key=\"row.isGroup ? undefined : row.key\"\n :data-column-group=\"row.isGroup ? row.path : undefined\"\n class=\"hover:bg-accent/50 flex h-8 cursor-pointer items-center gap-2 px-3\"\n :style=\"{ paddingLeft: `${12 + row.depth * 12}px` }\"\n @click=\"onPanelRowClick(row)\"\n >\n <Checkbox\n :checked=\"row.isGroup ? groupCheckedState(row) : isColumnVisible(row.key)\"\n :disabled=\"row.isGroup ? false : !canHideColumn(row.key)\"\n @update:checked=\"onPanelRowClick(row)\"\n @click.stop\n />\n <span class=\"min-w-0 flex-1 truncate\">{{ row.node.title }}</span>\n <!-- 有效 fixed 列(数字 width)标识:仅叶子 -->\n <svg\n v-if=\"\n !row.isGroup &&\n (row.node as TableColumnOptions).fixed !== undefined &&\n typeof (row.node as TableColumnOptions).width === 'number'\n \"\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"text-muted-foreground size-3 shrink-0\"\n aria-hidden=\"true\"\n >\n <path d=\"M12 17v5\" />\n <path\n d=\"M9 10.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V7h1a2 2 0 0 0 0-4H8a2 2 0 0 0 0 4h1z\"\n />\n </svg>\n </div>\n </div>\n </template>\n </Popover>\n <!-- 纯受控气泡(无默认插槽,不渲染触发器):开合由触发钮 pointerenter/leave 驱动 -->\n <Tooltip :open=\"settingsTipOpen\" content=\"列设置\" />\n </template>\n </div>\n\n <!-- 滚动容器:横向滚动时 fixed 列 sticky 生效;virtual/fill 模式兼任纵向滚动(分页条不参与滚动) -->\n <div\n ref=\"scrollEl\"\n :class=\"cn('overflow-x-auto', fill && 'min-h-0 flex-1 overflow-y-auto')\"\n :style=\"scrollStyle\"\n >\n <table\n class=\"w-full caption-bottom text-sm\"\n :class=\"tableClass\"\n :style=\"tableMinWidth > 0 ? { minWidth: `${tableMinWidth}px` } : undefined\"\n >\n <thead ref=\"theadEl\">\n <tr\n v-for=\"(cells, rowIndex) in headerRows\"\n :key=\"rowIndex\"\n :ref=\"(el) => (headerRowEls[rowIndex] = el as HTMLElement | null)\"\n :style=\"headerRowStyle(rowIndex)\"\n >\n <!-- 选择列:checkbox 型表头为本页全选三态;radio 型占位;视作最左固定列 -->\n <th\n v-if=\"hasSelection && rowIndex === 0\"\n scope=\"col\"\n :rowspan=\"headerRows.length\"\n class=\"h-10 w-12 px-2 text-center align-middle font-medium text-muted-foreground\"\n :class=\"[\n stickyClass(stickyOf, SELECTION_CELL, stickyOpts),\n theadThClass,\n theadLineClass,\n columnLinesOn ? 'border-r border-border' : '',\n ]\"\n :style=\"[\n { width: `${selection.width}px` },\n stickyStyle(stickyOf, SELECTION_CELL, true),\n ]\"\n >\n <Checkbox\n v-if=\"selection.type === 'checkbox'\"\n :checked=\"headerIndeterminate ? 'indeterminate' : headerChecked\"\n :aria-label=\"'全选本页'\"\n @update:checked=\"onHeaderSelect\"\n />\n </th>\n <!-- 拖拽把手列表头:占位(对齐 radio 选择列范式);视作最左固定列(紧随选择列) -->\n <th\n v-if=\"dragEnabled && rowIndex === 0\"\n scope=\"col\"\n :rowspan=\"headerRows.length\"\n class=\"h-10 px-1 text-center align-middle font-medium text-muted-foreground\"\n :class=\"[\n stickyClass(stickyOf, DRAG_CELL, stickyOpts),\n theadThClass,\n theadLineClass,\n columnLinesOn ? 'border-r border-border' : '',\n ]\"\n :style=\"[{ width: `${dragWidth}px` }, stickyStyle(stickyOf, DRAG_CELL, true)]\"\n >\n <span class=\"sr-only\">拖拽排序</span>\n </th>\n <th\n v-for=\"(cell, cellIndex) in cells\"\n :key=\"cell.key\"\n :scope=\"cell.isGroup ? 'colgroup' : 'col'\"\n :colspan=\"cell.colSpan > 1 ? cell.colSpan : undefined\"\n :rowspan=\"cell.rowSpan > 1 ? cell.rowSpan : undefined\"\n class=\"h-10 px-2 align-middle font-medium text-muted-foreground\"\n :class=\"[\n cell.isGroup ? undefined : stickyClass(stickyOf, cell.key, stickyOpts),\n theadThClass,\n theadLineClass,\n headerCellClass(cell, cellIndex === cells.length - 1),\n ]\"\n :style=\"[\n cell.isGroup\n ? { textAlign: headerCellAlign(cell) }\n : {\n width: widthOf((cell.node as TableColumnOptions).width),\n textAlign: headerCellAlign(cell),\n },\n cell.isGroup ? groupStickyStyle(cell) : stickyStyle(stickyOf, cell.key, true),\n ]\"\n :aria-sort=\"cell.isGroup ? undefined : ariaSort(cell.node as TableColumnOptions)\"\n >\n <button\n v-if=\"!cell.isGroup && (cell.node as TableColumnOptions).sortable\"\n type=\"button\"\n class=\"inline-flex items-center gap-1 hover:text-foreground\"\n @click=\"onSort((cell.node as TableColumnOptions).key)\"\n >\n {{ (cell.node as TableColumnOptions).title }}\n <span aria-hidden=\"true\" class=\"text-xs\">{{\n sortMark(cell.node as TableColumnOptions)\n }}</span>\n </button>\n <template v-else>{{ cell.node.title }}</template>\n </th>\n </tr>\n </thead>\n\n <tbody class=\"[&>tr:last-child>td]:border-b-0\">\n <!-- 加载态:固定 5 行骨架;选择列一并占位;骨架不虚拟化;loading 判定优先 -->\n <template v-if=\"loading\">\n <tr v-for=\"row in SKELETON_ROWS\" :key=\"row\" data-skeleton>\n <td\n v-if=\"hasSelection\"\n class=\"p-2 text-center align-middle\"\n :class=\"[\n rowLinesOn ? 'border-b border-border' : '',\n columnLinesOn ? 'border-r border-border' : '',\n stickyClass(stickyOf, SELECTION_CELL, stickyOpts),\n ]\"\n :style=\"stickyStyle(stickyOf, SELECTION_CELL, false)\"\n >\n <Skeleton class=\"size-4\" />\n </td>\n <td\n v-if=\"dragEnabled\"\n class=\"p-1 text-center align-middle\"\n :class=\"[\n rowLinesOn ? 'border-b border-border' : '',\n columnLinesOn ? 'border-r border-border' : '',\n stickyClass(stickyOf, DRAG_CELL, stickyOpts),\n ]\"\n :style=\"stickyStyle(stickyOf, DRAG_CELL, false)\"\n >\n <Skeleton class=\"size-4\" />\n </td>\n <td\n v-for=\"(column, colIndex) in visibleColumns\"\n :key=\"column.key\"\n class=\"p-2 align-middle\"\n :class=\"[\n rowLinesOn ? 'border-b border-border' : '',\n columnLinesOn && colIndex < visibleColumns.length - 1\n ? 'border-r border-border'\n : '',\n stickyClass(stickyOf, column.key, stickyOpts),\n ]\"\n :style=\"[\n { textAlign: column.align ?? 'center' },\n stickyStyle(stickyOf, column.key, false),\n ]\"\n >\n <Skeleton class=\"h-4 w-full\" />\n </td>\n </tr>\n </template>\n\n <!-- 错误态:error 优先于正常数据;插槽可自定义(slot props { error, retry }) -->\n <template v-else-if=\"showError\">\n <tr data-error>\n <td :colspan=\"columnCount\" class=\"p-8 text-center text-muted-foreground\">\n <slot name=\"error\" :error=\"loadError\" :retry=\"retry\">\n <div class=\"flex flex-col items-center gap-3\">\n <p>{{ loadError?.message ?? \"加载失败\" }}</p>\n <Button variant=\"outline\" size=\"sm\" @click=\"retry\">重试</Button>\n </div>\n </slot>\n </td>\n </tr>\n </template>\n\n <!-- 虚拟滚动:窗口行 + 前后占位行(总高撑开滚动区间;行高经 measureElement 动态测量) -->\n <template v-else-if=\"virtualEnabled\">\n <tr aria-hidden=\"true\" data-virtual-pad :style=\"{ height: `${padTop}px` }\">\n <td :colspan=\"columnCount\" class=\"border-0 p-0\"></td>\n </tr>\n <TableBodyRow\n v-for=\"item in virtualLines\"\n :key=\"item.line.key\"\n :ref=\"measureRow\"\n :data-index=\"item.row.index\"\n :line=\"item.line\"\n :class=\"striped && item.line.index % 2 === 1 ? 'bg-muted/30' : undefined\"\n :row-lines=\"rowLinesOn\"\n :column-lines=\"columnLinesOn\"\n :striped=\"striped\"\n :columns=\"visibleColumns\"\n :selection=\"hasSelection ? selection.type : undefined\"\n :selected=\"selectedKeys.has(item.line.key)\"\n :sticky=\"stickyOf\"\n :tree-indent=\"tree ? treeIndent : undefined\"\n :drag-column=\"dragEnabled\"\n :drag-disabled=\"rowDragDisabled(item.line)\"\n :dragging=\"drag.draggingKey.value === item.line.key\"\n @select=\"(checked: boolean) => onRowSelect(item.line, checked)\"\n @row-click=\"onRowClick(item.line.record, item.line.index, $event)\"\n @row-dblclick=\"onRowDblclick(item.line.record, item.line.index, $event)\"\n @row-contextmenu=\"onRowContextmenu(item.line.record, item.line.index, $event)\"\n @cell-click=\"\n (columnKey: string, event: MouseEvent) =>\n onCellClick(item.line.record, columnKey, item.line.index, event)\n \"\n @drag-start=\"onRowDragStart(item.line, $event)\"\n @drag-over=\"onRowDragOver(item.line, $event)\"\n @drop=\"onRowDrop(item.line, $event)\"\n @drag-end=\"onRowDragEnd()\"\n />\n <tr aria-hidden=\"true\" data-virtual-pad :style=\"{ height: `${padBottom}px` }\">\n <td :colspan=\"columnCount\" class=\"border-0 p-0\"></td>\n </tr>\n </template>\n\n <template v-else>\n <TableBodyRow\n v-for=\"line in displayBody\"\n :key=\"line.key\"\n :line=\"line\"\n :class=\"striped && line.index % 2 === 1 ? 'bg-muted/30' : undefined\"\n :row-lines=\"rowLinesOn\"\n :column-lines=\"columnLinesOn\"\n :striped=\"striped\"\n :columns=\"visibleColumns\"\n :selection=\"hasSelection ? selection.type : undefined\"\n :selected=\"selectedKeys.has(line.key)\"\n :sticky=\"stickyOf\"\n :tree-indent=\"tree ? treeIndent : undefined\"\n :drag-column=\"dragEnabled\"\n :drag-disabled=\"rowDragDisabled(line)\"\n :dragging=\"drag.draggingKey.value === line.key\"\n @select=\"(checked: boolean) => onRowSelect(line, checked)\"\n @row-click=\"onRowClick(line.record, line.index, $event)\"\n @row-dblclick=\"onRowDblclick(line.record, line.index, $event)\"\n @row-contextmenu=\"onRowContextmenu(line.record, line.index, $event)\"\n @cell-click=\"\n (columnKey: string, event: MouseEvent) =>\n onCellClick(line.record, columnKey, line.index, event)\n \"\n @drag-start=\"onRowDragStart(line, $event)\"\n @drag-over=\"onRowDragOver(line, $event)\"\n @drop=\"onRowDrop(line, $event)\"\n @drag-end=\"onRowDragEnd()\"\n />\n </template>\n\n <!-- 空态:横跨全列的单单元格,不虚拟化;错误态优先 -->\n <tr v-if=\"!loading && !showError && body.length === 0\" data-empty>\n <td :colspan=\"columnCount\" class=\"p-8 text-center text-muted-foreground\">\n <slot name=\"empty\">{{ emptyText ?? \"暂无数据\" }}</slot>\n </td>\n </tr>\n </tbody>\n </table>\n </div>\n\n <!-- 手动接线(须经 onPageIndex/onPageSize 包装器保留受控去重);size select 保持现状。\n 分页条不再补 border-t——分隔线由 table 底线承担(bordered 外框 / bottom-bordered) -->\n <TablePagination\n v-if=\"showPaginationBar\"\n :class=\"cn(fill && 'shrink-0')\"\n :page-index=\"instance.page.pageIndex\"\n :page-size=\"instance.page.pageSize\"\n :page-size-opts=\"instance.page.pageSizeOpts\"\n :total=\"instance.page.total\"\n :show-size-select=\"true\"\n @update:page-index=\"onPageIndex\"\n @update:page-size=\"onPageSize\"\n />\n </div>\n</template>\n"
43
43
  },
44
44
  {
45
45
  "path": "table-render/column-renders.ts",
@@ -81,7 +81,7 @@
81
81
  "path": "table-render/sticky.ts",
82
82
  "type": "registry:lib",
83
83
  "target": "components/ui/table-render/sticky.ts",
84
- "content": "export interface StickyInfo {\n side: \"left\" | \"right\";\n offset: number;\n edge: boolean;\n}\n\nexport type StickyMap = Map<string, StickyInfo>;\n\n/**\n * sticky 定位样式;head 为 true 时 z-index 高于表体(表头压住表体 sticky)\n * @param sticky - 列 key → sticky 信息的映射\n * @param key - 列 key\n * @param head - 是否为表头单元格(true 使用更高的 --z-sticky-head)\n * @returns inline style 对象;列非 sticky 时返回 undefined\n */\nexport function stickyStyle(sticky: StickyMap, key: string, head = false) {\n const info = sticky.get(key);\n if (!info) return undefined;\n return {\n position: \"sticky\" as const,\n [info.side]: `${info.offset}px`,\n zIndex: head ? \"var(--z-sticky-head)\" : \"var(--z-sticky)\",\n };\n}\n\n/**\n * sticky 底色(防滚动透出)与交界分隔边框\n * @param sticky - 列 key → sticky 信息的映射\n * @param key - 列 key\n * @returns class 列表(未命中项为空串);列非 sticky 时返回 undefined\n */\nexport function stickyClass(sticky: StickyMap, key: string) {\n const info = sticky.get(key);\n if (!info) return undefined;\n return [\n \"bg-background\",\n info.side === \"left\" && info.edge ? \"border-r border-border\" : \"\",\n info.side === \"right\" && info.edge ? \"border-l border-border\" : \"\",\n ];\n}\n"
84
+ "content": "export interface StickyInfo {\n side: \"left\" | \"right\";\n offset: number;\n edge: boolean;\n}\n\nexport type StickyMap = Map<string, StickyInfo>;\n\n/**\n * sticky 定位样式;head 为 true 时 z-index 高于表体(表头压住表体 sticky)\n * @param sticky - 列 key → sticky 信息的映射\n * @param key - 列 key\n * @param head - 是否为表头单元格(true 使用更高的 --z-sticky-head)\n * @returns inline style 对象;列非 sticky 时返回 undefined\n */\nexport function stickyStyle(sticky: StickyMap, key: string, head = false) {\n const info = sticky.get(key);\n if (!info) return undefined;\n return {\n position: \"sticky\" as const,\n [info.side]: `${info.offset}px`,\n zIndex: head ? \"var(--z-sticky-head)\" : \"var(--z-sticky)\",\n };\n}\n\n/** stickyClass 行为开关(边框/条纹正交模型的传导参数) */\nexport interface StickyClassOptions {\n /**\n * 列线开启:列间边界由统一列线(td/th 的 border-r)绘制,stickyClass 抑制交界边框——\n * separate 模型下前格 border-r 与 sticky 交界 border-l 会贴叠成 2px 双线,必须二选一\n */\n columnLines?: boolean;\n /**\n * 奇数条纹行:不透明底换 muted/30 与 background 的 color-mix 固色——\n * 保持防滚动透出的不透明性(bg-muted/30 是半透明,sticky 列透出滚动内容),与 tr 层条纹视觉对齐\n */\n striped?: boolean;\n}\n\n/**\n * sticky 底色(防滚动透出)与交界分隔边框\n * @param sticky - 列 key → sticky 信息的映射\n * @param key - 列 key\n * @param opts - 行为开关:columnLines 抑制交界边框(统一列线接管);striped 输出不透明条纹固色\n * @returns class 列表(未命中项为空串);列非 sticky 时返回 undefined\n */\nexport function stickyClass(sticky: StickyMap, key: string, opts: StickyClassOptions = {}) {\n const info = sticky.get(key);\n if (!info) return undefined;\n return [\n opts.striped\n ? \"bg-[color-mix(in_oklab,var(--color-muted)_30%,var(--color-background))]\"\n : \"bg-background\",\n !opts.columnLines && info.side === \"left\" && info.edge ? \"border-r border-border\" : \"\",\n !opts.columnLines && info.side === \"right\" && info.edge ? \"border-l border-border\" : \"\",\n ];\n}\n"
85
85
  },
86
86
  {
87
87
  "path": "table-render/types.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "tabs",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:ui",
6
6
  "description": "选项卡:基于 Ark UI Tabs 原语,键盘导航与受控/非受控双模式。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "textarea",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:ui",
6
6
  "description": "多行文本输入:纯样式封装,支持 invalid 校验态。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "timeline",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:ui",
6
6
  "description": "时间轴:数据驱动 items 渲染竖向事件流,支持单列/左右交替、五种语义节点色与空心节点、#item 作用域插槽自定义内容。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "toast",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:ui",
6
6
  "description": "全局轻提示:ToastProvider 在应用根部挂载一次,useToast() 提供命令式 API(success/error/info/warning/loading/promise/dismiss);基于 Ark UI Toast 原语,语义 type 映射主题 token 配色。",
7
7
  "registryDependencies": ["icon-shared", "utils", "overlay-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "tokens",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:style",
6
6
  "description": "Tailwind CSS v4 语义 tokens(shadcn 官方 v4 集合)。",
7
7
  "dependencies": ["tw-animate-css@^1.4.0"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "tooltip",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:ui",
6
6
  "description": "文字提示气泡:悬停触发,基于 Ark UI Tooltip 原语,支持 asChild 与延迟配置。",
7
7
  "registryDependencies": ["utils", "overlay-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "tree-select",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:ui",
6
6
  "description": "树形下拉选择:一站式 props 驱动,支持单/多选、勾选级联、过滤与多标签折叠。",
7
7
  "registryDependencies": ["icon-shared", "tree-shared", "utils", "date-shared", "overlay-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "tree-shared",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:ui",
6
6
  "description": "树形数据层与共享类型(移植自 treemate v0.3.11,MIT)。",
7
7
  "registryDependencies": ["icon-shared", "utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "utils",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:lib",
6
6
  "description": "cn 类名合并工具(clsx + tailwind-merge)。",
7
7
  "dependencies": ["clsx@^2.1.1", "tailwind-merge@^3.7.0", "class-variance-authority@^0.7.1"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "week-picker",
4
- "version": "0.5.14",
4
+ "version": "0.5.15",
5
5
  "type": "registry:ui",
6
6
  "description": "周选择器:输入框 + 日历弹层,点任意可选日归一到所在周并整周高亮,值以 \"yyyy-MM-dd\"(所在周起始日)字符串受控;周起点跟随 locale(zh-CN 周一起始),输入框回显 \"start ~ end\"。",
7
7
  "registryDependencies": ["utils", "date-shared", "calendar"],