primocode 10.17.0 → 10.19.0

package/kits/pontos-3d/regras/ritmo.md

@@ -0,0 +1,14 @@
+# Ritmo
+
+- 30 fps. Uma batida da trilha = **15 quadros** (120 bpm). Cortes em múltiplos de 15 quadros: 0, 15, 30, 45, 60, 75, 90, 105, 120, 135, 150, 165, 180, 195, 210, 225.
+
+| batida | duração (s) | quadros |
+|---|---|---|
+| gancho | 1,3–2,0 | 40–60 |
+| virada | 1,3–2,0 | 40–60 |
+| prova (cada) | 1,1–1,8 | 33–54 |
+| data | 1,0–1,6 | 30–48 |
+| marca | 1,6–3,0 | 48–90 |
+
+- Preview do kit: 8 s, 6 cenas.
+- Leitura: um título precisa de **≥ 30 quadros**; um contador, **≥ 24 quadros** depois de chegar ao valor.

package/kits/pontos-3d/regras/som.md

@@ -0,0 +1,20 @@
+# Som
+
+- Trilha: `assets/trilha/tech-120bpm.mp3` (8,6 s, 120 bpm), volume **0.55**, fade de saída nos últimos **20 quadros**. Vídeo maior que 8,6 s: gere uma trilha nova no MotionCraft (`music make`, preset `tech-bright`, 120 bpm, tom E), não faça loop deste trecho.
+- Com narração: trilha a **0.28** e efeitos a 70% do volume da tabela.
+- Efeitos (todos sintetizados) e volume padrão:
+
+| som | volume | quando |
+|---|---|---|
+| `tick` | 0.7 | ponto ou letra que se monta |
+| `pop` | 0.8 | rótulo que aparece |
+| `whoosh` | 0.85 | entrada de cena e troca de forma |
+| `varre` | 0.7 | a nuvem gira para outra forma |
+| `impacto` | 0.8 | fim da contagem e o nome do produto |
+| `subida` | 0.6 | durante a contagem |
+| `clique` | 0.8 | endereço / detalhe |
+| `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/pontos-3d/regras/tipografia.md

@@ -0,0 +1,16 @@
+# Tipografia
+
+Duas fontes: **Sora 800** para título e **JetBrains Mono 800** para número e rótulo.
+
+| papel | fonte | peso | tamanho (px) | máx. caracteres |
+|---|---|---|---|---|
+| título (hero) | Sora | 800 | 170–220 | 9 |
+| número do contador (hero) | JetBrains Mono | 800 | 210–280 | 7 |
+| texto de pontos | Sora | 800 | 230–290 (amostrado a cada 12 px) | 8 |
+| rótulo técnico | JetBrains Mono | 700 | 46–56 | 26 |
+| detalhe / endereço | JetBrains Mono | 500 | 44–52 | 30 |
+
+- Tracking: −0,03 em no título; 0 em mono.
+- Line-height: 1,0 no título; 1,3 no rótulo.
+- Caixa: título em frase normal; rótulos em minúsculas.
+- Texto que cresce encolhe sozinho (`caber()` em `base.ts`) até caber em 920 px; nunca palavra cortada.

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

@@ -0,0 +1,59 @@
+---
+slug: produto-3d
+nome: Produto 3D em estúdio
+descricao: filme de produto escuro e caro, com objeto 3D real, luz de borda, reflexo no chão polido, vista explodida e macro
+familia: SaaS e tecnologia
+versao: 2
+quando:
+  - "vídeo de lançamento de produto físico ou gadget"
+  - "mostrar um objeto por dentro, peça por peça"
+  - "anúncio premium de hardware com cara de keynote escuro"
+  - "quero o produto girando em estúdio com reflexo"
+  - "filme de produto com número de especificação"
+nao_serve:
+  - "estúdio claro e tipografia pequena e calma (use apple-tipografico)"
+  - "software sem objeto físico (use saas-linear ou vidro-ios)"
+---
+
+# Produto 3D em estúdio
+
+Um **filme de produto escuro**: breu `#030304`, um feixe de luz que cai do teto com poeira e um chão polido
+que **reflete o produto de verdade**. O herói é um **objeto 3D renderizado** (raymarching em JS, mesmo motor
+do `apple-tipografico`, reiluminado): duas tiras de **luz de borda** atrás (quente à esquerda, fria à direita)
+desenham a silhueta, uma softbox fraca em cima, materiais anodizado, metal polido, borracha estriada e vidro
+com tratamento verde/violeta. A câmera é **lenta e segura**: órbitas, empurrões, uma **vista explodida** em que
+as peças se abrem e encaixam uma a uma, e um **macro** que corre pelo detalhe. A tipografia é mínima e pesada:
+**Syncopate 700 caixa alta**, espaçamento que fecha ao entrar, e **IBM Plex Mono** nas etiquetas. Um só acento:
+laranja `#FF5A1F`, no anel do produto e num traço do título. Nunca parece o kit claro da Apple: aqui tudo é sombra.
+
+## Como montar um vídeo com este kit
+
+1. **Corte o roteiro** em 4–6 frases curtas. Uma frase = um plano. Plano tem 36–66 quadros.
+2. **Escolha as batidas** em `receita.json`: gancho (revelar do breu) → prova (vista explodida) → detalhe (macro)
+   → data (número) → marca. Uma ideia por plano.
+3. **Monte o produto** no `Produto3D`: use `modelo` (pronto em `modelos.ts`) ou escreva `pecas`. Dê `abre` a cada
+   peça pra vista explodida e `grupo` pra o que anda junto.
+4. **Escreva o plano** (`exemplos/plano.json`): câmera por chaves, `luz`, `borda`, `brilho`, `explodir`, um texto
+   por plano, sons 1–2 quadros antes do movimento.
+5. **Renderize** e confira: herói ≥ 40% da altura, 35–45% de tela vazia, texto entre y 168 e 1330, um respiro de
+   ≥ 8 quadros parado depois de cada golpe.
+
+## Elementos
+
+| elemento | o que faz | batidas |
+|---|---|---|
+| `Produto3D` | o objeto 3D: luz de borda, reflexo no chão, vista explodida (`explodir`, `cascata`), câmera por chaves | todas |
+| `Fundo` | breu + feixe de luz com poeira que balança ±2,2% + poço no chão + vinheta | todas |
+| `TituloMinimo` | Syncopate caixa alta, linha sobe da máscara, espaçamento fecha 0,3 → 0,04 em, traço de acento | gancho, virada |
+| `RotuloChamada` | ponto + linha fina + etiqueta mono apontando um detalhe (1 por cena) | prova, detalhe |
+| `NumeroDestaque` | número gigante que conta (`de` → `para`) com rótulo mono | data |
+| `VarreduraLuz` | risco de luz anamórfico no golpe | marca, golpe |
+| `AssinaturaMarca` | nome que se abre do centro + traço + linha mono | marca |
+
+## Proibido
+
+- Fundo claro, degradê colorido, mais de uma cor de acento.
+- Produto pequeno no meio do vazio (< 30% da altura) ou cortado sem ser macro.
+- Mais de 1 texto e 1 rótulo na mesma cena; texto em cima do produto.
+- Câmera tremida, giro rápido (> 40° por segundo), corte sem respiro.
+- Glow em letra, flash branco, partícula colorida.

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

