chesspal 0.3.0 → 0.3.2

package/dist/page/table/window.js

@@ -0,0 +1,130 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { useEffect, useState } from "preact/hooks";
+import { Dialog } from "../dialogs/dialog.js";
+import { checkIcon } from "../dialogs/profiles.js";
+/** The chat's window: closed once a chat opens or starts again, the page then saying where it stands. */
+export function ChatDialog({ open, table, settings, onChange, name, onClose, text }) {
+    const [sending, setSending] = useState(false);
+    const [failed, setFailed] = useState(false);
+    useEffect(() => setFailed(false), [open]);
+    const words = text.table;
+    const installed = table.hosts.filter((host) => host.installed && host.name in choiceKeys);
+    // A chat opened by hand is the player's: Chesspal cannot start it again. Its rows stay readable, as the ones waiting.
+    const byHand = table.chat && !table.held;
+    const busy = sending || table.opening !== undefined || table.waiting === true;
+    const choose = async (host) => {
+        setSending(true);
+        setFailed(false);
+        const done = table.chat ? await restartChat(host) : await openChat(host);
+        setSending(false);
+        if (done) {
+            onClose();
+        }
+        else {
+            setFailed(true);
+        }
+    };
+    // While a chat opens or waits to start again, the rows wait too, and the note says why.
+    const note = installed.length === 0
+        ? words.install(name)
+        : busy
+            ? chatState(table, name, text) ?? words.choose
+            : byHand
+                ? words.byHand(name)
+                : table.chat
+                    ? words.restartHint
+                    : words.choose;
+    const offersChoices = installed.some((host) => host.models.length > 0 || host.efforts.length > 0);
+    // The chat at the table started with other choices than the ones kept now: its row starts it again with these, else it only closes the window.
+    const started = table.held ? table.started : undefined;
+    const changed = (host) => started !== undefined && (chosen(host, "model", settings) !== (started.model ?? "") || chosen(host, "effort", settings) !== (started.effort ?? ""));
+    return (_jsxs(Dialog, { open: open, title: words.title, onClose: onClose, text: text, children: [_jsx("p", { class: "note", children: note }), _jsxs("div", { class: "chat-hosts", role: "group", "aria-label": words.title, children: [offersChoices
+                        ? (_jsxs("div", { class: "chat-head", "aria-hidden": "true", children: [_jsx("span", {}), _jsx("span", { children: words.model }), _jsx("span", { children: words.effort })] }))
+                        : null, installed.map((host) => {
+                        const atTable = table.chat && table.host === host.name;
+                        const off = busy || byHand;
+                        const again = !atTable || changed(host);
+                        return (_jsxs("div", { class: "chat-host", children: [_jsxs("button", { class: "choice", type: "button", title: atTable && again ? words.restartChanged : undefined, "aria-current": atTable ? "true" : undefined, "aria-disabled": off, onClick: off ? undefined : again ? () => void choose(host.name) : onClose, children: [_jsx("span", { children: hostTitles[host.name] ?? host.name }), atTable ? (again ? restartIcon : checkIcon) : null] }), _jsx(Choice, { host: host, kind: "model", settings: settings, onChange: onChange, text: text }), _jsx(Choice, { host: host, kind: "effort", settings: settings, onChange: onChange, text: text })] }, host.name));
+                    })] }), _jsx("p", { class: "chat-state", role: "status", children: failed ? (table.chat ? words.notRestarted : words.failed) : null }), table.chat || installed.length === 0 ? null : (_jsxs("p", { class: "chat-command", children: [words.typeIt, " ", installed.map((host, index) => (_jsxs("span", { children: [index === 0 ? "" : " · ", _jsx("code", { children: host.command })] }, host.name)))] }))] }));
+}
+/** The AI's name on its card, which opens the chat's window: with no chat at the table, a hollow ring before it says so. */
+export function AiNameButton({ name, table, onOpen, text }) {
+    const title = table.chat ? text.table.change : text.table.noChat;
+    return (_jsxs("button", { class: "profile-name ai-name", type: "button", title: title, "aria-label": `${name}: ${title}`, "aria-haspopup": "dialog", onClick: onOpen, children: [table.chat ? null : _jsx("span", { class: "no-chat", "aria-hidden": "true" }), _jsx("span", { children: name }), _jsx("svg", { class: "icon", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { d: "M7 10L12 15L17 10" }) })] }));
+}
+/**
+ * The note on the chat at the table where the asleep note stands: one opening or starting again; one waiting to, with a ↻ that starts it at once and a ×
+ * that lets the request go; in a game with no chat at the table, a line that opens the chat's window. None otherwise.
+ */
+export function tableNote({ table, name, inGame, onOpen, text }) {
+    const words = text.table;
+    const state = chatState(table, name, text);
+    if (table.waiting === true) {
+        return (_jsxs("p", { class: "asleep table-note", role: "status", children: [_jsx("span", { children: state }), _jsx("button", { class: "icon-button", type: "button", title: words.restartNow, "aria-label": words.restartNow, onClick: () => void endWaiting(true), children: restartIcon }), _jsx("button", { class: "icon-button", type: "button", title: words.cancel, "aria-label": words.cancel, onClick: () => void endWaiting(false), children: _jsx("svg", { class: "icon", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { d: "M6 6L18 18M18 6L6 18" }) }) })] }));
+    }
+    if (state !== undefined) {
+        return _jsx("p", { class: "asleep", role: "status", children: state });
+    }
+    if (!table.chat && inGame) {
+        return (_jsx("p", { class: "asleep table-note", role: "status", children: _jsxs("button", { class: "no-chat-line", type: "button", "aria-haspopup": "dialog", onClick: onOpen, children: [_jsx("span", { class: "no-chat", "aria-hidden": "true" }), words.noChat] }) }));
+    }
+    return null;
+}
+/** What the page says of the chat at the table: one opening, starting again, or waiting to; nothing else. */
+export function chatState(table, name, text) {
+    const words = text.table;
+    if (table.waiting === true) {
+        return words.waiting(name);
+    }
+    return table.opening === "chat" ? words.opening : table.opening === "again" ? words.again(name) : table.opening === "restart" ? words.restart : undefined;
+}
+const hostTitles = { claude: "Claude Code", codex: "Codex" };
+// The settings that keep each host's choice.
+const choiceKeys = {
+    claude: { model: "claudeModel", effort: "claudeEffort" },
+    codex: { model: "codexModel", effort: "codexEffort" },
+};
+/** The ↻ of a chat that starts again. */
+const restartIcon = (_jsx("svg", { class: "icon in-use", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { d: "M19.5 12a7.5 7.5 0 1 1-2.2-5.3M19.5 4.5v4h-4" }) }));
+/** A host's model or effort as the settings keep it: "" for the host's own, and for a choice it no longer offers. */
+function chosen(host, kind, settings) {
+    const key = choiceKeys[host.name][kind];
+    const offered = kind === "model" ? host.models : host.efforts;
+    return offered.includes(settings[key]) ? settings[key] : "";
+}
+/** A host's model or effort: a dash keeps the host's own; a choice it no longer offers shows as the dash. Its title says what it stands at, the dash too. */
+function Choice({ host, kind, settings, onChange, text }) {
+    const key = choiceKeys[host.name][kind];
+    const offered = kind === "model" ? host.models : host.efforts;
+    const value = chosen(host, kind, settings);
+    const title = hostTitles[host.name] ?? host.name;
+    if (offered.length === 0) {
+        return _jsx("span", {});
+    }
+    return (_jsxs("select", { "aria-label": `${text.table[kind]}, ${title}`, title: `${text.table[kind]}: ${value === "" ? text.table.asHost(title) : value}`, value: value, onChange: (event) => onChange({ ...settings, [key]: event.currentTarget.value }), children: [_jsx("option", { value: "", children: "\u2014" }), offered.map((one) => _jsx("option", { value: one, children: shortName(one) }, one))] }));
+}
+// Codex's models without the "gpt-" they all start with, so the choice stays narrow; the title keeps the whole name.
+function shortName(value) {
+    return value.replace(/^gpt-/, "");
+}
+/** Asks the table to open a terminal with a chat in the host: whether it did. */
+function openChat(host) {
+    return asked("/api/table/chat", { host }, (answer) => answer.opened === true);
+}
+/** Asks the table to start at once the chat that waits to start again, cutting its answer, or to let the request go. */
+function endWaiting(now) {
+    return asked("/api/table/waiting", { now }, () => true);
+}
+/** Asks the table to start its chat again with the host, at once or once it has ended its answer: whether it took the request. */
+function restartChat(host) {
+    return asked("/api/table/restart", { host }, (answer) => answer.restarting === true || answer.waiting === true);
+}
+async function asked(path, body, done) {
+    try {
+        const response = await fetch(path, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body) });
+        return response.ok && done((await response.json()));
+    }
+    catch {
+        return false;
+    }
+}

package/dist/page/talk/chat.css

@@ -5,15 +5,13 @@
     max-height: none;
 }
 
-/* A line apart from the AI's note, which another voice signed (Zoe) */
+/* Under the AI's note, with no line between them (Stefano) */
 .talk.studied > section > .chat {
     display: flex;
     flex-direction: column;
     flex: 1 1 auto;
     min-height: 0;
     margin-top: 12px;
-    padding-top: 10px;
-    border-top: 1px solid var(--line);
 }
 
 .chat > .compose {
@@ -49,16 +47,29 @@
 
     .flipped .talk.studied > section > .chat {
         margin: 0 0 12px;
-        padding: 0 0 10px;
-        border-top: 0;
-        border-bottom: 1px solid var(--line);
+    }
+
+    /* Turned round, the note's room goes under its bubbles, which would touch the AI's card or the note that no chat listens (Zoe) */
+    .flipped .talk.studied .ai-note {
+        margin: 0 0 12px;
     }
 }
 
-/* The AI's answers on the left, in its bubbles, without the tail that points at the Torretta: it is not by them */
+/* The AI's answers on the left, in its bubbles, each with a small Torretta at its foot instead of the tail that points at the big one: it is not by them (Stefano) */
 .sent li.from-ai {
     align-self: flex-start;
-    align-items: flex-start;
+    flex-direction: row;
+    align-items: flex-end;
+    gap: 6px;
+}
+
+.sent li.from-ai > .torretta {
+    flex: none;
+}
+
+/* The bubble's foot level with the Torretta's, spaced as the player's lines are */
+.sent li.from-ai > .say {
+    margin: 0;
 }
 
 .talk.studied .sent .say::before,

