Added #

• Introduced PageAware widget for route-aware lifecycle hooks (see lib/nav_service/page_aware.dart).
• Example updated: example/scenes/home.dart now demonstrates PageAware usage.
• Tests updated to cover PageAware lifecycle behaviors (test/nav_service_test.dart).

Changed #

• Documentation: README updated and installation snippets bumped to ^0.4.0.

Fixed #

• Minor code cleanups and test updates.

Added #

• Added topics to pubspec.yaml: nav-service, navigation, navigator, router, deep-linking

Changed #

• Bumped package version to 0.3.3

Added #

• Expanded README with LaunchScreen initial logic example and app_links deep-linking setup

Changed #

• Updated installation snippet to reference ^0.3.2

Added #

• Bump package version to 0.3.1
• Minor documentation clarifications and README examples

Added #

• Deep Linking System: Complete deep linking infrastructure for handling custom URLs and app links
• NavLinkHandler: Abstract class for creating custom link handlers with redirect path patterns
• NavLinkResult: Data class containing matched route path, path parameters, and query parameters from URL parsing
• LinkingServiceExt: Extension methods for URL processing and link handling with openUrl() method
• Link Prefixes: Support for multiple URL prefixes (scheme-based like myapp:// or domain-based like https://example.com)
• Path Parameter Extraction: Automatic extraction of path parameters using :paramName syntax in redirect paths
• Query Parameter Support: Full query parameter parsing and passing to link handlers
• Duplicate Path Detection: Built-in validation to prevent duplicate redirect paths across handlers
• URL Pattern Matching: Advanced pattern matching for complex URL structures with parameters

Enhanced #

• NavServiceConfig: Extended with linkPrefixes and linkHandlers properties for deep linking configuration
• Export Structure: Added exports for NavLinkHandler and NavLinkResult classes in main library

Fixed #

• Enhanced Navigation Methods: Improved reliability and error handling in core navigation functions
  • Fixed replace() method with better edge case handling when no navigation steps exist
  • Enhanced pushReplacementAll() method with improved animation control and route management
  • Improved replaceAll() method with enhanced null validation and proper route removal
  • Fixed removeAll() method with GoRouter integration warnings and improved state management
• Animation Improvements: Added _NoTransitionMaterialPageRoute class for smoother route transitions in replace operations when the steps empty
• Data Processing: Enhanced NavExtra constructor with optional processData parameter for better data handling flexibility
• Navigation State Consistency: Fixed navigation state consistency across all replace operations

Documentation #

• Comprehensive deep linking examples in example application
• Link handler implementations for profile and settings navigation
• Integration guides for GoRouter and app_links packages

Notes #

• Deep linking system is fully backward compatible with existing navigation methods
• Supports both custom URL schemes (myapp://) and universal links (https://domain.com)
• Link handlers provide flexible routing logic for complex navigation scenarios

Added #

• Error boundaries: wrapped navigation entry points with try/catch to surface and log unexpected exceptions

Fixed #

• Fixed generic type handling for page routes and route builders (preserve T result types)
• Fixed NavState.fromRoute null-safety when reading RouteSettings.arguments
• Fixed NavStep constructor ordering and prevState handling

Changed #

• Switched several imports from package:flutter/material.dart to package:flutter/widgets.dart to reduce dependency surface
• Improved and unified debug logging messages across navigation methods
• Reordered singleton initialization and tightened route map construction for consistency

Enhanced #

• Improved NavExtra data processing with automatic JSON serialization for better data consistency
• Enhanced data integrity when passing complex objects between routes
• Added automatic deep cloning of data to prevent reference issues

Added #

• Initial stable release of advanced_nav_service package
• NavService singleton class for advanced navigation management
• Route configuration with NavServiceConfig and NavRoute definitions
• Smart navigation with navigate() method that intelligently handles existing routes
• Navigation history tracking with NavStep and full stack inspection
• Extra data support with NavExtra for type-safe data passing between routes
• Navigation state management with NavState for route-aware widgets
• Comprehensive navigation methods:
  • push() and pop() with animation support
  • pushReplacement() and replace() for route replacement
  • pushAndRemoveUntil() for conditional stack management
  • popUntil() and popUntilPath() for targeted navigation
  • popAll() and removeAll() for complete stack clearing
• Bulk navigation operations:
  • pushAll() for multiple route pushing
  • replaceAll() for complete stack replacement
  • pushReplacementAll() for advanced stack manipulation
• Built-in route observer with automatic navigation event tracking
• Navigation debugging with joinedLocation and history inspection
• Configurable logging for development and debugging
• Custom page route with optimized animations
• Complete example application demonstrating all features
• Comprehensive test coverage for all navigation scenarios
• Full API documentation and usage examples