@tu-design/vue 0.2.2 → 0.4.0

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 (41) hide show
  1. package/dist/index.d.mts +3717 -1104
  2. package/dist/index.mjs +7593 -1249
  3. package/dist/registry/vue/alert-dialog.json +22 -0
  4. package/dist/registry/vue/alert.json +22 -0
  5. package/dist/registry/vue/avatar-group.json +21 -0
  6. package/dist/registry/vue/avatar.json +3 -3
  7. package/dist/registry/vue/calendar.json +34 -0
  8. package/dist/registry/vue/card.json +3 -33
  9. package/dist/registry/vue/cascader.json +34 -0
  10. package/dist/registry/vue/checkbox.json +1 -1
  11. package/dist/registry/vue/context-menu.json +22 -0
  12. package/dist/registry/vue/currency-input.json +1 -1
  13. package/dist/registry/vue/date-picker.json +22 -0
  14. package/dist/registry/vue/date-range-picker.json +22 -0
  15. package/dist/registry/vue/date-shared.json +26 -0
  16. package/dist/registry/vue/dialog.json +3 -45
  17. package/dist/registry/vue/drawer.json +22 -0
  18. package/dist/registry/vue/dropdown-menu.json +11 -35
  19. package/dist/registry/vue/empty.json +21 -0
  20. package/dist/registry/vue/form-render.json +115 -0
  21. package/dist/registry/vue/form.json +2 -2
  22. package/dist/registry/vue/month-picker.json +22 -0
  23. package/dist/registry/vue/number-input.json +1 -1
  24. package/dist/registry/vue/popconfirm.json +22 -0
  25. package/dist/registry/vue/popover.json +3 -15
  26. package/dist/registry/vue/progress.json +22 -0
  27. package/dist/registry/vue/radio-group.json +2 -8
  28. package/dist/registry/vue/registry.json +138 -6
  29. package/dist/registry/vue/select.json +3 -27
  30. package/dist/registry/vue/slider.json +1 -1
  31. package/dist/registry/vue/spin.json +22 -0
  32. package/dist/registry/vue/table-render.json +62 -0
  33. package/dist/registry/vue/tabs.json +2 -20
  34. package/dist/registry/vue/toast.json +28 -0
  35. package/dist/registry/vue/tokens.json +1 -1
  36. package/dist/registry/vue/tooltip.json +2 -14
  37. package/dist/registry/vue/tree-select.json +34 -0
  38. package/dist/registry/vue/tree-shared.json +92 -0
  39. package/dist/registry/vue/week-picker.json +22 -0
  40. package/dist/registry/vue/year-picker.json +22 -0
  41. package/package.json +3 -1
