@cube-dev/ui-kit 0.0.0-canary-73fed1d → 0.0.0-canary-ea72271

package/dist/version.js

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

package/docs/components/layout/Board.md

@@ -50,6 +50,7 @@ clipped by an ancestor's `overflow: hidden`.
 - **`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.
+- **`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, 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 inherits the parent's row height as a target, shrinking rows slightly when needed to fit the height the container widget grants it. `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).
 - **`place`** `Styles['place']` — Style prop shorthand for `place-items`/`place-content`.
@@ -64,12 +65,24 @@ clipped by an ancestor's `overflow: hidden`.
 - **`constraints`** `LayoutConstraint[]` — Per-widget constraints.
 - **`qa`** `string` — Test id for the rendered widget element.
 - **`styles`** `Styles` — Style overrides for the rendered widget element.
+- **`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.
 
 ### 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.
+
 ### Base Properties
 
 Supports [Base properties](../../BaseProperties.md).
@@ -106,11 +119,25 @@ Wrap boards in `Board.Provider` to drag widgets between them.
 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: its
+columns keep the parent's pixel pitch (so resizing the container adds or removes
+columns instead of stretching them), and its rows inherit the parent's row
+height, shrinking slightly when needed to fit the space the container widget
+gives it.
+
+Add `isAutoHeight` to the container `Board.Widget` to grow it (only ever taller)
+until the inner board's rows fit at the parent's row height, so an aligned board
+never has to squeeze its rows. It also stops the container's resize handle at
+that height, so you can't drag it shorter than the inner board needs.
+
 ### 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.
+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.
 
 ## Accessibility
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cube-dev/ui-kit",
-  "version": "0.0.0-canary-73fed1d",
+  "version": "0.0.0-canary-ea72271",
   "type": "module",
   "description": "UIKit for Cube Projects",
   "repository": {