sequenceDiagram
    autonumber
    participant Editor as Editor (VSCode/Neovim)
    participant LSP as "@birdcc/lsp"
    participant Linter as "@birdcc/linter"
    participant Formatter as "@birdcc/formatter"
    participant Parser as "@birdcc/parser"
    participant Core as "@birdcc/core"

    rect rgb(225, 245, 254)
        Note over Editor,Core: Real-time Diagnostics Flow
        Editor->>+LSP: textDocument/didChange
        LSP->>+Parser: parseBirdConfig(source)
        Parser-->>-LSP: ParsedBirdDocument
        LSP->>+Core: buildCoreSnapshot(parsed)
        Core-->>-LSP: CoreSnapshot
        LSP->>+Linter: lintBirdConfig(context)
        Linter-->>-LSP: Diagnostics[]
        LSP-->>-Editor: textDocument/publishDiagnostics
    end

    rect rgb(255, 243, 224)
        Note over Editor,Core: Formatting Flow
        Editor->>+LSP: textDocument/formatting
        LSP->>+Formatter: formatBirdConfig(source)
        Formatter->>+Parser: parseBirdConfig(source)
        Parser-->>-Formatter: AST
        Formatter-->>-LSP: Formatted Text
        LSP-->>-Editor: TextEdit[]
    end

flowchart BT
    classDef infra fill:#fce4ec,stroke:#ad1457,stroke-width:2px,color:#000
    classDef core fill:#e8f5e9,stroke:#2e7d32,stroke-width:3px,color:#000
    classDef service fill:#fff3e0,stroke:#ef6c00,stroke-width:2px,color:#000
    classDef lsp fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px,color:#000
    classDef user fill:#e3f2fd,stroke:#1565c0,stroke-width:2px,color:#000

    subgraph Infrastructure [Infrastructure Layer]
        PARSER("@birdcc/parser<br/>Tree-sitter/WASM")
        DPRINT("@birdcc/dprint-plugin-bird<br/>🦀 Rust")
    end

    subgraph CoreLayer [Core Layer]
        CORE("@birdcc/core<br/>Symbol Table & Type System")
    end

    subgraph ServiceLayer [Service Layer]
        FORMATTER("@birdcc/formatter<br/>Formatting Engine")
        LINTER("@birdcc/linter<br/>Config Static Analysis Engine")
    end

    subgraph LspLayer [LSP Adapter Layer]
        LSP_SERVER("@birdcc/lsp<br/>Language Server Protocol")
    end

    subgraph UserLayer [User Interface Layer]
        CLI("@birdcc/cli<br/>Command Line")
        VSCODE("@birdcc/vscode<br/>Editor Extension")
    end


    %% Infrastructure supports Formatter (Dprint as underlying engine)
    PARSER <--> DPRINT
    PARSER <--> CORE

    CORE --> FORMATTER
    DPRINT --> FORMATTER

    %% Core and Formatter support Linter
    CORE --> LINTER
    FORMATTER --> LINTER

    %% All services support LSP
    FORMATTER --> LSP_SERVER
    LINTER --> LSP_SERVER

    %% LSP and standalone services support user interfaces
    LSP_SERVER --> CLI
    LSP_SERVER --> VSCODE
    LINTER --> CLI
    FORMATTER --> CLI

    class PARSER,DPRINT infra
    class CORE core
    class FORMATTER,LINTER service
    class LSP_SERVER lsp
    class CLI,VSCODE user