primocode 10.17.0 → 10.19.0

package/kits/cubos/elementos/base.ts

@@ -0,0 +1,97 @@
+// Base do kit cubos: cores, fontes, curvas e medidas. Todo número visual sai daqui.
+// Os elementos importam só este arquivo, 'react' e 'remotion'. Nada de fora da pasta do kit.
+import {continueRender, delayRender} from 'remotion';
+import fonteA from '../assets/fontes/archivoblack-latin.woff2';
+import fonteB from '../assets/fontes/dmsans-latin.woff2';
+
+// ---------- tela ----------
+export const LARGURA = 1080, ALTURA = 1920, FPS = 30;
+// área segura (Reels/TikTok): o que se lê fica entre estas linhas
+export const SEGURA = {topo: 168, base: 1330, lado: 96};
+export const LARGURA_UTIL = LARGURA - SEGURA.lado * 2; // 888 px
+
+// ---------- cor ----------
+export const COR = {
+  chao: '#E6E9EE',
+  linha: '#D2D7E0',
+  tinta: '#1B1D22',
+  tomate: '#FF5B3A',
+  sol: '#FFC21A',
+  ceu: '#3D8BFF',
+  osso: '#F7F7F5',
+};
+
+/** escurece/clareia uma cor #RRGGBB por um fator (1 = igual) */
+export const tom = (hex: string, k: number) => {
+  const n = parseInt(hex.slice(1), 16), c = (v: number) => Math.max(0, Math.min(255, Math.round(v * k)));
+  return `rgb(${c((n >> 16) & 255)}, ${c((n >> 8) & 255)}, ${c(n & 255)})`;
+};
+export const PECAS = [COR.tomate, COR.sol, COR.ceu, COR.tinta];
+
+// ---------- fonte ----------
+// Famílias com o prefixo do kit, pra não colidir com outro kit no mesmo estúdio.
+export const FAM_A = 'CB Archivo Black';
+export const FONTE_A = '"CB Archivo Black", Impact, sans-serif';
+export const FAM_B = 'CB DM Sans';
+export const FONTE_B = '"CB DM Sans", system-ui, sans-serif';
+
+// As medidas de texto (caber) só valem depois das fontes: a Montagem espera `esperarFontes()` antes de desenhar.
+const TOTAL_FONTES = 2;
+let nProntas = 0;
+const aguardando: (() => void)[] = [];
+const marcarFonte = () => {nProntas++; if (nProntas >= TOTAL_FONTES) aguardando.splice(0).forEach((r) => r());};
+export const fontesProntas = () => nProntas >= TOTAL_FONTES || typeof document === 'undefined';
+export const esperarFontes = () => new Promise<void>((res) => {if (fontesProntas()) res(); else aguardando.push(res);});
+if (typeof document !== 'undefined' && !(globalThis as Record<string, unknown>).__cbA) {
+  (globalThis as Record<string, unknown>).__cbA = true;
+  const hA = delayRender('cubos: CB Archivo Black');
+  new FontFace('CB Archivo Black', `url(${fonteA}) format('woff2')`, {weight: '400', style: 'normal'}).load()
+    .then((ff) => {document.fonts.add(ff); marcarFonte(); continueRender(hA);})
+    .catch(() => {marcarFonte(); continueRender(hA);});
+}
+if (typeof document !== 'undefined' && !(globalThis as Record<string, unknown>).__cbB) {
+  (globalThis as Record<string, unknown>).__cbB = true;
+  const hB = delayRender('cubos: CB DM Sans');
+  new FontFace('CB DM Sans', `url(${fonteB}) format('woff2')`, {weight: '500 800', style: 'normal'}).load()
+    .then((ff) => {document.fonts.add(ff); marcarFonte(); continueRender(hB);})
+    .catch(() => {marcarFonte(); continueRender(hB);});
+}
+
+// ---------- tempo e curva ----------
+export const c01 = (t: number) => Math.max(0, Math.min(1, t));
+/** progresso 0..1 de f entre a e b */
+export const seg = (f: number, a: number, b: number) => c01((f - a) / (b - a));
+/** saída rápida e pouso longo, ≈ cubic-bezier(.2,.8,.2,1) */
+export const e5 = (t: number) => 1 - Math.pow(1 - c01(t), 5);
+/** saída com overshoot (passa de 1 e volta): toda entrada do kit usa esta ou a e5 */
+export const ob = (t: number, s = 1.8) => {const x = c01(t) - 1; return 1 + (s + 1) * x * x * x + s * x * x;};
+export const lerp = (a: number, b: number, t: number) => a + (b - a) * t;
+/** pseudo-aleatório estável (0..1) a partir de um inteiro */
+export const rnd = (n: number) => {const x = Math.sin(n * 127.1 + 311.7) * 43758.5453; return x - Math.floor(x);};
+/** uma batida da trilha do kit em quadros */
+export const BATIDA = 16.667;
+
+// ---------- medida de texto ----------
+let canvas: HTMLCanvasElement | null = null;
+const cache = new Map<string, number>();
+export const larguraTexto = (texto: string, tamanho: number, fam: string, peso = 800, trackingEm = 0): number => {
+  const chave = `${texto}|${tamanho}|${fam}|${peso}|${trackingEm}`;
+  const c = cache.get(chave); if (c !== undefined) return c;
+  if (typeof document === 'undefined') return texto.length * tamanho * 0.58;
+  canvas = canvas || document.createElement('canvas');
+  const ctx = canvas.getContext('2d'); if (!ctx) return texto.length * tamanho * 0.58;
+  const fonte = `${peso} ${tamanho}px "${fam}"`;
+  ctx.font = fonte;
+  const w = ctx.measureText(texto).width + texto.length * trackingEm * tamanho;
+  if (fontesProntas() && document.fonts.check(fonte)) cache.set(chave, w);
+  return w;
+};
+/** o maior tamanho até `tamanho` em que o texto cabe em `largura` (nunca palavra cortada) */
+export const caber = (texto: string, tamanho: number, fam: string, largura = LARGURA_UTIL, peso = 800, trackingEm = 0) => {
+  const w = larguraTexto(texto, tamanho, fam, peso, trackingEm);
+  return w > largura ? Math.floor(tamanho * (largura / w)) : tamanho;
+};
+/** tira os asteriscos de destaque: "Usar *IA*" -> "Usar IA" */
+export const textoLimpo = (t: string) => t.replace(/\*/g, '');
+/** corta "a *b* c" em [{t:'a ', d:false}, {t:'b', d:true}, {t:' c', d:false}] */
+export const partes = (t: string) => t.split('*').map((p, i) => ({t: p, d: i % 2 === 1})).filter((p) => p.t.length > 0);

