primocode 10.17.0 → 10.19.0

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

@@ -0,0 +1,14 @@
+# Área segura (9:16, 1080×1920)
+
+- Tudo que se lê fica entre **y = 168** e **y = 1330** e entre **x = 80** e **x = 1000** (920 px úteis). Abaixo de 1330 só fundo e o que sangra.
+- Herói com 40% ou mais da altura ou da largura; no máximo 2 apoios por cena.
+
+| uso | y de referência (px) |
+|---|---|
+| HUD | 215 |
+| título de 2 linhas (centro) | 700–760 |
+| sprite herói (centro) | 620–760 |
+| caixa de diálogo (centro) | 760 |
+| menu (centro) | 740 |
+| PRESS START | 1030–1070 |
+| endereço | 1150–1250 |

package/kits/pixel/regras/cor.md

@@ -0,0 +1,17 @@
+# Cor
+
+| token | hex | uso |
+|---|---|---|
+| `ceu` | #29ADFF | fundo |
+| `noite` | #1D2B53 | contorno, sombra dura, caixas escuras |
+| `creme` | #FFF1E8 | texto claro, miolo de caixa, nuvem |
+| `amarelo` | #FFEC27 | título principal, moeda, destaque |
+| `laranja` | #FFA300 | chão, sol |
+| `magenta` | #FF004D | seleção, nome, coração |
+| `verde` | #00E436 | grama, cartão de data |
+| `roxo` | #7E2553 | detalhe de sprite |
+| `cinza` | #83769C | sombra de sprite |
+
+- Sem degradê. Sombras são retângulos chapados de `noite` deslocados 8–10 px (`box-shadow: 10px 10px 0`).
+- Linhas finas de varredura: `rgba(29,43,83,0.06)` a cada 6 px, só no Overlay.
+- O cliente pode trocar: `amarelo` e `magenta` (cores de destaque) e o `ceu`.

package/kits/pixel/regras/movimento.md

@@ -0,0 +1,18 @@
+# Movimento
+
+- Tela 1080×1920, 30 fps. Curva padrão: `mola(t) com overshoot 2,2 (fórmula easeOutBack) em passos de 3 quadros`.
+- Passo de animação: **3 quadro(s)** por posição (movimento em passos, cara de stop-motion).
+- Câmera: zoom base 1.02, deriva ±14 px × ±10 px, giro ±0.004 rad, soco de 0.035 em cada batida (decai em 7 quadros).
+- Toda entrada passa do alvo e volta (overshoot de 2,2). Nenhum quadro parado.
+
+| movimento | quadros | valores |
+|---|---|---|
+| título cai | 10 | de −520 px com escala 1,25 até 1, mola 2,2; uma linha a cada 6 quadros |
+| sprite nasce | 9 | escala 0 → 1 com mola; depois pula: |sen(t/7,2)| × 3,2 × escala |
+| caixa de diálogo | 9 + 1 letra/1,5 q | escala 0 → 1 pela base; ▼ pisca a cada 8 quadros |
+| menu | 9 por item | entra 1100 px da esquerda, 4 quadros entre itens; seta troca a cada 10 q |
+| HUD | 9 | desce 300 px; pontos sobem em 30 quadros de 100 em 100 |
+| chuva | contínuo | velocidade 14–28 px/quadro, balanço ±30 px |
+| câmera | contínuo | zoom 1,02 ± 0,012, deriva ±14 × ±10 px, soco 0,035 |
+
+- Cena entra em 12 quadros e sobrepõe 10 com a próxima; cortes a cada 18–45 quadros.

package/kits/pixel/regras/ritmo.md

@@ -0,0 +1,15 @@
+# Ritmo
+
+- Trilha a **124 bpm**: 1 batida = **14.52 quadros** (0.48 s). Corte em múltiplos de batida (7, 15, 29 quadros).
+
+| batida | duração s | quadros |
+|---|---|---|
+| gancho | 1.3–2.5 | 40–75 |
+| virada | 1.3–3.0 | 40–90 |
+| problema | 1.3–3.3 | 40–100 |
+| lista | 1.2–2.5 | 36–75 |
+| data | 1.0–2.3 | 30–70 |
+| marca | 1.3–4.0 | 40–120 |
+
+- Tempo mínimo de leitura: 1 palavra = 8 quadros, frase de 3 palavras = 24 quadros.
+- Troca de cena a cada 0,6–1,5 s (18–45 quadros). Vídeo de 6–60 s.

