spine-framework 0.3.144 → 0.4.0

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

@@ -1,37 +1,29 @@
-
-
-
-// CIL[BEGIN chunk_id="skeleton_module_header_1783757774" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for Skeleton component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import utility function for className merging"]
-// CIL[DOC-CONTEXT module="skeleton" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/skeleton.tsx:module_header:module_header" type="module_header" identity="module_header" parent="module_header"]
+// CIL[DOC-MACRO purpose="Provides the Skeleton UI loading placeholder component for the design system"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import utility styles and expose the Skeleton component for use across the app"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/lib/utils.ts"]
 // CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import cn utility function for className merging" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-MICRO logic_summary="Imports className utility for component styling" 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: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/components/ui/dialog.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.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"]
+// CIL[DOC-AUDIENCE audience="developers"]
 import { cn } from "@/lib/utils"
-// CIL[END chunk_id="skeleton_module_header_1783757774"]
-// CIL[BEGIN chunk_id="skeleton_skeleton_1783757774" type="function" identity="Skeleton" parent="none"]
-// CIL[DOC-MACRO purpose="Animated skeleton placeholder component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render loading placeholder with pulse animation"]
-// CIL[DOC-CONTEXT module="skeleton" layer="frontend-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\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX skeleton element" errors="none" side_effects="renders UI elements"]
-// CIL[DOC-MICRO logic_summary="Render div with pulse animation, rounded corners, and muted background" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-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, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Provides the Skeleton UI loading placeholder component for the design system'; 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/skeleton.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/skeleton.tsx:skeleton:function" type="function" identity="skeleton" parent="module_header"]
+// CIL[DOC-MACRO purpose="Renders an animated placeholder element while content loads"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a skeleton loading state with optional className and extra props"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/skeleton.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className?: string, ...props: object" outputs="JSX.Element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Wraps a div with data-slot and applies utility classes" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function Skeleton({ className, ...props }: React.ComponentProps<"div">) {
   return (
     <div
@@ -41,20 +33,27 @@ function Skeleton({ className, ...props }: React.ComponentProps<"div">) {
     />
   )
 }
-// CIL[END chunk_id="skeleton_skeleton_1783757774"]
-// CIL[BEGIN chunk_id="skeleton_export_1783757774" type="export" identity="export" parent="none"]
-// CIL[DOC-MACRO purpose="Export Skeleton component for use in other modules"]
-// CIL[DOC-RESPONSIBILITY responsibility="Make Skeleton component available for import"]
-// CIL[DOC-CONTEXT module="skeleton" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Skeleton component export" errors="none" side_effects="module export"]
-// CIL[DOC-MICRO logic_summary="Export the Skeleton component for external use" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, 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="context" content="purpose='Renders an animated placeholder element while content loads'; 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/skeleton.tsx:skeleton:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/skeleton.tsx:export:export" type="export" identity="export" parent="module_header"]
+// CIL[DOC-MACRO purpose="Re-exports the Skeleton component for module consumers"]
+// CIL[DOC-RESPONSIBILITY responsibility="Make the Skeleton component available to other modules"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/skeleton.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Skeleton named export" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Named export of the Skeleton component" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export { Skeleton }
-// CIL[END chunk_id="skeleton_export_1783757774"]
+// CIL[DOC-VECTOR type="context" content="purpose='Re-exports the Skeleton component for module 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/skeleton.tsx:export:export"]

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

