# artkodessometimes/circuitjs architecture

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

- Interactive diagram: https://gitdiagram.com/artkodessometimes/circuitjs
- Repository: https://github.com/artkodessometimes/circuitjs

## Overview

CircuitJS1 is a browser-based electronic circuit simulator, with this fork emphasizing responsive, touch-friendly use. The principal workflow is to create or load a circuit, run the simulation, and inspect component behavior and signals in scopes. The graph separates circuit editing, simulation components, waveform analysis, and shared UI/rendering services. Source excerpts show the simulator coordinating circuit elements and scopes; other capability links are omitted where the available evidence does not establish the runtime call path.

Main entry points: [`src/com/lushprojects/circuitjs1/client/CirSim.java`](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CirSim.java) (Simulator coordinator), [`src/com/lushprojects/circuitjs1/client/CircuitElm.java`](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CircuitElm.java) (Circuit elements), [`src/com/lushprojects/circuitjs1/client/TransistorElm.java`](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/TransistorElm.java) (Transistor model), [`src/com/lushprojects/circuitjs1/client/CustomLogicModel.java`](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CustomLogicModel.java) (Custom logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editing["Circuit Editing"]
  node_sim["Simulator coordinator<br/>[CirSim.java]"]
  node_toolbar["Component toolbar<br/>[Toolbar.java]"]
  node_edit["Circuit editor<br/>[EditDialog.java]"]
  node_import["Circuit import"]
  node_export["Circuit export"]
end

subgraph group_simulation["Circuit Simulation"]
  node_elements["Circuit elements<br/>[CircuitElm.java]"]
  node_resistor["Resistor model<br/>[ResistorElm.java]"]
  node_transistor["Transistor model<br/>[TransistorElm.java]"]
  node_customlogic["Custom logic"]
  node_composite["Composite circuits"]
end

subgraph group_analysis["Signal Analysis"]
  node_scope["Waveform scopes<br/>[Scope.java]"]
  node_scopeconfig["Scope controls"]
end

subgraph group_shared["UI and Rendering"]
  node_dialog["Dialog framework<br/>[Dialog.java]"]
  node_checkbox["Checkbox control<br/>[Checkbox.java]"]
  node_editinfo["Edit metadata<br/>[EditInfo.java]"]
  node_graphics["Canvas graphics<br/>[Graphics.java]"]
  node_geometry["Drawing geometry<br/>[Point.java]"]
  node_locale["Localization<br/>[Locale.java]"]
  node_tokenizer["Circuit tokenization"]
end

node_user(("Circuit designer"))

node_user -->|"edits and runs"| node_sim
node_sim -->|"coordinates elements"| node_elements
node_sim -->|"manages scopes"| node_scope
node_sim -->|"opens editor"| node_edit
node_sim -->|"opens import"| node_import
node_sim -->|"exports circuit"| node_export
node_scopeconfig -->|"configures plots"| node_scope
node_transistor -->|"extends"| node_elements
node_composite -->|"uses logic model"| node_customlogic
node_customlogic -->|"parses tokens"| node_tokenizer
node_sim -->|"uses translations"| node_locale
node_elements -->|"draws through"| node_graphics
node_elements -->|"uses points"| node_geometry
node_transistor -->|"provides edit fields"| node_editinfo
node_dialog -->|"references simulator"| node_sim

click node_sim "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CirSim.java"
click node_toolbar "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Toolbar.java"
click node_edit "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/EditDialog.java"
click node_import "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ImportFromTextDialog.java"
click node_export "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ExportAsTextDialog.java"
click node_elements "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CircuitElm.java"
click node_resistor "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ResistorElm.java"
click node_transistor "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/TransistorElm.java"
click node_customlogic "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CustomLogicModel.java"
click node_composite "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CustomCompositeModel.java"
click node_scope "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Scope.java"
click node_scopeconfig "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ScopePropertiesDialog.java"
click node_dialog "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Dialog.java"
click node_checkbox "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Checkbox.java"
click node_editinfo "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/EditInfo.java"
click node_graphics "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Graphics.java"
click node_geometry "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Point.java"
click node_locale "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/util/Locale.java"
click node_tokenizer "https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/StringTokenizer.java"

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_sim,node_toolbar,node_edit,node_import,node_export toneBlue
class node_elements,node_resistor,node_transistor,node_customlogic,node_composite toneAmber
class node_scope,node_scopeconfig toneMint
class node_dialog,node_checkbox,node_editinfo,node_graphics,node_geometry,node_locale,node_tokenizer toneRose
class node_user toneIndigo
```

## Components

### Circuit Editing

- [Simulator coordinator](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CirSim.java): `src/com/lushprojects/circuitjs1/client/CirSim.java`
- [Component toolbar](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Toolbar.java): `src/com/lushprojects/circuitjs1/client/Toolbar.java`
- [Circuit editor](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/EditDialog.java): `src/com/lushprojects/circuitjs1/client/EditDialog.java`
- [Circuit import](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ImportFromTextDialog.java): `src/com/lushprojects/circuitjs1/client/ImportFromTextDialog.java`
- [Circuit export](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ExportAsTextDialog.java): `src/com/lushprojects/circuitjs1/client/ExportAsTextDialog.java`

### Circuit Simulation

- [Circuit elements](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CircuitElm.java): `src/com/lushprojects/circuitjs1/client/CircuitElm.java`
- [Resistor model](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ResistorElm.java): `src/com/lushprojects/circuitjs1/client/ResistorElm.java`
- [Transistor model](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/TransistorElm.java): `src/com/lushprojects/circuitjs1/client/TransistorElm.java`
- [Custom logic](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CustomLogicModel.java): `src/com/lushprojects/circuitjs1/client/CustomLogicModel.java`
- [Composite circuits](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/CustomCompositeModel.java): `src/com/lushprojects/circuitjs1/client/CustomCompositeModel.java`

### Signal Analysis

- [Waveform scopes](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Scope.java): `src/com/lushprojects/circuitjs1/client/Scope.java`
- [Scope controls](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/ScopePropertiesDialog.java): `src/com/lushprojects/circuitjs1/client/ScopePropertiesDialog.java`

### UI and Rendering

- [Dialog framework](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Dialog.java): `src/com/lushprojects/circuitjs1/client/Dialog.java`
- [Checkbox control](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Checkbox.java): `src/com/lushprojects/circuitjs1/client/Checkbox.java`
- [Edit metadata](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/EditInfo.java): `src/com/lushprojects/circuitjs1/client/EditInfo.java`
- [Canvas graphics](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Graphics.java): `src/com/lushprojects/circuitjs1/client/Graphics.java`
- [Drawing geometry](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/Point.java): `src/com/lushprojects/circuitjs1/client/Point.java`
- [Localization](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/util/Locale.java): `src/com/lushprojects/circuitjs1/client/util/Locale.java`
- [Circuit tokenization](https://github.com/artkodessometimes/circuitjs/blob/main/src/com/lushprojects/circuitjs1/client/StringTokenizer.java): `src/com/lushprojects/circuitjs1/client/StringTokenizer.java`

### Other components

- **Circuit designer**

## Connections

- Circuit designer → Simulator coordinator: edits and runs (evidence: `README.md`)
- Simulator coordinator → Circuit elements: coordinates elements (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Simulator coordinator → Waveform scopes: manages scopes (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Simulator coordinator → Circuit editor: opens editor (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Simulator coordinator → Circuit import: opens import (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Simulator coordinator → Circuit export: exports circuit (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Scope controls → Waveform scopes: configures plots (evidence: `src/com/lushprojects/circuitjs1/client/ScopePropertiesDialog.java`)
- Transistor model → Circuit elements: extends (evidence: `src/com/lushprojects/circuitjs1/client/TransistorElm.java`)
- Composite circuits → Custom logic: uses logic model (evidence: `src/com/lushprojects/circuitjs1/client/CustomCompositeModel.java`)
- Custom logic → Circuit tokenization: parses tokens (evidence: `src/com/lushprojects/circuitjs1/client/CustomLogicModel.java`)
- Simulator coordinator → Localization: uses translations (evidence: `src/com/lushprojects/circuitjs1/client/CirSim.java`)
- Circuit elements → Canvas graphics: draws through (evidence: `src/com/lushprojects/circuitjs1/client/CircuitElm.java`)
- Circuit elements → Drawing geometry: uses points (evidence: `src/com/lushprojects/circuitjs1/client/CircuitElm.java`)
- Transistor model → Edit metadata: provides edit fields (evidence: `src/com/lushprojects/circuitjs1/client/TransistorElm.java`)
- Dialog framework → Simulator coordinator: references simulator (evidence: `src/com/lushprojects/circuitjs1/client/Dialog.java`)
