{
  "id": "bottom-dock",
  "name": "BottomDock",
  "level": "molecule",
  "status": "stable",
  "purpose": "A raft of page actions pinned to the bottom of the frame.",
  "description": "Bottom-anchored primary navigation. Two semantic axes (`density`, `orientation`) and three slots (`workspace`, `items[]`, `user`). The active item wears a neutral capsule that hugs its icon and label and slides between items; the dock surface has a hairline top edge.",
  "role": "navigation",
  "import": "@rrios-forge/ui/molecules/bottom-dock",
  "exports": [
    "BottomDock",
    "BottomDockItem",
    "BOTTOM_DOCK_DENSITIES",
    "BOTTOM_DOCK_ORIENTATIONS",
    "bottomDockItemBadgeVariants",
    "bottomDockItemIconVariants",
    "bottomDockItemLabelVariants",
    "bottomDockItemVariants",
    "bottomDockItemsVariants",
    "bottomDockSlotVariants",
    "bottomDockVariants"
  ],
  "source": "packages/ui/src/molecules/bottom-dock",
  "axes": [
    {
      "axis": "orientation",
      "part": null,
      "values": [
        "horizontal"
      ],
      "default": "horizontal",
      "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": "active",
      "part": null,
      "values": [
        "true",
        "false"
      ],
      "default": "false",
      "meaning": "The current destination or item: marked as current to assistive tech."
    },
    {
      "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-010",
      "title": "PageShell v4: bottom dock + mobile floating bubble"
    },
    {
      "id": "ADR-011",
      "title": "PageShell v5: adaptive lateral sidebar + mobile nav bubble"
    },
    {
      "id": "ADR-013",
      "title": "PageShell: mobile-nav polymorphism"
    },
    {
      "id": "ADR-022",
      "title": "The material family: `solid` and `vibrant`"
    }
  ],
  "stories": [
    {
      "name": "Playground",
      "id": "components-molecules-bottomdock--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-bottomdock--playground",
      "frame": "/iframe.html?id=components-molecules-bottomdock--playground&viewMode=story"
    },
    {
      "name": "Comfortable",
      "id": "components-molecules-bottomdock--comfortable",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-bottomdock--comfortable",
      "frame": "/iframe.html?id=components-molecules-bottomdock--comfortable&viewMode=story"
    },
    {
      "name": "Compact",
      "id": "components-molecules-bottomdock--compact",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-bottomdock--compact",
      "frame": "/iframe.html?id=components-molecules-bottomdock--compact&viewMode=story"
    },
    {
      "name": "With badges",
      "id": "components-molecules-bottomdock--with-badges",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-bottomdock--with-badges",
      "frame": "/iframe.html?id=components-molecules-bottomdock--with-badges&viewMode=story"
    },
    {
      "name": "Items only (no workspace / user)",
      "id": "components-molecules-bottomdock--items-only",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-bottomdock--items-only",
      "frame": "/iframe.html?id=components-molecules-bottomdock--items-only&viewMode=story"
    },
    {
      "name": "asChild · framework Link",
      "id": "components-molecules-bottomdock--as-child-with-link",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-bottomdock--as-child-with-link",
      "frame": "/iframe.html?id=components-molecules-bottomdock--as-child-with-link&viewMode=story"
    },
    {
      "name": "asChild · prevents browser navigation",
      "id": "components-molecules-bottomdock--as-child-prevents-navigation",
      "interaction": true,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-bottomdock--as-child-prevents-navigation",
      "frame": "/iframe.html?id=components-molecules-bottomdock--as-child-prevents-navigation&viewMode=story"
    },
    {
      "name": "Mobile",
      "id": "components-molecules-bottomdock--mobile",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-bottomdock--mobile",
      "frame": "/iframe.html?id=components-molecules-bottomdock--mobile&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/molecules/bottom-dock.stories.tsx"
}
