@the-inclusionist/engine 7.0.1 → 8.0.0-rc.2

package/README.md

@@ -70,9 +70,11 @@ npm test           # testes Vitest (node + browser via Playwright); npm run test
   `allow_failure: true` e estavam vermelhos havia semanas. O histórico o guarda; o cabeçalho do `ci.yml`
   documenta o porte linha a linha.
 
-- **CD** — Cloudflare Pages (plano gratuito). ⚠️ **A conexão git dele apontava para o GitLab, que agora está
-  arquivado** — o deploy tem de ser reapontado para este repositório antes do próximo push valer publicação.
-  Não dá para conferir isto de fora do painel da Cloudflare. A cada push na `main`:
+- **CD** — ⚠️ **NÃO HÁ NENHUM**, hoje. Informado pelo Dev em 2026-09-07: **nenhum projeto do Cloudflare Pages
+  está conectado a repositório nenhum**. A ressalva anterior — «a conexão apontava para o GitLab, que agora
+  está arquivado» — descrevia um deploy desapontado; o estado atual é mais simples e mais grave de confundir:
+  **push não é publicação**, e `dist/` só chega a alguém por um passo manual.
+  A tabela abaixo fica como a RECEITA de quando houver conexão, e não como descrição do que existe:
 
   | Configuração | Valor |
   |---|---|

package/app/css/style.css

@@ -51,6 +51,7 @@
   --z-menu:30000;
   --z-menu-max:39999;
   --z-transition:40000;
+  --z-skip-link:41000;
   --z-loop-crash:45000;
   --z-debug:90000;
 }
