# marco-prontera/vite-plugin-css-injected-by-js architecture

> Architecture diagram of the GitHub repository marco-prontera/vite-plugin-css-injected-by-js, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marco-prontera/vite-plugin-css-injected-by-js
- Repository: https://github.com/marco-prontera/vite-plugin-css-injected-by-js

## Overview

##### Main Components

a) Build-time Components:
- Vite Build Pipeline
- CSS Injector Plugin Core
- Filter System
- Code Generation System
- Configuration Handler

b) Runtime Components:
- Generated JavaScript Bundle
- CSS Injection Mechanism
- DOM Integration
- CSP Handler

##### Key Relationships

BUILD TIME:
**Vite Build Pipeline → Plugin Integration → CSS Processing → JS Generation**

RUNTIME:
**JS Bundle Execution → CSS Injection → DOM Manipulation**

##### Specific Implementation Details

A. Build Time Layer (Top Section):
- Input: Source files (CSS/JS/TS)
- Plugin Configuration Handler
- Connection to all configurable options (cssAssetsFilterFunction, jsAssetsFilterFunction, etc.)
- CSS Processing Pipeline
- CSS Assets Filter
- CSS Code Pre-renderer
- Code Generation System
- Injection Code Generator
- Module Format Handler

B. Runtime Layer (Bottom Section):
- JavaScript Bundle Executor
- CSS Injection System
- Style Element Creator
- CSP Handler
- Attribute Manager
- DOM Integration Point

##### Important Flows to Highlight

a) Configuration Flow:
**User Config → Plugin Initialize → Feature Enablement**

b) Build Flow:
**CSS Files → Filter → Transform → Bundle**

c) Runtime Flow:
**JS Execute → Create Style → Inject CSS → DOM Update**

##### Notes Section

Callouts for:
- Experimental features
- CSP requirements
- Multiple entry point considerations
- Plugin-legacy compatibility notes

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Build["Build Time Layer"]
        direction TB
        ViteBuild["Vite Build Pipeline"]
        PluginCore["Plugin Core"]:::core
        ConfigHandler["Configuration Handler"]:::config
        
        subgraph Processing["CSS Processing"]
            direction TB
            CSSFilter["CSS Assets Filter"]
            JSFilter["JS Assets Filter"]
            PreRenderer["CSS Code Pre-renderer"]
        end
        
        subgraph CodeGen["Code Generation"]
            direction TB
            InjectionGen["Injection Code Generator"]
            ModuleFormat["Module Format Handler"]
        end
        
        ViteBuild --> PluginCore
        PluginCore --> ConfigHandler
        ConfigHandler --> Processing
        Processing --> CodeGen
    end
    
    subgraph Runtime["Runtime Layer"]
        direction TB
        JSBundle["JavaScript Bundle Executor"]
        
        subgraph Injection["CSS Injection System"]
            direction TB
            StyleCreator["Style Element Creator"]
            CSPHandler["CSP Handler"]
            AttrManager["Attribute Manager"]
        end
        
        DOMIntegration["DOM Integration Point"]
        
        JSBundle --> Injection
        Injection --> DOMIntegration
    end
    
    Build --> Runtime
    
    subgraph Legend["Legend"]
        direction TB
        L1["🔵 Build Time Component"]:::build
        L2["🟢 Runtime Component"]:::runtime
        L3["💠 Configuration Point"]:::config
        L4["⚡ Integration Point"]:::integration
    end
    
    subgraph Notes["Important Notes"]
        direction TB
        N1["⚠️ Development Mode: EXPERIMENTAL"]
        N2["🔒 CSP Compatibility Included"]
        N3["📦 Multiple Entry Point Support"]
    end
    
    %% Styling
    classDef build fill:#dae8fc,stroke:#6c8ebf
    classDef runtime fill:#d5e8d4,stroke:#82b366
    classDef config fill:#fff2cc,stroke:#d6b656
    classDef integration fill:#e1d5e7,stroke:#9673a6
    classDef core fill:#f8cecc,stroke:#b85450
    
    %% Click Events
    click PluginCore "https://github.com/marco-prontera/vite-plugin-css-injected-by-js/blob/main/src/index.ts"
    click ConfigHandler "https://github.com/marco-prontera/vite-plugin-css-injected-by-js/blob/main/src/interface.ts"
    click CSSFilter "https://github.com/marco-prontera/vite-plugin-css-injected-by-js/blob/main/src/utils.ts"
    click JSFilter "https://github.com/marco-prontera/vite-plugin-css-injected-by-js/blob/main/src/utils.ts"
    click InjectionGen "https://github.com/marco-prontera/vite-plugin-css-injected-by-js/blob/main/src/utils.ts"
```
