@tu-design/vue 0.5.1 → 0.5.3

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 (56) hide show
  1. package/dist/index.d.mts +398 -101
  2. package/dist/index.mjs +524 -179
  3. package/dist/registry/vue/alert-dialog.json +1 -1
  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 +1 -1
  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 +1 -1
  10. package/dist/registry/vue/card.json +1 -1
  11. package/dist/registry/vue/cascader.json +1 -1
  12. package/dist/registry/vue/checkbox.json +1 -1
  13. package/dist/registry/vue/context-menu.json +1 -1
  14. package/dist/registry/vue/currency-input.json +1 -1
  15. package/dist/registry/vue/date-picker.json +1 -1
  16. package/dist/registry/vue/date-range-picker.json +1 -1
  17. package/dist/registry/vue/date-shared.json +1 -1
  18. package/dist/registry/vue/dialog.json +1 -1
  19. package/dist/registry/vue/drawer.json +1 -1
  20. package/dist/registry/vue/dropdown-menu.json +1 -1
  21. package/dist/registry/vue/empty.json +1 -1
  22. package/dist/registry/vue/form-render.json +6 -6
  23. package/dist/registry/vue/form.json +1 -1
  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 +1 -1
  28. package/dist/registry/vue/number-input.json +1 -1
  29. package/dist/registry/vue/overlay-shared.json +7 -1
  30. package/dist/registry/vue/password-input.json +1 -1
  31. package/dist/registry/vue/pin-input.json +1 -1
  32. package/dist/registry/vue/popconfirm.json +1 -1
  33. package/dist/registry/vue/popover.json +2 -2
  34. package/dist/registry/vue/progress.json +1 -1
  35. package/dist/registry/vue/radio-group.json +1 -1
  36. package/dist/registry/vue/registry.json +52 -52
  37. package/dist/registry/vue/select.json +1 -1
  38. package/dist/registry/vue/separator.json +1 -1
  39. package/dist/registry/vue/skeleton.json +1 -1
  40. package/dist/registry/vue/slider.json +1 -1
  41. package/dist/registry/vue/slot.json +1 -1
  42. package/dist/registry/vue/spin.json +1 -1
  43. package/dist/registry/vue/switch.json +1 -1
  44. package/dist/registry/vue/table-render.json +4 -4
  45. package/dist/registry/vue/tabs.json +1 -1
  46. package/dist/registry/vue/textarea.json +1 -1
  47. package/dist/registry/vue/timeline.json +1 -1
  48. package/dist/registry/vue/toast.json +1 -1
  49. package/dist/registry/vue/tokens.json +1 -1
  50. package/dist/registry/vue/tooltip.json +1 -1
  51. package/dist/registry/vue/tree-select.json +1 -1
  52. package/dist/registry/vue/tree-shared.json +1 -1
  53. package/dist/registry/vue/utils.json +1 -1
  54. package/dist/registry/vue/week-picker.json +1 -1
  55. package/dist/registry/vue/year-picker.json +1 -1
  56. 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": "alert-dialog",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "确认弹窗单组件:v-model:open 控制显隐,title/description 传文案,@confirm/@cancel 处理确认与取消;确认处理器返回 Promise 时按钮进入 loading 并锁定 ESC/遮罩关闭,resolve 自动关闭、reject 保持打开;内容节点为 role=alertdialog。",
