remotion-colour-family
最小限のアンカーから完全なパレットを構築します。remotion-studio/src/colour/index.ts の contrast() ヘルパーを再利用します。
トリガー
- BrandConfig に
secondary、accent、neutral、またはsemanticブロックが欠けている。 - レンダリングがコントラストチェックに失敗した:テキストと背景のペアのコントラスト比が 4.5 未満。
- ユーザーが「{brand} のパレットを拡張して」または「カラーを監査して」と発言した。
入力
- 1~3 つの 16 進カラーアンカー(primary は必須、secondary と accent は任意)
family:restoration|safety|industrial|consumer|trainingschool(任意):editorial-monocle|modern-minimal|warm-soft|tech-utility|brutalist-experimental— ビジュアルスクールのプリセット(オープンデザインの系譜)。ファミリーヒューリスティックが実行される 前に、タイプキャラクター、コントラストバイアス、アクセントの役割を選択します。デフォルト:modern-minimal。- 既存のパレット(拡張時)
メソッド
-
スクールプリセット —
schoolのバイアスを 最初に 適用します。各スクールは色相範囲、明度範囲、ニュートラルの色温度、アクセント彩度を制約します。スクール 色相バイアス 明度バイアス ニュートラル アクセント彩度 参考(ベンダー化) editorial-monocle暖色アース(テラコッタ/クレイ/サンド) 高(パーチメント/アイボリー) 暖色グレーのみ — すべてのグレーが黄褐色のアンダートーンを持つ 1つのクロマチックアクセント、深くアース調 _library/claude/、_library/monocle/(存在する場合)modern-minimalクールニュートラル(スレート/ブルーグレー) バランス 純粋グレー 1つのエレクトリックアクセント、ビューポートあたり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 色空間で作業し、色相回転が知覚明度を維持するようにします。16 進アンカーを最初に OKLch に変換し、色相を ±30°/±60° 回転させながら、明度をスクールのバンド内にクランプします。
BrandConfigストレージ用に出力を 16 進に戻します。コントラストレポートにはoklchの兄弟フィールドを保持し、下流の Tailwind-4 コンシューマー(フェーズ 2)に対応します。 -
決定論 — 同じ
(primary, family, school)の 3 つ組は、実行ごとに常に同じ出力パレットを生成しなければなりません。ランダム性、温度、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)が必要です。
出力
2 つのアーティファクト:
- JSON コントラストレポート(OKLch 座標付き、
remotion-brand-codifyおよびフェーズ 2 の Web 消費向け):
{
"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 を使用しないでください — 関数は決定論的です。決定論が破綻した場合(同じ入力で実行ごとに異なる出力)、それはジェネレーターのバグであり、機能ではありません。
- 2 つのスクールを決して混ぜないでください。1 つを選んでください。
editorial-monocleの暖かさとtech-utilityのスレートを混ぜると、すべてのブランドが最初に持つ濁った「AI デフォルト」パレットが生成されます。
引き継ぎ先
remotion-brand-codify が結果を src/brands/{slug}.ts に書き込みます。