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

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

@@ -6,17 +6,25 @@
 // production). Overlay open/close plumbing (frontOverlay, focus management, the #typo hidden toggle, Escape
 // handling) is the SHARED helper used by every settings panel and stays in game.js. The font catalog itself
 // (FONT_GROUPS/FONT_BY_KEY) stays in ./fonts.js (Phase 2 extraction) — imported here, never duplicated.
-import { toggleLabel } from './dom.js';
+// (`toggleLabel` saiu daqui em 2026-09-07: ele devolve «Ligado»/«Desligado», e este menu é uma ESCOLHA.)
 import { t } from '../core/i18n.js';
-import { FONT_GROUPS, FONT_BY_KEY, DEFAULT_FONT_KEY } from './fonts.js';
+import { FONT_GROUPS, FONT_BY_KEY, DEFAULT_FONT_KEY, papelDaFonte, faceDisponivel } from './fonts.js';
 import { markChanged, markMenuChanged, CHANGED_CLASS } from './changed-mark.js';
 // ---------------------------------------------------------------------------------------------
 // Pure logic (no `document`, testable in node)
 // ---------------------------------------------------------------------------------------------
-/** A key is selectable when it exists in the catalog and is not marked `.off` (licence pending, etc.). */
-export function isSelectableFont(k) {
+/**
+ * A key is selectable when it exists in the catalog, is not marked `.off` (licence pending, etc.) — and is
+ * `geral`.
+ *
+ * ⚠️ O TERCEIRO TERMO ENTROU EM 2026-09-07 (issue #87), e sem ele o resto da mudança seria decoração: o menu
+ * deixaria de OFERECER as caligráficas e elas continuariam SELECIONÁVEIS por qualquer outro caminho — o
+ * `resolveFontKey` de uma chave guardada, um `data-font` num markup de consumidor. «Não está na lista» e «não
+ * pode ser escolhida» têm de ser a mesma afirmação, ou a lista é só uma sugestão.
+ */
+export function isSelectableFont(k, instalada) {
     const it = FONT_BY_KEY[k];
-    return !!it && !it.off;
+    return !!it && faceDisponivel(it, instalada) && papelDaFonte(it) === 'geral';
 }
 // A semantica da chave (validacao + migracao da chave antiga) mora em ui/fonts.ts, que e o dono do
 // catalogo; re-exportada aqui para quem ja consome este modulo. Uma implementacao, nao duas.
@@ -38,35 +46,76 @@ export function fontCssTarget(k, it) {
     const suffix = it.fb === 'serif' ? ',Georgia,serif' : it.fb === 'cursive' ? ',cursive' : '';
     return { fonte: 'custom', customFamily: `'${it.fam}'${suffix}` };
 }
+/**
+ * UMA linha da lista, a partir de uma face do catálogo. Extraída em 2026-09-07 (issue #87) porque o gate do
+ * mecanismo `.off` precisava de a exercitar com uma face de MENTIRA: as duas únicas entradas desligadas
+ * saíram do roster, e um caso que dependa da composição do catálogo reprova sempre que o roster muda.
+ *
+ * O mecanismo fica, e é preciso: o item 4 da #87 usa-o para a **Ronde**, que só pode ser oferecida se uma de
+ * três faces estiver instalada, porque duas delas são gratuitas apenas para uso pessoal e não podem ser
+ * empacotadas.
+ */
+export function linhaDaFonte(it, fontKey, instalada) {
+    // ⚠️ A MESMA pergunta que o `isSelectableFont` faz, pela MESMA função. Duas respostas dariam uma linha
+    // clicável que o clique recusa — ou, pior, uma linha cinzenta que o `resolveFontKey` aceita por outro
+    // caminho. «Não está disponível» e «não pode ser escolhida» têm de ser a mesma afirmação.
+    const disabled = !faceDisponivel(it, instalada);
+    // `d` e `off` também guardam CHAVE. O travessão que junta os dois é pontuação, não frase — as duas
+    // metades são independentes e cada uma traduz por si.
+    const desc = it.d ? t(it.d) : '', motivo = it.off ? t(it.off) : '';
+    const note = desc ? desc + (disabled ? ' — ' + motivo : '') : disabled ? motivo : '';
+    return { key: it.k, fam: it.fam, selected: fontKey === it.k, disabled, note };
+}
 /** Pure view-model for the typography list: which row is selected/disabled and its note, per catalog group. */
-export function typoGroups(fontKey) {
+export function typoGroups(fontKey, instalada) {
+    // ⚠️ SÓ AS GERAIS ENTRAM NA LISTA (emenda do ADR-0012, issue #87). As caligráficas existem para a criança
+    // APRENDER a ler letra cursiva — isso é matéria, e vive DENTRO das atividades, em botões próprios. Oferecê-
+    // las aqui é dar-lhe a matéria como obstáculo em todo lugar onde ela só quer navegar o menu.
+    //
+    // Um grupo que fique sem nenhuma face geral desaparece da lista, em vez de aparecer como título vazio.
     return FONT_GROUPS.map((g) => ({
         g: t(g.g), // `g` guarda CHAVE i18n desde o item 14 (ver ui/fonts)
-        rows: g.items.map((it) => {
-            const disabled = !!it.off;
-            // `d` e `off` também guardam CHAVE. O travessão que junta os dois é pontuação, não frase — as duas
-            // metades são independentes e cada uma traduz por si.
-            const desc = it.d ? t(it.d) : '', motivo = it.off ? t(it.off) : '';
-            const note = desc ? desc + (disabled ? ' — ' + motivo : '') : disabled ? motivo : '';
-            return { key: it.k, fam: it.fam, selected: fontKey === it.k, disabled, note };
-        }),
-    }));
+        rows: g.items.filter((it) => papelDaFonte(it) === 'geral').map((it) => linhaDaFonte(it, fontKey, instalada)),
+    })).filter((grupo) => grupo.rows.length > 0);
 }
