scrabble-solver 2.17.0 → 2.18.1

package/.nx/workspace-data/source-maps.json

@@ -40,6 +40,34 @@
       "packages/configs/package.json",
       "nx/core/package-json"
     ],
+    "tags.npm:scrabble": [
+      "packages/configs/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:board-game": [
+      "packages/configs/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:tile-distribution": [
+      "packages/configs/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:game-config": [
+      "packages/configs/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:literaki": [
+      "packages/configs/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:kelimelik": [
+      "packages/configs/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:super-scrabble": [
+      "packages/configs/package.json",
+      "nx/core/package-json"
+    ],
     "metadata.targetGroups": [
       "packages/configs/package.json",
       "nx/core/package-json"
@@ -174,6 +202,14 @@
       "packages/constants/package.json",
       "nx/core/package-json"
     ],
+    "tags.npm:scrabble": [
+      "packages/constants/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:constants": [
+      "packages/constants/package.json",
+      "nx/core/package-json"
+    ],
     "metadata.targetGroups": [
       "packages/constants/package.json",
       "nx/core/package-json"
@@ -308,6 +344,26 @@
       "packages/dictionaries/package.json",
       "nx/core/package-json"
     ],
+    "tags.npm:scrabble": [
+      "packages/dictionaries/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:dictionary": [
+      "packages/dictionaries/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:gaddag": [
+      "packages/dictionaries/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:word-list": [
+      "packages/dictionaries/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:cache": [
+      "packages/dictionaries/package.json",
+      "nx/core/package-json"
+    ],
     "metadata.targetGroups": [
       "packages/dictionaries/package.json",
       "nx/core/package-json"
@@ -538,6 +594,18 @@
       "packages/logger/package.json",
       "nx/core/package-json"
     ],
+    "tags.npm:logger": [
+      "packages/logger/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:winston": [
+      "packages/logger/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:scrabble": [
+      "packages/logger/package.json",
+      "nx/core/package-json"
+    ],
     "metadata.targetGroups": [
       "packages/logger/package.json",
       "nx/core/package-json"
@@ -704,6 +772,26 @@
       "packages/scrabble-solver/package.json",
       "nx/core/package-json"
     ],
+    "tags.npm:scrabble": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:word-finder": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:solver": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:nextjs": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:react": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
     "metadata.targetGroups": [
       "packages/scrabble-solver/package.json",
       "nx/core/package-json"
@@ -740,6 +828,10 @@
       "packages/scrabble-solver/package.json",
       "nx/core/package-json"
     ],
+    "metadata.targetGroups.NPM Scripts.7": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
     "metadata.description": [
       "packages/scrabble-solver/package.json",
       "nx/core/package-json"
@@ -872,6 +964,34 @@
       "packages/scrabble-solver/package.json",
       "nx/core/package-json"
     ],
+    "targets.generate-scss-types": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
+    "targets.generate-scss-types.executor": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
+    "targets.generate-scss-types.metadata": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
+    "targets.generate-scss-types.options.script": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
+    "targets.generate-scss-types.options": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
+    "targets.generate-scss-types.metadata.scriptContent": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
+    "targets.generate-scss-types.metadata.runCommand": [
+      "packages/scrabble-solver/package.json",
+      "nx/core/package-json"
+    ],
     "targets.start": [
       "packages/scrabble-solver/package.json",
       "nx/core/package-json"
@@ -998,6 +1118,30 @@
       "packages/solver/package.json",
       "nx/core/package-json"
     ],
+    "tags.npm:scrabble": [
+      "packages/solver/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:solver": [
+      "packages/solver/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:gaddag": [
+      "packages/solver/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:move-generation": [
+      "packages/solver/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:word-finder": [
+      "packages/solver/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:anagram": [
+      "packages/solver/package.json",
+      "nx/core/package-json"
+    ],
     "metadata.targetGroups": [
       "packages/solver/package.json",
       "nx/core/package-json"
@@ -1196,6 +1340,26 @@
       "packages/types/package.json",
       "nx/core/package-json"
     ],
+    "tags.npm:scrabble": [
+      "packages/types/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:types": [
+      "packages/types/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:domain-model": [
+      "packages/types/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:board": [
+      "packages/types/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:tiles": [
+      "packages/types/package.json",
+      "nx/core/package-json"
+    ],
     "metadata.targetGroups": [
       "packages/types/package.json",
       "nx/core/package-json"
@@ -1362,6 +1526,22 @@
       "packages/word-definitions/package.json",
       "nx/core/package-json"
     ],
+    "tags.npm:word-definitions": [
+      "packages/word-definitions/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:dictionary": [
+      "packages/word-definitions/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:wiktionary": [
+      "packages/word-definitions/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:scrabble": [
+      "packages/word-definitions/package.json",
+      "nx/core/package-json"
+    ],
     "metadata.targetGroups": [
       "packages/word-definitions/package.json",
       "nx/core/package-json"
@@ -1528,6 +1708,30 @@
       "packages/word-lists/package.json",
       "nx/core/package-json"
     ],
+    "tags.npm:word-list": [
+      "packages/word-lists/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:scrabble": [
+      "packages/word-lists/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:dictionary": [
+      "packages/word-lists/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:sowpods": [
+      "packages/word-lists/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:twl06": [
+      "packages/word-lists/package.json",
+      "nx/core/package-json"
+    ],
+    "tags.npm:sjp": [
+      "packages/word-lists/package.json",
+      "nx/core/package-json"
+    ],
     "metadata.targetGroups": [
       "packages/word-lists/package.json",
       "nx/core/package-json"

package/.oxlintrc.json

@@ -3,15 +3,13 @@
   "plugins": ["eslint", "typescript", "react", "import", "unicorn", "oxc", "jest"],
   "jsPlugins": [
     { "name": "import-js", "specifier": "eslint-plugin-import" },
-    { "name": "mocha", "specifier": "eslint-plugin-mocha" },
+    { "name": "playwright", "specifier": "eslint-plugin-playwright" },
     { "name": "react-js", "specifier": "eslint-plugin-react" }
   ],
   "env": {
     "browser": true,
     "node": true,
     "jest": true,
-    "mocha": true,
-    "jquery": true,
     "serviceworker": true
   },
   "globals": {
@@ -19,8 +17,6 @@
     "RequestInit": "readonly",
     "ServiceWorkerGlobalScope": "readonly",
     "beforeAll": "readonly",
-    "cy": "readonly",
-    "Cypress": "readonly",
     "define": "readonly",
     "describe": "readonly",
     "expect": "readonly",
@@ -43,7 +39,7 @@
     "import-js/resolver": {
       "typescript": {
         "alwaysTryTypes": true,
-        "project": ["tsconfig.json", "packages/*/tsconfig.json", "cypress/tsconfig.json"]
+        "project": ["tsconfig.json", "packages/*/tsconfig.json", "e2e/tsconfig.json"]
       },
       "node": true
     }
@@ -56,9 +52,9 @@
     "**/node_modules/**/*",
     "**/*.d.ts",
     "**/.eslintrc.js",
-    "**/babel.config.js",
     "**/bump-version.js",
     "packages/scrabble-solver/next.config.js",
+    "scripts/record-screencast.ts",
     "packages/logger/scripts/stats.js",
     "packages/scrabble-solver/public/service-worker.js",
     "**/.next/**/*"
@@ -81,7 +77,6 @@
       }
     ],
 
-    "mocha/no-exclusive-tests": "error",
     "jest/no-focused-tests": "error",
 
     "react-js/no-deprecated": "error",
@@ -262,7 +257,7 @@
   },
   "overrides": [
     {
-      "files": ["packages/*/benchmarks/**"],
+      "files": ["packages/*/benchmarks/**", "packages/*/scripts/**"],
       "rules": {
         "no-console": "off"
       }
@@ -303,11 +298,13 @@
       }
     },
     {
-      "files": ["**/*.spec.cy.ts", "cypress/**"],
+      "files": ["e2e/**"],
       "rules": {
         "max-statements": "off",
+        "max-lines": "off",
         "jest/valid-expect": "off",
-        "jest/no-focused-tests": "off"
+        "jest/no-focused-tests": "off",
+        "playwright/no-focused-test": "error"
       }
     },
     {

package/CLAUDE.md

@@ -30,15 +30,17 @@ The GADDAG itself lives outside this repo, in [`@kamilmielnik/gaddag`](https://g
 ### App package (`@scrabble-solver/scrabble-solver`)
 
 - **Routing**: Next.js Pages Router (`src/pages/`). API routes: `solve`, `verify`, `visit`, `dictionary/[locale]` (binary GADDAG download), and `dictionary/[locale]/[word]` (definitions). The path alias `@/*` resolves to `src/*` (set in `tsconfig.json`).
-- **State**: Redux Toolkit + Redux-Saga. Slices in `src/state/{board,cellFilters,dictionary,hoveredTile,rack,results,settings,solve,verify}`, each exporting `<name>Slice` (reducer + actions) and selectors. The root saga in `state/sagas.ts` reacts to slice actions: `submit` → call SDK → write results back. `solve`, `verify`, and `dictionary` use `takeLatest` (only the latest in-flight request resolves); cell/rack edits use `takeEvery`. State is intentionally **not** serializable-checked (`serializableCheck: false`) because slices hold class instances (`Board`, `Tile`).
+- **State**: Redux Toolkit + Redux-Saga. Slices in `src/state/{app,board,cellFilters,dictionary,hoveredTile,i18n,rack,results,settings,solve,verify}`, each exporting `<name>Slice` (reducer + actions) and selectors. The root saga in `state/sagas.ts` reacts to slice actions: `submit` → call SDK → write results back. `solve`, `verify`, and `dictionary` use `takeLatest` (only the latest in-flight request resolves); cell/rack edits use `takeEvery`. State is intentionally **not** serializable-checked (`serializableCheck: false`) because slices hold class instances (`Board`, `Tile`). `initialize({ version })` carries the app version (from `getStaticProps`) into the `app` slice; the translations cache is keyed on it.
+- **Board render budget**: `Cell`/`Tile` render 225+ times at once and must not subscribe to the store — every value they need flows down from `BoardPure` as memo-friendly props, and event handlers read state at event time via `useTypedStore().getState()` (see `Cell.tsx`). Anything added to a cell that subscribes via `useSelector` multiplies by 225 and shows up directly in TBT.
 - **SDK layer (`src/sdk/`)**: thin browser/server clients for the four API routes. `findWordDefinitions` is memoized at the saga level via `lib/memoize`. Always go through SDK — never `fetch` directly from a saga or component.
-- **Persistence**: settings, board, and rack auto-persist to `localStorage` via `store2` under the `scrabble-solver` namespace. The `useLocalStorage` hook (mounted in `pages/index.tsx`) subscribes to the three slices and writes them out on every change — **adding a new field to `SettingsState` is enough; you don't need to touch any save code** (PR #321, Apr 2026). On boot, `settingsInitialState` spreads `localStorage.getSettings()` last so persisted values win over the defaults computed at module-load time. When changing settings shape, add a migration block (see `migrateLegacySettings` for the pattern — dated comment with introduction date and life expectancy).
-- **Service worker**: built by `WorkboxPlugin.InjectManifest` from `src/service-worker/index.ts` to `public/service-worker.js`. It precaches the app shell and intercepts `/api/solve` and `/api/verify` requests so the app can still solve offline once a dictionary is cached. Only generated in production builds (`!isServer && !dev`).
-- **i18n**: `src/i18n/languages/<lang>.json` (8 languages, mapped to `Locale` in `i18n.ts`). The `LOCALE_FEATURES` registry in `src/i18n/constants.ts` carries per-locale UI metadata: `direction` ('ltr' | 'rtl'), `comma`/`separator` glyphs (Latin vs Arabic), flag `Icon`, language `label`/`name`, and `consonants`/`vowels` flags that drive the auto-group-tiles UI. The `useDirection` hook applies `direction` to `<html dir>`. Add a new locale by extending this map plus the i18n JSON dictionary plus a `Flag<XX>.svg` icon. `useTranslate()` is the lookup hook.
-- **Layout**: `AppLayoutProvider` (`src/app-layout/`) is a React context exposing `useAppLayoutValue`. It was extracted from a custom hook for memoization reasons — consume layout via `useAppLayout()`, not by re-deriving it. The active modal in `pages/index.tsx` is tracked as a `Record<Modal, boolean>` patched through a single `patchModals` callback.
-- **Styling**: SCSS modules with a shared design-token system. SCSS tokens live in `src/styles/_tokens.scss`; the same values are re-exported to TS via `:export` in `variables.module.scss` (imported in JS as a module, typed by `src/@types/scss.d.ts`). Concrete JS constants live in `src/parameters/index.ts` (e.g. `BREAKPOINTS`, `COLOR_BLUE`, `TRANSITION_DURATION`) — that file is the only place that should read from `variables.module.scss`. Update `_tokens.scss` first → expose via `variables.module.scss` `:export` block → consume via `parameters/`. This was added in PR #228 (Apr 2026); before it, JS-side colors and breakpoints were hard-coded duplicates. Responsive helpers come from `include-media`.
+- **Persistence**: settings, board, and rack auto-persist to `localStorage` via `store2` under the `scrabble-solver` namespace. The `useLocalStorage` hook (mounted in `pages/index.tsx`) subscribes to the three slices and writes them out on every change (skipping each effect's first post-hydration run, which would only echo what was just read) — **adding a new field to `SettingsState` is enough; you don't need to touch any save code** (PR #321, Apr 2026). Boot state is deterministic (SSR/hydration must match — issue #412): persisted settings/board/rack are applied post-mount by `hydratePersistedState` in the `initialize()` saga, guarded so a throw leaves the deterministic defaults and `app.hydrated` still fires (`finally`) — otherwise persistence would silently die for the session. The `state/localStorage.ts` getters treat corrupt/mismatched entries as absent and remove them; the saga skips no-op `init` dispatches so an empty-storage boot changes no state identities and re-renders nothing. The active locale's translations are also cached (`translations` key, keyed by app version + locale) and hydrated synchronously so a returning user's first post-hydration paint is already translated. When changing settings shape, add a migration block (see `migrateLegacySettings` for the pattern — dated comment with introduction date and life expectancy).
+- **Service worker**: built by `WorkboxPlugin.InjectManifest` from `src/service-worker/index.ts` to `public/service-worker.js`. It precaches the app shell and intercepts `/api/solve` and `/api/verify` requests so the app can still solve offline once a dictionary is cached. Only generated in production builds (`!isServer && !dev`). The precache excludes `.css` — every page inlines its stylesheets (see `_document.tsx`), so the emitted CSS files are never requested.
+- **i18n**: `src/i18n/languages/<lang>.json` (8 languages, mapped to `Locale` in `i18n.ts`). English is statically bundled; every other locale is a dynamic-import chunk (`loadTranslations`), loaded into the `i18n` slice — `selectTranslations` falls back to the complete English object, so missing keys are impossible mid-load. All locales preload on idle/first intent (`preloadTranslationsWhenIdle`), which is what makes switching languages apply instantly; the active locale is additionally cached in localStorage (see Persistence). The `LOCALE_FEATURES` registry in `src/i18n/constants.ts` carries per-locale UI metadata: `direction` ('ltr' | 'rtl'), `comma`/`separator` glyphs (Latin vs Arabic), language `label`/`name`, and `consonants`/`vowels` flags that drive the auto-group-tiles UI; flag icons live separately in `src/i18n/localeIcons.ts` (`LOCALE_ICONS`) so they stay out of the main bundle. The `useDirection` hook applies `direction` to `<html dir>`. Add a new locale by extending both maps plus the i18n JSON dictionary plus a `Flag<XX>.svg` icon. `useTranslate()` is the lookup hook.
+- **Layout**: all layout sizing lives in CSS custom properties (`src/styles/variables.scss`: `--cell-size`, `--rack-tile-size`, `--max-board-width`, …), with the config-dependent inputs (`--board-cols`, `--board-rows`, `--rack-size`) set on `:root` twice: before first paint by an inline script in `_document.tsx` (which reads persisted settings, also sets `dir`/`lang`, and adds the `config-pending` class that hides `main` until hydration applies a persisted non-default game — see `CONFIG_PENDING_CLASS`), and post-hydration by an effect in `pages/index.tsx`. There is no JS layout hook — components size themselves via these variables (the board grid templates use `repeat(var(--board-cols), …)` so the held board has its final geometry pre-hydration); JS reads viewport state only through `useMediaQuery`. **Boot-path DOM rules**: never read computed style in mount effects (forced reflow — compare against inline style or known defaults instead), and guard same-value writes to `<html>` attributes/variables (they invalidate style/paint document-wide and destabilize LCP). The active modal in `pages/index.tsx` is tracked as a `Record<Modal, boolean>` patched through a single `patchModals` callback; each modal mounts on first open and stays mounted (`mountedModals` latch), because a `next/dynamic({ssr: false})` component starts its chunk request during render.
+- **Styling**: SCSS modules with a shared design-token system. When one module's class overrides another component's styles (e.g. `Actions` restyling `Button`), it must win on **specificity**, not stylesheet order — webpack's CSS emission order shifts with the import graph (this flipped once and widened a square button). Class names are type-checked (#16): `scripts/generate-scss-types.ts` writes a git-ignored sibling `.d.ts` for every `*.module.scss` — the `build` and `type-check` scripts run it up front, `dev` runs it in watch mode, and its sass options mirror `sassOptions` in `next.config.js`. `src/@types/scss.d.ts` only covers side-effect imports of non-module stylesheets, deliberately exporting nothing so an import of an ungenerated module fails the type-check. SCSS tokens live in `src/styles/_tokens.scss`; the same values are re-exported to TS via `:export` in `variables.module.scss`. Concrete JS constants live in `src/parameters/index.ts` (e.g. `BREAKPOINTS`, `COLOR_BLUE`, `TRANSITION_DURATION`) — that file is the only place that should read from `variables.module.scss`. Update `_tokens.scss` first → expose via `variables.module.scss` `:export` block → consume via `parameters/`. This was added in PR #228 (Apr 2026); before it, JS-side colors and breakpoints were hard-coded duplicates. Responsive helpers come from `include-media`.
 - **SVGs**: imported as React components via `@svgr/webpack` (configured in `next.config.js`), typed by `src/@types/svg.d.ts`.
-- **Service worker registration**: production-only. Registered by `serviceWorkerManager.ts` from the index page; Cypress tests must call `unregisterServiceWorkers()` (in `cypress/support/lib`) in `beforeEach` and `cy.clearLocalStorage()` in `afterEach` to avoid bleed-through between tests.
+- **Service worker registration**: production-only. Registered by `serviceWorkerManager.ts` from the index page, deferred until load + idle (`waitForIdle`) so the install's precache downloads never compete with page resources (an eager install once caused Lighthouse's robots.txt fetch to time out). Playwright blocks registration entirely via `serviceWorkers: 'block'` in `playwright.config.ts`, and each test gets a fresh browser context, so e2e tests need no service-worker or localStorage cleanup.
+- **Deferral pattern**: anything that shouldn't compete with boot goes through `lib/waitForIdleOrFirstIntent.ts` (load + `requestIdleCallback`, or first pointerdown/keydown) — translations preload, modal chunk warming, and `visit()`; service worker registration is idle-only (`waitForIdle`), and the dictionary prefetch is intent-only (`waitForFirstIntent` — the multi-MB download is pointless for passive visitors and would land in Lighthouse's payload audit). Tooltips defer their floating-ui setup one task past hydration via `useDeferredRender`.
 
 ## Common commands
 
@@ -59,9 +61,9 @@ All commands run from the repo root unless noted.
 | One unit test file | `cd packages/solver && bun test src/solve.test.ts` |
 | One unit test by name | `cd packages/solver && bun test -t "pattern"` |
 | Solver benchmarks | `bun run benchmark` (rewrites the results table + chart in `packages/solver/README.md`) |
-| Cypress (interactive) | `bun run test-cypress` (expects dev server on :3000) |
-| Cypress (headless) | `bun run test-cypress:run` (expects server on :3333) |
-| Full test pipeline | `bun run test` (build → unit → `start-server-and-test` boots the app on :3333 → cypress run) — note: `bun test` invokes Bun's built-in test runner, not this script |
+| Playwright (UI mode) | `bun run test-playwright` (expects dev server on :3000) |
+| Playwright (headless) | `bun run test-playwright:run` (expects server on :3333) |
+| Full test pipeline | `bun run test` (build → unit → `start-server-and-test` boots the app on :3333 → playwright test) — note: `bun test` invokes Bun's built-in test runner, not this script |
 
 Hot reload only works for the `scrabble-solver` package. Edits to any other package require rebuilding that package before the app picks them up.
 
@@ -71,15 +73,15 @@ Hot reload only works for the `scrabble-solver` package. Edits to any other pack
 - Only `dictionaries`, `solver`, `word-definitions`, and `scrabble-solver` have a `test` script. Tests are auto-discovered under `src/` matching `*.test.ts(x)`. The 180s timeout is needed because some solver tests build a real `Gaddag` from a downloaded dictionary.
 - `bunfig.toml` + `bun.test.preload.ts` register a SCSS loader stub (returns a `Proxy` whose keys are their own names) so component tests can import `*.scss` modules without a real compiler. If you add other non-JS imports to test-touched code (images, etc.), extend the preload.
 - Each package's `tsconfig.json` excludes `**/*.test.ts` from the build output. Tests are not part of published packages.
-- Cypress: tests in `cypress/e2e/`. Custom command setup in `cypress/support/commands.ts` (registers `@testing-library/cypress` and `cypress-real-events`). Two base URLs are in play: `cypress.config.ts` defaults to `http://localhost:3000` (matches `bun run dev`); `test-cypress:run` and CI override to `:3333` (matches `bun start`). Pick the script that matches the server you're actually running. `cypress.config.ts` registers `@cypress/webpack-batteries-included-preprocessor` from npm as the `file:preprocessor` — the copy bundled inside Cypress 15.19.0 crashes on TypeScript 7 projects (its `@babel/preset-typescript` ships without a `package.json`); drop the override once a fixed Cypress release lands.
+- Playwright: specs in `e2e/` (`app.spec.ts`, `bugs/`, `features/`), shared page helpers in `e2e/lib/` (selectors return `Locator`s, actions take `page` first). Two base URLs are in play: `playwright.config.ts` defaults to `http://localhost:3000` (matches `bun run dev`); `test-playwright:run` and CI set `PLAYWRIGHT_BASE_URL=http://localhost:3333` (matches `bun start`). Pick the script that matches the server you're actually running. The config blocks service workers and runs Chromium only; browser binaries come from `bunx playwright install chromium`.
 
 ## Tooling specifics
 
 - **Linting**: `oxlint` (Rust-based ESLint replacement) configured in `.oxlintrc.json`. Type-aware rules require `oxlint-tsgolint`. Adding a new top-level JS config file usually means adding it to `ignorePatterns`. The oxlint config still loads the `jest` plugin and `jest` global because Bun's test runner mirrors the Jest API; do not remove them.
 - **Formatting**: `oxfmt` covers `*.{js,ts,tsx,scss}`.
 - **Install layout**: `bunfig.toml` pins `[install] linker = "hoisted"`. With Bun's isolated layout, `next build` fails — webpack bundles `unzipper` from `word-lists` and errors on its uninstalled optional `@aws-sdk/client-s3` dependency. Don't remove it.
-- **TypeScript**: stable TypeScript 7 (`typescript@^7.0.2`), whose `tsc` is the native Go compiler. It runs every package `build`, the app's `type-check`, and `next build` — the latter because Next.js runs the project-local `tsc` CLI (TS7 has no JS compiler API). Next 16.3.0 turned that on by default, so the `experimental.useTypeScriptCli` flag that pinned the app to the 16.3 preview line is gone from `next.config.js`; set it to `false` only to opt back into the JS compiler API, which TS7 cannot serve. The interim `@typescript/native-preview` (`tsgo`) setup from PR #422 was removed (Aug 2026). Root `tsconfig.json` sets `types: ["bun"]` for global test-runner types and excludes `cypress` and `cypress.config.ts`; library packages extend it and additionally exclude `**/*.test.ts` from emitted output.
-- **Next.js**: built with `--webpack` flag explicitly (the default Turbopack is intentionally not used). `next.config.js` registers `@svgr/webpack` for SVG-as-component imports and the Workbox `InjectManifest` plugin for the service worker. SCSS load paths are extended to `./src` and `node_modules/include-media/dist`.
+- **TypeScript**: stable TypeScript 7 (`typescript@^7.0.2`), whose `tsc` is the native Go compiler. It runs every package `build`, the app's `type-check`, and `next build` — the latter because Next.js runs the project-local `tsc` CLI (TS7 has no JS compiler API). Next 16.3.0 turned that on by default, so the `experimental.useTypeScriptCli` flag that pinned the app to the 16.3 preview line is gone from `next.config.js`; set it to `false` only to opt back into the JS compiler API, which TS7 cannot serve. The interim `@typescript/native-preview` (`tsgo`) setup from PR #422 was removed (Aug 2026). Root `tsconfig.json` sets `types: ["bun"]` for global test-runner types and excludes `e2e` and `playwright.config.ts` (covered by `e2e/tsconfig.json` instead); library packages extend it and additionally exclude `**/*.test.ts` from emitted output.
+- **Next.js**: built with `--webpack` flag explicitly (the default Turbopack is intentionally not used). `next.config.js` registers `@svgr/webpack` for SVG-as-component imports and the Workbox `InjectManifest` plugin for the service worker, and stubs out Next's unconditionally-bundled ES2019-2022 polyfills (`polyfill-module`) with `empty-module.js` via `NormalModuleReplacementPlugin` — every browserslist target (`package.json` `browserslist`: Chrome/Edge/Firefox ≥ 100, Safari ≥ 15.4, …) supports those natively, and browserslist alone does not control that chunk. SCSS load paths are extended to `./src` and `node_modules/include-media/dist`.
 - **Nx**: `nx.json` only defines a `build` target with `dependsOn: ["^build"]` and `cache: true`. It is used purely for dependency-aware build ordering and caching — there are no Nx generators or executors.
 
 ## CI workflows
@@ -88,9 +90,9 @@ Hot reload only works for the `scrabble-solver` package. Edits to any other pack
 
 - `build.yml` — `bun install --frozen-lockfile && bun run build`.
 - `unit.yml` — `bun run build && bun run test-unit`.
-- `e2e.yml` — Cypress (`cypress-io/github-action`) against the production server on :3333. Uploads screenshots on failure.
+- `e2e.yml` — Playwright against the app on :3333 (via `start-server-and-test`). Uploads the HTML report and traces on failure.
 - `oxlint.yml` / `oxfmt.yml` — lint and format-check. `oxlint.yml` runs `bun run build` first because type-aware rules need built packages.
-- `bunx.yml` / `npx.yml` — run daily, on push to master, and via `workflow_dispatch`. They poll npm (up to 15 min) until the current version of every workspace package is published, download the published `scrabble-solver` tarball with `npm pack`, install the global binary (`bun add --global` / `npm install --global`), pre-warm the dictionaries cache, then run Cypress from the extracted tarball against that binary. The Cypress specs come from the published package, **not** from `master` — if they came from master, any spec added for a feature that's merged but not yet released would run against the older published binary that lacks the feature, and fail (#428). Catches packaging regressions in the `bin/scrabble-solver.js` launcher.
+- `bunx.yml` / `npx.yml` — run daily, on push to master, and via `workflow_dispatch`. They poll npm (up to 15 min) until the current version of every workspace package is published, download the published `scrabble-solver` tarball with `npm pack`, install the global binary (`bun add --global` / `npm install --global`), pre-warm the dictionaries cache, then run Playwright from the extracted tarball against that binary. The Playwright specs come from the published package, **not** from `master` — if they came from master, any spec added for a feature that's merged but not yet released would run against the older published binary that lacks the feature, and fail (#428). Catches packaging regressions in the `bin/scrabble-solver.js` launcher.
 - `deploy.yml` — `workflow_dispatch` only (branch input, default `master`). SSHs into prod, pulls, builds, restarts `scrabble-solver.service`.
 
 When adding a workflow, match the existing pattern: trigger on `push`/`pull_request` to `master`, use `actions/checkout@v6` and `oven-sh/setup-bun@v2`, install with `bun install --frozen-lockfile`.
@@ -116,6 +118,7 @@ The `bunx scrabble-solver@latest` entry point (`bin/scrabble-solver.js`) just `c
 
 Look here when something seems set up oddly — the reason is usually one of these recent changes. Reference issue numbers, not dates, when grepping git log.
 
+- **#447 — Lighthouse 100** (Aug 2026, issue #412). The index page is fully server-rendered (the old `isClient` client-only gate is gone), so everything at boot must be SSR/hydration-safe and deterministic. The JS layout layer (`useAppLayoutValue`, `AppLayoutContext`) was deleted in favor of CSS variables; stylesheets are inlined into the HTML by `InlineCssHead` in `_document.tsx` (the emitted `.css` files exist but nothing requests them); a pre-paint inline script in `_document.tsx` applies persisted board dimensions/direction and holds `main` hidden until hydration when the persisted game differs from the default. Board cells are store-subscription-free (see "Board render budget"), modals mount on first open, tooltips/service-worker/dictionary/translations work is deferred past load or idle, and per-locale i18n chunks replaced the bundled all-locales map (with an idle preload and a version-keyed localStorage cache for instant/flash-free language behavior). `transliteration` was replaced with Unicode normalization, all barrel files were removed for tree-shaking, and Next's bundled polyfills are stubbed out. Perf invariants to preserve: no store subscriptions in `Cell`/`Tile`, no computed-style reads or same-value `<html>` writes in boot effects, nothing heavy before load+idle, and hydration must not change state identities on an empty-storage boot.
 - **#164 — GADDAG solver** (Aug 2026). `@kamilmielnik/trie` was dropped everywhere in favor of the external `@kamilmielnik/gaddag` package; `solve()` was rewritten as anchor-based GADDAG move generation (~40-60× faster). Disk-cached dictionaries changed from serialized-trie `.txt` to binary `.gaddag` files, and `/api/dictionary/[locale]` now serves `application/octet-stream`, gzipped when the client accepts it (compressed once per in-memory dictionary via a `WeakMap` cache — the route parses `Accept-Encoding` q-values so `gzip;q=0` gets identity and `*` counts as accepting, evicts failed compression promises from the cache, and sets `Vary: Accept-Encoding`). Responses are `Cache-Control: no-cache`, so clients revalidate with `If-None-Match` and unchanged re-downloads become 304s — the `ETag` comes from Next's built-in per-payload generation (it overrides any hand-set `ETag` on `send()`, so don't set one). The service worker deserializes with `Gaddag.deserialize` (the browser undoes `Content-Encoding` before the Cache API stores the body) and memoizes the deserialized `Gaddag` per locale, keyed on the cached response's `ETag`/`Date`/`Content-Length`, until `revalidateDictionary` replaces the entry.
 - **#421 — Bun migration** (Apr 2026). npm/Jest → Bun. Top-level scripts now use `bun run --filter`, lockfile is `bun.lock`, unit tests run on `bun test`, the published binary's launcher (`bin/scrabble-solver.js`) shells out to `bun start`, and the packaging workflow now runs in two variants (`bunx.yml` installs via `bun add --global`, `npx.yml` via `npm install --global`). All workflows use `oven-sh/setup-bun@v2`; `npx.yml` is the only one that also uses `setup-node`.
 - **#422 — TypeScript 7** (Apr 2026). Moved build/type-check to `tsgo` (native preview). Superseded in Aug 2026 by stable `typescript@7`, where the native compiler ships as plain `tsc` — scripts call `tsc` again and `@typescript/native-preview` is gone.

package/README.md

@@ -200,7 +200,7 @@ bun run --filter @scrabble-solver/word-lists build
 - [include-media](https://eduardoboucas.github.io/include-media/)
 - [Lerna](https://lerna.js.org/)
 - [Nx](https://nx.dev/)
-- [Cypress](https://www.cypress.io/)
+- [Playwright](https://playwright.dev/)
 - [Oxlint](https://oxc.rs/docs/guide/usage/linter)
 - [Oxfmt](https://oxc.rs/docs/guide/usage/formatter)
 
@@ -220,6 +220,13 @@ The user interface and source code for the web front end of Lexatious is based o
 - Web: https://lexatious.com
 - GitHub: https://github.com/ericgjackson/lexatious_web
 
+### ScrabbleBench
+
+A benchmark by Sunny Bala measuring how well large language models play Scrabble. Models are asked only for the word they want to play - Scrabble Solver then finds the optimal placement of that word on the board.
+
+- Web: https://sunnybala.github.io/scrabblebench/
+- GitHub: https://github.com/sunnybala/scrabblebench
+
 ## Media
 
 - [5 Free Scrabble Solver Websites To Quickly Find Top Scoring Words](https://www.ilovefreesoftware.com/05/featured/free-scrabble-solver-websites-to-quickly-find-top-scoring-words.html)