Added #

• New Nav API Structure: Complete API redesign with centralized Nav class
  • Nav.page - Access to PageService for route navigation
  • Nav.link - Access to LinkService for deep link handling
  • Nav.observers - Built-in navigation observers
• PageService: Comprehensive navigation service with methods like push(), pop(), navigate(), replace(), etc.
• LinkService: Dedicated service for deep link handling with openUrl() method
• PageAware Widget: New widget that responds to navigation events that can be used to provide context-aware navigation updates and lifecycle listening
• NavConfig: New configuration class (replaces NavServiceConfig)
• Deep Link Context: Supported widget context in deep link handler onRedirect

Changed #

• BREAKING: Migrated from NavService.instance pattern to Nav.page/Nav.link static access
• BREAKING: NavServiceConfig renamed to NavConfig
• BREAKING: NavAware widget renamed to PageAware
• License: Changed from MIT to BSD-3-Clause License
• Import Path: Now use import 'package:flutter_nav/flutter_nav.dart';
• Navigation Observers: Use Nav.observers instead of individual service observers

Enhanced #

• Documentation: Comprehensive README updates with new API examples
• Test Suite: Complete test rewrite and validation (19/19 tests passing)

Fixed #

• Test Structure: Fixed all test compilation and runtime issues with new API

Migration Guide #

• Replace NavService.instance.push() with Nav.page.push()
• Replace NavService.instance.openUrl() with Nav.link.openUrl()
• Replace NavServiceConfig with NavConfig
• Replace NavService.instance.init with Nav.init
• Update imports to package:flutter_nav/flutter_nav.dart
• Use Nav.observers in MaterialApp navigatorObservers

Fixed #

• Lint: Added explicit type annotations for Nav.observers and Nav.init to satisfy analyzer/lints.

Misc #

• Bumped package version to 0.4.1.

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