+/**
+ * ⚠️ A MARCA DE SELEÇÃO, e ela existe porque COR NÃO É ESTADO.
+ *
+ * O `.mode-btn.is-on` pinta o botão com `var(--accent)` — o fundo amarelo que a emenda do ADR-0012 pede
+ * por extenso. Mas quem não distingue a cor não vê estado nenhum, e é a mesma razão pela qual
+ * `ui/activities-menu.ts:656` já emite ☑/☐ ao lado do `aria-checked`: «o estado em DUAS formas, e nenhuma
+ * delas é cor».
+ */
+const MARCA_ESCOLHIDA = '●';
+const MARCA_ALTERNATIVA = '○';
 function rowHTML(row) {
     const noteHTML = row.note
         ? `<br><span class="opt-hint" style="margin:0;font-family:var(--font)">${row.note}</span>`
         : '';
     const ariaLabel = row.fam + (row.note ? ' — ' + row.note : '');
-    const stateLabel = toggleLabel(row.selected);
     return (`<div class="ctrl-row"><span style="font-family:'${row.fam}'"><strong>${row.fam}</strong>${noteHTML}</span>` +
-        `<button class="mode-btn switch${row.selected ? ' is-on' : ''}" data-font="${row.key}" type="button"` +
-        `${row.disabled ? ' disabled' : ''} aria-pressed="${row.selected}" aria-label="${ariaLabel}">${stateLabel}</button></div>`);
+        `<button class="mode-btn${row.selected ? ' is-on' : ''}" data-font="${row.key}" type="button" role="radio"` +
+        `${row.disabled ? ' disabled' : ''} aria-checked="${row.selected}" aria-label="${ariaLabel}">` +
+        `${row.selected ? MARCA_ESCOLHIDA : MARCA_ALTERNATIVA}</button></div>`);
 }
