# chimigit/bhutan-regions architecture

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

- Interactive diagram: https://gitdiagram.com/chimigit/bhutan-regions
- Repository: https://github.com/chimigit/bhutan-regions

## Overview

Bhutan Regions is a small data-and-lookup library: a consumer calls its exported API for lists, bilingual names, district–sub-district relationships, counts, validation, or complete regional data. The API implementation reads the bundled administrative dataset directly and computes results in memory; there is no external service or persistent store. The README documents the full capability set, while the source excerpt shows the API-to-data dependency. This compact runtime has no separate domain stages; unsampled data details are not expanded.

Main entry points: [`src/index.js`](https://github.com/chimigit/bhutan-regions/blob/main/src/index.js) (Region Queries), [`src/data.js`](https://github.com/chimigit/bhutan-regions/blob/main/src/data.js) (Bilingual Region Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Lookup API"]
  node_lookup["Region Queries<br/>[index.js]"]
end

subgraph group_dataset["Regional Dataset"]
  node_regions["Bilingual Region Data<br/>[data.js]"]
end

node_consumer(("Library Consumer"))

node_consumer -->|"calls exported API"| node_lookup
node_lookup -->|"reads data"| node_regions

click node_lookup "https://github.com/chimigit/bhutan-regions/blob/main/src/index.js"
click node_regions "https://github.com/chimigit/bhutan-regions/blob/main/src/data.js"

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_lookup toneBlue
class node_regions toneAmber
class node_consumer toneIndigo
```

## Components

### Lookup API

- [Region Queries](https://github.com/chimigit/bhutan-regions/blob/main/src/index.js): `src/index.js`

### Regional Dataset

- [Bilingual Region Data](https://github.com/chimigit/bhutan-regions/blob/main/src/data.js): `src/data.js`

### Other components

- **Library Consumer**

## Connections

- Library Consumer → Region Queries: calls exported API (evidence: `README.md`)
- Region Queries → Bilingual Region Data: reads data (evidence: `src/index.js`)
