spine-framework 0.3.145 → 0.4.0

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

@@ -1,23 +1,19 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/Modal.tsx:module_header:module_header" type="module_header" identity="module_header" parent="~/.framework/src/components/ui/Modal.tsx"]
+// CIL[DOC-MACRO purpose="shadcn/ui Modal component module built on Radix UI Dialog"]
+// CIL[DOC-RESPONSIBILITY responsibility="Imports dialog primitives and utils, then exports Modal and ModalFooter components"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/dialog.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="Modal and ModalFooter components, plus their prop interfaces" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Imports React, the cn utility, and local Dialog primitives; declares the public component exports" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="frontend"]
+
+
 
 
 
 
 
-// CIL[BEGIN chunk_id="Modal_moduleheader_1783907801" type="module_header" identity="imports" parent="none"]
-// CIL[DOC-MACRO purpose="Import React and dialog dependencies"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide all external dependencies for modal components"]
-// CIL[DOC-CONTEXT module="Modal" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="React, cn, Dialog components" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports React, utility function, and shadcn dialog primitives" 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/components/ui/dialog.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="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import React from 'react'
 import { cn } from '../../lib/utils'
 import {
@@ -27,21 +23,23 @@ import {
   DialogTitle,
   DialogDescription,
 } from './dialog'
-// CIL[END chunk_id="Modal_moduleheader_1783907801"]
-// CIL[BEGIN chunk_id="Modal_modalprops_1783907801" type="interface" identity="ModalProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define main modal component props interface"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify all props needed for Modal component configuration"]
-// CIL[DOC-CONTEXT module="Modal" layer="frontend-component" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/functions/_shared/schema-utils.ts\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ModalProps interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Props for open state, close handler, content, and sizing" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: frontend-component. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/components/ui/table-primitives.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='shadcn/ui Modal component module built on Radix UI Dialog'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/dialog.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/Modal.tsx:module_header:module_header"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/Modal.tsx:ModalProps:interface" type="interface" identity="ModalProps" parent="~/.framework/src/components/ui/Modal.tsx"]
+// CIL[DOC-MACRO purpose="Defines the prop contract for the Modal component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declares the configuration surface for Modal consumers"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/Modal.tsx,.framework/src/components/ui/dialog.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ModalProps TypeScript interface" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Optional title and description, required open state, close callback, children, and a size union" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface ModalProps {
   isOpen: boolean
   onClose: () => void
@@ -50,21 +48,23 @@ interface ModalProps {
   children: React.ReactNode
   size?: 'sm' | 'md' | 'lg' | 'xl'
 }
-// CIL[END chunk_id="Modal_modalprops_1783907801"]
-// CIL[BEGIN chunk_id="Modal_modal_1783907801" type="function" identity="Modal" parent="none"]
-// CIL[DOC-MACRO purpose="Render modal dialog with configurable size and content"]
-// CIL[DOC-RESPONSIBILITY responsibility="Handle modal open/close state and content rendering"]
-// CIL[DOC-CONTEXT module="Modal" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/functions/_shared/principal.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Dialog wrapper" errors="none" side_effects="Calls onClose when dialog closed"]
-// CIL[DOC-MICRO logic_summary="Maps size prop to Tailwind max-width classes, conditionally renders header" 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/pages/operations/OperationsDashboard.tsx, .framework/src/components/ui/table-primitives.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='Defines the prop contract for the Modal component'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/dialog.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/Modal.tsx:ModalProps:interface"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/Modal.tsx:Modal:component" type="component" identity="Modal" parent="~/.framework/src/components/ui/Modal.tsx"]
+// CIL[DOC-MACRO purpose="Renders an accessible modal dialog with configurable size and optional header"]
+// CIL[DOC-RESPONSIBILITY responsibility="Mounts a Dialog, applies size-based width classes, and renders optional title and description"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/Modal.tsx,.framework/src/components/ui/dialog.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="isOpen: boolean, onClose: () => void, title?: string, description?: string, children: React.ReactNode, size?: 'sm'|'md'|'lg'|'xl'" outputs="JSX.Element" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Maps size prop to Tailwind max-width classes and conditionally renders a DialogHeader" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function Modal({
   isOpen,
   onClose,
@@ -94,40 +94,44 @@ export function Modal({
     </Dialog>
   )
 }
-// CIL[END chunk_id="Modal_modal_1783907801"]
-// CIL[BEGIN chunk_id="Modal_modalfooterprops_1783907801" type="interface" identity="ModalFooterProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props for modal footer container"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify props for modal footer content and styling"]
-// CIL[DOC-CONTEXT module="Modal" layer="frontend-component" related_files="[\".framework/functions/_shared/principal.ts\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/TypeDetailPage.tsx\",\".framework/src/pages/admin/IntegrationsPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="ModalFooterProps interface" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Props for children content and optional styling 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: 0. Direct calls: 0. Related files: .framework/functions/_shared/principal.ts, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/TypeDetailPage.tsx, .framework/src/pages/admin/IntegrationsPage.tsx, custom/apps/portal/pages/ContentPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders an accessible modal dialog with configurable size and optional header'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/dialog.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/Modal.tsx:Modal:component"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/Modal.tsx:ModalFooterProps:interface" type="interface" identity="ModalFooterProps" parent="~/.framework/src/components/ui/Modal.tsx"]
+// CIL[DOC-MACRO purpose="Defines the prop contract for the ModalFooter component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Declares the configuration surface for ModalFooter consumers"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/Modal.tsx,.framework/src/components/ui/dialog.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="ModalFooterProps TypeScript interface" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Optional className and required children for the footer content" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface ModalFooterProps {
   children: React.ReactNode
   className?: string
 }
