# amcharts/amcharts5 architecture

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

- Interactive diagram: https://gitdiagram.com/amcharts/amcharts5
- Repository: https://github.com/amcharts/amcharts5

## Overview

##### Main Components (Core Layer)
- Render Engine (src/.internal/core/render)
- Theme System (src/.internal/core/Theme.ts)
- Root Component (src/.internal/core/Root.ts)
- Registry System (src/.internal/core/Registry.ts)

##### Chart Types Layer (Connected to Core)
- XY Charts (src/.internal/charts/xy)
- Flow Charts (src/.internal/charts/flow)
- Charts (src/.internal/charts/map)
- Hierarchy Charts (src/.internal/charts/hierarchy)
- Stock Charts (src/.internal/charts/stock)
- Radar Charts (src/.internal/charts/radar)
- Use rectangles for each chart type module

##### Data Processing Layer
- Components for:
- Data Parser (src/.internal/core/util/DataParser.ts)
- Data Processor (src/.internal/core/util/DataProcessor.ts)
- State Management (src/.internal/core/util/States.ts)
- Use parallelograms to represent data processing components

##### Plugin System (Extension Layer)
- Plugin architecture with:
- Exporting Plugin (src/.internal/plugins/exporting)
- JSON Plugin (src/.internal/plugins/json)
- SliceGrouper Plugin (src/.internal/plugins/sliceGrouper)
- Use circles for plugins to indicate extensibility

##### Resource Modules
- Create sections for:
- Geodata (src/geodata)
- Themes (src/themes)
- Locales (src/locales)

##### Utility Layer
- Crucial utilities:
- Animation System (src/.internal/core/util/Animation.ts)
- Event System (src/.internal/core/util/EventDispatcher.ts)
- Use rounded rectangles for utility components

- Core Components: Blue
- Chart Types: Green
- Data Processing: Yellow
- Plugins: Purple
- Resources: Orange
- Utilities: Gray

Connections:

Additional Elements:
##### External dependencies

Key Architectural Patterns to Highlight:

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles
    classDef core fill:#2196F3,stroke:#1565C0,color:white
    classDef chart fill:#4CAF50,stroke:#2E7D32,color:white
    classDef data fill:#FFC107,stroke:#FFA000,color:black
    classDef plugin fill:#9C27B0,stroke:#6A1B9A,color:white
    classDef resource fill:#FF9800,stroke:#F57C00,color:white
    classDef utility fill:#9E9E9E,stroke:#616161,color:white

    %% Core Layer
    subgraph CoreLayer["Core Layer"]
        Core{{Core Engine}}
        RenderEngine[Render Engine]
        ThemeSystem[Theme System]
        RootComponent[Root Component]
        Registry[Registry System]
    end
    
    Core --> RenderEngine
    Core --> ThemeSystem
    Core --> RootComponent
    Core --> Registry

    %% Chart Types Layer
    subgraph ChartTypes["Chart Types"]
        XYCharts[XY Charts]
        FlowCharts[Flow Charts]
        MapCharts[Map Charts]
        HierarchyCharts[Hierarchy Charts]
        StockCharts[Stock Charts]
        RadarCharts[Radar Charts]
    end

    %% Data Processing Layer
    subgraph DataProcessing["Data Processing"]
        DataParser[Data Parser]
        DataProcessor[Data Processor]
        StateManagement[State Management]
    end

    %% Plugin System
    subgraph Plugins["Plugin System"]
        ExportingPlugin(Exporting)
        JSONPlugin(JSON)
        SliceGrouperPlugin(SliceGrouper)
    end

    %% Resource Modules
    subgraph Resources["Resources"]
        Geodata[(Geodata)]
        Themes[(Themes)]
        Locales[(Locales)]
    end

    %% Utility Layer
    subgraph Utilities["Utility Layer"]
        Animation[Animation System]
        ColorManagement[Color Management]
        EventSystem[Event System]
    end

    %% Connections
    Core <--> ChartTypes
    DataProcessing --> ChartTypes
    Core -.-> Plugins
    Resources -.-> Core
    Utilities --> Core

    %% Click Events
    click RenderEngine "https://github.com/amcharts/amcharts5/tree/master/src/.internal/core/render/"
    click ThemeSystem "https://github.com/amcharts/amcharts5/blob/master/src/.internal/core/Theme.ts"
    click RootComponent "https://github.com/amcharts/amcharts5/blob/master/src/.internal/core/Root.ts"
    click Registry "https://github.com/amcharts/amcharts5/blob/master/src/.internal/core/Registry.ts"
    click XYCharts "https://github.com/amcharts/amcharts5/tree/master/src/.internal/charts/xy/"
    click FlowCharts "https://github.com/amcharts/amcharts5/tree/master/src/.internal/charts/flow/"
    click MapCharts "https://github.com/amcharts/amcharts5/tree/master/src/.internal/charts/map/"
    click HierarchyCharts "https://github.com/amcharts/amcharts5/tree/master/src/.internal/charts/hierarchy/"
    click StockCharts "https://github.com/amcharts/amcharts5/tree/master/src/.internal/charts/stock/"
    click RadarCharts "https://github.com/amcharts/amcharts5/tree/master/src/.internal/charts/radar/"
    click DataParser "https://github.com/amcharts/amcharts5/blob/master/src/.internal/core/util/DataParser.ts"
    click DataProcessor "https://github.com/amcharts/amcharts5/blob/master/src/.internal/core/util/DataProcessor.ts"
    click StateManagement "https://github.com/amcharts/amcharts5/blob/master/src/.internal/core/util/States.ts"
    click ExportingPlugin "https://github.com/amcharts/amcharts5/tree/master/src/.internal/plugins/exporting/"
    click JSONPlugin "https://github.com/amcharts/amcharts5/tree/master/src/.internal/plugins/json/"
    click SliceGrouperPlugin "https://github.com/amcharts/amcharts5/tree/master/src/.internal/plugins/sliceGrouper/"
    click Geodata "https://github.com/amcharts/amcharts5/tree/master/src/geodata/"
    click Themes "https://github.com/amcharts/amcharts5/tree/master/src/themes/"
    click Locales "https://github.com/amcharts/amcharts5/tree/master/src/locales/"
    click Animation "https://github.com/amcharts/amcharts5/blob/master/src/.internal/core/util/Animation.ts"
    click ColorManagement "https://github.com/amcharts/amcharts5/blob/master/src/.internal/core/util/Color.ts"
    click EventSystem "https://github.com/amcharts/amcharts5/blob/master/src/.internal/core/util/EventDispatcher.ts"

    %% Style Applications
    class Core,RenderEngine,ThemeSystem,RootComponent,Registry core
    class XYCharts,FlowCharts,MapCharts,HierarchyCharts,StockCharts,RadarCharts chart
    class DataParser,DataProcessor,StateManagement data
    class ExportingPlugin,JSONPlugin,SliceGrouperPlugin plugin
    class Geodata,Themes,Locales resource
    class Animation,ColorManagement,EventSystem utility
```
