@johnmorrisdotca/kumimoji 1.2.2 → 1.3.1

package/dist/ui.d.ts

@@ -3,7 +3,7 @@
  * (`mountKumimoji`), and the window a board shows the grid through
  * (`boardModel`). Its own entry, so the rules never carry a stylesheet.
  */
-export { mountKumimoji, type KumimojiTableHandle, type KumimojiTableOptions } from "./ui/mount.ts";
-export { BOARD_LEAST, BOARD_MARGIN, boardModel, type BoardModel, type BoardSquare, type TileMark } from "./ui/board.ts";
+export { KUMIMOJI_STRINGS, type KumimojiLocale, type KumimojiStrings, kumimojiSay, kumimojiStrings, } from "./strings.ts";
+export { BOARD_LEAST, BOARD_MARGIN, type BoardModel, type BoardSquare, boardModel, type TileMark } from "./ui/board.ts";
+export { type KumimojiTableHandle, type KumimojiTableOptions, mountKumimoji } from "./ui/mount.ts";
 export { KUMIMOJI_STYLE } from "./ui/style.ts";
-export { KUMIMOJI_STRINGS, kumimojiSay, kumimojiStrings, type KumimojiLocale, type KumimojiStrings } from "./strings.ts";

package/dist/ui.js

@@ -3,7 +3,7 @@
  * (`mountKumimoji`), and the window a board shows the grid through
  * (`boardModel`). Its own entry, so the rules never carry a stylesheet.
  */
-export { mountKumimoji } from "./ui/mount.js";
+export { KUMIMOJI_STRINGS, kumimojiSay, kumimojiStrings, } from "./strings.js";
 export { BOARD_LEAST, BOARD_MARGIN, boardModel } from "./ui/board.js";
+export { mountKumimoji } from "./ui/mount.js";
 export { KUMIMOJI_STYLE } from "./ui/style.js";
-export { KUMIMOJI_STRINGS, kumimojiSay, kumimojiStrings } from "./strings.js";

package/dist/version.d.ts

@@ -1,2 +1,9 @@
-/** The version of this package, as `package.json` has it. A test holds the two together. */
-export declare const KUMIMOJI_VERSION = "1.2.2";
+/** The version of this package, as `package.json` has it. A test holds the two together.
+ *
+ * @example
+ * ```ts
+ * import { KUMIMOJI_VERSION } from "@johnmorrisdotca/kumimoji";
+ * console.log(KUMIMOJI_VERSION);
+ * ```
+ */
+export declare const KUMIMOJI_VERSION = "1.3.1";

package/dist/version.js

@@ -1,2 +1,9 @@
-/** The version of this package, as `package.json` has it. A test holds the two together. */
-export const KUMIMOJI_VERSION = "1.2.2";
+/** The version of this package, as `package.json` has it. A test holds the two together.
+ *
+ * @example
+ * ```ts
+ * import { KUMIMOJI_VERSION } from "@johnmorrisdotca/kumimoji";
+ * console.log(KUMIMOJI_VERSION);
+ * ```
+ */
+export const KUMIMOJI_VERSION = "1.3.1";

package/dist/wilds.d.ts

@@ -21,7 +21,28 @@ import type { TileWords } from "./tileWords.ts";
  * table names the run as the player spelled it. It gives up, answering null,
  * past `WILD_SEARCH_MOST` steps: a grid it could not settle is not called
  * sound.
+ *
+ * @example
+ * ```ts
+ * import { WILD_SEARCH_MOST } from "@johnmorrisdotca/kumimoji";
+ * console.log(WILD_SEARCH_MOST);
+ * ```
  */
 export declare const WILD_SEARCH_MOST = 20000;
-/** The grid with every blank wild read as a letter that makes all its runs words, or null for none; the grid itself when it holds no blank. */
+/** The grid with every blank wild read as a letter that makes all its runs words, or null for none; the grid itself when it holds no blank.
+ *
+ * @param tiles - The map from row,column square names to internal tile codes.
+ * @param words - The loaded native language word list and tile mappings.
+ * @param rules - Whether diagonal runs are also judged.
+ * @returns The grid with every blank wild read as a letter that makes all its runs words, or null for none; the grid itself when it holds no blank.
+ * @example
+ * ```ts
+ * import { loadTileWordsFromModule } from "@johnmorrisdotca/kumimoji/words";
+ * import { readWilds } from "@johnmorrisdotca/kumimoji";
+ *
+ * const words = await loadTileWordsFromModule("english");
+ * const tiles = new Map([["0,0","c"],["0,1","a"],["0,2","t"]]);
+ * console.log(readWilds(tiles,words));
+ * ```
+ */
 export declare function readWilds(tiles: Tiles, words: TileWords, rules?: GridRules): Tiles | null;

package/dist/wilds.js

@@ -20,9 +20,30 @@ import { runsOf } from "./grid.js";
  * table names the run as the player spelled it. It gives up, answering null,
  * past `WILD_SEARCH_MOST` steps: a grid it could not settle is not called
  * sound.
+ *
+ * @example
+ * ```ts
+ * import { WILD_SEARCH_MOST } from "@johnmorrisdotca/kumimoji";
+ * console.log(WILD_SEARCH_MOST);
+ * ```
+ */
+export const WILD_SEARCH_MOST = 20_000;
+/** The grid with every blank wild read as a letter that makes all its runs words, or null for none; the grid itself when it holds no blank.
+ *
+ * @param tiles - The map from row,column square names to internal tile codes.
+ * @param words - The loaded native language word list and tile mappings.
+ * @param rules - Whether diagonal runs are also judged.
+ * @returns The grid with every blank wild read as a letter that makes all its runs words, or null for none; the grid itself when it holds no blank.
+ * @example
+ * ```ts
+ * import { loadTileWordsFromModule } from "@johnmorrisdotca/kumimoji/words";
+ * import { readWilds } from "@johnmorrisdotca/kumimoji";
+ *
+ * const words = await loadTileWordsFromModule("english");
+ * const tiles = new Map([["0,0","c"],["0,1","a"],["0,2","t"]]);
+ * console.log(readWilds(tiles,words));
+ * ```
  */
