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.jsonindex 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.mddeleted file mode 100644index 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 centeringdiff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.mdnew file mode 100644index 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 centeringdiff --git a/packages/cli/package.json b/packages/cli/package.jsonindex 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.mdnew file mode 100644index 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 centeringdiff --git a/packages/core/package.json b/packages/core/package.jsonindex 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.mdnew file mode 100644index 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]+ - @xds/[email protected]diff --git a/packages/themes/brutalist/package.json b/packages/themes/brutalist/package.jsonindex 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.mdnew file mode 100644index 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]+ - @xds/[email protected]diff --git a/packages/themes/default/package.json b/packages/themes/default/package.jsonindex 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.mdnew file mode 100644index 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]+ - @xds/[email protected]diff --git a/packages/themes/neutral/package.json b/packages/themes/neutral/package.jsonindex 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",