test(popup): 补齐应用示例展开态 Golden

Author: RSS1102

specs/020-popup-demo-alignment/acceptance.md

@@ -5,7 +5,7 @@
 - Flutter 3.32.0 / latest 3.47.0 严格 analyze：均为 0 error / 0 warning。
 - Popup 完整组件回归在本轮 Flutter 3.32.0 复跑 169 项通过；当前覆盖率调度器口径下生产源码 `519/532 = 97.56%`。
 - Popup Demo 功能测试：两个版本各 4 项通过。
-- Flutter 3.32.0 Linux 明暗主题 Golden：更新后立即无更新参数复跑，2 项完整页面与 10 项五方向展开态共 12 项通过；固定 375dp、DPR 1、受控 Roboto/CJK/TIcons 字体，展开态截取包含蒙层与 Popup Route 的 `Overlay`，未保留缺字符号。
+- Flutter 3.32.0 Linux 明暗主题 Golden：更新后立即无更新参数复跑，2 项完整页面与 14 项全部七个公开实例展开态共 16 项通过；固定 375dp、DPR 1、受控 Roboto/CJK/TIcons 字体，展开态截取包含蒙层与 Popup Route 的 `Overlay`，未保留缺字符号。
 - 示例代码生成 check、回归调度器自测与 `git diff --check` 通过。
 
 ## 人工证据

specs/020-popup-demo-alignment/plan.md

@@ -24,6 +24,6 @@
 ## 验证策略
 
 - 双版本执行 Popup 组件测试、Demo 功能测试与严格 analyze。
-- Flutter 3.32.0 Linux 生成并复跑明暗主题完整页面 Golden，以及顶部、左侧、居中、底部、右侧五个基础方向的展开态 Golden。
+- Flutter 3.32.0 Linux 生成并复跑明暗主题完整页面 Golden，以及顶部、左侧、居中、底部、右侧五个基础方向和两个应用示例的展开态 Golden。
 - 按 `lib/src/components/popup/` 过滤 LCOV，要求 LH/LF 不低于 95%。
 - 运行生成器 check、调度器自测和 `git diff --check`。

specs/020-popup-demo-alignment/spec.md

@@ -10,7 +10,7 @@ Popup Flutter Demo 虽覆盖了小程序公开页面的 7 个场景，但分组
 - 基础实例按顶部、左侧、居中、底部、右侧排列。
 - 对齐 5 个基础实例和 2 个应用实例的文案、尺寸、头部与关闭按钮结构。
 - Popup 默认贴合屏幕边缘，不主动避让系统安全区；需要避让时由调用方显式开启或在内容中组合 `SafeArea`。
-- 增加独立的双版本功能测试，以及 Flutter 3.32.0 Linux 明暗主题完整页面与五方向展开态 Golden，并接入集中式 CI 调度器。
+- 增加独立的双版本功能测试，以及 Flutter 3.32.0 Linux 明暗主题完整页面与全部七个公开实例展开态 Golden，并接入集中式 CI 调度器。
 
 ## 非目标
 
@@ -32,7 +32,7 @@ Popup Flutter Demo 虽覆盖了小程序公开页面的 7 个场景，但分组
 
 - [x] 分组、说明、实例数量、顺序和按钮文案由 Demo Widget 测试精确断言。
 - [x] 基础底部与两个应用实例的关键结构、尺寸和关闭交互通过测试。
-- [x] 明暗主题完整页面及五个基础方向展开态 Golden 在 Flutter 3.32.0 Linux 可复现。
+- [x] 明暗主题完整页面及全部七个公开实例展开态 Golden 在 Flutter 3.32.0 Linux 可复现。
 - [x] 已用微信开发者工具实际页截图与 Flutter Golden 比对，公开矩阵一致。
 - [x] Popup 组件测试、覆盖率目标、Demo 功能测试与 Golden 均进入 CI 实际调度入口。
 - [x] Popup 生产源码行覆盖率不低于 95%。

specs/020-popup-demo-alignment/tasks.md

@@ -6,5 +6,5 @@
 - [x] 删除公开嵌套示例
 - [x] 新增 Demo 结构与交互测试
 - [x] 登记 Popup 组件回归、覆盖率、功能测试与视觉回归
