@the-inclusionist/engine 7.0.0 → 8.0.0-rc.1

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,50 @@
 @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;}

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';
@@ -16,6 +17,41 @@ export interface EngineHost {
     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. Um jogo que não tem pausa nenhuma declara `declines.semMenuDePausa` —
+     * declinar é escolha registada, não ter é omissão, e o ADR-0106 §2 é inteiro sobre a diferença.
+     */
+    readonly pauseHost?: Element | null;
 }
 /**
  * O que este jogo NÃO tem. Declarado, e não deduzido de um getter que devolve null.
@@ -30,6 +66,20 @@ export interface Declinios {
     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;
@@ -101,6 +154,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;

package/dist-pkg/boot/create-game.js

@@ -41,20 +41,27 @@
 // exige seis coisas de plataforma. Não substitui o boot do `main.js`, que tem catorze anos de ordem própria.
 // O que ele cobre é o que o quiz provou ser IDÊNTICO em qualquer jogo: idioma, leitor de tela, mixer, voz,
 // pilha de diálogos, filtros de daltonismo, teclado remapeável e navegação de menu.
-import { initI18n } from '../core/i18n.js';
+import { initI18n, idiomaPronto } from '../core/i18n.js';
+import { entradaDe } from '../input/state.js';
 import { criarAvisoDeQueda } from '../ui/loop-crash.js';
 import { initFocusTrap, focaveisNoDom } from '../ui/focus-trap.js';
 import { mostrarAvisoDeAlcance } from '../ui/reach-notice.js';
 import { alcance, transportesPadrao } from '../input/transports.js';
-import { presetActions } from '../core/actions.js';
+import { presetActions, ACTIONS } from '../core/actions.js';
 import { t } from '../core/i18n.js';
 import { srSay, srAlert } from '../core/a11y-sr.js';
+import { initPauseIcons, iconsMarkup } from '../ui/pause-icons.js';
+// O módulo INTEIRO: o on do barramento de eventos, para a barra montada continuar a dizer a verdade.
+import * as state from '../core/state.js';
+import { vlibrasOpen, toggleLibras } from '../ui/vlibras.js';
 import { conformanceProblems } from '../core/contract.js';
 import { criarPilha } from '../core/scenes.js';
 import { createTts } from '../platform/tts.js';
-import { ensureAC, catNode, audioOut, soundOn, volume, audioCat, initAudioMixer, tonePan, audioCtx } from '../platform/audio.js';
+import { ensureAC, catNode, audioOut, soundOn, volume, audioCat, initAudioMixer, tonePan, audioCtx, setCatGain } from '../platform/audio.js';
 import { createAudioSonar } from '../platform/audio-sonar.js';
-import { VIZ_BY_KEY } from '../render/viz-modes.js';
+// A raiz é a camada que PODE conhecer os dois eixos: `render/` está abaixo dela, e é dela a tarefa de
+// responder ao `platform/audio-sonar`, que não pode importar daqui sem inverter uma aresta (#104).
+import { ehCego, ehBaixaVisao, PADRAO } from '../render/viz-axes.js';
 import { OVERLAY_SCOPE_SELECTOR } from '../ui/settings-panel.js';
 import { LOGICAL_W } from '../core/constants.js';
 import { initSettingsPanel } from '../ui/settings-panel.js';
@@ -64,6 +71,15 @@ import { kb, initKB } from '../input/keyboard.js';
 import { installCvdFilters } from '../render/cvd-matrices.js';
 /** Os ids que os painéis emprestados exigem do documento. Achado 6: sem eles o painel abre VAZIO, sem erro. */
 const MARCACAO_EXIGIDA = ['#game-region', '#sr-status', '#sr-alert'];
+/**
+ * Onde a engine procura a barra de acessibilidade quando o jogo não declara `host.a11yBarHost`.
+ *
+ * ⚠️ NÃO ENTROU NA `MARCACAO_EXIGIDA` de propósito, e a diferença é de mensagem e não de rigor. Aquela lista
+ * produz «marcação ausente: #x», que é o que se diz de um id que o jogo esqueceu. Aqui o que falta não é um
+ * id — é a barra inteira, e cinco jogos do catálogo não a têm porque ninguém lhes disse que a deviam ter. A
+ * frase própria pode explicar O QUE se perde, e é isso que a torna útil a quem a lê pela primeira vez.
+ */
+const SELETOR_BARRA_A11Y = '#title-icons';
 /**
  * Liga a engine para um jogo declarado.
  *
@@ -108,6 +124,11 @@ export function createGame(o) {
         getSoundOn: () => soundOn, getVolume: () => volume, getAudioCat: () => audioCat,
         carregarVozNeural: o.carregarVozNeural,
     });
+    if (!o.carregarVozNeural && !declines.semVozNeural) {
+        problems.push('sem voz neural: declare `carregarVozNeural` (uma linha — ver ADR-0094) ou `declines.semVozNeural`. '
+            + 'Sem ela a criança que não lê fica com a voz do sistema, que em Chromebook de escola pode não existir '
+            + 'em português');
+    }
     /**
      * O FILTRO DE VISÃO, aplicado ao MUNDO QUE O JOGO DECLAROU (ADR-0087).
      *
@@ -147,25 +168,208 @@ export function createGame(o) {
     const cvdFilters = installCvdFilters(o.host.cvdHost ?? null);
     if (!cvdFilters)
         problems.push('sem host de filtros (<svg>): a correção de daltonismo não foi montada');
+    // 4c. A BARRA DE ACESSIBILIDADE DA PRIMEIRA TELA. Ver a nota em `EngineHost.a11yBarHost`: cinco dos seis
+    //     jogos do catálogo não têm nenhuma, e nada o dizia. Isto não a monta — diz que ela falta, que é o
+    //     passo que tira o silêncio. A frase nomeia a saída, como as outras deste bloco fazem.
+    const a11yBar = o.host.a11yBarHost ?? $(SELETOR_BARRA_A11Y);
+    if (!a11yBar) {
+        problems.push(`sem barra de acessibilidade na primeira tela: declare \`host.a11yBarHost\` ou ponha um ${SELETOR_BARRA_A11Y} no documento. Sem ela a criança não alcança modo cego, TTS, alto contraste nem Libras antes de começar`);
+    }
+    /*
+     * ⚠️ E AGORA A ENGINE MONTA-A (ADR-0106 §4, etapa 2). Até 2026-09-08 esta raiz só REPORTAVA a ausência, e o
+     * registo dizia porquê: «reportar não é oferecer — cinco jogos continuam sem barra até alguém agir na
+     * linha». A etapa 1 tirou dos sete campos acidentais a obrigação de virem do jogo, e a 3 deu lista padrão
+     * ao menu; com isso o `PauseIconsCtx` deixou de exigir seja o que for que esta raiz não saiba responder.
+     *
+     * ⚠️ NÃO É `buildQuickBar`, e a diferença tem dono: aquele põe `tabIndex = -1` nos botões porque durante a
+     * partida dez paradas de tabulação separam a criança do jogo (ADR-0044 item 7). Na primeira tela não se
+     * está a jogar, e tirar os ícones da ordem de tabulação ali seria escondê-los de quem navega por teclado —
+     * exactamente a pessoa para quem eles existem.
+     */
+    /**
+     * O LEITOR DO MODO CEGO — e ele tem de ler ONDE O ESCRITOR PADRÃO ESCREVE.
+     *
+     * 🔴 ESTAS DUAS METADES GANHARAM PADRÃO EM DIAS DIFERENTES E NÃO SE FALAVAM, o que produziu um defeito que
+     * nenhum teste podia ver. O escritor recebeu o padrão da engine na etapa 1b do ADR-0106
+     * (`ui/pause-icons` → `ctx.setModoCego ?? setModoCegoValue`), que grava no `core/state`. O leitor ficou com
+     * o `() => false` que já cá estava — uma CONSTANTE. Num jogo que não injecta `isBlindMode`:
+     *
+     *   1. a criança carrega no ícone → `setModoCego(!false)` → o modo LIGA de verdade;
+     *   2. o reflexo lê `false` → o ícone diz «desligado» e o anúncio diz o mesmo;
+     *   3. ela carrega outra vez → `setModoCegoValue(!false)` = `true` OUTRA VEZ → a guarda de igualdade do
+     *      `core/state` devolve cedo → nada acontece.
+     *
+     * ⚠️ O modo cego ligava uma vez e NÃO HAVIA COMO DESLIGAR — um jogo que começa a descrever tudo em voz alta
+     * e não se cala, sem erro em lado nenhum. Para quem não depende dele, é o jogo a ficar inutilizável.
+     *
+     * 📌 UMA CONSTANTE E NÃO A EXPRESSÃO REPETIDA NOS DOIS SÍTIOS, porque a repetição É o defeito: duas
+     * respostas à mesma pergunta divergem, e foi assim que esta divergiu. `import * as state` dá ligação VIVA,
+     * então isto lê o valor de agora e não o do arranque.
+     */
+    const lerModoCego = o.isBlindMode ?? (() => state.modoCego);
+    const pauseIcons = initPauseIcons({
+        doc,
+        getPlayers: () => o.players ?? [],
+        getNumPlayers: () => (o.players ?? [null]).length,
+        srSay, srAlert,
+        // ⚠️ NÃO `instanceof HTMLElement`: esse é um GLOBAL DO NAVEGADOR, e lê-lo onde ele não existe LANÇA —
+        // não devolve falso. Escrito assim na etapa 2, fazia o `reflectPauseIcons` rebentar em qualquer ambiente
+        // sem DOM. É o mesmo erro de forma do ACHADO 15 no cabeçalho deste ficheiro: alcançar o global por baixo
+        // de quem injectou o documento. A pergunta certa é a mesma que o `barraUsavel` faz — sabe ser uma barra?
+        getA11yBars: () => (barraUsavel && a11yBar ? [a11yBar] : []),
+        getModoCego: lerModoCego,
+        getAudioCat: () => audioCat,
+        setCatGain,
+        /*
+         * ⚠️ QUEM RESPONDE PELO APARELHO EM USO É A RAIZ, e é aqui que o autómato do ADR-0109 ganha o primeiro
+         * leitor. `input/state.entradaDe(i)` devolve `PADRAO` para quem nunca produziu uma aresta, logo isto
+         * nunca é `undefined` e o ícone nunca escreve numa chave torta.
+         *
+         * 📌 E é a RAIZ que o passa, não o ícone que o importa: `ui/` a ler estado de módulo de `input/` seria
+         * uma aresta nova entre camadas para poupar um argumento. A composição é o trabalho deste ficheiro.
+         */
+        transporteEmUso: (i) => entradaDe(i).emUso,
+        reflectTtsPanel: () => { },
+        reflectTtsPanelEnabled: false,
+        isLibrasOn: vlibrasOpen,
+        toggleLibras,
+    });
+    /*
+     * ⚠️ O HOSPEDEIRO TEM DE SABER SER UMA BARRA, e perguntar isso não é zelo: `a11yBarHost` é `Element` no
+     * tipo, e um consumidor pode passar um duplo, um nó de outro documento, ou um elemento de um `<svg>`. Sem
+     * esta guarda, um objecto sem `addEventListener` derruba o BOOT INTEIRO — e derrubá-lo por causa da barra
+     * de acessibilidade seria tirar o jogo a toda a gente para não o dar a ninguém.
+     *
+     * Não sabendo, é `problems` como qualquer outra lacuna do hospedeiro: o consumidor lê e conserta.
+     */
+    const barraUsavel = !!a11yBar
+        && typeof a11yBar.addEventListener === 'function'
+        && 'innerHTML' in a11yBar;
+    if (a11yBar && !barraUsavel) {
+        problems.push('o elemento da barra de acessibilidade não aceita conteúdo nem clique: os ícones não foram montados');
+    }
+    if (a11yBar && barraUsavel) {
+        a11yBar.innerHTML = iconsMarkup(pauseIcons.iconesMontados);
+        a11yBar.addEventListener('click', (e) => {
+            const botao = e.target?.closest('.pi-btn');
+            if (!botao)
+                return;
+            pauseIcons.iconAct(botao.dataset.pi ?? '', 0);
+            pauseIcons.reflectIconsIn(a11yBar, 0);
+            // O anúncio lê o `aria-label` DEPOIS do reflexo, porque é ele que carrega o estado NOVO — anunciar
+            // antes diria o estado que a criança acabou de deixar.
+            srSay(botao.getAttribute('aria-label') ?? '');
+        });
+        pauseIcons.reflectIconsIn(a11yBar, 0);
+        /*
+         * ⚠️ E OUTRA VEZ QUANDO O IDIOMA DO ARRANQUE CHEGAR — sem isto a barra fica no idioma de RECUO.
+         *
+         * O `initI18n` aplica pt de forma síncrona (para a página nunca ficar em branco) e, se o idioma
+         * preferido for outro, PEDE a troca — que é assíncrona, porque en/es são chunks sob demanda. Esta
+         * marcação nasce nesse intervalo. 📏 Medido num navegador em 2026-09-08, com `lang="en"`: a barra
+         * servia cinco rótulos em inglês e três ainda em português, na mesma linha de ícones.
+         *
+         * 📌 O `idiomaPronto()` existe exactamente para isto, e o cabeçalho dele já descreve o defeito noutro
+         * lugar: «o `applyDom` conserta o markup ESTÁTICO, mas o que o JavaScript monta tinha capturado o
+         * texto de pt e ninguém reconstruía». A barra é a instância nova, criada quando a ENGINE passou a
+         * montá-la (ADR-0106 etapa 2).
+         *
+         * ⚠️ É O `idiomaPronto()` E NÃO O EVENTO `i18n:change`, de propósito: o evento é a troca de idioma EM
+         * EXECUÇÃO, e o próprio `core/i18n` declara essa pergunta como sendo do Dev («QUANDO a interface se
+         * reconstrói ao trocar de idioma em execução»). Isto responde só a pergunta do ARRANQUE, que aquele
+         * mesmo comentário diz não ter duas respostas.
+         */
+        void idiomaPronto().then(() => { pauseIcons.reflectIconsIn(a11yBar, 0); });
+        /*
+         * ⚠️ E ELA TEM DE CONTINUAR A DIZER A VERDADE quando o estado muda NOUTRO SÍTIO. O modo cego liga-se
+         * também pelo painel de áudio e pela simulação de empatia; sem esta assinatura, o ícone da barra ficaria
+         * a dizer «desligado» com `aria-pressed=false` depois de a criança o ter ligado — o controlo a mentir o
+         * estado, que é a família de defeito que o `reflectTTS` e o `#opt-modocego` já custaram a este projeto.
+         *
+         * 📌 SÓ O MODO CEGO, e a limitação é medida e não preguiça: dos ícones que esta raiz monta, ele é o ÚNICO
+         * cujo estado tem evento (`EventoDoJogo` tem `modoCego`; TTS, Libras, TEA e alternância não emitem nada).
+         * Os outros continuam a refletir-se ao clique, que é o caminho por onde hoje eles mudam.
+         */
+        state.on('modoCego', () => { pauseIcons.reflectIconsIn(a11yBar, 0); });
+    }
+    // 4d. QUEM ABRIU A PAUSA, quando há mais de um assento — o achado 3 da auditoria do `game-soccer`.
+    //
+    // ⚠️ O PAINEL DE CONTROLE É PARAMETRIZADO PELO ASSENTO: `render(selPlayer)` desenha as posições DAQUELE
+    // esquema, e não há selector de assento — o `#ctrl-players` é uma FRASE, não abas. Quem decide o assento é
+    // o consumidor, passando o ator da pausa: «edita o controle de quem abriu o menu».
+    //
+    // ⚠️ E É AQUI QUE ISTO FICA MUDO. O `setPauseActor` desta raiz é `() => {}` — literal, logo abaixo. Um jogo
+    // montado por `createGame` com dois assentos deixa a criança do SEGUNDO sem como remapear, e nada o diz.
+    // Não é a mesma coisa que declarar `semAtorDePausa`: essa é uma ausência declarada, e uma ausência
+    // declarada é uma escolha. Esta era uma ausência por omissão, que é a forma de defeito do ADR-0106 §2.
+    const assentos = (o.players ?? []).length;
+    if (assentos > 1 && !declines.semAtorDePausa) {
+        problems.push(`declarou ${assentos} jogadores e não registra o ator da pausa: o painel de controle edita sempre o `
+            + 'assento 0, então ninguém além do primeiro consegue remapear. Declare `declines.semAtorDePausa` se '
+            + 'for de propósito');
+    }
+    /*
+     * 4e. O CARTÃO DE PAUSA DA PRIMEIRA TELA — e isto fecha um LAÇO QUE ESTAVA ABERTO.
+     *
+     * 📏 MEDIDO EM 2026-09-08, nos seis jogos do catálogo local: `#vp-pause-0` é procurado por esta raiz (o
+     * `getPauseMenu` do `initMenuNav`, mais abaixo) e **NENHUM jogo o cria**. `git grep vp-pause` devolve zero
+     * em `game-platformer`, `game-soccer`, `pixi-15-puzzle`, `2048`, `whackwhack` e `game-chess`. Ou seja: a
+     * engine inventou uma convenção, procurou-a, não a achou, e concluiu em silêncio que nenhum jogo tem menu
+     * de pausa — que é a MESMA forma de defeito do ADR-0106 §2, desta vez cometida pela engine contra si mesma.
+     *
+     * Agora ela cria o que procura. Quem declina (`semMenuDePausa`) continua sem nada e sem acusação — declinar
+     * é escolha; não ter é omissão.
+     */
+    const hospedeiroDaPausa = declines.semMenuDePausa ? null : (o.host.pauseHost ?? $('#game-region'));
+    const pausaUsavel = !!hospedeiroDaPausa && typeof hospedeiroDaPausa.appendChild === 'function';
+    if (!declines.semMenuDePausa && !pausaUsavel) {
+        problems.push('sem sítio para o menu de pausa: declare `host.pauseHost` ou tenha um #game-region que aceite filhos. '
+            + 'Sem ele a criança não alcança os ajustes durante a partida, e `declines.semMenuDePausa` é como se diz '
+            + 'que isso é de propósito');
+    }
+    if (hospedeiroDaPausa && pausaUsavel) {
+        const cartao = pauseIcons.buildScreenPause(0);
+        // ⚠️ O ID É O QUE A PRÓPRIA ENGINE PROCURA, logo abaixo, no `getPauseMenu`. Montar sem o pôr deixaria o
+        // laço tão aberto como estava — o cartão existiria e a navegação de menu continuaria a não o achar.
+        cartao.id = 'vp-pause-0';
+        hospedeiroDaPausa.appendChild(cartao);
+    }
     // 4b. NAVEGAÇÃO SONORA. Só o contrato entra: nada de tile, caixa de colisão ou array de moedas.
     const sonar = createAudioSonar({
         topology: () => o.declaration.topology(),
         targetsOf: (i) => o.declaration.targetsOf(i),
         nameAt: (at) => o.declaration.nameAt(at),
+        // Campo 2 + o barramento do mixer: o que o GUIA CONTÍNUO precisa e o bipe não precisava (#84 item 2). O
+        // `roleAt` é o que deixa a rota contornar parede; o `catNode`/`audioOut`/`getVolume` são o que põem um
+        // grafo PERMANENTE no mesmo cursor de volume que todo o resto do áudio usa.
+        roleAt: (at) => o.declaration.roleAt(at),
         tonePan, srSay, narrate: (texto) => tts.narrate(texto),
-        VIZ_BY_KEY, getModoCego: o.isBlindMode ?? (() => false), LOGICAL_W,
+        catNode, audioOut, getVolume: () => volume,
+        // ⚠️ A RESPOSTA, E NÃO A TABELA (#104). O `platform/audio-sonar` recebia o `VIZ_BY_KEY` e atravessava-o
+        // com `pl.viz`; ele deixou de saber o que é um modo visual, e quem responde é aqui — a raiz é a única
+        // camada que conhece os dois eixos E pode importar de `render/`.
+        visaoComprometida: (pl) => {
+            const v = pl.visual;
+            return !!v && (ehCego(v) || ehBaixaVisao(v));
+        },
+        getModoCego: lerModoCego, LOGICAL_W,
         // O jogador DERIVADO do foco: campo 4 respondendo "onde a criança está". Um jogo que não fornece lista
         // ainda tem sonar, e é isso que faz a pilha de acessibilidade não ser acessório.
         getPlayers: o.sonarPlayers ?? (() => {
             const f = o.declaration.focusOf(0);
-            return f ? [{ i: 0, x: f.at.x, y: f.at.y, viz: 'normal' }] : [];
+            return f ? [{ i: 0, x: f.at.x, y: f.at.y, visual: PADRAO }] : [];
         }),
         getNumPlayers: () => (o.players ?? [null]).length,
         getAudioCtx: () => audioCtx, getSoundOn: () => soundOn, getAudioCat: () => audioCat,
     });
     // 5. Teclado remapeável — o melhor recorte da base (achado 11): esquema de teclas, sem mundo.
     initKB();
-    const players = o.players ?? [{ ctrl: {} }];
+    // ⚠️ O ESQUEMA DE ARRANQUE ALCANÇA NADA, e diz isso com `null` em vez de com um objeto vazio (issue #118).
+    // Ele vive um instante — `assignControls()` logo abaixo substitui-o pelo esquema real —, mas enquanto vive
+    // é um `KeyScheme` como qualquer outro, e a única forma honesta de um esquema que não alcança nada é
+    // catorze ausências declaradas. Um `{}` fazia o tipo mentir sobre estar completo.
+    const semAlcance = Object.fromEntries(ACTIONS.map((a) => [a, null]));
+    const players = o.players ?? [{ ctrl: semAlcance }];
     const keyboard = initKeyboardRuntime({
         getKB: () => kb, getNumPlayers: () => players.length, getPlayers: () => players,
     });
@@ -182,10 +386,25 @@ export function createGame(o) {
         // que ele existe se vier desligado (a mesma razão de o modo cego nascer com TTS e sonar).
         comIndice: o.comIndice ?? (() => true),
         isNavigable: o.isNavigable ?? (() => true),
-        // Um hospedeiro que nao tenha barra de acessibilidade responde "nunca" e nunca chama nada — o modo e'
-        // opcional para o consumidor, obrigatorio para este jogo.
-        naBarraDe: o.naBarraDe ?? (() => false),
-        navBar: o.navBar ?? (() => { }),
+        /*
+         * ⚠️ ESTE PADRÃO ERA `() => false` / `() => {}`, E DESDE HOJE ISSO SERIA UM BURACO QUE EU ABRI. O
+         * comentário que estava aqui dizia «um hospedeiro que não tenha barra de acessibilidade responde nunca e
+         * nunca chama nada» — verdade até a etapa 2 do ADR-0106, quando esta raiz passou a MONTAR a barra.
+         *
+         * Com a barra montada e estes dois em no-op, ela existiria e **não se conseguiria navegar por teclado nem
+         * por controle**: alcançável só por ponteiro. Para uma criança cega, que navega por teclado, uma barra
+         * que ela não alcança é o mesmo que barra nenhuma — e é exactamente o «oferece o caminho e depois
+         * recusa-o» que o §5 do ADR-0106 proíbe.
+         *
+         * A engine responde com a SUA instância, que é a mesma que montou a barra. Quem injecta continua a mandar.
+         *
+         * ⚠️ E FICA UMA METADE POR LIGAR, dita aqui em vez de descoberta: o `navBar` do `ui/menu-nav` recebe
+         * `(i, k)` e não o terceiro argumento `temStart`, que é a borda do botão de pausa — a SEGUNDA saída do
+         * modo (ADR-0044 item 7). No cartucho ela chega por outra rota (o encaminhador do gamepad, `main.ts:1470`)
+         * que esta raiz ainda não monta. Logo: o direcional navega a barra; sair por START, por enquanto, não.
+         */
+        naBarraDe: o.naBarraDe ?? ((i) => pauseIcons.naBarraDe(i)),
+        navBar: o.navBar ?? ((i, k) => pauseIcons.navBar(i, k)),
         isCapturing: () => false,
         closePadWiz: () => { },
         whichPlayer: (code) => keyboard.whichPlayer(code),
@@ -243,9 +462,30 @@ export function createGame(o) {
         catch {
             return true;
         } },
+        /**
+         * O RATO (ADR-0112) — e a sonda é `any-pointer` de propósito, não `pointer`.
+         *
+         * ⚠️ `(pointer:fine)` descreve o ponteiro PRIMÁRIO, então um tablet com rato ligado responde «coarse» e
+         * o rato desaparecia — exactamente o aparelho que esta pergunta existe para achar. `any-pointer:fine` diz
+         * «ALGUM dos dispositivos apontadores é fino», que é a pergunta certa: para desenhar basta um.
+         *
+         * ⚠️ ELA ERRA, e a direcção do erro é a que se aceita: um stylus também responde `fine`, e é um ponteiro
+         * a sério — logo isso não é erro. O que pode faltar é um rato ligado depois do arranque, e por isso a
+         * sonda é uma FUNÇÃO, avaliada a cada pergunta, como as três acima.
+         */
+        rato: () => { try {
+            return win.matchMedia('(any-pointer:fine)').matches;
+        }
+        catch {
+            return false;
+        } },
     };
     const acoesDoJogo = o.preset ? presetActions(o.preset) : [];
