niuma-ui 2.0.3 → 2.0.4

package/dist/components/input/src/RsInput.d.ts

@@ -1,5 +1,6 @@
 import type { RsComponentSize, RsRadius } from '../../../theme/types';
 import { type RsInputRule, type RsInputValidateTrigger } from './input-rules';
+import { type RsInputType } from './input-utils';
 import { type RsFormLabelPosition } from '../../form/src/form-utils';
 import { type RsFormRuleTrigger } from '../../form/src/form-rules';
 /**
@@ -16,9 +17,10 @@ export interface RsInputExpose {
 export type RsInputInstance = RsInputExpose & {
     $el: HTMLElement;
 };
+export type { RsInputType };
 type __VLS_Props = {
     id?: string;
-    type?: 'text' | 'email' | 'password' | 'search' | 'tel' | 'url' | 'number' | 'date' | 'datetime-local';
+    type?: RsInputType;
     placeholder?: string;
     disabled?: boolean;
     readonly?: boolean;
@@ -126,9 +128,9 @@ declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, RsInp
     onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
     onAddonAfterClick?: ((event: MouseEvent) => any) | undefined;
 }>, {
-    type: "text" | "email" | "password" | "search" | "tel" | "url" | "number" | "date" | "datetime-local";
-    invalid: boolean;
     required: boolean;
+    type: RsInputType;
+    invalid: boolean;
     disabled: boolean;
     readonly: boolean;
     validateTrigger: RsInputValidateTrigger;

package/dist/components/input/src/RsInput.impl.js

@@ -4,6 +4,7 @@ import { buildLocalInputRules, runFormFieldRules } from "../../form/src/form-rul
 import { isRsFormItemBoundControl, useRsFormContext, useRsFormField, useRsFormItemContext } from "../../form/src/form-utils.js";
 import { useResolvedRsComponentSize } from "../../_shared/src/resolve-size.js";
 import { rsRadiusCss, useResolvedRsRadius } from "../../_shared/src/resolve-radius.js";
+import { hasRsInputAddonAfterContent, normalizeRsInputValue, resolveRsInputAutocomplete, resolveRsInputControlType } from "./input-utils.js";
 import RsVNodeHost_default from "../../vnode-host/src/RsVNodeHost.js";
 import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createTextVNode, createVNode, defineComponent, guardReactiveProps, mergeModels, mergeProps, normalizeClass, normalizeProps, normalizeStyle, openBlock, ref, renderSlot, toDisplayString, unref, useAttrs, useId, useModel, useSlots, withModifiers } from "vue";
 //#region src/components/input/src/RsInput.vue?vue&type=script&setup=true&lang.ts
@@ -64,6 +65,7 @@ var _hoisted_15 = {
 	class: "rs-field__hint"
 };
 var RsInput_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsInput",
 	inheritAttrs: false,
 	__name: "RsInput",
 	props: /*@__PURE__*/ mergeModels({
@@ -140,10 +142,10 @@ var RsInput_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 		*/
 		const model = useModel(__props, "modelValue", {
 			get(value) {
-				return value == null ? "" : String(value);
+				return normalizeRsInputValue(value);
 			},
 			set(value) {
-				return value == null ? "" : String(value);
+				return normalizeRsInputValue(value);
 			}
 		});
 		const props = __props;
@@ -167,15 +169,11 @@ var RsInput_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 		const hasCustomSuffix = computed(() => Boolean(props.suffix || slots.suffix));
 		const hasAddonBefore = computed(() => Boolean(props.addonBefore || slots.addonBefore));
 		/** 插槽或文本 addonAfter 内容（优先于图标按钮） */
-		const hasAddonAfterContent = computed(() => Boolean(slots.addonAfter) || props.addonAfter != null && props.addonAfter !== "");
+		const hasAddonAfterContent = computed(() => hasRsInputAddonAfterContent(Boolean(slots.addonAfter), props.addonAfter));
 		const hasAddonAfter = computed(() => hasAddonAfterContent.value || Boolean(props.addonAfterIcon));
 		const hasAddon = computed(() => hasAddonBefore.value || hasAddonAfter.value);
 		const resolvedId = computed(() => props.id ?? fieldId);
-		/** 未显式传 autocomplete 时关闭快捷填充；密码框用 new-password 更稳 */
-		const resolvedAutocomplete = computed(() => {
-			if (props.autocomplete != null && props.autocomplete !== "") return props.autocomplete;
-			return props.type === "password" ? "new-password" : "off";
-		});
+		const resolvedAutocomplete = computed(() => resolveRsInputAutocomplete(props.autocomplete, props.type));
 		const resolvedLabelPosition = computed(() => props.labelPosition ?? formContext?.labelPosition.value ?? "top");
 		const resolvedLabelAlign = computed(() => formContext?.labelAlign.value ?? "start");
 		const errorId = computed(() => `${resolvedId.value}-error`);
@@ -209,10 +207,7 @@ var RsInput_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 		const resolvedRadius = useResolvedRsRadius(() => props.radius, "sm");
 		const radiusStyle = computed(() => ({ "--rs-input-radius": rsRadiusCss(resolvedRadius.value) }));
 		const resolvedShowPassword = computed(() => props.type === "password" && props.visibilityToggle);
-		const resolvedInputType = computed(() => {
-			if (props.type === "password" && passwordVisible.value) return "text";
-			return props.type;
-		});
+		const resolvedInputType = computed(() => resolveRsInputControlType(props.type, passwordVisible.value));
 		const hasValue = computed(() => model.value.length > 0);
 		const showClearButton = computed(() => props.clearable && hasValue.value && !resolvedDisabled.value && !resolvedReadonly.value);
 		const showPasswordToggle = computed(() => props.type === "password" && resolvedShowPassword.value && !resolvedDisabled.value);
@@ -221,9 +216,6 @@ var RsInput_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 		/** 无 addonAfter 内容时用组件自绘的后置图标按钮 */
 		const showAddonAfterIcon = computed(() => Boolean(props.addonAfterIcon) && !hasAddonAfterContent.value);
 		const hasSuffix = computed(() => Boolean(hasCustomSuffix.value || showClearButton.value || showPasswordToggle.value || showCountDisplay.value));
-		/**
-		* 点击框外后置图标按钮
-		*/
 		function onAddonAfterIconClick(event) {
 			if (resolvedDisabled.value || resolvedReadonly.value) return;
 			emit("addonAfterClick", event);
@@ -300,7 +292,7 @@ var RsInput_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 			passwordVisible.value = !passwordVisible.value;
 		}
 		function setValue(value) {
-			model.value = String(value ?? "");
+			model.value = normalizeRsInputValue(value);
 		}
 		function clearValidation() {
 			touched.value = false;

package/dist/components/input/src/RsInput.js

@@ -3,6 +3,6 @@ import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_exp
 import RsInput_vue_vue_type_script_setup_true_lang_default from "./RsInput.impl.js";
 
 //#region src/components/input/src/RsInput.vue
-var RsInput_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsInput_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-a3292d1e"]]);
+var RsInput_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsInput_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-ecc31779"]]);
 //#endregion
 export { RsInput_default as default };

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

@@ -0,0 +1,11 @@
+export declare const RS_INPUT_TYPES: readonly ["text", "email", "password", "search", "tel", "url", "number", "date", "datetime-local"];
+export type RsInputType = (typeof RS_INPUT_TYPES)[number];
+export declare function isRsInputType(value: unknown): value is RsInputType;
+export declare function resolveRsInputType(type?: string | null): RsInputType;
+/** modelValue 契约恒为 string；兜住外部误传 number / null。 */
+export declare function normalizeRsInputValue(value: unknown): string;
+/** 未显式传 autocomplete 时关闭快捷填充；密码框用 new-password 更稳。 */
+export declare function resolveRsInputAutocomplete(autocomplete: string | undefined, type: string): string;
+/** 密码显隐：可见时原生 type 改成 text，其余跟 prop。 */
+export declare function resolveRsInputControlType(type: string, passwordVisible: boolean): string;
+export declare function hasRsInputAddonAfterContent(hasSlot: boolean, addonAfter?: string | null): boolean;

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

@@ -0,0 +1,22 @@
+//#region src/components/input/src/input-utils.ts
+/** modelValue 契约恒为 string；兜住外部误传 number / null。 */
+function normalizeRsInputValue(value) {
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint") return `${value}`;
+	return "";
+}
+/** 未显式传 autocomplete 时关闭快捷填充；密码框用 new-password 更稳。 */
+function resolveRsInputAutocomplete(autocomplete, type) {
+	if (autocomplete != null && autocomplete !== "") return autocomplete;
+	return type === "password" ? "new-password" : "off";
+}
+/** 密码显隐：可见时原生 type 改成 text，其余跟 prop。 */
+function resolveRsInputControlType(type, passwordVisible) {
+	if (type === "password" && passwordVisible) return "text";
+	return type;
+}
+function hasRsInputAddonAfterContent(hasSlot, addonAfter) {
+	return hasSlot || addonAfter != null && addonAfter !== "";
+}
+//#endregion
+export { hasRsInputAddonAfterContent, normalizeRsInputValue, resolveRsInputAutocomplete, resolveRsInputControlType };

package/dist/components/input-number/index.d.ts

@@ -1,3 +1,4 @@
 export { default as RsInputNumber } from './src/RsInputNumber.js';
+export type { RsInputNumberExpose, RsInputNumberInstance } from './src/RsInputNumber.js';
 export type { RsInputNumberValue } from './src/input-number-utils';
 export { clampNumber, formatNumberValue, fromModelValue, isNumberInputInterim, normalizeCommittedNumber, parseNumberInput, resolveNumberPrecision, roundToPrecision, stepNumberValue, toModelValue, } from './src/input-number-utils';

package/dist/components/input-number/src/RsInputNumber.css

@@ -1,29 +1,29 @@
 
-.rs-input-number-field[data-v-30abc660] {
+.rs-input-number-field[data-v-d46f1e7f] {
   width: 100%;
 }
-.rs-field--label-left .rs-input-number-field[data-v-30abc660] {
+.rs-field--label-left .rs-input-number-field[data-v-d46f1e7f] {
   grid-column: 2;
   min-width: 0;
 }
-.rs-field--label-left .rs-input-number-field__error[data-v-30abc660] {
+.rs-field--label-left .rs-input-number-field__error[data-v-d46f1e7f] {
   grid-column: 2;
 }
-.rs-field--label-left .rs-field__label[data-v-30abc660] {
+.rs-field--label-left .rs-field__label[data-v-d46f1e7f] {
   display: flex;
   align-items: center;
   min-height: var(--rs-control-height-md);
 }
-.rs-input-number-field--ssm.rs-field--label-left .rs-field__label[data-v-30abc660] {
+.rs-input-number-field--ssm.rs-field--label-left .rs-field__label[data-v-d46f1e7f] {
   min-height: var(--rs-control-height-ssm);
 }
-.rs-input-number-field--sm.rs-field--label-left .rs-field__label[data-v-30abc660] {
+.rs-input-number-field--sm.rs-field--label-left .rs-field__label[data-v-d46f1e7f] {
   min-height: var(--rs-control-height-sm);
 }
-.rs-input-number-field--lg.rs-field--label-left .rs-field__label[data-v-30abc660] {
+.rs-input-number-field--lg.rs-field--label-left .rs-field__label[data-v-d46f1e7f] {
   min-height: var(--rs-control-height-lg);
 }
-.rs-input-number[data-v-30abc660] {
+.rs-input-number[data-v-d46f1e7f] {
   display: flex;
   align-items: stretch;
   box-sizing: border-box;
@@ -40,44 +40,44 @@
     background var(--rs-transition-fast);
   overflow: hidden;
 }
-.rs-input-number--ssm[data-v-30abc660] {
+.rs-input-number--ssm[data-v-d46f1e7f] {
   height: var(--rs-control-height-ssm);
   min-height: var(--rs-control-height-ssm);
 }
-.rs-input-number--sm[data-v-30abc660] {
+.rs-input-number--sm[data-v-d46f1e7f] {
   height: var(--rs-control-height-sm);
   min-height: var(--rs-control-height-sm);
 }
-.rs-input-number--lg[data-v-30abc660] {
+.rs-input-number--lg[data-v-d46f1e7f] {
   height: var(--rs-control-height-lg);
   min-height: var(--rs-control-height-lg);
 }
-.rs-input-number[data-v-30abc660]:hover:not(.rs-input-number--disabled):not(.rs-input-number--readonly):not(
+.rs-input-number[data-v-d46f1e7f]:hover:not(.rs-input-number--disabled):not(.rs-input-number--readonly):not(
     :focus-within
   ) {
   border-color: var(--rs-input-border-hover, var(--rs-border));
 }
-.rs-input-number[data-v-30abc660]:focus-within {
+.rs-input-number[data-v-d46f1e7f]:focus-within {
   border-color: var(--rs-focus-border, var(--rs-primary));
   box-shadow:
     var(--rs-input-shadow, none),
     0 0 0 var(--rs-focus-ring-width, 2px) var(--rs-focus-ring);
 }
-.rs-input-number--invalid[data-v-30abc660] {
+.rs-input-number--invalid[data-v-d46f1e7f] {
   border-color: var(--rs-danger);
 }
-.rs-input-number--invalid[data-v-30abc660]:focus-within {
+.rs-input-number--invalid[data-v-d46f1e7f]:focus-within {
   border-color: var(--rs-danger);
   box-shadow:
     var(--rs-input-shadow, none),
     0 0 0 var(--rs-focus-ring-width, 2px) color-mix(in srgb, var(--rs-danger) 14%, transparent);
 }
-.rs-input-number--disabled[data-v-30abc660] {
+.rs-input-number--disabled[data-v-d46f1e7f] {
   opacity: 0.55;
   cursor: not-allowed;
   background: var(--rs-surface-hover);
 }
-.rs-input-number__control[data-v-30abc660] {
+.rs-input-number__control[data-v-d46f1e7f] {
   flex: 1;
   align-self: stretch;
   min-width: 0;
@@ -95,27 +95,27 @@
   appearance: textfield;
   -moz-appearance: textfield;
 }
-.rs-input-number__control--ssm[data-v-30abc660] {
+.rs-input-number__control--ssm[data-v-d46f1e7f] {
   padding: 0 var(--rs-space-xs);
   font-size: var(--rs-font-size-xs);
 }
-.rs-input-number__control--sm[data-v-30abc660] {
+.rs-input-number__control--sm[data-v-d46f1e7f] {
   padding: 0 var(--rs-space-sm);
   font-size: var(--rs-font-size-xs);
 }
-.rs-input-number__control--lg[data-v-30abc660] {
+.rs-input-number__control--lg[data-v-d46f1e7f] {
   padding: 0 var(--rs-space-lg);
   font-size: var(--rs-font-size-base);
 }
-.rs-input-number__control[data-v-30abc660]:disabled {
+.rs-input-number__control[data-v-d46f1e7f]:disabled {
   cursor: not-allowed;
 }
-.rs-input-number__control[data-v-30abc660]::-webkit-outer-spin-button,
-.rs-input-number__control[data-v-30abc660]::-webkit-inner-spin-button {
+.rs-input-number__control[data-v-d46f1e7f]::-webkit-outer-spin-button,
+.rs-input-number__control[data-v-d46f1e7f]::-webkit-inner-spin-button {
   -webkit-appearance: none;
   margin: 0;
 }
-.rs-input-number__handlers[data-v-30abc660] {
+.rs-input-number__handlers[data-v-d46f1e7f] {
   display: flex;
   flex-direction: column;
   flex-shrink: 0;
@@ -126,11 +126,11 @@
   overflow: hidden;
   border-inline-start: 1px solid var(--rs-input-border, var(--rs-border));
 }
-.rs-input-number--ssm .rs-input-number__handlers[data-v-30abc660],
-.rs-input-number--sm .rs-input-number__handlers[data-v-30abc660] {
+.rs-input-number--ssm .rs-input-number__handlers[data-v-d46f1e7f],
+.rs-input-number--sm .rs-input-number__handlers[data-v-d46f1e7f] {
   width: 18px;
 }
-.rs-input-number__handler[data-v-30abc660] {
+.rs-input-number__handler[data-v-d46f1e7f] {
   flex: 1 1 0;
   min-height: 0;
   display: inline-flex;
@@ -144,18 +144,18 @@
   cursor: pointer;
   line-height: 1;
 }
-.rs-input-number__handler[data-v-30abc660]:hover:not(:disabled) {
+.rs-input-number__handler[data-v-d46f1e7f]:hover:not(:disabled) {
   color: var(--rs-text);
   background: var(--rs-surface-hover);
 }
-.rs-input-number__handler[data-v-30abc660]:disabled {
+.rs-input-number__handler[data-v-d46f1e7f]:disabled {
   opacity: 0.35;
   cursor: not-allowed;
 }
-.rs-input-number__handler--up[data-v-30abc660] {
+.rs-input-number__handler--up[data-v-d46f1e7f] {
   border-bottom: 1px solid var(--rs-input-border, var(--rs-border));
 }
-.rs-input-number-field__error[data-v-30abc660] {
+.rs-input-number-field__error[data-v-d46f1e7f] {
   margin: 4px 0 0;
   font-size: var(--rs-font-size-xs);
   color: var(--rs-danger);

package/dist/components/input-number/src/RsInputNumber.d.ts

@@ -1,6 +1,17 @@
 import type { RsComponentSize, RsRadius } from '../../../theme/types';
 import { type RsFormLabelPosition } from '../../form/src/form-utils';
 import { type RsInputNumberValue } from './input-number-utils';
+export interface RsInputNumberExpose {
+    focus: () => void;
+    blur: () => void;
+    commit: (raw?: string) => void;
+    setValue: (value: unknown) => void;
+    step: (direction: 1 | -1) => void;
+}
+/** 模板 ref 实例：expose + 根节点 */
+export type RsInputNumberInstance = RsInputNumberExpose & {
+    $el: HTMLElement;
+};
 type __VLS_Props = {
     id?: string;
     min?: number;
@@ -44,41 +55,32 @@ type __VLS_Props = {
     /** 解析展示值（对齐 Ant parser） */
     parser?: (display: string) => string;
 };
-declare function commitDraft(raw?: string): void;
-declare function applyStep(direction: 1 | -1): void;
-declare function setValue(value: unknown): void;
 type __VLS_ModelProps = {
     modelValue?: RsInputNumberValue;
 };
 type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
-declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, {
-    focus: () => void;
-    blur: () => void;
-    commit: typeof commitDraft;
-    setValue: typeof setValue;
-    step: typeof applyStep;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+declare const __VLS_export: import("vue").DefineComponent<__VLS_PublicProps, RsInputNumberExpose, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     blur: (event: FocusEvent) => any;
     focus: (event: FocusEvent) => any;
     "update:modelValue": (value: RsInputNumberValue) => any;
-    pressEnter: (event: KeyboardEvent) => any;
     step: (value: RsInputNumberValue, info: {
         offset: number;
     }) => any;
+    pressEnter: (event: KeyboardEvent) => any;
 }, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
     onBlur?: ((event: FocusEvent) => any) | undefined;
     onFocus?: ((event: FocusEvent) => any) | undefined;
     "onUpdate:modelValue"?: ((value: RsInputNumberValue) => any) | undefined;
-    onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
     onStep?: ((value: RsInputNumberValue, info: {
         offset: number;
     }) => any) | undefined;
+    onPressEnter?: ((event: KeyboardEvent) => any) | undefined;
 }>, {
     required: boolean;
     disabled: boolean;
+    step: number | string;
     readonly: boolean;
     autocomplete: string;
-    step: number | string;
     stringMode: boolean;
     controls: boolean;
     keyboard: boolean;

package/dist/components/input-number/src/RsInputNumber.impl.js

@@ -5,7 +5,7 @@ import { isRsFormItemBoundControl, useRsFormContext, useRsFormField, useRsFormIt
 import { useResolvedRsComponentSize } from "../../_shared/src/resolve-size.js";
 import { rsRadiusCss, useResolvedRsRadius } from "../../_shared/src/resolve-radius.js";
 import { formatNumberValue, fromModelValue, isNumberInputInterim, normalizeCommittedNumber, stepNumberValue, toModelValue } from "./input-number-utils.js";
-import { computed, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, mergeModels, mergeProps, normalizeClass, normalizeStyle, openBlock, ref, toDisplayString, unref, useId, useModel, watch, withModifiers } from "vue";
+import { computed, createCommentVNode, createElementBlock, createElementVNode, createVNode, defineComponent, mergeModels, mergeProps, normalizeClass, normalizeStyle, openBlock, ref, toDisplayString, unref, useAttrs, useId, useModel, useTemplateRef, watch, withModifiers } from "vue";
 //#region src/components/input-number/src/RsInputNumber.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = {
 	key: 0,
@@ -26,6 +26,7 @@ var _hoisted_5 = [
 	"placeholder",
 	"disabled",
 	"readonly",
+	"aria-required",
 	"aria-invalid",
 	"aria-describedby",
 	"aria-valuemin",
@@ -46,6 +47,7 @@ var _hoisted_10 = {
 	class: "rs-field__hint"
 };
 var RsInputNumber_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "RsInputNumber",
 	inheritAttrs: false,
 	__name: "RsInputNumber",
 	props: /*@__PURE__*/ mergeModels({
@@ -114,6 +116,8 @@ var RsInputNumber_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 		* - 输入过程用文本草稿，允许中间态；blur / step / Enter 再规范化
 		*/
 		const { t } = useRsI18n();
+		const attrs = useAttrs();
+		const controlRef = useTemplateRef("controlRef");
 		const model = useModel(__props, "modelValue");
 		const props = __props;
 		const emit = __emit;
@@ -234,6 +238,7 @@ var RsInputNumber_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 			emit("blur", event);
 		}
 		function onKeydown(event) {
+			if (event.isComposing || event.key === "Process") return;
 			if (event.key === "Enter") {
 				commitDraft();
 				emit("pressEnter", event);
@@ -254,6 +259,10 @@ var RsInputNumber_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 			event.preventDefault();
 			applyStep(event.deltaY < 0 ? 1 : -1);
 		}
+		const controlBinds = computed(() => props.changeOnWheel ? {
+			...attrs,
+			onWheel
+		} : attrs);
 		function setValue(value) {
 			if (value == null || value === "") {
 				model.value = null;
@@ -290,10 +299,10 @@ var RsInputNumber_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 		}));
 		__expose({
 			focus: () => {
-				document.getElementById(resolvedId.value)?.focus();
+				controlRef.value?.focus();
 			},
 			blur: () => {
-				document.getElementById(resolvedId.value)?.blur();
+				controlRef.value?.blur();
 			},
 			commit: commitDraft,
 			setValue,
@@ -316,6 +325,9 @@ var RsInputNumber_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 					"rs-input-number--controls": __props.controls,
 					[`rs-input-number--${unref(resolvedSize)}`]: true
 				}]) }, [createElementVNode("input", mergeProps({
+					ref_key: "controlRef",
+					ref: controlRef
+				}, controlBinds.value, {
 					id: resolvedId.value,
 					class: ["rs-input-number__control", `rs-input-number__control--${unref(resolvedSize)}`],
 					type: "text",
@@ -327,6 +339,7 @@ var RsInputNumber_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 					placeholder: __props.placeholder,
 					disabled: resolvedDisabled.value,
 					readonly: resolvedReadonly.value,
+					"aria-required": __props.required || void 0,
 					"aria-invalid": isInvalid.value || void 0,
 					"aria-describedby": displayMessage.value ? errorId.value : void 0,
 					"aria-valuemin": __props.min,
@@ -337,7 +350,7 @@ var RsInputNumber_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ de
 					onFocus,
 					onBlur,
 					onKeydown
-				}, __props.changeOnWheel ? { onWheel } : {}), null, 16, _hoisted_5), __props.controls ? (openBlock(), createElementBlock("div", _hoisted_6, [createElementVNode("button", {
+				}), null, 16, _hoisted_5), __props.controls ? (openBlock(), createElementBlock("div", _hoisted_6, [createElementVNode("button", {
 					type: "button",
 					class: "rs-input-number__handler rs-input-number__handler--up",
 					tabindex: "-1",

package/dist/components/input-number/src/RsInputNumber.js

@@ -3,6 +3,6 @@ import _plugin_vue_export_helper_default from "../../../_virtual/_plugin-vue_exp
 import RsInputNumber_vue_vue_type_script_setup_true_lang_default from "./RsInputNumber.impl.js";
 
 //#region src/components/input-number/src/RsInputNumber.vue
-var RsInputNumber_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsInputNumber_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-30abc660"]]);
+var RsInputNumber_default = /*#__PURE__*/ _plugin_vue_export_helper_default(RsInputNumber_vue_vue_type_script_setup_true_lang_default, [["__scopeId", "data-v-d46f1e7f"]]);
 //#endregion
 export { RsInputNumber_default as default };

package/dist/components/label/src/RsLabel.css

@@ -1,33 +1,52 @@
 
 /*
  * 消费全局 token（styles.css）：
- * --rs-label-font-size / --rs-label-font-weight / --rs-label-color / --rs-label-line-height
+ * --rs-label-font-size / font-weight / color / line-height / gap / mark-gap / disabled-opacity
  * 与 .rs-field__label 共用；父级覆盖即可，无需 :deep。
  */
-.rs-label[data-v-e4daa758] {
+.rs-label[data-v-dc8b2069] {
   display: flex;
   flex-direction: column;
-  gap: 0.25rem;
+  gap: var(--rs-label-gap);
   font-size: var(--rs-label-font-size);
   line-height: var(--rs-label-line-height);
   color: var(--rs-label-color);
 }
-.rs-label--disabled[data-v-e4daa758] {
-  opacity: 0.5;
+.rs-label--disabled[data-v-dc8b2069] {
+  opacity: var(--rs-label-disabled-opacity);
   cursor: not-allowed;
 }
-.rs-label--nowrap .rs-label__text[data-v-e4daa758] {
+.rs-label--nowrap .rs-label__text[data-v-dc8b2069] {
   white-space: nowrap;
 }
-.rs-label__text[data-v-e4daa758] {
+.rs-label__text[data-v-dc8b2069] {
   font-weight: var(--rs-label-font-weight);
 }
-.rs-label__required[data-v-e4daa758] {
-  margin-inline-start: 0.125rem;
+.rs-label__required[data-v-dc8b2069] {
+  margin-inline-start: var(--rs-label-mark-gap);
   color: var(--rs-danger);
 }
-.rs-label__hint[data-v-e4daa758] {
+.rs-label__optional[data-v-dc8b2069] {
+  margin-inline-start: var(--rs-label-mark-gap);
+  font-weight: var(--rs-font-weight-regular);
+  color: var(--rs-text-secondary);
+}
+.rs-label__colon[data-v-dc8b2069] {
+  margin-inline-start: var(--rs-label-mark-gap);
+}
+.rs-label__hint[data-v-dc8b2069] {
   font-size: var(--rs-font-size-xs);
   font-weight: var(--rs-font-weight-regular);
-  color: var(--rs-muted);
+  color: var(--rs-text-secondary);
+}
+.rs-label__sr[data-v-dc8b2069] {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
 }

package/dist/components/label/src/RsLabel.d.ts

@@ -1,19 +1,36 @@
 type __VLS_Props = {
+    /** 关联控件 id。国际用法也可写 htmlFor / for。 */
     forId?: string;
+    /** forId 别名（React / 国际文档常见）。 */
+    htmlFor?: string;
+    /** 原生 HTML for。forId / htmlFor 的别名。 */
+    for?: string;
+    /** 标签自身 id，供 aria-labelledby。 */
+    id?: string;
     required?: boolean;
+    /** 非必填标记。与 required 同时传时只显示必填。 */
+    optional?: boolean;
     hint?: string;
+    /** hint 节点 id。未传且有说明时自动生成。 */
+    hintId?: string;
     disabled?: boolean;
     /** 文案单行不换行（表单左侧标签等场景） */
     nowrap?: boolean;
+    /** 在文案后追加本地化冒号。默认关闭，避免改变旧版式。 */
+    colon?: boolean;
 };
-declare var __VLS_1: {};
+declare var __VLS_1: {}, __VLS_3: {};
 type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
+} & {
+    hint?: (props: typeof __VLS_3) => any;
 };
 declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     required: boolean;
     disabled: boolean;
+    optional: boolean;
     nowrap: boolean;
+    colon: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;