@the-inclusionist/engine 9.0.0 → 11.0.0

package/dist-pkg/core/anel.js

@@ -1,31 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// core/anel — A CONTA DO ANEL, e nada mais.
-//
-// Ela morava em `ui/menu-nav`, e saiu de lá quando o item 7 do ADR-0044 fez `ui/pause-icons` precisar dela
-// também: `menu-nav` já importava `pause-icons` (por `mostrarSubmenuDaPausa` e `PM_ITENS_VISIVEIS`), e a volta
-// fecharia um CICLO de importação. Ciclo em ESM não estoura na hora — estoura no boot, em TDZ, quando um dos
-// dois lê o outro durante a avaliação. É o tipo de defeito que aparece uma vez, em produção, e some ao ser
-// investigado.
-//
-// Módulo-folha de propósito: zero dependências, uma função, nenhuma I/O. `ui/menu-nav` continua a
-// reexportando, porque é de lá que os testes e os outros menus já a importavam — o nome público não muda.
-/**
- * ANDA UM PASSO NUM ANEL — passar do último volta ao primeiro, e antes do primeiro está o último.
- *
- * Era `clampIndex`, que prendia nas pontas "porque o original nunca faz wrap em lista de itens". O ADR-0044
- * derrubou isso, e o motivo é de uso, não de gosto: com UM MENU POR TELA, toda lista pode ser um anel, e o
- * item mais indesejado (`quit`) fica a UMA tecla do mais urgente (`resume`) sem estar perto dele. Quem não
- * enxerga não varre a lista à procura do fim — ela pergunta "e antes do primeiro?" e recebe uma resposta.
- *
- * A XAG 106 permite o anel exatamente para menu LINEAR, e o proíbe para grade 2-D de blocos: ali "voltar ao
- * primeiro" não tem significado espacial.
- *
- * ⚠️ NAVEGAR LISTA É ANEL; AJUSTAR VALOR É LIMITE. `selectStep` e `rangeStep` (em ui/menu-nav) continuam
- * presos nas pontas, e a diferença é real: passar do volume máximo para o mínimo com uma tecla é um susto,
- * não uma conveniência — e num jogo com pistas de áudio para cegueira, um susto de volume é dano.
- */
-export function passoNoAnel(len, idx, delta) {
-    if (len <= 0)
-        return 0;
-    return ((idx + delta) % len + len) % len; // o `+ len` extra: `%` de negativo em JS devolve negativo
-}

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

@@ -1,21 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-export type CollisionCtx = {
-    world: number[][];
-    W: number;
-    H: number;
-    isWheelchair: () => boolean;
-    isModoCego: () => boolean;
-    caneDiv: () => number;
-    wcSolid: () => ReadonlySet<string>;
-    gateTiles: () => ReadonlySet<string>;
-    gateOpen: () => boolean;
-};
-export declare function initCollision(ctx: CollisionCtx): void;
-export declare const caneBlockPx: () => number;
-export declare const isSolidType: (t: number) => boolean;
-export declare const tileAt: (tx: number, ty: number) => number;
-export declare const solidTile: (x: number, y: number) => boolean;
-export declare const solidAt: (tx: number, ty: number) => boolean;
-export declare const surfTop: (x: number, y: number) => boolean;
-export declare const isWcRampRiser: (col: number, row: number) => boolean;
-export declare function rampSurfaceY(cx: number, py: number): number | null;

package/dist-pkg/core/collision.js

