@tu-design/vue 0.4.0 → 0.4.1

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 (54) hide show
  1. package/README.md +74 -0
  2. package/dist/index.d.mts +54 -50
  3. package/dist/index.mjs +985 -874
  4. package/dist/registry/vue/alert-dialog.json +3 -3
  5. package/dist/registry/vue/alert.json +1 -1
  6. package/dist/registry/vue/avatar-group.json +1 -1
  7. package/dist/registry/vue/avatar.json +1 -1
  8. package/dist/registry/vue/badge.json +1 -1
  9. package/dist/registry/vue/button.json +2 -2
  10. package/dist/registry/vue/calendar.json +3 -3
  11. package/dist/registry/vue/card.json +1 -1
  12. package/dist/registry/vue/cascader.json +5 -5
  13. package/dist/registry/vue/checkbox.json +1 -1
  14. package/dist/registry/vue/context-menu.json +2 -2
  15. package/dist/registry/vue/currency-input.json +2 -2
  16. package/dist/registry/vue/date-picker.json +2 -2
  17. package/dist/registry/vue/date-range-picker.json +3 -3
  18. package/dist/registry/vue/date-shared.json +16 -2
  19. package/dist/registry/vue/dialog.json +3 -3
  20. package/dist/registry/vue/drawer.json +3 -3
  21. package/dist/registry/vue/dropdown-menu.json +4 -4
  22. package/dist/registry/vue/empty.json +1 -1
  23. package/dist/registry/vue/form-render.json +35 -34
  24. package/dist/registry/vue/form.json +2 -2
  25. package/dist/registry/vue/input.json +1 -1
  26. package/dist/registry/vue/label.json +1 -1
  27. package/dist/registry/vue/month-picker.json +2 -2
  28. package/dist/registry/vue/number-input.json +2 -2
  29. package/dist/registry/vue/overlay-shared.json +20 -0
  30. package/dist/registry/vue/password-input.json +1 -1
  31. package/dist/registry/vue/pin-input.json +1 -1
  32. package/dist/registry/vue/popconfirm.json +3 -3
  33. package/dist/registry/vue/popover.json +3 -3
  34. package/dist/registry/vue/progress.json +1 -1
  35. package/dist/registry/vue/radio-group.json +1 -1
  36. package/dist/registry/vue/registry.json +7 -1
  37. package/dist/registry/vue/select.json +4 -4
  38. package/dist/registry/vue/separator.json +1 -1
  39. package/dist/registry/vue/skeleton.json +1 -1
  40. package/dist/registry/vue/slider.json +1 -1
  41. package/dist/registry/vue/slot.json +3 -3
  42. package/dist/registry/vue/spin.json +1 -1
  43. package/dist/registry/vue/switch.json +1 -1
  44. package/dist/registry/vue/table-render.json +39 -11
  45. package/dist/registry/vue/tabs.json +1 -1
  46. package/dist/registry/vue/textarea.json +1 -1
  47. package/dist/registry/vue/toast.json +3 -3
  48. package/dist/registry/vue/tokens.json +2 -1
  49. package/dist/registry/vue/tooltip.json +3 -3
  50. package/dist/registry/vue/tree-select.json +5 -5
  51. package/dist/registry/vue/tree-shared.json +13 -12
  52. package/dist/registry/vue/week-picker.json +2 -2
  53. package/dist/registry/vue/year-picker.json +2 -2
  54. package/package.json +3 -2
@@ -3,18 +3,18 @@
3
3
  "name": "alert-dialog",
4
4
  "type": "registry:ui",
5
5
  "description": "确认弹窗单组件:v-model:open 控制显隐,title/description 传文案,@confirm/@cancel 处理确认与取消;确认处理器返回 Promise 时按钮进入 loading 并锁定 ESC/遮罩关闭,resolve 自动关闭、reject 保持打开;内容节点为 role=alertdialog。",
6
- "registryDependencies": ["button", "utils"],
6
+ "registryDependencies": ["button", "utils", "overlay-shared"],
7
7
  "dependencies": ["@ark-ui/vue@^5.39.2"],
8
8
  "files": [
9
9
  {
10
10
  "path": "alert-dialog/AlertDialog.vue",
11
11
  "type": "registry:component",
12
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"
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { Button } from \"@/components/ui/button\";\nimport { useConfirmPending } from \"../overlay-shared/useConfirmPending\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\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 { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n onChange: (open) => emit(\"update:open\", open),\n});\n\nfunction handleUpdate(open: boolean) {\n // pending 期间忽略一切关闭请求(走受控桥拒绝同步,弹窗保持打开)——\n // 与 Popconfirm 同款锁定方案;Root 仍保留 :close-on-escape/:close-on-interact-outside 双保险\n if (!open && loading.value) return;\n setOpen(open);\n}\n\n/** 关闭弹窗:走受控桥把 open 置 false,退出动画/焦点还原由 zag 处理 */\nfunction close() {\n handleUpdate(false);\n}\n\n// 确认 Promise pending 时锁定关闭通道(ESC/遮罩/取消按钮全部锁死),只能等 Promise 落定\nconst { loading, handleConfirm, handleCancel } = useConfirmPending({\n instance,\n emitConfirm: () => emit(\"confirm\"),\n emitCancel: () => 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-[var(--z-overlay)] 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=\"!loading\"\n :close-on-interact-outside=\"!loading\"\n @update:open=\"handleUpdate\"\n >\n <ArkDialog.Backdrop\n class=\"fixed inset-0 z-[var(--z-overlay)] 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\n class=\"fixed inset-0 z-[var(--z-overlay)] flex items-center justify-center p-4\"\n >\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
14
  },
15
15
  {
16
16
  "path": "alert-dialog/index.ts",
17
- "type": "registry:component",
17
+ "type": "registry:lib",
18
18
  "target": "components/ui/alert-dialog/index.ts",
19
19
  "content": "export { default as AlertDialog } from \"./AlertDialog.vue\";\n"
20
20
  }
@@ -14,7 +14,7 @@
14
14
  },
15
15
  {
16
16
  "path": "alert/index.ts",
17
- "type": "registry:component",
17
+ "type": "registry:lib",
18
18
  "target": "components/ui/alert/index.ts",
19
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
20
  }
@@ -13,7 +13,7 @@
13
13
  },
14
14
  {
15
15
  "path": "avatar-group/index.ts",
16
- "type": "registry:component",
16
+ "type": "registry:lib",
17
17
  "target": "components/ui/avatar-group/index.ts",
18
18
  "content": "export { default as AvatarGroup } from \"./AvatarGroup.vue\";\n"
19
19
  }
@@ -14,7 +14,7 @@
14
14
  },
15
15
  {
16
16
  "path": "avatar/index.ts",
17
- "type": "registry:component",
17
+ "type": "registry:lib",
18
18
  "target": "components/ui/avatar/index.ts",
19
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
  }
@@ -14,7 +14,7 @@
14
14
  },
15
15
  {
16
16
  "path": "badge/index.ts",
17
- "type": "registry:component",
17
+ "type": "registry:lib",
18
18
  "target": "components/ui/badge/index.ts",
19
19
  "content": "import { cva, type VariantProps } from \"class-variance-authority\";\n\nexport { default as Badge } from \"./Badge.vue\";\n\nexport const badgeVariants = cva(\n \"inline-flex items-center justify-center rounded-md border px-2 py-0.5 text-xs font-medium w-fit whitespace-nowrap shrink-0\",\n {\n variants: {\n variant: {\n default: \"bg-primary text-primary-foreground\",\n secondary: \"bg-secondary text-secondary-foreground\",\n destructive: \"bg-destructive text-white\",\n outline: \"text-foreground border border-input\",\n },\n },\n defaultVariants: {\n variant: \"default\",\n },\n },\n);\n\nexport type BadgeVariants = VariantProps<typeof badgeVariants>;\n"
20
20
  }
