@johnmorrisdotca/kuni 1.4.0 → 1.5.0

package/CHANGELOG.md

@@ -6,6 +6,21 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [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.
+
+### Added
+
+- **Every way to use it, tested.** `examples/` holds a script tag from jsDelivr and from unpkg, Vite, webpack, React (with a server render), Vue, Svelte, Angular, an iframe of the embed page, TypeScript and Node. `pnpm test:usage` builds, type-checks or runs each against the package as npm packs it, opens the ones with a page in a browser, and checks that the guides hold the same text word for word. CI runs it.
+- **Five guides, English and Japanese:** plain HTML and CDNs, Vite and webpack, React, Vue, Svelte and Angular, an iframe, and TypeScript and Node. The README links them ("Use it anywhere").
+- **`scripts/check-standard.mjs`**, the family's must-have list as a check (kazoku-ui's, copied unchanged), run by `pnpm test`.
+
+### Changed
+
+- **The demo's header** has the family's language picker and theme switch (kazoku-ui), and the page is `demo/index.html`. The README's pictures are new screenshots of it.
+- **The Release workflow** calls kazoku-ui's shared release workflow, and refuses a commit CI has not passed.
+
 ## [1.4.0] - 2026-10-14
 
 A country and subdivision card with a shared embed builder joins the demo and the package, tables download as Markdown and SQL, and the package has an English and Japanese documentation site with a checked example for every export. The country data, the codes and the lookups are unchanged.

package/README.md

@@ -281,6 +281,12 @@ 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
+
+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`).
+
+Guides: [script tag](./docs/guides/html-and-cdn.md), [Vite and webpack](./docs/guides/bundlers.md), [React, Vue, Svelte, Angular](./docs/guides/frameworks.md), [iframe](./docs/guides/embed-in-an-iframe.md), [TypeScript and Node](./docs/guides/typescript-and-node.md).
+
 ## Examples
 
 ### A country select, in either language
@@ -569,7 +575,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-two packages, each made for the same site, each at
+Kuni is one of thirty-three 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**
@@ -613,6 +619,7 @@ Kuni is one of thirty-two packages, each made for the same site, each at
 **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/).
 - [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/).
 - [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/).
@@ -629,7 +636,7 @@ Kuni is one of thirty-two 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-two share one header and footer, so each links the rest.
+**This package is Kuni.** The demos of all thirty-three share one header and footer, so each links the rest.
 <!-- family:end -->
 
 ## Development
@@ -661,7 +668,7 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md); the commands are under [Development](#
 
 ## Changes
 
-See [CHANGELOG.md](./CHANGELOG.md). The latest release, 1.4.0, adds the country card with the standard embed attributes, the shared embed builder, and the documentation site with a checked example for every export.
+See [CHANGELOG.md](./CHANGELOG.md). The latest release, 1.5.0, changes the demo, the docs and the release tooling only; 1.4.0 added the country card with the standard embed attributes, the shared embed builder, and the documentation site with a checked example for every export.
 
 ## Licence
 

package/dist/index.cjs

@@ -634,7 +634,7 @@ var CONTINENTS = ["AF", "AN", "AS", "EU", "NA", "OC", "SA"];
 var LANGUAGES = ["en", "ja"];
 
 // src/version.ts
-var VERSION = "1.4.0";
+var VERSION = "1.5.0";
 
 // src/index.ts
 var LEADING_THE = /^the /;

package/dist/index.d.cts

@@ -30,7 +30,7 @@ declare const fold: (text: string) => string;
  * console.log(`kuni ${VERSION}`);
  * ```
  */
-declare const VERSION = "1.4.0";
+declare const VERSION = "1.5.0";
 
 /** The order `countries()` lists them in: "code" (alpha-2), "en" (by English name) or "ja" (by Japanese name, in kana).
  *

package/dist/index.d.ts

@@ -30,7 +30,7 @@ declare const fold: (text: string) => string;
  * console.log(`kuni ${VERSION}`);
  * ```
  */
-declare const VERSION = "1.4.0";
+declare const VERSION = "1.5.0";
 
 /** The order `countries()` lists them in: "code" (alpha-2), "en" (by English name) or "ja" (by Japanese name, in kana).
  *

package/dist/index.js

@@ -596,7 +596,7 @@ var CONTINENTS = ["AF", "AN", "AS", "EU", "NA", "OC", "SA"];
 var LANGUAGES = ["en", "ja"];
 
 // src/version.ts
-var VERSION = "1.4.0";
+var VERSION = "1.5.0";
 
 // src/index.ts
 var LEADING_THE = /^the /;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/kuni",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Kuni 国 — Countries, states and provinces: ISO 3166 codes and English/Japanese names, subdivisions, country facts and groupings, typed lookups, on-demand country data and an optional card. Zero dependencies.",
   "keywords": [
     "countries",
@@ -4608,24 +4608,43 @@
     "docs:make": "node scripts/docs-resources.mjs && node scripts/docs.mjs",
     "docs:site": "pnpm build && node scripts/docs-site.mjs build",
     "docs:check": "pnpm build && node scripts/docs-site.mjs check",
-    "size": "node scripts/docs-site.mjs size"
+    "size": "node scripts/docs-site.mjs size",
+    "test:usage": "pnpm site && node scripts/check-usage.ts",
+    "check:standard": "node scripts/check-standard.mjs"
   },
   "devDependencies": {
+    "@angular/common": "^22.2.4",
+    "@angular/compiler": "^22.2.4",
+    "@angular/core": "^22.2.4",
+    "@angular/platform-browser": "^22.2.4",
     "@eslint/js": "^9.0.0",
     "@johnmorrisdotca/chizu": "1.4.0",
+    "@johnmorrisdotca/kazoku-ui": "^0.10.1",
     "@playwright/test": "^1.64.0",
+    "@sveltejs/vite-plugin-svelte": "^7.3.1",
     "@types/node": "^24.0.0",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "@vitejs/plugin-vue": "^6.0.10",
     "cldr-core": "48.2.0",
     "cldr-localenames-full": "48.2.0",
     "countries-list": "3.4.1",
     "esbuild": "^0.28.0",
     "eslint": "^9.0.0",
+    "marked": "^18.0.0",
+    "pagefind": "^1.5.2",
+    "react": "^19.3.1",
+    "react-dom": "^19.3.1",
+    "rxjs": "^7.8.2",
+    "svelte": "^5.57.3",
     "tsup": "^8.5.0",
     "typescript": "~5.9.0",
     "typescript-eslint": "^8.0.0",
+    "vite": "^8.3.5",
     "vitest": "^5.0.0",
-    "pagefind": "^1.5.2",
-    "marked": "^18.0.0"
+    "vue": "^3.5.44",
+    "webpack": "^5.112.2",
+    "webpack-cli": "^7.3.1"
   },
   "publishConfig": {
     "access": "public"