Merge pull request #2087 from Bdaya-Dev/master

Minor improvements with small breaking changes

@@ -75,9 +75,7 @@ class HomeView extends GetView<HomeController> {
                       shape: StadiumBorder(),
                       shape: StadiumBorder(),
                     ),
                     ),
                     onPressed: () async {
                     onPressed: () async {
-                      final data =
                       await Get.rootDelegate.toNamed('/home/country');
                       await Get.rootDelegate.toNamed('/home/country');
-                      print('DATA: $data');
                     },
                     },
                     child: Text(
                     child: Text(
                       'fetch_country'.tr,
                       'fetch_country'.tr,

+import 'dart:async';
+
+import 'package:get/get.dart';
+import 'package:async/async.dart';
+
+class SplashService extends GetxService {
+  final welcomeStr = ['GetX', 'Rules!'];
+  final activeStr = 0.obs;
+
+  final memo = AsyncMemoizer<void>();
+  Future<void> init() {
+    return memo.runOnce(_initFunction);
+  }
+
+  void _changeActiveString() {
+    activeStr.value = (activeStr.value + 1) % welcomeStr.length;
+  }
+
+  Future<void> _initFunction() async {
+    final t = Timer.periodic(
+      Duration(milliseconds: 500),
+      (t) => _changeActiveString(),
+    );
+    //simulate some long running operation
+    await Future.delayed(Duration(seconds: 5));
+    //cancel the timer once we are done
+    t.cancel();
+  }
+}

+import 'package:flutter/material.dart';
+
+import 'package:get/get.dart';
+
+import '../controllers/splash_service.dart';
+
+class SplashView extends GetView<SplashService> {
+  @override
+  Widget build(BuildContext context) {
+    return Scaffold(
+      body: Center(
+        child: Column(
+          mainAxisSize: MainAxisSize.min,
+          children: [
+            Obx(
+              () => Text(
+                controller.welcomeStr[controller.activeStr.value],
+                style: TextStyle(fontSize: 20),
+              ),
+            ),
+            CircularProgressIndicator(),
+          ],
+        ),
+      ),
+    );
+  }
+}

+import 'package:example_nav2/app/modules/splash/controllers/splash_service.dart';
+import 'package:example_nav2/app/modules/splash/views/splash_view.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/material.dart';
 import 'package:get/get.dart';
 import 'package:get/get.dart';
 
 
@@ -10,10 +12,23 @@ void main() {
       title: "Application",
       title: "Application",
       initialBinding: BindingsBuilder(
       initialBinding: BindingsBuilder(
         () {
         () {
+          Get.put(SplashService());
           Get.put(AuthService());
           Get.put(AuthService());
         },
         },
       ),
       ),
       getPages: AppPages.routes,
       getPages: AppPages.routes,
+      builder: (context, child) {
+        return FutureBuilder<void>(
+          key: ValueKey('initFuture'),
+          future: Get.find<SplashService>().init(),
+          builder: (context, snapshot) {
+            if (snapshot.connectionState == ConnectionState.done) {
+              return child ?? SizedBox.shrink();
+            }
+            return SplashView();
+          },
+        );
+      },
       // routeInformationParser: GetInformationParser(
       // routeInformationParser: GetInformationParser(
       //     // initialRoute: Routes.HOME,
       //     // initialRoute: Routes.HOME,
       //     ),
       //     ),

@@ -2,8 +2,6 @@
 //  Generated file. Do not edit.
 //  Generated file. Do not edit.
 //
 //
 
 
-// clang-format off
-
 #include "generated_plugin_registrant.h"
 #include "generated_plugin_registrant.h"
 
 
 
 

@@ -2,8 +2,6 @@
 //  Generated file. Do not edit.
 //  Generated file. Do not edit.
 //
 //
 
 
-// clang-format off
-
 #ifndef GENERATED_PLUGIN_REGISTRANT_
 #ifndef GENERATED_PLUGIN_REGISTRANT_
 #define GENERATED_PLUGIN_REGISTRANT_
 #define GENERATED_PLUGIN_REGISTRANT_
 
 

@@ -162,30 +162,25 @@ class GetInstance {
   }) {
   }) {
     final key = _getKey(S, name);
     final key = _getKey(S, name);
 
 
+    _InstanceBuilderFactory<S>? dep;
     if (_singl.containsKey(key)) {
     if (_singl.containsKey(key)) {
-      final dep = _singl[key];
-      if (dep != null && dep.isDirty) {
-        _singl[key] = _InstanceBuilderFactory<S>(
-          isSingleton,
-          builder,
-          permanent,
-          false,
-          fenix,
-          name,
-          lateRemove: dep as _InstanceBuilderFactory<S>,
-        );
-      }
+      final _dep = _singl[key];
+      if (_dep == null || !_dep.isDirty) {
+        return;
       } else {
       } else {
+        dep = _dep as _InstanceBuilderFactory<S>;
+      }
+    }
     _singl[key] = _InstanceBuilderFactory<S>(
     _singl[key] = _InstanceBuilderFactory<S>(
-        isSingleton,
-        builder,
-        permanent,
-        false,
-        fenix,
-        name,
+      isSingleton: isSingleton,
+      builderFunc: builder,
+      permanent: permanent,
+      isInit: false,
+      fenix: fenix,
+      tag: name,
+      lateRemove: dep,
     );
     );
   }
   }
-  }
 
 
   /// Initializes the dependencies for a Class Instance [S] (or tag),
   /// Initializes the dependencies for a Class Instance [S] (or tag),
   /// If its a Controller, it starts the lifecycle process.
   /// If its a Controller, it starts the lifecycle process.
@@ -519,14 +514,14 @@ class _InstanceBuilderFactory<S> {
 
 
   String? tag;
   String? tag;
 
 
-  _InstanceBuilderFactory(
-    this.isSingleton,
-    this.builderFunc,
-    this.permanent,
-    this.isInit,
-    this.fenix,
-    this.tag, {
-    this.lateRemove,
+  _InstanceBuilderFactory({
+    required this.isSingleton,
+    required this.builderFunc,
+    required this.permanent,
+    required this.isInit,
+    required this.fenix,
+    required this.tag,
+    required this.lateRemove,
   });
   });
 
 
   void _showInitLog() {
   void _showInitLog() {

@@ -4,6 +4,7 @@ export 'src/bottomsheet/bottomsheet.dart';
 export 'src/extension_navigation.dart';
 export 'src/extension_navigation.dart';
 export 'src/nav2/get_information_parser.dart';
 export 'src/nav2/get_information_parser.dart';
 export 'src/nav2/get_nav_config.dart';
 export 'src/nav2/get_nav_config.dart';
+export 'src/nav2/get_navigator.dart';
 export 'src/nav2/get_router_delegate.dart';
 export 'src/nav2/get_router_delegate.dart';
 export 'src/nav2/router_outlet.dart';
 export 'src/nav2/router_outlet.dart';
 export 'src/root/get_cupertino_app.dart';
 export 'src/root/get_cupertino_app.dart';

@@ -56,5 +56,5 @@ class GetNavConfig extends RouteInformation {
 
 
   @override
   @override
   String toString() => '''
   String toString() => '''
-======GetNavConfig=====\ncurrentTreeBranch: $currentTreeBranch\ncurrentPage: $currentPage\n======GetNavConfig=====''';
+======GetNavConfig=====\nlocation: $location\ncurrentTreeBranch: $currentTreeBranch\n======GetNavConfig=====''';
 }
 }

+import 'package:flutter/widgets.dart';
+import '../routes/default_route.dart';
+import '../routes/get_route.dart';
+
+class GetNavigator extends Navigator {
+  GetNavigator.onGenerateRoute({
+    GlobalKey<NavigatorState>? key,
+    bool Function(Route<dynamic>, dynamic)? onPopPage,
+    required List<GetPage> pages,
+    List<NavigatorObserver>? observers,
+    bool reportsRouteUpdateToEngine = false,
+    TransitionDelegate? transitionDelegate,
+    String? initialRoute,
+  }) : super(
+          //keys should be optional
+          key: key,
+          initialRoute: initialRoute,
+          onPopPage: onPopPage ??
+              (route, result) {
+                final didPop = route.didPop(result);
+                if (!didPop) {
+                  return false;
+                }
+                return true;
+              },
+          onGenerateRoute: (settings) {
+            final selectedPageList =
+                pages.where((element) => element.name == settings.name);
+            if (selectedPageList.isNotEmpty) {
+              final selectedPage = selectedPageList.first;
+              return GetPageRoute(
+                page: selectedPage.page,
+                settings: settings,
+              );
+            }
+          },
+          reportsRouteUpdateToEngine: reportsRouteUpdateToEngine,
+          pages: pages,
+          observers: [
+            // GetObserver(),
+            ...?observers,
+          ],
+          transitionDelegate:
+              transitionDelegate ?? const DefaultTransitionDelegate<dynamic>(),
+        );
+
+  GetNavigator({
+    GlobalKey<NavigatorState>? key,
+    bool Function(Route<dynamic>, dynamic)? onPopPage,
+    required List<GetPage> pages,
+    List<NavigatorObserver>? observers,
+    bool reportsRouteUpdateToEngine = false,
+    TransitionDelegate? transitionDelegate,
+    String? initialRoute,
+  }) : super(
+          //keys should be optional
+          key: key,
+          initialRoute: initialRoute,
+          onPopPage: onPopPage ??
+              (route, result) {
+                final didPop = route.didPop(result);
+                if (!didPop) {
+                  return false;
+                }
+                return true;
+              },
+          reportsRouteUpdateToEngine: reportsRouteUpdateToEngine,
+          pages: pages,
+          observers: [
+            // GetObserver(),
+            ...?observers,
+          ],
+          transitionDelegate:
+              transitionDelegate ?? const DefaultTransitionDelegate<dynamic>(),
+        );
+}

@@ -2,9 +2,50 @@ import 'dart:async';
 
 
 import 'package:flutter/foundation.dart';
 import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/material.dart';
-
 import '../../../get.dart';
 import '../../../get.dart';
 import '../../../get_state_manager/src/simple/list_notifier.dart';
 import '../../../get_state_manager/src/simple/list_notifier.dart';
+import 'get_navigator.dart';
+
+/// Enables the user to customize the intended pop behavior
+///
+/// Goes to either the previous history entry or the previous page entry
+///
+/// e.g. if the user navigates to these pages
+/// 1) /home
+/// 2) /home/products/1234
+///
+/// when popping on [History] mode, it will emulate a browser back button.
+///
+/// so the new history stack will be:
+/// 1) /home
+///
+/// when popping on [Page] mode, it will only remove the last part of the route
+/// so the new history stack will be:
+/// 1) /home
+/// 2) /home/products
+///
+/// another pop will change the history stack to:
+/// 1) /home
+enum PopMode {
+  History,
+  Page,
+}
+
+/// Enables the user to customize the behavior when pushing multiple routes that
+/// shouldn't be duplicates
+enum PreventDuplicateHandlingMode {
+  /// Removes the history entries until it reaches the old route
+  PopUntilOriginalRoute,
+
+  /// Simply don't push the new route
+  DoNothing,
+
+  /// Recommended - Moves the old route entry to the front
+  ///
+  /// With this mode, you guarantee there will be only one
+  /// route entry for each location
+  ReorderRoutes
+}
 
 
 class GetDelegate extends RouterDelegate<GetNavConfig>
 class GetDelegate extends RouterDelegate<GetNavConfig>
     with ListNotifierSingleMixin {
     with ListNotifierSingleMixin {
@@ -17,7 +58,10 @@ class GetDelegate extends RouterDelegate<GetNavConfig>
   final List<NavigatorObserver>? navigatorObservers;
   final List<NavigatorObserver>? navigatorObservers;
   final TransitionDelegate<dynamic>? transitionDelegate;
   final TransitionDelegate<dynamic>? transitionDelegate;
 
 
-  final _allCompleters = <GetPage, Completer>{};
+  final Iterable<GetPage> Function(GetNavConfig currentNavStack)?
+      pickPagesForRootNavigator;
+
+  GlobalKey<NavigatorState> get navigatorKey => Get.key;
 
 
   GetDelegate({
   GetDelegate({
     GetPage? notFoundRoute,
     GetPage? notFoundRoute,
@@ -26,6 +70,7 @@ class GetDelegate extends RouterDelegate<GetNavConfig>
     this.backButtonPopMode = PopMode.History,
     this.backButtonPopMode = PopMode.History,
     this.preventDuplicateHandlingMode =
     this.preventDuplicateHandlingMode =
         PreventDuplicateHandlingMode.ReorderRoutes,
         PreventDuplicateHandlingMode.ReorderRoutes,
+    this.pickPagesForRootNavigator,
   }) : notFoundRoute = notFoundRoute ??
   }) : notFoundRoute = notFoundRoute ??
             GetPage(
             GetPage(
               name: '/404',
               name: '/404',
@@ -36,157 +81,48 @@ class GetDelegate extends RouterDelegate<GetNavConfig>
     Get.log('GetDelegate is created !');
     Get.log('GetDelegate is created !');
   }
   }
 
 
-  @override
-  GetNavConfig? get currentConfiguration {
-    if (history.isEmpty) return null;
-    final route = history.last;
-    return route;
-  }
-
-  GlobalKey<NavigatorState> get navigatorKey => Get.key;
-
-  Map<String, String> get parameters {
-    return currentConfiguration?.currentPage?.parameters ?? {};
-  }
-
-  T arguments<T>() {
-    return currentConfiguration?.currentPage?.arguments as T;
-  }
-
-  /// Removes routes according to [PopMode]
-  /// until it reaches the specifc [fullRoute],
-  /// DOES NOT remove the [fullRoute]
-  Future<void> backUntil(
-    String fullRoute, {
-    PopMode popMode = PopMode.Page,
-  }) async {
-    // remove history or page entries until you meet route
-    var iterator = currentConfiguration;
-    while (_canPop(popMode) &&
-        iterator != null &&
-        iterator.location != fullRoute) {
-      await _pop(popMode);
-      // replace iterator
-      iterator = currentConfiguration;
-    }
-    refresh();
-  }
-
-  @override
-  Widget build(BuildContext context) {
-    final pages = getVisualPages();
-    if (pages.length == 0) return SizedBox.shrink();
-    final extraObservers = navigatorObservers;
-    return GetNavigator(
-      key: navigatorKey,
-      onPopPage: _onPopVisualRoute,
-      pages: pages,
-      observers: [
-        GetObserver(),
-        if (extraObservers != null) ...extraObservers,
-      ],
-      transitionDelegate:
-          transitionDelegate ?? const DefaultTransitionDelegate<dynamic>(),
-    );
-  }
-
-  // void _unsafeHistoryClear() {
-  //   history.clear();
-  // }
-
-  Future<bool> canPopHistory() {
-    return SynchronousFuture(_canPopHistory());
-  }
-
-  Future<bool> canPopPage() {
-    return SynchronousFuture(_canPopPage());
+  Future<GetNavConfig?> runMiddleware(GetNavConfig config) async {
+    final middlewares = config.currentTreeBranch.last.middlewares;
+    if (middlewares == null) {
+      return config;
     }
     }
-
-  /// gets the visual pages from the current history entry
-  ///
-  /// visual pages must have [participatesInRootNavigator] set to true
-  List<GetPage> getVisualPages() {
-    final currentHistory = currentConfiguration;
-    if (currentHistory == null) return <GetPage>[];
-
-    final res = currentHistory.currentTreeBranch
-        .where((r) => r.participatesInRootNavigator != null);
-    if (res.length == 0) {
-      //default behavoir, all routes participate in root navigator
-      return history.map((e) => e.currentPage!).toList();
-    } else {
-      //user specified at least one participatesInRootNavigator
-      return res
-          .where((element) => element.participatesInRootNavigator == true)
-          .toList();
+    var iterator = config;
+    for (var item in middlewares) {
+      var redirectRes = await item.redirectDelegate(iterator);
+      if (redirectRes == null) return null;
+      iterator = redirectRes;
     }
     }
+    return iterator;
   }
   }
 
 
-  // GetPageRoute getPageRoute(RouteSettings? settings) {
-  //   return PageRedirect(settings ?? RouteSettings(name: '/404'), _notFound())
-  //       .page();
-  // }
-
-  Future<bool> handlePopupRoutes({
-    Object? result,
-  }) async {
-    Route? currentRoute;
-    navigatorKey.currentState!.popUntil((route) {
-      currentRoute = route;
-      return true;
-    });
-    if (currentRoute is PopupRoute) {
-      return await navigatorKey.currentState!.maybePop(result);
-    }
-    return false;
+  Future<void> _unsafeHistoryAdd(GetNavConfig config) async {
+    final res = await runMiddleware(config);
+    if (res == null) return;
+    history.add(res);
   }
   }
 
 
-  Future<T?>? offAndToNamed<T>(
-    String page, {
-    dynamic arguments,
-    int? id,
-    dynamic result,
-    Map<String, String>? parameters,
-    PopMode popMode = PopMode.History,
-  }) async {
-    if (parameters != null) {
-      final uri = Uri(path: page, queryParameters: parameters);
-      page = uri.toString();
+  Future<void> _unsafeHistoryRemove(GetNavConfig config) async {
+    var index = history.indexOf(config);
+    if (index >= 0) await _unsafeHistoryRemoveAt(index);
   }
   }
 
 
-    await popRoute(result: result);
-    return toNamed(page, arguments: arguments, parameters: parameters);
+  Future<GetNavConfig?> _unsafeHistoryRemoveAt(int index) async {
+    if (index == history.length - 1 && history.length > 1) {
+      //removing WILL update the current route
+      final toCheck = history[history.length - 2];
+      final resMiddleware = await runMiddleware(toCheck);
+      if (resMiddleware == null) return null;
+      history[history.length - 2] = resMiddleware;
     }
     }
-
-  Future<T> offNamed<T>(
-    String page, {
-    dynamic arguments,
-    Map<String, String>? parameters,
-  }) async {
-    history.removeLast();
-    return toNamed<T>(page, arguments: arguments, parameters: parameters);
+    return history.removeAt(index);
   }
   }
 
 
-  Future<GetNavConfig?> popHistory() async {
-    return await _popHistory();
+  T arguments<T>() {
+    return currentConfiguration?.currentPage?.arguments as T;
   }
   }
 
 
-  // returns the popped page
-  @override
-  Future<bool> popRoute({
-    Object? result,
-    PopMode popMode = PopMode.Page,
-  }) async {
-    //Returning false will cause the entire app to be popped.
-    final wasPopup = await handlePopupRoutes(result: result);
-    if (wasPopup) return true;
-    final _popped = await _pop(popMode);
-    refresh();
-    if (_popped != null) {
-      //emulate the old pop with result
-      return true;
-    }
-    return false;
+  Map<String, String> get parameters {
+    return currentConfiguration?.currentPage?.parameters ?? {};
   }
   }
 
 
   /// Adds a new history entry and waits for the result
   /// Adds a new history entry and waits for the result
@@ -201,90 +137,59 @@ class GetDelegate extends RouterDelegate<GetNavConfig>
     }
     }
   }
   }
 
 
-  Future<GetNavConfig?> runMiddleware(GetNavConfig config) async {
-    final middlewares = config.currentTreeBranch.last.middlewares;
-    if (middlewares == null) {
-      return config;
-    }
-    var iterator = config;
-    for (var item in middlewares) {
-      var redirectRes = await item.redirectDelegate(iterator);
-      if (redirectRes == null) return null;
-      iterator = redirectRes;
-    }
-    return iterator;
+  Future<void> _removeHistoryEntry(GetNavConfig entry) async {
+    await _unsafeHistoryRemove(entry);
   }
   }
 
 
-  @override
-  Future<void> setNewRoutePath(GetNavConfig configuration) async {
-    await pushHistory(configuration);
+  Future<void> _pushHistory(GetNavConfig config) async {
+    if (config.currentPage!.preventDuplicates) {
+      final originalEntryIndex =
+          history.indexWhere((element) => element.location == config.location);
+      if (originalEntryIndex >= 0) {
+        switch (preventDuplicateHandlingMode) {
+          case PreventDuplicateHandlingMode.PopUntilOriginalRoute:
+            await backUntil(config.location!, popMode: PopMode.Page);
+            break;
+          case PreventDuplicateHandlingMode.ReorderRoutes:
+            await _unsafeHistoryRemoveAt(originalEntryIndex);
+            await _unsafeHistoryAdd(config);
+            break;
+          case PreventDuplicateHandlingMode.DoNothing:
+          default:
+            break;
         }
         }
-
-  Future<T> toNamed<T>(
-    String page, {
-    dynamic arguments,
-    Map<String, String>? parameters,
-  }) async {
-    if (parameters != null) {
-      final uri = Uri(path: page, queryParameters: parameters);
-      page = uri.toString();
+        return;
       }
       }
-
-    final decoder = Get.routeTree.matchRoute(page, arguments: arguments);
-    decoder.replaceArguments(arguments);
-
-    final completer = Completer<T>();
-
-    if (decoder.route != null) {
-      _allCompleters[decoder.route!] = completer;
-      await pushHistory(
-        GetNavConfig(
-          currentTreeBranch: decoder.treeBranch,
-          location: page,
-          state: null, //TODO: persist state?
-        ),
-      );
-
-      return completer.future;
-    } else {
-      ///TODO: IMPLEMENT ROUTE NOT FOUND
-
-      return Future.value();
     }
     }
+    await _unsafeHistoryAdd(config);
   }
   }
 
 
