# qvarcy/latne architecture

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

## Overview

LatNe is an early-stage Latvian-first programming language. Its current user-to-result workflow takes a `.lat` source file through a terminology-backed Unicode lexer, declaration and statement parsing, and a separate expression parser to produce a structured AST. The terminology editor is a distinct working capability that reads the canonical registry and can submit edits for persistence. The compiler and CLI are not yet implemented; later compilation and execution steps are documented goals, not current runtime connections. Relationships reflect README documentation and shown source; future links are dashed where implementation is absent.

Main entry points: [`packages/valoda/src/sintaktiskais-analizators.mjs`](https://github.com/qvarcy/latne/blob/main/packages/valoda/src/sintaktiskais-analizators.mjs) (Declarations and statements), [`tools/vardu-kalve/src/main.ts`](https://github.com/qvarcy/latne/blob/main/tools/vardu-kalve/src/main.ts) (Vārdu kalve editor), [`packages/valoda/src/leksiskais-analizators.mjs`](https://github.com/qvarcy/latne/blob/main/packages/valoda/src/leksiskais-analizators.mjs) (Unicode lexer), [`packages/valoda/data/termini.json`](https://github.com/qvarcy/latne/blob/main/packages/valoda/data/termini.json) (Term registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_language["Language core"]
  node_lat_source["&#96;.lat&#96; source<br/>[pamata-paraugs.lat]"]
  node_lexer["Unicode lexer"]
  node_syntax["Declarations and statements"]
  node_expression["Expression parser"]
  node_ast["Structured AST"]
end

subgraph group_terminology["Terminology"]
  node_registry[("Term registry<br/>[termini.json]")]
end

subgraph group_compile["Future execution"]
  node_semantics["Semantic transforms"]
  node_codegen["Code generator"]
  node_javascript["JavaScript output"]
  node_execution["Program execution"]
end

subgraph group_tools["Developer tools"]
  node_wordforge["Vārdu kalve editor<br/>[main.ts]"]
  node_terminology_api["Terminology save API<br/>[vite.config.ts]"]
  node_cli["LatNe CLI<br/>[index.ts]"]
end

node_programmer(("Programmer"))

node_programmer -->|"writes"| node_lat_source
node_lat_source -->|"lexes"| node_lexer
node_registry -->|"supplies terms"| node_lexer
node_lexer -->|"parses tokens"| node_syntax
node_syntax -->|"delegates expressions"| node_expression
node_syntax -->|"builds"| node_ast
node_expression -->|"builds expressions"| node_ast
node_programmer -->|"edits terms"| node_wordforge
node_wordforge -->|"loads"| node_registry
node_wordforge -->|"posts changes"| node_terminology_api
node_terminology_api -->|"validates and writes"| node_registry
node_ast -.->|"feeds future transforms"| node_semantics
node_semantics -.->|"transforms"| node_codegen
node_codegen -.->|"generates"| node_javascript
node_javascript -.->|"runs"| node_execution
node_execution -.->|"invoked through"| node_cli

click node_lat_source "https://github.com/qvarcy/latne/blob/main/examples/pamata-paraugs.lat"
click node_registry "https://github.com/qvarcy/latne/blob/main/packages/valoda/data/termini.json"
click node_lexer "https://github.com/qvarcy/latne/blob/main/packages/valoda/src/leksiskais-analizators.mjs"
click node_syntax "https://github.com/qvarcy/latne/blob/main/packages/valoda/src/sintaktiskais-analizators.mjs"
click node_expression "https://github.com/qvarcy/latne/blob/main/packages/valoda/src/izteiksmju-sintaktiskais-analizators.mjs"
click node_ast "https://github.com/qvarcy/latne/blob/main/packages/valoda/src/sintaktiskais-analizators.mjs"
click node_wordforge "https://github.com/qvarcy/latne/blob/main/tools/vardu-kalve/src/main.ts"
click node_terminology_api "https://github.com/qvarcy/latne/blob/main/tools/vardu-kalve/vite.config.ts"
click node_semantics "https://github.com/qvarcy/latne/tree/main/packages/kompilators/src"
click node_codegen "https://github.com/qvarcy/latne/tree/main/packages/kompilators/src"
click node_cli "https://github.com/qvarcy/latne/blob/main/packages/komandrinda/src/index.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_lat_source,node_lexer,node_syntax,node_expression,node_ast toneBlue
class node_registry toneAmber
class node_semantics,node_codegen,node_javascript,node_execution toneMint
class node_wordforge,node_terminology_api,node_cli toneRose
class node_programmer toneIndigo
```

## Components

### Language core

- [`.lat` source](https://github.com/qvarcy/latne/blob/main/examples/pamata-paraugs.lat): `examples/pamata-paraugs.lat`
- [Unicode lexer](https://github.com/qvarcy/latne/blob/main/packages/valoda/src/leksiskais-analizators.mjs): `packages/valoda/src/leksiskais-analizators.mjs`
- [Declarations and statements](https://github.com/qvarcy/latne/blob/main/packages/valoda/src/sintaktiskais-analizators.mjs): `packages/valoda/src/sintaktiskais-analizators.mjs`
- [Expression parser](https://github.com/qvarcy/latne/blob/main/packages/valoda/src/izteiksmju-sintaktiskais-analizators.mjs): `packages/valoda/src/izteiksmju-sintaktiskais-analizators.mjs`
- [Structured AST](https://github.com/qvarcy/latne/blob/main/packages/valoda/src/sintaktiskais-analizators.mjs): `packages/valoda/src/sintaktiskais-analizators.mjs`

### Terminology

- [Term registry](https://github.com/qvarcy/latne/blob/main/packages/valoda/data/termini.json): `packages/valoda/data/termini.json`

### Future execution

- [Semantic transforms](https://github.com/qvarcy/latne/tree/main/packages/kompilators/src): `packages/kompilators/src`
- [Code generator](https://github.com/qvarcy/latne/tree/main/packages/kompilators/src): `packages/kompilators/src`
- **JavaScript output**
- **Program execution**

### Developer tools

- [Vārdu kalve editor](https://github.com/qvarcy/latne/blob/main/tools/vardu-kalve/src/main.ts): `tools/vardu-kalve/src/main.ts`
- [Terminology save API](https://github.com/qvarcy/latne/blob/main/tools/vardu-kalve/vite.config.ts): `tools/vardu-kalve/vite.config.ts`
- [LatNe CLI](https://github.com/qvarcy/latne/blob/main/packages/komandrinda/src/index.ts): `packages/komandrinda/src/index.ts`

### Other components

- **Programmer**

## Connections

- Programmer → `.lat` source: writes (evidence: `README.md`)
- `.lat` source → Unicode lexer: lexes (evidence: `README.md`)
- Term registry → Unicode lexer: supplies terms (evidence: `README.md`)
- Unicode lexer → Declarations and statements: parses tokens (evidence: `README.md`)
- Declarations and statements → Expression parser: delegates expressions (evidence: `packages/valoda/src/sintaktiskais-analizators.mjs`)
- Declarations and statements → Structured AST: builds (evidence: `README.md`)
- Expression parser → Structured AST: builds expressions (evidence: `README.md`)
- Programmer → Vārdu kalve editor: edits terms (evidence: `README.md`)
- Vārdu kalve editor → Term registry: loads (evidence: `tools/vardu-kalve/src/main.ts`)
- Vārdu kalve editor → Terminology save API: posts changes (evidence: `tools/vardu-kalve/src/main.ts`)
- Terminology save API → Term registry: validates and writes (evidence: `tools/vardu-kalve/vite.config.ts`)
- Structured AST → Semantic transforms: feeds future transforms (evidence: `README.md`)
- Semantic transforms → Code generator: transforms (evidence: `README.md`)
- Code generator → JavaScript output: generates (evidence: `README.md`)
- JavaScript output → Program execution: runs (evidence: `README.md`)
- Program execution → LatNe CLI: invoked through (evidence: `README.md`)
