spine-framework 0.3.145 → 0.4.0

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

@@ -1,3 +1,16 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Provides the Carousel UI components built on Embla Carousel for the shadcn/ui design system"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import carousel dependencies and re-export the public Carousel component surface"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.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, Embla Carousel, utility, Button, and icon imports used by Carousel, Content, Item, Previous, and Next." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="frontend-developers"]
+
+
+
+
 
 
 
@@ -6,21 +19,6 @@
 
 
 
-// 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,19 +27,112 @@ import useEmblaCarousel, {
 import { cn } from "@/lib/utils"
 import { Button } from "@/components/ui/button"
 import { ChevronLeftIcon, ChevronRightIcon } from "lucide-react"
+// CIL[DOC-VECTOR type="context" content="purpose='Provides the Carousel UI components built on Embla Carousel for the shadcn/ui design system'; 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/carousel.tsx:module_header:module_header"]
 
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carouselapi:type" type="type" identity="carouselapi" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Exposes the Embla Carousel API type returned by useEmblaCarousel"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the CarouselApi type alias for consumer typing"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CarouselApi type alias" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Aliases UseEmblaCarouselType[1] as CarouselApi." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 type CarouselApi = UseEmblaCarouselType[1]
+// CIL[DOC-VECTOR type="context" content="purpose='Exposes the Embla Carousel API type returned by useEmblaCarousel'; 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/carousel.tsx:carouselapi:type"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:usecarouselparameters:type" type="type" identity="usecarouselparameters" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Defines the parameter tuple type accepted by the useEmblaCarousel hook"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the UseCarouselParameters type for the Carousel hook"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="UseCarouselParameters type alias" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Aliases Parameters<typeof useEmblaCarousel> as UseCarouselParameters." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 type UseCarouselParameters = Parameters<typeof useEmblaCarousel>
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the parameter tuple type accepted by the useEmblaCarousel hook'; 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/carousel.tsx:usecarouselparameters:type"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carouseloptions:type" type="type" identity="carouseloptions" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Defines the carousel configuration options type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the CarouselOptions type for the Carousel component"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CarouselOptions type alias" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Aliases UseCarouselParameters[0] as CarouselOptions." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 type CarouselOptions = UseCarouselParameters[0]
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the carousel configuration options type'; 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/carousel.tsx:carouseloptions:type"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carouselplugin:type" type="type" identity="carouselplugin" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Defines the carousel plugin type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide the CarouselPlugin type for Embla plugins"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CarouselPlugin type alias" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Aliases UseCarouselParameters[1] as CarouselPlugin." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 type CarouselPlugin = UseCarouselParameters[1]
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the carousel plugin type'; 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/carousel.tsx:carouselplugin:type"]
 
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carouselprops:type" type="type" identity="carouselprops" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Defines the props accepted by the Carousel component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare the CarouselProps interface with options, plugins, orientation, and setApi"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CarouselProps type declaration" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Describes the public props for the Carousel component including optional opts, plugins, orientation, and setApi callback." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 type CarouselProps = {
   opts?: CarouselOptions
   plugins?: CarouselPlugin
   orientation?: "horizontal" | "vertical"
   setApi?: (api: CarouselApi) => void
 }
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the props accepted by the Carousel component'; 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/carousel.tsx:carouselprops:type"]
 
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carouselcontextprops:type" type="type" identity="carouselcontextprops" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Defines the context shape consumed by nested Carousel subcomponents"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare the CarouselContextProps interface"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CarouselContextProps type declaration" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Extends CarouselProps with carouselRef, api, scroll handlers, and scrollability booleans." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 type CarouselContextProps = {
   carouselRef: ReturnType<typeof useEmblaCarousel>[0]
   api: ReturnType<typeof useEmblaCarousel>[1]
@@ -50,23 +141,39 @@ type CarouselContextProps = {
   canScrollPrev: boolean
   canScrollNext: boolean
 } & CarouselProps
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the context shape consumed by nested Carousel subcomponents'; 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/carousel.tsx:carouselcontextprops:type"]
 
-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[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carouselcontext:constant" type="constant" identity="carouselcontext" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Creates the React context for Carousel subcomponent communication"]
+// CIL[DOC-RESPONSIBILITY responsibility="Initialize the CarouselContext with a null default"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CarouselContext constant" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Creates a React context typed to CarouselContextProps or null." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" 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."]
+const CarouselContext = React.createContext<CarouselContextProps | null>(null)
+// CIL[DOC-VECTOR type="context" content="purpose='Creates the React context for Carousel subcomponent communication'; 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/carousel.tsx:carouselcontext:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:usecarousel:function" type="function" identity="usecarousel" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Hook to access the Carousel context from subcomponents"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return the CarouselContext value or throw if used outside a Carousel"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="CarouselContextProps" errors="Throws if context is null" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Reads React context and throws an error when not inside a Carousel provider." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function useCarousel() {
   const context = React.useContext(CarouselContext)
 
