primocode 8.35.0 → 8.37.0

package/studio/ferramentas/corte.md

@@ -84,12 +84,12 @@ cena. Se o assunto não empurrar para nenhuma, escolha a que você NÃO usou da
 | Assunto | `tema` | `trilha` | Estrutura |
 |---|---|---|---|
 | produto, tecnologia, lançamento | `meia-noite` ou `neon` | `pulso` | **Gancho** |
-| institucional, quem somos, serviço | `oceano` ou `floresta` | `ambiente` | **Retrato** |
+| institucional, quem somos, serviço | `oceano` ou `floresta` | `foco` | **Retrato** |
 | urgência, notícia, alerta, dado duro | `brasa` | `tenso` | **Manchete** |
-| explicação, tutorial, passo a passo | `papel` ou `claro` | `lofi` | **Aula** |
+| explicação, tutorial, passo a passo | `papel` ou `claro` | `foco` | **Aula** |
 | conquista, agradecimento, celebração | `doce` ou `neon` | `alegre` | **Brinde** |
 | memória, história, retrospectiva | `retro` ou `mono` | `lofi` | **Linha** |
-| curso, aula, treinamento, método | `ambar` | `lofi` | **Aula** |
+| curso, aula, treinamento, método | `ambar` | `suave` | **Aula** |
 | relatório, número, análise técnica | `grafite` | `ambiente` | **Manchete** |
 
 ### As seis estruturas
@@ -161,9 +161,16 @@ Música sintetizada na hora, sem arquivo e sem licença de terceiro.
 | `epico` | grave, crescendo | 88 |
 | `alegre` | maior, arpejo rápido | 124 |
 | `tenso` | menor, suspense | 100 |
+| `suave` | cama grave, sem bateria, quase não se nota | 60 |
+| `foco` | pulso leve, sem caixa, para tutorial e institucional | 96 |
 
 A trilha gerada não acaba — acompanha o vídeo até a última cena.
 
