spine-framework 0.3.144 → 0.4.0

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

@@ -1,47 +1,33 @@
-
-
-
-
-
-
-
-
-
-// CIL[BEGIN chunk_id="breadcrumb_module_header_1783881474" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Breadcrumb navigation component library with Radix integration"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide breadcrumb infrastructure and navigation utilities"]
-// CIL[DOC-CONTEXT module="ui.breadcrumb" layer="component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React, Slot, utils, navigation icons" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, Radix Slot, utility functions, and navigation icons" notable_decisions="['radix-ui integration', 'lucide icon usage', 'navigation pattern']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/breadcrumb.tsx:module_header:module_header" type="module_header" identity="module_header" parent=""]
+// CIL[DOC-MACRO purpose="Provides the set of breadcrumb UI primitives for navigation patterns."]
+// CIL[DOC-RESPONSIBILITY responsibility="Imports required dependencies and exports the breadcrumb component set."]
+// CIL[DOC-CONTEXT module="ui/breadcrumb" layer="components/ui" related_files=".framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="N/A" errors="N/A" side_effects="N/A"]
+// CIL[DOC-MICRO logic_summary="Imports React, radix Slot, local utils, and Lucide icons." 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: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/src/components/ui/dialog.tsx, 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="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="frontend-developers, ui-consumers"]
 import * as React from "react"
 import { Slot } from "radix-ui"
 
 import { cn } from "@/lib/utils"
 import { ChevronRightIcon, MoreHorizontalIcon } from "lucide-react"
-// CIL[END chunk_id="breadcrumb_module_header_1783881474"]
-// CIL[BEGIN chunk_id="breadcrumb_breadcrumb_1783881474" type="function" identity="Breadcrumb" parent="none"]
-// CIL[DOC-MACRO purpose="Main breadcrumb navigation container with accessibility"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide semantic breadcrumb navigation wrapper"]
-// CIL[DOC-CONTEXT module="ui.breadcrumb" layer="component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="semantic nav element" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Wraps nav element with proper ARIA label and slot attribution" notable_decisions="['semantic HTML', 'accessibility attributes', 'slot pattern']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .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='Provides the set of breadcrumb UI primitives for navigation patterns.'; 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/breadcrumb.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/breadcrumb.tsx:breadcrumb:function" type="function" identity="Breadcrumb" parent="~/.framework/src/components/ui/breadcrumb.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a semantic <nav> wrapper for breadcrumb navigation."]
+// CIL[DOC-RESPONSIBILITY responsibility="Wraps children in a nav element with an accessible aria-label."]
+// CIL[DOC-CONTEXT module="ui/breadcrumb" layer="components/ui" related_files=".framework/src/components/ui/breadcrumb.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className?: string, props: React.ComponentProps<'nav'>" outputs="JSX.Element" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Returns a nav element with aria-label=breadcrumb and merged className via cn." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function Breadcrumb({ className, ...props }: React.ComponentProps<"nav">) {
   return (
     <nav
@@ -52,21 +38,22 @@ function Breadcrumb({ className, ...props }: React.ComponentProps<"nav">) {
     />
   )
 }
-// CIL[END chunk_id="breadcrumb_breadcrumb_1783881474"]
-// CIL[BEGIN chunk_id="breadcrumb_breadcrumblist_1783881474" type="function" identity="BreadcrumbList" parent="none"]
-// CIL[DOC-MACRO purpose="Breadcrumb list container with responsive layout"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled ordered list for breadcrumb items"]
-// CIL[DOC-CONTEXT module="ui.breadcrumb" layer="component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled ol element" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Applies flex layout with responsive wrapping and text styling" notable_decisions="['flex layout', 'responsive design', 'text handling']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 1. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 2."]
-// 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 semantic <nav> wrapper for breadcrumb navigation.'; 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/breadcrumb.tsx:breadcrumb:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/breadcrumb.tsx:breadcrumblist:function" type="function" identity="BreadcrumbList" parent="~/.framework/src/components/ui/breadcrumb.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the ordered list of breadcrumb items."]
+// CIL[DOC-RESPONSIBILITY responsibility="Displays an ordered list styled for breadcrumb navigation."]
+// CIL[DOC-CONTEXT module="ui/breadcrumb" layer="components/ui" related_files=".framework/src/components/ui/breadcrumb.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className?: string, props: React.ComponentProps<'ol'>" outputs="JSX.Element" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Returns an ol element with flex wrap and muted-foreground styling." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function BreadcrumbList({ className, ...props }: React.ComponentProps<"ol">) {
   return (
     <ol
@@ -79,21 +66,22 @@ function BreadcrumbList({ className, ...props }: React.ComponentProps<"ol">) {
     />
   )
 }
