What's New

Release notes and changelog for all packages.

0.1.0

Breaking Changes
  • Rename theme-token helpers off the XDS name The @xds/core/theme token helpers are renamed: resolveXDSThemeTokens -> resolveThemeTokens, resolveXDSThemeToken -> resolveThemeToken, xdsTokenVar -> tokenVar, xdsTokenVars -> tokenVars, and the option types ResolveXDSThemeToken(s)Options -> ResolveThemeToken(s)Options. Update imports from @xds/core/theme / @xds/core/theme/tokens. Part of removing xds naming from the public API.
  • Remove the XDS-prefix compatibility layer — astryx is now the only public surface This release erases all xds naming from the public API; there is no compatibility window. Consumers must migrate (we own all consumers pre-OSS):
  • Remove the daily, brutalist, and default themes; neutral is the new baseline Three theme packages are removed from the repo and will no longer be published:
New Features
  • Underline links by default in the Markdown component Markdown links now render with a persistent underline instead of only underlining on hover, making links clearly distinguishable from surrounding text and improving accessibility. The accent color is unchanged.
Fixes
  • Markdown: parse ordered lists using the ) marker delimiter, not just . (#2994) CommonMark 5.2 allows an ordered-list marker to end in . or ) (e.g. 1)), but the parser only matched \d+\. , so 1) First lists rendered as literal paragraph text. Lists now capture their delimiter — a . → ) change starts a new list, including across streamed chunks — and paragraph interruption follows CommonMark (only a marker value of 1, including zero-padded like 01., may interrupt).
Other Changes
  • Component names: the XDS* aliases are gone — use bare names (Button not XDSButton, useTheme not useXDSTheme, ButtonProps not XDSButtonProps). The drop-xds-prefix-imports codemod automates this.
  • CSS classes: components emit only .astryx-* (the dual .xds-* class is gone). Update custom CSS selectors .xds-button -> .astryx-button (prop/state value classes like .primary/.sm are unchanged).
  • data attributes: only data-astryx-theme / data-astryx-media are written; update custom selectors and SSR root attributes off data-xds-*.
  • CSS layers: @layer xds-base / xds-theme are renamed to astryx-base / astryx-theme; update your @layer order line and any PostCSS layersBefore config. @astryxdesign/build's default library layer is now astryx-base.
  • Pre-compiled stylesheet: the @astryxdesign/core/xds.css export is removed — import @astryxdesign/core/astryx.css.
  • CSS custom properties: the --xds-* padding fallback is gone; set --astryx-*.
  • CLI config key: @astryxdesign/cli reads the package.json "astryx" field (was "xds"). Rename the block; a stale "xds" key silently drops the package from discovery.
  • @astryxdesign/theme-daily
  • @astryxdesign/theme-brutalist
  • @astryxdesign/theme-default
  • import {defaultTheme} from '@astryxdesign/theme-default/built';
    • import {neutralTheme} from '@astryxdesign/theme-neutral/built';
  • <Theme theme={defaultTheme}>...</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.
Contributors
Thanks to everyone who contributed to this release:

0.0.15

This release makes bare component names canonical: Button, Stack, useTheme, etc. are now first-class, and the XDS* / useXDS* names become compatibility aliases. Existing prefixed code keeps working through the alias layer — migrate when you're ready with the codemod below. It also lands several prop/component renames for cross-component consistency, each with its own codemod.
Breaking Changes
  • Un-prefix migration — bare names are canonical — Every XDS* component, hook, and type now has a bare alias (XDSButton → Button, useXDSTheme → useTheme, ~634 identifiers across 100 barrels). The prefixed names still work as aliases during the compat window, so this is non-breaking if you do nothing — but bare names are the new default for docs, discovery, and new code. (#2941) Codemod: npx astryx upgrade --codemod drop-xds-prefix-imports
  • @xds/core un-prefix — XDSMetaAppShell → MetaAppShell and related meta-app exports drop the XDS prefix. (#2957)
  • DatePicker components renamed to Input — XDSDateTimePicker → XDSDateTimeInput and XDSDateRangePicker → XDSDateRangeInput (plus their props, size, and hour-format types), for consistency with DateInput/TextInput/NumberInput. (#2276) Codemod: npx astryx upgrade --codemod rename-date-picker-to-input
  • Stack element → as — XDSStack, XDSHStack, XDSVStack, and XDSStackItem use as instead of element, matching other polymorphic components. (#2441) Codemod: npx astryx upgrade --codemod rename-stack-element-to-as
  • Chat isStreaming → isStopShown — On XDSChatComposer and XDSChatSendButton, the prop that controls the stop-button affordance is renamed to describe what it does rather than implying a streaming state. (Unchanged on XDSMarkdown/XDSChatReasoning.) (#2333) Codemod: npx astryx upgrade --codemod rename-isStreaming-to-isStopShown
  • Imperative handles move to handleRef — XDS* components reserve ref for the root DOM element. Components exposing an imperative handle (XDSCalendar, XDSChatComposerInput, XDSPowerSearch, XDSTokenizer, XDSChartStreamGL) now expose it via handleRef; XDSSideNavCollapseButton's sideNavRef is also renamed to handleRef. (#2363) Codemod: npx astryx upgrade --codemod rename-imperative-ref-to-handleRef
  • Menu/Selector trailing content: children → endContent — XDSDropdownMenuItem, XDSContextMenuItem, and XDSSelectorOption use endContent for trailing badges, status icons, shortcuts, and other end-aligned content; the previous trailing-content children prop is removed. (#2802) Codemod: npx astryx upgrade --codemod migrate-item-children-to-endcontent
  • Selector custom rendering: function-children → renderOption — XDSSelector and XDSMultiSelector use the renderOption prop for custom option rendering; the previous function-as-children renderer is removed. (#2821) Codemod: npx astryx upgrade --codemod migrate-selector-children-to-render-option
  • CheckboxList loading is now per-item — The group-level isLoading on XDSCheckboxList is removed in favor of isLoading on XDSCheckboxListItem. In collection mode the toggled item shows its spinner automatically while its changeAction is pending. (#2903)
  • Chat messageGap → gap — XDSChat renames messageGap to gap. (#2325)
  • FileInput onChangeAction → changeAction — Aligns XDSFileInput with the React 19 action-prop convention used across the system. (#2288)
  • PowerSearch preset types → *FilterPreset — Preset type exports are renamed for clarity. (#2925)
  • CenterAxis → XDSCenterAxis, DateRange unprefixed — Type-export naming cleanups for consistency. (#2289, #2922)
  • Stepper moved to @xds/lab — XDSStepper/XDSStep move to the lab package while the API is reworked; import from @xds/lab. (#2335)
Upgrade
bash
npx astryx upgrade --apply
This runs the release codemods in sequence. The bare-name migration (drop-xds-prefix-imports) and the theme data-attribute migration (migrate-theme-selectors-to-data-attrs) are optional — run them explicitly when you're ready, e.g.:
bash
npx astryx upgrade --codemod drop-xds-prefix-imports --codemod-only --apply
New Components
  • XDSLightbox — Image/media lightbox with overlay presentation. (#2298)
  • XDSItem — Shared item primitive with compact/balanced/spacious density and startContent/endContent slots, now composed by XDSListItem. (#2259)
  • XDSOutline — Sliding-indicator outline/nav with density variant and CSS anchor positioning. (#2347, #2746)
  • useXDSInteractiveRole / XDSInteractiveRoleContext — Coordinate interactive-role semantics across nested components. (#2399)
New Features
  • Bare-name subpath exports — @xds/core/Heading, @xds/core/Code, @xds/core/HStack, @xds/core/VStack ship as convenience subpaths. (#2420)
  • Field width prop — Field-based components accept a width (SizeValue) applied to the outer XDSField, so label, control, and status size together and stay aligned. Additive and backward compatible. Affects XDSTextInput, XDSTextArea, XDSNumberInput, XDSDateInput, XDSDateRangeInput, XDSDateTimeInput, XDSTimeInput, XDSFileInput, XDSSelector, XDSMultiSelector, XDSTypeahead, XDSTokenizer, XDSSlider, XDSCheckboxInput, XDSCheckboxList, XDSRadioList, XDSSwitch, and XDSField. (#2755)
  • lg size on all input components — Inputs gain a large size option. (#2324)
  • Markdown autolink="gfm" — XDSMarkdown gains an opt-in autolink prop enabling GitHub-Flavored Markdown autolink-literal rules (bare https?://…, www.…, <scheme:url>, <email>, user@host), skipping code spans, existing links, and image alt text. Also exposed on parseMarkdown, parseInline, and parseMarkdownIncremental via a new ParseOptions argument; the existing positional signature is preserved. Default behavior unchanged. (#2394)
  • Markdown display="inline" — Render inline markdown spans that inherit surrounding typography, for doc text and table cells without block-level wrappers.
  • Visual props reflected as data attributes — Components dual-emit data-* attributes for their variant/state axes (e.g. data-variant, data-size) alongside legacy bare variant classes, giving themes a stable selector surface. (#2792)
  • Spinner shade="inherit" — Paints the ring from inherited currentColor (with a translucent track) so it always matches the parent's resolved foreground regardless of theme or variant.
  • Text/Heading justify prop — Justified text alignment on XDSText and XDSHeading. (#2438)
  • AspectRatio isCircle — Circular containers via XDSAspectRatio. (#2632)
  • Link renders a button when href is undefined — XDSLink produces a semantic <button> for action links without an href. (#2507)
  • Carousel hasEdgeFade + padding props — Edge-fade affordance and padding control; the scale animation is removed. (#2566)
  • Tab isLabelHidden — Icon-only tabs omit empty label nodes so selected indicators align with the visible icon.
  • Menu placement options — Additional placement controls for menu surfaces. (#2770)
Fixes
  • Button/Spinner loading contrast — Fix poor loading-spinner contrast on themed variants; the spinner inherits the true variant foreground and the label hides correctly on destructive. (#2717)
  • Spinner centering — Fix XDSSpinner rendering off-center inside the icon-only XDSButton loading state at fractional device pixel ratios; loading overlay and wrapper use display: grid + place-items: center.
  • ChatComposer caret — XDSChatComposerInput preserves the caret when the parent updates the controlled value, fixing the caret jumping to offset 0 after slash-command picks.
  • Icon slots — renderIconSlot renders semantic icon-name strings through XDSIcon; new getIconRegistry() lets tooling derive icon-name options from the same registry.
  • CommandPalette inline scroll — XDSCommandPaletteItem no longer scrolls highlighted items into view on initial mount inside an inline dialog, preventing doc-page scroll jumps.
  • Docsite autofocus — XDSDialogHeader skips title autofocus inside XDSDialog isInline; XDSCommandPaletteInput reads the shared dialog inline context.
  • HoverCard font — Apply the theme body font token to XDS layer roots so portaled HoverCard content inherits the configured font family.
  • Info status icon — The default info status icon uses a solid fill (matching success/error/warning) for better visibility at small sizes.
  • List/Item density — XDSListItem passes density (compact/balanced/spacious) through to the shared XDSItem, fixing balanced/spacious collapsing to the same padding.
  • Markdown loose lists — Join blank-line-separated same-style list items into a single loose list (CommonMark §5.3) and forward a non-default start onto the rendered <ol> for assistive tech and copy-paste.
  • AppShell mobile nav — Fix mobile nav with a heading-only XDSTopNav; remove useXDSSlotPresence. (#2243)
  • Theme CSS prose regression — Fix built theme CSS that broke Markdown typography in the docsite (headings lost block margins) after the un-prefix migration. astryx theme build now uses a single CSS generation path (@xds/core's generator) and a failed @xds/core/theme import is a hard build error instead of a silent fallback. (#2964)
  • Escape-hatch & base-prop hygiene — Many components had redundant xstyle/className/style re-declarations removed and now consistently extend XDSBaseProps, forward escape hatches, and expose displayName (require-base-props / require-ref-prop lint rules). (#2300, #2310, #2835, #2858)
  • Toast barrel export — Export XDSToast and its props from the @xds/core barrel so docsite playground previews resolve Toast examples.
  • Typeahead id-less rows — XDSBaseTypeahead uses a shared key fallback for search results without id values, so id-less rows no longer all render as selected.
  • SelectableCard transitions tokenized; ResizeHandle gains className. (#2966)
Contributors
Thanks to everyone who contributed to this release:

0.0.14

Breaking Changes
  • on*Action → *Action (React 19 convention) — onChangeAction → changeAction, onClickAction → clickAction, onPressedChangeAction → pressedChangeAction, onScrollToTopAction → scrollToTopAction. Aligns with React 19 action prop naming. (#1942) Codemod: npx astryx upgrade --codemod rename-action-props
  • Status naming: positive/negative → success/error — Converge status variant naming across all components. (#2175) Codemod: npx astryx upgrade --codemod rename-status-variants
  • Section wash → muted — Rename variant for consistency with XDSCard. (#2063) Codemod: npx astryx upgrade --codemod rename-section-wash-to-muted
  • Stack direction defaults to vertical — XDSStack no longer requires an explicit direction prop; omitting it gives vertical layout. (#1945)
  • Table textOverflow default changed to truncate — Was wrap, now truncates by default with tooltip on hover. (#2096)
  • Remove deprecated *Raw token aliases — Migrate any *Raw usage to standard tokens. (#2095)
  • Remove runtime font loading from defineTheme — Fonts are now handled at the CSS level only. (#2226)
Upgrade
bash
npx astryx upgrade --apply
This runs all three codemods (rename-action-props, rename-status-variants, rename-section-wash-to-muted) in sequence.
New Components
New Features
  • Link to prop — Pass to alongside href for router compatibility (#2237)
  • Selector hasSearch — Enable filtering/searching within selector options (#2142)
  • CodeBlock container prop — Control width and border on code blocks (#2132)
  • Heading display type variants — Large display headings for hero sections (#2054)
  • Text custom theme-defined types — Support arbitrary text types from your theme (#1840)
  • Table structural children mode — Use <XDSTable> with JSX children + Markdown integration (#2098)
  • Table content-aware column widths — Auto layout for children mode (#2105)
  • Table responsive horizontal scroll — Default column min-widths (#2043)
  • TabList carousel overflow — Arrow navigation for overflowing tabs (#1978)
  • PowerSearch components map — Per-type token and editor overrides (#2076)
  • Markdown components map — Custom component injection + XDSCitation extraction (#2073)
  • Markdown inlinePlugins — Custom text pattern rendering (#1917)
  • SideNav built-in resize — Integrate useXDSResizable directly (#1877)
  • Resizable pill placement offset — Auto-collapse flipping (#1876)
  • Theme --color-track token — Spinner consumes it for fully tokenized track (#2170)
  • Server-safe utility subpath exports — @xds/core/server for RSC (#1981)
  • XDSLinkProvider adoption — All link-rendering components now use the provider (#1906)
Fixes
  • Chat composer paste — Fix silently dropped paste when no forwarded ref (#2179)
  • Citation — Prevent rest spread from overriding accessibility props; extend XDSBaseProps (#2217, #2092)
  • Field — Neutral gray hover shadow, focus border on input, horizontal-labels grid, z-index containment, click-to-focus on wrapper (#2157, #2059, #1890, #1839)
  • FormLayout — Equal-width horizontal children via CSS Grid (#2058)
  • Link label — Make optional; aria-label harms AT on text links (#2031)
  • TopNav — Stop click propagation on heading links, remove hover delay, add selected state to xdsClassName (#2135, #2133, #1997)
  • Spinner — Simplify color resolution with useXDSTheme (#2124)
  • Markdown tables — Reset container padding, alignment and width fixes (#2121, #2109)
  • Calendar — Add isolation to day cell container (#2001)
  • CommandPalette/MultiSelector — Prevent iOS zoom on input focus (#1993)
  • Dialog — Target-based backdrop detection for native popup compat (#1892)
  • Typeahead — Propagate generic type; prevent empty popover after selection (#2014, #1943)
  • Selector/MultiSelector — Resolve nested button HTML violation (#1853)
  • ClickableCard — Merge caller xstyle with internal interactive styles (#1893)
  • RadioList — Extend XDSBaseProps for standard prop inheritance; fix typography tokens (#2093, #1902)
  • Tokenizer — Add status to xdsClassName for theme targeting (#1995)
  • List — Wrap header + list in column container for flex parents (#2017)
  • Section — Propagate explicit padding to nested sections (#1972)
  • AppShell — Match flex layout properties on sticky sidenav container (#1850)
  • Menu hover — Gate behind (hover: hover) media query (#2046)
  • ResizeObserver — Migrate all usage to shared singleton for performance (#1990)
  • Layout — Container-driven edge compensation via :has() (#1987)
  • Missing xdsClassName hooks — Added to components using border tokens (#2244)
  • ProgressBar — Add xdsClassName to track for theme targeting (#2079)
  • z-index isolation — Add isolation to components with leaky z-index (#2004)
  • use client directives — Added to CommandPalette barrel, CodeBlock, ClickableCard, and others (#2069, #2048, #1833)
  • Thumbnail — Focus ring clipped by overflow hidden (#2264)
  • DropdownMenu — Light-dismiss + click-toggle race on touch browsers (#2186)
  • Theme — Baseline media theme color-scheme flip, standalone theme text styling fixes (#1921, #1831)
Contributors
Thanks to everyone who contributed to this release:

0.0.13

Breaking Changes
  • Toolbar density → size — XDSToolbar replaces the density prop with size, adds XDSSizeContext cascade for child components. (#1448)
  • Icon renames: checkCircle/xCircle → success/error — Default icon registry renames for semantic clarity. (#1503)
  • XDSChatComposerAttachments → XDSChatComposerDrawer — Renamed for clarity. (#1714)
  • Remove deprecated XDSSelectorItem — Internalized XDSSelectorOption; use XDSSelector directly. (#1582)
  • Tighten XDSBaseProps — Omits title and obscure HTML attributes; adds data-* index signature. (#1505, #1502)
New Features
Fixes
Performance
  • CodeBlock: content-visibility chunking for range mode, eliminate stylesheet mutations (#1457)
Upgrade
Codemods are available for all breaking changes in this release:
sh
npx astryx upgrade --apply --to 0.0.13
Preview changes first (dry run): npx astryx upgrade --to 0.0.13 Run a specific codemod: npx astryx upgrade --apply --codemod toolbar-density-to-size List all available codemods: npx astryx upgrade --list

0.0.12

Breaking Changes
  • Button isIconOnly required for icon-only mode — XDSButton and XDSToggleButton now require explicit isIconOnly for icon-only rendering. (#1257)
New Features
Fixes
  • Dialog: reset inherited edge signals, prevent ghost button margin shift (#1237)
  • CodeBlock: syntax highlighting missing on scroll + perf improvements (#1221)
  • Chat: harden bubbles, scroll button, drawer animation, status (#1245)
  • Chat: use color-neutral for message bubble background (#1271)
  • SegmentedControl: consistent border-radius for sm size (#1206)
  • Omit children from XDSBaseProps — require explicit opt-in (#1246)
  • Theme: ship built theme modules to prevent double CSS injection (#1247)
  • Theme: support bare state keys in parseStyleKey (#1233)
  • ProgressBar/Section: migrate to XDSBaseProps, fix RadioList double-apply (#1253)
  • CodeBlock: use semantic --text-code-size token for md size (#1273)
  • Input: forward native event handlers via ...rest spread (#1259, #1291)
Upgrade
Codemods are available for all breaking changes in this release:
sh
npx astryx upgrade --apply --to 0.0.12
Preview changes first (dry run): npx astryx upgrade --to 0.0.12 Run a specific codemod: npx astryx upgrade --apply --codemod add-is-icon-only List all available codemods: npx astryx upgrade --list