@the-inclusionist/engine 9.0.0 → 11.0.0

package/dist-pkg/ui/caa-sets.d.ts

@@ -1,39 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-export type CaaTier = 
-/** CC BY-SA ou nosso: pode viajar dentro do jogo, funciona sem rede nenhuma. */
-'bundled'
-/** A licença permite usar, não redistribuir: quem baixa é a pessoa, uma vez, e fica em cache. */
- | 'fetched'
-/** Falta permissão. Aparece no menu, não é escolhível. */
- | 'negotiating';
-export interface CaaSet {
-    readonly key: string;
-    readonly nome: string;
-    readonly tier: CaaTier;
-    /** Licença como ela foi VERIFICADA, ou null quando ainda não há. Texto curto, para caber na tela. */
-    readonly licenca: string | null;
-    /** Funciona NESTA build? Hoje só as letras — os pictogramas são arquivos que ainda não vieram. */
-    readonly disponivel: boolean;
-    /** Só para pictogramas: uma linha sobre a origem, quando ela muda o que a escolha significa. */
-    readonly nota?: string;
-}
-export declare const CAA_SETS: readonly CaaSet[];
-export declare const CAA_BY_KEY: Readonly<Record<string, CaaSet>>;
-/** Quais CONJUNTOS a criança pode escolher hoje: nenhum. O menu não finge o contrário — os pictogramas são
- *  milhares de arquivos que ainda não entraram no repositório, e quatro deles dependem de negociação. */
-export declare function caaDisponiveis(): CaaSet[];
-/**
- * Por que este conjunto não está disponível — chave i18n, nunca texto pronto.
- *
- * As duas respostas dizem coisas diferentes a quem lê, e é por isso que são duas: "em preparação" quer dizer
- * que a licença está resolvida e o trabalho é NOSSO; "aguardando negociação" quer dizer que a permissão é de
- * OUTRA PESSOA e nenhum esforço nosso a antecipa.
- *
- * E é por isso que os indisponíveis aparecem em vez de serem escondidos: são justamente os conjuntos que uma
- * escola brasileira tem mais chance de já usar em outro produto. O educador que procura PCS e não acha conclui
- * que o jogo não faz — quando o obstáculo é uma licença, não uma capacidade. Esconder responderia a pergunta
- * errada, e responderia errado.
- */
-export declare function caaMotivo(s: CaaSet): string | null;
-/** Rótulo pronto para a linha do menu: nome + o motivo, quando há um. */
-export declare function caaRotulo(s: CaaSet): string;

package/dist-pkg/ui/caa-sets.js

@@ -1,65 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// ui/caa-sets.ts — O CATÁLOGO DA COMUNICAÇÃO AUMENTADA E ALTERNATIVA (ADR-0028). Módulo-folha: dados puros e
-// dois predicados, zero DOM, zero I/O. Quem desenha o menu é ui/settings-caa; quem decide o que ele oferece
-// é este arquivo, porque a decisão é de LICENÇA e não de interface.
-//
-// PARA QUEM ISTO EXISTE: há crianças que leem símbolos e não letras. Para elas, o pictograma não é um enfeite
-// nem uma muleta — é a escrita. Um jogo educativo que só sabe exibir letras simplesmente não fala com elas.
-//
-// A REGRA QUE ORGANIZA A LISTA: a camada de cada conjunto é decidida pela LICENÇA DELE e por mais nada — não
-// pela qualidade, não pelo tamanho, não pela facilidade de integrar. No instante em que um conjunto mudar de
-// camada por outro motivo, este arquivo terá deixado de ser verdadeiro.
-//
-// `tier` é o FATO JURÍDICO (podemos redistribuir? é preciso baixar? falta permissão?). `disponivel` é o FATO
-// DE HOJE (funciona nesta build?). São duas perguntas diferentes e o menu precisa das duas: a primeira diz
-// quem tem de agir, a segunda diz o que a criança consegue escolher agora.
-import { t } from '../core/i18n.js';
-// AS LETRAS NÃO ESTÃO NESTA LISTA, e a ausência é decisão do Dev. Elas eram duas entradas — "maiúsculas e
-// minúsculas" e "maiúsculas somente" — e viraram UM interruptor: "Letras maiúsculas", ligado ou desligado,
-// com o desligado significando as duas caixas. Uma escolha binária apresentada como duas opções faz a criança
-// comparar duas linhas para descobrir que são a mesma pergunta; um interruptor pergunta uma vez.
-//
-// Sobra aqui o que é de verdade uma LISTA: os conjuntos de pictogramas, entre os quais se escolhe um.
-export const CAA_SETS = [
-    // --- PICTOGRAMAS que PODEM viajar com o jogo (CC BY-SA, verificado pelo Dev em 2026-08-24). ---
-    { key: 'mulberry', nome: 'Mulberry Symbols', tier: 'bundled', licenca: 'CC BY-SA', disponivel: false },
-    { key: 'blissymbolics', nome: 'Blissymbolics', tier: 'bundled', licenca: 'CC BY-SA 4.0', disponivel: false,
-        nota: 'Escrita simbólica própria: os símbolos se combinam para formar sentidos novos.' },
-    { key: 'tawasol', nome: 'Tawasol', tier: 'bundled', licenca: 'CC BY-SA 4.0', disponivel: false,
-        nota: 'Desenhado na e para a cultura árabe. Um pictograma não é neutro — a criança reconhece mais depressa os objetos, as roupas e os rostos do próprio mundo.' },
-    // --- PICTOGRAMA que precisa ser BAIXADO. ---
-    { key: 'arasaac', nome: 'ARASAAC', tier: 'fetched', licenca: 'baixado à parte', disponivel: false },
-    // --- AGUARDANDO NEGOCIAÇÃO. Ficam visíveis de propósito: ver `caaMotivo`. ---
-    { key: 'sclera', nome: 'Sclera', tier: 'negotiating', licenca: null, disponivel: false },
-    { key: 'pcs', nome: 'PCS', tier: 'negotiating', licenca: null, disponivel: false },
-    { key: 'symbolstix', nome: 'SymbolStix', tier: 'negotiating', licenca: null, disponivel: false },
-    { key: 'widgit', nome: 'Widgit Symbols', tier: 'negotiating', licenca: null, disponivel: false },
-];
-export const CAA_BY_KEY = Object.fromEntries(CAA_SETS.map((s) => [s.key, s]));
-/** Quais CONJUNTOS a criança pode escolher hoje: nenhum. O menu não finge o contrário — os pictogramas são
- *  milhares de arquivos que ainda não entraram no repositório, e quatro deles dependem de negociação. */
-export function caaDisponiveis() {
-    return CAA_SETS.filter((s) => s.disponivel);
-}
-/**
- * Por que este conjunto não está disponível — chave i18n, nunca texto pronto.
- *
- * As duas respostas dizem coisas diferentes a quem lê, e é por isso que são duas: "em preparação" quer dizer
- * que a licença está resolvida e o trabalho é NOSSO; "aguardando negociação" quer dizer que a permissão é de
- * OUTRA PESSOA e nenhum esforço nosso a antecipa.
- *
- * E é por isso que os indisponíveis aparecem em vez de serem escondidos: são justamente os conjuntos que uma
- * escola brasileira tem mais chance de já usar em outro produto. O educador que procura PCS e não acha conclui
- * que o jogo não faz — quando o obstáculo é uma licença, não uma capacidade. Esconder responderia a pergunta
- * errada, e responderia errado.
- */
-export function caaMotivo(s) {
-    if (s.disponivel)
-        return null;
-    return s.tier === 'negotiating' ? 'caa.aguardandoNegociacao' : 'caa.emPreparo';
-}
-/** Rótulo pronto para a linha do menu: nome + o motivo, quando há um. */
-export function caaRotulo(s) {
-    const motivo = caaMotivo(s);
-    return motivo ? `${s.nome} — ${t(motivo)}` : s.nome;
-}

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

@@ -1,32 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-/** Uma linha pronta a traduzir. `null` = há escolha, e não há nada a dizer. */
-export interface RecusaDaAlternancia {
-    readonly chave: string;
-    /** O transporte que a exige — fica disponível para quem quiser compor a frase de outro modo. */
-    readonly transporte: string;
-}
-/**
- * A chave i18n do motivo, POR TRANSPORTE.
- *
- * ⚠️ QUATRO CHAVES E NÃO UMA COM `{aparelho}`, e a razão é de tradução e não de estilo: «os gestos» é plural
- * e «o olhar» não, logo uma frase única obrigaria cada idioma a montar concordância a partir de um
- * substantivo solto. É exactamente o defeito que o `sr.nav.clockOne` registou para «às 1 horas», e que o
- * `ui/simulation-refusal` já recusou pela mesma razão com os três eixos dele.
- */
-export declare const CHAVE_DA_RECUSA: Readonly<Record<string, string>>;
-/**
- * A alternância pode ser desligada neste aparelho? 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 recusaDaAlternancia(transporte: string): RecusaDaAlternancia | null;
-/**
- * O controle continua NA TELA quando a alternância é exigida?
- *
- * ⚠️ SEMPRE, e é a metade «não some» da cláusula 3. Existe como função com nome próprio, e não como um
- * `!recusa` no ponto de uso, porque responde a outra pergunta: `recusaDaAlternancia` diz *por que* não dá;
- * esta diz *que a linha continua na tela*. Juntá-las faria «não há motivo» parecer «não desenhe a linha».
- */
-export declare function mostraMesmoExigida(): boolean;
-/** Os transportes que exigem alternância, para quem precisa de os enumerar. Vem da REGRA, não de uma cópia. */
-export declare const EXIGEM_ALTERNANCIA: ReadonlySet<string>;

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

