spine-framework 0.3.145 → 0.4.1

package/.framework/src/components/shared/SchemaFields.tsx

@@ -1,27 +1,32 @@
-
-
-
-
-
-
-// CIL[BEGIN chunk_id="SchemaFields_module_header_1783927912" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import dependencies and define schema field component interfaces"]
-// CIL[DOC-RESPONSIBILITY responsibility="Manage React imports and field component prop types"]
-// CIL[DOC-CONTEXT module="schema-fields" layer="frontend-component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Imported modules and interfaces" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, field types, and component, defines SchemaFieldsProps interface" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/SchemaFields.tsx:module_header:module_header" type="module_header" identity="module_header" parent=""]
+// CIL[DOC-MACRO purpose="Provide the module-level imports for the SchemaFields shared component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import React, the FieldDefinition type, and the FieldRenderer helper"]
+// CIL[DOC-CONTEXT module="components/shared" layer="presentation" related_files=".framework/src/components/shared/FieldRenderer.tsx,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, the FieldDefinition type from types, and the FieldRenderer helper for rendering schema fields" 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/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.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="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[DOC-AUDIENCE audience="developers"]
+
 import React from 'react'
 import { FieldDefinition } from '../../types/types'
 import { FieldRenderer } from './FieldRenderer'
+// CIL[DOC-VECTOR type="context" content="purpose='Provide the module-level imports for the SchemaFields shared component'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/shared/FieldRenderer.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/shared/SchemaFields.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/SchemaFields.tsx:schemafieldsprops:interface" type="interface" identity="SchemaFieldsProps" parent="module_header"]
+// CIL[DOC-MACRO purpose="Define the props contract for the SchemaFields component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare the typed shape of props accepted by the SchemaFields function"]
+// CIL[DOC-CONTEXT module="components/shared" layer="presentation" related_files=".framework/src/components/shared/FieldRenderer.tsx,.framework/src/components/shared/SchemaFields.tsx,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="SchemaFieldsProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines an interface with fields, data, onChange, readonly, errors, twoColumn and displayTypes props" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 
 interface SchemaFieldsProps {
   fields: FieldDefinition[]
@@ -32,21 +37,23 @@ interface SchemaFieldsProps {
   twoColumn?: boolean
   displayTypes?: Record<string, string>
 }
-// CIL[END chunk_id="SchemaFields_module_header_1783927912"]
-// CIL[BEGIN chunk_id="SchemaFields_schemafields_1783927912" type="function" identity="SchemaFields" parent="none"]
-// CIL[DOC-MACRO purpose="Render schema-driven field grid with responsive layout"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display and manage multiple schema fields in grid format"]
-// CIL[DOC-CONTEXT module="schema-fields" layer="frontend-component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Responsive field grid" errors="none" side_effects="Renders UI, calls onChange"]
-// CIL[DOC-MICRO logic_summary="Maps field definitions to SchemaField components, handles system vs JSONB data resolution" 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/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.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="context" content="purpose='Define the props contract for the SchemaFields component'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/shared/FieldRenderer.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/shared/SchemaFields.tsx:schemafieldsprops:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/SchemaFields.tsx:schemafields:function" type="function" identity="SchemaFields" parent="module_header"]
+// CIL[DOC-MACRO purpose="Render a grid or list of schema fields for a record"]
+// CIL[DOC-RESPONSIBILITY responsibility="Filter valid fields, resolve values, and render per-field SchemaField children"]
+// CIL[DOC-CONTEXT module="components/shared" layer="presentation" related_files=".framework/src/components/shared/FieldRenderer.tsx,.framework/src/components/shared/SchemaFields.tsx,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="fields FieldDefinition[], data Record<string, any>, onChange function, readonly boolean, errors Record<string, string>, twoColumn boolean, displayTypes Record<string, string>" outputs="JSX.Element | null" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Guard for empty fields, render a two-column or single-column container, and map filtered fields to SchemaField with resolved values" notable_decisions="['System fields read from data[name], non-system fields fall back from data.data[name] to data[name]']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export function SchemaFields({
   fields,
   data,
@@ -81,21 +88,23 @@ export function SchemaFields({
     </div>
   )
 }
-// CIL[END chunk_id="SchemaFields_schemafields_1783927912"]
-// CIL[BEGIN chunk_id="SchemaFields_interface_1783927912" type="interface" identity="SchemaFieldProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props interface for individual schema field wrapper"]
-// CIL[DOC-RESPONSIBILITY responsibility="Type definition for SchemaField component props"]
-// CIL[DOC-CONTEXT module="schema-fields" layer="frontend-component" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Interface definition" errors="none" side_effects="Type definition"]
-// CIL[DOC-MICRO logic_summary="Defines SchemaFieldProps interface with field, value, and callback properties" 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/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/TypeDetailPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a grid or list of schema fields for a record'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/shared/FieldRenderer.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/shared/SchemaFields.tsx:schemafields:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/SchemaFields.tsx:schemafieldprops:interface" type="interface" identity="SchemaFieldProps" parent="module_header"]
+// CIL[DOC-MACRO purpose="Define the props contract for the SchemaField helper"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declare the typed shape of props accepted by the SchemaField function"]
+// CIL[DOC-CONTEXT module="components/shared" layer="presentation" related_files=".framework/src/components/shared/FieldRenderer.tsx,.framework/src/components/shared/SchemaFields.tsx,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="SchemaFieldProps interface" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Defines an interface with field, value, onChange, readonly, error and displayType props" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 interface SchemaFieldProps {
   field: FieldDefinition
   value: any
@@ -104,21 +113,23 @@ interface SchemaFieldProps {
   error?: string
   displayType?: string
 }
-// CIL[END chunk_id="SchemaFields_interface_1783927912"]
-// CIL[BEGIN chunk_id="SchemaFields_schemafield_1783927912" type="function" identity="SchemaField" parent="none"]
-// CIL[DOC-MACRO purpose="Wrapper component that binds field name to FieldRenderer"]
-// CIL[DOC-RESPONSIBILITY responsibility="Connect individual field to FieldRenderer with proper callbacks"]
-// CIL[DOC-CONTEXT module="schema-fields" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="FieldRenderer component" errors="none" side_effects="Renders FieldRenderer"]
-// CIL[DOC-MICRO logic_summary="Wraps FieldRenderer with name-binding logic and readonly handling" 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/components/ui/dialog.tsx, custom/apps/cortex/functions/custom_cil-embeddings.ts, .framework/src/pages/admin/RolesPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Define the props contract for the SchemaField helper'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/shared/FieldRenderer.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/shared/SchemaFields.tsx:schemafieldprops:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/SchemaFields.tsx:schemafield:function" type="function" identity="SchemaField" parent="module_header"]
+// CIL[DOC-MACRO purpose="Render a single schema field using FieldRenderer"]
+// CIL[DOC-RESPONSIBILITY responsibility="Wrap FieldRenderer with the field definition, resolved value, and conditional change handler"]
+// CIL[DOC-CONTEXT module="components/shared" layer="presentation" related_files=".framework/src/components/shared/FieldRenderer.tsx,.framework/src/components/shared/SchemaFields.tsx,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="field FieldDefinition, value any, onChange function, readonly boolean, error string, displayType string" outputs="FieldRenderer JSX" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Compute an onChange callback for non-readonly fields and delegate rendering to FieldRenderer" notable_decisions="['Only invokes onChange when field.name is defined']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function SchemaField({ field, value, onChange, readonly, error, displayType }: SchemaFieldProps) {
   return (
     <FieldRenderer
@@ -131,21 +142,23 @@ function SchemaField({ field, value, onChange, readonly, error, displayType }: S
     />
   )
 }
-// CIL[END chunk_id="SchemaFields_schemafield_1783927912"]
-// CIL[BEGIN chunk_id="SchemaFields_schemafielddisplay_1783927912" type="function" identity="SchemaFieldDisplay" parent="none"]
-// CIL[DOC-MACRO purpose="Render read-only field value as label:value display row"]
-// CIL[DOC-RESPONSIBILITY responsibility="Display formatted field values in compact detail view"]
-// CIL[DOC-CONTEXT module="schema-fields" layer="frontend-component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Formatted display row" errors="none" side_effects="Renders UI"]
-// CIL[DOC-MICRO logic_summary="Formats field value and renders as label-value pair with proper styling" 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: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a single schema field using FieldRenderer'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/shared/FieldRenderer.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/shared/SchemaFields.tsx:schemafield:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/SchemaFields.tsx:schemafielddisplay:function" type="function" identity="SchemaFieldDisplay" parent="module_header"]
+// CIL[DOC-MACRO purpose="Display a read-only field label and formatted value pair"]
+// CIL[DOC-RESPONSIBILITY responsibility="Format the field value and render a definition list item"]
+// CIL[DOC-CONTEXT module="components/shared" layer="presentation" related_files=".framework/src/components/shared/FieldRenderer.tsx,.framework/src/components/shared/SchemaFields.tsx,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="field FieldDefinition, value any" outputs="JSX definition list item" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Compute a display value via formatFieldValue and render a flex row with label and value" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 export function SchemaFieldDisplay({
   field,
   value
@@ -166,21 +179,23 @@ export function SchemaFieldDisplay({
     </div>
   )
 }
-// CIL[END chunk_id="SchemaFields_schemafielddisplay_1783927912"]
-// CIL[BEGIN chunk_id="SchemaFields_formatfieldvalue_1783927912" type="function" identity="formatFieldValue" parent="none"]
-// CIL[DOC-MACRO purpose="Format field values for read-only display based on data type"]
-// CIL[DOC-RESPONSIBILITY responsibility="Apply type-specific formatting to field values"]
-// CIL[DOC-CONTEXT module="schema-fields" layer="frontend-component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Formatted ReactNode" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Switches on data_type to apply appropriate formatting (dates, booleans, URLs, JSON)" 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: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Display a read-only field label and formatted value pair'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/shared/FieldRenderer.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/shared/SchemaFields.tsx:schemafielddisplay:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/shared/SchemaFields.tsx:formatfieldvalue:function" type="function" identity="formatFieldValue" parent="module_header"]
+// CIL[DOC-MACRO purpose="Format a field value for read-only display based on its data_type"]
+// CIL[DOC-RESPONSIBILITY responsibility="Convert null, boolean, date, select, multiselect, json, url and other values into a display-friendly React node"]
+// CIL[DOC-CONTEXT module="components/shared" layer="presentation" related_files=".framework/src/components/shared/FieldRenderer.tsx,.framework/src/components/shared/SchemaFields.tsx,.framework/src/types/types.ts"]
+// CIL[DOC-CONTRACT inputs="field FieldDefinition, value any" outputs="React.ReactNode" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Handle missing values then switch on data_type to format booleans, dates, select options, arrays, json, urls and defaults" notable_decisions="['Booleans render as Yes/No, null or empty values render as an em dash, and select options look up labels from field.options']"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+
 function formatFieldValue(field: FieldDefinition, value: any): React.ReactNode {
   if (value === null || value === undefined || value === '') {
     return <span className="text-slate-400 italic">—</span>
@@ -241,4 +256,10 @@ function formatFieldValue(field: FieldDefinition, value: any): React.ReactNode {
       return String(value)
   }
 }
-// CIL[END chunk_id="SchemaFields_formatfieldvalue_1783927912"]
+// CIL[DOC-VECTOR type="context" content="purpose='Format a field value for read-only display based on its data_type'; No verified external callers; imports: .framework/src/types/types.ts,.framework/src/components/shared/FieldRenderer.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/shared/SchemaFields.tsx:formatfieldvalue:function"]

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

@@ -1,3 +1,13 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/DataTable.tsx:module_header:module_header" type="module_header" identity="module_header" parent="none"]
+// CIL[DOC-MACRO purpose="Provides a reusable DataTable UI component with sorting, searching, filtering, and pagination controls"]
+// CIL[DOC-RESPONSIBILITY responsibility="Export the DataTable component and supporting column/props interfaces for use across the UI layer"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/table.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="DataTable component and TypeScript interfaces" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Contains default imports, type declarations, and the DataTable component implementation" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developer|ai"]
+
 
 
 
@@ -9,21 +19,6 @@
 
 
 
-// CIL[BEGIN chunk_id="DataTable_moduleheader_1783907801" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and table dependencies"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide all external dependencies for data table components"]
-// CIL[DOC-CONTEXT module="DataTable" 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, useState, table components, UI components" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React hooks, shadcn table primitives, badge, button, 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: 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"]
 import React, { useState } from 'react'
 import {
   Table,
@@ -37,61 +32,64 @@ import { Badge } from './badge'
 import { Button } from './button'
 import { Search, Filter } from 'lucide-react'
 import { cn } from '../../lib/utils'
-// CIL[END chunk_id="DataTable_moduleheader_1783907801"]
-// CIL[BEGIN chunk_id="DataTable_tablecolumn_1783907801" type="interface" identity="TableColumn" parent="none"]
-// CIL[DOC-MACRO purpose="Define base table column interface"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify basic column properties for table rendering"]
-// CIL[DOC-CONTEXT module="DataTable" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TableColumn interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Generic column interface with key, title, render function, and sort flag" 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/schema-utils.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/src/pages/admin/RolesPage.tsx, .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Provides a reusable DataTable UI component with sorting, searching, filtering, and pagination controls'; No verified external callers; imports: .framework/src/components/ui/table.tsx,.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/DataTable.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/DataTable.tsx:TableColumn:interface" type="interface" identity="TableColumn" parent="none"]
+// CIL[DOC-MACRO purpose="Define the base column configuration contract for a generic DataTable"]
+// CIL[DOC-RESPONSIBILITY responsibility="Describe a single table column with key, title, optional renderer and sort flag"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/table.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="TableColumn<T> type" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Base generic interface for a table column" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface TableColumn<T> {
   key: keyof T | string
   title: string
   render?: (row: T) => React.ReactNode
   sortable?: boolean
 }
-// CIL[END chunk_id="DataTable_tablecolumn_1783907801"]
-// CIL[BEGIN chunk_id="DataTable_datatablecolumn_1783907801" type="interface" identity="DataTableColumn" parent="none"]
-// CIL[DOC-MACRO purpose="Define extended table column interface with filtering"]
-// CIL[DOC-RESPONSIBILITY responsibility="Extend TableColumn with filter-specific properties"]
-// CIL[DOC-CONTEXT module="DataTable" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="DataTableColumn interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Adds filterable flag and filter options array to base column interface" 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/schema-utils.ts, .framework/src/pages/admin/IntegrationsPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/functions/custom_cil-embeddings.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='Define the base column configuration contract for a generic DataTable'; No verified external callers; imports: .framework/src/components/ui/table.tsx,.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/DataTable.tsx:TableColumn:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/DataTable.tsx:DataTableColumn:interface" type="interface" identity="DataTableColumn" parent="none"]
+// CIL[DOC-MACRO purpose="Extend TableColumn with filter-specific properties for the DataTable"]
+// CIL[DOC-RESPONSIBILITY responsibility="Add filterable flag and filter options to a table column"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/table.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="DataTableColumn<T> type" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="DataTable column interface extending TableColumn with filtering support" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface DataTableColumn<T> extends TableColumn<T> {
   filterable?: boolean
   filterOptions?: Array<{ value: string; label: string }>
 }
-// CIL[END chunk_id="DataTable_datatablecolumn_1783907801"]
-// CIL[BEGIN chunk_id="DataTable_datatableprops_1783907801" type="interface" identity="DataTableProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define comprehensive data table props interface"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for DataTable component configuration"]
-// CIL[DOC-CONTEXT module="DataTable" layer="frontend-component" related_files="[\".framework/src/components/layout/Sidebar.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="DataTableProps interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Extensive props for data, columns, search, filters, pagination, and callbacks" 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/IntegrationsPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/functions/_shared/principal.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Extend TableColumn with filter-specific properties for the DataTable'; No verified external callers; imports: .framework/src/components/ui/table.tsx,.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/DataTable.tsx:DataTableColumn:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/DataTable.tsx:DataTableProps:interface" type="interface" identity="DataTableProps" parent="none"]
+// CIL[DOC-MACRO purpose="Define the prop contract for the DataTable component"]
+// CIL[DOC-RESPONSIBILITY responsibility="List all configurable props including data, columns, pagination, sort, search, filter, and callbacks"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/table.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="DataTableProps<T> type" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Props interface for the DataTable component" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface DataTableProps<T> {
   data: T[]
   columns: DataTableColumn<T>[]
@@ -116,21 +114,22 @@ interface DataTableProps<T> {
   emptyMessage?: string
   className?: string
 }
-// CIL[END chunk_id="DataTable_datatableprops_1783907801"]
-// CIL[BEGIN chunk_id="DataTable_datatable_1783907801" type="function" identity="DataTable" parent="none"]
-// CIL[DOC-MACRO purpose="Render full-featured data table with search, filters, sort, and pagination"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle table state management, user interactions, and data rendering"]
-// CIL[DOC-CONTEXT module="DataTable" layer="frontend-component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Table with search/filter controls" errors="none" side_effects="Calls search/filter/sort callbacks"]
-// CIL[DOC-MICRO logic_summary="Manages internal search/filter state, renders UI controls and table body" 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: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Define the prop contract for the DataTable component'; No verified external callers; imports: .framework/src/components/ui/table.tsx,.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/DataTable.tsx:DataTableProps:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/DataTable.tsx:DataTable:component" type="component" identity="DataTable" parent="none"]
+// CIL[DOC-MACRO purpose="Render a searchable, filterable, sortable data table with pagination"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display tabular data, manage search/filter UI state, and call provided handlers"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/DataTable.tsx,.framework/src/components/ui/badge.tsx,.framework/src/components/ui/button.tsx,.framework/src/components/ui/table.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="data: T[], columns: DataTableColumn<T>[], loading: boolean, searchable: boolean, filterable: boolean, pagination, sort/search/filter callbacks" outputs="Rendered table UI with search, filters, active filter badges and pagination controls" errors="none" side_effects="Calls onSearch, onFilter, onSort, onRowClick callbacks and updates local useState"]
+// CIL[DOC-MICRO logic_summary="Uses React state for search query, filter map and filter visibility; renders optional search input, filter dropdowns, active filter badges, table, and pagination" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function DataTable<T extends Record<string, any>>({
   data,
   columns,
@@ -272,8 +271,14 @@ export function DataTable<T extends Record<string, any>>({
           )}
           
           {Object.entries(filters).map(([key, value]) => {
+
+
             const column = columns.find(col => String(col.key) === key)
+
+
+
             const option = column?.filterOptions?.find(opt => opt.value === value)
+
             
             return (
               <Badge key={key} variant="info" className="flex items-center">
@@ -370,4 +375,11 @@ export function DataTable<T extends Record<string, any>>({
     </div>
   )
 }
-// CIL[END chunk_id="DataTable_datatable_1783907801"]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a searchable, filterable, sortable data table with pagination'; No verified external callers; imports: .framework/src/components/ui/table.tsx,.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/DataTable.tsx:DataTable:component"]
+