remotion-composition-builder
Le cœur. Lit tout le reste, écrit le TSX.
Déclencheurs
- Vague 4 d'un plan
remotion-orchestrator. - L'utilisateur demande de "construire une composition pour {sujet}" avec la marque et le storyboard déjà connus.
Entrées
Toutes consommées à partir des sorties des compétences précédentes dans le même travail :
BrandConfig(depuissrc/brands/{slug}.ts) — comportement et aspects dynamiques : voix, narration, motion, audience, chaîne, mots interdits{slug}.design.md(chargé vialoadDesign(slug)depuissrc/brands/loadDesign.ts) — tokens visuels : couleur, typographie, espacement, composants, mise en page, élévation- JSON du storyboard (depuis
remotion-screen-storyteller) - Spécification de mise en page (depuis
remotion-designer) — référence les tokens du design.md par leur nom - Bloc de motion (partie de
BrandConfig) - Spécification de la chaîne / rapport d'aspect (depuis
remotion-marketing-strategist)
Voir src/brands/CONTRACT.md pour la délimitation complète des responsabilités entre BrandConfig et design.md.
Méthode
- Localiser la composition —
src/compositions/{Nom}.tsxexiste-t-il ?- Si oui → mettre à jour sur place (préserver l'API existante).
- Si non → créer un nouveau fichier en utilisant
Explainer.tsxcomme modèle.
- Câbler les imports —
import { brands } from '../brands'pour le runtime,import { loadDesign, colour, spacing, componentRecipe, typography } from '../design'pour les tokens visuels, les helpers motion depuis../motion. - Définir le schéma —
z.objectpour les props d'entrée correspondant à la forme du storyboard. - Composer les scènes — une
<Sequence>par scène du storyboard. Chaque composant de scène litcfg = brands[props.brand](pour la motion/voix/narration) ETtokens = loadDesign(props.brand)(pour la couleur/typographie/espacement/recettes de composants), puis les compose. UtilisezcomponentRecipe(tokens, 'cta-primary')pour obtenir un objet prêt pour le CSS complètement résolu au lieu d'utiliser des codes hexadécimaux en dur. - Audio — câbler
<Audio src={staticFile(scene.voiceoverAudioPath)} />par scène si le chemin est défini. - Enregistrer dans Root — ajouter ou mettre à jour
<Composition id="{Nom}" ... />danssrc/Root.tsx.durationInFrames = sum(duréeSceneSec) * fps. - Hygiène du fichier — fichier de composition ≤500 lignes. Extraire les scènes dans
src/compositions/{Nom}/scenes/*.tsxs'il dépasse cette limite. - Vérification de types — exécuter
npx tsc --noEmit. En cas d'erreur, corriger et réessayer une fois.
Sortie
Fichiers modifiés :
src/compositions/{Nom}.tsx(ou sous-fichiers de scènes)src/Root.tsx(entrée du registre)
Rapport d'état à remotion-orchestrator :
{ "composition": "Explainer", "filesChanged": [...], "tscPassed": true, "ready": true }
Limites
- Ne jamais utiliser de valeurs de marque en dur (codes hexadécimaux, noms de polices, littéraux d'espacement) — toujours lire depuis
tokens(visuel) oucfg(runtime). VoirCONTRACT.mdpour savoir de quel côté relève chaque valeur. - Ne jamais définir
durationInFramessans additionner les durées des scènes du storyboard × fps. - Ne jamais utiliser
staticFile()avec un chemin d'actif qui n'existe pas — échouer de manière visible à la construction, pas silencieusement au rendu. - Ne jamais contourner
signatureEntry()pour l'entrée en motion — maintient la cohérence du langage de motion. - Ne jamais dupliquer un token entre
BrandConfig.tset{slug}.design.md. Si la valeur se trouve dans.design.md, le.tsne doit pas la redéclarer.
Réutilisé
src/compositions/Explainer.tsx— modèle canoniquesrc/motion/index.ts—signatureEntry,brandFadeIn,staggerStartsrc/colour/index.ts—readableOn,brandGradient,contrastsrc/design/index.ts—loadDesign,colour,spacing,typography,componentRecipe,resolveTokensrc/brands/loadDesign.ts— chargeur typé pour{slug}.design.mdsrc/brands/CONTRACT.md— délimitation des responsabilitésBrandConfig↔design.md
Passe la main à
remotion-render-pipeline pour le rendu effectif.