doxa-maps/library/data/README.md
Doxa Maps e19697673d
Some checks are pending
Deploy to GitHub Pages / build (push) Waiting to run
Deploy to GitHub Pages / deploy (push) Blocked by required conditions
Doxa Maps — the map bundler, 7 production plugins and the Experimental shelf
2026-09-25 20:07:59 +00:00

18 lines
1.1 KiB
Markdown

# library/data/ — static lookup tables
Small JSON tables inlined into any bundle that imports them (eager JSON imports, no runtime fetch).
Import as `@map/data/<file>.json`.
- **`langFamilyByLanguage.json`** — language label → family (`"Telugu": "Dravidian"`). Derives
`languageFamily` when the API returns `null` for `imb_language_family`. English labels only.
- **`langFamilyByIso.json`** — ISO 639-3 code → family (`"afr": "Indo-European"`). Used first,
because the API localizes language labels but `primary_language.value` (the ISO code) is stable
across locales. Generated by joining `langFamilyByLanguage.json` onto EN API rows by ISO code;
there is no regeneration script — re-run that join against a fresh EN pull if the language set
changes.
- **`iso-numeric-to-alpha2.json`** — ISO 3166-1 numeric → alpha-2 (`"840": "US"`). For joining
numeric-keyed geodata (world-atlas TopoJSON) to alpha-2 records. No code consumers yet — kept as a
ready lookup.
Consumers of the language tables: `composables/useMapData.js`, `useDoxaSearch.js`, `useMapLayers.js`,
`legends/useLanguageFamilyLegendData.js`.