@carbon-labs/react-ui-shell 0.50.0 → 0.51.0

package/es/node_modules/@carbon/ibm-products/es/settings.js

@@ -0,0 +1,84 @@
+/**
+ * Copyright IBM Corp. 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import pkg$1 from './global/js/package-settings.js';
+import React from 'react';
+import pconsole from './global/js/utils/pconsole.js';
+import { Canary } from './components/_Canary/Canary.js';
+
+const componentDeprecatedWarning = (name, details) => `Carbon for IBM Products (WARNING): Component "${name}" is deprecated. ${details}`;
+pkg$1.logDeprecated = (component, name) => {
+  if (component?.deprecated) {
+    const {
+      level,
+      details
+    } = component.deprecated;
+    const logUsing = pconsole?.[level] ?? pconsole.error;
+    logUsing(componentDeprecatedWarning(name || component.displayName, details));
+  }
+};
+
+// Check that a component is enabled. This function returns a stub which checks
+// the component status on first use and then renders as the component or as
+// a Canary placeholder initialized with the name of the replaced component.
+// Note that the returned stub carries any other properties which had already
+// been assigned (eg propTypes, displayName, etc).
+pkg$1.checkComponentEnabled = (component, name) => {
+  if (component.render) {
+    // The component is a forward-ref, so make a stub forward-ref.
+    const forward = /*#__PURE__*/React.forwardRef((props, ref) => {
+      pkg$1.logDeprecated(component, name); // may log don't care about result
+      // Replace the stub's render fn so this test only happens once.
+      return (forward.render = pkg$1.isComponentEnabled(name) || !pkg$1.isComponentPublic(name) ?
+      // If the component is enabled, or if it's not a public component,
+      // replace the stub's render fn with the component's render fn.
+      component.render :
+      // Note that Canary is a direct render fn (not a forward-ref) and
+      // will ignore the passed props and ref (if any)
+      Canary.bind(undefined, {
+        componentName: name
+      }))(
+      // Call it now (after this it will be directly called).
+      props, ref);
+    });
+
+    // Transfer object properties already assigned (eg propTypes, displayName)
+    // then merge in the stub forward-ref which checks the component status
+    // when first used.
+    // NOTE: React 18 = displayName not iterable on render function
+    return Object.assign({}, component, {
+      displayName: component.displayName
+    }, forward);
+  } else {
+    // The component is a direct render fn, so make a stub render fn.
+    let render = props => {
+      pkg$1.logDeprecated(component, name); // may log don't care about result
+      // Replace the stub render fn so this test only happens once.
+      return (render = pkg$1.isComponentEnabled(name) || !pkg$1.isComponentPublic(name) ?
+      // If the component is enabled, or if it's not a public component,
+      // replace the stub render fn with the component render fn.
+      component :
+      // Replace the stub render fn with the Canary render fn, which will
+      // ignore the passed props.
+      Canary.bind(undefined, {
+        componentName: name
+      }))(
+      // Call it now (after this it will be directly called).
+      props);
+    };
+
+    // Transfer object properties already assigned (eg propTypes, displayName)
+    // to a function which calls the stub render fn which checks the component
+    // status when first used.
+    return Object.assign(props => render(props), component, {
+      displayName: component.displayName
+    });
+  }
+};
+const pkg = pkg$1;
+
+export { pkg };

package/lib/components/Profile.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @license
+ *
+ * Copyright IBM Corp. 2025
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+interface ProfileProps {
+    /**
+     * Provide an optional class to be applied to the containing node
+     */
+    className?: string;
+    /**
+     * Custom children to be rendered within the popover of the Profile menu
+     */
+    children?: React.ReactNode;
+    /**
+     * Provide the Profile's label
+     */
+    label?: string;
+    /**
+     * Provide an optional icon to render in Profile.
+     */
+    renderIcon?: React.ReactNode;
+}
+declare const Profile: React.ForwardRefExoticComponent<ProfileProps & React.RefAttributes<HTMLDivElement>>;
+interface ProfileUserInfoProps {
+    /**
+     * Provide an optional class to be applied to the containing node
+     */
+    className?: string;
+    /**
+     * Provide the user's email
+     */
+    email?: string;
+    /**
+     * When passing the name prop, either send the initials to be used or the user's full name. The first two capital letters of the user's name will be used as the name.
+     */
+    name: string;
+}
+declare const ProfileUserInfo: React.ForwardRefExoticComponent<ProfileUserInfoProps & React.RefAttributes<HTMLDivElement>>;
+interface ProfileReadOnlyItem {
+    label: string;
+    title: string;
+}
+interface ProfileReadOnlyProps {
+    /**
+     * Provide an optional class to be applied to the containing node
+     */
+    className?: string;
+    /**
+     * List of read-only profile items
+     */
+    items?: ProfileReadOnlyItem[];
+}
+declare const ProfileReadOnly: React.ForwardRefExoticComponent<ProfileReadOnlyProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * -------
+ * Exports
+ * -------
+ */
+declare const Root: React.ForwardRefExoticComponent<ProfileProps & React.RefAttributes<HTMLDivElement>>;
+declare const UserInfo: React.ForwardRefExoticComponent<ProfileUserInfoProps & React.RefAttributes<HTMLDivElement>>;
+declare const ReadOnly: React.ForwardRefExoticComponent<ProfileReadOnlyProps & React.RefAttributes<HTMLDivElement>>;
+export { Profile, ProfileUserInfo, ProfileReadOnly, Root, UserInfo, ReadOnly, };
+export type { ProfileProps, ProfileUserInfoProps };

package/lib/components/Profile.js

