# ducphamngoc08/codevisualizer architecture

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

- Interactive diagram: https://gitdiagram.com/ducphamngoc08/codevisualizer
- Repository: https://github.com/ducphamngoc08/codevisualizer

## Overview

##### Project type and purpose
- This is a VS Code extension (“CodeVisualizer”) that analyzes source code (multiple languages) and renders interactive flowcharts and dependency graphs inside VS Code.

##### File structure
- Top-level:
- extension.ts – Extension entry point (activates commands, registers providers)
- src/core/language-services – Language-specific AST parsers (Tree-sitter WASM modules)
- src/core/dependency – Codebase dependency analyzer and graph builder
- src/ir – Intermediate representation definitions
- src/view – Webview providers and flowchart panel code
- Config/build: webpack.config.js, tsconfig.json, package.json
- Media and static assets under media/

##### README for additional insights
- Two pipelines:
- Optional AI pipeline step: IR node labels → LLMManager → human-friendly labels → cache

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% User and Entry
    User["User invokes command"]:::user
    VSCode["VS Code Extension Host"]:::extension
    click VSCode "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/extension.ts"

    User --> VSCode

    %% Core Engine
    subgraph "Core Engine"
        direction TB

        subgraph "Language Services" 
            direction TB
            AbstractParser["Abstract Parser"]:::parsing
            AstParserTypes["AST Parser Types"]:::parsing
            ParserInit["Parser Initialization"]:::parsing
            CAstParser["C AST Parser"]:::parsing
            CppAstParser["C++ AST Parser"]:::parsing
            GoAstParser["Go AST Parser"]:::parsing
            JavaAstParser["Java AST Parser"]:::parsing
            PyAstParser["Python AST Parser"]:::parsing
            RustAstParser["Rust AST Parser"]:::parsing
            TsAstParser["TypeScript AST Parser"]:::parsing

            click AbstractParser "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/common/AbstractParser.ts"
            click AstParserTypes "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/common/AstParserTypes.ts"
            click ParserInit "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/language-services/common/ParserInit.ts"
            click CAstParser "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/language-services/c/CAstParser.ts"
            click CppAstParser "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/language-services/cpp/CppAstParser.ts"
            click GoAstParser "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/language-services/go/GoAstParser.ts"
            click JavaAstParser "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/language-services/java/JavaAstParser.ts"
            click PyAstParser "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/language-services/python/PyAstParser.ts"
            click RustAstParser "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/language-services/rust/RustAstParser.ts"
            click TsAstParser "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/language-services/typescript/TsAstParser.ts"
        end

        subgraph "Analyzers"
            direction TB
            ASTAnalyzer["AST Analyzer"]:::core
            CodebaseAnalyzer["Codebase Dependency Analyzer"]:::core

            click ASTAnalyzer "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/analyzer.ts"
            click CodebaseAnalyzer "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/dependency/CodebaseAnalyzer.ts"
        end

        IRGenerator["IR Generator"]:::core
        click IRGenerator "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/ir/ir.ts"

        subgraph "Mermaid Generators"
            direction TB
            FunctionMermaid["Function-Level Diagram Generator"]:::core
            BaseMermaid["Base Mermaid Generator"]:::core
            DependencyMermaid["Dependency Graph Generator"]:::core

            click FunctionMermaid "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/EnhancedMermaidGenerator.ts"
            click BaseMermaid "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/MermaidGenerator.ts"
            click DependencyMermaid "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/dependency/CodebaseMermaidGenerator.ts"
        end

        subgraph "Dependency Builder"
            direction TB
            FileTypeClassifier["File Type Classifier"]:::core
            GraphBuilder["Graph Builder"]:::core

            click FileTypeClassifier "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/dependency/FileTypeClassifier.ts"
            click GraphBuilder "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/dependency/CodebaseGraphBuilder.ts"
        end

        subgraph "LLM Service (Optional AI)"
            direction TB
            LLMManager["LLM Manager"]:::external
            CacheManager["Cache Manager"]:::external
            LLMService["LLM Service Interface"]:::external
            LLMLogger["LLM Logger & Context"]:::external

            click LLMManager "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/llm/LLMManager.ts"
            click CacheManager "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/llm/CacheManager.ts"
            click LLMService "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/llm/LLMService.ts"
            click LLMLogger "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/llm/LLMLogger.ts"
        end

        subgraph "Utilities"
            direction TB
            EnvironmentDetector["Environment Detector"]:::utils
            ThemeManager["Theme Manager"]:::utils
            MetricsAnalyzer["Metrics Analyzer"]:::utils
            StringProcessor["String Processor"]:::utils

            click EnvironmentDetector "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/utils/EnvironmentDetector.ts"
            click ThemeManager "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/utils/ThemeManager.ts"
            click MetricsAnalyzer "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/utils/MetricsAnalyzer.ts"
            click StringProcessor "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/core/utils/StringProcessor.ts"
        end
    end

    %% View Layer
    subgraph "View Layer"
        direction TB
        BaseFlowProvider["Base Flowchart Provider"]:::view
        FlowPanel["Function Flowchart Panel"]:::view
        FlowView["General Flowchart View Provider"]:::view
        CodebaseFlow["Codebase Dependency Flow Provider"]:::view

        click BaseFlowProvider "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/view/BaseFlowchartProvider.ts"
        click FlowPanel "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/view/FlowchartPanelProvider.ts"
        click FlowView "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/view/FlowchartViewProvider.ts"
        click CodebaseFlow "https://github.com/ducphamngoc08/codevisualizer/blob/main/src/view/CodebaseFlowProvider.ts"
    end

    %% Configuration & Assets
    subgraph "Configuration & Build"
        tsconfig["tsconfig.json"]:::config
        webpack["webpack.config.js"]:::config
        packageJson["package.json"]:::config
        media["media/"]:::config
        click tsconfig "https://github.com/ducphamngoc08/codevisualizer/blob/main/tsconfig.json"
        click webpack "https://github.com/ducphamngoc08/codevisualizer/blob/main/webpack.config.js"
        click packageJson "https://github.com/ducphamngoc08/codevisualizer/blob/main/package.json"
        click media "https://github.com/ducphamngoc08/codevisualizer/tree/main/media/"
    end

    %% External Services
    subgraph "External LLM Providers"
        direction TB
        OpenAI["OpenAI, Ollama, etc."]:::external
    end

    %% Data Flows
    VSCode --> ASTAnalyzer
    VSCode --> CodebaseAnalyzer
    ASTAnalyzer --> IRGenerator
    CodebaseAnalyzer --> GraphBuilder
    GraphBuilder --> DependencyMermaid
    IRGenerator --> FunctionMermaid
    FunctionMermaid --> BaseMermaid
    BaseMermaid --> BaseFlowProvider
    DependencyMermaid --> CodebaseFlow
    IRGenerator --> LLMManager
    LLMManager --> IRGenerator
    BaseFlowProvider --> FlowPanel
    BaseFlowProvider --> FlowView
    BaseFlowProvider --> CodebaseFlow
    ThemeManager --> BaseFlowProvider
    EnvironmentDetector --> ASTAnalyzer
    MetricsAnalyzer --> ASTAnalyzer

    %% Styles
    classDef user fill:#f9f,stroke:#333,stroke-width:1px
    classDef extension fill:#bbf,stroke:#333,stroke-width:1px
    classDef parsing fill:#bfb,stroke:#333,stroke-width:1px
    classDef core fill:#bbf,stroke:#333,stroke-width:1px
    classDef utils fill:#dfd,stroke:#333,stroke-width:1px
    classDef view fill:#fea,stroke:#333,stroke-width:1px
    classDef config fill:#eee,stroke:#333,stroke-width:1px
    classDef external fill:#ddd,stroke:#333,stroke-width:1px
```
