@atlaskit/avatar 21.4.1 → 21.4.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @atlaskit/avatar
 
+## 21.4.3
+
+### Patch Changes
+
+- [#63807](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/63807) [`538c46e739b6`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/538c46e739b6) - [ux] Add accessible name to non-interactive avatars.
+
+## 21.4.2
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 21.4.1
 
 ### Patch Changes

package/dist/cjs/Avatar.js

@@ -9,6 +9,7 @@ var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/de
 var _taggedTemplateLiteral2 = _interopRequireDefault(require("@babel/runtime/helpers/taggedTemplateLiteral"));
 var _react = require("react");
 var _react2 = require("@emotion/react");
+var _reactUid = require("react-uid");
 var _analyticsNext = require("@atlaskit/analytics-next");
 var _colors = require("@atlaskit/theme/colors");
 var _AvatarImage = _interopRequireDefault(require("./AvatarImage"));
@@ -22,7 +23,7 @@ var _templateObject;
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var packageName = "@atlaskit/avatar";
-var packageVersion = "21.4.1";
+var packageVersion = "21.4.3";
 
 // eslint-disable-next-line @repo/internal/react/consistent-types-definitions
 
@@ -76,6 +77,7 @@ var Avatar = /*#__PURE__*/(0, _react.forwardRef)(function (_ref2, ref) {
   var customStatusNode = /*#__PURE__*/(0, _react.isValidElement)(status) ? status : null;
   var isValidIconSize = size !== 'xxlarge' && size !== 'xsmall';
   var lastAnalytics = (0, _react.useRef)(analyticsContext);
+  var uuid = (0, _reactUid.useUIDSeed)()('avatar');
   (0, _react.useEffect)(function () {
     lastAnalytics.current = analyticsContext;
   }, [analyticsContext]);
@@ -137,14 +139,12 @@ var Avatar = /*#__PURE__*/(0, _react.forwardRef)(function (_ref2, ref) {
 
   // add presence or status to the label by default if presence and status are passed as a string
   // if status or presence are nodes this is not added to the label by default
-  var generateDefaultLabel = function generateDefaultLabel() {
-    if (!name && !status && !presence) {
-      return;
-    }
-    return "".concat(name || '', " ").concat(isStatus && !customStatusNode ? "(".concat(status, ")") : '', " ").concat(isPresence && !customPresenceNode ? "(".concat(presence, ")") : '');
-  };
+  var defaultLabel = "".concat(name || '', " ").concat(isStatus && !customStatusNode ? "(".concat(status, ")") : '', " ").concat(isPresence && !customPresenceNode ? "(".concat(presence, ")") : '').trim();
+  var isInteractive = onClick || href || isDisabled;
   return (0, _react2.jsx)(AvatarContainer, {
     "data-testid": testId,
+    role: isInteractive || !defaultLabel ? undefined : 'img',
+    "aria-labelledby": isInteractive || !defaultLabel ? undefined : "".concat(uuid, "-label"),
     style: {
       display: 'inline-block',
       position: 'relative',
@@ -163,11 +163,14 @@ var Avatar = /*#__PURE__*/(0, _react.forwardRef)(function (_ref2, ref) {
         isInteractive: Boolean(href || onClick) && !isDisabled,
         isDisabled: isDisabled
       })
-    }, componentProps()), testId && getTestId(testId, children)), (onClick || href) && {
-      'aria-label': label || generateDefaultLabel()
+    }, componentProps()), testId && getTestId(testId, children)), isInteractive && {
+      'aria-label': label || defaultLabel
     }), {}, {
-      children: (0, _react2.jsx)(_AvatarImage.default, {
-        alt: name,
+      children: (0, _react2.jsx)(_AvatarImage.default
+      // Only pass the name if there is an image provided. We want the
+      // icons to be presentational if they don't show anything important.
+      , {
+        alt: src ? name : undefined,
         appearance: appearance,
         size: size,
         src: src,
@@ -187,7 +190,10 @@ var Avatar = /*#__PURE__*/(0, _react.forwardRef)(function (_ref2, ref) {
     borderColor: borderColor,
     status: typeof status === 'string' ? status : undefined,
     testId: testId
-  }, customStatusNode));
+  }, customStatusNode), !isInteractive && defaultLabel ? (0, _react2.jsx)("span", {
+    id: "".concat(uuid, "-label"),
+    hidden: true
+  }, defaultLabel) : undefined);
 });
 Avatar.displayName = 'Avatar';
 var _default = exports.default = Avatar;

package/dist/cjs/AvatarItem.js

@@ -22,10 +22,9 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 var avatarItemStyles = (0, _react2.css)({
   minWidth: 0,
   maxWidth: '100%',
-  paddingLeft: "var(--ds-space-100, 8px)",
   flex: '1 1 100%',
-  // eslint-disable-next-line @atlaskit/design-system/ensure-design-token-usage
-  lineHeight: '1.4'
+  lineHeight: '1.4',
+  paddingInlineStart: "var(--ds-space-100, 8px)"
 });
 var getStyles = function getStyles(css, _ref) {
   var backgroundColor = _ref.backgroundColor,

package/dist/cjs/IconWrapper.js

@@ -29,12 +29,10 @@ var iconWrapperStyles = (0, _react.css)({
 var IconWrapper = function IconWrapper(_ref) {
   var _ref$bgColor = _ref.bgColor,
     bgColor = _ref$bgColor === void 0 ? "var(--ds-surface-overlay, ".concat(_colors.N0, ")") : _ref$bgColor,
-    children = _ref.children,
-    label = _ref.label;
+    children = _ref.children;
   return (0, _react.jsx)("span", {
-    "aria-label": label || undefined,
     css: iconWrapperStyles,
-    role: label ? 'img' : 'presentation',
+    role: "presentation",
     style: {
       border: "".concat(_constants.BORDER_WIDTH, "px solid ").concat(bgColor),
       backgroundColor: bgColor

package/dist/cjs/Presence.js

@@ -67,16 +67,14 @@ var AvatarPresence = function AvatarPresence(_ref) {
     children = _ref.children,
     presence = _ref.presence;
   return /*#__PURE__*/_react.default.createElement(_IconWrapper.default, {
-    bgColor: borderColor,
-    label: typeof presence === 'string' ? presence : undefined
+    bgColor: borderColor
   }, presence ? /*#__PURE__*/_react.default.createElement("svg", {
-    "aria-hidden": "true",
     height: "100%",
     version: "1.1",
     viewBox: "0 0 8 8",
     width: "100%",
     xmlns: "http://www.w3.org/2000/svg"
-  }, getPresence(presence)) : children);
+  }, /*#__PURE__*/_react.default.createElement("title", null, "(".concat(presence, ")")), getPresence(presence)) : children);
 };
 var _default = exports.default = AvatarPresence;
 /**
@@ -93,7 +91,6 @@ var PresenceWrapper = exports.PresenceWrapper = function PresenceWrapper(_ref2)
     testId = _ref2.testId;
   var position = appearance === 'square' ? -4 : _constants.ICON_OFFSET[size];
   return /*#__PURE__*/_react.default.createElement("span", {
-    "aria-hidden": "true",
     "data-testid": testId && "".concat(testId, "--presence"),
     style: {
       pointerEvents: 'none',

package/dist/cjs/Status.js

@@ -65,16 +65,14 @@ var AvatarStatus = function AvatarStatus(_ref) {
     children = _ref.children,
     status = _ref.status;
   return /*#__PURE__*/_react.default.createElement(_IconWrapper.default, {
-    bgColor: borderColor,
-    label: typeof status === 'string' ? status : undefined
+    bgColor: borderColor
   }, status ? /*#__PURE__*/_react.default.createElement("svg", {
-    "aria-hidden": "true",
     height: "100%",
     version: "1.1",
     viewBox: "0 0 8 8",
     width: "100%",
     xmlns: "http://www.w3.org/2000/svg"
-  }, getStatus(status)) : children);
+  }, /*#__PURE__*/_react.default.createElement("title", null, "(".concat(status, ")")), getStatus(status)) : children);
 };
 var _default = exports.default = AvatarStatus;
 /**
@@ -91,7 +89,6 @@ var StatusWrapper = exports.StatusWrapper = function StatusWrapper(_ref2) {
     testId = _ref2.testId;
   var position = appearance === 'square' ? 0 : _constants.ICON_OFFSET[size];
   return /*#__PURE__*/_react.default.createElement("span", {
-    "aria-hidden": "true",
     "data-testid": testId && "".concat(testId, "--status"),
     style: {
       position: 'absolute',

package/dist/es2019/Avatar.js

@@ -2,6 +2,7 @@
 // eslint-disable-next-line @repo/internal/fs/filename-pattern-match
 import { createElement, forwardRef, isValidElement, useCallback, useEffect, useRef } from 'react';
 import { ClassNames, jsx } from '@emotion/react';
+import { useUIDSeed } from 'react-uid';
 import { useAnalyticsEvents } from '@atlaskit/analytics-next';
 import { B300, N0, N70A } from '@atlaskit/theme/colors';
 import AvatarImage from './AvatarImage';
@@ -10,7 +11,7 @@ import { PresenceWrapper } from './Presence';
 import { StatusWrapper } from './Status';
 import { getButtonProps, getCustomElement, getLinkProps } from './utilities';
 const packageName = "@atlaskit/avatar";
-const packageVersion = "21.4.1";
+const packageVersion = "21.4.3";
 
 // eslint-disable-next-line @repo/internal/react/consistent-types-definitions
 
@@ -150,6 +151,7 @@ const Avatar = /*#__PURE__*/forwardRef(({
   const customStatusNode = /*#__PURE__*/isValidElement(status) ? status : null;
   const isValidIconSize = size !== 'xxlarge' && size !== 'xsmall';
   const lastAnalytics = useRef(analyticsContext);
+  const uuid = useUIDSeed()('avatar');
   useEffect(() => {
     lastAnalytics.current = analyticsContext;
   }, [analyticsContext]);
@@ -213,14 +215,12 @@ const Avatar = /*#__PURE__*/forwardRef(({
 
   // add presence or status to the label by default if presence and status are passed as a string
   // if status or presence are nodes this is not added to the label by default
-  const generateDefaultLabel = () => {
-    if (!name && !status && !presence) {
-      return;
-    }
-    return `${name || ''} ${isStatus && !customStatusNode ? `(${status})` : ''} ${isPresence && !customPresenceNode ? `(${presence})` : ''}`;
-  };
+  const defaultLabel = `${name || ''} ${isStatus && !customStatusNode ? `(${status})` : ''} ${isPresence && !customPresenceNode ? `(${presence})` : ''}`.trim();
+  const isInteractive = onClick || href || isDisabled;
   return jsx(AvatarContainer, {
     "data-testid": testId,
+    role: isInteractive || !defaultLabel ? undefined : 'img',
+    "aria-labelledby": isInteractive || !defaultLabel ? undefined : `${uuid}-label`,
     style: {
       display: 'inline-block',
       position: 'relative',
@@ -242,11 +242,14 @@ const Avatar = /*#__PURE__*/forwardRef(({
       }),
       ...componentProps(),
       ...(testId && getTestId(testId, children)),
-      ...((onClick || href) && {
-        'aria-label': label || generateDefaultLabel()
+      ...(isInteractive && {
+        'aria-label': label || defaultLabel
       }),
-      children: jsx(AvatarImage, {
-        alt: name,
+      children: jsx(AvatarImage
+      // Only pass the name if there is an image provided. We want the
+      // icons to be presentational if they don't show anything important.
+      , {
+        alt: src ? name : undefined,
         appearance: appearance,
         size: size,
         src: src,
@@ -266,7 +269,10 @@ const Avatar = /*#__PURE__*/forwardRef(({
     borderColor: borderColor,
     status: typeof status === 'string' ? status : undefined,
     testId: testId
-  }, customStatusNode));
+  }, customStatusNode), !isInteractive && defaultLabel ? jsx("span", {
+    id: `${uuid}-label`,
+    hidden: true
+  }, defaultLabel) : undefined);
 });
 Avatar.displayName = 'Avatar';
 export default Avatar;

package/dist/es2019/AvatarItem.js

@@ -10,10 +10,9 @@ import { getButtonProps, getCustomElement, getLinkProps } from './utilities';
 const avatarItemStyles = css({
   minWidth: 0,
   maxWidth: '100%',
-  paddingLeft: "var(--ds-space-100, 8px)",
   flex: '1 1 100%',
-  // eslint-disable-next-line @atlaskit/design-system/ensure-design-token-usage
-  lineHeight: '1.4'
+  lineHeight: '1.4',
+  paddingInlineStart: "var(--ds-space-100, 8px)"
 });
 const getStyles = (css, {
   backgroundColor,

package/dist/es2019/IconWrapper.js

@@ -22,12 +22,10 @@ const iconWrapperStyles = css({
  */
 const IconWrapper = ({
   bgColor = `var(--ds-surface-overlay, ${N0})`,
-  children,
-  label
+  children
 }) => jsx("span", {
-  "aria-label": label || undefined,
   css: iconWrapperStyles,
-  role: label ? 'img' : 'presentation',
+  role: "presentation",
   style: {
     border: `${BORDER_WIDTH}px solid ${bgColor}`,
     backgroundColor: bgColor

package/dist/es2019/Presence.js

@@ -56,16 +56,14 @@ const AvatarPresence = ({
   children,
   presence
 }) => /*#__PURE__*/React.createElement(IconWrapper, {
-  bgColor: borderColor,
-  label: typeof presence === 'string' ? presence : undefined
+  bgColor: borderColor
 }, presence ? /*#__PURE__*/React.createElement("svg", {
-  "aria-hidden": "true",
   height: "100%",
   version: "1.1",
   viewBox: "0 0 8 8",
   width: "100%",
   xmlns: "http://www.w3.org/2000/svg"
-}, getPresence(presence)) : children);
+}, /*#__PURE__*/React.createElement("title", null, `(${presence})`), getPresence(presence)) : children);
 export default AvatarPresence;
 /**
  * __Presence wrapper__
@@ -82,7 +80,6 @@ export const PresenceWrapper = ({
 }) => {
   const position = appearance === 'square' ? -4 : ICON_OFFSET[size];
   return /*#__PURE__*/React.createElement("span", {
-    "aria-hidden": "true",
     "data-testid": testId && `${testId}--presence`,
     style: {
       pointerEvents: 'none',

package/dist/es2019/Status.js

@@ -54,16 +54,14 @@ const AvatarStatus = ({
   children,
   status
 }) => /*#__PURE__*/React.createElement(IconWrapper, {
-  bgColor: borderColor,
-  label: typeof status === 'string' ? status : undefined
+  bgColor: borderColor
 }, status ? /*#__PURE__*/React.createElement("svg", {
-  "aria-hidden": "true",
   height: "100%",
   version: "1.1",
   viewBox: "0 0 8 8",
   width: "100%",
   xmlns: "http://www.w3.org/2000/svg"
-}, getStatus(status)) : children);
+}, /*#__PURE__*/React.createElement("title", null, `(${status})`), getStatus(status)) : children);
 export default AvatarStatus;
 /**
  * Status wrapper**
@@ -80,7 +78,6 @@ export const StatusWrapper = ({
 }) => {
   const position = appearance === 'square' ? 0 : ICON_OFFSET[size];
   return /*#__PURE__*/React.createElement("span", {
-    "aria-hidden": "true",
     "data-testid": testId && `${testId}--status`,
     style: {
       position: 'absolute',

package/dist/esm/Avatar.js

@@ -7,6 +7,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 // eslint-disable-next-line @repo/internal/fs/filename-pattern-match
 import { createElement, forwardRef, isValidElement, useCallback, useEffect, useRef } from 'react';
 import { ClassNames, jsx } from '@emotion/react';
+import { useUIDSeed } from 'react-uid';
 import { useAnalyticsEvents } from '@atlaskit/analytics-next';
 import { B300, N0, N70A } from '@atlaskit/theme/colors';
 import AvatarImage from './AvatarImage';
@@ -15,7 +16,7 @@ import { PresenceWrapper } from './Presence';
 import { StatusWrapper } from './Status';
 import { getButtonProps, getCustomElement, getLinkProps } from './utilities';
 var packageName = "@atlaskit/avatar";
-var packageVersion = "21.4.1";
+var packageVersion = "21.4.3";
 
 // eslint-disable-next-line @repo/internal/react/consistent-types-definitions
 
@@ -69,6 +70,7 @@ var Avatar = /*#__PURE__*/forwardRef(function (_ref2, ref) {
   var customStatusNode = /*#__PURE__*/isValidElement(status) ? status : null;
   var isValidIconSize = size !== 'xxlarge' && size !== 'xsmall';
   var lastAnalytics = useRef(analyticsContext);
+  var uuid = useUIDSeed()('avatar');
   useEffect(function () {
     lastAnalytics.current = analyticsContext;
   }, [analyticsContext]);
@@ -130,14 +132,12 @@ var Avatar = /*#__PURE__*/forwardRef(function (_ref2, ref) {
 
   // add presence or status to the label by default if presence and status are passed as a string
   // if status or presence are nodes this is not added to the label by default
-  var generateDefaultLabel = function generateDefaultLabel() {
-    if (!name && !status && !presence) {
-      return;
-    }
-    return "".concat(name || '', " ").concat(isStatus && !customStatusNode ? "(".concat(status, ")") : '', " ").concat(isPresence && !customPresenceNode ? "(".concat(presence, ")") : '');
-  };
+  var defaultLabel = "".concat(name || '', " ").concat(isStatus && !customStatusNode ? "(".concat(status, ")") : '', " ").concat(isPresence && !customPresenceNode ? "(".concat(presence, ")") : '').trim();
+  var isInteractive = onClick || href || isDisabled;
   return jsx(AvatarContainer, {
     "data-testid": testId,
+    role: isInteractive || !defaultLabel ? undefined : 'img',
+    "aria-labelledby": isInteractive || !defaultLabel ? undefined : "".concat(uuid, "-label"),
     style: {
       display: 'inline-block',
       position: 'relative',
@@ -156,11 +156,14 @@ var Avatar = /*#__PURE__*/forwardRef(function (_ref2, ref) {
         isInteractive: Boolean(href || onClick) && !isDisabled,
         isDisabled: isDisabled
       })
-    }, componentProps()), testId && getTestId(testId, children)), (onClick || href) && {
-      'aria-label': label || generateDefaultLabel()
+    }, componentProps()), testId && getTestId(testId, children)), isInteractive && {
+      'aria-label': label || defaultLabel
     }), {}, {
-      children: jsx(AvatarImage, {
-        alt: name,
+      children: jsx(AvatarImage
+      // Only pass the name if there is an image provided. We want the
+      // icons to be presentational if they don't show anything important.
+      , {
+        alt: src ? name : undefined,
         appearance: appearance,
         size: size,
         src: src,
@@ -180,7 +183,10 @@ var Avatar = /*#__PURE__*/forwardRef(function (_ref2, ref) {
     borderColor: borderColor,
     status: typeof status === 'string' ? status : undefined,
     testId: testId
-  }, customStatusNode));
+  }, customStatusNode), !isInteractive && defaultLabel ? jsx("span", {
+    id: "".concat(uuid, "-label"),
+    hidden: true
+  }, defaultLabel) : undefined);
 });
 Avatar.displayName = 'Avatar';
 export default Avatar;

package/dist/esm/AvatarItem.js

@@ -15,10 +15,9 @@ import { getButtonProps, getCustomElement, getLinkProps } from './utilities';
 var avatarItemStyles = css({
   minWidth: 0,
   maxWidth: '100%',
-  paddingLeft: "var(--ds-space-100, 8px)",
   flex: '1 1 100%',
-  // eslint-disable-next-line @atlaskit/design-system/ensure-design-token-usage
-  lineHeight: '1.4'
+  lineHeight: '1.4',
+  paddingInlineStart: "var(--ds-space-100, 8px)"
 });
 var getStyles = function getStyles(css, _ref) {
   var backgroundColor = _ref.backgroundColor,

package/dist/esm/IconWrapper.js

@@ -23,12 +23,10 @@ var iconWrapperStyles = css({
 var IconWrapper = function IconWrapper(_ref) {
   var _ref$bgColor = _ref.bgColor,
     bgColor = _ref$bgColor === void 0 ? "var(--ds-surface-overlay, ".concat(N0, ")") : _ref$bgColor,
-    children = _ref.children,
-    label = _ref.label;
+    children = _ref.children;
   return jsx("span", {
-    "aria-label": label || undefined,
     css: iconWrapperStyles,
-    role: label ? 'img' : 'presentation',
+    role: "presentation",
     style: {
       border: "".concat(BORDER_WIDTH, "px solid ").concat(bgColor),
       backgroundColor: bgColor

package/dist/esm/Presence.js

@@ -56,16 +56,14 @@ var AvatarPresence = function AvatarPresence(_ref) {
     children = _ref.children,
     presence = _ref.presence;
   return /*#__PURE__*/React.createElement(IconWrapper, {
-    bgColor: borderColor,
-    label: typeof presence === 'string' ? presence : undefined
+    bgColor: borderColor
   }, presence ? /*#__PURE__*/React.createElement("svg", {
-    "aria-hidden": "true",
     height: "100%",
     version: "1.1",
     viewBox: "0 0 8 8",
     width: "100%",
     xmlns: "http://www.w3.org/2000/svg"
-  }, getPresence(presence)) : children);
+  }, /*#__PURE__*/React.createElement("title", null, "(".concat(presence, ")")), getPresence(presence)) : children);
 };
 export default AvatarPresence;
 /**
@@ -82,7 +80,6 @@ export var PresenceWrapper = function PresenceWrapper(_ref2) {
     testId = _ref2.testId;
   var position = appearance === 'square' ? -4 : ICON_OFFSET[size];
   return /*#__PURE__*/React.createElement("span", {
-    "aria-hidden": "true",
     "data-testid": testId && "".concat(testId, "--presence"),
     style: {
       pointerEvents: 'none',

package/dist/esm/Status.js

@@ -54,16 +54,14 @@ var AvatarStatus = function AvatarStatus(_ref) {
     children = _ref.children,
     status = _ref.status;
   return /*#__PURE__*/React.createElement(IconWrapper, {
-    bgColor: borderColor,
-    label: typeof status === 'string' ? status : undefined
+    bgColor: borderColor
   }, status ? /*#__PURE__*/React.createElement("svg", {
-    "aria-hidden": "true",
     height: "100%",
     version: "1.1",
     viewBox: "0 0 8 8",
     width: "100%",
     xmlns: "http://www.w3.org/2000/svg"
-  }, getStatus(status)) : children);
+  }, /*#__PURE__*/React.createElement("title", null, "(".concat(status, ")")), getStatus(status)) : children);
 };
 export default AvatarStatus;
 /**
@@ -80,7 +78,6 @@ export var StatusWrapper = function StatusWrapper(_ref2) {
     testId = _ref2.testId;
   var position = appearance === 'square' ? 0 : ICON_OFFSET[size];
   return /*#__PURE__*/React.createElement("span", {
-    "aria-hidden": "true",
     "data-testid": testId && "".concat(testId, "--status"),
     style: {
       position: 'absolute',

package/dist/types/Avatar.d.ts

@@ -33,7 +33,7 @@ export interface AvatarPropTypes {
      */
     borderColor?: string;
     /**
-     * Supply a custom avatar component instead of the default
+     * Supply a custom avatar component instead of the default.
      */
     children?: (props: CustomAvatarProps) => ReactNode;
     /**
@@ -50,13 +50,13 @@ export interface AvatarPropTypes {
     name?: string;
     /**
      * Indicates a user's online status by showing a small icon on the avatar.
-     * Refer to presence values on the Presence component.
+     * Refer to presence values on the presence component.
      * Alternatively accepts any React element. For best results, it is recommended to
      * use square content with height and width of 100%.
      */
     presence?: Presence | Omit<ReactNode, string> | (string & {}) | null;
     /**
-     * Defines the size of the avatar
+     * Defines the size of the avatar.
      */
     size?: SizeType;
     /**
@@ -85,11 +85,11 @@ export interface AvatarPropTypes {
      */
     onClick?: AvatarClickEventHandler;
     /**
-     * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests
+     * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests.
      */
     testId?: string;
     /**
-     * Analytics context meta data
+     * Analytics context meta data.
      */
     analyticsContext?: Record<string, any>;
     /**

package/dist/types/AvatarItem.d.ts

@@ -39,7 +39,7 @@ export interface AvatarItemProps {
      */
     href?: string;
     /**
-     * Disable the item from being interactive
+     * Disable the item from being interactive.
      */
     isDisabled?: boolean;
     /**
@@ -63,7 +63,7 @@ export interface AvatarItemProps {
      */
     isTruncationDisabled?: boolean;
     /**
-     * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests
+     * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests.
      */
     testId?: string;
 }

package/dist/types-ts4.5/Avatar.d.ts

@@ -33,7 +33,7 @@ export interface AvatarPropTypes {
      */
     borderColor?: string;
     /**
-     * Supply a custom avatar component instead of the default
+     * Supply a custom avatar component instead of the default.
      */
     children?: (props: CustomAvatarProps) => ReactNode;
     /**
@@ -50,13 +50,13 @@ export interface AvatarPropTypes {
     name?: string;
     /**
      * Indicates a user's online status by showing a small icon on the avatar.
-     * Refer to presence values on the Presence component.
+     * Refer to presence values on the presence component.
      * Alternatively accepts any React element. For best results, it is recommended to
      * use square content with height and width of 100%.
      */
     presence?: Presence | Omit<ReactNode, string> | (string & {}) | null;
     /**
-     * Defines the size of the avatar
+     * Defines the size of the avatar.
      */
     size?: SizeType;
     /**
@@ -85,11 +85,11 @@ export interface AvatarPropTypes {
      */
     onClick?: AvatarClickEventHandler;
     /**
-     * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests
+     * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests.
      */
     testId?: string;
     /**
-     * Analytics context meta data
+     * Analytics context meta data.
      */
     analyticsContext?: Record<string, any>;
     /**

package/dist/types-ts4.5/AvatarItem.d.ts

@@ -39,7 +39,7 @@ export interface AvatarItemProps {
      */
     href?: string;
     /**
-     * Disable the item from being interactive
+     * Disable the item from being interactive.
      */
     isDisabled?: boolean;
     /**
@@ -63,7 +63,7 @@ export interface AvatarItemProps {
      */
     isTruncationDisabled?: boolean;
     /**
-     * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests
+     * A `testId` prop is provided for specified elements, which is a unique string that appears as a data attribute `data-testid` in the rendered code, serving as a hook for automated tests.
      */
     testId?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/avatar",
-  "version": "21.4.1",
+  "version": "21.4.3",
   "description": "An avatar is a visual representation of a user or entity.",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -44,12 +44,13 @@
   },
   "dependencies": {
     "@atlaskit/analytics-next": "^9.1.0",
-    "@atlaskit/icon": "^21.12.0",
+    "@atlaskit/icon": "^22.0.0",
     "@atlaskit/theme": "^12.6.0",
-    "@atlaskit/tokens": "^1.28.0",
+    "@atlaskit/tokens": "^1.33.0",
     "@babel/runtime": "^7.0.0",
     "@emotion/react": "^11.7.1",
-    "@emotion/serialize": "^1.1.0"
+    "@emotion/serialize": "^1.1.0",
+    "react-uid": "^2.2.0"
   },
   "peerDependencies": {
     "react": "^16.8.0"
@@ -59,7 +60,7 @@
     "@af/visual-regression": "*",
     "@atlaskit/ds-lib": "^2.2.0",
     "@atlaskit/ssr": "*",
-    "@atlaskit/tooltip": "^17.8.0",
+    "@atlaskit/tooltip": "^18.1.0",
     "@atlaskit/visual-regression": "*",
     "@atlassian/atlassian-frontend-prettier-config-1.0.1": "npm:@atlassian/atlassian-frontend-prettier-config@1.0.1",
     "@emotion/styled": "^11.0.0",

package/tmp/api-report-tmp.d.ts

@@ -1,171 +0,0 @@
-## API Report File for "@atlaskit/avatar"
-
-> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
-
-```ts
-
-/// <reference types="react" />
-
-import { FC } from 'react';
-import { ForwardRefExoticComponent } from 'react';
-import { MouseEventHandler } from 'react';
-import { ReactNode } from 'react';
-import { Ref } from 'react';
-import { RefAttributes } from 'react';
-import { UIAnalyticsEvent } from '@atlaskit/analytics-next';
-
-// @public (undocumented)
-export const ACTIVE_SCALE_FACTOR = 0.9;
-
-// @public (undocumented)
-export type AppearanceType = 'circle' | 'square';
-
-// @public
-const Avatar: ForwardRefExoticComponent<AvatarPropTypes & RefAttributes<HTMLElement>>;
-export default Avatar;
-
-// @public (undocumented)
-export const AVATAR_RADIUS: AvatarSizeMap;
-
-// @public (undocumented)
-export const AVATAR_SIZES: AvatarSizeMap;
-
-// @public (undocumented)
-export type AvatarClickEventHandler = (event: React.MouseEvent, analyticsEvent?: UIAnalyticsEvent) => void;
-
-// @public
-export const AvatarItem: ForwardRefExoticComponent<AvatarItemProps & RefAttributes<HTMLElement>>;
-
-// @public (undocumented)
-export interface AvatarItemProps {
-    avatar: ReactNode;
-    backgroundColor?: string;
-    children?: (props: CustomAvatarItemProps) => ReactNode;
-    href?: string;
-    isDisabled?: boolean;
-    isTruncationDisabled?: boolean;
-    label?: string;
-    onClick?: AvatarClickEventHandler;
-    primaryText?: ReactNode;
-    secondaryText?: ReactNode;
-    target?: '_blank' | '_parent' | '_self' | '_top';
-    testId?: string;
-}
-
-// @public (undocumented)
-export interface AvatarPropTypes {
-    analyticsContext?: Record<string, any>;
-    appearance?: AppearanceType;
-    as?: React.ComponentType<React.AllHTMLAttributes<HTMLElement>> | keyof JSX.IntrinsicElements;
-    borderColor?: string;
-    children?: (props: CustomAvatarProps) => ReactNode;
-    href?: string;
-    isDisabled?: boolean;
-    label?: string;
-    name?: string;
-    onClick?: AvatarClickEventHandler;
-    presence?: (string & {}) | Omit<ReactNode, string> | PresenceType | null;
-    size?: SizeType;
-    src?: string;
-    stackIndex?: number;
-    status?: (string & {}) | Omit<ReactNode, string> | StatusType | null;
-    tabIndex?: number;
-    target?: '_blank' | '_parent' | '_self' | '_top';
-    testId?: string;
-}
-
-// @public (undocumented)
-type AvatarSizeMap = Record<SizeType, number>;
-
-// @public (undocumented)
-export const BORDER_WIDTH = 2;
-
-// @public (undocumented)
-export interface CustomAvatarItemProps {
-    // (undocumented)
-    'aria-disabled'?: 'false' | 'true' | boolean | undefined;
-    'aria-label'?: string;
-    // (undocumented)
-    children: ReactNode;
-    // (undocumented)
-    className?: string;
-    // (undocumented)
-    href?: string;
-    // (undocumented)
-    onClick?: MouseEventHandler;
-    // (undocumented)
-    ref: Ref<HTMLElement>;
-    // (undocumented)
-    testId?: string;
-}
-
-// @public (undocumented)
-export interface CustomAvatarProps {
-    'aria-label'?: string;
-    // (undocumented)
-    children: ReactNode;
-    // (undocumented)
-    className?: string;
-    // (undocumented)
-    href?: string;
-    // (undocumented)
-    onClick?: MouseEventHandler;
-    // (undocumented)
-    ref: Ref<HTMLElement>;
-    // (undocumented)
-    tabIndex?: number;
-    // (undocumented)
-    testId?: string;
-}
-
-// @public (undocumented)
-export type IndicatorSizeType = 'large' | 'medium' | 'small' | 'xlarge';
-
-// @public
-export const Presence: FC<PresenceProps>;
-
-// @public (undocumented)
-export interface PresenceProps {
-    borderColor?: string;
-    children?: ReactNode;
-    presence?: PresenceType;
-    testId?: string;
-}
-
-// @public (undocumented)
-export type PresenceType = 'busy' | 'focus' | 'offline' | 'online';
-
-// @public (undocumented)
-export type SizeType = 'large' | 'medium' | 'small' | 'xlarge' | 'xsmall' | 'xxlarge';
-
-// @public
-export const Skeleton: FC<SkeletonProps>;
-
-// @public (undocumented)
-export interface SkeletonProps {
-    // (undocumented)
-    appearance?: AppearanceType;
-    // (undocumented)
-    color?: string;
-    // (undocumented)
-    size?: SizeType;
-    // (undocumented)
-    weight?: 'normal' | 'strong';
-}
-
-// @public
-export const Status: FC<StatusProps>;
-
-// @public (undocumented)
-export interface StatusProps {
-    borderColor?: string;
-    children?: ReactNode;
-    status?: StatusType;
-}
-
-// @public (undocumented)
-export type StatusType = 'approved' | 'declined' | 'locked';
-
-// (No @packageDocumentation comment for this package)
-
-```