primocode 10.17.0 → 10.19.0

package/kits/mapa/elementos/TituloLocal.tsx

@@ -0,0 +1,38 @@
+// TituloLocal: o nome do lugar em DM Sans 800 branco sobre o magenta, até 2 linhas, subindo de uma máscara com overshoot.
+// `*palavra*` ganha um bloco creme com letra magenta. Embaixo, uma linha de apoio e um traço de rota que se desenha.
+import React from 'react';
+import {useCurrentFrame} from 'remotion';
+import {COR, FONTE, LARGURA, MONO, caber, e5, ov, partes, seg, textoLimpo} from './base';
+
+export type TituloLocalProps = {
+  linhas: string[];
+  apoio: string;
+  inicio?: number;
+  /** centro vertical do bloco, px */
+  y: number;
+  tamanho?: number;
+  fim?: number;
+};
+
+export const TituloLocal: React.FC<TituloLocalProps> = ({linhas, apoio, inicio = 0, y, tamanho = 230, fim = 1e9}) => {
+  const f = useCurrentFrame();
+  if (f < inicio - 1 || f > fim + 12) return null;
+  const tam = Math.min(...linhas.map((l) => caber(textoLimpo(l), tamanho, 880, 800, -0.04, 'MP DM Sans')));
+  const alt = tam * 1.12, topo = y - (linhas.length * alt) / 2, sai = e5(seg(f, fim, fim + 10));
+  const traco = e5(seg(f, inicio + 16, inicio + 36));
+  return <div style={{position: 'absolute', inset: 0, opacity: 1 - sai, transform: `translateY(${-sai * 140}px)`}}>
+    {linhas.map((l, i) => {
+      const p = ov(seg(f, inicio + i * 6, inicio + i * 6 + 16));
+      return <div key={i} style={{position: 'absolute', left: 0, width: LARGURA, top: topo + i * alt, height: alt, overflow: 'hidden', textAlign: 'center'}}>
+        <div style={{transform: `translateY(${(1 - p) * 115}%)`, fontFamily: FONTE, fontWeight: 800, fontSize: tam, lineHeight: `${alt}px`, color: '#fff', letterSpacing: '-0.04em', whiteSpace: 'nowrap'}}>
+          {partes(l).map((s, k) => s.d ? <span key={k} style={{background: COR.creme, color: COR.magenta, borderRadius: tam * 0.14, padding: `0 ${tam * 0.1}px`}}>{s.t}</span> : <span key={k}>{s.t}</span>)}
+        </div>
+      </div>;
+    })}
+    <svg width={720} height={80} viewBox="0 0 720 80" style={{position: 'absolute', left: 180, top: topo + linhas.length * alt + 20}}>
+      <path d="M10 60 L10 20 L360 20 L360 60 L710 60" pathLength={1} fill="none" stroke={COR.creme} strokeWidth={14} strokeLinecap="round" strokeLinejoin="round" strokeDasharray={1} strokeDashoffset={1 - traco} />
+      <circle cx={10} cy={60} r={12} fill={COR.creme} /><circle cx={710} cy={60} r={12} fill={COR.creme} opacity={traco > 0.98 ? 1 : 0} />
+    </svg>
+    <div style={{position: 'absolute', left: 0, width: LARGURA, top: topo + linhas.length * alt + 120, textAlign: 'center', fontFamily: MONO, fontWeight: 500, fontSize: 48, color: '#fff', opacity: 0.9 * seg(f, inicio + 20, inicio + 32), transform: `translateY(${(1 - ov(seg(f, inicio + 20, inicio + 36))) * 50}px)`}}>{apoio}</div>
+  </div>;
+};

package/kits/mapa/elementos/base.ts

@@ -0,0 +1,89 @@
+// Base do kit mapa: 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 fonte0Url from '../assets/fontes/dmsans.woff2';
+import fonte1Url from '../assets/fontes/dmmono.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: 80};
+export const LARGURA_UTIL = LARGURA - SEGURA.lado * 2; // 920 px
+
+// ---------- cor ----------
+export const COR = {
+  magenta: '#F2175B',
+  magentaEscuro: '#C70E47',
+  tinta: '#1B1F2A',
+  creme: '#FFF7EE',
+  terra: '#F3EEE3',
+  agua: '#BFE3F2',
+  parque: '#CFE8BB',
+  rua: '#FFFFFF',
+  ruaBorda: '#E2DACA',
+  avenida: '#FFE7A0',
+  avenidaBorda: '#E8CE84'
+};
+
+
+// ---------- fonte ----------
+// Nome de família com o prefixo do kit, pra não colidir com outro kit no mesmo estúdio.
+export const FONTE = "\"MP DM Sans\", system-ui, sans-serif";
+export const MONO = "\"MP DM Mono\", ui-monospace, Menlo, monospace";
+const fontes = [
+  {nome: 'MP DM Sans', url: fonte0Url, peso: '500 800', estilo: 'normal'},
+  {nome: 'MP DM Mono', url: fonte1Url, peso: '500', estilo: 'normal'},
+];
+if (typeof document !== 'undefined' && !(globalThis as Record<string, unknown>).__mapa) {
+  (globalThis as Record<string, unknown>).__mapa = true;
+  for (const f of fontes) {
+    const h = delayRender('mapa: ' + f.nome);
+    new FontFace(f.nome, `url(${f.url}) format('woff2')`, {weight: f.peso, style: f.estilo}).load()
+      .then((ff) => {document.fonts.add(ff); continueRender(h);})
+      .catch(() => continueRender(h));
+  }
+}
+
+// ---------- 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, parecida com cubic-bezier(.2,.8,.2,1) */
+export const e5 = (t: number) => 1 - Math.pow(1 - c01(t), 5);
+/** pouso com overshoot (passa 1.1x e volta), toda entrada usa esta */
+export const ov = (t: number) => { const x = c01(t) - 1; const k = 2.2; return 1 + (k + 1) * x * x * x + k * x * x; };
+export const lerp = (a: number, b: number, t: number) => a + (b - a) * t;
+/** uma batida da trilha do kit (100 bpm) em quadros */
+export const BATIDA = 18.0;
+
+// ---------- medida de texto ----------
+// Mede com canvas (só guarda no cache depois que a fonte carregou) pra encolher a linha que passaria
+// da largura útil. Nunca deixa palavra cortada.
+let canvas: HTMLCanvasElement | null = null;
+const cache = new Map<string, number>();
+export const larguraTexto = (texto: string, tamanho: number, peso = 800, trackingEm = -0.03, familia = 'MP DM Sans'): number => {
+  const chave = `${texto}|${tamanho}|${peso}|${trackingEm}|${familia}`;
+  const c = cache.get(chave); if (c !== undefined) return c;
+  if (typeof document === 'undefined') return texto.length * tamanho * 0.56;
+  canvas = canvas || document.createElement('canvas');
+  const ctx = canvas.getContext('2d'); if (!ctx) return texto.length * tamanho * 0.56;
+  const fonte = `${peso} ${tamanho}px "${familia}"`;
+  ctx.font = fonte;
+  const w = ctx.measureText(texto).width + texto.length * trackingEm * tamanho;
+  if (document.fonts.check(fonte)) cache.set(chave, w);
+  return w;
+};
+/** o maior tamanho até `tamanho` em que o texto cabe em `largura` */
+export const caber = (texto: string, tamanho: number, largura = LARGURA_UTIL, peso = 800, trackingEm = -0.03, familia = 'MP DM Sans') => {
+  const w = larguraTexto(texto, tamanho, peso, trackingEm, familia);
+  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, '');
+/** quebra "a *b* c" em partes {t, d}: d = destaque */
+export const partes = (t: string) => t.split(/(\*[^*]+\*)/).filter(Boolean).map((s) => s.startsWith('*') ? {t: s.slice(1, -1), d: true} : {t: s, d: false});
+import React from 'react';
+/** escala do mapa na tela (px por unidade do mapa); os pinos e rótulos se contra-escalam com isto */
+export const MapaCtx = React.createContext<{s: number} | null>(null);
+/** valores de uma lista de chaves [[quadro, v1, v2...], ...] no quadro f, com pouso suave entre as chaves */
+export const chavesN = (f: number, ks: number[][]): number[] => { if (f <= ks[0][0]) return ks[0].slice(1); for (let i = 1; i < ks.length; i++) if (f <= ks[i][0]) { const t = e5(seg(f, ks[i - 1][0], ks[i][0])); return ks[i].slice(1).map((v, j) => lerp(ks[i - 1][j + 1] ?? 0, v, t)); } return ks[ks.length - 1].slice(1); };