-// CIL[END chunk_id="breadcrumb_breadcrumblist_1783881474"]
-// CIL[BEGIN chunk_id="breadcrumb_breadcrumbitem_1783881474" type="function" identity="BreadcrumbItem" parent="none"]
-// CIL[DOC-MACRO purpose="Individual breadcrumb item with inline layout"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled list item for breadcrumb navigation"]
-// CIL[DOC-CONTEXT module="ui.breadcrumb" layer="component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled li element" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Applies inline flex layout with consistent spacing for items" notable_decisions="['inline layout', 'consistent spacing pattern']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 1. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 2."]
-// 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 ordered list of breadcrumb 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/breadcrumb.tsx:breadcrumblist:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/breadcrumb.tsx:breadcrumbitem:function" type="function" identity="BreadcrumbItem" parent="~/.framework/src/components/ui/breadcrumb.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a single item in the breadcrumb list."]
+// CIL[DOC-RESPONSIBILITY responsibility="Represents one breadcrumb entry as an inline list item."]
+// CIL[DOC-CONTEXT module="ui/breadcrumb" layer="components/ui" related_files=".framework/src/components/ui/breadcrumb.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className?: string, props: React.ComponentProps<'li'>" outputs="JSX.Element" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Returns an li element with inline-flex gap styling." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function BreadcrumbItem({ className, ...props }: React.ComponentProps<"li">) {
   return (
     <li
@@ -103,21 +91,22 @@ function BreadcrumbItem({ className, ...props }: React.ComponentProps<"li">) {
     />
   )
 }
-// CIL[END chunk_id="breadcrumb_breadcrumbitem_1783881474"]
-// CIL[BEGIN chunk_id="breadcrumb_breadcrumblink_1783881474" type="function" identity="BreadcrumbLink" parent="none"]
-// CIL[DOC-MACRO purpose="Breadcrumb link with composition support and hover styling"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled navigation link with asChild pattern"]
-// CIL[DOC-CONTEXT module="ui.breadcrumb" layer="component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled link or Slot component" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Uses Radix Slot for composition, applies hover color transitions" notable_decisions="['composition pattern', 'hover state styling', 'slot integration']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. 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 single item in the breadcrumb list.'; 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/breadcrumb.tsx:breadcrumbitem:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/breadcrumb.tsx:breadcrumblink:function" type="function" identity="BreadcrumbLink" parent="~/.framework/src/components/ui/breadcrumb.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a clickable link within a breadcrumb item."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides a navigational link or slottable anchor for a breadcrumb item."]
+// CIL[DOC-CONTEXT module="ui/breadcrumb" layer="components/ui" related_files=".framework/src/components/ui/breadcrumb.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="asChild?: boolean, className?: string, props: React.ComponentProps<'a'>" outputs="JSX.Element" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Selects between Slot.Root or an a tag based on asChild, applies hover classes." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function BreadcrumbLink({
   asChild,
   className,
@@ -135,21 +124,22 @@ function BreadcrumbLink({
     />
   )
 }
