feat(router): implement named navigation

- Added names to routes
- Added example sub-route
- Updated Routes class

Author: fulleni

lib/router/router.dart

@@ -14,12 +14,24 @@ final appRouter = GoRouter(
       routes: [
         GoRoute(
           path: Routes.headlinesFeed,
+          name: Routes.headlinesFeedName,
           builder: (BuildContext context, GoRouterState state) {
             return const HeadlinesFeedPage();
           },
+          routes: [
+            GoRoute(
+              path: 'article/:id',
+              name: Routes.articleDetailsName,
+              builder: (BuildContext context, GoRouterState state) {
+                final id = state.pathParameters['id']!;
+                return Placeholder(child: Text('Article ID: $id'));
+              },
+            ),
+          ],
         ),
         GoRoute(
           path: Routes.search,
+          name: Routes.searchName,
           builder: (BuildContext context, GoRouterState state) {
             return const Placeholder(
               child: Center(
@@ -30,6 +42,7 @@ final appRouter = GoRouter(
         ),
         GoRoute(
           path: Routes.account,
+          name: Routes.accountName,
           builder: (BuildContext context, GoRouterState state) {
             return const Placeholder(
               child: Center(

lib/router/routes.dart

@@ -1,6 +1,11 @@
 abstract final class Routes {
   static const home = '/';
+  static const homeName = 'home';
   static const headlinesFeed = '/headlines-feed';
+  static const headlinesFeedName = 'headlinesFeed';
   static const search = '/search';
+  static const searchName = 'search';
   static const account = '/account';
+  static const accountName = 'account';
+  static const articleDetailsName = 'articleDetails'; // For the sub-route
 }

memory-bank/activeContext.md

@@ -17,8 +17,14 @@ Initializing the memory bank. This involves creating the core files and populati
 - Updated `.clinerules` with the convention to document no-op operations.
 - Updated `.clinerules` with error handling best practices.
 
+## Recent Changes
+- Refactored the router (`lib/router/router.dart` and `lib/router/routes.dart`):
+  - Added `name` parameters to `GoRoute` definitions for named navigation.
+  - Added an example sub-route (`article/:id`) to demonstrate detail page routing.
+  - Updated the `Routes` class to include name constants.
+
 ## Next Steps
-- Update `progress.md`
+- Update `progress.md`.
 
 ## Active Decisions
 

memory-bank/progress.md

@@ -6,6 +6,7 @@
 -   BLoC pattern implementation for state management.
 -   Repository pattern for data access.
 -   Initial Memory Bank setup.
+- Router refactoring with named navigation and example sub-route.
 -   `headlines-feed` feature:
     -   `HeadlinesFeedBloc` for managing headlines data and filtering.
     -   `HeadlinesFeedPage` and `_HeadlinesFeedView` for displaying headlines.
@@ -17,7 +18,7 @@
 
 -   Integration with a real headlines API (currently using an in-memory client).
 -   Full implementation of filtering functionality (UI is present, but API integration may be needed).
--   Navigation and routing (basic setup exists, but likely needs more work for navigating to article details, etc.).
+-   Navigation and routing (basic setup exists, named navigation implemented, sub-routes need further implementation based on application needs).
 -   Error handling and potentially loading states (basic widgets exist, but more robust handling may be needed).
 -   Testing.
 

pubspec.yaml

@@ -1,6 +1,6 @@
 name: ht_main
 description: main headlines toolkit mobile app.
-version: 0.13.0
+version: 0.14.0
 publish_to: none
 repository: https://github.com/headlines-toolkit/ht-main
 environment: