@itwin/itwinui-react 3.0.0-dev.6 → 3.0.0-dev.8

package/cjs/core/Tile/Tile.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import type { PolymorphicForwardRefComponent } from '../utils/index.js';
 import { IconButton } from '../Buttons/index.js';
-type TileOwnProps = {
+type TileWrapperOwnProps = {
     /**
      * Status of the tile.
      */
@@ -46,12 +46,119 @@ type TileNameOwnProps = {
 };
 type TileMoreOptionsOwnProps = {
     buttonProps?: React.ComponentPropsWithoutRef<typeof IconButton>;
-    children?: React.ReactElement[];
+    children?: React.ReactNode[];
+};
+type TileLegacyProps = {
+    /**
+     * Name or title of the tile.
+     */
+    name: React.ReactNode;
+    /**
+     * Description text of the tile.
+     * Gets truncated if it can't fit in the tile.
+     */
+    description?: React.ReactNode;
+    /**
+     * Metadata section located below description.
+     * @example
+     * <Tile
+     *  // ...
+     *  metadata='basic metadata'
+     *  // or
+     *  metadata={<span><SvgClock /> 2021-01-01, 04:30 AM</span>}
+     *  // or
+     *  metadata={<>
+     *    <SvgTag2 />
+     *    <TagContainer><Tag variant='basic'>Tag 1</Tag><Tag variant='basic'>Tag 2</Tag></TagContainer>
+     *  </>}
+     * />
+     */
+    metadata?: React.ReactNode;
+    /**
+     * Thumbnail image url, a custom component or an svg.
+     * @example
+     * <Tile
+     *  // ...
+     *  thumbnail='/url/to/image.jpg'
+     *  // or
+     *  thumbnail={<Avatar image={<img src='icon.png' />} />}
+     *  // or
+     *  thumbnail={<SvgImodelHollow />}
+     * />
+     */
+    thumbnail?: string | React.ReactNode;
+    /**
+     * `Badge` shown on the bottom right of thumbnail.
+     */
+    badge?: React.ReactNode;
+    /**
+     * Icon shown on top left of the tile. Also known as "type indicator".
+     * Recommended to use an invisible `IconButton`.
+     */
+    leftIcon?: React.ReactNode;
+    /**
+     * Icon shown on top right of the tile. Also known as "quick action".
+     * Recommended to use an invisible `IconButton`.
+     */
+    rightIcon?: React.ReactNode;
+    /**
+     * Upto two buttons shown at the bottom of the tile.
+     */
+    buttons?: [React.ReactNode?, React.ReactNode?];
+    /**
+     * Dropdown menu containing `MenuItem`s.
+     */
+    moreOptions?: React.ReactNode[];
+    /**
+     * Status of the tile.
+     */
+    status?: 'positive' | 'warning' | 'negative';
+    /**
+     * Whether the tile is selected or in "active" state.
+     * Gets highlighted and shows a checkmark icon near tile name.
+     */
+    isSelected?: boolean;
+    /**
+     * Whether the tile is "new". Tile name becomes bold and gets a new status icon.
+     */
+    isNew?: boolean;
+    /**
+     * Default tile variant or the folder layout.
+     * @default 'default'
+     */
+    variant?: 'default' | 'folder';
+    /**
+     * Any custom nodes that will be appended to the tile's main content.
+     */
+    children?: React.ReactNode;
+    /**
+     * Whether the tile is expected to be interactable (i.e. `onClick`).
+     * It becomes focusable and gets on hover styling.
+     */
+    isActionable?: boolean;
+    /**
+     * Display a loading state.
+     * @default false
+     */
+    isLoading?: boolean;
+    /**
+     * Flag whether the tile is disabled.
+     *
+     * Note: This only affects the tile. You need to manually disable
+     * the buttons and other interactive elements inside the tile.
+     *
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Adds onClick to the TileAction component.
+     */
+    onClick?: React.MouseEventHandler<HTMLElement>;
 };
 /**
  * Tile with customizable Thumbnail, Name, Content and Buttons subcomponents
  * @example
- * <Tile>
+ * <Tile.Wrapper>
  *    <Tile.ThumbnailArea>
  *      <Tile.ThumbnailPicture/>
  *      <Tile.Badge/>
@@ -61,23 +168,40 @@ type TileMoreOptionsOwnProps = {
  *    <Tile.Name>
  *      <Tile.NameIcon/>
  *      <Tile.NameLabel/>
- *    <Tile.Name/>
+ *    </Tile.Name>
  *    <Tile.ContentArea>
  *      <Tile.Description />
  *      <Tile.Metadata/>
  *      <Tile.MoreOptions/>
  *    </Tile.ContentArea>
  *    <Tile.Buttons/>
- * </Tile>
+ * </Tile.Wrapper>
+ *
+ * @example
+ *  <Tile
+ *  name='Tile name'
+ *  description='Tile description that takes upto 3 lines'
+ *  metadata={<TagContainer><Tag variant='basic'>Tag 1</Tag></TagContainer>}
+ *  thumbnail='/url/to/image.jpg'
+ *  badge={<Badge backgroundColor='blue'>Badge label</Badge>}
+ *  buttons={[<Button>Button 1</Button>, <Button>Button 2</Button>]}
+ *  moreOptions={[<MenuItem>Item 1</MenuItem>, <MenuItem>Item 2</MenuItem>]}
+ *  leftIcon={<IconButton><SvgInfo /></IconButton>}
+ *  rightIcon={<IconButton><SvgStar /></IconButton>}
+ *  isSelected={true}
+ *  isNew={false}
+ * />
  */
-export declare const Tile: PolymorphicForwardRefComponent<"div", TileOwnProps> & {
+export declare const Tile: PolymorphicForwardRefComponent<"div", TileLegacyProps> & {
+    /**
+     * Wrapper subcomponent for fully customisable Tile.
+     */
+    Wrapper: PolymorphicForwardRefComponent<"div", TileWrapperOwnProps>;
     /**
      * ThumbnailArea subcomponent that contains `ThumbnailPicture`, `QuickAction`, `TypeIndicator` or `BadgeContainer`
      * @example
      * <Tile.ThumbnailArea>
      *    <Tile.ThumbnailPicture/>
-     *    // or
-     *    <Tile.ThumbnailAvatar/>
      *    <Tile.QuickAction/>
      *    <Tile.TypeIndicator/>
      *    <Tile.BadgeContainer/>
@@ -87,14 +211,14 @@ export declare const Tile: PolymorphicForwardRefComponent<"div", TileOwnProps> &
     /**
      * Thumbnail image url, a custom component or an svg for thumbnail avatar.
      * @example
-     * <Tile>
+     * <Tile.Wrapper>
      *  // ...
      *  <Tile.ThumbnailArea>
      *    <Tile.ThumbnailPicture url = '/url/to/image.jpg'/>
      *  </Tile.ThumbnailArea>
-     * </Tile>
+     * </Tile.Wrapper>
      * or
-     * <Tile>
+     * <Tile.Wrapper>
      *  // ...
      *  <Tile.ThumbnailArea>
      *    <Tile.ThumbnailPicture>
@@ -125,10 +249,11 @@ export declare const Tile: PolymorphicForwardRefComponent<"div", TileOwnProps> &
      */
     IconButton: PolymorphicForwardRefComponent<"button", Omit<Omit<Omit<React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref"> & {
         ref?: ((instance: HTMLButtonElement | null) => void) | React.RefObject<HTMLButtonElement> | null | undefined;
-    }, "label" | "as" | "size" | "styleType" | "isActive"> & {
+    }, "label" | "as" | "size" | "htmlDisabled" | "styleType" | "isActive" | "iconProps"> & {
         isActive?: boolean | undefined;
         label?: React.ReactNode;
-    } & Omit<import("../Buttons/Button/Button.js").ButtonProps, "startIcon" | "endIcon"> & {
+        iconProps?: React.DetailedHTMLProps<React.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement> | undefined;
+    } & Omit<import("../Buttons/Button/Button.js").ButtonProps, "startIcon" | "endIcon" | "labelProps" | "startIconProps" | "endIconProps"> & {
         as?: "button" | undefined;
     }, "ref">>;
     /**
@@ -138,11 +263,11 @@ export declare const Tile: PolymorphicForwardRefComponent<"div", TileOwnProps> &
     /**
      * `NameIcon` next to name of the tile. Goes under <Tile.Name>
      * @example
-     * <Tile>
+     * <Tile.Wrapper>
      *  <Tile.Name>
      *    <Tile.NameIcon/>
      *  </Tile.Name>
-     * <Tile/>
+     * </Tile.Wrapper>
      */
     NameIcon: PolymorphicForwardRefComponent<"div", {}>;
     NameLabel: PolymorphicForwardRefComponent<"span", {}>;
@@ -160,13 +285,13 @@ export declare const Tile: PolymorphicForwardRefComponent<"div", TileOwnProps> &
     /**
      * Tile content area that contains `Description`, `Metadata` and `MoreOptions` Tile subcomponents
      * @example
-     * <Tile>
+     * <Tile.Wrapper>
      *  <Tile.ContentArea>
      *    <Tile.Description/>
      *    <Tile.Metadata/>
      *    <Tile.MoreOptions/>
      *  </Tile.ContentArea>
-     * </Tile>
+     * </Tile.Wrapper>
      */
     ContentArea: PolymorphicForwardRefComponent<NonNullable<keyof JSX.IntrinsicElements>, {}>;
     /**

package/cjs/core/Tile/Tile.js

@@ -14,7 +14,7 @@ const index_js_3 = require('../Buttons/index.js');
 const index_js_4 = require('../ProgressIndicators/index.js');
 const TileContext = React.createContext(undefined);
 TileContext.displayName = 'TileContext';
-const TileComponent = React.forwardRef((props, forwardedRef) => {
+const TileWrapper = React.forwardRef((props, forwardedRef) => {
   const {
     className,
     status,
@@ -60,7 +60,7 @@ const TileComponent = React.forwardRef((props, forwardedRef) => {
     }),
   );
 });
-TileComponent.displayName = 'Tile';
+TileWrapper.displayName = 'Tile.Wrapper';
 // ----------------------------------------------------------------------------
 // Tile.Action component
 const TileAction = React.forwardRef((props, forwardedRef) => {
@@ -272,10 +272,84 @@ TileMoreOptions.displayName = 'Tile.MoreOptions';
 // Tile.Buttons component
 const TileButtons = (0, index_js_1.polymorphic)('iui-tile-buttons');
 TileButtons.displayName = 'Tile.Buttons';
+const TileComponent = React.forwardRef((props, forwardedRef) => {
+  const {
+    name,
+    description,
+    status,
+    isNew,
+    isLoading,
+    isSelected,
+    thumbnail,
+    badge,
+    leftIcon,
+    rightIcon,
+    buttons,
+    metadata,
+    moreOptions,
+    children,
+    isActionable,
+    isDisabled,
+    onClick,
+    ...rest
+  } = props;
+  return React.createElement(
+    TileWrapper,
+    {
+      ref: forwardedRef,
+      isNew: isNew,
+      isSelected: isSelected,
+      isLoading: isLoading,
+      status: status,
+      isDisabled: isDisabled,
+      ...rest,
+    },
+    React.createElement(
+      TileName,
+      null,
+      (status || isNew || isLoading || isSelected) &&
+        React.createElement(TileNameIcon, null),
+      React.createElement(
+        TileNameLabel,
+        null,
+        isActionable
+          ? React.createElement(
+              TileAction,
+              {
+                onClick: !isDisabled ? onClick : undefined,
+                'aria-disabled': isDisabled,
+              },
+              name,
+            )
+          : name,
+      ),
+    ),
+    React.createElement(
+      TileThumbnailArea,
+      null,
+      typeof thumbnail !== 'string'
+        ? React.createElement(TileThumbnailPicture, null, thumbnail)
+        : React.createElement(TileThumbnailPicture, { url: thumbnail }),
+      badge && React.createElement(TileBadgeContainer, null, badge),
+      leftIcon && React.createElement(TileTypeIndicator, null, leftIcon),
+      rightIcon && React.createElement(TileQuickAction, null, rightIcon),
+    ),
+    React.createElement(
+      TileContentArea,
+      null,
+      description && React.createElement(TileDescription, null, description),
+      moreOptions && React.createElement(TileMoreOptions, null, moreOptions),
+      metadata && React.createElement(TileMetadata, null, metadata),
+      children,
+    ),
+    buttons && React.createElement(TileButtons, null, buttons),
+  );
+});
+TileComponent.displayName = 'Tile';
 /**
  * Tile with customizable Thumbnail, Name, Content and Buttons subcomponents
  * @example
- * <Tile>
+ * <Tile.Wrapper>
  *    <Tile.ThumbnailArea>
  *      <Tile.ThumbnailPicture/>
  *      <Tile.Badge/>
@@ -285,23 +359,40 @@ TileButtons.displayName = 'Tile.Buttons';
  *    <Tile.Name>
  *      <Tile.NameIcon/>
  *      <Tile.NameLabel/>
- *    <Tile.Name/>
+ *    </Tile.Name>
  *    <Tile.ContentArea>
  *      <Tile.Description />
  *      <Tile.Metadata/>
  *      <Tile.MoreOptions/>
  *    </Tile.ContentArea>
  *    <Tile.Buttons/>
- * </Tile>
+ * </Tile.Wrapper>
+ *
+ * @example
+ *  <Tile
+ *  name='Tile name'
+ *  description='Tile description that takes upto 3 lines'
+ *  metadata={<TagContainer><Tag variant='basic'>Tag 1</Tag></TagContainer>}
+ *  thumbnail='/url/to/image.jpg'
+ *  badge={<Badge backgroundColor='blue'>Badge label</Badge>}
+ *  buttons={[<Button>Button 1</Button>, <Button>Button 2</Button>]}
+ *  moreOptions={[<MenuItem>Item 1</MenuItem>, <MenuItem>Item 2</MenuItem>]}
+ *  leftIcon={<IconButton><SvgInfo /></IconButton>}
+ *  rightIcon={<IconButton><SvgStar /></IconButton>}
+ *  isSelected={true}
+ *  isNew={false}
+ * />
  */
 exports.Tile = Object.assign(TileComponent, {
+  /**
+   * Wrapper subcomponent for fully customisable Tile.
+   */
+  Wrapper: TileWrapper,
   /**
    * ThumbnailArea subcomponent that contains `ThumbnailPicture`, `QuickAction`, `TypeIndicator` or `BadgeContainer`
    * @example
    * <Tile.ThumbnailArea>
    *    <Tile.ThumbnailPicture/>
-   *    // or
-   *    <Tile.ThumbnailAvatar/>
    *    <Tile.QuickAction/>
    *    <Tile.TypeIndicator/>
    *    <Tile.BadgeContainer/>
@@ -311,14 +402,14 @@ exports.Tile = Object.assign(TileComponent, {
   /**
    * Thumbnail image url, a custom component or an svg for thumbnail avatar.
    * @example
-   * <Tile>
+   * <Tile.Wrapper>
    *  // ...
    *  <Tile.ThumbnailArea>
    *    <Tile.ThumbnailPicture url = '/url/to/image.jpg'/>
    *  </Tile.ThumbnailArea>
-   * </Tile>
+   * </Tile.Wrapper>
    * or
-   * <Tile>
+   * <Tile.Wrapper>
    *  // ...
    *  <Tile.ThumbnailArea>
    *    <Tile.ThumbnailPicture>
@@ -355,21 +446,21 @@ exports.Tile = Object.assign(TileComponent, {
   /**
    * `NameIcon` next to name of the tile. Goes under <Tile.Name>
    * @example
-   * <Tile>
+   * <Tile.Wrapper>
    *  <Tile.Name>
    *    <Tile.NameIcon/>
    *  </Tile.Name>
-   * <Tile/>
+   * </Tile.Wrapper>
    */
   NameIcon: TileNameIcon,
   /*
    * `NameLabel` of the tile
    * @example
-   * <Tile>
+   * <Tile.Wrapper>
    *  <Tile.Name>
    *    <Tile.NameLabel> Tile Name <Tile.NameLabel/>
    *  </Tile.Name/>
-   * <Tile/>
+   * </Tile.Wrapper>
    */
   NameLabel: TileNameLabel,
   /**
@@ -386,13 +477,13 @@ exports.Tile = Object.assign(TileComponent, {
   /**
    * Tile content area that contains `Description`, `Metadata` and `MoreOptions` Tile subcomponents
    * @example
-   * <Tile>
+   * <Tile.Wrapper>
    *  <Tile.ContentArea>
    *    <Tile.Description/>
    *    <Tile.Metadata/>
    *    <Tile.MoreOptions/>
    *  </Tile.ContentArea>
-   * </Tile>
+   * </Tile.Wrapper>
    */
   ContentArea: TileContentArea,
   /**

package/cjs/core/Toast/Toast.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { CommonProps } from '../utils/index.js';
+import type { PolymorphicForwardRefComponent } from '../utils/index.js';
 export type ToastCategory = 'informational' | 'negative' | 'positive' | 'warning';
 export type ToastProps = {
     /**
@@ -10,6 +10,13 @@ export type ToastProps = {
      * Content of the Toast message
      */
     content: React.ReactNode;
+    /**
+     * Passes props to toast and content
+     */
+    domProps?: {
+        toastProps?: React.ComponentProps<'div'>;
+        contentProps?: React.ComponentProps<'div'>;
+    };
     /**
      * Category of the Toast, which controls the border color, as well as the category icon.
      */
@@ -60,12 +67,13 @@ export type ToastProps = {
  * <Toast type='persisting' content='Job processing error.' category='negative' />
  */
 export declare const Toast: (props: ToastProps) => React.JSX.Element;
-export type ToastPresentationProps = Omit<ToastProps, 'duration' | 'id' | 'isVisible' | 'onRemove'> & {
+export type ToastPresentationProps = Omit<ToastProps, 'duration' | 'id' | 'isVisible' | 'onRemove' | 'domProps'> & {
     onClose?: () => void;
-} & CommonProps;
+    contentProps?: React.ComponentProps<'div'>;
+};
 /**
  * The presentational part of a toast, without any animation or logic.
  * @private
  */
-export declare const ToastPresentation: (props: ToastPresentationProps) => React.JSX.Element;
+export declare const ToastPresentation: PolymorphicForwardRefComponent<"div", ToastPresentationProps>;
 export default Toast;

package/cjs/core/Toast/Toast.js

@@ -35,6 +35,7 @@ const Toast = (props) => {
     hasCloseButton,
     onRemove,
     animateOutTo,
+    domProps,
   } = props;
   const closeTimeout = React.useRef(0);
   const { placement } = (0, index_js_1.useSafeContext)(
@@ -48,9 +49,9 @@ const Toast = (props) => {
   const [margin, setMargin] = React.useState(0);
   const marginStyle = () => {
     if (placementPosition === 'top') {
-      return { marginBottom: margin };
+      return { marginBlockEnd: margin };
     }
-    return { marginTop: margin };
+    return { marginBlockStart: margin };
   };
   React.useEffect(() => {
     if (type === 'temporary') {
@@ -149,12 +150,15 @@ const Toast = (props) => {
         'div',
         { ref: onRef },
         React.createElement(exports.ToastPresentation, {
+          as: 'div',
           category: category,
           content: content,
           link: link,
           type: type,
           hasCloseButton: hasCloseButton,
           onClose: close,
+          ...domProps?.toastProps,
+          contentProps: domProps?.contentProps,
         }),
       ),
     ),
@@ -165,7 +169,7 @@ exports.Toast = Toast;
  * The presentational part of a toast, without any animation or logic.
  * @private
  */
-const ToastPresentation = (props) => {
+exports.ToastPresentation = React.forwardRef((props, forwardedRef) => {
   const {
     content,
     category,
@@ -174,6 +178,7 @@ const ToastPresentation = (props) => {
     hasCloseButton,
     onClose,
     className,
+    contentProps,
     ...rest
   } = props;
   const StatusIcon = index_js_1.StatusIconMap[category];
@@ -184,6 +189,7 @@ const ToastPresentation = (props) => {
         `iui-toast iui-${category}`,
         className,
       ),
+      ref: forwardedRef,
       ...rest,
     },
     React.createElement(
@@ -191,16 +197,22 @@ const ToastPresentation = (props) => {
       { className: 'iui-status-area' },
       React.createElement(StatusIcon, { className: 'iui-icon' }),
     ),
-    React.createElement(index_js_1.Box, { className: 'iui-message' }, content),
+    React.createElement(
+      index_js_1.Box,
+      {
+        as: 'div',
+        ...contentProps,
+        className: (0, classnames_1.default)(
+          'iui-message',
+          contentProps?.className,
+        ),
+      },
+      content,
+    ),
     link &&
       React.createElement(
-        index_js_1.Box,
-        {
-          as: 'button',
-          className: 'iui-toast-anchor',
-          ...link,
-          title: undefined,
-        },
+        index_js_1.ButtonBase,
+        { className: 'iui-toast-anchor', ...link, title: undefined },
         link.title,
       ),
     (type === 'persisting' || hasCloseButton) &&
@@ -215,6 +227,5 @@ const ToastPresentation = (props) => {
         React.createElement(index_js_1.SvgCloseSmall, null),
       ),
   );
-};
-exports.ToastPresentation = ToastPresentation;
+});
 exports.default = exports.Toast;

package/cjs/core/Tooltip/Tooltip.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { Placement } from '@floating-ui/react';
-import type { PolymorphicForwardRefComponent } from '../utils/index.js';
+import type { PolymorphicForwardRefComponent, PortalProps } from '../utils/index.js';
 type TooltipOptions = {
     /**
      * Placement of the Tooltip
@@ -11,6 +11,11 @@ type TooltipOptions = {
      * Property for manual visibility control
      */
     visible?: boolean;
+    /**
+     * Callback invoked every time the tooltip visibility changes as a result
+     * of internal logic. Should be used alongside `visible` prop.
+     */
+    onVisibleChange?: (visible: boolean) => void;
     /**
      * autoUpdate options that recalculates position
      * to ensure the floating element remains anchored
@@ -42,34 +47,26 @@ type TooltipOptions = {
         hide?: boolean;
         inline?: boolean;
     };
-};
-type TooltipOwnProps = {
-    /**
-     * Content of the tooltip.
-     */
-    content: React.ReactNode;
-    /**
-     * Element to have tooltip on. Has to be a valid JSX element and needs to forward its ref.
-     * If not specified, the `reference` prop should be used instead.
-     */
-    children?: React.ReactNode;
-    /**
-     * Element to portal tooltip to.
-     * Portals to ThemeProvider portalContainerRef by default.
-     * @default true;
-     */
-    portal?: boolean | {
-        to: HTMLElement;
-    };
     /**
      * Sets reference point to user provided element.
      * @example
-     * const buttonRef = React.useRef();
+     * const [trigger, setTrigger] = React.useState(null);
      * ...
-     * <Button ref={buttonRef} />
-     * <Tooltip content='tooltip text' reference={buttonRef} />
+     * <Button ref={setTrigger} />
+     * <Tooltip content='tooltip text' reference={trigger} />
      */
-    reference?: React.RefObject<HTMLElement>;
+    reference?: HTMLElement | null;
+    /**
+     * By default, the tooltip will be associated with the reference element
+     * using `aria-describedby`.
+     *
+     * Pass "label" if you want to use `aria-labelledby` instead, or pass "none"
+     * if you don't want any association.
+     *
+     * @default 'description'
+     */
+    ariaStrategy?: 'description' | 'label' | 'none';
+    id?: string;
 };
 /**
  * Basic tooltip component to display informative content when an element is hovered or focused.
@@ -77,10 +74,20 @@ type TooltipOwnProps = {
  * @example
  * <Tooltip content='tooltip text' placement='top'>Hover here</Tooltip>
  * @example
- * const buttonRef = React.useRef();
+ * const [trigger, setTrigger] = React.useState(null);
  * ...
- * <Button ref={buttonRef} />
- * <Tooltip content='tooltip text' reference={buttonRef} />
+ * <Button ref={setTrigger} />
+ * <Tooltip content='tooltip text' reference={trigger} />
  */
-export declare const Tooltip: PolymorphicForwardRefComponent<"div", TooltipOwnProps & TooltipOptions>;
+export declare const Tooltip: PolymorphicForwardRefComponent<"div", {
+    /**
+     * Content of the tooltip.
+     */
+    content: React.ReactNode;
+    /**
+     * Element to have tooltip on. Has to be a valid JSX element and needs to forward its ref.
+     * If not specified, the `reference` prop should be used instead.
+     */
+    children?: React.ReactNode;
+} & PortalProps & TooltipOptions>;
 export default Tooltip;