@@ -1,60 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// ui/latch-refusal.ts — QUANDO A ALTERNÂNCIA NÃO É UMA ESCOLHA, e o que se diz a quem carregou no botão.
-//
-// ========================= A CLÁUSULA 3 DO ADR-0113 =========================
-// «É impossível desligá-la em modos que não tem como funcionar sem ela (voz e câmera)» — a frase do Dev. Em
-// olhos, rosto, gestos e fala a alternância é o que faz a entrada funcionar: sem ela, um comando de cada vez
-// significa que a criança não consegue andar e agir.
-//
-// ⚠️ E O CONTROLE NÃO SOME — FICA DESABILITADO, COM O MOTIVO DITO. Sumir ensina que a coisa não existe: um
-// adulto conclui que ela foi retirada, não que a webcam a exige. É a mesma metade «never silently removed»
-// que o ADR-0076 escreveu para a simulação, e este ficheiro é o irmão do `ui/simulation-refusal` de propósito
-// — mesma forma, mesmo lugar na camada, e portanto conferível no project `node`, sem documento.
-//
-// 🔴 E O MOTIVO É UM FACTO SOBRE O APARELHO, NUNCA UMA REPREENSÃO. «O controle por olhar precisa das teclas de
-// alternância para funcionar» diz por que o botão não responde; «não desligue isto» repreende uma criança por
-// mexer num ajuste de que ela depende. O ADR-0076 já pagou esta distinção uma vez, e a mutação que a apanhou
-// trocava a frase por uma mais curta, mais clara e mais útil — que reprovava na mesma.
-//
-// Módulo-folha: importa só a regra pura da alternância.
-import { alternanciaEhEscolha, UM_COMANDO_DE_CADA_VEZ } from '../input/latch-scope.js';
-/**
- * A chave i18n do motivo, POR TRANSPORTE.
- *
- * ⚠️ QUATRO CHAVES E NÃO UMA COM `{aparelho}`, e a razão é de tradução e não de estilo: «os gestos» é plural
- * e «o olhar» não, logo uma frase única obrigaria cada idioma a montar concordância a partir de um
- * substantivo solto. É exactamente o defeito que o `sr.nav.clockOne` registou para «às 1 horas», e que o
- * `ui/simulation-refusal` já recusou pela mesma razão com os três eixos dele.
- */
-export const CHAVE_DA_RECUSA = Object.freeze({
-    olhos: 'alt.exigida.olhos',
-    rosto: 'alt.exigida.rosto',
-    gestos: 'alt.exigida.gestos',
-    fala: 'alt.exigida.fala',
-});
-/**
- * A alternância pode ser desligada neste aparelho? 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 recusaDaAlternancia(transporte) {
-    if (alternanciaEhEscolha(transporte))
-        return null;
-    const chave = CHAVE_DA_RECUSA[transporte];
-    // 📌 Um transporte que exija alternância e não tenha frase seria um botão desabilitado SEM motivo — pior do
-    // que o defeito que isto conserta, porque a criança deixa de saber sequer que há uma razão. O gate afirma
-    // que os dois conjuntos coincidem; aqui a ausência degrada para «não recuso», que mantém o controle vivo.
-    return chave ? { chave, transporte } : null;
-}
-/**
- * O controle continua NA TELA quando a alternância é exigida?
- *
- * ⚠️ SEMPRE, e é a metade «não some» da cláusula 3. Existe como função com nome próprio, e não como um
- * `!recusa` no ponto de uso, porque responde a outra pergunta: `recusaDaAlternancia` diz *por que* não dá;
- * esta diz *que a linha continua na tela*. Juntá-las faria «não há motivo» parecer «não desenhe a linha».
- */
-export function mostraMesmoExigida() {
-    return true;
-}
-/** Os transportes que exigem alternância, para quem precisa de os enumerar. Vem da REGRA, não de uma cópia. */
-export const EXIGEM_ALTERNANCIA = UM_COMANDO_DE_CADA_VEZ;

package/dist-pkg/ui/map-hub.d.ts

