{
  "$description": "Brand: U.S. Web Design System (uswds@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette uswds@1.0.0",
      "gray-1": {
        "$value": "#FCFCFC",
        "$type": "color"
      },
      "gray-2": {
        "$value": "#F9F9F9",
        "$type": "color"
      },
      "gray-3": {
        "$value": "#F6F6F6",
        "$type": "color"
      },
      "gray-4": {
        "$value": "#F3F3F3",
        "$type": "color"
      },
      "gray-5": {
        "$value": "#F0F0F0",
        "$type": "color"
      },
      "gray-10": {
        "$value": "#E6E6E6",
        "$type": "color"
      },
      "gray-20": {
        "$value": "#C9C9C9",
        "$type": "color"
      },
      "gray-30": {
        "$value": "#ADADAD",
        "$type": "color"
      },
      "gray-40": {
        "$value": "#919191",
        "$type": "color"
      },
      "gray-50": {
        "$value": "#757575",
        "$type": "color"
      },
      "gray-60": {
        "$value": "#5C5C5C",
        "$type": "color"
      },
      "gray-70": {
        "$value": "#454545",
        "$type": "color"
      },
      "gray-80": {
        "$value": "#2E2E2E",
        "$type": "color"
      },
      "gray-90": {
        "$value": "#1B1B1B",
        "$type": "color"
      },
      "gray-100": {
        "$value": "#000000",
        "$type": "color"
      },
      "gray-cool-1": {
        "$value": "#FBFCFD",
        "$type": "color"
      },
      "gray-cool-2": {
        "$value": "#F7F9FA",
        "$type": "color"
      },
      "gray-cool-3": {
        "$value": "#F5F6F7",
        "$type": "color"
      },
      "gray-cool-4": {
        "$value": "#F1F3F6",
        "$type": "color"
      },
      "gray-cool-5": {
        "$value": "#EDEFF0",
        "$type": "color"
      },
      "gray-cool-10": {
        "$value": "#DFE1E2",
        "$type": "color"
      },
      "gray-cool-20": {
        "$value": "#C6CACE",
        "$type": "color"
      },
      "gray-cool-30": {
        "$value": "#A9AEB1",
        "$type": "color"
      },
      "gray-cool-40": {
        "$value": "#8D9297",
        "$type": "color"
      },
      "gray-cool-50": {
        "$value": "#71767A",
        "$type": "color"
      },
      "gray-cool-60": {
        "$value": "#565C65",
        "$type": "color"
      },
      "gray-cool-70": {
        "$value": "#3D4551",
        "$type": "color"
      },
      "gray-cool-80": {
        "$value": "#2D2E2F",
        "$type": "color"
      },
      "gray-cool-90": {
        "$value": "#1C1D1F",
        "$type": "color"
      },
      "gray-warm-1": {
        "$value": "#FCFCFB",
        "$type": "color"
      },
      "gray-warm-2": {
        "$value": "#F9F9F7",
        "$type": "color"
      },
      "gray-warm-3": {
        "$value": "#F6F6F2",
        "$type": "color"
      },
      "gray-warm-4": {
        "$value": "#F5F5F0",
        "$type": "color"
      },
      "gray-warm-5": {
        "$value": "#F0F0EC",
        "$type": "color"
      },
      "gray-warm-10": {
        "$value": "#E6E6E2",
        "$type": "color"
      },
      "gray-warm-20": {
        "$value": "#CAC9C0",
        "$type": "color"
      },
      "gray-warm-30": {
        "$value": "#AFAEA2",
        "$type": "color"
      },
      "gray-warm-40": {
        "$value": "#929285",
        "$type": "color"
      },
      "gray-warm-50": {
        "$value": "#76766A",
        "$type": "color"
      },
      "gray-warm-60": {
        "$value": "#5D5D52",
        "$type": "color"
      },
      "gray-warm-70": {
        "$value": "#454540",
        "$type": "color"
      },
      "gray-warm-80": {
        "$value": "#2E2E2A",
        "$type": "color"
      },
      "gray-warm-90": {
        "$value": "#171716",
        "$type": "color"
      },
      "red-5": {
        "$value": "#F9EEEE",
        "$type": "color"
      },
      "red-10": {
        "$value": "#F8E1DE",
        "$type": "color"
      },
      "red-20": {
        "$value": "#F7BBB1",
        "$type": "color"
      },
      "red-30": {
        "$value": "#F2938C",
        "$type": "color"
      },
      "red-40": {
        "$value": "#E9695F",
        "$type": "color"
      },
      "red-50": {
        "$value": "#D83933",
        "$type": "color",
        "$description": "USWDS default error / danger color."
      },
      "red-60": {
        "$value": "#A23737",
        "$type": "color"
      },
      "red-70": {
        "$value": "#6F3331",
        "$type": "color"
      },
      "red-80": {
        "$value": "#3E2927",
        "$type": "color"
      },
      "red-90": {
        "$value": "#1B1616",
        "$type": "color"
      },
      "red-vivid-5": {
        "$value": "#FFF3F2",
        "$type": "color"
      },
      "red-vivid-10": {
        "$value": "#FDE0DB",
        "$type": "color"
      },
      "red-vivid-20": {
        "$value": "#FDB8AE",
        "$type": "color"
      },
      "red-vivid-30": {
        "$value": "#FF8D7B",
        "$type": "color"
      },
      "red-vivid-40": {
        "$value": "#FB5A47",
        "$type": "color"
      },
      "red-vivid-50": {
        "$value": "#E52207",
        "$type": "color"
      },
      "red-vivid-60": {
        "$value": "#B50909",
        "$type": "color"
      },
      "red-vivid-70": {
        "$value": "#8B0A03",
        "$type": "color"
      },
      "red-vivid-80": {
        "$value": "#5C1111",
        "$type": "color"
      },
      "orange-5": {
        "$value": "#F6EFE9",
        "$type": "color"
      },
      "orange-10": {
        "$value": "#F2E4D4",
        "$type": "color"
      },
      "orange-20": {
        "$value": "#F3BF90",
        "$type": "color"
      },
      "orange-30": {
        "$value": "#F09860",
        "$type": "color"
      },
      "orange-40": {
        "$value": "#DD7533",
        "$type": "color"
      },
      "orange-50": {
        "$value": "#A86437",
        "$type": "color"
      },
      "orange-60": {
        "$value": "#775540",
        "$type": "color"
      },
      "orange-70": {
        "$value": "#524236",
        "$type": "color"
      },
      "orange-80": {
        "$value": "#332D27",
        "$type": "color"
      },
      "orange-90": {
        "$value": "#1B1614",
        "$type": "color"
      },
      "orange-vivid-5": {
        "$value": "#FEF2E4",
        "$type": "color"
      },
      "orange-vivid-10": {
        "$value": "#FCE2C5",
        "$type": "color"
      },
      "orange-vivid-20": {
        "$value": "#FFBC78",
        "$type": "color"
      },
      "orange-vivid-30": {
        "$value": "#FA9441",
        "$type": "color"
      },
      "orange-vivid-40": {
        "$value": "#E66F0E",
        "$type": "color"
      },
      "orange-vivid-50": {
        "$value": "#C05600",
        "$type": "color"
      },
      "orange-vivid-60": {
        "$value": "#8C471C",
        "$type": "color"
      },
      "orange-vivid-70": {
        "$value": "#5F3617",
        "$type": "color"
      },
      "orange-vivid-80": {
        "$value": "#352313",
        "$type": "color"
      },
      "yellow-5": {
        "$value": "#FAF3D1",
        "$type": "color"
      },
      "yellow-10": {
        "$value": "#F5E6AF",
        "$type": "color"
      },
      "yellow-20": {
        "$value": "#E6C74C",
        "$type": "color"
      },
      "yellow-30": {
        "$value": "#C9AB48",
        "$type": "color",
        "$description": "USWDS warning color."
      },
      "yellow-40": {
        "$value": "#A88F48",
        "$type": "color"
      },
      "yellow-50": {
        "$value": "#8A7237",
        "$type": "color"
      },
      "yellow-60": {
        "$value": "#6B5A39",
        "$type": "color"
      },
      "yellow-70": {
        "$value": "#504332",
        "$type": "color"
      },
      "yellow-80": {
        "$value": "#332D27",
        "$type": "color"
      },
      "yellow-90": {
        "$value": "#1A1614",
        "$type": "color"
      },
      "yellow-vivid-5": {
        "$value": "#FFF5C2",
        "$type": "color"
      },
      "yellow-vivid-10": {
        "$value": "#FEE685",
        "$type": "color"
      },
      "yellow-vivid-20": {
        "$value": "#FACE00",
        "$type": "color"
      },
      "yellow-vivid-30": {
        "$value": "#DDAA01",
        "$type": "color"
      },
      "yellow-vivid-40": {
        "$value": "#B38C00",
        "$type": "color"
      },
      "yellow-vivid-50": {
        "$value": "#947100",
        "$type": "color"
      },
      "yellow-vivid-60": {
        "$value": "#776017",
        "$type": "color"
      },
      "yellow-vivid-70": {
        "$value": "#5C4809",
        "$type": "color"
      },
      "yellow-vivid-80": {
        "$value": "#422D19",
        "$type": "color"
      },
      "green-5": {
        "$value": "#EAF4DD",
        "$type": "color"
      },
      "green-10": {
        "$value": "#DFEACD",
        "$type": "color"
      },
      "green-20": {
        "$value": "#B8D293",
        "$type": "color"
      },
      "green-30": {
        "$value": "#9BB672",
        "$type": "color"
      },
      "green-40": {
        "$value": "#7D9B4E",
        "$type": "color"
      },
      "green-50": {
        "$value": "#607F35",
        "$type": "color",
        "$description": "USWDS success color."
      },
      "green-60": {
        "$value": "#4C6424",
        "$type": "color"
      },
      "green-70": {
        "$value": "#3C4A29",
        "$type": "color"
      },
      "green-80": {
        "$value": "#293021",
        "$type": "color"
      },
      "green-90": {
        "$value": "#161814",
        "$type": "color"
      },
      "green-vivid-5": {
        "$value": "#DDF9C7",
        "$type": "color"
      },
      "green-vivid-10": {
        "$value": "#C5EE93",
        "$type": "color"
      },
      "green-vivid-20": {
        "$value": "#98D035",
        "$type": "color"
      },
      "green-vivid-30": {
        "$value": "#7FB135",
        "$type": "color"
      },
      "green-vivid-40": {
        "$value": "#719F2A",
        "$type": "color"
      },
      "green-vivid-50": {
        "$value": "#538200",
        "$type": "color"
      },
      "green-vivid-60": {
        "$value": "#466C04",
        "$type": "color"
      },
      "green-vivid-70": {
        "$value": "#2F4A0B",
        "$type": "color"
      },
      "green-vivid-80": {
        "$value": "#243413",
        "$type": "color"
      },
      "mint-5": {
        "$value": "#DBF6ED",
        "$type": "color"
      },
      "mint-10": {
        "$value": "#C7EFE2",
        "$type": "color"
      },
      "mint-20": {
        "$value": "#92D9BB",
        "$type": "color"
      },
      "mint-30": {
        "$value": "#5ABF95",
        "$type": "color"
      },
      "mint-40": {
        "$value": "#34A37E",
        "$type": "color"
      },
      "mint-50": {
        "$value": "#2E8367",
        "$type": "color"
      },
      "mint-60": {
        "$value": "#286846",
        "$type": "color"
      },
      "mint-70": {
        "$value": "#204E34",
        "$type": "color"
      },
      "mint-80": {
        "$value": "#193324",
        "$type": "color"
      },
      "mint-90": {
        "$value": "#0D1A12",
        "$type": "color"
      },
      "mint-vivid-5": {
        "$value": "#C9FBEB",
        "$type": "color"
      },
      "mint-vivid-10": {
        "$value": "#83FCD4",
        "$type": "color"
      },
      "mint-vivid-20": {
        "$value": "#0CEDA6",
        "$type": "color"
      },
      "mint-vivid-30": {
        "$value": "#04C585",
        "$type": "color"
      },
      "mint-vivid-40": {
        "$value": "#00A871",
        "$type": "color"
      },
      "mint-vivid-50": {
        "$value": "#008659",
        "$type": "color"
      },
      "mint-vivid-60": {
        "$value": "#146947",
        "$type": "color"
      },
      "mint-vivid-70": {
        "$value": "#0C4E29",
        "$type": "color"
      },
      "mint-vivid-80": {
        "$value": "#0D351E",
        "$type": "color"
      },
      "cyan-5": {
        "$value": "#E7F6F8",
        "$type": "color"
      },
      "cyan-10": {
        "$value": "#CCECF2",
        "$type": "color"
      },
      "cyan-20": {
        "$value": "#99DEEA",
        "$type": "color"
      },
      "cyan-30": {
        "$value": "#5DC0D1",
        "$type": "color"
      },
      "cyan-40": {
        "$value": "#449DAC",
        "$type": "color"
      },
      "cyan-50": {
        "$value": "#168092",
        "$type": "color"
      },
      "cyan-60": {
        "$value": "#2A646D",
        "$type": "color"
      },
      "cyan-70": {
        "$value": "#2C4A4E",
        "$type": "color"
      },
      "cyan-80": {
        "$value": "#203133",
        "$type": "color"
      },
      "cyan-90": {
        "$value": "#111819",
        "$type": "color"
      },
      "cyan-vivid-5": {
        "$value": "#E5FAFF",
        "$type": "color"
      },
      "cyan-vivid-10": {
        "$value": "#A8F2FF",
        "$type": "color"
      },
      "cyan-vivid-20": {
        "$value": "#52DAF2",
        "$type": "color"
      },
      "cyan-vivid-30": {
        "$value": "#00BDE3",
        "$type": "color"
      },
      "cyan-vivid-40": {
        "$value": "#009EC1",
        "$type": "color"
      },
      "cyan-vivid-50": {
        "$value": "#0081A1",
        "$type": "color"
      },
      "cyan-vivid-60": {
        "$value": "#00687D",
        "$type": "color"
      },
      "cyan-vivid-70": {
        "$value": "#0E4F5C",
        "$type": "color"
      },
      "cyan-vivid-80": {
        "$value": "#093B44",
        "$type": "color"
      },
      "blue-5": {
        "$value": "#EFF6FB",
        "$type": "color"
      },
      "blue-10": {
        "$value": "#D9E8F6",
        "$type": "color"
      },
      "blue-20": {
        "$value": "#AACDEC",
        "$type": "color"
      },
      "blue-30": {
        "$value": "#73B3E7",
        "$type": "color"
      },
      "blue-40": {
        "$value": "#4F97D1",
        "$type": "color"
      },
      "blue-50": {
        "$value": "#2378C3",
        "$type": "color",
        "$description": "USWDS primary blue."
      },
      "blue-60": {
        "$value": "#2C608A",
        "$type": "color"
      },
      "blue-70": {
        "$value": "#274863",
        "$type": "color",
        "$description": "USWDS primary-dark."
      },
      "blue-80": {
        "$value": "#1F303E",
        "$type": "color"
      },
      "blue-90": {
        "$value": "#11181D",
        "$type": "color"
      },
      "blue-vivid-5": {
        "$value": "#E8F5FF",
        "$type": "color"
      },
      "blue-vivid-10": {
        "$value": "#CFE8FF",
        "$type": "color"
      },
      "blue-vivid-20": {
        "$value": "#A1D3FF",
        "$type": "color"
      },
      "blue-vivid-30": {
        "$value": "#58B4FF",
        "$type": "color"
      },
      "blue-vivid-40": {
        "$value": "#2491FF",
        "$type": "color"
      },
      "blue-vivid-50": {
        "$value": "#0076D6",
        "$type": "color"
      },
      "blue-vivid-60": {
        "$value": "#005EA2",
        "$type": "color"
      },
      "blue-vivid-70": {
        "$value": "#0B4778",
        "$type": "color"
      },
      "blue-vivid-80": {
        "$value": "#112F4E",
        "$type": "color"
      },
      "indigo-5": {
        "$value": "#EFEFF8",
        "$type": "color"
      },
      "indigo-10": {
        "$value": "#E5E4FA",
        "$type": "color"
      },
      "indigo-20": {
        "$value": "#C5C5F3",
        "$type": "color"
      },
      "indigo-30": {
        "$value": "#A5A8EB",
        "$type": "color"
      },
      "indigo-40": {
        "$value": "#8889DB",
        "$type": "color"
      },
      "indigo-50": {
        "$value": "#676CC8",
        "$type": "color"
      },
      "indigo-60": {
        "$value": "#4D52AF",
        "$type": "color"
      },
      "indigo-70": {
        "$value": "#3D4076",
        "$type": "color"
      },
      "indigo-80": {
        "$value": "#2B2C40",
        "$type": "color"
      },
      "indigo-90": {
        "$value": "#16171F",
        "$type": "color"
      },
      "indigo-vivid-5": {
        "$value": "#F0F0FF",
        "$type": "color"
      },
      "indigo-vivid-10": {
        "$value": "#E0E0FF",
        "$type": "color"
      },
      "indigo-vivid-20": {
        "$value": "#CCCEFF",
        "$type": "color"
      },
      "indigo-vivid-30": {
        "$value": "#A3A7FA",
        "$type": "color"
      },
      "indigo-vivid-40": {
        "$value": "#8289FF",
        "$type": "color"
      },
      "indigo-vivid-50": {
        "$value": "#656BD7",
        "$type": "color"
      },
      "indigo-vivid-60": {
        "$value": "#4A50C4",
        "$type": "color"
      },
      "indigo-vivid-70": {
        "$value": "#3333A3",
        "$type": "color"
      },
      "indigo-vivid-80": {
        "$value": "#212463",
        "$type": "color"
      },
      "violet-5": {
        "$value": "#F4F1F9",
        "$type": "color"
      },
      "violet-10": {
        "$value": "#EBE3F9",
        "$type": "color"
      },
      "violet-20": {
        "$value": "#D0C3E9",
        "$type": "color"
      },
      "violet-30": {
        "$value": "#B8A2E3",
        "$type": "color"
      },
      "violet-40": {
        "$value": "#9D84D2",
        "$type": "color"
      },
      "violet-50": {
        "$value": "#8168B3",
        "$type": "color"
      },
      "violet-60": {
        "$value": "#665190",
        "$type": "color"
      },
      "violet-70": {
        "$value": "#4C3D69",
        "$type": "color"
      },
      "violet-80": {
        "$value": "#312B3F",
        "$type": "color"
      },
      "violet-90": {
        "$value": "#18161D",
        "$type": "color"
      },
      "violet-vivid-5": {
        "$value": "#F7F2FF",
        "$type": "color"
      },
      "violet-vivid-10": {
        "$value": "#EDE3FF",
        "$type": "color"
      },
      "violet-vivid-20": {
        "$value": "#D5BFFF",
        "$type": "color"
      },
      "violet-vivid-30": {
        "$value": "#C39DEB",
        "$type": "color"
      },
      "violet-vivid-40": {
        "$value": "#AD79E9",
        "$type": "color"
      },
      "violet-vivid-50": {
        "$value": "#9355DC",
        "$type": "color"
      },
      "violet-vivid-60": {
        "$value": "#783CB9",
        "$type": "color"
      },
      "violet-vivid-70": {
        "$value": "#54278F",
        "$type": "color"
      },
      "violet-vivid-80": {
        "$value": "#39215E",
        "$type": "color"
      },
      "magenta-5": {
        "$value": "#F9F0F2",
        "$type": "color"
      },
      "magenta-10": {
        "$value": "#F6E1E8",
        "$type": "color"
      },
      "magenta-20": {
        "$value": "#F0BBCC",
        "$type": "color"
      },
      "magenta-30": {
        "$value": "#E895B3",
        "$type": "color"
      },
      "magenta-40": {
        "$value": "#E0699F",
        "$type": "color"
      },
      "magenta-50": {
        "$value": "#C84281",
        "$type": "color"
      },
      "magenta-60": {
        "$value": "#8B4566",
        "$type": "color"
      },
      "magenta-70": {
        "$value": "#66364B",
        "$type": "color"
      },
      "magenta-80": {
        "$value": "#402731",
        "$type": "color"
      },
      "magenta-90": {
        "$value": "#1B1617",
        "$type": "color"
      },
      "magenta-vivid-5": {
        "$value": "#FFF2F5",
        "$type": "color"
      },
      "magenta-vivid-10": {
        "$value": "#FFDDEA",
        "$type": "color"
      },
      "magenta-vivid-20": {
        "$value": "#FFB4CF",
        "$type": "color"
      },
      "magenta-vivid-30": {
        "$value": "#FF87B2",
        "$type": "color"
      },
      "magenta-vivid-40": {
        "$value": "#FD4496",
        "$type": "color"
      },
      "magenta-vivid-50": {
        "$value": "#D72D79",
        "$type": "color"
      },
      "magenta-vivid-60": {
        "$value": "#AB2165",
        "$type": "color"
      },
      "magenta-vivid-70": {
        "$value": "#731F44",
        "$type": "color"
      },
      "magenta-vivid-80": {
        "$value": "#4F172E",
        "$type": "color"
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Public Sans",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Public Sans (public-sans@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": [
          "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"
      }
    },
    "mono": {
      "family": {
        "$value": [
          "Roboto Mono",
          "SFMono-Regular",
          "Menlo",
          "Consolas",
          "Liberation Mono",
          "Courier New",
          "monospace"
        ],
        "$type": "fontFamily",
        "$description": "mono role → Roboto Mono (roboto-mono@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"
        },
        "$description": "Available font weights"
      }
    }
  },
  "$extensions": {
    "com.brand-atoms.rules": [
      {
        "type": "colorChoice",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "USWDS's default \"uswds\" theme resolves the `primary` token to blue-vivid-60 (#005EA2) and `primary-vivid` to blue-warm-60v (#0050D8), with blue-warm-70v (#1A4480) and blue-warm-80v (#162E51) as the dark variants. The secondary slot is red-50, but red MUST NOT stand in for the primary interactive role — doing so violates the documented theme contract that federal consumers rely on for affordance and link recognition.\n",
        "allowed": [
          "blue-vivid-60",
          "blue-vivid-70"
        ],
        "forbidden": [
          "red-50",
          "red-vivid-50",
          "green-50",
          "violet-50",
          "magenta-50"
        ]
      },
      {
        "type": "colorChoice",
        "target": "roles.colors.error",
        "severity": "error",
        "rationale": "USWDS Red 50 (#D83933) is the documented danger / error color across the system. Orange and yellow are reserved for accent-warm and warning roles respectively; conflating them with destructive error states undermines the WCAG-grounded affordance hierarchy USWDS encodes.\n",
        "allowed": [
          "red-50",
          "red-vivid-50"
        ],
        "forbidden": [
          "orange-vivid-30",
          "yellow-30",
          "magenta-50"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "USWDS's published accessibility commitment targets WCAG 2.1 Level AA across all components. Gray 90 (#1B1B1B) on Gray 1 (#FCFCFC) clears AA at ~17:1, satisfying the federal Section 508 accessibility baseline that USWDS exists to make routine.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Federal websites are subject to Section 508 of the Rehabilitation Act and OMB M-23-22 implementing guidance; USWDS is the standardized path to compliance and all consumers of this brand atom MUST meet AA at minimum.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "U.S. government insignia (agency seals, the great seal, department wordmarks) are subject to federal statute and agency-specific usage policy. The USWDS visual-identity guidance prohibits decorative treatment of official marks; consumers ship the official mark unaltered or substitute a site-specific identifier rendered in the system's theme colors only.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "gradient-fill",
          "outlined",
          "on-busy-photo"
        ]
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "warning",
        "rationale": "Public Sans, USWDS's commissioned default heading face, ships in Thin, ExtraLight, Light (300), Regular (400), Medium (500), SemiBold (600), Bold (700), ExtraBold, and Black. USWDS's documented type ramp anchors at Regular, Medium, SemiBold, and Bold for headings — Thin/ExtraLight and Black/ExtraBold cuts are not part of the documented scale and should not be used for primary heading roles.\n",
        "allowed": [
          "300",
          "400",
          "500",
          "600",
          "700"
        ]
      },
      {
        "type": "fontPairing",
        "target": "typography.display",
        "severity": "error",
        "rationale": "USWDS's documented type scale maintains a clear hierarchy between display and body sizes (heading-xl through heading-3xs, with body anchored at the 16-pixel base). Display-at-body-size collapses the scannability USWDS's component patterns rely on for landing pages, alerts, and form-flow surfaces.\n",
        "requires": "prose",
        "minSizeRatio": 1.5
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.success",
        "severity": "error",
        "rationale": "USWDS Green 50 (#607F35) is the documented success color used by the Alert and Status components. Inverting its meaning (success for failure) conflicts with the role contract federal product teams and screen-reader users rely on for assistive-tech announcement parity.\n",
        "allowedContexts": [
          "confirmation",
          "completion",
          "data-viz-positive"
        ],
        "forbiddenContexts": [
          "error-state",
          "destructive-action"
        ]
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.mark",
        "severity": "recommendation",
        "rationale": "Blue 60v reads as institutional federal-identity blue against the white canvas or the near-black ink surface. Placing it adjacent to red-50 (secondary), orange-vivid-30 (accent-warm), yellow-30 (warning), or magenta-50 at equal weight produces chromatic competition that fights the restrained civic-government voice USWDS targets.\n",
        "pairsWith": [
          "gray-1",
          "gray-3",
          "gray-90"
        ],
        "doesNotPairWith": [
          "red-50",
          "orange-vivid-30",
          "yellow-30",
          "magenta-50"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://designsystem.digital.gov/design-tokens/color/theme-tokens/",
      "license": "CC0-1.0",
      "attribution": "U.S. Web Design System (USWDS), released by the U.S. General Services Administration to the public domain (CC0-1.0). Theme token defaults captured from the published theme-color-tokens reference; system color values mirrored from the uswds-core Sass partials. \"U.S. Web Design System,\" \"USWDS,\" the federal word marks, and U.S. government insignia are not implied to be licensed CC0 — only the design-system code and tokens are.\n",
      "importedDate": "2026-05-19",
      "notes": "This brand atom REFERENCES the existing `uswds@1` palette atom rather than creating a duplicate. Theme-token defaults from the published reference resolve as follows: primary = blue-vivid-60 (#005EA2), secondary = red-50 (#D83933), accent-cool = cyan-vivid-30 (#00BDE3), accent-warm = orange-vivid-30 (#FA9441), base-darkest / base-ink = gray-90 (#1B1B1B). All referenced swatch IDs exist in palettes/uswds@1.\n"
    },
    "com.brand-atoms.references": {
      "palette": "uswds@1.0.0",
      "fonts": {
        "heading": "public-sans@1.0.0",
        "body": "source-sans-3@1.0.0",
        "mono": "roboto-mono@1.0.0"
      }
    }
  }
}