# mannylopez/tinymoon architecture

> Architecture diagram of the GitHub repository mannylopez/tinymoon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mannylopez/tinymoon
- Repository: https://github.com/mannylopez/tinymoon

## Overview

##### Project Type Analysis
This is a specialized astronomical calculations library implemented as a Swift package. It's a standalone tool that can be integrated into iOS and macOS applications.

##### Main Components

A. Core Components:
- TinyMoon Namespace (Main Entry Point)
- Moon Calculator Engine
- Data Models
- Astronomical Constants

B. Public Interfaces:
- Standard Moon Phase Calculator
- Exact Moon Phase Calculator

##### Primary Layer Structure

**┌─ Application Layer ─────────────────────┐**
- (Consumer Applications)                │
- • iOS Apps                            │
- • macOS Apps                          │
- ┬────────────────────┘
- ↓
**┌─ Public Interface Layer ─────────────────┐**
- TinyMoon Namespace                      │
- • calculateMoonPhase()                  │
- • calculateExactMoonPhase()            │
- ┬────────────────────┘
- ↓
**┌─ Core Calculation Layer ─────────────────┐**
- • Moon Phase Engine                     │
- • Astronomical Constants                │
- • Julian Date Converter                 │
- ┬────────────────────┘
- ↓
**┌─ Data Model Layer ──────────────────────┐**
- • Moon                                 │
- • ExactMoon                           │
- • MoonPhase (Enum)                    │
- • MoonDetail                          │
- ┘

##### Component Relationships
- Data flow direction
- Dependencies between components
- Public API access patterns

- Standard Path: Date → calculateMoonPhase() → Moon
- Exact Path:   Date → calculateExactMoonPhase() → ExactMoon

- MoonPhase (Enum)
- ↑
- Moon ←→ MoonDetail
- ↑
- ExactMoon

##### Implementation Details
- That calculations are performed offline
- That the system is stateless
- Entry points for time zone handling
- Where astronomical constants are used

##### Additional Elements
- Version compatibility information
- Platform support (iOS/macOS)
- SPM integration points

##### The clear data flow from input (Date) to output (Moon/ExactMoon)

Remember to include a small section showing how the package integrates with consumer applications, but keep the main focus on the internal architecture of TinyMoon itself.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Application Layer"
        iOSApps["iOS Apps"]
        macOSApps["macOS Apps"]
    end

    subgraph "Public Interface Layer"
        TinyMoon["TinyMoon Namespace"]:::public
        CalcStandard["calculateMoonPhase()"]:::public
        CalcExact["calculateExactMoonPhase()"]:::public
    end

    subgraph "Core Calculation Layer"
        MoonEngine["Moon Phase Engine"]:::core
        AstroConst["Astronomical Constants"]:::core
        JulianConv["Julian Date Converter"]:::core
        UTCHandler["UTC Handler"]:::core
    end

    subgraph "Data Model Layer"
        Moon["Moon"]:::model
        ExactMoon["ExactMoon"]:::model
        MoonPhase["MoonPhase Enum"]:::model
        MoonDetail["MoonDetail"]:::model
    end

    %% Relationships
    iOSApps --> TinyMoon
    macOSApps --> TinyMoon
    TinyMoon --> CalcStandard
    TinyMoon --> CalcExact
    CalcStandard --> MoonEngine
    CalcExact --> MoonEngine
    MoonEngine --> AstroConst
    MoonEngine --> JulianConv
    MoonEngine --> UTCHandler
    MoonEngine --> Moon
    MoonEngine --> ExactMoon
    Moon --> MoonPhase
    ExactMoon --> MoonPhase
    Moon --> MoonDetail
    ExactMoon --> MoonDetail

    %% Styling
    classDef public fill:#3498db,stroke:#2980b9,color:white
    classDef core fill:#2ecc71,stroke:#27ae60,color:white
    classDef model fill:#f1c40f,stroke:#f39c12,color:black

    %% Click Events
    click TinyMoon "https://github.com/mannylopez/TinyMoon/blob/main/Sources/TinyMoon/TinyMoon.swift"
    click AstroConst "https://github.com/mannylopez/TinyMoon/blob/main/Sources/TinyMoon/TinyMoon+AstronomicalConstant.swift"
    click Moon "https://github.com/mannylopez/TinyMoon/blob/main/Sources/TinyMoon/TinyMoon+Moon.swift"
    click ExactMoon "https://github.com/mannylopez/TinyMoon/blob/main/Sources/TinyMoon/TinyMoon+ExactMoon.swift"
    click MoonPhase "https://github.com/mannylopez/TinyMoon/blob/main/Sources/TinyMoon/TinyMoon+MoonPhase.swift"
    click MoonDetail "https://github.com/mannylopez/TinyMoon/blob/main/Sources/TinyMoon/TinyMoon+MoonDetail.swift"
    click UTCHandler "https://github.com/mannylopez/TinyMoon/blob/main/Tests/TinyMoonTests/UTCTests.swift"

    %% Legend
    subgraph Legend
        PublicAPI["Public API"]:::public
        CoreComp["Core Components"]:::core
        DataModel["Data Models"]:::model
    end
```
