# rei1024/apgm architecture

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

- Interactive diagram: https://gitdiagram.com/rei1024/apgm
- Repository: https://github.com/rei1024/apgm

## Overview

##### Main Components Identification

The system should be divided into these major components:
- Parser System (src/apgm/parser)
- Macro System (src/apgm/macro)
- APGM to APGL Transpiler (src/apgm_to_apgl)
- APGL Optimizer System (src/apgl)
- APGL to APGsembly Transpiler (src/apgl_to_apgsembly)
- Monaco Editor Integration (dist/apgm_monaco)

##### Detailed Component Breakdown

Create nested components showing:

a) Parser System:
- Completion Parser
- Number Parser
- String Parser
- Core Parser Components

b) Macro System:
- Macro Expander
- Difference Calculator
- Duplicates Handler

c) APGL Optimizer System:
- Action Optimizer
- If Optimizer
- Sequence Optimizer

##### Integration Points

Integration with:
- Monaco Editor components
- Test infrastructure
- Documentation system

**[Input: APGM Code] → [Parser System] → [AST (APGM + Macro)] → [Macro Expander] →**
**[Pure APGM AST] → [APGM to APGL Transpiler] → [APGL AST] → [Optimizer System] →**
**[Optimized APGL] → [APGL to APGsembly Transpiler] → [Output: APGsembly Code]**

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Input
        APGM[APGM Source Code]
    end

    subgraph "Parser System"
        Parser["Parser System"]:::parser
        CompParser["Completion Parser"]:::parser
        NumParser["Number Parser"]:::parser
        StrParser["String Parser"]:::parser
        Parser --> CompParser
        Parser --> NumParser
        Parser --> StrParser
    end

    subgraph "Macro System"
        MacroExp["Macro Expander"]:::macro
        DiffCalc["Difference Calculator"]:::macro
        DupHandler["Duplicates Handler"]:::macro
        MacroExp --> DiffCalc
        MacroExp --> DupHandler
    end

    subgraph "APGM to APGL"
        APGMTranspiler["APGM to APGL Transpiler"]:::transpiler
    end

    subgraph "Optimizer System"
        ActionOpt["Action Optimizer"]:::optimizer
        IfOpt["If Optimizer"]:::optimizer
        SeqOpt["Sequence Optimizer"]:::optimizer
    end

    subgraph "APGL to APGsembly"
        APGLTranspiler["APGL to APGsembly Transpiler"]:::transpiler
    end

    subgraph "Monaco Editor Integration"
        MonacoCore["Core Functionality"]:::editor
        CompProvider["Completion Provider"]:::editor
        HoverProvider["Hover Provider"]:::editor
        LangConfig["Language Configuration"]:::editor
        TokenProvider["Token Provider"]:::editor
        MonacoCore --> CompProvider
        MonacoCore --> HoverProvider
        MonacoCore --> LangConfig
        MonacoCore --> TokenProvider
    end

    APGM --> Parser
    Parser --> MacroExp
    MacroExp --> APGMTranspiler
    APGMTranspiler --> ActionOpt
    ActionOpt --> IfOpt
    IfOpt --> SeqOpt
    SeqOpt --> APGLTranspiler
    APGLTranspiler --> APGsembly[APGsembly Code]

    MonacoCore -.-> Parser
    
    %% Component Mappings
    click Parser "https://github.com/rei1024/apgm/tree/main/src/apgm/parser"
    click CompParser "https://github.com/rei1024/apgm/blob/main/src/apgm/parser/completion_parser.ts"
    click NumParser "https://github.com/rei1024/apgm/blob/main/src/apgm/parser/lib/number.ts"
    click StrParser "https://github.com/rei1024/apgm/blob/main/src/apgm/parser/lib/string.ts"
    click MacroExp "https://github.com/rei1024/apgm/blob/main/src/apgm/macro/expander.ts"
    click DiffCalc "https://github.com/rei1024/apgm/blob/main/src/apgm/macro/_diff.ts"
    click DupHandler "https://github.com/rei1024/apgm/blob/main/src/apgm/macro/_dups.ts"
    click APGMTranspiler "https://github.com/rei1024/apgm/blob/main/src/apgm_to_apgl/transpiler.ts"
    click ActionOpt "https://github.com/rei1024/apgm/blob/main/src/apgl/action_optimizer/mod.ts"
    click IfOpt "https://github.com/rei1024/apgm/blob/main/src/apgl/if_optimizer/mod.ts"
    click SeqOpt "https://github.com/rei1024/apgm/blob/main/src/apgl/seq_optimizer/mod.ts"
    click APGLTranspiler "https://github.com/rei1024/apgm/blob/main/src/apgl_to_apgsembly/transpiler.ts"
    click MonacoCore "https://github.com/rei1024/apgm/blob/main/dist/apgm_monaco/core.js"
    click CompProvider "https://github.com/rei1024/apgm/blob/main/dist/apgm_monaco/completionItemProvider.js"
    click HoverProvider "https://github.com/rei1024/apgm/blob/main/dist/apgm_monaco/hoverProvider.js"
    click LangConfig "https://github.com/rei1024/apgm/blob/main/dist/apgm_monaco/languageConfiguration.js"
    click TokenProvider "https://github.com/rei1024/apgm/blob/main/dist/apgm_monaco/monarchTokensProvider.js"

    classDef parser fill:#2196F3,stroke:#1565C0,color:white
    classDef macro fill:#4CAF50,stroke:#2E7D32,color:white
    classDef transpiler fill:#FF9800,stroke:#EF6C00,color:white
    classDef optimizer fill:#FFC107,stroke:#FFA000,color:black
    classDef editor fill:#9C27B0,stroke:#6A1B9A,color:white

    %% Legend
    subgraph Legend
        L1["Parser Components"]:::parser
        L2["Macro Components"]:::macro
        L3["Transpiler Components"]:::transpiler
        L4["Optimizer Components"]:::optimizer
        L5["Editor Components"]:::editor
    end
```
