From 2b26aab47d53c1c5c0a84072afdaa6f57962861a Mon Sep 17 00:00:00 2001
From: Shephard Tseisi <shephard@kernel.co.zw>
Date: Tue, 13 Oct 2026 01:03:16 +0200
Subject: [PATCH 1/8] fix: render Label's For parameter as the for attribute

---
 src/ShellUI.Components/Components/Label.razor | 26 +++++++------------
 1 file changed, 10 insertions(+), 16 deletions(-)

diff --git a/src/ShellUI.Components/Components/Label.razor b/src/ShellUI.Components/Components/Label.razor
index 5af8190..34fdd8e 100644
--- a/src/ShellUI.Components/Components/Label.razor
+++ b/src/ShellUI.Components/Components/Label.razor
@@ -1,25 +1,19 @@
 @namespace ShellUI.Components
 
-<label class="@CssClass" @attributes="AdditionalAttributes">
+<label
+    for="@For"
+    class="text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70"
+    @attributes="AdditionalAttributes">
     @ChildContent
 </label>
 
 @code {
-    [Parameter] public string For { get; set; } = "";
-    [Parameter] public RenderFragment? ChildContent { get; set; }
-    [Parameter(CaptureUnmatchedValues = true)]
-    public Dictionary<string, object>? AdditionalAttributes { get; set; }
-
-    private string CssClass => BuildCssClass();
+    [Parameter]
+    public string? For { get; set; }
 
-    private string BuildCssClass()
-    {
-        var classes = new List<string>
-        {
-            "text-sm font-medium leading-none peer-disabled:cursor-not-allowed peer-disabled:opacity-70"
-        };
+    [Parameter]
+    public RenderFragment? ChildContent { get; set; }
 
-        return string.Join(" ", classes);
-    }
+    [Parameter(CaptureUnmatchedValues = true)]
+    public Dictionary<string, object>? AdditionalAttributes { get; set; }
 }
-

From 190503a491c8d86e82c5b0d609d7ca908d046730 Mon Sep 17 00:00:00 2001
From: Shephard Tseisi <shephard@kernel.co.zw>
Date: Tue, 13 Oct 2026 01:03:17 +0200
Subject: [PATCH 2/8] fix: use an inline SVG for the FileUpload icon instead of
 the Material Symbols font

---
 src/ShellUI.Components/Components/FileUpload.razor      | 8 +++++++-
 src/ShellUI.Components/build/ShellUI.Components.targets | 2 --
 src/ShellUI.Components/wwwroot/shellui-classes.txt      | 2 --
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/src/ShellUI.Components/Components/FileUpload.razor b/src/ShellUI.Components/Components/FileUpload.razor
index 4a24a1a..af4421d 100644
--- a/src/ShellUI.Components/Components/FileUpload.razor
+++ b/src/ShellUI.Components/Components/FileUpload.razor
@@ -10,7 +10,13 @@
      @ondragover:preventDefault="true"
      @ondrop:preventDefault="true">
         <div class="text-center pointer-events-none">
-            <span class="material-symbols-outlined mx-auto text-5xl text-muted-foreground block">cloud_upload</span>
+            <svg class="mx-auto h-12 w-12 text-muted-foreground block"
+                 xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5"
+                      d="M7 16a4 4 0 01-.88-7.9 5 5 0 019.9-1A5.5 5.5 0 0118.5 16H7z" />
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5"
+                      d="M12 12v6m0-6l-2 2m2-2l2 2" />
+            </svg>
             <div class="mt-4">
                 <p class="text-sm text-foreground font-medium">@Text</p>
                 @if (Multiple && AllowedFileCount > 1)
diff --git a/src/ShellUI.Components/build/ShellUI.Components.targets b/src/ShellUI.Components/build/ShellUI.Components.targets
index cf4266f..68d2b2a 100644
--- a/src/ShellUI.Components/build/ShellUI.Components.targets
+++ b/src/ShellUI.Components/build/ShellUI.Components.targets
@@ -201,7 +201,6 @@
     <ShellUISafelistEntry Include="left-3.5" />
     <ShellUISafelistEntry Include="lg:space-x-8" />
     <ShellUISafelistEntry Include="list-none" />
-    <ShellUISafelistEntry Include="material-symbols-outlined" />
     <ShellUISafelistEntry Include="max-h-48" />
     <ShellUISafelistEntry Include="max-h-60" />
     <ShellUISafelistEntry Include="max-h-[90vh]" />
