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.mddeleted file mode 100644index 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.mdindex 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 releasediff --git a/packages/cli/package.json b/packages/cli/package.jsonindex 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.mdindex 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 releasediff --git a/packages/core/package.json b/packages/core/package.jsonindex 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.mdnew file mode 100644index 0000000000..2a3b2bd4cf--- /dev/null+++ b/packages/lab/CHANGELOG.md@@ -0,0 +1,8 @@+# @xds/lab++## 0.0.5++### Patch Changes++- Updated dependencies+ - @xds/[email protected]diff --git a/packages/lab/package.json b/packages/lab/package.jsonindex 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.mdindex 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 Changesdiff --git a/packages/themes/brutalist/package.json b/packages/themes/brutalist/package.jsonindex 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.mdindex 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+ - @xds/[email protected]+## 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 Heroiconsdiff --git a/packages/themes/default/package.json b/packages/themes/default/package.jsonindex 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.mdindex 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+ - @xds/[email protected]+## 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 iconsdiff --git a/packages/themes/neutral/package.json b/packages/themes/neutral/package.jsonindex 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",