@tu-design/vue 0.2.2 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. package/dist/index.d.mts +3365 -1104
  2. package/dist/index.mjs +7167 -1354
  3. package/dist/registry/vue/alert.json +22 -0
  4. package/dist/registry/vue/avatar-group.json +21 -0
  5. package/dist/registry/vue/avatar.json +3 -3
  6. package/dist/registry/vue/calendar.json +34 -0
  7. package/dist/registry/vue/card.json +3 -33
  8. package/dist/registry/vue/cascader.json +34 -0
  9. package/dist/registry/vue/checkbox.json +1 -1
  10. package/dist/registry/vue/currency-input.json +1 -1
  11. package/dist/registry/vue/date-picker.json +22 -0
  12. package/dist/registry/vue/date-range-picker.json +22 -0
  13. package/dist/registry/vue/date-shared.json +26 -0
  14. package/dist/registry/vue/dialog.json +3 -45
  15. package/dist/registry/vue/dropdown-menu.json +11 -35
  16. package/dist/registry/vue/empty.json +21 -0
  17. package/dist/registry/vue/form-render.json +115 -0
  18. package/dist/registry/vue/form.json +2 -2
  19. package/dist/registry/vue/month-picker.json +22 -0
  20. package/dist/registry/vue/number-input.json +1 -1
  21. package/dist/registry/vue/popover.json +3 -15
  22. package/dist/registry/vue/progress.json +22 -0
  23. package/dist/registry/vue/radio-group.json +2 -8
  24. package/dist/registry/vue/registry.json +114 -6
  25. package/dist/registry/vue/select.json +3 -27
  26. package/dist/registry/vue/slider.json +1 -1
  27. package/dist/registry/vue/spin.json +22 -0
  28. package/dist/registry/vue/table-render.json +62 -0
  29. package/dist/registry/vue/tabs.json +2 -20
  30. package/dist/registry/vue/toast.json +28 -0
  31. package/dist/registry/vue/tokens.json +1 -1
  32. package/dist/registry/vue/tooltip.json +2 -14
  33. package/dist/registry/vue/tree-select.json +34 -0
  34. package/dist/registry/vue/tree-shared.json +92 -0
  35. package/dist/registry/vue/week-picker.json +22 -0
  36. package/dist/registry/vue/year-picker.json +22 -0
  37. package/package.json +3 -1
@@ -2,7 +2,7 @@
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "dialog",
4
4
  "type": "registry:ui",
5
- "description": "模态对话框:基于 Ark UI Dialog 原语,含焦点圈定、Escape/遮罩关闭与进出场动画,支持 asChild 与 v-model:open。",
5
+ "description": "模态对话框单组件:#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Dialog 原语,含焦点圈定、Escape/遮罩关闭与进出场动画,支持 v-model:open。",
6
6
  "registryDependencies": ["utils"],
7
7
  "dependencies": ["@ark-ui/vue@^5.39.2"],
8
8
  "files": [
@@ -10,55 +10,13 @@
10
10
  "path": "dialog/Dialog.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/dialog/Dialog.vue",
13
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\n\ninterface Props {\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open?: boolean;\n defaultOpen?: boolean;\n /** 首次打开前不挂载内容 */\n lazyMount?: boolean;\n /** 关闭后卸载内容(关闭动画结束后) */\n unmountOnExit?: boolean;\n}\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。\nconst props = defineProps({\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n lazyMount: { type: Boolean, default: false },\n unmountOnExit: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,\n// 避开 zag uncontrolled 内部状态在部分环境下不同步的问题,两种模式行为一致。\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n</script>\n\n<template>\n <ArkDialog.Root\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"handleUpdate\"\n >\n <slot />\n </ArkDialog.Root>\n</template>\n"
14
- },
15
- {
16
- "path": "dialog/DialogClose.vue",
17
- "type": "registry:component",
18
- "target": "components/ui/dialog/DialogClose.vue",
19
- "content": "<script setup lang=\"ts\">\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\n\ninterface Props {\n /** 以默认插槽子元素为渲染目标,不渲染额外按钮 */\n asChild?: boolean;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkDialog.CloseTrigger :as-child=\"props.asChild\">\n <slot />\n </ArkDialog.CloseTrigger>\n</template>\n"
20
- },
21
- {
22
- "path": "dialog/DialogContent.vue",
23
- "type": "registry:component",
24
- "target": "components/ui/dialog/DialogContent.vue",
25
- "content": "<script setup lang=\"ts\">\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n /** 是否在内容右上角渲染关闭按钮 */\n showCloseButton?: boolean;\n class?: string;\n}\n\nconst props = withDefaults(defineProps<Props>(), { showCloseButton: true });\n</script>\n\n<template>\n <ArkDialog.Backdrop\n class=\"fixed inset-0 z-50 bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\"\n />\n <ArkDialog.Positioner class=\"fixed inset-0 z-50 flex items-center justify-center p-4\">\n <ArkDialog.Content\n :class=\"\n cn(\n 'bg-background data-[state=open]:animate-in data-[state=closed]:animate-out fixed left-1/2 top-1/2 z-50 grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-lg border p-6 shadow-lg duration-200 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 sm:max-w-lg',\n props.class,\n )\n \"\n >\n <slot />\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 <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n >\n <path d=\"M18 6 6 18\" />\n <path d=\"m6 6 12 12\" />\n </svg>\n <span class=\"sr-only\">关闭</span>\n </ArkDialog.CloseTrigger>\n </ArkDialog.Content>\n </ArkDialog.Positioner>\n</template>\n"
26
- },
27
- {
28
- "path": "dialog/DialogDescription.vue",
29
- "type": "registry:component",
30
- "target": "components/ui/dialog/DialogDescription.vue",
31
- "content": "<script setup lang=\"ts\">\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkDialog.Description :class=\"cn('text-sm text-muted-foreground', props.class)\">\n <slot />\n </ArkDialog.Description>\n</template>\n"
32
- },
33
- {
34
- "path": "dialog/DialogFooter.vue",
35
- "type": "registry:component",
36
- "target": "components/ui/dialog/DialogFooter.vue",
37
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <div :class=\"cn('flex flex-col-reverse gap-2 sm:flex-row sm:justify-end', props.class)\">\n <slot />\n </div>\n</template>\n"
38
- },
39
- {
40
- "path": "dialog/DialogHeader.vue",
41
- "type": "registry:component",
42
- "target": "components/ui/dialog/DialogHeader.vue",
43
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <div :class=\"cn('flex flex-col gap-2 text-center sm:text-left', props.class)\">\n <slot />\n </div>\n</template>\n"
44
- },
45
- {
46
- "path": "dialog/DialogTitle.vue",
47
- "type": "registry:component",
48
- "target": "components/ui/dialog/DialogTitle.vue",
49
- "content": "<script setup lang=\"ts\">\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkDialog.Title :class=\"cn('text-lg font-semibold leading-none tracking-tight', props.class)\">\n <slot />\n </ArkDialog.Title>\n</template>\n"
50
- },
51
- {
52
- "path": "dialog/DialogTrigger.vue",
53
- "type": "registry:component",
54
- "target": "components/ui/dialog/DialogTrigger.vue",
55
- "content": "<script setup lang=\"ts\">\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\n\ninterface Props {\n /** 以默认插槽子元素为渲染目标(样式与行为合并其上),不渲染额外按钮 */\n asChild?: boolean;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkDialog.Trigger :as-child=\"props.asChild\">\n <slot />\n </ArkDialog.Trigger>\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\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 internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n\n/** 关闭对话框(#footer 作用域插槽注入):走受控桥把 open 置 false,\n * 与原 TDialogClose(Ark CloseTrigger)的关闭语义等价,退出动画/焦点还原由 zag 处理 */\nfunction close() {\n handleUpdate(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-50 grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-lg border p-6 shadow-lg duration-200 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 sm:max-w-lg\",\n props.contentClass,\n ),\n);\n</script>\n\n<template>\n <ArkDialog.Root\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"handleUpdate\"\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-50 bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\"\n />\n <ArkDialog.Positioner class=\"fixed inset-0 z-50 flex items-center justify-center p-4\">\n <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 <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n >\n <path d=\"M18 6 6 18\" />\n <path d=\"m6 6 12 12\" />\n </svg>\n <span class=\"sr-only\">关闭</span>\n </ArkDialog.CloseTrigger>\n </ArkDialog.Content>\n </ArkDialog.Positioner>\n </ArkDialog.Root>\n</template>\n"
56
14
  },
57
15
  {
58
16
  "path": "dialog/index.ts",
59
17
  "type": "registry:component",
60
18
  "target": "components/ui/dialog/index.ts",
61
- "content": "export { default as Dialog } from \"./Dialog.vue\";\nexport { default as DialogClose } from \"./DialogClose.vue\";\nexport { default as DialogContent } from \"./DialogContent.vue\";\nexport { default as DialogDescription } from \"./DialogDescription.vue\";\nexport { default as DialogFooter } from \"./DialogFooter.vue\";\nexport { default as DialogHeader } from \"./DialogHeader.vue\";\nexport { default as DialogTitle } from \"./DialogTitle.vue\";\nexport { default as DialogTrigger } from \"./DialogTrigger.vue\";\n"
19
+ "content": "export { default as Dialog } from \"./Dialog.vue\";\n"
62
20
  }
63
21
  ]
64
22
  }
@@ -2,7 +2,7 @@
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "dropdown-menu",
4
4
  "type": "registry:ui",
5
- "description": "下拉菜单:基于 Ark UI Menu 原语,含键盘导航、选中回调与分组/分隔线,Trigger 支持 asChild。",
5
+ "description": "下拉菜单:单组件模式,items 描述菜单项(含分组/标题/分隔线,支持嵌套),内置键盘导航与选中回调,默认插槽为触发元素(asChild 透传)。",
6
6
  "registryDependencies": ["utils"],
7
7
  "dependencies": ["@ark-ui/vue@^5.39.2"],
8
8
  "files": [
@@ -10,49 +10,25 @@
10
10
  "path": "dropdown-menu/DropdownMenu.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/dropdown-menu/DropdownMenu.vue",
13
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\n\ninterface Props {\n /** 受控开关(配合 v-model:open);不传时为非受控 */\n open?: boolean;\n defaultOpen?: boolean;\n lazyMount?: boolean;\n unmountOnExit?: boolean;\n}\n\n// open 用 default: undefined 禁用 Boolean casting(Dialog/Tooltip 同款约定)\nconst props = defineProps({\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n lazyMount: { type: Boolean, default: false },\n unmountOnExit: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{\n \"update:open\": [open: boolean];\n /** 选中某个 item 时触发(closeOnSelect 关闭后仍会先发出) */\n select: [details: { value: string }];\n}>();\n\n// 对 Root 恒走受控模式,非受控语义由内部 ref 实现(Dialog 同款)\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n\nfunction handleSelect(details: { value: string }) {\n emit(\"select\", details);\n}\n</script>\n\n<template>\n <ArkMenu.Root\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"handleUpdate\"\n @select=\"handleSelect\"\n >\n <slot />\n </ArkMenu.Root>\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref, useAttrs } from \"vue\";\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\nimport { cn } from \"@/lib/utils\";\nimport MenuItems from \"./MenuItems.vue\";\nimport type { MenuItemOption } from \"./types\";\n\ndefineOptions({ name: \"DropdownMenu\", inheritAttrs: false });\n\nconst props = defineProps({\n /** 菜单项描述列表(item/label/separator/group 四种形态,group 可嵌套) */\n items: { type: Array as PropType<MenuItemOption[]>, required: true },\n /** 受控开关(配合 v-model:open);不传时为非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n lazyMount: { type: Boolean, default: false },\n unmountOnExit: { type: Boolean, default: false },\n /** 追加到触发元素上的 class(默认插槽内容即触发元素本身) */\n triggerClass: { type: String, default: undefined },\n /** 追加到菜单面板上的 class */\n contentClass: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:open\": [open: boolean];\n /** 选中某个 item 时触发(closeOnSelect 关闭后仍会先发出) */\n select: [details: { value: string }];\n}>();\n\n// attrs 转发到面板元素(Root 不渲染 DOM,避免 fallthrough 警告)\nconst attrs = useAttrs();\n\n// 对 Root 恒走受控模式,非受控语义由内部 ref 实现(Dialog/DatePicker 同款)\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n\nfunction handleSelect(details: { value: string }) {\n emit(\"select\", details);\n}\n\n// 样式类(收编自原 DropdownMenuContent.vue)\nconst contentCls =\n \"bg-popover text-popover-foreground z-50 min-w-[8rem] overflow-hidden rounded-md border p-1 shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95\";\n</script>\n\n<template>\n <ArkMenu.Root\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"handleUpdate\"\n @select=\"handleSelect\"\n >\n <!-- 默认插槽 = 触发元素本身(asChild 透传,行为合并不额外包裹元素) -->\n <ArkMenu.Trigger as-child :class=\"props.triggerClass\">\n <slot />\n </ArkMenu.Trigger>\n\n <ArkMenu.Positioner class=\"z-50\">\n <ArkMenu.Content v-bind=\"attrs\" :class=\"cn(contentCls, props.contentClass)\">\n <MenuItems :items=\"props.items\">\n <template v-if=\"$slots.item\" #item=\"slotProps\">\n <slot name=\"item\" v-bind=\"slotProps\" />\n </template>\n </MenuItems>\n </ArkMenu.Content>\n </ArkMenu.Positioner>\n </ArkMenu.Root>\n</template>\n"
14
14
  },
15
15
  {
16
- "path": "dropdown-menu/DropdownMenuContent.vue",
16
+ "path": "dropdown-menu/MenuItems.vue",
17
17
  "type": "registry:component",
18
- "target": "components/ui/dropdown-menu/DropdownMenuContent.vue",
19
- "content": "<script setup lang=\"ts\">\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkMenu.Positioner class=\"z-50\">\n <ArkMenu.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground z-50 min-w-[8rem] overflow-hidden rounded-md border p-1 shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95',\n props.class,\n )\n \"\n >\n <slot />\n </ArkMenu.Content>\n </ArkMenu.Positioner>\n</template>\n"
18
+ "target": "components/ui/dropdown-menu/MenuItems.vue",
19
+ "content": "<script setup lang=\"ts\">\nimport { useId } from \"vue\";\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\nimport { cn } from \"@/lib/utils\";\nimport type { MenuItemOption } from \"./types\";\n\n/** 当前层级要渲染的菜单项描述列表 */\ndefineProps<{ items: MenuItemOption[] }>();\n\n/** #item 逃生口:自定义 item 内容渲染(仍包在 ArkMenu.Item 内,保留键盘导航与 select 行为) */\ndefineSlots<{\n item?: (props: { item: Extract<MenuItemOption, { type: \"item\" }> }) => unknown;\n}>();\n\n// —— 样式类(收编自原 DropdownMenuItem/Label/Separator 子组件)——\nconst itemCls =\n \"relative flex cursor-pointer select-none items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none data-[highlighted]:bg-accent data-[highlighted]:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:size-4 [&_svg]:shrink-0\";\nconst labelCls = \"px-2 py-1.5 text-sm font-medium\";\nconst separatorCls = \"-mx-1 my-1 h-px bg-muted\";\n\n// 未提供 value 的 item 回退标识:useId 保证跨实例唯一,层级内索引保证实例内唯一\nconst uid = useId();\n\nfunction valueFor(item: Extract<MenuItemOption, { type: \"item\" }>, index: number): string {\n return item.value ?? `${uid}-item-${index}`;\n}\n</script>\n\n<template>\n <template\n v-for=\"(opt, i) in items\"\n :key=\"opt.type === 'item' ? valueFor(opt, i) : `${opt.type}-${i}`\"\n >\n <!-- 菜单项 -->\n <ArkMenu.Item\n v-if=\"opt.type === 'item'\"\n :value=\"valueFor(opt, i)\"\n :disabled=\"opt.disabled\"\n :class=\"cn(itemCls, opt.class)\"\n >\n <slot v-if=\"$slots.item\" name=\"item\" :item=\"opt\" />\n <template v-else>{{ opt.label }}</template>\n </ArkMenu.Item>\n\n <!-- 独立分组标题(纯视觉) -->\n <div v-else-if=\"opt.type === 'label'\" :class=\"cn(labelCls, opt.class)\">\n {{ opt.label }}\n </div>\n\n <!-- 分隔线 -->\n <ArkMenu.Separator v-else-if=\"opt.type === 'separator'\" :class=\"cn(separatorCls, opt.class)\" />\n\n <!-- 分组:label 走 ItemGroupLabel 与 group 建立 aria 关联,子项递归渲染 -->\n <ArkMenu.ItemGroup v-else :class=\"opt.class\">\n <ArkMenu.ItemGroupLabel v-if=\"opt.label\" :class=\"labelCls\">\n {{ opt.label }}\n </ArkMenu.ItemGroupLabel>\n <MenuItems :items=\"opt.children\">\n <template v-if=\"$slots.item\" #item=\"slotProps\">\n <slot name=\"item\" v-bind=\"slotProps\" />\n </template>\n </MenuItems>\n </ArkMenu.ItemGroup>\n </template>\n</template>\n"
20
20
  },
21
21
  {
22
- "path": "dropdown-menu/DropdownMenuGroup.vue",
23
- "type": "registry:component",
24
- "target": "components/ui/dropdown-menu/DropdownMenuGroup.vue",
25
- "content": "<script setup lang=\"ts\">\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\n\ninterface Props {\n /** 分组的可访问名称 */\n label?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkMenu.ItemGroup :label=\"props.label\">\n <slot />\n </ArkMenu.ItemGroup>\n</template>\n"
26
- },
27
- {
28
- "path": "dropdown-menu/DropdownMenuItem.vue",
29
- "type": "registry:component",
30
- "target": "components/ui/dropdown-menu/DropdownMenuItem.vue",
31
- "content": "<script setup lang=\"ts\">\nimport { useId } from \"vue\";\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n /** 选中回调里回传的标识;缺省自动生成 */\n value?: string;\n disabled?: boolean;\n class?: string;\n}\n\nconst props = withDefaults(defineProps<Props>(), { value: undefined, disabled: false });\n\nconst autoValue = useId();\n</script>\n\n<template>\n <ArkMenu.Item\n :value=\"props.value ?? autoValue\"\n :disabled=\"props.disabled\"\n :class=\"\n cn(\n 'relative flex cursor-pointer select-none items-center gap-2 rounded-sm px-2 py-1.5 text-sm outline-none data-[highlighted]:bg-accent data-[highlighted]:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50 [&_svg]:size-4 [&_svg]:shrink-0',\n props.class,\n )\n \"\n >\n <slot />\n </ArkMenu.Item>\n</template>\n"
32
- },
33
- {
34
- "path": "dropdown-menu/DropdownMenuLabel.vue",
35
- "type": "registry:component",
36
- "target": "components/ui/dropdown-menu/DropdownMenuLabel.vue",
37
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <div :class=\"cn('px-2 py-1.5 text-sm font-medium', props.class)\">\n <slot />\n </div>\n</template>\n"
38
- },
39
- {
40
- "path": "dropdown-menu/DropdownMenuSeparator.vue",
41
- "type": "registry:component",
42
- "target": "components/ui/dropdown-menu/DropdownMenuSeparator.vue",
43
- "content": "<script setup lang=\"ts\">\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkMenu.Separator :class=\"cn('-mx-1 my-1 h-px bg-muted', props.class)\" />\n</template>\n"
44
- },
45
- {
46
- "path": "dropdown-menu/DropdownMenuTrigger.vue",
22
+ "path": "dropdown-menu/index.ts",
47
23
  "type": "registry:component",
48
- "target": "components/ui/dropdown-menu/DropdownMenuTrigger.vue",
49
- "content": "<script setup lang=\"ts\">\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\n\ninterface Props {\n /** 以默认插槽子元素为渲染目标,行为合并其上 */\n asChild?: boolean;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkMenu.Trigger :as-child=\"props.asChild\">\n <slot />\n </ArkMenu.Trigger>\n</template>\n"
24
+ "target": "components/ui/dropdown-menu/index.ts",
25
+ "content": "export { default as DropdownMenu } from \"./DropdownMenu.vue\";\nexport type { MenuItemOption } from \"./types\";\n"
50
26
  },
51
27
  {
52
- "path": "dropdown-menu/index.ts",
28
+ "path": "dropdown-menu/types.ts",
53
29
  "type": "registry:component",
54
- "target": "components/ui/dropdown-menu/index.ts",
55
- "content": "export { default as DropdownMenu } from \"./DropdownMenu.vue\";\nexport { default as DropdownMenuContent } from \"./DropdownMenuContent.vue\";\nexport { default as DropdownMenuGroup } from \"./DropdownMenuGroup.vue\";\nexport { default as DropdownMenuItem } from \"./DropdownMenuItem.vue\";\nexport { default as DropdownMenuLabel } from \"./DropdownMenuLabel.vue\";\nexport { default as DropdownMenuSeparator } from \"./DropdownMenuSeparator.vue\";\nexport { default as DropdownMenuTrigger } from \"./DropdownMenuTrigger.vue\";\n"
30
+ "target": "components/ui/dropdown-menu/types.ts",
31
+ "content": "/** DropdownMenu 菜单项描述:四种形态,group 可嵌套 children 形成层级 */\nexport type MenuItemOption =\n | { type: \"item\"; value: string; label: string; disabled?: boolean; class?: string }\n | { type: \"label\"; label: string; class?: string }\n | { type: \"separator\"; class?: string }\n | { type: \"group\"; label?: string; class?: string; children: MenuItemOption[] };\n"
56
32
  }
57
33
  ]
58
34
  }