-// CIL[END chunk_id="breadcrumb_breadcrumblink_1783881474"]
-// CIL[BEGIN chunk_id="breadcrumb_breadcrumbpage_1783881474" type="function" identity="BreadcrumbPage" parent="none"]
-// CIL[DOC-MACRO purpose="Current page indicator with semantic styling"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled span for current breadcrumb page"]
-// CIL[DOC-CONTEXT module="ui.breadcrumb" layer="component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled span element" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Applies semantic attributes and foreground color for current page" notable_decisions="['semantic HTML', 'accessibility attributes', 'visual hierarchy']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. 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 clickable link within a breadcrumb 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/breadcrumb.tsx:breadcrumblink:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/breadcrumb.tsx:breadcrumbpage:function" type="function" identity="BreadcrumbPage" parent="~/.framework/src/components/ui/breadcrumb.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the current page segment in a breadcrumb."]
+// CIL[DOC-RESPONSIBILITY responsibility="Displays the active page with current-page semantics."]
+// CIL[DOC-CONTEXT module="ui/breadcrumb" layer="components/ui" related_files=".framework/src/components/ui/breadcrumb.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className?: string, props: React.ComponentProps<'span'>" outputs="JSX.Element" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Returns a span with role=link, aria-current=page, and foreground styling." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function BreadcrumbPage({ className, ...props }: React.ComponentProps<"span">) {
   return (
     <span
@@ -162,21 +152,22 @@ function BreadcrumbPage({ className, ...props }: React.ComponentProps<"span">) {
     />
   )
 }
-// CIL[END chunk_id="breadcrumb_breadcrumbpage_1783881474"]
-// CIL[BEGIN chunk_id="breadcrumb_breadcrumbseparator_1783881474" type="function" identity="BreadcrumbSeparator" parent="none"]
-// CIL[DOC-MACRO purpose="Breadcrumb separator with default chevron icon"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide visual separator between breadcrumb items"]
-// CIL[DOC-CONTEXT module="ui.breadcrumb" layer="component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="separator li element" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Uses semantic presentation role with customizable icon fallback" notable_decisions="['semantic HTML', 'icon fallback pattern', 'accessibility attributes']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. 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 current page segment in a breadcrumb.'; 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/breadcrumb.tsx:breadcrumbpage:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/breadcrumb.tsx:breadcrumbseparator:function" type="function" identity="BreadcrumbSeparator" parent="~/.framework/src/components/ui/breadcrumb.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a visual separator between breadcrumb items."]
+// CIL[DOC-RESPONSIBILITY responsibility="Separates breadcrumb items with a chevron icon."]
+// CIL[DOC-CONTEXT module="ui/breadcrumb" layer="components/ui" related_files=".framework/src/components/ui/breadcrumb.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="children?: React.ReactNode, className?: string, props: React.ComponentProps<'li'>" outputs="JSX.Element" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Returns an li with role=presentation, renders ChevronRightIcon by default." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function BreadcrumbSeparator({
   children,
   className,
@@ -196,21 +187,22 @@ function BreadcrumbSeparator({
     </li>
   )
 }
-// CIL[END chunk_id="breadcrumb_breadcrumbseparator_1783881474"]
-// CIL[BEGIN chunk_id="breadcrumb_breadcrumbellipsis_1783881474" type="function" identity="BreadcrumbEllipsis" parent="none"]
-// CIL[DOC-MACRO purpose="Breadcrumb ellipsis indicator with accessibility support"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide visual indicator for collapsed breadcrumb items"]
-// CIL[DOC-CONTEXT module="ui.breadcrumb" layer="component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ellipsis span element" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Uses semantic presentation role with icon and screen reader text" notable_decisions="['semantic HTML', 'accessibility support', 'icon integration']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. 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 visual separator between breadcrumb 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/breadcrumb.tsx:breadcrumbseparator:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/breadcrumb.tsx:breadcrumbellipsis:function" type="function" identity="BreadcrumbEllipsis" parent="~/.framework/src/components/ui/breadcrumb.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a collapsed-overflow indicator for long breadcrumbs."]
+// CIL[DOC-RESPONSIBILITY responsibility="Indicates collapsed breadcrumb items while preserving screen-reader text."]
+// CIL[DOC-CONTEXT module="ui/breadcrumb" layer="components/ui" related_files=".framework/src/components/ui/breadcrumb.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className?: string, props: React.ComponentProps<'span'>" outputs="JSX.Element" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Returns a span with MoreHorizontalIcon and an sr-only More label." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function BreadcrumbEllipsis({
   className,
   ...props
