spine-framework 0.3.145 → 0.4.1

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

@@ -1,41 +1,101 @@
-
-
-
-
-
-
-
-
-
-
-// CIL[BEGIN chunk_id="chart_module_header_1783881474" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Chart component library with Recharts integration"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide chart infrastructure and configuration types"]
-// CIL[DOC-CONTEXT module="ui.chart" layer="component" related_files="[\".framework/src/pages/admin/IntegrationsPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Chart types, constants, context" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Defines chart configuration system, themes, and React context" notable_decisions="['theme-aware styling', 'flexible color configuration', 'context pattern']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:use_client:directive" type="directive" identity="use_client" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Mark this module as a client-side React component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Indicate the module must run in the browser"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Next.js use client directive" 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: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/IntegrationsPage.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+"use client"
+// CIL[DOC-VECTOR type="context" content="purpose='Mark this module as a client-side React 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"]
-"use client"
-
+// CIL[END stable_id="~/.framework/src/components/ui/chart.tsx:use_client:directive"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Import dependencies for the chart component module"]
+// CIL[DOC-RESPONSIBILITY responsibility="Load React, Recharts primitives, and the cn utility"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, Recharts, TooltipValueType, and cn" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="frontend-developers"]
 import * as React from "react"
 import * as RechartsPrimitive from "recharts"
 import type { TooltipValueType } from "recharts"
 
 import { cn } from "@/lib/utils"
-
+// CIL[DOC-VECTOR type="context" content="purpose='Import dependencies for the chart component module'; No verified external callers; imports: .framework/src/lib/utils.ts"]
+// CIL[DOC-VECTOR type="blast_radius" content="No direct caller data from CIL graph; local impact only"]
+// CIL[DOC-VECTOR type="configuration" content="No environment or build configuration dependencies identified"]
+// CIL[DOC-VECTOR type="constraint" content="Standard runtime; no special invariants documented"]
+// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
+// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
+// CIL[END stable_id="~/.framework/src/components/ui/chart.tsx:module_header:module_header"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:THEMES:constant" type="constant" identity="THEMES" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Define CSS selector prefixes for light and dark themes"]
+// CIL[DOC-RESPONSIBILITY responsibility="Map theme keys to CSS class prefixes"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{ light: "", dark: ".dark" }" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Object mapping light to empty and dark to .dark" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const THEMES = { light: "", dark: ".dark" } as const
-
+// CIL[DOC-VECTOR type="context" content="purpose='Define CSS selector prefixes for light and dark themes'; 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/chart.tsx:THEMES:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:INITIAL_DIMENSION:constant" type="constant" identity="INITIAL_DIMENSION" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Provide default dimensions for the responsive chart container"]
+// CIL[DOC-RESPONSIBILITY responsibility="Supply fallback width and height before resize"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{ width: 320, height: 200 }" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Default width 320 and height 200 as const" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const INITIAL_DIMENSION = { width: 320, height: 200 } as const
+// CIL[DOC-VECTOR type="context" content="purpose='Provide default dimensions for the responsive chart container'; 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/chart.tsx:INITIAL_DIMENSION:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:TooltipNameType:type" type="type" identity="TooltipNameType" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Allow tooltip names to be numbers or strings"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type alias for tooltip label keys"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="number | string" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Union of number and string" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 type TooltipNameType = number | string
-
+// CIL[DOC-VECTOR type="context" content="purpose='Allow tooltip names to be numbers or strings'; 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/chart.tsx:TooltipNameType:type"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:ChartConfig:type" type="type" identity="ChartConfig" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Define the shape of chart color and label configuration"]
+// CIL[DOC-RESPONSIBILITY responsibility="Type the mapping of data keys to labels, icons, and theme-aware colors"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ChartConfig type alias" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Record of key to label, icon, and exclusive color or theme map" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export type ChartConfig = Record<
   string,
   {
@@ -46,27 +106,58 @@ export type ChartConfig = Record<
     | { color?: never; theme: Record<keyof typeof THEMES, string> }
   )
 >
-
+// CIL[DOC-VECTOR type="context" content="purpose='Define the shape of chart color and label configuration'; 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/chart.tsx:ChartConfig:type"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:ChartContextProps:type" type="type" identity="ChartContextProps" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Type the chart context value"]
+// CIL[DOC-RESPONSIBILITY responsibility="Carry the active ChartConfig down the tree"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="{ config: ChartConfig }" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Object containing the chart config" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 type ChartContextProps = {
   config: ChartConfig
 }
-
-const ChartContext = React.createContext<ChartContextProps | null>(null)
-// CIL[END chunk_id="chart_module_header_1783881474"]
-// CIL[BEGIN chunk_id="chart_usechart_1783881474" type="function" identity="useChart" parent="none"]
-// CIL[DOC-MACRO purpose="Hook to access chart configuration context"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide safe access to chart context with error handling"]
-// CIL[DOC-CONTEXT module="ui.chart" layer="component" related_files="[\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ChartContextProps" errors="throws if not in ChartContainer" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Retrieves chart context and throws descriptive error if missing" notable_decisions="['context validation', 'developer-friendly error messages']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[DOC-VECTOR type="context" content="purpose='Type the chart context value'; 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/chart.tsx:ChartContextProps:type"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:ChartContext:constant" type="constant" identity="ChartContext" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Create a React context for chart configuration"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provide ChartContext to container and child components"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="React context" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="React.createContext with null default" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 2. Direct calls: 0. Related files: custom/apps/cortex/functions/custom_cil-embeddings.ts, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/principal.ts, .framework/src/pages/admin/RolesPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 2. Total affected: 2."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+const ChartContext = React.createContext<ChartContextProps | null>(null)
+// CIL[DOC-VECTOR type="context" content="purpose='Create a React context for chart configuration'; 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/chart.tsx:ChartContext:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:useChart:hook" type="hook" identity="useChart" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Access the surrounding ChartContext value"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return chart config or throw if outside a container"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ChartConfig from context" errors="Error if context is null" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="useContext wrapper with missing-context guard" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function useChart() {
   const context = React.useContext(ChartContext)
 
@@ -76,21 +167,22 @@ function useChart() {
 
   return context
 }
-// CIL[END chunk_id="chart_usechart_1783881474"]
-// CIL[BEGIN chunk_id="chart_chartcontainer_1783881474" type="function" identity="ChartContainer" parent="none"]
-// CIL[DOC-MACRO purpose="Main chart container with responsive layout and context provider"]
-// CIL[DOC-RESPONSIBILITY responsibility="Wrap chart components with responsive container and configuration context"]
-// CIL[DOC-CONTEXT module="ui.chart" layer="component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/db.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="responsive chart container" errors="none" side_effects="provides context, renders DOM"]
-// CIL[DOC-MICRO logic_summary="Generates unique chart ID, provides context, applies comprehensive styling" notable_decisions="['unique ID generation', 'comprehensive recharts styling', 'responsive container pattern']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/dialog.tsx, .framework/functions/_shared/principal.ts, .framework/functions/_shared/db.ts, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Access the surrounding ChartContext value'; 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/chart.tsx:useChart:hook"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:ChartContainer:component" type="component" identity="ChartContainer" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Render a chart inside a styled responsive container"]
+// CIL[DOC-RESPONSIBILITY responsibility="Generate a unique chart id, provide config context, and wrap Recharts ResponsiveContainer"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="id, className, children, config, initialDimension, div props" outputs="JSX wrapping ResponsiveContainer" errors="" side_effects="sets ChartContext.Provider"]
+// CIL[DOC-MICRO logic_summary="Computes chartId, renders Provider, div, ChartStyle, and ResponsiveContainer" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ChartContainer({
   id,
   className,
@@ -132,21 +224,22 @@ function ChartContainer({
     </ChartContext.Provider>
   )
 }
-// CIL[END chunk_id="chart_chartcontainer_1783881474"]
-// CIL[BEGIN chunk_id="chart_chartstyle_1783881474" type="function" identity="ChartStyle" parent="none"]
-// CIL[DOC-MACRO purpose="Dynamic CSS generation for chart theme colors"]
-// CIL[DOC-RESPONSIBILITY responsibility="Generate theme-aware CSS variables for chart colors"]
-// CIL[DOC-CONTEXT module="ui.chart" layer="component" related_files="[\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="style element with CSS variables" errors="none" side_effects="injects styles into DOM"]
-// CIL[DOC-MICRO logic_summary="Creates CSS custom properties for chart colors across light/dark themes" notable_decisions="['dynamic CSS generation', 'theme-aware color system', 'dangerouslySetInnerHTML usage']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/pages/admin/TypeDetailPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, .framework/functions/_shared/schema-utils.ts, custom/apps/portal/pages/ContentPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a chart inside a styled responsive container'; 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/chart.tsx:ChartContainer:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:ChartStyle:component" type="component" identity="ChartStyle" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Generate CSS custom properties for chart colors per theme"]
+// CIL[DOC-RESPONSIBILITY responsibility="Inject a style tag mapping each config color to --color-* variables"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="id, config" outputs="style element or null" errors="" side_effects="injects inline styles into DOM"]
+// CIL[DOC-MICRO logic_summary="Filters color config, maps themes, and produces CSS variable rules" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const ChartStyle = ({ id, config }: { id: string; config: ChartConfig }) => {
   const colorConfig = Object.entries(config).filter(
     ([, config]) => config.theme ?? config.color
@@ -179,37 +272,39 @@ ${colorConfig
     />
   )
 }