@@ -10,11 +10,11 @@
10
10
  "path": "button/Button.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/button/Button.vue",
13
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\nimport { Slot } from \"@/components/slot\";\nimport { buttonVariants, type ButtonVariants } from \"./index\";\n\ninterface Props {\n variant?: ButtonVariants[\"variant\"];\n size?: ButtonVariants[\"size\"];\n as?: string;\n asChild?: boolean;\n class?: string;\n}\n\nconst props = withDefaults(defineProps<Props>(), { as: \"button\" });\n</script>\n\n<template>\n <Slot\n v-if=\"props.asChild\"\n :class=\"cn(buttonVariants({ variant: props.variant, size: props.size }), props.class)\"\n >\n <slot />\n </Slot>\n <component\n v-else\n :is=\"props.as\"\n :class=\"cn(buttonVariants({ variant: props.variant, size: props.size }), props.class)\"\n >\n <slot name=\"icon\" />\n <slot />\n </component>\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\nimport { Slot } from \"@/components/ui/slot\";\nimport { buttonVariants, type ButtonVariants } from \"./index\";\n\ninterface Props {\n variant?: ButtonVariants[\"variant\"];\n size?: ButtonVariants[\"size\"];\n as?: string;\n asChild?: boolean;\n class?: string;\n}\n\nconst props = withDefaults(defineProps<Props>(), { as: \"button\" });\n</script>\n\n<template>\n <Slot\n v-if=\"props.asChild\"\n :class=\"cn(buttonVariants({ variant: props.variant, size: props.size }), props.class)\"\n >\n <slot />\n </Slot>\n <component\n v-else\n :is=\"props.as\"\n :class=\"cn(buttonVariants({ variant: props.variant, size: props.size }), props.class)\"\n >\n <slot name=\"icon\" />\n <slot />\n </component>\n</template>\n"
14
14
  },
15
15
  {
16
16
  "path": "button/index.ts",
17
- "type": "registry:component",
17
+ "type": "registry:lib",
18
18
  "target": "components/ui/button/index.ts",
19
19
  "content": "import { cva, type VariantProps } from \"class-variance-authority\";\n\nexport { default as Button } from \"./Button.vue\";\n\nexport const buttonVariants = cva(\n \"inline-flex select-none items-center justify-center gap-2 whitespace-nowrap rounded-lg text-sm font-medium transition-[color,background-color,border-color,box-shadow,transform] [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4 disabled:pointer-events-none disabled:opacity-50 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:ring-offset-background active:scale-[0.98]\",\n {\n variants: {\n variant: {\n default: \"bg-primary text-primary-foreground shadow-xs hover:bg-primary/90 hover:shadow-sm\",\n destructive: \"bg-destructive text-white shadow-xs hover:bg-destructive/90\",\n outline:\n \"border border-input bg-background hover:border-muted-foreground/25 hover:bg-muted\",\n secondary: \"bg-secondary text-secondary-foreground shadow-xs hover:bg-secondary/80\",\n ghost: \"hover:bg-muted\",\n link: \"text-primary underline-offset-4 hover:underline\",\n },\n size: {\n default: \"h-9 px-4 py-2\",\n sm: \"h-8 px-3\",\n lg: \"h-10 px-6\",\n icon: \"size-9\",\n },\n },\n defaultVariants: {\n variant: \"default\",\n size: \"default\",\n },\n },\n);\n\nexport type ButtonVariants = VariantProps<typeof buttonVariants>;\n"
20
20
  }
@@ -10,7 +10,7 @@
10
10
  "path": "calendar/Calendar.vue",
11
11
  "type": "registry:component",
12
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"
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 { cn } from \"@/lib/utils\";\nimport { CALENDAR_IN_PICKER, formatIsoDate, parseIsoDate } from \"../date-shared/shared\";\nimport CalendarBody from \"./CalendarBody.vue\";\n\nconst props = defineProps({\n /** 视图形态:day=日网格(可切月/年);standalone 时 month/year 同时派生视图锁定 */\n mode: { type: String as PropType<\"day\" | \"month\" | \"year\">, default: \"day\" },\n /** 日视图并排月数 */\n numOfMonths: { type: Number, default: 1 },\n /** 受控值(\"yyyy-MM-dd\");仅 standalone 独立形态生效,embedded 值归宿主 Picker */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n /** 非受控初值(仅 standalone) */\n defaultValue: { type: String, default: undefined },\n /** 可选下界(\"yyyy-MM-dd\",含当日;仅 standalone) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy-MM-dd\",含当日;仅 standalone) */\n max: { type: String, default: undefined },\n /** 不可选日期谓词(参数为 ark 的 DateValue;仅 standalone) */\n isDateUnavailable: {\n type: Function as PropType<(date: DateValue) => boolean>,\n default: undefined,\n },\n /** 文案与周起点跟随 locale(仅 standalone;embedded 随宿主 Picker) */\n locale: { type: String, default: \"zh-CN\" },\n /** 周选择形态:日视图下整周高亮(与 TWeekPicker 配套) */\n week: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n}>();\n\n// 双形态探测:Picker 弹层内(宿主 provide)为 embedded 内嵌形态(纯卡片内核);独立使用为 standalone 独立形态(自建 Root)\nconst standalone = !inject(CALENDAR_IN_PICKER, false);\n\n// standalone 时 month/year 形态即语义 → 派生视图锁定(day 不锁,保留月/年切换)\nconst viewLock = computed(() => (props.mode === \"day\" ? undefined : props.mode));\n\n// —— 受控桥(DatePicker 同款简化版,单值无 mirror 需求)——\nconst internalValue = ref<string | null>(props.defaultValue ?? null);\nconst selected = computed(() => {\n const raw = props.modelValue !== undefined ? props.modelValue : internalValue.value;\n return parseIsoDate(raw ?? \"\");\n});\n// zag value 为 DateValue[] 数组形态,单选语义收敛为 [date] | []\nconst rootValue = computed<DateValue[]>(() => (selected.value ? [selected.value] : []));\n\nconst minDate = computed(() => parseIsoDate(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoDate(props.max ?? \"\"));\n\nfunction handleValueUpdate(next: DateValue[]) {\n const value = next[0] ? formatIsoDate(next[0]) : null;\n internalValue.value = value;\n emit(\"update:modelValue\", value);\n}\n</script>\n\n<template>\n <!--\n standalone 独立形态:自建 Root。:open=\"true\" 恒开——独立卡片没有输入框/触发钮\n 去打开弹层,不恒开则 Content hidden 整卡不可见。沿用已验证的 Root > Content 直渲形态\n (无 Positioner:卡片非浮层,就地渲染)。\n 外层 div 承接 attrs(Ark Root 不透传 attrs,实测 class/id 会丢);w-fit 收缩包裹卡片宽度。\n -->\n <div v-if=\"standalone\" :class=\"cn('w-fit', $attrs.class)\">\n <ArkDatePicker.Root\n :model-value=\"rootValue\"\n :open=\"true\"\n :num-of-months=\"props.numOfMonths\"\n :min-view=\"viewLock\"\n :max-view=\"viewLock\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :is-date-unavailable=\"props.isDateUnavailable\"\n :locale=\"props.locale\"\n @update:model-value=\"handleValueUpdate\"\n >\n <ArkDatePicker.Content>\n <CalendarBody\n :mode=\"props.mode\"\n :num-of-months=\"props.numOfMonths\"\n :week=\"props.week\"\n :locale=\"props.locale\"\n />\n </ArkDatePicker.Content>\n </ArkDatePicker.Root>\n </div>\n\n <!-- embedded 内嵌形态:宿主 Picker 的 Root 供能,纯卡片内核 -->\n <CalendarBody\n v-else\n :mode=\"props.mode\"\n :num-of-months=\"props.numOfMonths\"\n :week=\"props.week\"\n :locale=\"props.locale\"\n />\n</template>\n"
14
14
  },