@@ -1,62 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// core/collision.ts — consultas de colisão da GRADE do mundo (determinístico). Extraído do game.js (Estágio 4).
-// Design testável: o módulo NÃO guarda cópias do estado mutável — recebe CLOSURES em initCollision() que leem o
-// estado VIVO do game.js (wheelchair/modoCego/caneBlockDiv/wcSolid/gateTiles/gateOpen). Assim a colisão sempre
-// enxerga o valor atual (sem risco de dessincronização) e os testes passam um ctx falso → funções 100% puras.
-// TILE/TILE_TYPES são constantes (import direto). Consumido pela física (resolveX/resolveY/stepPlayer) no game.js.
-import { TILE, TILE_TYPES, ehPerigo, ehTrampolim } from './constants.js';
-// (`TileType` era declarado AQUI, privado, e era por isso que a tabela semântica não era usável de fora.
-//  Mudou de casa para `core/constants`, junto da tabela que ele descreve.)
-const TYPES = TILE_TYPES;
-// closures no-op até initCollision() (evita null-check no caminho quente da física).
-let _world = [], _W = 0, _H = 0;
-let _isWheelchair = () => false;
-let _isModoCego = () => false;
-let _caneDiv = () => 1;
-let _wcSolid = () => new Set();
-let _gateTiles = () => new Set();
-let _gateOpen = () => true;
-// Liga a colisão ao mundo + estado vivo. Chamado UMA vez no boot do game.js (após WORLD pronto). Idempotente.
-export function initCollision(ctx) {
-    _world = ctx.world;
-    _W = ctx.W;
-    _H = ctx.H;
-    _isWheelchair = ctx.isWheelchair;
-    _isModoCego = ctx.isModoCego;
-    _caneDiv = ctx.caneDiv;
-    _wcSolid = ctx.wcSolid;
-    _gateTiles = ctx.gateTiles;
-    _gateOpen = ctx.gateOpen;
-}
-// distância (px) entre batidas de bengala = TILE / divisor.
-export const caneBlockPx = () => TILE / _caneDiv();
-// Um TIPO de tile é sólido? Cadeirante: PERIGO e TRAMPOLIM viram chão. Modo cego: o PERIGO vira chão.
-// Pelas perguntas e não pelos números 9 e 5: a regra é sobre o que o tile É, e assim ela continua verdadeira
-// num mapa com outra numeração — que é exatamente o que um segundo jogo tem.
-export const isSolidType = (t) => ((_isWheelchair() && (ehPerigo(t) || ehTrampolim(t))) || (_isModoCego() && ehPerigo(t))) ? true : !!TYPES[t]?.solid;
-// Tile na posição (fora do mundo = pedra(2), parede natural). Coordenadas em TILES.
-export const tileAt = (tx, ty) => (tx < 0 || tx >= _W || ty < 0 || ty >= _H) ? 2 : _world[ty][tx];
-// Sólido "de pisar" (inclui sólidos só-cadeirante). isSolidType já cobre lava/trampolim no modo cadeira.
-export const solidTile = (x, y) => {
-    const t = tileAt(x, y);
-    return (_isWheelchair() && _wcSolid().has(x + ',' + y)) || isSolidType(t);
-};
-// Sólido "de barrar" (inclui portão fechado + sólidos só-cadeirante). Usado pela física.
-export const solidAt = (tx, ty) => (!_gateOpen() && _gateTiles().has(tx + ',' + ty)) || (_isWheelchair() && _wcSolid().has(tx + ',' + ty)) || isSolidType(tileAt(tx, ty));
-// Topo caminhável: sólido com ar logo acima (é uma superfície onde se anda).
-export const surfTop = (x, y) => solidTile(x, y) && !solidTile(x, y - 1);
-// Cadeirante: (col,row) é o "degrau" que uma rampa de 1 tile cobre? (superfície com vizinho-diagonal 1 acima)
-export const isWcRampRiser = (col, row) => surfTop(col, row) && (surfTop(col - 1, row + 1) || surfTop(col + 1, row + 1));
-// Altura (px) da diagonal 45° de uma rampa de 1 tile no x=cx do mundo; null se não há rampa por perto de py.
-export function rampSurfaceY(cx, py) {
-    const tcx = Math.floor(cx / TILE), fx = cx - tcx * TILE, ty = Math.floor(py / TILE);
-    for (let y = ty - 1; y <= ty + 1; y++) {
-        if (y < 1 || !surfTop(tcx, y))
-            continue;
-        if (surfTop(tcx + 1, y - 1))
-            return y * TILE - fx; // degrau sobe p/ direita: y*TILE → (y-1)*TILE
-        if (surfTop(tcx - 1, y - 1))
-            return (y - 1) * TILE + fx; // degrau sobe p/ esquerda: (y-1)*TILE → y*TILE
-    }
-    return null;
-}

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