-- [x] Flutter 3.32.0 Linux 生成并无更新参数复跑明暗主题完整页面与五方向展开态 Golden
+- [x] Flutter 3.32.0 Linux 生成并无更新参数复跑明暗主题完整页面与全部七个公开实例展开态 Golden
 - [x] Flutter 3.32.0 与 latest 完整验证

tdesign-component/example/test/goldens/popup_application_custom_close_opened_dark.png

@@ -4,36 +4,93 @@ import 'package:flutter_test/flutter_test.dart';
 import 'demo_page_test_utils.dart';
 import 'popup_demo_test_spec.dart';
 
+class _OpenedPopupGoldenCase {
+  const _OpenedPopupGoldenCase({
+    required this.name,
+    required this.triggerKey,
+    this.visibleText,
+    this.visibleTextCount = 1,
+    this.tooltip,
+  });
+
+  final String name;
+  final String triggerKey;
+  final String? visibleText;
+  final int visibleTextCount;
+  final String? tooltip;
+}
+
 void main() {
   registerDemoGoldenTests(popupDemoPageTestSpec);
 
-  const basicPopupCases = {
-    'top': ('popup-top-trigger', '顶部弹出'),
-    'left': ('popup-left-trigger', '左侧弹出'),
-    'center': ('popup-center-trigger', '中间弹出'),
-    'bottom': ('popup-bottom-trigger', '底部弹出'),
-    'right': ('popup-right-trigger', '右侧弹出'),
-  };
+  const openedPopupCases = [
+    _OpenedPopupGoldenCase(
+      name: 'basic_top',
+      triggerKey: 'popup-top-trigger',
+      visibleText: '顶部弹出',
+      visibleTextCount: 2,
+    ),
+    _OpenedPopupGoldenCase(
+      name: 'basic_left',
+      triggerKey: 'popup-left-trigger',
+      visibleText: '左侧弹出',
+      visibleTextCount: 2,
+    ),
+    _OpenedPopupGoldenCase(
+      name: 'basic_center',
+      triggerKey: 'popup-center-trigger',
+      visibleText: '中间弹出',
+      visibleTextCount: 2,
+    ),
+    _OpenedPopupGoldenCase(
+      name: 'basic_bottom',
+      triggerKey: 'popup-bottom-trigger',
+      visibleText: '底部弹出',
+      visibleTextCount: 2,
+    ),
+    _OpenedPopupGoldenCase(
+      name: 'basic_right',
+      triggerKey: 'popup-right-trigger',
+      visibleText: '右侧弹出',
+      visibleTextCount: 2,
+    ),
+    _OpenedPopupGoldenCase(
+      name: 'application_with_title',
+      triggerKey: 'popup-with-title-trigger',
+      visibleText: '标题文字',
+    ),
+    _OpenedPopupGoldenCase(
+      name: 'application_custom_close',
+      triggerKey: 'popup-custom-close-trigger',
+      tooltip: '关闭',
+    ),
+  ];
 
   for (final mode in [ThemeMode.light, ThemeMode.dark]) {
-    for (final entry in basicPopupCases.entries) {
-      final placement = entry.key;
-      final popupCase = entry.value;
-      testWidgets('popup basic $placement ${mode.name} opened golden', (
+    for (final popupCase in openedPopupCases) {
+      testWidgets('popup ${popupCase.name} ${mode.name} opened golden', (
         tester,
       ) async {
         await pumpDemoPageAtPhoneViewport(tester, popupDemoPageTestSpec, mode);
 
-        final trigger = find.byKey(ValueKey(popupCase.$1));
+        final trigger = find.byKey(ValueKey(popupCase.triggerKey));
         expect(trigger, findsOneWidget);
         await tester.tap(trigger);
         await tester.pumpAndSettle();
 
-        expect(find.text(popupCase.$2), findsAtLeastNWidgets(2));
+        if (popupCase.visibleText case final visibleText?) {
+          expect(
+            find.text(visibleText),
+            findsNWidgets(popupCase.visibleTextCount),
+          );
+        }
+        if (popupCase.tooltip case final tooltip?) {
+          expect(find.byTooltip(tooltip), findsOneWidget);
+        }
         await expectLater(
           find.byType(Overlay),
           matchesGoldenFile(
-            'goldens/popup_basic_${placement}_opened_${mode.name}.png',
+            'goldens/popup_${popupCase.name}_opened_${mode.name}.png',
           ),
         );
         await disposeDemoPage(tester);