{
  "$description": "Brand: HEY — light mode",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette hey@1.0.0",
      "hey-yellow": {
        "$value": "#FFFF00",
        "$type": "color",
        "$description": "The defining HEY accent — a pure CSS-yellow used as a highlight throughout the product (think text-marker / \"Screener\" highlight bar). Loud by design.\n"
      },
      "hey-blue": {
        "$value": "#0088CC",
        "$type": "color",
        "$description": "The action blue captured from hey.com — used for links, primary buttons, and active-state affordance.\n"
      },
      "hey-blue-hover": {
        "$value": "#1A8AD5",
        "$type": "color",
        "$description": "Slightly brighter hover variant."
      },
      "hey-blue-active": {
        "$value": "#176BAD",
        "$type": "color",
        "$description": "Pressed / active blue."
      },
      "hey-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Page canvas — pure white, no warm tint."
      },
      "hey-near-white": {
        "$value": "#FCFCFC",
        "$type": "color",
        "$description": "Subtle elevated surface."
      },
      "hey-grey-100": {
        "$value": "#F5F5F5",
        "$type": "color",
        "$description": "Hairline panel background."
      },
      "hey-grey-300": {
        "$value": "#DDDDDD",
        "$type": "color",
        "$description": "Border and divider on light surfaces."
      },
      "hey-grey-500": {
        "$value": "#888888",
        "$type": "color",
        "$description": "Tertiary text / inactive icon."
      },
      "hey-grey-700": {
        "$value": "#555555",
        "$type": "color",
        "$description": "Secondary text."
      },
      "hey-text": {
        "$value": "#333333",
        "$type": "color",
        "$description": "Body text on white canvas."
      },
      "hey-heading": {
        "$value": "#222222",
        "$type": "color",
        "$description": "Heading and emphasis text on white."
      },
      "hey-near-black": {
        "$value": "#1E1E1E",
        "$type": "color",
        "$description": "Deepest ink for high-contrast type and dark-mode canvas."
      },
      "hey-success": {
        "$value": "#3C763D",
        "$type": "color",
        "$description": "Confirmation green — Bootstrap success-text heritage."
      },
      "hey-success-bg": {
        "$value": "#DFF0D8",
        "$type": "color",
        "$description": "Success-state surface tint."
      },
      "hey-error": {
        "$value": "#A94442",
        "$type": "color",
        "$description": "Error red — Bootstrap danger-text heritage."
      },
      "hey-error-bg": {
        "$value": "#F2DEDE",
        "$type": "color",
        "$description": "Error-state surface tint."
      },
      "hey-warning": {
        "$value": "#8A6D3B",
        "$type": "color",
        "$description": "Warning amber."
      },
      "hey-warning-bg": {
        "$value": "#FCF8E3",
        "$type": "color",
        "$description": "Warning-state surface tint."
      }
    },
    "roles": {
      "$description": "Semantic color roles (light mode) mapped to palette swatches",
      "background": {
        "$value": "{color.swatches.hey-white}",
        "$type": "color",
        "$description": "background role → HEY White"
      },
      "surface": {
        "$value": "{color.swatches.hey-grey-100}",
        "$type": "color",
        "$description": "surface role → HEY Grey 100"
      },
      "surface-elevated": {
        "$value": "{color.swatches.hey-near-white}",
        "$type": "color",
        "$description": "surface-elevated role → HEY Near White"
      },
      "text-primary": {
        "$value": "{color.swatches.hey-text}",
        "$type": "color",
        "$description": "text-primary role → HEY Text"
      },
      "text-secondary": {
        "$value": "{color.swatches.hey-grey-700}",
        "$type": "color",
        "$description": "text-secondary role → HEY Grey 700"
      },
      "text-tertiary": {
        "$value": "{color.swatches.hey-grey-500}",
        "$type": "color",
        "$description": "text-tertiary role → HEY Grey 500"
      },
      "primary": {
        "$value": "{color.swatches.hey-blue}",
        "$type": "color",
        "$description": "primary role → HEY Blue"
      },
      "primary-hover": {
        "$value": "{color.swatches.hey-blue-hover}",
        "$type": "color",
        "$description": "primary-hover role → HEY Blue Hover"
      },
      "accent": {
        "$value": "{color.swatches.hey-yellow}",
        "$type": "color",
        "$description": "accent role → HEY Yellow"
      },
      "accent-hover": {
        "$value": "{color.swatches.hey-yellow}",
        "$type": "color",
        "$description": "accent-hover role → HEY Yellow"
      },
      "warning": {
        "$value": "{color.swatches.hey-warning}",
        "$type": "color",
        "$description": "warning role → HEY Warning"
      },
      "warning-hover": {
        "$value": "{color.swatches.hey-warning}",
        "$type": "color",
        "$description": "warning-hover role → HEY Warning"
      },
      "error": {
        "$value": "{color.swatches.hey-error}",
        "$type": "color",
        "$description": "error role → HEY Error"
      },
      "success": {
        "$value": "{color.swatches.hey-success}",
        "$type": "color",
        "$description": "success role → HEY Success"
      },
      "border": {
        "$value": "{color.swatches.hey-grey-300}",
        "$type": "color",
        "$description": "border role → HEY Grey 300"
      },
      "brand-overrides": {
        "$description": "Brand-level role overrides (take precedence over palette role mappings)",
        "identity": {
          "$value": "{color.swatches.hey-white}",
          "$type": "color",
          "$description": "Brand role identity → HEY White"
        },
        "on-identity": {
          "$value": "{color.swatches.hey-heading}",
          "$type": "color",
          "$description": "Brand role on-identity → HEY Heading"
        },
        "primary": {
          "$value": "{color.swatches.hey-blue}",
          "$type": "color",
          "$description": "Brand role primary → HEY Blue"
        },
        "primary-hover": {
          "$value": "{color.swatches.hey-blue-hover}",
          "$type": "color",
          "$description": "Brand role primary-hover → HEY Blue Hover"
        },
        "accent": {
          "$value": "{color.swatches.hey-yellow}",
          "$type": "color",
          "$description": "Brand role accent → HEY Yellow"
        },
        "accent-hover": {
          "$value": "{color.swatches.hey-yellow}",
          "$type": "color",
          "$description": "Brand role accent-hover → HEY Yellow"
        },
        "mark": {
          "$value": "{color.swatches.hey-heading}",
          "$type": "color",
          "$description": "Brand role mark → HEY Heading"
        },
        "highlight": {
          "$value": "{color.swatches.hey-yellow}",
          "$type": "color",
          "$description": "Brand role highlight → HEY Yellow"
        },
        "success": {
          "$value": "{color.swatches.hey-success}",
          "$type": "color",
          "$description": "Brand role success → HEY Success"
        },
        "warning": {
          "$value": "{color.swatches.hey-warning}",
          "$type": "color",
          "$description": "Brand role warning → HEY Warning"
        },
        "error": {
          "$value": "{color.swatches.hey-error}",
          "$type": "color",
          "$description": "Brand role error → HEY Error"
        },
        "background": {
          "$value": "{color.swatches.hey-white}",
          "$type": "color",
          "$description": "Brand role background → HEY White"
        },
        "surface": {
          "$value": "{color.swatches.hey-grey-100}",
          "$type": "color",
          "$description": "Brand role surface → HEY Grey 100"
        },
        "text-primary": {
          "$value": "{color.swatches.hey-text}",
          "$type": "color",
          "$description": "Brand role text-primary → HEY Text"
        },
        "text-secondary": {
          "$value": "{color.swatches.hey-grey-700}",
          "$type": "color",
          "$description": "Brand role text-secondary → HEY Grey 700"
        }
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Helvetica Neue",
          "Helvetica",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Helvetica Neue (helvetica-neue@1.0.0)"
      },
      "weight": {
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "body": {
      "family": {
        "$value": [
          "Helvetica Neue",
          "Helvetica",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Helvetica Neue (helvetica-neue@1.0.0)"
      },
      "weight": {
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "mono": {
      "family": {
        "$value": [
          "JetBrainsMono Nerd Font",
          "JetBrains Mono",
          "Fira Code",
          "Menlo",
          "Monaco",
          "Consolas",
          "Liberation Mono",
          "monospace"
        ],
        "$type": "fontFamily",
        "$description": "mono role → JetBrainsMono Nerd Font (jetbrainsmono-nerdfont@1.0.0)"
      },
      "weight": {
        "100": {
          "$value": 100,
          "$type": "fontWeight"
        },
        "200": {
          "$value": 200,
          "$type": "fontWeight"
        },
        "300": {
          "$value": 300,
          "$type": "fontWeight"
        },
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "600": {
          "$value": 600,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "800": {
          "$value": 800,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    }
  }
}