# kraftman/3de architecture

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

- Interactive diagram: https://gitdiagram.com/kraftman/3de
- Repository: https://github.com/kraftman/3de

## Overview

##### Main System Components

A. Electron Application Layer
- Main Process (src/main.js)
- Renderer Process (src/renderer.js)
- Preload Scripts (src/preload.js)

B. Core Application Components
- Flow Manager (src/FlowManager.jsx)
- Layer Manager (src/components/LayerManager.jsx)
- File System Manager (src/stores/useFileSystem.js)
- Node Manager (src/hooks/useNodeManager.js)

C. Node Types System
- Code Nodes
- Module Nodes
- Markdown Nodes
- Pure Function Nodes
- Settings Nodes
- Text Nodes
- Image Nodes

D. Utility Systems
- AST Processing (src/utils/astUtils.js)
- Code Analysis (src/utils/parser.js)
- File Operations (src/utils/fileUtils.js)
- Layout Management (src/utils/nodeUtils/layoutChildren.js)

**┌─────────────────────────────────────────────┐**
- Electron Runtime               │
- ┤
- React Application              │
- ┤
- File System Layer              │
- ┘

##### Key Relationships to Highlight

- Bidirectional communication between Main and Renderer processes
- How the Flow Manager orchestrates different node types
- Demonstrate the relationship between the File System and Node Manager
- How the AST processing pipeline works with different node types

##### Specific Implementation Details

**┌─────────────────────┐**
- Component Name   │
- ┤
- Key Function 1   │
- Key Function 2   │
- ┘

##### Data Flow Indicators

- File system operations (→)
- Component communication (⇄)
- Event flows (⇢)
- Data transformations (⇒)

##### Implementation Notes

- Nested components
- Bidirectional relationships
- Layer management
- Clear typography for component labels

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Electron["Electron Runtime"]
        MainProcess["Main Process"]
        RendererProcess["Renderer Process"]
        PreloadScripts["Preload Scripts"]
        
        MainProcess <--> RendererProcess
        RendererProcess --- PreloadScripts
    end

    subgraph Core["React Application Core"]
        FlowManager["Flow Manager"]
        LayerManager["Layer Manager"]
        FileSystemManager["File System Manager"]
        NodeManager["Node Manager"]
        EdgeManager["Edge Manager"]
        FlowScreen["Flow Screen"]
        
        FlowManager --> LayerManager
        FlowManager --> NodeManager
        FlowManager --> EdgeManager
        FlowManager --> FlowScreen
        LayerManager --> FileSystemManager
        NodeManager --> FileSystemManager
    end

    subgraph NodeTypes["Node Types System"]
        CodeNode["Code Node"]
        ModuleNode["Module Node"]
        MarkdownNode["Markdown Node"]
        PureFunctionNode["Pure Function Node"]
        SettingsNode["Settings Node"]
        TextNode["Text Node"]
        ImageNode["Image Node"]
    end

    subgraph Utils["Utility Systems"]
        ASTProcessing["AST Processing"]
        CodeAnalysis["Code Analysis"]
        FileOperations["File Operations"]
        LayoutManagement["Layout Management"]
        
        ASTProcessing --> CodeAnalysis
        CodeAnalysis --> FileOperations
        FileOperations --> LayoutManagement
    end

    RendererProcess --> FlowManager
    NodeManager --> NodeTypes
    Utils --> NodeTypes
    FileSystemManager --> FileOperations

    %% Click events for component mapping
    click MainProcess "https://github.com/kraftman/3DE/blob/master/src/main.js"
    click RendererProcess "https://github.com/kraftman/3DE/blob/master/src/renderer.js"
    click PreloadScripts "https://github.com/kraftman/3DE/blob/master/src/preload.js"
    click FlowManager "https://github.com/kraftman/3DE/blob/master/src/FlowManager.jsx"
    click LayerManager "https://github.com/kraftman/3DE/blob/master/src/components/LayerManager.jsx"
    click FileSystemManager "https://github.com/kraftman/3DE/blob/master/src/stores/useFileSystem.js"
    click NodeManager "https://github.com/kraftman/3DE/blob/master/src/hooks/useNodeManager.js"
    click CodeNode "https://github.com/kraftman/3DE/blob/master/src/components/nodes/CodeNode/CodeNode.jsx"
    click ModuleNode "https://github.com/kraftman/3DE/blob/master/src/components/nodes/ModuleNode/ModuleNode.jsx"
    click MarkdownNode "https://github.com/kraftman/3DE/blob/master/src/components/nodes/MarkdownNode/MarkdownNode.js"
    click PureFunctionNode "https://github.com/kraftman/3DE/blob/master/src/components/nodes/PureFunctionNode/PureFunctionNode.jsx"
    click SettingsNode "https://github.com/kraftman/3DE/blob/master/src/components/nodes/SettingsNode/SettingsNode.jsx"
    click TextNode "https://github.com/kraftman/3DE/blob/master/src/components/nodes/TextNode/TextNode.js"
    click ImageNode "https://github.com/kraftman/3DE/blob/master/src/components/nodes/ImageNode.jsx"
    click ASTProcessing "https://github.com/kraftman/3DE/blob/master/src/utils/astUtils.js"
    click CodeAnalysis "https://github.com/kraftman/3DE/blob/master/src/utils/parser.js"
    click FileOperations "https://github.com/kraftman/3DE/blob/master/src/utils/fileUtils.js"
    click LayoutManagement "https://github.com/kraftman/3DE/blob/master/src/utils/nodeUtils/layoutChildren.js"
    click FlowScreen "https://github.com/kraftman/3DE/blob/master/src/screens/Flow/Flow.js"
    click EdgeManager "https://github.com/kraftman/3DE/blob/master/src/hooks/useEdgeManager.js"

    classDef electron fill:#gray,stroke:#333,stroke-width:2px
    classDef core fill:#blue,stroke:#333,stroke-width:2px
    classDef nodes fill:#green,stroke:#333,stroke-width:2px
    classDef utils fill:#yellow,stroke:#333,stroke-width:2px

    class Electron electron
    class Core core
    class NodeTypes nodes
    class Utils utils
```
