@tu-design/vue 0.5.8 → 0.5.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/dist/index.d.mts +242 -158
  2. package/dist/index.mjs +1296 -516
  3. package/dist/registry/vue/alert-dialog.json +2 -2
  4. package/dist/registry/vue/alert.json +1 -1
  5. package/dist/registry/vue/avatar-group.json +1 -1
  6. package/dist/registry/vue/avatar.json +1 -1
  7. package/dist/registry/vue/badge.json +1 -1
  8. package/dist/registry/vue/button.json +1 -1
  9. package/dist/registry/vue/calendar.json +1 -1
  10. package/dist/registry/vue/card.json +1 -1
  11. package/dist/registry/vue/cascader.json +2 -2
  12. package/dist/registry/vue/checkbox.json +2 -2
  13. package/dist/registry/vue/context-menu.json +1 -1
  14. package/dist/registry/vue/currency-input.json +1 -1
  15. package/dist/registry/vue/date-picker.json +1 -1
  16. package/dist/registry/vue/date-range-picker.json +2 -2
  17. package/dist/registry/vue/date-shared.json +2 -2
  18. package/dist/registry/vue/dialog.json +2 -2
  19. package/dist/registry/vue/drawer.json +2 -2
  20. package/dist/registry/vue/dropdown-menu.json +1 -1
  21. package/dist/registry/vue/empty.json +1 -1
  22. package/dist/registry/vue/form-render.json +9 -9
  23. package/dist/registry/vue/form.json +2 -2
  24. package/dist/registry/vue/icon-shared.json +8 -2
  25. package/dist/registry/vue/input.json +2 -2
  26. package/dist/registry/vue/label.json +1 -1
  27. package/dist/registry/vue/month-picker.json +1 -1
  28. package/dist/registry/vue/number-input.json +1 -1
  29. package/dist/registry/vue/overlay-shared.json +1 -1
  30. package/dist/registry/vue/password-input.json +1 -1
  31. package/dist/registry/vue/pin-input.json +1 -1
  32. package/dist/registry/vue/popconfirm.json +1 -1
  33. package/dist/registry/vue/popover.json +2 -2
  34. package/dist/registry/vue/progress.json +1 -1
  35. package/dist/registry/vue/radio-group.json +1 -1
  36. package/dist/registry/vue/registry.json +54 -54
  37. package/dist/registry/vue/select.json +1 -1
  38. package/dist/registry/vue/separator.json +1 -1
  39. package/dist/registry/vue/skeleton.json +1 -1
  40. package/dist/registry/vue/slider.json +1 -1
  41. package/dist/registry/vue/slot.json +1 -1
  42. package/dist/registry/vue/spin.json +1 -1
  43. package/dist/registry/vue/switch.json +1 -1
  44. package/dist/registry/vue/table-render.json +24 -11
  45. package/dist/registry/vue/tabs.json +1 -1
  46. package/dist/registry/vue/textarea.json +2 -2
  47. package/dist/registry/vue/timeline.json +1 -1
  48. package/dist/registry/vue/toast.json +1 -1
  49. package/dist/registry/vue/tokens.json +2 -2
  50. package/dist/registry/vue/tooltip.json +1 -1
  51. package/dist/registry/vue/tree-select.json +2 -2
  52. package/dist/registry/vue/tree-shared.json +1 -1
  53. package/dist/registry/vue/utils.json +1 -1
  54. package/dist/registry/vue/week-picker.json +1 -1
  55. package/dist/registry/vue/year-picker.json +1 -1
  56. package/package.json +1 -1
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "alert-dialog",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "确认弹窗单组件:v-model:open 控制显隐,title/description 传文案,@confirm/@cancel 处理确认与取消;确认处理器返回 Promise 时按钮进入 loading 并锁定 ESC/遮罩关闭,resolve 自动关闭、reject 保持打开;内容节点为 role=alertdialog。",
7
7
  "registryDependencies": ["button", "utils", "overlay-shared"],
@@ -11,7 +11,7 @@
11
11
  "path": "alert-dialog/AlertDialog.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/alert-dialog/AlertDialog.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, useAttrs } 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\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds);复用 dialog machine,parts 同 Dialog\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\"content\", \"title\", \"description\", \"trigger\", \"closeTrigger\", \"positioner\", \"backdrop\"],\n});\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 :ids=\"rootIds\"\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
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, useAttrs } 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\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds);复用 dialog machine,parts 同 Dialog\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\"content\", \"title\", \"description\", \"trigger\", \"closeTrigger\", \"positioner\", \"backdrop\"],\n});\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-modal,60)] 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 :ids=\"rootIds\"\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-modal,60)] 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-modal,60)] 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"
15
15
  },
