What's New

Release notes and changelog for all packages.

0.0.6

Breaking Changes
  • Token renames — Design tokens renamed per naming audit: positive → success, negative → error, divider → border, etc. (migrate-token-names)
  • Shadow tokens — Elevation tokens renamed to shadow-base/shadow-menu/shadow-hover/shadow-dialog + insetshadow-border-* (migrate-shadow-tokens)
  • XDSCollapse → XDSCollapsible — Component and prop rename (migrate-collapse-to-collapsible)
  • Radius tokens — Semantic radius tokens renamed to numeric scale (migrate-radius-tokens, migrate-skeleton-radius)
  • Badge children → label — Content passed as children now uses the label prop (migrate-badge-children-to-label)
New Features
  • Dynamic theming primitives: radiusScale, motionScale, typeScale in defineTheme
  • Motion tokens: duration, easing, and component migration to token-based transitions
  • Ratio-based type scale with typeScale in defineTheme and 4px grid snapping
  • Mobile-responsive AppShell: responsive mobile nav API, autoMobileTopBar, entry animations
  • TopNav mobile rendering: responsive menu, MegaMenu composed children API + mobile drawer
  • SideNav: collapsible sidebar (isCollapsible prop), resizable sidebar with drag handle
  • PowerSearch: filter implementation with nested filters
  • TreeList component
  • NavItem component
  • Shared theme CSS generation, removed XDSFontWrapper
Fixes
  • Badge: hardcoded height → spacing token; add label prop for API consistency (#709)
  • CheckboxInput & Switch: focus rings + indeterminate aria (#723)
  • Kbd: platform detection for mod key (#722)
  • MegaMenu: uniform border radius, TopNav menu positioning/keyboard/focus trapping
  • Popover: background transparency, DropdownMenu elevation tokens
  • Collapsible: hardcoded fontSize/transition → tokens
  • AppShell: hardcoded spacing → spacing tokens
  • Dist CSS layer renamed from @layer xds to @layer xds.core.base
  • color-scheme in reset.css for lightningcss light-dark() compatibility
  • Sync package.json exports (NavItem, remove stale typography.css)
  • Type-scale: use Math.round for 4px grid snapping in computeLeading
Upgrade
Codemods are available for all breaking changes in this release:
sh
npx astryx upgrade --apply --to 0.0.6
Preview changes first (dry run): npx astryx upgrade --to 0.0.6 List all available codemods: npx astryx upgrade --list

0.0.5

Note: v0.0.5 was the published version. Codemods for this release are registered under v0.0.6 in the CLI. Use --to 0.0.6 to run them.
See 0.0.6 above for breaking changes and upgrade instructions.

0.0.4

New Components
Features
  • AppShell variant system — New variant prop (#597)
  • AppShell contentPadding — New contentPadding prop (#612)
  • AppShell auto height mode — Sidenav and sticky backgrounds (#615)
  • startIcon support (#584)
Fixes
Refactors

0.0.3

Patch Changes
  • Bundle StyleX runtime — consumers no longer need @stylexjs/stylex as peer dependency (#545)
  • Add stable token export path at @xds/core/tokens (#544)
  • Replace null style overrides with explicit values, add lint rule (#547)
  • Fix theme packages to produce proper JS/TS module output via tsup (#541)
  • Sync package.json exports map
  • Add verify-exports CI check (#537)

0.0.2

Breaking Changes
  • CSS-based theming replaces StyleX theme system — defineTheme() API
  • className and style props on all components
  • Numeric spacing scale for padding and gap
  • RSC-compatible icon registry (registerIcons/getIcon)
  • React 19 ref prop migration
  • Renames: TopNavTitle → TopNavHeading, SideNavHeader → SideNavHeading, useXDSIcon → getIcon
  • gap="space4" → gap={4}, isFullBleed → padding={0}
  • Badge dot → StatusDot
Upgrade
Codemods are available for all breaking changes in this release:
sh
npx astryx upgrade --apply --to 0.0.2
Preview changes first (dry run): npx astryx upgrade --to 0.0.2 List all available codemods: npx astryx upgrade --list
12 codemods included:
  • rename-selector-items-to-options — Selector items → options
  • unify-visibility-to-onOpenChange — onHide/onClose/onShow/onToggle → onOpenChange
  • unify-uncontrolled-to-defaultX — initialIsOpen/initialIsExpanded → defaultX
  • rename-banner-endButton-to-endContent — Banner endButton → endContent
  • rename-form-tooltip-startIcon — Form tooltip → labelTooltip, startIcon → labelIcon
  • rename-isShown-to-isOpen — Dialog/Popover isShown → isOpen
  • rename-topnav-title-to-heading — TopNav title → heading, TopNavTitle → TopNavHeading
  • rename-sidenav-header-to-heading — SideNav header → heading, SideNavHeader → SideNavHeading
  • migrate-useXDSIcon-to-getIcon — useXDSIcon() → getIcon()
  • migrate-gap-to-numeric — gap="space4" → gap={4}
  • migrate-isFullBleed-to-padding — isFullBleed → padding={0}
  • migrate-badge-dot-to-statusdot — Badge shape="dot" → StatusDot