@johnmorrisdotca/kumimoji 1.3.0 → 1.3.1

package/CHANGELOG.md

@@ -6,6 +6,18 @@ All notable changes to this project are written down here. The format follows
 
 ## [Unreleased]
 
+## [1.3.1] - 2026-10-31
+
+### Changed
+
+- Biome replaces ESLint as the formatter and linter, with the family's shared settings in `scripts/biome-family.json`; `pnpm lint` checks formatting too, and `pnpm format` applies 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 check` also 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.yml` invalid YAML.
+
 ## [1.3.0] - 2026-10-14
 
 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.

package/CONTRIBUTING.md

@@ -21,7 +21,8 @@ shape before you spend time on it. Taking part follows the
 
 ```sh
 pnpm install
-pnpm check          # lint, types and tests: the same as CI
+pnpm check          # format, lint, types, file sizes and tests: the same as CI
+pnpm format         # format the code and apply the safe lint fixes
 pnpm test:package   # pack it as npm does, install it in an empty project, import every entry
 pnpm site           # build the demo into ./site, as GitHub Pages publishes it
 ```
@@ -31,12 +32,18 @@ data scripts) are listed under its own heading below.
 
 ## House rules, shared by every package of the family
 
+How the code is written, formatted and checked, and why, is in
+[CODE-STYLE.md](CODE-STYLE.md), the same text in every package.
+
 - **No runtime dependencies.** Development dependencies are for tests, builds and
   documentation only.
 - **The core is pure.** Every function in it returns new values and never
   changes what it was given.
 - **Test what you change.** Tests sit beside the code they test. A rule you
   change has a test that would have caught it.
+- **At most 500 lines of code a file** under `src/`, not counting blank lines,
+  comments, tests or `*.data.ts` data. A file that reaches it is split by what
+  it does, never squeezed.
 - **Words a person reads come in English and Japanese.** If you cannot write the
   Japanese, say so in the pull request and someone will.
 - **Option values and names are kebab case.**
@@ -48,7 +55,9 @@ data scripts) are listed under its own heading below.
   together with the code.
 - **The family's own files are the same in every package**: `demo/family.css`,
   `scripts/family-template.mjs`, `scripts/family-readme.mjs`,
-  `scripts/release-notes.mjs`, the files in `scripts/community/` and
+  `scripts/release-notes.mjs`, the files in `scripts/community/`,
+  `CODE-STYLE.md`, `scripts/biome-family.json`, `scripts/check-size.mjs`,
+  `src/embed-attributes.ts` where the package has an element, and
   `family.test.js` (in `src/`, or in `test/`). Do not edit one here. To change
   one, change it in every repository at once, bump `FAMILY_TEMPLATE_VERSION` for
   the template, and record the new hash in `family.test.js`. What is the

package/README.md