15
15
  {
16
16
  "path": "calendar/CalendarBody.vue",
@@ -22,11 +22,11 @@
22
22
  "path": "calendar/CalendarNav.vue",
23
23
  "type": "registry:component",
24
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"
25
+ "content": "<script setup lang=\"ts\">\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { cn } from \"@/lib/utils\";\n\n/**\n * 视图导航条(内部件)。必须渲染在 <ArkDatePicker.View> 子树内:\n * Prev/NextTrigger 的 view 参数由 View provide(ViewPropsContext),\n * 放在 View 外会落到默认 { view: \"day\" },month/year 视图下\n * GOTO.NEXT 被 machine guard 的 event.view 短路成 focusNextPage(翻页月,表现为无反应)。\n */\nconst props = defineProps({\n /** 导航条服务的视图,决定中间内容形态:day=ViewTrigger(上钻)/ month=年份 / year=年代 */\n view: { type: String as PropType<\"day\" | \"month\" | \"year\">, required: true },\n});\n\nconst viewControlCls = \"flex items-center justify-between px-1 pb-3\";\nconst navBtnCls =\n \"text-muted-foreground inline-flex size-8 items-center justify-center rounded-md outline-none hover:bg-accent disabled:cursor-not-allowed disabled:opacity-40\";\nconst viewTriggerCls =\n \"hover:bg-accent inline-flex items-center gap-1 rounded-[3px] px-3 py-1.5 text-sm font-semibold text-foreground outline-none transition-colors disabled:pointer-events-none\";\nconst viewTitleCls = \"text-sm font-semibold text-foreground\";\n\n/** 年代范围文本(zag 无现成 part,由 focusedValue.year 推算):2026 → \"2020 - 2029\" */\nfunction decadeRange(year: number | undefined): string {\n const start = Math.floor((year ?? 0) / 10) * 10;\n return `${start} - ${start + 9}`;\n}\n</script>\n\n<template>\n <ArkDatePicker.ViewControl :class=\"cn(viewControlCls, $attrs.class)\">\n <ArkDatePicker.PrevTrigger :class=\"navBtnCls\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n >\n <path d=\"m15 18-6-6 6-6\" />\n </svg>\n </ArkDatePicker.PrevTrigger>\n\n <ArkDatePicker.Context v-slot=\"context\">\n <!-- day:ViewTrigger 上钻钮(内容原样自 CalendarBody 迁入,视觉零回归) -->\n <ArkDatePicker.ViewTrigger v-if=\"props.view === 'day'\" :class=\"viewTriggerCls\">\n <ArkDatePicker.RangeText />\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-3.5 opacity-50\"\n >\n <path d=\"m7 15 5 5 5-5\" />\n <path d=\"m7 9 5-5 5 5\" />\n </svg>\n </ArkDatePicker.ViewTrigger>\n <!-- month:年份标题(ViewTrigger 承载——DatePicker 可上钻 year;\n 锁定组件下 zag getNextView 无下级 → 原生 disabled,点击钳制) -->\n <ArkDatePicker.ViewTrigger v-else-if=\"props.view === 'month'\" :class=\"viewTriggerCls\">\n {{ context.focusedValue?.year }}\n </ArkDatePicker.ViewTrigger>\n <!-- year:年代范围 -->\n <span v-else :class=\"viewTitleCls\">{{ decadeRange(context.focusedValue?.year) }}</span>\n </ArkDatePicker.Context>\n\n <ArkDatePicker.NextTrigger :class=\"navBtnCls\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n >\n <path d=\"m9 18 6-6-6-6\" />\n </svg>\n </ArkDatePicker.NextTrigger>\n </ArkDatePicker.ViewControl>\n</template>\n"
26
26
  },
27
27
  {
28
28
  "path": "calendar/index.ts",
29
- "type": "registry:component",
29
+ "type": "registry:lib",
30
30
  "target": "components/ui/calendar/index.ts",
31
31
  "content": "export { default as Calendar } from \"./Calendar.vue\";\n"
32
32
  }
@@ -13,7 +13,7 @@
13
13
  },
14
14
  {
15
15
  "path": "card/index.ts",
16
- "type": "registry:component",
16
+ "type": "registry:lib",
17
17
  "target": "components/ui/card/index.ts",
18
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"
19
19
  }
@@ -3,30 +3,30 @@
3
3
  "name": "cascader",
4
4
  "type": "registry:ui",
5
5
  "description": "级联选择:一站式 props 驱动,多列联动、勾选级联、路径回显与多标签。",
6
- "registryDependencies": ["tree-shared", "utils", "date-shared"],
6
+ "registryDependencies": ["tree-shared", "utils", "date-shared", "overlay-shared"],
7
7
  "dependencies": ["@ark-ui/vue@^5.39.2"],
