docs(react-headless-components-preview): shorten manual-vs-auto nested comparison

Author: mainframev

packages/react-components/react-headless-components-preview/library/docs/popover-spec.md

@@ -133,7 +133,7 @@ This iteration ships **no built-in focus management**:
 
 - **No auto-focus on open.** The browser handles focus naturally. Top-layer popovers (`popover="manual"`) leave focus on the trigger; consumers can call `.focus()` on the surface or a descendant if needed.
 - **No focus trap.** Tab / Shift+Tab follow the document's normal tab order. With a top-layer surface, focus may move to elements behind the surface — that's expected for a non-modal popover.
-- **No focus restore.** When the surface unmounts, focus stays wherever the dismissal interaction left it (typically the trigger after click / Escape; arbitrary after click-outside).
+- **Focus restore on Escape only.** When Escape is pressed inside the surface, focus moves back to the trigger (native `popover="manual"` does not restore focus, so the surface's Escape handler does it explicitly). All other dismissal paths (click-outside, scroll-outside, programmatic close) leave focus wherever the interaction left it.
 - **`disableAutoFocus`** is preserved on `PopoverProps` for API stability but is currently inert. It will become meaningful again together with the upcoming focus hook.
 
 ### Labeling

packages/react-components/react-headless-components-preview/stories/src/Popover/PopoverNestedManualDescription.md

@@ -19,24 +19,12 @@ top-layer painter for the surface, not a state authority.
 
 ## How this differs from `Nested` (auto mode)
 
-| Aspect                | `Popover` (manual)                                   | `PopoverAuto` (auto)                                         |
-| --------------------- | ---------------------------------------------------- | ------------------------------------------------------------ |
-| Source of truth       | React state                                          | React state mirrored from browser `toggle` events            |
-| Light dismiss         | `useOnClickOutside`, `useOnScrollOutside`, React Esc | Browser-driven (Escape, click-outside, popover stack)        |
-| Esc filter            | `closest('[data-popover-surface]') === self`         | Browser closes only the topmost popover in its stack         |
-| Stack ancestry        | DOM nesting + React click/Escape filters             | DOM nesting (or `popovertarget` linkage) per HTML spec       |
-| Multiple open peers   | ✅ Allowed — any number of unrelated popovers open   | ❌ Browser dismisses non-ancestor popovers when a peer opens |
-| `popover` attribute   | `popover="manual"`                                   | `popover="auto"`                                             |
-| Hover / context modes | Fully supported (`openOnHover`, `openOnContext`)     | Open paths still React-driven; close paths defer to browser  |
-| Focus restoration     | None built in                                        | Browser restores focus to the invoker on dismiss             |
-| Predictability        | Behaviour is whatever React handlers say             | Behaviour follows the HTML Popover spec across all browsers  |
+`PopoverAuto` defers dismiss to the browser via `popover="auto"`, so Escape,
+click-outside, and the popover-stack peer-dismissal happen at HTML-spec
+timing and focus is restored to the invoker for free. The trade-off is
+that the browser only allows one root chain open at a time — opening an
+unrelated peer dismisses the existing root.
 
-**When to pick which:**
-
-- Reach for `PopoverAuto` when the popover is a single, modal-ish surface and
-  you want the browser's dismiss timing, focus restoration, and stack
-  semantics for free.
-- Reach for `Popover` when you need multiple unrelated popovers open at once,
-  hover/context-driven open with custom dismiss timing
-  (`mouseLeaveDelay`, `closeOnScroll`), or precise control over which event
-  closes which surface.
+Use `PopoverAuto` when you want native, single-root behaviour. Use
+`Popover` when you need multiple unrelated popovers open simultaneously
+or hover/context-driven open with custom dismiss timing.