@@ -352,7 +351,6 @@
     <ShellUISafelistEntry Include="starting:scale-95" />
     <ShellUISafelistEntry Include="tabular-nums" />
     <ShellUISafelistEntry Include="text-2xl" />
-    <ShellUISafelistEntry Include="text-5xl" />
     <ShellUISafelistEntry Include="text-[10px]" />
     <ShellUISafelistEntry Include="text-[8px]" />
     <ShellUISafelistEntry Include="text-accent-foreground" />
diff --git a/src/ShellUI.Components/wwwroot/shellui-classes.txt b/src/ShellUI.Components/wwwroot/shellui-classes.txt
index 546de46..64e09e1 100644
--- a/src/ShellUI.Components/wwwroot/shellui-classes.txt
+++ b/src/ShellUI.Components/wwwroot/shellui-classes.txt
@@ -198,7 +198,6 @@ left-2
 left-3.5
 lg:space-x-8
 list-none
-material-symbols-outlined
 max-h-48
 max-h-60
 max-h-[90vh]
@@ -349,7 +348,6 @@ starting:opacity-0
 starting:scale-95
 tabular-nums
 text-2xl
-text-5xl
 text-[10px]
 text-[8px]
 text-accent-foreground

From 30268d2ca819c1aeb80fc135e184b69617accda2 Mon Sep 17 00:00:00 2001
From: Shephard Tseisi <shephard@kernel.co.zw>
Date: Tue, 13 Oct 2026 01:03:17 +0200
Subject: [PATCH 3/8] fix: stop clicks inside Sheet and Drawer panels reaching
 parent click handlers

---
 src/ShellUI.Components/Components/Drawer.razor        | 2 +-
 src/ShellUI.Components/Components/DrawerContent.razor | 2 +-
 src/ShellUI.Components/Components/Sheet.razor         | 2 +-
 src/ShellUI.Components/Components/SheetContent.razor  | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/ShellUI.Components/Components/Drawer.razor b/src/ShellUI.Components/Components/Drawer.razor
