@the-inclusionist/engine 9.0.0 → 11.0.0

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';

package/dist-pkg/platform/vozes-prontas.js

@@ -1,61 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// platform/vozes-prontas.ts — A PONTE ENTRE O QUE DESCEU E O QUE A CRIANÇA OUVE (ADR-0110, gates 3 e 4).
-//
-// ========================= POR QUE ESTE MÓDULO EXISTE =========================
-// 📏 MEDIDO EM 2026-09-09: `vozEmUso` — a função que o ADR-0110 chama «o gate 3 em forma de código» — tinha
-// ZERO leitores em produção, e NADA no repositório produzia um `EstadosDasVozes`. O buscador que nasceu hoje
-// relata `RelatorioPesado[]`. São DUAS linguagens para o mesmo facto, e nenhuma falava com a outra.
-//
-// ⚠️ ISSO NÃO É UM ENCAIXE QUE FALTAVA, É A FORMA DE DEFEITO QUE ESTE REPOSITÓRIO PERSEGUE: um modelo aferido
-// e correcto, sem ninguém a lê-lo, ao lado de um mecanismo que produz a mesma verdade noutro vocabulário. O
-// `render/viz-axes` esteve exactamente assim — «é ÓRFÃO» — e o que isso custou foi a composição dos dois eixos
-// visuais a existir no papel e não na tela.
-//
-// ========================= 🎯 A REGRA QUE ESTE MÓDULO CARREGA, E É UMA SÓ =========================
-// **UMA VOZ SÓ ESTÁ PRONTA QUANDO OS DOIS FICHEIROS DESCERAM.** O piper recusa-se a falar sem o `.onnx.json`,
-// então uma voz com o modelo e sem a configuração é uma voz que NÃO FALA — e marcá-la `pronta` faria a engine
-// anunciar «voz neural» e ficar muda. É pior do que a voz em falta, porque a primeira parece resolvida, e é
-// literalmente a família do `reflectTTS` que o ADR-0110 nomeia ao pedir o gate 3.
-import { VOZES_NEURAIS } from './voice-plan.js';
-/** As duas ids que o catálogo dá a uma voz. Derivadas, não tabeladas — a tabela vive no catálogo. */
-const idsDe = (v) => [`voz:${v.voice}`, `voz:${v.voice}:cfg`];
-/**
- * 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 function estadosDasVozes(relatorio, opcoes = {}, catalogo = VOZES_NEURAIS) {
-    const porId = new Map(relatorio.map((r) => [r.id, r]));
-    const saida = {};
-    for (const v of catalogo) {
-        const partes = idsDe(v).map((id) => porId.get(id));
-        if (partes.some((p) => p && (p.estado === 'falhou' || p.estado === 'sem-fonte'))) {
-            // 📌 UMA METADE FALHADA CHEGA PARA A VOZ INTEIRA FALHAR, e é o mesmo argumento da regra do cabeçalho
-            // visto do outro lado: sem os dois ficheiros não há fala nenhuma, logo não há meia voz para oferecer.
-            saida[v.voice] = 'falhou';
-            continue;
-        }
-        if (partes.every((p) => p && (p.estado === 'baixado' || p.estado === 'ja-tinha'))) {
-            saida[v.voice] = 'pronta';
-            continue;
-        }
-        saida[v.voice] = opcoes.emCurso ? 'a-buscar' : 'ausente';
-    }
-    return Object.freeze(saida);
-}
-/**
- * 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 const idsDasVozes = (catalogo = VOZES_NEURAIS) => catalogo.flatMap((v) => [...idsDe(v)]);
-/** 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';

package/dist-pkg/render/camera.d.ts

@@ -1,58 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-/** Um tamanho em pixels de mundo ou de tela. Só isto: a câmera não precisa saber de mais nada. */
-export interface Tamanho {
-    w: number;
-    h: number;
-}
-/** Onde a câmera está, ANTES de arredondar. O arredondamento é do desenho, não da conta — ver `prender`. */
-export interface Camera {
-    camX: number;
-    camY: number;
-}
-/**
- * Prende a câmera dentro do mundo.
- *
- * ⚠️ MUNDO MENOR QUE A TELA: `mundo.w - tela.w` fica NEGATIVO, o `min` devolve esse negativo e o `max(0, …)`
- * o zera — a câmera encosta no canto superior esquerdo e sobra vazio à direita e abaixo. É o comportamento
- * que já existia e está preservado de propósito; o mapa de hoje (896×992 contra 320×180) nunca chega lá, mas
- * uma fase pequena chegaria, e é melhor que o caso esteja escrito do que descoberto.
- */
-export declare function prender(cam: Camera, mundo: Tamanho, tela: Tamanho): Camera;
-/** Põe `(alvoX, alvoY)` no CENTRO da tela e prende no mundo. O alvo é um ponto — quem tem corpo o converte. */
-export declare function enquadrar(alvoX: number, alvoY: number, mundo: Tamanho, tela: Tamanho): Camera;
-/**
- * Aplica o tremor (JUICE) e PRENDE DE NOVO.
- *
- * A segunda prisão não é zelo: sem ela o tremor empurra a câmera para fora do mundo na beirada da fase e a
- * criança vê o vazio atrás do cenário — justamente no momento em que alguma coisa explodiu e ela está olhando.
- *
- * @param amp amplitude em px (0 = sem tremor; `render/fx.shakeAmp`, que decai linearmente)
- * @param rx deslocamento horizontal já sorteado, em [-1, 1]
- * @param ry idem, vertical
- */
-export declare function tremer(cam: Camera, mundo: Tamanho, tela: Tamanho, amp: number, rx: number, ry: number): Camera;
-/** A zona-morta, em pixels de TELA. `{w:0,h:0}` = sem zona: a câmera cola no alvo, que é o de hoje. */
-export interface ZonaMorta {
-    readonly w: number;
-    readonly h: number;
-}
-export interface CameraObj {
-    /** Onde a câmera está, sem tremor, pré-arredondamento. */
-    readonly base: Camera;
-    /** Segue o alvo respeitando a zona-morta e prende no mundo. Devolve a base nova. */
-    seguir(alvoX: number, alvoY: number): Camera;
-    /** Centra no alvo AGORA, ignorando a zona-morta: nascimento, renascimento, troca de fase. */
-    pular(alvoX: number, alvoY: number): Camera;
-    /** Base + tremor, preso no mundo. NÃO altera a base — ver o cabeçalho. */
-    quadro(amp: number, rx: number, ry: number): Camera;
-    /** Mundo e/ou tela mudaram (fase nova, viewport dividido). Reprende a base no que passou a valer. */
-    redimensionar(mundo?: Tamanho, tela?: Tamanho): Camera;
-}
-/**
- * Cria uma câmera com alvo, zona-morta, prisão no mundo e tremor.
- *
- * ⚠️ ZONA ZERO É O COMPORTAMENTO DE HOJE, e não por coincidência: com `w = h = 0` a correção de `seguir` vira
- * `alvo - tela/2`, que é `enquadrar` letra por letra. É o que permite trocar o `placeCam` por esta câmera sem
- * mudar um pixel do que a criança vê, e escolher um valor de zona depois, como decisão separada.
- */
-export declare function criarCamera(mundo: Tamanho, tela: Tamanho, zona?: ZonaMorta): CameraObj;