@@ -1,42 +1,51 @@
-
-
-
-// CIL[BEGIN chunk_id="slider_module_header_1783757774" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for Slider component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import React, Radix UI Slider primitive, and utility function"]
-// CIL[DOC-CONTEXT module="slider" layer="frontend-component" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import React, Radix UI Slider primitive, and cn utility" 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: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/table-primitives.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.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[BEGIN stable_id="~/.framework/src/components/ui/slider.tsx:use_client:module_directive" type="module_directive" identity="use_client" parent="~/.framework/src/components/ui/slider.tsx"]
+// CIL[DOC-MACRO purpose="Declare this module as a client component for Next.js"]
+// CIL[DOC-RESPONSIBILITY responsibility="Mark this module for client-side rendering"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/slider.tsx" layer="ui" related_files=".framework/src/components/ui/slider.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="use client directive applied to the module" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Emits the use client directive at the top of the module" notable_decisions="Required for React client components in Next.js"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="[]"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="component developers"]
+"use client"
+// CIL[DOC-VECTOR type="context" content="purpose='Declare this module as a client component for Next.js'; 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"]
-"use client"
+// CIL[END stable_id="~/.framework/src/components/ui/slider.tsx:use_client:module_directive"]
 
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/slider.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/ui/slider.tsx"]
+// CIL[DOC-MACRO purpose="Import dependencies for the Slider component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Load React, the Radix UI Slider primitive, and the cn class merge utility"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/slider.tsx" layer="ui" related_files=".framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Imported React, SliderPrimitive, 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, the Slider primitive from radix-ui, and the cn Tailwind class merge utility" notable_decisions="Uses the @/lib/utils alias for cn"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="[]"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="component developers"]
 import * as React from "react"
 import { Slider as SliderPrimitive } from "radix-ui"
 
 import { cn } from "@/lib/utils"
