@tu-design/vue 0.5.3 → 0.5.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.mts +274 -75
- package/dist/index.mjs +477 -133
- package/dist/registry/vue/alert-dialog.json +2 -2
- package/dist/registry/vue/alert.json +1 -1
- package/dist/registry/vue/avatar-group.json +1 -1
- package/dist/registry/vue/avatar.json +1 -1
- package/dist/registry/vue/badge.json +1 -1
- package/dist/registry/vue/button.json +1 -1
- package/dist/registry/vue/calendar.json +1 -1
- package/dist/registry/vue/card.json +1 -1
- package/dist/registry/vue/cascader.json +2 -2
- package/dist/registry/vue/checkbox.json +1 -1
- package/dist/registry/vue/context-menu.json +3 -3
- package/dist/registry/vue/currency-input.json +1 -1
- package/dist/registry/vue/date-picker.json +2 -2
- package/dist/registry/vue/date-range-picker.json +2 -2
- package/dist/registry/vue/date-shared.json +8 -2
- package/dist/registry/vue/dialog.json +2 -2
- package/dist/registry/vue/drawer.json +2 -2
- package/dist/registry/vue/dropdown-menu.json +2 -2
- package/dist/registry/vue/empty.json +1 -1
- package/dist/registry/vue/form-render.json +1 -1
- package/dist/registry/vue/form.json +1 -1
- package/dist/registry/vue/icon-shared.json +1 -1
- package/dist/registry/vue/input.json +1 -1
- package/dist/registry/vue/label.json +1 -1
- package/dist/registry/vue/month-picker.json +2 -2
- package/dist/registry/vue/number-input.json +1 -1
- package/dist/registry/vue/overlay-shared.json +13 -1
- package/dist/registry/vue/password-input.json +1 -1
- package/dist/registry/vue/pin-input.json +1 -1
- package/dist/registry/vue/popconfirm.json +1 -1
- package/dist/registry/vue/popover.json +2 -2
- package/dist/registry/vue/progress.json +1 -1
- package/dist/registry/vue/radio-group.json +1 -1
- package/dist/registry/vue/registry.json +52 -52
- package/dist/registry/vue/select.json +2 -2
- package/dist/registry/vue/separator.json +1 -1
- package/dist/registry/vue/skeleton.json +1 -1
- package/dist/registry/vue/slider.json +1 -1
- package/dist/registry/vue/slot.json +1 -1
- package/dist/registry/vue/spin.json +1 -1
- package/dist/registry/vue/switch.json +1 -1
- package/dist/registry/vue/table-render.json +4 -4
- package/dist/registry/vue/tabs.json +1 -1
- package/dist/registry/vue/textarea.json +1 -1
- package/dist/registry/vue/timeline.json +1 -1
- package/dist/registry/vue/toast.json +1 -1
- package/dist/registry/vue/tokens.json +2 -2
- package/dist/registry/vue/tooltip.json +2 -2
- package/dist/registry/vue/tree-select.json +2 -2
- package/dist/registry/vue/tree-shared.json +1 -1
- package/dist/registry/vue/utils.json +1 -1
- package/dist/registry/vue/week-picker.json +2 -2
- package/dist/registry/vue/year-picker.json +2 -2
- package/package.json +2 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "table-render",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.5",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "配置驱动表格渲染器:defineTable 聚合 TanStack Table 实例与列配置,静态/服务端双模式(onLoad 回写分页排序),搜索表单联动(search 接 FormRender),左右固定列 sticky 横向滚动,表体虚拟滚动(virtual + height,TanStack Virtual 动态测量行高),树形数据(tree:子行展开/收起、depth 缩进、caret 位于首列),列显隐(columnSettings 面板 + visibleKeys 受控),错误态占位与重试(#error 插槽 + load-error),ellipsis 支持 tooltip 形态,v-model 受控(pageIndex/pageSize/sort/selectedKeys),Ark Pagination 分页条 + 原生 select 每页条数,排序表头 aria-sort、加载骨架与空态插槽,语义化 table + Tailwind tokens。",
|
|
7
7
|
"registryDependencies": [
|
|
@@ -38,7 +38,7 @@
|
|
|
38
38
|
"path": "table-render/TableRender.vue",
|
|
39
39
|
"type": "registry:component",
|
|
40
40
|
"target": "components/ui/table-render/TableRender.vue",
|
|
41
|
-
"content": "<script setup lang=\"ts\">\nimport type { ComponentPublicInstance, PropType, VNodeChild } from \"vue\";\nimport { useVirtualizer } from \"@tanstack/vue-virtual\";\nimport { columnRenders } from \"./column-renders\";\nimport { computed, onMounted, ref, watch } from \"vue\";\nimport { Button } from \"@/components/ui/button\";\nimport { Checkbox } from \"@/components/ui/checkbox\";\nimport { FormRender, type FormRenderDefinition } from \"@/components/ui/form-render\";\nimport { Popover } from \"@/components/ui/popover\";\nimport { Separator } from \"@/components/ui/separator\";\nimport { Skeleton } from \"@/components/ui/skeleton\";\nimport { Tooltip } from \"@/components/ui/tooltip\";\nimport { cn } from \"@/lib/utils\";\nimport { SELECTION_CELL } from \"./constants\";\nimport { stickyClass, stickyStyle, type StickyMap } from \"./sticky\";\nimport TableBodyRow from \"./TableBodyRow.vue\";\nimport TablePagination from \"./TablePagination.vue\";\nimport type {\n ColumnVisibilityOptions,\n DataRecord,\n SortableOptions,\n TableBodyLine,\n TableColumnOptions,\n TableLoadParams,\n TableRenderDefinition,\n TableSelectionOptions,\n TreeOptions,\n} from \"./types\";\nimport { useTableRender } from \"./useTableRender\";\n\n// boolean flags 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false;Checkbox/Dialog/FormRender 同款约定)\nconst props = defineProps({\n /** 聚合式(推荐):defineTable 返回的定义对象 */\n definition: { type: Object as PropType<TableRenderDefinition<any>> },\n /** 数据主键(记录缺字段时以行索引兜底) */\n rowKey: { type: String, required: true },\n /** 拆分式:与 definition 二选一,definition 优先 */\n columns: { type: Array as PropType<TableColumnOptions[]> },\n onLoad: {\n type: Function as PropType<(params: TableLoadParams) => void | Promise<unknown>>,\n },\n data: { type: Array as PropType<DataRecord[]> },\n autoLoad: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 每页条数 / 受控每页条数(D11):传入即受控(pageIndex 未受控时 R9 归位内部处理并通知) */\n pageSize: { type: Number },\n pageSizeOpts: { type: Array as PropType<number[]> },\n loading: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n emptyText: { type: String },\n /** 行选择(仅拆分式生效;聚合式请在 defineTable 配置):\"radio\" | \"checkbox\" | 对象 */\n rowSelection: {\n type: [String, Object] as PropType<\"radio\" | \"checkbox\" | TableSelectionOptions>,\n default: undefined,\n },\n /** 搜索表单(defineForm 返回值):拆分式直接传;聚合式请在 defineTable 配置(definition 优先,同传 DEV 警告) */\n search: { type: Object as PropType<FormRenderDefinition<any>> },\n /** 虚拟滚动:开启后表体行虚拟化渲染;聚合式请在 defineTable 配置(definition 优先);须同时给 height */\n virtual: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 虚拟滚动容器高度(数字 px 或 CSS 高度);仅 virtual: true 时生效 */\n height: { type: [Number, String] as PropType<number | string> },\n /** 树形数据(子行展开/收起);拆分式直接传,聚合式请在 defineTable 配置 */\n tree: { type: Object as PropType<TreeOptions> },\n /** 受控页码(1-based):传入即受控,缺省非受控;内部翻页经 update:page-index 通知 */\n pageIndex: { type: Number },\n /** 受控排序:传入即受控;内部/外部变化均经 sort-change 通知 */\n sort: { type: Object as PropType<SortableOptions> },\n /** 受控选中集(数组,与 update:selected-keys 载荷同构):传入即受控 */\n selectedKeys: { type: Array as PropType<Array<string | number>> },\n /** 受控可见列 key(columns 原序子集):传入即受控;内部显隐经 update:visible-keys 通知 */\n visibleKeys: { type: Array as PropType<string[]> },\n /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(R26,definition 优先) */\n defaultVisibleKeys: { type: Array as PropType<string[]> },\n /** 列设置触发器/面板开关(默认 true);false 时不渲染 UI,受控 API 不受影响 */\n columnSettings: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 搜索区渲染开关(R27):false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */\n showSearch: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 分页条渲染开关(R28):false 关闭内置分页条(组合式外置 TablePagination);缺省模式 R13 不变 */\n showPagination: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:page-index\": [pageIndex: number];\n \"update:page-size\": [pageSize: number];\n \"sort-change\": [sort: SortableOptions | undefined];\n \"row-click\": [record: DataRecord, index: number, event: MouseEvent];\n /** 行双击(与 row-click 独立,双击会先后触发 click 两次,属预期) */\n \"row-dblclick\": [record: DataRecord, index: number, event: MouseEvent];\n /** 行右键;不主动 preventDefault */\n \"row-contextmenu\": [record: DataRecord, index: number, event: MouseEvent];\n /** 单元格点击(columnKey 定位列);冒泡并存——cell-click 触发时 row-click 也会触发 */\n \"cell-click\": [record: DataRecord, columnKey: string, index: number, event: MouseEvent];\n \"selection-change\": [rows: DataRecord[]];\n \"update:selected-keys\": [keys: Array<string | number>];\n /** 搜索:FormRender 校验通过后触发;载荷为当前表单值 */\n search: [values: DataRecord];\n /** 重置:FormRender 已重置为 defaults 后触发;载荷为重置后的表单值 */\n reset: [values: DataRecord];\n /** 服务端模式 onLoad 抛错/ rejects 时触发;下一次 load 开始时 error 投影清除 */\n \"load-error\": [error: Error];\n /** 可见列变化(受控回写通知 / v-model:visible-keys) */\n \"update:visible-keys\": [keys: string[]];\n /** 列显隐变化(受控/非受控均触发,供业务持久化;载荷 = 可见列 key 有序数组,columns 原序) */\n \"column-visibility-change\": [keys: string[]];\n}>();\n\ndefineSlots<{\n empty?: () => VNodeChild;\n /** 错误态占位(服务端模式 onLoad 失败时渲染,优先于数据区) */\n error?: (props: { error: Error | undefined; retry: () => void }) => VNodeChild;\n}>();\n\n/** 加载态骨架行数(R14) */\nconst SKELETON_ROWS = [1, 2, 3, 4, 5];\n\n/** 内置渲染器单例:render 工厂按列求值时复用(工厂本身轻量,仅为整洁) */\nconst RENDERS = columnRenders();\n\n// 聚合式直接复用 defineTable 建好的内核;拆分式在本组件 setup 内建内核\n// (TanStack useVueTable 只能在 setup 调用,故不能放进条件分支深处)\nif (props.definition && props.columns && import.meta.env.DEV) {\n console.warn(\"[tu-design] <TableRender> definition 与 columns 同时传入,已按 definition 渲染。\");\n}\nif (props.definition && props.rowSelection && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 rowSelection 请在 defineTable 配置,组件 prop 已忽略。\",\n );\n}\nconst instance =\n props.definition ??\n useTableRender({\n columns: props.columns ?? [],\n onLoad: props.onLoad,\n data: () => props.data,\n autoLoad: props.autoLoad,\n pageSizeOpts: props.pageSizeOpts,\n rowKey: props.rowKey,\n rowSelection: props.rowSelection,\n search: props.search,\n virtual: props.virtual,\n height: props.height,\n tree: props.tree,\n pageIndex: () => props.pageIndex,\n pageSize: () => props.pageSize,\n sort: () => props.sort,\n selectedKeys: () => props.selectedKeys,\n columnVisibility: props.definition?.columnVisibility,\n defaultVisibleKeys: () => props.defaultVisibleKeys,\n visibleKeys: () => props.visibleKeys,\n });\n// 拆分式已传 rowKey;聚合式由组件回填(S1:选择引擎依赖 rowKey 就绪)\ninstance.setRowKey(props.rowKey);\n\n// ---- 搜索表单(FormRender 联动) --------------------------------------------\n// 与 rowSelection 不同:聚合式下 prop 未被 definition 覆盖时回填引擎(不做聚合式忽略限制);\n// definition 与 prop 二选一,definition 优先,同传 DEV 警告\nif (props.definition && props.search) {\n if (instance.search && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 search 已在 defineTable 配置,组件 prop 已忽略。\",\n );\n } else {\n instance.setSearch(props.search);\n }\n}\n// search 不支持运行时切换(与 FormRender definition/form 同款约定),setup 期定版即可\nconst search = instance.search;\n\n// 列设置触发器的 Tooltip 受控开合(Tooltip 与 Popover 触发器嵌套会吞点击,故手动控制、不嵌套触发器)\nconst settingsTipOpen = ref(false);\n\n// ---- 列显隐(column visibility,R20–R26) ------------------------------------\n// R26:聚合式(columnVisibility.defaultVisibleKeys 经引擎解析回传)与拆分式 prop 同传 → definition 优先。\n// 引擎是唯一解析点;聚合式受控回填经 setVisibleKeys(normalize 等值守卫防回弹);\n// 拆分式由引擎受控 watch 直接同步(源 = props getter)\nif (\n props.definition &&\n instance.defaultVisibleKeys !== undefined &&\n props.defaultVisibleKeys !== undefined &&\n import.meta.env.DEV\n) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 defaultVisibleKeys 已在 columnVisibility 配置,组件 prop 已忽略。\",\n );\n}\nwatch(\n () => props.visibleKeys,\n (next) => {\n if (props.definition && next !== undefined) instance.setVisibleKeys(next);\n },\n { immediate: true },\n);\n\n/** 当前搜索表单值快照(浅拷贝;无 search 时为空对象) */\nfunction searchValues(): DataRecord {\n return search ? { ...search.form.state.values } : {};\n}\n\n/** 搜索:校验已由 FormRender 完成;归位第 1 页重载,分页/排序取数自动携带最新表单值 */\nfunction onSearch() {\n emit(\"search\", searchValues());\n instance.reload(true);\n}\n\n/** 重置:FormRender 已同步重置为 defaults(TanStack reset 为同步 setState),此刻读取即 defaults */\nfunction onReset() {\n emit(\"reset\", searchValues());\n instance.reload(true);\n}\n\nconst columns = computed(() => instance.columns);\nconst rows = computed(() => instance.table.getRowModel().rows);\n/** 内部加载态 ∪ 外部受控加载态(R14) */\nconst loading = computed(() => props.loading === true || instance.loading.value);\nconst showPagination = computed(() => Math.ceil(instance.page.total / instance.page.pageSize) > 1);\n/** 内置分页条开关(R28):showPagination=false 关闭;R13 仅作用于缺省模式 */\nconst showPaginationBar = computed(() => showPagination.value && props.showPagination !== false);\n/** 内置搜索区开关(R27):配置了 search 且未被 showSearch=false 关闭;列设置触发器不受影响 */\nconst showSearchArea = computed(() => search !== undefined && props.showSearch !== false);\n\n// ---- 错误态(服务端模式 onLoad 失败) ----------------------------------------\n// loading 判定优先;error 优先于正常数据(load 开始时引擎已清除旧错误,loading 期间 error 恒空)\nconst loadError = computed(() => instance.error.value);\nconst showError = computed(() => !loading.value && loadError.value !== undefined);\n\nwatch(loadError, (err) => {\n if (err) emit(\"load-error\", err);\n});\n\nfunction retry() {\n instance.reload();\n}\n\n// ---- 行选择(S 系列) -------------------------------------------------------\nconst selection = computed(() => instance.selection);\nconst selectedKeys = instance.selectedKeys;\nconst hasSelection = computed(() => selection.value.enabled);\n\n// ---- 列显隐(column visibility,R20–R26) -------------------------------------\nconst visibleKeySet = computed(() => new Set(instance.visibleKeys.value));\n/** 可见业务列(columns 原序子集):header/body/骨架/colspan/sticky 全部基于此渲染(R23/R25) */\nconst visibleColumns = computed(() =>\n columns.value.filter((column) => visibleKeySet.value.has(column.key)),\n);\n/** 列设置触发器/面板开关(默认 true);false 时不渲染 UI,受控 API 不受影响 */\nconst showColumnSettings = computed(() => props.columnSettings ?? true);\n\nfunction isColumnVisible(key: string): boolean {\n return visibleKeySet.value.has(key);\n}\n\n/** 最少一列(R20):唯一可见列不可隐藏 */\nfunction canHideColumn(key: string): boolean {\n return !(instance.visibleKeys.value.length <= 1 && visibleKeySet.value.has(key));\n}\n\nfunction toggleColumnVisible(key: string) {\n if (!canHideColumn(key)) return;\n instance.setVisibleKeys(\n isColumnVisible(key)\n ? instance.visibleKeys.value.filter((k) => k !== key)\n : [...instance.visibleKeys.value, key],\n );\n}\n\nconst allColumnsVisible = computed(\n () => columns.value.length > 0 && visibleColumns.value.length === columns.value.length,\n);\n\nfunction selectAllColumns() {\n if (allColumnsVisible.value) return;\n instance.setVisibleKeys(columns.value.map((column) => column.key));\n}\n\nfunction resetColumns() {\n // R21:恢复 defaultVisibleKeys;未配置 = 全部可见\n instance.setVisibleKeys(instance.defaultVisibleKeys ?? columns.value.map((column) => column.key));\n}\n\n// 受控/非受控均通知:统一投影变化 → 双事件(载荷 = columns 原序可见 key)\nwatch(instance.visibleKeys, (keys) => {\n emit(\"update:visible-keys\", [...keys]);\n emit(\"column-visibility-change\", [...keys]);\n});\n\n/** 总列数 = 可见业务列 + 选择列(空态 colspan 与骨架行,S8/R23) */\nconst columnCount = computed(() => visibleColumns.value.length + (hasSelection.value ? 1 : 0));\n\n// ---- 固定列(sticky) --------------------------------------------------------\n\n// DEV 校验:sticky 偏移只能从数字 width(px)推算,否则降级普通列(columns setup 期定版,只查一次)\nfor (const column of columns.value) {\n if (column.fixed !== undefined && typeof column.width !== \"number\") {\n console.warn(\n `[tu-design] <TableRender> fixed 列 \"${column.key}\" 需要数字 width,已忽略 fixed。`,\n );\n }\n}\n\n/** sticky 单元格映射(纯渲染层 computed,不进 TanStack pinning state):\n * 选择列视作最左 fixed 列参与累计(offset 0);fixed-left 按列序累加,\n * fixed-right 从最右列反向累计。edge = 该 sticky 组朝滚动方向的交界列(加分隔边框)。\n * 全部基于**可见集**(R23):sticky 组因隐藏变空则无该组输出(不输出边框)。\n */\nconst stickyOf = computed<StickyMap>(() => {\n const map: StickyMap = new Map();\n // instance.columns 是联合数组(聚合式 any / 拆分式 DataRecord),联合上的 filter\n // 类型谓词重载解析不可靠,故 map 提取时以断言收窄 width(条件已含 typeof 守卫)\n const lefts = visibleColumns.value\n .filter((column) => column.fixed === \"left\" && typeof column.width === \"number\")\n .map((column) => ({ key: column.key, width: column.width as number }));\n const rights = visibleColumns.value\n .filter((column) => column.fixed === \"right\" && typeof column.width === \"number\")\n .map((column) => ({ key: column.key, width: column.width as number }));\n\n let acc = 0;\n if (hasSelection.value) {\n map.set(SELECTION_CELL, { side: \"left\", offset: 0, edge: lefts.length === 0 });\n acc = selection.value.width;\n }\n lefts.forEach((left, index) => {\n map.set(left.key, { side: \"left\", offset: acc, edge: index === lefts.length - 1 });\n acc += left.width;\n });\n\n let racc = 0;\n for (let index = rights.length - 1; index >= 0; index--) {\n const right = rights[index]!;\n map.set(right.key, { side: \"right\", offset: racc, edge: index === 0 });\n racc += right.width;\n }\n return map;\n});\n\n/** 表头全选三态(S10):本页可选行与选中集求交派生(TanStack getter 追踪不稳,自算) */\nconst selectableKeys = computed(() =>\n rows.value.filter((row) => row.getCanSelect()).map((row) => rowKeyOf(row.original, row.index)),\n);\nconst headerChecked = computed(\n () =>\n hasSelection.value &&\n selection.value.type === \"checkbox\" &&\n selectableKeys.value.length > 0 &&\n selectableKeys.value.every((key) => selectedKeys.value.has(key)),\n);\nconst headerIndeterminate = computed(\n () =>\n hasSelection.value &&\n !headerChecked.value &&\n selectableKeys.value.some((key) => selectedKeys.value.has(key)),\n);\n\nfunction onHeaderSelect(checked: boolean) {\n instance.table.toggleAllPageRowsSelected(checked);\n}\n\n/** 行选择控件切换;radio 不可取消由引擎 S4 守卫,不选中态点击传 checked=true */\nfunction onRowSelect(line: { key: string }, checked: boolean) {\n instance.toggleRowSelected(line.key, checked);\n}\n\n// 选中集变化 → 对外事件(S7):排序/翻页不改变选中集,故不会误发\nwatch(instance.selectedKeys, (keys) => {\n emit(\"selection-change\", [...selection.value.value]);\n emit(\"update:selected-keys\", [...keys]);\n});\n\n/** 行 → 单元格值矩阵:render > formatter > record[key](R17) */\nconst body = computed<TableBodyLine[]>(() => {\n // 渲染器工厂按列求值一次(而非每单元格),避免用户工厂内的重分配被放大\n const renderFns = new Map(\n columns.value.filter((c) => c.render).map((c) => [c, c.render!(RENDERS)]),\n );\n return rows.value.map((row) => ({\n /** TanStack Row:树形渲染读 depth / getCanExpand / getIsExpanded / toggleExpanded */\n row,\n key: rowKeyOf(row.original, row.index),\n index: row.index,\n record: row.original,\n /** 行级可选过滤(S5):selectable 谓词交由引擎 enableRowSelection 判定 */\n canSelect: row.getCanSelect(),\n // 可见列的值矩阵(列显隐只裁剪列;R25 状态不受影响)\n cells: visibleColumns.value.map((column): VNodeChild => {\n const render = renderFns.get(column);\n if (render) return render(row.original, row.index, column);\n if (column.formatter) return column.formatter(row.original) as VNodeChild;\n return String(row.original[column.key] ?? \"\");\n }),\n }));\n});\n\n// ---- 树形数据(T 系列) ------------------------------------------------------\n// 引擎是唯一解析点(无效配置已 warn 并忽略,回传 undefined);tree 为 undefined 时不渲染缩进与 caret\nconst tree = instance.tree;\nconst treeIndent = tree?.indentSize ?? 16;\n\nlet missingRowKeyWarned = false;\n\n/** 行主键:rowKey 字段缺失时以行索引兜底(R3) */\nfunction rowKeyOf(record: DataRecord, index: number): string {\n const value = record[props.rowKey];\n if (value === undefined || value === null) {\n if (!missingRowKeyWarned && import.meta.env.DEV) {\n missingRowKeyWarned = true;\n console.warn(\n `[tu-design] <TableRender> 部分记录缺少 rowKey 字段 \"${props.rowKey}\",已退化为按行索引标识。`,\n );\n }\n return `index-${index}`;\n }\n return String(value);\n}\n\n// ---- 虚拟滚动 ----------------------------------------------------------------\n// definition 优先于 prop(配置定版,不支持运行时切换)\nconst virtualRaw = instance.virtual ?? props.virtual;\nconst heightRaw = instance.height ?? props.height;\nif (virtualRaw === true && heightRaw === undefined) {\n console.warn(\"[tu-design] <TableRender> virtual 需要配置 height,已降级普通渲染。\");\n}\nconst virtualEnabled = virtualRaw === true && heightRaw !== undefined;\nconst scrollHeight = computed(() => (typeof heightRaw === \"number\" ? `${heightRaw}px` : heightRaw));\n\nconst scrollEl = ref<HTMLElement | null>(null);\nconst theadEl = ref<HTMLElement | null>(null);\n/** 滚动容器内 thead 占据的前缀高度(scrollMargin);表头内容静态,挂载后测量一次 */\nconst theadOffset = ref(0);\n\n// 仅 virtual: true 且 height 就绪时创建(配置 setup 期定版,顶层条件分支可安全注册生命周期)\nconst virtualizerRef = virtualEnabled\n ? useVirtualizer(\n computed(() => ({\n count: rows.value.length, // 翻页/重载后行窗口变化 → options 更新(setOptions 自动生效)\n getScrollElement: () => scrollEl.value,\n estimateSize: () => 40,\n overscan: 8,\n getItemKey: (index: number) => rowKeyOf(rows.value[index]!, index), // rowKey 作为虚拟行 key\n scrollMargin: theadOffset.value, // thead 在滚动容器内的 offset 前缀\n })),\n )\n : null;\n\nonMounted(() => {\n if (virtualEnabled) theadOffset.value = theadEl.value?.offsetHeight ?? 0;\n});\n\nconst virtualRows = computed(() => (virtualizerRef ? virtualizerRef.value.getVirtualItems() : []));\nconst virtualTotal = computed(() => (virtualizerRef ? virtualizerRef.value.getTotalSize() : 0));\n/** 窗口行 + 对应全量行数据(cells 矩阵已由 body computed 缓存,虚拟化只裁剪 DOM 节点) */\nconst virtualLines = computed(() =>\n virtualRows.value.map((row) => ({ row, line: body.value[row.index]! })),\n);\nconst padTop = computed(() => virtualRows.value[0]?.start ?? 0);\nconst padBottom = computed(() => {\n const items = virtualRows.value;\n return items.length === 0 ? 0 : Math.max(0, virtualTotal.value - items[items.length - 1]!.end);\n});\n\n/** 行高动态测量:measureElement 读 data-index 把实测高度写回(行内容高度可变,不假设固定行高)。\n * 行组件为函数 ref,拿到的是组件实例,需经 $el 取真实 tr。 */\nfunction measureRow(node: Element | ComponentPublicInstance | null) {\n const el = node instanceof Element ? node : (node?.$el as Element | undefined);\n if (el instanceof Element) virtualizerRef?.value.measureElement(el);\n}\n\n/** aria-sort 仅在该列当前被排序时标注(R16) */\nfunction ariaSort(column: TableColumnOptions): \"ascending\" | \"descending\" | undefined {\n if (instance.sort.value?.key !== column.key) return undefined;\n return instance.sort.value.direction === \"asc\" ? \"ascending\" : \"descending\";\n}\n\nfunction sortMark(column: TableColumnOptions): string {\n const direction = instance.sort.value?.key === column.key ? instance.sort.value.direction : \"\";\n return direction === \"asc\" ? \"↑\" : direction === \"desc\" ? \"↓\" : \"\";\n}\n\nfunction onSort(key: string) {\n instance.toggleSort(key);\n emit(\"sort-change\", instance.sort.value);\n}\n\nfunction onPageIndex(pageIndex: number) {\n instance.setPageIndex(pageIndex);\n lastEmittedPage.pageIndex = pageIndex;\n emit(\"update:page-index\", pageIndex);\n}\n\nfunction onPageSize(pageSize: number) {\n instance.setPageSize(pageSize);\n lastEmittedPage.pageSize = pageSize;\n emit(\"update:page-size\", pageSize);\n}\n\n// ---- 受控模式(v-model):page 投影 → update:* 通知 ---------------------------\n// 仅 page-index/page-size 至少一方受控时安装;lastEmittedPage 去重——\n// 动作路径已 emit 过的值不再重复发(受控回写/内部归位只通知「未通知过的」变化)\nconst pageControlled = () => props.pageIndex !== undefined || props.pageSize !== undefined;\nconst lastEmittedPage = {\n pageIndex: undefined as number | undefined,\n pageSize: undefined as number | undefined,\n};\n\nif (pageControlled()) {\n watch(\n () => [instance.page.pageIndex, instance.page.pageSize] as const,\n ([pageIndex, pageSize]) => {\n if (pageIndex !== lastEmittedPage.pageIndex) {\n lastEmittedPage.pageIndex = pageIndex;\n emit(\"update:page-index\", pageIndex);\n }\n if (pageSize !== lastEmittedPage.pageSize) {\n lastEmittedPage.pageSize = pageSize;\n emit(\"update:page-size\", pageSize);\n }\n },\n );\n}\n\nfunction onRowClick(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-click\", record, index, event);\n}\n\nfunction onRowDblclick(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-dblclick\", record, index, event);\n}\n\nfunction onRowContextmenu(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-contextmenu\", record, index, event);\n}\n\nfunction onCellClick(record: DataRecord, columnKey: string, index: number, event: MouseEvent) {\n emit(\"cell-click\", record, columnKey, index, event);\n}\n\ndefineExpose({\n table: instance.table,\n page: instance.page,\n sort: instance.sort,\n loading: instance.loading,\n error: instance.error,\n visibleKeys: instance.visibleKeys,\n setVisibleKeys: instance.setVisibleKeys,\n reload: instance.reload,\n toggleSort: onSort,\n setPageIndex: onPageIndex,\n setPageSize: onPageSize,\n selection: instance.selection,\n selectedKeys: instance.selectedKeys,\n setSelection: instance.setSelection,\n clearSelection: instance.clearSelection,\n});\n</script>\n\n<template>\n <div :class=\"cn('w-full', $attrs.class)\">\n <!-- 搜索区 + 列设置触发器:同行右对齐(items-end);无搜索时触发器位于表格上方(R27:showSearch=false 关闭搜索区) -->\n <div\n v-if=\"showSearchArea || showColumnSettings\"\n class=\"mb-2 flex items-end justify-between gap-2\"\n >\n <FormRender\n v-if=\"showSearchArea\"\n class=\"min-w-0 flex-1\"\n :definition=\"search\"\n :searchable=\"search.actions ? undefined : true\"\n @search=\"onSearch\"\n @reset=\"onReset\"\n />\n\n <!-- 列设置:Popover 面板(R20 最少一列 / R21 重置 / R22 不含选择列);\n 触发钮 Tooltip 手动受控开合(Tooltip 与 Popover 触发器嵌套会吞点击,故并列渲染、不走 hover 自动触发) -->\n <template v-if=\"showColumnSettings\">\n <Popover align=\"end\" content-class=\"w-56 p-0\">\n <Button\n variant=\"ghost\"\n size=\"icon\"\n aria-label=\"列设置\"\n aria-haspopup=\"true\"\n @pointerenter=\"settingsTipOpen = true\"\n @pointerleave=\"settingsTipOpen = false\"\n >\n <!-- lucide Settings2(内联 SVG,跟随项目图标现状) -->\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M20 7h-9\" />\n <path d=\"M14 17H5\" />\n <circle cx=\"17\" cy=\"17\" r=\"3\" />\n <circle cx=\"7\" cy=\"7\" r=\"3\" />\n </svg>\n </Button>\n <template #content>\n <div class=\"flex items-center justify-end gap-3 px-3 py-2\">\n <button\n type=\"button\"\n class=\"text-muted-foreground hover:text-foreground cursor-pointer text-xs disabled:cursor-not-allowed disabled:opacity-50\"\n :disabled=\"allColumnsVisible\"\n @click=\"selectAllColumns\"\n >\n 全选\n </button>\n <button\n type=\"button\"\n class=\"text-muted-foreground hover:text-foreground cursor-pointer text-xs\"\n @click=\"resetColumns\"\n >\n 重置\n </button>\n </div>\n <Separator />\n <div class=\"max-h-64 overflow-y-auto py-1\">\n <div\n v-for=\"column in columns\"\n :key=\"column.key\"\n data-column-item\n :data-column-key=\"column.key\"\n class=\"hover:bg-accent/50 flex h-8 cursor-pointer items-center gap-2 px-3\"\n @click=\"toggleColumnVisible(column.key)\"\n >\n <Checkbox\n :checked=\"isColumnVisible(column.key)\"\n :disabled=\"!canHideColumn(column.key)\"\n @update:checked=\"toggleColumnVisible(column.key)\"\n @click.stop\n />\n <span class=\"min-w-0 flex-1 truncate\">{{ column.title }}</span>\n <!-- 有效 fixed 列(数字 width)标识 -->\n <svg\n v-if=\"column.fixed !== undefined && typeof column.width === 'number'\"\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"text-muted-foreground size-3 shrink-0\"\n aria-hidden=\"true\"\n >\n <path d=\"M12 17v5\" />\n <path\n d=\"M9 10.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V7h1a2 2 0 0 0 0-4H8a2 2 0 0 0 0 4h1z\"\n />\n </svg>\n </div>\n </div>\n </template>\n </Popover>\n <!-- 纯受控气泡(无默认插槽,不渲染触发器):开合由触发钮 pointerenter/leave 驱动 -->\n <Tooltip :open=\"settingsTipOpen\" content=\"列设置\" />\n </template>\n </div>\n\n <!-- 滚动容器:横向滚动时 fixed 列 sticky 生效;virtual 模式兼任纵向滚动(分页条不参与滚动) -->\n <div\n ref=\"scrollEl\"\n class=\"overflow-x-auto\"\n :style=\"virtualEnabled ? { height: scrollHeight, overflowY: 'auto' } : undefined\"\n >\n <table class=\"w-full caption-bottom text-sm\">\n <thead ref=\"theadEl\" class=\"[&_tr]:border-b\">\n <tr>\n <!-- 选择列:checkbox 型表头为本页全选三态(S3/S10);radio 型占位;视作最左固定列 -->\n <th\n v-if=\"hasSelection\"\n scope=\"col\"\n class=\"h-10 w-12 px-2 align-middle font-medium text-muted-foreground\"\n :class=\"stickyClass(stickyOf, SELECTION_CELL)\"\n :style=\"[\n { width: `${selection.width}px` },\n stickyStyle(stickyOf, SELECTION_CELL, true),\n ]\"\n >\n <Checkbox\n v-if=\"selection.type === 'checkbox'\"\n :checked=\"headerIndeterminate ? 'indeterminate' : headerChecked\"\n :aria-label=\"'全选本页'\"\n @update:checked=\"onHeaderSelect\"\n />\n </th>\n <th\n v-for=\"column in visibleColumns\"\n :key=\"column.key\"\n scope=\"col\"\n class=\"h-10 px-2 align-middle font-medium text-muted-foreground\"\n :class=\"stickyClass(stickyOf, column.key)\"\n :style=\"[\n { width: column.width, textAlign: column.align },\n stickyStyle(stickyOf, column.key, true),\n ]\"\n :aria-sort=\"ariaSort(column)\"\n >\n <button\n v-if=\"column.sortable\"\n type=\"button\"\n class=\"inline-flex items-center gap-1 hover:text-foreground\"\n @click=\"onSort(column.key)\"\n >\n {{ column.title }}\n <span aria-hidden=\"true\" class=\"text-xs\">{{ sortMark(column) }}</span>\n </button>\n <template v-else>{{ column.title }}</template>\n </th>\n </tr>\n </thead>\n\n <tbody class=\"[&_tr:last-child]:border-0\">\n <!-- 加载态:固定 5 行骨架(R14);选择列一并占位(S8);骨架不虚拟化;loading 判定优先 -->\n <template v-if=\"loading\">\n <tr v-for=\"row in SKELETON_ROWS\" :key=\"row\" data-skeleton>\n <td\n v-if=\"hasSelection\"\n class=\"p-2 align-middle\"\n :class=\"stickyClass(stickyOf, SELECTION_CELL)\"\n :style=\"stickyStyle(stickyOf, SELECTION_CELL, false)\"\n >\n <Skeleton class=\"size-4\" />\n </td>\n <td\n v-for=\"column in visibleColumns\"\n :key=\"column.key\"\n class=\"p-2 align-middle\"\n :class=\"stickyClass(stickyOf, column.key)\"\n :style=\"[{ textAlign: column.align }, stickyStyle(stickyOf, column.key, false)]\"\n >\n <Skeleton class=\"h-4 w-full\" />\n </td>\n </tr>\n </template>\n\n <!-- 错误态:error 优先于正常数据;插槽可自定义(slot props { error, retry }) -->\n <template v-else-if=\"showError\">\n <tr data-error>\n <td :colspan=\"columnCount\" class=\"p-8 text-center text-muted-foreground\">\n <slot name=\"error\" :error=\"loadError\" :retry=\"retry\">\n <div class=\"flex flex-col items-center gap-3\">\n <p>{{ loadError?.message ?? \"加载失败\" }}</p>\n <Button variant=\"outline\" size=\"sm\" @click=\"retry\">重试</Button>\n </div>\n </slot>\n </td>\n </tr>\n </template>\n\n <!-- 虚拟滚动:窗口行 + 前后占位行(总高撑开滚动区间;行高经 measureElement 动态测量) -->\n <template v-else-if=\"virtualEnabled\">\n <tr aria-hidden=\"true\" data-virtual-pad :style=\"{ height: `${padTop}px` }\">\n <td :colspan=\"columnCount\" class=\"border-0 p-0\"></td>\n </tr>\n <TableBodyRow\n v-for=\"item in virtualLines\"\n :key=\"item.line.key\"\n :ref=\"measureRow\"\n :data-index=\"item.row.index\"\n :line=\"item.line\"\n :columns=\"visibleColumns\"\n :selection=\"hasSelection ? selection.type : undefined\"\n :selected=\"selectedKeys.has(item.line.key)\"\n :sticky=\"stickyOf\"\n :tree-indent=\"tree ? treeIndent : undefined\"\n @select=\"(checked: boolean) => onRowSelect(item.line, checked)\"\n @row-click=\"onRowClick(item.line.record, item.line.index, $event)\"\n @row-dblclick=\"onRowDblclick(item.line.record, item.line.index, $event)\"\n @row-contextmenu=\"onRowContextmenu(item.line.record, item.line.index, $event)\"\n @cell-click=\"\n (columnKey: string, event: MouseEvent) =>\n onCellClick(item.line.record, columnKey, item.line.index, event)\n \"\n />\n <tr aria-hidden=\"true\" data-virtual-pad :style=\"{ height: `${padBottom}px` }\">\n <td :colspan=\"columnCount\" class=\"border-0 p-0\"></td>\n </tr>\n </template>\n\n <template v-else>\n <TableBodyRow\n v-for=\"line in body\"\n :key=\"line.key\"\n :line=\"line\"\n :columns=\"visibleColumns\"\n :selection=\"hasSelection ? selection.type : undefined\"\n :selected=\"selectedKeys.has(line.key)\"\n :sticky=\"stickyOf\"\n :tree-indent=\"tree ? treeIndent : undefined\"\n @select=\"(checked: boolean) => onRowSelect(line, checked)\"\n @row-click=\"onRowClick(line.record, line.index, $event)\"\n @row-dblclick=\"onRowDblclick(line.record, line.index, $event)\"\n @row-contextmenu=\"onRowContextmenu(line.record, line.index, $event)\"\n @cell-click=\"\n (columnKey: string, event: MouseEvent) =>\n onCellClick(line.record, columnKey, line.index, event)\n \"\n />\n </template>\n\n <!-- 空态:横跨全列的单单元格,不虚拟化;错误态优先 -->\n <tr v-if=\"!loading && !showError && body.length === 0\" data-empty>\n <td :colspan=\"columnCount\" class=\"p-8 text-center text-muted-foreground\">\n <slot name=\"empty\">{{ emptyText ?? \"暂无数据\" }}</slot>\n </td>\n </tr>\n </tbody>\n </table>\n </div>\n\n <!-- R31:手动接线(须经 onPageIndex/onPageSize 包装器保留受控去重);显式补 border-t 与 size select 保持现状 -->\n <TablePagination\n v-if=\"showPaginationBar\"\n class=\"border-t\"\n :page-index=\"instance.page.pageIndex\"\n :page-size=\"instance.page.pageSize\"\n :page-size-opts=\"instance.page.pageSizeOpts\"\n :total=\"instance.page.total\"\n :show-size-select=\"true\"\n @update:page-index=\"onPageIndex\"\n @update:page-size=\"onPageSize\"\n />\n </div>\n</template>\n"
|
|
41
|
+
"content": "<script setup lang=\"ts\">\nimport type { ComponentPublicInstance, PropType, VNodeChild } from \"vue\";\nimport { useVirtualizer } from \"@tanstack/vue-virtual\";\nimport { columnRenders } from \"./column-renders\";\nimport { computed, inject, onMounted, ref, watch } from \"vue\";\nimport { Button } from \"@/components/ui/button\";\nimport { Checkbox } from \"@/components/ui/checkbox\";\nimport { FormRender, type FormRenderDefinition } from \"@/components/ui/form-render\";\nimport { Popover } from \"@/components/ui/popover\";\nimport { Separator } from \"@/components/ui/separator\";\nimport { Skeleton } from \"@/components/ui/skeleton\";\nimport { Tooltip } from \"@/components/ui/tooltip\";\nimport { cn } from \"@/lib/utils\";\nimport { PAGE_TABLE_FILL_KEY, SELECTION_CELL } from \"./constants\";\nimport { stickyClass, stickyStyle, type StickyMap } from \"./sticky\";\nimport TableBodyRow from \"./TableBodyRow.vue\";\nimport TablePagination from \"./TablePagination.vue\";\nimport type {\n ColumnVisibilityOptions,\n DataRecord,\n SortableOptions,\n TableBodyLine,\n TableColumnOptions,\n TableLoadParams,\n TableRenderDefinition,\n TableSelectionOptions,\n TreeOptions,\n} from \"./types\";\nimport { useTableRender } from \"./useTableRender\";\n\n// boolean flags 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false;Checkbox/Dialog/FormRender 同款约定)\nconst props = defineProps({\n /** 聚合式(推荐):defineTable 返回的定义对象 */\n definition: { type: Object as PropType<TableRenderDefinition<any>> },\n /** 数据主键(记录缺字段时以行索引兜底) */\n rowKey: { type: String, required: true },\n /** 拆分式:与 definition 二选一,definition 优先 */\n columns: { type: Array as PropType<TableColumnOptions[]> },\n onLoad: {\n type: Function as PropType<(params: TableLoadParams) => void | Promise<unknown>>,\n },\n data: { type: Array as PropType<DataRecord[]> },\n autoLoad: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 每页条数 / 受控每页条数(D11):传入即受控(pageIndex 未受控时 R9 归位内部处理并通知) */\n pageSize: { type: Number },\n pageSizeOpts: { type: Array as PropType<number[]> },\n loading: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n emptyText: { type: String },\n /** 行选择(仅拆分式生效;聚合式请在 defineTable 配置):\"radio\" | \"checkbox\" | 对象 */\n rowSelection: {\n type: [String, Object] as PropType<\"radio\" | \"checkbox\" | TableSelectionOptions>,\n default: undefined,\n },\n /** 搜索表单(defineForm 返回值):拆分式直接传;聚合式请在 defineTable 配置(definition 优先,同传 DEV 警告) */\n search: { type: Object as PropType<FormRenderDefinition<any>> },\n /** 虚拟滚动:开启后表体行虚拟化渲染;聚合式请在 defineTable 配置(definition 优先);须同时给 height */\n virtual: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 虚拟滚动容器高度(数字 px 或 CSS 高度);仅 virtual: true 时生效 */\n height: { type: [Number, String] as PropType<number | string> },\n /** 树形数据(子行展开/收起);拆分式直接传,聚合式请在 defineTable 配置 */\n tree: { type: Object as PropType<TreeOptions> },\n /** 受控页码(1-based):传入即受控,缺省非受控;内部翻页经 update:page-index 通知 */\n pageIndex: { type: Number },\n /** 受控排序:传入即受控;内部/外部变化均经 sort-change 通知 */\n sort: { type: Object as PropType<SortableOptions> },\n /** 受控选中集(数组,与 update:selected-keys 载荷同构):传入即受控 */\n selectedKeys: { type: Array as PropType<Array<string | number>> },\n /** 受控可见列 key(columns 原序子集):传入即受控;内部显隐经 update:visible-keys 通知 */\n visibleKeys: { type: Array as PropType<string[]> },\n /** 拆分式默认可见列集;与聚合式 columnVisibility.defaultVisibleKeys 同传时 DEV 警告(R26,definition 优先) */\n defaultVisibleKeys: { type: Array as PropType<string[]> },\n /** 列设置触发器/面板开关(默认 true);false 时不渲染 UI,受控 API 不受影响 */\n columnSettings: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 搜索区渲染开关(R27):false 关闭内置搜索区(组合式外置 FormRender);数据链路不变 */\n showSearch: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 分页条渲染开关(R28):false 关闭内置分页条(组合式外置 TablePagination);缺省模式 R13 不变 */\n showPagination: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 填充模式:根容器 h-full 纵向 flex,滚动区 flex-1 内滚;表头 sticky 钉住。\n * 父链需有确定高度(如页面布局的 .table-body);无确定高度时安全退化为自然高度。\n * 显式 prop 优先于布局 provide(key: \"tu-design:page-table-fill\");显式传 false 可强制关闭。\n * 纯布局属性,不进 defineTable/definition(virtual/height 例外),setup 期定版不支持运行时切换。 */\n fillHeight: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n});\n\n// ---- 填充模式(fillHeight)---------------------------------------------------\n// 布局上下文:页面布局容器 provide 同名 key,slot 内 TableRender 自动 fill。\n// 字符串 key 跨包约定(常量 PAGE_TABLE_FILL_KEY 已导出,消费方零依赖时按字符串值 provide),\n// setup 期定版,不支持运行时切换(与 virtual/search 同约定)。\nconst pageTableFill = inject<boolean>(PAGE_TABLE_FILL_KEY, false);\nconst fill = props.fillHeight ?? pageTableFill;\n\nconst emit = defineEmits<{\n \"update:page-index\": [pageIndex: number];\n \"update:page-size\": [pageSize: number];\n \"sort-change\": [sort: SortableOptions | undefined];\n \"row-click\": [record: DataRecord, index: number, event: MouseEvent];\n /** 行双击(与 row-click 独立,双击会先后触发 click 两次,属预期) */\n \"row-dblclick\": [record: DataRecord, index: number, event: MouseEvent];\n /** 行右键;不主动 preventDefault */\n \"row-contextmenu\": [record: DataRecord, index: number, event: MouseEvent];\n /** 单元格点击(columnKey 定位列);冒泡并存——cell-click 触发时 row-click 也会触发 */\n \"cell-click\": [record: DataRecord, columnKey: string, index: number, event: MouseEvent];\n \"selection-change\": [rows: DataRecord[]];\n \"update:selected-keys\": [keys: Array<string | number>];\n /** 搜索:FormRender 校验通过后触发;载荷为当前表单值 */\n search: [values: DataRecord];\n /** 重置:FormRender 已重置为 defaults 后触发;载荷为重置后的表单值 */\n reset: [values: DataRecord];\n /** 服务端模式 onLoad 抛错/ rejects 时触发;下一次 load 开始时 error 投影清除 */\n \"load-error\": [error: Error];\n /** 可见列变化(受控回写通知 / v-model:visible-keys) */\n \"update:visible-keys\": [keys: string[]];\n /** 列显隐变化(受控/非受控均触发,供业务持久化;载荷 = 可见列 key 有序数组,columns 原序) */\n \"column-visibility-change\": [keys: string[]];\n}>();\n\ndefineSlots<{\n empty?: () => VNodeChild;\n /** 错误态占位(服务端模式 onLoad 失败时渲染,优先于数据区) */\n error?: (props: { error: Error | undefined; retry: () => void }) => VNodeChild;\n}>();\n\n/** 加载态骨架行数(R14) */\nconst SKELETON_ROWS = [1, 2, 3, 4, 5];\n\n/** 内置渲染器单例:render 工厂按列求值时复用(工厂本身轻量,仅为整洁) */\nconst RENDERS = columnRenders();\n\n// 聚合式直接复用 defineTable 建好的内核;拆分式在本组件 setup 内建内核\n// (TanStack useVueTable 只能在 setup 调用,故不能放进条件分支深处)\nif (props.definition && props.columns && import.meta.env.DEV) {\n console.warn(\"[tu-design] <TableRender> definition 与 columns 同时传入,已按 definition 渲染。\");\n}\nif (props.definition && props.rowSelection && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 rowSelection 请在 defineTable 配置,组件 prop 已忽略。\",\n );\n}\nconst instance =\n props.definition ??\n useTableRender({\n columns: props.columns ?? [],\n onLoad: props.onLoad,\n data: () => props.data,\n autoLoad: props.autoLoad,\n pageSizeOpts: props.pageSizeOpts,\n rowKey: props.rowKey,\n rowSelection: props.rowSelection,\n search: props.search,\n virtual: props.virtual,\n height: props.height,\n tree: props.tree,\n pageIndex: () => props.pageIndex,\n pageSize: () => props.pageSize,\n sort: () => props.sort,\n selectedKeys: () => props.selectedKeys,\n columnVisibility: props.definition?.columnVisibility,\n defaultVisibleKeys: () => props.defaultVisibleKeys,\n visibleKeys: () => props.visibleKeys,\n });\n// 拆分式已传 rowKey;聚合式由组件回填(S1:选择引擎依赖 rowKey 就绪)\ninstance.setRowKey(props.rowKey);\n\n// ---- 搜索表单(FormRender 联动) --------------------------------------------\n// 与 rowSelection 不同:聚合式下 prop 未被 definition 覆盖时回填引擎(不做聚合式忽略限制);\n// definition 与 prop 二选一,definition 优先,同传 DEV 警告\nif (props.definition && props.search) {\n if (instance.search && import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 search 已在 defineTable 配置,组件 prop 已忽略。\",\n );\n } else {\n instance.setSearch(props.search);\n }\n}\n// search 不支持运行时切换(与 FormRender definition/form 同款约定),setup 期定版即可\nconst search = instance.search;\n\n// 列设置触发器的 Tooltip 受控开合(Tooltip 与 Popover 触发器嵌套会吞点击,故手动控制、不嵌套触发器)\nconst settingsTipOpen = ref(false);\n\n// ---- 列显隐(column visibility,R20–R26) ------------------------------------\n// R26:聚合式(columnVisibility.defaultVisibleKeys 经引擎解析回传)与拆分式 prop 同传 → definition 优先。\n// 引擎是唯一解析点;聚合式受控回填经 setVisibleKeys(normalize 等值守卫防回弹);\n// 拆分式由引擎受控 watch 直接同步(源 = props getter)\nif (\n props.definition &&\n instance.defaultVisibleKeys !== undefined &&\n props.defaultVisibleKeys !== undefined &&\n import.meta.env.DEV\n) {\n console.warn(\n \"[tu-design] <TableRender> 聚合式下 defaultVisibleKeys 已在 columnVisibility 配置,组件 prop 已忽略。\",\n );\n}\nwatch(\n () => props.visibleKeys,\n (next) => {\n if (props.definition && next !== undefined) instance.setVisibleKeys(next);\n },\n { immediate: true },\n);\n\n/** 当前搜索表单值快照(浅拷贝;无 search 时为空对象) */\nfunction searchValues(): DataRecord {\n return search ? { ...search.form.state.values } : {};\n}\n\n/** 搜索:校验已由 FormRender 完成;归位第 1 页重载,分页/排序取数自动携带最新表单值 */\nfunction onSearch() {\n emit(\"search\", searchValues());\n instance.reload(true);\n}\n\n/** 重置:FormRender 已同步重置为 defaults(TanStack reset 为同步 setState),此刻读取即 defaults */\nfunction onReset() {\n emit(\"reset\", searchValues());\n instance.reload(true);\n}\n\nconst columns = computed(() => instance.columns);\nconst rows = computed(() => instance.table.getRowModel().rows);\n/** 内部加载态 ∪ 外部受控加载态(R14) */\nconst loading = computed(() => props.loading === true || instance.loading.value);\nconst showPagination = computed(() => Math.ceil(instance.page.total / instance.page.pageSize) > 1);\n/** 内置分页条开关(R28):showPagination=false 关闭;R13 仅作用于缺省模式 */\nconst showPaginationBar = computed(() => showPagination.value && props.showPagination !== false);\n/** 内置搜索区开关(R27):配置了 search 且未被 showSearch=false 关闭;列设置触发器不受影响 */\nconst showSearchArea = computed(() => search !== undefined && props.showSearch !== false);\n\n// ---- 错误态(服务端模式 onLoad 失败) ----------------------------------------\n// loading 判定优先;error 优先于正常数据(load 开始时引擎已清除旧错误,loading 期间 error 恒空)\nconst loadError = computed(() => instance.error.value);\nconst showError = computed(() => !loading.value && loadError.value !== undefined);\n\nwatch(loadError, (err) => {\n if (err) emit(\"load-error\", err);\n});\n\nfunction retry() {\n instance.reload();\n}\n\n// ---- 行选择(S 系列) -------------------------------------------------------\nconst selection = computed(() => instance.selection);\nconst selectedKeys = instance.selectedKeys;\nconst hasSelection = computed(() => selection.value.enabled);\n\n// ---- 列显隐(column visibility,R20–R26) -------------------------------------\nconst visibleKeySet = computed(() => new Set(instance.visibleKeys.value));\n/** 可见业务列(columns 原序子集):header/body/骨架/colspan/sticky 全部基于此渲染(R23/R25) */\nconst visibleColumns = computed(() =>\n columns.value.filter((column) => visibleKeySet.value.has(column.key)),\n);\n/** 列设置触发器/面板开关(默认 true);false 时不渲染 UI,受控 API 不受影响 */\nconst showColumnSettings = computed(() => props.columnSettings ?? true);\n\nfunction isColumnVisible(key: string): boolean {\n return visibleKeySet.value.has(key);\n}\n\n/** 最少一列(R20):唯一可见列不可隐藏 */\nfunction canHideColumn(key: string): boolean {\n return !(instance.visibleKeys.value.length <= 1 && visibleKeySet.value.has(key));\n}\n\nfunction toggleColumnVisible(key: string) {\n if (!canHideColumn(key)) return;\n instance.setVisibleKeys(\n isColumnVisible(key)\n ? instance.visibleKeys.value.filter((k) => k !== key)\n : [...instance.visibleKeys.value, key],\n );\n}\n\nconst allColumnsVisible = computed(\n () => columns.value.length > 0 && visibleColumns.value.length === columns.value.length,\n);\n\nfunction selectAllColumns() {\n if (allColumnsVisible.value) return;\n instance.setVisibleKeys(columns.value.map((column) => column.key));\n}\n\nfunction resetColumns() {\n // R21:恢复 defaultVisibleKeys;未配置 = 全部可见\n instance.setVisibleKeys(instance.defaultVisibleKeys ?? columns.value.map((column) => column.key));\n}\n\n// 受控/非受控均通知:统一投影变化 → 双事件(载荷 = columns 原序可见 key)\nwatch(instance.visibleKeys, (keys) => {\n emit(\"update:visible-keys\", [...keys]);\n emit(\"column-visibility-change\", [...keys]);\n});\n\n/** 总列数 = 可见业务列 + 选择列(空态 colspan 与骨架行,S8/R23) */\nconst columnCount = computed(() => visibleColumns.value.length + (hasSelection.value ? 1 : 0));\n\n// ---- 固定列(sticky) --------------------------------------------------------\n\n// DEV 校验:sticky 偏移只能从数字 width(px)推算,否则降级普通列(columns setup 期定版,只查一次)\nfor (const column of columns.value) {\n if (column.fixed !== undefined && typeof column.width !== \"number\") {\n console.warn(\n `[tu-design] <TableRender> fixed 列 \"${column.key}\" 需要数字 width,已忽略 fixed。`,\n );\n }\n}\n\n/** sticky 单元格映射(纯渲染层 computed,不进 TanStack pinning state):\n * 选择列视作最左 fixed 列参与累计(offset 0);fixed-left 按列序累加,\n * fixed-right 从最右列反向累计。edge = 该 sticky 组朝滚动方向的交界列(加分隔边框)。\n * 全部基于**可见集**(R23):sticky 组因隐藏变空则无该组输出(不输出边框)。\n */\nconst stickyOf = computed<StickyMap>(() => {\n const map: StickyMap = new Map();\n // instance.columns 是联合数组(聚合式 any / 拆分式 DataRecord),联合上的 filter\n // 类型谓词重载解析不可靠,故 map 提取时以断言收窄 width(条件已含 typeof 守卫)\n const lefts = visibleColumns.value\n .filter((column) => column.fixed === \"left\" && typeof column.width === \"number\")\n .map((column) => ({ key: column.key, width: column.width as number }));\n const rights = visibleColumns.value\n .filter((column) => column.fixed === \"right\" && typeof column.width === \"number\")\n .map((column) => ({ key: column.key, width: column.width as number }));\n\n let acc = 0;\n if (hasSelection.value) {\n map.set(SELECTION_CELL, { side: \"left\", offset: 0, edge: lefts.length === 0 });\n acc = selection.value.width;\n }\n lefts.forEach((left, index) => {\n map.set(left.key, { side: \"left\", offset: acc, edge: index === lefts.length - 1 });\n acc += left.width;\n });\n\n let racc = 0;\n for (let index = rights.length - 1; index >= 0; index--) {\n const right = rights[index]!;\n map.set(right.key, { side: \"right\", offset: racc, edge: index === 0 });\n racc += right.width;\n }\n return map;\n});\n\n/** 表头全选三态(S10):本页可选行与选中集求交派生(TanStack getter 追踪不稳,自算) */\nconst selectableKeys = computed(() =>\n rows.value.filter((row) => row.getCanSelect()).map((row) => rowKeyOf(row.original, row.index)),\n);\nconst headerChecked = computed(\n () =>\n hasSelection.value &&\n selection.value.type === \"checkbox\" &&\n selectableKeys.value.length > 0 &&\n selectableKeys.value.every((key) => selectedKeys.value.has(key)),\n);\nconst headerIndeterminate = computed(\n () =>\n hasSelection.value &&\n !headerChecked.value &&\n selectableKeys.value.some((key) => selectedKeys.value.has(key)),\n);\n\nfunction onHeaderSelect(checked: boolean) {\n instance.table.toggleAllPageRowsSelected(checked);\n}\n\n/** 行选择控件切换;radio 不可取消由引擎 S4 守卫,不选中态点击传 checked=true */\nfunction onRowSelect(line: { key: string }, checked: boolean) {\n instance.toggleRowSelected(line.key, checked);\n}\n\n// 选中集变化 → 对外事件(S7):排序/翻页不改变选中集,故不会误发\nwatch(instance.selectedKeys, (keys) => {\n emit(\"selection-change\", [...selection.value.value]);\n emit(\"update:selected-keys\", [...keys]);\n});\n\n/** 行 → 单元格值矩阵:render > formatter > record[key](R17) */\nconst body = computed<TableBodyLine[]>(() => {\n // 渲染器工厂按列求值一次(而非每单元格),避免用户工厂内的重分配被放大\n const renderFns = new Map(\n columns.value.filter((c) => c.render).map((c) => [c, c.render!(RENDERS)]),\n );\n return rows.value.map((row) => ({\n /** TanStack Row:树形渲染读 depth / getCanExpand / getIsExpanded / toggleExpanded */\n row,\n key: rowKeyOf(row.original, row.index),\n index: row.index,\n record: row.original,\n /** 行级可选过滤(S5):selectable 谓词交由引擎 enableRowSelection 判定 */\n canSelect: row.getCanSelect(),\n // 可见列的值矩阵(列显隐只裁剪列;R25 状态不受影响)\n cells: visibleColumns.value.map((column): VNodeChild => {\n const render = renderFns.get(column);\n if (render) return render(row.original, row.index, column);\n if (column.formatter) return column.formatter(row.original) as VNodeChild;\n return String(row.original[column.key] ?? \"\");\n }),\n }));\n});\n\n// ---- 树形数据(T 系列) ------------------------------------------------------\n// 引擎是唯一解析点(无效配置已 warn 并忽略,回传 undefined);tree 为 undefined 时不渲染缩进与 caret\nconst tree = instance.tree;\nconst treeIndent = tree?.indentSize ?? 16;\n\nlet missingRowKeyWarned = false;\n\n/** 行主键:rowKey 字段缺失时以行索引兜底(R3) */\nfunction rowKeyOf(record: DataRecord, index: number): string {\n const value = record[props.rowKey];\n if (value === undefined || value === null) {\n if (!missingRowKeyWarned && import.meta.env.DEV) {\n missingRowKeyWarned = true;\n console.warn(\n `[tu-design] <TableRender> 部分记录缺少 rowKey 字段 \"${props.rowKey}\",已退化为按行索引标识。`,\n );\n }\n return `index-${index}`;\n }\n return String(value);\n}\n\n// ---- 虚拟滚动 / 填充模式 ------------------------------------------------------\n// definition 优先于 prop(配置定版,不支持运行时切换)\nconst virtualRaw = instance.virtual ?? props.virtual;\nconst heightRaw = instance.height ?? props.height;\n// fill 模式自带真实滚动盒(flex-1 实测高度),virtual 无需显式 height\nif (virtualRaw === true && heightRaw === undefined && !fill) {\n console.warn(\"[tu-design] <TableRender> virtual 需要配置 height,已降级普通渲染。\");\n}\nconst virtualEnabled = virtualRaw === true && (heightRaw !== undefined || fill);\nconst scrollHeight = computed(() => (typeof heightRaw === \"number\" ? `${heightRaw}px` : heightRaw));\n/** 表头 sticky 仅在组件内存在真实纵向滚动盒时生效(fill / virtual),普通模式不挂载,行为不变 */\nconst theadSticky = fill || virtualEnabled;\n/** 滚动区样式:virtual 用固定 height;fill 交给 flex 分配(二者同传以 fill 优先) */\nconst scrollStyle = computed(() => {\n if (fill || !virtualEnabled) return undefined;\n return { height: scrollHeight.value, overflowY: \"auto\" as const };\n});\n/** sticky 表头普通列类:不透明底防行内容透出;分隔线归 th(thead 行级 border 会随行滚走);\n * z-20 高于表体 fixed 列(--z-sticky: 10),纵向滚动行滑过表头时不穿透;\n * 表头 fixed 列的 z 由 stickyStyle inline style(var(--z-sticky-head))提供,inline 优先级天然覆盖此处 class */\nconst theadThClass = theadSticky ? \"sticky top-0 z-20 border-b border-border bg-background\" : \"\";\n/** sticky 态 table 改分离边框:preflight 为 border-collapse: collapse,\n * 折叠边框几何归属 table,Chrome 下 sticky th 粘住后自身 border-b 渲染丢失;\n * separate + spacing-0 恢复单元格边框。普通模式保持 collapse,零回归。 */\nconst tableClass = theadSticky ? \"border-separate border-spacing-0\" : \"\";\n\nconst scrollEl = ref<HTMLElement | null>(null);\nconst theadEl = ref<HTMLElement | null>(null);\n/** 滚动容器内 thead 占据的前缀高度(scrollMargin);表头内容静态,挂载后测量一次 */\nconst theadOffset = ref(0);\n\n// 仅 virtual: true 且 height 就绪时创建(配置 setup 期定版,顶层条件分支可安全注册生命周期)\nconst virtualizerRef = virtualEnabled\n ? useVirtualizer(\n computed(() => ({\n count: rows.value.length, // 翻页/重载后行窗口变化 → options 更新(setOptions 自动生效)\n getScrollElement: () => scrollEl.value,\n estimateSize: () => 40,\n overscan: 8,\n getItemKey: (index: number) => rowKeyOf(rows.value[index]!, index), // rowKey 作为虚拟行 key\n scrollMargin: theadOffset.value, // thead 在滚动容器内的 offset 前缀\n })),\n )\n : null;\n\nonMounted(() => {\n if (virtualEnabled) theadOffset.value = theadEl.value?.offsetHeight ?? 0;\n});\n\nconst virtualRows = computed(() => (virtualizerRef ? virtualizerRef.value.getVirtualItems() : []));\nconst virtualTotal = computed(() => (virtualizerRef ? virtualizerRef.value.getTotalSize() : 0));\n/** 窗口行 + 对应全量行数据(cells 矩阵已由 body computed 缓存,虚拟化只裁剪 DOM 节点) */\nconst virtualLines = computed(() =>\n virtualRows.value.map((row) => ({ row, line: body.value[row.index]! })),\n);\nconst padTop = computed(() => virtualRows.value[0]?.start ?? 0);\nconst padBottom = computed(() => {\n const items = virtualRows.value;\n return items.length === 0 ? 0 : Math.max(0, virtualTotal.value - items[items.length - 1]!.end);\n});\n\n/** 行高动态测量:measureElement 读 data-index 把实测高度写回(行内容高度可变,不假设固定行高)。\n * 行组件为函数 ref,拿到的是组件实例,需经 $el 取真实 tr。 */\nfunction measureRow(node: Element | ComponentPublicInstance | null) {\n const el = node instanceof Element ? node : (node?.$el as Element | undefined);\n if (el instanceof Element) virtualizerRef?.value.measureElement(el);\n}\n\n/** aria-sort 仅在该列当前被排序时标注(R16) */\nfunction ariaSort(column: TableColumnOptions): \"ascending\" | \"descending\" | undefined {\n if (instance.sort.value?.key !== column.key) return undefined;\n return instance.sort.value.direction === \"asc\" ? \"ascending\" : \"descending\";\n}\n\nfunction sortMark(column: TableColumnOptions): string {\n const direction = instance.sort.value?.key === column.key ? instance.sort.value.direction : \"\";\n return direction === \"asc\" ? \"↑\" : direction === \"desc\" ? \"↓\" : \"\";\n}\n\nfunction onSort(key: string) {\n instance.toggleSort(key);\n emit(\"sort-change\", instance.sort.value);\n}\n\nfunction onPageIndex(pageIndex: number) {\n instance.setPageIndex(pageIndex);\n lastEmittedPage.pageIndex = pageIndex;\n emit(\"update:page-index\", pageIndex);\n}\n\nfunction onPageSize(pageSize: number) {\n instance.setPageSize(pageSize);\n lastEmittedPage.pageSize = pageSize;\n emit(\"update:page-size\", pageSize);\n}\n\n// ---- 受控模式(v-model):page 投影 → update:* 通知 ---------------------------\n// 仅 page-index/page-size 至少一方受控时安装;lastEmittedPage 去重——\n// 动作路径已 emit 过的值不再重复发(受控回写/内部归位只通知「未通知过的」变化)\nconst pageControlled = () => props.pageIndex !== undefined || props.pageSize !== undefined;\nconst lastEmittedPage = {\n pageIndex: undefined as number | undefined,\n pageSize: undefined as number | undefined,\n};\n\nif (pageControlled()) {\n watch(\n () => [instance.page.pageIndex, instance.page.pageSize] as const,\n ([pageIndex, pageSize]) => {\n if (pageIndex !== lastEmittedPage.pageIndex) {\n lastEmittedPage.pageIndex = pageIndex;\n emit(\"update:page-index\", pageIndex);\n }\n if (pageSize !== lastEmittedPage.pageSize) {\n lastEmittedPage.pageSize = pageSize;\n emit(\"update:page-size\", pageSize);\n }\n },\n );\n}\n\nfunction onRowClick(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-click\", record, index, event);\n}\n\nfunction onRowDblclick(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-dblclick\", record, index, event);\n}\n\nfunction onRowContextmenu(record: DataRecord, index: number, event: MouseEvent) {\n emit(\"row-contextmenu\", record, index, event);\n}\n\nfunction onCellClick(record: DataRecord, columnKey: string, index: number, event: MouseEvent) {\n emit(\"cell-click\", record, columnKey, index, event);\n}\n\ndefineExpose({\n table: instance.table,\n page: instance.page,\n sort: instance.sort,\n loading: instance.loading,\n error: instance.error,\n visibleKeys: instance.visibleKeys,\n setVisibleKeys: instance.setVisibleKeys,\n reload: instance.reload,\n toggleSort: onSort,\n setPageIndex: onPageIndex,\n setPageSize: onPageSize,\n selection: instance.selection,\n selectedKeys: instance.selectedKeys,\n setSelection: instance.setSelection,\n clearSelection: instance.clearSelection,\n});\n</script>\n\n<template>\n <div :class=\"cn('w-full', fill && 'flex h-full min-h-0 flex-col', $attrs.class)\">\n <!-- 搜索区 + 列设置触发器:同行右对齐(items-end);无搜索时触发器位于表格上方(R27:showSearch=false 关闭搜索区) -->\n <div\n v-if=\"showSearchArea || showColumnSettings\"\n :class=\"cn('mb-2 flex items-end justify-between gap-2', fill && 'shrink-0')\"\n >\n <FormRender\n v-if=\"showSearchArea\"\n class=\"min-w-0 flex-1\"\n :definition=\"search\"\n :searchable=\"search.actions ? undefined : true\"\n @search=\"onSearch\"\n @reset=\"onReset\"\n />\n\n <!-- 列设置:Popover 面板(R20 最少一列 / R21 重置 / R22 不含选择列);\n 触发钮 Tooltip 手动受控开合(Tooltip 与 Popover 触发器嵌套会吞点击,故并列渲染、不走 hover 自动触发) -->\n <template v-if=\"showColumnSettings\">\n <Popover align=\"end\" content-class=\"w-56 p-0\">\n <Button\n variant=\"ghost\"\n size=\"icon\"\n aria-label=\"列设置\"\n aria-haspopup=\"true\"\n @pointerenter=\"settingsTipOpen = true\"\n @pointerleave=\"settingsTipOpen = false\"\n >\n <!-- lucide Settings2(内联 SVG,跟随项目图标现状) -->\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M20 7h-9\" />\n <path d=\"M14 17H5\" />\n <circle cx=\"17\" cy=\"17\" r=\"3\" />\n <circle cx=\"7\" cy=\"7\" r=\"3\" />\n </svg>\n </Button>\n <template #content>\n <div class=\"flex items-center justify-end gap-3 px-3 py-2\">\n <button\n type=\"button\"\n class=\"text-muted-foreground hover:text-foreground cursor-pointer text-xs disabled:cursor-not-allowed disabled:opacity-50\"\n :disabled=\"allColumnsVisible\"\n @click=\"selectAllColumns\"\n >\n 全选\n </button>\n <button\n type=\"button\"\n class=\"text-muted-foreground hover:text-foreground cursor-pointer text-xs\"\n @click=\"resetColumns\"\n >\n 重置\n </button>\n </div>\n <Separator />\n <div class=\"max-h-64 overflow-y-auto py-1\">\n <div\n v-for=\"column in columns\"\n :key=\"column.key\"\n data-column-item\n :data-column-key=\"column.key\"\n class=\"hover:bg-accent/50 flex h-8 cursor-pointer items-center gap-2 px-3\"\n @click=\"toggleColumnVisible(column.key)\"\n >\n <Checkbox\n :checked=\"isColumnVisible(column.key)\"\n :disabled=\"!canHideColumn(column.key)\"\n @update:checked=\"toggleColumnVisible(column.key)\"\n @click.stop\n />\n <span class=\"min-w-0 flex-1 truncate\">{{ column.title }}</span>\n <!-- 有效 fixed 列(数字 width)标识 -->\n <svg\n v-if=\"column.fixed !== undefined && typeof column.width === 'number'\"\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"text-muted-foreground size-3 shrink-0\"\n aria-hidden=\"true\"\n >\n <path d=\"M12 17v5\" />\n <path\n d=\"M9 10.76a2 2 0 0 1-1.11 1.79l-1.78.9A2 2 0 0 0 5 15.24V16a1 1 0 0 0 1 1h12a1 1 0 0 0 1-1v-.76a2 2 0 0 0-1.11-1.79l-1.78-.9A2 2 0 0 1 15 10.76V7h1a2 2 0 0 0 0-4H8a2 2 0 0 0 0 4h1z\"\n />\n </svg>\n </div>\n </div>\n </template>\n </Popover>\n <!-- 纯受控气泡(无默认插槽,不渲染触发器):开合由触发钮 pointerenter/leave 驱动 -->\n <Tooltip :open=\"settingsTipOpen\" content=\"列设置\" />\n </template>\n </div>\n\n <!-- 滚动容器:横向滚动时 fixed 列 sticky 生效;virtual/fill 模式兼任纵向滚动(分页条不参与滚动) -->\n <div\n ref=\"scrollEl\"\n :class=\"cn('overflow-x-auto', fill && 'min-h-0 flex-1 overflow-y-auto')\"\n :style=\"scrollStyle\"\n >\n <table class=\"w-full caption-bottom text-sm\" :class=\"tableClass\">\n <thead ref=\"theadEl\" :class=\"theadSticky ? undefined : '[&_tr]:border-b'\">\n <tr>\n <!-- 选择列:checkbox 型表头为本页全选三态(S3/S10);radio 型占位;视作最左固定列 -->\n <th\n v-if=\"hasSelection\"\n scope=\"col\"\n class=\"h-10 w-12 px-2 align-middle font-medium text-muted-foreground\"\n :class=\"[stickyClass(stickyOf, SELECTION_CELL), theadThClass]\"\n :style=\"[\n { width: `${selection.width}px` },\n stickyStyle(stickyOf, SELECTION_CELL, true),\n ]\"\n >\n <Checkbox\n v-if=\"selection.type === 'checkbox'\"\n :checked=\"headerIndeterminate ? 'indeterminate' : headerChecked\"\n :aria-label=\"'全选本页'\"\n @update:checked=\"onHeaderSelect\"\n />\n </th>\n <th\n v-for=\"column in visibleColumns\"\n :key=\"column.key\"\n scope=\"col\"\n class=\"h-10 px-2 align-middle font-medium text-muted-foreground\"\n :class=\"[stickyClass(stickyOf, column.key), theadThClass]\"\n :style=\"[\n { width: column.width, textAlign: column.align },\n stickyStyle(stickyOf, column.key, true),\n ]\"\n :aria-sort=\"ariaSort(column)\"\n >\n <button\n v-if=\"column.sortable\"\n type=\"button\"\n class=\"inline-flex items-center gap-1 hover:text-foreground\"\n @click=\"onSort(column.key)\"\n >\n {{ column.title }}\n <span aria-hidden=\"true\" class=\"text-xs\">{{ sortMark(column) }}</span>\n </button>\n <template v-else>{{ column.title }}</template>\n </th>\n </tr>\n </thead>\n\n <tbody class=\"[&_tr:last-child]:border-0\">\n <!-- 加载态:固定 5 行骨架(R14);选择列一并占位(S8);骨架不虚拟化;loading 判定优先 -->\n <template v-if=\"loading\">\n <tr v-for=\"row in SKELETON_ROWS\" :key=\"row\" data-skeleton>\n <td\n v-if=\"hasSelection\"\n class=\"p-2 align-middle\"\n :class=\"stickyClass(stickyOf, SELECTION_CELL)\"\n :style=\"stickyStyle(stickyOf, SELECTION_CELL, false)\"\n >\n <Skeleton class=\"size-4\" />\n </td>\n <td\n v-for=\"column in visibleColumns\"\n :key=\"column.key\"\n class=\"p-2 align-middle\"\n :class=\"stickyClass(stickyOf, column.key)\"\n :style=\"[{ textAlign: column.align }, stickyStyle(stickyOf, column.key, false)]\"\n >\n <Skeleton class=\"h-4 w-full\" />\n </td>\n </tr>\n </template>\n\n <!-- 错误态:error 优先于正常数据;插槽可自定义(slot props { error, retry }) -->\n <template v-else-if=\"showError\">\n <tr data-error>\n <td :colspan=\"columnCount\" class=\"p-8 text-center text-muted-foreground\">\n <slot name=\"error\" :error=\"loadError\" :retry=\"retry\">\n <div class=\"flex flex-col items-center gap-3\">\n <p>{{ loadError?.message ?? \"加载失败\" }}</p>\n <Button variant=\"outline\" size=\"sm\" @click=\"retry\">重试</Button>\n </div>\n </slot>\n </td>\n </tr>\n </template>\n\n <!-- 虚拟滚动:窗口行 + 前后占位行(总高撑开滚动区间;行高经 measureElement 动态测量) -->\n <template v-else-if=\"virtualEnabled\">\n <tr aria-hidden=\"true\" data-virtual-pad :style=\"{ height: `${padTop}px` }\">\n <td :colspan=\"columnCount\" class=\"border-0 p-0\"></td>\n </tr>\n <TableBodyRow\n v-for=\"item in virtualLines\"\n :key=\"item.line.key\"\n :ref=\"measureRow\"\n :data-index=\"item.row.index\"\n :line=\"item.line\"\n :columns=\"visibleColumns\"\n :selection=\"hasSelection ? selection.type : undefined\"\n :selected=\"selectedKeys.has(item.line.key)\"\n :sticky=\"stickyOf\"\n :tree-indent=\"tree ? treeIndent : undefined\"\n @select=\"(checked: boolean) => onRowSelect(item.line, checked)\"\n @row-click=\"onRowClick(item.line.record, item.line.index, $event)\"\n @row-dblclick=\"onRowDblclick(item.line.record, item.line.index, $event)\"\n @row-contextmenu=\"onRowContextmenu(item.line.record, item.line.index, $event)\"\n @cell-click=\"\n (columnKey: string, event: MouseEvent) =>\n onCellClick(item.line.record, columnKey, item.line.index, event)\n \"\n />\n <tr aria-hidden=\"true\" data-virtual-pad :style=\"{ height: `${padBottom}px` }\">\n <td :colspan=\"columnCount\" class=\"border-0 p-0\"></td>\n </tr>\n </template>\n\n <template v-else>\n <TableBodyRow\n v-for=\"line in body\"\n :key=\"line.key\"\n :line=\"line\"\n :columns=\"visibleColumns\"\n :selection=\"hasSelection ? selection.type : undefined\"\n :selected=\"selectedKeys.has(line.key)\"\n :sticky=\"stickyOf\"\n :tree-indent=\"tree ? treeIndent : undefined\"\n @select=\"(checked: boolean) => onRowSelect(line, checked)\"\n @row-click=\"onRowClick(line.record, line.index, $event)\"\n @row-dblclick=\"onRowDblclick(line.record, line.index, $event)\"\n @row-contextmenu=\"onRowContextmenu(line.record, line.index, $event)\"\n @cell-click=\"\n (columnKey: string, event: MouseEvent) =>\n onCellClick(line.record, columnKey, line.index, event)\n \"\n />\n </template>\n\n <!-- 空态:横跨全列的单单元格,不虚拟化;错误态优先 -->\n <tr v-if=\"!loading && !showError && body.length === 0\" data-empty>\n <td :colspan=\"columnCount\" class=\"p-8 text-center text-muted-foreground\">\n <slot name=\"empty\">{{ emptyText ?? \"暂无数据\" }}</slot>\n </td>\n </tr>\n </tbody>\n </table>\n </div>\n\n <!-- R31:手动接线(须经 onPageIndex/onPageSize 包装器保留受控去重);显式补 border-t 与 size select 保持现状 -->\n <TablePagination\n v-if=\"showPaginationBar\"\n :class=\"cn('border-t', fill && 'shrink-0')\"\n :page-index=\"instance.page.pageIndex\"\n :page-size=\"instance.page.pageSize\"\n :page-size-opts=\"instance.page.pageSizeOpts\"\n :total=\"instance.page.total\"\n :show-size-select=\"true\"\n @update:page-index=\"onPageIndex\"\n @update:page-size=\"onPageSize\"\n />\n </div>\n</template>\n"
|
|
42
42
|
},
|
|
43
43
|
{
|
|
44
44
|
"path": "table-render/column-renders.ts",
|
|
@@ -50,7 +50,7 @@
|
|
|
50
50
|
"path": "table-render/constants.ts",
|
|
51
51
|
"type": "registry:lib",
|
|
52
52
|
"target": "components/ui/table-render/constants.ts",
|
|
53
|
-
"content": "/** 选择列在 sticky 映射中的哨兵键(选择列不在 columns 内,表头/表体单独渲染) */\nexport const SELECTION_CELL = \"__selection__\";\n"
|
|
53
|
+
"content": "/** 选择列在 sticky 映射中的哨兵键(选择列不在 columns 内,表头/表体单独渲染) */\nexport const SELECTION_CELL = \"__selection__\";\n\n/** 布局容器与 TableRender 的跨包填充协议 key:provide(true) 声明容器内 TableRender 应填满、内部滚动、表头固定 */\nexport const PAGE_TABLE_FILL_KEY = \"tu-design:page-table-fill\";\n"
|
|
54
54
|
},
|
|
55
55
|
{
|
|
56
56
|
"path": "table-render/define-columns.ts",
|
|
@@ -68,7 +68,7 @@
|
|
|
68
68
|
"path": "table-render/index.ts",
|
|
69
69
|
"type": "registry:lib",
|
|
70
70
|
"target": "components/ui/table-render/index.ts",
|
|
71
|
-
"content": "export { default as TablePagination } from \"./TablePagination.vue\";\nexport { default as TableRender } from \"./TableRender.vue\";\nexport { columnRenders } from \"./column-renders\";\nexport type {\n ColumnRenders,\n DictColumnMapping,\n DictColumnOptions,\n DictEntryVariant,\n SerialColumnOptions,\n TableActionButton,\n} from \"./column-renders\";\nexport { defineColumns } from \"./define-columns\";\nexport { defineTable } from \"./define-table\";\nexport { useTableRender } from \"./useTableRender\";\nexport type {\n DataRecord,\n DefineTableOptions,\n PageableOptions,\n SortableOptions,\n TableColumnOptions,\n TableLoadParams,\n TableRenderDefinition,\n TreeOptions,\n UseTableRenderOptions,\n} from \"./types\";\n"
|
|
71
|
+
"content": "export { default as TablePagination } from \"./TablePagination.vue\";\nexport { default as TableRender } from \"./TableRender.vue\";\nexport { columnRenders } from \"./column-renders\";\nexport { PAGE_TABLE_FILL_KEY } from \"./constants\";\nexport type {\n ColumnRenders,\n DictColumnMapping,\n DictColumnOptions,\n DictEntryVariant,\n SerialColumnOptions,\n TableActionButton,\n} from \"./column-renders\";\nexport { defineColumns } from \"./define-columns\";\nexport { defineTable } from \"./define-table\";\nexport { useTableRender } from \"./useTableRender\";\nexport type {\n DataRecord,\n DefineTableOptions,\n PageableOptions,\n SortableOptions,\n TableColumnOptions,\n TableLoadParams,\n TableRenderDefinition,\n TreeOptions,\n UseTableRenderOptions,\n} from \"./types\";\n"
|
|
72
72
|
},
|
|
73
73
|
{
|
|
74
74
|
"path": "table-render/sticky.ts",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "timeline",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.5",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "时间轴:数据驱动 items 渲染竖向事件流,支持单列/左右交替、五种语义节点色与空心节点、#item 作用域插槽自定义内容。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "toast",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.5",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "全局轻提示:ToastProvider 在应用根部挂载一次,useToast() 提供命令式 API(success/error/info/warning/loading/promise/dismiss);基于 Ark UI Toast 原语,语义 type 映射主题 token 配色。",
|
|
7
7
|
"registryDependencies": ["icon-shared", "utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "tokens",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.5",
|
|
5
5
|
"type": "registry:style",
|
|
6
6
|
"description": "Tailwind CSS v4 语义 tokens(shadcn 官方 v4 集合)。",
|
|
7
7
|
"dependencies": ["tw-animate-css@^1.4.0"],
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
"path": "styles/tokens.css",
|
|
11
11
|
"type": "registry:style",
|
|
12
12
|
"target": "styles/tokens.css",
|
|
13
|
-
"content": "/* tu-design 官方 tokens —— Tailwind CSS v4 主题(shadcn v4 集合扩展)。\n *\n * 主题桥接:语义色优先消费应用级 --app-* CSS 变量(应用主题系统写入),\n * 未定义时回落官方 oklch 值 —— 无主题系统的项目观感与上游一致,零破坏。\n * 契约(--app-* 全集见各项目主题包,如 @repo/themes):\n * - --app-bg-page/surface/raised/hover → --background/--card/--popover/--muted/--accent\n * - --app-text-1/2/3 → --foreground 及各 *-foreground/--muted-foreground\n * (text-3 上游零消费,供应用侧直接使用)\n * - --app-accent/-contrast → --primary(+foreground)/--ring\n * - --app-border → --border/--input(dark 模式建议低不透明度值,如 #FFFFFF1A,对齐上游风格)\n * - --secondary/-foreground 有意不桥接(上游定位即中性灰)\n * - --app-destructive/success/warning/info → 状态色三件套:实色、-soft 浅底(未定义回落\n * color-mix 派生)、-foreground 前景(深色实色场景如 dark destructive 白字对比 borderline,\n * 建议应用侧显式定义覆盖)\n * - .dark 块同样桥接,兜底为官方暗色 oklch;--*-soft 在 .dark 内重复声明:\n * 自定义属性按声明处求值后继承,不在 .dark 重声明将无法响应暗色的实色变化。\n */\n@import \"tw-animate-css\";\n\n@custom-variant dark (&:where(.dark, .dark *));\n\n:root {\n --background: var(--app-bg-page, oklch(1 0 0));\n --foreground: var(--app-text-1, oklch(0.145 0 0));\n --card: var(--app-bg-raised, oklch(1 0 0));\n --card-foreground: var(--app-text-1, oklch(0.145 0 0));\n --popover: var(--app-bg-raised, oklch(1 0 0));\n --popover-foreground: var(--app-text-1, oklch(0.145 0 0));\n --primary: var(--app-accent, oklch(0.205 0 0));\n --primary-foreground: var(--app-accent-contrast, oklch(0.985 0 0));\n --secondary: oklch(0.97 0 0);\n --secondary-foreground: oklch(0.205 0 0);\n --muted: var(--app-bg-surface, oklch(0.97 0 0));\n --muted-foreground: var(--app-text-2, oklch(0.556 0 0));\n --accent: var(--app-bg-hover, oklch(0.97 0 0));\n --accent-foreground: var(--app-text-1, oklch(0.205 0 0));\n --destructive: var(--app-destructive, oklch(0.577 0.245 27.325));\n --destructive-soft: var(\n --app-destructive-soft,\n color-mix(in oklab, var(--destructive) 10%, transparent)\n );\n --destructive-foreground: var(--app-destructive-foreground, oklch(0.985 0 0));\n --success: var(--app-success, oklch(0.596 0.145 163.225));\n --success-soft: var(--app-success-soft, color-mix(in oklab, var(--success) 10%, transparent));\n --success-foreground: var(--app-success-foreground, oklch(0.985 0 0));\n --warning: var(--app-warning, oklch(0.666 0.179 58.318));\n --warning-soft: var(--app-warning-soft, color-mix(in oklab, var(--warning) 12%, transparent));\n --warning-foreground: var(--app-warning-foreground, oklch(0.985 0 0));\n --info: var(--app-info, oklch(0.546 0.245 262.881));\n --info-soft: var(--app-info-soft, color-mix(in oklab, var(--info) 12%, transparent));\n --info-foreground: var(--app-info-foreground, oklch(0.985 0 0));\n --border: var(--app-border, oklch(0.922 0 0));\n --input: var(--app-border, oklch(0.922 0 0));\n --ring: var(--app-accent, oklch(0.708 0 0));\n --radius: 0.625rem;\n /* 层叠序:表体 sticky < 表头 sticky < 浮层/弹窗(同级浮层按 DOM
|
|
13
|
+
"content": "/* tu-design 官方 tokens —— Tailwind CSS v4 主题(shadcn v4 集合扩展)。\n *\n * 主题桥接:语义色优先消费应用级 --app-* CSS 变量(应用主题系统写入),\n * 未定义时回落官方 oklch 值 —— 无主题系统的项目观感与上游一致,零破坏。\n * 契约(--app-* 全集见各项目主题包,如 @repo/themes):\n * - --app-bg-page/surface/raised/hover → --background/--card/--popover/--muted/--accent\n * - --app-text-1/2/3 → --foreground 及各 *-foreground/--muted-foreground\n * (text-3 上游零消费,供应用侧直接使用)\n * - --app-accent/-contrast → --primary(+foreground)/--ring\n * - --app-border → --border/--input(dark 模式建议低不透明度值,如 #FFFFFF1A,对齐上游风格)\n * - --secondary/-foreground 有意不桥接(上游定位即中性灰)\n * - --app-destructive/success/warning/info → 状态色三件套:实色、-soft 浅底(未定义回落\n * color-mix 派生)、-foreground 前景(深色实色场景如 dark destructive 白字对比 borderline,\n * 建议应用侧显式定义覆盖)\n * - .dark 块同样桥接,兜底为官方暗色 oklch;--*-soft 在 .dark 内重复声明:\n * 自定义属性按声明处求值后继承,不在 .dark 重声明将无法响应暗色的实色变化。\n */\n@import \"tw-animate-css\";\n\n@custom-variant dark (&:where(.dark, .dark *));\n\n:root {\n --background: var(--app-bg-page, oklch(1 0 0));\n --foreground: var(--app-text-1, oklch(0.145 0 0));\n --card: var(--app-bg-raised, oklch(1 0 0));\n --card-foreground: var(--app-text-1, oklch(0.145 0 0));\n --popover: var(--app-bg-raised, oklch(1 0 0));\n --popover-foreground: var(--app-text-1, oklch(0.145 0 0));\n --primary: var(--app-accent, oklch(0.205 0 0));\n --primary-foreground: var(--app-accent-contrast, oklch(0.985 0 0));\n --secondary: oklch(0.97 0 0);\n --secondary-foreground: oklch(0.205 0 0);\n --muted: var(--app-bg-surface, oklch(0.97 0 0));\n --muted-foreground: var(--app-text-2, oklch(0.556 0 0));\n --accent: var(--app-bg-hover, oklch(0.97 0 0));\n --accent-foreground: var(--app-text-1, oklch(0.205 0 0));\n --destructive: var(--app-destructive, oklch(0.577 0.245 27.325));\n --destructive-soft: var(\n --app-destructive-soft,\n color-mix(in oklab, var(--destructive) 10%, transparent)\n );\n --destructive-foreground: var(--app-destructive-foreground, oklch(0.985 0 0));\n --success: var(--app-success, oklch(0.596 0.145 163.225));\n --success-soft: var(--app-success-soft, color-mix(in oklab, var(--success) 10%, transparent));\n --success-foreground: var(--app-success-foreground, oklch(0.985 0 0));\n --warning: var(--app-warning, oklch(0.666 0.179 58.318));\n --warning-soft: var(--app-warning-soft, color-mix(in oklab, var(--warning) 12%, transparent));\n --warning-foreground: var(--app-warning-foreground, oklch(0.985 0 0));\n --info: var(--app-info, oklch(0.546 0.245 262.881));\n --info-soft: var(--app-info-soft, color-mix(in oklab, var(--info) 12%, transparent));\n --info-foreground: var(--app-info-foreground, oklch(0.985 0 0));\n --border: var(--app-border, oklch(0.922 0 0));\n --input: var(--app-border, oklch(0.922 0 0));\n --ring: var(--app-accent, oklch(0.708 0 0));\n --radius: 0.625rem;\n /* 层叠序:表体 sticky < 表头普通列 sticky(fill/virtual 表头钉住,z-20 由 TableRender theadThClass 提供)\n < 表头 sticky < 浮层/弹窗(同级浮层按 DOM 挂载次序叠放;表头 fixed 列经 stickyStyle inline style 消费 --z-sticky-head) */\n --z-sticky: 10;\n --z-sticky-head: 30;\n --z-overlay: 50;\n}\n\n.dark {\n --background: var(--app-bg-page, oklch(0.145 0 0));\n --foreground: var(--app-text-1, oklch(0.985 0 0));\n --card: var(--app-bg-raised, oklch(0.205 0 0));\n --card-foreground: var(--app-text-1, oklch(0.985 0 0));\n --popover: var(--app-bg-raised, oklch(0.269 0 0));\n --popover-foreground: var(--app-text-1, oklch(0.985 0 0));\n --primary: var(--app-accent, oklch(0.922 0 0));\n --primary-foreground: var(--app-accent-contrast, oklch(0.205 0 0));\n --secondary: oklch(0.269 0 0);\n --secondary-foreground: oklch(0.985 0 0);\n --muted: var(--app-bg-surface, oklch(0.269 0 0));\n --muted-foreground: var(--app-text-2, oklch(0.708 0 0));\n --accent: var(--app-bg-hover, oklch(0.371 0 0));\n --accent-foreground: var(--app-text-1, oklch(0.985 0 0));\n --destructive: var(--app-destructive, oklch(0.704 0.191 22.216));\n --destructive-soft: var(\n --app-destructive-soft,\n color-mix(in oklab, var(--destructive) 10%, transparent)\n );\n --destructive-foreground: var(--app-destructive-foreground, oklch(0.985 0 0));\n --success: var(--app-success, oklch(0.696 0.17 162.48));\n --success-soft: var(--app-success-soft, color-mix(in oklab, var(--success) 10%, transparent));\n --success-foreground: var(--app-success-foreground, oklch(0.985 0 0));\n --warning: var(--app-warning, oklch(0.769 0.188 70.08));\n --warning-soft: var(--app-warning-soft, color-mix(in oklab, var(--warning) 12%, transparent));\n --warning-foreground: var(--app-warning-foreground, oklch(0.205 0 0));\n --info: var(--app-info, oklch(0.623 0.214 259.815));\n --info-soft: var(--app-info-soft, color-mix(in oklab, var(--info) 12%, transparent));\n --info-foreground: var(--app-info-foreground, oklch(0.985 0 0));\n --border: var(--app-border, oklch(1 0 0 / 10%));\n --input: var(--app-border, oklch(1 0 0 / 15%));\n --ring: var(--app-accent, 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 --radius-2xl: calc(var(--radius) + 6px);\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-destructive-soft: var(--destructive-soft);\n --color-destructive-foreground: var(--destructive-foreground);\n --color-success: var(--success);\n --color-success-foreground: var(--success-foreground);\n --color-success-soft: var(--success-soft);\n --color-warning: var(--warning);\n --color-warning-foreground: var(--warning-foreground);\n --color-warning-soft: var(--warning-soft);\n --color-info: var(--info);\n --color-info-foreground: var(--info-foreground);\n --color-info-soft: var(--info-soft);\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"
|
|
14
14
|
}
|
|
15
15
|
]
|
|
16
16
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "tooltip",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.5",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "文字提示气泡:悬停触发,基于 Ark UI Tooltip 原语,支持 asChild 与延迟配置。",
|
|
7
7
|
"registryDependencies": ["utils", "overlay-shared"],
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"path": "tooltip/Tooltip.vue",
|
|
12
12
|
"type": "registry:component",
|
|
13
13
|
"target": "components/ui/tooltip/Tooltip.vue",
|
|
14
|
-
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useSlots } from \"vue\";\nimport { Tooltip as ArkTooltip } from \"@ark-ui/vue/tooltip\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\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 { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => 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=\"setOpen\"\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-[var(--z-overlay)]\">\n <ArkTooltip.Content\n v-bind=\"props.contentProps\"\n :class=\"\n cn(\n 'bg-primary text-primary-foreground z-[var(--z-overlay)] 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"
|
|
14
|
+
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs, useSlots } from \"vue\";\nimport { Tooltip as ArkTooltip } from \"@ark-ui/vue/tooltip\";\nimport type { TooltipRootProps } from \"@ark-ui/vue/tooltip\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds)\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\"content\", \"trigger\", \"positioner\", \"arrow\"],\n});\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 /** Ark Tooltip Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed\n (absolute 包含块错位修正,机制详注见 useSandboxOverlay / sandbox.ts) */\n positioning: {\n type: Object as PropType<TooltipRootProps[\"positioning\"]>,\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 { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// 沙箱适配(机制详注见 useSandboxOverlay / sandbox.ts):面板无 Teleport 留原地,\n// iframe realm 下 strategy 默认 fixed 消除 absolute 包含块(最近 positioned 祖先)错位\nconst rootPositioning = computed(() =>\n withSandboxStrategy(props.positioning, { ...props.positioning }),\n);\n</script>\n\n<template>\n <ArkTooltip.Root\n :ids=\"rootIds\"\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 :positioning=\"rootPositioning\"\n @update:open=\"setOpen\"\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-[var(--z-overlay)]\">\n <ArkTooltip.Content\n v-bind=\"props.contentProps\"\n :class=\"\n cn(\n 'bg-primary text-primary-foreground z-[var(--z-overlay)] 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"
|
|
15
15
|
},
|
|
16
16
|
{
|
|
17
17
|
"path": "tooltip/index.ts",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "tree-select",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.5",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "树形下拉选择:一站式 props 驱动,支持单/多选、勾选级联、过滤与多标签折叠。",
|
|
7
7
|
"registryDependencies": ["icon-shared", "tree-shared", "utils", "date-shared", "overlay-shared"],
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
"path": "tree-select/TreeSelect.vue",
|
|
18
18
|
"type": "registry:component",
|
|
19
19
|
"target": "components/ui/tree-select/TreeSelect.vue",
|
|
20
|
-
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, 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 { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport ChevronIcon from \"../icon-shared/ChevronIcon.vue\";\nimport CloseIcon from \"../icon-shared/CloseIcon.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 /** @deprecated 请改用 update:open(v-model:open);下一个 minor 移除 */\n \"update:show\": [open: boolean];\n \"update:open\": [open: boolean];\n \"update:expandedKeys\": [keys: Key[]];\n}>();\n\nif (import.meta.env.DEV && getCurrentInstance()?.vnode.props?.[\"onUpdate:show\"]) {\n console.warn(\"[tu-design] <TreeSelect> update:show 已弃用,请改用 update:open(v-model:open)。\");\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\n// defaultExpandAll 只在 options 首次非空时播种:首次计算时异步数据通常还是空树\nlet expandAllSeeded = !props.defaultExpandAll || treeMate.value.treeNodes.length > 0;\nwatch(\n () => props.options,\n () => {\n if (expandAllSeeded || !props.defaultExpandAll || props.expandedKeys !== undefined) return;\n if (treeMate.value.treeNodes.length === 0) return;\n expandAllSeeded = true;\n internalExpanded.value = treeMate.value.getNonLeafKeys({ preserveGroup: true });\n },\n);\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 setOpen(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 if (props.checkable) {\n const merged = treeMate.value.uncheck(key, normalizeValue(value.value), checkOptions.value);\n updateValue(merged.checkedKeys);\n return;\n }\n updateValue(toArrayValue(value.value).filter((k) => k !== key));\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 { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => {\n emit(\"update:open\", open);\n emit(\"update:show\", open);\n },\n});\n\nfunction openFromInput() {\n if (props.disabled || isOpen.value) return;\n syncPanelWidth();\n setOpen(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=\"setOpen\">\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 <CloseIcon class=\"size-4 shrink-0\" />\n </span>\n <ChevronIcon\n :class=\"\n cn(\n 'size-4 shrink-0 text-muted-foreground transition-transform',\n isOpen ? '-rotate-90' : 'rotate-90',\n )\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-[var(--z-overlay)]\">\n <ArkPopover.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground z-[var(--z-overlay)] 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
|
+
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, nextTick, ref, useAttrs, watch } from \"vue\";\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport type { PopoverRootProps } from \"@ark-ui/vue/popover\";\nimport { cn } from \"@/lib/utils\";\nimport { controlCls } from \"../date-shared/shared\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\nimport ChevronIcon from \"../icon-shared/ChevronIcon.vue\";\nimport CloseIcon from \"../icon-shared/CloseIcon.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\";\n\n// ids 全量覆盖(无冒号):ArkPopover 浮层载体,规避 wujie patch getElementById\n// 对 zag 缺省冒号 id 的 SyntaxError 刷屏(详注见 useOverlayIds)\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"anchor\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"arrow\",\n ],\n});\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 /** Ark Popover Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed */\n positioning: {\n type: Object as PropType<PopoverRootProps[\"positioning\"]>,\n default: undefined,\n },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: Key | Key[] | undefined];\n /** @deprecated 请改用 update:open(v-model:open);下一个 minor 移除 */\n \"update:show\": [open: boolean];\n \"update:open\": [open: boolean];\n \"update:expandedKeys\": [keys: Key[]];\n}>();\n\nif (import.meta.env.DEV && getCurrentInstance()?.vnode.props?.[\"onUpdate:show\"]) {\n console.warn(\"[tu-design] <TreeSelect> update:show 已弃用,请改用 update:open(v-model:open)。\");\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\n// defaultExpandAll 只在 options 首次非空时播种:首次计算时异步数据通常还是空树\nlet expandAllSeeded = !props.defaultExpandAll || treeMate.value.treeNodes.length > 0;\nwatch(\n () => props.options,\n () => {\n if (expandAllSeeded || !props.defaultExpandAll || props.expandedKeys !== undefined) return;\n if (treeMate.value.treeNodes.length === 0) return;\n expandAllSeeded = true;\n internalExpanded.value = treeMate.value.getNonLeafKeys({ preserveGroup: true });\n },\n);\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 setOpen(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 if (props.checkable) {\n const merged = treeMate.value.uncheck(key, normalizeValue(value.value), checkOptions.value);\n updateValue(merged.checkedKeys);\n return;\n }\n updateValue(toArrayValue(value.value).filter((k) => k !== key));\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 { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => {\n emit(\"update:open\", open);\n emit(\"update:show\", open);\n },\n});\n\n// —— 沙箱适配(机制详注见 useSandboxOverlay / sandbox.ts):Teleport 目标降级\n// (shadow DOM / wujie graft → 应用挂载容器,避免面板落入 iframe body)+\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位,fixed 唯一正确解);\n// 无 to prop,面板恒传送 ——\nconst teleportTarget = useSandboxTeleportTarget(() => undefined);\nconst rootPositioning = computed(() =>\n withSandboxStrategy(props.positioning, { ...props.positioning }),\n);\n\nfunction openFromInput() {\n if (props.disabled || isOpen.value) return;\n syncPanelWidth();\n setOpen(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\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :positioning=\"rootPositioning\"\n @update:open=\"setOpen\"\n >\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 <CloseIcon class=\"size-4 shrink-0\" />\n </span>\n <ChevronIcon\n :class=\"\n cn(\n 'size-4 shrink-0 text-muted-foreground transition-transform',\n isOpen ? '-rotate-90' : 'rotate-90',\n )\n \"\n />\n </span>\n </div>\n </ArkPopover.Anchor>\n\n <!-- 弹层 Teleport:脱离表单 DOM,消除 overflow 容器裁剪隐患(DatePicker 同款);\n 目标经沙箱适配降级(shadow DOM / wujie graft → 应用挂载容器) -->\n <Teleport :to=\"teleportTarget\">\n <ArkPopover.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkPopover.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground z-[var(--z-overlay)] 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"
|
|
21
21
|
},
|
|
22
22
|
{
|
|
23
23
|
"path": "tree-select/index.ts",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "tree-shared",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.5",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "树形数据层与共享类型(移植自 treemate v0.3.11,MIT)。",
|
|
7
7
|
"registryDependencies": ["icon-shared", "utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "utils",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.5",
|
|
5
5
|
"type": "registry:lib",
|
|
6
6
|
"description": "cn 类名合并工具(clsx + tailwind-merge)。",
|
|
7
7
|
"dependencies": ["clsx@^2.1.1", "tailwind-merge@^3.7.0", "class-variance-authority@^0.7.1"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "week-picker",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.5",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "周选择器:输入框 + 日历弹层,点任意可选日归一到所在周并整周高亮,值以 \"yyyy-MM-dd\"(所在周起始日)字符串受控;周起点跟随 locale(zh-CN 周一起始),输入框回显 \"start ~ end\"。",
|
|
7
7
|
"registryDependencies": ["utils", "date-shared", "calendar"],
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"path": "week-picker/WeekPicker.vue",
|
|
12
12
|
"type": "registry:component",
|
|
13
13
|
"target": "components/ui/week-picker/WeekPicker.vue",
|
|
14
|
-
"content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide } from \"vue\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport PickerShell from \"../date-shared/PickerShell.vue\";\nimport {\n CALENDAR_IN_PICKER,\n formatIsoWeek,\n parseIsoDate,\n weekStartOf,\n} from \"../date-shared/shared\";\nimport { usePickerBridge } from \"../date-shared/usePickerBridge\";\n\nconst props = defineProps({\n /** 受控值(\"yyyy-MM-dd\",语义=所在周起始日);undefined 走内部非受控,null 表示空 */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n /** 非受控初值(\"yyyy-MM-dd\",内部归一到所在周起始日) */\n defaultValue: { type: String, default: undefined },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n placeholder: { type: String, default: \"请选择周\" },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 可选下界(\"yyyy-MM-dd\",含当日;日粒度,周条带可能视觉越界但不影响点选禁用) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy-MM-dd\",含当日) */\n max: { type: String, default: undefined },\n /** 不可选日期谓词(参数为 ark 的 DateValue;命中格不可点,同周其余日仍可选) */\n isDateUnavailable: {\n type: Function as PropType<(date: DateValue) => boolean>,\n default: undefined,\n },\n /** 选中后是否自动关弹层 */\n closeOnSelect: { type: Boolean, default: true },\n /** 文案与周起点跟随 locale(zh-CN 默认周一起始) */\n locale: { type: String, default: \"zh-CN\" },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n \"update:open\": [open: boolean];\n}>();\n\n// attrs(id/aria-*)转发给真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root,值归本 Picker)\nprovide(CALENDAR_IN_PICKER, true);\n\n/** \"yyyy-MM-dd\" → 归一到所在周起始日的 ISO 串(非法输入返回 undefined) */\nfunction formatIsoWeekStart(raw: string): string | undefined {\n const date = parseIsoDate(raw);\n return date ? weekStartOf(date, props.locale).toString() : undefined;\n}\n\nconst { rootValue, isOpen, setOpen, handleValueUpdate } = usePickerBridge({\n modelValue: () => props.modelValue,\n defaultValue: () => props.defaultValue,\n open: () => props.open,\n defaultOpen: () => props.defaultOpen,\n disabled: () => props.disabled,\n readOnly: () => props.readOnly,\n parse: parseIsoDate,\n normalizeDefault: (raw) => formatIsoWeekStart(raw) ?? null,\n toPublicValue: (date) => formatIsoWeekStart(date.toString()) ?? null,\n onUpdateModelValue: (value) => emit(\"update:modelValue\", value),\n onUpdateOpen: (open) => emit(\"update:open\", open),\n});\n\nconst minDate = computed(() => parseIsoDate(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoDate(props.max ?? \"\"));\n\n// 输入框回显整周区间(format 钩子按单值调用,zag 自行拼接)\nfunction formatDate(date: DateValue): string {\n return formatIsoWeek(date, props.locale);\n}\n\n// 键入解析:任意合法日期键入归一到周起点;非法返回 undefined 由 zag 忽略\nfunction parseDate(raw: string): DateValue | undefined {\n const date = parseIsoDate(raw);\n return date ? weekStartOf(date, props.locale) : undefined;\n}\n</script>\n\n<template>\n <PickerShell\n v-bind=\"$attrs\"\n :model-value=\"rootValue\"\n :open=\"isOpen\"\n :locale=\"props.locale\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :is-date-unavailable=\"props.isDateUnavailable\"\n :close-on-select=\"props.closeOnSelect\"\n :read-only=\"props.readOnly\"\n :disabled=\"props.disabled\"\n :invalid=\"props.invalid\"\n :placeholder=\"props.placeholder\"\n :class=\"props.class\"\n :format=\"formatDate\"\n :parse=\"parseDate\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <TCalendar week :locale=\"props.locale\" />\n </PickerShell>\n</template>\n"
|
|
14
|
+
"content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport type { PickerPositioning } from \"../date-shared/positioning\";\nimport type { PropType } from \"vue\";\nimport { computed, provide } from \"vue\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport PickerShell from \"../date-shared/PickerShell.vue\";\nimport {\n CALENDAR_IN_PICKER,\n formatIsoWeek,\n parseIsoDate,\n weekStartOf,\n} from \"../date-shared/shared\";\nimport { usePickerBridge } from \"../date-shared/usePickerBridge\";\n\nconst props = defineProps({\n /** 受控值(\"yyyy-MM-dd\",语义=所在周起始日);undefined 走内部非受控,null 表示空 */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n /** 非受控初值(\"yyyy-MM-dd\",内部归一到所在周起始日) */\n defaultValue: { type: String, default: undefined },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n placeholder: { type: String, default: \"请选择周\" },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 可选下界(\"yyyy-MM-dd\",含当日;日粒度,周条带可能视觉越界但不影响点选禁用) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy-MM-dd\",含当日) */\n max: { type: String, default: undefined },\n /** 不可选日期谓词(参数为 ark 的 DateValue;命中格不可点,同周其余日仍可选) */\n isDateUnavailable: {\n type: Function as PropType<(date: DateValue) => boolean>,\n default: undefined,\n },\n /** 选中后是否自动关弹层 */\n closeOnSelect: { type: Boolean, default: true },\n /** 文案与周起点跟随 locale(zh-CN 默认周一起始) */\n locale: { type: String, default: \"zh-CN\" },\n /** Ark DatePicker Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed\n (absolute 包含块错位修正,机制详注见 useSandboxOverlay / sandbox.ts) */\n positioning: {\n type: Object as PropType<PickerPositioning>,\n default: undefined,\n },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n \"update:open\": [open: boolean];\n}>();\n\n// attrs(id/aria-*)转发给真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root,值归本 Picker)\nprovide(CALENDAR_IN_PICKER, true);\n\n/** \"yyyy-MM-dd\" → 归一到所在周起始日的 ISO 串(非法输入返回 undefined) */\nfunction formatIsoWeekStart(raw: string): string | undefined {\n const date = parseIsoDate(raw);\n return date ? weekStartOf(date, props.locale).toString() : undefined;\n}\n\nconst { rootValue, isOpen, setOpen, handleValueUpdate } = usePickerBridge({\n modelValue: () => props.modelValue,\n defaultValue: () => props.defaultValue,\n open: () => props.open,\n defaultOpen: () => props.defaultOpen,\n disabled: () => props.disabled,\n readOnly: () => props.readOnly,\n parse: parseIsoDate,\n normalizeDefault: (raw) => formatIsoWeekStart(raw) ?? null,\n toPublicValue: (date) => formatIsoWeekStart(date.toString()) ?? null,\n onUpdateModelValue: (value) => emit(\"update:modelValue\", value),\n onUpdateOpen: (open) => emit(\"update:open\", open),\n});\n\nconst minDate = computed(() => parseIsoDate(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoDate(props.max ?? \"\"));\n\n// 输入框回显整周区间(format 钩子按单值调用,zag 自行拼接)\nfunction formatDate(date: DateValue): string {\n return formatIsoWeek(date, props.locale);\n}\n\n// 键入解析:任意合法日期键入归一到周起点;非法返回 undefined 由 zag 忽略\nfunction parseDate(raw: string): DateValue | undefined {\n const date = parseIsoDate(raw);\n return date ? weekStartOf(date, props.locale) : undefined;\n}\n</script>\n\n<template>\n <PickerShell\n v-bind=\"$attrs\"\n :model-value=\"rootValue\"\n :open=\"isOpen\"\n :locale=\"props.locale\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :is-date-unavailable=\"props.isDateUnavailable\"\n :close-on-select=\"props.closeOnSelect\"\n :read-only=\"props.readOnly\"\n :disabled=\"props.disabled\"\n :invalid=\"props.invalid\"\n :placeholder=\"props.placeholder\"\n :positioning=\"props.positioning\"\n :class=\"props.class\"\n :format=\"formatDate\"\n :parse=\"parseDate\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <TCalendar week :locale=\"props.locale\" />\n </PickerShell>\n</template>\n"
|
|
15
15
|
},
|
|
16
16
|
{
|
|
17
17
|
"path": "week-picker/index.ts",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "year-picker",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.5",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "年份选择器:输入框 + 锁定年视图的日历弹层(decade 网格),值以 \"yyyy\" 字符串受控,min/max 为年粒度闭区间。",
|
|
7
7
|
"registryDependencies": ["utils", "date-shared", "calendar"],
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"path": "year-picker/YearPicker.vue",
|
|
12
12
|
"type": "registry:component",
|
|
13
13
|
"target": "components/ui/year-picker/YearPicker.vue",
|
|
14
|
-
"content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide } from \"vue\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport PickerShell from \"../date-shared/PickerShell.vue\";\nimport { CALENDAR_IN_PICKER, formatIsoYear, parseIsoYear } from \"../date-shared/shared\";\nimport { usePickerBridge } from \"../date-shared/usePickerBridge\";\n\nconst props = defineProps({\n /** 受控年份(\"yyyy\");undefined 走内部非受控,null 表示空 */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n /** 非受控初值(\"yyyy\") */\n defaultValue: { type: String, default: undefined },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n placeholder: { type: String, default: \"请选择年份\" },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 可选下界(\"yyyy\",含当年) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy\",含当年) */\n max: { type: String, default: undefined },\n /** 选中后是否自动关弹层 */\n closeOnSelect: { type: Boolean, default: true },\n /** 文案与周起点跟随 locale */\n locale: { type: String, default: \"zh-CN\" },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n \"update:open\": [open: boolean];\n}>();\n\n// attrs(id/aria-*)转发给真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root,值归本 Picker)\nprovide(CALENDAR_IN_PICKER, true);\n\nconst { rootValue, isOpen, setOpen, handleValueUpdate } = usePickerBridge({\n modelValue: () => props.modelValue,\n defaultValue: () => props.defaultValue,\n open: () => props.open,\n defaultOpen: () => props.defaultOpen,\n disabled: () => props.disabled,\n readOnly: () => props.readOnly,\n parse: parseIsoYear,\n toPublicValue: formatIsoYear,\n onUpdateModelValue: (value) => emit(\"update:modelValue\", value),\n onUpdateOpen: (open) => emit(\"update:open\", open),\n});\n\n// 年格 disabled 只比 min?.year/max?.year(zag connect isValueWithinRange),\n// 锚 1 月 1 日即安全,无需 MonthPicker 的末日换算\nconst minDate = computed(() => parseIsoYear(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoYear(props.max ?? \"\"));\n</script>\n\n<template>\n <PickerShell\n v-bind=\"$attrs\"\n :model-value=\"rootValue\"\n :open=\"isOpen\"\n :locale=\"props.locale\"\n min-view=\"year\"\n max-view=\"year\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :close-on-select=\"props.closeOnSelect\"\n :read-only=\"props.readOnly\"\n :disabled=\"props.disabled\"\n :invalid=\"props.invalid\"\n :placeholder=\"props.placeholder\"\n :class=\"props.class\"\n :format=\"formatIsoYear\"\n :parse=\"parseIsoYear\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <TCalendar mode=\"year\" />\n </PickerShell>\n</template>\n"
|
|
14
|
+
"content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport type { PickerPositioning } from \"../date-shared/positioning\";\nimport type { PropType } from \"vue\";\nimport { computed, provide } from \"vue\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport PickerShell from \"../date-shared/PickerShell.vue\";\nimport { CALENDAR_IN_PICKER, formatIsoYear, parseIsoYear } from \"../date-shared/shared\";\nimport { usePickerBridge } from \"../date-shared/usePickerBridge\";\n\nconst props = defineProps({\n /** 受控年份(\"yyyy\");undefined 走内部非受控,null 表示空 */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n /** 非受控初值(\"yyyy\") */\n defaultValue: { type: String, default: undefined },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n placeholder: { type: String, default: \"请选择年份\" },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 可选下界(\"yyyy\",含当年) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy\",含当年) */\n max: { type: String, default: undefined },\n /** 选中后是否自动关弹层 */\n closeOnSelect: { type: Boolean, default: true },\n /** 文案与周起点跟随 locale */\n locale: { type: String, default: \"zh-CN\" },\n /** Ark DatePicker Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed\n (absolute 包含块错位修正,机制详注见 useSandboxOverlay / sandbox.ts) */\n positioning: {\n type: Object as PropType<PickerPositioning>,\n default: undefined,\n },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n \"update:open\": [open: boolean];\n}>();\n\n// attrs(id/aria-*)转发给真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root,值归本 Picker)\nprovide(CALENDAR_IN_PICKER, true);\n\nconst { rootValue, isOpen, setOpen, handleValueUpdate } = usePickerBridge({\n modelValue: () => props.modelValue,\n defaultValue: () => props.defaultValue,\n open: () => props.open,\n defaultOpen: () => props.defaultOpen,\n disabled: () => props.disabled,\n readOnly: () => props.readOnly,\n parse: parseIsoYear,\n toPublicValue: formatIsoYear,\n onUpdateModelValue: (value) => emit(\"update:modelValue\", value),\n onUpdateOpen: (open) => emit(\"update:open\", open),\n});\n\n// 年格 disabled 只比 min?.year/max?.year(zag connect isValueWithinRange),\n// 锚 1 月 1 日即安全,无需 MonthPicker 的末日换算\nconst minDate = computed(() => parseIsoYear(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoYear(props.max ?? \"\"));\n</script>\n\n<template>\n <PickerShell\n v-bind=\"$attrs\"\n :model-value=\"rootValue\"\n :open=\"isOpen\"\n :locale=\"props.locale\"\n min-view=\"year\"\n max-view=\"year\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :close-on-select=\"props.closeOnSelect\"\n :read-only=\"props.readOnly\"\n :disabled=\"props.disabled\"\n :invalid=\"props.invalid\"\n :placeholder=\"props.placeholder\"\n :positioning=\"props.positioning\"\n :class=\"props.class\"\n :format=\"formatIsoYear\"\n :parse=\"parseIsoYear\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <TCalendar mode=\"year\" />\n </PickerShell>\n</template>\n"
|
|
15
15
|
},
|
|
16
16
|
{
|
|
17
17
|
"path": "year-picker/index.ts",
|