package/dist/page/talk/talk.css

@@ -233,65 +233,6 @@
     background: var(--say);
 }
 
-.me {
-    position: relative;
-    flex: none;
-    padding: 0;
-    border: 0;
-    border-radius: 50%;
-    background: none;
-    line-height: 0;
-    cursor: pointer;
-}
-
-.me-cover {
-    position: absolute;
-    inset: 0;
-    display: grid;
-    place-items: center;
-    border-radius: 50%;
-    background: rgba(0, 0, 0, 0.45);
-    color: #fff;
-    opacity: 0;
-    transition: opacity 0.12s;
-}
-
-.me-cover .icon {
-    width: 45%;
-    height: 45%;
-}
-
-.me:hover .me-cover,
-.me:focus-visible .me-cover {
-    opacity: 1;
-}
-
-/* Where nothing hovers, a camera in the corner says the picture changes */
-.me-badge {
-    position: absolute;
-    right: -2px;
-    bottom: -2px;
-    display: none;
-    place-items: center;
-    width: 18px;
-    height: 18px;
-    border-radius: 50%;
-    background: var(--accent);
-    color: var(--on-accent);
-    box-shadow: 0 0 0 2px var(--card);
-}
-
-.me-badge .icon {
-    width: 12px;
-    height: 12px;
-}
-
-@media (hover: none) {
-    .me-badge {
-        display: grid;
-    }
-}
-
 .profile-name {
     display: inline-flex;
     align-items: center;
@@ -369,6 +310,15 @@
     }
 }
 
+/* Its bust on a player's card: a disc of the player's picture's colour, which cuts what falls out of it */
+.torretta.bust {
+    clip-path: circle(50%);
+}
+
+.torretta .back {
+    fill: var(--say);
+}
+
 .torretta .shade {
     fill: var(--torretta-shade);
 }
@@ -701,23 +651,23 @@
     overflow-wrap: anywhere;
 }
 
-/* Only the note's last bubble has a tail, pointing down at the Torretta beside the AI's name, the board turned round or not */
+/* Only the note's first bubble has a tail, pointing up at the Torretta beside the AI's name, the board turned round or not (Stefano) */
 .ai-note > .say::before,
 .ai-note > .say::after {
     content: none;
 }
 
