Files
AtomUI/docs/controls
chinboy e4ba7ee512 docs(Semantic): 修正 SearchEdit 语义契约占位表并补正 public surface 描述
overview.md 的 LLMS 语义区域表原为生成器默认占位(root / input / trigger /
popup / validation,"相关 API" 列写「见 API 与契约模型」),与实际 descriptor
完全不符,且被逐字投射进对外生成的 semantic-cn.md,等于公开传播错误契约。
按 SearchEdit.SemanticParts.cs 的真实声明替换为 prefix / input / suffix /
clear / button 五个 Selector 部件,并记录路由锚点
(semantic-scope-input-frame / -prefix / -suffix),说明 semantic-content 与
semantic-placeholder 是非 Part 的辅助 marker,不注册 descriptor、不生成
Style,不属于对外语义契约。

同时补正同一文档中两处与源码不符的 public surface 描述:
- SearchButtonText 实际类型为 object?,原文写 string。
- 内部前后缀入口只有 InnerLeftContentTemplate / InnerRightContentTemplate,
  LineEdit 基类上没有非 Template 版本(文档照搬了别处的命名)。

全量审计(116 个声明部件名 vs 全部目标家族生成文档)确认这是 63 个家族中
唯一的契约与代码不符项。

验证:
- LLMS generate + verify 通过(79 控件 / 161 文件),影响面精确覆盖
  search-edit/semantic-cn.md 与两个聚合文件。
- SearchEdit 24/24、Docs.LLMsGenerator.Tests 23/23、Gallery 644/644、
  Desktop Controls 4031/4031 全绿,git diff --check 干净。
2026-09-17 11:13:21 +08:00
..