@the-inclusionist/engine 8.0.0 → 10.0.0

package/dist-pkg/input/transporte-em-uso.js

@@ -1,130 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// input/transporte-em-uso — A ALTERNÂNCIA SEGUE O APARELHO EM USO (ADR-0109), na metade pura.
-//
-// ========================= O QUE ESTE MÓDULO É =========================
-// O autómato das quatro regras do ADR-0109 §1, sem DOM, sem armazenamento e sem eventos. Recebe ARESTAS com
-// origem e devolve estado; quem pergunta «há alternância agora?» pergunta ao estado.
-//
-//   1. Por padrão, controle e teclado, ambos SEM alternância.
-//   2. Clique de mouse ou toque na tela → controles de tela COM alternância.
-//   3. Apertar tecla devolve o teclado SEM alternância; usar o controle faz o mesmo.
-//   4. Câmera e microfone precisam ser habilitados; habilitados, ligam a alternância em TODOS os outros
-//      controles, SEM possibilidade de desligar. São prioridade.
-//
-// ⚠️ POR QUE ISTO É UM AUTÓMATO E NÃO UM VALOR GUARDADO — e é o que o ADR-0109 supersede do ADR-0104 §C. A
-// alternância era uma ESCOLHA guardada por transporte, e a issue #114 mediu que a fiação dela não era
-// escrevível: a origem da aresta é apagada à porta (`input/state.keys` é `Set<string>` de CÓDIGOS, e o toque
-// e a webcam escrevem lá dentro). O Dev decidiu o COMPORTAMENTO, e o comportamento escolhe o mecanismo.
-//
-// ⚠️ E A REGRA 3 É A RAZÃO DE PRECISAR DE DUAS COISAS, não de uma. «Apertar uma tecla devolve o teclado sem
-// alternância» são DOIS factos: um EVENTO cuja origem tem de ser conhecida, e um MODO que persiste até à
-// troca seguinte. Uma aresta não guarda estado; um modo guardado não detecta a própria troca. Nenhuma metade
-// exprime a regra; juntas exprimem. Este ficheiro é a segunda metade — o MODO.
-//
-// 📌 A imagem do Dev, mantida porque diz a coisa: é um CAPS-LOCK NUM TECLADO COM MEMÓRIA. Modo e não estado
-// momentâneo; lembrado por aparelho; trocar de aparelho não apaga o que o outro lembra.
-/**
- * A UNIÃO COMO VALOR, porque há um sítio onde ela tem de ser verificada em runtime.
- *
- * ⚠️ EXISTE POR CAUSA DE UMA FRONTEIRA, e é a única razão que a justifica: o `input/origem-sintetica` lê o
- * transporte de um EXPANDO pendurado num `KeyboardEvent` — um objecto que este código não construiu e que
- * qualquer script da página pode construir. Um valor que atravessa essa fronteira não é um `Transporte` por
- * o TypeScript o dizer; é uma `string` até alguém a conferir. Sem lista, `'olho'` entrava no mapa de origens
- * como transporte fantasma, e nada o diria.
- *
- * 📌 Não é o defeito da lista-ao-lado-da-união que este repositório já desfez três vezes (o `RM_KEYS`, os
- * rótulos de movimento reduzido, as chaves de armazenamento), porque a guarda abaixo é do COMPILADOR: as duas
- * não podem divergir. Uma cópia que não pode divergir é uma projecção, não uma segunda fonte.
- */
-export const TRANSPORTES = ['teclado', 'gamepad', 'toque', 'olhos', 'rosto', 'gestos', 'fala'];
-const _COBRE_OS_TRANSPORTES = true;
-void _COBRE_OS_TRANSPORTES;
-/**
- * Isto que veio de fora é mesmo um transporte?
- *
- * ⚠️ A pergunta não é de segurança — os scripts desta página são todos da casa, e quem quisesse mentir usaria
- * um valor VÁLIDO. É de correcção: impede que um carimbo errado ou ausente vire uma entrada silenciosa no
- * `origemDaTecla`, que é a estrutura de que a alternância inteira depende.
- */
-export function ehTransporte(v) {
-    return typeof v === 'string' && TRANSPORTES.includes(v);
-}
-/**
- * OS QUATRO QUE EXIGEM HABILITAÇÃO EXPLÍCITA e, uma vez habilitados, mandam em todos (regra 4).
- *
- * ⚠️ É a mesma lista do `UM_COMANDO_DE_CADA_VEZ` do `input/latch-scope`, e a coincidência não é acaso: são
- * os transportes de quem NÃO CONSEGUE SEGURAR NADA. O que o ADR-0109 acrescenta é que eles não ligam a
- * alternância só para si — ligam-na para o resto, porque quem usa a webcam pode também tocar na tela, e uma
- * alternância que se desliga ao mudar de aparelho é uma armadilha para exactamente essa pessoa.
- */
-export const EXIGEM_HABILITACAO = new Set(['olhos', 'rosto', 'gestos', 'fala']);
-/** O transporte que liga a alternância por si só, sem prioridade nenhuma envolvida (regra 2). */
-export const COM_ALTERNANCIA_PROPRIA = new Set(['toque']);
-/**
- * O ESTADO INICIAL: teclado, sem alternância.
- *
- * ⚠️ A regra 1 diz «controle E teclado, ambos sem alternância», e é por isso que o padrão pode nomear um só
- * sem mentir: entre os dois a resposta à única pergunta que este módulo faz — há alternância? — é a MESMA.
- * O `emUso` só passa a distingui-los quando alguém quiser MOSTRAR o aparelho corrente, que é outra questão
- * e o ADR-0109 deixa-a explicitamente por decidir.
- */
-export const PADRAO = Object.freeze({ emUso: 'teclado', assistidaLigada: false });
-/**
- * HÁ ALTERNÂNCIA AGORA? — ⚠️ **NÃO PERGUNTE ISTO A ESTA FUNÇÃO.** Ver o parágrafo abaixo.
- *
- * ⚠️ A prioridade da assistida vem PRIMEIRO, e a ordem é a regra 4 inteira: enquanto ela estiver ligada,
- * nenhum outro aparelho a desliga — nem o teclado, que noutro caso a desligaria. Inverter estas duas linhas
- * é o defeito que trancaria uma criança fora do próprio jogo, e é silencioso.
- *
- * @deprecated 🔴 **ESTA FUNÇÃO IMPLEMENTA O MODELO QUE O ADR-0113 SUPERSEDEU**, e fica exportada por ser
- * superfície publicada (`./input/*.js`) e por o registo ter valor histórico — não por ser a resposta.
- *
- * O ADR-0109 decidia a alternância **só pelo aparelho**: assistida ligada → sim; toque → sim; todo o resto
- * → não. O ADR-0113 retirou essa cláusula, com a razão do Dev: a alternância é um **caps-lock guardado com
- * o mapeamento do controle**, e o valor que a criança gravou vale.
- *
- * 🔴 A DIVERGÊNCIA TEM UMA CRIANÇA CONCRETA, e é a que motivou o registo: quem tem dificuldade motora, joga
- * no TECLADO e gravou a alternância ligada. Esta função devolve `false` para ela — `teclado` não está em
- * `COM_ALTERNANCIA_PROPRIA` — e é exactamente o controle que lhe seria retirado. O `latch-scope.alternanciaDe`
- * devolve `true`, porque lê o que ela gravou.
- *
- * ⚠️ E A CLÁUSULA DO TOQUE TAMBÉM CAIU: sob o ADR-0113 o toque é um transporte como os outros — o valor dele
- * é escolha e fica guardado. Só olhos, rosto, gestos e fala podem recusar-se a DESLIGAR, e essa metade vive
- * em `latch-scope.alternanciaSempreLigada`, com um conjunto diferente deste e a responder a outra pergunta.
- *
- * **A resposta certa é `latch-scope.alternanciaDe(estado.emUso, leitura)`.** O papel que sobra a este
- * módulo é o que o nome dele diz: QUAL transporte está em uso — que é o que alimenta aquele primeiro
- * argumento. `tests/alternancia-por-transporte.node.test.js` afirma que esta função continua sem consumidor.
- */
-export function alternanciaAgora(estado) {
-    if (estado.assistidaLigada)
-        return true;
-    return COM_ALTERNANCIA_PROPRIA.has(estado.emUso);
-}
-/**
- * UMA ARESTA CHEGOU, com a sua origem. Devolve o estado NOVO.
- *
- * ⚠️ Uma aresta de um transporte assistido NÃO o habilita. Habilitar é um acto explícito (regra 4: «precisam
- * ser habilitados»), e deixar uma aresta fazê-lo significaria que um falso positivo da webcam — uma sombra,
- * um segundo rosto a passar — trancava a alternância de toda a gente sem ninguém ter pedido.
- */
-export function aposAresta(estado, origem) {
-    if (estado.emUso === origem)
-        return estado; // sem mudança: devolve o MESMO objecto, não uma cópia
-    return { emUso: origem, assistidaLigada: estado.assistidaLigada };
-}
-/** A criança (ou quem a acompanha) habilitou câmera/microfone. Daqui em diante a alternância é lei. */
-export function habilitarAssistida(estado) {
-    return estado.assistidaLigada ? estado : { emUso: estado.emUso, assistidaLigada: true };
-}
-/**
- * DESABILITAR a assistida. Existe, e o ADR-0109 diz de quem é: NÃO é da criança durante a partida.
- *
- * ⚠️ Fica exportada porque desligar a câmera tem de ser possível em algum lugar — trocar de utilizador,
- * fechar o jogo, um adulto a reconfigurar. O que o §4 proíbe é oferecê-la como um botão ao lado do jogo.
- * Uma função que existe e não é oferecida é diferente de uma função que não existe: a primeira diz onde a
- * decisão mora.
- */
-export function desabilitarAssistida(estado) {
-    return estado.assistidaLigada ? { emUso: estado.emUso, assistidaLigada: false } : estado;
-}

package/dist-pkg/platform/audio-nav.d.ts

@@ -1,51 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-import type { PlayerView, ControlledPlayer } from '../core/entity.js';
-import type { AudioSonar, PlayerAudioOut, PlayerCtxOut } from './audio-sonar.js';
-export type { PlayerCtxOut };
-/**
- * O jogador visto pela BENGALA e pelo NADO. `facing` e `wnT` são desta metade; a outra não os usa.
- *
- * A saída dedicada (`_ac`/`_acOut`) entra por INTERSECÇÃO com o tipo do dono, `PlayerAudioOut` de
- * `platform/audio-sonar` — não por uma redeclaração local.
- *
- * ⚠️ A JUSTIFICATIVA QUE ESTAVA AQUI ERA FALSA e vale corrigi-la em vez de apagá-la, senão o próximo leitor
- * a re-deriva: dizia que `core/` "não pode importar tipos de Web Audio". Não há importação a fazer — o
- * `tsconfig.json` tem `"lib": ["ES2022", "DOM", "DOM.Iterable"]`, então `AudioContext` e `GainNode` são
- * globais ambientes em qualquer arquivo desta árvore. O motivo verdadeiro é de CAMADA: `_ac` e `_acOut` não
- * são da entidade da engine, e por isso o `core/entity` deixou de mencioná-los (ADR-0039, opção A1).
- */
-type Player = PlayerView<'x' | 'y' | 'facing' | 'viz' | 'i' | 'audioSink' | 'wnT' | 'pad'> & PlayerAudioOut & Pick<ControlledPlayer, 'ctrl'>;
-export interface AudioNavCtx {
-    tileAt: (x: number, y: number) => number;
-    solidAt: (x: number, y: number) => boolean;
-    held: (pl: Player, act: string) => boolean;
-    tonePan: (freq: number, dur: number, cat: string, pan?: number | null, vol?: number, type?: OscillatorType, pc?: PlayerCtxOut | null) => void;
-    noiseHit: (mat: string, pan?: number, pc?: PlayerCtxOut | null) => void;
-    BOX: {
-        w: number;
-        h: number;
-    };
-    TILE: number;
-    getCenario: () => string;
-    /**
-     * A NAVEGAÇÃO SONORA, pronta (`platform/audio-sonar`). Entra por injeção e não por importação: é o que
-     * permite empacotar o sonar sem levar a bengala junto — e é a diferença entre "dois arquivos" e "dois
-     * módulos". Onze coisas do ctx antigo saíram com ela.
-     */
-    sonar: AudioSonar;
-}
-export interface AudioNav {
-    playerCtx: (pl: Player) => PlayerCtxOut | null;
-    caneProbe: (pl: Player) => string;
-    caneTap: (pl: Player) => void;
-    waterNav: (pl: Player) => void;
-    panFor: (wx: number, pl: Player) => number;
-    needsAudioCues: (pl: Player) => boolean;
-    sonar: (pl: Player) => void;
-    updateGuide: () => void;
-    readonly caneCount: number;
-    readonly waterNavCount: number;
-    readonly sonarCount: number;
-    readonly guideCount: number;
-}
-export declare function createAudioNav(ctx: AudioNavCtx): AudioNav;

package/dist-pkg/platform/audio-nav.js

@@ -1,99 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// platform/audio-nav — BENGALA e NADO CEGO: as pistas sonoras que só existem onde há MUNDO (item 19).
-//
-// ========================= ESTE MÓDULO ERA DOIS =========================
-// O achado 9 do segundo consumidor: "o módulo é DOIS módulos com um nome só — `caneProbe`/`caneTap`/
-// `waterNav` são bengala e natação, isto é, plataforma; `sonar`/`panFor`/`needsAudioCues` são navegação
-// sonora, que serve a qualquer jogo". A navegação sonora saiu para `platform/audio-sonar` e recebe o
-// CONTRATO em vez de tiles; aqui ficou a metade que lê o mundo, e que lê sem disfarce.
-//
-// O QUE SOBROU É PLATAFORMA, e é bom que o nome não esconda isso:
-//   caneProbe(pl) — material À FRENTE (água/vazio/madeira/chão do tema), lendo tile e chão.
-//   caneTap(pl)   — batida da bengala no material adiante (ou tom grave oco no vazio).
-//   waterNav(pl)  — nado cego: contato com paredes/chão/superfície (cordas).
-//
-// A bengala precisa de `facing`, `BOX.w` e `TILE` para saber o que é "à frente"; o nado precisa de `solidAt`
-// em três alturas. Nada disso é traduzível para um jogo sem corpo e sem mundo, e por isso NÃO foi traduzido:
-// o corte separa o que viaja do que não viaja, em vez de fingir que tudo viaja.
-//
-// ========================= A METADE QUE VIAJOU CONTINUA SAINDO DAQUI =========================
-// `playerCtx`, `panFor`, `needsAudioCues`, `sonar` e `updateGuide` seguem no retorno, delegados ao
-// `AudioSonar` injetado. Não é preguiça de mexer no chamador: a bengala PRECISA do `playerCtx` (a batida sai
-// no dispositivo do jogador) e o `main.js` monta um objeto só de navegação. O que mudou é que este módulo
-// deixou de IMPLEMENTAR a metade genérica — ele a repassa, e quem quiser só ela importa o outro arquivo.
-// Extraído do game.js. Ver docs/5-Refactoring/plano-modularizacao-mapa.md (Tier 2, áudio rodada 3).
-export function createAudioNav(ctx) {
-    const SURF_MAT = { cidade: 'piso', campo: 'grama', floresta: 'grama', cemiterio: 'terra', espaco: 'pedra', classico: 'pedra' }; // chão por tema
-    let _caneCount = 0, _waterNavCount = 0;
-    const som = ctx.sonar; // a metade que viaja, injetada
-    const playerCtx = (pl) => som.playerCtx(pl);
-    function caneProbe(pl) {
-        const dir = pl.facing < 0 ? -1 : 1;
-        const ax = Math.floor((pl.x + dir * (ctx.BOX.w / 2 + ctx.TILE * 0.6)) / ctx.TILE), footTy = Math.floor((pl.y + 1) / ctx.TILE);
-        if (ctx.tileAt(ax, footTy) === 3 || ctx.tileAt(ax, footTy - 1) === 3)
-            return 'agua'; // água à frente
-        let gty = -1;
-        for (let ty = footTy; ty <= footTy + 1; ty++) {
-            if (ctx.solidAt(ax, ty)) {
-                gty = ty;
-                break;
-            }
-        } // chão (pé ou 1 abaixo = degrau/rampa)
-        if (gty < 0)
-            return 'vazio'; // sem chão → fosso
-        if (ctx.tileAt(ax, gty) === 4)
-            return 'madeira'; // escada
-        return SURF_MAT[ctx.getCenario()] || 'pedra';
-    }
-    function caneTap(pl) {
-        const mat = caneProbe(pl), dir = pl.facing < 0 ? -1 : 1, pan = dir * 0.5, pc = playerCtx(pl);
-        _caneCount++;
-        if (mat === 'vazio') {
-            ctx.tonePan(150, 0.18, 'guard', pan, 0.16, 'sine', pc);
-            return;
-        } // vazio = tom grave oco
-        ctx.noiseHit(mat, pan, pc); // batida no material adiante (no dispositivo do jogador)
-    }
-    function waterNav(pl) {
-        // dir tipado como number (não 1|-1) DE PROPÓSITO: o original usa `dir!==0` (sempre true aqui, pois facing é ±1) —
-        // preservo essa guarda sempre-verdadeira exatamente; alargar o tipo satisfaz o tsc sem mudar o comportamento.
-        const dir = pl.facing < 0 ? -1 : 1, tx = Math.floor(pl.x / ctx.TILE), tyF = Math.floor((pl.y - 1) / ctx.TILE), tyH = Math.floor((pl.y - ctx.BOX.h) / ctx.TILE);
-        const wallAhead = ctx.solidAt(tx + dir, tyF) || ctx.solidAt(tx + dir, tyH); // parede lateral (azulejo)
-        const floorBelow = ctx.solidAt(tx, tyF + 1); // chão (fundo)
-        const openAbove = ctx.tileAt(tx, tyH - 1) !== 3 && !ctx.solidAt(tx, tyH - 1); // acima da cabeça é ar → dá p/ subir/sair
-        const moving = (dir !== 0) || ctx.held(pl, 'up') || ctx.held(pl, 'down'), pc = playerCtx(pl);
-        pl.wnT = (pl.wnT || 0) + 1;
-        if (pl.wnT < 18)
-            return;
-        let played = true;
-        if (openAbove && wallAhead)
-            ctx.noiseHit('parede', dir * 0.5, pc); // superfície + parede = batida (fim da corda)
-        else if (openAbove && moving)
-            ctx.tonePan(560, 0.09, 'guide', dir * 0.4, 0.12, 'sine', pc); // corda livre: "dá p/ subir"
-        else if (wallAhead && dir !== 0)
-            ctx.noiseHit('parede', dir * 0.5, pc); // parede submersa à frente
-        else if (floorBelow && ctx.held(pl, 'down'))
-            ctx.noiseHit('areia', 0, pc); // fundo (chão)
-        else
-            played = false;
-        if (played) {
-            pl.wnT = 0;
-            _waterNavCount++;
-        }
-        else
-            pl.wnT = 17; // sem contato = SEM som (pronto p/ tocar ao encostar)
-    }
-    return {
-        playerCtx, caneProbe, caneTap, waterNav,
-        // Delegação PURA para a metade que viajou. Sem lógica no meio: um adaptador que decidisse alguma coisa
-        // seria uma terceira implementação escondida entre as duas.
-        panFor: (wx, pl) => som.panFor(wx, pl),
-        needsAudioCues: (pl) => som.needsAudioCues(pl),
-        sonar: (pl) => som.sonar(pl),
-        updateGuide: () => som.updateGuide(),
-        get caneCount() { return _caneCount; },
-        get waterNavCount() { return _waterNavCount; },
-        get sonarCount() { return som.sonarCount; },
-        get guideCount() { return som.guideCount; },
-    };
-}