@@ -0,0 +1,18 @@
+# Assets do kit produto-3d
+
+| arquivo | o que é | origem | licença |
+|---|---|---|---|
+| `fontes/syncopate-latin.woff2` | Syncopate 700 (subset latino) | Google Fonts, baixado em 26/10/2026 | SIL OFL 1.1 — texto em `fontes/OFL-Syncopate.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-IBMPlexMono.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": "dark-minimal", "bpm": 100, "key": "A", "lead": "glock", "drums": "tight", "comp": "sustain", "brightness": 1.1}) | sem samples; síntese própria (CC0). MotionCraft é MIT |
+
+Conteúdo de demonstração (fica em `exemplos/`, não faz parte do estilo): o produto é desenhado no código (elementos/modelos.ts), sem fotos de terceiros, a menos que listado abaixo.

package/kits/produto-3d/assets/fontes/OFL-IBMPlexMono.txt

@@ -0,0 +1,93 @@
+Copyright The IBM Plex Mono Project Authors (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.

package/kits/produto-3d/assets/fontes/OFL-Syncopate.txt

@@ -0,0 +1,92 @@
+Copyright (c) Syncopate 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/produto-3d/elementos/AssinaturaMarca.tsx

@@ -0,0 +1,28 @@
+// AssinaturaMarca: o fecho. Nome do produto em Syncopate 92 px com espaçamento 0,08 em, que se abre do
+// centro (as letras chegam de 0,6 em → 0,08 em), um traço de acento de 120 px que cresce e uma linha mono.
+// Fica em cima do produto (o produto e o reflexo continuam embaixo).
+import React from 'react';
+import {useCurrentFrame} from 'remotion';
+import {COR, FONTE_D, FONTE_M, LARGURA_UTIL, TIPO, caber, lerp, saida, seg} from './base';
+
+export type AssinaturaMarcaProps = {
+  nome: string;
+  linha?: string;
+  rodape?: string;
+  y?: number;
+  inicio?: number;
+};
+
+export const AssinaturaMarca: React.FC<AssinaturaMarcaProps> = ({nome, linha, rodape, y = 300, inicio = 0}) => {
+  const f = useCurrentFrame();
+  const t = saida(seg(f, inicio, inicio + 22));
+  const tl = saida(seg(f, inicio + 10, inicio + 26));
+  const tam = caber(nome, TIPO.marca.tamanho, LARGURA_UTIL, FONTE_D, 700, 0.6);
+  return <div style={{position: 'absolute', left: 0, right: 0, top: y, textAlign: 'center'}}>
+    <div style={{fontFamily: FONTE_D, fontWeight: 700, fontSize: tam, color: COR.texto, whiteSpace: 'nowrap', textTransform: 'uppercase',
+      letterSpacing: `${lerp(0.6, TIPO.marca.tracking, t)}em`, marginRight: `-${lerp(0.6, TIPO.marca.tracking, t)}em`, opacity: t, filter: t < 1 ? `blur(${(1 - t) * 12}px)` : undefined}}>{nome}</div>
+    <div style={{width: 120 * tl, height: 3, background: COR.acento, margin: '30px auto 26px'}} />
+    {linha && <div style={{fontFamily: FONTE_M, fontWeight: 600, fontSize: TIPO.rotulo.tamanho, letterSpacing: `${TIPO.rotulo.tracking}em`, color: COR.apagado, textTransform: 'uppercase', opacity: tl}}>{linha}</div>}
+    {rodape && <div style={{marginTop: 18, fontFamily: FONTE_M, fontSize: 17, color: '#4C4F57', opacity: tl}}>{rodape}</div>}
+  </div>;
+};

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

@@ -0,0 +1,23 @@
+// Camera: o empurrão lento do filme para camadas 2D (texto, foto recortada, cartão).
+// O Produto3D tem a própria câmera 3D (órbita/distância por chaves); esta só aproxima o quadro.
+// Valores do filme: +3 a +6% de zoom por plano, curva suave, nunca tremor.
+import React from 'react';
+import {AbsoluteFill, useCurrentFrame} from 'remotion';
+import {CURVAS, NomeCurva, lerp, seg} from './base';
+import {useDuracaoCena} from './Cena';
+
+export type CameraProps = {
+  /** zoom no início e no fim da cena (1 = parado; 1.05 = empurrão do filme) */
+  de?: number; para?: number;
+  /** deriva horizontal total em px (−30 a 30) */
+  deriva?: number;
+  /** ponto que a câmera aproxima, em % da tela */
+  foco?: [number, number];
+  curva?: NomeCurva;
+  children: React.ReactNode;
+};
+
+export const Camera: React.FC<CameraProps> = ({de = 1, para = 1.04, deriva = 0, foco = [50, 48], curva = 'suave', children}) => {
+  const t = CURVAS[curva](seg(useCurrentFrame(), 0, useDuracaoCena()));
+  return <AbsoluteFill style={{transform: `translateX(${deriva * t}px) scale(${lerp(de, para, t)})`, transformOrigin: `${foco[0]}% ${foco[1]}%`}}>{children}</AbsoluteFill>;
+};

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

@@ -0,0 +1,55 @@
+// Cena: a janela de tempo de um plano do filme. Dentro dela, useCurrentFrame() começa em 0.
+// Transições do filme de referência (ver regras/movimento.md):
+//   corte     → troca seca
+//   dissolver → 10 quadros de fusão
+//   borrao    → chicote: desfoque horizontal de 8 quadros, a cena nova vem da direita
+//   escuro    → nasce do preto em 12 quadros (abertura)
+import React, {createContext, useContext} from 'react';
+import {AbsoluteFill, Sequence, useCurrentFrame} from 'remotion';
+import {entrada as curvaEntrada, saida as curvaSaida, seg} from './base';
+
+export type Transicao = 'corte' | 'dissolver' | 'borrao' | 'escuro';
+/** quadros em que a cena que sai continua por baixo da que entra */
+export const SOBREPOE = {corte: 0, dissolver: 10, borrao: 8, escuro: 0} as const;
+
+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;
+  /** como esta cena entra */
+  entrada?: Transicao;
+  /** como esta cena sai (= a entrada da próxima; a Montagem preenche sozinha) */
+  saida?: Transicao;
+  children: React.ReactNode;
+};
+
+/** filtro SVG de desfoque só na horizontal (o borrão de movimento do chicote) */
+export const BorraoX: React.FC<{id: string; x: number}> = ({id, x}) =>
+  <svg width={0} height={0} style={{position: 'absolute'}}>
+    <filter id={id} x="-20%" y="0" width="140%" height="100%"><feGaussianBlur stdDeviation={`${x} 0`} /></filter>
+  </svg>;
+
+const Janela: React.FC<{de: number; duracao: number; entrada: Transicao; saida: Transicao; children: React.ReactNode}> = ({de, duracao, entrada, saida, children}) => {
+  const f = useCurrentFrame();
+  let op = 1, tx = 0, bx = 0;
+  if (entrada === 'dissolver') op *= seg(f, 0, SOBREPOE.dissolver);
+  if (entrada === 'escuro') op *= curvaSaida(seg(f, 0, 12));
+  if (entrada === 'borrao') {const t = curvaSaida(seg(f, 0, SOBREPOE.borrao)); op *= Math.min(1, t * 2.2); tx += (1 - t) * 220; bx += (1 - t) * 60;}
+  if (saida === 'borrao') {const t = curvaEntrada(seg(f, duracao, duracao + SOBREPOE.borrao)); tx -= t * 160; bx += t * 60;}
+  const id = `p3-borrao-${de}`;
+  return <AbsoluteFill style={{opacity: op, transform: tx ? `translateX(${tx}px)` : undefined, filter: bx > 0.5 ? `url(#${id})` : undefined}}>
+    {bx > 0.5 && <BorraoX id={id} x={bx} />}
+    {children}
+  </AbsoluteFill>;
+};
+
+export const Cena: React.FC<CenaProps> = ({de, ate, entrada = 'corte', saida = 'corte', children}) => {
+  const duracao = ate - de;
+  return <Sequence from={de} durationInFrames={duracao + SOBREPOE[saida]} layout="none">
+    <CenaCtx.Provider value={{duracao}}>
+      <Janela de={de} duracao={duracao} entrada={entrada} saida={saida}>{children}</Janela>
+    </CenaCtx.Provider>
+  </Sequence>;
+};

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