@@ -76,21 +183,22 @@ 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="context" content="purpose='Hook to access the Carousel context from subcomponents'; 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/carousel.tsx:usecarousel:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carousel:function" type="function" identity="carousel" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Main Carousel component that wires Embla and exposes context to children"]
+// CIL[DOC-RESPONSIBILITY responsibility="Initialize the Embla carousel, track scrollability, handle keyboard input, and render the provider"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="props: React.ComponentProps<'div'> & CarouselProps" outputs="JSX element with CarouselContext.Provider and a keyboard-handled container" errors="none" side_effects="Registers Embla select/reInit event handlers and keyboard event handling"]
+// CIL[DOC-MICRO logic_summary="Creates an Embla instance, manages canScrollPrev/Next state, binds keyboard navigation, and passes values to context." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function Carousel({
   orientation = "horizontal",
   opts,
@@ -180,21 +288,22 @@ 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="context" content="purpose='Main Carousel component that wires Embla and exposes context to children'; 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/carousel.tsx:carousel:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carouselcontent:function" type="function" identity="carouselcontent" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the scrollable viewport and track for carousel items"]
+// CIL[DOC-RESPONSIBILITY responsibility="Apply the carousel ref and orientation styles to the content wrapper"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props: React.ComponentProps<'div'>" outputs="JSX element with overflow-hidden viewport and flex track" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Receives the Embla ref and orientation from context and renders the inner track with orientation-specific spacing." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function CarouselContent({ className, ...props }: React.ComponentProps<"div">) {
   const { carouselRef, orientation } = useCarousel()
 
@@ -215,21 +324,22 @@ 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="context" content="purpose='Renders the scrollable viewport and track for carousel items'; 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/carousel.tsx:carouselcontent:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carouselitem:function" type="function" identity="carouselitem" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders a single slide inside the Carousel track"]
+// CIL[DOC-RESPONSIBILITY responsibility="Apply slide role and orientation-specific padding to each item"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, ...props: React.ComponentProps<'div'>" outputs="JSX slide element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders a group with aria-roledescription 'slide' and orientation padding." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function CarouselItem({ className, ...props }: React.ComponentProps<"div">) {
   const { orientation } = useCarousel()
 
@@ -247,21 +357,22 @@ 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="context" content="purpose='Renders a single slide inside the Carousel track'; 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/carousel.tsx:carouselitem:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carouselprevious:function" type="function" identity="carouselprevious" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the previous-slide control button"]
+// CIL[DOC-RESPONSIBILITY responsibility="Scroll the carousel to the previous item when enabled"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="props: React.ComponentProps<typeof Button> with optional variant, size, className" outputs="Button element" errors="none" side_effects="Calls scrollPrev on click"]
+// CIL[DOC-MICRO logic_summary="Displays a ChevronLeft button positioned absolutely; disabled when no previous slide is available." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function CarouselPrevious({
   className,
   variant = "outline",
@@ -291,21 +402,22 @@ 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="context" content="purpose='Renders the previous-slide control button'; 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/carousel.tsx:carouselprevious:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:carouselnext:function" type="function" identity="carouselnext" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders the next-slide control button"]
+// CIL[DOC-RESPONSIBILITY responsibility="Scroll the carousel to the next item when enabled"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="props: React.ComponentProps<typeof Button> with optional variant, size, className" outputs="Button element" errors="none" side_effects="Calls scrollNext on click"]
+// CIL[DOC-MICRO logic_summary="Displays a ChevronRight button positioned absolutely; disabled when no next slide is available." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function CarouselNext({
   className,
   variant = "outline",
@@ -335,21 +447,22 @@ 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="context" content="purpose='Renders the next-slide control button'; 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/carousel.tsx:carouselnext:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/carousel.tsx:export_list:export" type="export" identity="export_list" parent="~/.framework/src/components/ui/carousel.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Re-exports the public Carousel component surface"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose Carousel, subcomponents, hooks, and types for module consumers"]
+// CIL[DOC-CONTEXT module="carousel" layer="components/ui" related_files=".framework/src/components/ui/button.tsx,.framework/src/components/ui/carousel.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Named exports of component and type symbols" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Lists all public identifiers for external consumers." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export {
   type CarouselApi,
   Carousel,
@@ -359,4 +472,10 @@ export {
   CarouselNext,
   useCarousel,
 }
-// CIL[END chunk_id="carousel_exports_1783881474"]
+// CIL[DOC-VECTOR type="context" content="purpose='Re-exports the public Carousel component surface'; 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/carousel.tsx:export_list:export"]