spine-framework 0.3.144 → 0.4.0

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

@@ -1,3 +1,11 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:use_client:directive" type="directive" identity="use_client" parent="none"]
+// CIL[DOC-MACRO purpose="Marks this module for client-side rendering in Next.js"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare the use client directive at the top of the file"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="client rendering directive" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Contains the 'use client' string required by Next.js for client components." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 
 
 
@@ -17,22 +25,24 @@
 
 
 
-// CIL[BEGIN chunk_id="combobox_module_header_1783844098" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for combobox components"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import React, Base UI primitives and UI components"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React, Base UI primitives, UI components" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, Base UI Combobox primitives, input groups and icons" 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. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/layout/Sidebar.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."]
+
+"use client"
+// CIL[DOC-VECTOR type="context" content="purpose='Marks this module for client-side rendering in Next.js'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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"]
-"use client"
+// CIL[END stable_id="~/.framework/src/components/ui/combobox.tsx:use_client:directive"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Provides the Combobox UI components built on Base UI for the shadcn/ui design system"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import combobox dependencies and re-export the public Combobox component surface"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imports and component exports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Sets up React, Base UI Combobox, utility, Button, InputGroup, and icon imports used by all combobox subcomponents." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="frontend-developers"]
 import * as React from "react"
 import { Combobox as ComboboxPrimitive } from "@base-ui/react"
 import { cn } from "@/lib/utils"
@@ -44,55 +54,58 @@ import {
   InputGroupInput,
 } from "@/components/ui/input-group"
 import { ChevronDownIcon, XIcon, CheckIcon } from "lucide-react"
-// CIL[END chunk_id="combobox_module_header_1783844098"]
-// CIL[BEGIN chunk_id="combobox_combobox_1783844098" type="const" identity="Combobox" parent="none"]
-// CIL[DOC-MACRO purpose="Root combobox component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide Base UI Combobox root primitive"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Combobox root primitive" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Direct alias to Base UI ComboboxPrimitive.Root" 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. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/layout/Sidebar.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="context" content="purpose='Provides the Combobox UI components built on Base UI for the shadcn/ui design system'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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"]
-const Combobox = ComboboxPrimitive.Root
-// CIL[END chunk_id="combobox_combobox_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxvalue_1783844098" type="function" identity="ComboboxValue" parent="none"]
-// CIL[DOC-MACRO purpose="Combobox value display component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render hidden value storage for combobox"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="value storage" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Wraps Base UI Value primitive with data-slot attribute" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[END stable_id="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:combobox:constant" type="constant" identity="combobox" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Assigns ComboboxPrimitive.Root to a local Combobox constant"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose the root Combobox component under a concise local alias"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Combobox constant alias" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Aliases ComboboxPrimitive.Root as Combobox for the public API." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/layout/Sidebar.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.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."]
+const Combobox = ComboboxPrimitive.Root
+// CIL[DOC-VECTOR type="context" content="purpose='Assigns ComboboxPrimitive.Root to a local Combobox constant'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:combobox:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxValue:component" type="component" identity="ComboboxValue" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the selected value display inside a combobox"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a styled ComboboxPrimitive.Value wrapper"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="...props from ComboboxPrimitive.Value.Props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Spreads props onto ComboboxPrimitive.Value with a data-slot attribute." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxValue({ ...props }: ComboboxPrimitive.Value.Props) {
   return <ComboboxPrimitive.Value data-slot="combobox-value" {...props} />
 }
-// CIL[END chunk_id="combobox_comboboxvalue_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxtrigger_1783844098" type="function" identity="ComboboxTrigger" parent="none"]
-// CIL[DOC-MACRO purpose="Combobox dropdown trigger"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide trigger button with chevron icon"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="trigger with icon" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates trigger with chevron down icon and icon sizing" 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. Direct callers: 0. Direct calls: 0. Related files: \."]
-// 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 selected value display inside a combobox'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxValue:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxTrigger:component" type="component" identity="ComboboxTrigger" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the combobox trigger button with a chevron icon"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a trigger element that opens the combobox popup"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, children, ...props and trigger props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Wraps ComboboxPrimitive.Trigger with cn utilities and appends a ChevronDownIcon." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxTrigger({
   className,
   children,
@@ -109,21 +122,22 @@ function ComboboxTrigger({
     </ComboboxPrimitive.Trigger>
   )
 }