index 9dde347..76bd72d 100644
--- a/src/ShellUI.Components/Components/Drawer.razor
+++ b/src/ShellUI.Components/Components/Drawer.razor
@@ -9,7 +9,7 @@
 else if (Open)
 {
     <div class="fixed inset-0 z-50 bg-black/80 animate-in fade-in-0" @onclick="Close"></div>
-    <div class="@DrawerVariants.Get(Side, Class)" @attributes="AdditionalAttributes">
+    <div class="@DrawerVariants.Get(Side, Class)" @onclick:stopPropagation="true" @attributes="AdditionalAttributes">
             <div class="mx-auto mt-4 h-2 w-[100px] rounded-full bg-muted"></div>
             <div class="grid gap-1.5 p-4 text-center sm:text-left">
                 @if (!string.IsNullOrEmpty(Title))
diff --git a/src/ShellUI.Components/Components/DrawerContent.razor b/src/ShellUI.Components/Components/DrawerContent.razor
index a2510ae..d3ea80a 100644
--- a/src/ShellUI.Components/Components/DrawerContent.razor
+++ b/src/ShellUI.Components/Components/DrawerContent.razor
@@ -6,7 +6,7 @@
 @if (Parent?.Open == true)
 {
     <div class="fixed inset-0 z-50 bg-black/80 animate-in fade-in-0" @onclick="Close"></div>
-    <div @ref="_content" tabindex="-1" role="dialog" aria-modal="true" @onkeydown="OnKeyDownAsync" class="outline-none @DrawerVariants.Get(Parent.Side, Class)" @attributes="AdditionalAttributes">
+    <div @ref="_content" tabindex="-1" role="dialog" aria-modal="true" @onkeydown="OnKeyDownAsync" class="outline-none @DrawerVariants.Get(Parent.Side, Class)" @onclick:stopPropagation="true" @attributes="AdditionalAttributes">
         <div class="mx-auto mt-4 h-2 w-[100px] rounded-full bg-muted"></div>
         <div class="flex flex-col gap-4 p-4">
             @ChildContent
diff --git a/src/ShellUI.Components/Components/Sheet.razor b/src/ShellUI.Components/Components/Sheet.razor
index 6fe6fca..8f7d65c 100644
--- a/src/ShellUI.Components/Components/Sheet.razor
+++ b/src/ShellUI.Components/Components/Sheet.razor
@@ -9,7 +9,7 @@
 else if (Open)
 {
     <div class="fixed inset-0 z-50 bg-background/80 backdrop-blur-sm animate-in fade-in-0" @onclick="Close"></div>
-    <div class="@SheetVariants.Get(Side, Class)" @attributes="AdditionalAttributes">
+    <div class="@SheetVariants.Get(Side, Class)" @onclick:stopPropagation="true" @attributes="AdditionalAttributes">
         <div class="flex flex-col space-y-2">
             @if (!string.IsNullOrEmpty(Title))
             {
diff --git a/src/ShellUI.Components/Components/SheetContent.razor b/src/ShellUI.Components/Components/SheetContent.razor
index bcc6426..4c3891b 100644
--- a/src/ShellUI.Components/Components/SheetContent.razor
+++ b/src/ShellUI.Components/Components/SheetContent.razor
@@ -6,7 +6,7 @@
 @if (Parent?.Open == true)
 {
     <div class="fixed inset-0 z-50 bg-background/80 backdrop-blur-sm animate-in fade-in-0" @onclick="Close"></div>
-    <div @ref="_content" tabindex="-1" role="dialog" aria-modal="true" @onkeydown="OnKeyDownAsync" class="outline-none @SheetVariants.Get(Parent.Side, Class)" @attributes="AdditionalAttributes">
+    <div @ref="_content" tabindex="-1" role="dialog" aria-modal="true" @onkeydown="OnKeyDownAsync" class="outline-none @SheetVariants.Get(Parent.Side, Class)" @onclick:stopPropagation="true" @attributes="AdditionalAttributes">
         <div class="flex flex-col gap-4 p-6">
             @ChildContent
         </div>

From f98aede32cfb3616d315e475ee0bc9a58e96ded8 Mon Sep 17 00:00:00 2001
From: Shephard Tseisi <shephard@kernel.co.zw>
Date: Tue, 13 Oct 2026 01:03:17 +0200
Subject: [PATCH 4/8] fix: show the Sheet close button when only Description is
 set

---
 src/ShellUI.Components/Components/Sheet.razor | 26 +++++++++++--------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/src/ShellUI.Components/Components/Sheet.razor b/src/ShellUI.Components/Components/Sheet.razor
index 8f7d65c..c6b05b0 100644
--- a/src/ShellUI.Components/Components/Sheet.razor
+++ b/src/ShellUI.Components/Components/Sheet.razor
@@ -11,18 +11,22 @@ else if (Open)
     <div class="fixed inset-0 z-50 bg-background/80 backdrop-blur-sm animate-in fade-in-0" @onclick="Close"></div>
     <div class="@SheetVariants.Get(Side, Class)" @onclick:stopPropagation="true" @attributes="AdditionalAttributes">
         <div class="flex flex-col space-y-2">
-            @if (!string.IsNullOrEmpty(Title))
-            {
-                <div class="flex items-center justify-between">
+            <div class="flex items-center justify-between">
+                @if (!string.IsNullOrEmpty(Title))
+                {
                     <h2 class="text-lg font-semibold text-foreground">@Title</h2>
-                    <button type="button" @onclick="Close" class="rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none">
-                        <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
-                            <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
-                        </svg>
-                        <span class="sr-only">Close</span>
-                    </button>
-                </div>
-            }
+                }
+                else
+                {
+                    <span></span>
+                }
+                <button type="button" @onclick="Close" class="rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none">
+                    <svg class="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M6 18L18 6M6 6l12 12" />
+                    </svg>
+                    <span class="sr-only">Close</span>
+                </button>
+            </div>
             @if (!string.IsNullOrEmpty(Description))
             {
                 <p class="text-sm text-muted-foreground">@Description</p>

From 99aa7d9383a903c437bec7e8432bac2f35cb9ce5 Mon Sep 17 00:00:00 2001
From: Shephard Tseisi <shephard@kernel.co.zw>
Date: Tue, 13 Oct 2026 01:03:28 +0200
Subject: [PATCH 5/8] fix: guard the CarouselItem template against zero slides

---
 src/ShellUI.Templates/Templates/CarouselItemTemplate.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/ShellUI.Templates/Templates/CarouselItemTemplate.cs b/src/ShellUI.Templates/Templates/CarouselItemTemplate.cs
index 77318df..1b0e4fd 100644
--- a/src/ShellUI.Templates/Templates/CarouselItemTemplate.cs
+++ b/src/ShellUI.Templates/Templates/CarouselItemTemplate.cs
@@ -16,7 +16,7 @@ public static class CarouselItemTemplate
     };
 
     public const string Content = """
-<div class="@($"w-full flex-shrink-0 {Class}")" style="width: @(100.0 / TotalSlides)%">
+<div class="@Shell.Cn("w-full flex-shrink-0", Class)" style="width: @(100.0 / Math.Max(1, TotalSlides))%">
     <div class="w-full h-full flex items-center justify-center">
         @ChildContent
     </div>

From 9e646004db664dc16376ee8edb69dbe9c0b59813 Mon Sep 17 00:00:00 2001
From: Shephard Tseisi <shephard@kernel.co.zw>
Date: Tue, 13 Oct 2026 01:03:28 +0200
Subject: [PATCH 6/8] fix: match the package in the SidebarMenuButton, Menubar
 and ThemeToggle templates

---
 src/ShellUI.Templates/Templates/MenubarTemplate.cs | 14 ++++----------
 .../Templates/SidebarMenuButtonTemplate.cs         |  2 +-
 .../Templates/ThemeToggleTemplate.cs               |  2 +-
 3 files changed, 6 insertions(+), 12 deletions(-)

diff --git a/src/ShellUI.Templates/Templates/MenubarTemplate.cs b/src/ShellUI.Templates/Templates/MenubarTemplate.cs
index 2b93f91..e610683 100644
--- a/src/ShellUI.Templates/Templates/MenubarTemplate.cs
+++ b/src/ShellUI.Templates/Templates/MenubarTemplate.cs
@@ -18,21 +18,15 @@ public class MenubarTemplate
 
     public static string Content => @"@namespace YourProjectNamespace.Components.UI
 
-<div class=""@(""flex h-10 items-center space-x-1 rounded-md border bg-background p-1 "" + ClassName + "" "" + Class)"" @attributes=""AdditionalAttributes"">
+<div class=""@Shell.Cn(""flex h-10 items-center space-x-1 rounded-md border border-border bg-background p-1"", ClassName, Class)"" @attributes=""AdditionalAttributes"">
     @ChildContent
 </div>
 
 @code {
-    [Parameter]
-    public RenderFragment? ChildContent { get; set; }
-    
-    [Parameter]
-    public string? Class { get; set; }
-
+    [Parameter] public RenderFragment? ChildContent { get; set; }
+    [Parameter] public string? Class { get; set; }
     // Deprecated: use Class.
-    [Parameter]
-    public string ClassName { get; set; } = """";
-    
+    [Parameter] public string ClassName { get; set; } = """";
     [Parameter(CaptureUnmatchedValues = true)]
     public Dictionary<string, object>? AdditionalAttributes { get; set; }
 }
diff --git a/src/ShellUI.Templates/Templates/SidebarMenuButtonTemplate.cs b/src/ShellUI.Templates/Templates/SidebarMenuButtonTemplate.cs
index d3a89d6..bd6270e 100644
--- a/src/ShellUI.Templates/Templates/SidebarMenuButtonTemplate.cs
+++ b/src/ShellUI.Templates/Templates/SidebarMenuButtonTemplate.cs
@@ -25,7 +25,7 @@ public static class SidebarMenuButtonTemplate
     };
 
     var buttonClass = Shell.Cn(
-        ""peer/menu-button flex w-full items-center gap-2 overflow-hidden rounded-md p-2 text-left text-sm outline-none ring-sidebar-ring transition-[width,height,padding] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 active:bg-sidebar-accent active:text-sidebar-accent-foreground disabled:pointer-events-none disabled:opacity-50 group-has-[[data-sidebar=menu-action]]/menu-item:pr-8 aria-disabled:pointer-events-none aria-disabled:opacity-50 data-[active=true]:bg-sidebar-accent data-[active=true]:font-medium data-[active=true]:text-sidebar-accent-foreground data-[state=open]:hover:bg-sidebar-accent data-[state=open]:hover:text-sidebar-accent-foreground group-data-[collapsible=icon]:!size-8 group-data-[collapsible=icon]:!p-2 [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0 [&>i]:w-4 [&>i]:shrink-0 [&>i]:text-center"",
+        ""peer/menu-button flex w-full items-center gap-2 overflow-hidden rounded-md p-2 text-left text-sm outline-none ring-sidebar-ring transition-[width,height,padding] hover:bg-sidebar-accent hover:text-sidebar-accent-foreground focus-visible:ring-2 active:bg-sidebar-accent active:text-sidebar-accent-foreground disabled:pointer-events-none disabled:opacity-50 group-has-[[data-sidebar=menu-action]]/menu-item:pr-8 aria-disabled:pointer-events-none aria-disabled:opacity-50 data-[active=true]:bg-sidebar-accent data-[active=true]:font-medium data-[active=true]:text-sidebar-accent-foreground data-[state=open]:hover:bg-sidebar-accent data-[state=open]:hover:text-sidebar-accent-foreground group-data-[collapsible=icon]:!size-8 group-data-[collapsible=icon]:!p-2 group-data-[collapsible=icon]:!rounded-full group-data-[collapsible=icon]:justify-center group-data-[collapsible=icon]:[&>span]:hidden [&>span:last-child]:truncate [&>svg]:size-4 [&>svg]:shrink-0 [&>i]:w-4 [&>i]:shrink-0 [&>i]:text-center"",
         sizeClass,
         Class
     );
diff --git a/src/ShellUI.Templates/Templates/ThemeToggleTemplate.cs b/src/ShellUI.Templates/Templates/ThemeToggleTemplate.cs
index 4c859d9..89d6edb 100644
--- a/src/ShellUI.Templates/Templates/ThemeToggleTemplate.cs
+++ b/src/ShellUI.Templates/Templates/ThemeToggleTemplate.cs
@@ -23,7 +23,7 @@ @implements IAsyncDisposable
 
 <button 
     @onclick=""ToggleTheme"" 
-    class=""inline-flex items-center justify-center rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 @(Variant == ""outline"" ? ""border border-input bg-background"" : """") hover:bg-accent hover:text-accent-foreground @(Size == ""sm"" ? ""h-8 w-8"" : Size == ""lg"" ? ""h-11 w-11"" : ""h-9 w-9"") @Class""
+    class=""@Shell.Cn(""inline-flex items-center justify-center rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50 hover:bg-accent hover:text-accent-foreground"", Variant == ""outline"" ? ""border border-input bg-background"" : """", Size == ""sm"" ? ""h-8 w-8"" : Size == ""lg"" ? ""h-11 w-11"" : ""h-9 w-9"", Class)""
     title=""Toggle theme""
     type=""button""
     @attributes=""AdditionalAttributes"">

From d722e85d80ad84b31b0983baf1934f8433671d45 Mon Sep 17 00:00:00 2001
From: Shephard Tseisi <shephard@kernel.co.zw>
Date: Tue, 13 Oct 2026 01:03:28 +0200
Subject: [PATCH 7/8] test: compare markup of reconciled components with their
 CLI templates

---
 ShellUI.Tests/TemplateSyncTests.cs | 39 ++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/ShellUI.Tests/TemplateSyncTests.cs b/ShellUI.Tests/TemplateSyncTests.cs
index 4c1894e..a54226a 100644
--- a/ShellUI.Tests/TemplateSyncTests.cs
+++ b/ShellUI.Tests/TemplateSyncTests.cs
@@ -129,6 +129,13 @@ public class TemplateSyncTests
     [InlineData("command-option", "CommandOption.razor")]
     [InlineData("command-empty", "CommandEmpty.razor")]
     [InlineData("command-separator", "CommandSeparator.razor")]
+    [InlineData("label", "Label.razor")]
+    [InlineData("file-upload", "FileUpload.razor")]
+    [InlineData("carousel-item", "CarouselItem.razor")]
+    [InlineData("menubar", "Menubar.razor")]
+    [InlineData("sheet-content", "SheetContent.razor")]
+    [InlineData("drawer-content", "DrawerContent.razor")]
+    [InlineData("sidebar-menu-button", "SidebarMenuButton.razor")]
     public void TemplateCodeBlock_MatchesLiveLibrary(string templateName, string razorFileName)
     {
         if (AllowedDrift.ContainsKey(templateName)) return;
@@ -152,6 +159,29 @@ public void TemplateCodeBlock_MatchesLiveLibrary(string templateName, string raz
             DiffSummary(normalizedLive, normalizedTemplate));
     }
 
+    [Theory]
+    [InlineData("label", "Label.razor")]
+    [InlineData("file-upload", "FileUpload.razor")]
+    [InlineData("carousel-item", "CarouselItem.razor")]
+    [InlineData("menubar", "Menubar.razor")]
+    [InlineData("sheet-content", "SheetContent.razor")]
+    [InlineData("drawer-content", "DrawerContent.razor")]
+    [InlineData("sidebar-menu-button", "SidebarMenuButton.razor")]
+    [InlineData("theme-toggle", "ThemeToggle.razor")]
+    public void TemplateMarkup_MatchesLiveLibrary(string templateName, string razorFileName)
+    {
+        var liveContent = File.ReadAllText(GetLiveRazorPath(razorFileName));
+        var templateContent = ComponentRegistry.GetComponentContent(templateName)
+            ?? throw new InvalidOperationException($"Template '{templateName}' not found in registry");
+
+        var normalizedLive = Normalize(ExtractMarkup(liveContent));
+        var normalizedTemplate = Normalize(ExtractMarkup(templateContent));
+
+        Assert.True(normalizedLive == normalizedTemplate,
+            $"Markup drift between live {razorFileName} and template {templateName}.\n\n" +
+            DiffSummary(normalizedLive, normalizedTemplate));
+    }
+
     [Fact]
     public void ChartVariantsTemplate_MatchesLiveLibrary()
     {
@@ -204,6 +234,15 @@ private static string DiffSummary(string live, string template)
         return diffs.Length == 0 ? "(no per-line diff — file lengths differ)" : diffs.ToString();
     }
 
+    // Everything before `@code`, without the @namespace and @using lines that differ by design.
+    private static string ExtractMarkup(string razor)
+    {
+        var match = Regex.Match(razor, @"@code\s*\{");
+        var head = match.Success ? razor.Substring(0, match.Index) : razor;
+        var lines = head.Split('\n').Where(l => !Regex.IsMatch(l.Trim(), @"^@(namespace|using)\b"));
+        return string.Join("\n", lines);
+    }
+
     /// Body of the first `@code { }` block, or null if missing or unbalanced.
     private static string? ExtractCodeBlock(string razor)
     {

From 203aa246b21d3e4541bb66e11937fae73d770a2e Mon Sep 17 00:00:00 2001
From: Shephard Tseisi <shephard@kernel.co.zw>
Date: Tue, 13 Oct 2026 01:03:28 +0200
Subject: [PATCH 8/8] docs: mark the Select, ContextMenu, NavigationMenu and
 Carousel parts as done in the roadmap

---
 docs/COMPONENT_ROADMAP.md | 13 ++++---------
 1 file changed, 4 insertions(+), 9 deletions(-)

diff --git a/docs/COMPONENT_ROADMAP.md b/docs/COMPONENT_ROADMAP.md
index 30af5bd..95b5b94 100644
--- a/docs/COMPONENT_ROADMAP.md
+++ b/docs/COMPONENT_ROADMAP.md
@@ -73,15 +73,10 @@ The current registry provides explicit sub-components for these parent component
 - [x] **Popover** — `PopoverTrigger`, `PopoverContent`
 - [x] **HoverCard** — `HoverCardTrigger`, `HoverCardContent`
 - [x] **Drawer and Sheet** — explicit trigger/content and variant support
-
-### Package only (CLI templates pending)
-
-These parts exist in the `ShellUI.Components` NuGet package, but their CLI templates are empty placeholders, so CLI installs only get the parent component.
-
-- [ ] **Select** — `SelectTrigger`, `SelectContent`, `SelectItem` (the native select works in both)
-- [ ] **ContextMenu** — `ContextMenuTrigger`, `ContextMenuContent`, `ContextMenuOption`
-- [ ] **NavigationMenu** — `NavList`, `NavItem`, `NavTrigger`, `NavContent`
-- [ ] **Carousel** — `CarouselList`, `CarouselSlide`
+- [x] **Select** — `SelectTrigger`, `SelectContent`, `SelectItem` (the native select still works)
+- [x] **ContextMenu** — `ContextMenuTrigger`, `ContextMenuContent`, `ContextMenuOption`
+- [x] **NavigationMenu** — `NavList`, `NavItem`, `NavTrigger`, `NavContent`
+- [x] **Carousel** — `CarouselList`, `CarouselSlide`
 
 The intended pattern is explicit child components, cascaded state and callbacks, value/label parameters, and Tailwind utility classes matching the shadcn-style API.