# clickfwd/yoyo architecture

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

- Interactive diagram: https://gitdiagram.com/clickfwd/yoyo
- Repository: https://github.com/clickfwd/yoyo

## Overview

##### Main Components Overview

a) Core Framework Components:
- Component Manager
- View System
- Request Handler
- Event System
- State Management

b) View Providers:
- Blade Integration
- Twig Integration
- Native PHP Templates
- Phalcon Integration

c) Client-Side Integration:
- HTMX Integration
- Browser Event System
- URL State Management

##### Component Relationships

**[Client Browser] <---> [HTMX/JavaScript Layer]**
- ↑               ↑

**[HTTP Request/Response Layer]**
- ↑
**[Yoyo Controller]**
- ↑
- [Component Manager]
- ↑
- [View Provider] ---> [Template Engines]
- ↑
**[Component Classes] ---> [Event System]**

##### Detailed Component Breakdown

Component Manager:
**[Component Manager]**

- > [Component Resolver]
- > [Anonymous Components]
- > [Dynamic Components]
- > [Component Properties]

View System:
**[View Provider Interface]**

- > [Blade Provider]
- > [Twig Provider]
- > [PHP Provider]
- > [Phalcon Provider]

Event System:
**[Event Manager]**

- > [Component Events]
- > [Browser Events]
- > [Event Listeners]

##### Key Features to Highlight

- Property binding system
- Loading states
- Query string management
- Computed properties
- Action handling

##### Integration Points

Clear connection points for:
- HTMX integration
- Template engine plugins
- Framework integrations (Laravel, Phalcon)
- Browser event system

##### Additional Elements

- Configuration options
- Asset management
- Error handling
- Security features

##### Storage Layer (State Management)

This will create a comprehensive visualization of Yoyo's architecture while maintaining clarity and showing the relationships between all major components.

Remember to include notes about:
- Scalability considerations
- Security implementations
- Performance optimizations
- Extension points

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        Browser["Browser"]
        HTMX["HTMX/JavaScript Layer"]:::clientside
        click HTMX "https://github.com/clickfwd/yoyo/blob/master/src/assets/js/yoyo.js"
    end

    subgraph "HTTP Layer"
        Request["Request Handler"]:::http
        Response["Response Handler"]:::http
        click Request "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/Request.php"
        click Response "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/Services/Response.php"
    end

    subgraph "Core Framework"
        CompManager["Component Manager"]:::core
        CompResolver["Component Resolver"]:::core
        Config["Configuration Service"]:::core
        click CompManager "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/ComponentManager.php"
        click CompResolver "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/ComponentResolver.php"
        click Config "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/Services/Configuration.php"
    end

    subgraph "Component Layer"
        BaseComp["Base Component"]:::component
        AnonComp["Anonymous Components"]:::component
        QueryString["Query String Management"]:::component
        click BaseComp "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/Component.php"
        click AnonComp "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/AnonymousComponent.php"
        click QueryString "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/QueryString.php"
    end

    subgraph "View System"
        ViewInterface["View Provider Interface"]:::view
        BaseView["Base View Provider"]:::view
        BladeView["Blade Provider"]:::view
        TwigView["Twig Provider"]:::view
        PhalconView["Phalcon Provider"]:::view
        click ViewInterface "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/Interfaces/ViewProviderInterface.php"
        click BaseView "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/ViewProviders/BaseViewProvider.php"
        click BladeView "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/ViewProviders/BladeViewProvider.php"
        click TwigView "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/ViewProviders/TwigViewProvider.php"
        click PhalconView "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/ViewProviders/PhalconViewProvider.php"
    end

    subgraph "Services"
        BrowserEvents["Browser Event System"]:::service
        URLState["URL State Management"]:::service
        PageRedirect["Page Redirect Service"]:::service
        click BrowserEvents "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/Services/BrowserEventsService.php"
        click URLState "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/Services/UrlStateManagerService.php"
        click PageRedirect "https://github.com/clickfwd/yoyo/blob/master/src/yoyo/Services/PageRedirectService.php"
    end

    Browser <--> HTMX
    HTMX <--> Request
    Request --> Response
    Response --> Browser
    
    Request --> CompManager
    CompManager --> CompResolver
    CompResolver --> BaseComp
    CompResolver --> AnonComp
    
    CompManager --> ViewInterface
    ViewInterface --> BaseView
    BaseView --> BladeView
    BaseView --> TwigView
    BaseView --> PhalconView
    
    BaseComp --> QueryString
    BaseComp --> BrowserEvents
    BaseComp --> URLState
    URLState --> PageRedirect
    
    CompManager --> Config

    classDef core fill:#2196F3,stroke:#1565C0,color:white
    classDef view fill:#4CAF50,stroke:#2E7D32,color:white
    classDef clientside fill:#FF9800,stroke:#EF6C00,color:white
    classDef service fill:#9C27B0,stroke:#6A1B9A,color:white
    classDef component fill:#607D8B,stroke:#37474F,color:white
    classDef http fill:#795548,stroke:#3E2723,color:white
```