package/kits/pixel/regras/som.md

@@ -0,0 +1,18 @@
+# Som
+
+- Trilha: `assets/trilha/trilha.mp3` (8,7 s, 124 bpm, preset MotionCraft `tech-bright`), volume **0,5**, fade de saída nos últimos 20 quadros. Com narração: 0,25.
+- Efeitos sintetizados (pacote `digital-soft`):
+
+| som | volume | quando |
+|---|---|---|
+| `whoosh-entra` | 0,9 | entrada de cena (−1 quadro) |
+| `pop-palavra` | 1,0 | título que cai, sprite que nasce |
+| `pop-cartao` | 0,9 | caixa/menu que abre |
+| `tick` | 0,6 | cada 2 letras do diálogo |
+| `clique` | 0,8 | seta do menu muda |
+| `impacto` | 0,9 | a palavra grande do gancho |
+| `subida` | 0,7 | 1,2 s antes do clímax |
+| `assinatura` | 0,9 | tela de título final |
+
+- No máximo **3 sons por segundo**; nunca o mesmo arquivo duas vezes seguidas.
+- Som entra **1 a 2 quadros antes** do visual. Alvo do mix: **−14 LUFS**, pico −1,5 dBTP.

package/kits/pixel/regras/tipografia.md

@@ -0,0 +1,18 @@
+# Tipografia
+
+- **título**: Press Start 2P 400 (arquivo `assets/fontes/pressstart2p.woff2`, família registrada como `PX Press Start 2P`).
+- **texto**: VT323 400 (arquivo `assets/fontes/vt323.woff2`, família registrada como `PX VT323`).
+
+| papel | tamanho px | máx. caracteres por linha | fonte |
+|---|---|---|---|
+| título gigante | 150 (2 linhas) / 130 | 6–9 | Press Start 2P |
+| título de data/oferta | 110 | 10 | Press Start 2P |
+| menu | 76 | 14 | Press Start 2P |
+| HUD (número / rótulo) | 52 / 24 | 6 / 12 | Press Start 2P |
+| diálogo | 104 | 22 por linha, 3 linhas | VT323 |
+| endereço | 84 | 18 | VT323 |
+
+- Tracking: 0 nos títulos (a fonte já é monoespaçada), 2 px no diálogo.
+- Line-height: 1.1 nos títulos, 1.02 no diálogo.
+- Caixa: TUDO EM MAIÚSCULAS (a fonte de 8 bits não tem minúscula legível em corpo grande).
+- Texto que passa da largura útil (920 px) **encolhe sozinho** (`caber()` em `base.ts`), nunca corta palavra.

package/kits/pontos-3d/SKILL.md

