@the-inclusionist/engine 6.36.1

package/dist-pkg/core/world.js

@@ -0,0 +1,58 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// core/world.ts — Mundo/nível — constrói o grid a partir do TEXTO-GLIFO (assets/levels/clarity.map.txt). Depende
+// só de tiles.ts. O WORLD instanciado + tileAt/wcSolid/gate/rampas ficam no game.js até core/state.js existir.
+import { parseLevel } from './tiles.js';
+const STRUCTURAL_SOLID = new Set([2, 5, 6, 10]);
+const CONVERTIBLE_SOLID = new Set([2, 6]);
+const NEEDS_2H = new Set([1, 3, 4, 7, 8, 10, 11]);
+function expandNarrowPassages(world) {
+    const H = world.length;
+    if (!H)
+        return;
+    const W = world[0].length;
+    const orig = world.map((r) => [...r]);
+    const isAir = (t) => NEEDS_2H.has(t);
+    const walk = Array.from({ length: H }, () => new Array(W).fill(false));
+    for (let ty = 0; ty < H - 1; ty++)
+        for (let tx = 0; tx < W; tx++)
+            if (isAir(orig[ty][tx]) && STRUCTURAL_SOLID.has(orig[ty + 1][tx]))
+                walk[ty][tx] = true;
+    let changed = true, guard = 0;
+    while (changed && guard++ < W + 4) {
+        changed = false;
+        for (let ty = 0; ty < H; ty++)
+            for (let tx = 0; tx < W; tx++) {
+                if (walk[ty][tx] || !isAir(orig[ty][tx]))
+                    continue;
+                if ((tx > 0 && walk[ty][tx - 1]) || (tx < W - 1 && walk[ty][tx + 1])) {
+                    walk[ty][tx] = true;
+                    changed = true;
+                }
+            }
+    }
+    for (let ty = 1; ty < H; ty++)
+        for (let tx = 0; tx < W; tx++)
+            if (walk[ty][tx] && CONVERTIBLE_SOLID.has(orig[ty - 1][tx]))
+                world[ty - 1][tx] = (orig[ty][tx] === 3) ? 3 : 1;
+}
+function buildWorld(rawGrid) {
+    const W = Math.max(...rawGrid.map((r) => r.length)), H = rawGrid.length;
+    const world = [];
+    for (let cy = 0; cy < H; cy++) {
+        const src = rawGrid[cy], row = new Array(W);
+        for (let cx = 0; cx < W; cx++)
+            row[cx] = src[cx] ?? 0;
+        world.push(row);
+    } // vazio à direita → ar escuro (0)
+    expandNarrowPassages(world);
+    if (world[42]?.[53] !== undefined)
+        world[42][53] = 1; // playability fix
+    // E18: itens injetados (fiel à v3 ITEM_PLACEMENTS): 12=super-corrida, 13=ultra-pulo, 14=ventosa
+    for (const [x, y, to] of [[13, 8, 12], [55, 37, 13], [13, 26, 14]])
+        if (world[y]?.[x] !== undefined)
+            world[y][x] = to;
+    return world;
+}
+// Constrói o mundo a partir do texto-glifo (parseLevel -> buildWorld: expand + injeção de itens).
+export function buildWorldFromText(text) { return buildWorld(parseLevel(text)); }
+export { buildWorld };

package/dist-pkg/educational/activities-registry.d.ts

