Replace hosted service with init extension

Author: ahjephson

CHANGELOG.md

@@ -2,8 +2,9 @@
 
 ## Unreleased
 
-- Initial standalone release preparation.
-- Prepared the package for independent build, test, and NuGet packaging.
+- Replaced hosted-service startup with explicit `InitializeHashRoutingAsync()` host initialization.
+- Canonicalized internal anchor `href` values to hash-route URLs for browser-managed navigation.
+- Clarified that relative anchor URLs such as `./foo` resolve relative to the application base URI.
 
 ## 1.0.0-rc.1
 

README.md

@@ -16,14 +16,19 @@ Register hash routing during startup:
 
 ```csharp
 using Blazor.HashRouting;
+using Microsoft.Extensions.Hosting;
 
 var builder = WebAssemblyHostBuilder.CreateDefault(args);
 
 builder.Services.AddHashRouting();
 
-await builder.Build().RunAsync();
+var host = builder.Build();
+await host.InitializeHashRoutingAsync();
+await host.RunAsync();
 ```
 
+Call `InitializeHashRoutingAsync()` after `Build()` and before `RunAsync()`.
+
 Optional configuration:
 
 ```csharp

release-notes/1.1.0-rc.md

@@ -6,12 +6,15 @@ Release candidate build for the `{{MAJOR_MINOR_PATCH}}` line of `Blazor.HashRout
 
 This release improves link behavior for hash-routed applications by canonicalizing internal anchor `href` values to `/#/...` URLs so browser-managed actions such as middle-click, right-click open in new tab, and copied links continue to resolve through the hash router.
 
+This release also switches startup initialization to an explicit host extension. Applications should call `InitializeHashRoutingAsync()` after building the host and before running it.
+
 ## Highlights
 
 - Canonicalizes internal anchor `href` values to hash-route URLs
 - Preserves opt-out behavior for links that use non-`_self` targets or `download`
 - Keeps browser-managed navigation aligned with intercepted left-click navigation
 - Continues to support base-path deployments such as `/proxy/app/#/settings`
+- Replaces hosted-service startup with explicit `InitializeHashRoutingAsync()` host initialization
 
 ## Relative link resolution
 

release-notes/1.1.0.md

@@ -6,12 +6,15 @@ Stable release for the `{{MAJOR_MINOR_PATCH}}` line of `Blazor.HashRouting`.
 
 This release improves link behavior for hash-routed applications by canonicalizing internal anchor `href` values to `/#/...` URLs so browser-managed actions such as middle-click, right-click open in new tab, and copied links continue to resolve through the hash router.
 
+This release also switches startup initialization to an explicit host extension. Applications should call `InitializeHashRoutingAsync()` after building the host and before running it.
+
 ## Highlights
 
 - Canonicalizes internal anchor `href` values to hash-route URLs
 - Preserves opt-out behavior for links that use non-`_self` targets or `download`
 - Keeps browser-managed navigation aligned with intercepted left-click navigation
 - Continues to support base-path deployments such as `/proxy/app/#/settings`
+- Replaces hosted-service startup with explicit `InitializeHashRoutingAsync()` host initialization
 
 ## Relative link resolution
 

src/Blazor.HashRouting/HashRoutingHostExtensions.cs

@@ -0,0 +1,39 @@
+using Blazor.HashRouting;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+
+namespace Microsoft.Extensions.Hosting
+{
+    /// <summary>
+    /// Host initialization extensions for hash routing.
+    /// </summary>
+    public static class HashRoutingHostExtensions
+    {
+        /// <summary>
+        /// Initializes hash routing after the host has been built.
+        /// </summary>
+        /// <param name="host">The application host.</param>
+        /// <param name="cancellationToken">A cancellation token.</param>
+        /// <returns>A task representing the asynchronous initialization operation.</returns>
+        public static Task InitializeHashRoutingAsync(this IHost host, CancellationToken cancellationToken = default)
+        {
+            ArgumentNullException.ThrowIfNull(host);
+
+            if (!OperatingSystem.IsBrowser())
+            {
+                throw new PlatformNotSupportedException("Blazor.HashRouting supports browser-hosted Blazor WebAssembly applications only.");
+            }
+
+            return InitializeHashRoutingCoreAsync(host, cancellationToken);
+        }
+
+        internal static Task InitializeHashRoutingCoreAsync(this IHost host, CancellationToken cancellationToken = default)
+        {
+            ArgumentNullException.ThrowIfNull(host);
+
+            var navigationManager = host.Services.GetRequiredService<HashNavigationManager>();
+
+            return navigationManager.InitializeAsync(cancellationToken);
+        }
+    }
+}

src/Blazor.HashRouting/HashRoutingHostedService.cs

@@ -1,6 +1,5 @@
 using Microsoft.AspNetCore.Components;
 using Microsoft.Extensions.DependencyInjection.Extensions;
-using Microsoft.Extensions.Hosting;
 using Blazor.HashRouting;
 using Microsoft.Extensions.Logging;
 using Microsoft.JSInterop;
@@ -50,7 +49,6 @@ internal static IServiceCollection AddHashRoutingCore(this IServiceCollection se
                 // Keep AddHashRouting idempotent while allowing the latest options registration to win.
                 services.RemoveAll<HashRoutingOptions>();
                 services.AddSingleton(options);
-                services.TryAddEnumerable(ServiceDescriptor.Singleton<IHostedService, HashRoutingHostedService>());
                 return services;
             }
 
@@ -86,7 +84,6 @@ internal static IServiceCollection AddHashRoutingCore(this IServiceCollection se
                 return (HashNavigationManager)serviceProvider.GetRequiredService<NavigationManager>();
             });
             services.AddSingleton<HashRoutingRegistrationMarker>();
-            services.TryAddEnumerable(ServiceDescriptor.Singleton<IHostedService, HashRoutingHostedService>());
 
             return services;
         }