# vpuzdriak/mapgen architecture

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

- Interactive diagram: https://gitdiagram.com/vpuzdriak/mapgen
- Repository: https://github.com/vpuzdriak/mapgen

## Overview

Mapgen is a .NET compile-time object mapper: users declare mapper methods and configuration, then generated mapping code provides type-safe conversions without runtime reflection. The principal workflow is mapper declaration → configuration parsing and mapping analysis → generated mapper and extension methods; diagnostics and code fixes support correction. The README documents custom, multi-parameter, collection, ignored-member, and enum mapping capabilities. Internal call evidence is limited to the supplied excerpts and SOURCE INDEX, so uncertain generator-stage links are marked dashed.

Main entry points: [`src/Mapgen.Analyzer/Mapper/MappingGenerator.cs`](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MappingGenerator.cs) (Mapping generator), [`src/Mapgen.Analyzer/Mapper/MapperTemplateEngine.cs`](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MapperTemplateEngine.cs) (Mapper template engine), [`src/Mapgen.Analyzer/Mapper/MappingParser.cs`](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MappingParser.cs) (Configuration parser), [`src/Mapgen.Analyzer/Mapper/MappingConfigurationMethods.cs`](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MappingConfigurationMethods.cs) (Mapping configuration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Mapper authoring"]
  node_mapper_decl["Mapper declaration"]
  node_config_api["Mapping configuration"]
end

subgraph group_analysis["Mapping analysis"]
  node_parser["Configuration parser<br/>[MappingParser.cs]"]
  node_metadata["Mapping metadata<br/>[Metadata]"]
  node_strategies["Mapping strategies"]
  node_type_checks["Type compatibility"]
end

subgraph group_generation["Code generation"]
  node_mapping_gen["Mapping generator"]
  node_mapper_template["Mapper template engine"]
  node_extension_info["Extension metadata"]
  node_extension_template["Extension generator"]
  node_generated_mapper["Generated mapper code"]
  node_extension_methods["Generated extensions"]
end

subgraph group_feedback["IDE feedback"]
  node_diagnostics["Mapping diagnostics"]
  node_diagnostic_ids["Diagnostic identifiers<br/>[DiagnosticIds.cs]"]
  node_reporter["Diagnostic reporter"]
  node_code_fixes["Code fixes<br/>[CodeFixes]"]
end

node_developer(("Mapper author"))

node_developer -->|"declares"| node_mapper_decl
node_developer -->|"configures"| node_config_api
node_mapper_decl -.->|"compile-time analysis"| node_mapping_gen
node_config_api -->|"parses calls"| node_parser
node_parser -->|"builds metadata"| node_metadata
node_parser -->|"recognizes methods"| node_config_api
node_strategies -->|"reads metadata"| node_metadata
node_strategies -->|"checks types"| node_type_checks
node_mapping_gen -.->|"analyzes configuration"| node_parser
node_mapping_gen -.->|"selects mappings"| node_strategies
node_mapping_gen -.->|"generates mapper"| node_mapper_template
node_mapper_template -->|"renders metadata"| node_metadata
node_mapper_template -.->|"emits code"| node_generated_mapper
node_mapper_template -->|"renders configuration helpers"| node_config_api
node_extension_template -->|"renders methods"| node_extension_info
node_extension_template -->|"emits wrappers"| node_extension_methods
node_mapping_gen -.->|"generates extensions"| node_extension_template
node_metadata -->|"stores diagnostics"| node_diagnostics
node_diagnostics -->|"uses identifiers"| node_diagnostic_ids
node_mapping_gen -.->|"reports issues"| node_reporter
node_code_fixes -->|"handles diagnostics"| node_diagnostic_ids

click node_mapper_decl "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/AttributeGenerator.cs"
click node_config_api "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MappingConfigurationMethods.cs"
click node_parser "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MappingParser.cs"
click node_metadata "https://github.com/vpuzdriak/mapgen/tree/main/src/Mapgen.Analyzer/Mapper/Metadata"
click node_strategies "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/Strategies/ConstructorMappingStrategy.cs"
click node_type_checks "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/Utils/TypeCompatibilityChecker.cs"
click node_mapping_gen "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MappingGenerator.cs"
click node_mapper_template "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MapperTemplateEngine.cs"
click node_extension_info "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Extensions/ExtensionMethodInfo.cs"
click node_extension_template "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Extensions/MappingExtensionsTemplateEngine.cs"
click node_diagnostics "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/Diagnostics/MapperDiagnostic.cs"
click node_diagnostic_ids "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/Diagnostics/DiagnosticIds.cs"
click node_reporter "https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/Diagnostics/MapperDiagnosticsReporter.cs"
click node_code_fixes "https://github.com/vpuzdriak/mapgen/tree/main/src/Mapgen.Analyzer/Mapper/CodeFixes"

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_mapper_decl,node_config_api toneBlue
class node_parser,node_metadata,node_strategies,node_type_checks toneAmber
class node_mapping_gen,node_mapper_template,node_extension_info,node_extension_template,node_generated_mapper,node_extension_methods toneMint
class node_diagnostics,node_diagnostic_ids,node_reporter,node_code_fixes toneRose
class node_developer toneIndigo
```

## Components

### Mapper authoring

- [Mapper declaration](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/AttributeGenerator.cs): `src/Mapgen.Analyzer/Mapper/AttributeGenerator.cs`
- [Mapping configuration](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MappingConfigurationMethods.cs): `src/Mapgen.Analyzer/Mapper/MappingConfigurationMethods.cs`

### Mapping analysis

- [Configuration parser](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MappingParser.cs): `src/Mapgen.Analyzer/Mapper/MappingParser.cs`
- [Mapping metadata](https://github.com/vpuzdriak/mapgen/tree/main/src/Mapgen.Analyzer/Mapper/Metadata): `src/Mapgen.Analyzer/Mapper/Metadata`
- [Mapping strategies](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/Strategies/ConstructorMappingStrategy.cs): `src/Mapgen.Analyzer/Mapper/Strategies/ConstructorMappingStrategy.cs`
- [Type compatibility](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/Utils/TypeCompatibilityChecker.cs): `src/Mapgen.Analyzer/Mapper/Utils/TypeCompatibilityChecker.cs`

### Code generation

- [Mapping generator](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MappingGenerator.cs): `src/Mapgen.Analyzer/Mapper/MappingGenerator.cs`
- [Mapper template engine](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/MapperTemplateEngine.cs): `src/Mapgen.Analyzer/Mapper/MapperTemplateEngine.cs`
- [Extension metadata](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Extensions/ExtensionMethodInfo.cs): `src/Mapgen.Analyzer/Extensions/ExtensionMethodInfo.cs`
- [Extension generator](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Extensions/MappingExtensionsTemplateEngine.cs): `src/Mapgen.Analyzer/Extensions/MappingExtensionsTemplateEngine.cs`
- **Generated mapper code**
- **Generated extensions**

### IDE feedback

- [Mapping diagnostics](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/Diagnostics/MapperDiagnostic.cs): `src/Mapgen.Analyzer/Mapper/Diagnostics/MapperDiagnostic.cs`
- [Diagnostic identifiers](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/Diagnostics/DiagnosticIds.cs): `src/Mapgen.Analyzer/Mapper/Diagnostics/DiagnosticIds.cs`
- [Diagnostic reporter](https://github.com/vpuzdriak/mapgen/blob/main/src/Mapgen.Analyzer/Mapper/Diagnostics/MapperDiagnosticsReporter.cs): `src/Mapgen.Analyzer/Mapper/Diagnostics/MapperDiagnosticsReporter.cs`
- [Code fixes](https://github.com/vpuzdriak/mapgen/tree/main/src/Mapgen.Analyzer/Mapper/CodeFixes): `src/Mapgen.Analyzer/Mapper/CodeFixes`

### Other components

- **Mapper author**

## Connections

- Mapper author → Mapper declaration: declares
- Mapper author → Mapping configuration: configures
- Mapper declaration → Mapping generator: compile-time analysis
- Mapping configuration → Configuration parser: parses calls (evidence: `src/Mapgen.Analyzer/Mapper/MappingParser.cs`)
- Configuration parser → Mapping metadata: builds metadata (evidence: `src/Mapgen.Analyzer/Mapper/MappingParser.cs`)
- Configuration parser → Mapping configuration: recognizes methods (evidence: `src/Mapgen.Analyzer/Mapper/MappingParser.cs`)
- Mapping strategies → Mapping metadata: reads metadata (evidence: `src/Mapgen.Analyzer/Mapper/Strategies/ConstructorMappingStrategy.cs`)
- Mapping strategies → Type compatibility: checks types (evidence: `src/Mapgen.Analyzer/Mapper/Strategies/ConstructorMappingStrategy.cs`)
- Mapping generator → Configuration parser: analyzes configuration
- Mapping generator → Mapping strategies: selects mappings
- Mapping generator → Mapper template engine: generates mapper
- Mapper template engine → Mapping metadata: renders metadata (evidence: `src/Mapgen.Analyzer/Mapper/MapperTemplateEngine.cs`)
- Mapper template engine → Generated mapper code: emits code
- Mapper template engine → Mapping configuration: renders configuration helpers (evidence: `src/Mapgen.Analyzer/Mapper/MapperTemplateEngine.cs`)
- Extension generator → Extension metadata: renders methods (evidence: `src/Mapgen.Analyzer/Extensions/MappingExtensionsTemplateEngine.cs`)
- Extension generator → Generated extensions: emits wrappers (evidence: `src/Mapgen.Analyzer/Extensions/MappingExtensionsTemplateEngine.cs`)
- Mapping generator → Extension generator: generates extensions
- Mapping metadata → Mapping diagnostics: stores diagnostics (evidence: `src/Mapgen.Analyzer/Mapper/Metadata/MapperMethodMetadata.cs`)
- Mapping diagnostics → Diagnostic identifiers: uses identifiers (evidence: `src/Mapgen.Analyzer/Mapper/Diagnostics/MapperDiagnostic.cs`)
- Mapping generator → Diagnostic reporter: reports issues
- Code fixes → Diagnostic identifiers: handles diagnostics (evidence: `src/Mapgen.Analyzer/Mapper/CodeFixes/AmbiguousConstructorCodeFixProvider.cs`)