@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+/** One entry of the activities catalog. `cat` drives menu placement + MODE; `d` is the minigame footer text. */
+export interface ActivityDef {
+    /** Menu category: 'ludico' (free play), 'alf' (literacy), 'mat' (math, incl. fractions). */
+    cat: 'ludico' | 'alf' | 'mat';
+    /** Display name (menu button + spoken by TTS). Em pt-BR CRU; só é o texto final quando não há `nomeKey`. */
+    nome: string;
+    /** Chave i18n do nome. Presente em tudo que NÃO é alfabetização — ver a nota de fronteira no cabeçalho. */
+    nomeKey?: string;
+    /** Chave i18n da descrição de rodapé. Mesma regra do `nomeKey`. */
+    dKey?: string;
+    /** Optional example sub-label shown under the name (literacy activities). */
+    sub?: string;
+    /** Optional footer description shown/spoken on menu focus. */
+    d?: string;
+    /** Fraction denominators this activity trains (presence marks it as a fractions activity). */
+    dens?: number[];
+    /** True when the activity needs a "pick numbers" sub-menu (Tabuada/Divisão) before starting. */
+    pick?: true;
+}
+/** Fallback activity id when a stored/requested id is missing or unknown. */
+export declare const DEFAULT_ACTIVITY_ID = "ludico";
+/** True when `id` names a real catalog entry. */
+export declare function isValidActivityId(id: string): boolean;
+/** Same check, spelled as the game.js call sites read it (`ACTIVITIES[id]` truthiness). */
+export declare function hasActivity(id: string): boolean;
+/** The activity definition for `id`, or `undefined` if unknown (mirrors `ACTIVITIES[id]`). */
+export declare function getActivity(id: string): ActivityDef | undefined;
+/** All activity ids, in catalog order. */
+export declare function listActivityIds(): string[];
+/** All [id, def] entries, in catalog order (drives menu builders like buildTitleMenus). */
+export declare function listActivities(): (readonly [string, ActivityDef])[];
+/** A categoria de menu de uma atividade — 'ludico' para tudo que o catálogo não conhece. */
+export type ActivityCat = ActivityDef['cat'];
+/** O vocabulário do MOTOR: como a rodada se comporta. Três valores, e nenhum é um id de atividade. */
+export type GameMode = 'ludico' | 'somasub' | 'silabas';
+/** Categoria de `id`, caindo em 'ludico' para qualquer coisa fora do catálogo. */
+export declare function activityCategory(id: string | null | undefined): ActivityCat;
+/** O MODE do motor para uma categoria — o único ponto onde os dois vocabulários se encontram. */
+export declare function modeForCategory(cat: ActivityCat): GameMode;
+/**
+ * O MODE de uma atividade. É a derivação inteira, num nome só — e é ela que torna impossível, por
+ * construção, o desacordo que a issue #54 reproduziu no jogo publicado: ciclar o `#opt-mode` deixava o MODE
+ * em 'silabas' com a atividade ainda em 'ludico', as moedas nasciam como letras e o despacho do quiz
+ * continuava consultando a categoria antiga.
+ */
+export declare function modeForActivity(id: string | null | undefined): GameMode;

package/dist-pkg/educational/activities-registry.js

