# obilet/cosmocalendar architecture

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

- Interactive diagram: https://gitdiagram.com/obilet/cosmocalendar
- Repository: https://github.com/obilet/cosmocalendar

## Overview

##### Project type and purpose
- This is an Android UI component library (CosmoCalendar) plus a sample Android app demonstrating its usage.
- Purpose: Provide a highly customizable calendar view with various selection modes, holiday pins, and styling options.

##### File structure
- Top-level Gradle projects:
- cosmocalendar/ (library module)
- sample/       (demo application module)
- Key packages in the library:
- adapter & viewholder – RecyclerView adapters for month/day cells
- view         – Custom views (CalendarView, MonthView, DayView)
- model        – Data models (Day, Month, DayOfWeek)
- selection    – Selection logic (Single, Multiple, Range, None)
- settings     – Appearance and behavior settings
- utils        – Date utilities, ID generators, snap helpers
- There is an AsyncTask (FetchMonthsAsyncTask) that internally generates the Month/Day data.
- Resources under res/ provide layouts, drawables, styles, and attributes.

##### README for additional insights
- Selection types & listeners (Observer pattern).
- Dialog wrapper around CalendarView (CalendarDialog).
- The sample app shows integration points and API usage.

a. Main components
- Sample App Module
- CosmoCalendar Library Module
– CalendarView (entry point)
– CalendarDialog
– Adapters & ViewHolders
– SelectionManagers (Single, Multiple, Range, None)
– SettingsManager & Appearance/Date/List/Selection Models
– DataGenerator (FetchMonthsAsyncTask)
– Utility classes
– Android Resources (layouts, drawables, attrs)
- Android Framework (RecyclerView, View system, Attributes)
b. Relationships & interactions
– Sample App → depends on → Library Module (Gradle dependency)
– CalendarView → uses → MonthAdapter → binds → MonthHolder/DayHolder → displays Day model
– CalendarView → triggers → FetchMonthsAsyncTask → produces → Month/Day data
– CalendarView → delegates selection events → SelectionManager → updates SelectionState → notifies → DateSelectedListener / OnDaysSelectionListener
– SettingsManager → supplies appearance/configuration to CalendarView & Adapters
– CalendarDialog → wraps CalendarView + exposes OnDaysSelectionListener
– Utility classes → support date calculations & snap behavior for RecyclerView
c. Architectural patterns & design principles
– Adapter pattern (RecyclerView Adapters & ViewHolders)
– Strategy pattern (SelectionManager implementations for SINGLE, MULTIPLE, RANGE, NONE)
– Observer/listener pattern (date‐selected, month‐change listeners)
– Separation of concerns:
- UI layer (views, adapters)
- Business logic (selection, settings)
- Data layer (models, AsyncTask)
- Utilities (shared helpers)
d. Key technologies & libraries
– Java, Android SDK
– AndroidX RecyclerView
– AsyncTask (for data generation)
– Custom attributes in attrs.xml
– Gradle build system

##### Detailed capture of essential architectural elements
- How SettingsManager configures both CalendarView & SelectionManagers
- Adapter/viewholder chain for rendering each month/day
- Demonstrate where resources (layouts, drawables, attrs) fit into view inflation

## Diagram (Mermaid)