package/dist-pkg/platform/pesados-catalogo.d.ts

@@ -1,14 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-/** Uma coisa pesada que a engine promete e que não cabe no pacote. */
-export interface Pesado {
-    readonly id: string;
-    /** `null` = decidido que existe, mas ainda não há de onde vir. Ver `porQueNaoTemFonte`. */
-    readonly url: string | null;
-    /** Medido, não estimado — é o número que uma frase honesta usa antes de começar a descarga. */
-    readonly bytes?: number;
-    /** Obrigatório quando `url` é `null`: uma ausência sem razão escrita vira uma ausência esquecida. */
-    readonly porQueNaoTemFonte?: string;
-}
-/** O nome da Cache Storage. Versionado: mudar o conteúdo do catálogo não deve servir bytes velhos. */
-export declare const CACHE_PESADOS = "incl-pesados-v1";
-export declare const PESADOS: readonly Pesado[];

package/dist-pkg/platform/pesados-catalogo.js

@@ -1,177 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// platform/pesados-catalogo.ts — O QUE É PESADO, DE ONDE VEM, E QUANTO PESA.
-//
-// 📌 SEPARADO DO BUSCADOR de propósito: a lista é DADO e muda por decisão registada; o buscador é regra e
-// muda por defeito encontrado. Juntos, cada correcção de uma URL mexeria no ficheiro que decide a ordem das
-// descargas, e cada correcção da ordem mexeria na lista que um registo governa.
-//
-// ========================= 🔴 A PRIMEIRA VERSÃO DESTE FICHEIRO COMETEU O DEFEITO QUE ELE SERVE =========================
-// Ela escrevia o host à mão (`const HF = 'https://huggingface.co/…'`), a lista das quatro vozes outra vez, e
-// uma segunda derivação do caminho `idioma/locale/nome/qualidade/…`. As três coisas JÁ EXISTEM no
-// `platform/voice-plan.ts`, que o ADR-0114 designou como o sítio ÚNICO onde o host é nomeado — e cujo próprio
-// comentário nomeia as três vezes que este repositório pagou por tabelas duplicadas (o `DomQuery`, os rótulos
-// de movimento reduzido, as chaves de armazenamento).
-//
-// 📏 QUEM APANHOU FOI O INVENTÁRIO, e não pela duplicação: o `nada-vem-de-fora` recusou uma URL nova sem razão
-// escrita. A URL era só a PROVA; declará-la teria feito o gate ficar verde com a duplicação lá dentro. ⚠️ É a
-// razão de a saída ser APAGAR a cópia e não desculpá-la — declarar duas vezes o mesmo endereço é precisamente
-// a cláusula que o `nada-de-cdn-a-mao` conta com um número.
-import { VOZES_NEURAIS, urlDoModelo, urlDaConfig } from './voice-plan.js';
-/** O nome da Cache Storage. Versionado: mudar o conteúdo do catálogo não deve servir bytes velhos. */
-export const CACHE_PESADOS = 'incl-pesados-v1';
-/**
- * O PESO DE CADA VOZ, MEDIDO EM 2026-09-09 e não estimado — `Content-Length` do modelo e corpo da configuração.
- *
- * 📌 O PESO MORA AQUI E O ENDEREÇO MORA NO `voice-plan`, e a divisão não é arrumação: o `voice-plan` responde
- * «que vozes a engine garante e onde estão», que é decisão do ADR-0110; isto responde «quanto custa descê-las
- * hoje», que é uma medição com data e que muda quando o fornecedor recomprime um ficheiro.
- *
- * ⚠️ UMA VOZ NOVA NO `voice-plan` SEM MEDIÇÃO AQUI FICA SEM `bytes`, e o aviso de «faltam N MB» passaria a
- * sub-reportar em silêncio. É por isso que o gate exige `bytes > 0` em toda entrada de voz COM url: o buraco
- * é pequeno e mudo, que é a forma de defeito que este repositório persegue.
- */
-const PESO_MEDIDO = Object.freeze({
-    'pt_BR-faber-medium': { modelo: 63_201_294, config: 4_855 },
-    'en_US-ryan-medium': { modelo: 63_201_294, config: 4_883 },
-    'en_US-amy-medium': { modelo: 63_201_294, config: 4_882 },
-    'es_MX-claude-high': { modelo: 63_122_309, config: 4_963 },
-});
-/**
- * ⚠️ O `urlDoModelo` devolve `null` para um identificador que não se deixe ler, e a razão viaja com a entrada
- * em vez de a entrada desaparecer. Uma URL inventada dá 404 na escola; um `null` COM razão dá para reportar
- * antes de sair de casa, que é a regra que o `voice-plan` já escreve na própria função.
- */
-const RAZAO_ID_TORTO = 'o identificador da voz não tem a forma `locale-nome-qualidade`, então o caminho no '
-    + 'fornecedor não se deixa derivar. Corrija o identificador no `platform/voice-plan.ts`.';
-/**
- * AS DUAS ENTRADAS DE UMA VOZ. ⚠️ SÃO DUAS E NÃO UMA: o `.onnx` é o modelo e o `.onnx.json` é a configuração,
- * e o piper recusa-se a falar sem a segunda. Um catálogo que só trouxesse a primeira produziria uma voz
- * «baixada» que não fala — que é pior do que uma voz em falta, porque a primeira parece resolvida.
- */
-function entradasDaVoz(v) {
-    const peso = PESO_MEDIDO[v.voice];
-    return [
-        { id: `voz:${v.voice}`, url: urlDoModelo(v), bytes: peso?.modelo, porQueNaoTemFonte: RAZAO_ID_TORTO },
-        { id: `voz:${v.voice}:cfg`, url: urlDaConfig(v), bytes: peso?.config, porQueNaoTemFonte: RAZAO_ID_TORTO },
-    ];
-}
-/**
- * O RUNTIME DE VISÃO — **MediaPipe**, decidido pelo Dev em 2026-09-09 (ADR-0124): «piper-tts, mediapipe
- * (webgazer não), e LPCP: devem acompanhar a engine».
- *
- * 🔴 ESTA ENTRADA DIZIA «a #129 ainda não escolheu o fornecedor» DEPOIS DE ELE TER ESCOLHIDO, e a linha
- * sobreviveu ao registo que a contradizia. Não era só trabalho em falta: era uma afirmação FALSA a dirigir
- * quem a lesse para uma issue já fechada. O Dev teve de perguntar três vezes.
- *
- * 📏 MEDIDO EM 2026-09-09, como as vozes e no mesmo minuto: os três ficheiros respondem 200 em jsDelivr com
- * `Access-Control-Allow-Origin: *`, na versão FIXADA — 155 439 + 323 377 + 11 756 954 bytes.
- *
- * ⚠️ CDN FIXADA É PERMITIDA E O ADR-0116 DIZ PORQUÊ: o que o pilar 8 proíbe é depender da rede DEPOIS do
- * primeiro dia. Isto desce na INSTALAÇÃO, com o resto — e é a diferença inteira para o WebGazer, que busca
- * quando a criança liga o controle por olhar, logo a máquina que nunca o ligou fica sem ele para sempre.
- * 📌 A versão vai na URL, que é o que o `check:precache` exige de qualquer entrada externa: bytes diferentes
- * chegam por endereço diferente, e uma entrada fixada nunca congela.
- *
- * 🎯 SÃO OS TRÊS FICHEIROS E NÃO SÓ O `.wasm`: o `vision_bundle.mjs` é quem o carrega e o
- * `vision_wasm_internal.js` é a cola do Emscripten. Baixar o wasm sozinho é a mesma armadilha do `.onnx` sem
- * o `.onnx.json` — uma coisa «baixada» que não corre.
- *
- * ⬜ O que continua por fazer é a FIAÇÃO (issue #11): estes bytes descem e ainda ninguém os lê. O
- * `tests/o-que-desce-tem-quem-leia.node.test.js` é onde essa dívida está declarada.
- */
-const MP = 'https://cdn.jsdelivr.net/npm/@mediapipe/tasks-vision@1.0.1';
-const MP_MODELOS = 'https://storage.googleapis.com/mediapipe-models';
-/**
- * 🔴 A PRIMEIRA VERSÃO DESTA LISTA TRAZIA O RUNTIME E NENHUM MODELO, e o Dev apanhou-o ao perguntar o que
- * tinha ficado de fora. 11,7 MB de WebAssembly sem um `.task` não reconhecem coisa nenhuma — é o `.onnx` sem
- * o `.onnx.json` outra vez, no ficheiro que escreve essa lição doze linhas acima.
- *
- * 📏 MEDIDOS EM 2026-09-09, todos 200 com CORS aberto. `float16` e não `float32`: metade do peso, e a precisão
- * que se perde é irrelevante para dizer onde está um íris num ecrã de 320×180.
- */
-const MEDIAPIPE = Object.freeze([
-    { id: 'visao:runtime', url: `${MP}/vision_bundle.mjs`, bytes: 155_439 },
-    { id: 'visao:runtime:cola', url: `${MP}/wasm/vision_wasm_internal.js`, bytes: 323_377 },
-    { id: 'visao:runtime:wasm', url: `${MP}/wasm/vision_wasm_internal.wasm`, bytes: 11_756_954 },
-    { id: 'visao:modelo:rosto', url: `${MP_MODELOS}/face_landmarker/face_landmarker/float16/1/face_landmarker.task`, bytes: 3_758_596 },
-    { id: 'visao:modelo:gestos', url: `${MP_MODELOS}/gesture_recognizer/gesture_recognizer/float16/1/gesture_recognizer.task`, bytes: 8_373_440 },
-    { id: 'visao:modelo:maos', url: `${MP_MODELOS}/hand_landmarker/hand_landmarker/float16/1/hand_landmarker.task`, bytes: 7_819_105 },
-]);
-/**
- * O WEBGAZER — **volta em 2026-09-09, ao lado do MediaPipe** (ADR-0132): «Traga o WebGazer de volta. Vamos
- * usar ambos.»
- *
- * 🎯 ELES NÃO SE SOBREPÕEM ONDE IMPORTA, e é essa medição que produziu a decisão: o MediaPipe diz ONDE O ÍRIS
- * ESTÁ — `FACE_LANDMARKS_LEFT_IRIS` são conjuntos de conexões sobre marcos —, e o WebGazer diz PARA ONDE A
- * CRIANÇA OLHA NO ECRÃ, que é um modelo de regressão com calibração. Nenhuma das quinze tarefas do
- * `tasks-vision` faz a segunda.
- *
- * ⚠️ E O DEFEITO DELE NUNCA FOI O FORNECEDOR: era ser PREGUIÇOSO. Buscado quando a criança liga o controle
- * por olhar, a máquina que nunca o ligou fica sem ele, e numa escola sem rede não acontece nada — sem erro e
- * sem explicação. Aqui desce na INSTALAÇÃO com tudo o resto, e o defeito desaparece com a capacidade intacta.
- * 📌 Fica a dívida que o ADR-0132 nomeia: o `<script src>` do `ui/webcam.ts` tem de sair no mesmo commit em
- * que a fiação o ler daqui, senão passam a existir dois caminhos para o mesmo ficheiro.
- */
-const WEBGAZER = Object.freeze([
-    { id: 'visao:olhar', url: 'https://webgazer.cs.brown.edu/webgazer.js', bytes: 1_895_169 },
-]);
-/**
- * O RUNTIME DE VOZ — **piper**, decidido no ADR-0127, e o Dev disse para que serve: «PiperTTS é o que será
- * usado para ler para o usuário. Precisa ser carregado com a engine».
- *
- * 🔴 ATÉ AQUI ELE SÓ CHEGAVA PELA PORTA DO CARTUCHO (ADR-0094), e três dos seis jogos não a declaram — nesses,
- * a engine descarregava 241 MB de modelos e não tinha com que os tocar. Descer os modelos sem o motor é a
- * mesma armadilha do `.onnx` sem o `.onnx.json`, um nível acima.
- *
- * 📏 MEDIDO EM 2026-09-09 em jsDelivr, versões FIXADAS, todos 200 com `Access-Control-Allow-Origin: *`.
- * ⚠️ SÃO CINCO FICHEIROS E NÃO UM: o `piper-tts-web.js` é só a entrada (23 KB) — os dois pedaços com hash no
- * nome são o corpo e a tabela de vozes, e o `onnxruntime-web` é quem corre o modelo. Trazer só a entrada dá
- * um módulo que importa o que não está lá.
- * 📌 `ort-wasm-simd-threaded` e não o `jsep`: o jsep é o caminho WebGPU e pesa 21,7 MB contra 11,2 — e o
- * hardware do pilar 1 não é onde a WebGPU se ganha.
- */
-const PP = 'https://cdn.jsdelivr.net/npm/@mintplex-labs/piper-tts-web@1.0.5/dist';
-const ORT = 'https://cdn.jsdelivr.net/npm/onnxruntime-web@1.20.1/dist';
-const PIPER = Object.freeze([
-    { id: 'voz:runtime', url: `${PP}/piper-tts-web.js`, bytes: 23_646 },
-    { id: 'voz:runtime:corpo', url: `${PP}/piper-o91UDS6e.js`, bytes: 158_217 },
-    { id: 'voz:runtime:tabela', url: `${PP}/voices_static-D_OtJDHM.js`, bytes: 147_377 },
-    { id: 'voz:runtime:ort', url: `${ORT}/ort.min.js`, bytes: 446_284 },
-    { id: 'voz:runtime:ort-wasm', url: `${ORT}/ort-wasm-simd-threaded.wasm`, bytes: 11_246_032 },
-]);
-export const PESADOS = Object.freeze([
-    ...VOZES_NEURAIS.flatMap(entradasDaVoz),
-    ...PIPER,
-    /*
-     * 🔴 O RUNTIME DE VISÃO — decidido e SEM FONTE, e a ausência é medida.
-     *
-     * A issue #11 diz «MediaPipe» e o `ui/webcam.ts` faz WebGazer, buscado de `webgazer.cs.brown.edu` por um
-     * `<script src>` com preguiça no PRIMEIRO USO — sem SRI, sem `crossorigin`, e a falhar em silêncio numa
-     * escola sem rede. `git grep -i mediapipe` em `app/js` devolve ZERO (ADR-0119).
-     *
-     * ⚠️ NÃO PONHO AQUI A URL DO WEBGAZER. Trocar o fornecedor é decisão da #129, e escrevê-la aqui seria
-     * decidi-la de lado — a mesma coisa que o ADR-0119 apanhou: um subsistema que a engine DECLARA possuir e
-     * que na prática é outra coisa.
-     */
-    ...MEDIAPIPE,
-    ...WEBGAZER,
-    /*
-     * 🔴 O ACERVO DE ARTE — a quarta coisa pesada do ADR-0119, e a única SEM FONTE. Medido: `art/` tem DOIS
-     * ficheiros — um README e um `ATTRIBUTION.csv` de 40 bytes, só o cabeçalho. Zero arte.
-     *
-     * ⚠️ ATÉ 2026-09-09 ESTA LINHA CULPAVA A COISA ERRADA. Dizia que a quarentena estava vazia e que a arte
-     * era CC BY-SA 3.0 com autoria por recurso — descrevendo o Liberated Pixel Cup, que o ADR-0133 recusou:
-     * os dois braços dele são share-alike ou GPL, e nenhum está na lista fechada de quatro licenças.
-     *
-     * 📌 A razão de continuar sem fonte MUDOU e é mais simples: não há acervo escolhido. A arte entra sob
-     * CC0, CC BY 3.0, CC BY 4.0 ou OGA-BY, com uma linha de livro por recurso e a URL da origem — e nada
-     * disso é uma URL única que um buscador possa pedir. A fonte desta linha é o dia em que houver acervo.
-     */
-    {
-        id: 'arte:acervo',
-        url: null,
-        porQueNaoTemFonte: 'não há acervo escolhido: `art/` tem só README e cabeçalho do CSV. O ADR-0133 fechou '
-            + 'a lista em CC0, CC BY 3.0/4.0 e OGA-BY, e a arte entra recurso a recurso com autoria e URL de '
-            + 'origem — não por uma URL solta que este buscador possa pedir.',
-    },
-]);

