{
  "$description": "Brand: Samsung (samsung@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette samsung@1.0.0",
      "samsung-blue": {
        "$value": "#1428A0",
        "$type": "color",
        "$description": "The signature Samsung wordmark blue. The brand's identity color and the only chromatic primary on the parent mark.\n"
      },
      "action-blue": {
        "$value": "#2189FF",
        "$type": "color",
        "$description": "Brighter action blue used on CTAs in the UX25 dark UI — higher contrast on dark surfaces than the corporate blue.\n"
      },
      "action-blue-pressed": {
        "$value": "#006BEA",
        "$type": "color",
        "$description": "Pressed / hover variant of Action Blue."
      },
      "link-blue": {
        "$value": "#0381FE",
        "$type": "color",
        "$description": "Inline link color on the white canvas."
      },
      "light-blue": {
        "$value": "#68AEFF",
        "$type": "color",
        "$description": "Light blue secondary; muted hover affordance."
      },
      "legacy-navy": {
        "$value": "#0C4DA2",
        "$type": "color",
        "$description": "Older Samsung navy still present on US legacy templates; a softer mid-navy than the corporate #1428A0.\n"
      },
      "white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Default page canvas; reverse wordmark fill."
      },
      "gray-50": {
        "$value": "#F7F7F7",
        "$type": "color",
        "$description": "Light page surface tint."
      },
      "gray-100": {
        "$value": "#F4F4F4",
        "$type": "color",
        "$description": "Subtle elevated surface."
      },
      "gray-200": {
        "$value": "#E7E7E7",
        "$type": "color",
        "$description": "Quiet rule / border on the white canvas."
      },
      "gray-300": {
        "$value": "#CBCBCB",
        "$type": "color",
        "$description": "Mid-light gray; disabled borders."
      },
      "gray-400": {
        "$value": "#8F8F8F",
        "$type": "color",
        "$description": "Mid-gray for inactive controls."
      },
      "gray-500": {
        "$value": "#757575",
        "$type": "color",
        "$description": "Tertiary text on the white canvas."
      },
      "gray-600": {
        "$value": "#6E6E73",
        "$type": "color",
        "$description": "Cool secondary text — the value declared inline on the samsung.com US homepage.\n"
      },
      "gray-700": {
        "$value": "#363636",
        "$type": "color",
        "$description": "Elevated dark surface on the UX25 dark canvas."
      },
      "gray-800": {
        "$value": "#313131",
        "$type": "color",
        "$description": "Dark surface; near-canvas in UX25 dark UI."
      },
      "gray-900": {
        "$value": "#1C1C1C",
        "$type": "color",
        "$description": "Near-black; canvas in UX25 dark UI."
      },
      "black": {
        "$value": "#000000",
        "$type": "color",
        "$description": "Primary text on light surfaces; logo fill in mono."
      },
      "success": {
        "$value": "#007E3B",
        "$type": "color",
        "$description": "Confirmation / success state color."
      },
      "warning": {
        "$value": "#F66700",
        "$type": "color",
        "$description": "Warning / caution state color."
      },
      "error": {
        "$value": "#EF3434",
        "$type": "color",
        "$description": "Error / destructive state color."
      }
    }
  },
  "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": "roles.colors.mark",
        "severity": "error",
        "rationale": "The Samsung wordmark fills with Samsung Blue (#1428A0) on light surfaces, or with monochrome black-on-light / white-on-dark when a one-color treatment is required. The brighter action blues are product-UI affordances; the legacy navy (#0C4DA2) is a softer historical variant. Substituting any of them for the corporate blue dilutes the wordmark's anchor color.\n",
        "allowed": [
          "samsung-blue",
          "black",
          "white"
        ],
        "forbidden": [
          "action-blue",
          "link-blue",
          "light-blue",
          "legacy-navy",
          "gray-600"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "The Samsung wordmark is a fixed-proportion identity. The live site uses it only in solid-color treatments (Samsung Blue, black, or white) on plain backgrounds. Skewing, rotating, gradient-filling, drop-shadowing, or placing the mark on a busy photo conflicts with the restrained corporate identity.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "gradient-fill",
          "on-busy-photo",
          "outlined",
          "distorted"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "Black (#000000) on white (#FFFFFF) measures ~21:1 — clears WCAG AA at the body-text floor decisively. The high- contrast monochrome posture is the parent brand's default reading environment.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contrastRatio",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "Samsung Blue (#1428A0) on white (#FFFFFF) measures ~11:1 — clears WCAG AA for body text decisively. This headroom is meaningful because Samsung Blue is used not only on the wordmark but also on inline links inside paragraph text.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "colorChoice",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "The identity-primary role is filled by Samsung Blue (default), Action Blue (on dark UX25 surfaces), or Legacy Navy (on legacy US templates). Link Blue (#0381FE) and Light Blue (#68AEFF) are inline-link and hover affordances — not primary action colors.\n",
        "allowed": [
          "samsung-blue",
          "action-blue",
          "legacy-navy"
        ],
        "forbidden": [
          "link-blue",
          "light-blue",
          "gray-600"
        ]
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.error",
        "severity": "error",
        "rationale": "Error (#EF3434) is the destructive / failure-state accent in the UX25 product UI. It must not appear in marketing context — the brand's marketing CTAs are blue, not red, and treating Error as a brand color collapses the destructive-state affordance.\n",
        "allowedContexts": [
          "error-state",
          "destructive-action",
          "form-validation"
        ],
        "forbiddenContexts": [
          "marketing-headline",
          "hero-background",
          "cta"
        ]
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. The monochrome-on-white text pairings and Samsung Blue inline links all clear AA at the body-text floor with significant headroom.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "fontPairing",
        "target": "typography.display",
        "severity": "recommendation",
        "rationale": "Samsung's marketing surfaces pair SamsungSharpSans (display, proprietary) with SamsungOne (body, proprietary) on the live site. Maintain at least a 1.3× ratio between display and prose to preserve the two-family hierarchy when both roles render through the Inter substitute.\n",
        "requires": "prose",
        "minSizeRatio": 1.3
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://www.samsung.com/us/",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Samsung Electronics Co., Ltd. — identity values captured from the deployed stylesheet on samsung.com (us.css, ux25 base CSS, and inline declarations on the US homepage). Samsung, the Samsung logo, Galaxy, Bespoke, Bixby, SmartThings, SamsungOne, and Samsung Sharp Sans are trademarks of Samsung Electronics Co., Ltd.\n",
      "importedDate": "2026-05-18",
      "notes": "Derived from live site CSS at https://www.samsung.com/us/ on 2026-05-18; the published brand-identity guide at samsung.com/global/about-us/brand-identity/ is unavailable (returns 403 to non-browser clients). The proprietary brand typefaces (SamsungOne for body, SamsungSharpSans for display) are declared on samsung.com via @font-face but are not publicly distributed. This atom references Inter@1 as the open-source rendering substitute. Scope is the parent corporate identity only — Galaxy, Bespoke, SmartThings, and other sub-brands are deferred. assets: [] per the encyclopedia's trademark-redistribution policy.\n"
    },
    "com.brand-atoms.references": {
      "palette": "samsung@1.0.0",
      "fonts": {
        "heading": "inter@1.0.0",
        "body": "inter@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}