AppDialog class final

Card central de um dialog do design system (a superfície flutuante em si).

É apenas a superfície: uma barra de topo, um child rolável e um footer opcional (ex.: um AppButtonsFooter com as ações). Para exibi-lo como modal (barrier + transição + gestão de foco) use o helper showAppDialog.

A barra de topo é a mesma das sheets (AppSurfaceTopBar): title opcional e botão de fechar em chip circular, ligado por padrão e à direita (end) por padrão. Diferente das sheets, o título é alinhado ao início — no dialog ele é o cabeçalho de um formulário, não o rótulo de um painel. Sem título e sem botão a barra simplesmente não existe (nada de vão vazio). Ela fica fora da rolagem, como o rodapé.

Participa dos eixos globais do DS:

• Estilo (AppStyle): por ser uma superfície flutuante, o default é elevated (sombra simétrica) — como os demais overlays (AppMenu, AppPopover, AppCard de painel). Sobrescreva por instância via style (outlined troca a sombra por borda outline; filled deixa chapado).
• Forma (AppRadiusMode): segue o modo de raio global, com override via radiusMode/radius.

Todas as cores vêm do tema (surfaceContainer, outline) → contraste AA em claro/escuro nas duas marcas.

showAppDialog(
  context: context,
  title: const AppText('Excluir veículo?'),
  child: const AppDialogContent(
    message: 'Esta ação não pode ser desfeita.',
    illustration: 'assets/delete.svg',
  ),
  footer: AppButtonsFooter(primary: confirmButton, secondary: cancelButton),
);