@tu-design/vue 0.2.1 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/dist/index.d.mts +3620 -674
  2. package/dist/index.mjs +7442 -799
  3. package/dist/registry/vue/alert.json +22 -0
  4. package/dist/registry/vue/avatar-group.json +21 -0
  5. package/dist/registry/vue/avatar.json +3 -3
  6. package/dist/registry/vue/calendar.json +34 -0
  7. package/dist/registry/vue/card.json +3 -33
  8. package/dist/registry/vue/cascader.json +34 -0
  9. package/dist/registry/vue/checkbox.json +1 -1
  10. package/dist/registry/vue/currency-input.json +27 -0
  11. package/dist/registry/vue/date-picker.json +22 -0
  12. package/dist/registry/vue/date-range-picker.json +22 -0
  13. package/dist/registry/vue/date-shared.json +26 -0
  14. package/dist/registry/vue/dialog.json +3 -45
  15. package/dist/registry/vue/dropdown-menu.json +11 -35
  16. package/dist/registry/vue/empty.json +21 -0
  17. package/dist/registry/vue/form-render.json +115 -0
  18. package/dist/registry/vue/form.json +70 -0
  19. package/dist/registry/vue/input.json +2 -2
  20. package/dist/registry/vue/month-picker.json +22 -0
  21. package/dist/registry/vue/number-input.json +28 -0
  22. package/dist/registry/vue/password-input.json +21 -0
  23. package/dist/registry/vue/pin-input.json +22 -0
  24. package/dist/registry/vue/popover.json +22 -0
  25. package/dist/registry/vue/progress.json +22 -0
  26. package/dist/registry/vue/radio-group.json +2 -8
  27. package/dist/registry/vue/registry.json +156 -6
  28. package/dist/registry/vue/select.json +3 -27
  29. package/dist/registry/vue/slider.json +1 -1
  30. package/dist/registry/vue/spin.json +22 -0
  31. package/dist/registry/vue/table-render.json +62 -0
  32. package/dist/registry/vue/tabs.json +2 -20
  33. package/dist/registry/vue/textarea.json +21 -0
  34. package/dist/registry/vue/toast.json +28 -0
  35. package/dist/registry/vue/tokens.json +1 -1
  36. package/dist/registry/vue/tooltip.json +2 -14
  37. package/dist/registry/vue/tree-select.json +34 -0
  38. package/dist/registry/vue/tree-shared.json +92 -0
  39. package/dist/registry/vue/week-picker.json +22 -0
  40. package/dist/registry/vue/year-picker.json +22 -0
  41. package/package.json +6 -2
@@ -0,0 +1,22 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "alert",
4
+ "type": "registry:ui",
5
+ "description": "语义化警示条,支持五种变体、内置图标与可关闭交互。",
6
+ "registryDependencies": ["utils"],
7
+ "dependencies": ["class-variance-authority@^0.7.1"],
8
+ "files": [
9
+ {
10
+ "path": "alert/Alert.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/alert/Alert.vue",
13
+ "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
+ },
15
+ {
16
+ "path": "alert/index.ts",
17
+ "type": "registry:component",
18
+ "target": "components/ui/alert/index.ts",
19
+ "content": "import { cva, type VariantProps } from \"class-variance-authority\";\n\nexport { default as Alert } from \"./Alert.vue\";\n\nexport const alertVariants = cva(\n \"relative w-full rounded-lg border px-4 py-3 text-sm flex gap-3 items-start\",\n {\n variants: {\n variant: {\n default: \"border-border bg-card text-card-foreground\",\n info: \"border-[color-mix(in_oklab,var(--color-info)_35%,transparent)] bg-[color-mix(in_oklab,var(--color-info)_10%,transparent)] text-foreground\",\n success:\n \"border-[color-mix(in_oklab,var(--color-success)_35%,transparent)] bg-[color-mix(in_oklab,var(--color-success)_10%,transparent)] text-foreground\",\n warning:\n \"border-[color-mix(in_oklab,var(--color-warning)_35%,transparent)] bg-[color-mix(in_oklab,var(--color-warning)_10%,transparent)] text-foreground\",\n error:\n \"border-[color-mix(in_oklab,var(--color-destructive)_35%,transparent)] bg-[color-mix(in_oklab,var(--color-destructive)_10%,transparent)] text-foreground\",\n },\n },\n defaultVariants: {\n variant: \"default\",\n },\n },\n);\n\nexport type AlertVariants = VariantProps<typeof alertVariants>;\n\nexport const alertIconVariants = cva(\"size-4 shrink-0 mt-0.5\", {\n variants: {\n variant: {\n default: \"text-foreground\",\n info: \"text-info\",\n success: \"text-success\",\n warning: \"text-warning\",\n error: \"text-destructive\",\n },\n },\n defaultVariants: {\n variant: \"default\",\n },\n});\n\n/**\n * 内置图标路径(按 variant 形状差异化,保证色弱用户可辨别):\n * - default:圆圈 + i(信息)\n * - info:圆圈 + 感叹号\n * - success:圆圈 + 对勾\n * - warning:三角 + 感叹号\n * - error:圆圈 + 叉号\n */\nexport const alertIconPaths: Record<string, string> = {\n default: \"M12 22a10 10 0 1 0 0-20 10 10 0 0 0 0 20ZM12 16v-4m0-4h.01\",\n info: \"M22 12a10 10 0 1 1-20 0 10 10 0 0 1 20 0ZM12 8v4m0 4h.01\",\n success: \"M22 11.08V12a10 10 0 1 1-5.93-9.14M22 4 12 14.01l-3-3\",\n warning:\n \"M12 9v4m0 4h.01M10.29 3.86 1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0Z\",\n error: \"M22 12a10 10 0 1 1-20 0 10 10 0 0 1 20 0ZM15 9l-6 6m0-6 6 6\",\n};\n"
20
+ }
21
+ ]
22
+ }
@@ -0,0 +1,21 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "avatar-group",
4
+ "type": "registry:ui",
5
+ "description": "头像组,数量折叠、悬停展开与垂直排列。",
6
+ "registryDependencies": ["utils", "avatar"],
7
+ "files": [
8
+ {
9
+ "path": "avatar-group/AvatarGroup.vue",
10
+ "type": "registry:component",
11
+ "target": "components/ui/avatar-group/AvatarGroup.vue",
12
+ "content": "<script setup lang=\"ts\">\nimport { Comment, Fragment, Text, computed, provide, ref, toRef, useSlots, type VNode } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { Avatar, avatarGroupKey, type AvatarVariants } from \"../avatar\";\n\ninterface Props {\n /** 最多展示的子头像数,超出折叠为 +N 尾巴(按 default 插槽内子 Avatar 计数) */\n max?: number;\n vertical?: boolean;\n /** 下发给子 Avatar 的尺寸(子级显式 size 优先) */\n size?: AvatarVariants[\"size\"] | number;\n /** 悬停展开全部头像(仅在设置了 max 时生效) */\n expandOnHover?: boolean;\n /** 子头像加描边(Group 内部分隔) */\n bordered?: boolean;\n class?: string;\n}\n\nconst props = defineProps<Props>();\n\nconst slots = useSlots();\nconst expanded = ref(false);\n\nprovide(avatarGroupKey, { size: toRef(props, \"size\") });\n\n// default 插槽的元素级 VNode(过滤注释与文本节点)。\n// 真实模板中 v-for 会把子节点包进单个 Fragment vnode,须递归展平后再计数/切片——\n// 否则 total 恒为 1,max 折叠在插槽用 v-for 时(绝大多数真实用法)整体失效\nfunction flattenVnodes(vnodes: VNode[]): VNode[] {\n return vnodes.flatMap((v) => {\n if (v.type === Fragment && Array.isArray(v.children))\n return flattenVnodes(v.children as VNode[]);\n return v.type !== Comment && v.type !== Text ? [v] : [];\n });\n}\n\nconst childVnodes = computed(() => flattenVnodes(slots.default?.() ?? []));\n\nconst total = computed(() => childVnodes.value.length);\n\nconst restCount = computed(() =>\n props.max != null && total.value > props.max ? total.value - props.max : 0,\n);\n\nconst showRest = computed(() => restCount.value > 0 && !(props.expandOnHover && expanded.value));\n\n// 折叠直接切片渲染:nth-child 动态类([&>*:nth-child(n+X)]:hidden)由运行时拼接,\n// Tailwind 扫描不到该候选而从不生成 CSS,折叠在真实页面从未生效\nconst visibleVnodes = computed(() =>\n props.max != null && !expanded.value ? childVnodes.value.slice(0, props.max) : childVnodes.value,\n);\n\nfunction onEnter() {\n if (props.expandOnHover) expanded.value = true;\n}\n\nfunction onLeave() {\n expanded.value = false;\n}\n</script>\n\n<template>\n <div\n :class=\"\n cn(\n 'inline-flex items-center',\n props.vertical ? 'flex-col [&>*+*]:-mt-2' : 'flex-row [&>*+*]:-ml-2',\n props.bordered && '[&>*]:ring-2 [&>*]:ring-background',\n props.class,\n )\n \"\n @mouseenter=\"onEnter\"\n @mouseleave=\"onLeave\"\n >\n <template v-for=\"(vnode, i) in visibleVnodes\" :key=\"vnode.key ?? i\">\n <component :is=\"vnode\" />\n </template>\n <Avatar v-if=\"showRest\" class=\"!inline-flex font-medium\">\n <slot name=\"rest\" :rest=\"restCount\">+{{ restCount }}</slot>\n </Avatar>\n </div>\n</template>\n"
13
+ },
14
+ {
15
+ "path": "avatar-group/index.ts",
16
+ "type": "registry:component",
17
+ "target": "components/ui/avatar-group/index.ts",
18
+ "content": "export { default as AvatarGroup } from \"./AvatarGroup.vue\";\n"
19
+ }
20
+ ]
21
+ }
@@ -2,7 +2,7 @@
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "avatar",
4
4
  "type": "registry:ui",
