{
  "$description": "Brand: Stanford — light mode",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette stanford@1.0.0",
      "cardinal-red": {
        "$value": "#8C1515",
        "$type": "color",
        "$description": "Stanford's institutional cardinal — primary brand colour."
      },
      "cardinal-red-light": {
        "$value": "#B83A4B",
        "$type": "color",
        "$description": "Light tint of Cardinal Red for surface accents."
      },
      "cardinal-red-dark": {
        "$value": "#820000",
        "$type": "color",
        "$description": "Deep Cardinal — pressed / active variant."
      },
      "white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Primary canvas in light mode."
      },
      "black": {
        "$value": "#2E2D29",
        "$type": "color",
        "$description": "Warm near-black — primary text on light surfaces."
      },
      "cool-grey": {
        "$value": "#53565A",
        "$type": "color",
        "$description": "Secondary text / supporting neutral."
      },
      "black-90": {
        "$value": "#43423E",
        "$type": "color",
        "$description": "90% black tint — deep text on lighter surfaces."
      },
      "black-10": {
        "$value": "#EAEAEA",
        "$type": "color",
        "$description": "10% black tint — soft surface / divider."
      },
      "digital-red": {
        "$value": "#B1040E",
        "$type": "color",
        "$description": "Digital accent red — emphasis only, not a replacement for Cardinal."
      },
      "digital-red-light": {
        "$value": "#E50808",
        "$type": "color",
        "$description": "Light digital red — interactive emphasis."
      },
      "digital-red-dark": {
        "$value": "#820000",
        "$type": "color",
        "$description": "Dark digital red — pressed state."
      },
      "digital-blue": {
        "$value": "#006CB8",
        "$type": "color",
        "$description": "Reserved for links on digital surfaces."
      },
      "digital-blue-light": {
        "$value": "#6FC3FF",
        "$type": "color",
        "$description": "Hover / focus link variant."
      },
      "digital-blue-dark": {
        "$value": "#00548F",
        "$type": "color",
        "$description": "Visited / active link variant."
      },
      "digital-green": {
        "$value": "#008566",
        "$type": "color",
        "$description": "Form-validation success."
      },
      "digital-green-light": {
        "$value": "#1AECBA",
        "$type": "color",
        "$description": "Light validation green — confirmation surfaces."
      },
      "digital-green-dark": {
        "$value": "#006F54",
        "$type": "color",
        "$description": "Dark validation green — pressed state."
      }
    },
    "roles": {
      "$description": "Semantic color roles (light mode) mapped to palette swatches",
      "background": {
        "$value": "{color.swatches.white}",
        "$type": "color",
        "$description": "background role → White"
      },
      "surface": {
        "$value": "{color.swatches.black-10}",
        "$type": "color",
        "$description": "surface role → Black 10"
      },
      "surface-elevated": {
        "$value": "{color.swatches.white}",
        "$type": "color",
        "$description": "surface-elevated role → White"
      },
      "text-primary": {
        "$value": "{color.swatches.black}",
        "$type": "color",
        "$description": "text-primary role → Black"
      },
      "text-secondary": {
        "$value": "{color.swatches.cool-grey}",
        "$type": "color",
        "$description": "text-secondary role → Cool Grey"
      },
      "text-tertiary": {
        "$value": "{color.swatches.black-90}",
        "$type": "color",
        "$description": "text-tertiary role → Black 90"
      },
      "primary": {
        "$value": "{color.swatches.cardinal-red}",
        "$type": "color",
        "$description": "primary role → Cardinal Red"
      },
      "primary-hover": {
        "$value": "{color.swatches.cardinal-red-dark}",
        "$type": "color",
        "$description": "primary-hover role → Cardinal Red Dark"
      },
      "accent": {
        "$value": "{color.swatches.digital-red}",
        "$type": "color",
        "$description": "accent role → Digital Red"
      },
      "accent-hover": {
        "$value": "{color.swatches.digital-red-dark}",
        "$type": "color",
        "$description": "accent-hover role → Digital Red Dark"
      },
      "link": {
        "$value": "{color.swatches.digital-blue}",
        "$type": "color",
        "$description": "link role → Digital Blue"
      },
      "link-hover": {
        "$value": "{color.swatches.digital-blue-dark}",
        "$type": "color",
        "$description": "link-hover role → Digital Blue Dark"
      },
      "warning": {
        "$value": "{color.swatches.digital-red}",
        "$type": "color",
        "$description": "warning role → Digital Red"
      },
      "warning-hover": {
        "$value": "{color.swatches.digital-red-dark}",
        "$type": "color",
        "$description": "warning-hover role → Digital Red Dark"
      },
      "error": {
        "$value": "{color.swatches.digital-red}",
        "$type": "color",
        "$description": "error role → Digital Red"
      },
      "success": {
        "$value": "{color.swatches.digital-green}",
        "$type": "color",
        "$description": "success role → Digital Green"
      },
      "border": {
        "$value": "{color.swatches.black-10}",
        "$type": "color",
        "$description": "border role → Black 10"
      },
      "brand-overrides": {
        "$description": "Brand-level role overrides (take precedence over palette role mappings)",
        "identity": {
          "$value": "{color.swatches.white}",
          "$type": "color",
          "$description": "Brand role identity → White"
        },
        "on-identity": {
          "$value": "{color.swatches.black}",
          "$type": "color",
          "$description": "Brand role on-identity → Black"
        },
        "primary": {
          "$value": "{color.swatches.cardinal-red}",
          "$type": "color",
          "$description": "Brand role primary → Cardinal Red"
        },
        "primary-hover": {
          "$value": "{color.swatches.cardinal-red-dark}",
          "$type": "color",
          "$description": "Brand role primary-hover → Cardinal Red Dark"
        },
        "accent": {
          "$value": "{color.swatches.digital-red}",
          "$type": "color",
          "$description": "Brand role accent → Digital Red"
        },
        "accent-hover": {
          "$value": "{color.swatches.digital-red-dark}",
          "$type": "color",
          "$description": "Brand role accent-hover → Digital Red Dark"
        },
        "mark": {
          "$value": "{color.swatches.cardinal-red}",
          "$type": "color",
          "$description": "Brand role mark → Cardinal Red"
        },
        "success": {
          "$value": "{color.swatches.digital-green}",
          "$type": "color",
          "$description": "Brand role success → Digital Green"
        },
        "warning": {
          "$value": "{color.swatches.digital-red}",
          "$type": "color",
          "$description": "Brand role warning → Digital Red"
        },
        "error": {
          "$value": "{color.swatches.digital-red}",
          "$type": "color",
          "$description": "Brand role error → Digital Red"
        },
        "text-primary-light": {
          "$value": "{color.swatches.black}",
          "$type": "color",
          "$description": "Brand role text-primary-light → Black"
        },
        "text-primary-dark": {
          "$value": "{color.swatches.white}",
          "$type": "color",
          "$description": "Brand role text-primary-dark → White"
        },
        "background-light": {
          "$value": "{color.swatches.white}",
          "$type": "color",
          "$description": "Brand role background-light → White"
        },
        "background-dark": {
          "$value": "{color.swatches.black}",
          "$type": "color",
          "$description": "Brand role background-dark → Black"
        },
        "surface-light": {
          "$value": "{color.swatches.black-10}",
          "$type": "color",
          "$description": "Brand role surface-light → Black 10"
        },
        "surface-dark": {
          "$value": "{color.swatches.black-90}",
          "$type": "color",
          "$description": "Brand role surface-dark → Black 90"
        },
        "text-secondary-light": {
          "$value": "{color.swatches.cool-grey}",
          "$type": "color",
          "$description": "Brand role text-secondary-light → Cool Grey"
        },
        "text-tertiary-light": {
          "$value": "{color.swatches.black-90}",
          "$type": "color",
          "$description": "Brand role text-tertiary-light → Black 90"
        },
        "border-light": {
          "$value": "{color.swatches.black-10}",
          "$type": "color",
          "$description": "Brand role border-light → Black 10"
        }
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Source Sans 3",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Source Sans 3 (source-sans-3@1.0.0)"
      },
      "weight": {
        "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"
        },
        "900": {
          "$value": 900,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "body": {
      "family": {
        "$value": [
          "Source Sans 3",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Source Sans 3 (source-sans-3@1.0.0)"
      },
      "weight": {
        "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"
        },
        "900": {
          "$value": 900,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "serif": {
      "family": {
        "$value": [
          "Lora",
          "Iowan Old Style",
          "Apple Garamond",
          "Baskerville",
          "Times New Roman",
          "serif"
        ],
        "$type": "fontFamily",
        "$description": "serif role → Lora (lora@1.0.0)"
      },
      "weight": {
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "500": {
          "$value": 500,
          "$type": "fontWeight"
        },
        "600": {
          "$value": 600,
          "$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"
      }
    }
  }
}