package/kits/cubos/elementos/index.ts

@@ -0,0 +1,15 @@
+// Tudo que o kit cubos oferece. A IA monta o vídeo combinando isto (ou escrevendo um plano pra Montagem).
+export * from './base';
+export {Fundo} from './Fundo';
+export {Camera, posCamera} from './Camera';
+export {Cena, useDuracaoCena, SOBREPOE} from './Cena';
+export {Cubo} from './Cubo';
+export {MontagemDeCubos} from './MontagemDeCubos';
+export {CuboGiratorio} from './CuboGiratorio';
+export {PlacaBloco} from './PlacaBloco';
+export {TorreDeCubos} from './TorreDeCubos';
+export {AssinaturaMarca} from './AssinaturaMarca';
+export {Efeito, Trilha, SONS} from './Som';
+export type {NomeSom} from './Som';
+export {Montagem, ELEMENTOS} from './Montagem';
+export type {Plano, CenaPlano, Camada} from './Montagem';

package/kits/cubos/exemplos/logo-encaixa.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 200"><rect width="200" height="200" fill="#FFC21A"/><rect x="40" y="90" width="64" height="64" rx="8" fill="#1B1D22"/><rect x="96" y="46" width="64" height="64" rx="8" fill="#FF5B3A"/><circle cx="128" cy="78" r="12" fill="#F7F7F5"/></svg>