+**Vídeo de alguém falando pede `suave` ou `foco`.** As duas foram feitas para
+ficar EMBAIXO de uma voz: moram fora da faixa da fala e não têm caixa batendo
+em cima dela. `epico` e `tenso` são faixas grandes — bonitas num teaser sem
+narração, e uma disputa com quem fala em qualquer outro caso.
+
 ### Arquivo do usuário
 
 ```json
@@ -213,9 +220,135 @@ Isso vale para o projeto do usuário, não para o PrimoCode.
 
 ## Elementos que dão cara de produção
 
-Estes seis existem porque um vídeo genérico é feito só de título + texto. São
+Estes existem porque um vídeo genérico é feito só de título + texto. São
 baratos de escrever e mudam completamente o resultado.
 
+**Todo vídeo leva pelo menos um.** Texto sobre fundo, do primeiro segundo ao
+último, é o vídeo que o usuário chamou de "sem efeito nenhum" — e não é falta
+de recurso: é este bloco não ter sido lido.
+
+## Anúncio de marca — o kit
+
+Quando o pedido é o COMERCIAL de um produto (um cartão, um app, um plano), o
+que separa uma peça de agência de um slide com música são quatro coisas, e as
+quatro têm elemento próprio. Uma peça de marca sem elas sai genérica por mais
+bonito que esteja o texto.
+
+**Primeiro, declare a marca no documento.** Ela pinta o destaque de tudo —
+número, botão, detalhe, o cartão — e libera o fundo `"marca"`:
+
+```json
+"marca": { "cor": "#21C25E", "logo": "/midia/logo.svg" },
+"tema": "claro"
+```
+
+Tema CLARO na maioria dos anúncios de marca. O escuro é para a cena de
+produto e para a vitrine; o resto da peça respira no branco.
+
+### `cartao` — o produto
+
+```json
+{ "tipo": "cartao", "nome": "PicPay", "variante": "Gold", "movimento": "flutuar" }
+```
+
+Sai um cartão desenhado: chip, símbolo de aproximação, numeração mascarada,
+nome e validade, com luz e sombra. `cor` (sem ela, a da marca), `largura`,
+`numero` (só os 4 últimos aparecem), `titular`, `validade`, `face: "verso"`,
+`movimento`: `flutuar` | `girar`.
+
+**Mostre o produto antes de falar dele.** Um anúncio de cartão que só tem
+frases é um anúncio sem produto.
+
+### `app` — a tela do aplicativo
+
+```json
+{ "tipo": "app", "topo": "Minha conta", "rotulo": "saldo disponível",
+  "valor": "R$ 1.284,90",
+  "linhas": [["Café da manhã", "R$ 18,90"], ["Mercado", "R$ 92,40"]],
+  "botao": "Pagar com o cartão" }
+```
+
+Cabeçalho, um número grande, linhas com o nome à esquerda e o valor à direita
+separadas por fio, e o botão cheio embaixo — que é o que faz o olho ler
+"aplicativo". Aceita `["nome", "valor"]` e `"nome|valor"`. `escuro: true` para
+a versão noturna.
+
+**Ele vai DENTRO do `dispositivo`**, e aí ocupa a tela inteira do aparelho:
+
+```json
+{ "tipo": "dispositivo", "forma": "celular", "dentro": [ { "tipo": "app", ... } ] }
+```
+
+Solto na cena ele vira o print da campanha. É o mesmo elemento de propósito:
+com dois, a tela do celular e o print divergiriam na primeira mudança.
+
+### `vitrine` — a linha de produtos
+
+```json
+{ "tipo": "vitrine", "titulo": "Escolha seu cartão", "atual": 1, "nome": "PicPay",
+  "itens": [ { "nome": "Gold", "cor": "#C9A227", "detalhe": "sem anuidade" },
+             { "nome": "Verde", "detalhe": "cashback" },
+             { "nome": "Black", "cor": "#181B1F", "detalhe": "sala VIP" } ] }
+```
+
+Os cartões numa fila, o `atual` à frente e os outros recuados. Vai bem sobre
+fundo escuro (`"fundo": "#0b0f0c"`), que é como toda tela de "escolha o seu" é
+desenhada.
+
+### `assinatura` — o ponto final
+
+```json
+{ "tipo": "assinatura", "nome": "PicPay", "frase": "o jeito fácil de pagar", "sobre": "marca" }
+```
+
+Ela toma a CENA INTEIRA: o logo sozinho, grande, sobre a cor da casa. `sobre`:
+`marca` | `claro` | `escuro`. Com `logo` ela usa a imagem; sem, o `nome`.
+
+**Todo anúncio termina assim.** Sem a assinatura a peça acaba numa frase, e
+ninguém fica sabendo quem falou.
+
+### A ordem que funciona
+
+Uma peça de marca de 20 a 30 segundos, com 8 a 10 cenas:
+
+| # | cena | o que entra |
+|---|---|---|
+| 1 | a promessa, em uma frase curta | `texto` pequeno, muito ar, fundo claro |
+| 2 | o produto | `cartao` com `movimento` |
+| 3 | o mote, na cor da casa | `fundo: "marca"`, `texto` branco, `anim: "palavra"` |
+| 4 | funcionando | `dispositivo` + `app` |
+| 5 | o benefício | `texto` |
+| 6 | a linha | `vitrine` sobre fundo escuro |
+| 7 | a última razão | `texto` |
+| 8 | assinatura | `assinatura` |
+
+E o rosto de quem fala, quando houver, entra por `clipe` entre a 4 e a 5 — o
+depoimento é o que dá confiança, e nenhum desenho substitui.
+
+---
+
+### `icone` — o desenho ao lado do argumento
+
+```json
+{ "tipo": "icone", "nome": "raio", "tamanho": 120 }
+{ "tipo": "icone", "nome": "crescimento", "tamanho": 90, "cor": "#22d3ee", "traco": 2 }
+```
+
+O jeito mais barato de uma cena deixar de ser um slide. Um ícone grande acima
+do título, ou um por item de uma lista de três, e a mesma frase passa a ter
+imagem.
+
+Os nomes que existem (traço, no tom do tema):
+
+`raio` `alvo` `foguete` `escudo` `relogio` `usuario` `pessoas` `coracao`
+`estrela` `nuvem` `engrenagem` `lampada` `cadeado` `chave` `casa` `email`
+`telefone` `camera` `fogo` `globo` `presente` `sino` `mapa` `dinheiro`
+`crescimento` `balao` `pasta` `livro` `check` `grafico` `codigo` `video`
+`play` `olho` `baixar` `tela` `cartao` `numero` `tabela` `imagem` `lista`
+
+Nome que não existe desenha a estrela — então use os daqui, e não o que
+parecer natural.
+
 ### `selo` — a pílula de estado
 
 ```json
@@ -373,16 +506,46 @@ trecho é longo, quebre em mais cenas do mesmo `src` em vez de encher a tela.
 
 ### Só a voz dele
 
