spine-framework 0.3.145 → 0.4.0

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

@@ -1,27 +1,35 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/button.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/ui/button.tsx"]
+// CIL[DOC-MACRO purpose="Declare module-level imports and dependencies for the Button component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import React, class-variance-authority, radix Slot, and the cn utility for the Button component"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/button.tsx" layer="ui" related_files=".framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Imported React, cva, Slot and cn bindings available to the module" errors="Module load fails if a peer dependency is missing" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, cva/VariantProps, Slot, and the cn Tailwind class merge utility" notable_decisions="Uses cva for variant-driven styling and cn for conditional class merging"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="[]"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="component developers"]
 
-
-
-// CIL[BEGIN chunk_id="button_module_header_1783881474" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Button component with comprehensive variant system using CVA"]
-// CIL[DOC-RESPONSIBILITY responsibility="Define button styling variants and component infrastructure"]
-// CIL[DOC-CONTEXT module="ui.button" layer="component" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="buttonVariants, React, CVA, Slot" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Creates comprehensive button variant system with theme support and accessibility" notable_decisions="['class-variance-authority pattern', 'extensive variant system', 'icon-aware sizing']"]
-// 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: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import * as React from "react"
 import { cva, type VariantProps } from "class-variance-authority"
 import { Slot } from "radix-ui"
 
 import { cn } from "@/lib/utils"
+// CIL[DOC-VECTOR type="context" content="purpose='Declare module-level imports and dependencies for the Button component'; 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/button.tsx:module_header:module_header"]
 
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/button.tsx:buttonVariants:constant" type="constant" identity="buttonVariants" parent="~/.framework/src/components/ui/button.tsx"]
+// CIL[DOC-MACRO purpose="Define the CVA-based style variants for the Button component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a class-variance-authority configuration that defines size, variant, and default variants for Button"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/button.tsx" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="buttonVariants function that returns Tailwind classes for given variant and size" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Configures cva with a base class, variant and size maps, and default variants" notable_decisions="Uses Tailwind tokens such as bg-primary and border-border; includes icon and state modifier sizes"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="[]"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="component developers"]
 const buttonVariants = cva(
   "group/button inline-flex shrink-0 items-center justify-center rounded-md border border-transparent bg-clip-padding text-xs/relaxed font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-2 focus-visible:ring-ring/30 active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-2 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
   {
@@ -56,31 +64,36 @@ const buttonVariants = cva(
     },
   }
 )