@@ -0,0 +1,148 @@
+/**
+ * Copyright IBM Corp. 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+var _rollupPluginBabelHelpers = require('../_virtual/_rollupPluginBabelHelpers.js');
+var index = require('../_virtual/index.js');
+var PropTypes = require('prop-types');
+var React = require('react');
+var usePrefix = require('../internal/usePrefix.js');
+var HeaderPopover = require('./HeaderPopover.js');
+var UserAvatar = require('../node_modules/@carbon/ibm-products/es/components/UserAvatar/UserAvatar.js');
+
+const Profile = /*#__PURE__*/React.forwardRef(function Profile(_ref) {
+  let {
+    className: customClassName,
+    label,
+    children,
+    renderIcon: IconElement
+  } = _ref;
+  const prefix = usePrefix.usePrefix();
+  const className = index.default({
+    [`${prefix}-profile`]: true,
+    [customClassName]: !!customClassName
+  });
+  return /*#__PURE__*/React.createElement(HeaderPopover.HeaderPopover, {
+    align: "bottom-right",
+    className: className
+  }, /*#__PURE__*/React.createElement(HeaderPopover.HeaderPopoverButton, {
+    align: "bottom",
+    label: label
+  }, IconElement), /*#__PURE__*/React.createElement(HeaderPopover.HeaderPopoverContent, null, children));
+});
+Profile.displayName = 'Profile';
+Profile.propTypes = {
+  /**
+   * Custom children to be rendered within the popover of the Profile menu
+   */
+  children: PropTypes.any,
+  /**
+   * Provide an optional class to be applied to the containing node
+   */
+  className: PropTypes.string,
+  /**
+   * Provide the Profile's label
+   */
+  label: PropTypes.string,
+  /**
+   * Provide an optional icon to render in Profile.
+   */
+  // @ts-expect-error - PropTypes are unable to cover this case.
+  renderIcon: PropTypes.oneOfType([PropTypes.func, PropTypes.object])
+};
+const ProfileUserInfo = /*#__PURE__*/React.forwardRef(function ProfileUserInfo(_ref2) {
+  let {
+    className: customClassName,
+    name,
+    email,
+    ...rest
+  } = _ref2;
+  const prefix = usePrefix.usePrefix();
+  const className = index.default({
+    [`${prefix}--profile-user-info`]: true,
+    [customClassName]: !!customClassName
+  });
+  return /*#__PURE__*/React.createElement("div", {
+    className: className
+  }, /*#__PURE__*/React.createElement(UserAvatar.UserAvatar, _rollupPluginBabelHelpers.extends({
+    size: "lg",
+    name: name
+  }, rest)), /*#__PURE__*/React.createElement("div", {
+    className: `${prefix}--profile-user-info__text-wrapper`
+  }, /*#__PURE__*/React.createElement("div", {
+    className: `${prefix}--profile-user-info__name`
+  }, name), /*#__PURE__*/React.createElement("div", {
+    className: `${prefix}--profile-user-info__email`
+  }, email)));
+});
+ProfileUserInfo.displayName = 'ProfileUserInfo';
+ProfileUserInfo.propTypes = {
+  /**
+   * Provide an optional class to be applied to the containing node
+   */
+  className: PropTypes.string,
+  /**
+   * Provide the user's email
+   */
+  email: PropTypes.string,
+  /**
+   * When passing the name prop, either send the initials to be used or the user's full name. The first two capital letters of the user's name will be used as the name.
+   */
+  name: PropTypes.string.isRequired
+};
+const ProfileReadOnly = /*#__PURE__*/React.forwardRef(function ProfileReadOnly(_ref3) {
+  let {
+    className: customClassName,
+    items
+  } = _ref3;
+  const prefix = usePrefix.usePrefix();
+  const className = index.default({
+    [`${prefix}--profile-read-only`]: true,
+    [customClassName]: !!customClassName
+  });
+  return /*#__PURE__*/React.createElement("div", {
+    className: className
+  }, items?.map((item, index) => /*#__PURE__*/React.createElement("div", {
+    className: `${prefix}--profile-read-only__items`,
+    key: index
+  }, /*#__PURE__*/React.createElement("div", {
+    className: `${prefix}--profile-read-only__label`
+  }, item.label), /*#__PURE__*/React.createElement("div", {
+    className: `${prefix}--profile-read-only__title`
+  }, item.title))));
+});
+ProfileReadOnly.displayName = 'ProfileReadOnly';
+ProfileReadOnly.propTypes = {
+  /**
+   * Provide an optional class to be applied to the containing node
+   */
+  className: PropTypes.string,
+  /**
+   * List of read-only profile items
+   */
+  items: PropTypes.array
+};
+
+/**
+ * -------
+ * Exports
+ * -------
+ */
+const Root = Profile;
+Root.displayName = 'Profile.Root';
+const UserInfo = ProfileUserInfo;
+UserInfo.displayName = 'ProfileUserInfo';
+const ReadOnly = ProfileReadOnly;
+ReadOnly.displayName = 'ProfileReadOnly';
+
+exports.Profile = Profile;
+exports.ProfileReadOnly = ProfileReadOnly;
+exports.ProfileUserInfo = ProfileUserInfo;
+exports.ReadOnly = ReadOnly;
+exports.Root = Root;
+exports.UserInfo = UserInfo;

package/lib/components/SideNavLinkPopover.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright IBM Corp. 2016, 2023
+ * Copyright IBM Corp. 2016, 2025
  *
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
@@ -62,7 +62,7 @@ interface IconButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>
     /**
      * Specify the size of the Button. Defaults to `md`.
      */
-    size?: ButtonSize;
+    size?: Extract<ButtonSize, 'sm' | 'md' | 'lg'>;
     /**
      * Specify an optional className to be added to your Tooltip wrapper
      */

package/lib/index.d.ts

@@ -6,16 +6,17 @@
  * This source code is licensed under the Apache-2.0 license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export { SideNav, SIDE_NAV_TYPE } from './components/SideNav.js';
-export { SideNavItems } from './components/SideNavItems.js';
-export { SideNavLink } from './components/SideNavLink.js';
-export { SideNavLinkPopover } from './components/SideNavLinkPopover.js';
-export { SideNavMenu } from './components/SideNavMenu.js';
-export { SideNavMenuItem } from './components/SideNavMenuItem.js';
+export { SideNav, SIDE_NAV_TYPE } from './components/SideNav';
+export { SideNavItems } from './components/SideNavItems';
+export { SideNavLink } from './components/SideNavLink';
+export { SideNavLinkPopover } from './components/SideNavLinkPopover';
+export { SideNavMenu } from './components/SideNavMenu';
+export { SideNavMenuItem } from './components/SideNavMenuItem';
 export { HeaderContainer } from './components/HeaderContainer';
 export { HeaderPopover, HeaderPopoverActions, HeaderPopoverButton, HeaderPopoverContent, } from './components/HeaderPopover';
 export { HeaderPanel } from './components/HeaderPanel';
 export { SharkFinIcon } from './components/SharkFinIcon';
 export { HeaderDivider } from './components/HeaderDivider';
 export { TrialCountdown } from './components/TrialCountdown';
+export * as Profile from './components/Profile';
 export { SideNavSlot } from './components/SideNavSlot';

package/lib/index.js

@@ -19,6 +19,7 @@ var HeaderPanel = require('./components/HeaderPanel.js');
 var SharkFinIcon = require('./components/SharkFinIcon.js');
 var HeaderDivider = require('./components/HeaderDivider.js');
 var TrialCountdown = require('./components/TrialCountdown.js');
+var Profile = require('./components/Profile.js');
 var SideNavSlot = require('./components/SideNavSlot.js');
 
 
@@ -39,4 +40,5 @@ exports.HeaderPanel = HeaderPanel.HeaderPanel;
 exports.SharkFinIcon = SharkFinIcon.SharkFinIcon;
 exports.HeaderDivider = HeaderDivider.HeaderDivider;
 exports.TrialCountdown = TrialCountdown.TrialCountdown;
+exports.Profile = Profile;
 exports.SideNavSlot = SideNavSlot.SideNavSlot;

package/lib/node_modules/@carbon/ibm-products/es/_virtual/_commonjsHelpers.js

@@ -0,0 +1,14 @@
+/**
+ * Copyright IBM Corp. 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+function getDefaultExportFromCjs(x) {
+  return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
+}
+
+exports.getDefaultExportFromCjs = getDefaultExportFromCjs;

package/lib/node_modules/@carbon/ibm-products/es/_virtual/_rollupPluginBabelHelpers.js

@@ -0,0 +1,20 @@
+/**
+ * Copyright IBM Corp. 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+function _extends() {
+  return _extends = Object.assign ? Object.assign.bind() : function (n) {
+    for (var e = 1; e < arguments.length; e++) {
+      var t = arguments[e];
+      for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]);
+    }
+    return n;
+  }, _extends.apply(null, arguments);
+}
+
+exports.extends = _extends;

package/lib/node_modules/@carbon/ibm-products/es/_virtual/index.js

@@ -0,0 +1,19 @@
+/**
+ * Copyright IBM Corp. 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var _commonjsHelpers = require('./_commonjsHelpers.js');
+var index = require('../node_modules/prop-types/index.js');
+
+var propTypesExports = /*@__PURE__*/index.__require();
+var PropTypes = /*@__PURE__*/_commonjsHelpers.getDefaultExportFromCjs(propTypesExports);
+
+exports.default = PropTypes;
+exports.p = propTypesExports;

package/lib/node_modules/@carbon/ibm-products/es/_virtual/index2.js

@@ -0,0 +1,14 @@
+/**
+ * Copyright IBM Corp. 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+var propTypes = {
+  exports: {}
+};
+
+exports.__module = propTypes;

package/lib/node_modules/@carbon/ibm-products/es/components/TooltipTrigger/TooltipTrigger.js

@@ -0,0 +1,63 @@
+/**
+ * Copyright IBM Corp. 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var React = require('react');
+var index$1 = require('../../_virtual/index.js');
+var index = require('../../../../../../_virtual/index.js');
+var settings = require('../../settings.js');
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+const blockClass = `${settings.pkg.prefix}--tooltip-trigger`;
+const componentName = 'TooltipTrigger';
+
+// NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+/**
+ * This is an tooltip trigger as Carbon Tooltip requires an active element to work but provides
+ * no blanked button.
+ */
+exports.TooltipTrigger = /*#__PURE__*/React.forwardRef((_ref, ref) => {
+  let {
+    children,
+    className,
+    // Collect any other property values passed in.
+    ...rest
+  } = _ref;
+  return /*#__PURE__*/React.createElement("button", _rollupPluginBabelHelpers.extends({
+    type: "button",
+    ref: ref
+  }, rest, {
+    className: index.default(blockClass,
+    // Apply the block class to the main HTML element
+    className // Apply any supplied class names to the main HTML element.
+    )
+  }), children);
+});
+
+// Return a placeholder if not released and not enabled by feature flag.
+exports.TooltipTrigger = settings.pkg.checkComponentEnabled(exports.TooltipTrigger, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+exports.TooltipTrigger.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+exports.TooltipTrigger.propTypes = {
+  /**
+   * Child content of tooltip trigger
+   */
+  children: index$1.default.node,
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: index$1.default.string
+};

package/lib/node_modules/@carbon/ibm-products/es/components/UserAvatar/UserAvatar.js

@@ -0,0 +1,170 @@
+/**
+ * Copyright IBM Corp. 2024
+ *
+ * This source code is licensed under the Apache-2.0 license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+'use strict';
+
+var _rollupPluginBabelHelpers = require('../../_virtual/_rollupPluginBabelHelpers.js');
+var React = require('react');
+var index = require('../../_virtual/index.js');
+var index$1 = require('../../../../../../_virtual/index.js');
+var devtools = require('../../global/js/utils/devtools.js');
+var settings = require('../../settings.js');
+var react = require('@carbon/react');
+var icons = require('@carbon/react/icons');
+require('../../global/js/utils/props-helper.js');
+var TooltipTrigger = require('../TooltipTrigger/TooltipTrigger.js');
+
+// Carbon and package components we use.
+/* TODO: @import(s) of carbon components and other package components. */
+
+// The block part of our conventional BEM class names (blockClass__E--M).
+const blockClass = `${settings.pkg.prefix}--user-avatar`;
+const componentName = 'UserAvatar';
+
+// NOTE: the component SCSS is not imported here: it is rolled up separately.
+
+/**
+ * TODO: A description of the component.
+ */
+
+exports.UserAvatar = /*#__PURE__*/React.forwardRef((_ref, ref) => {
+  let {
+    // The component props, in alphabetical order (for consistency).
+    backgroundColor = 'order-1-cyan',
+    className,
+    image,
+    imageDescription,
+    name,
+    /* TODO: add other props for UserAvatar, with default values if needed */
+    renderIcon: RenderIcon,
+    size = 'md',
+    tooltipText,
+    tooltipAlignment = 'bottom',
+    // Collect any other property values passed in.
+    ...rest
+  } = _ref;
+  const carbonPrefix = react.usePrefix();
+  const iconSize = {
+    sm: 16,
+    md: 20,
+    lg: 24,
+    xl: 32
+  };
+  const formatInitials = () => {
+    const parts = name?.split(' ') || [];
+    const firstChar = parts[0].charAt(0).toUpperCase();
+    const secondChar = parts[0].charAt(1).toUpperCase();
+    if (parts.length === 1) {
+      return firstChar + secondChar;
+    }
+    const lastChar = parts[parts.length - 1].charAt(0).toUpperCase();
+    const initials = [firstChar];
+    if (lastChar) {
+      initials.push(lastChar);
+    }
+    return ''.concat(...initials);
+  };
+  const getItem = () => {
+    const iconProps = {
+      size: iconSize[size]
+    };
+    if (image) {
+      return /*#__PURE__*/React.createElement("img", {
+        alt: imageDescription,
+        src: image,
+        className: `${blockClass}__photo ${blockClass}__photo--${size}`
+      });
+    }
+    if (RenderIcon) {
+      return /*#__PURE__*/React.createElement(RenderIcon, iconProps);
+    }
+    if (name) {
+      return formatInitials();
+    }
+    return /*#__PURE__*/React.createElement(icons.User, iconProps);
+  };
+  const Avatar = () => /*#__PURE__*/React.createElement("div", _rollupPluginBabelHelpers.extends({}, rest, {
+    className: index$1.default(blockClass,
+    // Apply the block class to the main HTML element
+    className,
+    // Apply any supplied class names to the main HTML element.
+    `${blockClass}--${backgroundColor}`, `${blockClass}--${size}`,
+    // example: `${blockClass}__template-string-class-${kind}-n-${size}`,
+    {
+      // switched classes dependant on props or state
+      // example: [`${blockClass}__here-if-small`]: size === 'sm',
+    }),
+    ref: ref
+  }, devtools.getDevtoolsProps(componentName)), getItem());
+  if (tooltipText) {
+    return /*#__PURE__*/React.createElement(react.Tooltip, {
+      align: tooltipAlignment,
+      label: tooltipText,
+      className: `${blockClass}__tooltip ${carbonPrefix}--icon-tooltip`
+    }, /*#__PURE__*/React.createElement(TooltipTrigger.TooltipTrigger, null, /*#__PURE__*/React.createElement(Avatar, null)));
+  }
+  return /*#__PURE__*/React.createElement(Avatar, null);
+});
+
+// Return a placeholder if not released and not enabled by feature flag
+exports.UserAvatar = settings.pkg.checkComponentEnabled(exports.UserAvatar, componentName);
+
+// The display name of the component, used by React. Note that displayName
+// is used in preference to relying on function.name.
+exports.UserAvatar.displayName = componentName;
+
+// The types and DocGen commentary for the component props,
+// in alphabetical order (for consistency).
+// See https://www.npmjs.com/package/prop-types#usage.
+exports.UserAvatar.propTypes = {
+  /**
+   * Provide the background color need to be set for UserAvatar. Background color will be set based on lighter or darker theme.
+   * For example: if you select order-5-purple, it will take $purple-60 for lighter theme and $purple-50 for darker theme.
+   */
+  backgroundColor: index.default.oneOf(['order-1-cyan', 'order-2-gray', 'order-3-green', 'order-4-magenta', 'order-5-purple', 'order-6-teal', 'order-7-cyan', 'order-8-gray', 'order-9-green', 'order-10-magenta', 'order-11-purple', 'order-12-teal']),
+  /**
+   * Provide an optional class to be applied to the containing node.
+   */
+  className: index.default.string,
+  /**
+   * When passing the image prop, supply a full path to the image to be displayed.
+   */
+  /**@ts-ignore */
+  image: index.default.string,
+  /**
+   * When passing the image prop use the imageDescription prop to describe the image for screen reader.
+   */
+  /**@ts-ignore */
+  imageDescription: index.default.string.isRequired.if(_ref2 => {
+    let {
+      image
+    } = _ref2;
+    return !!image;
+  }),
+  /**
+   * When passing the name prop, either send the initials to be used or the user's full name. The first two capital letters of the user's name will be used as the name.
+   */
+  name: index.default.string,
+  /**
+   * Provide a custom icon to use if you need to use an icon other than the default one
+   */
+  /**@ts-ignore */
+  renderIcon: index.default.oneOfType([index.default.func, index.default.object, index.default.string]),
+  /**
+   * Set the size of the avatar circle
+   */
+  size: index.default.oneOf(['xl', 'lg', 'md', 'sm']),
+  /**
+   * Specify how the trigger should align with the tooltip
+   */
+  tooltipAlignment: index.default.oneOf(['top', 'top-left', 'top-right', 'bottom', 'bottom-left', 'bottom-right', 'left', 'right']),
+  /**
+   * Pass in the display name to have it shown on hover
+   */
+  tooltipText: index.default.string
+  /* TODO: add types and DocGen for all props. */
+};