-// CIL[END chunk_id="combobox_comboboxtrigger_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxclear_1783844098" type="function" identity="ComboboxClear" parent="none"]
-// CIL[DOC-MACRO purpose="Combobox clear button"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide clear button with X icon for resetting selection"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="clear button" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates ghost button with X icon using InputGroupButton" 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. Direct callers: 0. Direct calls: 0. Related files: \."]
-// 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 combobox trigger button with a chevron icon'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxTrigger:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxClear:component" type="component" identity="ComboboxClear" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a clear button for the combobox selection"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render an accessible clear control as an InputGroupButton"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props and clear props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders ComboboxPrimitive.Clear using an icon ghost button and an XIcon." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxClear({ className, ...props }: ComboboxPrimitive.Clear.Props) {
   return (
     <ComboboxPrimitive.Clear
@@ -136,21 +150,22 @@ function ComboboxClear({ className, ...props }: ComboboxPrimitive.Clear.Props) {
     </ComboboxPrimitive.Clear>
   )
 }
-// CIL[END chunk_id="combobox_comboboxclear_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxinput_1783844098" type="function" identity="ComboboxInput" parent="none"]
-// CIL[DOC-MACRO purpose="Combobox input with optional trigger and clear"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide input field with conditional trigger and clear buttons"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="input group" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates InputGroup with conditional trigger and clear button addons" 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. 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 clear button for the combobox selection'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxClear:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxInput:component" type="component" identity="ComboboxInput" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the combobox text input with optional trigger and clear controls"]
+// CIL[DOC-RESPONSIBILITY responsibility="Compose an InputGroup with the primitive input, trigger and clear addons"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, children, disabled, showTrigger, showClear and input props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Assembles an InputGroup around ComboboxPrimitive.Input and conditionally renders a ComboboxTrigger and ComboboxClear." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxInput({
   className,
   children,
@@ -187,21 +202,22 @@ function ComboboxInput({
     </InputGroup>
   )
 }
-// CIL[END chunk_id="combobox_comboboxinput_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxcontent_1783844098" type="function" identity="ComboboxContent" parent="none"]
-// CIL[DOC-MACRO purpose="Combobox dropdown content container"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide positioned popup container for dropdown items"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="popup container" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates positioned popup with animations and responsive sizing" 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. 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 combobox text input with optional trigger and clear controls'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxInput:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxContent:component" type="component" identity="ComboboxContent" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the combobox popup content with positioning"]
+// CIL[DOC-RESPONSIBILITY responsibility="Portal and position the popup surface for the combobox list"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, side, sideOffset, align, alignOffset, anchor, ...props, Pick positioner props and popup props" outputs="React element" errors="none" side_effects="DOM portal"]
+// CIL[DOC-MICRO logic_summary="Uses ComboboxPrimitive.Portal and Positioner to render a themed Popup with animation and data attributes." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxContent({
   className,
   side = "bottom",
@@ -235,21 +251,22 @@ function ComboboxContent({
     </ComboboxPrimitive.Portal>
   )
 }
-// CIL[END chunk_id="combobox_comboboxcontent_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxlist_1783844098" type="function" identity="ComboboxList" parent="none"]
-// CIL[DOC-MACRO purpose="Scrollable list container for combobox items"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide scrollable container with max height and padding"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="scrollable list" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates scrollable container with overflow handling and padding" 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. 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 combobox popup content with positioning'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxContent:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxList:component" type="component" identity="ComboboxList" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the scrollable list container for combobox items"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a styled ComboboxPrimitive.List with overflow and empty state support"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props and list props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Applies a themed className with no-scrollbar, scroll padding and empty-state styling." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxList({ className, ...props }: ComboboxPrimitive.List.Props) {
   return (
     <ComboboxPrimitive.List
@@ -262,21 +279,22 @@ function ComboboxList({ className, ...props }: ComboboxPrimitive.List.Props) {
     />
   )
 }
-// CIL[END chunk_id="combobox_comboboxlist_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxitem_1783844098" type="function" identity="ComboboxItem" parent="none"]
-// CIL[DOC-MACRO purpose="Individual combobox selectable item"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render selectable item with hover and selection styling"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="selectable item" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates interactive item with selection indicator and 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. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders the scrollable list container for combobox items'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxList:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxItem:component" type="component" identity="ComboboxItem" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a selectable item inside the combobox list"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a list item with highlighting, disabled and checked indicator states"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, children, ...props and item props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Wraps ComboboxPrimitive.Item and renders a CheckIcon indicator when selected." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxItem({
   className,
   children,
