remotion-colour-family
Constrói uma paleta completa a partir de âncoras mínimas. Reutiliza o helper contrast() de remotion-studio/src/colour/index.ts.
Gatilhos
- BrandConfig está sem os blocos
secondary,accent,neutralousemantic. - Uma renderização falha no contraste: qualquer par texto-sobre-fundo tem razão < 4.5.
- O usuário diz "estender a paleta para {marca}" ou "auditar cor".
Entradas
- 1-3 âncoras hexadecimais (primária obrigatória; secundária e destaque opcionais)
family:restoration|safety|industrial|consumer|trainingschool(opcional):editorial-monocle|modern-minimal|warm-soft|tech-utility|brutalist-experimental— predefinição de escola visual (linhagem de design aberto). Seleciona o caráter do tipo, viés de contraste e papel do destaque antes que as heurísticas de família sejam executadas. Padrão:modern-minimal.- Paleta existente (se estendendo)
Método
-
Predefinição de escola — aplicar o viés
schoolprimeiro. Cada escola restringe a faixa de matiz, faixa de luminosidade, temperatura dos neutros e saturação do destaque:Escola Viés de matiz Viés de luminosidade Neutros Saturação do destaque Referência (fornecido) editorial-monocleterra quente (terracota/argila/areia) alta (pergaminho/marfim) apenas cinzas quentes — cada cinza carrega um tom amarelo-marrom um destaque cromático, profundamente terroso _library/claude/,_library/monocle/(se presente)modern-minimalneutro frio (ardósia/azul-acinzentado) equilibrada cinzas verdadeiros um destaque elétrico, usado <3× por viewport _library/airbnb/,_library/cal/warm-softpastéis quentes (pêssego/blush/creme) alta cinzas quentes + tons de creme rosa/coral de baixa saturação _library/airtable/,_library/cafe/tech-utilityíndigo / ciano / ardósia baixa (superfícies escuras preferidas) cinzas frios em direção a ardósia-900 destaque de sinal ciano, usado apenas em deltas / estado _library/binance/,_library/arc/brutalist-experimentalprimária de alto contraste sobre branco puro extremamente alta + extremamente escura apenas preto/branco puros neon forte, usado agressivamente _library/brutalism/,_library/bold/ -
Heurísticas de família — aplicadas após a escola. A família fornece os adjacentes canônicos:
safety: azul marinho + laranja de emergência + marfimrestoration: verde-azulado + ardósia + limaindustrial: grafite + aço + âmbarconsumer: vermelho/azul herói + branco quente + ardósiatraining: terracota + creme + tinta
-
Gerar em OKLch — trabalhar no espaço de cores OKLch, não HSL, para que as rotações de matiz preservem a luminosidade percebida. Converter âncoras hexadecimais para OKLch primeiro; rotacionar matiz em ±30°/±60° enquanto limita a luminosidade à banda da escola. Converter a saída de volta para hexadecimal para armazenamento em
BrandConfig. Manter um campo irmãooklchno relatório de contraste para consumidores downstream do Tailwind-4 (Fase 2). -
Determinismo — a mesma tríplice
(primary, family, school)DEVE produzir a mesma paleta de saída em todas as execuções. Sem aleatoriedade; sem temperatura; sem interpolação LLM. O gerador é uma função pura de suas entradas. -
Construir neutros — interpolar entre
oklch(99% 0 hue)(50) eoklch(15% 0 hue)(900), inclinando ochromaem direção ao matiz da primária de acordo com o viés da escola (warm-soft puxa os neutros para o quente; tech-utility puxa para o frio). -
Construir semânticas — escolher
success/warning/dangerde um conjunto fixo que não conflita com a primária. -
Construir variante escura — inverter os neutros (luminosidade
50 ↔ 900) e deslocar a primária em 8% de luminosidade no espaço OKLch. -
Validar — para cada par
(primary, neutral.50),(primary, neutral.900),(secondary, neutral.50),(accent, secondary), garantir contraste ≥ 4.5 (WCAG-AA). Se não, regenerar o slot com falha. Brutalist-experimental exige ≥ 7.0 (AAA).
Saída
Dois artefatos:
- Relatório JSON de contraste com coordenadas OKLch (para
remotion-brand-codifye consumo web da 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 pronto para ser inserido no bloco
colors:deSynthex/packages/brand-config/src/brands/{slug}.design.md— os nomes dos tokens seguem a especificação@google/design.md(minúsculas + traços para nomes de níveis, ex.: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"
Execute npx --prefix Pi-Dev-Ops/remotion-studio design.md lint no .design.md resultante para confirmar zero erros de contraste.
Limites
- Nunca entregar uma paleta com qualquer falha AA — bloquear e solicitar contribuição do fundador sobre o slot problemático.
- Nunca sobrescrever um
darkVariantexplícito definido pela marca. - Nunca usar vermelho como primária a menos que
family === 'consumer'e o nome da marca ancore explicitamente vermelho. - Nunca recorrer a um LLM durante a geração — a função é determinística. Se o determinismo falhar (mesma entrada → saída diferente entre execuções), isso é um bug no gerador, não uma funcionalidade.
- Nunca misturar duas escolas — escolher uma. Misturar o calor de
editorial-monoclecom a ardósia detech-utilityproduz a paleta turva "padrão de IA" com a qual toda marca começa.
Passar para
remotion-brand-codify escreve o resultado em src/brands/{slug}.ts.