5
- "description": "头像,含图片加载与回退(Ark UI)。",
5
+ "description": "头像,支持尺寸/形状、加载占位与失败回退(Ark UI)。",
6
6
  "registryDependencies": ["utils"],
7
7
  "dependencies": ["@ark-ui/vue@^5.39.2"],
8
8
  "files": [
@@ -10,13 +10,13 @@
10
10
  "path": "avatar/Avatar.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/avatar/Avatar.vue",
13
- "content": "<script setup lang=\"ts\">\nimport { Avatar as ArkAvatar } from \"@ark-ui/vue/avatar\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n src?: string;\n alt?: string;\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkAvatar.Root :class=\"cn('inline-flex size-10 overflow-hidden rounded-full', props.class)\">\n <ArkAvatar.Image\n v-if=\"props.src\"\n :src=\"props.src\"\n :alt=\"props.alt\"\n class=\"size-full object-cover\"\n />\n <ArkAvatar.Fallback class=\"flex size-full items-center justify-center bg-muted\">\n <slot />\n </ArkAvatar.Fallback>\n </ArkAvatar.Root>\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport type { ImgHTMLAttributes } from \"vue\";\nimport { computed, inject, ref } from \"vue\";\nimport { Avatar as ArkAvatar, type AvatarStatusChangeDetails } from \"@ark-ui/vue/avatar\";\nimport { cn } from \"@/lib/utils\";\nimport { avatarGroupKey, avatarVariants, type AvatarVariants } from \"./index\";\n\ninterface Props {\n src?: string;\n alt?: string;\n /** 图片加载失败时的备用图片地址(自动切换;备用图也失败时回落 Fallback 并再次触发 error) */\n fallback?: string;\n /** 预设尺寸或自定义像素值(number) */\n size?: AvatarVariants[\"size\"] | number;\n shape?: AvatarVariants[\"shape\"];\n /** Fallback 背景色覆盖(默认主题 bg-muted) */\n color?: string;\n /** 图片在容器内的适应方式 */\n objectFit?: \"fill\" | \"contain\" | \"cover\" | \"none\" | \"scale-down\";\n /** 透传到底层 img 的原生属性(组件显式属性优先级更高) */\n imgProps?: ImgHTMLAttributes;\n class?: string;\n}\n\nconst props = withDefaults(defineProps<Props>(), {\n shape: \"circle\",\n objectFit: \"cover\",\n});\n\nconst emit = defineEmits<{\n /** 图片加载完成 */\n load: [details: AvatarStatusChangeDetails];\n /** 图片加载失败(使用 fallback 且其也失败时会再次触发) */\n error: [details: AvatarStatusChangeDetails];\n}>();\n\n// Ark 仅上报 loaded/error(zag LoadStatus 双态);loading 为本地初始态,\n// 驱动 #placeholder 插槽与 fallback 切换\nconst status = ref<\"loading\" | \"loaded\" | \"error\">(\"loading\");\n\nfunction handleStatusChange(details: AvatarStatusChangeDetails) {\n status.value = details.status;\n if (details.status === \"loaded\") emit(\"load\", details);\n else emit(\"error\", details);\n}\n\n// 失败且配置 fallback 时切换到备用图;切图会重新走加载流程并再次上报状态\nconst currentSrc = computed(() =>\n status.value === \"error\" && props.fallback ? props.fallback : props.src,\n);\n\n// 头像组注入的 size(子级显式传入优先),缺省回落 md\nconst groupCtx = inject(avatarGroupKey, null);\nconst sizeValue = computed(() => props.size ?? groupCtx?.size.value ?? \"md\");\nconst sizeStyle = computed(() =>\n typeof sizeValue.value === \"number\"\n ? { width: `${sizeValue.value}px`, height: `${sizeValue.value}px` }\n : undefined,\n);\nconst variantClass = computed(() =>\n typeof sizeValue.value === \"number\"\n ? avatarVariants({ shape: props.shape })\n : avatarVariants({ size: sizeValue.value, shape: props.shape }),\n);\n</script>\n\n<template>\n <ArkAvatar.Root\n :class=\"cn(variantClass, props.class)\"\n :style=\"sizeStyle\"\n @status-change=\"handleStatusChange\"\n >\n <ArkAvatar.Image\n v-if=\"currentSrc\"\n v-bind=\"props.imgProps\"\n :src=\"currentSrc\"\n :alt=\"props.alt\"\n :style=\"{ objectFit: props.objectFit }\"\n class=\"size-full\"\n />\n <ArkAvatar.Fallback\n :style=\"props.color ? { background: props.color } : undefined\"\n class=\"flex size-full items-center justify-center\"\n >\n <slot v-if=\"currentSrc && status === 'loading'\" name=\"placeholder\" />\n <slot v-else>\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-1/2\"\n aria-hidden=\"true\"\n >\n <path d=\"M19 21v-2a4 4 0 0 0-4-4H9a4 4 0 0 0-4 4v2\" />\n <circle cx=\"12\" cy=\"7\" r=\"4\" />\n </svg>\n </slot>\n </ArkAvatar.Fallback>\n </ArkAvatar.Root>\n</template>\n"
14
14
  },
