halkyon/halkyon_learn_flutter/lib/src/app/app_router.dart

import 'package:flutter_bloc/flutter_bloc.dart';
import 'package:go_router/go_router.dart';
import 'package:halkyon_learn_flutter/src/core/dependencies/person_scope.dart';
import 'package:halkyon_learn_flutter/src/core/router/app_shell.dart';
import 'package:halkyon_learn_flutter/src/core/router/route_paths.dart';
import 'package:halkyon_learn_flutter/src/core/router/tab_visibility.dart';
import 'package:halkyon_learn_flutter/src/core/widget/found_by_id.dart';
import 'package:halkyon_learn_flutter/src/feature/auth/widget/profile_screen.dart';
import 'package:halkyon_learn_flutter/src/feature/card/bloc/card_edit_bloc.dart';
import 'package:halkyon_learn_flutter/src/feature/card/model/card.dart';
import 'package:halkyon_learn_flutter/src/feature/card/widget/card_screen.dart';
import 'package:halkyon_learn_flutter/src/feature/explore/widget/explore_screen.dart';
import 'package:halkyon_learn_flutter/src/feature/home/widget/home_screen.dart';
import 'package:halkyon_learn_flutter/src/feature/settings/widget/settings_screen.dart';
import 'package:halkyon_learn_flutter/src/feature/study/bloc/study_session_bloc.dart';
import 'package:halkyon_learn_flutter/src/feature/study/widget/study_screen.dart';
import 'package:halkyon_learn_flutter/src/feature/studyset/model/studyset.dart';
import 'package:halkyon_learn_flutter/src/feature/studyset/widget/library_screen.dart';
import 'package:halkyon_learn_flutter/src/feature/studyset/widget/studyset_screen.dart';
// Material's Card widget would clash with the domain's Card.
import 'package:material_ui/material_ui.dart' hide Card;

/// The router of one person's app: the four tabs in a shell, each with its own
/// stack of screens, and the focused surfaces over them. Every route is built
/// inside the person's scope, so screens read their repositories from
/// [PersonScope]. The app opens at [initialLocation].
GoRouter buildRouter({String initialLocation = RoutePaths.home}) => GoRouter(
  initialLocation: initialLocation,
  routes: [
    StatefulShellRoute(
      builder: (context, state, navigationShell) =>
          AppShell(navigationShell: navigationShell),
      navigatorContainerBuilder: tabsContainer,
      // In the order of the shell's destinations.
      branches: [
        StatefulShellBranch(
          routes: [
            GoRoute(
              path: RoutePaths.home,
              builder: (context, state) => const HomeScreen(),
            ),
          ],
        ),
        StatefulShellBranch(
          routes: [
            GoRoute(
              path: RoutePaths.library,
              builder: (context, state) => const LibraryScreen(),
              // Nested, so a studyset's screen sits above the library in the
              // tab's stack.
              routes: [
                GoRoute(
                  path: 'studysets/:id',
                  // Keyed by the id: several studysets' screens can be on
                  // the stack at once, and must not share one page.
                  pageBuilder: (context, state) {
                    final id = state.pathParameters['id']!;
                    return MaterialPage<void>(
                      key: ValueKey('studyset-$id'),
                      child: _studysetScreen(context, id),
                    );
                  },
                ),
              ],
            ),
          ],
        ),
        StatefulShellBranch(
          routes: [
            GoRoute(
              path: RoutePaths.explore,
              builder: (context, state) => const ExploreScreen(),
            ),
          ],
        ),
        StatefulShellBranch(
          routes: [
            GoRoute(
              path: RoutePaths.profile,
              builder: (context, state) => const ProfileScreen(),
            ),
          ],
        ),
      ],
    ),
    // Over the tabs: they need the whole window.
    GoRoute(
      path: '/study/:studysetId',
      builder: (context, state) {
        final person = PersonScope.of(context);
        return BlocProvider(
          create: (context) => StudySessionBloc(
            person.studysets,
            person.cards,
            person.reviews,
            state.pathParameters['studysetId']!,
          )..add(const StudySessionEventStarted()),
          child: const StudyScreen(),
        );
      },
    ),
    // Before the card route: its `new` would otherwise read as a card's id.
    GoRoute(
      path: '/studysets/:studysetId/cards/new',
      builder: (context, state) => BlocProvider(
        create: (context) => CardEditBloc(
          PersonScope.of(context).cards,
          PersonScope.of(context).tags,
          state.pathParameters['studysetId']!,
          null,
        )..add(const CardEditEventStarted()),
        child: const CardScreen(card: null),
      ),
    ),
    GoRoute(
      path: '/studysets/:studysetId/cards/:cardId',
      builder: (context, state) {
        final person = PersonScope.of(context);
        final studysetId = state.pathParameters['studysetId']!;
        return FoundById<Card>(
          id: state.pathParameters['cardId']!,
          items: () => person.cards.watch(studysetId),
          idOf: (card) => card.id,
          builder: (card, _) => BlocProvider(
            create: (context) => CardEditBloc(
              person.cards,
              person.tags,
              studysetId,
              card,
            )..add(const CardEditEventStarted()),
            child: CardScreen(card: card),
          ),
        );
      },
    ),
    GoRoute(
      path: RoutePaths.settings,
      builder: (context, state) => const SettingsScreen(),
    ),
  ],
);

Widget _studysetScreen(BuildContext context, String id) => FoundById<Studyset>(
  id: id,
  items: PersonScope.of(context).studysets.watchAll,
  idOf: (studyset) => studyset.id,
  builder: (studyset, all) => StudysetScreen(studyset: studyset, all: all),
);