primocode 9.8.0-beta.2 → 9.8.0-beta.20

package/lib/config.js

@@ -129,15 +129,25 @@ function listProjects() {
     } catch { return []; }
 }
 
+/* Palavras que dizem o TIPO da coisa, não QUAL coisa. "landing da barbearia"
+   e "landing-nova" (de outra empresa) dividiam "landing", e o pedido novo caía
+   dentro do projeto antigo — medido em 24/09: a landing da Navalha de Ouro foi
+   escrita em landing-nova/. Só o assunto conta como parecido. */
+const GENERICAS = new Set(['landing', 'lading', 'page', 'pagina', 'site', 'app', 'aplicativo', 'projeto',
+    'novo', 'nova', 'sistema', 'web', 'html', 'teste', 'versao', 'final', 'the', 'para', 'pra']);
+function tokensDoAssunto(nome) {
+    return slugify(nome).split('-').filter((t) => t.length > 2 && !GENERICAS.has(t) && !/^v?\d+$/.test(t));
+}
+
 // Projeto parecido com o que o usuário pediu? Compara os pedaços do slug.
 // "jogo-de-carro" vs "jogo-carro-2d" -> compartilham jogo+carro -> 0.5
 function findSimilarProject(projectName, minScore = 0.4) {
-    const wanted = new Set(slugify(projectName).split('-').filter((t) => t.length > 2));
+    const wanted = new Set(tokensDoAssunto(projectName));
     if (!wanted.size) return null;
 
     let best = null;
     for (const existing of listProjects()) {
-        const tokens = new Set(existing.split('-').filter((t) => t.length > 2));
+        const tokens = new Set(tokensDoAssunto(existing));
         if (!tokens.size) continue;
         let shared = 0;
         for (const t of wanted) if (tokens.has(t)) shared++;
@@ -285,9 +295,15 @@ function loadConfig() {
         currentProject: file.currentProject || null,
         userName: file.userName || null,
         mascot: file.mascot || 'primo',
+        // O rostinho do mascote depois da resposta. Ligado por padrão; quem acha
+        // que é enfeite demais desliga com /mascot reacoes off.
+        reacoes: file.reacoes !== false,
         theme: file.theme || 'primo',
         // Modo escolhido dura entre sessões: quem liga o auto quer o auto amanhã.
         mode: process.env.PRIMOCODE_MODE || file.mode || 'auto',
+        // O /permissoes: quando ele pergunta antes de agir. Dura entre sessões
+        // pelo mesmo motivo do modo — quem escolheu "perguntar" quer amanhã também.
+        permissoes: file.permissoes || 'auto',
         rootDir: ROOT_DIR,
         _file: file,
     };
@@ -297,8 +313,8 @@ function saveConfig(partial) {
     ensureDir(CONFIG_DIR);
     const cur = (() => { try { return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8')); } catch { return {}; } })();
     // Só persiste o que faz sentido guardar — nada de campos derivados.
-    const { server, model, effort, token, autoApply, currentProject, userName, mascot, theme, mode } = { ...cur, ...partial };
-    const next = { server, model, effort, token, autoApply, currentProject, userName, mascot, theme, mode };
+    const { server, model, effort, token, autoApply, currentProject, userName, mascot, reacoes, theme, mode, permissoes } = { ...cur, ...partial };
+    const next = { server, model, effort, token, autoApply, currentProject, userName, mascot, reacoes, theme, mode, permissoes };
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(next, null, 2), 'utf8');
     return next;
 }
@@ -338,6 +354,7 @@ function esquecerProjeto() {
 }
 
 module.exports = {
+    tokensDoAssunto, GENERICAS,
     lembrarProjeto, projetoLembrado, esquecerProjeto, PROJETO_ATIVO_FILE,
     loadConfig, saveConfig, appendHistory,
     CONFIG_DIR, CONFIG_FILE, HISTORY_FILE, ROOT_DIR, GENERAL_MEMORY,

package/lib/estudio/acervo-site.js

@@ -0,0 +1,157 @@
+/**
+ * acervo-site.js — as fotos, os vídeos e os fatos da PRÓPRIA marca, tirados
+ * do site dela.
+ *
+ *   "Eu pedi um vídeo pra Paris Group pra anunciar a imersão: ele poderia
+ *    puxar imagens das imersões, vídeos, fotos, etc. e colocar no decorrer do
+ *    vídeo." · "Os roteiros são nada a ver." (25/09/2026)
+ *
+ * O roteiro saía inventado ("sem data, preço nem local", anotou o próprio
+ * modelo) e as imagens eram de banco. O site da marca tem as duas coisas: a
+ * página da imersão diz "6 a 8 out · Chapecó/SC · 20 cadeiras", e a galeria
+ * tem as fotos da sala. Aqui se lê a página inicial e as páginas internas
+ * que combinam com o pedido, e sai:
+ *
+ *   - fotos: as maiores que o site oferece (o maior "w" do srcset), sem logo,
+ *     ícone, SVG nem miniatura;
+ *   - vídeos: os .mp4 que a página toca (depoimento, bastidor);
+ *   - fatos: o texto de cada página, limpo — a matéria-prima do roteiro.
+ */
+
+'use strict';
+
+const { URL } = require('url');
+
+const PALAVRAS_BOAS = ['galeria', 'imers', 'evento', 'sobre', 'about', 'portfolio', 'cases', 'case', 'turma', 'curso', 'produto', 'servic', 'equipe', 'time'];
+const RUIM = /(logo|icon|favicon|sprite|avatar|emoji|badge|\/brand\/|placeholder|blank|pixel|\.svg(\?|$)|-sm\.|\.sm\.|thumb)/i;
+
+function limpar(t) { return String(t || '').replace(/\s+/g, ' ').trim(); }
+
+/** O texto da página, sem script, estilo, menu nem rodapé repetido. */
+function textoDaPagina(html) {
+    let t = String(html || '')
+        .replace(/<script[\s\S]*?<\/script>|<style[\s\S]*?<\/style>|<noscript[\s\S]*?<\/noscript>/gi, ' ')
+        .replace(/<(nav|footer|header)[\s\S]*?<\/\1>/gi, ' ')
+        .replace(/<br\s*\/?>|<\/(p|h\d|li|div|section)>/gi, '. ')
+        .replace(/<[^>]+>/g, ' ');
+    t = t.replace(/&nbsp;/g, ' ').replace(/&amp;/g, '&').replace(/&quot;/g, '"').replace(/&#39;/g, "'").replace(/&[a-z]+;/g, ' ');
+    return limpar(t).replace(/(\.\s*){2,}/g, '. ').slice(0, 2200);
+}
+
+/** A versão maior de cada imagem: no srcset, o maior "w" até 2000. */
+function maiorDoSrcset(srcset) {
+    let melhor = null, largura = 0;
+    for (const parte of String(srcset).split(',')) {
+        const [u, w] = parte.trim().split(/\s+/);
+        const n = parseInt(w, 10) || 1;
+        if (u && n <= 2000 && n >= largura) { melhor = u; largura = n; }
+    }
+    return melhor;
+}
+
+// A mesma foto em tamanhos diferentes (x.sm.webp, x.md.webp, x.lg.webp) é UMA foto.
+const chaveDe = (u) => u.replace(/[?#].*$/, '').replace(/\.(sm|md|lg|xl|\d{2,4}w?)(?=\.[a-z]+$)/i, '').replace(/-\d{3,4}(?=\.[a-z]+$)/, '');
+
+function colherMidia(html, base) {
+    const abs = (u) => { try { return new URL(String(u).replace(/\\\//g, '/'), base).toString(); } catch { return null; } };
+    const fotos = new Map(), videos = new Map();
+    const pesoDe = (u) => (/\.lg\.|1800w|1920|2000/.test(u) ? 3 : /\.md\.|1280/.test(u) ? 2 : 1);
+    const poe = (mapa, u, alt = '') => {
+        const a = abs(u);
+        if (!a || RUIM.test(a) || a.startsWith('data:')) return;
+        const k = chaveDe(a);
+        const atual = mapa.get(k);
+        // Sem alt, o nome do arquivo descreve a foto ("palestrante-plateia-mesas").
+        const doNome = decodeURIComponent(a.split('/').pop().replace(/\.[a-z0-9]+$/i, '').replace(/\.(sm|md|lg)$/i, ''))
+            .replace(/^\d+[-_]?/, '').replace(/[-_]+/g, ' ').replace(/\b(dsc|img|hero)\b\s*\d*/gi, '').trim();
+        if (!atual || pesoDe(a) > pesoDe(atual.url)) mapa.set(k, { url: a, alt: limpar(alt).slice(0, 120) || (atual && atual.alt) || doNome });
+    };
+    let m;
+    const reImg = /<img\b[^>]*>/gi;
+    while ((m = reImg.exec(html))) {
+        const tag = m[0];
+        const alt = (tag.match(/\balt=["']([^"']*)/i) || [])[1] || '';
+        const srcset = (tag.match(/\b(?:srcset|data-srcset)=["']([^"']+)/i) || [])[1];
+        const src = (srcset && maiorDoSrcset(srcset)) || (tag.match(/\b(?:data-src|src)=["']([^"']+)/i) || [])[1];
+        if (src && /\.(jpe?g|png|webp|avif)(\?|$)/i.test(src)) poe(fotos, src, alt);
+    }
+    // Sites em Next/React guardam a galeria num JSON dentro da página: o
+    // caminho da mídia aparece como texto, não como <img>.
+    const reSolto = /["'(]((?:https?:)?\/[^"'()\s]+?\.(?:jpe?g|png|webp|avif|mp4|webm))(?:\?[^"'()\s]*)?["')]/gi;
+    while ((m = reSolto.exec(html))) {
+        const u = m[1];
+        if (/\.(mp4|webm)$/i.test(u)) poe(videos, u);
+        else poe(fotos, u);
+    }
+    const og = (html.match(/<meta[^>]+property=["']og:image["'][^>]+content=["']([^"']+)/i) || [])[1];
+    if (og) poe(fotos, og, 'capa do site');
+    return { fotos: [...fotos.values()], videos: [...videos.values()] };
+}
+
+/** As páginas internas que valem a leitura para ESTE pedido. */
+function paginasRelevantes(html, base, pedido, max = 5) {
+    const host = new URL(base).hostname;
+    const termos = String(pedido || '').normalize('NFD').replace(/[̀-ͯ]/g, '').toLowerCase()
+        .split(/[^a-z0-9]+/).filter((w) => w.length >= 4);
+    const vistos = new Set();
+    const lista = [];
+    const re = /href=["']([^"'#]+)["']/gi;
+    let m;
+    while ((m = re.exec(html))) {
+        let u;
+        try { u = new URL(m[1], base); } catch { continue; }
+        if (u.hostname !== host || /\.(css|js|png|jpe?g|svg|webp|pdf|ico|xml|json)$/i.test(u.pathname)) continue;
+        const caminho = u.pathname.replace(/\/$/, '');
+        if (!caminho || vistos.has(caminho) || /privacidade|privacy|termos|terms|login|blog\/|cdn-cgi/.test(caminho)) continue;
+        vistos.add(caminho);
+        const c = caminho.toLowerCase();
+        const pontos = termos.filter((t) => c.includes(t.slice(0, 6))).length * 3
+            + PALAVRAS_BOAS.filter((w) => c.includes(w)).length;
+        if (pontos > 0) lista.push({ url: u.toString(), pontos });
+    }
+    return lista.sort((a, b) => b.pontos - a.pontos).slice(0, max).map((x) => x.url);
+}
+
+/**
+ * Lê o site e baixa o acervo para a pasta do projeto.
+ *
+ * @param {object} op
+ * @param {string} op.url
+ * @param {string} op.pedido      o que o usuário pediu (decide quais páginas ler)
+ * @param {string} op.pasta       a pasta do projeto
+ * @param {function} op.buscar    (url) → {corpo} — o leitor de página do identidade.js
+ * @param {function} op.baixar    (item, {pasta, nome, sub}) → {ok, relativo} — o do assets.js
+ */
+async function colher({ url, pedido = '', pasta, buscar, baixar, maxFotos = 16, maxVideos = 4, htmlInicial = null }) {
+    const paginas = [];
+    const inicial = htmlInicial || (await buscar(url)).corpo;
+    paginas.push({ url, html: inicial });
+    for (const u of paginasRelevantes(inicial, url, pedido)) {
+        try { paginas.push({ url: u, html: (await buscar(u)).corpo }); } catch { /* página que não abriu fica de fora */ }
+    }
+
+    const fatos = paginas.map((p) => ({ pagina: p.url, texto: textoDaPagina(p.html) })).filter((f) => f.texto.length > 80);
+    const fotosVistas = new Map(), videosVistos = new Map();
+    // As páginas internas primeiro: a galeria tem mais foto de verdade que a home.
+    for (const p of [...paginas.slice(1), paginas[0]]) {
+        const { fotos, videos } = colherMidia(p.html, p.url);
+        for (const f of fotos) if (!fotosVistas.has(chaveDe(f.url))) fotosVistas.set(chaveDe(f.url), { ...f, pagina: p.url });
+        for (const v of videos) if (!videosVistos.has(chaveDe(v.url))) videosVistos.set(chaveDe(v.url), { ...v, pagina: p.url });
+    }
+
+    const fotos = [], videos = [];
+    for (const f of fotosVistas.values()) {
+        if (fotos.length >= maxFotos) break;
+        const d = await baixar({ url: f.url, titulo: f.alt || 'foto da marca', licenca: 'da própria marca', fonte: 'site' }, { pasta, nome: 'marca-foto', sub: 'midia/marca' });
+        // Menos de 25 KB é ícone ou miniatura, mesmo sem cara de ícone no nome.
+        if (d.ok && d.bytes > 25000) fotos.push({ src: d.relativo, alt: f.alt, pagina: f.pagina });
+    }
+    for (const v of videosVistos.values()) {
+        if (videos.length >= maxVideos) break;
+        const d = await baixar({ url: v.url, titulo: 'vídeo da marca', licenca: 'da própria marca', fonte: 'site' }, { pasta, nome: 'marca-video', sub: 'midia/marca' });
+        if (d.ok && d.bytes > 50000) videos.push({ src: d.relativo, pagina: v.pagina });
+    }
+    return { ok: true, paginas: paginas.map((p) => p.url), fatos, fotos, videos };
+}
+
+module.exports = { colher, colherMidia, paginasRelevantes, textoDaPagina, maiorDoSrcset };

package/lib/estudio/assets.js

@@ -120,7 +120,41 @@ const COLECOES = [
  * O SVG vem com `currentColor` no traço para a cor ser decidida na cena — um
  * ícone com cor cravada no arquivo obriga a baixar de novo para mudar de cor.
  */
+/* ── EMOJI 3D ─────────────────────────────────────────────────────────
+ * "Os emojis, quero emojis da Apple." (25/09/2026) Os da Apple têm direito
+ * autoral e não podem ir num vídeo publicado; os Fluent 3D da Microsoft têm
+ * licença MIT e o mesmo visual brilhante e com volume. "fluent-3d:robot" é o
+ * PNG do repositório oficial (pelo jsDelivr), embutido como <img> — o resto
+ * do render trata igual a um ícone SVG. Sem o 3D, cai no emoji plano. */
+const cache3d = new Map();
+async function emoji3d(nome, { pasta = null } = {}) {
+    if (cache3d.has(nome)) return cache3d.get(nome);
+    const palavras = nome.split('-');
+    const pastas = [
+        palavras.join(' ').replace(/^./, (c) => c.toUpperCase()),
+        palavras.map((w) => w[0].toUpperCase() + w.slice(1)).join(' '),
+    ];
+    for (const pastaGit of pastas) {
+        const url = `https://cdn.jsdelivr.net/gh/microsoft/fluentui-emoji@main/assets/${encodeURIComponent(pastaGit)}/3D/${palavras.join('_')}_3d.png`;
+        try {
+            const png = await pegar(url, { binario: true });
+            if (png && png.length > 1000 && png[0] === 0x89) {
+                if (pasta) guardar(path.join(pasta, 'midia', 'icones', `fluent-3d-${nome}.png`), png, { licenca: 'MIT (Microsoft Fluent UI Emoji)', origem: url });
+                const r = { ok: true, nome: 'fluent-3d:' + nome,
+                    svg: `<img src="data:image/png;base64,${png.toString('base64')}" style="width:100%;height:100%;object-fit:contain;display:block" />` };
+                cache3d.set(nome, r);
+                return r;
+            }
+        } catch { /* a próxima grafia */ }
+    }
+    const plano = await icone('fluent-emoji-flat:' + nome, { pasta });
+    const r = plano.ok ? { ...plano, nome: 'fluent-3d:' + nome } : plano;
+    cache3d.set(nome, r);
+    return r;
+}
+
 async function icone(nome, { pasta = null } = {}) {
+    if (/^fluent-3d:/i.test(String(nome))) return emoji3d(String(nome).split(':')[1], { pasta });
     const m = String(nome || '').match(/^([a-z0-9-]+):([a-z0-9-]+)$/i);
     if (!m) return { ok: false, error: 'o ícone é "coleção:nome", como "lucide:zap"' };
     const url = `https://api.iconify.design/${m[1]}/${m[2]}.svg?color=currentColor`;
@@ -213,7 +247,28 @@ function extensaoPorConteudo(bytes) {
  *
  * @returns {{ok, imagens: Array<{url, titulo, autor, licenca, creditos, fonte}>}}
  */
-async function procurarImagens(termo, { quantas = 8, transparente = false } = {}) {
+/* O Pexels pelo SERVIDOR: a chave é dele, e ninguém precisa ter uma. Sem
+   servidor (ou sem a chave lá), devolve null e a busca segue no Openverse. */
+async function pexelsDoServidor(tipo, termo, { quantas, orientacao } = {}) {
+    try {
+        const cfg = require('../config').loadConfig();
+        const r = await require('../api').getMidia(cfg.server, cfg.token, tipo, { q: termo, n: quantas, orientacao });
+        const lista = r && r.ok ? r[tipo] : null;
+        return lista && lista.length ? lista : null;
+    } catch { return null; }
+}
+
+/** Procura vídeo de apoio (b-roll). Só Pexels: o Openverse não tem vídeo. */
+async function procurarVideos(termo, { quantas = 5, orientacao = null } = {}) {
+    const videos = await pexelsDoServidor('videos', termo, { quantas, orientacao });
+    return videos ? { ok: true, videos } : { ok: false, error: 'sem acervo de vídeo agora (o servidor está sem a chave do Pexels).', videos: [] };
+}
+
+async function procurarImagens(termo, { quantas = 8, transparente = false, orientacao = null } = {}) {
+    if (!transparente && !process.env.PEXELS_API_KEY) {
+        const imagens = await pexelsDoServidor('imagens', termo, { quantas, orientacao });
+        if (imagens) return { ok: true, imagens };
+    }
     const chave = process.env.PEXELS_API_KEY;
     if (chave && !transparente) {
         try {
@@ -256,14 +311,33 @@ async function procurarImagens(termo, { quantas = 8, transparente = false } = {}
  * `duracaoMin` existe para separar as duas coisas sem o usuário dizer: um
  * "whoosh" tem menos de dois segundos, uma trilha tem mais de trinta.
  */
+/* A MÚSICA vem da Jamendo (pelo Openverse): música de verdade, moderna, de
+   licença aberta. O Openverse geral devolvia concerto antigo, vento e trilha
+   de terror para "cinematic" (medido em 25/09). Licença "nd" (sem obra
+   derivada) fica de fora da música: pôr a faixa num vídeo editado é derivar. */
+async function procurarMusica(termo, { quantas = 8, duracaoMin = 45 } = {}) {
+    try {
+        const r = await pegar(`https://api.openverse.org/v1/audio/?q=${encodeURIComponent(termo)}&source=jamendo`
+            + `&page_size=${Math.max(quantas * 2, 10)}&license_type=commercial`, { json: true });
+        const sons = (r.results || [])
+            .filter((x) => !/nd/.test(x.license || '') && (!duracaoMin || (x.duration || 0) / 1000 >= duracaoMin))
+            .slice(0, quantas)
+            .map((x) => ({ url: x.url, titulo: x.title || termo, autor: x.creator, licenca: x.license, creditos: x.attribution,
+                fonte: 'jamendo', segundos: x.duration ? Math.round(x.duration / 1000) : null }));
+        if (sons.length) return { ok: true, sons };
+    } catch { /* cai no Openverse geral */ }
+    return procurarSom(termo, { quantas, duracaoMin });
+}
+
 async function procurarSom(termo, { quantas = 8, duracaoMin = 0, duracaoMax = 0 } = {}) {
     try {
         let url = `https://api.openverse.org/v1/audio/?q=${encodeURIComponent(termo)}`
             + `&page_size=${quantas}&license_type=commercial`;
-        if (duracaoMin) url += `&length=${duracaoMin < 30 ? 'short' : 'medium'}`;
+        if (duracaoMin && duracaoMin < 30) url += '&length=short';
         const r = await pegar(url, { json: true });
         const sons = (r.results || [])
             .filter((x) => !duracaoMax || !x.duration || x.duration / 1000 <= duracaoMax)
+            .filter((x) => !duracaoMin || !x.duration || x.duration / 1000 >= duracaoMin)
             .map((x) => ({
                 url: x.url, titulo: x.title || termo, autor: x.creator,
                 licenca: x.license, creditos: x.attribution, fonte: 'openverse',
@@ -337,7 +411,7 @@ async function conferirFonte(familia) {
 module.exports = {
     extensaoPorConteudo,
     pegar, guardar,
-    icone, procurarIcones, iconesDoPlano, COLECOES,
+    icone, procurarIcones, iconesDoPlano, COLECOES, procurarVideos, procurarMusica,
     procurarImagens, procurarSom, baixar,
     FONTES, conferirFonte,
 };

package/lib/estudio/cinema.js

@@ -0,0 +1,277 @@
+/**
+ * cinema.js — o estilo cinematográfico, premium e humano.
+ *
+ *   "Os efeitos sonoros estão genéricos e sem impacto, a paleta da Paris não
+ *    é laranja, as cenas têm muito texto e não dá de ler antes de trocar, e
+ *    os textos não têm nada a ver com o roteiro." — e veio o roteiro dele:
+ *    "cinematográfico, premium, moderno e humano… poucas palavras por tela…
+ *    fotos nunca estáticas… NÃO usar excesso de efeitos… a abertura não
+ *    mostra o logo." (25/09/2026)
+ *
+ * O contrário do impacto: o texto entra com calma e FICA enquanto é falado
+ * (a voz lê o que está na tela), as fotos se movem sempre (zoom, pan,
+ * lateral), o preto é quase absoluto, o destaque é o gradiente da marca, a
+ * música cresce e silencia antes do clímax, e a marca só aparece no fim.
+ *
+ * Tipos de parte (todos com "fala" opcional; sem ela, a voz lê os textos):
+ *   frase      {linhas}                       preto, linha fina, texto
+ *   montagem   {linhas, ritmo}                fotos rápidas + texto por cima
+ *   numeros    {antes, itens:["3 EDIÇÕES"]}   os números contando
+ *   escada     {itens, final}                 "UMA SALA." "20 CADEIRAS." …
+ *   dia        {num, titulo, linhas}          01 PREPARAR + as três linhas
+ *   depoimento {clipes:[{src,de,ate,frase,nome}]}  o aluno falando
+ *   climax     {linhas}                       montagem acelerada, preto, silêncio
+ *   final      {linhas}                       a logo e a chamada
+ */
+
+'use strict';
+
+const { caber } = require('./composicao.js');
+
+const r2 = (n) => Math.round(n * 100) / 100;
+const tokens = (t) => String(t || '').normalize('NFD').replace(/[̀-ͯ]/g, '').toLowerCase().split(/[^a-z0-9]+/).filter(Boolean);
+
+/** Quanto tempo um texto precisa ficar na tela para ser lido. */
+const leitura = (t) => 0.55 + 0.22 * String(t || '').split(/\s+/).filter(Boolean).length;
+
+/** A fala desta parte (o que a voz diz): a "fala", ou os textos da tela. */
+function falaDe(p) {
+    if (p.fala) return p.fala;
+    if (p.tipo === 'depoimento') return '';
+    const partes = [p.antes, ...(p.linhas || []), ...(p.itens || []), p.num ? `Dia ${p.num}.` : '', p.titulo, p.final];
+    return partes.filter(Boolean).map((x) => String(x).replace(/[·→]/g, ',')).join(' ');
+}
+
+/* Quando cada texto começa, pelo tempo das palavras da voz: procura a
+   primeira palavra do texto a partir de onde parou. */
+function quando(textos, palavras, dur, t0 = 0.25) {
+    const ws = palavras.map((w) => ({ ...w, k: tokens(w.texto)[0] || '' }));
+    let cursor = 0;
+    return textos.map((txt, i) => {
+        const alvo = tokens(txt).find((w) => w.length >= 3) || tokens(txt)[0];
+        let achado = -1;
+        for (let j = cursor; j < ws.length; j++) if (ws[j].k === alvo || (alvo && ws[j].k.startsWith(alvo.slice(0, 5)))) { achado = j; break; }
+        if (achado >= 0) { cursor = achado + 1; return r2(ws[achado].de); }
+        return r2(t0 + (dur - t0) * (i / Math.max(1, textos.length)));
+    });
+}
+
+function montarCinema({ roteiro, largura = 1920, altura = 1080, tempos = [], narracao = null, sons = {}, trilha = null, fotos = [] }) {
+    const partes = (roteiro && roteiro.partes) || [];
+    if (!partes.length) return { ok: false, error: 'o roteiro veio sem partes.' };
+    const marca = roteiro.marca || {};
+    const grad = marca.gradiente && marca.gradiente.length >= 2 ? marca.gradiente : ['#2E81ED', '#9567DB'];
+    const PRETO = (marca.cores && marca.cores.fundo) || '#07070A';
+    const BRANCO = '#F5F5F7';
+    const DEST = grad[1];
+    const F = { titulo: (marca.fontes && marca.fontes.titulo) || 'Inter', texto: (marca.fontes && marca.fontes.texto) || 'Inter' };
+    const W = largura, H = altura, deitado = W >= H;
+    const M = Math.round(Math.min(W, H) * 0.08), W0 = W - 2 * M;
+    const base = Math.min(W, H);
+    const cenas = [], trechos = [], efeitos = [], volumes = [];
+    let t = 0, fotoI = 0;
+    const foto = () => fotos[fotoI++ % Math.max(1, fotos.length)];
+    const som = (tt, nome, volume = 0.6) => { if (sons[nome]) efeitos.push({ t: r2(Math.max(0, tt)), src: sons[nome], volume }); };
+    const vol = (tt, v) => volumes.push({ t: r2(tt), v });
+
+    // Os movimentos da foto, em rodízio: nunca parada.
+    const movs = [
+        (d) => ({ escala: [{ t: 0, v: 1.02 }, { t: d, v: 1.16, e: 'linear' }] }),
+        (d) => ({ escala: [{ t: 0, v: 1.18 }, { t: d, v: 1.06, e: 'linear' }] }),
+        (d) => ({ escala: [{ t: 0, v: 1.14 }, { t: d, v: 1.14 }], x: [{ t: 0, v: -W * 0.04 }, { t: d, v: W * 0.04, e: 'linear' }] }),
+        (d) => ({ escala: [{ t: 0, v: 1.14 }, { t: d, v: 1.14 }], x: [{ t: 0, v: W * 0.04 }, { t: d, v: -W * 0.04, e: 'linear' }] }),
+    ];
+    let mov = 0;
+    const pFoto = (els, f, de, ate, { veu = 0.5, entrada = 'corte' } = {}) => {
+        if (!f) return;
+        const d = r2(ate - de), v = f.tipo === 'video';
+        els.push({ tipo: v ? 'video' : 'imagem', src: f.src, ...(v ? { volume: 0 } : {}), x: 0, y: 0, largura: '100%', altura: '100%', ajuste: 'cover', foco: 'center 30%', de: r2(de), ate: r2(ate),
+            anima: { ...movs[mov++ % movs.length](d), ...(entrada === 'suave' ? { opacidade: [{ t: 0, v: 0 }, { t: 0.4, v: 1 }] } : {}) } });
+        if (veu > 0) els.push({ tipo: 'forma', forma: 'retangulo', x: 0, y: 0, largura: '100%', altura: '100%', de: r2(de), ate: r2(ate),
+            fundo: { tipo: 'gradiente', cores: [`rgba(7,7,10,${veu * 0.7})`, `rgba(7,7,10,${veu})`, `rgba(7,7,10,${Math.min(0.95, veu + 0.25)})`], angulo: 180 } });
+    };
+    // O texto: entra palavra por palavra no tempo da voz e fica; as palavras marcadas no gradiente.
+    const pTexto = (els, texto, de, ate, { y = null, max = deitado ? H * 0.11 : W * 0.13, linhas = 3, peso = 700, caixa = true, marcar = [], cor = BRANCO, pal = [], alinhar = 'center', x = M, larg = W0 } = {}) => {
+        const txt = caixa ? String(texto).toUpperCase() : String(texto);
+        const fit = caber(txt, { largura: larg * 0.86, linhas, max, fonte: F.titulo });
+        const h = fit.tamanho * 1.08 * fit.linhas;
+        const ws = txt.split(/\s+/);
+        /* Centralizado, a linha entra inteira: palavra por palavra, as que ainda
+           não foram ditas ocupam espaço invisível e o começo da frase aparece
+           torto, puxado para a esquerda. Alinhado à esquerda, palavra por palavra. */
+        const rev = ws.map((_, k) => (alinhar === 'center' ? 0 : r2(Math.max(0, (pal[k] != null ? pal[k] : de + 0.08 * k) - de))));
+        const idx = ws.map((w, k) => (marcar.some((m) => tokens(w)[0] && tokens(m).includes(tokens(w)[0])) ? k : -1)).filter((k) => k >= 0);
+        els.push({ tipo: 'texto', texto: txt, fonte: F.titulo, peso, tamanho: fit.tamanho, cor, entrelinha: 1.08, espacamento: caixa ? 1 : 0,
+            x: Math.round(x), y: Math.round(y == null ? (H - h) / 2 : y), largura: Math.round(larg), alinhamento: alinhar, de: r2(de), ate: r2(ate),
+            revelar: rev, ...(idx.length ? { destaques: idx, corDestaque: DEST } : {}),
+            anima: { opacidade: [{ t: 0, v: 1 }, { t: Math.max(0.01, ate - de - 0.25), v: 1 }, { t: ate - de, v: 0 }], y: [{ t: 0, v: 10 }, { t: ate - de, v: -6, e: 'linear' }] } });
+        return h;
+    };
+    const linhaFina = (els, y, de, larg = W * 0.18) => els.push({ tipo: 'forma', forma: 'retangulo', x: Math.round((W - larg) / 2), y: Math.round(y), largura: Math.round(larg), altura: 2,
+        fundo: { tipo: 'gradiente', cores: [grad[0], grad[1]], angulo: 90 }, origem: 'center', de: r2(de), anima: { escalaX: [{ t: 0, v: 0 }, { t: 0.8, v: 1, e: 'saida' }] } });
+    const pontos = (els, de) => { for (let k = 0; k < 3; k++) els.push({ tipo: 'forma', forma: 'circulo', largura: 6, altura: 6, cor: k === 1 ? DEST : 'rgba(255,255,255,0.4)', x: Math.round(W / 2 - 18 + k * 15), y: Math.round(H - M * 1.2), de: r2(de), anima: { opacidade: [{ t: 0.2 * k, v: 0 }, { t: 0.2 * k + 0.3, v: 1 }] } }); };
+
+    let narrI = 0;
+    partes.forEach((p, i) => {
+        const els = [];
+        const cena = { fundo: { tipo: 'cor', valor: PRETO }, elementos: els, transicao: { tipo: 'corte', duracao: 0 } };
+        const narrada = p.tipo !== 'depoimento';
+        const tp = narrada ? (tempos[narrI++] || null) : null;
+        const off = 0.35;                                         // a voz entra um instante depois do corte
+        const falaDur = tp ? Math.min(tp.ate + 0.6, tempos[narrI] ? tempos[narrI].de : tp.ate + 0.6) - tp.de : 0;
+        const rel = (w) => r2(off + w - (tp ? tp.de : 0));        // tempo da voz → tempo da cena
+        const pals = tp ? tp.palavras || [] : [];
+        let dur;
+
+        /* O fim da fala: a transcrição marca o fim da última palavra um pouco
+           antes do fim de verdade, e cortar ali comia a última sílaba ("parece
+           que a narração não terminou", 25/09). O trecho vai até perto do
+           começo da próxima fala, com folga. */
+        const proxFala = tempos[narrI] ? tempos[narrI].de : null;
+        const fimFala = tp ? r2(Math.min(proxFala != null ? proxFala - 0.02 : tp.ate + 0.6, tp.ate + 0.6)) : 0;
+        if (tp && narracao) trechos.push({ src: narracao, t: r2(t + off), de: r2(tp.de), ate: fimFala, volume: 1 });
+
+        const textosDaParte = p.tipo === 'escada' ? [...(p.itens || []), p.final].filter(Boolean)
+            : p.tipo === 'numeros' ? [p.antes, ...(p.itens || [])].filter(Boolean)
+                : p.tipo === 'dia' ? [p.num, p.titulo, ...(p.linhas || [])].filter(Boolean)
+                    : (p.linhas || []);
+        const somaLeitura = textosDaParte.reduce((n, x) => n + leitura(x), 0);
+        // A cena dura a fala (com um respiro) — e nunca menos que o tempo de ler.
+        dur = r2(Math.max(falaDur + off + 0.45, somaLeitura * 0.8, 2));
+        const inicios = quando(textosDaParte, pals.map((w) => ({ ...w, de: rel(w.de) })), dur, off);
+        /* Cada texto garante o SEU tempo de leitura e empurra o seguinte: sincronia
+           com a voz é bom, ler é obrigatório. Se a leitura pede mais que a fala,
+           a cena cresce (medido: "EDIÇÕES" ficava meio segundo na tela). */
+        for (let k = 1; k < inicios.length; k++) inicios[k] = r2(Math.max(inicios[k], inicios[k - 1] + leitura(textosDaParte[k - 1])));
+        if (inicios.length) dur = r2(Math.max(dur, inicios[inicios.length - 1] + leitura(textosDaParte[inicios.length - 1]) + 0.3));
+        const fimDe = (k) => (k < inicios.length - 1 ? inicios[k + 1] : dur);
+        const palDo = (txt) => { const ws = String(txt).split(/\s+/); const a = pals.findIndex((w) => tokens(w.texto)[0] === tokens(ws[0])[0]); return a < 0 ? [] : ws.map((_, k) => (pals[a + k] ? rel(pals[a + k].de) : null)); };
+
+        if (p.tipo === 'frase') {
+            if (i === 0) { som(t + 0.1, 'teclado', 0.5); vol(t, 0.12); }
+            linhaFina(els, H * 0.5 - base * 0.12, 0.2);
+            textosDaParte.forEach((x, k) => pTexto(els, x, inicios[k], fimDe(k), { caixa: false, peso: 600, max: deitado ? H * 0.1 : W * 0.12, linhas: deitado ? 3 : 4, marcar: p.marcar || [], pal: palDo(x) }));
+        } else if (p.tipo === 'montagem' || p.tipo === 'climax') {
+            const rap = p.tipo === 'climax' ? 0.38 : (p.ritmo || 0.75);
+            const fimFotos = p.tipo === 'climax' && textosDaParte.length ? Math.max(1.8, inicios[0] - 0.4) : dur;
+            for (let a = 0; a < fimFotos; a += rap) pFoto(els, foto(), a, Math.min(fimFotos, a + rap), { veu: p.tipo === 'climax' ? 0.15 : 0.5 });
+            if (p.tipo === 'climax') {
+                vol(t, 0.5); vol(t + fimFotos - 0.3, 0.75); vol(t + fimFotos, 0.0); vol(t + dur - 0.2, 0.0);
+                som(t + fimFotos, 'impacto', 0.7);
+            } else { vol(t, 0.28); som(t, 'whoosh', 0.35); }
+            textosDaParte.forEach((x, k) => pTexto(els, x, Math.max(inicios[k], p.tipo === 'climax' ? fimFotos : 0), fimDe(k), { peso: 800, marcar: p.marcar || [], pal: palDo(x) }));
+        } else if (p.tipo === 'numeros') {
+            vol(t, 0.3);
+            for (let a = 0; a < dur; a += 1.2) pFoto(els, foto(), a, Math.min(dur, a + 1.2), { veu: 0.62 });
+            textosDaParte.forEach((x, k) => {
+                const m = String(x).match(/^(\d+)\s+(.*)$/);
+                if (k === 0 && p.antes) { pTexto(els, x, inicios[k], fimDe(k), { max: base * 0.08, peso: 700, pal: palDo(x) }); return; }
+                if (!m) { pTexto(els, x, inicios[k], fimDe(k), { pal: palDo(x) }); return; }
+                const tam = Math.round(deitado ? H * 0.24 : W * 0.3);
+                els.push({ tipo: 'texto', texto: m[1], fonte: F.titulo, peso: 800, tamanho: tam, cor: BRANCO, x: M, y: Math.round(H * 0.5 - tam * 0.75), largura: W0, alinhamento: 'center',
+                    de: inicios[k], ate: fimDe(k), contar: { ate: Number(m[1]), dur: 0.9 }, gradienteTexto: undefined,
+                    anima: { opacidade: [{ t: 0, v: 0 }, { t: 0.25, v: 1 }], escala: [{ t: 0, v: 0.92 }, { t: 0.6, v: 1, e: 'saida' }] } });
+                pTexto(els, m[2], inicios[k] + 0.3, fimDe(k), { y: H * 0.5 + tam * 0.3, max: base * 0.085, peso: 700, cor: DEST });
+            });
+        } else if (p.tipo === 'escada') {
+            vol(t, 0.22);
+            if (sons.sala) trechos.push({ src: sons.sala, t: r2(t), de: 0, ate: dur, volume: 0.25 });
+            // As fotos passam devagar numa janela, à direita (ou em cima, no vertical).
+            // No vertical a janela desce da zona do topo do Instagram e fica maior.
+            const jan = deitado ? { x: W * 0.56, y: M, l: W * 0.44 - M, a: H - 2 * M } : { x: M, y: H * 0.1, l: W0, a: H * 0.42 };
+            const itens = p.itens || [];
+            const hItem = Math.round(deitado ? H * 0.1 : W * 0.12);
+            const fimItens = p.final ? inicios[itens.length] : dur;
+            for (let a = 0; a < fimItens; a += 1.3) {
+                const f = foto();
+                if (f) els.push({ tipo: f.tipo === 'video' ? 'video' : 'imagem', src: f.src, ...(f.tipo === 'video' ? { volume: 0 } : {}), x: Math.round(jan.x), y: Math.round(jan.y), largura: Math.round(jan.l), altura: Math.round(jan.a), ajuste: 'cover', foco: 'center 30%', raio: 18, de: r2(a), ate: r2(Math.min(fimItens, a + 1.3)),
+                    anima: { ...movs[mov++ % movs.length](1.3), opacidade: [{ t: 0, v: 0 }, { t: 0.3, v: 1 }] } });
+            }
+            itens.forEach((x, k) => {
+                const yy = deitado ? H * 0.5 - (itens.length * hItem * 1.25) / 2 + k * hItem * 1.25 : H * 0.56 + k * hItem * 1.25;
+                pTexto(els, x, inicios[k], fimItens, { y: yy, max: hItem, linhas: 1, alinhar: 'left', larg: deitado ? W * 0.48 : W0, peso: 800, pal: palDo(x) });
+            });
+            if (p.final) pTexto(els, p.final, fimItens, dur, { marcar: p.marcar || [], pal: palDo(p.final) });
+        } else if (p.tipo === 'dia') {
+            vol(t, 0.32);
+            pFoto(els, foto(), 0, dur, { veu: 0.66, entrada: 'suave' });
+            som(t, 'whoosh', 0.3);
+            const tamN = Math.round(deitado ? H * 0.34 : W * 0.42);
+            els.push({ tipo: 'texto', texto: String(p.num), fonte: F.titulo, peso: 800, tamanho: tamN, cor: 'rgba(149,103,219,0.12)', contorno: `${Math.max(3, Math.round(base * 0.004))}px ${DEST}`,
+                x: M, y: Math.round(deitado ? H * 0.12 : H * 0.14), largura: W0, alinhamento: deitado ? 'left' : 'center',
+                anima: { opacidade: [{ t: 0, v: 0 }, { t: 0.6, v: 1 }], x: [{ t: 0, v: -20 }, { t: dur, v: 20, e: 'linear' }] } });
+            const yT = deitado ? H * 0.5 : H * 0.42;
+            const hT = pTexto(els, p.titulo, inicios[1] || 0.4, dur, { y: yT, max: deitado ? H * 0.11 : W * 0.13, linhas: 1, alinhar: deitado ? 'left' : 'center', larg: W0, peso: 800, pal: palDo(p.titulo) });
+            (p.linhas || []).forEach((x, k) => pTexto(els, x, inicios[2 + k] || 0.8 + k * 0.6, dur, { y: yT + hT + H * 0.03 + k * base * (deitado ? 0.085 : 0.1), max: base * (deitado ? 0.06 : 0.07), linhas: 1, caixa: false, peso: 500, cor: 'rgba(245,245,247,0.8)',
+                alinhar: deitado ? 'left' : 'center', larg: W0, pal: palDo(x) }));
+        } else if (p.tipo === 'depoimento') {
+            /* O aluno falando, com a voz dele; a música quase some. CADA depoimento
+               é uma cena: o vídeo conta o tempo do início da cena, e com os três
+               na mesma cena o segundo e o terceiro já tinham passado do fim (preto). */
+            vol(t, 0.06);
+            const clipes = p.clipes || [];
+            clipes.forEach((c, n) => {
+                const d = r2(c.ate - c.de + 0.3);
+                const ce = { fundo: { tipo: 'cor', valor: PRETO }, elementos: [], transicao: { tipo: n === 0 ? 'esmaecer' : 'corte', duracao: n === 0 ? 0.4 : 0 }, duracao: d };
+                const el2 = ce.elementos;
+                if (deitado) {
+                    const wV = Math.round(H * 0.88 * 9 / 16), xV = Math.round(W * 0.08), xT = xV + wV + Math.round(W * 0.05);
+                    el2.push({ tipo: 'video', src: c.src, volume: 0, deOrigem: c.de, ateOrigem: c.ate + 0.3, x: 0, y: 0, largura: '100%', altura: '100%', ajuste: 'cover', anima: { desfoque: [{ t: 0, v: 40 }], brilho: [{ t: 0, v: 0.4 }] } });
+                    el2.push({ tipo: 'video', src: c.src, volume: 1, deOrigem: c.de, ateOrigem: c.ate + 0.3, x: xV, y: Math.round(H * 0.06), largura: wV, altura: Math.round(H * 0.88), ajuste: 'cover', raio: 20, anima: { opacidade: [{ t: 0, v: 0 }, { t: 0.2, v: 1 }] } });
+                    pTexto(el2, `“${c.frase}”`, 0.3, d, { x: xT, larg: W - xT - M, alinhar: 'left', caixa: false, peso: 600, max: H * 0.075, linhas: 5 });
+                    if (c.nome) el2.push({ tipo: 'texto', texto: c.nome.toUpperCase(), fonte: F.texto, peso: 700, tamanho: Math.round(H * 0.03), cor: DEST, espacamento: 3, x: xT, y: Math.round(H * 0.8), de: 0.5 });
+                } else {
+                    el2.push({ tipo: 'video', src: c.src, volume: 1, deOrigem: c.de, ateOrigem: c.ate + 0.3, x: 0, y: 0, largura: '100%', altura: '100%', ajuste: 'cover', foco: 'center 30%' });
+                    el2.push({ tipo: 'forma', forma: 'retangulo', x: 0, y: 0, largura: '100%', altura: '100%', fundo: { tipo: 'gradiente', cores: ['rgba(7,7,10,0)', 'rgba(7,7,10,0.35)', 'rgba(7,7,10,0.9)'], angulo: 180 } });
+                    // Tudo acima de 75% da altura: embaixo disso o Instagram põe a legenda e os botões.
+                    pTexto(el2, `“${c.frase}”`, 0.3, d, { y: H * 0.54, caixa: false, peso: 600, max: W * 0.08, linhas: 4 });
+                    if (c.nome) el2.push({ tipo: 'texto', texto: c.nome.toUpperCase(), fonte: F.texto, peso: 700, tamanho: Math.round(W * 0.035), cor: DEST, espacamento: 3, x: M, y: Math.round(H * 0.72), largura: W0, alinhamento: 'center', de: 0.5 });
+                }
+                if (n < clipes.length - 1) { cenas.push(ce); t += d; } else { Object.assign(cena, ce); dur = d; }
+            });
+            if (!clipes.length) dur = 1;
+        } else if (p.tipo === 'final') {
+            // A marca, enfim: a logo aparece devagar, as linhas em sequência, a logo some.
+            vol(t, 0.55); vol(t + dur - 1.8, 0.45); vol(t + dur, 0);
+            som(t + 0.05, 'impacto', 0.55);
+            const R = Math.round(Math.max(W, H) * 0.7);
+            els.push({ tipo: 'forma', forma: 'circulo', largura: R, altura: R, x: Math.round(W / 2 - R / 2), y: Math.round(H * 0.42 - R / 2), cor: grad[1], opacidade: 0.18, anima: { desfoque: [{ t: 0, v: Math.round(R * 0.25) }], escala: [{ t: 0, v: 0.8 }, { t: dur, v: 1.15, e: 'suave' }] } });
+            if (marca.logo) {
+                const lh = Math.round(base * (deitado ? 0.13 : 0.16));
+                els.push({ tipo: 'imagem', src: marca.logo, x: Math.round(W / 2 - lh * 1.75), y: Math.round(H * (deitado ? 0.2 : 0.3)), largura: Math.round(lh * 3.5), altura: lh, ajuste: 'contain',
+                    anima: { opacidade: [{ t: 0, v: 0 }, { t: 1.0, v: 1 }, { t: dur - 1.2, v: 1 }, { t: dur, v: 0 }], escala: [{ t: 0, v: 0.94 }, { t: dur, v: 1.02, e: 'linear' }] } });
+            }
+            const y0 = H * (deitado ? 0.44 : 0.42);
+            textosDaParte.forEach((x, k) => pTexto(els, x, inicios[k], k < textosDaParte.length - 1 ? fimDe(k) : dur, { y: y0 + (k % 2) * 0, max: k === textosDaParte.length - 1 ? base * (deitado ? 0.1 : 0.12) : base * (deitado ? 0.08 : 0.1), peso: k === textosDaParte.length - 1 ? 800 : 600,
+                marcar: p.marcar || [], cor: k === textosDaParte.length - 1 ? DEST : BRANCO, pal: palDo(x) }));
+            pontos(els, 0.3);
+            cena.transicao = { tipo: 'esmaecer', duracao: 0.6 };
+        }
+
+        // Entre as partes, um esmaecer curto: corte seco em tudo parecia fala interrompida.
+        if (i > 0 && cena.transicao.tipo === 'corte' && !['montagem', 'climax'].includes(p.tipo)) cena.transicao = { tipo: 'esmaecer', duracao: 0.35 };
+        cena.duracao = dur;
+        cenas.push(cena);
+        t += dur;
+    });
+
+    // Os cruzamentos são da cena que entra: a anterior fica no ar até ela entrar.
+    let acum = 0;
+    cenas.forEach((c, k) => {
+        const prox = cenas[k + 1];
+        c.duracao = r2(c.duracao + (prox && prox.transicao.tipo !== 'corte' ? prox.transicao.duracao : 0));
+        acum += c.duracao;
+    });
+    volumes.sort((a, b) => a.t - b.t);
+    return {
+        ok: true,
+        plano: {
+            formato: { largura: W, altura: H, fps: 30 }, fundoGeral: PRETO, cenas,
+            audio: { ...(trilha ? { trilha: { src: trilha, volumes: volumes.length ? volumes : [{ t: 0, v: 0.3 }], loop: true } } : {}), trechos, efeitos },
+            acabamento: { grao: 0.05, vinheta: 0.5, grade: 0.035, passoGrade: Math.round(base / 9) },
+        },
+        resumo: { cenas: cenas.length, estilo: 'cinema', segundos: r2(t) },
+    };
+}
+
+module.exports = { montarCinema, falaDe, quando, leitura };