@cube-dev/ui-kit 0.0.0-canary-ccfec10 → 0.0.0-canary-161c235

package/dist/tokens/colors.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 import { getPaletteVersion } from "./palette-config.js";
 import { BASE_TOKENS } from "./base.js";
 import { lazyStyles } from "./lazy-styles.js";

package/dist/tokens/index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 import { colorSeed } from "./color-seed.js";
 import { DEFAULT_PALETTE_CONFIG, MAX_BASE_SATURATION, getPaletteConfig, getPaletteConfigInput, getPaletteVersion, invalidatePaletteTokens, resetPaletteConfig, resolvePaletteConfig, setPaletteConfig, subscribePaletteConfig, usePaletteConfig, usePaletteVersion } from "./palette-config.js";
 import { BASE_TOKENS } from "./base.js";

package/dist/tokens/layout.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/tokens/layout.ts
 /**
 * Layout-related tokens for common UI dimensions.

package/dist/tokens/lazy-styles.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/tokens/lazy-styles.ts
 /**
 * Proxy that defers to `factory()` on every property / enumeration access.

package/dist/tokens/palette-config.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 import { colorSeed } from "./color-seed.js";
 import { useSyncExternalStore } from "react";
 

package/dist/tokens/palette.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 import { SURFACE_SATURATION_SHARE, getPaletteConfig, getPaletteVersion, resolvePaletteConfig } from "./palette-config.js";
 import { lazyStyles } from "./lazy-styles.js";
 import { apcaContrast, glaze, okhslToLinearSrgb, variantToOkhsl } from "@tenphi/glaze";

package/dist/tokens/shadows.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/tokens/shadows.ts
 /**
 * Shadow tokens using tasty shorthand syntax.

package/dist/tokens/sizes.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/tokens/sizes.ts
 /**
 * Component size values in pixels.

package/dist/tokens/spacing.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/tokens/spacing.ts
 /**
 * Spacing tokens using tasty multiplier syntax.

package/dist/tokens/typography.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/tokens/typography.ts
 /**
 * Typography presets for headings, text, and special styles.

package/dist/utils/ResizeSensor.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/utils/ResizeSensor.ts
 /**
 * Iterate over each of the provided element(s).

package/dist/utils/is-dev-env.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/utils/is-dev-env.ts
 function isDevEnv() {
 	if (typeof window !== "undefined" && window.localStorage) try {

package/dist/utils/modules.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/utils/modules.ts
 function extractModule(promise) {
 	return promise.then((module) => module.default || module);

package/dist/utils/promise.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/utils/promise.ts
 function timeout(ms = 30) {
 	return new Promise((resolve) => {

package/dist/utils/raf.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/utils/raf.ts
 /**
 * Chains N requestAnimationFrame calls and returns a cancel function.

package/dist/utils/random.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/utils/random.ts
 function random(min, max) {
 	const realMin = min < max ? min : max;

package/dist/utils/range.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/utils/range.ts
 function range(count) {
 	return Array.from({ length: count }, (_, i) => i);

package/dist/utils/react/RenderCache.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 import { useRef } from "react";
 import { Fragment as Fragment$1, jsx } from "react/jsx-runtime";
 

package/dist/utils/react/Slots.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 import { mergeProps } from "./mergeProps.js";
 import { Children, cloneElement, createContext, useContext, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/utils/react/chain.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/utils/react/chain.ts
 /**
 * Calls all functions in the order they were chained with the same arguments.

package/dist/utils/react/disabledProps.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/utils/react/disabledProps.ts
 /**
 * Tags where `disabled` is a real HTML attribute. Browsers refuse to dispatch

package/dist/utils/react/forwardRefWithGenerics.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/utils/react/forwardRefWithGenerics.tsx
 /**
 * A helper for creating forwardRef components with generic types.

package/dist/utils/react/index.js

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

package/dist/utils/react/useBufferedValue.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | 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.0.0-canary-ccfec10 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.0.0-canary-161c235 | Cube Dev Team */
 //#region src/version.ts