-export const WILD_SEARCH_MOST = 20000;
-/** The grid with every blank wild read as a letter that makes all its runs words, or null for none; the grid itself when it holds no blank. */
 export function readWilds(tiles, words, rules = {}) {
     const blanks = [...tiles].filter(([, tile]) => tile === "*").map(([square]) => square);
     if (blanks.length === 0)
@@ -103,7 +124,8 @@ function patternFits(words) {
             return already;
         const found = (words.byLength.get(sounds.length) ?? []).some((word) => {
             const letters = [...word];
-            return letters.length === sounds.length && sounds.every((sound, at) => sound === null || words.soundOf(letters[at]) === sound);
+            return (letters.length === sounds.length &&
+                sounds.every((sound, at) => sound === null || words.soundOf(letters[at]) === sound));
         });
         known.set(key, found);
         return found;

package/package.json

@@ -1,73 +1,74 @@
 {
   "name": "@johnmorrisdotca/kumimoji",
-  "version": "1.2.2",
-  "description": "Crossword tile race: each player builds a crossword from a bag of letter tiles, in English or Japanese kana, alone against the clock or at a table of two to eight. Seeded deals, a computer player and a playable table. Zero dependencies.",
+  "version": "1.3.1",
+  "description": "Kumimoji 組み文字 — Crossword tile game in English and Japanese: seeded bags, solo races, two-to-eight-player tables, word lists and a playable table for React, Vue, Svelte, Angular or plain HTML. Zero dependencies.",
   "keywords": [
-    "word-game",
-    "custom-element",
-    "web-component",
-    "word-puzzle",
-    "crossword",
-    "crossword-game",
-    "crossword-builder",
-    "tile-game",
-    "letter-tiles",
-    "tiles",
-    "word-tiles",
+    "ai",
     "anagram",
     "anagrams",
-    "word-race",
-    "spelling",
-    "vocabulary",
+    "angular",
+    "blank-tiles",
+    "bot",
+    "browser-game",
+    "computer-player",
+    "crossword",
+    "crossword-builder",
+    "crossword-game",
+    "custom-element",
+    "dark-mode",
+    "deterministic",
     "dictionary",
-    "word-list",
-    "word-check",
-    "word-validation",
+    "dom",
     "english",
-    "japanese",
-    "kana",
-    "hiragana",
-    "nihongo",
-    "language-learning",
-    "scowl",
-    "jmdict",
-    "wild-tiles",
-    "blank-tiles",
+    "esm",
+    "export",
     "game",
     "game-engine",
-    "rules-engine",
     "game-logic",
-    "puzzle",
-    "puzzle-generator",
-    "seeded",
-    "deterministic",
-    "prng",
-    "ai",
-    "computer-player",
-    "bot",
-    "multiplayer",
-    "pass-and-play",
+    "hiragana",
     "hotseat",
-    "party-game",
-    "save-game",
-    "json",
-    "export",
-    "import",
-    "browser-game",
     "html5-game",
-    "typescript",
+    "i18n",
+    "import",
+    "japanese",
     "javascript",
-    "esm",
+    "jmdict",
+    "json",
+    "kana",
+    "language-learning",
+    "letter-tiles",
+    "multiplayer",
+    "nihongo",
+    "party-game",
+    "pass-and-play",
+    "prng",
+    "puzzle",
+    "puzzle-generator",
     "react",
     "react-component",
-    "vue",
+    "rules-engine",
+    "save-game",
+    "scowl",
+    "scrabble-like",
+    "seeded",
+    "spelling",
     "svelte",
-    "angular",
-    "vanilla-js",
-    "dom",
-    "i18n",
     "theming",
-    "dark-mode",
+    "tile-game",
+    "tiles",
+    "typescript",
+    "vanilla-js",
+    "vocabulary",
+    "vue",
+    "web-component",
+    "wild-tiles",
+    "word-check",
+    "word-game",
+    "word-list",
+    "word-puzzle",
+    "word-race",
+    "word-tiles",
+    "word-validation",
     "zero-dependencies"
   ],
   "homepage": "https://johnmorrisdotca.github.io/kumimoji/",
@@ -134,19 +135,25 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "lint": "eslint .",
+    "lint": "biome check .",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
-    "test:table": "pnpm site && playwright test",
+    "test:table": "pnpm test:demo",
     "test:package": "pnpm build && node scripts/check-package.mjs",
     "family:readme": "node scripts/family-readme.mjs",
     "test:frameworks": "pnpm build && node scripts/check-frameworks.mjs",
-    "check": "pnpm lint && pnpm typecheck && pnpm test",
+    "check:size": "node scripts/check-size.mjs",
+    "check": "pnpm lint && pnpm typecheck && pnpm test && pnpm check:size",
     "site": "pnpm build && node scripts/site.mjs",
     "docs:make": "node scripts/docs.mjs",
     "prepublishOnly": "pnpm check && pnpm build",
     "screenshots:readme": "pnpm site && node scripts/readme-pictures.mjs",
-    "test:readme": "pnpm build && node scripts/check-readme-examples.mjs"
+    "test:readme": "pnpm build && node scripts/check-readme-examples.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",
+    "test:demo": "pnpm site && node scripts/docs-site.mjs build && playwright test",
+    "format": "biome check --write ."
   },
   "peerDependencies": {
     "react": ">=18"
@@ -157,16 +164,16 @@
     }
   },
   "devDependencies": {
-    "@eslint/js": "^9.0.0",
+    "@biomejs/biome": "2.6.4",
     "@playwright/test": "^1.63.0",
     "@types/node": "^24.0.0",
     "@types/react": "^19.0.0",
-    "eslint": "^9.0.0",
+    "esbuild": "^0.28.0",
     "eslint-plugin-react-hooks": "^5.0.0",
-    "globals": "^16.0.0",
+    "marked": "^18.0.0",
+    "pagefind": "^1.5.2",
     "react": "^19.0.0",
     "typescript": "^5.9.0",
-    "typescript-eslint": "^8.0.0",
     "vitest": "^5.0.0"
   },
   "publishConfig": {