adobe / spectrum-web-components / 33042115928

96%

push

github

docs(menu): add 2nd-gen migration plan (#6606)

* docs(menu): add 2nd-gen migration plan

Documents the 1st-gen and React Spectrum S2 Menu API surfaces, dependencies,
breaking changes, and a phased migration checklist ahead of the swc-menu
implementation work under SWC-1980.

* docs(menu): recommend two-phase implementation split

Ships swc-menu without selection first (Phase A), deferring the
selection engine to a follow-up ticket (Phase B) so reviewers validate
a smaller surface per PR. Holds regardless of how Q11 (picker/combobox
selection dependency) resolves.

* docs(menu): fix architecture premise and disposition gaps from review

swc-menu anchors via PlacementController directly, not <swc-popover> --
Popover already shipped (PR #6356) and is explicitly excluded from
menu/listbox/combobox use per its own a11y doc's design update.
Removes the false Popover sequencing blocker entirely.

Also: adds B7 disabled-focus conflict, B9/B10 dropped API, an Events
(2nd-gen) section, a full 1st-gen member disposition table, corrects
Q1's Figma-file framing, strengthens the Figma evidence behind Q2
(selection scope), and renumbers Q1-Q15 accordingly.

* docs(menu): pin selection (Phase B) to this plan, not a sibling doc

Selection lives entirely on Menu in 1st-gen, not MenuItem, so unlike
B1/B3/B8 there's no cross-plan ownership question. When Q2 resolves,
A2 promotes to Must-ship here directly rather than spinning up a
separate migration-plan.md.

* docs(menu): confirm Figma dev-mode component library matches plan

Cross-checked the actual Menu item component variants (node
125485:44694) against the property-table inference already in the
plan -- matches exactly. Adds one detail: the Unavailable contextual-
help bubble is its own sized (S/M/L/XL) component, not fixed-size.

* docs(menu): resolve Q1 -- confirmed as the only Figma file

Design confirmed no newer replacement exists for the deprecated-titled
S2/Web file. Unblocks Q3 (xl size confirmation).

* do... (continued)

6037 of 6481 branches covered (93.15%)

Branch coverage included in aggregate %.

38170 of 39445 relevant lines covered (96.77%)

456.52 hits per line