Skip to content

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

TypeScript

chore: version packages for v0.0.2

Cindy Zhang9ef214cdac4f
diff --git a/.changeset/config.json b/.changeset/config.json
index f9071789ae..20b8491186 100644
--- a/.changeset/config.json
+++ b/.changeset/config.json
@@ -7,5 +7,8 @@
"access": "public",
"baseBranch": "main",
"updateInternalDependencies": "patch",
- "ignore": ["@xds/storybook", "@xds/docs", "@xds/sandbox"]
+ "ignore": [
+ "@xds/storybook",
+ "@xds/sandbox"
+ ]
}
diff --git a/.changeset/v002-release.md b/.changeset/v002-release.md
deleted file mode 100644
index a8b92222d5..0000000000
--- a/.changeset/v002-release.md
+++ /dev/null
@@ -1,105 +0,0 @@
----
-'@xds/core': minor
-'@xds/cli': minor
-'@xds/theme-default': minor
-'@xds/theme-neutral': minor
----
-
-## 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 build-theme`
-
-### 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.
-
-### Breaking changes (all have codemods)
-
-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\*)
-
-### 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
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
new file mode 100644
index 0000000000..23a505fb8a
--- /dev/null
+++ b/packages/cli/CHANGELOG.md
@@ -0,0 +1,102 @@
+# @xds/cli
+
+## 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 build-theme`
+
+ ### 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.
+
+ ### Breaking changes (all have codemods)
+
+ 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\*)
+
+ ### 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
diff --git a/packages/cli/package.json b/packages/cli/package.json
index 5c5d76830c..f00423a9c5 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,7 +1,7 @@
{
"name": "@xds/cli",
- "version": "0.0.1",
- "description": "XDS design system CLI — init, swizzle, theme, templates, and agent docs",
+ "version": "0.0.2",
+ "description": "XDS design system CLI \u2014 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
new file mode 100644
index 0000000000..db47c44cdd
--- /dev/null
+++ b/packages/core/CHANGELOG.md
@@ -0,0 +1,102 @@
+# @xds/core
+
+## 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 build-theme`
+
+ ### 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.
+
+ ### Breaking changes (all have codemods)
+
+ 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\*)
+
+ ### 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
diff --git a/packages/core/package.json b/packages/core/package.json
index f97910aaf4..355e25aa12 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@xds/core",
- "version": "0.0.1",
+ "version": "0.0.2",
"description": "Core XDS components",
"main": "./dist/index.js",
"module": "./dist/index.mjs",
diff --git a/packages/themes/brutalist/CHANGELOG.md b/packages/themes/brutalist/CHANGELOG.md
new file mode 100644
index 0000000000..117f2e47a6
--- /dev/null
+++ b/packages/themes/brutalist/CHANGELOG.md
@@ -0,0 +1,8 @@
+# @xds/theme-brutalist
+
+## 1.0.0
+
+### Patch Changes
+
+- Updated dependencies [76ac780]
diff --git a/packages/themes/brutalist/package.json b/packages/themes/brutalist/package.json
index d5be23222e..c5b2cd9680 100644
--- a/packages/themes/brutalist/package.json
+++ b/packages/themes/brutalist/package.json
@@ -1,6 +1,6 @@
{
"name": "@xds/theme-brutalist",
- "version": "0.0.1",
+ "version": "1.0.0",
"private": false,
"description": "Brutalist theme for XDS — zero radius, monospace, heavy borders",
"license": "MIT",
diff --git a/packages/themes/default/CHANGELOG.md b/packages/themes/default/CHANGELOG.md
new file mode 100644
index 0000000000..4f20b6ece8
--- /dev/null
+++ b/packages/themes/default/CHANGELOG.md
@@ -0,0 +1,107 @@
+# @xds/theme-default
+
+## 1.0.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 build-theme`
+
+ ### 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.
+
+ ### Breaking changes (all have codemods)
+
+ 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\*)
+
+ ### 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
+
+### Patch Changes
+
+- Updated dependencies [76ac780]
diff --git a/packages/themes/default/package.json b/packages/themes/default/package.json
index 067a09590b..ca3a215d5e 100644
--- a/packages/themes/default/package.json
+++ b/packages/themes/default/package.json
@@ -1,6 +1,6 @@
{
"name": "@xds/theme-default",
- "version": "0.0.1",
+ "version": "0.0.2",
"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
new file mode 100644
index 0000000000..45305b9869
--- /dev/null
+++ b/packages/themes/neutral/CHANGELOG.md
@@ -0,0 +1,107 @@
+# @xds/theme-neutral
+
+## 1.0.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 build-theme`
+
+ ### 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.
+
+ ### Breaking changes (all have codemods)
+
+ 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\*)
+
+ ### 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
+
+### Patch Changes
+
+- Updated dependencies [76ac780]
diff --git a/packages/themes/neutral/package.json b/packages/themes/neutral/package.json
index 9f9fe0db7c..9bec192004 100644
--- a/packages/themes/neutral/package.json
+++ b/packages/themes/neutral/package.json
@@ -1,6 +1,6 @@
{
"name": "@xds/theme-neutral",
- "version": "0.0.1",
+ "version": "0.0.2",
"private": false,
"description": "Neutral theme for XDS components (Lucide icons)",
"license": "MIT",