-  bool _canPop(PopMode mode) {
-    switch (mode) {
-      case PopMode.History:
-        return _canPopHistory();
-      case PopMode.Page:
-      default:
-        return _canPopPage();
-    }
+  Future<GetNavConfig?> _popHistory() async {
+    if (!_canPopHistory()) return null;
+    return await _doPopHistory();
   }
   }
 
 
-  bool _canPopHistory() {
-    return history.length > 1;
+  Future<GetNavConfig?> _doPopHistory() async {
+    return await _unsafeHistoryRemoveAt(history.length - 1);
   }
   }
 
 
-  bool _canPopPage() {
-    final currentTreeBranch = currentConfiguration?.currentTreeBranch;
-    if (currentTreeBranch == null) return false;
-    return currentTreeBranch.length > 1 ? true : _canPopHistory();
+  Future<GetNavConfig?> _popPage() async {
+    if (!_canPopPage()) return null;
+    return await _doPopPage();
   }
   }
 
 
-  Future<GetNavConfig?> _doPopHistory() async {
-    return await _unsafeHistoryRemoveAt(history.length - 1);
+  Future<GetNavConfig?> _pop(PopMode mode) async {
+    switch (mode) {
+      case PopMode.History:
+        return await _popHistory();
+      case PopMode.Page:
+        return await _popPage();
+      default:
+        return null;
+    }
   }
   }
 
 
