interface FocusgroupEngineOptions { getItems: () => HTMLElement[]; getOrientation: () => 'horizontal' | 'vertical'; } /** * `NativeFocusgroupEngine` * * Focus engine backed by the browser's native `focusgroup` behavior. It does * NO key handling and NO tabindex management: the browser provides * directional navigation, `Home`/`End`, wrap, logical (writing-mode aware) * direction, the guaranteed single tab stop, last-focused memory and * focus-into-view scrolling. * * What remains here is exactly what the explainer assigns to author code for * the tabs pattern: * * - Declare the group on the tablist container: * `focusgroup="tablist [block] nomemory"`. `tablist` supplies the * `inline wrap` default modifiers; `block` overrides the axis for vertical * tablists; `nomemory` reproduces roving-by-selection entry semantics * (sequential re-entry always lands on the SELECTED item, not on the last * arrowed-to one). * - Move `focusgroupstart` to the newly selected item on every commit. * * The engine intentionally leaves every item's `tabindex` untouched: native * directional navigation requires items to be focusable (non-negative * tabindex), and the guaranteed tab stop collapses them into a single * sequential stop. */ export declare class NativeFocusgroupEngine { #private; constructor({ getItems, getOrientation }: FocusgroupEngineOptions); attach(container: HTMLElement | undefined): void; detach(): void; /** * Pushes the current orientation to the `focusgroup` token. The token * encodes the axis (`block` for vertical tablists), so a dynamic * `orientation` change must be synced explicitly. Safe to call before * `attach` (no-op until a container exists). */ syncOrientation(): void; /** * Moves `focusgroupstart` to the selected item. Idempotent; safe to call on * every selection commit or slot change. */ setEntryItem(entryItem: HTMLElement | undefined): void; } export {};