primocode 11.0.0 → 11.1.0

package/lib/estudio/kit.js

@@ -1,91 +0,0 @@
-/**
- * kit.js — o kit de motion do Estúdio, do lado do PrimoCode.
- *
- *   "Motion graphics absurdo de profissional", com as regras do guia MOTION
- *   VOX STYLE e o repertório dos vídeos de referência (brand reveal, reel de
- *   motion designer, lançamento de SaaS).
- *
- * As peças são React e moram em lib/estudio/kit/*.jsx: arquivos de verdade,
- * que se leem e se editam como código, copiados para src/kit/ do projeto
- * Remotion por remotion.js. No plano, cada peça é um elemento
- * {"tipo": "kit", "peca": "<nome>", …} — o plano continua sendo só dados.
- *
- * Aqui ficam o NOME de cada peça e o que ela precisa para desenhar alguma
- * coisa. É isso que o validador do plano confere: peça que não existe, ou
- * sem o campo que a alimenta, vira problema agora, e não um quadro vazio
- * vinte minutos depois.
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-
-/* precisa: todos estes campos; umDe: pelo menos um destes. listas: campos que
-   têm de ser lista não vazia. */
-const PECAS = {
-    // os oito dispositivos VOX (e o gráfico em tinta)
-    palavra: { precisa: ['palavras'], listas: ['palavras'] },
-    lista: { precisa: ['itens'], listas: ['itens'] },
-    letra: { precisa: ['texto'] },
-    especime: { precisa: ['termo'] },
-    pilula: { precisa: ['texto'] },
-    fonte: { precisa: ['texto'] },
-    marcatexto: { precisa: ['linhas'], listas: ['linhas'] },
-    textura: { precisa: ['texto'] },
-    barras: { precisa: ['barras'], listas: ['barras'] },
-    papel: {},
-    // marca e lançamento
-    orbe: {},
-    vetor: { umDe: ['glifos', 'texto'] },
-    manchete: { umDe: ['texto', 'contar'] },
-    cromo: {},
-    cores: { precisa: ['cores'], listas: ['cores'] },
-    padrao: {},
-    particulas: {},
-    estrela: {},
-    cartoes: { precisa: ['cartoes'] },
-    painel: {},
-    esfera: {},
-    grade: {},
-    site: {},
-    // O print REAL do site (print-site.js) numa janela ou num celular em 3D, rolando.
-    printsite: { precisa: ['src'] },
-    // O produto em 3D (kit/tres.jsx): fone, celular, lata ou caixa, de geometria.
-    produto3d: { precisa: ['modelo'] },
-    // Os ícones 3D de geometria (kit/tres.jsx): raio, coração, bateria, relógio, fone…
-    icone3d: { precisa: ['icone'] },
-    // O motion gerativo (kit/gerativo.jsx): a partitura inteira, numa peça só (gerativo.js).
-    gerativo: { precisa: ['partitura'] },
-    // O estilo fluido (kit/fluido.jsx): a forma que vira a próxima, numa peça só (fluido.js).
-    fluido: { precisa: ['partitura'] },
-    // O vídeo gravado em 3D (kit/personagem.jsx): o set, os personagens e a câmera (personagem.js).
-    personagem: { precisa: ['partitura'] },
-    // O mesmo vídeo gravado, no visual de blocos da referência (kit/voxel.jsx): o padrão desde a 10.5.
-    voxel: { precisa: ['partitura'] },
-    // A animação pronta da biblioteca (kit/animacao.jsx, colecao.js): o Lottie tocado quadro a quadro.
-    animacao: { precisa: ['src'] },
-    // O vídeo em camadas (kit/rosto.jsx, camadas.js): a gravação que muda de forma, e o palco escuro atrás dela.
-    rosto: { precisa: ['src'] },
-    palco: {},
-};
-
-const ARQUIVOS = ['base.jsx', 'vox.jsx', 'marca.jsx', 'tres.jsx', 'gerativo.jsx', 'fluido.jsx', 'personagem.jsx', 'mundo.jsx', 'voxel.jsx', 'animacao.jsx', 'rosto.jsx', 'natural.js', 'index.jsx'];
-
-/** Os arquivos do kit, para o projeto Remotion: [{nome: 'kit/base.jsx', conteudo}]. */
-function arquivos() {
-    return ARQUIVOS.map((f) => ({ nome: 'kit/' + f, conteudo: fs.readFileSync(path.join(__dirname, 'kit', f), 'utf-8') }));
-}
-
-/** O que falta nesta peça para ela desenhar alguma coisa. [] = pronta. */
-function conferirPeca(el) {
-    const def = PECAS[el && el.peca];
-    if (!def) return [`peça "${el && el.peca}" não existe no kit — use ${Object.keys(PECAS).join(', ')}`];
-    const falta = [];
-    for (const campo of def.precisa || []) if (el[campo] == null || el[campo] === '') falta.push(`a peça "${el.peca}" precisa de "${campo}"`);
-    for (const campo of def.listas || []) if (el[campo] != null && (!Array.isArray(el[campo]) || !el[campo].length)) falta.push(`"${campo}" é uma lista com pelo menos um item`);
-    if (def.umDe && !def.umDe.some((c) => el[c] != null && el[c] !== '')) falta.push(`a peça "${el.peca}" precisa de ${def.umDe.map((c) => `"${c}"`).join(' ou ')}`);
-    return falta;
-}
-
-module.exports = { PECAS, arquivos, conferirPeca };

