@tu-design/vue 0.2.2 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/dist/index.d.mts +3717 -1104
  2. package/dist/index.mjs +7593 -1249
  3. package/dist/registry/vue/alert-dialog.json +22 -0
  4. package/dist/registry/vue/alert.json +22 -0
  5. package/dist/registry/vue/avatar-group.json +21 -0
  6. package/dist/registry/vue/avatar.json +3 -3
  7. package/dist/registry/vue/calendar.json +34 -0
  8. package/dist/registry/vue/card.json +3 -33
  9. package/dist/registry/vue/cascader.json +34 -0
  10. package/dist/registry/vue/checkbox.json +1 -1
  11. package/dist/registry/vue/context-menu.json +22 -0
  12. package/dist/registry/vue/currency-input.json +1 -1
  13. package/dist/registry/vue/date-picker.json +22 -0
  14. package/dist/registry/vue/date-range-picker.json +22 -0
  15. package/dist/registry/vue/date-shared.json +26 -0
  16. package/dist/registry/vue/dialog.json +3 -45
  17. package/dist/registry/vue/drawer.json +22 -0
  18. package/dist/registry/vue/dropdown-menu.json +11 -35
  19. package/dist/registry/vue/empty.json +21 -0
  20. package/dist/registry/vue/form-render.json +115 -0
  21. package/dist/registry/vue/form.json +2 -2
  22. package/dist/registry/vue/month-picker.json +22 -0
  23. package/dist/registry/vue/number-input.json +1 -1
  24. package/dist/registry/vue/popconfirm.json +22 -0
  25. package/dist/registry/vue/popover.json +3 -15
  26. package/dist/registry/vue/progress.json +22 -0
  27. package/dist/registry/vue/radio-group.json +2 -8
  28. package/dist/registry/vue/registry.json +138 -6
  29. package/dist/registry/vue/select.json +3 -27
  30. package/dist/registry/vue/slider.json +1 -1
  31. package/dist/registry/vue/spin.json +22 -0
  32. package/dist/registry/vue/table-render.json +62 -0
  33. package/dist/registry/vue/tabs.json +2 -20
  34. package/dist/registry/vue/toast.json +28 -0
  35. package/dist/registry/vue/tokens.json +1 -1
  36. package/dist/registry/vue/tooltip.json +2 -14
  37. package/dist/registry/vue/tree-select.json +34 -0
  38. package/dist/registry/vue/tree-shared.json +92 -0
  39. package/dist/registry/vue/week-picker.json +22 -0
  40. package/dist/registry/vue/year-picker.json +22 -0
  41. package/package.json +3 -1
