# vcgtz/monstrjs architecture

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

- Interactive diagram: https://gitdiagram.com/vcgtz/monstrjs
- Repository: https://github.com/vcgtz/monstrjs

## Overview

MonstrJS is a TypeScript library and CLI for deterministic text-to-pixel-monster generation. The main workflow runs from CLI or library entry through the Monster facade into seeded generation: hashing and PRNG drive palette and sprite selection, composition builds a 64×64 grid, and optional symmetry transforms it. The resulting monster can be printed, rendered as PNG, or exported/imported as .monstr data. Sprite and palette capabilities are represented from README and indexed source references; unsampled implementation details are not expanded. Edges reflect explicit calls, imports, or documented behavior.

Main entry points: [`src/core/generator.ts`](https://github.com/vcgtz/monstrjs/blob/main/src/core/generator.ts) (Generator), [`src/sprites/index.ts`](https://github.com/vcgtz/monstrjs/blob/main/src/sprites/index.ts) (Sprite Selection), [`src/monster/Monster.ts`](https://github.com/vcgtz/monstrjs/blob/main/src/monster/Monster.ts) (Monster Facade), [`src/monster/grid.ts`](https://github.com/vcgtz/monstrjs/blob/main/src/monster/grid.ts) (Grid & Symmetry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User Interfaces"]
  node_cli["CLI<br/>[cli.ts]"]
  node_library["Library API<br/>[index.ts]"]
  node_monster["Monster Facade<br/>[Monster.ts]"]
end

subgraph group_generation["Generation"]
  node_hash["Text Hash<br/>[hash.ts]"]
  node_prng["Seeded PRNG<br/>[prng.ts]"]
  node_generator["Generator<br/>[generator.ts]"]
  node_palettes["Color Palettes<br/>[features.ts]"]
  node_grid["Grid &amp; Symmetry<br/>[grid.ts]"]
end

subgraph group_spriteart["Sprite Art"]
  node_sprite_selection["Sprite Selection<br/>[index.ts]"]
  node_bodies["Body Sprites<br/>[bodies.ts]"]
  node_faces["Face Sprites<br/>[faces.ts]"]
  node_accessories["Accessories<br/>[accessories.ts]"]
  node_composer["Sprite Composer<br/>[composer.ts]"]
  node_sprite_types["Sprite Definitions<br/>[types.ts]"]
end

subgraph group_outputs["Rendering &amp; Data"]
  node_terminal["Terminal Renderer<br/>[terminal.ts]"]
  node_png["PNG Renderer<br/>[png.ts]"]
  node_exporter["Monster Export<br/>[exporter.ts]"]
  node_importer["Monster Import<br/>[importer.ts]"]
  node_types["Data Types<br/>[index.ts]"]
end

node_cli -->|"uses"| node_monster
node_library -->|"delegates"| node_monster
node_monster -->|"generates"| node_generator
node_generator -->|"hashes text"| node_hash
node_generator -->|"seeds"| node_prng
node_generator -->|"selects palette"| node_palettes
node_generator -->|"generates sprites"| node_sprite_selection
node_generator -->|"creates symmetry"| node_grid
node_sprite_selection -->|"selects parts"| node_prng
node_sprite_selection -->|"selects body"| node_bodies
node_sprite_selection -->|"selects features"| node_faces
node_sprite_selection -->|"selects parts"| node_accessories
node_sprite_selection -->|"composes"| node_composer
node_composer -->|"writes pixels"| node_grid
node_monster -->|"renders text"| node_terminal
node_monster -->|"renders PNG"| node_png
node_monster -->|"exports data"| node_exporter
node_monster -->|"imports data"| node_importer
node_exporter -->|"encodes grid"| node_grid
node_importer -->|"decodes grid"| node_grid
node_importer -->|"parses colors"| node_terminal
node_generator -->|"uses types"| node_types
node_sprite_selection -->|"uses definitions"| node_sprite_types

click node_cli "https://github.com/vcgtz/monstrjs/blob/main/src/cli.ts"
click node_library "https://github.com/vcgtz/monstrjs/blob/main/src/index.ts"
click node_monster "https://github.com/vcgtz/monstrjs/blob/main/src/monster/Monster.ts"
click node_hash "https://github.com/vcgtz/monstrjs/blob/main/src/core/hash.ts"
click node_prng "https://github.com/vcgtz/monstrjs/blob/main/src/core/prng.ts"
click node_generator "https://github.com/vcgtz/monstrjs/blob/main/src/core/generator.ts"
click node_palettes "https://github.com/vcgtz/monstrjs/blob/main/src/monster/features.ts"
click node_grid "https://github.com/vcgtz/monstrjs/blob/main/src/monster/grid.ts"
click node_sprite_selection "https://github.com/vcgtz/monstrjs/blob/main/src/sprites/index.ts"
click node_bodies "https://github.com/vcgtz/monstrjs/blob/main/src/sprites/bodies.ts"
click node_faces "https://github.com/vcgtz/monstrjs/blob/main/src/sprites/faces.ts"
click node_accessories "https://github.com/vcgtz/monstrjs/blob/main/src/sprites/accessories.ts"
click node_composer "https://github.com/vcgtz/monstrjs/blob/main/src/sprites/composer.ts"
click node_sprite_types "https://github.com/vcgtz/monstrjs/blob/main/src/sprites/types.ts"
click node_terminal "https://github.com/vcgtz/monstrjs/blob/main/src/render/terminal.ts"
click node_png "https://github.com/vcgtz/monstrjs/blob/main/src/render/png.ts"
click node_exporter "https://github.com/vcgtz/monstrjs/blob/main/src/format/exporter.ts"
click node_importer "https://github.com/vcgtz/monstrjs/blob/main/src/format/importer.ts"
click node_types "https://github.com/vcgtz/monstrjs/blob/main/src/types/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_cli,node_library,node_monster toneBlue
class node_hash,node_prng,node_generator,node_palettes,node_grid toneAmber
class node_sprite_selection,node_bodies,node_faces,node_accessories,node_composer,node_sprite_types toneMint
class node_terminal,node_png,node_exporter,node_importer,node_types toneRose
```

## Components

### User Interfaces

- [CLI](https://github.com/vcgtz/monstrjs/blob/main/src/cli.ts): `src/cli.ts`
- [Library API](https://github.com/vcgtz/monstrjs/blob/main/src/index.ts): `src/index.ts`
- [Monster Facade](https://github.com/vcgtz/monstrjs/blob/main/src/monster/Monster.ts): `src/monster/Monster.ts`

### Generation

- [Text Hash](https://github.com/vcgtz/monstrjs/blob/main/src/core/hash.ts): `src/core/hash.ts`
- [Seeded PRNG](https://github.com/vcgtz/monstrjs/blob/main/src/core/prng.ts): `src/core/prng.ts`
- [Generator](https://github.com/vcgtz/monstrjs/blob/main/src/core/generator.ts): `src/core/generator.ts`
- [Color Palettes](https://github.com/vcgtz/monstrjs/blob/main/src/monster/features.ts): `src/monster/features.ts`
- [Grid & Symmetry](https://github.com/vcgtz/monstrjs/blob/main/src/monster/grid.ts): `src/monster/grid.ts`

### Sprite Art

- [Sprite Selection](https://github.com/vcgtz/monstrjs/blob/main/src/sprites/index.ts): `src/sprites/index.ts`
- [Body Sprites](https://github.com/vcgtz/monstrjs/blob/main/src/sprites/bodies.ts): `src/sprites/bodies.ts`
- [Face Sprites](https://github.com/vcgtz/monstrjs/blob/main/src/sprites/faces.ts): `src/sprites/faces.ts`
- [Accessories](https://github.com/vcgtz/monstrjs/blob/main/src/sprites/accessories.ts): `src/sprites/accessories.ts`
- [Sprite Composer](https://github.com/vcgtz/monstrjs/blob/main/src/sprites/composer.ts): `src/sprites/composer.ts`
- [Sprite Definitions](https://github.com/vcgtz/monstrjs/blob/main/src/sprites/types.ts): `src/sprites/types.ts`

### Rendering & Data

- [Terminal Renderer](https://github.com/vcgtz/monstrjs/blob/main/src/render/terminal.ts): `src/render/terminal.ts`
- [PNG Renderer](https://github.com/vcgtz/monstrjs/blob/main/src/render/png.ts): `src/render/png.ts`
- [Monster Export](https://github.com/vcgtz/monstrjs/blob/main/src/format/exporter.ts): `src/format/exporter.ts`
- [Monster Import](https://github.com/vcgtz/monstrjs/blob/main/src/format/importer.ts): `src/format/importer.ts`
- [Data Types](https://github.com/vcgtz/monstrjs/blob/main/src/types/index.ts): `src/types/index.ts`

## Connections

- CLI → Monster Facade: uses (evidence: `src/cli.ts`)
- Library API → Monster Facade: delegates (evidence: `src/index.ts`)
- Monster Facade → Generator: generates (evidence: `src/monster/Monster.ts`)
- Generator → Text Hash: hashes text (evidence: `src/core/generator.ts`)
- Generator → Seeded PRNG: seeds (evidence: `src/core/generator.ts`)
- Generator → Color Palettes: selects palette (evidence: `src/core/generator.ts`)
- Generator → Sprite Selection: generates sprites (evidence: `src/core/generator.ts`)
- Generator → Grid & Symmetry: creates symmetry (evidence: `src/core/generator.ts`)
- Sprite Selection → Seeded PRNG: selects parts (evidence: `src/sprites/index.ts`)
- Sprite Selection → Body Sprites: selects body (evidence: `src/sprites/index.ts`)
- Sprite Selection → Face Sprites: selects features (evidence: `src/sprites/index.ts`)
- Sprite Selection → Accessories: selects parts (evidence: `src/sprites/index.ts`)
- Sprite Selection → Sprite Composer: composes (evidence: `src/sprites/index.ts`)
- Sprite Composer → Grid & Symmetry: writes pixels (evidence: `src/sprites/composer.ts`)
- Monster Facade → Terminal Renderer: renders text (evidence: `src/monster/Monster.ts`)
- Monster Facade → PNG Renderer: renders PNG (evidence: `src/monster/Monster.ts`)
- Monster Facade → Monster Export: exports data (evidence: `src/monster/Monster.ts`)
- Monster Facade → Monster Import: imports data (evidence: `src/monster/Monster.ts`)
- Monster Export → Grid & Symmetry: encodes grid (evidence: `src/format/exporter.ts`)
- Monster Import → Grid & Symmetry: decodes grid (evidence: `src/format/importer.ts`)
- Monster Import → Terminal Renderer: parses colors (evidence: `src/format/importer.ts`)
- Generator → Data Types: uses types (evidence: `src/core/generator.ts`)
- Sprite Selection → Sprite Definitions: uses definitions (evidence: `src/sprites/index.ts`)