-  // @override
-  // Future<void> setInitialRoutePath(GetNavConfig configuration) async {
-  //   //no need to clear history with Reorder route strategy
-  //   // _unsafeHistoryClear();
-  //   // _resultCompleter.clear();
-  //   await pushHistory(configuration);
-  // }
-
+  // returns the popped page
   Future<GetNavConfig?> _doPopPage() async {
   Future<GetNavConfig?> _doPopPage() async {
     final currentBranch = currentConfiguration?.currentTreeBranch;
     final currentBranch = currentConfiguration?.currentTreeBranch;
     if (currentBranch != null && currentBranch.length > 1) {
     if (currentBranch != null && currentBranch.length > 1) {
@@ -320,167 +225,197 @@ class GetDelegate extends RouterDelegate<GetNavConfig>
     }
     }
   }
   }
 
 
-  bool _onPopVisualRoute(Route<dynamic> route, dynamic result) {
-    final didPop = route.didPop(result);
-    if (!didPop) {
-      return false;
+  Future<GetNavConfig?> popHistory() async {
+    return await _popHistory();
   }
   }
-    final settings = route.settings;
-    if (settings is GetPage) {
-      final config = history.cast<GetNavConfig?>().firstWhere(
-            (element) => element?.currentPage == settings,
-            orElse: () => null,
-          );
-      if (config != null) {
-        _removeHistoryEntry(config);
+
+  bool _canPopHistory() {
+    return history.length > 1;
   }
   }
-      if (_allCompleters.containsKey(settings)) {
-        _allCompleters[settings]?.complete(route.popped);
+
+  Future<bool> canPopHistory() {
+    return SynchronousFuture(_canPopHistory());
   }
   }
+
+  bool _canPopPage() {
+    final currentTreeBranch = currentConfiguration?.currentTreeBranch;
+    if (currentTreeBranch == null) return false;
+    return currentTreeBranch.length > 1 ? true : _canPopHistory();
   }
   }
-    refresh();
 
 
-    return true;
+  Future<bool> canPopPage() {
+    return SynchronousFuture(_canPopPage());
   }
   }
 
 
-  Future<GetNavConfig?> _pop(PopMode mode) async {
+  bool _canPop(PopMode mode) {
     switch (mode) {
     switch (mode) {
       case PopMode.History:
       case PopMode.History:
-        return await _popHistory();
+        return _canPopHistory();
       case PopMode.Page:
       case PopMode.Page:
-        return await _popPage();
       default:
       default:
-        return null;
+        return _canPopPage();
     }
     }
   }
   }
 
 
-  Future<GetNavConfig?> _popHistory() async {
-    if (!_canPopHistory()) return null;
-    return await _doPopHistory();
+  /// gets the visual pages from the current history entry
+  ///
+  /// visual pages must have [GetPage.participatesInRootNavigator] set to true
+  Iterable<GetPage> getVisualPages(GetNavConfig currentHistory) {
+    final res = currentHistory.currentTreeBranch
+        .where((r) => r.participatesInRootNavigator != null);
+    if (res.length == 0) {
+      //default behavoir, all routes participate in root navigator
+      return history.map((e) => e.currentPage!);
+    } else {
+      //user specified at least one participatesInRootNavigator
+      return res
+          .where((element) => element.participatesInRootNavigator == true);
+    }
   }
   }
 
 
-  Future<GetNavConfig?> _popPage() async {
-    if (!_canPopPage()) return null;
-    return await _doPopPage();
+  @override
+  Widget build(BuildContext context) {
+    final currentHistory = currentConfiguration;
+    final pages = currentHistory == null
+        ? <GetPage>[]
+        : pickPagesForRootNavigator?.call(currentHistory) ??
+            getVisualPages(currentHistory);
+    if (pages.length == 0) return SizedBox.shrink();
+    return GetNavigator(
+      key: navigatorKey,
+      onPopPage: _onPopVisualRoute,
+      pages: pages.toList(),
+      observers: [
+        GetObserver(),
+        ...?navigatorObservers,
+      ],
+      transitionDelegate:
+          transitionDelegate ?? const DefaultTransitionDelegate<dynamic>(),
+    );
   }
   }
 
 
