Fix listbox Home/End/PageUp/PageDown across Select, MultiSelect, and AutocompleteInput (#380)

[czarandy]

Fixes #380.

The shared piece

Select/MultiSelect (via useListboxNavigation) and AutocompleteInput/TagsInput (via BaseAutocompleteInput) each had their own combobox key handling, with different bugs. This adds src/internal/listboxKeyboard.ts, a small pure module that maps a key event onto the action a listbox should take:

type ListboxKeyAction =
  | {edge: 'first' | 'last'; type: 'jump'}
  | {edge: 'first' | 'last'; type: 'open'}
  | {step: -1 | 1; type: 'move'}
  | {type: 'commit'};

Both handlers now drive off resolveListboxKeyAction and apply the action to their own state model (value-keyed for the selects, index-keyed for autocomplete). preventDefault() stays with the caller so it can decline an action it can't fulfil — Enter with nothing highlighted still belongs to the form.

The three defects

1. Home/End were swallowed while typing in the popover search field. They fired on isOpen regardless of target, so the caret couldn't reach the start/end of the query. They now reach the listbox only when the event target has no text caret — the same handler is bound to both the search field and the trigger button, so the target decides.
2. Home/End were no-ops once a value was selected. They went through getInitialHighlight, which returns the selected option before honoring the direction. That helper is right for "open the listbox" and wrong for an explicit jump, which now uses a new getEdgeHighlight.
3. PageUp/PageDown did nothing. They fell through to the browser, which page-scrolled the popover away from aria-activedescendant. They're now the jump keys that always belong to the listbox, in every combobox.

Net keyboard map: arrows own the listbox, Home/End yield to the text caret when there is one, PageUp/PageDown jump to first/last.

AutocompleteInput

Picks up the jumps as part of the alignment, plus two consistency fixes it inherits from the shared map:

• ArrowUp on a closed menu opens it, instead of silently moving a highlight nobody can see.
• Opening with an arrow key seeds the highlight at the matching edge (previously it stayed at -1, so the first arrow press only opened the menu).

Tests

• Select — Home/End move the search caret and leave aria-activedescendant alone; PageDown jumps to the last filtered option, PageUp back to the first.
• MultiSelect — with a selection present, ArrowDown opens onto the selection but Home lands on the first option; PageDown/PageUp reach the edges.
• AutocompleteInput — Home/End keep the caret, PageDown/PageUp jump the highlight, and Enter commits the jumped-to result.

Each fails on main. Full suite: 3177 passing.

https://claude.ai/code/session_01XFkkvUQfynGRedEYDNxKoY

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
silver-ui-site	Ready	Preview	Aug 5, 2026 11:05pm

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
silver-ui	Ignored	Preview	Aug 5, 2026 11:05pm