@tu-design/vue 0.5.11 → 0.5.13
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/dist/index.d.mts +56 -38
- package/dist/index.mjs +140 -5
- package/dist/registry/vue/alert-dialog.json +2 -2
- 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 +1 -1
- package/dist/registry/vue/calendar.json +1 -1
- package/dist/registry/vue/card.json +1 -1
- package/dist/registry/vue/cascader.json +1 -1
- package/dist/registry/vue/checkbox.json +1 -1
- package/dist/registry/vue/context-menu.json +1 -1
- package/dist/registry/vue/currency-input.json +1 -1
- package/dist/registry/vue/date-picker.json +1 -1
- package/dist/registry/vue/date-range-picker.json +1 -1
- package/dist/registry/vue/date-shared.json +1 -1
- package/dist/registry/vue/dialog.json +2 -2
- package/dist/registry/vue/drawer.json +2 -2
- package/dist/registry/vue/dropdown-menu.json +1 -1
- package/dist/registry/vue/empty.json +1 -1
- package/dist/registry/vue/form-render.json +1 -1
- package/dist/registry/vue/form.json +1 -1
- package/dist/registry/vue/icon-shared.json +1 -1
- package/dist/registry/vue/input.json +1 -1
- package/dist/registry/vue/label.json +1 -1
- package/dist/registry/vue/month-picker.json +1 -1
- package/dist/registry/vue/number-input.json +1 -1
- package/dist/registry/vue/overlay-shared.json +14 -2
- package/dist/registry/vue/password-input.json +1 -1
- package/dist/registry/vue/pin-input.json +1 -1
- package/dist/registry/vue/popconfirm.json +1 -1
- package/dist/registry/vue/popover.json +1 -1
- package/dist/registry/vue/progress.json +1 -1
- package/dist/registry/vue/provider.json +2 -2
- package/dist/registry/vue/radio-group.json +1 -1
- package/dist/registry/vue/registry.json +53 -53
- package/dist/registry/vue/select.json +1 -1
- 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 +1 -1
- package/dist/registry/vue/spin.json +1 -1
- package/dist/registry/vue/switch.json +1 -1
- package/dist/registry/vue/table-render.json +1 -1
- package/dist/registry/vue/tabs.json +1 -1
- package/dist/registry/vue/textarea.json +1 -1
- package/dist/registry/vue/timeline.json +1 -1
- package/dist/registry/vue/toast.json +3 -3
- package/dist/registry/vue/tokens.json +1 -1
- package/dist/registry/vue/tooltip.json +1 -1
- package/dist/registry/vue/tree-select.json +1 -1
- package/dist/registry/vue/tree-shared.json +1 -1
- package/dist/registry/vue/utils.json +1 -1
- package/dist/registry/vue/week-picker.json +1 -1
- package/dist/registry/vue/year-picker.json +1 -1
- package/package.json +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "context-menu",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "右键菜单:单组件模式,items 描述菜单项(与 dropdown-menu 同构,含分组/标题/分隔线,支持嵌套),默认插槽为触发元素(ContextTrigger as-child,右键唤出并定位到指针处),内置键盘导航与选中回调。",
|
|
7
7
|
"registryDependencies": ["overlay-shared", "utils", "dropdown-menu"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "currency-input",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "金额输入框:内置万/元/角/分单位后缀,labelUnit 输入单位与 valueUnit 存储单位自动换算(整数分最小精度),值以 number|null 受控。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "date-picker",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "日期选择器:输入框 + 日历弹层(月/年视图切换),支持手动键入/清空/min-max 边界/不可选谓词,值以 \"yyyy-MM-dd\" 字符串受控。",
|
|
7
7
|
"registryDependencies": ["utils", "date-shared", "calendar"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "date-range-picker",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "日期范围选择器:双月日历弹层(月/年视图切换),点选起点与终点,值以 [\"yyyy-MM-dd\", \"yyyy-MM-dd\"] 有序元组受控,空值归一 null。",
|
|
7
7
|
"registryDependencies": ["icon-shared", "utils", "date-shared", "calendar", "overlay-shared"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "date-shared",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "日期家族共享模块:ISO 值域解析(日期/月/年/区间)、日历样式常量与单值选择器外壳(PickerShell/usePickerBridge)。",
|
|
7
7
|
"registryDependencies": ["icon-shared", "utils", "overlay-shared"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "dialog",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "模态对话框单组件:#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Dialog 原语,含焦点圈定、Escape/遮罩关闭与进出场动画,支持 v-model:open。",
|
|
7
7
|
"registryDependencies": ["icon-shared", "utils", "overlay-shared"],
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"path": "dialog/Dialog.vue",
|
|
12
12
|
"type": "registry:component",
|
|
13
13
|
"target": "components/ui/dialog/Dialog.vue",
|
|
14
|
-
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { overlayPreventScroll } from \"../overlay-shared/useSandboxOverlay\";\nimport CloseIcon from \"../icon-shared/CloseIcon.vue\";\n\n// ids 全量覆盖(无冒号):规避 wujie patch getElementById 对 zag 缺省冒号 id 的\n// SyntaxError 刷屏(详注见 useOverlayIds)\nconst { ids: rootIds } = useOverlayIds(
|
|
14
|
+
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Dialog as ArkDialog } from \"@ark-ui/vue/dialog\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { 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)\nconst { ids: rootIds } = useOverlayIds(attrs, {\n primary: \"content\",\n parts: [\"content\", \"title\", \"description\", \"trigger\", \"closeTrigger\", \"positioner\", \"backdrop\"],\n});\n\n// 用运行时 props 显式 default: undefined:Boolean prop 缺省时 Vue 会 cast 成 false,\n// 导致无法区分「未传(非受控)」与「传了 false(受控关闭)」。\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控,由内部状态管理 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次打开前不挂载内容 */\n lazyMount: { type: Boolean, default: false },\n /** 关闭后卸载内容(关闭动画结束后) */\n unmountOnExit: { type: Boolean, default: false },\n /** 标题文案(#title 插槽优先,两者皆无则不渲染标题) */\n title: { type: String, default: undefined },\n /** 描述文案(#description 插槽优先,两者皆无则不渲染描述) */\n description: { type: String, default: undefined },\n /** 是否渲染右上角内置关闭按钮 */\n showCloseButton: { type: Boolean, default: true },\n /** 追加/覆盖面板样式类(默认 sm:max-w-lg 可由此覆盖,如 \"sm:max-w-xl\") */\n contentClass: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// 对 Root 恒走受控模式(open 恒为布尔):非受控语义由内部 ref 实现,\n// 避开 zag uncontrolled 内部状态在部分环境下不同步的问题,两种模式行为一致。\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// overlay 滚动锁契约(issue #5,语义 B 拓扑闸在 overlayContract 内);\n// isModal 仅在 isOpen 转换回调内求值(冻结语义,不 watch attrs)\nuseOverlayScrollLock(isOpen, () => attrs.modal !== false && attrs.modal !== \"false\");\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// 滚动锁沙箱降级(wujie graft 下禁用,机制与论证见 overlayPreventScroll / issue #4);\n// wujie marker 先于子应用脚本注入,setup 顶层求值时序可靠\nconst preventScroll = overlayPreventScroll();\n\n// 面板样式:内置类 + contentClass 合并(twMerge 自动去冲突,后者优先)。\n// 面板底色走 --dialog 模态表面位(issue #2):--background 是页面画布语义,画布带色的主题下面板不被染色。\nconst contentClass = computed(() =>\n cn(\n \"bg-dialog text-dialog-foreground data-[state=open]:animate-in data-[state=closed]:animate-out fixed left-1/2 top-1/2 z-[var(--z-modal,60)] grid w-full max-w-[calc(100%-2rem)] -translate-x-1/2 -translate-y-1/2 gap-4 rounded-lg border p-6 shadow-lg duration-200 data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95 sm:max-w-lg\",\n props.contentClass,\n ),\n);\n</script>\n\n<template>\n <ArkDialog.Root\n :ids=\"rootIds\"\n :open=\"isOpen\"\n :prevent-scroll=\"preventScroll\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <!-- #trigger:触发元素本体(asChild 语义合并到子元素,原 TDialogTrigger 同款实现);未提供则不渲染触发器 -->\n <ArkDialog.Trigger v-if=\"$slots.trigger\" as-child>\n <slot name=\"trigger\" />\n </ArkDialog.Trigger>\n\n <ArkDialog.Backdrop\n class=\"fixed inset-0 z-[var(--z-modal,60)] bg-black/50 data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0\"\n />\n <ArkDialog.Positioner\n class=\"fixed inset-0 z-[var(--z-modal,60)] flex items-center justify-center p-4\"\n >\n <ArkDialog.Content :class=\"contentClass\">\n <!-- 标题/描述:#title / #description 插槽优先,回退 title/description props;皆无则不渲染对应 DOM -->\n <div\n v-if=\"hasHeader || $slots.title || $slots.description\"\n class=\"flex flex-col gap-2 text-center sm:text-left\"\n >\n <ArkDialog.Title\n v-if=\"$slots.title || props.title\"\n class=\"text-lg font-semibold leading-none tracking-tight\"\n >\n <slot name=\"title\">{{ props.title }}</slot>\n </ArkDialog.Title>\n <ArkDialog.Description\n v-if=\"$slots.description || props.description\"\n class=\"text-sm text-muted-foreground\"\n >\n <slot name=\"description\">{{ props.description }}</slot>\n </ArkDialog.Description>\n </div>\n\n <!-- 默认插槽:弹层内容区(原 TDialogContent 的 body 部分) -->\n <slot />\n\n <!-- 底部操作区:#footer=\"{ close }\" 注入关闭函数,替代原 TDialogClose -->\n <div v-if=\"$slots.footer\" class=\"flex flex-col-reverse gap-2 sm:flex-row sm:justify-end\">\n <slot name=\"footer\" :close=\"close\" />\n </div>\n\n <ArkDialog.CloseTrigger\n v-if=\"props.showCloseButton\"\n class=\"absolute right-4 top-4 cursor-pointer rounded-sm opacity-70 transition-opacity hover:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none\"\n >\n <slot name=\"close\">\n <CloseIcon class=\"size-4\" />\n <span class=\"sr-only\">关闭</span>\n </slot>\n </ArkDialog.CloseTrigger>\n </ArkDialog.Content>\n </ArkDialog.Positioner>\n </ArkDialog.Root>\n</template>\n"
|
|
15
15
|
},
|
|
16
16
|
{
|
|
17
17
|
"path": "dialog/index.ts",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "drawer",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "抽屉单组件:从四方向滑出的侧边/顶底面板,#trigger 放触发元素,title/description 传文案,#footer 注入 close 关闭;基于 Ark UI Drawer 原语,进出场动画随 placement 方向自适应,含焦点圈定、Escape/遮罩关闭,支持 v-model:open。",
|
|
7
7
|
"registryDependencies": ["icon-shared", "utils", "overlay-shared"],
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"path": "drawer/Drawer.vue",
|
|
12
12
|
"type": "registry:component",
|
|
13
13
|
"target": "components/ui/drawer/Drawer.vue",
|
|
14
|
-
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, useAttrs } from \"vue\";\nimport { Drawer as ArkDrawer } from \"@ark-ui/vue/drawer\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { overlayPreventScroll } from \"../overlay-shared/useSandboxOverlay\";\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(
|
|
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,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "dropdown-menu",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "下拉菜单:单组件模式,items 描述菜单项(含分组/标题/分隔线,支持嵌套),内置键盘导航与选中回调,默认插槽为触发元素(asChild 透传)。",
|
|
7
7
|
"registryDependencies": ["utils", "overlay-shared"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "form-render",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
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.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "表单状态与校验:基于 TanStack Form,配合 Valibot(Standard Schema)声明式校验,aria 自动接线。",
|
|
7
7
|
"registryDependencies": ["utils", "input", "button", "label"],
|
|
@@ -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.
|
|
4
|
+
"version": "0.5.13",
|
|
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": "month-picker",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "月份选择器:输入框 + 锁定月视图的日历弹层,值以 \"yyyy-MM\" 字符串受控,min/max 为月粒度闭区间(内部换算到当月末日)。",
|
|
7
7
|
"registryDependencies": ["utils", "date-shared", "calendar"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "number-input",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "数字输入框:内置加减步进按钮与数值边界,值以 number|null 受控(空值归一 null),支持 Intl 数字格式化。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "overlay-shared",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "弹层家族共享逻辑:受控开合桥接(useControlledBoolean)与确认 pending 语义(useConfirmPending)。",
|
|
7
7
|
"files": [
|
|
@@ -9,7 +9,13 @@
|
|
|
9
9
|
"path": "overlay-shared/config.ts",
|
|
10
10
|
"type": "registry:lib",
|
|
11
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\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"
|
|
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
|
+
},
|
|
14
|
+
{
|
|
15
|
+
"path": "overlay-shared/rafClock.ts",
|
|
16
|
+
"type": "registry:lib",
|
|
17
|
+
"target": "components/ui/overlay-shared/rafClock.ts",
|
|
18
|
+
"content": "/**\n * rAF 时钟守卫——「沙箱时钟混用」家族修复(issue #6)。\n *\n * 机制链(wujie 2.1.0 真机实证):\n * 1. wujie `windowRegWhiteList` 含 `/animationFrame$/i`,patchWindowEffect 把子应用\n * iframe window 的 `requestAnimationFrame` 替换为宿主 rAF 的 bind 包装(own\n * property,name 为 \"bound requestAnimationFrame\");`performance` 不在白名单,\n * 保持 iframe 本地 → 子应用内两时钟分属两条时间线,偏移 = 宿主加载→子应用\n * 打开间隔(秒~分钟级);\n * 2. `@zag-js/utils` 的 Timer(1.47.0/1.48.0 同构)混用两时钟:`start()` 取\n * `performance.now()`(本地),`tick()` 取 rAF 回调时间戳(宿主)→\n * `deltaMs ≈ 偏移 ≫ duration`,有限时长 toast 首 tick 即 DISMISS;\n * loading/duration:Infinity 走 shouldPersist 直通不启计时器,故完全正常\n * (与真机差分症状逐条吻合);\n * 3. 同族消费方:@zag-js/toast / clipboard / splitter / timer 四个机器,\n * 单点修复(本守卫)全部覆盖;\n * 4. 注:现代 Chrome 对「原始」同源 iframe 的 rAF 时间戳按 document 自身\n * timeOrigin 相对化(whatwg/html#9823 后的规范),普通 iframe 嵌入无此 bug\n * ——守卫 therefore 必须按运行时哨兵门控,不能按拓扑 mode 门控(否则普通\n * iframe 下反而注入 duration+偏移 的反向 bug,真机实证 3000ms → 7044ms)。\n *\n * 归一化形态:回调时间戳整体改传本地 `performance.now()`(上游单时钟方案的\n * 应用层同构),不做 timeOrigin 偏移算术——不访问 `window.parent`,跨域沙箱\n * 免疫,无符号错误面;误差预算 ≤1 帧(zag Timer 仅做 `deltaMs >= delay`\n * 比较,不依赖同帧同值,影响可忽略)。\n *\n * 门控:哨兵 = 安装后首个 rAF 回调测 `|ts − performance.now()|`;正常环境帧内\n * 抖动 ≤16ms,阈值 100ms(≈6 帧)零误伤。zag 上游修复(tick 单时钟)落地后,\n * 哨兵测得漂移≈0,守卫自动休眠——可与上游修复安全共存,无需回改本文件。\n *\n * 时序:同步安装包装(setup 顶层调用,零空窗)→ 主动排一帧空回调做哨兵 →\n * 裁决:干净则恢复全局原引用(已排队的 in-flight 回调仍经包装无害放行),\n * 漂移则保持武装。裁决前(首帧内)回调原样放行(= 原生行为)。\n *\n * 已知边界:\n * - wujie 同白名单替换了 cancelAnimationFrame,宿主 rAF id 配宿主 cancel,\n * 链路自洽;「只换 rAF 不换 cancel」的沙箱 frameId 会失配,属该沙箱自身缺陷;\n * - `mode: \"none\"` 不安装(语义 B「显式关全部适配」,与 config.ts 纪律一致),\n * 该拓扑下若仍存在时钟混用由应用自担;\n * - 哨兵仅在安装时测量一次;偏移在 iframe 创建即固定(timeOrigin 差),\n * 会话内恒定,无需复测。\n */\n\n/** 哨兵漂移阈值(ms):正常环境 rAF ts 与 performance.now() 同帧差 ≤1 帧(~16ms),留 6 帧余量 */\nexport const RAF_DRIFT_THRESHOLD_MS = 100;\n\n/** 守卫裁决结果句柄 */\nexport interface RafClockGuardHandle {\n /** 哨兵是否命中(安装归一化);裁决前为 false */\n readonly installed: boolean;\n /** 哨兵测量值 |ts − performance.now()|(ms);裁决前为 NaN */\n readonly driftMs: number;\n /** 还原全局 rAF 引用(测试/热更新用);in-flight 已排队回调仍经包装放行 */\n restore(): void;\n}\n\n/** 守卫所需的最小 window 结构(DI 入参,测试用假窗口即可满足) */\nexport interface ClockWindow {\n requestAnimationFrame: (cb: (ts: number) => void) => number;\n performance: { now(): number };\n}\n\n/** 全局幂等标记:Symbol.for 注册表键,抗 HMR 模块重载(同键恒等) */\nconst GUARD_FLAG = Symbol.for(\"tu-design.raf-clock-guard\");\n\ntype FlaggedClockWindow = ClockWindow & Record<PropertyKey, unknown>;\n\nconst NOOP_HANDLE: RafClockGuardHandle = Object.freeze({\n installed: false,\n driftMs: Number.NaN,\n restore: () => {},\n});\n\n/**\n * 安装 rAF 时钟守卫(幂等;同步包装、异步哨兵裁决)。\n *\n * 接线点:TuDesignProvider / ToastProvider setup 顶层(mode=\"none\" 跳过)。\n * 任意环境可安全调用——干净时间线首帧即自恢复,零残留。\n *\n * @param win 宿主窗口(DI 入参;缺省全局 window,SSR 环境返回 no-op)\n * @returns 哨兵裁决后的句柄(幂等重入时返回已存在句柄的裁决)\n */\nexport function ensureRafClockGuard(win?: ClockWindow): Promise<RafClockGuardHandle> {\n const target: ClockWindow | undefined =\n win ?? (typeof window !== \"undefined\" ? window : undefined);\n // SSR / 非浏览器环境:无时钟可守\n if (!target) return Promise.resolve(NOOP_HANDLE);\n\n const w = target as FlaggedClockWindow;\n const existing = w[GUARD_FLAG] as RafClockGuardHandle | undefined;\n if (existing) return Promise.resolve(existing);\n\n // 原引用必须先于 bind 捕获:restore() 要求还原到 === 相等的原始值\n const rawRef = w.requestAnimationFrame;\n const rawRaf = rawRef.bind(w);\n const perf = w.performance;\n\n let state: \"probing\" | \"armed\" | \"clean\" = \"probing\";\n let driftMs = Number.NaN;\n let resolveDecision!: (handle: RafClockGuardHandle) => void;\n\n const wrapper = (cb: (ts: number) => void): number => {\n return rawRaf((ts) => {\n if (state === \"probing\") {\n driftMs = Math.round(Math.abs(ts - perf.now()));\n state = driftMs >= RAF_DRIFT_THRESHOLD_MS ? \"armed\" : \"clean\";\n if (state === \"clean\") {\n // 干净时间线:恢复全局原引用(本包装仅剩 in-flight 排队回调,放行语义不变)\n w.requestAnimationFrame = rawRef;\n } else if (import.meta.env.DEV) {\n console.info(\n `[tu-design] 检测到 rAF 时间线漂移 ${driftMs}ms(沙箱 rAF/performance ` +\n \"时钟混用),已安装时钟归一化守卫,回调时间戳改传本地 performance.now()。\" +\n \"机制详注 overlay-shared/rafClock.ts(issue #6)。\",\n );\n }\n resolveDecision(handle);\n }\n // 裁决前原样放行(= 原生行为);武装后改传本地时钟;干净后原样\n cb(state === \"armed\" ? perf.now() : ts);\n });\n };\n\n const handle: RafClockGuardHandle = {\n get installed() {\n return state === \"armed\";\n },\n get driftMs() {\n return driftMs;\n },\n restore() {\n w.requestAnimationFrame = rawRef;\n },\n };\n\n // 同步注册幂等标记(先于任何 await,双调用零窗口)\n w[GUARD_FLAG] = handle;\n // 同步包装全局引用:此后所有 rAF 消费方(zag Timer 等)经守卫解析\n w.requestAnimationFrame = wrapper;\n // 主动排一帧哨兵:裁决在首个真实消费计时器之前完成(~16ms)\n wrapper(() => {});\n\n return new Promise<RafClockGuardHandle>((resolve) => {\n resolveDecision = resolve;\n });\n}\n"
|
|
13
19
|
},
|
|
14
20
|
{
|
|
15
21
|
"path": "overlay-shared/sandbox.ts",
|
|
@@ -35,6 +41,12 @@
|
|
|
35
41
|
"target": "components/ui/overlay-shared/useOverlayIds.ts",
|
|
36
42
|
"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"
|
|
37
43
|
},
|
|
44
|
+
{
|
|
45
|
+
"path": "overlay-shared/useOverlayScrollLock.ts",
|
|
46
|
+
"type": "registry:lib",
|
|
47
|
+
"target": "components/ui/overlay-shared/useOverlayScrollLock.ts",
|
|
48
|
+
"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"
|
|
49
|
+
},
|
|
38
50
|
{
|
|
39
51
|
"path": "overlay-shared/useSandboxOverlay.ts",
|
|
40
52
|
"type": "registry:lib",
|
|
@@ -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.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "密码输入框:内置明文/掩码切换按钮(Eye/EyeOff,带 aria 语义),值与可见性均支持 v-model 受控。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "pin-input",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "多格验证码输入:length 指定格数,支持 otp/mask/字符类型、焦点自动跳格与填满回调,可选分隔符插槽。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "popconfirm",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
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"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "popover",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "气泡弹层:基于 Ark UI Popover 原语的单组件,默认插槽为触发元素本体(asChild 语义),面板内容放 #content 插槽,受控/非受控开关。",
|
|
7
7
|
"registryDependencies": ["utils", "overlay-shared"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "provider",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.13",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "应用根组件(可选):mode 显式声明微前端渲染环境(覆盖浮层沙箱自动探测),:toast 聚合消息提示宿主;不使用时一切行为与自动探测一致。",
|
|
7
7
|
"registryDependencies": ["overlay-shared", "toast"],
|
|
@@ -10,7 +10,7 @@
|
|
|
10
10
|
"path": "provider/TuDesignProvider.vue",
|
|
11
11
|
"type": "registry:component",
|
|
12
12
|
"target": "components/ui/provider/TuDesignProvider.vue",
|
|
13
|
-
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { provide } from \"vue\";\nimport { TU_PROVIDER_KEY } from \"../overlay-shared/config\";\nimport type { 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 *\n *
|
|
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 { ensureRafClockGuard } from \"../overlay-shared/rafClock\";\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 * 4. rAF 时钟守卫(无 prop,哨兵自动):沙箱时钟混用家族修复(issue #6,\n * 机制详注 overlay-shared/rafClock.ts);mode=\"none\" 显式关闭,其余 mode\n * 哨兵命中才安装(幂等,干净环境首帧自恢复零残留)。\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// rAF 时钟守卫(setup 顶层同步安装,零空窗——toast/clipboard 等 zag rAF 计时\n// 全部发生在用户交互,恒晚于根挂载):mode=\"none\" 显式关闭,其余哨兵门控\nif (props.mode !== \"none\") void ensureRafClockGuard();\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
14
|
},
|
|
15
15
|
{
|
|
16
16
|
"path": "provider/index.ts",
|