Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

chore: version packages for v0.0.5 (#711)

Cindy Zhangdb33f2171d44
diff --git a/.changeset/v003-release.md b/.changeset/v003-release.md
deleted file mode 100644
index f29f957f92..0000000000
--- a/.changeset/v003-release.md
+++ /dev/null
@@ -1,15 +0,0 @@
----
-'@xds/core': patch
-'@xds/cli': patch
-'@xds/theme-default': patch
-'@xds/theme-neutral': patch
----
-
-v0.0.3 release — packaging and theming improvements for CDN consumers.
-
-- Bundle StyleX runtime — consumers no longer need @stylexjs/stylex as a 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)
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 764758425c..558f74d92d 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -1,10 +1,24 @@
# @xds/cli
+## 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)
+
+### Codemods
+
+- 5 new codemods for v0.0.5: `migrate-token-names`, `migrate-shadow-tokens`, `migrate-collapse-to-collapsible`, `migrate-radius-tokens`, `migrate-skeleton-radius`
+
+**Upgrade consumers:** `npx xds upgrade --apply`
+
## 0.0.4
### Features
-- **`xds theme build`** — Renamed from `build-theme` to `theme build`, establishing `xds theme` command group (#570)
+- **`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)
@@ -16,103 +30,16 @@
### Patch Changes
-## 0.1.0
-
-### Minor Changes
-
-- 76ac780: ## 0.0.2 Release
-
- ### New: CSS-based theming (replaces StyleX theme system)
-
- The StyleX-based theme system (`stylex.createTheme`, `ComponentStyles` context) has been replaced with a CSS-based approach using `defineTheme()`.
-
- **Migration:**
-
- ```tsx
- // Before (0.0.1)
- import { defaultTheme } from '@xds/theme-default';
- <XDSTheme theme={defaultTheme}>
-
- // After (0.0.2) — same API, new internals
- import { defaultTheme } from '@xds/theme-default';
- import '@xds/theme-default/theme.css'; // NEW: import the theme CSS
- <XDSTheme theme={defaultTheme}>
- ```
-
- Custom themes now use `defineTheme()`:
-
- ```tsx
- import {defineTheme} from '@xds/core';
+- Sync package.json exports map
+- Add verify-exports CI check (#537)
- const myTheme = defineTheme({
- name: 'my-theme',
- tokens: {
- '--color-accent': ['#0077B6', '#48CAE4'], // [light, dark]
- },
- components: {
- button: {base: {borderRadius: '999px'}},
- },
- icons: myIcons,
- });
- ```
+## 0.0.2
- Build theme CSS with: `npx xds theme build`
-
- ### New: `className` and `style` props on all components
-
- All components now accept `className` and `style` alongside `xstyle`. Use Tailwind, CSS modules, or plain CSS — no StyleX build requirement for consumers.
-
- ```tsx
- <XDSCard className="max-w-md shadow-lg" />
- <XDSCard style={{ maxWidth: 400 }} />
- <XDSCard xstyle={myStyleXOverrides} /> // still works
- ```
-
- ### New: Numeric spacing scale for `padding` and `gap`
-
- Layout components accept a numeric `padding` prop. Stack and Grid `gap` migrated from string tokens to numbers.
-
- ```tsx
- // Before
- <XDSStack gap="space4">
- <XDSCard isFullBleed>
-
- // After
- <XDSStack gap={4}>
- <XDSCard padding={0}>
- ```
-
- Scale: 0=0px, 1=4px, 2=8px, 3=12px, 4=16px (default), 6=24px, 8=32px, 10=40px.
-
- **Codemod:** `npx xds upgrade --apply`
-
- ### New: RSC-compatible icon registry
-
- Icons now use a global registry instead of React Context:
-
- ```tsx
- import {registerIcons, getIcon} from '@xds/core';
- registerIcons(myIcons); // works in RSC — no 'use client' needed
- const icon = getIcon('close'); // no hooks required
- ```
-
- ### New: React 19 ref prop
-
- All 64 components migrated from `forwardRef` to the React 19 `ref` prop pattern. No consumer changes needed — `ref` works the same way.
+### Features
- ### Breaking changes (all have codemods)
+- `xds upgrade` command with codemod support
+- `xds theme build` (formerly `build-theme`)
- Run `npx xds upgrade --apply` to auto-migrate:
- - `XDSTopNavTitle` → `XDSTopNavHeading`, prop `title` → `heading`
- - `XDSSideNavHeader` → `XDSSideNavHeading`, props `title/titleHref/supertitle/subtitle` → `heading/headingHref/superheading/subheading`
- - `useXDSIcon()` → `getIcon()`, `IconRegistryContext` removed
- - `gap="space4"` → `gap={4}` (numeric scale)
- - `isFullBleed` → `padding={0}` (on Card, Section, Layout\*)
+## 0.0.1
- ### Bug fixes
- - Badge height fixed to 20px
- - Token medium padding reduced to 8px
- - Card border uses opaque color for consistency across backgrounds
- - DateInput autocomplete disabled
- - SideNav 8px spacing alignment
- - Breadcrumbs text centering
+- Initial release
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 788d7e2489..a94c4a3a44 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,7 +1,7 @@
{
"name": "@xds/cli",
- "version": "0.0.4",
- "description": "XDS design system CLI \u2014 init, swizzle, theme, templates, and agent docs",
+ "version": "0.0.5",
+ "description": "XDS design system CLI — init, swizzle, theme, templates, and agent docs",
"type": "module",
"bin": {
"xds": "./bin/xds.mjs"
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 858155c453..8bb701d629 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -1,5 +1,42 @@
# @xds/core
+## 0.0.5
+
+### Breaking Changes (codemods included)
+
+- Rename design tokens per naming audit (`migrate-token-names`)
+- Rename elevation tokens to `shadow-base`/`shadow-menu`/`shadow-hover`/`shadow-dialog` + `insetshadow-border-*` (`migrate-shadow-tokens`)
+- Rename `XDSCollapse` → `XDSCollapsible` (`migrate-collapse-to-collapsible`)
+- Dynamic radius tokens — numeric scale with `radiusScale` config (`migrate-radius-tokens`, `migrate-skeleton-radius`)
+
+**Upgrade:** `npx xds upgrade --apply`
+
+### 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
+
+- CheckboxInput & Switch focus rings + indeterminate aria
+- MegaMenu uniform border radius, TopNav menu positioning/keyboard/focus trapping
+- Popover background transparency, DropdownMenu elevation tokens
+- Badge hardcoded height → spacing token
+- 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
+
## 0.0.4
### New Components
@@ -9,16 +46,16 @@
### Features
-- **AppShell variant system** — New `variant` prop (`wash`, `surface`, `section`, `elevated`) replaces `background` prop (#597)
-- **AppShell contentPadding** — New `contentPadding` prop for controlling content area padding (#612)
-- **AppShell auto height mode** — Sidenav and sticky backgrounds in auto height mode (#615)
-- **startIcon** — Added startIcon support (#584)
+- **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
-- Removed deprecated `isFullBleed` prop from Card and Section — use `padding={0}` instead (#610, #598)
+- Removed deprecated `isFullBleed` prop from Card and Section (#610, #598)
- Layout: `padding={0}` treated as equivalent to `isFullBleed` (#595)
-- SideNav: consistent spacing regardless of header/topContent visibility (#601)
+- SideNav: consistent spacing (#601)
- Nav: consistent gap and heading text sizes (#616)
### Refactors
@@ -29,103 +66,27 @@
### Patch Changes
-## 0.1.0
-
-### Minor Changes
-
-- 76ac780: ## 0.0.2 Release
-
- ### New: CSS-based theming (replaces StyleX theme system)
-
- The StyleX-based theme system (`stylex.createTheme`, `ComponentStyles` context) has been replaced with a CSS-based approach using `defineTheme()`.
-
- **Migration:**
-
- ```tsx
- // Before (0.0.1)
- import { defaultTheme } from '@xds/theme-default';
- <XDSTheme theme={defaultTheme}>
-
- // After (0.0.2) — same API, new internals
- import { defaultTheme } from '@xds/theme-default';
- import '@xds/theme-default/theme.css'; // NEW: import the theme CSS
- <XDSTheme theme={defaultTheme}>
- ```
-
- Custom themes now use `defineTheme()`:
-
- ```tsx
- import {defineTheme} from '@xds/core';
-
- const myTheme = defineTheme({
- name: 'my-theme',
- tokens: {
- '--color-accent': ['#0077B6', '#48CAE4'], // [light, dark]
- },
- components: {
- button: {base: {borderRadius: '999px'}},
- },
- icons: myIcons,
- });
- ```
-
- Build theme CSS with: `npx xds theme build`
-
- ### New: `className` and `style` props on all components
-
- All components now accept `className` and `style` alongside `xstyle`. Use Tailwind, CSS modules, or plain CSS — no StyleX build requirement for consumers.
-
- ```tsx
- <XDSCard className="max-w-md shadow-lg" />
- <XDSCard style={{ maxWidth: 400 }} />
- <XDSCard xstyle={myStyleXOverrides} /> // still works
- ```
-
- ### New: Numeric spacing scale for `padding` and `gap`
-
- Layout components accept a numeric `padding` prop. Stack and Grid `gap` migrated from string tokens to numbers.
-
- ```tsx
- // Before
- <XDSStack gap="space4">
- <XDSCard isFullBleed>
-
- // After
- <XDSStack gap={4}>
- <XDSCard padding={0}>
- ```
-
- Scale: 0=0px, 1=4px, 2=8px, 3=12px, 4=16px (default), 6=24px, 8=32px, 10=40px.
-
- **Codemod:** `npx xds upgrade --apply`
-
- ### New: RSC-compatible icon registry
-
- Icons now use a global registry instead of React Context:
+- 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)
- ```tsx
- import {registerIcons, getIcon} from '@xds/core';
- registerIcons(myIcons); // works in RSC — no 'use client' needed
- const icon = getIcon('close'); // no hooks required
- ```
+## 0.0.2
- ### New: React 19 ref prop
+### Breaking Changes (codemods included)
- All 64 components migrated from `forwardRef` to the React 19 `ref` prop pattern. No consumer changes needed — `ref` works the same way.
+- 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}`
- ### Breaking changes (all have codemods)
+**Codemod:** `npx xds upgrade --apply`
- Run `npx xds upgrade --apply` to auto-migrate:
- - `XDSTopNavTitle` → `XDSTopNavHeading`, prop `title` → `heading`
- - `XDSSideNavHeader` → `XDSSideNavHeading`, props `title/titleHref/supertitle/subtitle` → `heading/headingHref/superheading/subheading`
- - `useXDSIcon()` → `getIcon()`, `IconRegistryContext` removed
- - `gap="space4"` → `gap={4}` (numeric scale)
- - `isFullBleed` → `padding={0}` (on Card, Section, Layout\*)
+## 0.0.1
- ### Bug fixes
- - Badge height fixed to 20px
- - Token medium padding reduced to 8px
- - Card border uses opaque color for consistency across backgrounds
- - DateInput autocomplete disabled
- - SideNav 8px spacing alignment
- - Breadcrumbs text centering
+- Initial release
diff --git a/packages/core/package.json b/packages/core/package.json
index faa4b40736..7065785bae 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@xds/core",
- "version": "0.0.4",
+ "version": "0.0.5",
"description": "Core XDS components",
"main": "./dist/index.js",
"module": "./dist/index.mjs",
diff --git a/packages/lab/CHANGELOG.md b/packages/lab/CHANGELOG.md
new file mode 100644
index 0000000000..2a3b2bd4cf
--- /dev/null
+++ b/packages/lab/CHANGELOG.md
@@ -0,0 +1,8 @@
+# @xds/lab
+
+## 0.0.5
+
+### Patch Changes
+
+- Updated dependencies
diff --git a/packages/lab/package.json b/packages/lab/package.json
index 9ae6d61384..21d742b13c 100644
--- a/packages/lab/package.json
+++ b/packages/lab/package.json
@@ -1,6 +1,6 @@
{
"name": "@xds/lab",
- "version": "0.0.1",
+ "version": "0.0.5",
"private": true,
"description": "Experimental XDS components — not published, available in storybook and sandbox for testing",
"main": "./src/index.ts",
diff --git a/packages/themes/brutalist/CHANGELOG.md b/packages/themes/brutalist/CHANGELOG.md
index cd486af4c6..873771d078 100644
--- a/packages/themes/brutalist/CHANGELOG.md
+++ b/packages/themes/brutalist/CHANGELOG.md
@@ -1,5 +1,11 @@
# @xds/theme-brutalist
+## 0.0.5
+
+### Patch Changes
+
+- Aligned version with other packages
+
## 0.0.4
### Minor Changes
diff --git a/packages/themes/brutalist/package.json b/packages/themes/brutalist/package.json
index e4841a1feb..db1ef46f68 100644
--- a/packages/themes/brutalist/package.json
+++ b/packages/themes/brutalist/package.json
@@ -1,7 +1,7 @@
{
"name": "@xds/theme-brutalist",
- "version": "0.0.4",
- "private": false,
+ "version": "0.0.5",
+ "private": true,
"description": "Brutalist theme for XDS — zero radius, monospace, heavy borders",
"license": "MIT",
"sideEffects": false,
diff --git a/packages/themes/default/CHANGELOG.md b/packages/themes/default/CHANGELOG.md
index 29860696e5..a61871c1a9 100644
--- a/packages/themes/default/CHANGELOG.md
+++ b/packages/themes/default/CHANGELOG.md
@@ -1,5 +1,18 @@
# @xds/theme-default
+## 0.0.5
+
+### Changes
+
+- Updated token names to match naming audit (shadow, radius, elevation renames)
+- Motion token primitives: duration and easing values
+- Dynamic radius and type scale support via `defineTheme` config
+
+### Patch Changes
+
+- Updated dependencies
+
## 0.0.4
### Patch Changes
@@ -9,3 +22,15 @@
## 0.0.3
### Patch Changes
+
+- Fix theme package to produce proper JS/TS module output via tsup (#541)
+
+## 0.0.2
+
+### Changes
+
+- Migrated to CSS-based theming with `defineTheme()`
+
+## 0.0.1
+
+- Initial release — default theme with Heroicons
diff --git a/packages/themes/default/package.json b/packages/themes/default/package.json
index adc6606494..8faac9b120 100644
--- a/packages/themes/default/package.json
+++ b/packages/themes/default/package.json
@@ -1,6 +1,6 @@
{
"name": "@xds/theme-default",
- "version": "0.0.4",
+ "version": "0.0.5",
"private": false,
"description": "Default theme for XDS components (Heroicons)",
"license": "MIT",
diff --git a/packages/themes/neutral/CHANGELOG.md b/packages/themes/neutral/CHANGELOG.md
index 32b1abc851..2504891a1a 100644
--- a/packages/themes/neutral/CHANGELOG.md
+++ b/packages/themes/neutral/CHANGELOG.md
@@ -1,5 +1,18 @@
# @xds/theme-neutral
+## 0.0.5
+
+### Changes
+
+- Updated token names to match naming audit (shadow, radius, elevation renames)
+- Motion token primitives: duration and easing values
+- Dynamic radius and type scale support via `defineTheme` config
+
+### Patch Changes
+
+- Updated dependencies
+
## 0.0.4
### Patch Changes
@@ -9,3 +22,15 @@
## 0.0.3
### Patch Changes
+
+- Fix theme package to produce proper JS/TS module output via tsup (#541)
+
+## 0.0.2
+
+### Changes
+
+- Migrated to CSS-based theming with `defineTheme()`
+
+## 0.0.1
+
+- Initial release — neutral theme with Lucide icons
diff --git a/packages/themes/neutral/package.json b/packages/themes/neutral/package.json
index 0b73efee70..89909f8f57 100644
--- a/packages/themes/neutral/package.json
+++ b/packages/themes/neutral/package.json
@@ -1,6 +1,6 @@
{
"name": "@xds/theme-neutral",
- "version": "0.0.4",
+ "version": "0.0.5",
"private": false,
"description": "Neutral theme for XDS components (Lucide icons)",
"license": "MIT",