@geomelon/cameroon 0.0.0-stage → 1.0.0

package/ATTRIBUTION.md

@@ -0,0 +1,5 @@
+# Attribution
+
+This data is released under [CC0 1.0](./LICENSE) — no attribution is legally required.
+
+If you use it, a link back to [geomelon.dev](https://geomelon.dev) is appreciated but never required, the same posture Geomelon itself takes toward [Wikidata](https://www.wikidata.org), the ultimate source of this data.

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 1.0.0 - 2026-10-26
+
+Initial publish: 5098 cities, 12 regions.
+

package/LICENSE

@@ -0,0 +1,14 @@
+Creative Commons Legal Code
+
+CC0 1.0 Universal
+
+CC0 is a public domain dedication. To the extent possible under law, the
+author(s) have dedicated all copyright and related and neighboring rights to
+this data to the public domain worldwide. This work is published from a
+jurisdiction that recognizes the right to make dedications of copyright in
+the same manner as if it were a public domain work.
+
+You can copy, modify, distribute and perform the work, even for commercial
+purposes, all without asking permission.
+
+Full legal text: https://creativecommons.org/publicdomain/zero/1.0/legalcode

package/README.md

@@ -1,3 +1,72 @@
-# Temporary Holding Version
+# @geomelon/cameroon
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+City, region, and country data for **Cameroon** — 5098 cities across 12 regions, with names translated into 50 languages, sourced from Wikidata.
+
+## Install
+
+```bash
+npm install @geomelon/cameroon
+```
+
+## Usage
+
+```js
+const cameroon = require('@geomelon/cameroon')
+
+cameroon.cities({ name: '<your search prefix>' })   // matches the primary name or any translation
+cameroon.cities({ minPopulation: 1000000 })
+cameroon.city('Q1492')                              // by Geomelon id or Wikidata id
+cameroon.regions({ name: '<your search prefix>' })
+cameroon.country                                    // country-level fields
+cameroon.meta                                       // generatedAt, recordCount, license, source
+```
+
+## Filters
+
+`cities(filter?)`:
+| field | type | matches |
+|---|---|---|
+| `name` | `string` | case-insensitive prefix match against the primary name and every translation |
+| `regionId` | `string` | exact match |
+| `minPopulation` / `maxPopulation` | `number` | inclusive range |
+| `language` | `string` | city has a translation in this language |
+| `settlementType` | `string` | exact match against one of the city's settlement types |
+| `limit` | `number` | caps the result count |
+
+`regions(filter?)` supports `name` and `limit`.
+
+## Languages
+
+Names are translated into: Afrikaans (`af`), Albanian (`sq`), Arabic (`ar`), Armenian (`hy`), Azerbaijani (`az`), Bangla (`bn`), Basque (`eu`), Bokmål (`nb`), Bulgarian (`bg`), Catalan (`ca`), Chinese (`zh`), Croatian (`hr`), Czech (`cs`), Danish (`da`), Dutch (`nl`), English (`en`), Estonian (`et`), Finnish (`fi`), French (`fr`), Galician (`gl`), Georgian (`ka`), German (`de`), Hebrew (`he`), Hindi (`hi`), Hungarian (`hu`), Indonesian (`id`), Italian (`it`), Japanese (`ja`), Kazakh (`kk`), Korean (`ko`), Latvian (`lv`), Lithuanian (`lt`), Malay (`ms`), Modern Greek (`el`), Mongolian (`mn`), Persian (`fa`), Polish (`pl`), Portuguese (`pt`), Romanian (`ro`), Russian (`ru`), Serbian (`sr`), Slovak (`sk`), Slovene (`sl`), Spanish (`es`), Swedish (`sv`), Thai (`th`), Turkish (`tr`), Ukrainian (`uk`), Uzbek (`uz`), Vietnamese (`vi`).
+
+Coverage is capped to the 50 languages above — a widely-spoken top-50 set plus Cameroon's own official language(s) — to keep package size reasonable. The full long tail of rarer Wikidata-only translations isn't included.
+
+The raw JSON is still available directly if you'd rather roll your own queries:
+```js
+const data = require('@geomelon/cameroon/data.json')
+```
+
+## FAQ
+
+**Q: I want live geographical city data with multiple translations available, where do I get that from?**
+Use the Geomelon API — a live, searchable database of cities, countries, and regions — see the [API Docs](https://geomelon.dev/api-docs/) or try it on [RapidAPI](https://rapidapi.com/hom3chuk/api/geomelon).
+
+**Q: I want geo data on all countries, where do I get that?**
+For other countries as static npm packages, see the growing list at [Data Packages](https://geomelon.dev/data-packages/). If you want every country in one place right now instead of installing packages one at a time, use the [Geomelon API](https://geomelon.dev/api-docs/).
+
+**Q: I need a simple way to implement city autocomplete in multiple languages, how do I do that?**
+Use the [Geomelon Free City Autocomplete API](https://geomelon.dev/free-city-autocomplete-api/) — keyless, prefix search, pre-built for this exact use case.
+
+**Q: I want to integrate geo data into our product, what libraries can I use?**
+See [geomelon.dev/libraries](https://geomelon.dev/libraries/) for the full list. Official clients: [TypeScript](https://github.com/930m310n/typescript) (`geomelon` on npm), [Python](https://github.com/930m310n/python) (`geomelon` on PyPI), [React](https://github.com/930m310n/geomelon-react) (`geomelon-react` on npm).
+
+**Q: I want this data outside npm, e.g. for ML/NLP work?**
+The same per-country data is also published as a [Hugging Face dataset](https://huggingface.co/datasets/geomelon/cities) — one config per country, loaded with `datasets.load_dataset("geomelon/cities", "cameroon")`.
+
+## License
+
+The data (`data.json`) is dedicated to the public domain under [CC0 1.0](./LICENSE) — free to use, no attribution required. The loader code (`index.js`/`index.d.ts`) is MIT-licensed. See [ATTRIBUTION.md](./ATTRIBUTION.md) for the data's (optional) credit line.
+
+## Source
+
+Generated from [geomelon.dev](https://geomelon.dev) — an API and dataset built on [Wikidata](https://www.wikidata.org). See the full live API on [RapidAPI](https://rapidapi.com/hom3chuk/api/geomelon).