# savonneuse/midair-script architecture

> Architecture diagram of the GitHub repository savonneuse/midair-script, 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/savonneuse/midair-script
- Repository: https://github.com/savonneuse/midair-script

## Overview

Script Midair is a desktop and command-line calculator for finding sand/hammer TNT-cannon ratios. Users enter barrel positions and limits in the GUI, run a cancellable search, then inspect and sort solutions; the CLI accepts a JSON preset and prints text or JSON results. The solver derives barrel effects and searches candidate powers using the physics routines. The README also documents preset import/export and ranking criteria. UI styling and reusable widgets are shown as an internal layer. Some GUI details are omitted because the app source excerpt is partial.

Main entry points: [`src/app.rs`](https://github.com/savonneuse/midair-script/blob/main/src/app.rs) (Desktop workflow), [`src/main.rs`](https://github.com/savonneuse/midair-script/blob/main/src/main.rs) (Application launcher), [`src/cli.rs`](https://github.com/savonneuse/midair-script/blob/main/src/cli.rs) (CLI preset runner), [`src/solver.rs`](https://github.com/savonneuse/midair-script/blob/main/src/solver.rs) (Ratio search and ranking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_main["Application launcher<br/>[main.rs]"]
end

subgraph group_interfaces["User interfaces"]
  node_gui["Desktop workflow<br/>[app.rs]"]
  node_cli["CLI preset runner<br/>[cli.rs]"]
  node_console["Console attachment<br/>[console.rs]"]
end

subgraph group_calculation["Calculation engine"]
  node_solver["Ratio search and ranking<br/>[solver.rs]"]
  node_physics["Barrel physics<br/>[physics.rs]"]
end

subgraph group_presentation["UI presentation"]
  node_widgets["Reusable controls<br/>[widgets.rs]"]
  node_theme["Visual theme<br/>[theme.rs]"]
end

node_user(("User"))

node_user -->|"launches"| node_main
node_main -->|"starts GUI"| node_gui
node_main -->|"dispatches CLI"| node_cli
node_main -->|"attaches console"| node_console
node_user -->|"enters parameters"| node_gui
node_gui -->|"runs search"| node_solver
node_solver -->|"calculates barrels"| node_physics
node_solver -->|"returns solutions"| node_gui
node_user -->|"provides preset"| node_cli
node_cli -->|"runs search"| node_solver
node_cli -->|"prints results"| node_user
node_gui -->|"uses controls"| node_widgets
node_gui -->|"installs styling"| node_theme
node_widgets -->|"uses palette"| node_theme

click node_main "https://github.com/savonneuse/midair-script/blob/main/src/main.rs"
click node_gui "https://github.com/savonneuse/midair-script/blob/main/src/app.rs"
click node_cli "https://github.com/savonneuse/midair-script/blob/main/src/cli.rs"
click node_console "https://github.com/savonneuse/midair-script/blob/main/src/console.rs"
click node_solver "https://github.com/savonneuse/midair-script/blob/main/src/solver.rs"
click node_physics "https://github.com/savonneuse/midair-script/blob/main/src/physics.rs"
click node_widgets "https://github.com/savonneuse/midair-script/blob/main/src/widgets.rs"
click node_theme "https://github.com/savonneuse/midair-script/blob/main/src/theme.rs"

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_main,node_user toneBlue
class node_gui,node_cli,node_console toneAmber
class node_solver,node_physics toneMint
class node_widgets,node_theme toneRose
```

## Components

### Application entry

- [Application launcher](https://github.com/savonneuse/midair-script/blob/main/src/main.rs): `src/main.rs`

### User interfaces

- [Desktop workflow](https://github.com/savonneuse/midair-script/blob/main/src/app.rs): `src/app.rs`
- [CLI preset runner](https://github.com/savonneuse/midair-script/blob/main/src/cli.rs): `src/cli.rs`
- [Console attachment](https://github.com/savonneuse/midair-script/blob/main/src/console.rs): `src/console.rs`

### Calculation engine

- [Ratio search and ranking](https://github.com/savonneuse/midair-script/blob/main/src/solver.rs): `src/solver.rs`
- [Barrel physics](https://github.com/savonneuse/midair-script/blob/main/src/physics.rs): `src/physics.rs`

### UI presentation

- [Reusable controls](https://github.com/savonneuse/midair-script/blob/main/src/widgets.rs): `src/widgets.rs`
- [Visual theme](https://github.com/savonneuse/midair-script/blob/main/src/theme.rs): `src/theme.rs`

### Other components

- **User**

## Connections

- User → Application launcher: launches (evidence: `README.md`)
- Application launcher → Desktop workflow: starts GUI (evidence: `src/main.rs`)
- Application launcher → CLI preset runner: dispatches CLI (evidence: `src/main.rs`)
- Application launcher → Console attachment: attaches console (evidence: `src/main.rs`)
- User → Desktop workflow: enters parameters (evidence: `README.md`)
- Desktop workflow → Ratio search and ranking: runs search (evidence: `src/app.rs`)
- Ratio search and ranking → Barrel physics: calculates barrels (evidence: `src/solver.rs`)
- Ratio search and ranking → Desktop workflow: returns solutions (evidence: `src/app.rs`)
- User → CLI preset runner: provides preset (evidence: `README.md`)
- CLI preset runner → Ratio search and ranking: runs search (evidence: `src/cli.rs`)
- CLI preset runner → User: prints results (evidence: `src/cli.rs`)
- Desktop workflow → Reusable controls: uses controls (evidence: `src/app.rs`)
- Desktop workflow → Visual theme: installs styling (evidence: `src/app.rs`)
- Reusable controls → Visual theme: uses palette (evidence: `src/widgets.rs`)