@@ -232,21 +224,22 @@ function BreadcrumbEllipsis({
     </span>
   )
 }
-// CIL[END chunk_id="breadcrumb_breadcrumbellipsis_1783881474"]
-// CIL[BEGIN chunk_id="breadcrumb_exports_1783881474" type="exports" identity="exports" parent="none"]
-// CIL[DOC-MACRO purpose="Export breadcrumb components for public API"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide public interface for breadcrumb component library"]
-// CIL[DOC-CONTEXT module="ui.breadcrumb" layer="component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="all breadcrumb components" errors="none" side_effects="module exports"]
-// CIL[DOC-MICRO logic_summary="Exports comprehensive breadcrumb component set for navigation" notable_decisions="['comprehensive export strategy', 'navigation component library']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. 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 collapsed-overflow indicator for long breadcrumbs.'; 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/breadcrumb.tsx:breadcrumbellipsis:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/breadcrumb.tsx:module_exports:module_exports" type="module_exports" identity="module_exports" parent="~/.framework/src/components/ui/breadcrumb.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Re-exports the public breadcrumb component set for consumers."]
+// CIL[DOC-RESPONSIBILITY responsibility="Exposes named component exports from the breadcrumb module."]
+// CIL[DOC-CONTEXT module="ui/breadcrumb" layer="components/ui" related_files=".framework/src/components/ui/breadcrumb.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="N/A" outputs="Named component exports" errors="None" side_effects="None"]
+// CIL[DOC-MICRO logic_summary="Lists the named component exports in a single export block." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export {
   Breadcrumb,
   BreadcrumbList,
@@ -256,4 +249,10 @@ export {
   BreadcrumbSeparator,
   BreadcrumbEllipsis,
 }
-// CIL[END chunk_id="breadcrumb_exports_1783881474"]
+// CIL[DOC-VECTOR type="context" content="purpose='Re-exports the public breadcrumb component set for consumers.'; 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/breadcrumb.tsx:module_exports:module_exports"]

package/.framework/src/components/ui/button-group.tsx

@@ -1,29 +1,33 @@
-
-
-
-
-
-// CIL[BEGIN chunk_id="button-group_module_header_1783881474" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Button group component with orientation-aware styling using CVA"]
-// CIL[DOC-RESPONSIBILITY responsibility="Define button group variants and component infrastructure"]
-// CIL[DOC-CONTEXT module="ui.button-group" layer="component" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="buttonGroupVariants, CVA, Slot, Separator" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Creates orientation-aware button group variant system with complex border management" notable_decisions="['class-variance-authority pattern', 'complex CSS selector system', 'orientation-aware styling']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/button-group.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import CVA, Radix Slot, and project utilities for the ButtonGroup UI component set"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide shared imports and dependencies for button group building blocks"]
+// CIL[DOC-CONTEXT module="components/ui/button-group" layer="ui" related_files=".framework/src/components/ui/separator.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imported utilities and dependencies" errors="none" side_effects="adds module dependencies"]
+// CIL[DOC-MICRO logic_summary="Imports class-variance-authority, Radix Slot, cn utility, and the Separator component" 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: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.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="ui component consumers and maintainers"]
 import { cva, type VariantProps } from "class-variance-authority"
 import { Slot } from "radix-ui"
 
 import { cn } from "@/lib/utils"
 import { Separator } from "@/components/ui/separator"