@@ -768,7 +768,7 @@ The JSON, as `kumimojiToJSON` writes it:
 {
   "format": 1,
   "game": "kumimoji",
-  "generator": "kumimoji 1.3.0",
+  "generator": "kumimoji 1.3.1",
   "size": 3,
   "level": "hard",
   "seed": 44,
@@ -1201,7 +1201,7 @@ Please follow the [code of conduct](./CODE_OF_CONDUCT.md). A way to make a check
 
 See [CHANGELOG.md](./CHANGELOG.md).
 
-The latest release is 1.3.0: the table's standard embed attributes, the shared embed builder, and the documentation site with a checked example for every export.
+The latest release, 1.3.1, changes nothing a player sees.
 
 ## Licence
 

package/dist/check.js

@@ -1,6 +1,6 @@
 import { decodeGrid, lettersOf, sameLetters } from "./grid.js";
 import { judgeWithWords } from "./judge.js";
-import { kumimojiTileCount, kumimojiWildCount, KUMIMOJI_SCORE, TILE_MIX_TOTAL } from "./tiles.constants.js";
+import { KUMIMOJI_SCORE, kumimojiTileCount, kumimojiWildCount, TILE_MIX_TOTAL } from "./tiles.constants.js";
 import { tileWords } from "./tileWords.js";
 /**
  * WHETHER A GRID FINISHES A KUMIMOJI: the one check the server also runs.
@@ -62,7 +62,9 @@ export function checkKumimoji(size, givens, answer, options = {}) {
         return { ok: false, reason: "the answer is not a grid" };
     const bagIdentities = bag.map(words.familyKey);
     const tileIdentities = [...tiles.values()].map(words.familyKey);
-    if (bagIdentities.some((tile) => tile === null) || tileIdentities.some((tile) => tile === null) || !sameLetters(lettersOf(tileIdentities), lettersOf(bagIdentities))) {
+    if (bagIdentities.some((tile) => tile === null) ||
+        tileIdentities.some((tile) => tile === null) ||
+        !sameLetters(lettersOf(tileIdentities), lettersOf(bagIdentities))) {
         return { ok: false, reason: "the grid does not use exactly the tiles of the bag" };
     }
     const verdict = judgeWithWords(tiles, words, { diagonals: options.diagonals === true });

package/dist/computerPlay.js

@@ -76,7 +76,7 @@ function lacking(word, hand, most) {
 /** How many tiles already down one word may run through: two lets it bridge a gap, as players do. */
 const CROSSED_MOST = 2;
 /** How many placements are tried in one search at most, so a turn's thinking stays a fraction of a second on a phone. */
-const FITS_MOST = 20000;
+const FITS_MOST = 20_000;
 /** A laying's worth: tiles used first, rare letters next, wilds spent last. */
 function worth(fresh, wilds, words) {
     let rare = 0;
@@ -118,7 +118,8 @@ function layings(play, words, rules) {
     }
     const bounds = boundsOf(play.tiles);
     const fits = (first, last) => bounds === null ||
-        (Math.max(bounds.bottom, last.row) - Math.min(bounds.top, first.row) < KUMIMOJI_GRID_MOST && Math.max(bounds.right, last.col) - Math.min(bounds.left, first.col) < KUMIMOJI_GRID_MOST);
+        (Math.max(bounds.bottom, last.row) - Math.min(bounds.top, first.row) < KUMIMOJI_GRID_MOST &&
+            Math.max(bounds.right, last.col) - Math.min(bounds.left, first.col) < KUMIMOJI_GRID_MOST);
     const found = [];
     let tried = 0;
     let mostFresh = 0;
@@ -150,9 +151,15 @@ function layings(play, words, rules) {
                         if (fit === null)
                             continue;
                         const step = across ? { row: 0, col: 1 } : { row: 1, col: 0 };
-                        if (!fits(fit.first, { row: fit.first.row + (length - 1) * step.row, col: fit.first.col + (length - 1) * step.col }))
+                        if (!fits(fit.first, {
+                            row: fit.first.row + (length - 1) * step.row,
+                            col: fit.first.col + (length - 1) * step.col,
+                        }))
                             continue;
-                        const fresh = fit.fresh.map((square) => ({ square: squareAt(square.row, square.col), letter: word[(square.row - fit.first.row) + (square.col - fit.first.col)] }));
+                        const fresh = fit.fresh.map((square) => ({
+                            square: squareAt(square.row, square.col),
+                            letter: word[square.row - fit.first.row + (square.col - fit.first.col)],
+                        }));
                         const wilds = wildsNeeded(fresh, hand);
                         if (wilds !== null)
                             keep({ word, fresh, wilds, score: worth(fresh, wilds, words) });

package/dist/computerTurn.js

@@ -1,6 +1,6 @@
 import { bestLaying, judgeTiles, tradeChoice } from "./computerPlay.js";
 import { drawAll, isComputer, mayDrawAll, mayTradeThisTurn, seatPlay, withSeatPlay } from "./party.js";
-import { doneRefused, endTurn, goesOut, handCanSpell, isLastTurn, laidThisTurn, mayResign, resign } from "./partyTurns.js";
+import { doneRefused, endTurn, goesOut, handCanSpell, isLastTurn, laidThisTurn, mayResign, resign, } from "./partyTurns.js";
 import { liftAll, mayTrade, trade } from "./play.js";
 /**
  * A COMPUTER'S TURN in a pass-and-play game (John, 2026-09-28: "Also you can
@@ -100,7 +100,10 @@ export function planComputerTurn(game, words) {
             break;
     }
     const hand = now.players[now.turn].hand;
-    const stuck = hand.length > 0 && !laidThisTurn(now) && !mayTrade(seatPlay(now)) && bestLaying(seatPlay(now), words, rules) === null;
+    const stuck = hand.length > 0 &&
+        !laidThisTurn(now) &&
+        !mayTrade(seatPlay(now)) &&
+        bestLaying(seatPlay(now), words, rules) === null;
     const refused = doneRefused(now, verdict(), handSpells) !== null;
     if ((refused || (stuck && !isLastTurn(now))) && mayResign(now)) {
         take(resign(now), { kind: "resigned" });

package/dist/daily.js

@@ -38,5 +38,5 @@ export function kumimojiDay(at) {
  */
 export function kumimojiDailySeed(at) {
     const [year, month, day] = kumimojiDay(at).split("-").map(Number);
-    return year * 10000 + month * 100 + day;
+    return year * 10_000 + month * 100 + day;
 }

package/dist/element.d.ts

@@ -1,5 +1,5 @@
-import { type KumimojiTableHandle, type KumimojiTableOptions } from "./ui/mount.ts";
 import type { KumimojiSaved } from "./export.ts";
+import { type KumimojiTableHandle, type KumimojiTableOptions } from "./ui/mount.ts";
 declare const ElementBase: typeof HTMLElement;
 /**
  * THE `<kumimoji-table>` ELEMENT: a game of Kumimoji alone in a tag, with no