@cube-dev/ui-kit 0.143.1 → 0.145.0

package/dist/utils/react/interactions.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 import { useState } from "react";
 import { useFocus, useFocusVisible } from "react-aria";
 

package/dist/utils/react/isTextOnly.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | 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.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | 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.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | 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.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | 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/resolveIcon.js

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

package/dist/utils/react/useCombinedRefs.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 import { useEffect, useRef } from "react";
 
 //#region src/utils/react/useCombinedRefs.ts

package/dist/utils/react/useControlledFocusVisible.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 import { createSharedStore } from "./sharedStore.js";
 import { useEffect } from "react";
 import { useFocusVisible } from "react-aria";

package/dist/utils/react/useEventBus.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 import React, { createContext, useCallback, useContext, useEffect, useMemo, useRef } from "react";
 
 //#region src/utils/react/useEventBus.ts

package/dist/utils/react/useId.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 import { useLayoutEffect as useLayoutEffect$1 } from "./useLayoutEffect.js";
 import { useEffect, useRef, useState } from "react";
 import { useSSRSafeId } from "@react-aria/ssr";

package/dist/utils/react/useIsDarwin.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 import { useEffect, useState } from "react";
 
 //#region src/utils/react/useIsDarwin.ts

package/dist/utils/react/useKeySymbols.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 import { useIsDarwin } from "./useIsDarwin.js";
 import { useMemo } from "react";
 

package/dist/utils/react/useLayoutEffect.js

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

package/dist/utils/react/useMergeStyles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 import { mergeStyles } from "@tenphi/tasty";
 import { useMemo } from "react";
 

package/dist/utils/react/usePopoverSync.js

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