@@ -0,0 +1,21 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "empty",
4
+ "type": "registry:ui",
5
+ "description": "空状态占位,含默认插画与描述文案。",
6
+ "registryDependencies": ["utils"],
7
+ "files": [
8
+ {
9
+ "path": "empty/Empty.vue",
10
+ "type": "registry:component",
11
+ "target": "components/ui/empty/Empty.vue",
12
+ "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\nconst props = withDefaults(\n defineProps<{\n class?: string;\n description?: string;\n }>(),\n {\n description: \"暂无数据\",\n },\n);\n</script>\n\n<template>\n <div\n role=\"status\"\n :class=\"\n cn('flex flex-col items-center justify-center gap-3 px-6 py-16 text-center', props.class)\n \"\n >\n <div class=\"text-muted-foreground/60 [&_svg]:size-24\">\n <slot name=\"icon\">\n <!-- 内置插画:简洁空盒 -->\n <svg\n viewBox=\"0 0 96 96\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2.5\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n aria-hidden=\"true\"\n >\n <path d=\"M48 18 78 34v28L48 78 18 62V34L48 18Z\" opacity=\"0.55\" />\n <path d=\"M18 34l30 16 30-16\" opacity=\"0.55\" />\n <path d=\"M48 50v28\" opacity=\"0.55\" />\n <path\n d=\"M48 18l-8 26 8 6 8-6-8-26Z\"\n fill=\"currentColor\"\n fill-opacity=\"0.12\"\n stroke=\"none\"\n />\n <path d=\"M40 44l8 6 8-6\" opacity=\"0.75\" />\n </svg>\n </slot>\n </div>\n <p class=\"text-sm text-muted-foreground\">{{ props.description }}</p>\n <div v-if=\"$slots.default\" class=\"mt-2 flex items-center gap-3\">\n <slot />\n </div>\n </div>\n</template>\n"
13
+ },
14
+ {
15
+ "path": "empty/index.ts",
16
+ "type": "registry:component",
17
+ "target": "components/ui/empty/index.ts",
18
+ "content": "export { default as Empty } from \"./Empty.vue\";\n"
19
+ }
20
+ ]
21
+ }
@@ -0,0 +1,115 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "form-render",
4
+ "type": "registry:ui",
5
+ "description": "配置驱动表单渲染器:defineForm 聚合 TanStack Form 实例与字段配置,柯里化 widget DSL 声明控件,Tailwind 栅格自适应布局,复用 Form 家族 aria 接线。",
6
+ "registryDependencies": [
7
+ "form",
8
+ "button",
9
+ "label",
10
+ "utils",
11
+ "input",
12
+ "textarea",
13
+ "number-input",
14
+ "password-input",
15
+ "currency-input",
16
+ "select",
17
+ "checkbox",
18
+ "switch",
19
+ "radio-group",
20
+ "slider",
21
+ "date-picker",
22
+ "month-picker",
23
+ "year-picker",
24
+ "date-range-picker",
25
+ "tree-select",
26
+ "cascader"
27
+ ],
28
+ "dependencies": ["@tanstack/vue-form@^1.33.5", "valibot@^1.5.0"],
29
+ "files": [
30
+ {
31
+ "path": "form-render/FormRender.vue",
32
+ "type": "registry:component",
33
+ "target": "components/ui/form-render/FormRender.vue",
34
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport type {\n FormRenderDefinition,\n FormRenderFormApi,\n FormRenderItem,\n WidgetRenderReturn,\n} from \"./types\";\nimport { computed, provide, ref } from \"vue\";\nimport { Button } from \"@/components/button\";\nimport { FORM_KEY } from \"@/components/form/context\";\nimport FormRenderField from \"./FormRenderField.vue\";\nimport { widgetRenders } from \"./widgets\";\n\n// boolean flags 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false,\"缺省跟随 searchable\" 语义失效;Checkbox/Dialog 同款约定)\nconst props = defineProps({\n /** 聚合式(推荐):defineForm 返回的定义对象 */\n definition: { type: Object as PropType<FormRenderDefinition<any>> },\n /** 拆分式:与 <Form :form> 模式兼容(与 definition 二选一,definition 优先) */\n form: { type: Object as PropType<FormRenderFormApi> },\n items: { type: Array as PropType<FormRenderItem<any>[]> },\n searchable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n submitable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 缺省跟随 searchable */\n resetable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 缺省跟随 submitable */\n cancelable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n searchText: { type: String },\n submitText: { type: String },\n resetText: { type: String },\n /** 栅格最小列宽 px(auto-fill 自适应列数) */\n minWidth: { type: Number },\n});\n\nconst emit = defineEmits<{\n search: [];\n submit: [];\n reset: [];\n cancel: [];\n}>();\n\nconst instance = props.definition?.form ?? props.form;\nconst items = computed(() => props.definition?.items ?? props.items ?? []);\n\nif (import.meta.env.DEV && !instance) {\n console.warn(\n \"[tu-design] <FormRender> 需要 definition 或 form + items(definition/form 不支持运行时切换)\",\n );\n}\n\n// S2:FormField 依赖 inject(FORM_KEY),本组件替代 <Form> 的 provide 职责\nprovide(FORM_KEY, instance as never);\n\n// S1:form.state 非响应式,响应式 values 只能经 useSelector 订阅建立;\n// visible 过滤与 WidgetContext.values 一律消费它,渲染路径禁读 form.state.*\nconst valuesRef = instance\n ? instance.useSelector((s: any) => s.values)\n : ref<Record<string, unknown>>({});\n\nconst r = widgetRenders<any>();\n\nfunction widgetOf(item: FormRenderItem<any>): WidgetRenderReturn<any> {\n return item.render ? item.render(r) : r.input();\n}\n\nconst visibleItems = computed(() =>\n items.value.filter((item) =>\n typeof item.visible === \"function\"\n ? item.visible(valuesRef.value as never)\n : item.visible !== false,\n ),\n);\n\nconst gridStyle = computed(() => ({\n gridTemplateColumns: `repeat(auto-fill, minmax(${props.minWidth ?? 320}px, 1fr))`,\n}));\n\nfunction spanStyle(span?: number | \"full\") {\n if (span === \"full\") return { gridColumn: \"1 / -1\" };\n if (typeof span === \"number\") return { gridColumn: `span ${span}` };\n return undefined;\n}\n\nconst showReset = computed(() => props.resetable ?? !!props.searchable);\nconst showCancel = computed(() => props.cancelable ?? !!props.submitable);\nconst showActions = computed(\n () => props.searchable || props.submitable || showReset.value || showCancel.value,\n);\n\n/** I4:校验失败时 isFieldsValid=false,不 emit;成功后才 emit(事件回调中一次性读取不受 S1 限制) */\nasync function submit(mode: \"search\" | \"submit\") {\n if (!instance) return;\n await instance.handleSubmit();\n if (instance.state.isFieldsValid) {\n if (mode === \"search\") emit(\"search\");\n else emit(\"submit\");\n }\n}\n\nfunction onReset() {\n if (props.definition) {\n props.definition.resetToDefaults();\n } else {\n instance?.reset();\n }\n emit(\"reset\");\n}\n\ndefineExpose({\n form: instance,\n items,\n resetToDefaults: () =>\n props.definition ? props.definition.resetToDefaults() : instance?.reset(),\n});\n</script>\n\n<template>\n <div class=\"grid gap-4\" :style=\"gridStyle\">\n <div v-for=\"item in visibleItems\" :key=\"String(item.key)\" :style=\"spanStyle(item.span)\">\n <FormRenderField :item=\"item\" :widget=\"widgetOf(item)\" :values=\"valuesRef\" />\n </div>\n <div v-if=\"showActions\" class=\"col-span-full flex justify-end gap-2\">\n <slot name=\"actions\">\n <Button v-if=\"searchable\" @click=\"submit('search')\">\n {{ searchText ?? \"搜索\" }}\n </Button>\n <Button v-if=\"showReset\" variant=\"outline\" @click=\"onReset\">\n {{ resetText ?? \"重置\" }}\n </Button>\n <Button v-if=\"submitable\" @click=\"submit('submit')\">\n {{ submitText ?? \"提交\" }}\n </Button>\n <Button v-if=\"showCancel\" variant=\"outline\" @click=\"emit('cancel')\"> 取消 </Button>\n </slot>\n </div>\n </div>\n</template>\n"
35
+ },
36
+ {
37
+ "path": "form-render/FormRenderField.vue",
38
+ "type": "registry:component",
39
+ "target": "components/ui/form-render/FormRenderField.vue",
40
+ "content": "<script lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { defineComponent, h } from \"vue\";\nimport {\n FormControl,\n FormDescription,\n FormField,\n FormItem,\n FormLabel,\n FormMessage,\n} from \"@/components/form\";\nimport type { FormRenderItem, WidgetRenderReturn } from \"./types\";\n\n/**\n * 单字段桥接:复用 <FormField>(form.Field 动态渲染 + FIELD_KEY provide 时序),\n * 内部组装 FormItem/FormLabel/FormControl/FormDescription/FormMessage,\n * aria 接线(id/aria-invalid/aria-describedby)由 FormControl 的 cloneVNode 机制继承。\n * widget 调用发生在 FormField 插槽期,拿到 field 实例后组装 WidgetContext。\n */\nexport default defineComponent({\n name: \"TuFormRenderField\",\n props: {\n item: { type: Object as PropType<FormRenderItem<any>>, required: true },\n /** 已柯里化的 widget 渲染函数:r.input({...}) 的返回值 */\n widget: { type: Function as PropType<WidgetRenderReturn<any>>, required: true },\n /** 响应式全量表单值(FormRender 经 useSelector 建立,S1) */\n values: { type: Object as PropType<Record<string, unknown>>, required: true },\n },\n setup(props) {\n return () =>\n h(\n FormField,\n {\n name: String(props.item.key),\n validators: props.item.validators,\n },\n {\n default: ({ field }: any) => {\n if (!field) {\n if (import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <FormRenderField> 未取得 field 上下文(FormRender 缺 definition/form?)\",\n );\n }\n return null;\n }\n return h(\n FormItem,\n { class: props.item.class },\n {\n default: () => [\n props.item.hideLabel ? null : h(FormLabel, () => props.item.title),\n h(FormControl, () =>\n props.widget({\n field,\n item: props.item,\n values: props.values as never,\n }),\n ),\n props.item.description ? h(FormDescription, () => props.item.description) : null,\n h(FormMessage),\n ],\n },\n );\n },\n },\n );\n },\n});\n</script>\n"
41
+ },
42
+ {
43
+ "path": "form-render/define-form.ts",
44
+ "type": "registry:component",
45
+ "target": "components/ui/form-render/define-form.ts",
46
+ "content": "import { useFormRender, type UseFormRenderOptions } from \"./useFormRender\";\nimport type { FormRenderDefinition, FormRenderItem } from \"./types\";\n\nexport interface DefineFormOptions<T extends object> {\n items: FormRenderItem<T>[];\n /** Standard Schema(valibot v.object 输出直接兼容),映射到 TanStack validators.onSubmit */\n schema?: unknown;\n onSubmit?: (ctx: { value: T }) => void | Promise<void>;\n /** 其余 TanStack useForm 选项透传(如 onSubmitInvalid) */\n formOptions?: Record<string, unknown>;\n}\n\n/**\n * 聚合入口:单次调用完成「字段定义 + 类型约束 + 表单实例」。\n *\n * 返回 `{ items, form, resetToDefaults }`:\n * - `items` / `form` 传给 `<FormRender>`(支持 `:definition` 单 prop 或 `:form` + `:items` 拆分);\n * - `form` 可直接 `reset()` / `validate()` / `handleSubmit()`;\n * - `resetToDefaults()` 重置到 `items.default`(搜索表单\"重置\"语义)。\n *\n * 须在组件 setup 中调用(TanStack useForm 约束)。\n */\nexport function defineForm<T extends object>(\n config: DefineFormOptions<T>,\n): FormRenderDefinition<T> {\n return useFormRender<T>(config satisfies UseFormRenderOptions<T>);\n}\n"
47
+ },
48
+ {
49
+ "path": "form-render/index.ts",
50
+ "type": "registry:component",
51
+ "target": "components/ui/form-render/index.ts",
52
+ "content": "export { default as FormRender } from \"./FormRender.vue\";\nexport { defineForm, type DefineFormOptions } from \"./define-form\";\nexport { useFormRender, type UseFormRenderOptions } from \"./useFormRender\";\nexport { widgetRenders } from \"./widgets\";\nexport { bindField, CHECKED, MODEL_VALUE, SLIDER, VALUE, type BindingSpec } from \"./widgets/bind\";\nexport type {\n CheckboxWidgetOptions,\n CurrencyWidgetOptions,\n DatePickerWidgetOptions,\n DateRangeWidgetOptions,\n FormRenderDefinition,\n FormRenderFormApi,\n FormRenderItem,\n InputWidgetOptions,\n MonthPickerWidgetOptions,\n NumberWidgetOptions,\n PasswordWidgetOptions,\n RadioGroupWidgetOptions,\n SelectWidgetOptions,\n SfcOptions,\n SliderWidgetOptions,\n SwitchWidgetOptions,\n TextareaWidgetOptions,\n WidgetContext,\n WidgetItemOption,\n WidgetRenderReturn,\n WidgetRenders,\n YearPickerWidgetOptions,\n} from \"./types\";\n"
53
+ },
54
+ {
55
+ "path": "form-render/types.ts",
56
+ "type": "registry:component",
57
+ "target": "components/ui/form-render/types.ts",
58
+ "content": "import type { AnyFieldApi, FormApi, VueFormApi } from \"@tanstack/vue-form\";\nimport type { VNode } from \"vue\";\nimport type { Checkbox } from \"@/components/checkbox\";\nimport type { CurrencyInput } from \"@/components/currency-input\";\nimport type { DatePicker } from \"@/components/date-picker\";\nimport type { DateRangePicker } from \"@/components/date-range-picker\";\nimport type { Input } from \"@/components/input\";\nimport type { MonthPicker } from \"@/components/month-picker\";\nimport type { WeekPicker } from \"@/components/week-picker\";\nimport type { NumberInput } from \"@/components/number-input\";\nimport type { PasswordInput } from \"@/components/password-input\";\nimport type { RadioGroup } from \"@/components/radio-group\";\nimport type { Cascader } from \"@/components/cascader\";\nimport type { TreeSelect } from \"@/components/tree-select\";\nimport type { Select } from \"@/components/select\";\nimport type { Slider } from \"@/components/slider\";\nimport type { Switch } from \"@/components/switch\";\nimport type { Textarea } from \"@/components/textarea\";\nimport type { YearPicker } from \"@/components/year-picker\";\nimport type { SelectItemOption } from \"@/components/select\";\n\n/**\n * useForm() 返回实例的宽松形态(与 form/context.ts 的 FormInstance 同款契约:\n * provide/inject 与跨组件边界会擦除泛型,any 化是项目既定约定)。\n */\n/* prettier-ignore */\nexport type FormRenderFormApi =\n FormApi<any, any, any, any, any, any, any, any, any, any, any, any> &\n VueFormApi<any, any, any, any, any, any, any, any, any, any, any, any>;\n\n/** 字段渲染上下文(widget 柯里化第二段的唯一参数) */\nexport interface WidgetContext<T extends object> {\n field: AnyFieldApi;\n item: FormRenderItem<T>;\n /** 当前全量表单值(响应式,来自 form.useSelector(s => s.values);联动用) */\n values: T;\n}\n\nexport type WidgetRenderReturn<T extends object> = (ctx: WidgetContext<T>) => VNode;\n\n/** select/radioGroup 等选项的通用形态(字符串简写或 { label, value }) */\nexport type WidgetItemOption = string | SelectItemOption;\n\n/**\n * SFC props 类型派生(方案 C):widget 参数 = 原组件全部 props(命名穿透,\n * prop 变更时类型自动同步)。受控字段由 bindField/FormControl/items.default\n * 接管,用户不可传;Omit 不存在的键是 no-op,统一集合即可。\n */\ntype ControlledKey =\n | \"modelValue\"\n | \"onUpdate:modelValue\"\n | \"checked\"\n | \"onUpdate:checked\"\n | \"value\"\n | \"onUpdate:value\"\n | \"onBlur\"\n | \"invalid\"\n | \"class\"\n | \"id\"\n | \"defaultValue\"\n | \"defaultChecked\";\n\nexport type SfcOptions<T extends abstract new (...args: any) => any> = Partial<\n Omit<InstanceType<T>[\"$props\"], ControlledKey>\n>;\n\n// —— 各 widget 选项:组件全 props 派生(命名穿透) ——\n\nexport type NumberWidgetOptions = SfcOptions<typeof NumberInput>;\n\nexport type CurrencyWidgetOptions = SfcOptions<typeof CurrencyInput>;\n\n/** autoComplete 为 PasswordInput 真实 prop(探针实证),直接派生获得 */\nexport type PasswordWidgetOptions = SfcOptions<typeof PasswordInput>;\n\n/** Input 自身无 placeholder/type prop(原生 attr 透传),交叉手写 */\nexport type InputWidgetOptions = SfcOptions<typeof Input> & {\n placeholder?: string;\n type?: string;\n};\n\n/** Textarea 自身无 placeholder/rows prop(原生 attr 透传),交叉手写 */\nexport type TextareaWidgetOptions = SfcOptions<typeof Textarea> & {\n placeholder?: string;\n rows?: number;\n};\n\n/**\n * v3 命名穿透:选项字段即组件 prop 名 `items`——显式必填(Partial 化会退化为可选,\n * 缺失时 Select.vue collection 计算在首渲染崩溃);placeholder 已是 Select 单组件\n * 的正式 prop,不再 Omit,渲染时做 item 级缺省回退(I1)。\n */\nexport type SelectWidgetOptions = Omit<SfcOptions<typeof Select>, \"items\"> & {\n items: WidgetItemOption[];\n};\n\nexport type CheckboxWidgetOptions = SfcOptions<typeof Checkbox>;\n\nexport type SwitchWidgetOptions = SfcOptions<typeof Switch>;\n\n/**\n * radioGroup widget:单选组(值 prop 为 value)。items 为组件 required prop,\n * 显式必填(Partial 化会退化为可选);选项字段与组件 prop 同名(命名穿透)。\n * 注意:RadioGroup 不支持 Select 的字符串简写(无 normalize 回退,直传即崩),\n * 此处收窄为 SelectItemOption[] 而非 WidgetItemOption[]。\n */\nexport type RadioGroupWidgetOptions = Omit<SfcOptions<typeof RadioGroup>, \"items\"> & {\n items: SelectItemOption[];\n};\n\n/** TreeSelect / Cascader:选项 prop 原名 options,受控走 modelValue(ControlledKey 自动剔除) */\nexport type TreeSelectWidgetOptions = SfcOptions<typeof TreeSelect>;\n\nexport type CascaderWidgetOptions = SfcOptions<typeof Cascader>;\n\nexport type SliderWidgetOptions = SfcOptions<typeof Slider>;\n\n/** picker 三组件 props 面不同(DatePicker 有 isDateUnavailable/max/min,Month/Year 有 locale),各自派生 */\nexport type DatePickerWidgetOptions = SfcOptions<typeof DatePicker>;\n\nexport type MonthPickerWidgetOptions = SfcOptions<typeof MonthPicker>;\n\nexport type YearPickerWidgetOptions = SfcOptions<typeof YearPicker>;\n\nexport type DateRangeWidgetOptions = SfcOptions<typeof DateRangePicker>;\n\nexport type WeekPickerWidgetOptions = SfcOptions<typeof WeekPicker>;\n\n/**\n * widget 注册表类型契约:实现对象在 widgets/index.ts。\n * 类型集中于此避免循环依赖(type-only import 无运行时环)。\n */\nexport interface WidgetRenders<T extends object> {\n input(o?: InputWidgetOptions): WidgetRenderReturn<T>;\n password(o?: PasswordWidgetOptions): WidgetRenderReturn<T>;\n number(o?: NumberWidgetOptions): WidgetRenderReturn<T>;\n currency(o?: CurrencyWidgetOptions): WidgetRenderReturn<T>;\n textarea(o?: TextareaWidgetOptions): WidgetRenderReturn<T>;\n select(o: SelectWidgetOptions): WidgetRenderReturn<T>;\n checkbox(o?: CheckboxWidgetOptions): WidgetRenderReturn<T>;\n switch(o?: SwitchWidgetOptions): WidgetRenderReturn<T>;\n radioGroup(o: RadioGroupWidgetOptions): WidgetRenderReturn<T>;\n treeSelect(o: TreeSelectWidgetOptions): WidgetRenderReturn<T>;\n cascader(o: CascaderWidgetOptions): WidgetRenderReturn<T>;\n slider(o?: SliderWidgetOptions): WidgetRenderReturn<T>;\n datePicker(o?: DatePickerWidgetOptions): WidgetRenderReturn<T>;\n monthPicker(o?: MonthPickerWidgetOptions): WidgetRenderReturn<T>;\n yearPicker(o?: YearPickerWidgetOptions): WidgetRenderReturn<T>;\n dateRangePicker(o?: DateRangeWidgetOptions): WidgetRenderReturn<T>;\n weekPicker(o?: WeekPickerWidgetOptions): WidgetRenderReturn<T>;\n /** 逃逸口:完全自定义渲染 */\n render(fn: (ctx: WidgetContext<T>) => VNode): WidgetRenderReturn<T>;\n}\n\nexport interface FormRenderItem<T extends object> {\n /**\n * 字段名:严格 keyof T —— 自动补全 + 拼错编译报错。\n * 额外字段请在 T 中显式声明;运行时以 String(key) 归一为 FormField 的 name。\n */\n key: keyof T;\n title: string;\n description?: string;\n placeholder?: string;\n /**\n * 默认值(值或同步工厂);defineForm 据此派生 defaultValues。\n * 类型为 T 值域联合 T[keyof T](无 per-item 精确联动,强于 x-render 的 any)。\n */\n default?: T[keyof T] | (() => T[keyof T]);\n /** 栅格跨度:数字 = 占 n 列(须 ≤ 实际列数);\"full\" = 整行 */\n span?: number | \"full\";\n /** 联动显隐;消费 FormRender 经 useSelector 建立的响应式 values */\n visible?: boolean | ((values: T) => boolean);\n hideLabel?: boolean;\n class?: string;\n /** TanStack 字段级校验器透传(如 onChangeAsync) */\n validators?: Record<string, unknown>;\n /** widget 描述;缺省 = r.input() */\n render?: (r: WidgetRenders<T>) => WidgetRenderReturn<T>;\n /** 逃逸口:原样合并到控件 vnode 的 props */\n componentProps?: Record<string, unknown>;\n}\n\nexport interface FormRenderDefinition<T extends object> {\n items: FormRenderItem<T>[];\n form: FormRenderFormApi;\n /** 重置到 items.default(搜索表单\"重置\"语义) */\n resetToDefaults: () => void;\n}\n"
59
+ },
60
+ {
61
+ "path": "form-render/useFormRender.ts",
62
+ "type": "registry:component",
63
+ "target": "components/ui/form-render/useFormRender.ts",
64
+ "content": "import { useForm } from \"@tanstack/vue-form\";\nimport type { FormRenderDefinition, FormRenderItem } from \"./types\";\n\nexport interface UseFormRenderOptions<T extends object> {\n items: FormRenderItem<T>[];\n /** Standard Schema(valibot v.object 输出直接兼容),映射到 TanStack validators.onSubmit */\n schema?: unknown;\n onSubmit?: (ctx: { value: T }) => void | Promise<void>;\n /** 其余 TanStack useForm 选项透传(如 onSubmitInvalid) */\n formOptions?: Record<string, unknown>;\n}\n\n/**\n * 底层原语:包装 TanStack useForm(聚合入口 defineForm 内部也走这里)。\n *\n * - `defaultValues` 从 `items[].default` 派生(值或同步工厂,缺省 null)——单一真相源;\n * - 显式泛型 `useForm<T>`,保住 onSubmit `{ value: T }` 全链路推断;\n * - 须在组件 setup 中调用(TanStack useForm 内部 `onMounted(formApi.mount)`)。\n */\nexport function useFormRender<T extends object>(\n options: UseFormRenderOptions<T>,\n): FormRenderDefinition<T> {\n const { items, schema, onSubmit, formOptions } = options;\n\n const defaultValues = Object.fromEntries(\n items.map((item) => [\n String(item.key),\n typeof item.default === \"function\"\n ? (item.default as () => unknown)()\n : (item.default ?? null),\n ]),\n ) as T;\n\n // useForm 有 12 个必选泛型参数(validator 通道),validators 走 any 化宽松契约(同 context.ts FormInstance)\n const form = useForm<T, any, any, any, any, any, any, any, any, any, any, any>({\n defaultValues,\n // TanStack 默认在提交失败后 canSubmit=false 且 handleSubmit 被门控静默拦截,\n // 用户修正字段值后将永远无法再次提交(搜索表单致命)。\n // 放开门控:每次点击都执行完整校验流,失败走错误分发,成功才走 onSubmit。\n canSubmitWhenInvalid: true,\n ...(schema ? { validators: { onSubmit: schema } } : {}),\n ...(onSubmit ? { onSubmit: ({ value }) => onSubmit({ value }) } : {}),\n ...formOptions,\n });\n\n return { items, form, resetToDefaults: () => form.reset() };\n}\n"
65
+ },
66
+ {
67
+ "path": "form-render/widgets/bind.ts",
68
+ "type": "registry:component",
69
+ "target": "components/ui/form-render/widgets/bind.ts",
70
+ "content": "import type { AnyFieldApi } from \"@tanstack/vue-form\";\n\n/**\n * 值绑定形态描述:\n * - modelValue:大多数组件(Input/Password/Number/Currency/Textarea/picker 系/Select)\n * - checked:Checkbox/Switch\n * - value:RadioGroup\n * - SLIDER:Slider 特例 —— 值 prop 为 `value`,事件却是 `update:modelValue`,且数组语义(number ↔ [number])\n */\nexport interface BindingSpec {\n prop: string;\n event: string;\n /** field 值 → 控件 prop 的转换(slider: number → [number]) */\n toProp?: (value: unknown) => unknown;\n /** 控件事件 → field 值的转换(slider: [number] → number) */\n fromEvent?: (value: unknown) => unknown;\n}\n\nexport const MODEL_VALUE: BindingSpec = { prop: \"modelValue\", event: \"modelValue\" };\nexport const CHECKED: BindingSpec = { prop: \"checked\", event: \"checked\" };\nexport const VALUE: BindingSpec = { prop: \"value\", event: \"value\" };\nexport const SLIDER: BindingSpec = {\n prop: \"value\",\n event: \"modelValue\",\n toProp: (v) => (v === null || v === undefined ? undefined : [v]),\n fromEvent: (v) => (Array.isArray(v) ? (v[0] ?? null) : v),\n};\n\n/**\n * TanStack field → 控件 props 的统一绑定:\n * 值回显(field.state.value)+ 写回(handleChange)+ 失焦(handleBlur)。\n */\nexport function bindField(field: AnyFieldApi, spec: BindingSpec) {\n return {\n [spec.prop]: spec.toProp ? spec.toProp(field.state.value) : field.state.value,\n [`onUpdate:${spec.event}`]: (value: unknown) =>\n field.handleChange((spec.fromEvent ? spec.fromEvent(value) : value) as never),\n onBlur: field.handleBlur,\n };\n}\n"
71
+ },
72
+ {
73
+ "path": "form-render/widgets/boolean.ts",
74
+ "type": "registry:component",
75
+ "target": "components/ui/form-render/widgets/boolean.ts",
76
+ "content": "import { h } from \"vue\";\nimport { Checkbox } from \"@/components/checkbox\";\nimport { Switch } from \"@/components/switch\";\nimport type { CheckboxWidgetOptions, SwitchWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { CHECKED, bindField } from \"./bind\";\n\n/**\n * checkbox/switch widget:boolean 形态(值 prop 为 checked,非 modelValue)。\n * 单行布局倾向 hideLabel + label 经 item.title 展示由使用者决定。\n */\nexport function renderCheckboxItem<T extends object>(\n options: CheckboxWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Checkbox, {\n ...options,\n ...bindField(ctx.field, CHECKED),\n ...ctx.item.componentProps,\n });\n}\n\nexport function renderSwitchItem<T extends object>(\n options: SwitchWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Switch, {\n ...options,\n ...bindField(ctx.field, CHECKED),\n ...ctx.item.componentProps,\n });\n}\n"
77
+ },
78
+ {
79
+ "path": "form-render/widgets/index.ts",
80
+ "type": "registry:component",
81
+ "target": "components/ui/form-render/widgets/index.ts",
82
+ "content": "import type { WidgetRenders } from \"../types\";\nimport { renderCheckboxItem, renderSwitchItem } from \"./boolean\";\nimport {\n renderCurrencyItem,\n renderDatePickerItem,\n renderDateRangePickerItem,\n renderMonthPickerItem,\n renderNumberItem,\n renderPasswordItem,\n renderTextareaItem,\n renderYearPickerItem,\n renderWeekPickerItem,\n} from \"./model-value\";\nimport { renderInputItem } from \"./input\";\nimport { renderSelectItem } from \"./select\";\nimport { renderRadioGroupItem, renderSliderItem } from \"./value\";\nimport { renderCascaderItem, renderTreeSelectItem } from \"./tree\";\n\n/**\n * widget 注册表:`r.input({...})` 等柯里化工厂的运行时对象。\n * 文件按绑定形态聚合:input / model-value(modelValue 系)/ boolean(checked 系)/\n * value(radioGroup/slider)/ select(多子组件组装)。\n */\nexport function widgetRenders<T extends object>(): WidgetRenders<T> {\n return {\n input: renderInputItem<T>,\n password: renderPasswordItem<T>,\n number: renderNumberItem<T>,\n currency: renderCurrencyItem<T>,\n textarea: renderTextareaItem<T>,\n select: renderSelectItem<T>,\n checkbox: renderCheckboxItem<T>,\n switch: renderSwitchItem<T>,\n radioGroup: renderRadioGroupItem<T>,\n treeSelect: renderTreeSelectItem<T>,\n cascader: renderCascaderItem<T>,\n slider: renderSliderItem<T>,\n datePicker: renderDatePickerItem<T>,\n monthPicker: renderMonthPickerItem<T>,\n yearPicker: renderYearPickerItem<T>,\n dateRangePicker: renderDateRangePickerItem<T>,\n weekPicker: renderWeekPickerItem<T>,\n render: (fn) => fn,\n };\n}\n"
83
+ },
84
+ {
85
+ "path": "form-render/widgets/input.ts",
86
+ "type": "registry:component",
87
+ "target": "components/ui/form-render/widgets/input.ts",
88
+ "content": "import { h } from \"vue\";\nimport { Input } from \"@/components/input\";\nimport type { InputWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/** input widget:单行文本输入(placeholder 为原生 attr 透传,aria-invalid 由 FormControl 接线) */\nexport function renderInputItem<T extends object>(\n options: InputWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Input, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n"
89
+ },
90
+ {
91
+ "path": "form-render/widgets/model-value.ts",
92
+ "type": "registry:component",
93
+ "target": "components/ui/form-render/widgets/model-value.ts",
94
+ "content": "import type { Component } from \"vue\";\nimport { h } from \"vue\";\nimport { CurrencyInput } from \"@/components/currency-input\";\nimport { DatePicker } from \"@/components/date-picker\";\nimport { DateRangePicker } from \"@/components/date-range-picker\";\nimport { MonthPicker } from \"@/components/month-picker\";\nimport { NumberInput } from \"@/components/number-input\";\nimport { PasswordInput } from \"@/components/password-input\";\nimport { Textarea } from \"@/components/textarea\";\nimport { WeekPicker } from \"@/components/week-picker\";\nimport { YearPicker } from \"@/components/year-picker\";\nimport type {\n CurrencyWidgetOptions,\n DatePickerWidgetOptions,\n DateRangeWidgetOptions,\n MonthPickerWidgetOptions,\n NumberWidgetOptions,\n PasswordWidgetOptions,\n TextareaWidgetOptions,\n WeekPickerWidgetOptions,\n WidgetRenderReturn,\n YearPickerWidgetOptions,\n} from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/**\n * modelValue 形态 widgets 统一展开模式(方案 C):\n * item 级缺省 → options 整体展开(命名穿透,组件全 props)→ 受控绑定 → 逃逸口。\n * options.placeholder 为 undefined 时 Vue 视为未传,item 级缺省保留(I1 语义)。\n */\n\n/** password widget:密码输入(autoComplete 为组件真实 prop,直接派生透传) */\nexport function renderPasswordItem<T extends object>(\n options: PasswordWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(PasswordInput, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/** number widget:数值输入(modelValue: number|null) */\nexport function renderNumberItem<T extends object>(\n options: NumberWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(NumberInput, {\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/** currency widget:金额输入(labelUnit/valueUnit 单位展示) */\nexport function renderCurrencyItem<T extends object>(\n options: CurrencyWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(CurrencyInput, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/** textarea widget:多行文本(placeholder/rows 为原生 attr 透传) */\nexport function renderTextareaItem<T extends object>(\n options: TextareaWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Textarea, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * 日期类 widget 共用工厂:入口各自携带强类型(DatePicker/Month/Year/DateRange 的\n * props 面互不相同,见 types.ts 各派生接口),内部共享实现无需重复泛型关联。\n */\nfunction pickerRenderer(component: Component, options: object): WidgetRenderReturn<any> {\n return (ctx) =>\n h(component, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\nexport function renderDatePickerItem<T extends object>(\n options: DatePickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(DatePicker, options);\n}\n\nexport function renderMonthPickerItem<T extends object>(\n options: MonthPickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(MonthPicker, options);\n}\n\nexport function renderYearPickerItem<T extends object>(\n options: YearPickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(YearPicker, options);\n}\n\n/** dateRangePicker widget:[start, end] | null 形态 */\nexport function renderDateRangePickerItem<T extends object>(\n options: DateRangeWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(DateRangePicker, options);\n}\n\nexport function renderWeekPickerItem<T extends object>(\n options: WeekPickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(WeekPicker, options);\n}\n"
95
+ },
96
+ {
97
+ "path": "form-render/widgets/select.ts",
98
+ "type": "registry:component",
99
+ "target": "components/ui/form-render/widgets/select.ts",
100
+ "content": "import { h } from \"vue\";\nimport { Select } from \"@/components/select\";\nimport type { SelectWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/**\n * select widget:Select 已单组件化,items/placeholder 均为正式 prop 直写。\n * v3 命名穿透:options 整体透传给 Select(内部做 string 归一化);\n * placeholder 解构出来做 item 级缺省回退(options 优先,I1 语义)。\n */\nexport function renderSelectItem<T extends object>(\n options: SelectWidgetOptions,\n): WidgetRenderReturn<T> {\n const { placeholder, items, ...rootProps } = options;\n return (ctx) =>\n h(Select, {\n ...rootProps,\n items,\n placeholder: placeholder ?? ctx.item.placeholder,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n"
101
+ },
102
+ {
103
+ "path": "form-render/widgets/tree.ts",
104
+ "type": "registry:component",
105
+ "target": "components/ui/form-render/widgets/tree.ts",
106
+ "content": "import type { ComponentPublicInstance } from \"vue\";\nimport { h } from \"vue\";\nimport { Cascader } from \"@/components/cascader\";\nimport { TreeSelect } from \"@/components/tree-select\";\nimport type { CascaderWidgetOptions, TreeSelectWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/**\n * treeSelect / cascader widget:树形选项族(modelValue 受控形态)。\n * 命名穿透:options 原名直传(TreeOption:key/label/children/disabled);\n * placeholder 先用 item 级回退(I1),options.placeholder 展开时覆盖。\n *\n * 断言说明:两组件的 boolean props(multiple/checkable/clearable…)为裸\n * `Boolean, default: false` 声明,vue-tsc ExtractPropTypes 将其推断为 required,\n * spread Partial 必缺键;断言到 $props 同源类型保留键名检查(优于 as never)。\n */\ntype SfcAllProps<C> = C extends abstract new (...args: never[]) => any\n ? Partial<ComponentPublicInstance[\"$props\"]> & InstanceType<C>[\"$props\"]\n : never;\n\nexport function renderTreeSelectItem<T extends object>(\n options: TreeSelectWidgetOptions,\n): WidgetRenderReturn<T> {\n const { placeholder, ...rest } = options;\n return (ctx) =>\n h(TreeSelect, {\n placeholder: placeholder ?? ctx.item.placeholder,\n ...rest,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n } as SfcAllProps<typeof TreeSelect>);\n}\n\nexport function renderCascaderItem<T extends object>(\n options: CascaderWidgetOptions,\n): WidgetRenderReturn<T> {\n const { placeholder, ...rest } = options;\n return (ctx) =>\n h(Cascader, {\n placeholder: placeholder ?? ctx.item.placeholder,\n ...rest,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n } as SfcAllProps<typeof Cascader>);\n}\n"
107
+ },
108
+ {
109
+ "path": "form-render/widgets/value.ts",
110
+ "type": "registry:component",
111
+ "target": "components/ui/form-render/widgets/value.ts",
112
+ "content": "import { h } from \"vue\";\nimport { RadioGroup } from \"@/components/radio-group\";\nimport { Slider } from \"@/components/slider\";\nimport type { RadioGroupWidgetOptions, SliderWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { SLIDER, VALUE, bindField } from \"./bind\";\n\n/**\n * radioGroup widget:单选组(值 prop 为 value)。\n * 命名穿透:选项字段为组件 required prop `items`,整体直传,widget 不做组装。\n */\nexport function renderRadioGroupItem<T extends object>(\n options: RadioGroupWidgetOptions,\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(RadioGroup, {\n ...options,\n ...bindField(ctx.field, VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * slider widget:number ↔ number[] 混合绑定特例\n * (值 prop 为 `value`,事件却是 `update:modelValue` 且数组语义,由 SLIDER spec 转换)。\n */\nexport function renderSliderItem<T extends object>(\n options: SliderWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Slider, {\n ...options,\n ...bindField(ctx.field, SLIDER),\n ...ctx.item.componentProps,\n });\n}\n"
113
+ }
114
+ ]
115
+ }
@@ -16,7 +16,7 @@
16
16
  "path": "form/FormControl.vue",
