{
  "$description": "Brand: Hugging Face (huggingface@1.0.0)",
  "color": {
    "swatches": {
      "$description": "Source-of-truth color swatches from palette huggingface@1.0.0",
      "hug-yellow": {
        "$value": "#FFD21E",
        "$type": "color",
        "$description": "Hugging Face's published primary — the warm yellow of the hug-mark."
      },
      "hug-yellow-deep": {
        "$value": "#E6B800",
        "$type": "color",
        "$description": "Pressed / hover variant of hug-yellow for interactive surfaces."
      },
      "hug-orange": {
        "$value": "#FF9D00",
        "$type": "color",
        "$description": "Hugging Face's published secondary — a warm orange that pairs with the yellow primary."
      },
      "hug-orange-deep": {
        "$value": "#CC7E00",
        "$type": "color",
        "$description": "Pressed / hover variant of hug-orange."
      },
      "hug-neutral": {
        "$value": "#6B7280",
        "$type": "color",
        "$description": "Hugging Face's published neutral gray — the body-meta tone."
      },
      "hub-canvas": {
        "$value": "#FFFFFF",
        "$type": "color",
        "$description": "Page canvas — the bright neutral surface huggingface.co reads against."
      },
      "hub-surface": {
        "$value": "#F9FAFB",
        "$type": "color",
        "$description": "Subtle elevated surface; one step warmer than canvas."
      },
      "hub-surface-elevated": {
        "$value": "#F3F4F6",
        "$type": "color",
        "$description": "Card / panel surface elevated above hub-surface."
      },
      "hub-border": {
        "$value": "#E5E7EB",
        "$type": "color",
        "$description": "Quiet divider on the hub canvas."
      },
      "hub-ink": {
        "$value": "#111827",
        "$type": "color",
        "$description": "Primary text on hub canvas — deep slate near-black."
      },
      "hub-ink-secondary": {
        "$value": "#374151",
        "$type": "color",
        "$description": "Secondary text; muted slate for body copy de-emphasis."
      },
      "hub-ink-tertiary": {
        "$value": "#6B7280",
        "$type": "color",
        "$description": "Tertiary text / metadata tone — same hex as the published hug-neutral."
      },
      "hub-night": {
        "$value": "#0B0F19",
        "$type": "color",
        "$description": "Dark-mode canvas — the deep slate the hub flips to."
      },
      "hub-night-surface": {
        "$value": "#1F2937",
        "$type": "color",
        "$description": "Elevated surface in dark mode."
      },
      "hub-night-border": {
        "$value": "#374151",
        "$type": "color",
        "$description": "Quiet divider on the hub-night canvas."
      },
      "hub-success": {
        "$value": "#16A34A",
        "$type": "color",
        "$description": "Confirmation / positive state green."
      },
      "hub-error": {
        "$value": "#DC2626",
        "$type": "color",
        "$description": "Error / destructive state red."
      }
    }
  },
  "font": {
    "$description": "Typography roles mapped to font atoms",
    "heading": {
      "family": {
        "$value": [
          "Source Sans 3",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "heading role → Source Sans 3 (source-sans-3@1.0.0)"
      },
      "weight": {
        "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": [
          "Source Sans 3",
          "-apple-system",
          "BlinkMacSystemFont",
          "Segoe UI",
          "Roboto",
          "Helvetica Neue",
          "Arial",
          "sans-serif"
        ],
        "$type": "fontFamily",
        "$description": "body role → Source Sans 3 (source-sans-3@1.0.0)"
      },
      "weight": {
        "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 hug-mark renders in its signature Hug Yellow (#FFD21E), in monochrome ink on light surfaces, or in monochrome canvas on dark surfaces — per the four logo variants published at huggingface.co/brand (HF Logo, HF Logo with Title, HF Logo Monochrome, HF Logo Pirate). The secondary orange is a supporting accent, not a mark fill.\n",
        "allowed": [
          "hug-yellow",
          "hub-ink",
          "hub-canvas"
        ],
        "forbidden": [
          "hug-orange",
          "hub-success",
          "hub-error",
          "hub-night"
        ]
      },
      {
        "type": "colorChoice",
        "target": "roles.colors.primary",
        "severity": "error",
        "rationale": "Hugging Face's published brand page names Hug Yellow as the primary and Hug Orange as the secondary. Swapping them inverts the brand hierarchy — the yellow is the identity, the orange supports it.\n",
        "allowed": [
          "hug-yellow",
          "hug-yellow-deep"
        ],
        "forbidden": [
          "hug-orange",
          "hub-ink",
          "hub-canvas"
        ]
      },
      {
        "type": "forbiddenTreatment",
        "target": "logo",
        "severity": "error",
        "rationale": "Hugging Face publishes specific monochrome and pirate logo variants; consumers must use those variants rather than apply effects to the full-color mark. Stretching, rotating, or drop-shadowing the hug breaks the warm, hand-drawn voice.\n",
        "treatments": [
          "stretched",
          "rotated",
          "recolored",
          "drop-shadow",
          "gradient-fill",
          "on-busy-photo"
        ]
      },
      {
        "type": "contrastRatio",
        "target": "text-primary",
        "severity": "error",
        "rationale": "Hub Ink (#111827) on Hub Canvas (#FFFFFF) reads at ~17:1 — well above WCAG AA. Long-form model cards and dataset docs depend on holding that floor.\n",
        "against": "background",
        "minRatio": 4.5,
        "standard": "WCAG-AA"
      },
      {
        "type": "contextRestriction",
        "target": "roles.colors.primary",
        "severity": "warning",
        "rationale": "Hug Yellow (#FFD21E) on white reads at ~1.6:1 contrast — far below the AA 4.5:1 floor for body text. The yellow is for brand-mark surfaces and large emphasis blocks, never for small text or thin iconography on a light canvas.\n",
        "forbiddenContexts": [
          "body-text",
          "small-icon-on-light"
        ]
      },
      {
        "type": "enumMembership",
        "target": "typography.heading.fontWeight",
        "severity": "warning",
        "rationale": "The live huggingface.co surface renders display headings at 400 / 600 / 700 on Source Sans Pro. The substitute Source Sans 3 family carries the same weight band; intermediate weights are not part of the published display set.\n",
        "allowed": [
          "400",
          "600",
          "700"
        ]
      },
      {
        "type": "compositionConstraint",
        "target": "roles.colors.primary",
        "severity": "recommendation",
        "rationale": "Hug Yellow reads cleanest against deep ink, bright canvas, or alongside its warm secondary orange. Adjacent saturated reds or greens fight the warm-on-bright voice and read as product-state semantics rather than brand identity.\n",
        "pairsWith": [
          "hub-ink",
          "hub-canvas",
          "hug-orange"
        ],
        "doesNotPairWith": [
          "hub-error",
          "hub-success"
        ]
      },
      {
        "type": "accessibilityRequirement",
        "target": "*",
        "severity": "error",
        "rationale": "WCAG 2.1 Success Criterion 1.4.3 (Contrast Minimum) — Level AA. Hugging Face's Hub canvas pairs deep slate ink with bright surfaces, comfortably clearing AA; consumers must hold this floor across the adapted palette.\n",
        "standard": "WCAG-AA",
        "criterion": "1.4.3"
      }
    ],
    "com.brand-atoms.assets": [],
    "com.brand-atoms.provenance": {
      "source": "https://huggingface.co/brand",
      "license": "Proprietary — All Rights Reserved",
      "attribution": "Hugging Face and the hug-mark are trademarks of Hugging Face, Inc. Primary, secondary, and neutral brand colors captured directly from the official brand-assets page at huggingface.co/brand. Typography and surface tokens captured from the deployed stylesheet on huggingface.co.\n",
      "importedDate": "2026-05-19",
      "notes": "Hugging Face publishes a brand-assets page (huggingface.co/brand) that documents the primary, secondary, and neutral hex values and the logo variants (HF Logo, HF Logo with Title, Monochrome, Pirate) — but does not document a full typography or surface system. Surface and ink tokens are therefore supplemented from the live huggingface.co stylesheet on 2026-05-19. Source Sans Pro is the proprietary body face declared on the marketing site; Source Sans 3 is the open-source rendering substitute used here via the source-sans-3@1 atom.\n"
    },
    "com.brand-atoms.references": {
      "palette": "huggingface@1.0.0",
      "fonts": {
        "heading": "source-sans-3@1.0.0",
        "body": "source-sans-3@1.0.0",
        "mono": "jetbrainsmono-nerdfont@1.0.0"
      }
    }
  }
}