8
8
  "files": [
9
9
  {
10
10
  "path": "cascader/Cascader.vue",
11
11
  "type": "registry:component",
12
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"
13
+ "content": "<script setup lang=\"ts\">\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, nextTick, ref, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { controlCls } from \"../date-shared/shared\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport ChevronIcon from \"../tree-shared/ChevronIcon.vue\";\nimport ClearIcon from \"../tree-shared/ClearIcon.vue\";\nimport ValueTags from \"../tree-shared/ValueTags.vue\";\nimport {\n createTreeMate,\n type CheckStrategy,\n type Key,\n type TreeNode,\n type TreeOption,\n} from \"../tree-shared\";\nimport { nextActiveKey, type MoveKey } from \"../tree-shared/keyboard\";\nimport CascaderPanel from \"./CascaderPanel.vue\";\n\nconst props = defineProps({\n /** 树形选项(key 必填,label 展示名,children 子级) */\n options: { type: Array as PropType<TreeOption[]>, required: true },\n /** 受控值:单选为叶子 key,multiple/checkable 为 key 数组;undefined 走内部非受控 */\n modelValue: {\n type: [String, Number, Array] as PropType<Key | Key[] | undefined>,\n default: undefined,\n },\n defaultValue: {\n type: [String, Number, Array] as PropType<Key | Key[] | undefined>,\n default: undefined,\n },\n /** 多选(值恒为数组) */\n multiple: { type: Boolean, default: false },\n /** 勾选模式(隐含 multiple,值恒为数组) */\n checkable: { type: Boolean, default: false },\n /** 级联勾选:父子联动(默认 false,对齐 naive-ui) */\n cascade: { type: Boolean, default: false },\n /** 勾选策略:all=全选节点 child=仅叶子 parent=仅父级 */\n checkStrategy: { type: String as PropType<CheckStrategy>, default: \"all\" },\n /** 下级展开触发方式 */\n expandTrigger: { type: String as PropType<\"click\" | \"hover\">, default: \"click\" },\n /** 回显是否拼接完整路径 */\n showPath: { type: Boolean, default: true },\n /** 路径拼接分隔符 */\n separator: { type: String, default: \" / \" },\n /** 展示清空按钮 */\n clearable: { type: Boolean, default: false },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n placeholder: { type: String, default: \"请选择\" },\n /** 多选时最多展示的标签数,超出折叠为 +N */\n maxTagCount: { type: Number, default: undefined },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: Key | Key[] | undefined];\n /** @deprecated 请改用 update:open(v-model:open);下一个 minor 移除 */\n \"update:show\": [open: boolean];\n \"update:open\": [open: boolean];\n}>();\n\nif (import.meta.env.DEV && getCurrentInstance()?.vnode.props?.[\"onUpdate:show\"]) {\n console.warn(\"[tu-design] <Cascader> update:show 已弃用,请改用 update:open(v-model:open)。\");\n}\n\n// attrs(id/aria-*)转发给触发器,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\nconst toArrayValue = (v: Key | Key[] | undefined): Key[] =>\n Array.isArray(v) ? v : v === undefined || v === null ? [] : [v];\n\nconst treeMate = computed(() => createTreeMate(props.options, { ignoreEmptyChildren: true }));\nconst isMulti = computed(() => props.multiple || props.checkable);\n\n// —— 受控桥接(Select 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst internalValue = ref<Key | Key[] | undefined>(props.defaultValue);\nconst value = computed(() =>\n props.modelValue !== undefined ? props.modelValue : internalValue.value,\n);\nconst selectedKeys = computed<Key[]>(() => toArrayValue(value.value));\n\nconst checkedState = computed<{ checked: Key[]; indeterminate: Key[] }>(() => {\n if (!props.checkable) return { checked: [], indeterminate: [] };\n const merged = treeMate.value.getCheckedKeys(toArrayValue(value.value), {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n return { checked: merged.checkedKeys, indeterminate: merged.indeterminateKeys };\n});\n\n// 勾选选项运行时变化:值集合按新选项归一\nwatch(\n () => [props.cascade, props.checkStrategy] as const,\n () => {\n if (!props.checkable) return;\n const merged = treeMate.value.getCheckedKeys(toArrayValue(value.value), {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n internalValue.value = merged.checkedKeys;\n emit(\"update:modelValue\", merged.checkedKeys);\n },\n);\n\n// —— 弹层开合(点击/键盘 ↓ 显式驱动,保证各环境一致)——\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => {\n emit(\"update:open\", open);\n emit(\"update:show\", open);\n },\n});\n\nfunction openFromInput() {\n if (props.disabled || isOpen.value) return;\n syncPanelWidth();\n setOpen(true);\n}\n\n// —— 面板宽度对齐触发器 ——\nconst triggerEl = ref<HTMLElement | null>(null);\nconst panelMinWidth = ref(\"0px\");\nfunction syncPanelWidth() {\n panelMinWidth.value = `${triggerEl.value?.offsetWidth ?? 0}px`;\n}\n\nfunction commitValue(next: Key | Key[] | undefined) {\n internalValue.value = next;\n emit(\"update:modelValue\", next);\n}\n\nfunction handleClear() {\n commitValue(isMulti.value ? [] : undefined);\n}\n\nfunction removeTag(key: Key) {\n if (props.checkable) {\n const merged = treeMate.value.uncheck(key, toArrayValue(value.value), {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n commitValue(merged.checkedKeys);\n return;\n }\n commitValue(selectedKeys.value.filter((k) => k !== key));\n}\n\n// —— 展开路径(单路径:展开新列即收敛到该节点路径)——\nconst expandedPath = ref<Key[]>([]);\nconst columns = computed<TreeNode[][]>(() => {\n const result: TreeNode[][] = [treeMate.value.treeNodes];\n let current = treeMate.value.treeNodes;\n for (const key of expandedPath.value) {\n const node = current.find((n) => n.key === key);\n if (!node?.children?.length) break;\n current = node.children;\n result.push(current);\n }\n return result;\n});\n\nconst expandedPathSet = computed(() => new Set(expandedPath.value));\n\nfunction isExpanded(node: TreeNode): boolean {\n return expandedPathSet.value.has(node.key);\n}\n\nfunction handleExpand(node: TreeNode) {\n expandedPath.value = treeMate.value.getPath(node.key).keyPath;\n}\n\nfunction toggleCheck(node: TreeNode) {\n const current = toArrayValue(value.value);\n const op = current.includes(node.key) ? \"uncheck\" : \"check\";\n const merged = treeMate.value[op](node.key, current, {\n cascade: props.cascade,\n checkStrategy: props.checkStrategy,\n });\n commitValue(merged.checkedKeys);\n}\n\nfunction handleSelect(node: TreeNode) {\n // 级联语义:非叶子仅展开,叶子才选中/勾选\n if (node.children?.length) {\n handleExpand(node);\n return;\n }\n if (props.checkable) {\n toggleCheck(node);\n return;\n }\n if (props.multiple) {\n const current = selectedKeys.value;\n commitValue(\n current.includes(node.key) ? current.filter((k) => k !== node.key) : [...current, node.key],\n );\n return;\n }\n commitValue(node.key);\n setOpen(false);\n}\n\n// —— 回显:showPath 拼 keyPath 标签 ——\nfunction labelOf(node: TreeNode): string {\n return (node.rawNode as TreeOption).label ?? String(node.key);\n}\n\nfunction pathLabel(key: Key): string {\n const path = treeMate.value.getPath(key).keyPath;\n return path\n .map((k) => {\n const node = treeMate.value.getNode(k);\n return node ? labelOf(node as unknown as TreeNode) : String(k);\n })\n .join(props.separator);\n}\n\nfunction displayLabel(key: Key): string {\n const node = treeMate.value.getNode(key);\n if (!node) return \"\";\n return props.showPath ? pathLabel(key) : labelOf(node as unknown as TreeNode);\n}\n\nconst singleLabel = computed(() =>\n isMulti.value ? \"\" : displayLabel(selectedKeys.value[0]!) || \"\",\n);\n\nconst tags = computed(() =>\n selectedKeys.value\n .map((key) => ({ key, label: displayLabel(key) }))\n .filter((t) => t.label !== \"\"),\n);\n\nconst hasValue = computed(() => tags.value.length > 0);\n\n// —— 键盘导航(↑↓ 在 activeKey 所在列内移动,不跨列;←→/Enter 由下方分支处理)——\nconst activeKey = ref<Key | null>(null);\nconst MOVE_KEYS: MoveKey[] = [\"ArrowDown\", \"ArrowUp\", \"Home\", \"End\"];\n\n// activeKey 落在哪一列(无 active 或找不到时视为第 0 列)\nfunction activeColumn(): TreeNode[] {\n for (const col of columns.value) {\n if (col.some((n) => n.key === activeKey.value)) return col;\n }\n return columns.value[0] ?? [];\n}\n\nfunction scrollActiveIntoView() {\n nextTick(() => {\n document\n .querySelector('[data-part=\"cascader-panel\"] [data-part=\"tree-node\"][data-active]')\n ?.scrollIntoView?.({ block: \"nearest\" });\n });\n}\n\nfunction handleKeydown(e: KeyboardEvent) {\n if (props.disabled) return;\n if (!isOpen.value) {\n if (e.key === \"ArrowDown\" || e.key === \"Enter\") {\n e.preventDefault();\n openFromInput();\n }\n return;\n }\n if ((MOVE_KEYS as string[]).includes(e.key)) {\n e.preventDefault();\n activeKey.value = nextActiveKey(activeColumn(), activeKey.value, e.key as MoveKey);\n scrollActiveIntoView();\n return;\n }\n if (e.key === \"ArrowRight\") {\n e.preventDefault();\n const node = activeColumn().find((n) => n.key === activeKey.value);\n if (node?.children?.length) {\n handleExpand(node);\n const firstChild = node.children.find((c) => !c.disabled);\n if (firstChild) activeKey.value = firstChild.key;\n }\n return;\n }\n if (e.key === \"ArrowLeft\") {\n e.preventDefault();\n const node = activeColumn().find((n) => n.key === activeKey.value);\n const parent = node?.parent;\n if (parent && !parent.ignored) {\n expandedPath.value = treeMate.value.getPath(parent.key).keyPath.slice(0, -1);\n activeKey.value = parent.key;\n }\n return;\n }\n if (e.key === \"Enter\") {\n e.preventDefault();\n const node = activeColumn().find((n) => n.key === activeKey.value);\n if (node && !node.disabled) handleSelect(node);\n }\n}\n\n// 弹层开合时重置键盘游标与展开路径\nwatch(isOpen, (open) => {\n activeKey.value = null;\n if (open) syncPanelWidth();\n else expandedPath.value = [];\n});\n</script>\n\n<template>\n <ArkPopover.Root :open=\"isOpen\" @update:open=\"setOpen\">\n <ArkPopover.Anchor as-child>\n <div\n ref=\"triggerEl\"\n v-bind=\"$attrs\"\n data-part=\"trigger\"\n role=\"button\"\n tabindex=\"0\"\n :aria-expanded=\"isOpen\"\n aria-haspopup=\"true\"\n :aria-disabled=\"props.disabled || undefined\"\n :class=\"\n cn(\n controlCls,\n 'min-h-9 cursor-pointer gap-2 px-3 py-1.5 text-sm',\n props.disabled && 'cursor-not-allowed opacity-50',\n props.class,\n )\n \"\n @click=\"openFromInput\"\n @keydown=\"handleKeydown\"\n >\n <template v-if=\"isMulti\">\n <ValueTags\n v-if=\"tags.length\"\n :values=\"tags\"\n :max-tag-count=\"props.maxTagCount\"\n :disabled=\"!!props.disabled\"\n @remove=\"removeTag\"\n />\n <span v-if=\"!tags.length\" class=\"truncate text-muted-foreground\">{{\n props.placeholder\n }}</span>\n </template>\n <template v-else>\n <span v-if=\"singleLabel\" class=\"truncate\">{{ singleLabel }}</span>\n <span v-else class=\"truncate text-muted-foreground\">{{ props.placeholder }}</span>\n </template>\n <span class=\"ml-auto flex shrink-0 items-center gap-1\">\n <span\n v-if=\"props.clearable && hasValue && !props.disabled\"\n role=\"button\"\n data-part=\"clear\"\n class=\"text-muted-foreground hover:text-foreground\"\n aria-label=\"清空\"\n @click.stop=\"handleClear\"\n >\n <ClearIcon />\n </span>\n <ChevronIcon\n :class=\"\n cn('text-muted-foreground transition-transform', isOpen ? '-rotate-90' : 'rotate-90')\n \"\n />\n </span>\n </div>\n </ArkPopover.Anchor>\n <Teleport to=\"body\">\n <ArkPopover.Positioner>\n <ArkPopover.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground z-[var(--z-overlay)] rounded-md border p-0 shadow-md outline-none data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95',\n )\n \"\n :style=\"{ minWidth: panelMinWidth }\"\n @keydown=\"handleKeydown\"\n >\n <CascaderPanel\n :columns=\"columns\"\n :expand-trigger=\"props.expandTrigger\"\n :selected-keys=\"isMulti ? selectedKeys : []\"\n :checkable=\"props.checkable\"\n :checked-keys=\"checkedState.checked\"\n :indeterminate-keys=\"checkedState.indeterminate\"\n :active-key=\"activeKey\"\n :is-expanded=\"isExpanded\"\n @expand=\"handleExpand\"\n @select=\"handleSelect\"\n @check=\"toggleCheck\"\n />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </Teleport>\n </ArkPopover.Root>\n</template>\n"
14
14
  },
15
15
  {
16
16
  "path": "cascader/CascaderPanel.vue",
17
17
  "type": "registry:component",
18
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"
19
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport ChevronIcon from \"../tree-shared/ChevronIcon.vue\";\nimport type { Key, TreeNode, TreeOption } from \"../tree-shared\";\n\nconst props = defineProps({\n /** 列数据:columns[0] 为根层,后续每列为展开路径的子层 */\n columns: { type: Array as PropType<TreeNode[][]>, required: true },\n /** 下级展开触发方式 */\n expandTrigger: { type: String as PropType<\"click\" | \"hover\">, default: \"click\" },\n /** 已选中的 key(单选叶子 / 多选勾选值) */\n selectedKeys: { type: Array as PropType<Key[]>, default: () => [] },\n /** 勾选模式(显示 checkbox) */\n checkable: { type: Boolean, default: false },\n checkedKeys: { type: Array as PropType<Key[]>, default: () => [] },\n indeterminateKeys: { type: Array as PropType<Key[]>, default: () => [] },\n /** 键盘游标所在节点 */\n activeKey: { type: [String, Number] as PropType<Key | null>, default: null },\n /** 节点是否处于展开路径上(父组件传入,用于箭头朝向) */\n isExpanded: { type: Function as PropType<(node: TreeNode) => boolean>, required: true },\n});\n\nconst emit = defineEmits<{\n /** 展开 node 的下级列 */\n expand: [node: TreeNode];\n /** 点击行(非叶子→展开,叶子→选中/勾选,语义由父组件解释) */\n select: [node: TreeNode];\n /** 勾选切换 */\n check: [node: TreeNode];\n}>();\n\nfunction labelOf(node: TreeNode): string {\n return (node.rawNode as TreeOption).label ?? String(node.key);\n}\n\n// 每个可见节点都会查选中/勾选态:先 Set 化,避免对数组逐项 includes 的 O(n·k)\nconst selectedSet = computed(() => new Set(props.selectedKeys));\nconst checkedSet = computed(() => new Set(props.checkedKeys));\nconst indeterminateSet = computed(() => new Set(props.indeterminateKeys));\n\nfunction rowClick(node: TreeNode) {\n if (node.disabled) return;\n emit(\"select\", node);\n}\n\nfunction expandHover(node: TreeNode) {\n if (props.expandTrigger === \"hover\" && node.children?.length && !node.disabled) {\n emit(\"expand\", node);\n }\n}\n\nfunction toggleCheck(node: TreeNode) {\n if (!node.disabled) emit(\"check\", node);\n}\n</script>\n\n<template>\n <div data-part=\"cascader-panel\" :class=\"cn('flex overflow-x-auto', $attrs.class)\">\n <div\n v-for=\"(column, ci) in props.columns\"\n :key=\"ci\"\n role=\"listbox\"\n data-part=\"column\"\n :aria-label=\"`第 ${ci + 1} 列`\"\n class=\"max-h-[280px] min-w-36 overflow-y-auto border-r border-border py-1 last:border-r-0\"\n >\n <div\n v-for=\"node in column\"\n :key=\"node.key\"\n data-part=\"tree-node\"\n :data-key=\"node.key\"\n role=\"option\"\n :aria-selected=\"selectedSet.has(node.key)\"\n :aria-checked=\"props.checkable ? checkedSet.has(node.key) : undefined\"\n :aria-expanded=\"node.children?.length ? props.isExpanded(node) : undefined\"\n :aria-disabled=\"node.disabled || undefined\"\n :data-selected=\"selectedSet.has(node.key) || undefined\"\n :data-checked=\"checkedSet.has(node.key) || undefined\"\n :data-indeterminate=\"indeterminateSet.has(node.key) || undefined\"\n :data-active=\"props.activeKey === node.key || undefined\"\n class=\"flex cursor-pointer items-center gap-1 px-3 py-1.5 text-sm outline-none hover:bg-accent data-[active]:bg-accent data-[disabled]:cursor-not-allowed data-[disabled]:opacity-50\"\n @click=\"rowClick(node)\"\n @pointerenter=\"expandHover(node)\"\n >\n <span\n v-if=\"props.checkable\"\n data-part=\"checkbox\"\n class=\"flex size-4 shrink-0 items-center justify-center rounded-sm border\"\n :class=\"\n checkedSet.has(node.key)\n ? 'border-primary bg-primary text-primary-foreground'\n : 'border-input'\n \"\n @click.stop=\"toggleCheck(node)\"\n >\n <svg\n v-if=\"checkedSet.has(node.key)\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n class=\"size-3\"\n >\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n <svg\n v-else-if=\"indeterminateSet.has(node.key)\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n class=\"size-3\"\n >\n <path d=\"M5 12h14\" />\n </svg>\n </span>\n <span class=\"flex-1 truncate\">{{ labelOf(node) }}</span>\n <ChevronIcon\n v-if=\"node.children?.length\"\n :class=\"\n cn('size-3.5 shrink-0 text-muted-foreground', props.isExpanded(node) && 'rotate-90')\n \"\n />\n </div>\n <div v-if=\"!column.length\" class=\"px-3 py-1.5 text-sm text-muted-foreground\">无数据</div>\n </div>\n </div>\n</template>\n"
20
20
  },
21
21
  {
22
22
  "path": "cascader/index.ts",
23
- "type": "registry:component",
23
+ "type": "registry:lib",
24
24
  "target": "components/ui/cascader/index.ts",
25
25
  "content": "export { default as Cascader } from \"./Cascader.vue\";\nexport type { CheckStrategy, Key, TreeOption } from \"../tree-shared\";\n"
26
26
  },
27
27
  {
28
28
  "path": "cascader/types.ts",
29
- "type": "registry:component",
29
+ "type": "registry:lib",
30
30
  "target": "components/ui/cascader/types.ts",
31
31
  "content": "export type { CheckStrategy, Key, TreeOption } from \"../tree-shared\";\n"
32
32
  }
@@ -14,7 +14,7 @@
14
14
  },
15
15
  {
16
16
  "path": "checkbox/index.ts",
17
- "type": "registry:component",
17
+ "type": "registry:lib",
18
18
  "target": "components/ui/checkbox/index.ts",
19
19
  "content": "export { default as Checkbox } from \"./Checkbox.vue\";\n"
20
20
  }
@@ -10,11 +10,11 @@
10
10
  "path": "context-menu/ContextMenu.vue",
11
11
  "type": "registry:component",
12
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"
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-[var(--z-overlay)] 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-[var(--z-overlay)]\">\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
14
  },
15
15
  {
16
16
  "path": "context-menu/index.ts",
17
- "type": "registry:component",
17
+ "type": "registry:lib",
18
18
  "target": "components/ui/context-menu/index.ts",
19
19
  "content": "export { default as ContextMenu } from \"./ContextMenu.vue\";\n// items 类型与 dropdown-menu 同构:直接 re-export 其 MenuItemOption,保持单一事实来源\nexport type { MenuItemOption } from \"../dropdown-menu\";\n"
20
20
  }
@@ -13,13 +13,13 @@
13
13
  },
14
14
  {
15
15
  "path": "currency-input/index.ts",
16
- "type": "registry:component",
16
+ "type": "registry:lib",
17
17
  "target": "components/ui/currency-input/index.ts",
18
18
  "content": "export { default as CurrencyInput } from \"./CurrencyInput.vue\";\nexport { formatCurrency, parseCurrency, type CurrencyUnit } from \"./utils\";\n"
19
19
  },
