feat: enhance ShellDocs configuration with ShellDocsOptions class and improved service registration for navigation and Markdown rendering

Author: Shewart

src/ShellDocs.Components/ServiceCollectionExtensions.cs

@@ -1,39 +1,31 @@
 using Microsoft.Extensions.DependencyInjection;
+using ShellDocs.Components.Chrome;
 using ShellDocs.Core;
+using ShellDocs.Markdown;
 
 namespace ShellDocs.Components;
 
-/// Registers ShellDocs services with the consumer's DI container.
-/// Consumer's Program.cs calls this once — everything else is discovered by convention.
 public static class ServiceCollectionExtensions
 {
-    public static IServiceCollection AddShellDocs(
-        this IServiceCollection services,
-        Action<ShellDocsOptions>? configure = null)
+    public static IServiceCollection AddShellDocs(this IServiceCollection services, Action<ShellDocsOptions>? configure = null)
     {
         var options = new ShellDocsOptions();
         configure?.Invoke(options);
         services.AddSingleton(options);
 
-        // Real service wiring lands in feat/core-navigation-graph + feat/markdown-pipeline.
-        // Scaffolding: keep the surface consumers will call, no implementation yet.
-        return services;
-    }
-}
+        services.AddScoped<MobileNavState>();
+        services.AddSingleton<TypeRegistry>(_ => options.BuildTypeRegistry());
+        services.AddSingleton<MarkdownRenderer>(sp => new MarkdownRenderer(sp.GetRequiredService<TypeRegistry>()));
 
-/// Fluent options bag consumers configure in Program.cs.
-public class ShellDocsOptions
-{
-    public string ContentRoot { get; set; } = "content";
-    public string SiteName { get; set; } = "";
-    public string? GitHubRepo { get; set; }
-    public bool EnableSearch { get; set; } = true;
-    public string SearchIndexPath { get; set; } = "search-index.json";
-    public List<Type> RegisteredComponents { get; } = new();
+        services.AddSingleton<NavigationGraph>(_ =>
+        {
+            if (!Directory.Exists(options.ContentRoot))
+            {
+                return new NavigationGraph(new NavigationNode { Url = "/", Kind = NodeKind.Section });
+            }
+            return NavigationGraphBuilder.Build(options.ContentRoot);
+        });
 
-    public ShellDocsOptions RegisterComponent<T>() where T : Microsoft.AspNetCore.Components.ComponentBase
-    {
-        RegisteredComponents.Add(typeof(T));
-        return this;
+        return services;
     }
 }

src/ShellDocs.Components/ShellDocsOptions.cs

@@ -0,0 +1,50 @@
+using ShellDocs.Markdown;
+
+namespace ShellDocs.Components;
+
+public class ShellDocsOptions
+{
+    public string ContentRoot { get; set; } = "content";
+    public string SiteName { get; set; } = "";
+    public string? SiteTagline { get; set; }
+    public string? GitHubRepo { get; set; }
+    public ShellDocsTheme Theme { get; set; } = ShellDocsTheme.Shadcn;
+
+    public List<NavLink> PrimaryNav { get; } = new();
+    public List<Type> RegisteredComponents { get; } = new();
+
+    public ShellDocsOptions RegisterComponent<T>() where T : Microsoft.AspNetCore.Components.ComponentBase
+    {
+        RegisteredComponents.Add(typeof(T));
+        return this;
+    }
+
+    public ShellDocsOptions AddNavLink(string label, string href)
+    {
+        PrimaryNav.Add(new NavLink(label, href));
+        return this;
+    }
+
+    public ShellDocsOptions AddNavMenu(string label, params NavMenuItem[] items)
+    {
+        PrimaryNav.Add(new NavLink(label, "#", Children: items.ToList()));
+        return this;
+    }
+
+    internal TypeRegistry BuildTypeRegistry()
+    {
+        var registry = new TypeRegistry();
+        foreach (var type in RegisteredComponents) registry.Register(type);
+        return registry;
+    }
+}
+
+public record NavLink(string Label, string Href, List<NavMenuItem>? Children = null);
+public record NavMenuItem(string Label, string Href, string? Description = null, string? IconSvg = null);
+
+public enum ShellDocsTheme
+{
+    Shadcn,
+    Fuma,
+    Nextra
+}

src/ShellDocs.Components/_Imports.razor

@@ -1,9 +1,15 @@
 @using System.Net.Http
 @using System.Net.Http.Json
 @using Microsoft.AspNetCore.Components
+@using Microsoft.AspNetCore.Components.CompilerServices
 @using Microsoft.AspNetCore.Components.Forms
 @using Microsoft.AspNetCore.Components.Routing
 @using Microsoft.AspNetCore.Components.Web
+@using Microsoft.Extensions.DependencyInjection
 @using Microsoft.JSInterop
 @using ShellDocs.Components
+@using ShellDocs.Components.Chrome
+@using ShellDocs.Components.Content
+@using ShellDocs.Components.Layouts
 @using ShellDocs.Core
+@using ShellDocs.Markdown