@@ -0,0 +1,51 @@
+---
+slug: pontos-3d
+nome: Campo de pontos
+descricao: azul-elétrico chapado, milhares de pontos brancos em 3D que viram grade, esfera, cubo e até letras, com rótulos técnicos em mono
+familia: 3D e abstrato
+versao: 1
+quando:
+  - "vídeo de produto de dados, IA, mapas ou infraestrutura"
+  - "lançamento tecnológico com número grande e contador"
+  - "reels de startup, hackathon ou palestra técnica"
+  - "abertura com cara de visualização de dados e ciência"
+  - "anúncio minimalista, sem foto, só forma e número"
+nao_serve:
+  - "vídeo caloroso, de comida, moda ou festa (use aquarela, adesivos ou ugc-reels)"
+  - "clima luxuoso ou cromado (use metal-liquido)"
+---
+
+# Campo de pontos
+
+Um azul-elétrico chapado (`#1237FF`) e **só pontos brancos**: 900 pontos em perspectiva real que formam uma **grade ondulando, uma esfera, um cubo ou um anel** e se transformam de um no outro (cada ponto sai do seu lugar com atraso próprio). Palavras também são feitas de pontos: o nome do produto se monta a partir de uma nuvem solta. Os números são contadores em JetBrains Mono, os rótulos são etiquetas técnicas com linha e anel apontando para um ponto, e os títulos são Sora 800. Uns poucos pontos laranja `#FF5A36` quebram o branco. A câmera avança devagar e a nuvem nunca para de girar.
+
+## 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 → 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 = 15 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 |
+|---|---|---|
+| `NuvemDePontos` | 900 pontos 3D em perspectiva que viram grade, esfera, cubo, anel ou onda | gancho, prova |
+| `TextoDePontos` | palavra feita de pontos que voam de uma nuvem solta até as letras | virada, marca |
+| `TituloSora` | título em Sora 800 que sobe de máscara, com cursor laranja | virada, prova, data |
+| `Contador` | número gigante em mono que conta de 0 ao valor, com legenda | prova |
+| `RotuloPonto` | etiqueta técnica em mono com linha e anel apontando para um ponto | apoio de qualquer batida |
+| `AssinaturaMarca` | logo + nome em pontos + endereço em mono | marca |
+| `Fundo`, `Camera`, `Cena` | azul-elétrico com cruzes tênues que andam na diagonal e vinheta escura | todas |
+| `Efeito`, `Trilha` | sons e trilha do kit | todas |
+
+## Proibido
+
+- Qualquer cor além de azul, branco e o laranja de destaque (máx. 1 ponto em 12 laranja).
+- Pontos menores que 5 px ou nuvem com menos de 600 pontos: ela precisa ter corpo.
+- Linhas, malhas ou conexões entre pontos: o estilo é só ponto.
+- Glow, sombra ou degradê; a profundidade vem do tamanho e da opacidade do ponto.
+- Mais de 1 herói + 1 apoio por cena; margem menor que 96 px; nuvem encostando na borda.
+- Nuvem parada: ela sempre gira (1,1°/quadro) e a câmera sempre avança.
+- Texto fora da área segura (168–1330 px na vertical, 96 px nas laterais).

package/kits/pontos-3d/assets/ASSETS.md

@@ -0,0 +1,21 @@
+# Assets do kit pontos-3d
+
+| arquivo | o que é | origem | licença |
+|---|---|---|---|
+| `fontes/sora-latin.woff2` | Sora (500 800), subset latino | Google Fonts (`fonts.googleapis.com/css2?family=Sora`), baixado em 26/10/2026 | SIL OFL 1.1, texto em `fontes/OFL-Sora.txt` |
+| `fontes/jetbrains-latin.woff2` | JetBrains Mono (500 800), subset latino | Google Fonts (`fonts.googleapis.com/css2?family=JetBrains+Mono`), baixado em 26/10/2026 | SIL OFL 1.1, texto em `fontes/OFL-JetBrainsMono.txt` |
+| `sons/tick.mp3` | ponto ou letra que se monta | sintetizado: MotionCraft `sfx make`, tipo `letter_tick`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/pop.mp3` | rótulo que aparece | sintetizado: MotionCraft `sfx make`, tipo `icon_pop`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/whoosh.mp3` | entrada de cena e troca de forma | sintetizado: MotionCraft `sfx make`, tipo `whoosh_in`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/varre.mp3` | a nuvem gira para outra forma | sintetizado: MotionCraft `sfx make`, tipo `swoosh`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/impacto.mp3` | fim da contagem e o nome do produto | sintetizado: MotionCraft `sfx make`, tipo `impact`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/subida.mp3` | durante a contagem | sintetizado: MotionCraft `sfx make`, tipo `riser`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/clique.mp3` | endereço / detalhe | sintetizado: MotionCraft `sfx make`, tipo `button`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `sons/assinatura.mp3` | revelação da marca | sintetizado: MotionCraft `sfx make`, tipo `logo_sting`, pacote `digital-soft` | sem samples; síntese própria (CC0) |
+| `trilha/tech-120bpm.mp3` | 8,6 s a partir de 2.0 s da trilha gerada | MotionCraft `music make` (preset `tech-bright`, 120 bpm, tom E) | 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/logo-malha.svg` | logo fictício desenhado para a demo | próprio |

package/kits/pontos-3d/assets/fontes/OFL-JetBrainsMono.txt

@@ -0,0 +1,92 @@
+Copyright (c) JetBrains Mono Project Authors (Google Fonts)
+
+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://openfontlicense.org
+
+-----------------------------------------------------------
+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/pontos-3d/assets/fontes/OFL-Sora.txt

@@ -0,0 +1,92 @@
+Copyright (c) Sora Project Authors (Google Fonts)
+
+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://openfontlicense.org
+
+-----------------------------------------------------------
+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/pontos-3d/elementos/AssinaturaMarca.tsx

@@ -0,0 +1,23 @@
+// AssinaturaMarca: a última cena. O logo cai com overshoot, o nome se monta em pontos e o endereço aparece em mono.
+import React from 'react';
+import {useCurrentFrame} from 'remotion';
+import {COR, FAM_B, FONTE_B, caber, ob, seg} from './base';
+import {TextoDePontos} from './TextoDePontos';
+
+export type AssinaturaMarcaProps = {
+  logo: string;
+  nome: string;
+  endereco?: string;
+  inicio?: number;
+};
+
+export const AssinaturaMarca: React.FC<AssinaturaMarcaProps> = ({logo, nome, endereco, inicio = 0}) => {
+  const f = useCurrentFrame() - inicio;
+  const lg = ob(seg(f, 0, 18), 1.9), en = seg(f, 40, 52);
+  const te = caber(endereco ?? '', 50, FAM_B, 800, 500);
+  return <>
+    <img src={logo} style={{position: 'absolute', left: 540 - 190, top: 540 - 190, width: 380, height: 380, transform: `translateY(${(1 - lg) * -300}px) scale(${lg})`, opacity: Math.min(1, lg * 2)}} />
+    <TextoDePontos texto={nome} y={930} tamanho={210} passo={11} inicio={inicio + 8} ponto={6} />
+    {endereco && <div style={{position: 'absolute', left: 0, width: 1080, top: 1130, textAlign: 'center', fontFamily: FONTE_B, fontWeight: 500, fontSize: te, color: COR.gelo, opacity: en, transform: `translateY(${(1 - en) * 24}px)`}}>{endereco}</div>}
+  </>;
+};

package/kits/pontos-3d/elementos/Camera.tsx

@@ -0,0 +1,22 @@
+// Camera: deriva constante por baixo de tudo (zoom, deslize e giro) e um soco em cada batida.
+// O quadro nunca fica parado. `batidas` são quadros absolutos do vídeo.
+import React from 'react';
+import {AbsoluteFill, useCurrentFrame} from 'remotion';
+
+export type CameraProps = {batidas?: number[]; forca?: number; children: React.ReactNode};
+
+export const posCamera = (f: number, batidas: number[], forca = 1) => {
+  let z = 1.02 + 0.012 * Math.sin(f / 100) + f * 0.0003, dx = Math.sin(f / 37) * 12, dy = Math.cos(f / 51) * 10;
+  let rot = Math.sin(f / 83) * 0.005;
+  for (const h of batidas) if (f >= h) {
+    const d = Math.exp(-(f - h) / 8) * forca;
+    z += 0.025 * d; dx += 4 * d * Math.sin((f - h) * 2.7 + h); dy += 4 * d * Math.cos((f - h) * 3.3 + h);
+    rot += 0.002 * d * Math.sin((f - h) * 1.9 + h);
+  }
+  return {z, dx, dy, rot};
+};
+
+export const Camera: React.FC<CameraProps> = ({batidas = [], forca = 1, children}) => {
+  const c = posCamera(useCurrentFrame(), batidas, forca);
+  return <AbsoluteFill style={{transform: `translate(${c.dx}px, ${c.dy}px) rotate(${c.rot}rad) scale(${c.z})`, transformOrigin: '50% 42%'}}>{children}</AbsoluteFill>;
+};

package/kits/pontos-3d/elementos/Cena.tsx

@@ -0,0 +1,48 @@
+// Cena: janela de tempo de um plano. Entra com movimento (nunca corte seco) e a saída cruza 10 quadros
+// com a entrada da próxima. Dentro dela, useCurrentFrame() começa em 0.
+import React, {createContext, useContext} from 'react';
+import {AbsoluteFill, Sequence, useCurrentFrame} from 'remotion';
+import {c01, e5, ob, seg} from './base';
+
+export type Entrada = 'subir' | 'zoom' | 'direita' | 'esquerda' | 'giro' | 'queda' | 'circulo' | 'nenhuma';
+export type Saida = 'sobe' | 'esquerda' | 'zoom' | 'gira' | 'encolhe';
+export const SOBREPOE = 10; // quadros em que a saída desta cena cruza a entrada da próxima
+export const QUADROS_ENTRADA = 14;
+
+const CenaCtx = createContext({duracao: 60});
+/** duração da cena atual em quadros (sem a sobreposição) */
+export const useDuracaoCena = () => useContext(CenaCtx).duracao;
+
+export type CenaProps = {de: number; ate: number; entrada?: Entrada; saida?: Saida; ultima?: boolean; children: React.ReactNode};
+
+const Janela: React.FC<{duracao: number; entrada: Entrada; saida: Saida; ultima: boolean; children: React.ReactNode}> = ({duracao, entrada, saida, ultima, children}) => {
+  const f = useCurrentFrame();
+  const p = seg(f, 0, QUADROS_ENTRADA);
+  const en = entrada === 'nenhuma' ? 0 : 1 - ob(p, 1.3);
+  const xo = ultima ? 0 : e5(seg(f, duracao, duracao + SOBREPOE));
+  let tf = '';
+  let clip: string | undefined;
+  if (entrada === 'subir') tf += `translateY(${en * 300}px) `;
+  if (entrada === 'queda') tf += `translateY(${-en * 520}px) `;
+  if (entrada === 'zoom') tf += `scale(${1 + en * 0.9}) `;
+  if (entrada === 'direita') tf += `translateX(${en * 800}px) `;
+  if (entrada === 'esquerda') tf += `translateX(${-en * 800}px) `;
+  if (entrada === 'giro') tf += `rotate(${-en * 16}deg) scale(${1 + en * 0.6}) `;
+  if (entrada === 'circulo') clip = `circle(${e5(p) * 1700 + 4}px at 50% 52%)`;
+  if (saida === 'sobe') tf += `translateY(${-xo * 240}px) scale(${1 + xo * 0.08})`;
+  if (saida === 'esquerda') tf += `translateX(${-xo * 820}px) rotate(${-xo * 4}deg)`;
+  if (saida === 'zoom') tf += `scale(${1 + xo * 0.9})`;
+  if (saida === 'gira') tf += `rotate(${xo * 12}deg) scale(${1 - xo * 0.25}) translateY(${xo * 300}px)`;
+  if (saida === 'encolhe') tf += `scale(${1 - xo * 0.35})`;
+  const blur = c01(en) * 10 + xo * 10;
+  return <AbsoluteFill style={{transform: tf, clipPath: clip, opacity: (1 - c01(en) * 0.85) * (1 - xo), filter: blur > 0.3 ? `blur(${blur}px)` : undefined}}>{children}</AbsoluteFill>;
+};
+
+export const Cena: React.FC<CenaProps> = ({de, ate, entrada = 'subir', saida = 'zoom', ultima = false, children}) => {
+  const duracao = ate - de;
+  return <Sequence from={de} durationInFrames={duracao + (ultima ? 0 : SOBREPOE)} layout="none">
+    <CenaCtx.Provider value={{duracao}}>
+      <Janela duracao={duracao} entrada={entrada} saida={saida} ultima={ultima}>{children}</Janela>
+    </CenaCtx.Provider>
+  </Sequence>;
+};

package/kits/pontos-3d/elementos/Contador.tsx

@@ -0,0 +1,32 @@
+// Contador: número gigante em JetBrains Mono 800 que conta de 0 ao valor (e5, 40 quadros) com dígitos tabulares,
+// e uma legenda em mono embaixo. Ponto de milhar à brasileira. Ao chegar, dá um soco de escala (o plano põe o soco de câmera).
+import React from 'react';
+import {useCurrentFrame} from 'remotion';
+import {COR, FAM_B, FONTE_B, LARGURA_UTIL, caber, e5, ob, seg} from './base';
+
+export type ContadorProps = {
+  valor: number;
+  prefixo?: string;
+  sufixo?: string;
+  legenda?: string;
+  y?: number;
+  tamanho?: number;
+  inicio?: number;
+  duracao?: number;
+};
+
+const milhar = (n: number) => Math.round(n).toString().replace(/\B(?=(\d{3})+(?!\d))/g, '.');
+
+export const Contador: React.FC<ContadorProps> = ({valor, prefixo = '', sufixo = '', legenda, y = 680, tamanho = 250, inicio = 0, duracao = 40}) => {
+  const f = useCurrentFrame();
+  if (f < inicio) return null;
+  const txtFinal = prefixo + milhar(valor) + sufixo;
+  const tam = caber(txtFinal, tamanho, FAM_B, LARGURA_UTIL, 800, -0.04);
+  const v = valor * e5(seg(f, inicio, inicio + duracao)), chegou = f - (inicio + duracao);
+  const soco = chegou >= 0 ? 1 + 0.06 * Math.exp(-chegou / 5) * Math.cos(chegou) : 1;
+  const ent = ob(seg(f, inicio, inicio + 12), 1.5);
+  return <>
+    <div style={{position: 'absolute', left: 0, width: 1080, top: y - tam * 0.65, textAlign: 'center', fontFamily: FONTE_B, fontWeight: 800, fontSize: tam, lineHeight: 1.3, letterSpacing: '-0.04em', color: COR.branco, fontVariantNumeric: 'tabular-nums', transform: `scale(${soco * ent})`, whiteSpace: 'nowrap'}}>{prefixo}{milhar(v)}{sufixo}</div>
+    {legenda && <div style={{position: 'absolute', left: 0, width: 1080, top: y + tam * 0.62, textAlign: 'center', fontFamily: FONTE_B, fontWeight: 500, fontSize: 52, color: COR.gelo, opacity: seg(f, inicio + 14, inicio + 26), transform: `translateY(${(1 - seg(f, inicio + 14, inicio + 26)) * 24}px)`}}>{legenda}</div>}
+  </>;
+};

package/kits/pontos-3d/elementos/Fundo.tsx

@@ -0,0 +1,20 @@
+// Fundo: azul-elétrico chapado com vinheta escura e cruzes (+) tênues que andam na diagonal.
+// Fica FORA da Camera.
+import React from 'react';
+import {AbsoluteFill, useCurrentFrame} from 'remotion';
+import {COR} from './base';
+
+const cruz = `url("data:image/svg+xml;utf8,${encodeURIComponent("<svg xmlns='http://www.w3.org/2000/svg' width='90' height='90'><path d='M45 38v14M38 45h14' stroke='white' stroke-opacity='0.12' stroke-width='2'/></svg>")}")`;
+
+export type FundoProps = {
+  /** cor do chão (padrão: azul-elétrico) */
+  cor?: string;
+  velocidade?: number;
+};
+
+export const Fundo: React.FC<FundoProps> = ({cor = COR.azul, velocidade = 1}) => {
+  const f = useCurrentFrame() * velocidade;
+  return <AbsoluteFill style={{background: `radial-gradient(90% 55% at 50% 40%, #2A4BFF 0%, ${cor} 55%, ${COR.azulEscuro} 100%)`}}>
+    <AbsoluteFill style={{backgroundImage: cruz, backgroundSize: '90px 90px', backgroundPosition: `${f * 0.35}px ${f * 0.35}px`}} />
+  </AbsoluteFill>;
+};

package/kits/pontos-3d/elementos/Montagem.tsx

@@ -0,0 +1,67 @@
+// Montagem: transforma um plano de cenas (JSON escrito pela IA) em vídeo, usando só os elementos do kit.
+// Ela NÃO decide nada de estética: só põe Fundo + Camera + Cenas + sons onde o plano mandou.
+// Formato do plano: ver exemplos/plano.json e KITS.md (seção "plano de cenas").
+import React, {useEffect, useState} from 'react';
+import {AbsoluteFill, continueRender, delayRender} from 'remotion';
+import {COR, esperarFontes, fontesProntas} from './base';
+import {Fundo} from './Fundo';
+import {Camera} from './Camera';
+import {Cena, Entrada, Saida} from './Cena';
+import {Efeito, NomeSom, Trilha} from './Som';
+import {NuvemDePontos} from './NuvemDePontos';
+import {TextoDePontos} from './TextoDePontos';
+import {TituloSora} from './TituloSora';
+import {Contador} from './Contador';
+import {RotuloPonto} from './RotuloPonto';
+import {AssinaturaMarca} from './AssinaturaMarca';
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const ELEMENTOS: Record<string, React.FC<any>> = {
+  NuvemDePontos, TextoDePontos, TituloSora, Contador, RotuloPonto, AssinaturaMarca,
+};
+
+export type Camada = {elemento: string; props: Record<string, unknown>};
+export type CenaPlano = {
+  batida: string; de: number; ate: number; entrada?: Entrada; saida?: Saida;
+  camadas: Camada[];
+  /** sons relativos ao início da cena */
+  sons?: {som: NomeSom; em: number; volume?: number}[];
+  /** socos de câmera extras, relativos ao início da cena (o início já é um soco) */
+  socos?: number[];
+};
+export type Plano = {kit: string; duracao: number; fundo?: Record<string, unknown>; trilha?: {volume?: number} | false; cenas: CenaPlano[]};
+
+/** troca "fotos/foto-01.jpg" pela URL importada, em qualquer prop (texto, lista ou objeto) */
+const resolver = (v: unknown, arquivos: Record<string, string>): unknown => {
+  if (typeof v === 'string') return arquivos[v] ?? v;
+  if (Array.isArray(v)) return v.map((x) => resolver(x, arquivos));
+  if (v && typeof v === 'object') return Object.fromEntries(Object.entries(v).map(([k, x]) => [k, resolver(x, arquivos)]));
+  return v;
+};
+
+export const Montagem: React.FC<{plano: Plano; arquivos?: Record<string, string>}> = ({plano, arquivos = {}}) => {
+  // não desenha nada antes das fontes: as medidas de texto (caber) precisam delas
+  const [ok, setOk] = useState(fontesProntas());
+  useEffect(() => {
+    if (ok) return;
+    const h = delayRender('pontos-3d: aguardando fontes');
+    esperarFontes().then(() => {setOk(true); setTimeout(() => continueRender(h), 40);});
+  }, [ok]);
+  if (!ok) return <AbsoluteFill style={{background: COR.azul}} />;
+  const socos = plano.cenas.flatMap((c) => [c.de, ...(c.socos ?? []).map((s) => c.de + s)]);
+  const ultima = plano.cenas.length - 1;
+  return <AbsoluteFill style={{background: COR.azul}}>
+    <Fundo {...(plano.fundo ?? {})} />
+    <Camera batidas={socos} forca={1}>
+      {plano.cenas.map((c, i) => <Cena key={i} de={c.de} ate={c.ate} entrada={c.entrada} saida={c.saida} ultima={i === ultima}>
+        {c.camadas.map((k, j) => {
+          const El = ELEMENTOS[k.elemento];
+          if (!El) throw new Error(`pontos-3d: elemento "${k.elemento}" não existe no kit`);
+          return <El key={j} {...(resolver(k.props, arquivos) as object)} />;
+        })}
+      </Cena>)}
+    </Camera>
+    {plano.cenas.flatMap((c, i) => (c.sons ?? []).map((s, j) => <Efeito key={`${i}-${j}`} som={s.som} em={c.de + s.em} volume={s.volume} />))}
+    {plano.trilha !== false && <Trilha volume={plano.trilha?.volume} />}
+  </AbsoluteFill>;
+};