Add attribute-based routing support and docs

Introduces attribute-based routing with 8 new route attributes, automatic route discovery, and extension methods for mixing declarative and programmatic routes. Adds comprehensive documentation (ATTRIBUTE_ROUTING.md), updates sample apps to demonstrate attribute routing and transitions, enhances error handling, expands built-in transitions to 14 types, and improves layout and guard systems. Documentation and sample projects are updated to reflect new features and usage.

Author: Taiizor

ATTRIBUTE_ROUTING.md

@@ -7,6 +7,77 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.0.10] - 2025-11-19
+
+### Added
+- **Enhanced Route Transitions**: Expanded from 4 to 14 built-in transition types
+  - Added: `None`, `Pop`, `Blur`, `Reveal`, `Rotate`, `Curtain`, `SlideFade`, `Spotlight`, `Swipe`, `Lift`
+  - All transitions are GPU-accelerated for smooth performance
+  - Respects `prefers-reduced-motion` accessibility preference
+  - Comprehensive XML documentation for each transition type with use cases and best practices
+- **Attribute-Based Routing System**: Complete declarative routing configuration
+  - 8 attribute types: `[Route]`, `[RouteGuard]`, `[RouteTransition]`, `[RouteLayout]`, `[RouteTitle]`, `[RouteData]`, `[RouteRedirect]`, `[RouteExact]`
+  - `RouteAttributeDiscoveryService` for automatic route discovery via assembly scanning
+  - `AddAttributeRoutes()` extension method for mixing programmatic and attribute-based routes
+  - `FromAttributes()` static method for pure attribute-based configuration
+  - Full support for nested routes and complex configurations via attributes
+  - Detailed documentation in ATTRIBUTE_ROUTING.md
+- **Comprehensive Error Handling System**
+  - `IRouterErrorHandler` interface for custom error handling implementations
+  - `DefaultRouterErrorHandler` with built-in console logging
+  - `RouterErrorContext` providing detailed error information and context
+  - `RouterErrorType` enum with error categories: `ComponentLoadFailed`, `GuardRejected`, `NavigationFailed`, `InvalidRoute`
+  - `ErrorContent` RenderFragment parameter in Router component for custom error UI
+  - Retry mechanism support for failed operations
+  - Error event notifications throughout routing lifecycle
+  - `AddBlazouterErrorHandler<T>()` extension method for registering custom error handlers
+- **Enhanced Layout System**
+  - `DefaultLayout` parameter on Router component for application-wide layouts
+  - Per-route layout override via `RouteConfig.Layout` property
+  - Support for no-layout routes by explicitly setting `Layout = null`
+  - Layout priority system: Route.Layout > Router.DefaultLayout > No Layout
+  - `HasExplicitLayout` internal flag for proper layout resolution
+  - Seamless layout switching during navigation with state preservation
+- **Additional Components and Services**
+  - `BlankLayout` component for routes requiring no layout structure
+  - Enhanced `RouteMatcherService` with improved pattern matching
+  - `RouterStateService` with parameter change notifications
+  - Loading state support with `<Loading>` RenderFragment parameter in Router
+  - Component caching for lazy-loaded routes after first load
+
+### Changed
+- **Documentation Overhaul**
+  - README.md: Updated to reflect all 14 transitions, added error handling section, enhanced project structure
+  - FEATURES.md: Expanded from 8 to 10 features with detailed implementation descriptions
+  - All sample applications updated to showcase 14 transitions instead of 4
+  - Added comprehensive comparison table showing Blazouter advantages over traditional Blazor routing
+  - Project Structure section now includes all folders: Attributes/, Extensions/, Resources/, Components/Layouts/
+- **Enhanced RouteConfig Model**
+  - Added `HasExplicitLayout` property for proper layout handling
+  - Improved XML documentation for all properties
+  - Better support for complex nested route scenarios
+- **Sample Applications**
+  - All 4 sample apps (WebAssembly, Server, Hybrid, Web) updated with transition demos
+  - Added demo pages for all 14 transition types with descriptions and code examples
+  - Enhanced Home.razor with accurate feature showcase
+  - Added Transitions.razor pages demonstrating all transition types
+
+### Fixed
+- Layout handling when explicitly set to null vs. not set
+- Documentation inconsistencies between README.md and FEATURES.md
+- Sample applications showing outdated feature counts
+
+## [1.0.9] - 2025-11-18
+
+### Changed
+- Documentation links updated to reflect new repository location
+
+## [1.0.6-1.0.8] - 2025-11-16 to 2025-11-17
+
+### Note
+- Internal version increments for package stability and distribution
+- Minor bug fixes and improvements
+
 ### Deprecated
 - **Blazouter.Web package**: The `Blazouter.Web` package has been deprecated in favor of using `Blazouter.Server` and `Blazouter.WebAssembly` for Blazor Web Applications. This provides a clearer, more consistent package structure where:
   - Server project uses: `Blazouter.Server`
