@johnmorrisdotca/kuni 1.6.0 → 1.6.2

package/CHANGELOG.md

@@ -6,6 +6,31 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [1.6.2] - 2026-11-11
+
+### Added
+
+- **Cities ranked by their metropolitan area.** Each city has `metro`: the metropolitan area round it where one is named for it (`{ id, name, population, populationDate }`, else `null`): a Canadian city's census metropolitan area or agglomeration by Statistics Canada (2021 Census, id `statcan:<DGUID>`), any other's from Wikidata (CC0). The tiers, each country's file and `searchPlaces` rank a city by its metro's people where it has one, else by its own: Canada's first three are Toronto, Montreal and Vancouver, the United States' New York City, France's Paris, the Philippines' Manila. A tier still holds a city by its own `population`.
+- **`@johnmorrisdotca/kuni/zones`**: `subdivisionTimeZone(code)`, the IANA zone of a first-level subdivision (Wikidata's where it names one of the country's zones alone, else estimated and said so), and `timeZoneAt(country, point)`, the zone at a point (the country's one zone, or the zone of the subdivision whose capital is nearest, estimated). kuni has no boundaries, so a point near the edge of a zone can be given its neighbour's.
+- **`capitalZone`** in `/facts`: the IANA zone each capital keeps (245 countries; Astana's Asia/Almaty and Kosovo's Europe/Belgrade set by name, with the reason in docs/facts.md).
+
+### Fixed
+
+- **Units below a district are not cities**: upazilas, thanas, tehsils, talukas, municipal okrugs, subdistricts, wards, unions, arrondissements, county boroughs, regional councils, communes, the French métropoles and the Swiss cantons are left out (532 + 5 ids). Bangladesh's cities are now its 101 towns.
+- **Civil townships round a city are not cities**: in Iowa, Illinois, Indiana, Kansas, Missouri, Nebraska and the Dakotas, where a township is a civil unit of its county with cities inside it, every township is left out (Kaw Township, round Kansas City; Thornton Township, round South Holland and Harvey); elsewhere a township is the municipality people live in (Toms River, New Jersey; Clinton Township, Michigan) and stays.
+- Every id that leaves answers through `cityById` and `byId` with the city it belongs to, or with `null`. The alias table is written small, so the core of `/cities` stays under 24 KB.
+
+
+## [1.6.1] - 2026-11-11
+
+### Fixed
+
+- **Areas left out of the cities.** Metropolitan Toronto was Canada's first city. Names that start Metropolitan, Metro, Metropolis of, Commune or Sectorul, name a regional municipality or a "State of", or end in Region, Region of …, Capital City, Urban Corridor or New Area are areas and units, not cities, and are left out (a name with a comma, a town told apart by its region, stays). A Natural Earth place whose Wikidata item is an area while the city of its name stands beside it now joins the city (Jamalpur, not Jamalpur District; Kristiansand, not Kristiansand Municipality). Moro, Papua New Guinea, given 6.3 million people, is left out by name. 30,616 cities (from 30,668). Ids never change: the 52 ids of 1.6.0 that are no city now answer through `cityById` and `byId` with the city they became (Metropolitan Toronto with Toronto, Metro Manila with Manila, Chișinău's sectors with Chișinău), or with `null` for a region that is no city.
+
+### Changed
+
+- **`cityById` fetches one country for a town.** A city that is in no tier file (no capital, under 100,000 people) is found through a small index of which country each is in, so only that country's file is fetched, not all 243.
+
 ## [1.6.0] - 2026-11-11
 
 - **`/cities`**: the world's cities, in tiers, so that a page pays only for what it uses. `@johnmorrisdotca/kuni/cities/capitals` (every capital of a country or a subdivision, of any size), `/cities/1m` and `/cities/100k` (every city of a million people or more, and of 100,000 or more, capitals included), `loadCities("15k")` (15,000 or more, made from the countries' own files), `@johnmorrisdotca/kuni/cities/<code>` (one country's cities, every tier together) and `@johnmorrisdotca/kuni/cities`, the core: `citySet` (by id, by country, by subdivision, `nearest` and `within`), `loadCities(...tiers)`, `citiesOf(code)` and `cityById(id)`. **`@johnmorrisdotca/kuni/places`**, a new entry for what a place chooser asks: `continents()`, `countriesOf(continent)` and `searchPlaces(text, { lang, limit })` over English, Japanese and native names, with accents and kana folded, ranked by population. Kuni draws no chooser: a page builds its own. A city has its Wikidata id (or `ne:<number>` where only Natural Earth has it), its name in English, Japanese and in the official language of its country, continent, country, latitude and longitude, population with its date, first-level subdivision, capital flags (`national`, one for each country; `alternate`, for another seat of government such as Cape Town or Kyoto; `subdivision`) with the codes it is the capital of, and the source of each fact. Ids never change between releases: a merged id answers with the city it became. The data is Wikidata's (CC0) with Natural Earth's populated places (public domain) filling what Wikidata lacks; areas, wards, arrondissements and duplicate items are left out; `pnpm data:cities` takes a new snapshot by hand. docs/cities.md counts what is in each tier and what is missing; the new guide is "Use the cities".

package/NOTICE.md

@@ -103,6 +103,23 @@ or a subdivision, and the items Natural Earth's places name. For each, the Engli
 label, the coordinates, the country, the populations with their dates and the ISO 3166-2 codes of the places it is in.
 No Wikipedia text is used.
 
+A city's metropolitan area (`metro` on each city) comes from a third Wikidata snapshot
+(`data-sources/wikidata-metros-<day>.json`), CC0 on the same terms (read on 2026-11-11), asked for by
+`scripts/fetch-metros.ts`: the items that are a metropolitan or urban area, the links between them and the cities, their
+English labels and their populations with dates.
+
+A Canadian city's metropolitan area is Statistics Canada's census metropolitan area or census agglomeration, its 2021
+population from Table 98-10-0005-01, kept in `data-sources/statcan-cma-2021.json` by `scripts/fetch-statcan.ts`, under the
+Statistics Canada Open Licence (https://www.statcan.gc.ca/en/reference/licence, read on 2026-11-11):
+
+> Adapted from Statistics Canada, Table 98-10-0005-01, Population and dwelling counts: Canada, provinces and territories,
+> census metropolitan areas and census agglomerations, 2021 Census, reference date 2021-05-11. This does not constitute
+> an endorsement by Statistics Canada of this product.
+
+The time zones (`/zones`, and `capitalZone` in `/facts`) are from IANA's tzdb zone.tab (public domain, below) and a
+fourth Wikidata snapshot (`data-sources/wikidata-zones-<day>.json`, CC0 on the same terms, read on 2026-11-11), asked for
+by `scripts/fetch-zones.ts`: the IANA ids (P6687) of the zones each first-level subdivision is in (P421).
+
 ## Natural Earth's populated places
 
 Natural Earth's 10m Populated Places, version 5.1.2 (https://www.naturalearthdata.com/, public domain: "No permission

package/README.md

@@ -144,6 +144,7 @@ It ships ES modules and CommonJS, with types for both and `sideEffects: false`.
 | `@johnmorrisdotca/kuni/load` | `loadSubdivisions(code)`, one dynamic import per country | 97.6 kB min+gzip |
 | `@johnmorrisdotca/kuni/subdivisions` | All 5,050 subdivisions and the subdivision lookups | 88.4 kB min+gzip |
 | `@johnmorrisdotca/kuni/facts` | Every country's population, area, coordinates, borders, driving side and conventions | 8.6 kB min+gzip |
+| `@johnmorrisdotca/kuni/zones` | A subdivision's IANA time zone, and the zone at a point in a country | 26.9 kB min+gzip |
 | `@johnmorrisdotca/kuni/subdivision-facts` | `loadSubdivisionFacts(code)`, one dynamic import per country | 161.1 kB min+gzip |
 | `@johnmorrisdotca/kuni/subdivision-facts/<code>` | One country's subdivision facts (`/subdivision-facts/jp`) | 0.4–7.3 kB; Japan 2.4 kB |
 | `@johnmorrisdotca/kuni/groupings` | The 107 groupings and their lookups | 15.9 kB min+gzip |
@@ -416,6 +417,7 @@ The [API reference](https://johnmorrisdotca.github.io/kuni/api.html) lists every
 | `@johnmorrisdotca/kuni/subdivisions/<code>` | the country's list as the default export and as `SUBDIVISIONS` |
 | `@johnmorrisdotca/kuni/load` | `loadSubdivisions` and the type `Subdivision` |
 | `@johnmorrisdotca/kuni/facts` | `facts`, `allFacts`, `distanceKm`, `FACTS_READ`, and the types `CountryFacts`, `LatLon`, `DrivingSide`, `WeekStart`, `MeasurementSystem`, `PaperSize` and `HourCycle` |
+| `@johnmorrisdotca/kuni/zones` | `subdivisionTimeZone`, `timeZoneAt`, and the type `ZoneAnswer` |
 | `@johnmorrisdotca/kuni/subdivision-facts` | `loadSubdivisionFacts`, and the types `SubdivisionFacts` and `LatLon` |
 | `@johnmorrisdotca/kuni/subdivision-facts/<code>` | the country's subdivision facts as the default export and as `SUBDIVISION_FACTS` |
 | `@johnmorrisdotca/kuni/withdrawn` | `withdrawn`, `withdrawnCountries`, `WITHDRAWN_READ` and the type `WithdrawnCountry` |