# bahram-aliyev/moon.localization architecture

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

- Interactive diagram: https://gitdiagram.com/bahram-aliyev/moon.localization
- Repository: https://github.com/bahram-aliyev/moon.localization

## Overview

Moon.Localization is a .NET localization library with a shared resource model and ASP.NET, OWIN, and classic System.Web adapters. The main workflow configures an adapter, loads culture-specific dictionaries, selects resources for the current UI culture (falling back to a default), and exposes translations to server code or as a JavaScript resource object. JSON and XML dictionary formats and currency support are also present. Some unsampled loader and culture-middleware behavior is not linked where the excerpts do not establish the relationship.

Main entry points: [`src/Moon.Localization/Resources.cs`](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/Resources.cs) (Resource access), [`src/Moon.AspNet.Localization/Extensions/ApplicationBuilder.cs`](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.AspNet.Localization/Extensions/ApplicationBuilder.cs) (ASP.NET setup), [`src/Moon.Owin.Localization/Extensions/AppBuilder.cs`](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Owin.Localization/Extensions/AppBuilder.cs) (OWIN setup), [`src/Moon.Localization/IResourceDictionary.cs`](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/IResourceDictionary.cs) (Dictionary contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Resource core"]
  node_resources["Resource access<br/>[Resources.cs]"]
  node_aggregate["Culture aggregate"]
  node_contract["Dictionary contract"]
  node_loader["Dictionary loader"]
  node_not_found["Missing dictionary error"]
  node_culture_error["Culture mismatch error"]
  node_currency["Currency utilities<br/>[Currency.cs]"]
end

subgraph group_formats["Dictionary formats"]
  node_json_loader["JSON loader extension"]
  node_json_dictionary["JSON dictionary<br/>[JsonDictionary.cs]"]
  node_xml_loader["XML loader extension"]
  node_xml_dictionary["XML dictionary<br/>[XmlDictionary.cs]"]
end

subgraph group_modern["Middleware adapters"]
  node_asp_setup["ASP.NET setup"]
  node_asp_culture["Culture middleware"]
  node_asp_script["Script middleware"]
  node_owin_setup["OWIN setup<br/>[AppBuilder.cs]"]
  node_owin_culture["Culture middleware"]
  node_owin_script["Script middleware"]
end

subgraph group_classic["System.Web adapter"]
  node_web_culture["Culture module<br/>[CultureModule.cs]"]
  node_web_script["Script handler<br/>[ScriptHandler.cs]"]
end

node_app(("Application"))

node_app -->|"configures"| node_asp_setup
node_app -->|"configures"| node_owin_setup
node_asp_setup -->|"registers"| node_asp_culture
node_asp_setup -->|"maps script"| node_asp_script
node_owin_setup -->|"registers"| node_owin_culture
node_owin_setup -->|"maps script"| node_owin_script
node_asp_setup -->|"sets default"| node_resources
node_owin_setup -->|"sets default"| node_resources
node_asp_script -->|"reads translations"| node_resources
node_owin_script -->|"reads translations"| node_resources
node_web_script -->|"reads translations"| node_resources
node_loader -->|"loads dictionaries"| node_resources
node_resources -->|"stores by culture"| node_aggregate
node_resources -->|"returns dictionary"| node_contract
node_resources -->|"throws when absent"| node_not_found
node_aggregate -->|"implements"| node_contract
node_aggregate -->|"throws on mismatch"| node_culture_error
node_json_dictionary -->|"implements"| node_contract
node_xml_dictionary -->|"implements"| node_contract

click node_asp_setup "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.AspNet.Localization/Extensions/ApplicationBuilder.cs"
click node_asp_culture "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.AspNet.Localization/Middlewares/CultureMiddleware.cs"
click node_asp_script "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.AspNet.Localization/Middlewares/ScriptMiddleware.cs"
click node_owin_setup "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Owin.Localization/Extensions/AppBuilder.cs"
click node_owin_culture "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Owin.Localization/Middlewares/CultureMiddleware.cs"
click node_owin_script "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Owin.Localization/Middlewares/ScriptMiddleware.cs"
click node_web_culture "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Web.Localization/CultureModule.cs"
click node_web_script "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Web.Localization/ScriptHandler.cs"
click node_resources "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/Resources.cs"
click node_aggregate "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/AggregateDictionary.cs"
click node_contract "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/IResourceDictionary.cs"
click node_loader "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/DictionaryLoader.cs"
click node_not_found "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/DictionaryNotFoundException.cs"
click node_culture_error "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/CultureDoesNotMatchException.cs"
click node_currency "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/Currency.cs"
click node_json_loader "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization.Json/Extensions/DictionaryLoader.cs"
click node_json_dictionary "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization.Json/JsonDictionary.cs"
click node_xml_loader "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization.Xml/Extensions/DictionaryLoader.cs"
click node_xml_dictionary "https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization.Xml/XmlDictionary.cs"

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_resources,node_aggregate,node_contract,node_loader,node_not_found,node_culture_error,node_currency toneBlue
class node_json_loader,node_json_dictionary,node_xml_loader,node_xml_dictionary toneAmber
class node_asp_setup,node_asp_culture,node_asp_script,node_owin_setup,node_owin_culture,node_owin_script toneMint
class node_web_culture,node_web_script toneRose
class node_app toneIndigo
```

## Components

### Resource core

- [Resource access](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/Resources.cs): `src/Moon.Localization/Resources.cs`
- [Culture aggregate](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/AggregateDictionary.cs): `src/Moon.Localization/AggregateDictionary.cs`
- [Dictionary contract](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/IResourceDictionary.cs): `src/Moon.Localization/IResourceDictionary.cs`
- [Dictionary loader](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/DictionaryLoader.cs): `src/Moon.Localization/DictionaryLoader.cs`
- [Missing dictionary error](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/DictionaryNotFoundException.cs): `src/Moon.Localization/DictionaryNotFoundException.cs`
- [Culture mismatch error](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/CultureDoesNotMatchException.cs): `src/Moon.Localization/CultureDoesNotMatchException.cs`
- [Currency utilities](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization/Currency.cs): `src/Moon.Localization/Currency.cs`

### Dictionary formats

- [JSON loader extension](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization.Json/Extensions/DictionaryLoader.cs): `src/Moon.Localization.Json/Extensions/DictionaryLoader.cs`
- [JSON dictionary](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization.Json/JsonDictionary.cs): `src/Moon.Localization.Json/JsonDictionary.cs`
- [XML loader extension](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization.Xml/Extensions/DictionaryLoader.cs): `src/Moon.Localization.Xml/Extensions/DictionaryLoader.cs`
- [XML dictionary](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Localization.Xml/XmlDictionary.cs): `src/Moon.Localization.Xml/XmlDictionary.cs`

### Middleware adapters

- [ASP.NET setup](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.AspNet.Localization/Extensions/ApplicationBuilder.cs): `src/Moon.AspNet.Localization/Extensions/ApplicationBuilder.cs`
- [Culture middleware](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.AspNet.Localization/Middlewares/CultureMiddleware.cs): `src/Moon.AspNet.Localization/Middlewares/CultureMiddleware.cs`
- [Script middleware](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.AspNet.Localization/Middlewares/ScriptMiddleware.cs): `src/Moon.AspNet.Localization/Middlewares/ScriptMiddleware.cs`
- [OWIN setup](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Owin.Localization/Extensions/AppBuilder.cs): `src/Moon.Owin.Localization/Extensions/AppBuilder.cs`
- [Culture middleware](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Owin.Localization/Middlewares/CultureMiddleware.cs): `src/Moon.Owin.Localization/Middlewares/CultureMiddleware.cs`
- [Script middleware](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Owin.Localization/Middlewares/ScriptMiddleware.cs): `src/Moon.Owin.Localization/Middlewares/ScriptMiddleware.cs`

### System.Web adapter

- [Culture module](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Web.Localization/CultureModule.cs): `src/Moon.Web.Localization/CultureModule.cs`
- [Script handler](https://github.com/bahram-aliyev/moon.localization/blob/master/src/Moon.Web.Localization/ScriptHandler.cs): `src/Moon.Web.Localization/ScriptHandler.cs`

### Other components

- **Application**

## Connections

- Application → ASP.NET setup: configures (evidence: `src/Moon.AspNet.Localization/Extensions/ApplicationBuilder.cs`)
- Application → OWIN setup: configures (evidence: `src/Moon.Owin.Localization/Extensions/AppBuilder.cs`)
- ASP.NET setup → Culture middleware: registers (evidence: `src/Moon.AspNet.Localization/Extensions/ApplicationBuilder.cs`)
- ASP.NET setup → Script middleware: maps script (evidence: `src/Moon.AspNet.Localization/Extensions/ApplicationBuilder.cs`)
- OWIN setup → Culture middleware: registers (evidence: `src/Moon.Owin.Localization/Extensions/AppBuilder.cs`)
- OWIN setup → Script middleware: maps script (evidence: `src/Moon.Owin.Localization/Extensions/AppBuilder.cs`)
- ASP.NET setup → Resource access: sets default (evidence: `src/Moon.AspNet.Localization/Extensions/ApplicationBuilder.cs`)
- OWIN setup → Resource access: sets default (evidence: `src/Moon.Owin.Localization/Extensions/AppBuilder.cs`)
- Script middleware → Resource access: reads translations (evidence: `src/Moon.AspNet.Localization/Middlewares/ScriptMiddleware.cs`)
- Script middleware → Resource access: reads translations (evidence: `src/Moon.Owin.Localization/Middlewares/ScriptMiddleware.cs`)
- Script handler → Resource access: reads translations (evidence: `src/Moon.Web.Localization/ScriptHandler.cs`)
- Dictionary loader → Resource access: loads dictionaries (evidence: `src/Moon.Localization/DictionaryLoader.cs`)
- Resource access → Culture aggregate: stores by culture (evidence: `src/Moon.Localization/Resources.cs`)
- Resource access → Dictionary contract: returns dictionary (evidence: `src/Moon.Localization/Resources.cs`)
- Resource access → Missing dictionary error: throws when absent (evidence: `src/Moon.Localization/Resources.cs`)
- Culture aggregate → Dictionary contract: implements (evidence: `src/Moon.Localization/AggregateDictionary.cs`)
- Culture aggregate → Culture mismatch error: throws on mismatch (evidence: `src/Moon.Localization/AggregateDictionary.cs`)
- JSON dictionary → Dictionary contract: implements (evidence: `src/Moon.Localization.Json/JsonDictionary.cs`)
- XML dictionary → Dictionary contract: implements (evidence: `src/Moon.Localization.Xml/XmlDictionary.cs`)