@@ -0,0 +1,62 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "table-render",
4
+ "type": "registry:ui",
5
+ "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。",
6
+ "registryDependencies": ["button", "form-render", "popover", "separator", "skeleton", "tooltip"],
7
+ "dependencies": [
8
+ "@ark-ui/vue@^5.39.2",
9
+ "@tanstack/vue-table@^8.21.3",
10
+ "@tanstack/vue-virtual@^3.13.47"
11
+ ],
12
+ "files": [
13
+ {
14
+ "path": "table-render/TablePagination.vue",
15
+ "type": "registry:component",
16
+ "target": "components/ui/table-render/TablePagination.vue",
17
+ "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\";\n\nconst props = defineProps<{\n /** 1-based 当前页码 */\n pageIndex: number;\n pageSize: number;\n pageSizeOpts: readonly number[];\n total: number;\n}>();\n\nconst emit = defineEmits<{\n \"update:pageIndex\": [pageIndex: number];\n \"update:pageSize\": [pageSize: number];\n}>();\n\nconst totalPages = computed(() => Math.max(1, Math.ceil(props.total / props.pageSize)));\n\n/** 页码窗口:首页/尾页 + 当前页 ±1,跳过段用省略号(D12) */\nconst pages = computed<(number | string)[]>(() => {\n const count = totalPages.value;\n const window = [...new Set([1, count, props.pageIndex - 1, props.pageIndex, props.pageIndex + 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 <div class=\"flex w-full items-center justify-between gap-4 border-t p-2 text-sm\">\n <div class=\"flex items-center gap-2 text-muted-foreground\">\n <span>共 {{ total }} 条</span>\n <select\n class=\"h-8 rounded-md border bg-transparent px-2 text-sm\"\n :value=\"pageSize\"\n @change=\"emit('update:pageSize', 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\"\n :page=\"pageIndex\"\n :page-size=\"pageSize\"\n :sibling-count=\"1\"\n @page-change=\"emit('update:pageIndex', $event.page)\"\n >\n <ArkPaginationPrevTrigger\n class=\"h-8 rounded-md border px-3 disabled:opacity-50\"\n :disabled=\"pageIndex <= 1\"\n >\n 上一页\n </ArkPaginationPrevTrigger>\n\n <template v-for=\"(item, index) in pages\" :key=\"item\">\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-3 disabled:opacity-50\"\n :disabled=\"pageIndex >= totalPages\"\n >\n 下一页\n </ArkPaginationNextTrigger>\n </ArkPaginationRoot>\n </div>\n</template>\n"
18
+ },
19
+ {
20
+ "path": "table-render/TableRender.vue",
21
+ "type": "registry:component",
22
+ "target": "components/ui/table-render/TableRender.vue",
23
+ "content": "<script setup lang=\"ts\">\nimport type { ComponentPublicInstance, PropType, VNodeChild } from \"vue\";\nimport { useVirtualizer } from \"@tanstack/vue-virtual\";\nimport { columnRenders } from \"./column-renders\";\nimport { cloneVNode, computed, h, isVNode, onMounted, ref, watch } from \"vue\";\nimport { Button } from \"@/components/button\";\nimport { Checkbox } from \"@/components/checkbox\";\nimport { FormRender, type FormRenderDefinition } from \"@/components/form-render\";\nimport { Popover } from \"@/components/popover\";\nimport { Separator } from \"@/components/separator\";\nimport { Skeleton } from \"@/components/skeleton\";\nimport { Tooltip } from \"@/components/tooltip\";\nimport TablePagination from \"./TablePagination.vue\";\nimport type {\n ColumnVisibilityOptions,\n DataRecord,\n SortableOptions,\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/** 选择列在 sticky 映射中的哨兵键(选择列不在 columns 内,模板单独渲染) */\nconst SELECTION_CELL = \"__selection__\";\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(() => {\n const map = new Map<string, { side: \"left\" | \"right\"; offset: number; edge: boolean }>();\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/** sticky 定位样式;head 为 true 时 z-index 高于表体(表头 sticky 压住表体 sticky) */\nfunction stickyStyle(key: string, head: boolean) {\n const sticky = stickyOf.value.get(key);\n if (!sticky) return undefined;\n return {\n position: \"sticky\" as const,\n [sticky.side]: `${sticky.offset}px`,\n zIndex: head ? 20 : 10,\n };\n}\n\n/** sticky 底色(防滚动透出)与交界分隔边框 */\nfunction stickyClass(key: string) {\n const sticky = stickyOf.value.get(key);\n if (!sticky) return undefined;\n return [\n \"bg-background\",\n sticky.side === \"left\" && sticky.edge ? \"border-r border-border\" : \"\",\n sticky.side === \"right\" && sticky.edge ? \"border-l border-border\" : \"\",\n ];\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(() => {\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 把实测高度写回(行内容高度可变,不假设固定行高) */\nfunction measureRow(node: Element | ComponentPublicInstance | null) {\n if (node instanceof Element) virtualizerRef?.value.measureElement(node);\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 cellText(line: { cells: VNodeChild[] }, index: number): string {\n const value = line.cells[index];\n return isVNode(value) ? \"\" : String(value ?? \"\");\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\n/** ellipsis: \"tooltip\" 的单元格内容:默认插槽承载截断内容(触发元素本体,不额外包裹),content 显示完整文本。\n * VNode(render 工厂)单元格经 cloneVNode 复制进触发位(VNode 不可二次挂载)。 */\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\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=\"w-full\">\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 @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(SELECTION_CELL)\"\n :style=\"[{ width: `${selection.width}px` }, stickyStyle(SELECTION_CELL, true)]\"\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(column.key)\"\n :style=\"[\n { width: column.width, textAlign: column.align },\n stickyStyle(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(SELECTION_CELL)\"\n :style=\"stickyStyle(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(column.key)\"\n :style=\"[{ textAlign: column.align }, stickyStyle(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 <tr\n v-for=\"item in virtualLines\"\n :key=\"item.line.key\"\n :ref=\"measureRow\"\n :data-index=\"item.row.index\"\n class=\"border-b transition-colors hover:bg-muted/50\"\n @click=\"onRowClick(item.line.record, item.line.index, $event)\"\n @dblclick=\"onRowDblclick(item.line.record, item.line.index, $event)\"\n @contextmenu=\"onRowContextmenu(item.line.record, item.line.index, $event)\"\n >\n <!-- 选择单元格:阻断冒泡避免触发行 row-click(S5);radio 为原生控件 -->\n <td\n v-if=\"hasSelection\"\n class=\"w-12 p-2 align-middle\"\n :class=\"stickyClass(SELECTION_CELL)\"\n :style=\"stickyStyle(SELECTION_CELL, false)\"\n @click.stop\n >\n <input\n v-if=\"selection.type === 'radio'\"\n type=\"radio\"\n class=\"accent-primary size-4 cursor-pointer disabled:cursor-not-allowed disabled:opacity-50\"\n :checked=\"selectedKeys.has(item.line.key)\"\n :disabled=\"!item.line.canSelect\"\n :aria-label=\"`选择第 ${item.line.index + 1} 行`\"\n @click=\"onRowSelect(item.line, !selectedKeys.has(item.line.key))\"\n />\n <Checkbox\n v-else\n :checked=\"selectedKeys.has(item.line.key)\"\n :disabled=\"!item.line.canSelect\"\n :aria-label=\"`选择第 ${item.line.index + 1} 行`\"\n @update:checked=\"(checked: boolean) => onRowSelect(item.line, checked)\"\n />\n </td>\n <td\n v-for=\"(value, index) in item.line.cells\"\n :key=\"visibleColumns[index].key\"\n class=\"p-2 align-middle\"\n :class=\"[\n stickyClass(visibleColumns[index].key),\n { truncate: visibleColumns[index].ellipsis === true },\n ]\"\n :title=\"\n visibleColumns[index].ellipsis === true ? cellText(item.line, index) : undefined\n \"\n :style=\"[\n { textAlign: visibleColumns[index].align },\n stickyStyle(visibleColumns[index].key, false),\n ]\"\n @click=\"\n onCellClick(item.line.record, visibleColumns[index].key, item.line.index, $event)\n \"\n >\n <!-- 首列(tree 启用时):depth 缩进 + 展开 caret(点击 stop 避免误触发行点击) -->\n <span\n v-if=\"tree && index === 0\"\n class=\"inline-flex max-w-full items-center gap-1\"\n :style=\"{ marginLeft: `${item.line.row.depth * treeIndent}px` }\"\n >\n <button\n v-if=\"item.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=\"item.line.row.getIsExpanded()\"\n :aria-label=\"item.line.row.getIsExpanded() ? '收起' : '展开'\"\n @click.stop=\"item.line.row.toggleExpanded()\"\n >\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-3.5 transition-transform\"\n :class=\"{ 'rotate-90': item.line.row.getIsExpanded() }\"\n aria-hidden=\"true\"\n >\n <path d=\"m9 18 6-6-6-6\" />\n </svg>\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(item.line, index))\"\n v-else-if=\"visibleColumns[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 <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 <tr\n v-for=\"line in body\"\n :key=\"line.key\"\n class=\"border-b transition-colors hover:bg-muted/50\"\n @click=\"onRowClick(line.record, line.index, $event)\"\n @dblclick=\"onRowDblclick(line.record, line.index, $event)\"\n @contextmenu=\"onRowContextmenu(line.record, line.index, $event)\"\n >\n <!-- 选择单元格:阻断冒泡避免触发行 row-click(S5);radio 为原生控件 -->\n <td\n v-if=\"hasSelection\"\n class=\"w-12 p-2 align-middle\"\n :class=\"stickyClass(SELECTION_CELL)\"\n :style=\"stickyStyle(SELECTION_CELL, false)\"\n @click.stop\n >\n <input\n v-if=\"selection.type === 'radio'\"\n type=\"radio\"\n class=\"accent-primary size-4 cursor-pointer disabled:cursor-not-allowed disabled:opacity-50\"\n :checked=\"selectedKeys.has(line.key)\"\n :disabled=\"!line.canSelect\"\n :aria-label=\"`选择第 ${line.index + 1} 行`\"\n @click=\"onRowSelect(line, !selectedKeys.has(line.key))\"\n />\n <Checkbox\n v-else\n :checked=\"selectedKeys.has(line.key)\"\n :disabled=\"!line.canSelect\"\n :aria-label=\"`选择第 ${line.index + 1} 行`\"\n @update:checked=\"(checked: boolean) => onRowSelect(line, checked)\"\n />\n </td>\n <td\n v-for=\"(value, index) in line.cells\"\n :key=\"visibleColumns[index].key\"\n class=\"p-2 align-middle\"\n :class=\"[\n stickyClass(visibleColumns[index].key),\n { truncate: visibleColumns[index].ellipsis === true },\n ]\"\n :title=\"visibleColumns[index].ellipsis === true ? cellText(line, index) : undefined\"\n :style=\"[\n { textAlign: visibleColumns[index].align },\n stickyStyle(visibleColumns[index].key, false),\n ]\"\n @click=\"onCellClick(line.record, visibleColumns[index].key, line.index, $event)\"\n >\n <!-- 首列(tree 启用时):depth 缩进 + 展开 caret(点击 stop 避免误触发行点击) -->\n <span\n v-if=\"tree && index === 0\"\n class=\"inline-flex max-w-full items-center gap-1\"\n :style=\"{ marginLeft: `${line.row.depth * treeIndent}px` }\"\n >\n <button\n v-if=\"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=\"line.row.getIsExpanded()\"\n :aria-label=\"line.row.getIsExpanded() ? '收起' : '展开'\"\n @click.stop=\"line.row.toggleExpanded()\"\n >\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-3.5 transition-transform\"\n :class=\"{ 'rotate-90': line.row.getIsExpanded() }\"\n aria-hidden=\"true\"\n >\n <path d=\"m9 18 6-6-6-6\" />\n </svg>\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(line, index))\"\n v-else-if=\"visibleColumns[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\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"
24
+ },
25
+ {
26
+ "path": "table-render/column-renders.ts",
27
+ "type": "registry:component",
28
+ "target": "components/ui/table-render/column-renders.ts",
29
+ "content": "import type { BadgeVariants } from \"../badge\";\nimport type { ButtonVariants } from \"../button\";\nimport type { VNodeChild } from \"vue\";\nimport type { DataRecord, TableColumnOptions } from \"./types\";\nimport { h } from \"vue\";\nimport Badge from \"../badge/Badge.vue\";\nimport Button from \"../button/Button.vue\";\n\n/** 单元格渲染器:与 TableColumnOptions.render 同签名(column 用于读取字段值) */\nexport type ColumnRender<T extends DataRecord> = (\n record: T,\n index: number,\n column: TableColumnOptions<T>,\n) => VNodeChild;\n\nexport type DictEntryVariant = BadgeVariants[\"variant\"];\n\nexport type DictColumnMapping = Record<\n string | number,\n string | { label: string; variant?: DictEntryVariant }\n>;\n\nexport interface DictColumnOptions {\n /** 整列统一 Badge 形态;条目级 variant 优先 */\n badge?: DictEntryVariant | true;\n}\n\n/** 日期模式串(迷你令牌 yyyy MM dd HH mm ss),如 \"yyyy-MM-dd HH:mm\" */\nexport type DateColumnPattern = string;\n\nexport interface SerialColumnOptions {\n /** 起始序号,默认 1 */\n base?: number;\n}\n\nexport interface TableActionButton<T extends DataRecord> {\n text: string | ((record: T, index: number) => string);\n onClick?: (record: T, index: number) => void;\n variant?: ButtonVariants[\"variant\"];\n disabled?: (record: T, index: number) => boolean;\n}\n\nexport interface ColumnRenders<T extends DataRecord> {\n /** 逃逸口:自定义渲染器与内置同一范式(对齐 x-render renderRenderColumn) */\n render: (fn: ColumnRender<T>) => ColumnRender<T>;\n dict: (mapping: DictColumnMapping, options?: DictColumnOptions) => ColumnRender<T>;\n date: (pattern?: DateColumnPattern) => ColumnRender<T>;\n currency: (currency?: string, locale?: string) => ColumnRender<T>;\n serial: (base?: number) => ColumnRender<T>;\n button: (items: Array<TableActionButton<T> | string>) => ColumnRender<T>;\n}\n\nconst pad = (value: number) => String(value).padStart(2, \"0\");\n\n/** 迷你日期令牌格式化,不引入 date-fns;非法输入原样返回 */\nfunction formatDate(input: unknown, pattern: string): VNodeChild {\n const date = input instanceof Date ? input : new Date(input as string | number);\n if (Number.isNaN(date.getTime())) return input as VNodeChild;\n const tokens: Record<string, string> = {\n yyyy: String(date.getFullYear()),\n MM: pad(date.getMonth() + 1),\n dd: pad(date.getDate()),\n HH: pad(date.getHours()),\n mm: pad(date.getMinutes()),\n ss: pad(date.getSeconds()),\n };\n return pattern.replace(/yyyy|MM|dd|HH|mm|ss/g, (token) => tokens[token]!);\n}\n\n/**\n * 内置列渲染器工厂(对标 x-render table-columns,v1:dict/date/currency/serial/button)。\n * 返回值直接填入 TableColumnOptions.render;column 参数用于读取字段值。\n * 与 FormRender widget 的 r.xxx() 范式共词根(D10)。\n */\nexport function columnRenders<T extends DataRecord>(): ColumnRenders<T> {\n return {\n render: (fn) => fn,\n\n dict(mapping, options) {\n return (record, _index, column) => {\n const raw = (record as Record<string, unknown>)[column.key];\n const entry = mapping[raw as string | number];\n if (entry === undefined) return (raw ?? \"\") as VNodeChild;\n\n const label = typeof entry === \"string\" ? entry : entry.label;\n const entryVariant = typeof entry === \"object\" ? entry.variant : undefined;\n // Badge 形态:条目级 variant,或整列 badge 简写\n if (entryVariant !== undefined || options?.badge !== undefined) {\n const variant = entryVariant ?? (options?.badge === true ? undefined : options?.badge);\n return h(Badge, { variant }, () => label);\n }\n return label;\n };\n },\n\n date(pattern = \"yyyy-MM-dd\") {\n return (record, _index, column) =>\n formatDate((record as Record<string, unknown>)[column.key], pattern);\n },\n\n currency(currency = \"CNY\", locale = \"zh-CN\") {\n const format = new Intl.NumberFormat(locale, { style: \"currency\", currency });\n return (record, _index, column) => {\n const raw = (record as Record<string, unknown>)[column.key];\n const value = typeof raw === \"string\" ? Number(raw) : raw;\n if (typeof value !== \"number\" || Number.isNaN(value)) return raw as VNodeChild;\n return format.format(value);\n };\n },\n\n serial(base = 1) {\n return (_record, index) => index + base;\n },\n\n button(items) {\n return (record, index) => {\n if (items.length === 0) return \"\";\n return h(\n \"div\",\n { class: \"flex items-center gap-1\" },\n items.map((item) => {\n const action = typeof item === \"string\" ? { text: item } : item;\n return h(\n Button,\n {\n size: \"sm\",\n variant: action.variant ?? \"link\",\n disabled: action.disabled?.(record, index),\n onClick: () => action.onClick?.(record, index),\n },\n () => (typeof action.text === \"function\" ? action.text(record, index) : action.text),\n );\n }),\n );\n };\n },\n };\n}\n"
30
+ },
31
+ {
32
+ "path": "table-render/define-columns.ts",
33
+ "type": "registry:component",
34
+ "target": "components/ui/table-render/define-columns.ts",
35
+ "content": "import type { DataRecord, TableColumnOptions } from \"./types\";\n\n/**\n * 列定义辅助:补全泛型推导,便于把列配置抽到独立文件。\n *\n * 纯类型辅助,原样返回入参——裸数组同样可直接传给 defineTable(无需此函数)。\n */\nexport function defineColumns<T extends DataRecord = DataRecord>(\n columns: TableColumnOptions<T>[],\n): TableColumnOptions<T>[] {\n return columns;\n}\n"
36
+ },
37
+ {
38
+ "path": "table-render/define-table.ts",
39
+ "type": "registry:component",
40
+ "target": "components/ui/table-render/define-table.ts",
41
+ "content": "import { useTableRender } from \"./useTableRender\";\nimport type { DataRecord, DefineTableOptions, TableRenderDefinition } from \"./types\";\n\n/**\n * 聚合入口:单次调用完成「列定义 + 数据内核 + 分页排序状态 + 实例动作」。\n *\n * 返回值直接传给 `<TableRender :definition=\"def\" />`;\n * 须在组件 setup 中调用(TanStack useVueTable 约束)。\n */\nexport function defineTable<T extends DataRecord>(\n config: DefineTableOptions<T>,\n): TableRenderDefinition<T> {\n return useTableRender<T>(config);\n}\n"
42
+ },
43
+ {
44
+ "path": "table-render/index.ts",
45
+ "type": "registry:component",
46
+ "target": "components/ui/table-render/index.ts",
47
+ "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"
48
+ },
49
+ {
50
+ "path": "table-render/types.ts",
51
+ "type": "registry:component",
52
+ "target": "components/ui/table-render/types.ts",
53
+ "content": "import type { ColumnRender, ColumnRenders } from \"./column-renders\";\nimport type { FormRenderDefinition } from \"../form-render\";\nimport type { Table as TanstackTable } from \"@tanstack/vue-table\";\nimport type { MaybeRefOrGetter, Ref } from \"vue\";\n\n/** 任意数据行(表格是弱类型数据容器,行结构由调用方的 T 决定) */\nexport interface DataRecord {\n [key: string]: any;\n}\n\n/**\n * 列配置。\n *\n * 命名总纲(D10):能力/性质用 `-able` 形容词(sortable/ellipsis),\n * 配置值用名词(title/align/width),无 `allow-*`。\n */\nexport interface TableColumnOptions<T extends DataRecord = DataRecord> {\n /** 列标识,同时作为默认取值字段 */\n key: string;\n title: string;\n align?: \"left\" | \"center\" | \"right\";\n width?: number | string;\n /** 自定义单元格渲染,取值链 render > formatter > record[key](R17) */\n render?: (r: ColumnRenders<T>) => ColumnRender<T>;\n /** 纯数据格式化;render 存在时被忽略 */\n formatter?: (record: T) => string | number | Date | undefined;\n /** 超宽截断 + 原生 title 提示(R15);\"tooltip\" 形态改用库内 Tooltip(不设原生 title) */\n ellipsis?: boolean | \"tooltip\";\n /** 是否可排序(能力开关) */\n sortable?: boolean;\n /** 初始排序方向;需 sortable: true,否则 DEV 警告并忽略(R7) */\n defaultSort?: \"asc\" | \"desc\";\n /** 固定列:横向滚动时 sticky 在左/右;须同时提供数字 width,否则 DEV 警告并按普通列渲染 */\n fixed?: \"left\" | \"right\";\n}\n\nexport interface PageableOptions {\n /** 1-based 页码(对外 API 唯一口径) */\n pageIndex: number;\n pageSize: number;\n total: number;\n /** 只读:状态投影不允许调用方直接改写每页条数选项 */\n pageSizeOpts: readonly number[];\n}\n\nexport interface SortableOptions {\n key: string;\n direction: \"asc\" | \"desc\";\n}\n\n/** onLoad 入参:数据协议与 x-render 同构,request 生态由调用方自理 */\nexport interface TableLoadParams<T extends DataRecord = DataRecord> {\n /** 搜索表单值(来自 options.search 的表单当前值);未配置 search 时为 {} */\n form: DataRecord;\n page: PageableOptions;\n /** 无排序或已取消排序时为 undefined */\n sort?: SortableOptions;\n /** 回写数据;total 缺省时保留旧值(R10) */\n update: (data: T[], total?: number) => void;\n}\n\n/** defineTable 的声明式配置 */\nexport interface DefineTableOptions<T extends DataRecord = DataRecord> {\n columns: TableColumnOptions<T>[];\n /** 服务端模式数据源;与 data 二选一,onLoad 优先 */\n onLoad?: (params: TableLoadParams<T>) => void | Promise<unknown>;\n /** 静态模式数据源(本地分页/排序) */\n data?: T[];\n /** 是否在挂载后自动加载,默认 true;仅服务端模式生效 */\n autoLoad?: boolean;\n /**\n * 每页条数 / 受控每页条数(D11)。约定:传入(非 undefined)即受控,缺省(undefined)时\n * 以默认 10 行运行;R9 归位:pageIndex 未受控时内部归位第 1 页并经 update:page-index 通知,\n * 两个都受控时由父层自行联动。支持传 ref/getter(聚合式受控)\n */\n pageSize?: MaybeRefOrGetter<number | undefined>;\n pageSizeOpts?: number[];\n /** 行选择:radio 单选 / checkbox 多选;字符串为简写(S2) */\n rowSelection?: \"radio\" | \"checkbox\" | TableSelectionOptions<T>;\n /** 行主键字段;rowSelection 启用且此值无效时禁用选择(S1) */\n rowKey?: string;\n /**\n * 搜索表单(defineForm 返回值):仅服务端模式生效,每次 onLoad 的 form 参数\n * 携带 `search.form.state.values` 当前值。静态模式传入时 DEV 警告并忽略。\n * 泛型为 any:FormRenderDefinition 对 T 不变(FormRenderItem.key 字面量收窄),\n * DataRecord 版会拒收一切具体 defineForm<Q> 结果(对齐 FormRender.vue prop 约定)。\n */\n search?: FormRenderDefinition<any>;\n /** 虚拟滚动:开启后表体行在当前页行窗口内虚拟化(分页语义不变);须同时配置 height,否则 DEV 警告并降级普通渲染 */\n virtual?: boolean;\n /** 虚拟滚动容器高度(数字 px 或 CSS 高度);仅 virtual: true 时生效 */\n height?: number | string;\n /** 树形数据:子行展开/收起(展开按钮在首个业务列内);配置无效时 DEV 警告并忽略 */\n tree?: TreeOptions;\n /**\n * 受控页码(1-based,D11)。约定:传入(非 undefined)即受控,缺省保持非受控;\n * 内部翻页经 update:page-index 通知,外部变更经受控 watch 同步(语义等值跳过,防回弹循环)\n */\n pageIndex?: MaybeRefOrGetter<number | undefined>;\n /** 受控排序。内部/外部变化均经 sort-change 通知;指向不可排序列时 DEV 警告并忽略 */\n sort?: MaybeRefOrGetter<SortableOptions | undefined>;\n /** 受控选中集(数组,与 update:selected-keys 载荷同构)。经 setSelection 写入(S5 过滤/S12 待定 key 继承) */\n selectedKeys?: MaybeRefOrGetter<Array<string | number> | undefined>;\n /**\n * 列显隐:默认可见列集(R21「重置」基准;未知 key 静默忽略;未传 = 全部可见)。\n * 列显隐不触发 onLoad、不重置 pageIndex/sort/selectedKeys(R25)\n */\n columnVisibility?: ColumnVisibilityOptions;\n /**\n * 受控可见列 key(columns 原序子集)。约定:传入(非 undefined)即受控;\n * 内部显隐经 update:visible-keys 通知;空数组钳制为首列可见(R24,warn 一次)\n */\n visibleKeys?: MaybeRefOrGetter<string[] | undefined>;\n /**\n * 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时\n * DEV 警告 definition 优先(R26)\n */\n defaultVisibleKeys?: MaybeRefOrGetter<string[] | undefined>;\n}\n\n/** 树形数据配置(T 系列) */\nexport interface TreeOptions {\n /** 子行字段名,默认 \"children\" */\n childrenKey?: string;\n /** 默认全部展开,默认 false */\n defaultExpandAll?: boolean;\n /** 每层缩进 px,默认 16 */\n indentSize?: number;\n}\n\n/** 列显隐配置(R20–R24) */\nexport interface ColumnVisibilityOptions {\n /** 默认可见列 key 列表(R21「重置」基准);未知 key 静默忽略;未传 = 全部可见 */\n defaultVisibleKeys?: string[];\n}\n\n/** 行选择配置(S 系列) */\nexport interface TableSelectionOptions<T extends DataRecord = DataRecord> {\n type: \"radio\" | \"checkbox\";\n /** 选择列宽,默认 48 */\n width?: number;\n /** 行级可选过滤;false 的行选择控件置灰且被全选跳过(S5) */\n selectable?: (record: T) => boolean;\n /** radio 再点已选中行是否取消,默认 true(S4) */\n cancelable?: boolean;\n /** 翻页/重载后是否保留选中,默认 true(S6) */\n reserveOnPageChange?: boolean;\n}\n\n/** useTableRender 的入参:data 额外支持 ref/getter(拆分模式下 props 天然响应式) */\nexport interface UseTableRenderOptions<T extends DataRecord = DataRecord> extends Omit<\n DefineTableOptions<T>,\n \"data\"\n> {\n data?: MaybeRefOrGetter<T[] | undefined>;\n}\n\n/** defineTable / useTableRender 的返回物:列配置 + 引擎实例 + 只读状态 + 实例动作 */\nexport interface TableRenderDefinition<T extends DataRecord = DataRecord> {\n columns: TableColumnOptions<T>[];\n /** TanStack 表格实例(逃逸舱口) */\n table: TanstackTable<T>;\n page: Readonly<PageableOptions>;\n sort: Readonly<{ value: SortableOptions | undefined }>;\n loading: Readonly<{ value: boolean }>;\n /** 重新加载;resetPage 为 true 时先回到第 1 页(R12) */\n reload: (resetPage?: boolean) => void;\n /** 排序三态切换:无 → asc → desc → 取消(R8) */\n toggleSort: (key: string) => void;\n setPageIndex: (pageIndex: number) => void;\n setPageSize: (pageSize: number) => void;\n /** 选中行快照(含跨页保留行;跨页行可能为过期数据,见 S6) */\n selection: Readonly<{\n value: T[];\n /** rowSelection 配置有效(含 rowKey 就绪)时为 true(S1) */\n enabled: boolean;\n type: \"radio\" | \"checkbox\";\n width: number;\n }>;\n /** 选中主键集合;每次选中集变化替换为新 Set(S7) */\n selectedKeys: Readonly<Ref<Set<string | number>>>;\n /** 程序化设置选中集;不存在的 key 保留(S12) */\n setSelection: (keys: Array<string | number>) => void;\n clearSelection: () => void;\n /** 行控件切换:checked 为 false 时移除(radio 受 cancelable 约束,S4) */\n toggleRowSelected: (key: string, checked: boolean) => void;\n /** 搜索表单定义(options.search 校验后的回传,供 TableRender 渲染搜索区;被忽略时为 undefined) */\n search: FormRenderDefinition<any> | undefined;\n /** 内部装配口:definition 未配置 search 时由 TableRender 回填组件 prop(对齐 setRowKey) */\n setSearch: (search: FormRenderDefinition<any> | undefined) => void;\n /** 虚拟滚动配置透传(未配置为 undefined),供组件渲染层判定(definition 优先于 prop) */\n virtual: boolean | undefined;\n /** 虚拟滚动容器高度配置透传(仅 virtual: true 时被组件使用) */\n height: number | string | undefined;\n /** 树形配置(引擎校验后的回传,供组件读取 indentSize;无效配置被忽略时为 undefined) */\n tree: TreeOptions | undefined;\n /** 最近一次 onLoad 失败的 Error(仅服务端模式产生);下一次 load 开始时清除 */\n error: Readonly<Ref<Error | undefined>>;\n /** 可见列 key(columns 原序子集);受控/非受控统一投影 */\n visibleKeys: Readonly<Ref<readonly string[]>>;\n /** 列显隐动作:规范化(未知忽略、columns 原序、空钳制为首列 R24)后更新 */\n setVisibleKeys: (keys: string[]) => void;\n /** 解析后的默认可见集(R21 重置基准;未配置为 undefined = 全部可见) */\n defaultVisibleKeys: string[] | undefined;\n /** 聚合式列显隐配置回传(拆分式为 undefined) */\n columnVisibility: ColumnVisibilityOptions | undefined;\n /** 内部装配口:拆分式由 TableRender 在 setup 时回填 rowKey(S1) */\n setRowKey: (rowKey: string | undefined) => void;\n}\n"
54
+ },
55
+ {
56
+ "path": "table-render/useTableRender.ts",
57
+ "type": "registry:component",
58
+ "target": "components/ui/table-render/useTableRender.ts",
59
+ "content": "import type { ColumnDef, RowSelectionState } from \"@tanstack/vue-table\";\nimport { computed, onMounted, reactive, readonly, ref, shallowRef, toValue, watch } from \"vue\";\nimport type { Ref } from \"vue\";\nimport {\n getCoreRowModel,\n getExpandedRowModel,\n getPaginationRowModel,\n getSortedRowModel,\n useVueTable,\n} from \"@tanstack/vue-table\";\nimport type {\n DataRecord,\n SortableOptions,\n TableRenderDefinition,\n TableSelectionOptions,\n TreeOptions,\n UseTableRenderOptions,\n} from \"./types\";\nimport type { FormRenderDefinition } from \"../form-render\";\n\nconst DEFAULT_PAGE_SIZE_OPTS = [10, 20, 50, 100];\n\n/** 数值配置防御:受控 getter(组件层)与数值配置(defineTable 层)同字段共存时只认数字 */\nfunction numericOption(value: unknown): number | undefined {\n return typeof value === \"number\" ? value : undefined;\n}\n\n/** DEV 兜底提示:生产构建静默,只留可读的降级行为(R1–R7) */\nfunction warn(message: string) {\n if (import.meta.env.DEV) console.warn(`[tu-design] <TableRender> ${message}`);\n}\n\n/**\n * 表格数据内核:TanStack 无头引擎组装 + 1-based 对外投影 + 实例动作。\n *\n * 状态真相源是 TanStack 引擎(pageIndex 为 0-based),\n * `page`/`sort` 是对外的 1-based 只读投影,由 watch 同步。\n */\nexport function useTableRender<T extends DataRecord>(\n options: UseTableRenderOptions<T>,\n): TableRenderDefinition<T> {\n const columns = options.columns;\n // 传入 onLoad 即服务端模式:分页/排序交由数据源,引擎不做本地加工\n const serverMode = typeof options.onLoad === \"function\";\n\n if (columns.length === 0) warn(\"columns 为空,表格将没有表头。\");\n if (serverMode && options.data !== undefined) {\n warn(\"onLoad 与 data 不能同时传入,已按 onLoad(服务端模式)处理。\");\n }\n\n // ---- 受控模式(v-model,D11) ------------------------------------------------\n // 约定:options 字段传入(非 undefined)即受控;受控值经 watch 同步进 TanStack,\n // 内部交互仍走既有动作路径(emit 由组件负责)。等值守卫防「父回写 → 同步 → 回弹」循环。\n const controlledPageIndex = () => toValue(options.pageIndex);\n const controlledPageSize = () => toValue(options.pageSize);\n const controlledSort = () => toValue(options.sort);\n const controlledSelectedKeys = () => toValue(options.selectedKeys);\n const controlledVisibleKeys = () => toValue(options.visibleKeys);\n\n // ---- 树形数据(T 系列) ------------------------------------------------------\n // 唯一解析点:无效配置 warn 并忽略;解析结果回传供组件读取 indentSize\n let tree: TreeOptions | undefined;\n if (options.tree !== undefined) {\n if (typeof options.tree !== \"object\" || options.tree === null) {\n warn(\"tree 必须是对象配置,已忽略。\");\n } else if (\n options.tree.childrenKey !== undefined &&\n typeof options.tree.childrenKey !== \"string\"\n ) {\n warn(\"tree.childrenKey 必须是字符串,已忽略。\");\n } else {\n tree = options.tree;\n }\n }\n const childrenKey = tree?.childrenKey ?? \"children\";\n\n // ---- 搜索表单(FormRender 联动) -------------------------------------------\n // any:FormRenderDefinition 对 T 不变,DataRecord 版拒收具体 defineForm<Q> 结果(见 types.ts)\n let search: FormRenderDefinition<any> | undefined;\n\n /** search 唯一装配入口:静态模式 / 缺 form·items 时 DEV 警告并忽略 */\n function applySearch(next: FormRenderDefinition<any> | undefined) {\n if (next === undefined) {\n search = undefined;\n return;\n }\n if (!serverMode) {\n warn(\"search 仅服务端模式生效(未传 onLoad),已忽略。\");\n search = undefined;\n return;\n }\n if (!next.form || !Array.isArray(next.items)) {\n warn(\"search 缺少 form 或 items,已忽略。\");\n search = undefined;\n return;\n }\n search = next;\n }\n\n applySearch(options.search);\n\n /** 拆分式/组件级装配口:definition 未配置 search 时由 TableRender 回填 prop(对齐 setRowKey) */\n function setSearch(next: FormRenderDefinition<any> | undefined) {\n if (search || !next) return;\n applySearch(next);\n }\n\n const page = reactive({\n pageIndex: 1,\n pageSize: controlledPageSize() ?? numericOption(options.pageSize) ?? 10,\n total: 0,\n pageSizeOpts: options.pageSizeOpts ?? DEFAULT_PAGE_SIZE_OPTS,\n });\n // defaultSort:静态模式进 TanStack 初始 sorting,服务端模式进首载 sort 参数\n const defaults = columns.filter((column) => column.defaultSort !== undefined);\n if (defaults.length > 1) {\n warn(`多列 defaultSort 仅首列 \"${defaults[0].key}\" 生效,其余已忽略。`);\n }\n if (defaults[0] && defaults[0].sortable !== true) {\n warn(`列 \"${defaults[0].key}\" 的 defaultSort 需要同时开启 sortable,已忽略。`);\n }\n const sorted = defaults.find((column) => column.sortable === true);\n\n // 初始值合并:受控初值优先于 defaultSort / pageSize 配置(避免 mount 后二次跳转与重复 load)\n const initialSort = controlledSort();\n const sort = ref<SortableOptions | undefined>(\n initialSort ?? (sorted ? { key: sorted.key, direction: sorted.defaultSort! } : undefined),\n );\n const loading = ref(false);\n const error = ref<Error | undefined>(undefined);\n const rows = shallowRef<T[]>([]);\n\n // ---- 行选择(S 系列) ------------------------------------------------------\n // 字符串简写 → 对象(S2)\n const rawSelection = options.rowSelection;\n const selectionConfig: TableSelectionOptions<T> | undefined =\n rawSelection === undefined\n ? undefined\n : typeof rawSelection === \"string\"\n ? { type: rawSelection }\n : rawSelection;\n // rowKey 由 defineTable 配置或 TableRender setup 时回填(S1);就绪前选择不可用\n const rowKey = ref(options.rowKey);\n const selectionEnabled = computed(() => selectionConfig !== undefined && !!rowKey.value);\n const selectedKeys = ref(new Set<string | number>()) as Ref<Set<string | number>>;\n const selectionRows = shallowRef<T[]>([]);\n /** key → 最近一次出现的行对象;跨页选中行由此返回快照(S6) */\n const selectionSnapshot = new Map<string, T>();\n /** 选中但当前数据中不存在的 key(reserveOnPageChange 语义,S12) */\n const dirtyKeys = new Set<string>();\n /** 受控选择状态:单一真相源,onRowSelectionChange 只通知不落盘(避免 setRowSelection 回环) */\n const rowSelectionState = ref<RowSelectionState>({});\n\n function selectionEmitSafe() {\n // 选择集变化 → 替换新 Set 触发依赖(S7);rows 从快照解析(含跨页)\n const keys = new Set<string | number>();\n for (const key of Object.keys(rowSelectionState.value))\n if (rowSelectionState.value[key]) keys.add(key);\n selectedKeys.value = keys;\n selectionRows.value = [...keys].map(\n (key) => selectionSnapshot.get(String(key)) ?? ({ [rowKey.value!]: key } as T),\n );\n }\n\n /** 选中集写入的唯一入口:赋受控 state + 重建对外投影 */\n function applyRowSelection(next: RowSelectionState) {\n rowSelectionState.value = next;\n selectionEmitSafe();\n }\n\n /** 行主键 → TanStack row id;rowKey 缺失时退化为索引(仅非选择场景可达,S1) */\n function rowIdOf(record: T, index: number): string {\n const key = rowKey.value;\n const value = key ? record[key] : undefined;\n return value === undefined || value === null ? `index-${index}` : String(value);\n }\n\n /** 数据窗口变化时刷新快照中已存在 key 的行对象(S6:后写覆盖) */\n function refreshSnapshot() {\n const key = rowKey.value;\n if (!key) return;\n let collisionWarned = false;\n for (const record of rows.value) {\n const value = record[key];\n if (value === undefined || value === null) continue;\n const id = String(value);\n if (selectionSnapshot.has(id) && !collisionWarned && import.meta.env.DEV) {\n // S11:撞 key 属数据问题,只提示一次\n if (selectionSnapshot.get(id) !== record) {\n collisionWarned = true;\n warn(`rowKey \"${key}\" 存在重复值,行选择快照以后出现的记录为准。`);\n }\n }\n selectionSnapshot.set(id, record);\n dirtyKeys.delete(id);\n }\n // 选中行对象可能刚被刷新:重建投影\n if (selectedKeys.value.size > 0) selectionEmitSafe();\n }\n\n // ---- 引擎组装 -------------------------------------------------------------\n const table = useVueTable({\n get data() {\n return rows.value;\n },\n getRowId: (originalRow, index) => rowIdOf(originalRow, index),\n // 树形:子行走 childrenKey(空数组与缺字段都视为叶子);展开模型接入后\n // getRowModel() 返回「父行 + 可见子行」的扁平序列,行带 depth/toggleExpanded\n getSubRows: (originalRow) => {\n const children = (originalRow as DataRecord)[childrenKey];\n return Array.isArray(children) ? children : [];\n },\n getExpandedRowModel: getExpandedRowModel(),\n columns: columns.map<ColumnDef<T>>((column) => ({\n accessorKey: column.key,\n header: column.title,\n enableSorting: column.sortable === true,\n })),\n initialState: {\n // 排序从投影初值构造(覆盖 defaultSort 与受控 sort 两种来源)\n sorting: sort.value ? [{ id: sort.value.key, desc: sort.value.direction === \"desc\" }] : [],\n // 初始 pageSize 须进 TanStack(此前只写对外投影,静态模式初始 pageSize≠10 不生效);\n // 受控初值优先(组件层受控 getter 未传时返回 undefined,须防御性取数值配置)\n pagination: {\n pageIndex: Math.max(0, (controlledPageIndex() ?? 1) - 1),\n pageSize: controlledPageSize() ?? numericOption(options.pageSize) ?? 10,\n },\n // defaultExpandAll:true = 全部展开;否则全收起(TanStack expanded 空对象)\n expanded: tree?.defaultExpandAll === true ? true : {},\n },\n getCoreRowModel: getCoreRowModel(),\n getPaginationRowModel: getPaginationRowModel(),\n getSortedRowModel: getSortedRowModel(),\n manualPagination: serverMode,\n manualSorting: serverMode,\n get state() {\n return { rowSelection: rowSelectionState.value };\n },\n enableRowSelection: selectionConfig?.selectable\n ? (row) => selectionConfig.selectable!(row.original)\n : selectionConfig !== undefined,\n enableMultiRowSelection: selectionConfig?.type !== \"radio\",\n onRowSelectionChange: (updater) => {\n const prev = rowSelectionState.value;\n const next = typeof updater === \"function\" ? updater(prev) : updater;\n // S4:radio 且 cancelable: false 时,解绑结果为空集则保持原状\n if (\n selectionConfig?.type === \"radio\" &&\n selectionConfig.cancelable === false &&\n !Object.keys(next).some((key) => next[key])\n ) {\n return;\n }\n applyRowSelection(next);\n },\n });\n\n watch(\n () => table.getState().pagination,\n (pagination) => {\n if (page.pageIndex === pagination.pageIndex + 1 && page.pageSize === pagination.pageSize)\n return;\n page.pageIndex = pagination.pageIndex + 1;\n page.pageSize = pagination.pageSize;\n },\n { immediate: true },\n );\n\n watch(\n () => table.getState().sorting,\n (sorting) => {\n const next: SortableOptions | undefined = sorting[0]\n ? { key: sorting[0].id, direction: sorting[0].desc ? \"desc\" : \"asc\" }\n : undefined;\n // 仅在语义发散时回写:toggleSort 已同步落值,等价对象回写会触发多余的重复加载\n if (sort.value?.key === next?.key && sort.value?.direction === next?.direction) return;\n sort.value = next;\n },\n { immediate: true },\n );\n\n // 静态数据源:ref/getter 会自动跟随;普通数组为快照,可用 reload() 重同步\n function syncData() {\n const data = toValue(options.data);\n if (data !== undefined && !Array.isArray(data)) {\n warn(\"data 必须是数组,已按空表处理。\");\n }\n // 复制出新引用:就地修改同一个普通数组时 shallowRef 不会触发,行模型会停留在旧快照\n rows.value = Array.isArray(data) ? [...data] : [];\n page.total = rows.value.length;\n }\n\n watch(() => toValue(options.data), syncData, { immediate: true });\n\n function setPageIndex(pageIndex: number) {\n table.setPageIndex(Math.max(0, pageIndex - 1));\n }\n\n function setPageSize(pageSize: number) {\n table.setPageSize(pageSize);\n // TanStack 容量变更后停在最后一页(pageCount-1),R9 要求回到首页\n table.setPageIndex(0);\n }\n\n /** 排序应用的唯一管线:服务端模式归位第 1 页(R8)+ 投影落值 + TanStack setSorting。\n * 受控 sort 的外部同步与此共用(直接 setSorting 会漏服务端重载) */\n function applySort(next: SortableOptions | undefined) {\n // 服务端模式按新排序取数,必须先归位到首页(R8)\n if (serverMode && page.pageIndex !== 1) setPageIndex(1);\n // 同步落值:对外投影不能等 watcher(emit 需要立即读到新排序)\n sort.value = next;\n table.setSorting(next ? [{ id: next.key, desc: next.direction === \"desc\" }] : []);\n }\n\n /** 排序三态:无 → asc → desc → 取消;非 sortable 列为空操作(R8) */\n function toggleSort(key: string) {\n if (!columns.some((column) => column.key === key && column.sortable === true)) return;\n\n const current = sort.value;\n const direction =\n current?.key !== key ? \"asc\" : current.direction === \"asc\" ? \"desc\" : undefined;\n\n applySort(direction ? { key, direction } : undefined);\n }\n\n // 服务端模式:请求序号守卫,乱序返回的旧响应直接丢弃(R6)\n let requestId = 0;\n\n async function load() {\n const id = ++requestId;\n loading.value = true;\n // 下一次 load 开始时清除上一次的错误(无论该 load 是否为当前请求)\n error.value = undefined;\n try {\n await options.onLoad?.({\n // 事件/取数时机读取是安全的(form.state 非响应式但同步);浅拷贝避免调用方改写真值\n form: search ? { ...search.form.state.values } : {},\n page: {\n pageIndex: page.pageIndex,\n pageSize: page.pageSize,\n total: page.total,\n pageSizeOpts: page.pageSizeOpts,\n },\n sort: sort.value,\n update: (data, total) => {\n if (id !== requestId) return;\n rows.value = Array.isArray(data) ? data : [];\n // total 缺省时保留旧值(R10)\n if (typeof total === \"number\") page.total = total;\n },\n });\n } catch (err) {\n // 乱序旧请求的失败直接丢弃(R6 同款守卫)\n if (id === requestId) {\n const normalized = err instanceof Error ? err : new Error(String(err));\n error.value = normalized;\n console.error(\"[tu-design] <TableRender> onLoad 执行失败:\", normalized);\n }\n } finally {\n if (id === requestId) loading.value = false;\n }\n }\n\n // 服务端模式下分页/排序变化即重取数;同一 tick 内多次变更只触发一次\n watch(\n () => (serverMode ? [page.pageIndex, page.pageSize, sort.value] : null),\n () => {\n void load();\n },\n );\n\n // ---- 受控同步(D11):外部变更 → TanStack -------------------------------------\n // 各 watch 均带语义等值守卫:内部先行(动作已生效)或父回写回弹时跳过,\n // 严禁死循环与重复 onLoad(load watch 绑定投影,投影等值守卫兜底)。\n // pageIndex 受控(1-based;最小归 1)\n watch(controlledPageIndex, (next) => {\n if (next === undefined || page.pageIndex === next) return;\n table.setPageIndex(Math.max(0, next - 1));\n });\n\n // pageSize 受控:同步容量;pageIndex 未受控时保持 R9 归位第 1 页(两方都受控由父层联动)\n watch(controlledPageSize, (next) => {\n if (next === undefined || page.pageSize === next) return;\n table.setPageSize(next);\n if (controlledPageIndex() === undefined) table.setPageIndex(0);\n });\n\n // sort 受控:经 applySort 管线(服务端归位 + 重载不漏);不可排序列警告并忽略\n watch(controlledSort, (next) => {\n if (next === undefined && sort.value === undefined) return;\n if (\n next &&\n sort.value &&\n next.key === sort.value.key &&\n next.direction === sort.value.direction\n ) {\n return;\n }\n if (next && !columns.some((c) => c.key === next.key && c.sortable === true)) {\n warn(`sort 受控值指向不可排序列 \"${next.key}\",已忽略。`);\n return;\n }\n applySort(next);\n });\n\n // selectedKeys 受控:经 setSelection 写入(S5 selectable 过滤 / S12 待定 key 语义继承)\n watch(\n controlledSelectedKeys,\n (next) => {\n if (next === undefined) return;\n const current = selectedKeys.value;\n // 语义等值(内容而非引用):内部勾选先行或父回写回弹时跳过,防 Set 重建触发的事件回环\n if (next.length === current.size && next.every((key) => current.has(key))) return;\n setSelection(next);\n },\n { immediate: true },\n );\n\n // ---- 列显隐(column visibility,R20–R24) -------------------------------------\n // 统一投影:受控初值 > defaultVisibleKeys(拆分式/聚合式 R26) > 全部可见。\n // 列显隐只动本 ref——不触发 onLoad、不重置 pageIndex/sort/selectedKeys(R25)。\n let emptyVisibleWarned = false;\n\n /** 规范化:未知 key 静默忽略、按 columns 原序、空数组钳制为首列(R24,warn 一次) */\n function normalizeVisibleKeys(keys: readonly string[]): string[] {\n const known = columns.filter((column) => keys.includes(column.key)).map((column) => column.key);\n if (known.length > 0) return known;\n if (columns.length > 0) {\n if (!emptyVisibleWarned) {\n warn(\"可见列不能为空,已钳制为首列可见。\");\n emptyVisibleWarned = true;\n }\n return [columns[0]!.key];\n }\n return [];\n }\n\n function sameVisibleKeys(a: readonly string[], b: readonly string[]): boolean {\n return a.length === b.length && a.every((key, index) => key === b[index]);\n }\n\n const parsedDefaultVisibleKeys = (() => {\n const raw = toValue(options.defaultVisibleKeys) ?? options.columnVisibility?.defaultVisibleKeys;\n return raw ? normalizeVisibleKeys(raw) : undefined;\n })();\n\n const visibleKeysInternal = ref<string[]>(\n controlledVisibleKeys()\n ? normalizeVisibleKeys(controlledVisibleKeys()!)\n : (parsedDefaultVisibleKeys ?? columns.map((column) => column.key)),\n );\n\n /** 列显隐动作(面板交互/程序化):规范化后更新统一投影 */\n function setVisibleKeys(keys: string[]) {\n visibleKeysInternal.value = normalizeVisibleKeys(keys);\n }\n\n // visibleKeys 受控:外部变更同步投影(规范化后语义等值跳过,防回弹)\n watch(controlledVisibleKeys, (next) => {\n console.log(\"DBG vk watch fired:\", JSON.stringify(next));\n if (next === undefined) return;\n const normalized = normalizeVisibleKeys(next);\n if (sameVisibleKeys(normalized, visibleKeysInternal.value)) return;\n visibleKeysInternal.value = normalized;\n });\n\n onMounted(() => {\n if (serverMode && (options.autoLoad ?? true)) void load();\n // S1:rowKey 在 defineTable 阶段可能尚未就绪(聚合式由 TableRender 回填),挂载时终审\n if (selectionConfig && !rowKey.value) {\n warn(\"rowSelection 需要有效的 rowKey 字段,已禁用行选择。\");\n }\n });\n\n function reload(resetPage = false) {\n if (serverMode) {\n // 归位由分页 watch 触发重载;页码本就为首页时直接重载(避免双请求)\n if (resetPage && page.pageIndex !== 1) setPageIndex(1);\n else void load();\n return;\n }\n if (resetPage) setPageIndex(1);\n syncData();\n }\n\n // ---- 行选择动作与联动(S 系列) -------------------------------------------\n\n /** 程序化设置选中集;不存在的 key 保留进入 dirtyKeys(S12);不可选行被过滤(对齐 S5) */\n function setSelection(keys: Array<string | number>) {\n const next: RowSelectionState = {};\n for (const key of keys) {\n const row = selectionSnapshot.get(String(key));\n // 快照中存在的行按 selectable 谓词过滤;待定 key(尚无行对象)无法判定的不拦\n if (row && selectionConfig?.selectable && !selectionConfig.selectable(row)) continue;\n next[String(key)] = true;\n if (!row) dirtyKeys.add(String(key));\n }\n applyRowSelection(next);\n }\n\n function clearSelection() {\n applyRowSelection({});\n }\n\n function toggleRowSelected(key: string, checked: boolean) {\n // S4:radio 且 cancelable: false 时,交互解绑最后一个选中为空操作\n if (!checked && selectionConfig?.type === \"radio\" && selectionConfig.cancelable === false) {\n return;\n }\n if (!checked) {\n const { [key]: _removed, ...rest } = rowSelectionState.value;\n applyRowSelection(rest);\n return;\n }\n // radio:单选互斥(S4);checkbox:累加\n const next =\n selectionConfig?.type === \"radio\"\n ? { [key]: true }\n : { ...rowSelectionState.value, [key]: true };\n applyRowSelection(next);\n }\n\n /** 拆分式装配口:TableRender setup 时回传组件 rowKey(S1) */\n function setRowKey(key: string | undefined) {\n if (rowKey.value === key) return;\n rowKey.value = key;\n // 聚合式下数据窗口早于 rowKey 就绪(pre-flush 先于子组件 setup),补建快照\n refreshSnapshot();\n }\n\n // 数据窗口变化(翻页或数据替换):刷新快照;reserveOnPageChange: false 时清空选中(S6)\n watch([rows, () => page.pageIndex], () => {\n refreshSnapshot();\n if (selectionConfig && selectionConfig.reserveOnPageChange === false) clearSelection();\n });\n\n return {\n columns,\n table,\n page: readonly(page),\n sort: readonly(sort),\n loading: readonly(loading),\n error: readonly(error),\n reload,\n toggleSort,\n setPageIndex,\n setPageSize,\n selection: {\n get value(): T[] {\n return selectionRows.value;\n },\n get enabled(): boolean {\n return selectionEnabled.value;\n },\n get type(): \"radio\" | \"checkbox\" {\n return selectionConfig?.type ?? \"checkbox\";\n },\n get width(): number {\n return selectionConfig?.width ?? 48;\n },\n },\n selectedKeys: selectedKeys as Readonly<Ref<Set<string | number>>>,\n setSelection,\n clearSelection,\n toggleRowSelected,\n // getter 而非快照:setSearch 由 TableRender 在 setup 回填,读取须反映最新值\n get search() {\n return search;\n },\n setSearch,\n // 纯配置透传(渲染层消费;不支持运行时切换)\n virtual: options.virtual,\n height: options.height,\n tree,\n // 列显隐(R20–R24):统一投影 + 动作 + 重置基准\n visibleKeys: readonly(visibleKeysInternal),\n setVisibleKeys,\n defaultVisibleKeys: parsedDefaultVisibleKeys,\n columnVisibility: options.columnVisibility,\n setRowKey,\n };\n}\n"
60
+ }
61
+ ]
62
+ }
@@ -9,31 +9,13 @@
9
9
  "path": "tabs/Tabs.vue",
