@tu-design/vue 0.5.0 → 0.5.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/dist/index.d.mts +358 -178
  2. package/dist/index.mjs +344 -226
  3. package/dist/registry/vue/alert-dialog.json +1 -1
  4. package/dist/registry/vue/alert.json +3 -3
  5. package/dist/registry/vue/avatar-group.json +1 -1
  6. package/dist/registry/vue/avatar.json +1 -1
  7. package/dist/registry/vue/badge.json +1 -1
  8. package/dist/registry/vue/button.json +1 -1
  9. package/dist/registry/vue/calendar.json +5 -5
  10. package/dist/registry/vue/card.json +1 -1
  11. package/dist/registry/vue/cascader.json +4 -4
  12. package/dist/registry/vue/checkbox.json +1 -1
  13. package/dist/registry/vue/context-menu.json +1 -1
  14. package/dist/registry/vue/currency-input.json +1 -1
  15. package/dist/registry/vue/date-picker.json +1 -1
  16. package/dist/registry/vue/date-range-picker.json +3 -3
  17. package/dist/registry/vue/date-shared.json +3 -15
  18. package/dist/registry/vue/dialog.json +3 -3
  19. package/dist/registry/vue/drawer.json +3 -3
  20. package/dist/registry/vue/dropdown-menu.json +1 -1
  21. package/dist/registry/vue/empty.json +1 -1
  22. package/dist/registry/vue/form-render.json +1 -1
  23. package/dist/registry/vue/form.json +1 -1
  24. package/dist/registry/vue/icon-shared.json +27 -0
  25. package/dist/registry/vue/input.json +1 -1
  26. package/dist/registry/vue/label.json +1 -1
  27. package/dist/registry/vue/month-picker.json +1 -1
  28. package/dist/registry/vue/number-input.json +1 -1
  29. package/dist/registry/vue/overlay-shared.json +1 -1
  30. package/dist/registry/vue/password-input.json +1 -1
  31. package/dist/registry/vue/pin-input.json +1 -1
  32. package/dist/registry/vue/popconfirm.json +1 -1
  33. package/dist/registry/vue/popover.json +2 -2
  34. package/dist/registry/vue/progress.json +1 -1
  35. package/dist/registry/vue/radio-group.json +1 -1
  36. package/dist/registry/vue/registry.json +58 -51
  37. package/dist/registry/vue/select.json +3 -3
  38. package/dist/registry/vue/separator.json +1 -1
  39. package/dist/registry/vue/skeleton.json +1 -1
  40. package/dist/registry/vue/slider.json +1 -1
  41. package/dist/registry/vue/slot.json +1 -1
  42. package/dist/registry/vue/spin.json +2 -2
  43. package/dist/registry/vue/switch.json +1 -1
  44. package/dist/registry/vue/table-render.json +3 -2
  45. package/dist/registry/vue/tabs.json +1 -1
  46. package/dist/registry/vue/textarea.json +1 -1
  47. package/dist/registry/vue/timeline.json +1 -1
  48. package/dist/registry/vue/toast.json +3 -3
  49. package/dist/registry/vue/tokens.json +1 -1
  50. package/dist/registry/vue/tooltip.json +1 -1
  51. package/dist/registry/vue/tree-select.json +4 -4
  52. package/dist/registry/vue/tree-shared.json +3 -15
  53. package/dist/registry/vue/utils.json +1 -1
  54. package/dist/registry/vue/week-picker.json +1 -1
  55. package/dist/registry/vue/year-picker.json +1 -1
  56. package/package.json +1 -1
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "alert-dialog",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "确认弹窗单组件:v-model:open 控制显隐,title/description 传文案,@confirm/@cancel 处理确认与取消;确认处理器返回 Promise 时按钮进入 loading 并锁定 ESC/遮罩关闭,resolve 自动关闭、reject 保持打开;内容节点为 role=alertdialog。",
7
7
  "registryDependencies": ["button", "utils", "overlay-shared"],
@@ -1,17 +1,17 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "alert",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "语义化警示条,支持五种变体、内置图标与可关闭交互。",
7
- "registryDependencies": ["utils"],
7
+ "registryDependencies": ["icon-shared", "utils"],
8
8
  "dependencies": ["class-variance-authority@^0.7.1"],
