{
  "$description": "Brand: Stanford (stanford@1.0.0)",
  "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."
      }
    }
  },
  "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"
      }
    }
  },
  "$extensions": {
    "com.brand-atoms.rules": [
      {
        "type": "colorChoice",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "Cardinal Red (#8C1515) is Stanford's institutional colour. The Stanford Identity Guide is explicit that Digital Red \"is not a replacement for Cardinal red\" and that Digital Blue and Digital Green are role-restricted (links and form validation). The primary brand colour role MUST be Cardinal — no exceptions.\n",
        "allowed": [
          "cardinal-red",
          "cardinal-red-dark"
        ],
        "forbidden": [
          "digital-red",
          "digital-red-light",
          "digital-blue",
          "digital-green"
        ]
      },
      {
        "type": "colorChoice",
        "target": "roles.colors.mark",
        "severity": "error",
        "rationale": "The Stanford wordmark, block-S, and tree mark are reproduced in Cardinal Red, solid black, or solid white (reversed). Digital Red MUST NOT be used to colorize the Stanford wordmark per the published guidance.\n",
        "allowed": [
          "cardinal-red",
          "black",
          "white"
        ],
        "forbidden": [
          "digital-red",
          "digital-red-light",
          "digital-blue",
          "cardinal-red-light"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "Stanford Black (#2E2D29) on white gives ~14:1 — clears AAA. As a research university with extensive long-form scholarly content and obligations under ADA / Section 504, Stanford's surfaces target the enhanced 7:1 floor rather than the AA 4.5:1 minimum.\n",
        "against": "background",
        "minRatio": 7,
        "standard": "WCAG-AAA"
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.link",
        "severity": "error",
        "rationale": "The Identity Guide reserves Digital Blue (#006CB8) \"exclusively for links\" on digital communications. Repurposing it for confirmation, error, or data-viz roles breaks the link-affordance contract Stanford visitors rely on.\n",
        "allowedContexts": [
          "link",
          "navigation"
        ],
        "forbiddenContexts": [
          "error-state",
          "confirmation",
          "destructive-action",
          "data-viz-positive"
        ]
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.success",
        "severity": "error",
        "rationale": "Digital Green (#008566) is documented as the form-validation colour. Using it for errors or as a link colour inverts the semantics the Identity Guide assigns it.\n",
        "allowedContexts": [
          "confirmation",
          "completion",
          "form-validation",
          "data-viz-positive"
        ],
        "forbiddenContexts": [
          "error-state",
          "destructive-action",
          "link"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "Stanford's brand standards prohibit stretching, rotating, recolouring, outlining, or applying decorative treatments to the wordmark, block-S, or tree. Marks render in solid Cardinal Red, solid black, or solid white only, with documented clear-space.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "outlined",
          "gradient-fill",
          "on-busy-photo",
          "tilted"
        ]
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "warning",
        "rationale": "Stanford's Identity Guide type ramp anchors on Regular (400), SemiBold (600), and Bold (700) for headings and body. Heavier display cuts (800/900) are not part of the published institutional ramp.\n",
        "allowed": [
          "400",
          "600",
          "700"
        ]
      },
      {
        "type": "fontPairing",
        "target": "typography.display",
        "severity": "error",
        "rationale": "Stanford's editorial hierarchy pairs a large display sans with body sans at a minimum 1.5× ratio. The Identity Guide depends on that gap for the legible scholarly voice the institution projects.\n",
        "requires": "prose",
        "minSizeRatio": 1.5
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "warning",
        "rationale": "WCAG 2.1 Success Criterion 1.4.6 (Contrast Enhanced) — Level AAA. Stanford's research / scholarly posture and its obligations to a diverse academic community justify the enhanced 7:1 target on core text-on-background pairs.\n",
        "standard": "WCAG-AAA",
        "criterion": "1.4.6"
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.primary",
        "severity": "recommendation",
        "rationale": "Cardinal Red reads cleanest on white, soft black-tint surfaces, or against the warm institutional black. Adjacent to Digital Red or the light Cardinal tint, the two reds vibrate without resolving into hierarchy — and the Identity Guide treats their roles as semantically distinct.\n",
        "pairsWith": [
          "white",
          "black-10",
          "black"
        ],
        "doesNotPairWith": [
          "digital-red",
          "digital-red-light",
          "cardinal-red-light"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://identity.stanford.edu/design-elements/color/primary-colors/",
      "license": "Proprietary — All Rights Reserved (Stanford trademarks)",
      "attribution": "The Board of Trustees of The Leland Stanford Junior University — visual identity captured from the Stanford Identity Guide (identity.stanford.edu). \"Stanford,\" the Stanford block-S, the Stanford wordmark, and the Stanford tree are registered trademarks of the Board of Trustees.\n",
      "importedDate": "2026-05-19",
      "notes": "Stanford ships a proprietary type system anchored on Source Sans 3 and Source Serif 4 (both open-source) for digital surfaces. This atom references inter@1 as the sans surrogate where Source Sans is not the chosen substitute, source-serif-4@1 is unavailable in catalogue so lora@1 is used as the serif substitute, and jetbrainsmono-nerdfont@1 for code. The Identity Guide is explicit that Digital Red is \"not a replacement for Cardinal Red\" and that Digital Blue is reserved for links. Assets are kept empty per trademark policy.\n"
    },
    "com.brand-atoms.references": {
      "palette": "stanford@1.0.0",
      "fonts": {
        "heading": "source-sans-3@1.0.0",
        "body": "source-sans-3@1.0.0",
        "serif": "lora@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}