-    const alcanceAqui = alcance(transportesPadrao(disponibilidade), acoesDoJogo);
+    // O segundo eixo entra aqui, e vem do jogo (ADR-0104 §A): quantas posições ele segura ao mesmo tempo.
+    // ⚠️ O TERCEIRO EIXO ENTRA AQUI (ADR-0112), e vem do jogo tal como os outros dois. `?? false` e não um
+    // padrão inventado: o campo é opcional de propósito — ver a nota nele —, e a ausência significa «este jogo
+    // não desenha», que é a resposta certa para a esmagadora maioria dos trezentos.
+    const alcanceAqui = alcance(transportesPadrao(disponibilidade), acoesDoJogo, o.declaration.holdsAtOnce(), o.declaration.needsPointer?.() ?? false);
     // ⚠️ SÓ APARECE QUANDO HÁ O QUE DIZER. Um aviso que aparece sempre deixa de ser lido, e um jogo cujas ações
     // cabem no toque não tem nada a avisar — que é o caso comum e tem de continuar silencioso.
     if (acoesDoJogo.length) {
@@ -264,5 +504,23 @@ export function createGame(o) {
         criar: (tag) => doc.createElement(tag),
         narrar: (texto) => tts.narrate(texto),
     });
-    return { declaration: o.declaration, tts, overlays, nav, keyboard, sonar, aplicarFiltroDeVisao, cenas: criarPilha(), cvdFilters, problems, declines, aoFalhar, alcance: alcanceAqui };
+    /*
+     * ⚠️ MOSTRAR REFAZ OS ITENS ANTES DE REVELAR, e a ordem é a regra: o §5 do ADR-0106 diz que a criança nunca
+     * vê um item que não acciona, e a tabela de acções deste jogo pode ter mudado desde a montagem. Revelar
+     * primeiro e refazer depois deixaria um piscar em que ela vê o que não pode usar.
+     */
+    const pausa = {
+        mostrar: (i) => {
+            pauseIcons.reflectPauseIcons();
+            const cartao = $(`#vp-pause-${i}`);
+            if (cartao)
+                cartao.hidden = false;
+        },
+        esconder: (i) => {
+            const cartao = $(`#vp-pause-${i}`);
+            if (cartao)
+                cartao.hidden = true;
+        },
+    };
+    return { declaration: o.declaration, pausa, tts, overlays, nav, keyboard, sonar, aplicarFiltroDeVisao, cenas: criarPilha(), cvdFilters, problems, declines, aoFalhar, alcance: alcanceAqui };
 }