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; // 徽标文案

packages/skin/ui/ua.manifest.json

@@ -15,6 +15,7 @@
     "exports": [
       "button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用",
       "textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号禁用",
+      "inputNumber(props)：数字输入，−/+ 按钮 + 键盘 ↑↓ 调节，value 信号双向绑定，min/max/step 超界自动夹取",
       "textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号禁用",
       "slider(props)：滑块，value 信号双向绑定，min/max/step 可配，原生 range 承载键盘交互，右侧可显示当前值",
       "checkbox(props)：复选框，checked 信号双向绑定，disabled 支持布尔或信号禁用",
@@ -168,6 +169,52 @@
           "在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}`"
         ]
       },
+      {
+        "id": "inputNumber",
+        "title": "数字输入 InputNumber",
+        "demo": "sec-inputnumber",
+        "props": [
+          {
+            "n": "value",
+            "t": "Signal<number>",
+            "r": 1,
+            "d": "当前值信号，双向绑定（按钮/键盘写回、外部赋值同步）"
+          },
+          {
+            "n": "min",
+            "t": "number",
+            "d": "最小值；缺省无下限"
+          },
+          {
+            "n": "max",
+            "t": "number",
+            "d": "最大值；缺省无上限"
+          },
+          {
+            "n": "step",
+            "t": "number",
+            "d": "步长；缺省 1",
+            "df": "1"
+          },
+          {
+            "n": "disabled",
+            "t": "boolean | Signal<boolean>",
+            "d": "禁用态：布尔直接置位，传信号则动态同步"
+          },
+          {
+            "n": "onChange",
+            "t": "(value: number) => void",
+            "k": 1,
+            "d": "值变化回调（已夹取到合法区间）"
+          }
+        ],
+        "example": "const qty = signal(1); const el = inputNumber({ value: qty, min: 1, max: 99, onChange: (v) => console.log(v) })",
+        "steps": [
+          "用 signal(1) 创建数字信号并传入 value 完成双向绑定",
+          "点击 −/+ 按钮或在输入框聚焦时按 ↑↓ 以 step 调节；直接输入在失焦或回车时解析",
+          "非法输入自动回滚为当前值；min/max 超界自动夹取，disabled 支持布尔或信号禁用"
+        ]
+      },
       {
         "id": "textarea",
         "title": "多行输入 Textarea",

packages/skin/ui/ui.css

@@ -687,6 +687,22 @@
   resize: vertical;
 }
 
+/* —— 数字输入 —— */
+.ua-input-number {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+}
+.ua-input-number .ua-btn {
+  padding: 5px 12px; /* 收窄为步进按钮 */
+  line-height: 1.4;
+}
+.ua-input-number-field {
+  width: 76px;
+  text-align: center;
+  font-variant-numeric: tabular-nums;
+}
+
 /* —— 徽标 —— */
 .ua-badge {
   display: inline-block;