package/lib/estudio/kits-tela.js

@@ -1,199 +0,0 @@
-/**
- * kits-tela.js — a tela de estilos: os 50 kits (lib/kits.js) no mesmo carrossel da tela de gosto.
- *
- *   "O primeiro pedido de motion e o /styles abrem ESTA tela; a escolha volta pro PrimoCode
- *    como a da tela de gosto." (Joel, 26/10)
- *
- * A página é lib/estudio/kits/tela.html, uma CÓPIA de gosto/tela.html (que não muda) com os kits no lugar
- * dos 20 estilos fixos: capa.jpg no cartão, preview.mp4 com o mouse em cima (renderizado aqui na primeira
- * vez, num filho `primocode kit preview <slug>`, pra não travar o servidor), nome, família e descrição.
- *
- * Abre igual à de gosto: no terminal, o navegador; no app (PRIMOCODE_APP=1), a linha `primocode:abrir-gosto <url>`
- * no stderr (mesmo formato de URL: o app já abre e fecha a janela sozinho no /salvar e /pular).
- *
- *   abrirTela()        servidor 127.0.0.1 + token; resolve {ok:true, slug} | {ok:false, motivo}
- *   abrirOndeDer()     /styles: terminal → navegador, app → linha de protocolo
- *   primeiroMotion()   só abre se a pessoa nunca escolheu (nem pulou) e há gente do outro lado
- *   lerEscolha()       ~/.primocode/kit-escolhido.json: {slug, quando} ou {pulou:true}
- */
-'use strict';
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-const http = require('http');
-const crypto = require('crypto');
-const { spawn } = require('child_process');
-
-const arquivoEscolha = (home = os.homedir()) => path.join(home, '.primocode', 'kit-escolhido.json');
-function lerEscolha(home) { try { return JSON.parse(fs.readFileSync(arquivoEscolha(home), 'utf8')); } catch { return null; } }
-function salvarEscolha(dados, home) {
-    const arq = arquivoEscolha(home);
-    fs.mkdirSync(path.dirname(arq), { recursive: true });
-    const d = { ...dados, quando: new Date().toISOString() };
-    fs.writeFileSync(arq, JSON.stringify(d, null, 1));
-    return d;
-}
-
-/** Mesma regra da tela de gosto: 'app' (linha de protocolo), 'terminal' (navegador) ou null (CI, script sem app). */
-function modoTela(env = process.env, tty = !!process.stdout.isTTY) {
-    if (env.CI) return null;
-    if (env.PRIMOCODE_APP === '1') return 'app';
-    if (env.PRIMOCODE_SEM_TELA || !tty) return null;
-    return 'terminal';
-}
-
-/** O preview de um kit, renderizado num filho (o render leva ~20 s; a 1ª vez instala o estúdio dos kits). */
-function renderEmFilho(slug, { home, env = process.env } = {}) {
-    return new Promise((resolve) => {
-        const bin = path.join(__dirname, '..', '..', 'bin', 'primocode.js');
-        const p = spawn(process.execPath, [bin, 'kit', 'preview', slug], { env: { ...env, ...(home ? { HOME: home } : {}), PRIMOCODE_SEM_TELA: '1' }, stdio: ['ignore', 'pipe', 'pipe'] });
-        let saida = '';
-        p.stdout.on('data', (d) => { saida = (saida + d).slice(-2000); });
-        p.stderr.on('data', (d) => { saida = (saida + d).slice(-2000); });
-        p.on('close', (code) => resolve(code === 0 ? { ok: true } : { ok: false, error: saida.split('\n').filter(Boolean).slice(-1)[0] || `saiu com ${code}` }));
-        p.on('error', (e) => resolve({ ok: false, error: e.message }));
-    });
-}
-
-function dadosDaTela(K, home, inicial) {
-    const todos = K.listar({ home });
-    const familias = [...new Set([...K.FAMILIAS, ...todos.map((k) => k.familia)])].filter((f) => todos.some((k) => k.familia === f));
-    // na ordem das famílias, pra o chip de família levar a um bloco seguido
-    const kits = familias.flatMap((f) => todos.filter((k) => k.familia === f)).map((k) => ({
-        slug: k.slug, nome: k.nome, familia: k.familia, descricao: k.descricao, preview: !!K.previewPronto(k, { home }),
-    }));
-    return { kits, familias, inicial: inicial && kits.some((k) => k.slug === inicial) ? inicial : null };
-}
-
-/** Manda um arquivo com suporte a Range (o <video> do WebKit pede pedaços). */
-function servirArquivo(req, res, arq, tipo) {
-    let st;
-    try { st = fs.statSync(arq); } catch { res.writeHead(404); return res.end(); }
-    const r = /bytes=(\d*)-(\d*)/.exec(req.headers.range || '');
-    if (r) {
-        const ini = r[1] ? Number(r[1]) : Math.max(0, st.size - Number(r[2] || 0));
-        const fim = r[1] && r[2] ? Math.min(Number(r[2]), st.size - 1) : st.size - 1;
-        if (ini >= st.size || ini > fim) { res.writeHead(416, { 'content-range': `bytes */${st.size}` }); return res.end(); }
-        res.writeHead(206, { 'content-type': tipo, 'content-length': fim - ini + 1, 'content-range': `bytes ${ini}-${fim}/${st.size}`, 'accept-ranges': 'bytes', 'cache-control': 'no-store' });
-        return fs.createReadStream(arq, { start: ini, end: fim }).pipe(res);
-    }
-    res.writeHead(200, { 'content-type': tipo, 'content-length': st.size, 'accept-ranges': 'bytes', 'cache-control': 'no-store' });
-    fs.createReadStream(arq).pipe(res);
-}
-
-/**
- * Abre a tela. Resolve {ok:true, slug, kit} (escolheu), {ok:false, motivo:'pulou'|'fechou'|'tempo'|'sem_tela'}.
- * `abrir(url)`, `home`, `renderPreview(slug)` e `timeoutMs` são injetáveis (testes). `inicial`: o kit que já vem marcado.
- */
-function abrirTela({ home, abrir, timeoutMs = 10 * 60 * 1000, porta = 0, inicial, renderPreview, env = process.env } = {}) {
-    const K = require('../kits.js');
-    const render = renderPreview || ((slug) => renderEmFilho(slug, { home, env }));
-    return new Promise((resolve) => {
-        const token = crypto.randomBytes(16).toString('hex');
-        let html;
-        try { html = fs.readFileSync(path.join(__dirname, 'kits', 'tela.html'), 'utf8'); } catch { return resolve({ ok: false, motivo: 'sem_tela' }); }
-        const dados = JSON.stringify(dadosDaTela(K, home, inicial)).replace(/</g, '\\u003c');
-        const previews = new Map();   // slug → {estado:'fazendo'|'erro', motivo}
-        const fila = [];
-        let rodando = false;
-        const proximo = async () => {
-            if (rodando || !fila.length) return;
-            rodando = true;
-            const slug = fila.shift();
-            previews.set(slug, { estado: 'fazendo', motivo: 'renderizando o preview (~20 s)…' });
-            let r;
-            try { r = await render(slug); } catch (e) { r = { ok: false, error: e.message }; }
-            previews.set(slug, r && r.ok ? { estado: 'pronto' } : { estado: 'erro', motivo: String((r && r.error) || 'falhou').slice(0, 160) });
-            rodando = false;
-            proximo();
-        };
-        let fim = false, timer = null;
-        const srv = http.createServer(async (req, res) => {
-            const u = new URL(req.url, 'http://127.0.0.1');
-            const dizer = (cod, corpo, tipo = 'application/json; charset=utf-8') => { res.writeHead(cod, { 'content-type': tipo, 'cache-control': 'no-store' }); res.end(typeof corpo === 'string' ? corpo : JSON.stringify(corpo)); };
-            const slugDa = (pre) => decodeURIComponent(u.pathname.slice(pre.length));
-            try {
-                if (req.method === 'GET') {
-                    if (u.searchParams.get('t') !== token) return dizer(403, 'token inválido', 'text/plain; charset=utf-8');
-                    if (u.pathname === '/') return dizer(200, html.split('__TOKEN__').join(token).split('__DADOS__').join(dados), 'text/html; charset=utf-8');
-                    if (u.pathname.startsWith('/capa/')) {
-                        const k = K.achar(slugDa('/capa/'), { home });
-                        if (!k || !k.capa) return dizer(404, 'sem capa', 'text/plain; charset=utf-8');
-                        return servirArquivo(req, res, k.capa, 'image/jpeg');
-                    }
-                    if (u.pathname.startsWith('/preview/')) {
-                        const k = K.achar(slugDa('/preview/'), { home });
-                        const arq = k && K.previewPronto(k, { home });
-                        if (!arq) return dizer(404, 'sem preview', 'text/plain; charset=utf-8');
-                        return servirArquivo(req, res, arq, 'video/mp4');
-                    }
-                    return dizer(404, 'não achei', 'text/plain; charset=utf-8');
-                }
-                if (req.method !== 'POST') return dizer(405, 'não', 'text/plain; charset=utf-8');
-                if (req.headers['x-gosto-token'] !== token) return dizer(403, { ok: false, error: 'token inválido' });
-                if (u.pathname.startsWith('/preview/')) {
-                    const k = K.achar(slugDa('/preview/'), { home });
-                    if (!k) return dizer(404, { ok: false, error: 'kit não existe' });
-                    if (K.previewPronto(k, { home })) return dizer(200, { ok: true, estado: 'pronto' });
-                    const e = previews.get(k.slug);
-                    if (e && e.estado === 'erro') return dizer(200, { ok: true, ...e });
-                    if (!e) { previews.set(k.slug, { estado: 'fazendo', motivo: fila.length || rodando ? 'na fila do preview…' : 'preparando o preview…' }); fila.push(k.slug); proximo(); }
-                    return dizer(200, { ok: true, ...previews.get(k.slug) });
-                }
-                if (u.pathname === '/fechar') { dizer(200, { ok: true }); return terminar({ ok: false, motivo: 'fechou' }); }
-                if (u.pathname === '/pular') { salvarEscolha({ pulou: true }, home); dizer(200, { ok: true }); return terminar({ ok: false, motivo: 'pulou' }); }
-                if (u.pathname === '/salvar') {
-                    let corpo = '';
-                    for await (const c of req) { corpo += c; if (corpo.length > 4096) return dizer(413, { ok: false, error: 'grande' }); }
-                    let slug = '';
-                    try { slug = String(JSON.parse(corpo).slug || ''); } catch { /* corpo ruim */ }
-                    const k = slug && K.achar(slug, { home });
-                    if (!k || k.slug !== slug) return dizer(400, { ok: false, error: `o estilo "${slug}" não existe` });
-                    salvarEscolha({ slug: k.slug }, home);
-                    dizer(200, { ok: true, slug: k.slug });
-                    return terminar({ ok: true, slug: k.slug, kit: k });
-                }
-                dizer(404, { ok: false, error: 'não achei' });
-            } catch (e) { try { dizer(500, { ok: false, error: String(e.message || e) }); } catch { /* já respondeu */ } }
-        });
-        function terminar(r) {
-            if (fim) return;
-            fim = true;
-            clearTimeout(timer);
-            try { srv.close(); } catch { /* já fechou */ }
-            const t = setTimeout(() => { try { if (srv.closeAllConnections) srv.closeAllConnections(); } catch { /* ok */ } }, 300);
-            if (t.unref) t.unref();
-            resolve(r);
-        }
-        srv.on('error', () => terminar({ ok: false, motivo: 'sem_tela' }));
-        srv.listen(porta, '127.0.0.1', () => {
-            timer = setTimeout(() => terminar({ ok: false, motivo: 'tempo' }), timeoutMs);
-            const url = `http://127.0.0.1:${srv.address().port}/?t=${token}`;
-            try {
-                const r = (abrir || ((x) => require('../tools.js').openInBrowser(x)))(url);
-                if (r && typeof r.catch === 'function') r.catch(() => {});
-            } catch { /* sem navegador */ }
-        });
-    });
-}
-
-/** /styles: no app vai pela linha de protocolo (o app abre a janela); no terminal, pelo navegador. */
-function abrirOndeDer(opcoes = {}, { env = process.env, stderr = process.stderr } = {}) {
-    if (env.PRIMOCODE_APP === '1') {
-        const { linhaProtocolo } = require('./gosto.js');
-        return abrirTela({ ...opcoes, env, abrir: (url) => stderr.write(linhaProtocolo(url)) });
-    }
-    return abrirTela({ ...opcoes, env });
-}
-
-/** O primeiro motion: só abre se a pessoa nunca escolheu nem pulou, e se há gente do outro lado. */
-async function primeiroMotion(opcoes = {}, { env = process.env, tty, stderr = process.stderr } = {}) {
-    if (lerEscolha(opcoes.home)) return { ok: false, motivo: 'ja_escolheu' };
-    const modo = modoTela(env, tty);
-    if (!modo) return { ok: false, motivo: 'nao_abre' };
-    if (modo === 'terminal') { try { stderr.write('  ⎿ Antes do primeiro motion: abri a tela de estilos (até 10 min). Escolha um ou deixe o PrimoCode escolher.\n'); } catch { /* sem terminal */ } }
-    return abrirOndeDer(opcoes, { env, stderr });
-}
-
-module.exports = { abrirTela, abrirOndeDer, primeiroMotion, lerEscolha, salvarEscolha, arquivoEscolha, modoTela, dadosDaTela, renderEmFilho };