17
17
  "type": "registry:component",
18
18
  "target": "components/ui/form/FormControl.vue",
19
- "content": "<script lang=\"ts\">\nimport { cloneVNode, computed, defineComponent, inject } from \"vue\";\nimport { FIELD_KEY, FORM_ITEM_KEY } from \"./context\";\n\n/**\n * 把 id / aria-invalid / aria-describedby 合并到唯一子元素(cloneVNode)。\n * aria 全同步计算:description/message 的 presence 由 FormItem 的 refs 提供。\n */\nexport default defineComponent({\n name: \"TuFormControl\",\n props: {\n class: { type: String, default: undefined },\n },\n setup(props, { slots }) {\n const fieldCtx = inject(FIELD_KEY, undefined);\n const itemCtx = inject(FORM_ITEM_KEY, undefined);\n\n if (import.meta.env.DEV && (!fieldCtx || !itemCtx)) {\n console.warn(\"[tu-design] <FormControl> 必须在 <FormField> + <FormItem> 内使用\");\n }\n\n const isInvalid = computed(() => (fieldCtx?.field.value?.state.meta.errors.length ?? 0) > 0);\n const describedBy = computed(() => {\n if (!itemCtx) return undefined;\n const ids = [\n itemCtx.hasDescription.value && itemCtx.descriptionId,\n itemCtx.hasMessage.value && itemCtx.isInvalid.value && itemCtx.messageId,\n ].filter(Boolean);\n return ids.length > 0 ? ids.join(\" \") : undefined;\n });\n\n return () => {\n const vnodes = slots.default?.() ?? [];\n if (import.meta.env.DEV && vnodes.length !== 1) {\n console.warn(\"[tu-design] <FormControl> 需要且仅需要一个子元素\");\n }\n const first = vnodes[0];\n if (!first) return null;\n return cloneVNode(first, {\n id: itemCtx?.controlId,\n \"aria-invalid\": isInvalid.value || undefined,\n \"aria-describedby\": describedBy.value,\n class: props.class,\n });\n };\n },\n});\n</script>\n"
19
+ "content": "<script lang=\"ts\">\nimport { cloneVNode, computed, defineComponent, inject } from \"vue\";\nimport { FIELD_KEY, FORM_ITEM_KEY } from \"./context\";\n\n/**\n * 把 id / aria-invalid / aria-describedby 合并到唯一子元素(cloneVNode)。\n * aria 全同步计算:description/message 的 presence 由 FormItem 的 refs 提供。\n */\nexport default defineComponent({\n name: \"TuFormControl\",\n props: {\n class: { type: String, default: undefined },\n },\n setup(props, { slots }) {\n const fieldCtx = inject(FIELD_KEY, undefined);\n const itemCtx = inject(FORM_ITEM_KEY, undefined);\n\n if (import.meta.env.DEV && (!fieldCtx || !itemCtx)) {\n console.warn(\"[tu-design] <FormControl> 必须在 <FormField> + <FormItem> 内使用\");\n }\n\n const isInvalid = computed(() => itemCtx?.isInvalid.value ?? false);\n const describedBy = computed(() => {\n if (!itemCtx) return undefined;\n const ids = [\n itemCtx.hasDescription.value && itemCtx.descriptionId,\n itemCtx.hasMessage.value && itemCtx.isInvalid.value && itemCtx.messageId,\n ].filter(Boolean);\n return ids.length > 0 ? ids.join(\" \") : undefined;\n });\n\n return () => {\n const vnodes = slots.default?.() ?? [];\n if (import.meta.env.DEV && vnodes.length !== 1) {\n console.warn(\"[tu-design] <FormControl> 需要且仅需要一个子元素\");\n }\n const first = vnodes[0];\n if (!first) return null;\n return cloneVNode(first, {\n id: itemCtx?.controlId,\n \"aria-invalid\": isInvalid.value || undefined,\n \"aria-describedby\": describedBy.value,\n class: props.class,\n });\n };\n },\n});\n</script>\n"
20
20
  },
