{
  "id": "hero",
  "name": "Hero",
  "level": "organism",
  "status": "stable",
  "purpose": "The opening section of a landing or welcome page, with its headline and main action.",
  "description": "The canonical landing-page hero — display heading, description, primary + secondary CTAs, optional trust line and media slot. The `prominent` emphasis renders a soft radial gradient using existing feedback-surface tokens; the gradient collapses cleanly under high-contrast theme.",
  "role": "content",
  "import": "@rrios-forge/ui/organisms/hero",
  "exports": [
    "Hero",
    "HERO_ALIGNS",
    "HERO_EMPHASES",
    "HERO_LAYOUTS",
    "HERO_PROMINENCES",
    "HERO_SIZES",
    "heroVariants"
  ],
  "source": "packages/ui/src/organisms/hero",
  "axes": [
    {
      "axis": "prominence",
      "part": null,
      "values": [
        "subtle",
        "default",
        "featured"
      ],
      "default": "subtle",
      "meaning": "How a surface stands among its siblings."
    },
    {
      "axis": "material",
      "part": null,
      "values": [
        "solid",
        "vibrant"
      ],
      "default": "vibrant",
      "meaning": "The layer's material (ADR-022, ADR-027)."
    },
    {
      "axis": "size",
      "part": null,
      "values": [
        "sm",
        "md",
        "lg"
      ],
      "default": "md",
      "meaning": "Ergonomic scale, in three families (control, text, container)."
    },
    {
      "axis": "layout",
      "part": null,
      "values": [
        "stacked",
        "split",
        "centered"
      ],
      "default": "stacked",
      "meaning": "Arrangement of a composite."
    },
    {
      "axis": "align",
      "part": null,
      "values": [
        "start",
        "center"
      ],
      "default": "start",
      "meaning": "Distribution along the main axis."
    }
  ],
  "needs": [
    {
      "need": "Marketing / onboarding hero",
      "answer": "`Hero`"
    }
  ],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [
    {
      "id": "ADR-021",
      "title": "ProfileHeader organism and the `cover` slot contract"
    },
    {
      "id": "ADR-027",
      "title": "Vibrant is the system's material, not one of its members"
    }
  ],
  "stories": [
    {
      "name": "Stacked",
      "id": "components-organisms-hero--stacked",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-organisms-hero--stacked",
      "frame": "/iframe.html?id=components-organisms-hero--stacked&viewMode=story"
    },
    {
      "name": "Split",
      "id": "components-organisms-hero--split",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-organisms-hero--split",
      "frame": "/iframe.html?id=components-organisms-hero--split&viewMode=story"
    },
    {
      "name": "Centered",
      "id": "components-organisms-hero--centered",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-organisms-hero--centered",
      "frame": "/iframe.html?id=components-organisms-hero--centered&viewMode=story"
    },
    {
      "name": "Subtle (page section)",
      "id": "components-organisms-hero--subtle-section",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-organisms-hero--subtle-section",
      "frame": "/iframe.html?id=components-organisms-hero--subtle-section&viewMode=story"
    },
    {
      "name": "Sizes",
      "id": "components-organisms-hero--sizes",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-organisms-hero--sizes",
      "frame": "/iframe.html?id=components-organisms-hero--sizes&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/organisms/hero.stories.tsx"
}