# raytolfas/rayquiro architecture

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

- Interactive diagram: https://gitdiagram.com/raytolfas/rayquiro
- Repository: https://github.com/raytolfas/rayquiro

## Overview

RayQuiro is a scripting language and runtime for desktop apps, web backends, bots, and native tools. Its primary workflow is invoking `rqio` with a script, resolving and compiling that script, then running it with the interpreter or VM; CLI commands also expose build and bytecode packaging. The repository includes language tooling and app, web, UI, and engine modules. The graph uses documented CLI behavior and visible source/index references; some dispatch details and unsampled subsystem internals are not shown, so those connections are omitted or marked unverified.

Main entry points: [`src/main.cpp`](https://github.com/raytolfas/rayquiro/blob/master/src/main.cpp) (rqio CLI), [`include/rayquiro/BuiltinModules.h`](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/BuiltinModules.h) (Builtin module API), [`include/rayquiro/Compiler.h`](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Compiler.h) (Source compiler), [`src/modules/engine_module.cpp`](https://github.com/raytolfas/rayquiro/blob/master/src/modules/engine_module.cpp) (Engine module)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and tooling"]
  node_rqio["rqio CLI<br/>[main.cpp]"]
  node_cli_services["Project services<br/>[CliServices.h]"]
  node_language_server["Language server<br/>[LSPServer.h]"]
  node_debug_server["Debug server<br/>[DAPServer.h]"]
  node_formatter["Formatter<br/>[Formatter.h]"]
  node_paths["User paths<br/>[UserPaths.h]"]
end

subgraph group_language["Language pipeline"]
  node_lexer["Lexer<br/>[Lexer.h]"]
  node_parser["Parser<br/>[Parser.h]"]
  node_ast["AST model<br/>[AST.h]"]
  node_compiler["Source compiler<br/>[Compiler.h]"]
  node_generator["Code generator<br/>[Generator.h]"]
  node_bytecode_compiler["Bytecode compiler<br/>[BytecodeCompiler.h]"]
  node_bytecode["Bytecode format<br/>[Bytecode.h]"]
end

subgraph group_runtime["Execution runtime"]
  node_interpreter["Interpreter<br/>[Interpreter.h]"]
  node_vm["Virtual machine<br/>[VM.h]"]
  node_package["Bytecode packages<br/>[BytecodePackage.h]"]
  node_c_emitter["C emitter<br/>[CEmitter.h]"]
  node_llvm_emitter["LLVM emitter<br/>[LLVMEmitter.h]"]
  node_runtime_emitter["Native runtime emitter<br/>[RuntimeEmitter.h]"]
end

subgraph group_modules["App modules"]
  node_builtin_modules["Builtin module API<br/>[BuiltinModules.h]"]
  node_app_module["App module<br/>[app_module.cpp]"]
  node_web_module["Web module<br/>[web_module.cpp]"]
  node_ui_module["UI module<br/>[ui_module.cpp]"]
  node_modern_ui["Modern UI<br/>[ModernUI.h]"]
  node_engine_module["Engine module<br/>[engine_module.cpp]"]
  node_engine_api["Engine API<br/>[EngineDLLAPI.h]"]
  node_render_api["Runtime render API<br/>[rte_api.h]"]
end

node_user(("Script author"))

node_user -->|"runs script"| node_rqio
node_rqio -->|"resolves source"| node_compiler
node_compiler -->|"uses"| node_lexer
node_compiler -->|"uses"| node_parser
node_parser -->|"builds"| node_ast
node_compiler -->|"uses"| node_generator
node_rqio -->|"runs program"| node_interpreter
node_rqio -.->|"offers VM mode"| node_bytecode_compiler
node_bytecode_compiler -->|"compiles"| node_ast
node_bytecode_compiler -->|"produces"| node_bytecode
node_vm -->|"executes"| node_bytecode
node_rqio -.->|"runs bytecode"| node_vm
node_rqio -.->|"offers packing"| node_package
node_rqio -.->|"offers native build"| node_c_emitter
node_rqio -.->|"offers native build"| node_llvm_emitter
node_rqio -.->|"builds runtime"| node_runtime_emitter
node_rqio -.->|"handles project commands"| node_cli_services
node_rqio -->|"starts server"| node_language_server
node_rqio -.->|"offers debugging"| node_debug_server
node_rqio -.->|"offers formatting"| node_formatter
node_cli_services -->|"uses paths"| node_paths
node_interpreter -->|"dispatches modules"| node_builtin_modules
node_app_module -->|"implements API"| node_builtin_modules
node_web_module -->|"implements API"| node_builtin_modules
node_ui_module -->|"implements API"| node_builtin_modules
node_ui_module -->|"uses"| node_modern_ui
node_engine_module -->|"implements API"| node_builtin_modules
node_engine_module -.->|"exposes"| node_engine_api
node_engine_module -->|"uses"| node_render_api

click node_rqio "https://github.com/raytolfas/rayquiro/blob/master/src/main.cpp"
click node_cli_services "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/CliServices.h"
click node_language_server "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/LSPServer.h"
click node_debug_server "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/DAPServer.h"
click node_formatter "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Formatter.h"
click node_lexer "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Lexer.h"
click node_parser "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Parser.h"
click node_ast "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/AST.h"
click node_compiler "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Compiler.h"
click node_generator "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Generator.h"
click node_bytecode_compiler "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/BytecodeCompiler.h"
click node_bytecode "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Bytecode.h"
click node_interpreter "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Interpreter.h"
click node_vm "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/VM.h"
click node_package "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/BytecodePackage.h"
click node_c_emitter "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/CEmitter.h"
click node_llvm_emitter "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/LLVMEmitter.h"
click node_runtime_emitter "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/RuntimeEmitter.h"
click node_builtin_modules "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/BuiltinModules.h"
click node_app_module "https://github.com/raytolfas/rayquiro/blob/master/src/modules/app_module.cpp"
click node_web_module "https://github.com/raytolfas/rayquiro/blob/master/src/modules/web_module.cpp"
click node_ui_module "https://github.com/raytolfas/rayquiro/blob/master/src/modules/ui_module.cpp"
click node_modern_ui "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/modules/ModernUI.h"
click node_engine_module "https://github.com/raytolfas/rayquiro/blob/master/src/modules/engine_module.cpp"
click node_engine_api "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/modules/EngineDLLAPI.h"
click node_render_api "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/rte_api.h"
click node_paths "https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/UserPaths.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_rqio,node_cli_services,node_language_server,node_debug_server,node_formatter,node_paths toneBlue
class node_lexer,node_parser,node_ast,node_compiler,node_generator,node_bytecode_compiler,node_bytecode toneAmber
class node_interpreter,node_vm,node_package,node_c_emitter,node_llvm_emitter,node_runtime_emitter toneMint
class node_builtin_modules,node_app_module,node_web_module,node_ui_module,node_modern_ui,node_engine_module,node_engine_api,node_render_api toneRose
class node_user toneIndigo
```

## Components

### CLI and tooling

- [rqio CLI](https://github.com/raytolfas/rayquiro/blob/master/src/main.cpp): `src/main.cpp`
- [Project services](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/CliServices.h): `include/rayquiro/CliServices.h`
- [Language server](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/LSPServer.h): `include/rayquiro/LSPServer.h`
- [Debug server](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/DAPServer.h): `include/rayquiro/DAPServer.h`
- [Formatter](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Formatter.h): `include/rayquiro/Formatter.h`
- [User paths](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/UserPaths.h): `include/rayquiro/UserPaths.h`

### Language pipeline

- [Lexer](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Lexer.h): `include/rayquiro/Lexer.h`
- [Parser](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Parser.h): `include/rayquiro/Parser.h`
- [AST model](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/AST.h): `include/rayquiro/AST.h`
- [Source compiler](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Compiler.h): `include/rayquiro/Compiler.h`
- [Code generator](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Generator.h): `include/rayquiro/Generator.h`
- [Bytecode compiler](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/BytecodeCompiler.h): `include/rayquiro/BytecodeCompiler.h`
- [Bytecode format](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Bytecode.h): `include/rayquiro/Bytecode.h`

### Execution runtime

- [Interpreter](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/Interpreter.h): `include/rayquiro/Interpreter.h`
- [Virtual machine](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/VM.h): `include/rayquiro/VM.h`
- [Bytecode packages](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/BytecodePackage.h): `include/rayquiro/BytecodePackage.h`
- [C emitter](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/CEmitter.h): `include/rayquiro/CEmitter.h`
- [LLVM emitter](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/LLVMEmitter.h): `include/rayquiro/LLVMEmitter.h`
- [Native runtime emitter](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/RuntimeEmitter.h): `include/rayquiro/RuntimeEmitter.h`

### App modules

- [Builtin module API](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/BuiltinModules.h): `include/rayquiro/BuiltinModules.h`
- [App module](https://github.com/raytolfas/rayquiro/blob/master/src/modules/app_module.cpp): `src/modules/app_module.cpp`
- [Web module](https://github.com/raytolfas/rayquiro/blob/master/src/modules/web_module.cpp): `src/modules/web_module.cpp`
- [UI module](https://github.com/raytolfas/rayquiro/blob/master/src/modules/ui_module.cpp): `src/modules/ui_module.cpp`
- [Modern UI](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/modules/ModernUI.h): `include/rayquiro/modules/ModernUI.h`
- [Engine module](https://github.com/raytolfas/rayquiro/blob/master/src/modules/engine_module.cpp): `src/modules/engine_module.cpp`
- [Engine API](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/modules/EngineDLLAPI.h): `include/rayquiro/modules/EngineDLLAPI.h`
- [Runtime render API](https://github.com/raytolfas/rayquiro/blob/master/include/rayquiro/rte_api.h): `include/rayquiro/rte_api.h`

### Other components

- **Script author**

## Connections

- Script author → rqio CLI: runs script
- rqio CLI → Source compiler: resolves source (evidence: `src/main.cpp`)
- Source compiler → Lexer: uses (evidence: `include/rayquiro/Compiler.h`)
- Source compiler → Parser: uses (evidence: `include/rayquiro/Compiler.h`)
- Parser → AST model: builds (evidence: `include/rayquiro/Parser.h`)
- Source compiler → Code generator: uses (evidence: `include/rayquiro/Compiler.h`)
- rqio CLI → Interpreter: runs program (evidence: `src/main.cpp`)
- rqio CLI → Bytecode compiler: offers VM mode (evidence: `src/main.cpp`)
- Bytecode compiler → AST model: compiles (evidence: `include/rayquiro/BytecodeCompiler.h`)
- Bytecode compiler → Bytecode format: produces (evidence: `include/rayquiro/BytecodeCompiler.h`)
- Virtual machine → Bytecode format: executes (evidence: `include/rayquiro/VM.h`)
- rqio CLI → Virtual machine: runs bytecode (evidence: `src/main.cpp`)
- rqio CLI → Bytecode packages: offers packing (evidence: `src/main.cpp`)
- rqio CLI → C emitter: offers native build (evidence: `src/main.cpp`)
- rqio CLI → LLVM emitter: offers native build (evidence: `src/main.cpp`)
- rqio CLI → Native runtime emitter: builds runtime
- rqio CLI → Project services: handles project commands (evidence: `include/rayquiro/CliServices.h`)
- rqio CLI → Language server: starts server (evidence: `src/main.cpp`)
- rqio CLI → Debug server: offers debugging (evidence: `src/main.cpp`)
- rqio CLI → Formatter: offers formatting (evidence: `src/main.cpp`)
- Project services → User paths: uses paths (evidence: `include/rayquiro/CliServices.h`)
- Interpreter → Builtin module API: dispatches modules (evidence: `include/rayquiro/Interpreter.h`)
- App module → Builtin module API: implements API (evidence: `src/modules/app_module.cpp`)
- Web module → Builtin module API: implements API (evidence: `src/modules/web_module.cpp`)
- UI module → Builtin module API: implements API (evidence: `src/modules/ui_module.cpp`)
- UI module → Modern UI: uses (evidence: `src/modules/ui_module.cpp`)
- Engine module → Builtin module API: implements API (evidence: `src/modules/engine_module.cpp`)
- Engine module → Engine API: exposes (evidence: `src/modules/engine_module.cpp`)
- Engine module → Runtime render API: uses (evidence: `src/modules/engine_module.cpp`)