@@ -1,56 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-import type { DomQuery } from '../core/dom-query.js';
-/** Assinatura mínima do seletor de DOM (a mesma de `ui/dom.ts`). */
-export type { DomQuery } from '../core/dom-query.js';
-/** Qual painel a linha abre. `null` = ainda não existe subsistema para abrir. */
-export type MapHubAction = 'options' | 'padwiz' | null;
-/** Uma linha do painel. */
-export interface MapHubRow {
-    /** Rótulo com o emoji na frente — o emoji é o que `soonMessage` corta para falar. */
-    lbl: string;
-    /** Nº de telas exigido; `undefined` = vale em qualquer modo. */
-    mode?: number;
-    /** Em construção: aparece cinza, com "Em breve" no botão. */
-    soon?: boolean;
-    /** O painel que o botão abre, por nome. */
-    act?: MapHubAction;
-}
-/**
- * A TABELA — congelada. A ordem é a da tela: os quatro modos de teclado, o gamepad, e as três promessas.
- * As três últimas são o roadmap deste jogo (webcam e fala), e é por causa delas que o módulo não é engine.
- */
-export declare const MAP_HUB_ROWS: readonly MapHubRow[];
-/** O estado visual de uma linha, para o número de telas atual. */
-export interface MapHubRowState {
-    /** A linha exige um modo diferente do atual. */
-    off: boolean;
-    /** A linha está cinza (em construção OU modo errado) — é o que vira `row-off` + `disabled`. */
-    dis: boolean;
-}
-/** O estado de cada linha em `np` telas. Fonte única do markup e das duas mensagens de `srAlert`. */
-export declare function mapHubStates(np: number, rows?: readonly MapHubRow[]): MapHubRowState[];
-/** O HTML do painel inteiro — cabeçalho + uma `.ctrl-row` por linha. */
-export declare function mapHubMarkup(np: number, rows?: readonly MapHubRow[]): string;
-/** O rótulo sem o emoji da frente — "👁 Mapear olhos e boca" → "Mapear olhos e boca". */
-export declare function soonName(lbl: string): string;
-/** O aviso falado de uma linha em construção. */
-export declare function soonMessage(lbl: string): string;
-/** O aviso falado de uma linha cujo modo não é o número de telas atual. */
-export declare function wrongModeMessage(mode: number): string;
-export interface MapHubCtx {
-    /** Seletor de DOM injetado (`ui/dom.ts:$`) — o módulo nunca alcança `document` sozinho. */
-    $: DomQuery;
-    /** Anúncio assertivo ao leitor de tela (`core/a11y-sr.ts:srAlert`). */
-    srAlert: (msg: string) => void;
-    /** Nº de telas vivo (`core/state.ts:numPlayers`) — GETTER, porque é reatribuído. */
-    getNumPlayers: () => number;
-    /** Abre o painel de remapeamento de teclado (`openOptions` do main.js). */
-    openOptions: () => void;
-    /** Abre o assistente de gamepad (`input/gamepad.ts:openPadWiz`). */
-    openPadWiz: () => void;
-}
-export interface MapHubApi {
-    /** Redesenha `#map-hub` e reamarra os botões. Chamado por `openMovement`, a cada abertura do menu. */
-    render(): void;
-}
-export declare function initMapHub(ctx: MapHubCtx): MapHubApi;

package/dist-pkg/ui/map-hub.js

@@ -1,138 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// ui/map-hub — O PAINEL "MAPEAR CONTROLES", dentro do menu de Movimento.
-//
-// Este módulo é o antigo `renderMapHub()` do main.js (mais o seu ajudante `mapSoon`, que não tinha outro
-// chamador). Ele desenha a lista de formas de comandar o jogo — teclado (uma linha por modo de 1 a 4 telas),
-// gamepad, e três entradas ainda por construir (olhos e boca, setores de olhar, palavras faladas) — e amarra
-// o botão de cada linha ao painel que ela abre.
-//
-// ======================= É DESTE JOGO, E NÃO ENGINE =======================
-// Um segundo jogo da coleção NÃO reusaria este arquivo, e a razão não é o assunto (mapear controles é
-// universal) — é o CONTEÚDO. Este painel enumera exatamente os subsistemas de entrada que *The Inclusionist*
-// tem hoje e os que ele PROMETE ter: a redação "em construção — chega junto com os subsistemas de webcam e
-// fala" é uma declaração de roadmap deste jogo, não uma capacidade do engine. Ele também depende do `#map-hub`
-// deste `index.html`, das classes `ctrl-row`/`mode-btn`/`row-off` desta folha de estilo, e de dois painéis
-// concretos (`openOptions`, `openPadWiz`). O que É engine já está extraído e mora noutro lugar:
-// `input/keyboard.ts` (o esquema), `input/gamepad.ts` (o assistente de mapeamento), `core/screens.ts` (a
-// grade). Aqui sobra a VITRINE — e vitrine é do jogo. Daí `ui/`, ao lado de `ui/settings-motor.ts`, que é o
-// resto do mesmo menu de Movimento.
-//
-// ======================= DECIDIR ≠ EXECUTAR =======================
-// Três coisas eram uma só, e as duas primeiras são puras:
-//   · `MAP_HUB_ROWS` — a TABELA. Rótulo, modo exigido (ou nenhum) e a ação nomeada (`'options'`, `'padwiz'`
-//     ou nada, para as três em construção). A ação virou um NOME e não uma função: é o que permite a tabela
-//     ser um dado congelado, testável, e o `init` decidir qual painel cada nome abre.
-//   · `mapHubStates(np)` / `mapHubMarkup(np)` — o estado de cada linha (desabilitada por estar em construção,
-//     ou por o modo dela não ser o número de telas atual) e o HTML que sai disso. A regra que importa e que
-//     ninguém via no meio da interpolação: "⌨ Mapear teclado para modo 3 jogadores" só habilita quando o jogo
-//     ESTÁ em 3 telas — trocar o mapa de um modo em que você não está mostraria teclas que não valem.
-//   · `initMapHub(ctx).render()` — a metade impura: `innerHTML`, `querySelectorAll`, `addEventListener`.
-//
-// ======================= O AVISO É A PARTE DE ACESSIBILIDADE =======================
-// Um botão `disabled` é invisível para quem navega por teclado com leitor de tela: o foco simplesmente pula.
-// Por isso as duas mensagens de `srAlert` existem, e por isso elas são exportadas como funções puras
-// (`soonMessage`, `wrongModeMessage`): quem clica na linha cinza — por toque, ou porque o leitor lê a linha
-// inteira e não só o botão — recebe o MOTIVO em palavras, não silêncio.
-// Já foi assim: os botões nasciam com o atributo `disabled`, o `click` deles não disparava, e as duas
-// mensagens eram inalcançáveis — medido no navegador: das oito linhas, seis ficavam fora da ordem de foco e
-// clicar nelas não dizia nada. Agora é `aria-disabled`, que anuncia o estado sem esconder o botão.
-//
-// ======================= O QUE FICOU DE FORA, E POR QUÊ =======================
-//  · Abrir/fechar o overlay `#movement` (`openMovement`/`closeMovement`, `frontOverlay`, o foco no primeiro
-//    botão) FICA no main.js: é a casca compartilhada por TODOS os painéis de configuração, não deste.
-//  · `openOptions` e `gamepadApi.openPadWiz()` entram por injeção. O primeiro é do main.js (edita o controle
-//    do jogador que abriu a pausa), o segundo é de `input/gamepad.ts`.
-//  · O número de telas entra por GETTER (`getNumPlayers`) porque `numPlayers` é reatribuído por
-//    `setNumPlayers` a cada troca — e é justamente ele que decide quais linhas ficam cinzas.
-//
-// ======================= ARMADILHAS DE ORDEM DE BOOT =======================
-//  · Zero I/O no import: nada toca o DOM no corpo do módulo. `initMapHub` também não — ele só devolve
-//    `render()`, e é `render()` que procura `#map-hub`. Se o elemento não existir, `render()` desiste em
-//    silêncio (guard clause), como o original.
-//  · `render()` é chamado de dentro de `openMovement`, que é uma DECLARAÇÃO DE FUNÇÃO içada e aparece ANTES
-//    deste ponto no main.js. Não há TDZ: `openMovement` só roda a partir de um clique, muito depois do
-//    módulo ter avaliado. Ainda assim, a religação deve manter um invólucro `function renderMapHub()` no
-//    main.js — declaração içada, como manda a casa — para que a leitura de `openMovement` continue honesta.
-//  · O `np` é lido UMA vez por `render()` e fica preso no manipulador de clique daquela renderização. Isso é
-//    verbatim e é seguro hoje porque `openMovement` re-renderiza a cada abertura; se um dia o painel puder
-//    ficar aberto enquanto o nº de telas muda, esta é a linha a mexer.
-/**
- * A TABELA — congelada. A ordem é a da tela: os quatro modos de teclado, o gamepad, e as três promessas.
- * As três últimas são o roadmap deste jogo (webcam e fala), e é por causa delas que o módulo não é engine.
- */
-export const MAP_HUB_ROWS = Object.freeze([
-    { lbl: '⌨ Mapear teclado para modo 1 jogador', mode: 1, act: 'options' },
-    { lbl: '⌨ Mapear teclado para modo 2 jogadores', mode: 2, act: 'options' },
-    { lbl: '⌨ Mapear teclado para modo 3 jogadores', mode: 3, act: 'options' },
-    { lbl: '⌨ Mapear teclado para modo 4 jogadores', mode: 4, act: 'options' },
-    { lbl: '🎮 Mapear gamepad', act: 'padwiz' }, // L1: assistente (DirectInput e afins) — mapa salvo por modelo
-    { lbl: '👁 Mapear olhos e boca', soon: true },
-    { lbl: '🎯 Mapear setores de olhar', soon: true },
-    { lbl: '🎤 Mapear palavras (fala)', soon: true },
-].map((r) => Object.freeze(r)));
-/** O estado de cada linha em `np` telas. Fonte única do markup e das duas mensagens de `srAlert`. */
-export function mapHubStates(np, rows = MAP_HUB_ROWS) {
-    return rows.map((r) => {
-        const off = !!r.mode && r.mode !== np; // teclado: só o modo em que o jogo ESTÁ fica clicável
-        return { off, dis: !!r.soon || off };
-    });
-}
-/** O HTML do painel inteiro — cabeçalho + uma `.ctrl-row` por linha. */
-export function mapHubMarkup(np, rows = MAP_HUB_ROWS) {
-    const st = mapHubStates(np, rows);
-    return '<h3 class="panel-sub">Mapear controles <span class="panel-sub__tag">por jogador</span></h3>' +
-        rows.map((it, i) => {
-            const dis = st[i].dis;
-            const note = it.soon ? ' <em style="opacity:.7">(em construção)</em>' : '';
-            // `aria-disabled` e NAO `disabled`: o atributo real tira o botao da ordem de foco e engole o clique,
-            // entao quem navega por teclado pulava seis das oito linhas e nunca ficava sabendo por que elas nao
-            // funcionam — enquanto quem enxerga ve a linha cinza e o "(em construcao)". Com `aria-disabled` o
-            // estado e anunciado, o botao continua alcancavel, e as duas frases de srAlert que ja existiam aqui
-            // finalmente chegam a alguem. O visual nao muda: quem pinta a linha cinza e a classe `row-off`.
-            return `<div class="ctrl-row${dis ? ' row-off' : ''}"><span>${it.lbl}${note}</span>` +
-                `<button class="mode-btn" type="button" data-map="${i}"${dis ? ' aria-disabled="true"' : ''}>${it.soon ? 'Em breve' : 'Abrir'}</button></div>`;
-        }).join('');
-}
-/** O rótulo sem o emoji da frente — "👁 Mapear olhos e boca" → "Mapear olhos e boca". */
-export function soonName(lbl) {
-    return lbl.replace(/^\S+\s/, '');
-}
-/** O aviso falado de uma linha em construção. */
-export function soonMessage(lbl) {
-    return soonName(lbl) + ': em construção — chega junto com os subsistemas de webcam e fala.';
-}
-/** O aviso falado de uma linha cujo modo não é o número de telas atual. */
-export function wrongModeMessage(mode) {
-    return 'Disponível só no modo ' + mode + ' jogador' + (mode > 1 ? 'es' : '') + '. Troque o nº de telas na barra do topo.';
-}
-export function initMapHub(ctx) {
-    /** Nome da ação → o painel de verdade. Fora da tabela, para a tabela poder ser dado congelado. */
-    function run(act) {
-        if (act === 'options')
-            ctx.openOptions();
-        else if (act === 'padwiz')
-            ctx.openPadWiz();
-    }
-    function render() {
-        const el = ctx.$('#map-hub');
-        if (!el)
-            return; // o painel não está neste documento — nada a fazer
-        const np = ctx.getNumPlayers(); // lido UMA vez; preso no manipulador desta renderização (ver o cabeçalho)
-        el.innerHTML = mapHubMarkup(np);
-        el.querySelectorAll('button[data-map]').forEach((b) => b.addEventListener('click', () => {
-            const it = MAP_HUB_ROWS[Number(b.dataset['map'])];
-            if (!it)
-                return;
-            if (it.soon) {
-                ctx.srAlert(soonMessage(it.lbl));
-                return;
-            } // em construção: diz o porquê
-            if (it.mode && it.mode !== np) {
-                ctx.srAlert(wrongModeMessage(it.mode));
-                return;
-            } // modo errado: idem
-            run(it.act ?? null);
-        }));
-    }
-    return { render };
-}

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

