Allow React.ReactNode as Token content

.changeset/strong-doors-begin.md

@@ -0,0 +1,5 @@
+---
+"@primer/react": patch
+---
+
+Allow `React.ReactNode` as `Token` content

src/Token/Token.tsx

@@ -6,6 +6,7 @@ import TokenBase, {defaultTokenSize, isTokenInteractive, TokenBaseProps} from '.
 import RemoveTokenButton from './_RemoveTokenButton'
 import TokenTextContainer from './_TokenTextContainer'
 import {ForwardRefComponent as PolymorphicForwardRefComponent} from '../utils/polymorphic'
+import VisuallyHidden from '../_VisuallyHidden'
 
 // Omitting onResize and onResizeCapture because seems like React 18 types includes these menthod in the expansion but React 17 doesn't.
 // TODO: This is a temporary solution until we figure out why these methods are causing type errors.
@@ -94,6 +95,7 @@ const Token = forwardRef((props, forwardedRef) => {
         </LeadingVisualContainer>
       ) : null}
       <TokenTextContainer {...(hasMultipleActionTargets ? interactiveTokenProps : {})}>{text}</TokenTextContainer>
+      {onRemove && <VisuallyHidden> (press backspace or delete to remove)</VisuallyHidden>}
       {!hideRemoveButton && onRemove ? (
         <RemoveTokenButton
           borderOffset={tokenBorderWidthPx}

src/Token/TokenBase.tsx

@@ -40,7 +40,7 @@ export interface TokenBaseProps
   /**
    * The text label inside the token
    */
-  text: string
+  text: React.ReactNode
   /**
    * A unique identifier that can be associated with the token
    */
@@ -126,25 +126,22 @@ const StyledTokenBase = styled.span<
   ${sx}
 `
 
-const TokenBase = React.forwardRef(
-  ({text, onRemove, onKeyDown, id, size = defaultTokenSize, ...rest}, forwardedRef) => {
-    return (
-      <StyledTokenBase
-        onKeyDown={(event: KeyboardEvent<HTMLSpanElement & HTMLAnchorElement & HTMLButtonElement>) => {
-          onKeyDown && onKeyDown(event)
+const TokenBase = React.forwardRef(({onRemove, onKeyDown, id, size = defaultTokenSize, ...rest}, forwardedRef) => {
+  return (
+    <StyledTokenBase
+      onKeyDown={(event: KeyboardEvent<HTMLSpanElement & HTMLAnchorElement & HTMLButtonElement>) => {
+        onKeyDown && onKeyDown(event)
 
-          if ((event.key === 'Backspace' || event.key === 'Delete') && onRemove) {
-            onRemove()
-          }
-        }}
-        aria-label={onRemove ? `${text}, press backspace or delete to remove` : undefined}
-        id={id?.toString()}
-        size={size}
-        {...rest}
-        ref={forwardedRef}
-      />
-    )
-  },
-) as PolymorphicForwardRefComponent<'span' | 'a' | 'button', TokenBaseProps & SxProp>
+        if ((event.key === 'Backspace' || event.key === 'Delete') && onRemove) {
+          onRemove()
+        }
+      }}
+      id={id?.toString()}
+      size={size}
+      {...rest}
+      ref={forwardedRef}
+    />
+  )
+}) as PolymorphicForwardRefComponent<'span' | 'a' | 'button', TokenBaseProps & SxProp>
 
 export default TokenBase

src/__tests__/TextInputWithTokens.test.tsx

@@ -495,7 +495,7 @@ describe('TextInputWithTokens', () => {
       jest.runAllTimers()
     })
 
-    expect(document.activeElement?.textContent).toBe(mockTokens[1].text)
+    expect(document.activeElement?.textContent).toContain(mockTokens[1].text)
 
     jest.useRealTimers()
   })