Expose layout API and refresh regression docs

开发记录/功能变更/Feature-20260415-0008-KEY5-第二阶段专项回归场景增强.md

@@ -0,0 +1,78 @@
+# 功能变更 ID: Feature-20260415-0008
+
+> 适用场景：记录小到中等规模的功能、接口、行为、默认值或配置变化。
+> 不适用场景：新增核心模块、重大模块重构、架构级设计，请使用“新增功能模块”模板。
+
+## 基本信息
+
+- ID: Feature-20260415-0008
+- 标题: KEY5 第二阶段专项回归场景增强
+- 状态：已完成
+- 类型：修改
+- 级别：L2 中等
+- 模块: 测试用例 / 回归场景
+- 版本 / 分支: 当前工作区
+- 环境: Windows + EasyX
+- 负责人: Codex 协作修改
+
+## 变更背景
+
+- 背景:
+  - 旧版 `KEY5` 已能覆盖第一阶段布局主线，但场景层次不够集中，说明文字偏长，部分区域排版紧。
+  - 第二阶段引入了内容驱动、overlay 补画、容器职责边界等新验证点，旧 `KEY5` 覆盖不完整。
+- 目标:
+  - 把 `KEY5` 重构成第二阶段专项回归入口。
+  - 增加三层 `Canvas` 嵌套、通用 overlay、跨容器 hover 清理、`Label` 内容驱动规则验证。
+- 不做什么：[可选]
+  - 不追求视觉美化。
+  - 不把测试用例变成完整 demo 页。
+
+## 变更内容
+
+- 变更摘要:
+  - 重构 `KEY5` 的区域布局与说明文案。
+  - 引入三层嵌套 `Canvas` 场景。
+  - 增加 `Window / Canvas / TabControl / Table` 四类关键回归点。
+- 新增项：[可选]
+  - 三层 `Canvas` 嵌套与多层锚点链回归。
+  - `Label` 文本变化 / 样式变化按钮。
+  - 跨容器相邻按钮 hover/tooltip 回归点。
+  - 顶层浮层覆盖 `Table` 的 overlay 回归点。
+- 修改项：[可选]
+  - 缩短说明 `Label` 文案，减少普通排版重叠。
+  - 重新组织分区顺序，提升单区可读性。
+- 删除 / 废弃项：[可选]
+  - 删除过长、重复的说明文案。
+- 受影响的文件 / 类 / 函数:
+  - [`z-testDome.cpp`](D:/programming/imGUI-easyX/imGui-easyX/z-testDome.cpp)
+- 对外 API / 属性变化：[可选]
+  - 无
+
+## 行为对照
+
+- 变更前:
+  - `KEY5` 主要覆盖第一阶段布局规则，层次和交互链回归点相对分散。
+  - 说明文字较长，部分区域排版偏挤。
+- 变更后:
+  - `KEY5` 成为第二阶段主回归入口。
+  - 三层嵌套、overlay、跨容器 hover、`Label` 内容驱动、`Table` 分页与页码都能直接观察。
+- 兼容性说明：兼容
+- 迁移说明：[可选]
+  - 仍然通过 `#define KEY 5` 进入，无额外迁移。
+
+## 验证与落地
+
+- 验证方式:
+  - 编译 `z-testDome.cpp /DKEY=5`
+  - 手动观察窗口 resize、hover、tooltip、overlay、分页和 `Label` 变化
+- 验证结果:
+  - 编译级验证通过
+  - GUI 手动验证待本机执行
+- 关联 BUG / Fix：[可选]
+  - `BUG-20260415-0005`
+  - `Fix-BUG-20260415-0005`
+- Commit: 未提交（当前工作区）
+- PR：[可选]
+- 发布版本：[可选]
+- 备注：[可选]
+  - `Label` 样式变化验证明确依赖 `setDirty(true)` 使用约定。