remotion-colour-family
Construye una paleta completa a partir de anclajes mínimos. Reutiliza el ayudante contrast() de remotion-studio/src/colour/index.ts.
Disparadores
- BrandConfig carece de bloques
secondary,accent,neutralosemantic. - Un renderizado falla en contraste: cualquier par texto-sobre-fondo tiene una relación < 4.5.
- El usuario dice "extiende la paleta para {marca}" o "audita el color".
Entradas
- 1-3 anclajes hex (primario obligatorio; secundario, acento opcionales)
family:restoration|safety|industrial|consumer|trainingschool(opcional):editorial-monocle|modern-minimal|warm-soft|tech-utility|brutalist-experimental— preajuste de escuela visual (linaje de diseño abierto). Selecciona el carácter tipográfico, el sesgo de contraste y el rol del acento antes de que se ejecuten las heurísticas de familia. Valor por defecto:modern-minimal.- Paleta existente (si se extiende)
Método
-
Preajuste de escuela — aplicar el sesgo de
schoolprimero. Cada escuela restringe el rango de tono, el rango de luminosidad, la temperatura de los neutros y la saturación del acento:Escuela Sesgo de tono Sesgo de luminosidad Neutros Saturación del acento Referencia (vendorizada) editorial-monocletierra cálida (terracota/arcilla/arena) alta (pergamino/marfil) solo grises cálidos — cada gris lleva un matiz amarillo-marrón un acento cromático, profundamente terroso _library/claude/,_library/monocle/(si existe)modern-minimalneutro frío (pizarra/gris azulado) equilibrada grises verdaderos un acento eléctrico, usado <3 veces por viewport _library/airbnb/,_library/cal/warm-softpasteles cálidos (melocotón/sonrosado/crema) alta grises cálidos + matices crema rosa/coral de baja saturación _library/airtable/,_library/cafe/tech-utilityíndigo / cian / pizarra baja (superficies oscuras preferidas) grises fríos hacia slate-900 acento de señal cian, usado solo en deltas / estado _library/binance/,_library/arc/brutalist-experimentalprimario de alto contraste sobre blanco puro extrema alta + extrema oscura solo blanco y negro puros neón afilado, usado agresivamente _library/brutalism/,_library/bold/ -
Heurísticas de familia — aplicadas después de la escuela. La familia proporciona los adyacentes canónicos:
safety: azul marino + naranja de emergencia + marfilrestoration: verde azulado + pizarra + limaindustrial: grafito + acero + ámbarconsumer: rojo/azul heroico + blanco cálido + pizarratraining: terracota + crema + tinta
-
Generar en OKLch — trabajar en el espacio de color OKLch, no HSL, para que las rotaciones de tono preserven la luminosidad percibida. Convertir primero los anclajes hex a OKLch; rotar el tono ±30°/±60° mientras se limita la luminosidad a la banda de la escuela. Devolver el resultado a hex para el almacenamiento en
BrandConfig. Mantener un campo hermanooklchen el informe de contraste para los consumidores de Tailwind-4 (Fase 2). -
Determinismo — el mismo triplete
(primario, family, school)DEBE producir la misma paleta de salida en todas las ejecuciones. Sin aleatoriedad; sin temperatura; sin interpolación de LLM. El generador es una función pura de sus entradas. -
Construir neutros — interpolar entre
oklch(99% 0 hue)(50) yoklch(15% 0 hue)(900), inclinando elchromahacia el tono del primario según el sesgo de la escuela (warm-soft tira los neutros hacia cálido; tech-utility los tira hacia frío). -
Construir semántica — elegir
success/warning/dangerde un conjunto fijo que no choque con el primario. -
Construir variante oscura — invertir los neutros (intercambiar luminosidad
50 ↔ 900) y desplazar el primario hacia arriba un 8% de luminosidad en el espacio OKLch. -
Validar — para cada par
(primary, neutral.50),(primary, neutral.900),(secondary, neutral.50),(accent, secondary), asegurar contraste ≥ 4.5 (WCAG-AA). Si no, regenerar la ranura que falla. Brutalist-experimental requiere ≥ 7.0 (AAA).
Salida
Dos artefactos:
- Informe de contraste JSON con coordenadas OKLch (para
remotion-brand-codifyy consumo web en Fase 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": []
}
- Fragmento YAML listo para colocar en el bloque
colors:deSynthex/packages/brand-config/src/brands/{slug}.design.md— los nombres de los tokens siguen la especificación de@google/design.md(minúsculas + guiones para nombres de niveles, ej.neutral-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"
Ejecuta npx --prefix Pi-Dev-Ops/remotion-studio design.md lint contra el archivo .design.md resultante para confirmar cero errores de contraste.
Límites
- Nunca entregar una paleta con algún fallo AA — bloquear y solicitar la opinión del fundador sobre la ranura conflictiva.
- Nunca sobrescribir un
darkVariantexplícito establecido por la marca. - Nunca usar rojo como primario a menos que
family === 'consumer'y el nombre de la marca ancle explícitamente el rojo. - Nunca recurrir a un LLM durante la generación — la función es determinista. Si el determinismo falla (la misma entrada produce diferente salida entre ejecuciones), eso es un error en el generador, no una característica.
- Nunca mezclar dos escuelas — elegir una. Mezclar la calidez de
editorial-monoclecon la pizarra detech-utilityproduce la paleta "por defecto de IA" turbia con la que toda marca empieza.
Pasar el testigo a
remotion-brand-codify escribe el resultado en src/brands/{slug}.ts.