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

.ua/index.json

@@ -1,6 +1,6 @@
 {
   "$schema": "ui-arch-registry-index/0.1",
-  "generatedAt": "2026-10-23T10:58:48.833Z",
+  "generatedAt": "2026-10-23T11:03:12.689Z",
   "repoRoot": ".",
   "packages": [
     {
@@ -143,9 +143,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 支持布尔或信号禁用",
@@ -325,13 +325,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），控件会包进带边框的附加组，聚焦光环由组统一承载"
             ]
           },
           {
@@ -371,13 +382,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），控件会包进带边框的附加组，聚焦光环由组统一承载"
             ]
           },
           {
@@ -411,13 +433,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），控件会包进带边框的附加组，聚焦光环由组统一承载"
             ]
           },
           {