# bfur64/menu-manager architecture

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

- Interactive diagram: https://gitdiagram.com/bfur64/menu-manager
- Repository: https://github.com/bfur64/menu-manager

## Overview

Menu Manager is a composable Java terminal-menu runtime. A caller supplies a terminal and item list; MenuManager polls keys, routes them to the active editor or popup (otherwise handling navigation and selection), processes ready button actions, and renders each frame. Items provide editable values, toggles, keybinds, actions, and dynamic/static display; Property supplies mutable state, parsing, and validation. The source excerpts show the central dispatch and editing behavior; several supporting links rely on the SOURCE INDEX or README rather than inspected implementations.

Main entry points: [`menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java) (Menu manager), [`menu-manager-core/src/main/java/io/github/bfur64/menu/Event.java`](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/Event.java) (Event bus), [`menu-manager-core/src/main/java/io/github/bfur64/menu/MenuRenderer.java`](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/MenuRenderer.java) (Menu renderer), [`menu-manager-core/src/main/java/io/github/bfur64/menu/PopupManager.java`](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/PopupManager.java) (Error popup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Menu runtime"]
  node_manager["Menu manager<br/>[MenuManager.java]"]
  node_input["Input contract<br/>[InputHandler.java]"]
  node_cursor["Menu cursor<br/>[MenuCursor.java]"]
  node_renderer["Menu renderer<br/>[MenuRenderer.java]"]
  node_stack["Menu stack<br/>[ItemStack.java]"]
end

subgraph group_composition["Items and state"]
  node_items["Menu items<br/>[Item.java]"]
  node_actions["Selectable actions<br/>[ActionItem.java]"]
  node_editor["Value editor<br/>[InputItem.java]"]
  node_keyedit["Keybind editor<br/>[KeyInputItem.java]"]
  node_toggle["Toggle item<br/>[ToggleItem.java]"]
  node_property["Property state<br/>[Property.java]"]
  node_display["Display items<br/>[DynamicText.java]"]
end

subgraph group_feedback["Events and feedback"]
  node_events["Event bus<br/>[Event.java]"]
  node_popup["Error popup<br/>[PopupManager.java]"]
  node_eventtypes["Menu events"]
end

node_user(("Menu user"))
node_terminal["Terminal"]

node_user -->|"starts menu"| node_manager
node_terminal -->|"provides input"| node_manager
node_manager -->|"polls keys"| node_terminal
node_manager -->|"renders through"| node_terminal
node_manager -->|"routes keys"| node_input
node_manager -->|"moves cursor"| node_cursor
node_manager -->|"calls render"| node_renderer
node_manager -->|"adds menu items"| node_stack
node_manager -->|"publishes events"| node_events
node_manager -->|"routes popup input"| node_popup
node_renderer -->|"draws menu"| node_terminal
node_renderer -->|"renders items"| node_items
node_renderer -->|"draws popup"| node_popup
node_actions -->|"publishes selection"| node_events
node_editor -->|"validates and updates"| node_property
node_editor -->|"publishes errors"| node_events
node_keyedit -->|"specializes editing"| node_editor
node_toggle -->|"updates state"| node_property
node_events -->|"dispatches events"| node_eventtypes
node_popup -->|"subscribes and publishes"| node_events
node_popup -->|"draws feedback"| node_terminal
node_items -.->|"supports editable state"| node_property
node_display -->|"provides dynamic display"| node_items

click node_manager "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java"
click node_input "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/input/InputHandler.java"
click node_cursor "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/MenuCursor.java"
click node_renderer "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/MenuRenderer.java"
click node_stack "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/ItemStack.java"
click node_items "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/Item.java"
click node_actions "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/ActionItem.java"
click node_editor "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/InputItem.java"
click node_keyedit "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/KeyInputItem.java"
click node_toggle "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/ToggleItem.java"
click node_property "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/Property.java"
click node_display "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/display/DynamicText.java"
click node_events "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/Event.java"
click node_popup "https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/PopupManager.java"
click node_eventtypes "https://github.com/bfur64/menu-manager/tree/main/menu-manager-core/src/main/java/io/github/bfur64/menu/event"

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_manager,node_input,node_cursor,node_renderer,node_stack,node_user toneBlue
class node_items,node_actions,node_editor,node_keyedit,node_toggle,node_property,node_display toneAmber
class node_events,node_popup,node_eventtypes toneMint
class node_terminal toneIndigo
```

## Components

### Menu runtime

- [Menu manager](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`
- [Input contract](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/input/InputHandler.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/input/InputHandler.java`
- [Menu cursor](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/MenuCursor.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuCursor.java`
- [Menu renderer](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/MenuRenderer.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuRenderer.java`
- [Menu stack](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/ItemStack.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/ItemStack.java`

### Items and state

- [Menu items](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/Item.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/item/Item.java`
- [Selectable actions](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/ActionItem.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/item/ActionItem.java`
- [Value editor](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/InputItem.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/InputItem.java`
- [Keybind editor](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/KeyInputItem.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/KeyInputItem.java`
- [Toggle item](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/ToggleItem.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/ToggleItem.java`
- [Property state](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/Property.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/Property.java`
- [Display items](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/item/display/DynamicText.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/item/display/DynamicText.java`

### Events and feedback

- [Event bus](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/Event.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/Event.java`
- [Error popup](https://github.com/bfur64/menu-manager/blob/main/menu-manager-core/src/main/java/io/github/bfur64/menu/PopupManager.java): `menu-manager-core/src/main/java/io/github/bfur64/menu/PopupManager.java`
- [Menu events](https://github.com/bfur64/menu-manager/tree/main/menu-manager-core/src/main/java/io/github/bfur64/menu/event): `menu-manager-core/src/main/java/io/github/bfur64/menu/event`

### Other components

- **Menu user**
- **Terminal**

## Connections

- Menu user → Menu manager: starts menu (evidence: `README.md`)
- Terminal → Menu manager: provides input (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`)
- Menu manager → Terminal: polls keys (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`)
- Menu manager → Terminal: renders through (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`)
- Menu manager → Input contract: routes keys (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`)
- Menu manager → Menu cursor: moves cursor (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`)
- Menu manager → Menu renderer: calls render (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`)
- Menu manager → Menu stack: adds menu items (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`)
- Menu manager → Event bus: publishes events (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`)
- Menu manager → Error popup: routes popup input (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuManager.java`)
- Menu renderer → Terminal: draws menu (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuRenderer.java`)
- Menu renderer → Menu items: renders items (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuRenderer.java`)
- Menu renderer → Error popup: draws popup (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/MenuRenderer.java`)
- Selectable actions → Event bus: publishes selection
- Value editor → Property state: validates and updates (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/InputItem.java`)
- Value editor → Event bus: publishes errors (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/InputItem.java`)
- Keybind editor → Value editor: specializes editing (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/KeyInputItem.java`)
- Toggle item → Property state: updates state (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/item/input/ToggleItem.java`)
- Event bus → Menu events: dispatches events (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/Event.java`)
- Error popup → Event bus: subscribes and publishes (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/PopupManager.java`)
- Error popup → Terminal: draws feedback (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/PopupManager.java`)
- Menu items → Property state: supports editable state (evidence: `README.md`)
- Display items → Menu items: provides dynamic display (evidence: `menu-manager-core/src/main/java/io/github/bfur64/menu/item/display/DynamicText.java`)