20
20
  {
21
21
  "path": "currency-input/utils.ts",
22
- "type": "registry:component",
22
+ "type": "registry:lib",
23
23
  "target": "components/ui/currency-input/utils.ts",
24
24
  "content": "/** 货币单位:万/元/角/分(组件枚举固定,换算基准为整数分) */\nexport type CurrencyUnit = \"万\" | \"元\" | \"角\" | \"分\";\n\n/** 各单位折合整数分:分=1、角=10、元=100、万=1000000 */\nconst UNIT_FEN_EXP: Record<CurrencyUnit, number> = { 万: 6, 元: 2, 角: 1, 分: 0 };\n\n/**\n * 解析输入文本为 valueUnit 单位的数值(number|null)。\n * 全程十进制字符串移位(BigInt),仅在超出整数分精度时一次四舍五入;\n * 白名单 ^\\d*(\\.\\d*)?$,负号/非法字符/无数字一律 null。\n */\nexport function parseCurrency(\n raw: string,\n labelUnit: CurrencyUnit,\n valueUnit: CurrencyUnit,\n): number | null {\n if (!/^\\d*(\\.\\d*)?$/.test(raw) || !/\\d/.test(raw)) return null;\n const [intPart, fracPart = \"\"] = raw.split(\".\");\n const digits = BigInt((intPart || \"0\") + fracPart);\n const shift = UNIT_FEN_EXP[labelUnit] - fracPart.length;\n let fen: bigint;\n if (shift >= 0) {\n fen = digits * 10n ** BigInt(shift);\n } else {\n const divisor = 10n ** BigInt(-shift);\n const q = digits / divisor;\n const r = digits % divisor;\n fen = r * 2n >= divisor ? q + 1n : q;\n }\n return Number(fen) / 10 ** UNIT_FEN_EXP[valueUnit];\n}\n\n/**\n * 受控值(valueUnit 单位)反算为 labelUnit 单位的回显文本。\n * 值先取整到整数分(吸收浮点噪声),再做十进制移位并去尾零。\n */\nexport function formatCurrency(\n value: number,\n valueUnit: CurrencyUnit,\n labelUnit: CurrencyUnit,\n): string {\n if (!Number.isFinite(value)) return \"\";\n const negative = value < 0;\n const fen = BigInt(Math.abs(Math.round(value * 10 ** UNIT_FEN_EXP[valueUnit])));\n const exp = UNIT_FEN_EXP[labelUnit];\n let text: string;\n if (exp === 0) {\n text = fen.toString();\n } else {\n const s = fen.toString().padStart(exp + 1, \"0\");\n const frac = s.slice(-exp).replace(/0+$/, \"\");\n text = frac ? `${s.slice(0, -exp)}.${frac}` : s.slice(0, -exp);\n }\n return negative ? `-${text}` : text;\n}\n"
25
25
  }
@@ -10,11 +10,11 @@
10
10
  "path": "date-picker/DatePicker.vue",
11
11
  "type": "registry:component",
