4 August 2025

Feature: Use Text component to inherit typography styles automatically

Remove ARIA live region functionality from Notice component in favour of composition with LiveRegion component

Breaking: Refactor contextualItems to use a discriminated union

The contextualItems prop now requires a type field and uses a flat prop structure for each item.

New format:

• { type: 'badge', ...BadgeProps }
• { type: 'tag', ...TagProps }
• { type: 'avatar', ...AvatarProps }
• { type: 'link', icon?, label?, value, href }
• { type: 'button', icon?, label?, value, onClick }
• { type: 'node', icon?, label?, value } (value can be any React content)

Feature: Update actions prop to use discriminated union

This is a breaking change. The actions prop now expects a discriminated union instead of a plain Action[].

Each item must have a type of either 'button' or 'actionsDropdown'. This makes the API more explicit and improves type safety.

Only the first 3 actions are rendered — any additional items are ignored.

Example:

actions={[
  { type: 'button', label: 'Add new', onClick: handleAdd },
  {
    type: 'actionsDropdown',
    actions: [
      { label: 'Export', onClick: handleExport },
      { label: 'Delete', onClick: handleDelete, tone: 'critical' },
    ],
  },
]}

Improvement: Allow avatar prop to accept props or component

The avatar prop now accepts:

• A component: (props) => <Avatar {...props} />
• Or props directly: { name: 'John', src: 'avatar.jpg' }

Breaking: Remove legacy props from PageHeader

• Removed avatar.secondary, badge, and tag from PageHeaderProps

Initial release of LiveRegion component

Feature: Improve accessibility support in the ShowMore component

• Added aria-labelledby and aria-label props to the toggle button
• Applied inert and aria-hidden to the content container when collapsed to prevent keyboard and screen reader access
• Set role="region" on the content container only when expanded to provide a named landmark without cluttering the screen reader rotor

Improvement: Updated TabList to use a nav tag when its children are links, and added aria-current to the active TabItem for improved accessibility.