[DSRN] Aligned AvatarAccount (#606)

<!--
Please submit this PR as a draft initially.
Do not mark it as "Ready for review" until the template has been
completely filled out, and PR status checks have passed at least once.
-->

## **Description**
This PR updates the `AvatarAccount` component in the
`@metamask/design-system-react-native` package
- added jazziconProps, blockiesProps, maskiconProps
- updated tests
- updated descriptions and README
<!--
Write a short description of the changes included in this pull request,
also include relevant motivation and context. Have in mind the following
questions:
1. What is the reason for the change?
2. What is the improvement/solution?
-->

## **Related issues**

Fixes: #590 

## **Manual testing steps**

1. Run `yarn storybook:ios` from root
2. Check to make sure AvatarAccount is still functional
3.

## **Screenshots/Recordings**

<!-- If applicable, add screenshots and/or recordings to visualize the
before and after of your change. -->

### **Before**

<!-- [screenshots/recordings] -->

### **After**

https://github.com/user-attachments/assets/a811d973-097e-4817-9921-6fce7eb06e6b

<!-- [screenshots/recordings] -->

## **Pre-merge author checklist**

- [x] I've followed [MetaMask Contributor
Docs](https://github.com/MetaMask/contributor-docs)
- [x] I've completed the PR template to the best of my ability
- [x] I’ve included tests if applicable
- [x] I’ve documented my code using [JSDoc](https://jsdoc.app/) format
if applicable
- [x] I’ve applied the right labels on the PR (see [labeling
guidelines](https://github.com/MetaMask/metamask-extension/blob/develop/.github/guidelines/LABELING_GUIDELINES.md)).
Not required for external contributors.

## **Pre-merge reviewer checklist**

- [ ] I've manually tested the PR (e.g. pull and build branch, run the
app, test code being changed).
- [ ] I confirm that this PR addresses all acceptance criteria described
in the ticket it closes and includes the necessary testing evidence such
as recordings and or screenshots.

Co-authored-by: George Marshall <[email protected]>

Author: brianacnguyen

packages/design-system-react-native/src/components/AvatarAccount/AvatarAccount.test.tsx

@@ -5,13 +5,28 @@ import { AvatarAccountSize, AvatarAccountVariant } from '../../types';
 import AvatarAccount from './AvatarAccount';
 import { SAMPLE_AVATARACCOUNT_ADDRESSES } from './AvatarAccount.constants';
 
+jest.mock('react-native-svg', () => {
+  const React = require('react');
+  return {
+    SvgXml: (props: any) => React.createElement('SvgXml', props, props.xml),
+  };
+});
+jest.mock('react-native-jazzicon', () => {
+  return jest.fn(() => null);
+});
+
 describe('AvatarAccount', () => {
-  it('renders Jazzicon by default when no variant is provided', () => {
+  it('renders Jazzicon by default when no variant is provided', async () => {
     const address = SAMPLE_AVATARACCOUNT_ADDRESSES[0];
 
-    const { getByTestId } = render(<AvatarAccount address={address} />);
-
-    expect(getByTestId('jazzicon')).toBeTruthy();
+    const { findByTestId } = render(
+      <AvatarAccount
+        address={address}
+        jazziconProps={{ testID: 'jazzicon' }}
+      />,
+    );
+    const jazzicon = await findByTestId('jazzicon');
+    expect(jazzicon).toBeTruthy();
   });
 
   it('renders Blockies when variant is blockies', () => {
@@ -21,6 +36,7 @@ describe('AvatarAccount', () => {
       <AvatarAccount
         address={address}
         variant={AvatarAccountVariant.Blockies}
+        blockiesProps={{ testID: 'blockies' }}
       />,
     );
 
@@ -34,7 +50,7 @@ describe('AvatarAccount', () => {
       <AvatarAccount
         address={address}
         variant={AvatarAccountVariant.Maskicon}
-        testID="maskicon"
+        maskiconProps={{ testID: 'maskicon' }}
       />,
     );
 
@@ -57,17 +73,18 @@ describe('AvatarAccount', () => {
     );
   });
 
-  it('overrides the size if provided', () => {
+  it('overrides the size if provided', async () => {
     const address = SAMPLE_AVATARACCOUNT_ADDRESSES[0];
-    const { getByTestId } = render(
+    const { findByTestId, getByTestId } = render(
       <AvatarAccount
         address={address}
         size={AvatarAccountSize.Xl}
         testID="avatar-account"
+        jazziconProps={{ testID: 'jazzicon' }}
       />,
     );
 
-    const jazzicon = getByTestId('jazzicon');
+    const jazzicon = await findByTestId('jazzicon');
     expect(jazzicon).toBeTruthy();
     const avatarAccount = getByTestId('avatar-account');
     expect(avatarAccount).toBeDefined();

packages/design-system-react-native/src/components/AvatarAccount/AvatarAccount.tsx

@@ -16,32 +16,39 @@ const AvatarAccount = ({
   address,
   variant = AvatarAccountVariant.Jazzicon,
   size = AvatarAccountSize.Md,
-  shape = AvatarBaseShape.Circle,
+  blockiesProps,
+  jazziconProps,
+  maskiconProps,
   ...props
 }: AvatarAccountProps) => {
   let AvatarArtComponent;
 
   switch (variant) {
     case AvatarAccountVariant.Blockies:
       AvatarArtComponent = (
-        <Blockies address={address} size={Number(size)} testID="blockies" />
+        <Blockies address={address} size={Number(size)} {...blockiesProps} />
       );
       break;
     case AvatarAccountVariant.Maskicon:
       AvatarArtComponent = (
-        <Maskicon address={address} size={Number(size)} testID="maskicon" />
+        <Maskicon address={address} size={Number(size)} {...maskiconProps} />
       );
       break;
     case AvatarAccountVariant.Jazzicon:
     default:
       AvatarArtComponent = (
-        <Jazzicon address={address} size={Number(size)} testID="jazzicon" />
+        <Jazzicon address={address} size={Number(size)} {...jazziconProps} />
       );
       break;
   }
 
   return (
-    <AvatarBase size={size} shape={shape} accessibilityRole="image" {...props}>
+    <AvatarBase
+      size={size}
+      shape={AvatarBaseShape.Circle}
+      accessibilityRole="image"
+      {...props}
+    >
       {AvatarArtComponent}
     </AvatarBase>
   );

packages/design-system-react-native/src/components/AvatarAccount/AvatarAccount.types.ts

@@ -1,5 +1,8 @@
 import { AvatarAccountVariant } from '../../types';
 import { AvatarBaseProps } from '../AvatarBase';
+import { BlockiesProps } from '../temp-components/Blockies';
+import { JazziconProps } from '../temp-components/Jazzicon';
+import { MaskiconProps } from '../temp-components/Maskicon';
 
 /**
  * AvatarAccount component props.
@@ -14,4 +17,16 @@ export type AvatarAccountProps = {
    * @default AvatarAccountVariant.Jazzicon
    */
   variant?: AvatarAccountVariant;
+  /**
+   * Optional props to be passed to the Blockies component
+   */
+  blockiesProps?: Partial<BlockiesProps>;
+  /**
+   * Optional props to be passed to the Jazzicon component
+   */
+  jazziconProps?: Partial<JazziconProps>;
+  /**
+   * Optional props to be passed to the Maskicon component
+   */
+  maskiconProps?: Partial<MaskiconProps>;
 } & Omit<AvatarBaseProps, 'children' | 'fallbackText' | 'fallbackTextProps'>;

packages/design-system-react-native/src/components/AvatarAccount/README.md

@@ -1,6 +1,8 @@
 # AvatarAccount
 
-The `AvatarAccount` component is reserved for representing accounts inside of an avatar. It extends the functionality of [`AvatarBase`](../AvatarBase/) by incorporating an Account and severity levels, making it useful for visually representing statuses, alerts, or simply user avatars with Accounts.
+The `AvatarAccount` component is reserved for representing accounts inside of an avatar.
+
+_Developer Note: It extends the functionality of [`AvatarBase`](../AvatarBase/) by incorporating an Account and severity levels, making it useful for visually representing statuses, alerts, or simply user avatars with Accounts._
 
 ---
 
@@ -32,6 +34,42 @@ Required address used as a unique identifier to generate the AvatarAccount art.
 
 ---
 
+### `blockiesProps`
+
+Optional props to be passed to the `Blockies` component when the variant is `Blockies`.
+
+| TYPE                     | REQUIRED | DEFAULT     |
+| ------------------------ | -------- | ----------- |
+| `Partial<BlockiesProps>` | No       | `undefined` |
+
+Used to customize the `Blockies` identicon, such as block size or color settings.
+
+---
+
+### `jazziconProps`
+
+Optional props to be passed to the `Jazzicon` component when the variant is `Jazzicon`.
+
+| TYPE                     | REQUIRED | DEFAULT     |
+| ------------------------ | -------- | ----------- |
+| `Partial<JazziconProps>` | No       | `undefined` |
+
+Used to customize the `Jazzicon` identicon, such as diameter or address seed.
+
+---
+
+### `maskiconProps`
+
+Optional props to be passed to the `Maskicon` component itself.
+
+| TYPE                     | REQUIRED | DEFAULT     |
+| ------------------------ | -------- | ----------- |
+| `Partial<MaskiconProps>` | No       | `undefined` |
+
+Useful for forwarding additional `SvgProps`, accessibility attributes, or animation styles.
+
+---
+
 ### Other Props
 
 `AvatarAccount` supports all props from [`AvatarBase`](#) except `children`, `fallbackText`, and `fallbackTextProps`. This includes: