spine-framework 0.3.144 → 0.4.0

package/.framework/src/components/ui/navigation-menu.tsx

@@ -1,50 +1,36 @@
-
-
-
-
-
-
-
-
-
-
-
-// CIL[BEGIN chunk_id="navigation_menu_module_header_1783796064" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for navigation menu components"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import React, CVA, Radix UI, utilities, and icons"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="imported modules" errors="none" side_effects="module imports"]
-// CIL[DOC-MICRO logic_summary="Imports all dependencies for navigation menu component system" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/ui/navigation-menu.tsx"]
+// CIL[DOC-MACRO purpose="Declare dependencies and set up the NavigationMenu UI module"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import React, class-variance-authority, Radix primitives, utilities, and icons"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="loads module dependencies"]
+// CIL[DOC-MICRO logic_summary="Imports dependencies used by the NavigationMenu component set" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, \."]
-// 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"]
+// CIL[DOC-AUDIENCE audience="developers"]
+
 import * as React from "react"
 import { cva } from "class-variance-authority"
 import { NavigationMenu as NavigationMenuPrimitive } from "radix-ui"
 
 import { cn } from "@/lib/utils"
 import { ChevronDownIcon } from "lucide-react"
-// CIL[END chunk_id="navigation_menu_module_header_1783796064"]
-// CIL[BEGIN chunk_id="navigation_menu_navigationmenu_1783796064" type="function" identity="NavigationMenu" parent="none"]
-// CIL[DOC-MACRO purpose="Render main navigation menu container"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create navigation menu root with viewport support"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="navigation menu container" errors="none" side_effects="renders DOM element"]
-// CIL[DOC-MICRO logic_summary="Creates navigation menu root with optional viewport component" 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: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.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='Declare dependencies and set up the NavigationMenu UI module'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:navigationmenu:function" type="function" identity="navigationmenu" parent="~/.framework/src/components/ui/navigation-menu.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render a top-level navigation menu"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a Radix Root wrapper with an optional viewport"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/components/ui/navigation-menu.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, children, viewport, ...props" outputs="JSX navigation menu root" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders NavigationMenuPrimitive.Root, passes className and viewport flag, and conditionally renders the viewport" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function NavigationMenu({
   className,
   children,
@@ -68,21 +54,23 @@ function NavigationMenu({
     </NavigationMenuPrimitive.Root>
   )
 }
-// CIL[END chunk_id="navigation_menu_navigationmenu_1783796064"]
-// CIL[BEGIN chunk_id="navigation_menu_navigationmenulist_1783796064" type="function" identity="NavigationMenuList" parent="none"]
-// CIL[DOC-MACRO purpose="Render navigation menu list container"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create flex container for navigation menu items"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="navigation list container" errors="none" side_effects="renders DOM element"]
-// CIL[DOC-MICRO logic_summary="Creates flex container for horizontal navigation layout" 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: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.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='Render a top-level navigation menu'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:navigationmenu:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:navigationmenulist:function" type="function" identity="navigationmenulist" parent="~/.framework/src/components/ui/navigation-menu.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render a list of navigation menu items"]
+// CIL[DOC-RESPONSIBILITY responsibility="Wrap list items in a horizontally centered flex list"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/components/ui/navigation-menu.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props" outputs="JSX menu list" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders NavigationMenuPrimitive.List with flex, list-none, and gap utilities" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function NavigationMenuList({
   className,
   ...props
@@ -98,21 +86,23 @@ function NavigationMenuList({
     />
   )
 }
-// CIL[END chunk_id="navigation_menu_navigationmenulist_1783796064"]
-// CIL[BEGIN chunk_id="navigation_menu_navigationmenuitem_1783796064" type="function" identity="NavigationMenuItem" parent="none"]
-// CIL[DOC-MACRO purpose="Render navigation menu item container"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create container for individual navigation items"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="navigation item container" errors="none" side_effects="renders DOM element"]
-// CIL[DOC-MICRO logic_summary="Creates relative positioned container for navigation menu 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: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/TypeDetailPage.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='Render a list of navigation menu items'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:navigationmenulist:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:navigationmenuitem:function" type="function" identity="navigationmenuitem" parent="~/.framework/src/components/ui/navigation-menu.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render a single navigation menu item"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a relative-positioned Radix Item container"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/components/ui/navigation-menu.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props" outputs="JSX menu item" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders NavigationMenuPrimitive.Item with relative class and props" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function NavigationMenuItem({
   className,
   ...props
@@ -125,39 +115,43 @@ function NavigationMenuItem({
     />
   )
 }
-// CIL[END chunk_id="navigation_menu_navigationmenuitem_1783796064"]
-// CIL[BEGIN chunk_id="navigation_menu_navigationmenutriggerstyle_1783796064" type="cva" identity="navigationMenuTriggerStyle" parent="none"]
-// CIL[DOC-MACRO purpose="Define style variants for navigation menu triggers"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create CVA configuration for trigger styling"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="CVA variant configuration" errors="none" side_effects="defines styling variants"]
-// CIL[DOC-MICRO logic_summary="Defines comprehensive styling for navigation menu triggers" 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='Render a single navigation menu item'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:navigationmenuitem:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:navigationmenutriggerstyle:constant" type="constant" identity="navigationmenutriggerstyle" parent="~/.framework/src/components/ui/navigation-menu.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Provide the shared trigger style variant"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define cva classes for the navigation menu trigger button"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/components/ui/navigation-menu.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="string class variant" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Calls cva with a long tailwind class string for trigger styling" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 const navigationMenuTriggerStyle = cva(
   "group/navigation-menu-trigger inline-flex h-9 w-max items-center justify-center rounded-lg px-2.5 py-1.5 text-xs/relaxed font-medium transition-all outline-none hover:bg-muted focus:bg-muted focus-visible:ring-2 focus-visible:ring-ring/30 focus-visible:outline-1 disabled:pointer-events-none disabled:opacity-50 data-popup-open:bg-muted/50 data-popup-open:hover:bg-muted data-open:bg-muted/50 data-open:hover:bg-muted data-open:focus:bg-muted"
 )
-// CIL[END chunk_id="navigation_menu_navigationmenutriggerstyle_1783796064"]
-// CIL[BEGIN chunk_id="navigation_menu_navigationmenutrigger_1783796064" type="function" identity="NavigationMenuTrigger" parent="none"]
-// CIL[DOC-MACRO purpose="Render navigation menu trigger button"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create trigger with chevron icon and animations"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled trigger button" errors="none" side_effects="renders DOM element"]
-// CIL[DOC-MICRO logic_summary="Creates trigger button with rotating chevron 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='Provide the shared trigger style variant'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:navigationmenutriggerstyle:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:navigationmenutrigger:function" type="function" identity="navigationmenutrigger" parent="~/.framework/src/components/ui/navigation-menu.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render a trigger button for a navigation menu item"]
+// CIL[DOC-RESPONSIBILITY responsibility="Combine the trigger style with a chevron icon"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/components/ui/navigation-menu.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, children, ...props" outputs="JSX trigger" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders Radix Trigger using navigationMenuTriggerStyle and a ChevronDownIcon" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function NavigationMenuTrigger({
   className,
   children,
@@ -174,21 +168,23 @@ function NavigationMenuTrigger({
     </NavigationMenuPrimitive.Trigger>
   )
 }
-// CIL[END chunk_id="navigation_menu_navigationmenutrigger_1783796064"]
-// CIL[BEGIN chunk_id="navigation_menu_navigationmenucontent_1783796064" type="function" identity="NavigationMenuContent" parent="none"]
-// CIL[DOC-MACRO purpose="Render navigation menu content dropdown"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create styled content container with animations"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled content container" errors="none" side_effects="renders DOM element"]
-// CIL[DOC-MICRO logic_summary="Creates content dropdown with viewport-aware positioning 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='Render a trigger button for a navigation menu item'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:navigationmenutrigger:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:navigationmenucontent:function" type="function" identity="navigationmenucontent" parent="~/.framework/src/components/ui/navigation-menu.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render the dropdown content panel of a navigation menu"]
+// CIL[DOC-RESPONSIBILITY responsibility="Apply motion, position, and viewport-aware popover styles"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/components/ui/navigation-menu.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props" outputs="JSX content panel" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders Radix Content with complex data-state and viewport conditional classes" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function NavigationMenuContent({
   className,
   ...props
@@ -204,21 +200,23 @@ function NavigationMenuContent({
     />
   )
 }
-// CIL[END chunk_id="navigation_menu_navigationmenucontent_1783796064"]
-// CIL[BEGIN chunk_id="navigation_menu_navigationmenuviewport_1783796064" type="function" identity="NavigationMenuViewport" parent="none"]
-// CIL[DOC-MACRO purpose="Render navigation menu viewport container"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create viewport for dropdown content positioning"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled viewport container" errors="none" side_effects="renders DOM element"]
-// CIL[DOC-MICRO logic_summary="Creates positioned viewport with zoom animations for content" 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='Render the dropdown content panel of a navigation menu'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:navigationmenucontent:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:navigationmenuviewport:function" type="function" identity="navigationmenuviewport" parent="~/.framework/src/components/ui/navigation-menu.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render the viewport that positions menu content"]
+// CIL[DOC-RESPONSIBILITY responsibility="Center and contain the Radix Viewport"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/components/ui/navigation-menu.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props" outputs="JSX viewport" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Wraps Radix Viewport in a positioned div to center and size content" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function NavigationMenuViewport({
   className,
   ...props
