primocode 8.22.0 → 8.25.0

package/studio/arquivos/traco-estatico-traco-25872.json

@@ -0,0 +1,113 @@
+{
+  "id": "traco-estatico-traco-25872",
+  "ferramenta": "traco",
+  "titulo": "estatico-traco",
+  "doc": {
+    "tema": "meia-noite",
+    "largura": 1920,
+    "altura": 1080,
+    "cenas": [
+      {
+        "layout": "livre",
+        "fundo": "pontos",
+        "elementos": [
+          {
+            "id": "ped",
+            "tipo": "no",
+            "texto": "Pedido aberto",
+            "x": 120,
+            "y": 480,
+            "l": 320,
+            "a": 140,
+            "destaque": true,
+            "anim": "nenhuma"
+          },
+          {
+            "id": "val",
+            "tipo": "no",
+            "texto": "Validação\nfiscal",
+            "x": 620,
+            "y": 480,
+            "l": 320,
+            "a": 140,
+            "anim": "nenhuma"
+          },
+          {
+            "id": "ger",
+            "tipo": "no",
+            "texto": "Aprovação\ngerência",
+            "x": 1120,
+            "y": 300,
+            "l": 320,
+            "a": 140,
+            "anim": "nenhuma"
+          },
+          {
+            "id": "dir",
+            "tipo": "no",
+            "texto": "Aprovação\ndiretoria",
+            "x": 1120,
+            "y": 660,
+            "l": 320,
+            "a": 140,
+            "anim": "nenhuma"
+          },
+          {
+            "id": "ok",
+            "tipo": "no",
+            "texto": "Compra\nemitida",
+            "x": 1560,
+            "y": 480,
+            "l": 280,
+            "a": 140,
+            "destaque": true,
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "conector",
+            "de": "ped",
+            "para": "val",
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "conector",
+            "de": "val",
+            "para": "ger",
+            "texto": "até R$ 20 mil",
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "conector",
+            "de": "val",
+            "para": "dir",
+            "texto": "acima de R$ 20 mil",
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "conector",
+            "de": "ger",
+            "para": "ok",
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "conector",
+            "de": "dir",
+            "para": "ok",
+            "anim": "nenhuma"
+          },
+          {
+            "tipo": "texto",
+            "x": 120,
+            "y": 120,
+            "l": 900,
+            "a": 120,
+            "texto": "Compras · fluxo vigente",
+            "papel": "chapeu",
+            "anim": "nenhuma"
+          }
+        ]
+      }
+    ]
+  },
+  "atualizado": "2026-08-16T15:08:28+00:00"
+}

package/studio/arquivos/traco-sweep-traco-0bcf4.json

@@ -0,0 +1,102 @@
+{
+  "id": "traco-sweep-traco-0bcf4",
+  "ferramenta": "traco",
+  "titulo": "sweep-traco",
+  "doc": {
+    "tema": "meia-noite",
+    "largura": 1920,
+    "altura": 1080,
+    "cenas": [
+      {
+        "layout": "livre",
+        "fundo": "pontos",
+        "elementos": [
+          {
+            "id": "ped",
+            "tipo": "no",
+            "texto": "Pedido aberto",
+            "x": 120,
+            "y": 480,
+            "l": 320,
+            "a": 140,
+            "destaque": true
+          },
+          {
+            "id": "val",
+            "tipo": "no",
+            "texto": "Validação\nfiscal",
+            "x": 620,
+            "y": 480,
+            "l": 320,
+            "a": 140
+          },
+          {
+            "id": "ger",
+            "tipo": "no",
+            "texto": "Aprovação\ngerência",
+            "x": 1120,
+            "y": 300,
+            "l": 320,
+            "a": 140
+          },
+          {
+            "id": "dir",
+            "tipo": "no",
+            "texto": "Aprovação\ndiretoria",
+            "x": 1120,
+            "y": 660,
+            "l": 320,
+            "a": 140
+          },
+          {
+            "id": "ok",
+            "tipo": "no",
+            "texto": "Compra\nemitida",
+            "x": 1560,
+            "y": 480,
+            "l": 280,
+            "a": 140,
+            "destaque": true
+          },
+          {
+            "tipo": "conector",
+            "de": "ped",
+            "para": "val"
+          },
+          {
+            "tipo": "conector",
+            "de": "val",
+            "para": "ger",
+            "texto": "até R$ 20 mil"
+          },
+          {
+            "tipo": "conector",
+            "de": "val",
+            "para": "dir",
+            "texto": "acima de R$ 20 mil"
+          },
+          {
+            "tipo": "conector",
+            "de": "ger",
+            "para": "ok"
+          },
+          {
+            "tipo": "conector",
+            "de": "dir",
+            "para": "ok"
+          },
+          {
+            "tipo": "texto",
+            "x": 120,
+            "y": 120,
+            "l": 900,
+            "a": 120,
+            "texto": "Compras · fluxo vigente",
+            "papel": "chapeu"
+          }
+        ]
+      }
+    ]
+  },
+  "atualizado": "2026-08-16T15:07:33+00:00"
+}

