An open source design system that's fully customizable and agent ready
TypeScript
chore: version packages for v0.1.8 (#4223)
Cindy Zhangc5fa19bdaa10
diff --git a/.changeset/agent-docs-default-agents-md.md b/.changeset/agent-docs-default-agents-md.mddeleted file mode 100644index 82af67211b..0000000000--- a/.changeset/agent-docs-default-agents-md.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/cli': patch------[feat] `astryx init --features agents` now defaults to creating root `AGENTS.md` — the tool-agnostic standard that Codex/Copilot, Cursor, and most agents read — instead of the Claude-specific `.claude/CLAUDE.md`. Claude output is now opt-in via `--agent claude` (→ `.claude/CLAUDE.md`), and `--agent all` still writes both. Projects with existing agent-doc files are unaffected: init still discovers and updates every file already present, so this only changes the from-scratch default. (#4216)--@josephfarinadiff --git a/.changeset/avatar-group-overflow-pill.md b/.changeset/avatar-group-overflow-pill.mddeleted file mode 100644index 0c69bee43d..0000000000--- a/.changeset/avatar-group-overflow-pill.md+++ /dev/null@@ -1,9 +0,0 @@-----'@astryxdesign/core': patch------[fix] `AvatarGroupOverflow` now grows into a pill for long `+N` counts so the number never clips.--The indicator was a fixed-size circle, so wide counts (e.g. `+4912`) overflowed and crowded the edges. It now uses a minimum width equal to the avatar size plus horizontal padding: short counts (`+5`) stay a perfect circle, while longer counts grow horizontally into a stadium/pill and remain legible. No new public props.--@cixzhangdiff --git a/.changeset/avatar-size-scale.md b/.changeset/avatar-size-scale.mddeleted file mode 100644index 86c15953da..0000000000--- a/.changeset/avatar-size-scale.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch-'@astryxdesign/cli': patch------[breaking] Avatar and AvatarGroup adopt Icon's abbreviated size scale — `size` now takes `xsm`/`sm`/`md`/`lg`/`xl` instead of `tiny`/`xsmall`/`small`/`medium`/`large`. Pixel values are unchanged (20/24/36/48/128px) and the default is now `md` (still 36px, formerly `small`). Avatar's tiers stay larger than Icon's because avatars align with media rather than glyphs. Run `astryx upgrade` to migrate call sites. (#2672)-@cixzhangdiff --git a/.changeset/carousel-shift-wheel-horizontal.md b/.changeset/carousel-shift-wheel-horizontal.mddeleted file mode 100644index 988566e8e3..0000000000--- a/.changeset/carousel-shift-wheel-horizontal.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] Carousel now scrolls horizontally when you hold Shift and scroll the mouse wheel. Trackpad users already got horizontal scroll for free; this brings standard mouse (vertical-only wheel) users to parity using the established Shift + wheel convention. Native trackpad horizontal scrolling and the prev/next buttons are unchanged.--@cixzhangdiff --git a/.changeset/citation-cursor-non-interactive.md b/.changeset/citation-cursor-non-interactive.mddeleted file mode 100644index 8810ebf62b..0000000000--- a/.changeset/citation-cursor-non-interactive.md+++ /dev/null@@ -1,6 +0,0 @@-----'@astryxdesign/core': patch------[fix] Citation: a non-interactive citation (no `source.url`) now keeps the default cursor instead of showing a pointer, so only linked citations look clickable. The pointer cursor is applied alongside the existing hover treatment for both the `label` and `number` variants (#4134).-@MeGaurav4diff --git a/.changeset/cli-scoped-invocation-footgun.md b/.changeset/cli-scoped-invocation-footgun.mddeleted file mode 100644index a820eb6436..0000000000--- a/.changeset/cli-scoped-invocation-footgun.md+++ /dev/null@@ -1,17 +0,0 @@-----'@astryxdesign/cli': patch-'@astryxdesign/core': patch------[fix] Stop suggesting bare `npx astryx` before the CLI is installed — it resolves to an unrelated package on the npm registry.--The CLI now emits an install-aware invocation everywhere it prints a command:--- Installed / global / dev runs suggest `<pm> astryx <cmd>` (e.g. `pnpm exec astryx …`), unchanged.-- One-off runs (launched via `npx`/`pnpm dlx`/`yarn dlx`/`bunx`) suggest the scoped package `<dlx> @astryxdesign/cli <cmd>`, which always resolves to us.--This is driven by a single source of truth in `package-manager.mjs` (`getCliInvocation`, `formatCliCommand`, `getDlxPrefix`, `isCliOneOff`) and applied to every runtime hint the CLI prints — `search`, `component`, `hook`, `docs`, `build`, `template`, `swizzle`, `discover`, `theme`, `init`, `upgrade`, `doctor`, the update-check notice, the manifest pointer, and the postinstall banner — plus the injected `AGENTS.md`/`CLAUDE.md` index. The postinstall banner also no longer prints a stale `npx xds init`. Structured `--json` fields (e.g. search `command`, upgrade `suggestedCommand`) keep the canonical bare `astryx <cmd>` form; only the human-facing print is rewritten.--Docs are aligned too: bootstrap commands use the scoped package or an explicit install-then-run flow, and reference commands use the bare `astryx <cmd>` form (which fails cleanly if the CLI isn't installed, rather than fetching a look-alike package). The core `<Theme>` runtime warning and the docsite copy-commands now use `npx @astryxdesign/cli …`.--@joeyfarinadiff --git a/.changeset/codemod-mock-call-specifiers.md b/.changeset/codemod-mock-call-specifiers.mddeleted file mode 100644index 12f77316fb..0000000000--- a/.changeset/codemod-mock-call-specifiers.md+++ /dev/null@@ -1,10 +0,0 @@-----'@astryxdesign/cli': patch------[fix] Extend the v0.1.0 upgrade codemods to cover test files that mock `@xds/core` modules, which were previously left half-migrated and broke after upgrade:--- **migrate-xds-module-specifiers**: rewrite the mocked-module path in `vi.mock`/`vi.doMock`/`jest.mock`/`jest.doMock` (and bare `mock`) calls, plus `import(...)` specifiers used in TS type positions (`typeof import('@xds/core/Text')`), so the mock still intercepts the renamed `@astryxdesign/*` import.-- **drop-xds-prefix-imports**: un-prefix partial-mock override keys inside an `@xds/core` mock factory (e.g. `useXDSTruncation` → `useTruncation`) so the override matches the renamed export instead of silently overriding nothing. Scoped to recognized `@xds/core` mock factories only; unrelated object keys are untouched.--@ejhammonddiff --git a/.changeset/collapsible-content-typography.md b/.changeset/collapsible-content-typography.mddeleted file mode 100644index 832313c9df..0000000000--- a/.changeset/collapsible-content-typography.md+++ /dev/null@@ -1,6 +0,0 @@-----'@astryxdesign/core': patch------[feat] Collapsible: the content area now anchors body typography (font family, size, weight, line-height) instead of inheriting from its surroundings, and exposes a stable `astryx-collapsible-content` theme target so revealed text can be themed externally.-@cixzhangdiff --git a/.changeset/collapsible-disabled.md b/.changeset/collapsible-disabled.mddeleted file mode 100644index d10e00dd81..0000000000--- a/.changeset/collapsible-disabled.md+++ /dev/null@@ -1,6 +0,0 @@-----'@astryxdesign/core': patch------[feat] Collapsible: add an `isDisabled` prop to disable a single item. A disabled item's trigger can't be toggled and is dimmed; following the system-wide disabled convention it uses `aria-disabled` (not the native `disabled` attribute) and drops out of the tab order, staying perceivable to assistive tech. Disabling doesn't collapse an already-open item. Works standalone and inside CollapsibleGroup.-@cixzhangdiff --git a/.changeset/core-docs-mjs-redirect.md b/.changeset/core-docs-mjs-redirect.mddeleted file mode 100644index 62085d7f49..0000000000--- a/.changeset/core-docs-mjs-redirect.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[feat] `@astryxdesign/core`'s `docs.mjs` now redirects to the CLI so agents converge on a single documentation entry point (`astryx docs` / `astryx init`) instead of a large standalone script. (#4207)--@josephfarinadiff --git a/.changeset/dropdown-menu-properties-preview.md b/.changeset/dropdown-menu-properties-preview.mddeleted file mode 100644index 27921ab735..0000000000--- a/.changeset/dropdown-menu-properties-preview.md+++ /dev/null@@ -1,6 +0,0 @@-----'@astryxdesign/core': patch------[docs] DropdownMenu and DropdownMenuItem: seed playground defaults so the docsite properties-tab preview renders real content instead of an empty trigger.-@cixzhangdiff --git a/.changeset/dropdown-menu-selectable-items.md b/.changeset/dropdown-menu-selectable-items.mddeleted file mode 100644index ec135237f0..0000000000--- a/.changeset/dropdown-menu-selectable-items.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[feat] DropdownMenu selectable items: add `DropdownMenuCheckboxItem` (independent toggle, `role="menuitemcheckbox"`) and `DropdownMenuRadioGroup` + `DropdownMenuRadioItem` (single-select, `role="menuitemradio"`). The control size derives from the menu's item size and swaps to the row's inline-end on touch. They also work inside `ContextMenu` (re-exported as `ContextMenuCheckboxItem` / `ContextMenuRadioGroup` / `ContextMenuRadioItem`). Both menus' keyboard/typeahead/activation now recognize the selectable roles, and the menu context (`DropdownMenuContext`, `useDropdownMenuContext`, `DropdownMenuSize`) is exported for building custom menu items. See #3829.--@cixzhangdiff --git a/.changeset/i18n-description-improvements.md b/.changeset/i18n-description-improvements.mddeleted file mode 100644index 31fdff1f5c..0000000000--- a/.changeset/i18n-description-improvements.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[chore] Improved translator context in the shipped English catalog (`packages/core/locales/en.json`) descriptions. Sharpened ~172 entries — added screen-reader-only clarifications, ICU-composition examples, polysemy warnings, and set-pairing notes — so translators working in Crowdin get better context. No changes to `defaultMessage` values, keys, or runtime API.--@nynexman4464diff --git a/.changeset/icon-label-accessible-name.md b/.changeset/icon-label-accessible-name.mddeleted file mode 100644index 748078b123..0000000000--- a/.changeset/icon-label-accessible-name.md+++ /dev/null@@ -1,6 +0,0 @@-----'@astryxdesign/core': patch------[feat] Icon: add an optional `label` prop for the accessible name. Setting it makes a standalone icon meaningful (`role="img"` + `aria-label`, no `aria-hidden`), collapsing the old three-attribute dance into one prop; omitting it (or passing `''`) keeps the decorative default (`aria-hidden`).-@cixzhangdiff --git a/.changeset/icon-size-rem.md b/.changeset/icon-size-rem.mddeleted file mode 100644index debfc15d6b..0000000000--- a/.changeset/icon-size-rem.md+++ /dev/null@@ -1,6 +0,0 @@-----'@astryxdesign/core': patch------[fix] Icon: size variants (`xsm`/`sm`/`md`/`lg`) now use `rem` instead of hardcoded `px`, so icons scale in step with text when the document/root `font-size` changes — matching the rest of the design system's rem-based type scale. Fixes #4092.-@cixzhangdiff --git a/.changeset/init-foolproof-postinstall-nudge.md b/.changeset/init-foolproof-postinstall-nudge.mddeleted file mode 100644index 816f3ce944..0000000000--- a/.changeset/init-foolproof-postinstall-nudge.md+++ /dev/null@@ -1,8 +0,0 @@-----'@astryxdesign/cli': patch-'@astryxdesign/core': patch------[feat] "Foolproof init": both `@astryxdesign/core` and `@astryxdesign/cli` now print a postinstall nudge pointing you to `npx @astryxdesign/cli init`, `astryx` commands nudge you to finish setup until init has run, and `astryx init` runs non-interactively (no TTY required) so it works in CI and agent environments. (#4147, #4153, #4154, #4155)--@josephfarinadiff --git a/.changeset/integrations-cli-docs-topic.md b/.changeset/integrations-cli-docs-topic.mddeleted file mode 100644index 929015b42b..0000000000--- a/.changeset/integrations-cli-docs-topic.md+++ /dev/null@@ -1,8 +0,0 @@-----'@astryxdesign/cli': patch------[docs] Add a `cli-integrations` CLI docs topic (`astryx docs cli-integrations`) so the integration-authoring guide (originally written by @ejhammond) is discoverable through the CLI and docsite instead of an unreferenced markdown file. Rewrite the CLI README's Configuration section to match the current strict config schema (`integrations`, `issuesUrl`, `hooks.postCodemod`, `experimental.xle`) and reframe the Integrations section around the two-file API.--@ejhammond-@josephfarinadiff --git a/.changeset/outline-keyboard-navigate-scoping.md b/.changeset/outline-keyboard-navigate-scoping.mddeleted file mode 100644index 68d406e784..0000000000--- a/.changeset/outline-keyboard-navigate-scoping.md+++ /dev/null@@ -1,18 +0,0 @@-----'@astryxdesign/core': patch------[feat] Outline: keyboard navigation, navigate callbacks, and scroll-scoping props (#2527)--Layers the public API deferred out of #2746 onto the scroll-spy engine and click-lock that already shipped. No visual change.--- **Keyboard navigation** — the outline is now a single tab stop (roving tabindex via `useListFocus`), seated on the _active_ heading per WAI-ARIA, so tabbing into a table of contents while reading section 7 lands on section 7 rather than sending the reader back to section 1. Arrow keys move between headings, Home/End jump to the ends, and Enter/Space activate. A 40-heading table of contents costs one Tab press instead of 40, and Tab still leaves the outline in one press.-- **`onNavigateStart(id)` / `onNavigateEnd(id)`** — fire around the smooth scroll started by a click or keyboard activation, so an app can drive an arrival effect. `onNavigateEnd` resolves on `scrollend` where supported and on a settle timeout where it is not (Safari), so it also fires correctly when reduced motion collapses the scroll into an instant jump. It fires exactly once for every `onNavigateStart` — including when the user interrupts the scroll — so a "navigating" state can never leak.-- **`offset`** — the height of a fixed header overlaying the top of the scroll root. It shifts both the activation line **and** the scroll landing by the same amount, so a heading activates exactly where navigating to it puts it: below the header, not hidden underneath it. It composes with each heading's own `scroll-margin-top` (the header, then the breathing room below it) rather than replacing it — leave `offset` at 0 when nothing overlays the content and let `scroll-margin-top` do the work, since the browser already honors it.-- **`scrollContainerRef`** — scope scroll tracking to a specific container instead of auto-detecting the nearest scrollable ancestor. Fixes the table of contents whose highlight never moves inside a split pane, modal, or dashboard panel. The default (viewport) path is unchanged.-- **`hasScrollOnClick`** (default `true`) — set to `false` to own the scrolling yourself; the outline still updates the active item, the hash, and the navigate callbacks.--Clicking an outline item whose heading is not in the DOM (lazily-rendered or virtualized content) still falls through to the browser's native fragment navigation, as before — the link is never swallowed into a no-op.--Existing props (`items`, `activeId`, `onActiveIdChange`, `label`, `density`) and the `parseOutlineFromMarkdown` / `useOutlineFromMarkdown` / `useOutlineFromDOM` helpers are unchanged.-@AKnassadiff --git a/.changeset/row-expansion-cycle-guard.md b/.changeset/row-expansion-cycle-guard.mddeleted file mode 100644index 156caad88b..0000000000--- a/.changeset/row-expansion-cycle-guard.md+++ /dev/null@@ -1,9 +0,0 @@-----'@astryxdesign/core': patch------[fix] Guard useTableRowExpansionState tree walks against cyclic data (#3971)--The `depthMap`, flattened `data`, and `allExpandableKeys` walks now track the ancestor keys on the current path and skip edges that point back at an ancestor, so self-referential or cyclic row data terminates instead of overflowing the stack.--@AKnassadiff --git a/.changeset/table-sort-aria-i18n.md b/.changeset/table-sort-aria-i18n.mddeleted file mode 100644index 6a7b036d57..0000000000--- a/.changeset/table-sort-aria-i18n.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] Route the Table sortable plugin's header-button aria-labels ("Sort by …", "… sorted …", "… priority … of …") through `useTranslator()` with new `@astryx.table.sort.sortBy` / `sortedBy` / `sortedByWithPriority` / `direction.*` catalog keys, so they localize like the sort menu labels already do (#3618, tracker #3636). The direction word resolves through its own key rather than interpolating the raw enum value. English output is unchanged.--@AKnassadiff --git a/.changeset/table-tree-data-plugin.md b/.changeset/table-tree-data-plugin.mddeleted file mode 100644index dac04f7ce8..0000000000--- a/.changeset/table-tree-data-plugin.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[feat] Table: add a tree-data plugin — `useTableTreeState` and `useTableTreeData` — for rendering and managing hierarchical (parent/child) rows, expansion state, and flattening. Exported from `@astryxdesign/core/Table`. (#3789)--@AKnassadiff --git a/.changeset/table-tree-expander-i18n.md b/.changeset/table-tree-expander-i18n.mddeleted file mode 100644index 15b4f1f130..0000000000--- a/.changeset/table-tree-expander-i18n.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/core': patch------[fix] Table: the tree row expander's `aria-label` is now localized through `useTranslator()` instead of a hardcoded English string, so expand/collapse controls announce in the app's language. (#4149)--@nynexman4464diff --git a/.changeset/tablist-divider-indicator-gap.md b/.changeset/tablist-divider-indicator-gap.mddeleted file mode 100644index 24947db546..0000000000--- a/.changeset/tablist-divider-indicator-gap.md+++ /dev/null@@ -1,9 +0,0 @@-----'@astryxdesign/core': patch------[fix] TabList `hasDivider` reserves a gap so the hover pill and adjacent buttons no longer touch the underline--A divided TabList now reserves 4px between the tabs and the divider rail. The hover highlight sits clear of the underline, and a same-size Button placed alongside the tabs aligns to the tab baseline instead of butting the rail — so a `md` tab strip pairs with a `md` button. The selected indicator still rests on the rail. Non-divided tab lists are unchanged. TabList inside a `Toolbar` with `dividers={['bottom']}` gets the same alignment via the toolbar's own spacing.--@ernesttdiff --git a/.changeset/treelist-focus-ring-leak.md b/.changeset/treelist-focus-ring-leak.mddeleted file mode 100644index 1b1f1bdb8f..0000000000--- a/.changeset/treelist-focus-ring-leak.md+++ /dev/null@@ -1,6 +0,0 @@-----'@astryxdesign/core': patch------[fix] TreeList: focusing a parent row no longer leaks the focus-visible outline onto its descendant rows — each row's ring now resolves from its own nearest treeitem instead of matching any focused ancestor (#4130)-@is-jaindiff --git a/.changeset/upgrade-refresh-agent-docs.md b/.changeset/upgrade-refresh-agent-docs.mddeleted file mode 100644index 208db85726..0000000000--- a/.changeset/upgrade-refresh-agent-docs.md+++ /dev/null@@ -1,7 +0,0 @@-----'@astryxdesign/cli': patch------[fix] `astryx upgrade` now keeps the managed agent-docs block (`<!-- ASTRYX:START --> … <!-- ASTRYX:END -->`) in sync with the installed version on **every** path — including the up-to-date and no-codemods short-circuits that previously returned before any refresh, leaving AI agents reading a stale component index and superseded rules. The block documents the installed library, so it's now refreshed up front (independent of codemods) and reported in the `--json` receipt as `agentDocs`. One detection pass covers three cases: a stale block is rewritten (`--apply`) or reported as a pending change (dry-run, which no longer writes); a project with core installed but no managed block is nudged to run `astryx init --features agents`; an already-current block stays silent. (#4168, #4169)--@josephfarinadiff --git a/packages/build/CHANGELOG.md b/packages/build/CHANGELOG.mdindex f5a89e18a6..52c455dfba 100644--- a/packages/build/CHANGELOG.md+++ b/packages/build/CHANGELOG.md@@ -1,5 +1,9 @@# @xds/build+# 0.1.8++---+# 0.1.7---diff --git a/packages/build/package.json b/packages/build/package.jsonindex 93a7db4f0c..144b39457e 100644--- a/packages/build/package.json+++ b/packages/build/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/build",- "version": "0.1.7",+ "version": "0.1.8","description": "Build plugins for XDS source builds — babel, PostCSS, and Vite integrations","author": "Meta Open Source","license": "MIT",diff --git a/packages/charts/CHANGELOG.md b/packages/charts/CHANGELOG.mdindex 1a9abb4ca3..248bbf8bcd 100644--- a/packages/charts/CHANGELOG.md+++ b/packages/charts/CHANGELOG.md@@ -1,5 +1,9 @@# @astryxdesign/charts+# 0.1.8++---+# 0.1.7---diff --git a/packages/charts/package.json b/packages/charts/package.jsonindex 839205de3e..888c59032d 100644--- a/packages/charts/package.json+++ b/packages/charts/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/charts",- "version": "0.1.7",+ "version": "0.1.8","private": true,"description": "Astryx charts — a config-model data visualization library (d3-based). Published to npm only under the @canary dist-tag for early testing; never released as a stable (latest) version.","author": "Meta Open Source",@@ -57,7 +57,7 @@},"peerDependencies": {"@stylexjs/stylex": ">=0.10.0",- "@astryxdesign/core": "0.1.7",+ "@astryxdesign/core": "0.1.8","react": ">=19.0.0","react-dom": ">=19.0.0"},diff --git a/packages/cli/CHANGELOG.md b/packages/cli/CHANGELOG.mdindex 4051c83ef1..270367c608 100644--- a/packages/cli/CHANGELOG.md+++ b/packages/cli/CHANGELOG.md@@ -1,5 +1,45 @@# @xds/cli+# 0.1.8++#### Breaking Changes++- Avatar and AvatarGroup adopt Icon's abbreviated size scale — `size` now takes `xsm`/`sm`/`md`/`lg`/`xl` instead of `tiny`/`xsmall`/`small`/`medium`/`large`. Pixel values are unchanged (20/24/36/48/128px) and the default is now `md` (still 36px, formerly `small`). Avatar's tiers stay larger than Icon's because avatars align with media rather than glyphs. Run `astryx upgrade` to migrate call sites. (#2672)++#### New Features++- `astryx init --features agents` now defaults to creating root `AGENTS.md` — the tool-agnostic standard that Codex/Copilot, Cursor, and most agents read — instead of the Claude-specific `.claude/CLAUDE.md`. Claude output is now opt-in via `--agent claude` (→ `.claude/CLAUDE.md`), and `--agent all` still writes both. Projects with existing agent-doc files are unaffected: init still discovers and updates every file already present, so this only changes the from-scratch default. (#4216)+- "Foolproof init": both `@astryxdesign/core` and `@astryxdesign/cli` now print a postinstall nudge pointing you to `npx @astryxdesign/cli init`, `astryx` commands nudge you to finish setup until init has run, and `astryx init` runs non-interactively (no TTY required) so it works in CI and agent environments. (#4147, #4153, #4154, #4155)++#### Fixes++- Stop suggesting bare `npx astryx` before the CLI is installed — it resolves to an unrelated package on the npm registry.+ The CLI now emits an install-aware invocation everywhere it prints a command:+- Extend the v0.1.0 upgrade codemods to cover test files that mock `@xds/core` modules, which were previously left half-migrated and broke after upgrade:+- `astryx upgrade` now keeps the managed agent-docs block (`<!-- ASTRYX:START --> … <!-- ASTRYX:END -->`) in sync with the installed version on **every** path — including the up-to-date and no-codemods short-circuits that previously returned before any refresh, leaving AI agents reading a stale component index and superseded rules. The block documents the installed library, so it's now refreshed up front (independent of codemods) and reported in the `--json` receipt as `agentDocs`. One detection pass covers three cases: a stale block is rewritten (`--apply`) or reported as a pending change (dry-run, which no longer writes); a project with core installed but no managed block is nudged to run `astryx init --features agents`; an already-current block stays silent. (#4168, #4169)++#### Documentation++- Add a `cli-integrations` CLI docs topic (`astryx docs cli-integrations`) so the integration-authoring guide (originally written by @ejhammond) is discoverable through the CLI and docsite instead of an unreferenced markdown file. Rewrite the CLI README's Configuration section to match the current strict config schema (`integrations`, `issuesUrl`, `hooks.postCodemod`, `experimental.xle`) and reframe the Integrations section around the two-file API.++#### Other Changes++- Installed / global / dev runs suggest `<pm> astryx <cmd>` (e.g. `pnpm exec astryx …`), unchanged.+- One-off runs (launched via `npx`/`pnpm dlx`/`yarn dlx`/`bunx`) suggest the scoped package `<dlx> @astryxdesign/cli <cmd>`, which always resolves to us.+- **migrate-xds-module-specifiers**: rewrite the mocked-module path in `vi.mock`/`vi.doMock`/`jest.mock`/`jest.doMock` (and bare `mock`) calls, plus `import(...)` specifiers used in TS type positions (`typeof import('@xds/core/Text')`), so the mock still intercepts the renamed `@astryxdesign/*` import.+- **drop-xds-prefix-imports**: un-prefix partial-mock override keys inside an `@xds/core` mock factory (e.g. `useXDSTruncation` → `useTruncation`) so the override matches the renamed export instead of silently overriding nothing. Scoped to recognized `@xds/core` mock factories only; unrelated object keys are untouched.++#### Contributors++Thanks to everyone who contributed to this release:++- @cixzhang+- @ejhammond+- @joeyfarina+- @josephfarina++---+# 0.1.7#### New Featuresdiff --git a/packages/cli/package.json b/packages/cli/package.jsonindex b9e3630d30..644a9ae660 100644--- a/packages/cli/package.json+++ b/packages/cli/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/cli",- "version": "0.1.7",+ "version": "0.1.8","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.mdindex ad5dd19dea..5318a2d3a5 100644--- a/packages/core/CHANGELOG.md+++ b/packages/core/CHANGELOG.md@@ -1,5 +1,70 @@# @xds/core+# 0.1.8++#### Breaking Changes++- Avatar and AvatarGroup adopt Icon's abbreviated size scale — `size` now takes `xsm`/`sm`/`md`/`lg`/`xl` instead of `tiny`/`xsmall`/`small`/`medium`/`large`. Pixel values are unchanged (20/24/36/48/128px) and the default is now `md` (still 36px, formerly `small`). Avatar's tiers stay larger than Icon's because avatars align with media rather than glyphs. Run `astryx upgrade` to migrate call sites. (#2672)++#### New Features++- Collapsible: the content area now anchors body typography (font family, size, weight, line-height) instead of inheriting from its surroundings, and exposes a stable `astryx-collapsible-content` theme target so revealed text can be themed externally.+- Collapsible: add an `isDisabled` prop to disable a single item. A disabled item's trigger can't be toggled and is dimmed; following the system-wide disabled convention it uses `aria-disabled` (not the native `disabled` attribute) and drops out of the tab order, staying perceivable to assistive tech. Disabling doesn't collapse an already-open item. Works standalone and inside CollapsibleGroup.+- `@astryxdesign/core`'s `docs.mjs` now redirects to the CLI so agents converge on a single documentation entry point (`astryx docs` / `astryx init`) instead of a large standalone script. (#4207)+- DropdownMenu selectable items: add `DropdownMenuCheckboxItem` (independent toggle, `role="menuitemcheckbox"`) and `DropdownMenuRadioGroup` + `DropdownMenuRadioItem` (single-select, `role="menuitemradio"`). The control size derives from the menu's item size and swaps to the row's inline-end on touch. They also work inside `ContextMenu` (re-exported as `ContextMenuCheckboxItem` / `ContextMenuRadioGroup` / `ContextMenuRadioItem`). Both menus' keyboard/typeahead/activation now recognize the selectable roles, and the menu context (`DropdownMenuContext`, `useDropdownMenuContext`, `DropdownMenuSize`) is exported for building custom menu items. See #3829.+- Icon: add an optional `label` prop for the accessible name. Setting it makes a standalone icon meaningful (`role="img"` + `aria-label`, no `aria-hidden`), collapsing the old three-attribute dance into one prop; omitting it (or passing `''`) keeps the decorative default (`aria-hidden`).+- "Foolproof init": both `@astryxdesign/core` and `@astryxdesign/cli` now print a postinstall nudge pointing you to `npx @astryxdesign/cli init`, `astryx` commands nudge you to finish setup until init has run, and `astryx init` runs non-interactively (no TTY required) so it works in CI and agent environments. (#4147, #4153, #4154, #4155)+- Outline: keyboard navigation, navigate callbacks, and scroll-scoping props (#2527)+ Layers the public API deferred out of #2746 onto the scroll-spy engine and click-lock that already shipped. No visual change.+- Table: add a tree-data plugin — `useTableTreeState` and `useTableTreeData` — for rendering and managing hierarchical (parent/child) rows, expansion state, and flattening. Exported from `@astryxdesign/core/Table`. (#3789)++#### Fixes++- `AvatarGroupOverflow` now grows into a pill for long `+N` counts so the number never clips.+ The indicator was a fixed-size circle, so wide counts (e.g. `+4912`) overflowed and crowded the edges. It now uses a minimum width equal to the avatar size plus horizontal padding: short counts (`+5`) stay a perfect circle, while longer counts grow horizontally into a stadium/pill and remain legible. No new public props.+- Carousel now scrolls horizontally when you hold Shift and scroll the mouse wheel. Trackpad users already got horizontal scroll for free; this brings standard mouse (vertical-only wheel) users to parity using the established Shift + wheel convention. Native trackpad horizontal scrolling and the prev/next buttons are unchanged.+- Citation: a non-interactive citation (no `source.url`) now keeps the default cursor instead of showing a pointer, so only linked citations look clickable. The pointer cursor is applied alongside the existing hover treatment for both the `label` and `number` variants (#4134).+- Stop suggesting bare `npx astryx` before the CLI is installed — it resolves to an unrelated package on the npm registry.+ The CLI now emits an install-aware invocation everywhere it prints a command:+- Icon: size variants (`xsm`/`sm`/`md`/`lg`) now use `rem` instead of hardcoded `px`, so icons scale in step with text when the document/root `font-size` changes — matching the rest of the design system's rem-based type scale. Fixes #4092.+- Guard useTableRowExpansionState tree walks against cyclic data (#3971)+ The `depthMap`, flattened `data`, and `allExpandableKeys` walks now track the ancestor keys on the current path and skip edges that point back at an ancestor, so self-referential or cyclic row data terminates instead of overflowing the stack.+- Route the Table sortable plugin's header-button aria-labels ("Sort by …", "… sorted …", "… priority … of …") through `useTranslator()` with new `@astryx.table.sort.sortBy` / `sortedBy` / `sortedByWithPriority` / `direction.*` catalog keys, so they localize like the sort menu labels already do (#3618, tracker #3636). The direction word resolves through its own key rather than interpolating the raw enum value. English output is unchanged.+- Table: the tree row expander's `aria-label` is now localized through `useTranslator()` instead of a hardcoded English string, so expand/collapse controls announce in the app's language. (#4149)+- TabList `hasDivider` reserves a gap so the hover pill and adjacent buttons no longer touch the underline+ A divided TabList now reserves 4px between the tabs and the divider rail. The hover highlight sits clear of the underline, and a same-size Button placed alongside the tabs aligns to the tab baseline instead of butting the rail — so a `md` tab strip pairs with a `md` button. The selected indicator still rests on the rail. Non-divided tab lists are unchanged. TabList inside a `Toolbar` with `dividers={['bottom']}` gets the same alignment via the toolbar's own spacing.+- TreeList: focusing a parent row no longer leaks the focus-visible outline onto its descendant rows — each row's ring now resolves from its own nearest treeitem instead of matching any focused ancestor (#4130)++#### Documentation++- DropdownMenu and DropdownMenuItem: seed playground defaults so the docsite properties-tab preview renders real content instead of an empty trigger.++#### Other Changes++- Installed / global / dev runs suggest `<pm> astryx <cmd>` (e.g. `pnpm exec astryx …`), unchanged.+- One-off runs (launched via `npx`/`pnpm dlx`/`yarn dlx`/`bunx`) suggest the scoped package `<dlx> @astryxdesign/cli <cmd>`, which always resolves to us.+- Improved translator context in the shipped English catalog (`packages/core/locales/en.json`) descriptions. Sharpened ~172 entries — added screen-reader-only clarifications, ICU-composition examples, polysemy warnings, and set-pairing notes — so translators working in Crowdin get better context. No changes to `defaultMessage` values, keys, or runtime API.+- **Keyboard navigation** — the outline is now a single tab stop (roving tabindex via `useListFocus`), seated on the _active_ heading per WAI-ARIA, so tabbing into a table of contents while reading section 7 lands on section 7 rather than sending the reader back to section 1. Arrow keys move between headings, Home/End jump to the ends, and Enter/Space activate. A 40-heading table of contents costs one Tab press instead of 40, and Tab still leaves the outline in one press.+- **`onNavigateStart(id)` / `onNavigateEnd(id)`** — fire around the smooth scroll started by a click or keyboard activation, so an app can drive an arrival effect. `onNavigateEnd` resolves on `scrollend` where supported and on a settle timeout where it is not (Safari), so it also fires correctly when reduced motion collapses the scroll into an instant jump. It fires exactly once for every `onNavigateStart` — including when the user interrupts the scroll — so a "navigating" state can never leak.+- **`offset`** — the height of a fixed header overlaying the top of the scroll root. It shifts both the activation line **and** the scroll landing by the same amount, so a heading activates exactly where navigating to it puts it: below the header, not hidden underneath it. It composes with each heading's own `scroll-margin-top` (the header, then the breathing room below it) rather than replacing it — leave `offset` at 0 when nothing overlays the content and let `scroll-margin-top` do the work, since the browser already honors it.+- **`scrollContainerRef`** — scope scroll tracking to a specific container instead of auto-detecting the nearest scrollable ancestor. Fixes the table of contents whose highlight never moves inside a split pane, modal, or dashboard panel. The default (viewport) path is unchanged.+- **`hasScrollOnClick`** (default `true`) — set to `false` to own the scrolling yourself; the outline still updates the active item, the hash, and the navigate callbacks.++#### Contributors++Thanks to everyone who contributed to this release:++- @AKnassa+- @cixzhang+- @ernestt+- @is-jain+- @joeyfarina+- @josephfarina+- @MeGaurav4+- @nynexman4464++---+# 0.1.7#### Breaking Changesdiff --git a/packages/core/package.json b/packages/core/package.jsonindex f0b56b7cda..54779ab284 100644--- a/packages/core/package.json+++ b/packages/core/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/core",- "version": "0.1.7",+ "version": "0.1.8","displayName": "Astryx 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.mdindex 1f66197632..1aac90813d 100644--- a/packages/lab/CHANGELOG.md+++ b/packages/lab/CHANGELOG.md@@ -1,5 +1,9 @@# @xds/lab+# 0.1.8++---+# 0.1.7---diff --git a/packages/lab/package.json b/packages/lab/package.jsonindex 3c386c74ec..f4fe86a074 100644--- a/packages/lab/package.json+++ b/packages/lab/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/lab",- "version": "0.1.7",+ "version": "0.1.8","private": true,"description": "Experimental Astryx components — published to npm only under the @canary dist-tag for early testing; never released as a stable (latest) version.","author": "Meta Open Source",@@ -57,7 +57,7 @@},"peerDependencies": {"@stylexjs/stylex": ">=0.10.0",- "@astryxdesign/core": "0.1.7",+ "@astryxdesign/core": "0.1.8","react": ">=19.0.0","react-dom": ">=19.0.0"},diff --git a/packages/themes/butter/CHANGELOG.md b/packages/themes/butter/CHANGELOG.mdindex d726002a40..50b995b52c 100644--- a/packages/themes/butter/CHANGELOG.md+++ b/packages/themes/butter/CHANGELOG.md@@ -1,5 +1,9 @@# @xds/theme-butter+# 0.1.8++---+# 0.1.7---diff --git a/packages/themes/butter/package.json b/packages/themes/butter/package.jsonindex 037fcb1292..b2df3a18b0 100644--- a/packages/themes/butter/package.json+++ b/packages/themes/butter/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/theme-butter",- "version": "0.1.7",+ "version": "0.1.8","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.7",+ "@astryxdesign/core": "0.1.8","react": ">=19"},"devDependencies": {- "@astryxdesign/cli": "0.1.7"+ "@astryxdesign/cli": "0.1.8"},"module": "./dist/source.mjs"}diff --git a/packages/themes/chocolate/CHANGELOG.md b/packages/themes/chocolate/CHANGELOG.mdindex 7e32ded312..8b76903ff9 100644--- a/packages/themes/chocolate/CHANGELOG.md+++ b/packages/themes/chocolate/CHANGELOG.md@@ -1,5 +1,9 @@# @xds/theme-chocolate+# 0.1.8++---+# 0.1.7---diff --git a/packages/themes/chocolate/package.json b/packages/themes/chocolate/package.jsonindex 6ee1c6c719..5958d9cd28 100644--- a/packages/themes/chocolate/package.json+++ b/packages/themes/chocolate/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/theme-chocolate",- "version": "0.1.7",+ "version": "0.1.8","displayName": "Chocolate Theme","private": false,"description": "Warm chocolate theme for Astryx — rich brown palette with Fraunces headings, Albert Sans body, and Lucide icons",@@ -52,11 +52,11 @@"lucide-react": "^1.18.0"},"peerDependencies": {- "@astryxdesign/core": "0.1.7",+ "@astryxdesign/core": "0.1.8","react": ">=19"},"devDependencies": {- "@astryxdesign/cli": "0.1.7"+ "@astryxdesign/cli": "0.1.8"},"module": "./dist/source.mjs"}diff --git a/packages/themes/gothic/CHANGELOG.md b/packages/themes/gothic/CHANGELOG.mdindex 24297a2910..04d1c155c5 100644--- a/packages/themes/gothic/CHANGELOG.md+++ b/packages/themes/gothic/CHANGELOG.md@@ -1,5 +1,9 @@# @xds/theme-gothic+# 0.1.8++---+# 0.1.7---diff --git a/packages/themes/gothic/package.json b/packages/themes/gothic/package.jsonindex bbd9074cd6..d6d043421b 100644--- a/packages/themes/gothic/package.json+++ b/packages/themes/gothic/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/theme-gothic",- "version": "0.1.7",+ "version": "0.1.8","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.7",+ "@astryxdesign/core": "0.1.8","react": ">=19"},"devDependencies": {- "@astryxdesign/cli": "0.1.7"+ "@astryxdesign/cli": "0.1.8"},"module": "./dist/source.mjs"}diff --git a/packages/themes/matcha/CHANGELOG.md b/packages/themes/matcha/CHANGELOG.mdindex f0cd229573..97b085a5ff 100644--- a/packages/themes/matcha/CHANGELOG.md+++ b/packages/themes/matcha/CHANGELOG.md@@ -1,5 +1,9 @@# @xds/theme-matcha+# 0.1.8++---+# 0.1.7---diff --git a/packages/themes/matcha/package.json b/packages/themes/matcha/package.jsonindex 27547ff73d..171f63f3ca 100644--- a/packages/themes/matcha/package.json+++ b/packages/themes/matcha/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/theme-matcha",- "version": "0.1.7",+ "version": "0.1.8","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.7",+ "@astryxdesign/core": "0.1.8","react": ">=19"},"devDependencies": {- "@astryxdesign/cli": "0.1.7"+ "@astryxdesign/cli": "0.1.8"},"module": "./dist/source.mjs"}diff --git a/packages/themes/neutral/CHANGELOG.md b/packages/themes/neutral/CHANGELOG.mdindex ce913a6a6c..291a45b40f 100644--- a/packages/themes/neutral/CHANGELOG.md+++ b/packages/themes/neutral/CHANGELOG.md@@ -1,5 +1,9 @@# @xds/theme-neutral+# 0.1.8++---+# 0.1.7#### Fixesdiff --git a/packages/themes/neutral/package.json b/packages/themes/neutral/package.jsonindex fa71737e8f..dbf71d35c8 100644--- a/packages/themes/neutral/package.json+++ b/packages/themes/neutral/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/theme-neutral",- "version": "0.1.7",+ "version": "0.1.8","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.7",+ "@astryxdesign/core": "0.1.8","react": ">=19"},"devDependencies": {- "@astryxdesign/cli": "0.1.7"+ "@astryxdesign/cli": "0.1.8"},"module": "./dist/source.mjs"}diff --git a/packages/themes/stone/CHANGELOG.md b/packages/themes/stone/CHANGELOG.mdindex d59c47120d..b2cadd82e5 100644--- a/packages/themes/stone/CHANGELOG.md+++ b/packages/themes/stone/CHANGELOG.md@@ -1,5 +1,9 @@# @xds/theme-stone+# 0.1.8++---+# 0.1.7---diff --git a/packages/themes/stone/package.json b/packages/themes/stone/package.jsonindex bf2ec899cb..ec10bd1450 100644--- a/packages/themes/stone/package.json+++ b/packages/themes/stone/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/theme-stone",- "version": "0.1.7",+ "version": "0.1.8","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.7",+ "@astryxdesign/core": "0.1.8","react": ">=19"},"devDependencies": {- "@astryxdesign/cli": "0.1.7"+ "@astryxdesign/cli": "0.1.8"},"module": "./dist/source.mjs"}diff --git a/packages/themes/y2k/CHANGELOG.md b/packages/themes/y2k/CHANGELOG.mdindex ac619e9af8..403b2fa9df 100644--- a/packages/themes/y2k/CHANGELOG.md+++ b/packages/themes/y2k/CHANGELOG.md@@ -1,5 +1,9 @@# @xds/theme-y2k+# 0.1.8++---+# 0.1.7---diff --git a/packages/themes/y2k/package.json b/packages/themes/y2k/package.jsonindex 124db25afb..f139aac9de 100644--- a/packages/themes/y2k/package.json+++ b/packages/themes/y2k/package.json@@ -1,6 +1,6 @@{"name": "@astryxdesign/theme-y2k",- "version": "0.1.7",+ "version": "0.1.8","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.7",+ "@astryxdesign/core": "0.1.8","react": ">=19"},"devDependencies": {- "@astryxdesign/cli": "0.1.7"+ "@astryxdesign/cli": "0.1.8"},"module": "./dist/source.mjs"}diff --git a/pnpm-lock.yaml b/pnpm-lock.yamlindex 71268a38dc..1efe2d79a0 100644--- a/pnpm-lock.yaml+++ b/pnpm-lock.yaml@@ -504,7 +504,7 @@ importers:packages/charts:dependencies:'@astryxdesign/core':- specifier: 0.1.7+ specifier: 0.1.8version: link:../core'@stylexjs/stylex':specifier: ^0.19.0@@ -609,7 +609,7 @@ importers:packages/lab:dependencies:'@astryxdesign/core':- specifier: 0.1.7+ specifier: 0.1.8version: link:../core'@stylexjs/stylex':specifier: ^0.19.0@@ -640,7 +640,7 @@ importers:packages/themes/butter:dependencies:'@astryxdesign/core':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../corelucide-react:specifier: ^1.18.0@@ -650,13 +650,13 @@ importers:version: 19.2.7devDependencies:'@astryxdesign/cli':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../clipackages/themes/chocolate:dependencies:'@astryxdesign/core':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../corelucide-react:specifier: ^1.18.0@@ -666,13 +666,13 @@ importers:version: 19.2.7devDependencies:'@astryxdesign/cli':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../clipackages/themes/gothic:dependencies:'@astryxdesign/core':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../corelucide-react:specifier: ^1.18.0@@ -682,13 +682,13 @@ importers:version: 19.2.7devDependencies:'@astryxdesign/cli':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../clipackages/themes/matcha:dependencies:'@astryxdesign/core':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../corelucide-react:specifier: ^1.18.0@@ -698,13 +698,13 @@ importers:version: 19.2.7devDependencies:'@astryxdesign/cli':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../clipackages/themes/neutral:dependencies:'@astryxdesign/core':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../corelucide-react:specifier: ^1.18.0@@ -714,13 +714,13 @@ importers:version: 19.2.7devDependencies:'@astryxdesign/cli':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../clipackages/themes/stone:dependencies:'@astryxdesign/core':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../corelucide-react:specifier: ^1.18.0@@ -730,13 +730,13 @@ importers:version: 19.2.7devDependencies:'@astryxdesign/cli':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../clipackages/themes/y2k:dependencies:'@astryxdesign/core':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../corelucide-react:specifier: ^1.18.0@@ -746,7 +746,7 @@ importers:version: 19.2.7devDependencies:'@astryxdesign/cli':- specifier: 0.1.7+ specifier: 0.1.8version: link:../../clipackages/vega: