{
  "$description": "Brand: PayPal (paypal@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette paypal@1.0.0",
      "paypal-blue": {
        "$value": "#003087",
        "$type": "color",
        "$description": "Primary deep navy-blue — the back-facing \"P\" of the monogram and the wordmark color."
      },
      "paypal-cobalt": {
        "$value": "#009CDE",
        "$type": "color",
        "$description": "Bright cobalt — the front-facing \"P\" of the duotone monogram."
      },
      "paypal-blue-deep": {
        "$value": "#001C64",
        "$type": "color",
        "$description": "Deeper navy used on hover/pressed states and emphasis text on the primary blue."
      },
      "paypal-gold": {
        "$value": "#FFC439",
        "$type": "color",
        "$description": "Signature gold — the \"Pay with PayPal\" merchant-button fill across the web."
      },
      "paypal-gold-hover": {
        "$value": "#F2BB30",
        "$type": "color",
        "$description": "Authored darker gold for hover/pressed states on the gold merchant button."
      },
      "paypal-ink": {
        "$value": "#2C2E2F",
        "$type": "color",
        "$description": "Near-black for body copy on light surfaces."
      },
      "paypal-graphite": {
        "$value": "#545D68",
        "$type": "color",
        "$description": "Secondary text on light backgrounds."
      },
      "paypal-gray": {
        "$value": "#9DA3A6",
        "$type": "color",
        "$description": "Tertiary text and metadata."
      },
      "paypal-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Canonical light canvas."
      },
      "paypal-fog": {
        "$value": "#F5F7FA",
        "$type": "color",
        "$description": "Authored surface tone for cards and panels."
      },
      "paypal-divider": {
        "$value": "#CBD2D6",
        "$type": "color",
        "$description": "Authored hairline divider tone."
      },
      "paypal-canvas-dark": {
        "$value": "#0F1419",
        "$type": "color",
        "$description": "Authored dark-mode canvas — PayPal is light-first; this is an authored inversion."
      },
      "paypal-surface-dark": {
        "$value": "#1C232B",
        "$type": "color",
        "$description": "Authored elevated surface on dark mode."
      }
    }
  },
  "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": [
          "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": "logo.wordmark.fill",
        "severity": "error",
        "rationale": "The PayPal wordmark renders only in PayPal Blue (#003087), in reversed white on dark surfaces, or in monochrome ink for print/embossed use. Cobalt is the monogram's front-P, not the wordmark fill; gold is reserved for the merchant button only.\n",
        "allowed": [
          "paypal-blue",
          "paypal-white",
          "paypal-ink"
        ],
        "forbidden": [
          "paypal-cobalt",
          "paypal-gold",
          "paypal-blue-deep",
          "paypal-gray"
        ]
      },
      {
        "type": "colorChoice",
        "target": "logo.monogram",
        "severity": "error",
        "rationale": "The \"PP\" monogram is a duotone composition: PayPal Blue back-P paired with PayPal Cobalt front-P. Single-color or off-brand variants violate the published mark.\n",
        "allowed": [
          "paypal-blue",
          "paypal-cobalt"
        ],
        "forbidden": [
          "paypal-gold",
          "paypal-blue-deep"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "PayPal's brand-center program forbids modifying the marks. Apply only PayPal-approved variants with the documented clearspace.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "on-busy-photo",
          "inverted-without-variant"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "PayPal Ink (#2C2E2F) on PayPal White (#FFFFFF) gives ~13:1 — well above WCAG 2.1 Level AA. This rule guards the floor for any new foreground/background pairing.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contrastRatio",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "PayPal Blue (#003087) on white reaches ~13:1 — well above AA. The deep navy carries primary actions cleanly; this rule guards link usage so future palette additions cannot regress.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.warning",
        "severity": "error",
        "rationale": "PayPal Gold (#FFC439) is reserved for the merchant \"Pay with PayPal\" button per PayPal's button-style spec. Using it as body color, link color, or for error states conflicts with its established merchant-button semantics.\n",
        "forbiddenContexts": [
          "body-text",
          "secondary-link",
          "error-state"
        ]
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "warning",
        "rationale": "PayPal Sans headlines on paypal.com and Brand Center surfaces sit in the Medium (500), Semibold (600), and Bold (700) band. Lighter cuts compromise the confident, trust-leaning voice; heavier cuts are outside the documented marketing kit.\n",
        "allowed": [
          "500",
          "600",
          "700"
        ]
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Fintech surfaces have an elevated trust requirement; AA is the floor on any new role pairing.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.primary",
        "severity": "recommendation",
        "rationale": "The blue duotone (Blue + Cobalt) pairs cleanly with neutrals. Mixing the brand blue with the merchant gold on the same surface conflicts with the published button-style separation between corporate identity and merchant CTA.\n",
        "pairsWith": [
          "paypal-cobalt",
          "paypal-white",
          "paypal-fog"
        ],
        "doesNotPairWith": [
          "paypal-gold"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://newsroom.paypal-corp.com/Brand-Center",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "PayPal Holdings, Inc. — PayPal, the PayPal wordmark, and the two-tone \"PP\" monogram are registered trademarks of PayPal Holdings, Inc. The signature blue duotone (#003087 + #009CDE) and the merchant gold (#FFC439) are documented across PayPal's Brand Center press kit. PayPal Sans is the proprietary corporate typeface; Inter is referenced here as the open-source fallback.\n",
      "importedDate": "2026-05-18",
      "notes": "PayPal Sans is not publicly distributed. This atom references Inter for both heading and body roles and notes PayPal Sans as the proprietary primary in provenance. The signature gold button (\"Pay with PayPal\") is a regulated merchant-button color — its use in the wild is governed by PayPal's button-style spec.\n"
    },
    "com.brand-atoms.references": {
      "palette": "paypal@1.0.0",
      "fonts": {
        "heading": "inter@1.0.0",
        "body": "inter@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}