package/dist/utils/react/useQaProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 //#region src/utils/react/useQaProps.ts
 /**
 * Processes QA props.

package/dist/utils/react/useViewportSize.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 import { useEffect, useState } from "react";
 
 //#region src/utils/react/useViewportSize.ts

package/dist/utils/react/wrapNodeIfPlain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 import { isValidElement } from "react";
 import { isFragment } from "react-is";
 

package/dist/utils/selection.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | 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.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 //#region src/utils/styles.ts
 /**
 * Split properties into style and non-style properties.

package/dist/utils/tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | 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.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 //#region src/utils/warnings.ts
 const SUGGESTED_PROP_MAP = {
 	disabled: "isDisabled",

package/dist/version.js

@@ -1,6 +1,6 @@
-/** @license MIT | @cube-dev/ui-kit v0.143.1 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.145.0 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.143.1";
+const VERSION = "0.145.0";
 const TASTY_VERSION = "2.8.0";
 if (typeof window !== "undefined") {
 	const version = VERSION;

package/docs/components/layout/Board.md

@@ -0,0 +1,247 @@
+# Board
+
+A draggable and resizable widget grid for building dashboards. Widgets are
+declared with `Board.Widget` and positioned via a `layout` (grid units). Wrap
+multiple boards in a `BoardProvider` (`Board.Provider`) to drag widgets between
+them, including out of a nested board into its parent.
+
+Dragging and resizing are powered by React Aria's `useMove`, so they work with
+mouse, touch, and keyboard (focus a widget and use the arrow keys). While a
+widget is dragged with a pointer it renders into a fixed overlay so it is never
+clipped by an ancestor's `overflow: hidden`.
+
+## When to Use
+
+- Customizable dashboards where users arrange widgets
+- Report/analytics layouts with resizable tiles
+- Multi-panel workspaces where items move between areas
+- Nested containers whose children can be dragged out
+
+## Component
+
+---
+
+## Concepts
+
+- **Layout** — an array of items `{ i, x, y, w, h }` in grid units. `i` matches a
+  `Board.Widget` `id`.
+- **Content vs. position** — `Board.Widget` declares content; the owning `Board`
+  positions it. This decoupling is what lets a widget be transferred between
+  boards.
+- **Compaction** — `vertical` (default), `horizontal`, or `free`. In `free` mode a
+  widget is placed exactly where you drop it and its neighbours are never pushed
+  or swapped; without `allowOverlap` a drop onto an occupied cell is blocked, and
+  with `allowOverlap` widgets may stack for a fully free canvas.
+
+## Properties
+
+### Board
+
+- **`layout`** `LayoutItem[]` — Controlled layout.
+- **`defaultLayout`** `LayoutItem[]` — Initial layout for uncontrolled usage.
+- **`onLayoutChange`** `(layout: LayoutItem[]) => void` — Called when a drag or resize is committed.
+- **`onDragStart` / `onDrag` / `onDragStop`** `(info: BoardInteractionInfo) => void` — Drag lifecycle callbacks. `onDrag` fires on every step; `onDragStop` fires after the layout is committed.
+- **`onResizeStart` / `onResize` / `onResizeStop`** `(info: BoardInteractionInfo) => void` — Resize lifecycle callbacks, mirroring the drag ones.
+- **`cols`** `number` (default: `12`) — Number of columns.
+- **`rowHeight`** `number` (default: `100`) — Row height in pixels.
+- **`margin`** `[number, number]` (default: `[8, 8]`) — Horizontal/vertical gap between widgets.
+- **`containerPadding`** `[number, number]` — Inner padding. Defaults to `margin`, or to `[0, 0]` for an aligned nested board (`isAligned`) so its grid lines up with the ancestor board's.
+- **`maxRows`** `number` (default: `Infinity`) — Maximum number of rows.
+- **`compact`** `'vertical' | 'horizontal' | 'free' | null` (default: `'vertical'`) — Compaction behavior. `'vertical'`/`'horizontal'` reflow widgets to remove gaps; `'free'` places each widget exactly where dropped and never pushes its neighbours (blocked from occupied cells unless `allowOverlap`); `null` disables compaction but still resolves collisions the legacy react-grid-layout way.
+- **`allowOverlap`** `boolean` (default: `false`) — Allow widgets to overlap (stack). In `'free'` mode this is what distinguishes stacking from blocking a drop onto an occupied cell.
+- **`preventCollision`** `boolean` (default: `false`) — Block movement into occupied cells instead of pushing.
+- **`isDraggable`** `boolean` (default: `true`) — Enable dragging for all widgets.
+- **`isResizable`** `boolean` (default: `true`) — Enable resizing for all widgets.
+- **`isDroppable`** `boolean` (default: `true`) — Whether the board accepts widgets dropped from other boards.
+- **`resizeHandles`** `ResizeHandleAxis[]` (default: `['se']`) — Which resize handles to show. Corner handles (`ne`/`nw`/`se`/`sw`) show an angle grip; edge handles (`n`/`s`/`e`/`w`) show a dotted grip. Both are revealed on hover/focus/resize. A single edge (e.g. `['e']` or `['s']`) gives a horizontally- or vertically-only resizable widget.
+- **`dragCancel`** `string` — CSS selector for elements that must not start a pointer drag (e.g. form controls inside a widget: `"input,textarea,button,a,.no-drag"`). Keyboard moves are unaffected. Can be overridden per widget.
+- **`dragHandle`** `string` — CSS selector for the only elements from which a pointer drag may start. Can be overridden per widget.
+- **`showGridLines`** `boolean | 'drag'` (default: `false`) — Show grid lines behind the widgets. `true` always, `'drag'` only while a widget is being dragged or resized. A nested board that does not set this inherits an enabled ancestor's grid lines, showing its own while a drag is in progress.
+- **`isAligned`** `boolean` (default: `false`) — Align a nested board with its ancestor `Board`'s layout. Only takes effect when the board is nested inside another `Board`'s widget. When set, every cell matches the parent's cell size exactly: the board inherits the parent's column pitch (deriving its own column count from its measured width so cells stay parent-sized as the container is resized) and uses the parent's row height verbatim. It never shrinks rows to fit — pair it with an `isAutoHeight` container so the widget grows to fit its rows at that height. `cols`/`rowHeight` then act as fallbacks used only until the parent metrics resolve.
+- **`constraints`** `LayoutConstraint[]` — Grid/item layout constraints.
+- **`width`** `number` — Explicit width (disables measurement; useful for SSR/tests).
+- **`widgetProps`** `Partial<Board.Widget props>` — Default props applied to every widget this board hosts (per-widget `Board.Widget` props override these). Use it to add a card border to every widget (`widgetProps={{ isCard: true }}`) or set shared `styles`/sizing defaults without repeating them on each widget.
+- **`place`** `Styles['place']` — Style prop shorthand for `place-items`/`place-content`.
+- **`scrollMargin`** `Styles['scrollMargin']` — Style prop for scroll margin.
+
+### Board.Widget
+
+- **`id`** `string` (required) — Must match the `i` of a layout item.
+- **`isCard`** `boolean` (default: `false`) — Render this widget as a card by adding a border. Widgets are always filled (`#surface-2`) and rounded (`1cr`); `isCard` adds the border on top. Defaults to `false` (borderless) unless the owning `Board`'s `widgetProps.isCard` opts in; set it per widget to override that default.
+- **`isDraggable`** `boolean` — Disable dragging for this widget.
+- **`isResizable`** `boolean` — Disable resizing for this widget.
+- **`resizeHandles`** `ResizeHandleAxis[]` — Override the board's handles.
+- **`minW`** `number` — Minimum width in grid columns. Used when the layout item omits `minW`; the resize handle stops here.
+- **`maxW`** `number` — Maximum width in grid columns. Used when the layout item omits `maxW`.
+- **`minH`** `number` — Minimum height in grid rows. Used when the layout item omits `minH`.
+- **`maxH`** `number` — Maximum height in grid rows. Used when the layout item omits `maxH`.
+- **`constraints`** `LayoutConstraint[]` — Per-widget constraints.
+- **`qa`** `string` — Test id for the rendered widget element.
+- **`styles`** `Styles` — Style overrides for the rendered widget element.
+- **Style properties** — `Board.Widget` also accepts container style props directly (e.g. `fill`, `padding`, `radius`, `border`, `shadow`, `color`, `flow`, `gap`), just like `Board`. They are merged into `styles` (a direct prop wins over the same key in the `styles` object). Shared `widgetProps.styles` from the owning `Board` are merged underneath, so a per-widget style only overrides the matching keys instead of replacing the whole default.
+- **`isAutoHeight`** `boolean` (default: `false`) — Grow this widget's height in its board to fit its content (only ever increases, never shrinks). Pair it with a nested `Board isAligned` so the container expands until the inner board's rows fit at the parent's row height. It also pins the widget's resize floor: you cannot drag the widget shorter than the height its content currently needs.
+- **`dragCancel`** `string` — Override the board's `dragCancel` selector for this widget.
+- **`dragHandle`** `string` — Override the board's `dragHandle` selector for this widget.
+
+### Board.Provider
+
+Shares one drag context across multiple boards. A standalone `Board` provides its
+own automatically; only use `Board.Provider` when you need cross-board dragging.
+
+- **`onWidgetTransfer`** `(info: { widgetId, fromBoardId, toBoardId, item }) => void` —
+  Fired when a widget is dropped from one board into another.
+
+Dragging a widget across a container that can unmount (for example, out of an
+inactive `Tab`) requires controlled ownership: a widget's content is declared by
+its `Board.Widget`, so if that declaration unmounts the content is lost. Keep
+each board's `layout` controlled and, in response to `onWidgetTransfer`, move the
+`Board.Widget` declaration into the destination container so the content follows
+the widget. The [Boards inside Tabs](#boards-inside-tabs) example shows the
+pattern.
+
+### Board.Responsive
+
+A wrapper around `Board` that selects a layout and column count based on the
+container's measured width, mirroring react-grid-layout's `Responsive` +
+`WidthProvider`. It accepts all `Board` props except `layout`, `defaultLayout`,
+`cols`, `onLayoutChange`, and `width` (which it manages), plus:
+
+- **`breakpoints`** `Record<string, number>` — Breakpoint name to minimum container width (px).
+- **`cols`** `Record<string, number>` — Breakpoint name to column count.
+- **`layouts`** `Record<string, LayoutItem[]>` — Controlled per-breakpoint layouts.
+- **`defaultLayouts`** `Record<string, LayoutItem[]>` — Initial per-breakpoint layouts for uncontrolled usage.
+- **`onLayoutChange`** `(currentLayout: LayoutItem[], allLayouts: Record<string, LayoutItem[]>) => void` — Called on commit with the active breakpoint's layout and the full map.
+- **`onBreakpointChange`** `(breakpoint: string, cols: number) => void` — Called when the active breakpoint changes.
+- **`onWidthChange`** `(width: number, cols: number) => void` — Called when the measured container width changes, with the active breakpoint's column count. Mirrors react-grid-layout's `WidthProvider` `onWidthChange`. Not fired while width is unmeasured or when an explicit `width` is provided.
+- **`breakpoint`** `string` — Force a specific breakpoint regardless of width (e.g. for a fixed-size screenshot or PDF export).
+- **`width`** `number` — Explicit width; disables measurement (SSR/tests/forced-size exports).
+
+A breakpoint with no layout is synthesized from the nearest available one,
+corrected into bounds and compacted for the target column count.
+
+### Base Properties
+
+Supports [Base properties](../../BaseProperties.md).
+
+### Style Properties
+
+These properties allow direct style application without using the `styles` prop.
+Note: `margin` is repurposed as the grid gap (see Properties above) rather than a
+CSS margin.
+
+- **Base:** `display`, `font`, `preset`, `hide`, `whiteSpace`, `opacity`, `transition`
+- **Position:** `gridArea`, `order`, `gridColumn`, `gridRow`, `placeSelf`, `alignSelf`, `justifySelf`, `zIndex`, `margin`, `inset`, `position`, `scrollMargin`
+- **Dimension:** `width`, `height`, `flexBasis`, `flexGrow`, `flexShrink`, `flex`
+- **Block:** `border`, `radius`, `shadow`, `outline`, `padding`, `paddingInline`, `paddingBlock`, `overflow`, `scrollbar`, `textAlign`
+- **Color:** `color`, `fill`, `fade`, `image`
+- **Flow:** `flow`, `place`, `placeItems`, `placeContent`, `alignItems`, `alignContent`, `justifyItems`, `justifyContent`, `align`, `justify`, `gap`, `columnGap`, `rowGap`, `gridColumns`, `gridRows`, `gridTemplate`, `gridAreas`
+
+## Examples
+
+### Controlled layout
+
+### Free positioning
+
+A widget stays exactly where you drop it and never shuffles its neighbours.
+Dropping onto an occupied cell is blocked, so the widget stays at its last free
+spot.
+
+### Free positioning (overlap)
+
+Add `allowOverlap` to let widgets stack on top of each other instead of being
+blocked from occupied cells.
+
+### Horizontal compaction
+
+### Non-resizable
+
+### Min/max widget size
+
+Bound resizing with per-widget `minW`/`maxW` (columns) and `minH`/`maxH` (rows).
+
+### Grid lines
+
+Show grid lines behind the widgets while dragging or resizing (or always).
+
+### Card widgets
+
+Widgets are filled (`#surface-2`) and rounded by default, but borderless. Add a
+card border per widget with `isCard`, or for the whole board at once with
+`widgetProps={{ isCard: true }}`. Per-widget `isCard` overrides the board default.
+
+### Drag cancel
+
+Keep interactive controls inside a widget clickable by excluding them from the
+drag gesture with `dragCancel`.
+
+### Responsive
+
+`Board.Responsive` swaps the layout and column count per breakpoint.
+
+### Cross-board dragging
+
+Wrap boards in `Board.Provider` to drag widgets between them.
+
+### Nested boards
+
+A `Board` can be placed inside a `Board.Widget`, making the whole container
+draggable while its children can be dragged out into sibling boards.
+
+Set `isAligned` on the nested board to align it with the surrounding layout:
+every cell matches the parent's cell size exactly. Its columns keep the parent's
+pixel pitch (so resizing the container adds or removes columns instead of
+stretching them) and its rows use the parent's row height verbatim.
+
+Because an aligned board never shrinks its rows to fit, add `isAutoHeight` to the
+container `Board.Widget` so it grows (only ever taller) until the inner board's
+rows fit at the parent's row height. It also stops the container's resize handle
+at that height, so you can't drag it shorter than the inner board needs.
+
+### Aligned nested boards
+
+A nested `Board` with `isAligned` and no padding, fill, border, or radius of its
+own — only a header above the grid — inherits the parent column pitch with zero
+offset, so its columns line up exactly with the outer board. Grid lines are
+shown on both boards while dragging to verify the alignment.
+
+### Boards inside Tabs
+
+A `Board.Widget` can host a `Tabs` where each tab renders its own `Board`, all
+under a shared `Board.Provider` so widgets can be dragged between tabs and out
+into the surrounding board. Because an inactive tab unmounts, this example is
+fully controlled: each board's `layout` is controlled and `onWidgetTransfer`
+moves a widget's declaration into the destination container so its content
+survives dragging out of (and switching away from) a tab.
+
+When a `Tabs` sits inside a `Board`, tab switching becomes "spring-loaded"
+automatically: while you drag a widget, hovering a tab header for a moment opens
+that tab so you can drop into it (or move a widget between tabs). This needs no
+setup - `Tabs` detects the active Board drag and, for its duration, keeps panels
+mounted so the tab a widget is dragged out of (and the board owning the in-flight
+drag) is not unmounted mid-gesture. Spring-loading works with mouse and pen;
+touch drags capture the pointer, so they do not trigger it.
+
+## Accessibility
+
+- Widgets are focusable when draggable. Press <kbd>Tab</kbd> to focus a widget,
+  then use the arrow keys to move it one cell at a time.
+- Dragging, resizing, and keyboard movement are all handled by React Aria's
+  `useMove`, which normalizes mouse, touch, and keyboard interactions.
+
+## Not yet supported
+
+- **External drag-in from a palette** — dragging a brand-new widget from an
+  element outside any board into the grid (react-grid-layout's
+  `isDroppable`/`onDrop`/`droppingItem`) is not implemented. Board's drag engine
+  is built entirely on React Aria's `useMove` over registered widgets; drag-in
+  is a separate HTML5 drag-and-drop modality (pixel-to-grid mapping, a dropping
+  placeholder, and new `onDrop`/`droppingItem` props). Add widgets
+  programmatically (render a new `Board.Widget` and add its layout item), or drag
+  between boards with `Board.Provider`.
+
+## Attribution
+
+The layout engine in `grid-core/` is a vendored, trimmed copy of
+[react-grid-layout](https://github.com/react-grid-layout/react-grid-layout)
+(MIT). The React layer is a UI Kit-native reimplementation on top of tasty and
+React Aria. See `grid-core/NOTICE.md`.

package/docs/components/navigation/Tabs.md

@@ -131,8 +131,12 @@ DOM order is always "bar then panels" — visual order is controlled internally
 
 ```jsx
 <Tabs placement="left" defaultActiveKey="overview">
-  <Tab key="overview" title="Overview">Overview content</Tab>
-  <Tab key="settings" title="Settings">Settings content</Tab>
+  <Tab key="overview" title="Overview">
+    Overview content
+  </Tab>
+  <Tab key="settings" title="Settings">
+    Settings content
+  </Tab>
 </Tabs>
 ```
 
@@ -827,6 +831,18 @@ Tabs work seamlessly inside Layout components. When placed in a `Layout` or `Lay
 - Tab panels use `display: contents`, allowing children to participate in parent flex layout
 - Nested Layout components with `flexGrow: 1` (default) stretch to fill remaining space
 
+### Inside a Board (spring-loaded switching)
+
+When `Tabs` is rendered inside a [`Board`](../layout/Board.md), tab
+switching becomes spring-loaded automatically: while a Board widget is being
+dragged, hovering a tab header for a moment opens that tab, so a widget can be
+dropped into it or moved between tabs. This requires no configuration - `Tabs`
+detects the active Board drag and, for its duration, keeps panels mounted so the
+tab a widget is dragged out of (and the board owning the in-flight gesture) is
+not unmounted mid-drag. Spring-loading works with mouse and pen; touch drags
+capture the pointer and do not trigger it. Outside a `Board` this behavior is
+inert.
+
 ## Accessibility
 
 ### Keyboard Navigation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.143.1",
+  "version": "0.145.0",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {
@@ -91,7 +91,7 @@
     "@testing-library/user-event": "14.6.1",
     "@types/babel__core": "^7.20.5",
     "@types/babel__helper-plugin-utils": "^7.10.3",
-    "@types/node": "^22.17.2",
+    "@types/node": "^24.0.0",
     "@types/react": "^19.1.10",
     "@types/react-dom": "^19.1.7",
     "@types/react-is": "^18.2.4",
@@ -106,7 +106,7 @@
     "dedent": "^0.7.0",
     "husky": "^6.0.0",
     "jsdom": "^29.1.1",
-    "lint-staged": "^10.0.0",
+    "lint-staged": "^17.0.8",
     "markdown-table": "^3.0.3",
     "npm-run-all": "^4.1.5",
     "oxlint": "^1.72.0",
@@ -133,7 +133,7 @@
   ],
   "license": "MIT",
   "engines": {
-    "node": ">=22.14.0",
+    "node": ">=24.0.0",
     "pnpm": "^10.0.0"
   },
   "scripts": {