package/kits/cubos/exemplos/plano.json

@@ -0,0 +1,45 @@
+{
+  "kit": "cubos",
+  "roteiro": "exemplos/roteiro.md",
+  "duracao": 240,
+  "trilha": {"volume": 0.5},
+  "cenas": [
+    {"batida": "gancho", "de": 0, "ate": 50, "entrada": "nenhuma",
+     "camadas": [
+       {"elemento": "MontagemDeCubos", "props": {"layout": "piramide", "y": 640, "lado": 215, "inicio": 2, "intervalo": 2}}
+     ],
+     "socos": [32],
+     "sons": [{"som": "encaixa", "em": 8}, {"som": "encaixa", "em": 16}, {"som": "encaixa", "em": 24}, {"som": "queda", "em": 34}]},
+    {"batida": "virada", "de": 50, "ate": 100, "entrada": "zoom",
+     "camadas": [
+       {"elemento": "CuboGiratorio", "props": {"palavras": ["ENCAIXA", "MONTA", "REPETE", "ENCAIXA"], "y": 700, "lado": 560, "inicio": 0, "passo": 18}}
+     ],
+     "socos": [16, 34],
+     "sons": [{"som": "whoosh", "em": -1}, {"som": "gira", "em": 16}, {"som": "gira", "em": 34}, {"som": "queda", "em": 18}]},
+    {"batida": "prova", "de": 100, "ate": 134, "entrada": "subir",
+     "camadas": [
+       {"elemento": "TorreDeCubos", "props": {"quantidade": 5, "base": 1120, "lado": 170, "inicio": 0, "intervalo": 5, "rotulo": "x5"}}
+     ],
+     "socos": [24],
+     "sons": [{"som": "estala", "em": 3}, {"som": "estala", "em": 8}, {"som": "estala", "em": 13}, {"som": "estala", "em": 18}, {"som": "bloco", "em": 24}]},
+    {"batida": "prova", "de": 134, "ate": 168, "entrada": "direita",
+     "camadas": [
+       {"elemento": "MontagemDeCubos", "props": {"layout": "parede", "y": 700, "lado": 215, "inicio": 0, "intervalo": 1, "desmonta": 18}}
+     ],
+     "socos": [18],
+     "sons": [{"som": "encaixa", "em": 6}, {"som": "desmonta", "em": 17}]},
+    {"batida": "data", "de": 168, "ate": 206, "entrada": "zoom",
+     "camadas": [
+       {"elemento": "PlacaBloco", "props": {"texto": "8 DE", "y": 640, "tamanho": 220, "cor": "#FFC21A", "inicio": 2, "de": "esquerda"}},
+       {"elemento": "PlacaBloco", "props": {"texto": "DEZEMBRO", "y": 940, "tamanho": 130, "cor": "#3D8BFF", "inicio": 10, "de": "direita", "rot": 3}}
+     ],
+     "socos": [16, 24],
+     "sons": [{"som": "bloco", "em": 14}, {"som": "queda", "em": 24}]},
+    {"batida": "marca", "de": 206, "ate": 240, "entrada": "zoom",
+     "camadas": [
+       {"elemento": "AssinaturaMarca", "props": {"logo": "logo-encaixa.svg", "nome": "encaixa", "endereco": "encaixa.exemplo", "inicio": 0}}
+     ],
+     "socos": [18],
+     "sons": [{"som": "queda", "em": 17}, {"som": "assinatura", "em": 14}, {"som": "bloco", "em": 24}]}
+  ]
+}

package/kits/cubos/exemplos/roteiro.md

@@ -0,0 +1,20 @@
+# Roteiro de demonstração · "Encaixa" (blocos fictícios)
+
+Pedido: *"um reels de 8 s anunciando o Encaixa, blocos magnéticos de montar, 3 modelos, lançamento dia 8 de dezembro. Estilo cubos modulares."*
+
+Sem narração: os cortes seguem a trilha (1 batida = 16.667 quadros).
+
+| # | batida | tempo (quadros) | na tela | elemento | som |
+|---|---|---|---|---|---|
+| 1 | gancho | 0–50 | pirâmide de 14 cubos se monta | MontagemDeCubos | encaixa ×3, queda |
+| 2 | virada | 50–100 | cubo vira: ENCAIXA · MONTA · REPETE · ENCAIXA | CuboGiratorio | whoosh, gira ×2, queda |
+| 3 | prova | 100–134 | torre de 5 cubos + placa "3 modelos" | TorreDeCubos + PlacaBloco | estala ×5, bloco |
+| 4 | prova | 134–168 | parede monta e desmonta | MontagemDeCubos | encaixa, desmonta |
+| 5 | data | 168–206 | placas "8 DE" e "DEZEMBRO" | PlacaBloco ×2 | bloco, queda |
+| 6 | marca | 206–240 | cubo com logo + "encaixa" + "encaixa.exemplo" | AssinaturaMarca | queda, assinatura, bloco |
+
+Como a IA chegou nisso:
+1. Cortou o pedido em: montar, nome, quantidade, modelos, data.
+2. Pegou as batidas obrigatórias e deu um herói 3D diferente a cada uma (pirâmide, cubo giratório, torre, parede).
+3. Deixou só um apoio por cena e uma pausa depois de cada encaixe final.
+4. Escreveu `plano.json`; o `preview.tsx` passa o plano para `Montagem`.

package/kits/cubos/preview.tsx

@@ -0,0 +1,12 @@
+// Preview do kit: o vídeo de demonstração (8 s) montado SÓ com os elementos do kit, a partir de exemplos/plano.json.
+// O estúdio registra isto como `Kit-cubos`.
+import React from 'react';
+import {Montagem, Plano} from './elementos';
+import plano from './exemplos/plano.json';
+import l0 from './exemplos/logo-encaixa.svg';
+
+const arquivos: Record<string, string> = {'logo-encaixa.svg': l0};
+
+const Preview: React.FC = () => <Montagem plano={plano as Plano} arquivos={arquivos} />;
+
+export const preview = {duracaoEmQuadros: plano.duracao, quadroCapa: 45, Componente: Preview};

package/kits/cubos/receita.json