12
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"
13
+ "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide } from \"vue\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport PickerShell from \"../date-shared/PickerShell.vue\";\nimport { CALENDAR_IN_PICKER, formatIsoDate, parseIsoDate } from \"../date-shared/shared\";\nimport { usePickerBridge } from \"../date-shared/usePickerBridge\";\n\nconst props = defineProps({\n /** 受控值(\"yyyy-MM-dd\");undefined 走内部非受控,null 表示空 */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n 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\nconst { rootValue, isOpen, setOpen, handleValueUpdate } = usePickerBridge({\n modelValue: () => props.modelValue,\n defaultValue: () => props.defaultValue,\n open: () => props.open,\n defaultOpen: () => props.defaultOpen,\n disabled: () => props.disabled,\n readOnly: () => props.readOnly,\n parse: parseIsoDate,\n toPublicValue: formatIsoDate,\n onUpdateModelValue: (value) => emit(\"update:modelValue\", value),\n onUpdateOpen: (open) => emit(\"update:open\", open),\n});\n\nconst minDate = computed(() => parseIsoDate(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoDate(props.max ?? \"\"));\n</script>\n\n<template>\n <PickerShell\n v-bind=\"$attrs\"\n :model-value=\"rootValue\"\n :open=\"isOpen\"\n :locale=\"props.locale\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :is-date-unavailable=\"props.isDateUnavailable\"\n :close-on-select=\"props.closeOnSelect\"\n :read-only=\"props.readOnly\"\n :disabled=\"props.disabled\"\n :invalid=\"props.invalid\"\n :placeholder=\"props.placeholder\"\n :class=\"props.class\"\n :format=\"formatIsoDate\"\n :parse=\"parseIsoDate\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <TCalendar />\n </PickerShell>\n</template>\n"
14
14
  },
15
15
  {
16
16
  "path": "date-picker/index.ts",
17
- "type": "registry:component",
17
+ "type": "registry:lib",
18
18
  "target": "components/ui/date-picker/index.ts",
19
19
  "content": "export { default as DatePicker } from \"./DatePicker.vue\";\n"
20
20
  }
@@ -3,18 +3,18 @@
3
3
  "name": "date-range-picker",
4
4
  "type": "registry:ui",
5
5
  "description": "日期范围选择器:双月日历弹层(月/年视图切换),点选起点与终点,值以 [\"yyyy-MM-dd\", \"yyyy-MM-dd\"] 有序元组受控,空值归一 null。",
6
- "registryDependencies": ["utils", "date-shared", "calendar"],
6
+ "registryDependencies": ["utils", "date-shared", "calendar", "overlay-shared"],
7
7
  "dependencies": ["@ark-ui/vue@^5.39.2"],