10
10
  "type": "registry:component",
11
11
  "target": "components/ui/tabs/Tabs.vue",
12
- "content": "<script setup lang=\"ts\">\nimport { Tabs as ArkTabs } from \"@ark-ui/vue/tabs\";\n\ninterface Props {\n /** 当前激活的 tab 值(配合 v-model:value);不传时为非受控 */\n value?: string;\n defaultValue?: string;\n /** 切换模式:automatic 悬停聚焦即切换 / manual 需点击或 Enter */\n activationMode?: \"automatic\" | \"manual\";\n lazyMount?: boolean;\n unmountOnExit?: boolean;\n}\n\nconst props = defineProps<Props>();\n\nconst emit = defineEmits<{ \"update:value\": [value: string] }>();\n</script>\n\n<template>\n <ArkTabs.Root\n :model-value=\"props.value\"\n :default-value=\"props.defaultValue\"\n :activation-mode=\"props.activationMode\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:model-value=\"(value: string) => emit('update:value', value)\"\n >\n <slot />\n </ArkTabs.Root>\n</template>\n"
13
- },
14
- {
15
- "path": "tabs/TabsContent.vue",
16
- "type": "registry:component",
17
- "target": "components/ui/tabs/TabsContent.vue",
18
- "content": "<script setup lang=\"ts\">\nimport { Tabs as ArkTabs } from \"@ark-ui/vue/tabs\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n value: string;\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkTabs.Content :value=\"props.value\" :class=\"cn('flex-1 outline-none', props.class)\">\n <slot />\n </ArkTabs.Content>\n</template>\n"
19
- },
20
- {
21
- "path": "tabs/TabsList.vue",
22
- "type": "registry:component",
23
- "target": "components/ui/tabs/TabsList.vue",
24
- "content": "<script setup lang=\"ts\">\nimport { Tabs as ArkTabs } from \"@ark-ui/vue/tabs\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkTabs.List\n :class=\"\n cn(\n 'bg-muted text-muted-foreground inline-flex h-9 w-fit items-center justify-center rounded-lg p-[3px]',\n props.class,\n )\n \"\n >\n <slot />\n </ArkTabs.List>\n</template>\n"
25
- },
26
- {
27
- "path": "tabs/TabsTrigger.vue",
28
- "type": "registry:component",
29
- "target": "components/ui/tabs/TabsTrigger.vue",
30
- "content": "<script setup lang=\"ts\">\nimport { Tabs as ArkTabs } from \"@ark-ui/vue/tabs\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n value: string;\n disabled?: boolean;\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkTabs.Trigger\n :value=\"props.value\"\n :disabled=\"props.disabled\"\n :class=\"\n cn(\n 'data-[selected]:bg-background data-[selected]:text-foreground inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-2 py-1 text-sm font-medium whitespace-nowrap transition-[color,box-shadow] focus-visible:ring-ring/50 focus-visible:outline-none focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50 data-[selected]:shadow-sm',\n props.class,\n )\n \"\n >\n <slot />\n </ArkTabs.Trigger>\n</template>\n"
12
+ "content": "<script setup lang=\"ts\">\nimport { Tabs as ArkTabs } from \"@ark-ui/vue/tabs\";\nimport { computed, ref, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\n\n/** 单个标签页配置项 */\ninterface TabItem {\n /** 唯一标识,同时作为触发按钮与面板的 value */\n value: string;\n /** 触发按钮文案 */\n label: string;\n /** 是否禁用该标签(禁用项不参与键盘导航) */\n disabled?: boolean;\n /** 面板级覆盖:首次激活才挂载(缺省回落组件级 lazyMount) */\n lazyMount?: boolean;\n /** 面板级覆盖:切走即卸载(缺省回落组件级 unmountOnExit) */\n unmountOnExit?: boolean;\n /** 追加到触发按钮的样式类 */\n class?: string;\n}\n\ninterface Props {\n /** 标签页配置列表(必填) */\n items: TabItem[];\n /** 当前激活的 tab 值(配合 v-model:value);不传时为非受控 */\n value?: string;\n defaultValue?: string;\n /** 切换模式:automatic 聚焦即切换 / manual 需点击或 Enter */\n activationMode?: \"automatic\" | \"manual\";\n /** 组件级默认:面板首次激活才挂载(item.lazyMount 优先) */\n lazyMount?: boolean;\n /** 组件级默认:面板切走即卸载(item.unmountOnExit 优先) */\n unmountOnExit?: boolean;\n}\n\nconst props = defineProps<Props>();\n\nconst emit = defineEmits<{ \"update:value\": [value: string] }>();\n\n// —— 受控桥接(DatePicker 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst internalValue = ref(props.defaultValue);\nconst currentValue = computed(() => props.value ?? internalValue.value);\n\nfunction handleValueUpdate(next: string) {\n internalValue.value = next;\n emit(\"update:value\", next);\n}\n\n// —— 面板级挂载策略:复刻 ark usePresence 的 unmounted 公式,逐面板生效 ——\n// unmounted = (!active && !everActivated && lazyMount) || (unmountOnExit && !active && everActivated)\n// 说明:本版本 @ark-ui/vue 的 lazyMount/unmountOnExit 仅支持 Root 级全局策略,\n// 为实现 item 级覆盖,这里不经 Root 下发,由本组件自行计算每个面板的挂载与否。\nconst activatedValues = ref(new Set<string>());\nwatch(\n currentValue,\n (v) => {\n if (v == null || activatedValues.value.has(v)) return;\n activatedValues.value = new Set(activatedValues.value).add(v);\n },\n { immediate: true },\n);\n\nfunction isPanelUnmounted(item: TabItem): boolean {\n const active = currentValue.value === item.value;\n const everActivated = activatedValues.value.has(item.value);\n const lazyMount = item.lazyMount ?? props.lazyMount;\n const unmountOnExit = item.unmountOnExit ?? props.unmountOnExit;\n return (\n (!active && !everActivated && !!lazyMount) || (!!unmountOnExit && !active && everActivated)\n );\n}\n</script>\n\n<template>\n <ArkTabs.Root\n :model-value=\"currentValue\"\n :activation-mode=\"props.activationMode\"\n @update:model-value=\"handleValueUpdate\"\n >\n <ArkTabs.List\n class=\"bg-muted text-muted-foreground inline-flex h-9 w-fit items-center justify-center rounded-lg p-[3px]\"\n >\n <ArkTabs.Trigger\n v-for=\"item in props.items\"\n :key=\"item.value\"\n :value=\"item.value\"\n :disabled=\"item.disabled\"\n :class=\"\n cn(\n 'data-[selected]:bg-background data-[selected]:text-foreground inline-flex h-[calc(100%-1px)] flex-1 items-center justify-center gap-1.5 rounded-md border border-transparent px-2 py-1 text-sm font-medium whitespace-nowrap transition-[color,box-shadow] focus-visible:ring-ring/50 focus-visible:outline-none focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50 data-[selected]:shadow-sm',\n item.class,\n )\n \"\n >\n {{ item.label }}\n </ArkTabs.Trigger>\n </ArkTabs.List>\n\n <!-- 面板:hidden/挂载由本组件按 item 配置逐面板控制,不走 Root 的全局渲染策略 -->\n <ArkTabs.Context v-slot=\"api\">\n <template v-for=\"item in props.items\" :key=\"item.value\">\n <div\n v-if=\"!isPanelUnmounted(item)\"\n v-bind=\"api.getContentProps({ value: item.value })\"\n :data-state=\"currentValue === item.value ? 'open' : 'closed'\"\n class=\"flex-1 outline-none\"\n >\n <slot name=\"panel\" :item=\"item\" />\n </div>\n </template>\n </ArkTabs.Context>\n </ArkTabs.Root>\n</template>\n"
31
13
  },
