remotion-composition-builder
Las manos. Lee todo lo demás, escribe el TSX.
Disparadores
- Ola 4 de un plan
remotion-orchestrator. - El usuario pide "construir una composición para {tema}" con la marca y el storyboard ya conocidos.
Entradas
Todas se consumen de salidas de habilidades previas en el mismo trabajo:
BrandConfig(desrc/brands/{slug}.ts) — runtime + comportamiento: voz, voz en off, movimiento, audiencia, canal, palabras prohibidas{slug}.design.md(cargado medianteloadDesign(slug)desrc/brands/loadDesign.ts) — tokens visuales: color, tipografía, espaciado, componentes, diseño, elevación- JSON de Storyboard (de
remotion-screen-storyteller) - Especificación de diseño (de
remotion-designer) — referencia tokens de design.md por nombre - Bloque de movimiento (parte de
BrandConfig) - Especificación de canal / relación de aspecto (de
remotion-marketing-strategist)
Consulta src/brands/CONTRACT.md para conocer el límite de propiedad completo entre BrandConfig y design.md.
Método
- Localizar composición — ¿existe
src/compositions/{Name}.tsx?- Sí → modificar en el lugar (preservar la API existente).
- No → crear nuevo archivo usando
Explainer.tsxcomo plantilla.
- Cablear importaciones —
import { brands } from '../brands'para runtime,import { loadDesign, colour, spacing, componentRecipe, typography } from '../design'para tokens visuales, ayudantes de movimiento desde../motion. - Definir esquema —
z.objectpara props de entrada que coincidan con la forma del Storyboard. - Componer escenas — un
<Sequence>por escena del storyboard. Cada componente de escena leecfg = brands[props.brand](para movimiento/voz/voz en off) Ytokens = loadDesign(props.brand)(para color/tipografía/espaciado/recetas de componentes), luego los compone. UsacomponentRecipe(tokens, 'cta-primary')para obtener un objeto listo para CSS completamente resuelto en lugar de embeber códigos hex. - Audio — cablea
<Audio src={staticFile(scene.voiceoverAudioPath)} />por escena si la ruta está configurada. - Registrar en Root — añadir o actualizar
<Composition id="{Name}" ... />ensrc/Root.tsx.durationInFrames = sum(scene.durationSec) * fps. - Higiene de archivo — archivo de composición ≤500 líneas. Extraer escenas a
src/compositions/{Name}/scenes/*.tsxsi crece más allá de eso. - Verificación de tipos — ejecutar
npx tsc --noEmit. En caso de error, corregir y reintentar una vez.
Salidas
Archivos editados:
src/compositions/{Name}.tsx(o sub-archivos de escena)src/Root.tsx(entrada de registro)
Informe de estado a remotion-orchestrator:
{ "composition": "Explainer", "filesChanged": [...], "tscPassed": true, "ready": true }
Límites
- Nunca embeber valores de marca (códigos hex, nombres de fuente, literales de espaciado) — siempre leer desde
tokens(visual) ocfg(runtime). ConsultaCONTRACT.mdpara saber qué lado posee qué. - Nunca establecer
durationInFramessin sumar las duraciones de las escenas del storyboard × fps. - Nunca usar
staticFile()con una ruta de recurso que no exista — fallar con ruido en compilación, no en silencio en renderizado. - Nunca omitir
signatureEntry()para la entrada en movimiento — mantiene la consistencia del lenguaje de movimiento. - Nunca duplicar un token entre
BrandConfig.tsy{slug}.design.md. Si el valor vive en.design.md, el.tsno debe redeclararlo.
Reutilizado
src/compositions/Explainer.tsx— plantilla canónicasrc/motion/index.ts—signatureEntry,brandFadeIn,staggerStartsrc/colour/index.ts—readableOn,brandGradient,contrastsrc/design/index.ts—loadDesign,colour,spacing,typography,componentRecipe,resolveTokensrc/brands/loadDesign.ts— cargador tipado para{slug}.design.mdsrc/brands/CONTRACT.md— límite de propiedadBrandConfig↔design.md
Pasa a
remotion-render-pipeline para renderizar realmente.