+// CIL[DOC-VECTOR type="context" content="purpose='Import CVA, Radix Slot, and project utilities for the ButtonGroup UI component set'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/separator.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/button-group.tsx:module_header:module_header"]
 
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/button-group.tsx:buttongroupvariants:constant" type="constant" identity="buttonGroupVariants" parent="none"]
+// CIL[DOC-MACRO purpose="Define the class-variance-authority variant map for ButtonGroup styling"]
+// CIL[DOC-RESPONSIBILITY responsibility="Generate CSS classes for horizontal and vertical button group orientations"]
+// CIL[DOC-CONTEXT module="components/ui/button-group" layer="ui" related_files=".framework/src/components/ui/button-group.tsx,.framework/src/components/ui/separator.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="props: { orientation?: 'horizontal' | 'vertical' }" outputs="Tailwind class string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Combines a base flex layout with orientation-specific border rounding, gap, and focus rules" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const buttonGroupVariants = cva(
   "group/button-group flex w-fit items-stretch *:focus-visible:relative *:focus-visible:z-10 has-[>[data-slot=button-group]]:gap-2 has-[select[aria-hidden=true]:last-child]:[&>[data-slot=select-trigger]:last-of-type]:rounded-r-md [&>[data-slot=select-trigger]:not([class*='w-'])]:w-fit [&>input]:flex-1",
   {
@@ -40,21 +44,22 @@ const buttonGroupVariants = cva(
     },
   }
 )
-// CIL[END chunk_id="button-group_module_header_1783881474"]
-// CIL[BEGIN chunk_id="button-group_buttongroup_1783881474" type="function" identity="ButtonGroup" parent="none"]
-// CIL[DOC-MACRO purpose="Main button group container with orientation support"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render styled button group with semantic grouping and orientation"]
-// CIL[DOC-CONTEXT module="ui.button-group" layer="component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled button group container" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Applies CVA variants, sets semantic group role, handles orientation" notable_decisions="['semantic HTML', 'CVA integration', 'orientation handling']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.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='Define the class-variance-authority variant map for ButtonGroup styling'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/separator.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/button-group.tsx:buttongroupvariants:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/button-group.tsx:buttongroup:function" type="function" identity="ButtonGroup" parent="none"]
+// CIL[DOC-MACRO purpose="Render a container that groups child buttons with role, data-slot, and orientation styling"]
+// CIL[DOC-RESPONSIBILITY responsibility="Apply buttonGroupVariants classes and data attributes to a group div"]
+// CIL[DOC-CONTEXT module="components/ui/button-group" layer="ui" related_files=".framework/src/components/ui/button-group.tsx,.framework/src/components/ui/separator.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className: string | undefined, orientation: 'horizontal' | 'vertical' | undefined, ...props: React.ComponentProps<'div'> & VariantProps<typeof buttonGroupVariants>" outputs="JSX div" errors="prop type mismatch" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Applies cva-generated classes, role='group', and data-orientation; passes remaining props through" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ButtonGroup({
   className,
   orientation,
@@ -70,21 +75,22 @@ function ButtonGroup({
     />
   )
 }
-// CIL[END chunk_id="button-group_buttongroup_1783881474"]
-// CIL[BEGIN chunk_id="button-group_buttongrouptext_1783881474" type="function" identity="ButtonGroupText" parent="none"]
-// CIL[DOC-MACRO purpose="Button group text with composition support and styling"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled text content with asChild pattern for button groups"]
-// CIL[DOC-CONTEXT module="ui.button-group" layer="component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled text or Slot component" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Uses Radix Slot for composition, applies muted styling with icon handling" notable_decisions="['composition pattern', 'muted styling', 'icon integration']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.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 container that groups child buttons with role, data-slot, and orientation styling'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/separator.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/button-group.tsx:buttongroup:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/button-group.tsx:buttongrouptext:function" type="function" identity="ButtonGroupText" parent="none"]
+// CIL[DOC-MACRO purpose="Render a compact text or metadata element inside a button group"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a muted, rounded label slot with optional Slot.Root composition"]
+// CIL[DOC-CONTEXT module="components/ui/button-group" layer="ui" related_files=".framework/src/components/ui/button-group.tsx,.framework/src/components/ui/separator.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className: string | undefined, asChild: boolean, ...props: React.ComponentProps<'div'> & { asChild?: boolean }" outputs="JSX div or Slot.Root" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Chooses Slot.Root when asChild is true; applies muted, rounded, small text styles" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ButtonGroupText({
   className,
   asChild = false,
