[Victor Genaev (mainframev)]

Previous Behavior

Popover, Dialog, Tooltip, MenuPopover, the Combobox/Dropdown/TagPicker listbox and Toaster each drive the top layer on their own, and disagree on details: when they run, whether browser closes reach React state, focus restore, and exit animations.

New Behavior

All of them use useTopLayer from the previous PR. Each keeps its own focus model.

• Popover (TeachingPopover, InfoLabel): usePopover still drives contentRef, the surface still unmounts after the browser reports the close (now also after exit animations), and focus still returns to the trigger when it was inside. The tests from fix: restore headless TeachingPopover close focus #36843 pass unchanged.
• Dialog (Drawer): modal dialogs keep blocking native Escape (preventEscapeClose) so onOpenChange can veto a close; non-modal dialogs still report popovertarget toggles as surfaceToggle.
• Tooltip: hint with hintFallback: 'manual', so in browsers without popover="hint" showing a tooltip never closes an open popover.
• Menu, listbox, Toaster: keep their own focus handling (autofocus item and trigger restore, active descendant, toast restore).

Visible changes, also in the change file:

• Modal Dialog, trapFocus Popover and Drawer keep Tab inside.
• A non-modal Dialog moves focus to [autofocus] or its first focusable element on open, and restores focus on close only when it was inside.
• Escape inside a popover or dialog nested in a DialogSurface closes only the inner one.
• A Tooltip that has been shown and hidden is inert and aria-hidden while hidden; aria-labelledby / aria-describedby still resolve.

The spec gets a "Changes from master" table with every difference.

Bugs fixed

Master had a separate top-layer implementation in each overlay, and they disagreed on edge cases. Moving them onto the shared hooks fixes:

• Modal Dialog out of sync after a native close. <form method="dialog"> or dialog.close() from outside React closed the dialog but never reached onOpenChange, so open stayed true. It is now reported as surfaceToggle.
• Native modal opens ignored. showModal() from outside React or a commandfor invoker could open a closed modal Dialog that stays mounted (unmountOnClose={false}) without React knowing. Where dialogs fire toggle (Chromium 132+), the open is now reported as surfaceToggle, and undone when the consumer keeps open false. Non-modal Dialog already synced these.
• Popover unmounted mid-animation. The surface unmounted as soon as the browser reported the close. It now waits for exit animations, like DialogSurface.
• Exiting overlays still interactive. A Popover or Dialog that is animating out is now inert and aria-hidden="true" until the exit ends, then the consumer's own values come back.
• Escape closed the outer Dialog too. Escape inside a popover or dialog nested in a DialogSurface closed both. Only the inner one closes now; Escape from content portaled out of the surface still closes the dialog.

Related Issue(s)

Part 2 of 2 of the headless top-layer stack.

[github-actions]

Pull request demo site: URL

[Victor Genaev (mainframev)]

A non-modal dialog opened or closed by a popovertarget button is still reported as surfaceToggle, same as master.

Modal and alert dialogs keep blocking the native Escape close (preventEscapeClose), because onOpenChange can veto a close with preventDefault. Everything else using the hook lets the browser close on Escape.