# Kotoba 言葉 — Word lists and word-game rules

> Kotoba 言葉 — Word lists and word-game rules: English, French, German and Japanese kana dictionaries, guess marking, scoring, romaji input, daily words and a native game for any page. TypeScript, zero dependencies.

Install with `npm install @johnmorrisdotca/kotoba`. Every page below is also an HTML page at the same address ending in .html; the documentation's home is https://johnmorrisdotca.github.io/kotoba/docs/. The examples on the reference pages are run when the site is built, and what they print is shown under them.

## Guides

- [Getting started](https://johnmorrisdotca.github.io/kotoba/docs/guides/getting-started.md): Load a dictionary and submit one native guess.
- [Load only the needed word lists](https://johnmorrisdotca.github.io/kotoba/docs/guides/word-lists.md): Choose direct or lazy imports and preserve the data credits.
- [Choose a stable daily word](https://johnmorrisdotca.github.io/kotoba/docs/guides/daily.md): Pin the ordered word pool and define the calendar boundary.
- [Mark guesses and score a round](https://johnmorrisdotca.github.io/kotoba/docs/guides/marking.md): Handle repeated letters before awarding place and speed points.
- [Type and mark kana](https://johnmorrisdotca.github.io/kotoba/docs/guides/kana.md): Keep unfinished romaji and distinguish size, voicing and family.
- [Embed the native word game](https://johnmorrisdotca.github.io/kotoba/docs/guides/embeds.md): Mount a game, scope keyboard input and clean up its listeners.
- [CLI boundaries and host validation](https://johnmorrisdotca.github.io/kotoba/docs/guides/cli.md): Use the async CLI result and native state rather than display claims.
- [Architecture and packed data](https://johnmorrisdotca.github.io/kotoba/docs/guides/architecture.md): Separate pure rules, optional dictionaries and native rendering.
- [Troubleshooting and FAQ](https://johnmorrisdotca.github.io/kotoba/docs/guides/troubleshooting.md): Interpret null lists, refused guesses and incomplete mounts.
- [Upgrading and moving a word game](https://johnmorrisdotca.github.io/kotoba/docs/guides/upgrading.md): Preserve list identity, native marking and embed choices.

## Reference

- [@johnmorrisdotca/kotoba/words-en](https://johnmorrisdotca.github.io/kotoba/docs/api/words-en/index.md): English words
- [@johnmorrisdotca/kotoba/words-fr](https://johnmorrisdotca.github.io/kotoba/docs/api/words-fr/index.md): French words
- [@johnmorrisdotca/kotoba/words-de](https://johnmorrisdotca.github.io/kotoba/docs/api/words-de/index.md): German words
- [@johnmorrisdotca/kotoba/pop-answers](https://johnmorrisdotca.github.io/kotoba/docs/api/pop-answers/index.md): Pop-culture answers
- [@johnmorrisdotca/kotoba/pop-guesses](https://johnmorrisdotca.github.io/kotoba/docs/api/pop-guesses/index.md): Pop-culture guesses
- [@johnmorrisdotca/kotoba/kana-3](https://johnmorrisdotca.github.io/kotoba/docs/api/kana-3/index.md): Three-kana words
- [@johnmorrisdotca/kotoba/kana-4](https://johnmorrisdotca.github.io/kotoba/docs/api/kana-4/index.md): Four-kana words
- [@johnmorrisdotca/kotoba/kana-5](https://johnmorrisdotca.github.io/kotoba/docs/api/kana-5/index.md): Five-kana words
- [@johnmorrisdotca/kotoba/cli](https://johnmorrisdotca.github.io/kotoba/docs/api/cli/index.md): Command line
- [@johnmorrisdotca/kotoba/load](https://johnmorrisdotca.github.io/kotoba/docs/api/load/index.md): Load dictionaries
- [@johnmorrisdotca/kotoba/play](https://johnmorrisdotca.github.io/kotoba/docs/api/play/index.md): Playable game
- [@johnmorrisdotca/kotoba/element](https://johnmorrisdotca.github.io/kotoba/docs/api/element/index.md): Game element
- [@johnmorrisdotca/kotoba/element/define](https://johnmorrisdotca.github.io/kotoba/docs/api/element-define/index.md): Register the game
- [@johnmorrisdotca/kotoba](https://johnmorrisdotca.github.io/kotoba/docs/api/main/index.md): Kotoba: word lists and the rules of word games, in English, French, German and Japanese.

## Optional

- [Changelog](https://johnmorrisdotca.github.io/kotoba/docs/changelog.md): every release
- [Every export, in full](https://johnmorrisdotca.github.io/kotoba/llms-full.txt)
- [Source](https://github.com/johnmorrisdotca/kotoba)