@cube-dev/ui-kit 0.190.2 → 0.190.4

package/dist/utils/react/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { getDisabledElementProps, omitActivationEventProps } from "./disabledProps.js";
 import { forwardRefWithGenerics } from "./forwardRefWithGenerics.js";

package/dist/utils/react/interactions.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { c } from "react-compiler-runtime";
 import { useRef, useState } from "react";

package/dist/utils/react/isTextOnly.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { Children, isValidElement } from "react";
 
 //#region src/utils/react/isTextOnly.ts

package/dist/utils/react/mapProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 //#region src/utils/react/mapProps.ts
 /** Converts AriaButtonProps to CubeButtonProps */
 function ariaToCubeButtonProps(props) {

package/dist/utils/react/mergeProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { chain } from "./chain.js";
 import { mergeIds } from "./useId.js";
 import { mergeStyles } from "@tenphi/tasty";

package/dist/utils/react/nullableValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 //#region src/utils/react/nullableValue.ts
 function castNullableStringValue(props) {
 	return castNullableField(props, ["value", "defaultValue"], "string", (v) => String(v));

package/dist/utils/react/programmaticFocus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 //#region src/utils/react/programmaticFocus.ts
 /**
 * Telling focus the user moved from focus a component moved for them.

package/dist/utils/react/resolveIcon.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 //#region src/utils/react/resolveIcon.ts
 /**
 * Resolves a dynamic icon prop to its content and slot state.

package/dist/utils/react/sharedStore.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { isDevEnv } from "../is-dev-env.js";
 import { c } from "react-compiler-runtime";

package/dist/utils/react/useBufferedValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useCallback, useRef, useState } from "react";
 

package/dist/utils/react/useCombinedRefs.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import { useEffect, useRef } from "react";
 

package/dist/utils/react/useControlledFocusVisible.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { c } from "react-compiler-runtime";
 import { useEffect } from "react";

package/dist/utils/react/useEventBus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { c } from "react-compiler-runtime";
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { c } from "react-compiler-runtime";
 import { useEffect, useRef, useState } from "react";

package/dist/utils/react/useIsDarwin.js

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

package/dist/utils/react/useKeySymbols.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { useIsDarwin } from "./useIsDarwin.js";
 import { c } from "react-compiler-runtime";
 

package/dist/utils/react/useLayoutEffect.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import * as React$1 from "react";
 
 //#region src/utils/react/useLayoutEffect.tsx

package/dist/utils/react/useLocalStorage.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | 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.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | 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.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 import { useEvent } from "../../_internal/hooks/use-event.js";
 import { c } from "react-compiler-runtime";
 

package/dist/utils/react/usePopoverSync.js

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

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | 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.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | 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.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | 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.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | 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.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | 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.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | 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.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | 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.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | 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.190.2 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.190.4 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.190.2";
+const VERSION = "0.190.4";
 const TASTY_VERSION = "3.9.6";
 if (typeof window !== "undefined") {
 	const version = VERSION;

package/docs/components/actions/Link.md

@@ -59,6 +59,8 @@ These properties allow direct style application without using the `styles` prop:
 <Link to="../parent-page">Parent</Link>
 ```
 
+A string is external only when it starts with a URL scheme (`https:`, `mailto:`, `tel:`) or with `//`. A colon later in a path or query, as in `/models/cube:orders` or `..?thread=a:b`, stays router navigation. Write a relative path whose first segment holds a colon as `./cube:orders`.
+
 ### 2) Open in a new tab (`!` prefix)
 
 ```jsx

package/docs/components/content/HotKeys.md

@@ -16,7 +16,7 @@ A component that displays keyboard shortcuts in a visually appealing and accessi
 
 ### Properties
 
-- **`children`** `string` — Key combination string (e.g., "mod+k, ctrl+k")
+- **`children`** `string | (string | number)[]` — Key combination string (e.g., "mod+k, ctrl+k"). An array of text, such as the one `<Trans>` passes to a component slot, is joined into one string first.
 - **`type`** `'default' | 'primary' | 'inherit'` (default: `default`) — Visual appearance type: default (subtle), primary (high contrast), or inherit (adapts to parent color)
 
 ### Base Properties
@@ -102,6 +102,18 @@ The inherit type is particularly useful when the HotKeys component needs to matc
 </div>
 ```
 
+### Inside a Translation
+
+`HotKeys` can fill a `<Trans>` component slot. The keys come from the translated string:
+
+```jsx
+<Trans
+  i18nKey="search.hint"
+  defaults="Press <hotkeys>mod+k</hotkeys> to search"
+  components={{ hotkeys: <HotKeys type="inherit" /> }}
+/>
+```
+
 ### With Accessibility Labels
 
 ```jsx
@@ -205,7 +217,7 @@ The inherit type is particularly useful when the HotKeys component needs to matc
 
 ## Key Format
 
-The component children accepts a string with the following format:
+The keys (a string, or text children joined into one string) use the following format:
 
 - **Single key**: `"enter"`, `"space"`, `"a"`
 - **Key combinations**: `"mod+k"`, `"ctrl+shift+p"`

package/docs/components/content/Skeleton.md

@@ -17,6 +17,7 @@ A skeleton loading indicator with preset layouts. Composes `Placeholder` compone
 - **`tabs`** `number` (default: `3`) — Number of tabs (for tabs layout)
 - **`cards`** `number` (default: `3`) — Number of stat cards (for stats layout)
 - **`isStatic`** `boolean` (default: `false`) — Disable shimmer animation
+- **`children`** `ReactNode` — Replaces the placeholder body in the `page`, `content` and `tabs` layouts. The page's header row and the tab strip stay. Other layouts ignore it.
 - **`size`** `string` (default: `'2x'`) — Height of individual placeholder elements (from Placeholder)
 - **`circle`** `boolean` — Render placeholder as a circle (1:1 aspect ratio with round radius)
 - **`template`** `string` — CSS grid-template shorthand for the skeleton root grid layout
@@ -48,3 +49,11 @@ These properties allow direct style application without using the `styles` prop:
 
 <Skeleton layout="chart" columns={8} />
 ```
+
+### Custom Body
+
+```jsx
+<Skeleton layout="tabs" tabs={5}>
+  <Placeholder height="30x" />
+</Skeleton>
+```

package/docs/components/content/Tree.md

@@ -47,6 +47,7 @@ The component's data shape (`treeData`) and the public callback shape are design
 - **`menuTriggerProps`** `Partial<CubeMenuTriggerProps>` — Forwarded to every per-row `MenuTrigger`.
 - **`menuProps`** `Partial<CubeMenuProps<object>>` — Forwarded to every per-row `Menu` (both the overflow `⋮` menu and the right-click context menu). If you pass `onAction` here, it is **chained with** the tree-level `onAction`/per-node `data.onAction` callbacks (it does not override them) and receives the same normalized action key.
 - **`rowStyles`** `Styles` — Override styles for `[data-element="Row"]`.
+- **`itemProps`** `TreeItemProps | ((data: CubeTreeNodeData, state: TreeNodeState) => TreeItemProps)` — Per-row `Item` props (`prefix`, `suffix`, `actions`, `description`, `tooltip`, …), as an object or resolved for each row from its data and state. `TreeItemProps` and `TreeNodeState` are exported for typing the callback.
 
 #### `CubeTreeNodeData`
 
@@ -113,7 +114,7 @@ The following row-level modifiers are emitted automatically. They are useful whe
 
 ### Selection Modes
 
-- `none` — Row click does not select. Useful in pure-display or pure- checkable trees.
+- `none` — Row click does not select; pressing an expandable row toggles it. Useful in pure-display or pure- checkable trees.
 - `single` (default) — One row selected at a time.
 - `multiple` — Multi-select with keyboard modifiers and shift-range.
 
@@ -262,10 +263,11 @@ Tree implements the [`treegrid` ARIA pattern](https://www.w3.org/WAI/ARIA/apg/pa
 - `ArrowLeft` — Collapse the focused row (or move to its parent if already collapsed).
 - `Home` / `End` — Move focus to the first / last visible row.
 - `Space` / `Enter` — Toggle selection on the focused row (in `single` or `multiple` mode).
+- `Escape` — Clears the selection when rows are selected. Otherwise it reaches the surrounding overlay, such as a popover or dialog, so it can close, from a row and from a row's checkbox alike.
 
 ### Screen Reader Support
 
-- Each row reports `aria-level`, `aria-posinset`, `aria-setsize`, and `aria-expanded` so screen readers can announce the position and expansion state.
+- Each row reports `aria-level`, `aria-posinset` and `aria-setsize`. Expandable rows also report `aria-expanded`, including a lazy row (`isLeaf: false`) whose children have not loaded yet.
 - When `isCheckable` is enabled, the row carries `aria-checked` (`true`, `false`, or `mixed` for the indeterminate state).
 - Disabled rows expose `aria-disabled="true"`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.190.2",
+  "version": "0.190.4",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {
@@ -125,6 +125,7 @@
     "dedent": "^0.7.0",
     "eslint": "^10.8.0",
     "eslint-plugin-react-hooks": "^7.1.1",
+    "eslint-plugin-sonarjs": "^4.2.2",
     "husky": "^6.0.0",
     "jiti": "^2.6.1",
     "jsdom": "^29.1.1",
@@ -199,6 +200,7 @@
     "audit-defaults": "UPDATE_DEFAULTS=1 vitest run src/eslint-plugin/defaults.test.ts && prettier --write src/eslint-plugin/defaults.generated.ts",
     "diagnostics:compiler": "node scripts/compiler/report.mjs",
     "diagnostics:form": "node scripts/form-diagnostics.mjs",
+    "diagnostics:complexity": "node scripts/complexity-report.mjs",
     "update-tasty": "pnpm add @tenphi/tasty@${npm_config_version:-latest} --save-exact",
     "update-glaze": "pnpm add @tenphi/glaze@${npm_config_version:-latest} --save-exact",
     "test:form-compiled": "vitest run --config vitest.form-compiled.config.ts"