{
  "$meta": {
    "brand": "Metix",
    "version": "3.0",
    "scheme": "Klein Blue",
    "frozen": "2026-Q2",
    "owner": "Founder / Design lead",
    "note": "v3 replaces the earlier teal + serif drafts. Single source of truth for Metix brand tokens. Breaking changes require Founder sign-off."
  },
  "color": {
    "klein": {
      "klein":      { "value": "#002FA7", "role": "IKB · primary brand, heroes, CTAs. white text only" },
      "klein-900":  { "value": "#001E80", "role": "pressed / hover on Klein" },
      "klein-deep": { "value": "#001460", "role": "the void · footer, hero floor" },
      "klein-link": { "value": "#1A54D4", "role": "links on Paper; also success/confirmed" },
      "klein-300":  { "value": "#5E8FE8", "role": "decorative mid, chart fill" },
      "klein-tint": { "value": "#D7E2FB", "role": "tag / pill / tinted surface" },
      "klein-soft": { "value": "#EBF0FD", "role": "subtle wash" }
    },
    "gold": {
      "gold":      { "value": "#C9A84C", "role": "the spark · accent. decorative/large/icon. decorative/large/icon only" },
      "gold-2":    { "value": "#E6C877", "role": "emphasis text on Klein (AAA)" },
      "gold-soft": { "value": "#F8F1DC", "role": "quote ground / hint" }
    },
    "paper": {
      "paper":   { "value": "#F5F6FA", "role": "default page surface · cool off-white, not pure white" },
      "paper-2": { "value": "#E4E8F4", "role": "recessed / dividers" },
      "paper-3": { "value": "#FFFFFF", "role": "card · brightest" }
    },
    "ink": {
      "ink":   { "value": "#11141C", "role": "primary text · never pure black" },
      "ink-2": { "value": "#2A2E3B", "role": "body" },
      "ink-3": { "value": "#5A5D72", "role": "tertiary / meta" },
      "ink-4": { "value": "#A4A7B5", "role": "disabled / placeholder" }
    },
    "line": {
      "line": { "value": "#C7CCDB", "role": "hairline rules · cool grey, modernist" },
      "mist": { "value": "#ECEFF7", "role": "neutral light surface" }
    },
    "semantic": {
      "ok":      { "value": "#1A54D4", "role": "success / confirmed · brand blue, NOT green" },
      "error":   { "value": "#C0392B", "role": "error / destructive, sparingly" },
      "warning": { "value": "#C9A84C", "role": "warning · shares gold" }
    }
  },
  "surfaceBudget": { "klein": 0.45, "paper": 0.35, "ink": 0.13, "gold": 0.05 },
  "contrast": {
    "white-on-klein": { "ratio": "10.7:1", "grade": "AAA" },
    "ink-on-paper":   { "ratio": "16.3:1", "grade": "AAA" },
    "gold2-on-klein": { "ratio": "7.8:1",  "grade": "AAA" },
    "gold-on-paper":  { "ratio": "4.6:1",  "grade": "AA (large)" },
    "gold-on-klein":  { "ratio": "2.6:1",  "grade": "FAIL, decorative only" },
    "ink-on-klein":   { "ratio": "1.9:1",  "grade": "FAIL, white text only on Klein" }
  },
  "radius": { "default": "2px" },
  "type": {
    "families": { "display": "Satoshi", "displaySource": "Fontshare / Indian Type Foundry (free)", "body": "Hanken Grotesk", "mono": "JetBrains Mono", "cjkFallback": "PingFang SC" },
    "rules": { "italic": "never (emphasis = weight + color)", "caps": "eyebrow only, +0.18em" },
    "scale": {
      "display-xl": { "size": 96, "line": 92, "tracking": "-0.045em", "family": "display", "weight": 900 },
      "display-lg": { "size": 64, "line": 61, "tracking": "-0.035em", "family": "display", "weight": 700 },
      "display":    { "size": 44, "line": 44, "tracking": "-0.03em",  "family": "display", "weight": 700 },
      "h1":         { "size": 32, "line": 38, "tracking": "-0.02em",  "family": "body", "weight": 700 },
      "h2":         { "size": 22, "line": 28, "tracking": "-0.01em",  "family": "body", "weight": 600 },
      "lead":       { "size": 19, "line": 29, "tracking": "0", "family": "body", "weight": 400 },
      "body":       { "size": 16, "line": 26, "tracking": "0", "family": "body", "weight": 400 },
      "caption":    { "size": 13, "line": 18, "tracking": "0", "family": "body", "weight": 500 },
      "eyebrow":    { "size": 11, "line": 16, "tracking": "0.18em", "family": "mono", "case": "upper" }
    }
  },
  "motion": { "logoSettle": "200ms gold-diamond scale + fade (only logo motion)", "ease": "cubic-bezier(.2,.6,.2,1)", "reducedMotion": "disable all" },
  "mark": {
    "concept": "an open M in one even-weight line: two strokes rise into rounded shoulders, dip into a valley at centre, then close below into a single rounded bridge; gold kairos diamond at the valley",
    "viewBox": "10 5.375 140 140 (square frame, art centred, vertical symmetry)",
    "stroke": "~1u, round cap and join", "shoulders": "two rounded tops", "valley": "strokes meet at centre",
    "base": "one closed rounded bridge", "goldDiamond": "1.5u, at the valley", "symmetry": "vertical axis",
    "onPaper": "Klein open-M + gold diamond", "onKlein": "white open-M + gold diamond",
    "favicon": "Klein tile + heavier white open-M + enlarged gold diamond (stroke clears 2px at 16px)",
    "minSize": { "digital": "24px (16px mono)", "print": "8mm (5mm mono)" },
    "clearspace": { "unit": "X = gold diamond width", "min": "1.0X", "preferred": "1.5X" }
  }
}