# princejwesley/mancy architecture

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

- Interactive diagram: https://gitdiagram.com/princejwesley/mancy
- Repository: https://github.com/princejwesley/mancy

## Overview

Mancy is an Electron/React desktop REPL. Users configure a language and editor, enter commands, and inspect interactive results; the app also offers a separate console, suggestions, preferences, and multiple language runtimes. The graph follows the documented workflow and source-index references. Several feature components are represented at directory level because their implementations were not sampled; those links are included only where README or index references support them.

Main entry points: [`src/components/Repl.js`](https://github.com/princejwesley/mancy/blob/master/src/components/Repl.js) (REPL coordinator), [`src/components/ReplActiveInput.js`](https://github.com/princejwesley/mancy/blob/master/src/components/ReplActiveInput.js) (Command editor), [`src/app.js`](https://github.com/princejwesley/mancy/blob/master/src/app.js) (React app entry), [`src/stores/ReplPreferencesStore.js`](https://github.com/princejwesley/mancy/blob/master/src/stores/ReplPreferencesStore.js) (Preferences state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop shell"]
  node_electron["Electron host<br/>[index.js]"]
  node_menu["Window menus<br/>[MenuManager.js]"]
  node_renderer["React app entry<br/>[app.js]"]
end

subgraph group_interaction["REPL interaction"]
  node_repl["REPL coordinator<br/>[Repl.js]"]
  node_input["Command editor<br/>[ReplActiveInput.js]"]
  node_prompt["Prompt view<br/>[ReplPrompt.js]"]
  node_history["Command history<br/>[ReplEntries.js]"]
  node_suggestions["Suggestions<br/>[ReplSuggestions.js]"]
  node_input_state["Input state"]
  node_input_actions["Input actions"]
end

subgraph group_runtime["Language runtime"]
  node_context["Execution context<br/>[ReplContext.js]"]
  node_common_runtime["Runtime utilities<br/>[ReplCommon.js]"]
  node_languages["Language selector<br/>[ReplLanguages.js]"]
  node_language_adapters["Language adapters"]
end

subgraph group_output["Output and settings"]
  node_output_dispatch["Output dispatch<br/>[ReplOutput.js]"]
  node_output_views["Result viewers"]
  node_dom["DOM helpers<br/>[ReplDOM.js]"]
  node_console["Async console<br/>[ReplConsole.js]"]
  node_console_hook["Console capture<br/>[ReplConsoleHook.js]"]
  node_preferences["Preferences UI<br/>[ReplPreferences.js]"]
  node_preferences_state["Preferences state"]
  node_settings["Settings defaults<br/>[ReplConstants.js]"]
end

node_electron -->|"manages menus"| node_menu
node_renderer -->|"renders"| node_repl
node_renderer -->|"renders"| node_suggestions
node_renderer -->|"renders"| node_preferences
node_repl -->|"uses"| node_input
node_repl -->|"uses"| node_prompt
node_repl -->|"renders"| node_history
node_repl -->|"uses"| node_console
node_repl -->|"dispatches"| node_input_actions
node_input -->|"reads"| node_input_state
node_input_state -->|"listens to"| node_input_actions
node_input -->|"executes in"| node_context
node_input -->|"selects runtime"| node_languages
node_languages -->|"selects adapter"| node_language_adapters
node_language_adapters -->|"uses context"| node_context
node_input -->|"formats results"| node_output_dispatch
node_output_dispatch -->|"renders values"| node_output_views
node_output_dispatch -->|"uses helpers"| node_dom
node_console -->|"captures logs"| node_console_hook
node_preferences -->|"reads settings"| node_preferences_state
node_preferences_state -->|"uses constants"| node_settings
node_renderer -->|"loads defaults"| node_settings
node_preferences_state -->|"updates compiler options"| node_languages
node_preferences_state -->|"configures paths"| node_context

click node_electron "https://github.com/princejwesley/mancy/blob/master/src/main/index.js"
click node_menu "https://github.com/princejwesley/mancy/blob/master/src/main/MenuManager.js"
click node_renderer "https://github.com/princejwesley/mancy/blob/master/src/app.js"
click node_repl "https://github.com/princejwesley/mancy/blob/master/src/components/Repl.js"
click node_input "https://github.com/princejwesley/mancy/blob/master/src/components/ReplActiveInput.js"
click node_prompt "https://github.com/princejwesley/mancy/blob/master/src/components/ReplPrompt.js"
click node_history "https://github.com/princejwesley/mancy/blob/master/src/components/ReplEntries.js"
click node_suggestions "https://github.com/princejwesley/mancy/blob/master/src/components/ReplSuggestions.js"
click node_input_state "https://github.com/princejwesley/mancy/blob/master/src/stores/ReplActiveInputStore.js"
click node_input_actions "https://github.com/princejwesley/mancy/blob/master/src/actions/ReplActiveInputActions.js"
click node_context "https://github.com/princejwesley/mancy/blob/master/src/common/ReplContext.js"
click node_common_runtime "https://github.com/princejwesley/mancy/blob/master/src/common/ReplCommon.js"
click node_languages "https://github.com/princejwesley/mancy/blob/master/src/languages/ReplLanguages.js"
click node_language_adapters "https://github.com/princejwesley/mancy/tree/master/src/languages"
click node_output_dispatch "https://github.com/princejwesley/mancy/blob/master/src/common/ReplOutput.js"
click node_output_views "https://github.com/princejwesley/mancy/tree/master/src/components"
click node_dom "https://github.com/princejwesley/mancy/blob/master/src/common/ReplDOM.js"
click node_console "https://github.com/princejwesley/mancy/blob/master/src/components/ReplConsole.js"
click node_console_hook "https://github.com/princejwesley/mancy/blob/master/src/common/ReplConsoleHook.js"
click node_preferences "https://github.com/princejwesley/mancy/blob/master/src/components/ReplPreferences.js"
click node_preferences_state "https://github.com/princejwesley/mancy/blob/master/src/stores/ReplPreferencesStore.js"
click node_settings "https://github.com/princejwesley/mancy/blob/master/src/constants/ReplConstants.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_electron,node_menu,node_renderer toneBlue
class node_repl,node_input,node_prompt,node_history,node_suggestions,node_input_state,node_input_actions toneAmber
class node_context,node_common_runtime,node_languages,node_language_adapters toneMint
class node_output_dispatch,node_output_views,node_dom,node_console,node_console_hook,node_preferences,node_preferences_state,node_settings toneRose
```

## Components

### Desktop shell

- [Electron host](https://github.com/princejwesley/mancy/blob/master/src/main/index.js): `src/main/index.js`
- [Window menus](https://github.com/princejwesley/mancy/blob/master/src/main/MenuManager.js): `src/main/MenuManager.js`
- [React app entry](https://github.com/princejwesley/mancy/blob/master/src/app.js): `src/app.js`

### REPL interaction

- [REPL coordinator](https://github.com/princejwesley/mancy/blob/master/src/components/Repl.js): `src/components/Repl.js`
- [Command editor](https://github.com/princejwesley/mancy/blob/master/src/components/ReplActiveInput.js): `src/components/ReplActiveInput.js`
- [Prompt view](https://github.com/princejwesley/mancy/blob/master/src/components/ReplPrompt.js): `src/components/ReplPrompt.js`
- [Command history](https://github.com/princejwesley/mancy/blob/master/src/components/ReplEntries.js): `src/components/ReplEntries.js`
- [Suggestions](https://github.com/princejwesley/mancy/blob/master/src/components/ReplSuggestions.js): `src/components/ReplSuggestions.js`
- [Input state](https://github.com/princejwesley/mancy/blob/master/src/stores/ReplActiveInputStore.js): `src/stores/ReplActiveInputStore.js`
- [Input actions](https://github.com/princejwesley/mancy/blob/master/src/actions/ReplActiveInputActions.js): `src/actions/ReplActiveInputActions.js`

### Language runtime

- [Execution context](https://github.com/princejwesley/mancy/blob/master/src/common/ReplContext.js): `src/common/ReplContext.js`
- [Runtime utilities](https://github.com/princejwesley/mancy/blob/master/src/common/ReplCommon.js): `src/common/ReplCommon.js`
- [Language selector](https://github.com/princejwesley/mancy/blob/master/src/languages/ReplLanguages.js): `src/languages/ReplLanguages.js`
- [Language adapters](https://github.com/princejwesley/mancy/tree/master/src/languages): `src/languages`

### Output and settings

- [Output dispatch](https://github.com/princejwesley/mancy/blob/master/src/common/ReplOutput.js): `src/common/ReplOutput.js`
- [Result viewers](https://github.com/princejwesley/mancy/tree/master/src/components): `src/components`
- [DOM helpers](https://github.com/princejwesley/mancy/blob/master/src/common/ReplDOM.js): `src/common/ReplDOM.js`
- [Async console](https://github.com/princejwesley/mancy/blob/master/src/components/ReplConsole.js): `src/components/ReplConsole.js`
- [Console capture](https://github.com/princejwesley/mancy/blob/master/src/common/ReplConsoleHook.js): `src/common/ReplConsoleHook.js`
- [Preferences UI](https://github.com/princejwesley/mancy/blob/master/src/components/ReplPreferences.js): `src/components/ReplPreferences.js`
- [Preferences state](https://github.com/princejwesley/mancy/blob/master/src/stores/ReplPreferencesStore.js): `src/stores/ReplPreferencesStore.js`
- [Settings defaults](https://github.com/princejwesley/mancy/blob/master/src/constants/ReplConstants.js): `src/constants/ReplConstants.js`

## Connections

- Electron host → Window menus: manages menus (evidence: `src/main/index.js`)
- React app entry → REPL coordinator: renders (evidence: `src/app.js`)
- React app entry → Suggestions: renders (evidence: `src/app.js`)
- React app entry → Preferences UI: renders (evidence: `src/app.js`)
- REPL coordinator → Command editor: uses (evidence: `src/components/Repl.js`)
- REPL coordinator → Prompt view: uses (evidence: `src/components/Repl.js`)
- REPL coordinator → Command history: renders (evidence: `src/components/Repl.js`)
- REPL coordinator → Async console: uses (evidence: `src/components/Repl.js`)
- REPL coordinator → Input actions: dispatches (evidence: `src/components/Repl.js`)
- Command editor → Input state: reads (evidence: `src/components/ReplActiveInput.js`)
- Input state → Input actions: listens to (evidence: `src/stores/ReplActiveInputStore.js`)
- Command editor → Execution context: executes in (evidence: `src/components/ReplActiveInput.js`)
- Command editor → Language selector: selects runtime (evidence: `src/components/ReplActiveInput.js`)
- Language selector → Language adapters: selects adapter (evidence: `src/languages/ReplLanguages.js`)
- Language adapters → Execution context: uses context (evidence: `src/languages/ReplLangWrapper.js`)
- Command editor → Output dispatch: formats results (evidence: `src/components/ReplActiveInput.js`)
- Output dispatch → Result viewers: renders values (evidence: `src/common/ReplOutput.js`)
- Output dispatch → DOM helpers: uses helpers (evidence: `src/common/ReplOutput.js`)
- Async console → Console capture: captures logs (evidence: `src/components/ReplConsole.js`)
- Preferences UI → Preferences state: reads settings (evidence: `src/components/ReplPreferences.js`)
- Preferences state → Settings defaults: uses constants (evidence: `src/stores/ReplPreferencesStore.js`)
- React app entry → Settings defaults: loads defaults (evidence: `src/app.js`)
- Preferences state → Language selector: updates compiler options (evidence: `src/stores/ReplPreferencesStore.js`)
- Preferences state → Execution context: configures paths (evidence: `src/stores/ReplPreferencesStore.js`)
