# unovue/radix-vue architecture

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

- Interactive diagram: https://gitdiagram.com/unovue/radix-vue
- Repository: https://github.com/unovue/radix-vue

## Overview

##### Main Components of the System

a) Core Architecture:
- Component System
- Utilities Layer
- Shared Services
- Integration Layer

b) Component Categories:
- Navigation Components (NavigationMenu, Tabs, etc.)
- Overlay Components (Dialog, Popover, Toast, etc.)
- Form Components (Checkbox, RadioGroup, Switch, etc.)
- Layout Components (ScrollArea, Separator, etc.)
- Date Components (Calendar, DatePicker, etc.)

##### Relationships and Dependencies

Key relationships:
**Primitive Components → Composite Components → Higher-Order Components**
**↑**
**Shared Utilities**
**↑**
**Core Services**

##### Implementation Details

- Blue rectangles: Core components
- Green rectangles: Utility functions
- Yellow diamonds: Integration points
- Purple rectangles: Shared services

##### Specific Elements

a) Core Services Layer:
- Primitive Component System
- Context Management
- Focus Management
- Portal System
- Event Handling

b) Shared Utilities Layer:
- useForwardProps
- useEmitAsProps
- useId
- useDateFormatter
- Other shared hooks

c) Component Architecture:
- Component composition
- State management flow
- Event propagation
- Accessibility features

##### Integration Points

Integration with:
- Vue.js ecosystem
- Floating UI
- DOM APIs
- Accessibility APIs

##### Implementation Notes

Annotations for:
- Accessibility features
- Event handling
- State management
- Component composition
- Integration points

##### Integration capabilities

This system design should reflect Radix Vue's focus on:
- Accessibility
- Customization
- Component composition
- Framework integration
- Developer experience

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Core
        CS["Component System"]:::core
        UT["Utilities Layer"]:::core
        SS["Shared Services"]:::core
        IL["Integration Layer"]:::core
    end

    subgraph Components
        subgraph Navigation
            NM["Navigation Menu"]:::component
            TB["Tabs"]:::component
        end

        subgraph Overlay
            DG["Dialog"]:::component
            PO["Popover"]:::component
            TO["Toast"]:::component
        end

        subgraph Form
            CB["Checkbox"]:::component
            RG["Radio Group"]:::component
            SW["Switch"]:::component
        end

        subgraph Layout
            SA["Scroll Area"]:::component
            SP["Separator"]:::component
        end

        subgraph Date
            CA["Calendar"]:::component
            DP["Date Picker"]:::component
            DF["Date Field"]:::component
        end
    end

    subgraph CoreServices
        PCS["Primitive Component System"]:::service
        FM["Focus Management"]:::service
        PS["Portal System"]:::service
        EH["Event Handling"]:::service
    end

    subgraph SharedUtils
        FP["useForwardProps"]:::util
        EP["useEmitAsProps"]:::util
        UI["useId"]:::util
        DF2["useDateFormatter"]:::util
    end

    subgraph Integration
        VUE["Vue.js Ecosystem"]:::integration
        FUI["Floating UI"]:::integration
        DOM["DOM APIs"]:::integration
        A11Y["Accessibility APIs"]:::integration
    end

    CS --> Components
    UT --> Components
    SS --> Components
    IL --> Integration

    CoreServices --> CS
    SharedUtils --> CS

    %% Component Mappings
    click CS "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/Primitive/"
    click UT "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/shared/"
    click IL "https://github.com/unovue/radix-vue/tree/main/packages/plugins/"
    
    click NM "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/NavigationMenu/"
    click TB "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/Tabs/"
    click DG "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/Dialog/"
    click PO "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/Popover/"
    click TO "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/Toast/"
    click CB "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/Checkbox/"
    click RG "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/RadioGroup/"
    click SW "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/Switch/"
    click SA "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/ScrollArea/"
    click SP "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/Separator/"
    click CA "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/Calendar/"
    click DP "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/DatePicker/"
    click DF "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/DateField/"
    
    click PCS "https://github.com/unovue/radix-vue/blob/main/packages/radix-vue/src/Primitive/Primitive.ts"
    click FM "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/FocusScope/"
    click PS "https://github.com/unovue/radix-vue/tree/main/packages/radix-vue/src/Teleport/"
    click EH "https://github.com/unovue/radix-vue/blob/main/packages/radix-vue/src/shared/handleAndDispatchCustomEvent.ts"
    
    click FP "https://github.com/unovue/radix-vue/blob/main/packages/radix-vue/src/shared/useForwardProps.ts"
    click EP "https://github.com/unovue/radix-vue/blob/main/packages/radix-vue/src/shared/useEmitAsProps.ts"
    click UI "https://github.com/unovue/radix-vue/blob/main/packages/radix-vue/src/shared/useId.ts"
    click DF2 "https://github.com/unovue/radix-vue/blob/main/packages/radix-vue/src/shared/useDateFormatter.ts"

    classDef core fill:#2563eb,color:white
    classDef component fill:#16a34a,color:white
    classDef service fill:#9333ea,color:white
    classDef util fill:#ca8a04,color:white
    classDef integration fill:#dc2626,color:white
```
