{
  "$description": "Brand: Hugging Face — light mode",
  "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."
      }
    },
    "roles": {
      "$description": "Semantic color roles (light mode) mapped to palette swatches",
      "background": {
        "$value": "{color.swatches.hub-canvas}",
        "$type": "color",
        "$description": "background role → Hub Canvas"
      },
      "surface": {
        "$value": "{color.swatches.hub-surface}",
        "$type": "color",
        "$description": "surface role → Hub Surface"
      },
      "surface-elevated": {
        "$value": "{color.swatches.hub-surface-elevated}",
        "$type": "color",
        "$description": "surface-elevated role → Hub Surface Elevated"
      },
      "text-primary": {
        "$value": "{color.swatches.hub-ink}",
        "$type": "color",
        "$description": "text-primary role → Hub Ink"
      },
      "text-secondary": {
        "$value": "{color.swatches.hub-ink-secondary}",
        "$type": "color",
        "$description": "text-secondary role → Hub Ink Secondary"
      },
      "text-tertiary": {
        "$value": "{color.swatches.hub-ink-tertiary}",
        "$type": "color",
        "$description": "text-tertiary role → Hub Ink Tertiary"
      },
      "primary": {
        "$value": "{color.swatches.hug-yellow}",
        "$type": "color",
        "$description": "primary role → Hug Yellow"
      },
      "primary-hover": {
        "$value": "{color.swatches.hug-yellow-deep}",
        "$type": "color",
        "$description": "primary-hover role → Hug Yellow Deep"
      },
      "accent": {
        "$value": "{color.swatches.hug-orange}",
        "$type": "color",
        "$description": "accent role → Hug Orange"
      },
      "accent-hover": {
        "$value": "{color.swatches.hug-orange-deep}",
        "$type": "color",
        "$description": "accent-hover role → Hug Orange Deep"
      },
      "success": {
        "$value": "{color.swatches.hub-success}",
        "$type": "color",
        "$description": "success role → Hub Success"
      },
      "warning": {
        "$value": "{color.swatches.hug-orange}",
        "$type": "color",
        "$description": "warning role → Hug Orange"
      },
      "error": {
        "$value": "{color.swatches.hub-error}",
        "$type": "color",
        "$description": "error role → Hub Error"
      },
      "border": {
        "$value": "{color.swatches.hub-border}",
        "$type": "color",
        "$description": "border role → Hub Border"
      },
      "brand-overrides": {
        "$description": "Brand-level role overrides (take precedence over palette role mappings)",
        "identity": {
          "$value": "{color.swatches.hug-yellow}",
          "$type": "color",
          "$description": "Brand role identity → Hug Yellow"
        },
        "on-identity": {
          "$value": "{color.swatches.hub-ink}",
          "$type": "color",
          "$description": "Brand role on-identity → Hub Ink"
        },
        "primary": {
          "$value": "{color.swatches.hug-yellow}",
          "$type": "color",
          "$description": "Brand role primary → Hug Yellow"
        },
        "primary-hover": {
          "$value": "{color.swatches.hug-yellow-deep}",
          "$type": "color",
          "$description": "Brand role primary-hover → Hug Yellow Deep"
        },
        "accent": {
          "$value": "{color.swatches.hug-orange}",
          "$type": "color",
          "$description": "Brand role accent → Hug Orange"
        },
        "accent-hover": {
          "$value": "{color.swatches.hug-orange-deep}",
          "$type": "color",
          "$description": "Brand role accent-hover → Hug Orange Deep"
        },
        "mark": {
          "$value": "{color.swatches.hug-yellow}",
          "$type": "color",
          "$description": "Brand role mark → Hug Yellow"
        },
        "success": {
          "$value": "{color.swatches.hub-success}",
          "$type": "color",
          "$description": "Brand role success → Hub Success"
        },
        "warning": {
          "$value": "{color.swatches.hug-orange}",
          "$type": "color",
          "$description": "Brand role warning → Hug Orange"
        },
        "error": {
          "$value": "{color.swatches.hub-error}",
          "$type": "color",
          "$description": "Brand role error → Hub Error"
        },
        "text-primary-light": {
          "$value": "{color.swatches.hub-ink}",
          "$type": "color",
          "$description": "Brand role text-primary-light → Hub Ink"
        },
        "text-primary-dark": {
          "$value": "{color.swatches.hub-canvas}",
          "$type": "color",
          "$description": "Brand role text-primary-dark → Hub Canvas"
        },
        "background-light": {
          "$value": "{color.swatches.hub-canvas}",
          "$type": "color",
          "$description": "Brand role background-light → Hub Canvas"
        },
        "background-dark": {
          "$value": "{color.swatches.hub-night}",
          "$type": "color",
          "$description": "Brand role background-dark → Hub Night"
        },
        "surface-light": {
          "$value": "{color.swatches.hub-surface}",
          "$type": "color",
          "$description": "Brand role surface-light → Hub Surface"
        },
        "surface-dark": {
          "$value": "{color.swatches.hub-night-surface}",
          "$type": "color",
          "$description": "Brand role surface-dark → Hub Night Surface"
        },
        "text-secondary-light": {
          "$value": "{color.swatches.hub-ink-secondary}",
          "$type": "color",
          "$description": "Brand role text-secondary-light → Hub Ink Secondary"
        },
        "text-tertiary-light": {
          "$value": "{color.swatches.hub-ink-tertiary}",
          "$type": "color",
          "$description": "Brand role text-tertiary-light → Hub Ink Tertiary"
        },
        "border-light": {
          "$value": "{color.swatches.hub-border}",
          "$type": "color",
          "$description": "Brand role border-light → Hub Border"
        }
      }
    }
  },
  "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"
      }
    }
  }
}