-  Future<void> _pushHistory(GetNavConfig config) async {
-    if (config.currentPage!.preventDuplicates) {
-      final originalEntryIndex =
-          history.indexWhere((element) => element.location == config.location);
-      if (originalEntryIndex >= 0) {
-        switch (preventDuplicateHandlingMode) {
-          case PreventDuplicateHandlingMode.PopUntilOriginalRoute:
-            await backUntil(config.location!, popMode: PopMode.Page);
-            break;
-          case PreventDuplicateHandlingMode.ReorderRoutes:
-            await _unsafeHistoryRemoveAt(originalEntryIndex);
-            await _unsafeHistoryAdd(config);
-            break;
-          case PreventDuplicateHandlingMode.DoNothing:
-          default:
-            break;
+  @override
+  Future<void> setNewRoutePath(GetNavConfig configuration) async {
+    await pushHistory(configuration);
   }
   }
-        return;
+
+  @override
+  GetNavConfig? get currentConfiguration {
+    if (history.isEmpty) return null;
+    final route = history.last;
+    return route;
   }
   }
+
+  Future<void> toNamed(
+    String page, {
+    dynamic arguments,
+    Map<String, String>? parameters,
+  }) async {
+    if (parameters != null) {
+      final uri = Uri(path: page, queryParameters: parameters);
+      page = uri.toString();
+    }
+
+    final decoder = Get.routeTree.matchRoute(page, arguments: arguments);
+    decoder.replaceArguments(arguments);
+
+    if (decoder.route != null) {
+      await pushHistory(
+        GetNavConfig(
+          currentTreeBranch: decoder.treeBranch,
+          location: page,
+          state: null, //TODO: persist state?
+        ),
+      );
+    } else {
+      await pushHistory(
+        GetNavConfig(
+          currentTreeBranch: [notFoundRoute],
+          location: notFoundRoute.name,
+          state: null, //TODO: persist state?
+        ),
+      );
     }
     }
-    await _unsafeHistoryAdd(config);
   }
   }
 
 
-  Future<void> _removeHistoryEntry(GetNavConfig entry) async {
-    await _unsafeHistoryRemove(entry);
+  //pops the previous route (if there is one) and goes to new route
+  Future<void> offNamed(
+    String page, {
+    dynamic arguments,
+    Map<String, String>? parameters,
+    PopMode popMode = PopMode.History,
+  }) async {
+    await popRoute(popMode: popMode);
+    return toNamed(page, arguments: arguments, parameters: parameters);
   }
   }
 
 
-  Future<void> _unsafeHistoryAdd(GetNavConfig config) async {
-    final res = await runMiddleware(config);
-    if (res == null) return;
-    history.add(res);
+  /// Removes routes according to [PopMode]
+  /// until it reaches the specifc [fullRoute],
+  /// DOES NOT remove the [fullRoute]
+  Future<void> backUntil(
+    String fullRoute, {
+    PopMode popMode = PopMode.History,
+  }) async {
+    // remove history or page entries until you meet route
+    var iterator = currentConfiguration;
+    while (_canPop(popMode) &&
+        iterator != null &&
+        iterator.location != fullRoute) {
+      await _pop(popMode);
+      // replace iterator
+      iterator = currentConfiguration;
+    }
+    refresh();
   }
   }
 
 
-  Future<void> _unsafeHistoryRemove(GetNavConfig config) async {
-    var index = history.indexOf(config);
-    if (index >= 0) await _unsafeHistoryRemoveAt(index);
+  Future<bool> handlePopupRoutes({
+    Object? result,
+  }) async {
+    Route? currentRoute;
+    navigatorKey.currentState!.popUntil((route) {
+      currentRoute = route;
+      return true;
+    });
+    if (currentRoute is PopupRoute) {
+      return await navigatorKey.currentState!.maybePop(result);
+    }
+    return false;
   }
   }
 
 
-  Future<GetNavConfig?> _unsafeHistoryRemoveAt(int index) async {
-    if (index == history.length - 1 && history.length > 1) {
-      //removing WILL update the current route
-      final toCheck = history[history.length - 2];
-      final resMiddleware = await runMiddleware(toCheck);
-      if (resMiddleware == null) return null;
-      history[history.length - 2] = resMiddleware;
+  @override
+  Future<bool> popRoute({
+    Object? result,
+    PopMode? popMode,
+  }) async {
+    //Returning false will cause the entire app to be popped.
+    final wasPopup = await handlePopupRoutes(result: result);
+    if (wasPopup) return true;
+    final _popped = await _pop(popMode ?? backButtonPopMode);
+    refresh();
+    if (_popped != null) {
+      //emulate the old pop with result
+      return true;
     }
     }
-    return history.removeAt(index);
+    return false;
   }
   }
-}
 
 
-class GetNavigator extends Navigator {
-  GetNavigator({
-    GlobalKey<NavigatorState>? key,
-    bool Function(Route<dynamic>, dynamic)? onPopPage,
-    required List<Page> pages,
-    List<NavigatorObserver>? observers,
-    bool reportsRouteUpdateToEngine = false,
-    TransitionDelegate? transitionDelegate,
-  }) : super(
-          //keys should be optional
-          key: key,
-          onPopPage: onPopPage ??
-              (route, result) {
+  bool _onPopVisualRoute(Route<dynamic> route, dynamic result) {
     final didPop = route.didPop(result);
     final didPop = route.didPop(result);
     if (!didPop) {
     if (!didPop) {
       return false;
       return false;
     }
     }
-                return true;
-              },
-          reportsRouteUpdateToEngine: reportsRouteUpdateToEngine,
-          pages: pages,
-          observers: [
-            // GetObserver(),
-            if (observers != null) ...observers,
-          ],
-          transitionDelegate:
-              transitionDelegate ?? const DefaultTransitionDelegate<dynamic>(),
+    final settings = route.settings;
+    if (settings is GetPage) {
+      final config = history.cast<GetNavConfig?>().firstWhere(
+            (element) => element?.currentPage == settings,
+            orElse: () => null,
           );
           );
-}
-
-/// Enables the user to customize the intended pop behavior
-///
-/// Goes to either the previous history entry or the previous page entry
-///
-/// e.g. if the user navigates to these pages
-/// 1) /home
-/// 2) /home/products/1234
-///
-/// when popping on [History] mode, it will emulate a browser back button.
-///
-/// so the new history stack will be:
-/// 1) /home
-///
-/// when popping on [Page] mode, it will only remove the last part of the route
-/// so the new history stack will be:
-/// 1) /home
-/// 2) /home/products
-///
-/// another pop will change the history stack to:
-/// 1) /home
-enum PopMode {
-  History,
-  Page,
-}
-
-/// Enables the user to customize the behavior when pushing multiple routes that
-/// shouldn't be duplicates
-enum PreventDuplicateHandlingMode {
-  /// Removes the history entries until it reaches the old route
-  PopUntilOriginalRoute,
-
-  /// Simply don't push the new route
-  DoNothing,
+      if (config != null) {
+        _removeHistoryEntry(config);
+      }
+    }
+    refresh();
 
 
-  /// Recommended - Moves the old route entry to the front
-  ///
-  /// With this mode, you guarantee there will be only one
-  /// route entry for each location
-  ReorderRoutes
+    return true;
+  }
 }
 }

 import 'package:flutter/widgets.dart';
 import 'package:flutter/widgets.dart';
 
 
