@tu-design/vue 0.5.6 → 0.5.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.mts +160 -56
- package/dist/index.mjs +688 -76
- package/dist/registry/vue/alert-dialog.json +1 -1
- package/dist/registry/vue/alert.json +1 -1
- package/dist/registry/vue/avatar-group.json +1 -1
- package/dist/registry/vue/avatar.json +2 -2
- package/dist/registry/vue/badge.json +1 -1
- package/dist/registry/vue/button.json +1 -1
- package/dist/registry/vue/calendar.json +3 -3
- package/dist/registry/vue/card.json +1 -1
- package/dist/registry/vue/cascader.json +1 -1
- package/dist/registry/vue/checkbox.json +1 -1
- package/dist/registry/vue/context-menu.json +1 -1
- package/dist/registry/vue/currency-input.json +2 -2
- package/dist/registry/vue/date-picker.json +1 -1
- package/dist/registry/vue/date-range-picker.json +1 -1
- package/dist/registry/vue/date-shared.json +4 -4
- package/dist/registry/vue/dialog.json +1 -1
- package/dist/registry/vue/drawer.json +1 -1
- package/dist/registry/vue/dropdown-menu.json +1 -1
- package/dist/registry/vue/empty.json +1 -1
- package/dist/registry/vue/form-render.json +12 -12
- package/dist/registry/vue/form.json +1 -1
- package/dist/registry/vue/icon-shared.json +1 -1
- package/dist/registry/vue/input.json +1 -1
- package/dist/registry/vue/label.json +1 -1
- package/dist/registry/vue/month-picker.json +1 -1
- package/dist/registry/vue/number-input.json +3 -3
- package/dist/registry/vue/overlay-shared.json +5 -5
- package/dist/registry/vue/password-input.json +1 -1
- package/dist/registry/vue/pin-input.json +1 -1
- package/dist/registry/vue/popconfirm.json +1 -1
- package/dist/registry/vue/popover.json +2 -2
- package/dist/registry/vue/progress.json +1 -1
- package/dist/registry/vue/radio-group.json +1 -1
- package/dist/registry/vue/registry.json +52 -52
- package/dist/registry/vue/select.json +3 -3
- package/dist/registry/vue/separator.json +1 -1
- package/dist/registry/vue/skeleton.json +1 -1
- package/dist/registry/vue/slider.json +1 -1
- package/dist/registry/vue/slot.json +3 -2
- package/dist/registry/vue/spin.json +1 -1
- package/dist/registry/vue/switch.json +1 -1
- package/dist/registry/vue/table-render.json +9 -9
- package/dist/registry/vue/tabs.json +2 -1
- package/dist/registry/vue/textarea.json +1 -1
- package/dist/registry/vue/timeline.json +2 -2
- package/dist/registry/vue/toast.json +2 -2
- package/dist/registry/vue/tokens.json +1 -1
- package/dist/registry/vue/tooltip.json +1 -1
- package/dist/registry/vue/tree-select.json +1 -1
- package/dist/registry/vue/tree-shared.json +9 -9
- package/dist/registry/vue/utils.json +2 -2
- package/dist/registry/vue/week-picker.json +2 -2
- package/dist/registry/vue/year-picker.json +1 -1
- package/package.json +1 -1
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "form-render",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.8",
|
|
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\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
|
|
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"
|
|
37
37
|
},
|
|
38
38
|
{
|
|
39
39
|
"path": "form-render/FormRenderField.vue",
|
|
@@ -45,7 +45,7 @@
|
|
|
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 */\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 * @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",
|
|
@@ -63,55 +63,55 @@
|
|
|
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 */\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 /** 按钮预设七项(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"
|
|
67
67
|
},
|
|
68
68
|
{
|
|
69
69
|
"path": "form-render/widgets/bind.ts",
|
|
70
70
|
"type": "registry:lib",
|
|
71
71
|
"target": "components/ui/form-render/widgets/bind.ts",
|
|
72
|
-
"content": "import type { AnyFieldApi } from \"@tanstack/vue-form\";\n\n/**\n * 值绑定形态描述:\n * - modelValue:大多数组件(Input/Password/Number/Currency/Textarea/picker 系/Select)\n * - checked:Checkbox/Switch\n * - value:RadioGroup\n * - SLIDER:Slider 特例 —— 值 prop 为 `value`,事件却是 `update:modelValue`,且数组语义(number ↔ [number])\n */\nexport interface BindingSpec {\n prop: string;\n event: string;\n /** field 值 → 控件 prop 的转换(slider: number → [number]) */\n toProp?: (value: unknown) => unknown;\n /** 控件事件 → field 值的转换(slider: [number] → number) */\n fromEvent?: (value: unknown) => unknown;\n}\n\nexport const MODEL_VALUE: BindingSpec = { prop: \"modelValue\", event: \"modelValue\" };\nexport const CHECKED: BindingSpec = { prop: \"checked\", event: \"checked\" };\nexport const VALUE: BindingSpec = { prop: \"value\", event: \"value\" };\nexport const SLIDER: BindingSpec = {\n prop: \"value\",\n event: \"modelValue\",\n toProp: (v) => (v === null || v === undefined ? undefined : [v]),\n fromEvent: (v) => (Array.isArray(v) ? (v[0] ?? null) : v),\n};\n\n/**\n * TanStack field → 控件 props 的统一绑定:\n * 值回显(field.state.value)+ 写回(handleChange)+ 失焦(handleBlur)。\n */\nexport function bindField(field: AnyFieldApi, spec: BindingSpec) {\n return {\n [spec.prop]: spec.toProp ? spec.toProp(field.state.value) : field.state.value,\n [`onUpdate:${spec.event}`]: (value: unknown) =>\n field.handleChange((spec.fromEvent ? spec.fromEvent(value) : value) as never),\n onBlur: field.handleBlur,\n };\n}\n"
|
|
72
|
+
"content": "import type { AnyFieldApi } from \"@tanstack/vue-form\";\n\n/**\n * 值绑定形态描述:\n * - modelValue:大多数组件(Input/Password/Number/Currency/Textarea/picker 系/Select)\n * - checked:Checkbox/Switch\n * - value:RadioGroup\n * - SLIDER:Slider 特例 —— 值 prop 为 `value`,事件却是 `update:modelValue`,且数组语义(number ↔ [number])\n */\nexport interface BindingSpec {\n prop: string;\n event: string;\n /** field 值 → 控件 prop 的转换(slider: number → [number]) */\n toProp?: (value: unknown) => unknown;\n /** 控件事件 → field 值的转换(slider: [number] → number) */\n fromEvent?: (value: unknown) => unknown;\n}\n\nexport const MODEL_VALUE: BindingSpec = { prop: \"modelValue\", event: \"modelValue\" };\nexport const CHECKED: BindingSpec = { prop: \"checked\", event: \"checked\" };\nexport const VALUE: BindingSpec = { prop: \"value\", event: \"value\" };\nexport const SLIDER: BindingSpec = {\n prop: \"value\",\n event: \"modelValue\",\n toProp: (v) => (v === null || v === undefined ? undefined : [v]),\n fromEvent: (v) => (Array.isArray(v) ? (v[0] ?? null) : v),\n};\n\n/**\n * TanStack field → 控件 props 的统一绑定:\n * 值回显(field.state.value)+ 写回(handleChange)+ 失焦(handleBlur)。\n * @param field - TanStack 表单字段实例,提供值读取与变更/失焦句柄\n * @param spec - 绑定形态描述,决定值 prop 名、事件名与可选的双向转换\n * @returns 可展开到组件 props 上的对象(值 prop、onUpdate:<event>、onBlur)\n */\nexport function bindField(field: AnyFieldApi, spec: BindingSpec) {\n return {\n [spec.prop]: spec.toProp ? spec.toProp(field.state.value) : field.state.value,\n [`onUpdate:${spec.event}`]: (value: unknown) =>\n field.handleChange((spec.fromEvent ? spec.fromEvent(value) : value) as never),\n onBlur: field.handleBlur,\n };\n}\n"
|
|
73
73
|
},
|
|
74
74
|
{
|
|
75
75
|
"path": "form-render/widgets/boolean.ts",
|
|
76
76
|
"type": "registry:lib",
|
|
77
77
|
"target": "components/ui/form-render/widgets/boolean.ts",
|
|
78
|
-
"content": "import { h } from \"vue\";\nimport { Checkbox } from \"@/components/ui/checkbox\";\nimport { Switch } from \"@/components/ui/switch\";\nimport type { CheckboxWidgetOptions, SwitchWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { CHECKED, bindField } from \"./bind\";\n\n/**\n * checkbox/switch widget:boolean 形态(值 prop 为 checked,非 modelValue)。\n * 单行布局倾向 hideLabel + label 经 item.title 展示由使用者决定。\n */\nexport function renderCheckboxItem<T extends object>(\n options: CheckboxWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Checkbox, {\n ...options,\n ...bindField(ctx.field, CHECKED),\n ...ctx.item.componentProps,\n });\n}\n\nexport function renderSwitchItem<T extends object>(\n options: SwitchWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Switch, {\n ...options,\n ...bindField(ctx.field, CHECKED),\n ...ctx.item.componentProps,\n });\n}\n"
|
|
78
|
+
"content": "import { h } from \"vue\";\nimport { Checkbox } from \"@/components/ui/checkbox\";\nimport { Switch } from \"@/components/ui/switch\";\nimport type { CheckboxWidgetOptions, SwitchWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { CHECKED, bindField } from \"./bind\";\n\n/**\n * checkbox/switch widget:boolean 形态(值 prop 为 checked,非 modelValue)。\n * 单行布局倾向 hideLabel + label 经 item.title 展示由使用者决定。\n * @param options - widget 选项,整体展开后经 checked 受控绑定与 componentProps 透传给 Checkbox\n * @returns 渲染函数,接收渲染上下文并产出 Checkbox vnode\n */\nexport function renderCheckboxItem<T extends object>(\n options: CheckboxWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Checkbox, {\n ...options,\n ...bindField(ctx.field, CHECKED),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * switch widget:boolean 开关(checked 受控形态,绑定与 checkbox 一致)\n * @param options - widget 选项,整体展开后经 checked 受控绑定与 componentProps 透传给 Switch\n * @returns 渲染函数,接收渲染上下文并产出 Switch vnode\n */\nexport function renderSwitchItem<T extends object>(\n options: SwitchWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Switch, {\n ...options,\n ...bindField(ctx.field, CHECKED),\n ...ctx.item.componentProps,\n });\n}\n"
|
|
79
79
|
},
|
|
80
80
|
{
|
|
81
81
|
"path": "form-render/widgets/index.ts",
|
|
82
82
|
"type": "registry:lib",
|
|
83
83
|
"target": "components/ui/form-render/widgets/index.ts",
|
|
84
|
-
"content": "import type { WidgetRenders } from \"../types\";\nimport { renderCheckboxItem, renderSwitchItem } from \"./boolean\";\nimport {\n renderCurrencyItem,\n renderDatePickerItem,\n renderDateRangePickerItem,\n renderMonthPickerItem,\n renderNumberItem,\n renderPasswordItem,\n renderTextareaItem,\n renderYearPickerItem,\n renderWeekPickerItem,\n} from \"./model-value\";\nimport { renderInputItem } from \"./input\";\nimport { renderSelectItem } from \"./select\";\nimport { renderRadioGroupItem, renderSliderItem } from \"./value\";\nimport { renderCascaderItem, renderTreeSelectItem } from \"./tree\";\n\n/**\n * widget 注册表:`r.input({...})` 等柯里化工厂的运行时对象。\n * 文件按绑定形态聚合:input / model-value(modelValue 系)/ boolean(checked 系)/\n * value(radioGroup/slider)/ select(多子组件组装)。\n */\nexport function widgetRenders<T extends object>(): WidgetRenders<T> {\n return {\n input: renderInputItem<T>,\n password: renderPasswordItem<T>,\n number: renderNumberItem<T>,\n currency: renderCurrencyItem<T>,\n textarea: renderTextareaItem<T>,\n select: renderSelectItem<T>,\n checkbox: renderCheckboxItem<T>,\n switch: renderSwitchItem<T>,\n radioGroup: renderRadioGroupItem<T>,\n treeSelect: renderTreeSelectItem<T>,\n cascader: renderCascaderItem<T>,\n slider: renderSliderItem<T>,\n datePicker: renderDatePickerItem<T>,\n monthPicker: renderMonthPickerItem<T>,\n yearPicker: renderYearPickerItem<T>,\n dateRangePicker: renderDateRangePickerItem<T>,\n weekPicker: renderWeekPickerItem<T>,\n render: (fn) => fn,\n };\n}\n"
|
|
84
|
+
"content": "import type { WidgetRenders } from \"../types\";\nimport { renderCheckboxItem, renderSwitchItem } from \"./boolean\";\nimport {\n renderCurrencyItem,\n renderDatePickerItem,\n renderDateRangePickerItem,\n renderMonthPickerItem,\n renderNumberItem,\n renderPasswordItem,\n renderTextareaItem,\n renderYearPickerItem,\n renderWeekPickerItem,\n} from \"./model-value\";\nimport { renderInputItem } from \"./input\";\nimport { renderSelectItem } from \"./select\";\nimport { renderRadioGroupItem, renderSliderItem } from \"./value\";\nimport { renderCascaderItem, renderTreeSelectItem } from \"./tree\";\n\n/**\n * widget 注册表:`r.input({...})` 等柯里化工厂的运行时对象。\n * 文件按绑定形态聚合:input / model-value(modelValue 系)/ boolean(checked 系)/\n * value(radioGroup/slider)/ select(多子组件组装)。\n * @returns 各 widget 类型的柯里化工厂映射(render 为恒等直通),供 FormRender 渲染时调用\n */\nexport function widgetRenders<T extends object>(): WidgetRenders<T> {\n return {\n input: renderInputItem<T>,\n password: renderPasswordItem<T>,\n number: renderNumberItem<T>,\n currency: renderCurrencyItem<T>,\n textarea: renderTextareaItem<T>,\n select: renderSelectItem<T>,\n checkbox: renderCheckboxItem<T>,\n switch: renderSwitchItem<T>,\n radioGroup: renderRadioGroupItem<T>,\n treeSelect: renderTreeSelectItem<T>,\n cascader: renderCascaderItem<T>,\n slider: renderSliderItem<T>,\n datePicker: renderDatePickerItem<T>,\n monthPicker: renderMonthPickerItem<T>,\n yearPicker: renderYearPickerItem<T>,\n dateRangePicker: renderDateRangePickerItem<T>,\n weekPicker: renderWeekPickerItem<T>,\n render: (fn) => fn,\n };\n}\n"
|
|
85
85
|
},
|
|
86
86
|
{
|
|
87
87
|
"path": "form-render/widgets/input.ts",
|
|
88
88
|
"type": "registry:lib",
|
|
89
89
|
"target": "components/ui/form-render/widgets/input.ts",
|
|
90
|
-
"content": "import { h } from \"vue\";\nimport { Input } from \"@/components/ui/input\";\nimport type { InputWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n
|
|
90
|
+
"content": "import { h } from \"vue\";\nimport { Input } from \"@/components/ui/input\";\nimport type { InputWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { MODEL_VALUE, bindField } from \"./bind\";\n\n/**\n * input widget:单行文本输入(placeholder 为原生 attr 透传,aria-invalid 由 FormControl 接线)\n * @param options - widget 选项,整体展开后经 modelValue 受控绑定与 componentProps 透传给 Input\n * @returns 渲染函数,接收渲染上下文并产出 Input vnode\n */\nexport function renderInputItem<T extends object>(\n options: InputWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Input, {\n placeholder: ctx.item.placeholder,\n ...options,\n ...bindField(ctx.field, MODEL_VALUE),\n ...ctx.item.componentProps,\n });\n}\n"
|
|
91
91
|
},
|
|
92
92
|
{
|
|
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
|
|
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"
|
|
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 */\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 优先,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"
|
|
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\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\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 级回退(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"
|
|
109
109
|
},
|
|
110
110
|
{
|
|
111
111
|
"path": "form-render/widgets/value.ts",
|
|
112
112
|
"type": "registry:lib",
|
|
113
113
|
"target": "components/ui/form-render/widgets/value.ts",
|
|
114
|
-
"content": "import { h } from \"vue\";\nimport { RadioGroup } from \"@/components/ui/radio-group\";\nimport { Slider } from \"@/components/ui/slider\";\nimport type { RadioGroupWidgetOptions, SliderWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { SLIDER, VALUE, bindField } from \"./bind\";\n\n/**\n * radioGroup widget:单选组(值 prop 为 value)。\n * 命名穿透:选项字段为组件 required prop `items`,整体直传,widget 不做组装。\n */\nexport function renderRadioGroupItem<T extends object>(\n options: RadioGroupWidgetOptions,\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(RadioGroup, {\n ...options,\n ...bindField(ctx.field, VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * slider widget:number ↔ number[] 混合绑定特例\n * (值 prop 为 `value`,事件却是 `update:modelValue` 且数组语义,由 SLIDER spec 转换)。\n */\nexport function renderSliderItem<T extends object>(\n options: SliderWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Slider, {\n ...options,\n ...bindField(ctx.field, SLIDER),\n ...ctx.item.componentProps,\n });\n}\n"
|
|
114
|
+
"content": "import { h } from \"vue\";\nimport { RadioGroup } from \"@/components/ui/radio-group\";\nimport { Slider } from \"@/components/ui/slider\";\nimport type { RadioGroupWidgetOptions, SliderWidgetOptions, WidgetRenderReturn } from \"../types\";\nimport { SLIDER, VALUE, bindField } from \"./bind\";\n\n/**\n * radioGroup widget:单选组(值 prop 为 value)。\n * 命名穿透:选项字段为组件 required prop `items`,整体直传,widget 不做组装。\n * @param options - widget 选项,整体展开后经 value 受控绑定与 componentProps 透传给 RadioGroup\n * @returns 渲染函数,接收渲染上下文并产出 RadioGroup vnode\n */\nexport function renderRadioGroupItem<T extends object>(\n options: RadioGroupWidgetOptions,\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(RadioGroup, {\n ...options,\n ...bindField(ctx.field, VALUE),\n ...ctx.item.componentProps,\n });\n}\n\n/**\n * slider widget:number ↔ number[] 混合绑定特例\n * (值 prop 为 `value`,事件却是 `update:modelValue` 且数组语义,由 SLIDER spec 转换)。\n * @param options - widget 选项,整体展开后经 SLIDER 受控绑定与 componentProps 透传给 Slider\n * @returns 渲染函数,接收渲染上下文并产出 Slider vnode\n */\nexport function renderSliderItem<T extends object>(\n options: SliderWidgetOptions = {},\n): WidgetRenderReturn<T> {\n return (ctx) =>\n h(Slider, {\n ...options,\n ...bindField(ctx.field, SLIDER),\n ...ctx.item.componentProps,\n });\n}\n"
|
|
115
115
|
}
|
|
116
116
|
]
|
|
117
117
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "form",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.8",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "表单状态与校验:基于 TanStack Form,配合 Valibot(Standard Schema)声明式校验,aria 自动接线。",
|
|
7
7
|
"registryDependencies": ["utils", "input", "button", "label"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "icon-shared",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.8",
|
|
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": "month-picker",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.8",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "月份选择器:输入框 + 锁定月视图的日历弹层,值以 \"yyyy-MM\" 字符串受控,min/max 为月粒度闭区间(内部换算到当月末日)。",
|
|
7
7
|
"registryDependencies": ["utils", "date-shared", "calendar"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "number-input",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.8",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "数字输入框:内置加减步进按钮与数值边界,值以 number|null 受控(空值归一 null),支持 Intl 数字格式化。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
"path": "number-input/NumberInput.vue",
|
|
12
12
|
"type": "registry:component",
|
|
13
13
|
"target": "components/ui/number-input/NumberInput.vue",
|
|
14
|
-
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { NumberInput as ArkNumberInput } from \"@ark-ui/vue/number-input\";\nimport { cn } from \"@/lib/utils\";\nimport { numberOrNull } from \"./utils\";\n\nconst props = defineProps({\n /** 受控值:number 或 null(空);undefined 走内部非受控 */\n modelValue: { type: Number as PropType<number | null | undefined>, default: undefined },\n min: { type: Number, default: undefined },\n max: { type: Number, default: undefined },\n step: { type: Number, default: undefined },\n formatOptions: { type: Object as PropType<Intl.NumberFormatOptions>, default: undefined },\n // default: undefined 禁用 Boolean casting(Checkbox/Dialog 同款约定)\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:modelValue\": [value: number | null] }>();\n\n// attrs(id/aria-*)转发给内部真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 对 Ark Root 恒走受控模式,非受控语义由内部 ref 实现(Checkbox 同款)\nconst internalValue = ref<number | null>(null);\nconst current = computed(() =>\n props.modelValue === undefined ? internalValue.value : props.modelValue,\n);\n\n/** number → Ark 受控 string(null/NaN → 空串) */\nconst arkValue = computed(() =>\n current.value == null || Number.isNaN(current.value) ? \"\" : String(current.value),\n);\n\n
|
|
14
|
+
"content": "<script setup lang=\"ts\">\nimport type { PropType } from \"vue\";\nimport { computed, ref } from \"vue\";\nimport { NumberInput as ArkNumberInput } from \"@ark-ui/vue/number-input\";\nimport { cn } from \"@/lib/utils\";\nimport { numberOrNull } from \"./utils\";\n\nconst props = defineProps({\n /** 受控值:number 或 null(空);undefined 走内部非受控 */\n modelValue: { type: Number as PropType<number | null | undefined>, default: undefined },\n min: { type: Number, default: undefined },\n max: { type: Number, default: undefined },\n step: { type: Number, default: undefined },\n formatOptions: { type: Object as PropType<Intl.NumberFormatOptions>, default: undefined },\n // default: undefined 禁用 Boolean casting(Checkbox/Dialog 同款约定)\n disabled: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n invalid: { type: Boolean as PropType<boolean | undefined>, default: undefined },\n class: { type: String, default: undefined },\n});\n\nconst emit = defineEmits<{ \"update:modelValue\": [value: number | null] }>();\n\n// attrs(id/aria-*)转发给内部真实 input,保证 TLabel/TFormControl 关联\ndefineOptions({ inheritAttrs: false });\n\n// 对 Ark Root 恒走受控模式,非受控语义由内部 ref 实现(Checkbox 同款)\nconst internalValue = ref<number | null>(null);\nconst current = computed(() =>\n props.modelValue === undefined ? internalValue.value : props.modelValue,\n);\n\n/** number → Ark 受控 string(null/NaN → 空串) */\nconst arkValue = computed(() =>\n current.value == null || Number.isNaN(current.value) ? \"\" : String(current.value),\n);\n\n/**\n * Ark details(value: string / valueAsNumber: number)→ number|null(空串/NaN 归一 null)\n * @param details - Ark NumberInput 的 ValueChangeDetails\n */\nfunction handleValueChange(details: { value: string; valueAsNumber: number }) {\n const next = numberOrNull(details);\n internalValue.value = next;\n emit(\"update:modelValue\", next);\n}\n</script>\n\n<template>\n <ArkNumberInput.Root\n :model-value=\"arkValue\"\n :min=\"props.min\"\n :max=\"props.max\"\n :step=\"props.step\"\n :format-options=\"props.formatOptions\"\n :disabled=\"props.disabled\"\n :invalid=\"props.invalid\"\n :class=\"\n cn(\n 'border-input flex h-9 items-stretch overflow-hidden rounded-md border shadow-sm transition-[color,box-shadow] outline-none focus-within:border-ring focus-within:ring-ring/50 focus-within:ring-[3px] data-invalid:border-destructive data-invalid:ring-destructive/20 data-invalid:ring-[3px]',\n props.class,\n )\n \"\n @value-change=\"handleValueChange\"\n >\n <ArkNumberInput.DecrementTrigger\n :class=\"'bg-muted/50 hover:bg-accent flex w-9 shrink-0 items-center justify-center border-r text-muted-foreground text-sm transition-colors disabled:cursor-not-allowed disabled:opacity-50'\"\n >\n <slot name=\"decrement\">\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 class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n </svg>\n </slot>\n </ArkNumberInput.DecrementTrigger>\n <ArkNumberInput.Input\n v-bind=\"$attrs\"\n :class=\"'bg-transparent flex-1 min-w-0 px-1 text-center text-sm outline-none disabled:cursor-not-allowed'\"\n />\n <ArkNumberInput.IncrementTrigger\n :class=\"'bg-muted/50 hover:bg-accent flex w-9 shrink-0 items-center justify-center border-l text-muted-foreground text-sm transition-colors disabled:cursor-not-allowed disabled:opacity-50'\"\n >\n <slot name=\"increment\">\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 class=\"size-4\"\n aria-hidden=\"true\"\n >\n <path d=\"M5 12h14\" />\n <path d=\"M12 5v14\" />\n </svg>\n </slot>\n </ArkNumberInput.IncrementTrigger>\n </ArkNumberInput.Root>\n</template>\n"
|
|
15
15
|
},
|
|
16
16
|
{
|
|
17
17
|
"path": "number-input/index.ts",
|
|
@@ -23,7 +23,7 @@
|
|
|
23
23
|
"path": "number-input/utils.ts",
|
|
24
24
|
"type": "registry:lib",
|
|
25
25
|
"target": "components/ui/number-input/utils.ts",
|
|
26
|
-
"content": "
|
|
26
|
+
"content": "/**\n * Ark ValueChangeDetails → number|null(空串/NaN 归一 null,numberOrNull 为可单测的纯函数)\n * @param details - Ark NumberInput 的 ValueChangeDetails\n * @returns 有效数字;空串或 NaN 时返回 null\n */\nexport function numberOrNull(details: { value: string; valueAsNumber: number }): number | null {\n return details.value === \"\" || Number.isNaN(details.valueAsNumber) ? null : details.valueAsNumber;\n}\n"
|
|
27
27
|
}
|
|
28
28
|
]
|
|
29
29
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "overlay-shared",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.8",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "弹层家族共享逻辑:受控开合桥接(useControlledBoolean)与确认 pending 语义(useConfirmPending)。",
|
|
7
7
|
"files": [
|
|
@@ -9,25 +9,25 @@
|
|
|
9
9
|
"path": "overlay-shared/sandbox.ts",
|
|
10
10
|
"type": "registry:lib",
|
|
11
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
|
|
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/**\n * 组件 JS 是否运行在 iframe realm(wujie / iframe 型沙箱 / 普通 iframe 嵌入)。\n * @returns 运行在 iframe realm 时返回 true,否则返回 false\n */\nexport function isInIframeRealm(): boolean {\n return typeof window !== \"undefined\" && window.self !== window.top;\n}\n\n/**\n * 是否处于 wujie graft 沙箱(getRootNode/父链被 wujie patch 伪装,结构探测失效,\n * 依赖官方标记;wujie 在子应用脚本执行前注入,时序可靠)。\n * @returns 处于 wujie graft 沙箱时返回 true,否则返回 false\n */\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
13
|
},
|
|
14
14
|
{
|
|
15
15
|
"path": "overlay-shared/useConfirmPending.ts",
|
|
16
16
|
"type": "registry:lib",
|
|
17
17
|
"target": "components/ui/overlay-shared/useConfirmPending.ts",
|
|
18
|
-
"content": "import { ref, type ComponentInternalInstance } from \"vue\";\n\nexport interface ConfirmPendingOptions {\n /** 当前组件实例:从 vnode 上取原始 onConfirm 监听器(emit 不回传返回值) */\n instance: ComponentInternalInstance | null;\n /** 无监听器时补发 confirm 事件 */\n emitConfirm: () => void;\n emitCancel: () => void;\n /** 关闭弹层(走受控桥) */\n close: () => void;\n}\n\n/**\n * 确认弹层公共 pending 语义:@confirm 处理器返回 Promise 时锁定关闭通道,\n * resolve 后自动关闭,reject 保持打开并退出 loading;同步处理器直接关闭。\n */\nexport function useConfirmPending(options: ConfirmPendingOptions) {\n const loading = ref(false);\n\n function handleConfirm() {\n if (loading.value) return;\n const handler = options.instance?.vnode.props?.onConfirm as\n | ((...args: unknown[]) => unknown)\n | undefined;\n const result = handler?.();\n if (!handler) options.emitConfirm();\n if (result instanceof Promise) {\n loading.value = true;\n result\n .then(() => {\n loading.value = false;\n options.close();\n })\n .catch(() => {\n loading.value = false;\n });\n } else {\n options.close();\n }\n }\n\n function handleCancel() {\n if (loading.value) return;\n options.emitCancel();\n options.close();\n }\n\n return { loading, handleConfirm, handleCancel };\n}\n"
|
|
18
|
+
"content": "import { ref, type ComponentInternalInstance } from \"vue\";\n\nexport interface ConfirmPendingOptions {\n /** 当前组件实例:从 vnode 上取原始 onConfirm 监听器(emit 不回传返回值) */\n instance: ComponentInternalInstance | null;\n /** 无监听器时补发 confirm 事件 */\n emitConfirm: () => void;\n emitCancel: () => void;\n /** 关闭弹层(走受控桥) */\n close: () => void;\n}\n\n/**\n * 确认弹层公共 pending 语义:@confirm 处理器返回 Promise 时锁定关闭通道,\n * resolve 后自动关闭,reject 保持打开并退出 loading;同步处理器直接关闭。\n * @param options - pending 配置:组件实例、confirm/cancel 补发与弹层关闭回调\n * @returns loading(确认进行中标记)、handleConfirm(异步确认处理)与 handleCancel(取消处理)\n */\nexport function useConfirmPending(options: ConfirmPendingOptions) {\n const loading = ref(false);\n\n function handleConfirm() {\n if (loading.value) return;\n const handler = options.instance?.vnode.props?.onConfirm as\n | ((...args: unknown[]) => unknown)\n | undefined;\n const result = handler?.();\n if (!handler) options.emitConfirm();\n if (result instanceof Promise) {\n loading.value = true;\n result\n .then(() => {\n loading.value = false;\n options.close();\n })\n .catch(() => {\n loading.value = false;\n });\n } else {\n options.close();\n }\n }\n\n function handleCancel() {\n if (loading.value) return;\n options.emitCancel();\n options.close();\n }\n\n return { loading, handleConfirm, handleCancel };\n}\n"
|
|
19
19
|
},
|
|
20
20
|
{
|
|
21
21
|
"path": "overlay-shared/useControlledBoolean.ts",
|
|
22
22
|
"type": "registry:lib",
|
|
23
23
|
"target": "components/ui/overlay-shared/useControlledBoolean.ts",
|
|
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"
|
|
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 * @param options - 受控/非受控配置:受控值读取器、非受控初值与变更回调\n * @returns isOpen(当前开合状态)与 setOpen(写入状态并同步 onChange)\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
25
|
},
|
|
26
26
|
{
|
|
27
27
|
"path": "overlay-shared/useOverlayIds.ts",
|
|
28
28
|
"type": "registry:lib",
|
|
29
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
|
|
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 * @param attrs - 组件透传 attrs(其中的 ids 为用户覆盖项,可为 undefined)\n * @param options - 生成配置:primary 为主 part(stemId 不加后缀),parts 为声明覆盖口的 part 列表\n * @returns ids(合并用户覆盖后的完整 id 映射,供 :ids 受控绑定)与 resolveId(取实际生效的字符串 id,供 aria 手动接线)\n */\nexport function useOverlayIds(\n attrs: Record<string, unknown>,\n options: { primary: string; parts: readonly string[] },\n) {\n const stemId = useId();\n const userIds = computed(() => (attrs.ids ?? {}) as OverlayIds);\n /**\n * 默认派生值(不含 user 覆盖),独立于 ids 供 resolveId 回退;构造恒为字符串。\n * @returns 以 part 为键的默认 id 映射\n */\n const buildBase = (): Record<string, string> => {\n const base: Record<string, string> = {};\n for (const part of options.parts) {\n base[part] = part === options.primary ? stemId : `${stemId}-${part}`;\n }\n return base;\n };\n const ids = computed<OverlayIds>(() => ({ ...buildBase(), ...userIds.value })); // user 永远收尾\n /**\n * aria 接线用:user 字符串覆盖优先,函数型 user 回退默认值。\n * @param part - 目标 part 名(如 \"title\"、\"trigger\")\n * @returns 该 part 实际生效的字符串 id;part 未声明覆盖口时返回 undefined\n */\n const resolveId = (part: string) => {\n const v = userIds.value[part];\n return typeof v === \"string\" ? v : buildBase()[part];\n };\n return { ids, resolveId };\n}\n"
|
|
31
31
|
},
|
|
32
32
|
{
|
|
33
33
|
"path": "overlay-shared/useSandboxOverlay.ts",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "password-input",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.8",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "密码输入框:内置明文/掩码切换按钮(Eye/EyeOff,带 aria 语义),值与可见性均支持 v-model 受控。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "pin-input",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.8",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "多格验证码输入:length 指定格数,支持 otp/mask/字符类型、焦点自动跳格与填满回调,可选分隔符插槽。",
|
|
7
7
|
"registryDependencies": ["utils"],
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "popconfirm",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.8",
|
|
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,11 +1,11 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://ui.shadcn.com/schema/registry-item.json",
|
|
3
3
|
"name": "popover",
|
|
4
|
-
"version": "0.5.
|
|
4
|
+
"version": "0.5.8",
|
|
5
5
|
"type": "registry:ui",
|
|
6
6
|
"description": "气泡弹层:基于 Ark UI Popover 原语的单组件,默认插槽为触发元素本体(asChild 语义),面板内容放 #content 插槽,受控/非受控开关。",
|
|
7
7
|
"registryDependencies": ["utils", "overlay-shared"],
|
|
8
|
-
"dependencies": ["@ark-ui/vue@^5.39.2"],
|
|
8
|
+
"dependencies": ["@ark-ui/vue@^5.39.2", "clsx@^2.1.1"],
|
|
9
9
|
"files": [
|
|
10
10
|
{
|
|
11
11
|
"path": "popover/Popover.vue",
|