# codemirror/view architecture

> Architecture diagram of the GitHub repository codemirror/view, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/codemirror/view
- Repository: https://github.com/codemirror/view

## Overview

@codemirror/view implements CodeMirror’s browser-based editor view. The main workflow is that a consumer creates an EditorView, which handles user input and DOM changes, updates its document view, and renders the editor. Supporting stages provide layout and cursor geometry, bidi navigation, decorations, and extension-driven UI features. The README documents the public construction and dispatch workflow; source relationships below are limited to the supplied excerpts and SOURCE INDEX references, so unsampled feature links are omitted where they cannot be established.

Main entry points: [`src/editorview.ts`](https://github.com/codemirror/view/blob/main/src/editorview.ts) (EditorView), [`src/extension.ts`](https://github.com/codemirror/view/blob/main/src/extension.ts) (Extension System), [`src/docview.ts`](https://github.com/codemirror/view/blob/main/src/docview.ts) (Document View), [`src/input.ts`](https://github.com/codemirror/view/blob/main/src/input.ts) (Input Handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Editor Runtime"]
  node_view["EditorView<br/>[editorview.ts]"]
  node_input["Input Handling<br/>[input.ts]"]
  node_domchange["DOM Changes<br/>[domchange.ts]"]
  node_observer["DOM Observer<br/>[domobserver.ts]"]
  node_extensions["Extension System<br/>[extension.ts]"]
  node_dom["DOM Utilities<br/>[dom.ts]"]
  node_browser["Browser Detection<br/>[browser.ts]"]
end

subgraph group_render["Document Rendering"]
  node_docview["Document View<br/>[docview.ts]"]
  node_buildtile["Tile Builder<br/>[buildtile.ts]"]
  node_tiles["Tile Model<br/>[tile.ts]"]
  node_decorations["Decorations<br/>[decoration.ts]"]
  node_attributes["DOM Attributes<br/>[attributes.ts]"]
end

subgraph group_geometry["Layout and Navigation"]
  node_viewstate["View State<br/>[viewstate.ts]"]
  node_heightmap["Height Map<br/>[heightmap.ts]"]
  node_bidi["Bidi Navigation<br/>[bidi.ts]"]
  node_cursor["Cursor Geometry<br/>[cursor.ts]"]
end

subgraph group_features["View Features"]
  node_layer["View Layers<br/>[layer.ts]"]
  node_gutter["Gutters<br/>[gutter.ts]"]
  node_panel["Panels<br/>[panel.ts]"]
  node_tooltip["Tooltips<br/>[tooltip.ts]"]
  node_keymap["Keymaps<br/>[keymap.ts]"]
  node_selection["Selection Drawing<br/>[draw-selection.ts]"]
end

node_consumer(("Editor Consumer"))

node_consumer -->|"creates"| node_view
node_consumer -->|"dispatches updates"| node_view
node_view -->|"creates"| node_input
node_view -->|"creates"| node_docview
node_view -->|"applies changes"| node_domchange
node_view -->|"uses"| node_viewstate
node_view -->|"uses"| node_observer
node_view -->|"reads facets"| node_extensions
node_input -->|"dispatches input"| node_view
node_input -->|"uses selection helpers"| node_cursor
node_domchange -->|"reads composition"| node_docview
node_observer -->|"imports change handling"| node_domchange
node_docview -->|"builds tiles"| node_buildtile
node_docview -->|"updates tile tree"| node_tiles
node_buildtile -->|"creates tiles"| node_tiles
node_docview -->|"uses decorations"| node_decorations
node_decorations -->|"combines attributes"| node_attributes
node_viewstate -->|"uses layout map"| node_heightmap
node_cursor -->|"moves visually"| node_bidi
node_cursor -->|"queries blocks"| node_heightmap
node_view -->|"uses DOM helpers"| node_dom
node_dom -->|"reads capabilities"| node_browser
node_extensions -->|"provides decorations"| node_decorations
node_layer -->|"registers with"| node_extensions
node_gutter -->|"registers with"| node_extensions
node_panel -->|"registers with"| node_extensions
node_tooltip -->|"registers with"| node_extensions
node_keymap -->|"uses input behavior"| node_input
node_selection -->|"uses drawing layer"| node_layer

click node_view "https://github.com/codemirror/view/blob/main/src/editorview.ts"
click node_input "https://github.com/codemirror/view/blob/main/src/input.ts"
click node_domchange "https://github.com/codemirror/view/blob/main/src/domchange.ts"
click node_observer "https://github.com/codemirror/view/blob/main/src/domobserver.ts"
click node_extensions "https://github.com/codemirror/view/blob/main/src/extension.ts"
click node_docview "https://github.com/codemirror/view/blob/main/src/docview.ts"
click node_buildtile "https://github.com/codemirror/view/blob/main/src/buildtile.ts"
click node_tiles "https://github.com/codemirror/view/blob/main/src/tile.ts"
click node_decorations "https://github.com/codemirror/view/blob/main/src/decoration.ts"
click node_attributes "https://github.com/codemirror/view/blob/main/src/attributes.ts"
click node_viewstate "https://github.com/codemirror/view/blob/main/src/viewstate.ts"
click node_heightmap "https://github.com/codemirror/view/blob/main/src/heightmap.ts"
click node_bidi "https://github.com/codemirror/view/blob/main/src/bidi.ts"
click node_cursor "https://github.com/codemirror/view/blob/main/src/cursor.ts"
click node_dom "https://github.com/codemirror/view/blob/main/src/dom.ts"
click node_browser "https://github.com/codemirror/view/blob/main/src/browser.ts"
click node_layer "https://github.com/codemirror/view/blob/main/src/layer.ts"
click node_gutter "https://github.com/codemirror/view/blob/main/src/gutter.ts"
click node_panel "https://github.com/codemirror/view/blob/main/src/panel.ts"
click node_tooltip "https://github.com/codemirror/view/blob/main/src/tooltip.ts"
click node_keymap "https://github.com/codemirror/view/blob/main/src/keymap.ts"
click node_selection "https://github.com/codemirror/view/blob/main/src/draw-selection.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_view,node_input,node_domchange,node_observer,node_extensions,node_dom,node_browser toneBlue
class node_docview,node_buildtile,node_tiles,node_decorations,node_attributes toneAmber
class node_viewstate,node_heightmap,node_bidi,node_cursor toneMint
class node_layer,node_gutter,node_panel,node_tooltip,node_keymap,node_selection toneRose
class node_consumer toneIndigo
```

## Components

### Editor Runtime

- [EditorView](https://github.com/codemirror/view/blob/main/src/editorview.ts): `src/editorview.ts`
- [Input Handling](https://github.com/codemirror/view/blob/main/src/input.ts): `src/input.ts`
- [DOM Changes](https://github.com/codemirror/view/blob/main/src/domchange.ts): `src/domchange.ts`
- [DOM Observer](https://github.com/codemirror/view/blob/main/src/domobserver.ts): `src/domobserver.ts`
- [Extension System](https://github.com/codemirror/view/blob/main/src/extension.ts): `src/extension.ts`
- [DOM Utilities](https://github.com/codemirror/view/blob/main/src/dom.ts): `src/dom.ts`
- [Browser Detection](https://github.com/codemirror/view/blob/main/src/browser.ts): `src/browser.ts`

### Document Rendering

- [Document View](https://github.com/codemirror/view/blob/main/src/docview.ts): `src/docview.ts`
- [Tile Builder](https://github.com/codemirror/view/blob/main/src/buildtile.ts): `src/buildtile.ts`
- [Tile Model](https://github.com/codemirror/view/blob/main/src/tile.ts): `src/tile.ts`
- [Decorations](https://github.com/codemirror/view/blob/main/src/decoration.ts): `src/decoration.ts`
- [DOM Attributes](https://github.com/codemirror/view/blob/main/src/attributes.ts): `src/attributes.ts`

### Layout and Navigation

- [View State](https://github.com/codemirror/view/blob/main/src/viewstate.ts): `src/viewstate.ts`
- [Height Map](https://github.com/codemirror/view/blob/main/src/heightmap.ts): `src/heightmap.ts`
- [Bidi Navigation](https://github.com/codemirror/view/blob/main/src/bidi.ts): `src/bidi.ts`
- [Cursor Geometry](https://github.com/codemirror/view/blob/main/src/cursor.ts): `src/cursor.ts`

### View Features

- [View Layers](https://github.com/codemirror/view/blob/main/src/layer.ts): `src/layer.ts`
- [Gutters](https://github.com/codemirror/view/blob/main/src/gutter.ts): `src/gutter.ts`
- [Panels](https://github.com/codemirror/view/blob/main/src/panel.ts): `src/panel.ts`
- [Tooltips](https://github.com/codemirror/view/blob/main/src/tooltip.ts): `src/tooltip.ts`
- [Keymaps](https://github.com/codemirror/view/blob/main/src/keymap.ts): `src/keymap.ts`
- [Selection Drawing](https://github.com/codemirror/view/blob/main/src/draw-selection.ts): `src/draw-selection.ts`

### Other components

- **Editor Consumer**

## Connections

- Editor Consumer → EditorView: creates (evidence: `README.md`)
- Editor Consumer → EditorView: dispatches updates (evidence: `README.md`)
- EditorView → Input Handling: creates (evidence: `src/editorview.ts`)
- EditorView → Document View: creates (evidence: `src/editorview.ts`)
- EditorView → DOM Changes: applies changes (evidence: `src/editorview.ts`)
- EditorView → View State: uses (evidence: `src/editorview.ts`)
- EditorView → DOM Observer: uses (evidence: `src/editorview.ts`)
- EditorView → Extension System: reads facets (evidence: `src/editorview.ts`)
- Input Handling → EditorView: dispatches input (evidence: `src/input.ts`)
- Input Handling → Cursor Geometry: uses selection helpers (evidence: `src/input.ts`)
- DOM Changes → Document View: reads composition (evidence: `src/domchange.ts`)
- DOM Observer → DOM Changes: imports change handling (evidence: `src/domobserver.ts`)
- Document View → Tile Builder: builds tiles (evidence: `src/docview.ts`)
- Document View → Tile Model: updates tile tree (evidence: `src/docview.ts`)
- Tile Builder → Tile Model: creates tiles (evidence: `src/buildtile.ts`)
- Document View → Decorations: uses decorations (evidence: `src/docview.ts`)
- Decorations → DOM Attributes: combines attributes (evidence: `src/decoration.ts`)
- View State → Height Map: uses layout map (evidence: `src/viewstate.ts`)
- Cursor Geometry → Bidi Navigation: moves visually (evidence: `src/cursor.ts`)
- Cursor Geometry → Height Map: queries blocks (evidence: `src/cursor.ts`)
- EditorView → DOM Utilities: uses DOM helpers (evidence: `src/editorview.ts`)
- DOM Utilities → Browser Detection: reads capabilities (evidence: `src/dom.ts`)
- Extension System → Decorations: provides decorations (evidence: `src/extension.ts`)
- View Layers → Extension System: registers with (evidence: `src/layer.ts`)
- Gutters → Extension System: registers with (evidence: `src/gutter.ts`)
- Panels → Extension System: registers with (evidence: `src/panel.ts`)
- Tooltips → Extension System: registers with (evidence: `src/tooltip.ts`)
- Keymaps → Input Handling: uses input behavior (evidence: `src/keymap.ts`)
- Selection Drawing → View Layers: uses drawing layer (evidence: `src/draw-selection.ts`)
