{
  "id": "choice-group",
  "name": "ChoiceGroup",
  "level": "molecule",
  "status": "stable",
  "purpose": "Pick one or many from a short set, each choice with a title and a line of detail.",
  "description": "Pick one or many from a set, each with a title and a line of detail. A fieldset with its legend, an optional description and an optional error, holding checkboxes, radios or switches; vertical or horizontal, comfortable or compact. For radios, wrap the items in a RadioGroup so arrow keys move between them.",
  "role": "input",
  "import": "@rrios-forge/ui/molecules/choice-group",
  "exports": [
    "ChoiceGroup",
    "ChoiceGroupItem",
    "CHOICE_GROUP_DENSITIES",
    "CHOICE_GROUP_ORIENTATIONS",
    "choiceGroupVariants"
  ],
  "source": "packages/ui/src/molecules/choice-group",
  "axes": [
    {
      "axis": "orientation",
      "part": null,
      "values": [
        "vertical",
        "horizontal"
      ],
      "default": "vertical",
      "meaning": "The direction the parts run: a row (horizontal) or a column (vertical); responsive stacks on phones and runs in a row from sm."
    },
    {
      "axis": "invalid",
      "part": null,
      "values": [
        "true",
        "false"
      ],
      "default": "false",
      "meaning": "Fails validation: a danger edge, announced as invalid; pair it with an error message."
    }
  ],
  "needs": [
    {
      "need": "Binary toggle / checkbox / radio group",
      "answer": "`Switch` (in `SettingsField` with label) / `Checkbox` / `ChoiceGroup` with `Radio`"
    }
  ],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [],
  "stories": [
    {
      "name": "Playground",
      "id": "components-molecules-choicegroup--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-choicegroup--playground",
      "frame": "/iframe.html?id=components-molecules-choicegroup--playground&viewMode=story"
    },
    {
      "name": "Checkbox choices",
      "id": "components-molecules-choicegroup--checkbox-choices",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-choicegroup--checkbox-choices",
      "frame": "/iframe.html?id=components-molecules-choicegroup--checkbox-choices&viewMode=story"
    },
    {
      "name": "Radio choices",
      "id": "components-molecules-choicegroup--radio-choices",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-choicegroup--radio-choices",
      "frame": "/iframe.html?id=components-molecules-choicegroup--radio-choices&viewMode=story"
    },
    {
      "name": "Switch choices",
      "id": "components-molecules-choicegroup--switch-choices",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-choicegroup--switch-choices",
      "frame": "/iframe.html?id=components-molecules-choicegroup--switch-choices&viewMode=story"
    },
    {
      "name": "Invalid",
      "id": "components-molecules-choicegroup--invalid",
      "interaction": false,
      "snapshots": [
        "dark",
        "high-contrast",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-choicegroup--invalid",
      "frame": "/iframe.html?id=components-molecules-choicegroup--invalid&viewMode=story"
    },
    {
      "name": "Horizontal",
      "id": "components-molecules-choicegroup--horizontal",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-choicegroup--horizontal",
      "frame": "/iframe.html?id=components-molecules-choicegroup--horizontal&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/molecules/choice-group.stories.tsx"
}