#!/usr/bin/env python3 """ Generate per-page OG images for RankWizAI marketing routes. Editorial-product / operator's-tool template: - Pure white background - 1px slate-200 hairline rules top and bottom (real dividers, not decoration) - Brand chrome top-left (icon + wordmark), mono route slug top-right - Asymmetric headline: large editorial sans, left-aligned, single emphasis - Supporting clause beneath in slate-500 - Bottom chrome: rankwizai.com (mono, left), brand line (mono, right) - 4px brand-purple accent rule at the bottom edge Each page entry produces /public/og/og-{slug}-v2.svg and /public/og/og-{slug}-v2.png. PNG is the file referenced from Inertia ; SVG is kept as a versionable master. Usage: python3 scripts/branding/generate_og_images.py """ from __future__ import annotations import json import shutil import subprocess import sys from html import escape from pathlib import Path import cairosvg REPO_ROOT = Path(__file__).resolve().parents[2] PUBLIC_DIR = REPO_ROOT / "public" OG_DIR = PUBLIC_DIR / "og" CROWN_SPEC_PATH = REPO_ROOT / "resources" / "branding" / "crown.json" def load_crown_spec() -> dict: """ Load the canonical crown geometry + color tokens from resources/branding/crown.json — the same file consumed by Logo.tsx and OgImageRenderer.php. Single source of truth across all three implementations. """ with CROWN_SPEC_PATH.open(encoding="utf-8") as f: return json.load(f) CROWN = load_crown_spec() def preflight_fonts() -> None: """ Verify Inter + JetBrains Mono are discoverable by fontconfig before we render anything. Without these, cairosvg silently falls back to Lato + DejaVu Sans Mono — visually similar but not pixel-equivalent. The drift only shows up when comparing OG cards across CI vs local renders, which is exactly the kind of bug nobody catches until production. On miss: print clear remediation instructions and exit non-zero so CI fails loudly rather than shipping fonts-mismatched cards. """ if shutil.which("fc-match") is None: # No fontconfig — non-Linux dev machines. Skip the check; the # generator still works (renders with whatever's available). return required = { "Inter:weight=800": "Inter", "JetBrains Mono": "JetBrainsMono", } missing: list[str] = [] for query, expected_substring in required.items(): result = subprocess.run( ["fc-match", query], capture_output=True, text=True, check=False, ) if expected_substring.lower() not in result.stdout.lower(): missing.append(f" - {query!r} → got {result.stdout.strip() or '(nothing)'}") if missing: print( "ERROR: required fonts missing — OG images would render with the wrong typography.\n" "Missing:\n" + "\n".join(missing) + "\n\n" "Install (Linux):\n" " mkdir -p ~/.local/share/fonts/inter\n" " # drop Inter-{Regular,Medium,SemiBold,Bold,ExtraBold,Black}.ttf and\n" " # JetBrainsMono-{Regular,Bold}.ttf into that directory, then:\n" " fc-cache -f ~/.local/share/fonts/\n" "\n" "On macOS: install via Homebrew (`brew install --cask font-inter font-jetbrains-mono`)\n" "or drop the .ttf files into ~/Library/Fonts/.\n", file=sys.stderr, ) sys.exit(1) # ── Brand tokens (sourced from resources/branding/crown.json) ── PURPLE = CROWN["colors"]["purple"] PURPLE_DEEP = CROWN["colors"]["purpleDeep"] AMBER = CROWN["colors"]["amber"] SLATE_900 = CROWN["colors"]["slate900"] SLATE_500 = CROWN["colors"]["slate500"] SLATE_200 = CROWN["colors"]["slate200"] WHITE = CROWN["colors"]["white"] def crown_svg_group(*, body: str, band: str, gem: str, sparkle: str) -> str: """ Inline crown markup (no