Skip to the content

Kumimoji組み文字

Build crosswords from seeded English or Japanese tile bags, alone or at a shared table.

Kumimoji means assembled characters in Japanese. About the name

Contents

Getting started

Getting started

Install Kumimoji, read a word list before dealing, and deal a seeded hand.

Build a crossword from a seeded English or Japanese tile bag. The pure rules need no DOM or clock; the optional table entry handles presentation and elapsed time.

Install

npm install @johnmorrisdotca/kumimoji

Use Node 22 or later or a modern browser. Keep the shipped NOTICE.md and word-list attribution with your integration.

Load words before dealing

import {loadTileWordsFromModule} from "@johnmorrisdotca/kumimoji/words";
import {generateKumimoji,deal} from "@johnmorrisdotca/kumimoji";
await loadTileWordsFromModule("english");
const dealt = generateKumimoji(3,"hard",44);
const play = deal(dealt.givens,dealt.size);
console.log(dealt.seed,play.hand,play.tiles.size);
44 [ 'n', 'w', 'o' ] 0

The words entry registers a module loader for Node. Browser components load the selected list separately when needed. Await loading before synchronous generation or judging. A hand is 3, 7 or 11; difficulty controls wilds, and length controls the bag. A generated solution proves the bag can be finished; players may build another accepted crossword.

Pick a recipe

Word loading, solo progress, Japanese/wilds, shared tables, save/embed and the reference cover the next steps.

View sourceEdit on GitHubMade from the source of @johnmorrisdotca/kumimoji 1.6.0.