32
14
  {
33
15
  "path": "tabs/index.ts",
34
16
  "type": "registry:component",
35
17
  "target": "components/ui/tabs/index.ts",
36
- "content": "export { default as Tabs } from \"./Tabs.vue\";\nexport { default as TabsContent } from \"./TabsContent.vue\";\nexport { default as TabsList } from \"./TabsList.vue\";\nexport { default as TabsTrigger } from \"./TabsTrigger.vue\";\n"
18
+ "content": "export { default as Tabs } from \"./Tabs.vue\";\n"
37
19
  }
38
20
  ]
39
21
  }
@@ -0,0 +1,28 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "toast",
4
+ "type": "registry:ui",
5
+ "description": "全局轻提示:ToastProvider 在应用根部挂载一次,useToast() 提供命令式 API(success/error/info/warning/loading/promise/dismiss);基于 Ark UI Toast 原语,语义 type 映射主题 token 配色。",
6
+ "registryDependencies": ["utils"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "files": [
9
+ {
10
+ "path": "toast/ToastProvider.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/toast/ToastProvider.vue",
13
+ "content": "<script setup lang=\"ts\">\nimport { computed, onBeforeUnmount, onMounted, shallowRef } from \"vue\";\nimport { Toaster, Toast } from \"@ark-ui/vue/toast\";\nimport type { ToastPlacement } from \"./useToast\";\nimport { cn } from \"@/lib/utils\";\nimport { __configureToaster, __setToastMounted } from \"./useToast\";\n\n/**\n * Toast 渲染容器:在应用根部挂载一次。\n * 内部按 props 重建 useToast 单例 store,随后所有 toast 方法经单例转发到这里渲染。\n */\nconst props = defineProps({\n /** 弹出位置 */\n placement: { type: String as () => ToastPlacement, default: \"bottom-end\" },\n /** 默认自动关闭时长(ms) */\n duration: { type: Number, default: 3000 },\n /** 同屏最大数量,超出排队 */\n max: { type: Number, default: 3 },\n});\n\n// setup 阶段同步重建:首次渲染的 <Toaster> 即持有新配置(zag 仅在挂载时消费 store)\nconst toaster = shallowRef(\n __configureToaster({ placement: props.placement, duration: props.duration, max: props.max }),\n);\n\nonMounted(() => __setToastMounted(true));\nonBeforeUnmount(() => __setToastMounted(false));\n\n/** 语义 type → token 样式(tokens.css 的 success/warning/info/destructive) */\nconst typeClass: Record<string, string> = {\n success: \"bg-success text-success-foreground\",\n error: \"bg-destructive text-white\",\n warning: \"bg-warning text-warning-foreground\",\n info: \"bg-info text-info-foreground\",\n loading: \"bg-primary text-primary-foreground\",\n default: \"bg-background text-foreground border-border\",\n};\n\nconst rootBase =\n \"flex w-[22rem] max-w-[calc(100vw-2rem)] items-start gap-3 rounded-md border p-4 shadow-lg duration-200 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=open]:fade-in-0 data-[state=closed]:fade-out-0 data-[placement*=top]:data-[state=open]:slide-in-from-top-2 data-[placement*=top]:data-[state=closed]:slide-out-to-top-2 data-[placement*=bottom]:data-[state=open]:slide-in-from-bottom-2 data-[placement*=bottom]:data-[state=closed]:slide-out-to-bottom-2\";\n\nconst rootClass = computed(\n () => (type: string) => cn(rootBase, typeClass[type] ?? typeClass.default),\n);\n</script>\n\n<template>\n <Toaster :toaster=\"toaster\" v-slot=\"t\">\n <Toast.Root :class=\"rootClass(String(t.type ?? 'default'))\">\n <!-- 语义图标:随 type 着色(loading 旋转) -->\n <span v-if=\"t.type\" class=\"mt-0.5 shrink-0\" :class=\"{ 'animate-spin': t.type === 'loading' }\">\n <svg\n v-if=\"t.type === 'success'\"\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 >\n <path d=\"M21.801 10A10 10 0 1 1 17 3.335\" />\n <path d=\"m9 11 3 3L22 4\" />\n </svg>\n <svg\n v-else-if=\"t.type === 'error'\"\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 >\n <circle cx=\"12\" cy=\"12\" r=\"10\" />\n <path d=\"m15 9-6 6\" />\n <path d=\"m9 9 6 6\" />\n </svg>\n <svg\n v-else-if=\"t.type === 'warning'\"\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 >\n <path d=\"m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3\" />\n <path d=\"M12 9v4\" />\n <path d=\"M12 17h.01\" />\n </svg>\n <svg\n v-else-if=\"t.type === 'info'\"\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 >\n <circle cx=\"12\" cy=\"12\" r=\"10\" />\n <path d=\"M12 16v-4\" />\n <path d=\"M12 8h.01\" />\n </svg>\n <svg\n v-else\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 >\n <path d=\"M21 12a9 9 0 1 1-6.219-8.56\" />\n </svg>\n </span>\n\n <div class=\"flex-1\">\n <Toast.Title class=\"text-sm font-semibold\">{{ t.title }}</Toast.Title>\n <Toast.Description v-if=\"t.description\" class=\"mt-1 text-sm opacity-90\">\n {{ t.description }}\n </Toast.Description>\n </div>\n\n <div class=\"flex shrink-0 items-center gap-1\">\n <Toast.ActionTrigger\n v-if=\"t.action\"\n class=\"inline-flex h-8 items-center rounded-sm px-2 text-sm font-medium underline-offset-4 hover:underline focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-current/50\"\n />\n <Toast.CloseTrigger\n aria-label=\"关闭\"\n class=\"inline-flex size-6 items-center justify-center rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-current/50\"\n >\n <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 >\n <path d=\"M18 6 6 18\" />\n <path d=\"m6 6 12 12\" />\n </svg>\n <span class=\"sr-only\">关闭</span>\n </Toast.CloseTrigger>\n </div>\n </Toast.Root>\n </Toaster>\n</template>\n"
14
+ },
15
+ {
16
+ "path": "toast/index.ts",
17
+ "type": "registry:component",
18
+ "target": "components/ui/toast/index.ts",
19
+ "content": "export { default as ToastProvider } from \"./ToastProvider.vue\";\nexport { useToast } from \"./useToast\";\nexport type { ToastOptions, ToastPlacement, ToastPromiseOptions, ToastApi } from \"./useToast\";\n"
20
+ },
21
+ {
22
+ "path": "toast/useToast.ts",
23
+ "type": "registry:component",
24
+ "target": "components/ui/toast/useToast.ts",
25
+ "content": "import { createToaster } from \"@ark-ui/vue/toast\";\nimport type {\n ToastOptions as ArkToastOptions,\n ToastPlacement as ArkToastPlacement,\n ToastPromiseOptions as ArkToastPromiseOptions,\n} from \"@ark-ui/vue/toast\";\n\nexport type ToastOptions = ArkToastOptions;\nexport type ToastPlacement = ArkToastPlacement;\nexport type ToastPromiseOptions<T> = ArkToastPromiseOptions<T>;\n\n/** Provider 缺省配置(与 Provider props 默认值保持一致) */\nconst DEFAULTS = {\n placement: \"bottom-end\" as ArkToastPlacement,\n duration: 3000,\n max: 3,\n};\n\n// 模块级单例:useToast() 在任何地方返回同一个外观对象(引用稳定),\n// 内部转发到 current 指向的 zag store;Provider 挂载时按 props 重建 store。\nlet current = createToaster(DEFAULTS);\nlet providerMounted = false;\n\n/**\n * 按 props 重建单例内部 store(ToastProvider 挂载时调用)。\n * 返回新 store 供 Provider 的 <Toaster> 渲染使用。\n */\nexport function __configureToaster(\n props: Partial<{ placement: ArkToastPlacement; duration: number; max: number }> = {},\n) {\n current = createToaster({ ...DEFAULTS, ...props });\n return current;\n}\n\n/** 读取当前内部 store(测试用) */\nexport function __getInternalToaster() {\n return current;\n}\n\n/** 标记 Provider 已挂载/已卸载(Provider 生命周期与测试用) */\nexport function __setToastMounted(value: boolean) {\n providerMounted = value;\n}\n\nfunction warnIfUnmounted() {\n if (!providerMounted && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] 在 <ToastProvider> 挂载前调用了 toast。请在应用根部挂载一次 <ToastProvider>,否则提示不会渲染。\",\n );\n }\n}\n\n// 外观对象在模块级创建一次,保证 useToast() 引用恒定\nconst toastApi = {\n /** 成功提示 */\n success: (options: ToastOptions) => {\n warnIfUnmounted();\n return current.create({ ...options, type: \"success\" });\n },\n /** 错误提示 */\n error: (options: ToastOptions) => {\n warnIfUnmounted();\n return current.create({ ...options, type: \"error\" });\n },\n /** 信息提示 */\n info: (options: ToastOptions) => {\n warnIfUnmounted();\n return current.create({ ...options, type: \"info\" });\n },\n /** 警告提示 */\n warning: (options: ToastOptions) => {\n warnIfUnmounted();\n return current.create({ ...options, type: \"warning\" });\n },\n /** 加载中提示 */\n loading: (options: ToastOptions) => {\n warnIfUnmounted();\n return current.create({ ...options, type: \"loading\" });\n },\n /** 跟踪 Promise 状态的提示 */\n promise: <T>(\n promise: Promise<T> | (() => Promise<T>),\n options: ArkToastPromiseOptions<T>,\n shared?: Omit<ToastOptions, \"type\">,\n ) => {\n warnIfUnmounted();\n return current.promise(promise, options, shared);\n },\n /** 关闭指定 toast;不传 id 时关闭全部 */\n dismiss: (id?: string) => {\n warnIfUnmounted();\n current.dismiss(id);\n },\n};\n\nexport function useToast() {\n return toastApi;\n}\n\nexport type ToastApi = typeof toastApi;\n"
26
+ }
27
+ ]
28
+ }
@@ -8,7 +8,7 @@
8
8
  "path": "styles/tokens.css",