-// CIL[END chunk_id="Modal_modalfooterprops_1783907801"]
-// CIL[BEGIN chunk_id="Modal_modalfooter_1783907801" type="function" identity="ModalFooter" parent="none"]
-// CIL[DOC-MACRO purpose="Render modal footer with action buttons"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide styled container for modal action buttons"]
-// CIL[DOC-CONTEXT module="Modal" layer="frontend-component" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/table-primitives.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="Footer div container" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Uses Tailwind classes for flex layout, border, and spacing" 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/table-primitives.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
+// CIL[DOC-VECTOR type="context" content="purpose='Defines the prop contract for the ModalFooter component'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/dialog.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/Modal.tsx:ModalFooterProps:interface"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/Modal.tsx:ModalFooter:component" type="component" identity="ModalFooter" parent="~/.framework/src/components/ui/Modal.tsx"]
+// CIL[DOC-MACRO purpose="Renders a right-aligned, bordered footer for modal actions"]
+// CIL[DOC-RESPONSIBILITY responsibility="Provides a styled container for modal action buttons"]
+// CIL[DOC-CONTEXT module="components/ui" layer="ui" related_files=".framework/src/components/ui/Modal.tsx,.framework/src/components/ui/dialog.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="children: React.ReactNode, className?: string" outputs="JSX.Element" errors="" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Composes a flex row with gap and top border, allowing an extra className" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function ModalFooter({ children, className }: ModalFooterProps) {
   return (
     <div className={cn('flex justify-end gap-3 border-t px-6 py-4 mt-6', className)}>
@@ -135,4 +139,10 @@ export function ModalFooter({ children, className }: ModalFooterProps) {
     </div>
   )
 }
-// CIL[END chunk_id="Modal_modalfooter_1783907801"]
+// CIL[DOC-VECTOR type="context" content="purpose='Renders a right-aligned, bordered footer for modal actions'; No verified external callers; imports: .framework/src/lib/utils.ts,.framework/src/components/ui/dialog.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/Modal.tsx:ModalFooter:component"]

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

@@ -1,23 +1,19 @@
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/RichTextEditor.tsx:module_header:module_header"]
+// CIL[DOC-MACRO purpose="Declare dependencies and set up the RichTextEditor module"]
+// CIL[DOC-RESPONSIBILITY responsibility="Import and expose all required libraries, components, and utilities"]
+// CIL[DOC-CONTEXT module="RichTextEditor" layer="ui" related_files=".framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="none" errors="none" side_effects="loads module dependencies"]
+// CIL[DOC-MICRO logic_summary="Imports DOMPurify, marked, TipTap, lowlight, language definitions, React hooks, icons, and the cn utility" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
+// CIL[DOC-AUDIENCE audience="developers"]
+
+
 
 
 
 
 