@@ -178,7 +179,9 @@ html,body{margin:0;background:var(--bg);color:var(--ink);font-family:var(--font)
    (tolerância de 5px lógicos/lado) é cortado pelo .stage-wrap, e os menus rolam DENTRO dos cards. */
 body{display:flex;flex-direction:column;height:100vh;height:100dvh;overflow:hidden}
 .sr-only{position:absolute!important;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap;border:0}
-.skip-link{position:absolute;left:8px;top:-60px;background:var(--accent);color:var(--accent-ink);padding:.6em 1em;border-radius:0 0 10px 10px;font-weight:700;z-index:100;transition:top .15s}
+/* O `z-index` ADOTOU O SLOT em 2026-09-07. Era `100`, um literal que estava CERTO e cuja tabela estava
+   errada: o `Z` punha o skip-link em CAPTIONS(26000), abaixo dos modais. Ver `SKIP_LINK` em core/layers. */
+.skip-link{position:absolute;left:8px;top:-60px;background:var(--accent);color:var(--accent-ink);padding:.6em 1em;border-radius:0 0 10px 10px;font-weight:700;z-index:var(--z-skip-link);transition:top .15s}
 .skip-link:focus{top:0}
 :focus-visible{outline:4px solid var(--focus);outline-offset:2px;border-radius:6px}
 
@@ -300,10 +303,24 @@ body:not(.dbg) .topbar{display:none} /* título da PÁGINA só em ?debug=true (o
    navegador, e sem esta linha as duas listas do cartão de pausa apareceriam empilhadas (ADR-0044, item 5). */
 .pause-menu[hidden]{display:none}
 /* 44 px NÃO é o mínimo da WCAG — o 2.5.8 pede 24×24, e o cartão já passava nisso com folga. 44 é a
-   recomendação da Apple (HIG), e este projeto trata piso como piso. `min-height` e não `padding` porque a
-   altura de antes (35,6 px) não estava declarada em lugar nenhum: ela RESULTAVA da soma de padding, fonte e
-   entrelinha. Um alvo que ninguém escreveu é um alvo que ninguém defende. */
-.pm-btn{background:#1a2740;color:#eaf2f8;border:1px solid #3a4a6a;border-radius:10px;padding:.5rem .8rem;min-height:44px;display:flex;align-items:center;justify-content:center;font:inherit;font-weight:700;cursor:pointer;white-space:nowrap}
+   recomendação da Apple (HIG). `min-height` e não `padding` porque a altura de antes (35,6 px) não estava
+   declarada em lugar nenhum: ela RESULTAVA da soma de padding, fonte e entrelinha. Um alvo que ninguém
+   escreveu é um alvo que ninguém defende.
+
+   ⚠️ ESTA LINHA DIZIA TAMBÉM «e este projeto trata piso como piso», e essa metade morreu no ADR-0095: o
+   piso deixou de ser um número único e passou a ser a régua abaixo. Fica o resto, que continua a valer. */
+/* ⚠️ O ALVO DO ITEM DE MENU SEGUE A RÉGUA DO ADR-0095, e não um literal.
+   Era `min-height:44px` cravado. O registro fixou que o alvo é função da ALTURA DA TELA — 24 px (WCAG
+   2.5.8, AA) abaixo de 540, 34 a partir de 540, 44 (2.5.5, AAA) a partir de 720 — porque um alvo grande
+   que exige ROLAGEM para ser alcançado pode custar mais dedo do que um menor que está à vista.
+
+   ⚠️ E ELE USA `--alvo-min` E NÃO `--tap`, que são coisas diferentes: `--tap` é o tamanho PREFERIDO e
+   cresce com a escala do canvas (22 × k, nunca menos de 44); `--alvo-min` é o CHÃO por altura. Um botão
+   isolado pode ser o preferido; um item de LISTA, que tem de caber inteiro, usa o chão.
+
+   O `44px` do fallback é o comportamento de antes, para o caso de `layout()` não ter corrido — que era
+   exatamente o que acontecia no `quiz.html` até 07/09. */
+.pm-btn{background:#1a2740;color:#eaf2f8;border:1px solid #3a4a6a;border-radius:10px;padding:.5rem .8rem;min-height:var(--alvo-min,44px);display:flex;align-items:center;justify-content:center;font:inherit;font-weight:700;cursor:pointer;white-space:nowrap}
 .pm-btn:hover,.pm-btn:focus,.pm-btn.pm-sel{background:#2a3a5e;border-color:#ffd23f;outline:2px solid #ffd23f;outline-offset:1px}
 /* Legenda sim/não: ícone do botão (conforme layout do controle) + a palavra. Sony/Nintendo invertem 0↔1. */
 .pause-legend{display:flex;gap:1.1rem;justify-content:center;margin:.7rem 0 .1rem;font-size:.82em;color:#c3cfe0}

package/app/public/vendor/fonts.css

@@ -80,9 +80,71 @@
 @font-face{font-family:'Newsreader';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/newsreader-400.woff2') format('woff2');}
 @font-face{font-family:'Newsreader';font-style:normal;font-weight:700;font-display:swap;src:url('fonts/newsreader-700.woff2') format('woff2');}
 /* Manuscritas (caligráficas inglesas · blackletter alemãs · alfabetização) */
-@font-face{font-family:'Great Vibes';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/greatvibes-400.woff2') format('woff2');}
 @font-face{font-family:'Pinyon Script';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/pinyon-400.woff2') format('woff2');}
-@font-face{font-family:'UnifrakturCook';font-style:normal;font-weight:700;font-display:swap;src:url('fonts/ufcook-700.woff2') format('woff2');}
 @font-face{font-family:'UnifrakturMaguntia';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/ufmag-400.woff2') format('woff2');}
 @font-face{font-family:'Comic Neue';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/comicneue-400.woff2') format('woff2');}
 @font-face{font-family:'Comic Neue';font-style:normal;font-weight:700;font-display:swap;src:url('fonts/comicneue-700.woff2') format('woff2');}
+
+/* ===== ARCADE (papel `jogo`: HUD, título, rótulos — NUNCA a face da interface) =====
+   ⚠️ SEM `unicode-range`, E É DELIBERADO. O Google Fonts serve esta família em CINCO ficheiros ordenados
+   por `unicode-range` **com o latino por ÚLTIMO**, e uma vendorização que pegue no primeiro `src:` traz o
+   subconjunto cirílico — um woff2 válido, corretamente declarado, corretamente carregado, e sem uma única
+   letra latina.
+
+   Isso aconteceu de verdade, no `SP-the-inclusionist-whackwhack`: o título saiu na fonte errada durante
+   QUATRO commits e todas as verificações disponíveis diziam que estava certo —
+   `document.fonts.check()` devolvia `true`, o `status` era `loaded`, o `getComputedStyle` mostrava a
+   família certa. As três comparam o NOME da família, uma string escrita duas vezes pela mesma mão; nenhuma
+   olha para dentro do ficheiro. E o CSS resolve por CODEPOINT, então uma face sem glifo para `U+0057` é
+   ignorada para aquele caractere em silêncio.
+
+   O ficheiro aqui é o subconjunto LATINO, copiado daquele repositório já verificado, e o gate que o mede
+   é `tests/fonte-arcade.browser.test.js` — pela LARGURA DE AVANÇO, que vem do glifo e portanto do ficheiro. */
+@font-face{font-family:'Press Start 2P';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/pressstart-400.woff2') format('woff2');}
+
+
+/* ===== OpenDyslexic (ACESSIBILIDADE — oferecida, e SEM alegação de eficácia) =====
+   SIL OFL 1.1, confirmada na API do repositório oficial (antijingoist/opendyslexic) e não de memória — a
+   licença desta face JÁ MUDOU uma vez, e afirmar de cabeça seria afirmar o estado antigo.
+
+   ⚠️ ELA NÃO PROMETE LEITURA MELHOR, e isso é decisão registada. O `docs/game-design/typography.md` diz por
+   extenso: «Ofereça a Dyslexie e a OpenDyslexic apenas como escolha do usuário. A pesquisa não mostra ganho
+   de leitura com elas.» A descrição no menu fala do desenho — hastes pesadas na base —, nunca do efeito.
+
+   ⚠️ E ELA NÃO É SUBCONJUNTO: 100,9 KB do ficheiro compilado do próprio projeto, contra 23 KB da Fondamento
+   latina. É a face mais pesada do roster, e entra assim porque o upstream não publica subconjuntos; quem
+   quiser cortá-la depois faz por `pyftsubset`, e o gate de precache é quem reclama se o orçamento apertar. */
+@font-face{font-family:'OpenDyslexic';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/opendyslexic-400.woff2') format('woff2');}
+
+/* ===== Fondamento (CALIGRÁFICA — fora do menu, para dentro das atividades) =====
+   SIL OFL 1.1, do Google Fonts, nos dois subconjuntos que ele serve. Mínimo de 20 px fixado pelo Dev na
+   emenda do ADR-0012: abaixo disso a face deixa de ser DIFÍCIL e passa a ser ilegível, e as duas coisas são
+   diferentes — a dificuldade é o exercício, a ilegibilidade é a criança a desistir. */
+@font-face{font-family:'Fondamento';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/fondamento-400.woff2') format('woff2');
+  unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+0304,U+0308,U+0329,U+2000-206F,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;}
+@font-face{font-family:'Fondamento';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/fondamento-400-ext.woff2') format('woff2');
+  unicode-range:U+0100-02BA,U+02BD-02C5,U+02C7-02CC,U+02CE-02D7,U+02DD-02FF,U+0304,U+0308,U+0329,U+1D00-1DBF,U+1E00-1E9F,U+1EF2-1EFF,U+2020,U+20A0-20AB,U+20AD-20C0,U+2113,U+2C60-2C7F,U+A720-A7FF;}
+
+/* ===== Playwrite — as OITO das Américas (ADR-0108 §2, issue #87 item 3) =====
+ * A mão que cada país ensina a escrever. Os EUA entram com AS DUAS que ensinam — escolher uma seria
+ * escolher pela criança. São variáveis no peso (100–400) e cada família é UM ficheiro: a Google não as
+ * corta por unicode-range, então não há metade `-ext` para carregar depois. SIL OFL 1.1, como as outras. */
+@font-face{font-family:'Playwrite BR';font-style:normal;font-weight:100 400;font-display:swap;
+  src:url('fonts/playwrite-br.woff2') format('woff2');}
+@font-face{font-family:'Playwrite US Trad';font-style:normal;font-weight:100 400;font-display:swap;
+  src:url('fonts/playwrite-us-trad.woff2') format('woff2');}
+@font-face{font-family:'Playwrite US Modern';font-style:normal;font-weight:100 400;font-display:swap;
+  src:url('fonts/playwrite-us-modern.woff2') format('woff2');}
+@font-face{font-family:'Playwrite CA';font-style:normal;font-weight:100 400;font-display:swap;
+  src:url('fonts/playwrite-ca.woff2') format('woff2');}
+@font-face{font-family:'Playwrite MX';font-style:normal;font-weight:100 400;font-display:swap;
+  src:url('fonts/playwrite-mx.woff2') format('woff2');}
+@font-face{font-family:'Playwrite AR';font-style:normal;font-weight:100 400;font-display:swap;
+  src:url('fonts/playwrite-ar.woff2') format('woff2');}
+@font-face{font-family:'Playwrite CL';font-style:normal;font-weight:100 400;font-display:swap;
+  src:url('fonts/playwrite-cl.woff2') format('woff2');}
+@font-face{font-family:'Playwrite CO';font-style:normal;font-weight:100 400;font-display:swap;
+  src:url('fonts/playwrite-co.woff2') format('woff2');}

package/dist-pkg/boot/create-game.d.ts

@@ -1,6 +1,7 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 import { type Alcance, type Disponibilidade } from '../input/transports.js';
 import { type ActionPreset } from '../core/actions.js';
+import type { KeyScheme } from '../core/entity.js';
 import { type GameDeclaration } from '../core/contract.js';
 import { type SceneStack } from '../core/scenes.js';
 import { createTts, type CarregarVozNeural } from '../platform/tts.js';
@@ -10,12 +11,49 @@ import { type SettingsPanelApi } from '../ui/settings-panel.js';
 import { type MenuNavApi } from '../ui/menu-nav.js';
 import type { NavKeys } from '../input/edges.js';
 import { type KeyboardRuntime } from '../input/keyboard-runtime.js';
+import { type RelatorioPesado } from '../platform/pesados.js';
 /** O que o jogo empresta do documento. Tudo opcional menos `doc`/`win`: o que faltar vira `problems`. */
 export interface EngineHost {
     readonly doc: Document;
     readonly win: Window;
     /** Um `<svg>` vazio onde os seis filtros de daltonismo são montados em tempo de execução. */
     readonly cvdHost?: SVGElement | Element | null;
+    /**
+     * ONDE A BARRA DE ACESSIBILIDADE ENTRA, na PRIMEIRA tela do jogo.
+     *
+     * ⚠️ PEDIDO DO DEV, 2026-09-07: «o menu de pausa, o design do menu de pausa e os ícones de acessibilidade
+     * que aparecem no jogo desde a primeira tela devem ser oferecidos pela ENGINE e não pela programação do
+     * jogo. Todo jogo da engine inclusionist deve ter o mesmo menu de pausa e ícones de acessibilidade desde a
+     * primeira.»
+     *
+     * ⚠️ E A MEDIÇÃO DE 2026-09-08 MOSTROU QUE É UM ACHADO, e não uma arrumação: dos seis jogos do catálogo
+     * local, CINCO não têm barra de acessibilidade nenhuma — nem menu de pausa. `pixi-15-puzzle`, `game-chess`,
+     * `game-soccer`, `2048` e `whackwhack` não chamam `initPauseIcons` nem montam HUD, e o `createGame` nunca
+     * os montou por eles. O comentário do `ui/pause-icons` diz porquê sem o notar: «`initPauseIcons` é chamado
+     * pela raiz de composição de CADA jogo» — ou seja, cada jogo tinha de se lembrar, e cinco não se lembraram.
+     * A criança que depende do modo cego, do TTS ou do alto contraste abre esses cinco jogos e não tem por onde.
+     *
+     * Ausente, a engine procura `#title-icons` — o id que o jogo de plataforma usa desde sempre — e, não o
+     * achando, diz-o em `problems`.
+     *
+     * ✅ E DESDE 2026-09-08 ELA TAMBÉM **MONTA** (etapa 2 do ADR-0106 §4). Este parágrafo dizia «dizer não é
+     * montar, e a montagem é o passo seguinte»; o passo seguinte aconteceu. O que a destravou foram as etapas
+     * 1 e 3: nenhuma delas era sobre montar, e sem as duas o `PauseIconsCtx` exigia sete coisas que esta raiz
+     * não sabe responder por um jogo que não conhece.
+     *
+     * ⚠️ Achando o hospedeiro, a barra é escrita e fiada aqui. Não achando, continua a ser `problems` — porque
+     * a engine pode oferecer os ícones, mas não pode adivinhar ONDE eles cabem no desenho de um jogo alheio.
+     */
+    readonly a11yBarHost?: Element | null;
+    /**
+     * ONDE O CARTÃO DE PAUSA da primeira tela é pendurado. Ausente, a engine usa `#game-region`.
+     *
+     * ⚠️ Existe pela mesma razão do `a11yBarHost`: a engine pode OFERECER a pausa, mas não sabe onde ela cabe
+     * no desenho de um jogo alheio. 📌 E desde o ADR-0120 ONDE já não é SE: a pausa deixou de ser declinável, e
+     * o que sobra deste campo é o lugar. Um hospedeiro que não aceite filhos vira linha de `problems`, que é a
+     * diferença entre a engine não saber e a engine calar-se.
+     */
+    readonly pauseHost?: Element | null;
 }
 /**
  * O que este jogo NÃO tem. Declarado, e não deduzido de um getter que devolve null.
@@ -24,12 +62,24 @@ export interface EngineHost {
  * "pausado" para navegar os próprios menus, porque a engine não tinha por onde ouvir "eu não tenho fases".
  */
 export interface Declinios {
-    /** Sem menu de pausa por tela (um quiz não tem). */
-    readonly semMenuDePausa?: boolean;
     /** Sem assistente de mapeamento de controle. */
     readonly semAssistenteDePad?: boolean;
     /** Sem "ator da pausa" — quem apertou o botão que abriu o menu. */
     readonly semAtorDePausa?: boolean;
+    /**
+     * Sem voz neural — este jogo não abre a porta do ADR-0094.
+     *
+     * ⚠️ EXISTE PORQUE A AUSÊNCIA ESTAVA A SER SILENCIOSA, e a medição de 2026-09-08 diz quanto: dos SEIS jogos
+     * do catálogo local, TRÊS declaram `carregarVozNeural` (platformer, 15-puzzle, 2048) e TRÊS não
+     * (`game-soccer`, `whackwhack`, `game-chess`). Nos três últimos não há voz neural nenhuma, e nada o dizia.
+     *
+     * ⚠️ E ISSO CONTRADIZ UMA PROMESSA ESCRITA. O ADR-0065 §3 diz que as vozes «fazem parte da engine, e não do
+     * jogo em si» e que um cartucho «não tem de saber que existe»; o ADR-0094 — com razão, e por 135 MB de WASM
+     * — passou a exigir UMA LINHA do jogo. As duas coisas podem ser verdade ao mesmo tempo (a engine é dona das
+     * VOZES, o jogo nomeia o FORNECEDOR), mas só se quem esquece a linha for avisado. Declinar é escolha; não
+     * declarar era omissão.
+     */
+    readonly semVozNeural?: boolean;
 }
 export interface CreateGameOptions {
     /** Os SETE CAMPOS (core/contract). É o que a pilha de acessibilidade lê, e a única coisa que ela lê. */
@@ -51,9 +101,12 @@ export interface CreateGameOptions {
     readonly comIndice?: () => boolean;
     readonly naBarraDe?: (i: number) => boolean;
     readonly navBar?: (i: number, k: NavKeys) => void;
-    /** Jogadores para o teclado remapeável. `Pick<ControlledPlayer,'ctrl'>` — esquema de teclas e nada mais. */
+    /** Jogadores para o teclado remapeável. `Pick<ControlledPlayer,'ctrl'>` — esquema de teclas e nada mais.
+     *  ⚠️ `KeyScheme` e não `Record<string, string[]>` desde a #118: era uma CÓPIA ESTRUTURAL do tipo, e uma
+     *  cópia que ninguém obriga a concordar diverge — é a lição que o próprio `core/entity` abre a dizer, com
+     *  o `DomQuery` (dezasseis cópias) e o `KeyScheme` (seis) como as contas já pagas. */
     readonly players?: {
-        ctrl: Record<string, string[]>;
+        ctrl: KeyScheme;
     }[];
     /** Troca de fase, para quem tem fases. Ausente = não faz nada (o jogo sem fases não perde nada). */
     readonly setPhase?: (p: 'title' | 'playing' | 'paused') => void;
@@ -91,6 +144,35 @@ export interface CreateGameOptions {
      * painel de áudio deixa de OFERECER o motor neural, em vez de o oferecer e nunca o carregar.
      */
     readonly carregarVozNeural?: CarregarVozNeural;
+    /**
+     * BAIXAR AS COISAS PESADAS NO PRIMEIRO CARREGAMENTO? Padrão **sim** (ADR-0110 (b), ADR-0116, ADR-0119).
+     *
+     * As quatro vozes neurais são ~241 MB e descem em SEGUNDO PLANO, uma de cada vez, sem bloquear o jogo: a
+     * criança joga enquanto elas chegam, e o que não pode acontecer é ela voltar no segundo dia, sem rede, e
+     * descobrir que a voz nunca foi buscada. O pilar 8 é «primeiro dia ONLINE, depois offline-first», e o
+     * ADR-0116 tirou a contradição que travava isto — instalar já é um acto de rede.
+     *
+     * ⚠️ PÔR `false` É PARA QUEM TEM RAZÃO PARA O FAZER, e a razão que já existe é um TESTE: um caso que monte
+     * o arranque num navegador de verdade não pode disparar 241 MB contra o Hugging Face. Um jogo em produção
+     * que o desligue está a decidir que a criança dele fica sem voz neural offline.
+     *
+     * 📌 E o ADR-0117 diz que quem devia pagar isto uma vez é a PLATAFORMA, não cada cartucho — a Cache Storage
+     * é particionada por origem, e num site só os 241 MB descem uma vez para todos os jogos. Enquanto a
+     * plataforma não os pede, é o jogo que os pede: melhor descer duas vezes do que nunca.
+     */
+    readonly baixarPesados?: boolean;
+    /**
+     * O QUE ACONTECEU COM CADA COISA PESADA, à medida que acontece. Ausente = ninguém está a ver.
+     *
+     * ⚠️ É AQUI E NÃO EM `problems` porque a descarga é de FUNDO: `problems` é devolvido sincronamente pelo
+     * `createGame`, e uma linha que chegue depois disso entra num vector que o leitor já leu. O ADR-0110 pede
+     * que uma busca falhada seja REPORTADA — reportar é ter um canal que existe quando a notícia chega, e não
+     * empurrar para uma lista que já foi entregue.
+     *
+     * 📌 A engine não inventa superfície nenhuma com isto: quem sabe onde cabe «faltam 241 MB» na tela de um
+     * jogo é o jogo. `pesoPorBaixar(relatorio)` dá o número para a frase.
+     */
+    readonly aoProgredirPesados?: (r: RelatorioPesado) => void;
     /**
      * Como se descobre que cada transporte está aqui. Ausente = a engine pergunta ao aparelho.
      *
@@ -101,6 +183,27 @@ export interface CreateGameOptions {
 }
 export interface Engine {
     readonly declaration: GameDeclaration;
+    /**
+     * A PAUSA QUE ESTA RAIZ MONTOU — mostrar e esconder, sem o consumidor caçar id nenhum.
+     *
+     * ⚠️ EXISTE PORQUE MONTAR NÃO É MOSTRAR, e a etapa 2 do ADR-0106 tinha ficado a meio sem que nada o
+     * dissesse. O cartão nasce `hidden` (é assim que o `buildScreenPause` o entrega, e tem de ser: a pausa
+     * abre-se, não está aberta) e QUEM O REVELA é o `ui/shell`, por fase — que esta raiz **não monta**, de
+     * propósito: «não substitui o boot do main.js, que tem catorze anos de ordem própria».
+     *
+     * ⚠️ Sem estas duas, um jogo montado por `createGame` ficava com um cartão de pausa que NADA mostrava. Não
+     * é «o consumidor esqueceu-se»: não havia por onde, a não ser procurar `#vp-pause-0` no documento — que é
+     * exactamente o tipo de conhecimento que este ficheiro existe para não exigir.
+     *
+     * 📌 A engine OFERECE o mecanismo e não toma a fase. Quando abrir a pausa continua a ser do jogo, porque só
+     * ele sabe o que é estar a jogar; o que deixa de ser dele é saber COMO.
+     */
+    readonly pausa: {
+        /** Revela o cartão da tela `i` e refaz os itens — o §5 avaliado no instante em que ela abre. */
+        readonly mostrar: (i: number) => void;
+        /** Esconde-o outra vez. */
+        readonly esconder: (i: number) => void;
+    };
     readonly tts: ReturnType<typeof createTts>;
     readonly overlays: SettingsPanelApi;
     readonly nav: MenuNavApi;