{
  "$description": "Brand: Apple (apple@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette apple@1.0.0",
      "system-blue": {
        "$value": "#007AFF",
        "$type": "color",
        "$description": "Default iOS tint color. Used for interactive elements (links, buttons, switches) across iOS, iPadOS, and macOS.\n"
      },
      "system-brown": {
        "$value": "#A2845E",
        "$type": "color",
        "$description": "Earth-tone accent in the HIG System Colors set."
      },
      "system-gray": {
        "$value": "#8E8E93",
        "$type": "color",
        "$description": "Mid-gray for secondary content and inactive controls. Equivalent to UIColor.systemGray.\n"
      },
      "system-green": {
        "$value": "#34C759",
        "$type": "color",
        "$description": "Confirmation / success accent (e.g., toggle switches in the \"on\" state, recording indicators).\n"
      },
      "system-indigo": {
        "$value": "#5856D6",
        "$type": "color",
        "$description": "Cool-violet accent in the HIG System Colors set."
      },
      "system-mint": {
        "$value": "#00C7BE",
        "$type": "color",
        "$description": "Cool-teal accent introduced in iOS 15."
      },
      "system-orange": {
        "$value": "#FF9500",
        "$type": "color",
        "$description": "Warning accent. Used on system controls that signal caution (e.g., Cellular Data warnings).\n"
      },
      "system-pink": {
        "$value": "#FF2D55",
        "$type": "color",
        "$description": "Warm-pink accent in the HIG System Colors set."
      },
      "system-purple": {
        "$value": "#AF52DE",
        "$type": "color",
        "$description": "Purple accent. Used on Siri, Podcasts, and other identity-bearing Apple product surfaces.\n"
      },
      "system-red": {
        "$value": "#FF3B30",
        "$type": "color",
        "$description": "Destructive / error accent. Used for delete actions, error states, and recording indicators.\n"
      },
      "system-teal": {
        "$value": "#30B0C7",
        "$type": "color",
        "$description": "Cooler complement to System Mint in the HIG set."
      },
      "system-yellow": {
        "$value": "#FFCC00",
        "$type": "color",
        "$description": "Highlight / warning accent in the HIG System Colors set."
      },
      "label": {
        "$value": "#000000",
        "$type": "color",
        "$description": "Primary text on light-mode surfaces. Equivalent to the HIG `label` semantic color in Light Appearance.\n"
      },
      "secondary-label": {
        "$value": "#3C3C43",
        "$type": "color",
        "$description": "Secondary text. Equivalent to the HIG `secondaryLabel` (60% alpha black resolved against systemBackground) in Light.\n"
      },
      "tertiary-label": {
        "$value": "#3C3C434D",
        "$type": "color",
        "$description": "Tertiary text. Equivalent to the HIG `tertiaryLabel` (~30% alpha) in Light.\n"
      },
      "system-background": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Base background in Light Appearance."
      },
      "secondary-system-background": {
        "$value": "#F2F2F7",
        "$type": "color",
        "$description": "Grouped-table and grouped-cell background in Light."
      },
      "tertiary-system-background": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Elevated card / sheet background in Light."
      },
      "system-background-dark": {
        "$value": "#000000",
        "$type": "color",
        "$description": "Base background in Dark Appearance."
      },
      "secondary-system-background-dark": {
        "$value": "#1C1C1E",
        "$type": "color",
        "$description": "Grouped-cell background in Dark."
      },
      "tertiary-system-background-dark": {
        "$value": "#2C2C2E",
        "$type": "color",
        "$description": "Elevated card / sheet background in Dark."
      },
      "label-dark": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Primary text on dark-mode surfaces."
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "SF Pro",
          "Inter",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → SF Pro (sf-pro@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": [
          "SF Pro",
          "Inter",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → SF Pro (sf-pro@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": [
          "SF Pro",
          "Inter",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "mono role → SF Pro (sf-pro@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"
      }
    }
  },
  "$extensions": {
    "com.brand-atoms.rules": [
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "The Apple Identity Guidelines explicitly prohibit altering the proportions, color, orientation, or surrounding clearspace of the Apple logo. Only the approved monochrome variants (black, white, or single-color silver / gray) are permitted, and only on backgrounds that meet the documented contrast threshold.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "on-busy-photo",
          "outlined"
        ]
      },
      {
        "type": "colorChoice",
        "target": "logo.mark.fill",
        "severity": "error",
        "rationale": "The Apple mark is monochrome. The Identity Guidelines prohibit filling the logo with any of the System Colors — the chromatic System Colors are reserved for product UI tint, not for the corporate mark.\n",
        "allowed": [
          "label",
          "label-dark",
          "system-gray"
        ],
        "forbidden": [
          "system-blue",
          "system-red",
          "system-green",
          "system-yellow",
          "system-orange",
          "system-purple"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "WCAG 2.1 Level AA contrast requirement for body text. The HIG Accessibility section calls out 4.5:1 as the floor for body text and 3:1 for large text on a typical iOS surface; Label on System Background clears AA at ~21:1.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contrastRatio",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "System Blue on System Background must remain perceptible at interactive-control size. The HIG specifies that tint colors need at least 3:1 contrast against the underlying surface to preserve the \"tappable\" affordance.\n",
        "against": "background",
        "minRatio": 3,
        "standard": "WCAG-AA-large"
      },
      {
        "type": "fontPairing",
        "target": "typography.heading",
        "severity": "recommendation",
        "rationale": "Apple's HIG uses SF Pro for both heading and body, distinguished by the SF Pro Display vs SF Pro Text optical-size cuts and a meaningful size differential. Maintain at least a 1.3× ratio between heading and body to preserve hierarchy when one family does both jobs.\n",
        "requires": "body",
        "minSizeRatio": 1.3
      },
      {
        "type": "enumMembership",
        "target": "typography.body.fontWeight",
        "severity": "recommendation",
        "rationale": "The HIG type ramp uses SF Pro Regular (400) for body, Medium (500) for emphasis, and Semibold (600) for headings and controls. Lighter weights (100–300) are reserved for very large display sizes; bolder weights (700+) are rare in iOS UI.\n",
        "allowed": [
          "400",
          "500",
          "600"
        ]
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. The HIG Accessibility section aligns Apple's platform guidance with WCAG AA contrast as the floor for legible text-on-surface pairings.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.system-red",
        "severity": "warning",
        "rationale": "System Red is semantically reserved for destructive actions and error / recording indicators in the HIG. Using it as a marketing accent dilutes the platform-wide affordance that \"red means destructive.\"\n",
        "forbiddenContexts": [
          "marketing-headline",
          "hero-background"
        ]
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://developer.apple.com/design/human-interface-guidelines/",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Apple, the Apple logo, iPhone, iPad, Mac, iOS, macOS, iPadOS, watchOS, tvOS, visionOS, Human Interface Guidelines, and related names and marks are trademarks of Apple Inc. Brand colors and identity guidance documented here are derived from the Human Interface Guidelines at developer.apple.com/design/human-interface-guidelines/ and the Apple Identity Guidelines distributed to platform partners.\n",
      "importedDate": "2026-05-17",
      "notes": "Brand-atoms' read of Apple's public HIG. This file is not an official Apple brand document. Apple's logo is among the most- protected trademarks on the internet; no asset files are bundled here and any reference to \"the Apple logo\" must respect the Identity Guidelines.\n"
    },
    "com.brand-atoms.references": {
      "palette": "apple@1.0.0",
      "fonts": {
        "heading": "sf-pro@1.0.0",
        "body": "sf-pro@1.0.0",
        "mono": "sf-pro@1.0.0"
      }
    }
  }
}