-// CIL[BEGIN chunk_id="richtexteditor_module_header_1783883196" type="module_header" identity="module_header" parent="none"]
-// CIL[DOC-MACRO purpose="Import TipTap editor, extensions, syntax highlighting, and UI dependencies"]
-// CIL[DOC-RESPONSIBILITY responsibility="Provide external dependencies for rich text editor system"]
-// CIL[DOC-CONTEXT module="richtexteditor" layer="ui" related_files="[\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="TipTap, extensions, lowlight, icons, utils" errors="none" side_effects="none"]
-// CIL[DOC-MICRO logic_summary="Imports TipTap editor core, extensions, syntax highlighting libraries, icons, and utilities" 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: ui. Direct callers: 0. Direct calls: 0. Related files: custom/apps/cortex/pages/operations/OperationsDashboard.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 0. Total affected: 0."]
-// CIL[DOC-VECTOR type="configuration" content="No configuration dependencies."]
-// CIL[DOC-VECTOR type="constraint" content="No test paths identified."]
-// CIL[DOC-VECTOR type="implementation_pattern" content="" status="pending_human_input"]
-// CIL[DOC-VECTOR type="user_journey" content="" status="pending_human_input"]
 import DOMPurify from 'dompurify'
 import { marked } from 'marked'
 import { useEditor, EditorContent } from '@tiptap/react'
@@ -43,50 +39,66 @@ import {
   Minus,
 } from 'lucide-react'
 import { cn } from '@core/lib/utils'
-// CIL[END chunk_id="richtexteditor_module_header_1783883196"]
-// CIL[BEGIN chunk_id="richtexteditor_lowlight_1783883196" type="setup" identity="lowlight" parent="none"]
-// CIL[DOC-MACRO purpose="Configure syntax highlighting for code blocks"]
-// CIL[DOC-RESPONSIBILITY responsibility="Set up lowlight with multiple programming languages"]
-// CIL[DOC-CONTEXT module="richtexteditor" layer="ui" 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="lowlight instance" errors="none" side_effects="global config"]
-// CIL[DOC-MICRO logic_summary="Creates lowlight instance and registers TypeScript, JavaScript, JSON, Bash, SQL languages" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui. 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='Declare dependencies and set up the RichTextEditor 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/RichTextEditor.tsx:module_header:module_header"]
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/RichTextEditor.tsx:lowlight_setup:setup"]
+// CIL[DOC-MACRO purpose="Create and configure the lowlight syntax highlighter"]
+// CIL[DOC-RESPONSIBILITY responsibility="Register language parsers with lowlight for code block highlighting"]
+// CIL[DOC-CONTEXT module="RichTextEditor" layer="ui" related_files=".framework/src/components/ui/RichTextEditor.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="none" outputs="lowlight: Lowlight" errors="none" side_effects="registers TypeScript, JavaScript, JSON, Bash, and SQL language parsers in the lowlight instance"]
+// CIL[DOC-MICRO logic_summary="Creates a lowlight instance and registers five language parsers for code block syntax highlighting" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 const lowlight = createLowlight()
 lowlight.register('typescript', typescript)
 lowlight.register('javascript', javascript)
 lowlight.register('json', json)
 lowlight.register('bash', bash)
 lowlight.register('sql', sql)