15
15
  {
16
16
  "path": "avatar/index.ts",
17
17
  "type": "registry:component",
18
18
  "target": "components/ui/avatar/index.ts",
19
- "content": "export { default as Avatar } from \"./Avatar.vue\";\n"
19
+ "content": "import { cva, type VariantProps } from \"class-variance-authority\";\nimport type { InjectionKey, Ref } from \"vue\";\n\nexport { default as Avatar } from \"./Avatar.vue\";\n\nexport const avatarVariants = cva(\"inline-flex shrink-0 overflow-hidden bg-muted\", {\n variants: {\n size: {\n xs: \"size-6 text-[10px]\",\n sm: \"size-8 text-xs\",\n md: \"size-10 text-sm\",\n lg: \"size-12 text-base\",\n },\n shape: {\n circle: \"rounded-full\",\n square: \"rounded-md\",\n },\n },\n});\n\nexport type AvatarVariants = VariantProps<typeof avatarVariants>;\n\n/** 头像组上下文:size 经 provide/inject 下发给子 Avatar(子级显式 size 优先) */\nexport interface AvatarGroupContext {\n size: Ref<AvatarVariants[\"size\"] | number | undefined>;\n}\n\nexport const avatarGroupKey: InjectionKey<AvatarGroupContext> = Symbol(\"tu-avatar-group\");\n"
20
20
  }
21
21
  ]
22
22
  }
@@ -0,0 +1,34 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "calendar",
4
+ "type": "registry:ui",
5
+ "description": "日历(TCalendar):紧凑日历卡。Picker 弹层内为 embedded 内嵌形态(TDatePicker/TDateRangePicker 自动挂靠,纯卡片内核);独立使用即 standalone 独立形态(自带日历状态与 v-model,恒开展示)。",
6
+ "registryDependencies": ["utils", "date-shared"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "files": [
9
+ {
10
+ "path": "calendar/Calendar.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/calendar/Calendar.vue",
13
+ "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 { 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=\"w-fit\">\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
+ },
15
+ {
16
+ "path": "calendar/CalendarBody.vue",
17
+ "type": "registry:component",
18
+ "target": "components/ui/calendar/CalendarBody.vue",
19
+ "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
+ },
21
+ {
22
+ "path": "calendar/CalendarNav.vue",
23
+ "type": "registry:component",
24
+ "target": "components/ui/calendar/CalendarNav.vue",
25
+ "content": "<script setup lang=\"ts\">\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"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=\"viewControlCls\">\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
+ },
27
+ {
28
+ "path": "calendar/index.ts",
29
+ "type": "registry:component",
30
+ "target": "components/ui/calendar/index.ts",
31
+ "content": "export { default as Calendar } from \"./Calendar.vue\";\n"
32
+ }
33
+ ]
34
+ }
@@ -2,50 +2,20 @@
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "card",
4
4
  "type": "registry:ui",
5
- "description": "卡片容器族:Header/Title/Description/Content/Footer。",
5
+ "description": "卡片容器:单组件 API,title/description 头部 + 命名插槽(cover/action/footer/header),支持尺寸、视觉变体、分段分隔与可关闭。",
6
6
  "registryDependencies": ["utils"],
