# adlerzz/plex architecture

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

- Interactive diagram: https://gitdiagram.com/adlerzz/plex
- Repository: https://github.com/adlerzz/plex

## Overview

Plex is a small grammar-driven language toolkit: one entry point tokenizes text, another builds a parser action table from grammar rules, and a third interprets that table against tokens to produce output text. These are separate command-line stages; the excerpts do not show a single orchestrator connecting them. The parser’s state, rule, entity, and snapshot classes support automaton construction. Relationships are limited to calls and data flows visible in the excerpts; the README provides no additional capability details.

Main entry points: [`src/commons/filesys.js`](https://github.com/adlerzz/plex/blob/main/src/commons/filesys.js) (Resource I/O), [`src/prs.main.js`](https://github.com/adlerzz/plex/blob/main/src/prs.main.js) (Automaton builder), [`src/lex.main.js`](https://github.com/adlerzz/plex/blob/main/src/lex.main.js) (Tokenizer), [`src/kon.main.js`](https://github.com/adlerzz/plex/blob/main/src/kon.main.js) (Table interpreter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lex["Lexing"]
  node_lexer["Tokenizer<br/>[lex.main.js]"]
  node_lexrules["Lex rules<br/>[lex.rules.js]"]
  node_tokens["Token output<br/>[lex.output.json]"]
end

subgraph group_parser["Parser generation"]
  node_parsergen["Automaton builder<br/>[prs.main.js]"]
  node_prsrules["Grammar rules<br/>[prs.rules.js]"]
  node_table["Parser table<br/>[prs.output.json]"]
end

subgraph group_runtime["Table interpretation"]
  node_interpreter["Table interpreter<br/>[kon.main.js]"]
  node_output["Generated text<br/>[output.text]"]
end

subgraph group_shared["Parser models"]
  node_entities["Grammar entities<br/>[entity.class.js]"]
  node_rules["Grammar rules model<br/>[rule.class.js]"]
  node_snaps["Rule snapshots<br/>[snap.class.js]"]
  node_states["Automaton states<br/>[state.class.js]"]
  node_bunch["Collection helper<br/>[bunch.class.js]"]
  node_filesys["Resource I/O<br/>[filesys.js]"]
end

node_user(("CLI user"))

node_user -->|"runs"| node_lexer
node_lexer -->|"loads rules"| node_lexrules
node_lexer -->|"reads input"| node_filesys
node_lexer -->|"writes tokens"| node_filesys
node_filesys -->|"writes JSON"| node_tokens
node_user -->|"runs"| node_parsergen
node_parsergen -->|"loads grammar"| node_prsrules
node_parsergen -->|"imports rules"| node_filesys
node_parsergen -->|"writes outputs"| node_filesys
node_filesys -->|"writes JSON"| node_table
node_parsergen -->|"creates entities"| node_entities
node_parsergen -->|"creates rules"| node_rules
node_parsergen -->|"builds snapshots"| node_snaps
node_parsergen -->|"builds states"| node_states
node_parsergen -->|"uses collections"| node_bunch
node_states -->|"stores snapshots"| node_bunch
node_user -->|"runs"| node_interpreter
node_interpreter -->|"reads artifacts"| node_filesys
node_filesys -->|"reads JSON"| node_table
node_filesys -->|"reads JSON"| node_tokens
node_interpreter -->|"imports fold helpers"| node_prsrules
node_interpreter -->|"writes result"| node_filesys
node_filesys -->|"writes text"| node_output

click node_lexer "https://github.com/adlerzz/plex/blob/main/src/lex.main.js"
click node_lexrules "https://github.com/adlerzz/plex/blob/main/resources/lex.rules.js"
click node_tokens "https://github.com/adlerzz/plex/blob/main/resources/lex.output.json"
click node_parsergen "https://github.com/adlerzz/plex/blob/main/src/prs.main.js"
click node_prsrules "https://github.com/adlerzz/plex/blob/main/resources/prs.rules.js"
click node_table "https://github.com/adlerzz/plex/blob/main/resources/prs.output.json"
click node_interpreter "https://github.com/adlerzz/plex/blob/main/src/kon.main.js"
click node_output "https://github.com/adlerzz/plex/blob/main/resources/output.text"
click node_entities "https://github.com/adlerzz/plex/blob/main/src/models/entity.class.js"
click node_rules "https://github.com/adlerzz/plex/blob/main/src/models/rule.class.js"
click node_snaps "https://github.com/adlerzz/plex/blob/main/src/models/snap.class.js"
click node_states "https://github.com/adlerzz/plex/blob/main/src/models/state.class.js"
click node_bunch "https://github.com/adlerzz/plex/blob/main/src/commons/bunch.class.js"
click node_filesys "https://github.com/adlerzz/plex/blob/main/src/commons/filesys.js"

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_lexer,node_lexrules,node_tokens,node_user toneBlue
class node_parsergen,node_prsrules,node_table toneAmber
class node_interpreter,node_output toneMint
class node_entities,node_rules,node_snaps,node_states,node_bunch,node_filesys toneRose
```

## Components

### Lexing

- [Tokenizer](https://github.com/adlerzz/plex/blob/main/src/lex.main.js): `src/lex.main.js`
- [Lex rules](https://github.com/adlerzz/plex/blob/main/resources/lex.rules.js): `resources/lex.rules.js`
- [Token output](https://github.com/adlerzz/plex/blob/main/resources/lex.output.json): `resources/lex.output.json`

### Parser generation

- [Automaton builder](https://github.com/adlerzz/plex/blob/main/src/prs.main.js): `src/prs.main.js`
- [Grammar rules](https://github.com/adlerzz/plex/blob/main/resources/prs.rules.js): `resources/prs.rules.js`
- [Parser table](https://github.com/adlerzz/plex/blob/main/resources/prs.output.json): `resources/prs.output.json`

### Table interpretation

- [Table interpreter](https://github.com/adlerzz/plex/blob/main/src/kon.main.js): `src/kon.main.js`
- [Generated text](https://github.com/adlerzz/plex/blob/main/resources/output.text): `resources/output.text`

### Parser models

- [Grammar entities](https://github.com/adlerzz/plex/blob/main/src/models/entity.class.js): `src/models/entity.class.js`
- [Grammar rules model](https://github.com/adlerzz/plex/blob/main/src/models/rule.class.js): `src/models/rule.class.js`
- [Rule snapshots](https://github.com/adlerzz/plex/blob/main/src/models/snap.class.js): `src/models/snap.class.js`
- [Automaton states](https://github.com/adlerzz/plex/blob/main/src/models/state.class.js): `src/models/state.class.js`
- [Collection helper](https://github.com/adlerzz/plex/blob/main/src/commons/bunch.class.js): `src/commons/bunch.class.js`
- [Resource I/O](https://github.com/adlerzz/plex/blob/main/src/commons/filesys.js): `src/commons/filesys.js`

### Other components

- **CLI user**

## Connections

- CLI user → Tokenizer: runs
- Tokenizer → Lex rules: loads rules (evidence: `src/lex.main.js`)
- Tokenizer → Resource I/O: reads input (evidence: `src/lex.main.js`)
- Tokenizer → Resource I/O: writes tokens (evidence: `src/lex.main.js`)
- Resource I/O → Token output: writes JSON (evidence: `src/commons/filesys.js`)
- CLI user → Automaton builder: runs
- Automaton builder → Grammar rules: loads grammar (evidence: `src/prs.main.js`)
- Automaton builder → Resource I/O: imports rules (evidence: `src/prs.main.js`)
- Automaton builder → Resource I/O: writes outputs (evidence: `src/prs.main.js`)
- Resource I/O → Parser table: writes JSON (evidence: `src/commons/filesys.js`)
- Automaton builder → Grammar entities: creates entities (evidence: `src/prs.main.js`)
- Automaton builder → Grammar rules model: creates rules (evidence: `src/prs.main.js`)
- Automaton builder → Rule snapshots: builds snapshots (evidence: `src/prs.main.js`)
- Automaton builder → Automaton states: builds states (evidence: `src/prs.main.js`)
- Automaton builder → Collection helper: uses collections (evidence: `src/prs.main.js`)
- Automaton states → Collection helper: stores snapshots (evidence: `src/models/state.class.js`)
- CLI user → Table interpreter: runs
- Table interpreter → Resource I/O: reads artifacts (evidence: `src/kon.main.js`)
- Resource I/O → Parser table: reads JSON (evidence: `src/commons/filesys.js`)
- Resource I/O → Token output: reads JSON (evidence: `src/commons/filesys.js`)
- Table interpreter → Grammar rules: imports fold helpers (evidence: `src/kon.main.js`)
- Table interpreter → Resource I/O: writes result (evidence: `src/kon.main.js`)
- Resource I/O → Generated text: writes text (evidence: `src/commons/filesys.js`)