7
7
  "registryDependencies": ["button", "utils", "overlay-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "alert",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "语义化警示条,支持五种变体、内置图标与可关闭交互。",
7
7
  "registryDependencies": ["icon-shared", "utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "avatar-group",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "头像组,数量折叠、悬停展开与垂直排列。",
7
7
  "registryDependencies": ["utils", "avatar"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "avatar",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "头像,支持尺寸/形状、加载占位与失败回退(Ark UI)。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "badge",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
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": "button",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "带变体与尺寸的按钮,支持 as 标签切换与 asChild 组合。",
7
7
  "registryDependencies": ["utils", "slot"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "calendar",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "日历(TCalendar):紧凑日历卡。Picker 弹层内为 embedded 内嵌形态(TDatePicker/TDateRangePicker 自动挂靠,纯卡片内核);独立使用即 standalone 独立形态(自带日历状态与 v-model,恒开展示)。",
7
7
  "registryDependencies": ["icon-shared", "utils", "date-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "card",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "卡片容器:单组件 API,title/description 头部 + 命名插槽(cover/action/footer/header),支持尺寸、视觉变体、分段分隔与可关闭。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "cascader",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "级联选择:一站式 props 驱动,多列联动、勾选级联、路径回显与多标签。",
7
7
  "registryDependencies": ["icon-shared", "tree-shared", "utils", "date-shared", "overlay-shared"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "checkbox",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "复选框:基于 Ark UI Checkbox 原语,支持标签插槽、受控/非受控与禁用。",
7
7
  "registryDependencies": ["utils"],
@@ -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.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "右键菜单:单组件模式,items 描述菜单项(与 dropdown-menu 同构,含分组/标题/分隔线,支持嵌套),默认插槽为触发元素(ContextTrigger as-child,右键唤出并定位到指针处),内置键盘导航与选中回调。",
7
7
  "registryDependencies": ["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.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
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"],
@@ -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.1",
4
+ "version": "0.5.3",
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"],
@@ -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.1",
4
+ "version": "0.5.3",
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": "empty",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "配置驱动表单渲染器:defineForm 聚合 TanStack Form 实例与字段配置,柯里化 widget DSL 声明控件,Tailwind 栅格自适应布局,复用 Form 家族 aria 接线。",
7
7
  "registryDependencies": [
@@ -33,7 +33,7 @@
33
33
  "path": "form-render/FormRender.vue",
34
34
  "type": "registry:component",
35
35
  "target": "components/ui/form-render/FormRender.vue",
36
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport type {\n FormRenderDefinition,\n FormRenderFormApi,\n FormRenderItem,\n WidgetRenderReturn,\n} from \"./types\";\nimport { computed, provide, ref } from \"vue\";\nimport { Button } from \"@/components/ui/button\";\nimport { FORM_KEY } from \"@/components/ui/form/context\";\nimport { cn } from \"@/lib/utils\";\nimport FormRenderField from \"./FormRenderField.vue\";\nimport { widgetRenders } from \"./widgets\";\n\n// boolean flags 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false,\"缺省跟随 searchable\" 语义失效;Checkbox/Dialog 同款约定)\nconst props = defineProps({\n /** 聚合式(推荐):defineForm 返回的定义对象 */\n definition: { type: Object as PropType<FormRenderDefinition<any>> },\n /** 拆分式:与 <Form :form> 模式兼容(与 definition 二选一,definition 优先) */\n form: { type: Object as PropType<FormRenderFormApi> },\n items: { type: Array as PropType<FormRenderItem<any>[]> },\n searchable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n submitable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 缺省跟随 searchable */\n resetable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 缺省跟随 submitable */\n cancelable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n searchText: { type: String },\n submitText: { type: String },\n resetText: { type: String },\n /** 栅格最小列宽 px(auto-fill 自适应列数) */\n minWidth: { type: Number },\n});\n\nconst emit = defineEmits<{\n search: [];\n submit: [];\n reset: [];\n cancel: [];\n}>();\n\nconst instance = props.definition?.form ?? props.form;\nconst items = computed(() => props.definition?.items ?? props.items ?? []);\n\nif (import.meta.env.DEV && !instance) {\n console.warn(\n \"[tu-design] <FormRender> 需要 definition 或 form + items(definition/form 不支持运行时切换)\",\n );\n}\n\n// S2:FormField 依赖 inject(FORM_KEY),本组件替代 <Form> 的 provide 职责\nprovide(FORM_KEY, instance as never);\n\n// S1:form.state 非响应式,响应式 values 只能经 useSelector 订阅建立;\n// visible 过滤与 WidgetContext.values 一律消费它,渲染路径禁读 form.state.*\nconst valuesRef = instance\n ? instance.useSelector((s: any) => s.values)\n : ref<Record<string, unknown>>({});\n\nconst r = widgetRenders<any>();\n\nfunction widgetOf(item: FormRenderItem<any>): WidgetRenderReturn<any> {\n return item.render ? item.render(r) : r.input();\n}\n\nconst visibleItems = computed(() =>\n items.value.filter((item) =>\n typeof item.visible === \"function\"\n ? item.visible(valuesRef.value as never)\n : item.visible !== false,\n ),\n);\n\nconst gridStyle = computed(() => ({\n gridTemplateColumns: `repeat(auto-fill, minmax(${props.minWidth ?? 320}px, 1fr))`,\n}));\n\nfunction spanStyle(span?: number | \"full\") {\n if (span === \"full\") return { gridColumn: \"1 / -1\" };\n if (typeof span === \"number\") return { gridColumn: `span ${span}` };\n return undefined;\n}\n\nconst showReset = computed(() => props.resetable ?? !!props.searchable);\nconst showCancel = computed(() => props.cancelable ?? !!props.submitable);\nconst showActions = computed(\n () => props.searchable || props.submitable || showReset.value || showCancel.value,\n);\n\n/** I4:校验失败时 isFieldsValid=false,不 emit;成功后才 emit(事件回调中一次性读取不受 S1 限制) */\nasync function submit(mode: \"search\" | \"submit\") {\n if (!instance) return;\n await instance.handleSubmit();\n if (instance.state.isFieldsValid) {\n if (mode === \"search\") emit(\"search\");\n else emit(\"submit\");\n }\n}\n\nfunction onReset() {\n if (props.definition) {\n props.definition.resetToDefaults();\n } else {\n instance?.reset();\n }\n emit(\"reset\");\n}\n\ndefineExpose({\n form: instance,\n items,\n resetToDefaults: () =>\n props.definition ? props.definition.resetToDefaults() : instance?.reset(),\n});\n</script>\n\n<template>\n <div :class=\"cn('grid gap-4', $attrs.class)\" :style=\"gridStyle\">\n <div v-for=\"item in visibleItems\" :key=\"String(item.key)\" :style=\"spanStyle(item.span)\">\n <FormRenderField :item=\"item\" :widget=\"widgetOf(item)\" :values=\"valuesRef\" />\n </div>\n <div v-if=\"showActions\" class=\"col-span-full flex justify-end gap-2\">\n <slot name=\"actions\">\n <Button v-if=\"searchable\" @click=\"submit('search')\">\n {{ searchText ?? \"搜索\" }}\n </Button>\n <Button v-if=\"showReset\" variant=\"outline\" @click=\"onReset\">\n {{ resetText ?? \"重置\" }}\n </Button>\n <Button v-if=\"submitable\" @click=\"submit('submit')\">\n {{ submitText ?? \"提交\" }}\n </Button>\n <Button v-if=\"showCancel\" variant=\"outline\" @click=\"emit('cancel')\"> 取消 </Button>\n </slot>\n </div>\n </div>\n</template>\n"
36
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport type {\n FormRenderDefinition,\n FormRenderFormApi,\n FormRenderItem,\n WidgetRenderReturn,\n} from \"./types\";\nimport { computed, provide, ref } from \"vue\";\nimport { Button } from \"@/components/ui/button\";\nimport { FORM_KEY } from \"@/components/ui/form/context\";\nimport { cn } from \"@/lib/utils\";\nimport FormRenderField from \"./FormRenderField.vue\";\nimport { widgetRenders } from \"./widgets\";\n\n// boolean flags 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false,\"缺省跟随 searchable\" 语义失效;Checkbox/Dialog 同款约定)\nconst props = defineProps({\n /** 聚合式(推荐):defineForm 返回的定义对象 */\n definition: { type: Object as PropType<FormRenderDefinition<any>> },\n /** 拆分式:与 <Form :form> 模式兼容(与 definition 二选一,definition 优先) */\n form: { type: Object as PropType<FormRenderFormApi> },\n items: { type: Array as PropType<FormRenderItem<any>[]> },\n searchable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n submitable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 缺省跟随 searchable */\n resetable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 缺省跟随 submitable */\n cancelable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n searchText: { type: String },\n submitText: { type: String },\n resetText: { type: String },\n /** 栅格最小列宽 px(auto-fill 自适应列数) */\n minWidth: { type: Number },\n});\n\nconst emit = defineEmits<{\n search: [];\n submit: [];\n reset: [];\n cancel: [];\n}>();\n\nconst instance = props.definition?.form ?? props.form;\nconst items = computed(() => props.definition?.items ?? props.items ?? []);\n\nif (import.meta.env.DEV && !instance) {\n console.warn(\n \"[tu-design] <FormRender> 需要 definition 或 form + items(definition/form 不支持运行时切换)\",\n );\n}\n\n// S2:FormField 依赖 inject(FORM_KEY),本组件替代 <Form> 的 provide 职责\nprovide(FORM_KEY, instance as never);\n\n// S1:form.state 非响应式,响应式 values 只能经 useSelector 订阅建立;\n// visible 过滤与 WidgetContext.values 一律消费它,渲染路径禁读 form.state.*\nconst valuesRef = instance\n ? instance.useSelector((s: any) => s.values)\n : ref<Record<string, unknown>>({});\n\nconst r = widgetRenders<any>();\n\nfunction widgetOf(item: FormRenderItem<any>): WidgetRenderReturn<any> {\n return item.render ? item.render(r) : r.input();\n}\n\nconst visibleItems = computed(() =>\n items.value.filter((item) =>\n typeof item.visible === \"function\"\n ? item.visible(valuesRef.value as never)\n : item.visible !== false,\n ),\n);\n\nconst gridStyle = computed(() => ({\n gridTemplateColumns: `repeat(auto-fill, minmax(${props.minWidth ?? 320}px, 1fr))`,\n}));\n\nfunction spanStyle(span?: number | \"full\") {\n if (span === \"full\") return { gridColumn: \"1 / -1\" };\n if (typeof span === \"number\") return { gridColumn: `span ${span}` };\n return undefined;\n}\n\n// ---- 按钮解析(A1 块级互斥):definition.actions 存在 → 七项全量 actions 域解析,props 域不参与;\n// actions 未配置 → 现状 props 域解析(含缺省跟随),行为逐字节不变\nconst actions = props.definition?.actions;\nconst searchable = computed(() => (actions ? actions.searchable : props.searchable) ?? false);\nconst submitable = computed(() => (actions ? actions.submitable : props.submitable) ?? false);\nconst showReset = computed(\n () => (actions ? actions.resetable : props.resetable) ?? !!searchable.value,\n);\nconst showCancel = computed(\n () => (actions ? actions.cancelable : props.cancelable) ?? !!submitable.value,\n);\nconst showActions = computed(\n () => searchable.value || submitable.value || showReset.value || showCancel.value,\n);\nconst resolvedSearchText = computed(\n () => (actions ? actions.searchText : props.searchText) ?? \"搜索\",\n);\nconst resolvedSubmitText = computed(\n () => (actions ? actions.submitText : props.submitText) ?? \"提交\",\n);\nconst resolvedResetText = computed(() => (actions ? actions.resetText : props.resetText) ?? \"重置\");\n\n// A6:actions 存在且显式传了任一按钮 prop → definition 优先,DEV 警告一次\n// (actions 存在 + props 全缺省是正常用法——如 TableRender 内置区经条件传递不传 searchable——不告警)\nif (import.meta.env.DEV && actions) {\n const provided =\n props.searchable !== undefined ||\n props.submitable !== undefined ||\n props.resetable !== undefined ||\n props.cancelable !== undefined ||\n props.searchText !== undefined ||\n props.submitText !== undefined ||\n props.resetText !== undefined;\n if (provided) {\n console.warn(\n \"[tu-design] <FormRender> definition.actions 与按钮 props 同传,已按 actions 渲染。\",\n );\n }\n}\n\n/** I4:校验失败时 isFieldsValid=false,不 emit;成功后才 emit(事件回调中一次性读取不受 S1 限制)。\n * 校验语义单点化(R30):definition 存在时复用 definition.submit();拆分式 :form + :items 走内联逻辑 */\nasync function submit(mode: \"search\" | \"submit\") {\n if (!instance) return;\n let valid: boolean;\n if (props.definition) {\n valid = await props.definition.submit();\n } else {\n await instance.handleSubmit();\n valid = instance.state.isFieldsValid;\n }\n if (!valid) return;\n if (mode === \"search\") emit(\"search\");\n else emit(\"submit\");\n}\n\nfunction onReset() {\n if (props.definition) {\n props.definition.resetToDefaults();\n } else {\n instance?.reset();\n }\n emit(\"reset\");\n}\n\ndefineExpose({\n form: instance,\n items,\n resetToDefaults: () =>\n props.definition ? props.definition.resetToDefaults() : instance?.reset(),\n});\n</script>\n\n<template>\n <div :class=\"cn('grid gap-4', $attrs.class)\" :style=\"gridStyle\">\n <div v-for=\"item in visibleItems\" :key=\"String(item.key)\" :style=\"spanStyle(item.span)\">\n <FormRenderField :item=\"item\" :widget=\"widgetOf(item)\" :values=\"valuesRef\" />\n </div>\n <div v-if=\"showActions\" class=\"col-span-full flex justify-end gap-2\">\n <slot name=\"actions\">\n <Button v-if=\"searchable\" @click=\"submit('search')\">\n {{ resolvedSearchText }}\n </Button>\n <Button v-if=\"showReset\" variant=\"outline\" @click=\"onReset\">\n {{ resolvedResetText }}\n </Button>\n <Button v-if=\"submitable\" @click=\"submit('submit')\">\n {{ resolvedSubmitText }}\n </Button>\n <Button v-if=\"showCancel\" variant=\"outline\" @click=\"emit('cancel')\"> 取消 </Button>\n </slot>\n </div>\n </div>\n</template>\n"
37
37
  },
38
38
  {
39
39
  "path": "form-render/FormRenderField.vue",
@@ -45,25 +45,25 @@
45
45
  "path": "form-render/define-form.ts",
46
46
  "type": "registry:lib",
47
47
  "target": "components/ui/form-render/define-form.ts",
48
- "content": "import { useFormRender, type UseFormRenderOptions } from \"./useFormRender\";\nimport type { FormRenderDefinition, FormRenderItem } from \"./types\";\n\nexport interface DefineFormOptions<T extends object> {\n items: FormRenderItem<T>[];\n /** Standard Schema(valibot v.object 输出直接兼容),映射到 TanStack validators.onSubmit */\n schema?: unknown;\n onSubmit?: (ctx: { value: T }) => void | Promise<void>;\n /** 其余 TanStack useForm 选项透传(如 onSubmitInvalid) */\n formOptions?: Record<string, unknown>;\n}\n\n/**\n * 聚合入口:单次调用完成「字段定义 + 类型约束 + 表单实例」。\n *\n * 返回 `{ items, form, resetToDefaults }`:\n * - `items` / `form` 传给 `<FormRender>`(支持 `:definition` 单 prop 或 `:form` + `:items` 拆分);\n * - `form` 可直接 `reset()` / `validate()` / `handleSubmit()`;\n * - `resetToDefaults()` 重置到 `items.default`(搜索表单\"重置\"语义)。\n *\n * 须在组件 setup 中调用(TanStack useForm 约束)。\n */\nexport function defineForm<T extends object>(\n config: DefineFormOptions<T>,\n): FormRenderDefinition<T> {\n return useFormRender<T>(config satisfies UseFormRenderOptions<T>);\n}\n"
48
+ "content": "import { useFormRender, type UseFormRenderOptions } from \"./useFormRender\";\nimport type { FormRenderDefinition, FormRenderItem } from \"./types\";\n\nexport interface DefineFormOptions<T extends object> {\n items: FormRenderItem<T>[];\n /** Standard Schema(valibot v.object 输出直接兼容),映射到 TanStack validators.onSubmit */\n schema?: unknown;\n onSubmit?: (ctx: { value: T }) => void | Promise<void>;\n /** 按钮预设七项(A1 块级互斥):显式传任一项即投影为 definition.actions,组件按钮 props 全量忽略 */\n searchable?: boolean;\n submitable?: boolean;\n resetable?: boolean;\n cancelable?: boolean;\n searchText?: string;\n submitText?: string;\n resetText?: string;\n /** 其余 TanStack useForm 选项透传(如 onSubmitInvalid) */\n formOptions?: Record<string, unknown>;\n}\n\n/**\n * 聚合入口:单次调用完成「字段定义 + 类型约束 + 表单实例 + 按钮预设」。\n *\n * 返回 `{ items, form, resetToDefaults, submit, actions? }`:\n * - `items` / `form` 传给 `<FormRender>`(支持 `:definition` 单 prop 或 `:form` + `:items` 拆分);\n * - `form` 可直接 `reset()` / `validate()` / `handleSubmit()`;\n * - `resetToDefaults()` 重置到 `items.default`(搜索表单\"重置\"语义);\n * - `submit()` 全量校验并返回是否通过(R30,组合式查询链路);\n * - `actions` 按钮预设(searchable 等七项直传):存在时 `<FormRender>` 组件按钮 props 全量忽略(A1 块级互斥)。\n *\n * 须在组件 setup 中调用(TanStack useForm 约束)。\n */\nexport function defineForm<T extends object>(\n config: DefineFormOptions<T>,\n): FormRenderDefinition<T> {\n return useFormRender<T>(config satisfies UseFormRenderOptions<T>);\n}\n"
49
49
  },
50
50
  {
51
51
  "path": "form-render/index.ts",
52
52
  "type": "registry:lib",
53
53
  "target": "components/ui/form-render/index.ts",
54
- "content": "export { default as FormRender } from \"./FormRender.vue\";\nexport { defineForm, type DefineFormOptions } from \"./define-form\";\nexport { useFormRender, type UseFormRenderOptions } from \"./useFormRender\";\nexport { widgetRenders } from \"./widgets\";\nexport { bindField, CHECKED, MODEL_VALUE, SLIDER, VALUE, type BindingSpec } from \"./widgets/bind\";\nexport type {\n CheckboxWidgetOptions,\n CurrencyWidgetOptions,\n DatePickerWidgetOptions,\n DateRangeWidgetOptions,\n FormRenderDefinition,\n FormRenderFormApi,\n FormRenderItem,\n InputWidgetOptions,\n MonthPickerWidgetOptions,\n NumberWidgetOptions,\n PasswordWidgetOptions,\n RadioGroupWidgetOptions,\n SelectWidgetOptions,\n SfcOptions,\n SliderWidgetOptions,\n SwitchWidgetOptions,\n TextareaWidgetOptions,\n WidgetContext,\n WidgetItemOption,\n WidgetRenderReturn,\n WidgetRenders,\n YearPickerWidgetOptions,\n} from \"./types\";\n"
54
+ "content": "export { default as FormRender } from \"./FormRender.vue\";\nexport { defineForm, type DefineFormOptions } from \"./define-form\";\nexport { useFormRender, type UseFormRenderOptions } from \"./useFormRender\";\nexport { widgetRenders } from \"./widgets\";\nexport { bindField, CHECKED, MODEL_VALUE, SLIDER, VALUE, type BindingSpec } from \"./widgets/bind\";\nexport type {\n CheckboxWidgetOptions,\n CurrencyWidgetOptions,\n DatePickerWidgetOptions,\n DateRangeWidgetOptions,\n FormActionsConfig,\n FormRenderDefinition,\n FormRenderFormApi,\n FormRenderItem,\n InputWidgetOptions,\n MonthPickerWidgetOptions,\n NumberWidgetOptions,\n PasswordWidgetOptions,\n RadioGroupWidgetOptions,\n SelectWidgetOptions,\n SfcOptions,\n SliderWidgetOptions,\n SwitchWidgetOptions,\n TextareaWidgetOptions,\n WidgetContext,\n WidgetItemOption,\n WidgetRenderReturn,\n WidgetRenders,\n YearPickerWidgetOptions,\n} from \"./types\";\n"
55
55
  },
56
56
  {
57
57
  "path": "form-render/types.ts",
58
58
  "type": "registry:lib",
59
59
  "target": "components/ui/form-render/types.ts",
60
- "content": "import type { AnyFieldApi, FormApi, VueFormApi } from \"@tanstack/vue-form\";\nimport type { VNode } from \"vue\";\nimport type { Checkbox } from \"@/components/ui/checkbox\";\nimport type { CurrencyInput } from \"@/components/ui/currency-input\";\nimport type { DatePicker } from \"@/components/ui/date-picker\";\nimport type { DateRangePicker } from \"@/components/ui/date-range-picker\";\nimport type { Input } from \"@/components/ui/input\";\nimport type { MonthPicker } from \"@/components/ui/month-picker\";\nimport type { WeekPicker } from \"@/components/ui/week-picker\";\nimport type { NumberInput } from \"@/components/ui/number-input\";\nimport type { PasswordInput } from \"@/components/ui/password-input\";\nimport type { RadioGroup } from \"@/components/ui/radio-group\";\nimport type { Cascader } from \"@/components/ui/cascader\";\nimport type { TreeSelect } from \"@/components/ui/tree-select\";\nimport type { Select } from \"@/components/ui/select\";\nimport type { Slider } from \"@/components/ui/slider\";\nimport type { Switch } from \"@/components/ui/switch\";\nimport type { Textarea } from \"@/components/ui/textarea\";\nimport type { YearPicker } from \"@/components/ui/year-picker\";\nimport type { SelectItemOption } from \"@/components/ui/select\";\n\n/**\n * useForm() 返回实例的宽松形态(与 form/context.ts 的 FormInstance 同款契约:\n * provide/inject 与跨组件边界会擦除泛型,any 化是项目既定约定)。\n */\n/* prettier-ignore */\nexport type FormRenderFormApi =\n FormApi<any, any, any, any, any, any, any, any, any, any, any, any> &\n VueFormApi<any, any, any, any, any, any, any, any, any, any, any, any>;\n\n/** 字段渲染上下文(widget 柯里化第二段的唯一参数) */\nexport interface WidgetContext<T extends object> {\n field: AnyFieldApi;\n item: FormRenderItem<T>;\n /** 当前全量表单值(响应式,来自 form.useSelector(s => s.values);联动用) */\n values: T;\n}\n\nexport type WidgetRenderReturn<T extends object> = (ctx: WidgetContext<T>) => VNode;\n\n/** select/radioGroup 等选项的通用形态(字符串简写或 { label, value }) */\nexport type WidgetItemOption = string | SelectItemOption;\n\n/**\n * SFC props 类型派生(方案 C):widget 参数 = 原组件全部 props(命名穿透,\n * prop 变更时类型自动同步)。受控字段由 bindField/FormControl/items.default\n * 接管,用户不可传;Omit 不存在的键是 no-op,统一集合即可。\n */\ntype ControlledKey =\n | \"modelValue\"\n | \"onUpdate:modelValue\"\n | \"checked\"\n | \"onUpdate:checked\"\n | \"value\"\n | \"onUpdate:value\"\n | \"onBlur\"\n | \"invalid\"\n | \"class\"\n | \"id\"\n | \"defaultValue\"\n | \"defaultChecked\";\n\nexport type SfcOptions<T extends abstract new (...args: any) => any> = Partial<\n Omit<InstanceType<T>[\"$props\"], ControlledKey>\n>;\n\n// —— 各 widget 选项:组件全 props 派生(命名穿透) ——\n\nexport type NumberWidgetOptions = SfcOptions<typeof NumberInput>;\n\nexport type CurrencyWidgetOptions = SfcOptions<typeof CurrencyInput>;\n\n/** autoComplete 为 PasswordInput 真实 prop(探针实证),直接派生获得 */\nexport type PasswordWidgetOptions = SfcOptions<typeof PasswordInput>;\n\n/** Input 自身无 placeholder/type prop(原生 attr 透传),交叉手写 */\nexport type InputWidgetOptions = SfcOptions<typeof Input> & {\n placeholder?: string;\n type?: string;\n};\n\n/** Textarea 自身无 placeholder/rows prop(原生 attr 透传),交叉手写 */\nexport type TextareaWidgetOptions = SfcOptions<typeof Textarea> & {\n placeholder?: string;\n rows?: number;\n};\n\n/**\n * v3 命名穿透:选项字段即组件 prop 名 `items`——显式必填(Partial 化会退化为可选,\n * 缺失时 Select.vue collection 计算在首渲染崩溃);placeholder 已是 Select 单组件\n * 的正式 prop,不再 Omit,渲染时做 item 级缺省回退(I1)。\n */\nexport type SelectWidgetOptions = Omit<SfcOptions<typeof Select>, \"items\"> & {\n items: WidgetItemOption[];\n};\n\nexport type CheckboxWidgetOptions = SfcOptions<typeof Checkbox>;\n\nexport type SwitchWidgetOptions = SfcOptions<typeof Switch>;\n\n/**\n * radioGroup widget:单选组(值 prop 为 value)。items 为组件 required prop,\n * 显式必填(Partial 化会退化为可选);选项字段与组件 prop 同名(命名穿透)。\n * 注意:RadioGroup 不支持 Select 的字符串简写(无 normalize 回退,直传即崩),\n * 此处收窄为 SelectItemOption[] 而非 WidgetItemOption[]。\n */\nexport type RadioGroupWidgetOptions = Omit<SfcOptions<typeof RadioGroup>, \"items\"> & {\n items: SelectItemOption[];\n};\n\n/** TreeSelect / Cascader:选项 prop 原名 options,受控走 modelValue(ControlledKey 自动剔除) */\nexport type TreeSelectWidgetOptions = SfcOptions<typeof TreeSelect>;\n\nexport type CascaderWidgetOptions = SfcOptions<typeof Cascader>;\n\nexport type SliderWidgetOptions = SfcOptions<typeof Slider>;\n\n/** picker 三组件 props 面不同(DatePicker 有 isDateUnavailable/max/min,Month/Year 有 locale),各自派生 */\nexport type DatePickerWidgetOptions = SfcOptions<typeof DatePicker>;\n\nexport type MonthPickerWidgetOptions = SfcOptions<typeof MonthPicker>;\n\nexport type YearPickerWidgetOptions = SfcOptions<typeof YearPicker>;\n\nexport type DateRangeWidgetOptions = SfcOptions<typeof DateRangePicker>;\n\nexport type WeekPickerWidgetOptions = SfcOptions<typeof WeekPicker>;\n\n/**\n * widget 注册表类型契约:实现对象在 widgets/index.ts。\n * 类型集中于此避免循环依赖(type-only import 无运行时环)。\n */\nexport interface WidgetRenders<T extends object> {\n input(o?: InputWidgetOptions): WidgetRenderReturn<T>;\n password(o?: PasswordWidgetOptions): WidgetRenderReturn<T>;\n number(o?: NumberWidgetOptions): WidgetRenderReturn<T>;\n currency(o?: CurrencyWidgetOptions): WidgetRenderReturn<T>;\n textarea(o?: TextareaWidgetOptions): WidgetRenderReturn<T>;\n select(o: SelectWidgetOptions): WidgetRenderReturn<T>;\n checkbox(o?: CheckboxWidgetOptions): WidgetRenderReturn<T>;\n switch(o?: SwitchWidgetOptions): WidgetRenderReturn<T>;\n radioGroup(o: RadioGroupWidgetOptions): WidgetRenderReturn<T>;\n treeSelect(o: TreeSelectWidgetOptions): WidgetRenderReturn<T>;\n cascader(o: CascaderWidgetOptions): WidgetRenderReturn<T>;\n slider(o?: SliderWidgetOptions): WidgetRenderReturn<T>;\n datePicker(o?: DatePickerWidgetOptions): WidgetRenderReturn<T>;\n monthPicker(o?: MonthPickerWidgetOptions): WidgetRenderReturn<T>;\n yearPicker(o?: YearPickerWidgetOptions): WidgetRenderReturn<T>;\n dateRangePicker(o?: DateRangeWidgetOptions): WidgetRenderReturn<T>;\n weekPicker(o?: WeekPickerWidgetOptions): WidgetRenderReturn<T>;\n /** 逃逸口:完全自定义渲染 */\n render(fn: (ctx: WidgetContext<T>) => VNode): WidgetRenderReturn<T>;\n}\n\nexport interface FormRenderItem<T extends object> {\n /**\n * 字段名:严格 keyof T —— 自动补全 + 拼错编译报错。\n * 额外字段请在 T 中显式声明;运行时以 String(key) 归一为 FormField 的 name。\n */\n key: keyof T;\n title: string;\n description?: string;\n placeholder?: string;\n /**\n * 默认值(值或同步工厂);defineForm 据此派生 defaultValues。\n * 类型为 T 值域联合 T[keyof T](无 per-item 精确联动,强于 x-render 的 any)。\n */\n default?: T[keyof T] | (() => T[keyof T]);\n /** 栅格跨度:数字 = 占 n 列(须 ≤ 实际列数);\"full\" = 整行 */\n span?: number | \"full\";\n /** 联动显隐;消费 FormRender 经 useSelector 建立的响应式 values */\n visible?: boolean | ((values: T) => boolean);\n hideLabel?: boolean;\n class?: string;\n /** TanStack 字段级校验器透传(如 onChangeAsync) */\n validators?: Record<string, unknown>;\n /** widget 描述;缺省 = r.input() */\n render?: (r: WidgetRenders<T>) => WidgetRenderReturn<T>;\n /** 逃逸口:原样合并到控件 vnode 的 props */\n componentProps?: Record<string, unknown>;\n}\n\nexport interface FormRenderDefinition<T extends object> {\n items: FormRenderItem<T>[];\n form: FormRenderFormApi;\n /** 重置到 items.default(搜索表单\"重置\"语义) */\n resetToDefaults: () => void;\n}\n"
60
+ "content": "import type { AnyFieldApi, FormApi, VueFormApi } from \"@tanstack/vue-form\";\nimport type { VNode } from \"vue\";\nimport type { Checkbox } from \"@/components/ui/checkbox\";\nimport type { CurrencyInput } from \"@/components/ui/currency-input\";\nimport type { DatePicker } from \"@/components/ui/date-picker\";\nimport type { DateRangePicker } from \"@/components/ui/date-range-picker\";\nimport type { Input } from \"@/components/ui/input\";\nimport type { MonthPicker } from \"@/components/ui/month-picker\";\nimport type { WeekPicker } from \"@/components/ui/week-picker\";\nimport type { NumberInput } from \"@/components/ui/number-input\";\nimport type { PasswordInput } from \"@/components/ui/password-input\";\nimport type { RadioGroup } from \"@/components/ui/radio-group\";\nimport type { Cascader } from \"@/components/ui/cascader\";\nimport type { TreeSelect } from \"@/components/ui/tree-select\";\nimport type { Select } from \"@/components/ui/select\";\nimport type { Slider } from \"@/components/ui/slider\";\nimport type { Switch } from \"@/components/ui/switch\";\nimport type { Textarea } from \"@/components/ui/textarea\";\nimport type { YearPicker } from \"@/components/ui/year-picker\";\nimport type { SelectItemOption } from \"@/components/ui/select\";\n\n/**\n * useForm() 返回实例的宽松形态(与 form/context.ts 的 FormInstance 同款契约:\n * provide/inject 与跨组件边界会擦除泛型,any 化是项目既定约定)。\n */\n/* prettier-ignore */\nexport type FormRenderFormApi =\n FormApi<any, any, any, any, any, any, any, any, any, any, any, any> &\n VueFormApi<any, any, any, any, any, any, any, any, any, any, any, any>;\n\n/** 字段渲染上下文(widget 柯里化第二段的唯一参数) */\nexport interface WidgetContext<T extends object> {\n field: AnyFieldApi;\n item: FormRenderItem<T>;\n /** 当前全量表单值(响应式,来自 form.useSelector(s => s.values);联动用) */\n values: T;\n}\n\nexport type WidgetRenderReturn<T extends object> = (ctx: WidgetContext<T>) => VNode;\n\n/** select/radioGroup 等选项的通用形态(字符串简写或 { label, value }) */\nexport type WidgetItemOption = string | SelectItemOption;\n\n/**\n * SFC props 类型派生(方案 C):widget 参数 = 原组件全部 props(命名穿透,\n * prop 变更时类型自动同步)。受控字段由 bindField/FormControl/items.default\n * 接管,用户不可传;Omit 不存在的键是 no-op,统一集合即可。\n */\ntype ControlledKey =\n | \"modelValue\"\n | \"onUpdate:modelValue\"\n | \"checked\"\n | \"onUpdate:checked\"\n | \"value\"\n | \"onUpdate:value\"\n | \"onBlur\"\n | \"invalid\"\n | \"class\"\n | \"id\"\n | \"defaultValue\"\n | \"defaultChecked\";\n\nexport type SfcOptions<T extends abstract new (...args: any) => any> = Partial<\n Omit<InstanceType<T>[\"$props\"], ControlledKey>\n>;\n\n// —— 各 widget 选项:组件全 props 派生(命名穿透) ——\n\nexport type NumberWidgetOptions = SfcOptions<typeof NumberInput>;\n\nexport type CurrencyWidgetOptions = SfcOptions<typeof CurrencyInput>;\n\n/** autoComplete 为 PasswordInput 真实 prop(探针实证),直接派生获得 */\nexport type PasswordWidgetOptions = SfcOptions<typeof PasswordInput>;\n\n/** Input 自身无 placeholder/type prop(原生 attr 透传),交叉手写 */\nexport type InputWidgetOptions = SfcOptions<typeof Input> & {\n placeholder?: string;\n type?: string;\n};\n\n/** Textarea 自身无 placeholder/rows prop(原生 attr 透传),交叉手写 */\nexport type TextareaWidgetOptions = SfcOptions<typeof Textarea> & {\n placeholder?: string;\n rows?: number;\n};\n\n/**\n * v3 命名穿透:选项字段即组件 prop 名 `items`——显式必填(Partial 化会退化为可选,\n * 缺失时 Select.vue collection 计算在首渲染崩溃);placeholder 已是 Select 单组件\n * 的正式 prop,不再 Omit,渲染时做 item 级缺省回退(I1)。\n */\nexport type SelectWidgetOptions = Omit<SfcOptions<typeof Select>, \"items\"> & {\n items: WidgetItemOption[];\n};\n\nexport type CheckboxWidgetOptions = SfcOptions<typeof Checkbox>;\n\nexport type SwitchWidgetOptions = SfcOptions<typeof Switch>;\n\n/**\n * radioGroup widget:单选组(值 prop 为 value)。items 为组件 required prop,\n * 显式必填(Partial 化会退化为可选);选项字段与组件 prop 同名(命名穿透)。\n * 注意:RadioGroup 不支持 Select 的字符串简写(无 normalize 回退,直传即崩),\n * 此处收窄为 SelectItemOption[] 而非 WidgetItemOption[]。\n */\nexport type RadioGroupWidgetOptions = Omit<SfcOptions<typeof RadioGroup>, \"items\"> & {\n items: SelectItemOption[];\n};\n\n/** TreeSelect / Cascader:选项 prop 原名 options,受控走 modelValue(ControlledKey 自动剔除) */\nexport type TreeSelectWidgetOptions = SfcOptions<typeof TreeSelect>;\n\nexport type CascaderWidgetOptions = SfcOptions<typeof Cascader>;\n\nexport type SliderWidgetOptions = SfcOptions<typeof Slider>;\n\n/** picker 三组件 props 面不同(DatePicker 有 isDateUnavailable/max/min,Month/Year 有 locale),各自派生 */\nexport type DatePickerWidgetOptions = SfcOptions<typeof DatePicker>;\n\nexport type MonthPickerWidgetOptions = SfcOptions<typeof MonthPicker>;\n\nexport type YearPickerWidgetOptions = SfcOptions<typeof YearPicker>;\n\nexport type DateRangeWidgetOptions = SfcOptions<typeof DateRangePicker>;\n\nexport type WeekPickerWidgetOptions = SfcOptions<typeof WeekPicker>;\n\n/**\n * widget 注册表类型契约:实现对象在 widgets/index.ts。\n * 类型集中于此避免循环依赖(type-only import 无运行时环)。\n */\nexport interface WidgetRenders<T extends object> {\n input(o?: InputWidgetOptions): WidgetRenderReturn<T>;\n password(o?: PasswordWidgetOptions): WidgetRenderReturn<T>;\n number(o?: NumberWidgetOptions): WidgetRenderReturn<T>;\n currency(o?: CurrencyWidgetOptions): WidgetRenderReturn<T>;\n textarea(o?: TextareaWidgetOptions): WidgetRenderReturn<T>;\n select(o: SelectWidgetOptions): WidgetRenderReturn<T>;\n checkbox(o?: CheckboxWidgetOptions): WidgetRenderReturn<T>;\n switch(o?: SwitchWidgetOptions): WidgetRenderReturn<T>;\n radioGroup(o: RadioGroupWidgetOptions): WidgetRenderReturn<T>;\n treeSelect(o: TreeSelectWidgetOptions): WidgetRenderReturn<T>;\n cascader(o: CascaderWidgetOptions): WidgetRenderReturn<T>;\n slider(o?: SliderWidgetOptions): WidgetRenderReturn<T>;\n datePicker(o?: DatePickerWidgetOptions): WidgetRenderReturn<T>;\n monthPicker(o?: MonthPickerWidgetOptions): WidgetRenderReturn<T>;\n yearPicker(o?: YearPickerWidgetOptions): WidgetRenderReturn<T>;\n dateRangePicker(o?: DateRangeWidgetOptions): WidgetRenderReturn<T>;\n weekPicker(o?: WeekPickerWidgetOptions): WidgetRenderReturn<T>;\n /** 逃逸口:完全自定义渲染 */\n render(fn: (ctx: WidgetContext<T>) => VNode): WidgetRenderReturn<T>;\n}\n\nexport interface FormRenderItem<T extends object> {\n /**\n * 字段名:严格 keyof T —— 自动补全 + 拼错编译报错。\n * 额外字段请在 T 中显式声明;运行时以 String(key) 归一为 FormField 的 name。\n */\n key: keyof T;\n title: string;\n description?: string;\n placeholder?: string;\n /**\n * 默认值(值或同步工厂);defineForm 据此派生 defaultValues。\n * 类型为 T 值域联合 T[keyof T](无 per-item 精确联动,强于 x-render 的 any)。\n */\n default?: T[keyof T] | (() => T[keyof T]);\n /** 栅格跨度:数字 = 占 n 列(须 ≤ 实际列数);\"full\" = 整行 */\n span?: number | \"full\";\n /** 联动显隐;消费 FormRender 经 useSelector 建立的响应式 values */\n visible?: boolean | ((values: T) => boolean);\n hideLabel?: boolean;\n class?: string;\n /** TanStack 字段级校验器透传(如 onChangeAsync) */\n validators?: Record<string, unknown>;\n /** widget 描述;缺省 = r.input() */\n render?: (r: WidgetRenders<T>) => WidgetRenderReturn<T>;\n /** 逃逸口:原样合并到控件 vnode 的 props */\n componentProps?: Record<string, unknown>;\n}\n\n/** 按钮预设(A1 块级互斥:actions 存在时 <FormRender> 组件按钮 props 全量忽略) */\nexport interface FormActionsConfig {\n /** 搜索按钮,缺省 false */\n searchable?: boolean;\n /** 提交按钮,缺省 false */\n submitable?: boolean;\n /** 重置按钮;缺省跟随 searchable(A2,域内解析) */\n resetable?: boolean;\n /** 取消按钮;缺省跟随 submitable(A2,域内解析) */\n cancelable?: boolean;\n searchText?: string;\n submitText?: string;\n resetText?: string;\n}\n\nexport interface FormRenderDefinition<T extends object> {\n items: FormRenderItem<T>[];\n form: FormRenderFormApi;\n /** 重置到 items.default(搜索表单\"重置\"语义) */\n resetToDefaults: () => void;\n /** 全量校验并返回是否通过(R30);不触发 FormRender 的 search/submit 事件。\n * 组合式外部查询标准链路:`if (await table.search.submit()) table.reload(true)` */\n submit: () => Promise<boolean>;\n /** 按钮预设投影(引擎从 options 七项直传;未配置为 undefined——此时组件按钮 props 全量生效) */\n actions?: FormActionsConfig;\n}\n"
61
61
  },
62
62
  {
63
63
  "path": "form-render/useFormRender.ts",
64
64
  "type": "registry:lib",
65
65
  "target": "components/ui/form-render/useFormRender.ts",
66
- "content": "import { useForm } from \"@tanstack/vue-form\";\nimport type { FormRenderDefinition, FormRenderItem } from \"./types\";\n\nexport interface UseFormRenderOptions<T extends object> {\n items: FormRenderItem<T>[];\n /** Standard Schema(valibot v.object 输出直接兼容),映射到 TanStack validators.onSubmit */\n schema?: unknown;\n onSubmit?: (ctx: { value: T }) => void | Promise<void>;\n /** 其余 TanStack useForm 选项透传(如 onSubmitInvalid) */\n formOptions?: Record<string, unknown>;\n}\n\n/**\n * 底层原语:包装 TanStack useForm(聚合入口 defineForm 内部也走这里)。\n *\n * - `defaultValues` 从 `items[].default` 派生(值或同步工厂,缺省 null)——单一真相源;\n * - 显式泛型 `useForm<T>`,保住 onSubmit `{ value: T }` 全链路推断;\n * - 须在组件 setup 中调用(TanStack useForm 内部 `onMounted(formApi.mount)`)。\n */\nexport function useFormRender<T extends object>(\n options: UseFormRenderOptions<T>,\n): FormRenderDefinition<T> {\n const { items, schema, onSubmit, formOptions } = options;\n\n const defaultValues = Object.fromEntries(\n items.map((item) => [\n String(item.key),\n typeof item.default === \"function\"\n ? (item.default as () => unknown)()\n : (item.default ?? null),\n ]),\n ) as T;\n\n // useForm 有 12 个必选泛型参数(validator 通道),validators 走 any 化宽松契约(同 context.ts FormInstance)\n const form = useForm<T, any, any, any, any, any, any, any, any, any, any, any>({\n defaultValues,\n // TanStack 默认在提交失败后 canSubmit=false 且 handleSubmit 被门控静默拦截,\n // 用户修正字段值后将永远无法再次提交(搜索表单致命)。\n // 放开门控:每次点击都执行完整校验流,失败走错误分发,成功才走 onSubmit。\n canSubmitWhenInvalid: true,\n ...(schema ? { validators: { onSubmit: schema } } : {}),\n ...(onSubmit ? { onSubmit: ({ value }) => onSubmit({ value }) } : {}),\n ...formOptions,\n });\n\n return { items, form, resetToDefaults: () => form.reset() };\n}\n"
66
+ "content": "import { useForm } from \"@tanstack/vue-form\";\nimport type { FormRenderDefinition, FormRenderItem } from \"./types\";\n\nexport interface UseFormRenderOptions<T extends object> {\n items: FormRenderItem<T>[];\n /** Standard Schema(valibot v.object 输出直接兼容),映射到 TanStack validators.onSubmit */\n schema?: unknown;\n onSubmit?: (ctx: { value: T }) => void | Promise<void>;\n /** 按钮预设七项(A1):显式传任一项即投影为 actions(definition 域,组件按钮 props 全量忽略) */\n searchable?: boolean;\n submitable?: boolean;\n resetable?: boolean;\n cancelable?: boolean;\n searchText?: string;\n submitText?: string;\n resetText?: string;\n /** 其余 TanStack useForm 选项透传(如 onSubmitInvalid) */\n formOptions?: Record<string, unknown>;\n}\n\n/**\n * 底层原语:包装 TanStack useForm(聚合入口 defineForm 内部也走这里)。\n *\n * - `defaultValues` 从 `items[].default` 派生(值或同步工厂,缺省 null)——单一真相源;\n * - 显式泛型 `useForm<T>`,保住 onSubmit `{ value: T }` 全链路推断;\n * - 须在组件 setup 中调用(TanStack useForm 内部 `onMounted(formApi.mount)`)。\n */\nexport function useFormRender<T extends object>(\n options: UseFormRenderOptions<T>,\n): FormRenderDefinition<T> {\n const {\n items,\n schema,\n onSubmit,\n formOptions,\n searchable,\n submitable,\n resetable,\n cancelable,\n searchText,\n submitText,\n resetText,\n } = options;\n\n // 按钮预设七项直传投影(A1 块级互斥的 definition 域;全 undefined = 未配置 → 组件 props 域生效)\n const actions =\n searchable === undefined &&\n submitable === undefined &&\n resetable === undefined &&\n cancelable === undefined &&\n searchText === undefined &&\n submitText === undefined &&\n resetText === undefined\n ? undefined\n : { searchable, submitable, resetable, cancelable, searchText, submitText, resetText };\n\n const defaultValues = Object.fromEntries(\n items.map((item) => [\n String(item.key),\n typeof item.default === \"function\"\n ? (item.default as () => unknown)()\n : (item.default ?? null),\n ]),\n ) as T;\n\n // useForm 有 12 个必选泛型参数(validator 通道),validators 走 any 化宽松契约(同 context.ts FormInstance)\n const form = useForm<T, any, any, any, any, any, any, any, any, any, any, any>({\n defaultValues,\n // TanStack 默认在提交失败后 canSubmit=false 且 handleSubmit 被门控静默拦截,\n // 用户修正字段值后将永远无法再次提交(搜索表单致命)。\n // 放开门控:每次点击都执行完整校验流,失败走错误分发,成功才走 onSubmit。\n canSubmitWhenInvalid: true,\n ...(schema ? { validators: { onSubmit: schema } } : {}),\n ...(onSubmit ? { onSubmit: ({ value }) => onSubmit({ value }) } : {}),\n ...formOptions,\n });\n\n return {\n items,\n form,\n resetToDefaults: () => form.reset(),\n // canSubmitWhenInvalid 已放开门控:每次 handleSubmit 都执行完整校验流(R30 校验语义单点化)\n submit: async () => {\n await form.handleSubmit();\n return form.state.isFieldsValid;\n },\n actions,\n };\n}\n"
67
67
  },
68
68
  {
69
69
  "path": "form-render/widgets/bind.ts",
@@ -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.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "内置功能性图标(CloseIcon/ChevronIcon/CalendarIcon),内部共享,非公共 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.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
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": "month-picker",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "数字输入框:内置加减步进按钮与数值边界,值以 number|null 受控(空值归一 null),支持 Intl 数字格式化。",
7
7
  "registryDependencies": ["utils"],
@@ -1,10 +1,16 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "overlay-shared",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "弹层家族共享逻辑:受控开合桥接(useControlledBoolean)与确认 pending 语义(useConfirmPending)。",
7
7
  "files": [
8
+ {
9
+ "path": "overlay-shared/sandbox.ts",
10
+ "type": "registry:lib",
11
+ "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/** 组件 JS 是否运行在 iframe realm(wujie / iframe 型沙箱 / 普通 iframe 嵌入) */\nexport function isInIframeRealm(): boolean {\n return typeof window !== \"undefined\" && window.self !== window.top;\n}\n\n/** 是否处于 wujie graft 沙箱(getRootNode/父链被 wujie patch 伪装,结构探测失效,\n * 依赖官方标记;wujie 在子应用脚本执行前注入,时序可靠) */\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
+ },
8
14
  {
9
15
  "path": "overlay-shared/useConfirmPending.ts",
10
16
  "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.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
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.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "气泡弹层:基于 Ark UI Popover 原语的单组件,默认插槽为触发元素本体(asChild 语义),面板内容放 #content 插槽,受控/非受控开关。",
7
7
  "registryDependencies": ["utils", "overlay-shared"],
@@ -11,7 +11,7 @@
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, useAttrs } from \"vue\";\nimport type { PopoverRootProps } from \"@ark-ui/vue/popover\";\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\n\n/** 面板相对触发器的对齐方向 */\ntype Align = \"start\" | \"center\" | \"end\";\n\n/** Ark Popover Root 的 positioning 配置(placement 含四方向 × 对齐组合) */\ntype ArkPositioning = NonNullable<PopoverRootProps[\"positioning\"]>;\ntype ArkPlacement = NonNullable<ArkPositioning[\"placement\"]>;\n\ndefineOptions({ inheritAttrs: false });\n\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次展开才挂载面板内容 */\n lazyMount: { type: Boolean, default: false },\n /** 收起时卸载面板内容 */\n unmountOnExit: { type: Boolean, default: false },\n /** 面板相对触发器的对齐方向(默认居中);attrs.positioning.placement 显式给出时以其为准 */\n align: { type: String as PropType<Align>, default: \"center\" },\n /** 追加/覆盖面板样式类(默认 w-72 可由此覆盖,如 \"w-56 p-0\") */\n contentClass: { type: String, default: undefined },\n /** 透传到面板根元素上的属性(id/style/data-* 等,class 请用 contentClass) */\n contentProps: { type: Object as PropType<Record<string, unknown>>, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\n// attrs(positioning/modal 等 Ark Root 属性)手动转发,便于与 align 合并出 positioning\nconst attrs = useAttrs();\n\n// —— 受控桥接(Dialog 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// align → Ark positioning.placement(横轴对齐,主轴默认 bottom 与 Ark 原语一致);\n// 外部经 attrs 传入的 positioning 已显式指定 placement 时以其为准,其余字段原样合并\nconst rootPositioning = computed<ArkPositioning>(() => {\n const user = (attrs.positioning ?? {}) as ArkPositioning;\n if (user.placement) return user;\n const placement = (props.align === \"center\" ? \"bottom\" : `bottom-${props.align}`) as ArkPlacement;\n return { ...user, placement };\n});\n\n// 面板样式:内置类 + contentClass + contentProps.class 三方合并(twMerge 自动去冲突,后者优先)\nconst contentClass = computed(() =>\n cn(\n \"bg-popover text-popover-foreground z-[var(--z-overlay)] w-72 rounded-md border p-4 shadow-md outline-none data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95\",\n props.contentClass,\n props.contentProps?.[\"class\"] as ClassValue,\n ),\n);\n</script>\n\n<template>\n <ArkPopover.Root\n v-bind=\"attrs\"\n :open=\"isOpen\"\n :positioning=\"rootPositioning\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <!-- 默认插槽即触发元素本体(asChild 语义合并到子元素,不额外包裹,原 PopoverTrigger 同款实现) -->\n <ArkPopover.Trigger as-child>\n <slot />\n </ArkPopover.Trigger>\n <ArkPopover.Positioner class=\"z-[var(--z-overlay)]\">\n <ArkPopover.Content v-bind=\"props.contentProps\" :class=\"contentClass\">\n <slot name=\"content\" />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </ArkPopover.Root>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { ClassValue } from \"clsx\";\nimport type { PropType } from \"vue\";\nimport {\n computed,\n getCurrentInstance,\n onBeforeUnmount,\n onMounted,\n ref,\n useAttrs,\n useId,\n useSlots,\n} 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 { isInIframeRealm, isInWujie } from \"../overlay-shared/sandbox\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\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// 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// 共享 Vue(__MICRO_SHARED__)下各子应用 app._container 相互独立,检测按实例隔离;\n// 沙箱两类:真 shadow DOM 由 getRootNode() 命中;wujie graft 下 getRootNode/父链\n// 被 patch 伪装成 iframe 文档语义(实测),结构探测失效,须叠加官方标记位。\n// 其余微前端(qiankun / micro-app light DOM)body 即主文档 body,兜底正确\nconst instance = getCurrentInstance();\nconst inWujie = isInWujie();\nconst detectedTarget = ref<string | HTMLElement>(\"body\");\nonMounted(() => {\n queueMicrotask(() => {\n if (props.to) 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});\nconst teleportTarget = computed<string | HTMLElement>(() => props.to ?? detectedTarget.value);\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.content 定死面板 id,保证 aria-controls 可靠指向\nconst contentId = useId();\nconst rootIds = computed<Record<string, string> | undefined>(() => {\n if (useNativeTrigger.value) return undefined;\n const user = (attrs.ids ?? {}) as Record<string, string>;\n return { ...user, content: contentId };\n});\nconst anchorAria = computed(() =>\n useNativeTrigger.value\n ? {}\n : {\n \"aria-haspopup\": \"dialog\" as const,\n \"aria-expanded\": isOpen.value,\n \"aria-controls\": contentId,\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(wujie graft / iframe 型沙箱 / iframe 嵌入)且未显式指定 strategy 时\n// 默认 fixed:非 graft 拓扑下 fixed 与 absolute 坐标等价(零副作用),graft 拓扑\n// (wujie)absolute 包含块错位,fixed 是唯一正确解 —— 详见 overlay-shared/sandbox.ts\nconst inIframeRealm = isInIframeRealm();\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 const merged: ArkPositioning = {\n ...user,\n placement,\n sameWidth: props.matchTriggerWidth || user.sameWidth,\n };\n if (inIframeRealm && user.strategy == null) {\n merged.strategy = \"fixed\";\n }\n return merged;\n});\n\n// 面板样式:内置类 + contentClass + contentProps.class 三方合并(twMerge 自动去冲突,后者优先)\nconst contentClass = computed(() =>\n cn(\n \"bg-popover text-popover-foreground z-[var(--z-overlay)] 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-overlay)]\"));\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,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "progress",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "进度条:基于 Ark UI Progress 原语,支持语义色、标签与百分比显示、不确定态。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "radio-group",
4
- "version": "0.5.1",
4
+ "version": "0.5.3",
5
5
  "type": "registry:ui",
6
6
  "description": "单选组:基于 Ark UI Radio Group 原语,键盘导航与受控/非受控双模式。",
7
7
  "registryDependencies": ["utils"],