@cube-dev/ui-kit 0.0.0-canary-09a690c → 0.0.0-canary-30d7fcd

package/dist/utils/react/useLocalStorage.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { c } from "react/compiler-runtime";
 import { useSyncExternalStore } from "react";

package/dist/utils/react/useMergeStyles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 import { mergeStyles } from "@tenphi/tasty";
 import { useMemo } from "react";
 

package/dist/utils/react/useOverlayEscapeGuard.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { c } from "react/compiler-runtime";
 import { getEventTarget, nodeContains } from "@react-aria/utils";

package/dist/utils/react/usePopoverSync.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 import { EventBusContext, useEventBus } from "./useEventBus.js";
 import { c } from "react/compiler-runtime";
 import { useContext, useEffect, useEffectEvent, useRef } from "react";

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 //#region src/utils/react/useQaProps.ts
 /**
 * Processes QA props.

package/dist/utils/react/useScheme.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 import { useSyncExternalStore } from "react";
 
 //#region src/utils/react/useScheme.ts

package/dist/utils/react/useViewportSize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 import { c } from "react/compiler-runtime";
 import { useEffect, useState } from "react";
 

package/dist/utils/react/wrapNodeIfPlain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 import { Fragment, isValidElement } from "react";
 
 //#region src/utils/react/wrapNodeIfPlain.ts

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 //#region src/utils/selection.ts
 /**
 * Deduplicate/toggle keys in a selection: if a key appears twice it is

package/dist/utils/styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 import { isSelector, mergeStyles } from "@tenphi/tasty";
 
 //#region src/utils/styles.ts

package/dist/utils/tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 //#region src/utils/tree.ts
 function toFlatTree(tree, includingFolders) {
 	return tree.reduce((result, node) => {

package/dist/utils/warnings.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 import { isDevEnvOrTest } from "./is-dev-env.js";
 
 //#region src/utils/warnings.ts

package/dist/version.js

@@ -1,6 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-09a690c | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-30d7fcd | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.0.0-canary-09a690c";
+const VERSION = "0.0.0-canary-30d7fcd";
 const TASTY_VERSION = "3.9.9";
 if (typeof window !== "undefined") {
 	const version = VERSION;

package/docs/Usage.md

@@ -11,6 +11,10 @@ For styling engine internals see the [Tasty documentation](./tasty/usage.md). Ta
 - **injector.md** — Low-level style injector: `inject()`, `injectGlobal()`, deduplication, SSR.
 - **tasty-static.md** — Zero-runtime `tastyStatic()`, Babel plugin, Next.js/Vite integration.
 
+## Navigation
+
+Pass your router's `useHref` and `useNavigate` hooks through `Root`'s `navigation` adapter. `Menu.Item`, like `Button`, `ItemButton`, and `Link`, accepts `to` destinations. Its label and description expose native anchors for modified-click, middle-click and link context-menu commands; the complete row supports ordinary click and keyboard activation. Use `navigationOptions` for router options and `target`, `rel`, or `download` for native link behavior. Nested providers and overlays inherit the adapter unless they explicitly supply another one.
+
 ## React Compiler
 
 UI Kit ships components optimized with React Compiler and requires React and React DOM 19.3 or newer. Your application does not need to enable Compiler to use this build. Adoption is incremental: functions with known compatibility diagnostics remain unoptimized, and the legacy form's mutable render paths are explicitly excluded.

package/docs/components/CollectionItem.md

@@ -6,6 +6,10 @@
 
 ListBox, FilterListBox, Select, ComboBox, FilterPicker, Picker, Menu, CommandMenu
 
+The parent component determines an item's semantics. `Menu.Item` and `CommandMenu.Item` can mix commands (`onAction`) with navigation links (`to` or `href`). See [Menu](./actions/Menu.md) for keyboard behavior and inline actions, and [CommandMenu](./actions/CommandMenu.md) for searchable menus.
+
+ListBox, ComboBox, SearchComboBox, Select, Picker and their filtering variants render selection options. Their `.Item` APIs reject navigation props, and the controls ignore destinations even when given an item from another factory. Use a menu or command menu when activating a suggestion should navigate.
+
 ## Usage Patterns
 
 There are two ways to provide items to collection components:
@@ -114,7 +118,7 @@ const items = [{
 - **`onAction`** `() => void` — Callback fired when the item is activated (Menu items)
 - **`wrapper`** `(item: ReactElement) => ReactElement` — Function to wrap the rendered item
 
-Extends all [Item component](./content/Item.md) props.
+Supports [Item component](./content/Item.md) content and styling props. Navigation props are available only on `Menu.Item` and `CommandMenu.Item`.
 
 ### Base Properties
 

package/docs/components/actions/CommandMenu.md

@@ -1,11 +1,11 @@
 # CommandMenu
 
-A searchable, keyboard-first surface for finding and executing application actions. CommandMenu renders the searchable menu content; wrap it in `CommandMenu.Trigger` for a button-anchored popover or place it in a `Dialog` for a global command palette.
+A searchable, keyboard-first surface for finding and executing application commands or opening navigation destinations. CommandMenu renders the searchable menu content; wrap it in `CommandMenu.Trigger` for a button-anchored popover or place it in a `Dialog` for a global command palette.
 
 ## When to use
 
 - Users need to search a large or changing set of application commands
-- The primary result of choosing an item is executing an action
+- Choosing an item executes a command or opens a destination
 - Keyboard-first discovery, aliases (`keywords`), and shortcut hints are important
 - A trigger-based command popover or modal global command palette is needed
 
@@ -38,7 +38,7 @@ Choose a different component when the interaction has another outcome:
 - **`autoFocus`** `boolean | FocusStrategy` (default: `true`) — Whether to auto-focus the search input
 - **`items`** `Iterable<T>` — Collection of items for dynamic content with render function pattern
 - **`disabledKeys`** `Iterable<Key>` — Keys of items that should be disabled
-- **`onAction`** `(key: Key) => void` — Callback fired when an item is selected
+- **`onAction`** `(key: Key) => void` — Callback fired when an item is activated, after its own `onAction()`
 - **`isDisabled`** `boolean` — Whether the command menu is disabled
 - **`header`** `ReactNode` — Optional header content above the search input
 - **`footer`** `ReactNode` — Optional footer content below the menu
@@ -117,7 +117,11 @@ For detailed information about all available item properties, see the [Menu.Item
 - **`hotkeys`** `string` — Keyboard shortcut that triggers this item
 - **`tooltip`** `string | boolean | object` — Tooltip configuration
 - **`isDisabled`** `boolean` — Whether the item is disabled
-- **`onAction`** `() => void` — Callback fired when item is activated
+- **`onAction`** `() => void` — Callback fired when the item is activated, before the CommandMenu's `onAction(key)`
+- **`to`** `string | Path` — Application destination resolved by Root's navigation adapter; takes precedence over `href`
+- **`navigationOptions`** `NavigateOptions` — Options for client navigation, such as `replace`, `state`, `relative` and `preventScrollReset`
+- **`href`** `string` — Native destination when `to` is omitted
+- **`target`**, **`rel`**, **`download`**, **`ping`**, **`referrerPolicy`**, **`hrefLang`** — Native anchor attributes
 
 #### CommandMenu-specific Properties
 
@@ -125,6 +129,36 @@ For detailed information about all available item properties, see the [Menu.Item
 - **`forceMount`** `boolean` — Whether to always show this item regardless of search filter
 - **`textValue`** `string` — Text value for search filtering (if different from children)
 
+#### Mixed Commands and Navigation
+
+The same searchable collection can contain commands and links. Give commands an `onAction` and navigation destinations a `to` or `href`; do not navigate again in the action callback. CommandMenu.Item uses the same navigation behavior as [Menu.Item](./Menu.md#navigation-items): ordinary activation uses Root's navigation adapter, while modified clicks, middle clicks, downloads, external destinations and other targets retain native browser behavior. A `!` prefix on `to` opens a new tab, and an `@` prefix forces native navigation.
+
+```tsx
+<CommandMenu aria-label="Workbooks" onAction={recordActivation}>
+  <CommandMenu.Item key="create" onAction={createWorkbook} keywords={['new']}>
+    Create workbook
+  </CommandMenu.Item>
+  <CommandMenu.Section title="Recent workbooks">
+    <CommandMenu.Item
+      key="saved"
+      to={{ pathname: '/workbooks/saved', search: '?view=table' }}
+      description="Open the saved workbook"
+    >
+      Saved workbook
+    </CommandMenu.Item>
+  </CommandMenu.Section>
+  <CommandMenu.Item key="browse" to="/workbooks">Browse all</CommandMenu.Item>
+</CommandMenu>
+```
+
+Filtering, Arrow keys and Enter use the same primary items for both commands and links. The item's `onAction()` runs first, then the CommandMenu's `onAction(key)`, once each. Space activates the highlighted item only while the search is empty; while typing a query, Space inserts text. Disabled items cannot activate or navigate. Selection modes select commands; navigation items open their destination without becoming selected.
+
+Loading items are disabled by default. Set `isDisabled={false}` to keep a loading item available; `disabledKeys` still applies.
+
+Navigation items expose `menuitem` semantics without a checked state, including when other items are checkboxes or radio choices. Supply `aria-current` to identify a destination that represents the current page.
+
+The primary native anchor covers the complete row and exposes the menu-item semantics and destination, while the original Item row retains its layout and style slots. Padding, gaps and whitespace support native browser link commands. Give icon-only items a meaningful accessible name. Follow [Menu's focus and selector migration guidance](./Menu.md#focus-and-selector-migration) for custom selectors. CommandMenu uses virtual focus: the search input keeps DOM focus and identifies the active primary menu item with `aria-activedescendant`, including when styles hide an individual content slot. Inline actions are unsupported in this virtual-focus mode; use a separate primary item for each command or a DOM-focus Menu when independent row actions are required.
+
 #### Example with Enhanced Search
 
 ```jsx
@@ -167,17 +201,17 @@ Alias for MenuTrigger component. See [Menu.Trigger documentation](./Menu.md#menu
 The CommandMenu component provides comprehensive keyboard support:
 
 - **Search Input Focus**: The search input is automatically focused when the palette opens
-- **Arrow Keys**: Navigate through filtered options while keeping search input focused
-- **Enter**: Select the currently highlighted option
+- **ArrowUp/ArrowDown**: Navigate through enabled filtered items while keeping the search input focused
+- **Enter**: Activate the currently highlighted command or navigation destination
+- **Space**: Activate the highlighted item only when the search is empty; otherwise insert a space into the query
 - **Escape**: Clear search term or close the palette
 - **Tab**: Navigate between focusable elements
 
 ### Screen Reader Support
 
-- Proper ARIA roles and labels for search and menu functionality
-- Live region announcements for state changes
-- Support for `aria-activedescendant` for virtual focus
-- Descriptive labels for loading and empty states
+The named search input has `searchbox` semantics and controls a `menu`, rather than a listbox of form options. Its `aria-activedescendant` points to the actual highlighted menu item, including items inside sections and native navigation anchors. Generated IDs are unique per palette. A plain command retains its consumer-provided DOM `id`; keep explicit IDs non-empty and unique within the page. Empty and loading states clear references to items that are no longer rendered.
+
+Give the palette an `aria-label` and provide a descriptive `searchPlaceholder`, which also names the search input. Screen-reader wording and virtual-focus behavior vary by reader and browser; verify the consuming application's browser/reader combination. The [WAI-ARIA active-descendant requirements](https://www.w3.org/TR/wai-aria-1.2/#aria-activedescendant) permit a searchbox to reference an item owned by its controlled menu.
 
 ### Focus Management
 
@@ -441,14 +475,8 @@ The CommandMenu supports enhanced search capabilities:
 ### Performance
 
 - The component uses efficient filtering with React Stately's collection system
-- Search filtering is debounced to prevent excessive re-renders
-- Virtual focus is used to maintain performance with large option sets
-
-### Accessibility Compliance
-
-- Meets WCAG 2.1 AA standards for keyboard navigation
-- Supports screen readers with proper ARIA attributes
-- Implements virtual focus pattern for optimal accessibility
+- Filtering updates as the search value changes
+- Virtual focus keeps the search input focused during item navigation
 
 ### Browser Support
 

package/docs/components/actions/Menu.md

@@ -17,6 +17,10 @@ Choose a different component when the interaction has another shape:
 - Use [FilterPicker](../fields/FilterPicker.md) for persistent single or multiple field values with search.
 - Use [SearchComboBox](../fields/SearchComboBox.md) for a focused search-and-act input that clears after each result.
 
+A menu can mix commands and navigation destinations. For example, an enterprise workbook menu can offer “Create workbook”, links to recent workbooks and a “Browse all” link in the same collection. Choose semantics per item: give navigation a `to` or `href`, and give a command an `onAction`. Consumers do not need to choose a navigation-only mode for the entire Menu.
+
+Use `Menu` when users expect a composite popup with arrow-key navigation and Tab leaving the menu. For a persistent sidebar or ordinary site navigation, prefer a navigation list with links and disclosure buttons; the [WAI-ARIA guidance for navigation disclosures](https://www.w3.org/WAI/ARIA/apg/patterns/disclosure/examples/disclosure-navigation/) explains that interaction. Native anchors with `role="menuitem"` are valid inside a menu, as illustrated by the [WAI-ARIA navigation menu example](https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/examples/menu-button-links/).
+
 ## Component
 
 ---
@@ -32,7 +36,7 @@ Choose a different component when the interaction has another shape:
 - **`defaultSelectedKeys`** `Iterable<Key>` — Initially selected keys (uncontrolled)
 - **`disabledKeys`** `Iterable<Key>` — Keys of items that should appear disabled
 - **`autoFocus`** `boolean | FocusStrategy` (default: `false`) — Whether to auto-focus the menu when it opens
-- **`shouldFocusWrap`** `boolean` (default: `false`) — Whether keyboard navigation should wrap around
+- **`shouldFocusWrap`** `boolean` (default: `true`) — Whether keyboard navigation should wrap around
 - **`size`** `'medium' | 'large'` (default: `medium`) — Size of the menu items
 - **`styles`** `Styles` — Custom styles for the menu container
 - **`menuStyles`** `Styles` — Custom styles for the inner menu list element
@@ -73,7 +77,7 @@ Customizes individual menu items.
 **Sub-elements:**
 
 - `Icon` - Icon element within menu items
-- `Text` - Main text content of menu items
+- `Label` - Main text content of menu items
 - `Description` - Secondary text content for items with descriptions
 
 #### sectionStyles
@@ -166,7 +170,108 @@ For detailed information about all available item properties, see [Item document
 
 - **`textValue`** `string` — Text for typeahead search
 - **`wrapper`** `(item: ReactElement) => ReactElement` — Function to wrap the item
-- **`onAction`** `() => void` — Callback fired when item is activated
+- **`onAction`** `() => void` — Callback fired when this item is activated, before the Menu's `onAction(key)`
+- **`to`** `string \| Path` — Application destination, resolved by Root's navigation adapter; takes precedence over `href`
+- **`navigationOptions`** `NavigateOptions` — Options forwarded during client navigation, such as `replace`, `state`, `relative`, and `preventScrollReset`
+- **`href`** `string` — Link destination when `to` is omitted
+- **`target`**, **`rel`**, **`download`**, **`ping`**, **`referrerPolicy`**, **`hrefLang`** — Native anchor attributes
+
+#### Navigation Items
+
+Navigation items render native anchors. An ordinary click or Enter/Space activation uses the navigation adapter passed to [Root](../Root.md) and closes the menu. Without a custom adapter, activation stays native and preserves the anchor's attributes. Modified clicks, middle clicks, downloads, other targets, and external destinations retain browser link behavior. Right-click offers the browser's link commands. Disabled links have no destination and cannot navigate.
+
+Loading items are disabled by default. Set `isDisabled={false}` to keep a loading item available; `disabledKeys` still applies.
+
+Links expose `menuitem` semantics even in a selectable menu. Only selectable commands expose `menuitemradio` or `menuitemcheckbox` and a checked state; opening a destination does not select it. Use `aria-current` when a link needs to identify the current page.
+
+```tsx
+<MenuTrigger>
+  <Button>Workbooks</Button>
+  <Menu>
+    <Menu.Section title="Recent workbooks">
+      <Menu.Item key="recent" to={{ pathname: '/workbooks/42', search: '?chatId=abc' }}>
+        Recent workbook
+      </Menu.Item>
+    </Menu.Section>
+    <Menu.Item key="browse" to="/workbooks">Browse all</Menu.Item>
+    <Menu.Item key="docs" to="!https://cube.dev/docs">Documentation</Menu.Item>
+    <Menu.Item key="create" onAction={createWorkbook}>Create workbook</Menu.Item>
+  </Menu>
+</MenuTrigger>
+```
+
+As with other UI Kit actions, a `!` prefix opens `to` in a new tab and an `@` prefix forces native navigation. Use `onAction` for commands, including history actions. Link `onAction` callbacks still run during activation; navigation itself belongs to `to` or `href`, so the callback should not navigate again. Submenu parents open their submenu and ignore destinations; links inside the submenu behave normally.
+
+An item's `onAction()` and the Menu's `onAction(key)` compose: when both are supplied, the item callback runs first and the Menu callback runs second, once each. Mouse activation, Enter, Space and the item's hotkey use the same callbacks. Disabled items invoke neither callback. A submenu parent only opens its submenu; its command callbacks do not run. An inline `Menu.Item.Action` handles its own activation independently and does not invoke either callback for the containing row.
+
+```tsx
+<Menu onAction={(key) => recordMenuActivation(key)}>
+  <Menu.Item key="create" onAction={createWorkbook}>Create workbook</Menu.Item>
+  <Menu.Item key="browse" to="/workbooks">Browse all</Menu.Item>
+</Menu>
+```
+
+Use the item callback for a command that belongs to that item, or handle commands centrally using the Menu callback and item keys. Supplying both is useful for additional observation, such as recording an activation; avoid executing the same command in both callbacks.
+
+The native link target covers the complete row, including padding, gaps and whitespace. Right-click anywhere on that target offers the browser's link commands. Independent controls in the prefix, suffix or actions slots retain their own targets. The primary native anchor owns menu-item semantics and keyboard focus, while Item's original list element owns layout and styling. Command content has no link destination.
+
+#### Inline Actions
+
+Use `Menu.Item.Action` in the `actions` slot for an independent action associated with a row. It is a sibling menu item in the keyboard order, outside the row's primary menu item and any navigation anchor. Activating it runs its own `onPress`; it does not run the row's `onAction`, the Menu's `onAction`, or the row's navigation.
+
+```tsx
+<Menu aria-label="Workbooks">
+  <Menu.Item key="create" onAction={createWorkbook}>Create workbook</Menu.Item>
+  <Menu.Item
+    key="saved"
+    to="/workbooks/saved"
+    description="Open the saved workbook"
+    actions={
+      <Menu.Item.Action
+        icon={<TrashIcon />}
+        aria-label="Delete saved workbook"
+        onPress={deleteSavedWorkbook}
+      />
+    }
+  >
+    Saved workbook
+  </Menu.Item>
+</Menu>
+```
+
+Up/Down and Home/End include inline actions in DOM order. Disabled actions are skipped. Tab and Shift+Tab leave the menu rather than visiting each action. Give every action an accessible name that identifies its context, such as “Delete saved workbook”; an icon or a repeated “Delete” label alone does not identify the affected row.
+
+Keep the label and description non-interactive: text, icons and decorative badges are suitable, but buttons, links and inputs belong outside those content slots. `Menu.Item.Action` supplies the menu-item contract automatically. A custom control in `actions` must provide the same contract, including an appropriate menu-item role, accessible name, `tabIndex={-1}`, disabled behavior and keyboard activation; a generic button is not sufficient. Inline actions support the default DOM-focus mode; combining them with virtual focus is unsupported.
+
+#### Focus and Selector Migration
+
+The original `li` retains Item's layout, style slots, modifiers and forwarded ref. A navigation row, or a command row with inline actions, places the primary menu-item role and DOM focus on a native anchor covering the row. A command without inline actions keeps its menu-item role and focus on the `li`. The command anchor has no `href`. Inline actions remain outside that primary focus target.
+
+Give every item a meaningful accessible name; use `aria-label` or `aria-labelledby` for icon-only rows. Hiding an individual content slot does not move the primary focus target. Explicit accessible names remain in effect. Heading items retain their heading element and level.
+
+Use the item's `focused` modifier for row focus styles. It marks the active collection row, including the row associated with a focused inline action. Existing style props and named sub-element overrides continue to style the same layout elements.
+
+```tsx
+<Menu
+  itemStyles={{
+    fill: { '': '#clear', focused: '#dark.09' },
+  }}
+>
+  <Menu.Item key="browse" to="/workbooks">Browse all</Menu.Item>
+</Menu>
+```
+
+Consumer CSS that literally targets `li:focus` or assumes the `li` has `role="menuitem"` needs to follow the split between layout and semantics:
+
+| Selector purpose | Use |
+| --- | --- |
+| Focus styling on the layout row | The `focused` style state, or `[data-menuitem][data-focused]` |
+| Row layout or adjacency | The layout marker `[data-menuitem]`, including `[data-menuitem] + [data-menuitem]` |
+| The actual focusable menu item | `[role="menuitem"]`, `[role="menuitemcheckbox"]` or `[role="menuitemradio"]` |
+
+Do not use the forwarded row ref or a role selector as a proxy for the primary focus target. A row's semantic role can move to its anchor when a destination or inline action is added. `:focus-within` tracks DOM focus anywhere inside the row; use the `focused` modifier for the collection's active-row state, including virtual focus.
+
+Use named style slots or their `data-element` markers for content styling. Selectors that depend on the Label, Description or Icon being a particular HTML tag need to allow their native anchor host. A private native target is also a child of the row; use slot markers instead of child-position selectors for content.
 
 #### Example with Rich Items
 
@@ -397,32 +502,32 @@ const items = [
 
 ### Keyboard Navigation
 
-- `Tab` - Moves focus to the menu
-- `Arrow Keys` - Navigate between items
-- `Right Arrow` - Open submenu when focused on submenu trigger
-- `Left Arrow` - Close submenu and return to parent
-- `Home/End` - Move to first/last item
-- `Enter/Space` - Activate the focused item or open submenu
-- `Escape` - Close the menu or submenu
-- `A-Z` - Typeahead search for items
+- Open the menu with its trigger to move focus into it. A standalone Menu can use `autoFocus` or be reached with Tab.
+- `ArrowUp`/`ArrowDown` - Navigate through enabled primary items and inline actions in DOM order. Navigation wraps by default; set `shouldFocusWrap={false}` to stop at the ends.
+- `Home`/`End` - Move to the first/last enabled menu item, including inline actions.
+- `Enter`/`Space` - Activate the focused command, destination or inline action, or open a submenu.
+- `ArrowRight` - Open a submenu from its trigger. On a row with inline actions, move from the primary item into its actions.
+- `ArrowLeft` - Return from inline actions to their primary item, or close a submenu and return to its trigger. Left/Right directions reverse in RTL layouts; submenu behavior takes priority over row shortcuts.
+- `Tab`/`Shift+Tab` - Leave the menu; inline actions do not add separate Tab stops.
+- `Escape` - Close the menu or submenu.
+- Typing, `PageUp` and `PageDown` - Use the primary collection items. From an inline action, focus first returns to its primary row before the collection handles the key.
 
 ### Screen Reader Support
 
-- Menu announces as "menu" with proper role
-- Items announce as "menuitem", "menuitemcheckbox", or "menuitemradio"
-- Submenu triggers announce with "has submenu" indication
-- Selection state is announced for selectable items
-- Keyboard shortcuts are announced when present
-- Section headings provide context for grouped items
-- Submenu opening and closing is announced to screen readers
+The collection has the `menu` role and an accessible name supplied by `aria-label` or `aria-labelledby`. Each focus target exposes `menuitem`, `menuitemcheckbox` or `menuitemradio` semantics. The item label supplies its name, and its description supplies additional accessible information. Submenu triggers expose their expanded state and submenu relationship; selectable items expose their checked state.
+
+A navigation item's focused menu item is the native anchor with the real destination. A screen reader may announce it as a menu item rather than an ordinary link because its menu-item role defines the composite interaction. Browser link commands remain available on the anchor. The layout row is presentational when its child owns the menu-item role, so inline actions are exposed as independent siblings rather than interactive descendants of a menu item.
+
+Screen-reader wording varies by reader and browser. Provide descriptive names for the menu and every inline action, and verify the chosen browser/reader combination in the consuming application, especially when adding custom controls or wrappers.
 
 ### ARIA Properties
 
 - `aria-label` - Provides accessible label for the menu
 - `aria-labelledby` - References element that labels the menu
-- `aria-activedescendant` - Indicates the currently focused item
 - `aria-orientation` - Indicates menu orientation (vertical by default)
 
+Default Menu navigation moves DOM focus directly to items. CommandMenu owns the search input's `aria-controls` and `aria-activedescendant` relationship. A custom consumer using Menu's virtual-focus mode must own that relationship on its focused controller; enabling virtual focus alone does not supply it.
+
 ## Best Practices
 
 1. **Clear Labels**: Use descriptive, action-oriented labels

package/docs/components/data/ItemTable.md

@@ -525,8 +525,6 @@ Virtualization is skipped for the empty and error states, and turns off entirely
 
 Wide bounded tables also window default text cells horizontally, with a small overscan band. Headers and the complete column layout remain mounted, so header Tab order, menus, resizing, sticky columns and logical ARIA indices remain available. Offscreen body runs become hidden colspan spacers; scrolling mounts their text cells when they approach the viewport.
 
-Tables that retain every body column skip column-window tracking. Small horizontal moves reuse the mounted buffer rather than rebuilding rows at every column boundary. The moving edge refills while retaining the ahead coverage; extra cells are released when scrolling settles or vertical movement starts, so new rows keep their ordinary body window.
-
 Pinned and structural columns, row headers, the tree column, wrapping columns, custom renderers and per-column cell styles remain mounted. This preserves row naming, controls, drafts and measured row heights. Arbitrary `cellProps`, custom body/row/cell styling, `SlotProvider` text overrides or text/descendant overrides supplied through `styles` keep the complete body layout. When the row-height floor is below the inherited text line box, the body also keeps all columns, since offscreen text can determine intrinsic height. Relative row-height tokens also keep the complete body. This check follows ancestor typography and size-token changes, including viewport media queries. Auto-height and explicitly disabled virtualization render all columns.
 
 ```jsx

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.0.0-canary-09a690c",
+  "version": "0.0.0-canary-30d7fcd",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {