primocode 10.16.0 → 10.17.0

package/lib/estudio/kit-ae/primitivas.jsx

@@ -13,6 +13,9 @@
 
 function kPre(comp, P) { var g = { W: comp.width, H: comp.height, u: kU(comp), v: kVert(comp), cam: kBase(comp, P) }; g.cx = g.W / 2; g.cy = g.H / 2; return g; }
 function kSobre(P) { return kLum(P.ac) > 0.5 ? '#14110F' : '#FFFFFF'; }
+/* O cartão em destaque vem da paleta da cena (maquina.js, cartaoDestaque): o acento quando é cor; senão o brilho. Nunca preto solto. */
+function kCardAc(P) { return P.cardAc || P.ac; }
+function kSobreCard(P) { return P.sobreCardAc || kSobre(P); }
 function kT(g, comp, P, str, y, o) {
     o = o || {};
     var t0 = o.t0 != null ? o.t0 : 0.14, W = g.W, H = g.H;
@@ -31,7 +34,13 @@ function kT(g, comp, P, str, y, o) {
     }
     return r;
 }
-function kItens(d, padrao, n) { var it = (d.itens && d.itens.length ? d.itens : padrao).slice(0, n || 5); return it; }
+/* Os itens da lista, sem repetir (o mesmo texto, ignorando caixa, acento e espaço, entra uma vez só): faltou item, a lista fica menor. */
+function kChaveItem(s) { return String(s || '').toLowerCase().replace(/[\*\s.,;:!?]+/g, '').replace(/[áàâã]/g, 'a').replace(/[éê]/g, 'e').replace(/[í]/g, 'i').replace(/[óôõ]/g, 'o').replace(/[ú]/g, 'u').replace(/ç/g, 'c'); }
+function kItens(d, padrao, n) {
+    var fonte = d.itens && d.itens.length ? d.itens : padrao, it = [], visto = {}, i;
+    for (i = 0; i < fonte.length && it.length < (n || 5); i++) { var k = kChaveItem(fonte[i]); if (!k || visto[k]) continue; visto[k] = 1; it.push(fonte[i]); }
+    return it;
+}
 function kEstrelaPts(r, ri) { var p = [], i; for (i = 0; i < 10; i++) { var a = -Math.PI / 2 + i * Math.PI / 5, rr = i % 2 ? ri : r; p.push([Math.cos(a) * rr, Math.sin(a) * rr]); } return p; }
 function kContr(a, b) { var x = kLum(a) + 0.05, y = kLum(b) + 0.05; return x > y ? x / y : y / x; }
 function kEsc(s) { return String(s).replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\r?\n/g, ' '); }
