表单校验

import { initFormValidate, createFormValidator, registerValidator, setValidateMessages }  from '@icen.ai/ui/kit/form-validate';initFormValidate();   // document 委托 + 幂等；form[data-icen-validate] 自动挂 novalidate<!-- HTML5 属性即 schema；data-icen-validate 只承载额外规则 --><form data-icen-validate data-icen-validate-summary data-icen-validate-show-valid>  <input name="email" type="email" required data-icen-msg-required="邮箱必填" />  <input name="confirm" data-icen-validate="matches:password" />  <input name="code" data-icen-validate="unique:invite" /></form><!-- 具名自定义校验（可异步；true 通过，string 即消息） -->registerValidator('unique', async (value, field, form) => {  const res = await fetch('/api/check?code=' + encodeURIComponent(value));  return res.ok ? true : '邀请码无效';});<!-- i18n 全局消息表（占位符 {min} {max} {step} {length} {label}） -->setValidateMessages({ required: '{label}不能为空', email: '邮箱格式有误' });<!-- 程序化单表单（同 form 单例，init 与显式创建共享） -->const handle = createFormValidator(formEl, {  strategy: { on: 'submit', debounceMs: 160 },   // on: 'submit'|'blur'|'input'；缺省 = submit 优先策略  scrollToError: true,                            // 失败聚焦首错 + scrollIntoView});await handle.validate();          // true | false；事件 icen:form-valid / icen:form-invalid 双通道await handle.validateField('email');handle.errors();                  // { 字段名: 消息 }handle.reset();                   // 清状态与呈现（不动值）handle.destroy();// 事件（detail 契约见 events.ts IcenEventMap）：//   icen:form-field-validate { name, valid, message? }   每字段校验完//   icen:form-valid   { names }                            整表通过（通过字段名数组）//   icen:form-invalid { errors, first }                    未过（errors + 第一个错误字段名）// AI 工具（import 本模块即自动注册）：//   show_form —— 向用户渲染一个结构化表单收集输入；//   area.call('show_form', { title, fields: [{ name, label, type, required, pattern, min, max, options, help }], submitLabel })//   → run 返回 Promise：提交（过校验）resolve 表单值对象；「取消」resolve { cancelled: true }