7
7
  "files": [
8
8
  {
9
9
  "path": "card/Card.vue",
10
10
  "type": "registry:component",
11
11
  "target": "components/ui/card/Card.vue",
12
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\nconst props = defineProps<{ class?: string }>();\n</script>\n\n<template>\n <div\n :class=\"\n cn('rounded-xl border border-border bg-card text-card-foreground shadow-xs', props.class)\n \"\n >\n <slot />\n </div>\n</template>\n"
13
- },
14
- {
15
- "path": "card/CardContent.vue",
16
- "type": "registry:component",
17
- "target": "components/ui/card/CardContent.vue",
18
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\nconst props = defineProps<{ class?: string }>();\n</script>\n\n<template>\n <div :class=\"cn('p-6 pt-0', props.class)\">\n <slot />\n </div>\n</template>\n"
19
- },
20
- {
21
- "path": "card/CardDescription.vue",
22
- "type": "registry:component",
23
- "target": "components/ui/card/CardDescription.vue",
24
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\nconst props = defineProps<{ class?: string }>();\n</script>\n\n<template>\n <p :class=\"cn('text-sm text-muted-foreground', props.class)\">\n <slot />\n </p>\n</template>\n"
25
- },
26
- {
27
- "path": "card/CardFooter.vue",
28
- "type": "registry:component",
29
- "target": "components/ui/card/CardFooter.vue",
30
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\nconst props = defineProps<{ class?: string }>();\n</script>\n\n<template>\n <div :class=\"cn('flex items-center p-6 pt-0', props.class)\">\n <slot />\n </div>\n</template>\n"
31
- },
32
- {
33
- "path": "card/CardHeader.vue",
34
- "type": "registry:component",
35
- "target": "components/ui/card/CardHeader.vue",
36
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\nconst props = defineProps<{ class?: string }>();\n</script>\n\n<template>\n <div :class=\"cn('flex flex-col gap-1.5 p-6', props.class)\">\n <slot />\n </div>\n</template>\n"
37
- },
38
- {
39
- "path": "card/CardTitle.vue",
40
- "type": "registry:component",
41
- "target": "components/ui/card/CardTitle.vue",
42
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\nconst props = defineProps<{ class?: string }>();\n</script>\n\n<template>\n <h3 :class=\"cn('font-semibold leading-none tracking-tight', props.class)\">\n <slot />\n </h3>\n</template>\n"
12
+ "content": "<script setup lang=\"ts\">\nimport { computed, useSlots } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { cardVariants, type CardVariants } from \"./index\";\n\ninterface Props {\n /** 标题文案,渲染进头部(#title / #header 插槽可覆盖) */\n title?: string;\n /** 描述文案,渲染进头部(#description / #header 插槽可覆盖) */\n description?: string;\n /** 卡片尺寸,联动圆角、字级与分区 padding */\n size?: CardVariants[\"size\"];\n /** 是否显示边框(关闭时同时去掉阴影基底) */\n bordered?: boolean;\n /** 悬浮时提升阴影 */\n hoverable?: boolean;\n /** 可点击卡片:hover 提升 + cursor-pointer */\n interactive?: boolean;\n /** 嵌入式背景(bg-muted/30) */\n embedded?: boolean;\n /** 分区之间显示分隔线(不含 Cover) */\n segmented?: boolean;\n /** 显示关闭按钮,点击触发 close 事件 */\n closable?: boolean;\n class?: string;\n}\n\nconst props = withDefaults(defineProps<Props>(), {\n title: undefined,\n description: undefined,\n size: \"default\",\n bordered: true,\n});\n\nconst emit = defineEmits<{ close: [] }>();\n\nconst slots = useSlots();\n\n// 分区样式原样搬运自原复合子组件(CardHeader/CardTitle/CardDescription/\n// CardAction/CardCover/CardContent/CardFooter),保持视觉与 data-slot 不变\nconst headerClass =\n \"grid auto-rows-min grid-rows-[auto_auto] items-start gap-1.5 p-6 has-data-[slot=card-action]:grid-cols-[minmax(0,1fr)_auto]\";\nconst titleClass = \"font-semibold leading-none tracking-tight\";\nconst descriptionClass = \"text-sm text-muted-foreground\";\nconst actionClass =\n \"col-start-2 row-span-2 row-start-1 flex items-center gap-2 self-start justify-self-end\";\nconst coverClass = \"-mx-px -mt-px overflow-hidden rounded-t-[inherit]\";\nconst contentClass = \"p-6 pt-0\";\nconst footerClass = \"flex items-center p-6 pt-0\";\n\n// 是否渲染头部:任一头部来源存在即渲染(#header 逃生口 / #action / title / description)\nconst hasHeader = computed(\n () =>\n Boolean(slots.header) ||\n Boolean(slots.action) ||\n props.title !== undefined ||\n Boolean(slots.title) ||\n props.description !== undefined ||\n Boolean(slots.description),\n);\n\nconst rootClass = computed(() =>\n cn(\n cardVariants({\n size: props.size,\n bordered: props.bordered,\n hoverable: props.hoverable,\n interactive: props.interactive,\n embedded: props.embedded,\n }),\n props.segmented\n ? [\n \"[&>[data-slot]:not(:first-child):not([data-slot=card-cover])]:border-t\",\n \"[&>[data-slot=card-content]]:pt-6\",\n \"[&>[data-slot=card-footer]]:pt-6\",\n ]\n : undefined,\n props.class,\n ),\n);\n</script>\n\n<template>\n <div data-slot=\"card\" :class=\"rootClass\">\n <!-- 封面区(原 CardCover):顶部媒体区,负 margin 贴边 + 圆角裁剪 -->\n <div v-if=\"slots.cover\" data-slot=\"card-cover\" :class=\"coverClass\">\n <slot name=\"cover\" />\n </div>\n\n <!-- 头部(原 CardHeader):含 #action 时自动切换为两栏 grid;\n #header 为全自定义逃生口,提供时替代 title/description 头部渲染 -->\n <div v-if=\"hasHeader\" data-slot=\"card-header\" :class=\"headerClass\">\n <template v-if=\"slots.header\">\n <slot name=\"header\" />\n </template>\n <template v-else>\n <h3 v-if=\"slots.title || props.title\" data-slot=\"card-title\" :class=\"titleClass\">\n <slot name=\"title\">{{ props.title }}</slot>\n </h3>\n <p\n v-if=\"slots.description || props.description\"\n data-slot=\"card-description\"\n :class=\"descriptionClass\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </p>\n </template>\n <!-- 头部右侧动作区(原 CardAction),无论 #header 是否接管均可叠加 -->\n <div v-if=\"slots.action\" data-slot=\"card-action\" :class=\"actionClass\">\n <slot name=\"action\" />\n </div>\n </div>\n\n <!-- 内容区(原 CardContent):默认插槽 -->\n <div v-if=\"slots.default\" data-slot=\"card-content\" :class=\"contentClass\">\n <slot />\n </div>\n\n <!-- 底部(原 CardFooter) -->\n <div v-if=\"slots.footer\" data-slot=\"card-footer\" :class=\"footerClass\">\n <slot name=\"footer\" />\n </div>\n\n <button\n v-if=\"props.closable\"\n type=\"button\"\n aria-label=\"关闭\"\n class=\"absolute right-3 top-3 inline-flex size-7 cursor-pointer items-center justify-center rounded-md text-muted-foreground opacity-70 transition-[color,background-color,opacity] hover:bg-muted hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring\"\n @click=\"emit('close')\"\n >\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M18 6 6 18\" />\n <path d=\"m6 6 12 12\" />\n </svg>\n </button>\n </div>\n</template>\n"
43
13
  },
44
14
  {
45
15
  "path": "card/index.ts",
46
16
  "type": "registry:component",
47
17
  "target": "components/ui/card/index.ts",
48
- "content": "export { default as Card } from \"./Card.vue\";\nexport { default as CardContent } from \"./CardContent.vue\";\nexport { default as CardDescription } from \"./CardDescription.vue\";\nexport { default as CardFooter } from \"./CardFooter.vue\";\nexport { default as CardHeader } from \"./CardHeader.vue\";\nexport { default as CardTitle } from \"./CardTitle.vue\";\n"
18
+ "content": "import { cva, type VariantProps } from \"class-variance-authority\";\n\nexport { default as Card } from \"./Card.vue\";\n\nexport const cardVariants = cva(\n \"relative rounded-xl border border-border bg-card text-card-foreground shadow-xs\",\n {\n variants: {\n size: {\n sm: \"rounded-lg text-sm [&>[data-slot=card-header]]:p-4 [&>[data-slot=card-content]]:px-4 [&>[data-slot=card-footer]]:px-4\",\n default: \"\",\n lg: \"rounded-2xl text-base [&>[data-slot=card-header]]:p-8 [&>[data-slot=card-content]]:px-8 [&>[data-slot=card-footer]]:px-8\",\n },\n bordered: { true: \"\", false: \"border-0 shadow-none\" },\n hoverable: { true: \"transition-shadow hover:shadow-md\" },\n interactive: {\n true: \"cursor-pointer transition-[box-shadow,translate] hover:shadow-md hover:-translate-y-0.5 active:translate-y-0\",\n },\n embedded: { true: \"bg-muted/30\" },\n },\n defaultVariants: {\n size: \"default\",\n bordered: true,\n },\n },\n);\n\nexport type CardVariants = VariantProps<typeof cardVariants>;\n"
49
19
  }
50
20
  ]