@@ -0,0 +1,95 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// educational/activities-registry — the ACTIVITIES catalog: every playable activity's id → metadata
+// (category, display name, sub-label, description, fraction denominators, "pick numbers" flag). This module
+// owns only the CATALOG + id validation — it does NOT hold the current selection (that stays `activity` +
+// `setActivityValue` in core/state.ts, per ADR/plano-modularizacao-mapa).
+//
+// ============================ POR QUE ISTO NÃO MORA EM `game/` (ADR-0032) ============================
+// Isto é CURRÍCULO, não jogo. `alf1..alf5` são as hipóteses da psicogênese de Ferreiro; `mat1..mat6` e as
+// frações são progressão de matemática. Nada disso descreve "The Inclusionist" — descreve o que uma criança
+// precisa aprender, e vale igual em qualquer jogo que queira ensinar a mesma coisa. O ADR-0004 já separava
+// `docs/educational/` como camada de currículo/pedagogia; esta pasta é a metade em CÓDIGO da mesma camada.
+//
+// O destino declarado é a PLATAFORMA EdSP: o catálogo é dela, e cada jogo puxa as atividades que lhe cabem.
+// A EdSP não existe ainda, então o catálogo mora aqui — mas com a FORMA do destino (camada própria, DADOS,
+// nada de `game/` entrando) em vez da forma do lugar onde estava. Ver ADR-0032.
+//
+// ============================ O QUE TRADUZ, E O QUE NÃO (a fronteira, medida) ============================
+// A regra do pilar 3 é ESTREITA, e este arquivo a aplicava ao catálogo inteiro — a exceção comeu a regra, e
+// o efeito era um menu de matemática em português dentro de um jogo em inglês.
+//
+//   · ALFABETIZAÇÃO (`cat: 'alf'`) NÃO TRADUZ. A psicogênese de Ferreiro é sobre a escrita do PORTUGUÊS: a
+//     palavra, a sílaba, a soletração e a cela Braille são A MATÉRIA, não a moldura. `nome`/`sub`/`d` dessas
+//     cinco seguem em pt-BR, crus, fora dos dicionários.
+//   · TODO O RESTO TRADUZ. O CLAUDE.md é explícito: "Matemática NÃO é disciplina de idioma. `2 + 3`
+//     independe de língua". "Tabuada", "Divisão" e "Soma e subtração com meios" nomeiam operações que
+//     existem iguais em qualquer língua, e o lúdico ("Coletar 10 moedas") nem currículo é.
+//
+// MECANICAMENTE: quem traduz declara `nomeKey`/`dKey`; quem não traduz não declara. Este módulo continua sem
+// importar NADA — guarda a CHAVE, e quem resolve é o ponto de exibição (`nomeDaAtividade` em
+// ui/activities-menu), pelo mesmo motivo de `TOUCH_ACT_LABELS` e `PAD_GLYPH_SPOKEN`: uma `const` de módulo é
+// avaliada uma vez no import, e texto já resolvido congelaria o idioma no boot.
+//
+// O gate é `tests/atividades-matematica-traduzem.node.test.js`, e ele vigia os DOIS lados: atividade
+// traduzível sem chave reprova, e atividade de alfabetização COM chave reprova também.
+const ACTIVITIES_DATA = [
+    ['ludico', { cat: 'ludico', nome: 'Coletar 10 moedas', nomeKey: 'act.ludico.nome' }],
+    ['alf1', { cat: 'alf', nome: 'Descobrindo palavras', sub: 'BABA • BOLA • BEBE', d: 'Elaborado para ajudar a superar as hipóteses pré-silábicas.' }],
+    ['alf2', { cat: 'alf', nome: 'Descobrindo sílabas', sub: 'BA • BE • BI', d: 'Feito para ajudar a superar a hipótese silábica sem valor sonoro (uma letra errada por sílaba) e com valor sonoro (vogal ou consoante correta por sílaba), deixando claro que cada som é uma sílaba e cada sílaba tem sua forma correta de escrever.' }],
+    ['alf3', { cat: 'alf', nome: 'Montando palavras', sub: 'BA+BA • BE+BE • BO+LA', d: 'Feito para superar a fase da hipótese silábico-alfabética, desafiando o aluno a encontrar as sílabas corretas para montar a palavra.' }],
+    ['alf4', { cat: 'alf', nome: 'Escrevendo palavras', sub: 'B-A-B-A • B-O-L-A • B-E-B-E', d: 'Atividade com o objetivo de treinar ortografia.' }],
+    ['alf5', { cat: 'alf', nome: 'Escrevendo em Braille', d: 'Escreva letra por letra; o jogo dita os pontos da cela Braille (12 letras).' }],
+    ['mat1', { cat: 'mat', nome: 'Quantidade', d: 'Conte as bolinhas e escolha o número certo (1 a 9).', nomeKey: 'act.mat1.nome', dKey: 'act.mat1.d' }],
+    ['mat2', { cat: 'mat', nome: 'Soma fácil', d: 'Somas com parcelas de 0 a 5.', nomeKey: 'act.mat2.nome', dKey: 'act.mat2.d' }],
+    ['mat3', { cat: 'mat', nome: 'Soma e Subtração 1', d: 'Contas que dá para fazer nos dedos (até 10).', nomeKey: 'act.mat3.nome', dKey: 'act.mat3.d' }],
+    ['mat4', { cat: 'mat', nome: 'Soma e Subtração 2', d: 'Guarde um número na cabeça e opere o outro nos dedos (até 20).', nomeKey: 'act.mat4.nome', dKey: 'act.mat4.d' }],
+    ['mat5', { cat: 'mat', nome: 'Tabuada', pick: true, d: 'Escolha os números e treine a multiplicação.', nomeKey: 'act.mat5.nome', dKey: 'act.mat5.d' }],
+    ['mat6', { cat: 'mat', nome: 'Divisão', pick: true, d: 'Escolha os números e treine a divisão.', nomeKey: 'act.mat6.nome', dKey: 'act.mat6.d' }],
+    ['fr2', { cat: 'mat', nome: 'Soma e subtração com meios', dens: [2], d: 'Some e subtraia meios.', nomeKey: 'act.fr2.nome', dKey: 'act.fr2.d' }],
+    ['fr3', { cat: 'mat', nome: 'Soma e subtração com terços', dens: [3], d: 'Some e subtraia terços.', nomeKey: 'act.fr3.nome', dKey: 'act.fr3.d' }],
+    ['fr42', { cat: 'mat', nome: 'Soma e subtração com quartos e meios', dens: [4, 2], d: 'Some e subtraia quartos e meios.', nomeKey: 'act.fr42.nome', dKey: 'act.fr42.d' }],
+    ['fr5', { cat: 'mat', nome: 'Soma e subtração com quintos', dens: [5], d: 'Some e subtraia quintos.', nomeKey: 'act.fr5.nome', dKey: 'act.fr5.d' }],
+    ['fr632', { cat: 'mat', nome: 'Soma e subtração com sextos, terços e meios', dens: [6, 3, 2], d: 'Some e subtraia sextos, terços e meios.', nomeKey: 'act.fr632.nome', dKey: 'act.fr632.d' }],
+    ['fr2a6', { cat: 'mat', nome: 'Soma e subtração com frações de meio a sextos', dens: [2, 3, 4, 5, 6], d: 'Some e subtraia frações de meios a sextos.', nomeKey: 'act.fr2a6.nome', dKey: 'act.fr2a6.d' }],
+];
+/** Lookup by id — insertion order preserved (buildTitleMenus iterates it in this fixed order). */
+const ACTIVITIES = new Map(ACTIVITIES_DATA);
+/** Fallback activity id when a stored/requested id is missing or unknown. */
+export const DEFAULT_ACTIVITY_ID = 'ludico';
+/** True when `id` names a real catalog entry. */
+export function isValidActivityId(id) {
+    return ACTIVITIES.has(id);
+}
+/** Same check, spelled as the game.js call sites read it (`ACTIVITIES[id]` truthiness). */
+export function hasActivity(id) {
+    return isValidActivityId(id);
+}
+/** The activity definition for `id`, or `undefined` if unknown (mirrors `ACTIVITIES[id]`). */
+export function getActivity(id) {
+    return ACTIVITIES.get(id);
+}
+/** All activity ids, in catalog order. */
+export function listActivityIds() {
+    return [...ACTIVITIES.keys()];
+}
+/** All [id, def] entries, in catalog order (drives menu builders like buildTitleMenus). */
+export function listActivities() {
+    return [...ACTIVITIES.entries()];
+}
+/** Categoria de `id`, caindo em 'ludico' para qualquer coisa fora do catálogo. */
+export function activityCategory(id) {
+    return (getActivity(id ?? '') || {}).cat || 'ludico';
+}
+/** O MODE do motor para uma categoria — o único ponto onde os dois vocabulários se encontram. */
+export function modeForCategory(cat) {
+    return cat === 'alf' ? 'silabas' : cat === 'mat' ? 'somasub' : 'ludico';
+}
+/**
+ * O MODE de uma atividade. É a derivação inteira, num nome só — e é ela que torna impossível, por
+ * construção, o desacordo que a issue #54 reproduziu no jogo publicado: ciclar o `#opt-mode` deixava o MODE
+ * em 'silabas' com a atividade ainda em 'ludico', as moedas nasciam como letras e o despacho do quiz
+ * continuava consultando a categoria antiga.
+ */
+export function modeForActivity(id) {
+    return modeForCategory(activityCategory(id));
+}

package/dist-pkg/i18n/en.d.ts

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+declare const en: Record<string, string>;
+export default en;