spine-framework 0.3.124 → 0.3.126

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

@@ -1,3 +1,48 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+// 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"
@@ -21,14 +66,42 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 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
@@ -38,9 +111,37 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function useSidebar() {
   const context = React.useContext(SidebarContext)
   if (!context) {
@@ -49,7 +150,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarProvider({
   defaultOpen = true,
   open: openProp,
@@ -66,8 +181,6 @@ function SidebarProvider({
   const isMobile = useIsMobile()
   const [openMobile, setOpenMobile] = React.useState(false)
 
-  // This is the internal state of the sidebar.
-  // We use openProp and setOpenProp for control from outside the component.
   const [_open, _setOpen] = React.useState(defaultOpen)
   const open = openProp ?? _open
   const setOpen = React.useCallback(
@@ -79,18 +192,15 @@ function SidebarProvider({
         _setOpen(openState)
       }
 
-      // This sets the cookie to keep the sidebar state.
       document.cookie = `${SIDEBAR_COOKIE_NAME}=${openState}; path=/; max-age=${SIDEBAR_COOKIE_MAX_AGE}`
     },
     [setOpenProp, open]
   )
 
-  // Helper to toggle the sidebar.
   const toggleSidebar = React.useCallback(() => {
     return isMobile ? setOpenMobile((open) => !open) : setOpen((open) => !open)
   }, [isMobile, setOpen, setOpenMobile])
 
-  // Adds a keyboard shortcut to toggle the sidebar.
   React.useEffect(() => {
     const handleKeyDown = (event: KeyboardEvent) => {
       if (
@@ -106,8 +216,6 @@ function SidebarProvider({
     return () => window.removeEventListener("keydown", handleKeyDown)
   }, [toggleSidebar])
 
-  // We add a state so that we can do data-state="expanded" or "collapsed".
-  // This makes it easier to style the sidebar with Tailwind classes.
   const state = open ? "expanded" : "collapsed"
 
   const contextValue = React.useMemo<SidebarContextProps>(
@@ -145,7 +253,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function Sidebar({
   side = "left",
   variant = "sidebar",
@@ -228,7 +350,6 @@ function Sidebar({
         data-side={side}
         className={cn(
           "fixed inset-y-0 z-10 hidden h-svh w-(--sidebar-width) transition-[left,right,width] duration-200 ease-linear data-[side=left]:left-0 data-[side=left]:group-data-[collapsible=offcanvas]:left-[calc(var(--sidebar-width)*-1)] data-[side=right]:right-0 data-[side=right]:group-data-[collapsible=offcanvas]:right-[calc(var(--sidebar-width)*-1)] md:flex",
-          // Adjust the padding for floating and inset variants.
           variant === "floating" || variant === "inset"
             ? "p-2 group-data-[collapsible=icon]:w-[calc(var(--sidebar-width-icon)+(--spacing(4))+2px)]"
             : "group-data-[collapsible=icon]:w-(--sidebar-width-icon) group-data-[side=left]:border-r group-data-[side=right]:border-l",
@@ -247,7 +368,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarTrigger({
   className,
   onClick,
@@ -273,7 +408,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarRail({ className, ...props }: React.ComponentProps<"button">) {
   const { toggleSidebar } = useSidebar()
 
@@ -298,7 +447,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarInset({ className, ...props }: React.ComponentProps<"main">) {
   return (
     <main
@@ -311,7 +474,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarInput({
   className,
   ...props
@@ -328,7 +505,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarHeader({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -339,7 +530,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarFooter({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -350,7 +555,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarSeparator({
   className,
   ...props
@@ -364,7 +583,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarContent({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -378,7 +611,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarGroup({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -392,7 +639,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarGroupLabel({
   className,
   asChild = false,
@@ -412,7 +673,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarGroupAction({
   className,
   asChild = false,
@@ -432,7 +707,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarGroupContent({
   className,
   ...props
@@ -446,7 +735,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarMenu({ className, ...props }: React.ComponentProps<"ul">) {
   return (
     <ul
@@ -457,7 +760,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarMenuItem({ className, ...props }: React.ComponentProps<"li">) {
   return (
     <li
@@ -468,7 +785,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 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",
   {
@@ -490,7 +821,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarMenuButton({
   asChild = false,
   isActive = false,
@@ -540,7 +885,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarMenuAction({
   className,
   asChild = false,
@@ -566,7 +925,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarMenuBadge({
   className,
   ...props
@@ -583,7 +956,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarMenuSkeleton({
   className,
   showIcon = false,
@@ -591,7 +978,6 @@ function SidebarMenuSkeleton({
 }: React.ComponentProps<"div"> & {
   showIcon?: boolean
 }) {
-  // Random width between 50 to 90%.
   const [width] = React.useState(() => {
     return `${Math.floor(Math.random() * 40) + 50}%`
   })
@@ -621,7 +1007,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarMenuSub({ className, ...props }: React.ComponentProps<"ul">) {
   return (
     <ul
@@ -635,7 +1035,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarMenuSubItem({
   className,
   ...props
@@ -649,7 +1063,21 @@ 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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function SidebarMenuSubButton({
   asChild = false,
   size = "md",
@@ -677,7 +1105,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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export {
   Sidebar,
   SidebarContent,
@@ -704,3 +1146,4 @@ export {
   SidebarTrigger,
   useSidebar,
 }
+// CIL[END chunk_id="sidebar_exports_1783758409"]