51
21
  }
@@ -0,0 +1,34 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "cascader",
4
+ "type": "registry:ui",
5
+ "description": "级联选择:一站式 props 驱动,多列联动、勾选级联、路径回显与多标签。",
6
+ "registryDependencies": ["tree-shared", "utils", "date-shared"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "files": [
9
+ {
10
+ "path": "cascader/Cascader.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/cascader/Cascader.vue",
13
+ "content": "<script setup lang=\"ts\">\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport type { PropType } from \"vue\";\nimport { computed, nextTick, ref, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { controlCls } from \"../date-shared/shared\";\nimport ChevronIcon from \"../tree-shared/ChevronIcon.vue\";\nimport ClearIcon from \"../tree-shared/ClearIcon.vue\";\nimport ValueTags from \"../tree-shared/ValueTags.vue\";\nimport {\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 \"update:show\": [open: boolean];\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 internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleOpenUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:show\", open);\n}\n\nfunction openFromInput() {\n if (props.disabled || isOpen.value) return;\n syncPanelWidth();\n handleOpenUpdate(true);\n}\n\n// —— 面板宽度对齐触发器 ——\nconst triggerEl = ref<HTMLElement | null>(null);\nconst panelMinWidth = ref(\"0px\");\nfunction syncPanelWidth() {\n panelMinWidth.value = `${triggerEl.value?.offsetWidth ?? 0}px`;\n}\n\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 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\nfunction isExpanded(node: TreeNode): boolean {\n return expandedPath.value.includes(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 handleOpenUpdate(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=\"handleOpenUpdate\">\n <ArkPopover.Anchor as-child>\n <div\n ref=\"triggerEl\"\n v-bind=\"$attrs\"\n data-part=\"trigger\"\n role=\"button\"\n tabindex=\"0\"\n :aria-expanded=\"isOpen\"\n aria-haspopup=\"true\"\n :aria-disabled=\"props.disabled || undefined\"\n :class=\"\n cn(\n controlCls,\n 'min-h-9 cursor-pointer gap-2 px-3 py-1.5 text-sm',\n props.disabled && 'cursor-not-allowed opacity-50',\n props.class,\n )\n \"\n @click=\"openFromInput\"\n @keydown=\"handleKeydown\"\n >\n <template v-if=\"isMulti\">\n <ValueTags\n v-if=\"tags.length\"\n :values=\"tags\"\n :max-tag-count=\"props.maxTagCount\"\n :disabled=\"!!props.disabled\"\n @remove=\"removeTag\"\n />\n <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-50 rounded-md border p-0 shadow-md outline-none data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95',\n )\n \"\n :style=\"{ minWidth: panelMinWidth }\"\n @keydown=\"handleKeydown\"\n >\n <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
+ },
15
+ {
16
+ "path": "cascader/CascaderPanel.vue",
17
+ "type": "registry:component",
18
+ "target": "components/ui/cascader/CascaderPanel.vue",
19
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } 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\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=\"flex overflow-x-auto\">\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=\"props.selectedKeys.includes(node.key)\"\n :aria-checked=\"props.checkable ? props.checkedKeys.includes(node.key) : undefined\"\n :aria-expanded=\"node.children?.length ? props.isExpanded(node) : undefined\"\n :aria-disabled=\"node.disabled || undefined\"\n :data-selected=\"props.selectedKeys.includes(node.key) || undefined\"\n :data-checked=\"props.checkedKeys.includes(node.key) || undefined\"\n :data-indeterminate=\"props.indeterminateKeys.includes(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 props.checkedKeys.includes(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=\"props.checkedKeys.includes(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=\"props.indeterminateKeys.includes(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
+ },
21
+ {
22
+ "path": "cascader/index.ts",
23
+ "type": "registry:component",
24
+ "target": "components/ui/cascader/index.ts",
25
+ "content": "export { default as Cascader } from \"./Cascader.vue\";\nexport type { CheckStrategy, Key, TreeOption } from \"../tree-shared\";\n"
26
+ },
27
+ {
28
+ "path": "cascader/types.ts",
29
+ "type": "registry:component",
30
+ "target": "components/ui/cascader/types.ts",
31
+ "content": "export type { CheckStrategy, Key, TreeOption } from \"../tree-shared\";\n"
32
+ }
33
+ ]
34
+ }
@@ -10,7 +10,7 @@
10
10
  "path": "checkbox/Checkbox.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/checkbox/Checkbox.vue",
13
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { Checkbox as ArkCheckbox } from \"@ark-ui/vue/checkbox\";\nimport { cn } from \"@/lib/utils\";\n\n// checked 用 default: undefined 禁用 Boolean casting(Dialog 同款约定)\nconst props = defineProps({\n checked: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultChecked: { type: Boolean, default: false },\n disabled: { type: Boolean, default: false },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:checked\": [checked: boolean] }>();\n\n// 对 Root 恒走受控模式,非受控语义由内部 ref 实现(Dialog 同款)\nconst internalChecked = ref(props.defaultChecked);\nconst isChecked = computed(() => props.checked ?? internalChecked.value);\n\nfunction handleUpdate(checked: boolean) {\n internalChecked.value = checked;\n emit(\"update:checked\", checked);\n}\n</script>\n\n<template>\n <ArkCheckbox.Root\n :checked=\"isChecked\"\n :disabled=\"props.disabled\"\n :class=\"cn('inline-flex items-center gap-2', props.class)\"\n @update:checked=\"handleUpdate\"\n >\n <ArkCheckbox.HiddenInput />\n <ArkCheckbox.Control\n class=\"border-input data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground data-[state=checked]:border-primary focus-visible:border-ring focus-visible:ring-ring/50 peer size-4 shrink-0 rounded-[4px] border bg-transparent shadow-xs transition-shadow outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50\"\n >\n <ArkCheckbox.Indicator class=\"flex items-center justify-center text-current\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-3.5\"\n >\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n </ArkCheckbox.Indicator>\n </ArkCheckbox.Control>\n <ArkCheckbox.Label v-if=\"$slots.default\" class=\"text-sm leading-none font-medium select-none\">\n <slot />\n </ArkCheckbox.Label>\n </ArkCheckbox.Root>\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { Checkbox as ArkCheckbox } from \"@ark-ui/vue/checkbox\";\nimport { cn } from \"@/lib/utils\";\n\n// checked 用 default: undefined 禁用 Boolean casting(Dialog 同款约定);\n// \"indeterminate\" 对齐 Ark UI CheckedState,用于表格全选等半选语义(S10)\nconst props = defineProps({\n checked: {\n type: [Boolean, String] as PropType<boolean | \"indeterminate\" | undefined>,\n default: undefined,\n },\n defaultChecked: { type: Boolean, default: false },\n disabled: { type: Boolean, default: false },\n /** 原生表单提交的字段名(透传 HiddenInput,与 RadioGroup 对齐) */\n name: { type: String, default: undefined },\n /** 关联的 form id */\n form: { type: String, default: undefined },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:checked\": [checked: boolean] }>();\n\n// 对 Root 恒走受控模式,非受控语义由内部 ref 实现(Dialog 同款)\nconst internalChecked = ref<boolean>(props.defaultChecked);\nconst isChecked = computed(() => props.checked ?? internalChecked.value);\n\nfunction handleUpdate(checked: boolean | \"indeterminate\") {\n const next = checked === \"indeterminate\" ? false : checked;\n internalChecked.value = next;\n emit(\"update:checked\", next);\n}\n</script>\n\n<template>\n <ArkCheckbox.Root\n :checked=\"isChecked\"\n :disabled=\"props.disabled\"\n :name=\"props.name\"\n :form=\"props.form\"\n :class=\"cn('inline-flex items-center gap-2', props.class)\"\n @update:checked=\"handleUpdate\"\n >\n <ArkCheckbox.HiddenInput />\n <ArkCheckbox.Control\n class=\"border-input data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground data-[state=checked]:border-primary focus-visible:border-ring focus-visible:ring-ring/50 peer size-4 shrink-0 rounded-[4px] border bg-transparent shadow-xs transition-shadow outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50\"\n >\n <ArkCheckbox.Indicator class=\"flex items-center justify-center text-current\">\n <!-- 半选态(data-state=indeterminate)显示短横线,选中态显示对勾 -->\n <svg\n v-if=\"isChecked === 'indeterminate'\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n stroke-linecap=\"round\"\n class=\"size-3.5\"\n >\n <path d=\"M5 12h14\" />\n </svg>\n <svg\n v-else\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-3.5\"\n >\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n </ArkCheckbox.Indicator>\n </ArkCheckbox.Control>\n <ArkCheckbox.Label v-if=\"$slots.default\" class=\"text-sm leading-none font-medium select-none\">\n <slot />\n </ArkCheckbox.Label>\n </ArkCheckbox.Root>\n</template>\n"
14
14
  },
