@itwin/itwinui-react 5.0.0-alpha.10 → 5.0.0-alpha.12

package/dist/bricks/TextBox.js

@@ -3,69 +3,55 @@ import * as React from "react";
 import { Role } from "@ariakit/react/role";
 import { Focusable } from "@ariakit/react/focusable";
 import cx from "classnames";
-import { FieldControl } from "./Field.js";
 import { Icon } from "./Icon.js";
 import { useMergedRefs } from "./~hooks.js";
 import { forwardRef } from "./~utils.js";
+import { useFieldControlType } from "./Field.internal.js";
 const TextBoxInput = forwardRef(
   (props, forwardedRef) => {
-    const { id, ...rest } = props;
+    useFieldControlType("textlike");
     const rootContext = React.useContext(TextBoxRootContext);
     const setDisabled = rootContext?.setDisabled;
     React.useEffect(() => {
       setDisabled?.(props.disabled);
     }, [setDisabled, props.disabled]);
     return /* @__PURE__ */ jsx(
-      FieldControl,
+      Role.input,
       {
-        type: "textlike",
-        id,
+        readOnly: props.disabled,
+        ...props,
+        className: cx({ "\u{1F95D}-text-box": !rootContext }, props.className),
+        placeholder: props.placeholder ?? " ",
         render: /* @__PURE__ */ jsx(
-          Role.input,
+          Focusable,
           {
-            readOnly: props.disabled,
-            ...rest,
-            className: cx({ "\u{1F95D}-text-box": !rootContext }, props.className),
-            placeholder: props.placeholder ?? " ",
-            render: /* @__PURE__ */ jsx(
-              Focusable,
-              {
-                accessibleWhenDisabled: true,
-                render: props.render || /* @__PURE__ */ jsx("input", {})
-              }
-            ),
-            ref: useMergedRefs(rootContext?.inputRef, forwardedRef)
+            accessibleWhenDisabled: true,
+            render: props.render || /* @__PURE__ */ jsx("input", {})
           }
-        )
+        ),
+        ref: useMergedRefs(rootContext?.inputRef, forwardedRef)
       }
     );
   }
 );
 const TextBoxTextarea = forwardRef(
   (props, forwardedRef) => {
-    const { id, ...rest } = props;
+    useFieldControlType("textlike");
     return /* @__PURE__ */ jsx(
-      FieldControl,
+      Role.textarea,
       {
-        type: "textlike",
-        id,
+        readOnly: props.disabled,
+        ...props,
+        className: cx("\u{1F95D}-text-box", props.className),
+        placeholder: props.placeholder ?? " ",
         render: /* @__PURE__ */ jsx(
-          Role.textarea,
+          Focusable,
           {
-            readOnly: props.disabled,
-            ...rest,
-            className: cx("\u{1F95D}-text-box", props.className),
-            placeholder: props.placeholder ?? " ",
-            render: /* @__PURE__ */ jsx(
-              Focusable,
-              {
-                accessibleWhenDisabled: true,
-                render: props.render || /* @__PURE__ */ jsx("textarea", {})
-              }
-            ),
-            ref: forwardedRef
+            accessibleWhenDisabled: true,
+            render: props.render || /* @__PURE__ */ jsx("textarea", {})
           }
-        )
+        ),
+        ref: forwardedRef
       }
     );
   }

package/dist/bricks/Tooltip.js

@@ -43,6 +43,7 @@ const Tooltip = forwardRef(
             AkTooltip.Tooltip,
             {
               "aria-hidden": "true",
+              portal: true,
               ...rest,
               unmountOnHide,
               className: cx("\u{1F95D}-tooltip", props.className),
@@ -53,7 +54,6 @@ const Tooltip = forwardRef(
                 ...props.style
               },
               wrapperProps: popover.wrapperProps,
-              portal: popover.portal,
               children: content
             }
           )

package/dist/bricks/TreeItem.d.ts

@@ -1,5 +1,4 @@
 import * as React from "react";
