# probabletrain/mapgenerator architecture

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

- Interactive diagram: https://gitdiagram.com/probabletrain/mapgenerator
- Repository: https://github.com/probabletrain/mapgenerator

## Overview

Map Generator is a browser-based procedural city-map editor. A user opens the generator, adjusts the map and generation controls, and can generate roads, water, blocks, and buildings before styling or exporting the result. The documented product also supports image downloads (PNG/SVG) and 3D STL downloads. The graph reflects the main entry point and module references in the source index; unsampled implementation details are not inferred as specific call sequences.

Main entry points: [`src/ts/ui/main_gui.ts`](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/main_gui.ts) (Generation controls), [`src/ts/impl/tensor_field.ts`](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/tensor_field.ts) (Tensor field), [`src/main.ts`](https://github.com/probabletrain/mapgenerator/blob/master/src/main.ts) (Application entry), [`src/ts/impl/water_generator.ts`](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/water_generator.ts) (Water generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Editor interaction"]
  node_entry["Application entry<br/>[main.ts]"]
  node_gui["Generation controls<br/>[main_gui.ts]"]
  node_fieldgui["Field controls"]
  node_drag["Drag controls<br/>[drag_controller.ts]"]
  node_domain["Pan and zoom"]
  node_roadsui["Road controls<br/>[road_gui.ts]"]
  node_waterui["Water controls<br/>[water_gui.ts]"]
end

subgraph group_generation["City generation"]
  node_streamlines["Streamline generation<br/>[streamlines.ts]"]
  node_water["Water generation<br/>[water_generator.ts]"]
  node_graph["Road graph<br/>[graph.ts]"]
  node_polygons["Block polygons<br/>[polygon_finder.ts]"]
  node_buildings["Building generation<br/>[buildings.ts]"]
end

subgraph group_presentation["Rendering and export"]
  node_style["Map styling<br/>[style.ts]"]
  node_canvas["Canvas and SVG<br/>[canvas_wrapper.ts]"]
  node_model["3D model export<br/>[model_generator.ts]"]
end

subgraph group_core["Geometry and fields"]
  node_tensorfield["Tensor field<br/>[tensor_field.ts]"]
  node_basis["Basis fields<br/>[basis_field.ts]"]
  node_integrator["Field integration<br/>[integrator.ts]"]
  node_polyutil["Polygon operations<br/>[polygon_util.ts]"]
  node_vectors["Vector math<br/>[vector.ts]"]
end

node_user(("Map editor user"))

node_user -->|"opens"| node_entry
node_entry -->|"initializes"| node_gui
node_entry -->|"initializes"| node_fieldgui
node_entry -->|"initializes"| node_drag
node_entry -->|"uses"| node_domain
node_gui -->|"uses"| node_tensorfield
node_gui -->|"uses"| node_streamlines
node_gui -->|"uses"| node_water
node_gui -->|"uses"| node_graph
node_gui -->|"uses"| node_roadsui
node_gui -->|"uses"| node_waterui
node_gui -->|"uses"| node_buildings
node_gui -->|"uses"| node_polygons
node_gui -->|"uses"| node_style
node_fieldgui -->|"edits"| node_tensorfield
node_fieldgui -->|"uses"| node_basis
node_drag -->|"transforms view"| node_domain
node_roadsui -->|"uses"| node_streamlines
node_waterui -->|"uses"| node_water
node_tensorfield -->|"samples"| node_basis
node_integrator -->|"samples"| node_tensorfield
node_streamlines -->|"integrates with"| node_integrator
node_streamlines -->|"uses"| node_vectors
node_water -->|"uses"| node_streamlines
node_water -->|"uses"| node_tensorfield
node_water -->|"uses"| node_polyutil
node_polygons -->|"walks nodes"| node_graph
node_polygons -->|"checks land"| node_tensorfield
node_polygons -->|"uses"| node_polyutil
node_buildings -->|"builds from"| node_graph
node_buildings -->|"finds lots"| node_polygons
node_buildings -->|"uses"| node_tensorfield
node_style -->|"draws with"| node_canvas
node_gui -->|"exports model"| node_model
node_user -->|"downloads PNG or SVG"| node_style
node_user -->|"downloads STL"| node_model
node_tensorfield -->|"uses"| node_vectors
node_polyutil -->|"uses"| node_vectors

click node_entry "https://github.com/probabletrain/mapgenerator/blob/master/src/main.ts"
click node_gui "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/main_gui.ts"
click node_fieldgui "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/tensor_field_gui.ts"
click node_drag "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/drag_controller.ts"
click node_domain "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/domain_controller.ts"
click node_roadsui "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/road_gui.ts"
click node_waterui "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/water_gui.ts"
click node_tensorfield "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/tensor_field.ts"
click node_basis "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/basis_field.ts"
click node_integrator "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/integrator.ts"
click node_streamlines "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/streamlines.ts"
click node_water "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/water_generator.ts"
click node_graph "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/graph.ts"
click node_polygons "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/polygon_finder.ts"
click node_polyutil "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/polygon_util.ts"
click node_buildings "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/buildings.ts"
click node_style "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/style.ts"
click node_canvas "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/canvas_wrapper.ts"
click node_model "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/model_generator.ts"
click node_vectors "https://github.com/probabletrain/mapgenerator/blob/master/src/ts/vector.ts"

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_gui,node_fieldgui,node_drag,node_domain,node_roadsui,node_waterui,node_user toneBlue
class node_streamlines,node_water,node_graph,node_polygons,node_buildings toneAmber
class node_style,node_canvas,node_model toneMint
class node_tensorfield,node_basis,node_integrator,node_polyutil,node_vectors toneRose
```

## Components

### Editor interaction

- [Application entry](https://github.com/probabletrain/mapgenerator/blob/master/src/main.ts): `src/main.ts`
- [Generation controls](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/main_gui.ts): `src/ts/ui/main_gui.ts`
- [Field controls](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/tensor_field_gui.ts): `src/ts/ui/tensor_field_gui.ts`
- [Drag controls](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/drag_controller.ts): `src/ts/ui/drag_controller.ts`
- [Pan and zoom](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/domain_controller.ts): `src/ts/ui/domain_controller.ts`
- [Road controls](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/road_gui.ts): `src/ts/ui/road_gui.ts`
- [Water controls](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/water_gui.ts): `src/ts/ui/water_gui.ts`

### City generation

- [Streamline generation](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/streamlines.ts): `src/ts/impl/streamlines.ts`
- [Water generation](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/water_generator.ts): `src/ts/impl/water_generator.ts`
- [Road graph](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/graph.ts): `src/ts/impl/graph.ts`
- [Block polygons](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/polygon_finder.ts): `src/ts/impl/polygon_finder.ts`
- [Building generation](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/buildings.ts): `src/ts/ui/buildings.ts`

### Rendering and export

- [Map styling](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/style.ts): `src/ts/ui/style.ts`
- [Canvas and SVG](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/ui/canvas_wrapper.ts): `src/ts/ui/canvas_wrapper.ts`
- [3D model export](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/model_generator.ts): `src/ts/model_generator.ts`

### Geometry and fields

- [Tensor field](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/tensor_field.ts): `src/ts/impl/tensor_field.ts`
- [Basis fields](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/basis_field.ts): `src/ts/impl/basis_field.ts`
- [Field integration](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/integrator.ts): `src/ts/impl/integrator.ts`
- [Polygon operations](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/impl/polygon_util.ts): `src/ts/impl/polygon_util.ts`
- [Vector math](https://github.com/probabletrain/mapgenerator/blob/master/src/ts/vector.ts): `src/ts/vector.ts`

### Other components

- **Map editor user**

## Connections

- Map editor user → Application entry: opens (evidence: `README.md`)
- Application entry → Generation controls: initializes (evidence: `src/main.ts`)
- Application entry → Field controls: initializes (evidence: `src/main.ts`)
- Application entry → Drag controls: initializes (evidence: `src/main.ts`)
- Application entry → Pan and zoom: uses (evidence: `src/main.ts`)
- Generation controls → Tensor field: uses (evidence: `src/ts/ui/main_gui.ts`)
- Generation controls → Streamline generation: uses (evidence: `src/ts/ui/main_gui.ts`)
- Generation controls → Water generation: uses (evidence: `src/ts/ui/main_gui.ts`)
- Generation controls → Road graph: uses (evidence: `src/ts/ui/main_gui.ts`)
- Generation controls → Road controls: uses (evidence: `src/ts/ui/main_gui.ts`)
- Generation controls → Water controls: uses (evidence: `src/ts/ui/main_gui.ts`)
- Generation controls → Building generation: uses (evidence: `src/ts/ui/main_gui.ts`)
- Generation controls → Block polygons: uses (evidence: `src/ts/ui/main_gui.ts`)
- Generation controls → Map styling: uses (evidence: `src/ts/ui/main_gui.ts`)
- Field controls → Tensor field: edits (evidence: `src/ts/ui/tensor_field_gui.ts`)
- Field controls → Basis fields: uses (evidence: `src/ts/ui/tensor_field_gui.ts`)
- Drag controls → Pan and zoom: transforms view (evidence: `src/ts/ui/drag_controller.ts`)
- Road controls → Streamline generation: uses (evidence: `src/ts/ui/road_gui.ts`)
- Water controls → Water generation: uses (evidence: `src/ts/ui/water_gui.ts`)
- Tensor field → Basis fields: samples (evidence: `src/ts/impl/tensor_field.ts`)
- Field integration → Tensor field: samples (evidence: `src/ts/impl/integrator.ts`)
- Streamline generation → Field integration: integrates with (evidence: `src/ts/impl/streamlines.ts`)
- Streamline generation → Vector math: uses (evidence: `src/ts/impl/streamlines.ts`)
- Water generation → Streamline generation: uses (evidence: `src/ts/impl/water_generator.ts`)
- Water generation → Tensor field: uses (evidence: `src/ts/impl/water_generator.ts`)
- Water generation → Polygon operations: uses (evidence: `src/ts/impl/water_generator.ts`)
- Block polygons → Road graph: walks nodes (evidence: `src/ts/impl/polygon_finder.ts`)
- Block polygons → Tensor field: checks land (evidence: `src/ts/impl/polygon_finder.ts`)
- Block polygons → Polygon operations: uses (evidence: `src/ts/impl/polygon_finder.ts`)
- Building generation → Road graph: builds from (evidence: `src/ts/ui/buildings.ts`)
- Building generation → Block polygons: finds lots (evidence: `src/ts/ui/buildings.ts`)
- Building generation → Tensor field: uses (evidence: `src/ts/ui/buildings.ts`)
- Map styling → Canvas and SVG: draws with (evidence: `src/ts/ui/style.ts`)
- Generation controls → 3D model export: exports model (evidence: `src/ts/ui/main_gui.ts`)
- Map editor user → Map styling: downloads PNG or SVG (evidence: `README.md`)
- Map editor user → 3D model export: downloads STL (evidence: `README.md`)
- Tensor field → Vector math: uses (evidence: `src/ts/impl/tensor_field.ts`)
- Polygon operations → Vector math: uses (evidence: `src/ts/impl/polygon_util.ts`)