@@ -59,8 +68,10 @@ function cenaCinetico(comp, P, d) {
     var disco = forma(comp, 'circulo', { x: g.cx, y: g.cy, w: Math.min(W, H) * 0.9, cor: P.card, parent: cam.no, nome: 'disco' });
     for (i = 0; i < n; i++) {
         var ti = Q(pal[i].t, 0.14 + i * passo), fim = i < n - 1 ? Math.max(ti + 0.22, Q(pal[i + 1].t, 0.14 + (i + 1) * passo) - 0.02) : comp.duration;
-        var cor = pal[i].kw ? P.ac : (i % 2 ? P.fg : P.mudo == P.fg ? P.fg : P.fg);
-        var r = texto(comp, (pal[i].kw ? '*' : '') + pal[i].t, { tamanho: (g.v ? 230 : 200) * u, cor: i % 3 == 2 ? P.ac : P.fg, corDestaque: P.ac, x: g.cx, y: g.cy, parent: cam.no, entrada: modos[i % modos.length], t0: ti, largura: W * 0.84, maxLinhas: 1, sublinhado: false, fala: false, sobrepoe: true });
+        // a palavra tem que ficar INTEIRA e legível antes de sair (0,15 s de verdade: a cena nominal toca f× mais rápido); a letra
+        // que voa só entra se dá tempo de montar e ler
+        var modo = kEntradaQueCabe(modos[i % modos.length], pal[i].t, (i < n - 1 ? fim : comp.duration) - ti, 0.15 * (KIT.f || 1));
+        var r = texto(comp, (pal[i].kw ? '*' : '') + pal[i].t, { tamanho: (g.v ? 230 : 200) * u, cor: i % 3 == 2 ? P.ac : P.fg, corDestaque: P.ac, x: g.cx, y: g.cy, parent: cam.no, entrada: modo, t0: ti, largura: W * 0.84, maxLinhas: 1, sublinhado: false, fala: false, sobrepoe: true });
         var j; for (j = 0; j < r.camadas.length; j++) if (i < n - 1) curva(kO(r.camadas[j]), [[fim, 100, null, 30], [fim + 0.06, 0, 60, null]]);
         mola(kS(disco), ti, [88, 88], [100, 100], { quique: 0.5, dur: 0.45 });
         som(ti, i % 2 ? 'tique' : 'pop', 0.55);
@@ -97,8 +108,8 @@ function cenaInterface(comp, P, d) {
     var cx0 = sx + sw / 2 + 24 * u, cwid = ww / 2 - cx0 - 22 * u, k, vals = [d.valor || '+128', '4,9', '32'];
     for (k = 0; k < 3; k++) {
         var cw = (cwid - 2 * 18 * u) / 3, kx = cx0 + cw / 2 + k * (cw + 18 * u), ky = -wh / 2 + 160 * u, tk = Q(vals[k], T0 + 1.0 + k * 0.2);
-        var cd = forma(comp, 'retangulo', { x: kx, y: ky, w: cw, h: 130 * u, r: 24 * u, cor: k == 0 ? P.ac : P.bg, alfa: k == 0 ? 100 : 70, parent: frente, entrada: 'pop', t0: tk, quique: 0.6, nome: 'card' });
-        texto(comp, String(vals[k]), { fonte: P.fonteTitulo, tamanho: 46 * u, cor: k == 0 ? kSobre(P) : P.fg, x: kx, y: ky - 6 * u, parent: frente, entrada: 'palavra', t0: tk + 0.08, largura: cw * 0.86, maxLinhas: 1, sublinhado: false, livre: true, fala: false });
+        var cd = forma(comp, 'retangulo', { x: kx, y: ky, w: cw, h: 130 * u, r: 24 * u, cor: k == 0 ? kCardAc(P) : P.bg, alfa: k == 0 ? 100 : 70, parent: frente, entrada: 'pop', t0: tk, quique: 0.6, nome: 'card' });
+        texto(comp, String(vals[k]), { fonte: P.fonteTitulo, tamanho: 46 * u, cor: k == 0 ? kSobreCard(P) : P.fg, x: kx, y: ky - 6 * u, parent: frente, entrada: 'palavra', t0: tk + 0.08, largura: cw * 0.86, maxLinhas: 1, sublinhado: false, livre: true, fala: false });
         som(tk, 'pop', 0.5);
     }
     // gráfico de barras dentro da janela
@@ -152,8 +163,8 @@ function cenaCameraNulls(comp, P, d) {
     for (i = 0; i < n; i++) {
         var ox = v ? 0 : i * gap, oy = v ? i * gap : 0, ti = Q(it[i], 0.3 + i * passo);
         ts.push(ti);
-        var c = forma(comp, 'retangulo', { x: ox, y: oy, w: pw, h: ph, r: 56 * u, cor: i % 2 ? P.card : P.ac, parent: zoom, nome: 'painel' });
-        var tc = i % 2 ? P.fg : kSobre(P), ta = i % 2 ? P.ac : kSobre(P);
+        var c = forma(comp, 'retangulo', { x: ox, y: oy, w: pw, h: ph, r: 56 * u, cor: i % 2 ? P.card : kCardAc(P), parent: zoom, nome: 'painel' });
+        var tc = i % 2 ? P.fg : kSobreCard(P), ta = i % 2 ? P.ac : kSobreCard(P);
         texto(comp, String(i + 1), { fonte: P.fonteTitulo, tamanho: 220 * u, cor: ta, corDestaque: ta, x: ox - pw * 0.28, y: oy - ph * 0.25, parent: zoom, entrada: 'palavra', t0: 0.3, largura: pw * 0.4, maxLinhas: 1, sublinhado: false, livre: true, fala: false });
         elemento(comp, i, { x: ox + pw * 0.25, y: oy - ph * 0.22, w: pw * 0.38, parent: zoom, flutua: 8, fase: i });
         texto(comp, it[i], { tamanho: 70 * u, cor: tc, corDestaque: ta, x: ox, y: oy + ph * 0.22, parent: zoom, entrada: 'mascara', t0: 0.4, largura: pw * 0.82, maxLinhas: 3, sublinhado: false, livre: true, fala: false });
@@ -185,7 +196,7 @@ function cenaBarras(comp, P, d) {
     var tops = [];
     for (i = 0; i < n; i++) {
         var altura = ah * (0.2 + 0.8 * Math.pow((i + 1) / n, 1.5)), bx = area[0] + gap * (i + 0.5), ti = Q(it[i], T0 + 0.3 + i * 0.4), ult = i == n - 1;
-        var b = forma(comp, 'retangulo', { x: bx, y: area[3], w: bw, h: altura, r: 18 * u, cor: ult ? P.ac : P.card, traco: ult ? null : P.mudo, tracoL: 3 * u, parent: cam.no, nome: 'barra' });
+        var b = forma(comp, 'retangulo', { x: bx, y: area[3], w: bw, h: altura, r: 18 * u, cor: ult ? kCardAc(P) : P.card, traco: ult ? null : P.mudo, tracoL: 3 * u, parent: cam.no, nome: 'barra' });
         kA(b).setValue([0, altura / 2]);
         mola(kS(b), ti, [100, 0], [100, 100], { quique: ult ? 0.7 : 0.4, dur: 0.7 });
         som(ti, ult ? 'impacto' : 'pop', ult ? 0.8 : 0.55);
@@ -274,14 +285,14 @@ function cenaCardsPulam(comp, P, d) {
     var cw = v ? W * 0.8 : W * 0.44, ch = Math.min(v ? H * 0.15 : H * 0.2, (H * 0.62) / n - 16 * u), top = v ? H * 0.31 : H * 0.5 - (n * (ch + 18 * u)) / 2 + ch / 2, cx0 = v ? g.cx : W * 0.72;
     for (i = 0; i < n; i++) {
         var y = top + i * (ch + 18 * u) + (v ? ch / 2 : 0), ti = Q(it[i], T0 + 0.3 + i * 0.42), ult = i == n - 1, rot = (i % 2 ? 1 : -1) * 5;
-        var c = forma(comp, 'retangulo', { x: cx0, y: y, w: cw, h: ch, r: 36 * u, cor: ult ? P.ac : P.card, traco: ult ? null : P.mudo, tracoL: 3 * u, parent: cam.no, nome: 'card' });
+        var c = forma(comp, 'retangulo', { x: cx0, y: y, w: cw, h: ch, r: 36 * u, cor: ult ? kCardAc(P) : P.card, traco: ult ? null : P.mudo, tracoL: 3 * u, parent: cam.no, nome: 'card' });
         mola(kP(c), ti, [cx0 + (i % 2 ? 1 : -1) * 40 * u, y + H * 0.45], [cx0, y], { quique: 0.75, dur: 0.85 });
         mola(kR(c), ti, rot * 2, 0, { quique: 0.6, dur: 0.9 });
         curva(kO(c), [[ti - 0.04, 0, null, 30], [ti, 100, null, 30]]);
         som(ti + 0.22, 'pop', 0.6);
         var ex = cx0 - cw / 2 + ch * 0.62;
         var ic = elemento(comp, i, { x: ex, y: y, w: ch * 0.78, parent: cam.no, entrada: 'pop', t0: ti + 0.3, quique: 0.7 });
-        texto(comp, it[i], { tamanho: Math.min(58 * u, ch * 0.42), cor: ult ? kSobre(P) : P.fg, corDestaque: ult ? kSobre(P) : P.ac, x: cx0 + ch * 0.4, y: y, parent: cam.no, entrada: 'sobe', t0: ti + 0.3, largura: cw - ch * 1.6, maxLinhas: 2, sublinhado: false, fala: false });
+        texto(comp, it[i], { tamanho: Math.min(58 * u, ch * 0.42), cor: ult ? kSobreCard(P) : P.fg, corDestaque: ult ? kSobreCard(P) : P.ac, x: cx0 + ch * 0.4, y: y, parent: cam.no, entrada: 'sobe', t0: ti + 0.3, largura: cw - ch * 1.6, maxLinhas: 2, sublinhado: false, fala: false });
     }
     cam.empurra(0.8, 0, -10 * u, 1.03).empurra(comp.duration - 0.2, 0, 20 * u, 1.08);
     fecha(comp);
@@ -314,20 +325,24 @@ function cenaCursor(comp, P, d) {
     var bt = botao(comp, { x: px, y: by, w: bw, h: bh, rotulo: d.botao || 'Enviar', cor: P.ac, corTexto: kSobre(P), t0: T0 + 0.4, tam: 46 * u, parent: cam.no });
     var cur = kCursor(comp, cam.no, u, P.fg, P.bg);
     var tc = T0 + 0.9, txt = d.texto || d.sub || d.rotulo || 'o que você quer';
+    // o cursor é elemento: clica no fim do campo (o texto digitado nasce à esquerda) e na borda do botão, nunca em cima de letra
+    var xt0 = px - campoW / 2 + 36 * u, wt = Math.min(kMedir(comp, txt, P.fonteTexto, 42 * u), campoW * 0.86);
+    var pc = kCursorNoBotao(comp, [px - campoW / 2, cy1 - campoH / 2, px + campoW / 2, cy1 + campoH / 2], { x: xt0 + wt / 2, y: cy1, w: wt + 12 * u, h: 60 * u }, 0, 0, 1, [px + campoW * 0.34, cy1 + 6 * u], u);
+    var pb = kCursorNoBotao(comp, [px - bt.w / 2, by - bt.h / 2, px + bt.w / 2, by + bt.h / 2], bt.texto, 0, 0, 1, [px + bt.w / 2 - bt.h * 0.45, by + bt.h * 0.12], u);
     kP(cur).setValue([px + pw * 0.6, py + ph * 0.9]);
-    curva(kP(cur), [[tc - 0.7, [px + pw * 0.6, py + ph * 0.9], null, 20], [tc, [px - campoW * 0.3, cy1 + 10 * u], 75, 30]]);
+    curva(kP(cur), [[tc - 0.7, [px + pw * 0.6, py + ph * 0.9], null, 20], [tc, pc, 75, 30]]);
     curva(kO(cur), [[tc - 0.7, 0, null, 30], [tc - 0.5, 100, 60, null]]);
     curva(kS(cur), [[tc, [100, 100], null, 25], [tc + 0.07, [82, 82], 70, 40], [tc + 0.2, [100, 100], 70, null]]);
     curva(kO(foco), [[tc, 0, null, 30], [tc + 0.12, 100, 60, null]]);
     som(tc, 'clique', 0.8);
     var dg = digita(comp, txt, { x: px - campoW / 2 + 36 * u, y: cy1, tamanho: 42 * u, fonte: P.fonteTexto, cor: P.fg, largura: campoW * 0.86, parent: cam.no, t0: tc + 0.25, cps: 26 });
     var t2 = Math.max(dg.fim + 0.15, tc + 0.9);
-    curva(kP(cur), [[tc + 0.1, [px - campoW * 0.3, cy1 + 10 * u], null, 25], [t2, [px + bw * 0.1, by + 8 * u], 75, 30]]);
+    curva(kP(cur), [[tc + 0.1, pc, null, 25], [t2, pb, 75, 30]]);
     curva(kS(cur), [[t2, [100, 100], null, 25], [t2 + 0.07, [82, 82], 70, 40], [t2 + 0.2, [100, 100], 70, null]]);
     bt.aperta(t2);
-    var res = forma(comp, 'pilula', { x: px, y: py + ph * 0.02, w: campoW * 0.9, h: 96 * u, cor: P.ac, parent: cam.no, entrada: 'pop', t0: t2 + 0.25, quique: 0.7, nome: 'resultado' });
-    check(comp, { x: px - campoW * 0.36, y: py + ph * 0.02, tam: 44 * u, cor: kSobre(P), parent: cam.no, t0: t2 + 0.4 });
-    texto(comp, d.rotulo || 'Pronto!', { fonte: P.fonteTitulo, tamanho: 44 * u, cor: kSobre(P), corDestaque: kSobre(P), x: px + 20 * u, y: py + ph * 0.02, parent: cam.no, entrada: 'sobe', t0: t2 + 0.3, largura: campoW * 0.6, maxLinhas: 1, sublinhado: false, livre: true, fala: false });
+    var res = forma(comp, 'pilula', { x: px, y: py + ph * 0.02, w: campoW * 0.9, h: 96 * u, cor: kCardAc(P), parent: cam.no, entrada: 'pop', t0: t2 + 0.25, quique: 0.7, nome: 'resultado' });
+    check(comp, { x: px - campoW * 0.36, y: py + ph * 0.02, tam: 44 * u, cor: kSobreCard(P), parent: cam.no, t0: t2 + 0.4 });
+    texto(comp, d.rotulo || 'Pronto!', { fonte: P.fonteTitulo, tamanho: 44 * u, cor: kSobreCard(P), corDestaque: kSobreCard(P), x: px + 20 * u, y: py + ph * 0.02, parent: cam.no, entrada: 'sobe', t0: t2 + 0.3, largura: campoW * 0.6, maxLinhas: 1, sublinhado: false, livre: true, fala: false });
     som(t2 + 0.28, 'brilho', 0.7);
     curva(kO(cur), [[t2 + 0.7, 100, null, 30], [t2 + 0.95, 0, 60, null]]);
     cam.empurra(0.8, 0, 0, 1.02).empurra(tc, 0, -10 * u, 1.06).empurra(t2 + 0.2, 0, 30 * u, 1.1).empurra(comp.duration - 0.2, 0, 40 * u, 1.12);
@@ -687,8 +702,29 @@ function cenaParedeLogos(comp, P, d) {
         }
     }
     kR(par).setValue(-8);
-    var plaquinha = forma(comp, 'retangulo', { x: g.cx, y: g.cy, w: W * (v ? 0.88 : 0.62), h: H * (v ? 0.2 : 0.26), r: 48 * u, cor: P.bg, traco: P.ac, tracoL: 8 * u, parent: cam.no, entrada: 'pop', t0: T0 + 0.7, quique: 0.5, nome: 'faixa' });
-    kT(g, comp, P, d.titulo || '', g.cy, { maxLinhas: 2, tam: v ? 84 : 72, t0: T0 + 0.8, largura: W * (v ? 0.8 : 0.56), sobrepoe: true });
+    var pw0 = W * (v ? 0.88 : 0.62), ph0 = H * (v ? 0.2 : 0.26);
+    var plaquinha = forma(comp, 'retangulo', { x: g.cx, y: g.cy, w: pw0, h: ph0, r: 48 * u, cor: P.bg, traco: P.ac, tracoL: 8 * u, parent: cam.no, nome: 'faixa' });
+    var n0 = comp.numLayers;
+    var tt = kT(g, comp, P, d.titulo || '', g.cy, { maxLinhas: 2, tam: v ? 84 : 72, t0: T0 + 0.8, largura: W * (v ? 0.8 : 0.56), sobrepoe: true });
+    // texto dentro de cartão, pela guarda: cabe com folga; senão o corpo encolhe até o mínimo; senão a faixa cresce (o texto
+    // principal ganha linha e "PrimoCode" e "de bolso" vazavam da faixa fixa)
+    if (tt && tt.h) {
+        var tc = [tt.x - tt.w / 2, tt.y - tt.h / 2, tt.x + tt.w / 2, tt.y + tt.h / 2], pc = [g.cx - pw0 / 2, g.cy - ph0 / 2, g.cx + pw0 / 2, g.cy + ph0 / 2];
+        var tMin = (H / W > 1.6 ? 112 : H * 0.036) * KIT.ajuste * KIT.ajusteCena;   // o piso do texto() (principal no 9:16, 3,6% fora)
+        var gc = gTextoNoCartao(tc, pc, { folga: 55 * u, kMin: Math.min(1, tMin / Math.max(1, tt.tam)), max: [W * 0.03, H * 0.1, W * 0.97, H * 0.9] });
+        if (gc.k < 0.999) {   // o corpo encolhe em volta do centro do bloco: cada camada criada pelo título (palavras, sublinhado)
+            var j0, cxT = tt.x, cyT = tt.y;
+            for (j0 = 1; j0 <= comp.numLayers - n0; j0++) { var Lt = comp.layer(j0), pv = kP(Lt).valueAtTime(comp.duration, false); kDesloca(Lt, (pv[0] - cxT) * (gc.k - 1), (pv[1] - cyT) * (gc.k - 1), gc.k); }
+        }
+        if (gc.cresceu) {
+            var pw = gW(gc.cartao), ph = gH(gc.cartao);
+            try { plaquinha.property('ADBE Root Vectors Group').property(1).property('ADBE Vectors Group').property('ADBE Vector Shape - Rect').property('ADBE Vector Rect Size').setValue([pw, ph]); }
+            catch (e) { kS(plaquinha).setValue([100 * pw / pw0, 100 * ph / ph0]); }
+            kP(plaquinha).setValue([gCx(gc.cartao), gCy(gc.cartao)]);
+        }
+        if (gc.log.length) writeLn('GUARDA ' + JSON.stringify({ cena: KIT.cenaIdx, w: W, h: H, log: gc.log, caixas: [{ tipo: 'cartao', nome: 'faixa do título', c: [Math.round(gc.cartao[0]), Math.round(gc.cartao[1]), Math.round(gc.cartao[2]), Math.round(gc.cartao[3])], fora: 0 }], violacoes: gc.ok ? [] : ['título maior que a faixa máxima'] }));
+    }
+    kEntrada(plaquinha, T0 + 0.7, 'pop', 0.5);
     som(T0, 'sobe', 0.5); som(T0 + 0.7, 'impacto', 0.7);
     cam.empurra(0.8, 0, 0, 1.0).empurra(comp.duration - 0.2, 0, 0, 1.08);
     fecha(comp);
@@ -719,10 +755,10 @@ function cenaPrompt(comp, P, d) {
     for (i = 0; i < n; i++) {
         var ry = by + 70 * u + rh / 2 + i * (rh + 14 * u), ti = Q(it[i], tr + i * 0.2);
         ti = Math.max(ti, tr);
-        forma(comp, 'retangulo', { x: px, y: ry, w: iw, h: rh, r: 26 * u, cor: i == 0 ? P.ac : P.bg, parent: cam.no, entrada: 'pop', t0: ti, quique: 0.7, nome: 'resultado' });
+        forma(comp, 'retangulo', { x: px, y: ry, w: iw, h: rh, r: 26 * u, cor: i == 0 ? kCardAc(P) : P.bg, parent: cam.no, entrada: 'pop', t0: ti, quique: 0.7, nome: 'resultado' });
         if (v) elemento(comp, i, { x: px - iw / 2 + rh * 0.7, y: ry, w: rh * 0.7, parent: cam.no, entrada: 'pop', t0: ti + 0.06 });   // em 16:9 a linha é baixa: só o texto e o check (ícone de 12% da largura não cabe)
-        texto(comp, it[i], { tamanho: Math.min(40 * u, rh * 0.45), cor: i == 0 ? kSobre(P) : P.fg, corDestaque: P.ac, x: px + rh * 0.3, y: ry, parent: cam.no, entrada: 'sobe', t0: ti + 0.1, largura: iw - rh * 2, maxLinhas: 1, sublinhado: false, fala: false });
-        check(comp, { x: px + iw / 2 - rh * 0.6, y: ry, tam: rh * 0.34, cor: i == 0 ? kSobre(P) : P.ac, parent: cam.no, t0: ti + 0.25 });
+        texto(comp, it[i], { tamanho: Math.min(40 * u, rh * 0.45), cor: i == 0 ? kSobreCard(P) : P.fg, corDestaque: P.ac, x: px + rh * 0.3, y: ry, parent: cam.no, entrada: 'sobe', t0: ti + 0.1, largura: iw - rh * 2, maxLinhas: 1, sublinhado: false, fala: false });
+        check(comp, { x: px + iw / 2 - rh * 0.6, y: ry, tam: rh * 0.34, cor: i == 0 ? kSobreCard(P) : P.ac, parent: cam.no, t0: ti + 0.25 });
         som(ti, 'notif', 0.6);
     }
     cam.empurra(0.8, 0, 0, 1.02).empurra(tr, 0, 20 * u, 1.06).empurra(comp.duration - 0.2, 0, 30 * u, 1.1);
@@ -829,9 +865,9 @@ function cenaLeque(comp, P, d) {
         var ang = (i - (n - 1) / 2) * spread, ti = Q(it[i], T0 + 0.35 + i * 0.28), ult = i == n - 1;
         var carta = grupo(comp, { x: px, y: py, parent: cam.no, nome: 'carta' });
         kA(carta).setValue([0, 0]);
-        var c = forma(comp, 'retangulo', { x: 0, y: -ch * 0.78, w: cw, h: ch, r: 34 * u, cor: ult ? P.ac : P.card, traco: ult ? null : P.mudo, tracoL: 3 * u, parent: carta, nome: 'carta-corpo' });
+        var c = forma(comp, 'retangulo', { x: 0, y: -ch * 0.78, w: cw, h: ch, r: 34 * u, cor: ult ? kCardAc(P) : P.card, traco: ult ? null : P.mudo, tracoL: 3 * u, parent: carta, nome: 'carta-corpo' });
         elemento(comp, i, { x: 0, y: -ch * 0.95, w: cw * 0.6, parent: carta });
-        texto(comp, it[i], { fonte: P.fonteTexto, tamanho: 36 * u, cor: ult ? kSobre(P) : P.fg, corDestaque: P.ac, x: 0, y: -ch * 0.52, parent: carta, entrada: 'fade', t0: ti, largura: cw * 0.84, maxLinhas: 2, sublinhado: false, fala: false, livre: true });
+        texto(comp, it[i], { fonte: P.fonteTexto, tamanho: 36 * u, cor: ult ? kSobreCard(P) : P.fg, corDestaque: P.ac, x: 0, y: -ch * 0.52, parent: carta, entrada: 'fade', t0: ti, largura: cw * 0.84, maxLinhas: 2, sublinhado: false, fala: false, livre: true });
         mola(kR(carta), ti - 0.1, 0, ang, { quique: 0.55, dur: 0.8 });
         curva(kO(carta), [[ti - 0.14, 0, null, 30], [ti - 0.1, 100, null, 30]]);
         som(ti, 'papel', 0.6);
@@ -865,8 +901,10 @@ function cenaRolagem(comp, P, d) {
     var cw = v ? W * 0.8 : W * 0.38, ch = v ? H * 0.2 : H * 0.28, gap = 28 * u, x = v ? g.cx : W * 0.7;
     var feed = grupo(comp, { x: x, y: 0, parent: cam.no, nome: 'feed' });
     var total = n * (ch + gap), y0 = v ? H * 0.3 : H * 0.14, tl = T0 + 0.2, dd = 1.3;
-    for (i = 0; i < n + 1; i++) {
-        var y = y0 + i * (ch + gap) + ch / 2, idx = i % n;
+    // no 9:16 com título, o feed sobe UM cartão: começa um cartão abaixo do topo do conteúdo (Ct do kT) pra nunca passar por baixo do título
+    if (v && d.titulo) y0 = H * 0.2 + gap + (ch + gap);
+    for (i = 0; i < n; i++) {   // um post por item: nada de repetir o primeiro no fim pra encher o feed
+        var y = y0 + i * (ch + gap) + ch / 2, idx = i;
         forma(comp, 'retangulo', { x: 0, y: y, w: cw, h: ch, r: 36 * u, cor: P.card, traco: P.mudo, tracoL: 3 * u, parent: feed, nome: 'post' });
         elemento(comp, i, { x: -cw / 2 + ch * 0.55, y: y, w: ch * 0.7, parent: feed });
         texto(comp, it[idx], { tamanho: Math.min(44 * u, ch * 0.28), cor: P.fg, corDestaque: P.ac, x: ch * 0.28, y: y - ch * 0.12, parent: feed, entrada: 'fade', t0: T0, largura: cw - ch * 1.5, maxLinhas: 2, sublinhado: false, fala: false, livre: true });
@@ -909,3 +947,121 @@ function cenaEstrelas(comp, P, d) {
     cam.empurra(0.8, 0, 0, 1.02).empurra(comp.duration - 0.2, 0, 0, 1.08);
     fecha(comp);
 }
+
+// ---------------------------------------------------------------- 31. foto: a foto do pedido em 3 planos, em 3D, com passeio de câmera
+/* d.foto = {arquivo, fundo, recorte, w, h, moldura} (o Node já copiou pro projeto, desfocou o fundo e tentou o recorte);
+   d.movimento (aproxima · passeio · revela · orbita · afasta) é o que o diretor sorteou a partir da câmera da cena, e
+   d.sentido (±1) alterna entre fotos seguidas. Planos: 1) o fundo desfocado e ampliado, 2) a foto (recorte com alfa, ou a foto
+   inteira numa moldura arredondada que é uma comp própria: o passeio acontece DENTRO da moldura), em 3D com rotação,
+   3) elementos reais na frente, que andam mais que a foto (parallax). Tudo com ease: nada linear. */
+function kFotoImp(arq) {
+    if (!arq) return null;
+    KIT.cache = KIT.cache || {};
+    if (KIT.cache[arq]) return KIT.cache[arq];
+    try { var it = app.project.importFile(new ImportOptions(new File(arq))); KIT.cache[arq] = it; return it; }
+    catch (er) { KIT.avisos.push('cena ' + KIT.cenaIdx + ': a foto não abriu: ' + arq); return null; }
+}
+function kFotoPonto(cw, ch, pan, z, fx, fy) { var lim = (z - 1) / 2 * pan; return [cw / 2 - fx * lim * cw, ch / 2 - fy * lim * ch]; }
+function kRot(L, eixo) { return L.property('ADBE Transform Group').property('ADBE Rotate ' + eixo); }
+function cenaFoto(comp, P, d) {
+    var F = d.foto, itF = F ? kFotoImp(F.recorte || F.arquivo) : null;
+    if (!itF) { KIT.avisos.push('cena ' + KIT.cenaIdx + ': sem foto, a cena virou herói'); return cenaHeroi(comp, P, d); }
+    var g = kPre(comp, P), W = g.W, H = g.H, u = g.u, cam = g.cam, v = g.v, T0 = 0.1, i, dur = comp.duration;
+    var mov = d.movimento || 'aproxima', sg = d.sentido || 1, recorte = !!F.recorte;
+    var ease = [60, 60];
+    // 1. o plano de trás: a própria foto desfocada, ampliada, com um véu da cor da cena; anda ao contrário da foto
+    var itB = F.fundo ? kFotoImp(F.fundo) : null;
+    if (itB) {
+        var bg = comp.layers.add(itB); bg.name = 'foto-fundo';   // sem pai: a câmera encolhe o quadro (88%) e deixaria borda; o fundo tem o movimento dele
+        var kb = Math.max(W / itB.width, H / itB.height) * 100;
+        kP(bg).setValue([g.cx, g.cy]);
+        curva(kS(bg), [[0, [kb * 1.32, kb * 1.32], ease[0], ease[1]], [dur, [kb * 1.5, kb * 1.5], ease[0], ease[1]]]);
+        curva(kP(bg), [[0, [g.cx + sg * W * 0.035, g.cy], ease[0], ease[1]], [dur, [g.cx - sg * W * 0.035, g.cy - H * 0.01], ease[0], ease[1]]]);
+        var veu = comp.layers.addSolid(kCor(P.bg), 'foto-veu', W, H, 1); kO(veu).setValue(40);
+    }
+    // 2. a foto: o tamanho da caixa respeita a proporção dela (nada cortado) e a zona do texto
+    var fw = recorte ? (F.rw || F.w) : F.w, fh = recorte ? (F.rh || F.h) : F.h;   // o recorte já vem aparado: só a pessoa
+    var LY = d.layout || null;   // o plano da GUARDA (maquina-guarda.js): foto grande, título sem encostar, ícones só no espaço livre
+    var bx = v ? W * (recorte ? 0.9 : 0.8) : W * 0.4, by = v ? H * (recorte ? 0.5 : 0.46) : H * (recorte ? 0.84 : 0.74);
+    var cwf = Math.min(bx, by * fw / fh), chf = cwf * fh / fw;
+    var px = v ? g.cx : W * 0.3, py = recorte ? (v ? H * 0.64 - chf / 2 : H * 0.9 - chf / 2) : (v ? H * 0.38 : g.cy);
+    var corte = 1;   // a parte da altura que aparece (foto alta cortada em 4:5 pela guarda)
+    if (LY && LY.foto) { cwf = LY.foto.w; chf = LY.foto.h; px = LY.foto.x; py = LY.foto.y; corte = LY.foto.corte || 1; }
+    var halo;
+    if (LY && LY.halo && LY.halo.d) halo = forma(comp, 'circulo', { x: LY.halo.x, y: LY.halo.y, w: LY.halo.d, cor: P.ac, alfa: 70, parent: cam.no, entrada: 'cresce', t0: T0, nome: 'halo' });
+    else if (LY && LY.halo) halo = forma(comp, 'retangulo', { x: LY.halo.x, y: LY.halo.y, w: LY.halo.w, h: LY.halo.h, r: 46 * u, cor: P.ac, alfa: 34, parent: cam.no, entrada: 'cresce', t0: T0, nome: 'halo' });
+    else halo = forma(comp, 'circulo', { x: px, y: py, w: Math.max(cwf, chf) * (recorte ? 0.95 : 1.05), cor: P.ac, alfa: recorte ? 70 : 26, parent: cam.no, entrada: 'cresce', t0: T0, nome: 'halo' });
+    var card, kBase0;
+    if (recorte) {
+        card = comp.layers.add(itF); card.name = 'foto-recorte'; kPai(card, cam.no);
+        kBase0 = cwf / itF.width * 100;
+        kA(card).setValue([itF.width / 2, itF.height * corte / 2]);
+        // o corte da foto (ombros e braços na beira, ou o corpo abaixo do 4:5) some num degradê: a pessoa não termina numa linha reta
+        try { var mk = card.property('ADBE Mask Parade').addProperty('ADBE Mask Atom'); mk.property('ADBE Mask Shape').setValue(kRetShape(itF.width * 0.02, -itF.height, itF.width * 0.98, itF.height * corte * 0.96, 0)); mk.property('ADBE Mask Feather').setValue([itF.width * 0.05, itF.height * corte * 0.12]); } catch (eM) { }
+    } else {
+        var inner = novaComp('foto-int ' + KIT.cenaIdx, Math.round(cwf), Math.round(chf), dur, KIT.fps);
+        var im = inner.layers.add(itF); im.name = 'foto-img';
+        var ki = Math.max(cwf / itF.width, chf / itF.height) * 100;
+        kP(im).setValue([cwf / 2, chf / 2]);
+        // o passeio DENTRO da moldura (ease, nunca linear): escala e deslocamento por movimento
+        var z0 = 1, z1 = 1.2, x0 = 0, x1 = 0, y0 = 0, y1 = 0, pan = 0.8;
+        if (mov == 'aproxima') { z0 = 1.0; z1 = 1.3; y0 = 0; y1 = -0.06; }
+        else if (mov == 'passeio') { z0 = 1.26; z1 = 1.26; x0 = -sg * 0.5; x1 = sg * 0.5; y0 = 0.25; y1 = -0.25; }
+        else if (mov == 'revela') { z0 = 1.45; z1 = 1.05; x0 = sg * 0.2; x1 = 0; y0 = 0.3; y1 = 0; }
+        else if (mov == 'orbita') { z0 = 1.08; z1 = 1.22; x0 = -sg * 0.25; x1 = sg * 0.25; }
+        else if (mov == 'afasta') { z0 = 1.34; z1 = 1.0; y0 = -0.12; y1 = 0.0; }
+        curva(kS(im), [[0, [ki * z0, ki * z0], ease[0], ease[1]], [T0 + 0.9 * dur / 3, [ki * (z0 + (z1 - z0) * 0.5), ki * (z0 + (z1 - z0) * 0.5)], ease[0], ease[1]], [dur, [ki * z1, ki * z1], ease[0], ease[1]]]);
+        curva(kP(im), [[0, kFotoPonto(cwf, chf, pan, z0, x0, y0), ease[0], ease[1]], [dur, kFotoPonto(cwf, chf, pan, z1, x1, y1), ease[0], ease[1]]]);
+        card = comp.layers.add(inner); card.name = 'foto-moldura'; kPai(card, cam.no);
+        kMascaraRect(card, 0, 0, cwf, chf, 38 * u);
+        kBase0 = 100;
+    }
+    kP(card).setValue([px, py]);
+    kS(card).setValue([kBase0, kBase0]);
+    if (recorte) {   // o recorte anda e cresce no próprio plano (a foto inteira não tem moldura onde passear)
+        // com a guarda (LY) o passeio é mais curto na escala e no deslocamento: a foto fica GRANDE e o 3D (rotação) leva o movimento
+        var rzA = LY ? 0.97 : 0.94, rzB = LY ? 1.06 : 1.12, rzC = LY ? 1.06 : 1.1, dxF = LY ? 0.025 : 0.04, dyF = LY ? 0.015 : 0.03;
+        var rz1 = mov == 'afasta' || mov == 'revela' ? rzA : rzC, rz0 = mov == 'afasta' || mov == 'revela' ? rzB : 1.0;
+        curva(kS(card), [[0, [kBase0 * rz0, kBase0 * rz0], ease[0], ease[1]], [dur, [kBase0 * rz1, kBase0 * rz1], ease[0], ease[1]]]);
+        if (mov == 'passeio' || mov == 'orbita') curva(kP(card), [[0, [px - sg * W * dxF, py], ease[0], ease[1]], [dur, [px + sg * W * dxF, py], ease[0], ease[1]]]);
+        else curva(kP(card), [[0, [px, py + H * dyF], ease[0], ease[1]], [dur, [px, py - H * dyF / 3], ease[0], ease[1]]]);
+    }
+    // sombra no chão e entrada: a foto chega girando e assenta (a rotação é o 3D; a mola é a entrada)
+    var sombra = LY ? sombraChao(comp, px, py + chf * 0.5 - 30 * u, cwf * 0.5, { parent: cam.no, t0: T0 + 0.25, alfa: 22 })   // com a guarda: a sombra fica no envelope da foto
+        : sombraChao(comp, px, py + chf * 0.5 + 18 * u, cwf * 0.7, { parent: cam.no, t0: T0 + 0.25, alfa: 28 });
+    curva(kO(card), [[T0, 0, null, 30], [T0 + 0.3, 100, 60, null]]);
+    kMarcaEntrada(T0 + 0.3);
+    try {
+        card.threeDLayer = true;
+        var A = (mov == 'aproxima') ? [[-22, -7, 5], [8, 3, -2]] : (mov == 'passeio') ? [[-12, 0, 0], [12, 4, 0]] : (mov == 'revela') ? [[60, 0, 16], [0, 0, 0]] : (mov == 'orbita') ? [[-34, 0, 4], [34, 0, -2]] : [[14, 0, -12], [0, 0, 0]];
+        var tm = Math.min(dur * 0.55, T0 + 0.95);
+        curva(kRot(card, 'Y'), [[0, A[0][0] * sg, ease[0], ease[1]], [mov == 'passeio' || mov == 'orbita' ? dur : tm, (mov == 'passeio' || mov == 'orbita' ? A[1][0] : (A[0][0] + A[1][0]) / 2 * 0.4) * sg, ease[0], ease[1]], [dur, A[1][0] * sg, ease[0], ease[1]]]);
+        curva(kRot(card, 'X'), [[0, A[0][2], ease[0], ease[1]], [dur, A[1][2], ease[0], ease[1]]]);
+    } catch (e) { KIT.avisos.push('cena ' + KIT.cenaIdx + ': 3D da foto indisponível: ' + e); }
+    som(T0, 'impacto', 0.6); som(T0 + 0.5, 'sobe', 0.45);
+    // 3. na frente: elementos reais do assunto, que andam mais que a foto (parallax)
+    var nEl = Math.min(KIT.elementos.length, v ? 3 : 2), S = Math.min(W, H) * (v ? 0.2 : 0.24);
+    var posV = [[W * 0.2, H * 0.17], [W * 0.84, H * 0.5], [W * 0.18, H * 0.58]], posH = [[W * 0.54, H * 0.2], [W * 0.5, H * 0.8]];
+    var ics = [];
+    if (LY && LY.icones) { for (i = 0; i < LY.icones.length; i++) if (!LY.icones[i].fora) ics.push({ i: LY.icones[i].i, x: LY.icones[i].x, y: LY.icones[i].y, w: LY.icones[i].w }); }
+    else for (i = 0; i < nEl; i++) ics.push({ i: i, x: (v ? posV[i] : posH[i])[0], y: (v ? posV[i] : posH[i])[1], w: S });
+    for (i = 0; i < ics.length; i++) {
+        var ph = ics[i].i * 1.9, a = 12 * u, kx = (ics[i].i % 2 ? -1 : 1) * W * 0.05;
+        // o envelope do balanço vai pra caixa (folga): a guarda do kit reserva o caminho inteiro do ícone
+        var el = elemento(comp, ics[i].i, { x: ics[i].x, y: ics[i].y, w: ics[i].w, parent: cam.no, entrada: 'pop', t0: T0 + 0.55 + i * 0.18, quique: 0.7, folgaX: a + Math.abs(kx), folgaY: a * 1.1 });
+        kP(el).expression = 'value + [Math.sin(time*1.7+' + ph.toFixed(1) + ')*' + a.toFixed(1) + ' + ' + (sg * kx).toFixed(1) + ' * (time / ' + dur.toFixed(2) + ' - 0.5) * 2, Math.cos(time*1.3+' + ph.toFixed(1) + ')*' + (a * 1.1).toFixed(1) + ']';
+    }
+    if (d.titulo) {
+        var TY = LY && LY.titulo;
+        kT(g, comp, P, d.titulo, TY ? TY.y : (v ? H * 0.79 : g.cy), { x: TY ? TY.x : (v ? g.cx : W * 0.73), largura: TY ? TY.largura : (v ? W * 0.86 : W * 0.42), maxLinhas: 3, tam: TY ? TY.tam : (v ? 86 : 74), t0: T0 + 0.7 });
+    }
+    // a foto entra na guarda do kit (fecha → kGuarda) com a caixa do envelope: se o texto real encostar, ela sobe ou encolhe
+    if (LY && LY.particulas) {
+        var ec = LY.particulas;
+        KIT.rects.push({ espaco: 'c', cena: KIT.cenaIdx, x0: ec[0], y0: ec[1], x1: ec[2], y1: ec[3], t0: 0, t1: 1, texto: false, livre: true, sobrepoe: true, guarda: 'foto', nome: 'a foto', camadas: [card, halo, sombra], infla: (ec[2] - ec[0]) / Math.max(1, cwf) });
+    }
+    var pa = LY && LY.particulas ? [LY.particulas[0], LY.particulas[1], LY.particulas[2], LY.particulas[3]] : [px - cwf * 0.6, py - chf * 0.6, px + cwf * 0.6, py + chf * 0.5];
+    particulas(comp, { n: 10, cor: P.ac, parent: cam.no, tipo: 'flutua', raio: 8, area: pa, alfa: 70, t0: T0 + 0.4 });
+    cam.empurra(0.8, 0, 0, 1.0).empurra(comp.duration - 0.2, 0, 0, 1.06);
+    fecha(comp);
+}

package/lib/estudio/maquina-diretor.js

@@ -58,12 +58,18 @@ const PRIMITIVAS = {
     split: { fam: 'comparacao', entra: 2.6, papeis: ['problema', 'virada'], dur: 3.2, elemento: true },
     ondas: { fam: 'som', entra: 1.0, papeis: ['gancho', 'processo', 'virada'], dur: 2.8, elemento: true },
     estrelas: { fam: 'social', entra: 2.7, papeis: ['prova'], dur: 3.2, elemento: true },
+    // a foto do pedido (maquina-foto.js): só entra quando há foto; o sorteio comum nunca a escolhe
+    foto: { fam: 'foto', entra: 1.6, papeis: ['gancho', 'virada', 'prova', 'processo'], dur: 3.4, foto: true },
 };
 const TIPOS = Object.keys(PRIMITIVAS);
 
 const TRANSICOES = ['encolhe', 'empurra', 'zoom', 'persiana', 'chicote', 'desfoque', 'cortina', 'giro', 'tremor', 'abre', 'dissolve', 'corte'];   // sem íris/pontos: o círculo claro crescendo parecia flash
 const CAMERAS = ['deriva', 'pulso', 'trilho', 'orbita', 'push', 'chicote', 'cinema'];   // sem câmera na mão: tremedeira fora
 
+/** Os passeios pela foto (Ken Burns com ease, nunca linear) e qual deles cada câmera do diretor pede. */
+const MOVIMENTOS_FOTO = ['aproxima', 'passeio', 'revela', 'orbita', 'afasta'];
+const CAMERA_FOTO = { push: 'aproxima', pulso: 'aproxima', deriva: 'passeio', trilho: 'passeio', orbita: 'orbita', chicote: 'revela', cinema: 'afasta' };
+
 /** Sistemas tipográficos: fontes + como a palavra entra + como a palavra-chave é realçada. */
 const TIPOGRAFIAS = {
     editorial: { fontes: { titulo: 'Poppins', texto: 'Plus Jakarta Sans', destaque: 'Playfair Display' }, entrada: 'palavra', realce: 'italico', passo: 0.1 },
@@ -229,7 +235,11 @@ function marcarChave(titulo) {
     return ps.join(' ');
 }
 const primeirasPalavras = (s, n) => String(s || '').replace(/\*/g, '').split(/\s+/).filter(Boolean).slice(0, n).join(' ');
-const itensDe = (v, n, m) => (Array.isArray(v) ? v : []).map((x) => limpa(typeof x === 'object' && x ? (x.titulo || x.texto || x.nome || '') : x, m)).filter(Boolean).slice(0, n);
+/** A chave de um item pra achar repetido: sem caixa, acento, espaço nem pontuação. */
+const chaveItem = (s) => String(s || '').toLowerCase().normalize('NFD').replace(/[\u0300-\u036f]/g, '').replace(/[^a-z0-9]/g, '');
+/** Os itens de uma lista: limpos, sem vazio e SEM REPETIR (faltou item, a lista fica menor). */
+const itensDe = (v, n, m) => (Array.isArray(v) ? v : []).map((x) => limpa(typeof x === 'object' && x ? (x.titulo || x.texto || x.nome || '') : x, m))
+    .filter((x, i, a) => x && a.findIndex((y) => chaveItem(y) === chaveItem(x)) === i).slice(0, n);
 
 /** Põe em `c` o que a primitiva `tipo` precisa e o modelo não mandou. `ctx`: {assunto, meta, proxima}. */
 function completar(c, tipo, ctx) {
@@ -239,7 +249,7 @@ function completar(c, tipo, ctx) {
     out.titulo = marcarChave(base);
     out.sub = limpa(c.sub, 70) || undefined;
     let it = itensDe(c.itens, 6, 28);
-    if (spec.itens && it.length < spec.itens) it = (it.length ? it.concat(ctx.meta.itens) : ctx.meta.itens).slice(0, Math.max(spec.itens, it.length));
+    if (spec.itens && it.length < spec.itens) it = itensDe(it.length ? it.concat(ctx.meta.itens) : ctx.meta.itens, Math.max(spec.itens, it.length), 28);   // completa sem repetir
     out.itens = it;
     out.valor = limpa(c.valor, 12) || (tipo === 'relogio' ? '7:00' : tipo === 'medidor' ? '82%' : tipo === 'estrelas' ? '4,9' : '100');
     out.rotulo = limpa(c.rotulo, 60) || undefined;
@@ -251,7 +261,7 @@ function completar(c, tipo, ctx) {
     out.toques = itensDe(c.toques, 4, 24);
     if (ctx.proxima) { out.prox = limpa(ctx.proxima.titulo || ctx.proxima.texto, 40).replace(/\*/g, ''); }
     out.fala = c.fala ? String(c.fala) : undefined;
-    out.dur = Math.max(1.4, Math.min(tipo === 'celular' || tipo === 'prompt' ? 5 : 4.2, Number(c.dur || c.duracao) || spec.dur));
+    out.dur = Math.max(1.4, Math.min(tipo === 'celular' || tipo === 'prompt' ? 5 : tipo === 'foto' ? 4.8 : 4.2, Number(c.dur || c.duracao) || spec.dur));
     return out;
 }
 
@@ -269,8 +279,8 @@ function escolherPrimitiva(papel, ctx, rnd) {
     const recentes = new Map();
     ctx.historico.slice(-5).forEach((h, i, arr) => (h.primitivas || []).forEach((p) => recentes.set(p, (recentes.get(p) || 0) + 1 + i / arr.length)));
     const nao = new Set(ctx.meta.nao || []);
-    const cand = TIPOS.filter((t) => PRIMITIVAS[t].papeis.includes(papel) && !usados.has(t) && !nao.has(t) && (!PRIMITIVAS[t].elemento || ctx.temElemento));
-    const lista = (cand.length ? cand : TIPOS.filter((t) => !usados.has(t) && PRIMITIVAS[t].papeis.includes(papel))).map((t) => {
+    const cand = TIPOS.filter((t) => !PRIMITIVAS[t].foto && PRIMITIVAS[t].papeis.includes(papel) && !usados.has(t) && !nao.has(t) && (!PRIMITIVAS[t].elemento || ctx.temElemento));
+    const lista = (cand.length ? cand : TIPOS.filter((t) => !PRIMITIVAS[t].foto && !usados.has(t) && PRIMITIVAS[t].papeis.includes(papel))).map((t) => {
         let peso = 1;
         peso *= ctx.meta.prefere[t] != null ? ctx.meta.prefere[t] : 1;
         peso *= Math.pow(0.55, recentes.get(t) || 0);
@@ -326,24 +336,28 @@ function montarDirecao({ args, assunto, meta, duracao, hist, rnd, temElemento })
         while (papeis.length > n + 1 && papeis.includes('processo')) papeis.splice(papeis.lastIndexOf('processo'), 1);
         pedidas = papeis.map((papel) => ({ papel }));
     }
+    const nFotosPedido = Array.isArray(args.fotos) ? args.fotos.length : (Number(args.nFotos) || 0);
     const papeisUsados = [];
     const cenas = [];
     pedidas.forEach((c, i) => {
         let tipo = normTipo(c.tipo);
         const papel = c.papel || (i === 0 ? 'gancho' : i === pedidas.length - 1 ? 'cta' : ['problema', 'processo', 'prova', 'virada'][i % 4]);
         papeisUsados.push(papel);
+        if (tipo === 'foto' && !nFotosPedido) tipo = '';   // "foto" sem foto: o diretor escolhe outra peça
         if (!PRIMITIVAS[tipo]) tipo = papel === 'cta' ? 'cta' : escolherPrimitiva(papel, ctx, rnd);   // todo vídeo termina num CTA de verdade (botão grande)
         ctx.usados.add(tipo);
         ctx.ultimaFam = PRIMITIVAS[tipo].fam;
         cenas.push({ c, tipo, papel });
     });
+    // a FOTO do pedido: pelo menos uma cena "foto" (a de abertura e/ou a de destaque), nunca duas coladas
+    if (nFotosPedido > 0) colocarFotos(cenas, nFotosPedido);
     // o assunto aparece em OBJETOS: pelo menos 2 cenas com primitiva que usa o elemento real (as que o modelo fixou ficam como estão)
     if (temElemento) {
         const nao = new Set(meta.nao || []);
         const conta = () => cenas.filter((x) => PRIMITIVAS[x.tipo].elemento).length;
         for (let i = 0; i < cenas.length && conta() < 2; i++) {
             const x = cenas[(i * 2 + 1) % cenas.length];
-            if (PRIMITIVAS[x.tipo].elemento || (x.c && PRIMITIVAS[normTipo(x.c.tipo)])) continue;
+            if (x.tipo === 'foto' || PRIMITIVAS[x.tipo].elemento || (x.c && PRIMITIVAS[normTipo(x.c.tipo)])) continue;
             const cand = TIPOS.filter((t) => PRIMITIVAS[t].elemento && PRIMITIVAS[t].papeis.includes(x.papel) && !nao.has(t) && !cenas.some((y) => y.tipo === t));
             if (cand.length) { ctx.usados.delete(x.tipo); x.tipo = sortear(rnd, cand.map((t) => [t, meta.prefere[t] != null ? meta.prefere[t] : 1])); ctx.usados.add(x.tipo); }
         }
@@ -373,6 +387,7 @@ function montarDirecao({ args, assunto, meta, duracao, hist, rnd, temElemento })
     const camera = CAMERAS.includes(args.camera) ? args.camera : sortear(rnd, CAMERAS.map((x) => [x, (meta.cameras.includes(x) ? 3 : 1) * Math.pow(0.45, recC.get(x) || 0) * gm('cameras', x)]));
     const camera2 = sortear(rnd, CAMERAS.filter((x) => x !== camera).map((x) => [x, (meta.cameras.includes(x) ? 2 : 1) * gm('cameras', x)]));
     out.forEach((c, i) => { c.camera = c.camera && CAMERAS.includes(c.camera) ? c.camera : (i % 3 === 2 ? camera2 : camera); });
+    movimentosDasFotos(out);
 
     // tipografia
     const recTi = new Map(); hist.slice(-3).forEach((h) => recTi.set(h.tipografia, (recTi.get(h.tipografia) || 0) + 1));
@@ -391,7 +406,46 @@ function montarDirecao({ args, assunto, meta, duracao, hist, rnd, temElemento })
     return { metafora: meta, cenas: out, trocas, camera, tipografia, ritmo, paleta, ordemPal, assinatura };
 }
 
+/**
+ * Põe a primitiva "foto" nas cenas: a de abertura primeiro, depois as de destaque (prova, virada, processo), nunca coladas,
+ * nunca no CTA, no máximo 3 cenas. Cena que o modelo já fixou como "foto" conta; cena fixada com outro tipo só cede se não
+ * sobrar nenhuma livre. Cada cena "foto" recebe `foto` (o índice da foto em args.fotos).
+ */
+function colocarFotos(cenas, nFotos) {
+    const max = Math.max(1, Math.min(3, nFotos, Math.ceil(cenas.length / 2)));
+    const ehFoto = (x) => x.tipo === 'foto';
+    const fixa = (x) => !!(x.c && x.c.tipo && PRIMITIVAS[normTipo(x.c.tipo)] && normTipo(x.c.tipo) !== 'foto');
+    const vizinhaDeFoto = (i) => (cenas[i - 1] && ehFoto(cenas[i - 1])) || (cenas[i + 1] && ehFoto(cenas[i + 1]));
+    const podeSer = (i, livre) => i < cenas.length && !ehFoto(cenas[i]) && cenas[i].papel !== 'cta' && !(i === cenas.length - 1 && cenas.length > 1) && !vizinhaDeFoto(i) && (!livre || !fixa(cenas[i]));
+    const poe = (i) => { cenas[i].tipo = 'foto'; cenas[i].c = { ...cenas[i].c, tipo: 'foto' }; };
+    let n = cenas.filter(ehFoto).length;
+    const ordem = [0, ...cenas.map((x, i) => i).filter((i) => i > 0 && ['prova', 'virada', 'processo', 'problema'].includes(cenas[i].papel)), ...cenas.map((x, i) => i)];
+    for (const livre of [true, false]) {
+        for (const i of ordem) { if (n >= max) break; if (podeSer(i, livre)) { poe(i); n++; } }
+        if (n > 0) break;   // a foto entrou: o resto das fixadas pelo modelo fica como está
+    }
+    if (!n && cenas.length) { poe(0); n = 1; }   // uma cena só: a foto vira a cena
+    let k = 0;
+    cenas.forEach((x) => { if (ehFoto(x)) { x.c = { ...x.c, foto: x.c.foto != null ? x.c.foto : k % nFotos }; k++; } });
+}
+
+/** O passeio de cada foto: o que a câmera da cena pede, sem repetir o de nenhuma outra foto do vídeo (e o sentido alterna). */
+function movimentosDasFotos(out) {
+    const usados = [];
+    let sentido = 1;
+    out.forEach((c) => {
+        if (c.tipo !== 'foto') return;
+        let mov = MOVIMENTOS_FOTO.includes(c.movimento) && !usados.includes(c.movimento) ? c.movimento : CAMERA_FOTO[c.camera] || 'aproxima';
+        if (usados.includes(mov)) mov = MOVIMENTOS_FOTO[(MOVIMENTOS_FOTO.indexOf(mov) + 1 + usados.length) % MOVIMENTOS_FOTO.length];
+        for (let g = 0; usados.includes(mov) && g < MOVIMENTOS_FOTO.length; g++) mov = MOVIMENTOS_FOTO[(MOVIMENTOS_FOTO.indexOf(mov) + 1) % MOVIMENTOS_FOTO.length];
+        usados.push(mov);
+        c.movimento = mov;
+        c.sentido = sentido;
+        sentido = -sentido;
+    });
+}
+
 /** Quantos itens do vocabulário (para o teste e para o relatório). */
 const VOCABULARIO = () => ({ primitivas: TIPOS.length, transicoes: TRANSICOES.length, cameras: CAMERAS.length, tipografias: Object.keys(TIPOGRAFIAS).length });
 
-module.exports = { PRIMITIVAS, TIPOS, TRANSICOES, CAMERAS, TIPOGRAFIAS, METAFORAS, PALETAS, achar, dirigir, similaridade, lerHistorico, registrar, completar, marcarChave, normTipo, escolherPrimitiva, VOCABULARIO, LIMITE_PARECIDO, hashTexto, mulberry, arquivoHistorico };
+module.exports = { itensDe, PRIMITIVAS, TIPOS, TRANSICOES, CAMERAS, MOVIMENTOS_FOTO, CAMERA_FOTO, colocarFotos, movimentosDasFotos, TIPOGRAFIAS, METAFORAS, PALETAS, achar, dirigir, similaridade, lerHistorico, registrar, completar, marcarChave, normTipo, escolherPrimitiva, VOCABULARIO, LIMITE_PARECIDO, hashTexto, mulberry, arquivoHistorico };