# robinloom/classcraft architecture

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

- Interactive diagram: https://gitdiagram.com/robinloom/classcraft
- Repository: https://github.com/robinloom/classcraft

## Overview

ClassCraft is a compile-time Java annotation-processor library. A developer annotates source types, constructors, or fields; Java’s compiler runs the matching processor, which emits companion source for use by the application. The five generator branches cover staged builders, DTOs, bidirectional mapping, copy-with-one-field methods, and structured logging. Marker annotations influence field selection, nullability, and masking. Processor excerpts are incomplete, so the graph shows only documented or indexed relationships and does not infer interactions among generators.

Main entry points: [`classcraft-annotations/src/main/java/com/robinloom/classcraft/annotations`](https://github.com/robinloom/classcraft/tree/master/classcraft-annotations/src/main/java/com/robinloom/classcraft/annotations) (Generator and field annotations), [`classcraft/src/main/java/com/robinloom/classcraft/processor/BuilderProcessor.java`](https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/BuilderProcessor.java) (Builder processor), [`classcraft/src/main/java/com/robinloom/classcraft/processor/DTOProcessor.java`](https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/DTOProcessor.java) (DTO processor), [`classcraft/src/main/java/com/robinloom/classcraft/processor/MapperProcessor.java`](https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/MapperProcessor.java) (Mapper processor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Annotations"]
  node_annotations["Generator and field annotations"]
end

subgraph group_generation["Source Generation"]
  node_builder["Builder processor"]
  node_dto["DTO processor<br/>[DTOProcessor.java]"]
  node_mapper["Mapper processor"]
  node_wither["Wither processor"]
  node_logger["Logger processor"]
  node_generated["Generated companions"]
end

subgraph group_use["Application Use"]
  node_application["Java application"]
end

node_developer(("Developer"))
node_compiler["Java compiler"]

node_developer -->|"annotates source"| node_annotations
node_annotations -->|"supplies annotations"| node_compiler
node_compiler -.->|"runs processor"| node_builder
node_compiler -.->|"runs processor"| node_dto
node_compiler -.->|"runs processor"| node_mapper
node_compiler -.->|"runs processor"| node_wither
node_compiler -.->|"runs processor"| node_logger
node_builder -->|"reads markers"| node_annotations
node_dto -->|"reads markers"| node_annotations
node_mapper -->|"reads markers"| node_annotations
node_wither -->|"reads markers"| node_annotations
node_logger -->|"reads markers"| node_annotations
node_builder -->|"emits builder"| node_generated
node_dto -->|"emits DTO"| node_generated
node_mapper -->|"emits mapper"| node_generated
node_wither -->|"emits wither"| node_generated
node_logger -->|"emits logger"| node_generated
node_generated -->|"used by"| node_application

click node_annotations "https://github.com/robinloom/classcraft/tree/master/classcraft-annotations/src/main/java/com/robinloom/classcraft/annotations"
click node_builder "https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/BuilderProcessor.java"
click node_dto "https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/DTOProcessor.java"
click node_mapper "https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/MapperProcessor.java"
click node_wither "https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/WitherProcessor.java"
click node_logger "https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/LoggerProcessor.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_annotations toneBlue
class node_builder,node_dto,node_mapper,node_wither,node_logger,node_generated toneAmber
class node_application toneMint
class node_developer,node_compiler toneIndigo
```

## Components

### Annotations

- [Generator and field annotations](https://github.com/robinloom/classcraft/tree/master/classcraft-annotations/src/main/java/com/robinloom/classcraft/annotations): `classcraft-annotations/src/main/java/com/robinloom/classcraft/annotations`

### Source Generation

- [Builder processor](https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/BuilderProcessor.java): `classcraft/src/main/java/com/robinloom/classcraft/processor/BuilderProcessor.java`
- [DTO processor](https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/DTOProcessor.java): `classcraft/src/main/java/com/robinloom/classcraft/processor/DTOProcessor.java`
- [Mapper processor](https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/MapperProcessor.java): `classcraft/src/main/java/com/robinloom/classcraft/processor/MapperProcessor.java`
- [Wither processor](https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/WitherProcessor.java): `classcraft/src/main/java/com/robinloom/classcraft/processor/WitherProcessor.java`
- [Logger processor](https://github.com/robinloom/classcraft/blob/master/classcraft/src/main/java/com/robinloom/classcraft/processor/LoggerProcessor.java): `classcraft/src/main/java/com/robinloom/classcraft/processor/LoggerProcessor.java`
- **Generated companions**

### Application Use

- **Java application**

### Other components

- **Developer**
- **Java compiler**

## Connections

- Developer → Generator and field annotations: annotates source (evidence: `README.md`)
- Generator and field annotations → Java compiler: supplies annotations (evidence: `README.md`)
- Java compiler → Builder processor: runs processor
- Java compiler → DTO processor: runs processor
- Java compiler → Mapper processor: runs processor
- Java compiler → Wither processor: runs processor
- Java compiler → Logger processor: runs processor
- Builder processor → Generator and field annotations: reads markers (evidence: `classcraft/src/main/java/com/robinloom/classcraft/processor/BuilderProcessor.java`)
- DTO processor → Generator and field annotations: reads markers (evidence: `classcraft/src/main/java/com/robinloom/classcraft/processor/DTOProcessor.java`)
- Mapper processor → Generator and field annotations: reads markers (evidence: `classcraft/src/main/java/com/robinloom/classcraft/processor/MapperProcessor.java`)
- Wither processor → Generator and field annotations: reads markers (evidence: `classcraft/src/main/java/com/robinloom/classcraft/processor/WitherProcessor.java`)
- Logger processor → Generator and field annotations: reads markers (evidence: `classcraft/src/main/java/com/robinloom/classcraft/processor/LoggerProcessor.java`)
- Builder processor → Generated companions: emits builder (evidence: `classcraft/src/main/java/com/robinloom/classcraft/processor/BuilderProcessor.java`)
- DTO processor → Generated companions: emits DTO (evidence: `README.md`)
- Mapper processor → Generated companions: emits mapper (evidence: `classcraft/src/main/java/com/robinloom/classcraft/processor/MapperProcessor.java`)
- Wither processor → Generated companions: emits wither (evidence: `classcraft/src/main/java/com/robinloom/classcraft/processor/WitherProcessor.java`)
- Logger processor → Generated companions: emits logger (evidence: `classcraft/src/main/java/com/robinloom/classcraft/processor/LoggerProcessor.java`)
- Generated companions → Java application: used by (evidence: `README.md`)