-// CIL[END chunk_id="button_module_header_1783881474"]
-// CIL[BEGIN chunk_id="button_button_1783881474" type="function" identity="Button" parent="none"]
-// CIL[DOC-MACRO purpose="Main button component with variant support and asChild pattern"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render styled button with flexible composition via Radix Slot"]
-// CIL[DOC-CONTEXT module="ui.button" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled button or Slot component" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Uses Radix Slot for composition, applies CVA variants, sets data attributes" notable_decisions="['composition pattern', 'CVA integration', 'data attributes for styling']"]
-// 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: 2. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, .framework/src/pages/admin/RolesPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 2. 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='Define the CVA-based style variants for the Button component'; 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"]
-function Button({
+// CIL[END stable_id="~/.framework/src/components/ui/button.tsx:buttonVariants:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/button.tsx:Button:component" type="component" identity="Button" parent="~/.framework/src/components/ui/button.tsx"]
+// CIL[DOC-MACRO purpose="Render a flexible Button component with CVA variants and optional child slot"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a styled button or polymorphic Slot wrapper using the configured size and variant"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/button.tsx" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, variant, size, asChild, ref, standard button props" outputs="React element with merged CVA classes and data attributes" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Chooses Slot.Root or 'button' based on asChild; merges className with buttonVariants output and spreads remaining props" notable_decisions="forwardRef is required — Radix primitives (DropdownMenuTrigger/PopoverTrigger/DialogTrigger/TooltipTrigger) attach their anchor ref through asChild; a plain function component silently drops it under React 18 and the floating content positions at 0,0 off-screen"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="[]"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="component developers"]
+const Button = React.forwardRef<
+  HTMLButtonElement,
+  React.ComponentProps<"button"> &
+    VariantProps<typeof buttonVariants> & {
+      asChild?: boolean
+    }
+>(function Button({
   className,
   variant = "default",
   size = "default",
   asChild = false,
   ...props
-}: React.ComponentProps<"button"> &
-  VariantProps<typeof buttonVariants> & {
-    asChild?: boolean
-  }) {
+}, ref) {
   const Comp = asChild ? Slot.Root : "button"
 
   return (
@@ -89,24 +102,32 @@ function Button({
       data-variant={variant}
       data-size={size}
       className={cn(buttonVariants({ variant, size, className }))}
+      ref={ref}
       {...props}
     />
   )
-}
-// CIL[END chunk_id="button_button_1783881474"]
-// CIL[BEGIN chunk_id="button_exports_1783881474" type="exports" identity="exports" parent="none"]
-// CIL[DOC-MACRO purpose="Export button component and variants for public API"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide public interface for button component library"]
-// CIL[DOC-CONTEXT module="ui.button" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Button component and buttonVariants" errors="none" side_effects="module exports"]
-// CIL[DOC-MICRO logic_summary="Exports main Button component and buttonVariants 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, .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+})
+// CIL[DOC-VECTOR type="context" content="purpose='Render a flexible Button component with CVA variants and optional child slot'; 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/button.tsx:Button:component"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/button.tsx:exports:variable" type="variable" identity="exports" parent="~/.framework/src/components/ui/button.tsx"]
+// CIL[DOC-MACRO purpose="Export the Button component and buttonVariants helper for consumers"]
+// CIL[DOC-RESPONSIBILITY responsibility="Make Button and buttonVariants available to other modules"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/button.tsx" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Named exports Button and buttonVariants" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Re-exports the Button component and buttonVariants constant from this module" notable_decisions="Named exports allow tree-shaking and explicit imports"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="[]"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="component developers"]
 export { Button, buttonVariants }
-// CIL[END chunk_id="button_exports_1783881474"]
+// CIL[DOC-VECTOR type="context" content="purpose='Export the Button component and buttonVariants helper 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/button.tsx:exports:variable"]

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

@@ -1,24 +1,29 @@
-
-
-
-
-// CIL[BEGIN chunk_id="calendar_module_header_1783881474" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Calendar component with react-day-picker integration"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide calendar infrastructure and dependencies"]
-// CIL[DOC-CONTEXT module="ui.calendar" layer="component" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".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="React, DayPicker, Button, icons" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports calendar library dependencies and UI components for calendar implementation" notable_decisions="['react-day-picker integration', 'custom button integration', 'lucide icons']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/calendar.tsx:module_directive:module_directive" type="module_directive" identity="module_directive" parent=""]
+// CIL[DOC-MACRO purpose="Marks this module as client-side React code for the Next.js app router."]
+// CIL[DOC-RESPONSIBILITY responsibility="Sets the 'use client' directive at the top of the file."]
+// CIL[DOC-CONTEXT module="calendar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/calendar.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="client directive" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Contains the 'use client' directive only." 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/pages/admin/IntegrationsPage.tsx, .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."]
+"use client"
+// CIL[DOC-VECTOR type="context" content="purpose='Marks this module as client-side React code for the Next.js app router.'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
-"use client"
+// CIL[END stable_id="~/.framework/src/components/ui/calendar.tsx:module_directive:module_directive"]
 
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/calendar.tsx:module_header:module_header" type="module_header" identity="module_header" parent=""]
+// CIL[DOC-MACRO purpose="Imports dependencies and registers UI symbols used by the calendar components."]
+// CIL[DOC-RESPONSIBILITY responsibility="Import React, DayPicker, utility functions, button component, and icons."]
+// CIL[DOC-CONTEXT module="calendar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imported modules and types" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Module imports for the calendar UI components." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developer"]
 import * as React from "react"
 import {
   DayPicker,
@@ -30,21 +35,22 @@ import {
 import { cn } from "@/lib/utils"
 import { Button, buttonVariants } from "@/components/ui/button"
 import { ChevronLeftIcon, ChevronRightIcon, ChevronDownIcon } from "lucide-react"
-// CIL[END chunk_id="calendar_module_header_1783881474"]
-// CIL[BEGIN chunk_id="calendar_calendar_1783881474" type="function" identity="Calendar" parent="none"]
-// CIL[DOC-MACRO purpose="Main calendar component with extensive customization options"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render customizable calendar with theme integration and custom components"]
-// CIL[DOC-CONTEXT module="ui.calendar" layer="component" 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\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled calendar component" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Configures DayPicker with custom styling, components, and comprehensive class name overrides" notable_decisions="['extensive customization system', 'custom component injection', 'theme-aware styling']"]
-// 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/ui/dialog.tsx, .framework/src/components/layout/Sidebar.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/schema-utils.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Imports dependencies and registers UI symbols used by the calendar components.'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/calendar.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/calendar.tsx:Calendar:component" type="component" identity="Calendar" parent=""]
+// CIL[DOC-MACRO purpose="Renders a styled date picker calendar using react-day-picker with Tailwind class names and custom sub-components."]
+// CIL[DOC-RESPONSIBILITY responsibility="Render the Calendar UI, apply default and user-supplied class names, configure day buttons and dropdowns, and compose DayPicker sub-components."]
+// CIL[DOC-CONTEXT module="calendar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/calendar.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, classNames, showOutsideDays, captionLayout, buttonVariant, locale, formatters, components, and DayPicker props" outputs="JSX DayPicker element with custom classNames and components" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Wraps react-day-picker DayPicker, merges default Tailwind classNames, customizes Root/Chevron/DayButton/WeekNumber, and spreads remaining props." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function Calendar({
   className,
   classNames,
@@ -184,6 +190,8 @@ function Calendar({
             )
           }
 
+
+
           if (orientation === "right") {
             return (
               <ChevronRightIcon className={cn("size-4", className)} {...props} />
@@ -212,21 +220,22 @@ function Calendar({
     />
   )
 }
-// CIL[END chunk_id="calendar_calendar_1783881474"]
-// CIL[BEGIN chunk_id="calendar_calendardaybutton_1783881474" type="function" identity="CalendarDayButton" parent="none"]
-// CIL[DOC-MACRO purpose="Custom calendar day button with focus management and range selection"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render styled day button with accessibility and selection states"]
-// CIL[DOC-CONTEXT module="ui.calendar" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled button component" errors="none" side_effects="renders DOM, manages focus"]
-// CIL[DOC-MICRO logic_summary="Handles focus management, applies complex selection styling with data attributes" notable_decisions="['focus management', 'complex selection states', 'data attribute patterns']"]
-// 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/functions/custom_cil-embeddings.ts, custom/apps/cortex/pages/operations/OperationsDashboard.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='Renders a styled date picker calendar using react-day-picker with Tailwind class names and custom sub-components.'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/calendar.tsx:Calendar:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/calendar.tsx:CalendarDayButton:component" type="component" identity="CalendarDayButton" parent=""]
+// CIL[DOC-MACRO purpose="Renders an individual day button for the calendar with focus, selection, and range state styling."]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a single day cell button, manage focus for the focused modifier, and apply range/selection class names."]
+// CIL[DOC-CONTEXT module="calendar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/calendar.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, day, modifiers, locale, ...props" outputs="JSX Button with data attributes and merged class names" errors="none" side_effects="focuses the button when modifiers.focused is true"]
+// CIL[DOC-MICRO logic_summary="Uses a React ref and useEffect to focus when the day is focused, applies default classNames and range/selected data attributes." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function CalendarDayButton({
   className,
   day,
@@ -265,20 +274,26 @@ function CalendarDayButton({
     />
   )
 }
-// CIL[END chunk_id="calendar_calendardaybutton_1783881474"]
-// CIL[BEGIN chunk_id="calendar_exports_1783881474" type="exports" identity="exports" parent="none"]
-// CIL[DOC-MACRO purpose="Export calendar components for public API"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide public interface for calendar component library"]
-// CIL[DOC-CONTEXT module="ui.calendar" layer="component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Calendar and CalendarDayButton components" errors="none" side_effects="module exports"]
-// CIL[DOC-MICRO logic_summary="Exports main calendar components for consumption" notable_decisions="['named exports pattern', 'component library interface']"]
-// 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/src/components/ui/dialog.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders an individual day button for the calendar with focus, selection, and range state styling.'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
 // CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
 // CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/calendar.tsx:CalendarDayButton:component"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/calendar.tsx:module_exports:module_exports" type="module_exports" identity="module_exports" parent=""]
+// CIL[DOC-MACRO purpose="Exports the Calendar and CalendarDayButton components for consumers."]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose Calendar and CalendarDayButton from this module."]
+// CIL[DOC-CONTEXT module="calendar" layer="ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/calendar.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="named exports Calendar and CalendarDayButton" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Named export of the two calendar components." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export { Calendar, CalendarDayButton }
-// CIL[END chunk_id="calendar_exports_1783881474"]
+// CIL[DOC-VECTOR type="context" content="purpose='Exports the Calendar and CalendarDayButton components for consumers.'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/button.tsx"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/calendar.tsx:module_exports:module_exports"]