@tu-design/vue 0.5.8 → 0.5.10

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 +242 -158
  2. package/dist/index.mjs +1296 -516
  3. package/dist/registry/vue/alert-dialog.json +2 -2
  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 +2 -2
  12. package/dist/registry/vue/checkbox.json +2 -2
  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 +2 -2
  17. package/dist/registry/vue/date-shared.json +2 -2
  18. package/dist/registry/vue/dialog.json +2 -2
  19. package/dist/registry/vue/drawer.json +2 -2
  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 +9 -9
  23. package/dist/registry/vue/form.json +2 -2
  24. package/dist/registry/vue/icon-shared.json +8 -2
  25. package/dist/registry/vue/input.json +2 -2
  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 +1 -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 +54 -54
  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 +24 -11
  45. package/dist/registry/vue/tabs.json +1 -1
  46. package/dist/registry/vue/textarea.json +2 -2
  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 +2 -2
  50. package/dist/registry/vue/tooltip.json +1 -1
  51. package/dist/registry/vue/tree-select.json +2 -2
  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": "form-render",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "配置驱动表单渲染器:defineForm 聚合 TanStack Form 实例与字段配置,柯里化 widget DSL 声明控件,Tailwind 栅格自适应布局,复用 Form 家族 aria 接线。",
7
7
  "registryDependencies": [
@@ -33,19 +33,19 @@
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\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/**\n * I4:校验失败时 isFieldsValid=false,不 emit;成功后才 emit(事件回调中一次性读取不受 S1 限制)。\n * 校验语义单点化(R30):definition 存在时复用 definition.submit();拆分式 :form + :items 走内联逻辑\n * @param mode - 提交语义:\"search\" 触发 search 事件(查询按钮),\"submit\" 触发 submit 事件\n */\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"
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// FormField 依赖 inject(FORM_KEY),本组件替代 <Form> 的 provide 职责\nprovide(FORM_KEY, instance as never);\n\n// 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// ---- 按钮解析(块级互斥):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// 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/**\n * 校验失败时 isFieldsValid=false,不 emit;成功后才 emit(事件回调中一次性读取不受非响应式限制)。\n * 校验语义单点化:definition 存在时复用 definition.submit();拆分式 :form + :items 走内联逻辑\n * @param mode - 提交语义:\"search\" 触发 search 事件(查询按钮),\"submit\" 触发 submit 事件\n */\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",
40
40
  "type": "registry:component",
41
41
  "target": "components/ui/form-render/FormRenderField.vue",
42
- "content": "<script lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { defineComponent, h } from \"vue\";\nimport {\n FormControl,\n FormDescription,\n FormField,\n FormItem,\n FormLabel,\n FormMessage,\n} from \"@/components/ui/form\";\nimport type { FormRenderItem, WidgetRenderReturn } from \"./types\";\n\n/**\n * 单字段桥接:复用 <FormField>(form.Field 动态渲染 + FIELD_KEY provide 时序),\n * 内部组装 FormItem/FormLabel/FormControl/FormDescription/FormMessage,\n * aria 接线(id/aria-invalid/aria-describedby)由 FormControl 的 cloneVNode 机制继承。\n * widget 调用发生在 FormField 插槽期,拿到 field 实例后组装 WidgetContext。\n */\nexport default defineComponent({\n name: \"TuFormRenderField\",\n props: {\n item: { type: Object as PropType<FormRenderItem<any>>, required: true },\n /** 已柯里化的 widget 渲染函数:r.input({...}) 的返回值 */\n widget: { type: Function as PropType<WidgetRenderReturn<any>>, required: true },\n /** 响应式全量表单值(FormRender 经 useSelector 建立,S1) */\n values: { type: Object as PropType<Record<string, unknown>>, required: true },\n },\n setup(props) {\n return () =>\n h(\n FormField,\n {\n name: String(props.item.key),\n validators: props.item.validators,\n },\n {\n default: ({ field }: any) => {\n if (!field) {\n if (import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <FormRenderField> 未取得 field 上下文(FormRender 缺 definition/form?)\",\n );\n }\n return null;\n }\n return h(\n FormItem,\n { class: props.item.class },\n {\n default: () => [\n props.item.hideLabel ? null : h(FormLabel, () => props.item.title),\n h(FormControl, () =>\n props.widget({\n field,\n item: props.item,\n values: props.values as never,\n }),\n ),\n props.item.description ? h(FormDescription, () => props.item.description) : null,\n h(FormMessage),\n ],\n },\n );\n },\n },\n );\n },\n});\n</script>\n"
42
+ "content": "<script lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { defineComponent, h } from \"vue\";\nimport {\n FormControl,\n FormDescription,\n FormField,\n FormItem,\n FormLabel,\n FormMessage,\n} from \"@/components/ui/form\";\nimport type { FormRenderItem, WidgetRenderReturn } from \"./types\";\n\n/**\n * 单字段桥接:复用 <FormField>(form.Field 动态渲染 + FIELD_KEY provide 时序),\n * 内部组装 FormItem/FormLabel/FormControl/FormDescription/FormMessage,\n * aria 接线(id/aria-invalid/aria-describedby)由 FormControl 的 cloneVNode 机制继承。\n * widget 调用发生在 FormField 插槽期,拿到 field 实例后组装 WidgetContext。\n */\nexport default defineComponent({\n name: \"TuFormRenderField\",\n props: {\n item: { type: Object as PropType<FormRenderItem<any>>, required: true },\n /** 已柯里化的 widget 渲染函数:r.input({...}) 的返回值 */\n widget: { type: Function as PropType<WidgetRenderReturn<any>>, required: true },\n /** 响应式全量表单值(FormRender 经 useSelector 建立) */\n values: { type: Object as PropType<Record<string, unknown>>, required: true },\n },\n setup(props) {\n return () =>\n h(\n FormField,\n {\n name: String(props.item.key),\n validators: props.item.validators,\n },\n {\n default: ({ field }: any) => {\n if (!field) {\n if (import.meta.env.DEV) {\n console.warn(\n \"[tu-design] <FormRenderField> 未取得 field 上下文(FormRender 缺 definition/form?)\",\n );\n }\n return null;\n }\n return h(\n FormItem,\n { class: props.item.class },\n {\n default: () => [\n props.item.hideLabel ? null : h(FormLabel, () => props.item.title),\n h(FormControl, () =>\n props.widget({\n field,\n item: props.item,\n values: props.values as never,\n }),\n ),\n props.item.description ? h(FormDescription, () => props.item.description) : null,\n h(FormMessage),\n ],\n },\n );\n },\n },\n );\n },\n});\n</script>\n"
43
43
  },
