ensis-ui 0.0.0-stage → 3.0.0

package/dist/components/fieldset/src/RsFieldset.impl.js

@@ -0,0 +1,145 @@
+import { useRsI18n } from "../../../composables/useRsI18n.js";
+import { useRsFormContext } from "../../form/src/form-utils.js";
+import RsTooltip_default from "../../tooltip/src/RsTooltip.js";
+import { resolveFieldsetInvalid, resolveFieldsetTitleSize, resolveFieldsetTitleWeight, resolveFieldsetTooltip } from "./fieldset-utils.js";
+import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createTextVNode, defineComponent, normalizeClass, normalizeStyle, openBlock, renderSlot, toDisplayString, unref, useId, useSlots, withCtx } from "vue";
+//#region src/components/fieldset/src/RsFieldset.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = [
+	"id",
+	"name",
+	"form",
+	"disabled",
+	"aria-invalid",
+	"aria-describedby"
+];
+var _hoisted_2 = {
+	key: 0,
+	class: "rs-fieldset__legend"
+};
+var _hoisted_3 = { class: "rs-fieldset__heading" };
+var _hoisted_4 = { class: "rs-fieldset__title" };
+var _hoisted_5 = {
+	key: 0,
+	class: "rs-fieldset__required",
+	"aria-hidden": "true"
+};
+var _hoisted_6 = {
+	key: 1,
+	class: "rs-fieldset__sr"
+};
+var _hoisted_7 = {
+	key: 0,
+	class: "rs-fieldset__extra"
+};
+var _hoisted_8 = { class: "rs-fieldset__body" };
+var _hoisted_9 = ["id"];
+var _hoisted_10 = ["id"];
+var RsFieldset_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsFieldset",
+	__name: "RsFieldset",
+	props: {
+		legend: {},
+		tooltip: {},
+		description: {},
+		disabled: {
+			type: Boolean,
+			default: false
+		},
+		size: { default: "md" },
+		name: {},
+		form: {},
+		id: {},
+		required: {
+			type: Boolean,
+			default: false
+		},
+		invalid: {
+			type: Boolean,
+			default: false
+		},
+		error: {},
+		borderStyle: { default: "solid" },
+		borderTone: { default: "default" },
+		titleWeight: { default: "semibold" },
+		titleTone: { default: "default" },
+		titleSize: { default: "sm" }
+	},
+	setup(__props) {
+		const props = __props;
+		const slots = useSlots();
+		const { t } = useRsI18n();
+		const formContext = useRsFormContext();
+		const autoErrorId = useId();
+		const autoHintId = useId();
+		const isDisabled = computed(() => Boolean(props.disabled || formContext?.disabled.value));
+		const resolvedTooltip = computed(() => resolveFieldsetTooltip(props.tooltip, props.description));
+		const hasTooltip = computed(() => Boolean(resolvedTooltip.value || slots.tooltip));
+		const hasError = computed(() => Boolean(props.error?.trim() || slots.error));
+		const isInvalid = computed(() => resolveFieldsetInvalid(props.invalid, props.error, Boolean(slots.error)));
+		const hasLegend = computed(() => Boolean(props.legend || slots.legend || slots.extra || hasTooltip.value || props.required));
+		const showDisabledHint = computed(() => isDisabled.value && hasTooltip.value);
+		const helpLabel = computed(() => t("fieldset.help", "Group help"));
+		const errorId = computed(() => hasError.value ? autoErrorId : void 0);
+		const hintId = computed(() => showDisabledHint.value ? autoHintId : void 0);
+		const describedBy = computed(() => {
+			const ids = [errorId.value, hintId.value].filter(Boolean);
+			return ids.length ? ids.join(" ") : void 0;
+		});
+		const rootClass = computed(() => [
+			"rs-fieldset",
+			`rs-fieldset--${props.size}`,
+			`rs-fieldset--${props.borderStyle}`,
+			`rs-fieldset--tone-${props.borderTone}`,
+			`rs-fieldset--title-${props.titleTone}`,
+			{
+				"rs-fieldset--disabled": isDisabled.value,
+				"rs-fieldset--invalid": isInvalid.value
+			}
+		]);
+		const rootStyle = computed(() => ({
+			"--rs-fieldset-title-size": resolveFieldsetTitleSize(props.titleSize),
+			"--rs-fieldset-title-weight": resolveFieldsetTitleWeight(props.titleWeight)
+		}));
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("fieldset", {
+				id: __props.id,
+				class: normalizeClass(rootClass.value),
+				style: normalizeStyle(rootStyle.value),
+				name: __props.name,
+				form: __props.form,
+				disabled: isDisabled.value,
+				"aria-invalid": isInvalid.value ? "true" : void 0,
+				"aria-describedby": describedBy.value
+			}, [hasLegend.value ? (openBlock(), createElementBlock("legend", _hoisted_2, [createElementVNode("span", _hoisted_3, [
+				renderSlot(_ctx.$slots, "legend", {}, () => [createElementVNode("span", _hoisted_4, toDisplayString(__props.legend), 1)], true),
+				__props.required ? (openBlock(), createElementBlock("span", _hoisted_5, "*")) : createCommentVNode("", true),
+				__props.required ? (openBlock(), createElementBlock("span", _hoisted_6, toDisplayString(unref(t)("label.required")), 1)) : createCommentVNode("", true),
+				hasTooltip.value && !isDisabled.value ? (openBlock(), createBlock(RsTooltip_default, {
+					key: 2,
+					icon: "",
+					content: resolvedTooltip.value,
+					"aria-label": helpLabel.value
+				}, createSlots({ _: 2 }, [_ctx.$slots.tooltip ? {
+					name: "content",
+					fn: withCtx(() => [renderSlot(_ctx.$slots, "tooltip", {}, void 0, true)]),
+					key: "0"
+				} : void 0]), 1032, ["content", "aria-label"])) : createCommentVNode("", true)
+			]), _ctx.$slots.extra ? (openBlock(), createElementBlock("span", _hoisted_7, [renderSlot(_ctx.$slots, "extra", {}, void 0, true)])) : createCommentVNode("", true)])) : createCommentVNode("", true), createElementVNode("div", _hoisted_8, [
+				showDisabledHint.value ? (openBlock(), createElementBlock("div", {
+					key: 0,
+					id: hintId.value,
+					class: "rs-fieldset__hint"
+				}, [renderSlot(_ctx.$slots, "tooltip", {}, () => [createTextVNode(toDisplayString(resolvedTooltip.value), 1)], true)], 8, _hoisted_9)) : createCommentVNode("", true),
+				renderSlot(_ctx.$slots, "default", {}, void 0, true),
+				hasError.value ? (openBlock(), createElementBlock("p", {
+					key: 1,
+					id: errorId.value,
+					class: "rs-fieldset__error",
+					role: "alert"
+				}, [renderSlot(_ctx.$slots, "error", {}, () => [createTextVNode(toDisplayString(__props.error), 1)], true)], 8, _hoisted_10)) : createCommentVNode("", true)
+			])], 14, _hoisted_1);
+		};
+	}
+});
+//#endregion
+export { RsFieldset_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/fieldset/src/RsFieldset.js

@@ -0,0 +1,8 @@
+import './RsFieldset.css'
+import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_export-helper.js";
+import RsFieldset_vue_vue_type_script_setup_true_lang_default from "./RsFieldset.impl.js";
+
+//#region src/components/fieldset/src/RsFieldset.vue
+var RsFieldset_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsFieldset_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-460cb31f"]]);
+//#endregion
+export { RsFieldset_default as default };

package/dist/components/fieldset/src/fieldset-utils.d.ts

@@ -0,0 +1,33 @@
+import type { RsFontSize, RsFontWeight } from '../../../theme/types';
+/**
+ * 表单分组密度。只影响内边距与组内间距，不改变控件高度。
+ */
+export type RsFieldsetSize = 'sm' | 'md';
+/**
+ * 边框线型。对齐 CSS `border-style`（solid / dashed / dotted）。
+ */
+export type RsFieldsetBorderStyle = 'solid' | 'dashed' | 'dotted';
+/**
+ * 边框浓度。
+ * - default：主题分隔线
+ * - subtle：弱分隔
+ * - faded：虚化（降低不透明度）
+ */
+export type RsFieldsetBorderTone = 'default' | 'subtle' | 'faded';
+/**
+ * 标题对比（清晰度）。
+ * - strong：最高对比
+ * - default：正文色
+ * - muted：次要说明色
+ */
+export type RsFieldsetTitleTone = 'strong' | 'default' | 'muted';
+/** 分组标题字号，只开放 caption / 次要 / 正文三档。 */
+export type RsFieldsetTitleSize = Extract<RsFontSize, 'xs' | 'sm' | 'base'>;
+/** 解析标题字号 token。 */
+export declare function resolveFieldsetTitleSize(size: RsFieldsetTitleSize): string;
+/** 解析标题字重 token。 */
+export declare function resolveFieldsetTitleWeight(weight: RsFontWeight): string;
+/** tooltip 优先；弃用的 description 仍映射到同一 tip。 */
+export declare function resolveFieldsetTooltip(tooltip: string | undefined, description: string | undefined): string;
+/** 显式 invalid，或有错误文案 / #error，都算组级失败。 */
+export declare function resolveFieldsetInvalid(invalid: boolean, error: string | undefined, hasErrorSlot: boolean): boolean;

package/dist/components/fieldset/src/fieldset-utils.js

@@ -0,0 +1,20 @@
+import { RS_FONT_SIZE_CSS, RS_FONT_WEIGHT_CSS } from "../../../theme/types.js";
+//#region src/components/fieldset/src/fieldset-utils.ts
+/** 解析标题字号 token。 */
+function resolveFieldsetTitleSize(size) {
+	return RS_FONT_SIZE_CSS[size];
+}
+/** 解析标题字重 token。 */
+function resolveFieldsetTitleWeight(weight) {
+	return RS_FONT_WEIGHT_CSS[weight];
+}
+/** tooltip 优先；弃用的 description 仍映射到同一 tip。 */
+function resolveFieldsetTooltip(tooltip, description) {
+	return (tooltip || description || "").trim();
+}
+/** 显式 invalid，或有错误文案 / #error，都算组级失败。 */
+function resolveFieldsetInvalid(invalid, error, hasErrorSlot) {
+	return Boolean(invalid || error?.trim() || hasErrorSlot);
+}
+//#endregion
+export { resolveFieldsetInvalid, resolveFieldsetTitleSize, resolveFieldsetTitleWeight, resolveFieldsetTooltip };

package/dist/components/form/index.d.ts

@@ -0,0 +1,10 @@
+export { default as RsForm } from './src/RsForm.js';
+export type { RsFormExpose, RsFormInstance } from './src/RsForm.js';
+export { default as RsFormItem } from './src/RsFormItem.js';
+export { default as RsFormList } from './src/RsFormList.js';
+export type { RsFormContext, RsFormErrorRender, RsFormErrorRenderContext, RsFormFieldExpose, RsFormItemContext, RsFormListContext, RsFormListField, RsFormListOperations, RsFormFieldValidationResult, RsFormGap, RsFormLabelAlign, RsFormLabelPosition, RsFormMaxWidth, RsFormSize, RsFormValidateStatus, RsFormValidationResult, } from './src/form-utils';
+export { cloneFormFieldValue, isRsFormItemBoundControl, provideRsFormItemContext, provideRsFormListContext, RS_FORM_INJECTION_KEY, RS_FORM_ITEM_INJECTION_KEY, RS_FORM_LIST_INJECTION_KEY, resolveFieldRules, useRsFormContext, useRsFormField, useRsFormItemContext, useRsFormListContext, } from './src/form-utils';
+export type { RsFormNamePath } from './src/form-path';
+export { concatNamePath, getByNamePath, hasByNamePath, isIndexSegment, namePathKey, normalizeNamePath, setByNamePath, } from './src/form-path';
+export type { RsFormRuleItem, RsFormRuleMessage, RsFormRules, RsFormRuleTrigger, RsFormRuleValidateResult, RsFormValidateMessages, RsFormValidatorContext, } from './src/form-rules';
+export { buildLocalInputRules, matchFormRuleTrigger, normalizeFormRules, resolveRuleMessage, runFormFieldRules, } from './src/form-rules';

package/dist/components/form/src/RsForm.css

@@ -0,0 +1,33 @@
+
+.rs-form[data-v-0cdc7aeb] {
+  --rs-form-max-sm: 24rem;
+  --rs-form-max-md: 32rem;
+  --rs-form-max-lg: 48rem;
+  display: flex;
+  flex-direction: column;
+  width: 100%;
+}
+.rs-form--gap-sm[data-v-0cdc7aeb] {
+  gap: var(--rs-space-sm);
+}
+.rs-form--gap-md[data-v-0cdc7aeb] {
+  gap: var(--rs-space-md);
+}
+.rs-form--gap-lg[data-v-0cdc7aeb] {
+  gap: var(--rs-space-lg);
+}
+.rs-form--max-sm[data-v-0cdc7aeb] {
+  max-width: var(--rs-form-max-sm);
+}
+.rs-form--max-md[data-v-0cdc7aeb] {
+  max-width: var(--rs-form-max-md);
+}
+.rs-form--max-lg[data-v-0cdc7aeb] {
+  max-width: var(--rs-form-max-lg);
+}
+.rs-form--max-full[data-v-0cdc7aeb] {
+  max-width: 100%;
+}
+.rs-form--max-none[data-v-0cdc7aeb] {
+  max-width: none;
+}

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

@@ -0,0 +1,78 @@
+import type { RsFormErrorRender, RsFormFieldValidationResult, RsFormGap, RsFormLabelAlign, RsFormLabelPosition, RsFormMaxWidth, RsFormSize, RsFormValidationResult } from './form-utils';
+import type { RsFormRuleTrigger, RsFormRules, RsFormValidateMessages } from './form-rules';
+import { type RsFormNamePath } from './form-path';
+/**
+ * RsForm 模板 ref 请用此类型。
+ * 不要写 `InstanceType<typeof RsForm>`：组件实例类型过深，vue-tsc 会报 Excessive stack depth。
+ */
+export interface RsFormExpose {
+    validate: (trigger?: RsFormRuleTrigger) => Promise<RsFormValidationResult>;
+    validateField: (name: string, trigger?: RsFormRuleTrigger) => Promise<RsFormFieldValidationResult>;
+    clearValidation: (names?: string | string[]) => void;
+    resetFields: (names?: string | string[]) => void;
+    getFieldsValue: () => Record<string, unknown>;
+    setFieldsValue: (values: Record<string, unknown>) => void;
+    getFieldValue: (name: RsFormNamePath) => unknown;
+    setFieldValue: (name: RsFormNamePath, value: unknown) => void;
+    scrollToField: (name: RsFormNamePath) => void;
+}
+/** 模板 ref 实例：expose + 根 form */
+export type RsFormInstance = RsFormExpose & {
+    $el: HTMLFormElement;
+};
+type __VLS_Props = {
+    disabled?: boolean;
+    labelPosition?: RsFormLabelPosition;
+    labelWidth?: string;
+    labelAlign?: RsFormLabelAlign;
+    size?: RsFormSize;
+    gap?: RsFormGap;
+    maxWidth?: RsFormMaxWidth;
+    /**
+     * 集中声明校验规则（按字段 name 匹配）。
+     * 与字段自身 required/rule/validator 合并执行。
+     */
+    rules?: RsFormRules;
+    /**
+     * 表单数据中枢（对齐 Ant Design Form.model）。
+     * Form.Item 声明 name 后读写此对象；也可继续在控件上 v-model。
+     */
+    model?: Record<string, unknown>;
+    /** 覆盖默认校验文案模板，支持 `{label}` */
+    validateMessages?: RsFormValidateMessages;
+    /** 原生 form 提交时自动跑一遍校验（默认 true） */
+    validateOnSubmit?: boolean;
+    /**
+     * 自定义错误渲染（函数式）。
+     * 也可用 `#error="{ name, message, value }"` 插槽，插槽优先。
+     */
+    errorRender?: RsFormErrorRender;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, RsFormExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    submit: (event: Event) => any;
+    validate: (result: RsFormValidationResult) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSubmit?: ((event: Event) => any) | undefined;
+    onValidate?: ((result: RsFormValidationResult) => any) | undefined;
+}>, {
+    maxWidth: RsFormMaxWidth;
+    gap: RsFormGap;
+    size: RsFormSize;
+    disabled: boolean;
+    labelWidth: string;
+    labelAlign: RsFormLabelAlign;
+    labelPosition: RsFormLabelPosition;
+    validateOnSubmit: boolean;
+}, {}, {}, {}, 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/RsForm.impl.js

@@ -0,0 +1,201 @@
+import { getByNamePath, namePathKey, setByNamePath } from "./form-path.js";
+import { cloneFormFieldValue, normalizeRsFormNameFilter, provideRsFormContext, resolveFieldRules, scrollRsFormField } from "./form-utils.js";
+import { computed, createElementBlock, defineComponent, normalizeClass, onBeforeUnmount, openBlock, renderSlot, toRef, useSlots, useTemplateRef } from "vue";
+//#region src/components/form/src/RsForm.vue?vue&type=script&setup=true&lang.ts
+var RsForm_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsForm",
+	__name: "RsForm",
+	props: {
+		disabled: {
+			type: Boolean,
+			default: false
+		},
+		labelPosition: { default: "top" },
+		labelWidth: { default: "6rem" },
+		labelAlign: { default: "start" },
+		size: { default: "md" },
+		gap: { default: "md" },
+		maxWidth: { default: "full" },
+		rules: {},
+		model: {},
+		validateMessages: {},
+		validateOnSubmit: {
+			type: Boolean,
+			default: true
+		},
+		errorRender: {}
+	},
+	emits: ["submit", "validate"],
+	setup(__props, { expose: __expose, emit: __emit }) {
+		const props = __props;
+		const emit = __emit;
+		const slots = useSlots();
+		const formEl = useTemplateRef("formEl");
+		const fields = /* @__PURE__ */ new Map();
+		const fieldsByName = /* @__PURE__ */ new Map();
+		const initialValues = /* @__PURE__ */ new Map();
+		let mounted = true;
+		const disabledRef = computed(() => props.disabled);
+		const labelPositionRef = computed(() => props.labelPosition);
+		const labelWidthRef = computed(() => props.labelWidth);
+		const labelAlignRef = computed(() => props.labelAlign);
+		const sizeRef = computed(() => props.size);
+		const rulesRef = toRef(props, "rules");
+		const modelRef = toRef(props, "model");
+		const validateMessagesRef = computed(() => props.validateMessages);
+		function registerField(id, field) {
+			fields.set(id, field);
+			initialValues.set(id, cloneFormFieldValue(field.getValue()));
+			if (field.name && !fieldsByName.has(field.name)) fieldsByName.set(field.name, field);
+		}
+		function unregisterField(id) {
+			const field = fields.get(id);
+			fields.delete(id);
+			initialValues.delete(id);
+			if (field?.name && fieldsByName.get(field.name) === field) fieldsByName.delete(field.name);
+		}
+		function findField(name) {
+			return fieldsByName.get(name);
+		}
+		function getFieldRules(name) {
+			return resolveFieldRules(props.rules, name);
+		}
+		function getFieldValue(name) {
+			if (modelRef.value) return getByNamePath(modelRef.value, name);
+			return findField(namePathKey(name))?.getValue();
+		}
+		function setFieldValue(name, value) {
+			if (modelRef.value) {
+				setByNamePath(modelRef.value, name, value);
+				return;
+			}
+			findField(namePathKey(name))?.setValue(value);
+		}
+		function getFieldsValue() {
+			if (modelRef.value) return { ...modelRef.value };
+			const values = {};
+			fields.forEach((field) => {
+				if (!field.name) return;
+				values[field.name] = field.getValue();
+			});
+			return values;
+		}
+		function setFieldsValue(values) {
+			Object.entries(values).forEach(([name, value]) => {
+				setFieldValue(name, value);
+			});
+		}
+		function scrollToField(name) {
+			scrollRsFormField(formEl.value, name);
+		}
+		function renderError(ctx) {
+			if (slots.error) return slots.error(ctx);
+			return props.errorRender?.(ctx);
+		}
+		provideRsFormContext({
+			disabled: disabledRef,
+			labelPosition: labelPositionRef,
+			labelWidth: labelWidthRef,
+			labelAlign: labelAlignRef,
+			size: sizeRef,
+			rules: rulesRef,
+			getFieldRules,
+			renderError,
+			registerField,
+			unregisterField,
+			model: modelRef,
+			validateMessages: validateMessagesRef,
+			getFieldValue,
+			setFieldValue,
+			getFieldsValue
+		});
+		function collectResult(results) {
+			const errors = {};
+			for (const result of results) if (!result.valid && result.name && result.message && !errors[result.name]) errors[result.name] = result.message;
+			return {
+				valid: results.every((result) => result.valid),
+				errors
+			};
+		}
+		/** 校验全部字段；可传 trigger 过滤规则 */
+		async function validate(trigger = "submit") {
+			const aggregated = collectResult(await Promise.all(Array.from(fields.values()).map((field) => field.validate?.(trigger) ?? {
+				valid: true,
+				name: field.name
+			})));
+			if (!mounted) return aggregated;
+			emit("validate", aggregated);
+			return aggregated;
+		}
+		/** 按 name 校验单个字段 */
+		async function validateField(name, trigger = "submit") {
+			const field = findField(name);
+			if (!field) return {
+				valid: true,
+				name
+			};
+			return {
+				...await field.validate?.(trigger) ?? {
+					valid: true,
+					name
+				},
+				name
+			};
+		}
+		function clearValidation(names) {
+			const nameSet = normalizeRsFormNameFilter(names);
+			fields.forEach((field) => {
+				if (nameSet && (!field.name || !nameSet.has(field.name))) return;
+				field.clearValidation?.();
+			});
+		}
+		function resetFields(names) {
+			const nameSet = normalizeRsFormNameFilter(names);
+			fields.forEach((field, id) => {
+				if (nameSet && (!field.name || !nameSet.has(field.name))) return;
+				field.setValue(cloneFormFieldValue(initialValues.get(id)));
+				field.clearValidation?.();
+			});
+		}
+		async function onSubmit(event) {
+			if (props.validateOnSubmit) {
+				event.preventDefault();
+				if (!(await validate("submit")).valid) return;
+			}
+			if (!mounted) return;
+			emit("submit", event);
+		}
+		onBeforeUnmount(() => {
+			mounted = false;
+			fields.clear();
+			fieldsByName.clear();
+			initialValues.clear();
+		});
+		__expose({
+			validate,
+			validateField,
+			clearValidation,
+			resetFields,
+			getFieldsValue,
+			setFieldsValue,
+			getFieldValue,
+			setFieldValue,
+			scrollToField
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("form", {
+				ref_key: "formEl",
+				ref: formEl,
+				class: normalizeClass(["rs-form", [
+					`rs-form--gap-${__props.gap}`,
+					`rs-form--max-${__props.maxWidth}`,
+					`rs-form--label-${__props.labelPosition}`
+				]]),
+				novalidate: "",
+				onSubmit
+			}, [renderSlot(_ctx.$slots, "default", {}, void 0, true)], 34);
+		};
+	}
+});
+//#endregion
+export { RsForm_vue_vue_type_script_setup_true_lang_default as default };

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

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

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

