iter(g03): 输入组件补 prefix/suffix 附加块

packages/skin/ui/ua.manifest.json

@@ -14,9 +14,9 @@
     "entry": "src/index.ts",
     "exports": [
       "button(props)：按钮，variant = primary | ghost | danger，disabled 支持布尔或信号禁用",
-      "textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号禁用",
-      "inputNumber(props)：数字输入，−/+ 按钮 + 键盘 ↑↓ 调节，value 信号双向绑定，min/max/step 超界自动夹取",
-      "textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号禁用",
+      "textField(props)：文本输入，value 信号双向绑定，disabled 支持布尔或信号，onInput 输入回调；prefix/suffix 可选渲染为输入框内侧附加块",
+      "inputNumber(props)：数字输入，−/+ 按钮与键盘 ↑↓ 调节，min/max/step 夹取；prefix/suffix 可选渲染为整组前后附加块",
+      "textarea(props)：多行输入，value 信号双向绑定，disabled 支持布尔或信号，rows 控行数；prefix/suffix 可选渲染为上下附加块",
       "slider(props)：滑块，value 信号双向绑定，min/max/step 可配，原生 range 承载键盘交互，右侧可显示当前值",
       "checkbox(props)：复选框，checked 信号双向绑定，disabled 支持布尔或信号禁用",
       "switchButton(props)：开关，checked 信号双向绑定，disabled 支持布尔或信号禁用",
@@ -196,13 +196,24 @@
             "t": "(value: string) => void",
             "k": 1,
             "d": "输入回调，每次按键触发"
+          },
+          {
+            "n": "prefix",
+            "t": "string | HTMLElement",
+            "d": "前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染"
+          },
+          {
+            "n": "suffix",
+            "t": "string | HTMLElement",
+            "d": "后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染"
           }
         ],
         "example": "const name = signal(''); const el = textField({ value: name, placeholder: '输入名字…', onInput: (v) => console.log(v) })",
         "steps": [
           "先用 signal('') 创建字符串信号",
           "传入 value 完成双向绑定：用户输入自动写回，外部赋值自动回显",
-          "在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}`"
+          "在任意响应式位置用 name() 读取最新值，如 () => `你好，${name()}`",
+          "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载"
         ]
       },
       {
@@ -242,13 +253,24 @@
             "t": "(value: number) => void",
             "k": 1,
             "d": "值变化回调（已夹取到合法区间）"
+          },
+          {
+            "n": "prefix",
+            "t": "string | HTMLElement",
+            "d": "前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染"
+          },
+          {
+            "n": "suffix",
+            "t": "string | HTMLElement",
+            "d": "后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染"
           }
         ],
         "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 支持布尔或信号禁用"
+          "非法输入自动回滚为当前值；min/max 超界自动夹取，disabled 支持布尔或信号禁用",
+          "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载"
         ]
       },
       {
@@ -282,13 +304,24 @@
             "t": "(value: string) => void",
             "k": 1,
             "d": "输入回调"
+          },
+          {
+            "n": "prefix",
+            "t": "string | HTMLElement",
+            "d": "前置附加块（textField/inputNumber 在输入框内侧前、textarea 在上方）；缺省不渲染"
+          },
+          {
+            "n": "suffix",
+            "t": "string | HTMLElement",
+            "d": "后置附加块（textField/inputNumber 在输入框内侧后、textarea 在下方）；缺省不渲染"
           }
         ],
         "example": "const bio = signal(''); textarea({ value: bio, rows: 4, placeholder: '一句话介绍…' })",
         "steps": [
           "创建信号并传入 value",
           "用 rows 控制初始高度，用户可纵向拉伸",
-          "字数统计等派生逻辑直接在响应式文本里读 bio().length"
+          "字数统计等派生逻辑直接在响应式文本里读 bio().length",
+          "需要图标、货币符、单位等前后缀时传 prefix/suffix（字符串或 DOM），控件会包进带边框的附加组，聚焦光环由组统一承载"
         ]
       },
       {