# wangeditor-team/wangeditor architecture

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

- Interactive diagram: https://gitdiagram.com/wangeditor-team/wangeditor
- Repository: https://github.com/wangeditor-team/wangeditor

## Overview

wangEditor 5 is a configurable web rich-text editor. Users edit content in the core editor, invoke toolbar or contextual menus, and can import or export HTML; built-in and optional modules add formatting, structured blocks, media, tables, lists, and code highlighting. The graph groups runtime components and product capabilities rather than build tooling. Evidence is limited to the README, tree, and supplied source index/excerpts; dashed, uncited links indicate likely integration that those excerpts do not verify.

Main entry points: [`packages/core/src/editor/dom-editor.ts`](https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/editor/dom-editor.ts) (DOM editor), [`packages/core/src/text-area/TextArea.ts`](https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/text-area/TextArea.ts) (Editable surface), [`packages/upload-image-module/src/module/upload-images.ts`](https://github.com/wangeditor-team/wangeditor/blob/master/packages/upload-image-module/src/module/upload-images.ts) (Image upload), [`packages/editor/src/Boot.ts`](https://github.com/wangeditor-team/wangeditor/blob/master/packages/editor/src/Boot.ts) (Editor bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Editor shell"]
  node_boot["Editor bootstrap<br/>[Boot.ts]"]
  node_builtin["Built-in registration<br/>[register.ts]"]
end

subgraph group_engine["Editing engine"]
  node_editor["DOM editor<br/>[dom-editor.ts]"]
  node_textarea["Editable surface<br/>[TextArea.ts]"]
  node_selection["Selection sync<br/>[syncSelection.ts]"]
  node_view["View updates<br/>[update-view.ts]"]
  node_render["Node rendering"]
  node_htmlin["HTML parsing"]
  node_htmlout["HTML serialization"]
  node_maps["Editor relationships<br/>[weak-maps.ts]"]
end

subgraph group_menus["Menus"]
  node_toolbar["Toolbar<br/>[Toolbar.ts]"]
  node_hoverbar["Contextual bar<br/>[HoverBar.ts]"]
end

subgraph group_features["Content features"]
  node_basic["Formatting and blocks"]
  node_lists["Lists"]
  node_tables["Tables"]
  node_media["Images and video"]
end

subgraph group_extensions["Optional extensions"]
  node_highlight["Code highlighting"]
  node_imageupload["Image upload<br/>[upload-images.ts]"]
  node_videoupload["Video upload<br/>[upload-videos.ts]"]
end

node_user(("Editor user"))

node_user -.->|"configures"| node_boot
node_boot -->|"registers"| node_builtin
node_builtin -.->|"configures"| node_editor
node_user -.->|"edits"| node_textarea
node_editor -->|"creates"| node_textarea
node_textarea -->|"syncs selection"| node_selection
node_textarea -->|"updates view"| node_view
node_textarea -.->|"renders content"| node_render
node_editor -.->|"parses HTML"| node_htmlin
node_editor -.->|"exports HTML"| node_htmlout
node_editor -->|"uses mappings"| node_maps
node_editor -->|"creates"| node_toolbar
node_editor -->|"creates"| node_hoverbar
node_user -.->|"invokes"| node_toolbar
node_user -.->|"invokes"| node_hoverbar
node_basic -.->|"extends"| node_editor
node_lists -.->|"extends"| node_editor
node_tables -->|"extends"| node_editor
node_highlight -->|"extends"| node_editor
node_imageupload -->|"uploads into"| node_editor
node_imageupload -->|"inserts image"| node_media
node_videoupload -.->|"uploads video"| node_media

click node_boot "https://github.com/wangeditor-team/wangeditor/blob/master/packages/editor/src/Boot.ts"
click node_builtin "https://github.com/wangeditor-team/wangeditor/blob/master/packages/editor/src/register-builtin-modules/register.ts"
click node_editor "https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/editor/dom-editor.ts"
click node_textarea "https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/text-area/TextArea.ts"
click node_selection "https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/text-area/syncSelection.ts"
click node_view "https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/text-area/update-view.ts"
click node_render "https://github.com/wangeditor-team/wangeditor/tree/master/packages/core/src/render"
click node_htmlin "https://github.com/wangeditor-team/wangeditor/tree/master/packages/core/src/parse-html"
click node_htmlout "https://github.com/wangeditor-team/wangeditor/tree/master/packages/core/src/to-html"
click node_maps "https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/utils/weak-maps.ts"
click node_toolbar "https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/menus/bar/Toolbar.ts"
click node_hoverbar "https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/menus/bar/HoverBar.ts"
click node_basic "https://github.com/wangeditor-team/wangeditor/tree/master/packages/basic-modules/src/modules"
click node_lists "https://github.com/wangeditor-team/wangeditor/tree/master/packages/list-module/src/module"
click node_tables "https://github.com/wangeditor-team/wangeditor/tree/master/packages/table-module/src/module"
click node_media "https://github.com/wangeditor-team/wangeditor/tree/master/packages/basic-modules/src/modules/image"
click node_highlight "https://github.com/wangeditor-team/wangeditor/tree/master/packages/code-highlight/src/module"
click node_imageupload "https://github.com/wangeditor-team/wangeditor/blob/master/packages/upload-image-module/src/module/upload-images.ts"
click node_videoupload "https://github.com/wangeditor-team/wangeditor/blob/master/packages/video-module/src/module/helper/upload-videos.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_boot,node_builtin,node_user toneBlue
class node_editor,node_textarea,node_selection,node_view,node_render,node_htmlin,node_htmlout,node_maps toneAmber
class node_toolbar,node_hoverbar toneMint
class node_basic,node_lists,node_tables,node_media toneRose
class node_highlight,node_imageupload,node_videoupload toneIndigo
```

## Components

### Editor shell

- [Editor bootstrap](https://github.com/wangeditor-team/wangeditor/blob/master/packages/editor/src/Boot.ts): `packages/editor/src/Boot.ts`
- [Built-in registration](https://github.com/wangeditor-team/wangeditor/blob/master/packages/editor/src/register-builtin-modules/register.ts): `packages/editor/src/register-builtin-modules/register.ts`

### Editing engine

- [DOM editor](https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/editor/dom-editor.ts): `packages/core/src/editor/dom-editor.ts`
- [Editable surface](https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/text-area/TextArea.ts): `packages/core/src/text-area/TextArea.ts`
- [Selection sync](https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/text-area/syncSelection.ts): `packages/core/src/text-area/syncSelection.ts`
- [View updates](https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/text-area/update-view.ts): `packages/core/src/text-area/update-view.ts`
- [Node rendering](https://github.com/wangeditor-team/wangeditor/tree/master/packages/core/src/render): `packages/core/src/render`
- [HTML parsing](https://github.com/wangeditor-team/wangeditor/tree/master/packages/core/src/parse-html): `packages/core/src/parse-html`
- [HTML serialization](https://github.com/wangeditor-team/wangeditor/tree/master/packages/core/src/to-html): `packages/core/src/to-html`
- [Editor relationships](https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/utils/weak-maps.ts): `packages/core/src/utils/weak-maps.ts`

### Menus

- [Toolbar](https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/menus/bar/Toolbar.ts): `packages/core/src/menus/bar/Toolbar.ts`
- [Contextual bar](https://github.com/wangeditor-team/wangeditor/blob/master/packages/core/src/menus/bar/HoverBar.ts): `packages/core/src/menus/bar/HoverBar.ts`

### Content features

- [Formatting and blocks](https://github.com/wangeditor-team/wangeditor/tree/master/packages/basic-modules/src/modules): `packages/basic-modules/src/modules`
- [Lists](https://github.com/wangeditor-team/wangeditor/tree/master/packages/list-module/src/module): `packages/list-module/src/module`
- [Tables](https://github.com/wangeditor-team/wangeditor/tree/master/packages/table-module/src/module): `packages/table-module/src/module`
- [Images and video](https://github.com/wangeditor-team/wangeditor/tree/master/packages/basic-modules/src/modules/image): `packages/basic-modules/src/modules/image`

### Optional extensions

- [Code highlighting](https://github.com/wangeditor-team/wangeditor/tree/master/packages/code-highlight/src/module): `packages/code-highlight/src/module`
- [Image upload](https://github.com/wangeditor-team/wangeditor/blob/master/packages/upload-image-module/src/module/upload-images.ts): `packages/upload-image-module/src/module/upload-images.ts`
- [Video upload](https://github.com/wangeditor-team/wangeditor/blob/master/packages/video-module/src/module/helper/upload-videos.ts): `packages/video-module/src/module/helper/upload-videos.ts`

### Other components

- **Editor user**

## Connections

- Editor user → Editor bootstrap: configures
- Editor bootstrap → Built-in registration: registers (evidence: `packages/editor/src/Boot.ts`)
- Built-in registration → DOM editor: configures
- Editor user → Editable surface: edits
- DOM editor → Editable surface: creates (evidence: `packages/core/src/editor/dom-editor.ts`)
- Editable surface → Selection sync: syncs selection (evidence: `packages/core/src/text-area/TextArea.ts`)
- Editable surface → View updates: updates view (evidence: `packages/core/src/text-area/TextArea.ts`)
- Editable surface → Node rendering: renders content
- DOM editor → HTML parsing: parses HTML
- DOM editor → HTML serialization: exports HTML
- DOM editor → Editor relationships: uses mappings (evidence: `packages/core/src/editor/dom-editor.ts`)
- DOM editor → Toolbar: creates (evidence: `packages/core/src/editor/dom-editor.ts`)
- DOM editor → Contextual bar: creates (evidence: `packages/core/src/editor/dom-editor.ts`)
- Editor user → Toolbar: invokes
- Editor user → Contextual bar: invokes
- Formatting and blocks → DOM editor: extends
- Lists → DOM editor: extends
- Tables → DOM editor: extends (evidence: `packages/table-module/src/module/plugin.ts`)
- Code highlighting → DOM editor: extends (evidence: `packages/code-highlight/src/module/parse-style-html.ts`)
- Image upload → DOM editor: uploads into (evidence: `packages/upload-image-module/src/module/upload-images.ts`)
- Image upload → Images and video: inserts image (evidence: `packages/upload-image-module/src/module/upload-images.ts`)
- Video upload → Images and video: uploads video