9
9
  "type": "registry:style",
10
10
  "target": "styles/tokens.css",
11
- "content": "@import \"tw-animate-css\";\n\n@custom-variant dark (&:where(.dark, .dark *));\n\n:root {\n --background: oklch(1 0 0);\n --foreground: oklch(0.145 0 0);\n --card: oklch(1 0 0);\n --card-foreground: oklch(0.145 0 0);\n --popover: oklch(1 0 0);\n --popover-foreground: oklch(0.145 0 0);\n --primary: oklch(0.205 0 0);\n --primary-foreground: oklch(0.985 0 0);\n --secondary: oklch(0.97 0 0);\n --secondary-foreground: oklch(0.205 0 0);\n --muted: oklch(0.97 0 0);\n --muted-foreground: oklch(0.556 0 0);\n --accent: oklch(0.97 0 0);\n --accent-foreground: oklch(0.205 0 0);\n --destructive: oklch(0.577 0.245 27.325);\n --border: oklch(0.922 0 0);\n --input: oklch(0.922 0 0);\n --ring: oklch(0.708 0 0);\n --radius: 0.625rem;\n}\n\n.dark {\n --background: oklch(0.145 0 0);\n --foreground: oklch(0.985 0 0);\n --card: oklch(0.205 0 0);\n --card-foreground: oklch(0.985 0 0);\n --popover: oklch(0.269 0 0);\n --popover-foreground: oklch(0.985 0 0);\n --primary: oklch(0.922 0 0);\n --primary-foreground: oklch(0.205 0 0);\n --secondary: oklch(0.269 0 0);\n --secondary-foreground: oklch(0.985 0 0);\n --muted: oklch(0.269 0 0);\n --muted-foreground: oklch(0.708 0 0);\n --accent: oklch(0.371 0 0);\n --accent-foreground: oklch(0.985 0 0);\n --destructive: oklch(0.704 0.191 22.216);\n --border: oklch(1 0 0 / 10%);\n --input: oklch(1 0 0 / 15%);\n --ring: oklch(0.556 0 0);\n}\n\n@theme inline {\n --radius-sm: calc(var(--radius) - 4px);\n --radius-md: calc(var(--radius) - 2px);\n --radius-lg: var(--radius);\n --radius-xl: calc(var(--radius) + 4px);\n --color-background: var(--background);\n --color-foreground: var(--foreground);\n --color-card: var(--card);\n --color-card-foreground: var(--card-foreground);\n --color-popover: var(--popover);\n --color-popover-foreground: var(--popover-foreground);\n --color-primary: var(--primary);\n --color-primary-foreground: var(--primary-foreground);\n --color-secondary: var(--secondary);\n --color-secondary-foreground: var(--secondary-foreground);\n --color-muted: var(--muted);\n --color-muted-foreground: var(--muted-foreground);\n --color-accent: var(--accent);\n --color-accent-foreground: var(--accent-foreground);\n --color-destructive: var(--destructive);\n --color-border: var(--border);\n --color-input: var(--input);\n --color-ring: var(--ring);\n}\n\n/* 全局边框色兜底,对齐 shadcn v4 官方 tokens(上游另含 outline-ring/50,此处仅移植 border):\n 裸 border 类不再回退 currentColor,而是使用 --border token。 */\n@layer base {\n * {\n border-color: var(--color-border);\n }\n}\n"
11
+ "content": "@import \"tw-animate-css\";\n\n@custom-variant dark (&:where(.dark, .dark *));\n\n:root {\n --background: oklch(1 0 0);\n --foreground: oklch(0.145 0 0);\n --card: oklch(1 0 0);\n --card-foreground: oklch(0.145 0 0);\n --popover: oklch(1 0 0);\n --popover-foreground: oklch(0.145 0 0);\n --primary: oklch(0.205 0 0);\n --primary-foreground: oklch(0.985 0 0);\n --secondary: oklch(0.97 0 0);\n --secondary-foreground: oklch(0.205 0 0);\n --muted: oklch(0.97 0 0);\n --muted-foreground: oklch(0.556 0 0);\n --accent: oklch(0.97 0 0);\n --accent-foreground: oklch(0.205 0 0);\n --destructive: oklch(0.577 0.245 27.325);\n --success: oklch(0.596 0.145 163.225);\n --success-foreground: oklch(0.985 0 0);\n --warning: oklch(0.666 0.179 58.318);\n --warning-foreground: oklch(0.985 0 0);\n --info: oklch(0.546 0.245 262.881);\n --info-foreground: oklch(0.985 0 0);\n --border: oklch(0.922 0 0);\n --input: oklch(0.922 0 0);\n --ring: oklch(0.708 0 0);\n --radius: 0.625rem;\n}\n\n.dark {\n --background: oklch(0.145 0 0);\n --foreground: oklch(0.985 0 0);\n --card: oklch(0.205 0 0);\n --card-foreground: oklch(0.985 0 0);\n --popover: oklch(0.269 0 0);\n --popover-foreground: oklch(0.985 0 0);\n --primary: oklch(0.922 0 0);\n --primary-foreground: oklch(0.205 0 0);\n --secondary: oklch(0.269 0 0);\n --secondary-foreground: oklch(0.985 0 0);\n --muted: oklch(0.269 0 0);\n --muted-foreground: oklch(0.708 0 0);\n --accent: oklch(0.371 0 0);\n --accent-foreground: oklch(0.985 0 0);\n --destructive: oklch(0.704 0.191 22.216);\n --success: oklch(0.696 0.17 162.48);\n --success-foreground: oklch(0.985 0 0);\n --warning: oklch(0.769 0.188 70.08);\n --warning-foreground: oklch(0.205 0 0);\n --info: oklch(0.623 0.214 259.815);\n --info-foreground: oklch(0.985 0 0);\n --border: oklch(1 0 0 / 10%);\n --input: oklch(1 0 0 / 15%);\n --ring: oklch(0.556 0 0);\n}\n\n@theme inline {\n --radius-sm: calc(var(--radius) - 4px);\n --radius-md: calc(var(--radius) - 2px);\n --radius-lg: var(--radius);\n --radius-xl: calc(var(--radius) + 4px);\n --color-background: var(--background);\n --color-foreground: var(--foreground);\n --color-card: var(--card);\n --color-card-foreground: var(--card-foreground);\n --color-popover: var(--popover);\n --color-popover-foreground: var(--popover-foreground);\n --color-primary: var(--primary);\n --color-primary-foreground: var(--primary-foreground);\n --color-secondary: var(--secondary);\n --color-secondary-foreground: var(--secondary-foreground);\n --color-muted: var(--muted);\n --color-muted-foreground: var(--muted-foreground);\n --color-accent: var(--accent);\n --color-accent-foreground: var(--accent-foreground);\n --color-destructive: var(--destructive);\n --color-success: var(--success);\n --color-success-foreground: var(--success-foreground);\n --color-warning: var(--warning);\n --color-warning-foreground: var(--warning-foreground);\n --color-info: var(--info);\n --color-info-foreground: var(--info-foreground);\n --color-border: var(--border);\n --color-input: var(--input);\n --color-ring: var(--ring);\n}\n\n/* 全局边框色兜底,对齐 shadcn v4 官方 tokens(上游另含 outline-ring/50,此处仅移植 border):\n 裸 border 类不再回退 currentColor,而是使用 --border token。 */\n@layer base {\n * {\n border-color: var(--color-border);\n }\n}\n"
12
12
  }
