# samualtnorman/wasm architecture

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

- Interactive diagram: https://gitdiagram.com/samualtnorman/wasm
- Repository: https://github.com/samualtnorman/wasm

## Overview

##### Main Components Identification
The project is structured as a monorepo with two main packages:
- Utils Package (WASM Parser/Tokenizer)
- VSCode Extension Package

##### Component Breakdown

A. Core Components Layer:
- [WASM Parser/Tokenizer Core]
- Tokenizer Module
- AST Node Handler
- Parser Module

B. Extension Layer:
- [VSCode Extension]
- Language Configuration
- Syntax Highlighting
- Extension Host

- [WASM Source File] → [Tokenizer] → [Parser] → [AST Generation]
- ↓
- [Syntax Highlighting]
- ↓
- [VSCode Integration]

##### Detailed Component Specifications

For each major component, include:

A. Tokenizer:
- [Tokenizer Module]
- Input: .wat files
- Processing: TokenTag definitions
- Output: Token stream

B. Parser:
- [Parser Module]
- AstNode processing
- Parsing utilities
- String handling

C. VSCode Extension:
- [Extension Module]
- Language configuration
- Syntax highlighting rules
- Extension activation

##### Integration Points

Clear integration points between:
- Tokenizer → VSCode Syntax Highlighting
- Parser → VSCode Language Features
- Source Files ↔ VSCode Editor

##### Technical Details

Annotations for:
- File formats (.wat, .wasm)
- Configuration files (language-configuration.json, wat.tmLanguage.json)
- Build process flow (rollup configuration)

##### Development Flow

**[Source Files] → [Build Process] → [Extension Package] → [VSCode]**

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Core ["Core Processing Layer"]
        direction TB
        Source[".wat Source File"]
        Tokenizer["Tokenizer Module"]:::core
        Parser["Parser Module"]:::core
        AST["AST Node Handler"]:::core
        TokenDefs["Token Definitions"]:::core
        ASTTypes["AST Node Types"]:::core
        ParseUtils["Parsing Utilities"]:::core
        StringUtils["String Parsing"]:::core
        
        Source --> Tokenizer
        Tokenizer --> Parser
        Parser --> AST
        TokenDefs --> Tokenizer
        ASTTypes --> AST
        ParseUtils --> Parser
        StringUtils --> Parser
    end

    subgraph Extension ["VSCode Extension Layer"]
        direction TB
        ExtHost["Extension Host"]:::extension
        LangConfig["Language Configuration"]:::extension
        SyntaxHL["Syntax Highlighting"]:::extension
        
        ExtHost --> LangConfig
        ExtHost --> SyntaxHL
    end

    subgraph Debug ["Debug Utilities"]
        direction TB
        TokenDebug["Token Debug Utils"]:::debug
        ASTDebug["AST Debug Utils"]:::debug
        
        Tokenizer --> TokenDebug
        AST --> ASTDebug
    end

    %% Integration flows
    Tokenizer --> SyntaxHL
    Parser --> ExtHost
    AST --> ExtHost

    %% Click events for component mapping
    click Tokenizer "https://github.com/samualtnorman/wasm/blob/main/packages/utils/src/tokenise.ts"
    click AST "https://github.com/samualtnorman/wasm/blob/main/packages/utils/src/AstNode.ts"
    click Parser "https://github.com/samualtnorman/wasm/blob/main/packages/utils/src/parse.ts"
    click ParseUtils "https://github.com/samualtnorman/wasm/tree/main/packages/utils/src/lib/parsing/"
    click TokenDefs "https://github.com/samualtnorman/wasm/blob/main/packages/utils/src/TokenTag.ts"
    click LangConfig "https://github.com/samualtnorman/wasm/blob/main/packages/vscode-extension/language-configuration.json"
    click SyntaxHL "https://github.com/samualtnorman/wasm/blob/main/packages/vscode-extension/wat.tmLanguage.json"
    click ExtHost "https://github.com/samualtnorman/wasm/blob/main/packages/vscode-extension/src/extension.ts"
    click StringUtils "https://github.com/samualtnorman/wasm/blob/main/packages/utils/src/lib/parsing/string.ts"
    click ASTTypes "https://github.com/samualtnorman/wasm/blob/main/packages/utils/src/AstNodeTag.ts"
    click TokenDebug "https://github.com/samualtnorman/wasm/blob/main/packages/utils/src/tokenToDebugString.ts"
    click ASTDebug "https://github.com/samualtnorman/wasm/blob/main/packages/utils/src/astNodeToDebugString.ts"

    %% Styling
    classDef core fill:#2374ab
    classDef extension fill:#47a025
    classDef debug fill:#a67c00
    
    %% Legend
    subgraph Legend
        direction TB
        L1["Core Components"]:::core
        L2["Extension Components"]:::extension
        L3["Debug Utilities"]:::debug
    end
```
