@tu-design/vue 0.4.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +74 -0
- package/dist/index.d.mts +54 -50
- package/dist/index.mjs +985 -874
- package/dist/registry/vue/alert-dialog.json +3 -3
- package/dist/registry/vue/alert.json +1 -1
- package/dist/registry/vue/avatar-group.json +1 -1
- package/dist/registry/vue/avatar.json +1 -1
- package/dist/registry/vue/badge.json +1 -1
- package/dist/registry/vue/button.json +2 -2
- package/dist/registry/vue/calendar.json +3 -3
- package/dist/registry/vue/card.json +1 -1
- package/dist/registry/vue/cascader.json +5 -5
- package/dist/registry/vue/checkbox.json +1 -1
- package/dist/registry/vue/context-menu.json +2 -2
- package/dist/registry/vue/currency-input.json +2 -2
- package/dist/registry/vue/date-picker.json +2 -2
- package/dist/registry/vue/date-range-picker.json +3 -3
- package/dist/registry/vue/date-shared.json +16 -2
- package/dist/registry/vue/dialog.json +3 -3
- package/dist/registry/vue/drawer.json +3 -3
- package/dist/registry/vue/dropdown-menu.json +4 -4
- package/dist/registry/vue/empty.json +1 -1
- package/dist/registry/vue/form-render.json +35 -34
- package/dist/registry/vue/form.json +2 -2
- package/dist/registry/vue/input.json +1 -1
- package/dist/registry/vue/label.json +1 -1
- package/dist/registry/vue/month-picker.json +2 -2
- package/dist/registry/vue/number-input.json +2 -2
- package/dist/registry/vue/overlay-shared.json +20 -0
- package/dist/registry/vue/password-input.json +1 -1
- package/dist/registry/vue/pin-input.json +1 -1
- package/dist/registry/vue/popconfirm.json +3 -3
- package/dist/registry/vue/popover.json +3 -3
- package/dist/registry/vue/progress.json +1 -1
- package/dist/registry/vue/radio-group.json +1 -1
- package/dist/registry/vue/registry.json +7 -1
- package/dist/registry/vue/select.json +4 -4
- package/dist/registry/vue/separator.json +1 -1
- package/dist/registry/vue/skeleton.json +1 -1
- package/dist/registry/vue/slider.json +1 -1
- package/dist/registry/vue/slot.json +3 -3
- package/dist/registry/vue/spin.json +1 -1
- package/dist/registry/vue/switch.json +1 -1
- package/dist/registry/vue/table-render.json +39 -11
- package/dist/registry/vue/tabs.json +1 -1
- package/dist/registry/vue/textarea.json +1 -1
- package/dist/registry/vue/toast.json +3 -3
- package/dist/registry/vue/tokens.json +2 -1
- package/dist/registry/vue/tooltip.json +3 -3
- package/dist/registry/vue/tree-select.json +5 -5
- package/dist/registry/vue/tree-shared.json +13 -12
- package/dist/registry/vue/week-picker.json +2 -2
- package/dist/registry/vue/year-picker.json +2 -2
- package/package.json +3 -2
|
@@ -3,18 +3,18 @@
|
|
|
3
3
|
"name": "dialog",
|
|
4
4
|
"type": "registry:ui",
|
|
5
5
|
"description": "模态对话框单组件:#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Dialog 原语,含焦点圈定、Escape/遮罩关闭与进出场动画,支持 v-model:open。",
|
|
6
|
-
"registryDependencies": ["utils"],
|
|
6
|
+
"registryDependencies": ["utils", "overlay-shared"],
|
|
7
7
|
"dependencies": ["@ark-ui/vue@^5.39.2"],
|
|
8
8
|
"files": [
|
|
9
9
|
{
|
|
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
|
|
13
|
+
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\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 :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 <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"
|
|
14
14
|
},
|
|
15
15
|
{
|
|
16
16
|
"path": "dialog/index.ts",
|
|
17
|
-
"type": "registry:
|
|
17
|
+
"type": "registry:lib",
|
|
18
18
|
"target": "components/ui/dialog/index.ts",
|
|
19
19
|
"content": "export { default as Dialog } from \"./Dialog.vue\";\n"
|
|
20
20
|
}
|
|
@@ -3,18 +3,18 @@
|
|
|
3
3
|
"name": "drawer",
|
|
4
4
|
"type": "registry:ui",
|
|
5
5
|
"description": "抽屉单组件:从四方向滑出的侧边/顶底面板,#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Drawer 原语,进出场动画随 placement 方向自适应,含焦点圈定、Escape/遮罩关闭,支持 v-model:open。",
|
|
6
|
-
"registryDependencies": ["utils"],
|
|
6
|
+
"registryDependencies": ["utils", "overlay-shared"],
|
|
7
7
|
"dependencies": ["@ark-ui/vue@^5.39.2"],
|
|
8
8
|
"files": [
|
|
9
9
|
{
|
|
10
10
|
"path": "drawer/Drawer.vue",
|
|
11
11
|
"type": "registry:component",
|
|
12
12
|
"target": "components/ui/drawer/Drawer.vue",
|
|
13
|
-
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed
|
|
13
|
+
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed } from \"vue\";\nimport { Drawer as ArkDrawer } from \"@ark-ui/vue/drawer\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\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 :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 <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 </ArkDrawer.CloseTrigger>\n </ArkDrawer.Content>\n </ArkDrawer.Positioner>\n </ArkDrawer.Root>\n</template>\n"
|
|
14
14
|
},
|
|
15
15
|
{
|
|
16
16
|
"path": "drawer/index.ts",
|
|
17
|
-
"type": "registry:
|
|
17
|
+
"type": "registry:lib",
|
|
18
18
|
"target": "components/ui/drawer/index.ts",
|
|
19
19
|
"content": "export { default as Drawer } from \"./Drawer.vue\";\n"
|
|
20
20
|
}
|
|
@@ -3,14 +3,14 @@
|
|
|
3
3
|
"name": "dropdown-menu",
|
|
4
4
|
"type": "registry:ui",
|
|
5
5
|
"description": "下拉菜单:单组件模式,items 描述菜单项(含分组/标题/分隔线,支持嵌套),内置键盘导航与选中回调,默认插槽为触发元素(asChild 透传)。",
|
|
6
|
-
"registryDependencies": ["utils"],
|
|
6
|
+
"registryDependencies": ["utils", "overlay-shared"],
|
|
7
7
|
"dependencies": ["@ark-ui/vue@^5.39.2"],
|
|
8
8
|
"files": [
|
|
9
9
|
{
|
|
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 {
|
|
13
|
+
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { useAttrs } from \"vue\";\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\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 { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => 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-[var(--z-overlay)] min-w-[8rem] overflow-hidden rounded-md border p-1 shadow-md data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95\";\n</script>\n\n<template>\n <ArkMenu.Root\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\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-[var(--z-overlay)]\">\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
16
|
"path": "dropdown-menu/MenuItems.vue",
|
|
@@ -20,13 +20,13 @@
|
|
|
20
20
|
},
|
|
21
21
|
{
|
|
22
22
|
"path": "dropdown-menu/index.ts",
|
|
23
|
-
"type": "registry:
|
|
23
|
+
"type": "registry:lib",
|
|
24
24
|
"target": "components/ui/dropdown-menu/index.ts",
|
|
25
25
|
"content": "export { default as DropdownMenu } from \"./DropdownMenu.vue\";\nexport type { MenuItemOption } from \"./types\";\n"
|
|
26
26
|
},
|
|
27
27
|
{
|
|
28
28
|
"path": "dropdown-menu/types.ts",
|
|
29
|
-
"type": "registry:
|
|
29
|
+
"type": "registry:lib",
|
|
30
30
|
"target": "components/ui/dropdown-menu/types.ts",
|
|
31
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"
|
|
32
32
|
}
|
|
@@ -4,26 +4,27 @@
|
|
|
4
4
|
"type": "registry:ui",
|
|
5
5
|
"description": "配置驱动表单渲染器:defineForm 聚合 TanStack Form 实例与字段配置,柯里化 widget DSL 声明控件,Tailwind 栅格自适应布局,复用 Form 家族 aria 接线。",
|
|
6
6
|
"registryDependencies": [
|
|
7
|
-
"form",
|
|
8
7
|
"button",
|
|
9
|
-
"
|
|
10
|
-
"
|
|
8
|
+
"cascader",
|
|
9
|
+
"checkbox",
|
|
10
|
+
"currency-input",
|
|
11
|
+
"date-picker",
|
|
12
|
+
"date-range-picker",
|
|
13
|
+
"form",
|
|
11
14
|
"input",
|
|
12
|
-
"
|
|
15
|
+
"label",
|
|
16
|
+
"month-picker",
|
|
13
17
|
"number-input",
|
|
14
18
|
"password-input",
|
|
15
|
-
"currency-input",
|
|
16
|
-
"select",
|
|
17
|
-
"checkbox",
|
|
18
|
-
"switch",
|
|
19
19
|
"radio-group",
|
|
20
|
+
"select",
|
|
20
21
|
"slider",
|
|
21
|
-
"
|
|
22
|
-
"
|
|
23
|
-
"year-picker",
|
|
24
|
-
"date-range-picker",
|
|
22
|
+
"switch",
|
|
23
|
+
"textarea",
|
|
25
24
|
"tree-select",
|
|
26
|
-
"
|
|
25
|
+
"utils",
|
|
26
|
+
"week-picker",
|
|
27
|
+
"year-picker"
|
|
27
28
|
],
|
|
28
29
|
"dependencies": ["@tanstack/vue-form@^1.33.5", "valibot@^1.5.0"],
|
|
29
30
|
"files": [
|
|
@@ -31,85 +32,85 @@
|
|
|
31
32
|
"path": "form-render/FormRender.vue",
|
|
32
33
|
"type": "registry:component",
|
|
33
34
|
"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
|
+
"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/ui/button\";\nimport { FORM_KEY } from \"@/components/ui/form/context\";\nimport { cn } from \"@/lib/utils\";\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=\"cn('grid gap-4', $attrs.class)\" :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
|
},
|
|
36
37
|
{
|
|
37
38
|
"path": "form-render/FormRenderField.vue",
|
|
38
39
|
"type": "registry:component",
|
|
39
40
|
"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
|
+
"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/ui/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
|
},
|
|
42
43
|
{
|
|
43
44
|
"path": "form-render/define-form.ts",
|
|
44
|
-
"type": "registry:
|
|
45
|
+
"type": "registry:lib",
|
|
45
46
|
"target": "components/ui/form-render/define-form.ts",
|
|
46
47
|
"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
|
},
|
|
48
49
|
{
|
|
49
50
|
"path": "form-render/index.ts",
|
|
50
|
-
"type": "registry:
|
|
51
|
+
"type": "registry:lib",
|
|
51
52
|
"target": "components/ui/form-render/index.ts",
|
|
52
53
|
"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
|
},
|
|
54
55
|
{
|
|
55
56
|
"path": "form-render/types.ts",
|
|
56
|
-
"type": "registry:
|
|
57
|
+
"type": "registry:lib",
|
|
57
58
|
"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
|
+
"content": "import type { AnyFieldApi, FormApi, VueFormApi } from \"@tanstack/vue-form\";\nimport type { VNode } from \"vue\";\nimport type { Checkbox } from \"@/components/ui/checkbox\";\nimport type { CurrencyInput } from \"@/components/ui/currency-input\";\nimport type { DatePicker } from \"@/components/ui/date-picker\";\nimport type { DateRangePicker } from \"@/components/ui/date-range-picker\";\nimport type { Input } from \"@/components/ui/input\";\nimport type { MonthPicker } from \"@/components/ui/month-picker\";\nimport type { WeekPicker } from \"@/components/ui/week-picker\";\nimport type { NumberInput } from \"@/components/ui/number-input\";\nimport type { PasswordInput } from \"@/components/ui/password-input\";\nimport type { RadioGroup } from \"@/components/ui/radio-group\";\nimport type { Cascader } from \"@/components/ui/cascader\";\nimport type { TreeSelect } from \"@/components/ui/tree-select\";\nimport type { Select } from \"@/components/ui/select\";\nimport type { Slider } from \"@/components/ui/slider\";\nimport type { Switch } from \"@/components/ui/switch\";\nimport type { Textarea } from \"@/components/ui/textarea\";\nimport type { YearPicker } from \"@/components/ui/year-picker\";\nimport type { SelectItemOption } from \"@/components/ui/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
|
},
|
|
60
61
|
{
|
|
61
62
|
"path": "form-render/useFormRender.ts",
|
|
62
|
-
"type": "registry:
|
|
63
|
+
"type": "registry:lib",
|
|
63
64
|
"target": "components/ui/form-render/useFormRender.ts",
|
|
64
65
|
"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
|
},
|
|
66
67
|
{
|
|
67
68
|
"path": "form-render/widgets/bind.ts",
|
|
68
|
-
"type": "registry:
|
|
69
|
+
"type": "registry:lib",
|
|
69
70
|
"target": "components/ui/form-render/widgets/bind.ts",
|
|
70
71
|
"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
|
},
|
|
72
73
|
{
|
|
73
74
|
"path": "form-render/widgets/boolean.ts",
|
|
74
|
-
"type": "registry:
|
|
75
|
+
"type": "registry:lib",
|
|
75
76
|
"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
|
+
"content": "import { h } from \"vue\";\nimport { Checkbox } from \"@/components/ui/checkbox\";\nimport { Switch } from \"@/components/ui/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
|
},
|
|
78
79
|
{
|
|
79
80
|
"path": "form-render/widgets/index.ts",
|
|
80
|
-
"type": "registry:
|
|
81
|
+
"type": "registry:lib",
|
|
81
82
|
"target": "components/ui/form-render/widgets/index.ts",
|
|
82
83
|
"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
|
},
|
|
84
85
|
{
|
|
85
86
|
"path": "form-render/widgets/input.ts",
|
|
86
|
-
"type": "registry:
|
|
87
|
+
"type": "registry:lib",
|
|
87
88
|
"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
|
+
"content": "import { h } from \"vue\";\nimport { Input } from \"@/components/ui/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
|
},
|
|
90
91
|
{
|
|
91
92
|
"path": "form-render/widgets/model-value.ts",
|
|
92
|
-
"type": "registry:
|
|
93
|
+
"type": "registry:lib",
|
|
93
94
|
"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
|
+
"content": "import type { Component } from \"vue\";\nimport { h } from \"vue\";\nimport { CurrencyInput } from \"@/components/ui/currency-input\";\nimport { DatePicker } from \"@/components/ui/date-picker\";\nimport { DateRangePicker } from \"@/components/ui/date-range-picker\";\nimport { MonthPicker } from \"@/components/ui/month-picker\";\nimport { NumberInput } from \"@/components/ui/number-input\";\nimport { PasswordInput } from \"@/components/ui/password-input\";\nimport { Textarea } from \"@/components/ui/textarea\";\nimport { WeekPicker } from \"@/components/ui/week-picker\";\nimport { YearPicker } from \"@/components/ui/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
|
},
|
|
96
97
|
{
|
|
97
98
|
"path": "form-render/widgets/select.ts",
|
|
98
|
-
"type": "registry:
|
|
99
|
+
"type": "registry:lib",
|
|
99
100
|
"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
|
+
"content": "import { h } from \"vue\";\nimport { Select } from \"@/components/ui/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
|
},
|
|
102
103
|
{
|
|
103
104
|
"path": "form-render/widgets/tree.ts",
|
|
104
|
-
"type": "registry:
|
|
105
|
+
"type": "registry:lib",
|
|
105
106
|
"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
|
+
"content": "import type { ComponentPublicInstance } from \"vue\";\nimport { h } from \"vue\";\nimport { Cascader } from \"@/components/ui/cascader\";\nimport { TreeSelect } from \"@/components/ui/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
|
},
|
|
108
109
|
{
|
|
109
110
|
"path": "form-render/widgets/value.ts",
|
|
110
|
-
"type": "registry:
|
|
111
|
+
"type": "registry:lib",
|
|
111
112
|
"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
|
+
"content": "import { h } from \"vue\";\nimport { RadioGroup } from \"@/components/ui/radio-group\";\nimport { Slider } from \"@/components/ui/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
|
}
|
|
114
115
|
]
|
|
115
116
|
}
|
|
@@ -56,13 +56,13 @@
|
|
|
56
56
|
},
|
|
57
57
|
{
|
|
58
58
|
"path": "form/context.ts",
|
|
59
|
-
"type": "registry:
|
|
59
|
+
"type": "registry:lib",
|
|
60
60
|
"target": "components/ui/form/context.ts",
|
|
61
61
|
"content": "import type { AnyFieldApi, FormApi, VueFormApi } from \"@tanstack/vue-form\";\nimport type { ComputedRef, InjectionKey, Ref, ShallowRef } from \"vue\";\n\n/** useForm() 返回实例的宽松形态(provide/inject 边界会擦除泛型,any 化是契约) */\n/* prettier-ignore */\nexport type FormInstance =\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/** FormField 内部经 form.Field 插槽才能拿到 field 实例,用 ShallowRef 承载 provide 时序 */\nexport interface FieldContext {\n field: ShallowRef<AnyFieldApi | undefined>;\n name: string;\n}\n\n/** FormItem 提供给 FormLabel/FormControl/FormDescription/FormMessage 的静态 id 与 presence 上下文 */\nexport interface FormItemContext {\n name: string;\n /** 实例级唯一控件 id(useId 前缀 + 字段名),label/控件/aria 均由它派生 */\n controlId: string;\n descriptionId: string;\n messageId: string;\n hasDescription: Ref<boolean>;\n hasMessage: Ref<boolean>;\n isInvalid: ComputedRef<boolean>;\n}\n\nexport const FORM_KEY: InjectionKey<FormInstance> = Symbol(\"tu-form\");\nexport const FIELD_KEY: InjectionKey<FieldContext> = Symbol(\"tu-form-field\");\nexport const FORM_ITEM_KEY: InjectionKey<FormItemContext> = Symbol(\"tu-form-item\");\n"
|
|
62
62
|
},
|
|
63
63
|
{
|
|
64
64
|
"path": "form/index.ts",
|
|
65
|
-
"type": "registry:
|
|
65
|
+
"type": "registry:lib",
|
|
66
66
|
"target": "components/ui/form/index.ts",
|
|
67
67
|
"content": "export { default as Form } from \"./Form.vue\";\nexport { default as FormControl } from \"./FormControl.vue\";\nexport { default as FormDescription } from \"./FormDescription.vue\";\nexport { default as FormField } from \"./FormField.vue\";\nexport { default as FormItem } from \"./FormItem.vue\";\nexport { default as FormLabel } from \"./FormLabel.vue\";\nexport { default as FormMessage } from \"./FormMessage.vue\";\nexport { default as FormSubscribe } from \"./FormSubscribe.vue\";\n"
|
|
68
68
|
}
|
|
@@ -10,11 +10,11 @@
|
|
|
10
10
|
"path": "month-picker/MonthPicker.vue",
|
|
11
11
|
"type": "registry:component",
|
|
12
12
|
"target": "components/ui/month-picker/MonthPicker.vue",
|
|
13
|
-
"content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport
|
|
13
|
+
"content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide } from \"vue\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport PickerShell from \"../date-shared/PickerShell.vue\";\nimport { CALENDAR_IN_PICKER, formatIsoMonth, parseIsoMonth } from \"../date-shared/shared\";\nimport { usePickerBridge } from \"../date-shared/usePickerBridge\";\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\nconst { rootValue, isOpen, setOpen, handleValueUpdate } = usePickerBridge({\n modelValue: () => props.modelValue,\n defaultValue: () => props.defaultValue,\n open: () => props.open,\n defaultOpen: () => props.defaultOpen,\n disabled: () => props.disabled,\n readOnly: () => props.readOnly,\n parse: parseIsoMonth,\n toPublicValue: formatIsoMonth,\n onUpdateModelValue: (value) => emit(\"update:modelValue\", value),\n onUpdateOpen: (open) => emit(\"update:open\", open),\n});\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</script>\n\n<template>\n <PickerShell\n v-bind=\"$attrs\"\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 :invalid=\"props.invalid\"\n :placeholder=\"props.placeholder\"\n :class=\"props.class\"\n :format=\"formatIsoMonth\"\n :parse=\"parseIsoMonth\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <TCalendar mode=\"month\" />\n </PickerShell>\n</template>\n"
|
|
14
14
|
},
|
|
15
15
|
{
|
|
16
16
|
"path": "month-picker/index.ts",
|
|
17
|
-
"type": "registry:
|
|
17
|
+
"type": "registry:lib",
|
|
18
18
|
"target": "components/ui/month-picker/index.ts",
|
|
19
19
|
"content": "export { default as MonthPicker } from \"./MonthPicker.vue\";\n"
|
|
20
20
|
}
|
|
@@ -14,13 +14,13 @@
|
|
|
14
14
|
},
|
|
15
15
|
{
|
|
16
16
|
"path": "number-input/index.ts",
|
|
17
|
-
"type": "registry:
|
|
17
|
+
"type": "registry:lib",
|
|
18
18
|
"target": "components/ui/number-input/index.ts",
|
|
19
19
|
"content": "export { default as NumberInput } from \"./NumberInput.vue\";\nexport { numberOrNull } from \"./utils\";\n"
|
|
20
20
|
},
|
|
21
21
|
{
|
|
22
22
|
"path": "number-input/utils.ts",
|
|
23
|
-
"type": "registry:
|
|
23
|
+
"type": "registry:lib",
|
|
24
24
|
"target": "components/ui/number-input/utils.ts",
|
|
25
25
|
"content": "/** Ark ValueChangeDetails → number|null(空串/NaN 归一 null,numberOrNull 为可单测的纯函数) */\nexport function numberOrNull(details: { value: string; valueAsNumber: number }): number | null {\n return details.value === \"\" || Number.isNaN(details.valueAsNumber) ? null : details.valueAsNumber;\n}\n"
|
|
26
26
|
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
|
+
"name": "overlay-shared",
|
|
4
|
+
"type": "registry:ui",
|
|
5
|
+
"description": "弹层家族共享逻辑:受控开合桥接(useControlledBoolean)与确认 pending 语义(useConfirmPending)。",
|
|
6
|
+
"files": [
|
|
7
|
+
{
|
|
8
|
+
"path": "overlay-shared/useConfirmPending.ts",
|
|
9
|
+
"type": "registry:lib",
|
|
10
|
+
"target": "components/ui/overlay-shared/useConfirmPending.ts",
|
|
11
|
+
"content": "import { ref, type ComponentInternalInstance } from \"vue\";\n\nexport interface ConfirmPendingOptions {\n /** 当前组件实例:从 vnode 上取原始 onConfirm 监听器(emit 不回传返回值) */\n instance: ComponentInternalInstance | null;\n /** 无监听器时补发 confirm 事件 */\n emitConfirm: () => void;\n emitCancel: () => void;\n /** 关闭弹层(走受控桥) */\n close: () => void;\n}\n\n/**\n * 确认弹层公共 pending 语义:@confirm 处理器返回 Promise 时锁定关闭通道,\n * resolve 后自动关闭,reject 保持打开并退出 loading;同步处理器直接关闭。\n */\nexport function useConfirmPending(options: ConfirmPendingOptions) {\n const loading = ref(false);\n\n function handleConfirm() {\n if (loading.value) return;\n const handler = options.instance?.vnode.props?.onConfirm as\n | ((...args: unknown[]) => unknown)\n | undefined;\n const result = handler?.();\n if (!handler) options.emitConfirm();\n if (result instanceof Promise) {\n loading.value = true;\n result\n .then(() => {\n loading.value = false;\n options.close();\n })\n .catch(() => {\n loading.value = false;\n });\n } else {\n options.close();\n }\n }\n\n function handleCancel() {\n if (loading.value) return;\n options.emitCancel();\n options.close();\n }\n\n return { loading, handleConfirm, handleCancel };\n}\n"
|
|
12
|
+
},
|
|
13
|
+
{
|
|
14
|
+
"path": "overlay-shared/useControlledBoolean.ts",
|
|
15
|
+
"type": "registry:lib",
|
|
16
|
+
"target": "components/ui/overlay-shared/useControlledBoolean.ts",
|
|
17
|
+
"content": "import { computed, ref, type ComputedRef } from \"vue\";\n\nexport interface ControlledBooleanOptions {\n /** 受控值;返回 undefined 表示非受控(内部状态接管) */\n controlled: () => boolean | undefined;\n /** 非受控初始值 */\n defaultValue?: () => boolean;\n /** 状态变更对外同步(一般 emit(\"update:open\", next)) */\n onChange?: (next: boolean) => void;\n}\n\nexport interface ControlledBoolean {\n isOpen: ComputedRef<boolean>;\n setOpen: (next: boolean) => void;\n}\n\n/**\n * 业务组件惯例:Ark Root 恒走受控,非受控语义由内部 ref 实现。\n * `controlled()` 返回 undefined 时用内部值,否则永远跟随外部 prop。\n */\nexport function useControlledBoolean(options: ControlledBooleanOptions): ControlledBoolean {\n const internal = ref(options.defaultValue?.() ?? false);\n const isOpen = computed(() => options.controlled() ?? internal.value);\n\n function setOpen(next: boolean) {\n internal.value = next;\n options.onChange?.(next);\n }\n\n return { isOpen, setOpen };\n}\n"
|
|
18
|
+
}
|
|
19
|
+
]
|
|
20
|
+
}
|