Repository navigation
Releases
v1.6.0
A minor version: nothing that 1.5.0 gave is taken away except five lines that are obscene in themselves. The English list, the rules and the saved-game format are unchanged.
Changed
- The Japanese word list no longer leaves out ordinary words (MODULES-392; John, 2026-11-04: "we can't filter out regular good words"). Kotoba's children bar, which writes the list, is narrowed: a line is out only when every entry that spells it is marked vulgar, X-rated, sensitive or derogatory by JMdict, or has a first sense that names a sex act, a sex organ or the sex trade, or it is a reading on Kotoba's short list of obscene ones. A sense that only mentions sex is no longer enough. 86 lines are back, among them せいべつ (性別), いせい (異性), どうせい (同性), きょうがく (共学), こんりゅう (建立), まぜもの (混ぜ物), そうにゅう (挿入), ふじゅん (不純), なのはな (菜の花), あいじん (愛人).
- Five lines are held out by name: まんこ and うんこ and おっぱい and ちんこ, which JMdict marks nothing or shares with an ordinary word (万古 is also まんこ), and れいふ, the line that れいぷ plays on the tiles (it is also 霊符, a charm, which goes out with it). The list is 162,243 readings, 86 more and 5 fewer: 162,324.
- A seeded Japanese game is dealt differently, as the list has other words to choose among; English games and the saved-game format are unchanged.
v1.5.0
A minor version: nothing that 1.4.0 gave is taken away except what children should not have been handed. The English list, the rules and the saved-game format are unchanged.
Changed
- The Japanese word list leaves out what is not for children (MODULES-390). Children play this game, and the list was every kana reading of every JMdict entry. It now has the bar of Kotoba's kana lists (
scripts/children-bar.mjsin Kotoba, which writes the list withscripts/word-lists-ja.mjs): a reading is out when every JMdict entry that spells it has a vulgar, X-rated, sensitive or derogatory mark on its first sense, or a first sense whose gloss names sex or the sex trade. A reading that an ordinary entry is also spelt like stays, and so does a line that another word plays: the tiles play ば and ぱ as は, so れいぷ is the line れいふ, which is also 霊符 (a charm). Of the 163,585 lines JMdict's release of 2026-11-04 gives, 1,347 are barred (110 of 3 kana, 347 of 4, 264 of 5, 626 longer), among them せっくす, ばいしゅん, ぽるの, えろい, おなに, ちくび, ふぇらちお, せいどれい, いんらん, ちんぽ and らぶほてる; the 5 words earlier lists held that JMdict no longer lists are kept, so a game kept half way still checks. The list holds 162,243 readings (163,461 in 1.4.0). A test (src/childrenBar.test.ts) holds the known bad readings out. The guide "Load and judge with word lists" says what is left out, in English and in Japanese. - A seeded Japanese game is dealt differently, as the list has fewer words to choose among: the same seed gives another bag. English games are unchanged, and so is the saved-game format; a kept Japanese game checks as before unless it spells one of the barred lines.
- The Japanese list is made again from JMdict's release of 2026-11-04 (it was 2026-09-28): 129 readings join, 5 are kept that JMdict dropped.
- The package is a little smaller: the Japanese list is 715 kB (394 kB gzipped), and the sizes in
docs/bundle-size.jsonare measured again.
Added
- 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.pngandicon.png.
v1.4.0
Added
-
A table can be laid in the family's five cloths:
<kumimoji-table cloth="blue">,mountKumimoji(el, { cloth })andset({ cloth }), theclothembed parameter and Builder option, andKUMIMOJI_CLOTHS,isClothandclothVarsfrom/ui. The demo's header patches lay it through the page's theme. -
checkKumimojigives its reason as a code and values as well as in English. A refusal is now{ ok: false, reason, code, values }:reasonis the sentence it has always been, word for word, andcode("no-hand","givens-not-bag","wild-count-wrong","bag-exceeds-set","answer-not-grid","grid-not-the-bag","tiles-apart","not-a-word"and"grid-not-finished") andvalues({ size }forno-hand,{ word }fornot-a-word) let a site say it in its own language.KUMIMOJI_CHECK_REASONSlists every code with its English clause,kumimojiRefusal(code, values)makes a refusal, and the types areKumimojiCheckCodeandKumimojiCheckValues. A test holds every refusal'sreasonto its code's clause filled with its values.
v1.3.1
Changed
- Biome replaces ESLint as the formatter and linter, with the family's shared settings in
scripts/biome-family.json;pnpm lintchecks formatting too, andpnpm formatapplies it. The code is formatted once to 120 columns. Nothing a user of the package sees has changed. - TypeScript targets ES2022, treats an indexed read as possibly missing, and refuses switch fallthrough and unmarked overrides.
pnpm checkalso holds every source file to at most 500 lines of code (scripts/check-size.mjs; blank lines, comments, tests and data files are not counted).
Fixed
- The issue chooser's security link shows again: an unquoted colon had made
.github/ISSUE_TEMPLATE/config.ymlinvalid YAML.
v1.3.0
The table 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 rules, generation, seeds and saved games are unchanged.
Added
- Add the bilingual documentation site, checked public examples, paired guides, local search and machine-readable pages.
- Add the shared crossword-table builder and validated iframe route with reflected settings and display options. Preserve native saved/table access and gameplay methods; presentation updates now retain play.
- Add native ready/set, optional initial saved state, control visibility and localized load failures, forwarded by the React wrapper. Preserve event shapes with composed JSON-safe snapshots and add load/error events.
- Share a package-independent embed builder for option controls, preview adapters, code tabs and shareable links.
Changed
- Synchronize documentation tooling for repository layouts, generated type references, Node entry points and repository-specific README links.
- Keep large documentation resource catalogues on the entry index and the active resource beside core navigation, preserving every reference page; render valid default imports in HTML and Markdown.
- The props table of
KumimojiBoardmoved from the README todocs/react.md, so that the README, which now lists the sports packages too, stays under npm's 65,536 characters; the README keeps a summary and a link. - 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.
v1.2.2
Nothing that was exported has changed.
Changed
- The README takes the family's one layout, fully: a hero picture of the demo on a desk and on a phone in light and dark, a picture of each kind of table (English, kana, a run that is not a word, a hand of eleven, a wild tile), an Examples section of ten examples whose output is what they print, an Install section, and a short list of the calls to learn first. Its pictures are in
docs/images(WebP, light and dark) and are retaken withpnpm screenshots:readme(it replacespnpm picturesand the two JPEGsdocs/desktop.jpganddocs/phone.jpg); they are not in the tarball, andpnpm test:packagefails if one is. - To keep the README under the 64,000 characters npm can show, the long tables of exports (dealing and judging, tiles and grids, playing, the table of players, looking at the table) and the table's, the element's and the React components' options moved to
docs/API.md, and the source tree moved todocs/ARCHITECTURE.md, each with a summary and a link left in the README. Nothing was removed, and the tests that hold these tables to the code read the README anddocs/API.mdtogether. pnpm test:readmetype-checks and runs every TypeScript and JavaScript example in the README against the built package, as a CI job of its own, andpnpm checkholds the README to the family's lint.- "The command line" says there is none, and now sits after the languages, where the other sections of the standard's order leave room for it.
- Repository only: the package and everything it exports are unchanged.
CONTRIBUTING.mdis the family's one text with a section of its own for Kumimoji, held to the master in johnmorrisdotca/.github bysrc/family.test.js;ci.ymlandpages.ymlare 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.
v1.2.1
Nothing that was exported has changed.
Added
- A test holds every
@johnmorrisdotca/kumimoji@Nversion 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.
homepageis the demo site andauthoris"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.
- Every entry has an
importcondition besidedefault.