@tu-design/vue 0.5.2 → 0.5.5

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 +533 -181
  2. package/dist/index.mjs +790 -264
  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 +1 -1
  13. package/dist/registry/vue/context-menu.json +3 -3
  14. package/dist/registry/vue/currency-input.json +1 -1
  15. package/dist/registry/vue/date-picker.json +2 -2
  16. package/dist/registry/vue/date-range-picker.json +2 -2
  17. package/dist/registry/vue/date-shared.json +8 -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 +2 -2
  21. package/dist/registry/vue/empty.json +1 -1
  22. package/dist/registry/vue/form-render.json +6 -6
  23. package/dist/registry/vue/form.json +1 -1
  24. package/dist/registry/vue/icon-shared.json +1 -1
  25. package/dist/registry/vue/input.json +1 -1
  26. package/dist/registry/vue/label.json +1 -1
  27. package/dist/registry/vue/month-picker.json +2 -2
  28. package/dist/registry/vue/number-input.json +1 -1
  29. package/dist/registry/vue/overlay-shared.json +19 -1
  30. package/dist/registry/vue/password-input.json +1 -1
  31. package/dist/registry/vue/pin-input.json +1 -1
  32. package/dist/registry/vue/popconfirm.json +1 -1
  33. package/dist/registry/vue/popover.json +2 -2
  34. package/dist/registry/vue/progress.json +1 -1
  35. package/dist/registry/vue/radio-group.json +1 -1
  36. package/dist/registry/vue/registry.json +52 -52
  37. package/dist/registry/vue/select.json +2 -2
  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 +5 -5
  45. package/dist/registry/vue/tabs.json +1 -1
  46. package/dist/registry/vue/textarea.json +1 -1
  47. package/dist/registry/vue/timeline.json +1 -1
  48. package/dist/registry/vue/toast.json +1 -1
  49. package/dist/registry/vue/tokens.json +2 -2
  50. package/dist/registry/vue/tooltip.json +2 -2
  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 +2 -2
  55. package/dist/registry/vue/year-picker.json +2 -2
  56. package/package.json +2 -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.2",
4
+ "version": "0.5.5",
5
5
  "type": "registry:ui",
6
6
  "description": "配置驱动表单渲染器:defineForm 聚合 TanStack Form 实例与字段配置,柯里化 widget DSL 声明控件,Tailwind 栅格自适应布局,复用 Form 家族 aria 接线。",
7
7
  "registryDependencies": [
@@ -33,7 +33,7 @@
33
33
  "path": "form-render/FormRender.vue",
34
34
  "type": "registry:component",
35
35
  "target": "components/ui/form-render/FormRender.vue",
36
- "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport type {\n FormRenderDefinition,\n FormRenderFormApi,\n FormRenderItem,\n WidgetRenderReturn,\n} from \"./types\";\nimport { computed, provide, ref } from \"vue\";\nimport { Button } from \"@/components/ui/button\";\nimport { FORM_KEY } from \"@/components/ui/form/context\";\nimport { cn } from \"@/lib/utils\";\nimport FormRenderField from \"./FormRenderField.vue\";\nimport { widgetRenders } from \"./widgets\";\n\n// boolean flags 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false,\"缺省跟随 searchable\" 语义失效;Checkbox/Dialog 同款约定)\nconst props = defineProps({\n /** 聚合式(推荐):defineForm 返回的定义对象 */\n definition: { type: Object as PropType<FormRenderDefinition<any>> },\n /** 拆分式:与 <Form :form> 模式兼容(与 definition 二选一,definition 优先) */\n form: { type: Object as PropType<FormRenderFormApi> },\n items: { type: Array as PropType<FormRenderItem<any>[]> },\n searchable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n submitable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 缺省跟随 searchable */\n resetable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 缺省跟随 submitable */\n cancelable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n searchText: { type: String },\n submitText: { type: String },\n resetText: { type: String },\n /** 栅格最小列宽 px(auto-fill 自适应列数) */\n minWidth: { type: Number },\n});\n\nconst emit = defineEmits<{\n search: [];\n submit: [];\n reset: [];\n cancel: [];\n}>();\n\nconst instance = props.definition?.form ?? props.form;\nconst items = computed(() => props.definition?.items ?? props.items ?? []);\n\nif (import.meta.env.DEV && !instance) {\n console.warn(\n \"[tu-design] <FormRender> 需要 definition 或 form + items(definition/form 不支持运行时切换)\",\n );\n}\n\n// S2:FormField 依赖 inject(FORM_KEY),本组件替代 <Form> 的 provide 职责\nprovide(FORM_KEY, instance as never);\n\n// S1:form.state 非响应式,响应式 values 只能经 useSelector 订阅建立;\n// visible 过滤与 WidgetContext.values 一律消费它,渲染路径禁读 form.state.*\nconst valuesRef = instance\n ? instance.useSelector((s: any) => s.values)\n : ref<Record<string, unknown>>({});\n\nconst r = widgetRenders<any>();\n\nfunction widgetOf(item: FormRenderItem<any>): WidgetRenderReturn<any> {\n return item.render ? item.render(r) : r.input();\n}\n\nconst visibleItems = computed(() =>\n items.value.filter((item) =>\n typeof item.visible === \"function\"\n ? item.visible(valuesRef.value as never)\n : item.visible !== false,\n ),\n);\n\nconst gridStyle = computed(() => ({\n gridTemplateColumns: `repeat(auto-fill, minmax(${props.minWidth ?? 320}px, 1fr))`,\n}));\n\nfunction spanStyle(span?: number | \"full\") {\n if (span === \"full\") return { gridColumn: \"1 / -1\" };\n if (typeof span === \"number\") return { gridColumn: `span ${span}` };\n return undefined;\n}\n\nconst showReset = computed(() => props.resetable ?? !!props.searchable);\nconst showCancel = computed(() => props.cancelable ?? !!props.submitable);\nconst showActions = computed(\n () => props.searchable || props.submitable || showReset.value || showCancel.value,\n);\n\n/** I4:校验失败时 isFieldsValid=false,不 emit;成功后才 emit(事件回调中一次性读取不受 S1 限制) */\nasync function submit(mode: \"search\" | \"submit\") {\n if (!instance) return;\n await instance.handleSubmit();\n if (instance.state.isFieldsValid) {\n if (mode === \"search\") emit(\"search\");\n else emit(\"submit\");\n }\n}\n\nfunction onReset() {\n if (props.definition) {\n props.definition.resetToDefaults();\n } else {\n instance?.reset();\n }\n emit(\"reset\");\n}\n\ndefineExpose({\n form: instance,\n items,\n resetToDefaults: () =>\n props.definition ? props.definition.resetToDefaults() : instance?.reset(),\n});\n</script>\n\n<template>\n <div :class=\"cn('grid gap-4', $attrs.class)\" :style=\"gridStyle\">\n <div v-for=\"item in visibleItems\" :key=\"String(item.key)\" :style=\"spanStyle(item.span)\">\n <FormRenderField :item=\"item\" :widget=\"widgetOf(item)\" :values=\"valuesRef\" />\n </div>\n <div v-if=\"showActions\" class=\"col-span-full flex justify-end gap-2\">\n <slot name=\"actions\">\n <Button v-if=\"searchable\" @click=\"submit('search')\">\n {{ searchText ?? \"搜索\" }}\n </Button>\n <Button v-if=\"showReset\" variant=\"outline\" @click=\"onReset\">\n {{ resetText ?? \"重置\" }}\n </Button>\n <Button v-if=\"submitable\" @click=\"submit('submit')\">\n {{ submitText ?? \"提交\" }}\n </Button>\n <Button v-if=\"showCancel\" variant=\"outline\" @click=\"emit('cancel')\"> 取消 </Button>\n </slot>\n </div>\n </div>\n</template>\n"
36
+ "content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport type {\n FormRenderDefinition,\n FormRenderFormApi,\n FormRenderItem,\n WidgetRenderReturn,\n} from \"./types\";\nimport { computed, provide, ref } from \"vue\";\nimport { Button } from \"@/components/ui/button\";\nimport { FORM_KEY } from \"@/components/ui/form/context\";\nimport { cn } from \"@/lib/utils\";\nimport FormRenderField from \"./FormRenderField.vue\";\nimport { widgetRenders } from \"./widgets\";\n\n// boolean flags 用运行时声明 + default: undefined 禁用 Vue 的 Boolean casting\n// (casting 会让未传的 prop 变 false,\"缺省跟随 searchable\" 语义失效;Checkbox/Dialog 同款约定)\nconst props = defineProps({\n /** 聚合式(推荐):defineForm 返回的定义对象 */\n definition: { type: Object as PropType<FormRenderDefinition<any>> },\n /** 拆分式:与 <Form :form> 模式兼容(与 definition 二选一,definition 优先) */\n form: { type: Object as PropType<FormRenderFormApi> },\n items: { type: Array as PropType<FormRenderItem<any>[]> },\n searchable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n submitable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 缺省跟随 searchable */\n resetable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 缺省跟随 submitable */\n cancelable: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n searchText: { type: String },\n submitText: { type: String },\n resetText: { type: String },\n /** 栅格最小列宽 px(auto-fill 自适应列数) */\n minWidth: { type: Number },\n});\n\nconst emit = defineEmits<{\n search: [];\n submit: [];\n reset: [];\n cancel: [];\n}>();\n\nconst instance = props.definition?.form ?? props.form;\nconst items = computed(() => props.definition?.items ?? props.items ?? []);\n\nif (import.meta.env.DEV && !instance) {\n console.warn(\n \"[tu-design] <FormRender> 需要 definition 或 form + items(definition/form 不支持运行时切换)\",\n );\n}\n\n// S2:FormField 依赖 inject(FORM_KEY),本组件替代 <Form> 的 provide 职责\nprovide(FORM_KEY, instance as never);\n\n// S1:form.state 非响应式,响应式 values 只能经 useSelector 订阅建立;\n// visible 过滤与 WidgetContext.values 一律消费它,渲染路径禁读 form.state.*\nconst valuesRef = instance\n ? instance.useSelector((s: any) => s.values)\n : ref<Record<string, unknown>>({});\n\nconst r = widgetRenders<any>();\n\nfunction widgetOf(item: FormRenderItem<any>): WidgetRenderReturn<any> {\n return item.render ? item.render(r) : r.input();\n}\n\nconst visibleItems = computed(() =>\n items.value.filter((item) =>\n typeof item.visible === \"function\"\n ? item.visible(valuesRef.value as never)\n : item.visible !== false,\n ),\n);\n\nconst gridStyle = computed(() => ({\n gridTemplateColumns: `repeat(auto-fill, minmax(${props.minWidth ?? 320}px, 1fr))`,\n}));\n\nfunction spanStyle(span?: number | \"full\") {\n if (span === \"full\") return { gridColumn: \"1 / -1\" };\n if (typeof span === \"number\") return { gridColumn: `span ${span}` };\n return undefined;\n}\n\n// ---- 按钮解析(A1 块级互斥):definition.actions 存在 → 七项全量 actions 域解析,props 域不参与;\n// actions 未配置 → 现状 props 域解析(含缺省跟随),行为逐字节不变\nconst actions = props.definition?.actions;\nconst searchable = computed(() => (actions ? actions.searchable : props.searchable) ?? false);\nconst submitable = computed(() => (actions ? actions.submitable : props.submitable) ?? false);\nconst showReset = computed(\n () => (actions ? actions.resetable : props.resetable) ?? !!searchable.value,\n);\nconst showCancel = computed(\n () => (actions ? actions.cancelable : props.cancelable) ?? !!submitable.value,\n);\nconst showActions = computed(\n () => searchable.value || submitable.value || showReset.value || showCancel.value,\n);\nconst resolvedSearchText = computed(\n () => (actions ? actions.searchText : props.searchText) ?? \"搜索\",\n);\nconst resolvedSubmitText = computed(\n () => (actions ? actions.submitText : props.submitText) ?? \"提交\",\n);\nconst resolvedResetText = computed(() => (actions ? actions.resetText : props.resetText) ?? \"重置\");\n\n// A6:actions 存在且显式传了任一按钮 prop → definition 优先,DEV 警告一次\n// (actions 存在 + props 全缺省是正常用法——如 TableRender 内置区经条件传递不传 searchable——不告警)\nif (import.meta.env.DEV && actions) {\n const provided =\n props.searchable !== undefined ||\n props.submitable !== undefined ||\n props.resetable !== undefined ||\n props.cancelable !== undefined ||\n props.searchText !== undefined ||\n props.submitText !== undefined ||\n props.resetText !== undefined;\n if (provided) {\n console.warn(\n \"[tu-design] <FormRender> definition.actions 与按钮 props 同传,已按 actions 渲染。\",\n );\n }\n}\n\n/** I4:校验失败时 isFieldsValid=false,不 emit;成功后才 emit(事件回调中一次性读取不受 S1 限制)。\n * 校验语义单点化(R30):definition 存在时复用 definition.submit();拆分式 :form + :items 走内联逻辑 */\nasync function submit(mode: \"search\" | \"submit\") {\n if (!instance) return;\n let valid: boolean;\n if (props.definition) {\n valid = await props.definition.submit();\n } else {\n await instance.handleSubmit();\n valid = instance.state.isFieldsValid;\n }\n if (!valid) return;\n if (mode === \"search\") emit(\"search\");\n else emit(\"submit\");\n}\n\nfunction onReset() {\n if (props.definition) {\n props.definition.resetToDefaults();\n } else {\n instance?.reset();\n }\n emit(\"reset\");\n}\n\ndefineExpose({\n form: instance,\n items,\n resetToDefaults: () =>\n props.definition ? props.definition.resetToDefaults() : instance?.reset(),\n});\n</script>\n\n<template>\n <div :class=\"cn('grid gap-4', $attrs.class)\" :style=\"gridStyle\">\n <div v-for=\"item in visibleItems\" :key=\"String(item.key)\" :style=\"spanStyle(item.span)\">\n <FormRenderField :item=\"item\" :widget=\"widgetOf(item)\" :values=\"valuesRef\" />\n </div>\n <div v-if=\"showActions\" class=\"col-span-full flex justify-end gap-2\">\n <slot name=\"actions\">\n <Button v-if=\"searchable\" @click=\"submit('search')\">\n {{ resolvedSearchText }}\n </Button>\n <Button v-if=\"showReset\" variant=\"outline\" @click=\"onReset\">\n {{ resolvedResetText }}\n </Button>\n <Button v-if=\"submitable\" @click=\"submit('submit')\">\n {{ resolvedSubmitText }}\n </Button>\n <Button v-if=\"showCancel\" variant=\"outline\" @click=\"emit('cancel')\"> 取消 </Button>\n </slot>\n </div>\n </div>\n</template>\n"
37
37
  },