-Para deixar apenas a voz da gravação: `"mudo": false` no clipe e trilha em
-volume baixo (`"volume": 0.15`) ou `"trilha": {"tipo": "nenhuma"}`. Para o
-contrário — a imagem dele com a sua narração por cima — `"mudo": true` e
+Três combinações, e elas resolvem coisas diferentes:
+
+**A voz dele com a imagem dele** (o padrão) — `"mudo": false` no clipe e a
+trilha em volume baixo (`"volume": 0.15`) ou `"trilha": {"tipo": "nenhuma"}`.
+
+**A imagem dele com a sua narração por cima** — `"mudo": true` no clipe e
 `narracao` na cena.
 
+**A VOZ DELE COM A SUA TELA POR CIMA** — `"apenas": "som"` no clipe:
+
+```json
+{ "layout": "centro", "elementos": [
+    { "tipo": "clipe", "src": "/midia/gravacao.mp4", "de": 9.5, "ate": 17.1, "apenas": "som" },
+    { "tipo": "icone", "nome": "crescimento", "tamanho": 120 },
+    { "tipo": "texto", "papel": "titulo", "texto": "Três vezes mais rápido" },
+    { "tipo": "numeros", "itens": ["3x|velocidade", "0|instalação"], "contar": true } ] }
+```
+
+O clipe some do quadro e continua tocando: a cena dura o trecho, o áudio dele
+entra no arquivo exportado, e o que se VÊ é o que você montou. É assim que se
+entrega "só a voz, com uma tela de exemplos" — a gravação vira a narração da
+sua peça.
+
+Use na parte em que ele EXPLICA, e não na em que ele aparece: o rosto de quem
+fala é o que dá confiança, e escondê-lo o vídeo inteiro joga isso fora. O
+desenho que costuma funcionar é alternar — ele na tela quando se apresenta e
+quando conclui, a tela montada enquanto ele explica.
+
+Não junte `"apenas": "som"` com `"mudo": true`: um cancela o outro e a cena
+vira um silêncio do tamanho do trecho.
+
 ### A música que combina
 
-Não repita a mesma trilha em todo vídeo do usuário. Depoimento e história
-pessoal pedem `lofi` ou `ambiente`; anúncio e lançamento pedem `pulso` ou
-`epico`; algo leve pede `alegre`. A tabela de estilos está acima.
+Não repita a mesma trilha em todo vídeo do usuário.
+
+A primeira pergunta é se **alguém fala** no vídeo — narração ou o áudio da
+gravação. Se fala, a trilha é cama: `suave` (mais discreta) ou `foco` (com
+andamento). Só depois vem o assunto: depoimento e história pessoal pedem `lofi`
+ou `ambiente`; anúncio e lançamento pedem `pulso` ou `epico`; algo leve pede
+`alegre`. A tabela de estilos está acima.
 
 ---
 

package/studio/server.py

@@ -751,11 +751,19 @@ def criar_analise(dados):
         for velho in sorted(ANALISES, key=lambda k: ANALISES[k]["criado"])[:len(ANALISES) - LIMITE_ANALISES + 1]:
             ANALISES.pop(velho, None)
 
+    # `manter` e `repetida` viajam SEM valor padrão aqui, e isso é de propósito:
+    # quem decide quanto de pausa fica é a página (ela conhece o tamanho de cada
+    # uma), e um padrão escrito também deste lado seria um segundo dono da mesma
+    # escolha — os dois divergem na primeira mudança e o que vale passa a ser o
+    # que ninguém lembra de olhar.
+    pedido = dados or {}
     ident = uuid.uuid4().hex[:10]
     ANALISES[ident] = {
         "id": ident, "arquivo": arquivo, "estado": "pedido",
-        "silencio": float((dados or {}).get("silencio") or 0.45),
-        "pausa": float((dados or {}).get("pausa") or 0.6),
+        "silencio": float(pedido.get("silencio") or 0.45),
+        "pausa": float(pedido.get("pausa") or 0.6),
+        "manter": None if pedido.get("manter") is None else float(pedido["manter"]),
+        "repetida": pedido.get("repetida") is not False,
         "criado": time.time(), "resultado": None,
     }
     return {"id": ident, "pagina": "/analise#" + ident, "estado": "pedido"}, 201
@@ -770,10 +778,16 @@ def gravar_analise(ident, dados):
         tarefa["resultado"] = {"erro": str(dados["erro"])[:300]}
     else:
         tarefa["estado"] = "pronto"