-// CIL[END chunk_id="chart_chartstyle_1783881474"]
-// CIL[BEGIN chunk_id="chart_charttooltip_1783881474" type="constant" identity="ChartTooltip" parent="none"]
-// CIL[DOC-MACRO purpose="Re-export of Recharts Tooltip component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide direct access to underlying Recharts tooltip"]
-// CIL[DOC-CONTEXT module="ui.chart" layer="component" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Recharts Primitive Tooltip" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Simple re-export for advanced tooltip customization" notable_decisions="['re-export pattern', 'library integration']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/pages/admin/RolesPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 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='Generate CSS custom properties for chart colors per theme'; 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"]
-const ChartTooltip = RechartsPrimitive.Tooltip
-// CIL[END chunk_id="chart_charttooltip_1783881474"]
-// CIL[BEGIN chunk_id="chart_charttooltipcontent_1783881474" type="function" identity="ChartTooltipContent" parent="none"]
-// CIL[DOC-MACRO purpose="Custom tooltip content with configurable indicators and formatting"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render styled tooltip with chart configuration integration"]
-// CIL[DOC-CONTEXT module="ui.chart" layer="component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled tooltip component" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Complex tooltip rendering with label formatting, custom indicators, and chart config integration" notable_decisions="['complex prop interface', 'multiple indicator types', 'custom formatting support']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[END stable_id="~/.framework/src/components/ui/chart.tsx:ChartStyle:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:ChartTooltip:constant" type="constant" identity="ChartTooltip" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Expose the Recharts Tooltip component under the Chart namespace"]
+// CIL[DOC-RESPONSIBILITY responsibility="Re-export RechartsPrimitive.Tooltip"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Tooltip component" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Alias to RechartsPrimitive.Tooltip" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 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."]
+const ChartTooltip = RechartsPrimitive.Tooltip
+// CIL[DOC-VECTOR type="context" content="purpose='Expose the Recharts Tooltip component under the Chart namespace'; 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/chart.tsx:ChartTooltip:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:ChartTooltipContent:component" type="component" identity="ChartTooltipContent" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Render a customized tooltip for Recharts charts"]
+// CIL[DOC-RESPONSIBILITY responsibility="Format tooltip label, indicator, and payload values using chart config"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="active, payload, className, indicator, hideLabel, hideIndicator, label, labelFormatter, labelClassName, formatter, color, nameKey, labelKey, Tooltip props, React" outputs="JSX tooltip or null" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Computes label from payload and config, renders dot/line/dashed indicators and values" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ChartTooltipContent({
   active,
   payload,
@@ -363,37 +458,39 @@ function ChartTooltipContent({
     </div>
   )
 }
-// CIL[END chunk_id="chart_charttooltipcontent_1783881474"]
-// CIL[BEGIN chunk_id="chart_chartlegend_1783881474" type="constant" identity="ChartLegend" parent="none"]
-// CIL[DOC-MACRO purpose="Re-export of Recharts Legend component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide direct access to underlying Recharts legend"]
-// CIL[DOC-CONTEXT module="ui.chart" layer="component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Recharts Primitive Legend" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Simple re-export for advanced legend customization" notable_decisions="['re-export pattern', 'library integration']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a customized tooltip for Recharts charts'; 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"]
-const ChartLegend = RechartsPrimitive.Legend
-// CIL[END chunk_id="chart_chartlegend_1783881474"]
-// CIL[BEGIN chunk_id="chart_chartlegendcontent_1783881474" type="function" identity="ChartLegendContent" parent="none"]
-// CIL[DOC-MACRO purpose="Custom legend content with configurable icons and alignment"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render styled legend with chart configuration integration"]
-// CIL[DOC-CONTEXT module="ui.chart" layer="component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="styled legend component" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Maps legend payload to styled items with optional icons and configuration" notable_decisions="['config-aware rendering', 'flexible icon support', 'vertical alignment options']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
+// CIL[END stable_id="~/.framework/src/components/ui/chart.tsx:ChartTooltipContent:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:ChartLegend:constant" type="constant" identity="ChartLegend" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Expose the Recharts Legend component under the Chart namespace"]
+// CIL[DOC-RESPONSIBILITY responsibility="Re-export RechartsPrimitive.Legend"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Legend component" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Alias to RechartsPrimitive.Legend" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
 // CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 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."]
