spine-framework 0.3.145 → 0.4.0

package/.framework/src/components/ui/sidebar.tsx

@@ -1,3 +1,13 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-AUDIENCE audience="frontend-developers"]
+// CIL[DOC-MACRO purpose="Collects sidebar dependencies, shared configuration, context types, and exports the public sidebar API"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import shared dependencies and declare module-level sidebar constants and types"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none (side effects at module level)" errors="none" side_effects="creates React context and defines module constants"]
+// CIL[DOC-MICRO logic_summary="Imports React, cva, radix-ui Slot, project hooks, local utilities, and sibling UI components" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 
 
 
@@ -28,21 +38,6 @@
 
 
 
-// CIL[BEGIN chunk_id="sidebar_module_header_1783758409" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for sidebar component library"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import external React UI primitives and utilities"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React, CVA, hooks, UI components, icons" errors="none" side_effects="Module imports"]
-// CIL[DOC-MICRO logic_summary="Imports React, CVA, hooks, UI components and icons for sidebar functionality" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/components/ui/dialog.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/portal/pages/CoursesPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import * as React from "react"
 import { cva, type VariantProps } from "class-variance-authority"
 import { Slot } from "radix-ui"
@@ -66,42 +61,28 @@ import {
   TooltipTrigger,
 } from "@/components/ui/tooltip"
 import { PanelLeftIcon } from "lucide-react"
-// CIL[END chunk_id="sidebar_module_header_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_constants_1783758409" type="constants" identity="constants" parent="none"]
-// CIL[DOC-MACRO purpose="Define sidebar configuration constants"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide sidebar state and styling configuration values"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Constants" errors="none" side_effects="Constants definition"]
-// CIL[DOC-MICRO logic_summary="Defines cookie name, max age, width values and keyboard shortcut for sidebar" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Collects sidebar dependencies, shared configuration, context types, and exports the public sidebar API'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:sidebar_config:config" type="config" identity="sidebar_config" parent="none"]
+// CIL[DOC-MACRO purpose="Defines sidebar layout constants, cookie name, keyboard shortcut, and the React context type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide reusable layout values and the typed sidebar context"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="constants, types, and context" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares cookie and width constants and a typed context for provider state" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const SIDEBAR_COOKIE_NAME = "sidebar_state"
 const SIDEBAR_COOKIE_MAX_AGE = 60 * 60 * 24 * 7
 const SIDEBAR_WIDTH = "16rem"
 const SIDEBAR_WIDTH_MOBILE = "18rem"
 const SIDEBAR_WIDTH_ICON = "3rem"
 const SIDEBAR_KEYBOARD_SHORTCUT = "b"
-// CIL[END chunk_id="sidebar_constants_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_types_1783758409" type="types" identity="SidebarContextProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define sidebar context interface"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide TypeScript interface for sidebar context"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TypeScript interface" errors="none" side_effects="Type definition"]
-// CIL[DOC-MICRO logic_summary="Defines interface with state, open/close functions, mobile detection and toggle" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 type SidebarContextProps = {
   state: "expanded" | "collapsed"
   open: boolean
@@ -111,37 +92,23 @@ type SidebarContextProps = {
   isMobile: boolean
   toggleSidebar: () => void
 }
