@tu-design/vue 0.5.10 → 0.5.12

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 (57) hide show
  1. package/dist/index.d.mts +1164 -1151
  2. package/dist/index.mjs +444 -321
  3. package/dist/registry/vue/alert-dialog.json +3 -3
  4. package/dist/registry/vue/alert.json +1 -1
  5. package/dist/registry/vue/avatar-group.json +1 -1
  6. package/dist/registry/vue/avatar.json +2 -2
  7. package/dist/registry/vue/badge.json +1 -1
  8. package/dist/registry/vue/button.json +1 -1
  9. package/dist/registry/vue/calendar.json +2 -2
  10. package/dist/registry/vue/card.json +1 -1
  11. package/dist/registry/vue/cascader.json +4 -4
  12. package/dist/registry/vue/checkbox.json +2 -2
  13. package/dist/registry/vue/context-menu.json +3 -3
  14. package/dist/registry/vue/currency-input.json +2 -2
  15. package/dist/registry/vue/date-picker.json +2 -2
  16. package/dist/registry/vue/date-range-picker.json +3 -3
  17. package/dist/registry/vue/date-shared.json +3 -3
  18. package/dist/registry/vue/dialog.json +3 -3
  19. package/dist/registry/vue/drawer.json +3 -3
  20. package/dist/registry/vue/dropdown-menu.json +3 -3
  21. package/dist/registry/vue/empty.json +1 -1
  22. package/dist/registry/vue/form-render.json +1 -1
  23. package/dist/registry/vue/form.json +2 -2
  24. package/dist/registry/vue/icon-shared.json +1 -1
  25. package/dist/registry/vue/input.json +1 -1
  26. package/dist/registry/vue/label.json +1 -1
  27. package/dist/registry/vue/month-picker.json +2 -2
  28. package/dist/registry/vue/number-input.json +2 -2
  29. package/dist/registry/vue/overlay-shared.json +15 -3
  30. package/dist/registry/vue/password-input.json +1 -1
  31. package/dist/registry/vue/pin-input.json +2 -2
  32. package/dist/registry/vue/popconfirm.json +2 -2
  33. package/dist/registry/vue/popover.json +3 -3
  34. package/dist/registry/vue/progress.json +2 -2
  35. package/dist/registry/vue/provider.json +28 -0
  36. package/dist/registry/vue/radio-group.json +2 -2
  37. package/dist/registry/vue/registry.json +59 -52
  38. package/dist/registry/vue/select.json +3 -3
  39. package/dist/registry/vue/separator.json +1 -1
  40. package/dist/registry/vue/skeleton.json +1 -1
  41. package/dist/registry/vue/slider.json +2 -2
  42. package/dist/registry/vue/slot.json +1 -1
  43. package/dist/registry/vue/spin.json +1 -1
  44. package/dist/registry/vue/switch.json +2 -2
  45. package/dist/registry/vue/table-render.json +8 -8
  46. package/dist/registry/vue/tabs.json +2 -2
  47. package/dist/registry/vue/textarea.json +1 -1
  48. package/dist/registry/vue/timeline.json +1 -1
  49. package/dist/registry/vue/toast.json +4 -4
  50. package/dist/registry/vue/tokens.json +2 -2
  51. package/dist/registry/vue/tooltip.json +3 -3
  52. package/dist/registry/vue/tree-select.json +4 -4
  53. package/dist/registry/vue/tree-shared.json +3 -3
  54. package/dist/registry/vue/utils.json +1 -1
  55. package/dist/registry/vue/week-picker.json +2 -2
  56. package/dist/registry/vue/year-picker.json +2 -2
  57. package/package.json +16 -16
@@ -1,17 +1,17 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "drawer",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "抽屉单组件:从四方向滑出的侧边/顶底面板,#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Drawer 原语,进出场动画随 placement 方向自适应,含焦点圈定、Escape/遮罩关闭,支持 v-model:open。",
7
7
  "registryDependencies": ["icon-shared", "utils", "overlay-shared"],
