spine-framework 0.3.125 → 0.3.127

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

@@ -1,7 +1,45 @@
+
+
+
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="card_module_header_1783881474" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Import React and utility functions for card components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide dependencies for card component library"]
+// CIL[DOC-CONTEXT module="ui.card" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React, cn utility" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Standard React and utility imports for UI components" 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: component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/functions/_shared/schema-utils.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import * as React from "react"
 
 import { cn } from "@/lib/utils"
-
+// CIL[END chunk_id="card_module_header_1783881474"]
+// CIL[BEGIN chunk_id="card_card_1783881474" type="function" identity="Card" parent="none"]
+// CIL[DOC-MACRO purpose="Main card container component with responsive sizing"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render card container with styling and size variants"]
+// CIL[DOC-CONTEXT module="ui.card" layer="component" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="styled div element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Applies conditional styling based on size prop using cn utility" notable_decisions="['data attributes for styling', 'responsive design 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: 2. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, custom/apps/portal/pages/ContentPage.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="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function Card({
   className,
   size = "default",
@@ -19,7 +57,21 @@ function Card({
     />
   )
 }
-
+// CIL[END chunk_id="card_card_1783881474"]
+// CIL[BEGIN chunk_id="card_cardheader_1783881474" type="function" identity="CardHeader" parent="none"]
+// CIL[DOC-MACRO purpose="Card header section with responsive grid layout"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide styled header container for card content"]
+// CIL[DOC-CONTEXT module="ui.card" layer="component" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\".framework/migrations/015_simplify_apps_table.sql\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="header div element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Implements responsive grid with conditional styling for actions/descriptions" notable_decisions="['grid layout system', 'container queries']"]
+// 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/table-primitives.tsx, .framework/migrations/015_simplify_apps_table.sql, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -32,7 +84,21 @@ function CardHeader({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-
+// CIL[END chunk_id="card_cardheader_1783881474"]
+// CIL[BEGIN chunk_id="card_cardtitle_1783881474" type="function" identity="CardTitle" parent="none"]
+// CIL[DOC-MACRO purpose="Card title with heading typography styling"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render styled title text for card headers"]
+// CIL[DOC-CONTEXT module="ui.card" layer="component" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/db.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="title div element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Applies heading font styles and medium weight to title text" notable_decisions="['semantic heading styles', 'font weight consistency']"]
+// 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/functions/_shared/schema-utils.ts, .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/db.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -42,7 +108,21 @@ function CardTitle({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-
+// CIL[END chunk_id="card_cardtitle_1783881474"]
+// CIL[BEGIN chunk_id="card_carddescription_1783881474" type="function" identity="CardDescription" parent="none"]
+// CIL[DOC-MACRO purpose="Card description with muted text styling"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render styled description text for card content"]
+// CIL[DOC-CONTEXT module="ui.card" layer="component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="description div element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Applies muted foreground color and relaxed line height" notable_decisions="['accessibility-focused styling', 'text hierarchy']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/table-primitives.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/principal.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -52,7 +132,21 @@ function CardDescription({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-
+// CIL[END chunk_id="card_carddescription_1783881474"]
+// CIL[BEGIN chunk_id="card_cardaction_1783881474" type="function" identity="CardAction" parent="none"]
+// CIL[DOC-MACRO purpose="Card action area with grid positioning"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide positioned container for card actions/buttons"]
+// CIL[DOC-CONTEXT module="ui.card" layer="component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/db.ts\",\".framework/src/components/ui/table-primitives.tsx\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="action div element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Uses CSS Grid to position actions in top-right of card header" notable_decisions="['grid positioning strategy', 'self-alignment']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/db.ts, .framework/src/components/ui/table-primitives.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"]
 function CardAction({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -65,7 +159,21 @@ function CardAction({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-
+// CIL[END chunk_id="card_cardaction_1783881474"]
+// CIL[BEGIN chunk_id="card_cardcontent_1783881474" type="function" identity="CardContent" parent="none"]
+// CIL[DOC-MACRO purpose="Card content area with responsive padding"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide main content container for card body"]
+// CIL[DOC-CONTEXT module="ui.card" layer="component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="content div element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Applies responsive horizontal padding based on card size" notable_decisions="['responsive padding', 'size-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: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function CardContent({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -75,7 +183,21 @@ function CardContent({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-
+// CIL[END chunk_id="card_cardcontent_1783881474"]
+// CIL[BEGIN chunk_id="card_cardfooter_1783881474" type="function" identity="CardFooter" parent="none"]
+// CIL[DOC-MACRO purpose="Card footer with responsive styling and border handling"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide styled footer container for card bottom section"]
+// CIL[DOC-CONTEXT module="ui.card" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/components/ui/dialog.tsx\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="footer div element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Applies flex layout, responsive padding, and conditional border styling" notable_decisions="['border conditional styling', 'flex layout for alignment']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/components/ui/dialog.tsx."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -88,7 +210,21 @@ function CardFooter({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-
+// CIL[END chunk_id="card_cardfooter_1783881474"]
+// CIL[BEGIN chunk_id="card_exports_1783881474" type="exports" identity="exports" parent="none"]
+// CIL[DOC-MACRO purpose="Export all card components for public API"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide public interface for card component library"]
+// CIL[DOC-CONTEXT module="ui.card" layer="component" related_files="[\".framework/migrations/015_simplify_apps_table.sql\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="named exports of card components" errors="none" side_effects="module exports"]
+// CIL[DOC-MICRO logic_summary="Exports all card components as named exports for consumption" notable_decisions="['comprehensive export strategy', '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: .framework/migrations/015_simplify_apps_table.sql, .framework/src/components/ui/table-primitives.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/TypeDetailPage.tsx."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export {
   Card,
   CardHeader,
@@ -98,3 +234,4 @@ export {
   CardDescription,
   CardContent,
 }
+// CIL[END chunk_id="card_exports_1783881474"]

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

@@ -1,3 +1,26 @@
+
+
+
+
+
+
+
+
+// CIL[BEGIN chunk_id="carousel_module_header_1783881474" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Carousel component library with Embla Carousel integration"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide carousel infrastructure, types, and context system"]
+// CIL[DOC-CONTEXT module="ui.carousel" 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="carousel types, context, React, Embla" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines carousel type system, context provider, and Embla integration" notable_decisions="['embla-carousel integration', 'comprehensive type system', 'context pattern']"]
+// 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/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."]
+// 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 useEmblaCarousel, {
   type UseEmblaCarouselType,
@@ -29,7 +52,21 @@ type CarouselContextProps = {
 } & CarouselProps
 
 const CarouselContext = React.createContext<CarouselContextProps | null>(null)
-
+// CIL[END chunk_id="carousel_module_header_1783881474"]
+// CIL[BEGIN chunk_id="carousel_usecarousel_1783881474" type="function" identity="useCarousel" parent="none"]
+// CIL[DOC-MACRO purpose="Hook to access carousel context with error handling"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide safe access to carousel context and API"]
+// CIL[DOC-CONTEXT module="ui.carousel" layer="component" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CarouselContextProps" errors="throws if not in Carousel" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Retrieves carousel context and throws descriptive error if missing" notable_decisions="['context validation', 'developer-friendly error messages']"]
+// 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: 4. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 4. Total affected: 4."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function useCarousel() {
   const context = React.useContext(CarouselContext)
 
@@ -39,7 +76,21 @@ function useCarousel() {
 
   return context
 }
-
+// CIL[END chunk_id="carousel_usecarousel_1783881474"]
+// CIL[BEGIN chunk_id="carousel_carousel_1783881474" type="function" identity="Carousel" parent="none"]
+// CIL[DOC-MACRO purpose="Main carousel component with orientation support and keyboard navigation"]
+// CIL[DOC-RESPONSIBILITY responsibility="Manage carousel state, navigation, and context provision"]
+// CIL[DOC-CONTEXT module="ui.carousel" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="carousel container with context" errors="none" side_effects="provides context, manages state"]
+// CIL[DOC-MICRO logic_summary="Integrates Embla Carousel, manages scroll state, handles keyboard events" notable_decisions="['embla integration', 'keyboard navigation', 'context provision 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/layout/Sidebar.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function Carousel({
   orientation = "horizontal",
   opts,
@@ -129,7 +180,21 @@ function Carousel({
     </CarouselContext.Provider>
   )
 }
-
+// CIL[END chunk_id="carousel_carousel_1783881474"]
+// CIL[BEGIN chunk_id="carousel_carouselcontent_1783881474" type="function" identity="CarouselContent" parent="none"]
+// CIL[DOC-MACRO purpose="Carousel content container with orientation-aware layout"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide scrollable content area with proper ref attachment"]
+// CIL[DOC-CONTEXT module="ui.carousel" layer="component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="scrollable content container" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Attaches carousel ref, applies orientation-specific flex layout" notable_decisions="['orientation-aware layout', 'ref attachment pattern']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 1. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 1. Total affected: 1."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function CarouselContent({ className, ...props }: React.ComponentProps<"div">) {
   const { carouselRef, orientation } = useCarousel()
 
@@ -150,7 +215,21 @@ function CarouselContent({ className, ...props }: React.ComponentProps<"div">) {
     </div>
   )
 }
-
+// CIL[END chunk_id="carousel_carouselcontent_1783881474"]
+// CIL[BEGIN chunk_id="carousel_carouselitem_1783881474" type="function" identity="CarouselItem" parent="none"]
+// CIL[DOC-MACRO purpose="Individual carousel slide with orientation-aware spacing"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide styled container for individual carousel slides"]
+// CIL[DOC-CONTEXT module="ui.carousel" layer="component" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="slide container element" errors="none" side_effects="renders DOM"]
+// CIL[DOC-MICRO logic_summary="Applies orientation-specific padding and slide layout styling" notable_decisions="['orientation-aware spacing', 'accessibility roles']"]
+// 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/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, \."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function CarouselItem({ className, ...props }: React.ComponentProps<"div">) {
   const { orientation } = useCarousel()
 
@@ -168,7 +247,21 @@ function CarouselItem({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-
+// CIL[END chunk_id="carousel_carouselitem_1783881474"]
+// CIL[BEGIN chunk_id="carousel_carouselprevious_1783881474" type="function" identity="CarouselPrevious" parent="none"]
+// CIL[DOC-MACRO purpose="Previous navigation button with orientation-aware positioning"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide styled previous button with state management"]
+// CIL[DOC-CONTEXT module="ui.carousel" layer="component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="navigation button component" errors="none" side_effects="renders DOM, triggers scroll"]
+// CIL[DOC-MICRO logic_summary="Applies orientation-specific positioning and manages disabled state" notable_decisions="['orientation-aware positioning', 'state management integration']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function CarouselPrevious({
   className,
   variant = "outline",
@@ -198,7 +291,21 @@ function CarouselPrevious({
     </Button>
   )
 }
-
+// CIL[END chunk_id="carousel_carouselprevious_1783881474"]
+// CIL[BEGIN chunk_id="carousel_carouselnext_1783881474" type="function" identity="CarouselNext" parent="none"]
+// CIL[DOC-MACRO purpose="Next navigation button with orientation-aware positioning"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide styled next button with state management"]
+// CIL[DOC-CONTEXT module="ui.carousel" layer="component" related_files="[]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="navigation button component" errors="none" side_effects="renders DOM, triggers scroll"]
+// CIL[DOC-MICRO logic_summary="Applies orientation-specific positioning and manages disabled state" notable_decisions="['orientation-aware positioning', 'state management integration']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: none."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 function CarouselNext({
   className,
   variant = "outline",
@@ -228,7 +335,21 @@ function CarouselNext({
     </Button>
   )
 }
-
+// CIL[END chunk_id="carousel_carouselnext_1783881474"]
+// CIL[BEGIN chunk_id="carousel_exports_1783881474" type="exports" identity="exports" parent="none"]
+// CIL[DOC-MACRO purpose="Export carousel components and types for public API"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide public interface for carousel component library"]
+// CIL[DOC-CONTEXT module="ui.carousel" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"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\"]"]
+// CIL[DOC-CONTRACT inputs="none" outputs="carousel components, types, and hook" errors="none" side_effects="module exports"]
+// CIL[DOC-MICRO logic_summary="Exports all carousel components, types, and utilities for consumption" notable_decisions="['comprehensive export strategy', 'type exports included', 'hook exports']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/layout/Sidebar.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/TypeDetailPage.tsx."]
+// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
+// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
+// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 export {
   type CarouselApi,
   Carousel,
@@ -238,3 +359,4 @@ export {
   CarouselNext,
   useCarousel,
 }
+// CIL[END chunk_id="carousel_exports_1783881474"]