{
  "$description": "Brand: Square (square@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette square@1.0.0",
      "square-blue": {
        "$value": "#006AFF",
        "$type": "color",
        "$description": "Primary brand blue — the Square interactive color, primary CTAs, and merchant accents."
      },
      "square-blue-hover": {
        "$value": "#0058D6",
        "$type": "color",
        "$description": "Authored darker blue for hover/pressed states on the primary action."
      },
      "square-black": {
        "$value": "#000000",
        "$type": "color",
        "$description": "The Square mark itself — solid black on light canvas. Also the wordmark color."
      },
      "square-near-black": {
        "$value": "#1A1A1A",
        "$type": "color",
        "$description": "Authored dark canvas — slightly lifted from pure black for dark-mode comfort."
      },
      "square-ink": {
        "$value": "#212121",
        "$type": "color",
        "$description": "Body text on light surfaces."
      },
      "square-graphite": {
        "$value": "#4F4F4F",
        "$type": "color",
        "$description": "Secondary text on light backgrounds."
      },
      "square-gray": {
        "$value": "#7B7B7B",
        "$type": "color",
        "$description": "Tertiary text and metadata."
      },
      "square-divider": {
        "$value": "#E5E5E5",
        "$type": "color",
        "$description": "Authored hairline divider tone."
      },
      "square-white": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Canonical light canvas."
      },
      "square-fog": {
        "$value": "#F7F7F7",
        "$type": "color",
        "$description": "Authored surface tone for cards and panels."
      },
      "square-surface-dark": {
        "$value": "#2B2B2B",
        "$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.mark.fill",
        "severity": "error",
        "rationale": "The Square mark renders only in solid black (on light surfaces) or reversed white (on dark surfaces). Blue is the interactive color for CTAs and links — not a mark fill. Recoloring the square into off-brand hues violates Square's brand-use guidance.\n",
        "allowed": [
          "square-black",
          "square-white"
        ],
        "forbidden": [
          "square-blue",
          "square-blue-hover",
          "square-ink",
          "square-graphite"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "The Square mark is a literal geometric square — its identity depends on exact proportions and a flat solid fill. Stretching, rotating beyond 0°, recoloring, or applying drop-shadows breaks the most essential brand cue.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "gradient-fill",
          "on-busy-photo",
          "inverted-without-variant"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "Square Ink (#212121) on Square White (#FFFFFF) gives ~16: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": "Square Blue (#006AFF) on white reaches ~5.6:1 — clears AA for normal text. Buttons using the blue fill with white text exceed 6:1; this rule guards link usage so the brand interactive color stays AA-compliant against the canvas.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "warning",
        "rationale": "Square's marketing surfaces use Sharp Sans in Medium (500), Semibold (600), and Bold (700) for headlines. Lighter cuts read as body weight and compromise the confident merchant-facing voice; heavier cuts are outside the standard corporate kit.\n",
        "allowed": [
          "500",
          "600",
          "700"
        ]
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.mark",
        "severity": "error",
        "rationale": "Square Black is reserved for the mark, the wordmark, and primary headlines. Using solid #000000 for body text or secondary links muddles the mark/text hierarchy the brand depends on; use Square Ink (#212121) for body instead.\n",
        "forbiddenContexts": [
          "body-text",
          "secondary-link"
        ]
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Square's seller-facing surfaces have an elevated trust requirement; AA is the floor on any new role pairing.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      },
      {
        "type": "fontPairing",
        "target": "typography.heading",
        "severity": "warning",
        "rationale": "Square's marketing hero typography runs materially larger than body copy. A 1.5× minimum size ratio preserves the display-to- prose hierarchy the seller-facing voice depends on.\n",
        "requires": "body",
        "minSizeRatio": 1.5
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://squareup.com/us/en/about/press",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Block, Inc. / Square — Square, the Square wordmark, and the Square mark are registered trademarks of Block, Inc. The signature Square Blue (#006AFF) is documented across Square's press kit and visible in the deployed squareup.com marketing surfaces. Sharp Sans is the proprietary corporate typeface historically used across Square; Inter is referenced here as the open-source fallback.\n",
      "importedDate": "2026-05-18",
      "notes": "Square's parent rebranded to Block in 2021. The Square seller brand retained its identity. Sharp Sans (proprietary) is not publicly distributed; this atom references Inter for both heading and body roles and notes Sharp Sans in provenance. The Square mark is rendered in solid black on light surfaces or in reversed white on dark; \"recolored\" treatments are forbidden.\n"
    },
    "com.brand-atoms.references": {
      "palette": "square@1.0.0",
      "fonts": {
        "heading": "inter@1.0.0",
        "body": "inter@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}