{
  "$description": "Brand: Apple Music (apple-music@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette apple-music@1.0.0",
      "apple-music-pink": {
        "$value": "#FF4E6B",
        "$type": "color",
        "$description": "The lighter terminus of Apple Music's signature pink-to-red gradient; primary mark fill."
      },
      "apple-music-red": {
        "$value": "#FF0436",
        "$type": "color",
        "$description": "The deeper terminus of the gradient; pairs with the pink to form the mark."
      },
      "apple-music-coral": {
        "$value": "#FA233B",
        "$type": "color",
        "$description": "Mid-gradient coral — the pressed / hovered state on the gradient marks."
      },
      "apple-music-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Primary text and reversed wordmark fill on the dark canvas."
      },
      "apple-music-black": {
        "$value": "#000000",
        "$type": "color",
        "$description": "Canonical Apple HIG dark-mode canvas. Inherited from the iOS / macOS system-background-dark token."
      },
      "apple-music-surface": {
        "$value": "#1C1C1E",
        "$type": "color",
        "$description": "Elevated surface on the dark canvas — matches HIG secondary-system-background-dark."
      },
      "apple-music-surface-elevated": {
        "$value": "#2C2C2E",
        "$type": "color",
        "$description": "Cards, sheets, and elevated tiles — matches HIG tertiary-system-background-dark."
      },
      "apple-music-gray": {
        "$value": "#8E8E93",
        "$type": "color",
        "$description": "Secondary text and divider tone — matches HIG system-gray on dark."
      },
      "apple-music-gray-light": {
        "$value": "#C7C7CC",
        "$type": "color",
        "$description": "Tertiary text and metadata on the dark canvas."
      }
    }
  },
  "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.mark.fill",
        "severity": "error",
        "rationale": "The Apple Music mark renders as the pink-to-red gradient or as a flat-white reversed variant on dark / chromatic surfaces. Filling the mark with the neutral grays or with black collapses the gradient identity into the parent Apple corporate monochrome posture, which is reserved for the Apple corporate mark at `apple@1`.\n",
        "allowed": [
          "apple-music-pink",
          "apple-music-red",
          "apple-music-coral",
          "apple-music-white"
        ],
        "forbidden": [
          "apple-music-black",
          "apple-music-gray",
          "apple-music-gray-light"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "Apple Music inherits the Apple Identity Guidelines' prohibition on stretching, rotating, recoloring, or adding effects to the mark. The gradient direction is fixed (pink at one terminus, red at the other) — reversing the gradient inverts the brand's published treatment.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "on-busy-photo",
          "outlined",
          "gradient-reversed"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "Apple Music White (#FFFFFF) on Apple Music Black (#000000) gives ~21:1 — well clear of WCAG 2.1 Level AA. This rule encodes the floor any new role pairing must clear on the dark canvas.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contrastRatio",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "Apple Music Pink (#FF4E6B) on the dark canvas must remain perceptible at interactive sizes. Falling below 3:1 (AA-large) breaks the affordance of primary CTAs and the play button the brand depends on.\n",
        "against": "background",
        "minRatio": 3,
        "standard": "WCAG-AA-large"
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "The pink gradient terminus is reserved for the mark, hero typographic moments, and the primary play / subscribe action. Reusing it for body text or validation-failure states conflicts with its established positive-action meaning and dilutes the gradient identity.\n",
        "forbiddenContexts": [
          "body-text",
          "secondary-link",
          "validation-failure"
        ]
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "recommendation",
        "rationale": "Apple's HIG type ramp uses SF Pro Medium (500) and Semibold (600) for most heading sizes, with Bold (700) reserved for hero typography. Apple Music's marketing headlines lean into the heavier end of this ramp for editorial impact while staying within the HIG-approved weight set.\n",
        "allowed": [
          "500",
          "600",
          "700"
        ]
      },
      {
        "type": "fontPairing",
        "target": "typography.heading",
        "severity": "recommendation",
        "rationale": "Apple Music inherits Apple's HIG convention of using one family (SF Pro, substituted here by Inter) for both heading and body, distinguished by a meaningful size differential. A 1.3× floor preserves hierarchy when one family does both jobs.\n",
        "requires": "body",
        "minSizeRatio": 1.3
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Apple Music inherits the Apple HIG Accessibility floor: 4.5:1 for body text, 3:1 for large text and interactive controls.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.primary",
        "severity": "recommendation",
        "rationale": "The pink-to-red gradient reads cleanest against the deep black canvas or against pure white. Pairing the gradient against the mid-grays produces a muddy adjacency that fights the gradient's saturation rather than supporting it as a focal accent.\n",
        "pairsWith": [
          "apple-music-black",
          "apple-music-surface",
          "apple-music-white"
        ],
        "doesNotPairWith": [
          "apple-music-gray",
          "apple-music-gray-light"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://brandcolorcode.com/apple-music",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Apple, Apple Music, the Apple Music wordmark, and the pink-to-red gradient mark are trademarks of Apple Inc. This atom captures brand-atoms' read of Apple Music's publicly observable identity (the marketing site at apple.com/apple-music/ and the iOS / macOS app icon and wordmark) cross-referenced against third-party brand-color aggregators. It is not an official Apple brand-guidelines document.\n",
      "importedDate": "2026-05-19",
      "notes": "Apple Music sits **under the `apple@1` parent brand**. The parent atom MUST NOT be modified by this child; relationship is documented here in prose only. Apple does not publish explicit hex values for the Apple Music gradient — the pink (#FF4E6B) and red (#FF0436) values are the closest third-party-reported approximations per brandcolorcode.com. The proprietary SF Pro family is not openly distributed; this atom substitutes `inter@1` as the open-source rendering fallback for both heading and body roles, mirroring the convention used by other Apple-family atoms in this catalog.\n"
    },
    "com.brand-atoms.references": {
      "palette": "apple-music@1.0.0",
      "fonts": {
        "heading": "inter@1.0.0",
        "body": "inter@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}