@@ -0,0 +1,52 @@
+
+.rs-form-item__control[data-v-4e86187e] {
+  width: 100%;
+  min-height: var(--rs-control-height-md);
+  min-width: 0;
+}
+
+/*
+ * 左侧标签与控件行等高、文字垂直居中。
+ * 网格仍是 align-items:start，错误文案在第 2 列，不会把 label 顶歪。
+ */
+.rs-field--label-left > .rs-field__label[data-v-4e86187e] {
+  display: flex;
+  align-items: center;
+  box-sizing: border-box;
+  min-height: var(--rs-control-height-md);
+}
+.rs-form-item--ssm.rs-field--label-left > .rs-field__label[data-v-4e86187e],
+.rs-form-item--ssm .rs-form-item__control[data-v-4e86187e] {
+  min-height: var(--rs-control-height-ssm);
+}
+.rs-form-item--sm.rs-field--label-left > .rs-field__label[data-v-4e86187e],
+.rs-form-item--sm .rs-form-item__control[data-v-4e86187e] {
+  min-height: var(--rs-control-height-sm);
+}
+.rs-form-item--lg.rs-field--label-left > .rs-field__label[data-v-4e86187e],
+.rs-form-item--lg .rs-form-item__control[data-v-4e86187e] {
+  min-height: var(--rs-control-height-lg);
+}
+.rs-field--label-left .rs-form-item__control[data-v-4e86187e],
+.rs-field--label-left .rs-form-item__error[data-v-4e86187e],
+.rs-field--label-left .rs-form-item__help[data-v-4e86187e],
+.rs-field--label-left .rs-form-item__extra[data-v-4e86187e] {
+  grid-column: 2;
+}
+.rs-form-item__error[data-v-4e86187e],
+.rs-form-item__help[data-v-4e86187e],
+.rs-form-item__extra[data-v-4e86187e] {
+  margin: 0.25rem 0 0;
+  font-size: var(--rs-font-size-xs);
+  line-height: var(--rs-line-height-tight);
+}
+.rs-form-item__error[data-v-4e86187e] {
+  color: var(--rs-danger);
+}
+.rs-form-item__help[data-v-4e86187e],
+.rs-form-item__extra[data-v-4e86187e] {
+  color: var(--rs-muted);
+}
+.rs-form-item--warning .rs-form-item__error[data-v-4e86187e] {
+  color: var(--rs-warning, #d48806);
+}

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

@@ -0,0 +1,80 @@
+import { type RsFormLabelPosition, type RsFormValidateStatus } from './form-utils';
+import { type RsFormRuleItem, type RsFormRuleTrigger } from './form-rules';
+import { type RsFormNamePath } from './form-path';
+type __VLS_Props = {
+    name?: RsFormNamePath;
+    label?: string;
+    required?: boolean;
+    rules?: RsFormRuleItem | RsFormRuleItem[];
+    invalid?: boolean;
+    errorMessage?: string;
+    showMessage?: boolean;
+    hint?: string;
+    /** 标签旁帮助图标，悬停出提示（对齐 Ant Design Form.Item tooltip，不另起一行） */
+    tooltip?: string;
+    /** 始终展示的辅助说明（错误出现时仍保留） */
+    extra?: string;
+    /** 无错误时的说明；出错时被错误文案替换 */
+    help?: string;
+    validateStatus?: RsFormValidateStatus;
+    /** 不渲染标签与外壳，只保留控件与错误（schema 表单外置 label） */
+    noStyle?: boolean;
+    /** 依赖字段变化时重新校验本字段（对齐 Ant Design dependencies） */
+    dependencies?: RsFormNamePath[];
+    labelPosition?: RsFormLabelPosition;
+};
+declare function runValidate(trigger?: RsFormRuleTrigger): Promise<boolean>;
+declare function setError(message: string): void;
+declare function setValue(value: unknown): void;
+declare function clearValidation(): void;
+type __VLS_ModelProps = {
+    modelValue?: unknown;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_1: {}, __VLS_14: {
+    id: string;
+    invalid: boolean;
+    message: string;
+    field: string | undefined;
+    status: RsFormValidateStatus;
+}, __VLS_16: {
+    name: string | undefined;
+    message: string;
+    value: unknown;
+};
+type __VLS_Slots = {} & {
+    label?: (props: typeof __VLS_1) => any;
+} & {
+    default?: (props: typeof __VLS_14) => any;
+} & {
+    error?: (props: typeof __VLS_16) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {
+    validate: typeof runValidate;
+    clearValidation: typeof clearValidation;
+    setValue: typeof setValue;
+    setError: typeof setError;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: unknown) => any;
+    validate: (result: {
+        valid: boolean;
+        message?: string;
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: unknown) => any) | undefined;
+    onValidate?: ((result: {
+        valid: boolean;
+        message?: string;
+    }) => any) | undefined;
+}>, {
+    showMessage: boolean;
+    noStyle: boolean;
+}, {}, {}, {}, 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;
+    };
+};