context: The Comi Ecosystem Knowledge Forge is a pristine space dedicated to documenting CodeMirror 6 extension design, architectural patterns, and deep-level execution contexts.
objectives: Keep all CodeMirror 6 components decoupled, maintain strict state-to-view separation, and document custom extension patterns clearly.
architectural_guides_map:
core_architecture:
CM6-Architecture.md: Deep dive into the immutable EditorState, mutable EditorView, and transaction flow.
extension_design:
CM6-Extensions.md: High-level overview of LSP, ghost text simulator, and git-diff gutters integration.
LSP-Design.md: Autocomplete and diagnostic linter extensions, state-to-view interaction, and quick-fix implementations.
Ghost-Text-Simulator.md: Inline ghost text simulator using transaction filtering, decoration state fields, widget rendering, and custom keymap bindings.
Line-Decorations.md: Gutter extensions, diff-tracking state fields, and custom line background styling.
AI-Streaming-Simulator.md: Block-level Copilot style multi-agent workflow using state fields and simulated token streams.
deep_xray_internals:
xray/codemirror/state/fields-and-facets.md: Editor state fields, extension configuration, and custom facets.
xray/codemirror/view/plugins-and-decorations.md: View plugins, decorations, updates, and DOM rendering.
xray/codemirror/commands/keymaps-and-dispatch.md: Command dispatch, standard keymaps, and key event handling.
xray/codemirror/language/lezer-and-highlighting.md: Lezer parser integration, syntax trees, and tags.
xray/execution/sandboxing-and-lifecycle.md: Execution safety, sandbox constraints, and lifecycle events.
xray/plugins/bridge-and-events.md: Communication bridge, event emitters, and cross-context message passing.