変更履歴

All notable changes to this project are written here. The format follows Keep a Changelog, and the project uses Semantic Versioning.

[Unreleased]

[1.1.0] - 2026-10-14

The picker is a custom element with the family's standard embed attributes and a shared builder, and the package has an English and Japanese documentation site with a checked example for every export. The search, the indexes, the names and the stroke counts are unchanged.

Added

• Add the bilingual documentation site, checked public examples, paired guides, local search and machine-readable pages.
• Add the shared embed builder, validated iframe route, reflected presentation options and host data/callback options. Preserve picker methods and lazy data loading; native events now cross shadow roots.
• Share a package-independent embed builder for option controls, preview adapters, code tabs and shareable links.

Changed

• The API link in the header reads "API" in English, so that the header takes the same number of rows in English and in Japanese on a phone, as the demo's test of a language change asks.
• Synchronize documentation tooling for repository layouts, generated type references, Node entry points and repository-specific README links.
• Keep complete resource catalogues on the documentation entry index and the active resource beside core navigation; render valid default imports in HTML and Markdown.
• Group the package family by kind, alphabetize each group, and include the geography packages and REST in Pieces in the shared footer and README.
• Update the shared family description for addresses in all seven supported countries, including France and Germany.

[1.0.2] - 2026-10-06

Nothing that was exported has changed. The README is the family's one layout, in full.

Added

• The README has a picture of the picker on a desk and on a phone, in light and dark, taken from the demo by pnpm screenshots:readme (the pictures are in docs/images/ and are not in the package), a picture for each part of the picker, an Examples section of eleven examples that run, and an Accessibility section.
• pnpm test:readme type-checks and runs every TypeScript and JavaScript example in the README against the built package, as a job of its own in CI; src/readme.test.js holds the README to the family's standard (sections in order, languages on code fences, pictures with alt text and a caption, no marketing words, version pins) in pnpm check; pnpm test:package fails if a picture or anything under docs/ is in the packed package.

Changed

• Repository only: the package and everything it exports are unchanged. CONTRIBUTING.md is the family's one text with a section of its own for Bushu, held to the master in johnmorrisdotca/.github by src/family.test.js; ci.yml and pages.yml are the family's one text (pnpm check, the demo, and the package on Linux, macOS and Windows), and any jobs of the package's own after them.

Fixed

• The API reference page wraps a long entry path instead of running about 2 px wider than a 360 px screen. Nothing the package exports has changed.

[1.0.1] - 2026-10-05

Nothing that was exported has changed.

Added

• A test holds every @johnmorrisdotca/bushu@N version pin in the README to this package's major version.

Changed

• The family's list, in the README and in the demo's footer, names all twenty-four packages, Karakuri and Houseki included.
• The npm description is one sentence of 250 characters or fewer, so npm and its search show it whole; it is also the repository's About text. homepage is the demo site and author is "John Morris", the same in every package.
• The GitHub Actions workflows use the current versions of the actions (checkout 7, setup-node 7, pnpm/action-setup 6; configure-pages 6, upload-pages-artifact 5 and deploy-pages 5 for Pages), which clears GitHub's Node 20 deprecation warning.

[1.0.0] - 2026-10-01

The first release.

• The lookup (@johnmorrisdotca/bushu): kanjiForRadicals (the kanji that hold every chosen part), usableRadicals (the parts that can still narrow them, for dimming the rest), radicalGroups (the grid by stroke count), orderChosen and radicalsInKanji (what a kanji is made of), over radicals handed in as an argument, each returning new values.
• The shapes: radicalForm turns RADKFILE's 25 stand-in keys (汁, 扎, 艾 and the rest) into the shapes people see (氵, 扌, 艹), RADICAL_FORMS is the table, and withCorrectedStrokes files 乞 and 舛 under the strokes they have, which RADKFILE gets wrong.
• @johnmorrisdotca/bushu/radkfile: the 253 radicals of RADKFILE with their 6,355 kanji, checked against KRADFILE, with EDRDG's own list of the Unicode characters for its stand-ins and the address, date and SHA-256 of each file it was made from.
• @johnmorrisdotca/bushu/names: the names a Japanese school teaches for 227 of the radicals (さんずい, にんべん, くさかんむり), with romaji, an English meaning, the position and the Kangxi number, from Kanji alive (CC BY 4.0).
• @johnmorrisdotca/bushu/strokes: the strokes of every one of the 6,355 kanji, from KANJIDIC2, and sortByStrokes.
• @johnmorrisdotca/bushu/picker: mountBushu draws the grid of parts by stroke count, the chosen parts, the matches and the card of a kanji into any element, with dimming of the parts that cannot help, English and Japanese words, light and dark, and the events bushu-change and bushu-pick.
• <bushu-picker> (/element, /element/define): the same in a tag, which loads its own data.
• The data is made by scripts, never by hand: scripts/build-data.mjs (RADKFILE, KRADFILE, KANJIDIC2) and scripts/build-names.ts (Kanji alive, from one pinned commit), deterministic, with each file's SHA-256 recorded. A monthly workflow, as EDRDG's licence asks, fetches the files again and leaves a branch when they change.
• The demo has the picker, a choice of order, names, the most matches shown and a box to open the parts of a kanji, the family's Help switch and cloth patches, and browser tests (pnpm test:demo) in Chromium and WebKit at a phone's width and a desk's.