@cube-dev/ui-kit 0.131.0 → 0.132.0

package/dist/components/content/Tree/TreeNode.js

@@ -1,12 +1,17 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { mergeRefs } from "../../../utils/react/useCombinedRefs.js";
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { LoadingIcon } from "../../../icons/LoadingIcon.js";
+import { ItemAction } from "../../actions/ItemAction/ItemAction.js";
 import { DirectionIcon } from "../../../icons/DirectionIcon.js";
+import { MoreIcon } from "../../../icons/MoreIcon.js";
+import { _MenuTrigger } from "../../actions/Menu/MenuTrigger.js";
+import { __Menu } from "../../actions/Menu/Menu.js";
+import { useContextMenu } from "../../actions/use-context-menu.js";
 import { TreeNodeCheckboxWrapper, TreeNodeRow, TreeNodeToggle, TreeNodeTogglePlaceholder, TreeRowItem } from "./styled.js";
 import { __Checkbox } from "../../fields/Checkbox/Checkbox.js";
-import { memo, useMemo, useRef } from "react";
+import { Children, memo, useMemo, useRef, useState } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { useHover, useTreeItem } from "react-aria";
 
@@ -14,10 +19,52 @@ import { useHover, useTreeItem } from "react-aria";
 const stopPropagation = (e) => {
 	e.stopPropagation();
 };
+/**
+* CSS selector matching focusable / activatable descendants that
+* should "absorb" a click so the parent row does not also react to
+* it. Used by the `expandOnFolderClick` row click / pointer guards.
+*
+* Covers the standard interactive elements (`button`, `a`, form
+* controls), explicit ARIA roles (`button`, `menuitem`, `checkbox`,
+* `link`, `tab`, `option`, etc.), and react-aria's pressable marker.
+*/
+const INTERACTIVE_DESCENDANT_SELECTOR = [
+	"button",
+	"a[href]",
+	"input",
+	"textarea",
+	"select",
+	"[role=\"button\"]",
+	"[role=\"menuitem\"]",
+	"[role=\"menuitemcheckbox\"]",
+	"[role=\"menuitemradio\"]",
+	"[role=\"checkbox\"]",
+	"[role=\"radio\"]",
+	"[role=\"link\"]",
+	"[role=\"tab\"]",
+	"[role=\"option\"]",
+	"[role=\"switch\"]",
+	"[data-react-aria-pressable]"
+].join(",");
+/**
+* Returns `true` when `target` is (or is contained within) an
+* interactive element that lives BETWEEN `target` and `currentTarget`
+* — i.e. something the user clearly intended to click instead of the
+* row itself.
+*/
+function isInteractiveDescendant(target, currentTarget) {
+	if (!(target instanceof Element) || !(currentTarget instanceof Element)) return false;
+	const interactive = target.closest(INTERACTIVE_DESCENDANT_SELECTOR);
+	return !!interactive && interactive !== currentTarget && currentTarget.contains(interactive);
+}
+/** Check whether a `menu` ReactNode actually contains anything. */
+function isMenuEmpty(menu) {
+	if (menu === null || menu === void 0 || menu === false) return true;
+	return Children.toArray(menu).length === 0;
+}
 function TreeNodeInner(props) {
-	const { node, data, state, isCheckable, isExpanded, isIndeterminate, isChecked, isLoading, onToggleChecked, size, itemProps, rowStyles, virtualStyle, virtualRef, virtualIndex } = props;
+	const { node, data, state, isCheckable, isExpanded, isIndeterminate, isChecked, isLoading, onToggleChecked, size, itemProps, rowStyles, virtualStyle, virtualRef, virtualIndex, menu: treeMenu, contextMenu: treeContextMenu, onAction: treeOnAction, menuTriggerProps, menuProps, expandOnFolderClick } = props;
 	const rowRef = useRef(null);
-	const combinedRef = useMemo(() => virtualRef ? mergeRefs(rowRef, virtualRef) : rowRef, [virtualRef]);
 	const { rowProps, gridCellProps, expandButtonProps, isPressed } = useTreeItem({ node }, state, rowRef);
 	const isDisabled = state.disabledKeys.has(node.key);
 	const isSelected = state.selectionManager.isSelected(node.key);
@@ -25,14 +72,75 @@ function TreeNodeInner(props) {
 	const isFocused = state.selectionManager.isFocused && state.selectionManager.focusedKey === node.key;
 	const isLeaf = data.isLeaf === true || data.isLeaf !== false && !node.hasChildNodes;
 	const isRowCheckable = isCheckable && data.isCheckable !== false;
+	const nodeState = {
+		isExpanded,
+		isSelected,
+		isChecked,
+		isIndeterminate,
+		isLeaf
+	};
+	const effectiveMenuChildren = data.menu === null ? null : data.menu !== void 0 ? data.menu : typeof treeMenu === "function" ? treeMenu(data, nodeState) : treeMenu ?? null;
+	const hasMenu = !isMenuEmpty(effectiveMenuChildren);
+	const effectiveContextMenu = data.contextMenu ?? treeContextMenu ?? false;
+	const menuExposed = hasMenu && (effectiveContextMenu === true || effectiveContextMenu === "context-only");
+	const contextMenuOnly = effectiveContextMenu === "context-only";
+	const [isMenuOpen, setIsMenuOpen] = useState(false);
+	const handleMenuAction = useEvent((action) => {
+		const actionStr = String(action);
+		const normalizedAction = actionStr.startsWith(".$") ? actionStr.slice(2) : actionStr;
+		data.onAction?.(normalizedAction);
+		treeOnAction?.(normalizedAction, node.key);
+		menuProps?.onAction?.(normalizedAction);
+	});
+	const rowContextMenu = useContextMenu(__Menu, { placement: "bottom start" }, {
+		...menuProps,
+		onAction: handleMenuAction,
+		children: effectiveMenuChildren
+	});
 	const handleCheckboxChange = useEvent(() => {
 		onToggleChecked(String(node.key));
 	});
+	const shouldExpandOnRowClick = !!expandOnFolderClick && !isLeaf && !isDisabled;
+	const handleFolderRowClick = useEvent((e) => {
+		if (e.button !== 0) return;
+		if (isInteractiveDescendant(e.target, e.currentTarget)) return;
+		e.preventDefault();
+		e.stopPropagation();
+		state.toggleKey(node.key);
+		state.selectionManager.setFocused(true);
+		state.selectionManager.setFocusedKey(node.key);
+	});
+	const handleFolderRowPointerEvent = useEvent((e) => {
+		if (e.button !== 0) return;
+		if (isInteractiveDescendant(e.target, e.currentTarget)) return;
+		e.stopPropagation();
+	});
 	const handleKeyDown = useEvent((e) => {
 		if (e.key === " " && isRowCheckable && !isDisabled && !data.isCheckboxDisabled) {
 			e.preventDefault();
 			onToggleChecked(String(node.key));
+			return false;
+		}
+		if (e.key === "F10" && e.shiftKey && menuExposed) {
+			e.preventDefault();
+			e.stopPropagation();
+			if (contextMenuOnly) rowContextMenu.open();
+			else setIsMenuOpen(true);
+			return true;
 		}
+		if (shouldExpandOnRowClick && (e.key === "Enter" || e.key === " " && !isRowCheckable)) {
+			e.preventDefault();
+			e.stopPropagation();
+			state.toggleKey(node.key);
+			state.selectionManager.setFocused(true);
+			state.selectionManager.setFocusedKey(node.key);
+			return true;
+		}
+		return false;
+	});
+	const composedKeyDown = useEvent((e) => {
+		if (handleKeyDown(e)) return;
+		rowProps.onKeyDown?.(e);
 	});
 	const sharedMods = useMemo(() => ({
 		checked: isChecked,
@@ -40,14 +148,16 @@ function TreeNodeInner(props) {
 		expanded: isExpanded,
 		loading: isLoading,
 		leaf: isLeaf,
-		"has-checkbox": isRowCheckable
+		"has-checkbox": isRowCheckable,
+		"has-menu": menuExposed
 	}), [
 		isChecked,
 		isIndeterminate,
 		isExpanded,
 		isLoading,
 		isLeaf,
-		isRowCheckable
+		isRowCheckable,
+		menuExposed
 	]);
 	const rowMods = useMemo(() => ({
 		...sharedMods,
@@ -69,10 +179,19 @@ function TreeNodeInner(props) {
 		...virtualStyle
 	}), [node.level, virtualStyle]);
 	const ariaChecked = isRowCheckable ? isIndeterminate ? "mixed" : isChecked ? "true" : "false" : void 0;
-	const finalRowProps = mergeProps$1(rowProps, hoverProps, {
+	const baseRowProps = {
+		...mergeProps$1(rowProps, hoverProps),
 		"aria-checked": ariaChecked,
-		onKeyDown: handleKeyDown
-	});
+		onKeyDown: composedKeyDown
+	};
+	const finalRowProps = shouldExpandOnRowClick ? {
+		...baseRowProps,
+		onClick: handleFolderRowClick,
+		onPointerDown: handleFolderRowPointerEvent,
+		onPointerUp: handleFolderRowPointerEvent,
+		onMouseDown: handleFolderRowPointerEvent,
+		onMouseUp: handleFolderRowPointerEvent
+	} : baseRowProps;
 	const toggleNode = isLeaf ? /* @__PURE__ */ jsx(TreeNodeTogglePlaceholder, {
 		"aria-hidden": true,
 		"data-element": "Toggle"
@@ -95,23 +214,42 @@ function TreeNodeInner(props) {
 			onChange: handleCheckboxChange
 		})
 	}) : null;
-	const { prefix: userPrefix, ...restUserProps } = (typeof itemProps === "function" ? itemProps(data, {
-		isExpanded,
-		isSelected,
-		isChecked,
-		isIndeterminate,
-		isLeaf
-	}) : itemProps) ?? {};
+	const { prefix: userPrefix, actions: userActions, ...restUserProps } = (typeof itemProps === "function" ? itemProps(data, nodeState) : itemProps) ?? {};
 	const composedPrefix = checkboxNode || userPrefix ? /* @__PURE__ */ jsxs(Fragment$1, { children: [checkboxNode, userPrefix] }) : null;
-	return /* @__PURE__ */ jsx(TreeNodeRow, {
+	const menuAction = menuExposed && !contextMenuOnly ? /* @__PURE__ */ jsxs(_MenuTrigger, {
+		isOpen: isMenuOpen,
+		onOpenChange: setIsMenuOpen,
+		children: [/* @__PURE__ */ jsx(ItemAction, {
+			tabIndex: -1,
+			icon: /* @__PURE__ */ jsx(MoreIcon, {}),
+			"aria-label": "Actions",
+			...menuTriggerProps
+		}), /* @__PURE__ */ jsx(__Menu, {
+			...menuProps,
+			onAction: handleMenuAction,
+			children: effectiveMenuChildren
+		})]
+	}) : null;
+	const composedActions = userActions || menuAction ? /* @__PURE__ */ jsxs(Fragment$1, { children: [userActions, menuAction] }) : void 0;
+	const refs = useMemo(() => {
+		const list = [rowRef];
+		if (virtualRef) list.push(virtualRef);
+		if (menuExposed) list.push(rowContextMenu.targetRef);
+		return mergeRefs(...list);
+	}, [
+		virtualRef,
+		menuExposed,
+		rowContextMenu.targetRef
+	]);
+	return /* @__PURE__ */ jsxs(TreeNodeRow, {
 		...finalRowProps,
-		ref: combinedRef,
+		ref: refs,
 		mods: rowMods,
 		style: rowStyle,
 		"data-element": "Row",
 		"data-qa-key": String(node.key),
 		"data-index": virtualIndex,
-		children: /* @__PURE__ */ jsx(TreeRowItem, {
+		children: [/* @__PURE__ */ jsx(TreeRowItem, {
 			...gridCellProps,
 			...restUserProps,
 			size,
@@ -120,9 +258,10 @@ function TreeNodeInner(props) {
 			mods: itemMods,
 			icon: toggleNode,
 			prefix: composedPrefix,
+			actions: composedActions,
 			styles: rowStyles,
 			children: data.title
-		})
+		}), menuExposed && rowContextMenu.rendered]
 	});
 }
 const TreeNode = memo(TreeNodeInner);

package/dist/components/content/Tree/TreeNode.js.map

@@ -1 +1 @@
-{"version":3,"file":"TreeNode.js","names":["mergeProps","Checkbox"],"sources":["../../../../src/components/content/Tree/TreeNode.tsx"],"sourcesContent":["import { memo, useMemo, useRef } from 'react';\nimport { useHover, useTreeItem } from 'react-aria';\n\nimport { useEvent } from '../../../_internal/hooks';\nimport { DirectionIcon, LoadingIcon } from '../../../icons';\nimport { mergeProps, mergeRefs } from '../../../utils/react';\nimport { Checkbox } from '../../fields/Checkbox/Checkbox';\n\nimport {\n  TreeNodeCheckboxWrapper,\n  TreeNodeRow,\n  TreeNodeToggle,\n  TreeNodeTogglePlaceholder,\n  TreeRowItem,\n} from './styled';\n\nimport type { Node } from '@react-types/shared';\nimport type { Styles } from '@tenphi/tasty';\nimport type { CSSProperties, KeyboardEvent, SyntheticEvent } from 'react';\nimport type { TreeState } from 'react-stately';\nimport type { CubeTreeNodeData, TreeItemProps, TreeNodeState } from './types';\n\nconst stopPropagation = (e: SyntheticEvent) => {\n  e.stopPropagation();\n};\n\nexport interface TreeNodeProps {\n  node: Node<CubeTreeNodeData>;\n  /** The original `CubeTreeNodeData` for this row, looked up by key. */\n  data: CubeTreeNodeData;\n  state: TreeState<CubeTreeNodeData>;\n\n  /** Whether the tree as a whole renders checkboxes. */\n  isCheckable: boolean;\n  /** Whether this row is currently expanded. */\n  isExpanded: boolean;\n  /** Whether the row is in an indeterminate (half-checked) state. */\n  isIndeterminate: boolean;\n  /** Whether the row is fully checked. */\n  isChecked: boolean;\n  /** Whether `loadData` is currently fetching this row's children. */\n  isLoading: boolean;\n\n  /** Toggle this row's checkbox (cascades). */\n  onToggleChecked: (key: string) => void;\n\n  /** Row size passed to the underlying Item. */\n  size?: string;\n\n  /** Per-node Item customization (static object or callback). */\n  itemProps?:\n    | TreeItemProps\n    | ((data: CubeTreeNodeData, state: TreeNodeState) => TreeItemProps);\n\n  /** Styles applied to the visible row (`TreeRowItem`). */\n  rowStyles?: Styles;\n\n  /** Inline style for virtualizer absolute positioning. */\n  virtualStyle?: CSSProperties;\n  /** Ref callback from `@tanstack/react-virtual` to measure row height. */\n  virtualRef?: (element: HTMLElement | null) => void;\n  /** Virtual index for `data-index` attribute. */\n  virtualIndex?: number;\n}\n\nfunction TreeNodeInner(props: TreeNodeProps) {\n  const {\n    node,\n    data,\n    state,\n    isCheckable,\n    isExpanded,\n    isIndeterminate,\n    isChecked,\n    isLoading,\n    onToggleChecked,\n    size,\n    itemProps,\n    rowStyles,\n    virtualStyle,\n    virtualRef,\n    virtualIndex,\n  } = props;\n\n  const rowRef = useRef<HTMLDivElement>(null);\n  const combinedRef = useMemo(\n    () => (virtualRef ? mergeRefs(rowRef, virtualRef) : rowRef),\n    [virtualRef],\n  );\n\n  const { rowProps, gridCellProps, expandButtonProps, isPressed } = useTreeItem(\n    { node },\n    state,\n    rowRef,\n  );\n\n  const isDisabled = state.disabledKeys.has(node.key);\n  const isSelected = state.selectionManager.isSelected(node.key);\n\n  // `useTreeItem` doesn't track hover; we need it for the `hovered` mod.\n  const { hoverProps, isHovered } = useHover({ isDisabled });\n  // React Aria's treegrid uses roving tabindex, so no `data-focused`\n  // attribute lands on the row — mirror it as a mod manually.\n  const isFocused =\n    state.selectionManager.isFocused &&\n    state.selectionManager.focusedKey === node.key;\n  // For lazy rows with no children yet, still render a toggle unless\n  // explicitly marked as leaf.\n  const isLeaf =\n    data.isLeaf === true || (data.isLeaf !== false && !node.hasChildNodes);\n  const isRowCheckable = isCheckable && data.isCheckable !== false;\n\n  const handleCheckboxChange = useEvent(() => {\n    onToggleChecked(String(node.key));\n  });\n\n  const handleKeyDown = useEvent((e: KeyboardEvent) => {\n    if (\n      e.key === ' ' &&\n      isRowCheckable &&\n      !isDisabled &&\n      !data.isCheckboxDisabled\n    ) {\n      e.preventDefault();\n      onToggleChecked(String(node.key));\n    }\n  });\n\n  const sharedMods = useMemo(\n    () => ({\n      checked: isChecked,\n      indeterminate: isIndeterminate,\n      expanded: isExpanded,\n      loading: isLoading,\n      leaf: isLeaf,\n      'has-checkbox': isRowCheckable,\n    }),\n    [isChecked, isIndeterminate, isExpanded, isLoading, isLeaf, isRowCheckable],\n  );\n\n  const rowMods = useMemo(\n    () => ({ ...sharedMods, disabled: isDisabled }),\n    [sharedMods, isDisabled],\n  );\n\n  const itemMods = useMemo(\n    () => ({\n      ...sharedMods,\n      focused: isFocused,\n      hovered: isHovered,\n      pressed: isPressed,\n    }),\n    [sharedMods, isFocused, isHovered, isPressed],\n  );\n\n  const rowStyle = useMemo<CSSProperties>(\n    () => ({\n      ['--tree-level' as keyof CSSProperties]: String(node.level ?? 0),\n      ...virtualStyle,\n    }),\n    [node.level, virtualStyle],\n  );\n\n  // Only emit `aria-checked` when the tree is in checkable mode.\n  const ariaChecked: 'mixed' | 'true' | 'false' | undefined = isRowCheckable\n    ? isIndeterminate\n      ? 'mixed'\n      : isChecked\n        ? 'true'\n        : 'false'\n    : undefined;\n\n  const finalRowProps = mergeProps(rowProps, hoverProps, {\n    'aria-checked': ariaChecked,\n    onKeyDown: handleKeyDown,\n  });\n\n  // Leaf rows get a placeholder so sibling indents align.\n  const toggleNode = isLeaf ? (\n    <TreeNodeTogglePlaceholder aria-hidden data-element=\"Toggle\" />\n  ) : (\n    <TreeNodeToggle {...expandButtonProps} tabIndex={-1} data-element=\"Toggle\">\n      {isLoading ? (\n        <LoadingIcon />\n      ) : (\n        <DirectionIcon to={isExpanded ? 'bottom' : 'right'} />\n      )}\n    </TreeNodeToggle>\n  );\n\n  const checkboxNode = isRowCheckable ? (\n    <TreeNodeCheckboxWrapper\n      data-element=\"Checkbox\"\n      role=\"presentation\"\n      onClick={stopPropagation}\n      onKeyDown={stopPropagation}\n    >\n      <Checkbox\n        isSelected={isChecked}\n        isIndeterminate={isIndeterminate}\n        isDisabled={isDisabled || data.isCheckboxDisabled}\n        aria-label={\n          typeof data.title === 'string' ? data.title : String(node.key)\n        }\n        // @ts-expect-error AriaCheckboxProps loses `onChange` where InputDOMProps overlaps (react-types).\n        onChange={handleCheckboxChange}\n      />\n    </TreeNodeCheckboxWrapper>\n  ) : null;\n\n  const nodeState: TreeNodeState = {\n    isExpanded,\n    isSelected,\n    isChecked,\n    isIndeterminate,\n    isLeaf,\n  };\n  const resolvedItemProps =\n    typeof itemProps === 'function' ? itemProps(data, nodeState) : itemProps;\n  const { prefix: userPrefix, ...restUserProps } = resolvedItemProps ?? {};\n\n  const composedPrefix =\n    checkboxNode || userPrefix ? (\n      <>\n        {checkboxNode}\n        {userPrefix}\n      </>\n    ) : null;\n\n  return (\n    <TreeNodeRow\n      {...finalRowProps}\n      ref={combinedRef}\n      mods={rowMods}\n      style={rowStyle}\n      data-element=\"Row\"\n      data-qa-key={String(node.key)}\n      data-index={virtualIndex}\n    >\n      <TreeRowItem\n        {...gridCellProps}\n        {...restUserProps}\n        size={size}\n        isSelected={isSelected}\n        isDisabled={isDisabled}\n        mods={itemMods}\n        icon={toggleNode}\n        prefix={composedPrefix}\n        styles={rowStyles}\n      >\n        {data.title}\n      </TreeRowItem>\n    </TreeNodeRow>\n  );\n}\n\nexport const TreeNode = memo(TreeNodeInner);\n"],"mappings":";;;;;;;;;;;;;AAsBA,MAAM,mBAAmB,MAAsB;AAC7C,GAAE,iBAAiB;;AA0CrB,SAAS,cAAc,OAAsB;CAC3C,MAAM,EACJ,MACA,MACA,OACA,aACA,YACA,iBACA,WACA,WACA,iBACA,MACA,WACA,WACA,cACA,YACA,iBACE;CAEJ,MAAM,SAAS,OAAuB,KAAK;CAC3C,MAAM,cAAc,cACX,aAAa,UAAU,QAAQ,WAAW,GAAG,QACpD,CAAC,WAAW,CACb;CAED,MAAM,EAAE,UAAU,eAAe,mBAAmB,cAAc,YAChE,EAAE,MAAM,EACR,OACA,OACD;CAED,MAAM,aAAa,MAAM,aAAa,IAAI,KAAK,IAAI;CACnD,MAAM,aAAa,MAAM,iBAAiB,WAAW,KAAK,IAAI;CAG9D,MAAM,EAAE,YAAY,cAAc,SAAS,EAAE,YAAY,CAAC;CAG1D,MAAM,YACJ,MAAM,iBAAiB,aACvB,MAAM,iBAAiB,eAAe,KAAK;CAG7C,MAAM,SACJ,KAAK,WAAW,QAAS,KAAK,WAAW,SAAS,CAAC,KAAK;CAC1D,MAAM,iBAAiB,eAAe,KAAK,gBAAgB;CAE3D,MAAM,uBAAuB,eAAe;AAC1C,kBAAgB,OAAO,KAAK,IAAI,CAAC;GACjC;CAEF,MAAM,gBAAgB,UAAU,MAAqB;AACnD,MACE,EAAE,QAAQ,OACV,kBACA,CAAC,cACD,CAAC,KAAK,oBACN;AACA,KAAE,gBAAgB;AAClB,mBAAgB,OAAO,KAAK,IAAI,CAAC;;GAEnC;CAEF,MAAM,aAAa,eACV;EACL,SAAS;EACT,eAAe;EACf,UAAU;EACV,SAAS;EACT,MAAM;EACN,gBAAgB;EACjB,GACD;EAAC;EAAW;EAAiB;EAAY;EAAW;EAAQ;EAAe,CAC5E;CAED,MAAM,UAAU,eACP;EAAE,GAAG;EAAY,UAAU;EAAY,GAC9C,CAAC,YAAY,WAAW,CACzB;CAED,MAAM,WAAW,eACR;EACL,GAAG;EACH,SAAS;EACT,SAAS;EACT,SAAS;EACV,GACD;EAAC;EAAY;EAAW;EAAW;EAAU,CAC9C;CAED,MAAM,WAAW,eACR;GACJ,iBAAwC,OAAO,KAAK,SAAS,EAAE;EAChE,GAAG;EACJ,GACD,CAAC,KAAK,OAAO,aAAa,CAC3B;CAGD,MAAM,cAAsD,iBACxD,kBACE,UACA,YACE,SACA,UACJ;CAEJ,MAAM,gBAAgBA,aAAW,UAAU,YAAY;EACrD,gBAAgB;EAChB,WAAW;EACZ,CAAC;CAGF,MAAM,aAAa,SACjB,oBAAC;EAA0B;EAAY,gBAAa;GAAW,GAE/D,oBAAC;EAAe,GAAI;EAAmB,UAAU;EAAI,gBAAa;YAC/D,YACC,oBAAC,gBAAc,GAEf,oBAAC,iBAAc,IAAI,aAAa,WAAW,UAAW;GAEzC;CAGnB,MAAM,eAAe,iBACnB,oBAAC;EACC,gBAAa;EACb,MAAK;EACL,SAAS;EACT,WAAW;YAEX,oBAACC;GACC,YAAY;GACK;GACjB,YAAY,cAAc,KAAK;GAC/B,cACE,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,OAAO,KAAK,IAAI;GAGhE,UAAU;IACV;GACsB,GACxB;CAWJ,MAAM,EAAE,QAAQ,YAAY,GAAG,mBAD7B,OAAO,cAAc,aAAa,UAAU,MARb;EAC/B;EACA;EACA;EACA;EACA;EACD,CAE6D,GAAG,cACK,EAAE;CAExE,MAAM,iBACJ,gBAAgB,aACd,8CACG,cACA,cACA,GACD;AAEN,QACE,oBAAC;EACC,GAAI;EACJ,KAAK;EACL,MAAM;EACN,OAAO;EACP,gBAAa;EACb,eAAa,OAAO,KAAK,IAAI;EAC7B,cAAY;YAEZ,oBAAC;GACC,GAAI;GACJ,GAAI;GACE;GACM;GACA;GACZ,MAAM;GACN,MAAM;GACN,QAAQ;GACR,QAAQ;aAEP,KAAK;IACM;GACF;;AAIlB,MAAa,WAAW,KAAK,cAAc"}
+{"version":3,"file":"TreeNode.js","names":["Menu","mergeProps","Checkbox","MenuTrigger"],"sources":["../../../../src/components/content/Tree/TreeNode.tsx"],"sourcesContent":["import { Children, memo, useMemo, useRef, useState } from 'react';\nimport { useHover, useTreeItem } from 'react-aria';\n\nimport { useEvent } from '../../../_internal/hooks';\nimport { DirectionIcon, LoadingIcon, MoreIcon } from '../../../icons';\nimport { mergeProps, mergeRefs } from '../../../utils/react';\nimport { CubeItemActionProps, ItemAction } from '../../actions/ItemAction';\nimport { CubeMenuProps, Menu, MenuTrigger } from '../../actions/Menu';\nimport { useContextMenu } from '../../actions/use-context-menu';\nimport { Checkbox } from '../../fields/Checkbox/Checkbox';\n\nimport {\n  TreeNodeCheckboxWrapper,\n  TreeNodeRow,\n  TreeNodeToggle,\n  TreeNodeTogglePlaceholder,\n  TreeRowItem,\n} from './styled';\n\nimport type { Key, Node } from '@react-types/shared';\nimport type { Styles } from '@tenphi/tasty';\nimport type {\n  CSSProperties,\n  KeyboardEvent,\n  MouseEvent as ReactMouseEvent,\n  ReactNode,\n  Ref,\n  SyntheticEvent,\n} from 'react';\nimport type { TreeState } from 'react-stately';\nimport type {\n  CubeTreeNodeData,\n  TreeContextMenu,\n  TreeItemProps,\n  TreeNodeState,\n} from './types';\n\nconst stopPropagation = (e: SyntheticEvent) => {\n  e.stopPropagation();\n};\n\n/**\n * CSS selector matching focusable / activatable descendants that\n * should \"absorb\" a click so the parent row does not also react to\n * it. Used by the `expandOnFolderClick` row click / pointer guards.\n *\n * Covers the standard interactive elements (`button`, `a`, form\n * controls), explicit ARIA roles (`button`, `menuitem`, `checkbox`,\n * `link`, `tab`, `option`, etc.), and react-aria's pressable marker.\n */\nconst INTERACTIVE_DESCENDANT_SELECTOR = [\n  'button',\n  'a[href]',\n  'input',\n  'textarea',\n  'select',\n  '[role=\"button\"]',\n  '[role=\"menuitem\"]',\n  '[role=\"menuitemcheckbox\"]',\n  '[role=\"menuitemradio\"]',\n  '[role=\"checkbox\"]',\n  '[role=\"radio\"]',\n  '[role=\"link\"]',\n  '[role=\"tab\"]',\n  '[role=\"option\"]',\n  '[role=\"switch\"]',\n  '[data-react-aria-pressable]',\n].join(',');\n\n/**\n * Returns `true` when `target` is (or is contained within) an\n * interactive element that lives BETWEEN `target` and `currentTarget`\n * — i.e. something the user clearly intended to click instead of the\n * row itself.\n */\nfunction isInteractiveDescendant(\n  target: EventTarget | null,\n  currentTarget: EventTarget | null,\n): boolean {\n  if (!(target instanceof Element) || !(currentTarget instanceof Element)) {\n    return false;\n  }\n  const interactive = target.closest(INTERACTIVE_DESCENDANT_SELECTOR);\n  return (\n    !!interactive &&\n    interactive !== currentTarget &&\n    currentTarget.contains(interactive)\n  );\n}\n\n/** Check whether a `menu` ReactNode actually contains anything. */\nfunction isMenuEmpty(menu: ReactNode): boolean {\n  if (menu === null || menu === undefined || menu === false) return true;\n  return Children.toArray(menu).length === 0;\n}\n\nexport interface TreeNodeProps {\n  node: Node<CubeTreeNodeData>;\n  /** The original `CubeTreeNodeData` for this row, looked up by key. */\n  data: CubeTreeNodeData;\n  state: TreeState<CubeTreeNodeData>;\n\n  /** Whether the tree as a whole renders checkboxes. */\n  isCheckable: boolean;\n  /** Whether this row is currently expanded. */\n  isExpanded: boolean;\n  /** Whether the row is in an indeterminate (half-checked) state. */\n  isIndeterminate: boolean;\n  /** Whether the row is fully checked. */\n  isChecked: boolean;\n  /** Whether `loadData` is currently fetching this row's children. */\n  isLoading: boolean;\n\n  /** Toggle this row's checkbox (cascades). */\n  onToggleChecked: (key: string) => void;\n\n  /** Row size passed to the underlying Item. */\n  size?: string;\n\n  /** Per-node Item customization (static object or callback). */\n  itemProps?:\n    | TreeItemProps\n    | ((data: CubeTreeNodeData, state: TreeNodeState) => TreeItemProps);\n\n  /** Styles applied to the visible row (`TreeRowItem`). */\n  rowStyles?: Styles;\n\n  /** Inline style for virtualizer absolute positioning. */\n  virtualStyle?: CSSProperties;\n  /** Ref callback from `@tanstack/react-virtual` to measure row height. */\n  virtualRef?: (element: HTMLElement | null) => void;\n  /** Virtual index for `data-index` attribute. */\n  virtualIndex?: number;\n\n  /** Tree-wide menu default (resolved against `data.menu`). */\n  menu?:\n    | ReactNode\n    | ((data: CubeTreeNodeData, state: TreeNodeState) => ReactNode | null);\n  /** Tree-wide `contextMenu` default. */\n  contextMenu?: TreeContextMenu;\n  /** Tree-wide `onAction` callback. */\n  onAction?: (action: string, key: Key) => void;\n  /** Forwarded to every per-row `MenuTrigger`. */\n  menuTriggerProps?: Partial<CubeItemActionProps>;\n  /** Forwarded to every per-row `Menu`. */\n  menuProps?: Partial<CubeMenuProps<object>>;\n\n  /**\n   * When true, pressing a non-leaf row toggles its expansion instead\n   * of triggering selection.\n   */\n  expandOnFolderClick?: boolean;\n}\n\nfunction TreeNodeInner(props: TreeNodeProps) {\n  const {\n    node,\n    data,\n    state,\n    isCheckable,\n    isExpanded,\n    isIndeterminate,\n    isChecked,\n    isLoading,\n    onToggleChecked,\n    size,\n    itemProps,\n    rowStyles,\n    virtualStyle,\n    virtualRef,\n    virtualIndex,\n    menu: treeMenu,\n    contextMenu: treeContextMenu,\n    onAction: treeOnAction,\n    menuTriggerProps,\n    menuProps,\n    expandOnFolderClick,\n  } = props;\n\n  const rowRef = useRef<HTMLDivElement>(null);\n\n  const { rowProps, gridCellProps, expandButtonProps, isPressed } = useTreeItem(\n    { node },\n    state,\n    rowRef,\n  );\n\n  const isDisabled = state.disabledKeys.has(node.key);\n  const isSelected = state.selectionManager.isSelected(node.key);\n\n  // `useTreeItem` doesn't track hover; we need it for the `hovered` mod.\n  const { hoverProps, isHovered } = useHover({ isDisabled });\n  // React Aria's treegrid uses roving tabindex, so no `data-focused`\n  // attribute lands on the row — mirror it as a mod manually.\n  const isFocused =\n    state.selectionManager.isFocused &&\n    state.selectionManager.focusedKey === node.key;\n  // For lazy rows with no children yet, still render a toggle unless\n  // explicitly marked as leaf.\n  const isLeaf =\n    data.isLeaf === true || (data.isLeaf !== false && !node.hasChildNodes);\n  const isRowCheckable = isCheckable && data.isCheckable !== false;\n\n  const nodeState: TreeNodeState = {\n    isExpanded,\n    isSelected,\n    isChecked,\n    isIndeterminate,\n    isLeaf,\n  };\n\n  // ---- Menu resolution (per-node override > tree-level) --------------------\n\n  const effectiveMenuChildren: ReactNode =\n    data.menu === null\n      ? null\n      : data.menu !== undefined\n        ? data.menu\n        : typeof treeMenu === 'function'\n          ? treeMenu(data, nodeState)\n          : treeMenu ?? null;\n  const hasMenu = !isMenuEmpty(effectiveMenuChildren);\n\n  const effectiveContextMenu: TreeContextMenu =\n    data.contextMenu ?? treeContextMenu ?? false;\n  // The menu is exposed only when the consumer opts in via\n  // `contextMenu`. When `contextMenu` is `false` (default) we render\n  // nothing, even if `menu` is provided — this matches the plan and\n  // keeps default rows visually clean.\n  const menuExposed =\n    hasMenu &&\n    (effectiveContextMenu === true || effectiveContextMenu === 'context-only');\n  const contextMenuOnly = effectiveContextMenu === 'context-only';\n\n  // Controlled state for menu trigger (enables keyboard opening with Shift+F10)\n  const [isMenuOpen, setIsMenuOpen] = useState(false);\n\n  const handleMenuAction = useEvent((action: Key) => {\n    // Strip the \".$\" prefix that React adds via Children.toArray/map.\n    const actionStr = String(action);\n    const normalizedAction = actionStr.startsWith('.$')\n      ? actionStr.slice(2)\n      : actionStr;\n    data.onAction?.(normalizedAction);\n    treeOnAction?.(normalizedAction, node.key);\n    // Forward to the consumer-supplied `menuProps.onAction` so users\n    // who pass extra `Menu` props through `menuProps` still receive\n    // the action stream alongside the tree-level callback.\n    menuProps?.onAction?.(normalizedAction);\n  });\n\n  const rowContextMenu = useContextMenu<HTMLDivElement, CubeMenuProps<object>>(\n    Menu,\n    { placement: 'bottom start' },\n    {\n      ...menuProps,\n      onAction: handleMenuAction,\n      children: effectiveMenuChildren,\n    },\n  );\n\n  // ---- Checkbox ------------------------------------------------------------\n\n  const handleCheckboxChange = useEvent(() => {\n    onToggleChecked(String(node.key));\n  });\n\n  // ---- Folder-click interception ------------------------------------------\n\n  const shouldExpandOnRowClick =\n    !!expandOnFolderClick && !isLeaf && !isDisabled;\n\n  const handleFolderRowClick = useEvent((e: ReactMouseEvent) => {\n    // Only intercept primary-button clicks; let right-click reach\n    // `useContextMenu` (it listens for the `contextmenu` event).\n    if (e.button !== 0) return;\n    // If the click originated inside an interactive descendant\n    // (chevron, checkbox, overflow trigger, user-supplied buttons in\n    // `prefix` / `actions`, etc.) DO NOT toggle the row. Most\n    // react-aria buttons stop propagation through `usePress` already,\n    // and the `actions` slot has its own propagation guard, but\n    // user-supplied controls in the `prefix` slot or any non-react-aria\n    // button do not — without this check they would expand/collapse\n    // the row as a side-effect of being clicked, and the chevron\n    // would visibly double-toggle.\n    if (isInteractiveDescendant(e.target, e.currentTarget)) return;\n    e.preventDefault();\n    e.stopPropagation();\n    state.toggleKey(node.key);\n    state.selectionManager.setFocused(true);\n    state.selectionManager.setFocusedKey(node.key);\n  });\n\n  // Typed against the broader `MouseEvent` because both pointer and\n  // mouse handlers route here. React's `PointerEvent<T>` extends\n  // `MouseEvent<T>`, so via parameter contravariance this single\n  // function is assignable to both `PointerEventHandler<T>` and\n  // `MouseEventHandler<T>` slots without any casts.\n  const handleFolderRowPointerEvent = useEvent(\n    (e: ReactMouseEvent<HTMLDivElement>) => {\n      if (e.button !== 0) return;\n      // Skip when the event originated in an interactive descendant\n      // so the descendant's own usePress / press tracking is not\n      // disrupted by the row swallowing pointer propagation.\n      if (isInteractiveDescendant(e.target, e.currentTarget)) return;\n      // Stop usePress from latching its `isPressed` state — the row is\n      // not a press target anymore in this mode.\n      e.stopPropagation();\n    },\n  );\n\n  // ---- Keyboard ------------------------------------------------------------\n\n  // Composed keydown handler. Runs BEFORE `rowProps.onKeyDown` from\n  // `useTreeItem` so we can short-circuit the default react-aria\n  // behavior (which would otherwise trigger selection on Enter/Space).\n  // Returns `true` when the event was handled and react-aria's keydown\n  // must NOT run; returns `false` to chain to react-aria's handler.\n  const handleKeyDown = useEvent((e: KeyboardEvent) => {\n    // Space toggles the checkbox first when checkable. We DON'T claim\n    // the event (return `false`) so react-aria's onKeyDown still runs\n    // afterwards and the focused row also selects — matching the\n    // pre-refactor behavior when handlers were chained via\n    // `mergeProps`. `preventDefault` is kept to suppress page scroll.\n    if (\n      e.key === ' ' &&\n      isRowCheckable &&\n      !isDisabled &&\n      !data.isCheckboxDisabled\n    ) {\n      e.preventDefault();\n      onToggleChecked(String(node.key));\n      return false;\n    }\n\n    // Shift+F10 opens the row menu (standard accessibility shortcut).\n    if (e.key === 'F10' && e.shiftKey && menuExposed) {\n      e.preventDefault();\n      e.stopPropagation();\n      if (contextMenuOnly) {\n        rowContextMenu.open();\n      } else {\n        setIsMenuOpen(true);\n      }\n      return true;\n    }\n\n    // Folder activation via keyboard in expandOnFolderClick mode.\n    // Must run BEFORE `useTreeItem`'s onKeyDown so react-aria doesn't\n    // also fire selection on the same keypress.\n    //   - Enter always expands (matches the row-click behavior, even\n    //     when the row is also checkable — Enter is not a checkbox key).\n    //   - Space only expands when the row is NOT checkable; in\n    //     checkable trees Space is reserved for the checkbox toggle\n    //     (handled by the earlier branch).\n    if (\n      shouldExpandOnRowClick &&\n      (e.key === 'Enter' || (e.key === ' ' && !isRowCheckable))\n    ) {\n      e.preventDefault();\n      e.stopPropagation();\n      state.toggleKey(node.key);\n      state.selectionManager.setFocused(true);\n      state.selectionManager.setFocusedKey(node.key);\n      return true;\n    }\n\n    return false;\n  });\n\n  // Wrapper that delegates to react-aria's default keydown only when\n  // our handler did not claim the event. Replaces (rather than\n  // chains with) `rowProps.onKeyDown` so the order of handlers is\n  // strictly: our shortcuts → react-aria default.\n  const composedKeyDown = useEvent((e: KeyboardEvent<HTMLDivElement>) => {\n    if (handleKeyDown(e)) return;\n    rowProps.onKeyDown?.(e as unknown as globalThis.KeyboardEvent);\n  });\n\n  // ---- Mods ----------------------------------------------------------------\n\n  const sharedMods = useMemo(\n    () => ({\n      checked: isChecked,\n      indeterminate: isIndeterminate,\n      expanded: isExpanded,\n      loading: isLoading,\n      leaf: isLeaf,\n      'has-checkbox': isRowCheckable,\n      'has-menu': menuExposed,\n    }),\n    [\n      isChecked,\n      isIndeterminate,\n      isExpanded,\n      isLoading,\n      isLeaf,\n      isRowCheckable,\n      menuExposed,\n    ],\n  );\n\n  const rowMods = useMemo(\n    () => ({ ...sharedMods, disabled: isDisabled }),\n    [sharedMods, isDisabled],\n  );\n\n  const itemMods = useMemo(\n    () => ({\n      ...sharedMods,\n      focused: isFocused,\n      hovered: isHovered,\n      pressed: isPressed,\n    }),\n    [sharedMods, isFocused, isHovered, isPressed],\n  );\n\n  const rowStyle = useMemo<CSSProperties>(\n    () => ({\n      ['--tree-level' as keyof CSSProperties]: String(node.level ?? 0),\n      ...virtualStyle,\n    }),\n    [node.level, virtualStyle],\n  );\n\n  // Only emit `aria-checked` when the tree is in checkable mode.\n  const ariaChecked: 'mixed' | 'true' | 'false' | undefined = isRowCheckable\n    ? isIndeterminate\n      ? 'mixed'\n      : isChecked\n        ? 'true'\n        : 'false'\n    : undefined;\n\n  // ---- Compose row props ---------------------------------------------------\n\n  // Merge react-aria + hover props but EXCLUDE `onKeyDown` from the\n  // chain — `composedKeyDown` already wraps `rowProps.onKeyDown` and\n  // must run first to short-circuit Enter/Space selection in\n  // `expandOnFolderClick` mode.\n  const baseRowProps = {\n    ...mergeProps(rowProps, hoverProps),\n    'aria-checked': ariaChecked,\n    onKeyDown: composedKeyDown,\n  };\n\n  // When `expandOnFolderClick` applies, replace the click + pointer\n  // handlers so usePress (from `useSelectableItem`) doesn't trigger\n  // selection. We still want focus/keyboard nav, so we manually call\n  // `setFocusedKey` + `setFocused`.\n  const finalRowProps = shouldExpandOnRowClick\n    ? {\n        ...baseRowProps,\n        onClick: handleFolderRowClick,\n        onPointerDown: handleFolderRowPointerEvent,\n        onPointerUp: handleFolderRowPointerEvent,\n        onMouseDown: handleFolderRowPointerEvent,\n        onMouseUp: handleFolderRowPointerEvent,\n      }\n    : baseRowProps;\n\n  // ---- Toggle (chevron) and checkbox slots --------------------------------\n\n  // Leaf rows get a placeholder so sibling indents align.\n  const toggleNode = isLeaf ? (\n    <TreeNodeTogglePlaceholder aria-hidden data-element=\"Toggle\" />\n  ) : (\n    <TreeNodeToggle {...expandButtonProps} tabIndex={-1} data-element=\"Toggle\">\n      {isLoading ? (\n        <LoadingIcon />\n      ) : (\n        <DirectionIcon to={isExpanded ? 'bottom' : 'right'} />\n      )}\n    </TreeNodeToggle>\n  );\n\n  const checkboxNode = isRowCheckable ? (\n    <TreeNodeCheckboxWrapper\n      data-element=\"Checkbox\"\n      role=\"presentation\"\n      onClick={stopPropagation}\n      onKeyDown={stopPropagation}\n    >\n      <Checkbox\n        isSelected={isChecked}\n        isIndeterminate={isIndeterminate}\n        isDisabled={isDisabled || data.isCheckboxDisabled}\n        aria-label={\n          typeof data.title === 'string' ? data.title : String(node.key)\n        }\n        // @ts-expect-error AriaCheckboxProps loses `onChange` where InputDOMProps overlaps (react-types).\n        onChange={handleCheckboxChange}\n      />\n    </TreeNodeCheckboxWrapper>\n  ) : null;\n\n  // ---- Resolve user-supplied per-node Item props --------------------------\n\n  const resolvedItemProps =\n    typeof itemProps === 'function' ? itemProps(data, nodeState) : itemProps;\n  const {\n    prefix: userPrefix,\n    actions: userActions,\n    ...restUserProps\n  } = resolvedItemProps ?? {};\n\n  const composedPrefix =\n    checkboxNode || userPrefix ? (\n      <>\n        {checkboxNode}\n        {userPrefix}\n      </>\n    ) : null;\n\n  // ---- Built-in overflow `⋮` action ---------------------------------------\n\n  const menuAction =\n    menuExposed && !contextMenuOnly ? (\n      <MenuTrigger isOpen={isMenuOpen} onOpenChange={setIsMenuOpen}>\n        <ItemAction\n          tabIndex={-1}\n          icon={<MoreIcon />}\n          aria-label=\"Actions\"\n          {...menuTriggerProps}\n        />\n        <Menu {...menuProps} onAction={handleMenuAction}>\n          {effectiveMenuChildren}\n        </Menu>\n      </MenuTrigger>\n    ) : null;\n\n  // Compose with user-supplied actions (user actions render first).\n  const composedActions =\n    userActions || menuAction ? (\n      <>\n        {userActions}\n        {menuAction}\n      </>\n    ) : undefined;\n\n  // ---- Refs / context-menu wiring -----------------------------------------\n\n  // When the context menu is enabled for this row, attach the hook's\n  // `targetRef` to the row so right-clicks land on the correct anchor.\n  const refs = useMemo(() => {\n    const list: Ref<HTMLDivElement>[] = [rowRef];\n    if (virtualRef) list.push(virtualRef);\n    if (menuExposed) list.push(rowContextMenu.targetRef);\n    return mergeRefs(...list);\n  }, [virtualRef, menuExposed, rowContextMenu.targetRef]);\n\n  return (\n    <TreeNodeRow\n      {...finalRowProps}\n      ref={refs}\n      mods={rowMods}\n      style={rowStyle}\n      data-element=\"Row\"\n      data-qa-key={String(node.key)}\n      data-index={virtualIndex}\n    >\n      <TreeRowItem\n        {...gridCellProps}\n        {...restUserProps}\n        size={size}\n        isSelected={isSelected}\n        isDisabled={isDisabled}\n        mods={itemMods}\n        icon={toggleNode}\n        prefix={composedPrefix}\n        actions={composedActions}\n        styles={rowStyles}\n      >\n        {data.title}\n      </TreeRowItem>\n      {menuExposed && rowContextMenu.rendered}\n    </TreeNodeRow>\n  );\n}\n\nexport const TreeNode = memo(TreeNodeInner);\n"],"mappings":"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"}

package/dist/components/content/Tree/index.d.ts

@@ -1,3 +1,3 @@
 
-import { CubeTreeNodeData, CubeTreeProps, TreeLoadDataNode, TreeOnCheckInfo, TreeOnExpandInfo, TreeOnSelectInfo, TreeSelectionMode } from "./types.js";
+import { CubeTreeNodeData, CubeTreeProps, TreeContextMenu, TreeLoadDataNode, TreeNodeState, TreeOnCheckInfo, TreeOnExpandInfo, TreeOnSelectInfo, TreeSelectionMode } from "./types.js";
 import { Tree } from "./Tree.js";

package/dist/components/content/Tree/styled.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { _Item } from "../Item/Item.js";
 import { Action } from "../../actions/Action/Action.js";
 import { tasty } from "@tenphi/tasty";

package/dist/components/content/Tree/tree-index.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 //#region src/components/content/Tree/tree-index.ts
 function buildTreeIndex(treeData) {
 	const byKey = /* @__PURE__ */ new Map();

package/dist/components/content/Tree/types.d.ts

@@ -1,5 +1,9 @@
 
+import { CubeMenuProps } from "../../actions/Menu/Menu.js";
 import { CubeItemProps } from "../Item/Item.js";
+import { CubeItemActionProps } from "../../actions/ItemAction/ItemAction.js";
+import "../../actions/ItemAction/index.js";
+import "../../actions/Menu/index.js";
 import { SizeName } from "../../../tokens/sizes.js";
 import { BaseProps, OuterStyleProps, Styles } from "@tenphi/tasty";
 import { ReactNode } from "react";
@@ -8,6 +12,18 @@ import { Key as Key$1 } from "@react-types/shared";
 //#region src/components/content/Tree/types.d.ts
 /** Selection cardinality, mirroring React Aria/Stately's `selectionMode`. */
 type TreeSelectionMode = 'none' | 'single' | 'multiple';
+/**
+ * How the tree row `menu` is exposed.
+ *
+ * - `false` (default) — no menu at all.
+ * - `true` — render the overflow `⋮` trigger inside `actions` AND open
+ *   the same menu on right-click / Shift+F10.
+ * - `'context-only'` — right-click / Shift+F10 only; no `⋮` trigger.
+ *
+ * Mirrors `TabContextMenu` from `Tabs` so consumers see the same API
+ * across components.
+ */
+type TreeContextMenu = boolean | 'context-only';
 /**
  * A single node in the `treeData` array.
  *
@@ -34,6 +50,19 @@ interface CubeTreeNodeData {
    * - `false`: hide the checkbox for this row even when the tree is `isCheckable`.
    */
   isCheckable?: boolean;
+  /**
+   * Per-node menu override (Menu.Item children). Wins over the
+   * tree-level `menu` prop. Pass `null` to disable the menu for this
+   * specific row when the tree provides a default `menu`.
+   */
+  menu?: ReactNode | null;
+  /** Per-node `contextMenu` override. */
+  contextMenu?: TreeContextMenu;
+  /**
+   * Per-node `onAction` override. Called before the tree-level
+   * `onAction` with the action key from `Menu.Item`.
+   */
+  onAction?: (action: string) => void;
 }
 /** Info passed as the second argument to `onCheck`. */
 interface TreeOnCheckInfo {
@@ -177,7 +206,61 @@ interface CubeTreeProps extends BaseProps, OuterStyleProps {
   ariaLabel?: string;
   /** QA selector. */
   qa?: string;
+  /**
+   * When `true`, activating a non-leaf row toggles its expansion
+   * instead of selecting it. Useful for file-tree UX where only
+   * leaves are selectable. Folder rows remain focusable for keyboard
+   * navigation, and the chevron toggle keeps working independently.
+   *
+   * Activation rules for folder rows:
+   *   - Mouse click → expand / collapse.
+   *   - `Enter` → expand / collapse (always, including in `isCheckable`
+   *     trees — `Enter` is not a checkbox key).
+   *   - `Space` → expand / collapse in non-checkable trees; in
+   *     `isCheckable` trees `Space` toggles the row's checkbox instead.
+   *
+   * Leaf rows are unaffected and continue to select normally.
+   * @default false
+   */
+  expandOnFolderClick?: boolean;
+  /**
+   * Per-tree default menu items (Menu.Item children) shown on every
+   * row that doesn't override via `data.menu`.
+   *
+   * Accepts a static `ReactNode` (applied to every row) or a callback
+   * that receives the row data and the derived state and returns the
+   * menu content. Return `null` to hide the menu for that row.
+   */
+  menu?: ReactNode | ((data: CubeTreeNodeData, state: TreeNodeState) => ReactNode | null);
+  /**
+   * Where the menu is exposed. Same semantics as `Tabs#contextMenu`:
+   * - `false` (default) — no menu at all.
+   * - `true` — render an overflow `⋮` trigger inside `actions` AND
+   *   open the same menu on right-click / Shift+F10.
+   * - `'context-only'` — right-click / Shift+F10 only; no `⋮` trigger.
+   *
+   * Per-node `data.contextMenu` wins when provided.
+   * @default false
+   */
+  contextMenu?: TreeContextMenu;
+  /**
+   * Called when a menu action is triggered on any row. Receives the
+   * action key (with the React `.$` prefix stripped) and the row key.
+   * Per-node `data.onAction` is called first.
+   */
+  onAction?: (action: string, key: Key$1) => void;
+  /** Forwarded to every per-row `MenuTrigger`. */
+  menuTriggerProps?: Partial<CubeItemActionProps>;
+  /**
+   * Forwarded to every per-row `Menu` (both the overflow `⋮` menu and
+   * the right-click context menu).
+   *
+   * If `onAction` is provided here, it is **chained with** the
+   * tree-level `onAction` and per-node `data.onAction` (it does not
+   * override them) and receives the same normalized action key.
+   */
+  menuProps?: Partial<CubeMenuProps<object>>;
 }
 //#endregion
-export { CubeTreeNodeData, CubeTreeProps, TreeLoadDataNode, TreeOnCheckInfo, TreeOnExpandInfo, TreeOnSelectInfo, TreeSelectionMode };
+export { CubeTreeNodeData, CubeTreeProps, TreeContextMenu, TreeLoadDataNode, TreeNodeState, TreeOnCheckInfo, TreeOnExpandInfo, TreeOnSelectInfo, TreeSelectionMode };
 //# sourceMappingURL=types.d.ts.map

package/dist/components/content/Tree/use-checkbox-tree.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { useMemo, useState } from "react";
 

package/dist/components/content/Tree/use-load-data.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { useEvent } from "../../../_internal/hooks/use-event.js";
 import { useRef, useState } from "react";
 

package/dist/components/content/highlightText.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { _Text } from "./Text.js";
 import { jsx } from "react/jsx-runtime";
 

package/dist/components/content/use-auto-tooltip.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { TooltipProvider } from "../overlays/Tooltip/TooltipProvider.js";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/components/fields/Checkbox/Checkbox.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { _Text } from "../../content/Text.js";

package/dist/components/fields/Checkbox/CheckboxGroup.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useProviderProps } from "../../../provider.js";

package/dist/components/fields/Checkbox/context.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { createContext } from "react";
 
 //#region src/components/fields/Checkbox/context.ts

package/dist/components/fields/ComboBox/ComboBox.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { useLayoutEffect as useLayoutEffect$1 } from "../../../utils/react/useLayoutEffect.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";

package/dist/components/fields/DatePicker/DateInput.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useProviderProps } from "../../../provider.js";

package/dist/components/fields/DatePicker/DateInputBase.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { InvalidIcon } from "../../shared/InvalidIcon.js";

package/dist/components/fields/DatePicker/DatePicker.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useProviderProps } from "../../../provider.js";

package/dist/components/fields/DatePicker/DatePickerButton.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { ItemAction } from "../../actions/ItemAction/ItemAction.js";
 import { CalendarIcon } from "../../../icons/CalendarIcon.js";
 import { tasty } from "@tenphi/tasty";

package/dist/components/fields/DatePicker/DatePickerElement.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { Space } from "../../layout/Space.js";
 import { tasty } from "@tenphi/tasty";
 

package/dist/components/fields/DatePicker/DatePickerInput.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { DatePickerSegment } from "./DatePickerSegment.js";
 import { formatSegments } from "./utils.js";

package/dist/components/fields/DatePicker/DatePickerSegment.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { tasty } from "@tenphi/tasty";
 import { useRef } from "react";
 import { jsx } from "react/jsx-runtime";

package/dist/components/fields/DatePicker/DateRangePicker.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useProviderProps } from "../../../provider.js";

package/dist/components/fields/DatePicker/DateRangeSeparatedPicker.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useProviderProps } from "../../../provider.js";

package/dist/components/fields/DatePicker/TimeInput.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { extractStyles } from "../../../utils/styles.js";
 import { mergeProps as mergeProps$1 } from "../../../utils/react/mergeProps.js";
 import { useProviderProps } from "../../../provider.js";

package/dist/components/fields/DatePicker/intl.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 //#region src/components/fields/DatePicker/intl.ts
 const dateMessages = {
 	time: "Time",

package/dist/components/fields/DatePicker/parseDate.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { parseAbsolute } from "@internationalized/date";
 
 //#region src/components/fields/DatePicker/parseDate.ts

package/dist/components/fields/DatePicker/props.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 //#region src/components/fields/DatePicker/props.ts
 const DEFAULT_DATE_PROPS = {
 	granularity: "day",

package/dist/components/fields/DatePicker/utils.js

@@ -1,4 +1,4 @@
-/** @license MIT | @cube-dev/ui-kit v0.131.0 | Cube Dev Team */
+/** @license MIT | @cube-dev/ui-kit v0.132.0 | Cube Dev Team */
 import { useImperativeHandle, useRef } from "react";
 import { createDOMRef } from "@react-spectrum/utils";
 import { createFocusManager } from "@react-aria/focus";