@the-inclusionist/engine 6.36.1 → 7.0.0

package/app/css/style.css

@@ -51,6 +51,7 @@
   --z-menu:30000;
   --z-menu-max:39999;
   --z-transition:40000;
+  --z-loop-crash:45000;
   --z-debug:90000;
 }
 /* Emoji: usa o Noto Color Emoji do sistema (Chromebook/Android/Linux) e, se ausente, o woff2 embutido
@@ -379,9 +380,13 @@ main{flex:1;display:flex;flex-direction:column;width:100%;margin:0 auto;padding:
    ⚠️ E AS CORES SÃO CRUAS, DE PROPÓSITO: nada de `var(--…)`. Este aviso aparece justamente quando alguma
    coisa quebrou, e a máquina de temas é candidata plausível. Branco sobre vinho dá 9,5:1, acima do 7:1 do
    1.4.6, e não depende de nada ter sobrevivido. */
-.game-region[data-incl-parou]::after{
-  content:attr(data-incl-parou);
-  position:absolute;inset:auto 0 0 0;z-index:60;
+/* ⚠️ ERA UM `::after` COM `content: attr(...)`, E NUNCA APARECERIA. Medido no arranque real: o
+   `.game-region.crt-scan-1::after` logo abaixo é a scanline do CRT, ligada por padrão — e um elemento tem UM
+   `::after` só. As duas regras não se empilham; a do CRT vem depois e vence. O `::before` está tomado pela
+   vinheta. Agora é um ELEMENTO, que não disputa lugar com ninguém — e cujo texto entra na árvore de
+   acessibilidade, coisa que `content` não garante. `z-index` acima do 500 da scanline, de propósito. */
+#incl-parou{
+  position:absolute;inset:auto 0 0 0;z-index:var(--z-loop-crash);
   padding:14px 18px;
   background:#7f1d1d;color:#fff;border-top:3px solid #fff;
   font:700 15px/1.35 system-ui,-apple-system,"Segoe UI",sans-serif;

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

@@ -3,7 +3,7 @@ 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 { createTts, type CarregarVozNeural } 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';
@@ -76,6 +76,21 @@ export interface CreateGameOptions {
      * aparece, que é o comportamento de hoje e não uma regressão.
      */
     readonly preset?: ActionPreset;
+    /**
+     * COMO SE CARREGA A VOZ NEURAL — uma linha do lado do jogo (ADR-0094):
+     *
+     *     carregarVozNeural: () => import('@mintplex-labs/piper-tts-web')
+     *
+     * ⚠️ AUSENTE POR OMISSÃO, E ISSO É A DECISÃO E NÃO UM DESCUIDO. A engine não pode nomear o fornecedor:
+     * ele traz `onnxruntime-web` como peer NÃO-opcional, que o npm instala sozinho — **135,4 MB** no
+     * `node_modules` de todo consumidor, incluindo um jogo que nunca fale por voz neural. E declará-lo em
+     * `devDependencies`, que era o estado até 06/09, publicou uma engine que NÃO COMPILAVA para ninguém
+     * (ADR-0093). A porta é a única forma que resolve as duas coisas ao mesmo tempo.
+     *
+     * Sem ela a narração cai na voz do navegador (Web Speech), que fala o idioma certo e não pesa nada — e o
+     * painel de áudio deixa de OFERECER o motor neural, em vez de o oferecer e nunca o carregar.
+     */
+    readonly carregarVozNeural?: CarregarVozNeural;
     /**
      * Como se descobre que cada transporte está aqui. Ausente = a engine pergunta ao aparelho.
      *

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

@@ -106,6 +106,7 @@ export function createGame(o) {
     const tts = createTts({
         srSay, srAlert, ensureAC, catNode, audioOut,
         getSoundOn: () => soundOn, getVolume: () => volume, getAudioCat: () => audioCat,
+        carregarVozNeural: o.carregarVozNeural,
     });
     /**
      * O FILTRO DE VISÃO, aplicado ao MUNDO QUE O JOGO DECLAROU (ADR-0087).
@@ -260,6 +261,7 @@ export function createGame(o) {
     // que ele perde é dizer que parou.
     const aoFalhar = criarAvisoDeQueda({
         procurar: (sel) => $(sel),
+        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 };

package/dist-pkg/core/layers.d.ts

@@ -32,6 +32,12 @@ export declare const Z: {
     readonly MENU: 30000;
     readonly MENU_MAX: 39999;
     readonly TRANSITION: 40000;
+    /**
+     * O LAÇO MORREU (ADR-0054). Acima do `TRANSITION` de propósito: quando o quadro lança, o que estiver na
+     * tela — menu aberto, fade a meio, mensagem de fase — está congelado e deixou de importar. O aviso tem de
+     * ser visto por cima de tudo isso, e só o painel de desenvolvimento fica acima dele.
+     */
+    readonly LOOP_CRASH: 45000;
     readonly DEBUG: 90000;
 };
 export type LayerName = keyof typeof Z;

package/dist-pkg/core/layers.js

@@ -49,6 +49,12 @@ export const Z = {
     MENU: 30000, // menus — RANGE reservado 30000–39999 (níveis aninhados: +1000 por nível)
     MENU_MAX: 39999,
     TRANSITION: 40000, // fade/wipe de troca de fase (cobre tudo)
+    /**
+     * O LAÇO MORREU (ADR-0054). Acima do `TRANSITION` de propósito: quando o quadro lança, o que estiver na
+     * tela — menu aberto, fade a meio, mensagem de fase — está congelado e deixou de importar. O aviso tem de
+     * ser visto por cima de tudo isso, e só o painel de desenvolvimento fica acima dele.
+     */
+    LOOP_CRASH: 45000,
     DEBUG: 90000, // painel ?debug / FPS / hitboxes (dev; topo absoluto)
 };
 // Cadeia de PÓS-PROCESSO — passes sobre o frame COMPOSTO, do interno p/ o externo. NÃO são camadas Z.

package/dist-pkg/i18n/en.js

@@ -259,6 +259,7 @@ const en = {
     'audio.noSystemVoices': '(no system voices)',
     'sr.tts.engineNoLanguage': 'This engine does not speak this language yet — for now, use Piper (neural) or the browser voice.',
     'sr.tts.noNeuralForLanguage': 'There is no neural voice for this language yet — carrying on with the browser voice, which speaks it.',
+    'sr.tts.neuralNotBundled': 'This build of the game ships no neural voice — carrying on with the browser voice.',
     'sr.tts.downloading': 'Downloading the neural voice (needs the internet on the first use only)…',
     'sr.tts.progress': 'Neural voice: {pct}%.',
     'sr.tts.ready': 'Neural voice ready, in {s} seconds.',

package/dist-pkg/i18n/es.js

@@ -259,6 +259,7 @@ const es = {
     'audio.noSystemVoices': '(sin voces del sistema)',
     'sr.tts.engineNoLanguage': 'Este motor todavía no habla este idioma — por ahora, usa Piper (neuronal) o la voz del navegador.',
     'sr.tts.noNeuralForLanguage': 'Todavía no hay voz neuronal para este idioma — seguimos con la voz del navegador, que sí lo habla.',
+    'sr.tts.neuralNotBundled': 'Esta versión del juego no trae voz neuronal — seguimos con la voz del navegador.',
     'sr.tts.downloading': 'Descargando la voz neuronal (necesita internet solo en el 1.er uso)…',
     'sr.tts.progress': 'Voz neuronal: {pct} %.',
     'sr.tts.ready': 'Voz neuronal lista, en {s} segundos.',

package/dist-pkg/i18n/pt.js

@@ -331,6 +331,9 @@ const pt = {
     'audio.noSystemVoices': '(sem vozes do sistema)',
     'sr.tts.engineNoLanguage': 'Este motor ainda não fala este idioma — por enquanto, use Piper (neural) ou a voz do navegador.',
     'sr.tts.noNeuralForLanguage': 'Ainda não há voz neural para este idioma — seguindo com a voz do navegador, que fala a língua certa.',
+    // ⚠️ NÃO diz «para este idioma» (ADR-0094): sem motor neural nesta montagem, não há voz neural em idioma
+    // nenhum, e a outra frase faria a criança trocar de idioma à procura do que não está lá.
+    'sr.tts.neuralNotBundled': 'Esta versão do jogo não traz voz neural — seguindo com a voz do navegador.',
     'sr.tts.downloading': 'Baixando a voz neural (precisa de internet só no 1º uso)…',
     'sr.tts.progress': 'Voz neural: {pct}%.',
     'sr.tts.ready': 'Voz neural pronta, em {s} segundos.',

package/dist-pkg/platform/tts.d.ts

@@ -3,6 +3,30 @@ interface TtsEngine {
     id: string;
     speak: (text: string) => void;
 }
+/**
+ * O QUE A ENGINE PRECISA DE UM MOTOR NEURAL — e nada mais. Duas chamadas, escritas aqui em vez de importadas
+ * do fornecedor, porque importar o TIPO obrigaria o pacote a estar instalado para o `tsc` do consumidor
+ * correr: seria o mesmo defeito do ADR-0093 mudado de campo, do `dependencies` para o espaço de tipos.
+ */
+export interface SessaoNeural {
+    predict: (texto: string) => Promise<{
+        arrayBuffer: () => Promise<ArrayBuffer>;
+    }>;
+}
+export interface ModuloNeural {
+    TtsSession: {
+        create: (o: {
+            voiceId: string;
+            progress?: (p: {
+                loaded: number;
+                total: number;
+            }) => void;
+            logger?: (...a: unknown[]) => void;
+        }) => Promise<SessaoNeural>;
+    };
+}
+/** A PORTA (ADR-0094). Uma linha do lado do jogo: `() => import('@mintplex-labs/piper-tts-web')`. */
+export type CarregarVozNeural = () => Promise<ModuloNeural>;
 export interface TtsCtx {
     srSay: (t: string) => void;
     srAlert: (t: string) => void;
@@ -14,6 +38,17 @@ export interface TtsCtx {
     getAudioCat: () => Record<string, {
         on: boolean;
     }> | null;
+    /**
+     * COMO SE CARREGA O MOTOR NEURAL — fornecido pelo JOGO, ausente por omissão (ADR-0094).
+     *
+     * ⚠️ A engine NÃO NOMEIA O FORNECEDOR, e o motivo é medido: o `@mintplex-labs/piper-tts-web` traz
+     * `onnxruntime-web` como peer NÃO-opcional, que o npm instala sozinho — **135,4 MB** no `node_modules` de
+     * todo consumidor, incluindo um que nunca fale por voz neural. Nomeá-lo aqui obrigaria os 135 MB, e
+     * declará-lo em `devDependencies` (como estava até 06/09) publica um pacote que não compila.
+     *
+     * Ausente = a narração cai na voz do navegador (Web Speech), que fala o idioma certo e não pesa nada.
+     */
+    carregarVozNeural?: CarregarVozNeural;
 }
 export interface Tts {
     narrate: (text: string) => void;
@@ -28,6 +63,12 @@ export interface Tts {
     readonly loading: boolean;
     readonly failed: boolean;
     readonly narrateCount: number;
+    /**
+     * ESTA MONTAGEM TEM MOTOR NEURAL? (ADR-0094) O painel de áudio pergunta antes de o oferecer: uma opção
+     * que não pode funcionar é pior que uma opção a menos — quem a escolhe fica à espera de um download que
+     * nunca começa, e quem navega por escuta não tem como ver que não começou.
+     */
+    readonly neuralDisponivel: boolean;
 }
 export declare function createTts(ctx: TtsCtx): Tts;
 export {};

package/dist-pkg/platform/tts.js

@@ -1,16 +1,20 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
-// platform/tts — narração por voz. Motor NEURAL Piper pt-BR carregado LAZY (import de CDN + cache OPFS → a 2ª sessão fala
-// offline), com FALLBACK imediato p/ a voz nativa do navegador (Web Speech) enquanto o neural não chega. narrate() é o
+// platform/tts — narração por voz. Motor NEURAL pt-BR carregado LAZY pela PORTA que o jogo fornece (ADR-0094; modelo
+// em cache OPFS → a 2ª sessão fala offline), com FALLBACK imediato p/ a voz nativa do navegador (Web Speech) — que é
+// também o que se ouve quando não há porta nenhuma, e é por isso que a ausência dela não cala nada. narrate() é o
 // ponto de entrada, gated pelo toggle 'Narração (TTS)' do mixer (audioCat.tts.on) — independe das legendas. As funções de
 // PAINEL (populateTTSEngines/Voices/reflectTTS) ficam no game.js (→ ui/settings-audio, #38→#54) e usam get/setEngineSel +
 // get/setVoiceObj daqui. Injeção por closure. Ver docs/plano-tts-fase-f5.md + docs/5-Refactoring/plano-modularizacao-mapa.md.
 import * as store from './storage.js';
 import { t, bcp47 } from '../core/i18n.js';
 import { criarFalaInterrompivel } from './interruptible-speech.js';
-// ⚠️ MIGRAÇÃO PENDENTE (ADR-0022): esta implementação com @mintplex-labs/piper-tts-web será SUBSTITUÍDA por
-// sherpa-onnx-wasm (loader universal, modelos VITS/Piper + Kokoro-multi-lang carregados de qq URL R2 em runtime via
+// ⚠️ MIGRAÇÃO PENDENTE (ADR-0022): a implementação neural de hoje é o @mintplex-labs/piper-tts-web e será SUBSTITUÍDA
+// por sherpa-onnx-wasm (loader universal, modelos VITS/Piper + Kokoro-multi-lang carregados de qq URL R2 em runtime via
 // FS.writeFile; lazy-fetch; eSpeak/Web Speech de fallback). @mintplex-labs foi descontinuado e só carrega 2 vozes pt-BR.
-// Enquanto a migração não vem: a lib vem do npm (code-split pelo Vite no 1º uso), modelo do HF em cache OPFS. (#69→#38)
+// ⚠️ E DESDE O ADR-0094 ESTE MÓDULO NÃO NOMEIA FORNECEDOR NENHUM — quem o nomeia é o JOGO, por `ctx.carregarVozNeural`.
+// O nome estava aqui num `import()` e o pacote em `devDependencies`, o que publicou uma engine que não compilava
+// (ADR-0093); pô-lo em `dependencies` consertava o build e obrigava todo consumidor a 135,4 MB de `onnxruntime-web`,
+// que o fornecedor traz como peer não-opcional. A porta é o que faz a troca do ADR-0022 não ser um segundo abalo.
 /**
  * Voz NEURAL por idioma, indexada pela etiqueta BCP-47 de core/i18n. Só o pt-BR tem uma hoje, e essa ausência
  * é agora CONSULTÁVEL em vez de presumida: `loadTTS` pergunta à tabela se existe voz para o idioma corrente,
@@ -57,6 +61,15 @@ export function createTts(ctx) {
                 ctx.srAlert(t('sr.tts.engineNoLanguage'));
             return;
         }
+        // ESTA MONTAGEM NÃO TRAZ MOTOR NEURAL (ADR-0094). Vem ANTES da pergunta do idioma de propósito: sem
+        // porta, não há voz neural em idioma nenhum, e dizer «não há voz para o teu idioma» faria a criança
+        // pensar que trocar de idioma resolveria. `ttsFailed` para não repetir a pergunta a cada fala.
+        const carregar = ctx.carregarVozNeural;
+        if (!carregar) {
+            ttsFailed = true;
+            ctx.srAlert(t('sr.tts.neuralNotBundled'));
+            return;
+        }
         // O Piper só tem voz para os idiomas em TTS_SOURCES. Sem voz para o idioma corrente, NÃO se baixa a de
         // outro idioma: avisa e segue na voz do navegador, que fala a língua certa.
         const fonte = TTS_SOURCES[bcp47()];
@@ -67,7 +80,7 @@ export function createTts(ctx) {
         ttsLoading = true;
         const t0 = performance.now();
         ctx.srSay(t('sr.tts.downloading'));
-        import('@mintplex-labs/piper-tts-web').then(async (mod) => {
+        carregar().then(async (mod) => {
             const session = await mod.TtsSession.create({ voiceId: fonte.voice,
                 progress: (p) => { if (!p || !p.total)
                     return; const pct = Math.round(p.loaded * 100 / p.total); if (pct >= _ttsPct + 25 && pct < 100) {
@@ -138,5 +151,6 @@ export function createTts(ctx) {
         getEngineSel: () => ttsEngineSel, setEngineSel: (v) => { ttsEngineSel = v; },
         getEngine: () => ttsEngine, getVoiceObj: () => _ttsVoiceObj, setVoiceObj: (v) => { _ttsVoiceObj = v; },
         get loading() { return ttsLoading; }, get failed() { return ttsFailed; }, get narrateCount() { return _narrateCount; },
+        get neuralDisponivel() { return !!ctx.carregarVozNeural; },
     };
 }

package/dist-pkg/ui/loop-crash.d.ts

@@ -1,7 +1,11 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
+/** O id da caixa do aviso. Estável porque a folha de estilo e o teste a procuram. */
+export declare const AVISO_DE_QUEDA_ID = "incl-parou";
 export interface AvisoDeQuedaCtx {
     /** `querySelector` do documento deste jogo. Injetado: a engine recebe o dela, `main.ts` passa o `$` global. */
     procurar: (sel: string) => HTMLElement | null;
+    /** `document.createElement` — a caixa do aviso é um elemento de verdade, não um pseudo-elemento. */
+    criar: (tag: string) => HTMLElement;
     /** A narração falada, quando o jogo tiver uma. Ausente = o aviso escrito basta. */
     narrar?: (texto: string) => void;
 }

package/dist-pkg/ui/loop-crash.js

@@ -24,6 +24,8 @@
 //     segundo jogo na mesma página) perderia o aviso. O anúncio de que tudo parou é o último lugar que
 //     deveria depender de uma busca global.
 import { t } from '../core/i18n.js';
+/** O id da caixa do aviso. Estável porque a folha de estilo e o teste a procuram. */
+export const AVISO_DE_QUEDA_ID = 'incl-parou';
 /**
  * Monta o `aoFalhar` para entrar em `startLoop(ticker, quadro, maxDt, { aoFalhar })`.
  *
@@ -50,11 +52,28 @@ export function criarAvisoDeQueda(ctx) {
             ctx.narrar?.(msg);
         }
         catch { /* noop: a narração falhou; o aviso escrito já saiu */ }
-        // O VISÍVEL. O texto entra no ATRIBUTO e a folha de estilo o mostra com `content: attr(...)` — é o que
-        // mantém a frase LOCALIZADA. Um aviso cravado no CSS estaria em inglês para uma criança brasileira, que
-        // é o defeito que o pilar 3 existe para impedir.
+        // O VISÍVEL, e é um ELEMENTO DE VERDADE — não um pseudo-elemento.
+        //
+        // ⚠️ ERA `::after` COM `content: attr(data-incl-parou)`, E NUNCA TERIA APARECIDO. Medido no arranque real
+        // em 2026-09-06: `.game-region.crt-scan-1::after` é o efeito de scanline do CRT, ligado por padrão, e um
+        // elemento tem UM `::after` só — as duas regras não se empilham, a do CRT vem depois e vence. O
+        // `::before` está igualmente tomado, pela vinheta. O aviso disputava um lugar já ocupado.
+        //
+        // ⚠️ E O PSEUDO-ELEMENTO ERA ERRADO POR UMA SEGUNDA RAZÃO, que a primeira escondia: texto de `content`
+        // não entra de forma confiável na árvore de acessibilidade. O aviso de que o jogo morreu é exatamente o
+        // que não pode depender disso.
+        //
+        // O raciocínio que continua de pé é o da TRADUÇÃO: a frase vem de `t()` e entra por `textContent`, então
+        // ela chega traduzida e escapada. O que muda é o recipiente.
         const regiao = ctx.procurar('#game-region');
-        if (regiao)
-            regiao.setAttribute('data-incl-parou', msg);
+        if (!regiao)
+            return;
+        const anterior = ctx.procurar('#' + AVISO_DE_QUEDA_ID);
+        const caixa = anterior ?? ctx.criar('div');
+        caixa.id = AVISO_DE_QUEDA_ID;
+        caixa.setAttribute('role', 'alert');
+        caixa.textContent = msg;
+        if (!anterior)
+            regiao.appendChild(caixa);
     };
 }

package/dist-pkg/ui/settings-audio.d.ts

@@ -29,6 +29,12 @@ export interface TtsPanel {
     setVoiceObj: (v: SpeechSynthesisVoice | null) => void;
     loadTTS: () => void;
     narrate: (text: string) => void;
+    /**
+     * ESTA MONTAGEM TEM MOTOR NEURAL? (ADR-0094) OPCIONAL, e a ausência vale `true`: um falso de teste
+     * escrito antes deste campo não tem opinião sobre motores neurais, e fazê-lo esconder o Piper mudaria o
+     * que esse teste afirma sem que ninguém tenha escrito a mudança.
+     */
+    neuralDisponivel?: boolean;
 }
 /**
  * Saída de áudio dedicada de um jogador: o id do dispositivo e o AudioContext/ganho que ele abriu.
@@ -104,6 +110,18 @@ export declare function caneDivMessage(div: number): string;
 /** #tts-engine's option catalog: (value, i18n KEY of the label). The engine NAMES are proper nouns and stay
  *  put; what translates is the parenthetical that explains each one. Keys, not text — see input/devices. */
 export declare const TTS_ENGINE_OPTIONS: readonly (readonly [string, string])[];
+/**
+ * Os motores que ESTA MONTAGEM pode de facto oferecer (ADR-0094).
+ *
+ * ⚠️ Desde que o motor neural passou a chegar por PORTA (`ctx.carregarVozNeural`), «o Piper existe» deixou
+ * de ser verdade sobre a engine e passou a ser verdade sobre o JOGO. Oferecer uma opção que não pode
+ * funcionar é pior que uma opção a menos: quem a escolhe fica à espera de um download que nunca começa, e
+ * quem navega por escuta não tem como ver que não começou.
+ *
+ * Só o `piper` é filtrado. `kokoro`/`kitten`/`espeak` também não funcionam hoje — «ainda não entraram» —,
+ * mas isso é anterior a este registro e escondê-los aqui mudaria comportamento que ninguém pediu para mudar.
+ */
+export declare function opcoesDeMotor(neuralDisponivel: boolean): readonly (readonly [string, string])[];
 export interface VoiceLike {
     name: string;
     lang: string;

package/dist-pkg/ui/settings-audio.js

@@ -69,6 +69,20 @@ export const TTS_ENGINE_OPTIONS = [
     ['kitten', 'tts.engine.kitten'],
     ['espeak', 'tts.engine.espeak'],
 ];
+/**
+ * Os motores que ESTA MONTAGEM pode de facto oferecer (ADR-0094).
+ *
+ * ⚠️ Desde que o motor neural passou a chegar por PORTA (`ctx.carregarVozNeural`), «o Piper existe» deixou
+ * de ser verdade sobre a engine e passou a ser verdade sobre o JOGO. Oferecer uma opção que não pode
+ * funcionar é pior que uma opção a menos: quem a escolhe fica à espera de um download que nunca começa, e
+ * quem navega por escuta não tem como ver que não começou.
+ *
+ * Só o `piper` é filtrado. `kokoro`/`kitten`/`espeak` também não funcionam hoje — «ainda não entraram» —,
+ * mas isso é anterior a este registro e escondê-los aqui mudaria comportamento que ninguém pediu para mudar.
+ */
+export function opcoesDeMotor(neuralDisponivel) {
+    return neuralDisponivel ? TTS_ENGINE_OPTIONS : TTS_ENGINE_OPTIONS.filter(([v]) => v !== 'piper');
+}
 /**
  * As vozes do sistema no idioma pedido; sem nenhuma, a lista inteira.
  *
@@ -204,7 +218,7 @@ export function initSettingsAudio(ctx) {
         if (!sel || sel.dataset.filled)
             return;
         sel.dataset.filled = '1';
-        TTS_ENGINE_OPTIONS.forEach(([v, l]) => {
+        opcoesDeMotor(ctx.tts.neuralDisponivel !== false).forEach(([v, l]) => {
             const o = document.createElement('option');
             o.value = v;
             o.textContent = t(l);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-inclusionist/engine",
-  "version": "6.36.1",
+  "version": "7.0.0",
   "type": "module",
   "description": "Accessibility-first (WCAG 2.2 + GAG) engine for educational 2D pixel-art games, built with PixiJS. Screen reader, sonar, high contrast by role, colour-vision filters, remappable input as intent, i18n and offline PWA — the parts every game inherits (ADR-0035, ADR-0036).",
   "comment:exports": [
@@ -23,13 +23,34 @@
     "faces by RELATIVE url, so the folder travels whole or not at all."
   ],
   "exports": {
-    ".": { "types": "./dist-pkg/boot/create-game.d.ts", "default": "./dist-pkg/boot/create-game.js" },
-    "./core/*.js": { "types": "./dist-pkg/core/*.d.ts", "default": "./dist-pkg/core/*.js" },
-    "./input/*.js": { "types": "./dist-pkg/input/*.d.ts", "default": "./dist-pkg/input/*.js" },
-    "./render/*.js": { "types": "./dist-pkg/render/*.d.ts", "default": "./dist-pkg/render/*.js" },
-    "./platform/*.js": { "types": "./dist-pkg/platform/*.d.ts", "default": "./dist-pkg/platform/*.js" },
-    "./ui/*.js": { "types": "./dist-pkg/ui/*.d.ts", "default": "./dist-pkg/ui/*.js" },
-    "./educational/*.js": { "types": "./dist-pkg/educational/*.d.ts", "default": "./dist-pkg/educational/*.js" },
+    ".": {
+      "types": "./dist-pkg/boot/create-game.d.ts",
+      "default": "./dist-pkg/boot/create-game.js"
+    },
+    "./core/*.js": {
+      "types": "./dist-pkg/core/*.d.ts",
+      "default": "./dist-pkg/core/*.js"
+    },
+    "./input/*.js": {
+      "types": "./dist-pkg/input/*.d.ts",
+      "default": "./dist-pkg/input/*.js"
+    },
+    "./render/*.js": {
+      "types": "./dist-pkg/render/*.d.ts",
+      "default": "./dist-pkg/render/*.js"
+    },
+    "./platform/*.js": {
+      "types": "./dist-pkg/platform/*.d.ts",
+      "default": "./dist-pkg/platform/*.js"
+    },
+    "./ui/*.js": {
+      "types": "./dist-pkg/ui/*.d.ts",
+      "default": "./dist-pkg/ui/*.js"
+    },
+    "./educational/*.js": {
+      "types": "./dist-pkg/educational/*.d.ts",
+      "default": "./dist-pkg/educational/*.js"
+    },
     "./style.css": "./app/css/style.css",
     "./assets/*": "./app/public/*",
     "./package.json": "./package.json"
@@ -42,7 +63,9 @@
     "⚠️ E o consumidor que mais depende disto hoje não é o registro: `the-inclusionist/hartwig-zdog-chess`",
     "consome esta engine por `file:../SP-the-inclusionist-tracer`, ou seja, lê ESTA pasta ao vivo."
   ],
-  "sideEffects": ["*.css"],
+  "sideEffects": [
+    "*.css"
+  ],
   "license": "AGPL-3.0-or-later",
   "comment:ownership": [
     "ADR-0071 §2 said the ownership claim does NOT live in the package NAME, and that nothing would enter",
@@ -51,8 +74,13 @@
     "`files`). Patrimonial owner: the Municipio, under Lei no 9.609/1998 art. 4. Publication is a PEDIDO,",
     "not the developer's decision."
   ],
-  "repository": { "type": "git", "url": "git+https://github.com/the-inclusionist/the-inclusionist-engine.git" },
-  "publishConfig": { "access": "public" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/the-inclusionist/the-inclusionist-engine.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "files": [
     "dist-pkg",
     "app/css/style.css",
@@ -62,6 +90,22 @@
     "docs/LICENSES.md",
     "docs/CREDITS.md"
   ],
+  "comment:no-dependencies": [
+    "⚠️ ESTE PACOTE NÃO TEM `dependencies`, E ISSO É UMA DECISÃO MEDIDA (ADR-0094), não um acaso.",
+    "A 6.36.1 saiu com `@mintplex-labs/piper-tts-web` em `devDependencies` enquanto `platform/tts` — código",
+    "EMBARCADO, alcançado por `createGame` — o nomeava num `import()`. O npm não instala devDependencies para",
+    "quem consome, então a versão publicada NÃO COMPILAVA para ninguém (ADR-0093).",
+    "O conserto óbvio era mover para `dependencies`, e ele foi feito e DESFEITO no mesmo dia, por uma medida",
+    "que faltava: o fornecedor traz `onnxruntime-web` como peer NÃO-opcional, que o npm instala sozinho —",
+    "**135,4 MB** no `node_modules` de todo consumidor, incluindo um jogo que nunca fale por voz neural.",
+    "⚠️ `optionalDependencies` NÃO resolveria: o npm as instala por omissão; só tolera a falha da instalação.",
+    "O motor neural passa a chegar por PORTA — `carregarVozNeural` em `CreateGameOptions`, uma linha do lado",
+    "do jogo. `main.ts` (o app DESTE repositório, que fica fora do pacote) é o único ponto da árvore que",
+    "nomeia o fornecedor, e é por isso que ele continua em `devDependencies` aqui.",
+    "O gate que prende as duas direções é `tests/engine-package.node.test.js`: nenhum módulo embarcado pode",
+    "nomear pacote não declarado, e nada declarado pode ficar sem quem o nomeie. É ele que faz a troca por",
+    "sherpa-onnx-wasm (ADR-0022) não reabrir o mesmo buraco em silêncio."
+  ],
   "comment:peerDependencies": [
     "PixiJS is a PEER, not a dependency. Measured on the emitted package (2026-09-05): exactly TWO shipped",
     "modules import it — `render/canvas` and `render/minimap` — plus their two `.d.ts`. A consumer that",