iter: e01 新增 inputNumber 数字输入组件（−/+ 步进 + 键盘上下调节，信号双向绑定，min/max/step 夹取）

packages/skin/ui/src/index.ts

@@ -1,6 +1,7 @@
 export * from './types.js';
 export { button } from './button.js';
 export { textField } from './textField.js';
+export { inputNumber } from './inputNumber.js';
 export { textarea } from './textarea.js';
 export { slider } from './slider.js';
 export { checkbox } from './checkbox.js';

packages/skin/ui/src/inputNumber.ts

@@ -0,0 +1,26 @@
+import { effect, h } from '@ui-arch/frame';
+import { button } from './button.js';
+import type { InputNumberProps } from './types.js';
+
+/*** 数字输入：−/+ 按钮 + 输入框三段式，value 信号双向绑定，min/max/step 超界自动夹取，键盘 ↑↓ 调节 ***/
+export function inputNumber(props: InputNumberProps): HTMLDivElement {
+  const min = props.min ?? -Infinity; // 无下限缺省
+  const max = props.max ?? Infinity; // 无上限缺省
+  const step = props.step ?? 1; // 步长缺省 1
+  const clamp = (v: number): number => Math.min(max, Math.max(min, v)); // 任何来源的值都夹回合法区间
+  const emit = (v: number): void => { const n = clamp(v); props.value(n); if (props.onChange) props.onChange(n); }; // 写回信号并回调
+  const input = h('input', { class: 'ua-input ua-input-number-field', inputmode: 'decimal', disabled: props.disabled, 'aria-label': '数字输入' }) as HTMLInputElement;
+  const sync = (): void => { const text = String(props.value()); if (input.value !== text) input.value = text; }; // 外部变化写回输入框
+  effect(sync);
+  input.addEventListener('change', () => { const n = parseFloat(input.value); if (Number.isNaN(n)) sync(); else emit(n); }); // 非法输入回滚当前值
+  input.addEventListener('keydown', (e: KeyboardEvent) => {
+    if (e.key !== 'ArrowUp' && e.key !== 'ArrowDown') return; // 卫语句：只拦截上下方向键
+    e.preventDefault();
+    emit(props.value() + (e.key === 'ArrowUp' ? step : -step)); // ↑ 加步长 / ↓ 减步长
+  });
+  const dec = button({ label: '−', variant: 'ghost', disabled: props.disabled, onClick: () => emit(props.value() - step) });
+  const inc = button({ label: '+', variant: 'ghost', disabled: props.disabled, onClick: () => emit(props.value() + step) });
+  dec.setAttribute('aria-label', '减少');
+  inc.setAttribute('aria-label', '增加');
+  return h('div', { class: 'ua-input-number', role: 'group' }, dec, input, inc) as HTMLDivElement;
+}

packages/skin/ui/src/types.ts

@@ -165,6 +165,16 @@ export interface TextareaProps {
   onInput?: (value: string) => void; // 输入回调
 }
 
+/*** 数字输入入参 ***/
+export interface InputNumberProps {
+  value: Signal<number>;   // 当前值信号，双向绑定（按钮/键盘写回、外部赋值同步）
+  min?: number;            // 最小值；缺省无下限
+  max?: number;            // 最大值；缺省无上限
+  step?: number;           // 步长；缺省 1
+  disabled?: boolean | Signal<boolean>; // 禁用态：布尔直接置位，传信号则动态同步
+  onChange?: (value: number) => void;   // 值变化回调（已夹取到合法区间）
+}
+
 /*** 徽标入参 ***/
 export interface BadgeProps {
   label: string; // 徽标文案