Update documentation and samples for .NET 10 and SmartNavigation rename

[Copilot]

Updates documentation to reflect the library rename from PageResolver to SmartNavigation (v3.0) and documents new .NET 10 features from PR #52.

README Updates

• Rename notice: Added prominent callout about PageResolver → SmartNavigation transition
• Quick start examples: Basic navigation, parameters, modals, Shell routing, and smart back navigation
• INavigationManager API: Full interface documentation with DI injection examples
• ViewModel lifecycle: NavigatedInitBehavior and IViewModelLifecycle with XAML integration
• Source generator: Now opt-in via [GenerateAutoDependencies] attribute
• Migration guide: Breaking changes, checklist, and feature adoption path from 2.x

Demo Project

New NavigationManagerDemoPage showcasing:

• INavigationManager service injection and usage patterns
• IViewModelLifecycle async initialization (first navigation vs. subsequent)
• NavigatedInitBehavior XAML declaration

public class MyViewModel : IViewModelLifecycle
{
    private readonly INavigationManager _nav;
    
    public MyViewModel(INavigationManager nav) => _nav = nav;
    
    public async Task OnInitAsync(bool isFirstNavigation)
    {
        if (isFirstNavigation)
            await LoadDataAsync();
    }
}

<ContentPage xmlns:behaviors="clr-namespace:Plugin.Maui.SmartNavigation.Behaviours;assembly=Plugin.Maui.SmartNavigation">
    <ContentPage.Behaviors>
        <behaviors:NavigatedInitBehavior />
    </ContentPage.Behaviors>
</ContentPage>

Package Description

Updated NuGet description to highlight INavigationManager, lifecycle behaviors, type-safe routing, and mention the rename from PageResolver.

Original prompt

---

This section details on the original issue you should resolve

<issue_title>10-19: Update Documentation and Samples</issue_title>
<issue_description>Update all documentation to reflect .NET 10 changes and new APIs.

Acceptance Criteria:

• Update README with new API examples
• Add migration guide
• Add Shell vs non-Shell navigation guide
• Add behaviors overview and usage guide
• Add quick start examples for common scenarios
• Update demo project to showcase all features
• Create migration checklist from PageResolver 2.x</issue_description>

<agent_instructions>It may be beneficial to look at pull request #52 to see the full scope of the changes. Would be good to mention in the readme about PageResolver is now SmartNavigation. Some of what is in this issue is already there and just needs updating. Note also that detailed guides are not required as there is a wiki in the repo that I will update separately. </agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes 10-19: Update Documentation and Samples Plugin.Maui.SmartNavigation#1

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[matt-goldman]

Excellent