feat: checkable menu items and pressed-state toggle buttons

[DavertMik]

Stacked on #5704 (feat/checkoption-aria-roles). It targets 4.x and will show P1's two commits until #5704 merges; review only feat: checkable menu items and pressed-state toggle buttons. Rebase/retarget once P1 lands.

Implements plan P6: the two component families the checkable actions could not reach — checkbox/radio items inside Dropdown Menus, and aria-pressed toggle buttons — on Radix and Base UI.

What changed

checkOption reaches menu items. role=menuitemcheckbox and role=menuitemradio join the ARIA role pass in all three helpers (Playwright's getByRole loop, Puppeteer's ::-p-aria([name][role]) loop, WebDriver's keepCheckable filter).

Playwright takes a click-plus-verify path for those two roles. It reads aria-checked, clicks only if the state differs from the one requested, then waits for the new state. Native inputs and role=checkbox|radio|switch keep using check()/uncheck(), which P1 proved works for them.

WebDriver's seeCheckboxIsChecked falls back to findCheckable. proceedSeeCheckbox goes through findFields (unlike Playwright and Puppeteer, which go through findCheckable), and no menu item can satisfy a field lookup. The fallback runs only when findFields comes back empty, so nothing that resolves today changes.

Pressed state gets its own API. I.toggleButton(locator), I.seeButtonIsPressed(locator), I.dontSeeButtonIsPressed(locator) on all three helpers, with docs/webapi/*.mustache partials.

grabCheckedElementStatus reads ARIA. aria-checked then aria-pressed, instead of requiring type=checkbox|radio; when it still cannot answer it names the role it found. The existing error-message assertion in Playwright_test.js is updated to match.

The API question, for you to override

The plan flagged this and recommended the split implemented here: menu items are genuinely checkable (aria-checked), so they belong under checkOption; a toggle button is not a checkbox, so I.checkOption('Bold') would otherwise mean two different things.

The alternative is to route aria-pressed through checkOption/seeCheckboxIsChecked as well. That is a small change — setCheckableState and the state reader would take aria-pressed alongside aria-checked — and toggleButton/seeButtonIsPressed would either go away or become aliases. Say the word and I will switch it.

A related, smaller call: seeCheckboxIsChecked on an aria-pressed button currently throws "is a toggle button with aria-pressed=…, use seeButtonIsPressed" rather than answering. The plan's §3 asked for a silent fallback to aria-pressed there; I made it a pointed error instead, so checked-ness and pressed-ness stay distinct in assertions the way they do in actions. One-line reversal if you prefer the fallback.

Findings that correct the plan and the report

• Playwright's check() does support menuitemcheckbox. The report's "hangs until timeout" is specifically the Radix case: check() clicks, Radix closes the menu on select, and the post-click verification then waits on a detached node until the timeout. Base UI (closeOnClick defaults to false) passed check() in 47 ms. So the click-plus-verify path exists to tolerate the element disappearing, not to work around a role refusal — and that is why it treats a vanished element as "applied".
• WebDriver reaches menu items by label. P1 had to skip Radix checkables on WebDriver because an icon-only <button role=checkbox> has no accessible name of its own. A menu item's text content is its accessible name, so aria/Show status bar resolves and no WebDriver skips were needed here. The only WebDriver gap was the findFields lookup above.
• checkOption on menu items already worked on Puppeteer and WebDriver before this PR's role-list change, and is already idempotent there — both read aria-checked and click only on a mismatch. They regressed only because P1's role restriction (c4e7fed) narrowed the ARIA pass to checkbox|radio|switch; adding the two menu roles restores them.

Tests

Four fixtures (form/menu/{radix,baseui}.php, form/toggle/{radix,baseui}.php) built with the importmap + esm.sh + window.__ready pattern, using the real libraries. Menu items exist only while the menu is open, and Radix closes it on select, so the spec reopens the menu before each read — which also makes the idempotency case real: check, reopen, check again, still aria-checked="true".

Specs live in test/helper/webapi.js next to P1's block, so they run on all three helpers; grabCheckedElementStatus is Playwright-only and is covered in Playwright_test.js next to the existing cases.

Local, against a PHP fixture server, run serially:

suite	result
Playwright, full	3 failures, all pre-existing env (mock server on :3001, seeTraffic against codecept.io)
Puppeteer, full	5 failures, all pre-existing env (cookies, seeTraffic, a Chrome sandbox crash in the Trace suite)
WebDriver, full	405 passing, 0 failing, 27 pending
new blocks on all three helpers	green
npm run test:unit	770 passing, 0 failing
npm run lint, npm run def + npm run dtslint	clean

🤖 Generated with Claude Code

https://claude.ai/code/session_01TcwzSXPnfaig8nBZD2Vxfi