```mermaid
flowchart TB
    classDef sample fill:#FFFFFF,stroke:#888888,stroke-dasharray: 5 5
    classDef ui fill:#D0E8FF,stroke:#0066CC
    classDef logic fill:#D0FFD0,stroke:#009900
    classDef data fill:#FFF8B0,stroke:#D6B800
    classDef util fill:#EEEEEE,stroke:#888888
    classDef res fill:#F0F0F0,stroke:#666666
    classDef framework fill:#F5F5F5,stroke:#AAAAAA,stroke-dasharray: 2 2

    SampleApp["Sample App Module"]:::sample
    click SampleApp "https://github.com/obilet/cosmocalendar/tree/master/sample/"

    subgraph "CosmoCalendar Library Module"
        direction TB

        subgraph "UI Components"
            direction TB
            CalendarView["CalendarView"]:::ui
            CalendarDialog["CalendarDialog"]:::ui
            MonthAdapter["MonthAdapter"]:::ui
            DaysAdapter["DaysAdapter"]:::ui
            ViewHolders["ViewHolders"]:::ui
            MonthView["MonthView"]:::ui
            DayView["DayView Variants"]:::ui
        end

        subgraph "Business Logic"
            direction TB
            SelectionManagers["SelectionManagers"]:::logic
            SettingsManager["SettingsManager"]:::logic
        end

        subgraph "Data Layer"
            direction TB
            FetchTask["FetchMonthsAsyncTask"]:::data
            DataModels["Day/Month/DayOfWeek Models"]:::data
        end

        subgraph "Utilities"
            direction TB
            Utils["Utility Classes"]:::util
        end

        subgraph "Resources"
            direction TB
            Resources["Layouts/Drawables/Attrs"]:::res
        end

    end

    AndroidFramework["Android Framework\n(RecyclerView, View system)"]:::framework

    %% Dependencies & Flows
    SampleApp -->|"uses"| DefaultActivity["DefaultCalendarActivity"]:::sample
    click DefaultActivity "https://github.com/obilet/cosmocalendar/blob/master/sample/src/main/java/com/applikeysolutions/cosmocalendar/sample/DefaultCalendarActivity.java"

    DefaultActivity -->|"inflates"| CalendarView
    DefaultActivity -->|"shows"| CalendarDialog

    CalendarView -->|"uses"| MonthAdapter
    CalendarView -->|"uses"| DaysAdapter
    MonthAdapter -->|"binds to"| ViewHolders
    CalendarView -->|"inflates"| MonthView
    MonthView -->|"renders"| DayView
    CalendarView -->|"triggers"| FetchTask
    FetchTask -->|"produces"| DataModels

    CalendarView -->|"delegates to"| SelectionManagers
    CalendarView -->|"configures via"| SettingsManager
    CalendarDialog -->|"wraps"| CalendarView

    SelectionManagers -->|"use strategy implementations"| SingleSM["SingleSelectionManager"] 
    SelectionManagers -->|"use strategy implementations"| MultipleSM["MultipleSelectionManager"] 
    SelectionManagers -->|"use strategy implementations"| RangeSM["RangeSelectionManager"] 
    SelectionManagers -->|"use strategy implementations"| NoneSM["NoneSelectionManager"] 

    SettingsManager -->|"manages"| AppearanceModel["AppearanceModel Interfaces"] 
    SettingsManager -->|"manages"| DateModel["DateModel Interfaces"] 
    SettingsManager -->|"manages"| ListsModel["ListsModel Interfaces"] 
    SettingsManager -->|"manages"| SelectionModel["SelectionModel Interfaces"] 

    Utils -->|"include"| DateUtils["DateUtils"] 
    Utils -->|"include"| ViewIDGen["ViewIDGenerator"] 
    Utils -->|"include"| SnapHelper["GravityPagerSnapHelper"] 

    CalendarView --> AndroidFramework
    MonthAdapter --> AndroidFramework
    DaysAdapter --> AndroidFramework

    %% Click events for library components
    click CalendarView "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/view/CalendarView.java"
    click CalendarDialog "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/dialog/CalendarDialog.java"
    click MonthAdapter "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/adapter/MonthAdapter.java"
    click DaysAdapter "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/adapter/DaysAdapter.java"
    click ViewHolders "https://github.com/obilet/cosmocalendar/tree/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/adapter/viewholder/"
    click SingleSM "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/selection/SingleSelectionManager.java"
    click MultipleSM "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/selection/MultipleSelectionManager.java"
    click RangeSM "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/selection/RangeSelectionManager.java"
    click NoneSM "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/selection/NoneSelectionManager.java"
    click SettingsManager "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/settings/SettingsManager.java"
    click AppearanceModel "https://github.com/obilet/cosmocalendar/tree/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/settings/appearance/"
    click DateModel "https://github.com/obilet/cosmocalendar/tree/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/settings/date/"
    click ListsModel "https://github.com/obilet/cosmocalendar/tree/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/settings/lists/"
    click SelectionModel "https://github.com/obilet/cosmocalendar/tree/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/settings/selection/"
    click FetchTask "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/FetchMonthsAsyncTask.java"
    click DataModels "https://github.com/obilet/cosmocalendar/tree/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/model/"
    click DateUtils "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/utils/DateUtils.java"
    click ViewIDGen "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/utils/ViewIDGenerator.java"
    click SnapHelper "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/utils/snap/GravityPagerSnapHelper.java"
    click MonthView "https://github.com/obilet/cosmocalendar/blob/master/cosmocalendar/src/main/java/com/applikeysolutions/cosmocalendar/view/MonthView.java"

    %% Styles
    class SampleApp,DefaultActivity sample
    class CalendarView,CalendarDialog,MonthAdapter,DaysAdapter,ViewHolders,MonthView,DayView ui
    class SelectionManagers,SettingsManager,SingleSM,MultipleSM,RangeSM,NoneSM,AppearanceModel,DateModel,ListsModel,SelectionModel logic
    class FetchTask,DataModels data
    class Utils,DateUtils,ViewIDGen,SnapHelper util
    class Resources res
    class AndroidFramework framework
```