@@ -1,63 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-export declare const Z: {
-    readonly SKY: 1000;
-    readonly SKY_ANIM: 2000;
-    readonly PARALLAX_4: 3000;
-    readonly PARALLAX_3: 4000;
-    readonly PARALLAX_2: 5000;
-    readonly PARALLAX_1: 6000;
-    readonly BG_DECOR: 7000;
-    readonly TILES: 8000;
-    readonly SCENERY_INTERACT: 9000;
-    readonly VFX_BACK: 10000;
-    readonly FLORA_BACK: 11000;
-    readonly FAUNA_BACK: 12000;
-    readonly NPC: 13000;
-    readonly ITEMS: 14000;
-    readonly PLAYER: 15000;
-    readonly VFX_FRONT: 16000;
-    readonly VEHICLES: 17000;
-    readonly FLORA_FRONT: 18000;
-    readonly FAUNA_FRONT: 19000;
-    readonly FOREGROUND: 20000;
-    readonly WEATHER: 21000;
-    readonly DARK_WORLD: 22000;
-    readonly WORLD_A11Y: 23000;
-    readonly HUD: 24000;
-    readonly TOUCH_CONTROLS: 25000;
-    readonly CAPTIONS: 26000;
-    readonly DIALOGUE: 27000;
-    readonly GAME_MSG: 28000;
-    readonly MODAL_SCRIM: 29000;
-    readonly MENU: 30000;
-    readonly MENU_MAX: 39999;
-    readonly TRANSITION: 40000;
-    /**
-     * ⚠️ A SAÍDA DE EMERGÊNCIA, E ELA FICA ACIMA DA TRANSIÇÃO (decisão do Dev, 2026-09-07).
-     *
-     * Este comentário dizia que o *skip-link* mora em `CAPTIONS` (26000) — e isso deixava-o ABAIXO de
-     * `MENU` (30000). Um «pular para o conteúdo» que um modal cobre não é alcançável, o que é a WCAG 2.4.1 ao
-     * contrário: o mecanismo que existe para atravessar blocos repetidos passa a ser mais um bloco.
-     * O gate do `z-order-css` já registava o defeito com todas as letras — «o `Z` ERRA, não o CSS» —, e ficou
-     * assim durante semanas porque nada o obrigava a mudar.
-     *
-     * ⚠️ E É ACIMA DA `TRANSITION`, não entre o menu e ela. O Dev pediu 41000 e o motivo é o que sobra depois
-     * de tudo o resto falhar: a saída não pode ficar atrás de nada que a pessoa não controla, e um fade de
-     * troca de fase é precisamente isso. O custo — o link aparecer por cima de uma animação — é nulo na
-     * prática, porque ele só é visível AO FOCO (`top:-60px` até `:focus`), e porque durante a transição já não
-     * se tabula: o foco sai da tela antiga e só reaparece na seguinte (ver a regra de foco no ADR).
-     *
-     * Só o aviso de laço morto (ADR-0054) e o painel de desenvolvimento ficam acima dela.
-     */
-    readonly SKIP_LINK: 41000;
-    /**
-     * O LAÇO MORREU (ADR-0054). Acima do `TRANSITION` de propósito: quando o quadro lança, o que estiver na
-     * tela — menu aberto, fade a meio, mensagem de fase — está congelado e deixou de importar. O aviso tem de
-     * ser visto por cima de tudo isso, e só o painel de desenvolvimento fica acima dele.
-     */
-    readonly LOOP_CRASH: 45000;
-    readonly DEBUG: 90000;
-};
-export type LayerName = keyof typeof Z;
-export declare const POST_FX_ORDER: readonly ["CRT_VIGNETTE", "EMPATHY_SIM", "A11Y_CORRECTION", "FLASH_LIMIT"];
-export type PostFx = typeof POST_FX_ORDER[number];

package/dist-pkg/core/layers.js

