# venlious/bloob.io-locale architecture

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

- Interactive diagram: https://gitdiagram.com/venlious/bloob.io-locale
- Repository: https://github.com/venlious/bloob.io-locale

## Overview

##### Core Components
- Translation Management System (Central Component)
- Helper Modules
- Message Storage
- Number Format System
- Translation Processing Pipeline

**[Translation Management System]**
- [Helper Modules]
- [Message Storage]
- [Number Formats]
- [Translation Processing]

##### Helper Modules (Green)
- Fill Helper
- Fix Helper
- Translate Helper
- Utility Functions

##### Message Storage (Orange)
- Regular Messages
- Verified Messages
- Empty Template

##### Translation Processing Pipeline (Purple)
- Source Language Input
- Translation Processing
- Verification Stage
- Output Generation

Key Interactions to Highlight:

##### Translation Flow
- [Source Language] → [Translation Helper] → [Message Storage]
- ↓
- [Verification] ← [Processing] → [Verified Storage]

##### Utility Flow
- [Fill Helper] → [Message Storage]
- [Fix Helper] → [Message Storage]

Additional Elements:

##### External Integration Points
- Translation Editor Interface
- API Integration Points
- File System Interface (for JSON storage)

##### Configuration Components
- Environment Configuration
- Babel Configuration
- TypeScript Configuration

##### Clear separation between
- Source files (.ts files)
- Configuration files
- Resource files (messages)
- Helper utilities

##### Build and verification pipeline

Remember to:
- Version control integration points
- Test coverage paths
- Configuration dependencies
- Automated processes vs. manual interventions

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph TMS["Translation Management System"]
        direction TB
        Core["Core System"]:::core
        TransClass["Translation Class"]:::core
        Types["Type Definitions"]:::types
    end

    subgraph Helpers["Helper Modules"]
        direction TB
        Fill["Fill Helper"]:::helper
        Fix["Fix Helper"]:::helper
        Translate["Translate Helper"]:::helper
        Utils["Utility Functions"]:::helper
    end

    subgraph Storage["Message Storage"]
        direction TB
        RegMsgs[("Regular Messages")]:::storage
        VerMsgs[("Verified Messages")]:::storage
        EmptyTemp[("Empty Template")]:::storage
    end

    subgraph Processing["Translation Processing Pipeline"]
        direction TB
        SrcLang["Source Language Input"]:::process
        TransProc["Translation Processing"]:::process
        Verify["Verification Stage"]:::process
        Output["Output Generation"]:::process
    end

    subgraph Config["Configuration"]
        direction TB
        Env["Environment"]:::config
        Babel["Babel"]:::config
        TS["TypeScript"]:::config
        ESLint["ESLint"]:::config
        Prettier["Prettier"]:::config
    end

    subgraph Testing["Testing Infrastructure"]
        direction TB
        MainTests["Main Tests"]:::test
        CICD["CI/CD Pipeline"]:::test
    end

    NumberFmt[("Number Formats")]:::storage

    %% Relationships
    Core --> TransClass
    Core --> Types
    
    Fill --> RegMsgs
    Fix --> RegMsgs
    Translate --> TransProc
    
    SrcLang --> TransProc
    TransProc --> Verify
    Verify --> VerMsgs
    Verify --> Output
    
    RegMsgs --> TransProc
    VerMsgs --> Output
    EmptyTemp --> Fill
    
    NumberFmt --> TransProc
    
    %% Click Events
    click Core "https://github.com/Venlious/bloob.io-locale/blob/master/index.ts"
    click TransClass "https://github.com/Venlious/bloob.io-locale/blob/master/helpers/translate/TranslationClass.ts"
    click Types "https://github.com/Venlious/bloob.io-locale/blob/master/types/index.ts"
    click Fill "https://github.com/Venlious/bloob.io-locale/blob/master/helpers/fill/index.ts"
    click Fix "https://github.com/Venlious/bloob.io-locale/blob/master/helpers/fix/index.ts"
    click Translate "https://github.com/Venlious/bloob.io-locale/blob/master/helpers/translate/index.ts"
    click Utils "https://github.com/Venlious/bloob.io-locale/blob/master/helpers/utils.ts"
    click RegMsgs "https://github.com/Venlious/bloob.io-locale/tree/master/messages"
    click VerMsgs "https://github.com/Venlious/bloob.io-locale/tree/master/messages/verified"
    click EmptyTemp "https://github.com/Venlious/bloob.io-locale/blob/master/messages/_empty.json"
    click NumberFmt "https://github.com/Venlious/bloob.io-locale/blob/master/numberFormats/data.json"
    click Env "https://github.com/Venlious/bloob.io-locale/blob/master/.env.example"
    click Babel "https://github.com/Venlious/bloob.io-locale/blob/master/babel.config.js"
    click TS "https://github.com/Venlious/bloob.io-locale/blob/master/tsconfig.json"
    click ESLint "https://github.com/Venlious/bloob.io-locale/blob/master/.eslintrc.js"
    click Prettier "https://github.com/Venlious/bloob.io-locale/blob/master/.prettierrc"
    click MainTests "https://github.com/Venlious/bloob.io-locale/blob/master/index.spec.ts"
    click CICD "https://github.com/Venlious/bloob.io-locale/blob/master/.github/workflows/test.yml"

    %% Styling
    classDef core fill:#2374ab
    classDef helper fill:#57b894
    classDef storage fill:#ff7f50
    classDef process fill:#9b59b6
    classDef config fill:#f1c40f
    classDef test fill:#95a5a6
    classDef types fill:#3498db

    %% Legend
    subgraph Legend
        direction TB
        L1["Core Component"]:::core
        L2["Helper Module"]:::helper
        L3[("Storage")]:::storage
        L4["Process"]:::process
        L5["Configuration"]:::config
        L6["Testing"]:::test
        L7["Types"]:::types
    end
```
