How vcgtz/monstrjs works
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: generator.ts Generator · index.ts Sprite Selection · Monster.ts Monster Facade · grid.ts Grid & Symmetry
Components 19
User Interfaces
- CLI
src/cli.ts - Library API
src/index.ts - Monster Facade
src/monster/Monster.ts
Generation
- Text Hash
src/core/hash.ts - Seeded PRNG
src/core/prng.ts - Generator
src/core/generator.ts - Color Palettes
src/monster/features.ts - Grid & Symmetry
src/monster/grid.ts
Sprite Art
- Sprite Selection
src/sprites/index.ts - Body Sprites
src/sprites/bodies.ts - Face Sprites
src/sprites/faces.ts - Accessories
src/sprites/accessories.ts - Sprite Composer
src/sprites/composer.ts - Sprite Definitions
src/sprites/types.ts
Rendering & Data
- Terminal Renderer
src/render/terminal.ts - PNG Renderer
src/render/png.ts - Monster Export
src/format/exporter.ts - Monster Import
src/format/importer.ts - Data Types
src/types/index.ts
Connections 23
- CLI → Monster Facade: uses
src/cli.ts - Library API → Monster Facade: delegates
src/index.ts - Monster Facade → Generator: generates
src/monster/Monster.ts - Generator → Text Hash: hashes text
src/core/generator.ts - Generator → Seeded PRNG: seeds
src/core/generator.ts - Generator → Color Palettes: selects palette
src/core/generator.ts - Generator → Sprite Selection: generates sprites
src/core/generator.ts - Generator → Grid & Symmetry: creates symmetry
src/core/generator.ts - Sprite Selection → Seeded PRNG: selects parts
src/sprites/index.ts - Sprite Selection → Body Sprites: selects body
src/sprites/index.ts - Sprite Selection → Face Sprites: selects features
src/sprites/index.ts - Sprite Selection → Accessories: selects parts
src/sprites/index.ts - Sprite Selection → Sprite Composer: composes
src/sprites/index.ts - Sprite Composer → Grid & Symmetry: writes pixels
src/sprites/composer.ts - Monster Facade → Terminal Renderer: renders text
src/monster/Monster.ts - Monster Facade → PNG Renderer: renders PNG
src/monster/Monster.ts - Monster Facade → Monster Export: exports data
src/monster/Monster.ts - Monster Facade → Monster Import: imports data
src/monster/Monster.ts - Monster Export → Grid & Symmetry: encodes grid
src/format/exporter.ts - Monster Import → Grid & Symmetry: decodes grid
src/format/importer.ts - Monster Import → Terminal Renderer: parses colors
src/format/importer.ts - Generator → Data Types: uses types
src/core/generator.ts - Sprite Selection → Sprite Definitions: uses definitions
src/sprites/index.ts