@@ -1,95 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// core/layers — ORDEM-Z CANÔNICA (fonte única de verdade). Cada camada tem um Z NOMEADO; ninguém mais faz
-// addChildAt(getChildIndex(...)) nem "re-adiciona ao topo" — a inserção passa a ser pelo Z (fim do acoplamento).
-// Duas escalas: MUNDO (por viewport — PIXI zIndex dentro da câmera, com sortableChildren) e OVERLAY (global, tela —
-// vira CSS z-index no DOM, pois menu/HUD/legenda são DOM). **Passo 1000** = folga generosa: 999 slots livres entre
-// camadas nomeadas (e sub-slots dentro de cada uma) p/ inserir futuras SEM renumerar. Elementos concretos entram por
-// `Z.BANDA + offset` pequeno (ex.: cane/cadeira = PLAYER+10/+20) — ver docs/5-Refactoring/plano-religacao-z-camadas.md.
-//
-// NATUREZA (fauna/flora) STRADDLE o jogador: há um par BACK (atrás) e FRONT (à frente) p/ cada, deixando bichos/plantas
-// aparecerem dos dois lados do player (imersão — pedido do José). PIXI sortableChildren é tudo-ou-nada por container →
-// o mundo inteiro migra numa rodada só (todos os filhos ganham zIndex de uma vez, reproduzindo a ordem atual = no-op).
-//
-// PÓS-PROCESSO ≠ camada Z: CRT/vinheta e os filtros de a11y (alto-contraste, correção de daltonismo, simulação de
-// deficiência) são uma CADEIA de passes sobre o frame JÁ COMPOSTO (POST_FX_ORDER), não itens da display-list — e cobrem
-// TUDO, inclusive o menu. A11Y_CORRECTION é SEMPRE o último passe; modos de a11y SUPRIMEM o CRT/efeitos decorativos; o
-// overlay é palette-aware (troca p/ CB-safe). Ver ADR-0020 + ADR-0011.
-export const Z = {
-    // ===== MUNDO (por viewport; PIXI zIndex dentro da câmera) =====
-    SKY: 1000, // gradiente de céu (base)
-    SKY_ANIM: 2000, // animações do céu atrás do parallax (estrelas)
-    PARALLAX_4: 3000, // paralaxe mais distante. Nuvens de céu podem entrar em PARALLAX_*+offset (profundidades)
-    PARALLAX_3: 4000,
-    PARALLAX_2: 5000,
-    PARALLAX_1: 6000, // fundo próximo do jogo
-    BG_DECOR: 7000, // deco ATRÁS dos tiles: árvores, água/corais/algas, ruínas, deco de cidade, nuvens de tela
-    TILES: 8000, // tileset / plataforma (o nível)
-    SCENERY_INTERACT: 9000, // cenário interativo: porta, alavanca, interruptor, manivela, corda, portão, rampa, elevador
-    VFX_BACK: 10000, // efeitos ATRÁS dos atores: poeira de pé, god-rays, tracinhos de lava, sombras
-    FLORA_BACK: 11000, // plantas ATRÁS do player (grama, flores, arbustos de fundo)
-    FAUNA_BACK: 12000, // criaturas ATRÁS do player (bichos da cidade, animais de fundo)
-    NPC: 13000, // personagens interativos (não-jogador)
-    ITEMS: 14000, // coletáveis (moedas, poderes, chave) — ATRÁS do player (barril DK / Yoshi / chave SMW)
-    PLAYER: 15000, // jogador(es). Aparatos presos (bengala/cadeira) = PLAYER+offset
-    VFX_FRONT: 16000, // efeitos NA FRENTE do player: partículas/juice, explosão, faísca, fogos, confete
-    VEHICLES: 17000, // veículos na frente (carros/trânsito da cidade)
-    FLORA_FRONT: 18000, // plantas NA FRENTE do player (folhagem que tampa o ator — imersão)
-    FAUNA_FRONT: 19000, // criaturas NA FRENTE do player (borboletas/vagalumes/minhocas v3 passando à frente)
-    FOREGROUND: 20000, // primeiro-plano oclusivo genérico (props que tampam o ator)
-    WEATHER: 21000, // clima na frente de tudo do mundo (névoa, chuva, clarão)
-    DARK_WORLD: 22000, // escurecimento do mundo (modo cego / empatia baixa-visão)
-    WORLD_A11Y: 23000, // pistas visuais de a11y no mundo (sonar, guarda de beirada, hitbox fácil, realce)
-    // ===== OVERLAY (global, tela; = CSS z-index no DOM / topo da stage PIXI) =====
-    HUD: 24000, // placar/moedas/poder/objetivo/minimapa (persistente durante o jogo)
-    TOUCH_CONTROLS: 25000, // gamepad virtual / botões de toque (mobile)
-    CAPTIONS: 26000, // legendas de som (a11y surdez) + skip-link de navegação
-    DIALOGUE: 27000, // fala/diálogo/atividade (quiz)
-    GAME_MSG: 28000, // vitória / game over / pause / faixa de fase
-    MODAL_SCRIM: 29000, // escurecimento do fundo quando abre um modal
-    MENU: 30000, // menus — RANGE reservado 30000–39999 (níveis aninhados: +1000 por nível)
-    MENU_MAX: 39999,
-    TRANSITION: 40000, // fade/wipe de troca de fase (cobre tudo)
-    /**
-     * ⚠️ A SAÍDA DE EMERGÊNCIA, E ELA FICA ACIMA DA TRANSIÇÃO (decisão do Dev, 2026-09-07).
-     *
-     * Este comentário dizia que o *skip-link* mora em `CAPTIONS` (26000) — e isso deixava-o ABAIXO de
-     * `MENU` (30000). Um «pular para o conteúdo» que um modal cobre não é alcançável, o que é a WCAG 2.4.1 ao
-     * contrário: o mecanismo que existe para atravessar blocos repetidos passa a ser mais um bloco.
-     * O gate do `z-order-css` já registava o defeito com todas as letras — «o `Z` ERRA, não o CSS» —, e ficou
-     * assim durante semanas porque nada o obrigava a mudar.
-     *
-     * ⚠️ E É ACIMA DA `TRANSITION`, não entre o menu e ela. O Dev pediu 41000 e o motivo é o que sobra depois
-     * de tudo o resto falhar: a saída não pode ficar atrás de nada que a pessoa não controla, e um fade de
-     * troca de fase é precisamente isso. O custo — o link aparecer por cima de uma animação — é nulo na
-     * prática, porque ele só é visível AO FOCO (`top:-60px` até `:focus`), e porque durante a transição já não
-     * se tabula: o foco sai da tela antiga e só reaparece na seguinte (ver a regra de foco no ADR).
-     *
-     * Só o aviso de laço morto (ADR-0054) e o painel de desenvolvimento ficam acima dela.
-     */
-    SKIP_LINK: 41000,
-    /**
-     * O LAÇO MORREU (ADR-0054). Acima do `TRANSITION` de propósito: quando o quadro lança, o que estiver na
-     * tela — menu aberto, fade a meio, mensagem de fase — está congelado e deixou de importar. O aviso tem de
-     * ser visto por cima de tudo isso, e só o painel de desenvolvimento fica acima dele.
-     */
-    LOOP_CRASH: 45000,
-    DEBUG: 90000, // painel ?debug / FPS / hitboxes (dev; topo absoluto)
-};
-// Cadeia de PÓS-PROCESSO — passes sobre o frame COMPOSTO, do interno p/ o externo. NÃO são camadas Z.
-// Modos de a11y suprimem CRT_VIGNETTE e flashes decorativos (precedência a11y > estética). Ver ADR-0020.
-//
-// DUAS COISAS DIFERENTES NO FIM DA FILA, e confundi-las é o que este comentário existe para impedir:
-//
-//  · A11Y_CORRECTION é o último passe de CORREÇÃO. Ele decide como a imagem SE PARECE, e por isso precisa ver o
-//    composto final, menus inclusive — é essa a razão de ele vir depois do CRT, que senão re-tinge e desfaz a
-//    correção de daltonismo.
-//  · FLASH_LIMIT é o último passe, ponto. Ele decide se a imagem pode FAZER MAL. A WCAG 2.3.1 limita a variação de
-//    luminância no tempo, e o único quadro cuja luminância importa é o que chega ao olho. Um limitador colocado
-//    ANTES da correção limita uma imagem que já não existe, e a correção fica livre para reabrir a oscilação que
-//    ele acabou de fechar — uma matriz de daltonismo redistribui luminância por definição. Segurança é o passe mais
-//    externo porque é a última coisa verdadeira sobre o quadro.
-//
-// O ADR-0020 dizia "A11Y_CORRECTION sempre por último" sem essa distinção; foi emendado em 2026-08-24. FLASH_LIMIT
-// ainda NÃO está implementado — está declarado aqui, e aferido por teste, para que quem o implementar encontre o
-// lugar certo já ocupado em vez de deduzir a ordem errada a partir da redação antiga.
-export const POST_FX_ORDER = ['CRT_VIGNETTE', 'EMPATHY_SIM', 'A11Y_CORRECTION', 'FLASH_LIMIT'];

