@tu-design/vue 0.5.1 → 0.5.3
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.
- package/dist/index.d.mts +398 -101
- package/dist/index.mjs +524 -179
- package/dist/registry/vue/alert-dialog.json +1 -1
- package/dist/registry/vue/alert.json +1 -1
- package/dist/registry/vue/avatar-group.json +1 -1
- package/dist/registry/vue/avatar.json +1 -1
- package/dist/registry/vue/badge.json +1 -1
- package/dist/registry/vue/button.json +1 -1
- package/dist/registry/vue/calendar.json +1 -1
- package/dist/registry/vue/card.json +1 -1
- package/dist/registry/vue/cascader.json +1 -1
- package/dist/registry/vue/checkbox.json +1 -1
- package/dist/registry/vue/context-menu.json +1 -1
- package/dist/registry/vue/currency-input.json +1 -1
- package/dist/registry/vue/date-picker.json +1 -1
- package/dist/registry/vue/date-range-picker.json +1 -1
- package/dist/registry/vue/date-shared.json +1 -1
- package/dist/registry/vue/dialog.json +1 -1
- package/dist/registry/vue/drawer.json +1 -1
- package/dist/registry/vue/dropdown-menu.json +1 -1
- package/dist/registry/vue/empty.json +1 -1
- package/dist/registry/vue/form-render.json +6 -6
- package/dist/registry/vue/form.json +1 -1
- package/dist/registry/vue/icon-shared.json +1 -1
- package/dist/registry/vue/input.json +1 -1
- package/dist/registry/vue/label.json +1 -1
- package/dist/registry/vue/month-picker.json +1 -1
- package/dist/registry/vue/number-input.json +1 -1
- package/dist/registry/vue/overlay-shared.json +7 -1
- package/dist/registry/vue/password-input.json +1 -1
- package/dist/registry/vue/pin-input.json +1 -1
- package/dist/registry/vue/popconfirm.json +1 -1
- package/dist/registry/vue/popover.json +2 -2
- package/dist/registry/vue/progress.json +1 -1
- package/dist/registry/vue/radio-group.json +1 -1
- package/dist/registry/vue/registry.json +52 -52
- package/dist/registry/vue/select.json +1 -1
- package/dist/registry/vue/separator.json +1 -1
- package/dist/registry/vue/skeleton.json +1 -1
- package/dist/registry/vue/slider.json +1 -1
- package/dist/registry/vue/slot.json +1 -1
- package/dist/registry/vue/spin.json +1 -1
- package/dist/registry/vue/switch.json +1 -1
- package/dist/registry/vue/table-render.json +4 -4
- package/dist/registry/vue/tabs.json +1 -1
- package/dist/registry/vue/textarea.json +1 -1
- package/dist/registry/vue/timeline.json +1 -1
- package/dist/registry/vue/toast.json +1 -1
- package/dist/registry/vue/tokens.json +1 -1
- package/dist/registry/vue/tooltip.json +1 -1
- package/dist/registry/vue/tree-select.json +1 -1
- package/dist/registry/vue/tree-shared.json +1 -1
- package/dist/registry/vue/utils.json +1 -1
- package/dist/registry/vue/week-picker.json +1 -1
- package/dist/registry/vue/year-picker.json +1 -1
- 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.
|
|
4
|
+
"version": "0.5.3",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "配置驱动表格渲染器:defineTable 聚合 TanStack Table 实例与列配置,静态/服务端双模式(onLoad 回写分页排序),搜索表单联动(search 接 FormRender),左右固定列 sticky 横向滚动,表体虚拟滚动(virtual + height,TanStack Virtual 动态测量行高),树形数据(tree:子行展开/收起、depth 缩进、caret 位于首列),列显隐(columnSettings 面板 + visibleKeys 受控),错误态占位与重试(#error 插槽 + load-error),ellipsis 支持 tooltip 形态,v-model 受控(pageIndex/pageSize/sort/selectedKeys),Ark Pagination 分页条 + 原生 select 每页条数,排序表头 aria-sort、加载骨架与空态插槽,语义化 table + Tailwind tokens。",
|
|
7
7
|
"registryDependencies": [
|
|
@@ -32,13 +32,13 @@
|
|
|
32
32
|
"path": "table-render/TablePagination.vue",
|
|
33
33
|
"type": "registry:component",
|
|
34
34
|
"target": "components/ui/table-render/TablePagination.vue",
|
|
35
|
-
"content": "<script setup lang=\"ts\">\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\nconst props = defineProps
|
|
35
|
+
"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/动作并按 R13 单页自隐藏;\n * 与手动分页 props 同传时以 definition 为准(DEV 警告,R29/R4 对齐) */\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// R29 输入解析在 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// R29: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 模式按 R13 单页自隐藏;手动模式须 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 模式经实例动作接线(R29);事件恒 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,跳过段用省略号(D12) */\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 <!-- R31:不带 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
36
|
},
|
|
37
37
|
{
|
|
38
38
|
"path": "table-render/TableRender.vue",
|
|
39
39
|
"type": "registry:component",
|
|
40
40
|
"target": "components/ui/table-render/TableRender.vue",
|
|
41
|
-
"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, 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 { 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 TableColumnOptions,\n TableLoadParams,\n TableRenderDefinition,\n TableSelectionOptions,\n TreeOptions,\n} from \"./types\";\nimport { useTableRender } from \"./useTableRender\";\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<TableColumnOptions[]> },\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 /** 每页条数 / 受控每页条数(D11):传入即受控(pageIndex 未受控时 R9 归位内部处理并通知) */\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 /** 受控页码(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 警告(R26,definition 优先) */\n defaultVisibleKeys: { type: Array as PropType<string[]> },\n /** 列设置触发器/面板开关(默认 true);false 时不渲染 UI,受控 API 不受影响 */\n columnSettings: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n});\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}>();\n\ndefineSlots<{\n empty?: () => VNodeChild;\n /** 错误态占位(服务端模式 onLoad 失败时渲染,优先于数据区) */\n error?: (props: { error: Error | undefined; retry: () => void }) => VNodeChild;\n}>();\n\n/** 加载态骨架行数(R14) */\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}\nconst instance =\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 pageIndex: () => props.pageIndex,\n pageSize: () => props.pageSize,\n sort: () => props.sort,\n selectedKeys: () => props.selectedKeys,\n columnVisibility: props.definition?.columnVisibility,\n defaultVisibleKeys: () => props.defaultVisibleKeys,\n visibleKeys: () => props.visibleKeys,\n });\n// 拆分式已传 rowKey;聚合式由组件回填(S1:选择引擎依赖 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,R20–R26) ------------------------------------\n// R26:聚合式(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/** 当前搜索表单值快照(浅拷贝;无 search 时为空对象) */\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/** 内部加载态 ∪ 外部受控加载态(R14) */\nconst loading = computed(() => props.loading === true || instance.loading.value);\nconst showPagination = computed(() => Math.ceil(instance.page.total / instance.page.pageSize) > 1);\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,R20–R26) -------------------------------------\nconst visibleKeySet = computed(() => new Set(instance.visibleKeys.value));\n/** 可见业务列(columns 原序子集):header/body/骨架/colspan/sticky 全部基于此渲染(R23/R25) */\nconst visibleColumns = computed(() =>\n columns.value.filter((column) => visibleKeySet.value.has(column.key)),\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/** 最少一列(R20):唯一可见列不可隐藏 */\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 // R21:恢复 defaultVisibleKeys;未配置 = 全部可见\n instance.setVisibleKeys(instance.defaultVisibleKeys ?? columns.value.map((column) => column.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 与骨架行,S8/R23) */\nconst columnCount = computed(() => visibleColumns.value.length + (hasSelection.value ? 1 : 0));\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/** sticky 单元格映射(纯渲染层 computed,不进 TanStack pinning state):\n * 选择列视作最左 fixed 列参与累计(offset 0);fixed-left 按列序累加,\n * fixed-right 从最右列反向累计。edge = 该 sticky 组朝滚动方向的交界列(加分隔边框)。\n * 全部基于**可见集**(R23):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, { side: \"left\", offset: 0, edge: lefts.length === 0 });\n acc = selection.value.width;\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/** 表头全选三态(S10):本页可选行与选中集求交派生(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/** 行选择控件切换;radio 不可取消由引擎 S4 守卫,不选中态点击传 checked=true */\nfunction onRowSelect(line: { key: string }, checked: boolean) {\n instance.toggleRowSelected(line.key, checked);\n}\n\n// 选中集变化 → 对外事件(S7):排序/翻页不改变选中集,故不会误发\nwatch(instance.selectedKeys, (keys) => {\n emit(\"selection-change\", [...selection.value.value]);\n emit(\"update:selected-keys\", [...keys]);\n});\n\n/** 行 → 单元格值矩阵:render > formatter > record[key](R17) */\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 /** 行级可选过滤(S5):selectable 谓词交由引擎 enableRowSelection 判定 */\n canSelect: row.getCanSelect(),\n // 可见列的值矩阵(列显隐只裁剪列;R25 状态不受影响)\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/** 行主键:rowKey 字段缺失时以行索引兜底(R3) */\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;\nif (virtualRaw === true && heightRaw === undefined) {\n console.warn(\"[tu-design] <TableRender> virtual 需要配置 height,已降级普通渲染。\");\n}\nconst virtualEnabled = virtualRaw === true && heightRaw !== undefined;\nconst scrollHeight = computed(() => (typeof heightRaw === \"number\" ? `${heightRaw}px` : heightRaw));\n\nconst scrollEl = ref<HTMLElement | null>(null);\nconst theadEl = ref<HTMLElement | null>(null);\n/** 滚动容器内 thead 占据的前缀高度(scrollMargin);表头内容静态,挂载后测量一次 */\nconst theadOffset = ref(0);\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(() => {\n if (virtualEnabled) theadOffset.value = theadEl.value?.offsetHeight ?? 0;\n});\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。 */\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/** aria-sort 仅在该列当前被排序时标注(R16) */\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: instance.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', $attrs.class)\">\n <!-- 搜索区 + 列设置触发器:同行右对齐(items-end);无搜索时触发器位于表格上方 -->\n <div v-if=\"search || showColumnSettings\" class=\"mb-2 flex items-end justify-between gap-2\">\n <FormRender\n v-if=\"search\"\n class=\"min-w-0 flex-1\"\n :definition=\"search\"\n searchable\n @search=\"onSearch\"\n @reset=\"onReset\"\n />\n\n <!-- 列设置:Popover 面板(R20 最少一列 / R21 重置 / R22 不含选择列);\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=\"column in columns\"\n :key=\"column.key\"\n data-column-item\n :data-column-key=\"column.key\"\n class=\"hover:bg-accent/50 flex h-8 cursor-pointer items-center gap-2 px-3\"\n @click=\"toggleColumnVisible(column.key)\"\n >\n <Checkbox\n :checked=\"isColumnVisible(column.key)\"\n :disabled=\"!canHideColumn(column.key)\"\n @update:checked=\"toggleColumnVisible(column.key)\"\n @click.stop\n />\n <span class=\"min-w-0 flex-1 truncate\">{{ column.title }}</span>\n <!-- 有效 fixed 列(数字 width)标识 -->\n <svg\n v-if=\"column.fixed !== undefined && typeof column.width === 'number'\"\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 模式兼任纵向滚动(分页条不参与滚动) -->\n <div\n ref=\"scrollEl\"\n class=\"overflow-x-auto\"\n :style=\"virtualEnabled ? { height: scrollHeight, overflowY: 'auto' } : undefined\"\n >\n <table class=\"w-full caption-bottom text-sm\">\n <thead ref=\"theadEl\" class=\"[&_tr]:border-b\">\n <tr>\n <!-- 选择列:checkbox 型表头为本页全选三态(S3/S10);radio 型占位;视作最左固定列 -->\n <th\n v-if=\"hasSelection\"\n scope=\"col\"\n class=\"h-10 w-12 px-2 align-middle font-medium text-muted-foreground\"\n :class=\"stickyClass(stickyOf, SELECTION_CELL)\"\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 <th\n v-for=\"column in visibleColumns\"\n :key=\"column.key\"\n scope=\"col\"\n class=\"h-10 px-2 align-middle font-medium text-muted-foreground\"\n :class=\"stickyClass(stickyOf, column.key)\"\n :style=\"[\n { width: column.width, textAlign: column.align },\n stickyStyle(stickyOf, column.key, true),\n ]\"\n :aria-sort=\"ariaSort(column)\"\n >\n <button\n v-if=\"column.sortable\"\n type=\"button\"\n class=\"inline-flex items-center gap-1 hover:text-foreground\"\n @click=\"onSort(column.key)\"\n >\n {{ column.title }}\n <span aria-hidden=\"true\" class=\"text-xs\">{{ sortMark(column) }}</span>\n </button>\n <template v-else>{{ column.title }}</template>\n </th>\n </tr>\n </thead>\n\n <tbody class=\"[&_tr:last-child]:border-0\">\n <!-- 加载态:固定 5 行骨架(R14);选择列一并占位(S8);骨架不虚拟化;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 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-for=\"column in visibleColumns\"\n :key=\"column.key\"\n class=\"p-2 align-middle\"\n :class=\"stickyClass(stickyOf, column.key)\"\n :style=\"[{ textAlign: column.align }, stickyStyle(stickyOf, column.key, false)]\"\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 @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 />\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 body\"\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 @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 />\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 <TablePagination\n v-if=\"showPagination\"\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 @update:page-index=\"onPageIndex\"\n @update:page-size=\"onPageSize\"\n />\n </div>\n</template>\n"
|
|
41
|
+
"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, 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 { 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 TableColumnOptions,\n TableLoadParams,\n TableRenderDefinition,\n TableSelectionOptions,\n TreeOptions,\n} from \"./types\";\nimport { useTableRender } from \"./useTableRender\";\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<TableColumnOptions[]> },\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 /** 每页条数 / 受控每页条数(D11):传入即受控(pageIndex 未受控时 R9 归位内部处理并通知) */\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 /** 受控页码(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 警告(R26,definition 优先) */\n defaultVisibleKeys: { type: Array as PropType<string[]> },\n /** 列设置触发器/面板开关(默认 true);false 时不渲染 UI,受控 API 不受影响 */\n columnSettings: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 搜索区渲染开关(R27):false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */\n showSearch: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 分页条渲染开关(R28):false 关闭内置分页条(组合式外置 TablePagination);缺省模式 R13 不变 */\n showPagination: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n});\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}>();\n\ndefineSlots<{\n empty?: () => VNodeChild;\n /** 错误态占位(服务端模式 onLoad 失败时渲染,优先于数据区) */\n error?: (props: { error: Error | undefined; retry: () => void }) => VNodeChild;\n}>();\n\n/** 加载态骨架行数(R14) */\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}\nconst instance =\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 pageIndex: () => props.pageIndex,\n pageSize: () => props.pageSize,\n sort: () => props.sort,\n selectedKeys: () => props.selectedKeys,\n columnVisibility: props.definition?.columnVisibility,\n defaultVisibleKeys: () => props.defaultVisibleKeys,\n visibleKeys: () => props.visibleKeys,\n });\n// 拆分式已传 rowKey;聚合式由组件回填(S1:选择引擎依赖 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,R20–R26) ------------------------------------\n// R26:聚合式(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/** 当前搜索表单值快照(浅拷贝;无 search 时为空对象) */\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/** 内部加载态 ∪ 外部受控加载态(R14) */\nconst loading = computed(() => props.loading === true || instance.loading.value);\nconst showPagination = computed(() => Math.ceil(instance.page.total / instance.page.pageSize) > 1);\n/** 内置分页条开关(R28):showPagination=false 关闭;R13 仅作用于缺省模式 */\nconst showPaginationBar = computed(() => showPagination.value && props.showPagination !== false);\n/** 内置搜索区开关(R27):配置了 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,R20–R26) -------------------------------------\nconst visibleKeySet = computed(() => new Set(instance.visibleKeys.value));\n/** 可见业务列(columns 原序子集):header/body/骨架/colspan/sticky 全部基于此渲染(R23/R25) */\nconst visibleColumns = computed(() =>\n columns.value.filter((column) => visibleKeySet.value.has(column.key)),\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/** 最少一列(R20):唯一可见列不可隐藏 */\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 // R21:恢复 defaultVisibleKeys;未配置 = 全部可见\n instance.setVisibleKeys(instance.defaultVisibleKeys ?? columns.value.map((column) => column.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 与骨架行,S8/R23) */\nconst columnCount = computed(() => visibleColumns.value.length + (hasSelection.value ? 1 : 0));\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/** sticky 单元格映射(纯渲染层 computed,不进 TanStack pinning state):\n * 选择列视作最左 fixed 列参与累计(offset 0);fixed-left 按列序累加,\n * fixed-right 从最右列反向累计。edge = 该 sticky 组朝滚动方向的交界列(加分隔边框)。\n * 全部基于**可见集**(R23):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, { side: \"left\", offset: 0, edge: lefts.length === 0 });\n acc = selection.value.width;\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/** 表头全选三态(S10):本页可选行与选中集求交派生(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/** 行选择控件切换;radio 不可取消由引擎 S4 守卫,不选中态点击传 checked=true */\nfunction onRowSelect(line: { key: string }, checked: boolean) {\n instance.toggleRowSelected(line.key, checked);\n}\n\n// 选中集变化 → 对外事件(S7):排序/翻页不改变选中集,故不会误发\nwatch(instance.selectedKeys, (keys) => {\n emit(\"selection-change\", [...selection.value.value]);\n emit(\"update:selected-keys\", [...keys]);\n});\n\n/** 行 → 单元格值矩阵:render > formatter > record[key](R17) */\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 /** 行级可选过滤(S5):selectable 谓词交由引擎 enableRowSelection 判定 */\n canSelect: row.getCanSelect(),\n // 可见列的值矩阵(列显隐只裁剪列;R25 状态不受影响)\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/** 行主键:rowKey 字段缺失时以行索引兜底(R3) */\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;\nif (virtualRaw === true && heightRaw === undefined) {\n console.warn(\"[tu-design] <TableRender> virtual 需要配置 height,已降级普通渲染。\");\n}\nconst virtualEnabled = virtualRaw === true && heightRaw !== undefined;\nconst scrollHeight = computed(() => (typeof heightRaw === \"number\" ? `${heightRaw}px` : heightRaw));\n\nconst scrollEl = ref<HTMLElement | null>(null);\nconst theadEl = ref<HTMLElement | null>(null);\n/** 滚动容器内 thead 占据的前缀高度(scrollMargin);表头内容静态,挂载后测量一次 */\nconst theadOffset = ref(0);\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(() => {\n if (virtualEnabled) theadOffset.value = theadEl.value?.offsetHeight ?? 0;\n});\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。 */\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/** aria-sort 仅在该列当前被排序时标注(R16) */\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: instance.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', $attrs.class)\">\n <!-- 搜索区 + 列设置触发器:同行右对齐(items-end);无搜索时触发器位于表格上方(R27:showSearch=false 关闭搜索区) -->\n <div\n v-if=\"showSearchArea || showColumnSettings\"\n class=\"mb-2 flex items-end justify-between gap-2\"\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 面板(R20 最少一列 / R21 重置 / R22 不含选择列);\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=\"column in columns\"\n :key=\"column.key\"\n data-column-item\n :data-column-key=\"column.key\"\n class=\"hover:bg-accent/50 flex h-8 cursor-pointer items-center gap-2 px-3\"\n @click=\"toggleColumnVisible(column.key)\"\n >\n <Checkbox\n :checked=\"isColumnVisible(column.key)\"\n :disabled=\"!canHideColumn(column.key)\"\n @update:checked=\"toggleColumnVisible(column.key)\"\n @click.stop\n />\n <span class=\"min-w-0 flex-1 truncate\">{{ column.title }}</span>\n <!-- 有效 fixed 列(数字 width)标识 -->\n <svg\n v-if=\"column.fixed !== undefined && typeof column.width === 'number'\"\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 模式兼任纵向滚动(分页条不参与滚动) -->\n <div\n ref=\"scrollEl\"\n class=\"overflow-x-auto\"\n :style=\"virtualEnabled ? { height: scrollHeight, overflowY: 'auto' } : undefined\"\n >\n <table class=\"w-full caption-bottom text-sm\">\n <thead ref=\"theadEl\" class=\"[&_tr]:border-b\">\n <tr>\n <!-- 选择列:checkbox 型表头为本页全选三态(S3/S10);radio 型占位;视作最左固定列 -->\n <th\n v-if=\"hasSelection\"\n scope=\"col\"\n class=\"h-10 w-12 px-2 align-middle font-medium text-muted-foreground\"\n :class=\"stickyClass(stickyOf, SELECTION_CELL)\"\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 <th\n v-for=\"column in visibleColumns\"\n :key=\"column.key\"\n scope=\"col\"\n class=\"h-10 px-2 align-middle font-medium text-muted-foreground\"\n :class=\"stickyClass(stickyOf, column.key)\"\n :style=\"[\n { width: column.width, textAlign: column.align },\n stickyStyle(stickyOf, column.key, true),\n ]\"\n :aria-sort=\"ariaSort(column)\"\n >\n <button\n v-if=\"column.sortable\"\n type=\"button\"\n class=\"inline-flex items-center gap-1 hover:text-foreground\"\n @click=\"onSort(column.key)\"\n >\n {{ column.title }}\n <span aria-hidden=\"true\" class=\"text-xs\">{{ sortMark(column) }}</span>\n </button>\n <template v-else>{{ column.title }}</template>\n </th>\n </tr>\n </thead>\n\n <tbody class=\"[&_tr:last-child]:border-0\">\n <!-- 加载态:固定 5 行骨架(R14);选择列一并占位(S8);骨架不虚拟化;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 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-for=\"column in visibleColumns\"\n :key=\"column.key\"\n class=\"p-2 align-middle\"\n :class=\"stickyClass(stickyOf, column.key)\"\n :style=\"[{ textAlign: column.align }, stickyStyle(stickyOf, column.key, false)]\"\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 @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 />\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 body\"\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 @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 />\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 <!-- R31:手动接线(须经 onPageIndex/onPageSize 包装器保留受控去重);显式补 border-t 与 size select 保持现状 -->\n <TablePagination\n v-if=\"showPaginationBar\"\n class=\"border-t\"\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
42
|
},
|
|
43
43
|
{
|
|
44
44
|
"path": "table-render/column-renders.ts",
|
|
@@ -68,7 +68,7 @@
|
|
|
68
68
|
"path": "table-render/index.ts",
|
|
69
69
|
"type": "registry:lib",
|
|
70
70
|
"target": "components/ui/table-render/index.ts",
|
|
71
|
-
"content": "export { default as TableRender } from \"./TableRender.vue\";\nexport { columnRenders } from \"./column-renders\";\nexport type {\n ColumnRenders,\n DictColumnMapping,\n DictColumnOptions,\n DictEntryVariant,\n SerialColumnOptions,\n TableActionButton,\n} from \"./column-renders\";\nexport { defineColumns } from \"./define-columns\";\nexport { defineTable } from \"./define-table\";\nexport { useTableRender } from \"./useTableRender\";\nexport type {\n DataRecord,\n DefineTableOptions,\n PageableOptions,\n SortableOptions,\n TableColumnOptions,\n TableLoadParams,\n TableRenderDefinition,\n TreeOptions,\n UseTableRenderOptions,\n} from \"./types\";\n"
|
|
71
|
+
"content": "export { default as TablePagination } from \"./TablePagination.vue\";\nexport { default as TableRender } from \"./TableRender.vue\";\nexport { columnRenders } from \"./column-renders\";\nexport type {\n ColumnRenders,\n DictColumnMapping,\n DictColumnOptions,\n DictEntryVariant,\n SerialColumnOptions,\n TableActionButton,\n} from \"./column-renders\";\nexport { defineColumns } from \"./define-columns\";\nexport { defineTable } from \"./define-table\";\nexport { useTableRender } from \"./useTableRender\";\nexport type {\n DataRecord,\n DefineTableOptions,\n PageableOptions,\n SortableOptions,\n TableColumnOptions,\n TableLoadParams,\n TableRenderDefinition,\n TreeOptions,\n UseTableRenderOptions,\n} from \"./types\";\n"
|
|
72
72
|
},
|
|
73
73
|
{
|
|
74
74
|
"path": "table-render/sticky.ts",
|
|
@@ -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.
|
|
4
|
+
"version": "0.5.3",
|
|
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.
|
|
4
|
+
"version": "0.5.3",
|
|
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"],
|
|
@@ -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.
|
|
4
|
+
"version": "0.5.3",
|
|
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.
|
|
4
|
+
"version": "0.5.3",
|
|
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.
|
|
4
|
+
"version": "0.5.3",
|
|
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.
|
|
4
|
+
"version": "0.5.3",
|
|
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.
|
|
4
|
+
"version": "0.5.3",
|
|
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.
|
|
4
|
+
"version": "0.5.3",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "周选择器:输入框 + 日历弹层,点任意可选日归一到所在周并整周高亮,值以 \"yyyy-MM-dd\"(所在周起始日)字符串受控;周起点跟随 locale(zh-CN 周一起始),输入框回显 \"start ~ end\"。",
|
|
7
7
|
"registryDependencies": ["utils", "date-shared", "calendar"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "year-picker",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.3",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "年份选择器:输入框 + 锁定年视图的日历弹层(decade 网格),值以 \"yyyy\" 字符串受控,min/max 为年粒度闭区间。",
|
|
7
7
|
"registryDependencies": ["utils", "date-shared", "calendar"],
|