spine-framework 0.3.145 → 0.4.0

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

@@ -9,42 +9,40 @@
 
 
 
-// CIL[BEGIN chunk_id="ItemCard_moduleheader_1783907801" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and item display dependencies"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide all external dependencies for item card components"]
-// CIL[DOC-CONTEXT module="ItemCard" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React, Item types, UI components, icons, utils" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, item types, badge, button, icons, and utility functions" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/ItemCard.tsx:module_header:module_header" type="module_header" identity="module_header" parent=""]
+// CIL[DOC-MACRO purpose="Import dependencies and set up module for the ItemCard and ItemGrid UI components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare module-level imports for React, types, UI primitives, and utilities used by ItemCard and ItemGrid"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="imported symbols available to component chunks" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, Item/ItemType, Badge, Button, lucide-react icons, and date/text helpers" 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: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .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"]
+// CIL[DOC-AUDIENCE audience="frontend maintainers"]
 import React from 'react'
 import { Item, ItemType } from '../../types/types'
 import { Badge } from './badge'
 import { Button } from './button'
 import { Box, FileText, Calendar, User, MoreVertical } from 'lucide-react';
 import { formatDateTime, truncateText } from '../../lib/utils'
-// CIL[END chunk_id="ItemCard_moduleheader_1783907801"]
-// CIL[BEGIN chunk_id="ItemCard_itemcardprops_1783907801" type="interface" identity="ItemCardProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props for item card component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for ItemCard component configuration"]
-// CIL[DOC-CONTEXT module="ItemCard" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ItemCardProps interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Props for item data, action callbacks, and display 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/layout/Sidebar.tsx, .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, .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='Import dependencies and set up module for the ItemCard and ItemGrid UI components'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/ui/badge.tsx,.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/ItemCard.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/ItemCard.tsx:ItemCardProps:interface" type="interface" identity="ItemCardProps" parent="~/.framework/src/components/ui/ItemCard.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Define the accepted props for the ItemCard component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type the property contract and rendering options for a single item card"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/ItemCard.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="item, optional callbacks, and display flags" outputs="ItemCardProps TypeScript interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Props extend Item with an optional item_type string or object plus optional onEdit/onDelete/onView callbacks and layout flags" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface ItemCardProps {
   item: Item & { item_type?: ItemType | string }
   onEdit?: (item: Item) => void
@@ -53,21 +51,22 @@ interface ItemCardProps {
   showActions?: boolean
   compact?: boolean
 }
-// CIL[END chunk_id="ItemCard_itemcardprops_1783907801"]
-// CIL[BEGIN chunk_id="ItemCard_itemcard_1783907801" type="function" identity="ItemCard" parent="none"]
-// CIL[DOC-MACRO purpose="Render item card with optional actions in full or compact mode"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display item data with type badge, metadata, and action buttons"]
-// CIL[DOC-CONTEXT module="ItemCard" layer="frontend-component" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Item card component" errors="none" side_effects="Calls action callbacks"]
-// CIL[DOC-MICRO logic_summary="Renders different layouts based on compact prop, extracts data from item" 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: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, .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='Define the accepted props for the ItemCard component'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/ui/badge.tsx,.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/ItemCard.tsx:ItemCardProps:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/ItemCard.tsx:ItemCard:component" type="component" identity="ItemCard" parent="~/.framework/src/components/ui/ItemCard.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render a single item as a card, with an optional compact layout and action buttons"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display item title, type badge, description, metadata, and action controls"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/ItemCard.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="ItemCardProps" outputs="React JSX for the item card" errors="none" side_effects="triggers onView/onEdit callbacks when user clicks a button"]
+// CIL[DOC-MICRO logic_summary="Derives primary text, secondary description, type label and badge color, then renders either a compact or full card layout" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function ItemCard({
   item,
   onEdit,
@@ -238,21 +237,22 @@ export function ItemCard({
     </div>
   )
 }
-// CIL[END chunk_id="ItemCard_itemcard_1783907801"]
-// CIL[BEGIN chunk_id="ItemCard_itemgridprops_1783907801" type="interface" identity="ItemGridProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props for item grid container"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for ItemGrid component configuration"]
-// CIL[DOC-CONTEXT module="ItemCard" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ItemGridProps interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Props for items array, loading state, actions, and display 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/layout/Sidebar.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/schema-utils.ts, .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 single item as a card, with an optional compact layout and action buttons'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/ui/badge.tsx,.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/ItemCard.tsx:ItemCard:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/ItemCard.tsx:ItemGridProps:interface" type="interface" identity="ItemGridProps" parent="~/.framework/src/components/ui/ItemCard.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Define the accepted props for the ItemGrid component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type the property contract for rendering a list of items as a grid"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/ItemCard.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="item array, optional callbacks, loading flag, and empty message" outputs="ItemGridProps TypeScript interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Props describe a list of items with callbacks, loading/empty UI controls, and a compact flag" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface ItemGridProps {
   items: (Item & { item_type: ItemType })[]
   loading?: boolean
@@ -262,21 +262,22 @@ interface ItemGridProps {
   compact?: boolean
   emptyMessage?: string
 }
-// CIL[END chunk_id="ItemCard_itemgridprops_1783907801"]
-// CIL[BEGIN chunk_id="ItemCard_itemgrid_1783907801" type="function" identity="ItemGrid" parent="none"]
-// CIL[DOC-MACRO purpose="Render responsive grid of item cards with loading and empty states"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display items in grid layout with loading spinner and empty message"]
-// CIL[DOC-CONTEXT module="ItemCard" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Grid container or loading/empty states" errors="none" side_effects="Delegates to ItemCard actions"]
-// CIL[DOC-MICRO logic_summary="Maps items to ItemCard components, handles loading and empty states" 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: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .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='Define the accepted props for the ItemGrid component'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/ui/badge.tsx,.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/ItemCard.tsx:ItemGridProps:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/ItemCard.tsx:ItemGrid:component" type="component" identity="ItemGrid" parent="~/.framework/src/components/ui/ItemCard.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render a responsive grid of ItemCard components with loading and empty states"]
+// CIL[DOC-RESPONSIBILITY responsibility="Map an array of items to ItemCard instances and display loading or empty placeholders"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/ItemCard.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="ItemGridProps" outputs="React JSX grid, loader, or empty message" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Shows a spinner while loading, an empty message when items are absent, or a responsive grid of ItemCard components" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function ItemGrid({
   items,
   loading = false,
@@ -321,4 +322,10 @@ export function ItemGrid({
     </div>
   )
 }
-// CIL[END chunk_id="ItemCard_itemgrid_1783907801"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a responsive grid of ItemCard components with loading and empty states'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/ui/badge.tsx,.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/ItemCard.tsx:ItemGrid:component"]

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

@@ -1,3 +1,13 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/ItemListView.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Module imports and exports for the item list view UI components"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides the component library entry point, declaring dependencies and exporting ItemListView, ItemListPage, and their prop interfaces"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui" layer="ui" related_files=".framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/ItemCard.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="module imports and named exports" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, type definitions, DataTable, ItemCard, Badge, Button, icons, and date formatting utilities" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="ui developers"]
+
 
 
 
@@ -9,21 +19,6 @@
 
 
 
-// CIL[BEGIN chunk_id="ItemListView_moduleheader_1783907801" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and item list dependencies"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide all external dependencies for item list view components"]
-// CIL[DOC-CONTEXT module="ItemListView" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React, useState, item types, UI components" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React hooks, item types, DataTable, ItemCard, 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: frontend-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/RolesPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, .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"]
 import React, { useState } from 'react'
 import { Item, ItemType } from '../../types/types'
 import { DataTable } from './DataTable'
@@ -32,21 +27,22 @@ import { Badge } from './badge'
 import { Button } from './button'
 import { Squares2X2Icon, List, Plus } from 'lucide-react';
 import { formatDateTime } from '../../lib/utils'
-// CIL[END chunk_id="ItemListView_moduleheader_1783907801"]
-// CIL[BEGIN chunk_id="ItemListView_itemlistviewprops_1783907801" type="interface" identity="ItemListViewProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props for item list view component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for ItemListView component configuration"]
-// CIL[DOC-CONTEXT module="ItemListView" layer="frontend-component" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ItemListViewProps interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Props for items array, loading state, actions, and display 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/pages/admin/TypeDetailPage.tsx, .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.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="context" content="purpose='Module imports and exports for the item list view UI components'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/ItemCard.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/ItemListView.tsx:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/ItemListView.tsx:ItemListViewProps:interface" type="interface" identity="ItemListViewProps" parent="~/.framework/src/components/ui/ItemListView.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Props contract for the ItemListView component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines the shape of input properties accepted by ItemListView including items, callbacks, and display options"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui" layer="ui" related_files=".framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/ItemCard.tsx,.framework/src/components/ui/ItemListView.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ItemListViewProps TypeScript interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Type-only interface describing props for item list view rendering" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface ItemListViewProps {
   items: (Item & { item_type: ItemType })[]
   loading?: boolean