@@ -240,21 +238,23 @@ function NavigationMenuViewport({
     </div>
   )
 }
-// CIL[END chunk_id="navigation_menu_navigationmenuviewport_1783796064"]
-// CIL[BEGIN chunk_id="navigation_menu_navigationmenulink_1783796064" type="function" identity="NavigationMenuLink" parent="none"]
-// CIL[DOC-MACRO purpose="Render navigation menu link component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create styled link for navigation menu items"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled link element" errors="none" side_effects="renders DOM element"]
-// CIL[DOC-MICRO logic_summary="Creates navigation link with hover states and active 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='Render the viewport that positions menu content'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:navigationmenuviewport:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:navigationmenulink:function" type="function" identity="navigationmenulink" parent="~/.framework/src/components/ui/navigation-menu.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render a navigation menu link"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a styled anchor for menu links"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/components/ui/navigation-menu.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props" outputs="JSX link" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders Radix Link with muted hover, focus, and active state classes" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function NavigationMenuLink({
   className,
   ...props
@@ -270,21 +270,23 @@ function NavigationMenuLink({
     />
   )
 }
-// CIL[END chunk_id="navigation_menu_navigationmenulink_1783796064"]
-// CIL[BEGIN chunk_id="navigation_menu_navigationmenuindicator_1783796064" type="function" identity="NavigationMenuIndicator" parent="none"]
-// CIL[DOC-MACRO purpose="Render navigation menu indicator element"]
-// CIL[DOC-RESPONSIBILITY responsibility="Create visual indicator for active menu item"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled indicator element" errors="none" side_effects="renders DOM element"]
-// CIL[DOC-MICRO logic_summary="Creates animated indicator with triangular design for active 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='Render a navigation menu link'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:navigationmenulink:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:navigationmenuindicator:function" type="function" identity="navigationmenuindicator" parent="~/.framework/src/components/ui/navigation-menu.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render a small triangle indicator under the active menu"]
+// CIL[DOC-RESPONSIBILITY responsibility="Show a pointer indicator aligned with the selected item"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/components/ui/navigation-menu.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props" outputs="JSX indicator" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders Radix Indicator with a small rotated square and state animations" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function NavigationMenuIndicator({
   className,
   ...props
@@ -302,21 +304,23 @@ function NavigationMenuIndicator({
     </NavigationMenuPrimitive.Indicator>
   )
 }
-// CIL[END chunk_id="navigation_menu_navigationmenuindicator_1783796064"]
-// CIL[BEGIN chunk_id="navigation_menu_exports_1783796064" type="exports" identity="exports" parent="none"]
-// CIL[DOC-MACRO purpose="Export navigation menu components for public use"]
-// CIL[DOC-RESPONSIBILITY responsibility="Export all navigation menu-related components"]
-// CIL[DOC-CONTEXT module="navigation-menu" layer="ui_components" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="exported components" errors="none" side_effects="module exports"]
-// CIL[DOC-MICRO logic_summary="Exports comprehensive navigation menu component system for consumption" 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='Render a small triangle indicator under the active menu'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:navigationmenuindicator:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/navigation-menu.tsx:module_exports:module_exports" type="module_exports" identity="module_exports" parent="~/.framework/src/components/ui/navigation-menu.tsx"]
+// CIL[DOC-MACRO purpose="Export all NavigationMenu subcomponents and styles"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose the public API of the module"]
+// CIL[DOC-CONTEXT module="NavigationMenu" layer="ui" related_files=".framework/src/components/ui/navigation-menu.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Named exports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Collects and re-exports all functions and the trigger style" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export {
   NavigationMenu,
   NavigationMenuList,
@@ -328,4 +332,10 @@ export {
   NavigationMenuViewport,
   navigationMenuTriggerStyle,
 }
-// CIL[END chunk_id="navigation_menu_exports_1783796064"]
+// CIL[DOC-VECTOR type="context" content="purpose='Export all NavigationMenu subcomponents and styles'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// 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/navigation-menu.tsx:module_exports:module_exports"]