# open-source-labs/svelvet architecture

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

- Interactive diagram: https://gitdiagram.com/open-source-labs/svelvet
- Repository: https://github.com/open-source-labs/svelvet

## Overview

##### Main Components Architecture

**┌─────────────────────────────────────────────────────────────┐**
- Svelvet Container                      │
- ┤

- ┌─────────────┐    ┌──────────┐    ┌──────────────────┐   │
- Graph     │    │  Editor  │    │    Controls      │   │
- ┘    └──────────┘    └──────────────────┘   │

- ┌─────────────┐    ┌──────────┐    ┌──────────────────┐   │
- Minimap   │    │  Drawer  │    │  Theme Toggle    │   │
- ┘    └──────────┘    └──────────────────┘   │

- ┘

##### Core Component Relationships

**┌─────────────────────────────────────────────────────────────────────┐**
- Graph Component                           │
- ┤

- ┌──────────┐         ┌──────────┐         ┌──────────────┐      │
- Node    │◄───────►│  Edge    │◄───────►│   Anchor    │      │
- ┘         └──────────┘         └──────────────┘      │
- ▲                    ▲                      ▲               │

- ┌──────────┐         ┌──────────┐         ┌──────────────┐      │
- Group   │         │ Resizer  │         │ Background   │      │
- ┘         └──────────┘         └──────────────┘      │

- ┘

##### Data Flow System

**┌────────────────────────────────────────────────────┐**
- Data Flow System                  │
- ┤

- ┌──────────┐    ┌──────────┐    ┌──────────┐   │
- Slider  │    │   Knob   │    │ Toggle   │   │
- ┘    └──────────┘    └──────────┘   │

- ┌──────────┐    ┌──────────┐    ┌──────────┐   │
- Group   │    │  Picker  │    │  Field   │   │
- ┘    └──────────┘    └──────────┘   │

- ┘

##### State Management

**┌────────────────────────────────────────────┐**
- Store System                  │
- ┤

- ┌───────────────┐    ┌──────────────┐  │
- Graph Store  │    │ Cursor Store │  │
- ┘    └──────────────┘  │

- ┌───────────────┐    ┌──────────────┐  │
- Bounds Store  │    │ Edge Store   │  │
- ┘    └──────────────┘  │

- ┘

##### Important Implementation Details

- Core components (blue)
- Data flow components (green)
- Store system (orange)
- Utility components (gray)

- Use different line styles for different types of relationships:

- Annotations for:
- Accessibility features
- Theme system
- Event handling system
- Persistent storage functionality

##### Technical Stack Indicators

- Svelte/SvelteKit
- TypeScript
- Playwright (testing)
- Vitest (unit testing)
- Local Storage (state persistence)

This system design should emphasize:
- Component modularity
- Event-driven architecture
- State management
- Accessibility features
- Customization options
- Data flow system

- Clear visual hierarchy
- Interactive elements (if possible)
- Exportable formats
- Version control compatibility

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Container
        SvelvetContainer["Svelvet Container"]
        GraphComp["Graph Component"]
        Editor["Editor"]
        Controls["Controls"]
        Minimap["Minimap"]
        Drawer["Drawer"]
        ThemeToggle["Theme Toggle"]
        
        SvelvetContainer --> GraphComp
        SvelvetContainer --> Editor
        SvelvetContainer --> Controls
        SvelvetContainer --> Minimap
        SvelvetContainer --> Drawer
        SvelvetContainer --> ThemeToggle
    end

    subgraph GraphComponents
        Node["Node"]
        Edge["Edge"]
        Anchor["Anchor"]
        Group["Group"]
        Resizer["Resizer"]
        Background["Background"]
        
        GraphComp --> Node
        GraphComp --> Edge
        GraphComp --> Anchor
        GraphComp --> Group
        GraphComp --> Resizer
        GraphComp --> Background
        
        Node <--> Edge
        Edge <--> Anchor
    end

    subgraph DataFlow
        Slider["Slider"]
        Knob["Knob"]
        Toggle["Toggle"]
        RadioGroup["Radio Group"]
        ColorPicker["Color Picker"]
        TextField["Text Field"]
    end

    subgraph Stores
        GraphStore["Graph Store"]
        CursorStore["Cursor Store"]
        BoundsStore["Bounds Store"]
        EdgeStore["Edge Store"]
    end

    GraphComp -.-> GraphStore
    GraphComp -.-> CursorStore
    GraphComp -.-> BoundsStore
    Edge -.-> EdgeStore

    %% Click events for components
    click SvelvetContainer "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/containers/Svelvet/Svelvet.svelte"
    click GraphComp "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/containers/Graph/Graph.svelte"
    click Editor "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/Editor/Editor.svelte"
    click Controls "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/Controls/Controls.svelte"
    click Minimap "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/Minimap/Minimap.svelte"
    click Drawer "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/Drawer/Drawer.svelte"
    click ThemeToggle "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/ThemeToggle/ThemeToggle.svelte"
    click Node "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/Node/Node.svelte"
    click Edge "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/Edge/Edge.svelte"
    click Anchor "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/Anchor/Anchor.svelte"
    click Group "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/Group/Group.svelte"
    click Resizer "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/Resizer/Resizer.svelte"
    click Background "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/containers/Background/Background.svelte"
    click Slider "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/data/Slider/Slider.svelte"
    click Knob "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/data/Knob/Knob.svelte"
    click Toggle "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/data/Toggle/Toggle.svelte"
    click RadioGroup "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/data/RadioGroup/RadioGroup.svelte"
    click ColorPicker "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/data/ColorPicker/ColorWheel.svelte"
    click TextField "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/components/data/TextField/TextField.svelte"
    click GraphStore "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/stores/GraphStore.ts"
    click CursorStore "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/stores/CursorStore.ts"
    click EdgeStore "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/utils/creators/createEdgeStore.ts"
    click BoundsStore "https://github.com/open-source-labs/Svelvet/blob/main/src/lib/utils/creators/createBoundsStore.ts"

    %% Styling
    classDef container fill:#e1f5fe,stroke:#01579b
    classDef component fill:#e8f5e9,stroke:#2e7d32
    classDef dataflow fill:#fff3e0,stroke:#ff6f00
    classDef store fill:#fce4ec,stroke:#c2185b

    class SvelvetContainer,Container container
    class GraphComp,Editor,Controls,Minimap,Drawer,ThemeToggle,Node,Edge,Anchor,Group,Resizer,Background component
    class Slider,Knob,Toggle,RadioGroup,ColorPicker,TextField dataflow
    class GraphStore,CursorStore,BoundsStore,EdgeStore store
```
