{
  "id": "label",
  "name": "Label",
  "level": "atom",
  "status": "stable",
  "purpose": "Names a form control and marks it as required.",
  "description": "Accessible label for a form control. Renders a real `<label>`. The `required` indicator is the conventional `*` (quiet `content-muted`, danger only once the owning Field is invalid) plus an `sr-only` 'required' message — meaning is never carried by colour alone. `size` mirrors the field: `lg` sets 16 px next to a large Input.",
  "role": "input",
  "import": "@rrios-forge/ui/atoms/label",
  "exports": [
    "Label",
    "labelVariants",
    "LABEL_SIZES"
  ],
  "source": "packages/ui/src/atoms/label",
  "axes": [
    {
      "axis": "size",
      "part": null,
      "values": [
        "sm",
        "md",
        "lg"
      ],
      "default": "md",
      "meaning": "Ergonomic scale, in three families (control, text, container)."
    },
    {
      "axis": "disabled",
      "part": null,
      "values": [
        "true",
        "false"
      ],
      "default": "false",
      "meaning": "Not available: dimmed, skipped by the keyboard, ignores the pointer."
    }
  ],
  "needs": [],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [
    {
      "id": "ADR-002",
      "title": "Component variants live in `variants.ts` and export their option metadata"
    }
  ],
  "stories": [
    {
      "name": "Playground",
      "id": "components-atoms-label--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-label--playground",
      "frame": "/iframe.html?id=components-atoms-label--playground&viewMode=story"
    },
    {
      "name": "States",
      "id": "components-atoms-label--states",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-label--states",
      "frame": "/iframe.html?id=components-atoms-label--states&viewMode=story"
    },
    {
      "name": "Sizes",
      "id": "components-atoms-label--sizes",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-label--sizes",
      "frame": "/iframe.html?id=components-atoms-label--sizes&viewMode=story"
    },
    {
      "name": "Paired with a control",
      "id": "components-atoms-label--paired-with-control",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-label--paired-with-control",
      "frame": "/iframe.html?id=components-atoms-label--paired-with-control&viewMode=story"
    },
    {
      "name": "Disabled control",
      "id": "components-atoms-label--disabled-pair",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-atoms-label--disabled-pair",
      "frame": "/iframe.html?id=components-atoms-label--disabled-pair&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/atoms/label.stories.tsx"
}