13
13
  ]
14
14
  }
@@ -10,25 +10,13 @@
10
10
  "path": "tooltip/Tooltip.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/tooltip/Tooltip.vue",
13
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { Tooltip as ArkTooltip } from \"@ark-ui/vue/tooltip\";\n\ninterface Props {\n /** 受控开关(配合 v-model:open);不传时为非受控 */\n open?: boolean;\n defaultOpen?: boolean;\n /** 悬停多久后显示(毫秒) */\n delayDuration?: number;\n /** 移开后多久隐藏(毫秒) */\n closeDuration?: number;\n lazyMount?: boolean;\n unmountOnExit?: boolean;\n}\n\n// open 用 default: undefined 禁用 Boolean casting,保证「未传」可辨(Dialog 同款约定)\nconst props = defineProps({\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n delayDuration: { type: Number, default: undefined },\n closeDuration: { type: Number, default: undefined },\n lazyMount: { type: Boolean, default: false },\n unmountOnExit: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式,非受控语义由内部 ref 实现(Dialog 同款)\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n</script>\n\n<template>\n <ArkTooltip.Root\n :open=\"isOpen\"\n :open-delay=\"props.delayDuration\"\n :close-delay=\"props.closeDuration\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"handleUpdate\"\n >\n <slot />\n </ArkTooltip.Root>\n</template>\n"
14
- },
15
- {
16
- "path": "tooltip/TooltipContent.vue",
17
- "type": "registry:component",
18
- "target": "components/ui/tooltip/TooltipContent.vue",
19
- "content": "<script setup lang=\"ts\">\nimport { Tooltip as ArkTooltip } from \"@ark-ui/vue/tooltip\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkTooltip.Positioner class=\"z-50\">\n <ArkTooltip.Content\n :class=\"\n cn(\n 'bg-primary text-primary-foreground z-50 w-fit rounded-md px-3 py-1.5 text-sm data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95',\n props.class,\n )\n \"\n >\n <slot />\n </ArkTooltip.Content>\n </ArkTooltip.Positioner>\n</template>\n"
20
- },
21
- {
22
- "path": "tooltip/TooltipTrigger.vue",
23
- "type": "registry:component",
24
- "target": "components/ui/tooltip/TooltipTrigger.vue",
25
- "content": "<script setup lang=\"ts\">\nimport { Tooltip as ArkTooltip } from \"@ark-ui/vue/tooltip\";\n\ninterface Props {\n /** 以默认插槽子元素为渲染目标,行为合并其上 */\n asChild?: boolean;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkTooltip.Trigger :as-child=\"props.asChild\">\n <slot />\n </ArkTooltip.Trigger>\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref, useSlots } from \"vue\";\nimport { Tooltip as ArkTooltip } from \"@ark-ui/vue/tooltip\";\nimport { cn } from \"@/lib/utils\";\n\nconst props = defineProps({\n /** 提示文字;#content 插槽可覆盖以渲染富内容 */\n content: { type: String, default: undefined },\n /** 受控开关(配合 v-model:open);不传时为非受控 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n /** 悬停多久后显示(毫秒) */\n delayDuration: { type: Number, default: undefined },\n /** 移开后多久隐藏(毫秒) */\n closeDuration: { type: Number, default: undefined },\n lazyMount: { type: Boolean, default: false },\n unmountOnExit: { type: Boolean, default: false },\n /** 追加/覆盖气泡样式(经 cn 合并) */\n contentClass: { type: String, default: undefined },\n /** 透传到气泡 Content 的属性对象(id、data-*、事件监听等) */\n contentProps: {\n type: Object as PropType<Record<string, unknown>>,\n default: undefined,\n },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\nconst slots = useSlots();\n\n// open 用 default: undefined 禁用 Boolean casting,保证「未传」可辨(Dialog 同款约定)\n// 对 Root 恒走受控模式,非受控语义由内部 ref 实现(Dialog 同款)\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n</script>\n\n<template>\n <ArkTooltip.Root\n :open=\"isOpen\"\n :open-delay=\"props.delayDuration\"\n :close-delay=\"props.closeDuration\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"handleUpdate\"\n >\n <!-- 默认插槽即触发元素本身:Ark Trigger asChild 把行为(hover/focus、aria)合并其上,\n 不额外包裹元素。省略默认插槽即为纯受控气泡(open 驱动,配合 #content) -->\n <ArkTooltip.Trigger v-if=\"slots.default\" as-child>\n <slot />\n </ArkTooltip.Trigger>\n\n <ArkTooltip.Positioner class=\"z-50\">\n <ArkTooltip.Content\n v-bind=\"props.contentProps\"\n :class=\"\n cn(\n 'bg-primary text-primary-foreground z-50 w-fit rounded-md px-3 py-1.5 text-sm data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95',\n props.contentClass,\n )\n \"\n >\n <slot name=\"content\">{{ props.content }}</slot>\n </ArkTooltip.Content>\n </ArkTooltip.Positioner>\n </ArkTooltip.Root>\n</template>\n"
26
14
  },