@@ -104,21 +110,22 @@ function ButtonGroupText({
     />
   )
 }
-// CIL[END chunk_id="button-group_buttongrouptext_1783881474"]
-// CIL[BEGIN chunk_id="button-group_buttongroupseparator_1783881474" type="function" identity="ButtonGroupSeparator" parent="none"]
-// CIL[DOC-MACRO purpose="Button group separator with orientation-aware styling"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled separator for button groups with orientation support"]
-// CIL[DOC-CONTEXT module="ui.button-group" layer="component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled separator component" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Wraps Separator with orientation-specific styling and data attributes" notable_decisions="['separator wrapper pattern', 'orientation-aware styling', 'data attributes']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/principal.ts, .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 compact text or metadata element inside a button group'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/separator.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/button-group.tsx:buttongrouptext:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/button-group.tsx:buttongroupseparator:function" type="function" identity="ButtonGroupSeparator" parent="none"]
+// CIL[DOC-MACRO purpose="Render a visual separator between items in a button group"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a stretchable Separator with theme-aware input background"]
+// CIL[DOC-CONTEXT module="components/ui/button-group" layer="ui" related_files=".framework/src/components/ui/button-group.tsx,.framework/src/components/ui/separator.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className: string | undefined, orientation: 'horizontal' | 'vertical' | undefined, ...props: React.ComponentProps<typeof Separator>" outputs="JSX Separator" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Renders a Separator with data-slot and orientation-aware background utility classes" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ButtonGroupSeparator({
   className,
   orientation = "vertical",
@@ -136,25 +143,32 @@ function ButtonGroupSeparator({
     />
   )
 }
-// CIL[END chunk_id="button-group_buttongroupseparator_1783881474"]
-// CIL[BEGIN chunk_id="button-group_exports_1783881474" type="exports" identity="exports" parent="none"]
-// CIL[DOC-MACRO purpose="Export button group components and variants for public API"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide public interface for button group component library"]
-// CIL[DOC-CONTEXT module="ui.button-group" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="button group components and variants" errors="none" side_effects="module exports"]
-// CIL[DOC-MICRO logic_summary="Exports all button group components and variants for customization" notable_decisions="['export variants for customization', 'named exports pattern']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.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="context" content="purpose='Render a visual separator between items in a button group'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/separator.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/button-group.tsx:buttongroupseparator:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/button-group.tsx:module_exports:module_exports" type="module_exports" identity="module_exports" parent="none"]
+// CIL[DOC-MACRO purpose="Expose the ButtonGroup, ButtonGroupText, ButtonGroupSeparator, and buttonGroupVariants API"]
+// CIL[DOC-RESPONSIBILITY responsibility="Named export of the public button-group module members"]
+// CIL[DOC-CONTEXT module="components/ui/button-group" layer="ui" related_files=".framework/src/components/ui/button-group.tsx,.framework/src/components/ui/separator.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="named exports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Re-exports all component pieces from this module as named exports" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export {
   ButtonGroup,
   ButtonGroupSeparator,
   ButtonGroupText,
   buttonGroupVariants,
 }
-// CIL[END chunk_id="button-group_exports_1783881474"]
+// CIL[DOC-VECTOR type="context" content="purpose='Expose the ButtonGroup, ButtonGroupText, ButtonGroupSeparator, and buttonGroupVariants API'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/separator.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/button-group.tsx:module_exports:module_exports"]