-import { IconButton } from "./IconButton.js";
 import { type BaseProps } from "./~utils.js";
 interface TreeItemRootProps extends Omit<BaseProps, "content" | "children"> {
     /** Specifies the nesting level of the tree item. Nesting levels start at 1. */
@@ -28,7 +27,7 @@ interface TreeItemRootProps extends Omit<BaseProps, "content" | "children"> {
      * Used to determine if a tree item is a parent node. If `undefined`, it is a leaf node (i.e. not expandable).
      *
      * @default undefined
-     * */
+     */
     expanded?: boolean;
     /**
      * Callback fired when the tree item is expanded.
@@ -62,17 +61,45 @@ interface TreeItemRootProps extends Omit<BaseProps, "content" | "children"> {
     /** Secondary line of text to display additional information about the tree item. */
     description?: React.ReactNode;
     /**
-     * The actions available for the tree item. Must be a list of `Tree.ItemAction` components.
+     * The secondary actions available for the tree item. Must be a list of `Tree.ItemAction` components.
      *
      * Example:
      * ```tsx
      * actions={[
+     *   error && <Tree.ItemAction key={…} icon={…} label={…} />,
      *   <Tree.ItemAction key={…} icon={…} label={…} />,
      *   <Tree.ItemAction key={…} icon={…} label={…} />,
      * ]}
      * ```
+     *
+     * Excess actions will automatically get collapsed into an overflow menu.
+     * - Normally, the third action and onwards will overflow.
+     * - When the `error` prop is set, the _second_ action and onwards will overflow.
+     *
+     * The actions are normally hidden until the treeitem is hovered or focused.
+     * When the `error` prop is set, the actions will be made visible by default. The first
+     * action slot can be used to display an error-related action.
+     *
+     * ```tsx
+     * actions={[
+     *   error && <Tree.ItemAction key={…} icon={…} label={…} />,
+     *   <Tree.ItemAction key={…} icon={…} label={…} />,
+     *   <Tree.ItemAction key={…} icon={…} label={…} />,
+     * ]}
+     * ```
+     *
+     * @experimental
      */
     actions?: React.ReactNode[];
+    /**
+     * Specifies if the tree item is in an error state.
+     *
+     * Can be combined with the `actions` prop to display an error-related action. The first
+     * action will be made visible by default.
+     *
+     * @default false
+     */
+    error?: boolean;
 }
 /**
  * A treeitem is a node in a tree structure that may be expanded or collapsed to reveal or hide its descendants.
@@ -101,23 +128,40 @@ interface TreeItemRootProps extends Omit<BaseProps, "content" | "children"> {
  * Secondary actions can be passed into the `actions` prop.
  */
 declare const TreeItemRoot: React.ForwardRefExoticComponent<TreeItemRootProps & React.RefAttributes<HTMLElement | HTMLDivElement>>;
-type IconButtonProps = React.ComponentProps<typeof IconButton>;
-interface TreeItemActionProps extends BaseProps<"button">, Pick<IconButtonProps, "label" | "icon"> {
+interface TreeItemActionProps extends Omit<BaseProps<"button">, "children"> {
+    /**
+     * Label for the action.
+     *
+     * Will be displayed as a tooltip when the action is an icon-button,
+     * otherwise will be displayed as a label inside the menu-item.
+     */
+    label: string;
+    /**
+     * Icon for the action.
+     *
+     * Can be a URL of an SVG from the `@itwin/itwinui-icons` package, or a JSX element.
+     *
+     * Required when the action is displayed as an icon-button (i.e. not overflowing).
+     */
+    icon?: string | React.JSX.Element;
     /**
-     * Controls the visibility of the action.
+     * Controls the visibility of the action (only when the action is displayed as icon-button).
      *
      * If `true`, the action is always visible.
      * If `false`, the action is hidden and becomes inaccessible, but still occupies space.
      *
-     * By default, the action is shown only when the treeitem receives hover/focus.
+     * By default, the action is shown only when the treeitem receives hover/focus. When the
+     * treeitem has an `error`, the action will become always visible (i.e. it will default
+     * to `true` when `error` is set).
      */
     visible?: boolean;
 }
 /**
  * A secondary action for `<Tree.Item>`, to be passed into the `actions` prop. The action is typically
- * displayed as an icon-button on the right end of the treeitem.
+ * displayed as an icon-button or a menu-item (e.g. when overflowing).
  *
- * By default, the action appears only on hover/focus. This can be controlled by the `visible` prop.
+ * By default, the action appears only when the treeitem has hover/focus or an error. This behavior can
+ * be overridden using the `visible` prop.
  */
 declare const TreeItemAction: React.ForwardRefExoticComponent<TreeItemActionProps & React.RefAttributes<HTMLElement | HTMLButtonElement>>;
 export { TreeItemRoot as Root, TreeItemAction as Action };

package/dist/bricks/TreeItem.js

@@ -2,15 +2,17 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
 import cx from "classnames";
 import { Role } from "@ariakit/react/role";
+import { PopoverProvider } from "@ariakit/react/popover";
 import {
   CompositeItem
 } from "@ariakit/react/composite";
 import { Toolbar } from "@ariakit/react/toolbar";
 import * as ListItem from "./~utils.ListItem.js";
 import { IconButton } from "./IconButton.js";
-import { Icon } from "./Icon.js";
+import * as DropdownMenu from "./DropdownMenu.js";
+import { Icon, StatusWarning, MoreHorizontal } from "./Icon.js";
 import { forwardRef } from "./~utils.js";
-import { useEventHandlers } from "./~hooks.js";
+import { useEventHandlers, useSafeContext } from "./~hooks.js";
 import { GhostAligner, useGhostAlignment } from "./~utils.GhostAligner.js";
 const TreeItemContext = React.createContext(void 0);
 const TreeItemRoot = forwardRef(
@@ -19,11 +21,12 @@ const TreeItemRoot = forwardRef(
       "aria-level": level,
       selected,
       expanded,
-      icon,
+      icon: iconProp,
       unstable_decorations,
       label,
       description,
       actions,
+      error,
       onSelectedChange,
       onExpandedChange,
       onClick: onClickProp,
@@ -48,6 +51,7 @@ const TreeItemRoot = forwardRef(
     const labelId = React.useId();
     const descriptionId = React.useId();
     const decorationId = React.useId();
+    const icon = error ? /* @__PURE__ */ jsx(StatusWarning, {}) : iconProp;
     const describedBy = React.useMemo(() => {
       const idRefs = [];
       if (description) idRefs.push(descriptionId);
@@ -61,9 +65,10 @@ const TreeItemRoot = forwardRef(
           () => ({
             level,
             expanded,
-            selected
+            selected,
+            error
           }),
-          [level, expanded, selected]
+          [level, expanded, selected, error]
         ),
         children: /* @__PURE__ */ jsx(
           CompositeItem,
@@ -90,6 +95,7 @@ const TreeItemRoot = forwardRef(
               {
                 "data-kiwi-expanded": expanded,
                 "data-kiwi-selected": selected,
+                "data-kiwi-error": error ? true : void 0,
                 className: "\u{1F95D}-tree-item-node",
                 style: { "--\u{1F95D}tree-item-level": level },
                 role: void 0,
@@ -139,24 +145,89 @@ const TreeItemRoot = forwardRef(
   }
 );
 const TreeItemActions = forwardRef((props, forwardedRef) => {
-  return /* @__PURE__ */ jsx(
+  const { children, ...rest } = props;
+  const actions = React.Children.toArray(children).filter(Boolean);
+  const { error } = useSafeContext(TreeItemContext);
+  const limit = error ? 2 : 3;
+  return /* @__PURE__ */ jsxs(
     Toolbar,
     {
-      ...props,
+      ...rest,
       onClick: useEventHandlers(props.onClick, (e) => e.stopPropagation()),
       onKeyDown: useEventHandlers(props.onKeyDown, (e) => e.stopPropagation()),
-      className: cx("\u{1F95D}-tree-item-actions", props.className),
+      className: cx("\u{1F95D}-tree-item-actions-container", props.className),
+      focusLoop: false,
       ref: forwardedRef,
-      children: props.children
+      children: [
+        actions.slice(0, limit - 1),
+        actions.length === limit ? actions[limit - 1] : null,
+        actions.length > limit ? /* @__PURE__ */ jsx(TreeItemActionsOverflowMenu, { children: actions.slice(limit - 1) }) : null
+      ]
     }
   );
 });
+const arrowKeys = ["ArrowDown", "ArrowUp", "ArrowLeft", "ArrowRight"];
+const TreeItemActionsOverflowMenuContext = React.createContext(false);
+function TreeItemActionsOverflowMenu({ children }) {
+  const [open, setOpen] = React.useState(false);
+  const isArrowKeyPressed = React.useRef(false);
+  return /* @__PURE__ */ jsx(PopoverProvider, { placement: "right-start", children: /* @__PURE__ */ jsxs(
+    DropdownMenu.Root,
+    {
+      open,
+      setOpen: React.useCallback((value) => {
+        if (value && !isArrowKeyPressed.current) {
+          setOpen(true);
+        } else {
+          setOpen(false);
+        }
+      }, []),
+      children: [
+        /* @__PURE__ */ jsx(
+          DropdownMenu.Button,
+          {
+            onKeyDown: (e) => {
+              if (arrowKeys.includes(e.key)) {
+                isArrowKeyPressed.current = true;
+              }
+              queueMicrotask(() => {
+                isArrowKeyPressed.current = false;
+              });
+            },
+            render: /* @__PURE__ */ jsx(TreeItemAction, { label: "More", icon: /* @__PURE__ */ jsx(MoreHorizontal, {}) })
+          }
+        ),
+        /* @__PURE__ */ jsx(TreeItemActionsOverflowMenuContext.Provider, { value: true, children: /* @__PURE__ */ jsx(DropdownMenu.Content, { children }) })
+      ]
+    }
+  ) });
+}
 const TreeItemAction = forwardRef(
   (props, forwardedRef) => {
-    const { visible, ...rest } = props;
+    const { error } = useSafeContext(TreeItemContext);
+    const {
+      visible = error ? true : void 0,
+      // visible by default during error state
+      label,
+      icon,
+      ...rest
+    } = props;
+    if (React.useContext(TreeItemActionsOverflowMenuContext)) {
+      return /* @__PURE__ */ jsx(
+        DropdownMenu.Item,
+        {
+          ...rest,
+          label,
+          icon,
+          ref: forwardedRef
+        }
+      );
+    }
     return /* @__PURE__ */ jsx(
       IconButton,
       {
+        label,
+        icon,
         inert: visible === false ? true : void 0,
         ...rest,
         variant: "ghost",

package/dist/bricks/index.d.ts

@@ -10,7 +10,7 @@ export * as DropdownMenu from "./DropdownMenu.js";
 export { Divider } from "./Divider.js";
 export { Icon } from "./Icon.js";
 export { IconButton } from "./IconButton.js";
-export { Field } from "./Field.js";
+export * as Field from "./Field.js";
 export { Kbd } from "./Kbd.js";
 export { Label } from "./Label.js";
 export { ProgressBar } from "./ProgressBar.js";
@@ -19,6 +19,7 @@ export * as Select from "./Select.js";
 export { Spinner } from "./Spinner.js";
 export { Skeleton } from "./Skeleton.js";
 export { Switch } from "./Switch.js";
+export * as Table from "./Table.js";
 export * as Tabs from "./Tabs.js";
 export { Text } from "./Text.js";
 export * as TextBox from "./TextBox.js";

package/dist/bricks/index.js

@@ -11,7 +11,7 @@ import * as DropdownMenu from "./DropdownMenu.js";
 import { Divider } from "./Divider.js";
 import { Icon } from "./Icon.js";
 import { IconButton } from "./IconButton.js";
-import { Field } from "./Field.js";
+import * as Field from "./Field.js";
 import { Kbd } from "./Kbd.js";
 import { Label } from "./Label.js";
 import { ProgressBar } from "./ProgressBar.js";
@@ -20,6 +20,7 @@ import * as Select from "./Select.js";
 import { Spinner } from "./Spinner.js";
 import { Skeleton } from "./Skeleton.js";
 import { Switch } from "./Switch.js";
+import * as Table from "./Table.js";
 import * as Tabs from "./Tabs.js";
 import { Text } from "./Text.js";
 import * as TextBox from "./TextBox.js";
@@ -48,6 +49,7 @@ export {
   Skeleton,
   Spinner,
   Switch,
+  Table,
   Tabs,
   Text,
   TextBox,