+import 'default_route.dart';
+
 enum Transition {
 enum Transition {
   fade,
   fade,
   fadeIn,
   fadeIn,
@@ -20,3 +22,4 @@ enum Transition {
 }
 }
 
 
 typedef GetPageBuilder = Widget Function();
 typedef GetPageBuilder = Widget Function();
+typedef GetRouteAwarePageBuilder<T> = Widget Function([GetPageRoute<T>? route]);

@@ -569,7 +569,4 @@ class BindError<T> extends Error {
 /// instance of Bindings to manage the
 /// instance of Bindings to manage the
 /// dependencies() (via Get.put()) for the Route you are opening.
 /// dependencies() (via Get.put()) for the Route you are opening.
 // ignore: one_member_abstracts
 // ignore: one_member_abstracts
-abstract class Binding extends BindingsInterface<List<Bind>> {
-  @override
-  List<Bind> dependencies();
-}
+abstract class Binding extends BindingsInterface<Iterable<Bind>> {}

@@ -24,36 +24,32 @@ typedef ValueBuilderBuilder<T> = Widget Function(
 ///  ),
 ///  ),
 ///  ```
 ///  ```
 class ValueBuilder<T> extends StatefulWidget {
 class ValueBuilder<T> extends StatefulWidget {
-  final T? initialValue;
+  final T initialValue;
   final ValueBuilderBuilder<T> builder;
   final ValueBuilderBuilder<T> builder;
   final void Function()? onDispose;
   final void Function()? onDispose;
   final void Function(T)? onUpdate;
   final void Function(T)? onUpdate;
 
 
   const ValueBuilder({
   const ValueBuilder({
     Key? key,
     Key? key,
-    this.initialValue,
+    required this.initialValue,
     this.onDispose,
     this.onDispose,
     this.onUpdate,
     this.onUpdate,
     required this.builder,
     required this.builder,
   }) : super(key: key);
   }) : super(key: key);
 
 
   @override
   @override
-  _ValueBuilderState<T> createState() => _ValueBuilderState<T>();
+  _ValueBuilderState<T> createState() => _ValueBuilderState<T>(initialValue);
 }
 }
 
 
-class _ValueBuilderState<T> extends State<ValueBuilder<T?>> {
-  T? value;
+class _ValueBuilderState<T> extends State<ValueBuilder<T>> {
+  T value;
+  _ValueBuilderState(this.value);
 
 
-  @override
-  void initState() {
-    super.initState();
-    value = widget.initialValue;
-  }
 
 
   @override
   @override
   Widget build(BuildContext context) => widget.builder(value, updater);
   Widget build(BuildContext context) => widget.builder(value, updater);
 
 
-  void updater(T? newValue) {
+  void updater(T newValue) {
     if (widget.onUpdate != null) {
     if (widget.onUpdate != null) {
       widget.onUpdate!(newValue);
       widget.onUpdate!(newValue);
     }
     }
@@ -71,7 +67,6 @@ class _ValueBuilderState<T> extends State<ValueBuilder<T?>> {
     } else if (value is StreamController) {
     } else if (value is StreamController) {
       (value as StreamController?)?.close();
       (value as StreamController?)?.close();
     }
     }
-    value = null;
   }
   }
 }
 }
 
 

+import 'package:collection/collection.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/material.dart';
 
 
-import '../platform/platform.dart';
-
 extension ContextExtensionss on BuildContext {
 extension ContextExtensionss on BuildContext {
   /// The same of [MediaQuery.of(context).size]
   /// The same of [MediaQuery.of(context).size]
   Size get mediaQuerySize => MediaQuery.of(this).size;
   Size get mediaQuerySize => MediaQuery.of(this).size;
@@ -100,17 +99,44 @@ extension ContextExtensionss on BuildContext {
   /// True if width be larger than 800
   /// True if width be larger than 800
   bool get showNavbar => (width > 800);
   bool get showNavbar => (width > 800);
 
 
-  /// True if the shortestSide is smaller than 600p
-  bool get isPhone => (mediaQueryShortestSide < 600);
+  /// True if the width is smaller than 600p
+  bool get isPhoneOrLess => width <= 600;
+
+  /// True if the width is higher than 600p
+  bool get isPhoneOrWider => width >= 600;
+
+  /// same as [isPhoneOrLess]
+  bool get isPhone => isPhoneOrLess;
+
+  /// True if the width is smaller than 600p
+  bool get isSmallTabletOrLess => width <= 600;
+
+  /// True if the width is higher than 600p
+  bool get isSmallTabletOrWider => width >= 600;
+
+  /// same as [isSmallTabletOrLess]
+  bool get isSmallTablet => isSmallTabletOrLess;
+
+  /// True if the width is smaller than 720p
+  bool get isLargeTabletOrLess => width <= 720;
 
 
-  /// True if the shortestSide is largest than 600p
-  bool get isSmallTablet => (mediaQueryShortestSide >= 600);
+  /// True if the width is higher than 720p
+  bool get isLargeTabletOrWider => width >= 720;
 
 
-  /// True if the shortestSide is largest than 720p
-  bool get isLargeTablet => (mediaQueryShortestSide >= 720);
+  /// same as [isLargeTabletOrLess]
+  bool get isLargeTablet => isLargeTabletOrLess;
 
 
   /// True if the current device is Tablet
   /// True if the current device is Tablet
-  bool get isTablet => isSmallTablet || isLargeTablet;
+  bool get isTablet => isSmallTablet;
+
+  /// True if the width is smaller than 1200p
+  bool get isDesktopOrLess => width <= 1200;
+
+  /// True if the width is higher than 1200p
+  bool get isDesktopOrWider => width >= 1200;
+
+  /// same as [isDesktopOrLess]
+  bool get isDesktop => isDesktopOrLess;
 
 
   /// Returns a specific value according to the screen size
   /// Returns a specific value according to the screen size
   /// if the device width is higher than or equal to 1200 return
   /// if the device width is higher than or equal to 1200 return
@@ -119,23 +145,28 @@ extension ContextExtensionss on BuildContext {
   /// if the device width is less than 300  return [watch] value.
   /// if the device width is less than 300  return [watch] value.
   /// in other cases return [mobile] value.
   /// in other cases return [mobile] value.
   T responsiveValue<T>({
   T responsiveValue<T>({
+    T? watch,
     T? mobile,
     T? mobile,
     T? tablet,
     T? tablet,
     T? desktop,
     T? desktop,
-    T? watch,
   }) {
   }) {
-    var deviceWidth = mediaQuerySize.shortestSide;
-    if (GetPlatform.isDesktop) {
-      deviceWidth = mediaQuerySize.width;
-    }
-    if (deviceWidth >= 1200 && desktop != null) {
-      return desktop;
-    } else if (deviceWidth >= 600 && tablet != null) {
-      return tablet;
-    } else if (deviceWidth < 300 && watch != null) {
-      return watch;
-    } else {
-      return mobile!;
-    }
+    assert(
+        watch != null || mobile != null || tablet != null || desktop != null);
+
+    var deviceWidth = mediaQuerySize.width;
+    //big screen width can display smaller sizes
+    final strictValues = [
+      if (deviceWidth >= 1200) desktop, //desktop is allowed
+      if (deviceWidth >= 600) tablet, //tablet is allowed
+      if (deviceWidth >= 300) mobile, //mobile is allowed
+      watch, //watch is allowed
+    ].whereType<T>();
+    final looseValues = [
+      watch,
+      mobile,
+      tablet,
+      desktop,
+    ].whereType<T>();
+    return strictValues.firstOrNull ?? looseValues.first;
   }
   }
 }
 }

@@ -34,16 +34,19 @@ void main() {
     expect(isLandscape, context.isLandscape);
     expect(isLandscape, context.isLandscape);
     var mediaQueryShortestSide = mediaQuerySize.shortestSide;
     var mediaQueryShortestSide = mediaQuerySize.shortestSide;
     expect(mediaQueryShortestSide, context.mediaQueryShortestSide);
     expect(mediaQueryShortestSide, context.mediaQueryShortestSide);
-    var isLargeTablet = (mediaQueryShortestSide >= 720);
-    expect(isLargeTablet, context.isLargeTablet);
-    var isPhone = (mediaQueryShortestSide < 600);
-    expect(isPhone, context.isPhone);
+    var width = mediaQuerySize.width;
+    expect(width, context.width);
+
+    var isLargeTabletOrWider = (width >= 720);
+    expect(isLargeTabletOrWider, context.isLargeTabletOrWider);
+    var isPhoneOrLess = (width < 600);
+    expect(isPhoneOrLess, context.isPhoneOrLess);
     var isPortrait = orientation == Orientation.portrait;
     var isPortrait = orientation == Orientation.portrait;
     expect(isPortrait, context.isPortrait);
     expect(isPortrait, context.isPortrait);
-    var isSmallTablet = (mediaQueryShortestSide >= 600);
-    expect(isSmallTablet, context.isSmallTablet);
-    var isTablet = isSmallTablet || isLargeTablet;
-    expect(isTablet, context.isTablet);
+    var isSmallTabletOrWider = (width >= 600);
+    expect(isSmallTabletOrWider, context.isSmallTabletOrWider);
+    var isTablet = isSmallTabletOrWider || isLargeTabletOrWider;
+    expect(isTablet, context.isSmallTabletOrWider);
     var mediaQueryPadding = mediaQuery.padding;
     var mediaQueryPadding = mediaQuery.padding;
     expect(mediaQueryPadding, context.mediaQueryPadding);
     expect(mediaQueryPadding, context.mediaQueryPadding);
     var mediaQueryViewInsets = mediaQuery.viewInsets;
     var mediaQueryViewInsets = mediaQuery.viewInsets;
@@ -55,8 +58,7 @@ void main() {
     expect(widthTransformer, context.widthTransformer());
     expect(widthTransformer, context.widthTransformer());
     var ratio = heightTransformer / widthTransformer;
     var ratio = heightTransformer / widthTransformer;
     expect(ratio, context.ratio());
     expect(ratio, context.ratio());
-    var width = mediaQuerySize.width;
-    expect(width, context.width);
+
     var showNavbar = (width > 800);
     var showNavbar = (width > 800);
     expect(showNavbar, context.showNavbar);
     expect(showNavbar, context.showNavbar);
     var textScaleFactor = mediaQuery.textScaleFactor;
     var textScaleFactor = mediaQuery.textScaleFactor;