@johnmorrisdotca/kuni 1.6.1 → 1.6.3

package/CHANGELOG.md

@@ -6,6 +6,29 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [1.6.3] - 2026-11-11
+
+### Added
+
+- **Short Japanese city names for map labels**: `name.jaShort` beside `name.ja` on every city with a Japanese name: 東京 for 東京都, 大阪 for 大阪市, 新宿 for 新宿区, ソウル for ソウル特別市. A one-character name drops its 市 as maps print it (津市, 津); a name is kept whole where 区 would leave one character (中区), where the result would be a country's name (クウェート市) or would mean something else (中央市, 南九州市, 雲南市, ケソン市) or something bigger (東海市, 吉林市, 北海市, 山梨市), where 都市 is the word for a city in a longer name (関西文化学術研究都市; 京都市 is 京都), or where the 区 belongs to the name (浦東新区, ワシントン郡区); 町, 村 and 郡 are never dropped.
+- **Seven wrong Japanese names dropped**: Várzea Grande, Qods, Kiryat Tiv'on and one Jinhe Town carried Wikidata's Japanese label of a larger place (a state, a province, a district, a county), and East Meadow, Pingdiquan Town and Ih Toli Gol that of another city (ニューヨーク市, 済寧, 玉林); they now have none, until a right one is found.
+- **Brussels, Munich and Birmingham** rank by their metropolitan areas (3.35, 3.02 and 3.12 million): Wikidata has the areas but links them to no city, so `scripts/metro-links.ts` sets each by name with its reason. Somerset, a county, is no longer listed as a city.
+
+## [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

package/NOTICE.md

@@ -103,6 +103,24 @@ 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. Brussels, Munich and Birmingham are linked to their areas by name in
+`scripts/metro-links.ts`, from the same CC0 snapshot.
+
+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 |
@@ -273,7 +274,7 @@ countriesOf("OC");                                    // the countries of a cont
 (await searchPlaces("パリ", { lang: "ja" }))[0].label; // "パリ": English, Japanese or native names, accents and kana folded
 ```
 
-A city is in one tier only. `id` is the Wikidata item (`"Q90"`), or `"ne:<number>"` where only Natural Earth has the place, and never changes between releases: an id that was merged into another city still answers with it. `name.ja` and `name.native` are left out where no source has them, never an English name copied in. [Use the cities](./docs/guides/cities.md) has the rest.
+A city is in one tier only. `id` is the Wikidata item (`"Q90"`), or `"ne:<number>"` where only Natural Earth has the place, and never changes between releases: an id that was merged into another city still answers with it. `name.ja` and `name.native` are left out where no source has them, never an English name copied in. `name.jaShort` is the short Japanese name a map labels a city by (東京 for 東京都, 大阪 for 大阪市), beside the full `name.ja`. [Use the cities](./docs/guides/cities.md) has the rest.
 
 ### In a page, with no bundler
 
@@ -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` |