38
38
  {
39
39
  "path": "form-render/FormRenderField.vue",
@@ -45,25 +45,25 @@
45
45
  "path": "form-render/define-form.ts",
46
46
  "type": "registry:lib",
47
47
  "target": "components/ui/form-render/define-form.ts",
48
- "content": "import { useFormRender, type UseFormRenderOptions } from \"./useFormRender\";\nimport type { FormRenderDefinition, FormRenderItem } from \"./types\";\n\nexport interface DefineFormOptions<T extends object> {\n items: FormRenderItem<T>[];\n /** Standard Schema(valibot v.object 输出直接兼容),映射到 TanStack validators.onSubmit */\n schema?: unknown;\n onSubmit?: (ctx: { value: T }) => void | Promise<void>;\n /** 其余 TanStack useForm 选项透传(如 onSubmitInvalid) */\n formOptions?: Record<string, unknown>;\n}\n\n/**\n * 聚合入口:单次调用完成「字段定义 + 类型约束 + 表单实例」。\n *\n * 返回 `{ items, form, resetToDefaults }`:\n * - `items` / `form` 传给 `<FormRender>`(支持 `:definition` 单 prop 或 `:form` + `:items` 拆分);\n * - `form` 可直接 `reset()` / `validate()` / `handleSubmit()`;\n * - `resetToDefaults()` 重置到 `items.default`(搜索表单\"重置\"语义)。\n *\n * 须在组件 setup 中调用(TanStack useForm 约束)。\n */\nexport function defineForm<T extends object>(\n config: DefineFormOptions<T>,\n): FormRenderDefinition<T> {\n return useFormRender<T>(config satisfies UseFormRenderOptions<T>);\n}\n"
48
+ "content": "import { useFormRender, type UseFormRenderOptions } from \"./useFormRender\";\nimport type { FormRenderDefinition, FormRenderItem } from \"./types\";\n\nexport interface DefineFormOptions<T extends object> {\n items: FormRenderItem<T>[];\n /** Standard Schema(valibot v.object 输出直接兼容),映射到 TanStack validators.onSubmit */\n schema?: unknown;\n onSubmit?: (ctx: { value: T }) => void | Promise<void>;\n /** 按钮预设七项(A1 块级互斥):显式传任一项即投影为 definition.actions,组件按钮 props 全量忽略 */\n searchable?: boolean;\n submitable?: boolean;\n resetable?: boolean;\n cancelable?: boolean;\n searchText?: string;\n submitText?: string;\n resetText?: string;\n /** 其余 TanStack useForm 选项透传(如 onSubmitInvalid) */\n formOptions?: Record<string, unknown>;\n}\n\n/**\n * 聚合入口:单次调用完成「字段定义 + 类型约束 + 表单实例 + 按钮预设」。\n *\n * 返回 `{ items, form, resetToDefaults, submit, actions? }`:\n * - `items` / `form` 传给 `<FormRender>`(支持 `:definition` 单 prop 或 `:form` + `:items` 拆分);\n * - `form` 可直接 `reset()` / `validate()` / `handleSubmit()`;\n * - `resetToDefaults()` 重置到 `items.default`(搜索表单\"重置\"语义);\n * - `submit()` 全量校验并返回是否通过(R30,组合式查询链路);\n * - `actions` 按钮预设(searchable 等七项直传):存在时 `<FormRender>` 组件按钮 props 全量忽略(A1 块级互斥)。\n *\n * 须在组件 setup 中调用(TanStack useForm 约束)。\n */\nexport function defineForm<T extends object>(\n config: DefineFormOptions<T>,\n): FormRenderDefinition<T> {\n return useFormRender<T>(config satisfies UseFormRenderOptions<T>);\n}\n"
49
49
  },
50
50
  {
51
51
  "path": "form-render/index.ts",
52
52
  "type": "registry:lib",
53
53
  "target": "components/ui/form-render/index.ts",
54
- "content": "export { default as FormRender } from \"./FormRender.vue\";\nexport { defineForm, type DefineFormOptions } from \"./define-form\";\nexport { useFormRender, type UseFormRenderOptions } from \"./useFormRender\";\nexport { widgetRenders } from \"./widgets\";\nexport { bindField, CHECKED, MODEL_VALUE, SLIDER, VALUE, type BindingSpec } from \"./widgets/bind\";\nexport type {\n CheckboxWidgetOptions,\n CurrencyWidgetOptions,\n DatePickerWidgetOptions,\n DateRangeWidgetOptions,\n FormRenderDefinition,\n FormRenderFormApi,\n FormRenderItem,\n InputWidgetOptions,\n MonthPickerWidgetOptions,\n NumberWidgetOptions,\n PasswordWidgetOptions,\n RadioGroupWidgetOptions,\n SelectWidgetOptions,\n SfcOptions,\n SliderWidgetOptions,\n SwitchWidgetOptions,\n TextareaWidgetOptions,\n WidgetContext,\n WidgetItemOption,\n WidgetRenderReturn,\n WidgetRenders,\n YearPickerWidgetOptions,\n} from \"./types\";\n"
54
+ "content": "export { default as FormRender } from \"./FormRender.vue\";\nexport { defineForm, type DefineFormOptions } from \"./define-form\";\nexport { useFormRender, type UseFormRenderOptions } from \"./useFormRender\";\nexport { widgetRenders } from \"./widgets\";\nexport { bindField, CHECKED, MODEL_VALUE, SLIDER, VALUE, type BindingSpec } from \"./widgets/bind\";\nexport type {\n CheckboxWidgetOptions,\n CurrencyWidgetOptions,\n DatePickerWidgetOptions,\n DateRangeWidgetOptions,\n FormActionsConfig,\n FormRenderDefinition,\n FormRenderFormApi,\n FormRenderItem,\n InputWidgetOptions,\n MonthPickerWidgetOptions,\n NumberWidgetOptions,\n PasswordWidgetOptions,\n RadioGroupWidgetOptions,\n SelectWidgetOptions,\n SfcOptions,\n SliderWidgetOptions,\n SwitchWidgetOptions,\n TextareaWidgetOptions,\n WidgetContext,\n WidgetItemOption,\n WidgetRenderReturn,\n WidgetRenders,\n YearPickerWidgetOptions,\n} from \"./types\";\n"
55
55
  },
