@tu-design/vue 0.5.11 → 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.
- package/dist/index.d.mts +45 -27
- package/dist/index.mjs +74 -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 +8 -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 +1 -1
- 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": "drawer",
|
|
4
|
-
"version": "0.5.
|
|
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"],
|
|
@@ -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.12",
|
|
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.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.
|
|
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"],
|
|
@@ -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.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": "month-picker",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.12",
|
|
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.12",
|
|
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.12",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "弹层家族共享逻辑:受控开合桥接(useControlledBoolean)与确认 pending 语义(useConfirmPending)。",
|
|
7
7
|
"files": [
|
|
@@ -9,7 +9,7 @@
|
|
|
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
13
|
},
|
|
14
14
|
{
|
|
15
15
|
"path": "overlay-shared/sandbox.ts",
|
|
@@ -35,6 +35,12 @@
|
|
|
35
35
|
"target": "components/ui/overlay-shared/useOverlayIds.ts",
|
|
36
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"
|
|
37
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
|
+
},
|
|
38
44
|
{
|
|
39
45
|
"path": "overlay-shared/useSandboxOverlay.ts",
|
|
40
46
|
"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.12",
|
|
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.12",
|
|
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.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"],
|
|
@@ -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.12",
|
|
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.12",
|
|
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 { 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
14
|
},
|
|
15
15
|
{
|
|
16
16
|
"path": "provider/index.ts",
|