@@ -1,45 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-import type { LetterCase } from '../core/state.js';
-import { type CaaSet } from './caa-sets.js';
-/**
- * A linha das LETRAS é um INTERRUPTOR, não duas opções (decisão do Dev). Ligado = só maiúsculas; desligado =
- * maiúsculas e minúsculas. Uma pergunta binária apresentada como duas linhas obriga a criança a comparar as
- * duas para descobrir que são a mesma pergunta.
- */
-export declare function caixaAltaLigada(caso: LetterCase): boolean;
-/** O interruptor das letras. Sempre disponível: é o piso offline, e nunca dependeu de arquivo nenhum. */
-export declare function letrasRowHtml(ligado: boolean): string;
-/**
- * Uma linha do menu: RÓTULO CURTO e nada mais à vista.
- *
- * Tudo o que explica — nota, licença, situação — entra num único `.opt-hint`, que é o que a casca
- * (`fillExplain`) reconhece e MOVE para o rodapé. A primeira versão pendurava três blocos de prosa dentro da
- * linha, e o Dev viu o resultado: o menu virou um manual, mais parecido com um arquivo de configuração do que
- * com um menu de videogame. A explicação já tinha um lugar; eu é que não a pus lá.
- *
- * O `disabled` fica: a situação some do TEXTO, não do controle. E o `aria-label` guarda o motivo, para quem
- * navega por teclado ouvir por que a linha não responde sem precisar caçar o rodapé.
- */
-export declare function caaRowHtml(s: CaaSet, selecionada: boolean): string;
-/** O corpo do menu, em três seções — a seção diz de quem é a vez de agir. */
-export declare function caaListHtml(caso: LetterCase): string;
-export interface SettingsCaaCtx {
-    $: <T extends Element = Element>(sel: string) => T | null;
-    srSay: (msg: string) => void;
-    /** Leitura viva de core/state `letterCase` (o binding é reatribuído pelo setter). */
-    getLetterCase: () => LetterCase;
-    /** `setLetterCaseValue` de core/state MAIS a reflexão que o jogo precisa (re-render do quiz, rótulos). */
-    setLetterCase: (c: LetterCase) => void;
-    frontOverlay: (el: HTMLElement | null) => void;
-    /** Move a prosa das linhas para o rodapé (ui/settings-panel `fillExplain`). Chamado a CADA render, e não só
-     *  ao abrir: `render()` reconstrói as linhas, e sem esta chamada a explicação volta para dentro delas — foi
-     *  exatamente o que aconteceu, e o menu virou manual de novo ao primeiro clique. */
-    fillExplain: (card: HTMLElement | null) => void;
-    restoreFocus?: (id: string) => boolean;
-}
-export interface SettingsCaaApi {
-    render: () => void;
-    open: () => void;
-    close: () => void;
-}
-export declare function initSettingsCaa(ctx: SettingsCaaCtx): SettingsCaaApi;

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

