jiu/client/test/support/golden_harness.dart

import 'package:flutter/material.dart';
import 'package:flutter/services.dart' show rootBundle, FontLoader;
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:jiu_client/core/theme/themes.dart';
import 'package:jiu_client/core/utils/clock.dart';

// 加载真实中文字体（消除 golden 豆腐块），使 golden 能与原型截图做保真 diff。
// 原型截图侧同样注入 Noto Sans SC（见 tools/fidelity.mjs），两边字体一致。
bool _fontsLoaded = false;
Future<void> ensureGoldenFonts() async {
  if (_fontsLoaded) return;
  final loader = FontLoader('NotoSansSC')
    ..addFont(rootBundle.load('assets/fonts/NotoSansSC.ttf'));
  await loader.load();
  // 等宽真相源 JetBrainsMono（AppFonts.mono；400+700）——与原型截图注入、
  // 真机打包同一字体文件，等宽渲染三方同源（未加载会渲染成黑块 tofu）。
  final mono = FontLoader('JetBrainsMono')
    ..addFont(rootBundle.load('assets/fonts/JetBrainsMono-Regular.ttf'))
    ..addFont(rootBundle.load('assets/fonts/JetBrainsMono-Bold.ttf'));
  await mono.load();
  // 真实 Material 图标字体（否则 golden 里图标渲染成豆腐块 □）。
  for (final key in const [
    'fonts/MaterialIcons-Regular.otf',
    'packages/flutter/fonts/MaterialIcons-Regular.otf',
  ]) {
    try {
      final f = FontLoader('MaterialIcons')..addFont(rootBundle.load(key));
      await f.load();
      break;
    } catch (_) {/* 换下一个 asset key */}
  }
  // lucide 图标字体（与原型同款图形库）。
  try {
    // package 字体在运行时 family 带 packages/<pkg>/ 前缀，FontLoader 须用全名。
    final lucide = FontLoader('packages/lucide_icons_flutter/Lucide')
      ..addFont(
          rootBundle.load('packages/lucide_icons_flutter/assets/lucide.ttf'));
    await lucide.load();
  } catch (_) {/* 包未装时跳过 */}
  _fontsLoaded = true;
}

/// 把 NotoSansSC 套到主题文字上（含 hardcoded TextStyle 经 DefaultTextStyle 继承）。
ThemeData withGoldenFont(ThemeData base) => base.copyWith(
      textTheme: base.textTheme.apply(fontFamily: 'NotoSansSC'),
      primaryTextTheme: base.primaryTextTheme.apply(fontFamily: 'NotoSansSC'),
    );

/// design-distill 阶段4（Flutter 端）可复用 golden 骨架。
/// 在指定主题 / viewport 下渲染 [child]（含 provider 覆盖），比对/更新 golden。
///
/// 验收分两类闸（见 ~/.claude/skills/design-distill/references/flutter-golden.md）：
/// - 保真：原型基准 vs 本 golden 用 montage.mjs 人工目检（跨渲染器，不跑严格 diff）。
/// - 回归：本 golden 多主题入库，CI `flutter test` 同渲染器自比抓串色/漏 token。
///
/// 更新基准：flutter test --update-goldens test/golden/<x>_golden_test.dart
///
/// 坑（详见 reference）：viewport 逻辑尺寸 = physical ÷ dpr（已按 logical*dpr 设好）；
/// 高度给足防 RenderFlex 溢出；测试无中文字体 → CJK 显示豆腐块属正常。
Future<void> pumpGolden(
  WidgetTester tester, {
  required Widget child,
  required String theme,
  required String goldenName,
  List<Override> overrides = const [],
  Size logical = const Size(1280, 900),
  double dpr = 2.0,
}) async {
  await ensureGoldenFonts();
  // 冻结应用时钟：凡走 appNow() 的展示计算（如商品详情「近30天出库」）不再依赖真实时间，
  // 保证 golden 确定性（ds-flow：golden 钉死一切动态值）。选 2026-07-01，使 fake 6 月流水
  // 稳定落在「近30天」窗口内。tearDown 复位，不影响其它测试。
  appClock = () => DateTime(2026, 7, 1, 12, 0);
  addTearDown(() => appClock = () => DateTime.now());
  tester.view.physicalSize = Size(logical.width * dpr, logical.height * dpr);
  tester.view.devicePixelRatio = dpr;
  addTearDown(tester.view.resetPhysicalSize);
  addTearDown(tester.view.resetDevicePixelRatio);

  await tester.pumpWidget(ProviderScope(
    overrides: overrides,
    child: MaterialApp(
      debugShowCheckedModeBanner: false,
      theme: withGoldenFont(buildTheme(theme)),
      home: child,
    ),
  ));
  await tester.pumpAndSettle();

  await expectLater(
    find.byType(MaterialApp),
    matchesGoldenFile('goldens/$goldenName.png'),
  );
}

/// 跑「同一 child × A/B/C 三主题」的 golden 组（回归闸常用）。
void goldenAcrossThemes(
  String description, {
  required Widget Function() child,
  required String goldenPrefix,
  List<Override> Function()? overrides,
  Size logical = const Size(1280, 900),
  double dpr = 2.0,
}) {
  for (final theme in const ['a', 'b', 'c']) {
    testWidgets('$description · theme $theme', (tester) async {
      await pumpGolden(
        tester,
        child: child(),
        theme: theme,
        goldenName: '${goldenPrefix}_$theme',
        overrides: overrides?.call() ?? const [],
        logical: logical,
        dpr: dpr,
      );
    });
  }
}