@@ -0,0 +1,151 @@
+{
+  "kit": "cubos",
+  "fps": 30,
+  "batida_trilha_quadros": 16.667,
+  "duracao_video_s": [
+    6,
+    45
+  ],
+  "ordem_sugerida": [
+    "gancho",
+    "virada",
+    "prova",
+    "data",
+    "marca"
+  ],
+  "batidas": [
+    {
+      "nome": "gancho",
+      "obrigatoria": true,
+      "duracao": [
+        40,
+        60
+      ],
+      "elementos": [
+        "MontagemDeCubos"
+      ],
+      "entrada": [
+        "nenhuma"
+      ],
+      "sons": [
+        "encaixa",
+        "queda"
+      ],
+      "nota": "herói: pirâmide de cubos se montando, o último encaixe é o soco."
+    },
+    {
+      "nome": "virada",
+      "obrigatoria": true,
+      "duracao": [
+        45,
+        66
+      ],
+      "elementos": [
+        "CuboGiratorio"
+      ],
+      "entrada": [
+        "zoom"
+      ],
+      "sons": [
+        "whoosh",
+        "gira",
+        "gira",
+        "queda"
+      ],
+      "nota": "o cubo gigante mostra 3–4 palavras, uma por face; a última é o nome do produto."
+    },
+    {
+      "nome": "prova",
+      "obrigatoria": true,
+      "duracao": [
+        36,
+        54
+      ],
+      "elementos": [
+        "TorreDeCubos",
+        "MontagemDeCubos",
+        "PlacaBloco"
+      ],
+      "entrada": [
+        "subir",
+        "direita"
+      ],
+      "sons": [
+        "estala",
+        "bloco",
+        "desmonta"
+      ],
+      "nota": "uma torre com número, ou uma parede que se desmonta; no máximo uma placa de apoio."
+    },
+    {
+      "nome": "data",
+      "obrigatoria": false,
+      "duracao": [
+        36,
+        54
+      ],
+      "elementos": [
+        "PlacaBloco"
+      ],
+      "entrada": [
+        "zoom"
+      ],
+      "sons": [
+        "bloco",
+        "queda"
+      ],
+      "nota": "duas placas empilhadas: dia e mês."
+    },
+    {
+      "nome": "marca",
+      "obrigatoria": true,
+      "duracao": [
+        48,
+        90
+      ],
+      "elementos": [
+        "AssinaturaMarca"
+      ],
+      "entrada": [
+        "zoom"
+      ],
+      "sons": [
+        "queda",
+        "assinatura",
+        "bloco"
+      ],
+      "nota": "sempre a última. O cubo do logo cai e gira."
+    }
+  ],
+  "transicoes": [
+    {
+      "nome": "zoom",
+      "quadros": 12,
+      "como": "entra de 1,9x para 1 com desfoque 6 px; a anterior encolhe"
+    },
+    {
+      "nome": "subir",
+      "quadros": 12,
+      "como": "entra 300 px de baixo"
+    },
+    {
+      "nome": "direita",
+      "quadros": 12,
+      "como": "entra 800 px da direita"
+    },
+    {
+      "nome": "nenhuma",
+      "quadros": 0,
+      "como": "só a primeira cena"
+    }
+  ],
+  "camera": {
+    "deriva": "sempre, e a cena 3D orbita ±12°",
+    "socos": "o último cubo que encaixa, o cubo que para de girar"
+  },
+  "trilha": {
+    "arquivo": "assets/trilha/calma-com-punch-108bpm.mp3",
+    "volume": 0.5,
+    "com_narracao": 0.25
+  }
+}

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

@@ -0,0 +1,18 @@
+# Área segura (9:16, 1080×1920)
+
+- Tudo que se lê fica entre **y = 168** e **y = 1330** e entre **x = 96** e **x = 984** (888 px úteis).
+- Embaixo de 1330 px ficam a legenda e os botões do Reels/TikTok: ali só fundo e o que sangra.
+- Respiro: 35–45% do quadro livre, 1 herói + no máximo 1 apoio por cena, nada encostando na borda, pausa de 15–24 quadros depois de cada impacto.
+- Posições de referência (centro da linha, em px):
+
+| uso | y |
+|---|---|
+| herói 3D (centro) | 700 |
+| cubo giratório (centro) | 700 |
+| base da pilha | 1000 |
+| placa de apoio | 1140–1200 |
+| logo na assinatura (centro) | 620 |
+| nome | 1000 |
+| endereço | 1160 |
+
+- Só o chão e a grade sangram; as peças ficam dentro das margens de 96 px.

package/kits/cubos/regras/cor.md

@@ -0,0 +1,23 @@
+# Cor
+
+| token | hex | uso |
+|---|---|---|
+| `chao` | #E6E9EE | chão (cinza-azulado claro) |
+| `linha` | #D2D7E0 | grade isométrica |
+| `tinta` | #1B1D22 | texto e cubo preto |
+| `tomate` | #FF5B3A | peça 1 |
+| `sol` | #FFC21A | peça 2 |
+| `ceu` | #3D8BFF | peça 3 |
+| `osso` | #F7F7F5 | peça clara e texto sobre cor escura |
+
+## Degradês e sombras
+
+- Faces do cubo (multiplicadores da cor-base): topo ×1,12 · frente ×1,00 · esquerda ×0,90 · direita ×0,78 · fundo ×0,66 · base ×0,55.
+- Pino no topo: círculo de 38% do lado, ×1,2 da cor-base, borda ×0,9.
+- Borda de encaixe: `rgba(255,255,255,.28)` de 4 px em cada face.
+- Extrusão da placa: 18 sombras sólidas de 1 px na cor-base ×0,62 (diagonal 1,1).
+- Grade isométrica: linhas de 2 px `#D2D7E0` a ±30° com passo de 120 px, andando 0,25 px/quadro.
+
+## O que o cliente pode trocar
+
+As 3 cores de peça (tomate, sol, céu) podem ser as da marca; preto, osso e o cinza do chão ficam.

package/kits/cubos/regras/movimento.md

@@ -0,0 +1,17 @@
+# Movimento
+
+Curva padrão: `ob(t, 1,8)` (overshoot ~8%) para encaixes e `e5(t) = 1 − (1 − t)^5` para voos de saída.
+
+| movimento | duração | valores |
+|---|---|---|
+| cubo cai e encaixa | 18 quadros | cai 900 px girando rotateX 180° → 0 com overshoot 1,8; 5 quadros de intervalo entre cubos |
+| cubos se desmontam | 20 quadros | cada peça voa 420–900 px para fora girando 270°, some nos últimos 6 |
+| cubo gigante vira | 16 + 18 quadros | gira 90° com overshoot 1,8 e fica 18 quadros parado |
+| placa estala | 14 quadros | desliza 700 px, bate com overshoot 1,8 e a extrusão afunda 6 px por 3 quadros |
+| órbita da cena | contínuo | rotateY −34° ± 12° (período 190 quadros) + 0,15°/quadro, rotateX −26° |
+| pilha cresce | 12 quadros por cubo | cada cubo cai de 700 px com overshoot, um a cada 7 quadros |
+| entrada de cena | 12 quadros | `zoom` 1,9× · `subir` 300 px · `direita` 800 px; desfoque 6 px |
+| câmera (sempre) | contínuo | zoom 1,02 + 0,00015/quadro ± 0,012; soco +0,03 |
+
+- Pausa de 15–24 quadros depois do último cubo encaixar (só a órbita se mexe).
+- Uma peça por vez: o próximo cubo só cai quando o anterior já encaixou (≥ 5 quadros).

package/kits/cubos/regras/ritmo.md

@@ -0,0 +1,14 @@
+# Ritmo
+
+- 30 fps. Uma batida da trilha = **16.667 quadros** (108 bpm). Cortes em múltiplos de 16,7 (arredonde): 0, 17, 33, 50, 67, 83, 100, 117, 133, 150, 167, 183, 200, 217, 233.
+
+| batida | duração (s) | quadros |
+|---|---|---|
+| gancho | 1,3–2,0 | 40–60 |
+| virada | 1,5–2,2 | 45–66 |
+| prova (cada) | 1,2–1,8 | 36–54 |
+| data | 1,2–1,8 | 36–54 |
+| marca | 1,6–3,0 | 48–90 |
+
+- Preview do kit: 8 s, 6 cenas.
+- Leitura: uma palavra de cubo precisa de **≥ 18 quadros** parada; uma placa, **≥ 24**.

package/kits/cubos/regras/som.md

@@ -0,0 +1,20 @@
+# Som
+
+- Trilha: `assets/trilha/calma-com-punch-108bpm.mp3` (8,6 s, 108 bpm), volume **0.5**, fade de saída nos últimos **20 quadros**. Vídeo maior que 8,6 s: gere uma trilha nova no MotionCraft (`music make`, preset `calm-punch`, 108 bpm, tom A), não faça loop deste trecho.
+- Com narração: trilha a **0.25** e efeitos a 70% do volume da tabela.
+- Efeitos (todos sintetizados) e volume padrão:
+
+| som | volume | quando |
+|---|---|---|
+| `encaixa` | 1.0 | cubo que encaixa no lugar |
+| `bloco` | 0.85 | peça pequena ou placa que estala |
+| `queda` | 0.8 | o último cubo / a peça grande |
+| `whoosh` | 0.85 | entrada de cena |
+| `gira` | 0.75 | cubo gigante que vira de face |
+| `estala` | 0.7 | cada cubo da pilha |
+| `desmonta` | 0.8 | peças voando pra fora |
+| `assinatura` | 0.9 | revelação da marca |
+
+- Um som por movimento que importa; no máximo **3 sons por segundo**; nunca o mesmo arquivo duas vezes seguidas.
+- Som entra **1 a 2 quadros antes** do visual.
+- O render nivela o mix em **−14 LUFS**, pico −1,5 dBTP.

package/kits/cubos/regras/tipografia.md

@@ -0,0 +1,15 @@
+# Tipografia
+
+Duas fontes: **Archivo Black** (peso único, gorda) para tudo que é grande e **DM Sans 700** para detalhe.
+
+| papel | fonte | peso | tamanho (px) | máx. caracteres |
+|---|---|---|---|---|
+| palavra de cubo (hero) | Archivo Black | 400 | 110–150 | 9 |
+| placa extrudada | Archivo Black | 400 | 96–150 | 14 |
+| número da pilha | Archivo Black | 400 | 90–120 | 5 |
+| detalhe / endereço | DM Sans | 700 | 48–56 | 30 |
+
+- Tracking: 0 no Archivo; 0,01 em no DM Sans.
+- Line-height: 1,0 na placa; 1,2 no detalhe.
+- Caixa: caixa-alta em cubo e placa; frase normal no detalhe.
+- Texto que cresce encolhe sozinho (`caber()` em `base.ts`) até caber em 920 px; nunca palavra cortada.

package/kits/dashboard-dados/SKILL.md

@@ -0,0 +1,51 @@
+---
+slug: dashboard-dados
+nome: Painel de dados
+descricao: azul-marinho profundo, gráficos planos e saturados que crescem, números gigantes que contam
+familia: SaaS e tecnologia
+versao: 1
+quando:
+  - "vídeo de relatório, resultado do mês ou painel de métricas"
+  - "mostrar crescimento com números e gráficos"
+  - "anúncio de ferramenta de analytics, BI ou financeiro"
+  - "prova de resultado com um número grande"
+  - "resumo de ano ou retrospectiva em dados"
+nao_serve:
+  - "vídeo sem nenhum número ou dado"
+  - "clima editorial, calmo, em papel (use notion-editorial)"
+---
+
+# Painel de dados
+
+Fundo **azul-marinho profundo** (`#0C1224`) com linhas de eixo finas que sobem devagar como a régua de um gráfico. Os heróis são **dados desenhados em cores chapadas e saturadas** (laranja `#FF8A3D`, turquesa `#35D6C0`, rosa `#FF5C8A`, amarelo `#FFD23F`): um **KPI de 380 px** que conta, **colunas que crescem com overshoot**, **rosca que se desenha fatia a fatia**, **ranking de barras horizontais** e **linha de tendência** com ponto final etiquetado. Tudo **alinhado à esquerda** (x = 96), como num painel, em **Montserrat 800**. A cor laranja marca sempre a barra/fatia/ponto que importa; o resto é turquesa. Um herói por cena e muito vazio ao redor.
+
+## Como montar um vídeo com este kit
+
+1. **Leia o pedido e o roteiro.** Corte cada fala em frases curtas. Uma frase = um plano.
+2. **Escolha as batidas** em `receita.json`. Cada batida diz quanto dura e quais elementos servem.
+3. **Escreva o plano de cenas** (`plano.json`, mesmo formato de `exemplos/plano.json`): `de`/`ate` em quadros, `entrada`, `camadas` (elemento + props) e `sons`. Os cortes seguem a voz ou a batida da trilha (1 batida = 14.75 quadros).
+4. **Renderize** com `<Montagem plano={...} arquivos={...} />`.
+5. **Confira** um quadro por cena contra `regras/`: área segura, herói grande, nada parado, nada cortado.
+
+## Elementos
+
+| elemento | o que faz | batidas |
+|---|---|---|
+| `NumeroGigante` | KPI de até 380 px contando, rótulo mono e selo de variação | kpi |
+| `BarrasCrescendo` | colunas que crescem da base com overshoot, números contando, a destacada em laranja | barras |
+| `RoscaDados` | rosca de 640 px com fatias que se desenham em sequência + legenda | rosca |
+| `RankingBarras` | barras horizontais ordenadas que deslizam, valor contando | ranking |
+| `LinhaTendencia` | linha que se desenha, pontos que estalam, etiqueta no último | tendencia |
+| `AssinaturaMarca` | logo + nome + fio laranja + endereço, à esquerda | marca (última) |
+| `Fundo`, `Camera`, `Cena` | o chão, a deriva da câmera e a janela de cada plano | todas |
+| `Efeito`, `Trilha` | sons e trilha do kit | todas |
+
+## Proibido
+
+- Fundo claro ou cartões brancos (isso é stripe-ondas) e janela de app (isso é saas-linear).
+- Mais de 4 cores de dado; laranja só no que importa.
+- Gráfico sem número: todo dado mostra o valor contando.
+- Dado inventado fora de ordem de grandeza razoável; sempre rotule a unidade.
+- Mais de um herói por cena; elemento a menos de 96 px da borda.
+- Brilho/glow, flash branco, 3D.
+- Texto fora da área segura (168–1330 px, 96 px nas laterais).

package/kits/dashboard-dados/assets/ASSETS.md

@@ -0,0 +1,18 @@
+# Assets do kit dashboard-dados
+
+| arquivo | o que é | origem | licença |
+|---|---|---|---|
+| `fontes/montserrat.woff2` | Montserrat (subset latino) | Google Fonts, baixado em 26/10/2026 | SIL OFL 1.1 — texto em `fontes/OFL-Montserrat.txt` |
+| `fontes/plex-mono.woff2` | IBM Plex Mono (subset latino) | Google Fonts, baixado em 26/10/2026 | SIL OFL 1.1 — texto em `fontes/OFL-IBM-Plex-Mono.txt` |
+| `sons/whoosh-entra.mp3` | efeito `whoosh_in` | sintetizado: MotionCraft `sfx make`, pacote do kit | sem samples; síntese própria (CC0) |
+| `sons/whoosh-sai.mp3` | efeito `whoosh_out` | sintetizado: MotionCraft `sfx make`, pacote do kit | sem samples; síntese própria (CC0) |
+| `sons/swoosh.mp3` | efeito `swoosh` | sintetizado: MotionCraft `sfx make`, pacote do kit | sem samples; síntese própria (CC0) |
+| `sons/pop-palavra.mp3` | efeito `word_pop` | sintetizado: MotionCraft `sfx make`, pacote do kit | sem samples; síntese própria (CC0) |
+| `sons/pop-cartao.mp3` | efeito `icon_pop` | sintetizado: MotionCraft `sfx make`, pacote do kit | sem samples; síntese própria (CC0) |
+| `sons/clique.mp3` | efeito `button` | sintetizado: MotionCraft `sfx make`, pacote do kit | sem samples; síntese própria (CC0) |
+| `sons/impacto.mp3` | efeito `impact` | sintetizado: MotionCraft `sfx make`, pacote do kit | sem samples; síntese própria (CC0) |
+| `sons/subida.mp3` | efeito `riser` | sintetizado: MotionCraft `sfx make`, pacote do kit | sem samples; síntese própria (CC0) |
+| `sons/assinatura.mp3` | efeito `logo_sting` | sintetizado: MotionCraft `sfx make`, pacote do kit | sem samples; síntese própria (CC0) |
+| `trilha/trilha.mp3` | 9 s de trilha | MotionCraft `music make` ({"preset": "tech-bright", "bpm": 118, "key": "G", "progression": "soft-pop", "lead": "pluck", "drums": "tight", "comp": "syncopated"}) | sem samples; síntese própria (CC0). MotionCraft é MIT |
+
+Conteúdo de demonstração (fica em `exemplos/`, não faz parte do estilo): desenhado no código ou SVG próprio, sem fotos de terceiros, a menos que listado abaixo.

package/kits/dashboard-dados/assets/fontes/OFL-IBM-Plex-Mono.txt

@@ -0,0 +1,93 @@
+Copyright IBM Corp. (https://github.com/IBM/plex)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.