# idanatz/oneadapter architecture

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

- Interactive diagram: https://gitdiagram.com/idanatz/oneadapter
- Repository: https://github.com/idanatz/oneadapter

## Overview

##### Main Components Overview

a. Core Components:
- OneAdapter (Main Entry Point)
- Internal Adapter System
- Module Management System
- Event Hook System
- State Management System

b. Supporting Components:
- Diffing Engine
- Threading Management
- View Holder Management
- Selection Management
- Paging Management

##### Component Relationships

**┌─────────────────────────────────────────────────────────────────┐**
- OneAdapter                              │
- ┬─────────────────┬────────────────┬─────────────┘

- ┌───────────▼───────┐ ┌──────▼──────┐ ┌──────▼─────────┐
- Module System   │ │ Event Hooks │ │ Internal Adapter│
- ┬─────────┘ └──────┬──────┘ └────────┬───────┘

- ┌─────────▼──────────────────▼─────────────────▼───────────┐
- View Holder System                     │
- ┬───────────────────────────────┘

- ┌──────────▼──────────┐
- Diffing Engine   │
- ┘

##### Module Details Layer

**┌────────────────── Module System ──────────────────┐**

- ┌─────────────┐  ┌──────────┐  ┌─────────────┐  │
- Item Module  │  │ Emptiness│  │   Paging    │  │
- Module  │  │   Module    │  │
- ┘  └──────────┘  └─────────────┘  │

- ┌─────────────┐  ┌──────────┐                   │
- Selection   │  │  Custom  │                   │
- Module    │  │  Module  │                   │
- ┘  └──────────┘                   │
- ┘

##### Event Hooks Layer

A section for event hooks:

**┌────────────────── Event Hooks System ───────────────┐**

- ┌─────────────┐    ┌─────────────┐              │
- Click Events │    │Swipe Events │              │
- ┘    └─────────────┘              │

- ┌─────────────┐    ┌─────────────┐              │
- Custom Hooks │    │State Hooks  │              │
- ┘    └─────────────┘              │
- ┘

##### Integration Points

Integration points with:
- RecyclerView
- Data Binding
- View Binding
- DiffUtil

##### Threading Model

A section showing thread management:
- Main Thread Operations
- Background Thread Operations
- Thread Synchronization Points

##### Extension points

Remember to:
- Version information
- Notes for important implementation details
- Configuration points
- Public APIs vs internal components

This design will help developers understand both the high-level architecture and the detailed implementation aspects of the OneAdapter library.

## Diagram (Mermaid)

```mermaid
graph TB
    %% Main Components
    OneAdapter["OneAdapter"]:::main
    InternalAdapter["Internal Adapter"]:::core
    ModuleSystem["Module Management System"]:::core
    EventSystem["Event Hook System"]:::core
    StateSystem["State Management System"]:::core
    DiffingEngine["Diffing Engine"]:::core
    ViewHolderSystem["View Holder Management"]:::core
    
    %% Module System Components
    subgraph Modules
        ItemModule["Item Module"]:::module
        EmptinessModule["Emptiness Module"]:::module
        PagingModule["Paging Module"]:::module
        SelectionModule["Selection Module"]:::module
    end
    
    %% Event System Components
    subgraph Events
        EventHooks["Event Hooks"]:::event
        EventHooksMap["Event Hooks Map"]:::event
    end
    
    %% State Management Components
    subgraph States
        StatesManager["States"]:::state
        StatesMap["States Map"]:::state
    end
    
    %% View Holder Components
    subgraph ViewHolders
        OneViewHolder["One View Holder"]:::viewholder
        ViewBinder["View Binder"]:::viewholder
        ViewHolderCreator["View Holder Creator"]:::viewholder
    end
    
    %% Selection Components
    subgraph Selection
        SelectionHandler["Selection Handler"]:::selection
        SelectionObserver["Selection Observer"]:::selection
    end
    
    %% Paging Components
    subgraph Paging
        LoadMoreObserver["Load More Observer"]:::paging
        ScrollListener["Scroll Listener"]:::paging
    end
    
    %% Relationships
    OneAdapter --> InternalAdapter
    OneAdapter --> ModuleSystem
    OneAdapter --> EventSystem
    OneAdapter --> StateSystem
    
    ModuleSystem --> ItemModule
    ModuleSystem --> EmptinessModule
    ModuleSystem --> PagingModule
    ModuleSystem --> SelectionModule
    
    EventSystem --> EventHooks
    EventSystem --> EventHooksMap
    
    StateSystem --> StatesManager
    StateSystem --> StatesMap
    
    InternalAdapter --> ViewHolderSystem
    ViewHolderSystem --> OneViewHolder
    ViewHolderSystem --> ViewBinder
    ViewHolderSystem --> ViewHolderCreator
    
    InternalAdapter --> DiffingEngine
    InternalAdapter --> Selection
    InternalAdapter --> Paging
    
    Selection --> SelectionHandler
    Selection --> SelectionObserver
    
    Paging --> LoadMoreObserver
    Paging --> ScrollListener
    
    %% Click Events
    click OneAdapter "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/OneAdapter.kt"
    click InternalAdapter "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/internal/InternalAdapter.kt"
    click ModuleSystem "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/external/modules/Modules.kt"
    click ItemModule "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/external/modules/ItemModule.kt"
    click EmptinessModule "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/external/modules/EmptinessModule.kt"
    click PagingModule "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/external/modules/PagingModule.kt"
    click EventHooks "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/external/event_hooks/EventHooks.kt"
    click EventHooksMap "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/external/event_hooks/EventHooksMap.kt"
    click StatesManager "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/external/states/States.kt"
    click StatesMap "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/external/states/StatesMap.kt"
    click DiffingEngine "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/internal/diffing/OneDiffUtil.kt"
    click OneViewHolder "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/internal/holders/OneViewHolder.kt"
    click ViewBinder "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/internal/holders/ViewBinder.kt"
    click ViewHolderCreator "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/internal/holders_creators/ViewHolderCreator.kt"
    click SelectionHandler "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/internal/selection/OneSelectionHandler.kt"
    click SelectionObserver "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/internal/selection/SelectionObserver.kt"
    click LoadMoreObserver "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/internal/paging/LoadMoreObserver.kt"
    click ScrollListener "https://github.com/idanatz/OneAdapter/blob/master/oneadapter/src/main/java/com/idanatz/oneadapter/internal/paging/OneScrollListener.kt"
    
    %% Styles
    classDef main fill:#f9f,stroke:#333,stroke-width:4px
    classDef core fill:#bbf,stroke:#333,stroke-width:2px
    classDef module fill:#dfd,stroke:#333
    classDef event fill:#fdd,stroke:#333
    classDef state fill:#ddf,stroke:#333
    classDef viewholder fill:#ffd,stroke:#333
    classDef selection fill:#dff,stroke:#333
    classDef paging fill:#fdf,stroke:#333
```
