@johnmorrisdotca/kuni 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -6,6 +6,13 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [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".
+- `fold` writes ł, ß, ø, đ, ı, æ, œ, ð and þ as l, ss, o, d, i, ae, oe, d and th, so that "Lodz" finds Łódź and "Strasse" finds Straße in every lookup.
+- Kuni's local ports are 8600 to 8699 (AGENTS.md).
+- The README opens with the package's thumbnail, and the demo carries it as its link preview (og:image) and publishes the card, a dark card and an icon on Pages at `thumbnail.png`, `thumbnail-dark.png` and `icon.png`.
+
 ## [1.5.0] - 2026-11-03
 
 The demo, the docs and the release tooling follow the family's must-have list. No change to the package's code beyond its version.

package/NOTICE.md

@@ -94,6 +94,24 @@ side of the road it drives on, the countries it shares a border with and the int
 of. `scripts/facts.ts`, `scripts/subdivision-facts.ts` and `scripts/groupings.ts` say how each is chosen. Figures are
 kept as Wikidata gives them, rounded only for coordinates (two decimal places).
 
+## Wikidata, for the cities
+
+The cities (`/cities`) are made from a second Wikidata snapshot (`data-sources/wikidata-cities-<day>.json`), CC0 on the
+terms quoted above (read on 2026-11-11), asked for by `scripts/fetch-cities.ts`: the items that are an instance of a
+human settlement, have coordinates and a best-ranked population of 15,000 or more, every current capital of a country
+or a subdivision, and the items Natural Earth's places name. For each, the English and Japanese labels, the native
+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.
+
+## Natural Earth's populated places
+
+Natural Earth's 10m Populated Places, version 5.1.2 (https://www.naturalearthdata.com/, public domain: "No permission
+is needed to use Natural Earth. Crediting the authors is unnecessary."), read from its own release on GitHub
+(nvkelso/natural-earth-vector, tag v5.1.2) on 2026-11-11, are the second input of the cities. They fill a Japanese name,
+a population or a point Wikidata has not got, add a capital where Wikidata names none, and give the cities Wikidata has
+no item for (ids that start `ne:`). Places it marks "Historic place" are left out. Each city's `source` field says which
+input a fact came from. It is credited here anyway.
+
 ## Natural Earth, through Chizu
 
 Natural Earth (https://www.naturalearthdata.com/) is in the public domain: "No permission is needed to use Natural

package/README.md

@@ -1,3 +1,5 @@
+<p align="center"><a href="https://johnmorrisdotca.github.io/kuni/"><picture><source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/johnmorrisdotca/kuni/main/docs/images/thumbnail-dark.png"><img src="https://raw.githubusercontent.com/johnmorrisdotca/kuni/main/docs/images/thumbnail.png" alt="Kuni: the outlines of Japan, Canada, Italy and Brazil with their capitals marked, their ISO codes and their names in English and Japanese." width="1200"></picture></a></p>
+
 <h1 align="center">Kuni <sub>国</sub> — Countries, states and provinces</h1>
 
 <p align="center"><strong>Kuni 国: every country and its states, provinces and prefectures, with ISO 3166 codes and names in English and Japanese.</strong><br>
@@ -11,7 +13,7 @@ A typed, zero-dependency dataset from Unicode CLDR and Wikidata, loaded one coun
   <a href="./LICENSE"><img alt="MIT licence" src="https://img.shields.io/badge/licence-MIT-2f5d4a"></a>
   <img alt="No dependencies" src="https://img.shields.io/badge/dependencies-0-2f5d4a">
   <img alt="TypeScript" src="https://img.shields.io/badge/types-TypeScript-3178c6">
-  <a href="https://johnmorrisdotca.github.io/kuni/docs/api/main/index.html"><img alt="21.4 kB minified and gzipped" src="https://img.shields.io/badge/min%2Bgzip-21.4%20kB-2f5d4a"></a>
+  <a href="https://johnmorrisdotca.github.io/kuni/docs/api/main/index.html"><img alt="21.6 kB minified and gzipped" src="https://img.shields.io/badge/min%2Bgzip-21.6%20kB-2f5d4a"></a>
   <a href="https://www.npmjs.com/package/@johnmorrisdotca/kuni#provenance"><img alt="Published with npm provenance" src="https://img.shields.io/badge/npm-provenance-2f5d4a"></a>
 </p>
 
@@ -97,9 +99,10 @@ Install the scoped name: the unscoped `kuni` on npm is somebody else's package.
 - **Facts with their dates** (`/facts`): population and area with the year each is for, coordinates of the country and its capital, land borders (confirmed by Natural Earth's outlines, so islands have none), the side of the road it drives on, and CLDR's first day of the week, measurement system, paper size and clock. `distanceKm` between two points.
 - **Facts about subdivisions** (`/subdivision-facts`): each one's capital, population, area and coordinates, one country at a time; complete for Japan's 47 prefectures.
 - **Withdrawn countries** (`/withdrawn`): the 31 entries of ISO 3166-3 (SU, YU, CS, DD, ZR, TP, AN, BU and the rest), each with the four-letter code, the alpha-2, alpha-3 and numeric codes it held, its name in English and Japanese, the years the code was in force and the codes ISO lists for what came after it. They are never in `countries()`, so a picker does not offer the Soviet Union; a lookup by an old code says what it was.
+- **Cities** (`/cities`): the world's cities in tiers, each its own entry so that a page pays only for what it uses: every capital of a country or a subdivision (`/cities/capitals`), the cities of a million people or more (`/cities/1m`) and of 100,000 or more (`/cities/100k`), capitals included, the cities of 15,000 or more through `loadCities("15k")` (made from the countries' own files), and one country's cities at a time (`/cities/<code>`). Each city has its Wikidata id (stable between releases), its name in English, Japanese and its own language where a source has them, continent, country, latitude and longitude, population with its date, country, first-level subdivision, capital flags and where each fact came from; `citySet` finds one by id, lists a country's, and answers the city nearest to a point. Wikidata (CC0) with Natural Earth's populated places (public domain). [docs/cities.md](./docs/cities.md) counts what is in each tier and what is missing.
 - **Olympic codes**: `country(code).ioc` is the International Olympic Committee's three-letter code ("JPN", "GER" for Germany, "SUI" for Switzerland) for the 209 countries that have one.
 - **Groupings** (`/groupings`): the seven continents, the 30 UN M49 areas, 23 international bodies (the UN, the EU, the euro area, Schengen, NATO, the G7 and G20, ASEAN and more) with the days members joined and left, 16 informal groupings (the Middle East, the Balkans, Scandinavia, the Sahel) each with the definition it follows, and regions inside a country (Japan's 地方, the US Census regions, Canada's regions).
-- **Small where it matters.** The countries and lookups are 21.4 kB minified and gzipped; one country's subdivisions are their own entry (Japan's 47, measured separately) or a dynamic import.
+- **Small where it matters.** The countries and lookups are 21.6 kB minified and gzipped; one country's subdivisions are their own entry (Japan's 47, measured separately) or a dynamic import.
 - **Typed, frozen, pure and the same everywhere.** ESM and CommonJS, types for both, no dependencies, no network and no `Intl`. Every export carries a doc comment with a runnable example, which an editor shows on hover and the tests run.
 - **A demo to use, not just to read.** A page for each country, two countries compared, every country in a sortable table, the groupings explorer, three seeded quizzes, a country and region form widget with its code to copy, and the data's quality in the open, each at an address of its own and downloadable as CSV, JSON, text, a Markdown table or SQL: [the demo](https://johnmorrisdotca.github.io/kuni/).
 - **Never a guess.** A value no source gives is `null`, with the reason written down (`docs/facts.md`, `docs/subdivision-facts.md`, `docs/ja-gaps.md`), never a plausible filler.
