domma-cms 1.8.32 → 1.8.33

package/plugins/_lib/games/plays.js

@@ -12,6 +12,11 @@
  * Writes go one at a time (`withLock`), so two answers sent at once cannot
  * both be marked.
  *
+ * A TEST play (`test: true`) is an admin trying the game from its Tool. It
+ * plays exactly like any other, but it is nobody's go: it never counts for a
+ * board, a place, the goes-per-name limit, the badge or the admin's list of
+ * plays, and the next test of the same game clears it away.
+ *
  * @module _lib/games/plays
  */
 
@@ -53,7 +58,13 @@ export class PlayStore {
 
     forget() { this.cache = null; }
 
+    /** The real plays of a game - test plays left out. */
     async forGame(gameId) {
+        return (await this.all()).filter(p => p.gameId === gameId && p.test !== true);
+    }
+
+    /** Every play of a game, tests included. */
+    async everyForGame(gameId) {
         return (await this.all()).filter(p => p.gameId === gameId);
     }
 
@@ -81,17 +92,18 @@ export class PlayStore {
     }
 
     /**
-     * @param {{gameId: string, name: string, maxScore?: number, state?: object, userId?: string}} play
+     * @param {{gameId: string, name: string, maxScore?: number, state?: object, userId?: string, test?: boolean}} play
+     *   `test`: an admin trying the game - see the module comment
      * @returns {Promise<object>} the play, token included - for the player, once
      */
-    async start({gameId, name, maxScore = 0, state = {}, userId = ''}) {
+    async start({gameId, name, maxScore = 0, state = {}, userId = '', test = false}) {
         return this.withLock(async () => {
             const now = new Date().toISOString();
             const saved = await createEntry(this.slug, {
                 gameId, name, nameKey: nameKey(name), userId,
                 status: 'playing', startedAt: now, finishedAt: '', timeMs: 0, score: 0, maxScore,
-                hidden: false, token: randomBytes(24).toString('base64url'), state
-            }, {source: 'public'});
+                hidden: false, ...(test ? {test: true} : {}), token: randomBytes(24).toString('base64url'), state
+            }, {source: test ? 'admin' : 'public'});
             this.forget();
             return flat(saved);
         });
@@ -129,12 +141,21 @@ export class PlayStore {
         this.forget();
     }
 
-    /** Every play of a game gone: a fresh board. */
+    /** Every play of a game gone: a fresh board. Answers how many real plays went. */
     async reset(gameId) {
-        const mine = await this.forGame(gameId);
+        const mine = await this.everyForGame(gameId);
         await this.withLock(async () => { for (const p of mine) await deleteEntry(this.slug, p.id).catch(() => {}); });
         this.forget();
-        return mine.length;
+        return mine.filter(p => p.test !== true).length;
+    }
+
+    /** A game's test plays gone (before the next test starts). */
+    async clearTests(gameId) {
+        const tests = (await this.everyForGame(gameId)).filter(p => p.test === true);
+        if (!tests.length) return 0;
+        await this.withLock(async () => { for (const p of tests) await deleteEntry(this.slug, p.id).catch(() => {}); });
+        this.forget();
+        return tests.length;
     }
 
     async board(gameId, {period = 'all', limit = 10} = {}) {

package/plugins/crossword/CLAUDE.md

@@ -0,0 +1,37 @@
+# crossword - AI Assistant Guide
+
+## Purpose
+
+Crosswords on the public site, built from a word + clue list, timed by the server, with a fastest-solver
+leaderboard. 1.1.0 (2026-10-21), `tier: free`, disabled on arrival. Sibling of `quiz`; shares `plugins/_lib/games`.
+
+## Files
+
+- `public/lib/layout.js` - PURE, isomorphic, SERVED: `generate(words, {seed})` (greedy, deterministic from the
+  seed, clues never affect the layout), `cleanAnswer` (letters + enumeration), `solutionGrid`, `shapeOf`. The admin
+  builder imports it over HTTP for the live preview; the server runs the same function on save, so a layout is
+  never taken from the browser. It holds no puzzle, which is why it may live under `public/`.
+- `lib/crossword.js` - PURE: `cleanPuzzle`, `isOpen`, `publicPuzzle` (shape + clues, no letters), `readCells`,
+  `compare`, `catchUp`, `finish`, `view`.
+- `lib/store.js` - `crossword-puzzles` + `plays = new PlayStore('crossword-plays', {order: 'time'})`.
+- `plugin.js` - routes (header comment), shortcodes, the `fastest` notification source.
+- `public/crossword.js` - the player: the screens are domma-reactive; the grid is a `Board` class over real
+  `<input>`s (keyboard rules in its header - all focus and keystrokes, which bindings do not reach), letters
+  remembered per play in storage. Exports `mount(el, {test})`, which the admin's Test screen uses.
+- `admin/views/crossword.js` - list, editor with live grid, test and plays screens, all domma-reactive through the
+  admin kit (`_lib/admin/games/kit.js`). The preview grid is a data-each over cells.
+
+## Contracts
+
+- **No letters before solving.** `/public/crossword/:slug` gives only the size; the clues come with the play (so
+  nobody studies them off the clock); `solution` is in `/result` only when `status === 'finished'`. The tests
+  assert no answer string appears in the play payload - keep that test.
+- **Time = server elapsed + `state.penaltyMs`.** Check adds `checkPenalty` seconds (403 when `checks` is off); a
+  FULL but wrong submit adds `wrongPenalty`; a grid with empties only reports the count.
+- Cells travel as `height` strings of `width` chars, `A-Z` or space; anything else is 400.
+- The grid uses fixed ink/paper colours (`--cw-ink`, `--cw-paper`) whatever the theme - a themed grid inverted
+  under dark themes.
+- Same shortcode prefix trap as quiz: `crossword-leaderboard` is registered with `{priority: 5}`.
+- **Test plays** (1.1.0): `GET/POST /puzzles/:id/test` (manage), as in quiz's CLAUDE.md - the saved crossword
+  whatever its status, never on a board, not in the plays list, no notification, cleared by the next test.
+  `/result` answers `test: true` and `wouldPlace`.

package/plugins/crossword/admin/css/index.css

@@ -1 +1,18 @@
-.cwa-words{display:flex;flex-direction:column;gap:.4rem}.cwa-word{display:grid;grid-template-columns:1.6rem minmax(7rem,12rem) 3.5rem minmax(0,1fr) auto;gap:.4rem;align-items:center}.cwa-n{color:var(--dm-text-muted);font-size:var(--dm-text-sm);text-align:right}.cwa-answer{text-transform:uppercase;font-family:var(--dm-font-mono, monospace);letter-spacing:.04em}.cwa-enum{color:var(--dm-text-muted);font-size:var(--dm-text-xs);white-space:nowrap}@media(max-width:700px){.cwa-word{grid-template-columns:1.4rem 1fr auto}.cwa-enum{display:none}.cwa-clue{grid-column:2 / 4}}.cwa-side{position:sticky;top:.5rem}.cwa-preview{overflow:auto;max-height:70vh}.cwa-grid{display:grid;gap:0;width:max-content;border:2px solid var(--dm-text)}.cwa-cell{position:relative;width:1.7rem;height:1.7rem;display:grid;place-items:center;font-weight:700;font-size:.85rem;background:var(--dm-background, #fff);color:var(--dm-text);border:1px solid color-mix(in srgb,var(--dm-text) 35%,transparent);box-sizing:border-box}.cwa-cell.is-block{background:var(--dm-text);border-color:var(--dm-text)}.cwa-num{position:absolute;top:1px;left:2px;font-size:.5rem;font-weight:600;line-height:1;color:var(--dm-text-muted)}.cwa-unplaced{margin:0;padding:.5rem .75rem;border-radius:6px;font-size:var(--dm-text-sm);background:color-mix(in srgb,var(--dm-warning) 15%,transparent);color:color-mix(in srgb,var(--dm-warning) 55%,var(--dm-text))}
+/* Crossword admin - the word list and the live grid. Shared pieces are in /plugins/_lib/admin/games/games.css. */
+.cwa-words { display: flex; flex-direction: column; gap: .4rem; }
+.cwa-word { display: grid; grid-template-columns: 1.6rem minmax(7rem, 12rem) 3.5rem minmax(0, 1fr) auto; gap: .4rem; align-items: center; }
+.cwa-n { color: var(--dm-text-muted); font-size: var(--dm-text-sm); text-align: right; }
+.cwa-answer { text-transform: uppercase; font-family: var(--dm-font-mono, monospace); letter-spacing: .04em; }
+.cwa-enum { color: var(--dm-text-muted); font-size: var(--dm-text-xs); white-space: nowrap; }
+@media (max-width: 700px) { .cwa-word { grid-template-columns: 1.4rem 1fr auto; } .cwa-enum { display: none; } .cwa-clue { grid-column: 2 / 4; } }
+
+.cwa-side { position: sticky; top: .5rem; }
+.cwa-preview { overflow: auto; max-height: 70vh; }
+/* Fixed ink and paper, as on the public grid: a themed grid came out inverted under dark themes. */
+.cwa-grid { --cwa-ink: #111827; --cwa-paper: #ffffff; display: grid; gap: 0; width: max-content; border: 2px solid var(--cwa-ink); background: var(--cwa-ink); }
+.cwa-cell { position: relative; width: 1.7rem; height: 1.7rem; display: grid; place-items: center; font-weight: 700; font-size: .85rem;
+    background: var(--cwa-paper); color: var(--cwa-ink); border: 1px solid color-mix(in srgb, var(--cwa-ink) 35%, transparent); box-sizing: border-box; }
+.cwa-cell.is-block { background: var(--cwa-ink); border-color: var(--cwa-ink); }
+.cwa-num { position: absolute; top: 1px; left: 2px; font-size: .5rem; font-weight: 600; line-height: 1; color: #4b5563; }
+.cwa-unplaced { margin: 0; padding: .5rem .75rem; border-radius: 6px; font-size: var(--dm-text-sm);
+    background: color-mix(in srgb, var(--dm-warning) 15%, transparent); color: color-mix(in srgb, var(--dm-warning) 55%, var(--dm-text)); }