# horizontal42/summarum architecture

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

## Overview

Summarum is a bilingual calculator notebook: users enter text in sheets and receive live, formatted results. The main path runs from the desktop UI through the sheet workspace and calculation engine to rendered answers; related branches support cross-sheet references, search, persistence, exports, extensions, rates, and updates. The engine’s documented and indexed modules are represented. Some native and network wiring is only partially visible, so unverified connections are marked dashed.

Main entry points: [`src/main.ts`](https://github.com/horizontal42/summarum/blob/main/src/main.ts) (App coordinator), [`src/engine/index.ts`](https://github.com/horizontal42/summarum/blob/main/src/engine/index.ts) (Engine facade), [`src/engine/registry.ts`](https://github.com/horizontal42/summarum/blob/main/src/engine/registry.ts) (Phrase registry), [`src/storage.ts`](https://github.com/horizontal42/summarum/blob/main/src/storage.ts) (Sheet storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Notebook app"]
  node_app["App coordinator<br/>[main.ts]"]
  node_editor["Sheet editor<br/>[editor.ts]"]
  node_workspace["Sheet workspace<br/>[workspace.ts]"]
  node_search["Sheet search<br/>[search.ts]"]
  node_export["Image export<br/>[export.ts]"]
  node_sparkline["Sparklines<br/>[sparkline.ts]"]
end

subgraph group_engine["Calculation engine"]
  node_engine["Engine facade<br/>[index.ts]"]
  node_lexer["Text lexer<br/>[lexer.ts]"]
  node_tokenizer["Phrase tokenizer<br/>[tokenizer.ts]"]
  node_registry["Phrase registry<br/>[registry.ts]"]
  node_vocab["Bilingual vocabulary<br/>[vocab.ts]"]
  node_vocabdata["Vocabulary data<br/>[vocab-data.ts]"]
  node_unitdata["Unit definitions<br/>[unitdata.ts]"]
  node_extraunits["Extra units<br/>[extraunits.ts]"]
  node_parser["Expression parser<br/>[parser.ts]"]
  node_evaluator["Value evaluator<br/>[evaluator.ts]"]
  node_datetime["Date and time<br/>[datetime.ts]"]
  node_formatter["Result formatter<br/>[formatter.ts]"]
end

subgraph group_data["Data and integrations"]
  node_storage[("Sheet storage<br/>[storage.ts]")]
  node_extensions["Extensions API<br/>[extensions.ts]"]
  node_i18n["Interface translations<br/>[i18n.ts]"]
  node_updater["App updater<br/>[updater.ts]"]
end

subgraph group_desktop["Desktop runtime"]
  node_native["Tauri runtime<br/>[main.rs]"]
end

node_user(("User"))
node_market["Rates and markets"]

node_user -->|"uses"| node_app
node_app -->|"creates"| node_editor
node_editor -->|"evaluates text"| node_engine
node_editor -->|"renders"| node_sparkline
node_app -->|"manages sheets"| node_workspace
node_workspace -->|"evaluates sheets"| node_engine
node_app -->|"opens search"| node_search
node_search -->|"searches sheets"| node_workspace
node_search -->|"matches results"| node_engine
node_app -->|"exports sheets"| node_export
node_export -->|"reads sheet data"| node_storage
node_app -->|"loads and saves"| node_storage
node_app -->|"loads extensions"| node_extensions
node_extensions -->|"registers additions"| node_engine
node_app -->|"translates interface"| node_i18n
node_app -->|"checks updates"| node_updater
node_engine -->|"tokenizes lines"| node_tokenizer
node_tokenizer -->|"lexes text"| node_lexer
node_tokenizer -->|"looks up phrases"| node_registry
node_engine -->|"builds registry"| node_registry
node_registry -->|"loads vocabulary"| node_vocab
node_vocab -->|"reads definitions"| node_vocabdata
node_registry -->|"loads units"| node_unitdata
node_registry -->|"loads extra units"| node_extraunits
node_engine -->|"parses lines"| node_parser
node_parser -->|"consumes tokens"| node_tokenizer
node_parser -->|"uses phrase types"| node_registry
node_engine -->|"evaluates expressions"| node_evaluator
node_evaluator -->|"resolves dates"| node_datetime
node_engine -->|"formats results"| node_formatter
node_storage -.->|"invokes commands"| node_native
node_app -->|"fetches live data"| node_storage
node_storage -.->|"requests rates and prices"| node_market
node_native -.->|"fetches external data"| node_market

click node_app "https://github.com/horizontal42/summarum/blob/main/src/main.ts"
click node_editor "https://github.com/horizontal42/summarum/blob/main/src/ui/editor.ts"
click node_workspace "https://github.com/horizontal42/summarum/blob/main/src/workspace.ts"
click node_search "https://github.com/horizontal42/summarum/blob/main/src/ui/search.ts"
click node_export "https://github.com/horizontal42/summarum/blob/main/src/ui/export.ts"
click node_sparkline "https://github.com/horizontal42/summarum/blob/main/src/ui/sparkline.ts"
click node_engine "https://github.com/horizontal42/summarum/blob/main/src/engine/index.ts"
click node_lexer "https://github.com/horizontal42/summarum/blob/main/src/engine/lexer.ts"
click node_tokenizer "https://github.com/horizontal42/summarum/blob/main/src/engine/tokenizer.ts"
click node_registry "https://github.com/horizontal42/summarum/blob/main/src/engine/registry.ts"
click node_vocab "https://github.com/horizontal42/summarum/blob/main/src/engine/vocab.ts"
click node_vocabdata "https://github.com/horizontal42/summarum/blob/main/src/engine/vocab-data.ts"
click node_unitdata "https://github.com/horizontal42/summarum/blob/main/src/engine/unitdata.ts"
click node_extraunits "https://github.com/horizontal42/summarum/blob/main/src/engine/extraunits.ts"
click node_parser "https://github.com/horizontal42/summarum/blob/main/src/engine/parser.ts"
click node_evaluator "https://github.com/horizontal42/summarum/blob/main/src/engine/evaluator.ts"
click node_datetime "https://github.com/horizontal42/summarum/blob/main/src/engine/datetime.ts"
click node_formatter "https://github.com/horizontal42/summarum/blob/main/src/engine/formatter.ts"
click node_storage "https://github.com/horizontal42/summarum/blob/main/src/storage.ts"
click node_extensions "https://github.com/horizontal42/summarum/blob/main/src/extensions.ts"
click node_i18n "https://github.com/horizontal42/summarum/blob/main/src/i18n.ts"
click node_updater "https://github.com/horizontal42/summarum/blob/main/src/updater.ts"
click node_native "https://github.com/horizontal42/summarum/blob/main/src-tauri/src/main.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_app,node_editor,node_workspace,node_search,node_export,node_sparkline,node_user toneBlue
class node_engine,node_lexer,node_tokenizer,node_registry,node_vocab,node_vocabdata,node_unitdata,node_extraunits,node_parser,node_evaluator,node_datetime,node_formatter toneAmber
class node_storage,node_extensions,node_i18n,node_updater toneMint
class node_native toneRose
class node_market toneIndigo
```

## Components

### Notebook app

- [App coordinator](https://github.com/horizontal42/summarum/blob/main/src/main.ts): `src/main.ts`
- [Sheet editor](https://github.com/horizontal42/summarum/blob/main/src/ui/editor.ts): `src/ui/editor.ts`
- [Sheet workspace](https://github.com/horizontal42/summarum/blob/main/src/workspace.ts): `src/workspace.ts`
- [Sheet search](https://github.com/horizontal42/summarum/blob/main/src/ui/search.ts): `src/ui/search.ts`
- [Image export](https://github.com/horizontal42/summarum/blob/main/src/ui/export.ts): `src/ui/export.ts`
- [Sparklines](https://github.com/horizontal42/summarum/blob/main/src/ui/sparkline.ts): `src/ui/sparkline.ts`

### Calculation engine

- [Engine facade](https://github.com/horizontal42/summarum/blob/main/src/engine/index.ts): `src/engine/index.ts`
- [Text lexer](https://github.com/horizontal42/summarum/blob/main/src/engine/lexer.ts): `src/engine/lexer.ts`
- [Phrase tokenizer](https://github.com/horizontal42/summarum/blob/main/src/engine/tokenizer.ts): `src/engine/tokenizer.ts`
- [Phrase registry](https://github.com/horizontal42/summarum/blob/main/src/engine/registry.ts): `src/engine/registry.ts`
- [Bilingual vocabulary](https://github.com/horizontal42/summarum/blob/main/src/engine/vocab.ts): `src/engine/vocab.ts`
- [Vocabulary data](https://github.com/horizontal42/summarum/blob/main/src/engine/vocab-data.ts): `src/engine/vocab-data.ts`
- [Unit definitions](https://github.com/horizontal42/summarum/blob/main/src/engine/unitdata.ts): `src/engine/unitdata.ts`
- [Extra units](https://github.com/horizontal42/summarum/blob/main/src/engine/extraunits.ts): `src/engine/extraunits.ts`
- [Expression parser](https://github.com/horizontal42/summarum/blob/main/src/engine/parser.ts): `src/engine/parser.ts`
- [Value evaluator](https://github.com/horizontal42/summarum/blob/main/src/engine/evaluator.ts): `src/engine/evaluator.ts`
- [Date and time](https://github.com/horizontal42/summarum/blob/main/src/engine/datetime.ts): `src/engine/datetime.ts`
- [Result formatter](https://github.com/horizontal42/summarum/blob/main/src/engine/formatter.ts): `src/engine/formatter.ts`

### Data and integrations

- [Sheet storage](https://github.com/horizontal42/summarum/blob/main/src/storage.ts): `src/storage.ts`
- [Extensions API](https://github.com/horizontal42/summarum/blob/main/src/extensions.ts): `src/extensions.ts`
- [Interface translations](https://github.com/horizontal42/summarum/blob/main/src/i18n.ts): `src/i18n.ts`
- [App updater](https://github.com/horizontal42/summarum/blob/main/src/updater.ts): `src/updater.ts`

### Desktop runtime

- [Tauri runtime](https://github.com/horizontal42/summarum/blob/main/src-tauri/src/main.rs): `src-tauri/src/main.rs`

### Other components

- **User**
- **Rates and markets**

## Connections

- User → App coordinator: uses (evidence: `README.md`)
- App coordinator → Sheet editor: creates (evidence: `src/main.ts`)
- Sheet editor → Engine facade: evaluates text (evidence: `src/ui/editor.ts`)
- Sheet editor → Sparklines: renders (evidence: `src/ui/editor.ts`)
- App coordinator → Sheet workspace: manages sheets (evidence: `src/main.ts`)
- Sheet workspace → Engine facade: evaluates sheets (evidence: `src/workspace.ts`)
- App coordinator → Sheet search: opens search (evidence: `src/main.ts`)
- Sheet search → Sheet workspace: searches sheets (evidence: `src/ui/search.ts`)
- Sheet search → Engine facade: matches results (evidence: `src/ui/search.ts`)
- App coordinator → Image export: exports sheets (evidence: `src/main.ts`)
- Image export → Sheet storage: reads sheet data (evidence: `src/ui/export.ts`)
- App coordinator → Sheet storage: loads and saves (evidence: `src/main.ts`)
- App coordinator → Extensions API: loads extensions (evidence: `src/main.ts`)
- Extensions API → Engine facade: registers additions (evidence: `src/extensions.ts`)
- App coordinator → Interface translations: translates interface (evidence: `src/main.ts`)
- App coordinator → App updater: checks updates (evidence: `src/main.ts`)
- Engine facade → Phrase tokenizer: tokenizes lines (evidence: `src/engine/index.ts`)
- Phrase tokenizer → Text lexer: lexes text (evidence: `src/engine/tokenizer.ts`)
- Phrase tokenizer → Phrase registry: looks up phrases (evidence: `src/engine/tokenizer.ts`)
- Engine facade → Phrase registry: builds registry (evidence: `src/engine/index.ts`)
- Phrase registry → Bilingual vocabulary: loads vocabulary (evidence: `src/engine/registry.ts`)
- Bilingual vocabulary → Vocabulary data: reads definitions (evidence: `src/engine/vocab.ts`)
- Phrase registry → Unit definitions: loads units (evidence: `src/engine/registry.ts`)
- Phrase registry → Extra units: loads extra units (evidence: `src/engine/registry.ts`)
- Engine facade → Expression parser: parses lines (evidence: `src/engine/index.ts`)
- Expression parser → Phrase tokenizer: consumes tokens (evidence: `src/engine/parser.ts`)
- Expression parser → Phrase registry: uses phrase types (evidence: `src/engine/parser.ts`)
- Engine facade → Value evaluator: evaluates expressions (evidence: `src/engine/index.ts`)
- Value evaluator → Date and time: resolves dates (evidence: `src/engine/evaluator.ts`)
- Engine facade → Result formatter: formats results (evidence: `src/engine/index.ts`)
- Sheet storage → Tauri runtime: invokes commands
- App coordinator → Sheet storage: fetches live data (evidence: `src/main.ts`)
- Sheet storage → Rates and markets: requests rates and prices (evidence: `README.md`)
- Tauri runtime → Rates and markets: fetches external data (evidence: `README.md`)
