Skip to content

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

TypeScript

chore(release): version packages 0.1.1 (#3147)

Cindy Zhanga514b9915151
diff --git a/.changeset/build-astryx-exports.md b/.changeset/build-astryx-exports.md
deleted file mode 100644
index 6423ec9017..0000000000
--- a/.changeset/build-astryx-exports.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-'@astryxdesign/build': patch
----
-
-[breaking] Rename `@xds/build` exports off the xds name
-@ejhammond
-
-The Vite integration's public exports are renamed: `xdsStylex` -> `astryxStylex`,
-and the option types `XDSVitePluginOptions` / `XDSVitePluginLegacyOptions` ->
-`AstryxVitePluginOptions` / `AstryxVitePluginLegacyOptions`. Update imports from
-`@xds/build/vite` accordingly. Internal plugin names and the babel wrapper are
-also rebranded. Part of removing `xds` naming from the public API.
diff --git a/.changeset/build-with-astryx.md b/.changeset/build-with-astryx.md
deleted file mode 100644
index 9b618a7d61..0000000000
--- a/.changeset/build-with-astryx.md
+++ /dev/null
@@ -1,11 +0,0 @@
----
-'@astryxdesign/build': patch
----
-
-[breaking] Rename Next.js helper `withXDS` to `withAstryx`
-@ejhammond
-
-The Next.js configuration wrapper is renamed `withXDS` -> `withAstryx`
-(exported from `@astryxdesign/build/next`). Update your `next.config.mjs`:
-`import {withAstryx} from '@astryxdesign/build/next'`. Part of removing xds
-naming from the public API.
diff --git a/.changeset/chatlayoutscrollbutton-label-padding.md b/.changeset/chatlayoutscrollbutton-label-padding.md
deleted file mode 100644
index d2b9ce9b46..0000000000
--- a/.changeset/chatlayoutscrollbutton-label-padding.md
+++ /dev/null
@@ -1,13 +0,0 @@
----
-'@astryxdesign/core': patch
----
-
-[fix] Increase trailing padding on `ChatLayoutScrollButton` when a label is shown
-@cixzhang
-
-With a label (e.g. "New messages"), the chevron icon sits on the leading edge
-and the text on the trailing edge. The symmetric inline padding left the label
-text cramped against the pill's rounded corner. The trailing inline padding is
-now widened when a label is present, giving the text comfortable breathing room
-from the rounded edge. The icon-only (collapsed) state is unchanged and stays
-balanced.
diff --git a/.changeset/cli-bin-symlink-resolution.md b/.changeset/cli-bin-symlink-resolution.md
deleted file mode 100644
index e161ce2c68..0000000000
--- a/.changeset/cli-bin-symlink-resolution.md
+++ /dev/null
@@ -1,13 +0,0 @@
----
-'@astryxdesign/cli': patch
----
-
-[fix] `npx astryx` now works when the CLI is installed as a real npm package.
-The bin imported its `../src/*` modules relative to the invoked path, so running
-through the `node_modules/.bin/astryx` symlink made them resolve outside the
-package (`ERR_MODULE_NOT_FOUND: .../node_modules/src/...`) on Node versions that
-don't realpath the bin entry. It now resolves siblings via the bin's real path
-(realpath of `import.meta.url`), working whether invoked via symlink, copy, or
-Windows shim. Also fixes the non-interactive `init`/`theme` error to say
-`astryx <command>` instead of the stale `xds <command>`.
-@josephfarina
diff --git a/.changeset/cli-build-command.md b/.changeset/cli-build-command.md
deleted file mode 100644
index 2a8ad92259..0000000000
--- a/.changeset/cli-build-command.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-'@astryxdesign/cli': patch
----
-
-[feat] Add `astryx build` command for page composition, with natural-language search ranking.
-
-`build "<idea>"` returns a composition kit — the closest page template, the
-blocks that cover parts, and components to fill gaps, plus a Compose suggestion.
-`build` with no args prints the how-to-build playbook. The shared search ranking
-now handles oblique natural-language queries via tokenization + stopwords, a
-synonym/intent map, light stemming, and page-template keyword enrichment.
-@joeyfarina
diff --git a/.changeset/cli-build-first-docs.md b/.changeset/cli-build-first-docs.md
deleted file mode 100644
index e0b169e06c..0000000000
--- a/.changeset/cli-build-first-docs.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-'@astryxdesign/cli': patch
----
-
-[feat] Make generated agent docs build-first and restructure `init` output.
-
-The generated `CLAUDE.md` now leads with the `build` workflow (search reframed as
-a neutral universal find), and includes a required-CSS setup note
-(`reset.css` + `astryx.css`) so components never render unstyled. `init` now
-points agents at `astryx build`/`astryx search` instead of dumping page-template
-names.
-@joeyfarina
diff --git a/.changeset/cli-build-kit.md b/.changeset/cli-build-kit.md
deleted file mode 100644
index ebb2d1c61b..0000000000
--- a/.changeset/cli-build-kit.md
+++ /dev/null
@@ -1,14 +0,0 @@
----
-'@astryxdesign/cli': patch
----
-
-[feat] Improve `astryx build` output into a complete composition kit.
-
-`build "<idea>"` now returns an agent-ready kit grouped by role: a START line
-(scaffold vs compose), the closest PAGE template, an always-on FRAME (page
-shell) and FOUNDATION (layout/typography/action primitives), idea-specific
-BLOCKS and DOMAIN COMPONENTS (with a relevance floor to cut noise), and a SETUP
-reminder. The always-on FRAME/FOUNDATION groups fix low recall of the
-structural primitives every page needs but that never keyword-match an idea
-(measured: component recall 15% to 71% on an agent-grounded eval).
-@joeyfarina
diff --git a/.changeset/core-token-defaults-rename.md b/.changeset/core-token-defaults-rename.md
deleted file mode 100644
index de14ffe7f4..0000000000
--- a/.changeset/core-token-defaults-rename.md
+++ /dev/null
@@ -1,10 +0,0 @@
----
-'@astryxdesign/core': patch
----
-
-[breaking] Rename `xdsTokenDefaults` export to `tokenDefaults`
-@ejhammond
-
-The token-defaults constant is renamed from `xdsTokenDefaults` to
-`tokenDefaults` (exported from `@astryxdesign/core/theme`). Update imports
-accordingly. Part of removing xds naming from the public API.
diff --git a/.changeset/dateinput-incomplete-input-crash.md b/.changeset/dateinput-incomplete-input-crash.md
deleted file mode 100644
index 9bb028a16c..0000000000
--- a/.changeset/dateinput-incomplete-input-crash.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-'@astryxdesign/core': patch
----
-
-[fix] Prevent `DateInput` from crashing the page while typing an incomplete
-date. Typing a leading `0` or `1` (e.g. starting to enter `01` for January)
-could coerce the in-progress value into an invalid date with a year of `0`,
-which then threw a `RangeError` and crashed the surrounding page. Partial,
-not-yet-complete input is now treated as incomplete instead of being parsed
-into a date, so the field stays usable as you type.
-
-@cixzhang
diff --git a/.changeset/env-aware-styling-docs.md b/.changeset/env-aware-styling-docs.md
deleted file mode 100644
index d0ee2a5f72..0000000000
--- a/.changeset/env-aware-styling-docs.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-'@astryxdesign/cli': patch
----
-
-[feat] Densify agent docs + tailor styling guidance to the project's configured system
-
-Tightened the generated `CLAUDE.md`/`AGENTS.md` block from ~48 lines to ~26
-(the per-topic `docs` dump collapsed to one line, `build`/`search`/`component`
-no longer duplicated between workflow and reference, run-prefix stated once,
-filler prose removed) — same information, far denser.
-
-`init`/`agent-docs` now detect whether the consumer project has the StyleX
-compiler, Tailwind, or neither, and write the matching custom-styling guidance
-into the generated `CLAUDE.md`/`AGENTS.md`:
-
-- StyleX compiler wired → `xstyle` / StyleX token imports
-- Tailwind → utility classes backed by `@astryxdesign/core/tailwind-theme.css`
-- neither → `style`/`className` with `var(--token)` design tokens, plus an
- explicit note NOT to use `xstyle`/utilities (they would not compile)
-
-Previously the docs hardcoded "use the xstyle prop," which throws at runtime
-(blank page) in a plain Vite app with no StyleX compiler, and ignored the
-Tailwind bridge entirely. Also corrects the token prefix in the theme rule
-(`--astryx-color-*` → `--color-*`).
-@joeyfarina
diff --git a/.changeset/fix-selector-double-focus-ring.md b/.changeset/fix-selector-double-focus-ring.md
deleted file mode 100644
index da00c9518c..0000000000
--- a/.changeset/fix-selector-double-focus-ring.md
+++ /dev/null
@@ -1,10 +0,0 @@
----
-'@astryxdesign/core': patch
----
-
-[fix] Remove doubled focus ring on `Selector`. The inner combobox button drew
-its own `:focus-visible` outline on top of the wrapper's `:focus-within` ring,
-producing a stacked, rounded outline over the trigger after selecting an option
-or navigating with the keyboard. The button now defers to the wrapper's focus
-ring, matching `TextInput` and `NumberInput`.
-@cixzhang
diff --git a/.changeset/layout-children-as-content.md b/.changeset/layout-children-as-content.md
deleted file mode 100644
index ce52620aad..0000000000
--- a/.changeset/layout-children-as-content.md
+++ /dev/null
@@ -1,12 +0,0 @@
----
-'@astryxdesign/core': patch
----
-
-[fix] `<Layout>…</Layout>` no longer renders a blank page. `Layout` is
-slot-driven (`content`/`header`/`start`/`end`/`footer`), and the natural nested
-form `<Layout><LayoutContent /></Layout>` previously type-checked and built
-green while dropping its children at runtime — an empty shell. Children now
-render as a shorthand for the `content` slot (`<Layout>{main}</Layout>` is
-equivalent to `<Layout content={main} />`), matching how `Card` and `Section`
-accept content; an explicit `content` prop still wins when both are provided.
-@josephfarina
diff --git a/.changeset/shaggy-bears-migrate.md b/.changeset/shaggy-bears-migrate.md
deleted file mode 100644
index b54914da93..0000000000
--- a/.changeset/shaggy-bears-migrate.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-'@astryxdesign/cli': patch
----
-
-[fix] Add a v0.1.0 upgrade codemod that migrates legacy `@xds/*` module specifiers and config surfaces to the Astryx v0.1.0 names.
-@ejhammond
-
-[breaking] Remove legacy `astryx.versionFile` update-hint support from package.json.
-@ejhammond
diff --git a/.changeset/stone-neutral-dark-transparency.md b/.changeset/stone-neutral-dark-transparency.md
deleted file mode 100644
index ef1854d10e..0000000000
--- a/.changeset/stone-neutral-dark-transparency.md
+++ /dev/null
@@ -1,9 +0,0 @@
----
-'@astryxdesign/theme-stone': patch
----
-
-[fix] Stone theme: add ~10% transparency to dark-mode `--color-neutral`
-
-The dark-mode value was a fully opaque `#f3f3f5`, unlike every other theme which uses a semi-transparent (~10% alpha) neutral tint. Because `--color-neutral` fills the secondary `Button` variant, this rendered a solid near-white surface with near-white text in dark mode (unreadable). Changed dark value to `#f3f3f51a` to match the convention used across all other themes. Fixes #3119.
-
-@ernestt
diff --git a/.changeset/theme-doc-install-step.md b/.changeset/theme-doc-install-step.md
deleted file mode 100644
index 4085a99c6f..0000000000
--- a/.changeset/theme-doc-install-step.md
+++ /dev/null
@@ -1,8 +0,0 @@
----
-'@astryxdesign/cli': patch
----
-
-[docs] Add npm install step to the Theme System guide
-@nynexman4464
-
-The Quick Start section jumped straight to `import {neutralTheme} from '@astryxdesign/theme-neutral'`, which fails with `Cannot find module` for anyone who hasn't already installed the theme package. Prepend a one-line preamble + `npm install` code block, and add a short prose note above the Available Themes table pointing at the install command pattern. Reported in #3082.
diff --git a/.changeset/togglebutton-pressedchangeaction-transition.md b/.changeset/togglebutton-pressedchangeaction-transition.md
deleted file mode 100644
index f7d4ceddaf..0000000000
--- a/.changeset/togglebutton-pressedchangeaction-transition.md
+++ /dev/null
@@ -1,21 +0,0 @@
----
-'@astryxdesign/core': patch
----
-
-[fix] ToggleButton runs pressedChangeAction in an interruptible transition with optimistic state
-@cixzhang
-
-`pressedChangeAction` was fired as a non-awaited promise, so the documented
-loading spinner never appeared and the toggle ignored the action's lifecycle.
-It now runs inside a transition with an optimistic pressed state, matching
-`Switch`:
-
-- The optimistic pressed state flips immediately on click; the spinner is
- debounced so a fast action shows the new state without a spinner flash.
-- The action is interruptible — clicking again while it is pending starts a
- new transition with the next optimistic state (e.g. true -> false -> true),
- instead of being dropped or guarded out.
-- Synchronous handlers are supported too: a `pressedChangeAction` (or
- `onPressedChange`) that synchronously triggers a suspending update, such as
- a router navigation that suspends on data, also drives the pending state.
- `pressedChangeAction` now accepts `void | Promise<void>`.
diff --git a/packages/build/CHANGELOG.md b/packages/build/CHANGELOG.md
index d465078e1b..9a01707227 100644
--- a/packages/build/CHANGELOG.md
+++ b/packages/build/CHANGELOG.md
@@ -1,5 +1,29 @@
# @xds/build
+# 0.1.1
+
+#### Breaking Changes
+
+- Rename `@xds/build` exports off the xds name
+ The Vite integration's public exports are renamed: `xdsStylex` -> `astryxStylex`,
+ and the option types `XDSVitePluginOptions` / `XDSVitePluginLegacyOptions` ->
+ `AstryxVitePluginOptions` / `AstryxVitePluginLegacyOptions`. Update imports from
+ `@xds/build/vite` accordingly. Internal plugin names and the babel wrapper are
+ also rebranded. Part of removing `xds` naming from the public API.
+- Rename Next.js helper `withXDS` to `withAstryx`
+ The Next.js configuration wrapper is renamed `withXDS` -> `withAstryx`
+ (exported from `@astryxdesign/build/next`). Update your `next.config.mjs`:
+ `import {withAstryx} from '@astryxdesign/build/next'`. Part of removing xds
+ naming from the public API.
+
+#### Contributors
+
+Thanks to everyone who contributed to this release:
+
+- @ejhammond
+
+---
+
# 0.1.0
#### Breaking Changes
@@ -42,9 +66,11 @@
- import {neutralTheme} from '@astryxdesign/theme-neutral/built';
- <Theme theme={defaultTheme}>...</Theme>
- <Theme theme={neutralTheme}>...</Theme>
+
```
```
+
- Rename the npm package scope from `@xds/*` to `@astryxdesign/*`
All published packages move to the new `@astryxdesign` scope (e.g. `@xds/core` → `@astryxdesign/core`), along with the workspace lockfile, build/runtime scope-directory scans, and docsite slug derivation. Consumers must update their imports and dependency names. The internal ESLint plugin namespace (`@xds/*` rules) is intentionally untouched and tracked separately. Existing `@xds/*` codemods continue to target the old scope so projects still on `@xds/*` can migrate.
diff --git a/packages/build/package.json b/packages/build/package.json
index 0c1b3b4177..915323c23e 100644
--- a/packages/build/package.json
+++ b/packages/build/package.json
@@ -1,7 +1,7 @@
{
"name": "@astryxdesign/build",
- "version": "0.1.0",
- "description": "Build plugins for XDS source builds \u2014 babel, PostCSS, and Vite integrations",
+ "version": "0.1.1",
+ "description": "Build plugins for XDS source builds — babel, PostCSS, and Vite integrations",
"author": "Meta Open Source",
"license": "MIT",
"homepage": "https://github.com/facebook/astryx#readme",
diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.md
index 2c6d1fc0ef..4d00d27137 100644
--- a/packages/cli/CHANGELOG.md
+++ b/packages/cli/CHANGELOG.md
@@ -1,5 +1,71 @@
# @xds/cli
+# 0.1.1
+
+#### New Features
+
+- Add `astryx build` command for page composition, with natural-language search ranking.
+ `build "<idea>"` returns a composition kit — the closest page template, the
+ blocks that cover parts, and components to fill gaps, plus a Compose suggestion.
+ `build` with no args prints the how-to-build playbook. The shared search ranking
+ now handles oblique natural-language queries via tokenization + stopwords, a
+ synonym/intent map, light stemming, and page-template keyword enrichment.
+- Make generated agent docs build-first and restructure `init` output.
+ The generated `CLAUDE.md` now leads with the `build` workflow (search reframed as
+ a neutral universal find), and includes a required-CSS setup note
+ (`reset.css` + `astryx.css`) so components never render unstyled. `init` now
+ points agents at `astryx build`/`astryx search` instead of dumping page-template
+ names.
+- Improve `astryx build` output into a complete composition kit.
+ `build "<idea>"` now returns an agent-ready kit grouped by role: a START line
+ (scaffold vs compose), the closest PAGE template, an always-on FRAME (page
+ shell) and FOUNDATION (layout/typography/action primitives), idea-specific
+ BLOCKS and DOMAIN COMPONENTS (with a relevance floor to cut noise), and a SETUP
+ reminder. The always-on FRAME/FOUNDATION groups fix low recall of the
+ structural primitives every page needs but that never keyword-match an idea
+ (measured: component recall 15% to 71% on an agent-grounded eval).
+- Densify agent docs + tailor styling guidance to the project's configured system
+ Tightened the generated `CLAUDE.md`/`AGENTS.md` block from ~48 lines to ~26
+ (the per-topic `docs` dump collapsed to one line, `build`/`search`/`component`
+ no longer duplicated between workflow and reference, run-prefix stated once,
+ filler prose removed) — same information, far denser.
+
+#### Fixes
+
+- `npx astryx` now works when the CLI is installed as a real npm package.
+ The bin imported its `../src/*` modules relative to the invoked path, so running
+ through the `node_modules/.bin/astryx` symlink made them resolve outside the
+ package (`ERR_MODULE_NOT_FOUND: .../node_modules/src/...`) on Node versions that
+ don't realpath the bin entry. It now resolves siblings via the bin's real path
+ (realpath of `import.meta.url`), working whether invoked via symlink, copy, or
+ Windows shim. Also fixes the non-interactive `init`/`theme` error to say
+ `astryx <command>` instead of the stale `xds <command>`.
+- Add a v0.1.0 upgrade codemod that migrates legacy `@xds/*` module specifiers and config surfaces to the Astryx v0.1.0 names.
+ [breaking] Remove legacy `astryx.versionFile` update-hint support from package.json.
+
+#### Documentation
+
+- Add npm install step to the Theme System guide
+ The Quick Start section jumped straight to `import {neutralTheme} from '@astryxdesign/theme-neutral'`, which fails with `Cannot find module` for anyone who hasn't already installed the theme package. Prepend a one-line preamble + `npm install` code block, and add a short prose note above the Available Themes table pointing at the install command pattern. Reported in #3082.
+
+#### Other Changes
+
+- StyleX compiler wired → `xstyle` / StyleX token imports
+- Tailwind → utility classes backed by `@astryxdesign/core/tailwind-theme.css`
+- neither → `style`/`className` with `var(--token)` design tokens, plus an
+ explicit note NOT to use `xstyle`/utilities (they would not compile)
+
+#### Contributors
+
+Thanks to everyone who contributed to this release:
+
+- @ejhammond
+- @joeyfarina
+- @josephfarina
+- @nynexman4464
+
+---
+
# 0.1.0
#### Breaking Changes
@@ -71,9 +137,11 @@
- import {neutralTheme} from '@astryxdesign/theme-neutral/built';
- <Theme theme={defaultTheme}>...</Theme>
- <Theme theme={neutralTheme}>...</Theme>
+
```
```
+
- Remove the internal `drop-xds-meta-prefix` codemod from the OSS repo (#2970)
This codemod has been moved to its own package's tooling, where it belongs. It was registered as an optional, version-independent transform and is not part of any standard upgrade path, so removing it does not affect the public `0.0.13 → 0.0.15` migration.
- Rename the npm package scope from `@xds/*` to `@astryxdesign/*`
diff --git a/packages/cli/package.json b/packages/cli/package.json
index b7eb22d252..b4d69d82d1 100644
--- a/packages/cli/package.json
+++ b/packages/cli/package.json
@@ -1,6 +1,6 @@
{
"name": "@astryxdesign/cli",
- "version": "0.1.0",
+ "version": "0.1.1",
"displayName": "CLI",
"description": "Scaffold projects, browse templates, generate themes, and get agent-ready docs from the command line.",
"author": "Meta Open Source",
diff --git a/packages/core/CHANGELOG.md b/packages/core/CHANGELOG.md
index 350e8d59a6..37a7a918f0 100644
--- a/packages/core/CHANGELOG.md
+++ b/packages/core/CHANGELOG.md
@@ -1,5 +1,69 @@
# @xds/core
+# 0.1.1
+
+#### Breaking Changes
+
+- Rename `xdsTokenDefaults` export to `tokenDefaults`
+ The token-defaults constant is renamed from `xdsTokenDefaults` to
+ `tokenDefaults` (exported from `@astryxdesign/core/theme`). Update imports
+ accordingly. Part of removing xds naming from the public API.
+
+#### Fixes
+
+- Increase trailing padding on `ChatLayoutScrollButton` when a label is shown
+ With a label (e.g. "New messages"), the chevron icon sits on the leading edge
+ and the text on the trailing edge. The symmetric inline padding left the label
+ text cramped against the pill's rounded corner. The trailing inline padding is
+ now widened when a label is present, giving the text comfortable breathing room
+ from the rounded edge. The icon-only (collapsed) state is unchanged and stays
+ balanced.
+- Prevent `DateInput` from crashing the page while typing an incomplete
+ date. Typing a leading `0` or `1` (e.g. starting to enter `01` for January)
+ could coerce the in-progress value into an invalid date with a year of `0`,
+ which then threw a `RangeError` and crashed the surrounding page. Partial,
+ not-yet-complete input is now treated as incomplete instead of being parsed
+ into a date, so the field stays usable as you type.
+- Remove doubled focus ring on `Selector`. The inner combobox button drew
+ its own `:focus-visible` outline on top of the wrapper's `:focus-within` ring,
+ producing a stacked, rounded outline over the trigger after selecting an option
+ or navigating with the keyboard. The button now defers to the wrapper's focus
+ ring, matching `TextInput` and `NumberInput`.
+- `<Layout>…</Layout>` no longer renders a blank page. `Layout` is
+ slot-driven (`content`/`header`/`start`/`end`/`footer`), and the natural nested
+ form `<Layout><LayoutContent /></Layout>` previously type-checked and built
+ green while dropping its children at runtime — an empty shell. Children now
+ render as a shorthand for the `content` slot (`<Layout>{main}</Layout>` is
+ equivalent to `<Layout content={main} />`), matching how `Card` and `Section`
+ accept content; an explicit `content` prop still wins when both are provided.
+- ToggleButton runs pressedChangeAction in an interruptible transition with optimistic state
+ `pressedChangeAction` was fired as a non-awaited promise, so the documented
+ loading spinner never appeared and the toggle ignored the action's lifecycle.
+ It now runs inside a transition with an optimistic pressed state, matching
+ `Switch`:
+
+#### Other Changes
+
+- The optimistic pressed state flips immediately on click; the spinner is
+ debounced so a fast action shows the new state without a spinner flash.
+- The action is interruptible — clicking again while it is pending starts a
+ new transition with the next optimistic state (e.g. true -> false -> true),
+ instead of being dropped or guarded out.
+- Synchronous handlers are supported too: a `pressedChangeAction` (or
+ `onPressedChange`) that synchronously triggers a suspending update, such as
+ a router navigation that suspends on data, also drives the pending state.
+ `pressedChangeAction` now accepts `void | Promise<void>`.
+
+#### Contributors
+
+Thanks to everyone who contributed to this release:
+
+- @cixzhang
+- @ejhammond
+- @josephfarina
+
+---
+
# 0.1.0
#### Breaking Changes
@@ -52,9 +116,11 @@
- import {neutralTheme} from '@astryxdesign/theme-neutral/built';
- <Theme theme={defaultTheme}>...</Theme>
- <Theme theme={neutralTheme}>...</Theme>
+
```
```
+
- Rename the npm package scope from `@xds/*` to `@astryxdesign/*`
All published packages move to the new `@astryxdesign` scope (e.g. `@xds/core` → `@astryxdesign/core`), along with the workspace lockfile, build/runtime scope-directory scans, and docsite slug derivation. Consumers must update their imports and dependency names. The internal ESLint plugin namespace (`@xds/*` rules) is intentionally untouched and tracked separately. Existing `@xds/*` codemods continue to target the old scope so projects still on `@xds/*` can migrate.
diff --git a/packages/core/package.json b/packages/core/package.json
index 99aabc9316..b321f394f7 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
{
"name": "@astryxdesign/core",
- "version": "0.1.0",
+ "version": "0.1.1",
"displayName": "XDS Core",
"description": "The component library. Accessible, themeable React components with built-in spacing, dark mode, and StyleX styling.",
"author": "Meta Open Source",
diff --git a/packages/lab/CHANGELOG.md b/packages/lab/CHANGELOG.md
index e1abccb104..a7c3a9cc99 100644
--- a/packages/lab/CHANGELOG.md
+++ b/packages/lab/CHANGELOG.md
@@ -1,5 +1,9 @@
# @xds/lab
+# 0.1.1
+
+---
+
# 0.1.0
---
diff --git a/packages/lab/package.json b/packages/lab/package.json
index 387ac3e23d..da16f39bd4 100644
--- a/packages/lab/package.json
+++ b/packages/lab/package.json
@@ -1,8 +1,8 @@
{
"name": "@astryxdesign/lab",
- "version": "0.1.0",
+ "version": "0.1.1",
"private": true,
- "description": "Experimental XDS components \u2014 not published, available in storybook and sandbox for testing",
+ "description": "Experimental XDS components — not published, available in storybook and sandbox for testing",
"author": "Meta Open Source",
"license": "MIT",
"homepage": "https://github.com/facebook/astryx#readme",
@@ -25,7 +25,7 @@
"sideEffects": false,
"peerDependencies": {
"@stylexjs/stylex": ">=0.10.0",
- "@astryxdesign/core": "0.1.0",
+ "@astryxdesign/core": "0.1.1",
"react": ">=19.0.0",
"react-dom": ">=19.0.0"
},
diff --git a/packages/themes/butter/CHANGELOG.md b/packages/themes/butter/CHANGELOG.md
index 71d637dd88..2b7abfbf35 100644
--- a/packages/themes/butter/CHANGELOG.md
+++ b/packages/themes/butter/CHANGELOG.md
@@ -1,5 +1,9 @@
# @xds/theme-butter
+# 0.1.1
+
+---
+
# 0.1.0
---
diff --git a/packages/themes/butter/package.json b/packages/themes/butter/package.json
index b1f68a0a7f..2d25e1fef1 100644
--- a/packages/themes/butter/package.json
+++ b/packages/themes/butter/package.json
@@ -1,6 +1,6 @@
{
"name": "@astryxdesign/theme-butter",
- "version": "0.1.0",
+ "version": "0.1.1",
"displayName": "Butter Theme",
"private": false,
"description": "Warm, creamy yellows with a friendly blue accent. Playful enough for consumer surfaces, soft enough to stay readable.",
@@ -52,11 +52,11 @@
"lucide-react": "^1.18.0"
},
"peerDependencies": {
- "@astryxdesign/core": "0.1.0",
+ "@astryxdesign/core": "0.1.1",
"react": ">=19"
},
"devDependencies": {
- "@astryxdesign/cli": "0.1.0"
+ "@astryxdesign/cli": "0.1.1"
},
"module": "./dist/source.mjs"
}
diff --git a/packages/themes/chocolate/CHANGELOG.md b/packages/themes/chocolate/CHANGELOG.md
index b2357de428..8ee2d3331d 100644
--- a/packages/themes/chocolate/CHANGELOG.md
+++ b/packages/themes/chocolate/CHANGELOG.md
@@ -1,5 +1,9 @@
# @xds/theme-chocolate
+# 0.1.1
+
+---
+
# 0.1.0
---
diff --git a/packages/themes/chocolate/package.json b/packages/themes/chocolate/package.json
index 65a2800cef..59312367cb 100644
--- a/packages/themes/chocolate/package.json
+++ b/packages/themes/chocolate/package.json
@@ -1,9 +1,9 @@
{
"name": "@astryxdesign/theme-chocolate",
- "version": "0.1.0",
+ "version": "0.1.1",
"displayName": "Chocolate Theme",
"private": false,
- "description": "Warm chocolate theme for Astryx \u2014 rich brown palette with Fraunces headings, Albert Sans body, and Lucide icons",
+ "description": "Warm chocolate theme for Astryx — rich brown palette with Fraunces headings, Albert Sans body, and Lucide icons",
"author": "Meta Open Source",
"license": "MIT",
"homepage": "https://github.com/facebook/astryx#readme",
@@ -52,11 +52,11 @@
"lucide-react": "^1.18.0"
},
"peerDependencies": {
- "@astryxdesign/core": "0.1.0",
+ "@astryxdesign/core": "0.1.1",
"react": ">=19"
},
"devDependencies": {
- "@astryxdesign/cli": "0.1.0"
+ "@astryxdesign/cli": "0.1.1"
},
"module": "./dist/source.mjs"
}
diff --git a/packages/themes/gothic/CHANGELOG.md b/packages/themes/gothic/CHANGELOG.md
index 1bfea6afa9..baf26cb067 100644
--- a/packages/themes/gothic/CHANGELOG.md
+++ b/packages/themes/gothic/CHANGELOG.md
@@ -1,5 +1,9 @@
# @xds/theme-gothic
+# 0.1.1
+
+---
+
# 0.1.0
---
diff --git a/packages/themes/gothic/package.json b/packages/themes/gothic/package.json
index 0208041c81..3195298120 100644
--- a/packages/themes/gothic/package.json
+++ b/packages/themes/gothic/package.json
@@ -1,6 +1,6 @@
{
"name": "@astryxdesign/theme-gothic",
- "version": "0.1.0",
+ "version": "0.1.1",
"displayName": "Gothic Theme",
"private": false,
"description": "Deep blue-grays and a signature display serif. Dramatic and editorial, for surfaces that want to be remembered.",
@@ -52,11 +52,11 @@
"lucide-react": "^1.18.0"
},
"peerDependencies": {
- "@astryxdesign/core": "0.1.0",
+ "@astryxdesign/core": "0.1.1",
"react": ">=19"
},
"devDependencies": {
- "@astryxdesign/cli": "0.1.0"
+ "@astryxdesign/cli": "0.1.1"
},
"module": "./dist/source.mjs"
}
diff --git a/packages/themes/matcha/CHANGELOG.md b/packages/themes/matcha/CHANGELOG.md
index 86b0838f2b..c7b0a8a70c 100644
--- a/packages/themes/matcha/CHANGELOG.md
+++ b/packages/themes/matcha/CHANGELOG.md
@@ -1,5 +1,9 @@
# @xds/theme-matcha
+# 0.1.1
+
+---
+
# 0.1.0
---
diff --git a/packages/themes/matcha/package.json b/packages/themes/matcha/package.json
index b722fa43db..731b1126e0 100644
--- a/packages/themes/matcha/package.json
+++ b/packages/themes/matcha/package.json
@@ -1,6 +1,6 @@
{
"name": "@astryxdesign/theme-matcha",
- "version": "0.1.0",
+ "version": "0.1.1",
"private": false,
"description": "Earthy greens with a calm, organic feel. Naturalistic and grounded, great for wellness or content-first apps.",
"author": "Meta Open Source",
@@ -51,11 +51,11 @@
"lucide-react": "^1.18.0"
},
"peerDependencies": {
- "@astryxdesign/core": "0.1.0",
+ "@astryxdesign/core": "0.1.1",
"react": ">=19"
},
"devDependencies": {
- "@astryxdesign/cli": "0.1.0"
+ "@astryxdesign/cli": "0.1.1"
},
"module": "./dist/source.mjs"
}
diff --git a/packages/themes/neutral/CHANGELOG.md b/packages/themes/neutral/CHANGELOG.md
index 622352d912..df82663703 100644
--- a/packages/themes/neutral/CHANGELOG.md
+++ b/packages/themes/neutral/CHANGELOG.md
@@ -1,5 +1,9 @@
# @xds/theme-neutral
+# 0.1.1
+
+---
+
# 0.1.0
---
diff --git a/packages/themes/neutral/package.json b/packages/themes/neutral/package.json
index 4d7c11f9ef..71edd84283 100644
--- a/packages/themes/neutral/package.json
+++ b/packages/themes/neutral/package.json
@@ -1,6 +1,6 @@
{
"name": "@astryxdesign/theme-neutral",
- "version": "0.1.0",
+ "version": "0.1.1",
"displayName": "Neutral Theme",
"private": false,
"description": "Restrained warm grays. Minimal and quiet, so the content stays the focus.",
@@ -52,11 +52,11 @@
"lucide-react": "^1.18.0"
},
"peerDependencies": {
- "@astryxdesign/core": "0.1.0",
+ "@astryxdesign/core": "0.1.1",
"react": ">=19"
},
"devDependencies": {
- "@astryxdesign/cli": "0.1.0"
+ "@astryxdesign/cli": "0.1.1"
},
"module": "./dist/source.mjs"
}
diff --git a/packages/themes/stone/CHANGELOG.md b/packages/themes/stone/CHANGELOG.md
index 85e9d83559..06547c0454 100644
--- a/packages/themes/stone/CHANGELOG.md
+++ b/packages/themes/stone/CHANGELOG.md
@@ -1,5 +1,20 @@
# @xds/theme-stone
+# 0.1.1
+
+#### Fixes
+
+- Stone theme: add ~10% transparency to dark-mode `--color-neutral`
+ The dark-mode value was a fully opaque `#f3f3f5`, unlike every other theme which uses a semi-transparent (~10% alpha) neutral tint. Because `--color-neutral` fills the secondary `Button` variant, this rendered a solid near-white surface with near-white text in dark mode (unreadable). Changed dark value to `#f3f3f51a` to match the convention used across all other themes. Fixes #3119.
+
+#### Contributors
+
+Thanks to everyone who contributed to this release:
+
+- @ernestt
+
+---
+
# 0.1.0
---
diff --git a/packages/themes/stone/package.json b/packages/themes/stone/package.json
index 3c4c1ad8d7..2a39491336 100644
--- a/packages/themes/stone/package.json
+++ b/packages/themes/stone/package.json
@@ -1,6 +1,6 @@
{
"name": "@astryxdesign/theme-stone",
- "version": "0.1.0",
+ "version": "0.1.1",
"displayName": "Stone Theme",
"private": false,
"description": "Warm stone and slate, earthy and understated, with just enough character to feel handcrafted.",
@@ -52,11 +52,11 @@
"lucide-react": "^1.18.0"
},
"peerDependencies": {
- "@astryxdesign/core": "0.1.0",
+ "@astryxdesign/core": "0.1.1",
"react": ">=19"
},
"devDependencies": {
- "@astryxdesign/cli": "0.1.0"
+ "@astryxdesign/cli": "0.1.1"
},
"module": "./dist/source.mjs"
}
diff --git a/packages/themes/y2k/CHANGELOG.md b/packages/themes/y2k/CHANGELOG.md
index 94b7e563c1..4679d2662e 100644
--- a/packages/themes/y2k/CHANGELOG.md
+++ b/packages/themes/y2k/CHANGELOG.md
@@ -1,5 +1,9 @@
# @xds/theme-y2k
+# 0.1.1
+
+---
+
# 0.1.0
#### New Features
diff --git a/packages/themes/y2k/package.json b/packages/themes/y2k/package.json
index 0ac4aec73a..d9aef1fc1e 100644
--- a/packages/themes/y2k/package.json
+++ b/packages/themes/y2k/package.json
@@ -1,6 +1,6 @@
{
"name": "@astryxdesign/theme-y2k",
- "version": "0.1.0",
+ "version": "0.1.1",
"displayName": "Y2K Theme",
"private": false,
"description": "Hot pinks, lime greens, and Poppins. Bubbly, playful, and unmistakably retro.",
@@ -52,11 +52,11 @@
"lucide-react": "^1.18.0"
},
"peerDependencies": {
- "@astryxdesign/core": "0.1.0",
+ "@astryxdesign/core": "0.1.1",
"react": ">=19"
},
"devDependencies": {
- "@astryxdesign/cli": "0.1.0"
+ "@astryxdesign/cli": "0.1.1"
},
"module": "./dist/source.mjs"
}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index a88662c381..fb426cdae1 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -766,7 +766,7 @@ importers:
packages/lab:
dependencies:
'@astryxdesign/core':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../core
'@stylexjs/stylex':
specifier: '>=0.10.0'
@@ -800,7 +800,7 @@ importers:
packages/themes/butter:
dependencies:
'@astryxdesign/core':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../core
lucide-react:
specifier: ^1.18.0
@@ -810,13 +810,13 @@ importers:
version: 19.2.7
devDependencies:
'@astryxdesign/cli':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../cli
packages/themes/chocolate:
dependencies:
'@astryxdesign/core':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../core
lucide-react:
specifier: ^1.18.0
@@ -826,13 +826,13 @@ importers:
version: 19.2.7
devDependencies:
'@astryxdesign/cli':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../cli
packages/themes/gothic:
dependencies:
'@astryxdesign/core':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../core
lucide-react:
specifier: ^1.18.0
@@ -842,13 +842,13 @@ importers:
version: 19.2.7
devDependencies:
'@astryxdesign/cli':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../cli
packages/themes/matcha:
dependencies:
'@astryxdesign/core':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../core
lucide-react:
specifier: ^1.18.0
@@ -858,13 +858,13 @@ importers:
version: 19.2.7
devDependencies:
'@astryxdesign/cli':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../cli
packages/themes/neutral:
dependencies:
'@astryxdesign/core':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../core
lucide-react:
specifier: ^1.18.0
@@ -874,13 +874,13 @@ importers:
version: 19.2.7
devDependencies:
'@astryxdesign/cli':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../cli
packages/themes/stone:
dependencies:
'@astryxdesign/core':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../core
lucide-react:
specifier: ^1.18.0
@@ -890,13 +890,13 @@ importers:
version: 19.2.7
devDependencies:
'@astryxdesign/cli':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../cli
packages/themes/y2k:
dependencies:
'@astryxdesign/core':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../core
lucide-react:
specifier: ^1.18.0
@@ -906,7 +906,7 @@ importers:
version: 19.2.7
devDependencies:
'@astryxdesign/cli':
- specifier: 0.1.0
+ specifier: 0.1.1
version: link:../../cli
packages/vega: