What's New

Release notes and changelog for all packages.

Unreleased

Fixes
  • --json contract enforcement — Commands that don't support --json now reject the flag in a preAction hook before running any side effects. Previously xds init --json would create files (e.g. .claude/CLAUDE.md) and then emit the unsupported-output error, leaving partial state behind.
  • --json envelope shape documented — Success responses are { type, data }. Error responses are { error, suggestions? }. The --json help text now describes both.
  • xds --version --json — Now emits { type: 'version', data: { version } } instead of plain text.
  • xds --json (no subcommand) — Now emits { type: 'help', data: { commands, jsonSupported, ... } } instead of human help text.
  • xds upgrade --json — The "already up to date" path now emits { type: 'upgrade.status', data: { status: 'up_to_date', ... } }. The "no codemods in version range" path emits { type: 'upgrade.status', data: { status: 'no_codemods', ... } }. The codemod runner is now silent under --json so prompts and progress lines no longer corrupt stdout.
  • xds discover --json — When no packages are configured, the response now includes meta: { configured: false } so consumers can distinguish "configured but empty" from "not configured".
  • xds gap-report --json — Without --component/--category/--reason, returns a structured error instead of starting an interactive prompt. The "gh CLI missing" path also emits a JSON error.
  • xds theme --json — The theme parent command (without a subcommand) now rejects --json cleanly. theme build --json continues to work.

0.0.14

Codemods
  • rename-action-props — Rename on*Action props to *Action (React 19 convention) (#1942)
  • rename-status-variants — Rename positive/negative status to success/error (#2175)
  • rename-section-wash-to-muted — Rename Section wash variant to muted (#2063)
New Features
Fixes

0.0.13

Codemods
  • toolbar-density-to-size — Migrate Toolbar density prop to size (#1448)
  • icon-name-deprecations — Rename checkCircle/xCircle icons to success/error (#1503)
  • rename-attachments-to-drawer — Rename XDSChatComposerAttachments → XDSChatComposerDrawer (#1714)
New Features
  • --skip-install and --force-install flags for xds upgrade (#1547)
  • npx xds docs icons reference + updated icon prop descriptions (#1500)
  • Theme nudge in generated agent docs (#1456)
  • Theme expandColorScale — derive color tokens from accent hex in xds theme build (#1452)
  • Component groups read from doc files instead of hardcoded map (#1650)
  • Page and block template system (#1393)
Fixes
  • Handle prerelease suffixes in semverCompare (#1512)
  • Handle ternary/logical expressions in icon-name-deprecations codemod (#1513)
  • Don't inject XDS block into files without markers during upgrade (#1495)
  • findShowcase matches by directory name and componentsUsed (#1728)
  • Include onMedia CSS in built theme output (#1450)
  • Register codemods for v0.0.13 (moved from v0.0.14) (#1508)
Upgrade
sh
npx xds upgrade --apply --to 0.0.13

0.0.12

Codemods
Upgrade
sh
npx xds upgrade --apply --to 0.0.12

0.0.10

Codemods
Upgrade
sh
npx xds upgrade --apply --to 0.0.10

0.0.8

New Features
  • CLI: tsx parser for .ts files
  • Update hints in postAction hook
Codemods
  • rename-endslot-to-endcontent — Button endSlot → endContent (#895)
  • migrate-token-renames — Token name migration to v0.0.8 convention
Upgrade
sh
npx xds upgrade --apply --to 0.0.8

0.0.7

Codemods
  • rename-banner-variant-to-container — Banner variant → container (#814)
Upgrade
sh
npx xds upgrade --apply --to 0.0.7

0.0.6

Codemods
  • migrate-token-names — Design token renames per naming audit
  • migrate-shadow-tokens — Elevation → shadow semantic naming
  • migrate-collapse-to-collapsible — XDSCollapse → XDSCollapsible
  • migrate-radius-tokens — Semantic radius → numeric scale
  • migrate-skeleton-radius — Skeleton radius prop → numeric scale
  • migrate-badge-children-to-label — Badge children → label prop
Upgrade
sh
npx xds upgrade --apply --to 0.0.6

0.0.5

New Features
  • Generate agent cheat sheet from live CLI metadata (#640)
  • --detail and --lang flags for typed .doc.mjs output (#636)
  • Fold agent-docs into init with --features flag (#639)

Note: Codemods for v0.0.5 breaking changes are registered under v0.0.6. Use --to 0.0.6.

0.0.4

Features
  • xds theme build — Renamed from build-theme to theme build (#570)
  • --lang flag — TranslationDoc support for i18n/compressed docs (#611)
  • --zh flag — Chinese Simplified doc output (#567)
Refactors
  • Split component.mjs into lib/ modules with lazy command registry (#613)

0.0.3

Patch Changes
  • Sync package.json exports map
  • Add verify-exports CI check (#537)

0.0.2

New Features
  • xds upgrade command with codemod support
  • xds theme build (formerly build-theme)
Codemods

12 codemods for the v0.0.2 breaking changes:

  • rename-selector-items-to-options — Selector items → options
  • unify-visibility-to-onOpenChange — Visibility callbacks → onOpenChange
  • unify-uncontrolled-to-defaultX — Uncontrolled state → defaultX pattern
  • 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
  • rename-sidenav-header-to-heading — SideNav header → heading
  • migrate-useXDSIcon-to-getIcon — useXDSIcon() → getIcon()
  • migrate-gap-to-numeric — String gap tokens → numeric
  • migrate-isFullBleed-to-padding — isFullBleed → padding={0}
  • migrate-badge-dot-to-statusdot — Badge dot → StatusDot
Upgrade
sh
npx xds upgrade --apply --to 0.0.2

0.0.1

  • Initial release