What's New

Release notes and changelog for all packages.

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:

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