@@ -133,7 +136,7 @@ It ships ES modules and CommonJS, with types for both and `sideEffects: false`.
 
 | Entry | What it carries | Size (minified + gzip) |
 | --- | --- | --- |
-| `@johnmorrisdotca/kuni` | The 250 countries and the country lookups | 21.4 kB min+gzip |
+| `@johnmorrisdotca/kuni` | The 250 countries and the country lookups | 21.6 kB min+gzip |
 | `@johnmorrisdotca/kuni/element` | `KuniCard`, `defineCard`, `KUNI_CARD_FIELDS`, `KUNI_CARD_OPTION_KEYS`, `readCardColors`; `KuniCardOptions` | 290.5 kB min+gzip |
 | `@johnmorrisdotca/kuni/element/define` | registers the tag and re-exports the element API | 290.5 kB min+gzip |
 | `@johnmorrisdotca/kuni/codes` | The 250 codes and `isCountryCode`, nothing else | 0.6 kB min+gzip |
@@ -145,6 +148,12 @@ It ships ES modules and CommonJS, with types for both and `sideEffects: false`.
 | `@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 |
 | `@johnmorrisdotca/kuni/withdrawn` | The 31 withdrawn countries (ISO 3166-3) and `withdrawn(code)` | 2.1 kB min+gzip |
+| `@johnmorrisdotca/kuni/cities` | `citySet`, `loadCities(...tiers)`, `citiesOf(code)` and `cityById(id)`: the lookups, with no city in it | 4.2 kB min+gzip (the docs site's figure counts every tier, which load on demand) |
+| `@johnmorrisdotca/kuni/places` | `continents()`, `countriesOf(continent)` and `searchPlaces(text, { lang, limit })`, for a place chooser | 51.2 kB min+gzip |
+| `@johnmorrisdotca/kuni/cities/capitals` | Every capital, of a country or of a subdivision | 192.1 kB min+gzip |
+| `@johnmorrisdotca/kuni/cities/1m` | The cities of a million people or more (capitals too) | 32.6 kB min+gzip |
+| `@johnmorrisdotca/kuni/cities/100k` | The cities of 100,000 or more (capitals too) | 238.9 kB min+gzip |
+| `@johnmorrisdotca/kuni/cities/<code>` | One country's cities, every tier together (`/cities/jp`) | 1.2–187 kB gzip; Japan 37 kB |
 
 ### 1. The countries
 
@@ -245,6 +254,27 @@ withdrawnCountries().length;         // 31
 
 The 31 are the entries of ISO 3166-3, whose codes, years and successors are the published list's, transcribed once and pinned whole by a test; their names in English and Japanese are Wikidata's (property P773). A successor is exactly the new code ISO lists, and may itself be withdrawn: Yugoslavia's is `CS`, which `withdrawn("CS")` answers as Serbia and Montenegro first and Czechoslovakia after. [docs/withdrawn.md](./docs/withdrawn.md) says how, and lists their Japanese names for review. They are a list of their own: `country("SU")` is still `null`, `isCountryCode("SU")` is still `false` and `countries()` never holds them. A lookup by a code answers every withdrawn country that held it, the last one first, and an empty list for anything else; a record whose alpha-2 code a current country holds now (`BY`, `AI`, `BQ`, `GE`, `SK`) says so in `reusedBy`.
 
+### 9. Cities
+
+```ts
+import { citySet, citiesOf, cityById } from "@johnmorrisdotca/kuni/cities";
+import { countriesOf, searchPlaces } from "@johnmorrisdotca/kuni/places";
+import { capitalCities } from "@johnmorrisdotca/kuni/cities/capitals";
+import { cities1m } from "@johnmorrisdotca/kuni/cities/1m";
+
+const world = citySet(capitalCities(), cities1m());   // tiers joined; each is its own import
+world.byId("Q90")?.name.ja;                           // "パリ"
+world.inCountry("JP").length;                         // the Japanese capitals and cities of a million or more
+world.nearest({ lat: 48.8566, lon: 2.3522 })?.city.name.en; // "Paris", for a "you are here" marker
+
+const japan = await citiesOf("JP");          // one country's cities, every tier, fetched when asked for
+const paris = await cityById("Q90");                  // one city by its id (tiers loaded until it is found)
+countriesOf("OC");                                    // the countries of a continent, from the groupings
+(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.
+
 ### In a page, with no bundler
 
 ```html
@@ -281,7 +311,7 @@ import "@johnmorrisdotca/kuni/element/define";
 
 The `@johnmorrisdotca/kuni/element` entry exports the class and `defineCard(tag?)`; `@johnmorrisdotca/kuni/element/define` registers the tag. Both are safe to import on a server. The builder also supplies plain HTML, Vue, Svelte, Angular and iframe examples.
 
-## Use it anywhere
+## Every way to use it
 
 The [demo](https://johnmorrisdotca.github.io/kuni/), the [docs](https://johnmorrisdotca.github.io/kuni/docs/) (English and Japanese) and the [embed page](https://johnmorrisdotca.github.io/kuni/embed/). Each way below is a tested file in [`examples/`](./examples) (`pnpm test:usage`).
 
@@ -389,6 +419,12 @@ The [API reference](https://johnmorrisdotca.github.io/kuni/api.html) lists every
 | `@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` |
+| `@johnmorrisdotca/kuni/cities` | `citySet`, `loadCities`, `citiesOf`, `cityById`, `CITY_TIERS`, and the types `City`, `CityAt`, `CitySet`, `CitySource`, `CityTier` and `NearestOptions` |
+| `@johnmorrisdotca/kuni/places` | `continents`, `countriesOf`, `searchPlaces`, and the types `PlaceContinent`, `PlaceHit` and `SearchPlacesOptions` |
+| `@johnmorrisdotca/kuni/cities/capitals` | `capitalCities`, `CITIES_READ` |
+| `@johnmorrisdotca/kuni/cities/1m` | `cities1m`, `CITIES_READ` |
+| `@johnmorrisdotca/kuni/cities/100k` | `cities100k`, `CITIES_READ` |
+| `@johnmorrisdotca/kuni/cities/<code>` | the country's cities as the default export and as `CITIES` |
 | `@johnmorrisdotca/kuni/groupings` | `groupings`, `grouping`, `groupingsOf`, `membersOf`, `GROUPING_KINDS`, and the types `Grouping`, `GroupingKind`, `GroupingMember`, `GroupingName`, `GroupingOther`, `GroupingSource`, `GroupingStatus`, `GroupingsOptions` and `GroupingDateOptions` |
 
 A country:
@@ -501,7 +537,7 @@ None, on purpose: Kuni is data and lookups, with no colours, markup or styles, s
 | Groupings | 7 continents, 30 UN M49 areas, 23 bodies, 16 informal, 31 inside a country | `/groupings` |
 | Languages | English and Japanese | `LANGUAGES` |
 
-Not here: cities, postal codes, outlines, and names in other languages. CLDR marks nearly all of its Japanese subdivision names "provisional"; where Wikidata names a place differently, CLDR's name is kept and the difference listed in [docs/disagreements.md](./docs/disagreements.md) (226 of 4,313 compared) for review. CLDR's trailing brackets (セント・ポール (ドミニカ国), バリンゴ (カウンティ)) are taken off by a rule listed in [docs/name-rules.md](./docs/name-rules.md), and 56 Japanese names a reviewer found wrong or out of date are written by hand, with their reasons, in [docs/disagreements.md](./docs/disagreements.md). Every English name is checked against Wikidata's English label for the patterns that were found wrong in 1.0.0 (a name cut short, an adjective for a name, marks stripped, a name swapped with a neighbour's, an old place's name on a reused code); 32 are corrected by hand, with their reasons, in the same file. Where ISO 3166-2 has changed since CLDR's release (Norway's counties of 2024), the codes follow ISO.
+Not here: postal codes, outlines, and names in other languages. CLDR marks nearly all of its Japanese subdivision names "provisional"; where Wikidata names a place differently, CLDR's name is kept and the difference listed in [docs/disagreements.md](./docs/disagreements.md) (226 of 4,313 compared) for review. CLDR's trailing brackets (セント・ポール (ドミニカ国), バリンゴ (カウンティ)) are taken off by a rule listed in [docs/name-rules.md](./docs/name-rules.md), and 56 Japanese names a reviewer found wrong or out of date are written by hand, with their reasons, in [docs/disagreements.md](./docs/disagreements.md). Every English name is checked against Wikidata's English label for the patterns that were found wrong in 1.0.0 (a name cut short, an adjective for a name, marks stripped, a name swapped with a neighbour's, an old place's name on a reused code); 32 are corrected by hand, with their reasons, in the same file. Where ISO 3166-2 has changed since CLDR's release (Norway's counties of 2024), the codes follow ISO.
 
 ## Accessibility
 
@@ -553,6 +589,8 @@ The [architecture guide](docs/guides/architecture.md) retains the complete origi
 | First day of the week, measurement system, paper size, clock; UN M49; the UN's members | Unicode CLDR 48.2 (`cldr-core`) | Unicode-3.0 |
 | The bodies' members, the informal groupings and the regions inside a country | written for this package from each body's own list, on 2026-10-09 (`scripts/groupings-config.ts`) | MIT; lists of facts |
 | IOC codes, and the withdrawn countries' names | Wikidata, a snapshot of 2026-10-10 (`data-sources/wikidata-codes-2026-10-10.json`) | CC0 |
+| The cities: names, coordinates, populations with dates, countries, subdivisions, capitals | Wikidata, a snapshot of 2026-11-11 (`data-sources/wikidata-cities-2026-11-11.json`) | CC0 |
+| The cities: a Japanese name, a population or a point Wikidata lacks, capital classes, and the places Wikidata has no item for | Natural Earth 5.1.2 10m Populated Places, from its own release (`data-sources/natural-earth-populated-places-5.1.2.json`) | Public domain |
 | The withdrawn countries' codes, years and successors | ISO 3166-3's published list, transcribed once (`scripts/withdrawn-config.ts`) | A list of facts |
 | Aliases, a few readings and 46 corrected Japanese subdivision names | written for this package | MIT |
 
@@ -575,7 +613,7 @@ Using Kuni in something else? Open an *Add my project* issue and we will add you
 ### The family
 
 <!-- family:start (made by scripts/family-readme.mjs from scripts/family-template.mjs; change those, not this) -->
-Kuni is one of thirty-three packages, each made for the same site, each at
+Kuni is one of forty-one packages, each made for the same site, each at
 [github.com/johnmorrisdotca](https://github.com/johnmorrisdotca) or [github.com/spxis](https://github.com/spxis). The code of every one is MIT.
 
 **Games — board**
@@ -588,6 +626,7 @@ Kuni is one of thirty-three packages, each made for the same site, each at
 
 **Games — cards & tiles**
 
+- [Fuda Cards](https://github.com/johnmorrisdotca/fuda-cards) (札): collectible card frames with a true thickness, foil, stacks, wear and a binder, as two web components. [Demo](https://johnmorrisdotca.github.io/fuda-cards/).
 - [Hitotsu](https://github.com/johnmorrisdotca/hitotsu) (一つ): a colour-card shedding game for two to eight, with the house rules people play. [Demo](https://johnmorrisdotca.github.io/hitotsu/).
 - [Jarajara](https://github.com/johnmorrisdotca/jarajara) (ジャラジャラ): mahjong tiles drawn as SVG, stacked layouts, and the matching solitaire Awase. [Demo](https://johnmorrisdotca.github.io/jarajara/).
 - [Kumimoji](https://github.com/johnmorrisdotca/kumimoji) (組み文字): a crossword tile race, in English and Japanese kana. [Demo](https://johnmorrisdotca.github.io/kumimoji/).
@@ -614,20 +653,30 @@ Kuni is one of thirty-three packages, each made for the same site, each at
 
 - [Bushu](https://github.com/johnmorrisdotca/bushu) (部首): find a kanji by the parts it is made of. [Demo](https://johnmorrisdotca.github.io/bushu/).
 - [Hikidashi](https://github.com/johnmorrisdotca/hikidashi) (引き出し): a drawer of small Japanese text tools: era dates, kanji numerals, readings and sentence difficulty. [Demo](https://johnmorrisdotca.github.io/hikidashi/).
+- [Jisho](https://github.com/johnmorrisdotca/jisho) (辞書): words of Japanese looked up by reading or written form, and the grades, JLPT levels, readings and look-alike pairs of 2,999 kanji. [Demo](https://johnmorrisdotca.github.io/jisho/).
 - [Kotoba](https://github.com/johnmorrisdotca/kotoba) (言葉): word lists and word-game rules in English, French, German and Japanese. [Demo](https://johnmorrisdotca.github.io/kotoba/).
 
+**Space Program X**
+
+- [Chikyu Earth](https://github.com/johnmorrisdotca/chikyu-earth) (地球): a line-drawn globe that turns at the Earth's own rate, with an optional realistic Earth from space and markers for any place. [Demo](https://johnmorrisdotca.github.io/chikyu-earth/).
+- [Hoshi Stars](https://github.com/johnmorrisdotca/hoshi-stars) (星): the stars you can see without a telescope, with names, colours and distances, the constellations with their lines and boundaries, and the Messier objects, drawn on any of seven sky maps. [Demo](https://johnmorrisdotca.github.io/hoshi-stars/).
+- [Uchusen Rockets](https://github.com/johnmorrisdotca/uchusen-rockets) (宇宙船): rockets drawn from sourced sizes, as line drawings and 3D views you can take apart and turn, with a check that a rocket really goes together. [Demo](https://johnmorrisdotca.github.io/uchusen-rockets/).
+- [Wakusei Planets](https://github.com/johnmorrisdotca/wakusei-planets) (惑星): the Sun, the planets and their moons, as line drawings, shaded drawings and painted surface maps, with their real sizes, tilt and rotation. [Demo](https://johnmorrisdotca.github.io/wakusei-planets/).
+
 **Geography & data**
 
 - [address-plus](https://github.com/johnmorrisdotca/address-plus) (アドレスプラス): parse and format addresses in the United States, Canada, Japan, Australia, France, Germany and the United Kingdom. [Demo](https://johnmorrisdotca.github.io/address-plus/).
-- [Chikyu Earth](https://github.com/johnmorrisdotca/chikyu-earth) (地球): a line-drawn globe that turns at the Earth's own rate, with an optional realistic Earth from space and markers for any place. [Demo](https://johnmorrisdotca.github.io/chikyu-earth/).
 - [Chizu](https://github.com/johnmorrisdotca/chizu) (地図): maps of the world and of countries' regions, in English and Japanese, with a quiz and callouts. [Demo](https://johnmorrisdotca.github.io/chizu/).
+- [Hako Devices](https://github.com/johnmorrisdotca/hako-devices) (箱): line drawings and 3D views of computers, phones, consoles and NAS boxes, from published sizes. [Demo](https://johnmorrisdotca.github.io/hako-devices/).
 - [Hata](https://github.com/johnmorrisdotca/hata) (旗): country and regional flags as SVG, at their true proportions and keyed by ISO code. [Demo](https://johnmorrisdotca.github.io/hata/).
+- [Koyomi Calendars](https://github.com/johnmorrisdotca/koyomi-calendars) (暦): calendar-page icons and whole months as SVG, in light and dark, with page-turning from one day to the next. [Demo](https://johnmorrisdotca.github.io/koyomi-calendars/).
 - [Kuni](https://github.com/johnmorrisdotca/kuni) (国): countries and their regions, with ISO codes and names in English and Japanese. [Demo](https://johnmorrisdotca.github.io/kuni/).
 
 **Sports**
 
 - [Dougu Sports](https://github.com/johnmorrisdotca/dougu-sports) (道具): sports emblems as SVG: trophies, medals, crests, and the ball and gear of every sport, with optional 3D turning. [Demo](https://johnmorrisdotca.github.io/dougu-sports/).
 - [Kyogijo Stadiums](https://github.com/johnmorrisdotca/kyogijo-stadiums) (競技場): sports fields, rinks, courts and ballparks drawn to scale as SVG, with each team and the score on them. [Demo](https://johnmorrisdotca.github.io/kyogijo-stadiums/).
+- [Meigen Sports](https://github.com/johnmorrisdotca/meigen-sports) (名言): sports quotations and on-this-day history. [Demo](https://johnmorrisdotca.github.io/meigen-sports/).
 - [Senshu Jerseys](https://github.com/johnmorrisdotca/senshu-jerseys) (選手): sports jerseys, sweaters, kits, caps, helmets and retired-number banners as SVG, front and back, with optional 2.5D turning. [Demo](https://johnmorrisdotca.github.io/senshu-jerseys/).
 - [Taisen Brackets](https://github.com/johnmorrisdotca/taisen-brackets) (対戦): a sport-agnostic tournament bracket, drawn as SVG, from a list of ties. [Demo](https://johnmorrisdotca.github.io/taisen-brackets/).
 
@@ -636,7 +685,7 @@ Kuni is one of thirty-three packages, each made for the same site, each at
 - [REST in Pieces](https://github.com/spxis/rest-in-pieces) (レスト・イン・ピーシーズ): seeded test data and REST APIs for frontend development, with latency and error drills. [Demo](https://spxis.github.io/rest-in-pieces/).
 
 
-**This package is Kuni.** The demos of all thirty-three share one header and footer, so each links the rest.
+**This package is Kuni.** The demos of all forty-one share one header and footer, so each links the rest.
 <!-- family:end -->
 
 ## Development