package/lib/estudio/kokoro.js

@@ -1,127 +0,0 @@
-/* A VOZ LOCAL (Kokoro-82M): roda na CPU desta máquina, sem cota e sem
-   servidor. Entra quando o Gemini falha (cota, voz cortada) ou quando o
-   roteiro pede `voz: 'kokoro'` (ou PRIMOCODE_VOZ=kokoro). Sem `uv` ou sem
-   espeak-ng ela diz que não está disponível e a corrente segue — nunca
-   derruba a narração.
-
-   Provado nesta máquina em 05/10: 11 s de áudio em 3,5 s (+4,3 s de carga
-   do modelo), sem o corte no fim que o Gemini às vezes deixa. */
-const fs = require('fs');
-const path = require('path');
-const { spawn, execFileSync } = require('child_process');
-
-const SCRIPT = path.join(__dirname, '..', '..', 'studio', 'voz_kokoro.py');
-// Sem `transformers>=4.45` o uv escolhe a 4.12 e o tokenizers não compila (05/10).
-const DEPS = ['kokoro>=0.9.4', 'transformers>=4.45', 'soundfile', 'misaki[en]'];
-// As vozes do Studio viram as do Kokoro em português: pf_dora (feminina), pm_alex (masculina).
-const VOZES = { thalita: 'pf_dora', francisca: 'pf_dora', feminina: 'pf_dora', antonio: 'pm_alex', masculina: 'pm_alex' };
-
-/** O roteiro (ou quem usa) pediu a voz local? */
-function querKokoro(voz, env = process.env) {
-    return String(voz || '').toLowerCase() === 'kokoro' || String(env.PRIMOCODE_VOZ || '').toLowerCase() === 'kokoro';
-}
-
-/** "PrimoCode" sai "Primo Kodi" no Kokoro; escrito assim, sai certo. */
-function pronuncia(texto) {
-    return String(texto || '').replace(/primo\s*code/gi, 'Primo Côude');
-}
-
-function vozKokoro(voz) {
-    const v = String(voz || '').toLowerCase();
-    if (/^p[fm]_/.test(v)) return v;
-    return VOZES[v] || 'pm_alex';
-}
-
-/** Onde está o espeak-ng (o Kokoro precisa dele para o português). */
-function acharEspeak({ existe = fs.existsSync, brew = () => execFileSync('brew', ['--prefix', 'espeak-ng'], { stdio: ['ignore', 'pipe', 'ignore'], timeout: 10000 }).toString().trim() } = {}) {
-    const bases = [];
-    try { bases.push(brew()); } catch { /* sem brew */ }
-    bases.push('/opt/homebrew/opt/espeak-ng', '/usr/local/opt/espeak-ng', '/usr');
-    for (const b of bases) {
-        if (!b) continue;
-        const dados = path.join(b, 'share', 'espeak-ng-data');
-        const lib = ['lib/libespeak-ng.dylib', 'lib/libespeak-ng.so.1', 'lib/x86_64-linux-gnu/libespeak-ng.so.1', 'lib/aarch64-linux-gnu/libespeak-ng.so.1']
-            .map((l) => path.join(b, l)).find(existe);
-        if (existe(dados) && lib) return { dados, lib };
-    }
-    return null;
-}
-
-/** O comando inteiro (uv + deps fixadas + env do espeak), ou null se falta peça. */
-function comando({ uv, espeak, arquivo, saida, voz, env = process.env }) {
-    if (!uv || !espeak) return null;
-    const args = ['run', '--quiet', '--python', '3.11'];
-    for (const d of DEPS) args.push('--with', d);
-    args.push('python', SCRIPT, 'roteiro', '--arquivo', arquivo, '--saida', saida, '--voz', vozKokoro(voz));
-    return { cmd: uv, args, env: { ...env, ESPEAK_DATA_PATH: espeak.dados, PHONEMIZER_ESPEAK_LIBRARY: espeak.lib } };
-}
-
-function rodar({ cmd, args, env }, timeout) {
-    return new Promise((resolve) => {
-        const p = spawn(cmd, args, { env });
-        let saida = '', erro = '';
-        p.stdout.on('data', (d) => { saida += d.toString(); });
-        p.stderr.on('data', (d) => { erro += d.toString(); });
-        const relogio = setTimeout(() => { try { p.kill(); } catch {} }, timeout);
-        p.on('close', () => {
-            clearTimeout(relogio);
-            try { resolve(JSON.parse(saida.trim().split('\n').pop())); }
-            catch { resolve({ ok: false, error: (erro || saida).slice(-400).trim() || 'o kokoro não respondeu' }); }
-        });
-        p.on('error', (e) => { clearTimeout(relogio); resolve({ ok: false, error: e.message }); });
-    });
-}
-
-/** Narra a lista [{texto}] em mp3 com o Kokoro. Devolve o mesmo formato do narrar.py. */
-async function narrar(lista, mp3, { voz, uv, espeak = acharEspeak(), executar = rodar, timeout = 15 * 60000 } = {}) {
-    const arquivo = mp3.replace(/\.mp3$/, '') + '.kokoro.json';
-    const c = comando({ uv, espeak, arquivo, saida: mp3, voz });
-    if (!c) return { ok: false, indisponivel: true, error: !uv ? 'kokoro: falta o uv' : 'kokoro: falta o espeak-ng (brew install espeak-ng)' };
-    try {
-        fs.writeFileSync(arquivo, JSON.stringify(lista.map((x) => ({ ...x, texto: pronuncia(x.texto) }))));
-        return await executar(c, timeout);
-    } catch (e) {
-        return { ok: false, error: e.message };
-    } finally {
-        try { fs.unlinkSync(arquivo); } catch { /* fica */ }
-    }
-}
-
-/** A ordem das vozes: pedida → Kokoro e depois o Edge; senão Gemini → Edge → Kokoro.
-    O Edge (vozes neurais da Microsoft, ou a ElevenLabs quando há chave) vem
-    ANTES do Kokoro desde 11/10: com a cota do Gemini no fim, o Kokoro em
-    português era a "voz robótica" que a pessoa ouvia. `motorVoz: 'edge'` no
-    roteiro pula as outras. */
-function ordem(voz, env = process.env, { soEdge = false } = {}) {
-    if (soEdge) return ['edge'];
-    if (querKokoro(voz, env)) return ['kokoro', 'edge'];
-    // O VoiceStudio local vem primeiro (15/10); fechado, a cadeia segue para o Gemini na hora.
-    return env.PRIMOCODE_SEM_VOICESTUDIO ? ['gemini', 'edge', 'kokoro'] : ['voicestudio', 'gemini', 'edge', 'kokoro'];
-}
-
-/* A voz do Gemini no Edge: o narrar.py só conhece antonio, francisca e
-   thalita — o nome do Gemini ("Kore") caía na primeira, e toda fala de mulher
-   saía na voz do Antonio. Mantém o GÊNERO de quem fala. */
-const GEMINI_FEMININAS = new Set(['kore', 'aoede', 'leda', 'zephyr', 'sulafat', 'achird', 'despina', 'erinome', 'laomedeia', 'pulcherrima', 'vindemiatrix', 'callirrhoe', 'autonoe', 'gacrux']);
-function vozNoEdge(voz, reserva = 'thalita') {
-    const v = String(voz || '').trim().toLowerCase();
-    if (['antonio', 'francisca', 'thalita'].includes(v)) return v;
-    if (!v || querKokoro(v, {})) return reserva;
-    return GEMINI_FEMININAS.has(v) ? 'francisca' : 'antonio';
-}
-
-/** Roda a corrente: a primeira voz que der certo ganha; a falha de uma nunca derruba. */
-async function corrente(passos, provedores) {
-    let ultimo = { ok: false, error: 'nenhuma voz disponível' };
-    for (const nome of passos) {
-        const f = provedores[nome];
-        if (!f) continue;
-        let r;
-        try { r = await f(); } catch (e) { r = { ok: false, error: e.message }; }
-        if (r && r.ok) return r;
-        if (r) ultimo = r;
-    }
-    return ultimo;
-}
-
-module.exports = { vozNoEdge, querKokoro, pronuncia, vozKokoro, acharEspeak, comando, narrar, ordem, corrente, DEPS, SCRIPT };

