{
  "$description": "Brand: Oxford (oxford@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette oxford@1.0.0",
      "oxford-blue": {
        "$value": "#002147",
        "$type": "color",
        "$description": "The institutional Oxford Blue (Pantone 282) — primary brand colour."
      },
      "white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Primary canvas in light mode."
      },
      "oxford-off-white": {
        "$value": "#F2F0F0",
        "$type": "color",
        "$description": "Warm off-white — soft canvas tint."
      },
      "oxford-ash-grey": {
        "$value": "#61615F",
        "$type": "color",
        "$description": "Mid-deep neutral — body text on light surfaces."
      },
      "oxford-umber": {
        "$value": "#89827A",
        "$type": "color",
        "$description": "Warm mid-neutral — secondary text."
      },
      "oxford-stone-grey": {
        "$value": "#D9D8D6",
        "$type": "color",
        "$description": "Soft warm grey — border / divider."
      },
      "oxford-shell-grey": {
        "$value": "#F1EEE9",
        "$type": "color",
        "$description": "Lightest warm neutral — surface tint."
      },
      "oxford-charcoal": {
        "$value": "#211D1C",
        "$type": "color",
        "$description": "Near-black — primary text on light canvas."
      },
      "oxford-cerulean-blue": {
        "$value": "#49B6FF",
        "$type": "color",
        "$description": "Bright sky-cerulean — digital accent."
      },
      "oxford-lemon-yellow": {
        "$value": "#F7EF66",
        "$type": "color",
        "$description": "Pale lemon — editorial highlight / warning."
      },
      "oxford-mauve": {
        "$value": "#776885",
        "$type": "color",
        "$description": "Muted mauve — editorial accent."
      },
      "oxford-peach": {
        "$value": "#E08D79",
        "$type": "color",
        "$description": "Warm peach — soft accent."
      },
      "oxford-potters-pink": {
        "$value": "#ED9390",
        "$type": "color",
        "$description": "Heritage pink — editorial accent."
      },
      "oxford-dusk": {
        "$value": "#C4A29E",
        "$type": "color",
        "$description": "Muted dusk — soft warm accent."
      },
      "oxford-lilac": {
        "$value": "#D1BDD5",
        "$type": "color",
        "$description": "Pale lilac — illustration tint."
      },
      "oxford-sienna": {
        "$value": "#994636",
        "$type": "color",
        "$description": "Deep sienna — heritage accent."
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Inter",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Inter (inter@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"
        },
        "900": {
          "$value": 900,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "body": {
      "family": {
        "$value": [
          "Inter",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Inter (inter@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"
        },
        "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": "Oxford Blue (#002147 — Pantone 282) is the institutional colour and the only swatch authorized to act as the primary brand anchor. The Oxford brand guidelines describe the blue as the colour \"recognised worldwide as our identifying colour\" — the secondary palette supports but never substitutes for it.\n",
        "allowed": [
          "oxford-blue"
        ],
        "forbidden": [
          "oxford-cerulean-blue",
          "oxford-lemon-yellow",
          "oxford-mauve",
          "oxford-peach",
          "oxford-potters-pink",
          "oxford-dusk",
          "oxford-lilac",
          "oxford-sienna"
        ]
      },
      {
        "type": "colorChoice",
        "target": "roles.colors.mark",
        "severity": "error",
        "rationale": "The Oxford coat of arms and belted-crest mark are reproduced in Oxford Blue, near-black Oxford Charcoal, or reversed in white only. Secondary palette colours MUST NOT be used to colorize the institutional mark.\n",
        "allowed": [
          "oxford-blue",
          "oxford-charcoal",
          "white"
        ],
        "forbidden": [
          "oxford-cerulean-blue",
          "oxford-sienna",
          "oxford-potters-pink",
          "oxford-mauve",
          "oxford-peach"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "Oxford Charcoal (#211D1C) on white gives ~17:1 — clears AAA decisively. The University's scholarly long-form posture, statutory obligations under the UK Equality Act, and the publishing weight of ox.ac.uk justify the enhanced 7:1 floor rather than the AA 4.5:1 minimum.\n",
        "against": "background",
        "minRatio": 7,
        "standard": "WCAG-AAA"
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "Oxford's brand guidelines prohibit stretching, rotating, recolouring, outlining, applying drop-shadow or gradient fills, or placing the coat of arms or belted-crest mark on busy photographic backgrounds. Marks render in approved colourways only with documented clear-space.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "outlined",
          "gradient-fill",
          "on-busy-photo",
          "tilted",
          "cropped"
        ]
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "warning",
        "rationale": "The Oxford editorial type ramp uses Regular (400), Medium (500), SemiBold (600), and Bold (700) across surfaces. Heavier display cuts (800/900) are not part of the documented institutional ramp.\n",
        "allowed": [
          "400",
          "500",
          "600",
          "700"
        ]
      },
      {
        "type": "fontPairing",
        "target": "typography.display",
        "severity": "error",
        "rationale": "Oxford's editorial hierarchy pairs a large display sans (or its serif companion) with body text at a minimum 1.5× ratio. The University's scholarly voice depends on that explicit gap between display and prose; flattening below 1.5× breaks the typographic hierarchy.\n",
        "requires": "prose",
        "minSizeRatio": 1.5
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "warning",
        "rationale": "WCAG 2.1 Success Criterion 1.4.6 (Contrast Enhanced) — Level AAA. Oxford's scholarly posture and obligations under the UK Equality Act to a diverse academic and public audience justify the enhanced 7:1 target on core text-on-background pairs.\n",
        "standard": "WCAG-AAA",
        "criterion": "1.4.6"
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.warning",
        "severity": "error",
        "rationale": "Oxford Lemon Yellow (#F7EF66) is the pale editorial highlight in the secondary palette. Using it for hard errors or confirmation states is inconsistent with its documented soft-emphasis role.\n",
        "allowedContexts": [
          "warning-state",
          "highlight",
          "editorial-emphasis"
        ],
        "forbiddenContexts": [
          "error-state",
          "destructive-action",
          "confirmation"
        ]
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.primary",
        "severity": "recommendation",
        "rationale": "Oxford Blue reads cleanest on white, the warm Oxford off white / shell grey, or against the near-black Oxford Charcoal. Adjacent to the muted warm pinks (potter's pink, peach, dusk) the institutional blue loses the calm authority the heritage colour is designed to project.\n",
        "pairsWith": [
          "white",
          "oxford-off-white",
          "oxford-shell-grey",
          "oxford-charcoal"
        ],
        "doesNotPairWith": [
          "oxford-potters-pink",
          "oxford-peach",
          "oxford-dusk"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://www.ox.ac.uk/about/the-university/brand/guidelines",
      "license": "Proprietary — All Rights Reserved (Oxford trademarks)",
      "attribution": "The Chancellor, Masters, and Scholars of the University of Oxford — visual identity captured from the University of Oxford brand guidelines page on ox.ac.uk. \"Oxford,\" \"University of Oxford,\" the Oxford coat of arms, and the belted-crest mark are protected marks of the University of Oxford.\n",
      "importedDate": "2026-05-19",
      "notes": "The University publishes a proprietary type family (Foundry Sterling and a paired serif) for institutional use. This atom references inter@1 as the open-source sans substitute, lora@1 as the serif substitute (a humanist serif consistent with Oxford's traditional voice), and jetbrainsmono-nerdfont@1 for code. The proprietary faces are not publicly distributed and assets are kept empty per trademark policy. Oxford Blue is documented as Pantone 282 across the central University brand guidance; the Wikipedia Oxford Blue entry corroborates #002147 as the hex equivalent. Scoped to the parent University only — the constituent colleges (Christ Church, Magdalen, Balliol, etc.) and the Oxford University Press identity are out of scope and have their own brand systems.\n"
    },
    "com.brand-atoms.references": {
      "palette": "oxford@1.0.0",
      "fonts": {
        "heading": "inter@1.0.0",
        "body": "inter@1.0.0",
        "serif": "lora@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}