@@ -302,21 +320,22 @@ function ComboboxItem({
     </ComboboxPrimitive.Item>
   )
 }
-// CIL[END chunk_id="combobox_comboboxitem_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxgroup_1783844098" type="function" identity="ComboboxGroup" parent="none"]
-// CIL[DOC-MACRO purpose="Container for grouping combobox items"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide grouping container for related combobox items"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="group container" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Wraps Base UI Group primitive with data-slot attribute" 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. 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 selectable item inside the combobox list'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxItem:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxGroup:component" type="component" identity="ComboboxGroup" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Groups related combobox items under a common wrapper"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a ComboboxPrimitive.Group with className merging"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props and group props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards props to ComboboxPrimitive.Group and applies className via cn." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxGroup({ className, ...props }: ComboboxPrimitive.Group.Props) {
   return (
     <ComboboxPrimitive.Group
@@ -326,21 +345,22 @@ function ComboboxGroup({ className, ...props }: ComboboxPrimitive.Group.Props) {
     />
   )
 }
-// CIL[END chunk_id="combobox_comboboxgroup_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxlabel_1783844098" type="function" identity="ComboboxLabel" parent="none"]
-// CIL[DOC-MACRO purpose="Label for combobox groups"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled label text for combobox groups"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled label" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates muted text label with padding for group headers" 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. 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='Groups related combobox items under a common wrapper'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxGroup:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxLabel:component" type="component" identity="ComboboxLabel" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a label for a combobox group"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a muted group label using ComboboxPrimitive.GroupLabel"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props and label props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Applies muted typography and padding to a ComboboxPrimitive.GroupLabel." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxLabel({
   className,
   ...props
@@ -353,41 +373,43 @@ function ComboboxLabel({
     />
   )
 }
-// CIL[END chunk_id="combobox_comboboxlabel_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxcollection_1783844098" type="function" identity="ComboboxCollection" parent="none"]
-// CIL[DOC-MACRO purpose="Collection wrapper for combobox items"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide collection container for combobox items management"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="collection wrapper" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Wraps Base UI Collection primitive with data-slot attribute" 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. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a label for a combobox group'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxLabel:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxCollection:component" type="component" identity="ComboboxCollection" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Provides the collection wrapper for combobox options"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a ComboboxPrimitive.Collection with a data-slot attribute"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="...props as collection props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards props to ComboboxPrimitive.Collection and adds a data-slot marker." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxCollection({ ...props }: ComboboxPrimitive.Collection.Props) {
   return (
     <ComboboxPrimitive.Collection data-slot="combobox-collection" {...props} />
   )
 }
-// CIL[END chunk_id="combobox_comboboxcollection_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxempty_1783844098" type="function" identity="ComboboxEmpty" parent="none"]
-// CIL[DOC-MACRO purpose="Empty state for combobox list"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display styled content when no items match search"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled empty state" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates centered container with padding for empty state 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. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Provides the collection wrapper for combobox options'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxCollection:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxEmpty:component" type="component" identity="ComboboxEmpty" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the empty state when no combobox items match"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display a centered empty message when the list has no matches"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props and empty props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Uses a group-data-empty selector to show the message only when the list is empty." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxEmpty({ className, ...props }: ComboboxPrimitive.Empty.Props) {
   return (
     <ComboboxPrimitive.Empty
@@ -400,21 +422,22 @@ function ComboboxEmpty({ className, ...props }: ComboboxPrimitive.Empty.Props) {
     />
   )
 }
-// CIL[END chunk_id="combobox_comboboxempty_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxseparator_1783844098" type="function" identity="ComboboxSeparator" parent="none"]
-// CIL[DOC-MACRO purpose="Visual separator for combobox groups"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render styled separator between combobox sections"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled separator" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates horizontal line with margin and border 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. 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 empty state when no combobox items match'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxEmpty:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxSeparator:component" type="component" identity="ComboboxSeparator" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a visual divider between combobox groups"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a horizontal separator between list groups"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props and separator props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards props to ComboboxPrimitive.Separator and applies a border line style." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxSeparator({
   className,
   ...props
@@ -427,21 +450,22 @@ function ComboboxSeparator({
     />
   )
 }
