{
  "$schema": "./tokens.schema.json",
  "meta": {
    "brand": "CRAFTSMAN+",
    "theme": "SUNSET",
    "version": "1.0.0",
    "canonical": "https://brand.craftsmanplus.com",
    "note": "Single source of truth for the CRAFTSMAN+ brand. Every downstream artifact (CSS, Tailwind theme, downloads, API) is generated from this file. Do not hardcode these values anywhere else.",
    "mode": "dark",
    "modeNote": "All CRAFTSMAN+ content is dark mode. Light-mode content is never created."
  },
  "color": {
    "black": {
      "formal": "CRAFTSMAN BLACK",
      "codename": "MIDNIGHT",
      "hex": "#090909",
      "tier": "primary-monotone",
      "usage": "The solid ground. Working surfaces, dense content, and anywhere a gradient would compete. Never substitute #000000; the off-pure black is deliberate."
    },
    "white": {
      "formal": "CRAFTSMAN WHITE",
      "codename": "STARLIGHT",
      "hex": "#FDFDFD",
      "tier": "primary-monotone",
      "usage": "Type and marks on dark grounds. Never a background: all CRAFTSMAN+ content is dark mode. Never substitute #FFFFFF."
    },
    "grey": {
      "formal": "CRAFTSMAN GREY",
      "codename": "METEOR",
      "hex": "#E3E3E3",
      "tier": "primary-monotone",
      "usage": "Secondary type, dividers, and the third chart series. Spelled GREY, never gray or silver."
    },
    "orange": {
      "formal": "CRAFTSMAN ORANGE",
      "codename": "GARIBALDI",
      "hex": "#F86400",
      "tier": "primary-color",
      "usage": "Primary accent. Where the brand shows up. First series in any chart."
    },
    "pink": {
      "formal": "CRAFTSMAN PINK",
      "codename": "CORAL",
      "hex": "#EB5173",
      "tier": "primary-color",
      "usage": "Primary accent alongside Orange. Second series in any chart."
    },
    "purple": {
      "formal": "CRAFTSMAN PURPLE",
      "codename": "URCHIN",
      "hex": "#8912A0",
      "tier": "product",
      "usage": "The third stop of the INTELLIGENCE palette and the marker for AI. Using it on a non-AI surface removes the only signal that an AI feature is present.",
      "product": "INTELLIGENCE"
    },
    "prismViolet": {
      "formal": "PRISM VIOLET",
      "codename": "ANEMONE",
      "hex": "#9249F5",
      "tier": "product",
      "product": "PRISM",
      "usage": "First stop of the PRISM palette."
    },
    "prismBlue": {
      "formal": "PRISM BLUE",
      "codename": "LAGOON",
      "hex": "#4492D3",
      "tier": "product",
      "product": "PRISM",
      "usage": "Middle stop of the PRISM palette."
    },
    "prismTeal": {
      "formal": "PRISM TEAL",
      "codename": "REEF",
      "hex": "#06CAB8",
      "tier": "product",
      "product": "PRISM",
      "usage": "Final stop of the PRISM palette."
    },
    "analyticsGreen": {
      "formal": "ANALYTICS GREEN",
      "codename": "KELP",
      "hex": "#22A800",
      "tier": "product",
      "product": "ANALYTICS",
      "usage": "First stop of the ANALYTICS palette."
    },
    "analyticsLime": {
      "formal": "ANALYTICS LIME",
      "codename": "SEAGRASS",
      "hex": "#49E400",
      "tier": "product",
      "product": "ANALYTICS",
      "usage": "Middle stop of the ANALYTICS palette."
    },
    "analyticsYellow": {
      "formal": "ANALYTICS YELLOW",
      "codename": "PLANKTON",
      "hex": "#FAFF1F",
      "tier": "product",
      "product": "ANALYTICS",
      "usage": "Final stop of the ANALYTICS palette."
    }
  },
  "gradient": {
    "craftsmanPlus": {
      "formal": "CRAFTSMAN+ GRADIENT",
      "stops": [
        "#F86400",
        "#EB5173"
      ],
      "angle": 90,
      "surface": "brand",
      "darkVariant": "craftsmanPlusDark",
      "usage": "The primary brand gradient. Accents, gradient text, and PLAY surfaces and identity."
    },
    "craftsmanPlusDark": {
      "formal": "CRAFTSMAN+ GRADIENT DARK",
      "stops": [
        "#2A1B11",
        "#29191D"
      ],
      "angle": 135,
      "surface": "brand",
      "usage": "Dark background variant of the CRAFTSMAN+ GRADIENT. Used sparingly, for PLAY surfaces; NEBULA is the default ground. Do not lighten it to make it visible."
    },
    "intelligence": {
      "formal": "INTELLIGENCE",
      "stops": [
        "#F86400",
        "#EB5173",
        "#8912A0"
      ],
      "angle": 90,
      "surface": "intelligence",
      "darkVariant": "intelligenceDark",
      "usage": "INTELLIGENCE and AI features only."
    },
    "intelligenceDark": {
      "formal": "INTELLIGENCE DARK",
      "stops": [
        "#2A1B11",
        "#29191D",
        "#1F1321"
      ],
      "angle": 135,
      "surface": "intelligence",
      "usage": "Dark backgrounds on INTELLIGENCE surfaces. Used sparingly; NEBULA is the default ground."
    },
    "minimal": {
      "formal": "CRAFTSMAN+ MINIMAL GRADIENT",
      "codename": "NEBULA",
      "stops": [
        "#260D12",
        "#090909",
        "#281000"
      ],
      "angle": 135,
      "surface": "platform",
      "usage": "The default ground. Main backgrounds use NEBULA nine times out of ten; it reads as texture rather than color. Midpoint is CRAFTSMAN BLACK #090909, not pure black."
    },
    "prism": {
      "formal": "PRISM",
      "stops": [
        "#9249F5",
        "#4492D3",
        "#06CAB8"
      ],
      "angle": 90,
      "surface": "prism",
      "darkVariant": "prismDark",
      "usage": "PRISM surfaces, icon, and identity."
    },
    "prismDark": {
      "formal": "PRISM DARK",
      "stops": [
        "#1B1128",
        "#111B23",
        "#092220"
      ],
      "angle": 135,
      "surface": "prism",
      "usage": "Dark backgrounds on PRISM surfaces. A background, not an accent."
    },
    "analytics": {
      "formal": "ANALYTICS",
      "stops": [
        "#22A800",
        "#49E400",
        "#FAFF1F"
      ],
      "positions": [
        14.17,
        57.5,
        99.93
      ],
      "angle": 90,
      "surface": "analytics",
      "darkVariant": "analyticsDark",
      "usage": "ANALYTICS surfaces, icon, and identity."
    },
    "analyticsDark": {
      "formal": "ANALYTICS DARK",
      "stops": [
        "#0C1E08",
        "#112508",
        "#28290C"
      ],
      "angle": 135,
      "surface": "analytics",
      "usage": "Dark backgrounds on ANALYTICS surfaces. A background, not an accent."
    }
  },
  "surface": {
    "bg": {
      "value": "#090909",
      "usage": "Page ground. CRAFTSMAN BLACK."
    },
    "bgAlt": {
      "value": "#0D0D10",
      "usage": "Alternate ground for banded sections."
    },
    "raised": {
      "value": "#111113",
      "usage": "Cards and raised panels."
    },
    "raised2": {
      "value": "#18181B",
      "usage": "Second-level raised surface: popovers, code blocks."
    },
    "border": {
      "value": "rgba(255, 255, 255, 0.06)",
      "usage": "Default hairline border."
    },
    "borderStrong": {
      "value": "rgba(255, 255, 255, 0.12)",
      "usage": "Hover and emphasis borders."
    },
    "textMuted": {
      "value": "#A1A1AA",
      "usage": "Secondary text on dark grounds."
    },
    "textDim": {
      "value": "#71717A",
      "usage": "Tertiary text, captions, meta."
    }
  },
  "typography": {
    "family": {
      "sans": "\"Inter Variable\", \"Inter\", system-ui, -apple-system, \"Segoe UI\", Helvetica, Arial, sans-serif",
      "mono": "\"JetBrains Mono\", ui-monospace, SFMono-Regular, Menlo, monospace"
    },
    "features": "\"ss01\", \"ss02\", \"cv11\"",
    "scale": {
      "display": {
        "size": "clamp(44px, 6vw, 92px)",
        "weight": 900,
        "tracking": "-0.045em",
        "leading": 1.02,
        "usage": "Page heroes. One per page.",
        "designSize": 92
      },
      "h1": {
        "size": "clamp(34px, 4vw, 56px)",
        "weight": 800,
        "tracking": "-0.04em",
        "leading": 1.08,
        "usage": "Page titles.",
        "designSize": 56
      },
      "h2": {
        "size": "clamp(26px, 2.6vw, 36px)",
        "weight": 700,
        "tracking": "-0.02em",
        "leading": 1.16,
        "usage": "Section headings.",
        "designSize": 36
      },
      "h3": {
        "size": "clamp(19px, 1.6vw, 24px)",
        "weight": 600,
        "tracking": "-0.01em",
        "leading": 1.3,
        "usage": "Subsection headings.",
        "designSize": 24
      },
      "bodyLarge": {
        "size": "clamp(16px, 1.3vw, 20px)",
        "weight": 400,
        "tracking": "0",
        "leading": 1.6,
        "usage": "Ledes and intro paragraphs.",
        "designSize": 20
      },
      "body": {
        "size": "15px",
        "weight": 400,
        "tracking": "0",
        "leading": 1.55,
        "usage": "Default body copy.",
        "designSize": 15
      },
      "small": {
        "size": "13px",
        "weight": 400,
        "tracking": "0.01em",
        "leading": 1.5,
        "usage": "Captions and metadata.",
        "designSize": 13
      },
      "eyebrow": {
        "size": "12px",
        "weight": 600,
        "tracking": "0.18em",
        "leading": 1,
        "transform": "uppercase",
        "usage": "Section eyebrows and labels.",
        "designSize": 12
      },
      "mono": {
        "size": "13px",
        "weight": 400,
        "tracking": "0",
        "leading": 1.6,
        "usage": "Code, tokens, and technical values.",
        "designSize": 13
      }
    }
  },
  "space": {
    "unit": 4,
    "scale": [
      4,
      8,
      12,
      16,
      24,
      32,
      48,
      64,
      96,
      140
    ],
    "sectionPad": "clamp(56px, 9vw, 140px)",
    "maxWidth": "min(1440px, 90%)",
    "maxWidthProse": "72ch"
  },
  "radius": {
    "sm": "6px",
    "md": "10px",
    "lg": "14px",
    "card": "20px"
  },
  "elevation": {
    "cardEdge": "inset 0 1px 0 rgba(255, 255, 255, 0.05)",
    "cardLift": "0 16px 40px rgba(0, 0, 0, 0.45), 0 0 28px rgba(248, 100, 0, 0.06), inset 0 1px 0 rgba(255, 255, 255, 0.07)"
  },
  "motion": {
    "easing": {
      "standard": {
        "value": "cubic-bezier(0.2, 0.8, 0.2, 1)",
        "usage": "Default for UI transitions: hovers, reveals, toggles."
      },
      "outQuart": {
        "value": "cubic-bezier(0.25, 1, 0.5, 1)",
        "usage": "Entrances and scroll reveals. Fast start, long settle."
      }
    },
    "duration": {
      "fast": {
        "value": "150ms",
        "usage": "Hovers, small state changes."
      },
      "base": {
        "value": "300ms",
        "usage": "Reveals, toggles, most transitions."
      },
      "slow": {
        "value": "600ms",
        "usage": "Section entrances, large surface moves."
      },
      "ambient": {
        "value": "8000ms",
        "usage": "Background gradient drift. Barely perceptible."
      }
    }
  },
  "texture": {
    "grain": {
      "filter": "feTurbulence type='fractalNoise' baseFrequency='0.9' numOctaves='2'",
      "tileSize": "200px",
      "blend": "overlay",
      "opacity": 0.035,
      "usage": "Fixed full-viewport overlay. The atmospheric layer. Never raise opacity above 0.05."
    }
  }
}
