@nice2dev/ui-presentations 1.2.2 → 1.3.0

package/CHANGELOG.md

@@ -1,5 +1,381 @@
 # @nice2dev/ui-presentations — Changelog
 
+## 1.3.0
+
+### Patch Changes
+
+- ada5a2d: Keyboard, gamepad and remote input for every Nice control (TODO_1.3.0, ADR-005).
+
+  - `@nice2dev/ui-core` gets the input layer, also as its own entry `@nice2dev/ui-core/input`:
+    one engine per page that turns keys, pad buttons and remote keys into intents (`navigate`,
+    `activate`, `back`, `secondary`, `tertiary`, `menu`, `view`, `sectionPrev` / `sectionNext`,
+    `pagePrev` / `pageNext`, `first` / `last`, `scroll`, `toggleHints`). No animation frame without a
+    pad; changes only, no re-render per frame; repeat with acceleration, stick hysteresis, several
+    pads, Xbox / PlayStation / Nintendo / Steam / generic families (Nintendo confirms with the right
+    button). Pads also emulate the matching key on the focused element, so controls with a keyboard
+    pattern work with a pad as they are.
+  - Focus without registration: spatial moves between tabbable elements, focus scopes
+    (`useFocusScope`, `<NiceFocusScope>`) with memory, wrapping, traps and escalation at an edge,
+    regions for F6 / Select, focus recovery when the focused element disappears. Value controls are
+    engaged first on a pad (`useEngage`): the d-pad passes them by until A.
+  - `useRovingFocus` (APG keys, 1-D and 2-D, typeahead, RTL), `useOverlayFocus` (initial focus,
+    trap, Escape / B, overlay stack, return to the opener), `useIntent`, `useInputMethod`,
+    `useGamepadFamily`, `useInputPreferences`, `NiceInputProvider` (preferences persisted in
+    `NiceUserPreferences` as `global.input`; `useUserPreferencesOptional` added).
+  - `@nice2dev/testing`: `mockGamepad()` with a controlled frame clock, `pressKey()`,
+    `pressIntent()`, `describeInputContract()` / `runInputContract()`, `stubLayout()` /
+    `stubGridLayout()` for jsdom.
+  - Focus visibility: in pad and remote modes the ring shows on plain `:focus` (the browsers'
+    `:focus-visible` heuristics miss focus moved by a pad); an engaged control wears
+    `--nice-focus-ring-engaged`; `scroll-padding` on the root from `--nice-scroll-padding-top` /
+    `-bottom`. `NiceDisplayValue` drew no ring: its outline used the box-shadow token as a colour.
+  - The old APIs are layers over the engine and `@deprecated` (removal only in a breaking release):
+    `useGamepad` reads the engine's frames — no animation loop of its own and no render per frame;
+    `NiceSpatialNavProvider` takes intents instead of a `window` keydown listener, so it no longer
+    steals the arrow keys of text fields; `useRovingTabIndex` runs on `useRovingFocus` (2-D in
+    `grid`); `createNavigationActions` fires once per stick push instead of every frame.
+  - Button prompts (B1–B4, B6, B7): 41 glyphs of pad buttons (Xbox, PlayStation, Nintendo, generic
+    positions), bumpers, triggers, d-pad, sticks, remote keys and the macOS key symbols — outline
+    built-ins of `NiceIcon` and filled, coloured `Ntd*` icons of `@nice2dev/icons` under the same
+    names (`pad-xbox-a` → `NtdPadXboxA`); `NiceKeyCap` (words translated, arrows and ⌘ ⌥ ⇧ as
+    glyphs); `NiceButtonPrompt` (the button or key of an intent for the device in use, the pad
+    family and the user's bindings); `NiceInputHintBar` + `useInputHints` (the actions of the focus
+    path); `useNiceAction` (application actions with a key, a pad intent, a scope, `when`,
+    `aria-keyshortcuts`, conflict warnings) and `useNiceActions` / `triggerNiceAction` for command
+    palettes. `NiceKeyboardHint` is reachable with Tab, draws an icon instead of "?", keycaps, and
+    the pad button of shortcuts that carry an `intent` (`COMMON_SHORTCUTS` do); `NiceSkipLink`
+    translates its default text. 64 dictionary keys in six languages.
+  - `NiceDeviceManager`, the karaoke pad player, the note particles (ui-audio) and the model viewer
+    (ui-3d) read pads through the engine (`getInputEngine().gamepadSnapshot`,
+    `useConnectedGamepads`). `@nice2dev/ui` re-exports the app-facing part of the input layer.
+  - `NiceInputSettings` (new): the input preferences and the rebinding of every intent to keys or a
+    pad button, captured from the next press. `NiceCommandPalette` opens on the `menu` intent
+    (Ctrl+K, Start, the remote's menu key), keeps focus inside, moves with the d-pad, runs with A
+    and lists the `useNiceAction` actions (`includeActions`, default on).
+  - Shells are focus scopes (D1, D2): `NiceNavShell`, `NiceAppShell` and the shells of
+    `NiceShells` move with the arrows and the d-pad, have F6 / Select regions, switch sections with
+    LB / RB and show the hint bar in pad mode (`hintBar`: `bottom` by default, `top`, `none`).
+    `NiceNavShell` gets an APG tab strip with a tab menu and moving tabs without dragging
+    (Ctrl+Shift+← →), moves focus into the new page after navigating (`focusContentOnNavigate`),
+    remembers focus per route and announces the page; `contentArrows: 'native'` gives the arrows
+    back to the page.
+  - Tabs (C6): every tab list moves with ← → Home End and the d-pad (`useRovingFocus`, also new
+    `activateOnMove`). `NiceTabs` links each tab to its panel (`aria-controls` /
+    `aria-labelledby`), sets `aria-orientation`, switches with LB / RB in its scope and shows those
+    prompts with `showHints`. `NiceCarousel` moves between its dots; ← → on the carousel go on to
+    the page at an end without wrapping. The sheet buttons of `NiceSpreadsheet` and the tabs of
+    `NiceMobileTabs` are now `role="tab"` with `aria-selected` (they were buttons with
+    `aria-pressed` — tests that look them up as buttons must look up tabs); stepping onto "More"
+    does not open its sheet.
+  - Overlays (C12): every modal, drawer, sheet, popover, lightbox, picker popup and confirmation
+    runs on `useOverlayFocus`. Escape / B close only the top overlay — they listened on the
+    document before, so one Escape closed every open overlay at once — and focus returns to the
+    element that opened it. `useFocusTrap` runs on `useOverlayFocus` (it took its element list
+    once, so elements added later broke the trap); a modal no longer pulls focus back from a popup
+    opened above it (a select's list portalled after it). An overlay that can be closed shows
+    "B Close" in the hint bar (`closeHint`); `useInputHints` takes several publishers per element
+    (`fallback` hints give way). Consent dialogs (`NiceCookieConsent`, `NiceGDPRConsent`) keep focus
+    until answered. `NiceLightbox`, the mobile `NiceImageGallery`, both print previews and
+    `NiceTutorial` take LB / RB (and LT / RT for zoom) on a pad; their keys listen on the overlay
+    instead of the window. The context menus (`NiceOverlayContextMenu`, `NiceTouchMenuPopover`)
+    open from the menu key, Shift+F10 and X, move with the arrows and letters, and a submenu
+    closes on ← / Escape alone. `NiceWindowManager` / `NiceWindow`: windows are F6 / View regions,
+    raised when focus enters them, and the taskbar moves with the arrows. `NiceCommandBar` gets
+    `aria-activedescendant` and unique ids. The raw glyphs used as icons in `NiceTutorial`, the
+    print preview of `@nice2dev/ui-printing` and `NiceGlobalSearch` are `NiceIcon` / `NiceKeyCap`.
+  - Menus (C7): `useMenuButton` (new) — ↓ / ↑ on the trigger open the menu on its first / last
+    item, the arrows, Home End and letters move, Enter / Space activate items that are not buttons,
+    Escape / B, focus leaving and a press outside close it, and a pad's d-pad moves past the trigger
+    (A opens). It runs `NiceDropDownButton`, `NiceSpeedDialAction`, `NiceUserMenu`, the extra-action
+    menus of `NiceTopNav`, `NiceHamburgerMenu`, the desktop Start menu and the "Open" menu of
+    `NiceThemeBuilder`. `NiceUserMenu` and the `NiceTopNav` action menus closed 200 / 180 ms after
+    their button lost focus, so focus could never move into them. `NiceTopMenu` is an APG menubar;
+    `NiceNavMenu` moves focus into an opened panel (it never did), adds Home / End, moves in two
+    dimensions in a mega panel and opens / closes its flyouts from the keyboard; panels opened by
+    hovering leave focus where it is. The closed panel of `NiceHamburgerMenu` is inert (Tab reached
+    its hidden items). The quick settings of `NiceDeviceTile` are a `dialog`, not a `menu`.
+  - Select lists (C3): with the default `searchable`, `NiceSelect` moved focus into a search
+    field that had no keys — the list could not be used from the keyboard at all. The field and the
+    trigger now share the keys (↑ ↓ PageUp PageDown, Home / End on the trigger, Enter, Escape), the
+    list opens on the selected option, names the highlighted one (`aria-activedescendant`), keeps
+    it in view and gives focus back to the trigger after a pick; a pad moves and picks in the field.
+    The same for `NiceLookup`, `NiceCountryPicker`, `NiceLanguagePicker` and `NiceThemePicker`
+    (after a pick from their search field focus was lost to the page), `NiceAutocomplete`,
+    `NiceMention` and `NiceSearchInput`. A select open inside a modal now closes alone on Escape.
+    `useOverlayFocus` takes `initialFocus: 'none'` and returns focus to the element focused before
+    an `autoFocus` child took it.
+  - Lists (C8): every list of items is an APG listbox with one tab stop — the arrows, Home End,
+    PageUp PageDown and letters move, Enter / Space (A on a pad) pick: `NiceList` (one listbox with
+    groups too), both columns of `NicePickList`, `NiceRevisionHistory`, `NiceTaskInbox` and both
+    panels of `NiceReconciliationView` (Space picks a row, Enter opens its details as a double
+    click does; its rows were `role="row"`, each a tab stop, and `focusStatements()` /
+    `focusEntries()` focused nothing). The fields with a list of suggestions drive it from the field
+    (`aria-activedescendant`) and with a pad: `NiceTagBox` (a list opened by focus alone has no
+    highlight, so Enter still submits a form), `NiceTagInput` (a combobox only with `suggestions`),
+    `NiceAccountPicker`, `NiceContactPicker`, `NiceCommandBar` and `NiceGlobalSearch` (Enter and the
+    pad took the result from before the filter). The dropdowns of `NiceModeSelector` and
+    `NiceDisplayStylePicker` are select-only comboboxes that open on the current item. These fields
+    and triggers are `role="combobox"` now — tests that look them up as textboxes or buttons must
+    look up comboboxes. Each column of `NiceCascadeSelect` is a listbox: → / Enter go into an
+    option's children, ← back; it opens on the selected path and Escape returns focus to the
+    trigger. The panel of `NiceIconPicker` is a dialog on the overlay stack (it listened for Escape
+    on the document) with a two-dimensional icon grid. The time columns of the `NiceDateTimePicker`
+    popup are spinbuttons (Home / End, PageUp / PageDown); the wheel beside them is for the pointer.
+    The palette of `NiceWorkflowDesigner` inserts an element on Enter / Space.
+  - Trees (C9): `useTreeFocus` (new, also exported from `@nice2dev/ui`) — the APG tree view on
+    nested or flat (`aria-level`) trees: one tab stop, ↑ ↓ Home End and letters move, → opens an
+    item or enters it, ← closes it or goes to its parent, `*` opens the siblings; Enter / Space and
+    a pad's A click the item's row and a pad's X / Shift+F10 open its context menu, so the
+    components keep their click handlers. `NiceTreeView` (the items had only the pointer; F2 edits
+    and focus comes back after the edit; its context menu is a real menu with focus in it and
+    Escape back to the item), `NiceTreeSelect` (↓ / ↑ / Enter on the field open the tree with
+    focus in it, ↓ from the search box goes to the tree, a pick returns focus to the field),
+    the page tree of `NiceWiki`, the resource tree of `NiceAccessManager` and the mobile tree of
+    `NiceTopNav` (each node was two tab stops — its toggle and its link — and the mobile tree had
+    `role="tree"` with no items in it).
+  - Data grids (C10): `useGridFocus` (new, also exported from `@nice2dev/ui`) — the APG data grid:
+    one tab stop, the arrows move by row and column, Home / End along a row, Ctrl+Home / Ctrl+End
+    to the corners, PageUp / PageDown by rows; Enter / Space / a pad's A click the cell, and a cell
+    holding one control (a header's "toggle all", a row checkbox, a link) is reached on that
+    control. `NicePermissionMatrix` (the grants had only the pointer), `NiceModuleGrid` (its cells
+    are `gridcell`s now and `role="grid"` sits on the table, no longer on the whole control with
+    its toolbar and pagination — tests that look the grid up still find it, by its label too; a
+    cell's Enter selects its row, a header's sorts; the mobile cards are a listbox of options, not
+    rows), `NiceWarehouseView` (ui-erp; every bin was a tab stop, and a focused bin shows its
+    details as a hovered one does). `NiceSpreadsheet` adds Home / End, Ctrl+Home / Ctrl+End and
+    PageUp / PageDown.
+  - One of several (C4): `NiceSegmentedControl` is a radio group — one tab stop, the arrows (a
+    pad's d-pad) move and select; its options were toggle buttons with `aria-pressed`, one tab stop
+    each (tests that look them up as pressed buttons must look up checked radios). So are the
+    true / false, NPS and star scales of the assessment widgets (`NiceSurvey`, `NiceQuiz`,
+    `NicePollLive`). `NiceRadioGroup` and the payment method selector were native radio groups
+    already.
+  - Sliders (C5): `NiceRangeSlider`'s thumbs had no keys at all — the arrows step, PageUp /
+    PageDown take a tenth of the range, Home / End go as far as the thumb may, and they are named
+    "Minimum" / "Maximum" with the formatted value as `aria-valuetext`. `NiceKnob`, `NiceTempDial`
+    and `NiceRating` add PageUp / PageDown and Home / End; `NiceTempDial` consumes its keys (the
+    arrows also scrolled the page, and an engaged pad's d-pad moved focus away instead of stepping).
+  - Toolbars (C13): the toolbars of `NiceDocumentEditor`, `NiceImageEditor`, `NicePDFViewer`, the
+    file manager, the component playground's canvas and `NiceDock` are one tab stop with the arrows
+    along the bar and Home / End between their buttons (their fields and selects keep their own
+    keys); they are named, a side dock is a vertical toolbar and a focused dock item magnifies as a
+    hovered one does. The file manager's panels name the item under their cursor
+    (`aria-activedescendant`) — its rows were no options, so ↑ ↓ moved a cursor no screen reader
+    could follow.
+  - Dates (C11): `NiceCalendar` is an APG date grid — its days had no keys at all though the hint
+    listed them: focus sits on a day (one tab stop), ← → a day, ↑ ↓ a week, Home / End the week,
+    PageUp / PageDown a month, Shift+PageUp / PageDown a year, crossing into the next month as
+    needed; Enter / Space pick; a pad's LB / RB change the month and LT / RT the year; the month
+    and year pickers move in two dimensions and a pick keeps focus in the calendar. The
+    `NiceDateTimePicker` field opens its picker with Alt+↓, the context-menu key, Shift+F10 or a
+    pad's X (its button is no tab stop), focus on the day; the clock's hour and minute are
+    spinbuttons. The single-field `NiceDateRangeBox` opens with Enter / Space / ↓, its popup is on
+    the overlay stack (it closed on any Escape on the page) and a picked range returns focus to
+    the field. In the engine a read-only text field is not engaged: a pad's A acts as its Enter.
+  - Number fields (C2): WAI-ARIA spinbutton keys — ↑ ↓ a step, PageUp / PageDown ten, Home / End
+    the minimum / maximum (without a bound they stay the caret's). `NiceNumericInput` had no keys
+    at all; `NiceNumberInput` adds the big step and the bounds, a stepped value replaces the typed
+    text (it stayed on screen) and a read-only field no longer steps. With `showSteppers`
+    `NiceMoneyInput`'s amount is a `spinbutton` with the same keys — its stepper buttons are out of
+    the tab order, so the steps were pointer-only (the buttons show `NiceIcon`s instead of "−" /
+    "+"); without steppers it stays a text field. On a pad B on an engaged number field cancels:
+    the engine puts a native `<input type="number">`'s value from before back, and the new
+    `useEngage` option `restoreOnCancel` does it for a custom control (put the value back in
+    `onRelease(true)`). LT / RT on an engaged native field (minimum / maximum) went past React's
+    value tracker unseen — a controlled input never heard of it. The hint bar names what the
+    buttons do on an engaged control — "Adjust", "A Done, B Cancel" on number fields, "Start
+    Confirm, B Done" on a text field, "A Select, B Close" with a list open — and follows engaging
+    and opening a list (it only changed when focus moved).
+  - Composites (C14, part 1): `NiceAccordion` headers move with ↑ ↓ Home / End (each stays a Tab
+    stop; `type="button"` — in a form a header submitted it; `aria-controls` only while the panel
+    exists). `NiceCollapse`'s panel is named by its trigger; a header-toggled
+    `NiceCollapsibleCard` no longer takes Enter / Space from the controls in it. `NiceFAQ`'s
+    folded answers are `inert` (their buttons stayed in the Tab order while hidden) and a
+    foldable group has a button. `NiceStepper` steps are buttons with `allowStepClick` (pointer
+    only before) and the active one is `aria-current="step"`. `NiceWizard` and
+    `NiceSetupWizard` step back and on with LB / RB (Ctrl+PageUp / Ctrl+PageDown) — validated as
+    the buttons are, with hints; the wizard's progress is a `progressbar`, its step content a
+    named `group` (a `tabpanel` without tabs) and its validation error an `alert`; the setup
+    wizard's vertical layout moves through the steps with ↑ ↓. `NiceCarousel` waits while the
+    pointer is over it or focus is in it, has a button that stops / starts the rotation
+    (WCAG 2.2.2 — it never stopped), takes slides out of view out of the Tab order (`inert`),
+    announces a slide the user changed and changes slides on LB / RB. `NiceGallery`'s
+    thumbnails are one Tab stop (← → Home End move and show), `aria-pressed` on the shown one;
+    its autoplay waits the same way; LB / RB change the image. `NicePagination` buttons are
+    `type="button"` (in a form, Enter in a field "clicked" First / Previous), pages are named
+    ("Page 3"), the ellipsis is hidden, the jump field is labelled, the page change is announced
+    and LT / RT (PageUp / PageDown) turn the page, the prev / next buttons showing the triggers
+    next to them (B5). In a paged `NiceDataGrid` a pad's LT / RT turn the page from anywhere in
+    the grid — the keyboard's PageUp / PageDown stay the cell's. A breadcrumb with only `onClick`
+    is a button (an `<a>` without `href` had no Tab stop), separators are hidden. A clickable
+    `NiceTag` takes Enter / Space and, when removable, Delete / Backspace; `aria-pressed` with
+    `selected`; its remove button names the tag ("Remove: React").
+  - Composites (C14, part 2): `NiceColorPicker`'s saturation / brightness box is a slider — it
+    took only the pointer (← → saturation, ↑ ↓ brightness, Shift by ten, PageUp / PageDown,
+    Home / End); its presets are one Tab stop moved in two dimensions (as its shortcut hint
+    already promised), `aria-pressed` on the current one; every channel field is named and a
+    disabled picker is no Tab stop. `NiceGradientPicker`'s stops are sliders (← → move,
+    Delete removes; focus selects as a click does), its toggle groups show `aria-pressed`, every
+    field is named. `NiceColorPalette`'s hue wheel is a slider of the base hue (pointer only
+    before); its tints and shades took focus but no keys — one Tab stop now, Enter / Space
+    apply; focus into a colour row selects it. `NiceUpload`: an icon-only drop zone is named,
+    progress is a `progressbar`, a file's actions name the file and status changes are
+    announced. `NiceTutorial` is named by its step and described by its text, says the title of
+    a new step (focus stays on the Next button) and goes to the first / last step with Home /
+    End. In `useRovingFocus` the pressed button of a toggle group is the initial stop.
+  - TV / 10-foot mode (D4): `data-nice-tv` on any element applies the 10-foot variant of the
+    theme below it — type of 24–28 px on a 1080p picture, targets of 48–64 px, spacing × 1.5, a
+    stronger focus ring (`styles/tv.css`, part of the `@nice2dev/ui` stylesheet); the input engine
+    sets it on `<html>` in a TV browser (webOS, Tizen, Android TV …; `engine.isTv`), and
+    `NiceKioskShell` / `NiceNavShell` take `tv`, which also keeps a 5 % safe area for overscan.
+    Remote keys were already the engine's (A1).
+  - `NiceMdiWorkspace` (D1): the tab menu (right click, X on a pad, Shift+F10) is a menu that
+    takes focus, moves with ↑ ↓ and closes on Escape / B with focus back on its tab — it was a
+    plain box the keyboard never reached; it moves a tab left or right (the way without
+    dragging); Delete closes the focused tab; the unsaved-changes question is a modal dialog with
+    focus on Cancel; LB / RB (Ctrl+PageUp / Ctrl+PageDown) switch tabs from anywhere in the
+    workspace.
+  - Hover has a focus counterpart (C15): `NiceRate` previews the focused star; an auto-hidden
+    `NiceDockMenu` shows while focus is in it (a Tab reached its buttons while they stayed
+    hidden) and its icon or letter items are named by their text; a hover `NicePopover` opens on
+    focus of its trigger too and Escape there hides it first; `NiceTimeline` events took only the
+    pointer — they are one Tab stop moved by the arrows, Enter / Space open one and focus shows
+    its details; `NiceScheduler` events are Tab stops with Enter / Space and their details on
+    focus; the comment button of `NiceGitDiffViewer` shows on focus as on hover.
+  - Typing with a pad (H1, H2): `NiceOnScreenKeyboard` (new, `@nice2dev/ui`) — the d-pad moves
+    over the keys and A types; X deletes, Y types a space, LT / RT move the cursor, LB / RB change
+    the layout (letters with the accents of the interface language, symbols, more languages),
+    Start confirms and B closes; the buttons show next to their keys in pad mode; a physical
+    keyboard and touch type too; `modal={false}` makes it a standing keyboard of a page.
+    `NiceOnScreenKeyboardHost` (new) opens it for the text field a pad or remote engages (A on the
+    field) — every key goes into the field as typing would (a controlled field hears it in
+    `onChange`), Start submits as Enter (a form submits), B leaves the text as it is; number
+    fields get digits, a text area new lines; the `onScreenKeyboard` preference turns it off or
+    also opens it on touch (kiosks). The application shells render the host. Its layouts are the
+    keyboard core now in `@nice2dev/ui-core` (`NICE_KEYBOARD_LAYOUTS`, `buildKeyboardRows`,
+    `insertAtCaret` …), which `NiceTouchKeyboard` (ui-mobile) uses too — its exported type names
+    are unchanged. New built-in glyphs `key-backspace`, `key-space`, `key-caps` (and
+    `NtdKeyBackspace`, `NtdKeySpace`, `NtdKeyCaps` in `@nice2dev/icons`); `setFieldText` writes a
+    field's text past React's value tracker.
+  - Toasts (D3): `NiceToastContainer` is a region named "Notifications", so F6 or a pad's View
+    reaches the toasts while they never take focus; Escape / B dismisses the toast with focus,
+    which goes on to the next toast or back where it came from (it was lost with the toast). The
+    countdown waits while the pointer is over a toast or focus is in it (WCAG 2.2.1). A toast can
+    carry an `action` (`{ label, onClick }`, also in `useNiceToast`'s options, `NiceToastOptions`)
+    — it runs and dismisses the toast.
+  - `NiceScientificChart` (ui-science): the export buttons had no handler — CSV and JSON of the
+    visible data and SVG / PNG of the plot download now, and the new `onExport` takes every format
+    over (PDF is offered only with it); the tooltip sits beside the hovered point instead of the
+    plot's corner. The VLAN panel of `@nice2dev/ui-buildings` labels its connections with a key of
+    their own (in Polish it read "połączeń", the counted form).
+  - `NiceCodeEditor`: an inline `lsp={{ … }}` object re-created the Monaco editor on every render,
+    dropping its undo history and cursor — it is re-created only when the LSP config's content
+    changes. The audio editor's project hooks (`useProjectCRUD`, `useAutoSave`) word their status
+    messages and questions through the translator (some were Polish without diacritics).
+  - Prompts next to controls (B5): `NiceControlHint`, and `hint` / `showHint` on `NiceButton` — the
+    button or keys of its action, shown while hints are visible; keys also become
+    `aria-keyshortcuts`. `NiceButton` also passes `role`, `aria-selected`, `aria-pressed`,
+    `aria-expanded`, `aria-controls`, `aria-haspopup`, `tabIndex` and `onKeyDown`.
+  - Found by the showcase crawler (I4, `scripts/audit-input-crawl.mjs`): **no `NiceButton` showed a
+    focus ring** — the display styles write `box-shadow` inline (`none` for the default `flat`) and
+    that beat the `:focus-visible` rule; the ring is `!important` now, also for the `underlined` and
+    `neumorphic` fields. `NiceCodeEditor`, `NiceCodeDiffEditor`, `NiceSimpleCodeEditor` and
+    `NiceMarkdownEditor` were keyboard traps (Tab indents and Shift+Tab outdents, nothing left the
+    field): Escape, then Tab moves focus on (WCAG 2.1.2), said in the field's description, and a
+    read-only editor lets Tab through (it indented its text); `createTabEscape()` (new, ui-core
+    and ui) gives a control of your own the same. These editors, `NiceHtmlEditor`,
+    `NiceTerminalUI` and the search of `NicePickList` drew no focus at all — their frame shows the
+    ring now. The diagram buttons of `NiceGamepad` were pointer-only, so arming a button for an
+    assignment took a mouse: with a handler or an action tree they are buttons (one Tab stop, the
+    arrows move by geometry, Enter / Space / A press, `aria-pressed` while armed); an SVG element
+    has no `click()`, so a pad's A dispatches a click to one (`clickElement`, new). A sortable
+    `NiceDataGrid` header sorted only on a click: it is a Tab stop and sorts on
+    Enter / Space / A. `NicePasswordInput`'s show / hide button is a Tab stop (showing the password
+    took a pointer). The `NiceDateTimePicker` field says how its picker opens (`aria-haspopup`,
+    `aria-keyshortcuts="Alt+ArrowDown"`).
+  - More from the crawler (I4). `NiceDataGrid` took keys from anything inside it: with a focused
+    cell Tab never left the grid (a trap, also from a header) and the search field's arrows did
+    not move its caret — the cell cursor follows only the grid's own focus, and Tab at the edge of
+    a row leaves. `NiceSpreadsheet`'s formula bar kept Tab without an edit. `NiceModelEditor`
+    (ui-3d) listened on the whole page: Tab cycled its mode anywhere (focus moved nowhere on a page
+    with the editor), Space pressed no button and Ctrl+Z took the undo of every text field — its
+    shortcuts work inside the editor only, Tab and Space on its controls are theirs, Escape then
+    Tab leaves the viewport. `NiceDocumentEditor` indents a block on Tab and lets the keyboard out
+    as the code editors do (Escape, then Tab; its shortcut list says so). `NicePlaylistDualPane` (ui-audio)
+    switches panes on Tab, and Escape then Tab moves on. `NiceSeatingChart` / `NiceSeatPicker`
+    (events) take focus to the cursor seat — it stayed on the chart, out of a screen reader's
+    reach. Rings where there were none: the cursor row of `NiceKaraokeSongBrowser` (it looked the
+    same focused as not), `NiceFileManager`'s panels, `NiceTagInput`, the name field of
+    `NiceWorkflowDesigner`, `NiceDocumentEditor`, the chat and search fields of ui-communication
+    (`outline: none` inline), the search of `NiceGlobalSearch` and `NiceAccessLog`
+    (ui-enterprise), the fields of `NiceTaskManager` and `NiceTorrentUI` (templates) and of the
+    automation and scene editors (ui-buildings), the viewport of `NiceModelViewer` (ui-3d).
+  - `useOverlayFocus` gave focus back to the opener whenever an overlay closed with focus on the
+    page body — also for the moment of a Tab, when the opener's blur closed a popup it showed on
+    focus: a `NiceDataGrid` header with column stats took focus back on every Tab, a trap. Focus
+    goes back now only when it was in the overlay. The keyboard shortcuts of `GenericPlayer`
+    (ui-audio) and `NicePresentationPlayer` (ui-presentations) listened on the whole page — the
+    arrows of every list and a pad's d-pad (they move focus with them) did nothing on a page with a
+    player, Space pressed no button, and with a presentation Backspace deleted nothing and Enter
+    submitted nothing in any field; they work in the player or with focus on the page body, and
+    Space / Enter on the player's own buttons press them. A pad has no Tab: on a control of a
+    player its d-pad moves focus (as seek, volume or the next slide it kept focus in the player for
+    good); on the player itself or the page body a remote's arrows still turn the slides.
+  - Lint (I2): the whole jsx-a11y recommended set is on, with the input program's own rules against
+    page-wide key listeners and inline `outline: 'none'`. Found on the way: the reply box of
+    `NiceHelpdesk` and the search of `NiceCommandBar` took the outline away and showed nothing
+    instead — they show focus now.
+  - `NicePopover` (the one anchored to a `targetRef`) had no keyboard at all — it closed only on a
+    click outside it. It is a `dialog` named by its `title`, takes focus when it opens, closes on
+    Escape / B and gives focus back to its target (tests that count the page's dialogs see it now).
+    A pick in a `NiceSelect` inside it closed it and was lost (the select's list is portalled out
+    of the popover): such a click keeps it open.
+  - Rows, cards, tiles and list entries that answered a pointer only (C1) are buttons for the
+    keyboard and the pad: `role="button"`, a Tab stop, Enter / Space / A press them — a selection
+    toggle says `aria-pressed`, a folder or summary row `aria-expanded`, a check box drawn with a
+    `div` is a `checkbox` with its item's name. `clickOnActivationKey` (new, ui-core and ui) is the
+    `onKeyDown` for such an element: Enter and Space click it, once per press and with the
+    modifiers, so Ctrl+Enter selects as Ctrl+click does; keys of a control inside it stay that
+    control's. Dialog backdrops and click stoppers are `role="presentation"` (Escape / B close the
+    dialogs). Done so far in events (attraction picker and voting, round list), game-engine (the
+    Godot, Unity and Unreal project browsers, the asset store, the editor's hierarchy), licensing
+    (portal, transfer, the license table), templates (health, life dashboard, personal finance,
+    task manager, torrent UI) and `OmniWerkLogo`, whose `role="button"` took no key; ui-3d (model
+    editor outliner with expand / show-hide buttons, Add menu, context menu, timeline, particle
+    editor), ui-ai (dataset, experiment, model and labeling cards), ui-api (endpoints, schemas,
+    history), ui-audio (sample browser, bar-fill swatches, DMX cues and tracks, the "activate
+    audio" overlay, playlist grid / overview / sidebar / search / tags / track list),
+    ui-bi (ETL palette and nodes), ui-buildings (automations, zone card, scenes, network paths,
+    object library), ui-diagrams, ui-enterprise (access log, contract sections), ui-erp (capacity
+    planner — its time cells are named buttons, the only way to add an allocation — and inventory
+    cards), ui-forms, and in ui-core `NiceIcon` and `NiceTouchTarget` with an `onClick` and the
+    profiler's header — `NiceTouchTarget` also draws a focus ring now; ui-graphics (font glyphs, 2D game asset lists and state nodes, photo
+    overlays and colour swatches, pixel layers with show / lock buttons, palette and frames,
+    texture and UI designer layers, vector gradients and layers), ui-iot cards, ui-math templates,
+    ui-monitoring (saved queries, expandable log rows), ui-presentations (slide thumbnails and the
+    overview), ui-printing (template cards, schema fields, layers), ui-science (citations,
+    notebooks) and ui-video (live sources, timeline tracks and clips). A clickable `NiceIcon` is a
+    button now. `ImportPreviewDialog` (ui-buildings) carried `role="dialog"` on its backdrop — it
+    is on the dialog box now. The wheel of `NiceMobilePicker` still has no keys (it gets a
+    spinbutton column with E). Tests that count the buttons of these components find more.
+  - C1 in `@nice2dev/ui`: the rows, cards and items of the devops, data-branching, media, no-code,
+    tools, backup and chart components are buttons (selection toggles `aria-pressed`, folding rows
+    `aria-expanded`); a `NiceKanbanBoard` card that opens on a click and a `NiceTileView` tile with
+    `onTileClick` are buttons; `NiceTreeList` rows fold from the keyboard (the toggle is a named
+    button with `aria-expanded`); `NiceDataGrid`'s virtual group rows and detail toggles take
+    Enter / Space. A built-in `NiceIcon` with `onClick` is a button — it was `aria-hidden` and took
+    no key. `NiceSelect`, `NiceCountryPicker`, `NiceLanguagePicker` and `NiceThemePicker` clear with
+    Delete / Backspace on the trigger (`aria-keyshortcuts="Delete"`): the × in the trigger was
+    pointer-only (in `NiceSelect` a `role="button"` inside the trigger button) and is
+    `role="presentation"` now. `NiceModal`, `NiceConfirmDialog`, `NiceCommandPalette` and
+    `NiceGlobalSearch` stop clicks at the backdrop instead of the dialog — a click on the backdrop
+    itself closes, and no click inside or on it reaches a component around the overlay.
+    `NiceHtmlEditor`'s template list is a menu with keys, its emoji are buttons; `NiceGitManager`
+    opens a file's diff from its path, a button (a click elsewhere on the row did it before);
+    `NiceResourceAllocation`'s days are named buttons with `onSlotClick`. Options of comboboxes and
+    items of menus, trees and grids keep their click with a line disable naming the keys that
+    drive them. The empty cells of `NiceScheduler`'s grids get their keys with E.
+
 ## 1.2.2
 
 ### Patch Changes

package/dist/__tests__/playerKeys.test.d.ts

@@ -0,0 +1 @@
+export {};