niuma-ui 1.2.9 → 1.3.1

package/dist/components/RsTextarea.impl.js

@@ -0,0 +1,385 @@
+import { useRsI18n } from "../composables/useRsI18n.js";
+import RsIcon_default from "./RsIcon.js";
+import { buildLocalInputRules, runFormFieldRules } from "./form-rules.js";
+import { isRsFormItemBoundControl, useRsFormContext, useRsFormField, useRsFormItemContext } from "./form-utils.js";
+import { useResolvedRsComponentSize } from "./resolve-size.js";
+import { rsRadiusCss, useResolvedRsRadius } from "./resolve-radius.js";
+import { computed, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, mergeModels, mergeProps, nextTick, normalizeClass, normalizeStyle, onMounted, openBlock, ref, renderSlot, toDisplayString, unref, useAttrs, useId, useModel, watch, withModifiers } from "vue";
+//#region src/components/RsTextarea.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = {
+	key: 0,
+	class: "rs-field__label"
+};
+var _hoisted_2 = ["for"];
+var _hoisted_3 = {
+	key: 0,
+	class: "rs-field__required",
+	"aria-hidden": "true"
+};
+var _hoisted_4 = { class: "rs-textarea" };
+var _hoisted_5 = [
+	"id",
+	"value",
+	"rows",
+	"placeholder",
+	"disabled",
+	"readonly",
+	"minlength",
+	"maxlength",
+	"aria-invalid",
+	"aria-describedby"
+];
+var _hoisted_6 = ["aria-label"];
+var _hoisted_7 = ["id"];
+var _hoisted_8 = {
+	key: 1,
+	class: "rs-field__hint"
+};
+var RsTextarea_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	inheritAttrs: false,
+	__name: "RsTextarea",
+	props: /*@__PURE__*/ mergeModels({
+		id: {},
+		placeholder: {},
+		disabled: {
+			type: Boolean,
+			default: false
+		},
+		readonly: {
+			type: Boolean,
+			default: false
+		},
+		invalid: {
+			type: Boolean,
+			default: false
+		},
+		errorMessage: {},
+		size: {},
+		radius: {},
+		rows: { default: 3 },
+		resize: { default: "vertical" },
+		autosize: {
+			type: [Boolean, Object],
+			default: false
+		},
+		rule: {},
+		validator: {},
+		required: {
+			type: Boolean,
+			default: false
+		},
+		validateTrigger: { default: "blur" },
+		name: {},
+		minlength: {},
+		maxlength: {},
+		showCount: {
+			type: Boolean,
+			default: false
+		},
+		clearable: {
+			type: Boolean,
+			default: false
+		},
+		showValidateMessage: {
+			type: Boolean,
+			default: true
+		},
+		label: {},
+		hint: {},
+		labelPosition: {}
+	}, {
+		"modelValue": { default: "" },
+		"modelModifiers": {}
+	}),
+	emits: /*@__PURE__*/ mergeModels([
+		"validate",
+		"blur",
+		"focus",
+		"pressEnter",
+		"clear"
+	], ["update:modelValue"]),
+	setup(__props, { expose: __expose, emit: __emit }) {
+		const { t } = useRsI18n();
+		const model = useModel(__props, "modelValue", {
+			get(value) {
+				return value == null ? "" : String(value);
+			},
+			set(value) {
+				return value == null ? "" : String(value);
+			}
+		});
+		const props = __props;
+		const emit = __emit;
+		const attrs = useAttrs();
+		const formContext = useRsFormContext();
+		const formItem = useRsFormItemContext();
+		const boundToItem = computed(() => isRsFormItemBoundControl(formItem, {
+			id: props.id,
+			name: props.name
+		}));
+		const fieldId = useId();
+		const textareaRef = ref(null);
+		const touched = ref(false);
+		const autoInvalid = ref(false);
+		const autoMessage = ref("");
+		const composing = ref(false);
+		const resolvedId = computed(() => props.id ?? fieldId);
+		const resolvedLabelPosition = computed(() => props.labelPosition ?? formContext?.labelPosition.value ?? "top");
+		const resolvedLabelAlign = computed(() => formContext?.labelAlign.value ?? "start");
+		const errorId = computed(() => `${resolvedId.value}-error`);
+		const displayMessage = computed(() => {
+			if (boundToItem.value) return "";
+			if (props.errorMessage) return props.errorMessage;
+			if (props.showValidateMessage && autoInvalid.value) return autoMessage.value;
+			return "";
+		});
+		const isInvalid = computed(() => {
+			if (boundToItem.value) return Boolean(formItem?.invalid.value || props.invalid);
+			return props.invalid || autoInvalid.value;
+		});
+		const describedBy = computed(() => {
+			if (boundToItem.value) return formItem?.describedBy.value;
+			return displayMessage.value ? errorId.value : void 0;
+		});
+		const resolvedDisabled = computed(() => props.disabled || formContext?.disabled.value || false);
+		const resolvedSize = useResolvedRsComponentSize(() => props.size);
+		const resolvedRadius = useResolvedRsRadius(() => props.radius, "sm");
+		const radiusStyle = computed(() => ({ "--rs-input-radius": rsRadiusCss(resolvedRadius.value) }));
+		const fieldStyle = computed(() => {
+			if (resolvedLabelPosition.value !== "left") return void 0;
+			const labelWidth = formContext?.labelWidth.value;
+			if (!labelWidth) return void 0;
+			return { "--rs-field-label-width": labelWidth };
+		});
+		const autosizeEnabled = computed(() => Boolean(props.autosize));
+		const autosizeSpec = computed(() => typeof props.autosize === "object" && props.autosize ? props.autosize : {});
+		const displayRows = computed(() => autosizeSpec.value.minRows ?? props.rows);
+		const resolvedResize = computed(() => autosizeEnabled.value ? "none" : props.resize);
+		const countText = computed(() => {
+			const n = model.value.length;
+			return props.maxlength != null ? `${n} / ${props.maxlength}` : String(n);
+		});
+		const countLimitReached = computed(() => props.maxlength != null && model.value.length >= props.maxlength);
+		const showClearButton = computed(() => props.clearable && !resolvedDisabled.value && !props.readonly && model.value.length > 0);
+		function parseLineHeight(el) {
+			const style = getComputedStyle(el);
+			const lh = Number.parseFloat(style.lineHeight);
+			if (Number.isFinite(lh) && lh > 0) return lh;
+			return (Number.parseFloat(style.fontSize) || 14) * 1.5;
+		}
+		function autosizePadding(el) {
+			const style = getComputedStyle(el);
+			const pad = Number.parseFloat(style.paddingTop) + Number.parseFloat(style.paddingBottom);
+			if (style.boxSizing !== "border-box") return 0;
+			const border = Number.parseFloat(style.borderTopWidth) + Number.parseFloat(style.borderBottomWidth);
+			return (Number.isFinite(pad) ? pad : 0) + (Number.isFinite(border) ? border : 0);
+		}
+		function adjustHeight() {
+			const el = textareaRef.value;
+			if (!el) return;
+			if (!autosizeEnabled.value) {
+				el.style.height = "";
+				el.style.overflowY = "";
+				return;
+			}
+			el.style.height = "auto";
+			el.style.overflowY = "hidden";
+			const lineHeight = parseLineHeight(el);
+			const extra = autosizePadding(el);
+			const minRows = autosizeSpec.value.minRows ?? props.rows;
+			const maxRows = autosizeSpec.value.maxRows;
+			const min = lineHeight * minRows + extra;
+			const max = maxRows != null ? lineHeight * maxRows + extra : void 0;
+			let height = el.scrollHeight;
+			if (height < min) height = min;
+			if (max != null && height > max) {
+				height = max;
+				el.style.overflowY = "auto";
+			}
+			el.style.height = `${height}px`;
+		}
+		function scheduleAdjustHeight() {
+			nextTick(adjustHeight);
+		}
+		async function runValidate(trigger = "submit") {
+			const formRules = formContext?.getFieldRules(props.name) ?? [];
+			const localRules = buildLocalInputRules({
+				required: props.required,
+				rule: props.rule,
+				validator: props.validator
+			});
+			const rules = [...formRules, ...localRules];
+			if (!rules.length) {
+				autoInvalid.value = false;
+				autoMessage.value = "";
+				emit("validate", { valid: true });
+				return true;
+			}
+			const result = await runFormFieldRules(model.value, rules, {
+				trigger,
+				t
+			});
+			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) {
+			model.value = String(value ?? "");
+			scheduleAdjustHeight();
+		}
+		function clearValidation() {
+			touched.value = false;
+			autoInvalid.value = false;
+			autoMessage.value = "";
+		}
+		function focus() {
+			textareaRef.value?.focus();
+		}
+		function blur() {
+			textareaRef.value?.blur();
+		}
+		function onNativeInput(event) {
+			const el = event.target;
+			model.value = el?.value ?? "";
+			scheduleAdjustHeight();
+			if (composing.value) return;
+			if (touched.value && (props.validateTrigger === "input" || props.validateTrigger === "both")) runValidate("change");
+		}
+		function onCompositionStart() {
+			composing.value = true;
+		}
+		function onCompositionEnd(event) {
+			composing.value = false;
+			onNativeInput(event);
+		}
+		function onBlur(event) {
+			touched.value = true;
+			if (props.validateTrigger === "blur" || props.validateTrigger === "both") runValidate("blur");
+			emit("blur", event);
+		}
+		function onKeydown(event) {
+			if (event.key !== "Enter" || composing.value) return;
+			emit("pressEnter", event);
+		}
+		function onClear() {
+			if (resolvedDisabled.value || props.readonly) return;
+			model.value = "";
+			emit("clear");
+			nextTick(() => {
+				textareaRef.value?.focus();
+				adjustHeight();
+				if (props.validateTrigger === "input" || props.validateTrigger === "both") runValidate("change");
+			});
+		}
+		watch([
+			model,
+			() => props.autosize,
+			() => props.rows,
+			() => props.size,
+			() => props.showCount
+		], scheduleAdjustHeight);
+		onMounted(adjustHeight);
+		useRsFormField(() => ({
+			get name() {
+				return props.name;
+			},
+			getValue: () => model.value,
+			setValue,
+			validate: async (trigger) => {
+				return {
+					valid: await runValidate(trigger ?? "submit"),
+					message: autoMessage.value || void 0,
+					name: props.name
+				};
+			},
+			clearValidation,
+			setError
+		}));
+		__expose({
+			validate: runValidate,
+			clearValidation,
+			setValue,
+			setError,
+			focus,
+			blur
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", {
+				class: normalizeClass(["rs-field", [
+					`rs-field--label-${resolvedLabelPosition.value}`,
+					resolvedLabelPosition.value === "left" && resolvedLabelAlign.value === "end" ? "rs-field--label-align-end" : void 0,
+					`rs-input-field--${unref(resolvedSize)}`
+				]]),
+				style: normalizeStyle([fieldStyle.value, radiusStyle.value])
+			}, [__props.label ? (openBlock(), createElementBlock("span", _hoisted_1, [createElementVNode("label", { for: resolvedId.value }, toDisplayString(__props.label), 9, _hoisted_2), __props.required ? (openBlock(), createElementBlock("span", _hoisted_3, "*")) : createCommentVNode("", true)])) : createCommentVNode("", true), createElementVNode("div", _hoisted_4, [
+				createElementVNode("div", { class: normalizeClass(["rs-textarea__shell", {
+					"is-invalid": isInvalid.value,
+					"is-disabled": resolvedDisabled.value,
+					"is-readonly": __props.readonly,
+					"is-autosize": autosizeEnabled.value,
+					"has-count": __props.showCount,
+					"has-clear": showClearButton.value
+				}]) }, [
+					createElementVNode("textarea", mergeProps({
+						ref_key: "textareaRef",
+						ref: textareaRef
+					}, unref(attrs), {
+						id: resolvedId.value,
+						value: model.value,
+						class: "rs-textarea__control",
+						rows: displayRows.value,
+						style: { resize: resolvedResize.value },
+						placeholder: __props.placeholder,
+						disabled: resolvedDisabled.value,
+						readonly: __props.readonly,
+						minlength: __props.minlength,
+						maxlength: __props.maxlength,
+						"aria-invalid": isInvalid.value || void 0,
+						"aria-describedby": describedBy.value,
+						onInput: onNativeInput,
+						onCompositionstart: onCompositionStart,
+						onCompositionend: onCompositionEnd,
+						onKeydown,
+						onBlur,
+						onFocus: _cache[0] || (_cache[0] = ($event) => emit("focus", $event))
+					}), null, 16, _hoisted_5),
+					showClearButton.value ? (openBlock(), createElementBlock("button", {
+						key: 0,
+						type: "button",
+						class: "rs-textarea__clear",
+						tabindex: "-1",
+						"aria-label": unref(t)("input.clear"),
+						onPointerdown: _cache[1] || (_cache[1] = withModifiers(() => {}, ["prevent"])),
+						onClick: onClear
+					}, [createVNode(RsIcon_default, {
+						name: "x",
+						size: 14
+					})], 40, _hoisted_6)) : createCommentVNode("", true),
+					__props.showCount ? (openBlock(), createElementBlock("span", {
+						key: 1,
+						class: normalizeClass(["rs-textarea__count", { "is-limit": countLimitReached.value }]),
+						"aria-hidden": "true"
+					}, [renderSlot(_ctx.$slots, "count", {
+						value: model.value,
+						count: model.value.length,
+						maxlength: __props.maxlength
+					}, () => [createTextVNode(toDisplayString(countText.value), 1)], true)], 2)) : createCommentVNode("", true)
+				], 2),
+				displayMessage.value ? (openBlock(), createElementBlock("p", {
+					key: 0,
+					id: errorId.value,
+					class: "rs-field__error",
+					role: "alert"
+				}, [renderSlot(_ctx.$slots, "error", { message: displayMessage.value }, () => [createTextVNode(toDisplayString(displayMessage.value), 1)], true)], 8, _hoisted_7)) : createCommentVNode("", true),
+				__props.hint ? (openBlock(), createElementBlock("span", _hoisted_8, toDisplayString(__props.hint), 1)) : createCommentVNode("", true)
+			])], 6);
+		};
+	}
+});
+//#endregion
+export { RsTextarea_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/RsTextarea.js

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

package/dist/components/RsTooltip.css

@@ -1,15 +1,16 @@
 
 .rs-tooltip__with-icon {
   display: inline-flex;
+  flex-wrap: nowrap;
   align-items: center;
   gap: 0.25rem;
+  width: max-content;
   max-width: 100%;
-  vertical-align: baseline;
+  vertical-align: middle;
 }
 .rs-tooltip__label {
-  display: inline-flex;
+  display: inline;
   min-width: 0;
-  max-width: 100%;
 }
 .rs-tooltip__icon-trigger {
   display: inline-flex;

package/dist/components/RsTooltip.d.ts

@@ -18,6 +18,8 @@ type __VLS_Props = {
     icon?: boolean;
     /** 后缀图标名，默认 info（问号/说明圆标；对齐表单帮助惯用） */
     iconName?: string;
+    /** 帮助图标的无障碍名称；缺省用 content，再回退 locale `tooltip.help` */
+    ariaLabel?: string;
 };
 declare var __VLS_8: {}, __VLS_27: {}, __VLS_41: {};
 type __VLS_Slots = {} & {

package/dist/components/RsTooltip.impl.js

@@ -1,3 +1,4 @@
+import { useRsI18n } from "../composables/useRsI18n.js";
 import RsIcon_default from "./RsIcon.js";
 import { TooltipContent, TooltipPortal, TooltipRoot, TooltipTrigger } from "./reka.js";
 import { computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, normalizeClass, openBlock, renderSlot, toDisplayString, unref, useSlots, withCtx } from "vue";
@@ -34,13 +35,15 @@ var RsTooltip_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 			type: Boolean,
 			default: false
 		},
-		iconName: { default: "info" }
+		iconName: { default: "info" },
+		ariaLabel: {}
 	},
 	setup(__props) {
 		const props = __props;
 		const slots = useSlots();
+		const { t } = useRsI18n();
 		const hasLabelSlot = computed(() => Boolean(slots.default));
-		const iconAriaLabel = computed(() => props.content?.trim() || "Help");
+		const iconAriaLabel = computed(() => props.ariaLabel?.trim() || props.content?.trim() || t("tooltip.help", "Help"));
 		return (_ctx, _cache) => {
 			return openBlock(), createBlock(unref(TooltipRoot), {
 				disabled: __props.disabled,

package/dist/components/RsVirtualList.css

@@ -1,29 +1,29 @@
 
-.rs-virtual-list[data-v-c2c4b7ba] {
+.rs-virtual-list[data-v-808bf3fd] {
   overflow: auto;
   border: 1px solid var(--rs-border-subtle);
   border-radius: var(--rs-virtual-list-radius, var(--rs-radius-sm));
 }
-.rs-virtual-list--fill[data-v-c2c4b7ba] {
+.rs-virtual-list--fill[data-v-808bf3fd] {
   flex: 1;
   align-self: stretch;
   width: 100%;
   min-height: 0;
   height: 0;
 }
-.rs-virtual-list__spacer[data-v-c2c4b7ba] {
+.rs-virtual-list__spacer[data-v-808bf3fd] {
   position: relative;
 }
-.rs-virtual-list__items[data-v-c2c4b7ba] {
+.rs-virtual-list__items[data-v-808bf3fd] {
   position: absolute;
   left: 0;
   right: 0;
   top: 0;
 }
-.rs-virtual-list__item[data-v-c2c4b7ba] {
+.rs-virtual-list__item[data-v-808bf3fd] {
   box-sizing: border-box;
 }
-.rs-virtual-list__item--active[data-v-c2c4b7ba] {
+.rs-virtual-list__item--active[data-v-808bf3fd] {
   background: color-mix(in srgb, var(--rs-primary) 14%, var(--rs-surface));
   box-shadow: inset 2px 0 0 var(--rs-primary);
 }

package/dist/components/RsVirtualList.d.ts

@@ -15,7 +15,7 @@ declare const __VLS_export: <T>(__VLS_props: NonNullable<Awaited<typeof __VLS_se
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: import("vue").ShallowUnwrapRef<{
-        scrollToIndex: (index: number) => void;
+        scrollToIndex: (index: number, align?: "nearest" | "center" | "start" | "end") => void;
     }>) => void;
     attrs: any;
     slots: {

package/dist/components/RsVirtualList.impl.js

@@ -89,17 +89,22 @@ var RsVirtualList_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 		})));
 		const totalHeight = computed(() => props.items.length * fixedItemSize.value);
 		const offsetY = computed(() => startIndex.value * fixedItemSize.value);
-		function scrollToIndex(index) {
+		function scrollToIndex(index, align = "center") {
 			const el = rootRef.value;
 			if (!el || index < 0 || index >= props.items.length) return;
 			const itemTop = index * fixedItemSize.value;
 			const itemBottom = itemTop + fixedItemSize.value;
 			const viewTop = el.scrollTop;
 			const viewBottom = viewTop + el.clientHeight;
-			if (itemTop >= viewTop && itemBottom <= viewBottom) return;
+			if (align === "nearest" && itemTop >= viewTop && itemBottom <= viewBottom) return;
 			const maxScroll = Math.max(0, totalHeight.value - el.clientHeight);
-			const centered = itemTop - (el.clientHeight - fixedItemSize.value) / 2;
-			el.scrollTop = Math.min(maxScroll, Math.max(0, centered));
+			let next = itemTop - (el.clientHeight - fixedItemSize.value) / 2;
+			if (align === "start") next = itemTop;
+			if (align === "end") next = itemBottom - el.clientHeight;
+			if (align === "nearest") if (itemTop < viewTop) next = itemTop;
+			else if (itemBottom > viewBottom) next = itemBottom - el.clientHeight;
+			else return;
+			el.scrollTop = Math.min(maxScroll, Math.max(0, next));
 			scrollTop.value = el.scrollTop;
 		}
 		watch(() => [props.activeIndex, props.items.length], async ([index, length]) => {

package/dist/components/RsVirtualList.js

@@ -3,6 +3,6 @@ import _plugin_vue_export_helper_default from "../_virtual/_plugin-vue_export-he
 import RsVirtualList_vue_vue_type_script_setup_true_lang_default from "./RsVirtualList.impl.js";
 
 //#region src/components/RsVirtualList.vue
-var RsVirtualList_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsVirtualList_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-c2c4b7ba"]]);
+var RsVirtualList_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsVirtualList_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-808bf3fd"]]);
 //#endregion
 export { RsVirtualList_default as default };

package/dist/components/button-utils.d.ts

@@ -1,17 +1,26 @@
 /**
- * RsButton 外观变体
- * - primary / default / ghost / danger：常规控件按钮
- * - link：行内链接态（可带下划线）
- * - text：工具栏/表格操作等 quaternary 文字按钮（无底无边，靠 tone 着色）
+ * RsButton 外观变体（形态，与 tone 正交）
+ * - primary：实心
+ * - default / secondary：轮廓 + 浅底（secondary 等价 default）
+ * - ghost：透明底 + 描边
+ * - text：无底无边
+ * - link：行内链接
+ * - danger：兼容别名，等价 primary + tone="danger" 的历史实心底（保留独立样式）
  */
 export type RsButtonVariant = 'primary' | 'default' | 'secondary' | 'ghost' | 'danger' | 'link' | 'text';
 /**
- * RsButton 语义色调
- * 主要用于 text / ghost / link：只改文字与图标色，不改变填充形态。
- * 对 primary / default / danger 等填充变体将被忽略。
+ * RsButton 语义色（色相，与 variant 正交）
+ * 对齐 Ant Design color / Element Plus type / Naive UI type：
+ * `variant="default" tone="warning"` → 描边 + 浅底 + 警告色。
  */
 export type RsButtonTone = 'neutral' | 'primary' | 'danger' | 'success' | 'warning' | 'info';
-/** 填充类变体：已自带语义色，不再叠加 tone */
+/** 规范化变体：未传为 primary；secondary 视为 default。 */
+export declare function resolveRsButtonVariant(variant?: RsButtonVariant): Exclude<RsButtonVariant, 'secondary'>;
+/**
+ * 解析语义色。未传 tone 时：primary/link 用 primary，danger 变体用 danger，其余 neutral。
+ */
+export declare function resolveRsButtonTone(variant?: RsButtonVariant, tone?: RsButtonTone): RsButtonTone;
+/** 实心/轮廓填充类变体（相对 text / ghost / link）。 */
 export declare function isRsButtonFilledVariant(variant: RsButtonVariant): boolean;
-/** text / ghost / link 可叠加 tone */
-export declare function supportsRsButtonTone(variant: RsButtonVariant): boolean;
+/** 所有变体都可叠加 tone（形态 × 色相）。 */
+export declare function supportsRsButtonTone(_variant?: RsButtonVariant): boolean;

package/dist/components/button-utils.js

@@ -1,13 +1,28 @@
 //#region src/components/button-utils.ts
-/** 填充类变体：已自带语义色，不再叠加 tone */
+/** 规范化变体：未传为 primary；secondary 视为 default。 */
+function resolveRsButtonVariant(variant) {
+	if (variant === "secondary") return "default";
+	if (!variant) return "primary";
+	return variant;
+}
+/**
+* 解析语义色。未传 tone 时：primary/link 用 primary，danger 变体用 danger，其余 neutral。
+*/
+function resolveRsButtonTone(variant, tone) {
+	if (tone) return tone;
+	const resolved = resolveRsButtonVariant(variant);
+	if (resolved === "danger") return "danger";
+	if (resolved === "primary" || resolved === "link") return "primary";
+	return "neutral";
+}
+/** 实心/轮廓填充类变体（相对 text / ghost / link）。 */
 function isRsButtonFilledVariant(variant) {
-	const resolved = variant === "secondary" ? "default" : variant;
+	const resolved = resolveRsButtonVariant(variant);
 	return resolved === "primary" || resolved === "default" || resolved === "danger";
 }
-/** text / ghost / link 可叠加 tone */
-function supportsRsButtonTone(variant) {
-	const resolved = variant === "secondary" ? "default" : variant;
-	return resolved === "text" || resolved === "ghost" || resolved === "link";
+/** 所有变体都可叠加 tone（形态 × 色相）。 */
+function supportsRsButtonTone(_variant) {
+	return true;
 }
 //#endregion
-export { isRsButtonFilledVariant, supportsRsButtonTone };
+export { isRsButtonFilledVariant, resolveRsButtonTone, resolveRsButtonVariant, supportsRsButtonTone };

package/dist/components/dialog-window.d.ts

@@ -14,6 +14,8 @@ export declare function useRsDialogWindow(options: {
     widthPreset: Ref<RsDialogWidthPreset>;
     /** 自定义初始宽度（px）；有值时优先于预设/比例 */
     initialWidth?: Ref<number | undefined>;
+    /** 自定义初始高度（px）；有值时优先于默认 75% 视口高 */
+    initialHeight?: Ref<number | undefined>;
     draggable: Ref<boolean>;
     resizable: Ref<boolean>;
     compact?: Ref<boolean>;

package/dist/components/dialog-window.js

@@ -62,9 +62,10 @@ function useRsDialogWindow(options) {
 	function defaultWindowSize() {
 		const { width: maxW, height: maxH } = dialogViewportSize();
 		const customW = options.initialWidth?.value;
+		const customH = options.initialHeight?.value;
 		return {
 			width: customW != null && Number.isFinite(customW) && customW > 0 ? Math.min(maxW, Math.max(minWidth, Math.round(customW))) : Math.min(maxW, Math.max(minWidth, Math.round(maxW * defaultWidthRatio))),
-			height: Math.min(maxH, Math.max(minHeight, Math.round(maxH * defaultHeightRatio)))
+			height: customH != null && Number.isFinite(customH) && customH > 0 ? Math.min(maxH, Math.max(minHeight, Math.round(customH))) : Math.min(maxH, Math.max(minHeight, Math.round(maxH * defaultHeightRatio)))
 		};
 	}
 	function refreshCachedInsets() {

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

@@ -0,0 +1,29 @@
+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;

package/dist/components/fieldset-utils.js

@@ -0,0 +1,12 @@
+import { RS_FONT_SIZE_CSS, RS_FONT_WEIGHT_CSS } from "../theme/types.js";
+//#region src/components/fieldset-utils.ts
+/** 解析标题字号 token。 */
+function resolveFieldsetTitleSize(size) {
+	return RS_FONT_SIZE_CSS[size];
+}
+/** 解析标题字重 token。 */
+function resolveFieldsetTitleWeight(weight) {
+	return RS_FONT_WEIGHT_CSS[weight];
+}
+//#endregion
+export { resolveFieldsetTitleSize, resolveFieldsetTitleWeight };