iter(g342): 重置按钮逐项复位字段与错误态

llms-full.txt

@@ -1,6 +1,6 @@
 # @ui-arch 组件库 Agent 文档（无图形版）
 
-> 自动生成于 2026-10-26T18:09:53.780Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
+> 自动生成于 2026-10-26T18:24:21.676Z，数据源：各包 ua.manifest.json，勿手改。人类版文档站：apps/docs/index.html。
 > 组件 = 普通函数，传 props 返回 DOM；状态用 signal 双向绑定：读 signal() 写 signal(v)。
 
 ## 快速上手
@@ -993,7 +993,8 @@ const open = signal(false); drawer({ title: '详情', open, width: 360, onClose:
 - （formItem）hint：string —— 控件下方辅助说明（格式提示等）；报错时让位给错误文案
 - （formItem）span：number —— 多列表单里本字段占几列（如整宽的多行备注）；单列布局或窄屏下自动退回整行
 - （formItem）visible：Signal<boolean> —— 条件显示信号：为假时整项隐藏且不参与校验（未显示的字段不该拦住提交）
-- onReset：() => void —— 重置按钮点击回调；组件不自行清空字段，由调用方重置信号；不传 resetText 不渲染按钮
+- （formItem）reset：() => void —— 自绘控件的复位钩子：select / dataTable 这类没有原生 input 的控件拿不到值，由调用方在这里回写信号；原生输入框由 formItem 自己还原，不用管
+- onReset：() => void —— 重置按钮点击回调；组件已先逐项复位（原生控件回初始值、错误态与汇总条清空），此处只做额外清理；不传 resetText 不渲染按钮
 - onError（回调）：(count: number) => void —— 校验不通过时的回调，参数为不通字段数（适合埋点或顶部提示）
 - errorSummary：boolean —— 是否在表单顶部显示「有 N 项需要修改」汇总条；缺省 true，自带错误 UI 时传 false