-// CIL[END chunk_id="slider_module_header_1783757774"]
-// CIL[BEGIN chunk_id="slider_slider_1783757774" type="function" identity="Slider" parent="none"]
-// CIL[DOC-MACRO purpose="Custom slider component built on Radix UI"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render interactive slider with track, range, and thumbs"]
-// CIL[DOC-CONTEXT module="slider" layer="frontend-component" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX slider element" errors="none" side_effects="renders UI elements"]
-// CIL[DOC-MICRO logic_summary="Memoize values, render Radix UI primitive with track, range, and thumbs" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/table-primitives.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.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='Import dependencies for the Slider 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/slider.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/slider.tsx:slider:function" type="function" identity="Slider" parent="~/.framework/src/components/ui/slider.tsx"]
+// CIL[DOC-MACRO purpose="Render an accessible range slider using Radix UI"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a styled slider with track, range, and thumb elements"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/slider.tsx" layer="ui" related_files=".framework/src/components/ui/slider.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, defaultValue, value, min, max, and Radix SliderPrimitive.Root props" outputs="React element implementing a horizontal or vertical range slider" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes the value array from props, then renders a Radix SliderPrimitive.Root with track, range, and thumb children" notable_decisions="Defaults min to 0 and max to 100; coerces a single value into a [min, max] range"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.85" flags="[]"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="component developers"]
 function Slider({
   className,
   defaultValue,
@@ -87,20 +96,28 @@ function Slider({
     </SliderPrimitive.Root>
   )
 }
-// CIL[END chunk_id="slider_slider_1783757774"]
-// CIL[BEGIN chunk_id="slider_export_1783757774" type="export" identity="export" parent="none"]
-// CIL[DOC-MACRO purpose="Export Slider component for use in other modules"]
-// CIL[DOC-RESPONSIBILITY responsibility="Make Slider component available for import"]
-// CIL[DOC-CONTEXT module="slider" layer="frontend-component" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Slider component export" errors="none" side_effects="module export"]
-// CIL[DOC-MICRO logic_summary="Export the Slider component for external use" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.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='Render an accessible range slider using Radix UI'; 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/slider.tsx:slider:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/slider.tsx:export:export" type="export" identity="export" parent="~/.framework/src/components/ui/slider.tsx"]
+// CIL[DOC-MACRO purpose="Export the Slider component for consumers"]
+// CIL[DOC-RESPONSIBILITY responsibility="Make the Slider component available to other modules"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/slider.tsx" layer="ui" related_files=".framework/src/components/ui/slider.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Named export of the Slider component" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Re-exports the Slider function from this module" notable_decisions="Named export enables 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 { Slider }
-// CIL[END chunk_id="slider_export_1783757774"]
+// CIL[DOC-VECTOR type="context" content="purpose='Export the Slider component 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/slider.tsx:export:export"]

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

@@ -1,39 +1,32 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sonner.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/ui/sonner.tsx"]
+// CIL[DOC-MACRO purpose="Import next-themes hook, the sonner Toaster component, and Lucide icons for toast notifications"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide theme-aware toaster dependencies and the icon set used for toast states"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/sonner.tsx" layer="ui" related_files=".framework/src/components/ui/sonner.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="useTheme, Sonner Toaster, ToasterProps, and Lucide icons available in module scope" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports useTheme from next-themes, the Toaster component and its props type from sonner, and five status icons from lucide-react" notable_decisions="Uses sonner v2 and lucide-react icons"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.9" flags="[]"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="developers"]
 
-
-
-// CIL[BEGIN chunk_id="sonner_module_header_1783757774" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for toast notification component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import theme hook, Sonner library, and icons"]
-// CIL[DOC-CONTEXT module="sonner" layer="frontend-component" related_files="[\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import theme hook, Sonner toast library, and Lucide React icons" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-AUDIENCE audience="developer"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/table-primitives.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.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"]
 import { useTheme } from "next-themes"
 import { Toaster as Sonner, type ToasterProps } from "sonner"
 import { CircleCheckIcon, InfoIcon, TriangleAlertIcon, OctagonXIcon, Loader2Icon } from "lucide-react"
-// CIL[END chunk_id="sonner_module_header_1783757774"]
-// CIL[BEGIN chunk_id="sonner_toaster_1783757774" type="function" identity="Toaster" parent="none"]
-// CIL[DOC-MACRO purpose="Theme-aware toast notification component wrapper"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render Sonner toasts with theme support and custom icons"]
-// CIL[DOC-CONTEXT module="sonner" layer="frontend-component" related_files="[\".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="JSX toast container" errors="none" side_effects="renders UI elements"]
-// CIL[DOC-MICRO logic_summary="Get theme, render Sonner with theme, icons, styles, and toast options" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .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: 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='Import next-themes hook, the sonner Toaster component, and Lucide icons for toast notifications'; No verified external callers; imports: none"]
+// 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/sonner.tsx:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sonner.tsx:toaster:constant" type="constant" identity="Toaster" parent="~/.framework/src/components/ui/sonner.tsx"]
+// CIL[DOC-MACRO purpose="Render a theme-aware toast notification wrapper with custom Lucide icons and style variables"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display sonner toast notifications using the current theme and a set of custom status icons"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/sonner.tsx" layer="ui" related_files=".framework/src/components/ui/sonner.tsx"]
+// CIL[DOC-CONTRACT inputs="props: ToasterProps from sonner" outputs="JSX Sonner component configured with the active theme, CSS variables, custom icons, and a toast className" errors="none" side_effects="renders a React component tree"]
+// CIL[DOC-MICRO logic_summary="Reads the current theme from next-themes, then renders the sonner Toaster with custom icons, CSS custom properties mapped to the Tailwind theme, and a cn-toast className" notable_decisions="Defaults the theme to system; maps --popover, --popover-foreground, --border, and --radius CSS variables"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.9" flags="[]"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="developers"]
 const Toaster = ({ ...props }: ToasterProps) => {
   const { theme = "system" } = useTheme()
 
@@ -75,20 +68,27 @@ const Toaster = ({ ...props }: ToasterProps) => {
     />
   )
 }
-// CIL[END chunk_id="sonner_toaster_1783757774"]
-// CIL[BEGIN chunk_id="sonner_export_1783757774" type="export" identity="export" parent="none"]
-// CIL[DOC-MACRO purpose="Export Toaster component for use in other modules"]
-// CIL[DOC-RESPONSIBILITY responsibility="Make Toaster component available for import"]
-// CIL[DOC-CONTEXT module="sonner" layer="frontend-component" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Toaster component export" errors="none" side_effects="module export"]
-// CIL[DOC-MICRO logic_summary="Export the Toaster component for external use" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.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='Render a theme-aware toast notification wrapper with custom Lucide icons and style variables'; No verified external callers; imports: none"]
+// 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/sonner.tsx:toaster:constant"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/sonner.tsx:exports:statement" type="statement" identity="exports" parent="~/.framework/src/components/ui/sonner.tsx"]
+// CIL[DOC-MACRO purpose="Expose the configured Toaster component for external use"]
+// CIL[DOC-RESPONSIBILITY responsibility="Make the sonner Toaster wrapper available to other modules"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui/sonner.tsx" layer="ui" related_files=".framework/src/components/ui/sonner.tsx"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Toaster named export" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Named export of the Toaster constant" notable_decisions="Flat export surface"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.9" flags="[]"]
+// CIL[DOC-STABILITY stable]
+// CIL[DOC-AUDIENCE audience="developers"]
 export { Toaster }
-// CIL[END chunk_id="sonner_export_1783757774"]
+// CIL[DOC-VECTOR type="context" content="purpose='Expose the configured Toaster component for external use'; No verified external callers; imports: none"]
+// 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/sonner.tsx:exports:statement"]

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

@@ -1,57 +1,62 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/spinner.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/ui/spinner.tsx:file"]
+// CIL[DOC-MACRO purpose="shadcn/ui loading spinner component module"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide a reusable Spinner loading indicator built on lucide-react"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="cn, Loader2Icon, and Spinner component available to the module" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports the cn utility and Loader2Icon icon for the Spinner component" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="frontend"]
+
+
+
+
 
 
 
-// CIL[BEGIN chunk_id="spinner_module_header_1783757774" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies for Spinner component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Import utility function and loading icon"]
-// CIL[DOC-CONTEXT module="spinner" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Import cn utility and Loader2Icon from Lucide React" 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: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/components/ui/dialog.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/portal/pages/CoursesPage.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 { cn } from "@/lib/utils"
 import { Loader2Icon } from "lucide-react"
-// CIL[END chunk_id="spinner_module_header_1783757774"]
-// CIL[BEGIN chunk_id="spinner_spinner_1783757774" type="function" identity="Spinner" parent="none"]
-// CIL[DOC-MACRO purpose="Animated loading spinner component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render spinning loading indicator with accessibility"]
-// CIL[DOC-CONTEXT module="spinner" layer="frontend-component" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/layout/Sidebar.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/portal/pages/CoursesPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX spinner element" errors="none" side_effects="renders UI elements"]
-// CIL[DOC-MICRO logic_summary="Render Loader2Icon with spinning animation and accessibility attributes" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-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, custom/apps/portal/pages/CoursesPage.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='shadcn/ui loading spinner component module'; 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/spinner.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/spinner.tsx:spinner:function" type="function" identity="spinner" parent="~/.framework/src/components/ui/spinner.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Renders an accessible loading spinner icon"]
+// CIL[DOC-RESPONSIBILITY responsibility="Render a spinning loading indicator with default styling"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/spinner.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className?: string, ...props: React.ComponentProps<'svg'>" outputs="JSX.Element" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders Loader2Icon with role=status, aria-label=Loading, default size and animation classes, and spreads remaining props" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function Spinner({ className, ...props }: React.ComponentProps<"svg">) {
   return (
     <Loader2Icon role="status" aria-label="Loading" className={cn("size-4 animate-spin", className)} {...props} />
   )
 }
-// CIL[END chunk_id="spinner_spinner_1783757774"]
-// CIL[BEGIN chunk_id="spinner_export_1783757774" type="export" identity="export" parent="none"]
-// CIL[DOC-MACRO purpose="Export Spinner component for use in other modules"]
-// CIL[DOC-RESPONSIBILITY responsibility="Make Spinner component available for import"]
-// CIL[DOC-CONTEXT module="spinner" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Spinner component export" errors="none" side_effects="module export"]
-// CIL[DOC-MICRO logic_summary="Export the Spinner component for external use" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/layout/Sidebar.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .framework/src/components/ui/dialog.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="context" content="purpose='Renders an accessible loading spinner icon'; 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/spinner.tsx:spinner:function"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/spinner.tsx:spinner:export" type="export" identity="spinner" parent="~/.framework/src/components/ui/spinner.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Re-exports the Spinner component from the module"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose the Spinner component for external consumers"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/spinner.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Named Spinner export" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Named export for the Spinner component" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export { Spinner }
-// CIL[END chunk_id="spinner_export_1783757774"]
+// CIL[DOC-VECTOR type="context" content="purpose='Re-exports the Spinner component from the module'; 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/spinner.tsx:spinner:export"]