@the-inclusionist/engine 6.36.1

package/app/public/vendor/fonts.css

@@ -0,0 +1,88 @@
+/* SPDX-License-Identifier: OFL-1.1
+ * Fontes oficiais do EdSP — self-hosted (PWA offline). Todas SIL OFL 1.1.
+ *  Atkinson Hyperlegible  → PADRÃO (UI/leitura)            — Braille Institute
+ *  Andika                 → ALFABETIZAÇÃO                  — SIL
+ *  Lexend                 → OPCIONAL (dislexia/TDAH/discalculia) — SIL
+ *  Atkinson Hyperlegible Mono → MATEMÁTICA (algarismos)    — Braille Institute
+ * latin cobre PT-BR + nórdico (À-ÿ, å ä ö ø æ); latin-ext só baixa se necessário. */
+
+/* ---- ranges ---- */
+/* latin:     U+0000–00FF + pontuação tipográfica
+   latin-ext: U+0100–024F etc. (carga sob demanda) */
+
+/* ===== Atkinson Hyperlegible (PADRÃO) ===== */
+@font-face{font-family:'Atkinson Hyperlegible';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/atkinson-400.woff2') format('woff2');
+  unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;}
+@font-face{font-family:'Atkinson Hyperlegible';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/atkinson-400-ext.woff2') format('woff2');
+  unicode-range:U+0100-024F,U+0259,U+1E00-1EFF,U+2020,U+20A0-20AB,U+20AD-20CF,U+2113,U+2C60-2C7F,U+A720-A7FF;}
+@font-face{font-family:'Atkinson Hyperlegible';font-style:normal;font-weight:700;font-display:swap;
+  src:url('fonts/atkinson-700.woff2') format('woff2');
+  unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;}
+@font-face{font-family:'Atkinson Hyperlegible';font-style:normal;font-weight:700;font-display:swap;
+  src:url('fonts/atkinson-700-ext.woff2') format('woff2');
+  unicode-range:U+0100-024F,U+0259,U+1E00-1EFF,U+2020,U+20A0-20AB,U+20AD-20CF,U+2113,U+2C60-2C7F,U+A720-A7FF;}
+
+/* ===== Andika (ALFABETIZAÇÃO) ===== */
+@font-face{font-family:'Andika';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/andika-400.woff2') format('woff2');
+  unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;}
+@font-face{font-family:'Andika';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/andika-400-ext.woff2') format('woff2');
+  unicode-range:U+0100-024F,U+0259,U+1E00-1EFF,U+2020,U+20A0-20AB,U+20AD-20CF,U+2113,U+2C60-2C7F,U+A720-A7FF;}
+@font-face{font-family:'Andika';font-style:normal;font-weight:700;font-display:swap;
+  src:url('fonts/andika-700.woff2') format('woff2');
+  unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;}
+@font-face{font-family:'Andika';font-style:normal;font-weight:700;font-display:swap;
+  src:url('fonts/andika-700-ext.woff2') format('woff2');
+  unicode-range:U+0100-024F,U+0259,U+1E00-1EFF,U+2020,U+20A0-20AB,U+20AD-20CF,U+2113,U+2C60-2C7F,U+A720-A7FF;}
+
+/* ===== Lexend (OPCIONAL) ===== */
+@font-face{font-family:'Lexend';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/lexend-400.woff2') format('woff2');
+  unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;}
+@font-face{font-family:'Lexend';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/lexend-400-ext.woff2') format('woff2');
+  unicode-range:U+0100-024F,U+0259,U+1E00-1EFF,U+2020,U+20A0-20AB,U+20AD-20CF,U+2113,U+2C60-2C7F,U+A720-A7FF;}
+@font-face{font-family:'Lexend';font-style:normal;font-weight:700;font-display:swap;
+  src:url('fonts/lexend-700.woff2') format('woff2');
+  unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;}
+@font-face{font-family:'Lexend';font-style:normal;font-weight:700;font-display:swap;
+  src:url('fonts/lexend-700-ext.woff2') format('woff2');
+  unicode-range:U+0100-024F,U+0259,U+1E00-1EFF,U+2020,U+20A0-20AB,U+20AD-20CF,U+2113,U+2C60-2C7F,U+A720-A7FF;}
+
+/* ===== Atkinson Hyperlegible Mono (MATEMÁTICA) ===== */
+@font-face{font-family:'Atkinson Hyperlegible Mono';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/atkinson-mono-400.woff2') format('woff2');
+  unicode-range:U+0000-00FF,U+0131,U+0152-0153,U+02BB-02BC,U+02C6,U+02DA,U+02DC,U+2000-206F,U+2074,U+20AC,U+2122,U+2191,U+2193,U+2212,U+2215,U+FEFF,U+FFFD;}
+@font-face{font-family:'Atkinson Hyperlegible Mono';font-style:normal;font-weight:400;font-display:swap;
+  src:url('fonts/atkinson-mono-400-ext.woff2') format('woff2');
+  unicode-range:U+0100-024F,U+0259,U+1E00-1EFF,U+2020,U+20A0-20AB,U+20AD-20CF,U+2113,U+2C60-2C7F,U+A720-A7FF;}
+
+/* ===== L2/Tipografia: catálogo escolhível no menu (todas SIL OFL 1.1; subset latin) ===== */
+/* Sem serifa */
+@font-face{font-family:'iA Writer Quattro';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/quattro-400.woff2') format('woff2');}
+@font-face{font-family:'iA Writer Quattro';font-style:normal;font-weight:700;font-display:swap;src:url('fonts/quattro-700.woff2') format('woff2');}
+@font-face{font-family:'Source Sans 3';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/sourcesans-400.woff2') format('woff2');}
+@font-face{font-family:'Source Sans 3';font-style:normal;font-weight:700;font-display:swap;src:url('fonts/sourcesans-700.woff2') format('woff2');}
+@font-face{font-family:'Inter';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/inter-400.woff2') format('woff2');}
+@font-face{font-family:'Inter';font-style:normal;font-weight:700;font-display:swap;src:url('fonts/inter-700.woff2') format('woff2');}
+@font-face{font-family:'Open Sans';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/opensans-400.woff2') format('woff2');}
+@font-face{font-family:'Open Sans';font-style:normal;font-weight:700;font-display:swap;src:url('fonts/opensans-700.woff2') format('woff2');}
+@font-face{font-family:'Lato';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/lato-400.woff2') format('woff2');}
+@font-face{font-family:'Lato';font-style:normal;font-weight:700;font-display:swap;src:url('fonts/lato-700.woff2') format('woff2');}
+/* Serifadas */
+@font-face{font-family:'Literata';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/literata-400.woff2') format('woff2');}
+@font-face{font-family:'Literata';font-style:normal;font-weight:700;font-display:swap;src:url('fonts/literata-700.woff2') format('woff2');}
+@font-face{font-family:'Source Serif 4';font-style:normal;font-weight:400;font-display:swap;src:url('fonts/sourceserif-400.woff2') format('woff2');}
+@font-face{font-family:'Source Serif 4';font-style:normal;font-weight:700;font-display:swap;src:url('fonts/sourceserif-700.woff2') format('woff2');}
+@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');}

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

@@ -0,0 +1,159 @@
+// 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 GameDeclaration } from '../core/contract.js';
+import { type SceneStack } from '../core/scenes.js';
+import { createTts } from '../platform/tts.js';
+import { type AudioSonar, type SonarPlayer } from '../platform/audio-sonar.js';
+import type { AlcanceDoFiltro } from '../render/port.js';
+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';
+/** 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;
+}
+/**
+ * O que este jogo NÃO tem. Declarado, e não deduzido de um getter que devolve null.
+ *
+ * O achado 10 do segundo consumidor é a razão de isto existir como tipo: o quiz precisava se declarar
+ * "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;
+}
+export interface CreateGameOptions {
+    /** Os SETE CAMPOS (core/contract). É o que a pilha de acessibilidade lê, e a única coisa que ela lê. */
+    readonly declaration: GameDeclaration;
+    readonly host: EngineHost;
+    readonly declines?: Declinios;
+    /**
+     * É AGORA hora de navegar menu? A plataforma responde `phase === 'paused'`; um quiz responde `true`.
+     * Ausente = `true`, que é o caso do jogo sem fases — o mais simples, e o que não obriga a inventar uma.
+     */
+    readonly isNavigable?: () => boolean;
+    /**
+     * O MODO `accessibility` do ADR-0044 (item 7): o direcional dirige a barra rápida em vez do personagem.
+     *
+     * Opcionais porque um hospedeiro pode não ter barra nenhuma — sem eles a resposta é "ninguém está nela" e
+     * nada é chamado. O jogo de plataforma os fornece; um quiz sem HUD de a11y, não.
+     */
+    /** O índice "N de M" está ligado? Ausente = sim. Ver `comIndice` em ui/menu-nav. */
+    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. */
+    readonly players?: {
+        ctrl: Record<string, string[]>;
+    }[];
+    /** 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;
+    /**
+     * Os jogadores como a NAVEGAÇÃO SONORA os vê. Ausente, `createGame` DERIVA um do campo 4 do contrato: o
+     * foco diz onde o jogador está, que é tudo o que o sonar precisa saber sobre posição.
+     *
+     * Um jogo com vários jogadores, ou com dispositivo de áudio por jogador, fornece a sua lista. Um jogo de
+     * uma criança só não fornece nada — e ganha sonar assim mesmo, que é o ponto.
+     */
+    readonly sonarPlayers?: () => SonarPlayer[];
+    /** Modo cego ligado? Ausente = não. Vale para todos os jogadores, como no jogo de plataforma. */
+    readonly isBlindMode?: () => boolean;
+    /**
+     * AS PALAVRAS DESTE JOGO (`core/actions`). Sem elas a engine não sabe QUANTAS ações pedir a um transporte,
+     * e a garantia do ADR-0079 §3 não tem como ser medida — foi a lacuna que a issue #112 encontrou: a
+     * aritmética existia, testada, e o `createGame` tinha ZERO ocorrências de qualquer coisa sobre ações.
+     *
+     * Opcional porque um jogo pode não declarar preset ainda; sem ele o aviso de alcance simplesmente não
+     * aparece, que é o comportamento de hoje e não uma regressão.
+     */
+    readonly preset?: ActionPreset;
+    /**
+     * Como se descobre que cada transporte está aqui. Ausente = a engine pergunta ao aparelho.
+     *
+     * Injetável porque «há um controle ligado?» e «isto é uma tela de toque?» são perguntas ao navegador, e um
+     * teste que não as possa responder não consegue exercitar a tela que depende delas.
+     */
+    readonly disponibilidade?: Disponibilidade;
+}
+export interface Engine {
+    readonly declaration: GameDeclaration;
+    readonly tts: ReturnType<typeof createTts>;
+    readonly overlays: SettingsPanelApi;
+    readonly nav: MenuNavApi;
+    readonly keyboard: KeyboardRuntime;
+    /**
+     * APLICA O FILTRO DE VISÃO NO MUNDO QUE ESTE JOGO DECLAROU (ADR-0087).
+     *
+     * ⚠️ Existe porque, sem ela, cada consumidor escrevia a sua — e o `game-15puzzle` escreveu, com o
+     * raciocínio certo e sozinho. O que ela acrescenta é a regra dos MENUS, que um consumidor não tem como
+     * saber: eles vivem por cima da simulação e são o instrumento de sair dela, então se herdaram o filtro por
+     * estarem DENTRO do mundo, ele é desfeito neles. Uma cegueira que apagasse o menu de pausa trancaria a
+     * criança dentro da simulação (#82).
+     */
+    readonly aplicarFiltroDeVisao: (css: string, alcance: AlcanceDoFiltro) => void;
+    /**
+     * A NAVEGAÇÃO SONORA, pronta e ligada à declaração deste jogo (item 19).
+     *
+     * Ela vem de graça porque o sonar deixou de precisar de tiles: pergunta topologia (campo 1), alvos (campo
+     * 5) e nome (campo 3), e o jogo já declarou os três para existir. Era o achado 9 do segundo consumidor —
+     * "ligá-lo exigiria MENTIR para a engine" —, e a mentira era exigida pela FORMA da pergunta, não pelo som.
+     */
+    readonly sonar: AudioSonar;
+    /**
+     * A PILHA DE CENAS (item 22, C3 do ADR-0030), vazia e pronta.
+     *
+     * Vem de `createGame` e não de cada jogo pelo mesmo motivo do sonar: é infraestrutura, e um jogo que a
+     * montasse sozinho montaria a décima quinta versão de push/pop. O que ela substitui é o
+     * `phase: 'title' | 'playing' | 'paused'` — um enum DESTE jogo que doze módulos leem, e que um jogo com
+     * mapa de fases ou tela de resultados não teria como estender sem pedir constante nova à engine (o ADR-0030
+     * registra alargar a união como NÃO-opção, e é essa a razão).
+     *
+     * Nasce VAZIA: quem empilha é o jogo, porque quais são as cenas é a única parte disto que é dele.
+     */
+    readonly cenas: SceneStack;
+    /** Quantos filtros de daltonismo foram montados. `0` = não havia host, e o menu visual perde metade. */
+    readonly cvdFilters: number;
+    /** O que FALTOU no documento do consumidor. Vazia = o hospedeiro cumpriu o contrato de marcação. */
+    readonly problems: readonly string[];
+    /** O que este jogo declarou não ter. Devolvido para poder ser auditado — declinar fica no registro. */
+    readonly declines: Declinios;
+    /**
+     * O ANÚNCIO DE QUE O LAÇO PAROU, pronto para entrar em `startLoop(ticker, quadro, maxDt, { aoFalhar })`.
+     *
+     * ⚠️ O ADR-0054 diz por escrito que fica *"só metade verdadeiro"* enquanto isto não existir, e a metade que
+     * faltava é a que importa: **criança cega não vê tela congelada.** Sem anúncio, o modo cego não distingue
+     * «travou» de «está pensando», e o silêncio é a mesma coisa nos dois casos.
+     *
+     * ⚠️ VEM DA ENGINE E NÃO DE CADA JOGO porque a mensagem é a mesma em todos e o canal (leitor de tela +
+     * narração + o que se VÊ) é infraestrutura. Mas quem chama `startLoop` é o JOGO — ele é o dono do ticker —,
+     * então isto é entregue e não instalado: um jogo que monte o laço sem passar isto continua a PARAR, porque
+     * parar não é opcional; o que ele perde é dizer que parou.
+     */
+    readonly aoFalhar: (erro: unknown) => void;
+    /**
+     * O ALCANCE MEDIDO NO ARRANQUE — a garantia do ADR-0079 §3 como dado, para quem quiser lê-la.
+     *
+     * A engine já mostrou o aviso se havia o que dizer; isto fica devolvido porque um jogo pode querer decidir
+     * mais (esconder uma fase que exige doze ações, por exemplo), e porque `ok: false` é o tipo de facto que
+     * tem de poder ser auditado em vez de ficar só numa tela que já fechou.
+     */
+    readonly alcance: Alcance;
+}
+/**
+ * Liga a engine para um jogo declarado.
+ *
+ * ⚠️ LANÇA se a declaração for malformada, e NÃO lança se faltar marcação. A diferença não é gosto: uma
+ * declaração errada é defeito de PROGRAMA, e um jogo que roda meio declarado é pior do que um que não abre;
+ * um id ausente é lacuna do HOSPEDEIRO, e o quiz provou que ligar só a parte que serve é legítimo — foi
+ * assim que ele recusou o pad e o sonar sem mentir. Por isso um vira exceção e o outro vira `problems`.
+ */
+export declare function createGame(o: CreateGameOptions): Engine;

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

@@ -0,0 +1,266 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// boot/create-game — O TESTE DE FRONTEIRA DO ADR-0027 (passo 4), escrito em vez de discutido.
+//
+// ========================= A PERGUNTA QUE ESTE ARQUIVO EXISTE PARA RESPONDER =========================
+// O ADR-0027 pôs um veredito e não o deixou vago:
+//
+//     "se `createGame()` não puder ser escrito sem um parâmetro chamado `coinTarget`, a fronteira que este
+//      registro propõe está errada e os passos 5 a 7 NÃO PODEM COMEÇAR."
+//
+// Pode. Não há `coinTarget` aqui, e não é por disciplina — é porque o ADR-0030 resolveu de onde o alvo vem:
+// campo 5 do contrato (`objectiveOf`). O HUD que pedia um número de moedas passa a perguntar ao jogo quantas
+// de quantas, e "moeda" deixa de ser palavra da engine. `tests/boot-create-game.node.test.js` prende isso.
+//
+// ========================= O QUE ISTO É: A ORDEM, E O QUE FALTA =========================
+// Não é um framework. É a sequência de ligar a engine, que hoje cada consumidor reescreve à mão — e o segundo
+// consumidor mediu o preço de reescrevê-la (`consumer-quiz`, achados 3, 6 e 12):
+//
+//  · ACHADO 3 — `initAudioMixer()` TEM de rodar antes de `createTts`, senão `audioCat` é null e o `narrate`
+//    desiste CALADO. Uma dependência de ordem que nenhum tipo declara e que se descobre pelo silêncio. Aqui
+//    ela é impossível de errar: quem chama não escolhe a ordem.
+//  · ACHADO 6 — os painéis exigem ids fixos no documento (`#typo`, `#typo-list`…) e, quando faltam, ABREM
+//    VAZIOS. Sem erro. Aqui a falta vira `problems`, que é uma lista que o consumidor pode ler e mostrar.
+//  · ACHADO 12 — todo consumidor escreve o mesmo adaptador de uma linha para o `window`. Escrito uma vez.
+//
+// E um achado NOVO, que só apareceu quando esta função tentou bootar contra um documento injetado:
+//
+//  · ACHADO 15 — `initI18n()` chamava `applyDom(document)`, o GLOBAL, por baixo de quem a chamasse. Num
+//    navegador dá no mesmo e por isso sobreviveu; num teste de lógica pura é a diferença entre bootar e não
+//    bootar, e num futuro com dois documentos (uma engine em iframe, um editor ao lado do jogo) seria a
+//    diferença entre traduzir o documento certo e o outro. Consertado no mesmo passo: `initI18n(root)`, com
+//    o global como padrão, exatamente como `applyDom` já fazia.
+//
+// ========================= DECLINAR NÃO É MENTIR =========================
+// O quiz recusou o sonar e o pad em vez de inventar tiles e uma caixa de colisão falsos, e essa distinção é o
+// que separa um achado de um verde falso. Aqui ela vira TIPO: um jogo sem menu de pausa declara
+// `semMenuDePausa: true` em vez de devolver `null` de um getter e torcer. O que se declina fica registrado no
+// objeto devolvido, e um consumidor pode ser auditado pelo que recusou.
+//
+// ========================= O QUE ISTO AINDA NÃO FAZ, DITO AQUI E NÃO ESCONDIDO =========================
+// Não liga render, física, tiles nem o sonar — nada disso é de todo jogo, e o achado 9 mostra que o sonar hoje
+// 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 { 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 { t } from '../core/i18n.js';
+import { srSay, srAlert } from '../core/a11y-sr.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 { createAudioSonar } from '../platform/audio-sonar.js';
+import { VIZ_BY_KEY } from '../render/viz-modes.js';
+import { OVERLAY_SCOPE_SELECTOR } from '../ui/settings-panel.js';
+import { LOGICAL_W } from '../core/constants.js';
+import { initSettingsPanel } from '../ui/settings-panel.js';
+import { initMenuNav } from '../ui/menu-nav.js';
+import { initKeyboardRuntime } from '../input/keyboard-runtime.js';
+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'];
+/**
+ * Liga a engine para um jogo declarado.
+ *
+ * ⚠️ LANÇA se a declaração for malformada, e NÃO lança se faltar marcação. A diferença não é gosto: uma
+ * declaração errada é defeito de PROGRAMA, e um jogo que roda meio declarado é pior do que um que não abre;
+ * um id ausente é lacuna do HOSPEDEIRO, e o quiz provou que ligar só a parte que serve é legítimo — foi
+ * assim que ele recusou o pad e o sonar sem mentir. Por isso um vira exceção e o outro vira `problems`.
+ */
+export function createGame(o) {
+    const problemasDoContrato = conformanceProblems(o.declaration);
+    if (problemasDoContrato.length) {
+        throw new Error('createGame: declaração malformada — ' + problemasDoContrato.join('; '));
+    }
+    const { doc, win } = o.host;
+    const declines = o.declines ?? {};
+    const problems = [];
+    const $ = (sel) => doc.querySelector(sel);
+    const $$ = (sel) => [...doc.querySelectorAll(sel)];
+    for (const sel of MARCACAO_EXIGIDA) {
+        if (!$(sel))
+            problems.push(`marcação ausente: ${sel}`);
+    }
+    // ⚠️ O MUNDO DECLARADO TEM DE EXISTIR NO DOCUMENTO, e esta é a falha que o ADR-0087 deixaria aberta se
+    // parasse na conformidade. `conformanceProblems` confere a FORMA — que há um seletor e que ele não está
+    // vazio — e não tem como conferir se ele CASA alguma coisa, porque `core/contract` é puro e não vê DOM.
+    //
+    // Um seletor com erro de digitação (`#gaem-region`) passa na conformidade e produz exatamente o defeito
+    // que o registro existe para eliminar: a simulação de empatia aplicada a NADA, e um adulto informado de
+    // que sentiu algo que não sentiu. É um problema do HOSPEDEIRO e não do programa, então entra em
+    // `problems` como as marcações — o jogo abre, e quem o integrou lê que o mundo dele não está lá.
+    const mundo = o.declaration.world();
+    if (mundo.kind === 'element' && !$(mundo.selector)) {
+        problems.push(`mundo declarado não encontrado: ${mundo.selector}`);
+    }
+    // 1. IDIOMA ANTES DE TUDO. A interface não pode ser construída antes de a língua ser conhecida — foi o que
+    //    o item 14 consertou movendo `initI18n()` para o topo do boot. O documento entra: ver o achado 15.
+    initI18n(doc);
+    // 2. MIXER ANTES DA VOZ. O achado 3, virado sequência: quem chama não tem como inverter estas duas linhas.
+    initAudioMixer();
+    const tts = createTts({
+        srSay, srAlert, ensureAC, catNode, audioOut,
+        getSoundOn: () => soundOn, getVolume: () => volume, getAudioCat: () => audioCat,
+    });
+    /**
+     * O FILTRO DE VISÃO, aplicado ao MUNDO QUE O JOGO DECLAROU (ADR-0087).
+     *
+     * ⚠️ E A REGRA DOS MENUS É UMA GENERALIZAÇÃO, não uma segunda regra. O jogo próprio da engine limpava o
+     * filtro em `#dom-layer` porque ele está DENTRO de `#game-region` e um filtro CSS herda — sem isso, uma
+     * simulação de cegueira apagaria o menu de pausa e trancaria a criança dentro dela (#82). O 15-puzzle não
+     * tem nada dentro, e a mesma linha não faz nada. Um só código serve às duas formas porque ele pergunta ao
+     * DOM em vez de assumir a forma: limpa o filtro nos overlays que ESTEJAM dentro do mundo.
+     *
+     * ⚠️ `{kind:'none'}` NÃO APLICA NADA. Uma atividade sem espaço não tem mundo para simular, e pintar um
+     * filtro sobre ela seria a mentira que o ADR-0087 existe para impedir, só que ao contrário.
+     */
+    function aplicarFiltroDeVisao(css, alcance) {
+        const mundo = o.declaration.world();
+        if (mundo.kind !== 'element')
+            return;
+        const el = $(mundo.selector);
+        if (!el)
+            return; // já reportado em `problems`; não se inventa superfície
+        el.style.filter = css;
+        if (alcance === 'mundo') {
+            // Os menus vivem POR CIMA da simulação e são o instrumento de sair dela: se herdaram o filtro por
+            // estarem dentro do mundo, desfaz-se neles.
+            for (const ov of $$(OVERLAY_SCOPE_SELECTOR)) {
+                if (el.contains(ov))
+                    ov.style.filter = '';
+            }
+        }
+    }
+    // 3. A pilha de diálogos. O ctx é o mesmo em qualquer jogo — é boilerplate, e boilerplate repetido é onde
+    //    consumidores divergem sem querer.
+    const overlays = initSettingsPanel({
+        $, $$, doc,
+        computedZ: (el) => +win.getComputedStyle(el).zIndex || 0,
+    });
+    // 4. Daltonismo: a engine ENTREGA o markup em vez de exigir que o consumidor o adivinhe (achado 7).
+    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');
+    // 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),
+        tonePan, srSay, narrate: (texto) => tts.narrate(texto),
+        VIZ_BY_KEY, getModoCego: o.isBlindMode ?? (() => false), 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' }] : [];
+        }),
+        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: {} }];
+    const keyboard = initKeyboardRuntime({
+        getKB: () => kb, getNumPlayers: () => players.length, getPlayers: () => players,
+    });
+    keyboard.assignControls();
+    // 6. Navegação de menu. Os três declínios entram como AUSÊNCIA DECLARADA, não como getter que devolve null.
+    const nav = initMenuNav({
+        $, getActiveElement: () => doc.activeElement,
+        topVisibleOverlay: overlays.topVisibleOverlay, closeById: overlays.closeById,
+        getPauseMenu: declines.semMenuDePausa ? () => null : (i) => $(`#vp-pause-${i}`),
+        setPhase: o.setPhase ?? (() => { }),
+        setPauseActor: () => { },
+        srSay,
+        // Sem opinião declarada, o índice fica LIGADO: quem precisa dele para se orientar não tem como saber
+        // 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 ?? (() => { }),
+        isCapturing: () => false,
+        closePadWiz: () => { },
+        whichPlayer: (code) => keyboard.whichPlayer(code),
+        actionOf: (code, i) => keyboard.actionOf(code, i),
+        // Achado 12, RESOLVIDO NA ENGINE: o ctx tipava `win` com `fn: (e: never) => void`, o `window` real não
+        // casava, e cada consumidor escrevia o mesmo adaptador de uma linha. A porta agora é genérica sobre
+        // `WindowEventMap` (ver `EventTargetLike` em input/touch-bindings), então o `window` entra direto.
+        win,
+    });
+    // ⚠️ E AGORA LIGA. A `nav` era montada aqui e ficava desligada — `MenuNavApi.attach()` existia, `menu-nav.ts`
+    // descrevia-a como estando ali "para o game.js instalar exatamente como antes", e `createGame` nunca a
+    // chamava. O efeito num jogo que arranque pela engine: os diálogos de acessibilidade e o menu de pausa
+    // respondem só ao RATO, o que é o pilar 2 a falhar por inteiro — e o `consumer-quiz` teve de a chamar à mão
+    // depois do `createGame`, que é o sintoma da fronteira estar no lugar errado.
+    //
+    // Um fio que a engine MONTA e não liga é pior do que um que ela não monta: a ausência seria visível — o
+    // objeto tem uma `nav`, e ela parece pronta.
+    //
+    // Instalar aqui é seguro antes de o jogo acabar de arrancar: sem diálogo aberto e sem menu de pausa,
+    // `menuNavKey` não consome tecla nenhuma e a deixa seguir para quem for o dono.
+    nav.attach();
+    // ⚠️ E A ARMADILHA DE FOCO, que não existia em lado nenhum — os outros dois fios eram montados e deixados
+    // desligados; este nunca tinha sido escrito. Com um overlay aberto, o Tab entrava no tabuleiro por baixo,
+    // enquanto todo `.overlay__card` do documento diz `aria-modal="true"`. Uma promessa que o teclado desmente
+    // é pior do que promessa nenhuma: quem usa leitor de tela sai para um jogo cujo estado não percebe.
+    initFocusTrap({
+        overlayDeCima: overlays.topVisibleOverlay,
+        focoAtual: () => doc.activeElement,
+        focaveisDe: focaveisNoDom,
+        win,
+    }).attach();
+    /**
+     * O ALCANCE: entre os transportes DISPONÍVEIS a esta criança, algum carrega as ações deste jogo?
+     *
+     * ⚠️ A detecção segue o que o projeto JÁ usa para a mesma pergunta (`isCoarsePointer` em `game/session`):
+     * `pointer:coarse && hover:none` é toque, e o contrário é teclado. Ela erra num tablet COM teclado — e o
+     * erro só é tolerável porque a tela INFORMA em vez de recusar. Ver o cabeçalho de `ui/reach-notice`.
+     */
+    const disponibilidade = o.disponibilidade ?? {
+        gamepad: () => { try {
+            return [...(win.navigator?.getGamepads?.() ?? [])].some(Boolean);
+        }
+        catch {
+            return false;
+        } },
+        toque: () => { try {
+            return win.matchMedia('(pointer:coarse)').matches && win.matchMedia('(hover:none)').matches;
+        }
+        catch {
+            return false;
+        } },
+        teclado: () => { try {
+            return !(win.matchMedia('(pointer:coarse)').matches && win.matchMedia('(hover:none)').matches);
+        }
+        catch {
+            return true;
+        } },
+    };
+    const acoesDoJogo = o.preset ? presetActions(o.preset) : [];
+    const alcanceAqui = alcance(transportesPadrao(disponibilidade), acoesDoJogo);
+    // ⚠️ 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) {
+        mostrarAvisoDeAlcance({
+            procurar: (sel) => $(sel),
+            criar: (tag) => doc.createElement(tag),
+            t,
+            srAlert,
+        }, alcanceAqui);
+    }
+    // O ANÚNCIO DE QUE O LAÇO PAROU (ADR-0054). Entregue e não instalado: quem chama `startLoop` é o JOGO, que
+    // é o dono do ticker. Um jogo que monte o laço sem passar isto continua a PARAR — parar não é opcional; o
+    // que ele perde é dizer que parou.
+    const aoFalhar = criarAvisoDeQueda({
+        procurar: (sel) => $(sel),
+        narrar: (texto) => tts.narrate(texto),
+    });
+    return { declaration: o.declaration, tts, overlays, nav, keyboard, sonar, aplicarFiltroDeVisao, cenas: criarPilha(), cvdFilters, problems, declines, aoFalhar, alcance: alcanceAqui };
+}

package/dist-pkg/core/a11y-sr.d.ts

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+export declare function setVlibrasSay(fn: (text: string) => void): void;
+export declare const srSay: (t: string) => void;
+export declare const srAlert: (t: string) => void;