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 thelabelprop (migrate-badge-children-to-label)
New Features
- Dynamic theming primitives:
radiusScale,motionScale,typeScaleindefineTheme - Motion tokens: duration, easing, and component migration to token-based transitions
- Ratio-based type scale with
typeScaleindefineThemeand 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 (
isCollapsibleprop), 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
labelprop 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 xdsto@layer xds.core.base color-schemein 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:
shnpx 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 --list0.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.6to run them.
See 0.0.6 above for breaking changes and upgrade instructions.
0.0.4
New Components
- XDSTreeList — Hierarchical tree list component with expand/collapse (#609)
- XDSPowerSearch — Advanced search component with result count, filtering (#561, #593)
Features
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 classNameandstyleprops on all components- Numeric spacing scale for
paddingandgap - 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:
shnpx 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 --list12 codemods included:
rename-selector-items-to-options— Selectoritems→optionsunify-visibility-to-onOpenChange— onHide/onClose/onShow/onToggle →onOpenChangeunify-uncontrolled-to-defaultX— initialIsOpen/initialIsExpanded → defaultXrename-banner-endButton-to-endContent— BannerendButton→endContentrename-form-tooltip-startIcon— Formtooltip→labelTooltip,startIcon→labelIconrename-isShown-to-isOpen— Dialog/PopoverisShown→isOpenrename-topnav-title-to-heading— TopNavtitle→heading, TopNavTitle → TopNavHeadingrename-sidenav-header-to-heading— SideNav header → heading, SideNavHeader → SideNavHeadingmigrate-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— Badgeshape="dot"→ StatusDot