package/dist-pkg/core/letter-grid.d.ts

@@ -1,55 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-/** As quatro direções que um direcional produz. Nomes em português porque são vocabulário do jogo, não da web. */
-export type Direcao = 'esquerda' | 'direita' | 'cima' | 'baixo';
-/** Onde o cursor está, em coordenadas de grade — o que a tela desenha e o leitor de tela anuncia. */
-export interface Posicao {
-    readonly linha: number;
-    readonly coluna: number;
-}
-export interface GradeDeLetras {
-    /** A grade, como dado: quem desenha lê daqui em vez de recontar. */
-    readonly simbolos: readonly string[];
-    readonly colunas: number;
-    readonly linhas: number;
-    /** Quantas casas o valor aceita. `0` = sem limite (jogos de palavra). */
-    readonly capacidade: number;
-    /** Índice linear do cursor, `0..simbolos.length-1`. */
-    indice(): number;
-    /** A posição do cursor em linha/coluna, base ZERO — quem anuncia soma 1 se quiser falar "linha 1". */
-    posicao(): Posicao;
-    /** O símbolo sob o cursor. */
-    sob(): string;
-    /** Move o cursor uma casa, enrolando em toroide. */
-    mover(dir: Direcao): void;
-    /** Leva o cursor ao símbolo dado. Devolve `false` — e não move — quando ele não está na grade. */
-    irPara(simbolo: string): boolean;
-    /** Acrescenta o símbolo sob o cursor ao valor. Não faz nada quando o valor já está cheio. */
-    digitar(): void;
-    /** Apaga a última casa. Não faz nada quando o valor está vazio. */
-    apagar(): void;
-    /** Esvazia o valor. O cursor NÃO se mexe: quem apagou continua olhando para onde estava. */
-    limpar(): void;
-    /** O que foi digitado até agora. */
-    valor(): string;
-    /** Quantas casas ainda faltam. `null` quando não há capacidade declarada. */
-    faltam(): number | null;
-    /** `true` quando o valor atingiu a capacidade. Sempre `false` sem capacidade declarada. */
-    completo(): boolean;
-}
-export interface OpcoesDaGrade {
-    /** Os símbolos, em ordem de leitura (esquerda→direita, cima→baixo). */
-    simbolos: string;
-    /** Largura da grade. As linhas saem da divisão, e a última pode ficar incompleta. */
-    colunas: number;
-    /** Quantas casas o valor aceita; omitir ou `0` deixa sem limite. */
-    capacidade?: number;
-}
-/**
- * A grade, como instância.
- *
- * `colunas` precisa ser inteiro ≥ 1 e `simbolos` não pode ser vazio: uma grade sem casas não tem cursor, e
- * um cursor sem casa é a origem de todo `undefined` que aparece três telas adiante. As mensagens são
- * SELETORES e não prosa — o gate de i18n de engine proíbe frase em qualquer idioma aqui, e o nome do campo
- * que falhou é mais útil que uma frase de qualquer forma.
- */
-export declare function criarGrade(opcoes: OpcoesDaGrade): GradeDeLetras;

