# pstachula-dev/react-micro-carousel architecture

> Architecture diagram of the GitHub repository pstachula-dev/react-micro-carousel, 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/pstachula-dev/react-micro-carousel
- Repository: https://github.com/pstachula-dev/react-micro-carousel

## Overview

##### Main Components Structure
a. Core Components
b. Hooks & Logic
c. Services & Utilities

##### Component Layer (Top Section)
- CarouselProvider (Top-level)
- Carousel
- Slide
- DotsGroup
- Dot
- NextButton
- PrevButton
- Counter

##### State Management & Context Layer (Middle Section)
- CarouselContext
- useCarouselReducer

##### Hooks Layer (Middle-Right Section)
Custom hooks:
- Custom Hooks
- useAutoplay
- useMergeConfig
- useIntersectionObserver
- useResizeObserver

##### Services Layer (Bottom Section)
Utility services:
- Services
- CarouselError
- Event Management
- Slider Calculations
- Type Definitions

##### Special Notations
- Lazy-loading capability
- Touch/mouse event handlers
- Tailwind CSS integration points

##### Important Features to Highlight
- Zero dependencies architecture
- Typescript support
- Lazy loading mechanism
- Touch/mouse event handling
- Responsive design support

##### Implementation Details
- Configuration flow from CarouselProvider
- Event propagation paths
- Intersection observer connections
- Resize observer integration

Key Considerations:

##### Demonstrate how lazy loading is implemented

Additional Notes:
- Package size information (2.6kB JS, 1.5kB CSS)
- Tailwind CSS integration points
- TypeScript type definitions flow

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph React_Simple_Headless_Carousel["React Simple Headless Carousel"]
        subgraph Core_Components["Core Components"]
            Provider["CarouselProvider"]:::component
            Carousel["Carousel"]:::component
            Slide["Slide"]:::component
            DotsGroup["DotsGroup"]:::component
            Dot["Dot"]:::component
            NextBtn["NextButton"]:::component
            PrevBtn["PrevButton"]:::component
            Counter["Counter"]:::component
            SliderBtn["SliderButton"]:::component
        end

        subgraph State_Management["State Management & Context"]
            Context["CarouselContext"]:::context
            Reducer["useCarouselReducer"]:::context
        end

        subgraph Custom_Hooks["Custom Hooks"]
            Autoplay["useAutoplay"]:::hook
            MergeConfig["useMergeConfig"]:::hook
            IntersectObs["useIntersectionObserver"]:::hook
            ResizeObs["useResizeObserver"]:::hook
        end

        subgraph Services["Services & Utilities"]
            Error["CarouselError"]:::service
            EventMgmt["Event Management"]:::service
            SliderCalc["Slider Calculations"]:::service
            Types["Type Definitions"]:::service
        end
    end

    %% Component Relationships
    Provider --> Carousel
    Carousel --> Slide
    Carousel --> DotsGroup
    DotsGroup --> Dot
    Carousel --> NextBtn
    Carousel --> PrevBtn
    Carousel --> Counter
    Carousel --> SliderBtn

    %% Context Relationships
    Provider --> Context
    Context --> Reducer
    Context -.-> Carousel
    Context -.-> DotsGroup
    Context -.-> NextBtn
    Context -.-> PrevBtn
    Context -.-> Counter

    %% Hook Relationships
    Carousel --> Autoplay
    Carousel --> MergeConfig
    Carousel --> IntersectObs
    Carousel --> ResizeObs

    %% Service Relationships
    Carousel --> EventMgmt
    Carousel --> SliderCalc
    Provider --> Error
    Provider --> Types

    %% Styling
    classDef component fill:#2196F3,stroke:#1565C0,color:white
    classDef context fill:#4CAF50,stroke:#2E7D32,color:white
    classDef hook fill:#FFC107,stroke:#FFA000,color:black
    classDef service fill:#9E9E9E,stroke:#616161,color:white

    %% Click Events
    click Provider "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/context/CarouselProvider.tsx"
    click Carousel "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/components/Carousel.tsx"
    click Slide "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/components/Slide.tsx"
    click DotsGroup "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/components/DotsGroup.tsx"
    click Dot "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/components/Dot.tsx"
    click NextBtn "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/components/NextButton.tsx"
    click PrevBtn "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/components/PrevButton.tsx"
    click Counter "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/components/Counter.tsx"
    click SliderBtn "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/components/SliderButton.tsx"
    click Context "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/context/CarouselContext.ts"
    click Reducer "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/hooks/useCarouselReducer.ts"
    click Autoplay "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/hooks/useAutoplay.ts"
    click MergeConfig "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/hooks/useMergeConfig.ts"
    click IntersectObs "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/hooks/useIntersectionObserver.ts"
    click ResizeObs "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/hooks/useResizeObserver.ts"
    click Error "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/services/CarouseError.ts"
    click EventMgmt "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/services/manageEvents.ts"
    click SliderCalc "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/services/getSliderClientX.ts"
    click Types "https://github.com/pstachula-dev/react-micro-carousel/blob/main/packages/react-simple-headless-carousel/src/lib/simple-headless-carousel/services/types.ts"
```
