{
  "_copyright": "Copyright (c) 2026, Salesforce, Inc., All rights reserved. For full license text, see the LICENSE.txt file",
  "$schema": "https://slds.lightningdesignsystem.com/schemas/uif-foundation.v1.json",
  "apiVersion": "1.0.0",
  "name": "Prompt",
  "description": "Initializes Prompt style notification",
  "structure": {
    "name": "root",
    "restrict": [
      "section",
      "div"
    ],
    "description": "Initializes Prompt style notification",
    "attributes": {
      "static": {
        "role": "alertdialog",
        "aria-modal": "true",
        "tabindex": "0"
      },
      "bound": {
        "aria-labelledby": {
          "prop": "headingId"
        },
        "aria-describedby": {
          "prop": "contentId"
        }
      }
    },
    "children": [
      {
        "name": "container",
        "restrict": [
          "div"
        ],
        "description": "Prompt dialog container",
        "children": [
          {
            "name": "header",
            "restrict": [
              "div",
              "header"
            ],
            "description": "Prompt header band (carries the variant theme color and texture)",
            "children": [
              {
                "name": "icon",
                "restrict": [
                  "span"
                ],
                "description": "Optional decorative icon shown alongside the heading",
                "renderWhen": "slotFilled",
                "slot": {
                  "name": "icon"
                }
              },
              {
                "name": "heading",
                "restrict": [
                  "h1",
                  "h2"
                ],
                "description": "Prompt heading",
                "slot": {
                  "name": "heading",
                  "required": true
                }
              }
            ]
          },
          {
            "name": "content",
            "restrict": [
              "div"
            ],
            "description": "Prompt message content wrapper",
            "children": [
              {
                "name": "message",
                "restrict": [
                  "p"
                ],
                "description": "Prompt message paragraph",
                "slot": {
                  "name": "default"
                }
              }
            ]
          },
          {
            "name": "footer",
            "restrict": [
              "div",
              "footer"
            ],
            "description": "Prompt footer hosting the acknowledgement action(s)",
            "children": [
              {
                "name": "action",
                "restrict": [
                  "button"
                ],
                "description": "Acknowledgement button required to dismiss the prompt",
                "slot": {
                  "name": "footer",
                  "required": true
                }
              }
            ]
          }
        ]
      },
      {
        "name": "backdrop",
        "restrict": [
          "div"
        ],
        "description": "background overlay behind prompt",
        "attributes": {
          "static": {
            "role": "presentation"
          }
        }
      }
    ]
  },
  "states": [
    {
      "name": "open",
      "type": "boolean",
      "description": "Whether the prompt dialog is visible"
    }
  ],
  "accessibility": {
    "requirements": [
      {
        "id": "alertdialog-role",
        "description": "Must have role='alertdialog' (the legacy blueprint used 'dialog'; alertdialog is the correct ARIA pattern for a prompt requiring user acknowledgment)"
      },
      {
        "id": "focus-trap",
        "description": "Focus must be trapped within prompt"
      },
      {
        "id": "labelledby",
        "description": "aria-labelledby must reference the heading element id"
      },
      {
        "id": "describedby",
        "description": "aria-describedby must reference the content wrapper id"
      }
    ]
  }
}