# andraderaul/br-ow-ser architecture

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

- Interactive diagram: https://gitdiagram.com/andraderaul/br-ow-ser
- Repository: https://github.com/andraderaul/br-ow-ser

## Overview

##### Component Relationships

Key flows to highlight:
- HTML → HTML Parser → DOM Tree
- CSS → CSS Parser → CSSOM Tree
- DOM Tree + CSSOM Tree → Style Engine → Layout Engine → Painting Engine
- Painting Engine → PNG/PDF Output

##### Technical Details
Annotations showing:
- Supported HTML features (balanced tags, attributes, text nodes)
- Supported CSS features (simple selectors)
- Layout engine capabilities
- Painting engine output formats

##### Architecture Patterns
Pipeline architecture pattern used in the browser engine:
- Sequential processing stages
- Data transformation at each stage
- Test points in the pipeline

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef input fill:#b3d9ff,stroke:#333
    classDef parser fill:#90EE90,stroke:#333
    classDef datastructure fill:#FFE5B4,stroke:#333
    classDef processing fill:#FFA07A,stroke:#333
    classDef output fill:#DDA0DD,stroke:#333
    classDef test fill:#E6E6FA,stroke:#333

    %% Input Layer
    subgraph Input
        HTML["HTML Input"]:::input
        CSS["CSS Input"]:::input
    end

    %% Parsing Layer
    subgraph Parsing
        HTMLParser["HTML Parser"]:::parser
        CSSParser["CSS Parser"]:::parser
        HTMLTest["HTML Parser Tests"]:::test
        CSSTest["CSS Parser Tests"]:::test
    end

    %% Data Structure Layer
    subgraph DataStructures
        DOM["DOM Tree"]:::datastructure
        CSSOM["CSSOM Tree"]:::datastructure
        DOMTest["DOM Tests"]:::test
        CSSOMTest["CSSOM Tests"]:::test
    end

    %% Processing Layer
    subgraph Processing
        StyleEngine["Style Engine"]:::processing
        LayoutEngine["Layout Engine"]:::processing
        StyleTest["Style Tests"]:::test
    end

    %% Output Layer
    subgraph Output
        PaintEngine["Painting Engine"]:::output
        PDFGen["PDF Generator"]:::output
    end

    %% Main CLI
    CLI["Command Line Interface"]:::input

    %% Relationships
    HTML --> HTMLParser
    CSS --> CSSParser
    HTMLParser --> DOM
    CSSParser --> CSSOM
    DOM --> StyleEngine
    CSSOM --> StyleEngine
    StyleEngine --> LayoutEngine
    LayoutEngine --> PaintEngine
    PaintEngine --> PDFGen

    %% Test Relationships
    HTMLParser -.-> HTMLTest
    CSSParser -.-> CSSTest
    DOM -.-> DOMTest
    CSSOM -.-> CSSOMTest
    StyleEngine -.-> StyleTest

    %% CLI Control
    CLI --> HTML
    CLI --> CSS

    %% Click Events
    click HTMLParser "https://github.com/andraderaul/br-ow-ser/blob/main/src/html.rs"
    click HTMLTest "https://github.com/andraderaul/br-ow-ser/blob/main/src/html_test.rs"
    click CSSParser "https://github.com/andraderaul/br-ow-ser/blob/main/src/css.rs"
    click CSSTest "https://github.com/andraderaul/br-ow-ser/blob/main/src/css_test.rs"
    click DOM "https://github.com/andraderaul/br-ow-ser/blob/main/src/dom.rs"
    click DOMTest "https://github.com/andraderaul/br-ow-ser/blob/main/src/dom_test.rs"
    click CSSOM "https://github.com/andraderaul/br-ow-ser/blob/main/src/cssom.rs"
    click CSSOMTest "https://github.com/andraderaul/br-ow-ser/blob/main/src/cssom_test.rs"
    click StyleEngine "https://github.com/andraderaul/br-ow-ser/blob/main/src/style.rs"
    click StyleTest "https://github.com/andraderaul/br-ow-ser/blob/main/src/style_test.rs"
    click LayoutEngine "https://github.com/andraderaul/br-ow-ser/blob/main/src/layout.rs"
    click PaintEngine "https://github.com/andraderaul/br-ow-ser/blob/main/src/painting.rs"
    click PDFGen "https://github.com/andraderaul/br-ow-ser/blob/main/src/pdf.rs"
    click CLI "https://github.com/andraderaul/br-ow-ser/blob/main/src/main.rs"
    click HTML "https://github.com/andraderaul/br-ow-ser/blob/main/examples/*.html"
    click CSS "https://github.com/andraderaul/br-ow-ser/blob/main/examples/*.css"
```
