{
  "id": "description",
  "name": "Description",
  "level": "atom",
  "status": "stable",
  "purpose": "Quiet supporting text that explains a field or a section.",
  "description": "Supporting / helper / status copy primitive. Composition surface for Field (helper text), Alert (body), Card (subtitle), EmptyState (body) and any inline form description / error message. Polymorphic via `as`; `tone` reinforces meaning; defaults to `muted` because Description is the supporting layer below `<Text>`.",
  "role": "content",
  "import": "@rrios-forge/ui/atoms/description",
  "exports": [
    "Description",
    "descriptionVariants",
    "DESCRIPTION_ELEMENTS",
    "DESCRIPTION_SIZES",
    "DESCRIPTION_TONES"
  ],
  "source": "packages/ui/src/atoms/description",
  "axes": [
    {
      "axis": "tone",
      "part": null,
      "values": [
        "neutral",
        "muted",
        "danger",
        "success",
        "warning"
      ],
      "default": "muted",
      "meaning": "Which semantic colour family the element speaks in."
    },
    {
      "axis": "size",
      "part": null,
      "values": [
        "sm",
        "md"
      ],
      "default": "md",
      "meaning": "Ergonomic scale, in three families (control, text, container)."
    }
  ],
  "needs": [
    {
      "need": "Text / heading / helper / code / shortcut",
      "answer": "`Text` / `Heading` / `Description` / `Code` / `Kbd`"
    }
  ],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [],
  "stories": [
    {
      "name": "Playground",
      "id": "components-atoms-description--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-description--playground",
      "frame": "/iframe.html?id=components-atoms-description--playground&viewMode=story"
    },
    {
      "name": "Tones",
      "id": "components-atoms-description--tones",
      "interaction": false,
      "snapshots": [
        "dark",
        "high-contrast",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-description--tones",
      "frame": "/iframe.html?id=components-atoms-description--tones&viewMode=story"
    },
    {
      "name": "Sizes",
      "id": "components-atoms-description--sizes",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-description--sizes",
      "frame": "/iframe.html?id=components-atoms-description--sizes&viewMode=story"
    },
    {
      "name": "In context",
      "id": "components-atoms-description--in-context",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-description--in-context",
      "frame": "/iframe.html?id=components-atoms-description--in-context&viewMode=story"
    },
    {
      "name": "Form description",
      "id": "components-atoms-description--form-description",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-description--form-description",
      "frame": "/iframe.html?id=components-atoms-description--form-description&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/atoms/description.stories.tsx"
}