27
15
  {
28
16
  "path": "tooltip/index.ts",
29
17
  "type": "registry:component",
30
18
  "target": "components/ui/tooltip/index.ts",
31
- "content": "export { default as Tooltip } from \"./Tooltip.vue\";\nexport { default as TooltipContent } from \"./TooltipContent.vue\";\nexport { default as TooltipTrigger } from \"./TooltipTrigger.vue\";\n"
19
+ "content": "export { default as Tooltip } from \"./Tooltip.vue\";\n"
32
20
  }
33
21
  ]
34
22
  }
@@ -0,0 +1,34 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "tree-select",
4
+ "type": "registry:ui",
5
+ "description": "树形下拉选择:一站式 props 驱动,支持单/多选、勾选级联、过滤与多标签折叠。",
6
+ "registryDependencies": ["tree-shared", "utils", "date-shared"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "files": [
9
+ {
10
+ "path": "tree-select/TreePanel.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/tree-select/TreePanel.vue",
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed } from \"vue\";\nimport ChevronIcon from \"../tree-shared/ChevronIcon.vue\";\nimport type { Key, TreeNode } from \"../tree-shared\";\nimport type { TreeOption } from \"../tree-shared\";\n\nconst props = defineProps({\n /** 展开态扁平化的可见节点序列(来自 treeMate.getFlattenedNodes(expandedKeys)) */\n nodes: { type: Array as PropType<Array<TreeNode>>, required: true },\n /** 当前选中键集合(用于 data-selected 回显) */\n selectedKeys: { type: Array as PropType<Key[]>, default: () => [] },\n /** 展开的分支键集合 */\n expandedKeys: { type: Array as PropType<Key[]>, default: () => [] },\n /** 键盘活动节点(Task 5 启用) */\n activeKey: { type: [String, Number] as PropType<Key | null>, default: null },\n /** 勾选模式:行首渲染 checkbox,选中语义由 checkedKeys 驱动 */\n checkable: { type: Boolean, default: false },\n /** 勾选键集合(级联归一后) */\n checkedKeys: { type: Array as PropType<Key[]>, default: () => [] },\n /** 半选键集合 */\n indeterminateKeys: { type: Array as PropType<Key[]>, default: () => [] },\n});\n\nconst emit = defineEmits<{\n select: [node: TreeNode];\n toggle: [node: TreeNode];\n}>();\n\nfunction label(node: TreeNode): string {\n return (node.rawNode as TreeOption).label ?? String(node.key);\n}\n\nfunction hasChildren(node: TreeNode): boolean {\n return !node.isLeaf && !!node.children?.length;\n}\n\nfunction isExpanded(node: TreeNode): boolean {\n return hasChildren(node) && props.expandedKeys.includes(node.key);\n}\n\nfunction isSelected(node: TreeNode): boolean {\n return props.checkable\n ? props.checkedKeys.includes(node.key)\n : props.selectedKeys.includes(node.key);\n}\n\nfunction isChecked(node: TreeNode): boolean {\n return props.checkedKeys.includes(node.key);\n}\n\nfunction isIndeterminate(node: TreeNode): boolean {\n return props.indeterminateKeys.includes(node.key);\n}\n</script>\n\n<template>\n <div class=\"max-h-[280px] overflow-auto p-1\" role=\"tree\">\n <div\n v-for=\"node in nodes\"\n :key=\"node.key\"\n role=\"treeitem\"\n :aria-level=\"node.level + 1\"\n :aria-selected=\"isSelected(node)\"\n :aria-checked=\"props.checkable ? isChecked(node) : undefined\"\n :aria-expanded=\"hasChildren(node) ? isExpanded(node) : undefined\"\n data-part=\"tree-node\"\n :data-key=\"node.key\"\n :data-selected=\"isSelected(node) ? '' : undefined\"\n :data-checked=\"isChecked(node) ? '' : undefined\"\n :data-indeterminate=\"isIndeterminate(node) ? '' : undefined\"\n :data-active=\"activeKey === node.key ? '' : undefined\"\n class=\"flex cursor-pointer items-center gap-1 rounded-sm py-1.5 pr-2 text-sm outline-none hover:bg-accent data-[active]:bg-accent data-[selected]:bg-accent\"\n :style=\"{ paddingLeft: `${node.level * 16 + 8}px` }\"\n @click=\"emit('select', node)\"\n >\n <span\n v-if=\"hasChildren(node)\"\n data-part=\"expand\"\n class=\"flex size-4 shrink-0 items-center justify-center text-muted-foreground\"\n :aria-label=\"isExpanded(node) ? '折叠' : '展开'\"\n @click.stop=\"emit('toggle', node)\"\n >\n <ChevronIcon :class=\"isExpanded(node) ? 'rotate-90' : ''\" />\n </span>\n <span v-else class=\"size-4 shrink-0\" aria-hidden=\"true\" />\n <span\n v-if=\"props.checkable\"\n data-part=\"checkbox\"\n :data-checked=\"isChecked(node) ? '' : undefined\"\n :data-indeterminate=\"isIndeterminate(node) ? '' : undefined\"\n class=\"flex size-4 shrink-0 items-center justify-center rounded-[3px] border border-input bg-background text-background data-[checked]:border-primary data-[checked]:bg-primary data-[indeterminate]:border-primary data-[indeterminate]:bg-primary\"\n aria-hidden=\"true\"\n >\n <svg\n v-if=\"isChecked(node)\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-3\"\n >\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n <svg\n v-else-if=\"isIndeterminate(node)\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n stroke-linecap=\"round\"\n class=\"size-3\"\n >\n <path d=\"M5 12h14\" />\n </svg>\n </span>\n <span class=\"truncate\">{{ label(node) }}</span>\n </div>\n <div v-if=\"nodes.length === 0\" class=\"px-2 py-6 text-center text-sm text-muted-foreground\">\n 无数据\n </div>\n </div>\n</template>\n"
14
+ },
15
+ {
16
+ "path": "tree-select/TreeSelect.vue",
17
+ "type": "registry:component",
18
+ "target": "components/ui/tree-select/TreeSelect.vue",
19
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, nextTick, ref, watch } from \"vue\";\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport { cn } from \"@/lib/utils\";\nimport { controlCls } from \"../date-shared/shared\";\nimport ChevronIcon from \"../tree-shared/ChevronIcon.vue\";\nimport ClearIcon from \"../tree-shared/ClearIcon.vue\";\nimport ValueTags from \"../tree-shared/ValueTags.vue\";\nimport { createTreeMate, type Key, type TreeNode, type TreeOption } from \"../tree-shared\";\nimport { nextActiveKey, type MoveKey } from \"../tree-shared/keyboard\";\nimport TreePanel from \"./TreePanel.vue\";\nimport type { TreeSelectTag } from \"./types\";\n\ndefineOptions({ inheritAttrs: false });\n\nconst props = defineProps({\n /** 树选项(key/label/children/disabled) */\n options: { type: Array as PropType<TreeOption[]>, required: true },\n /** 当前值:单选为 key,multiple 为 key 数组;不传走内部非受控 */\n modelValue: {\n type: [String, Number, Array] as PropType<Key | Key[] | undefined>,\n default: undefined,\n },\n defaultValue: {\n type: [String, Number, Array] as PropType<Key | Key[] | undefined>,\n default: undefined,\n },\n /** 多选:值恒为数组,点击节点切换选中 */\n multiple: { type: Boolean, default: false },\n /** 勾选模式:行首渲染 checkbox,值恒为数组(隐含多选语义) */\n checkable: { type: Boolean, default: false },\n /** 勾选级联:勾选父级联动全部子级(默认 false,对齐 naive-ui) */\n cascade: { type: Boolean, default: false },\n /** 勾选策略:all 值含全选节点 / parent 仅父 / child 仅叶(默认 all) */\n checkStrategy: { type: String as PropType<\"all\" | \"parent\" | \"child\">, default: \"all\" },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n placeholder: { type: String, default: \"请选择\" },\n /** 多选最多展示标签数,超出折叠为 +N */\n maxTagCount: { type: Number, default: undefined },\n /** 展示清空按钮 */\n clearable: { type: Boolean, default: false },\n /** 可搜索:触发器内嵌输入框,按 label 过滤(展示命中节点及其祖先路径) */\n filterable: { type: Boolean, default: false },\n /** 受控展开键集合;undefined 走内部非受控 */\n expandedKeys: { type: Array as PropType<Key[] | undefined>, default: undefined },\n defaultExpandedKeys: { type: Array as PropType<Key[]>, default: () => [] },\n /** 初始展开全部分支 */\n defaultExpandAll: { type: Boolean, default: false },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: Key | Key[] | undefined];\n \"update:show\": [open: boolean];\n \"update:expandedKeys\": [keys: Key[]];\n}>();\n\n// —— 受控桥接(Select/DatePicker 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst internalValue = ref<Key | Key[] | undefined>(props.defaultValue);\nconst value = computed<Key | Key[] | undefined>(() =>\n props.modelValue !== undefined ? props.modelValue : internalValue.value,\n);\n\n// —— 树数据:options 变更即重建;值中的失效 key 经 getNode 静默忽略 ——\nconst treeMate = computed(() => createTreeMate(props.options, { ignoreEmptyChildren: true }));\n\nconst internalExpanded = ref<Key[]>(\n props.defaultExpandAll\n ? treeMate.value.getNonLeafKeys({ preserveGroup: true })\n : [...props.defaultExpandedKeys],\n);\nconst expandedKeys = computed<Key[]>(() => props.expandedKeys ?? internalExpanded.value);\n\nfunction handleExpandedUpdate(keys: Key[]) {\n internalExpanded.value = keys;\n emit(\"update:expandedKeys\", keys);\n}\n\nfunction toggleNode(node: TreeNode) {\n const next = expandedKeys.value.includes(node.key)\n ? expandedKeys.value.filter((k) => k !== node.key)\n : [...expandedKeys.value, node.key];\n handleExpandedUpdate(next);\n}\n\nfunction toArrayValue(v: Key | Key[] | undefined): Key[] {\n if (v === undefined) return [];\n return Array.isArray(v) ? v : [v];\n}\n\n// checkable 值语义恒为数组:单值 Key 输入按无选中处理并 dev 警告一次\nlet warnedNonArrayValue = false;\nfunction normalizeValue(v: Key | Key[] | undefined): Key[] {\n if (v === undefined) return [];\n if (Array.isArray(v)) return v;\n if (props.checkable) {\n if (import.meta.env?.DEV && !warnedNonArrayValue) {\n warnedNonArrayValue = true;\n console.warn(\"[TreeSelect] checkable 模式下 modelValue 需为数组,单值输入已按无选中处理。\");\n }\n return [];\n }\n return [v];\n}\n\nconst selectedKeys = computed<Key[]>(() => toArrayValue(value.value));\n\nconst checkOptions = computed(() => ({\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n}));\n\n// 勾选模式的展示状态(级联归一后的选中/半选集合)\nconst checkedState = computed<{ checked: Key[]; indeterminate: Key[] }>(() => {\n if (!props.checkable) return { checked: selectedKeys.value, indeterminate: [] };\n const merged = treeMate.value.getCheckedKeys(normalizeValue(value.value), checkOptions.value);\n return { checked: merged.checkedKeys, indeterminate: merged.indeterminateKeys };\n});\n\nconst tags = computed<TreeSelectTag[]>(() =>\n selectedKeys.value\n .map((key) => {\n const node = treeMate.value.getNode(key);\n return node ? { key, label: (node.rawNode as TreeOption).label ?? String(key) } : null;\n })\n .filter((t): t is TreeSelectTag => t !== null),\n);\n\n// checkable 隐含多选语义(值恒为 Key[],与 multiple 等价)\nconst isMulti = computed(() => props.multiple || props.checkable);\n\nconst singleLabel = computed(() => (isMulti.value ? \"\" : (tags.value[0]?.label ?? \"\")));\n\nfunction updateValue(next: Key | Key[] | undefined) {\n internalValue.value = next;\n emit(\"update:modelValue\", next);\n}\n\nfunction selectNode(node: TreeNode) {\n if (node.disabled) return;\n if (props.checkable) {\n const current = normalizeValue(value.value);\n const isNodeChecked = checkedState.value.checked.includes(node.key);\n const merged = isNodeChecked\n ? treeMate.value.uncheck(node.key, current, checkOptions.value)\n : treeMate.value.check(node.key, current, checkOptions.value);\n updateValue(merged.checkedKeys);\n return;\n }\n if (props.multiple) {\n const current = toArrayValue(value.value);\n const next = current.includes(node.key)\n ? current.filter((k) => k !== node.key)\n : [...current, node.key];\n updateValue(next);\n } else {\n updateValue(node.key);\n handleOpenUpdate(false);\n }\n}\n\n// checkStrategy / cascade 运行时切换:值集合按新策略归一\nwatch(checkOptions, () => {\n if (!props.checkable) return;\n const normalized = treeMate.value.getCheckedKeys(normalizeValue(value.value), checkOptions.value);\n const current = toArrayValue(value.value);\n if (\n normalized.checkedKeys.length !== current.length ||\n normalized.checkedKeys.some((k) => !current.includes(k))\n ) {\n updateValue(normalized.checkedKeys);\n }\n});\n\nfunction removeTag(key: Key) {\n const next = toArrayValue(value.value).filter((k) => k !== key);\n internalValue.value = next;\n emit(\"update:modelValue\", next);\n}\n\nconst hasValue = computed(() => tags.value.length > 0);\n\nfunction handleClear() {\n const next = isMulti.value ? [] : undefined;\n internalValue.value = next;\n emit(\"update:modelValue\", next);\n}\n\n// —— 弹层开合(点击/键盘 ↓ 显式驱动,保证各环境一致)——\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleOpenUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:show\", open);\n}\n\nfunction openFromInput() {\n if (props.disabled || isOpen.value) return;\n syncPanelWidth();\n handleOpenUpdate(true);\n}\n\n// —— 面板宽度对齐触发器 ——\nconst triggerEl = ref<HTMLElement | null>(null);\nconst panelMinWidth = ref(\"0px\");\nfunction syncPanelWidth() {\n panelMinWidth.value = `${triggerEl.value?.offsetWidth ?? 0}px`;\n}\n\nconst visibleNodes = computed(() => treeMate.value.getFlattenedNodes(expandedKeys.value));\n\n// —— 过滤:命中节点及其祖先路径可见(搜索态下全树展开)——\nconst pattern = ref(\"\");\nconst searchPattern = computed(() => pattern.value.trim().toLowerCase());\nconst filteredNodes = computed<TreeNode[]>(() => {\n if (!props.filterable || !searchPattern.value) return visibleNodes.value;\n const mate = treeMate.value;\n // 命中节点与其全部祖先均保留(祖先自身无命中也保留)\n const keep = new Set<Key>();\n const allNodes = mate.getFlattenedNodes(mate.getNonLeafKeys({ preserveGroup: true }));\n for (const node of allNodes) {\n const path = mate.getPath(node.key);\n if (path.treeNodePath.some((tn) => labelOf(tn).toLowerCase().includes(searchPattern.value))) {\n path.treeNodePath.forEach((tn) => keep.add(tn.key));\n }\n }\n return allNodes.filter((n) => keep.has(n.key));\n});\n\nfunction labelOf(node: TreeNode): string {\n return (node.rawNode as TreeOption).label ?? String(node.key);\n}\n\n// —— 键盘导航(↑↓←→ / Home / End / Enter,游标仅落在非 disabled 节点)——\nconst activeKey = ref<Key | null>(null);\nconst MOVE_KEYS: MoveKey[] = [\"ArrowDown\", \"ArrowUp\", \"Home\", \"End\"];\n\nfunction scrollActiveIntoView() {\n nextTick(() => {\n document\n .querySelector('[data-part=\"tree-node\"][data-active]')\n ?.scrollIntoView?.({ block: \"nearest\" });\n });\n}\n\nfunction moveHorizontally(expand: boolean) {\n if (activeKey.value === null) return;\n const node = filteredNodes.value.find((n) => n.key === activeKey.value);\n if (!node) return;\n if (expand) {\n if (node.isLeaf || !node.children?.length) return;\n if (!expandedKeys.value.includes(node.key)) {\n handleExpandedUpdate([...expandedKeys.value, node.key]);\n return;\n }\n const firstChild = node.children.find((c) => !c.disabled);\n if (firstChild) activeKey.value = firstChild.key;\n } else {\n if (node.children?.length && expandedKeys.value.includes(node.key)) {\n handleExpandedUpdate(expandedKeys.value.filter((k) => k !== node.key));\n return;\n }\n if (node.parent && !node.parent.ignored) activeKey.value = node.parent.key;\n }\n}\n\nfunction handleKeydown(e: KeyboardEvent) {\n if (props.disabled) return;\n if (!isOpen.value) {\n if (e.key === \"ArrowDown\" || e.key === \"Enter\") {\n e.preventDefault();\n openFromInput();\n }\n return;\n }\n if ((MOVE_KEYS as string[]).includes(e.key)) {\n e.preventDefault();\n activeKey.value = nextActiveKey(filteredNodes.value, activeKey.value, e.key as MoveKey);\n scrollActiveIntoView();\n return;\n }\n if (e.key === \"ArrowRight\" || e.key === \"ArrowLeft\") {\n e.preventDefault();\n moveHorizontally(e.key === \"ArrowRight\");\n return;\n }\n if (e.key === \"Enter\") {\n e.preventDefault();\n const node = filteredNodes.value.find((n) => n.key === activeKey.value);\n if (node) selectNode(node);\n }\n}\n\n// 弹层开合时重置键盘游标与搜索词\nwatch(isOpen, (open) => {\n activeKey.value = null;\n if (open) syncPanelWidth();\n else pattern.value = \"\";\n});\n</script>\n\n<template>\n <ArkPopover.Root :open=\"isOpen\" @update:open=\"handleOpenUpdate\">\n <ArkPopover.Anchor as-child>\n <div\n ref=\"triggerEl\"\n v-bind=\"$attrs\"\n data-part=\"trigger\"\n role=\"button\"\n tabindex=\"0\"\n :aria-expanded=\"isOpen\"\n aria-haspopup=\"true\"\n :aria-disabled=\"props.disabled || undefined\"\n :class=\"\n cn(\n controlCls,\n 'min-h-9 cursor-pointer gap-2 px-3 py-1.5 text-sm',\n props.disabled && 'cursor-not-allowed opacity-50',\n props.class,\n )\n \"\n @click=\"openFromInput\"\n @keydown=\"handleKeydown\"\n >\n <template v-if=\"isMulti\">\n <ValueTags\n v-if=\"tags.length\"\n :values=\"tags\"\n :max-tag-count=\"props.maxTagCount\"\n :disabled=\"!!props.disabled\"\n @remove=\"removeTag\"\n />\n <input\n v-if=\"props.filterable\"\n v-model=\"pattern\"\n data-part=\"input\"\n type=\"text\"\n class=\"h-5 w-12 min-w-0 flex-1 bg-transparent outline-none placeholder:text-muted-foreground\"\n :placeholder=\"tags.length ? '' : props.placeholder\"\n :aria-label=\"props.placeholder\"\n />\n <span v-if=\"!tags.length && !props.filterable\" class=\"truncate text-muted-foreground\">{{\n props.placeholder\n }}</span>\n </template>\n <template v-else>\n <input\n v-if=\"props.filterable\"\n v-model=\"pattern\"\n data-part=\"input\"\n type=\"text\"\n class=\"h-full w-full min-w-0 flex-1 bg-transparent outline-none placeholder:text-muted-foreground\"\n :placeholder=\"singleLabel || props.placeholder\"\n :aria-label=\"props.placeholder\"\n />\n <template v-else>\n <span v-if=\"singleLabel\" class=\"truncate\">{{ singleLabel }}</span>\n <span v-else class=\"truncate text-muted-foreground\">{{ props.placeholder }}</span>\n </template>\n </template>\n <span class=\"ml-auto flex shrink-0 items-center gap-1\">\n <span\n v-if=\"props.clearable && hasValue && !props.disabled\"\n role=\"button\"\n data-part=\"clear\"\n class=\"text-muted-foreground hover:text-foreground\"\n aria-label=\"清空\"\n @click.stop=\"handleClear\"\n >\n <ClearIcon />\n </span>\n <ChevronIcon\n :class=\"\n cn('text-muted-foreground transition-transform', isOpen ? '-rotate-90' : 'rotate-90')\n \"\n />\n </span>\n </div>\n </ArkPopover.Anchor>\n\n <!-- 弹层 Teleport 到 body:脱离表单 DOM,消除 overflow 容器裁剪隐患(DatePicker 同款) -->\n <Teleport to=\"body\">\n <ArkPopover.Positioner class=\"z-50\">\n <ArkPopover.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground z-50 rounded-md border p-0 shadow-md outline-none data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95',\n )\n \"\n :style=\"{ minWidth: panelMinWidth }\"\n @keydown=\"handleKeydown\"\n >\n <TreePanel\n :nodes=\"filteredNodes\"\n :selected-keys=\"selectedKeys\"\n :expanded-keys=\"expandedKeys\"\n :active-key=\"activeKey\"\n :checkable=\"props.checkable\"\n :checked-keys=\"checkedState.checked\"\n :indeterminate-keys=\"checkedState.indeterminate\"\n @select=\"selectNode\"\n @toggle=\"toggleNode\"\n />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </Teleport>\n </ArkPopover.Root>\n</template>\n"
20
+ },
21
+ {
22
+ "path": "tree-select/index.ts",
23
+ "type": "registry:component",
24
+ "target": "components/ui/tree-select/index.ts",
25
+ "content": "export { default as TreeSelect } from \"./TreeSelect.vue\";\nexport type { CheckStrategy, Key, TreeOption } from \"../tree-shared\";\n"
26
+ },
27
+ {
28
+ "path": "tree-select/types.ts",
29
+ "type": "registry:component",
30
+ "target": "components/ui/tree-select/types.ts",
31
+ "content": "import type { Key } from \"../tree-shared\";\n\n/** 触发器多选标签的展示结构(由选中 key 经 treeMate.getNode 解析,失效 key 静默剔除) */\nexport interface TreeSelectTag {\n key: Key;\n label: string;\n}\n"
32
+ }
33
+ ]
34
+ }