# ethan-heo/generate-design-token architecture

> Architecture diagram of the GitHub repository ethan-heo/generate-design-token, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ethan-heo/generate-design-token
- Repository: https://github.com/ethan-heo/generate-design-token

## Overview

##### Main Components

a) Core Processing Components:
- Token Parser
- Token Generator
- Token Transformer
- Token Validator

b) Input/Output Components:
- Input Token Definitions (JSON)
- Template Engine (EJS)
- Output Generators (File/String)

c) Support Systems:
- Helper Functions
- Type System
- Validation Rules

**┌─ Input Layer ─────────────────────┐**
- JSON Token Definitions          │
- EJS Templates                   │
- ┬───────────────────┘
- ↓
**┌─ Core Processing Layer ───────────┐**
- ┌─ Parser ─────┐  ┌─ Validator ─┐ │
- Parse      │→ │ - Format    │ │
- Tokenize   │  │ - Duplicate │ │
- ┘  └─────────────┘ │
- ↓                ↓        │
- ┌─ Transformer ─┐  ┌─ Generator ┐ │
- Case 1-4   │←→│ - Content  │ │
- References │  │ - File     │ │
- ┘  └─────────────┘ │
- ┬───────────────────┘
- ↓
**┌─ Output Layer ────────────────────┐**
- Generated Files                 │
- Generated Strings               │
- ┘

##### Important Relationships

- Flow from input JSON through the processing pipeline to output

##### Additional Elements

A separate panel showing:
- Supported token types
- Template helpers
- Transform cases (1-4 as described in README)
- File format support

##### Technical Details

- EJS template integration
- Token reference resolution
- Transformation patterns
- Validation rules
- Output format options

##### Implementation Notes

- Use standardized UML notation where appropriate
- Notes for key configuration options
- Error handling paths

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Input
        JSON[JSON Token Definitions]
        TEMP[EJS Templates]
    end

    subgraph Core
        subgraph Parser
            PARS["Token Parser"]:::parser
            PARS_PROC["Parse & Tokenize"]:::process
        end

        subgraph Validator
            VAL["Token Validator"]:::validator
            VAL_FMT["Format Check"]:::process
            VAL_DUP["Duplicate Check"]:::process
        end

        subgraph Transformer
            TRANS["Token Transformer"]:::transformer
            TRANS_CASE["Transform Cases"]:::process
            TRANS_REF["Reference Resolution"]:::process
        end

        subgraph Generator
            GEN["Token Generator"]:::generator
            GEN_CONT["Content Generation"]:::process
            GEN_FILE["File Generation"]:::process
        end
    end

    subgraph Support
        HELP["Helper Functions"]:::support
        TYPE["Type System"]:::support
        REF["Token Reference Resolution"]:::support
    end

    subgraph Output
        OUT_FILE["Generated Files"]
        OUT_STR["Generated Strings"]
    end

    %% Connections
    JSON --> PARS
    TEMP --> GEN
    PARS --> PARS_PROC
    PARS_PROC --> VAL
    VAL --> VAL_FMT
    VAL --> VAL_DUP
    VAL_FMT --> TRANS
    VAL_DUP --> TRANS
    TRANS --> TRANS_CASE
    TRANS --> TRANS_REF
    TRANS_CASE --> GEN
    TRANS_REF --> GEN
    GEN --> GEN_CONT
    GEN --> GEN_FILE
    GEN_CONT --> OUT_STR
    GEN_FILE --> OUT_FILE
    
    %% Support System Connections
    HELP -.-> PARS
    HELP -.-> TRANS
    HELP -.-> GEN
    TYPE -.-> VAL
    TYPE -.-> TRANS
    REF -.-> TRANS_REF

    %% Styling
    classDef parser fill:#a8d5ff
    classDef validator fill:#ffe7a8
    classDef transformer fill:#a8ffd5
    classDef generator fill:#ffa8d5
    classDef process fill:#f5f5f5
    classDef support fill:#e0e0e0

    %% Click Events
    click PARS "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/modules/parse.ts"
    click GEN "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/modules/generate.ts"
    click TRANS "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/modules/transform.ts"
    click VAL "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/modules/validate.ts"
    click VAL_FMT "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/utils/validate/format.ts"
    click VAL_DUP "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/utils/validate/duplicate.ts"
    click JSON "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/_mocks/base.tokens.json"
    click OUT_FILE "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/_mocks/generated.tokens.json"
    click TYPE "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/types/token.types.ts"
    click HELP "https://github.com/ethan-heo/generate-design-token/tree/master/packages/generate-design-token/src/utils"
    click REF "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/modules/find-referred-token.ts"
    click TRANS_REF "https://github.com/ethan-heo/generate-design-token/blob/master/packages/generate-design-token/src/utils/token-ref.ts"
```