-/** Full innerHTML for #typo-list, given the currently selected key. Pure string building — no DOM. */
-export function typoListHTML(fontKey) {
-    return typoGroups(fontKey)
+/**
+ * Full innerHTML for #typo-list, given the currently selected key. Pure string building — no DOM.
+ *
+ * ⚠️ É UM GRUPO DE RÁDIO SÓ, ATRAVESSANDO AS TRÊS SECÇÕES, e isso é a decisão e não um detalhe de
+ * marcação: a exclusividade é do MENU inteiro — uma fonte activa no total —, não de cada família. Três
+ * grupos diriam a quem escuta que dá para ter uma sans E uma serif ao mesmo tempo.
+ *
+ * ⚠️ E ISTO DEIXOU DE SER UM INTERRUPTOR EM 2026-09-07. Era `class="mode-btn switch"` + `aria-pressed` +
+ * `toggleLabel()`, ou seja dezassete interruptores independentes anunciando «Ligado»/«Desligado» para
+ * escolher UMA fonte. A emenda do ADR-0012 diz o contrário em tantas palavras: «THE MENU IS A CHOICE, NOT
+ * A TOGGLE […] One font is active; the others are alternatives, not switches.» O `switch` do
+ * `style.css:427` desenha uma chave de 52×28 px com bolinha — era o desenho de um estado que não existe.
+ */
+export function typoListHTML(fontKey, instalada) {
+    const grupos = typoGroups(fontKey, instalada)
         .map((group) => `<h3 class="panel-sub">${group.g}</h3>` + group.rows.map(rowHTML).join(''))
         .join('');
+    return `<div role="radiogroup" aria-label="${t('font.grupo.rotulo')}">${grupos}</div>`;
 }
 // ---------------------------------------------------------------------------------------------
 // DOM-facing (thin) — requires `document`/injected ctx
@@ -75,7 +124,9 @@ export function initSettingsTypo(ctx) {
     let fontKey = resolveFontKey(ctx.store);
     function setFont(k, announce = false) {
         const it = FONT_BY_KEY[k];
-        if (!it || it.off)
+        // A MESMA função das outras duas leituras: uma face que a lista mostra clicável tem de ser aceite aqui,
+        // e uma que ela mostra cinzenta tem de ser recusada. Três respostas à mesma pergunta divergem.
+        if (!it || !faceDisponivel(it, ctx.fonteInstalada))
             return;
         fontKey = k;
         persistFontKey(ctx.store, k);
@@ -95,7 +146,7 @@ export function initSettingsTypo(ctx) {
         const el = ctx.$('#typo-list');
         if (!el)
             return;
-        el.innerHTML = typoListHTML(fontKey);
+        el.innerHTML = typoListHTML(fontKey, ctx.fonteInstalada);
         el.querySelectorAll('button[data-font]').forEach((b) => {
             b.addEventListener('click', () => {
                 const k = b.dataset.font;

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

@@ -50,7 +50,14 @@ export interface SettingsVisualCtx {
     /** Desenha UMA lista de rádio de modos visuais (+ abas por jogador). O MESMO helper que o painel de
      *  empatia usa — de propósito: as três correções mudaram de menu, e mudar junto a aparência delas faria a
      *  criança ter de reaprender um controle que ela já conhecia. */
-    renderVizGroup: (listSel: string, tabsSel: string, modes: readonly VizMode[]) => void;
+    /**
+     * Os DOIS eixos deste painel (#104). Substituiu o `renderVizGroup`, que fica com o painel de EMPATIA.
+     *
+     * ⚠️ A lista de sete que este painel oferecia era a forma honesta de contar uma exclusividade REAL, e o
+     * `VISUAL_MODES` explica-a em prosa logo acima. Ela deixou de existir: o estado tem dois eixos, e os
+     * escritores por eixo mexem num sem tocar no outro.
+     */
+    renderEixosVisuais: (listSel: string, tabsSel: string) => void;
     setLq: (t: number) => void;
     setOwnerColors: (on: boolean) => void;
     setCbSafe: (on: boolean) => void;
@@ -58,6 +65,19 @@ export interface SettingsVisualCtx {
     setOutlineBg: (level: number) => void;
     setRoleColor: (key: RoleKey, hex: string) => void;
     resetRoleColors: () => void;
+    /**
+     * Move a prosa das linhas para o rodapé (`ui/settings-panel` → `fillExplain`). Chamado a CADA render.
+     *
+     * ⚠️ NÃO É OPCIONAL POR ELEGÂNCIA: `fillExplain` roda uma vez quando o overlay é frontalizado e move o
+     * `.opt-hint` de dentro de cada linha para o rodapé. Este painel RECONSTRÓI as linhas, e as linhas novas
+     * voltam com a prosa lá dentro — então a explicação aparece duas vezes, no rodapé e sob o rótulo, a
+     * partir do primeiro clique. O `CLAUDE.md` §4 regista exatamente isto, e a issue #109 já o consertou
+     * uma vez noutros painéis.
+     *
+     * Opcional na assinatura porque um consumidor pode montar o painel sem a casca (um teste, o segundo
+     * consumidor): sem casca não há rodapé para duplicar.
+     */
+    fillExplain?: (card: HTMLElement | null) => void;
 }
 /**
  * `viz` quando ele é um modo DESTE menu (contraste ou correção), senão 'normal'.

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

@@ -61,4 +61,25 @@ A narração por voz roda **inteiramente no navegador/offline** graças ao traba
   `es_MX` (ADR-0065, que supersede o ADR-0022).
 
 > 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`.
+> criança sai do dispositivo. Ver `the-inclusionist-docs · docs/2-Architecture/adr/ADR-0065-three-neural-voices-owned-by-the-engine-and-cached-on-first-use.yaml`.
+
+## Arte importada — CC0, CC BY 3.0, CC BY 4.0 ou OGA-BY
+
+A atribuição da arte que vem de fora é **por recurso**, e por isso não cabe nesta página em prosa: a autoria de um
+acervo lê-se recurso a recurso, e a cadeia de derivações com ela.
+
+**Ela mora em [`../art/ATTRIBUTION.csv`](../art/ATTRIBUTION.csv)** — caminho, autor, **URL da 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.** Três das quatro licenças exigem-na, e um recurso
+sem autor conhecido **não entra** — «não consegui descobrir» não é licença. O gate
+`tests/arte-licencas-aceites.node.test.js` reprova a entrada vazia, a entrada órfã, o recurso sem entrada, a fonte
+sem URL e **qualquer licença fora das quatro** — com ND, NC e share-alike recusados por nome e com o motivo de
+cada um, que o [`LICENSES.md`](LICENSES.md) §3 e o **ADR-0133** explicam.
+
+📌 **Não há quarentena, e já houve.** Até 2026-09-09 o Liberated Pixel Cup ia entrar sob CC BY-SA 3.0 atrás de uma
+parede (ADR-0107). O Dev recusou o share-alike e a parede saiu com ele: sem arte cujo copyleft viaje, não há o que
+segregar.
+
+**Hoje o livro está vazio** — nenhum recurso entrou nunca.