+const ChartLegend = RechartsPrimitive.Legend
+// CIL[DOC-VECTOR type="context" content="purpose='Expose the Recharts Legend component under the Chart namespace'; 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/chart.tsx:ChartLegend:constant"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:ChartLegendContent:component" type="component" identity="ChartLegendContent" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Render a customized legend for Recharts charts"]
+// CIL[DOC-RESPONSIBILITY responsibility="Map payload items to labels and color swatches using chart config"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="className, hideIcon, payload, verticalAlign, nameKey, div props" outputs="JSX legend or null" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Filters payload, resolves item config, renders icon or color dot with label" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ChartLegendContent({
   className,
   hideIcon = false,
@@ -448,21 +545,22 @@ function ChartLegendContent({
     </div>
   )
 }
-// CIL[END chunk_id="chart_chartlegendcontent_1783881474"]
-// CIL[BEGIN chunk_id="chart_getpayloadconfigfrompayload_1783881474" type="function" identity="getPayloadConfigFromPayload" parent="none"]
-// CIL[DOC-MACRO purpose="Extract chart configuration from tooltip payload"]
-// CIL[DOC-RESPONSIBILITY responsibility="Resolve chart config items from complex payload structures"]
-// CIL[DOC-CONTEXT module="ui.chart" layer="component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ChartConfig item or undefined" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Handles nested payload structures and dynamic key resolution" notable_decisions="['defensive programming', 'nested object handling', 'key fallback strategy']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: none."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Render a customized legend for Recharts charts'; 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/chart.tsx:ChartLegendContent:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:getPayloadConfigFromPayload:function" type="function" identity="getPayloadConfigFromPayload" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Resolve the chart config entry for a payload item"]
+// CIL[DOC-RESPONSIBILITY responsibility="Determine which config key to use based on payload fields"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="config: ChartConfig, payload: unknown, key: string" outputs="ChartConfig entry for the resolved key" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Looks for key in payload and payload.payload, falls back to original key" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function getPayloadConfigFromPayload(
   config: ChartConfig,
   payload: unknown,
@@ -498,21 +596,22 @@ function getPayloadConfigFromPayload(
 
   return configLabelKey in config ? config[configLabelKey] : config[key]
 }
-// CIL[END chunk_id="chart_getpayloadconfigfrompayload_1783881474"]
-// CIL[BEGIN chunk_id="chart_exports_1783881474" type="exports" identity="exports" parent="none"]
-// CIL[DOC-MACRO purpose="Export chart components and utilities for public API"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide public interface for chart component library"]
-// CIL[DOC-CONTEXT module="ui.chart" layer="component" related_files="[]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="named exports of chart components" errors="none" side_effects="module exports"]
-// CIL[DOC-MICRO logic_summary="Exports all chart components and utilities for consumption" notable_decisions="['comprehensive export strategy', 'named exports pattern']"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: component. Direct callers: 0. Direct calls: 0. Related files: 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='Resolve the chart config entry for a payload item'; 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/chart.tsx:getPayloadConfigFromPayload:function"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/chart.tsx:exports:export" type="export" identity="exports" parent="~/.framework/src/components/ui/chart.tsx"]
+// CIL[DOC-MACRO purpose="Export public chart components and helpers"]
+// CIL[DOC-RESPONSIBILITY responsibility="Expose ChartContainer, ChartTooltip, ChartTooltipContent, ChartLegend, ChartLegendContent, and ChartStyle"]
+// CIL[DOC-CONTEXT module="components/ui" layer="presentation" related_files=".framework/src/components/ui/chart.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="named exports" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Named exports for chart primitives" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export {
   ChartContainer,
   ChartTooltip,
@@ -521,4 +620,10 @@ export {
   ChartLegendContent,
   ChartStyle,
 }
-// CIL[END chunk_id="chart_exports_1783881474"]
+// CIL[DOC-VECTOR type="context" content="purpose='Export public chart components and helpers'; 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/chart.tsx:exports:export"]