56
56
  {
57
57
  "path": "form-render/types.ts",
58
58
  "type": "registry:lib",
59
59
  "target": "components/ui/form-render/types.ts",
60
- "content": "import type { AnyFieldApi, FormApi, VueFormApi } from \"@tanstack/vue-form\";\nimport type { VNode } from \"vue\";\nimport type { Checkbox } from \"@/components/ui/checkbox\";\nimport type { CurrencyInput } from \"@/components/ui/currency-input\";\nimport type { DatePicker } from \"@/components/ui/date-picker\";\nimport type { DateRangePicker } from \"@/components/ui/date-range-picker\";\nimport type { Input } from \"@/components/ui/input\";\nimport type { MonthPicker } from \"@/components/ui/month-picker\";\nimport type { WeekPicker } from \"@/components/ui/week-picker\";\nimport type { NumberInput } from \"@/components/ui/number-input\";\nimport type { PasswordInput } from \"@/components/ui/password-input\";\nimport type { RadioGroup } from \"@/components/ui/radio-group\";\nimport type { Cascader } from \"@/components/ui/cascader\";\nimport type { TreeSelect } from \"@/components/ui/tree-select\";\nimport type { Select } from \"@/components/ui/select\";\nimport type { Slider } from \"@/components/ui/slider\";\nimport type { Switch } from \"@/components/ui/switch\";\nimport type { Textarea } from \"@/components/ui/textarea\";\nimport type { YearPicker } from \"@/components/ui/year-picker\";\nimport type { SelectItemOption } from \"@/components/ui/select\";\n\n/**\n * useForm() 返回实例的宽松形态(与 form/context.ts 的 FormInstance 同款契约:\n * provide/inject 与跨组件边界会擦除泛型,any 化是项目既定约定)。\n */\n/* prettier-ignore */\nexport type FormRenderFormApi =\n FormApi<any, any, any, any, any, any, any, any, any, any, any, any> &\n VueFormApi<any, any, any, any, any, any, any, any, any, any, any, any>;\n\n/** 字段渲染上下文(widget 柯里化第二段的唯一参数) */\nexport interface WidgetContext<T extends object> {\n field: AnyFieldApi;\n item: FormRenderItem<T>;\n /** 当前全量表单值(响应式,来自 form.useSelector(s => s.values);联动用) */\n values: T;\n}\n\nexport type WidgetRenderReturn<T extends object> = (ctx: WidgetContext<T>) => VNode;\n\n/** select/radioGroup 等选项的通用形态(字符串简写或 { label, value }) */\nexport type WidgetItemOption = string | SelectItemOption;\n\n/**\n * SFC props 类型派生(方案 C):widget 参数 = 原组件全部 props(命名穿透,\n * prop 变更时类型自动同步)。受控字段由 bindField/FormControl/items.default\n * 接管,用户不可传;Omit 不存在的键是 no-op,统一集合即可。\n */\ntype ControlledKey =\n | \"modelValue\"\n | \"onUpdate:modelValue\"\n | \"checked\"\n | \"onUpdate:checked\"\n | \"value\"\n | \"onUpdate:value\"\n | \"onBlur\"\n | \"invalid\"\n | \"class\"\n | \"id\"\n | \"defaultValue\"\n | \"defaultChecked\";\n\nexport type SfcOptions<T extends abstract new (...args: any) => any> = Partial<\n Omit<InstanceType<T>[\"$props\"], ControlledKey>\n>;\n\n// —— 各 widget 选项:组件全 props 派生(命名穿透) ——\n\nexport type NumberWidgetOptions = SfcOptions<typeof NumberInput>;\n\nexport type CurrencyWidgetOptions = SfcOptions<typeof CurrencyInput>;\n\n/** autoComplete 为 PasswordInput 真实 prop(探针实证),直接派生获得 */\nexport type PasswordWidgetOptions = SfcOptions<typeof PasswordInput>;\n\n/** Input 自身无 placeholder/type prop(原生 attr 透传),交叉手写 */\nexport type InputWidgetOptions = SfcOptions<typeof Input> & {\n placeholder?: string;\n type?: string;\n};\n\n/** Textarea 自身无 placeholder/rows prop(原生 attr 透传),交叉手写 */\nexport type TextareaWidgetOptions = SfcOptions<typeof Textarea> & {\n placeholder?: string;\n rows?: number;\n};\n\n/**\n * v3 命名穿透:选项字段即组件 prop 名 `items`——显式必填(Partial 化会退化为可选,\n * 缺失时 Select.vue collection 计算在首渲染崩溃);placeholder 已是 Select 单组件\n * 的正式 prop,不再 Omit,渲染时做 item 级缺省回退(I1)。\n */\nexport type SelectWidgetOptions = Omit<SfcOptions<typeof Select>, \"items\"> & {\n items: WidgetItemOption[];\n};\n\nexport type CheckboxWidgetOptions = SfcOptions<typeof Checkbox>;\n\nexport type SwitchWidgetOptions = SfcOptions<typeof Switch>;\n\n/**\n * radioGroup widget:单选组(值 prop 为 value)。items 为组件 required prop,\n * 显式必填(Partial 化会退化为可选);选项字段与组件 prop 同名(命名穿透)。\n * 注意:RadioGroup 不支持 Select 的字符串简写(无 normalize 回退,直传即崩),\n * 此处收窄为 SelectItemOption[] 而非 WidgetItemOption[]。\n */\nexport type RadioGroupWidgetOptions = Omit<SfcOptions<typeof RadioGroup>, \"items\"> & {\n items: SelectItemOption[];\n};\n\n/** TreeSelect / Cascader:选项 prop 原名 options,受控走 modelValue(ControlledKey 自动剔除) */\nexport type TreeSelectWidgetOptions = SfcOptions<typeof TreeSelect>;\n\nexport type CascaderWidgetOptions = SfcOptions<typeof Cascader>;\n\nexport type SliderWidgetOptions = SfcOptions<typeof Slider>;\n\n/** picker 三组件 props 面不同(DatePicker 有 isDateUnavailable/max/min,Month/Year 有 locale),各自派生 */\nexport type DatePickerWidgetOptions = SfcOptions<typeof DatePicker>;\n\nexport type MonthPickerWidgetOptions = SfcOptions<typeof MonthPicker>;\n\nexport type YearPickerWidgetOptions = SfcOptions<typeof YearPicker>;\n\nexport type DateRangeWidgetOptions = SfcOptions<typeof DateRangePicker>;\n\nexport type WeekPickerWidgetOptions = SfcOptions<typeof WeekPicker>;\n\n/**\n * widget 注册表类型契约:实现对象在 widgets/index.ts。\n * 类型集中于此避免循环依赖(type-only import 无运行时环)。\n */\nexport interface WidgetRenders<T extends object> {\n input(o?: InputWidgetOptions): WidgetRenderReturn<T>;\n password(o?: PasswordWidgetOptions): WidgetRenderReturn<T>;\n number(o?: NumberWidgetOptions): WidgetRenderReturn<T>;\n currency(o?: CurrencyWidgetOptions): WidgetRenderReturn<T>;\n textarea(o?: TextareaWidgetOptions): WidgetRenderReturn<T>;\n select(o: SelectWidgetOptions): WidgetRenderReturn<T>;\n checkbox(o?: CheckboxWidgetOptions): WidgetRenderReturn<T>;\n switch(o?: SwitchWidgetOptions): WidgetRenderReturn<T>;\n radioGroup(o: RadioGroupWidgetOptions): WidgetRenderReturn<T>;\n treeSelect(o: TreeSelectWidgetOptions): WidgetRenderReturn<T>;\n cascader(o: CascaderWidgetOptions): WidgetRenderReturn<T>;\n slider(o?: SliderWidgetOptions): WidgetRenderReturn<T>;\n datePicker(o?: DatePickerWidgetOptions): WidgetRenderReturn<T>;\n monthPicker(o?: MonthPickerWidgetOptions): WidgetRenderReturn<T>;\n yearPicker(o?: YearPickerWidgetOptions): WidgetRenderReturn<T>;\n dateRangePicker(o?: DateRangeWidgetOptions): WidgetRenderReturn<T>;\n weekPicker(o?: WeekPickerWidgetOptions): WidgetRenderReturn<T>;\n /** 逃逸口:完全自定义渲染 */\n render(fn: (ctx: WidgetContext<T>) => VNode): WidgetRenderReturn<T>;\n}\n\nexport interface FormRenderItem<T extends object> {\n /**\n * 字段名:严格 keyof T —— 自动补全 + 拼错编译报错。\n * 额外字段请在 T 中显式声明;运行时以 String(key) 归一为 FormField 的 name。\n */\n key: keyof T;\n title: string;\n description?: string;\n placeholder?: string;\n /**\n * 默认值(值或同步工厂);defineForm 据此派生 defaultValues。\n * 类型为 T 值域联合 T[keyof T](无 per-item 精确联动,强于 x-render 的 any)。\n */\n default?: T[keyof T] | (() => T[keyof T]);\n /** 栅格跨度:数字 = 占 n 列(须 ≤ 实际列数);\"full\" = 整行 */\n span?: number | \"full\";\n /** 联动显隐;消费 FormRender 经 useSelector 建立的响应式 values */\n visible?: boolean | ((values: T) => boolean);\n hideLabel?: boolean;\n class?: string;\n /** TanStack 字段级校验器透传(如 onChangeAsync) */\n validators?: Record<string, unknown>;\n /** widget 描述;缺省 = r.input() */\n render?: (r: WidgetRenders<T>) => WidgetRenderReturn<T>;\n /** 逃逸口:原样合并到控件 vnode 的 props */\n componentProps?: Record<string, unknown>;\n}\n\nexport interface FormRenderDefinition<T extends object> {\n items: FormRenderItem<T>[];\n form: FormRenderFormApi;\n /** 重置到 items.default(搜索表单\"重置\"语义) */\n resetToDefaults: () => void;\n}\n"
60
+ "content": "import type { AnyFieldApi, FormApi, VueFormApi } from \"@tanstack/vue-form\";\nimport type { VNode } from \"vue\";\nimport type { Checkbox } from \"@/components/ui/checkbox\";\nimport type { CurrencyInput } from \"@/components/ui/currency-input\";\nimport type { DatePicker } from \"@/components/ui/date-picker\";\nimport type { DateRangePicker } from \"@/components/ui/date-range-picker\";\nimport type { Input } from \"@/components/ui/input\";\nimport type { MonthPicker } from \"@/components/ui/month-picker\";\nimport type { WeekPicker } from \"@/components/ui/week-picker\";\nimport type { NumberInput } from \"@/components/ui/number-input\";\nimport type { PasswordInput } from \"@/components/ui/password-input\";\nimport type { RadioGroup } from \"@/components/ui/radio-group\";\nimport type { Cascader } from \"@/components/ui/cascader\";\nimport type { TreeSelect } from \"@/components/ui/tree-select\";\nimport type { Select } from \"@/components/ui/select\";\nimport type { Slider } from \"@/components/ui/slider\";\nimport type { Switch } from \"@/components/ui/switch\";\nimport type { Textarea } from \"@/components/ui/textarea\";\nimport type { YearPicker } from \"@/components/ui/year-picker\";\nimport type { SelectItemOption } from \"@/components/ui/select\";\n\n/**\n * useForm() 返回实例的宽松形态(与 form/context.ts 的 FormInstance 同款契约:\n * provide/inject 与跨组件边界会擦除泛型,any 化是项目既定约定)。\n */\n/* prettier-ignore */\nexport type FormRenderFormApi =\n FormApi<any, any, any, any, any, any, any, any, any, any, any, any> &\n VueFormApi<any, any, any, any, any, any, any, any, any, any, any, any>;\n\n/** 字段渲染上下文(widget 柯里化第二段的唯一参数) */\nexport interface WidgetContext<T extends object> {\n field: AnyFieldApi;\n item: FormRenderItem<T>;\n /** 当前全量表单值(响应式,来自 form.useSelector(s => s.values);联动用) */\n values: T;\n}\n\nexport type WidgetRenderReturn<T extends object> = (ctx: WidgetContext<T>) => VNode;\n\n/** select/radioGroup 等选项的通用形态(字符串简写或 { label, value }) */\nexport type WidgetItemOption = string | SelectItemOption;\n\n/**\n * SFC props 类型派生(方案 C):widget 参数 = 原组件全部 props(命名穿透,\n * prop 变更时类型自动同步)。受控字段由 bindField/FormControl/items.default\n * 接管,用户不可传;Omit 不存在的键是 no-op,统一集合即可。\n */\ntype ControlledKey =\n | \"modelValue\"\n | \"onUpdate:modelValue\"\n | \"checked\"\n | \"onUpdate:checked\"\n | \"value\"\n | \"onUpdate:value\"\n | \"onBlur\"\n | \"invalid\"\n | \"class\"\n | \"id\"\n | \"defaultValue\"\n | \"defaultChecked\";\n\nexport type SfcOptions<T extends abstract new (...args: any) => any> = Partial<\n Omit<InstanceType<T>[\"$props\"], ControlledKey>\n>;\n\n// —— 各 widget 选项:组件全 props 派生(命名穿透) ——\n\nexport type NumberWidgetOptions = SfcOptions<typeof NumberInput>;\n\nexport type CurrencyWidgetOptions = SfcOptions<typeof CurrencyInput>;\n\n/** autoComplete 为 PasswordInput 真实 prop(探针实证),直接派生获得 */\nexport type PasswordWidgetOptions = SfcOptions<typeof PasswordInput>;\n\n/** Input 自身无 placeholder/type prop(原生 attr 透传),交叉手写 */\nexport type InputWidgetOptions = SfcOptions<typeof Input> & {\n placeholder?: string;\n type?: string;\n};\n\n/** Textarea 自身无 placeholder/rows prop(原生 attr 透传),交叉手写 */\nexport type TextareaWidgetOptions = SfcOptions<typeof Textarea> & {\n placeholder?: string;\n rows?: number;\n};\n\n/**\n * v3 命名穿透:选项字段即组件 prop 名 `items`——显式必填(Partial 化会退化为可选,\n * 缺失时 Select.vue collection 计算在首渲染崩溃);placeholder 已是 Select 单组件\n * 的正式 prop,不再 Omit,渲染时做 item 级缺省回退(I1)。\n */\nexport type SelectWidgetOptions = Omit<SfcOptions<typeof Select>, \"items\"> & {\n items: WidgetItemOption[];\n};\n\nexport type CheckboxWidgetOptions = SfcOptions<typeof Checkbox>;\n\nexport type SwitchWidgetOptions = SfcOptions<typeof Switch>;\n\n/**\n * radioGroup widget:单选组(值 prop 为 value)。items 为组件 required prop,\n * 显式必填(Partial 化会退化为可选);选项字段与组件 prop 同名(命名穿透)。\n * 注意:RadioGroup 不支持 Select 的字符串简写(无 normalize 回退,直传即崩),\n * 此处收窄为 SelectItemOption[] 而非 WidgetItemOption[]。\n */\nexport type RadioGroupWidgetOptions = Omit<SfcOptions<typeof RadioGroup>, \"items\"> & {\n items: SelectItemOption[];\n};\n\n/** TreeSelect / Cascader:选项 prop 原名 options,受控走 modelValue(ControlledKey 自动剔除) */\nexport type TreeSelectWidgetOptions = SfcOptions<typeof TreeSelect>;\n\nexport type CascaderWidgetOptions = SfcOptions<typeof Cascader>;\n\nexport type SliderWidgetOptions = SfcOptions<typeof Slider>;\n\n/** picker 三组件 props 面不同(DatePicker 有 isDateUnavailable/max/min,Month/Year 有 locale),各自派生 */\nexport type DatePickerWidgetOptions = SfcOptions<typeof DatePicker>;\n\nexport type MonthPickerWidgetOptions = SfcOptions<typeof MonthPicker>;\n\nexport type YearPickerWidgetOptions = SfcOptions<typeof YearPicker>;\n\nexport type DateRangeWidgetOptions = SfcOptions<typeof DateRangePicker>;\n\nexport type WeekPickerWidgetOptions = SfcOptions<typeof WeekPicker>;\n\n/**\n * widget 注册表类型契约:实现对象在 widgets/index.ts。\n * 类型集中于此避免循环依赖(type-only import 无运行时环)。\n */\nexport interface WidgetRenders<T extends object> {\n input(o?: InputWidgetOptions): WidgetRenderReturn<T>;\n password(o?: PasswordWidgetOptions): WidgetRenderReturn<T>;\n number(o?: NumberWidgetOptions): WidgetRenderReturn<T>;\n currency(o?: CurrencyWidgetOptions): WidgetRenderReturn<T>;\n textarea(o?: TextareaWidgetOptions): WidgetRenderReturn<T>;\n select(o: SelectWidgetOptions): WidgetRenderReturn<T>;\n checkbox(o?: CheckboxWidgetOptions): WidgetRenderReturn<T>;\n switch(o?: SwitchWidgetOptions): WidgetRenderReturn<T>;\n radioGroup(o: RadioGroupWidgetOptions): WidgetRenderReturn<T>;\n treeSelect(o: TreeSelectWidgetOptions): WidgetRenderReturn<T>;\n cascader(o: CascaderWidgetOptions): WidgetRenderReturn<T>;\n slider(o?: SliderWidgetOptions): WidgetRenderReturn<T>;\n datePicker(o?: DatePickerWidgetOptions): WidgetRenderReturn<T>;\n monthPicker(o?: MonthPickerWidgetOptions): WidgetRenderReturn<T>;\n yearPicker(o?: YearPickerWidgetOptions): WidgetRenderReturn<T>;\n dateRangePicker(o?: DateRangeWidgetOptions): WidgetRenderReturn<T>;\n weekPicker(o?: WeekPickerWidgetOptions): WidgetRenderReturn<T>;\n /** 逃逸口:完全自定义渲染 */\n render(fn: (ctx: WidgetContext<T>) => VNode): WidgetRenderReturn<T>;\n}\n\nexport interface FormRenderItem<T extends object> {\n /**\n * 字段名:严格 keyof T —— 自动补全 + 拼错编译报错。\n * 额外字段请在 T 中显式声明;运行时以 String(key) 归一为 FormField 的 name。\n */\n key: keyof T;\n title: string;\n description?: string;\n placeholder?: string;\n /**\n * 默认值(值或同步工厂);defineForm 据此派生 defaultValues。\n * 类型为 T 值域联合 T[keyof T](无 per-item 精确联动,强于 x-render 的 any)。\n */\n default?: T[keyof T] | (() => T[keyof T]);\n /** 栅格跨度:数字 = 占 n 列(须 ≤ 实际列数);\"full\" = 整行 */\n span?: number | \"full\";\n /** 联动显隐;消费 FormRender 经 useSelector 建立的响应式 values */\n visible?: boolean | ((values: T) => boolean);\n hideLabel?: boolean;\n class?: string;\n /** TanStack 字段级校验器透传(如 onChangeAsync) */\n validators?: Record<string, unknown>;\n /** widget 描述;缺省 = r.input() */\n render?: (r: WidgetRenders<T>) => WidgetRenderReturn<T>;\n /** 逃逸口:原样合并到控件 vnode 的 props */\n componentProps?: Record<string, unknown>;\n}\n\n/** 按钮预设(A1 块级互斥:actions 存在时 <FormRender> 组件按钮 props 全量忽略) */\nexport interface FormActionsConfig {\n /** 搜索按钮,缺省 false */\n searchable?: boolean;\n /** 提交按钮,缺省 false */\n submitable?: boolean;\n /** 重置按钮;缺省跟随 searchable(A2,域内解析) */\n resetable?: boolean;\n /** 取消按钮;缺省跟随 submitable(A2,域内解析) */\n cancelable?: boolean;\n searchText?: string;\n submitText?: string;\n resetText?: string;\n}\n\nexport interface FormRenderDefinition<T extends object> {\n items: FormRenderItem<T>[];\n form: FormRenderFormApi;\n /** 重置到 items.default(搜索表单\"重置\"语义) */\n resetToDefaults: () => void;\n /** 全量校验并返回是否通过(R30);不触发 FormRender 的 search/submit 事件。\n * 组合式外部查询标准链路:`if (await table.search.submit()) table.reload(true)` */\n submit: () => Promise<boolean>;\n /** 按钮预设投影(引擎从 options 七项直传;未配置为 undefined——此时组件按钮 props 全量生效) */\n actions?: FormActionsConfig;\n}\n"
61
61
  },