+        # ESTE DICIONÁRIO É UMA PENEIRA, e campo que não está aqui morre em
+        # silêncio. Foi assim que a lista de falas repetidas sumiu no dia em que
+        # a página passou a devolvê-la: o vídeo saía com o tropeço já cortado e
+        # nada na tela dizia o que tinha sido tirado. Campo novo na página entra
+        # AQUI junto, ou não existe.
         tarefa["resultado"] = {
             "duracao": dados.get("duracao"),
             "trechos": dados.get("trechos") or [],
             "pausas": dados.get("pausas") or [],
+            "repetidos": dados.get("repetidos") or [],
             "cortado": dados.get("cortado"),
         }
     return {"ok": True, "estado": tarefa["estado"]}, 200
@@ -820,8 +834,10 @@ def revisar_monotonia(doc, ferramenta):
 
     if ferramenta == "corte" and not doc.get("trilha"):
         avisos.append(
-            "o vídeo está sem trilha. Seis estilos gerados existem (pulso, ambiente, "
-            "lofi, epico, alegre, tenso) e nenhum custa arquivo nem licença — escolha "
+            "o vídeo está sem trilha. Oito estilos gerados existem (pulso, ambiente, "
+            "lofi, epico, alegre, tenso, suave, foco) e nenhum custa arquivo nem licença. "
+            "Se alguém FALA no vídeo, use suave ou foco: as duas foram feitas para ficar "
+            "embaixo de uma voz. Escolha "
             "pelo assunto.")
 
     duracoes = [c.get("duracao") for c in cenas if isinstance(c.get("duracao"), (int, float))]
@@ -840,6 +856,77 @@ def revisar_monotonia(doc, ferramenta):
             'toda animação de entrada é "%s". Varie: subir, surgir, esquerda, direita, '
             "zoom, desfoque, cair, girar, saltar, revelar, cortina, elastico." % anims[0])
 
+    # ── O QUE FALTA, E NÃO SÓ O QUE SE REPETE ───────────────────────────
+    #
+    #   "Falta de efeitos visuais: não adiciona efeitos, não insere ícones ou
+    #    elementos visuais de apoio no vídeo final."
+    #
+    # Os avisos acima cobram VARIEDADE — eles só disparam quando alguma coisa
+    # foi usada e usada sempre igual. Um vídeo que não usa NADA passava por
+    # todos eles calado, e era esse o vídeo do relato: texto sobre fundo, do
+    # primeiro segundo ao último. O que falta não aparece contando repetição;
+    # aparece contando ausência.
+    todos = [e for c in cenas for e in (c.get("elementos") or []) if isinstance(e, dict)]
+    tipos = {e.get("tipo") for e in todos}
+
+    if not doc.get("acabamento") and not any(c.get("acabamento") for c in cenas):
+        avisos.append(
+            "nenhuma cena tem acabamento. É a textura por cima do quadro inteiro "
+            "(grao, vinheta, scanlines, luz, brilho, moldura) e é o que tira a cara "
+            'de template: "acabamento": "grao" no documento vale para o vídeo todo.')
+
+    apoio = {"icone", "selo", "forma", "grafico", "progresso", "dispositivo",
+             "conversa", "passos", "opcoes", "numeros", "avatar", "citacao"}
+    if not (tipos & apoio):
+        avisos.append(
+            "o vídeo é só texto e imagem: nenhum elemento de apoio em %d cenas. "
+            'Um "icone" ao lado do argumento (raio, alvo, foguete, escudo, relogio, '
+            "lampada, cadeado, crescimento, pessoas, dinheiro, globo, fogo…), um "
+            '"selo" de estado, um "numeros" com "contar": true — é isto que faz a '
+            "tela parecer produzida em vez de um slide com legenda." % len(cenas))
+
+    movimento = any(e.get("chaves") or e.get("movimento") for e in todos)
+    if not movimento and not anims:
+        avisos.append(
+            "nada se mexe: nenhum elemento tem anim, chaves ou movimento. Imagem "
+            'parada em vídeo denuncia preguiça — toda "imagem" leva "movimento" '
+            "(aproximar, afastar, esquerda, direita, cima), e uma ou duas peças por "
+            "vídeo levam chaves de animação.")
+
+    # ── ANÚNCIO DE MARCA SEM PRODUTO E SEM ASSINATURA ───────────────────
+    #
+    #   "Ainda não tá bom, tá genérico. Quero nesse nível." — o dono, sobre um
+    #   comercial de fintech mandado como referência.
+    #
+    # O que separava a peça daqui daquela não era tema nem cor: era não ter o
+    # PRODUTO na tela e não assinar no fim. Quem declarou uma `marca` está
+    # fazendo peça de marca, e aí estas duas ausências são o defeito inteiro.
+    if doc.get("marca") and len(cenas) >= 4:
+        if not (tipos & {"cartao", "app", "vitrine", "dispositivo", "imagem", "clipe"}):
+            avisos.append(
+                "esta peça tem marca declarada e nenhuma cena mostra o PRODUTO — são %d cenas "
+                "de texto sobre fundo. Um anúncio de cartão mostra o cartão (`cartao`), o app "
+                "funcionando dentro do celular (`dispositivo` + `app`) e a linha de produtos "
+                "(`vitrine`). É essa ausência que se lê como genérico." % len(cenas))
+        if "assinatura" not in tipos:
+            avisos.append(
+                'o anúncio acaba sem assinar. A última cena de uma peça de marca é '
+                '{"tipo":"assinatura","nome":"…","sobre":"marca"} — o logo sozinho, grande, '
+                "sobre a cor da casa. Sem ela a peça termina numa frase e ninguém fica "
+                "sabendo quem falou.")
+
+    # Só a voz com tela montada: existe e quase nunca é lembrado, porque é o
+    # contrário do `mudo` e o contrário não estava no vocabulário até agora.
+    clipes = [e for e in todos if e.get("tipo") == "clipe"]
+    if clipes and len(clipes) >= 3 and not any(
+            e.get("apenas") == "som" or e.get("som") is True for e in clipes):
+        avisos.append(
+            "todos os %d clipes mostram a gravação. Se o que vale é o que ele DIZ, "
+            '"apenas": "som" no clipe mantém a voz e libera o quadro para a tela que '
+            "você montar por cima — é o vídeo dele virando narração da sua peça. "
+            "Vale para a parte em que ele explica, não para a em que ele aparece."
+            % len(clipes))
+
     return avisos
 
 