package/kits/mapa/elementos/index.ts

@@ -0,0 +1,15 @@
+// Tudo que o kit mapa 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 {MapaBase} from './MapaBase';
+export {Pino} from './Pino';
+export {RotaAnimada} from './RotaAnimada';
+export {ChipTempo} from './ChipTempo';
+export {CartaoEndereco} from './CartaoEndereco';
+export {TituloLocal} from './TituloLocal';
+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/mapa/exemplos/plano.json

@@ -0,0 +1,48 @@
+{
+  "kit": "mapa",
+  "roteiro": "exemplos/roteiro.md",
+  "duracao": 240,
+  "trilha": {"volume": 0.45},
+  "cenas": [
+    {
+      "batida": "mapa", "de": 0, "ate": 52, "entrada": "nenhuma",
+      "camadas": [
+        {"elemento": "MapaBase", "props": {"foco": [[0, 1000, 1200, 0.95, 0], [52, 930, 1300, 1.7, 0]], "pinos": [{"x": 930, "y": 1330, "tamanho": 200, "inicio": 16}], "inicio": 0, "y": 780, "altura": 1100}}
+      ],
+      "socos": [16],
+      "sons": [{"som": "whoosh-entra", "em": 0}, {"som": "quique", "em": 20}, {"som": "pop-cartao", "em": 24}]
+    },
+    {
+      "batida": "rota", "de": 52, "ate": 116, "entrada": "deslizar",
+      "camadas": [
+        {"elemento": "MapaBase", "props": {"foco": [[0, 670, 1000, 1.5, 0], [24, 670, 920, 1.4, 0], [60, 700, 1000, 1.7, -4]], "rotas": [{"pontos": [[410, 600], [410, 1080], [930, 1080], [930, 1330]], "inicio": 6, "duracao": 36}], "pinos": [{"x": 930, "y": 1330, "tamanho": 190, "inicio": 0}], "chips": [{"texto": "6 min a pé", "x": 670, "y": 1005, "inicio": 30}], "inicio": 0, "y": 780, "altura": 1100}}
+      ],
+      "socos": [10, 40],
+      "sons": [{"som": "swoosh", "em": -1}, {"som": "traco", "em": 6}, {"som": "pop-cartao", "em": 32}, {"som": "clique", "em": 44}]
+    },
+    {
+      "batida": "unidades", "de": 116, "ate": 168, "entrada": "baixo",
+      "camadas": [
+        {"elemento": "MapaBase", "props": {"foco": [[0, 1000, 1250, 0.85, -14], [52, 1000, 1250, 1.0, -8]], "pinos": [{"x": 930, "y": 1330, "tamanho": 180, "inicio": 4, "miolo": "1"}, {"x": 560, "y": 760, "tamanho": 180, "inicio": 14, "miolo": "2"}, {"x": 1450, "y": 1530, "tamanho": 180, "inicio": 24, "miolo": "3"}], "inicio": 0, "y": 780, "altura": 1100}}
+      ],
+      "socos": [8, 18, 28],
+      "sons": [{"som": "whoosh-entra", "em": -1}, {"som": "quique", "em": 10}, {"som": "pop-cartao", "em": 20}, {"som": "quique", "em": 30}]
+    },
+    {
+      "batida": "endereco", "de": 168, "ate": 212, "entrada": "direita",
+      "camadas": [
+        {"elemento": "CartaoEndereco", "props": {"nome": "Café Rota", "endereco": "Rua das Flores, 120", "detalhe": "Abre às 8h · 6 min a pé", "botao": "Como chegar", "inicio": 2, "clica": 30, "y": 760}}
+      ],
+      "socos": [30],
+      "sons": [{"som": "swoosh", "em": -1}, {"som": "pop-cartao", "em": 10}, {"som": "clique", "em": 30}]
+    },
+    {
+      "batida": "marca", "de": 212, "ate": 240, "entrada": "circulo",
+      "camadas": [
+        {"elemento": "TituloLocal", "props": {"linhas": ["Café", "*Rota*"], "apoio": "Rua das Flores, 120", "inicio": 2, "y": 740, "tamanho": 260}}
+      ],
+      "socos": [12],
+      "sons": [{"som": "whoosh-entra", "em": -1}, {"som": "impacto", "em": 12}, {"som": "assinatura", "em": 14}]
+    }
+  ]
+}