62
62
  {
63
63
  "path": "form-render/useFormRender.ts",
64
64
  "type": "registry:lib",
65
65
  "target": "components/ui/form-render/useFormRender.ts",
66
- "content": "import { useForm } from \"@tanstack/vue-form\";\nimport type { FormRenderDefinition, FormRenderItem } from \"./types\";\n\nexport interface UseFormRenderOptions<T extends object> {\n items: FormRenderItem<T>[];\n /** Standard Schema(valibot v.object 输出直接兼容),映射到 TanStack validators.onSubmit */\n schema?: unknown;\n onSubmit?: (ctx: { value: T }) => void | Promise<void>;\n /** 其余 TanStack useForm 选项透传(如 onSubmitInvalid) */\n formOptions?: Record<string, unknown>;\n}\n\n/**\n * 底层原语:包装 TanStack useForm(聚合入口 defineForm 内部也走这里)。\n *\n * - `defaultValues` 从 `items[].default` 派生(值或同步工厂,缺省 null)——单一真相源;\n * - 显式泛型 `useForm<T>`,保住 onSubmit `{ value: T }` 全链路推断;\n * - 须在组件 setup 中调用(TanStack useForm 内部 `onMounted(formApi.mount)`)。\n */\nexport function useFormRender<T extends object>(\n options: UseFormRenderOptions<T>,\n): FormRenderDefinition<T> {\n const { items, schema, onSubmit, formOptions } = options;\n\n const defaultValues = Object.fromEntries(\n items.map((item) => [\n String(item.key),\n typeof item.default === \"function\"\n ? (item.default as () => unknown)()\n : (item.default ?? null),\n ]),\n ) as T;\n\n // useForm 有 12 个必选泛型参数(validator 通道),validators 走 any 化宽松契约(同 context.ts FormInstance)\n const form = useForm<T, any, any, any, any, any, any, any, any, any, any, any>({\n defaultValues,\n // TanStack 默认在提交失败后 canSubmit=false 且 handleSubmit 被门控静默拦截,\n // 用户修正字段值后将永远无法再次提交(搜索表单致命)。\n // 放开门控:每次点击都执行完整校验流,失败走错误分发,成功才走 onSubmit。\n canSubmitWhenInvalid: true,\n ...(schema ? { validators: { onSubmit: schema } } : {}),\n ...(onSubmit ? { onSubmit: ({ value }) => onSubmit({ value }) } : {}),\n ...formOptions,\n });\n\n return { items, form, resetToDefaults: () => form.reset() };\n}\n"
66
+ "content": "import { useForm } from \"@tanstack/vue-form\";\nimport type { FormRenderDefinition, FormRenderItem } from \"./types\";\n\nexport interface UseFormRenderOptions<T extends object> {\n items: FormRenderItem<T>[];\n /** Standard Schema(valibot v.object 输出直接兼容),映射到 TanStack validators.onSubmit */\n schema?: unknown;\n onSubmit?: (ctx: { value: T }) => void | Promise<void>;\n /** 按钮预设七项(A1):显式传任一项即投影为 actions(definition 域,组件按钮 props 全量忽略) */\n searchable?: boolean;\n submitable?: boolean;\n resetable?: boolean;\n cancelable?: boolean;\n searchText?: string;\n submitText?: string;\n resetText?: string;\n /** 其余 TanStack useForm 选项透传(如 onSubmitInvalid) */\n formOptions?: Record<string, unknown>;\n}\n\n/**\n * 底层原语:包装 TanStack useForm(聚合入口 defineForm 内部也走这里)。\n *\n * - `defaultValues` 从 `items[].default` 派生(值或同步工厂,缺省 null)——单一真相源;\n * - 显式泛型 `useForm<T>`,保住 onSubmit `{ value: T }` 全链路推断;\n * - 须在组件 setup 中调用(TanStack useForm 内部 `onMounted(formApi.mount)`)。\n */\nexport function useFormRender<T extends object>(\n options: UseFormRenderOptions<T>,\n): FormRenderDefinition<T> {\n const {\n items,\n schema,\n onSubmit,\n formOptions,\n searchable,\n submitable,\n resetable,\n cancelable,\n searchText,\n submitText,\n resetText,\n } = options;\n\n // 按钮预设七项直传投影(A1 块级互斥的 definition 域;全 undefined = 未配置 → 组件 props 域生效)\n const actions =\n searchable === undefined &&\n submitable === undefined &&\n resetable === undefined &&\n cancelable === undefined &&\n searchText === undefined &&\n submitText === undefined &&\n resetText === undefined\n ? undefined\n : { searchable, submitable, resetable, cancelable, searchText, submitText, resetText };\n\n const defaultValues = Object.fromEntries(\n items.map((item) => [\n String(item.key),\n typeof item.default === \"function\"\n ? (item.default as () => unknown)()\n : (item.default ?? null),\n ]),\n ) as T;\n\n // useForm 有 12 个必选泛型参数(validator 通道),validators 走 any 化宽松契约(同 context.ts FormInstance)\n const form = useForm<T, any, any, any, any, any, any, any, any, any, any, any>({\n defaultValues,\n // TanStack 默认在提交失败后 canSubmit=false 且 handleSubmit 被门控静默拦截,\n // 用户修正字段值后将永远无法再次提交(搜索表单致命)。\n // 放开门控:每次点击都执行完整校验流,失败走错误分发,成功才走 onSubmit。\n canSubmitWhenInvalid: true,\n ...(schema ? { validators: { onSubmit: schema } } : {}),\n ...(onSubmit ? { onSubmit: ({ value }) => onSubmit({ value }) } : {}),\n ...formOptions,\n });\n\n return {\n items,\n form,\n resetToDefaults: () => form.reset(),\n // canSubmitWhenInvalid 已放开门控:每次 handleSubmit 都执行完整校验流(R30 校验语义单点化)\n submit: async () => {\n await form.handleSubmit();\n return form.state.isFieldsValid;\n },\n actions,\n };\n}\n"
67
67
  },
