{
  "$description": "Brand: PyPI (Python Package Index) — light mode",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette pypi@1.0.0",
      "pypi-blue": {
        "$value": "#3775A9",
        "$type": "color",
        "$description": "Primary brand color — the canonical PyPI/Python-family blue. Source: simple-icons \"PyPI\" entry, matching the PSF logo's upper-snake blue.\n"
      },
      "pypi-blue-dark": {
        "$value": "#1E415E",
        "$type": "color",
        "$description": "Deeper navy for hover states; dark-mode tertiary surface."
      },
      "pypi-yellow": {
        "$value": "#FFD43B",
        "$type": "color",
        "$description": "Secondary brand color — the Python-family yellow inherited from the PSF logo's lower-snake fill.\n"
      },
      "pypi-yellow-dark": {
        "$value": "#FFC331",
        "$type": "color",
        "$description": "Deeper amber used for hover states on the yellow accent."
      },
      "pypi-black": {
        "$value": "#0E1217",
        "$type": "color",
        "$description": "Dark-mode page canvas."
      },
      "pypi-charcoal": {
        "$value": "#1C232C",
        "$type": "color",
        "$description": "Elevated dark surface for cards and panels."
      },
      "pypi-slate": {
        "$value": "#3D4554",
        "$type": "color",
        "$description": "Body text on light canvas; secondary copy."
      },
      "pypi-gray": {
        "$value": "#6B7280",
        "$type": "color",
        "$description": "Tertiary text and quiet UI."
      },
      "pypi-light-gray": {
        "$value": "#D5D9DE",
        "$type": "color",
        "$description": "Hairline borders on light canvas."
      },
      "pypi-off-white": {
        "$value": "#F4F5F7",
        "$type": "color",
        "$description": "Subtle layered surface on light canvas."
      },
      "pypi-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Page canvas in light mode."
      },
      "pypi-error": {
        "$value": "#BD4147",
        "$type": "color",
        "$description": "Status error color used in advisory and yanked-release callouts."
      }
    },
    "roles": {
      "$description": "Semantic color roles (light mode) mapped to palette swatches",
      "background": {
        "$value": "{color.swatches.pypi-white}",
        "$type": "color",
        "$description": "background role → PyPI White"
      },
      "surface": {
        "$value": "{color.swatches.pypi-off-white}",
        "$type": "color",
        "$description": "surface role → PyPI Off-White"
      },
      "surface-elevated": {
        "$value": "{color.swatches.pypi-white}",
        "$type": "color",
        "$description": "surface-elevated role → PyPI White"
      },
      "text-primary": {
        "$value": "{color.swatches.pypi-blue-dark}",
        "$type": "color",
        "$description": "text-primary role → PyPI Blue Dark"
      },
      "text-secondary": {
        "$value": "{color.swatches.pypi-slate}",
        "$type": "color",
        "$description": "text-secondary role → PyPI Slate"
      },
      "text-tertiary": {
        "$value": "{color.swatches.pypi-gray}",
        "$type": "color",
        "$description": "text-tertiary role → PyPI Gray"
      },
      "primary": {
        "$value": "{color.swatches.pypi-blue}",
        "$type": "color",
        "$description": "primary role → PyPI Blue"
      },
      "primary-hover": {
        "$value": "{color.swatches.pypi-blue-dark}",
        "$type": "color",
        "$description": "primary-hover role → PyPI Blue Dark"
      },
      "accent": {
        "$value": "{color.swatches.pypi-yellow}",
        "$type": "color",
        "$description": "accent role → PyPI Yellow"
      },
      "accent-hover": {
        "$value": "{color.swatches.pypi-yellow-dark}",
        "$type": "color",
        "$description": "accent-hover role → PyPI Yellow Dark"
      },
      "warning": {
        "$value": "{color.swatches.pypi-yellow-dark}",
        "$type": "color",
        "$description": "warning role → PyPI Yellow Dark"
      },
      "warning-hover": {
        "$value": "{color.swatches.pypi-yellow}",
        "$type": "color",
        "$description": "warning-hover role → PyPI Yellow"
      },
      "error": {
        "$value": "{color.swatches.pypi-error}",
        "$type": "color",
        "$description": "error role → PyPI Error Red"
      },
      "success": {
        "$value": "{color.swatches.pypi-blue}",
        "$type": "color",
        "$description": "success role → PyPI Blue"
      },
      "border": {
        "$value": "{color.swatches.pypi-light-gray}",
        "$type": "color",
        "$description": "border role → PyPI Light Gray"
      },
      "brand-overrides": {
        "$description": "Brand-level role overrides (take precedence over palette role mappings)",
        "identity": {
          "$value": "{color.swatches.pypi-blue}",
          "$type": "color",
          "$description": "Brand role identity → PyPI Blue"
        },
        "on-identity": {
          "$value": "{color.swatches.pypi-white}",
          "$type": "color",
          "$description": "Brand role on-identity → PyPI White"
        },
        "primary": {
          "$value": "{color.swatches.pypi-blue}",
          "$type": "color",
          "$description": "Brand role primary → PyPI Blue"
        },
        "primary-hover": {
          "$value": "{color.swatches.pypi-blue-dark}",
          "$type": "color",
          "$description": "Brand role primary-hover → PyPI Blue Dark"
        },
        "accent": {
          "$value": "{color.swatches.pypi-yellow}",
          "$type": "color",
          "$description": "Brand role accent → PyPI Yellow"
        },
        "accent-hover": {
          "$value": "{color.swatches.pypi-yellow-dark}",
          "$type": "color",
          "$description": "Brand role accent-hover → PyPI Yellow Dark"
        },
        "mark": {
          "$value": "{color.swatches.pypi-blue}",
          "$type": "color",
          "$description": "Brand role mark → PyPI Blue"
        },
        "background": {
          "$value": "{color.swatches.pypi-white}",
          "$type": "color",
          "$description": "Brand role background → PyPI White"
        },
        "surface": {
          "$value": "{color.swatches.pypi-off-white}",
          "$type": "color",
          "$description": "Brand role surface → PyPI Off-White"
        },
        "text-primary": {
          "$value": "{color.swatches.pypi-blue-dark}",
          "$type": "color",
          "$description": "Brand role text-primary → PyPI Blue Dark"
        },
        "text-secondary": {
          "$value": "{color.swatches.pypi-slate}",
          "$type": "color",
          "$description": "Brand role text-secondary → PyPI Slate"
        },
        "error": {
          "$value": "{color.swatches.pypi-error}",
          "$type": "color",
          "$description": "Brand role error → PyPI Error Red"
        },
        "success": {
          "$value": "{color.swatches.pypi-blue}",
          "$type": "color",
          "$description": "Brand role success → PyPI Blue"
        },
        "border": {
          "$value": "{color.swatches.pypi-light-gray}",
          "$type": "color",
          "$description": "Brand role border → PyPI Light Gray"
        }
      }
    }
  },
  "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"
      }
    },
    "mono": {
      "family": {
        "$value": [
          "Source Code Pro",
          "ui-monospace",
          "SFMono-Regular",
          "Menlo",
          "Consolas",
          "Liberation Mono",
          "monospace"
        ],
        "$type": "fontFamily",
        "$description": "mono role → Source Code Pro (source-code-pro@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"
      }
    }
  }
}