package/kits/mapa/exemplos/roteiro.md

@@ -0,0 +1,19 @@
+# Roteiro de demonstração · "Café Rota" (cafeteria fictícia)
+
+Pedido: *"um reels de 8 s do Café Rota: mostrar onde fica, a rota de 6 minutos a pé do metrô, as 3 unidades, o endereço Rua das Flores, 120 com botão 'Como chegar' e fechar com o nome."*
+
+Sem narração: os cortes seguem a trilha (1 batida = 18 quadros).
+
+| # | batida | quadros | na tela | elemento | som |
+|---|---|---|---|---|---|
+| 1 | mapa | 0–52 | mapa amplo descendo até o pino, que cai e quica | MapaBase + Pino | whoosh, quique, pop |
+| 2 | rota | 52–116 | rota do metrô até o café traçada, chip "6 min a pé" | MapaBase + RotaAnimada, ChipTempo | swoosh, traço, pop, clique |
+| 3 | unidades | 116–168 | mapa girado com 3 pinos numerados caindo | MapaBase + Pino ×3 | whoosh, quiques, pop |
+| 4 | endereco | 168–212 | cartão "Café Rota · Rua das Flores, 120 · Abre às 8h · 6 min a pé" + botão | CartaoEndereco | swoosh, pop, clique |
+| 5 | marca | 212–240 | "Café *Rota*" gigante + traço de rota | TituloLocal | whoosh, impacto, assinatura |
+
+Como a IA chegou nisso:
+1. Foi do geral ao específico: onde (mapa), como chegar (rota), quantos (unidades), o endereço exato (cartão) e a marca.
+2. Deu um herói por plano (mapa, mapa, mapa, cartão, título) e um só apoio (pino ou chip), com pausa depois de cada evento.
+3. Cortou nas batidas da trilha (0, 52, 116, 168, 212) e alternou a troca (nenhuma, deslizar, baixo, direita, círculo).
+4. O `preview.tsx` passa o plano para `Montagem`, que só usa os elementos do kit.

package/kits/mapa/preview.tsx

@@ -0,0 +1,9 @@
+// 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-mapa`.
+import React from 'react';
+import {Montagem, Plano} from './elementos';
+import plano from './exemplos/plano.json';
+
+const Preview: React.FC = () => <Montagem plano={plano as Plano} />;
+
+export const preview = {duracaoEmQuadros: plano.duracao, quadroCapa: 100, Componente: Preview};

package/kits/mapa/receita.json