44
44
  {
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 /** 按钮预设七项(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 * @param config - 表单配置:字段定义、校验 schema、提交回调、按钮预设七项与 TanStack 透传项\n * @returns 表单渲染 definition(items + form + resetToDefaults + submit + actions?),直接传给 <FormRender>\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 /** 按钮预设七项(块级互斥):显式传任一项即投影为 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()` 全量校验并返回是否通过(组合式查询链路);\n * - `actions` 按钮预设(searchable 等七项直传):存在时 `<FormRender>` 组件按钮 props 全量忽略(块级互斥)。\n *\n * 须在组件 setup 中调用(TanStack useForm 约束)。\n * @param config - 表单配置:字段定义、校验 schema、提交回调、按钮预设七项与 TanStack 透传项\n * @returns 表单渲染 definition(items + form + resetToDefaults + submit + actions?),直接传给 <FormRender>\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",
@@ -57,13 +57,13 @@
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\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"
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 级缺省回退。\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 精确联动)。\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/** 按钮预设(块级互斥:actions 存在时 <FormRender> 组件按钮 props 全量忽略) */\nexport interface FormActionsConfig {\n /** 搜索按钮,缺省 false */\n searchable?: boolean;\n /** 提交按钮,缺省 false */\n submitable?: boolean;\n /** 重置按钮;缺省跟随 searchable(域内解析) */\n resetable?: boolean;\n /** 取消按钮;缺省跟随 submitable(域内解析) */\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 /** 全量校验并返回是否通过;不触发 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 /** 按钮预设七项(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 * @param options - 表单选项:字段定义、校验 schema、提交回调、按钮预设七项与 TanStack 透传项\n * @returns 表单渲染 definition(items + form + resetToDefaults + submit + actions?)\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"
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 /** 按钮预设七项:显式传任一项即投影为 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 * @param options - 表单选项:字段定义、校验 schema、提交回调、按钮预设七项与 TanStack 透传项\n * @returns 表单渲染 definition(items + form + resetToDefaults + submit + actions?)\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 // 按钮预设七项直传投影(块级互斥的 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 都执行完整校验流(校验语义单点化)\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",
@@ -93,19 +93,19 @@
93
93
  "path": "form-render/widgets/model-value.ts",
94
94
  "type": "registry:lib",
95
95
  "target": "components/ui/form-render/widgets/model-value.ts",
96
- "content": "import type { Component } from \"vue\";\nimport { h } from \"vue\";\nimport { CurrencyInput } from \"@/components/ui/currency-input\";\nimport { DatePicker } from \"@/components/ui/date-picker\";\nimport { DateRangePicker } from \"@/components/ui/date-range-picker\";\nimport { MonthPicker } from \"@/components/ui/month-picker\";\nimport { NumberInput } from \"@/components/ui/number-input\";\nimport { PasswordInput } from \"@/components/ui/password-input\";\nimport { Textarea } from \"@/components/ui/textarea\";\nimport { WeekPicker } from \"@/components/ui/week-picker\";\nimport { YearPicker } from \"@/components/ui/year-picker\";\nimport type {\n CurrencyWidgetOptions,\n DatePickerWidgetOptions,\n DateRangeWidgetOptions,\n MonthPickerWidgetOptions,\n NumberWidgetOptions,\n PasswordWidgetOptions,\n TextareaWidgetOptions,\n WeekPickerWidgetOptions,\n WidgetRenderReturn,\n YearPickerWidgetOptions,\n} from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/**\n * modelValue 形态 widgets 统一展开模式(方案 C):\n * item 级缺省 → options 整体展开(命名穿透,组件全 props)→ 受控绑定 → 逃逸口。\n * options.placeholder 为 undefined 时 Vue 视为未传,item 级缺省保留(I1 语义)。\n */\n\n/**\n * password widget:密码输入(autoComplete 为组件真实 prop,直接派生透传)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给 PasswordInput\n * @returns 渲染函数,接收渲染上下文并产出 PasswordInput vnode\n */\nexport function renderPasswordItem<T extends object>(\n options: PasswordWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(PasswordInput, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * number widget:数值输入(modelValue: number|null)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给 NumberInput\n * @returns 渲染函数,接收渲染上下文并产出 NumberInput vnode\n */\nexport function renderNumberItem<T extends object>(\n options: NumberWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(NumberInput, {\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * currency widget:金额输入(labelUnit/valueUnit 单位展示)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给 CurrencyInput\n * @returns 渲染函数,接收渲染上下文并产出 CurrencyInput vnode\n */\nexport function renderCurrencyItem<T extends object>(\n options: CurrencyWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(CurrencyInput, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * textarea widget:多行文本(placeholder/rows 为原生 attr 透传)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给 Textarea\n * @returns 渲染函数,接收渲染上下文并产出 Textarea vnode\n */\nexport function renderTextareaItem<T extends object>(\n options: TextareaWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Textarea, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * 日期类 widget 共用工厂:入口各自携带强类型(DatePicker/Month/Year/DateRange 的\n * props 面互不相同,见 types.ts 各派生接口),内部共享实现无需重复泛型关联。\n * @param component - 日期类组件(DatePicker/MonthPicker/YearPicker/DateRangePicker/WeekPicker)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给组件\n * @returns 渲染函数,接收渲染上下文并产出对应日期组件的 vnode\n */\nfunction pickerRenderer(component: Component, options: object): WidgetRenderReturn<any> {\n return (ctx) =>\n h(component, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * datePicker widget:日期选择(单日,modelValue 受控形态)\n * @param options - widget 选项,经 pickerRenderer 共享实现透传给 DatePicker\n * @returns 渲染函数,接收渲染上下文并产出 DatePicker vnode\n */\nexport function renderDatePickerItem<T extends object>(\n options: DatePickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(DatePicker, options);\n}\n\n/**\n * monthPicker widget:月份选择(modelValue 受控形态)\n * @param options - widget 选项,经 pickerRenderer 共享实现透传给 MonthPicker\n * @returns 渲染函数,接收渲染上下文并产出 MonthPicker vnode\n */\nexport function renderMonthPickerItem<T extends object>(\n options: MonthPickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(MonthPicker, options);\n}\n\n/**\n * yearPicker widget:年份选择(modelValue 受控形态)\n * @param options - widget 选项,经 pickerRenderer 共享实现透传给 YearPicker\n * @returns 渲染函数,接收渲染上下文并产出 YearPicker vnode\n */\nexport function renderYearPickerItem<T extends object>(\n options: YearPickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(YearPicker, options);\n}\n\n/**\n * dateRangePicker widget:[start, end] | null 形态\n * @param options - widget 选项,经 pickerRenderer 共享实现透传给 DateRangePicker\n * @returns 渲染函数,接收渲染上下文并产出 DateRangePicker vnode\n */\nexport function renderDateRangePickerItem<T extends object>(\n options: DateRangeWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(DateRangePicker, options);\n}\n\n/**\n * weekPicker widget:周选择(modelValue 受控形态)\n * @param options - widget 选项,经 pickerRenderer 共享实现透传给 WeekPicker\n * @returns 渲染函数,接收渲染上下文并产出 WeekPicker vnode\n */\nexport function renderWeekPickerItem<T extends object>(\n options: WeekPickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(WeekPicker, options);\n}\n"
96
+ "content": "import type { Component } from \"vue\";\nimport { h } from \"vue\";\nimport { CurrencyInput } from \"@/components/ui/currency-input\";\nimport { DatePicker } from \"@/components/ui/date-picker\";\nimport { DateRangePicker } from \"@/components/ui/date-range-picker\";\nimport { MonthPicker } from \"@/components/ui/month-picker\";\nimport { NumberInput } from \"@/components/ui/number-input\";\nimport { PasswordInput } from \"@/components/ui/password-input\";\nimport { Textarea } from \"@/components/ui/textarea\";\nimport { WeekPicker } from \"@/components/ui/week-picker\";\nimport { YearPicker } from \"@/components/ui/year-picker\";\nimport type {\n CurrencyWidgetOptions,\n DatePickerWidgetOptions,\n DateRangeWidgetOptions,\n MonthPickerWidgetOptions,\n NumberWidgetOptions,\n PasswordWidgetOptions,\n TextareaWidgetOptions,\n WeekPickerWidgetOptions,\n WidgetRenderReturn,\n YearPickerWidgetOptions,\n} from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/**\n * modelValue 形态 widgets 统一展开模式(方案 C):\n * item 级缺省 → options 整体展开(命名穿透,组件全 props)→ 受控绑定 → 逃逸口。\n * options.placeholder 为 undefined 时 Vue 视为未传,item 级缺省保留。\n */\n\n/**\n * password widget:密码输入(autoComplete 为组件真实 prop,直接派生透传)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给 PasswordInput\n * @returns 渲染函数,接收渲染上下文并产出 PasswordInput vnode\n */\nexport function renderPasswordItem<T extends object>(\n options: PasswordWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(PasswordInput, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * number widget:数值输入(modelValue: number|null)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给 NumberInput\n * @returns 渲染函数,接收渲染上下文并产出 NumberInput vnode\n */\nexport function renderNumberItem<T extends object>(\n options: NumberWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(NumberInput, {\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * currency widget:金额输入(labelUnit/valueUnit 单位展示)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给 CurrencyInput\n * @returns 渲染函数,接收渲染上下文并产出 CurrencyInput vnode\n */\nexport function renderCurrencyItem<T extends object>(\n options: CurrencyWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(CurrencyInput, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * textarea widget:多行文本(placeholder/rows 为原生 attr 透传)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给 Textarea\n * @returns 渲染函数,接收渲染上下文并产出 Textarea vnode\n */\nexport function renderTextareaItem<T extends object>(\n options: TextareaWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Textarea, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * 日期类 widget 共用工厂:入口各自携带强类型(DatePicker/Month/Year/DateRange 的\n * props 面互不相同,见 types.ts 各派生接口),内部共享实现无需重复泛型关联。\n * @param component - 日期类组件(DatePicker/MonthPicker/YearPicker/DateRangePicker/WeekPicker)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给组件\n * @returns 渲染函数,接收渲染上下文并产出对应日期组件的 vnode\n */\nfunction pickerRenderer(component: Component, options: object): WidgetRenderReturn<any> {\n return (ctx) =>\n h(component, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * datePicker widget:日期选择(单日,modelValue 受控形态)\n * @param options - widget 选项,经 pickerRenderer 共享实现透传给 DatePicker\n * @returns 渲染函数,接收渲染上下文并产出 DatePicker vnode\n */\nexport function renderDatePickerItem<T extends object>(\n options: DatePickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(DatePicker, options);\n}\n\n/**\n * monthPicker widget:月份选择(modelValue 受控形态)\n * @param options - widget 选项,经 pickerRenderer 共享实现透传给 MonthPicker\n * @returns 渲染函数,接收渲染上下文并产出 MonthPicker vnode\n */\nexport function renderMonthPickerItem<T extends object>(\n options: MonthPickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(MonthPicker, options);\n}\n\n/**\n * yearPicker widget:年份选择(modelValue 受控形态)\n * @param options - widget 选项,经 pickerRenderer 共享实现透传给 YearPicker\n * @returns 渲染函数,接收渲染上下文并产出 YearPicker vnode\n */\nexport function renderYearPickerItem<T extends object>(\n options: YearPickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(YearPicker, options);\n}\n\n/**\n * dateRangePicker widget:[start, end] | null 形态\n * @param options - widget 选项,经 pickerRenderer 共享实现透传给 DateRangePicker\n * @returns 渲染函数,接收渲染上下文并产出 DateRangePicker vnode\n */\nexport function renderDateRangePickerItem<T extends object>(\n options: DateRangeWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(DateRangePicker, options);\n}\n\n/**\n * weekPicker widget:周选择(modelValue 受控形态)\n * @param options - widget 选项,经 pickerRenderer 共享实现透传给 WeekPicker\n * @returns 渲染函数,接收渲染上下文并产出 WeekPicker vnode\n */\nexport function renderWeekPickerItem<T extends object>(\n options: WeekPickerWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return pickerRenderer(WeekPicker, options);\n}\n"
97
97
  },
98
98
  {
99
99
  "path": "form-render/widgets/select.ts",
100
100
  "type": "registry:lib",
101
101
  "target": "components/ui/form-render/widgets/select.ts",
102
- "content": "import { h } from \"vue\";\nimport { Select } from \"@/components/ui/select\";\nimport type { SelectWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/**\n * select widget:Select 已单组件化,items/placeholder 均为正式 prop 直写。\n * v3 命名穿透:options 整体透传给 Select(内部做 string 归一化);\n * placeholder 解构出来做 item 级缺省回退(options 优先,I1 语义)。\n * @param options - widget 选项,items/placeholder 直写为组件 prop,其余整体透传给 Select\n * @returns 渲染函数,接收渲染上下文并产出 Select vnode\n */\nexport function renderSelectItem<T extends object>(\n options: SelectWidgetOptions,\n): WidgetRenderReturn<T> {\n const { placeholder, items, ...rootProps } = options;\n return (ctx) =>\n h(Select, {\n ...rootProps,\n items,\n placeholder: placeholder ?? ctx.item.placeholder,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n"
102
+ "content": "import { h } from \"vue\";\nimport { Select } from \"@/components/ui/select\";\nimport type { SelectWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/**\n * select widget:Select 已单组件化,items/placeholder 均为正式 prop 直写。\n * v3 命名穿透:options 整体透传给 Select(内部做 string 归一化);\n * placeholder 解构出来做 item 级缺省回退(options 优先)。\n * @param options - widget 选项,items/placeholder 直写为组件 prop,其余整体透传给 Select\n * @returns 渲染函数,接收渲染上下文并产出 Select vnode\n */\nexport function renderSelectItem<T extends object>(\n options: SelectWidgetOptions,\n): WidgetRenderReturn<T> {\n const { placeholder, items, ...rootProps } = options;\n return (ctx) =>\n h(Select, {\n ...rootProps,\n items,\n placeholder: placeholder ?? ctx.item.placeholder,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n"
103
103
  },
104
104
  {
105
105
  "path": "form-render/widgets/tree.ts",
106
106
  "type": "registry:lib",
107
107
  "target": "components/ui/form-render/widgets/tree.ts",
108
- "content": "import type { ComponentPublicInstance } from \"vue\";\nimport { h } from \"vue\";\nimport { Cascader } from \"@/components/ui/cascader\";\nimport { TreeSelect } from \"@/components/ui/tree-select\";\nimport type { CascaderWidgetOptions, TreeSelectWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/**\n * treeSelect / cascader widget:树形选项族(modelValue 受控形态)。\n * 命名穿透:options 原名直传(TreeOption:key/label/children/disabled);\n * placeholder 先用 item 级回退(I1),options.placeholder 展开时覆盖。\n *\n * 断言说明:两组件的 boolean props(multiple/checkable/clearable…)为裸\n * `Boolean, default: false` 声明,vue-tsc ExtractPropTypes 将其推断为 required,\n * spread Partial 必缺键;断言到 $props 同源类型保留键名检查(优于 as never)。\n */\ntype SfcAllProps<C> = C extends abstract new (...args: never[]) => any\n ? Partial<ComponentPublicInstance[\"$props\"]> & InstanceType<C>[\"$props\"]\n : never;\n\n/**\n * treeSelect widget:树形下拉选择,options 原名直传(TreeOption 命名穿透),\n * placeholder 先用 item 级回退(I1),options.placeholder 展开时覆盖。\n * @param options - widget 选项,原名直传给 TreeSelect,placeholder 以 item 级缺省兜底\n * @returns 渲染函数,接收渲染上下文并产出 TreeSelect vnode\n */\nexport function renderTreeSelectItem<T extends object>(\n options: TreeSelectWidgetOptions,\n): WidgetRenderReturn<T> {\n const { placeholder, ...rest } = options;\n return (ctx) =>\n h(TreeSelect, {\n placeholder: placeholder ?? ctx.item.placeholder,\n ...rest,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n } as SfcAllProps<typeof TreeSelect>);\n}\n\n/**\n * cascader widget:级联选择,绑定与 treeSelect 一致(modelValue 受控形态),\n * placeholder 先用 item 级回退(I1),options.placeholder 展开时覆盖。\n * @param options - widget 选项,原名直传给 Cascader,placeholder 以 item 级缺省兜底\n * @returns 渲染函数,接收渲染上下文并产出 Cascader vnode\n */\nexport function renderCascaderItem<T extends object>(\n options: CascaderWidgetOptions,\n): WidgetRenderReturn<T> {\n const { placeholder, ...rest } = options;\n return (ctx) =>\n h(Cascader, {\n placeholder: placeholder ?? ctx.item.placeholder,\n ...rest,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n } as SfcAllProps<typeof Cascader>);\n}\n"
108
+ "content": "import type { ComponentPublicInstance } from \"vue\";\nimport { h } from \"vue\";\nimport { Cascader } from \"@/components/ui/cascader\";\nimport { TreeSelect } from \"@/components/ui/tree-select\";\nimport type { CascaderWidgetOptions, TreeSelectWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/**\n * treeSelect / cascader widget:树形选项族(modelValue 受控形态)。\n * 命名穿透:options 原名直传(TreeOption:key/label/children/disabled);\n * placeholder 先用 item 级回退,options.placeholder 展开时覆盖。\n *\n * 断言说明:两组件的 boolean props(multiple/checkable/clearable…)为裸\n * `Boolean, default: false` 声明,vue-tsc ExtractPropTypes 将其推断为 required,\n * spread Partial 必缺键;断言到 $props 同源类型保留键名检查(优于 as never)。\n */\ntype SfcAllProps<C> = C extends abstract new (...args: never[]) => any\n ? Partial<ComponentPublicInstance[\"$props\"]> & InstanceType<C>[\"$props\"]\n : never;\n\n/**\n * treeSelect widget:树形下拉选择,options 原名直传(TreeOption 命名穿透),\n * placeholder 先用 item 级回退,options.placeholder 展开时覆盖。\n * @param options - widget 选项,原名直传给 TreeSelect,placeholder 以 item 级缺省兜底\n * @returns 渲染函数,接收渲染上下文并产出 TreeSelect vnode\n */\nexport function renderTreeSelectItem<T extends object>(\n options: TreeSelectWidgetOptions,\n): WidgetRenderReturn<T> {\n const { placeholder, ...rest } = options;\n return (ctx) =>\n h(TreeSelect, {\n placeholder: placeholder ?? ctx.item.placeholder,\n ...rest,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n } as SfcAllProps<typeof TreeSelect>);\n}\n\n/**\n * cascader widget:级联选择,绑定与 treeSelect 一致(modelValue 受控形态),\n * placeholder 先用 item 级回退,options.placeholder 展开时覆盖。\n * @param options - widget 选项,原名直传给 Cascader,placeholder 以 item 级缺省兜底\n * @returns 渲染函数,接收渲染上下文并产出 Cascader vnode\n */\nexport function renderCascaderItem<T extends object>(\n options: CascaderWidgetOptions,\n): WidgetRenderReturn<T> {\n const { placeholder, ...rest } = options;\n return (ctx) =>\n h(Cascader, {\n placeholder: placeholder ?? ctx.item.placeholder,\n ...rest,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n } as SfcAllProps<typeof Cascader>);\n}\n"
109
109
  },
110
110
  {
111
111
  "path": "form-render/widgets/value.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.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "表单状态与校验:基于 TanStack Form,配合 Valibot(Standard Schema)声明式校验,aria 自动接线。",
7
7
  "registryDependencies": ["utils", "input", "button", "label"],
@@ -29,7 +29,7 @@
29
29
  "path": "form/FormField.vue",
30
30
  "type": "registry:component",
31
31
  "target": "components/ui/form/FormField.vue",
32
- "content": "<script lang=\"ts\">\nimport type { AnyFieldApi } from \"@tanstack/vue-form\";\nimport type { PropType } from \"vue\";\nimport { defineComponent, h, inject, provide, shallowRef } from \"vue\";\nimport { FIELD_KEY, FORM_KEY } from \"./context\";\n\n/**\n * 渲染 TanStack `form.Field` 并经 provide 下发 field 上下文。\n * field 实例只能在 form.Field 的插槽执行期取得(时序早于子组件 setup),\n * 故用 defineComponent + render function 在插槽回调中写入 ShallowRef。\n */\nexport default defineComponent({\n name: \"TuFormField\",\n props: {\n /** 字段名(TanStack 深层 key 的运行时形态) */\n name: { type: String, required: true },\n /** 校验器配置,原样透传(值可为函数或 Standard Schema,如 valibot) */\n validators: { type: Object as PropType<Record<string, unknown>>, default: undefined },\n /** 字段模式:value 单值(默认);array 数组字段,解锁 pushValue/removeValue 等行操作 */\n mode: { type: String as PropType<\"value\" | \"array\">, default: \"value\" },\n },\n setup(props, { slots }) {\n const form = inject(FORM_KEY);\n if (!form && import.meta.env.DEV) {\n console.warn(\"[tu-design] <FormField> 必须在 <Form> 内使用\");\n }\n\n const fieldRef = shallowRef<AnyFieldApi>();\n provide(FIELD_KEY, { field: fieldRef, name: props.name });\n\n if (!form) {\n // 优雅降级:field 上下文缺席(FIELD_KEY.field 为 undefined),子组件需自行容忍\n return () => slots.default?.({ field: undefined as unknown as AnyFieldApi });\n }\n\n return () =>\n h(\n form.Field as never,\n { name: props.name, validators: props.validators, mode: props.mode } as never,\n {\n default: (slotProps: { field: AnyFieldApi }) => {\n fieldRef.value = slotProps.field;\n return slots.default?.(slotProps);\n },\n },\n );\n },\n});\n</script>\n"
32
+ "content": "<script lang=\"ts\">\nimport type { AnyFieldApi } from \"@tanstack/vue-form\";\nimport type { PropType, SlotsType, VNodeChild } from \"vue\";\nimport { defineComponent, h, inject, provide, shallowRef } from \"vue\";\nimport { FIELD_KEY, FORM_KEY } from \"./context\";\n\ninterface FormFieldProps {\n /** 字段名(TanStack 深层 key 的运行时形态) */\n name: string;\n /** 校验器配置,原样透传(值可为函数或 Standard Schema,如 valibot) */\n validators?: Record<string, unknown>;\n /** 字段模式:value 单值(默认);array 数组字段,解锁 pushValue/removeValue 等行操作 */\n mode?: \"value\" | \"array\";\n}\n\n/*\n * 渲染 TanStack `form.Field` 并经 provide 下发 field 上下文。\n * field 实例只能在 form.Field 的插槽执行期取得(时序早于子组件 setup),\n * 故用 setup 函数 + render function 在插槽回调中写入 ShallowRef。\n *\n * 用 defineComponent 函数式重载显式声明 slots 类型(Options API 无法声明):\n * 降级路径(FormField 不在 Form 内)field 为 undefined,类型必须诚实,\n * 否则消费者 #default=\"{ field }\" 拿到 any(内部子组件已容忍 undefined)。\n */\nexport default defineComponent<\n FormFieldProps,\n {},\n string,\n SlotsType<{ default?: (props: { field: AnyFieldApi | undefined }) => VNodeChild }>\n>(\n /**\n * @param props - 组件 props(name/validators/mode)\n * @param ctx - setup 上下文(slots/attrs/emit)\n * @returns 渲染函数:Form 内渲染 TanStack form.Field 并捕获 field 实例;缺席时降级直渲插槽\n */\n (props, ctx) => {\n const { slots } = ctx;\n const form = inject(FORM_KEY);\n if (!form && import.meta.env.DEV) {\n console.warn(\"[tu-design] <FormField> 必须在 <Form> 内使用\");\n }\n\n const fieldRef = shallowRef<AnyFieldApi>();\n provide(FIELD_KEY, { field: fieldRef, name: props.name });\n\n if (!form) {\n // 优雅降级:field 上下文缺席(FIELD_KEY.field 为 undefined),子组件需自行容忍\n return () => slots.default?.({ field: undefined });\n }\n\n return () =>\n h(\n form.Field as never,\n { name: props.name, validators: props.validators, mode: props.mode } as never,\n {\n default: (slotProps: { field: AnyFieldApi }) => {\n fieldRef.value = slotProps.field;\n return slots.default?.(slotProps);\n },\n },\n );\n },\n {\n name: \"TuFormField\",\n props: {\n name: { type: String, required: true },\n validators: {\n type: Object as PropType<Record<string, unknown>>,\n default: undefined,\n },\n mode: { type: String as PropType<\"value\" | \"array\">, default: \"value\" },\n },\n },\n);\n</script>\n"
33
33
  },
34
34
  {
35
35
  "path": "form/FormItem.vue",
@@ -1,9 +1,9 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "icon-shared",
4
- "version": "0.5.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
- "description": "内置功能性图标(CloseIcon/ChevronIcon/CalendarIcon),内部共享,非公共 API。图标组件零默认类:尺寸/旋转/过渡类由使用处显式传入,避免 fallthrough 拼接时同名工具类排序冲突。",
6
+ "description": "内置功能性图标(CloseIcon/ChevronIcon/CalendarIcon/GripIcon),内部共享,非公共 API。图标组件零默认类:尺寸/旋转/过渡类由使用处显式传入,避免 fallthrough 拼接时同名工具类排序冲突。",
7
7
  "files": [
8
8
  {
9
9
  "path": "icon-shared/CalendarIcon.vue",
@@ -22,6 +22,12 @@
22
22
  "type": "registry:component",
23
23
  "target": "components/ui/icon-shared/CloseIcon.vue",
24
24
  "content": "<template>\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n aria-hidden=\"true\"\n >\n <path d=\"M18 6 6 18\" />\n <path d=\"m6 6 12 12\" />\n </svg>\n</template>\n"
25
+ },
26
+ {
27
+ "path": "icon-shared/GripIcon.vue",
28
+ "type": "registry:component",
29
+ "target": "components/ui/icon-shared/GripIcon.vue",
30
+ "content": "<template>\n <svg\n viewBox=\"0 0 24 24\"\n fill=\"none\"\n stroke=\"currentColor\"\n stroke-width=\"2\"\n stroke-linecap=\"round\"\n stroke-linejoin=\"round\"\n aria-hidden=\"true\"\n >\n <circle cx=\"9\" cy=\"12\" r=\"1\" />\n <circle cx=\"9\" cy=\"5\" r=\"1\" />\n <circle cx=\"9\" cy=\"19\" r=\"1\" />\n <circle cx=\"15\" cy=\"12\" r=\"1\" />\n <circle cx=\"15\" cy=\"5\" r=\"1\" />\n <circle cx=\"15\" cy=\"19\" r=\"1\" />\n </svg>\n</template>\n"
25
31
  }
26
32
  ]
27
33
  }
@@ -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.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "文本输入框,支持 v-model、attrs 透传与 invalid 校验态。",
7
7
  "registryDependencies": ["utils"],
@@ -10,7 +10,7 @@
10
10
  "path": "input/Input.vue",
11
11
  "type": "registry:component",
12
12
  "target": "components/ui/input/Input.vue",
13
- "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\nconst modelValue = defineModel<string | number>();\nconst props = defineProps<{ class?: string; invalid?: boolean }>();\n</script>\n\n<template>\n <input\n v-model=\"modelValue\"\n :aria-invalid=\"props.invalid ? 'true' : undefined\"\n :class=\"\n cn(\n 'flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-sm transition-[color,box-shadow] outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-destructive/20 aria-invalid:border-destructive',\n props.class,\n )\n \"\n />\n</template>\n"
13
+ "content": "<script setup lang=\"ts\">\nimport { cn } from \"@/lib/utils\";\n\n// 原生 <input> 的 v-model 回写恒为 string,会令绑定了 number 的模型类型漂移\n// (string 是联合成员,类型系统不报错)。跟随绑定类型归一:当前模型值为 number\n// 时按 looseToNumber 语义(parseFloat,NaN 则原样)回写 number,文本绑定不归一\n// (邮编/前导零安全)。useModel 保证 set 执行时读到的仍是旧值,故以此为绑定类型依据。\nconst looseToNumber = (val: string | number): string | number => {\n const n = Number.parseFloat(String(val));\n return Number.isNaN(n) ? val : n;\n};\n\nconst modelValue = defineModel<string | number>({\n set: (v) => (typeof modelValue.value === \"number\" ? looseToNumber(v) : v),\n});\nconst props = defineProps<{ class?: string; invalid?: boolean }>();\n</script>\n\n<template>\n <input\n v-model=\"modelValue\"\n :aria-invalid=\"props.invalid ? 'true' : undefined\"\n :class=\"\n cn(\n 'flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-sm transition-[color,box-shadow] outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] disabled:cursor-not-allowed disabled:opacity-50 aria-invalid:ring-destructive/20 aria-invalid:border-destructive',\n props.class,\n )\n \"\n />\n</template>\n"
14
14
  },
15
15
  {
16
16
  "path": "input/index.ts",
@@ -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.8",
4
+ "version": "0.5.10",
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.8",
4
+ "version": "0.5.10",
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.8",
4
+ "version": "0.5.10",
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.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "弹层家族共享逻辑:受控开合桥接(useControlledBoolean)与确认 pending 语义(useConfirmPending)。",
7
7
  "files": [
@@ -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.8",
4
+ "version": "0.5.10",
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.8",
4
+ "version": "0.5.10",
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.8",
4
+ "version": "0.5.10",
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.8",
4
+ "version": "0.5.10",
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, onBeforeUnmount, useAttrs, useSlots } from \"vue\";\nimport type { PopoverRootProps } from \"@ark-ui/vue/popover\";\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\n\n/** 面板相对触发器的对齐方向 */\ntype Align = \"start\" | \"center\" | \"end\";\n/** 面板主轴方向(与 align 组合成 12 方位 placement) */\ntype Side = \"top\" | \"bottom\" | \"left\" | \"right\";\n/** 触发方式:click 内建切换;hover/focus 延迟桥接;manual 纯受控 */\ntype TriggerMode = \"click\" | \"hover\" | \"focus\" | \"manual\";\n\n/** Ark Popover Root 的 positioning 配置(placement 含四方向 × 对齐组合) */\ntype ArkPositioning = NonNullable<PopoverRootProps[\"positioning\"]>;\ntype ArkPlacement = NonNullable<ArkPositioning[\"placement\"]>;\n\ndefineOptions({ inheritAttrs: false });\n\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次展开才挂载面板内容 */\n lazyMount: { type: Boolean, default: false },\n /** 收起时卸载面板内容 */\n unmountOnExit: { type: Boolean, default: false },\n /** 触发方式:click(默认,内建切换+完整 aria) / hover / focus(带延迟,Anchor+手动 aria) / manual(纯受控,仅定位锚点) */\n trigger: { type: String as PropType<TriggerMode>, default: \"click\" },\n /** hover/focus 打开延迟(毫秒) */\n openDelay: { type: Number, default: 100 },\n /** hover/focus 关闭延迟(毫秒) */\n closeDelay: { type: Number, default: 100 },\n /** hover/focus 时悬浮/聚焦面板保持打开 */\n keepAliveOnHover: { type: Boolean, default: true },\n /** 面板主轴方向(与 align 组合定位);attrs.positioning.placement 显式给出时以其为准 */\n side: { type: String as PropType<Side>, default: \"bottom\" },\n /** 面板相对触发器的对齐方向(默认居中) */\n align: { type: String as PropType<Align>, default: \"center\" },\n /** 显示箭头(shadcn 风格默认无箭头) */\n arrow: { type: Boolean, default: false },\n /** 追加/覆盖箭头样式类 */\n arrowClass: { type: String, default: undefined },\n /** 禁用触发(不响应任何触发事件;已打开状态不受影响) */\n disabled: { type: Boolean, default: false },\n /** 是否 Teleport(浮层定位不受嵌套裁剪影响);false 时面板留在原地 */\n portal: { type: Boolean, default: true },\n /** Teleport 目标(选择器或元素),仅 portal=true 时生效;\n 缺省时若应用挂载容器处于 shadow DOM 或 wujie graft 沙箱,自动降级为该容器,否则 body */\n to: { type: [String, Object] as PropType<string | HTMLElement>, default: undefined },\n /** 面板宽度与触发元素一致 */\n matchTriggerWidth: { type: Boolean, default: false },\n /** 覆盖面板/定位层级(默认走 --z-overlay) */\n zIndex: { type: Number, default: undefined },\n /** 追加/覆盖面板样式类(默认 w-72 可由此覆盖,如 \"w-56 p-0\") */\n contentClass: { type: String, default: undefined },\n /** 透传到面板根元素上的属性(id/style/data-* 等,class 请用 contentClass) */\n contentProps: { type: Object as PropType<Record<string, unknown>>, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\nconst slots = useSlots();\nconst attrs = useAttrs();\n\n// —— Teleport 目标解析:显式 to > shadow DOM / wujie graft 自动降级 > body ——\n// 机制详注见 useSandboxTeleportTarget(Popover 0.5.3 沙箱修复的公共层抽离)\nconst teleportTarget = useSandboxTeleportTarget(() => props.to);\n\n// —— 受控桥接(Dialog 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// —— 触发路径分派:click 用内建 Trigger(完整 aria 自动接线);\n// hover/focus/manual 用 Anchor 作定位锚点(无内建 click,语义不冲突)。\n// disabled 时也切 Anchor:内建 TOGGLE 无法从外部短路(AT_TARGET 阶段监听器按注册顺序\n// 执行、capture 无优先级),不渲染 Trigger 是唯一可靠方式 ——\nconst useNativeTrigger = computed(() => props.trigger === \"click\" && !props.disabled);\n\n// —— Anchor 模式的手动 aria 接线(补偿放弃 Trigger 的自动接线)——\n// —— ids 全量覆盖(无冒号)详注见 useOverlayIds(wujie patch getElementById\n// 对 zag 缺省冒号 id `popover:{id}:*` 每次查询抛 SyntaxError 刷警告);\n// trigger 为静态 id,仅支持单触发器(本 wrapper 只渲染单个 Trigger/Anchor)——\nconst { ids: rootIds, resolveId } = useOverlayIds(attrs, {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"anchor\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"arrow\",\n ],\n});\nconst anchorAria = computed(() =>\n useNativeTrigger.value\n ? {}\n : {\n \"aria-haspopup\": \"dialog\" as const,\n \"aria-expanded\": isOpen.value,\n \"aria-controls\": resolveId(\"content\"), // user 覆盖优先,与面板实际 id 一致\n },\n);\n\n// —— 延迟桥接(hover/focus):单一定时器,进入取消关闭、离开取消打开 ——\nlet timer: ReturnType<typeof setTimeout> | null = null;\nconst clearTimer = () => {\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n};\nconst schedule = (next: boolean, delay: number) => {\n if (props.disabled) return;\n clearTimer();\n if (delay <= 0) {\n setOpen(next);\n return;\n }\n timer = setTimeout(() => {\n timer = null;\n if (!props.disabled) setOpen(next);\n }, delay);\n};\n\nconst isHoverFocus = () => props.trigger === \"hover\" || props.trigger === \"focus\";\n\nconst onTriggerEnter = () => {\n if (!isHoverFocus()) return;\n schedule(true, props.openDelay);\n};\nconst onTriggerLeave = () => {\n if (!isHoverFocus()) return;\n schedule(false, props.closeDelay);\n};\n// 面板悬浮/聚焦保活(keep-alive 语义):仅取消挂起的关闭计时\nconst onPanelEnter = () => {\n if (!isHoverFocus() || !props.keepAliveOnHover) return;\n clearTimer();\n};\n// 离开面板(去往触发器以外的地方)也应关闭:覆盖 trigger→panel→outside 链路\nconst onPanelLeave = () => {\n if (!isHoverFocus()) return;\n schedule(false, props.closeDelay);\n};\n\nonBeforeUnmount(clearTimer);\n\n// side/align → Ark positioning.placement(12 方位,居中不带对齐后缀);\n// 外部经 attrs 传入的 positioning 已显式指定 placement 时以其为准,其余字段原样合并。\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位修正),机制详注见\n// withSandboxStrategy / overlay-shared/sandbox.ts —— 沙箱修复的公共层抽离\nconst rootPositioning = computed<ArkPositioning>(() => {\n const user = (attrs.positioning ?? {}) as ArkPositioning;\n const placement = (\n props.align === \"center\" ? props.side : `${props.side}-${props.align}`\n ) as ArkPlacement;\n return withSandboxStrategy(user, {\n ...user,\n placement,\n sameWidth: props.matchTriggerWidth || user.sameWidth,\n });\n});\n\n// 面板样式:内置类 + contentClass + contentProps.class 三方合并(twMerge 自动去冲突,后者优先)\nconst contentClass = computed(() =>\n cn(\n \"bg-popover text-popover-foreground z-[var(--z-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"
14
+ "content": "<script setup lang=\"ts\">\nimport type { ClassValue } from \"clsx\";\nimport type { PropType } from \"vue\";\nimport { computed, onBeforeUnmount, useAttrs, useSlots } from \"vue\";\nimport type { PopoverRootProps } from \"@ark-ui/vue/popover\";\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\nimport { useOverlayIds } from \"../overlay-shared/useOverlayIds\";\nimport { useSandboxTeleportTarget, withSandboxStrategy } from \"../overlay-shared/useSandboxOverlay\";\n\n/** 面板相对触发器的对齐方向 */\ntype Align = \"start\" | \"center\" | \"end\";\n/** 面板主轴方向(与 align 组合成 12 方位 placement) */\ntype Side = \"top\" | \"bottom\" | \"left\" | \"right\";\n/** 触发方式:click 内建切换;hover/focus 延迟桥接;manual 纯受控 */\ntype TriggerMode = \"click\" | \"hover\" | \"focus\" | \"manual\";\n\n/** Ark Popover Root 的 positioning 配置(placement 含四方向 × 对齐组合) */\ntype ArkPositioning = NonNullable<PopoverRootProps[\"positioning\"]>;\ntype ArkPlacement = NonNullable<ArkPositioning[\"placement\"]>;\n\ndefineOptions({ inheritAttrs: false });\n\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次展开才挂载面板内容 */\n lazyMount: { type: Boolean, default: false },\n /** 收起时卸载面板内容 */\n unmountOnExit: { type: Boolean, default: false },\n /** 触发方式:click(默认,内建切换+完整 aria) / hover / focus(带延迟,Anchor+手动 aria) / manual(纯受控,仅定位锚点) */\n trigger: { type: String as PropType<TriggerMode>, default: \"click\" },\n /** hover/focus 打开延迟(毫秒) */\n openDelay: { type: Number, default: 100 },\n /** hover/focus 关闭延迟(毫秒) */\n closeDelay: { type: Number, default: 100 },\n /** hover/focus 时悬浮/聚焦面板保持打开 */\n keepAliveOnHover: { type: Boolean, default: true },\n /** 面板主轴方向(与 align 组合定位);attrs.positioning.placement 显式给出时以其为准 */\n side: { type: String as PropType<Side>, default: \"bottom\" },\n /** 面板相对触发器的对齐方向(默认居中) */\n align: { type: String as PropType<Align>, default: \"center\" },\n /** 显示箭头(shadcn 风格默认无箭头) */\n arrow: { type: Boolean, default: false },\n /** 追加/覆盖箭头样式类 */\n arrowClass: { type: String, default: undefined },\n /** 禁用触发(不响应任何触发事件;已打开状态不受影响) */\n disabled: { type: Boolean, default: false },\n /** 是否 Teleport(浮层定位不受嵌套裁剪影响);false 时面板留在原地 */\n portal: { type: Boolean, default: true },\n /** Teleport 目标(选择器或元素),仅 portal=true 时生效;\n 缺省时若应用挂载容器处于 shadow DOM 或 wujie graft 沙箱,自动降级为该容器,否则 body */\n to: { type: [String, Object] as PropType<string | HTMLElement>, default: undefined },\n /** 面板宽度与触发元素一致 */\n matchTriggerWidth: { type: Boolean, default: false },\n /** 覆盖面板/定位层级(默认走 --z-overlay) */\n zIndex: { type: Number, default: undefined },\n /** 追加/覆盖面板样式类(默认 w-72 可由此覆盖,如 \"w-56 p-0\") */\n contentClass: { type: String, default: undefined },\n /** 透传到面板根元素上的属性(id/style/data-* 等,class 请用 contentClass) */\n contentProps: { type: Object as PropType<Record<string, unknown>>, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:open\": [open: boolean] }>();\n\nconst slots = useSlots();\nconst attrs = useAttrs();\n\n// —— Teleport 目标解析:显式 to > shadow DOM / wujie graft 自动降级 > body ——\n// 机制详注见 useSandboxTeleportTarget(Popover 0.5.3 沙箱修复的公共层抽离)\nconst teleportTarget = useSandboxTeleportTarget(() => props.to);\n\n// —— 受控桥接(Dialog 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// —— 触发路径分派:click 用内建 Trigger(完整 aria 自动接线);\n// hover/focus/manual 用 Anchor 作定位锚点(无内建 click,语义不冲突)。\n// disabled 时也切 Anchor:内建 TOGGLE 无法从外部短路(AT_TARGET 阶段监听器按注册顺序\n// 执行、capture 无优先级),不渲染 Trigger 是唯一可靠方式 ——\nconst useNativeTrigger = computed(() => props.trigger === \"click\" && !props.disabled);\n\n// —— Anchor 模式的手动 aria 接线(补偿放弃 Trigger 的自动接线)——\n// —— ids 全量覆盖(无冒号)详注见 useOverlayIds(wujie patch getElementById\n// 对 zag 缺省冒号 id `popover:{id}:*` 每次查询抛 SyntaxError 刷警告);\n// trigger 为静态 id,仅支持单触发器(本 wrapper 只渲染单个 Trigger/Anchor)——\nconst { ids: rootIds, resolveId } = useOverlayIds(attrs, {\n primary: \"content\",\n parts: [\n \"content\",\n \"title\",\n \"description\",\n \"anchor\",\n \"trigger\",\n \"closeTrigger\",\n \"positioner\",\n \"arrow\",\n ],\n});\nconst anchorAria = computed(() =>\n useNativeTrigger.value\n ? {}\n : {\n \"aria-haspopup\": \"dialog\" as const,\n \"aria-expanded\": isOpen.value,\n \"aria-controls\": resolveId(\"content\"), // user 覆盖优先,与面板实际 id 一致\n },\n);\n\n// —— 延迟桥接(hover/focus):单一定时器,进入取消关闭、离开取消打开 ——\nlet timer: ReturnType<typeof setTimeout> | null = null;\nconst clearTimer = () => {\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n};\nconst schedule = (next: boolean, delay: number) => {\n if (props.disabled) return;\n clearTimer();\n if (delay <= 0) {\n setOpen(next);\n return;\n }\n timer = setTimeout(() => {\n timer = null;\n if (!props.disabled) setOpen(next);\n }, delay);\n};\n\nconst isHoverFocus = () => props.trigger === \"hover\" || props.trigger === \"focus\";\n\nconst onTriggerEnter = () => {\n if (!isHoverFocus()) return;\n schedule(true, props.openDelay);\n};\nconst onTriggerLeave = () => {\n if (!isHoverFocus()) return;\n schedule(false, props.closeDelay);\n};\n// 面板悬浮/聚焦保活(keep-alive 语义):仅取消挂起的关闭计时\nconst onPanelEnter = () => {\n if (!isHoverFocus() || !props.keepAliveOnHover) return;\n clearTimer();\n};\n// 离开面板(去往触发器以外的地方)也应关闭:覆盖 trigger→panel→outside 链路\nconst onPanelLeave = () => {\n if (!isHoverFocus()) return;\n schedule(false, props.closeDelay);\n};\n\nonBeforeUnmount(clearTimer);\n\n// side/align → Ark positioning.placement(12 方位,居中不带对齐后缀);\n// 外部经 attrs 传入的 positioning 已显式指定 placement 时以其为准,其余字段原样合并。\n// iframe realm 下 strategy 默认 fixed(absolute 包含块错位修正),机制详注见\n// withSandboxStrategy / overlay-shared/sandbox.ts —— 沙箱修复的公共层抽离\nconst rootPositioning = computed<ArkPositioning>(() => {\n const user = (attrs.positioning ?? {}) as ArkPositioning;\n const placement = (\n props.align === \"center\" ? props.side : `${props.side}-${props.align}`\n ) as ArkPlacement;\n return withSandboxStrategy(user, {\n ...user,\n placement,\n sameWidth: props.matchTriggerWidth || user.sameWidth,\n });\n});\n\n// 面板样式:内置类 + contentClass + contentProps.class 三方合并(twMerge 自动去冲突,后者优先)\nconst contentClass = computed(() =>\n cn(\n \"bg-popover text-popover-foreground z-[var(--z-modal,60)] w-72 rounded-md border p-4 shadow-md outline-none data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95\",\n props.contentClass,\n props.contentProps?.[\"class\"] as ClassValue,\n ),\n);\n\n// 箭头:尺寸/底色经 CSS 变量交给 zag 内联样式(arrowTip 自动取 --arrow-background 上色)\nconst arrowClass = computed(() =>\n cn(\"[--arrow-size:10px] [--arrow-background:var(--popover)]\", props.arrowClass),\n);\n\n// zIndex prop 走内联 style(Tailwind 任意值类不适合动态拼接);未传保持默认层级类\nconst positionerClass = computed(() => (props.zIndex != null ? \"\" : \"z-[var(--z-modal,60)]\"));\nconst positionerStyle = computed(() =>\n props.zIndex != null ? { zIndex: props.zIndex } : undefined,\n);\n</script>\n\n<template>\n <ArkPopover.Root\n v-bind=\"attrs\"\n :open=\"isOpen\"\n :positioning=\"rootPositioning\"\n :ids=\"rootIds\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <!-- click 且未禁用:内建 Trigger,行为/aria 与旧版完全一致 -->\n <ArkPopover.Trigger v-if=\"useNativeTrigger\" as-child>\n <slot />\n </ArkPopover.Trigger>\n\n <!-- hover/focus/manual 或 disabled:Anchor + 自绑监听 + 手动 aria -->\n <ArkPopover.Anchor\n v-else-if=\"slots.default\"\n as-child\n v-bind=\"anchorAria\"\n @mouseenter=\"onTriggerEnter\"\n @mouseleave=\"onTriggerLeave\"\n @focusin=\"onTriggerEnter\"\n @focusout=\"onTriggerLeave\"\n >\n <slot />\n </ArkPopover.Anchor>\n\n <!-- portal:Teleport(Ark Vue 原语不自带传送,浮层定位不受嵌套 overflow 裁剪影响);\n portal=false 时 disabled Teleport 面板留在原地;to 显式指定目标,\n 缺省时真 shadow DOM(getRootNode 检测)与 wujie graft(marker 检测)沙箱\n 自动降级为应用挂载容器,避免传送出 shadow root -->\n <Teleport :to=\"teleportTarget\" :disabled=\"!props.portal\">\n <ArkPopover.Positioner :class=\"positionerClass\" :style=\"positionerStyle\">\n <ArkPopover.Content\n v-bind=\"props.contentProps\"\n :class=\"contentClass\"\n @mouseenter=\"onPanelEnter\"\n @mouseleave=\"onPanelLeave\"\n @focusin=\"onPanelEnter\"\n @focusout=\"onPanelLeave\"\n >\n <ArkPopover.Arrow v-if=\"props.arrow\" :class=\"arrowClass\">\n <ArkPopover.ArrowTip />\n </ArkPopover.Arrow>\n <slot name=\"header\" />\n <slot name=\"content\" />\n <slot name=\"footer\" />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </Teleport>\n </ArkPopover.Root>\n</template>\n"
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.8",
4
+ "version": "0.5.10",
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.8",
4
+ "version": "0.5.10",
5
5
  "type": "registry:ui",
6
6
  "description": "单选组:基于 Ark UI Radio Group 原语,键盘导航与受控/非受控双模式。",
7
7
  "registryDependencies": ["utils"],