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

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

@@ -12,6 +12,8 @@ import { lqName as lqLabel } from '../render/lq-filter.js';
 import { HC_ROLE_KEYS, HC_ROLE_DEF } from '../render/hc-role-data.js';
 import { VIZ_CORRECTIONS, VIZ_MODES } from '../render/viz-modes.js';
 import { DEFAULTS } from '../core/state.js';
+// O padrao dos DOIS EIXOS (ADR-0076/#104). A marca pergunta ao modelo novo, nao ao espelho p.viz.
+import { PADRAO as PADRAO_VISUAL } from '../render/viz-axes.js';
 import { markChanged, markMenuChanged } from './changed-mark.js';
 /** Contrast levels, in cycle order — mirrors game.js's HC_SEQ (also used there by the physical contrast-cycle button). */
 export const CONTRAST_LEVELS = ['normal', 'hc-direto', 'hc-direto-45', 'hc-direto-7'];
@@ -77,6 +79,21 @@ export function rgbToHex(rgb) {
 export function onOffLabel(on) {
     return toggleLabel(on);
 }
+/**
+ * Lê `player[i].visual` defensivamente, sem importar o tipo do jogador — o mesmo molde do `playerViz` abaixo,
+ * e pela mesma razão: `getPlayers()` devolve `readonly unknown[]` porque o tipo real é do JOGO (ADR-0033), e
+ * cada consumidor estreita para a SUA fatia.
+ *
+ * ⚠️ Sem jogador ou sem o campo, devolve o PADRÃO — que é a resposta certa para «esta criança mexeu em
+ * alguma coisa?»: quem não existe não mexeu. Inventar `hc7` aqui marcaria um menu que ninguém tocou.
+ */
+function playerVisual(list, i) {
+    const v = list[i]?.visual;
+    return {
+        tema: typeof v?.tema === 'string' ? v.tema : PADRAO_VISUAL.tema,
+        correcao: typeof v?.correcao === 'string' ? v.correcao : PADRAO_VISUAL.correcao,
+    };
+}
 /** Reads player[i].viz defensively (no player at that index -> 'normal'), without a Player type import. */
 function playerViz(list, i) {
     const p = list[i];
@@ -144,7 +161,11 @@ export function initSettingsVisual(ctx) {
             ctx.setSelectedPlayer(selected);
         const contrastValue = resolveVisualMode(playerViz(ctx.getPlayers(), selected));
         const settings = ctx.getVisualSettings();
-        ctx.renderVizGroup('#visual-modes', '#visual-players', VISUAL_MODE_LIST);
+        // ⚠️ `renderEixosVisuais` E NÃO `renderVizGroup` desde a #104: este painel passou a ter DOIS controles,
+        // e o `renderVizGroup` continua a servir o painel de EMPATIA, cuja lista de simulações é mesmo exclusiva.
+        // Trocar o corpo daquela função em vez de acrescentar esta teria posto os dois eixos na lista de
+        // simulações — foi o que quase aconteceu, e o que a separação impede.
+        ctx.renderEixosVisuais('#visual-modes', '#visual-players');
         el.innerHTML = renderVisualPanelHtml(contrastValue, settings);
         const lq = ctx.$('#opt-lq');
         const lqv = ctx.$('#opt-lq-val');
@@ -182,6 +203,8 @@ export function initSettingsVisual(ctx) {
             rr.addEventListener('click', () => { ctx.resetRoleColors(); render(); });
         reflectOutlines();
         refreshMarks();
+        // A prosa volta para o rodapé depois de as linhas serem reconstruídas (CLAUDE.md §4, #109).
+        ctx.fillExplain?.(ctx.$('#visual .overlay__card'));
     }
     /**
      * A marca de "saiu do padrão" (ADR-0029). Cada linha contra o SEU padrão, e o botão do menu por cima.
@@ -193,7 +216,27 @@ export function initSettingsVisual(ctx) {
      */
     function refreshMarks() {
         const s = ctx.getVisualSettings();
-        const contraste = resolveVisualMode(playerViz(ctx.getPlayers(), ctx.getSelectedPlayer())) !== 'normal';
+        /**
+         * 🔴 A MARCA É POR EIXO DESDE 2026-09-08, e a granularidade que ela recupera foi perdida por mim na #104
+         * etapa 4d. Enquanto o `#visual-modes` era UM rádio de sete opções, marcar o contentor era marcar a
+         * escolha. A etapa 4d pôs DOIS eixos lá dentro, e uma marca no contentor deixou de dizer QUAL saiu do
+         * padrão — que é o terceiro canal do ADR-0029 a perder informação: «a criança cega percorre o menu e OUVE,
+         * em ordem, o que saiu do padrão». Ouvir «mudado» sem saber de quê manda-a procurar em oito linhas.
+         *
+         * ⚠️ E VEM DO MODELO NOVO. Isto era `resolveVisualMode(playerViz(...))`, que lê o `p.viz` que a etapa 1a
+         * marcou `@deprecated` — um leitor que ficou para trás na migração.
+         *
+         * 📌 E A REGRA DA SIMULAÇÃO DEIXA DE SER DERIVADA E PASSA A SER ESTRUTURAL, que é o ganho de fundo. Ela
+         * está escrita logo acima: uma simulação de empatia não marca ESTE menu, porque a marca dela pertence ao
+         * menu de empatia e é lá que ela leva a criança. Antes isso dependia de o `resolveVisualMode` responder
+         * `normal`; agora a simulação vive noutro campo do `VisualState`, e perguntar pelo tema e pela correcção
+         * nunca a alcança.
+         */
+        const visual = playerVisual(ctx.getPlayers(), ctx.getSelectedPlayer());
+        const tema = visual.tema !== PADRAO_VISUAL.tema;
+        const correcao = visual.correcao !== PADRAO_VISUAL.correcao;
+        const linhaDoEixo = (eixo) => ctx.$(`#visual-modes button[data-eixo="${eixo}"][aria-checked="true"]`)
+            ?.closest('.ctrl-row') ?? null;
         const lqOff = s.lq !== DEFAULTS.lq;
         const owner = s.ownerColors !== DEFAULTS.ownerColors;
         const cb = s.cbSafe !== DEFAULTS.cbSafe;
@@ -201,14 +244,15 @@ export function initSettingsVisual(ctx) {
         const bg = s.outlineBg !== DEFAULTS.hcOutlineBg;
         const papeis = ROLE_KEYS.some((k) => !sameRgb(s.roleColors[k], HC_ROLE_DEF[k]));
         const linha = (sel) => ctx.$(sel)?.closest('.ctrl-row') ?? null;
-        markChanged(ctx.$('#visual-modes'), contraste);
+        markChanged(linhaDoEixo('tema'), tema);
+        markChanged(linhaDoEixo('correcao'), correcao);
         markChanged(linha('#opt-lq'), lqOff);
         markChanged(linha('#opt-ownercolors'), owner);
         markChanged(linha('#opt-cbsafe'), cb);
         markChanged(linha('#opt-outline-fg'), fg);
         markChanged(linha('#opt-outline-bg'), bg);
         markChanged(linha('#opt-role-reset'), papeis);
-        markMenuChanged(ctx.$('[data-act="visual"]'), [contraste, lqOff, owner, cb, fg, bg, papeis]);
+        markMenuChanged(ctx.$('[data-act="visual"]'), [tema, correcao, lqOff, owner, cb, fg, bg, papeis]);
     }
     // ---- restaurar os padrões DESTE menu (ADR-0028) ----
     //

package/dist-pkg/ui/shell.d.ts

@@ -32,9 +32,19 @@ export type { FatosDaCena } from '../core/scenes.js';
 export interface PhaseView {
     /** `#title-overlay`.hidden — o splash só aparece no título. */
     titleOverlayHidden: boolean;
-    /** `#pause-overlay`.hidden — SEMPRE true. A pausa global foi aposentada na Etapa 2 (agora é uma por tela);
-     *  o elemento continua no index.html e o original o escondia incondicionalmente. Verbatim. */
-    pauseOverlayHidden: true;
+    /**
+     * ⚠️ `pauseOverlayHidden` SAIU EM 2026-09-08, e a ausência é a notícia.
+     *
+     * Ele era `true` em toda fase, e existia porque a Etapa 2 aposentou a pausa GLOBAL sem apagar o elemento: a
+     * casca continuava a procurá-lo e a escondê-lo a cada troca de fase, com dois gates a afirmar que ele ficava
+     * escondido. Código a segurar um cadáver.
+     *
+     * E o cadáver custava mais do que as linhas: aquelas quarenta linhas de `#pause-overlay` no `index.html` do
+     * cartucho eram o menu de pausa com aspecto mais OFICIAL do repositório — o que o próximo autor de cartucho
+     * copia junto com o ficheiro —, e já tinham derivado do que a engine gera (dois itens «Comunicação», e um
+     * `#opt-letra` que hoje sai do `dynLabel`). Um campo que diz «está escondido» aceita que ele exista; não o
+     * ter diz que ele não existe.
+     */
     /** `.screen-pause`.hidden de CADA tela — os menus por tela só aparecem na pausa. */
     screenPauseHidden: boolean;
     /** `setMasterMuted(...)` — GAG: fora de 'playing' TODO o som cala (loops de ambiente/chuva inclusive). */

package/dist-pkg/ui/shell.js

@@ -99,7 +99,6 @@ import { PM_ITENS_VISIVEIS } from './pause-icons.js';
 export function phaseView(f) {
     return {
         titleOverlayHidden: !f.telaDeTitulo,
-        pauseOverlayHidden: true,
         screenPauseHidden: !f.menuDePausa,
         masterMuted: !f.mundoRodando,
         hideTouchControls: !f.mundoRodando,
@@ -308,11 +307,11 @@ export function initShell(ctx) {
     /* ===================== a troca de fase ===================== */
     /** A metade IMPURA: pega a projeção pronta e a carimba no documento. */
     function applyPhaseView(v) {
-        const t = ctx.$('#title-overlay'), pa = ctx.$('#pause-overlay');
+        // A pausa GLOBAL não é procurada: ela foi aposentada na Etapa 2, e a casca deixou de a segurar em
+        // 2026-09-08. Ver a nota no `PhaseView`, onde o campo estava.
+        const t = ctx.$('#title-overlay');
         if (t)
             t.hidden = v.titleOverlayHidden;
-        if (pa)
-            pa.hidden = v.pauseOverlayHidden; // pausa GLOBAL aposentada (Etapa 2): agora é uma por tela
         ctx.getPauseScreens().forEach((sp) => { sp.hidden = v.screenPauseHidden; });
     }
     /** O estado do `#touch-controls` ANTES de qualquer coisa desta troca de fase mexer nele. */

package/dist-pkg/ui/simulation-refusal.d.ts

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+import { type MotivoIndisponivel, type VisualState } from '../render/viz-axes.js';
+/** Uma linha pronta a traduzir: a chave e o que ela precisa. `null` = não há nada a dizer. */
+export interface Recusa {
+    readonly chave: string;
+    /** O que a criança tem de desfazer para a demonstração ser honesta. Entra na frase por `{eixo}`. */
+    readonly eixo: MotivoIndisponivel;
+}
+/**
+ * A chave i18n do motivo, por eixo fora do padrão.
+ *
+ * ⚠️ TRÊS CHAVES E NÃO UMA COM PARÂMETRO, e a diferença é de tradução e não de estilo: em português «o tema»
+ * e «a correção de cor» levam artigos diferentes, e «os dois» não é o plural de nenhum dos dois. Uma frase
+ * com `{eixo}` obrigaria cada idioma a montar concordância a partir de um substantivo solto — que é
+ * exactamente o defeito que o `sr.nav.clockOne` já registou para «às 1 horas».
+ */
+export declare const CHAVE_DO_MOTIVO: Readonly<Record<MotivoIndisponivel, string>>;
+/**
+ * Esta simulação pode ser oferecida? E se não, o que dizer.
+ *
+ * `null` = pode; a interface não mostra nada, porque um aviso que aparece sempre deixa de ser lido.
+ */
+export declare function recusaDaSimulacao(v: VisualState): Recusa | null;
+/**
+ * A simulação deve aparecer DESABILITADA em vez de sumir?
+ *
+ * ⚠️ SEMPRE, E É A METADE «never silently removed» DO ADR-0076. Existe como função com nome próprio, e não
+ * como um `!recusa` no ponto de uso, porque ela responde a uma pergunta diferente: `recusaDaSimulacao` diz
+ * *por que* não dá; esta diz *que a linha continua na tela*. Quem desenha precisa das duas, e juntá-las numa
+ * só faria a resposta «não há motivo» parecer «não desenhe a linha».
+ */
+export declare function mostraMesmoIndisponivel(): boolean;

package/dist-pkg/ui/simulation-refusal.js

@@ -0,0 +1,57 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// ui/simulation-refusal — POR QUE A SIMULAÇÃO NÃO ESTÁ DISPONÍVEL, dito à criança (ADR-0076, issue #104).
+//
+// ========================= O QUE A RECUSA TEM DE FAZER, E O QUE ELA NÃO PODE FAZER =========================
+// O ADR-0076 exige que uma simulação indisponível apareça **VISÍVEL e explicada** — «never silently removed,
+// never accepted then ignored». As duas metades dessa frase descrevem dois defeitos diferentes:
+//
+//   · REMOVER EM SILÊNCIO ensina que a coisa não existe. Um adulto que ontem mostrou a simulação a uma turma
+//     e hoje não a acha conclui que ela foi tirada, e não que ele próprio ligou o alto contraste.
+//   · ACEITAR E IGNORAR é pior: a demonstração PARECE estar a correr. Sobre uma tela já corrigida, ela não
+//     mostra nem a deficiência nem a correção; sobre um tema de alto contraste, mostra o que o TEMA faz e não
+//     o que a deuteranopia faz. ⚠️ Não é uma demonstração mais fraca — **ela ensina uma coisa falsa**.
+//
+// ⚠️ E O MOTIVO É UM FACTO SOBRE A DEMONSTRAÇÃO, NUNCA UMA REPREENSÃO A QUEM ESCOLHEU. Quem ligou o alto
+// contraste ligou-o porque precisa; quem ligou a correção de cor vê melhor com ela. A frase diz o que a
+// demonstração precisa para ser honesta, e diz como voltar — nunca «desligue isso».
+//
+// ========================= POR QUE ISTO É UM MÓDULO PURO =========================
+// Mesma forma do `ui/reach-notice`: devolve DADO (chave i18n + parâmetros), não texto pronto. A frase é da
+// interface e tem de passar por `t()`; devolver português daqui repetiria o defeito que o `PADWIZ_STEPS` já
+// deixou de cometer. E, sendo puro, o desenho da recusa é conferível no project `node`, sem documento.
+//
+// Módulo-folha: importa só os tipos e o predicado do modelo de dois eixos.
+import { simulacaoIndisponivel } from '../render/viz-axes.js';
+/**
+ * A chave i18n do motivo, por eixo fora do padrão.
+ *
+ * ⚠️ TRÊS CHAVES E NÃO UMA COM PARÂMETRO, e a diferença é de tradução e não de estilo: em português «o tema»
+ * e «a correção de cor» levam artigos diferentes, e «os dois» não é o plural de nenhum dos dois. Uma frase
+ * com `{eixo}` obrigaria cada idioma a montar concordância a partir de um substantivo solto — que é
+ * exactamente o defeito que o `sr.nav.clockOne` já registou para «às 1 horas».
+ */
+export const CHAVE_DO_MOTIVO = Object.freeze({
+    tema: 'sim.indisponivel.tema',
+    correcao: 'sim.indisponivel.correcao',
+    ambos: 'sim.indisponivel.ambos',
+});
+/**
+ * Esta simulação pode ser oferecida? E se não, o que dizer.
+ *
+ * `null` = pode; a interface não mostra nada, porque um aviso que aparece sempre deixa de ser lido.
+ */
+export function recusaDaSimulacao(v) {
+    const motivo = simulacaoIndisponivel(v);
+    return motivo === null ? null : { chave: CHAVE_DO_MOTIVO[motivo], eixo: motivo };
+}
+/**
+ * A simulação deve aparecer DESABILITADA em vez de sumir?
+ *
+ * ⚠️ SEMPRE, E É A METADE «never silently removed» DO ADR-0076. Existe como função com nome próprio, e não
+ * como um `!recusa` no ponto de uso, porque ela responde a uma pergunta diferente: `recusaDaSimulacao` diz
+ * *por que* não dá; esta diz *que a linha continua na tela*. Quem desenha precisa das duas, e juntá-las numa
+ * só faria a resposta «não há motivo» parecer «não desenhe a linha».
+ */
+export function mostraMesmoIndisponivel() {
+    return true;
+}

package/dist-pkg/ui/visual-axes-panel.d.ts

@@ -0,0 +1,48 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+import { type Tema, type Correcao, type VisualState } from '../render/viz-axes.js';
+/** O rótulo de cada tema. Chave i18n — quem exibe resolve, como todo o resto do menu. */
+export declare const ROTULO_DO_TEMA: Readonly<Record<Tema, string>>;
+/** O rótulo de cada correção de cor. */
+export declare const ROTULO_DA_CORRECAO: Readonly<Record<Correcao, string>>;
+/**
+ * Os rótulos CURTOS, para os ícones da barra rápida — «7:1», «deuteranopia».
+ *
+ * ⚠️ SÃO AS CHAVES QUE JÁ EXISTIAM (`contrast.*`, `cvd.*`), re-chaveadas por eixo. A barra rápida sempre
+ * falou curto porque anuncia UM ícone de cada vez, e o painel sempre falou por extenso porque a criança está
+ * a ler uma lista — a diferença é de contexto e sobrevive à divisão. Reaproveitar em vez de traduzir de novo
+ * é o que mantém a mesma palavra nos dois sítios.
+ */
+export declare const CURTO_DO_TEMA: Readonly<Record<Tema, string>>;
+export declare const CURTO_DA_CORRECAO: Readonly<Record<Correcao, string>>;
+/** Os dois eixos, como o painel os identifica no DOM. */
+export type EixoVisual = 'tema' | 'correcao';
+/** Um tradutor, igual ao que o resto da interface recebe. */
+export type Tradutor = (chave: string, params?: Record<string, string | number>) => string;
+/**
+ * As linhas de UM eixo, no formato de rádio que o painel já usa.
+ *
+ * ⚠️ RÁDIO E NÃO SETE BOTÕES, e o motivo sobrevive à divisão: DENTRO de um eixo os valores continuam
+ * exclusivos — um tema de cada vez, uma correção de cada vez. O que deixou de ser exclusivo é a relação
+ * ENTRE os eixos, e é por isso que eles viram dois rádios em vez de um.
+ *
+ * ⚠️ E MANTÉM-SE A FORMA DE LINHA VISÍVEL, não um `<select>`. O `settings-visual` regista o erro que o Dev
+ * apanhou na primeira tentativa: dentro de uma caixa fechada, um controle cuja razão de existir é ser ACHADO
+ * por quem enxerga mal fica «quase o mesmo que não ter movido».
+ */
+export declare function linhasDoEixo(eixo: EixoVisual, valores: readonly string[], rotulos: Readonly<Record<string, string>>, atual: string, t: Tradutor): string;
+/**
+ * Os DOIS eixos, um a seguir ao outro, com um título cada.
+ *
+ * O título existe porque dois rádios seguidos sem nome são um rádio de oito para quem lê depressa — e essa
+ * leitura é exactamente o mal-entendido que a divisão existe para desfazer.
+ */
+export declare function eixosHtml(v: VisualState, t: Tradutor): string;
+/** O que um clique num botão do painel quer dizer. `null` quando o botão não é de eixo nenhum. */
+export interface EscolhaDeEixo {
+    readonly eixo: EixoVisual;
+    readonly valor: string;
+}
+export declare function escolhaDoBotao(dataset: {
+    eixo?: string;
+    valor?: string;
+}): EscolhaDeEixo | null;

package/dist-pkg/ui/visual-axes-panel.js

@@ -0,0 +1,95 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// ui/visual-axes-panel — O MENU VISUAL COM DOIS CONTROLES (ADR-0076, issue #104), na metade pura.
+//
+// ========================= O COMENTÁRIO QUE AUTORIZA ESTA MUDANÇA =========================
+// O `ui/settings-visual` justifica o controle ÚNICO com estas palavras, e elas continuam lá, verdadeiras
+// sobre o dia em que foram escritas:
+//
+//     «Os sete vivem num CONTROLE SÓ, e isso não é economia de espaço: `p.viz` guarda UM valor. Dois
+//      controles separados se sobrescreveriam em silêncio — a criança escolheria a correção, depois o
+//      contraste, e perderia a correção sem nada dizer que perdeu.»
+//
+// ⚠️ A RAZÃO QUE ELE DÁ DEIXOU DE EXISTIR. `p.viz` já não guarda um valor: guarda dois eixos mais a
+// simulação, e os escritores por eixo (`setTemaDoJogador`/`setCorrecaoDoJogador`) mexem num sem tocar no
+// outro. O controle único era a forma honesta de contar uma exclusividade REAL; mantê-lo agora seria contar
+// uma exclusividade que já não existe — e continuar a negar os dois a quem precisa dos dois.
+//
+// ========================= OS NOMES DOS PADRÕES SÃO DECISÃO, NÃO ROTINA =========================
+// ⚠️ «Tema padrão» e «Visão tricromática», e o ADR-0076 fecha a *definition of done* com a regra que os
+// escolheu: **nenhum rótulo de padrão diagnostica quem lê**. `modo sem deficiência visual` foi oferecido e
+// recusado — ele diz à criança o que ela NÃO é, no menu que ela abriu para conseguir jogar. Um padrão
+// chama-se pelo que ele É.
+//
+// E `Modo padrão` (o `viz.normal` de hoje) deixa de servir aqui: era o neutro PARTILHADO, de quando os dois
+// eixos eram um só. Com dois controles, um «padrão» sem dizer padrão de QUÊ é ambíguo em ambos.
+//
+// Módulo puro: devolve HTML e chaves i18n, não toca documento nenhum. Quem monta é o `render/viz-setters`.
+import { TEMAS, CORRECOES } from '../render/viz-axes.js';
+/** O rótulo de cada tema. Chave i18n — quem exibe resolve, como todo o resto do menu. */
+export const ROTULO_DO_TEMA = Object.freeze({
+    padrao: 'eixo.tema.padrao',
+    hc3: 'viz.hc-direto',
+    hc45: 'viz.hc-direto-45',
+    hc7: 'viz.hc-direto-7',
+});
+/** O rótulo de cada correção de cor. */
+export const ROTULO_DA_CORRECAO = Object.freeze({
+    tricro: 'eixo.correcao.tricro',
+    protan: 'viz.fix-protan',
+    deuter: 'viz.fix-deuter',
+    tritan: 'viz.fix-tritan',
+});
+/**
+ * Os rótulos CURTOS, para os ícones da barra rápida — «7:1», «deuteranopia».
+ *
+ * ⚠️ SÃO AS CHAVES QUE JÁ EXISTIAM (`contrast.*`, `cvd.*`), re-chaveadas por eixo. A barra rápida sempre
+ * falou curto porque anuncia UM ícone de cada vez, e o painel sempre falou por extenso porque a criança está
+ * a ler uma lista — a diferença é de contexto e sobrevive à divisão. Reaproveitar em vez de traduzir de novo
+ * é o que mantém a mesma palavra nos dois sítios.
+ */
+export const CURTO_DO_TEMA = Object.freeze({
+    padrao: 'contrast.off', hc3: 'contrast.3', hc45: 'contrast.45', hc7: 'contrast.7',
+});
+export const CURTO_DA_CORRECAO = Object.freeze({
+    tricro: 'cvd.off', protan: 'cvd.protan', deuter: 'cvd.deuter', tritan: 'cvd.tritan',
+});
+/**
+ * As linhas de UM eixo, no formato de rádio que o painel já usa.
+ *
+ * ⚠️ RÁDIO E NÃO SETE BOTÕES, e o motivo sobrevive à divisão: DENTRO de um eixo os valores continuam
+ * exclusivos — um tema de cada vez, uma correção de cada vez. O que deixou de ser exclusivo é a relação
+ * ENTRE os eixos, e é por isso que eles viram dois rádios em vez de um.
+ *
+ * ⚠️ E MANTÉM-SE A FORMA DE LINHA VISÍVEL, não um `<select>`. O `settings-visual` regista o erro que o Dev
+ * apanhou na primeira tentativa: dentro de uma caixa fechada, um controle cuja razão de existir é ser ACHADO
+ * por quem enxerga mal fica «quase o mesmo que não ter movido».
+ */
+export function linhasDoEixo(eixo, valores, rotulos, atual, t) {
+    return valores.map((valor) => {
+        const sel = valor === atual;
+        return `<div class="ctrl-row"><span><strong>${t(rotulos[valor])}</strong></span>`
+            + `<button class="mode-btn${sel ? ' is-on' : ''}" role="radio" aria-checked="${sel}"`
+            + ` data-eixo="${eixo}" data-valor="${valor}" type="button">${sel ? t('viz.escolhido') : t('viz.escolher')}</button></div>`;
+    }).join('');
+}
+/**
+ * Os DOIS eixos, um a seguir ao outro, com um título cada.
+ *
+ * O título existe porque dois rádios seguidos sem nome são um rádio de oito para quem lê depressa — e essa
+ * leitura é exactamente o mal-entendido que a divisão existe para desfazer.
+ */
+export function eixosHtml(v, t) {
+    return `<h3 class="opt-sub">${t('eixo.tema.titulo')}</h3>`
+        + linhasDoEixo('tema', TEMAS, ROTULO_DO_TEMA, v.tema, t)
+        + `<h3 class="opt-sub">${t('eixo.correcao.titulo')}</h3>`
+        + linhasDoEixo('correcao', CORRECOES, ROTULO_DA_CORRECAO, v.correcao, t);
+}
+export function escolhaDoBotao(dataset) {
+    const { eixo, valor } = dataset;
+    if (eixo !== 'tema' && eixo !== 'correcao')
+        return null;
+    if (!valor)
+        return null;
+    const validos = eixo === 'tema' ? TEMAS : CORRECOES;
+    return validos.includes(valor) ? { eixo, valor } : null;
+}

package/dist-pkg/ui/webcam.js

@@ -7,6 +7,7 @@ import { t } from '../core/i18n.js';
 import { $ } from './dom.js';
 import { srAlert } from '../core/a11y-sr.js';
 import { emFracao } from '../input/pointer-space.js'; // #105: um lugar so converte um ponto de tela
+import { carimbarOrigem } from '../input/origem-sintetica.js'; // ADR-0109: a tecla sintetica declara quem a produziu
 const wg = () => window.webgazer;
 export let eyeMode = false; // ligado pelo botão; onGaze só age com ele ligado
 export function setEyeMode(on) { eyeMode = on; }
@@ -16,7 +17,11 @@ function eyeSet(k, on, code) {
     if (_eyeKeys[k] === on)
         return;
     _eyeKeys[k] = on;
-    const ev = new KeyboardEvent(on ? 'keydown' : 'keyup', { code, bubbles: true });
+    // ⚠️ CARIMBADO `'olhos'` ANTES DE DESPACHAR (ADR-0109). Sem esta linha o evento chega ao `input/keydown`
+    // indistinguível de uma tecla premida e é carimbado `teclado` — e o efeito não é cosmético: a regra 3 diz
+    // que apertar uma tecla devolve o teclado SEM alternância, logo o olhar da criança desligaria, sozinho e em
+    // silêncio, a alternância de que ela depende para jogar. É o defeito que o §C desta issue existe para fechar.
+    const ev = carimbarOrigem(new KeyboardEvent(on ? 'keydown' : 'keyup', { code, bubbles: true }), 'olhos');
     window.dispatchEvent(ev);
     document.dispatchEvent(ev);
 }

package/docs/CREDITS.md

@@ -62,3 +62,21 @@ A narração por voz roda **inteiramente no navegador/offline** graças ao traba
 
 > Os pesos das vozes são **baixados uma vez** (de um host público) e rodam **100% localmente** depois — nenhum áudio de
 > criança sai do dispositivo. Ver `docs/2-Architecture/adr/ADR-0065-three-neural-voices-owned-by-the-engine-and-cached-on-first-use.yaml`.
+
+## Arte — Liberated Pixel Cup — CC BY-SA 3.0
+
+A atribuição do [Liberated Pixel Cup](https://github.com/OpenGameArt/LiberatedPixelCup) é **por recurso**, e por
+isso não cabe nesta página em prosa: o repositório do LCP guarda ficheiros de autoria separados para originais e
+derivados, e a cadeia lê-se recurso a recurso.
+
+**Ela mora em [`../art/lcp/ATTRIBUTION.csv`](../art/lcp/ATTRIBUTION.csv)** — caminho, autor, fonte, licença e de que
+recursos cada um derivou. É a mesma forma que o `LICENSES.md` §4 já usa para as 100 gerações do PixelLab: um
+ficheiro tabular ao lado do apontador em prosa, porque um livro-razão que cresce com o catálogo não se mantém à mão.
+
+⚠️ **Atribuição aqui é condição de uso, não linha de crédito.** Os dois braços da licença exigem-na, e um recurso
+sem autor conhecido **não entra** — «não consegui descobrir» não é licença. O gate
+`tests/lcp-quarantine.node.test.js` reprova a entrada vazia, a entrada órfã e o recurso sem entrada, e a árvore
+está em **quarentena** por uma razão que o [`LICENSES.md`](LICENSES.md) §3 e o **ADR-0107** explicam: misturar o LCP
+com a arte própria licenciaria em share-alike a obra de alguém que não está neste repositório para discordar.
+
+**Hoje o livro está vazio** — o LCP foi decidido em 2026-09-08 e ainda não entrou.

package/docs/LICENSES.md

@@ -72,6 +72,18 @@ Nem tudo aqui é nosso, e o que não é **não muda de licença por estar neste
 - **Tipografias** — roster e restrições no **ADR-0012**. ⚠️ Ronde e as alternativas OPTIFrench-Script e
   Merveille são **gratuitas só para uso pessoal e NÃO podem ser empacotadas**: oferece-se download, e a
   opção fica desabilitada quando nenhuma está presente.
+- **Arte de terceiros — o Liberated Pixel Cup** (`github.com/OpenGameArt/LiberatedPixelCup`), sob
+  **CC BY-SA 3.0** (**ADR-0107**). O conjunto é duplamente licenciado — CC BY-SA 3.0 **ou** GPL-3.0 — e o
+  projeto toma o braço **CC BY-SA**, para que arte continue governada como arte e não seja puxada para a
+  licença do CÓDIGO; é a mesma separação de regimes que este ficheiro tem em três linhas.
+  ⚠️ **E ele vive em QUARENTENA, o que é mecanismo e não arrumação.** Nenhum recurso pode conter ao mesmo
+  tempo material derivado do LCP e a **arte própria** da autora: o SA alcança o que nós alterarmos — como já
+  está escrito acima para os pictogramas — e misturar os dois licenciaria a arte DELA em share-alike, que é
+  precisamente a decisão que o **pilar 10** deixa com ela e não connosco. O CC BY-SA 3.0 também é
+  **incompatível com a família GPL**, então a mesma quarentena é o que mantém o regime do código limpo.
+  ⚠️ **Atribuição é condição de uso, por recurso**: o repositório do LCP guarda ficheiros de autoria
+  separados para originais e derivados. Recurso sem autor conhecido **não entra** — «não consegui descobrir»
+  não é licença.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-inclusionist/engine",
-  "version": "7.0.0",
+  "version": "8.0.0-rc.1",
   "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": [
@@ -17,10 +17,25 @@
     "form and it is the one every module in this repository already writes internally, so a consumer's",
     "import line looks exactly like ours. Extensionless is NOT offered: supporting both needs two patterns",
     "per layer, and two spellings of one import is how two halves of a codebase drift.",
-    "`./style.css` and `./assets/*` exist because the borrowed panels REQUIRE them and nothing said so — a",
+    "⚠️ `./assets/*` IS GONE (2026-09-07, issue #119). It matched the whole of `app/public/` while `files`",
+    "ships only `app/public/vendor`, so the pattern promised what it did not deliver and a consumer found",
+    "out through a 404 at runtime. Measured before removing: `app/public/` holds three entries — `vendor/`,",
+    "`_headers`, `icon.svg` — and only `vendor` ships, so everything the wide door could resolve in a",
+    "published tarball is already covered by `./assets/vendor/*`, and the rest already 404'd. Nobody's import",
+    "line changes: `engine/assets/vendor/fonts.css` still matches.",
+    "`./style.css` and `./assets/vendor/*` exist because the borrowed panels REQUIRE them and nothing said so — a",
     "consumer that installed this package got dialogs with no styling and a typography menu offering 18",
     "fonts that 404. Copy `assets/vendor/` into your own `public/` at build time: `fonts.css` addresses the",
-    "faces by RELATIVE url, so the folder travels whole or not at all."
+    "faces by RELATIVE url, so the folder travels whole or not at all.",
+    "⚠️ AND COPYING IS NOT ENOUGH — THE CONSUMER MUST ALSO *LINK* THE SHEET, which nothing said either:",
+    "    <link rel=\"stylesheet\" href=\"/vendor/fonts.css\">",
+    "    <link rel=\"preload\" href=\"/vendor/fonts/atkinson-400.woff2\" as=\"font\" type=\"font/woff2\" crossorigin>",
+    "Measured on 2026-09-07: NOBODY in this repository referenced `vendor/fonts.css`. The `app/index.html`",
+    "that used to link it left with the cartridge (issue #111), and the typography panel went on offering",
+    "seventeen families of which none loaded — the child picks one, the menu marks it active, and the browser",
+    "draws the system font. No error anywhere. `app/quiz.html` links it now, and",
+    "`tests/fontes-carregam.node.test.js` holds both halves: no offerable font without a `@font-face`, and",
+    "the host actually loading the sheet."
   ],
   "exports": {
     ".": {
@@ -51,8 +66,12 @@
       "types": "./dist-pkg/educational/*.d.ts",
       "default": "./dist-pkg/educational/*.js"
     },
+    "./i18n/*.js": {
+      "types": "./dist-pkg/i18n/*.d.ts",
+      "default": "./dist-pkg/i18n/*.js"
+    },
     "./style.css": "./app/css/style.css",
-    "./assets/*": "./app/public/*",
+    "./assets/vendor/*": "./app/public/vendor/*",
     "./package.json": "./package.json"
   },
   "types": "./dist-pkg/boot/create-game.d.ts",
@@ -133,6 +152,7 @@
     "test:node": "vitest run --project node",
     "test:browser": "vitest run --project browser",
     "check:precache": "node scripts/check-precache.mjs",
+    "check:annual-report": "node scripts/check-annual-report.mjs",
     "test:a11y": "node scripts/axe-check.mjs",
     "release": "release-it"
   },