@@ -80,6 +151,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - FEATURES.md detailing all capabilities
 - Sample application demonstrating key features
 
+[1.0.10]: https://github.com/Taiizor/Blazouter/compare/v1.0.9...v1.0.10
+[1.0.9]: https://github.com/Taiizor/Blazouter/compare/v1.0.5...v1.0.9
+[1.0.6-1.0.8]: https://github.com/Taiizor/Blazouter/compare/v1.0.5...v1.0.9
 [1.0.5]: https://github.com/Taiizor/Blazouter/compare/v1.0.2...v1.0.5
 [1.0.2]: https://github.com/Taiizor/Blazouter/compare/v1.0.1...v1.0.2
 [1.0.1]: https://github.com/Taiizor/Blazouter/releases/tag/v1.0.1

CHANGELOG.md

@@ -19,38 +19,50 @@ Blazouter is a comprehensive routing library for Blazor applications, available
 - Tested and verified working
 - Full hierarchical route structure support
 - Example: `/users` (parent) → `/users/:id` (child)
+- Unlimited nesting depth for complex route hierarchies
 - Parent routes with child routes using `RouterOutlet` component
 
 ### ✅ 2. Route Guards (Protected Routes)
 - Tested and verified working
 - `CanActivateAsync` method to control route access
 - Example: `SampleAuthGuard` in the sample application
 - `GetRedirectPathAsync` for redirect on denied access
+- Support for multiple guards per route (executed in order)
 - `IRouteGuard` interface for custom authentication/authorization logic
+- Guards can be registered via dependency injection or created via Activator
 
 ### ✅ 3. Lazy Loading
 - Reduces initial bundle size
 - Tested and verified working
 - Async component loading with `Task<Type>`
 - Example: Lazy page with simulated 1-second delay
 - `ComponentLoader` function property on `RouteConfig`
+- Loading state support with `<Loading>` parameter in Router
+- Component caching after first load for performance
 
 ### ✅ 4. Route Transitions/Animations
 - Tested and verified working
+- 14 built-in transition types
 - Custom animations can be added via CSS
 - Configurable per-route via `Transition` property
 - Automatic animation application on route change
+- GPU-accelerated animations for smooth performance
+- Respects prefers-reduced-motion accessibility preference
 - Built-in transitions: `None`, `Pop`, `Blur`, `Fade`, `Flip`, `Lift`, `Scale`, `Slide`, `Swipe`, `Reveal`, `Rotate`, `Curtain`, `SlideUp`, `SlideFade`, `Spotlight`
 
 ### ✅ 5. Programmatic Navigation
 - Query parameter support
+- Browser history integration
 - Tested and verified working
 - `NavigateTo(path)` method
+- Support for relative and absolute navigation
 - Integration with Blazor's `NavigationManager`
 - `RouterNavigationService` for imperative navigation
 
 ### ✅ 6. Dynamic Route Parameters
 - Tested and verified working
+- Parameter change notifications
+- Type-safe parameter extraction
 - Query string parameter support
 - Support for nested route parameters
 - Path parameters using `:paramName` syntax
@@ -60,18 +72,42 @@ Blazouter is a comprehensive routing library for Blazor applications, available
 - `Exact` matching option
 - Tested and verified working
 - Visual feedback for current route