package/dist-pkg/core/letter-grid.js

@@ -1,116 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// core/letter-grid — ENTRADA DE TEXTO SEM TECLADO, e é essa a coisa que este arquivo é.
-//
-// ========================= POR QUE ISTO EXISTE =========================
-// O ADR-0027 diz o que falta ao motor em uma linha: *"the engine needs a LETTER GRID SELECTOR, not a
-// keyboard"*. Um console não tem teclado, e o alvo desta engine é uma máquina de escola operada por
-// direcional — quando não por UM botão só. Digitar, aqui, é mover um cursor por uma grade e confirmar.
-//
-// O consumidor é o CÓDIGO DA SALA DA PROFESSORA. Não é a senha de progressão da criança: o ADR-0037 a
-// enterrou junto com a ideia de salvar jogo — não existe save, e o Inclusionist não guarda nada sobre uma
-// criança. O que o ADR-0037 diz que sobrevive é o `core/password`, e por outro motivo: *"the teacher's room
-// code is the same engineering problem… it stays because the room screen will need it"*. O modo de falha
-// mudou de forma junto: um código errado que seja ACEITO não carrega o progresso de outra criança — larga
-// esta criança na sala de outra turma, fazendo a atividade de outra professora.
-//
-// O segundo consumidor já está previsto e é o que impede este módulo de nascer como componente de senha: os
-// jogos de palavras do catálogo do `inclusionist-demos` precisam da mesma coisa.
-//
-// ========================= O CORTE (ADR-0041) =========================
-// MECÂNICA aqui, TELA no `ui/`. É a mesma divisão que o `core/password` acabou de usar, e ela existe para
-// preservar a propriedade mais cara que o `core/` tem: ser testável sem navegador. O `core/scenes` foi
-// escrito de propósito sem PIXI e sem DOM por esse motivo, e um módulo que DESENHE dentro do `core/` abre
-// uma porta que a próxima tela atravessa sem discussão.
-//
-// O que NÃO está aqui, e é honesto dizer: a repetição de tecla. Ela é temporização de entrada e mora com o
-// `input/`, junto das bordas de tecla — o ADR-0041 a listou como conteúdo desta metade e ela não é.
-//
-// ========================= A ESCOLHA DE ENROLAMENTO, E O MOTIVO =========================
-// Nas bordas o cursor enrola em TOROIDE: andar para a direita mantém a LINHA, andar para baixo mantém a
-// COLUNA. A alternativa — a da direita na última coluna cair na linha seguinte, como texto — é comum em
-// teclados de console e está errada aqui, e o motivo é o leitor de tela: a leitura anuncia "linha 2,
-// coluna 1", e um movimento horizontal que mude a linha faz o anúncio contradizer a direção que a criança
-// apertou. Movimento previsível vale mais que economia de apertos.
-//
-// SEM I/O NO IMPORT, e sem estado de módulo: `criarGrade()` devolve a instância e quem compõe a possui. É a
-// D13 do `inclusionist-demos`, e é o que permite duas grades na mesma página sem uma pisar na outra.
-/**
- * A grade, como instância.
- *
- * `colunas` precisa ser inteiro ≥ 1 e `simbolos` não pode ser vazio: uma grade sem casas não tem cursor, e
- * um cursor sem casa é a origem de todo `undefined` que aparece três telas adiante. As mensagens são
- * SELETORES e não prosa — o gate de i18n de engine proíbe frase em qualquer idioma aqui, e o nome do campo
- * que falhou é mais útil que uma frase de qualquer forma.
- */
-export function criarGrade(opcoes) {
-    const simbolos = [...opcoes.simbolos];
-    const colunas = opcoes.colunas;
-    if (simbolos.length === 0)
-        throw new Error('simbolos');
-    if (!Number.isInteger(colunas) || colunas < 1)
-        throw new Error('colunas');
-    const linhas = Math.ceil(simbolos.length / colunas);
-    const capacidade = opcoes.capacidade ?? 0;
-    if (!Number.isInteger(capacidade) || capacidade < 0)
-        throw new Error('capacidade');
-    let cursor = 0;
-    let digitado = '';
-    /** Enrolamento de um eixo, escrito uma vez: `((v % n) + n) % n` sobrevive a negativo, que `v % n` não. */
-    const enrolar = (v, n) => ((v % n) + n) % n;
-    /**
-     * A ÚLTIMA LINHA PODE SER INCOMPLETA — 32 símbolos em 8 colunas dão 4 linhas cheias, mas 30 dariam uma
-     * linha com 6. Descer numa coluna que não existe na linha de destino cairia num buraco, e este é o ponto
-     * que decide o que fazer: o cursor pula a linha incompleta naquela coluna e segue descendo. Assim toda
-     * tecla move, sempre, para uma casa que existe — e o leitor de tela nunca anuncia vazio.
-     */
-    function indiceDe(linha, coluna) {
-        for (let i = 0; i < linhas; i++) {
-            const l = enrolar(linha + i, linhas);
-            const idx = l * colunas + coluna;
-            if (idx < simbolos.length)
-                return idx;
-        }
-        return cursor; // inalcançável com colunas ≥ 1: a linha 0 sempre tem a coluna 0
-    }
-    function posicao() {
-        return { linha: Math.floor(cursor / colunas), coluna: cursor % colunas };
-    }
-    function mover(dir) {
-        const { linha, coluna } = posicao();
-        if (dir === 'esquerda' || dir === 'direita') {
-            // Enrola DENTRO da linha, e a linha incompleta enrola no tamanho dela, não no da grade.
-            const inicio = linha * colunas;
-            const largura = Math.min(colunas, simbolos.length - inicio);
-            cursor = inicio + enrolar(coluna + (dir === 'direita' ? 1 : -1), largura);
-            return;
-        }
-        cursor = indiceDe(linha + (dir === 'baixo' ? 1 : -1), coluna);
-    }
-    return {
-        simbolos,
-        colunas,
-        linhas,
-        capacidade,
-        indice: () => cursor,
-        posicao,
-        sob: () => simbolos[cursor],
-        mover,
-        irPara(simbolo) {
-            const i = simbolos.indexOf(simbolo);
-            if (i < 0)
-                return false;
-            cursor = i;
-            return true;
-        },
-        digitar() {
-            if (capacidade > 0 && digitado.length >= capacidade)
-                return;
-            digitado += simbolos[cursor];
-        },
-        apagar() { digitado = digitado.slice(0, -1); },
-        limpar() { digitado = ''; },
-        valor: () => digitado,
-        faltam: () => (capacidade > 0 ? capacidade - digitado.length : null),
-        completo: () => capacidade > 0 && digitado.length >= capacidade,
-    };
-}

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