21
21
  {
22
22
  "path": "form/FormDescription.vue",
@@ -28,7 +28,7 @@
28
28
  "path": "form/FormField.vue",
29
29
  "type": "registry:component",
30
30
  "target": "components/ui/form/FormField.vue",
31
- "content": "<script lang=\"ts\">\nimport type { AnyFieldApi } from \"@tanstack/vue-form\";\nimport type { PropType } from \"vue\";\nimport { defineComponent, h, inject, provide, shallowRef } from \"vue\";\nimport { FIELD_KEY, FORM_KEY } from \"./context\";\n\n/**\n * 渲染 TanStack `form.Field` 并经 provide 下发 field 上下文。\n * field 实例只能在 form.Field 的插槽执行期取得(时序早于子组件 setup),\n * 故用 defineComponent + render function 在插槽回调中写入 ShallowRef。\n */\nexport default defineComponent({\n name: \"TuFormField\",\n props: {\n /** 字段名(TanStack 深层 key 的运行时形态) */\n name: { type: String, required: true },\n /** 校验器配置,原样透传(值可为函数或 Standard Schema,如 valibot) */\n validators: { type: Object as PropType<Record<string, unknown>>, default: undefined },\n },\n setup(props, { slots }) {\n const form = inject(FORM_KEY);\n if (!form && import.meta.env.DEV) {\n console.warn(\"[tu-design] <FormField> 必须在 <Form> 内使用\");\n }\n\n const fieldRef = shallowRef<AnyFieldApi>();\n provide(FIELD_KEY, { field: fieldRef, name: props.name });\n\n if (!form) {\n // 优雅降级:field 上下文缺席(FIELD_KEY.field 为 undefined),子组件需自行容忍\n return () => slots.default?.({ field: undefined as unknown as AnyFieldApi });\n }\n\n return () =>\n h(form.Field as never, { name: props.name, validators: props.validators } as never, {\n default: (slotProps: { field: AnyFieldApi }) => {\n fieldRef.value = slotProps.field;\n return slots.default?.(slotProps);\n },\n });\n },\n});\n</script>\n"
31
+ "content": "<script lang=\"ts\">\nimport type { AnyFieldApi } from \"@tanstack/vue-form\";\nimport type { PropType } from \"vue\";\nimport { defineComponent, h, inject, provide, shallowRef } from \"vue\";\nimport { FIELD_KEY, FORM_KEY } from \"./context\";\n\n/**\n * 渲染 TanStack `form.Field` 并经 provide 下发 field 上下文。\n * field 实例只能在 form.Field 的插槽执行期取得(时序早于子组件 setup),\n * 故用 defineComponent + render function 在插槽回调中写入 ShallowRef。\n */\nexport default defineComponent({\n name: \"TuFormField\",\n props: {\n /** 字段名(TanStack 深层 key 的运行时形态) */\n name: { type: String, required: true },\n /** 校验器配置,原样透传(值可为函数或 Standard Schema,如 valibot) */\n validators: { type: Object as PropType<Record<string, unknown>>, default: undefined },\n /** 字段模式:value 单值(默认);array 数组字段,解锁 pushValue/removeValue 等行操作 */\n mode: { type: String as PropType<\"value\" | \"array\">, default: \"value\" },\n },\n setup(props, { slots }) {\n const form = inject(FORM_KEY);\n if (!form && import.meta.env.DEV) {\n console.warn(\"[tu-design] <FormField> 必须在 <Form> 内使用\");\n }\n\n const fieldRef = shallowRef<AnyFieldApi>();\n provide(FIELD_KEY, { field: fieldRef, name: props.name });\n\n if (!form) {\n // 优雅降级:field 上下文缺席(FIELD_KEY.field 为 undefined),子组件需自行容忍\n return () => slots.default?.({ field: undefined as unknown as AnyFieldApi });\n }\n\n return () =>\n h(\n form.Field as never,\n { name: props.name, validators: props.validators, mode: props.mode } as never,\n {\n default: (slotProps: { field: AnyFieldApi }) => {\n fieldRef.value = slotProps.field;\n return slots.default?.(slotProps);\n },\n },\n );\n },\n});\n</script>\n"
32
32
  },
