remotion-colour-family
Construit une palette complète à partir d'ancrages minimaux. Réutilise le helper contrast() de remotion-studio/src/colour/index.ts.
Déclencheurs
- BrandConfig ne contient pas les blocs
secondary,accent,neutralousemantic. - Un rendu échoue au contraste : toute paire texte-sur-fond a un rapport < 4.5.
- L'utilisateur dit « étends la palette pour {marque} » ou « audite les couleurs ».
Entrées
- 1 à 3 ancrages hexadécimaux (primaire obligatoire ; secondaire et accent facultatifs)
family:restoration|safety|industrial|consumer|trainingschool(optionnel) :editorial-monocle|modern-minimal|warm-soft|tech-utility|brutalist-experimental— préréglage d'école visuelle (lignée design ouvert). Sélectionne le caractère typographique, le biais de contraste et le rôle de l'accent avant que les heuristiques de famille ne s'exécutent. Par défaut :modern-minimal.- Palette existante (si extension)
Méthode
-
Préréglage d'école — applique le biais
schoolen premier. Chaque école contraint la plage de teinte, la plage de luminosité, la température des neutres et la saturation de l'accent :École Biais de teinte Biais de luminosité Neutres Saturation de l'accent Référence (vendue) editorial-monocleterre chaude (terre cuite/argile/sable) élevée (parchemin/ivoire) gris chauds uniquement — chaque gris porte une nuance jaune-brun un accent chromatique, profondément terreux _library/claude/,_library/monocle/(si présent)modern-minimalneutre froid (ardoise/bleu-gris) équilibrée gris véritables un accent électrique, utilisé <3× par zone d'affichage _library/airbnb/,_library/cal/warm-softpastels chauds (pêche/fard/crème) élevée gris chauds + teintes crème rose corail à faible saturation _library/airtable/,_library/cafe/tech-utilityindigo / cyan / ardoise faible (surfaces sombres privilégiées) gris froids vers ardoise-900 accent cyan, utilisé uniquement sur les deltas/états _library/binance/,_library/arc/brutalist-experimentalprimaire à fort contraste sur blanc pur extrême haute + extrême sombre noir/blanc purs uniquement néon vif, utilisé de manière agressive _library/brutalism/,_library/bold/ -
Heuristiques de famille — appliquées après l'école. La famille fournit les adjacents canoniques :
safety: bleu marine + orange de sécurité + ivoirerestoration: sarcelle + ardoise + citron vertindustrial: graphite + acier + ambreconsumer: rouge/bleu héroïque + blanc chaud + ardoisetraining: terre cuite + crème + encre
-
Générer en OKLch — travailler dans l'espace colorimétrique OKLch, pas HSL, afin que les rotations de teinte préservent la luminosité perçue. Convertir d'abord les ancrages hexadécimaux en OKLch ; faire pivoter la teinte de ±30°/±60° tout en limitant la luminosité à la bande de l'école. Reconvertir le résultat en hexadécimal pour le stockage dans
BrandConfig. Conserver un champ frèreoklchdans le rapport de contraste pour les consommateurs Tailwind-4 en aval (Phase 2). -
Déterminisme — le même triplet
(primaire, famille, école)DOIT produire la même palette de sortie entre les exécutions. Pas de hasard ; pas de température ; pas d'interpolation LLM. Le générateur est une fonction pure de ses entrées. -
Construire les neutres — interpoler entre
oklch(99% 0 hue)(50) etoklch(15% 0 hue)(900), en inclinant lechromavers la teinte du primaire selon le biais de l'école (warm-soft tire les neutres vers le chaud ; tech-utility les tire vers le froid). -
Construire les sémantiques — choisir
success/warning/dangerà partir d'un pool fixe qui n'entre pas en conflit avec le primaire. -
Construire la variante sombre — inverser les neutres (luminosité
50 ↔ 900) et décaler le primaire de 8% de luminosité vers le haut dans l'espace OKLch. -
Valider — pour chaque paire
(primaire, neutre.50),(primaire, neutre.900),(secondaire, neutre.50),(accent, secondaire), garantir un contraste ≥ 4.5 (WCAG-AA). Sinon, régénérer l'emplacement défaillant. Brutalist-experimental nécessite ≥ 7.0 (AAA).
Sortie
Deux artefacts :
- Rapport de contraste JSON avec les coordonnées OKLch (pour
remotion-brand-codifyet la consommation web de Phase 2) :
{
"school": "modern-minimal",
"family": "restoration",
"tokens": {
"primary": { "hex": "#0E7C7B", "oklch": "oklch(48% 0.10 195)" },
"neutral": {
"50": { "hex": "#F5F7F8", "oklch": "oklch(97% 0.005 200)" },
"900": { "hex": "#0E1518", "oklch": "oklch(15% 0.010 215)" }
}
},
"passes": [ { "fg":"#F5F7F8", "bg":"#0E7C7B", "ratio": 7.21, "level":"AAA" } ],
"fails": []
}
- Fragment YAML prêt à être inséré dans le bloc
colors:deSynthex/packages/brand-config/src/brands/{slug}.design.md— les noms des tokens suivent la spécification@google/design.md(minuscules + tirets pour les noms de niveaux, par exempleneutral-50,dark-primary) :
colors:
primary: "#0E7C7B"
secondary: "#2A3D45"
accent: "#C5E063"
neutral-50: "#F5F7F8"
neutral-100: "#E4E9EC"
neutral-500: "#6F7B82"
neutral-900: "#0E1518"
success: "#3FA34D"
warning: "#E0A800"
danger: "#C0392B"
on-primary: "#FFFFFF"
on-secondary: "#FFFFFF"
on-accent: "#0E1518"
surface: "{colors.neutral-50}"
on-surface: "{colors.neutral-900}"
dark-primary: "#16B5B3"
dark-secondary: "#1A2428"
dark-surface: "#0E1518"
dark-on-surface: "#F5F7F8"
Exécutez npx --prefix Pi-Dev-Ops/remotion-studio design.md lint sur le fichier .design.md résultant pour confirmer zéro erreur de contraste.
Limites
- Ne jamais livrer une palette avec un échec AA — bloquer et demander l'avis du fondateur sur l'emplacement défaillant.
- Ne jamais remplacer une
darkVariantexplicite définie par la marque. - Ne jamais utiliser le rouge comme primaire sauf si
family === 'consumer'et que le nom de la marque ancre explicitement le rouge. - Ne jamais faire appel à un LLM en pleine génération — la fonction est déterministe. Si le déterminisme échoue (même entrée → sortie différente entre les exécutions), c'est un bogue du générateur, pas une fonctionnalité.
- Ne jamais mélanger deux écoles — en choisir une. Mélanger la chaleur d'
editorial-monocleavec l'ardoise detech-utilityproduit la palette « AI-par défaut » boueuse avec laquelle chaque marque commence.
Passer le relais à
remotion-brand-codify écrit le résultat dans src/brands/{slug}.ts.