8
- "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "dependencies": ["@ark-ui/vue@^5.40.0"],
9
9
  "files": [
10
10
  {
11
11
  "path": "drawer/Drawer.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/drawer/Drawer.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Drawer as ArkDrawer } from \"@ark-ui/vue/drawer\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds);grabber/grabberIndicator/swipeArea\n// 随 anatomy 全量覆盖(zag drawer.dom.js:53-72)\nconst { ids: rootIds } = useOverlayIds(useAttrs(), {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"backdrop\",\n \"header\",\n \"grabber\",\n \"grabberIndicator\",\n \"swipeArea\",\n ],\n});\n\ntype Placement = \"top\" | \"right\" | \"bottom\" | \"left\";\ntype Size = \"sm\" | \"default\" | \"lg\";\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次打开前不挂载内容 */\n lazyMount: { type: Boolean, default: false },\n /** 关闭后卸载内容(关闭动画结束后) */\n unmountOnExit: { type: Boolean, default: false },\n /** 抽屉弹出方向 */\n placement: { type: String as PropType<Placement>, default: \"right\" },\n /** 尺寸档位:侧向(left/right)为宽度,顶/底向(top/bottom)为高度 */\n size: { type: String as PropType<Size>, default: \"default\" },\n /** 标题文案(#title 插槽优先,两者皆无则不渲染标题) */\n title: { type: String, default: undefined },\n /** 描述文案(#description 插槽优先,两者皆无则不渲染描述) */\n description: { type: String, default: undefined },\n /** 是否渲染右上角内置关闭按钮(aria-label=\"关闭\") */\n showCloseButton: { type: Boolean, default: true },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,\n// 与 Dialog 同款桥接,两种模式行为一致。\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n/** 关闭抽屉(#footer 作用域插槽注入) */\nfunction close() {\n setOpen(false);\n}\n\n// 标题/描述有任一来源(props 或插槽)时才渲染头部区块\nconst hasHeader = computed(() => Boolean(props.title || props.description));\n\n// 定位与尺寸:侧向=宽度档位,顶/底向=高度档位;边框贴合抽屉边缘\nconst placementConfig: Record<\n Placement,\n { positioner: string; content: string; sizes: Record<Size, string> }\n> = {\n right: {\n positioner: \"justify-end\",\n content: \"inset-y-0 right-0 h-full border-l\",\n // 档位类带 sm: 前缀 + 基础类用无前缀全宽:tw-merge 对不同断点前缀不互相覆盖,\n // 语义确定为「移动端全宽、sm 起按档位」(写成 \"w-full sm:w-96\" 而非让 tw-merge 去重)\n sizes: { sm: \"sm:w-80\", default: \"sm:w-96\", lg: \"sm:w-[40rem]\" },\n },\n left: {\n positioner: \"justify-start\",\n content: \"inset-y-0 left-0 h-full border-r\",\n sizes: { sm: \"sm:w-80\", default: \"sm:w-96\", lg: \"sm:w-[40rem]\" },\n },\n top: {\n positioner: \"items-start\",\n content: \"inset-x-0 top-0 w-full border-b\",\n sizes: { sm: \"sm:h-64\", default: \"sm:h-80\", lg: \"sm:h-[28rem]\" },\n },\n bottom: {\n positioner: \"items-end\",\n content: \"inset-x-0 bottom-0 w-full border-t\",\n sizes: { sm: \"sm:h-64\", default: \"sm:h-80\", lg: \"sm:h-[28rem]\" },\n },\n};\n\n// 进出场动画随 placement 方向自适应:从哪侧弹出就从哪侧滑入,退场对称滑出\nconst placementAnimations: Record<Placement, string> = {\n right: \"data-[state=open]:slide-in-from-right data-[state=closed]:slide-out-to-right\",\n left: \"data-[state=open]:slide-in-from-left data-[state=closed]:slide-out-to-left\",\n top: \"data-[state=open]:slide-in-from-top data-[state=closed]:slide-out-to-top\",\n bottom: \"data-[state=open]:slide-in-from-bottom data-[state=closed]:slide-out-to-bottom\",\n};\n\nconst config = computed(() => placementConfig[props.placement]);\n\nconst isLateral = computed(() => props.placement === \"left\" || props.placement === \"right\");\n\n// 面板样式:定位 + 档位尺寸 + 方向动画\n// 侧向:基础 w-full(移动端全宽)+ sm: 断点档位宽度;顶/底向:基础 h-full + sm: 档位高度\nconst contentClass = computed(() =>\n cn(\n \"bg-background data-[state=open]:animate-in data-[state=closed]:animate-out fixed z-[var(--z-modal,60)] flex flex-col gap-4 overflow-y-auto p-6 shadow-lg duration-200\",\n config.value.content,\n isLateral.value\n ? cn(\"w-full\", config.value.sizes[props.size])\n : cn(\"h-full\", config.value.sizes[props.size]),\n placementAnimations[props.placement],\n ),\n);\n</script>\n\n<template>\n <ArkDrawer.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <ArkDrawer.Trigger v-if=\"$slots.trigger\" as-child>\n <slot name=\"trigger\" />\n </ArkDrawer.Trigger>\n\n <ArkDrawer.Backdrop\n class=\"fixed inset-0 z-[var(--z-modal,60)] bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\"\n />\n <ArkDrawer.Positioner\n :class=\"cn('fixed inset-0 z-[var(--z-modal,60)] flex', config.positioner)\"\n >\n <ArkDrawer.Content :class=\"contentClass\">\n <div v-if=\"hasHeader || $slots.title || $slots.description\" class=\"flex flex-col gap-1.5\">\n <ArkDrawer.Title\n v-if=\"$slots.title || props.title\"\n class=\"text-lg font-semibold leading-none tracking-tight\"\n >\n <slot name=\"title\">{{ props.title }}</slot>\n </ArkDrawer.Title>\n <ArkDrawer.Description\n v-if=\"$slots.description || props.description\"\n class=\"text-sm text-muted-foreground\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </ArkDrawer.Description>\n </div>\n\n <slot />\n\n <div\n v-if=\"$slots.footer\"\n class=\"mt-auto flex flex-col-reverse gap-2 pt-2 sm:flex-row sm:justify-end\"\n >\n <slot name=\"footer\" :close=\"close\" />\n </div>\n\n <ArkDrawer.CloseTrigger\n v-if=\"props.showCloseButton\"\n aria-label=\"关闭\"\n class=\"absolute right-4 top-4 cursor-pointer rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none\"\n >\n <slot name=\"close\">\n <CloseIcon class=\"size-4\" />\n <span class=\"sr-only\">关闭</span>\n </slot>\n </ArkDrawer.CloseTrigger>\n </ArkDrawer.Content>\n </ArkDrawer.Positioner>\n </ArkDrawer.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Drawer as ArkDrawer } from \"@ark-ui/vue/drawer\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { useOverlayScrollLock } from \"../overlay-shared/useOverlayScrollLock\";\nimport { overlayPreventScroll } from \"../overlay-shared/useSandboxOverlay\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\n\nconst attrs = useAttrs();\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds);grabber/grabberIndicator/swipeArea\n// 随 anatomy 全量覆盖(zag drawer.dom.js:53-72)\nconst { ids: rootIds } = useOverlayIds(attrs, {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"backdrop\",\n \"header\",\n \"grabber\",\n \"grabberIndicator\",\n \"swipeArea\",\n ],\n});\n\ntype Placement = \"top\" | \"right\" | \"bottom\" | \"left\";\ntype Size = \"sm\" | \"default\" | \"lg\";\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次打开前不挂载内容 */\n lazyMount: { type: Boolean, default: false },\n /** 关闭后卸载内容(关闭动画结束后) */\n unmountOnExit: { type: Boolean, default: false },\n /** 抽屉弹出方向 */\n placement: { type: String as PropType<Placement>, default: \"right\" },\n /** 尺寸档位:侧向(left/right)为宽度,顶/底向(top/bottom)为高度 */\n size: { type: String as PropType<Size>, default: \"default\" },\n /** 标题文案(#title 插槽优先,两者皆无则不渲染标题) */\n title: { type: String, default: undefined },\n /** 描述文案(#description 插槽优先,两者皆无则不渲染描述) */\n description: { type: String, default: undefined },\n /** 是否渲染右上角内置关闭按钮(aria-label=\"关闭\") */\n showCloseButton: { type: Boolean, default: true },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,\n// 与 Dialog 同款桥接,两种模式行为一致。\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// overlay 滚动锁契约(issue #5,语义 B 拓扑闸在 overlayContract 内);\n// isModal 仅在 isOpen 转换回调内求值(冻结语义,不 watch attrs)\nuseOverlayScrollLock(isOpen, () => attrs.modal !== false && attrs.modal !== \"false\");\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-dialog text-dialog-foreground data-[state=open]:animate-in data-[state=closed]:animate-out fixed z-[var(--z-modal,60)] flex flex-col gap-4 overflow-y-auto p-6 shadow-lg duration-200\",\n config.value.content,\n isLateral.value\n ? cn(\"w-full\", config.value.sizes[props.size])\n : cn(\"h-full\", config.value.sizes[props.size]),\n placementAnimations[props.placement],\n ),\n);\n\n// 滚动锁沙箱降级(wujie graft 下禁用,机制与论证见 overlayPreventScroll / issue #4)\nconst preventScroll = overlayPreventScroll();\n</script>\n\n<template>\n <ArkDrawer.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :prevent-scroll=\"preventScroll\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <ArkDrawer.Trigger v-if=\"$slots.trigger\" as-child>\n <slot name=\"trigger\" />\n </ArkDrawer.Trigger>\n\n <ArkDrawer.Backdrop\n class=\"fixed inset-0 z-[var(--z-modal,60)] bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\"\n />\n <ArkDrawer.Positioner\n :class=\"cn('fixed inset-0 z-[var(--z-modal,60)] flex', config.positioner)\"\n >\n <ArkDrawer.Content :class=\"contentClass\">\n <div v-if=\"hasHeader || $slots.title || $slots.description\" class=\"flex flex-col gap-1.5\">\n <ArkDrawer.Title\n v-if=\"$slots.title || props.title\"\n class=\"text-lg font-semibold leading-none tracking-tight\"\n >\n <slot name=\"title\">{{ props.title }}</slot>\n </ArkDrawer.Title>\n <ArkDrawer.Description\n v-if=\"$slots.description || props.description\"\n class=\"text-sm text-muted-foreground\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </ArkDrawer.Description>\n </div>\n\n <slot />\n\n <div\n v-if=\"$slots.footer\"\n class=\"mt-auto flex flex-col-reverse gap-2 pt-2 sm:flex-row sm:justify-end\"\n >\n <slot name=\"footer\" :close=\"close\" />\n </div>\n\n <ArkDrawer.CloseTrigger\n v-if=\"props.showCloseButton\"\n aria-label=\"关闭\"\n class=\"absolute right-4 top-4 cursor-pointer rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none\"\n >\n <slot name=\"close\">\n <CloseIcon class=\"size-4\" />\n <span class=\"sr-only\">关闭</span>\n </slot>\n </ArkDrawer.CloseTrigger>\n </ArkDrawer.Content>\n </ArkDrawer.Positioner>\n </ArkDrawer.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "drawer/index.ts",
@@ -1,17 +1,17 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "dropdown-menu",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "下拉菜单:单组件模式,items 描述菜单项(含分组/标题/分隔线,支持嵌套),内置键盘导航与选中回调,默认插槽为触发元素(asChild 透传)。",
7
7
  "registryDependencies": ["utils", "overlay-shared"],
8
- "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "dependencies": ["@ark-ui/vue@^5.40.0"],
9
9
  "files": [
10
10
  {
11
11
  "path": "dropdown-menu/DropdownMenu.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/dropdown-menu/DropdownMenu.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\nimport type { MenuRootProps } from \"@ark-ui/vue/menu\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\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 /** Ark Menu Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed\n (absolute 包含块错位修正,机制详注见 useSandboxOverlay / sandbox.ts) */\n positioning: {\n type: Object as PropType<MenuRootProps[\"positioning\"]>,\n default: undefined,\n },\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\n// 沙箱适配(机制详注见 useSandboxOverlay / sandbox.ts):面板无 Teleport 留原地,\n// iframe realm 下 strategy 默认 fixed 消除 absolute 包含块(最近 positioned 祖先)错位\nconst rootPositioning = computed(() =>\n withSandboxStrategy(props.positioning, { ...props.positioning }),\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 :positioning=\"rootPositioning\"\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
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Menu as ArkMenu } from \"@ark-ui/vue/menu\";\nimport type { MenuRootProps } from \"@ark-ui/vue/menu\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\nimport { useTuProvider } from \"../overlay-shared/config\";\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 /** Ark Menu Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed\n (absolute 包含块错位修正,机制详注见 useSandboxOverlay / sandbox.ts) */\n positioning: {\n type: Object as PropType<MenuRootProps[\"positioning\"]>,\n default: undefined,\n },\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\n// 沙箱适配(机制详注见 useSandboxOverlay / sandbox.ts):面板无 Teleport 留原地,\n// iframe realm 下 strategy 默认 fixed 消除 absolute 包含块(最近 positioned 祖先)错位\n// Provider 显式配置快照:withSandboxStrategy 在 computed 内调用,inject 须于 setup 顶层捕获后传入\nconst tuProvider = useTuProvider();\n\nconst rootPositioning = computed(() =>\n withSandboxStrategy(props.positioning, { ...props.positioning }, tuProvider),\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 :positioning=\"rootPositioning\"\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"
15
15
  },
16
16
  {
17
17
  "path": "dropdown-menu/MenuItems.vue",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "empty",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "空状态占位,含默认插画与描述文案。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "form-render",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "配置驱动表单渲染器:defineForm 聚合 TanStack Form 实例与字段配置,柯里化 widget DSL 声明控件,Tailwind 栅格自适应布局,复用 Form 家族 aria 接线。",
7
7
  "registryDependencies": [
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "form",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "表单状态与校验:基于 TanStack Form,配合 Valibot(Standard Schema)声明式校验,aria 自动接线。",
7
7
  "registryDependencies": ["utils", "input", "button", "label"],
@@ -59,7 +59,7 @@
59
59
  "path": "form/context.ts",
60
60
  "type": "registry:lib",
61
61
  "target": "components/ui/form/context.ts",
62
- "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
+ "content": "import type { AnyFieldApi } from \"@tanstack/vue-form\";\nimport type { ComputedRef, InjectionKey, Ref, ShallowRef } from \"vue\";\n\n/** useForm() 返回实例的宽松形态(provide/inject 边界会擦除泛型,any 化是契约)。\n * 注:TS6 对 FormApi<any> 的方法成员按逆变检查(如 pushFieldValue 的 TField 收窄为 never),\n * any 化交集不再能兼容任意具体泛型实例,故契约直接 any 化。 */\nexport type FormInstance = 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"
63
63
  },
64
64
  {
65
65
  "path": "form/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "icon-shared",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "内置功能性图标(CloseIcon/ChevronIcon/CalendarIcon/GripIcon),内部共享,非公共 API。图标组件零默认类:尺寸/旋转/过渡类由使用处显式传入,避免 fallthrough 拼接时同名工具类排序冲突。",
7
7
  "files": [
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "input",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "文本输入框,支持 v-model、attrs 透传与 invalid 校验态。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "label",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "表单标签。",
7
7
  "registryDependencies": ["utils"],
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "month-picker",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "月份选择器:输入框 + 锁定月视图的日历弹层,值以 \"yyyy-MM\" 字符串受控,min/max 为月粒度闭区间(内部换算到当月末日)。",
7
7
  "registryDependencies": ["utils", "date-shared", "calendar"],
8
- "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "dependencies": ["@ark-ui/vue@^5.40.0"],
9
9
  "files": [
10
10
  {
11
11
  "path": "month-picker/MonthPicker.vue",
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "number-input",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "数字输入框:内置加减步进按钮与数值边界,值以 number|null 受控(空值归一 null),支持 Intl 数字格式化。",
7
7
  "registryDependencies": ["utils"],
8
- "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "dependencies": ["@ark-ui/vue@^5.40.0"],
9
9
  "files": [
10
10
  {
11
11
  "path": "number-input/NumberInput.vue",
@@ -1,15 +1,21 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "overlay-shared",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "弹层家族共享逻辑:受控开合桥接(useControlledBoolean)与确认 pending 语义(useConfirmPending)。",
7
7
  "files": [
8
+ {
9
+ "path": "overlay-shared/config.ts",
10
+ "type": "registry:lib",
11
+ "target": "components/ui/overlay-shared/config.ts",
12
+ "content": "import type { InjectionKey } from \"vue\";\nimport { inject } from \"vue\";\nimport { isInIframeRealm, isInWujie } from \"./sandbox\";\n\n/**\n * TuDesignProvider 应用级显式配置层(plan: tu-design-provider-mode)。\n *\n * 动机:自动探测(marker / realm / 结构信号)存在固有边界——marker 随 wujie 版本漂移、\n * degrade 模式无法区分、故障静默。本模块新增手动声明层,解析优先级:\n * 组件显式 prop(to / positioning.strategy 等,已有) > Provider mode(本模块) > 自动探测(auto 缺省)。\n *\n * mode 语义 = 「隔离构成」行为组,判据是拓扑而非框架品牌(机制详注见 sandbox.ts 头注):\n * - none = { } // 独立运行 / qiankun / micro-app lightDOM / 纯 iframe 嵌入 / wujie degrade\n * - shadow = { teleport降级 } // micro-app strictStyleIsolation / web component\n * - shadow-iframe = { teleport降级, fixed策略, 锁禁用 } // wujie 默认模式(iframe realm + shadow graft 双重隔离)\n * - auto(缺省) = 现行探测链,行为与历史版本逐字节一致\n *\n * 纪律:\n * - 显式 mode 一律短路,不进入任何探测代码(marker 漂移免疫的可证性质);\n * - mode 只表达渲染环境单维度;新的根部能力走 Provider 命名空间对象 prop(present = enabled),\n * 且每个 prop 必须注明 mount-time / reactive(缺省 mount-time);\n * - `none` 是「显式关全部适配」,不保证与 auto 逐位等值(如纯 iframe 下 auto 会注入无害 fixed)。\n */\n\n/** 渲染环境声明(行为组名,非框架名) */\nexport type TuProviderMode = \"auto\" | \"none\" | \"shadow\" | \"shadow-iframe\";\n\n/** Provider 注入的配置快照(mount-time 消费;动态变更用 :key 重挂载) */\nexport interface TuProviderConfig {\n mode: TuProviderMode;\n /**\n * overlay 命名空间 prop(present = enabled,mount-time;issue #5)。\n * 可选键:既有 provide({ mode }) 字面量与 DEFAULT_CONFIG 不受影响。\n */\n overlay?: TuOverlayContract;\n}\n\n/** provide/inject 契约键(沿逻辑树传递,Teleport 子树同样命中) */\nexport const TU_PROVIDER_KEY: InjectionKey<TuProviderConfig> = Symbol(\"tu-provider\");\n\nconst DEFAULT_CONFIG: TuProviderConfig = { mode: \"auto\" };\n\n/**\n * 读取应用级配置;无 Provider 时缺省 auto(= 未引入本特性前的行为,向后兼容兜底)。\n * 须在 setup 顶层调用(inject 约束)。\n * @returns 最近 Provider 的配置快照,或 { mode: \"auto\" }\n */\nexport function useTuProvider(): TuProviderConfig {\n return inject(TU_PROVIDER_KEY, DEFAULT_CONFIG);\n}\n\n/**\n * Teleport 目标降级判定:shadow / shadow-iframe → 降级到应用挂载容器;\n * none → 恒 body;auto → 现行 isInWujie 探测(结构 shadowRoot 信号在\n * useSandboxTeleportTarget 内与本结果 OR,仅 auto 分支参与)。\n * @param mode 环境声明\n * @returns 是否强制降级(显式 mode 下不执行任何探测)\n */\nexport function teleportDegrade(mode: TuProviderMode): boolean {\n switch (mode) {\n case \"none\":\n return false;\n case \"shadow\":\n case \"shadow-iframe\":\n return true;\n case \"auto\":\n return isInWujie();\n }\n}\n\n/**\n * positioning.strategy 缺省 fixed 判定:仅 shadow-iframe(iframe realm + graft 坐标错位)\n * 与 auto 的 isInIframeRealm 探测注入;用户显式 strategy 的优先级在调用方\n * (withSandboxStrategy)先行短路。\n * @param mode 环境声明\n * @returns 用户未指定 strategy 时是否注入 fixed\n */\nexport function strategyFixed(mode: TuProviderMode): boolean {\n switch (mode) {\n case \"none\":\n case \"shadow\":\n return false;\n case \"shadow-iframe\":\n return true;\n case \"auto\":\n return isInIframeRealm();\n }\n}\n\n/**\n * 模态滚动锁策略:shadow-iframe → false(禁用,issue #4 的 graft 坐标系误补偿);\n * none / shadow → undefined(交还 Ark preventScroll=modal 派生默认);\n * auto → 现行 isInWujie ? false : undefined。\n * 传硬编码 true 永远禁止——attrs 透传 :modal=false 的既有用法会被强加滚动锁(行为回归)。\n * @param mode 环境声明\n * @returns false=显式禁用;undefined=不覆盖 Ark 缺省\n */\nexport function preventScrollOverride(mode: TuProviderMode): boolean | undefined {\n switch (mode) {\n case \"none\":\n case \"shadow\":\n return undefined;\n case \"shadow-iframe\":\n return false;\n case \"auto\":\n return isInWujie() ? false : undefined;\n }\n}\n\n/**\n * overlay 滚动锁契约(issue #5):消费方提供 lock() → 解锁函数,\n * 契约层只负责「是否消费」的拓扑判定,不包装、不持有状态。\n */\nexport interface TuOverlayContract {\n lock(): VoidFunction;\n}\n\n/**\n * overlay 契约消费判定(语义 B:仅锁禁用拓扑消费,issue #5)。\n * overlay 命名空间 prop present = enabled,mount-time 消费;\n * 仅当 preventScrollOverride(mode) === false(shadow-iframe 显式 / auto 探测命中 wujie)\n * 时透传契约引用,其余拓扑(none / shadow / auto 非 wujie / 未提供 overlay)一律 null。\n * 显式 mode 短路探测的性质由 preventScrollOverride 继承(marker 漂移免疫)。\n * @param config Provider 配置快照\n * @returns 锁禁用拓扑下为 config.overlay 同引用,否则 null\n */\nexport function overlayContract(config: TuProviderConfig): TuOverlayContract | null {\n return config.overlay && preventScrollOverride(config.mode) === false ? config.overlay : null;\n}\n"
13
+ },
8
14
  {
9
15
  "path": "overlay-shared/sandbox.ts",
10
16
  "type": "registry:lib",
11
17
  "target": "components/ui/overlay-shared/sandbox.ts",
12
- "content": "/**\n * 微前端沙箱探测(按渲染拓扑分派,框架无关)。\n *\n * 拓扑三分:\n * - 同文档(无沙箱 / qiankun / micro-app light DOM / 降级 iframe):absolute 正确\n * - 真 shadow DOM(web component 沙箱 / micro-app shadowDOM 模式):absolute 正确,\n * 由组件的 `getRootNode() instanceof ShadowRoot` 检测命中\n * - graft 型(wujie):iframe 文档树 graft 进 shadowRoot 渲染,absolute 输出视口系\n * 坐标但包含块是 graft body → 错位;fixed 以最近视口为包含块,是唯一正确解\n *\n * 安全性论证:非 graft 拓扑下 absolute 与 fixed 坐标等价(包含块同为最近视口),\n * iframe realm 下默认 fixed 零副作用;跨域 iframe 下 self/top 仅引用比较,\n * 不读属性,无 SecurityError。\n *\n * 已知边界:\n * - fixed 元素祖先有 transform/filter 时包含块被劫持(宿主布局应避免;graft 下\n * absolute 的 offsetParent 解析本就失效,错法不同而非新增错误)\n * - fixed 面板在祖先滚动时依赖 autoUpdate 重算,重算前一帧有视口驻留(瞬时视觉差异)\n * - 若未来出现「非 iframe 的 graft 型沙箱」,本探测无法覆盖,需追加该沙箱的 marker 信号\n */\n\n/**\n * 组件 JS 是否运行在 iframe realm(wujie / iframe 型沙箱 / 普通 iframe 嵌入)。\n * @returns 运行在 iframe realm 时返回 true,否则返回 false\n */\nexport function isInIframeRealm(): boolean {\n return typeof window !== \"undefined\" && window.self !== window.top;\n}\n\n/**\n * 是否处于 wujie graft 沙箱(getRootNode/父链被 wujie patch 伪装,结构探测失效,\n * 依赖官方标记;wujie 在子应用脚本执行前注入,时序可靠)。\n * @returns 处于 wujie graft 沙箱时返回 true,否则返回 false\n */\nexport function isInWujie(): boolean {\n return (\n typeof window !== \"undefined\" &&\n (window as { __POWERED_BY_WUJIE__?: boolean }).__POWERED_BY_WUJIE__ === true\n );\n}\n"
18
+ "content": "/**\n * 微前端沙箱探测(按渲染拓扑分派,框架无关)。\n *\n * 拓扑三分:\n * - 同文档(无沙箱 / qiankun / micro-app light DOM / 降级 iframe):absolute 正确\n * - 真 shadow DOM(web component 沙箱 / micro-app shadowDOM 模式):absolute 正确,\n * 由组件的 `getRootNode() instanceof ShadowRoot` 检测命中\n * - graft 型(wujie):iframe 文档树 graft 进 shadowRoot 渲染,absolute 输出视口系\n * 坐标但包含块是 graft body → 错位;fixed 以最近视口为包含块,是唯一正确解\n *\n * 安全性论证:非 graft 拓扑下 absolute 与 fixed 坐标等价(包含块同为最近视口),\n * iframe realm 下默认 fixed 零副作用;跨域 iframe 下 self/top 仅引用比较,\n * 不读属性,无 SecurityError。\n *\n * 已知边界:\n * - fixed 元素祖先有 transform/filter 时包含块被劫持(宿主布局应避免;graft 下\n * absolute 的 offsetParent 解析本就失效,错法不同而非新增错误)\n * - fixed 面板在祖先滚动时依赖 autoUpdate 重算,重算前一帧有视口驻留(瞬时视觉差异)\n * - 模态滚动锁(remove-scroll)同属 graft 坐标系差异家族:innerWidth(宿主视口)与\n * clientWidth(子应用容器)相减把宿主 chrome 宽误当滚动条 → 弹窗开合整页重排,\n * 策略收敛于 useSandboxOverlay.overlayPreventScroll()(wujie 下禁用,issue #4)\n * - 若未来出现「非 iframe 的 graft 型沙箱」,本探测无法覆盖,需追加该沙箱的 marker 信号\n */\n\n/**\n * 组件 JS 是否运行在 iframe realm(wujie / iframe 型沙箱 / 普通 iframe 嵌入)。\n * @returns 运行在 iframe realm 时返回 true,否则返回 false\n */\nexport function isInIframeRealm(): boolean {\n return typeof window !== \"undefined\" && window.self !== window.top;\n}\n\n/**\n * 是否处于 wujie graft 沙箱(getRootNode/父链被 wujie patch 伪装,结构探测失效,\n * 依赖官方标记;wujie 在子应用脚本执行前注入,时序可靠)。\n * @returns 处于 wujie graft 沙箱时返回 true,否则返回 false\n */\nexport function isInWujie(): boolean {\n return (\n typeof window !== \"undefined\" &&\n (window as { __POWERED_BY_WUJIE__?: boolean }).__POWERED_BY_WUJIE__ === true\n );\n}\n"
13
19
  },
14
20
  {
15
21
  "path": "overlay-shared/useConfirmPending.ts",
@@ -29,11 +35,17 @@
29
35
  "target": "components/ui/overlay-shared/useOverlayIds.ts",
30
36
  "content": "import { computed, useId } from \"vue\";\n\n/** 与 zag ids 兼容的宽类型:string 或函数型(如 select 的 item(value) => string) */\nexport type OverlayIds = Record<string, string | ((value: string) => string)>;\n\n/**\n * 浮层组件 ids 全量覆盖(无冒号化)。\n *\n * 背景:zag 缺省 id 惯例形如 `popover:{scope.id}:title`(各包 *.dom.js get*Id\n * 兜底分支),而部分 part 元素并不总是渲染(title/description/anchor/clearTrigger/\n * arrow 等),machine 仍会按状态变更反复 getById 查询。wujie 沙箱把\n * document.getElementById patch 成 `querySelector('[id=\"…\"]')` miss 后兜底\n * `querySelector('#'+id)`(wujie proxy.js),冒号未转义 → SyntaxError → catch 打出\n * \"[wujie warn] 不支持document.getElementById()传入特殊字符…\" 且打开期间反复刷屏。\n * ids 派生自 Vue useId()(v-0 格式,无冒号)后,未命中也是合法选择器,静默返回\n * null,告警消除;原生环境 getElementById 不解析选择器,行为零变化。\n *\n * 用法(组件 setup 内,inheritAttrs: false 透传模式下同样适用):\n * const { ids, resolveId } = useOverlayIds(attrs, {\n * primary: \"content\",\n * parts: [\"title\", \"description\", \"anchor\", \"trigger\", \"closeTrigger\", \"positioner\", \"arrow\"],\n * });\n * // 模板:<ArkXxx.Root v-bind=\"attrs\" :ids=\"ids\">(:ids 须位于 v-bind=\"attrs\" 之后)\n * // aria 手动接线取元素 id 时用 resolveId(part)(user 覆盖优先,与实际 DOM 一致)\n *\n * 边界:parts 只声明「字符串型覆盖口」的 part;函数型 part(如 select 的\n * item/itemGroup/itemGroupLabel——元素必渲染,[id=\"…\"] 首查即命中,无炸点)不进\n * parts,由 user 经 attrs.ids 直传原样保留。user 永远最后展开:显式传入以其为准。\n * @param attrs - 组件透传 attrs(其中的 ids 为用户覆盖项,可为 undefined)\n * @param options - 生成配置:primary 为主 part(stemId 不加后缀),parts 为声明覆盖口的 part 列表\n * @returns ids(合并用户覆盖后的完整 id 映射,供 :ids 受控绑定)与 resolveId(取实际生效的字符串 id,供 aria 手动接线)\n */\nexport function useOverlayIds(\n attrs: Record<string, unknown>,\n options: { primary: string; parts: readonly string[] },\n) {\n const stemId = useId();\n const userIds = computed(() => (attrs.ids ?? {}) as OverlayIds);\n /**\n * 默认派生值(不含 user 覆盖),独立于 ids 供 resolveId 回退;构造恒为字符串。\n * @returns 以 part 为键的默认 id 映射\n */\n const buildBase = (): Record<string, string> => {\n const base: Record<string, string> = {};\n for (const part of options.parts) {\n base[part] = part === options.primary ? stemId : `${stemId}-${part}`;\n }\n return base;\n };\n const ids = computed<OverlayIds>(() => ({ ...buildBase(), ...userIds.value })); // user 永远收尾\n /**\n * aria 接线用:user 字符串覆盖优先,函数型 user 回退默认值。\n * @param part - 目标 part 名(如 \"title\"、\"trigger\")\n * @returns 该 part 实际生效的字符串 id;part 未声明覆盖口时返回 undefined\n */\n const resolveId = (part: string) => {\n const v = userIds.value[part];\n return typeof v === \"string\" ? v : buildBase()[part];\n };\n return { ids, resolveId };\n}\n"
31
37
  },
38
+ {
39
+ "path": "overlay-shared/useOverlayScrollLock.ts",
40
+ "type": "registry:lib",
41
+ "target": "components/ui/overlay-shared/useOverlayScrollLock.ts",
42
+ "content": "import type { Ref } from \"vue\";\nimport { onBeforeUnmount, watch } from \"vue\";\nimport { overlayContract, useTuProvider } from \"./config\";\n\n/**\n * overlay 滚动锁契约消费(issue #5):wujie graft 下 Ark 原生滚动锁被禁用(issue #4),\n * 「锁背景」改由宿主经 Provider overlay 命名空间 prop 提供 lock() → 解锁函数契约。\n *\n * 设计依据(冻结语义):\n * - 语义 B 拓扑闸:仅锁禁用拓扑消费契约(overlayContract 内判定,shadow-iframe 显式 /\n * auto 探测命中 wujie),其余拓扑 setup 顶层直接 return,零 watch 零副作用。\n * - RAII 配对:lock() 返回的 release 与开合状态一一对应——open 且模态时持锁,\n * 关闭/非模态时释放,onBeforeUnmount 补调防泄漏(打开态直接卸载不丢 release)。\n * - sync + immediate:flush:\"sync\" 使 lock/release 在 isOpen 转换内同步完成,\n * 无 nextTick 窗口、同 tick 快速翻转不合并(true-false-true → lock 2 次 release 1 次);\n * immediate 覆盖初始 open=true 的挂载即锁场景。\n * - isModal 仅在 isOpen 转换回调内求值,不 watch attrs:打开期间 modal 变化不触发\n * 锁状态变更(三组件接线 () => attrs.modal !== false && attrs.modal !== \"false\")。\n *\n * @param isOpen - 开合状态(受控桥 ComputedRef 或内部 ref 均可)\n * @param isModal - 模态判定读取器(仅转换回调内求值)\n */\nexport function useOverlayScrollLock(isOpen: Ref<boolean>, isModal: () => boolean): void {\n const contract = overlayContract(useTuProvider());\n if (!contract) return;\n\n let release: VoidFunction | null = null;\n\n watch(\n isOpen,\n (open) => {\n if (open && isModal() && !release) {\n release = contract.lock();\n } else if ((!open || !isModal()) && release) {\n release();\n release = null;\n }\n },\n { immediate: true, flush: \"sync\" },\n );\n\n onBeforeUnmount(() => {\n if (release) {\n release();\n release = null;\n }\n });\n}\n"
43
+ },
32
44
  {
33
45
  "path": "overlay-shared/useSandboxOverlay.ts",
34
46
  "type": "registry:lib",
35
47
  "target": "components/ui/overlay-shared/useSandboxOverlay.ts",
36
- "content": "import type { ComputedRef } from \"vue\";\nimport { computed, getCurrentInstance, onMounted, ref } from \"vue\";\nimport { isInIframeRealm, isInWujie } from \"./sandbox\";\n\n/**\n * 浮层沙箱适配公共层(Popover 0.5.3 修复的推广形态,机制与实测依据见 sandbox.ts 头注):\n * - useSandboxTeleportTarget:Teleport 目标降级(真 shadow DOM / wujie graft → 应用挂载容器)\n * - withSandboxStrategy:iframe realm 下 positioning.strategy 默认 fixed(absolute 包含块错位修正)\n */\n\n/**\n * 浮层 Teleport 目标解析:显式 to > shadow DOM / wujie graft 自动降级 > body。\n *\n * app._container 在 mount 的 render 完成后才赋值(runtime-core 3.5.43:render L4337\n * → 赋值 L4340),而子组件 onMounted 在 render 内同步执行、届时仍为 undefined,\n * 故检测再延后一个微任务(mount 调用栈结束后 _container 必已赋值),结果存 ref\n * 驱动 computed 重算;getCurrentInstance 仅 setup 同步上下文可用,本函数须在\n * setup 顶层调用。共享 Vue(__MICRO_SHARED__)下各子应用 app._container 相互\n * 独立,检测按实例隔离。\n * 沙箱两类:真 shadow DOM 由 getRootNode() 命中;wujie graft 下 getRootNode/父链\n * 被 patch 伪装成 iframe 文档语义(实测),结构探测失效,须叠加官方标记位。\n * 其余微前端(qiankun / micro-app light DOM)body 即主文档 body,兜底正确。\n *\n * @param explicitTo 组件显式 to 的取值函数(响应式安全:computed 内重读)\n * @returns Teleport 目标(显式 to 优先,其次降级容器,兜底 body)\n */\nexport function useSandboxTeleportTarget(\n explicitTo: () => string | HTMLElement | undefined,\n): ComputedRef<string | HTMLElement> {\n const instance = getCurrentInstance();\n const inWujie = isInWujie();\n const detectedTarget = ref<string | HTMLElement>(\"body\");\n onMounted(() => {\n queueMicrotask(() => {\n if (explicitTo()) return;\n const container = (instance?.appContext.app as { _container?: HTMLElement } | undefined)\n ?._container;\n if (container && (container.getRootNode() instanceof ShadowRoot || inWujie)) {\n detectedTarget.value = container;\n }\n });\n });\n return computed(() => explicitTo() ?? detectedTarget.value);\n}\n\n/**\n * iframe realm(wujie graft / iframe 型沙箱 / iframe 嵌入)且用户未显式指定\n * strategy 时默认 fixed:非 graft 拓扑下 fixed 与 absolute 坐标等价(零副作用),\n * graft 拓扑(wujie)absolute 包含块错位,fixed 是唯一正确解。\n * 纯函数、原地写入 merged(调用方传入自己的合成对象,无共享引用风险);\n * user.strategy 显式给出(含 null 意义上的「未传」判定用 == null)时以其为准。\n *\n * @param user 用户原始 positioning(undefined 或经 attrs 透传的合成对象)\n * @param merged 组件已合成 placement/sameWidth 等的基础 positioning(将被写入)\n * @returns 写入 strategy 后的 merged(同引用,便于 computed 直接 return)\n */\nexport function withSandboxStrategy<T extends object>(user: T | undefined, merged: T): T {\n if (isInIframeRealm() && (user as { strategy?: string } | undefined)?.strategy == null) {\n (merged as { strategy?: string }).strategy = \"fixed\";\n }\n return merged;\n}\n"
48
+ "content": "import type { ComputedRef } from \"vue\";\nimport { computed, getCurrentInstance, onMounted, ref } from \"vue\";\nimport {\n type TuProviderConfig,\n preventScrollOverride,\n strategyFixed,\n teleportDegrade,\n useTuProvider,\n} from \"./config\";\n\n/**\n * 浮层沙箱适配公共层(Popover 0.5.3 修复的推广形态,机制与实测依据见 sandbox.ts 头注):\n * - useSandboxTeleportTarget:Teleport 目标降级(真 shadow DOM / wujie graft → 应用挂载容器)\n * - withSandboxStrategy:iframe realm 下 positioning.strategy 默认 fixed(absolute 包含块错位修正)\n * - overlayPreventScroll:模态浮层滚动锁按沙箱拓扑降级(wujie graft 下禁用,issue #4)\n *\n * 三项均「Provider mode 显式声明优先、缺省 auto 走探测」,解析语义见 config.ts。\n */\n\n/**\n * 浮层 Teleport 目标解析:显式 to > Provider mode / 探测降级 > body。\n *\n * app._container 在 mount 的 render 完成后才赋值(runtime-core 3.5.43:render L4337\n * → 赋值 L4340),而子组件 onMounted 在 render 内同步执行、届时仍为 undefined,\n * 故检测再延后一个微任务(mount 调用栈结束后 _container 必已赋值),结果存 ref\n * 驱动 computed 重算;getCurrentInstance 仅 setup 同步上下文可用,本函数须在\n * setup 顶层调用。共享 Vue(__MICRO_SHARED__)下各子应用 app._container 相互\n * 独立,检测按实例隔离。\n * 降级判定:显式 mode(shadow / shadow-iframe)短路降级、none 恒不降;auto 走现行\n * 双信号——真 shadow DOM 由 getRootNode() 命中,wujie graft 下 getRootNode/父链被\n * patch 伪装(实测)故叠加 marker。结构 shadowRoot 信号仅 auto 分支参与(显式声明\n * 时不再猜测)。其余微前端(qiankun / micro-app light DOM)body 即主文档 body,兜底正确。\n *\n * @param explicitTo 组件显式 to 的取值函数(响应式安全:computed 内重读)\n * @returns Teleport 目标(显式 to 优先,其次降级容器,兜底 body)\n */\nexport function useSandboxTeleportTarget(\n explicitTo: () => string | HTMLElement | undefined,\n): ComputedRef<string | HTMLElement> {\n const instance = getCurrentInstance();\n const { mode } = useTuProvider();\n const degrade = teleportDegrade(mode);\n const detectedTarget = ref<string | HTMLElement>(\"body\");\n onMounted(() => {\n queueMicrotask(() => {\n if (explicitTo()) return;\n const container = (instance?.appContext.app as { _container?: HTMLElement } | undefined)\n ?._container;\n if (\n container &&\n (degrade || (mode === \"auto\" && container.getRootNode() instanceof ShadowRoot))\n ) {\n detectedTarget.value = container;\n }\n });\n });\n return computed(() => explicitTo() ?? detectedTarget.value);\n}\n\n/**\n * 用户未显式指定 strategy 时按环境注入缺省 fixed:shadow-iframe 显式注入、\n * none / shadow 恒不注入、auto 走 isInIframeRealm 探测(非 graft 拓扑下 fixed 与\n * absolute 坐标等价,零副作用;graft 下 absolute 包含块错位,fixed 是唯一正确解)。\n * 优先级:user.strategy > Provider mode/探测 > 不注入。\n * 纯函数、原地写入 merged(调用方传入自己的合成对象,无共享引用风险);\n * user.strategy 显式给出(含 null 意义上的「未传」判定用 == null)时以其为准。\n * config 须在组件 setup 顶层经 useTuProvider() 捕获后传入(computed 内 inject 不可用)。\n *\n * @param user 用户原始 positioning(undefined 或经 attrs 透传的合成对象)\n * @param merged 组件已合成 placement/sameWidth 等的基础 positioning(将被写入)\n * @param config 应用级沙箱配置快照(setup 顶层 useTuProvider() 结果)\n * @returns 写入 strategy 后的 merged(同引用,便于 computed 直接 return)\n */\nexport function withSandboxStrategy<T extends object>(\n user: T | undefined,\n merged: T,\n config: TuProviderConfig,\n): T {\n if ((user as { strategy?: string } | undefined)?.strategy == null && strategyFixed(config.mode)) {\n (merged as { strategy?: string }).strategy = \"fixed\";\n }\n return merged;\n}\n\n/**\n * 模态浮层滚动锁策略(dialog / alert-dialog / drawer 共用,issue #4):\n * 按 useTuProvider().mode 解析(shadow-iframe 禁用 / none、shadow 交还缺省 /\n * auto 走 isInWujie 探测)。禁用依据:@zag-js/remove-scroll 的补偿公式\n * `scrollbarWidth = win.innerWidth − documentElement.clientWidth` 在 graft 下跨坐标系\n * (iframe 报宿主视口宽,documentElement 是 graft 进 shadowRoot 的子应用容器),\n * 宿主 chrome 宽被误当滚动条写入渲染 body(padding-right)→ 弹窗开合整页重排抖动;\n * 且主流 wujie 拓扑下子应用 body 本就不滚(滚动在宿主容器),锁无收益只有副作用。\n * 拓扑边界:若子应用 body 自身可滚,禁用后背景随弹窗可滚——带误补偿的锁不如不要,\n * wujie 下真正的「锁背景」需宿主参与(见 plan §6 follow-up)。\n * 传硬编码 true 永远禁止——本库组件单根、attrs 透传,消费方 :modal=\"false\" 的\n * 既有用法会被强加滚动锁(行为回归),undefined 经适配层 cleanProps 过滤后\n * 保留 zag 缺省 preventScroll = modal。\n * 须在 setup 顶层调用(inject 约束)。\n *\n * @returns false=禁用滚动锁;undefined=不覆盖 Ark 缺省\n */\nexport function overlayPreventScroll(): boolean | undefined {\n return preventScrollOverride(useTuProvider().mode);\n}\n"
37
49
  }
38
50
  ]
39
51
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "password-input",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "密码输入框:内置明文/掩码切换按钮(Eye/EyeOff,带 aria 语义),值与可见性均支持 v-model 受控。",
7
7
  "registryDependencies": ["utils"],
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "pin-input",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "多格验证码输入:length 指定格数,支持 otp/mask/字符类型、焦点自动跳格与填满回调,可选分隔符插槽。",
7
7
  "registryDependencies": ["utils"],
8
- "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "dependencies": ["@ark-ui/vue@^5.40.0"],
9
9
  "files": [
10
10
  {
11
11
  "path": "pin-input/PinInput.vue",
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "popconfirm",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "气泡确认:Popover 薄壳变体单组件,默认插槽为触发元素本体(asChild),title/description 传文案,@confirm/@cancel 处理确认与取消;确认处理器返回 Promise 时确认钮 loading 并锁定关闭通道,resolve 自动关闭、reject 保持打开。",
7
7
  "registryDependencies": ["utils", "popover", "button", "overlay-shared"],
8
- "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "dependencies": ["@ark-ui/vue@^5.40.0"],
9
9
  "files": [
10
10
  {
11
11
  "path": "popconfirm/Popconfirm.vue",
@@ -1,17 +1,17 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "popover",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "气泡弹层:基于 Ark UI Popover 原语的单组件,默认插槽为触发元素本体(asChild 语义),面板内容放 #content 插槽,受控/非受控开关。",
7
7
  "registryDependencies": ["utils", "overlay-shared"],
8
- "dependencies": ["@ark-ui/vue@^5.39.2", "clsx@^2.1.1"],
8
+ "dependencies": ["@ark-ui/vue@^5.40.0", "clsx@^2.1.1"],
9
9
  "files": [
10
10
  {
11
11
  "path": "popover/Popover.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/popover/Popover.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { ClassValue } from \"clsx\";\nimport type { PropType } from \"vue\";\nimport { computed, onBeforeUnmount, useAttrs, useSlots } from \"vue\";\nimport type { PopoverRootProps } from \"@ark-ui/vue/popover\";\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\n\n/** 面板相对触发器的对齐方向 */\ntype Align = \"start\" | \"center\" | \"end\";\n/** 面板主轴方向(与 align 组合成 12 方位 placement) */\ntype Side = \"top\" | \"bottom\" | \"left\" | \"right\";\n/** 触发方式:click 内建切换;hover/focus 延迟桥接;manual 纯受控 */\ntype TriggerMode = \"click\" | \"hover\" | \"focus\" | \"manual\";\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 /** 触发方式:click(默认,内建切换+完整 aria) / hover / focus(带延迟,Anchor+手动 aria) / manual(纯受控,仅定位锚点) */\n trigger: { type: String as PropType<TriggerMode>, default: \"click\" },\n /** hover/focus 打开延迟(毫秒) */\n openDelay: { type: Number, default: 100 },\n /** hover/focus 关闭延迟(毫秒) */\n closeDelay: { type: Number, default: 100 },\n /** hover/focus 时悬浮/聚焦面板保持打开 */\n keepAliveOnHover: { type: Boolean, default: true },\n /** 面板主轴方向(与 align 组合定位);attrs.positioning.placement 显式给出时以其为准 */\n side: { type: String as PropType<Side>, default: \"bottom\" },\n /** 面板相对触发器的对齐方向(默认居中) */\n align: { type: String as PropType<Align>, default: \"center\" },\n /** 显示箭头(shadcn 风格默认无箭头) */\n arrow: { type: Boolean, default: false },\n /** 追加/覆盖箭头样式类 */\n arrowClass: { type: String, default: undefined },\n /** 禁用触发(不响应任何触发事件;已打开状态不受影响) */\n disabled: { type: Boolean, default: false },\n /** 是否 Teleport(浮层定位不受嵌套裁剪影响);false 时面板留在原地 */\n portal: { type: Boolean, default: true },\n /** Teleport 目标(选择器或元素),仅 portal=true 时生效;\n 缺省时若应用挂载容器处于 shadow DOM 或 wujie graft 沙箱,自动降级为该容器,否则 body */\n to: { type: [String, Object] as PropType<string | HTMLElement>, default: undefined },\n /** 面板宽度与触发元素一致 */\n matchTriggerWidth: { type: Boolean, default: false },\n /** 覆盖面板/定位层级(默认走 --z-overlay) */\n zIndex: { type: Number, default: undefined },\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\nconst slots = useSlots();\nconst attrs = useAttrs();\n\n// —— Teleport 目标解析:显式 to > shadow DOM / wujie graft 自动降级 > body ——\n// 机制详注见 useSandboxTeleportTarget(Popover 0.5.3 沙箱修复的公共层抽离)\nconst teleportTarget = useSandboxTeleportTarget(() => props.to);\n\n// —— 受控桥接(Dialog 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// —— 触发路径分派:click 用内建 Trigger(完整 aria 自动接线);\n// hover/focus/manual 用 Anchor 作定位锚点(无内建 click,语义不冲突)。\n// disabled 时也切 Anchor:内建 TOGGLE 无法从外部短路(AT_TARGET 阶段监听器按注册顺序\n// 执行、capture 无优先级),不渲染 Trigger 是唯一可靠方式 ——\nconst useNativeTrigger = computed(() => props.trigger === \"click\" && !props.disabled);\n\n// —— Anchor 模式的手动 aria 接线(补偿放弃 Trigger 的自动接线)——\n// —— ids 全量覆盖(无冒号)详注见 useOverlayIds(wujie patch getElementById\n// 对 zag 缺省冒号 id `popover:{id}:*` 每次查询抛 SyntaxError 刷警告);\n// trigger 为静态 id,仅支持单触发器(本 wrapper 只渲染单个 Trigger/Anchor)——\nconst { ids: rootIds, resolveId } = useOverlayIds(attrs, {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"anchor\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"arrow\",\n ],\n});\nconst anchorAria = computed(() =>\n useNativeTrigger.value\n ? {}\n : {\n \"aria-haspopup\": \"dialog\" as const,\n \"aria-expanded\": isOpen.value,\n \"aria-controls\": resolveId(\"content\"), // user 覆盖优先,与面板实际 id 一致\n },\n);\n\n// —— 延迟桥接(hover/focus):单一定时器,进入取消关闭、离开取消打开 ——\nlet timer: ReturnType<typeof setTimeout> | null = null;\nconst clearTimer = () => {\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n};\nconst schedule = (next: boolean, delay: number) => {\n if (props.disabled) return;\n clearTimer();\n if (delay <= 0) {\n setOpen(next);\n return;\n }\n timer = setTimeout(() => {\n timer = null;\n if (!props.disabled) setOpen(next);\n }, delay);\n};\n\nconst isHoverFocus = () => props.trigger === \"hover\" || props.trigger === \"focus\";\n\nconst onTriggerEnter = () => {\n if (!isHoverFocus()) return;\n schedule(true, props.openDelay);\n};\nconst onTriggerLeave = () => {\n if (!isHoverFocus()) return;\n schedule(false, props.closeDelay);\n};\n// 面板悬浮/聚焦保活(keep-alive 语义):仅取消挂起的关闭计时\nconst onPanelEnter = () => {\n if (!isHoverFocus() || !props.keepAliveOnHover) return;\n clearTimer();\n};\n// 离开面板(去往触发器以外的地方)也应关闭:覆盖 trigger→panel→outside 链路\nconst onPanelLeave = () => {\n if (!isHoverFocus()) return;\n schedule(false, props.closeDelay);\n};\n\nonBeforeUnmount(clearTimer);\n\n// side/align → Ark positioning.placement(12 方位,居中不带对齐后缀);\n// 外部经 attrs 传入的 positioning 已显式指定 placement 时以其为准,其余字段原样合并。\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位修正),机制详注见\n// withSandboxStrategy / overlay-shared/sandbox.ts —— 沙箱修复的公共层抽离\nconst rootPositioning = computed<ArkPositioning>(() => {\n const user = (attrs.positioning ?? {}) as ArkPositioning;\n const placement = (\n props.align === \"center\" ? props.side : `${props.side}-${props.align}`\n ) as ArkPlacement;\n return withSandboxStrategy(user, {\n ...user,\n placement,\n sameWidth: props.matchTriggerWidth || user.sameWidth,\n });\n});\n\n// 面板样式:内置类 + contentClass + contentProps.class 三方合并(twMerge 自动去冲突,后者优先)\nconst contentClass = computed(() =>\n cn(\n \"bg-popover text-popover-foreground z-[var(--z-modal,60)] 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\n// 箭头:尺寸/底色经 CSS 变量交给 zag 内联样式(arrowTip 自动取 --arrow-background 上色)\nconst arrowClass = computed(() =>\n cn(\"[--arrow-size:10px] [--arrow-background:var(--popover)]\", props.arrowClass),\n);\n\n// zIndex prop 走内联 style(Tailwind 任意值类不适合动态拼接);未传保持默认层级类\nconst positionerClass = computed(() => (props.zIndex != null ? \"\" : \"z-[var(--z-modal,60)]\"));\nconst positionerStyle = computed(() =>\n props.zIndex != null ? { zIndex: props.zIndex } : undefined,\n);\n</script>\n\n<template>\n <ArkPopover.Root\n v-bind=\"attrs\"\n :open=\"isOpen\"\n :positioning=\"rootPositioning\"\n :ids=\"rootIds\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <!-- click 且未禁用:内建 Trigger,行为/aria 与旧版完全一致 -->\n <ArkPopover.Trigger v-if=\"useNativeTrigger\" as-child>\n <slot />\n </ArkPopover.Trigger>\n\n <!-- hover/focus/manual 或 disabled:Anchor + 自绑监听 + 手动 aria -->\n <ArkPopover.Anchor\n v-else-if=\"slots.default\"\n as-child\n v-bind=\"anchorAria\"\n @mouseenter=\"onTriggerEnter\"\n @mouseleave=\"onTriggerLeave\"\n @focusin=\"onTriggerEnter\"\n @focusout=\"onTriggerLeave\"\n >\n <slot />\n </ArkPopover.Anchor>\n\n <!-- portal:Teleport(Ark Vue 原语不自带传送,浮层定位不受嵌套 overflow 裁剪影响);\n portal=false 时 disabled Teleport 面板留在原地;to 显式指定目标,\n 缺省时真 shadow DOM(getRootNode 检测)与 wujie graft(marker 检测)沙箱\n 自动降级为应用挂载容器,避免传送出 shadow root -->\n <Teleport :to=\"teleportTarget\" :disabled=\"!props.portal\">\n <ArkPopover.Positioner :class=\"positionerClass\" :style=\"positionerStyle\">\n <ArkPopover.Content\n v-bind=\"props.contentProps\"\n :class=\"contentClass\"\n @mouseenter=\"onPanelEnter\"\n @mouseleave=\"onPanelLeave\"\n @focusin=\"onPanelEnter\"\n @focusout=\"onPanelLeave\"\n >\n <ArkPopover.Arrow v-if=\"props.arrow\" :class=\"arrowClass\">\n <ArkPopover.ArrowTip />\n </ArkPopover.Arrow>\n <slot name=\"header\" />\n <slot name=\"content\" />\n <slot name=\"footer\" />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </Teleport>\n </ArkPopover.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { ClassValue } from \"clsx\";\nimport type { PropType } from \"vue\";\nimport { computed, onBeforeUnmount, useAttrs, useSlots } from \"vue\";\nimport type { PopoverRootProps } from \"@ark-ui/vue/popover\";\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\nimport { useTuProvider } from \"../overlay-shared/config\";\n\n/** 面板相对触发器的对齐方向 */\ntype Align = \"start\" | \"center\" | \"end\";\n/** 面板主轴方向(与 align 组合成 12 方位 placement) */\ntype Side = \"top\" | \"bottom\" | \"left\" | \"right\";\n/** 触发方式:click 内建切换;hover/focus 延迟桥接;manual 纯受控 */\ntype TriggerMode = \"click\" | \"hover\" | \"focus\" | \"manual\";\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 /** 触发方式:click(默认,内建切换+完整 aria) / hover / focus(带延迟,Anchor+手动 aria) / manual(纯受控,仅定位锚点) */\n trigger: { type: String as PropType<TriggerMode>, default: \"click\" },\n /** hover/focus 打开延迟(毫秒) */\n openDelay: { type: Number, default: 100 },\n /** hover/focus 关闭延迟(毫秒) */\n closeDelay: { type: Number, default: 100 },\n /** hover/focus 时悬浮/聚焦面板保持打开 */\n keepAliveOnHover: { type: Boolean, default: true },\n /** 面板主轴方向(与 align 组合定位);attrs.positioning.placement 显式给出时以其为准 */\n side: { type: String as PropType<Side>, default: \"bottom\" },\n /** 面板相对触发器的对齐方向(默认居中) */\n align: { type: String as PropType<Align>, default: \"center\" },\n /** 显示箭头(shadcn 风格默认无箭头) */\n arrow: { type: Boolean, default: false },\n /** 追加/覆盖箭头样式类 */\n arrowClass: { type: String, default: undefined },\n /** 禁用触发(不响应任何触发事件;已打开状态不受影响) */\n disabled: { type: Boolean, default: false },\n /** 是否 Teleport(浮层定位不受嵌套裁剪影响);false 时面板留在原地 */\n portal: { type: Boolean, default: true },\n /** Teleport 目标(选择器或元素),仅 portal=true 时生效;\n 缺省时若应用挂载容器处于 shadow DOM 或 wujie graft 沙箱,自动降级为该容器,否则 body */\n to: { type: [String, Object] as PropType<string | HTMLElement>, default: undefined },\n /** 面板宽度与触发元素一致 */\n matchTriggerWidth: { type: Boolean, default: false },\n /** 覆盖面板/定位层级(默认走 --z-overlay) */\n zIndex: { type: Number, default: undefined },\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\nconst slots = useSlots();\nconst attrs = useAttrs();\n\n// —— Teleport 目标解析:显式 to > shadow DOM / wujie graft 自动降级 > body ——\n// 机制详注见 useSandboxTeleportTarget(Popover 0.5.3 沙箱修复的公共层抽离)\nconst teleportTarget = useSandboxTeleportTarget(() => props.to);\n\n// —— 受控桥接(Dialog 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// —— 触发路径分派:click 用内建 Trigger(完整 aria 自动接线);\n// hover/focus/manual 用 Anchor 作定位锚点(无内建 click,语义不冲突)。\n// disabled 时也切 Anchor:内建 TOGGLE 无法从外部短路(AT_TARGET 阶段监听器按注册顺序\n// 执行、capture 无优先级),不渲染 Trigger 是唯一可靠方式 ——\nconst useNativeTrigger = computed(() => props.trigger === \"click\" && !props.disabled);\n\n// —— Anchor 模式的手动 aria 接线(补偿放弃 Trigger 的自动接线)——\n// —— ids 全量覆盖(无冒号)详注见 useOverlayIds(wujie patch getElementById\n// 对 zag 缺省冒号 id `popover:{id}:*` 每次查询抛 SyntaxError 刷警告);\n// trigger 为静态 id,仅支持单触发器(本 wrapper 只渲染单个 Trigger/Anchor)——\nconst { ids: rootIds, resolveId } = useOverlayIds(attrs, {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"anchor\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"arrow\",\n ],\n});\nconst anchorAria = computed(() =>\n useNativeTrigger.value\n ? {}\n : {\n \"aria-haspopup\": \"dialog\" as const,\n \"aria-expanded\": isOpen.value,\n \"aria-controls\": resolveId(\"content\"), // user 覆盖优先,与面板实际 id 一致\n },\n);\n\n// —— 延迟桥接(hover/focus):单一定时器,进入取消关闭、离开取消打开 ——\nlet timer: ReturnType<typeof setTimeout> | null = null;\nconst clearTimer = () => {\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n};\nconst schedule = (next: boolean, delay: number) => {\n if (props.disabled) return;\n clearTimer();\n if (delay <= 0) {\n setOpen(next);\n return;\n }\n timer = setTimeout(() => {\n timer = null;\n if (!props.disabled) setOpen(next);\n }, delay);\n};\n\nconst isHoverFocus = () => props.trigger === \"hover\" || props.trigger === \"focus\";\n\nconst onTriggerEnter = () => {\n if (!isHoverFocus()) return;\n schedule(true, props.openDelay);\n};\nconst onTriggerLeave = () => {\n if (!isHoverFocus()) return;\n schedule(false, props.closeDelay);\n};\n// 面板悬浮/聚焦保活(keep-alive 语义):仅取消挂起的关闭计时\nconst onPanelEnter = () => {\n if (!isHoverFocus() || !props.keepAliveOnHover) return;\n clearTimer();\n};\n// 离开面板(去往触发器以外的地方)也应关闭:覆盖 trigger→panel→outside 链路\nconst onPanelLeave = () => {\n if (!isHoverFocus()) return;\n schedule(false, props.closeDelay);\n};\n\nonBeforeUnmount(clearTimer);\n\n// Provider 显式配置快照:withSandboxStrategy 在 computed 内调用,inject 须于 setup 顶层捕获后传入\nconst tuProvider = useTuProvider();\n\n// side/align → Ark positioning.placement(12 方位,居中不带对齐后缀);\n// 外部经 attrs 传入的 positioning 已显式指定 placement 时以其为准,其余字段原样合并。\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位修正),机制详注见\n// withSandboxStrategy / overlay-shared/sandbox.ts —— 沙箱修复的公共层抽离\nconst rootPositioning = computed<ArkPositioning>(() => {\n const user = (attrs.positioning ?? {}) as ArkPositioning;\n const placement = (\n props.align === \"center\" ? props.side : `${props.side}-${props.align}`\n ) as ArkPlacement;\n return withSandboxStrategy(\n user,\n {\n ...user,\n placement,\n sameWidth: props.matchTriggerWidth || user.sameWidth,\n },\n tuProvider,\n );\n});\n\n// 面板样式:内置类 + contentClass + contentProps.class 三方合并(twMerge 自动去冲突,后者优先)\nconst contentClass = computed(() =>\n cn(\n \"bg-popover text-popover-foreground z-[var(--z-modal,60)] 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\n// 箭头:尺寸/底色经 CSS 变量交给 zag 内联样式(arrowTip 自动取 --arrow-background 上色)\nconst arrowClass = computed(() =>\n cn(\"[--arrow-size:10px] [--arrow-background:var(--popover)]\", props.arrowClass),\n);\n\n// zIndex prop 走内联 style(Tailwind 任意值类不适合动态拼接);未传保持默认层级类\nconst positionerClass = computed(() => (props.zIndex != null ? \"\" : \"z-[var(--z-modal,60)]\"));\nconst positionerStyle = computed(() =>\n props.zIndex != null ? { zIndex: props.zIndex } : undefined,\n);\n</script>\n\n<template>\n <ArkPopover.Root\n v-bind=\"attrs\"\n :open=\"isOpen\"\n :positioning=\"rootPositioning\"\n :ids=\"rootIds\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <!-- click 且未禁用:内建 Trigger,行为/aria 与旧版完全一致 -->\n <ArkPopover.Trigger v-if=\"useNativeTrigger\" as-child>\n <slot />\n </ArkPopover.Trigger>\n\n <!-- hover/focus/manual 或 disabled:Anchor + 自绑监听 + 手动 aria -->\n <ArkPopover.Anchor\n v-else-if=\"slots.default\"\n as-child\n v-bind=\"anchorAria\"\n @mouseenter=\"onTriggerEnter\"\n @mouseleave=\"onTriggerLeave\"\n @focusin=\"onTriggerEnter\"\n @focusout=\"onTriggerLeave\"\n >\n <slot />\n </ArkPopover.Anchor>\n\n <!-- portal:Teleport(Ark Vue 原语不自带传送,浮层定位不受嵌套 overflow 裁剪影响);\n portal=false 时 disabled Teleport 面板留在原地;to 显式指定目标,\n 缺省时真 shadow DOM(getRootNode 检测)与 wujie graft(marker 检测)沙箱\n 自动降级为应用挂载容器,避免传送出 shadow root -->\n <Teleport :to=\"teleportTarget\" :disabled=\"!props.portal\">\n <ArkPopover.Positioner :class=\"positionerClass\" :style=\"positionerStyle\">\n <ArkPopover.Content\n v-bind=\"props.contentProps\"\n :class=\"contentClass\"\n @mouseenter=\"onPanelEnter\"\n @mouseleave=\"onPanelLeave\"\n @focusin=\"onPanelEnter\"\n @focusout=\"onPanelLeave\"\n >\n <ArkPopover.Arrow v-if=\"props.arrow\" :class=\"arrowClass\">\n <ArkPopover.ArrowTip />\n </ArkPopover.Arrow>\n <slot name=\"header\" />\n <slot name=\"content\" />\n <slot name=\"footer\" />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </Teleport>\n </ArkPopover.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "popover/index.ts",
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "progress",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "进度条:基于 Ark UI Progress 原语,支持语义色、标签与百分比显示、不确定态。",
7
7
  "registryDependencies": ["utils"],
8
- "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "dependencies": ["@ark-ui/vue@^5.40.0"],
9
9
  "files": [
10
10
  {
11
11
  "path": "progress/Progress.vue",
@@ -0,0 +1,28 @@
1
+ {
2
+ "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
+ "name": "provider",
4
+ "version": "0.5.12",
5
+ "type": "registry:ui",
6
+ "description": "应用根组件(可选):mode 显式声明微前端渲染环境(覆盖浮层沙箱自动探测),:toast 聚合消息提示宿主;不使用时一切行为与自动探测一致。",
7
+ "registryDependencies": ["overlay-shared", "toast"],
8
+ "files": [
9
+ {
10
+ "path": "provider/TuDesignProvider.vue",
11
+ "type": "registry:component",
12
+ "target": "components/ui/provider/TuDesignProvider.vue",
13
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { provide } from \"vue\";\nimport { preventScrollOverride, TU_PROVIDER_KEY } from \"../overlay-shared/config\";\nimport type { TuOverlayContract, TuProviderMode } from \"../overlay-shared/config\";\nimport { ToastProvider } from \"../toast\";\nimport type { TuToastConfig } from \"./types\";\n\n/**\n * 应用根组件(可选层):微前端环境显式声明 + 根部能力聚合。\n *\n * 1. `mode`:声明渲染环境,覆盖浮层组件的自动沙箱探测(Teleport 降级 /\n * 定位策略 / 模态滚动锁)。解析优先级:组件显式 prop > 本 mode > 自动探测。\n * 行为组语义与框架映射表见文档「微前端与沙箱 · 手动声明运行环境」。\n * 不挂载本组件或不传 mode 时,一切行为与自动探测现行版本完全一致。\n * 2. `:toast`:消息提示宿主(组合渲染 ToastProvider,present = enabled);\n * 与独立挂载 ToastProvider 二选一,双挂载 dev 告警。\n * 3. `:overlay`:滚动锁契约(present = enabled,语义 B:仅锁禁用拓扑生效);\n * 经 provide 快照透传,消费判定见 overlayContract()。非锁禁用拓扑下 dev 告警。\n *\n * 三者均为 mount-time 契约(provide 快照 / ToastProvider 挂载时消费),\n * 动态变更用 :key 重挂载。须包住子应用根(inject 沿逻辑树,Teleport 子树同样命中;\n * 组件挂载在 Provider 子树之外时回落 auto 兜底)。\n */\ndefineOptions({ inheritAttrs: false });\n\nconst props = defineProps({\n /** 渲染环境声明(行为组名,非框架名);缺省 auto = 现行探测链 */\n mode: { type: String as PropType<TuProviderMode>, default: \"auto\" },\n /** 消息提示宿主配置:未传不渲染 Toaster;传 {} 全走缺省 */\n toast: { type: Object as PropType<TuToastConfig>, default: undefined },\n /** overlay 滚动锁契约(present = enabled):仅锁禁用拓扑消费(语义 B),mount-time */\n overlay: { type: Object as PropType<TuOverlayContract>, default: undefined },\n});\n\n// mount-time 快照:mode / overlay 变更不响应(契约见组件头注)\nprovide(TU_PROVIDER_KEY, { mode: props.mode, overlay: props.overlay });\n\n// dev 告警(每次 mount 一次,setup 顶层求值;auto 探测时机已探针实证):\n// 语义 B——overlay 契约仅锁禁用拓扑生效,其余拓扑传入即静默不消费,须显式提示\nif (import.meta.env.DEV && props.overlay && preventScrollOverride(props.mode) !== false) {\n console.warn(\n \"[tu-design] TuDesignProvider :overlay 仅锁禁用拓扑生效(语义 B):当前 mode 下滚动锁未被禁用,overlay 契约不会被消费。\",\n );\n}\n</script>\n\n<template>\n <!-- present = enabled::toast 传入即挂载消息宿主(组合复用 ToastProvider,零复制) -->\n <ToastProvider v-if=\"props.toast\" v-bind=\"props.toast\" />\n <slot />\n</template>\n"
14
+ },
15
+ {
16
+ "path": "provider/index.ts",
17
+ "type": "registry:lib",
18
+ "target": "components/ui/provider/index.ts",
19
+ "content": "export { default as TuDesignProvider } from \"./TuDesignProvider.vue\";\nexport type { TuToastConfig } from \"./types\";\nexport type { TuProviderMode } from \"../overlay-shared/config\";\n"
20
+ },
21
+ {
22
+ "path": "provider/types.ts",
23
+ "type": "registry:lib",
24
+ "target": "components/ui/provider/types.ts",
25
+ "content": "import type { ToastPlacement } from \"../toast/useToast\";\n\n/**\n * `TuDesignProvider` 的 `:toast` 命名空间配置(present = enabled)。\n * 各键语义与独立使用 ToastProvider 时的同名 prop 完全一致;mount-time 消费。\n */\nexport interface TuToastConfig {\n /** 弹出位置 */\n placement?: ToastPlacement;\n /** 默认自动关闭时长(ms) */\n duration?: number;\n /** 同屏最大数量,超出排队 */\n max?: number;\n}\n\n/**\n * 根部能力契约备忘(新能力加入 Provider 时遵循):\n * - 命名空间对象 prop(如 toast),present = enabled,未传 = 该能力关闭;\n * - mount-time / reactive 必须显式声明,缺省 mount-time;\n * - 不再新增平级 Provider 组件,能力一律聚合到 TuDesignProvider。\n */\n"
26
+ }
27
+ ]
28
+ }
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "radio-group",
4
- "version": "0.5.10",
4
+ "version": "0.5.12",
5
5
  "type": "registry:ui",
6
6
  "description": "单选组:基于 Ark UI Radio Group 原语,键盘导航与受控/非受控双模式。",
7
7
  "registryDependencies": ["utils"],
8
- "dependencies": ["@ark-ui/vue@^5.39.2"],
8
+ "dependencies": ["@ark-ui/vue@^5.40.0"],
9
9
  "files": [
10
10
  {
11
11
  "path": "radio-group/RadioGroup.vue",