package/dist-pkg/platform/pesados.d.ts

@@ -1,31 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-import { CACHE_PESADOS, PESADOS, type Pesado } from './pesados-catalogo.js';
-export { CACHE_PESADOS, PESADOS };
-export type { Pesado };
-/** O que aconteceu com cada entrada, para quem chama poder dizê-lo a uma pessoa. */
-export interface RelatorioPesado {
-    readonly id: string;
-    readonly estado: 'ja-tinha' | 'baixado' | 'falhou' | 'sem-fonte';
-    readonly bytes?: number;
-    readonly erro?: string;
-}
-export interface OpcoesDosPesados {
-    /** `caches` do navegador. Injectado para o gate não precisar de um. */
-    readonly cacheStorage?: CacheStorage;
-    /** `fetch`. Injectado pela mesma razão. */
-    readonly buscar?: typeof fetch;
-    /** Chamado a cada entrada resolvida — é o que deixa a interface dizer o que está a acontecer. */
-    readonly aoProgredir?: (r: RelatorioPesado) => void;
-    /** Só estas ids, se dado. Serve ao consumidor que quer as vozes e não o resto. */
-    readonly apenas?: readonly string[];
-}
-/**
- * BAIXA O QUE FALTA, UM DE CADA VEZ, E DEVOLVE O QUE ACONTECEU COM CADA UM.
- *
- * ⚠️ AS ENTRADAS SEM `url` NÃO SÃO SALTADAS EM SILÊNCIO — devolvem `sem-fonte`. É a diferença entre «este
- * subsistema ainda não tem de onde vir» e «este subsistema está tratado», e é exactamente a distinção que o
- * ADR-0119 mediu em falta: a engine PROMETIA quatro coisas e entregava uma, sem nada a dizê-lo.
- */
-export declare function baixarPesados(opcoes?: OpcoesDosPesados): Promise<RelatorioPesado[]>;
-/** O peso do que ainda falta, em bytes — para um aviso poder dizer «faltam 241 MB» antes de começar. */
-export declare function pesoPorBaixar(relatorio: readonly RelatorioPesado[]): number;

