# ui-awesome/html-core-component architecture

> Architecture diagram of the GitHub repository ui-awesome/html-core-component, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ui-awesome/html-core-component
- Repository: https://github.com/ui-awesome/html-core-component

## Overview

Html Core Component is an immutable PHP library for composing accessible HTML UI primitives. A consumer configures a concrete component or subclasses a base, supplies content and menu items, then renders HTML; menu-capable components delegate entry composition to Menu and Item. The graph preserves README capabilities, including alert, breadcrumb, dropdown, navbar, toggle, and direct menu/item use. Relationships for unsampled implementations are included only where the README or SOURCE INDEX documents them; other internal details are not inferred.

Main entry points: [`src/Menu.php`](https://github.com/ui-awesome/html-core-component/blob/main/src/Menu.php) (Menu), [`src/Base/BaseDropdown.php`](https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseDropdown.php) (Dropdown), [`src/Base/BaseBreadcrumb.php`](https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseBreadcrumb.php) (Breadcrumb), [`src/Item.php`](https://github.com/ui-awesome/html-core-component/blob/main/src/Item.php) (Menu Item)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Component API"]
end

subgraph group_navigation["Navigation Components"]
  node_breadcrumb["Breadcrumb<br/>[BaseBreadcrumb.php]"]
  node_breadcrumb_api["Breadcrumb Wrapper<br/>[Breadcrumb.php]"]
  node_dropdown["Dropdown<br/>[BaseDropdown.php]"]
  node_dropdown_api["Dropdown Wrapper<br/>[Dropdown.php]"]
  node_navbar["Navbar<br/>[BaseNavBar.php]"]
  node_navbar_api["Navbar Wrapper<br/>[NavBar.php]"]
end

subgraph group_controls["Alerts And Toggles"]
  node_alert["Alert<br/>[Alert.php]"]
  node_base_alert["Alert Base<br/>[BaseAlert.php]"]
  node_toggle["Toggle<br/>[BaseToggle.php]"]
  node_toggle_api["Toggle Wrapper<br/>[Toggle.php]"]
  node_toggle_interface["Toggle Contract"]
end

subgraph group_composition["Menu Composition"]
  node_menu["Menu<br/>[Menu.php]"]
  node_item["Menu Item<br/>[Item.php]"]
  node_attributes["Menu Attributes"]
end

subgraph group_shared["Reusable Behaviors"]
  node_has_toggle["Toggle Binding<br/>[HasToggle.php]"]
  node_activation["Path Activation"]
  node_current_path["Current Path<br/>[HasCurrentPath.php]"]
  node_item_template["Item Template"]
  node_prefix_items["Prefix Items<br/>[HasPrefixItems.php]"]
  node_suffix_items["Suffix Items<br/>[HasSuffixItems.php]"]
end

node_consumer(("PHP Consumer"))

node_consumer -->|"configures and renders"| node_alert
node_consumer -->|"configures and renders"| node_breadcrumb_api
node_consumer -->|"configures and renders"| node_dropdown_api
node_consumer -->|"configures and renders"| node_navbar_api
node_consumer -->|"configures and renders"| node_toggle_api
node_consumer -->|"configures and renders"| node_menu
node_consumer -->|"creates items"| node_item
node_alert -->|"extends"| node_base_alert
node_breadcrumb_api -->|"extends"| node_breadcrumb
node_dropdown_api -->|"extends"| node_dropdown
node_navbar_api -->|"extends"| node_navbar
node_toggle_api -->|"extends"| node_toggle
node_breadcrumb -->|"constructs"| node_menu
node_dropdown -->|"constructs"| node_menu
node_navbar -->|"uses"| node_menu
node_menu -->|"configures and renders"| node_item
node_item -->|"uses attribute traits"| node_attributes
node_menu -->|"uses attribute traits"| node_attributes
node_breadcrumb -->|"uses behavior"| node_activation
node_dropdown -->|"uses behavior"| node_activation
node_menu -->|"uses behavior"| node_activation
node_item -->|"uses behavior"| node_current_path
node_breadcrumb -->|"uses template behavior"| node_item_template
node_dropdown -->|"uses template behavior"| node_item_template
node_menu -->|"uses template behavior"| node_item_template
node_breadcrumb -->|"uses behavior"| node_prefix_items
node_dropdown -->|"uses behavior"| node_prefix_items
node_breadcrumb -->|"uses behavior"| node_suffix_items
node_dropdown -->|"uses behavior"| node_suffix_items
node_base_alert -->|"uses behavior"| node_has_toggle
node_dropdown -->|"uses behavior"| node_has_toggle
node_has_toggle -->|"binds and renders"| node_toggle_interface
node_toggle -->|"implements contract"| node_toggle_interface

click node_alert "https://github.com/ui-awesome/html-core-component/blob/main/src/Alert.php"
click node_base_alert "https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseAlert.php"
click node_breadcrumb "https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseBreadcrumb.php"
click node_breadcrumb_api "https://github.com/ui-awesome/html-core-component/blob/main/src/Breadcrumb.php"
click node_dropdown "https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseDropdown.php"
click node_dropdown_api "https://github.com/ui-awesome/html-core-component/blob/main/src/Dropdown.php"
click node_navbar "https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseNavBar.php"
click node_navbar_api "https://github.com/ui-awesome/html-core-component/blob/main/src/NavBar.php"
click node_menu "https://github.com/ui-awesome/html-core-component/blob/main/src/Menu.php"
click node_item "https://github.com/ui-awesome/html-core-component/blob/main/src/Item.php"
click node_attributes "https://github.com/ui-awesome/html-core-component/tree/main/src/Attribute"
click node_toggle "https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseToggle.php"
click node_toggle_api "https://github.com/ui-awesome/html-core-component/blob/main/src/Toggle.php"
click node_toggle_interface "https://github.com/ui-awesome/html-core-component/blob/main/src/ToggleInterface.php"
click node_has_toggle "https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/HasToggle.php"
click node_activation "https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/CanBeActivateItems.php"
click node_current_path "https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/HasCurrentPath.php"
click node_item_template "https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/HasTemplateLinkItem.php"
click node_prefix_items "https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/HasPrefixItems.php"
click node_suffix_items "https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/HasSuffixItems.php"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_breadcrumb,node_breadcrumb_api,node_dropdown,node_dropdown_api,node_navbar,node_navbar_api toneAmber
class node_alert,node_base_alert,node_toggle,node_toggle_api,node_toggle_interface toneMint
class node_menu,node_item,node_attributes toneRose
class node_has_toggle,node_activation,node_current_path,node_item_template,node_prefix_items,node_suffix_items,node_consumer toneIndigo
```

## Components

### Navigation Components

- [Breadcrumb](https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseBreadcrumb.php): `src/Base/BaseBreadcrumb.php`
- [Breadcrumb Wrapper](https://github.com/ui-awesome/html-core-component/blob/main/src/Breadcrumb.php): `src/Breadcrumb.php`
- [Dropdown](https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseDropdown.php): `src/Base/BaseDropdown.php`
- [Dropdown Wrapper](https://github.com/ui-awesome/html-core-component/blob/main/src/Dropdown.php): `src/Dropdown.php`
- [Navbar](https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseNavBar.php): `src/Base/BaseNavBar.php`
- [Navbar Wrapper](https://github.com/ui-awesome/html-core-component/blob/main/src/NavBar.php): `src/NavBar.php`

### Alerts And Toggles

- [Alert](https://github.com/ui-awesome/html-core-component/blob/main/src/Alert.php): `src/Alert.php`
- [Alert Base](https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseAlert.php): `src/Base/BaseAlert.php`
- [Toggle](https://github.com/ui-awesome/html-core-component/blob/main/src/Base/BaseToggle.php): `src/Base/BaseToggle.php`
- [Toggle Wrapper](https://github.com/ui-awesome/html-core-component/blob/main/src/Toggle.php): `src/Toggle.php`
- [Toggle Contract](https://github.com/ui-awesome/html-core-component/blob/main/src/ToggleInterface.php): `src/ToggleInterface.php`

### Menu Composition

- [Menu](https://github.com/ui-awesome/html-core-component/blob/main/src/Menu.php): `src/Menu.php`
- [Menu Item](https://github.com/ui-awesome/html-core-component/blob/main/src/Item.php): `src/Item.php`
- [Menu Attributes](https://github.com/ui-awesome/html-core-component/tree/main/src/Attribute): `src/Attribute`

### Reusable Behaviors

- [Toggle Binding](https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/HasToggle.php): `src/Mixin/HasToggle.php`
- [Path Activation](https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/CanBeActivateItems.php): `src/Mixin/CanBeActivateItems.php`
- [Current Path](https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/HasCurrentPath.php): `src/Mixin/HasCurrentPath.php`
- [Item Template](https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/HasTemplateLinkItem.php): `src/Mixin/HasTemplateLinkItem.php`
- [Prefix Items](https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/HasPrefixItems.php): `src/Mixin/HasPrefixItems.php`
- [Suffix Items](https://github.com/ui-awesome/html-core-component/blob/main/src/Mixin/HasSuffixItems.php): `src/Mixin/HasSuffixItems.php`

### Other components

- **PHP Consumer**

## Connections

- PHP Consumer → Alert: configures and renders (evidence: `README.md`)
- PHP Consumer → Breadcrumb Wrapper: configures and renders (evidence: `README.md`)
- PHP Consumer → Dropdown Wrapper: configures and renders (evidence: `README.md`)
- PHP Consumer → Navbar Wrapper: configures and renders (evidence: `README.md`)
- PHP Consumer → Toggle Wrapper: configures and renders (evidence: `README.md`)
- PHP Consumer → Menu: configures and renders (evidence: `README.md`)
- PHP Consumer → Menu Item: creates items (evidence: `README.md`)
- Alert → Alert Base: extends (evidence: `src/Alert.php`)
- Breadcrumb Wrapper → Breadcrumb: extends (evidence: `src/Breadcrumb.php`)
- Dropdown Wrapper → Dropdown: extends (evidence: `src/Dropdown.php`)
- Navbar Wrapper → Navbar: extends (evidence: `src/NavBar.php`)
- Toggle Wrapper → Toggle: extends (evidence: `src/Toggle.php`)
- Breadcrumb → Menu: constructs (evidence: `src/Base/BaseBreadcrumb.php`)
- Dropdown → Menu: constructs (evidence: `src/Base/BaseDropdown.php`)
- Navbar → Menu: uses (evidence: `src/Base/BaseNavBar.php`)
- Menu → Menu Item: configures and renders (evidence: `src/Menu.php`)
- Menu Item → Menu Attributes: uses attribute traits (evidence: `src/Item.php`)
- Menu → Menu Attributes: uses attribute traits (evidence: `src/Menu.php`)
- Breadcrumb → Path Activation: uses behavior (evidence: `src/Base/BaseBreadcrumb.php`)
- Dropdown → Path Activation: uses behavior (evidence: `src/Base/BaseDropdown.php`)
- Menu → Path Activation: uses behavior (evidence: `src/Menu.php`)
- Menu Item → Current Path: uses behavior (evidence: `src/Item.php`)
- Breadcrumb → Item Template: uses template behavior (evidence: `src/Base/BaseBreadcrumb.php`)
- Dropdown → Item Template: uses template behavior (evidence: `src/Base/BaseDropdown.php`)
- Menu → Item Template: uses template behavior (evidence: `src/Menu.php`)
- Breadcrumb → Prefix Items: uses behavior (evidence: `src/Base/BaseBreadcrumb.php`)
- Dropdown → Prefix Items: uses behavior (evidence: `src/Base/BaseDropdown.php`)
- Breadcrumb → Suffix Items: uses behavior (evidence: `src/Base/BaseBreadcrumb.php`)
- Dropdown → Suffix Items: uses behavior (evidence: `src/Base/BaseDropdown.php`)
- Alert Base → Toggle Binding: uses behavior (evidence: `src/Base/BaseAlert.php`)
- Dropdown → Toggle Binding: uses behavior (evidence: `src/Base/BaseDropdown.php`)
- Toggle Binding → Toggle Contract: binds and renders (evidence: `src/Mixin/HasToggle.php`)
- Toggle → Toggle Contract: implements contract (evidence: `src/Base/BaseToggle.php`)
