remotion-colour-family
최소 앵커로 완전한 팔레트를 구축합니다. remotion-studio/src/colour/index.ts의 contrast() 헬퍼를 재사용합니다.
트리거
- BrandConfig에
secondary,accent,neutral또는semantic블록이 누락된 경우. - 렌더링이 대비 검사에 실패한 경우: 텍스트-배경 쌍의 비율이 4.5 미만.
- 사용자가 "{brand}의 팔레트를 확장해줘" 또는 "색상을 감사해줘"라고 말한 경우.
입력
- 1~3개의 헥스 앵커 (primary 필수; secondary, accent 선택)
family:restoration|safety|industrial|consumer|trainingschool(선택):editorial-monocle|modern-minimal|warm-soft|tech-utility|brutalist-experimental— 비주얼 스쿨 프리셋 (오픈 디자인 계열). family 휴리스틱이 실행되기 전에 타입 특성, 대비 편향, 강조 역할을 선택합니다. 기본값:modern-minimal.- 기존 팔레트 (확장하는 경우)
방법
-
학교 프리셋 —
school편향을 먼저 적용합니다. 각 학교는 색조 범위, 명도 범위, 중립색 온도, 강조 채도를 제한합니다:학교 색조 편향 명도 편향 중립색 강조 채도 참고 (벤더됨) editorial-monocle따뜻한 흙색 (테라코타/진흙/모래) 높음 (양피지/아이보리) 따뜻한 회색만 — 모든 회색은 황갈색 언더톤을 지님 하나의 채도 강조, 깊이 있는 흙빛 _library/claude/,_library/monocle/(존재하는 경우)modern-minimal차가운 중성 (슬레이트/청회색) 균형 잡힘 진정한 회색 하나의 전기 강조, 뷰포트당 3회 미만 사용 _library/airbnb/,_library/cal/warm-soft따뜻한 파스텔 (복숭아/발그레/크림) 높음 따뜻한 회색 + 크림 틴트 낮은 채도의 장미/산호 _library/airtable/,_library/cafe/tech-utility남색 / 시안 / 슬레이트 낮음 (어두운 표면 선호) 슬레이트-900 방향의 차가운 회색 시안 신호 강조, 델타/상태에만 사용 _library/binance/,_library/arc/brutalist-experimental원시 흰색 위의 고대비 기본색 극단적 높음 + 극단적 어두움 순수 검정/흰색만 날카로운 네온, 적극적으로 사용 _library/brutalism/,_library/bold/ -
군 휴리스틱 — 학교 이후에 적용됩니다. 군은 표준 인접 색상을 제공합니다:
safety: 네이비 + 비상 주황 + 아이보리restoration: 청록 + 슬레이트 + 라임industrial: 흑연 + 강철 + 호박색consumer: 히어로 레드/블루 + 따뜻한 흰색 + 슬레이트training: 테라코타 + 크림 + 잉크
-
OKLch로 생성 — HSL이 아닌 OKLch 색 공간에서 작업하여 색조 회전이 인지된 명도를 보존합니다. 헥스 앵커를 먼저 OKLch로 변환하고, 학교의 명도 대역 내로 명도를 고정하면서 색조를 ±30°/±60° 회전합니다. 출력은
BrandConfig저장을 위해 헥스로 변환합니다. 대비 보고서에oklch형제 필드를 유지하여 다운스트림 Tailwind-4 소비자(2단계)를 지원합니다. -
결정론 — 동일한
(primary, family, school)트리플은 실행 간에 항상 동일한 출력 팔레트를 생성해야 합니다. 무작위성 없음, 온도 없음, LLM 보간 없음. 생성기는 입력의 순수 함수입니다. -
중립색 구축 —
oklch(99% 0 hue)(50)과oklch(15% 0 hue)(900) 사이를 보간하고, 학교 편향에 따라chroma를 기본색 색조 방향으로 기울입니다 (warm-soft는 중립색을 따뜻하게, tech-utility는 차갑게). -
의미 색상 구축 — 기본색과 충돌하지 않는 고정 풀에서
success/warning/danger를 선택합니다. -
다크 변형 구축 — 중립색을 반전(
50 ↔ 900명도)하고 기본색을 OKLch 공간에서 8% 명도를 올립니다. -
검증 — 각 쌍
(primary, neutral.50),(primary, neutral.900),(secondary, neutral.50),(accent, secondary)에 대해 대비 ≥ 4.5 (WCAG-AA)를 확인합니다. 실패하면 해당 슬롯을 재생성합니다. Brutalist-experimental은 ≥ 7.0 (AAA)이 필요합니다.
출력
두 가지 산출물:
- JSON 대비 보고서 — OKLch 좌표 포함 (
remotion-brand-codify및 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": []
}
- YAML 조각 —
Synthex/packages/brand-config/src/brands/{slug}.design.md의colors:블록에 바로 넣을 수 있습니다. 토큰 이름은@google/design.md사양을 따릅니다 (계층 이름은 소문자 + 대시, 예: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"
결과 .design.md 파일에 대해 npx --prefix Pi-Dev-Ops/remotion-studio design.md lint를 실행하여 대비 오류가 없음을 확인하세요.
경계
- AA 실패가 있는 팔레트를 절대 제공하지 마세요 — 실패한 슬롯을 차단하고 설립자 입력을 요청하세요.
- 브랜드가 설정한 명시적
darkVariant를 절대 재정의하지 마세요. family === 'consumer'이고 브랜드 이름이 명시적으로 빨간색을 고정하지 않는 한, 빨간색을 기본색으로 사용하지 마세요.- 생성 중에 LLM을 사용하지 마세요 — 함수는 결정론적입니다. 결정론이 실패하면(동일한 입력 → 실행 간 다른 출력), 이는 기능이 아닌 생성기의 버그입니다.
- 두 학교를 혼합하지 마세요 — 하나를 선택하세요.
editorial-monocle의 따뜻함과tech-utility의 슬레이트를 혼합하면 모든 브랜드가 시작하는 진흙탕 "AI 기본" 팔레트가 생성됩니다.
인계
remotion-brand-codify가 결과를 src/brands/{slug}.ts에 씁니다.