id: dialog
kind: component
name: Dialog
description: A modal surface that interrupts the current task until the user responds or dismisses it.

metadata:
  status: {status: stable}
  since: 1.0.0
  tags: [overlay, modal]

sections:
  - kind: guidelines
    for: all
    items:
      - statement: Move focus to the dialog when it opens, and return it to the triggering element when it closes.
        level: must
      - statement: Dismiss on Escape unless the dialog is blocking on an action the user must explicitly choose.
        level: should
