Release 44.0.0

This release adds Toast/Toaster and Tag to React, ListItem to React Native, aligns the TextButton API across platforms, and standardizes severity vocabulary (Error → Danger) across AvatarIcon, IconAlert, and Tag.

📦 Package Versions

• @metamask/design-system-shared: 0.22.0
• @metamask/design-system-react: 0.26.0
• @metamask/design-system-react-native: 0.29.0

🔄 Shared Type Updates (0.22.0)

New shared types (#1190, #1203, #1224, #1225)

What Changed:

• Added ToastPropsShared and ToastSeverity for cross-platform Toast support
• Added ListItemPropsShared and related types for cross-platform ListItem support
• Added TextButtonPropsShared to align TextButton API across React and React Native
• Added AvatarNetworkSize as a named export from the shared package

Impact:

• Enables consistent Toast and ListItem implementations across both platforms
• Continues ADR-0003/0004 const-object + string-union pattern adoption

Severity vocabulary: .Error → .Danger (#1159)

What Changed:

• AvatarIconSeverity.Error → AvatarIconSeverity.Danger
• IconAlertSeverity.Error → IconAlertSeverity.Danger
• TagSeverity.Error → TagSeverity.Danger

Impact:

• Breaking change for any consumer using .Error on these three const objects. Rendered colors are unchanged.

🌐 React Web Updates (0.26.0)

Added

• Added Tag component for categorization and filtering labels (#1211)
• Added Toast component with Toaster provider and imperative toast() API (#1190)

Changed

• BREAKING: TextButton API aligned with React Native — size/TextButtonSize replaced by variant/TextVariant; isInverse, isDisabled, textProps, and icon/accessory props removed; asChild added (#1224)
• BREAKING: AvatarIconSeverity.Error → AvatarIconSeverity.Danger (#1159)

Fixed

• Fixed Toast to support toast() calls made before Toaster mounts (#1217)

📱 React Native Updates (0.29.0)

Added

• Added ListItem component for list row layouts (#1203)
• Added Toast component with Toaster provider and imperative toast() API (#1190)

Changed

• BREAKING: AvatarIconSeverity.Error, IconAlertSeverity.Error, and TagSeverity.Error → .Danger (#1159)

⚠️ Breaking Changes

TextButton rewrite (React Web Only)

What Changed:

• size / TextButtonSize removed — use variant / TextVariant instead
• isInverse, isDisabled, textProps, start/end icons, and accessory slots removed
• asChild added for semantic link composition

Migration:

// Before (0.25.0)
import { TextButton, TextButtonSize } from '@metamask/design-system-react';
<TextButton size={TextButtonSize.BodySm}>Learn more</TextButton>

// After (0.26.0)
import { TextButton } from '@metamask/design-system-react';
import { TextVariant } from '@metamask/design-system-shared';
<TextButton variant={TextVariant.BodySm}>Learn more</TextButton>

See React Migration Guide

Severity vocabulary: .Error → .Danger (Both Platforms)

What Changed:

• AvatarIconSeverity.Error → AvatarIconSeverity.Danger (React + React Native)
• IconAlertSeverity.Error → IconAlertSeverity.Danger (React Native)
• TagSeverity.Error → TagSeverity.Danger (React Native)

Migration:

// Before
<AvatarIcon severity={AvatarIconSeverity.Error} />
<IconAlert severity={IconAlertSeverity.Error} />
<Tag severity={TagSeverity.Error}>High risk</Tag>

// After
<AvatarIcon severity={AvatarIconSeverity.Danger} />
<IconAlert severity={IconAlertSeverity.Danger} />
<Tag severity={TagSeverity.Danger}>High risk</Tag>

See migration guides for complete instructions:

• React Migration Guide
• React Native Migration Guide

✅ Checklist

• Changelogs updated with human-readable descriptions
• Changelog validation passed (yarn changelog:validate)
• Version bumps follow semantic versioning
  • design-system-shared: minor (0.21.0 → 0.22.0) - new shared types + breaking severity rename
  • design-system-react: minor (0.25.0 → 0.26.0) - new components + breaking API changes
  • design-system-react-native: minor (0.28.0 → 0.29.0) - new components + breaking severity rename
• Breaking changes documented with migration guidance
• Migration guides updated with before/after examples
• PR references included in changelog entries

Pre-merge author checklist

• I've followed MetaMask Contributor Docs
• I've reviewed the Release Workflow cursor rule
• All tests pass (yarn build && yarn test && yarn lint)
• Changelog validation passes (yarn changelog:validate)

Pre-merge reviewer checklist

• I've reviewed the Reviewing Release PRs guide
• Package versions follow semantic versioning
• Changelog entries are consumer-facing (not commit message regurgitation)
• Breaking changes are documented in MIGRATION.md with examples
• All unreleased changes are accounted for in changelogs