@@ -0,0 +1,45 @@
+// Fundo: o estúdio escuro. Breu sem emenda, um FEIXE de luz que cai do teto (volume com poeira),
+// um poço de luz no chão polido e vinheta. O feixe balança devagar: nada fica parado.
+import React from 'react';
+import {AbsoluteFill, useCurrentFrame} from 'remotion';
+import {COR} from './base';
+
+export type FundoProps = {
+  /** centro do feixe em % da largura */
+  feixe?: number;
+  /** centro do poço de luz no chão, em % da tela */
+  poca?: [number, number];
+  /** força do feixe e do poço (0–1) */
+  forca?: number;
+  /** linha do horizonte do chão polido em % da altura (o chão fica 4% mais claro abaixo dela) */
+  horizonte?: number;
+};
+
+const rnd = (i: number) => {const x = Math.sin(i * 127.1 + 311.7) * 43758.5453; return x - Math.floor(x);};
+
+export const Fundo: React.FC<FundoProps> = ({feixe = 50, poca = [50, 66], forca = 1, horizonte = 64}) => {
+  const f = useCurrentFrame();
+  const bal = Math.sin(f / 46) * 2.2; // o feixe balança ±2,2%
+  const x = feixe + bal;
+  return <AbsoluteFill style={{background: COR.breu, overflow: 'hidden'}}>
+    {/* chão polido: um tom acima do breu, que some no horizonte */}
+    <AbsoluteFill style={{background: `linear-gradient(180deg, ${COR.breu} 0%, ${COR.breu} ${horizonte - 8}%, ${COR.chao} ${horizonte}%, #0B0C10 100%)`}} />
+    {/* o feixe: trapézio do teto ao chão, borrado */}
+    <AbsoluteFill style={{
+      clipPath: `polygon(${x - 7}% -2%, ${x + 7}% -2%, ${x + 30}% ${poca[1] + 2}%, ${x - 30}% ${poca[1] + 2}%)`,
+      background: `linear-gradient(180deg, rgba(154,163,181,${0.2 * forca}) 0%, rgba(154,163,181,${0.07 * forca}) 55%, rgba(154,163,181,0) 100%)`,
+      filter: 'blur(28px)',
+    }} />
+    {/* poeira no feixe */}
+    {Array.from({length: 26}, (_, i) => {
+      const px = x + (rnd(i) - 0.5) * 30 * (0.3 + rnd(i + 9));
+      const py = ((rnd(i + 3) * 70 + f * (0.05 + rnd(i + 5) * 0.08)) % 70) + 2;
+      const a = (0.25 + 0.5 * rnd(i + 7)) * forca * (0.5 + 0.5 * Math.sin(f / 9 + i));
+      return <div key={i} style={{position: 'absolute', left: `${px}%`, top: `${py}%`, width: 3, height: 3, borderRadius: 2, background: '#CFD6E4', opacity: a * 0.6}} />;
+    })}
+    {/* poço de luz no chão */}
+    <AbsoluteFill style={{background: `radial-gradient(34% 5.5% at ${poca[0] + bal * 0.5}% ${poca[1]}%, rgba(170,180,200,${0.2 * forca}) 0%, rgba(170,180,200,${0.06 * forca}) 55%, rgba(0,0,0,0) 100%)`}} />
+    {/* vinheta */}
+    <AbsoluteFill style={{background: 'radial-gradient(120% 75% at 50% 45%, rgba(0,0,0,0) 55%, rgba(0,0,0,.75) 100%)'}} />
+  </AbsoluteFill>;
+};

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

@@ -0,0 +1,53 @@
+// 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: põe Fundo + Camera + camadas + sons onde o plano mandou.
+import React from 'react';
+import {AbsoluteFill} from 'remotion';
+import {Fundo, FundoProps} from './Fundo';
+import {Camera, CameraProps} from './Camera';
+import {Cena, Transicao} from './Cena';
+import {Efeito, NomeSom, Trilha} from './Som';
+import {Produto3D} from './Produto3D';
+import {TituloMinimo} from './TituloMinimo';
+import {RotuloChamada} from './RotuloChamada';
+import {NumeroDestaque} from './NumeroDestaque';
+import {VarreduraLuz} from './VarreduraLuz';
+import {AssinaturaMarca} from './AssinaturaMarca';
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export const ELEMENTOS: Record<string, React.FC<any>> = {Produto3D, TituloMinimo, RotuloChamada, NumeroDestaque, VarreduraLuz, AssinaturaMarca};
+
+export type Camada = {elemento: string; props: Record<string, unknown>};
+export type CenaPlano = {
+  batida: string; de: number; ate: number; entrada?: Transicao;
+  /** o estúdio da cena (feixe, poço, força); false = sem fundo */
+  fundo?: FundoProps | false;
+  /** empurrão 2D da cena inteira (o Produto3D já tem câmera própria) */
+  camera?: Omit<CameraProps, 'children'>;
+  camadas: Camada[];
+  sons?: {som: NomeSom; em: number; volume?: number}[];
+};
+export type Plano = {kit: string; duracao: number; trilha?: {volume?: number} | false; cenas: CenaPlano[]};
+
+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 = {}}) =>
+  <AbsoluteFill style={{background: '#030304'}}>
+    {plano.cenas.map((c, i) => {
+      const camadas = c.camadas.map((k, j) => {
+        const El = ELEMENTOS[k.elemento];
+        if (!El) throw new Error(`produto-3d: elemento "${k.elemento}" não existe no kit`);
+        return <El key={j} {...(resolver(k.props, arquivos) as object)} />;
+      });
+      return <Cena key={i} de={c.de} ate={c.ate} entrada={c.entrada} saida={plano.cenas[i + 1]?.entrada ?? 'corte'}>
+        {c.fundo !== false && <Fundo {...(c.fundo ?? {})} />}
+        {c.camera ? <Camera {...c.camera}>{camadas}</Camera> : camadas}
+      </Cena>;
+    })}
+    {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>;

package/kits/produto-3d/elementos/NumeroDestaque.tsx

@@ -0,0 +1,35 @@
+// NumeroDestaque: o número da especificação, enorme (Syncopate 150 px), que CONTA do valor `de` ao
+// `para` no ritmo da câmera, com um rótulo mono embaixo. Ex.: abertura f/2.8 → f/1.2.
+import React from 'react';
+import {useCurrentFrame} from 'remotion';
+import {COR, FONTE_D, FONTE_M, SEGURA, TIPO, entrada, saida, seg, suave} from './base';
+import {useDuracaoCena} from './Cena';
+
+export type NumeroDestaqueProps = {
+  de: number; para: number; casas?: number;
+  prefixo?: string; sufixo?: string;
+  rotulo?: string;
+  x?: number; y?: number; tamanho?: number;
+  inicio?: number;
+  /** quadros que a contagem leva */
+  conta?: number;
+  sai?: number;
+};
+
+export const NumeroDestaque: React.FC<NumeroDestaqueProps> = ({de, para, casas = 1, prefixo = '', sufixo = '', rotulo, x = SEGURA.lado, y = 1060, tamanho = TIPO.numero.tamanho, inicio = 0, conta = 22, sai = -1}) => {
+  const f = useCurrentFrame();
+  const dur = useDuracaoCena();
+  const fim = sai < 0 ? dur + 99 : sai;
+  const tOut = entrada(seg(f, fim, fim + 8));
+  const tIn = saida(seg(f, inicio, inicio + 12));
+  const v = de + (para - de) * suave(seg(f, inicio + 2, inicio + 2 + conta));
+  const txt = v.toFixed(casas).replace('.', '.');
+  return <div style={{position: 'absolute', left: x, top: y, opacity: tIn * (1 - tOut), transform: `translateY(${(1 - tIn) * 40 + tOut * 20}px)`}}>
+    <div style={{fontFamily: FONTE_D, fontWeight: 700, fontSize: tamanho, lineHeight: 1, color: COR.texto, whiteSpace: 'nowrap', letterSpacing: '-0.02em'}}>
+      <span style={{fontSize: tamanho * 0.42, color: COR.apagado, marginRight: 8}}>{prefixo}</span>{txt}<span style={{fontSize: tamanho * 0.42, color: COR.acento}}>{sufixo}</span>
+    </div>
+    {rotulo && <div style={{marginTop: 22, fontFamily: FONTE_M, fontWeight: 600, fontSize: TIPO.rotulo.tamanho, letterSpacing: `${TIPO.rotulo.tracking}em`, color: COR.apagado, textTransform: 'uppercase'}}>
+      <span style={{display: 'inline-block', width: 34, height: 2, background: COR.acento, verticalAlign: 'middle', marginRight: 14}} />{rotulo}
+    </div>}
+  </div>;
+};