Changed #

• Enhanced Code Documentation: Improved documentation accuracy and clarity across the codebase
• Fixed Documentation: Corrected inaccurate descriptions about navigation history management

Added #

• Navigator 2.0 Support: Full declarative navigation support with MaterialApp.router
  • Added DashRouterWidget for simplified router setup
  • Added DashRouterScope for accessing router from widget tree
  • Added routerConfig extension for convenient MaterialApp.router integration
  • Enhanced _DashRouterDelegate with proper URL synchronization
  • Enhanced _DashRouteInformationParser with query parameter support
  • Added _NavigatorObserverAdapter for tracking route changes
• Deep Linking: Complete URL handling for web and mobile platforms
  • Browser history integration on web
  • System back button handling via PopNavigatorRouterDelegateMixin
  • BackButtonDispatcher support for Android hardware back button
• New exports in dash_router.dart:
  • src/navigation/router_widget.dart

Changed #

• Improved documentation with Navigator 1.0 and 2.0 usage examples
• Updated README with deep linking and shell routes documentation
• Removed deprecated onPopPage callback in favor of modern Navigator API

Documentation #

• Added comprehensive Navigator 2.0 setup guide
• Added shell routes usage examples
• Updated installation version to ^1.1.0

Fixed #

• Fixed documentation errors with incorrect API references
• Corrected parameter access examples in README (use route.body.arguments instead of direct cast)
• Updated route guard and middleware documentation to reflect instance-based usage
• Removed references to non-existent @PathParam, @QueryParam, @BodyParam annotations
• Fixed DashRouteScope.of() to throw StateError instead of using assert for better error handling

Changed #

• Extracted shared matchGlobPattern utility to RouteUtils class for code deduplication
• Improved dispose method to properly clean up internal state
• Unified route annotation API - all route types (shell, redirect, dialog, initial) now use @DashRoute with appropriate properties

Documentation #

• Added comprehensive examples for shell routes with shell: true
• Added examples for fullscreen dialog routes with fullscreenDialog: true
• Added examples for redirect routes with redirectTo
• Updated example project with EditProfilePage demonstrating fullscreen dialog
• Improved README with all unified DashRoute usage patterns

Added #

• Initial stable release of dash_router
• Core DashRouter class for route management and navigation
• RouteEntry class for defining route configurations
• RedirectEntry class for route redirects
• DashRouterOptions for router configuration
• Type-safe parameter access via RouteData and TypedParamsResolver
• RouteInfoCache for O(1) parameter access using InheritedWidget
• DashTypedRoute base class for generated typed routes with $-prefixed API:
  • $pattern - Route pattern with parameter placeholders
  • $name - Route name for named navigation
  • $path - Concrete path with interpolated values
  • $query - Query parameters map
  • $body - Body arguments (supports Record types)
  • $transition - Optional custom transition per-navigation
• Navigation extensions on BuildContext:
  • Typed Route Navigation (recommended):
    • push(DashTypedRoute) - Push typed route
    • replace(DashTypedRoute) - Replace with typed route
    • popAndPush(DashTypedRoute) - Pop and push typed route
    • pushAndRemoveUntil(DashTypedRoute, predicate) - Push and remove
    • pushAndRemoveAll(DashTypedRoute) - Clear stack and push
  • String Path Navigation:
    • pushNamed(path, {query, body, transition}) - Push by path
    • replaceNamed(path, ...) - Replace by path
    • popAndPushNamed(path, ...) - Pop and push by path
    • pushNamedAndRemoveUntil(path, predicate, ...) - Push and remove
    • pushNamedAndRemoveAll(path, ...) - Clear stack and push
  • Pop Operations:
    • pop([result]) - Pop current route
    • popUntil(predicate) - Pop until predicate
    • popUntilNamed(path) - Pop until reaching path
    • popToRoot() - Pop to root route
    • maybePop([result]) - Respects route guards
    • back([result]) - Alias for pop
  • Navigation State:
    • canGoBack - Check if can go back
    • previousPath - Get previous route path
• Built-in transitions:
  • DashFadeTransition - Fade animation
  • DashSlideTransition - Slide from any direction
  • DashScaleTransition - Scale animation
  • DashRotationTransition - Rotation animation
  • DashScaleFadeTransition - Combined scale and fade
  • DashSlideFadeTransition - Combined slide and fade
  • PlatformTransition - Platform-adaptive transition
  • MaterialTransition - Material Design transition
  • CupertinoTransition - iOS-style transition
  • NoTransition - Instant transition without animation
• CustomAnimatedTransition for runtime custom transitions
• Route guards system with DashGuard base class:
  • canActivate() - Check if navigation is allowed
  • onActivated() - Called after successful navigation
  • onDenied() - Called when navigation is denied
  • routes and excludeRoutes for glob pattern filtering
  • priority for execution order control
• Guard results: GuardAllow, GuardDeny, GuardRedirect
• Utility guards: FunctionalGuard, ConditionalGuard, AsyncConditionalGuard
• Middleware system with DashMiddleware base class:
  • handle() - Process navigation request
  • afterNavigation() - Called after successful navigation
  • onAborted() - Called when navigation is aborted
• Middleware results: MiddlewareContinue, MiddlewareAbort, MiddlewareRedirect
• Utility middleware: FunctionalMiddleware, LoggingMiddleware, DelayMiddleware
• Navigation history tracking with NavigationHistory
• Shell routes support for nested navigation with isolated animations
• Nested navigator support via NestedNavigator and StatefulShellScope
• Automatic nested navigation detection in navigation methods
• Full cross-platform support (iOS, Android, Web, macOS, Windows, Linux)

API Design #

• Typed Routes: Use $-prefixed properties to avoid conflicts with user parameters
• Naming Convention: Path-based class names (e.g., /app/user/:id → AppUser$IdRoute)
• Navigation Separation: Clear distinction between typed route and string path navigation
• Body Parameters: Support for complex types via Record tuples or Map