@@ -60,21 +56,22 @@ interface ItemListViewProps {
   showCreateButton?: boolean
   createButtonText?: string
 }
-// CIL[END chunk_id="ItemListView_itemlistviewprops_1783907801"]
-// CIL[BEGIN chunk_id="ItemListView_itemlistview_1783907801" type="function" identity="ItemListView" parent="none"]
-// CIL[DOC-MACRO purpose="Render switchable grid/table item view with mode toggle"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle view mode switching and item display rendering"]
-// CIL[DOC-CONTEXT module="ItemListView" layer="frontend-component" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="View mode toggle + ItemGrid or DataTable" errors="none" side_effects="Calls action callbacks"]
-// CIL[DOC-MICRO logic_summary="Manages view mode state, builds table columns, renders appropriate view" 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: custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .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='Props contract for the ItemListView component'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/ItemCard.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/ItemListView.tsx:ItemListViewProps:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/ItemListView.tsx:ItemListView:component" type="component" identity="ItemListView" parent="~/.framework/src/components/ui/ItemListView.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render an interactive item list with grid/table toggle and actions"]
+// CIL[DOC-RESPONSIBILITY responsibility="Displays items in a grid or data table, computes unique item type filters, formats dates, and wires edit/view/create handlers"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui" layer="ui" related_files=".framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/ItemCard.tsx,.framework/src/components/ui/ItemListView.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="ItemListViewProps: items, loading, onEdit, onDelete, onView, onCreate, searchable, filterable, emptyMessage, showCreateButton, createButtonText" outputs="JSX element with header, view toggle, create button, and conditional grid/table content" errors="none" side_effects="setViewMode updates local React state"]
+// CIL[DOC-MICRO logic_summary="Builds a type map from item_type values for filtering, derives a primary text/textarea display field with a name fallback, renders view mode buttons, and chooses ItemGrid or DataTable" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function ItemListView({
   items,
   loading = false,
@@ -247,21 +244,22 @@ export function ItemListView({
     </div>
   )
 }
-// CIL[END chunk_id="ItemListView_itemlistview_1783907801"]
-// CIL[BEGIN chunk_id="ItemListView_itemlistpageprops_1783907801" type="interface" identity="ItemListPageProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props for item list page component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for ItemListPage component configuration"]
-// CIL[DOC-CONTEXT module="ItemListView" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ItemListPageProps interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Extends ItemListViewProps with page-level title and description" 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: custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, .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='Render an interactive item list with grid/table toggle and actions'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/ItemCard.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/ItemListView.tsx:ItemListView:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/ItemListView.tsx:ItemListPageProps:interface" type="interface" identity="ItemListPageProps" parent="~/.framework/src/components/ui/ItemListView.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Props contract for the ItemListPage page-level wrapper"]
+// CIL[DOC-RESPONSIBILITY responsibility="Defines page wrapper props that extend ItemListViewProps with a title and description"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui" layer="ui" related_files=".framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/ItemCard.tsx,.framework/src/components/ui/ItemListView.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ItemListPageProps TypeScript interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Type-only interface extending ItemListViewProps with title and description fields" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface ItemListPageProps {
   items: (Item & { item_type: ItemType })[]
   loading?: boolean
@@ -277,21 +275,22 @@ interface ItemListPageProps {
   title?: string
   description?: string
 }
-// CIL[END chunk_id="ItemListView_itemlistpageprops_1783907801"]
-// CIL[BEGIN chunk_id="ItemListView_itemlistpage_1783907801" type="function" identity="ItemListPage" parent="none"]
-// CIL[DOC-MACRO purpose="Render full item list page with header and switchable view"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide page-level wrapper with title and ItemListView"]
-// CIL[DOC-CONTEXT module="ItemListView" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Page with header + ItemListView" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Renders page header with title/description, wraps ItemListView component" 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: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/TypeDetailPage.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='Props contract for the ItemListPage page-level wrapper'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/ItemCard.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/ItemListView.tsx:ItemListPageProps:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/ItemListView.tsx:ItemListPage:component" type="component" identity="ItemListPage" parent="~/.framework/src/components/ui/ItemListView.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Page-level wrapper that renders a titled item list page"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides a page header with title and description and delegates the list rendering to ItemListView"]
+// CIL[DOC-CONTEXT module=".framework/src/components/ui" layer="ui" related_files=".framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/ItemCard.tsx,.framework/src/components/ui/ItemListView.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/lib/utils.ts,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="ItemListPageProps: all ItemListViewProps plus title and description" outputs="JSX page layout containing a header and an ItemListView" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Renders a page header and passes all props through to ItemListView" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function ItemListPage({
   items,
   loading = false,