33
33
  {
34
34
  "path": "form/FormItem.vue",
@@ -0,0 +1,22 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "month-picker",
4
+ "type": "registry:ui",
5
+ "description": "月份选择器:输入框 + 锁定月视图的日历弹层,值以 \"yyyy-MM\" 字符串受控,min/max 为月粒度闭区间(内部换算到当月末日)。",
6
+ "registryDependencies": ["utils", "date-shared", "calendar"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "files": [
9
+ {
10
+ "path": "month-picker/MonthPicker.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/month-picker/MonthPicker.vue",
13
+ "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport { DatePicker as ArkDatePicker } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide, ref } from \"vue\";\nimport { cn } from \"@/lib/utils\";\nimport { Calendar as TCalendar } from \"../calendar\";\n// SFC 仅 default export,必须默认导入\nimport CalendarIcon from \"../date-shared/CalendarIcon.vue\";\nimport ClearIcon from \"../date-shared/ClearIcon.vue\";\nimport {\n CALENDAR_IN_PICKER,\n controlCls,\n formatIsoMonth,\n iconBtnCls,\n parseIsoMonth,\n} from \"../date-shared/shared\";\n\nconst props = defineProps({\n /** 受控月份(\"yyyy-MM\");undefined 走内部非受控,null 表示空 */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n /** 非受控初值(\"yyyy-MM\") */\n defaultValue: { type: String, default: undefined },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n placeholder: { type: String, default: \"请选择月份\" },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 可选下界(\"yyyy-MM\",含当月) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy-MM\",含当月) */\n max: { type: String, default: undefined },\n /** 选中后是否自动关弹层 */\n closeOnSelect: { type: Boolean, default: true },\n /** 文案与周起点跟随 locale */\n locale: { type: String, default: \"zh-CN\" },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n \"update:open\": [open: boolean];\n}>();\n\n// attrs(id/aria-*)转发给真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root,值归本 Picker)\nprovide(CALENDAR_IN_PICKER, true);\n\n// —— 受控桥接(与 DatePicker 同款简化版:单值无 mirror 需求)——\nconst internalValue = ref<string | null>(props.defaultValue ?? null);\nconst selected = computed(() => {\n const raw = props.modelValue !== undefined ? props.modelValue : internalValue.value;\n return parseIsoMonth(raw ?? \"\");\n});\n// zag value 为 DateValue[] 数组形态,单选语义收敛为 [date] | []\nconst rootValue = computed<DateValue[]>(() => (selected.value ? [selected.value] : []));\n\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nconst minDate = computed(() => parseIsoMonth(props.min ?? \"\"));\n// zag 月格值继承 focusedValue 的 day(normalizeValue: focusedValue.set({month}),可能是\n// 今天/已选值的 day)→ max 锚当月 1 日会误禁当月,须换算当月末日\n// (CalendarDate.set 内部 constrain,day=31 自动收敛到月末)\nconst maxDate = computed<DateValue | undefined>(() => {\n const anchor = parseIsoMonth(props.max ?? \"\");\n return anchor ? anchor.set({ day: 31 }) : undefined;\n});\n\nfunction handleValueUpdate(next: DateValue[]) {\n const value = next[0] ? formatIsoMonth(next[0]) : null;\n internalValue.value = value;\n emit(\"update:modelValue\", value);\n}\n\nfunction handleOpenUpdate(next: boolean) {\n internalOpen.value = next;\n emit(\"update:open\", next);\n}\n\n// 点击/键盘 ↓ 输入框即开弹层(zag 默认仅 Trigger 开,openOnClick prop 默认关闭;\n// 显式驱动保证各环境行为一致并显式走受控 emit)\nfunction openFromInput() {\n if (props.disabled || props.readOnly || isOpen.value) return;\n handleOpenUpdate(true);\n}\n</script>\n\n<template>\n <ArkDatePicker.Root\n :model-value=\"rootValue\"\n :open=\"isOpen\"\n :locale=\"props.locale\"\n :min-view=\"'month'\"\n :max-view=\"'month'\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :close-on-select=\"props.closeOnSelect\"\n :read-only=\"props.readOnly\"\n :disabled=\"props.disabled\"\n :format=\"formatIsoMonth\"\n :parse=\"parseIsoMonth\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"handleOpenUpdate\"\n >\n <ArkDatePicker.Control\n :class=\"cn(controlCls, props.class)\"\n :data-invalid=\"props.invalid ? '' : undefined\"\n >\n <ArkDatePicker.Input\n v-bind=\"$attrs\"\n :placeholder=\"props.placeholder\"\n :aria-invalid=\"props.invalid || undefined\"\n class=\"bg-transparent h-full w-full min-w-0 flex-1 px-3 text-sm tabular-nums outline-none\"\n @click=\"openFromInput\"\n @keydown.down.prevent=\"openFromInput\"\n />\n <ArkDatePicker.ClearTrigger :class=\"iconBtnCls\">\n <ClearIcon />\n </ArkDatePicker.ClearTrigger>\n <ArkDatePicker.Trigger :class=\"iconBtnCls\">\n <CalendarIcon />\n </ArkDatePicker.Trigger>\n </ArkDatePicker.Control>\n\n <!-- 弹层 Teleport 到 body:脱离表单 DOM——隔离外层 FormControl 的 group class\n (group-hover 会污染面板内全部格子),并消除 overflow 容器裁剪弹层的隐患。 -->\n <Teleport to=\"body\">\n <ArkDatePicker.Positioner class=\"z-50\">\n <ArkDatePicker.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 relative z-50 rounded-md border shadow-md',\n )\n \"\n >\n <TCalendar mode=\"month\" />\n </ArkDatePicker.Content>\n </ArkDatePicker.Positioner>\n </Teleport>\n </ArkDatePicker.Root>\n</template>\n"
14
+ },
15
+ {
16
+ "path": "month-picker/index.ts",
17
+ "type": "registry:component",
18
+ "target": "components/ui/month-picker/index.ts",
19
+ "content": "export { default as MonthPicker } from \"./MonthPicker.vue\";\n"
20
+ }
21
+ ]
22
+ }
@@ -10,7 +10,7 @@
10
10
  "path": "number-input/NumberInput.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/number-input/NumberInput.vue",
13
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { NumberInput as ArkNumberInput } from \"@ark-ui/vue/number-input\";\nimport { cn } from \"@/lib/utils\";\nimport { numberOrNull } from \"./utils\";\n\nconst props = defineProps({\n /** 受控值:number 或 null(空);undefined 走内部非受控 */\n modelValue: { type: Number as PropType<number | null | undefined>, default: undefined },\n min: { type: Number, default: undefined },\n max: { type: Number, default: undefined },\n step: { type: Number, default: undefined },\n formatOptions: { type: Object as PropType<Intl.NumberFormatOptions>, default: undefined },\n // default: undefined 禁用 Boolean casting(Checkbox/Dialog 同款约定)\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:modelValue\": [value: number | null] }>();\n\n// attrs(id/aria-*)转发给内部真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 对 Ark Root 恒走受控模式,非受控语义由内部 ref 实现(Checkbox 同款)\nconst internalValue = ref<number | null>(null);\nconst current = computed(() =>\n props.modelValue === undefined ? internalValue.value : props.modelValue,\n);\n\n/** number → Ark 受控 string(null/NaN → 空串) */\nconst arkValue = computed(() =>\n current.value == null || Number.isNaN(current.value) ? \"\" : String(current.value),\n);\n\n/** Ark details(value: string / valueAsNumber: number)→ number|null(空串/NaN 归一 null) */\nfunction handleValueChange(details: { value: string; valueAsNumber: number }) {\n const next = numberOrNull(details);\n internalValue.value = next;\n emit(\"update:modelValue\", next);\n}\n</script>\n\n<template>\n <ArkNumberInput.Root\n :model-value=\"arkValue\"\n :min=\"props.min\"\n :max=\"props.max\"\n :step=\"props.step\"\n :format-options=\"props.formatOptions\"\n :disabled=\"props.disabled\"\n :invalid=\"props.invalid\"\n :class=\"\n cn(\n 'border-input flex h-9 items-stretch overflow-hidden rounded-md border shadow-sm transition-[color,box-shadow] outline-none data-invalid:border-destructive data-invalid:ring-destructive/20 data-invalid:ring-[3px]',\n props.class,\n )\n \"\n @value-change=\"handleValueChange\"\n >\n <ArkNumberInput.DecrementTrigger\n :class=\"'bg-muted/50 hover:bg-accent flex w-9 shrink-0 items-center justify-center border-r text-muted-foreground text-sm transition-colors disabled:cursor-not-allowed disabled:opacity-50'\"\n >\n <slot name=\"decrement\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n </svg>\n </slot>\n </ArkNumberInput.DecrementTrigger>\n <ArkNumberInput.Input\n v-bind=\"$attrs\"\n :class=\"'bg-transparent flex-1 min-w-0 px-1 text-center text-sm outline-none disabled:cursor-not-allowed'\"\n />\n <ArkNumberInput.IncrementTrigger\n :class=\"'bg-muted/50 hover:bg-accent flex w-9 shrink-0 items-center justify-center border-l text-muted-foreground text-sm transition-colors disabled:cursor-not-allowed disabled:opacity-50'\"\n >\n <slot name=\"increment\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n <path d=\"M12 5v14\" />\n </svg>\n </slot>\n </ArkNumberInput.IncrementTrigger>\n </ArkNumberInput.Root>\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { NumberInput as ArkNumberInput } from \"@ark-ui/vue/number-input\";\nimport { cn } from \"@/lib/utils\";\nimport { numberOrNull } from \"./utils\";\n\nconst props = defineProps({\n /** 受控值:number 或 null(空);undefined 走内部非受控 */\n modelValue: { type: Number as PropType<number | null | undefined>, default: undefined },\n min: { type: Number, default: undefined },\n max: { type: Number, default: undefined },\n step: { type: Number, default: undefined },\n formatOptions: { type: Object as PropType<Intl.NumberFormatOptions>, default: undefined },\n // default: undefined 禁用 Boolean casting(Checkbox/Dialog 同款约定)\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:modelValue\": [value: number | null] }>();\n\n// attrs(id/aria-*)转发给内部真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 对 Ark Root 恒走受控模式,非受控语义由内部 ref 实现(Checkbox 同款)\nconst internalValue = ref<number | null>(null);\nconst current = computed(() =>\n props.modelValue === undefined ? internalValue.value : props.modelValue,\n);\n\n/** number → Ark 受控 string(null/NaN → 空串) */\nconst arkValue = computed(() =>\n current.value == null || Number.isNaN(current.value) ? \"\" : String(current.value),\n);\n\n/** Ark details(value: string / valueAsNumber: number)→ number|null(空串/NaN 归一 null) */\nfunction handleValueChange(details: { value: string; valueAsNumber: number }) {\n const next = numberOrNull(details);\n internalValue.value = next;\n emit(\"update:modelValue\", next);\n}\n</script>\n\n<template>\n <ArkNumberInput.Root\n :model-value=\"arkValue\"\n :min=\"props.min\"\n :max=\"props.max\"\n :step=\"props.step\"\n :format-options=\"props.formatOptions\"\n :disabled=\"props.disabled\"\n :invalid=\"props.invalid\"\n :class=\"\n cn(\n 'border-input flex h-9 items-stretch overflow-hidden rounded-md border shadow-sm transition-[color,box-shadow] outline-none focus-within:border-ring focus-within:ring-ring/50 focus-within:ring-[3px] data-invalid:border-destructive data-invalid:ring-destructive/20 data-invalid:ring-[3px]',\n props.class,\n )\n \"\n @value-change=\"handleValueChange\"\n >\n <ArkNumberInput.DecrementTrigger\n :class=\"'bg-muted/50 hover:bg-accent flex w-9 shrink-0 items-center justify-center border-r text-muted-foreground text-sm transition-colors disabled:cursor-not-allowed disabled:opacity-50'\"\n >\n <slot name=\"decrement\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n </svg>\n </slot>\n </ArkNumberInput.DecrementTrigger>\n <ArkNumberInput.Input\n v-bind=\"$attrs\"\n :class=\"'bg-transparent flex-1 min-w-0 px-1 text-center text-sm outline-none disabled:cursor-not-allowed'\"\n />\n <ArkNumberInput.IncrementTrigger\n :class=\"'bg-muted/50 hover:bg-accent flex w-9 shrink-0 items-center justify-center border-l text-muted-foreground text-sm transition-colors disabled:cursor-not-allowed disabled:opacity-50'\"\n >\n <slot name=\"increment\">\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n <path d=\"M12 5v14\" />\n </svg>\n </slot>\n </ArkNumberInput.IncrementTrigger>\n </ArkNumberInput.Root>\n</template>\n"
14
14
  },