package/studio/ferramentas/corte.md

@@ -70,18 +70,69 @@ fatos da SUA tarefa. O servidor recusa documento que venha com estas frases.
 
 ---
 
-## Como pensar um vídeo curto
-
-Um Reels de 30 s são 7 a 9 cenas de 3 a 5 segundos. A regra é dura:
-**uma frase por cena**. Se não dá para ler em voz alta dentro da duração, corte texto.
-
-| Cena | Papel | Duração |
-|---|---|---|
-| 1 | gancho — a frase que segura o dedo | 2–3 s |
-| 2–3 | o problema, concreto | 3–4 s |
-| 4–6 | a virada, um argumento por cena | 4 s |
-| 7 | número ou prova | 4 s |
-| 8 | chamada — o que fazer agora | 3 s |
+## ANTES DE ESCREVER: escolha, não repita
+
+O exemplo acima é UMA receita. Usar sempre ela — `brasa`, `pulso`, gancho →
+problema → virada — é o que faz todo vídeo sair com a mesma cara. O dono já
+reclamou disso: *"ele não alterna entre os temas, usa um tema só pra todos os
+vídeos, e o vídeo sempre tem a mesma estrutura, fica tudo genérico"*.
+
+Escolha as quatro coisas abaixo **pelo assunto**, antes de escrever a primeira
+cena. Se o assunto não empurrar para nenhuma, escolha a que você NÃO usou da
+última vez — nunca a primeira da lista por comodidade.
+
+| Assunto | `tema` | `trilha` | Estrutura |
+|---|---|---|---|
+| produto, tecnologia, lançamento | `meia-noite` ou `neon` | `pulso` | **Gancho** |
+| institucional, quem somos, serviço | `oceano` ou `floresta` | `ambiente` | **Retrato** |
+| urgência, notícia, alerta, dado duro | `brasa` | `tenso` | **Manchete** |
+| explicação, tutorial, passo a passo | `papel` ou `claro` | `lofi` | **Aula** |
+| conquista, agradecimento, celebração | `doce` ou `neon` | `alegre` | **Brinde** |
+| memória, história, retrospectiva | `retro` ou `mono` | `lofi` | **Linha** |
+
+### As seis estruturas
+
+Cada uma tem ritmo próprio. Não misture, e não use "Gancho" para tudo.
+
+**Gancho** (vender algo) — 7 a 9 cenas de 3 a 5 s
+frase que segura o dedo · o problema, concreto · a virada, um argumento por
+cena · número ou prova · chamada.
+
+**Retrato** (apresentar quem faz) — 5 a 6 cenas de 4 a 6 s, mais calmo
+o nome e o que faz · para quem · como trabalha · uma prova (número, cliente,
+tempo de casa) · convite. Transições suaves (`fade`, `limpar`), sem `flash`.
+
+**Manchete** (informar rápido) — 4 a 6 cenas de 2 a 4 s, seco
+o fato em uma linha · o número que dói · por que aconteceu · o que muda para
+você. Corte duro entre cenas (`corte`, `flash`), texto grande, pouca palavra.
+
+**Aula** (ensinar) — 6 a 10 cenas de 4 a 7 s
+a pergunta · por que importa · passo 1, 2, 3 (uma cena cada, com `lista`
+revelando) · o resumo · o erro comum a evitar. Fundo calmo, sem fogos.
+
+**Brinde** (celebrar) — 4 a 6 cenas de 3 a 4 s
+a conquista · os números dela · quem fez acontecer · agradecimento.
+Animações vivas (`saltar`, `elastico`), fundo com brilho.
+
+**Linha** (contar uma história no tempo) — 6 a 8 cenas de 4 a 5 s
+o começo · o que mudou em cada etapa (uma cena por marco, com o ano no
+`chapeu`) · onde chegou · o que vem. Um `tema` por época, se fizer sentido.
+
+### Regras que matam o genérico
+
+- **O `fundo` muda a cena a cena.** Onze existem. Dez cenas com o mesmo fundo
+  é o que faz parecer template. Repetir um fundo tudo bem; repetir TODOS não.
+- **A `transicao` muda também.** Tudo em `fade` parece slide, não vídeo.
+- **A `trilha` combina com o assunto.** Seis estilos existem; `pulso` não é o
+  padrão de nada — é o de vídeo de produto.
+- **Cor de destaque.** Se o usuário tem marca, `marca.cor` pinta números,
+  gráficos e detalhes. Sem marca, escolha `tom` na cena que mais importa.
+- **Uma cena fora do tom.** Uma citação em `papel` no meio de um deck escuro,
+  ou uma cena `mono` antes do fecho, vale mais que dez efeitos.
+
+Um Reels de 30 s é 7 a 9 cenas de 3 a 5 segundos. A regra é dura:
+**uma frase por cena**. Se não dá para ler em voz alta dentro da duração,
+corte texto.
 
 Vertical é `1080 × 1920`. Horizontal (`1920 × 1080`) só quando o destino for YouTube
 ou tela grande. Em vertical, os tamanhos padrão de texto já crescem sozinhos.
@@ -127,6 +178,102 @@ livre de direitos, ou uma das trilhas geradas acima.
 
 ---
 
+## Editar o vídeo do usuário (`clipe`)
+
+Quando a pessoa manda uma gravação dela — o rosto falando, uma tela gravada,
+uma cena de celular — o trabalho é EDITAR, não ilustrar. O elemento `clipe`
+põe um trecho dessa gravação dentro de uma cena.
+
+**Primeiro passo, sempre:** `studio_midia` com o caminho do arquivo. Ele
+devolve uma URL `/midia/...`. Um caminho do disco (`/Users/...`, `C:\...`)
+não funciona — o navegador não abre arquivo local.
+
+```json
+{ "tipo": "clipe", "src": "/midia/gravacao.mp4", "de": 12.4, "ate": 19.8 }
+```
+
+| campo | o que faz |
+|---|---|
+| `src` | a URL que `studio_midia` devolveu — obrigatório |
+| `de` / `ate` | segundos **no arquivo original**. O trecho, não a cena |
+| `mudo` | `true` deixa só a imagem (quando quem fala é a narração) |
+| `volume` | 0 a 1, para misturar a voz da gravação com a trilha |
+| `ajuste` | `"cobrir"` (padrão, enche o quadro) ou `"conter"` |
+| `filtro` | `"cinza"`, `"sepia"`, `"contraste"`, `"desbotado"` |
+| `x`/`y` | só se quiser quadro-dentro-do-quadro; sem eles ocupa a cena inteira |
+
+Sem `x`/`y` o clipe é o CHÃO da cena: a imagem enche o quadro e o texto fica
+por cima. É o que se quer quase sempre.
+
+**Não escreva `duracao` numa cena com clipe.** A cena passa a durar o trecho
+(`ate` − `de`) sozinha. Escrever `duracao` por cima é o que faz o corte não
+cortar: o trecho de 1,2s fica congelado até completar os 4s.
+
+### Cortar as pausas
+
+**Não adivinhe onde estão.** Chame `studio_analisar` com a URL do vídeo: ele
+ouve o arquivo e devolve `trechos`, a lista de `[início, fim]` já sem os
+silêncios. Cada trecho vira uma cena.
+
+```
+studio_analisar  arquivo: "/midia/gravacao.mp4"
+→ { trechos: [[0.8, 6.2], [9.5, 17.1], [19.0, 24.3]], cortado: 4.6 }
+```
+
+`pausa` (padrão 0,6s) é a partir de quantos segundos de silêncio conta como
+pausa. Suba para 1.0 se a pessoa fala pausado e o corte ficou ofegante.
+
+A análise leva alguns segundos e abre uma aba que se fecha sozinha — é o
+navegador que sabe ler o áudio de um .mp4. Se ela não responder, siga com o
+vídeo inteiro num clipe só; não invente tempos.
+
+Cortar as pausas é escrever VÁRIOS clipes do mesmo `src`, com os silêncios de
+fora. Uma cena por trecho aproveitado:
+
+```json
+"cenas": [
+  { "layout": "capa", "transicao": "fade",
+    "elementos": [{ "tipo": "clipe", "src": "/midia/gravacao.mp4", "de": 0.8, "ate": 6.2 },
+                  { "tipo": "texto", "papel": "titulo", "texto": "O que ninguém te conta" }] },
+  { "layout": "capa", "transicao": "corte",
+    "elementos": [{ "tipo": "clipe", "src": "/midia/gravacao.mp4", "de": 9.5, "ate": 17.1 }] }
+]
+```
+
+Entre 6.2 e 9.5 havia uma pausa: ela simplesmente não entra. Use `"transicao":
+"corte"` entre trechos da mesma fala — fade entre dois pedaços da mesma frase
+parece defeito.
+
+### Legendar
+
+A legenda é um `texto` com `"papel": "fala"` na mesma cena do clipe:
+
+```json
+{ "tipo": "texto", "papel": "fala", "texto": "isso mudou tudo pra mim" }
+```
+
+Ela já vai sozinha para o terço de baixo, branca, com chapa escura atrás —
+legível sobre qualquer imagem. Não use `papel: "legenda"` para isso: aquele é
+o rodapé de um slide, com 18px, ilegível num vídeo.
+
+Uma frase curta por cena, no ritmo da fala — nunca o parágrafo inteiro. Se o
+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
+`narracao` na cena.
+
+### 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.
+
+---
+
 ## Narração
 
 A voz que fala por cima do vídeo. Vai **na cena**, e o estúdio narra sozinho