+// CIL[DOC-VECTOR type="context" content="purpose='Create and configure the lowlight syntax highlighter'; 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/RichTextEditor.tsx:lowlight_setup:setup"]
 
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/RichTextEditor.tsx:toHtml:function"]
+// CIL[DOC-MACRO purpose="Convert raw markdown or HTML text to HTML"]
+// CIL[DOC-RESPONSIBILITY responsibility="Return a string of HTML, parsing markdown only when input does not already look like HTML"]
+// CIL[DOC-CONTEXT module="RichTextEditor" layer="ui" related_files=".framework/src/components/ui/RichTextEditor.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="raw: string | undefined" outputs="html: string" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="Trims the input, tests for HTML-like tags, and either returns the source or parses markdown synchronously" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function toHtml(raw: string | undefined): string {
   const source = (raw ?? '').trim()
   if (!source) return ''
   const likelyHtml = /<\/?(?:h[1-6]|p|div|ul|ol|li|pre|code|br|span|strong|em|a|table|tr|td|th|thead|tbody|blockquote)\b/i.test(source)
   return likelyHtml ? source : (marked.parse(source, { async: false }) as string)
 }
-
-// CIL[END chunk_id="richtexteditor_lowlight_1783883196"]
-// CIL[BEGIN chunk_id="richtexteditor_richtexteditorprops_1783883196" type="interface" identity="RichTextEditorProps" parent="none"]
-// CIL[DOC-MACRO purpose="Define props interface for RichTextEditor component"]
-// CIL[DOC-RESPONSIBILITY responsibility="Specify component configuration and behavior options"]
-// CIL[DOC-CONTEXT module="richtexteditor" layer="ui" related_files="[\".framework/functions/_shared/schema-utils.ts\",\".framework/src/components/ui/dialog.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/principal.ts\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="RichTextEditorProps interface" errors="none" side_effects="type definition"]
-// CIL[DOC-MICRO logic_summary="Defines value, onChange, placeholder, readonly, className, minHeight props" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui. Direct callers: 0. Direct calls: 0. Related files: .framework/functions/_shared/schema-utils.ts, .framework/src/components/ui/dialog.tsx, custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/principal.ts, custom/apps/cortex/pages/operations/OperationsDashboard.tsx, \."]
-// CIL[DOC-VECTOR type="blast_radius" content="Direct callers: 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='Convert raw markdown or HTML text to HTML'; 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/RichTextEditor.tsx:toHtml:function"]
+
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/RichTextEditor.tsx:RichTextEditorProps:interface"]
+// CIL[DOC-MACRO purpose="Declare props for the RichTextEditor component"]
+// CIL[DOC-RESPONSIBILITY responsibility="Define the typed prop contract for editor configuration"]
+// CIL[DOC-CONTEXT module="RichTextEditor" layer="ui" related_files=".framework/src/components/ui/RichTextEditor.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="value: string, onChange?: (html: string) => void, placeholder?: string, readonly?: boolean, className?: string, minHeight?: string" outputs="N/A" errors="none" side_effects="none"]
+// CIL[DOC-MICRO logic_summary="TypeScript interface describing optional and required props for RichTextEditor" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 interface RichTextEditorProps {
   value: string
   onChange?: (html: string) => void
@@ -95,21 +107,22 @@ interface RichTextEditorProps {
   className?: string
   minHeight?: string
 }
-// CIL[END chunk_id="richtexteditor_richtexteditorprops_1783883196"]
-// CIL[BEGIN chunk_id="richtexteditor_toolbarbutton_1783883196" type="function" identity="ToolbarButton" parent="none"]
-// CIL[DOC-MACRO purpose="Toolbar button component with active state styling"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render styled toolbar button with active/inactive states"]
-// CIL[DOC-CONTEXT module="richtexteditor" layer="ui" related_files="[\".framework/src/components/ui/dialog.tsx\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/portal/pages/ContentPage.tsx\",\"custom/apps/cortex/functions/custom_cil-embeddings.ts\",\".framework/functions/_shared/schema-utils.ts\",\"\\\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX button element" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates button with active styling, hover effects, and click 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: ui. Direct callers: 0. Direct calls: 0. Related files: .framework/src/components/ui/dialog.tsx, .framework/src/pages/admin/RolesPage.tsx, custom/apps/portal/pages/ContentPage.tsx, custom/apps/cortex/functions/custom_cil-embeddings.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='Declare props for the RichTextEditor 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/RichTextEditor.tsx:RichTextEditorProps:interface"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/RichTextEditor.tsx:ToolbarButton:component"]
+// CIL[DOC-MACRO purpose="Render a single formatting toolbar button"]
+// CIL[DOC-RESPONSIBILITY responsibility="Display a styled button that invokes a formatting command when clicked"]
+// CIL[DOC-CONTEXT module="RichTextEditor" layer="ui" related_files=".framework/src/components/ui/RichTextEditor.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="onClick: () => void, active?: boolean, title: string, children: React.ReactNode" outputs="JSX.Element" errors="none" side_effects="invokes onClick when clicked"]
+// CIL[DOC-MICRO logic_summary="Renders a styled button with active state and onMouseDown preventDefault for TipTap integration" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 function ToolbarButton({
   onClick,
   active,
