@itwin/itwinui-react 5.0.0-alpha.1 → 5.0.0-alpha.3

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 5.0.0-alpha.3
+
+- Added `<DropdownMenu.CheckboxItem>` component for rendering menu items with a checkable state.
+- Added `variant` prop to `<Select.HtmlSelect>` component for displaying different visual variants of the component.
+- Updated event handling of `Tree` components to avoid firing `onClick` event of the `<Tree.Item>` component when the expander or one of the actions is clicked.
+- Updated `Tree` components to implement a tree view pattern instead of the previously used nested list approach.
+- Updated size and spacing of `<Tree.Item>`, `<DropdownMenu.Item>` and `<Select>` components.
+- Fixed `<Label>` component alignment with `TextBox` components.
+- Fixed action rendering of `<Tree.Item>` component.
+- Fixed `<Checkbox>` component styling, which caused the mixed checkbox to be displayed as unchecked in the light theme.
+
+## 5.0.0-alpha.2
+
+- Added initial `Tree` component, exposed as `<Tree.Root>` and `<Tree.Item>` subcomponents.
+- Added initial `<Spinner>` component for indicating quick, indeterminate progress.
+- Added `<Description>` component to be used within a `<Field>`.
+- Added initial `<Chip>` component.
+- Added `symbol` prop to `<Kbd>` for displaying predefined symbols.
+- Added `focusable` prop to `<Tabs.TabPanel>` component.
+- Fixed a visual issue where light color-scheme was using dark shadows.
+
 ## 5.0.0-alpha.1
 
 - Added `<Text>` component with a `variant` prop to support all text styles from Figma.

package/dist/DEV/bricks/Anchor.js

