{
  "id": "list-item",
  "name": "ListItem",
  "level": "molecule",
  "status": "stable",
  "purpose": "One row of a list: a title, a line of detail and an action.",
  "description": "Reusable list row with leading slot, title, description, metadata, badge and action. interactive only adds visual hover/focus affordances; the consumer wraps the row in a real semantic interactive element when the whole row commits an action. selected becomes aria-selected only when interactive=true. Patterns consulted: Patterns/Information Architecture · MetadataAndActions, Patterns/Composition · DoNotOverCompose.",
  "role": "content",
  "import": "@rrios-forge/ui/molecules/list-item",
  "exports": [
    "ListItem",
    "LIST_ITEM_DENSITIES",
    "LIST_ITEM_TONES",
    "listItemVariants"
  ],
  "source": "packages/ui/src/molecules/list-item",
  "axes": [
    {
      "axis": "tone",
      "part": null,
      "values": [
        "neutral",
        "muted",
        "danger"
      ],
      "default": "neutral",
      "meaning": "Which semantic colour family the element speaks in."
    },
    {
      "axis": "selected",
      "part": null,
      "values": [
        "true",
        "false"
      ],
      "default": "false",
      "meaning": "Chosen in a set: the selected wash plus a non-colour cue (weight, check)."
    },
    {
      "axis": "disabled",
      "part": null,
      "values": [
        "true",
        "false"
      ],
      "default": "false",
      "meaning": "Not available: dimmed, skipped by the keyboard, ignores the pointer."
    },
    {
      "axis": "interactive",
      "part": null,
      "values": [
        "true",
        "false"
      ],
      "default": "false",
      "meaning": "Responds to the pointer: hover and press feedback, a pointer cursor."
    }
  ],
  "needs": [
    {
      "need": "Property list / data row / list item",
      "answer": "`PropertyList` / `DataRow` / `ListItem`"
    },
    {
      "need": "Row that opens a page (settings-list disclosure)",
      "answer": "`ListItem href` (whole row is the link, trailing chevron)"
    }
  ],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [
    {
      "id": "ADR-005",
      "title": "Visual operational rules: surfaces, interaction, motion"
    },
    {
      "id": "ADR-030",
      "title": "Axis vocabulary: one name, one meaning"
    }
  ],
  "stories": [
    {
      "name": "Playground",
      "id": "components-molecules-listitem--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-listitem--playground",
      "frame": "/iframe.html?id=components-molecules-listitem--playground&viewMode=story"
    },
    {
      "name": "Densities",
      "id": "components-molecules-listitem--densities",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-listitem--densities",
      "frame": "/iframe.html?id=components-molecules-listitem--densities&viewMode=story"
    },
    {
      "name": "With avatar",
      "id": "components-molecules-listitem--with-avatar",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-listitem--with-avatar",
      "frame": "/iframe.html?id=components-molecules-listitem--with-avatar&viewMode=story"
    },
    {
      "name": "With icon",
      "id": "components-molecules-listitem--with-icon",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-listitem--with-icon",
      "frame": "/iframe.html?id=components-molecules-listitem--with-icon&viewMode=story"
    },
    {
      "name": "Selected",
      "id": "components-molecules-listitem--selected",
      "interaction": false,
      "snapshots": [
        "dark",
        "high-contrast",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-listitem--selected",
      "frame": "/iframe.html?id=components-molecules-listitem--selected&viewMode=story"
    },
    {
      "name": "Disabled",
      "id": "components-molecules-listitem--disabled",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-listitem--disabled",
      "frame": "/iframe.html?id=components-molecules-listitem--disabled&viewMode=story"
    },
    {
      "name": "Danger",
      "id": "components-molecules-listitem--danger",
      "interaction": false,
      "snapshots": [
        "dark",
        "high-contrast",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-listitem--danger",
      "frame": "/iframe.html?id=components-molecules-listitem--danger&viewMode=story"
    },
    {
      "name": "With actions",
      "id": "components-molecules-listitem--with-actions",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-listitem--with-actions",
      "frame": "/iframe.html?id=components-molecules-listitem--with-actions&viewMode=story"
    },
    {
      "name": "Grouped",
      "id": "components-molecules-listitem--grouped",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-listitem--grouped",
      "frame": "/iframe.html?id=components-molecules-listitem--grouped&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/molecules/list-item.stories.tsx"
}