{
  "id": "dialog",
  "name": "Dialog",
  "level": "molecule",
  "status": "stable",
  "purpose": "A modal surface for a focused task; the page waits behind it.",
  "description": "Modal panel. Composes `@radix-ui/react-dialog` for the full modal contract: `aria-modal`, focus trap, focus return, escape-to-close, outside-click-to-close, body scroll lock, portal isolation. Title + Description are required for accessibility.",
  "role": "feedback",
  "import": "@rrios-forge/ui/molecules/dialog",
  "exports": [
    "Dialog",
    "DialogClose",
    "DialogContent",
    "DialogDescription",
    "DialogFooter",
    "DialogHeader",
    "DialogTitle",
    "DialogTrigger",
    "dialogContentVariants",
    "dialogOverlayVariants",
    "DIALOG_SIZES"
  ],
  "source": "packages/ui/src/molecules/dialog",
  "axes": [
    {
      "axis": "size",
      "part": null,
      "values": [
        "sm",
        "md",
        "lg",
        "xl"
      ],
      "default": "md",
      "meaning": "Ergonomic scale, in three families (control, text, container)."
    }
  ],
  "needs": [
    {
      "need": "Confirmation modal / generic modal",
      "answer": "`Dialog` + `ConfirmDialogContent` / `Dialog`"
    }
  ],
  "patterns": [],
  "a11yExceptions": [],
  "decisions": [
    {
      "id": "ADR-006",
      "title": "Geometry and typography signature"
    },
    {
      "id": "ADR-007",
      "title": "Material highlight on raised surfaces"
    },
    {
      "id": "ADR-009",
      "title": "Editorial Frame: PageShell v3 + new `TopBar` molecule"
    },
    {
      "id": "ADR-015",
      "title": "Drawer molecule on top of Radix Dialog"
    },
    {
      "id": "ADR-024",
      "title": "`LocaleSelector` is a new molecule, not an extension of `Combobox`"
    }
  ],
  "stories": [
    {
      "name": "Playground",
      "id": "components-molecules-dialog--playground",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-dialog--playground",
      "frame": "/iframe.html?id=components-molecules-dialog--playground&viewMode=story"
    },
    {
      "name": "Sizes",
      "id": "components-molecules-dialog--sizes",
      "interaction": false,
      "snapshots": [
        "dark",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-dialog--sizes",
      "frame": "/iframe.html?id=components-molecules-dialog--sizes&viewMode=story"
    },
    {
      "name": "With form",
      "id": "components-molecules-dialog--with-form",
      "interaction": false,
      "snapshots": [
        "dark",
        "high-contrast",
        "light"
      ],
      "skipsSnapshot": false,
      "docs": "/?path=/story/components-molecules-dialog--with-form",
      "frame": "/iframe.html?id=components-molecules-dialog--with-form&viewMode=story"
    },
    {
      "name": "Focus flow (interaction test)",
      "id": "components-molecules-dialog--focus-flow",
      "interaction": true,
      "snapshots": [],
      "skipsSnapshot": true,
      "docs": "/?path=/story/components-molecules-dialog--focus-flow",
      "frame": "/iframe.html?id=components-molecules-dialog--focus-flow&viewMode=story"
    }
  ],
  "storyFile": "tooling/storybook/stories/components/molecules/dialog.stories.tsx"
}
