refactor(dialog): MD3 updates, updated Dialog API

[kachmashk]

Motivation

The goal of this PR is to address Material Design 3 guidelines for the Dialog component based on the official documentation as well as this issue. This PR also provides ability to avoid using previous compound components implementation in favor of props directly passed to the Dialog component.

Changes

Material Design 3:

• Dialog.ScrollArea divider border color uses outline,
• Dialog has now restricted minimum and maximum width set to 280dp and 560dp,
• Fixed an issue when DialogIcon is the first component in the Dialog and it had a total top margin of 48dp instead of 24dp,
• Dialog now detects if Dialog.Icon and Dialog.Title are present and if so enforcing Dialog.Title to be centered.

Dialog:

• Dialog component now supports icon, title, content, actions, scrollable props instead of using compound components. Dialog still uses compound components underneath to properly comply with Material Design specs as these components enforce proper styling,
• Added new test cases for Dialog to ensure the new approach works as intended.

Example:

• Updated Dialog screen within Example app with the same dialogs as before but using new API to make sure they look and work as expected.

Related issue

• refactor(dialog): improve composition model and accessibility #4933

Test plan

• lint
• typecheck
• test

Reviewers can through new Dialogs added to the Example app. They are duplicated as previous dialogs but they use new approach.

[JKobrynski]

The MD3 corrections here should all land - divider colour, the 280/560 width clamp, the icon margin, the centred headline. What I'd like to reconsider is replacing children with title/content/actions props. #5076 solves the same problem while keeping the sub-components, which matches Card, List and DataTable. Could you drop the API change and keep the MD3 fixes? #5076 will need to land first either way, since the two touch the same files. @kachmashk

[JKobrynski]

Also @kachmashk could you resolve the comments that've been addressed? 🙏

[kachmashk]

Waiting for a #5076 to be closed.

[JKobrynski]

#5094 removes docs from the repo, can you remove them from this PR? 🙏

[JKobrynski]

@kachmashk ☝️ and we've got conflicts

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[k0ndee]

Heads up - #5125 is reworking Modal's accessibility props: it replaces overlayAccessibilityLabel with aria-label, and adds a new configurable role prop (defaulting to dialog) directly on Modal's Surface, rather than a hardcoded value. This PR already forwards aria-label from Dialog to Modal, but its Modal usage here still targets the old shape (overlayAccessibilityLabel + hardcoded role="dialog"), so it'll need a rebase once #5125 merges.