# zytherdev/tzrender architecture

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

- Interactive diagram: https://gitdiagram.com/zytherdev/tzrender
- Repository: https://github.com/zytherdev/tzrender

## Overview

tzrender is both a reusable vanilla-JavaScript UI library and a separate learning website. The library workflow is an application creating a Render instance and invoking UI components; the website offers front-end tools and a browser editor for project files, language assistance, execution, and preview. The package structure and several website modules are evidenced by excerpts or the source index; detailed editor wiring is not shown, so uncertain connections are omitted.

Main entry points: [`src/render.js`](https://github.com/zytherdev/tzrender/blob/main/src/render.js) (Render API), [`site/editor.js`](https://github.com/zytherdev/tzrender/blob/main/site/editor.js) (Editor interface), [`utils/main.js`](https://github.com/zytherdev/tzrender/blob/main/utils/main.js) (Learning site entry), [`site/editor/preview-content.js`](https://github.com/zytherdev/tzrender/blob/main/site/editor/preview-content.js) (Preview content)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_package["UI library"]
  node_entry["Package entry<br/>[index.js]"]
  node_render["Render API<br/>[render.js]"]
  node_colors["Theme colors<br/>[colors.js]"]
end

subgraph group_components["Component families"]
  node_feedback["Feedback and display<br/>[components.js]"]
  node_forms["Form controls<br/>[forms.js]"]
  node_display["Display controls<br/>[display.js]"]
  node_navigation["Navigation controls<br/>[navigation.js]"]
end

subgraph group_editor["Browser editor"]
  node_editorui["Editor interface<br/>[editor.js]"]
  node_projects["Project model<br/>[project.js]"]
  node_filesystem["File system<br/>[file-system.js]"]
  node_explorer["File explorer<br/>[explorer.js]"]
  node_terminal["Terminal<br/>[terminal.js]"]
  node_previewcontent["Preview content<br/>[preview-content.js]"]
  node_previewdoc["Sandbox document"]
end

subgraph group_execution["Language services"]
  node_diagnostics["Language diagnostics"]
  node_intelligence["Language intelligence"]
  node_runtimes["Language runtimes"]
  node_workers["Execution workers"]
end

subgraph group_learning["Learning site"]
  node_toolspage["Front-end tools<br/>[tools.js]"]
  node_toolbox["Toolbox UI<br/>[toolbox.js]"]
  node_demos["Library demos<br/>[library-demos.js]"]
  node_siteentry["Learning site entry<br/>[main.js]"]
end

node_app(("Host application"))
node_editoruser(("Learner"))

node_app -->|"imports"| node_entry
node_entry -->|"exports"| node_render
node_app -->|"creates and calls"| node_render
node_render -->|"dispatches"| node_feedback
node_render -->|"dispatches"| node_forms
node_render -->|"dispatches"| node_display
node_render -->|"dispatches"| node_navigation
node_render -->|"uses"| node_colors
node_editoruser -.->|"edits project"| node_editorui
node_explorer -->|"uses"| node_filesystem
node_explorer -->|"uses"| node_projects
node_terminal -->|"uses"| node_filesystem
node_terminal -->|"uses"| node_projects
node_diagnostics -->|"queries"| node_intelligence
node_editorui -.->|"requests"| node_diagnostics
node_editorui -.->|"runs code"| node_runtimes
node_runtimes -.->|"dispatches"| node_workers
node_editorui -.->|"requests preview"| node_previewcontent
node_previewcontent -->|"reads"| node_projects
node_previewcontent -->|"builds document"| node_previewdoc
node_siteentry -->|"mounts"| node_toolbox
node_siteentry -->|"mounts"| node_demos
node_siteentry -->|"imports"| node_entry

click node_entry "https://github.com/zytherdev/tzrender/blob/main/index.js"
click node_render "https://github.com/zytherdev/tzrender/blob/main/src/render.js"
click node_colors "https://github.com/zytherdev/tzrender/blob/main/src/utils/colors.js"
click node_feedback "https://github.com/zytherdev/tzrender/blob/main/src/components.js"
click node_forms "https://github.com/zytherdev/tzrender/blob/main/src/components/forms.js"
click node_display "https://github.com/zytherdev/tzrender/blob/main/src/components/display.js"
click node_navigation "https://github.com/zytherdev/tzrender/blob/main/src/components/navigation.js"
click node_editorui "https://github.com/zytherdev/tzrender/blob/main/site/editor.js"
click node_projects "https://github.com/zytherdev/tzrender/blob/main/site/editor/project.js"
click node_filesystem "https://github.com/zytherdev/tzrender/blob/main/site/editor/file-system.js"
click node_explorer "https://github.com/zytherdev/tzrender/blob/main/site/editor/explorer.js"
click node_terminal "https://github.com/zytherdev/tzrender/blob/main/site/editor/terminal.js"
click node_diagnostics "https://github.com/zytherdev/tzrender/blob/main/site/editor/language-diagnostics.js"
click node_intelligence "https://github.com/zytherdev/tzrender/tree/main/site/editor"
click node_runtimes "https://github.com/zytherdev/tzrender/tree/main/site/editor"
click node_workers "https://github.com/zytherdev/tzrender/tree/main/site/editor"
click node_previewcontent "https://github.com/zytherdev/tzrender/blob/main/site/editor/preview-content.js"
click node_previewdoc "https://github.com/zytherdev/tzrender/blob/main/site/preview-document.js"
click node_toolspage "https://github.com/zytherdev/tzrender/blob/main/site/tools.js"
click node_toolbox "https://github.com/zytherdev/tzrender/blob/main/utils/toolbox.js"
click node_demos "https://github.com/zytherdev/tzrender/blob/main/utils/library-demos.js"
click node_siteentry "https://github.com/zytherdev/tzrender/blob/main/utils/main.js"

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_entry,node_render,node_colors toneBlue
class node_feedback,node_forms,node_display,node_navigation toneAmber
class node_editorui,node_projects,node_filesystem,node_explorer,node_terminal,node_previewcontent,node_previewdoc toneMint
class node_diagnostics,node_intelligence,node_runtimes,node_workers toneRose
class node_toolspage,node_toolbox,node_demos,node_siteentry,node_app,node_editoruser toneIndigo
```

## Components

### UI library

- [Package entry](https://github.com/zytherdev/tzrender/blob/main/index.js): `index.js`
- [Render API](https://github.com/zytherdev/tzrender/blob/main/src/render.js): `src/render.js`
- [Theme colors](https://github.com/zytherdev/tzrender/blob/main/src/utils/colors.js): `src/utils/colors.js`

### Component families

- [Feedback and display](https://github.com/zytherdev/tzrender/blob/main/src/components.js): `src/components.js`
- [Form controls](https://github.com/zytherdev/tzrender/blob/main/src/components/forms.js): `src/components/forms.js`
- [Display controls](https://github.com/zytherdev/tzrender/blob/main/src/components/display.js): `src/components/display.js`
- [Navigation controls](https://github.com/zytherdev/tzrender/blob/main/src/components/navigation.js): `src/components/navigation.js`

### Browser editor

- [Editor interface](https://github.com/zytherdev/tzrender/blob/main/site/editor.js): `site/editor.js`
- [Project model](https://github.com/zytherdev/tzrender/blob/main/site/editor/project.js): `site/editor/project.js`
- [File system](https://github.com/zytherdev/tzrender/blob/main/site/editor/file-system.js): `site/editor/file-system.js`
- [File explorer](https://github.com/zytherdev/tzrender/blob/main/site/editor/explorer.js): `site/editor/explorer.js`
- [Terminal](https://github.com/zytherdev/tzrender/blob/main/site/editor/terminal.js): `site/editor/terminal.js`
- [Preview content](https://github.com/zytherdev/tzrender/blob/main/site/editor/preview-content.js): `site/editor/preview-content.js`
- [Sandbox document](https://github.com/zytherdev/tzrender/blob/main/site/preview-document.js): `site/preview-document.js`

### Language services

- [Language diagnostics](https://github.com/zytherdev/tzrender/blob/main/site/editor/language-diagnostics.js): `site/editor/language-diagnostics.js`
- [Language intelligence](https://github.com/zytherdev/tzrender/tree/main/site/editor): `site/editor`
- [Language runtimes](https://github.com/zytherdev/tzrender/tree/main/site/editor): `site/editor`
- [Execution workers](https://github.com/zytherdev/tzrender/tree/main/site/editor): `site/editor`

### Learning site

- [Front-end tools](https://github.com/zytherdev/tzrender/blob/main/site/tools.js): `site/tools.js`
- [Toolbox UI](https://github.com/zytherdev/tzrender/blob/main/utils/toolbox.js): `utils/toolbox.js`
- [Library demos](https://github.com/zytherdev/tzrender/blob/main/utils/library-demos.js): `utils/library-demos.js`
- [Learning site entry](https://github.com/zytherdev/tzrender/blob/main/utils/main.js): `utils/main.js`

### Other components

- **Host application**
- **Learner**

## Connections

- Host application → Package entry: imports (evidence: `README.md`)
- Package entry → Render API: exports (evidence: `index.js`)
- Host application → Render API: creates and calls (evidence: `README.md`)
- Render API → Feedback and display: dispatches (evidence: `src/render.js`)
- Render API → Form controls: dispatches (evidence: `src/render.js`)
- Render API → Display controls: dispatches (evidence: `src/render.js`)
- Render API → Navigation controls: dispatches (evidence: `src/render.js`)
- Render API → Theme colors: uses (evidence: `src/render.js`)
- Learner → Editor interface: edits project
- File explorer → File system: uses (evidence: `site/editor/explorer.js`)
- File explorer → Project model: uses (evidence: `site/editor/explorer.js`)
- Terminal → File system: uses (evidence: `site/editor/terminal.js`)
- Terminal → Project model: uses (evidence: `site/editor/terminal.js`)
- Language diagnostics → Language intelligence: queries (evidence: `site/editor/language-diagnostics.js`)
- Editor interface → Language diagnostics: requests
- Editor interface → Language runtimes: runs code
- Language runtimes → Execution workers: dispatches
- Editor interface → Preview content: requests preview
- Preview content → Project model: reads (evidence: `site/editor/preview-content.js`)
- Preview content → Sandbox document: builds document (evidence: `site/editor/preview-content.js`)
- Learning site entry → Toolbox UI: mounts (evidence: `utils/main.js`)
- Learning site entry → Library demos: mounts (evidence: `utils/main.js`)
- Learning site entry → Package entry: imports (evidence: `utils/main.js`)