@@ -1,137 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// ui/settings-caa.ts — O SÉTIMO MENU: COMUNICAÇÃO AUMENTADA E ALTERNATIVA (ADR-0028, issue #57).
-//
-// O catálogo (quem existe, sob qual licença, em qual camada) mora em ./caa-sets.js; aqui só a tela. DI por
-// ctx, como os seis painéis irmãos: nada de global fora do que for injetado.
-//
-// O QUE ESTE MENU É HOJE, dito sem maquiagem: um seletor de caixa de letra que já mostra, ao lado, os sete
-// conjuntos de pictogramas que virão. Só as duas caixas de letra funcionam — os pictogramas são milhares de
-// arquivos que ainda não entraram no repositório, e três deles dependem de negociação que não é nossa.
-//
-// Mostrar o que não funciona seria desonesto se o menu não dissesse POR QUE. Ele diz, e com duas respostas
-// diferentes de propósito: "em preparação" (a licença está resolvida, o trabalho é nosso) e "aguardando
-// negociação" (a permissão é de outra pessoa). Um educador que lê a primeira sabe esperar; que lê a segunda
-// sabe que esperar não adianta. Esconder tudo o que ainda não anda faria o educador concluir que o jogo não
-// faz pictograma nenhum — que é a conclusão errada, e a que mais custa a quem precisa deles.
-//
-// LETRA vs PICTOGRAMA: a escolha de caixa é `letterCase` (core/state). NÃO existe um `caaMode` paralelo, e
-// isso é decisão: enquanto só duas opções forem escolhíveis, uma segunda variável para a mesma pergunta
-// seria duplicação com aparência de arquitetura. Ver a nota em core/state.
-import { toggleLabel } from './dom.js';
-import { t } from '../core/i18n.js';
-import { DEFAULTS } from '../core/state.js';
-import { CAA_SETS, CAA_BY_KEY, caaMotivo } from './caa-sets.js';
-import { markChanged, markMenuChanged } from './changed-mark.js';
-/**
- * A linha das LETRAS é um INTERRUPTOR, não duas opções (decisão do Dev). Ligado = só maiúsculas; desligado =
- * maiúsculas e minúsculas. Uma pergunta binária apresentada como duas linhas obriga a criança a comparar as
- * duas para descobrir que são a mesma pergunta.
- */
-export function caixaAltaLigada(caso) {
-    return caso === 'upper';
-}
-/** O interruptor das letras. Sempre disponível: é o piso offline, e nunca dependeu de arquivo nenhum. */
-export function letrasRowHtml(ligado) {
-    return ('<div class="ctrl-row" id="caa-letras"><span><strong>Letras maiúsculas</strong>' +
-        '<span class="opt-hint">Ligado: o jogo inteiro em caixa alta, como a alfabetização brasileira costuma ' +
-        'começar. Desligado: maiúsculas e minúsculas, a escrita do dia a dia.</span></span>' +
-        `<button class="mode-btn switch${ligado ? ' is-on' : ''}" id="caa-caixa-alta" type="button"` +
-        ` aria-pressed="${ligado}" aria-label="Letras maiúsculas">${toggleLabel(ligado)}</button></div>`);
-}
-/**
- * Uma linha do menu: RÓTULO CURTO e nada mais à vista.
- *
- * Tudo o que explica — nota, licença, situação — entra num único `.opt-hint`, que é o que a casca
- * (`fillExplain`) reconhece e MOVE para o rodapé. A primeira versão pendurava três blocos de prosa dentro da
- * linha, e o Dev viu o resultado: o menu virou um manual, mais parecido com um arquivo de configuração do que
- * com um menu de videogame. A explicação já tinha um lugar; eu é que não a pus lá.
- *
- * O `disabled` fica: a situação some do TEXTO, não do controle. E o `aria-label` guarda o motivo, para quem
- * navega por teclado ouvir por que a linha não responde sem precisar caçar o rodapé.
- */
-export function caaRowHtml(s, selecionada) {
-    const motivo = caaMotivo(s);
-    const explica = [s.nota, s.licenca ? `Licença: ${s.licenca}` : '', motivo ? t(motivo) : '']
-        .filter(Boolean).join(' · ');
-    const hint = explica ? `<span class="opt-hint">${explica}</span>` : '';
-    const estado = toggleLabel(selecionada);
-    return (`<div class="ctrl-row"><span><strong>${s.nome}</strong>${hint}</span>` +
-        `<button class="mode-btn switch${selecionada ? ' is-on' : ''}" data-caa="${s.key}" type="button"` +
-        `${s.disponivel ? '' : ' disabled'} aria-pressed="${selecionada}"` +
-        ` aria-label="${s.nome}${motivo ? ', ' + t(motivo) : ''}">${estado}</button></div>`);
-}
-/** O corpo do menu, em três seções — a seção diz de quem é a vez de agir. */
-export function caaListHtml(caso) {
-    const bloco = (titulo, tag, corpo) => corpo ? `<h3 class="panel-sub">${titulo} <span class="panel-sub__tag">${tag}</span></h3>${corpo}` : '';
-    const sets = (f) => CAA_SETS.filter(f).map((s) => caaRowHtml(s, false)).join('');
-    return (bloco(t('caa.secao.agora'), t('caa.secao.agoraTag'), letrasRowHtml(caixaAltaLigada(caso))) +
-        bloco(t('caa.secao.preparo'), t('caa.secao.preparoTag'), sets((s) => s.tier !== 'negotiating')) +
-        bloco(t('caa.secao.negociacao'), t('caa.secao.negociacaoTag'), sets((s) => s.tier === 'negotiating')));
-}
-export function initSettingsCaa(ctx) {
-    function render() {
-        const el = ctx.$('#caa-list');
-        if (!el)
-            return;
-        el.innerHTML = caaListHtml(ctx.getLetterCase());
-        const alta = el.querySelector('#caa-caixa-alta');
-        if (alta)
-            alta.addEventListener('click', () => {
-                const ligar = !caixaAltaLigada(ctx.getLetterCase());
-                ctx.setLetterCase(ligar ? 'upper' : 'mixed');
-                render();
-                ctx.srSay(t(ligar ? 'sr.caa.caixaAltaOn' : 'sr.caa.caixaAltaOff'));
-            });
-        el.querySelectorAll('button[data-caa]').forEach((b) => {
-            b.addEventListener('click', () => {
-                const set = b.dataset.caa ? CAA_BY_KEY[b.dataset.caa] : undefined;
-                // Nenhum conjunto está disponível hoje, e todos vêm `disabled`. A guarda existe para o dia em que
-                // alguém remover o atributo "só para testar": um conjunto que não está no jogo não pode virar a
-                // escolha da criança por acidente, deixando a tela sem nada para desenhar.
-                if (!set || !set.disponivel)
-                    return;
-            });
-        });
-        ctx.fillExplain(ctx.$('#caa .overlay__card'));
-        refreshMarks();
-    }
-    /** A marca de "saiu do padrão" (ADR-0029), na linha escolhida e no botão do menu. */
-    function refreshMarks() {
-        const mudou = ctx.getLetterCase() !== DEFAULTS.letterCase;
-        markChanged(ctx.$('#caa-letras'), mudou);
-        markMenuChanged(ctx.$('[data-act="caa"]'), [mudou]);
-    }
-    function open() {
-        const ov = ctx.$('#caa');
-        if (!ov)
-            return;
-        render();
-        ov.hidden = false;
-        ctx.frontOverlay(ov);
-        const f = ov.querySelector('button');
-        if (f)
-            f.focus();
-    }
-    function close() {
-        const ov = ctx.$('#caa');
-        if (!ov)
-            return;
-        ov.hidden = true;
-        ctx.restoreFocus?.('caa');
-    }
-    const closeBtn = ctx.$('#caa-close');
-    if (closeBtn)
-        closeBtn.addEventListener('click', close);
-    // ---- restaurar os padrões DESTE menu (ADR-0028) ----
-    // O menu tem uma escolha só, então o reset é uma linha — mas vale dizer para onde ele volta: maiúsculas, que
-    // é onde a alfabetização brasileira costuma começar. Uma criança que trocou a caixa e não consegue mais ler
-    // a tela precisa de um caminho de volta que termine no que a professora dela usa.
-    const resetBtn = ctx.$('#caa-reset');
-    if (resetBtn)
-        resetBtn.addEventListener('click', () => {
-            ctx.setLetterCase(DEFAULTS.letterCase);
-            render();
-            ctx.srSay(t('sr.caa.reset'));
-        });
-    return { render, open, close };
-}