8
8
  "files": [
9
9
  {
10
10
  "path": "date-range-picker/DateRangePicker.vue",
11
11
  "type": "registry:component",
12
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"
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, shallowRef, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport CalendarIcon from \"../date-shared/CalendarIcon.vue\";\nimport ClearIcon from \"../date-shared/ClearIcon.vue\";\nimport {\n CALENDAR_IN_PICKER,\n controlCls,\n formatIsoDate,\n iconBtnCls,\n parseIsoDate,\n parseIsoRange,\n} from \"../date-shared/shared\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\n\nconst props = defineProps({\n /** 受控值 [start, end](\"yyyy-MM-dd\",start ≤ end);undefined 走内部非受控,null 表示空 */\n modelValue: {\n type: Array as unknown as PropType<[string, string] | null | undefined>,\n default: undefined,\n },\n defaultValue: {\n type: Array as unknown as PropType<[string, string] | undefined>,\n default: undefined,\n },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n placeholder: { type: String, default: \"请选择日期范围\" },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 可选下界(\"yyyy-MM-dd\",含当日) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy-MM-dd\",含当日) */\n max: { type: String, default: undefined },\n /** 不可选日期谓词(参数为 ark 的 DateValue) */\n isDateUnavailable: {\n type: Function as PropType<(date: DateValue) => boolean>,\n default: undefined,\n },\n /** 选完终点后是否自动关弹层 */\n closeOnSelect: { type: Boolean, default: true },\n /** 日视图并排月数 */\n numOfMonths: { type: Number, default: 2 },\n /** 文案与周起点跟随 locale(zh-CN 默认周一起始) */\n locale: { type: String, default: \"zh-CN\" },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: [string, string] | null];\n \"update:open\": [open: boolean];\n}>();\n\n// attrs(id/aria-*)转发给真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root,值归本 Picker)\nprovide(CALENDAR_IN_PICKER, true);\n\n// —— 受控桥接(mirror 模式)——\n// range 是两步交互:zag 受控模式下内部值读 prop,父组件回显滞后会吃掉 pending start,\n// 导致第二次点击永远变成新起点。因此恒以内部镜像(zag 原生 0–2 元素 DateValue[])为准,\n// 外部 modelValue 赋值经 watch 覆盖 mirror;对外 emit 归一为 [ISO, ISO] | null。\n// shallowRef:internalValue 恒整体替换/读取,且规避 ref 深层 unwrap 把 DateValue\n// 类联合展开成结构类型(ZonedDateTime 丢 #private)导致 vue-tsc 不再匹配 DateValue[]\nconst internalValue = shallowRef<DateValue[]>([]);\nconst rootValue = computed(() => internalValue.value);\n\nfunction normalize(next: DateValue[]): [string, string] | null {\n return next.length === 2 ? [formatIsoDate(next[0]), formatIsoDate(next[1])] : null;\n}\n\nfunction handleValueUpdate(next: DateValue[]) {\n internalValue.value = next;\n emit(\"update:modelValue\", normalize(next));\n}\n\nfunction sameTuple(a: [string, string] | null, b: [string, string] | null | undefined): boolean {\n if (a === null || b === undefined) return a === null && (b === null || b === undefined);\n return Array.isArray(b) && a[0] === b[0] && a[1] === b[1];\n}\n\nwatch(\n () => props.modelValue,\n (v) => {\n // 回环守卫:emit 值原样回流(含 pending 期父组件回传 null)则跳过,避免打断选择\n if (sameTuple(normalize(internalValue.value), v)) return;\n internalValue.value = parseIsoRange(v) ?? [];\n },\n { immediate: true },\n);\n\n// 非受控初值(modelValue 未传时以 defaultValue 种子)\nif (props.modelValue === undefined && props.defaultValue) {\n internalValue.value = parseIsoRange(props.defaultValue) ?? [];\n}\n\nconst minDate = computed(() => parseIsoDate(props.min ?? \"\"));\nconst maxDate = computed(() => parseIsoDate(props.max ?? \"\"));\n\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// 点击/键盘 ↓ 输入框即开弹层(zag 默认仅 Trigger 开,openOnClick prop 默认关闭;\n// 显式驱动保证各环境行为一致并显式走受控 emit)\nfunction openFromInput() {\n if (props.disabled || props.readOnly || isOpen.value) return;\n setOpen(true);\n}\n</script>\n\n<template>\n <!-- outside-day-selectable:zag getDayTableCellState 的 getUnitDuration 把 months 强制置 1,\n 多月视图下第二月起所有当月格被误判 outside-range 而禁用;此开关对冲(见 calendar/CalendarBody 注释) -->\n <ArkDatePicker.Root\n :model-value=\"rootValue\"\n selection-mode=\"range\"\n :num-of-months=\"props.numOfMonths\"\n outside-day-selectable\n :open=\"isOpen\"\n :locale=\"props.locale\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :is-date-unavailable=\"props.isDateUnavailable\"\n :close-on-select=\"props.closeOnSelect\"\n :read-only=\"props.readOnly\"\n :disabled=\"props.disabled\"\n :format=\"formatIsoDate\"\n :parse=\"parseIsoDate\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"props.invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :index=\"0\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"text-muted-foreground size-3.5 shrink-0\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n <path d=\"m12 5 7 7-7 7\" />\n </svg>\n <ArkDatePicker.Input\n :index=\"1\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <ClearIcon />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport 到 body:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患。 -->\n <Teleport to=\"body\">\n <ArkDatePicker.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkDatePicker.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-[var(--z-overlay)] rounded-md border shadow-md',\n )\n \"\n >\n <TCalendar :num-of-months=\"props.numOfMonths\" />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
14
14
  },
15
15
  {
16
16
  "path": "date-range-picker/index.ts",
17
- "type": "registry:component",
17
+ "type": "registry:lib",
18
18
  "target": "components/ui/date-range-picker/index.ts",
19
19
  "content": "export { default as DateRangePicker } from \"./DateRangePicker.vue\";\n"
20
20
  }
@@ -2,7 +2,9 @@
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "date-shared",
4
4
  "type": "registry:ui",
5
- "description": "日期家族共享模块:ISO 值域解析(日期/月/年/区间)与日历样式常量。",
5
+ "description": "日期家族共享模块:ISO 值域解析(日期/月/年/区间)、日历样式常量与单值选择器外壳(PickerShell/usePickerBridge)。",
6
+ "registryDependencies": ["utils", "overlay-shared"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
6
8
  "files": [
7
9
  {
8
10
  "path": "date-shared/CalendarIcon.vue",
@@ -17,10 +19,22 @@
17
19
  "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
20
  },
19
21
  {
20
- "path": "date-shared/shared.ts",
22
+ "path": "date-shared/PickerShell.vue",
21
23
  "type": "registry:component",
24
+ "target": "components/ui/date-shared/PickerShell.vue",
25
+ "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { provide } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport CalendarIcon from \"./CalendarIcon.vue\";\nimport ClearIcon from \"./ClearIcon.vue\";\nimport { CALENDAR_IN_PICKER, controlCls, iconBtnCls } from \"./shared\";\n\n/** 单值日期族(Date/Month/Year/Week)共用外壳:触发器 + 清空/日历按钮 + 弹层容器。 */\ndefineOptions({ inheritAttrs: false });\n\nconst props = defineProps({\n modelValue: { type: Array as PropType<DateValue[]>, required: true },\n open: { type: Boolean, required: true },\n locale: { type: String, default: \"zh-CN\" },\n min: { type: Object as PropType<DateValue | undefined>, default: undefined },\n max: { type: Object as PropType<DateValue | undefined>, default: undefined },\n /** 不可选日期谓词(参数为 ark 的 DateValue) */\n isDateUnavailable: {\n type: Function as PropType<(date: DateValue) => boolean>,\n default: undefined,\n },\n closeOnSelect: { type: Boolean, default: true },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n placeholder: { type: String, default: \"请选择\" },\n /** 锁定视图粒度(Month/Year 选择器);undefined 走 Ark 默认 day 视图 */\n minView: { type: String as PropType<\"day\" | \"month\" | \"year\" | undefined>, default: undefined },\n maxView: { type: String as PropType<\"day\" | \"month\" | \"year\" | undefined>, default: undefined },\n format: { type: Function as PropType<(date: DateValue) => string>, required: true },\n parse: { type: Function as PropType<(raw: string) => DateValue | undefined>, required: true },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: DateValue[]];\n \"update:open\": [open: boolean];\n}>();\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root)\nprovide(CALENDAR_IN_PICKER, true);\n\nfunction openFromInput() {\n if (props.disabled || props.readOnly || props.open) return;\n emit(\"update:open\", true);\n}\n</script>\n\n<template>\n <ArkDatePicker.Root\n :model-value=\"modelValue\"\n :open=\"open\"\n :locale=\"locale\"\n :min-view=\"minView\"\n :max-view=\"maxView\"\n :min=\"min\"\n :max=\"max\"\n :is-date-unavailable=\"isDateUnavailable\"\n :close-on-select=\"closeOnSelect\"\n :read-only=\"readOnly\"\n :disabled=\"disabled\"\n :format=\"format\"\n :parse=\"parse\"\n @update:model-value=\"emit('update:modelValue', $event)\"\n @update:open=\"emit('update:open', $event)\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :placeholder=\"placeholder\"\n :aria-invalid=\"invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <ClearIcon />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport 到 body:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患。 -->\n <Teleport to=\"body\">\n <ArkDatePicker.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkDatePicker.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-[var(--z-overlay)] rounded-md border shadow-md',\n )\n \"\n >\n <slot />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
26
+ },
27
+ {
28
+ "path": "date-shared/shared.ts",
29
+ "type": "registry:lib",
22
30
  "target": "components/ui/date-shared/shared.ts",
23
31
  "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"
32
+ },
33
+ {
34
+ "path": "date-shared/usePickerBridge.ts",
35
+ "type": "registry:lib",
36
+ "target": "components/ui/date-shared/usePickerBridge.ts",
37
+ "content": "import type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { computed, ref } from \"vue\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\n\nexport interface PickerBridgeOptions {\n /** 受控值:undefined 走内部非受控,null 表示空 */\n modelValue: () => string | null | undefined;\n defaultValue: () => string | null | undefined;\n open: () => boolean | undefined;\n defaultOpen: () => boolean;\n disabled: () => boolean | undefined;\n readOnly: () => boolean | undefined;\n /** 对外字符串值 → zag DateValue */\n parse: (raw: string) => DateValue | undefined;\n /** 非受控初值归一(如周选择器归一到所在周起始日) */\n normalizeDefault?: (raw: string) => string | null;\n /** zag DateValue → 对外字符串值 */\n toPublicValue: (date: DateValue) => string | null;\n onUpdateModelValue: (value: string | null) => void;\n onUpdateOpen: (open: boolean) => void;\n}\n\n/**\n * 单值日期选择器的受控桥接:值以内部 ref 为镜像、Root 恒走受控,\n * 开合复用 useControlledBoolean,openFromInput 统一「点击/↓ 输入框即开」。\n */\nexport function usePickerBridge(options: PickerBridgeOptions) {\n const initial = options.defaultValue();\n const internalValue = ref<string | null>(\n initial ? (options.normalizeDefault?.(initial) ?? initial) : null,\n );\n\n const selected = computed(() => {\n const raw = options.modelValue() !== undefined ? options.modelValue() : internalValue.value;\n return options.parse(raw ?? \"\");\n });\n // zag value 为 DateValue[] 数组形态,单选语义收敛为 [date] | []\n const rootValue = computed<DateValue[]>(() => (selected.value ? [selected.value] : []));\n\n const { isOpen, setOpen } = useControlledBoolean({\n controlled: options.open,\n defaultValue: options.defaultOpen,\n onChange: options.onUpdateOpen,\n });\n\n function handleValueUpdate(next: DateValue[]) {\n const value = next[0] ? options.toPublicValue(next[0]) : null;\n internalValue.value = value;\n options.onUpdateModelValue(value);\n }\n\n // 点击/键盘 ↓ 输入框即开弹层(zag 默认仅 Trigger 开,openOnClick 默认关闭;\n // 显式驱动保证各环境行为一致并显式走受控 emit)\n function openFromInput() {\n if (options.disabled() || options.readOnly() || isOpen.value) return;\n setOpen(true);\n }\n\n return { rootValue, isOpen, setOpen, openFromInput, handleValueUpdate };\n}\n"
24
38
  }
25
39
  ]
26
40
  }