-// CIL[END chunk_id="combobox_comboboxseparator_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxchips_1783844098" type="function" identity="ComboboxChips" parent="none"]
-// CIL[DOC-MACRO purpose="Container for combobox selection chips"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled container for multiple selected items"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="chips container" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates flex container with border and focus styling for chips" 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. 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 divider between combobox groups'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxSeparator:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxChips:component" type="component" identity="ComboboxChips" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the chip container for a multi-select combobox"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a flex-wrapped chip list with focus and invalid states"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props, ComboboxPrimitive chips type and component props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Wraps ComboboxPrimitive.Chips with a styled input-like container and focus ring." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxChips({
   className,
   ...props
@@ -458,21 +482,22 @@ function ComboboxChips({
     />
   )
 }
-// CIL[END chunk_id="combobox_comboboxchips_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxchip_1783844098" type="function" identity="ComboboxChip" parent="none"]
-// CIL[DOC-MACRO purpose="Individual selection chip component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render removable chip for selected combobox items"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled chip" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates removable chip with conditional remove button and 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. 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 chip container for a multi-select combobox'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxChips:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxChip:component" type="component" identity="ComboboxChip" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders an individual selected chip with optional remove button"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a chip label and conditionally a remove button"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, children, showRemove, ...props and chip props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders ComboboxPrimitive.Chip and conditionally a ChipRemove button using Button." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxChip({
   className,
   children,
@@ -503,21 +528,22 @@ function ComboboxChip({
     </ComboboxPrimitive.Chip>
   )
 }
-// CIL[END chunk_id="combobox_comboboxchip_1783844098"]
-// CIL[BEGIN chunk_id="combobox_comboboxchipsinput_1783844098" type="function" identity="ComboboxChipsInput" parent="none"]
-// CIL[DOC-MACRO purpose="Input field for chips container"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide input field within chips for adding new items"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="chips input" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates minimal input field with outline removal for chips" 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. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders an individual selected chip with optional remove button'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxChip:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:ComboboxChipsInput:component" type="component" identity="ComboboxChipsInput" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the inline text input inside the chip container"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a flexible text input for typing within chips"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props and input props" outputs="React element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Forwards props to ComboboxPrimitive.Input and applies a small outline-none className." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ComboboxChipsInput({
   className,
   ...props
@@ -530,39 +556,40 @@ function ComboboxChipsInput({
     />
   )
 }
-// CIL[END chunk_id="combobox_comboboxchipsinput_1783844098"]
-// CIL[BEGIN chunk_id="combobox_usecomboboxanchor_1783844098" type="function" identity="useComboboxAnchor" parent="none"]
-// CIL[DOC-MACRO purpose="Hook for combobox anchor reference"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide ref for anchoring combobox content"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React ref" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Creates React ref for HTMLDivElement anchor element" 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. 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 inline text input inside the chip container'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:ComboboxChipsInput:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:useComboboxAnchor:hook" type="hook" identity="useComboboxAnchor" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Provides a ref for anchoring the combobox popup"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a ref that can be attached to an anchor element"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React ref to HTMLDivElement" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Creates a React ref typed to HTMLDivElement for anchoring." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function useComboboxAnchor() {
   return React.useRef<HTMLDivElement | null>(null)
 }
-// CIL[END chunk_id="combobox_usecomboboxanchor_1783844098"]
-// CIL[BEGIN chunk_id="combobox_exports_1783844098" type="exports" identity="exports" parent="none"]
-// CIL[DOC-MACRO purpose="Export combobox components"]
-// CIL[DOC-RESPONSIBILITY responsibility="Make all combobox components available for import"]
-// CIL[DOC-CONTEXT module="combobox" layer="ui" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="component exports" errors="none" side_effects="module exports"]
-// CIL[DOC-MICRO logic_summary="Exports all combobox components and utility hook for external usage" 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. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Provides a ref for anchoring the combobox popup'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:useComboboxAnchor:hook"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/combobox.tsx:combobox:exports" type="export" identity="combobox" parent="~/.framework/src/components/ui/combobox.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Re-exports the public Combobox component surface"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose all combobox subcomponents and the anchor hook"]
+// CIL[DOC-CONTEXT module="combobox" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/combobox.tsx,.framework/src/components/ui/input-group.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="named exports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Lists all named component and hook exports for consumers." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export {
   Combobox,
   ComboboxInput,
@@ -581,4 +608,10 @@ export {
   ComboboxValue,
   useComboboxAnchor,
 }
-// CIL[END chunk_id="combobox_exports_1783844098"]
+// CIL[DOC-VECTOR type="context" content="purpose='Re-exports the public Combobox component surface'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx,.framework/src/components/ui/input-group.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/combobox.tsx:combobox:exports"]