package/dist-pkg/platform/pesados.js

@@ -1,75 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// platform/pesados.ts — AS COISAS PESADAS, BAIXADAS NO PRIMEIRO CARREGAMENTO (ADR-0110, ADR-0116, ADR-0119).
-//
-// ========================= O QUE ISTO É =========================
-// O pilar 8 diz «PWA no primeiro dia ONLINE, depois OFFLINE-FIRST», e o ADR-0116 tirou a contradição que
-// travava isto: instalar já é um acto de rede, logo buscar na instalação não viola nada. O que faltava era
-// alguém a buscar.
-//
-// 📏 MEDIDO EM 2026-09-09, e é o estado que este ficheiro existe para mudar: das quatro coisas pesadas que a
-// engine promete (fontes · voz neural · runtime de visão · arte do LCP), só as FONTES viajavam de verdade.
-// As vozes eram porta do cartucho, o runtime de visão era um `<script src>` de CDN buscado com preguiça no
-// PRIMEIRO USO, e a arte do LCP não existe.
-//
-// ⚠️ E ISTO NÃO BLOQUEIA O JOGO. A criança joga enquanto os 241 MB descem; o que não pode acontecer é ela
-// chegar ao segundo dia, sem rede, e descobrir que a voz nunca foi buscada.
-//
-// ========================= AS TRÊS REGRAS QUE A FORMA IMPÕE =========================
-//  1. **UM DE CADA VEZ.** Quatro descargas de 60 MB em paralelo num link de escola disputam a mesma banda e
-//     nenhuma acaba primeiro — e o jogo, que precisa da rede para as próprias imagens, fica atrás delas.
-//  2. **NUNCA LANÇA.** Uma falha de rede é REPORTADA e a lista continua. Um `throw` aqui derrubaria o
-//     arranque de um jogo por causa de um recurso que ele nem usa hoje.
-//  3. **IDEMPOTENTE.** O que já está na Cache Storage não é buscado outra vez — é o que torna isto seguro de
-//     chamar em todo arranque em vez de só «no primeiro», que ninguém sabe detectar com honestidade.
-import { CACHE_PESADOS, PESADOS } from './pesados-catalogo.js';
-export { CACHE_PESADOS, PESADOS };
-/**
- * BAIXA O QUE FALTA, UM DE CADA VEZ, E DEVOLVE O QUE ACONTECEU COM CADA UM.
- *
- * ⚠️ AS ENTRADAS SEM `url` NÃO SÃO SALTADAS EM SILÊNCIO — devolvem `sem-fonte`. É a diferença entre «este
- * subsistema ainda não tem de onde vir» e «este subsistema está tratado», e é exactamente a distinção que o
- * ADR-0119 mediu em falta: a engine PROMETIA quatro coisas e entregava uma, sem nada a dizê-lo.
- */
-export async function baixarPesados(opcoes = {}) {
-    const cs = opcoes.cacheStorage ?? (typeof caches !== 'undefined' ? caches : undefined);
-    const buscar = opcoes.buscar ?? (typeof fetch !== 'undefined' ? fetch : undefined);
-    const alvos = opcoes.apenas
-        ? PESADOS.filter((p) => opcoes.apenas.includes(p.id))
-        : PESADOS;
-    const out = [];
-    const conta = (r) => { out.push(r); opcoes.aoProgredir?.(r); };
-    if (!cs || !buscar) {
-        for (const p of alvos)
-            conta({ id: p.id, estado: 'falhou', erro: 'sem Cache Storage ou sem fetch' });
-        return out;
-    }
-    const cache = await cs.open(CACHE_PESADOS);
-    for (const p of alvos) {
-        if (!p.url) {
-            conta({ id: p.id, estado: 'sem-fonte', erro: p.porQueNaoTemFonte });
-            continue;
-        }
-        try {
-            if (await cache.match(p.url)) {
-                conta({ id: p.id, estado: 'ja-tinha' });
-                continue;
-            }
-            const resp = await buscar(p.url);
-            if (!resp.ok) {
-                conta({ id: p.id, estado: 'falhou', erro: `HTTP ${resp.status}` });
-                continue;
-            }
-            await cache.put(p.url, resp.clone());
-            conta({ id: p.id, estado: 'baixado', bytes: p.bytes });
-        }
-        catch (e) {
-            conta({ id: p.id, estado: 'falhou', erro: e instanceof Error ? e.message : String(e) });
-        }
-    }
-    return out;
-}
-/** O peso do que ainda falta, em bytes — para um aviso poder dizer «faltam 241 MB» antes de começar. */
-export function pesoPorBaixar(relatorio) {
-    const feitos = new Set(relatorio.filter((r) => r.estado === 'ja-tinha' || r.estado === 'baixado').map((r) => r.id));
-    return PESADOS.filter((p) => p.url && !feitos.has(p.id)).reduce((s, p) => s + (p.bytes ?? 0), 0);
-}

