{
  "id": "card",
  "name": "Card",
  "level": "molecule",
  "status": "stable",
  "purpose": "A content surface that groups one subject, with optional actions.",
  "description": "Reusable surface for grouped content. Compound API: Card + CardHeader + CardTitle + CardDescription + CardContent + CardFooter. Three tones (default, muted, elevated) and four padding densities. Card is not interactive by default; pass interactive=true plus a real semantic interactive wrapper. Patterns consulted: Patterns/Information Architecture · SectionAnatomy, Patterns/Composition · ReuseBeforeCreate + DoNotOverCompose, Patterns/Density & Growth · DensityLevels.",
  "role": "content",
  "import": "@rrios-forge/ui/molecules/card",
  "exports": [
    "Card",
    "CardContent",
    "CardDescription",
    "CardFooter",
    "CardHeader",
    "CardTitle",
    "CardContext",
    "CARD_FILL",
    "CARD_MATERIALS",
    "CARD_PADDING",
    "CARD_SURFACES",
    "CARD_TONES",
    "cardVariants"
  ],
  "source": "packages/ui/src/molecules/card",
  "axes": [
    {
      "axis": "surface",
      "part": null,
      "values": [
        "default",
        "muted",
        "raised"
      ],
      "default": "default",
      "meaning": "Which surface level a container paints."
    },
    {
      "axis": "padding",
      "part": null,
      "values": [
        "none",
        "sm",
        "md",
        "lg"
      ],
      "default": "md",
      "meaning": "Inner spacing of a container."
    },
    {
      "axis": "interactive",
      "part": null,
      "values": [
        "true",
        "false"
      ],
      "default": "false",
      "meaning": "Responds to the pointer: hover and press feedback, a pointer cursor."
    },
    {
      "axis": "fill",
      "part": null,
      "values": [
        "true",
        "false"
      ],
      "default": "false",
      "meaning": "Card grows to its row's tallest sibling (ADR-012)."
    }
  ],
  "needs": [
    {
      "need": "Content card",
      "answer": "`Card`"
    }
  ],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [
    {
      "id": "ADR-004",
      "title": "Migrate boolean configuration props to semantic axes"
    },
    {
      "id": "ADR-005",
      "title": "Visual operational rules: surfaces, interaction, motion"
    },
    {
      "id": "ADR-006",
      "title": "Geometry and typography signature"
    },
    {
      "id": "ADR-007",
      "title": "Material highlight on raised surfaces"
    },
    {
      "id": "ADR-009",
      "title": "Editorial Frame: PageShell v3 + new `TopBar` molecule"
    },
    {
      "id": "ADR-011",
      "title": "PageShell v5: adaptive lateral sidebar + mobile nav bubble"
    },
    {
      "id": "ADR-012",
      "title": "Card.fill axis for symmetric growth in grids"
    },
    {
      "id": "ADR-027",
      "title": "Vibrant is the system's material, not one of its members"
    }
  ],
  "stories": [
    {
      "name": "Playground",
      "id": "components-molecules-card--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-card--playground",
      "frame": "/iframe.html?id=components-molecules-card--playground&viewMode=story"
    },
    {
      "name": "Anatomy",
      "id": "components-molecules-card--anatomy",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-card--anatomy",
      "frame": "/iframe.html?id=components-molecules-card--anatomy&viewMode=story"
    },
    {
      "name": "Tones",
      "id": "components-molecules-card--tones",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-card--tones",
      "frame": "/iframe.html?id=components-molecules-card--tones&viewMode=story"
    },
    {
      "name": "Padding",
      "id": "components-molecules-card--padding",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-card--padding",
      "frame": "/iframe.html?id=components-molecules-card--padding&viewMode=story"
    },
    {
      "name": "With actions",
      "id": "components-molecules-card--with-actions",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-card--with-actions",
      "frame": "/iframe.html?id=components-molecules-card--with-actions&viewMode=story"
    },
    {
      "name": "Dense content",
      "id": "components-molecules-card--dense-content",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-card--dense-content",
      "frame": "/iframe.html?id=components-molecules-card--dense-content&viewMode=story"
    },
    {
      "name": "In context",
      "id": "components-molecules-card--in-context",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-card--in-context",
      "frame": "/iframe.html?id=components-molecules-card--in-context&viewMode=story"
    },
    {
      "name": "Fill in grid",
      "id": "components-molecules-card--fill-in-grid",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-card--fill-in-grid",
      "frame": "/iframe.html?id=components-molecules-card--fill-in-grid&viewMode=story"
    },
    {
      "name": "Vibrant",
      "id": "components-molecules-card--vibrant",
      "interaction": false,
      "snapshots": [
        "dark",
        "high-contrast",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-card--vibrant",
      "frame": "/iframe.html?id=components-molecules-card--vibrant&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/molecules/card.stories.tsx"
}