package/lib/estudio/maquina-foto.js

@@ -1,177 +0,0 @@
-/**
- * maquina-foto.js — a FOTO que a pessoa manda vira peça do motion (a primitiva "foto" do kit-ae).
- *
- * Antes (20/10): a foto do pedido virava só "referência" (cores, em index.js:importarReferencia) e nenhuma primitiva
- * aceitava imagem: o motion não tinha onde pôr a foto e o pedido travava. Agora, ANTES do render e uma vez só:
- *
- *   1. confere o arquivo (formato, tamanho, se abre) e diz o porquê em português quando não serve;
- *   2. copia para <projeto>/midia/fotos/ (o motion nunca aponta para fora do projeto), já com o lado maior em ≤ 2400 px;
- *   3. faz o fundo desfocado (o plano de trás do parallax) com o ffmpeg;
- *   4. tenta o recorte da pessoa: o Vision do macOS primeiro (lib/estudio/visao.js), o MediaPipe (studio/pessoa.py) depois;
- *      sem pessoa ou sem nenhum dos dois, a foto vai inteira, com moldura arredondada.
- *
- *   preparar({fotos, pasta, deps}) → {fotos:[{arquivo, fundo, recorte, w, h, nome, de, moldura}], recusadas:[{arquivo, motivo}]}
- *
- * `deps` (injetáveis; testes): sondar(arq) → {w,h}|null, recortar(entrada, saida) → {ok, semPessoa?}, converter(entrada, saida) → bool.
- */
-
-'use strict';
-
-const fs = require('fs');
-const path = require('path');
-const { spawnSync } = require('child_process');
-
-const FORMATOS = ['jpg', 'jpeg', 'png', 'webp', 'heic', 'heif'];
-const MAX_BYTES = 25 * 1024 * 1024;
-const MAX_LADO = 2400;
-const MAX_FOTOS = 6;
-
-const slug = (s) => String(s).normalize('NFD').replace(/[̀-ͯ]/g, '').replace(/[^a-z0-9]+/gi, '-').toLowerCase().replace(/^-|-$/g, '').slice(0, 30) || 'foto';
-
-function ff(args, timeout = 60000) {
-    const r = spawnSync('ffmpeg', ['-y', '-hide_banner', '-loglevel', 'error', ...args], { encoding: 'utf8', timeout });
-    return r.status === 0;
-}
-
-/** Largura e altura pelo ffprobe (o que o ffmpeg abre, o motion abre). null = não abre. */
-function sondar(arq) {
-    const r = spawnSync('ffprobe', ['-v', 'error', '-select_streams', 'v:0', '-show_entries', 'stream=width,height', '-of', 'csv=p=0:s=x', arq], { encoding: 'utf8', timeout: 20000 });
-    const m = r.status === 0 && String(r.stdout).trim().match(/^(\d+)x(\d+)/);
-    return m ? { w: Number(m[1]), h: Number(m[2]) } : null;
-}
-
-/** HEIC/HEIF → JPG: sips (macOS) ou o ffmpeg, se ele leu HEIC. false = sem conversor. */
-function converter(entrada, saida) {
-    if (process.platform === 'darwin') {
-        const r = spawnSync('sips', ['-s', 'format', 'jpeg', entrada, '--out', saida], { encoding: 'utf8', timeout: 60000 });
-        if (r.status === 0 && fs.existsSync(saida)) return true;
-    }
-    return ff(['-i', entrada, '-frames:v', '1', saida]) && fs.existsSync(saida);
-}
-
-function extensao(arq) { return path.extname(String(arq || '')).replace('.', '').toLowerCase(); }
-
-/** Confere uma foto SEM mexer nela. {ok:true, ext, bytes} ou {ok:false, error} (em português, dizendo o que fazer). */
-function validar(arq, { sondar: sd = sondar } = {}) {
-    const nome = path.basename(String(arq || '')) || String(arq || '');
-    if (!arq || typeof arq !== 'string') return { ok: false, error: 'faltou o caminho da foto.' };
-    const ext = extensao(arq);
-    if (!FORMATOS.includes(ext)) {
-        return { ok: false, error: `a foto "${nome}" é ${ext ? '.' + ext : 'de um tipo sem extensão'}: aceito ${FORMATOS.map((f) => '.' + f).join(', ')}. Salve ou exporte como JPG ou PNG e mande de novo.` };
-    }
-    let st;
-    try { st = fs.statSync(arq); } catch { return { ok: false, error: `não achei a foto "${nome}" em ${path.dirname(arq)}. Confira o caminho.` }; }
-    if (!st.isFile()) return { ok: false, error: `"${nome}" não é um arquivo de foto.` };
-    if (st.size === 0) return { ok: false, error: `a foto "${nome}" está vazia (0 bytes).` };
-    if (st.size > MAX_BYTES) return { ok: false, error: `a foto "${nome}" tem ${(st.size / 1048576).toFixed(1)} MB: o máximo é ${MAX_BYTES / 1048576} MB. Reduza o tamanho e mande de novo.` };
-    if (ext !== 'heic' && ext !== 'heif') {
-        const d = sd(arq);
-        if (!d || !(d.w > 0 && d.h > 0)) return { ok: false, error: `não consegui abrir a foto "${nome}": o arquivo está corrompido ou não é uma imagem de verdade. Tente exportar de novo.` };
-        if (d.w < 200 || d.h < 200) return { ok: false, error: `a foto "${nome}" é pequena demais (${d.w}x${d.h}): precisa ter pelo menos 200 px de lado para não ficar borrada no vídeo.` };
-    }
-    return { ok: true, ext, bytes: st.size };
-}
-
-function acharPython() {
-    for (const p of [process.env.PRIMOCODE_PYTHON, 'python3', 'python'].filter(Boolean)) {
-        const r = spawnSync(p, ['--version'], { encoding: 'utf8', timeout: 10000 });
-        if (r.status === 0) return p;
-    }
-    return null;
-}
-
-/** Apara a margem transparente do recorte (o que sobra é a pessoa): grava no próprio arquivo e devolve {w,h}; null se não deu. */
-function aparar(png) {
-    const r = spawnSync('ffmpeg', ['-hide_banner', '-i', png, '-vf', 'alphaextract,cropdetect=limit=24:round=2:skip=0', '-f', 'null', '-'], { encoding: 'utf8', timeout: 60000 });
-    const todos = [...String(r.stderr || '').matchAll(/crop=(\d+):(\d+):(\d+):(\d+)/g)];
-    if (!todos.length) return null;
-    const [, w, h, x, y] = todos[todos.length - 1].map(Number);
-    if (!(w >= 64 && h >= 64)) return null;
-    const tmp = png.replace(/\.png$/, '-aparado.png');
-    if (!ff(['-i', png, '-vf', `crop=${w}:${h}:${x}:${y}`, tmp]) || !fs.existsSync(tmp)) return null;
-    fs.renameSync(tmp, png);
-    return { w, h };
-}
-
-/** O recorte pelo MediaPipe (studio/pessoa.py). {ok:true} | {ok:false, semPessoa?, semMediaPipe?, error}. Nunca lança. */
-function recortarMediaPipe(entrada, saida) {
-    const py = acharPython();
-    if (!py) return { ok: false, error: 'sem Python 3 para o recorte' };
-    const r = spawnSync(py, [path.join(__dirname, '..', '..', 'studio', 'pessoa.py'), 'recortar-foto', '--entrada', entrada, '--saida', saida], { encoding: 'utf8', timeout: 90000 });
-    try { return { ...JSON.parse(String(r.stdout || '').trim().split('\n').pop()), motor: 'mediapipe' }; } catch { return { ok: false, error: String(r.stderr || r.stdout || 'o recorte não respondeu').slice(-200) }; }
-}
-
-/**
- * O recorte da pessoa, do melhor pro último caso: 1) o Vision do macOS (VNGeneratePersonSegmentationRequest, sem instalar
- * nada; lib/estudio/visao.js), 2) o MediaPipe (studio/pessoa.py), 3) nenhum → a foto vai inteira, com moldura.
- * {ok:true, motor} | {ok:false, semPessoa?, error}. Nunca lança. `deps.visao` é injetável (testes).
- */
-function recortarPessoa(entrada, saida, { visao } = {}) {
-    let V = visao;
-    if (V === undefined) { try { V = require('./visao.js'); } catch { V = null; } }
-    if (V && V.disponivel()) {
-        const r = V.recortar(entrada, saida);
-        if (r && r.ok && fs.existsSync(saida)) return { ok: true, motor: 'vision', cobertura: r.cobertura };
-        if (r && r.semPessoa) return { ok: false, semPessoa: true, motor: 'vision', error: 'sem pessoa na foto' };
-    }
-    return recortarMediaPipe(entrada, saida);
-}
-
-/**
- * Prepara as fotos do pedido. Nunca lança: o que não serve vai em `recusadas`, com o porquê.
- * `opc.max` limita quantas entram (padrão 6).
- */
-async function preparar({ fotos = [], pasta, deps = {}, max = MAX_FOTOS } = {}) {
-    const out = { fotos: [], recusadas: [] };
-    if (!pasta) return { ...out, recusadas: [{ arquivo: '', motivo: 'faltou a pasta do projeto.' }] };
-    const lista = (Array.isArray(fotos) ? fotos : [fotos]).filter(Boolean).map((f) => String(f).replace(/^file:\/\//, ''));
-    const unicas = [...new Set(lista)];
-    const sd = deps.sondar || sondar;
-    const dir = path.join(pasta, 'midia', 'fotos');
-    for (const orig of unicas) {
-        if (out.fotos.length >= max) { out.recusadas.push({ arquivo: orig, motivo: `o motion usa até ${max} fotos: "${path.basename(orig)}" ficou de fora.` }); continue; }
-        const v = validar(orig, { sondar: sd });
-        if (!v.ok) { out.recusadas.push({ arquivo: orig, motivo: v.error }); continue; }
-        try {
-            fs.mkdirSync(dir, { recursive: true });
-            const n = out.fotos.length + 1;
-            const base = `foto-${n}-${slug(path.basename(orig, path.extname(orig)))}`;
-            let entrada = orig;
-            if (v.ext === 'heic' || v.ext === 'heif') {
-                const jpgTmp = path.join(dir, base + '-heic.jpg');
-                const ok = (deps.converter || converter)(orig, jpgTmp);
-                if (!ok || !fs.existsSync(jpgTmp)) {
-                    out.recusadas.push({ arquivo: orig, motivo: `a foto "${path.basename(orig)}" é HEIC e esta máquina não tem conversor (no macOS vem o sips; no Windows/Linux, instale o ffmpeg com suporte a HEIC). Exporte como JPG e mande de novo.` });
-                    continue;
-                }
-                entrada = jpgTmp;
-            }
-            // cópia dentro do projeto, no lado máximo de 2400 px (a rotação do EXIF o ffmpeg já aplica)
-            const alvo = path.join(dir, base + (v.ext === 'png' ? '.png' : '.jpg'));
-            const filtro = `scale='if(gt(iw,ih),min(${MAX_LADO},iw),-2)':'if(gt(iw,ih),-2,min(${MAX_LADO},ih))'`;
-            const ok = ff(['-i', entrada, '-frames:v', '1', '-vf', filtro, ...(v.ext === 'png' ? [] : ['-q:v', '2']), alvo]);
-            // sem ffmpeg ou ele recusou: copia como veio (o kit ainda tenta abrir)
-            if (!ok || !fs.existsSync(alvo) || fs.statSync(alvo).size === 0) fs.copyFileSync(entrada, alvo);
-            if (entrada !== orig) fs.rmSync(entrada, { force: true });
-            const dims = sd(alvo);
-            const d = dims || { w: 1080, h: 1080 };
-            // o plano de trás do parallax: pequeno e muito desfocado (o kit amplia)
-            const fundo = path.join(dir, base + '-fundo.jpg');
-            const okF = ff(['-i', alvo, '-frames:v', '1', '-vf', 'scale=480:-2,gblur=sigma=16', '-q:v', '4', fundo]) && fs.existsSync(fundo);
-            // o recorte da pessoa, uma vez; sem pessoa ou sem MediaPipe: foto inteira com moldura
-            let recorte = null, motivoRecorte = null, rdims = null, motorRecorte = null;
-            if (deps.recortar !== false) {
-                const png = path.join(dir, base + '-recorte.png');
-                const rc = await (deps.recortar || ((e, s2) => recortarPessoa(e, s2, { visao: deps.visao })))(alvo, png);
-                if (rc && rc.ok && fs.existsSync(png)) { recorte = png; motorRecorte = rc.motor || null; rdims = (deps.aparar || aparar)(png) || sd(png); }
-                else motivoRecorte = (rc && rc.semPessoa) ? 'sem pessoa na foto' : ((rc && rc.error) || 'sem recorte');
-            }
-            out.fotos.push({ arquivo: alvo, fundo: okF ? fundo : alvo, recorte, w: d.w, h: d.h, nome: path.basename(orig), de: orig, moldura: !recorte, ...(rdims ? { rw: rdims.w, rh: rdims.h } : {}), ...(motorRecorte ? { recorteMotor: motorRecorte } : {}), ...(motivoRecorte ? { semRecorte: motivoRecorte } : {}) });
-        } catch (e) {
-            out.recusadas.push({ arquivo: orig, motivo: `não consegui preparar a foto "${path.basename(orig)}": ${e.message}` });
-        }
-    }
-    return out;
-}
-
-module.exports = { FORMATOS, MAX_BYTES, MAX_LADO, MAX_FOTOS, validar, preparar, sondar, converter, recortarPessoa, recortarMediaPipe, aparar, slug, extensao };