rippr/test/hud_edit_overlay_test.dart

import 'package:flutter/gestures.dart';
import 'package:flutter/material.dart';
import 'package:flutter_riverpod/flutter_riverpod.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:rippr/src/app/providers.dart';
import 'package:rippr/src/config/config.dart';
import 'package:rippr/src/hud/hud_metric.dart';
import 'package:rippr/src/ui/components/hud_edit_overlay.dart';
import 'package:shared_preferences/shared_preferences.dart';

/// UI-04: drag/toggle behaviour of the customizable HUD, simulated via `TestGesture`
/// the same way other drag interactions in this codebase are tested (see
/// `route_planner_screen_test.dart`'s waypoint-drag coverage).
void main() {
  late Config config;

  setUp(() async {
    SharedPreferences.setMockInitialValues({});
    config = await Config.load();
  });

  Widget host() => ProviderScope(
    overrides: [configProvider.overrideWith((ref) => config)],
    child: MaterialApp(
      home: Scaffold(
        body: SizedBox.expand(
          child: HudEditOverlay(
            metricBuilder: (context, metric) => Text(metric.label),
          ),
        ),
      ),
    ),
  );

  testWidgets('a tap outside edit mode does not move a widget', (tester) async {
    await tester.pumpWidget(host());
    await tester.pumpAndSettle();

    expect(find.byKey(const Key('hud-edit-done')), findsNothing,
        reason: 'not editing yet');

    await tester.tap(find.text('Speed'));
    await tester.pump();

    expect(find.byKey(const Key('hud-edit-done')), findsNothing,
        reason: 'a plain tap on a widget must never enter edit mode or move it');
  });

  testWidgets('a long-press on empty space enters edit mode, showing resize handles '
      'and Done', (tester) async {
    await tester.pumpWidget(host());
    await tester.pumpAndSettle();

    await tester.longPress(find.byKey(const Key('hud-edit-background')));
    await tester.pumpAndSettle();

    expect(find.byKey(const Key('hud-edit-done')), findsOneWidget);
    expect(find.byKey(const Key('hud-resize-handle')), findsWidgets);
  });

  testWidgets('a long-press-and-drag on a widget moves it, and Done persists the new '
      'position', (tester) async {
    await tester.pumpWidget(host());
    await tester.pumpAndSettle();

    await tester.longPress(find.byKey(const Key('hud-edit-background')));
    await tester.pumpAndSettle();

    final before = config.hudLayout[HudMetric.speed]!;

    final speedFinder = find.text('Speed');
    final gesture = await tester.startGesture(tester.getCenter(speedFinder));
    await tester.pump(kLongPressTimeout + kPressTimeout);
    await gesture.moveBy(const Offset(40, 60));
    await tester.pump();
    await gesture.up();
    await tester.pumpAndSettle();

    await tester.tap(find.byKey(const Key('hud-edit-done')));
    await tester.pumpAndSettle();

    final after = config.hudLayout[HudMetric.speed]!;
    expect(after.x, isNot(before.x));
    expect(after.y, isNot(before.y));
  });

  testWidgets('a drag while not editing does not move the widget', (tester) async {
    await tester.pumpWidget(host());
    await tester.pumpAndSettle();

    final before = config.hudLayout[HudMetric.speed]!;
    final speedFinder = find.text('Speed');

    final gesture = await tester.startGesture(tester.getCenter(speedFinder));
    await tester.pump(kLongPressTimeout + kPressTimeout);
    await gesture.moveBy(const Offset(40, 60));
    await gesture.up();
    await tester.pumpAndSettle();

    expect(find.byKey(const Key('hud-edit-done')), findsNothing);
    final after = config.hudLayout[HudMetric.speed]!;
    expect(after.x, before.x);
    expect(after.y, before.y);
  });

  testWidgets('only visible metrics render a widget', (tester) async {
    await tester.pumpWidget(host());
    await tester.pumpAndSettle();

    expect(find.text('Speed'), findsOneWidget, reason: 'visible by default');
    expect(find.text('Max speed'), findsNothing, reason: 'hidden by default');
  });
}