@@ -332,4 +331,10 @@ export function ItemListPage({
     </div>
   )
 }
-// CIL[END chunk_id="ItemListView_itemlistpage_1783907801"]
+// CIL[DOC-VECTOR type="context" content="purpose='Page-level wrapper that renders a titled item list page'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/ItemCard.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/ItemListView.tsx:ItemListPage:component"]

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

@@ -1,62 +1,51 @@
-
-
-
-
-
-
-
-// CIL[BEGIN chunk_id="LoadingSpinner_moduleheader_1783907801" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and spinner dependencies"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide all external dependencies for loading spinner component"]
-// CIL[DOC-CONTEXT module="LoadingSpinner" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React, Loader2 icon, cn utility" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, lucide-react Loader2 icon, and utility function" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/LoadingSpinner.tsx:module_header:module_header" type="module_header" identity="module_header" parent=""]
+// CIL[DOC-MACRO purpose="Import React, the Loader2 icon, and the cn utility to support the LoadingSpinner UI component."]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide module-level imports for the LoadingSpinner component and its props interface."]
+// 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="Imports the React, Loader2, and cn dependencies required by the LoadingSpinner component." 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: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/pages/admin/RolesPage.tsx, .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"]
+// CIL[DOC-AUDIENCE audience="internal"]
 import React from 'react'
 import { Loader2 } from 'lucide-react'
 import { cn } from '../../lib/utils'
-// CIL[END chunk_id="LoadingSpinner_moduleheader_1783907801"]
-// CIL[BEGIN chunk_id="LoadingSpinner_loadingspinnerprops_1783907801" type="interface" identity="LoadingSpinnerProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props for loading spinner component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for LoadingSpinner component configuration"]
-// CIL[DOC-CONTEXT module="LoadingSpinner" layer="frontend-component" related_files="[\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="LoadingSpinnerProps interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Props for optional className and size (sm/md/lg)" 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, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, .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='Import React, the Loader2 icon, and the cn utility to support the LoadingSpinner UI 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/LoadingSpinner.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/LoadingSpinner.tsx:LoadingSpinnerProps:interface" type="interface" identity="LoadingSpinnerProps" parent="~/.framework/src/components/ui/LoadingSpinner.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Declare the typed props accepted by the LoadingSpinner component."]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the className and size prop types for LoadingSpinner."]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/LoadingSpinner.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="LoadingSpinnerProps interface definition" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Declares an interface with an optional className string and an optional size union of sm, md, or lg." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface LoadingSpinnerProps {
   className?: string
   size?: 'sm' | 'md' | 'lg'
 }
-// CIL[END chunk_id="LoadingSpinner_loadingspinnerprops_1783907801"]
-// CIL[BEGIN chunk_id="LoadingSpinner_loadingspinner_1783907801" type="function" identity="LoadingSpinner" parent="none"]
-// CIL[DOC-MACRO purpose="Render animated loading spinner with configurable size"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display spinning loader icon with size and styling options"]
-// CIL[DOC-CONTEXT module="LoadingSpinner" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Animated Loader2 component" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Maps size prop to Tailwind classes, applies animation and custom classes" 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: 1. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/RolesPage.tsx, .framework/src/components/ui/dialog.tsx, \."]
-// 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='Declare the typed props accepted by the LoadingSpinner 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/LoadingSpinner.tsx:LoadingSpinnerProps:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/LoadingSpinner.tsx:loadingspinner:function" type="function" identity="loadingspinner" parent="~/.framework/src/components/ui/LoadingSpinner.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Render an animated loading spinner using the Loader2 icon with configurable size and className."]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a spinning Loader2 icon sized according to the size prop and combined with the className prop."]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/LoadingSpinner.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="LoadingSpinnerProps { className?: string, size?: 'sm' | 'md' | 'lg' }" outputs="React element: animated Loader2 icon" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Selects Tailwind size classes based on the size prop, then renders a Loader2 icon with animate-spin and merged class names." notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function LoadingSpinner({ className, size = 'md' }: LoadingSpinnerProps) {
   const sizeClasses = {
     sm: 'h-4 w-4',
@@ -74,4 +63,10 @@ export function LoadingSpinner({ className, size = 'md' }: LoadingSpinnerProps)
     />
   )
 }
-// CIL[END chunk_id="LoadingSpinner_loadingspinner_1783907801"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render an animated loading spinner using the Loader2 icon with configurable size and className.'; 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/LoadingSpinner.tsx:loadingspinner:function"]