16
16
  {
17
17
  "path": "alert-dialog/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "alert",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "语义化警示条,支持五种变体、内置图标与可关闭交互。",
7
7
  "registryDependencies": ["icon-shared", "utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "avatar-group",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "头像组,数量折叠、悬停展开与垂直排列。",
7
7
  "registryDependencies": ["utils", "avatar"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "avatar",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "头像,支持尺寸/形状、加载占位与失败回退(Ark UI)。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "badge",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "轻量状态徽标,支持四种变体。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "button",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "带变体与尺寸的按钮,支持 as 标签切换与 asChild 组合。",
7
7
  "registryDependencies": ["utils", "slot"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "calendar",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "日历(TCalendar):紧凑日历卡。Picker 弹层内为 embedded 内嵌形态(TDatePicker/TDateRangePicker 自动挂靠,纯卡片内核);独立使用即 standalone 独立形态(自带日历状态与 v-model,恒开展示)。",
7
7
  "registryDependencies": ["icon-shared", "utils", "date-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "card",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "卡片容器:单组件 API,title/description 头部 + 命名插槽(cover/action/footer/header),支持尺寸、视觉变体、分段分隔与可关闭。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "cascader",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "级联选择:一站式 props 驱动,多列联动、勾选级联、路径回显与多标签。",
7
7
  "registryDependencies": ["icon-shared", "tree-shared", "utils", "date-shared", "overlay-shared"],
@@ -11,7 +11,7 @@
11
11
  "path": "cascader/Cascader.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/cascader/Cascader.vue",
14
- "content": "<script setup lang=\"ts\">\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport type { PopoverRootProps } from \"@ark-ui/vue/popover\";\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, nextTick, ref, useAttrs, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { controlCls } from \"../date-shared/shared\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\nimport ChevronIcon from \"../icon-shared/ChevronIcon.vue\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\nimport ValueTags from \"../tree-shared/ValueTags.vue\";\n\n// ids 全量覆盖(无冒号):ArkPopover 浮层载体,规避 wujie patch getElementById\n// 对 zag 缺省冒号 id 的 SyntaxError 刷屏(详注见 useOverlayIds)\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"anchor\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"arrow\",\n ],\n});\nimport {\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 /** Ark Popover Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed */\n positioning: {\n type: Object as PropType<PopoverRootProps[\"positioning\"]>,\n default: undefined,\n },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: Key | Key[] | undefined];\n /** @deprecated 请改用 update:open(v-model:open);下一个 minor 移除 */\n \"update:show\": [open: boolean];\n \"update:open\": [open: boolean];\n}>();\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\n// —— 沙箱适配(机制详注见 useSandboxOverlay / sandbox.ts):Teleport 目标降级\n// (shadow DOM / wujie graft → 应用挂载容器,避免面板落入 iframe body)+\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位,fixed 唯一正确解);\n// 无 to prop,面板恒传送 ——\nconst teleportTarget = useSandboxTeleportTarget(() => undefined);\nconst rootPositioning = computed(() =>\n withSandboxStrategy(props.positioning, { ...props.positioning }),\n);\n\nfunction openFromInput() {\n if (props.disabled || isOpen.value) return;\n syncPanelWidth();\n setOpen(true);\n}\n\n// —— 面板宽度对齐触发器 ——\nconst triggerEl = ref<HTMLElement | null>(null);\nconst panelMinWidth = ref(\"0px\");\nfunction syncPanelWidth() {\n panelMinWidth.value = `${triggerEl.value?.offsetWidth ?? 0}px`;\n}\n\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\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :positioning=\"rootPositioning\"\n @update:open=\"setOpen\"\n >\n <ArkPopover.Anchor as-child>\n <div\n ref=\"triggerEl\"\n v-bind=\"$attrs\"\n data-part=\"trigger\"\n role=\"button\"\n tabindex=\"0\"\n :aria-expanded=\"isOpen\"\n aria-haspopup=\"true\"\n :aria-disabled=\"props.disabled || undefined\"\n :class=\"\n cn(\n controlCls,\n 'min-h-9 cursor-pointer gap-2 px-3 py-1.5 text-sm',\n props.disabled && 'cursor-not-allowed opacity-50',\n props.class,\n )\n \"\n @click=\"openFromInput\"\n @keydown=\"handleKeydown\"\n >\n <template v-if=\"isMulti\">\n <ValueTags\n v-if=\"tags.length\"\n :values=\"tags\"\n :max-tag-count=\"props.maxTagCount\"\n :disabled=\"!!props.disabled\"\n @remove=\"removeTag\"\n />\n <span v-if=\"!tags.length\" class=\"truncate text-muted-foreground\">{{\n props.placeholder\n }}</span>\n </template>\n <template v-else>\n <span v-if=\"singleLabel\" class=\"truncate\">{{ singleLabel }}</span>\n <span v-else class=\"truncate text-muted-foreground\">{{ props.placeholder }}</span>\n </template>\n <span class=\"ml-auto flex shrink-0 items-center gap-1\">\n <span\n v-if=\"props.clearable && hasValue && !props.disabled\"\n role=\"button\"\n data-part=\"clear\"\n class=\"text-muted-foreground hover:text-foreground\"\n aria-label=\"清空\"\n @click.stop=\"handleClear\"\n >\n <CloseIcon class=\"size-4 shrink-0\" />\n </span>\n <ChevronIcon\n :class=\"\n cn(\n 'size-4 shrink-0 text-muted-foreground transition-transform',\n isOpen ? '-rotate-90' : 'rotate-90',\n )\n \"\n />\n </span>\n </div>\n </ArkPopover.Anchor>\n <Teleport :to=\"teleportTarget\">\n <ArkPopover.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkPopover.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground z-[var(--z-overlay)] rounded-md border p-0 shadow-md outline-none data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95',\n )\n \"\n :style=\"{ minWidth: panelMinWidth }\"\n @keydown=\"handleKeydown\"\n >\n <CascaderPanel\n :columns=\"columns\"\n :expand-trigger=\"props.expandTrigger\"\n :selected-keys=\"isMulti ? selectedKeys : []\"\n :checkable=\"props.checkable\"\n :checked-keys=\"checkedState.checked\"\n :indeterminate-keys=\"checkedState.indeterminate\"\n :active-key=\"activeKey\"\n :is-expanded=\"isExpanded\"\n @expand=\"handleExpand\"\n @select=\"handleSelect\"\n @check=\"toggleCheck\"\n />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </Teleport>\n </ArkPopover.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport type { PopoverRootProps } from \"@ark-ui/vue/popover\";\nimport type { PropType } from \"vue\";\nimport { computed, getCurrentInstance, nextTick, ref, useAttrs, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { controlCls } from \"../date-shared/shared\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\nimport ChevronIcon from \"../icon-shared/ChevronIcon.vue\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\nimport ValueTags from \"../tree-shared/ValueTags.vue\";\n\n// ids 全量覆盖(无冒号):ArkPopover 浮层载体,规避 wujie patch getElementById\n// 对 zag 缺省冒号 id 的 SyntaxError 刷屏(详注见 useOverlayIds)\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"anchor\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"arrow\",\n ],\n});\nimport {\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 /** Ark Popover Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed */\n positioning: {\n type: Object as PropType<PopoverRootProps[\"positioning\"]>,\n default: undefined,\n },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: Key | Key[] | undefined];\n /** @deprecated 请改用 update:open(v-model:open);下一个 minor 移除 */\n \"update:show\": [open: boolean];\n \"update:open\": [open: boolean];\n}>();\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\n// —— 沙箱适配(机制详注见 useSandboxOverlay / sandbox.ts):Teleport 目标降级\n// (shadow DOM / wujie graft → 应用挂载容器,避免面板落入 iframe body)+\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位,fixed 唯一正确解);\n// 无 to prop,面板恒传送 ——\nconst teleportTarget = useSandboxTeleportTarget(() => undefined);\nconst rootPositioning = computed(() =>\n withSandboxStrategy(props.positioning, { ...props.positioning }),\n);\n\nfunction openFromInput() {\n if (props.disabled || isOpen.value) return;\n syncPanelWidth();\n setOpen(true);\n}\n\n// —— 面板宽度对齐触发器 ——\nconst triggerEl = ref<HTMLElement | null>(null);\nconst panelMinWidth = ref(\"0px\");\nfunction syncPanelWidth() {\n panelMinWidth.value = `${triggerEl.value?.offsetWidth ?? 0}px`;\n}\n\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\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :positioning=\"rootPositioning\"\n @update:open=\"setOpen\"\n >\n <ArkPopover.Anchor as-child>\n <div\n ref=\"triggerEl\"\n v-bind=\"$attrs\"\n data-part=\"trigger\"\n role=\"button\"\n tabindex=\"0\"\n :aria-expanded=\"isOpen\"\n aria-haspopup=\"true\"\n :aria-disabled=\"props.disabled || undefined\"\n :class=\"\n cn(\n controlCls,\n 'min-h-9 cursor-pointer gap-2 px-3 py-1.5 text-sm',\n props.disabled && 'cursor-not-allowed opacity-50',\n props.class,\n )\n \"\n @click=\"openFromInput\"\n @keydown=\"handleKeydown\"\n >\n <template v-if=\"isMulti\">\n <ValueTags\n v-if=\"tags.length\"\n :values=\"tags\"\n :max-tag-count=\"props.maxTagCount\"\n :disabled=\"!!props.disabled\"\n @remove=\"removeTag\"\n />\n <span v-if=\"!tags.length\" class=\"truncate text-muted-foreground\">{{\n props.placeholder\n }}</span>\n </template>\n <template v-else>\n <span v-if=\"singleLabel\" class=\"truncate\">{{ singleLabel }}</span>\n <span v-else class=\"truncate text-muted-foreground\">{{ props.placeholder }}</span>\n </template>\n <span class=\"ml-auto flex shrink-0 items-center gap-1\">\n <span\n v-if=\"props.clearable && hasValue && !props.disabled\"\n role=\"button\"\n data-part=\"clear\"\n class=\"text-muted-foreground hover:text-foreground\"\n aria-label=\"清空\"\n @click.stop=\"handleClear\"\n >\n <CloseIcon class=\"size-4 shrink-0\" />\n </span>\n <ChevronIcon\n :class=\"\n cn(\n 'size-4 shrink-0 text-muted-foreground transition-transform',\n isOpen ? '-rotate-90' : 'rotate-90',\n )\n \"\n />\n </span>\n </div>\n </ArkPopover.Anchor>\n <Teleport :to=\"teleportTarget\">\n <ArkPopover.Positioner class=\"z-[var(--z-modal,60)]\">\n <ArkPopover.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground z-[var(--z-modal,60)] rounded-md border p-0 shadow-md outline-none data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95',\n )\n \"\n :style=\"{ minWidth: panelMinWidth }\"\n @keydown=\"handleKeydown\"\n >\n <CascaderPanel\n :columns=\"columns\"\n :expand-trigger=\"props.expandTrigger\"\n :selected-keys=\"isMulti ? selectedKeys : []\"\n :checkable=\"props.checkable\"\n :checked-keys=\"checkedState.checked\"\n :indeterminate-keys=\"checkedState.indeterminate\"\n :active-key=\"activeKey\"\n :is-expanded=\"isExpanded\"\n @expand=\"handleExpand\"\n @select=\"handleSelect\"\n @check=\"toggleCheck\"\n />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </Teleport>\n </ArkPopover.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "cascader/CascaderPanel.vue",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "checkbox",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "复选框:基于 Ark UI Checkbox 原语,支持标签插槽、受控/非受控与禁用。",
7
7
  "registryDependencies": ["utils"],
@@ -11,7 +11,7 @@
11
11
  "path": "checkbox/Checkbox.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/checkbox/Checkbox.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { Checkbox as ArkCheckbox } from \"@ark-ui/vue/checkbox\";\nimport { cn } from \"@/lib/utils\";\n\n// checked 用 default: undefined 禁用 Boolean casting(Dialog 同款约定);\n// \"indeterminate\" 对齐 Ark UI CheckedState,用于表格全选等半选语义(S10)\nconst props = defineProps({\n checked: {\n type: [Boolean, String] as PropType<boolean | \"indeterminate\" | undefined>,\n default: undefined,\n },\n defaultChecked: { type: Boolean, default: false },\n disabled: { type: Boolean, default: false },\n /** 原生表单提交的字段名(透传 HiddenInput,与 RadioGroup 对齐) */\n name: { type: String, default: undefined },\n /** 关联的 form id */\n form: { type: String, default: undefined },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:checked\": [checked: boolean] }>();\n\n// 对 Root 恒走受控模式,非受控语义由内部 ref 实现(Dialog 同款)\nconst internalChecked = ref<boolean>(props.defaultChecked);\nconst isChecked = computed(() => props.checked ?? internalChecked.value);\n\nfunction handleUpdate(checked: boolean | \"indeterminate\") {\n const next = checked === \"indeterminate\" ? false : checked;\n internalChecked.value = next;\n emit(\"update:checked\", next);\n}\n</script>\n\n<template>\n <ArkCheckbox.Root\n :checked=\"isChecked\"\n :disabled=\"props.disabled\"\n :name=\"props.name\"\n :form=\"props.form\"\n :class=\"cn('inline-flex items-center gap-2', props.class)\"\n @update:checked=\"handleUpdate\"\n >\n <ArkCheckbox.HiddenInput />\n <ArkCheckbox.Control\n class=\"border-input data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground data-[state=checked]:border-primary focus-visible:border-ring focus-visible:ring-ring/50 peer size-4 shrink-0 rounded-[4px] border bg-transparent shadow-xs transition-shadow outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50\"\n >\n <ArkCheckbox.Indicator class=\"flex items-center justify-center text-current\">\n <!-- 半选态(data-state=indeterminate)显示短横线,选中态显示对勾 -->\n <svg\n v-if=\"isChecked === 'indeterminate'\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n stroke-linecap=\"round\"\n class=\"size-3.5\"\n >\n <path d=\"M5 12h14\" />\n </svg>\n <svg\n v-else\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-3.5\"\n >\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n </ArkCheckbox.Indicator>\n </ArkCheckbox.Control>\n <ArkCheckbox.Label v-if=\"$slots.default\" class=\"text-sm leading-none font-medium select-none\">\n <slot />\n </ArkCheckbox.Label>\n </ArkCheckbox.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { Checkbox as ArkCheckbox } from \"@ark-ui/vue/checkbox\";\nimport { cn } from \"@/lib/utils\";\n\n// checked 用 default: undefined 禁用 Boolean casting(Dialog 同款约定);\n// \"indeterminate\" 对齐 Ark UI CheckedState,用于表格全选等半选语义\nconst props = defineProps({\n checked: {\n type: [Boolean, String] as PropType<boolean | \"indeterminate\" | undefined>,\n default: undefined,\n },\n defaultChecked: { type: Boolean, default: false },\n disabled: { type: Boolean, default: false },\n /** 原生表单提交的字段名(透传 HiddenInput,与 RadioGroup 对齐) */\n name: { type: String, default: undefined },\n /** 关联的 form id */\n form: { type: String, default: undefined },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:checked\": [checked: boolean] }>();\n\n// 对 Root 恒走受控模式,非受控语义由内部 ref 实现(Dialog 同款)\nconst internalChecked = ref<boolean>(props.defaultChecked);\nconst isChecked = computed(() => props.checked ?? internalChecked.value);\n\nfunction handleUpdate(checked: boolean | \"indeterminate\") {\n const next = checked === \"indeterminate\" ? false : checked;\n internalChecked.value = next;\n emit(\"update:checked\", next);\n}\n</script>\n\n<template>\n <ArkCheckbox.Root\n :checked=\"isChecked\"\n :disabled=\"props.disabled\"\n :name=\"props.name\"\n :form=\"props.form\"\n :class=\"cn('inline-flex items-center gap-2', props.class)\"\n @update:checked=\"handleUpdate\"\n >\n <ArkCheckbox.HiddenInput />\n <ArkCheckbox.Control\n class=\"border-input data-[state=checked]:bg-primary data-[state=checked]:text-primary-foreground data-[state=checked]:border-primary focus-visible:border-ring focus-visible:ring-ring/50 peer size-4 shrink-0 rounded-[4px] border bg-transparent shadow-xs transition-shadow outline-none focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50\"\n >\n <ArkCheckbox.Indicator class=\"flex items-center justify-center text-current\">\n <!-- 半选态(data-state=indeterminate)显示短横线,选中态显示对勾 -->\n <svg\n v-if=\"isChecked === 'indeterminate'\"\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n stroke-linecap=\"round\"\n class=\"size-3.5\"\n >\n <path d=\"M5 12h14\" />\n </svg>\n <svg\n v-else\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"3\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-3.5\"\n >\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n </ArkCheckbox.Indicator>\n </ArkCheckbox.Control>\n <ArkCheckbox.Label v-if=\"$slots.default\" class=\"text-sm leading-none font-medium select-none\">\n <slot />\n </ArkCheckbox.Label>\n </ArkCheckbox.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "checkbox/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "context-menu",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "右键菜单:单组件模式,items 描述菜单项(与 dropdown-menu 同构,含分组/标题/分隔线,支持嵌套),默认插槽为触发元素(ContextTrigger as-child,右键唤出并定位到指针处),内置键盘导航与选中回调。",
7
7
  "registryDependencies": ["overlay-shared", "utils", "dropdown-menu"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "currency-input",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "金额输入框:内置万/元/角/分单位后缀,labelUnit 输入单位与 valueUnit 存储单位自动换算(整数分最小精度),值以 number|null 受控。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "date-picker",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "日期选择器:输入框 + 日历弹层(月/年视图切换),支持手动键入/清空/min-max 边界/不可选谓词,值以 \"yyyy-MM-dd\" 字符串受控。",
7
7
  "registryDependencies": ["utils", "date-shared", "calendar"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "date-range-picker",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "日期范围选择器:双月日历弹层(月/年视图切换),点选起点与终点,值以 [\"yyyy-MM-dd\", \"yyyy-MM-dd\"] 有序元组受控,空值归一 null。",
7
7
  "registryDependencies": ["icon-shared", "utils", "date-shared", "calendar", "overlay-shared"],
@@ -11,7 +11,7 @@
11
11
  "path": "date-range-picker/DateRangePicker.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/date-range-picker/DateRangePicker.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide, shallowRef, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport CalendarIcon from \"../icon-shared/CalendarIcon.vue\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\nimport {\n CALENDAR_IN_PICKER,\n controlCls,\n formatIsoDate,\n iconBtnCls,\n parseIsoDate,\n parseIsoRange,\n} from \"../date-shared/shared\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\nimport type { PickerPositioning } from \"../date-shared/positioning\";\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 /** Ark DatePicker Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed */\n positioning: {\n type: Object as PropType<PickerPositioning>,\n default: undefined,\n },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: [string, 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// —— 沙箱适配(机制详注见 useSandboxOverlay / sandbox.ts):Teleport 目标降级\n// (shadow DOM / wujie graft → 应用挂载容器,避免面板落入 iframe body)+\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位,fixed 唯一正确解);\n// 无 to prop,面板恒传送 ——\nconst teleportTarget = useSandboxTeleportTarget(() => undefined);\nconst rootPositioning = computed(() =>\n withSandboxStrategy(props.positioning, { ...props.positioning }),\n);\n\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 :positioning=\"rootPositioning\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"props.invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :index=\"0\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"text-muted-foreground size-3.5 shrink-0\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n <path d=\"m12 5 7 7-7 7\" />\n </svg>\n <ArkDatePicker.Input\n :index=\"1\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <CloseIcon class=\"size-4\" />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon class=\"size-4\" />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患;\n 目标经沙箱适配降级(shadow DOM / wujie graft → 应用挂载容器) -->\n <Teleport :to=\"teleportTarget\">\n <ArkDatePicker.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkDatePicker.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-[var(--z-overlay)] rounded-md border shadow-md',\n )\n \"\n >\n <TCalendar :num-of-months=\"props.numOfMonths\" />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide, shallowRef, watch } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport CalendarIcon from \"../icon-shared/CalendarIcon.vue\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\nimport {\n CALENDAR_IN_PICKER,\n controlCls,\n formatIsoDate,\n iconBtnCls,\n parseIsoDate,\n parseIsoRange,\n} from \"../date-shared/shared\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\nimport type { PickerPositioning } from \"../date-shared/positioning\";\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 /** Ark DatePicker Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed */\n positioning: {\n type: Object as PropType<PickerPositioning>,\n default: undefined,\n },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: [string, 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// —— 沙箱适配(机制详注见 useSandboxOverlay / sandbox.ts):Teleport 目标降级\n// (shadow DOM / wujie graft → 应用挂载容器,避免面板落入 iframe body)+\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位,fixed 唯一正确解);\n// 无 to prop,面板恒传送 ——\nconst teleportTarget = useSandboxTeleportTarget(() => undefined);\nconst rootPositioning = computed(() =>\n withSandboxStrategy(props.positioning, { ...props.positioning }),\n);\n\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 :positioning=\"rootPositioning\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"props.invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :index=\"0\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"text-muted-foreground size-3.5 shrink-0\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n <path d=\"m12 5 7 7-7 7\" />\n </svg>\n <ArkDatePicker.Input\n :index=\"1\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <CloseIcon class=\"size-4\" />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon class=\"size-4\" />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患;\n 目标经沙箱适配降级(shadow DOM / wujie graft → 应用挂载容器) -->\n <Teleport :to=\"teleportTarget\">\n <ArkDatePicker.Positioner class=\"z-[var(--z-modal,60)]\">\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-modal,60)] rounded-md border shadow-md',\n )\n \"\n >\n <TCalendar :num-of-months=\"props.numOfMonths\" />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "date-range-picker/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "date-shared",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "日期家族共享模块:ISO 值域解析(日期/月/年/区间)、日历样式常量与单值选择器外壳(PickerShell/usePickerBridge)。",
7
7
  "registryDependencies": ["icon-shared", "utils", "overlay-shared"],
@@ -11,7 +11,7 @@
11
11
  "path": "date-shared/PickerShell.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/date-shared/PickerShell.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport type { DatePickerRootProps } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport CalendarIcon from \"../icon-shared/CalendarIcon.vue\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\nimport { CALENDAR_IN_PICKER, controlCls, iconBtnCls } from \"./shared\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\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 /** Ark DatePicker Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed */\n positioning: {\n type: Object as PropType<DatePickerRootProps[\"positioning\"]>,\n default: undefined,\n },\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\n// —— 沙箱适配(机制详注见 useSandboxOverlay / sandbox.ts):Teleport 目标降级\n// (shadow DOM / wujie graft → 应用挂载容器,避免面板落入 iframe body)+\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位,fixed 唯一正确解);\n// 覆盖 Date/Month/Year/Week 四个单值日期组件,无 to prop,面板恒传送 ——\nconst teleportTarget = useSandboxTeleportTarget(() => undefined);\nconst rootPositioning = computed(() =>\n withSandboxStrategy(props.positioning, { ...props.positioning }),\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 :positioning=\"rootPositioning\"\n @update:model-value=\"emit('update:modelValue', $event)\"\n @update:open=\"emit('update:open', $event)\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :placeholder=\"placeholder\"\n :aria-invalid=\"invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <CloseIcon class=\"size-4\" />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon class=\"size-4\" />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患;\n 目标经沙箱适配降级(shadow DOM / wujie graft → 应用挂载容器) -->\n <Teleport :to=\"teleportTarget\">\n <ArkDatePicker.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkDatePicker.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-[var(--z-overlay)] rounded-md border shadow-md',\n )\n \"\n >\n <slot />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport type { DatePickerRootProps } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport CalendarIcon from \"../icon-shared/CalendarIcon.vue\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\nimport { CALENDAR_IN_PICKER, controlCls, iconBtnCls } from \"./shared\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\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 /** Ark DatePicker Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed */\n positioning: {\n type: Object as PropType<DatePickerRootProps[\"positioning\"]>,\n default: undefined,\n },\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\n// —— 沙箱适配(机制详注见 useSandboxOverlay / sandbox.ts):Teleport 目标降级\n// (shadow DOM / wujie graft → 应用挂载容器,避免面板落入 iframe body)+\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位,fixed 唯一正确解);\n// 覆盖 Date/Month/Year/Week 四个单值日期组件,无 to prop,面板恒传送 ——\nconst teleportTarget = useSandboxTeleportTarget(() => undefined);\nconst rootPositioning = computed(() =>\n withSandboxStrategy(props.positioning, { ...props.positioning }),\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 :positioning=\"rootPositioning\"\n @update:model-value=\"emit('update:modelValue', $event)\"\n @update:open=\"emit('update:open', $event)\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :placeholder=\"placeholder\"\n :aria-invalid=\"invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <CloseIcon class=\"size-4\" />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon class=\"size-4\" />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患;\n 目标经沙箱适配降级(shadow DOM / wujie graft → 应用挂载容器) -->\n <Teleport :to=\"teleportTarget\">\n <ArkDatePicker.Positioner class=\"z-[var(--z-modal,60)]\">\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-modal,60)] rounded-md border shadow-md',\n )\n \"\n >\n <slot />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "date-shared/positioning.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "dialog",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "模态对话框单组件:#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Dialog 原语,含焦点圈定、Escape/遮罩关闭与进出场动画,支持 v-model:open。",
7
7
  "registryDependencies": ["icon-shared", "utils", "overlay-shared"],
@@ -11,7 +11,7 @@
11
11
  "path": "dialog/Dialog.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/dialog/Dialog.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds)\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\"content\", \"title\", \"description\", \"trigger\", \"closeTrigger\", \"positioner\", \"backdrop\"],\n});\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次打开前不挂载内容 */\n lazyMount: { type: Boolean, default: false },\n /** 关闭后卸载内容(关闭动画结束后) */\n unmountOnExit: { type: Boolean, default: false },\n /** 标题文案(#title 插槽优先,两者皆无则不渲染标题) */\n title: { type: String, default: undefined },\n /** 描述文案(#description 插槽优先,两者皆无则不渲染描述) */\n description: { type: String, default: undefined },\n /** 是否渲染右上角内置关闭按钮 */\n showCloseButton: { type: Boolean, default: true },\n /** 追加/覆盖面板样式类(默认 sm:max-w-lg 可由此覆盖,如 \"sm:max-w-xl\") */\n contentClass: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,\n// 避开 zag uncontrolled 内部状态在部分环境下不同步的问题,两种模式行为一致。\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n/** 关闭对话框(#footer 作用域插槽注入):走受控桥把 open 置 false,\n * 与原 TDialogClose(Ark CloseTrigger)的关闭语义等价,退出动画/焦点还原由 zag 处理 */\nfunction close() {\n setOpen(false);\n}\n\n// 标题/描述有任一来源(props 或插槽)时才渲染头部区块(原 TDialogHeader 布局类)\nconst hasHeader = computed(() => Boolean(props.title || props.description));\n\n// 面板样式:内置类 + contentClass 合并(twMerge 自动去冲突,后者优先)\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-lg\",\n props.contentClass,\n ),\n);\n</script>\n\n<template>\n <ArkDialog.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <!-- #trigger:触发元素本体(asChild 语义合并到子元素,原 TDialogTrigger 同款实现);未提供则不渲染触发器 -->\n <ArkDialog.Trigger v-if=\"$slots.trigger\" as-child>\n <slot name=\"trigger\" />\n </ArkDialog.Trigger>\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 <ArkDialog.Content :class=\"contentClass\">\n <!-- 标题/描述:#title / #description 插槽优先,回退 title/description props;皆无则不渲染对应 DOM -->\n <div\n v-if=\"hasHeader || $slots.title || $slots.description\"\n class=\"flex flex-col gap-2 text-center sm:text-left\"\n >\n <ArkDialog.Title\n v-if=\"$slots.title || props.title\"\n class=\"text-lg font-semibold leading-none tracking-tight\"\n >\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 <!-- 默认插槽:弹层内容区(原 TDialogContent 的 body 部分) -->\n <slot />\n\n <!-- 底部操作区:#footer=\"{ close }\" 注入关闭函数,替代原 TDialogClose -->\n <div v-if=\"$slots.footer\" class=\"flex flex-col-reverse gap-2 sm:flex-row sm:justify-end\">\n <slot name=\"footer\" :close=\"close\" />\n </div>\n\n <ArkDialog.CloseTrigger\n v-if=\"props.showCloseButton\"\n class=\"absolute right-4 top-4 cursor-pointer rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none\"\n >\n <slot name=\"close\">\n <CloseIcon class=\"size-4\" />\n <span class=\"sr-only\">关闭</span>\n </slot>\n </ArkDialog.CloseTrigger>\n </ArkDialog.Content>\n </ArkDialog.Positioner>\n </ArkDialog.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds)\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\"content\", \"title\", \"description\", \"trigger\", \"closeTrigger\", \"positioner\", \"backdrop\"],\n});\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次打开前不挂载内容 */\n lazyMount: { type: Boolean, default: false },\n /** 关闭后卸载内容(关闭动画结束后) */\n unmountOnExit: { type: Boolean, default: false },\n /** 标题文案(#title 插槽优先,两者皆无则不渲染标题) */\n title: { type: String, default: undefined },\n /** 描述文案(#description 插槽优先,两者皆无则不渲染描述) */\n description: { type: String, default: undefined },\n /** 是否渲染右上角内置关闭按钮 */\n showCloseButton: { type: Boolean, default: true },\n /** 追加/覆盖面板样式类(默认 sm:max-w-lg 可由此覆盖,如 \"sm:max-w-xl\") */\n contentClass: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,\n// 避开 zag uncontrolled 内部状态在部分环境下不同步的问题,两种模式行为一致。\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n/** 关闭对话框(#footer 作用域插槽注入):走受控桥把 open 置 false,\n * 与原 TDialogClose(Ark CloseTrigger)的关闭语义等价,退出动画/焦点还原由 zag 处理 */\nfunction close() {\n setOpen(false);\n}\n\n// 标题/描述有任一来源(props 或插槽)时才渲染头部区块(原 TDialogHeader 布局类)\nconst hasHeader = computed(() => Boolean(props.title || props.description));\n\n// 面板样式:内置类 + contentClass 合并(twMerge 自动去冲突,后者优先)\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-modal,60)] 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-lg\",\n props.contentClass,\n ),\n);\n</script>\n\n<template>\n <ArkDialog.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <!-- #trigger:触发元素本体(asChild 语义合并到子元素,原 TDialogTrigger 同款实现);未提供则不渲染触发器 -->\n <ArkDialog.Trigger v-if=\"$slots.trigger\" as-child>\n <slot name=\"trigger\" />\n </ArkDialog.Trigger>\n\n <ArkDialog.Backdrop\n class=\"fixed inset-0 z-[var(--z-modal,60)] 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-modal,60)] flex items-center justify-center p-4\"\n >\n <ArkDialog.Content :class=\"contentClass\">\n <!-- 标题/描述:#title / #description 插槽优先,回退 title/description props;皆无则不渲染对应 DOM -->\n <div\n v-if=\"hasHeader || $slots.title || $slots.description\"\n class=\"flex flex-col gap-2 text-center sm:text-left\"\n >\n <ArkDialog.Title\n v-if=\"$slots.title || props.title\"\n class=\"text-lg font-semibold leading-none tracking-tight\"\n >\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 <!-- 默认插槽:弹层内容区(原 TDialogContent 的 body 部分) -->\n <slot />\n\n <!-- 底部操作区:#footer=\"{ close }\" 注入关闭函数,替代原 TDialogClose -->\n <div v-if=\"$slots.footer\" class=\"flex flex-col-reverse gap-2 sm:flex-row sm:justify-end\">\n <slot name=\"footer\" :close=\"close\" />\n </div>\n\n <ArkDialog.CloseTrigger\n v-if=\"props.showCloseButton\"\n class=\"absolute right-4 top-4 cursor-pointer rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none\"\n >\n <slot name=\"close\">\n <CloseIcon class=\"size-4\" />\n <span class=\"sr-only\">关闭</span>\n </slot>\n </ArkDialog.CloseTrigger>\n </ArkDialog.Content>\n </ArkDialog.Positioner>\n </ArkDialog.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "dialog/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "drawer",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "抽屉单组件:从四方向滑出的侧边/顶底面板,#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Drawer 原语,进出场动画随 placement 方向自适应,含焦点圈定、Escape/遮罩关闭,支持 v-model:open。",
7
7
  "registryDependencies": ["icon-shared", "utils", "overlay-shared"],
@@ -11,7 +11,7 @@
11
11
  "path": "drawer/Drawer.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/drawer/Drawer.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Drawer as ArkDrawer } from \"@ark-ui/vue/drawer\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds);grabber/grabberIndicator/swipeArea\n// 随 anatomy 全量覆盖(zag drawer.dom.js:53-72)\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"backdrop\",\n \"header\",\n \"grabber\",\n \"grabberIndicator\",\n \"swipeArea\",\n ],\n});\n\ntype Placement = \"top\" | \"right\" | \"bottom\" | \"left\";\ntype Size = \"sm\" | \"default\" | \"lg\";\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次打开前不挂载内容 */\n lazyMount: { type: Boolean, default: false },\n /** 关闭后卸载内容(关闭动画结束后) */\n unmountOnExit: { type: Boolean, default: false },\n /** 抽屉弹出方向 */\n placement: { type: String as PropType<Placement>, default: \"right\" },\n /** 尺寸档位:侧向(left/right)为宽度,顶/底向(top/bottom)为高度 */\n size: { type: String as PropType<Size>, default: \"default\" },\n /** 标题文案(#title 插槽优先,两者皆无则不渲染标题) */\n title: { type: String, default: undefined },\n /** 描述文案(#description 插槽优先,两者皆无则不渲染描述) */\n description: { type: String, default: undefined },\n /** 是否渲染右上角内置关闭按钮(aria-label=\"关闭\") */\n showCloseButton: { type: Boolean, default: true },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,\n// 与 Dialog 同款桥接,两种模式行为一致。\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n/** 关闭抽屉(#footer 作用域插槽注入) */\nfunction close() {\n setOpen(false);\n}\n\n// 标题/描述有任一来源(props 或插槽)时才渲染头部区块\nconst hasHeader = computed(() => Boolean(props.title || props.description));\n\n// 定位与尺寸:侧向=宽度档位,顶/底向=高度档位;边框贴合抽屉边缘\nconst placementConfig: Record<\n Placement,\n { positioner: string; content: string; sizes: Record<Size, string> }\n> = {\n right: {\n positioner: \"justify-end\",\n content: \"inset-y-0 right-0 h-full border-l\",\n // 档位类带 sm: 前缀 + 基础类用无前缀全宽:tw-merge 对不同断点前缀不互相覆盖,\n // 语义确定为「移动端全宽、sm 起按档位」(写成 \"w-full sm:w-96\" 而非让 tw-merge 去重)\n sizes: { sm: \"sm:w-80\", default: \"sm:w-96\", lg: \"sm:w-[40rem]\" },\n },\n left: {\n positioner: \"justify-start\",\n content: \"inset-y-0 left-0 h-full border-r\",\n sizes: { sm: \"sm:w-80\", default: \"sm:w-96\", lg: \"sm:w-[40rem]\" },\n },\n top: {\n positioner: \"items-start\",\n content: \"inset-x-0 top-0 w-full border-b\",\n sizes: { sm: \"sm:h-64\", default: \"sm:h-80\", lg: \"sm:h-[28rem]\" },\n },\n bottom: {\n positioner: \"items-end\",\n content: \"inset-x-0 bottom-0 w-full border-t\",\n sizes: { sm: \"sm:h-64\", default: \"sm:h-80\", lg: \"sm:h-[28rem]\" },\n },\n};\n\n// 进出场动画随 placement 方向自适应:从哪侧弹出就从哪侧滑入,退场对称滑出\nconst placementAnimations: Record<Placement, string> = {\n right: \"data-[state=open]:slide-in-from-right data-[state=closed]:slide-out-to-right\",\n left: \"data-[state=open]:slide-in-from-left data-[state=closed]:slide-out-to-left\",\n top: \"data-[state=open]:slide-in-from-top data-[state=closed]:slide-out-to-top\",\n bottom: \"data-[state=open]:slide-in-from-bottom data-[state=closed]:slide-out-to-bottom\",\n};\n\nconst config = computed(() => placementConfig[props.placement]);\n\nconst isLateral = computed(() => props.placement === \"left\" || props.placement === \"right\");\n\n// 面板样式:定位 + 档位尺寸 + 方向动画\n// 侧向:基础 w-full(移动端全宽)+ sm: 断点档位宽度;顶/底向:基础 h-full + sm: 档位高度\nconst contentClass = computed(() =>\n cn(\n \"bg-background data-[state=open]:animate-in data-[state=closed]:animate-out fixed z-[var(--z-overlay)] flex flex-col gap-4 overflow-y-auto p-6 shadow-lg duration-200\",\n config.value.content,\n isLateral.value\n ? cn(\"w-full\", config.value.sizes[props.size])\n : cn(\"h-full\", config.value.sizes[props.size]),\n placementAnimations[props.placement],\n ),\n);\n</script>\n\n<template>\n <ArkDrawer.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <ArkDrawer.Trigger v-if=\"$slots.trigger\" as-child>\n <slot name=\"trigger\" />\n </ArkDrawer.Trigger>\n\n <ArkDrawer.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 <ArkDrawer.Positioner :class=\"cn('fixed inset-0 z-[var(--z-overlay)] flex', config.positioner)\">\n <ArkDrawer.Content :class=\"contentClass\">\n <div v-if=\"hasHeader || $slots.title || $slots.description\" class=\"flex flex-col gap-1.5\">\n <ArkDrawer.Title\n v-if=\"$slots.title || props.title\"\n class=\"text-lg font-semibold leading-none tracking-tight\"\n >\n <slot name=\"title\">{{ props.title }}</slot>\n </ArkDrawer.Title>\n <ArkDrawer.Description\n v-if=\"$slots.description || props.description\"\n class=\"text-sm text-muted-foreground\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </ArkDrawer.Description>\n </div>\n\n <slot />\n\n <div\n v-if=\"$slots.footer\"\n class=\"mt-auto flex flex-col-reverse gap-2 pt-2 sm:flex-row sm:justify-end\"\n >\n <slot name=\"footer\" :close=\"close\" />\n </div>\n\n <ArkDrawer.CloseTrigger\n v-if=\"props.showCloseButton\"\n aria-label=\"关闭\"\n class=\"absolute right-4 top-4 cursor-pointer rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none\"\n >\n <slot name=\"close\">\n <CloseIcon class=\"size-4\" />\n <span class=\"sr-only\">关闭</span>\n </slot>\n </ArkDrawer.CloseTrigger>\n </ArkDrawer.Content>\n </ArkDrawer.Positioner>\n </ArkDrawer.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Drawer as ArkDrawer } from \"@ark-ui/vue/drawer\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds);grabber/grabberIndicator/swipeArea\n// 随 anatomy 全量覆盖(zag drawer.dom.js:53-72)\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"backdrop\",\n \"header\",\n \"grabber\",\n \"grabberIndicator\",\n \"swipeArea\",\n ],\n});\n\ntype Placement = \"top\" | \"right\" | \"bottom\" | \"left\";\ntype Size = \"sm\" | \"default\" | \"lg\";\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次打开前不挂载内容 */\n lazyMount: { type: Boolean, default: false },\n /** 关闭后卸载内容(关闭动画结束后) */\n unmountOnExit: { type: Boolean, default: false },\n /** 抽屉弹出方向 */\n placement: { type: String as PropType<Placement>, default: \"right\" },\n /** 尺寸档位:侧向(left/right)为宽度,顶/底向(top/bottom)为高度 */\n size: { type: String as PropType<Size>, default: \"default\" },\n /** 标题文案(#title 插槽优先,两者皆无则不渲染标题) */\n title: { type: String, default: undefined },\n /** 描述文案(#description 插槽优先,两者皆无则不渲染描述) */\n description: { type: String, default: undefined },\n /** 是否渲染右上角内置关闭按钮(aria-label=\"关闭\") */\n showCloseButton: { type: Boolean, default: true },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,\n// 与 Dialog 同款桥接,两种模式行为一致。\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n/** 关闭抽屉(#footer 作用域插槽注入) */\nfunction close() {\n setOpen(false);\n}\n\n// 标题/描述有任一来源(props 或插槽)时才渲染头部区块\nconst hasHeader = computed(() => Boolean(props.title || props.description));\n\n// 定位与尺寸:侧向=宽度档位,顶/底向=高度档位;边框贴合抽屉边缘\nconst placementConfig: Record<\n Placement,\n { positioner: string; content: string; sizes: Record<Size, string> }\n> = {\n right: {\n positioner: \"justify-end\",\n content: \"inset-y-0 right-0 h-full border-l\",\n // 档位类带 sm: 前缀 + 基础类用无前缀全宽:tw-merge 对不同断点前缀不互相覆盖,\n // 语义确定为「移动端全宽、sm 起按档位」(写成 \"w-full sm:w-96\" 而非让 tw-merge 去重)\n sizes: { sm: \"sm:w-80\", default: \"sm:w-96\", lg: \"sm:w-[40rem]\" },\n },\n left: {\n positioner: \"justify-start\",\n content: \"inset-y-0 left-0 h-full border-r\",\n sizes: { sm: \"sm:w-80\", default: \"sm:w-96\", lg: \"sm:w-[40rem]\" },\n },\n top: {\n positioner: \"items-start\",\n content: \"inset-x-0 top-0 w-full border-b\",\n sizes: { sm: \"sm:h-64\", default: \"sm:h-80\", lg: \"sm:h-[28rem]\" },\n },\n bottom: {\n positioner: \"items-end\",\n content: \"inset-x-0 bottom-0 w-full border-t\",\n sizes: { sm: \"sm:h-64\", default: \"sm:h-80\", lg: \"sm:h-[28rem]\" },\n },\n};\n\n// 进出场动画随 placement 方向自适应:从哪侧弹出就从哪侧滑入,退场对称滑出\nconst placementAnimations: Record<Placement, string> = {\n right: \"data-[state=open]:slide-in-from-right data-[state=closed]:slide-out-to-right\",\n left: \"data-[state=open]:slide-in-from-left data-[state=closed]:slide-out-to-left\",\n top: \"data-[state=open]:slide-in-from-top data-[state=closed]:slide-out-to-top\",\n bottom: \"data-[state=open]:slide-in-from-bottom data-[state=closed]:slide-out-to-bottom\",\n};\n\nconst config = computed(() => placementConfig[props.placement]);\n\nconst isLateral = computed(() => props.placement === \"left\" || props.placement === \"right\");\n\n// 面板样式:定位 + 档位尺寸 + 方向动画\n// 侧向:基础 w-full(移动端全宽)+ sm: 断点档位宽度;顶/底向:基础 h-full + sm: 档位高度\nconst contentClass = computed(() =>\n cn(\n \"bg-background data-[state=open]:animate-in data-[state=closed]:animate-out fixed z-[var(--z-modal,60)] flex flex-col gap-4 overflow-y-auto p-6 shadow-lg duration-200\",\n config.value.content,\n isLateral.value\n ? cn(\"w-full\", config.value.sizes[props.size])\n : cn(\"h-full\", config.value.sizes[props.size]),\n placementAnimations[props.placement],\n ),\n);\n</script>\n\n<template>\n <ArkDrawer.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <ArkDrawer.Trigger v-if=\"$slots.trigger\" as-child>\n <slot name=\"trigger\" />\n </ArkDrawer.Trigger>\n\n <ArkDrawer.Backdrop\n class=\"fixed inset-0 z-[var(--z-modal,60)] 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 <ArkDrawer.Positioner\n :class=\"cn('fixed inset-0 z-[var(--z-modal,60)] flex', config.positioner)\"\n >\n <ArkDrawer.Content :class=\"contentClass\">\n <div v-if=\"hasHeader || $slots.title || $slots.description\" class=\"flex flex-col gap-1.5\">\n <ArkDrawer.Title\n v-if=\"$slots.title || props.title\"\n class=\"text-lg font-semibold leading-none tracking-tight\"\n >\n <slot name=\"title\">{{ props.title }}</slot>\n </ArkDrawer.Title>\n <ArkDrawer.Description\n v-if=\"$slots.description || props.description\"\n class=\"text-sm text-muted-foreground\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </ArkDrawer.Description>\n </div>\n\n <slot />\n\n <div\n v-if=\"$slots.footer\"\n class=\"mt-auto flex flex-col-reverse gap-2 pt-2 sm:flex-row sm:justify-end\"\n >\n <slot name=\"footer\" :close=\"close\" />\n </div>\n\n <ArkDrawer.CloseTrigger\n v-if=\"props.showCloseButton\"\n aria-label=\"关闭\"\n class=\"absolute right-4 top-4 cursor-pointer rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none\"\n >\n <slot name=\"close\">\n <CloseIcon class=\"size-4\" />\n <span class=\"sr-only\">关闭</span>\n </slot>\n </ArkDrawer.CloseTrigger>\n </ArkDrawer.Content>\n </ArkDrawer.Positioner>\n </ArkDrawer.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "drawer/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "dropdown-menu",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "下拉菜单:单组件模式,items 描述菜单项(含分组/标题/分隔线,支持嵌套),内置键盘导航与选中回调,默认插槽为触发元素(asChild 透传)。",
7
7
  "registryDependencies": ["utils", "overlay-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "empty",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "空状态占位,含默认插画与描述文案。",
7
7
  "registryDependencies": ["utils"],