package/dist-pkg/render/camera.js

@@ -1,105 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-// render/camera — ONDE A CÂMERA FICA. Item 22 (ADR-0027 passo 7), opção M1: a conta sai de dentro do efeito.
-//
-// ========================= POR QUE ISTO É UM MÓDULO, E POR QUE SÓ AGORA =========================
-// `placeCam` morava dentro de `render/draw.ts`, e o comentário do main.js registrava o motivo com honestidade:
-// "placeCam NÃO ganha envólucro: fora do próprio draw ele não tinha chamador nenhum". Era verdade — e deixou
-// de ser no dia em que o item 22 pediu uma câmera. O que muda não é o número de chamadores: é que a posição da
-// câmera passou a ser uma coisa que se DECIDE (zona-morta? uma por viewport? quem ela segue?), e uma decisão
-// enterrada dentro de uma função de 300 linhas de desenho não pode ser discutida nem aferida.
-//
-// Aqui não há decisão nova nenhuma. As fórmulas são as do `placeCam`, VERBATIM, na mesma ordem — enquadra,
-// prende, treme, prende de novo. É de propósito: M1 é o PREFIXO COMUM de todas as alternativas de câmera que
-// estão na mesa (extrair · zona-morta · uma por viewport), e nenhuma delas o dispensa. Extrair sem mudar é o
-// que torna a extração reversível e o que deixa a escolha inteira nas mãos do Dev.
-//
-// ========================= O QUE A EXTRAÇÃO TIRA DE CIMA DA MESA =========================
-// Duas coisas que `placeCam` sabia e não devia:
-//
-//  1. `BOX.h / 2` — a metade da CAIXA DE COLISÃO do jogador de plataforma, usada para converter "o y do pé"
-//     em "o y do meio do corpo". É conhecimento de gênero: um top-down não ancora no pé, um quiz não tem
-//     corpo. Agora quem chama passa o PONTO a enquadrar, e a conversão fica onde o corpo existe.
-//  2. `LOGICAL_W`/`LOGICAL_H` — o tamanho da tela lido de uma constante de módulo. O multiplayer já desenha N
-//     viewports; no dia em que cada um tiver a sua câmera, o tamanho tem de ENTRAR, não ser lido de fora.
-//
-// ========================= SEM I/O, SEM PIXI, SEM ALEATÓRIO =========================
-// Nenhuma função daqui toca sprite, container ou `Math.random`. O tremor recebe os dois deslocamentos JÁ
-// SORTEADOS (`rx`, `ry`), e é isso que o torna testável: a mesma entrada dá a mesma câmera, sempre. Quem
-// sorteia é `render/draw`, com o `rnd` compartilhado de core/rng — a semente continua sendo uma só.
-/**
- * Prende a câmera dentro do mundo.
- *
- * ⚠️ MUNDO MENOR QUE A TELA: `mundo.w - tela.w` fica NEGATIVO, o `min` devolve esse negativo e o `max(0, …)`
- * o zera — a câmera encosta no canto superior esquerdo e sobra vazio à direita e abaixo. É o comportamento
- * que já existia e está preservado de propósito; o mapa de hoje (896×992 contra 320×180) nunca chega lá, mas
- * uma fase pequena chegaria, e é melhor que o caso esteja escrito do que descoberto.
- */
-export function prender(cam, mundo, tela) {
-    return {
-        camX: Math.max(0, Math.min(cam.camX, mundo.w - tela.w)),
-        camY: Math.max(0, Math.min(cam.camY, mundo.h - tela.h)),
-    };
-}
-/** Põe `(alvoX, alvoY)` no CENTRO da tela e prende no mundo. O alvo é um ponto — quem tem corpo o converte. */
-export function enquadrar(alvoX, alvoY, mundo, tela) {
-    return prender({ camX: alvoX - tela.w / 2, camY: alvoY - tela.h / 2 }, mundo, tela);
-}
-/**
- * Aplica o tremor (JUICE) e PRENDE DE NOVO.
- *
- * A segunda prisão não é zelo: sem ela o tremor empurra a câmera para fora do mundo na beirada da fase e a
- * criança vê o vazio atrás do cenário — justamente no momento em que alguma coisa explodiu e ela está olhando.
- *
- * @param amp amplitude em px (0 = sem tremor; `render/fx.shakeAmp`, que decai linearmente)
- * @param rx deslocamento horizontal já sorteado, em [-1, 1]
- * @param ry idem, vertical
- */
-export function tremer(cam, mundo, tela, amp, rx, ry) {
-    if (!(amp > 0))
-        return cam;
-    return prender({ camX: cam.camX + rx * amp, camY: cam.camY + ry * amp }, mundo, tela);
-}
-/**
- * Cria uma câmera com alvo, zona-morta, prisão no mundo e tremor.
- *
- * ⚠️ ZONA ZERO É O COMPORTAMENTO DE HOJE, e não por coincidência: com `w = h = 0` a correção de `seguir` vira
- * `alvo - tela/2`, que é `enquadrar` letra por letra. É o que permite trocar o `placeCam` por esta câmera sem
- * mudar um pixel do que a criança vê, e escolher um valor de zona depois, como decisão separada.
- */
-export function criarCamera(mundo, tela, zona = { w: 0, h: 0 }) {
-    let m = mundo, t = tela;
-    let base = { camX: 0, camY: 0 };
-    /** Quanto a câmera precisa andar num eixo para o alvo voltar para dentro da zona. Zero se já está dentro. */
-    const correcao = (alvo, cam, telaLado, zonaLado) => {
-        const meia = Math.max(0, zonaLado) / 2;
-        const d = alvo - (cam + telaLado / 2); // distância do alvo ao CENTRO da tela
-        if (Math.abs(d) <= meia)
-            return 0;
-        return d - Math.sign(d) * meia; // anda o mínimo: o alvo pousa na BORDA da zona, não no centro
-    };
-    return {
-        get base() { return base; },
-        seguir(alvoX, alvoY) {
-            base = prender({
-                camX: base.camX + correcao(alvoX, base.camX, t.w, zona.w),
-                camY: base.camY + correcao(alvoY, base.camY, t.h, zona.h),
-            }, m, t);
-            return base;
-        },
-        pular(alvoX, alvoY) {
-            base = enquadrar(alvoX, alvoY, m, t);
-            return base;
-        },
-        quadro(amp, rx, ry) {
-            return tremer(base, m, t, amp, rx, ry);
-        },
-        redimensionar(novoMundo, novaTela) {
-            if (novoMundo)
-                m = novoMundo;
-            if (novaTela)
-                t = novaTela;
-            base = prender(base, m, t);
-            return base;
-        },
-    };
-}