@@ -1,34 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-/** Um campo do esquema: um nome e quantos BITS ele ocupa (⇒ valores de 0 a 2^bits − 1). */
-export interface CampoSenha {
-    readonly nome: string;
-    readonly bits: number;
-}
-export interface CodecSenha {
-    /** Quantos caracteres a senha tem, sem separadores. Constante: toda senha deste esquema tem este tamanho. */
-    readonly comprimento: number;
-    /** Os campos, na ordem em que foram declarados (cópia — quem lê não altera o esquema). */
-    readonly campos: readonly CampoSenha[];
-    /** Empacota os valores. Lança se algum campo faltar ou não couber — ver a nota em `codificar`. */
-    codificar(valores: Readonly<Record<string, number>>): string;
-    /** Desempacota. `null` = senha inválida (comprimento, símbolo, soma ou enchimento). */
-    decodificar(senha: string): Record<string, number> | null;
-}
-/** Crockford base32: sem I, L, O e U. Índice = valor de 5 bits. */
-export declare const ALFABETO = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-/**
- * Cria um codec para o esquema `campos`.
- *
- * ⚠️ LANÇA em esquema malformado, e isso é decisão: um esquema errado é erro de PROGRAMA, e um erro de
- * programa que só aparece como senha estranha três meses depois custa mais caro que um boot que não sobe.
- * É a mesma escolha de `boot/create-game` para a declaração malformada.
- */
-export declare function criarCodec(campos: readonly CampoSenha[]): CodecSenha;
-/**
- * Insere um separador a cada `grupo` caracteres — `'A1B2C3D4'` vira `'A1B2-C3D4'`.
- *
- * É acessibilidade, não enfeite: uma sequência sem grupos é lida caractere a caractere pelo leitor de tela e
- * copiada perdendo o lugar por quem lê da tela para o caderno. `decodificar` ignora o separador, então a
- * senha agrupada e a senha corrida são a MESMA senha — quem digitar sem o traço não é punido por isso.
- */
-export declare function formatar(senha: string, grupo?: number, sep?: string): string;