TestWidgetsApp class

A minimal WidgetsApp wrapper for use in widget tests.

This provides a convenient way to wrap test widgets with the necessary app-level widgets (like Directionality, MediaQuery, etc.) that WidgetsApp provides, without the overhead of MaterialApp or CupertinoApp.

The pageRouteBuilder creates a Navigator which provides an Overlay, so widgets that need overlay support (like Draggable, RawTooltip, etc.) will work correctly when placed in home.

Example usage:

testWidgets('my test', (WidgetTester tester) async {
  await tester.pumpWidget(
    TestWidgetsApp(
      home: GestureDetector(
        onTap: () {},
        child: Container(),
      ),
    ),
  );
});

For navigation tests with routes:

testWidgets('navigation test', (WidgetTester tester) async {
  await tester.pumpWidget(
    TestWidgetsApp(
      home: const Text('Home'),
      routes: <String, WidgetBuilder>{
        '/details': (BuildContext context) => const Text('Details'),
      },
    ),
  );
  tester.state<NavigatorState>(find.byType(Navigator)).pushNamed('/details');
  await tester.pumpAndSettle();
});

For tests that need full control over route generation:

testWidgets('custom route test', (WidgetTester tester) async {
  await tester.pumpWidget(
    TestWidgetsApp(
      initialRoute: '/',
      onGenerateRoute: (RouteSettings settings) {
        return PageRouteBuilder<void>(
          settings: settings,
          pageBuilder: (_, _, _) => const Text('Generated'),
        );
      },
    ),
  );
});