-.ai-note > .say:has(+ .who)::after {
+.ai-note > .who + .say::before {
     content: "";
     position: absolute;
     left: 8px;
-    bottom: -9px;
+    top: -9px;
     border: 10px solid transparent;
-    border-bottom: 0;
-    border-top-color: var(--say);
+    border-top: 0;
+    border-bottom-color: var(--say);
 }
 
-.ai-note > .say + .who {
+.ai-note > .who + .say {
     margin-top: 4px;
 }
 
@@ -866,8 +816,8 @@
     margin: 0 0 var(--between);
 }
 
-.ai-block:has(> .asleep) .say::before,
-.ai-block:has(> .asleep) .say::after {
+.ai-block:has(> .asleep) .says .say::before,
+.ai-block:has(> .asleep) .says .say::after {
     content: none;
 }
 

package/dist/page/talk/talk.js

@@ -16,7 +16,7 @@ export function AiWords({ words, newestFirst, voice }) {
     return (_jsx("ol", { ref: list, class: "says", "aria-live": "polite", children: inOrder(words.map((word, index) => (_jsx("li", { class: "say", style: aged(words.length - 1 - index), children: _jsx(Marked, { text: word }) }, index))), newestFirst) }));
 }
 /**
- * The AI's word on the move shown of a game in analysis (D-69), in a bubble that points down at the Torretta beside the AI's name: the move, its badge by name,
+ * The AI's word on the move shown of a game in analysis (D-69), in a bubble under the Torretta beside the AI's name, pointing up at it: the move, its badge by name,
  * and its note when it wrote one; read out as the player steps through the game. The Torretta and the name stay when the move has no word.
  */
 export function AiNote({ ply, opening, closing, summary, reviewing, name, by, mood, voice, text }) {
@@ -32,10 +32,10 @@ export function AiNote({ ply, opening, closing, summary, reviewing, name, by, mo
         }
         return hush;
     }, [spoken, voice]);
-    // The Torretta stays in sight through the whole analysis, under its bubbles, which show only where it wrote something.
-    return (_jsxs("div", { class: "ai-note", "aria-live": "polite", children: [ply === undefined || shown === undefined ? null : (_jsxs("p", { class: `say move-note ${shown.badge ?? ""}`, children: [_jsxs("span", { class: "head", children: [shown.badge === undefined ? _jsx(NoteIcon, {}) : _jsx(BadgeIcon, { badge: shown.badge }), _jsxs("b", { children: [_jsxs("span", { class: "visually-hidden", children: [ply.number, ply.side === "white" ? "." : "...", ply.san] }), _jsxs("span", { "aria-hidden": "true", children: [_jsxs("span", { class: "move-number", children: [ply.number, ply.side === "white" ? "." : "..."] }), _jsx(Figurines, { san: ply.san, side: ply.side })] })] }), " ", title] }), note === undefined ? null : (_jsx("span", { class: "note", children: _jsx(Marked, { text: note }) })), shown.arrows === undefined && shown.squares === undefined ? null : _jsx(Legend, { review: shown, words: text.drawn })] })), summary === undefined ? null : _jsx(GameReview, { by: name, summary: summary, text: text }), closing === undefined ? null : (_jsx("p", { class: "say closing", children: _jsx(Marked, { text: closing }) })), reviewing === true
+    // The Torretta stays in sight through the whole analysis, over its bubbles, which show only where it wrote something.
+    return (_jsxs("div", { class: "ai-note", "aria-live": "polite", children: [_jsxs("p", { class: "who", children: [_jsx(Torretta, { size: 36, mood: mood }), _jsxs("span", { class: "signed", children: [name, by === undefined ? null : _jsx("small", { children: signature(by.annotator, by.effort) })] })] }), ply === undefined || shown === undefined ? null : (_jsxs("p", { class: `say move-note ${shown.badge ?? ""}`, children: [_jsxs("span", { class: "head", children: [shown.badge === undefined ? _jsx(NoteIcon, {}) : _jsx(BadgeIcon, { badge: shown.badge }), _jsxs("b", { children: [_jsxs("span", { class: "visually-hidden", children: [ply.number, ply.side === "white" ? "." : "...", ply.san] }), _jsxs("span", { "aria-hidden": "true", children: [_jsxs("span", { class: "move-number", children: [ply.number, ply.side === "white" ? "." : "..."] }), _jsx(Figurines, { san: ply.san, side: ply.side })] })] }), " ", title] }), note === undefined ? null : (_jsx("span", { class: "note", children: _jsx(Marked, { text: note }) })), shown.arrows === undefined && shown.squares === undefined ? null : _jsx(Legend, { review: shown, words: text.drawn })] })), summary === undefined ? null : _jsx(GameReview, { by: name, summary: summary, text: text }), closing === undefined ? null : (_jsx("p", { class: "say closing", children: _jsx(Marked, { text: closing }) })), reviewing === true
                 ? (_jsxs("p", { class: "say reviewing", children: [_jsx("span", { class: "spinner", "aria-hidden": "true" }), text.reviewing(name)] }))
-                : null, _jsxs("p", { class: "who", children: [_jsx(Torretta, { size: 36, mood: mood }), _jsxs("span", { class: "signed", children: [name, by === undefined ? null : _jsx("small", { children: signature(by.annotator, by.effort) })] })] })] }));
+                : null] }));
 }
 /** The squares and moves in the AI's words, such as e3, Cxe4, 7.Nd4 or O-O: in bold, as the player looks for them on the board. */
 export function Marked({ text }) {
@@ -60,7 +60,7 @@ export function Legend({ review, words }) {
 /**
  * The player's words of the game, the newest by the box they write in with how far it got, and the box: Enter or the button sends the words alone, the next
  * move takes them with it. 200 characters from one move of the AI's to the next: once they are written, the box goes until its move (D-54). In analysis the
- * AI's answers are in the same thread, and each line of the player's names the move it was written on (D-101).
+ * AI's answers are in the same thread, each by a small Torretta, and each line of the player's names the move it was written on (D-101).
  */
 export function Compose({ lines, newestFirst, spent, draft, onDraft, onSend, canMove, name, problem, about, text }) {
     const list = useRef(null);
@@ -76,7 +76,7 @@ export function Compose({ lines, newestFirst, spent, draft, onDraft, onSend, can
         }
     };
     return (_jsxs(_Fragment, { children: [_jsx("ol", { ref: list, class: "sent", "aria-live": "polite", children: inOrder(lines.map((line, index) => (_jsxs("li", { class: line.who === "ai" ? "from-ai" : undefined, style: about === undefined ? aged(lines.length - 1 - index) : reread(index, lastAnswer), children: [line.who === "ai"
-                            ? (_jsx("p", { class: "say", children: _jsx(Marked, { text: line.text }) }))
+                            ? (_jsxs(_Fragment, { children: [_jsx(Torretta, { size: 24 }), _jsx("p", { class: "say", children: _jsx(Marked, { text: line.text }) })] }))
                             : (_jsxs("p", { class: "said", children: [about === undefined || line.shown?.move === undefined ? null : _jsx(ShownMove, { move: line.shown.move, onShow: () => about.onShow(line.shown.at), text: text }), line.text] })), index === lastWritten ? _jsx(Status, { heard: line.heard, name: name, text: text }) : null] }, index))), newestFirst) }), left <= 0 ? null : (_jsxs("form", { class: about === undefined ? "compose" : "compose asking", onSubmit: (event) => {
                     event.preventDefault();
                     submit();
@@ -94,7 +94,7 @@ export function Compose({ lines, newestFirst, spent, draft, onDraft, onSend, can
  * whoever moves and a dot on the Torretta when the AI spoke meanwhile.
  */
 export function TalkFaces({ name, aiPicture, you, picture, ai, player, aiMoves, playerMoves, unread, text }) {
-    return (_jsxs("div", { class: "faces", children: [_jsx(RailPlayer, { place: "ai", picture: aiPicture ?? _jsx(Torretta, { size: 40 }), name: name, ...(ai === undefined ? {} : { side: text.sides[ai] }), moves: aiMoves, unread: unread }), _jsx(RailPlayer, { place: "you", picture: picture, name: you, ...(player === undefined ? {} : { side: text.sides[player] }), moves: playerMoves })] }));
+    return (_jsxs("div", { class: "faces", children: [_jsx(RailPlayer, { place: "ai", picture: aiPicture ?? _jsx(Torretta, { size: 40, bust: true }), name: name, ...(ai === undefined ? {} : { side: text.sides[ai] }), moves: aiMoves, unread: unread }), _jsx(RailPlayer, { place: "you", picture: picture, name: you, ...(player === undefined ? {} : { side: text.sides[player] }), moves: playerMoves })] }));
 }
 /** The move a line of the player's was written on, 14.♘f3, small at the line's head: a press shows it on the board again (Zoe). */
 function ShownMove({ move, onShow, text }) {

package/dist/page/talk/voice.js

@@ -1,10 +1,9 @@
-// The AI's words read aloud (Stefano's idea, IDEE.md): the browser's own voices, a local one first, so the words stay on the computer where it can.
-/** Reads the words aloud in the language given, cutting short what was being read. */
-export function speak(words, language) {
+/** Reads the words aloud in the voice's language, the moves in words, cutting short what was being read. */
+export function speak(words, voice) {
     if (typeof speechSynthesis === "undefined") {
         return;
     }
-    const said = words.replace(/\*\*/g, "").trim();
+    const said = spokenMoves(words.replace(/\*\*/g, ""), voice.saidMove).trim();
     speechSynthesis.cancel();
     clearTimeout(pending);
     if (said === "") {
@@ -13,10 +12,10 @@ export function speak(words, language) {
     // Chrome drops words spoken right after a cancel, and lists its voices late the first time: the words wait a moment.
     pending = setTimeout(() => {
         const utterance = new SpeechSynthesisUtterance(said);
-        const voice = voiceFor(language);
-        utterance.lang = voice?.lang ?? language;
-        if (voice !== undefined) {
-            utterance.voice = voice;
+        const reader = readerFor(voice.language);
+        utterance.lang = reader?.lang ?? voice.language;
+        if (reader !== undefined) {
+            utterance.voice = reader;
         }
         speechSynthesis.resume();
         speechSynthesis.speak(utterance);
@@ -29,9 +28,48 @@ export function hush() {
         speechSynthesis.cancel();
     }
 }
+/** Whether the browser has a voice for the language: without one the words cannot be read. */
+export function hasVoice(language) {
+    return typeof speechSynthesis !== "undefined" && readerFor(language) !== undefined;
+}
+/** Calls the listener whenever the browser's voices change, since Chrome lists them late: what it returns stops it. */
+export function onVoices(listener) {
+    if (typeof speechSynthesis === "undefined") {
+        return () => undefined;
+    }
+    speechSynthesis.addEventListener("voiceschanged", listener);
+    return () => speechSynthesis.removeEventListener("voiceschanged", listener);
+}
+/**
+ * The words with each move the AI wrote said in words, since a voice reads ♟g4 as "chess pawn g4": ♞xf6+, Nxf6+, exd5, O-O, e8=♛. A square alone, e4,
+ * stays as it is; a pawn's move becomes words only with its figurine, a capture, a promotion or a check, and without the file it takes from.
+ */
+export function spokenMoves(words, say) {
+    return words.replace(movePattern, (move, ...found) => {
+        const { castles, figurine, letter, from, takes, square, promotion, check } = found.at(-1);
+        const checked = check === undefined ? {} : { check: check === "+" ? "check" : "mate" };
+        if (castles !== undefined) {
+            return say({ castles: castles.length > 3 ? "long" : "short", ...checked });
+        }
+        if (square === undefined || (figurine === undefined && letter === undefined && takes === undefined && promotion === undefined && check === undefined)) {
+            return move;
+        }
+        const piece = figurine === undefined ? (letter ?? "P") : pieceOf(figurine);
+        const promoted = promotion === undefined ? {} : { promotion: pieceOf(promotion) };
+        // A pawn's file, exd5, goes unsaid: "pawn takes d5".
+        const said = from === undefined || from === "" || piece === "P" ? {} : { from };
+        return say({ piece, ...said, takes: takes !== undefined, square, ...promoted, ...checked });
+    });
+}
 let pending;
+// A move in SAN, with the pieces' letters or figurines, as the AI writes it; the parts named, castling apart.
+const movePattern = /(?<![\w♔-♟])(?:(?<castles>O-O(?:-O)?|0-0(?:-0)?)|(?:(?<figurine>[♔-♟])[\uFE0E\uFE0F]?|(?<letter>[KQRBN]))?(?<from>[a-h]?[1-8]?)(?<takes>[x×])?(?<square>[a-h][1-8])(?:=?(?<promotion>[QRBN]|[♔-♟]))?[\uFE0E\uFE0F]?)(?<check>\+\+|[+#])?(?![\w♔-♟])/gu;
+// A piece's letter, or its figurine: White's run ♔♕♖♗♘♙ and Black's ♚♛♜♝♞♟, in SAN's order.
+function pieceOf(sign) {
+    return ("KQRBN".includes(sign) ? sign : "KQRBNP".charAt(((sign.codePointAt(0) ?? 0) - 0x2654) % 6));
+}
 /** A voice for the language: a local one first, the browser's default among them first. */
-function voiceFor(language) {
+function readerFor(language) {
     const voices = speechSynthesis.getVoices().filter((voice) => voice.lang.toLowerCase().startsWith(language.toLowerCase()));
     const local = voices.filter((voice) => voice.localService);
     return local.find((voice) => voice.default) ?? local[0] ?? voices[0];