68
68
  {
69
69
  "path": "form-render/widgets/bind.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "form",
4
- "version": "0.5.2",
4
+ "version": "0.5.5",
5
5
  "type": "registry:ui",
6
6
  "description": "表单状态与校验:基于 TanStack Form,配合 Valibot(Standard Schema)声明式校验,aria 自动接线。",
7
7
  "registryDependencies": ["utils", "input", "button", "label"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "icon-shared",
4
- "version": "0.5.2",
4
+ "version": "0.5.5",
5
5
  "type": "registry:ui",
6
6
  "description": "内置功能性图标(CloseIcon/ChevronIcon/CalendarIcon),内部共享,非公共 API。图标组件零默认类:尺寸/旋转/过渡类由使用处显式传入,避免 fallthrough 拼接时同名工具类排序冲突。",
7
7
  "files": [
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "input",
4
- "version": "0.5.2",
4
+ "version": "0.5.5",
5
5
  "type": "registry:ui",
6
6
  "description": "文本输入框,支持 v-model、attrs 透传与 invalid 校验态。",
7
7
  "registryDependencies": ["utils"],
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "label",
4
- "version": "0.5.2",
4
+ "version": "0.5.5",
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.2",
4
+ "version": "0.5.5",
5
5
  "type": "registry:ui",
6
6
  "description": "月份选择器:输入框 + 锁定月视图的日历弹层,值以 \"yyyy-MM\" 字符串受控,min/max 为月粒度闭区间(内部换算到当月末日)。",
7
7
  "registryDependencies": ["utils", "date-shared", "calendar"],
@@ -11,7 +11,7 @@
11
11
  "path": "month-picker/MonthPicker.vue",
12
12
  "type": "registry:component",
13
13
  "target": "components/ui/month-picker/MonthPicker.vue",
14
- "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport type { PropType } from \"vue\";\nimport { computed, provide } from \"vue\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport PickerShell from \"../date-shared/PickerShell.vue\";\nimport { CALENDAR_IN_PICKER, formatIsoMonth, parseIsoMonth } from \"../date-shared/shared\";\nimport { usePickerBridge } from \"../date-shared/usePickerBridge\";\n\nconst props = defineProps({\n /** 受控月份(\"yyyy-MM\");undefined 走内部非受控,null 表示空 */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n /** 非受控初值(\"yyyy-MM\") */\n defaultValue: { type: String, default: undefined },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n placeholder: { type: String, default: \"请选择月份\" },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 可选下界(\"yyyy-MM\",含当月) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy-MM\",含当月) */\n max: { type: String, default: undefined },\n /** 选中后是否自动关弹层 */\n closeOnSelect: { type: Boolean, default: true },\n /** 文案与周起点跟随 locale */\n locale: { type: String, default: \"zh-CN\" },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n \"update:open\": [open: boolean];\n}>();\n\n// attrs(id/aria-*)转发给真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root,值归本 Picker)\nprovide(CALENDAR_IN_PICKER, true);\n\nconst { rootValue, isOpen, setOpen, handleValueUpdate } = usePickerBridge({\n modelValue: () => props.modelValue,\n defaultValue: () => props.defaultValue,\n open: () => props.open,\n defaultOpen: () => props.defaultOpen,\n disabled: () => props.disabled,\n readOnly: () => props.readOnly,\n parse: parseIsoMonth,\n toPublicValue: formatIsoMonth,\n onUpdateModelValue: (value) => emit(\"update:modelValue\", value),\n onUpdateOpen: (open) => emit(\"update:open\", open),\n});\n\nconst minDate = computed(() => parseIsoMonth(props.min ?? \"\"));\n// zag 月格值继承 focusedValue 的 day(normalizeValue: focusedValue.set({month}),可能是\n// 今天/已选值的 day)→ max 锚当月 1 日会误禁当月,须换算当月末日\n// (CalendarDate.set 内部 constrain,day=31 自动收敛到月末)\nconst maxDate = computed<DateValue | undefined>(() => {\n const anchor = parseIsoMonth(props.max ?? \"\");\n return anchor ? anchor.set({ day: 31 }) : undefined;\n});\n</script>\n\n<template>\n <PickerShell\n v-bind=\"$attrs\"\n :model-value=\"rootValue\"\n :open=\"isOpen\"\n :locale=\"props.locale\"\n min-view=\"month\"\n max-view=\"month\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :close-on-select=\"props.closeOnSelect\"\n :read-only=\"props.readOnly\"\n :disabled=\"props.disabled\"\n :invalid=\"props.invalid\"\n :placeholder=\"props.placeholder\"\n :class=\"props.class\"\n :format=\"formatIsoMonth\"\n :parse=\"parseIsoMonth\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <TCalendar mode=\"month\" />\n </PickerShell>\n</template>\n"
14
+ "content": "<script setup lang=\"ts\">\nimport type { DateValue } from \"@ark-ui/vue/date-picker\";\nimport type { PickerPositioning } from \"../date-shared/positioning\";\nimport type { PropType } from \"vue\";\nimport { computed, provide } from \"vue\";\nimport { Calendar as TCalendar } from \"../calendar\";\nimport PickerShell from \"../date-shared/PickerShell.vue\";\nimport { CALENDAR_IN_PICKER, formatIsoMonth, parseIsoMonth } from \"../date-shared/shared\";\nimport { usePickerBridge } from \"../date-shared/usePickerBridge\";\n\nconst props = defineProps({\n /** 受控月份(\"yyyy-MM\");undefined 走内部非受控,null 表示空 */\n modelValue: { type: String as PropType<string | null | undefined>, default: undefined },\n /** 非受控初值(\"yyyy-MM\") */\n defaultValue: { type: String, default: undefined },\n /** 弹层开合受控;undefined 走内部非受控(default: undefined 禁用 Boolean casting) */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n defaultOpen: { type: Boolean, default: false },\n placeholder: { type: String, default: \"请选择月份\" },\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n readOnly: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 可选下界(\"yyyy-MM\",含当月) */\n min: { type: String, default: undefined },\n /** 可选上界(\"yyyy-MM\",含当月) */\n max: { type: String, default: undefined },\n /** 选中后是否自动关弹层 */\n closeOnSelect: { type: Boolean, default: true },\n /** 文案与周起点跟随 locale */\n locale: { type: String, default: \"zh-CN\" },\n /** Ark DatePicker Root 的 positioning 配置(placement/gutter 等);\n iframe realm(wujie graft / iframe 嵌入)下 strategy 未显式指定时默认 fixed\n (absolute 包含块错位修正,机制详注见 useSandboxOverlay / sandbox.ts) */\n positioning: {\n type: Object as PropType<PickerPositioning>,\n default: undefined,\n },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{\n \"update:modelValue\": [value: string | null];\n \"update:open\": [open: boolean];\n}>();\n\n// attrs(id/aria-*)转发给真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 弹层内的 TCalendar 探测到宿主标记 → embedded 内嵌形态(纯卡片内核,不自建 Root,值归本 Picker)\nprovide(CALENDAR_IN_PICKER, true);\n\nconst { rootValue, isOpen, setOpen, handleValueUpdate } = usePickerBridge({\n modelValue: () => props.modelValue,\n defaultValue: () => props.defaultValue,\n open: () => props.open,\n defaultOpen: () => props.defaultOpen,\n disabled: () => props.disabled,\n readOnly: () => props.readOnly,\n parse: parseIsoMonth,\n toPublicValue: formatIsoMonth,\n onUpdateModelValue: (value) => emit(\"update:modelValue\", value),\n onUpdateOpen: (open) => emit(\"update:open\", open),\n});\n\nconst minDate = computed(() => parseIsoMonth(props.min ?? \"\"));\n// zag 月格值继承 focusedValue 的 day(normalizeValue: focusedValue.set({month}),可能是\n// 今天/已选值的 day)→ max 锚当月 1 日会误禁当月,须换算当月末日\n// (CalendarDate.set 内部 constrain,day=31 自动收敛到月末)\nconst maxDate = computed<DateValue | undefined>(() => {\n const anchor = parseIsoMonth(props.max ?? \"\");\n return anchor ? anchor.set({ day: 31 }) : undefined;\n});\n</script>\n\n<template>\n <PickerShell\n v-bind=\"$attrs\"\n :model-value=\"rootValue\"\n :open=\"isOpen\"\n :locale=\"props.locale\"\n min-view=\"month\"\n max-view=\"month\"\n :min=\"minDate\"\n :max=\"maxDate\"\n :close-on-select=\"props.closeOnSelect\"\n :read-only=\"props.readOnly\"\n :disabled=\"props.disabled\"\n :invalid=\"props.invalid\"\n :placeholder=\"props.placeholder\"\n :positioning=\"props.positioning\"\n :class=\"props.class\"\n :format=\"formatIsoMonth\"\n :parse=\"parseIsoMonth\"\n @update:model-value=\"handleValueUpdate\"\n @update:open=\"setOpen\"\n >\n <TCalendar mode=\"month\" />\n </PickerShell>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "month-picker/index.ts",
@@ -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.2",
4
+ "version": "0.5.5",
5
5
  "type": "registry:ui",
6
6
  "description": "数字输入框:内置加减步进按钮与数值边界,值以 number|null 受控(空值归一 null),支持 Intl 数字格式化。",
7
7
  "registryDependencies": ["utils"],
@@ -1,10 +1,16 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "overlay-shared",
4
- "version": "0.5.2",
4
+ "version": "0.5.5",
5
5
  "type": "registry:ui",
6
6
  "description": "弹层家族共享逻辑:受控开合桥接(useControlledBoolean)与确认 pending 语义(useConfirmPending)。",
7
7
  "files": [
8
+ {
9
+ "path": "overlay-shared/sandbox.ts",
10
+ "type": "registry:lib",
11
+ "target": "components/ui/overlay-shared/sandbox.ts",
12
+ "content": "/**\n * 微前端沙箱探测(按渲染拓扑分派,框架无关)。\n *\n * 拓扑三分:\n * - 同文档(无沙箱 / qiankun / micro-app light DOM / 降级 iframe):absolute 正确\n * - 真 shadow DOM(web component 沙箱 / micro-app shadowDOM 模式):absolute 正确,\n * 由组件的 `getRootNode() instanceof ShadowRoot` 检测命中\n * - graft 型(wujie):iframe 文档树 graft 进 shadowRoot 渲染,absolute 输出视口系\n * 坐标但包含块是 graft body → 错位;fixed 以最近视口为包含块,是唯一正确解\n *\n * 安全性论证:非 graft 拓扑下 absolute 与 fixed 坐标等价(包含块同为最近视口),\n * iframe realm 下默认 fixed 零副作用;跨域 iframe 下 self/top 仅引用比较,\n * 不读属性,无 SecurityError。\n *\n * 已知边界:\n * - fixed 元素祖先有 transform/filter 时包含块被劫持(宿主布局应避免;graft 下\n * absolute 的 offsetParent 解析本就失效,错法不同而非新增错误)\n * - fixed 面板在祖先滚动时依赖 autoUpdate 重算,重算前一帧有视口驻留(瞬时视觉差异)\n * - 若未来出现「非 iframe 的 graft 型沙箱」,本探测无法覆盖,需追加该沙箱的 marker 信号\n */\n\n/** 组件 JS 是否运行在 iframe realm(wujie / iframe 型沙箱 / 普通 iframe 嵌入) */\nexport function isInIframeRealm(): boolean {\n return typeof window !== \"undefined\" && window.self !== window.top;\n}\n\n/** 是否处于 wujie graft 沙箱(getRootNode/父链被 wujie patch 伪装,结构探测失效,\n * 依赖官方标记;wujie 在子应用脚本执行前注入,时序可靠) */\nexport function isInWujie(): boolean {\n return (\n typeof window !== \"undefined\" &&\n (window as { __POWERED_BY_WUJIE__?: boolean }).__POWERED_BY_WUJIE__ === true\n );\n}\n"
13
+ },
8
14
  {
9
15
  "path": "overlay-shared/useConfirmPending.ts",
10
16
  "type": "registry:lib",
@@ -16,6 +22,18 @@
16
22
  "type": "registry:lib",
17
23
  "target": "components/ui/overlay-shared/useControlledBoolean.ts",
18
24
  "content": "import { computed, ref, type ComputedRef } from \"vue\";\n\nexport interface ControlledBooleanOptions {\n /** 受控值;返回 undefined 表示非受控(内部状态接管) */\n controlled: () => boolean | undefined;\n /** 非受控初始值 */\n defaultValue?: () => boolean;\n /** 状态变更对外同步(一般 emit(\"update:open\", next)) */\n onChange?: (next: boolean) => void;\n}\n\nexport interface ControlledBoolean {\n isOpen: ComputedRef<boolean>;\n setOpen: (next: boolean) => void;\n}\n\n/**\n * 业务组件惯例:Ark Root 恒走受控,非受控语义由内部 ref 实现。\n * `controlled()` 返回 undefined 时用内部值,否则永远跟随外部 prop。\n */\nexport function useControlledBoolean(options: ControlledBooleanOptions): ControlledBoolean {\n const internal = ref(options.defaultValue?.() ?? false);\n const isOpen = computed(() => options.controlled() ?? internal.value);\n\n function setOpen(next: boolean) {\n internal.value = next;\n options.onChange?.(next);\n }\n\n return { isOpen, setOpen };\n}\n"
25
+ },
26
+ {
27
+ "path": "overlay-shared/useOverlayIds.ts",
28
+ "type": "registry:lib",
29
+ "target": "components/ui/overlay-shared/useOverlayIds.ts",
30
+ "content": "import { computed, useId } from \"vue\";\n\n/** 与 zag ids 兼容的宽类型:string 或函数型(如 select 的 item(value) => string) */\nexport type OverlayIds = Record<string, string | ((value: string) => string)>;\n\n/**\n * 浮层组件 ids 全量覆盖(无冒号化)。\n *\n * 背景:zag 缺省 id 惯例形如 `popover:{scope.id}:title`(各包 *.dom.js get*Id\n * 兜底分支),而部分 part 元素并不总是渲染(title/description/anchor/clearTrigger/\n * arrow 等),machine 仍会按状态变更反复 getById 查询。wujie 沙箱把\n * document.getElementById patch 成 `querySelector('[id=\"…\"]')` miss 后兜底\n * `querySelector('#'+id)`(wujie proxy.js),冒号未转义 → SyntaxError → catch 打出\n * \"[wujie warn] 不支持document.getElementById()传入特殊字符…\" 且打开期间反复刷屏。\n * ids 派生自 Vue useId()(v-0 格式,无冒号)后,未命中也是合法选择器,静默返回\n * null,告警消除;原生环境 getElementById 不解析选择器,行为零变化。\n *\n * 用法(组件 setup 内,inheritAttrs: false 透传模式下同样适用):\n * const { ids, resolveId } = useOverlayIds(attrs, {\n * primary: \"content\",\n * parts: [\"title\", \"description\", \"anchor\", \"trigger\", \"closeTrigger\", \"positioner\", \"arrow\"],\n * });\n * // 模板:<ArkXxx.Root v-bind=\"attrs\" :ids=\"ids\">(:ids 须位于 v-bind=\"attrs\" 之后)\n * // aria 手动接线取元素 id 时用 resolveId(part)(user 覆盖优先,与实际 DOM 一致)\n *\n * 边界:parts 只声明「字符串型覆盖口」的 part;函数型 part(如 select 的\n * item/itemGroup/itemGroupLabel——元素必渲染,[id=\"…\"] 首查即命中,无炸点)不进\n * parts,由 user 经 attrs.ids 直传原样保留。user 永远最后展开:显式传入以其为准。\n */\nexport function useOverlayIds(\n attrs: Record<string, unknown>,\n options: { primary: string; parts: readonly string[] },\n) {\n const stemId = useId();\n const userIds = computed(() => (attrs.ids ?? {}) as OverlayIds);\n /** 默认派生值(不含 user 覆盖),独立于 ids 供 resolveId 回退;构造恒为字符串 */\n const buildBase = (): Record<string, string> => {\n const base: Record<string, string> = {};\n for (const part of options.parts) {\n base[part] = part === options.primary ? stemId : `${stemId}-${part}`;\n }\n return base;\n };\n const ids = computed<OverlayIds>(() => ({ ...buildBase(), ...userIds.value })); // user 永远收尾\n /** aria 接线用:user 字符串覆盖优先,函数型 user 回退默认值 */\n const resolveId = (part: string) => {\n const v = userIds.value[part];\n return typeof v === \"string\" ? v : buildBase()[part];\n };\n return { ids, resolveId };\n}\n"
31
+ },
32
+ {
33
+ "path": "overlay-shared/useSandboxOverlay.ts",
34
+ "type": "registry:lib",
35
+ "target": "components/ui/overlay-shared/useSandboxOverlay.ts",
36
+ "content": "import type { ComputedRef } from \"vue\";\nimport { computed, getCurrentInstance, onMounted, ref } from \"vue\";\nimport { isInIframeRealm, isInWujie } from \"./sandbox\";\n\n/**\n * 浮层沙箱适配公共层(Popover 0.5.3 修复的推广形态,机制与实测依据见 sandbox.ts 头注):\n * - useSandboxTeleportTarget:Teleport 目标降级(真 shadow DOM / wujie graft → 应用挂载容器)\n * - withSandboxStrategy:iframe realm 下 positioning.strategy 默认 fixed(absolute 包含块错位修正)\n */\n\n/**\n * 浮层 Teleport 目标解析:显式 to > shadow DOM / wujie graft 自动降级 > body。\n *\n * app._container 在 mount 的 render 完成后才赋值(runtime-core 3.5.43:render L4337\n * → 赋值 L4340),而子组件 onMounted 在 render 内同步执行、届时仍为 undefined,\n * 故检测再延后一个微任务(mount 调用栈结束后 _container 必已赋值),结果存 ref\n * 驱动 computed 重算;getCurrentInstance 仅 setup 同步上下文可用,本函数须在\n * setup 顶层调用。共享 Vue(__MICRO_SHARED__)下各子应用 app._container 相互\n * 独立,检测按实例隔离。\n * 沙箱两类:真 shadow DOM 由 getRootNode() 命中;wujie graft 下 getRootNode/父链\n * 被 patch 伪装成 iframe 文档语义(实测),结构探测失效,须叠加官方标记位。\n * 其余微前端(qiankun / micro-app light DOM)body 即主文档 body,兜底正确。\n *\n * @param explicitTo 组件显式 to 的取值函数(响应式安全:computed 内重读)\n * @returns Teleport 目标(显式 to 优先,其次降级容器,兜底 body)\n */\nexport function useSandboxTeleportTarget(\n explicitTo: () => string | HTMLElement | undefined,\n): ComputedRef<string | HTMLElement> {\n const instance = getCurrentInstance();\n const inWujie = isInWujie();\n const detectedTarget = ref<string | HTMLElement>(\"body\");\n onMounted(() => {\n queueMicrotask(() => {\n if (explicitTo()) return;\n const container = (instance?.appContext.app as { _container?: HTMLElement } | undefined)\n ?._container;\n if (container && (container.getRootNode() instanceof ShadowRoot || inWujie)) {\n detectedTarget.value = container;\n }\n });\n });\n return computed(() => explicitTo() ?? detectedTarget.value);\n}\n\n/**\n * iframe realm(wujie graft / iframe 型沙箱 / iframe 嵌入)且用户未显式指定\n * strategy 时默认 fixed:非 graft 拓扑下 fixed 与 absolute 坐标等价(零副作用),\n * graft 拓扑(wujie)absolute 包含块错位,fixed 是唯一正确解。\n * 纯函数、原地写入 merged(调用方传入自己的合成对象,无共享引用风险);\n * user.strategy 显式给出(含 null 意义上的「未传」判定用 == null)时以其为准。\n *\n * @param user 用户原始 positioning(undefined 或经 attrs 透传的合成对象)\n * @param merged 组件已合成 placement/sameWidth 等的基础 positioning(将被写入)\n * @returns 写入 strategy 后的 merged(同引用,便于 computed 直接 return)\n */\nexport function withSandboxStrategy<T extends object>(user: T | undefined, merged: T): T {\n if (isInIframeRealm() && (user as { strategy?: string } | undefined)?.strategy == null) {\n (merged as { strategy?: string }).strategy = \"fixed\";\n }\n return merged;\n}\n"
19
37
  }
20
38
  ]
21
39
  }
@@ -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.2",
4
+ "version": "0.5.5",
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.2",
4
+ "version": "0.5.5",
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.2",
4
+ "version": "0.5.5",
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.2",
4
+ "version": "0.5.5",
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 {\n computed,\n getCurrentInstance,\n onBeforeUnmount,\n onMounted,\n ref,\n useAttrs,\n useId,\n useSlots,\n} from \"vue\";\nimport type { PopoverRootProps } from \"@ark-ui/vue/popover\";\nimport { Popover as ArkPopover } from \"@ark-ui/vue/popover\";\nimport { cn } from \"@/lib/utils\";\nimport { useControlledBoolean } from \"../overlay-shared/useControlledBoolean\";\n\n/** 面板相对触发器的对齐方向 */\ntype Align = \"start\" | \"center\" | \"end\";\n/** 面板主轴方向(与 align 组合成 12 方位 placement) */\ntype Side = \"top\" | \"bottom\" | \"left\" | \"right\";\n/** 触发方式:click 内建切换;hover/focus 延迟桥接;manual 纯受控 */\ntype TriggerMode = \"click\" | \"hover\" | \"focus\" | \"manual\";\n\n/** Ark Popover Root 的 positioning 配置(placement 含四方向 × 对齐组合) */\ntype ArkPositioning = NonNullable<PopoverRootProps[\"positioning\"]>;\ntype ArkPlacement = NonNullable<ArkPositioning[\"placement\"]>;\n\ndefineOptions({ inheritAttrs: false });\n\nconst props = defineProps({\n /** 受控开关(配合 v-model:open);不传时为非受控 */\n open: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n /** 非受控时的初始开关 */\n defaultOpen: { type: Boolean, default: false },\n /** 首次展开才挂载面板内容 */\n lazyMount: { type: Boolean, default: false },\n /** 收起时卸载面板内容 */\n unmountOnExit: { type: Boolean, default: false },\n /** 触发方式:click(默认,内建切换+完整 aria) / hover / focus(带延迟,Anchor+手动 aria) / manual(纯受控,仅定位锚点) */\n trigger: { type: String as PropType<TriggerMode>, default: \"click\" },\n /** hover/focus 打开延迟(毫秒) */\n openDelay: { type: Number, default: 100 },\n /** hover/focus 关闭延迟(毫秒) */\n closeDelay: { type: Number, default: 100 },\n /** hover/focus 时悬浮/聚焦面板保持打开 */\n keepAliveOnHover: { type: Boolean, default: true },\n /** 面板主轴方向(与 align 组合定位);attrs.positioning.placement 显式给出时以其为准 */\n side: { type: String as PropType<Side>, default: \"bottom\" },\n /** 面板相对触发器的对齐方向(默认居中) */\n align: { type: String as PropType<Align>, default: \"center\" },\n /** 显示箭头(shadcn 风格默认无箭头) */\n arrow: { type: Boolean, default: false },\n /** 追加/覆盖箭头样式类 */\n arrowClass: { type: String, default: undefined },\n /** 禁用触发(不响应任何触发事件;已打开状态不受影响) */\n disabled: { type: Boolean, default: false },\n /** 是否 Teleport(浮层定位不受嵌套裁剪影响);false 时面板留在原地 */\n portal: { type: Boolean, default: true },\n /** Teleport 目标(选择器或元素),仅 portal=true 时生效;\n 缺省时若应用挂载容器处于 shadow DOM(微前端沙箱)自动降级为该容器,否则 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 自动降级 > body ——\n// app._container 在 mount 的 render 完成后才赋值(runtime-core 3.5.43:render L4337\n// → 赋值 L4340),而子组件 onMounted 在 render 内同步执行、届时仍为 undefined,\n// 故检测再延后一个微任务(mount 调用栈结束后 _container 必已赋值),结果存 ref\n// 驱动 computed 重算;getCurrentInstance 仅 setup 同步上下文可用,须顶层捕获。\n// 共享 Vue(__MICRO_SHARED__)下各子应用 app._container 相互独立,检测按实例隔离;\n// 非 shadow 环境 getRootNode() 返回 Document → 兜底 body,零破坏\nconst instance = getCurrentInstance();\nconst detectedTarget = ref<string | HTMLElement>(\"body\");\nonMounted(() => {\n queueMicrotask(() => {\n if (props.to) return;\n const container = (instance?.appContext.app as { _container?: HTMLElement } | undefined)\n ?._container;\n if (container && container.getRootNode() instanceof ShadowRoot) {\n detectedTarget.value = container;\n }\n });\n});\nconst teleportTarget = computed<string | HTMLElement>(() => props.to ?? detectedTarget.value);\n\n// —— 受控桥接(Dialog 同款):Root 恒走受控,非受控语义由内部 ref 实现 ——\nconst { isOpen, setOpen } = useControlledBoolean({\n controlled: () => props.open,\n defaultValue: () => props.defaultOpen,\n onChange: (open) => emit(\"update:open\", open),\n});\n\n// —— 触发路径分派:click 用内建 Trigger(完整 aria 自动接线);\n// hover/focus/manual 用 Anchor 作定位锚点(无内建 click,语义不冲突)。\n// disabled 时也切 Anchor:内建 TOGGLE 无法从外部短路(AT_TARGET 阶段监听器按注册顺序\n// 执行、capture 无优先级),不渲染 Trigger 是唯一可靠方式 ——\nconst useNativeTrigger = computed(() => props.trigger === \"click\" && !props.disabled);\n\n// Anchor 模式的手动 aria 接线(补偿放弃 Trigger 的自动接线):\n// 经 ids.content 定死面板 id,保证 aria-controls 可靠指向\nconst contentId = useId();\nconst rootIds = computed<Record<string, string> | undefined>(() => {\n if (useNativeTrigger.value) return undefined;\n const user = (attrs.ids ?? {}) as Record<string, string>;\n return { ...user, content: contentId };\n});\nconst anchorAria = computed(() =>\n useNativeTrigger.value\n ? {}\n : {\n \"aria-haspopup\": \"dialog\" as const,\n \"aria-expanded\": isOpen.value,\n \"aria-controls\": contentId,\n },\n);\n\n// —— 延迟桥接(hover/focus):单一定时器,进入取消关闭、离开取消打开 ——\nlet timer: ReturnType<typeof setTimeout> | null = null;\nconst clearTimer = () => {\n if (timer !== null) {\n clearTimeout(timer);\n timer = null;\n }\n};\nconst schedule = (next: boolean, delay: number) => {\n if (props.disabled) return;\n clearTimer();\n if (delay <= 0) {\n setOpen(next);\n return;\n }\n timer = setTimeout(() => {\n timer = null;\n if (!props.disabled) setOpen(next);\n }, delay);\n};\n\nconst isHoverFocus = () => props.trigger === \"hover\" || props.trigger === \"focus\";\n\nconst onTriggerEnter = () => {\n if (!isHoverFocus()) return;\n schedule(true, props.openDelay);\n};\nconst onTriggerLeave = () => {\n if (!isHoverFocus()) return;\n schedule(false, props.closeDelay);\n};\n// 面板悬浮/聚焦保活(keep-alive 语义):仅取消挂起的关闭计时\nconst onPanelEnter = () => {\n if (!isHoverFocus() || !props.keepAliveOnHover) return;\n clearTimer();\n};\n// 离开面板(去往触发器以外的地方)也应关闭:覆盖 trigger→panel→outside 链路\nconst onPanelLeave = () => {\n if (!isHoverFocus()) return;\n schedule(false, props.closeDelay);\n};\n\nonBeforeUnmount(clearTimer);\n\n// side/align → Ark positioning.placement(12 方位,居中不带对齐后缀);\n// 外部经 attrs 传入的 positioning 已显式指定 placement 时以其为准,其余字段原样合并\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 { ...user, placement, sameWidth: props.matchTriggerWidth || user.sameWidth };\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 沙箱(wujie 等)自动降级为应用挂载容器,避免传送出 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-overlay)] w-72 rounded-md border p-4 shadow-md outline-none data-[state=open]:animate-in data-[state=open]:fade-in-0 data-[state=open]:zoom-in-95 data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=closed]:zoom-out-95\",\n props.contentClass,\n props.contentProps?.[\"class\"] as ClassValue,\n ),\n);\n\n// 箭头:尺寸/底色经 CSS 变量交给 zag 内联样式(arrowTip 自动取 --arrow-background 上色)\nconst arrowClass = computed(() =>\n cn(\"[--arrow-size:10px] [--arrow-background:var(--popover)]\", props.arrowClass),\n);\n\n// zIndex prop 走内联 style(Tailwind 任意值类不适合动态拼接);未传保持默认层级类\nconst positionerClass = computed(() => (props.zIndex != null ? \"\" : \"z-[var(--z-overlay)]\"));\nconst positionerStyle = computed(() =>\n props.zIndex != null ? { zIndex: props.zIndex } : undefined,\n);\n</script>\n\n<template>\n <ArkPopover.Root\n v-bind=\"attrs\"\n :open=\"isOpen\"\n :positioning=\"rootPositioning\"\n :ids=\"rootIds\"\n :lazy-mount=\"props.lazyMount\"\n :unmount-on-exit=\"props.unmountOnExit\"\n @update:open=\"setOpen\"\n >\n <!-- click 且未禁用:内建 Trigger,行为/aria 与旧版完全一致 -->\n <ArkPopover.Trigger v-if=\"useNativeTrigger\" as-child>\n <slot />\n </ArkPopover.Trigger>\n\n <!-- hover/focus/manual 或 disabled:Anchor + 自绑监听 + 手动 aria -->\n <ArkPopover.Anchor\n v-else-if=\"slots.default\"\n as-child\n v-bind=\"anchorAria\"\n @mouseenter=\"onTriggerEnter\"\n @mouseleave=\"onTriggerLeave\"\n @focusin=\"onTriggerEnter\"\n @focusout=\"onTriggerLeave\"\n >\n <slot />\n </ArkPopover.Anchor>\n\n <!-- portal:Teleport(Ark Vue 原语不自带传送,浮层定位不受嵌套 overflow 裁剪影响);\n portal=false 时 disabled Teleport 面板留在原地;to 显式指定目标,\n 缺省时真 shadow DOM(getRootNode 检测)与 wujie graft(marker 检测)沙箱\n 自动降级为应用挂载容器,避免传送出 shadow root -->\n <Teleport :to=\"teleportTarget\" :disabled=\"!props.portal\">\n <ArkPopover.Positioner :class=\"positionerClass\" :style=\"positionerStyle\">\n <ArkPopover.Content\n v-bind=\"props.contentProps\"\n :class=\"contentClass\"\n @mouseenter=\"onPanelEnter\"\n @mouseleave=\"onPanelLeave\"\n @focusin=\"onPanelEnter\"\n @focusout=\"onPanelLeave\"\n >\n <ArkPopover.Arrow v-if=\"props.arrow\" :class=\"arrowClass\">\n <ArkPopover.ArrowTip />\n </ArkPopover.Arrow>\n <slot name=\"header\" />\n <slot name=\"content\" />\n <slot name=\"footer\" />\n </ArkPopover.Content>\n </ArkPopover.Positioner>\n </Teleport>\n </ArkPopover.Root>\n</template>\n"
15
15
  },
16
16
  {
17
17
  "path": "popover/index.ts",
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
3
3
  "name": "progress",
4
- "version": "0.5.2",
4
+ "version": "0.5.5",
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.2",
4
+ "version": "0.5.5",
5
5
  "type": "registry:ui",
6
6
  "description": "单选组:基于 Ark UI Radio Group 原语,键盘导航与受控/非受控双模式。",
7
7
  "registryDependencies": ["utils"],