@@ -0,0 +1,21 @@
+{
+  "kit": "mapa", "fps": 30, "batida_trilha_quadros": 18,
+  "duracao_video_s": [6, 30],
+  "ordem_sugerida": ["mapa", "rota", "unidades", "endereco", "marca"],
+  "batidas": [
+    {"nome": "mapa", "obrigatoria": true, "duracao": [48, 54], "elementos": ["MapaBase", "Pino"], "entrada": ["nenhuma"], "sons": ["whoosh-entra", "quique", "pop-cartao"], "nota": "vista ampla que desce até o pino; o pino cai no quadro 16."},
+    {"nome": "rota", "obrigatoria": false, "duracao": [60, 72], "elementos": ["MapaBase", "RotaAnimada", "ChipTempo", "Pino"], "entrada": ["deslizar"], "sons": ["swoosh", "traco", "pop-cartao", "clique"], "nota": "zoom 1,4–1,7 na rota; chip com o tempo acima da linha, nunca sobre ela."},
+    {"nome": "unidades", "obrigatoria": false, "duracao": [48, 54], "elementos": ["MapaBase", "Pino"], "entrada": ["baixo"], "sons": ["whoosh-entra", "quique", "pop-cartao"], "nota": "mapa girado −14° → −8°, 2–3 pinos numerados caindo a cada 10 quadros."},
+    {"nome": "endereco", "obrigatoria": true, "duracao": [42, 48], "elementos": ["CartaoEndereco"], "entrada": ["direita"], "sons": ["swoosh", "pop-cartao", "clique"], "nota": "cartão com nome, endereço, horário e botão que aperta no quadro 30."},
+    {"nome": "marca", "obrigatoria": true, "duracao": [28, 42], "elementos": ["TituloLocal"], "entrada": ["circulo"], "sons": ["whoosh-entra", "impacto", "assinatura"], "nota": "sempre a última: nome do lugar gigante em branco, 1 palavra no bloco creme."}
+  ],
+  "transicoes": [
+    {"nome": "deslizar", "quadros": 9, "como": "entra 1080 px da direita; a anterior sai 460 px para a esquerda"},
+    {"nome": "direita", "quadros": 9, "como": "igual a deslizar, vindo da direita"},
+    {"nome": "baixo", "quadros": 9, "como": "entra 900 px de baixo"},
+    {"nome": "circulo", "quadros": 9, "como": "entra com zoom 1,6× → 1"},
+    {"nome": "nenhuma", "quadros": 0, "como": "só no gancho"}
+  ],
+  "camera": {"deriva": "sempre, suave", "socos": "pino batendo, chip, botão, título"},
+  "trilha": {"arquivo": "assets/trilha/rota-100bpm.mp3", "volume": 0.45, "com_narracao": 0.2}
+}

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

@@ -0,0 +1,15 @@
+# Área segura (9:16, 1080×1920)
+
+- Todo texto lido: **y 168–1330**, **x 100–980** (margem ≥ 96 px). A janela do mapa fica em x 100–980.
+- Respiro (regra do dono): 35–45% de cada quadro vazio; 1 herói + no máximo 1 apoio.
+
+| elemento | y de referência (centro) |
+|---|---|
+| janela do mapa (880 × 1100) | 780 (ocupa 230–1330) |
+| pino (190–200 px) | dentro da janela; deixe ≥ 150 px até a borda |
+| chip de tempo | acima da rota; nunca sobre ela |
+| cartão de endereço (880 × 720) | 760 |
+| título (2 linhas, 260 px) | 740 |
+| apoio do título | ≈ 1130 (topo) |
+
+- O zoom e o giro acontecem dentro da janela (overflow cortado); a janela nunca muda de posição.

package/kits/mapa/regras/cor.md

@@ -0,0 +1,18 @@
+# Cor
+
+| token | hex | uso |
+|---|---|---|
+| `magenta` | `#F2175B` | chão (topo), rota, pino, botão |
+| `magentaEscuro` | `#C70E47` | chão (base), sombra do botão, texto do detalhe |
+| `tinta` | `#1B1F2A` | texto, chip de tempo, ponto de origem |
+| `creme` | `#FFF7EE` | contorno do pino, bloco do título |
+| `terra` | `#F3EEE3` | chão do mapa |
+| `agua` | `#BFE3F2` | rio |
+| `parque` | `#CFE8BB` | parques |
+| `rua` / `ruaBorda` | `#FFFFFF` / `#E2DACA` | ruas (30 px, borda 42 px) |
+| `avenida` / `avenidaBorda` | `#FFE7A0` / `#E8CE84` | avenidas (50 px, borda 66 px) |
+
+- Quadras: retângulos de canto 18 px em `#EAE3D3`/`#EDE6D6` alternados, 200 × 180 unidades. Rio: traço de 170 unidades com tracejado branco 50%.
+- Curvas de nível: elipses brancas, traço 4 e 8 px, opacidade ≤ 10%, centro (980, 1700), expandem 1,4 px/quadro.
+- Sombra da janela: `0 50px 90px rgba(80,0,30,.4)`; do cartão: `0 60px 100px rgba(80,0,30,.45)`.
+- O cliente pode trocar o magenta pela cor da marca (mantendo contraste com branco ≥ 3:1) e os tons do mapa por uma paleta mais fria. Proibido: degradê roxo-azul.

package/kits/mapa/regras/movimento.md

@@ -0,0 +1,21 @@
+# Movimento
+
+Curvas: `e5(t) = 1 − (1 − t)^5` e `ov(t)` = pouso com overshoot (`1 + 3,2x³ + 2,2x²`). **Toda entrada usa `ov`.** A câmera do mapa interpola cada canal com `e5` entre as chaves.
+
+| movimento | duração | valores |
+|---|---|---|
+| janela entra | 18 quadros | sobe 1100 px, gira 5° → 0, escala 0,92 → 1 |
+| câmera do mapa | 24–60 quadros por trecho | chaves [quadro, cx, cy, zoom, giro]; zoom 0,95 → 1,7; giro de 0 a −14° |
+| pino cai | 18 quadros | cai 5× a altura com overshoot; sombra cresce em 10 quadros |
+| ondas do pino | 26 quadros, 8 de defasagem | duas elipses de 0 a 0,9× a altura, somem |
+| rota | 36–40 quadros | `e5` de 0 a 100% do comprimento; bolinha na ponta |
+| chip | 14 quadros | escala 0 → 1 com overshoot, contra-escalado pelo zoom |
+| cartão entra | 18 quadros | sobe 1200 px, gira −4° → 0 |
+| botão aperta | 8 quadros | escala 0,96, desce 8 px; anel de 60 px que some em 16 quadros |
+| título | 16 quadros, 6 de intervalo | sobe 115% da altura; traço de rota se desenha em 20 quadros |
+| troca de cena | 9 quadros | `direita`/`esquerda` 1080 px, `subir` 900 px, `zoom` 1,6× |
+| curvas de nível | contínuo | 1,4 px/quadro |
+| câmera (sempre) | contínuo | zoom 1,014 ± 0,012 (+0,00012/quadro), deriva ±8/±8 px, giro ±0,17° |
+| soco de câmera | decai em ~7 quadros | +0,025 de zoom, tremor 5 px |
+
+- **Pausa**: depois do pino quicar ou do botão apertar, 15–24 quadros sem evento novo (o mapa pode continuar a se mover devagar).

package/kits/mapa/regras/ritmo.md

@@ -0,0 +1,15 @@
+# Ritmo
+
+- 100 bpm: **1 batida = 18 quadros** (0,6 s). Cortes caem a cada 2–3 batidas; a rota de 36 quadros dura 2 batidas.
+- Vídeo de 8 s = 240 quadros = 5 cenas.
+
+| batida | duração s | quadros |
+|---|---|---|
+| mapa | 1,6–1,8 | 48–54 (pino cai no quadro 16) |
+| rota | 2,0–2,4 | 60–72 (rota 36–40, chip no quadro 30) |
+| unidades | 1,6–1,8 | 48–54 (um pino a cada 10 quadros) |
+| endereco | 1,4–1,6 | 42–48 (botão no quadro 30) |
+| marca | 0,9–1,4 | 28–42 |
+
+- Leitura mínima: chip ≥ 24 quadros; endereço ≥ 30 quadros depois do cartão pousar.
+- Em cada cena: entrada → evento (pino, rota, botão) → **pausa de 15–24 quadros** → saída.

package/kits/mapa/regras/som.md

@@ -0,0 +1,21 @@
+# Som
+
+- Trilha: `assets/trilha/rota-100bpm.mp3` (8,6 s, 100 bpm, lofi-desk, tom Bb), volume **0,45**, fade nos últimos **20 quadros**. Vídeo maior: gere outra (`music make --preset lofi-desk --bpm 100 --key Bb --force`), sem loop.
+- Com narração: trilha a **0,2** e efeitos a 70%.
+
+| som | volume | quando |
+|---|---|---|
+| `quique` | 0,8 | pino bate no chão |
+| `pop-cartao` | 0,95 | pino pousa, chip, cartão |
+| `traco` | 0,55 | rota começando a se traçar |
+| `clique` | 0,85 | botão, chegada ao destino |
+| `swoosh` | 0,85 | cena que entra de lado |
+| `whoosh-entra` | 0,8 | cena sem lado (−1 quadro) |
+| `impacto` | 0,8 | título assenta |
+| `assinatura` | 0,85 | fecho, 2 quadros depois do impacto |
+| `pop-palavra` | 0,9 | opcional |
+| `subida` | 0,65 | opcional |
+| `whoosh-sai` | 0,65 | opcional |
+
+- No máximo **3 sons por segundo**; nunca o mesmo arquivo duas vezes seguidas. Som entra 1 a 2 quadros antes do visual.
+- Alvo −14 LUFS, pico −1,5 dBTP.

package/kits/mapa/regras/tipografia.md

@@ -0,0 +1,16 @@
+# Tipografia
+
+- **DM Sans 500–800** (nomes, botão, chip) · **DM Mono 500** (endereços, nomes de rua, apoio). Registradas como `"MP DM Sans"` e `"MP DM Mono"`.
+- DM Sans com tracking −0,03 a −0,04 em; sem caixa alta.
+
+| papel | fonte | tamanho px | máx. caracteres |
+|---|---|---|---|
+| título do local | DM Sans 800, branco | 260 (encolhe até 880) | 8 por linha |
+| apoio do título | DM Mono 500 | 48 | 24 |
+| nome no cartão | DM Sans 800 | 118 (até 780) | 12 |
+| endereço no cartão | DM Mono 500 | 42 | 26 |
+| detalhe (chip rosa) | DM Sans 700 | 40 | 28 |
+| botão | DM Sans 800 | 56 | 14 |
+| chip de tempo | DM Sans 800 | 54 na tela | 14 |
+| nome de rua no mapa | DM Mono 500, 55% | 30 (unidades do mapa) | 16 |
+| número no pino | DM Sans 800 | 28 (unidades do pino) | 1 |

package/kits/massinha/SKILL.md

@@ -0,0 +1,53 @@
+---
+slug: massinha
+nome: Massinha
+descricao: massinha de modelar em 3D falso: bolas, letras e bichinhos com brilho, sombra e squash & stretch, sobre tapete de corte turquesa
+familia: Feito à mão
+versao: 1
+quando:
+  - "vídeo infantil, de brinquedo, escola ou oficina de modelagem"
+  - "anúncio fofo e divertido com personagem de massinha"
+  - "lançamento de produto lúdico ou de comida"
+  - "quero cara de stop-motion, claymation, massinha 3D"
+  - "convite de festa ou evento para crianças e famílias"
+nao_serve:
+  - "clima sério, corporativo ou tecnológico (use outro kit)"
+  - "visual minimalista premium"
+  - "fotos como protagonista"
+---
+
+# Massinha
+
+Um estúdio de claymation. A mesa é um tapete de corte turquesa `#8ED6D0` com grade de 90 px e luz suave; por cima, **tudo é massinha**: cada objeto usa o sólido do kit (`argila()` em `elementos/argila.ts`): gradiente radial com brilho no alto à esquerda, sombra interna dos dois lados e sombra projetada na mesa. As letras do título têm extrusão de 14 camadas e contorno claro; as bolas, o bichinho e as cápsulas **caem, amassam no chão e esticam no ar** (squash & stretch), e tudo anda em **passos de 2 quadros** (stop-motion). Marcas de dedão nos cantos, migalhas coloridas no pé do quadro. 1 herói por plano, no máximo 1 apoio.
+
+## Como montar um vídeo com este kit
+
+1. **Leia o pedido e o roteiro.** Corte cada fala em frases curtas (1 a 4 palavras). Uma frase = uma cena de 0,6 a 1,5 s.
+2. **Escolha as batidas** em `receita.json` (gancho → prova → virada → lista → data → marca). Cada batida diz a duração e os elementos que 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`. 1 batida da trilha = 15.52 quadros.
+4. **Renderize** com `<Montagem plano={...} arquivos={...} />` ou combine `Fundo`, `Camera`, `Cena` e os elementos (tudo sai de `elementos/index.ts`).
+5. **Confira** um quadro por cena contra `regras/`: área segura, herói grande, nada parado, nada cortado.
+
+## Elementos
+
+| elemento | o que faz | batidas |
+|---|---|---|
+| `TituloMassa` | letras de massinha com extrusão, que caem, amassam e quicam uma a uma | gancho, marca |
+| `BolasMassa` | herói: 1 a 3 bolas grandes quicando fora de fase com dedada | prova |
+| `BichinhoMassa` | bichinho com olhos que piscam e olham, pula; fala em balão de massinha | virada, problema |
+| `PlacaMassa` | placa grossa com texto em relevo e tira colorida | data, oferta |
+| `ListaMassa` | cápsulas coloridas que caem e amassam | lista |
+| `FormaMassa` | estrela, coração, flor ou gota de massinha (apoio) | apoio |
+| `AssinaturaMarca` | disco branco + nome em letras + detalhe + endereço em tira | marca (sempre a última) |
+| `Fundo`, `Overlay`, `Camera`, `Cena` | tapete de corte, vinheta + migalhas, câmera, janela | todas |
+| `Efeito`, `Trilha` | sons e trilha do kit | todas |
+
+## Proibido
+
+- Objeto chapado sem brilho nem sombra: tudo passa por `argila()`.
+- Movimento liso ou sem squash: toda queda amassa e todo pulo estica.
+- Contorno preto, neon, degradê linear, blur de movimento.
+- Mais de 1 herói + 1 apoio; menos de 35% do tapete livre; margens < 96 px.
+- Cores fora da paleta de massinha; fotos reais; emoji.
+- Fontes fora de Chewy e Nunito; texto fora da área segura (168–1330 px).
+- Sem a pausa de 0,5–0,8 s depois da última queda.

package/kits/massinha/assets/ASSETS.md

@@ -0,0 +1,18 @@
+# Assets do kit massinha
+
+| arquivo | o que é | origem | licença |
+|---|---|---|---|
+| `fontes/chewy.woff2` | Chewy (título), subset latino | Google Fonts (fonts.gstatic.com), baixado em 26/10/2026 | Apache 2.0 (Chewy) — texto em `fontes/OFL-chewy.txt` |
+| `fontes/nunito-800.woff2` | Nunito (texto), subset latino | Google Fonts (fonts.gstatic.com), baixado em 26/10/2026 | SIL OFL 1.1 — texto em `fontes/OFL-nunito-800.txt` |
+| `sons/whoosh-entra.mp3` | efeito whoosh-entra | sintetizado: MotionCraft `sfx make`, tipo `whoosh_in`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/whoosh-sai.mp3` | efeito whoosh-sai | sintetizado: MotionCraft `sfx make`, tipo `whoosh_out`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/swoosh.mp3` | efeito swoosh | sintetizado: MotionCraft `sfx make`, tipo `swoosh`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/pop-palavra.mp3` | efeito pop-palavra | sintetizado: MotionCraft `sfx make`, tipo `word_pop`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/pop-cartao.mp3` | efeito pop-cartao | sintetizado: MotionCraft `sfx make`, tipo `icon_pop`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/clique.mp3` | efeito clique | sintetizado: MotionCraft `sfx make`, tipo `button`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/impacto.mp3` | efeito impacto | sintetizado: MotionCraft `sfx make`, tipo `impact`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/subida.mp3` | efeito subida | sintetizado: MotionCraft `sfx make`, tipo `riser`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/assinatura.mp3` | efeito assinatura | sintetizado: MotionCraft `sfx make`, tipo `logo_sting`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `sons/tick.mp3` | efeito tick | sintetizado: MotionCraft `sfx make`, tipo `letter_tick`, pacote `soft-pop` | sem samples; síntese própria (CC0) |
+| `trilha/trilha.mp3` | trilha de 8,7 s, 116 bpm | MotionCraft `music make --preset warm-major --bpm 116 --key F` | síntese própria (CC0); MotionCraft é MIT |
+

package/kits/massinha/assets/fontes/OFL-chewy.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Chewy Project Authors (https://github.com/rsms/inter)
+
+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.

package/kits/massinha/assets/fontes/OFL-nunito-800.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Nunito Project Authors (https://github.com/rsms/inter)
+
+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.