-const VERSION = "0.0.0-canary-ccfec10";
+const VERSION = "0.0.0-canary-161c235";
 const TASTY_VERSION = "3.0.2";
 if (typeof window !== "undefined") {
 	const version = VERSION;

package/docs/Usage.md

@@ -402,6 +402,24 @@ tokens (`#loading-face-1` … `#loading-face-3`) rather than a `currentColor`
 glyph, so it ignores `color` and belongs at illustration sizes (`size="8x"` and
 up).
 
+## Hierarchical Table Rows
+
+`ItemTable` and `DataTable` opt into native treegrid behavior with
+`getRowChildren`. Pass roots in `data`; the callback returns already-loaded
+children, and row keys must be globally unique. Expansion is uncontrolled with
+`defaultExpandedKeys` or controlled with `expandedKeys` / `onExpand`.
+
+The shared table engine recursively sorts siblings, paginates roots with their
+complete subtrees, and flattens only expanded rows for rendering and
+virtualization. ItemTable client search preserves ancestor paths and temporarily
+opens branches containing matches. Server modes do not transform nested data.
+
+Use `treeColumnKey` to choose the disclosure/indent column. Its hierarchy chrome
+is customizable through the `TreeContent`, `TreeToggle`, and `TreeValue`
+sub-elements. ItemTable multiple selection cascades by default; DataTable cell
+ranges contain visible rows only. See each component's docs for pagination,
+numbering, selection, and drag/drop limits.
+
 ## Form System
 
 ### Form Component

package/docs/components/data/DataTable.md

@@ -44,6 +44,15 @@ and everything it knows about the query, in Cloud.
 - **`columns`** `CubeDataTableColumn<T>[]` — Same shape as `ItemTable`'s, plus `dataType`.
 - **`rowKey`** `string` (default: `'id'`) — Property to read the row identity from.
 - **`getRowKey`** `(row: T, index: number) => Key` — Wins over `rowKey`.
+- **`getRowChildren`** `(row: T) => readonly T[] | undefined` — Enables nested
+  treegrid rows; `data` contains roots.
+- **`treeColumnKey`** `string` — Indented disclosure column. Defaults to the
+  first visible data column.
+- **`expandedKeys`** `Key[]` — Controlled expansion.
+- **`defaultExpandedKeys`** `Key[]` — Initial expansion. Nothing is expanded by
+  default.
+- **`onExpand`** `(keys, info) => void` — Reports the resulting keys and toggled
+  row metadata.
 - **`pinnedTopRows`** `readonly T[]` — Rows stuck to the top of the scroller. Ordinary rows as far as the columns are concerned.
 - **`pinnedBottomRows`** `readonly T[]` — The same, at the bottom. This is where totals go.
 
@@ -136,6 +145,9 @@ see [Column Colors](#column-colors) for the last two.
 - **`getRowProps`** `(ctx: CubeTableRowContext<T>) => Record<string, any>` — Per-row mods, styles and height.
 - **`storageKey`** `string` — Persists page size, column widths and column order.
 - **`ariaLabel`** `string`
+- **`isChecked`** `boolean` — Base checked-state modifier.
+- **`place`** `string` — Tasty placement shorthand on the root frame.
+- **`scrollMargin`** `string | number` — Scroll margin on the root frame.
 
 #### `dataType`
 
@@ -204,6 +216,37 @@ body into a scroller, pins the header, and lets virtualization engage at all.
 Cell-level, in addition to `ItemTable`'s: `cell-selected`, `last-column`,
 `pinned`.
 
+## Tree Rows
+
+Tree mode uses the same nested-data contract as `ItemTable`:
+
+```jsx
+<DataTable
+  data={regions}
+  columns={columns}
+  getRowChildren={(row) => row.children}
+  treeColumnKey="region"
+  defaultExpandedKeys={['americas']}
+/>
+```
+
+Multi-sort is recursive: every sibling collection is sorted by the same
+precedence. Client pagination slices roots and keeps complete subtrees together;
+server pages are rendered exactly as supplied and `total` counts roots. Pinned
+rows remain ordinary non-hierarchical totals.
+
+Only visible descendants participate in cell ranges and virtualization.
+Collapsing a range endpoint makes the effective range inactive; a controlled or
+uncontrolled range is restored when that endpoint becomes visible again. Client
+row numbers remain continuous across root pages, while server tree pages restart
+at 1 because preceding descendant counts are unknown.
+
+The native table exposes `role="treegrid"`, `aria-level`, `aria-expanded`,
+`aria-posinset` and `aria-setsize`. Right/Left expand, collapse or move to the
+parent; Up/Down traverse visible rows, and typeahead reads `treeColumnKey`.
+Customize the hierarchy chrome with `styles.TreeContent`, `styles.TreeToggle`
+and `styles.TreeValue`.
+
 ## Examples
 
 ### Multi-Column Sorting

package/docs/components/data/ItemTable.md

@@ -31,6 +31,14 @@ pivots, totals. Use `ListBox` when there is only one column.
 - **`columns`** `CubeItemTableColumn<T>[]` — Column definitions. See below.
 - **`rowKey`** `string` (default: `'id'`) — Property used as the row key.
 - **`getRowKey`** `(row: T, index: number) => Key` — Wins over `rowKey`.
+- **`getRowChildren`** `(row: T) => readonly T[] | undefined` — Enables tree
+  mode. `data` then contains top-level rows and children are read recursively.
+- **`treeColumnKey`** `string` — Column containing indentation and the
+  disclosure control. Defaults to the first visible data column.
+- **`expandedKeys`** `Key[]` — Controlled expanded rows.
+- **`defaultExpandedKeys`** `Key[]` — Initially expanded rows. Defaults to none.
+- **`onExpand`** `(keys, info) => void` — Reports the complete expanded-key list
+  and the toggled row, key, zero-based level, parent key and resulting state.
 - **`isLoading`** `boolean` (default: `false`) — Marks a fetch in flight. What
   the user sees depends on `loadingIndicator`.
 - **`loadingIndicator`** `'overlay' | 'skeleton' | 'none'` (default: `'overlay'`)
@@ -117,6 +125,10 @@ pivots, totals. Use `ListBox` when there is only one column.
 - **`selectionTooltip`** `string | ((row: T) => string | undefined)` — Explains
   an inert checkbox.
 - **`disabledKeys`** `Key[]` — Rows that cannot be interacted with at all.
+- **`treeSelectionBehavior`** `'cascade' | 'independent'` (default: `'cascade'`
+  in tree mode) — Multiple selection only. Cascade selects eligible descendants
+  and derives checked or indeterminate ancestors; single selection is always
+  independent.
 - **`rowLink`** `(row: T, index: number) => NavigateArg | undefined` — Turns the
   row-header cell into a stretched link covering the whole row. Return
   `undefined` for a row that should not navigate.
@@ -207,6 +219,9 @@ pivots, totals. Use `ListBox` when there is only one column.
 - **`getRowProps`** `(ctx) => { isDimmed?, mods?, styles?, height?, qa?, tooltip? }`
   — Per-row visuals.
 - **`ariaLabel`** `string` — Labels the grid.
+- **`isChecked`** `boolean` — Base checked-state modifier.
+- **`place`** `string` — Tasty placement shorthand on the root frame.
+- **`scrollMargin`** `string | number` — Scroll margin on the root frame.
 
 #### `CubeItemTableColumn<T>`
 
@@ -291,6 +306,8 @@ reachable from this one prop — that is the whole styling contract.
 - `Table` — the `<table>`
 - `Head`, `HeadRow`, `HeaderCell` — the column header
 - `Body`, `Row`, `Cell` — the data rows
+- `TreeContent`, `TreeToggle`, `TreeValue` — indentation, disclosure/leaf
+  placeholder, and the consumer-rendered value in the tree column
 - `SortIndicator` — the sort arrow, inside the header `Item`'s suffix
 - `Foot`, `FootRow`, `FootCell` — pinned totals
 - `StateContent` — the empty / no-results / error content
@@ -390,6 +407,39 @@ Row-level modifiers, set on each `<tr>`: `odd`, `selected`, `focused`, `dimmed`,
 />
 ```
 
+### Tree Rows
+
+Supplying `getRowChildren` changes the root to `role="treegrid"`. Rows keep their
+original objects; keys must be unique across the complete hierarchy.
+
+```jsx
+<ItemTable
+  data={folders}
+  columns={columns}
+  getRowChildren={(row) => row.children}
+  treeColumnKey="name"
+  defaultExpandedKeys={['production']}
+  selectionMode="multiple"
+/>
+```
+
+Client sorting runs independently within every sibling collection. Client
+search retains ancestor paths; a matching parent keeps its complete subtree,
+and required branches open temporarily without changing `expandedKeys`. Client
+pagination counts and slices roots, keeping each subtree on its parent's page.
+Server modes treat the supplied nested page as already processed, and `total`
+counts roots.
+
+The chevron and Right/Left arrows expand or collapse. Up/Down traverse visible
+rows, typeahead uses the tree column, and Left on a collapsed child moves to its
+parent. Ordinary row clicks still activate `onRowAction`/`rowLink`; the
+disclosure does not. Select-all includes collapsed descendants. Disabled and
+unselectable descendants are excluded from cascade.
+
+Tree mode ignores `isReorderable`, because a flat reordered array cannot encode
+parents. `dropOnRow` remains available for folder moves; self/descendant cycles
+are rejected and selected descendants are collapsed under a dragged ancestor.
+
 ### Custom Cells
 
 ```jsx

package/package.json

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