@@ -7,8 +7,8 @@ const Anchor = forwardRef((props, forwardedRef) => {
   return /* @__PURE__ */ jsx(
     Ariakit.Role.a,
     {
-      "data-kiwi-tone": tone,
       ...rest,
+      "data-kiwi-tone": tone,
       className: cx("\u{1F95D}-anchor", props.className),
       render: /* @__PURE__ */ jsx(
         Ariakit.Focusable,

package/dist/DEV/bricks/Button.js

@@ -9,9 +9,9 @@ const Button = forwardRef(
       Ariakit.Button,
       {
         accessibleWhenDisabled: true,
+        ...rest,
         "data-kiwi-variant": variant,
         "data-kiwi-tone": tone,
-        ...rest,
         className: cx("\u{1F95D}-button", props.className),
         ref: forwardedRef
       }

package/dist/DEV/bricks/Checkbox.js

@@ -1,11 +1,12 @@
 import { jsx } from "react/jsx-runtime";
 import cx from "classnames";
 import * as Ariakit from "@ariakit/react";
-import { useFieldId } from "./Field.js";
+import { useFieldDescribedBy, useFieldId } from "./Field.js";
 import { forwardRef } from "./~utils.js";
 const Checkbox = forwardRef(
   (props, forwardedRef) => {
     const fieldId = useFieldId();
+    const describedBy = useFieldDescribedBy(props["aria-describedby"]);
     return /* @__PURE__ */ jsx(
       Ariakit.Checkbox,
       {
@@ -13,6 +14,7 @@ const Checkbox = forwardRef(
         id: fieldId,
         ...props,
         className: cx("\u{1F95D}-checkbox", props.className),
+        "aria-describedby": describedBy,
         ref: forwardedRef
       }
     );

package/dist/DEV/bricks/Chip.js

@@ -0,0 +1,21 @@
+import { jsx } from "react/jsx-runtime";
+import cx from "classnames";
+import * as Ariakit from "@ariakit/react";
+import { forwardRef } from "./~utils.js";
+const Chip = forwardRef((props, forwardedRef) => {
+  const { variant = "solid", children, ...rest } = props;
+  return /* @__PURE__ */ jsx(
+    Ariakit.Role.div,
+    {
+      "data-kiwi-variant": variant,
+      ...rest,
+      className: cx("\u{1F95D}-chip", props.className),
+      ref: forwardedRef,
+      children
+    }
+  );
+});
+DEV: Chip.displayName = "Chip";
+export {
+  Chip
+};

package/dist/DEV/bricks/Description.js

@@ -0,0 +1,27 @@
+import { jsx } from "react/jsx-runtime";
+import * as React from "react";
+import { forwardRef } from "./~utils.js";
+import cx from "classnames";
+import { Text } from "./Text.js";
+import { useFieldRegisterDescribedBy } from "./Field.js";
+const Description = forwardRef(
+  (props, forwardedRef) => {
+    const generatedId = React.useId();
+    const { id = generatedId, tone, ...rest } = props;
+    useFieldRegisterDescribedBy(id);
+    return /* @__PURE__ */ jsx(
+      Text,
+      {
+        ...rest,
+        id,
+        variant: "caption-md",
+        "data-kiwi-tone": tone ?? "neutral",
+        className: cx("\u{1F95D}-description", props.className),
+        ref: forwardedRef
+      }
+    );
+  }
+);
+export {
+  Description
+};

package/dist/DEV/bricks/DropdownMenu.js

@@ -5,7 +5,7 @@ import * as Ariakit from "@ariakit/react";
 import * as ListItem from "./ListItem.js";
 import { Button } from "./Button.js";
 import { Kbd } from "./Kbd.js";
-import { DisclosureArrow } from "./Icon.js";
+import { Checkmark, DisclosureArrow } from "./Icon.js";
 import { forwardRef, supportsPopover } from "./~utils.js";
 function DropdownMenu(props) {
   const {
@@ -98,8 +98,27 @@ const DropdownMenuItem = forwardRef(
   }
 );
 DEV: DropdownMenuItem.displayName = "DropdownMenu.Item";
+const DropdownMenuCheckboxItem = forwardRef((props, forwardedRef) => {
+  return /* @__PURE__ */ jsxs(
+    Ariakit.MenuItemCheckbox,
+    {
+      accessibleWhenDisabled: true,
+      value: props.defaultChecked ? "on" : void 0,
+      ...props,
+      render: /* @__PURE__ */ jsx(ListItem.Root, { render: props.render }),
+      className: cx("\u{1F95D}-dropdown-menu-checkbox-item", props.className),
+      ref: forwardedRef,
+      children: [
+        /* @__PURE__ */ jsx(ListItem.Content, { children: props.children }),
+        /* @__PURE__ */ jsx(Checkmark, { className: "\u{1F95D}-dropdown-menu-checkmark" })
+      ]
+    }
+  );
+});
+DEV: DropdownMenuCheckboxItem.displayName = "DropdownMenu.CheckboxItem";
 export {
   DropdownMenuButton as Button,
+  DropdownMenuCheckboxItem as CheckboxItem,
   DropdownMenuContent as Content,
   DropdownMenuItem as Item,
   DropdownMenu as Root

package/dist/DEV/bricks/Field.js

@@ -5,23 +5,74 @@ import cx from "classnames";
 import { forwardRef } from "./~utils.js";
 const Field = forwardRef((props, forwardedRef) => {
   const fieldId = React.useId();
-  const { className, layout, ...rest } = props;
-  return /* @__PURE__ */ jsx(FieldIdContext.Provider, { value: fieldId, children: /* @__PURE__ */ jsx(
+  const { layout, ...rest } = props;
+  return /* @__PURE__ */ jsx(FieldIdContext.Provider, { value: fieldId, children: /* @__PURE__ */ jsx(FieldDescribedByProvider, { children: /* @__PURE__ */ jsx(
     Ariakit.Role,
     {
       ...rest,
-      className: cx("\u{1F95D}-field", className),
+      className: cx("\u{1F95D}-field", props.className),
       "data-kiwi-layout": layout,
       ref: forwardedRef
     }
-  ) });
+  ) }) });
 });
 DEV: Field.displayName = "Field";
+const FieldDescribedByContext = React.createContext(void 0);
+function FieldDescribedByProvider(props) {
+  const [describedBy, setDescribedBy] = React.useState(/* @__PURE__ */ new Set());
+  const register = React.useCallback((id) => {
+    setDescribedBy((describedBy2) => {
+      const updated = new Set(describedBy2);
+      updated.add(id);
+      return updated;
+    });
+  }, []);
+  const unregister = React.useCallback((id) => {
+    setDescribedBy((describedBy2) => {
+      const updated = new Set(describedBy2);
+      updated.delete(id);
+      return updated;
+    });
+  }, []);
+  return /* @__PURE__ */ jsx(
+    FieldDescribedByContext.Provider,
+    {
+      value: React.useMemo(
+        () => ({
+          describedBy,
+          register,
+          unregister
+        }),
+        [describedBy, register, unregister]
+      ),
+      children: props.children
+    }
+  );
+}
+function useFieldDescribedBy(ariaDescribedByProp) {
+  const describedBySet = React.useContext(FieldDescribedByContext)?.describedBy;
+  return React.useMemo(
+    () => !describedBySet || describedBySet.size === 0 ? ariaDescribedByProp : [...describedBySet, ariaDescribedByProp].filter(Boolean).join(" "),
+    [describedBySet, ariaDescribedByProp]
+  );
+}
+function useFieldRegisterDescribedBy(id) {
+  const context = React.useContext(FieldDescribedByContext);
+  const register = context?.register;
+  const unregister = context?.unregister;
+  React.useEffect(() => {
+    if (!register || !unregister) return;
+    register(id);
+    return () => unregister(id);
+  }, [id, register, unregister]);
+}
 const FieldIdContext = React.createContext(void 0);
 function useFieldId() {
   return React.useContext(FieldIdContext);
 }
 export {
   Field,
-  useFieldId
+  useFieldDescribedBy,
+  useFieldId,
+  useFieldRegisterDescribedBy
 };

package/dist/DEV/bricks/Icon.js

@@ -9,9 +9,9 @@ const Icon = forwardRef((props, forwardedRef) => {
   return /* @__PURE__ */ jsx(
     Ariakit.Role.svg,
     {
-      "data-kiwi-size": size,
       "aria-hidden": true,
       ...rest,
+      "data-kiwi-size": size,
       className: cx("\u{1F95D}-icon", props.className),
       ref: forwardedRef,
       children: /* @__PURE__ */ jsx("use", { href: `${props.href}#${iconId}` })
@@ -56,7 +56,38 @@ const DisclosureArrow = forwardRef(
   }
 );
 DEV: DisclosureArrow.displayName = "DisclosureArrow";
+const Checkmark = forwardRef(
+  (props, forwardedRef) => {
+    return /* @__PURE__ */ jsx(
+      Icon,
+      {
+        ...props,
+        render: /* @__PURE__ */ jsx(
+          Ariakit.Role.svg,
+          {
+            width: "16",
+            height: "16",
+            fill: "currentColor",
+            viewBox: "0 0 16 16",
+            render: props.render,
+            children: /* @__PURE__ */ jsx(
+              "path",
+              {
+                fillRule: "evenodd",
+                d: "M13.854 4.146a.5.5 0 0 1 0 .708l-7 7a.5.5 0 0 1-.708 0l-3-3a.5.5 0 1 1 .708-.708L6.5 10.793l6.646-6.647a.5.5 0 0 1 .708 0Z",
+                clipRule: "evenodd"
+              }
+            )
+          }
+        ),
+        ref: forwardedRef
+      }
+    );
+  }
+);
+DEV: Checkmark.displayName = "Checkmark";
 export {
+  Checkmark,
   DisclosureArrow,
   Icon
 };

package/dist/DEV/bricks/IconButton.js

@@ -1,5 +1,6 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import cx from "classnames";
+import * as Ariakit from "@ariakit/react";
 import { Button } from "./Button.js";
 import { VisuallyHidden } from "./VisuallyHidden.js";
 import { Icon } from "./Icon.js";
@@ -8,11 +9,13 @@ import { forwardRef } from "./~utils.js";
 const IconButton = forwardRef(
   (props, forwardedRef) => {
     const { label, icon, isActive, labelVariant, ...rest } = props;
+    const toolbar = Ariakit.useToolbarContext();
     const button = /* @__PURE__ */ jsxs(
       Button,
       {
         "aria-pressed": isActive,
         ...rest,
+        render: toolbar ? /* @__PURE__ */ jsx(Ariakit.ToolbarItem, { render: props.render }) : props.render,
         className: cx("\u{1F95D}-icon-button", props.className),
         ref: forwardedRef,
         children: [

package/dist/DEV/bricks/Kbd.js

@@ -1,17 +1,49 @@
-import { jsx } from "react/jsx-runtime";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import cx from "classnames";
 import * as Ariakit from "@ariakit/react";
 import { forwardRef } from "./~utils.js";
+import { VisuallyHidden } from "./VisuallyHidden.js";
+const predefinedSymbols = {
+  Backspace: "\u232B",
+  Command: "\u2318",
+  Control: "Ctrl",
+  Down: "\u2193",
+  Eject: "\u23CF",
+  Enter: "\u21B5",
+  Escape: "Esc",
+  Left: "\u2190",
+  Option: "\u2325",
+  Right: "\u2192",
+  Shift: "\u21E7",
+  Space: "\u2423",
+  Tab: "Tab",
+  Up: "\u2191"
+};
 const Kbd = forwardRef((props, forwardedRef) => {
-  const { variant = "solid", ...rest } = props;
+  const { variant = "solid", symbol, children, ...rest } = props;
+  DEV: {
+    if (symbol && !(symbol in predefinedSymbols)) {
+      console.error(
+        `Kbd: Invalid symbol "${symbol}". Must be one of: ${Object.keys(predefinedSymbols).join(", ")}`
+      );
+    }
+  }
+  let content = children;
+  if (symbol) {
+    content = /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: predefinedSymbols[symbol] }),
+      children || /* @__PURE__ */ jsx(VisuallyHidden, { children: symbol })
+    ] });
+  }
   return /* @__PURE__ */ jsx(
     Ariakit.Role,
     {
-      "data-kiwi-variant": variant,
       ...rest,
+      "data-kiwi-variant": variant,
       className: cx("\u{1F95D}-kbd", props.className),
       render: props.render || /* @__PURE__ */ jsx("kbd", {}),
-      ref: forwardedRef
+      ref: forwardedRef,
+      children: content
     }
   );
 });

package/dist/DEV/bricks/Radio.js

@@ -1,10 +1,11 @@
 import { jsx } from "react/jsx-runtime";
 import cx from "classnames";
 import * as Ariakit from "@ariakit/react";
-import { useFieldId } from "./Field.js";
+import { useFieldDescribedBy, useFieldId } from "./Field.js";
 import { forwardRef } from "./~utils.js";
 const Radio = forwardRef((props, forwardedRef) => {
   const fieldId = useFieldId();
+  const describedBy = useFieldDescribedBy(props["aria-describedby"]);
   return /* @__PURE__ */ jsx(
     Ariakit.Radio,
     {
@@ -12,6 +13,7 @@ const Radio = forwardRef((props, forwardedRef) => {
       id: fieldId,
       ...props,
       className: cx("\u{1F95D}-checkbox", "\u{1F95D}-radio", props.className),
+      "aria-describedby": describedBy,
       ref: forwardedRef
     }
   );

package/dist/DEV/bricks/Select.js

@@ -7,7 +7,7 @@ import {
   isBrowser
 } from "./~utils.js";
 import { DisclosureArrow } from "./Icon.js";
-import { useFieldId } from "./Field.js";
+import { useFieldDescribedBy, useFieldId } from "./Field.js";
 const supportsHas = isBrowser && CSS?.supports?.("selector(:has(+ *))");
 const HtmlSelectContext = React.createContext(() => {
 });
@@ -25,8 +25,10 @@ const SelectRoot = forwardRef((props, forwardedRef) => {
 });
 const HtmlSelect = forwardRef(
   (props, forwardedRef) => {
+    const { variant = "solid", ...rest } = props;
     const setIsHtmlSelect = React.useContext(HtmlSelectContext);
     const fieldId = useFieldId();
+    const describedBy = useFieldDescribedBy(props["aria-describedby"]);
     React.useEffect(
       function updateContext() {
         setIsHtmlSelect(true);
@@ -38,10 +40,11 @@ const HtmlSelect = forwardRef(
         Ariakit.Role.select,
         {
           id: fieldId,
-          ...props,
+          ...rest,
           className: cx("\u{1F95D}-button", "\u{1F95D}-select", props.className),
+          "aria-describedby": describedBy,
           "data-kiwi-tone": "neutral",
-          "data-kiwi-variant": "solid",
+          "data-kiwi-variant": variant,
           ref: forwardedRef
         }
       ),

package/dist/DEV/bricks/Spinner.js

@@ -0,0 +1,40 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import * as Ariakit from "@ariakit/react";
+import cx from "classnames";
+import { VisuallyHidden } from "./VisuallyHidden.js";
+import { forwardRef } from "./~utils.js";
+const Spinner = forwardRef(
+  (props, forwardedRef) => {
+    const {
+      alt = "Loading\u2026",
+      size = "medium",
+      tone = "neutral",
+      ...rest
+    } = props;
+    return /* @__PURE__ */ jsxs(
+      Ariakit.Role,
+      {
+        ...rest,
+        "data-kiwi-size": size,
+        "data-kiwi-tone": tone,
+        className: cx("\u{1F95D}-spinner", props.className),
+        ref: forwardedRef,
+        children: [
+          /* @__PURE__ */ jsx("svg", { "aria-hidden": "true", className: "\u{1F95D}-spinner-svg", viewBox: "0 0 16 16", children: /* @__PURE__ */ jsx(
+            "path",
+            {
+              stroke: "currentColor",
+              "stroke-linecap": "round",
+              d: "M9.5 1.674a6.503 6.503 0 0 1 0 12.652m-3-12.652a6.503 6.503 0 0 0 0 12.652"
+            }
+          ) }),
+          /* @__PURE__ */ jsx(VisuallyHidden, { children: alt })
+        ]
+      }
+    );
+  }
+);
+DEV: Spinner.displayName = "Spinner";
+export {
+  Spinner
+};

package/dist/DEV/bricks/Switch.js

@@ -1,11 +1,12 @@
 import { jsx } from "react/jsx-runtime";
 import cx from "classnames";
 import * as Ariakit from "@ariakit/react";
-import { useFieldId } from "./Field.js";
+import { useFieldDescribedBy, useFieldId } from "./Field.js";
 import { forwardRef } from "./~utils.js";
 const Switch = forwardRef(
   (props, forwardedRef) => {
     const fieldId = useFieldId();
+    const describedBy = useFieldDescribedBy(props["aria-describedby"]);
     return /* @__PURE__ */ jsx(
       Ariakit.Checkbox,
       {
@@ -13,6 +14,7 @@ const Switch = forwardRef(
         id: fieldId,
         ...props,
         className: cx("\u{1F95D}-switch", props.className),
+        "aria-describedby": describedBy,
         role: "switch",
         ref: forwardedRef
       }

package/dist/DEV/bricks/Tabs.js

@@ -48,8 +48,8 @@ const TabList = forwardRef((props, forwardedRef) => {
   return /* @__PURE__ */ jsx(
     Ariakit.TabList,
     {
-      "data-kiwi-tone": tone,
       ...rest,
+      "data-kiwi-tone": tone,
       className: cx("\u{1F95D}-tab-list", props.className),
       style: {
         "--\u{1F95D}tab-active-stripe-view-transition-name": viewTransitionName,

package/dist/DEV/bricks/TextBox.js

@@ -2,13 +2,13 @@ import { jsx } from "react/jsx-runtime";
 import * as React from "react";
 import * as Ariakit from "@ariakit/react";
 import cx from "classnames";
-import { useFieldId } from "./Field.js";
+import { useFieldDescribedBy, useFieldId } from "./Field.js";
 import { Icon } from "./Icon.js";
-import { Textarea } from "./Textarea.js";
 import { useMergedRefs } from "./~hooks.js";
 import { forwardRef } from "./~utils.js";
 const TextBoxInput = forwardRef(
   (props, forwardedRef) => {
+    const describedBy = useFieldDescribedBy(props["aria-describedby"]);
     const fieldId = useFieldId();
     const rootContext = React.useContext(TextBoxRootContext);
     const setDisabled = rootContext?.setDisabled;
@@ -20,7 +20,9 @@ const TextBoxInput = forwardRef(
       {
         id: fieldId,
         ...props,
+        "aria-describedby": describedBy,
         className: cx({ "\u{1F95D}-text-box": !rootContext }, props.className),
+        placeholder: props.placeholder ?? " ",
         render: /* @__PURE__ */ jsx(
           Ariakit.Focusable,
           {
@@ -34,6 +36,31 @@ const TextBoxInput = forwardRef(
   }
 );
 DEV: TextBoxInput.displayName = "TextBox.Input";
+const TextBoxTextarea = forwardRef(
+  (props, forwardedRef) => {
+    const fieldId = useFieldId();
+    const describedBy = useFieldDescribedBy(props["aria-describedby"]);
+    return /* @__PURE__ */ jsx(
+      Ariakit.Role.textarea,
+      {
+        id: fieldId,
+        ...props,
+        className: cx("\u{1F95D}-text-box", props.className),
+        "aria-describedby": describedBy,
+        placeholder: props.placeholder ?? " ",
+        render: /* @__PURE__ */ jsx(
+          Ariakit.Focusable,
+          {
+            accessibleWhenDisabled: true,
+            render: props.render || /* @__PURE__ */ jsx("textarea", {})
+          }
+        ),
+        ref: forwardedRef
+      }
+    );
+  }
+);
+DEV: TextBoxTextarea.displayName = "TextBox.Textarea";
 const TextBoxRoot = forwardRef(
   (props, forwardedRef) => {
     const inputRef = React.useRef(null);
@@ -96,5 +123,5 @@ export {
   TextBoxInput as Input,
   TextBoxRoot as Root,
   TextBoxText as Text,
-  Textarea
+  TextBoxTextarea as Textarea
 };

package/dist/DEV/bricks/Tooltip.js

@@ -5,12 +5,12 @@ import * as Ariakit from "@ariakit/react";
 import { forwardRef, supportsPopover } from "./~utils.js";
 const Tooltip = forwardRef(
   (props, forwardedRef) => {
+    const generatedId = React.useId();
     const {
       content,
       children,
-      className,
       type = "description",
-      id = React.useId(),
+      id = generatedId,
       defaultOpen: defaultOpenProp,
       open: openProp,
       setOpen: setOpenProp,
@@ -53,7 +53,7 @@ const Tooltip = forwardRef(
               "aria-hidden": "true",
               ...rest,
               unmountOnHide,
-              className: cx("\u{1F95D}-tooltip", className),
+              className: cx("\u{1F95D}-tooltip", props.className),
               ref: forwardedRef,
               id,
               style: {