What's New
Release notes and changelog for all packages.0.4.3
New Features
- New string utilities:
characterCount,firstCharacter, andtruncateCharacters— replacements for.length,.charAt(0), and slice-based truncation that measure and cut user-visible strings by whole characters, so an emoji, flag, or accented letter counts as one and never gets split. Built onIntl.Segmenterwith a code-point fallback. - ComplexSelector: support ghost toolbar triggers, leading icons, popup alignment, and an imperative
handleRef(open/close/toggle/isOpen) for programmatic control. useContainerReveal: two ways to control the reveal without reaching into the hook's private custom properties.getContainerProps({hoverDelay})gates the reveal on pointer dwell — the hover-intent idea Tooltip and HoverCard already have asdelay— so a cursor sweeping down a list no longer lights up every row it grazes, andgetContainerProps({forceState})pins the container's trigger state when something else owns the interaction (a scroll, a drag, an open row menu). Per element,getContentRevealProps({forceVisibility})pins how one child looks regardless of its container. Still CSS-only: no hover state in React, no re-render. Keyboard and touch are untouched — focus always reveals,forceState: 'inactive'andforceVisibility: 'hidden'both yield to:focus-within.
Fixes
- Banner: a dismissed banner no longer drops focus, a custom status no longer loses its ARIA role, and the info banner paints again under the neutral theme. Dismissing unmounted the focused dismiss button, so focus landed on
<body>and a keyboard user lost their place in the page. Banner now records where focus entered from and returns it there, the same handoffToastViewportmakes for a dismissed toast. Measured in Chromium:document.activeElementwasBODY, and is now the control the user tabbed in from.BannerStatusMapis documented as augmentable, but all four status lookups were closedRecord<BannerStatus, ...>maps. Adding the augmentation the docs show produced four TypeScript errors insideBanner.tsxitself, which a consumer cannot fix, and at runtime an unknown status resolved toundefinedfor its icon, its background and its ARIA role, so the banner stopped being a live region at all. The lookups are partial now: an unrecognized status renders with no status fill, no default glyph androle="status".A theme could not reach the banner's radius.--_banner-radiuswas declared in the doc file and inderivedVarRegistry.ts, but no rule read it, so a theme'sborderRadiuson thebannertarget expanded into a variable nothing consumed. The four card-silhouette radii read it now, falling back to--radius-container.Under@astryxdesign/theme-neutralthe info banner had no background at all, light or dark: the override setbackground-colordirectly and forced--color-accent-mutedtotransparent, and a plain CSS property written by a theme lands in@layer astryx-theme, which StyleX's@layer priority4outranks. Info now goes through--color-accent-mutedlike the other three statuses and like the stone theme already did.Also in this change:children={false}(the ordinary{cond && <ul/>}idiom) no longer produces an expand toggle that opens an empty box, anddescription=""no longer leaves an empty 20px row, both viaisRenderable; a long unbroken word in the title or description no longer forces the page into horizontal scrolling at a 320px viewport, measured atdocument.scrollWidth529px before; and the content area's bottom border uses logicalborder-block-endalongside its inline siblings. - Count and cut text the way people read it: the TextArea character counter (and its over-limit state and screen-reader announcements) counts user-perceived characters — an emoji is 1, not 2; PowerSearch token truncation no longer cuts an emoji or accented letter in half; Table's auto-generated headers capitalize astral-plane letters correctly; Avatar's initials now use the shared character utilities.
- ComplexSelector: honor the
sm,md, andlgelement-height tokens exactly. - TreeList's
variantaxis is themeable, and a new guard keeps every extensible axis honest.TreeListVariantMapinvites theme packages to add variants — its own JSDoc shows the module augmentation — butthemeProps('tree-list', {density})never passedvariant, so a custom variant type-checked, rendered, and produced no selector to style. It is passed now, and documented in the target'svisualPropssoastryx theme buildstops calling it an unknown prop.packages/core/src/theme/extensibleAxes.test.tsis the third theming-drift guard, beside the ones coveringtargetsandvars/derived. Those two check what a component renders against what it documents; neither looked at the open prop unions, which is why this went unnoticed. For every*Mapthat types a component prop, it now asserts the three places that have to agree: the interface is declared in the index a consumer augments (a re-export is invisible to both module augmentation and the CLI), the prop is reflected throughthemeProps, and it is documented as a visual prop. It reads the TypeScript AST rather than the type checker, and holds the map's OWNER accountable — a component forwardingactionVariantorstatusVariantto the component that owns the map is not separately responsible for it.Registry maps that widen a set of NAMES rather than a visual prop (IndicatorMap,IndicatorFamilyMap) are out of scope by construction, not by allowlist: the guard only considers maps whose alias types a prop on a*Propsinterface. - Security: reject
javascript:,vbscript:anddata:text/htmlURLs in the Markdown parser, so untrusted markdown can no longer produce an executable link href or image src; and fixescapeRegExpinChatTokenizedText, whose character class closed early and left]and\unescaped, so token values containing them were injected raw into aRegExp extendsnow reaches the CSS. A theme that extended another built a stylesheet holding only the declarations it stated itself: the base's tokens, component overrides and surface rules were all absent, and because each theme is@scoped to its owndata-astryx-themevalue, loading the base's stylesheet alongside could not fill the gap either. Every consumer of an inheritance chain silently got stock geometry, elevation and type with a new palette painted over it (#5067). Nothing warned; the loss only showed up by diffing two generated stylesheets token by token. The cause wastheme buildshadowing its own inputs. It writes<name>.jsnext to<name>.ts, and the loader resolved a plain./<name>specifier to that generated artifact before the source — so the second build of a family read the artifact, which carries nocomponentsand exports<name>Themerather than whatever the source exports. A named import that missed becameextends: undefined, anddefineThemetreated an absent base as no base at all. The loader now resolves source extensions first, which is also the resolution the author's TypeScript sees, so the CSS a build emits matches the theme that type-checked.Three things behind it are fixed too, so the failure cannot come back by another route.defineThemethrows whenextendsis present but is not a theme, naming the likely cause, instead of inheriting nothing — the one behavior change here, and it turns a silent stylesheet into a build error. A theme'sonDark/onLightsurfaces and its__inputTokensare now inherited like its tokens and components were, so a child no longer reverts its base's inverted-surface customizations to the defaults or loses its[light, dark]tuples. And a built theme module now carries the resolvedcomponentsand surfaces alongside its tokens, so extending one — the./builtsubpath every shipped theme exposes — is no longer lossy.theme buildalso stopped hand-picking fields when it re-resolves a plain object theme file, which droppedextends,colorandsyntaxon the way in.An extended theme is flat: everything it inherits is resolved into its own output, and its stylesheet stands alone. Measured on a 14-theme family (one base, 13 palettes extending it): each palette went from 25 custom properties and no component rules to the base's full 175 and 70, with its own colours still winning.
Contributors
Thanks to everyone who contributed to this release:
0.4.2
New Features
- AvatarGroup: expose
sizeon theavatar-group-overflowtheming target so themes can style the "+N" overflow chip per size (matchingavatar-fallback); the default chip font is unchanged (#5046). - Chat: ChatMessageBubble accepts a
widthprop (numbers are pixels, strings pass through, e.g.width="100%"), following the sizing convention on Card and other containers. When set it replaces the bubble's defaultmax(80%, 280px)width cap; when unset nothing changes. Combined withvariant="ghost", custom in-message content (an artifact card, attachment chips, a standalone ChatMessageMetadata) can now align with the bubble's text column at the full message-column width — previously the only workaround was hardcoding the bubble's private padding token at every call site. (#2574) astryx theme templatewrites an annotated theme template into your project (#5048). New sibling oftheme add: whereaddstarts you from a theme we ship,templatestarts you from a blank annotated one.astryx init --features themecalls the same leaf, so project setup writes it too — it previously printed a one-line hint and wrote nothing, which is the weakest form of the help a theme author needs, since the first problem is not knowing the command but not knowing what the theme surface contains. The file istheme.template.ts: everydefineThemefield with a note on when to reach for it, the token families, the component override syntax, and the consumption steps (providing the theme, loading the fonts you name, building for SSR), each section naming the CLI command that prints its authoritative reference. An existing file is never clobbered.This came out of a vibe test (#5047): agents given an annotated template reached twice as far into the theme surface as agents given only the docs (17 component targets vs 8, and the only arm to use interaction states, custom variants andonDark), and shipped a third of the contrast defects.A template that lies is worse than no template, so its claims are machine-checked against live sources rather than trusted:scripts/check-theme-template.test.mjsfails when adefineThemefield is added and left undocumented, when a token family is missing from the inventory, when a CSS variable or component key it names does not exist, when it cites a docs topic that does not, or when a theme source drops its SYNC reference.theme buildcompiles it warning-free in CI, and the CLI typecheck now covers it.
Fixes
- Avatar: put the avatar box on the element that carries the
astryx-avatartheme target, so a theme rule on the documentedsizeaxis resizes the whole avatar instead of growing the wrapper around a fixed-size circle; treat a whitespace-onlynameoraltas absent, so it falls through to the default icon rather than rendering an empty plate behind a blank accessible name; warn through the shareduseDevWarninghook rather than a bareconsole.warnin the render body; and replace the phantom<OnlineIndicator />in the JSDoc example with the realAvatarStatusDot(#5030) - CommandPaletteFooter: wire default keyboard-hint strings through useTranslator so they resolve from the locale catalog instead of being hardcoded English (#4506)
context-menucomponent overrides now drive the menu's internal radius and padding vars.ContextMenu.doc.mjshas always documentedderivedentries mappingborderRadius→--_dropdown-menu-radiusandpadding→--_dropdown-menu-padding, butderivedVarRegistryhad nocontext-menukey, so the mapping was dead:components: {'context-menu': {base: {borderRadius: '12px'}}}emittedborder-radiusalone and the menu kept reading its ownvar(--_dropdown-menu-radius). The registry entry now matches the doc, as it already does fordropdown-menu(#4783).useFocusTrap: a modal surface with no tabbable controls keeps its programmatic focus target instead of letting Tab escape into the page behind it. A dialog that places initial focus on atabIndex={-1}heading or panel had nowhere to advance to, so Tab walked straight out of the trap.@astryxdesign/core/hooksalso exportshasActiveFocusTrapEscapeandisImeKeyEvent, which coordinate nested traps and skip IME composition keys (#5023).- Heading's
typeis a documented theming target, and the docs stop teaching a CSS variable that does not exist (#5016).Headingreflectstypeas a theme selector —typography.scalegeneratesheading: {'type:display-1' …}rules for it — buttheming.targetslisted onlylevelandcolor, soastryx theme buildwarnedUnknown prop "type" on component "heading"on every theme that sets a type scale, including the shippedneutralTheme. The drift guard missed it twice over: it read a conditional spread ({level, color, ...(type && {type})}) as an unknown bag, and it only checked a component against a doc file in its own directory, soHeading/— documented fromText/Text.doc.mjs— was never checked at all. Both are fixed, which brings three more previously unchecked directories under the guard.Separately, the theme docs' component-override example set--button-press-scale, which no component defines: copying it produces CSS that silently never applies. It now sets a real public var, and the example no longer declares the samebuttonkey twice. - DateTimeInput: the focused-and-empty time placeholder hints ("e.g., 2:30 PM" / "e.g., 14:30") now route through the i18n translator so they localize with the rest of the component. Adds
@astryx.dateTimeInput.timeHint12hand@astryx.dateTimeInput.timeHint24hto theencatalog. The live-region "Invalid date" / "Invalid time" announcements this PR also covered landed first in #4363 and now reuse that PR's@astryx.dateInput.invalidDateand@astryx.timeInput.invalidTimekeys. (#4546) - Floating layers now declare their own body type instead of inheriting it. The layer container already set
font-family; it now setsfont-sizeandline-heightfrom--text-body-size/--text-body-leadingalongside it. A layer is hosted wherever its trigger sits, so any content that did not set its own size took the ambient one — the same Tooltip, Popover or HoverCard rendered at 13px from a caption and at 20px from a lede. Content that goes throughText, or sets a size itself (Tooltip's label, DropdownMenu items, NavMenu headings), is unaffected: those already declared their own and still win. Anything that was relying on inheriting a non-body size now renders at the body size and should set one explicitly (#5064). - Added a
@astryx.listInput.*catalog namespace topackages/core/locales/en.jsonso the labListInputcomponent's action labels, empty state, reorder instructions, and live announcements can be translated.ListInputpreviously hardcoded every visible and assistive-technology-facing string (#4967). - Layer: use an inert
<template>marker to find each context layer's actual JSX position. Safe positions stay inline; positions inside a paragraph, link, button, inline formatting, or a structurally restricted container portal to the nearest safe ancestor. Corrective portals keep CSS custom properties inheriting from that nearby host while preserving direction and writing mode, andshow()passes the trigger as the popover's invokersource. The newlazyMountoption waits until opening to resolve and mount content; HoverCard uses it so rich content never enters an invalid paragraph during initial render and unmounts again when hidden. Other context layers keep their existing closed-content behavior (#5039). - Two guards left failing on
mainby their own landings, so every PR since has been red through no fault of its own. #4963 gave Thumbnail's remove button a coarse-pointer hit-area var and did not document it, which the derived-var guard reads as an undocumented private var; the var is aninseton a::afteroverlay, so it is documented as private and listed alongside the other vars no standard CSS property maps onto. #5026 movedborderDefaultsintoCoreTokenName— the landing the theme-template guard was explicitly waiting for (its comment says "when #5017 lands, this guard starts requiring the template to cover it") — so the template's token inventory now names--border-width. - Menus that open on hover no longer close when you click them. A hover-opened menu is already open under the cursor by the time the pointer arrives, so the click that naturally follows was dismissing it — fixed for TopNavMegaMenu in #4555, and now shared: the hover→click guard lives in
useMenuHover, so TopNavMenu, TopNavHeading, SideNavHeading and DropdownMenuSubMenu get it too, and TopNavMegaMenu runs on the shared machine instead of its own copy. Also from the consolidation: opening a menu moves focus into it synchronously rather than a frame later, closing one returns focus to its trigger instead of dropping it to the document, and keyboard activation always opens rather than toggling an open menu shut (#3121) - SideNav: a hardening pass over the family, driven by the component audit. Accessibility, theming, passthrough and code-health defects across
SideNavItem,SideNavHeading,SideNavSection,SideNavCollapseButtonand thenavItemStylesmodule the TopNav drawer modes share — the motion guards, the untranslated flyout name, the hand-rolled visually-hidden block, the dropped...rest, the missing theming state, the uncleaned timers, and the hand-rolled hover intent, which is now the shareduseMenuHover. Nav rows also adopt the shared focus outline from #4654, so a keyboard-focused row is ringed with the system's2px --color-accentat3pxoffset in every theme instead of falling through to the browser's own ring; in a split-action row the link and the chevron toggle are ringed individually, since they are separate tab stops. Three visual fixes came out of review. The collapsed submenu flyout was painting a second, square-cornered surface inside the popover's rounded one, and insetting its own content by 4px instead of standing off the rail — both gone, with the gap moved to the positioned layer whereDropdownMenukeeps it. The selected row now survivesforced-colors: active: it marked the current page with a 6% background tint, which forced colors flatten away entirely, and it now paintsHighlight/HighlightTextlikeToggleButtonandSegmentedControlItem. And the footer icon row comes out one size, with the collapse chevron centred rather than seated 2.42px high on a stray text baseline.Four changes are visible to a consumer. Hover on a collapsed item's flyout is now gated on(hover: hover)and only closes onmouseleaveif hover opened it, and a click-to-dismiss no longer springs back open under a stationary pointer. The footer icon rows cascade asmsize throughSizeContext, so an unsizedButtonpassed tofooterIconsnow matches the built-in collapse button instead of rendering a size larger — pass an explicitsizeto opt out.SideNavCollapseButtontakes asize, for placements outside the nav that have no row to inherit from. AndSideNavCollapseButtontakes the controlledcollapsibleconfig — the same{isCollapsed, onCollapsedChange}object handed to SideNav — which is how a button rendered outside the sidenav now stays in step with it.handleRefon both components is deprecated in its favour: the state the consumer already owns reaches the button through props, with no imperative handle in between. - Slider: the thumb no longer overhangs the component's own box at
minandmax. It was centred on the container edge at either extreme, leaving half of it (10px) outside the control, where a tight container clipped it or it overlapped the next element. Thumb travel is now inset by half a thumb at each end — the geometry a nativeinput[type=range]uses — and the fill, the marks and the pointer-to-value mapping share that inset, so the thumb also stays under the pointer that grabbed it instead of jumping by up to half its width. Vertical sliders and both thumbs of a range slider are fixed the same way (#5051). - Interactive controls meet the WCAG 2.5.8 AA 24px minimum on touch. The Slider track (20px tall, and clickable along its whole length) floors its block size to 24px, Thumbnail's remove button grows its tappable area through a
::afteroverlay, andsmCheckboxInput, RadioListItem and Switch floor to a 24px target centred on the control. All of it is gated on@media (pointer: coarse), and only the invisible tappable area changes — rails, thumbs and glyphs stay exactly where they were, and fine-pointer rendering is untouched (#4963, #4964).
Documentation
- Ten private (
--_*) component theming vars are now documented in their owning component'stheming.vars[]:--_avatar-group-overlap,--_card-elevation,--_card-ring,--_codeblock-gutter-width,--_item-label-color,--_item-description-color,--_tab-indicator-bottom,--_tree-indent(plus--_dropdown-menu-radius/--_dropdown-menu-padding, which Breadcrumbs sets on a child menu). They were declared in source and described nowhere, because the drift guard skipped the--_prefix outright (#4783).
Contributors
Thanks to everyone who contributed to this release:
0.4.1
New Features
- The keyboard focus ring is now a theme token.
--focus-outline-width,--focus-outline-style,--focus-outline-colorand--focus-outline-offsetdrive every ring in core and lab, so one override in a theme'stokensrestyles focus system-wide; the color tracks--color-accentunless a theme sets it. The:focus-visiblecondition is not themeable, so a themed ring still cannot appear for pointer users (#4973). Every ring is now drawn from the shared focus-outline utility rather than written out per component, and a lint rule keeps it that way. Two corrections come with that: the rings that had drifted to a 2px offset (Slider, Switch, Lightbox, ProgressBar, and lab's InfoTip, Step and LogStream) now sit at the documented 3px, and the buttons inside a field — the Date, DateRange and DateTime calendar toggles, the DateRange presets, and the Selector and MultiSelector status buttons — draw the standard 2px ring instead of a 1px one. - AspectRatio, Badge, Blockquote, Card, Center, Code, Grid, Section, Skeleton and VisuallyHidden no longer carry
'use client'(#823). Each was verified against its transitive import graph to use no React client API, no client-only dependency and no module-level mutable state, so they can now render in a React Server Component without forcing a client boundary. A newserverSafeComponents.test.tsderives the server-safe set from the import graph and fails if one of these components later gains a client dependency without restoring the directive — including the transitive casescripts/check-use-client.mjscannot see. Not a breaking change: no prop, type or export changed, and'use client'is inert outside an RSC bundler. Client consumers keep working identically, though bundlers may lay these modules out in different chunks now that they are no longer client entry points. - Selector and MultiSelector:
indicatorPositionplaces the selection indicator on either edge of the option row —startorend, logical, so it follows RTL. Defaults keep today's rendering (endfor Selector's check,startfor MultiSelector's checkbox); a start-positioned check reserves its column on every row so labels stay aligned (#4993).
Fixes
- TimeInput: announce arrow-key time stepping via the polite live region (also in DateTimeInput), localize the "Invalid date"/"Invalid time" live-region messages through the i18n catalog, and use long timezone names in Timestamp's AT-facing aria-label while keeping the short form visible (#4363)
- Banner: the 'banner-icon' theme target now rides on the default status Icon itself instead of its layout wrapper, so theme component overrides ('banner-icon' + 'status:X') that set color actually reach the glyph. The Icon keeps its existing color variant (info still renders accent) and same-element rules in @layer astryx-theme win over it, so default rendering is unchanged. Contract note: '.astryx-banner-icon' now matches the icon element rather than the wrapper when the default icon renders; a theme that used the target for wrapper layout (margin, alignment) now styles the glyph instead. With a custom
iconnode the target stays on the layout-only wrapper, since core never injects props into consumer elements (#4166) - CommandPalette: discard in-flight search responses when the palette closes (#3896) Closing the palette while a search was still in flight let the late response re-commit the abandoned query and results into the closed palette, which showed up as a ghost query on reopen. Closing now invalidates any pending request.
- FileInput: validation messages, default placeholder, drag hint, and file-selected announcements now go through the i18n translator instead of hardcoded English. DropdownMenuRadioGroup: consumer
xstyleprop is composed into styles instead of being dropped (#4589). - The popup theme targets added in #4991 sat on the wrong element.
astryx-complex-selector-popupandastryx-multi-selector-popupwere rendered on each component's own content box — the one with the padding and the scroll — while the element that paints the popup's background, radius and elevation is the surfaceusePopovercreates one level above it. A theme reaching for those classes to restyle a popup got a rule that could not paint it. Both now land on the surface, so they do what they were documented to do.Selectorgains the matchingastryx-selector-popup, which its siblingMultiSelectorhad and it did not.New: every popup surface carries the sharedastryx-popover-surfaceclass, so a theme can style all of them at once, andusePopoveraccepts asurfaceTargetnaming the surface for a component that wants its own target there. A component cannot do this for itself — the surface belongs tousePopover, so any class it renders itself lands inside. - Selector's menu now clears the trigger by the standard
--spacing-1gap whenever it is not overlaying it — every explicitplacement, and search mode. It was the only anchored menu in the system sitting flush against its anchor; DropdownMenu, MultiSelector, ComplexSelector, Popover, and Tooltip all use this clearance. The default selected-item overlay is unchanged: it owns its block geometry and is meant to sit on the trigger (#5003). - Selector, MultiSelector: the dropdown panel's search field is now part of the panel instead of a bordered input dropped into it. The panel is already a bordered, elevated surface, so the nested
TextInputdrew a box inside a box; the row now renders a leading magnifier, a borderless input, and the shared clear (✕) button, with a full-bleed divider between it and the options — the same shape the command palette already uses. Focus is shown as an inset ring on the row, rounded to the panel's own corners. Section titles move from labeled dividers to plain secondary headings, matching DropdownMenu and CommandPaletteGroup, and MultiSelector no longer draws a rule under select-all. Behavior, keyboard handling, and accessible names are unchanged; MultiSelector's search row additionally stays put while the options scroll under it. New theme targets:astryx-selector-search,astryx-selector-section-heading,astryx-multi-selector-search,astryx-multi-selector-section-heading; anything that styled the dropdown search throughastryx-text-inputneeds to move to those. - TableRow: honor
classNameandstyleon the<tr>.TableRowPropsextendsBaseProps, but both were spread beforemergeProps()and then overwritten by the component's own StyleX classes, so a consumer's values silently had no effect. They are now merged throughmergeProps()alongside the row's StyleX styles, the same wayTableCellandTableHeaderCellalready handle them, in both the in-Tableand standalone rendering paths. The Astryx theme classes and striped/hover styling are unchanged (#4391).
Contributors
Thanks to everyone who contributed to this release:
0.4.0
Breaking Changes
- DropdownMenu's two item modes are peers again. Compound mode gains a
DropdownMenuDividercomponent (aliased asContextMenuDividerandBreadcrumbMenuDivider), which the data path also renders, so{type: 'divider'}and<DropdownMenuDivider />produce identical DOM, spacing, and theme target. Data mode gainsendContentanddescription, so anitemsrow can carry a shortcut hint or secondary text without dropping to compound mode. Itslabelwidens fromstringtoReactNode, matching compound mode: the narrowing existed only because rows were keyed by label, and they no longer are (#4953). The bare names now belong to those components, so the data-mode option types take theDatasuffix their siblingDropdownMenuItemDataalready carries:DropdownMenuDivider→DropdownMenuDividerData,ContextMenuDivider→ContextMenuDividerData,BreadcrumbMenuDivider→BreadcrumbMenuDividerData. TypeScript cannot re-export a value and a type under one name from a single barrel, so the rename is what makes the components exportable at all. Runastryx upgrade --applyto rewrite the type imports; a missed one fails at compile time rather than silently. - Remove the
dropdown-menu-radio-dottheme target. Menu radio rows draw the shared radio indicator now, so the dot is the indicator's dot: targetradio-indicator-dot(the legacyradio-dotname still matches it too). The row's circle keeps itsdropdown-menu-radiotarget, so only the dot moved. (#4890) Runtime themes are not validated — a theme keyed on the removed target keeps compiling and silently stops matching — soastryx upgradenow carriesrename-dropdown-menu-radio-dot-target, which rewrites the key and theastryx-dropdown-menu-radio-dotclass. The new target is app-wide rather than menu-only (there is no menu-only dot element left to address), so the codemod leaves a TODO at each site it rewrites. - useTableRowExpansion is now a detail-panel plugin: it expands a full-width panel below a row via renderExpanded(item), and useTableRowExpansionState is removed. For hierarchical/tree tables (child rows that reuse the parent columns), migrate to useTableTreeData + useTableTreeState. See the migration example on the useTableRowExpansion docs. (#4609)
Codemod:
npx astryx upgrade --applyrunsmigrate-table-rowexpansion-to-tree, which rewrites tree-modeuseTableRowExpansioncall sites ontouseTableTreeData+useTableTreeState.
New Features
- Avatar: the fallback surface (initials and default icon) is now a direct theme target via the stable
astryx-avatar-fallbackclass. Theme its background, text color, font weight, and per-size font size through theavatar-fallbackcomponent key (e.g.components: { 'avatar-fallback': { base: { backgroundColor: '...' }, 'size:sm': { fontSize: '...' } } }), replacing the internal--_avatar-fallback-*derived vars. (#4716) - CodeBlock: the built-in copy button is now a themeable ghost
IconButtonwith a default "Copy code" tooltip, reachable via the stableastryx-codeblock-copy-buttonclass (theme it through thecodeblock-copy-buttoncomponent key). Restyle or keep the copy control without turning it off and re-implementing it. The tooltip stays "Copy code" after copying — the copy→check icon flip is the confirmation. (#4867) [feat] NewuseClipboardhook (@astryxdesign/core/hooks): the shared copy-to-clipboard behavior — clipboard write, a transientisCopiedflag with its reset timer, and an optional polite screen-reader announcement. CodeBlock and Timestamp now build their copy buttons on it; reach for it directly for copy affordances that are not a plain icon button. - CodeBlock: add
codeblock-headerandcodeblock-titletheme targets on the header row and the title/language-label element. A theme can now restyle the header (e.g. padding) and the title (e.g. font size) directly, instead of reaching them through structural> div:first-child > div > spanselectors that reverse-engineer the header layout. Both reflect thesize/language(/container) visual props like the root. (#4943) - DateInput, DateRangeInput, and DateTimeInput now accept a
weekStartsOnprop that sets the first day of the week in the calendar popover (0 = Sunday … 6 = Saturday, or a three-letter day name like"mon"). It forwards to the underlying Calendar, whose default stays Sunday, so existing usage is unchanged. (#4745) - Selector, MultiSelector and Typeahead expose their empty ("No results found") state as a themeable target (#4756, #4862) —
astryx-selector-empty-state,astryx-multi-selector-empty-stateandastryx-typeahead-empty-state. Themes can restyle the empty state without the fragile structural selectors consumers previously had to reach for. (The Selector search field is a TextInput, so its placeholder is reachable today via.astryx-text-input::placeholder; a Selector-scoped placeholder seam would require a TextInput change and is left as a possible follow-up.) - EmptyState: add
empty-state-titleandempty-state-descriptiontheme targets on the title heading and the description. A theme can now restyle the title and description directly (e.g. font size, color, pervariant) instead of reaching them through structural> div:has(> :is(h1..h6))selectors that reverse-engineer which element is which. (#4942) - Every clearable input now renders its clear (✕) affordance through the shared
InputClearButton, so the glyph is themeable in one place via theastryx-input-clear-icontarget instead of a per-component target or a fragile descendant selector. The component-specificastryx-{date-input,date-range-input,selector,multi-selector}-clear-icontargets remain supported as deprecated aliases; new themes should useinput-clear-icon. The clear glyph is now a consistent secondary-color icon with a ghost-button hover affordance across the whole family. (#4876) - The input family (TextInput, NumberInput, DateInput, DateRangeInput, DateTimeInput, TimeInput, TextArea, Tokenizer) now reflects its disabled state on the root theming target as
data-disabled="disabled"plus a.disabledvariant (only when disabled), so a theme can gate its own hover/border treatment on the disabled state — mirroring the existingstatus/sizereflection — instead of relying on structural:has(input:disabled)CSS. This closes a documented theming gap for downstream consumers. (#4794) - useLayer takes an
offsetfor clearance from the anchor, derived from the resolved placement, and the layer wrappers stop hand-rolling it (#4803) - DropdownMenu rows take two new options (#4953).
DropdownMenuItemtakeshasCloseOnSelect, so a plain action can report its result on the item instead of closing the menu.DropdownMenuItemDataandDropdownMenuSectiontake an optionalid, the row's stable React key for a menu whose items reorder or filter (also reaching MoreMenu, ContextMenu and Breadcrumbs, which share the type). - DropdownMenuItem now accepts a
variantprop ('default' | 'destructive');'destructive'renders the label, description, and icon in the error color for dangerous actions like Delete. The data-drivenitemsAPI accepts the samevariantfield, and because ContextMenu shares the menu-item data shape, context-menu items get it too. Defaults to'default', so existing menus are unchanged. (#4753) - MultiSelector: dropdown option rows are themeable through a single (#4628)
multi-selector-optiontarget, carrying the row'ssizeand itsselect-all,selectedanddisabledstates — so a theme can express "selected option at large" or restyle just the Select All row. Row typography moved from the label span onto the row, so one override reaches both the fallback label andrenderOptioncontent; custom option content now inherits the row's font and disabled color. - NumberInput: render a text-backed spinbutton that supports formatted display values, explicit wheel and keyboard stepping, and opt-in trailing increment/decrement buttons. Existing wheel stepping remains enabled by default and can now be disabled with
isWheelEnabled={false}(#4896). - ComplexSelector and MultiSelector: add
astryx-complex-selector-popupandastryx-multi-selector-popuptheme targets on the popup surface, so a theme can style the popup — background, border, radius, elevation, padding — throughdefineThemeinstead of a structural selector or a fork. Both components already targeted their trigger but nothing in the popup, which is the part that has to match the rest of an app's menus. The target sits on the popup's content box rather than the layer element:useLayerzeroes the layer's borders, padding and background, so the content box is the surface that actually paints. Purely additive — default rendering is unchanged. (#4991) - TextInput, TextArea, NumberInput: add
isReadOnly. The value is shown at full opacity and still submits with the form, but cannot be edited — the "visible, locked, still sent" case thatisDisableddeliberately does not cover, since disabled controls are excluded from submission. Read-only fields are not dimmed and stay in the tab order, matching the nativereadonlysemantics they compile to;isDisabledtakes precedence when both are set, and the clear button is hidden while read-only. The state is reflected on the root theming target asdata-readonly="readonly", alongside the existingdata-disabled, so a theme can paint it without structural:has(input:read-only)CSS.isReadOnlyalready existed on CheckboxInput, CheckboxList, and PowerSearch; the remaining text-ish inputs (DateInput, DateRangeInput, DateTimeInput, TimeInput, Tokenizer) do not have it yet. (#4816) - Selector/MultiSelector: two additive theming seams (#4626, #4627). A
selector-checktheme target on the selected-row checkmark lets themes restyle or hide it (e.g. to compose their own selected indicator viarenderOption) instead of relying on a structural sibling selector, anddata-disablednow reflects on the trigger for theme-driven disabled styling. Rotation styles remain on the indicator-icon target. Default appearance is unchanged. - Table:
contextMenuActionsnow accept avariant: 'destructive'for dangerous row/column actions (e.g. Delete), rendered in the error color to match ContextMenu. (#4864) - TextArea: theme the text inset by writing
paddingInlineon thetextareacomponent key — it now drives the internal--_textarea-inline-paddingvar instead of landing on the wrapper. The wrapper stays flush (padding: 0), so the native resize grip keeps its true-corner position and the start icon, status, and character counter stay aligned to the text. Adds areplacesoption to derived var entries for the general "map a property onto a var without emitting it on the class element" case. (#4793) - Add themeable indicators — the componentized check, checkbox, and radio visuals.
defineTheme({indicators: {check: RadioIndicator}})replaces one by name, and every component drawing it follows. (#4712) Theme targets now follow the component-name convention:checkbox-indicator,radio-indicator,radio-indicator-dot. The old names (checkbox,radio,radio-dot) remain emitted on the same element so existing themes keep working. New themes should use the canonical names; deprecation does not set an automatic removal deadline.Migration: menu radios use those shared targets now.dropdown-menu-radio-dotis removed — targetradio-indicator-dot;astryx upgraderewrites it for you. - TreeList: two additive changes. (1) A fully flat tree — one with no expandable items at all — now renders its rows flush instead of reserving an empty chevron-alignment column that nothing lines up under; any tree that has at least one expandable item keeps the same per-level alignment as before, so only fully flat trees change shape. (2) Adds a themeable
--tree-list-row-gapfor the inter-row gap, defaulting to a subtle2px(var(--spacing-0-5)) separation — matching the inter-row gapListandDropdownMenualready ship — so this shifts the default spacing of every tree by that amount; set it on thetree-listtarget to widen or close it. The gap rides collapse-proofpadding-blockon the row wrapper (not the paintabletree-list-itemtarget), and the connector guides span it automatically without overhanging the last row. (#4540)
Fixes
- AlertDialog: correct the inline role and pin initial focus (#4887). The
isInlinepreview path no longer rendersrole="alertdialog". That role promises a modal interruption — focus trap, inert page, explicit dismissal — and the inline path is an always-present, non-modal preview with none of it. It now rendersrole="group", keeping the title and description associated througharia-labelledby/aria-describedby.The cancel button now carriesdata-autofocus, so the documented "initial focus goes to the cancel button" behavior is pinned instead of depending on cancel happening to be the first focusable node in the footer. Docs now name and link the WAI-ARIA APG Alert Dialog pattern the component implements, and gain an anatomy section. - AppShell: two a11y fixes to the shell chrome (#4944). The mobile top bar rendered for a sidenav-only layout is now a
bannerlandmark, matching the header region of a layout that has atopNav. Previously the page's landmark structure changed depending on which nav slots it filled: a screen-reader user on a small viewport got no banner region at all. When abannerslot is present the existing header keeps the role, so there is still exactly one.The skip link now draws the shared Astryx focus ring instead of the browser default outline, so it follows--color-accentand matches every other focusable surface in a custom theme. - Avatar: fallback initials no longer break for names containing emoji or other multi-codepoint characters. (#4750)
- ChatLayoutScrollButton: the default (label-less) state now renders as icon-only, with the translated "Scroll to bottom" string as the accessible name only. It was previously missing
isIconOnlyon its innerButton, so Button's default (visible-text) contract rendered the translation as clipped visible text inside the circular button instead. (#4854) - Chat: the dictation and scroll buttons now carry their
chat-dictation-buttonandchat-layout-scroll-buttontheme targets, and ChatSendButton no longer clobbers a consumer'sclassName(#4634). - ChatToolCalls: hover backgrounds on grouped call rows (2+ calls) now keep their full
--radius-elementrounding instead of getting clipped flat on the inline edges.groupContentInner— theoverflow: hiddenclip boundary the expand/collapse height animation needs — was missing the padding/negative-margin pair that absorbs the row-level hover-background overhang, so the overhang extended past the clip boundary and got cut off. Matches the ungrouped single-call row, which has no such wrapper to clip it. (#4858) ComplexSelector's popup now keeps its 4px clearance from the trigger whenplacement="above", matchingplacement="below"andPopover. The popup's margin was set onmarginBlockStartonly, which is correct for a popup opening downward but leaves zero clearance on the edge that matters when it opens upward. (#4861)- ComplexSelector: the trigger's focus ring is now keyboard-only. It was drawn from
:focus-within, which also matches a mouse click — open the popover with the mouse, dismiss it with the mouse, and the restored focus left a pointer user staring at a keyboard affordance. It now uses the shared:has(:focus-visible)ring, which also brings the outline to the documented 3px offset. (#4935) - DateInput and DateTimeInput no longer steal focus when the open calendar is dismissed by clicking another control. Clicking the field to open the calendar, then clicking the time input (DateTimeInput) or any other element, kept yanking focus back to the date input because the popover's close handler always refocused it. It now restores focus only when the dismiss left focus detached (Escape, or a click on empty space), so a click that lands focus elsewhere is respected. (#4974)
- TextInput, TextArea, NumberInput: a disabled field is no longer submitted with the form when
disabledMessageis set. Showing the reason tooltip requires swapping the nativedisabledattribute foraria-disabled+readOnly, so the message stays discoverable by pointer and keyboard — but read-only fields still serialize intoFormData, and these three kept theirname, so a locked field posted its value. They now withhold thenamewhile disabled, matching CheckboxInput and Switch (which forward the name only when enabled) and the hidden-input carriers in Selector, MultiSelector, Slider, and Tokenizer (which mirrordisabled). Adds form-participation coverage to all three so the guarantee is pinned. (#4811) - DropdownMenu/MoreMenu: opening with a pointer no longer highlights the first item as if it were selected (#4477). Initial focus now follows the input modality: keyboard opens (Enter/Space/ArrowDown on the trigger) still focus the first enabled item per the APG menu-button pattern, while pointer opens focus the menu container itself so the first ArrowDown moves to item 1. Synthesized clicks (detail 0, e.g. screen reader activation) and programmatic controlled opens keep the first-item focus behavior. Covers data-driven items mode, compound mode, and MoreMenu, which share the open path.
- EmptyState: the rest spread sits before the contract
role, so a consumer can no longer clobber the landmark role the component guarantees (#4826). - Indicator: a falsy
childrenno longer deletes the state mark. The busy idiom a host actually writes —children={isBusy && <Spinner/>}— passesfalsewhen it is not busy, andfalseis neithernullnor caught by??, so all three indicators took the children path, rendered nothing in it, and dropped the checkmark, the checkbox tick and the radio dot on every selected row. They now useisRenderable, so only children that actually render replace the mark.0still counts as content, since it renders the character "0". (#4913) CheckIndicator's children slot also reserves the glyph's box and carries its color, so swapping a Spinner in no longer shifts the row or loses the disabled shade.Fixes #4893. - Consolidate general interactive focus outlines onto one definition — 2px
--color-accentat 3px offset, matching Design Conventions. (#4654) Most general controls had drifted to a 2px offset; Button, Calendar, Dialog and Pagination were the ones still on spec. Their value wins, so a focus ring on the drifted components (Link, TabList, Token, TreeList, SegmentedControl, TopNav items) now sits 1px further from its control.Destructive buttons keep their error-colored ring, and--button-focus-offsetis unchanged. Form and input focus treatments are out of scope. <Heading type="display-N">now sizes correctly under every theme, matchingText's behavior.generateTypeScaleComponents()only emittedlevel:N-keyed CSS rules forheading, with notype:display-Ncounterpart — so as soon as a theme suppliedtypography.scale, the generated theme-layer CSS'slevel:Nrule was the only one present and silently won regardless oftype, discarding the prop. A theme with no typography config was unaffected, which made the bug look intermittent. (#4859)- theme:
color.contrast: 'high'now strengthens border tokens too — the emphasized border tone is pulled toward mid-scale (stronger against both light and dark surfaces) and the subtle hairline's alpha is doubled, so structural boundaries stay perceivable in high-contrast themes instead of only text/icons changing. (#4529) - Icons render through
<Icon>and carry their component's theme target (#4838). Styling-only wrappers around rotating icons are gone, and each rotation now sits on the icon element that already carries the component's theme target — so a theme reaches the glyph and its open/closed transform through one selector. No new theme targets: Selector, MultiSelector and ComplexSelector consolidate onto their existing*-indicator-icontargets, and the Table plugins and TreeList simply shed redundant wrapper elements.Where an RTL mirror sat on a separate parent element, it is folded into each state's transform (scaleX(-1) rotate(...)) so one element carries both. In the Table plugins that mirror was inert —transformdoes not apply to a non-replaced inline box — so RTL disclosure chevrons now mirror correctly where they silently did not before.Registry glyphs in SideNav, TopNav, Collapsible, TreeList and Breadcrumbs now render through<Icon>instead ofuseIcon()inside a hand-written<span>. Those spans were a weaker reimplementation of<Icon>, which already resolves the same glyph and renders a span carrying mergedclassName/style/xstyleplus theastryx-icontheme target. The converted sites gain that target, and the node count is unchanged.useIcon()keeps its place for the cases that resolve a glyph without rendering it: MoreMenu and ChatSendButton pass the node as a default for a consumer-overridable prop, which<Icon>cannot express.Also adds the@astryx/no-wrapper-transformlint rule (warn) for<div>/<span>wrappers that exist to transform the icon inside them. - Indicator: a caller can no longer un-hide or focus a decorative indicator (#4921, #4947).
IndicatorPropsnow omitsaria-hidden,role,aria-label,aria-labelledbyandtabIndex— passingroleortabIndexis a compile error — and each indicator emits its ownaria-hiddenafter{...rest}, so a forwarded one cannot win. Un-hiding an indicator had it announced next to the control that owns the accessible name, saying the same thing twice; a tab stop on one is a focusable node inside a hidden subtree, an axearia-hidden-focusviolation.Nothing is stripped: every other prop, including a forwardedaria-label, still reaches the DOM, where it is inert inside anaria-hiddensubtree. Note that TypeScript exempts hyphenated JSX attributes from excess-property checking, so the type alone cannot rejectaria-*; the attribute order is what enforces it.tabIndexis a plain identifier, so its omission stands on its own.Also corrects two doc claims: a replacement must renderchildrenwhen they will actually draw something (isRenderable, notchildren ?? mark), and "passingroleis a compile error" holds for a literal attribute — a spread bypasses excess-property checking.Fixes #4918. - A DropdownMenu item closes the menu on activation even when it carries no
onClick, and a data-mode row that changes its own label keeps its identity instead of remounting and dropping focus (#4953) - Fix
mergeRefscleanup so object refs are cleared and callback refs without cleanup functions still receivenullwhen a merged ref returns cleanup (#4901). - MoreMenu forwards
placementandalignmentto its DropdownMenu. Both were part of the underlying menu's API but were dropped on the floor by the wrapper, so an overflow menu — the one component whose job is a trailing-edge affordance — could not ask to be end-aligned; it only looked right when the layer happened to collision-flip. Defaults are unchanged: MoreMenu passes the props straight through, so DropdownMenu's'below'/'start'still apply. (#4952) - Pagination: vertically center the prev/next caret icons. The RTL mirror wrapped each chevron in a
display: contentsspan, which dropped the icon out of the button's flex-centering context so the glyph sat a few pixels high. The mirror transform now rides on theIcondirectly viaxstyle, so the icon stays a centered flex child and still flips under RTL — no wrapper element. (#4723) - ProgressBar: a theme can size the target mark again without
!important. The mark'swidth/heightwere plain StyleX declarations, so aprogressbar-markoverride only landed where@layer astryx-themeoutranks the component atomics — in a source-build app that compiles StyleX withoutuseCSSLayersthe atomics are unlayered and beat every theme rule, leaving no way to resize the tick but an unlayered!importantrule. The dimensions now travel as derived vars with no competing declaration, so the samedefineThemeentry lands in either build. Theme authoring is unchanged; a mark's color is still a plain declaration and still depends on the layer order. (#4970) - ProgressBar marks take their color from what they sit on: the fill variant's on-color inside the filled area, the emphasized divider color out on the track (#4741)
- CommandPalette, ComplexSelector and ContextMenu: a consumer's
onClick/onMouseEnteris composed with the component's own handler instead of being overwritten by it, and{...props}no longer lands after the props the component must control (#4725). - CheckboxInput, Switch: a
requiredcontrol that is disabled with adisabledMessageno longer blocks the whole form from submitting. Showing the reason tooltip swaps the nativedisabledattribute foraria-disabled, which leaves the control subject to constraint validation — so an unchecked required checkbox (or an off required switch) the user has been told they cannot touch made the form permanently unsubmittable, with the browser reporting a validation error against a control they had no way to satisfy. Both now detach from the form viaform=""while focusable-disabled, matching a natively disabled control and the treatment RadioListItem already applied. Enabled controls are unaffected — a required, unchecked checkbox still blocks submission as it should. (#4815) useScrollLock: coordinate concurrent locks with a shared counter, so overlays closing out of order no longer unlock the body early or leave it stuck locked. (#4788)- Selector: keep the selected option text aligned with the closed trigger across every menu position by measuring untransformed layout geometry during the popover entry animation. (#4802)
- Drop the shared trigger-icon wrapper in Selector, MultiSelector and ComplexSelector — each trigger icon is now the element that carries its own box, colour and theme target. (#4846)
The wrapper set a 16px box and
--color-icon-secondaryon a span with no theme target of its own, shared by two different affordances: the status glyph and the disclosure chevron.<Icon>already provides both (size="sm"is the same 16px box,color="secondary"the same token), so the wrapper only stood between a theme and the icons — and made the two affordances share a node they never should have shared. - Selector selects by typing, matching a native select (#3764) Typing a printable character on a focused, closed Selector now selects the matching option — tab to a state picker, press "C", get "CA" — instead of doing nothing until the menu is opened. Repeated presses cycle through options sharing a first letter, and spaces count as match characters ("new y" reaches "New York"). With the menu open, typing moves the highlight and Enter commits, as before. With
hasSearch, typing on the closed trigger opens the popup and seeds the search input.Matching reuses the shareduseTypeaheadhook, so Selector behaves like the other collections (menus, listboxes). Because a match committed from the closed trigger changes the value without opening the popup or moving focus, the new selection is announced throughuseAnnounce.useComboboxno longer implements typeahead itself; callers that want it composeuseTypeaheadand run it ahead of the combobox key handler.Adopting the shared hook exposed two matching bugs in it, fixed here — soDropdownMenu,ContextMenuandNavHeadingMenuimprove too. A single-character search now starts after the current item, as native<select>and the APG pattern do, instead of only advancing on a repeated press: pressing a letter that the focused item already begins with used to do nothing at all. And with nothing focused the search now genuinely starts at the top, rather than wrapping onto the last item first. Characters composed with Option/Alt (Option+a→ "å") count as typeahead again, so accented labels stay reachable. - SideNav:
footercontent now centers when the nav is collapsed, matching howchildrenalready centers.stickyBottomCollapsed(the collapsed-rail wrapper forfooter) was missingalignItems: 'center', which its siblingscrollableCollapsed(the collapsed-rail wrapper forchildren) already had — so full-width footer content (e.g. an icon-only button) stretched to the collapsed rail's width instead of centering. (#4852) - SideNav: the collapsed icon-only
SideNavHeadingtrigger with amenuno longer omits its popover's anchor. The trigger's ref callback wasn't forwarding tousePopover'striggerRef, so the menu popover had no CSS anchor to position against and fell back to the viewport corner instead of opening next to the trigger. (#4850) - Stepper: localize the "Optional" step affordance via the new
@astryx.step.optionalmessage key so it translates like the rest of the component. No visual change in English. (#4872) useStreamingTextno longer renders a broken glyph (a lone surrogate, or a partial ZWJ emoji sequence) for one frame when its fixed-code-unit reveal cadence happens to land inside a surrogate pair or multi-codepoint emoji. The rendered slice now snaps back to the nearest grapheme cluster boundary viaIntl.Segmenter(with a surrogate-pair-safe fallback where it's unavailable); the reveal cadence itself is unchanged. Also corrected the hook's doc comment, which inaccurately described the cadence as advancing on word/syntax boundaries — it always advanced by fixed code units. (#4866)- TextArea: no longer reserves trailing space for the on-field status icon when
statusVariant="detached". The detached variant surfaces its status glyph in the message box below the field and renders no on-field icon, so the reserved inset pushed the text in for an icon that never appeared. Trailing space is now reserved only when the spinner or on-field status icon actually renders. (#4940) - TextArea: remove the duplicate wrapper padding so the text and native resize grip sit flush to the edge. The wrapper's
padding: 0shorthand was being overridden by the shared input-wrapper longhands, leaving the inset applied twice; it now zeroes with matching longhands. (#4813) - TopNavMegaMenu: fix the hover-then-click flicker where clicking a nav item after hovering dismissed the mega menu. The trigger is registered as the native invoker for its
popover="auto"panel and uses a Vercel-style hover→click guard, so the click that naturally follows a hover confirms and pins the panel open instead of toggling it shut. Native outside-click, Escape dismissal, and sibling-popover exclusivity are preserved. Click/keyboard opens are pinned (persist past mouse-leave); hover opens stay transient. Keyboard activation (Enter/Space) always opens and moves focus into the panel, while touch/click without a preceding hover toggles cleanly (#3121) - TreeList typeahead now cycles through same-letter matches instead of stalling, and searches from the top when no treeitem is focused. (#4844)
BaseTypeahead(and everything built on it —Typeahead,Tokenizer,PowerSearch's content-search field) no longer misinterprets the Enter keydown that commits an IME composition (Korean/Japanese/Chinese input) as "accept the highlighted suggestion". Previously that keydown both selected the highlighted result and cleared the input, so the still-composing syllable landed in the freshly-cleared field and became its own spurious second selection on the next Enter. Also guarded the Enter-to-save handler inPowerSearchEditPopover, which had the same gap when typing a CJK filter value. (#4860)- useLongPress: cancel the pending long-press when a second finger joins mid-press. Previously
onTouchStartandonTouchMoveonly checkedtouches.lengthon their own event, so a second finger arriving after a single-finger press had already started the timer (e.g. a pinch-to-zoom gesture) fell through thetouches.length !== 1guard without ever clearing it —onLongPresscould still fire with the stale first-finger point mid-gesture. No API change. (#4735) - useContainerReveal scopes the reveal by inheritance instead of a marker pool: no dev warnings on lists longer than six rows, and isEnabled now takes effect after mount (#4955)
Documentation
- AppShell: the two worked examples of the
mobileNavescape hatch passedtitletoMobileNav, which does not accept it:MobileNavPropsomits the nativetitleattribute and the drawer heading prop isheader. Copying either example produced a type error and a drawer with no heading. Both now sayheader. The doc also gains an anatomy list and accessibility guidance covering the landmark structure AppShell owns. (#4944) - AspectRatio: document the sizing contract and add the missing anatomy. The box takes its width from its container and derives its height from the ratio, so constraining only the height clamps it off ratio (pass
width: 'auto'alongside) and a shrink-to-fit parent collapses it to zero width. Both are now in the component JSDoc and inbestPractices, along with the single-child expectation: withfitset, every direct child is stretched to fill the box. The image-gallery example block now usesvar(--radius-element)instead of a raw8. (#4984) - StatusDot: document the builder's accessibility responsibilities in the usage dos and don'ts. A color-only dot is not fully accessible in isolation, so the guidance now says to use it as a binary present/absent signal, pair it with a label, carry the status as a shape via an icon, and — if neither fits — convey the status through an accessible alternative. (#4737)
Other Changes
DropdownMenuItemData— the shape of one entry in aDropdownMenu/ContextMenu/MoreMenuitemsarray — is now sourced fromDropdownMenuItemProps(Pick) instead of restatingicon,onClick,isDisabled, andvariantby hand, andrenderDropdownItemsforwards the whole item toDropdownMenuItemrather than copying it field by field. The data and compound APIs describe the same item, so they can no longer drift — exposing another item prop to the data API is now one key in thePick. The type is structurally identical to before (labelis still narrowed tostring, since the renderer keys rows by it) and rendering is unchanged. (#4809)- Remove 15
<div>/<span>wrappers that existed only to style the single Astryx component inside them (Carousel, Lightbox, MobileNav, Pagination, Switch, TopNav, TopNavMegaMenu, Table row-expansion menu icon); the styles now sit on that component's own root viaxstyle— or, for Pagination's page-size Selector, its documentedwidthprop. No API change, but the rendered DOM has one fewer node at each site, so anything selecting on that structure is affected:patch, not[breaking], because the removed nodes were internal implementation with no documented contract, no theme target, and no stable class. Two rendering defects the wrappers were causing are fixed as a side effect: the Lightbox prev/next chevrons and the Pagination first/last chevrons were 2.5-3px off their button's vertical centre. (#4775)
Contributors
Thanks to everyone who contributed to this release:
0.3.0
Breaking Changes
- DropdownMenuRadioGroup now takes a required
labelprop that names the group for assistive tech (applied as aria-label), replacing the previous optionalaria-label/aria-labelledbypassthrough -- renamearia-label="..."tolabel="..."(passaria-labelledbyvia base props instead when a visible label already exists). This also covers the ContextMenu/Breadcrumb re-exports (ContextMenuRadioGroup, BreadcrumbMenuRadioGroup). Also fixes ContextMenu to close the menu on Tab per the APG menu pattern. - Core — the authoring surfaces move to
@astryxdesign/cli/authoring.@astryxdesign/core/authoring(createIntegration/createPageTemplate/createBlockTemplate/createComponentDoc/createFunctionDoc/createDocand their types) and@astryxdesign/core/config(createConfig+AstryxConfig) are removed. The doc-type vocabulary re-exported from@astryxdesign/core(ComponentDoc,ReferenceDoc,ComponentPropDoc,ComponentTranslationDoc, …) is now a deprecated alias that re-exports from@astryxdesign/cli/authoringand will be removed next release. Author docs/configs/integrations as plain objects and import types from@astryxdesign/cli/authoring;astryx upgraderepoints existing imports automatically. - Remove long-deprecated compatibility APIs from core and CLI. Run
astryx upgradefirst to migrate the supported replacements for authoring imports, Dialog logical positions, Switch label spacing, and Table root props.
New Features
- Carousel: add
hasLoopfor wrap-around scrolling (next at the end returns to the start, prev at the start jumps to the end; navigation buttons stay active at both edges) and ahandleRefimperative handle (CarouselHandle) exposingscrollNext,scrollPrev,scrollTo(index),canScrollNext(), andcanScrollPrev()for programmatic control. - Center: add
padding,paddingInline,paddingBlock(spacing-scale inner padding) props. These match the existingpaddingprops onStack,Card,LayoutContent, andLayoutPanel, so centered page content no longer needs inlinestyle={{}}orxstylewrappers for basic padding. - ComplexSelector: add a rich custom selector shell with accessible button/popover behavior, async change actions, and optional grid keyboard navigation.
defineTheme: makecolor.accentoptional (#2279) A theme can now restyle the neutral ramp (neutralStyle,contrast) without adopting an accent. An accent-less config seeds the neutral palettes from the default accent's hue but leaves--color-accent,--color-accent-mutedand--color-on-accentungenerated, so they fall through to the token defaults — the same fall-throughexpandColorScalealready applies to status, categorical and on-dark tokens. Configs that pass an accent are unchanged, token for token.- Dialog: add logical
start/endoffsets to thepositionprop and deprecate the physicalleft/right.start/endmap toinset-inline-start/inset-inline-end, so a positioned dialog mirrors correctly under RTL (start hugs the inline-start edge — left in LTR, right in RTL). The physicalleft/rightstill work unchanged and never mirror (non-breaking); they are now@deprecatedand will be removed in a future major. When both a logical offset and its physical counterpart are set, the logical one wins. A codemod (migrate-dialog-position-to-logical, v0.2.1) rewritesposition={{left, right}}to{{start, end}}. - DropdownMenuCheckboxItem now composes CheckboxInput so its checkmark matches CheckboxListItem and the standard checkbox theming slots apply. The checkbox stays decorative — the menu row keeps role="menuitemcheckbox" and owns the checked state.
- DropdownMenu now accepts an
alignmentprop for matching Popover/HoverCard positioning parity. - DropdownMenu: expose themeable slots for the section heading, menu divider, submenu indicator icon, and checked radio dot (
astryx-dropdown-menu-section-heading,astryx-dropdown-menu-divider,astryx-dropdown-menu-indicator-icon,astryx-dropdown-menu-radio-dot) so themes can style them directly instead of relying on structural selectors. ContextMenu inherits these via shared item rendering. - Add a ghost trigger variant for Selector and MultiSelector for toolbar-style controls, with ghost status messages detached by default.
- Field/FieldStatus: add
astryx-input-status-iconandastryx-field-status-icontheme targets on the field status glyph, so consumers can recolor, resize, and restyle it — per status — viadefineThemeinstead of a fragile descendant selector or raw CSS.astryx-input-status-iconsits on the on-field icon shared by all bordered inputs across theattachedandtooltipstatus variants and reflectsdata-size/data-status;astryx-field-status-iconsits on the detached message box's leading icon and reflectsdata-type. Purely additive — default rendering is unchanged. - Markdown: expose per-block spacing to theming. Every block type now renders a stable theme target —
astryx-markdown-heading,-paragraph,-list,-codeblock,-blockquote,-table,-hr, and-image— so a theme can tune the gap around any block (marginBlockStart/marginBlockEnd) viadefineThemeinstead of overriding global spacing tokens or reaching for fragile[role="paragraph"]-style descendant selectors. Each target reflectsdata-density(so spacing can differ perdefault/compact), and the heading target additionally reflectsdata-level(1–6) for per-level spacing. Targets apply only to the default render path — a customcomponents.heading/code/blockquote/hr/imagecontinues to own its own styling. Purely additive — default rendering is unchanged. - Pagination: add an
inputvariant — an editable page-number box (aNumberInput, so it clamps to[1, totalPages]with integer-only semantics) flanked by first/last («/») buttons, renderingPage [ n ] / N. Navigation is page-based via the existingonChange. The leading noun is set with an openpageLabelprop (defaults to the localized "Page"; passpageLabel="Row"to relabel it). Also adds astepprop controlling how many pages the prev/next buttons advance per click (default 1, clamped to range); when greater than 1 the buttons' accessible names reflect the stride. AddschevronsLeft/chevronsRighticons. The first/last/prev/next carets now also carry a hover tooltip (the same localized, step-aware label already used as their accessible name), so sighted users get the affordance the icon-only buttons previously exposed only to assistive tech. (#4248) - ProgressBar: add an opt-in
marksprop that draws fixed target lines on the track at values in the same 0..max scale asvalue(e.g. a goal or threshold). Marks stay visible whether progress is below or past them; each mark requires alabel(its accessible name, revealed via a tooltip on hover/focus), and marks are ignored in indeterminate mode. The mark tick is directly themeable via theprogressbar-marktarget — a theme setsbackgroundColor,width, andheighton it (a larger height makes a "flag" tick that overhangs the bar symmetrically above and below). The mark tooltip is loaded lazily, so a ProgressBar with no marks bundles no tooltip code. Namedmarks(with aProgressBarMarktype) to match themarksprop on Slider. - Icon registry:
registerIcons()now accepts arbitrary extension keys (not just built-inIconNames), so libraries can augment the icon map with their own keys. AddgetExtendedIcon(name, fallback)— resolves an extension key, preferring a theme-registered icon over a caller-supplied default. This lets library-shipped icons (e.g. the labRichTextEditorToolbar'srichtext:*glyphs) be overridden per-theme without forking. - SelectableCard: pressing Enter now toggles selection, in addition to Space, when the card is focused
- Selector & MultiSelector: the dropdown search field is now a
TextInput, so it gains that component's built-in affordances — a leading search magnifier (startIcon) rendered inside the field and a trailing clear (✕) button (hasClear) that appears once a query is typed and resets + refocuses on click. The field now shares TextInput's border, focus ring, and sizing, so it matches every other Astryx input instead of being a bespoke control. No new props or theme targets. Non-breaking, but note the magnifier is a new default glyph, so existinghasSearchdropdowns gain a leading icon. - Add SSR-friendly theme and icon registry resolution so semantic icons can resolve from a registered theme name without relying on React context.
- Table:
astryx-table-cellandastryx-table-header-cellnow reflect the active row density asdata-density(compact/balanced/spacious), so a theme can override cell padding per density viadefineTheme. Previously the density split lived entirely in internal StyleX classes with nodensity:*hook on the cell target, so acomponents: { 'table-cell': {...} }entry could only set one padding for all densities — it could not, for example, hold the inline inset constant while varying only the block padding per density. The targets now carry the hook ({className: 'astryx-table-cell', visualProps: ['density']}), enablingcomponents: { 'table-cell': { 'density:balanced': { paddingBlock: '12px' } } }. Purely additive — default padding is unchanged. - Table:
useTableTreeDatagains an opt-inhasRowClickExpansionprop. When set, clicking anywhere on an expandable row toggles it, in addition to the chevron. Clicks on interactive cell content or a text selection are ignored, leaf rows stay inert, and it is a no-op on flat data. (#4142) - Text & Heading:
coloris now theme-extensible.TextColoris derived from a newTextColorMapinterface (same technique asButtonVariantMapetc.), so a theme can add custom text colors —astryx theme buildgenerates the module augmentation when it sees newcolor:*values on Text/Heading overrides, and consumers can augmentTextColorMapmanually for type safety. A custom color renders as a stable class (astryx-text.<color>/astryx-heading.<color>) that theme CSS paints, falling back to theprimaryStyleX baseline so it never renders unstyled. Built-in colors are unchanged. - Timestamp: the hover surface is now a single copyable hover card for every timestamp that shows one. Relative timestamps and
tooltipEntries-configured timestamps share one card, replacing the old read-only tooltip; the default single row carries the full absolute time and is itself copyable. EachtooltipEntriesrow opts into a copy button viaisCopyable(defaultfalse) — so a card can mix human-readable, read-only rows with a copyable machine value (e.g. show local and UTC for reading, but only let readers grab thesystem_date_timevalue). Copyable rows render their copy button in a dedicated trailing action column so the buttons align down one column regardless of value width; that column is only reserved when some row is copyable, so a fully read-only card carries no trailing gutter. The card's labels use thesupportingtext role (the secondary, quieter register that is Timestamp's own default) and values thebodyrole. - Timestamp: add a
relative_shortformat — the compact sibling ofrelative. It uses the same tier boundaries and present/clock-skew handling but renders abbreviated units for space-constrained surfaces (chat metadata, dense tables, chips):now,30s ago,5m ago,2h ago,1d ago,3mo ago,2y ago, andin 5mfor future times. Months render asmo(notm) so they never collide with minutes; the short form is always numeric (noyesterdayidiom). Likerelative, it keeps the full absolute date as its accessible name and gets the hover tooltip and live updates. Additive — existing formats are unchanged. - Timestamp: rename the recently added
system_unixformat tounix_seconds. The value is absolute Unix time in whole seconds since the epoch — not a wall-clocksystem_*rendering — so it does not belong to thesystem_*family; the explicit unit name also leaves room for a futureunix_millis. Behavior is unchanged (zone-independent epoch seconds). This renames a format value that only just shipped, before it has consumers. - Timestamp: two additions. (1) A new
system_unixformat renders the value as Unix time in whole seconds since the epoch (e.g.1771520400) — an absolute, zone-independent machine value, useful as a copyabletooltipEntriesrow alongside human-readable zones. It joins thesystem_*machine-readable family and, being absolute, ignores any tooltip time zone. (2) The copyable hover card's copy button now shows a visibleCopytooltip on hover/focus (flipping toCopiedafter a copy, in step with the icon), so the affordance is discoverable for sighted users; the fullCopy <value>string remains the button's aria-label for assistive tech. Both additive — no change to existing formats or default rendering. - Add
useContainerReveal— a headless hook for revealing (or concealing) content when its container is hovered or focused. CSS-driven (no hover state in JS, no re-render on hover) and accessible by construction: revealed content stays in the accessibility tree and tab order, reveals on keyboard focus-within, and stays visible on touch. Callers spreadgetContainerProps()on the container andgetContentRevealProps()on each child; no StyleX authoring required.Thumbnail'sshowRemoveOn="hover"now uses this hook internally (no API change).
Fixes
- AppShell: make the skip-link target focusable (tabIndex={-1}), localize the skip-link label via the i18n catalog, and expose the header region as a banner landmark
- CheckboxList: each option is a single tab stop — the checkbox is the option's only focusable control (WCAG 4.1.2). The row is now an enlarged click/tap target that delegates surface clicks to the checkbox via a new
interactiveRefprop on Item/ListItem (the useClickableContainer pattern), replacing the internal invisible row button.interactiveRefis mutually exclusive withonClick/href. - Resizable, TabMenu: two collection ARIA minors (WCAG 4.1.2) — Resizable's collapsed handle clamps
aria-valuenowtoaria-valueminand announces a localized "Collapsed" viaaria-valuetext, and TabMenu overflow options aremenuitemradiowitharia-checked(APG menu-button single-select) instead ofmenuitem+aria-current. - core: preserve state indication for painted controls (Switch, CheckboxInput, RadioList, SegmentedControl, ToggleButton, Skeleton) under forced colors / Windows High Contrast (WCAG 1.4.11)
- i18n: localize remaining hardcoded assistive-tech strings (AvatarGroup overflow label, CodeBlock copy announcement, Button loading announcement, MetadataList show more/less, Table row-expansion context-menu actions, keyboard hint)
- i18n: add
@astryx.step.*catalog keys (goToStep,goToStepWithStatus,status.completed/status.warning/status.error) backing the lab Stepper's localized status text and clickable-step accessible names. - Lightbox: add keyboard zoom (Enter/Space on the image,
+/-) and arrow-key panning while zoomed, with polite announcements (WCAG 2.1.1) - Selector: convey MultiSelector select-all partial state in its accessible name, mark Selector/MultiSelector empty-state messages presentational inside the listbox, and remove Typeahead's collapsed input from the Tab order while a token is shown
- Toast: announce toasts via the persistent singleton live regions instead of per-toast regions that mount together with their content
- theme: guarantee WCAG contrast for generated color token pairs — text-on-surface pairs are asserted at >= 4.5:1 and non-text UI pairs at >= 3:1 (WCAG 1.4.3/1.4.11), with
--color-border-emphasizedtone-bumped in generation until it clears 3:1 against the generated surface - Token: render the remove button as a sibling of the link instead of nesting it inside the anchor when both
hrefandonRemoveare provided. The token surface now delegates to the link viauseClickableContainer, so clicking anywhere on the token (including with middle-click or cmd/ctrl+click to open in a new tab) activates the link, while the remove button keeps handling its own clicks. - theme build: generated custom Button variants now type-check through the public
@astryxdesign/core/Buttonsubpath. - Use spacing tokens for ChatComposerDrawer bar handle dimensions.
- ChatLayout no longer shows a phantom scrollbar in self-scroll mode when messages don't fill the viewport. The root is now a flex column: the message area flexes to fill the space the composer dock doesn't need, so the sticky dock's natural height is part of the 100% instead of overflowing past it by exactly the dock height. Long conversations still scroll and the dock still sticks; external-scrollRef mode (fixed dock) is unchanged.
- Deprecate the
isRtloption onuseListFocusanduseGridFocus. Right-to-left arrow-key direction is now auto-detected from the container, so the explicit override is redundant and will be removed in an upcoming major — omit it and RTL is handled automatically. - DropdownMenu now reports uncontrolled native open/close transitions and restores focus to the trigger after native popover dismissals.
- DropdownMenu: a submenu trigger no longer shows a second highlight when hovered while another item still holds focus — hover now moves the single focus-driven highlight onto the trigger, matching regular menu items
- CheckboxInput & Switch: clicking the field description now forwards to the control (the whole label area is one hit target), while clicks on interactive content inside a description (links, buttons) are left alone. No new prop or accessibility-tree change — the description stays a sibling of the label, so it isn't folded into the control's accessible name.
- FieldLabel: localize the "Required"/"Optional" indicator through the i18n runtime instead of hardcoding English, so consumers can translate it via
InternationalizationProvider(#4508). - useContainerReveal: eliminate the exit flicker on the default (non-layout-preserved) reveal. Hidden content flips
position: static -> absolutediscretely, which previously snapped it out of layout flow at full opacity before the fade could run. The flip now participates in the transition withtransition-behavior: allow-discreteand a state-conditional delay, so it stays in flow until the opacity fade finishes on exit while remaining immediate on entry. Content stays in the accessibility tree and tab order throughout. - Selector and MultiSelector: with
statusVariant="detached", the on-field status icon is no longer shown inside the trigger. The detached message box already renders its own leading status icon, so the field keeps its chevron indicator instead of duplicating the glyph — matching the bordered inputs. - Dynamic
import()specifiers now get their mandatory.jsextension in the published ESM dist —babel-plugin-add-extensionsonly rewrote static import/export declarations, so the lazy Tooltip specifier inText,HeadingandTimestampshipped extensionless and strict-ESM consumers (Rspack, webpackfullySpecified, Node ESM) failed to resolve any component importing them. A new post-build gate (scripts/check-fully-specified.mjs) now fails any build whose dist ships an extensionless relative specifier. (#4569) - TopNavMegaMenu: keep the desktop mega-menu panel within the viewport — cap its height to the space below the nav (scrolling internally) and clamp its width — so a tall or wide menu no longer overflows the screen edge and clips content
- Lightbox: make backdrop click dismissal actually reachable The dismiss check only matched clicks on the dialog element itself, but the layout container fills the entire transparent dialog, so clicks on the dark area around the media always landed on the container and never closed the lightbox. Clicks on the container now dismiss too, and a pan drag that ends over the backdrop is ignored.
- Markdown streaming perf tests declare explicit timeouts matching their own budgets, instead of relying on vitest's 5s default
- MetadataList: a numeric
columnsvalue is honored with stacked labels.columns={3}previously fell back to the responsiverepeat(auto-fill, minmax(280px, 1fr))grid whenever labels were stacked (the default for multi-column lists), so the documented fixed column count only worked withlabel={{position: 'start'}}. The grid template now covers both label positions —repeat(n, 1fr)for stacked labels,repeat(n, auto 1fr)for side labels — and resolves through a StyleX dynamic style instead of an inlinestyleobject. - MultiSelector: remove the trigger button's own focus outline so it no
longer doubles the field wrapper's focus ring. The wrapper renders a single
:focus-withinring, matchingSelectorand the other bordered inputs. - NumberInput: hide the browser's native number spinners so the field matches the component's own visual treatment across browsers, and stop a focused wheel gesture (which steps the value) from also scrolling an ancestor container. Keyboard stepping and the
spinbuttonrole are unchanged, so there is no accessibility impact. - Pagination: mirror the prev/next chevrons under RTL with CSS (the shared
scaleX(-1)mirror) instead of reading the ambient direction in JS. The controls now flip purely from an ancestor'sdir, matching Calendar and the rest of the library — so they render correctly on the server with no hydration flash. No API change;aria-labels are unchanged. - Popover: expose wrapper role and modal options so non-dialog popup content can own its semantics.
- Add a shared
rtlStyles.centerInline(blockOffset)helper for horizontally centering an absolutely-positioned, auto-width element on the inline axis, with an optional block-axis offset folded into the same transform. It intentionally uses physicalleft: 50%+translateX(-50%)— both reference the same physical edge, so the pair is direction-symmetric and centers identically in LTR and RTL. A logicalinsetInlineStart: 50%anchor would flip in RTL while the physical translate does not, shifting the element off-center by its own width. This is the one case where physicalleftis correct, so the single sanctionedno-physical-propertiessuppression lives in the helper rather than at each call site. The@astryx/no-physical-propertiesrule now recognises thisleft: '50%'+ centeringtranslateidiom and points offenders at the helper instead of wrongly suggesting a logical rename. - The RTL physical→logical migration is complete, so promote the
@astryx/no-physical-propertieslint rule fromwarntoerrorin both the recommended and strict tiers. This gates against future physical-property regressions now that the core package is clean (the one sanctioned physical suppression lives inrtlStyles.centerInline). - RTL Phase 4c — make three animated/interactive behaviors direction-aware under RTL: the ProgressBar indeterminate bar now slides along the reading flow (right → left) instead of always physically left → right; the Switch thumb mirrors on toggle (off-thumb on the reading-start side, on-thumb on the reading-end side, per Material/iOS convention); and horizontal Layer enter animations (Popover/DropdownMenu/HoverCard/Selector placement start/end) now nudge in from the correct physical side. Vertical Layer entrances are unchanged (direction-neutral). LTR behavior is identical.
- Complete the RTL physical→logical CSS migration across the core package: the final components (Avatar, Banner, Calendar, Chat composer, Chat composer drawer, Markdown, Popover, Slider, Resizable) now use CSS logical properties (
insetInlineStart/End,borderStart*/End*radii,textAlign: 'end') instead of physicalleft/right, so they mirror correctly under RTL. The Avatar status dot's outward-pushtransformis now direction-aware, so it hugs the bottom-inline-end corner (bottom-right in LTR, bottom-left in RTL) instead of pulling inward under RTL. The Popover close button, vertical Slider track/thumb, and ResizeHandle centered grab-zone/pill now consume the sharedrtlStyles.centerInlinehelper — fixing an RTL regression where a logicalinsetInlineStart: 50%anchor combined with a physical centeringtranslateshifted the element off-center by its own width. - TextArea: the
<textarea>now spans the full input container, with icons, status/spinner, and the character counter as absolutely-positioned overlays. The native resize grip sits in the container's bottom-right corner and the scrollbar covers the whole field. ThemaxLengthcounter moved inside the container, anchored bottom-right beneath the text (#4233). - Thumbnail: show the placeholder when the image fails to load The docs promise a placeholder on load failure, but the img had no error handling, so a broken src rendered a broken image indefinitely. The component now tracks the errored src and falls back to the placeholder, retrying when src changes.
- TreeList arrow-key navigation now follows visual direction in RTL: ArrowLeft expands and ArrowRight collapses under
dir="rtl"(mirrored from LTR). Detected automatically; LTR is unchanged.
Documentation
- Soft-deprecate useTableRowExpansion and useTableRowExpansionState in favor of the tree plugin (useTableTreeData + useTableTreeState). The hooks still work; JSDoc @deprecated tags and the docs point to the migration guide. Removal will come in a later release.
- Document the
@astryxdesign/coreStyleX peer dependency — add@stylexjs/stylexto the Getting Started / Quick Start install commands in both READMEs, and add anastryx initnext-steps reminder to ensure the@stylexjs/stylexpeer dependency is met, with a pointer toastryx doctor. StyleX is the styling runtime every component calls, and not all package managers auto-install peers. - Surface the React 19 peer-dependency requirement everywhere a user would look for it (root README, core README, docsite hero, and the CLI getting-started guide), and add a sync test that keeps those surfaces naming the same React major as the core peer range.
- Add a migration guide from useTableRowExpansion to useTableTreeData + useTableTreeState (before/after example plus a config mapping), since the two tree plugins are converging.
Contributors
Thanks to everyone who contributed to this release: