{
  "$description": "Brand: Microsoft (microsoft@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette microsoft@1.0.0",
      "microsoft-red": {
        "$value": "#F25022",
        "$type": "color",
        "$description": "Top-left quadrant of the Microsoft four-square logo. Used for Office, PowerPoint, and the warm corner of the corporate mark.\n"
      },
      "microsoft-green": {
        "$value": "#7FBA00",
        "$type": "color",
        "$description": "Top-right quadrant. Associated with Excel and the productivity side of the brand. (Sometimes also documented as #7CBB00.)\n"
      },
      "microsoft-blue": {
        "$value": "#00A4EF",
        "$type": "color",
        "$description": "Bottom-left quadrant of the logo — Windows blue, lighter than the Communications primary.\n"
      },
      "microsoft-yellow": {
        "$value": "#FFB900",
        "$type": "color",
        "$description": "Bottom-right quadrant. Often associated with Microsoft Build / developer surfaces.\n"
      },
      "communications-blue": {
        "$value": "#0078D4",
        "$type": "color",
        "$description": "Microsoft's primary communications blue — the Fluent system primary used across Microsoft 365, the corporate site, and product UI chrome.\n"
      },
      "microsoft-black": {
        "$value": "#000000",
        "$type": "color",
        "$description": "Wordmark fill and primary text on light backgrounds."
      },
      "microsoft-near-black": {
        "$value": "#1F1F1F",
        "$type": "color",
        "$description": "Softer near-black for body text and dark surfaces."
      },
      "microsoft-gray-160": {
        "$value": "#605E5C",
        "$type": "color",
        "$description": "Secondary text and inactive UI (Fluent Neutral Foreground 2)."
      },
      "microsoft-gray-130": {
        "$value": "#8A8886",
        "$type": "color",
        "$description": "Tertiary text and dividers (Fluent Neutral Foreground 3)."
      },
      "microsoft-gray-30": {
        "$value": "#EDEBE9",
        "$type": "color",
        "$description": "Subtle surface tint (Fluent Neutral Background 3)."
      },
      "microsoft-gray-20": {
        "$value": "#F3F2F1",
        "$type": "color",
        "$description": "Page-level background (Fluent Neutral Background 2)."
      },
      "microsoft-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Base background and reversed text on chromatic surfaces."
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Segoe UI",
          "system-ui",
          "Inter",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Segoe UI (segoe-ui@1.0.0)"
      },
      "weight": {
        "300": {
          "$value": 300,
          "$type": "fontWeight"
        },
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "600": {
          "$value": 600,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "body": {
      "family": {
        "$value": [
          "Segoe UI",
          "system-ui",
          "Inter",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Segoe UI (segoe-ui@1.0.0)"
      },
      "weight": {
        "300": {
          "$value": 300,
          "$type": "fontWeight"
        },
        "400": {
          "$value": 400,
          "$type": "fontWeight"
        },
        "600": {
          "$value": 600,
          "$type": "fontWeight"
        },
        "700": {
          "$value": 700,
          "$type": "fontWeight"
        },
        "$description": "Available font weights"
      }
    },
    "mono": {
      "family": {
        "$value": [
          "CaskaydiaCove Nerd Font",
          "Cascadia Code",
          "JetBrains Mono",
          "Menlo",
          "Monaco",
          "Consolas",
          "Liberation Mono",
          "monospace"
        ],
        "$type": "fontFamily",
        "$description": "mono role → CascadiaCode Nerd Font (cascadiacode-nerdfont@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"
        },
        "$description": "Available font weights"
      }
    }
  },
  "$extensions": {
    "com.brand-atoms.rules": [
      {
        "type": "colorChoice",
        "target": "logo.quadrants",
        "severity": "error",
        "rationale": "The Microsoft four-square logo uses the canonical quadrant hues (#F25022, #7FBA00, #00A4EF, #FFB900). Communications Blue (#0078D4) is the Fluent system primary for UI chrome, not a logo fill.\n",
        "allowed": [
          "microsoft-red",
          "microsoft-green",
          "microsoft-blue",
          "microsoft-yellow"
        ],
        "forbidden": [
          "communications-blue"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "Microsoft's brand guidelines explicitly prohibit altering the proportions, colors, or arrangement of the four-square mark, and require sufficient clearspace around the logo on any surface.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "on-busy-photo",
          "separated-quadrants"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "WCAG 2.1 Level AA contrast requirement for body text. Microsoft Near-Black (#1F1F1F) on Microsoft White clears AA at ~17:1, and Fluent's accessibility guidance specifies AA as the floor for text-on-background pairings.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contrastRatio",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "Communications Blue on Microsoft White must remain perceptible at link / large-text sizes. Below 3:1, interactive affordance collapses — Fluent's color system relies on this contrast to signal \"clickable.\"\n",
        "against": "background",
        "minRatio": 3,
        "standard": "WCAG-AA-large"
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.primary",
        "severity": "recommendation",
        "rationale": "The four logo-quadrant hues belong together as the brand mark. Pairing Communications Blue with one quadrant hue alone (without the full quadrant set) reads as a brand-identity conflict rather than a coordinated palette.\n",
        "doesNotPairWith": [
          "microsoft-red",
          "microsoft-green",
          "microsoft-yellow"
        ]
      },
      {
        "type": "fontPairing",
        "target": "typography.heading",
        "severity": "recommendation",
        "rationale": "Fluent uses Segoe UI for both heading and body. Maintain a meaningful size ratio (Fluent's type ramp goes from Caption at ~12px to Title at ~32px+) to preserve hierarchy when one family does double duty.\n",
        "requires": "body",
        "minSizeRatio": 1.4
      },
      {
        "type": "enumMembership",
        "target": "typography.body.fontWeight",
        "severity": "recommendation",
        "rationale": "Fluent's type ramp uses Segoe UI Regular (400) and Semibold (600) for the majority of UI surfaces. Other weights exist but are reserved for specific roles (Light for hero display, Bold for emphasis).\n",
        "allowed": [
          "400",
          "600"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://www.microsoft.com/design/",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Microsoft, the Microsoft logo, Windows, Office, Azure, Fluent, and related names and marks are trademarks of the Microsoft group of companies. Brand colors and identity guidance documented here are derived from microsoft.com/design/ and the Fluent 2 design system site at fluent2.microsoft.design.\n",
      "importedDate": "2026-05-17",
      "notes": "Brand-atoms' read of Microsoft's public Fluent and brand-resource guidance. This file is not an official Microsoft brand document. Microsoft's four-square logo is one of the most-protected marks on the internet; no asset files are bundled here.\n"
    },
    "com.brand-atoms.references": {
      "palette": "microsoft@1.0.0",
      "fonts": {
        "heading": "segoe-ui@1.0.0",
        "body": "segoe-ui@1.0.0",
        "mono": "cascadiacode-nerdfont@1.0.0"
      }
    }
  }
}