15
15
  {
16
16
  "path": "checkbox/index.ts",
@@ -0,0 +1,27 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "currency-input",
4
+ "type": "registry:ui",
5
+ "description": "金额输入框:内置万/元/角/分单位后缀,labelUnit 输入单位与 valueUnit 存储单位自动换算(整数分最小精度),值以 number|null 受控。",
6
+ "registryDependencies": ["utils"],
7
+ "files": [
8
+ {
9
+ "path": "currency-input/CurrencyInput.vue",
10
+ "type": "registry:component",
11
+ "target": "components/ui/currency-input/CurrencyInput.vue",
12
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { formatCurrency, parseCurrency, type CurrencyUnit } from \"./utils\";\n\nconst props = defineProps({\n /** 受控值(valueUnit 单位);undefined 走内部非受控,null 表示空 */\n modelValue: { type: Number as PropType<number | null | undefined>, default: undefined },\n /** 界面输入单位 */\n labelUnit: { type: String as PropType<CurrencyUnit>, default: \"元\" },\n /** 存储单位(v-model 值的单位) */\n valueUnit: { type: String as PropType<CurrencyUnit>, default: \"元\" },\n placeholder: { type: String, default: undefined },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: number | null];\n}>();\n\n// attrs(id/aria-*)转发给内部 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 纯原生实现:金额换算为十进制字符串移位(整数分精度),无需 ark/zag 原语\nconst internalValue = ref<number | null>(null);\nconst isControlled = computed(() => props.modelValue !== undefined);\n\n// 输入框保留用户键入原文;仅外部 modelValue 变化(非本次 emit 回流)才反算回显\nconst display = ref(\n props.modelValue !== undefined && props.modelValue !== null\n ? formatCurrency(props.modelValue, props.valueUnit, props.labelUnit)\n : \"\",\n);\nlet lastEmitted: number | null | undefined;\n\nfunction onInput(event: Event) {\n const raw = (event.target as HTMLInputElement).value;\n display.value = raw;\n const next = parseCurrency(raw, props.labelUnit, props.valueUnit);\n lastEmitted = next;\n if (!isControlled.value) internalValue.value = next;\n emit(\"update:modelValue\", next);\n}\n\nwatch(\n () => props.modelValue,\n (value) => {\n if (!isControlled.value || value === lastEmitted) return;\n display.value = value === null ? \"\" : formatCurrency(value, props.valueUnit, props.labelUnit);\n },\n);\n</script>\n\n<template>\n <div\n :class=\"\n cn(\n 'border-input flex h-9 w-full items-center overflow-hidden rounded-md border shadow-sm transition-[color,box-shadow] outline-none focus-within:border-ring focus-within:ring-ring/20 focus-within:ring-[3px] data-invalid:border-destructive data-invalid:ring-destructive/20 data-invalid:ring-[3px]',\n props.class,\n )\n \"\n :data-invalid=\"props.invalid ? '' : undefined\"\n >\n <input\n v-bind=\"$attrs\"\n type=\"text\"\n inputmode=\"decimal\"\n :value=\"display\"\n :placeholder=\"props.placeholder\"\n :disabled=\"props.disabled\"\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 disabled:cursor-not-allowed disabled:opacity-50'\"\n @input=\"onInput\"\n />\n <div\n aria-hidden=\"true\"\n :class=\"\n cn(\n 'border-input text-muted-foreground flex h-full shrink-0 items-center border-l bg-muted/40 px-3 text-sm',\n props.disabled && 'opacity-50',\n )\n \"\n >\n {{ props.labelUnit }}\n </div>\n </div>\n</template>\n"
13
+ },
14
+ {
15
+ "path": "currency-input/index.ts",
16
+ "type": "registry:component",
17
+ "target": "components/ui/currency-input/index.ts",
18
+ "content": "export { default as CurrencyInput } from \"./CurrencyInput.vue\";\nexport { formatCurrency, parseCurrency, type CurrencyUnit } from \"./utils\";\n"
19
+ },
20
+ {
21
+ "path": "currency-input/utils.ts",
22
+ "type": "registry:component",
23
+ "target": "components/ui/currency-input/utils.ts",
24
+ "content": "/** 货币单位:万/元/角/分(组件枚举固定,换算基准为整数分) */\nexport type CurrencyUnit = \"万\" | \"元\" | \"角\" | \"分\";\n\n/** 各单位折合整数分:分=1、角=10、元=100、万=1000000 */\nconst UNIT_FEN_EXP: Record<CurrencyUnit, number> = { 万: 6, 元: 2, 角: 1, 分: 0 };\n\n/**\n * 解析输入文本为 valueUnit 单位的数值(number|null)。\n * 全程十进制字符串移位(BigInt),仅在超出整数分精度时一次四舍五入;\n * 白名单 ^\\d*(\\.\\d*)?$,负号/非法字符/无数字一律 null。\n */\nexport function parseCurrency(\n raw: string,\n labelUnit: CurrencyUnit,\n valueUnit: CurrencyUnit,\n): number | null {\n if (!/^\\d*(\\.\\d*)?$/.test(raw) || !/\\d/.test(raw)) return null;\n const [intPart, fracPart = \"\"] = raw.split(\".\");\n const digits = BigInt((intPart || \"0\") + fracPart);\n const shift = UNIT_FEN_EXP[labelUnit] - fracPart.length;\n let fen: bigint;\n if (shift >= 0) {\n fen = digits * 10n ** BigInt(shift);\n } else {\n const divisor = 10n ** BigInt(-shift);\n const q = digits / divisor;\n const r = digits % divisor;\n fen = r * 2n >= divisor ? q + 1n : q;\n }\n return Number(fen) / 10 ** UNIT_FEN_EXP[valueUnit];\n}\n\n/**\n * 受控值(valueUnit 单位)反算为 labelUnit 单位的回显文本。\n * 值先取整到整数分(吸收浮点噪声),再做十进制移位并去尾零。\n */\nexport function formatCurrency(\n value: number,\n valueUnit: CurrencyUnit,\n labelUnit: CurrencyUnit,\n): string {\n if (!Number.isFinite(value)) return \"\";\n const negative = value < 0;\n const fen = BigInt(Math.abs(Math.round(value * 10 ** UNIT_FEN_EXP[valueUnit])));\n const exp = UNIT_FEN_EXP[labelUnit];\n let text: string;\n if (exp === 0) {\n text = fen.toString();\n } else {\n const s = fen.toString().padStart(exp + 1, \"0\");\n const frac = s.slice(-exp).replace(/0+$/, \"\");\n text = frac ? `${s.slice(0, -exp)}.${frac}` : s.slice(0, -exp);\n }\n return negative ? `-${text}` : text;\n}\n"
25
+ }
26
+ ]
27
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "date-picker",
4
+ "type": "registry:ui",
5
+ "description": "日期选择器:输入框 + 日历弹层(月/年视图切换),支持手动键入/清空/min-max 边界/不可选谓词,值以 \"yyyy-MM-dd\" 字符串受控。",
6
+ "registryDependencies": ["utils", "date-shared", "calendar"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "files": [
9
+ {
10
+ "path": "date-picker/DatePicker.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/date-picker/DatePicker.vue",
13
+ "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, ref } 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} from \"../date-shared/shared\";\n\nconst props = defineProps({\n /** 受控值(\"yyyy-MM-dd\");undefined 走内部非受控,null 表示空 */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n defaultValue: { type: String, default: undefined },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n placeholder: { type: String, default: \"请选择日期\" },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 可选下界(\"yyyy-MM-dd\",含当日) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy-MM-dd\",含当日) */\n max: { type: String, default: undefined },\n /** 不可选日期谓词(参数为 ark 的 DateValue,见 date-picker.md 类型说明) */\n isDateUnavailable: {\n type: Function as PropType<(date: DateValue) => boolean>,\n default: undefined,\n },\n /** 选中后是否自动关弹层 */\n closeOnSelect: { type: Boolean, default: true },\n /** 文案与周起点跟随 locale(zh-CN 默认周一起始) */\n locale: { type: String, default: \"zh-CN\" },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n \"update:open\": [open: boolean];\n}>();\n\n// attrs(id/aria-*)转发给真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root,值归本 Picker)\nprovide(CALENDAR_IN_PICKER, true);\n\n// —— 受控桥接(Select 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\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 internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.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\nfunction handleOpenUpdate(next: boolean) {\n internalOpen.value = next;\n emit(\"update:open\", next);\n}\n\n// 点击/键盘 ↓ 输入框即开弹层(zag 默认仅 Trigger 开,openOnClick prop 默认关闭;\n// 显式驱动保证各环境行为一致并显式走受控 emit)\nfunction openFromInput() {\n if (props.disabled || props.readOnly || isOpen.value) return;\n handleOpenUpdate(true);\n}\n</script>\n\n<template>\n <ArkDatePicker.Root\n :model-value=\"rootValue\"\n :open=\"isOpen\"\n :locale=\"props.locale\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :is-date-unavailable=\"props.isDateUnavailable\"\n :close-on-select=\"props.closeOnSelect\"\n :read-only=\"props.readOnly\"\n :disabled=\"props.disabled\"\n :format=\"formatIsoDate\"\n :parse=\"parseIsoDate\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"handleOpenUpdate\"\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 :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-50\">\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-50 rounded-md border shadow-md',\n )\n \"\n >\n <TCalendar />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
14
+ },
15
+ {
16
+ "path": "date-picker/index.ts",
17
+ "type": "registry:component",
18
+ "target": "components/ui/date-picker/index.ts",
19
+ "content": "export { default as DatePicker } from \"./DatePicker.vue\";\n"
20
+ }
21
+ ]
22
+ }
@@ -0,0 +1,22 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "date-range-picker",
4
+ "type": "registry:ui",
5
+ "description": "日期范围选择器:双月日历弹层(月/年视图切换),点选起点与终点,值以 [\"yyyy-MM-dd\", \"yyyy-MM-dd\"] 有序元组受控,空值归一 null。",
6
+ "registryDependencies": ["utils", "date-shared", "calendar"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "files": [
9
+ {
10
+ "path": "date-range-picker/DateRangePicker.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/date-range-picker/DateRangePicker.vue",
13
+ "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, ref, 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\";\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 internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleOpenUpdate(next: boolean) {\n internalOpen.value = next;\n emit(\"update:open\", next);\n}\n\n// 点击/键盘 ↓ 输入框即开弹层(zag 默认仅 Trigger 开,openOnClick prop 默认关闭;\n// 显式驱动保证各环境行为一致并显式走受控 emit)\nfunction openFromInput() {\n if (props.disabled || props.readOnly || isOpen.value) return;\n handleOpenUpdate(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=\"handleOpenUpdate\"\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-50\">\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-50 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
+ },
15
+ {
16
+ "path": "date-range-picker/index.ts",
17
+ "type": "registry:component",
18
+ "target": "components/ui/date-range-picker/index.ts",
19
+ "content": "export { default as DateRangePicker } from \"./DateRangePicker.vue\";\n"
20
+ }
21
+ ]
22
+ }
@@ -0,0 +1,26 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "date-shared",
4
+ "type": "registry:ui",
5
+ "description": "日期家族共享模块:ISO 值域解析(日期/月/年/区间)与日历样式常量。",
6
+ "files": [
7
+ {
8
+ "path": "date-shared/CalendarIcon.vue",
9
+ "type": "registry:component",
10
+ "target": "components/ui/date-shared/CalendarIcon.vue",
11
+ "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"
12
+ },
13
+ {
14
+ "path": "date-shared/ClearIcon.vue",
15
+ "type": "registry:component",
16
+ "target": "components/ui/date-shared/ClearIcon.vue",
17
+ "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"
18
+ },
19
+ {
20
+ "path": "date-shared/shared.ts",
21
+ "type": "registry:component",
22
+ "target": "components/ui/date-shared/shared.ts",
23
+ "content": "import { type DateValue, parseDate } from \"@ark-ui/vue/date-picker\";\nimport type { InjectionKey } from \"vue\";\n\n/**\n * 日期家族共享模块:ISO 值域解析(日期/月/年/区间)与日历样式常量。\n * 供 DatePicker / DateRangePicker 及后续变体(Month/Year/WeekPicker)复用。\n */\n\n/**\n * TCalendar 双形态标记:Picker 在 setup 里 provide(true),\n * 弹层内的 TCalendar 检测到宿主即保持「纯卡片内核」(embedded 内嵌形态,不自建 Root);\n * 独立使用时 inject 落到 fallback false → 自建 Root(standalone 独立形态,恒开)。\n */\nexport const CALENDAR_IN_PICKER: InjectionKey<boolean> = Symbol(\"tu-calendar-in-picker\");\n\n/** ISO 日期串格式(yyyy-MM-dd):日期家族公开值域的基础格式 */\nexport type IsoDate = string;\n\n/** zag 按 locale 分隔符清洗键入字符(zh-CN 为 \"/\"),解析前统一归一为 \"-\" */\nfunction normalizeSeparators(raw: string): string {\n return raw.trim().replace(/\\//g, \"-\");\n}\n\n/**\n * \"yyyy-MM-dd\" → DateValue(@internationalized/date 纯日历解析,无时区参与)。\n * 兼容 \"/\" 分隔(zag 键入清洗路径,如 \"2026/10/09\"),归一后做严格 ISO 校验;\n * 非法/非补零(如 \"abc\"、\"2026-2-3\")返回 undefined,由调用方忽略。\n */\nexport function parseIsoDate(raw: string): DateValue | undefined {\n const normalized = normalizeSeparators(raw);\n if (!/^\\d{4}-\\d{2}-\\d{2}$/.test(normalized)) return undefined;\n try {\n return parseDate(normalized);\n } catch {\n return undefined;\n }\n}\n\n/** DateValue → \"yyyy-MM-dd\"(CalendarDate.toString 原生 ISO 输出) */\nexport function formatIsoDate(date: DateValue): string {\n return date.toString();\n}\n\n/** \"yyyy-MM\" → DateValue(锚定 1 日);非法/非补零返回 undefined */\nexport function parseIsoMonth(raw: string): DateValue | undefined {\n const normalized = normalizeSeparators(raw);\n if (!/^\\d{4}-\\d{2}$/.test(normalized)) return undefined;\n try {\n return parseDate(`${normalized}-01`);\n } catch {\n return undefined;\n }\n}\n\n/** DateValue → \"yyyy-MM\"(不能走 toString(),会带 day) */\nexport function formatIsoMonth(date: DateValue): string {\n return `${date.year}-${String(date.month).padStart(2, \"0\")}`;\n}\n\n/** \"yyyy\" → DateValue(锚定 1 月 1 日);非四位年份返回 undefined */\nexport function parseIsoYear(raw: string): DateValue | undefined {\n const normalized = normalizeSeparators(raw);\n if (!/^\\d{4}$/.test(normalized)) return undefined;\n try {\n return parseDate(`${normalized}-01-01`);\n } catch {\n return undefined;\n }\n}\n\n/** DateValue → \"yyyy\" */\nexport function formatIsoYear(date: DateValue): string {\n return String(date.year);\n}\n\n// —— 周粒度换算(WeekPicker 复用):不引入新依赖,纯日历计算 ——\n\n/**\n * locale 周起点(1=周一 … 7=周日,ISO 语义)。\n * 取 Intl.Locale.weekInfo.firstDay(Node ≥ 22 / 现代浏览器可用),异常兜底周一。\n */\nfunction localeFirstDay(locale: string): number {\n try {\n const info = (new Intl.Locale(locale) as Intl.Locale & { weekInfo?: { firstDay?: number } })\n .weekInfo;\n if (info?.firstDay && info.firstDay >= 1 && info.firstDay <= 7) return info.firstDay;\n } catch {\n // 非法 locale 落兜底\n }\n return 1;\n}\n\n/** DateValue → 周起点(跟随 locale;zh-CN 周一起始、en-US 周日起始) */\nexport function weekStartOf(date: DateValue, locale = \"zh-CN\"): DateValue {\n // 纯公历星期计算:ISO 日期 → UTC Date 的 getUTCDay(0=周日…6=周六),无时区歧义\n const utcDay = new Date(Date.UTC(date.year, date.month - 1, date.day)).getUTCDay();\n const firstDayIndex = localeFirstDay(locale) % 7; // 归一为 0=周日…6=周六\n const diff = (utcDay - firstDayIndex + 7) % 7;\n return diff === 0 ? date : date.subtract({ days: diff });\n}\n\n/** DateValue → 周终点(= 周起点 + 6 天) */\nexport function weekEndOf(date: DateValue, locale = \"zh-CN\"): DateValue {\n return weekStartOf(date, locale).add({ days: 6 });\n}\n\n/** 两日期是否同属一周(跟随 locale) */\nexport function isSameWeek(a: DateValue, b: DateValue, locale = \"zh-CN\"): boolean {\n return weekStartOf(a, locale).compare(weekStartOf(b, locale)) === 0;\n}\n\n/** DateValue → \"yyyy-MM-dd ~ yyyy-MM-dd\"(所在周区间,输入框回显用) */\nexport function formatIsoWeek(date: DateValue, locale = \"zh-CN\"): string {\n return `${formatIsoDate(weekStartOf(date, locale))} ~ ${formatIsoDate(weekEndOf(date, locale))}`;\n}\n\n/** 区间解析:逐侧 parseIsoDate + 顺序归一(start ≤ end);null / 任一侧非法返回 undefined */\nexport function parseIsoRange(\n raw: [string, string] | null | undefined,\n): [DateValue, DateValue] | undefined {\n if (!raw) return undefined;\n const start = parseIsoDate(raw[0] ?? \"\");\n const end = parseIsoDate(raw[1] ?? \"\");\n if (!start || !end) return undefined;\n return start.compare(end) <= 0 ? [start, end] : [end, start];\n}\n\n// —— 输入框侧共享样式常量(Control 容器与触发钮;卡片视觉见 calendar/CalendarBody)——\n\nexport const controlCls =\n \"border-input flex h-9 w-full items-center overflow-hidden rounded-md border bg-transparent shadow-xs transition-[color,box-shadow] outline-none focus-within:border-ring focus-within:ring-ring/50 focus-within:ring-[3px] data-invalid:border-destructive data-invalid:ring-destructive/20 data-invalid:ring-[3px]\";\nexport const iconBtnCls =\n \"text-muted-foreground/70 hover:text-foreground flex h-full w-8 shrink-0 items-center justify-center outline-none disabled:cursor-not-allowed disabled:opacity-30\";\n"
24
+ }
25
+ ]
26
+ }