# cuernatra/emi-node-editor architecture

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

- Interactive diagram: https://gitdiagram.com/cuernatra/emi-node-editor
- Repository: https://github.com/cuernatra/emi-node-editor

## Overview

AO Emi is a C++ visual programming editor: users assemble node graphs, compile them to EMI-Script, and inspect behavior in a demo preview. The README documents the graph model, node registry, compiler, editor, and preview; the sampled preview code also shows graph-driven evaluation and drawing. The embedded EMI-Script parser and VM are included as runtime layers. Some connections are documented or visible only in the source index, so unsampled behavior is not expanded into unsupported call paths.

Main entry points: [`src/editor/mainEditor.cpp`](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/mainEditor.cpp) (Main Editor), [`src/editor/renderer/nodeRenderer.cpp`](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/renderer/nodeRenderer.cpp) (Node Renderer), [`EMI-Script/src/VM.cpp`](https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/VM.cpp) (Script VM), [`src/core/compiler/graphCompiler.cpp`](https://github.com/cuernatra/emi-node-editor/blob/main/src/core/compiler/graphCompiler.cpp) (Graph Compiler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Graph Editing"]
  node_app["App Loop<br/>[app.cpp]"]
  node_layout["Editor Layout<br/>[editorLayout.cpp]"]
  node_main_editor["Main Editor<br/>[mainEditor.cpp]"]
  node_graph_state["Graph State<br/>[graphState.h]"]
  node_graph_editor["Graph Canvas<br/>[graphEditor.cpp]"]
  node_graph_serializer["Graph Serializer"]
  node_node_renderer["Node Renderer<br/>[nodeRenderer.cpp]"]
  node_field_renderer["Field Widgets"]
  node_pin_renderer["Pin Renderer<br/>[pinRenderer.h]"]
end

subgraph group_compilation["Graph Compilation"]
  node_node_registry["Node Registry<br/>[nodeRegistry.cpp]"]
  node_node_definitions["Node Definitions<br/>[flowNodes.cpp]"]
  node_graph_compiler["Graph Compiler<br/>[graphCompiler.cpp]"]
end

subgraph group_preview["Preview Runtime"]
  node_preview_panel["Graph Preview"]
  node_executor["Graph Executor<br/>[graphExecutor.cpp]"]
end

subgraph group_emi["EMI-Script Runtime"]
  node_emi_api["EMI API<br/>[EMI.h]"]
  node_parser["Script Parser<br/>[Parser.cpp]"]
  node_ast["Script AST<br/>[AST.h]"]
  node_vm["Script VM<br/>[VM.cpp]"]
  node_functions["Script Functions<br/>[Function.h]"]
  node_namespaces["Script Namespaces<br/>[Namespace.h]"]
end

node_user(("Editor User"))

node_user -->|"uses"| node_app
node_app -->|"updates and renders"| node_layout
node_layout -.->|"composes"| node_main_editor
node_main_editor -->|"uses"| node_graph_state
node_main_editor -->|"uses"| node_graph_editor
node_main_editor -->|"uses"| node_graph_serializer
node_main_editor -->|"uses"| node_executor
node_node_renderer -->|"uses"| node_field_renderer
node_node_renderer -->|"uses"| node_pin_renderer
node_node_renderer -->|"looks up nodes"| node_node_registry
node_node_definitions -->|"registers nodes"| node_node_registry
node_graph_compiler -->|"looks up nodes"| node_node_registry
node_graph_state -.->|"provides graph"| node_graph_compiler
node_graph_compiler -->|"produces EMI-Script"| node_emi_api
node_main_editor -.->|"opens preview"| node_preview_panel
node_preview_panel -->|"evaluates graph"| node_graph_state
node_emi_api -.->|"compiles scripts"| node_parser
node_parser -->|"builds AST"| node_ast
node_vm -->|"dispatches parsing"| node_parser
node_vm -->|"uses functions"| node_functions
node_vm -->|"uses namespaces"| node_namespaces

click node_app "https://github.com/cuernatra/emi-node-editor/blob/main/src/app/app.cpp"
click node_layout "https://github.com/cuernatra/emi-node-editor/blob/main/src/app/editorLayout.cpp"
click node_main_editor "https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/mainEditor.cpp"
click node_graph_state "https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/graph/graphState.h"
click node_graph_editor "https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/graph/graphEditor.cpp"
click node_graph_serializer "https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/graph/graphSerializer.cpp"
click node_node_renderer "https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/renderer/nodeRenderer.cpp"
click node_field_renderer "https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/renderer/fieldWidgetRenderer.cpp"
click node_pin_renderer "https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/renderer/pinRenderer.h"
click node_node_registry "https://github.com/cuernatra/emi-node-editor/blob/main/src/core/registry/nodeRegistry.cpp"
click node_node_definitions "https://github.com/cuernatra/emi-node-editor/blob/main/src/core/registry/nodes/flowNodes.cpp"
click node_graph_compiler "https://github.com/cuernatra/emi-node-editor/blob/main/src/core/compiler/graphCompiler.cpp"
click node_preview_panel "https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/panels/graphPreviewPanel.cpp"
click node_executor "https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/graph/graphExecutor.cpp"
click node_emi_api "https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/include/EMI/EMI.h"
click node_parser "https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/Parser/Parser.cpp"
click node_ast "https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/Parser/AST.h"
click node_vm "https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/VM.cpp"
click node_functions "https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/Function.h"
click node_namespaces "https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/Namespace.h"

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_app,node_layout,node_main_editor,node_graph_state,node_graph_editor,node_graph_serializer,node_node_renderer,node_field_renderer,node_pin_renderer,node_user toneBlue
class node_node_registry,node_node_definitions,node_graph_compiler toneAmber
class node_preview_panel,node_executor toneMint
class node_emi_api,node_parser,node_ast,node_vm,node_functions,node_namespaces toneRose
```

## Components

### Graph Editing

- [App Loop](https://github.com/cuernatra/emi-node-editor/blob/main/src/app/app.cpp): `src/app/app.cpp`
- [Editor Layout](https://github.com/cuernatra/emi-node-editor/blob/main/src/app/editorLayout.cpp): `src/app/editorLayout.cpp`
- [Main Editor](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/mainEditor.cpp): `src/editor/mainEditor.cpp`
- [Graph State](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/graph/graphState.h): `src/editor/graph/graphState.h`
- [Graph Canvas](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/graph/graphEditor.cpp): `src/editor/graph/graphEditor.cpp`
- [Graph Serializer](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/graph/graphSerializer.cpp): `src/editor/graph/graphSerializer.cpp`
- [Node Renderer](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/renderer/nodeRenderer.cpp): `src/editor/renderer/nodeRenderer.cpp`
- [Field Widgets](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/renderer/fieldWidgetRenderer.cpp): `src/editor/renderer/fieldWidgetRenderer.cpp`
- [Pin Renderer](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/renderer/pinRenderer.h): `src/editor/renderer/pinRenderer.h`

### Graph Compilation

- [Node Registry](https://github.com/cuernatra/emi-node-editor/blob/main/src/core/registry/nodeRegistry.cpp): `src/core/registry/nodeRegistry.cpp`
- [Node Definitions](https://github.com/cuernatra/emi-node-editor/blob/main/src/core/registry/nodes/flowNodes.cpp): `src/core/registry/nodes/flowNodes.cpp`
- [Graph Compiler](https://github.com/cuernatra/emi-node-editor/blob/main/src/core/compiler/graphCompiler.cpp): `src/core/compiler/graphCompiler.cpp`

### Preview Runtime

- [Graph Preview](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/panels/graphPreviewPanel.cpp): `src/editor/panels/graphPreviewPanel.cpp`
- [Graph Executor](https://github.com/cuernatra/emi-node-editor/blob/main/src/editor/graph/graphExecutor.cpp): `src/editor/graph/graphExecutor.cpp`

### EMI-Script Runtime

- [EMI API](https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/include/EMI/EMI.h): `EMI-Script/include/EMI/EMI.h`
- [Script Parser](https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/Parser/Parser.cpp): `EMI-Script/src/Parser/Parser.cpp`
- [Script AST](https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/Parser/AST.h): `EMI-Script/src/Parser/AST.h`
- [Script VM](https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/VM.cpp): `EMI-Script/src/VM.cpp`
- [Script Functions](https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/Function.h): `EMI-Script/src/Function.h`
- [Script Namespaces](https://github.com/cuernatra/emi-node-editor/blob/main/EMI-Script/src/Namespace.h): `EMI-Script/src/Namespace.h`

### Other components

- **Editor User**

## Connections

- Editor User → App Loop: uses (evidence: `README.md`)
- App Loop → Editor Layout: updates and renders
- Editor Layout → Main Editor: composes
- Main Editor → Graph State: uses (evidence: `src/editor/mainEditor.cpp`)
- Main Editor → Graph Canvas: uses (evidence: `src/editor/mainEditor.cpp`)
- Main Editor → Graph Serializer: uses (evidence: `src/editor/mainEditor.cpp`)
- Main Editor → Graph Executor: uses (evidence: `src/editor/mainEditor.cpp`)
- Node Renderer → Field Widgets: uses (evidence: `src/editor/renderer/nodeRenderer.cpp`)
- Node Renderer → Pin Renderer: uses (evidence: `src/editor/renderer/nodeRenderer.cpp`)
- Node Renderer → Node Registry: looks up nodes (evidence: `src/editor/renderer/nodeRenderer.cpp`)
- Node Definitions → Node Registry: registers nodes (evidence: `src/core/registry/nodes/flowNodes.cpp`)
- Graph Compiler → Node Registry: looks up nodes (evidence: `src/core/compiler/graphCompiler.cpp`)
- Graph State → Graph Compiler: provides graph
- Graph Compiler → EMI API: produces EMI-Script (evidence: `README.md`)
- Main Editor → Graph Preview: opens preview
- Graph Preview → Graph State: evaluates graph (evidence: `src/editor/panels/graphPreviewPanel.cpp`)
- EMI API → Script Parser: compiles scripts
- Script Parser → Script AST: builds AST (evidence: `EMI-Script/src/Parser/Parser.cpp`)
- Script VM → Script Parser: dispatches parsing (evidence: `EMI-Script/src/VM.cpp`)
- Script VM → Script Functions: uses functions (evidence: `EMI-Script/src/VM.cpp`)
- Script VM → Script Namespaces: uses namespaces (evidence: `EMI-Script/src/VM.cpp`)