+- Supports nested route active states
+- Automatic update on route changes
 - `ActiveClass` property for custom styling
 - `RouterLink` component with automatic active class
 
 ### ✅ 8. Layout System
 - Tested and verified working
+- Layout state preservation during navigation
 - Seamless layout switching during navigation
 - Support for no-layout routes by setting Layout to null
 - `RouteConfig.Layout` property for route-specific layouts
 - `Router.DefaultLayout` parameter for application-wide layout
 - Layout priority: Route.Layout > Router.DefaultLayout > No Layout
 - Automatic layout wrapping using @Body from LayoutComponentBase
 
+### ✅ 9. Attribute-Based Routing
+- Tested and verified working
+- Mix programmatic and attribute-based routes
+- Declarative route configuration using attributes
+- Full documentation in [ATTRIBUTE_ROUTING.md](https://github.com/Taiizor/Blazouter/blob/develop/ATTRIBUTE_ROUTING.md)
+- Automatic route discovery via assembly scanning
+- `AddAttributeRoutes()` extension for easy integration
+- `FromAttributes()` for pure attribute-based configuration
+- 8 attribute types: `[Route]`, `[RouteGuard]`, `[RouteTransition]`, `[RouteLayout]`, `[RouteTitle]`, `[RouteData]`, `[RouteRedirect]`, `[RouteExact]`
+
+### ✅ 10. Error Handling
+- Error event notifications
+- Comprehensive error handling system
+- Retry mechanism for failed operations
+- `DefaultRouterErrorHandler` with built-in logging
+- `RouterErrorContext` with detailed error information
+- `ErrorContent` parameter in Router for custom error UI
+- `IRouterErrorHandler` interface for custom error handlers
+- Custom error handler registration via `AddBlazouterErrorHandler<T>()`
+- Error types: `ComponentLoadFailed`, `GuardRejected`, `NavigationFailed`, `InvalidRoute`
+
 ## Components
 
 ### Router
@@ -98,47 +134,78 @@ Nested route renderer that:
 
 ## Services
 
-### RouteMatcherService
-- Query string parsing
-- Nested route matching
-- Pattern matching for routes
-- Dynamic parameter extraction
+### RouteMatcherService (IRouteMatcherService)
+- Registered as scoped service
+- Route priority and exact match handling
+- Dynamic parameter extraction from URL paths
+- Query string parsing and parameter extraction
+- Pattern matching for routes with wildcard support
+- Nested route matching with parent-child relationships
 
 ### RouterStateService
-- Parameter access
-- Event notifications
-- Current route tracking
-- Central state management
+- Query parameter retrieval
+- Registered as scoped service
+- Component lifecycle integration
+- Event notifications for route changes
+- Current route tracking with RouteMatch
+- Parameter access via GetParam(key) method
+- Central state management for routing context
 
 ### RouterNavigationService
-- Query parameter handling
-- Programmatic navigation API
-- Wrapper around NavigationManager
+- Browser history integration
+- Registered as scoped service
+- Support for relative and absolute navigation
+- Query parameter handling and URL building
+- Programmatic navigation API with NavigateTo(path)
+- Wrapper around NavigationManager for enhanced functionality
+
+### RouteAttributeDiscoveryService
+- Supports all 8 route attributes
+- Reflection-based with trimming warnings
+- Converts attributes to RouteConfig objects
+- Static service for route discovery at startup
+- Discovers components with [Route] attribute
+- Assembly scanning for attribute-based routes
+
+### IRouterErrorHandler / DefaultRouterErrorHandler
+- Error type categorization
+- Retry mechanism support
+- Default handler with console logging
+- Error context with detailed information
+- Error handling interface for custom implementations
+- Registered as scoped service via AddBlazouterErrorHandler<T>()
 
 ## Configuration
 
 ### RouteConfig Properties
-- `RedirectTo`: Redirect path
-- `Data`: Custom data dictionary
-- `Transition`: Animation name
-- `Title`: Route title for metadata
-- `Exact`: Exact path matching flag
-- `Guards`: List of route guard types
-- `Path`: Route pattern (e.g., "/users/:id")
-- `Children`: Nested route configurations
-- `Component`: Component type to render
-- `Layout`: Layout component type (overrides DefaultLayout)
-- `ComponentLoader`: Async component loader for lazy loading
+- `Exact`: Exact path matching flag - When true, requires exact URL match
+- `Data`: Custom data dictionary - Arbitrary metadata passed to components
+- `Transition`: Animation type - One of 14 built-in RouteTransition enum values
+- `HasExplicitLayout`: Internal flag - Tracks if Layout was explicitly set (even if null)
+- `Layout`: Layout component type - Overrides DefaultLayout, set to null for no layout
+- `Path`: Route pattern (e.g., "/users/:id") - Supports dynamic parameters with `:` prefix
+- `Title`: Route title for metadata - Used for page title, breadcrumbs, or navigation labels
+- `Children`: Nested route configurations - List of child RouteConfig for hierarchical routing
+- `RedirectTo`: Redirect path - Automatically redirects to specified path when route matches
+- `Guards`: List of route guard types - Array of IRouteGuard implementations for access control
+- `Component`: Component type to render - Direct component reference for immediate loading
+- `ComponentLoader`: Async component loader for lazy loading - Returns `Task<Type>` for on-demand loading
 
 ## Package-Specific Features
 
 ### Blazouter (Core)
-- Navigation services
-- Lazy loading support
-- Route guards interface
-- Route configuration and matching
-- Multi-framework support (net6.0-net10.0)
+- Lazy loading support with ComponentLoader
+- 14 transition types with RouteTransition enum
+- Comprehensive XML documentation for IntelliSense
+- Layout system support (DefaultLayout, per-route Layout)
+- CSS animations included (blazouter.css, blazouter.min.css)
 - All routing components (Router, RouterLink, RouterOutlet)
+- Multi-framework support (net6.0, net7.0, net8.0, net9.0, net10.0)
+- Navigation services (RouterNavigationService, RouterStateService)
+- Route guards interface (IRouteGuard, AuthGuard base implementation)
+- Route configuration and matching (RouteConfig, RouteMatcherService)
+- Attribute-based routing (RouteAttributeDiscoveryService, 8 route attributes)
+- Error handling (IRouterErrorHandler, DefaultRouterErrorHandler, RouterErrorContext)
 
 ### Blazouter.Server
 - Server-side route optimization
@@ -174,11 +241,13 @@ All features are interactive and can be tested by navigating through the applica
 
 | Feature | Traditional Blazor | Blazouter |
 |---------|-------------------|-----------|
-| Transitions | ❌ None | ✅ Built-in |
-| Active Links | ⚠️ Manual | ✅ Automatic |
-| Lazy Loading | ⚠️ Limited | ✅ Full support |
-| Route Guards | ❌ Manual | ✅ Built-in |
-| Nested Routes | ❌ Limited | ✅ Full support |
-| Parameter Access | ✅ Basic | ✅ Enhanced |
-| Programmatic Nav | ✅ Basic | ✅ Enhanced |
-| Layout System | ⚠️ Static @layout | ✅ Dynamic per-route |
+| Transitions | ❌ None | ✅ 14 built-in transitions |
+| Active Links | ⚠️ Manual | ✅ Automatic with RouterLink |
+| Lazy Loading | ⚠️ Limited | ✅ Full support with ComponentLoader |
+| Route Guards | ❌ Manual | ✅ Built-in IRouteGuard interface |
+| Layout System | ⚠️ Static @layout | ✅ Dynamic per-route with priority |
+| Error Handling | ❌ Manual | ✅ Built-in with IRouterErrorHandler |
+| Nested Routes | ❌ Limited | ✅ Unlimited nesting depth |
+| Attribute Routes | ❌ @page only | ✅ 8 attribute types with full config |
+| Parameter Access | ✅ Basic | ✅ Enhanced with RouterStateService |
+| Programmatic Nav | ✅ Basic | ✅ Enhanced with RouterNavigationService |