remotion-composition-builder
As mãos. Lê todo o resto, escreve o TSX.
Acionadores
- Onda 4 de um plano
remotion-orchestrator. - Usuário pede para "construir uma composição para {tópico}" com marca e storyboard já conhecidos.
Entradas
Todas consumidas a partir de saídas de habilidades anteriores no mesmo job:
BrandConfig(desrc/brands/{slug}.ts) — runtime e comportamento: voz, narração, movimento, público, canal, palavras proibidas{slug}.design.md(carregado vialoadDesign(slug)desrc/brands/loadDesign.ts) — tokens visuais: cor, tipografia, espaçamento, componentes, layout, elevação- Storyboard JSON (de
remotion-screen-storyteller) - Especificação de layout (de
remotion-designer) — referencia tokens do design.md pelo nome - Bloco de movimento (parte de
BrandConfig) - Especificação de canal / proporção de aspecto (de
remotion-marketing-strategist)
Veja src/brands/CONTRACT.md para o limite de propriedade completo entre BrandConfig e design.md.
Método
- Localizar composição — o arquivo
src/compositions/{Name}.tsxexiste?- Se sim → aplicar patch no local (preservar API existente).
- Se não → criar novo arquivo usando
Explainer.tsxcomo template.
- Conectar imports —
import { brands } from '../brands'para runtime,import { loadDesign, colour, spacing, componentRecipe, typography } from '../design'para tokens visuais, helpers de movimento de../motion. - Definir esquema —
z.objectpara props de entrada correspondentes à forma do Storyboard. - Compor cenas — um
<Sequence>por cena do storyboard. Cada componente de cena lêcfg = brands[props.brand](para movimento/voz/narração) Etokens = loadDesign(props.brand)(para cor/tipografia/espaçamento/recipes de componentes), então os compõe. UsecomponentRecipe(tokens, 'cta-primary')para obter um objeto totalmente resolvido pronto para CSS em vez de inline de hexes. - Áudio — conectar
<Audio src={staticFile(scene.voiceoverAudioPath)} />por cena se o caminho estiver definido. - Registrar em Root — adicionar ou atualizar
<Composition id="{Name}" ... />emsrc/Root.tsx.durationInFrames = sum(scene.durationSec) * fps. - Higiene do arquivo — arquivo de composição ≤500 linhas. Extrair cenas para
src/compositions/{Name}/scenes/*.tsxse crescer além disso. - Verificação de tipo — executar
npx tsc --noEmit. Em vermelho, corrigir e tentar novamente uma vez.
Saída
Arquivos editados:
src/compositions/{Name}.tsx(ou sub-arquivos de cena)src/Root.tsx(entrada de registro)
Relatório de status para remotion-orchestrator:
{ "composition": "Explainer", "filesChanged": [...], "tscPassed": true, "ready": true }
Limites
- Nunca colocar valores de marca inline (códigos hex, nomes de fontes, literais de espaçamento) — sempre ler de
tokens(visual) oucfg(runtime). VejaCONTRACT.mdpara saber qual lado possui o quê. - Nunca definir
durationInFramessem somar as durações das cenas do storyboard × fps. - Nunca usar
staticFile()com um caminho de asset que não existe — falhar alto na build, não silencioso no render. - Nunca ignorar
signatureEntry()para movimento de entrada — manter a consistência da linguagem de movimento. - Nunca duplicar um token entre
BrandConfig.tse{slug}.design.md. Se o valor estiver em.design.md, o.tsnão deve redeclarar.
Reutilizados
src/compositions/Explainer.tsx— template canônicosrc/motion/index.ts—signatureEntry,brandFadeIn,staggerStartsrc/colour/index.ts—readableOn,brandGradient,contrastsrc/design/index.ts—loadDesign,colour,spacing,typography,componentRecipe,resolveTokensrc/brands/loadDesign.ts— carregador tipado para{slug}.design.mdsrc/brands/CONTRACT.md— limite de propriedade entreBrandConfig↔design.md
Passa para
remotion-render-pipeline para realmente renderizar.