primocode 10.17.0 → 10.19.0

package/kits/terminal/elementos/TextoGrande.tsx

@@ -0,0 +1,35 @@
+// TextoGrande: frases grandes impressas no tubo (VT323 até 150 px), cada linha digitada com a cadência
+// humana, com cursor de bloco no fim da última. `quente` pinta a linha com o acento.
+import React from 'react';
+import {useCurrentFrame} from 'remotion';
+import {BLOOM, COR, FONTE, GRADE, cadencia, digitados} from './base';
+
+export type TextoGrandeProps = {
+  linhas: {texto: string; tamanho?: number; quente?: boolean}[];
+  y?: number;
+  inicio?: number;
+  /** quadros entre o fim de uma linha e o começo da próxima */
+  pausa?: number;
+  cursor?: boolean;
+};
+
+export const TextoGrande: React.FC<TextoGrandeProps> = ({linhas, y = 300, inicio = 0, pausa = 4, cursor = true}) => {
+  const f = useCurrentFrame() - inicio;
+  if (f < 0) return null;
+  let t0 = 0, top = y;
+  return <>{linhas.map((l, i) => {
+    const tam = l.tamanho ?? 120;
+    const tempos = cadencia(l.texto, i + 5).map((x) => x * 0.5);
+    const comeca = t0; const n = digitados(f - comeca, tempos);
+    t0 += (tempos[tempos.length - 1] ?? 0) + pausa;
+    const meuTop = top; top += tam * 1.05;
+    if (f < comeca) return null;
+    const ultima = i === linhas.length - 1;
+    const cor = l.quente ? COR.quente : COR.fosforo;
+    const pisca = n < l.texto.length || Math.floor(f / 8) % 2 === 0;
+    return <div key={i} style={{position: 'absolute', left: GRADE.margem, top: meuTop, fontFamily: FONTE, fontSize: tam, lineHeight: 1, color: cor, textShadow: BLOOM(COR.fosforo, 1.2), whiteSpace: 'pre'}}>
+      {l.texto.slice(0, n)}
+      {cursor && (ultima || n < l.texto.length) && pisca && <span style={{display: 'inline-block', width: tam * 0.5, height: tam * 0.8, background: COR.quente, verticalAlign: '-0.05em', boxShadow: BLOOM(COR.fosforo, 0.8)}} />}
+    </div>;
+  })}</>;
+};

package/kits/terminal/elementos/base.ts