15
15
  {
16
16
  "path": "number-input/index.ts",
@@ -2,7 +2,7 @@
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "popover",
4
4
  "type": "registry:ui",
5
- "description": "气泡弹层:基于 Ark UI Popover 原语,受控/非受控开关,Trigger 支持 asChild。",
5
+ "description": "气泡弹层:基于 Ark UI Popover 原语的单组件,默认插槽为触发元素本体(asChild 语义),面板内容放 #content 插槽,受控/非受控开关。",
6
6
  "registryDependencies": ["utils"],
7
7
  "dependencies": ["@ark-ui/vue@^5.39.2"],
8
8
  "files": [
@@ -10,25 +10,13 @@
10
10
  "path": "popover/Popover.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/popover/Popover.vue",
13
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\n\ninterface Props {\n /** 受控开关(配合 v-model:open);不传时为非受控 */\n open?: boolean;\n defaultOpen?: boolean;\n lazyMount?: boolean;\n unmountOnExit?: boolean;\n}\n\n// open 用 default: undefined 禁用 Boolean casting,保证「未传」可辨(Dialog 同款约定)\nconst props = defineProps({\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n lazyMount: { type: Boolean, default: false },\n unmountOnExit: { type: Boolean, default: false },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式,非受控语义由内部 ref 实现(Dialog 同款)\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n</script>\n\n<template>\n <ArkPopover.Root\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"handleUpdate\"\n >\n <slot />\n </ArkPopover.Root>\n</template>\n"
14
- },
15
- {
16
- "path": "popover/PopoverContent.vue",
17
- "type": "registry:component",
18
- "target": "components/ui/popover/PopoverContent.vue",
19
- "content": "<script setup lang=\"ts\">\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport { cn } from \"@/lib/utils\";\n\ninterface Props {\n class?: string;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkPopover.Positioner class=\"z-50\">\n <ArkPopover.Content\n :class=\"\n cn(\n 'bg-popover text-popover-foreground z-50 w-72 rounded-md border p-4 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 props.class,\n )\n \"\n >\n <slot />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n</template>\n"
20
- },
21
- {
22
- "path": "popover/PopoverTrigger.vue",
23
- "type": "registry:component",
24
- "target": "components/ui/popover/PopoverTrigger.vue",
25
- "content": "<script setup lang=\"ts\">\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\n\ninterface Props {\n /** 以默认插槽子元素为渲染目标,行为合并其上 */\n asChild?: boolean;\n}\n\nconst props = defineProps<Props>();\n</script>\n\n<template>\n <ArkPopover.Trigger :as-child=\"props.asChild\">\n <slot />\n </ArkPopover.Trigger>\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport type { ClassValue } from \"clsx\";\nimport type { PropType } from \"vue\";\nimport { computed, ref, useAttrs } from \"vue\";\nimport type { PopoverRootProps } from \"@ark-ui/vue/popover\";\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport { cn } from \"@/lib/utils\";\n\n/** 面板相对触发器的对齐方向 */\ntype Align = \"start\" | \"center\" | \"end\";\n\n/** Ark Popover Root 的 positioning 配置(placement 含四方向 × 对齐组合) */\ntype ArkPositioning = NonNullable<PopoverRootProps[\"positioning\"]>;\ntype ArkPlacement = NonNullable<ArkPositioning[\"placement\"]>;\n\ndefineOptions({ inheritAttrs: false });\n\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 /** 面板相对触发器的对齐方向(默认居中);attrs.positioning.placement 显式给出时以其为准 */\n align: { type: String as PropType<Align>, default: \"center\" },\n /** 追加/覆盖面板样式类(默认 w-72 可由此覆盖,如 \"w-56 p-0\") */\n contentClass: { type: String, default: undefined },\n /** 透传到面板根元素上的属性(id/style/data-* 等,class 请用 contentClass) */\n contentProps: { type: Object as PropType<Record<string, unknown>>, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// attrs(positioning/modal 等 Ark Root 属性)手动转发,便于与 align 合并出 positioning\nconst attrs = useAttrs();\n\n// —— 受控桥接(Dialog 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst internalOpen = ref(props.defaultOpen);\nconst isOpen = computed(() => props.open ?? internalOpen.value);\n\nfunction handleUpdate(open: boolean) {\n internalOpen.value = open;\n emit(\"update:open\", open);\n}\n\n// align → Ark positioning.placement(横轴对齐,主轴默认 bottom 与 Ark 原语一致);\n// 外部经 attrs 传入的 positioning 已显式指定 placement 时以其为准,其余字段原样合并\nconst rootPositioning = computed<ArkPositioning>(() => {\n const user = (attrs.positioning ?? {}) as ArkPositioning;\n if (user.placement) return user;\n const placement = (props.align === \"center\" ? \"bottom\" : `bottom-${props.align}`) as ArkPlacement;\n return { ...user, placement };\n});\n\n// 面板样式:内置类 + contentClass + contentProps.class 三方合并(twMerge 自动去冲突,后者优先)\nconst contentClass = computed(() =>\n cn(\n \"bg-popover text-popover-foreground z-50 w-72 rounded-md border p-4 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 props.contentClass,\n props.contentProps?.[\"class\"] as ClassValue,\n ),\n);\n</script>\n\n<template>\n <ArkPopover.Root\n v-bind=\"attrs\"\n :open=\"isOpen\"\n :positioning=\"rootPositioning\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"handleUpdate\"\n >\n <!-- 默认插槽即触发元素本体(asChild 语义合并到子元素,不额外包裹,原 PopoverTrigger 同款实现) -->\n <ArkPopover.Trigger as-child>\n <slot />\n </ArkPopover.Trigger>\n <ArkPopover.Positioner class=\"z-50\">\n <ArkPopover.Content v-bind=\"props.contentProps\" :class=\"contentClass\">\n <slot name=\"content\" />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </ArkPopover.Root>\n</template>\n"
26
14
  },
27
15
  {
28
16
  "path": "popover/index.ts",
29
17
  "type": "registry:component",
30
18
  "target": "components/ui/popover/index.ts",
31
- "content": "export { default as Popover } from \"./Popover.vue\";\nexport { default as PopoverContent } from \"./PopoverContent.vue\";\nexport { default as PopoverTrigger } from \"./PopoverTrigger.vue\";\n"
19
+ "content": "export { default as Popover } from \"./Popover.vue\";\n"
32
20
  }
33
21
  ]
