# bsrwx/psm_kalkulator architecture

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

- Interactive diagram: https://gitdiagram.com/bsrwx/psm_kalkulator
- Repository: https://github.com/bsrwx/psm_kalkulator

## Overview

Kalkulator is an Android calculator built with Jetpack Compose. The user enters expressions through a reusable keyboard; the app evaluates complete expressions in a separate Kotlin engine and displays results or calculation errors. The README also documents landscape scientific functions, adaptive layout, saved state across rotation, and light/dark theming. Source excerpts were not provided, so relationships below rely on README statements; unverified implementation links are omitted or dashed.

Main entry points: [`app/src/main/java/com/example/kalkulator/MainActivity.kt`](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt) (Calculator screen), [`app/src/main/java/com/example/kalkulator/ui/theme/Theme.kt`](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/ui/theme/Theme.kt) (Compose theme), [`app/src/main/java/com/example/kalkulator/CalculatorEngine.kt`](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/CalculatorEngine.kt) (Calculator engine), [`app/src/main/res/values/strings.xml`](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/res/values/strings.xml) (Localized error text)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Calculator UI"]
  node_activity["Calculator screen<br/>[MainActivity.kt]"]
  node_keyboard["Reusable keyboard<br/>[MainActivity.kt]"]
  node_adaptive["Adaptive layout<br/>[MainActivity.kt]"]
  node_scientific["Scientific mode<br/>[MainActivity.kt]"]
  node_savedstate["Saved UI state<br/>[MainActivity.kt]"]
end

subgraph group_calculation["Calculation"]
  node_engine["Calculator engine"]
  node_parser["mXparser"]
end

subgraph group_presentation["Presentation"]
  node_errorstrings["Localized error text<br/>[strings.xml]"]
  node_theme["Compose theme<br/>[Theme.kt]"]
  node_colors["Theme colors<br/>[Color.kt]"]
  node_typography["Theme typography<br/>[Type.kt]"]
  node_translations["UI translations<br/>[strings.xml]"]
end

node_user(("Calculator user"))

node_user -->|"uses"| node_activity
node_activity -->|"renders"| node_keyboard
node_activity -->|"adapts layout"| node_adaptive
node_activity -->|"shows in landscape"| node_scientific
node_activity -->|"preserves state"| node_savedstate
node_activity -.->|"evaluates with"| node_engine
node_engine -->|"parses expressions"| node_parser
node_activity -->|"shows calculation error"| node_errorstrings
node_activity -->|"uses"| node_theme
node_theme -.->|"applies"| node_colors
node_theme -.->|"applies"| node_typography
node_activity -->|"localizes UI"| node_translations

click node_activity "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt"
click node_keyboard "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt"
click node_adaptive "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt"
click node_scientific "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt"
click node_savedstate "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt"
click node_engine "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/CalculatorEngine.kt"
click node_errorstrings "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/res/values/strings.xml"
click node_theme "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/ui/theme/Theme.kt"
click node_colors "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/ui/theme/Color.kt"
click node_typography "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/ui/theme/Type.kt"
click node_translations "https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/res/values-pl/strings.xml"

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_activity,node_keyboard,node_adaptive,node_scientific,node_savedstate,node_user toneBlue
class node_engine,node_parser toneAmber
class node_errorstrings,node_theme,node_colors,node_typography,node_translations toneMint
```

## Components

### Calculator UI

- [Calculator screen](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt): `app/src/main/java/com/example/kalkulator/MainActivity.kt`
- [Reusable keyboard](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt): `app/src/main/java/com/example/kalkulator/MainActivity.kt`
- [Adaptive layout](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt): `app/src/main/java/com/example/kalkulator/MainActivity.kt`
- [Scientific mode](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt): `app/src/main/java/com/example/kalkulator/MainActivity.kt`
- [Saved UI state](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/MainActivity.kt): `app/src/main/java/com/example/kalkulator/MainActivity.kt`

### Calculation

- [Calculator engine](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/CalculatorEngine.kt): `app/src/main/java/com/example/kalkulator/CalculatorEngine.kt`
- **mXparser**

### Presentation

- [Localized error text](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/res/values/strings.xml): `app/src/main/res/values/strings.xml`
- [Compose theme](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/ui/theme/Theme.kt): `app/src/main/java/com/example/kalkulator/ui/theme/Theme.kt`
- [Theme colors](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/ui/theme/Color.kt): `app/src/main/java/com/example/kalkulator/ui/theme/Color.kt`
- [Theme typography](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/java/com/example/kalkulator/ui/theme/Type.kt): `app/src/main/java/com/example/kalkulator/ui/theme/Type.kt`
- [UI translations](https://github.com/bsrwx/psm_kalkulator/blob/main/app/src/main/res/values-pl/strings.xml): `app/src/main/res/values-pl/strings.xml`

### Other components

- **Calculator user**

## Connections

- Calculator user → Calculator screen: uses (evidence: `README.md`)
- Calculator screen → Reusable keyboard: renders (evidence: `README.md`)
- Calculator screen → Adaptive layout: adapts layout (evidence: `README.md`)
- Calculator screen → Scientific mode: shows in landscape (evidence: `README.md`)
- Calculator screen → Saved UI state: preserves state (evidence: `README.md`)
- Calculator screen → Calculator engine: evaluates with
- Calculator engine → mXparser: parses expressions (evidence: `README.md`)
- Calculator screen → Localized error text: shows calculation error (evidence: `README.md`)
- Calculator screen → Compose theme: uses (evidence: `README.md`)
- Compose theme → Theme colors: applies
- Compose theme → Theme typography: applies
- Calculator screen → UI translations: localizes UI (evidence: `README.md`)