@@ -0,0 +1,67 @@
+// Base do kit terminal (v2): um MONITOR CRT de fósforo âmbar. Cores, fontes, grade de caracteres,
+// curvas e a cadência de digitação. Todo número visual sai daqui.
+import {continueRender, delayRender} from 'remotion';
+import vt323 from '../assets/fontes/vt323.woff2';
+import jb700 from '../assets/fontes/jetbrains-mono-700.woff2';
+
+// ---------- tela ----------
+export const LARGURA = 1080, ALTURA = 1920, FPS = 30;
+export const SEGURA = {topo: 168, base: 1330, lado: 88};
+/** o monitor (moldura de plástico) e o vidro, em px da tela 1080×1920 */
+export const MONITOR = {x: 64, y: 142, l: 952, a: 1352, chin: 150};
+export const VIDRO = {x: 120, y: 198, l: 840, a: 1110}; // texto lido entre y 198 e 1308
+/** a grade de caracteres dentro do vidro */
+export const GRADE = {margem: 44, tamanho: 50, linha: 58};
+
+// ---------- cor (fósforo P3 âmbar, ver regras/cor.md) ----------
+export const COR = {
+  parede: '#0A0705',
+  plastico: '#1D1A17',
+  plasticoLuz: '#2B2723',
+  plasticoSombra: '#0F0D0B',
+  vidro: '#120A02',
+  vidroCentro: '#1D1206',
+  fosforo: '#FFB23F',
+  /** o único acento: fósforo superaquecido (o herói e o cursor) */
+  quente: '#FFE7B0',
+  apagado: '#7A4A12',
+  led: '#FF9A1F',
+};
+
+// ---------- fonte ----------
+export const FONTE = '"TM VT323", monospace';
+export const FONTE_PLACA = '"TM JetBrains Mono", monospace';
+if (typeof document !== 'undefined' && !(globalThis as Record<string, unknown>).__k_terminal2) {
+  (globalThis as Record<string, unknown>).__k_terminal2 = true;
+  const h = delayRender('terminal: fontes');
+  Promise.all([['TM VT323', vt323, '400'], ['TM JetBrains Mono', jb700, '700']].map(([nome, url, peso]) =>
+    new FontFace(nome, `url(${url}) format('woff2')`, {weight: peso, style: 'normal'}).load().then((ff) => {document.fonts.add(ff);}).catch(() => undefined)))
+    .then(() => continueRender(h));
+}
+/** brilho do fósforo (bloom): só neste estilo é permitido */
+export const BLOOM = (cor: string = COR.fosforo, k = 1) => `0 0 ${4 * k}px ${cor}, 0 0 ${14 * k}px ${cor}99, 0 0 ${34 * k}px ${cor}44`;
+
+// ---------- tempo e curva ----------
+export const c01 = (t: number) => Math.max(0, Math.min(1, t));
+export const seg = (f: number, a: number, b: number) => (b <= a ? (f >= b ? 1 : 0) : c01((f - a) / (b - a)));
+export const e5 = (t: number) => 1 - Math.pow(1 - c01(t), 5);
+export const e3 = (t: number) => {const x = c01(t); return x * x * (3 - 2 * x);};
+export const lerp = (a: number, b: number, t: number) => a + (b - a) * t;
+export const ruido = (n: number) => {const x = Math.sin(n * 127.1 + 311.7) * 43758.5453; return x - Math.floor(x);};
+/** uma batida da trilha (110 bpm) em quadros */
+export const BATIDA = 16.36;
+
+/** cadência de digitação humana: quadro em que cada caractere aparece (relativo ao início).
+ *  1–3 quadros por tecla, pausa de 5 quadros antes de "-" e de espaço depois da palavra do comando. */
+export const cadencia = (texto: string, semente = 1): number[] => {
+  const out: number[] = []; let t = 0;
+  for (let i = 0; i < texto.length; i++) {
+    const ch = texto[i];
+    if (ch === ' ' || ch === '-' && texto[i - 1] === ' ') t += 4;
+    t += 1 + Math.floor(ruido(i * 7.3 + semente) * 2.6);
+    out.push(t);
+  }
+  return out;
+};
+/** quantos caracteres já foram digitados no quadro f */
+export const digitados = (f: number, tempos: number[]) => {let n = 0; while (n < tempos.length && tempos[n] <= f) n++; return n;};

package/kits/terminal/elementos/index.ts

@@ -0,0 +1,16 @@
+// Tudo que o kit terminal oferece.
+export * from './base';
+export * from './Fundo';
+export * from './Camera';
+export * from './Monitor';
+export * from './Tela';
+export * from './Cena';
+export * from './Som';
+export * from './BootBios';
+export * from './LinhaComando';
+export * from './BarraProgresso';
+export * from './ArteAscii';
+export * from './PainelCaixa';
+export * from './TextoGrande';
+export * from './BarraStatus';
+export * from './Montagem';

package/kits/terminal/exemplos/plano.json

@@ -0,0 +1,330 @@
+{
+ "kit": "terminal",
+ "duracao": 240,
+ "trilha": {
+  "volume": 0.45
+ },
+ "monitor": {
+  "placa": "VG-9 · fósforo P3",
+  "liga": 0,
+  "desliga": 234
+ },
+ "status": {
+  "segmentos": [
+   "VIGIA.EXE",
+   "COM1 9600"
+  ],
+  "desde": 10
+ },
+ "camera": [
+  [
+   0,
+   0.93,
+   40
+  ],
+  [
+   56,
+   0.96,
+   24
+  ],
+  [
+   112,
+   0.99,
+   0
+  ],
+  [
+   124,
+   1.16,
+   -80
+  ],
+  [
+   160,
+   1.18,
+   -80
+  ],
+  [
+   172,
+   1.0,
+   0
+  ],
+  [
+   200,
+   1.0,
+   0
+  ],
+  [
+   214,
+   1.1,
+   -50
+  ],
+  [
+   240,
+   1.12,
+   -50
+  ]
+ ],
+ "cenas": [
+  {
+   "batida": "gancho",
+   "de": 0,
+   "ate": 56,
+   "entrada": "nenhuma",
+   "camadas": [
+    {
+     "elemento": "BootBios",
+     "props": {
+      "cabecalho": [
+       "VIGIA BIOS v2.13",
+       "(c) 1994 Vigia Labs"
+      ],
+      "memoria": {
+       "rotulo": "TESTE DE MEMÓRIA",
+       "ate": 640,
+       "unidade": "K"
+      },
+      "checagens": [
+       "DISCO C:",
+       "REDE COM1",
+       "MODEM 9600"
+      ],
+      "inicio": 8,
+      "intervalo": 5
+     }
+    }
+   ],
+   "sons": [
+    {
+     "som": "liga-crt",
+     "em": 0
+    },
+    {
+     "som": "subida",
+     "em": 12,
+     "volume": 0.4
+    },
+    {
+     "som": "clique",
+     "em": 34
+    },
+    {
+     "som": "tick",
+     "em": 38
+    },
+    {
+     "som": "pop-palavra",
+     "em": 43,
+     "volume": 0.5
+    }
+   ]
+  },
+  {
+   "batida": "comando",
+   "de": 56,
+   "ate": 112,
+   "entrada": "varre",
+   "camadas": [
+    {
+     "elemento": "LinhaComando",
+     "props": {
+      "comando": "vigia --blindar",
+      "y": 80,
+      "tamanho": 66,
+      "inicio": 2,
+      "enter": 38
+     }
+    },
+    {
+     "elemento": "BarraProgresso",
+     "props": {
+      "itens": [
+       {
+        "rotulo": "FIREWALL",
+        "duracao": 26
+       },
+       {
+        "rotulo": "SENHAS",
+        "duracao": 30
+       },
+       {
+        "rotulo": "BACKUP",
+        "duracao": 34
+       }
+      ],
+      "y": 270,
+      "inicio": 38,
+      "intervalo": 5
+     }
+    }
+   ],
+   "sons": [
+    {
+     "som": "digitar",
+     "em": 1
+    },
+    {
+     "som": "clique",
+     "em": 37
+    },
+    {
+     "som": "subida",
+     "em": 40,
+     "volume": 0.5
+    },
+    {
+     "som": "pop-cartao",
+     "em": 64,
+     "volume": 0.6
+    },
+    {
+     "som": "tick",
+     "em": 69
+    },
+    {
+     "som": "pop-palavra",
+     "em": 73,
+     "volume": 0.5
+    }
+   ]
+  },
+  {
+   "batida": "virada",
+   "de": 112,
+   "ate": 160,
+   "entrada": "varre",
+   "camadas": [
+    {
+     "elemento": "ArteAscii",
+     "props": {
+      "texto": "VIGIA",
+      "y": 380,
+      "inicio": 4,
+      "porLinha": 2
+     }
+    },
+    {
+     "elemento": "TextoGrande",
+     "props": {
+      "linhas": [
+       {
+        "texto": "seu servidor,",
+        "tamanho": 76
+       },
+       {
+        "texto": "de guarda.",
+        "tamanho": 76,
+        "quente": true
+       }
+      ],
+      "y": 660,
+      "inicio": 12,
+      "pausa": 3
+     }
+    }
+   ],
+   "sons": [
+    {
+     "som": "whoosh-entra",
+     "em": 0
+    },
+    {
+     "som": "impacto",
+     "em": 4
+    },
+    {
+     "som": "digitar",
+     "em": 12,
+     "volume": 0.5
+    }
+   ]
+  },
+  {
+   "batida": "prova",
+   "de": 160,
+   "ate": 200,
+   "entrada": "varre",
+   "camadas": [
+    {
+     "elemento": "PainelCaixa",
+     "props": {
+      "titulo": " STATUS ",
+      "linhas": [
+       {
+        "chave": "SERVIDORES",
+        "valor": 214,
+        "de": 0
+       },
+       {
+        "chave": "AMEAÇAS",
+        "valor": 0,
+        "de": 37
+       },
+       {
+        "chave": "UPTIME",
+        "valor": 99.99,
+        "de": 90,
+        "casas": 2,
+        "sufixo": "%"
+       }
+      ],
+      "y": 300,
+      "inicio": 2,
+      "intervalo": 3
+     }
+    }
+   ],
+   "sons": [
+    {
+     "som": "swoosh",
+     "em": 0
+    },
+    {
+     "som": "pop-cartao",
+     "em": 12,
+     "volume": 0.6
+    },
+    {
+     "som": "tick",
+     "em": 16
+    }
+   ]
+  },
+  {
+   "batida": "cta",
+   "de": 200,
+   "ate": 240,
+   "entrada": "varre",
+   "camadas": [
+    {
+     "elemento": "TextoGrande",
+     "props": {
+      "linhas": [
+       {
+        "texto": "12.11",
+        "tamanho": 230,
+        "quente": true
+       },
+       {
+        "texto": "vigia.app",
+        "tamanho": 110
+       }
+      ],
+      "y": 340,
+      "inicio": 2,
+      "pausa": 3
+     }
+    }
+   ],
+   "sons": [
+    {
+     "som": "assinatura",
+     "em": 2
+    },
+    {
+     "som": "whoosh-sai",
+     "em": 35,
+     "volume": 0.6
+    }
+   ]
+  }
+ ]
+}

package/kits/terminal/exemplos/roteiro.md

@@ -0,0 +1,14 @@
+# Roteiro da demo: Vigia (ferramenta de segurança fictícia)
+
+Pedido: "Reels de lançamento do Vigia, que blinda servidor. Quero cara de computador antigo."
+
+| cena | batida | quadros | na tela | elemento | som |
+|---|---|---|---|---|---|
+| 1 | gancho | 0–56 | tubo liga · VIGIA BIOS · 000640K OK · checagens | BootBios | liga-crt, subida, clique, tick |
+| 2 | comando | 56–112 | C:\>vigia --blindar · 3 barras enchendo | LinhaComando, BarraProgresso | digitar, clique, subida, pop |
+| 3 | virada | 112–160 | VIGIA em blocos · "seu servidor, de guarda." | ArteAscii, TextoGrande | whoosh, impacto, digitar |
+| 4 | prova | 160–200 | STATUS: 214 servidores · 0 ameaças · 99,99% | PainelCaixa | swoosh, pop, tick |
+| 5 | cta | 200–240 | 12.11 · vigia.app · tubo desliga | TextoGrande | assinatura, whoosh-sai |
+
+Como a IA chegou nisso: a história de uma máquina (liga → trabalha → entrega → desliga) dá a ordem. A saída do
+comando é o produto funcionando, então ela é o herói, não um enfeite. Vigia é marca fictícia.

package/kits/terminal/preview.tsx

@@ -0,0 +1,9 @@
+// Preview do kit: demo de 8 s montada SÓ com os elementos do kit, a partir de exemplos/plano.json.
+// O estúdio registra isto como `Kit-terminal`.
+import React from 'react';
+import {Montagem, Plano} from './elementos';
+import plano from './exemplos/plano.json';
+
+const Preview: React.FC = () => <Montagem plano={plano as unknown as Plano} />;
+
+export const preview = {duracaoEmQuadros: plano.duracao, quadroCapa: 154, Componente: Preview};

package/kits/terminal/receita.json

@@ -0,0 +1,14 @@
+{
+  "kit": "terminal", "fps": 30, "batida_trilha_quadros": 16.36,
+  "batidas": [
+    {"nome": "gancho", "obrigatoria": true, "duracao": [48, 60], "elementos": ["BootBios"], "entrada": ["nenhuma"], "sons": ["liga-crt", "subida", "clique", "tick"], "nota": "o tubo liga e o BIOS conta a memória"},
+    {"nome": "comando", "obrigatoria": true, "duracao": [48, 60], "elementos": ["LinhaComando", "BarraProgresso"], "entrada": ["varre"], "sons": ["digitar", "clique", "subida", "pop-cartao"], "nota": "alguém digita; a saída vira o herói"},
+    {"nome": "virada", "obrigatoria": true, "duracao": [42, 54], "elementos": ["ArteAscii", "TextoGrande"], "entrada": ["varre"], "sons": ["whoosh-entra", "impacto", "digitar"], "nota": "o nome em letras de bloco + uma frase; câmera empurra"},
+    {"nome": "prova", "obrigatoria": false, "duracao": [34, 42], "elementos": ["PainelCaixa", "BarraProgresso"], "entrada": ["varre"], "sons": ["swoosh", "pop-cartao", "tick"], "nota": "3 números que contam"},
+    {"nome": "cta", "obrigatoria": true, "duracao": [36, 42], "elementos": ["TextoGrande"], "entrada": ["varre"], "sons": ["assinatura", "whoosh-sai"], "nota": "data + endereço digitados; o tubo desliga"}
+  ],
+  "transicoes": [
+    {"nome": "varre", "quadros": 8, "como": "a tela nova é escrita de cima a baixo, cabeça de escrita quente"},
+    {"nome": "corte", "quadros": 0, "como": "troca seca"}
+  ]
+}

package/kits/terminal/regras/area-segura.md

@@ -0,0 +1,18 @@
+# Área segura
+
+Tela 1080×1920. O texto mora no vidro: x 120–960, y 198–1308 (dentro de 168–1330).
+
+| elemento | y no vidro (somar 198 pra tela) |
+|---|---|
+| cabeçalho BIOS | 70 |
+| contador de memória | 290 |
+| checagens | 560+ |
+| comando | 80 |
+| barras | 270, passo 230 |
+| letras de bloco | 380 |
+| texto grande | 340–660 |
+| painel | 300 |
+| barra de status | 1006 (fixa) |
+
+- Monitor: x 64–1016, y 142–1494; quarto e mesa embaixo (y 1590+), sem texto.
+- No empurrão do herói (1,16) o vidro passa da tela nas laterais: o herói fica em x 160–920.

package/kits/terminal/regras/cor.md

@@ -0,0 +1,16 @@
+# Cor
+
+| token | hex | uso |
+|---|---|---|
+| parede | #0A0705 | o quarto |
+| plastico | #1D1A17 (luz #2B2723, sombra #0F0D0B) | o monitor |
+| vidro | #120A02 (centro #1D1206) | o tubo apagado |
+| fosforo | #FFB23F | todo texto e bloco |
+| quente | #FFE7B0 | o acento: herói, cursor, [OK], linha recém-escrita |
+| apagado | #7A4A12 | prompt, rótulos secundários |
+| led | #FF9A1F | LED do monitor |
+
+- Bloom: `0 0 4px fosforo, 0 0 14px fosforo/60%, 0 0 34px fosforo/27%`.
+- Varredura: 1 px preto a 34% a cada 3 px. Vinheta: 0 → 92% do raio 58% ao 100%.
+- Vazamento de luz na parede: âmbar a 16% (pulsa ±4%).
+- O cliente pode trocar o fósforo por verde P1 (#7DFF6A) ou branco P4 (#E8F0FF), sempre um só.

package/kits/terminal/regras/movimento.md

@@ -0,0 +1,15 @@
+# Movimento
+
+| movimento | quadros | valores |
+|---|---|---|
+| tubo liga | 2–9 | linha de 4 px abre em escala Y 0,004 → 1 (curva e5), brilho 2,2× |
+| tubo desliga | 0–4 + 4–8 | fecha em linha (Y → 0,004), depois em ponto (X → 0,01) |
+| entrada `varre` | 8 | a tela nova é revelada de cima a baixo com cabeça de escrita quente |
+| digitação | 1–3 por tecla | +4 antes de espaço e de opção "-" (cadência determinística) |
+| cursor | 8 on / 8 off | sólido enquanto digita |
+| contador de memória | 20 | 12 saltos irregulares |
+| barra de progresso | 26–34 | 9 degraus irregulares, para em 97% até completar |
+| letras de bloco | 2 por linha (7 linhas) | cada bloco nasce quente e esfria em 6; tremor de 0,6 célula enquanto quente |
+| painel | 8 + 12 | moldura desenha em 8, cada valor conta em 12 |
+| câmera | contínuo | giro Y ±2,5° (período 14,7 s), X ±1,2°; empurrão 1,0 → 1,16 em 12 quadros no herói |
+| barra que rola | 75 | de −20% a 120% do vidro |

package/kits/terminal/regras/ritmo.md

@@ -0,0 +1,14 @@
+# Ritmo
+
+110 bpm = 16,36 quadros por batida.
+
+| batida | duração s | quadros |
+|---|---|---|
+| gancho (boot) | 1,6–2,0 | 48–60 |
+| comando | 1,6–2,0 | 48–60 |
+| virada (letras de bloco) | 1,4–1,8 | 42–54 |
+| prova (painel) | 1,1–1,4 | 34–42 |
+| cta | 1,2–1,4 | 36–42 |
+
+- Leitura: a digitação termina ≥ 8 quadros antes do corte; cada [OK] fica ≥ 10 quadros.
+- O tubo desliga só nos últimos 6 quadros.

package/kits/terminal/regras/som.md

@@ -0,0 +1,17 @@
+# Som
+
+Trilha: `assets/trilha/trilha.mp3` (dark-minimal, 110 bpm), volume 0,45, fade de 20 quadros. Alvo −14 LUFS.
+
+| som | volume | quando |
+|---|---|---|
+| liga-crt | 0,9 | o tubo liga (quadro 0) |
+| digitar | 0,5–0,8 | cada digitação (rajada de 16 teclas com cadência humana) |
+| clique | 0,8 | Enter e [OK] da memória |
+| subida | 0,4–0,5 | contagem e barras enchendo |
+| impacto | 0,9 | as letras de bloco (1 por vídeo) |
+| tick / pop-palavra / pop-cartao | 0,5–0,6 | [OK] de cada barra e checagem, alternando os arquivos |
+| swoosh / whoosh-entra | 1 / 0,9 | troca de tela |
+| assinatura | 0,9 | a data final |
+| whoosh-sai | 0,6 | o tubo desliga |
+
+- Máx. 3 sons por segundo, nunca o mesmo arquivo duas vezes seguidas (a rajada de teclas conta como 1).

package/kits/terminal/regras/tipografia.md

@@ -0,0 +1,15 @@
+# Tipografia
+
+| papel | fonte | tamanho px | máx. caracteres | caixa |
+|---|---|---|---|---|
+| contador de memória | VT323 | 210 (unidade 96) | 6 dígitos | — |
+| texto grande / data | VT323 | 110–230 | 9 | livre |
+| comando | VT323 | 66 | 18 | baixa |
+| rótulo de barra | VT323 | 62 | 10 | alta |
+| valor do painel | VT323 | 64 | 12 | alta |
+| BIOS / checagens | VT323 | 44 | 24 | alta |
+| status | VT323 | 40 | 30 | alta |
+| placa do monitor | JetBrains Mono 700 | 22, tracking 0,24 em | 20 | alta |
+
+- Margem do texto dentro do vidro: 44 px. Linha da grade: 58 px.
+- Letras de bloco: fonte 5×7 desenhada, célula = largura ÷ (letras × 6 − 1), vão 12% da célula, até 760 px.

package/kits/tiktok-energia/SKILL.md

@@ -0,0 +1,51 @@
+---
+slug: tiktok-energia
+nome: Energia TikTok
+descricao: blocos de cor chapada que cortam a cada 28 quadros, palavra gigante em Anton que bate com tremor e divisão de cor, texto de adesivo em caixa e emoji com contorno
+familia: Redes sociais
+versao: 1
+quando:
+  - "anúncio de drop, promoção ou lançamento com muita energia"
+  - "vídeo de jovem público: moda, tênis, games, música, evento"
+  - "reels de contagem, "só hoje" e chamada de ação urgente"
+  - "trend rápida com texto na tela e cortes secos"
+  - "divulgação de sorteio ou data com tom empolgado"
+nao_serve:
+  - "vídeo calmo, elegante ou institucional (use aurora ou apple-tipografico)"
+  - "conteúdo explicativo longo (a energia atropela frases acima de 3 palavras)"
+---
+
+# Energia TikTok
+
+Cada cena é **um bloco de cor chapada** (lima `#D4FF1F`, preto, magenta `#FF2D75`, azul `#2E5BFF`) que entra cortando em diagonal em 6 quadros e fica. Sobre ele, **uma palavra de 380 px em Anton** que **bate**: nasce a 3,4× o tamanho, assenta em 4 quadros e treme (14 px, decaindo em 6 quadros) com a **divisão de cor RGB** (sombras magenta e azul a ±16 px que fecham para ±3 px). Frases curtas aparecem em **caixas de texto de adesivo** (Rubik 800, branca, preta, lima ou magenta, giradas 3–6°); fotos entram como **retângulo de quina viva com sombra sólida**; emoji de 240 px com **contorno branco** quica. A câmera treme em cada batida e o ritmo é de um corte a cada 28–36 quadros. Depois de cada soco, uma pausa de 15–18 quadros: **a energia vem do contraste entre bater e segurar**.
+
+## Como montar um vídeo com este kit
+
+1. **Leia o pedido e o roteiro.** Corte cada fala em frases curtas. Uma frase = uma cena.
+2. **Escolha as batidas** em `receita.json` (gancho → virada → prova → data → cta → marca). Cada batida diz quanto dura e quais elementos servem.
+3. **Escreva o plano de cenas** (`plano.json`, mesmo formato de `exemplos/plano.json`): para cada cena, `de`/`ate` em quadros, a `entrada`, as `camadas` (elemento + props) e os `sons`. Os cortes seguem a voz (se houver) ou a batida da trilha: 1 batida = 14.0625 quadros.
+4. **Renderize** com `<Montagem plano={...} arquivos={...} />` ou escreva o TSX direto combinando `Fundo`, `Camera`, `Cena` e os elementos (tudo sai de `elementos/index.ts`).
+5. **Confira** os quadros (um por cena) contra `regras/`: área segura, nada cortado, um herói por cena, nenhum quadro parado.
+
+## Elementos
+
+| elemento | o que faz | batidas |
+|---|---|---|
+| `CorteDeCor` | bloco de cor chapada que corta em diagonal em 6 quadros e vira o fundo da cena | todas |
+| `PalavraSoco` | palavra (ou sequência) em Anton 380 px que bate com tremida e divisão RGB | gancho, virada, data, cta |
+| `TextoCaixa` | frase curta em caixa de adesivo (branca, preta, lima ou magenta) girada | prova, apoio |
+| `FotoSoco` | foto em retângulo de quina viva com sombra sólida, bate e dá zoom | prova |
+| `EmojiSticker` | emoji de 240 px com contorno branco que bate e quica | apoio de qualquer batida |
+| `AssinaturaMarca` | bloco lima, logo que bate, nome em Anton e endereço em caixa preta | marca |
+| `Fundo`, `Camera`, `Cena` | preto chapado (só aparece antes do primeiro bloco de cor) | todas |
+| `Efeito`, `Trilha` | sons e trilha do kit | todas |
+
+## Proibido
+
+- Cena sem corte de cor: toda cena entra com o bloco chapado em diagonal (6 quadros).
+- Palavra de herói menor que 300 px ou fora do Anton em caixa-alta.
+- Mais de 1 herói + 1 apoio por cena; margens menores que 96 px; mais de 3 palavras por frase.
+- Degradê, textura, sombra suave ou glow; só cor chapada e sombra sólida deslocada.
+- Flash branco: a única coisa que "acende" é o bloco de cor cortando.
+- Corte sem pausa: depois de cada soco a palavra fica parada (só a tremida decai) por 15–18 quadros.
+- Texto fora da área segura (168–1330 px na vertical, 96 px nas laterais).

package/kits/tiktok-energia/assets/ASSETS.md

@@ -0,0 +1,22 @@
+# Assets do kit tiktok-energia
+
+| arquivo | o que é | origem | licença |
+|---|---|---|---|
+| `fontes/anton-latin.woff2` | Anton (400), subset latino | Google Fonts (`fonts.googleapis.com/css2?family=Anton`), baixado em 26/10/2026 | SIL OFL 1.1, texto em `fontes/OFL-Anton.txt` |
+| `fontes/rubik-latin.woff2` | Rubik (600 900), subset latino | Google Fonts (`fonts.googleapis.com/css2?family=Rubik`), baixado em 26/10/2026 | SIL OFL 1.1, texto em `fontes/OFL-Rubik.txt` |
+| `sons/soco.mp3` | cada palavra que bate | sintetizado: MotionCraft `sfx make`, tipo `impact`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/corte.mp3` | cada bloco de cor que corta | sintetizado: MotionCraft `sfx make`, tipo `slot_tick`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/whoosh.mp3` | foto ou caixa que entra | sintetizado: MotionCraft `sfx make`, tipo `whoosh_in`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/pop.mp3` | emoji ou caixa de texto | sintetizado: MotionCraft `sfx make`, tipo `icon_pop`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/zap.mp3` | botão / endereço | sintetizado: MotionCraft `sfx make`, tipo `button`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/subida.mp3` | antes do número ou da data | sintetizado: MotionCraft `sfx make`, tipo `riser`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/palavra.mp3` | segunda palavra da sequência | sintetizado: MotionCraft `sfx make`, tipo `word_pop`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/assinatura.mp3` | revelação da marca | sintetizado: MotionCraft `sfx make`, tipo `logo_sting`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `trilha/tech-128bpm.mp3` | 8,6 s a partir de 1.875 s da trilha gerada | MotionCraft `music make` (preset `tech-bright`, 128 bpm, tom G) | sem samples; síntese própria (CC0). MotionCraft é MIT |
+
+Conteúdo de demonstração (não faz parte do estilo, fica em `exemplos/`):
+
+| arquivo | origem | licença |
+|---|---|---|
+| `exemplos/fotos/foto-03.jpg` | cópia de `kits/apple-tipografico/exemplos/fotos/` (Unsplash, picsum id 3), recorte 720×960 | Unsplash License |
+| `exemplos/logo-pulo.svg` | logo fictício desenhado para a demo | próprio |