package/dist-pkg/platform/vozes-prontas.d.ts

@@ -1,28 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-import { type EstadosDasVozes, type VozNeural } from './voice-plan.js';
-import type { RelatorioPesado } from './pesados.js';
-/**
- * O ESTADO DE CADA VOZ A PARTIR DO QUE O BUSCADOR RELATOU.
- *
- * ⚠️ `emCurso` NÃO É COSMÉTICA, E É O QUE IMPEDE ESTA PONTE DE MENTIR NOS DOIS SENTIDOS. O relatório só
- * contém o que JÁ resolveu, logo uma voz por relatar é ambígua: pode estar a caminho ou nunca ter sido
- * pedida. O `voice-plan` recusa-se a confundir as duas por escrito — «ausente não se disfarça de a buscar»,
- * porque isso esconderia um buscador que nunca arrancou atrás de uma frase tranquilizadora — e a única coisa
- * que desfaz a ambiguidade é quem chamou saber se a descarga ainda corre.
- *
- * 📌 E o par contrário importa igualmente: com a descarga TERMINADA, uma voz por relatar é `ausente` e nunca
- * `a-buscar`, senão a interface prometeria para sempre uma coisa que já não vem.
- */
-export declare function estadosDasVozes(relatorio: readonly RelatorioPesado[], opcoes?: {
-    readonly emCurso?: boolean;
-}, catalogo?: readonly VozNeural[]): EstadosDasVozes;
-/**
- * AS IDS DAS COISAS PESADAS QUE SÃO VOZ — para quem queira descê-las primeiro, sem adivinhar o formato da id.
- *
- * ⚠️ Existe porque a alternativa é o consumidor escrever `p.id.startsWith('voz:')` no ponto de uso, e aí o
- * formato da id passa a ser contrato público sem nunca ter sido decidido como tal.
- */
-export declare const idsDasVozes: (catalogo?: readonly VozNeural[]) => string[];
-/** Reexportado para quem faz a ponte não ter de importar de dois sítios para responder a uma pergunta. */
-export { vozEmUso, estadoDe } from './voice-plan.js';
-export type { VozEmUso, EstadosDasVozes } from './voice-plan.js';