@@ -962,6 +1049,15 @@ def _clipe_invalido(e, i, j):
                     '"de": 12.5, "ate": 19.' % (onde, campo, v))
         if v < 0:
             return '%s tem "%s": %r — segundo negativo não existe.' % (onde, campo, v)
+    # "apenas": "som" entrega a VOZ da gravação com a tela montada por cima.
+    # Junto com "mudo": true ele não entrega nada: sem imagem porque foi
+    # escondido, sem som porque foi silenciado. A cena sairia com a duração do
+    # trecho e o conteúdo de um silêncio — que é exatamente o tipo de defeito
+    # que só aparece quando alguém assiste o vídeo pronto.
+    if (e.get("apenas") == "som" or e.get("som") is True) and e.get("mudo"):
+        return ('%s tem "apenas": "som" com "mudo": true. Um cancela o outro: o clipe some da '
+                'tela E fica sem áudio, e a cena vira um silêncio do tamanho do trecho. Para a '
+                'voz dele com a sua tela por cima, tire o "mudo".' % onde)
     de, ate = e.get("de"), e.get("ate")
     if isinstance(de, (int, float)) and isinstance(ate, (int, float)) and ate <= de:
         return ('%s tem "ate": %r antes ou igual a "de": %r. O trecho ficaria com duração zero ou '
@@ -987,9 +1083,16 @@ def validar_doc(modelo, doc):
     # default do renderizador: texto cru de 16px num canvas de 1920 — ou nada,
     # quando o texto estava noutro campo. Era o "vídeo com música mas tudo
     # preto": documento válido na forma, invisível na tela.
+# O kit de anúncio (cartao, app, vitrine, assinatura) entra na lista abaixo.
+#
+# A LISTA É LIDA POR UM TESTE (`vocabulario.test.js`), que a recorta com uma
+# expressão regular e pega as palavras — então comentário DENTRO dela vira
+# "tipo que o render precisa desenhar", e o teste passa a cobrar `produto`,
+# `linha` e `fim`. Texto sobre os tipos mora aqui fora.
     TIPOS_VALIDOS = {"texto", "lista", "cartoes", "numeros", "tabela", "codigo",
                      "citacao", "forma", "imagem", "icone", "grafico", "no", "conector",
                      "objeto3d", "clipe",
+                     "cartao", "app", "vitrine", "assinatura",
                      "selo", "progresso", "avatar", "dispositivo", "conversa",
                      "passos", "opcoes"}
     # Os sete últimos são o vocabulário do vídeo de referência. O comentário