9
9
  "files": [
10
10
  {
11
11
  "path": "alert/Alert.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/alert/Alert.vue",
14
- "content": "<script setup lang=\"ts\">\nimport { computed, useSlots } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { alertIconPaths, alertIconVariants, alertVariants, type AlertVariants } from \"./index\";\n\ninterface Props {\n title?: string;\n description?: string;\n variant?: AlertVariants[\"variant\"];\n closable?: boolean;\n showIcon?: boolean;\n class?: string;\n}\n\nconst props = withDefaults(defineProps<Props>(), {\n title: \"\",\n description: undefined,\n variant: \"default\",\n closable: false,\n showIcon: true,\n class: undefined,\n});\n\nconst emit = defineEmits<{ close: [] }>();\n\nconst slots = useSlots();\n\nconst visible = defineModel<boolean>({ default: true });\n\nconst role = computed(() => (props.variant === \"error\" ? \"alert\" : \"status\"));\n\nconst iconPath = computed(\n () => alertIconPaths[props.variant ?? \"default\"] ?? alertIconPaths.default,\n);\n\nfunction onClose() {\n visible.value = false;\n emit(\"close\");\n}\n</script>\n\n<template>\n <div\n v-if=\"visible\"\n :role=\"role\"\n :class=\"cn(alertVariants({ variant: props.variant }), props.class)\"\n >\n <slot name=\"icon\">\n <svg\n v-if=\"props.showIcon\"\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 aria-hidden=\"true\"\n :class=\"cn(alertIconVariants({ variant: props.variant }))\"\n >\n <path :d=\"iconPath\" />\n </svg>\n </slot>\n\n <div class=\"min-w-0 flex-1\">\n <div v-if=\"props.title || slots.title\" class=\"font-medium leading-snug\">\n <slot name=\"title\">{{ props.title }}</slot>\n </div>\n <div\n v-if=\"props.description || slots.default\"\n :class=\"\n cn(\n 'text-sm leading-relaxed',\n (props.title || slots.title) && 'text-muted-foreground mt-1',\n )\n \"\n >\n <slot>{{ props.description }}</slot>\n </div>\n </div>\n\n <slot name=\"close\">\n <button\n v-if=\"props.closable\"\n type=\"button\"\n aria-label=\"关闭\"\n class=\"shrink-0 rounded-sm opacity-60 transition-opacity hover:opacity-100 focus-visible:outline-2 focus-visible:outline-ring -m-1 p-1\"\n @click=\"onClose\"\n >\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n aria-hidden=\"true\"\n class=\"size-4\"\n >\n <path d=\"M18 6 6 18M6 6l12 12\" />\n </svg>\n </button>\n </slot>\n </div>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport { computed, useSlots } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\nimport { alertIconPaths, alertIconVariants, alertVariants, type AlertVariants } from \"./index\";\n\ninterface Props {\n title?: string;\n description?: string;\n variant?: AlertVariants[\"variant\"];\n closable?: boolean;\n showIcon?: boolean;\n class?: string;\n}\n\nconst props = withDefaults(defineProps<Props>(), {\n title: \"\",\n description: undefined,\n variant: \"default\",\n closable: false,\n showIcon: true,\n class: undefined,\n});\n\nconst emit = defineEmits<{ close: [] }>();\n\nconst slots = useSlots();\n\nconst visible = defineModel<boolean>({ default: true });\n\nconst role = computed(() => (props.variant === \"error\" ? \"alert\" : \"status\"));\n\nconst iconPath = computed(\n () => alertIconPaths[props.variant ?? \"default\"] ?? alertIconPaths.default,\n);\n\nfunction onClose() {\n visible.value = false;\n emit(\"close\");\n}\n</script>\n\n<template>\n <div\n v-if=\"visible\"\n :role=\"role\"\n :class=\"cn(alertVariants({ variant: props.variant }), props.class)\"\n >\n <slot name=\"icon\">\n <svg\n v-if=\"props.showIcon\"\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 aria-hidden=\"true\"\n :class=\"cn(alertIconVariants({ variant: props.variant }))\"\n >\n <path :d=\"iconPath\" />\n </svg>\n </slot>\n\n <div class=\"min-w-0 flex-1\">\n <div v-if=\"props.title || slots.title\" class=\"font-medium leading-snug\">\n <slot name=\"title\">{{ props.title }}</slot>\n </div>\n <div\n v-if=\"props.description || slots.default\"\n :class=\"\n cn(\n 'text-sm leading-relaxed',\n (props.title || slots.title) && 'text-muted-foreground mt-1',\n )\n \"\n >\n <slot>{{ props.description }}</slot>\n </div>\n </div>\n\n <slot name=\"close\">\n <button\n v-if=\"props.closable\"\n type=\"button\"\n aria-label=\"关闭\"\n class=\"shrink-0 rounded-sm opacity-60 transition-opacity hover:opacity-100 focus-visible:outline-2 focus-visible:outline-ring -m-1 p-1\"\n @click=\"onClose\"\n >\n <CloseIcon class=\"size-4\" />\n </button>\n </slot>\n </div>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "alert/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "avatar-group",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "头像组,数量折叠、悬停展开与垂直排列。",
7
7
  "registryDependencies": ["utils", "avatar"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "avatar",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "头像,支持尺寸/形状、加载占位与失败回退(Ark UI)。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "badge",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "轻量状态徽标,支持四种变体。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "button",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "带变体与尺寸的按钮,支持 as 标签切换与 asChild 组合。",
7
7
  "registryDependencies": ["utils", "slot"],
@@ -1,29 +1,29 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "calendar",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "日历(TCalendar):紧凑日历卡。Picker 弹层内为 embedded 内嵌形态(TDatePicker/TDateRangePicker 自动挂靠,纯卡片内核);独立使用即 standalone 独立形态(自带日历状态与 v-model,恒开展示)。",
7
- "registryDependencies": ["utils", "date-shared"],
7
+ "registryDependencies": ["icon-shared", "utils", "date-shared"],
8
8
  "dependencies": ["@ark-ui/vue@^5.39.2"],
9
9
  "files": [
10
10
  {
11
11
  "path": "calendar/Calendar.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/calendar/Calendar.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, inject, ref } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { CALENDAR_IN_PICKER, formatIsoDate, parseIsoDate } from \"../date-shared/shared\";\nimport CalendarBody from \"./CalendarBody.vue\";\n\nconst props = defineProps({\n /** 视图形态:day=日网格(可切月/年);standalone 时 month/year 同时派生视图锁定 */\n mode: { type: String as PropType<\"day\" | \"month\" | \"year\">, default: \"day\" },\n /** 日视图并排月数 */\n numOfMonths: { type: Number, default: 1 },\n /** 受控值(\"yyyy-MM-dd\");仅 standalone 独立形态生效,embedded 值归宿主 Picker */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n /** 非受控初值(仅 standalone) */\n defaultValue: { type: String, default: undefined },\n /** 可选下界(\"yyyy-MM-dd\",含当日;仅 standalone) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy-MM-dd\",含当日;仅 standalone) */\n max: { type: String, default: undefined },\n /** 不可选日期谓词(参数为 ark 的 DateValue;仅 standalone) */\n isDateUnavailable: {\n type: Function as PropType<(date: DateValue) => boolean>,\n default: undefined,\n },\n /** 文案与周起点跟随 locale(仅 standalone;embedded 随宿主 Picker) */\n locale: { type: String, default: \"zh-CN\" },\n /** 周选择形态:日视图下整周高亮(与 TWeekPicker 配套) */\n week: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n}>();\n\n// 双形态探测:Picker 弹层内(宿主 provide)为 embedded 内嵌形态(纯卡片内核);独立使用为 standalone 独立形态(自建 Root)\nconst standalone = !inject(CALENDAR_IN_PICKER, false);\n\n// standalone 时 month/year 形态即语义 → 派生视图锁定(day 不锁,保留月/年切换)\nconst viewLock = computed(() => (props.mode === \"day\" ? undefined : props.mode));\n\n// —— 受控桥(DatePicker 同款简化版,单值无 mirror 需求)——\nconst internalValue = ref<string | null>(props.defaultValue ?? null);\nconst selected = computed(() => {\n const raw = props.modelValue !== undefined ? props.modelValue : internalValue.value;\n return parseIsoDate(raw ?? \"\");\n});\n// zag value 为 DateValue[] 数组形态,单选语义收敛为 [date] | []\nconst rootValue = computed<DateValue[]>(() => (selected.value ? [selected.value] : []));\n\nconst minDate = computed(() => parseIsoDate(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoDate(props.max ?? \"\"));\n\nfunction handleValueUpdate(next: DateValue[]) {\n const value = next[0] ? formatIsoDate(next[0]) : null;\n internalValue.value = value;\n emit(\"update:modelValue\", value);\n}\n</script>\n\n<template>\n <!--\n standalone 独立形态:自建 Root。:open=\"true\" 恒开——独立卡片没有输入框/触发钮\n 去打开弹层,不恒开则 Content hidden 整卡不可见。沿用已验证的 Root > Content 直渲形态\n (无 Positioner:卡片非浮层,就地渲染)。\n 外层 div 承接 attrs(Ark Root 不透传 attrs,实测 class/id 会丢);w-fit 收缩包裹卡片宽度。\n -->\n <div v-if=\"standalone\" :class=\"cn('w-fit', $attrs.class)\">\n <ArkDatePicker.Root\n :model-value=\"rootValue\"\n :open=\"true\"\n :num-of-months=\"props.numOfMonths\"\n :min-view=\"viewLock\"\n :max-view=\"viewLock\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :is-date-unavailable=\"props.isDateUnavailable\"\n :locale=\"props.locale\"\n @update:model-value=\"handleValueUpdate\"\n >\n <ArkDatePicker.Content>\n <CalendarBody\n :mode=\"props.mode\"\n :num-of-months=\"props.numOfMonths\"\n :week=\"props.week\"\n :locale=\"props.locale\"\n />\n </ArkDatePicker.Content>\n </ArkDatePicker.Root>\n </div>\n\n <!-- embedded 内嵌形态:宿主 Picker 的 Root 供能,纯卡片内核 -->\n <CalendarBody\n v-else\n :mode=\"props.mode\"\n :num-of-months=\"props.numOfMonths\"\n :week=\"props.week\"\n :locale=\"props.locale\"\n />\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, inject, ref } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { CALENDAR_IN_PICKER, formatIsoDate, parseIsoDate } from \"../date-shared/shared\";\nimport CalendarBody from \"./CalendarBody.vue\";\n\nconst props = defineProps({\n /** 视图形态:day=日网格(可切月/年);standalone 时 month/year 同时派生视图锁定 */\n mode: { type: String as PropType<\"day\" | \"month\" | \"year\">, default: \"day\" },\n /** 日视图并排月数 */\n numOfMonths: { type: Number, default: 1 },\n /** 受控值(\"yyyy-MM-dd\");仅 standalone 独立形态生效,embedded 值归宿主 Picker */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n /** 非受控初值(仅 standalone) */\n defaultValue: { type: String, default: undefined },\n /** 可选下界(\"yyyy-MM-dd\",含当日;仅 standalone) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy-MM-dd\",含当日;仅 standalone) */\n max: { type: String, default: undefined },\n /** 不可选日期谓词(参数为 ark 的 DateValue;仅 standalone) */\n isDateUnavailable: {\n type: Function as PropType<(date: DateValue) => boolean>,\n default: undefined,\n },\n /** 文案与周起点跟随 locale(仅 standalone;embedded 随宿主 Picker) */\n locale: { type: String, default: \"zh-CN\" },\n /** 周选择形态:日视图下整周高亮(与 TWeekPicker 配套) */\n week: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n}>();\n\n// 双形态探测:Picker 弹层内(宿主 provide)为 embedded 内嵌形态(纯卡片内核);独立使用为 standalone 独立形态(自建 Root)\nconst standalone = !inject(CALENDAR_IN_PICKER, false);\n\n// standalone 时 month/year 形态即语义 → 派生视图锁定(day 不锁,保留月/年切换)\nconst viewLock = computed(() => (props.mode === \"day\" ? undefined : props.mode));\n\n// —— 受控桥(DatePicker 同款简化版,单值无 mirror 需求)——\nconst internalValue = ref<string | null>(props.defaultValue ?? null);\nconst selected = computed(() => {\n const raw = props.modelValue !== undefined ? props.modelValue : internalValue.value;\n return parseIsoDate(raw ?? \"\");\n});\n// zag value 为 DateValue[] 数组形态,单选语义收敛为 [date] | []\nconst rootValue = computed<DateValue[]>(() => (selected.value ? [selected.value] : []));\n\nconst minDate = computed(() => parseIsoDate(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoDate(props.max ?? \"\"));\n\nfunction handleValueUpdate(next: DateValue[]) {\n const value = next[0] ? formatIsoDate(next[0]) : null;\n internalValue.value = value;\n emit(\"update:modelValue\", value);\n}\n</script>\n\n<template>\n <!--\n standalone 独立形态:自建 Root。:open=\"true\" 恒开——独立卡片没有输入框/触发钮\n 去打开弹层,不恒开则 Content hidden 整卡不可见。沿用已验证的 Root > Content 直渲形态\n (无 Positioner:卡片非浮层,就地渲染)。\n 外层 div 承接 attrs(Ark Root 不透传 attrs,实测 class/id 会丢);w-fit 收缩包裹卡片宽度。\n -->\n <div v-if=\"standalone\" :class=\"cn('w-fit', $attrs.class)\">\n <ArkDatePicker.Root\n :model-value=\"rootValue\"\n :open=\"true\"\n :num-of-months=\"props.numOfMonths\"\n :min-view=\"viewLock\"\n :max-view=\"viewLock\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :is-date-unavailable=\"props.isDateUnavailable\"\n :locale=\"props.locale\"\n @update:model-value=\"handleValueUpdate\"\n >\n <ArkDatePicker.Content>\n <CalendarBody\n :mode=\"props.mode\"\n :num-of-months=\"props.numOfMonths\"\n :week=\"props.week\"\n :locale=\"props.locale\"\n >\n <template v-if=\"$slots['prev-icon']\" #prev-icon><slot name=\"prev-icon\" /></template>\n <template v-if=\"$slots['next-icon']\" #next-icon><slot name=\"next-icon\" /></template>\n </CalendarBody>\n </ArkDatePicker.Content>\n </ArkDatePicker.Root>\n </div>\n\n <!-- embedded 内嵌形态:宿主 Picker 的 Root 供能,纯卡片内核 -->\n <CalendarBody\n v-else\n :mode=\"props.mode\"\n :num-of-months=\"props.numOfMonths\"\n :week=\"props.week\"\n :locale=\"props.locale\"\n >\n <template v-if=\"$slots['prev-icon']\" #prev-icon><slot name=\"prev-icon\" /></template>\n <template v-if=\"$slots['next-icon']\" #next-icon><slot name=\"next-icon\" /></template>\n </CalendarBody>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "calendar/CalendarBody.vue",
18
18
  "type": "registry:component",
19
19
  "target": "components/ui/calendar/CalendarBody.vue",
20
- "content": "<script setup lang=\"ts\">\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { computed } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { isSameWeek } from \"../date-shared/shared\";\nimport CalendarNav from \"./CalendarNav.vue\";\n\nconst props = withDefaults(\n defineProps<{\n /** 渲染裁剪:渲染哪个视图块;「锁定视图」由 picker Root 的 minView/maxView 承担(卡片不持 Root) */\n mode?: \"day\" | \"month\" | \"year\";\n /** 日视图并排月数 */\n numOfMonths?: number;\n /** 周选择形态:日视图下与选中值同周的格子全部 data-selected(整周高亮,周起点随 locale) */\n week?: boolean;\n /** 周起点 locale(week 形态下生效) */\n locale?: string;\n }>(),\n { mode: \"day\", numOfMonths: 1, week: false, locale: \"zh-CN\" },\n);\n\n// —— 卡片视觉常量(打磨单点:视觉调整只改本文件)——\nconst cardCls = computed(() => [props.numOfMonths > 1 ? \"w-[40rem]\" : \"w-80\", \"p-4\"]);\n// 导航条(ViewControl/Prev/Next/ViewTrigger)样式常量已迁 calendar/CalendarNav.vue\n// 日视图双层格子(naive 式「命中大、视觉小」):\n// trigger = 全格命中区 + range 无缝条带层(primary/10;行首行尾圆角由模板按列位补)\n// + week 整周条带层(data-week-selected:实心 primary 无缝整行,行首行尾圆角同上)\n// + week hover 预览(行挂 group/week-row,任意格 hover 时同周全行亮 primary/10 浅条带;\n// 非 week 形态无 group/week-row 宿主,变体永不命中,零副作用)\n// dot = 24px 视觉圆点层,hover/选中/今天/禁用色全落此层(经 group-* 读取 trigger 状态)\n// outside-view = Card 自标「格不属于本表锚点月」,range/选中视觉在补位格上失效,\n// 且补位格不可点击(naive excluded 语义:仅作日期连续性视觉提示;\n// week 条带上补位格降为 40% 透明,保留整行连续性)\nconst dayTriggerCls =\n \"group relative flex h-8 w-full cursor-pointer items-center justify-center outline-none data-[outside-view]:pointer-events-none data-[disabled]:pointer-events-none data-[in-range]:not-data-[outside-view]:not-data-[range-start]:not-data-[range-end]:bg-primary/10 data-[range-start]:rounded-l-[3px] data-[range-end]:rounded-r-[3px] data-[week-selected]:bg-primary data-[week-selected]:data-[outside-view]:bg-primary/40 data-[week-selected]:hover:data-[outside-view]:bg-primary/40 group-hover/week-row:not-data-[week-selected]:not-data-[outside-view]:bg-primary/10 group-hover/week-row:data-[outside-view]:not-data-[week-selected]:bg-primary/5\";\nconst dayDotCls =\n \"flex size-6 items-center justify-center rounded-[3px] text-sm transition-colors group-hover:not-group-data-[week-selected]:bg-accent group-data-[focus]:not-group-data-[outside-view]:not-group-data-[week-selected]:bg-accent group-data-[selected]:not-group-data-[week-selected]:not-group-data-[outside-view]:bg-primary group-data-[selected]:not-group-data-[week-selected]:not-group-data-[outside-view]:font-medium group-data-[selected]:not-group-data-[week-selected]:not-group-data-[outside-view]:text-primary-foreground group-data-[week-selected]:bg-transparent group-data-[week-selected]:font-medium group-data-[week-selected]:text-primary-foreground group-data-[week-selected]:hover:bg-white/20 group-data-[today]:not-group-data-[selected]:text-primary group-data-[today]:not-group-data-[selected]:font-semibold group-data-[unavailable]:line-through group-data-[unavailable]:opacity-30 group-data-[disabled]:opacity-40 group-data-[outside-view]:opacity-30\";\n// 月/年视图单层格子(沿用小圆角语言;range 变体单选无副作用,此处不涉及)\nconst cellCls =\n \"flex h-9 w-full items-center justify-center rounded-[3px] text-sm outline-none hover:bg-accent data-[selected]:bg-primary data-[selected]:font-medium data-[selected]:text-primary-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-40\";\n// table-fixed:7 列日视图 / 4 列月年视图均分列宽,表头与内容同走原生 table 布局\nconst tableCls = \"w-full min-w-0 flex-1 table-fixed border-collapse\";\nconst headCellCls =\n \"text-muted-foreground h-8 border-x-0! border-t-0! border-b border-border p-0! text-center! text-xs! align-middle font-normal whitespace-nowrap\";\nconst bodyCellCls = \"border-0! p-0! text-center\";\n// 宿主斑马线防御:VitePress .vp-doc tr:nth-child(2n) 背景污染(与 range 条带浅色撞车)\nconst rowCls = \"bg-transparent!\";\n\n// —— 补位格自标记( zag data-outside-range 是「整机可见范围」语义,双月时相邻月表内\n// 的上月尾/下月头格不带它,range/选中视觉会跨表重复高亮;Card 按锚点月自行判定)——\ntype TableCtx = {\n getOffset(duration: { months: number }): { visibleRange: { start: DateValue } };\n};\n\n/** 表 i 的锚点月起点(zag getOffset({months: i-1}).visibleRange.start) */\nfunction tableAnchor(context: TableCtx, i: number): DateValue | undefined {\n return context.getOffset({ months: i - 1 })?.visibleRange?.start;\n}\n\n/** 格子日期不属于锚点月(年或月不一致)即为补位格 */\nfunction isOutsideView(day: DateValue, anchor: DateValue | undefined): boolean {\n return !!anchor && (day.year !== anchor.year || day.month !== anchor.month);\n}\n\n/**\n * 周形态整周高亮:day 与选中值同周 → 补 data-selected(语义标记,供 zag 状态/测试判定)\n * 与 data-week-selected(视觉标记,驱动 trigger 整行条带与 dot 层反色变体);\n * 非 week 形态返回空对象,完全不下发属性,选中视觉交回 zag 原生绑定,避免 fallthrough 覆盖。\n * 走显式函数而非模板内联,避免与日视图 v-for 的 `week` 循环变量同名遮蔽。\n */\nfunction weekSelectedAttrs(\n day: DateValue,\n selected: DateValue[] | undefined,\n): Record<string, string> {\n return weekSelected(day, selected) ? { \"data-selected\": \"\", \"data-week-selected\": \"\" } : {};\n}\n\nfunction weekSelected(day: DateValue, selected: DateValue[] | undefined): boolean {\n return !!props.week && !!selected?.[0] && isSameWeek(day, selected[0], props.locale);\n}\n</script>\n\n<template>\n <div :class=\"cn(cardCls)\">\n <template v-if=\"mode === 'day'\">\n <ArkDatePicker.View :view=\"'day'\">\n <!-- day 视图导航条在 View 内:viewProps=day → GOTO.NEXT=focusNextPage(翻月) -->\n <CalendarNav view=\"day\" />\n <ArkDatePicker.Context v-slot=\"context\">\n <div class=\"flex gap-6\">\n <ArkDatePicker.Table v-for=\"i in numOfMonths\" :key=\"i\" :class=\"tableCls\">\n <ArkDatePicker.TableHead>\n <ArkDatePicker.TableRow :class=\"rowCls\">\n <ArkDatePicker.TableHeader\n v-for=\"(weekDay, id) in context.weekDays\"\n :key=\"id\"\n :class=\"headCellCls\"\n >\n {{ weekDay.narrow }}\n </ArkDatePicker.TableHeader>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableHead>\n <ArkDatePicker.TableBody>\n <ArkDatePicker.TableRow\n :class=\"cn(rowCls, props.week && 'group/week-row')\"\n v-for=\"(week, id) in context.getOffset({ months: i - 1 }).weeks\"\n :key=\"id\"\n >\n <ArkDatePicker.TableCell\n v-for=\"(day, colIdx) in week\"\n :key=\"day.toString()\"\n :value=\"day\"\n :class=\"bodyCellCls\"\n >\n <ArkDatePicker.TableCellTrigger\n :class=\"\n cn(\n dayTriggerCls,\n colIdx === 0 && 'rounded-l-[3px]',\n colIdx === week.length - 1 && 'rounded-r-[3px]',\n )\n \"\n :data-outside-view=\"\n isOutsideView(day, tableAnchor(context, i)) ? '' : undefined\n \"\n v-bind=\"weekSelectedAttrs(day, context.value)\"\n >\n <span :class=\"dayDotCls\">{{ day.day }}</span>\n </ArkDatePicker.TableCellTrigger>\n </ArkDatePicker.TableCell>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableBody>\n </ArkDatePicker.Table>\n </div>\n </ArkDatePicker.Context>\n </ArkDatePicker.View>\n\n <ArkDatePicker.View :view=\"'month'\">\n <!-- 切换视图导航条也在 View 内:DatePicker 切月视图后 GOTO.NEXT=focusNextYear(修复 backlog) -->\n <CalendarNav view=\"month\" />\n <ArkDatePicker.Context v-slot=\"context\">\n <ArkDatePicker.Table :class=\"tableCls\">\n <ArkDatePicker.TableBody>\n <ArkDatePicker.TableRow\n :class=\"rowCls\"\n v-for=\"(monthsRow, id) in context.getMonthsGrid({ columns: 4, format: 'short' })\"\n :key=\"id\"\n >\n <ArkDatePicker.TableCell\n v-for=\"month in monthsRow\"\n :key=\"month.value.toString()\"\n :value=\"month.value\"\n :class=\"bodyCellCls\"\n >\n <ArkDatePicker.TableCellTrigger :class=\"cn(cellCls)\">\n {{ month.label }}\n </ArkDatePicker.TableCellTrigger>\n </ArkDatePicker.TableCell>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableBody>\n </ArkDatePicker.Table>\n </ArkDatePicker.Context>\n </ArkDatePicker.View>\n\n <ArkDatePicker.View :view=\"'year'\">\n <CalendarNav view=\"year\" />\n <ArkDatePicker.Context v-slot=\"context\">\n <ArkDatePicker.Table :class=\"tableCls\">\n <ArkDatePicker.TableBody>\n <ArkDatePicker.TableRow\n :class=\"rowCls\"\n v-for=\"(yearsRow, id) in context.getYearsGrid({ columns: 4 })\"\n :key=\"id\"\n >\n <ArkDatePicker.TableCell\n v-for=\"year in yearsRow\"\n :key=\"year.value.toString()\"\n :value=\"year.value\"\n :class=\"bodyCellCls\"\n >\n <ArkDatePicker.TableCellTrigger :class=\"cn(cellCls)\">\n {{ year.label }}\n </ArkDatePicker.TableCellTrigger>\n </ArkDatePicker.TableCell>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableBody>\n </ArkDatePicker.Table>\n </ArkDatePicker.Context>\n </ArkDatePicker.View>\n </template>\n\n <ArkDatePicker.View v-else-if=\"mode === 'month'\" :view=\"'month'\">\n <!-- 导航条必须在 View 子树内:Prev/NextTrigger 才能拿到 view=\"month\"(GOTO.NEXT=focusNextYear) -->\n <CalendarNav view=\"month\" />\n <ArkDatePicker.Context v-slot=\"context\">\n <ArkDatePicker.Table :class=\"tableCls\">\n <ArkDatePicker.TableBody>\n <ArkDatePicker.TableRow\n :class=\"rowCls\"\n v-for=\"(monthsRow, id) in context.getMonthsGrid({ columns: 4, format: 'short' })\"\n :key=\"id\"\n >\n <ArkDatePicker.TableCell\n v-for=\"month in monthsRow\"\n :key=\"month.value.toString()\"\n :value=\"month.value\"\n :class=\"bodyCellCls\"\n >\n <ArkDatePicker.TableCellTrigger :class=\"cn(cellCls)\">\n {{ month.label }}\n </ArkDatePicker.TableCellTrigger>\n </ArkDatePicker.TableCell>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableBody>\n </ArkDatePicker.Table>\n </ArkDatePicker.Context>\n </ArkDatePicker.View>\n\n <ArkDatePicker.View v-else :view=\"'year'\">\n <!-- 导航条必须在 View 子树内:Prev/NextTrigger 才能拿到 view=\"year\"(GOTO.NEXT=focusNextDecade) -->\n <CalendarNav view=\"year\" />\n <ArkDatePicker.Context v-slot=\"context\">\n <ArkDatePicker.Table :class=\"tableCls\">\n <ArkDatePicker.TableBody>\n <ArkDatePicker.TableRow\n :class=\"rowCls\"\n v-for=\"(yearsRow, id) in context.getYearsGrid({ columns: 4 })\"\n :key=\"id\"\n >\n <ArkDatePicker.TableCell\n v-for=\"year in yearsRow\"\n :key=\"year.value.toString()\"\n :value=\"year.value\"\n :class=\"bodyCellCls\"\n >\n <ArkDatePicker.TableCellTrigger :class=\"cn(cellCls)\">\n {{ year.label }}\n </ArkDatePicker.TableCellTrigger>\n </ArkDatePicker.TableCell>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableBody>\n </ArkDatePicker.Table>\n </ArkDatePicker.Context>\n </ArkDatePicker.View>\n </div>\n</template>\n"
20
+ "content": "<script setup lang=\"ts\">\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { computed } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { isSameWeek } from \"../date-shared/shared\";\nimport CalendarNav from \"./CalendarNav.vue\";\n\nconst props = withDefaults(\n defineProps<{\n /** 渲染裁剪:渲染哪个视图块;「锁定视图」由 picker Root 的 minView/maxView 承担(卡片不持 Root) */\n mode?: \"day\" | \"month\" | \"year\";\n /** 日视图并排月数 */\n numOfMonths?: number;\n /** 周选择形态:日视图下与选中值同周的格子全部 data-selected(整周高亮,周起点随 locale) */\n week?: boolean;\n /** 周起点 locale(week 形态下生效) */\n locale?: string;\n }>(),\n { mode: \"day\", numOfMonths: 1, week: false, locale: \"zh-CN\" },\n);\n\n// —— 卡片视觉常量(打磨单点:视觉调整只改本文件)——\nconst cardCls = computed(() => [props.numOfMonths > 1 ? \"w-[40rem]\" : \"w-80\", \"p-4\"]);\n// 导航条(ViewControl/Prev/Next/ViewTrigger)样式常量已迁 calendar/CalendarNav.vue\n// 日视图双层格子(naive 式「命中大、视觉小」):\n// trigger = 全格命中区 + range 无缝条带层(primary/10;行首行尾圆角由模板按列位补)\n// + week 整周条带层(data-week-selected:实心 primary 无缝整行,行首行尾圆角同上)\n// + week hover 预览(行挂 group/week-row,任意格 hover 时同周全行亮 primary/10 浅条带;\n// 非 week 形态无 group/week-row 宿主,变体永不命中,零副作用)\n// dot = 24px 视觉圆点层,hover/选中/今天/禁用色全落此层(经 group-* 读取 trigger 状态)\n// outside-view = Card 自标「格不属于本表锚点月」,range/选中视觉在补位格上失效,\n// 且补位格不可点击(naive excluded 语义:仅作日期连续性视觉提示;\n// week 条带上补位格降为 40% 透明,保留整行连续性)\nconst dayTriggerCls =\n \"group relative flex h-8 w-full cursor-pointer items-center justify-center outline-none data-[outside-view]:pointer-events-none data-[disabled]:pointer-events-none data-[in-range]:not-data-[outside-view]:not-data-[range-start]:not-data-[range-end]:bg-primary/10 data-[range-start]:rounded-l-[3px] data-[range-end]:rounded-r-[3px] data-[week-selected]:bg-primary data-[week-selected]:data-[outside-view]:bg-primary/40 data-[week-selected]:hover:data-[outside-view]:bg-primary/40 group-hover/week-row:not-data-[week-selected]:not-data-[outside-view]:bg-primary/10 group-hover/week-row:data-[outside-view]:not-data-[week-selected]:bg-primary/5\";\nconst dayDotCls =\n \"flex size-6 items-center justify-center rounded-[3px] text-sm transition-colors group-hover:not-group-data-[week-selected]:bg-accent group-data-[focus]:not-group-data-[outside-view]:not-group-data-[week-selected]:bg-accent group-data-[selected]:not-group-data-[week-selected]:not-group-data-[outside-view]:bg-primary group-data-[selected]:not-group-data-[week-selected]:not-group-data-[outside-view]:font-medium group-data-[selected]:not-group-data-[week-selected]:not-group-data-[outside-view]:text-primary-foreground group-data-[week-selected]:bg-transparent group-data-[week-selected]:font-medium group-data-[week-selected]:text-primary-foreground group-data-[week-selected]:hover:bg-white/20 group-data-[today]:not-group-data-[selected]:text-primary group-data-[today]:not-group-data-[selected]:font-semibold group-data-[unavailable]:line-through group-data-[unavailable]:opacity-30 group-data-[disabled]:opacity-40 group-data-[outside-view]:opacity-30\";\n// 月/年视图单层格子(沿用小圆角语言;range 变体单选无副作用,此处不涉及)\nconst cellCls =\n \"flex h-9 w-full items-center justify-center rounded-[3px] text-sm outline-none hover:bg-accent data-[selected]:bg-primary data-[selected]:font-medium data-[selected]:text-primary-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-40\";\n// table-fixed:7 列日视图 / 4 列月年视图均分列宽,表头与内容同走原生 table 布局\nconst tableCls = \"w-full min-w-0 flex-1 table-fixed border-collapse\";\nconst headCellCls =\n \"text-muted-foreground h-8 border-x-0! border-t-0! border-b border-border p-0! text-center! text-xs! align-middle font-normal whitespace-nowrap\";\nconst bodyCellCls = \"border-0! p-0! text-center\";\n// 宿主斑马线防御:VitePress .vp-doc tr:nth-child(2n) 背景污染(与 range 条带浅色撞车)\nconst rowCls = \"bg-transparent!\";\n\n// —— 补位格自标记( zag data-outside-range 是「整机可见范围」语义,双月时相邻月表内\n// 的上月尾/下月头格不带它,range/选中视觉会跨表重复高亮;Card 按锚点月自行判定)——\ntype TableCtx = {\n getOffset(duration: { months: number }): { visibleRange: { start: DateValue } };\n};\n\n/** 表 i 的锚点月起点(zag getOffset({months: i-1}).visibleRange.start) */\nfunction tableAnchor(context: TableCtx, i: number): DateValue | undefined {\n return context.getOffset({ months: i - 1 })?.visibleRange?.start;\n}\n\n/** 格子日期不属于锚点月(年或月不一致)即为补位格 */\nfunction isOutsideView(day: DateValue, anchor: DateValue | undefined): boolean {\n return !!anchor && (day.year !== anchor.year || day.month !== anchor.month);\n}\n\n/**\n * 周形态整周高亮:day 与选中值同周 → 补 data-selected(语义标记,供 zag 状态/测试判定)\n * 与 data-week-selected(视觉标记,驱动 trigger 整行条带与 dot 层反色变体);\n * 非 week 形态返回空对象,完全不下发属性,选中视觉交回 zag 原生绑定,避免 fallthrough 覆盖。\n * 走显式函数而非模板内联,避免与日视图 v-for 的 `week` 循环变量同名遮蔽。\n */\nfunction weekSelectedAttrs(\n day: DateValue,\n selected: DateValue[] | undefined,\n): Record<string, string> {\n return weekSelected(day, selected) ? { \"data-selected\": \"\", \"data-week-selected\": \"\" } : {};\n}\n\nfunction weekSelected(day: DateValue, selected: DateValue[] | undefined): boolean {\n return !!props.week && !!selected?.[0] && isSameWeek(day, selected[0], props.locale);\n}\n</script>\n\n<template>\n <div :class=\"cn(cardCls)\">\n <template v-if=\"mode === 'day'\">\n <ArkDatePicker.View :view=\"'day'\">\n <!-- day 视图导航条在 View 内:viewProps=day → GOTO.NEXT=focusNextPage(翻月) -->\n <CalendarNav view=\"day\">\n <template v-if=\"$slots['prev-icon']\" #prev-icon><slot name=\"prev-icon\" /></template>\n <template v-if=\"$slots['next-icon']\" #next-icon><slot name=\"next-icon\" /></template>\n </CalendarNav>\n <ArkDatePicker.Context v-slot=\"context\">\n <div class=\"flex gap-6\">\n <ArkDatePicker.Table v-for=\"i in numOfMonths\" :key=\"i\" :class=\"tableCls\">\n <ArkDatePicker.TableHead>\n <ArkDatePicker.TableRow :class=\"rowCls\">\n <ArkDatePicker.TableHeader\n v-for=\"(weekDay, id) in context.weekDays\"\n :key=\"id\"\n :class=\"headCellCls\"\n >\n {{ weekDay.narrow }}\n </ArkDatePicker.TableHeader>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableHead>\n <ArkDatePicker.TableBody>\n <ArkDatePicker.TableRow\n :class=\"cn(rowCls, props.week && 'group/week-row')\"\n v-for=\"(week, id) in context.getOffset({ months: i - 1 }).weeks\"\n :key=\"id\"\n >\n <ArkDatePicker.TableCell\n v-for=\"(day, colIdx) in week\"\n :key=\"day.toString()\"\n :value=\"day\"\n :class=\"bodyCellCls\"\n >\n <ArkDatePicker.TableCellTrigger\n :class=\"\n cn(\n dayTriggerCls,\n colIdx === 0 && 'rounded-l-[3px]',\n colIdx === week.length - 1 && 'rounded-r-[3px]',\n )\n \"\n :data-outside-view=\"\n isOutsideView(day, tableAnchor(context, i)) ? '' : undefined\n \"\n v-bind=\"weekSelectedAttrs(day, context.value)\"\n >\n <span :class=\"dayDotCls\">{{ day.day }}</span>\n </ArkDatePicker.TableCellTrigger>\n </ArkDatePicker.TableCell>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableBody>\n </ArkDatePicker.Table>\n </div>\n </ArkDatePicker.Context>\n </ArkDatePicker.View>\n\n <ArkDatePicker.View :view=\"'month'\">\n <!-- 切换视图导航条也在 View 内:DatePicker 切月视图后 GOTO.NEXT=focusNextYear(修复 backlog) -->\n <CalendarNav view=\"month\">\n <template v-if=\"$slots['prev-icon']\" #prev-icon><slot name=\"prev-icon\" /></template>\n <template v-if=\"$slots['next-icon']\" #next-icon><slot name=\"next-icon\" /></template>\n </CalendarNav>\n <ArkDatePicker.Context v-slot=\"context\">\n <ArkDatePicker.Table :class=\"tableCls\">\n <ArkDatePicker.TableBody>\n <ArkDatePicker.TableRow\n :class=\"rowCls\"\n v-for=\"(monthsRow, id) in context.getMonthsGrid({ columns: 4, format: 'short' })\"\n :key=\"id\"\n >\n <ArkDatePicker.TableCell\n v-for=\"month in monthsRow\"\n :key=\"month.value.toString()\"\n :value=\"month.value\"\n :class=\"bodyCellCls\"\n >\n <ArkDatePicker.TableCellTrigger :class=\"cn(cellCls)\">\n {{ month.label }}\n </ArkDatePicker.TableCellTrigger>\n </ArkDatePicker.TableCell>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableBody>\n </ArkDatePicker.Table>\n </ArkDatePicker.Context>\n </ArkDatePicker.View>\n\n <ArkDatePicker.View :view=\"'year'\">\n <CalendarNav view=\"year\">\n <template v-if=\"$slots['prev-icon']\" #prev-icon><slot name=\"prev-icon\" /></template>\n <template v-if=\"$slots['next-icon']\" #next-icon><slot name=\"next-icon\" /></template>\n </CalendarNav>\n <ArkDatePicker.Context v-slot=\"context\">\n <ArkDatePicker.Table :class=\"tableCls\">\n <ArkDatePicker.TableBody>\n <ArkDatePicker.TableRow\n :class=\"rowCls\"\n v-for=\"(yearsRow, id) in context.getYearsGrid({ columns: 4 })\"\n :key=\"id\"\n >\n <ArkDatePicker.TableCell\n v-for=\"year in yearsRow\"\n :key=\"year.value.toString()\"\n :value=\"year.value\"\n :class=\"bodyCellCls\"\n >\n <ArkDatePicker.TableCellTrigger :class=\"cn(cellCls)\">\n {{ year.label }}\n </ArkDatePicker.TableCellTrigger>\n </ArkDatePicker.TableCell>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableBody>\n </ArkDatePicker.Table>\n </ArkDatePicker.Context>\n </ArkDatePicker.View>\n </template>\n\n <ArkDatePicker.View v-else-if=\"mode === 'month'\" :view=\"'month'\">\n <!-- 导航条必须在 View 子树内:Prev/NextTrigger 才能拿到 view=\"month\"(GOTO.NEXT=focusNextYear) -->\n <CalendarNav view=\"month\">\n <template v-if=\"$slots['prev-icon']\" #prev-icon><slot name=\"prev-icon\" /></template>\n <template v-if=\"$slots['next-icon']\" #next-icon><slot name=\"next-icon\" /></template>\n </CalendarNav>\n <ArkDatePicker.Context v-slot=\"context\">\n <ArkDatePicker.Table :class=\"tableCls\">\n <ArkDatePicker.TableBody>\n <ArkDatePicker.TableRow\n :class=\"rowCls\"\n v-for=\"(monthsRow, id) in context.getMonthsGrid({ columns: 4, format: 'short' })\"\n :key=\"id\"\n >\n <ArkDatePicker.TableCell\n v-for=\"month in monthsRow\"\n :key=\"month.value.toString()\"\n :value=\"month.value\"\n :class=\"bodyCellCls\"\n >\n <ArkDatePicker.TableCellTrigger :class=\"cn(cellCls)\">\n {{ month.label }}\n </ArkDatePicker.TableCellTrigger>\n </ArkDatePicker.TableCell>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableBody>\n </ArkDatePicker.Table>\n </ArkDatePicker.Context>\n </ArkDatePicker.View>\n\n <ArkDatePicker.View v-else :view=\"'year'\">\n <!-- 导航条必须在 View 子树内:Prev/NextTrigger 才能拿到 view=\"year\"(GOTO.NEXT=focusNextDecade) -->\n <CalendarNav view=\"year\">\n <template v-if=\"$slots['prev-icon']\" #prev-icon><slot name=\"prev-icon\" /></template>\n <template v-if=\"$slots['next-icon']\" #next-icon><slot name=\"next-icon\" /></template>\n </CalendarNav>\n <ArkDatePicker.Context v-slot=\"context\">\n <ArkDatePicker.Table :class=\"tableCls\">\n <ArkDatePicker.TableBody>\n <ArkDatePicker.TableRow\n :class=\"rowCls\"\n v-for=\"(yearsRow, id) in context.getYearsGrid({ columns: 4 })\"\n :key=\"id\"\n >\n <ArkDatePicker.TableCell\n v-for=\"year in yearsRow\"\n :key=\"year.value.toString()\"\n :value=\"year.value\"\n :class=\"bodyCellCls\"\n >\n <ArkDatePicker.TableCellTrigger :class=\"cn(cellCls)\">\n {{ year.label }}\n </ArkDatePicker.TableCellTrigger>\n </ArkDatePicker.TableCell>\n </ArkDatePicker.TableRow>\n </ArkDatePicker.TableBody>\n </ArkDatePicker.Table>\n </ArkDatePicker.Context>\n </ArkDatePicker.View>\n </div>\n</template>\n"
21
21
  },
22
22
  {
23
23
  "path": "calendar/CalendarNav.vue",
24
24
  "type": "registry:component",
25
25
  "target": "components/ui/calendar/CalendarNav.vue",
26
- "content": "<script setup lang=\"ts\">\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { cn } from \"@/lib/utils\";\n\n/**\n * 视图导航条(内部件)。必须渲染在 <ArkDatePicker.View> 子树内:\n * Prev/NextTrigger 的 view 参数由 View provide(ViewPropsContext),\n * 放在 View 外会落到默认 { view: \"day\" },month/year 视图下\n * GOTO.NEXT 被 machine guard 的 event.view 短路成 focusNextPage(翻页月,表现为无反应)。\n */\nconst props = defineProps({\n /** 导航条服务的视图,决定中间内容形态:day=ViewTrigger(上钻)/ month=年份 / year=年代 */\n view: { type: String as PropType<\"day\" | \"month\" | \"year\">, required: true },\n});\n\nconst viewControlCls = \"flex items-center justify-between px-1 pb-3\";\nconst navBtnCls =\n \"text-muted-foreground inline-flex size-8 items-center justify-center rounded-md outline-none hover:bg-accent disabled:cursor-not-allowed disabled:opacity-40\";\nconst viewTriggerCls =\n \"hover:bg-accent inline-flex items-center gap-1 rounded-[3px] px-3 py-1.5 text-sm font-semibold text-foreground outline-none transition-colors disabled:pointer-events-none\";\nconst viewTitleCls = \"text-sm font-semibold text-foreground\";\n\n/** 年代范围文本(zag 无现成 part,由 focusedValue.year 推算):2026 → \"2020 - 2029\" */\nfunction decadeRange(year: number | undefined): string {\n const start = Math.floor((year ?? 0) / 10) * 10;\n return `${start} - ${start + 9}`;\n}\n</script>\n\n<template>\n <ArkDatePicker.ViewControl :class=\"cn(viewControlCls, $attrs.class)\">\n <ArkDatePicker.PrevTrigger :class=\"navBtnCls\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n >\n <path d=\"m15 18-6-6 6-6\" />\n </svg>\n </ArkDatePicker.PrevTrigger>\n\n <ArkDatePicker.Context v-slot=\"context\">\n <!-- day:ViewTrigger 上钻钮(内容原样自 CalendarBody 迁入,视觉零回归) -->\n <ArkDatePicker.ViewTrigger v-if=\"props.view === 'day'\" :class=\"viewTriggerCls\">\n <ArkDatePicker.RangeText />\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-3.5 opacity-50\"\n >\n <path d=\"m7 15 5 5 5-5\" />\n <path d=\"m7 9 5-5 5 5\" />\n </svg>\n </ArkDatePicker.ViewTrigger>\n <!-- month:年份标题(ViewTrigger 承载——DatePicker 可上钻 year;\n 锁定组件下 zag getNextView 无下级 → 原生 disabled,点击钳制) -->\n <ArkDatePicker.ViewTrigger v-else-if=\"props.view === 'month'\" :class=\"viewTriggerCls\">\n {{ context.focusedValue?.year }}\n </ArkDatePicker.ViewTrigger>\n <!-- year:年代范围 -->\n <span v-else :class=\"viewTitleCls\">{{ decadeRange(context.focusedValue?.year) }}</span>\n </ArkDatePicker.Context>\n\n <ArkDatePicker.NextTrigger :class=\"navBtnCls\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n >\n <path d=\"m9 18 6-6-6-6\" />\n </svg>\n </ArkDatePicker.NextTrigger>\n </ArkDatePicker.ViewControl>\n</template>\n"
26
+ "content": "<script setup lang=\"ts\">\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport ChevronIcon from \"../icon-shared/ChevronIcon.vue\";\n\n/**\n * 视图导航条(内部件)。必须渲染在 <ArkDatePicker.View> 子树内:\n * Prev/NextTrigger 的 view 参数由 View provide(ViewPropsContext),\n * 放在 View 外会落到默认 { view: \"day\" },month/year 视图下\n * GOTO.NEXT 被 machine guard 的 event.view 短路成 focusNextPage(翻页月,表现为无反应)。\n */\nconst props = defineProps({\n /** 导航条服务的视图,决定中间内容形态:day=ViewTrigger(上钻)/ month=年份 / year=年代 */\n view: { type: String as PropType<\"day\" | \"month\" | \"year\">, required: true },\n});\n\nconst viewControlCls = \"flex items-center justify-between px-1 pb-3\";\nconst navBtnCls =\n \"text-muted-foreground inline-flex size-8 items-center justify-center rounded-md outline-none hover:bg-accent disabled:cursor-not-allowed disabled:opacity-40\";\nconst viewTriggerCls =\n \"hover:bg-accent inline-flex items-center gap-1 rounded-[3px] px-3 py-1.5 text-sm font-semibold text-foreground outline-none transition-colors disabled:pointer-events-none\";\nconst viewTitleCls = \"text-sm font-semibold text-foreground\";\n\n/** 年代范围文本(zag 无现成 part,由 focusedValue.year 推算):2026 → \"2020 - 2029\" */\nfunction decadeRange(year: number | undefined): string {\n const start = Math.floor((year ?? 0) / 10) * 10;\n return `${start} - ${start + 9}`;\n}\n</script>\n\n<template>\n <ArkDatePicker.ViewControl :class=\"cn(viewControlCls, $attrs.class)\">\n <ArkDatePicker.PrevTrigger :class=\"navBtnCls\">\n <slot name=\"prev-icon\"><ChevronIcon class=\"size-4 rotate-180\" /></slot>\n </ArkDatePicker.PrevTrigger>\n\n <ArkDatePicker.Context v-slot=\"context\">\n <!-- day:ViewTrigger 上钻钮(内容原样自 CalendarBody 迁入,视觉零回归) -->\n <ArkDatePicker.ViewTrigger v-if=\"props.view === 'day'\" :class=\"viewTriggerCls\">\n <ArkDatePicker.RangeText />\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-3.5 opacity-50\"\n >\n <path d=\"m7 15 5 5 5-5\" />\n <path d=\"m7 9 5-5 5 5\" />\n </svg>\n </ArkDatePicker.ViewTrigger>\n <!-- month:年份标题(ViewTrigger 承载——DatePicker 可上钻 year;\n 锁定组件下 zag getNextView 无下级 → 原生 disabled,点击钳制) -->\n <ArkDatePicker.ViewTrigger v-else-if=\"props.view === 'month'\" :class=\"viewTriggerCls\">\n {{ context.focusedValue?.year }}\n </ArkDatePicker.ViewTrigger>\n <!-- year:年代范围 -->\n <span v-else :class=\"viewTitleCls\">{{ decadeRange(context.focusedValue?.year) }}</span>\n </ArkDatePicker.Context>\n\n <ArkDatePicker.NextTrigger :class=\"navBtnCls\">\n <slot name=\"next-icon\"><ChevronIcon class=\"size-4\" /></slot>\n </ArkDatePicker.NextTrigger>\n </ArkDatePicker.ViewControl>\n</template>\n"
27
27
  },
28
28
  {
29
29
  "path": "calendar/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "card",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "卡片容器:单组件 API,title/description 头部 + 命名插槽(cover/action/footer/header),支持尺寸、视觉变体、分段分隔与可关闭。",
7
7
  "registryDependencies": ["utils"],
@@ -1,23 +1,23 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "cascader",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "级联选择:一站式 props 驱动,多列联动、勾选级联、路径回显与多标签。",
7
- "registryDependencies": ["tree-shared", "utils", "date-shared", "overlay-shared"],
7
+ "registryDependencies": ["icon-shared", "tree-shared", "utils", "date-shared", "overlay-shared"],
8
8
  "dependencies": ["@ark-ui/vue@^5.39.2"],
9
9
  "files": [
10
10
  {
11
11
  "path": "cascader/Cascader.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/cascader/Cascader.vue",
14
- "content": "<script setup lang=\"ts\">\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, nextTick, ref, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { controlCls } from \"../date-shared/shared\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport ChevronIcon from \"../tree-shared/ChevronIcon.vue\";\nimport ClearIcon from \"../tree-shared/ClearIcon.vue\";\nimport ValueTags from \"../tree-shared/ValueTags.vue\";\nimport {\n createTreeMate,\n type CheckStrategy,\n type Key,\n type TreeNode,\n type TreeOption,\n} from \"../tree-shared\";\nimport { nextActiveKey, type MoveKey } from \"../tree-shared/keyboard\";\nimport CascaderPanel from \"./CascaderPanel.vue\";\n\nconst props = defineProps({\n /** 树形选项(key 必填,label 展示名,children 子级) */\n options: { type: Array as PropType<TreeOption[]>, required: true },\n /** 受控值:单选为叶子 key,multiple/checkable 为 key 数组;undefined 走内部非受控 */\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 /** 勾选模式(隐含 multiple,值恒为数组) */\n checkable: { type: Boolean, default: false },\n /** 级联勾选:父子联动(默认 false,对齐 naive-ui) */\n cascade: { type: Boolean, default: false },\n /** 勾选策略:all=全选节点 child=仅叶子 parent=仅父级 */\n checkStrategy: { type: String as PropType<CheckStrategy>, default: \"all\" },\n /** 下级展开触发方式 */\n expandTrigger: { type: String as PropType<\"click\" | \"hover\">, default: \"click\" },\n /** 回显是否拼接完整路径 */\n showPath: { type: Boolean, default: true },\n /** 路径拼接分隔符 */\n separator: { type: String, default: \" / \" },\n /** 展示清空按钮 */\n clearable: { 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 /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { 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}>();\n\nif (import.meta.env.DEV && getCurrentInstance()?.vnode.props?.[\"onUpdate:show\"]) {\n console.warn(\"[tu-design] <Cascader> update:show 已弃用,请改用 update:open(v-model:open)。\");\n}\n\n// attrs(id/aria-*)转发给触发器,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\nconst toArrayValue = (v: Key | Key[] | undefined): Key[] =>\n Array.isArray(v) ? v : v === undefined || v === null ? [] : [v];\n\nconst treeMate = computed(() => createTreeMate(props.options, { ignoreEmptyChildren: true }));\nconst isMulti = computed(() => props.multiple || props.checkable);\n\n// —— 受控桥接(Select 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst internalValue = ref<Key | Key[] | undefined>(props.defaultValue);\nconst value = computed(() =>\n props.modelValue !== undefined ? props.modelValue : internalValue.value,\n);\nconst selectedKeys = computed<Key[]>(() => toArrayValue(value.value));\n\nconst checkedState = computed<{ checked: Key[]; indeterminate: Key[] }>(() => {\n if (!props.checkable) return { checked: [], indeterminate: [] };\n const merged = treeMate.value.getCheckedKeys(toArrayValue(value.value), {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n return { checked: merged.checkedKeys, indeterminate: merged.indeterminateKeys };\n});\n\n// 勾选选项运行时变化:值集合按新选项归一\nwatch(\n () => [props.cascade, props.checkStrategy] as const,\n () => {\n if (!props.checkable) return;\n const merged = treeMate.value.getCheckedKeys(toArrayValue(value.value), {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n internalValue.value = merged.checkedKeys;\n emit(\"update:modelValue\", merged.checkedKeys);\n },\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\nfunction commitValue(next: Key | Key[] | undefined) {\n internalValue.value = next;\n emit(\"update:modelValue\", next);\n}\n\nfunction handleClear() {\n commitValue(isMulti.value ? [] : undefined);\n}\n\nfunction removeTag(key: Key) {\n if (props.checkable) {\n const merged = treeMate.value.uncheck(key, toArrayValue(value.value), {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n commitValue(merged.checkedKeys);\n return;\n }\n commitValue(selectedKeys.value.filter((k) => k !== key));\n}\n\n// —— 展开路径(单路径:展开新列即收敛到该节点路径)——\nconst expandedPath = ref<Key[]>([]);\nconst columns = computed<TreeNode[][]>(() => {\n const result: TreeNode[][] = [treeMate.value.treeNodes];\n let current = treeMate.value.treeNodes;\n for (const key of expandedPath.value) {\n const node = current.find((n) => n.key === key);\n if (!node?.children?.length) break;\n current = node.children;\n result.push(current);\n }\n return result;\n});\n\nconst expandedPathSet = computed(() => new Set(expandedPath.value));\n\nfunction isExpanded(node: TreeNode): boolean {\n return expandedPathSet.value.has(node.key);\n}\n\nfunction handleExpand(node: TreeNode) {\n expandedPath.value = treeMate.value.getPath(node.key).keyPath;\n}\n\nfunction toggleCheck(node: TreeNode) {\n const current = toArrayValue(value.value);\n const op = current.includes(node.key) ? \"uncheck\" : \"check\";\n const merged = treeMate.value[op](node.key, current, {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n commitValue(merged.checkedKeys);\n}\n\nfunction handleSelect(node: TreeNode) {\n // 级联语义:非叶子仅展开,叶子才选中/勾选\n if (node.children?.length) {\n handleExpand(node);\n return;\n }\n if (props.checkable) {\n toggleCheck(node);\n return;\n }\n if (props.multiple) {\n const current = selectedKeys.value;\n commitValue(\n current.includes(node.key) ? current.filter((k) => k !== node.key) : [...current, node.key],\n );\n return;\n }\n commitValue(node.key);\n setOpen(false);\n}\n\n// —— 回显:showPath 拼 keyPath 标签 ——\nfunction labelOf(node: TreeNode): string {\n return (node.rawNode as TreeOption).label ?? String(node.key);\n}\n\nfunction pathLabel(key: Key): string {\n const path = treeMate.value.getPath(key).keyPath;\n return path\n .map((k) => {\n const node = treeMate.value.getNode(k);\n return node ? labelOf(node as unknown as TreeNode) : String(k);\n })\n .join(props.separator);\n}\n\nfunction displayLabel(key: Key): string {\n const node = treeMate.value.getNode(key);\n if (!node) return \"\";\n return props.showPath ? pathLabel(key) : labelOf(node as unknown as TreeNode);\n}\n\nconst singleLabel = computed(() =>\n isMulti.value ? \"\" : displayLabel(selectedKeys.value[0]!) || \"\",\n);\n\nconst tags = computed(() =>\n selectedKeys.value\n .map((key) => ({ key, label: displayLabel(key) }))\n .filter((t) => t.label !== \"\"),\n);\n\nconst hasValue = computed(() => tags.value.length > 0);\n\n// —— 键盘导航(↑↓ 在 activeKey 所在列内移动,不跨列;←→/Enter 由下方分支处理)——\nconst activeKey = ref<Key | null>(null);\nconst MOVE_KEYS: MoveKey[] = [\"ArrowDown\", \"ArrowUp\", \"Home\", \"End\"];\n\n// activeKey 落在哪一列(无 active 或找不到时视为第 0 列)\nfunction activeColumn(): TreeNode[] {\n for (const col of columns.value) {\n if (col.some((n) => n.key === activeKey.value)) return col;\n }\n return columns.value[0] ?? [];\n}\n\nfunction scrollActiveIntoView() {\n nextTick(() => {\n document\n .querySelector('[data-part=\"cascader-panel\"] [data-part=\"tree-node\"][data-active]')\n ?.scrollIntoView?.({ block: \"nearest\" });\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(activeColumn(), activeKey.value, e.key as MoveKey);\n scrollActiveIntoView();\n return;\n }\n if (e.key === \"ArrowRight\") {\n e.preventDefault();\n const node = activeColumn().find((n) => n.key === activeKey.value);\n if (node?.children?.length) {\n handleExpand(node);\n const firstChild = node.children.find((c) => !c.disabled);\n if (firstChild) activeKey.value = firstChild.key;\n }\n return;\n }\n if (e.key === \"ArrowLeft\") {\n e.preventDefault();\n const node = activeColumn().find((n) => n.key === activeKey.value);\n const parent = node?.parent;\n if (parent && !parent.ignored) {\n expandedPath.value = treeMate.value.getPath(parent.key).keyPath.slice(0, -1);\n activeKey.value = parent.key;\n }\n return;\n }\n if (e.key === \"Enter\") {\n e.preventDefault();\n const node = activeColumn().find((n) => n.key === activeKey.value);\n if (node && !node.disabled) handleSelect(node);\n }\n}\n\n// 弹层开合时重置键盘游标与展开路径\nwatch(isOpen, (open) => {\n activeKey.value = null;\n if (open) syncPanelWidth();\n else expandedPath.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 <span v-if=\"!tags.length\" class=\"truncate text-muted-foreground\">{{\n props.placeholder\n }}</span>\n </template>\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 <span class=\"ml-auto flex shrink-0 items-center gap-1\">\n <span\n v-if=\"props.clearable && hasValue && !props.disabled\"\n role=\"button\"\n data-part=\"clear\"\n class=\"text-muted-foreground hover:text-foreground\"\n aria-label=\"清空\"\n @click.stop=\"handleClear\"\n >\n <ClearIcon />\n </span>\n <ChevronIcon\n :class=\"\n cn('text-muted-foreground transition-transform', isOpen ? '-rotate-90' : 'rotate-90')\n \"\n />\n </span>\n </div>\n </ArkPopover.Anchor>\n <Teleport to=\"body\">\n <ArkPopover.Positioner>\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 <CascaderPanel\n :columns=\"columns\"\n :expand-trigger=\"props.expandTrigger\"\n :selected-keys=\"isMulti ? selectedKeys : []\"\n :checkable=\"props.checkable\"\n :checked-keys=\"checkedState.checked\"\n :indeterminate-keys=\"checkedState.indeterminate\"\n :active-key=\"activeKey\"\n :is-expanded=\"isExpanded\"\n @expand=\"handleExpand\"\n @select=\"handleSelect\"\n @check=\"toggleCheck\"\n />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </Teleport>\n </ArkPopover.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, nextTick, ref, watch } from \"vue\";\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 {\n createTreeMate,\n type CheckStrategy,\n type Key,\n type TreeNode,\n type TreeOption,\n} from \"../tree-shared\";\nimport { nextActiveKey, type MoveKey } from \"../tree-shared/keyboard\";\nimport CascaderPanel from \"./CascaderPanel.vue\";\n\nconst props = defineProps({\n /** 树形选项(key 必填,label 展示名,children 子级) */\n options: { type: Array as PropType<TreeOption[]>, required: true },\n /** 受控值:单选为叶子 key,multiple/checkable 为 key 数组;undefined 走内部非受控 */\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 /** 勾选模式(隐含 multiple,值恒为数组) */\n checkable: { type: Boolean, default: false },\n /** 级联勾选:父子联动(默认 false,对齐 naive-ui) */\n cascade: { type: Boolean, default: false },\n /** 勾选策略:all=全选节点 child=仅叶子 parent=仅父级 */\n checkStrategy: { type: String as PropType<CheckStrategy>, default: \"all\" },\n /** 下级展开触发方式 */\n expandTrigger: { type: String as PropType<\"click\" | \"hover\">, default: \"click\" },\n /** 回显是否拼接完整路径 */\n showPath: { type: Boolean, default: true },\n /** 路径拼接分隔符 */\n separator: { type: String, default: \" / \" },\n /** 展示清空按钮 */\n clearable: { 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 /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { 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}>();\n\nif (import.meta.env.DEV && getCurrentInstance()?.vnode.props?.[\"onUpdate:show\"]) {\n console.warn(\"[tu-design] <Cascader> update:show 已弃用,请改用 update:open(v-model:open)。\");\n}\n\n// attrs(id/aria-*)转发给触发器,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\nconst toArrayValue = (v: Key | Key[] | undefined): Key[] =>\n Array.isArray(v) ? v : v === undefined || v === null ? [] : [v];\n\nconst treeMate = computed(() => createTreeMate(props.options, { ignoreEmptyChildren: true }));\nconst isMulti = computed(() => props.multiple || props.checkable);\n\n// —— 受控桥接(Select 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst internalValue = ref<Key | Key[] | undefined>(props.defaultValue);\nconst value = computed(() =>\n props.modelValue !== undefined ? props.modelValue : internalValue.value,\n);\nconst selectedKeys = computed<Key[]>(() => toArrayValue(value.value));\n\nconst checkedState = computed<{ checked: Key[]; indeterminate: Key[] }>(() => {\n if (!props.checkable) return { checked: [], indeterminate: [] };\n const merged = treeMate.value.getCheckedKeys(toArrayValue(value.value), {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n return { checked: merged.checkedKeys, indeterminate: merged.indeterminateKeys };\n});\n\n// 勾选选项运行时变化:值集合按新选项归一\nwatch(\n () => [props.cascade, props.checkStrategy] as const,\n () => {\n if (!props.checkable) return;\n const merged = treeMate.value.getCheckedKeys(toArrayValue(value.value), {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n internalValue.value = merged.checkedKeys;\n emit(\"update:modelValue\", merged.checkedKeys);\n },\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\nfunction commitValue(next: Key | Key[] | undefined) {\n internalValue.value = next;\n emit(\"update:modelValue\", next);\n}\n\nfunction handleClear() {\n commitValue(isMulti.value ? [] : undefined);\n}\n\nfunction removeTag(key: Key) {\n if (props.checkable) {\n const merged = treeMate.value.uncheck(key, toArrayValue(value.value), {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n commitValue(merged.checkedKeys);\n return;\n }\n commitValue(selectedKeys.value.filter((k) => k !== key));\n}\n\n// —— 展开路径(单路径:展开新列即收敛到该节点路径)——\nconst expandedPath = ref<Key[]>([]);\nconst columns = computed<TreeNode[][]>(() => {\n const result: TreeNode[][] = [treeMate.value.treeNodes];\n let current = treeMate.value.treeNodes;\n for (const key of expandedPath.value) {\n const node = current.find((n) => n.key === key);\n if (!node?.children?.length) break;\n current = node.children;\n result.push(current);\n }\n return result;\n});\n\nconst expandedPathSet = computed(() => new Set(expandedPath.value));\n\nfunction isExpanded(node: TreeNode): boolean {\n return expandedPathSet.value.has(node.key);\n}\n\nfunction handleExpand(node: TreeNode) {\n expandedPath.value = treeMate.value.getPath(node.key).keyPath;\n}\n\nfunction toggleCheck(node: TreeNode) {\n const current = toArrayValue(value.value);\n const op = current.includes(node.key) ? \"uncheck\" : \"check\";\n const merged = treeMate.value[op](node.key, current, {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n commitValue(merged.checkedKeys);\n}\n\nfunction handleSelect(node: TreeNode) {\n // 级联语义:非叶子仅展开,叶子才选中/勾选\n if (node.children?.length) {\n handleExpand(node);\n return;\n }\n if (props.checkable) {\n toggleCheck(node);\n return;\n }\n if (props.multiple) {\n const current = selectedKeys.value;\n commitValue(\n current.includes(node.key) ? current.filter((k) => k !== node.key) : [...current, node.key],\n );\n return;\n }\n commitValue(node.key);\n setOpen(false);\n}\n\n// —— 回显:showPath 拼 keyPath 标签 ——\nfunction labelOf(node: TreeNode): string {\n return (node.rawNode as TreeOption).label ?? String(node.key);\n}\n\nfunction pathLabel(key: Key): string {\n const path = treeMate.value.getPath(key).keyPath;\n return path\n .map((k) => {\n const node = treeMate.value.getNode(k);\n return node ? labelOf(node as unknown as TreeNode) : String(k);\n })\n .join(props.separator);\n}\n\nfunction displayLabel(key: Key): string {\n const node = treeMate.value.getNode(key);\n if (!node) return \"\";\n return props.showPath ? pathLabel(key) : labelOf(node as unknown as TreeNode);\n}\n\nconst singleLabel = computed(() =>\n isMulti.value ? \"\" : displayLabel(selectedKeys.value[0]!) || \"\",\n);\n\nconst tags = computed(() =>\n selectedKeys.value\n .map((key) => ({ key, label: displayLabel(key) }))\n .filter((t) => t.label !== \"\"),\n);\n\nconst hasValue = computed(() => tags.value.length > 0);\n\n// —— 键盘导航(↑↓ 在 activeKey 所在列内移动,不跨列;←→/Enter 由下方分支处理)——\nconst activeKey = ref<Key | null>(null);\nconst MOVE_KEYS: MoveKey[] = [\"ArrowDown\", \"ArrowUp\", \"Home\", \"End\"];\n\n// activeKey 落在哪一列(无 active 或找不到时视为第 0 列)\nfunction activeColumn(): TreeNode[] {\n for (const col of columns.value) {\n if (col.some((n) => n.key === activeKey.value)) return col;\n }\n return columns.value[0] ?? [];\n}\n\nfunction scrollActiveIntoView() {\n nextTick(() => {\n document\n .querySelector('[data-part=\"cascader-panel\"] [data-part=\"tree-node\"][data-active]')\n ?.scrollIntoView?.({ block: \"nearest\" });\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(activeColumn(), activeKey.value, e.key as MoveKey);\n scrollActiveIntoView();\n return;\n }\n if (e.key === \"ArrowRight\") {\n e.preventDefault();\n const node = activeColumn().find((n) => n.key === activeKey.value);\n if (node?.children?.length) {\n handleExpand(node);\n const firstChild = node.children.find((c) => !c.disabled);\n if (firstChild) activeKey.value = firstChild.key;\n }\n return;\n }\n if (e.key === \"ArrowLeft\") {\n e.preventDefault();\n const node = activeColumn().find((n) => n.key === activeKey.value);\n const parent = node?.parent;\n if (parent && !parent.ignored) {\n expandedPath.value = treeMate.value.getPath(parent.key).keyPath.slice(0, -1);\n activeKey.value = parent.key;\n }\n return;\n }\n if (e.key === \"Enter\") {\n e.preventDefault();\n const node = activeColumn().find((n) => n.key === activeKey.value);\n if (node && !node.disabled) handleSelect(node);\n }\n}\n\n// 弹层开合时重置键盘游标与展开路径\nwatch(isOpen, (open) => {\n activeKey.value = null;\n if (open) syncPanelWidth();\n else expandedPath.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 <span v-if=\"!tags.length\" class=\"truncate text-muted-foreground\">{{\n props.placeholder\n }}</span>\n </template>\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 <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 <Teleport to=\"body\">\n <ArkPopover.Positioner>\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 <CascaderPanel\n :columns=\"columns\"\n :expand-trigger=\"props.expandTrigger\"\n :selected-keys=\"isMulti ? selectedKeys : []\"\n :checkable=\"props.checkable\"\n :checked-keys=\"checkedState.checked\"\n :indeterminate-keys=\"checkedState.indeterminate\"\n :active-key=\"activeKey\"\n :is-expanded=\"isExpanded\"\n @expand=\"handleExpand\"\n @select=\"handleSelect\"\n @check=\"toggleCheck\"\n />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </Teleport>\n </ArkPopover.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "cascader/CascaderPanel.vue",
18
18
  "type": "registry:component",
19
19
  "target": "components/ui/cascader/CascaderPanel.vue",
20
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport ChevronIcon from \"../tree-shared/ChevronIcon.vue\";\nimport type { Key, TreeNode, TreeOption } from \"../tree-shared\";\n\nconst props = defineProps({\n /** 列数据:columns[0] 为根层,后续每列为展开路径的子层 */\n columns: { type: Array as PropType<TreeNode[][]>, required: true },\n /** 下级展开触发方式 */\n expandTrigger: { type: String as PropType<\"click\" | \"hover\">, default: \"click\" },\n /** 已选中的 key(单选叶子 / 多选勾选值) */\n selectedKeys: { type: Array as PropType<Key[]>, default: () => [] },\n /** 勾选模式(显示 checkbox) */\n checkable: { type: Boolean, default: false },\n checkedKeys: { type: Array as PropType<Key[]>, default: () => [] },\n indeterminateKeys: { type: Array as PropType<Key[]>, default: () => [] },\n /** 键盘游标所在节点 */\n activeKey: { type: [String, Number] as PropType<Key | null>, default: null },\n /** 节点是否处于展开路径上(父组件传入,用于箭头朝向) */\n isExpanded: { type: Function as PropType<(node: TreeNode) => boolean>, required: true },\n});\n\nconst emit = defineEmits<{\n /** 展开 node 的下级列 */\n expand: [node: TreeNode];\n /** 点击行(非叶子→展开,叶子→选中/勾选,语义由父组件解释) */\n select: [node: TreeNode];\n /** 勾选切换 */\n check: [node: TreeNode];\n}>();\n\nfunction labelOf(node: TreeNode): string {\n return (node.rawNode as TreeOption).label ?? String(node.key);\n}\n\n// 每个可见节点都会查选中/勾选态:先 Set 化,避免对数组逐项 includes 的 O(n·k)\nconst selectedSet = computed(() => new Set(props.selectedKeys));\nconst checkedSet = computed(() => new Set(props.checkedKeys));\nconst indeterminateSet = computed(() => new Set(props.indeterminateKeys));\n\nfunction rowClick(node: TreeNode) {\n if (node.disabled) return;\n emit(\"select\", node);\n}\n\nfunction expandHover(node: TreeNode) {\n if (props.expandTrigger === \"hover\" && node.children?.length && !node.disabled) {\n emit(\"expand\", node);\n }\n}\n\nfunction toggleCheck(node: TreeNode) {\n if (!node.disabled) emit(\"check\", node);\n}\n</script>\n\n<template>\n <div data-part=\"cascader-panel\" :class=\"cn('flex overflow-x-auto', $attrs.class)\">\n <div\n v-for=\"(column, ci) in props.columns\"\n :key=\"ci\"\n role=\"listbox\"\n data-part=\"column\"\n :aria-label=\"`第 ${ci + 1} 列`\"\n class=\"max-h-[280px] min-w-36 overflow-y-auto border-r border-border py-1 last:border-r-0\"\n >\n <div\n v-for=\"node in column\"\n :key=\"node.key\"\n data-part=\"tree-node\"\n :data-key=\"node.key\"\n role=\"option\"\n :aria-selected=\"selectedSet.has(node.key)\"\n :aria-checked=\"props.checkable ? checkedSet.has(node.key) : undefined\"\n :aria-expanded=\"node.children?.length ? props.isExpanded(node) : undefined\"\n :aria-disabled=\"node.disabled || undefined\"\n :data-selected=\"selectedSet.has(node.key) || undefined\"\n :data-checked=\"checkedSet.has(node.key) || undefined\"\n :data-indeterminate=\"indeterminateSet.has(node.key) || undefined\"\n :data-active=\"props.activeKey === node.key || undefined\"\n class=\"flex cursor-pointer items-center gap-1 px-3 py-1.5 text-sm outline-none hover:bg-accent data-[active]:bg-accent data-[disabled]:cursor-not-allowed data-[disabled]:opacity-50\"\n @click=\"rowClick(node)\"\n @pointerenter=\"expandHover(node)\"\n >\n <span\n v-if=\"props.checkable\"\n data-part=\"checkbox\"\n class=\"flex size-4 shrink-0 items-center justify-center rounded-sm border\"\n :class=\"\n checkedSet.has(node.key)\n ? 'border-primary bg-primary text-primary-foreground'\n : 'border-input'\n \"\n @click.stop=\"toggleCheck(node)\"\n >\n <svg\n v-if=\"checkedSet.has(node.key)\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n class=\"size-3\"\n >\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n <svg\n v-else-if=\"indeterminateSet.has(node.key)\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n class=\"size-3\"\n >\n <path d=\"M5 12h14\" />\n </svg>\n </span>\n <span class=\"flex-1 truncate\">{{ labelOf(node) }}</span>\n <ChevronIcon\n v-if=\"node.children?.length\"\n :class=\"\n cn('size-3.5 shrink-0 text-muted-foreground', props.isExpanded(node) && 'rotate-90')\n \"\n />\n </div>\n <div v-if=\"!column.length\" class=\"px-3 py-1.5 text-sm text-muted-foreground\">无数据</div>\n </div>\n </div>\n</template>\n"
20
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport ChevronIcon from \"../icon-shared/ChevronIcon.vue\";\nimport type { Key, TreeNode, TreeOption } from \"../tree-shared\";\n\nconst props = defineProps({\n /** 列数据:columns[0] 为根层,后续每列为展开路径的子层 */\n columns: { type: Array as PropType<TreeNode[][]>, required: true },\n /** 下级展开触发方式 */\n expandTrigger: { type: String as PropType<\"click\" | \"hover\">, default: \"click\" },\n /** 已选中的 key(单选叶子 / 多选勾选值) */\n selectedKeys: { type: Array as PropType<Key[]>, default: () => [] },\n /** 勾选模式(显示 checkbox) */\n checkable: { type: Boolean, default: false },\n checkedKeys: { type: Array as PropType<Key[]>, default: () => [] },\n indeterminateKeys: { type: Array as PropType<Key[]>, default: () => [] },\n /** 键盘游标所在节点 */\n activeKey: { type: [String, Number] as PropType<Key | null>, default: null },\n /** 节点是否处于展开路径上(父组件传入,用于箭头朝向) */\n isExpanded: { type: Function as PropType<(node: TreeNode) => boolean>, required: true },\n});\n\nconst emit = defineEmits<{\n /** 展开 node 的下级列 */\n expand: [node: TreeNode];\n /** 点击行(非叶子→展开,叶子→选中/勾选,语义由父组件解释) */\n select: [node: TreeNode];\n /** 勾选切换 */\n check: [node: TreeNode];\n}>();\n\nfunction labelOf(node: TreeNode): string {\n return (node.rawNode as TreeOption).label ?? String(node.key);\n}\n\n// 每个可见节点都会查选中/勾选态:先 Set 化,避免对数组逐项 includes 的 O(n·k)\nconst selectedSet = computed(() => new Set(props.selectedKeys));\nconst checkedSet = computed(() => new Set(props.checkedKeys));\nconst indeterminateSet = computed(() => new Set(props.indeterminateKeys));\n\nfunction rowClick(node: TreeNode) {\n if (node.disabled) return;\n emit(\"select\", node);\n}\n\nfunction expandHover(node: TreeNode) {\n if (props.expandTrigger === \"hover\" && node.children?.length && !node.disabled) {\n emit(\"expand\", node);\n }\n}\n\nfunction toggleCheck(node: TreeNode) {\n if (!node.disabled) emit(\"check\", node);\n}\n</script>\n\n<template>\n <div data-part=\"cascader-panel\" :class=\"cn('flex overflow-x-auto', $attrs.class)\">\n <div\n v-for=\"(column, ci) in props.columns\"\n :key=\"ci\"\n role=\"listbox\"\n data-part=\"column\"\n :aria-label=\"`第 ${ci + 1} 列`\"\n class=\"max-h-[280px] min-w-36 overflow-y-auto border-r border-border py-1 last:border-r-0\"\n >\n <div\n v-for=\"node in column\"\n :key=\"node.key\"\n data-part=\"tree-node\"\n :data-key=\"node.key\"\n role=\"option\"\n :aria-selected=\"selectedSet.has(node.key)\"\n :aria-checked=\"props.checkable ? checkedSet.has(node.key) : undefined\"\n :aria-expanded=\"node.children?.length ? props.isExpanded(node) : undefined\"\n :aria-disabled=\"node.disabled || undefined\"\n :data-selected=\"selectedSet.has(node.key) || undefined\"\n :data-checked=\"checkedSet.has(node.key) || undefined\"\n :data-indeterminate=\"indeterminateSet.has(node.key) || undefined\"\n :data-active=\"props.activeKey === node.key || undefined\"\n class=\"flex cursor-pointer items-center gap-1 px-3 py-1.5 text-sm outline-none hover:bg-accent data-[active]:bg-accent data-[disabled]:cursor-not-allowed data-[disabled]:opacity-50\"\n @click=\"rowClick(node)\"\n @pointerenter=\"expandHover(node)\"\n >\n <span\n v-if=\"props.checkable\"\n data-part=\"checkbox\"\n class=\"flex size-4 shrink-0 items-center justify-center rounded-sm border\"\n :class=\"\n checkedSet.has(node.key)\n ? 'border-primary bg-primary text-primary-foreground'\n : 'border-input'\n \"\n @click.stop=\"toggleCheck(node)\"\n >\n <svg\n v-if=\"checkedSet.has(node.key)\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n class=\"size-3\"\n >\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n <svg\n v-else-if=\"indeterminateSet.has(node.key)\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n class=\"size-3\"\n >\n <path d=\"M5 12h14\" />\n </svg>\n </span>\n <span class=\"flex-1 truncate\">{{ labelOf(node) }}</span>\n <ChevronIcon\n v-if=\"node.children?.length\"\n :class=\"\n cn(\n 'size-3.5 shrink-0 text-muted-foreground transition-transform',\n props.isExpanded(node) && 'rotate-90',\n )\n \"\n />\n </div>\n <div v-if=\"!column.length\" class=\"px-3 py-1.5 text-sm text-muted-foreground\">无数据</div>\n </div>\n </div>\n</template>\n"
21
21
  },
22
22
  {
23
23
  "path": "cascader/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "checkbox",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "复选框:基于 Ark UI Checkbox 原语,支持标签插槽、受控/非受控与禁用。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "context-menu",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "右键菜单:单组件模式,items 描述菜单项(与 dropdown-menu 同构,含分组/标题/分隔线,支持嵌套),默认插槽为触发元素(ContextTrigger as-child,右键唤出并定位到指针处),内置键盘导航与选中回调。",
7
7
  "registryDependencies": ["utils", "dropdown-menu"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "currency-input",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "金额输入框:内置万/元/角/分单位后缀,labelUnit 输入单位与 valueUnit 存储单位自动换算(整数分最小精度),值以 number|null 受控。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "date-picker",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "日期选择器:输入框 + 日历弹层(月/年视图切换),支持手动键入/清空/min-max 边界/不可选谓词,值以 \"yyyy-MM-dd\" 字符串受控。",
7
7
  "registryDependencies": ["utils", "date-shared", "calendar"],
@@ -1,17 +1,17 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "date-range-picker",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "日期范围选择器:双月日历弹层(月/年视图切换),点选起点与终点,值以 [\"yyyy-MM-dd\", \"yyyy-MM-dd\"] 有序元组受控,空值归一 null。",
7
- "registryDependencies": ["utils", "date-shared", "calendar", "overlay-shared"],
7
+ "registryDependencies": ["icon-shared", "utils", "date-shared", "calendar", "overlay-shared"],
8
8
  "dependencies": ["@ark-ui/vue@^5.39.2"],
9
9
  "files": [
10
10
  {
11
11
  "path": "date-range-picker/DateRangePicker.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/date-range-picker/DateRangePicker.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide, shallowRef, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport CalendarIcon from \"../date-shared/CalendarIcon.vue\";\nimport ClearIcon from \"../date-shared/ClearIcon.vue\";\nimport {\n CALENDAR_IN_PICKER,\n controlCls,\n formatIsoDate,\n iconBtnCls,\n parseIsoDate,\n parseIsoRange,\n} from \"../date-shared/shared\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\n\nconst props = defineProps({\n /** 受控值 [start, end](\"yyyy-MM-dd\",start ≤ end);undefined 走内部非受控,null 表示空 */\n modelValue: {\n type: Array as unknown as PropType<[string, string] | null | undefined>,\n default: undefined,\n },\n defaultValue: {\n type: Array as unknown as PropType<[string, string] | undefined>,\n default: undefined,\n },\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 /** 日视图并排月数 */\n numOfMonths: { type: Number, default: 2 },\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, 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// —— 受控桥接(mirror 模式)——\n// range 是两步交互:zag 受控模式下内部值读 prop,父组件回显滞后会吃掉 pending start,\n// 导致第二次点击永远变成新起点。因此恒以内部镜像(zag 原生 0–2 元素 DateValue[])为准,\n// 外部 modelValue 赋值经 watch 覆盖 mirror;对外 emit 归一为 [ISO, ISO] | null。\n// shallowRef:internalValue 恒整体替换/读取,且规避 ref 深层 unwrap 把 DateValue\n// 类联合展开成结构类型(ZonedDateTime 丢 #private)导致 vue-tsc 不再匹配 DateValue[]\nconst internalValue = shallowRef<DateValue[]>([]);\nconst rootValue = computed(() => internalValue.value);\n\nfunction normalize(next: DateValue[]): [string, string] | null {\n return next.length === 2 ? [formatIsoDate(next[0]), formatIsoDate(next[1])] : null;\n}\n\nfunction handleValueUpdate(next: DateValue[]) {\n internalValue.value = next;\n emit(\"update:modelValue\", normalize(next));\n}\n\nfunction sameTuple(a: [string, string] | null, b: [string, string] | null | undefined): boolean {\n if (a === null || b === undefined) return a === null && (b === null || b === undefined);\n return Array.isArray(b) && a[0] === b[0] && a[1] === b[1];\n}\n\nwatch(\n () => props.modelValue,\n (v) => {\n // 回环守卫:emit 值原样回流(含 pending 期父组件回传 null)则跳过,避免打断选择\n if (sameTuple(normalize(internalValue.value), v)) return;\n internalValue.value = parseIsoRange(v) ?? [];\n },\n { immediate: true },\n);\n\n// 非受控初值(modelValue 未传时以 defaultValue 种子)\nif (props.modelValue === undefined && props.defaultValue) {\n internalValue.value = parseIsoRange(props.defaultValue) ?? [];\n}\n\nconst minDate = computed(() => parseIsoDate(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoDate(props.max ?? \"\"));\n\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// 点击/键盘 ↓ 输入框即开弹层(zag 默认仅 Trigger 开,openOnClick prop 默认关闭;\n// 显式驱动保证各环境行为一致并显式走受控 emit)\nfunction openFromInput() {\n if (props.disabled || props.readOnly || isOpen.value) return;\n setOpen(true);\n}\n</script>\n\n<template>\n <!-- outside-day-selectable:zag getDayTableCellState 的 getUnitDuration 把 months 强制置 1,\n 多月视图下第二月起所有当月格被误判 outside-range 而禁用;此开关对冲(见 calendar/CalendarBody 注释) -->\n <ArkDatePicker.Root\n :model-value=\"rootValue\"\n selection-mode=\"range\"\n :num-of-months=\"props.numOfMonths\"\n outside-day-selectable\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 :format=\"formatIsoDate\"\n :parse=\"parseIsoDate\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"props.invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :index=\"0\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"text-muted-foreground size-3.5 shrink-0\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n <path d=\"m12 5 7 7-7 7\" />\n </svg>\n <ArkDatePicker.Input\n :index=\"1\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <ClearIcon />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport 到 body:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患。 -->\n <Teleport to=\"body\">\n <ArkDatePicker.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkDatePicker.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-[var(--z-overlay)] rounded-md border shadow-md',\n )\n \"\n >\n <TCalendar :num-of-months=\"props.numOfMonths\" />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide, shallowRef, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport CalendarIcon from \"../icon-shared/CalendarIcon.vue\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\nimport {\n CALENDAR_IN_PICKER,\n controlCls,\n formatIsoDate,\n iconBtnCls,\n parseIsoDate,\n parseIsoRange,\n} from \"../date-shared/shared\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\n\nconst props = defineProps({\n /** 受控值 [start, end](\"yyyy-MM-dd\",start ≤ end);undefined 走内部非受控,null 表示空 */\n modelValue: {\n type: Array as unknown as PropType<[string, string] | null | undefined>,\n default: undefined,\n },\n defaultValue: {\n type: Array as unknown as PropType<[string, string] | undefined>,\n default: undefined,\n },\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 /** 日视图并排月数 */\n numOfMonths: { type: Number, default: 2 },\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, 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// —— 受控桥接(mirror 模式)——\n// range 是两步交互:zag 受控模式下内部值读 prop,父组件回显滞后会吃掉 pending start,\n// 导致第二次点击永远变成新起点。因此恒以内部镜像(zag 原生 0–2 元素 DateValue[])为准,\n// 外部 modelValue 赋值经 watch 覆盖 mirror;对外 emit 归一为 [ISO, ISO] | null。\n// shallowRef:internalValue 恒整体替换/读取,且规避 ref 深层 unwrap 把 DateValue\n// 类联合展开成结构类型(ZonedDateTime 丢 #private)导致 vue-tsc 不再匹配 DateValue[]\nconst internalValue = shallowRef<DateValue[]>([]);\nconst rootValue = computed(() => internalValue.value);\n\nfunction normalize(next: DateValue[]): [string, string] | null {\n return next.length === 2 ? [formatIsoDate(next[0]), formatIsoDate(next[1])] : null;\n}\n\nfunction handleValueUpdate(next: DateValue[]) {\n internalValue.value = next;\n emit(\"update:modelValue\", normalize(next));\n}\n\nfunction sameTuple(a: [string, string] | null, b: [string, string] | null | undefined): boolean {\n if (a === null || b === undefined) return a === null && (b === null || b === undefined);\n return Array.isArray(b) && a[0] === b[0] && a[1] === b[1];\n}\n\nwatch(\n () => props.modelValue,\n (v) => {\n // 回环守卫:emit 值原样回流(含 pending 期父组件回传 null)则跳过,避免打断选择\n if (sameTuple(normalize(internalValue.value), v)) return;\n internalValue.value = parseIsoRange(v) ?? [];\n },\n { immediate: true },\n);\n\n// 非受控初值(modelValue 未传时以 defaultValue 种子)\nif (props.modelValue === undefined && props.defaultValue) {\n internalValue.value = parseIsoRange(props.defaultValue) ?? [];\n}\n\nconst minDate = computed(() => parseIsoDate(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoDate(props.max ?? \"\"));\n\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// 点击/键盘 ↓ 输入框即开弹层(zag 默认仅 Trigger 开,openOnClick prop 默认关闭;\n// 显式驱动保证各环境行为一致并显式走受控 emit)\nfunction openFromInput() {\n if (props.disabled || props.readOnly || isOpen.value) return;\n setOpen(true);\n}\n</script>\n\n<template>\n <!-- outside-day-selectable:zag getDayTableCellState 的 getUnitDuration 把 months 强制置 1,\n 多月视图下第二月起所有当月格被误判 outside-range 而禁用;此开关对冲(见 calendar/CalendarBody 注释) -->\n <ArkDatePicker.Root\n :model-value=\"rootValue\"\n selection-mode=\"range\"\n :num-of-months=\"props.numOfMonths\"\n outside-day-selectable\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 :format=\"formatIsoDate\"\n :parse=\"parseIsoDate\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"props.invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :index=\"0\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"text-muted-foreground size-3.5 shrink-0\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n <path d=\"m12 5 7 7-7 7\" />\n </svg>\n <ArkDatePicker.Input\n :index=\"1\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <CloseIcon class=\"size-4\" />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon class=\"size-4\" />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport 到 body:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患。 -->\n <Teleport to=\"body\">\n <ArkDatePicker.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkDatePicker.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-[var(--z-overlay)] rounded-md border shadow-md',\n )\n \"\n >\n <TCalendar :num-of-months=\"props.numOfMonths\" />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "date-range-picker/index.ts",
@@ -1,29 +1,17 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "date-shared",
4
- "version": "0.5.0",
4
+ "version": "0.5.2",
5
5
  "type": "registry:ui",
6
6
  "description": "日期家族共享模块:ISO 值域解析(日期/月/年/区间)、日历样式常量与单值选择器外壳(PickerShell/usePickerBridge)。",
7
- "registryDependencies": ["utils", "overlay-shared"],
7
+ "registryDependencies": ["icon-shared", "utils", "overlay-shared"],
8
8
  "dependencies": ["@ark-ui/vue@^5.39.2"],
9
9
  "files": [
10
- {
11
- "path": "date-shared/CalendarIcon.vue",
12
- "type": "registry:component",
13
- "target": "components/ui/date-shared/CalendarIcon.vue",
14
- "content": "<template>\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n >\n <rect width=\"18\" height=\"18\" x=\"3\" y=\"4\" rx=\"2\" />\n <path d=\"M16 2v4\" />\n <path d=\"M8 2v4\" />\n <path d=\"M3 10h18\" />\n </svg>\n</template>\n"
15
- },
16
- {
17
- "path": "date-shared/ClearIcon.vue",
18
- "type": "registry:component",
19
- "target": "components/ui/date-shared/ClearIcon.vue",
20
- "content": "<template>\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n >\n <path d=\"M18 6 6 18\" />\n <path d=\"m6 6 12 12\" />\n </svg>\n</template>\n"
21
- },
22
10
  {
23
11
  "path": "date-shared/PickerShell.vue",
24
12
  "type": "registry:component",
25
13
  "target": "components/ui/date-shared/PickerShell.vue",
26
- "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { provide } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport CalendarIcon from \"./CalendarIcon.vue\";\nimport ClearIcon from \"./ClearIcon.vue\";\nimport { CALENDAR_IN_PICKER, controlCls, iconBtnCls } from \"./shared\";\n\n/** 单值日期族(Date/Month/Year/Week)共用外壳:触发器 + 清空/日历按钮 + 弹层容器。 */\ndefineOptions({ inheritAttrs: false });\n\nconst props = defineProps({\n modelValue: { type: Array as PropType<DateValue[]>, required: true },\n open: { type: Boolean, required: true },\n locale: { type: String, default: \"zh-CN\" },\n min: { type: Object as PropType<DateValue | undefined>, default: undefined },\n max: { type: Object as PropType<DateValue | undefined>, default: undefined },\n /** 不可选日期谓词(参数为 ark 的 DateValue) */\n isDateUnavailable: {\n type: Function as PropType<(date: DateValue) => boolean>,\n default: undefined,\n },\n closeOnSelect: { type: Boolean, default: true },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n placeholder: { type: String, default: \"请选择\" },\n /** 锁定视图粒度(Month/Year 选择器);undefined 走 Ark 默认 day 视图 */\n minView: { type: String as PropType<\"day\" | \"month\" | \"year\" | undefined>, default: undefined },\n maxView: { type: String as PropType<\"day\" | \"month\" | \"year\" | undefined>, default: undefined },\n format: { type: Function as PropType<(date: DateValue) => string>, required: true },\n parse: { type: Function as PropType<(raw: string) => DateValue | undefined>, required: true },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: DateValue[]];\n \"update:open\": [open: boolean];\n}>();\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root)\nprovide(CALENDAR_IN_PICKER, true);\n\nfunction openFromInput() {\n if (props.disabled || props.readOnly || props.open) return;\n emit(\"update:open\", true);\n}\n</script>\n\n<template>\n <ArkDatePicker.Root\n :model-value=\"modelValue\"\n :open=\"open\"\n :locale=\"locale\"\n :min-view=\"minView\"\n :max-view=\"maxView\"\n :min=\"min\"\n :max=\"max\"\n :is-date-unavailable=\"isDateUnavailable\"\n :close-on-select=\"closeOnSelect\"\n :read-only=\"readOnly\"\n :disabled=\"disabled\"\n :format=\"format\"\n :parse=\"parse\"\n @update:model-value=\"emit('update:modelValue', $event)\"\n @update:open=\"emit('update:open', $event)\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :placeholder=\"placeholder\"\n :aria-invalid=\"invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <ClearIcon />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport 到 body:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患。 -->\n <Teleport to=\"body\">\n <ArkDatePicker.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkDatePicker.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-[var(--z-overlay)] rounded-md border shadow-md',\n )\n \"\n >\n <slot />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { provide } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport CalendarIcon from \"../icon-shared/CalendarIcon.vue\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\nimport { CALENDAR_IN_PICKER, controlCls, iconBtnCls } from \"./shared\";\n\n/** 单值日期族(Date/Month/Year/Week)共用外壳:触发器 + 清空/日历按钮 + 弹层容器。 */\ndefineOptions({ inheritAttrs: false });\n\nconst props = defineProps({\n modelValue: { type: Array as PropType<DateValue[]>, required: true },\n open: { type: Boolean, required: true },\n locale: { type: String, default: \"zh-CN\" },\n min: { type: Object as PropType<DateValue | undefined>, default: undefined },\n max: { type: Object as PropType<DateValue | undefined>, default: undefined },\n /** 不可选日期谓词(参数为 ark 的 DateValue) */\n isDateUnavailable: {\n type: Function as PropType<(date: DateValue) => boolean>,\n default: undefined,\n },\n closeOnSelect: { type: Boolean, default: true },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n placeholder: { type: String, default: \"请选择\" },\n /** 锁定视图粒度(Month/Year 选择器);undefined 走 Ark 默认 day 视图 */\n minView: { type: String as PropType<\"day\" | \"month\" | \"year\" | undefined>, default: undefined },\n maxView: { type: String as PropType<\"day\" | \"month\" | \"year\" | undefined>, default: undefined },\n format: { type: Function as PropType<(date: DateValue) => string>, required: true },\n parse: { type: Function as PropType<(raw: string) => DateValue | undefined>, required: true },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: DateValue[]];\n \"update:open\": [open: boolean];\n}>();\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root)\nprovide(CALENDAR_IN_PICKER, true);\n\nfunction openFromInput() {\n if (props.disabled || props.readOnly || props.open) return;\n emit(\"update:open\", true);\n}\n</script>\n\n<template>\n <ArkDatePicker.Root\n :model-value=\"modelValue\"\n :open=\"open\"\n :locale=\"locale\"\n :min-view=\"minView\"\n :max-view=\"maxView\"\n :min=\"min\"\n :max=\"max\"\n :is-date-unavailable=\"isDateUnavailable\"\n :close-on-select=\"closeOnSelect\"\n :read-only=\"readOnly\"\n :disabled=\"disabled\"\n :format=\"format\"\n :parse=\"parse\"\n @update:model-value=\"emit('update:modelValue', $event)\"\n @update:open=\"emit('update:open', $event)\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :placeholder=\"placeholder\"\n :aria-invalid=\"invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <CloseIcon class=\"size-4\" />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon class=\"size-4\" />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport 到 body:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患。 -->\n <Teleport to=\"body\">\n <ArkDatePicker.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkDatePicker.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-[var(--z-overlay)] rounded-md border shadow-md',\n )\n \"\n >\n <slot />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
27
15
  },
28
16
  {
29
17
  "path": "date-shared/shared.ts",