34
22
  }
@@ -0,0 +1,22 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "progress",
4
+ "type": "registry:ui",
5
+ "description": "进度条:基于 Ark UI Progress 原语,支持语义色、标签与百分比显示、不确定态。",
6
+ "registryDependencies": ["utils"],
7
+ "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "files": [
9
+ {
10
+ "path": "progress/Progress.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/progress/Progress.vue",
13
+ "content": "<script setup lang=\"ts\">\nimport { computed, ref } from \"vue\";\nimport { Progress as ArkProgress } from \"@ark-ui/vue/progress\";\nimport { cn } from \"@/lib/utils\";\n\n/** 语义变体 */\ntype ProgressVariant = \"default\" | \"info\" | \"success\" | \"warning\" | \"error\";\n\nconst props = withDefaults(\n defineProps<{\n /** 当前值(配合 v-model:value,0 ~ max);显式传 null 为不确定态 */\n value?: number | null;\n /** 最大值 @default 100 */\n max?: number;\n /** 进度标签文本 */\n label?: string;\n /** 是否显示百分比文本 @default false */\n showValue?: boolean;\n /** 语义变体:default 用 primary,error 映射 destructive @default \"default\" */\n variant?: ProgressVariant;\n /** 不确定态(忽略 value,恒以 null 传给 Ark) */\n indeterminate?: boolean;\n /** 追加/覆盖根元素样式类 */\n class?: string;\n }>(),\n { max: 100, showValue: false, variant: \"default\", indeterminate: false },\n);\n\nconst emit = defineEmits<{ \"update:value\": [value: number | null] }>();\n\n// —— 受控桥接(Popover 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst internalValue = ref<number | null>(0);\nconst modelValue = computed<number | null>(() => {\n if (props.indeterminate) return null;\n // 显式传 value(含 null)即受控;未传走内部状态\n return props.value !== undefined ? props.value : internalValue.value;\n});\n\nfunction handleUpdate(value: number | null) {\n internalValue.value = value;\n emit(\"update:value\", value);\n}\n\n// variant → 语义 token 着色(default 用 primary)\nconst rangeClass = computed(\n () =>\n ({\n default: \"bg-primary\",\n info: \"bg-info\",\n success: \"bg-success\",\n warning: \"bg-warning\",\n error: \"bg-destructive\",\n })[props.variant],\n);\n</script>\n\n<template>\n <ArkProgress.Root\n :model-value=\"modelValue\"\n :max=\"props.max\"\n :class=\"cn('relative flex w-full items-center gap-3', props.class)\"\n @update:model-value=\"handleUpdate\"\n >\n <ArkProgress.Label\n v-if=\"props.label\"\n class=\"text-foreground text-sm font-medium whitespace-nowrap\"\n >\n {{ props.label }}\n </ArkProgress.Label>\n <ArkProgress.Track class=\"bg-muted relative h-2 w-full grow overflow-hidden rounded-full\">\n <ArkProgress.Range\n :class=\"\n cn(\n 'h-full rounded-full transition-all duration-300',\n 'data-[state=indeterminate]:w-1/2 data-[state=indeterminate]:animate-pulse',\n rangeClass,\n )\n \"\n />\n </ArkProgress.Track>\n <ArkProgress.ValueText\n v-if=\"props.showValue\"\n class=\"text-muted-foreground text-sm leading-none tabular-nums whitespace-nowrap\"\n />\n </ArkProgress.Root>\n</template>\n"
14
+ },
15
+ {
16
+ "path": "progress/index.ts",
17
+ "type": "registry:component",
18
+ "target": "components/ui/progress/index.ts",
19
+ "content": "export { default as Progress } from \"./Progress.vue\";\n"
20
+ }
21
+ ]
22
+ }