@cube-dev/ui-kit 0.0.0-canary-0b19a41 → 0.0.0-canary-74176ba

package/dist/utils/react/useScheme.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-0b19a41 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-74176ba | 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-0b19a41 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-74176ba | 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-0b19a41 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-74176ba | 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-0b19a41 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-74176ba | 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-0b19a41 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-74176ba | 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-0b19a41 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-74176ba | 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-0b19a41 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-74176ba | 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-0b19a41 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-74176ba | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.0.0-canary-0b19a41";
+const VERSION = "0.0.0-canary-74176ba";
 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/actions/Menu.md

@@ -73,7 +73,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
@@ -167,6 +167,34 @@ 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
+- **`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`** — 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.
+
+```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.
+
+The label and description provide native anchors; use these text cells for browser link commands. The complete row retains ordinary click and keyboard activation, while Item's original list element owns layout, focus and styling. Inline action controls remain independent. This preserves sizing, structural style conditions, visibility and focus styles. Command text has no link destination.
 
 #### Example with Rich Items
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.0.0-canary-0b19a41",
+  "version": "0.0.0-canary-74176ba",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {
@@ -46,7 +46,6 @@
     "test:package": "vitest run --config vitest.package.config.ts",
     "watch": "tsdown --watch",
     "test": "vitest run",
-    "test:once": "node scripts/test-once.mjs",
     "test:form-store": "vitest run --config vitest.form-store.config.ts",
     "test:form-react": "vitest run --config vitest.form-react.config.ts",
     "test:browser": "vitest run --config vitest.browser.config.ts",