@fluentui/react-avatar 9.0.0-nightly.f81b28ceb3.1 → 9.0.0-rc.1

package/dist/react-avatar.d.ts

@@ -1,23 +1,22 @@
 import type { ComponentProps } from '@fluentui/react-utilities';
 import type { ComponentState } from '@fluentui/react-utilities';
 import type { ForwardRefComponent } from '@fluentui/react-utilities';
-import type { IntrinsicShorthandProps } from '@fluentui/react-utilities';
-import type { ObjectShorthandProps } from '@fluentui/react-utilities';
-import type { PresenceBadgeProps } from '@fluentui/react-badge';
+import { PresenceBadge } from '@fluentui/react-badge';
 import * as React_2 from 'react';
-import type { ShorthandRenderFunction } from '@fluentui/react-utilities';
+import type { Slot } from '@fluentui/react-utilities';
 
 export declare const Avatar: ForwardRefComponent<AvatarProps>;
 
-export declare type AvatarCommons = Omit<React_2.HTMLAttributes<HTMLElement>, 'children'> & {
-    /**
-     * The name used for displaying the initials of the avatar if the image is not provided
-     */
-    name: string;
+export declare const avatarClassName = "fui-Avatar";
+
+declare type AvatarCommons = {
     /**
-     * Custom method for generating the initials from the name property, which is shown if no image is provided.
+     * The name of the person or entity represented by this Avatar. This should always be provided if it is available.
+     *
+     * The name will be used to determine the initials displayed when there is no icon, as well as provided to
+     * accessibility tools.
      */
-    getInitials: (name: string, isRtl: boolean) => string;
+    name?: string;
     /**
      * Size of the avatar in pixels.
      *
@@ -52,7 +51,7 @@ export declare type AvatarCommons = Omit<React_2.HTMLAttributes<HTMLElement>, 'c
      *
      * @defaultvalue ring
      */
-    activeAppearance: 'ring' | 'shadow' | 'glow' | 'ring-shadow' | 'ring-glow';
+    activeAppearance: 'ring' | 'shadow' | 'ring-shadow';
     /**
      * The color when displaying either an icon or initials.
      * * neutral (default): gray
@@ -78,39 +77,35 @@ export declare type AvatarNamedColor = 'darkRed' | 'cranberry' | 'red' | 'pumpki
 /**
  * Properties for Avatar
  */
-export declare type AvatarProps = Omit<ComponentProps<AvatarSlots>, 'image'> & Partial<AvatarCommons> & {
-    /**
-     * The Avatar's image. Cannot be typed as a normal slot since it should not accept any children
-     * but can accept a children render function.
-     */
-    image?: Omit<IntrinsicShorthandProps<'img'>, 'children'> & {
-        children?: ShorthandRenderFunction<React_2.HTMLAttributes<HTMLImageElement>>;
-    };
-};
+export declare type AvatarProps = Omit<ComponentProps<AvatarSlots>, 'color'> & Partial<AvatarCommons>;
 
 export declare type AvatarSlots = {
-    root: Omit<IntrinsicShorthandProps<'span'>, 'color'> & {
-        children?: never;
-    };
+    root: Slot<'span'>;
     /**
-     * This overidden in the component's props, it's only here to make `getSlots` work
-     * `img`  is an exception since it should never accept children, but can accept a children render function
+     * The Avatar's image.
+     *
+     * Usage e.g.: `image={{ src: '...' }}`
      */
-    image?: IntrinsicShorthandProps<'img'>;
+    image?: Slot<'img'>;
     /**
-     * The label shown when there's no image. Defaults to the initials derived from `name` using `getInitials`.
+     * (optional) Custom initials.
+     *
+     * It is usually not necessary to specify custom initials; by default they will be derived from the `name` prop,
+     * using the `getInitials` function.
+     *
+     * The initials are displayed when there is no image (including while the image is loading).
      */
-    label?: IntrinsicShorthandProps<'span'>;
+    initials?: Slot<'span'>;
     /**
-     * Icon to be displayed when the avatar doesn't have an image or name (or if getInitials returns an empty string).
+     * Icon to be displayed when the avatar doesn't have an image or initials.
      *
-     * @defaultvalue `Person20Regular` (the default icon's size depends on the Avatar's size)
+     * @defaultvalue `PersonRegular` (the default icon's size depends on the Avatar's size)
      */
-    icon?: IntrinsicShorthandProps<'span'>;
+    icon?: Slot<'span'>;
     /**
      * Badge to show the avatar's presence status.
      */
-    badge?: ObjectShorthandProps<PresenceBadgeProps>;
+    badge?: Slot<typeof PresenceBadge>;
 };
 
 /**
@@ -123,10 +118,25 @@ export declare type AvatarState = ComponentState<AvatarSlots> & AvatarCommons &
     color: Exclude<AvatarCommons['color'], 'colorful'>;
 };
 
-export declare const renderAvatar: (state: AvatarState) => JSX.Element;
+/**
+ * Regular expressions matching characters to ignore when calculating the initials.
+ */
+/**
+ * Get (up to 2 characters) initials based on display name of the persona.
+ *
+ * @param displayName - The full name of the person or entity
+ * @param isRtl - Whether the display is in RTL
+ * @param allowPhoneInitials - Should initials be generated from phone numbers (default false)
+ *
+ * @returns The 1 or 2 character initials based on the name. Or an empty string if no initials
+ * could be derived from the name.
+ */
+export declare function getInitials(displayName: string | undefined | null, isRtl: boolean, allowPhoneInitials?: boolean): string;
+
+export declare const renderAvatar_unstable: (state: AvatarState) => JSX.Element;
 
-export declare const useAvatar: (props: AvatarProps, ref: React_2.Ref<HTMLElement>) => AvatarState;
+export declare const useAvatar_unstable: (props: AvatarProps, ref: React_2.Ref<HTMLElement>) => AvatarState;
 
-export declare const useAvatarStyles: (state: AvatarState) => AvatarState;
+export declare const useAvatarStyles_unstable: (state: AvatarState) => AvatarState;
 
 export { }

package/lib/components/Avatar/Avatar.js

@@ -1,11 +1,11 @@
 import * as React from 'react';
-import { renderAvatar } from './renderAvatar';
-import { useAvatar } from './useAvatar';
-import { useAvatarStyles } from './useAvatarStyles';
-export var Avatar = /*#__PURE__*/React.forwardRef(function (props, ref) {
-  var state = useAvatar(props, ref);
-  useAvatarStyles(state);
-  return renderAvatar(state);
+import { renderAvatar_unstable } from './renderAvatar';
+import { useAvatar_unstable } from './useAvatar';
+import { useAvatarStyles_unstable } from './useAvatarStyles';
+export const Avatar = /*#__PURE__*/React.forwardRef((props, ref) => {
+  const state = useAvatar_unstable(props, ref);
+  useAvatarStyles_unstable(state);
+  return renderAvatar_unstable(state);
 });
 Avatar.displayName = 'Avatar';
 //# sourceMappingURL=Avatar.js.map

package/lib/components/Avatar/Avatar.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/Avatar/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,YAAT,QAA6B,gBAA7B;AACA,SAAS,SAAT,QAA0B,aAA1B;AACA,SAAS,eAAT,QAAgC,mBAAhC;AAIA,OAAO,IAAM,MAAM,gBAAqC,KAAK,CAAC,UAAN,CAAiB,UAAC,KAAD,EAAQ,GAAR,EAAW;AAClF,MAAM,KAAK,GAAG,SAAS,CAAC,KAAD,EAAQ,GAAR,CAAvB;AAEA,EAAA,eAAe,CAAC,KAAD,CAAf;AAEA,SAAO,YAAY,CAAC,KAAD,CAAnB;AACD,CANuD,CAAjD;AAQP,MAAM,CAAC,WAAP,GAAqB,QAArB","sourceRoot":""}
+{"version":3,"sources":["../../../src/components/Avatar/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,qBAAT,QAAsC,gBAAtC;AACA,SAAS,kBAAT,QAAmC,aAAnC;AACA,SAAS,wBAAT,QAAyC,mBAAzC;AAIA,OAAO,MAAM,MAAM,gBAAqC,KAAK,CAAC,UAAN,CAAiB,CAAC,KAAD,EAAQ,GAAR,KAAe;AACtF,QAAM,KAAK,GAAG,kBAAkB,CAAC,KAAD,EAAQ,GAAR,CAAhC;AAEA,EAAA,wBAAwB,CAAC,KAAD,CAAxB;AAEA,SAAO,qBAAqB,CAAC,KAAD,CAA5B;AACD,CANuD,CAAjD;AAQP,MAAM,CAAC,WAAP,GAAqB,QAArB","sourceRoot":""}

package/lib/components/Avatar/Avatar.types.d.ts

@@ -1,39 +1,41 @@
-import * as React from 'react';
-import type { ComponentProps, ComponentState, IntrinsicShorthandProps, ObjectShorthandProps, ShorthandRenderFunction } from '@fluentui/react-utilities';
-import type { PresenceBadgeProps } from '@fluentui/react-badge';
+import { PresenceBadge } from '@fluentui/react-badge';
+import type { ComponentProps, ComponentState, Slot } from '@fluentui/react-utilities';
 export declare type AvatarSlots = {
-    root: Omit<IntrinsicShorthandProps<'span'>, 'color'> & {
-        children?: never;
-    };
+    root: Slot<'span'>;
     /**
-     * This overidden in the component's props, it's only here to make `getSlots` work
-     * `img`  is an exception since it should never accept children, but can accept a children render function
+     * The Avatar's image.
+     *
+     * Usage e.g.: `image={{ src: '...' }}`
      */
-    image?: IntrinsicShorthandProps<'img'>;
+    image?: Slot<'img'>;
     /**
-     * The label shown when there's no image. Defaults to the initials derived from `name` using `getInitials`.
+     * (optional) Custom initials.
+     *
+     * It is usually not necessary to specify custom initials; by default they will be derived from the `name` prop,
+     * using the `getInitials` function.
+     *
+     * The initials are displayed when there is no image (including while the image is loading).
      */
-    label?: IntrinsicShorthandProps<'span'>;
+    initials?: Slot<'span'>;
     /**
-     * Icon to be displayed when the avatar doesn't have an image or name (or if getInitials returns an empty string).
+     * Icon to be displayed when the avatar doesn't have an image or initials.
      *
-     * @defaultvalue `Person20Regular` (the default icon's size depends on the Avatar's size)
+     * @defaultvalue `PersonRegular` (the default icon's size depends on the Avatar's size)
      */
-    icon?: IntrinsicShorthandProps<'span'>;
+    icon?: Slot<'span'>;
     /**
      * Badge to show the avatar's presence status.
      */
-    badge?: ObjectShorthandProps<PresenceBadgeProps>;
+    badge?: Slot<typeof PresenceBadge>;
 };
-export declare type AvatarCommons = Omit<React.HTMLAttributes<HTMLElement>, 'children'> & {
-    /**
-     * The name used for displaying the initials of the avatar if the image is not provided
-     */
-    name: string;
+declare type AvatarCommons = {
     /**
-     * Custom method for generating the initials from the name property, which is shown if no image is provided.
+     * The name of the person or entity represented by this Avatar. This should always be provided if it is available.
+     *
+     * The name will be used to determine the initials displayed when there is no icon, as well as provided to
+     * accessibility tools.
      */
-    getInitials: (name: string, isRtl: boolean) => string;
+    name?: string;
     /**
      * Size of the avatar in pixels.
      *
@@ -68,7 +70,7 @@ export declare type AvatarCommons = Omit<React.HTMLAttributes<HTMLElement>, 'chi
      *
      * @defaultvalue ring
      */
-    activeAppearance: 'ring' | 'shadow' | 'glow' | 'ring-shadow' | 'ring-glow';
+    activeAppearance: 'ring' | 'shadow' | 'ring-shadow';
     /**
      * The color when displaying either an icon or initials.
      * * neutral (default): gray
@@ -92,15 +94,7 @@ export declare type AvatarNamedColor = 'darkRed' | 'cranberry' | 'red' | 'pumpki
 /**
  * Properties for Avatar
  */
-export declare type AvatarProps = Omit<ComponentProps<AvatarSlots>, 'image'> & Partial<AvatarCommons> & {
-    /**
-     * The Avatar's image. Cannot be typed as a normal slot since it should not accept any children
-     * but can accept a children render function.
-     */
-    image?: Omit<IntrinsicShorthandProps<'img'>, 'children'> & {
-        children?: ShorthandRenderFunction<React.HTMLAttributes<HTMLImageElement>>;
-    };
-};
+export declare type AvatarProps = Omit<ComponentProps<AvatarSlots>, 'color'> & Partial<AvatarCommons>;
 /**
  * State used in rendering Avatar
  */
@@ -110,3 +104,4 @@ export declare type AvatarState = ComponentState<AvatarSlots> & AvatarCommons &
      */
     color: Exclude<AvatarCommons['color'], 'colorful'>;
 };
+export {};

package/lib/components/Avatar/renderAvatar.d.ts

@@ -1,2 +1,2 @@
 import type { AvatarState } from './Avatar.types';
-export declare const renderAvatar: (state: AvatarState) => JSX.Element;
+export declare const renderAvatar_unstable: (state: AvatarState) => JSX.Element;

package/lib/components/Avatar/renderAvatar.js

@@ -1,11 +1,15 @@
-import { __assign } from "tslib";
 import * as React from 'react';
 import { getSlots } from '@fluentui/react-utilities';
-export var renderAvatar = function (state) {
-  var _a = getSlots(state, ['root', 'label', 'image', 'badge', 'icon']),
-      slots = _a.slots,
-      slotProps = _a.slotProps;
-
-  return /*#__PURE__*/React.createElement(slots.root, __assign({}, slotProps.root), /*#__PURE__*/React.createElement(slots.label, __assign({}, slotProps.label)), /*#__PURE__*/React.createElement(slots.icon, __assign({}, slotProps.icon)), /*#__PURE__*/React.createElement(slots.image, __assign({}, slotProps.image)), /*#__PURE__*/React.createElement(slots.badge, __assign({}, slotProps.badge)));
+export const renderAvatar_unstable = state => {
+  const {
+    slots,
+    slotProps
+  } = getSlots(state);
+  return /*#__PURE__*/React.createElement(slots.root, { ...slotProps.root
+  }, slots.initials && /*#__PURE__*/React.createElement(slots.initials, { ...slotProps.initials
+  }), slots.icon && /*#__PURE__*/React.createElement(slots.icon, { ...slotProps.icon
+  }), slots.image && /*#__PURE__*/React.createElement(slots.image, { ...slotProps.image
+  }), slots.badge && /*#__PURE__*/React.createElement(slots.badge, { ...slotProps.badge
+  }));
 };
 //# sourceMappingURL=renderAvatar.js.map

package/lib/components/Avatar/renderAvatar.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/Avatar/renderAvatar.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,QAAT,QAAyB,2BAAzB;AAGA,OAAO,IAAM,YAAY,GAAG,UAAC,KAAD,EAAmB;AACvC,MAAA,EAAA,GAAuB,QAAQ,CAAc,KAAd,EAAqB,CAAC,MAAD,EAAS,OAAT,EAAkB,OAAlB,EAA2B,OAA3B,EAAoC,MAApC,CAArB,CAA/B;AAAA,MAAE,KAAK,GAAA,EAAA,CAAA,KAAP;AAAA,MAAS,SAAS,GAAA,EAAA,CAAA,SAAlB;;AAEN,sBACE,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,QAAA,CAAA,EAAA,EAAK,SAAS,CAAC,IAAf,CAAX,eACE,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,KAAP,EAAY,QAAA,CAAA,EAAA,EAAK,SAAS,CAAC,KAAf,CAAZ,CADF,eAEE,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,QAAA,CAAA,EAAA,EAAK,SAAS,CAAC,IAAf,CAAX,CAFF,eAGE,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,KAAP,EAAY,QAAA,CAAA,EAAA,EAAK,SAAS,CAAC,KAAf,CAAZ,CAHF,eAIE,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,KAAP,EAAY,QAAA,CAAA,EAAA,EAAK,SAAS,CAAC,KAAf,CAAZ,CAJF,CADF;AAQD,CAXM","sourceRoot":""}
+{"version":3,"sources":["../../../src/components/Avatar/renderAvatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAZ,MAAuB,OAAvB;AACA,SAAS,QAAT,QAAyB,2BAAzB;AAGA,OAAO,MAAM,qBAAqB,GAAI,KAAD,IAAuB;AAC1D,QAAM;AAAE,IAAA,KAAF;AAAS,IAAA;AAAT,MAAuB,QAAQ,CAAc,KAAd,CAArC;AAEA,sBACE,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,EAAA,GAAK,SAAS,CAAC;AAAf,GAAX,EACG,KAAK,CAAC,QAAN,iBAAkB,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,QAAP,EAAe,EAAA,GAAK,SAAS,CAAC;AAAf,GAAf,CADrB,EAEG,KAAK,CAAC,IAAN,iBAAc,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,IAAP,EAAW,EAAA,GAAK,SAAS,CAAC;AAAf,GAAX,CAFjB,EAGG,KAAK,CAAC,KAAN,iBAAe,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,KAAP,EAAY,EAAA,GAAK,SAAS,CAAC;AAAf,GAAZ,CAHlB,EAIG,KAAK,CAAC,KAAN,iBAAe,KAAA,CAAA,aAAA,CAAC,KAAK,CAAC,KAAP,EAAY,EAAA,GAAK,SAAS,CAAC;AAAf,GAAZ,CAJlB,CADF;AAQD,CAXM","sourceRoot":""}

package/lib/components/Avatar/useAvatar.d.ts

@@ -1,3 +1,3 @@
 import * as React from 'react';
 import type { AvatarProps, AvatarState } from './Avatar.types';
-export declare const useAvatar: (props: AvatarProps, ref: React.Ref<HTMLElement>) => AvatarState;
+export declare const useAvatar_unstable: (props: AvatarProps, ref: React.Ref<HTMLElement>) => AvatarState;

package/lib/components/Avatar/useAvatar.js

@@ -1,100 +1,117 @@
-import { __assign } from "tslib";
 import * as React from 'react';
-import { getNativeElementProps, resolveShorthand } from '@fluentui/react-utilities';
-import { getInitials as getInitialsDefault } from '../../utils/index';
-import { Person16Regular, Person20Regular, Person24Regular, Person28Regular, Person32Regular, Person48Regular } from '@fluentui/react-icons';
+import { getNativeElementProps, resolveShorthand, useId } from '@fluentui/react-utilities';
+import { getInitials } from '../../utils/index';
+import { PersonRegular } from '@fluentui/react-icons';
 import { PresenceBadge } from '@fluentui/react-badge';
 import { useFluent } from '@fluentui/react-shared-contexts';
-export var useAvatar = function (props, ref) {
-  var _a, _b, _c;
+export const useAvatar_unstable = (props, ref) => {
+  var _a;
 
-  var dir = useFluent().dir;
-  var _d = props.name,
-      name = _d === void 0 ? '' : _d,
-      _e = props.size,
-      size = _e === void 0 ? 32 : _e,
-      _f = props.shape,
-      shape = _f === void 0 ? 'circular' : _f,
-      _g = props.active,
-      active = _g === void 0 ? 'unset' : _g,
-      _h = props.activeAppearance,
-      activeAppearance = _h === void 0 ? 'ring' : _h,
-      idForColor = props.idForColor,
-      _j = props.getInitials,
-      getInitials = _j === void 0 ? getInitialsDefault : _j;
-  var _k = props.color,
-      color = _k === void 0 ? 'neutral' : _k; // Resolve 'colorful' to a specific color name
+  const {
+    dir
+  } = useFluent();
+  const {
+    name,
+    size = 32,
+    shape = 'circular',
+    active = 'unset',
+    activeAppearance = 'ring',
+    idForColor
+  } = props;
+  let {
+    color = 'neutral'
+  } = props; // Resolve 'colorful' to a specific color name
 
   if (color === 'colorful') {
-    color = avatarColors[getHashCode((_b = (_a = props.idForColor) !== null && _a !== void 0 ? _a : props.name) !== null && _b !== void 0 ? _b : '') % avatarColors.length];
+    color = avatarColors[getHashCode((_a = idForColor !== null && idForColor !== void 0 ? idForColor : name) !== null && _a !== void 0 ? _a : '') % avatarColors.length];
   }
 
-  var state = {
-    size: size,
-    name: name,
-    shape: shape,
-    active: active,
-    activeAppearance: activeAppearance,
-    color: color,
-    idForColor: idForColor,
-    getInitials: getInitials,
-    components: {
-      root: 'span',
-      label: 'span',
-      icon: 'span',
-      image: 'img',
-      badge: PresenceBadge
-    },
-    root: getNativeElementProps('span', __assign(__assign({}, props), {
-      ref: ref
-    })),
-    label: resolveShorthand(props.label),
-    icon: undefined,
-    image: resolveShorthand(props.image),
-    badge: resolveShorthand(props.badge, {
+  const baseId = useId('avatar-');
+  const root = getNativeElementProps('span', {
+    role: 'img',
+    id: baseId,
+    // aria-label and/or aria-labelledby are resolved below
+    ...props,
+    ref
+  },
+  /* excludedPropNames: */
+  ['name']); // Resolve the initials slot, defaulted to getInitials.
+
+  let initials = resolveShorthand(props.initials, {
+    required: true,
+    defaultProps: {
+      children: getInitials(name, dir === 'rtl'),
+      'aria-hidden': true
+    }
+  }); // Render the icon slot *only if* there aren't any initials to display.
+
+  let icon = undefined;
+
+  if (!(initials === null || initials === void 0 ? void 0 : initials.children)) {
+    initials = undefined;
+    icon = resolveShorthand(props.icon, {
+      required: true,
       defaultProps: {
-        size: getBadgeSize(size)
+        children: /*#__PURE__*/React.createElement(PersonRegular, null),
+        'aria-hidden': true,
+        id: baseId + '__initials'
       }
-    })
-  }; // If a label was not provided, use the initials and fall back to the icon if initials aren't available
-
-  if (!((_c = state.label) === null || _c === void 0 ? void 0 : _c.children)) {
-    var initials = state.getInitials(state.name, dir === 'rtl');
+    });
+  }
 
-    if (initials) {
-      state.label = __assign(__assign({}, state.label), {
-        children: initials
-      });
-    } else {
-      state.icon = resolveShorthand(props.icon, {
-        required: true,
-        defaultProps: {
-          children: getDefaultIcon(state.size)
-        }
-      });
+  const image = resolveShorthand(props.image, {
+    defaultProps: {
+      alt: '',
+      role: 'presentation',
+      'aria-hidden': true
     }
-  }
+  });
+  const badge = resolveShorthand(props.badge, {
+    defaultProps: {
+      size: getBadgeSize(size),
+      role: 'presentation',
+      'aria-hidden': true,
+      id: baseId + '__badge'
+    }
+  }); // Resolve aria-label and/or aria-labelledby if not provided by the user
 
-  return state;
-};
+  if (!root['aria-label'] && !root['aria-labelledby']) {
+    if (name) {
+      root['aria-label'] = name; // Include the badge in labelledby if it exists
 
-var getDefaultIcon = function (size) {
-  if (size <= 24) {
-    return /*#__PURE__*/React.createElement(Person16Regular, null);
-  } else if (size <= 40) {
-    return /*#__PURE__*/React.createElement(Person20Regular, null);
-  } else if (size <= 48) {
-    return /*#__PURE__*/React.createElement(Person24Regular, null);
-  } else if (size <= 56) {
-    return /*#__PURE__*/React.createElement(Person28Regular, null);
-  } else if (size <= 72) {
-    return /*#__PURE__*/React.createElement(Person32Regular, null);
-  } else {
-    return /*#__PURE__*/React.createElement(Person48Regular, null);
+      if (badge) {
+        root['aria-labelledby'] = root.id + ' ' + badge.id;
+      }
+    } else if (initials) {
+      // root's aria-label should be the name, but fall back to being labelledby the initials if name is missing
+      root['aria-labelledby'] = initials.id + (badge ? ' ' + badge.id : '');
+    }
   }
+
+  return {
+    size,
+    name,
+    shape,
+    active,
+    activeAppearance,
+    color,
+    idForColor,
+    components: {
+      root: 'span',
+      initials: 'span',
+      icon: 'span',
+      image: 'img',
+      badge: PresenceBadge
+    },
+    root,
+    initials,
+    icon,
+    image,
+    badge
+  };
 };
 
-var getBadgeSize = function (size) {
+const getBadgeSize = size => {
   if (size >= 96) {
     return 'extra-large';
   } else if (size >= 64) {
@@ -110,14 +127,14 @@ var getBadgeSize = function (size) {
   }
 };
 
-var avatarColors = ['darkRed', 'cranberry', 'red', 'pumpkin', 'peach', 'marigold', 'gold', 'brass', 'brown', 'forest', 'seafoam', 'darkGreen', 'lightTeal', 'teal', 'steel', 'blue', 'royalBlue', 'cornflower', 'navy', 'lavender', 'purple', 'grape', 'lilac', 'pink', 'magenta', 'plum', 'beige', 'mink', 'platinum', 'anchor'];
+const avatarColors = ['darkRed', 'cranberry', 'red', 'pumpkin', 'peach', 'marigold', 'gold', 'brass', 'brown', 'forest', 'seafoam', 'darkGreen', 'lightTeal', 'teal', 'steel', 'blue', 'royalBlue', 'cornflower', 'navy', 'lavender', 'purple', 'grape', 'lilac', 'pink', 'magenta', 'plum', 'beige', 'mink', 'platinum', 'anchor'];
 
-var getHashCode = function (str) {
-  var hashCode = 0;
+const getHashCode = str => {
+  let hashCode = 0;
 
-  for (var len = str.length - 1; len >= 0; len--) {
-    var ch = str.charCodeAt(len);
-    var shift = len % 8;
+  for (let len = str.length - 1; len >= 0; len--) {
+    const ch = str.charCodeAt(len);
+    const shift = len % 8;
     hashCode ^= (ch << shift) + (ch >> 8 - shift); // eslint-disable-line no-bitwise
   }
 

package/lib/components/Avatar/useAvatar.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/Avatar/useAvatar.tsx"],"names":[],"mappings":"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","sourceRoot":""}
+{"version":3,"sources":["../../../src/components/Avatar/useAvatar.tsx"],"names":[],"mappings":"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","sourceRoot":""}

package/lib/components/Avatar/useAvatarStyles.d.ts

@@ -1,2 +1,3 @@
 import type { AvatarState } from './Avatar.types';
-export declare const useAvatarStyles: (state: AvatarState) => AvatarState;
+export declare const avatarClassName = "fui-Avatar";
+export declare const useAvatarStyles_unstable: (state: AvatarState) => AvatarState;