-// CIL[END chunk_id="sidebar_types_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_context_1783758409" type="context" identity="SidebarContext" parent="none"]
-// CIL[DOC-MACRO purpose="Create React context for sidebar state"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide context for sharing sidebar state across components"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React Context" errors="none" side_effects="React context creation"]
-// CIL[DOC-MICRO logic_summary="Creates React context with SidebarContextProps type and null default" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/portal/pages/CoursesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 const SidebarContext = React.createContext<SidebarContextProps | null>(null)
-// CIL[END chunk_id="sidebar_context_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_usesidebar_1783758409" type="function" identity="useSidebar" parent="none"]
-// CIL[DOC-MACRO purpose="Hook to access sidebar context"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide safe access to sidebar context with error handling"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="SidebarContextProps" errors="Throws if context missing" side_effects="React context access"]
-// CIL[DOC-MICRO logic_summary="Accesses React context with error throwing for missing provider" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Defines sidebar layout constants, cookie name, keyboard shortcut, and the React context type'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:sidebar_config:config"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:useSidebar:hook" type="hook" identity="useSidebar" parent="none"]
+// CIL[DOC-MACRO purpose="Provides the sidebar state hook used by consumers within a SidebarProvider"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return the current sidebar context or throw if the provider is missing"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="SidebarContextProps object" errors="throws if called outside a SidebarProvider" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Reads context and throws when null" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function useSidebar() {
   const context = React.useContext(SidebarContext)
   if (!context) {
@@ -150,21 +117,22 @@ function useSidebar() {
 
   return context
 }
-// CIL[END chunk_id="sidebar_usesidebar_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarprovider_1783758409" type="function" identity="SidebarProvider" parent="none"]
-// CIL[DOC-MACRO purpose="Provider component for sidebar state management"]
-// CIL[DOC-RESPONSIBILITY responsibility="Manage sidebar state, persistence, keyboard shortcuts and mobile detection"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Context provider" errors="none" side_effects="State management, cookie storage, keyboard events"]
-// CIL[DOC-MICRO logic_summary="Manages sidebar state with cookie persistence, keyboard shortcuts, mobile detection and context provision" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Provides the sidebar state hook used by consumers within a SidebarProvider'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:useSidebar:hook"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarProvider:component" type="component" identity="SidebarProvider" parent="none"]
+// CIL[DOC-MACRO purpose="Manages sidebar open state, mobile sheet state, cookie persistence, and keyboard toggle"]
+// CIL[DOC-RESPONSIBILITY responsibility="Own sidebar state, cookie persistence, keyboard shortcut, and context value"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="defaultOpen, open, onOpenChange, className, style, children, props" outputs="JSX element" errors="none" side_effects="sets document.cookie and attaches a window keydown listener"]
+// CIL[DOC-MICRO logic_summary="Initializes open state, syncs props, persists state to a cookie, and toggles via keyboard" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarProvider({
   defaultOpen = true,
   open: openProp,
@@ -253,21 +221,22 @@ function SidebarProvider({
     </SidebarContext.Provider>
   )
 }
-// CIL[END chunk_id="sidebar_sidebarprovider_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebar_1783758409" type="function" identity="Sidebar" parent="none"]
-// CIL[DOC-MACRO purpose="Main sidebar component with responsive behavior"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render sidebar panel with mobile/desktop variants and positioning"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled sidebar panel" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates responsive sidebar with mobile sheet, desktop panel, gap handling and animations" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Manages sidebar open state, mobile sheet state, cookie persistence, and keyboard toggle'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarProvider:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:Sidebar:component" type="component" identity="Sidebar" parent="none"]
+// CIL[DOC-MACRO purpose="Renders the main sidebar container with responsive offcanvas, floating, or inset variants"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the correct sidebar layout for desktop or mobile contexts"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="side, variant, collapsible, className, children, dir, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Chooses between a static container, a mobile Sheet, or a desktop peer layout based on props and screen" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function Sidebar({
   side = "left",
   variant = "sidebar",
@@ -323,7 +292,6 @@ function Sidebar({
       </Sheet>
     )
   }
-
   return (
     <div
       className="group peer hidden text-sidebar-foreground md:block"
@@ -368,21 +336,22 @@ function Sidebar({
     </div>
   )
 }
-// CIL[END chunk_id="sidebar_sidebar_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebartrigger_1783758409" type="function" identity="SidebarTrigger" parent="none"]
-// CIL[DOC-MACRO purpose="Button to toggle sidebar open/closed state"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle sidebar toggle with button styling and icon"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Toggle button" errors="none" side_effects="State change, DOM events"]
-// CIL[DOC-MICRO logic_summary="Creates button with PanelLeftIcon that toggles sidebar state on click" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders the main sidebar container with responsive offcanvas, floating, or inset variants'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:Sidebar:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarTrigger:component" type="component" identity="SidebarTrigger" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a button that toggles the sidebar open/closed state"]
+// CIL[DOC-RESPONSIBILITY responsibility="Toggle sidebar state when activated by user interaction"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, onClick, props" outputs="JSX element" errors="none" side_effects="calls toggleSidebar on click"]
+// CIL[DOC-MICRO logic_summary="Wraps Button and calls toggleSidebar when clicked" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarTrigger({
   className,
   onClick,
@@ -408,21 +377,22 @@ function SidebarTrigger({
     </Button>
   )
 }
-// CIL[END chunk_id="sidebar_sidebartrigger_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarrail_1783758409" type="function" identity="SidebarRail" parent="none"]
-// CIL[DOC-MACRO purpose="Rail handle for manual sidebar resizing"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide draggable rail with resize cursor and visual feedback"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Rail button" errors="none" side_effects="DOM events"]
-// CIL[DOC-MICRO logic_summary="Creates draggable rail with resize cursor, hover states and visual divider" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a button that toggles the sidebar open/closed state'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarTrigger:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarRail:component" type="component" identity="SidebarRail" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a collapsible rail area that toggles the sidebar when clicked"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a clickable rail to collapse or expand the sidebar"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="calls toggleSidebar on click"]
+// CIL[DOC-MICRO logic_summary="Renders an absolute hover/click rail to toggle the sidebar" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarRail({ className, ...props }: React.ComponentProps<"button">) {
   const { toggleSidebar } = useSidebar()
 
@@ -447,21 +417,22 @@ function SidebarRail({ className, ...props }: React.ComponentProps<"button">) {
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarrail_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarinset_1783758409" type="function" identity="SidebarInset" parent="none"]
-// CIL[DOC-MACRO purpose="Main content area with sidebar inset spacing"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide main container with responsive margin for sidebar"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Main content area" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates main content area with responsive margins when sidebar is present" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a collapsible rail area that toggles the sidebar when clicked'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarRail:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarInset:component" type="component" identity="SidebarInset" parent="none"]
+// CIL[DOC-MACRO purpose="Renders the main content area that adapts to the sidebar variant"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display main page content with correct margins for the active sidebar variant"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders main content with inset-aware margins" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarInset({ className, ...props }: React.ComponentProps<"main">) {
   return (
     <main
@@ -474,21 +445,22 @@ function SidebarInset({ className, ...props }: React.ComponentProps<"main">) {
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarinset_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarinput_1783758409" type="function" identity="SidebarInput" parent="none"]
-// CIL[DOC-MACRO purpose="Input field styled for sidebar context"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled input with sidebar-specific styling"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled input" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates input with fixed height, background color and sidebar styling" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders the main content area that adapts to the sidebar variant'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarInset:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarInput:component" type="component" identity="SidebarInput" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a compact input styled for use inside the sidebar"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render an input field visually adapted to the sidebar"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards to Input with sidebar-specific styling" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarInput({
   className,
   ...props
@@ -505,21 +477,22 @@ function SidebarInput({
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarinput_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarheader_1783758409" type="function" identity="SidebarHeader" parent="none"]
-// CIL[DOC-MACRO purpose="Header section container for sidebar"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled header container with spacing"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled header div" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates flex column header with gap and padding using Tailwind classes" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a compact input styled for use inside the sidebar'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarInput:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarHeader:component" type="component" identity="SidebarHeader" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a header section inside the sidebar"]
+// CIL[DOC-RESPONSIBILITY responsibility="Contain header-level children inside the sidebar layout"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards to a styled div" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarHeader({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -530,21 +503,22 @@ function SidebarHeader({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarheader_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarfooter_1783758409" type="function" identity="SidebarFooter" parent="none"]
-// CIL[DOC-MACRO purpose="Footer section container for sidebar"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled footer container with auto margin"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled footer div" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates flex column footer with auto margin, gap and padding using Tailwind" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a header section inside the sidebar'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarHeader:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarFooter:component" type="component" identity="SidebarFooter" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a footer section inside the sidebar"]
+// CIL[DOC-RESPONSIBILITY responsibility="Contain footer-level children inside the sidebar layout"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards to a styled div" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarFooter({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -555,21 +529,22 @@ function SidebarFooter({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarfooter_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarseparator_1783758409" type="function" identity="SidebarSeparator" parent="none"]
-// CIL[DOC-MACRO purpose="Visual separator for sidebar content"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled horizontal divider for sidebar sections"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled separator" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates horizontal divider with border color and negative margins" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a footer section inside the sidebar'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarFooter:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarSeparator:component" type="component" identity="SidebarSeparator" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a horizontal separator line inside the sidebar"]
+// CIL[DOC-RESPONSIBILITY responsibility="Visually separate groups of sidebar items"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards to a styled Separator" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarSeparator({
   className,
   ...props
@@ -583,21 +558,22 @@ function SidebarSeparator({
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarseparator_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarcontent_1783758409" type="function" identity="SidebarContent" parent="none"]
-// CIL[DOC-MACRO purpose="Main content area for sidebar items"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle SidebarContent"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Scrollable content area" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates scrollable flex column container with overflow handling" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a horizontal separator line inside the sidebar'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarSeparator:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarContent:component" type="component" identity="SidebarContent" parent="none"]
+// CIL[DOC-MACRO purpose="Renders the scrollable content area of the sidebar"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the scrollable primary content region of the sidebar"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards to a scrollable flex div" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarContent({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -611,21 +587,22 @@ function SidebarContent({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarcontent_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebargroup_1783758409" type="function" identity="SidebarGroup" parent="none"]
-// CIL[DOC-MACRO purpose="Group container for sidebar items"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled container for grouping sidebar content"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled group container" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates flex column container with min-width and padding for sidebar groups" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders the scrollable content area of the sidebar'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarContent:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarGroup:component" type="component" identity="SidebarGroup" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a grouping container for sidebar menu items"]
+// CIL[DOC-RESPONSIBILITY responsibility="Group related items and labels inside the sidebar"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards to a styled div" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarGroup({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -639,21 +616,22 @@ function SidebarGroup({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebargroup_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebargrouplabel_1783758409" type="function" identity="SidebarGroupLabel" parent="none"]
-// CIL[DOC-MACRO purpose="Label for sidebar groups"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled label with optional slot rendering"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled label" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates label with optional slot rendering, styling and collapse behavior" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a grouping container for sidebar menu items'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarGroup:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarGroupLabel:component" type="component" identity="SidebarGroupLabel" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a label for a sidebar group with collapse behavior"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display the group heading and hide it in collapsed icon mode"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, asChild, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Uses Slot.Root or div and hides on icon-only sidebar" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarGroupLabel({
   className,
   asChild = false,
@@ -673,21 +651,22 @@ function SidebarGroupLabel({
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebargrouplabel_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebargroupaction_1783758409" type="function" identity="SidebarGroupAction" parent="none"]
-// CIL[DOC-MACRO purpose="Action button for sidebar groups"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled action button with optional slot rendering"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled action button" errors="none" side_effects="DOM events"]
-// CIL[DOC-MICRO logic_summary="Creates action button with optional slot rendering and hover states" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a label for a sidebar group with collapse behavior'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarGroupLabel:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarGroupAction:component" type="component" identity="SidebarGroupAction" parent="none"]
+// CIL[DOC-MACRO purpose="Renders an action button for a sidebar group"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose a small action button on a group header"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, asChild, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Uses Slot.Root or button and positions absolutely in the group header" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarGroupAction({
   className,
   asChild = false,
@@ -707,21 +686,22 @@ function SidebarGroupAction({
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebargroupaction_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebargroupcontent_1783758409" type="function" identity="SidebarGroupContent" parent="none"]
-// CIL[DOC-MACRO purpose="Content area for sidebar groups"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled container for group content items"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled content container" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates flex column container with full width and small text styling" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders an action button for a sidebar group'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarGroupAction:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarGroupContent:component" type="component" identity="SidebarGroupContent" parent="none"]
+// CIL[DOC-MACRO purpose="Renders the content wrapper for a sidebar group"]
+// CIL[DOC-RESPONSIBILITY responsibility="Wrap the children of a sidebar group"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards to a styled div" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarGroupContent({
   className,
   ...props
@@ -735,21 +715,22 @@ function SidebarGroupContent({
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebargroupcontent_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarmenu_1783758409" type="function" identity="SidebarMenu" parent="none"]
-// CIL[DOC-MACRO purpose="Menu container for sidebar navigation"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled list container for menu items"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled menu list" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates flex column list with full width and gap between items" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders the content wrapper for a sidebar group'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarGroupContent:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenu:component" type="component" identity="SidebarMenu" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a menu list inside the sidebar"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the unordered menu list of sidebar items"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards to a styled ul" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">) {
   return (
     <ul
@@ -760,21 +741,22 @@ function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">) {
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarmenu_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarmenuitem_1783758409" type="function" identity="SidebarMenuItem" parent="none"]
-// CIL[DOC-MACRO purpose="Menu item container for sidebar navigation"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled list item for menu entries"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled menu item" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates list item with relative positioning and group styling" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a menu list inside the sidebar'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenu:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuItem:component" type="component" identity="SidebarMenuItem" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a menu item wrapper inside the sidebar"]
+// CIL[DOC-RESPONSIBILITY responsibility="Wrap a single entry in the sidebar menu"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards to a styled li" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">) {
   return (
     <li
@@ -785,21 +767,23 @@ function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">) {
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarmenuitem_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarmenubuttonvariants_1783758409" type="variants" identity="sidebarMenuButtonVariants" parent="none"]
-// CIL[DOC-MACRO purpose="Define variants for sidebar menu button styling"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide CVA configuration for menu button variants"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="CVA variants" errors="none" side_effects="Variant definition"]
-// CIL[DOC-MICRO logic_summary="Defines base styles and variants for outline/default and size options" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a menu item wrapper inside the sidebar'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuItem:component"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:sidebarMenuButtonVariants:constant" type="constant" identity="sidebarMenuButtonVariants" parent="none"]
+// CIL[DOC-MACRO purpose="Defines the class-variance-authority variants for sidebar menu buttons"]
+// CIL[DOC-RESPONSIBILITY responsibility="Compute CSS class variants for menu button sizes and styles"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="cva variant function" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Builds cva variants for default and outline styles plus sizes" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const sidebarMenuButtonVariants = cva(
   "peer/menu-button group/menu-button flex w-full items-center gap-2 overflow-hidden rounded-[calc(var(--radius-sm)+2px)] p-2 text-left text-xs ring-sidebar-ring outline-hidden transition-[width,height,padding] group-has-data-[sidebar=menu-action]/menu-item:pr-8 group-data-[collapsible=icon]:size-8! group-data-[collapsible=icon]:p-2! 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 aria-disabled:pointer-events-none aria-disabled:opacity-50 data-open:hover:bg-sidebar-accent data-open:hover:text-sidebar-accent-foreground data-active:bg-sidebar-accent data-active:font-medium data-active:text-sidebar-accent-foreground [&_svg]:size-4 [&_svg]:shrink-0 [&>span:last-child]:truncate",
   {
@@ -821,21 +805,22 @@ const sidebarMenuButtonVariants = cva(
     },
   }
 )
-// CIL[END chunk_id="sidebar_sidebarmenubuttonvariants_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarmenubutton_1783758409" type="function" identity="SidebarMenuButton" parent="none"]
-// CIL[DOC-MACRO purpose="Menu button with tooltip support for sidebar"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled menu button with optional tooltip and variants"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled menu button" errors="none" side_effects="DOM events"]
-// CIL[DOC-MICRO logic_summary="Creates menu button with variants, tooltip support and responsive styling" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the class-variance-authority variants for sidebar menu buttons'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:sidebarMenuButtonVariants:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuButton:component" type="component" identity="SidebarMenuButton" parent="none"]
+// CIL[DOC-MACRO purpose="Renders an interactive sidebar menu button with optional tooltip"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the interactive menu button and optional collapsed tooltip"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="asChild, isActive, variant, size, tooltip, className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders the cva-styled button and wraps with tooltip when collapsed" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarMenuButton({
   asChild = false,
   isActive = false,
@@ -885,21 +870,22 @@ function SidebarMenuButton({
     </Tooltip>
   )
 }
-// CIL[END chunk_id="sidebar_sidebarmenubutton_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarmenuaction_1783758409" type="function" identity="SidebarMenuAction" parent="none"]
-// CIL[DOC-MACRO purpose="Action button for sidebar menu items"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled action button with optional slot rendering"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled action button" errors="none" side_effects="DOM events"]
-// CIL[DOC-MICRO logic_summary="Creates action button with optional slot rendering and hover visibility" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders an interactive sidebar menu button with optional tooltip'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuButton:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuAction:component" type="component" identity="SidebarMenuAction" parent="none"]
+// CIL[DOC-MACRO purpose="Renders an action button attached to a sidebar menu item"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a small action attached to a menu item, with hover reveal"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, asChild, showOnHover, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders an optional child or button and reveals on hover" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarMenuAction({
   className,
   asChild = false,
@@ -925,21 +911,22 @@ function SidebarMenuAction({
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarmenuaction_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarmenubadge_1783758409" type="function" identity="SidebarMenuBadge" parent="none"]
-// CIL[DOC-MACRO purpose="Badge indicator for sidebar menu items"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled badge with positioning and styling"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled badge" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates badge with absolute positioning, size and tabular number styling" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders an action button attached to a sidebar menu item'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuAction:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuBadge:component" type="component" identity="SidebarMenuBadge" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a badge indicator for a sidebar menu item"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display a numeric or status badge next to a menu item"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders a small badge with dynamic hover colors" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarMenuBadge({
   className,
   ...props
@@ -956,21 +943,22 @@ function SidebarMenuBadge({
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarmenubadge_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarmenuskeleton_1783758409" type="function" identity="SidebarMenuSkeleton" parent="none"]
-// CIL[DOC-MACRO purpose="Skeleton loader for sidebar menu items"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled skeleton with optional icon and random width"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled skeleton" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates skeleton with optional icon and random width between 50-90%" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a badge indicator for a sidebar menu item'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuBadge:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuSkeleton:component" type="component" identity="SidebarMenuSkeleton" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a placeholder skeleton loading row for sidebar menu items"]
+// CIL[DOC-RESPONSIBILITY responsibility="Show a loading placeholder for a menu item"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, showIcon, props" outputs="JSX element" errors="none" side_effects="uses Math.random to pick a skeleton width on mount"]
+// CIL[DOC-MICRO logic_summary="Renders icon and text skeletons with a randomized width" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarMenuSkeleton({
   className,
   showIcon = false,
@@ -1007,21 +995,22 @@ function SidebarMenuSkeleton({
     </div>
   )
 }
-// CIL[END chunk_id="sidebar_sidebarmenuskeleton_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarmenusub_1783758409" type="function" identity="SidebarMenuSub" parent="none"]
-// CIL[DOC-MACRO purpose="Sub-menu container for nested sidebar navigation"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled sub-menu with border and indentation"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled sub-menu" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates sub-menu with left border, padding and collapsed visibility" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a placeholder skeleton loading row for sidebar menu items'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuSkeleton:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuSub:component" type="component" identity="SidebarMenuSub" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a collapsible sub-menu list inside the sidebar"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render an indented sub-menu list"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders an indented bordered sub-list" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarMenuSub({ className, ...props }: React.ComponentProps<"ul">) {
   return (
     <ul
@@ -1035,21 +1024,22 @@ function SidebarMenuSub({ className, ...props }: React.ComponentProps<"ul">) {
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarmenusub_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarmenusubitem_1783758409" type="function" identity="SidebarMenuSubItem" parent="none"]
-// CIL[DOC-MACRO purpose="Sub-menu item container for nested navigation"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled list item for sub-menu entries"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled sub-menu item" errors="none" side_effects="DOM rendering"]
-// CIL[DOC-MICRO logic_summary="Creates list item with relative positioning and sub-menu styling" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a collapsible sub-menu list inside the sidebar'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuSub:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuSubItem:component" type="component" identity="SidebarMenuSubItem" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a sub-menu item wrapper"]
+// CIL[DOC-RESPONSIBILITY responsibility="Wrap a single sub-menu entry"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards to a styled li" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarMenuSubItem({
   className,
   ...props
@@ -1063,21 +1053,22 @@ function SidebarMenuSubItem({
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarmenusubitem_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_sidebarmenusubbutton_1783758409" type="function" identity="SidebarMenuSubButton" parent="none"]
-// CIL[DOC-MACRO purpose="Sub-menu button for nested sidebar navigation"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled sub-menu button with size and active states"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Styled sub-menu button" errors="none" side_effects="DOM events"]
-// CIL[DOC-MICRO logic_summary="Creates sub-menu button with size variants, active states and responsive styling" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a sub-menu item wrapper'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuSubItem:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuSubButton:component" type="component" identity="SidebarMenuSubButton" parent="none"]
+// CIL[DOC-MACRO purpose="Renders a button for a sub-menu item"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render an anchor-like sub-menu button"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="asChild, size, isActive, className, props" outputs="JSX element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders an anchor or child with size/active states" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function SidebarMenuSubButton({
   asChild = false,
   size = "md",
@@ -1105,21 +1096,21 @@ function SidebarMenuSubButton({
     />
   )
 }
-// CIL[END chunk_id="sidebar_sidebarmenusubbutton_1783758409"]
-// CIL[BEGIN chunk_id="sidebar_exports_1783758409" type="exports" identity="exports" parent="none"]
-// CIL[DOC-MACRO purpose="Export all sidebar components for public API"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide module exports for sidebar component library"]
-// CIL[DOC-CONTEXT module="sidebar" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Component exports" errors="none" side_effects="Module exports"]
-// CIL[DOC-MICRO logic_summary="Exports all sidebar components: Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, useSidebar" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui_components. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a button for a sub-menu item'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:SidebarMenuSubButton:component"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sidebar.tsx:module_exports:export" type="export" identity="module_exports" parent="none"]
+// CIL[DOC-MACRO purpose="Re-exports all public sidebar components, hooks, and helpers"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose all public sidebar symbols to consumers"]
+// CIL[DOC-CONTEXT module="sidebar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input.tsx,.framework/src/components/ui/separator.tsx,.framework/src/components/ui/sheet.tsx,.framework/src/components/ui/sidebar.tsx,.framework/src/components/ui/skeleton.tsx,.framework/src/components/ui/tooltip.tsx,.framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none (module re-exports)" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Lists every public component and hook in a single export block" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export {
   Sidebar,
   SidebarContent,
@@ -1146,4 +1137,10 @@ export {
   SidebarTrigger,
   useSidebar,
 }
-// CIL[END chunk_id="sidebar_exports_1783758409"]
+// CIL[DOC-VECTOR type="context" content="purpose='Re-exports all public sidebar components, hooks, and helpers'; No verified external callers; imports: .framework/src/hooks/use-mobile.ts,.framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/sidebar.tsx:module_exports:export"]