ensis-ui 0.0.0-stage → 3.0.0

package/dist/components/form/src/RsFormItem.impl.js

@@ -0,0 +1,298 @@
+import { useRsI18n } from "../../../composables/useRsI18n.js";
+import { buildLocalInputRules, normalizeFormRules, runFormFieldRules } from "./form-rules.js";
+import { concatNamePath, isIndexSegment, namePathKey } from "./form-path.js";
+import { provideRsFormItemContext, useRsFormContext, useRsFormField, useRsFormListContext } from "./form-utils.js";
+import RsVNodeHost_default from "../../vnode-host/src/RsVNodeHost.js";
+import RsTooltip_default from "../../tooltip/src/RsTooltip.js";
+import RsFormItemControl_default from "./RsFormItemControl.js";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, guardReactiveProps, mergeModels, normalizeClass, normalizeProps, normalizeStyle, openBlock, ref, renderSlot, toDisplayString, unref, useId, useModel, useSlots, watch, withCtx } from "vue";
+//#region src/components/form/src/RsFormItem.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = ["data-rs-form-item"];
+var _hoisted_2 = {
+	key: 0,
+	class: "rs-field__label"
+};
+var _hoisted_3 = ["for"];
+var _hoisted_4 = {
+	key: 1,
+	class: "rs-field__required",
+	"aria-hidden": "true"
+};
+var _hoisted_5 = { class: "rs-form-item__control" };
+var _hoisted_6 = ["id"];
+var _hoisted_7 = ["id"];
+var _hoisted_8 = {
+	key: 3,
+	class: "rs-field__hint"
+};
+var _hoisted_9 = ["id"];
+/**
+* 表单项容器：包住任意自定义控件，负责 name / rules / 错误文案。
+* 对标 Ant Design Form.Item、Element Plus ElFormItem。
+* 内置 RsInput / RsSelect 已自行注册；放在已声明 name 的 Item 内时不再重复注册。
+*/
+var RsFormItem_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsFormItem",
+	__name: "RsFormItem",
+	props: /*@__PURE__*/ mergeModels({
+		name: {},
+		label: {},
+		required: { type: Boolean },
+		rules: {},
+		invalid: { type: Boolean },
+		errorMessage: {},
+		showMessage: {
+			type: Boolean,
+			default: true
+		},
+		hint: {},
+		tooltip: {},
+		extra: {},
+		help: {},
+		validateStatus: {},
+		noStyle: {
+			type: Boolean,
+			default: false
+		},
+		dependencies: {},
+		labelPosition: {}
+	}, {
+		"modelValue": {},
+		"modelModifiers": {}
+	}),
+	emits: /*@__PURE__*/ mergeModels(["validate"], ["update:modelValue"]),
+	setup(__props, { expose: __expose, emit: __emit }) {
+		const model = useModel(__props, "modelValue");
+		const props = __props;
+		const emit = __emit;
+		const { t } = useRsI18n();
+		const slots = useSlots();
+		const formContext = useRsFormContext();
+		const listContext = useRsFormListContext();
+		const fieldId = useId();
+		const errorId = computed(() => `${fieldId}-error`);
+		const extraId = computed(() => `${fieldId}-extra`);
+		const touched = ref(false);
+		const autoInvalid = ref(false);
+		const autoMessage = ref("");
+		const resolvedNamePath = computed(() => {
+			if (props.name == null) return void 0;
+			const own = concatNamePath(props.name);
+			if (!listContext) return own;
+			return concatNamePath(listContext.prefix.value, own);
+		});
+		const nameKey = computed(() => resolvedNamePath.value?.length ? namePathKey(resolvedNamePath.value) : void 0);
+		const ownsField = computed(() => Boolean(nameKey.value));
+		const resolvedLabelPosition = computed(() => props.labelPosition ?? formContext?.labelPosition.value ?? "top");
+		const resolvedLabelAlign = computed(() => formContext?.labelAlign.value ?? "start");
+		const resolvedSize = computed(() => formContext?.size.value ?? "md");
+		function readValue() {
+			const path = resolvedNamePath.value;
+			if (formContext && path?.length && formContext.model.value) return formContext.getFieldValue(path);
+			return model.value;
+		}
+		function writeValue(value) {
+			model.value = value;
+			const path = resolvedNamePath.value;
+			if (formContext?.model.value && path?.length) formContext.setFieldValue(path, value);
+		}
+		/**
+		* 解析 dependencies / getFieldValue 路径。
+		* List 内以数字下标开头的视为相对路径（[0, 'password'] → users.0.password）；
+		* 其它视为表单根路径，便于 List 内依赖根字段。
+		*/
+		function resolveWatchName(name) {
+			const segs = concatNamePath(name);
+			const prefix = listContext?.prefix.value;
+			if (!prefix?.length || !segs.length) return segs;
+			const first = segs[0];
+			if (first !== void 0 && isIndexSegment(first)) return concatNamePath(prefix, segs);
+			return segs;
+		}
+		const showRequiredMark = computed(() => {
+			if (props.required) return true;
+			const formRules = formContext?.getFieldRules(nameKey.value) ?? [];
+			const localRules = [...buildLocalInputRules({ required: props.required }), ...normalizeFormRules(props.rules)];
+			return [...formRules, ...localRules].some((rule) => rule.required);
+		});
+		const displayMessage = computed(() => {
+			if (props.errorMessage) return props.errorMessage;
+			if (props.showMessage && autoInvalid.value) return autoMessage.value;
+			return "";
+		});
+		const isInvalid = computed(() => {
+			if (props.validateStatus === "error") return true;
+			if (props.validateStatus) return false;
+			return props.invalid || autoInvalid.value;
+		});
+		const mergedStatus = computed(() => {
+			if (props.validateStatus) return props.validateStatus;
+			if (isInvalid.value) return "error";
+			return "";
+		});
+		const describedBy = computed(() => {
+			const ids = [];
+			if (displayMessage.value || props.help) ids.push(errorId.value);
+			if (props.extra) ids.push(extraId.value);
+			return ids.length ? ids.join(" ") : void 0;
+		});
+		const errorSlotProps = computed(() => ({
+			name: nameKey.value,
+			message: displayMessage.value,
+			value: readValue()
+		}));
+		const formErrorContent = computed(() => {
+			if (!displayMessage.value || !formContext?.renderError) return null;
+			return formContext.renderError(errorSlotProps.value);
+		});
+		const fieldStyle = computed(() => {
+			if (props.noStyle || resolvedLabelPosition.value !== "left") return void 0;
+			const labelWidth = formContext?.labelWidth.value;
+			if (!labelWidth) return void 0;
+			return { "--rs-field-label-width": labelWidth };
+		});
+		const showLabel = computed(() => Boolean(props.label || slots.label) && !props.noStyle);
+		const controlInject = computed(() => ({
+			id: fieldId,
+			invalid: isInvalid.value,
+			showValidateMessage: false,
+			"aria-invalid": isInvalid.value || void 0,
+			"aria-describedby": describedBy.value,
+			modelValue: readValue(),
+			"onUpdate:modelValue": writeValue
+		}));
+		async function runValidate(trigger = "submit") {
+			touched.value = true;
+			const formRules = formContext?.getFieldRules(nameKey.value) ?? [];
+			const localRules = [...buildLocalInputRules({ required: props.required }), ...normalizeFormRules(props.rules)];
+			const rules = [...formRules, ...localRules];
+			if (!rules.length) {
+				autoInvalid.value = false;
+				autoMessage.value = "";
+				emit("validate", { valid: true });
+				return true;
+			}
+			const result = await runFormFieldRules(readValue(), rules, {
+				trigger,
+				t,
+				name: nameKey.value,
+				label: typeof props.label === "string" ? props.label : void 0,
+				validateMessages: formContext?.validateMessages.value,
+				getFieldValue: (name) => formContext?.getFieldValue(resolveWatchName(name)),
+				getFieldsValue: () => formContext?.getFieldsValue() ?? {}
+			});
+			autoInvalid.value = !result.valid;
+			autoMessage.value = result.message ?? "";
+			emit("validate", result);
+			return result.valid;
+		}
+		function setError(message) {
+			autoInvalid.value = true;
+			autoMessage.value = message;
+		}
+		function setValue(value) {
+			writeValue(value);
+		}
+		function clearValidation() {
+			touched.value = false;
+			autoInvalid.value = false;
+			autoMessage.value = "";
+		}
+		useRsFormField(() => {
+			if (!nameKey.value) return void 0;
+			return {
+				name: nameKey.value,
+				getValue: () => readValue(),
+				setValue,
+				validate: async (trigger) => {
+					return {
+						valid: await runValidate(trigger ?? "submit"),
+						message: autoMessage.value || void 0,
+						name: nameKey.value
+					};
+				},
+				clearValidation,
+				setError
+			};
+		});
+		provideRsFormItemContext({
+			name: nameKey,
+			ownsField,
+			invalid: isInvalid,
+			message: displayMessage,
+			status: mergedStatus,
+			fieldId: computed(() => fieldId),
+			errorId,
+			describedBy
+		});
+		watch(() => readValue(), () => {
+			if (touched.value) runValidate("change");
+		});
+		watch(() => JSON.stringify((props.dependencies ?? []).map((name) => formContext?.getFieldValue(resolveWatchName(name)))), (_next, prev) => {
+			if (prev === void 0) return;
+			const current = readValue();
+			const hasValue = current != null && !(typeof current === "string" && current.trim() === "");
+			if (touched.value || autoInvalid.value || hasValue) runValidate("change");
+		});
+		__expose({
+			validate: runValidate,
+			clearValidation,
+			setValue,
+			setError
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", {
+				class: normalizeClass(["rs-form-item", [
+					!__props.noStyle ? "rs-field" : void 0,
+					!__props.noStyle ? `rs-field--label-${resolvedLabelPosition.value}` : void 0,
+					!__props.noStyle && resolvedLabelPosition.value === "left" && resolvedLabelAlign.value === "end" ? "rs-field--label-align-end" : void 0,
+					mergedStatus.value ? `rs-form-item--${mergedStatus.value}` : void 0,
+					`rs-form-item--${resolvedSize.value}`
+				]]),
+				style: normalizeStyle(fieldStyle.value),
+				"data-rs-form-item": nameKey.value
+			}, [
+				showLabel.value ? (openBlock(), createElementBlock("span", _hoisted_2, [
+					renderSlot(_ctx.$slots, "label", {}, () => [createElementVNode("label", { for: unref(fieldId) }, toDisplayString(__props.label), 9, _hoisted_3)], true),
+					__props.tooltip ? (openBlock(), createBlock(RsTooltip_default, {
+						key: 0,
+						icon: "",
+						content: __props.tooltip
+					}, null, 8, ["content"])) : createCommentVNode("", true),
+					showRequiredMark.value ? (openBlock(), createElementBlock("span", _hoisted_4, "*")) : createCommentVNode("", true)
+				])) : createCommentVNode("", true),
+				createElementVNode("div", _hoisted_5, [createVNode(RsFormItemControl_default, { inject: controlInject.value }, {
+					default: withCtx(() => [renderSlot(_ctx.$slots, "default", {
+						id: unref(fieldId),
+						invalid: isInvalid.value,
+						message: displayMessage.value,
+						field: nameKey.value,
+						status: mergedStatus.value
+					}, void 0, true)]),
+					_: 3
+				}, 8, ["inject"])]),
+				displayMessage.value ? (openBlock(), createElementBlock("p", {
+					key: 1,
+					id: errorId.value,
+					class: "rs-form-item__error",
+					role: "alert"
+				}, [renderSlot(_ctx.$slots, "error", normalizeProps(guardReactiveProps(errorSlotProps.value)), () => [formErrorContent.value !== null && formErrorContent.value !== void 0 ? (openBlock(), createBlock(RsVNodeHost_default, {
+					key: 0,
+					content: formErrorContent.value
+				}, null, 8, ["content"])) : (openBlock(), createElementBlock(Fragment, { key: 1 }, [createTextVNode(toDisplayString(displayMessage.value), 1)], 64))], true)], 8, _hoisted_6)) : __props.help ? (openBlock(), createElementBlock("p", {
+					key: 2,
+					id: errorId.value,
+					class: "rs-form-item__help"
+				}, toDisplayString(__props.help), 9, _hoisted_7)) : createCommentVNode("", true),
+				__props.hint && !__props.noStyle ? (openBlock(), createElementBlock("span", _hoisted_8, toDisplayString(__props.hint), 1)) : createCommentVNode("", true),
+				__props.extra ? (openBlock(), createElementBlock("span", {
+					key: 4,
+					id: extraId.value,
+					class: "rs-form-item__extra"
+				}, toDisplayString(__props.extra), 9, _hoisted_9)) : createCommentVNode("", true)
+			], 14, _hoisted_1);
+		};
+	}
+});
+//#endregion
+export { RsFormItem_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/form/src/RsFormItem.js

@@ -0,0 +1,8 @@
+import './RsFormItem.css'
+import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_export-helper.js";
+import RsFormItem_vue_vue_type_script_setup_true_lang_default from "./RsFormItem.impl.js";
+
+//#region src/components/form/src/RsFormItem.vue
+var RsFormItem_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsFormItem_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-4e86187e"]]);
+//#endregion
+export { RsFormItem_default as default };

package/dist/components/form/src/RsFormItemControl.d.ts

@@ -0,0 +1,21 @@
+import { type PropType, type VNode } from 'vue';
+/**
+ * 将 inject 合并到默认插槽第一个子节点，供 Form.Item 注入控件 props。
+ */
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    inject: {
+        type: PropType<Record<string, unknown>>;
+        default: () => {};
+    };
+}>, () => VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    inject: {
+        type: PropType<Record<string, unknown>>;
+        default: () => {};
+    };
+}>> & Readonly<{}>, {
+    inject: Record<string, unknown>;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/dist/components/form/src/RsFormItemControl.impl.js

@@ -0,0 +1,19 @@
+import { bindFormItemControl } from "./form-item-control.js";
+import { defineComponent } from "vue";
+//#region src/components/form/src/RsFormItemControl.vue?vue&type=script&lang.ts
+/**
+* 将 inject 合并到默认插槽第一个子节点，供 Form.Item 注入控件 props。
+*/
+var RsFormItemControl_vue_vue_type_script_lang_default = defineComponent({
+	name: "RsFormItemControl",
+	inheritAttrs: false,
+	props: { inject: {
+		type: Object,
+		default: () => ({})
+	} },
+	setup(props, { slots }) {
+		return () => bindFormItemControl(slots.default?.(), props.inject);
+	}
+});
+//#endregion
+export { RsFormItemControl_vue_vue_type_script_lang_default as default };

package/dist/components/form/src/RsFormItemControl.js

@@ -0,0 +1,5 @@
+import RsFormItemControl_vue_vue_type_script_lang_default from "./RsFormItemControl.impl.js";
+//#region src/components/form/src/RsFormItemControl.vue
+var RsFormItemControl_default = RsFormItemControl_vue_vue_type_script_lang_default;
+//#endregion
+export { RsFormItemControl_default as default };

package/dist/components/form/src/RsFormList.d.ts

@@ -0,0 +1,23 @@
+import { type RsFormListField } from './form-utils';
+import { type RsFormNamePath } from './form-path';
+type __VLS_Props = {
+    name: RsFormNamePath;
+};
+declare var __VLS_1: {
+    fields: RsFormListField[];
+    add: (defaultValue?: unknown) => void;
+    remove: (index: number) => void;
+    move: (from: number, to: number) => void;
+};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/form/src/RsFormList.impl.js

@@ -0,0 +1,86 @@
+import { concatNamePath } from "./form-path.js";
+import { provideRsFormListContext, useRsFormContext, useRsFormListContext } from "./form-utils.js";
+import { computed, createElementBlock, defineComponent, openBlock, ref, renderSlot, watch } from "vue";
+//#region src/components/form/src/RsFormList.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = { class: "rs-form-list" };
+/**
+* 动态数组字段（对齐 Ant Design Form.List）。
+* 需要 Form.model；子 Item 的 name 为相对路径，会拼上 List 前缀。
+*/
+var RsFormList_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsFormList",
+	__name: "RsFormList",
+	props: { name: {} },
+	setup(__props) {
+		const props = __props;
+		const form = useRsFormContext();
+		const parentList = useRsFormListContext();
+		const prefix = computed(() => concatNamePath(parentList?.prefix.value, props.name));
+		provideRsFormListContext({ prefix });
+		const rowKeys = ref([]);
+		let keySeed = 0;
+		function readList() {
+			const raw = form?.getFieldValue(prefix.value);
+			return Array.isArray(raw) ? raw : [];
+		}
+		function writeList(next) {
+			form?.setFieldValue(prefix.value, next);
+		}
+		function syncKeys(length) {
+			const keys = rowKeys.value;
+			if (keys.length === length) return;
+			if (keys.length < length) {
+				const next = keys.slice();
+				while (next.length < length) {
+					keySeed += 1;
+					next.push(keySeed);
+				}
+				rowKeys.value = next;
+				return;
+			}
+			rowKeys.value = keys.slice(0, length);
+		}
+		watch(() => readList().length, (length) => {
+			syncKeys(length);
+		}, { immediate: true });
+		const fields = computed(() => readList().map((_, index) => ({
+			key: rowKeys.value[index] ?? index,
+			name: index,
+			index
+		})));
+		const add = (defaultValue = {}) => {
+			const current = readList();
+			keySeed += 1;
+			rowKeys.value = [...rowKeys.value, keySeed];
+			writeList([...current, defaultValue]);
+		};
+		const remove = (index) => {
+			const current = readList();
+			if (index < 0 || index >= current.length) return;
+			rowKeys.value = rowKeys.value.filter((_, i) => i !== index);
+			writeList(current.filter((_, i) => i !== index));
+		};
+		const move = (from, to) => {
+			const current = readList();
+			if (from === to || from < 0 || to < 0 || from >= current.length || to >= current.length) return;
+			const next = current.slice();
+			const [row] = next.splice(from, 1);
+			next.splice(to, 0, row);
+			const keys = rowKeys.value.slice();
+			const [key] = keys.splice(from, 1);
+			keys.splice(to, 0, key);
+			rowKeys.value = keys;
+			writeList(next);
+		};
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", _hoisted_1, [renderSlot(_ctx.$slots, "default", {
+				fields: fields.value,
+				add,
+				remove,
+				move
+			})]);
+		};
+	}
+});
+//#endregion
+export { RsFormList_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/form/src/RsFormList.js

@@ -0,0 +1,5 @@
+import RsFormList_vue_vue_type_script_setup_true_lang_default from "./RsFormList.impl.js";
+//#region src/components/form/src/RsFormList.vue
+var RsFormList_default = RsFormList_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { RsFormList_default as default };

package/dist/components/form/src/form-item-control.d.ts

@@ -0,0 +1,7 @@
+import { type VNode } from 'vue';
+/**
+ * 把 Form.Item 的 id / aria / invalid / v-model 注入到默认插槽的第一个控件（对齐 Ant cloneElement）。
+ * 只有这个直接子节点跟 Item 的 error；子孙里的搜索框不吃 invalid。
+ * 子节点已绑定 v-model 时不覆盖（switch Y/N、select 类型映射等）。
+ */
+export declare function bindFormItemControl(children: VNode[] | undefined, extra: Record<string, unknown>): VNode[] | undefined;

package/dist/components/form/src/form-item-control.js

@@ -0,0 +1,46 @@
+import { Comment, Fragment, Text, cloneVNode, isVNode } from "vue";
+//#region src/components/form/src/form-item-control.ts
+function flattenVNodes(nodes, out = []) {
+	for (const node of nodes) {
+		if (node == null || typeof node === "boolean") continue;
+		if (Array.isArray(node)) {
+			flattenVNodes(node, out);
+			continue;
+		}
+		if (!isVNode(node)) continue;
+		if (node.type === Fragment && Array.isArray(node.children)) {
+			flattenVNodes(node.children, out);
+			continue;
+		}
+		out.push(node);
+	}
+	return out;
+}
+function isControlVNode(node) {
+	if (node.type === Comment || node.type === Text) return false;
+	return true;
+}
+/**
+* 把 Form.Item 的 id / aria / invalid / v-model 注入到默认插槽的第一个控件（对齐 Ant cloneElement）。
+* 只有这个直接子节点跟 Item 的 error；子孙里的搜索框不吃 invalid。
+* 子节点已绑定 v-model 时不覆盖（switch Y/N、select 类型映射等）。
+*/
+function bindFormItemControl(children, extra) {
+	if (!children?.length) return children;
+	const flat = flattenVNodes(children);
+	const index = flat.findIndex(isControlVNode);
+	if (index < 0) return children;
+	const target = flat[index];
+	if (!target) return children;
+	const next = flat.slice();
+	next[index] = cloneVNode(target, pickControlInject(target, extra), true);
+	return next;
+}
+function pickControlInject(node, extra) {
+	const props = node.props;
+	if (!props || !("modelValue" in props || "onUpdate:modelValue" in props)) return extra;
+	const { modelValue: _model, "onUpdate:modelValue": _update, ...rest } = extra;
+	return rest;
+}
+//#endregion
+export { bindFormItemControl };

package/dist/components/form/src/form-path.d.ts

@@ -0,0 +1,29 @@
+/** 字段路径：`'user.email'` 或 `['user', 'email']`（对齐 Ant Design NamePath） */
+export type RsFormNamePath = string | Array<string | number>;
+/** 路径段是否为数组下标（Form.List 相对 name 的第一段）。 */
+export declare function isIndexSegment(seg: string | number): boolean;
+/**
+ * 将 NamePath 规范为路径段。字符串按 `.` 拆分。
+ */
+export declare function normalizeNamePath(name?: RsFormNamePath | null): Array<string | number>;
+/**
+ * 拼接多段 NamePath（List 前缀 + Item name）。
+ */
+export declare function concatNamePath(...parts: Array<RsFormNamePath | undefined | null>): Array<string | number>;
+/**
+ * 路径转 rules / DOM 使用的稳定键。
+ */
+export declare function namePathKey(name?: RsFormNamePath | null): string;
+/**
+ * 路径是否已存在于对象树上（含值为 null / undefined 的叶子）。
+ */
+export declare function hasByNamePath(source: unknown, name?: RsFormNamePath | null): boolean;
+/**
+ * 按 NamePath 读取对象字段。
+ */
+export declare function getByNamePath(source: unknown, name?: RsFormNamePath | null): unknown;
+/**
+ * 按 NamePath 写入对象字段。
+ * 中间缺失的容器按下一段是否为下标补 `[]` 或 `{}`，已有数组不会被覆盖成对象。
+ */
+export declare function setByNamePath(target: Record<string, unknown>, name: RsFormNamePath, value: unknown): void;

package/dist/components/form/src/form-path.js

@@ -0,0 +1,78 @@
+//#region src/components/form/src/form-path.ts
+/** 路径段是否为数组下标（Form.List 相对 name 的第一段）。 */
+function isIndexSegment(seg) {
+	if (typeof seg === "number") return Number.isInteger(seg) && seg >= 0;
+	return /^\d+$/.test(seg);
+}
+/**
+* 将 NamePath 规范为路径段。字符串按 `.` 拆分。
+*/
+function normalizeNamePath(name) {
+	if (name == null || name === "") return [];
+	if (Array.isArray(name)) return name.filter((seg) => seg !== "");
+	return String(name).split(".").filter((seg) => seg !== "");
+}
+/**
+* 拼接多段 NamePath（List 前缀 + Item name）。
+*/
+function concatNamePath(...parts) {
+	return parts.flatMap((part) => normalizeNamePath(part));
+}
+/**
+* 路径转 rules / DOM 使用的稳定键。
+*/
+function namePathKey(name) {
+	return normalizeNamePath(name).map(String).join(".");
+}
+/**
+* 路径是否已存在于对象树上（含值为 null / undefined 的叶子）。
+*/
+function hasByNamePath(source, name) {
+	const keys = normalizeNamePath(name);
+	if (!keys.length) return false;
+	let current = source;
+	for (const key of keys) {
+		if (current == null || typeof current !== "object") return false;
+		if (!Object.prototype.hasOwnProperty.call(current, String(key))) return false;
+		current = current[String(key)];
+	}
+	return true;
+}
+/**
+* 按 NamePath 读取对象字段。
+*/
+function getByNamePath(source, name) {
+	const keys = normalizeNamePath(name);
+	if (!keys.length) return void 0;
+	let current = source;
+	for (const key of keys) {
+		if (current == null || typeof current !== "object") return void 0;
+		current = current[String(key)];
+	}
+	return current;
+}
+/**
+* 按 NamePath 写入对象字段。
+* 中间缺失的容器按下一段是否为下标补 `[]` 或 `{}`，已有数组不会被覆盖成对象。
+*/
+function setByNamePath(target, name, value) {
+	const keys = normalizeNamePath(name);
+	if (!keys.length) return;
+	let current = target;
+	for (let i = 0; i < keys.length - 1; i += 1) {
+		if (current == null || typeof current !== "object") return;
+		const obj = current;
+		const key = String(keys[i]);
+		const nextKey = keys[i + 1];
+		let next = obj[key];
+		if (next == null || typeof next !== "object") {
+			next = isIndexSegment(nextKey) ? [] : {};
+			obj[key] = next;
+		}
+		current = next;
+	}
+	if (current == null || typeof current !== "object") return;
+	current[String(keys[keys.length - 1])] = value;
+}
+//#endregion
+export { concatNamePath, getByNamePath, hasByNamePath, isIndexSegment, namePathKey, normalizeNamePath, setByNamePath };