@@ -137,21 +150,22 @@ function ToolbarButton({
     </button>
   )
 }
-// CIL[END chunk_id="richtexteditor_toolbarbutton_1783883196"]
-// CIL[BEGIN chunk_id="richtexteditor_richtexteditor_1783883196" type="function" identity="RichTextEditor" parent="none"]
-// CIL[DOC-MACRO purpose="Main rich text editor with toolbar and content editing"]
-// CIL[DOC-RESPONSIBILITY responsibility="Render complete rich text editor with formatting toolbar and content area"]
-// CIL[DOC-CONTEXT module="richtexteditor" layer="ui" related_files="[\"custom/apps/portal/pages/ContentPage.tsx\",\".framework/functions/_shared/schema-utils.ts\",\".framework/src/pages/admin/RolesPage.tsx\",\"custom/apps/cortex/pages/operations/OperationsDashboard.tsx\",\".framework/src/components/ui/dialog.tsx\"]"]
-// CIL[DOC-CONTRACT inputs="none" outputs="JSX editor component" errors="none" side_effects="renders DOM"]
-// CIL[DOC-MICRO logic_summary="Creates TipTap editor with toolbar, readonly mode, content styling, and synchronization" notable_decisions="[]"]
-// CIL[DOC-CONFIDENCE pass="second" score="0.95" flags="none"]
-// CIL[DOC-STABILITY stability="stable"]
-// CIL[DOC-VECTOR type="context" content="Layer: ui. Direct callers: 0. Direct calls: 0. Related files: custom/apps/portal/pages/ContentPage.tsx, .framework/functions/_shared/schema-utils.ts, .framework/src/pages/admin/RolesPage.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='Render a single formatting toolbar button'; 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/RichTextEditor.tsx:ToolbarButton:component"]
+
+// CIL[BEGIN stable_id="~/.framework/src/components/ui/RichTextEditor.tsx:RichTextEditor:component"]
+// CIL[DOC-MACRO purpose="Rich text editor component with formatting toolbar and readonly preview"]
+// CIL[DOC-RESPONSIBILITY responsibility="Initialize a TipTap editor, render a formatting toolbar, and display sanitized HTML output"]
+// CIL[DOC-CONTEXT module="RichTextEditor" layer="ui" related_files=".framework/src/components/ui/RichTextEditor.tsx,.framework/src/lib/utils.ts"]
+// CIL[DOC-CONTRACT inputs="props: RichTextEditorProps" outputs="JSX.Element" errors="none" side_effects="calls onChange on edits, syncs content and editable state via effects, renders sanitized HTML in readonly mode"]
+// CIL[DOC-MICRO logic_summary="Sanitizes initial HTML, creates a TipTap editor with StarterKit and lowlight, syncs content and readonly state, and renders a toolbar or read-only preview" notable_decisions="[]"]
+// CIL[DOC-CONFIDENCE pass="second" score="0.90" flags="none"]
+// CIL[DOC-STABILITY stability="stable"]
 export function RichTextEditor({
   value,
   onChange,
@@ -299,4 +313,10 @@ export function RichTextEditor({
     </div>
   )
 }
-// CIL[END chunk_id="richtexteditor_richtexteditor_1783883196"]
+// CIL[DOC-VECTOR type="context" content="purpose='Rich text editor component with formatting toolbar and readonly preview'; 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/RichTextEditor.tsx:RichTextEditor:component"]