@@ -0,0 +1,22 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "alert-dialog",
4
+ "type": "registry:ui",
5
+ "description": "确认弹窗单组件:v-model:open 控制显隐,title/description 传文案,@confirm/@cancel 处理确认与取消;确认处理器返回 Promise 时按钮进入 loading 并锁定 ESC/遮罩关闭,resolve 自动关闭、reject 保持打开;内容节点为 role=alertdialog。",
6
+ "registryDependencies": ["button", "utils"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "files": [
9
+ {
10
+ "path": "alert-dialog/AlertDialog.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/alert-dialog/AlertDialog.vue",
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, ref } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { Button } from \"@/components/button\";\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。与 Dialog.vue 同款约定。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 标题文案(#title 插槽优先) */\n title: { type: String, required: true },\n /** 描述文案(#description 插槽优先,可不传) */\n description: { type: String, default: undefined },\n /** 确认按钮文案 */\n confirmText: { type: String, default: \"确定\" },\n /** 取消按钮文案 */\n cancelText: { type: String, default: \"取消\" },\n /** 确认按钮使用 destructive 语义色(危险操作场景) */\n destructive: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{\n \"update:open\": [open: boolean];\n confirm: [];\n cancel: [];\n}>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,与 Dialog.vue 一致。\n// setup 期间捕获实例:getCurrentInstance 仅在 setup/生命周期内有效,事件回调里返回 null。\nconst instance = getCurrentInstance();\nconst internalOpen = ref(false);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleUpdate(open: boolean) {\n // pending 期间忽略一切关闭请求(走受控桥拒绝同步,弹窗保持打开)——\n // 与 Popconfirm 同款锁定方案;Root 仍保留 :close-on-escape/:close-on-interact-outside 双保险\n if (!open && loading.value) return;\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n\n/** 关闭弹窗:走受控桥把 open 置 false,退出动画/焦点还原由 zag 处理 */\nfunction close() {\n handleUpdate(false);\n}\n\n// 确认 Promise pending 时锁定关闭通道(ESC/遮罩/取消按钮全部锁死),只能等 Promise 落定\nconst loading = ref(false);\nconst locked = computed(() => loading.value);\n\n/**\n * 确认:emit 不会回传处理器返回值,因此从 vnode 上直接取原始 onConfirm 处理器调用——\n * 返回 Promise 时进入 loading 并锁定关闭,resolve 后自动关闭,reject 保持打开且退出 loading;\n * 同步处理器(或无处理器)直接关闭。\n */\nfunction handleConfirm() {\n if (loading.value) return;\n const handler = instance?.vnode.props?.onConfirm as ((...args: unknown[]) => unknown) | undefined;\n const result = handler?.();\n if (!handler) emit(\"confirm\");\n if (result instanceof Promise) {\n loading.value = true;\n result\n .then(() => {\n loading.value = false;\n close();\n })\n .catch(() => {\n loading.value = false;\n });\n } else {\n close();\n }\n}\n\n/** 取消:pending 时同样锁定;确认关闭并派发 cancel */\nfunction handleCancel() {\n if (loading.value) return;\n emit(\"cancel\");\n close();\n}\n\n// 面板样式:复用 Dialog 的内容面板类,宽度收窄为 sm:max-w-md 的确认弹窗尺度\nconst contentClass = computed(() =>\n cn(\n \"bg-background data-[state=open]:animate-in data-[state=closed]:animate-out fixed left-1/2 top-1/2 z-50 grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-lg border p-6 shadow-lg duration-200 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 sm:max-w-md\",\n ),\n);\n</script>\n\n<template>\n <ArkDialog.Root\n :open=\"isOpen\"\n :close-on-escape=\"!locked\"\n :close-on-interact-outside=\"!locked\"\n @update:open=\"handleUpdate\"\n >\n <ArkDialog.Backdrop\n class=\"fixed inset-0 z-50 bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\"\n />\n <ArkDialog.Positioner class=\"fixed inset-0 z-50 flex items-center justify-center p-4\">\n <!-- role=\"alertdialog\":覆盖 Ark Content 默认 role=\"dialog\",补偿无上游 AlertDialog 原语的角色语义 -->\n <ArkDialog.Content :class=\"contentClass\" role=\"alertdialog\" aria-modal=\"true\">\n <div class=\"flex flex-col gap-2 text-center sm:text-left\">\n <ArkDialog.Title class=\"text-lg font-semibold leading-none tracking-tight\">\n <slot name=\"title\">{{ props.title }}</slot>\n </ArkDialog.Title>\n <ArkDialog.Description\n v-if=\"$slots.description || props.description\"\n class=\"text-sm text-muted-foreground\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </ArkDialog.Description>\n </div>\n\n <!-- 默认插槽:补充正文(可选) -->\n <slot />\n\n <!-- 底部操作区:取消 outline,确认按 destructive 切换语义色;pending 时确认钮转 loading -->\n <div class=\"flex flex-col-reverse gap-2 sm:flex-row sm:justify-end\">\n <Button variant=\"outline\" :disabled=\"loading\" @click=\"handleCancel\">\n {{ props.cancelText }}\n </Button>\n <Button\n :variant=\"props.destructive ? 'destructive' : 'default'\"\n :disabled=\"loading\"\n @click=\"handleConfirm\"\n >\n <svg\n v-if=\"loading\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n class=\"size-4 animate-spin\"\n aria-hidden=\"true\"\n >\n <path d=\"M21 12a9 9 0 1 1-6.219-8.56\" />\n </svg>\n {{ props.confirmText }}\n </Button>\n </div>\n </ArkDialog.Content>\n </ArkDialog.Positioner>\n </ArkDialog.Root>\n</template>\n"
14
+ },
15
+ {
16
+ "path": "alert-dialog/index.ts",
17
+ "type": "registry:component",
18
+ "target": "components/ui/alert-dialog/index.ts",
19
+ "content": "export { default as AlertDialog } from \"./AlertDialog.vue\";\n"
20
+ }
21
+ ]
22
+ }
@@ -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,22 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "context-menu",
4
+ "type": "registry:ui",
5
+ "description": "右键菜单:单组件模式,items 描述菜单项(与 dropdown-menu 同构,含分组/标题/分隔线,支持嵌套),默认插槽为触发元素(ContextTrigger as-child,右键唤出并定位到指针处),内置键盘导航与选中回调。",
6
+ "registryDependencies": ["utils", "dropdown-menu"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "files": [
9
+ {
10
+ "path": "context-menu/ContextMenu.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/context-menu/ContextMenu.vue",
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { useAttrs } from \"vue\";\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\nimport { cn } from \"@/lib/utils\";\n// 与 dropdown-menu 同构:items 类型与渲染逻辑直接复用其实现(单一事实来源)\nimport MenuItems from \"../dropdown-menu/MenuItems.vue\";\nimport type { MenuItemOption } from \"../dropdown-menu/types\";\n\ndefineOptions({ name: \"ContextMenu\", inheritAttrs: false });\n\nconst props = defineProps({\n /** 菜单项描述列表,与 DropdownMenu 的 items 完全同构(item/label/separator/group 四种形态,group 可嵌套) */\n items: { type: Array as PropType<MenuItemOption[]>, required: true },\n});\n\n// 仅暴露选中事件;开合由触发元素上的右键(contextmenu)事件驱动,ark 内部管理状态\nconst emit = defineEmits<{\n /** 选中某个 item 时触发(对齐 DropdownMenu 的事件语义) */\n select: [details: { value: string }];\n}>();\n\n// attrs 转发到面板元素(Root 不渲染 DOM,避免 fallthrough 警告)\nconst attrs = useAttrs();\n\nfunction handleSelect(details: { value: string }) {\n emit(\"select\", details);\n}\n\n// 面板样式对齐 DropdownMenu 面板(token 化,暗色随主题变量自动切换)\nconst contentCls =\n \"bg-popover text-popover-foreground z-50 min-w-[8rem] overflow-hidden rounded-md border p-1 shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95\";\n</script>\n\n<template>\n <ArkMenu.Root @select=\"handleSelect\">\n <!-- 默认插槽 = 触发元素本身(ContextTrigger as-child 透传,右键唤出并定位到指针处) -->\n <ArkMenu.ContextTrigger as-child>\n <slot />\n </ArkMenu.ContextTrigger>\n\n <ArkMenu.Positioner class=\"z-50\">\n <ArkMenu.Content v-bind=\"attrs\" :class=\"cn(contentCls)\">\n <MenuItems :items=\"props.items\" />\n </ArkMenu.Content>\n </ArkMenu.Positioner>\n </ArkMenu.Root>\n</template>\n"
14
+ },
15
+ {
16
+ "path": "context-menu/index.ts",
17
+ "type": "registry:component",
18
+ "target": "components/ui/context-menu/index.ts",
19
+ "content": "export { default as ContextMenu } from \"./ContextMenu.vue\";\n// items 类型与 dropdown-menu 同构:直接 re-export 其 MenuItemOption,保持单一事实来源\nexport type { MenuItemOption } from \"../dropdown-menu\";\n"
20
+ }
21
+ ]
22
+ }
@@ -9,7 +9,7 @@
9
9
  "path": "currency-input/CurrencyInput.vue",
10
10
  "type": "registry:component",
11
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 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"
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
13
  },
14
14
  {
15
15
  "path": "currency-input/index.ts",
@@ -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
+ }