What's New
Release notes and changelog for all packages.0.7.2
Experimental APIs
- Drawer's full-viewport mobile coverage ships as experimental:
experimental={{isFullWidthOnMobile: true}}fills the viewport below 640px instead of keeping the 56px page reveal. Anything inside Drawer'sexperimentalprop may change or be removed in a patch release; omitting it keeps the stable behavior.
New Components
- Promote
DrawerandDrawerHeaderfrom the canary-only Lab package to Core, imported from@astryxdesign/core/Draweror the package root. The stable package now ships the full-height side panel with modal and non-modal presentation, the shared dismissal stack, Dialog'spurposedismissal policy, aDrawerHeaderwhose close button appears when givenonOpenChange, and Dialog-style container padding (--spacing-4by default,paddingprop, or a theme'sdrawerpadding), plus Core documentation and runnable examples. Canary users importing from@astryxdesign/labswitch to@astryxdesign/core/Drawer.
New Features
- An integration can set the command its users run the CLI with: a new
cliCommandfield inastryx.integration.*, such ascliCommand: 'acme astryx'. In a project that loads that integration, every command the CLI prints starts with it instead of the package-manager prefix (npx astryx,pnpm exec astryx): next-step hints, errors, suggestions, Doctor fixes,--help, the setup reminder, the agent-docs block, and doc text. If two loaded integrations set different commands, neither is used, and the newcli-commandcheck inastryx doctorwarns. An invalidcliCommandis ignored with aninvalid_cli_commandwarning; the rest of the manifest still loads. Docs, including an integration's, are now written with bareastryx ...commands, andastryx docsprefixes them for the project when it prints them. JSON output keeps every command bare, as before. The install-time setup reminder from@astryxdesign/coreand@astryxdesign/clinames the command the project's package manager runs, instead of alwaysnpx @astryxdesign/cli. - Adds the
@astryx.diffViewer.*keys to theencatalog so the labDiffViewerreads its file-status badges, line counts, line-number button labels, per-line "Added"/"Removed" labels, and empty-state messages from the translation runtime. No existing string changes; locales without a translation fall back to English. Itemacceptsalign="first-line", which centers each start and end slot on the label's first line. A small status dot, radio, checkbox, or timestamp beside a wrapping label now stays level with the first line, wherecenterdrops it to the middle of the row andstartleaves it above the line. A slot taller than the first line moves the text down rather than leaving the row, and a one-line row with no description looks the same ascenter.ListItem,RadioListItem, andCheckboxListItemaccept the samealignand pass it to their row. Themes can style these rows through theitemtarget'salignaxis. The default stayscenter, so existing rows don't change.- i18n catalog: add the English messages used by the Lab CommentComposer for its input, image upload, inline quote, emoji action, cancel action, and retry affordance.
- i18n catalog: add the English messages used by the Lab CommentThread for replies, reactions, edit history, resolution, errors, comment actions, and the unsaved-draft warning it announces when a dismissal would discard a reply or edit.
- i18n catalog: add the English messages used by the Lab Comments panel for its region, empty/loading states, pagination, and posting errors.
- i18n catalog: add the English messages used by the Lab EmojiPicker so locale catalogs and provider overrides can replace its labels, search status, loading state, and group names.
List: addedgeto choose where each row's text, dividers, and hover and selection backgrounds sit.padded(default) keeps today's look.flushdrops the rows' side padding, so text and dividers start on the same line as the list header and a heading above, with no container needed.outsetkeeps backgrounds' room around the text while reaching into the padding of a Card, Section, or Dialog, so text lands on the heading's line.bleedreaches rows to the container's edges with square corners, like Table rows in a Card.edgeCompensation="inline"is deprecated in favor ofedge="outset"and keeps working; its rows' outer room is no longer cut off by the list's swipe clip. Runastryx upgradeto rename it.Pagination:variant="compact"shows first/last buttons around previous/next whenhasFirstLastistrueand the page count is known. Compact still omits them by default, and theinputvariant still shows them unlesshasFirstLastisfalse.reset.css: in Chromium, the dropdown marker of an<input>with alistsits in the middle of the field. Chromium sets the marker on the field's line-height, so above a line-height of 1 it sits low, and the reset makes every field inherit the page's 1.5: the marker sat 3.5px below the middle of a 40px field, and further down on taller lines. Date and time fields, whose calendar icon uses the same part, keep their icon where it was. To keep the old placement, addinput[list]::-webkit-calendar-picker-indicator { line-height: inherit; }after the reset.SideNavItem: nested items now span the full width of the nav list, like top-level items, so their hover and selected fill lines up with the rows above them. Before, a nested item started 24px in from the list edge. The indent now sits inside the row, one--spacing-6step per nesting level, so icons and labels stay exactly where they were. The indent area is now part of the nested row, so it shows hover feedback and clicking it activates the item. Content placed directly inside aSideNavItemthat is not itself aSideNavItemis no longer inset by the children group. There is no supported way to keep the old inset look.TabMenupasses host attributes and DOM event handlers to its trigger button. The trigger keeps its button semantics, tab stop, and menu disclosure attributes; a caller'sonClickruns after the menu toggle.- Tables draw a line on every cell edge, not only between rows, on both
Markdownand the RichText surfaces, and the grid closes at the table's rim. A reader following one row across never needed vertical lines, but someone editing a table has to aim at a cell and judge where a selection stops, and the empty 3×3 a toolbar insert produces was three horizontal rules with no sign it had three columns. The line is the same--color-borderalready used between rows, the rim merges with it into one rule rather than doubling at the edge, and both surfaces move together — the read and edit renderings match block for block, more closely than before. TreeList: nested rows now span the full width of the list, like root rows, so their hover and selected fill lines up with the rows above them. Before, a nested row started at its indent. The indent now sits inside the row, so chevrons, icons and labels stay exactly where they were. The indent area is now part of the row, so it shows hover feedback, and clicking it activates the row: clicking a folder's indent toggles the folder, and clicking a row whose only action is its link anywhere outside its label follows the link, as Enter already did: modifier keys are kept, so Cmd/Ctrl-click opens a new tab, and a middle-click opens one too. Controls in a row's start or end content keep their own clicks, including role-based ones such as arole="switch"element, which no longer also toggle the row or run itsonClick. Guide lines draw above the rows, so a hover or selected fill doesn't break them, and they let clicks pass through to the row underneath. The one exception is a row with keyboard focus: it draws above the guides so they never cut its focus ring, which means that if it is also filled (selected or hovered), its fill covers the guides at that row. Padding set on a row through thetree-list-itemtheme target or an item'sclassName,styleorxstylestill composes with the indent.--tree-list-indentstill retunes the indent step. There is no supported way to keep the old inset rows.
Fixes
- Allow MetadataList label width without an explicit position while preserving single- and multi-column label defaults (#6310)
- AppShell: defer hiding the mobile nav's Activity boundary until its close animation finishes (#5701)
AppShellmounts the mobile nav drawer inside aReact.Activityboundary that flipped tomode="hidden"in the same commit as the drawer closing. React'sActivityhides its subtree withdisplay: none !importantsynchronously and re-runs the cleanup of every effect inside it, which cut offMobileNav's own slide-out CSS transition and cancelled its delayeddialog.close()before either could run. The drawer still closed correctly (a safety-net effect force-closed the native dialog on that same cleanup), just with the close animation skipped entirely.AppShellnow holds theActivityboundary visible for a beat after the drawer closes, strictly longer thanMobileNav's own worst-case close delay, soMobileNav's normal close effect gets a real chance to run its transition and its own timeddialog.close()beforeActivityever hides the subtree.MobileNavalso keeps its dialog rendered from the commit that closes it until its delayedclose()has run, instead of relying on the dialog's discretedisplaytransition to do so. A browser that does not hold that transition (WebKit) dropped the dialog todisplay: noneat once while it was still an open modal, so for about 200ms nothing was visible and the page stayed inert. The slide-out itself is unchanged. AspectRatio'sfit="cover"andfit="contain"now fill the box on the documented Tailwind setups. The fit rules lived inreset.css, in theresetlayer, and the setup guides put Tailwind's preflight in a layer above it, so preflight'simg, video { height: auto }won and a fitted image kept its own aspect ratio. The fit sizing now ships with the component's own styles inastryx-base: above preflight, and below Tailwind's utilities, so a utility class on the child still wins.reset.cssno longer carries AspectRatio rules. Withfit="cover"orfit="contain", a direct child's own Astryx styles (an Astryx component's own size orobject-fit) no longer override the fill. To keep a child's own size, set it with an inline style, unlayered CSS or a rule in a later layer, or leavefitunset.- The static
AvatarGroupOverflowchip (noonClick) is exposed to assistive technology as an image named by its count label ("5 more"). Before, it was a span with anaria-labelbut no role, a name the generic role does not allow, so screen readers could skip the count. This meets WCAG 2.2 SC 4.1.2 Name, Role, Value. Nothing changes visually; the clickable chip stays a button, and arolepassed by the caller still wins. Button(andIconButton) no longer use the nativedisabledattribute while a busy state (isLoading, or a non-interruptibleclickActionin flight) is the only reason the button can't be clicked. A natively disabled element can't hold focus, so the browser moved focus to<body>the instant an action started and never restored it — the classic reason busy state should be visual-only. Busy now usesaria-disabled(button stays focusable) witharia-busyand the spinner, matching the documented "Disabled vs Busy" API convention and the behavior input components already follow.isDisabled(andisDisabledtogether with a busy state) is unchanged — that still uses nativedisabled.isInterruptibleis also unchanged.aria-disabled, unlike nativedisabled, still lets the button dispatch a click — the busy guard already calledpreventDefault()to block the button's own action, but a click on a busy button could still bubble to a wrapping ancestor's own click handler (a clickable row, card, or backdrop), which the previous native-disabledbehavior never allowed.handleClicknow also callsstopPropagation()in that guard, containing an unavailable click at the Button boundary the way a natively disabled control always did.Thehref-rendered anchor path had the same gap for keyboard activation: it only wiredonClickto the busy guard, notonKeyDown, so a consumer's ownonKeyDownstill received Enter/Space on a busy-only anchor Button while it was announcedaria-disabled. The anchor path now wires the samehandleKeyDownsuppression the button path already had, so Enter/Space are swallowed and every other key still reaches the consumer, on both render paths.ChatLayoutScrollButton: the scroll-to-bottom pill now gives up keyboard focus, and refuses new focus, as soon as it starts to hide. Previously focus stayed on the fading pill for about half a second, untilvisibility: hiddenapplied, so it could sit on a control that was fading out or already transparent (WCAG 2.2 SC 2.4.7 Focus Visible). (#7738)- Preserve caller-provided IDs on CheckboxInput and keep labels associated with the native input.
- CheckboxList keeps a caller's
aria-labelledby. The group always replaced it with its own label id, so the caller's ids never reached the accessible name. The group is now named by its label and then the caller's ids, the same order RadioList and TimeInput use. - The setup reminder, the swizzle StyleX note, and one doctor line say only what is true
CommandPaletteInput: the query field now draws the shared keyboard focus ring. Previously it suppressed the browser outline without replacing it, so keyboard users could not see which field held focus.- Source builds through Next.js's Babel no longer fail with
Unknown property: L(orZs,Letter) when the app sets no browserslist or targets a browser without Unicode property escapes.Avatar's initials and the Markdown parser's emphasis and heading-link rules now build their\p{…}regular expressions at runtime, asNumberInputalready does, so there is no literal for Babel to rewrite. Matching is unchanged. DrawerHeadernow renders numeric zerostartContentinside its start slot and preserves numeric zeroendContentwhen no close button is present.Drawernow slides from the correct logical edge whendir="rtl"is set directly on the drawer, matching inherited right-to-left regions.DropdownMenuDividernow forwards host attributes and DOM handlers (id,data-*,aria-*, event handlers) to its separator, as other DOM-owning components do. Before, it accepted onlyxstyle,className,styleandrefand dropped everything else, so a separator could not carry a test id or an accessible label. Itsrole="separator"and orientation stay component-owned.- DropdownMenu: load the touch bottom sheet only when a menu shows it
DropdownMenuimported its touch sheet (BottomSheet, its gestures, and the touch action list) up front, so every page with a dropdown shipped it, even when the menu only ever opens as an anchored popover. The sheet now loads on demand, the wayContextMenualready loads it. A popover-only dropdown's own code drops by about a third (about 23 KB gzipped). Bottom-sheet and adaptive menus behave as before. The sheet starts loading when the trigger mounts, and a menu opened from the keyboard before it arrives still focuses its first action once it loads. EmptyStateno longer leaves blank icon or action spacing when those optional slots receive a boolean or an empty string. An empty description also omits its theme target. The docs now describe configurable heading levels and map the container anatomy to the public theme target.- Keep
Field's horizontal-label layout marker authoritative when callers pass conflicting data attributes, and keep hidden descriptions visually hidden in that layout. Correct its custom label-icon type, all three status placements, complete anatomy, and guidance for controls that cannot safely use attached status. FieldStatus(and any element usinguseEntryAnimation) no longer causes a hydration mismatch on server-rendered pages. An element that arrives in the server's HTML now hydrates without the entry style and never plays its entry animation, even when hydration runs after the page has painted; elements mounted after hydration still animate.useEntryAnimationno longer documents server rendering as unsupported.- Keep
FormLayout's direction metadata authoritative when callers pass conflicting data attributes. GridSpankeeps its content inside the span. A child whose min-content width is wider than the span, such as aTokenizerwith a long token, used to stretch the span's column past the grid cell; it now gets the span's width and truncates the way it does outside a Grid (#7438)- Keep
Grid's theming metadata authoritative when callers pass conflicting data attributes. useHoverCard: closing a hover card withhide()or Escape while the pointer rests on the card no longer leaves the next open stuck. The hook kept believing the pointer was still over the card, because a card closed that way unmounts without amouseleave, so the trigger's next hover-open never closed on leave or afterhideDelay. Both paths now clear that state, as the touch dismissal already did.- Compute ISO week numbers (
Calendar hasWeekNumbers,getWeekNumber) on UTC anchors instead of local-timeDatearithmetic. In timezones whose DST ends after New Year (Sydney, Auckland, Santiago), the local-millisecond difference between the week's Thursday and January 1 carried the DST offset, and in years whose January 1 is a Friday that extra hour rounded a whole week up: the entire ISO week 14 of April 2021 displayed as week 15. Week numbers are now identical in every timezone. - Anchored layers (
Popover,DropdownMenu, and every component built on them) now keep their safe-area gutter and dynamic-viewport size cap in the shipped stylesheet. The compiled CSS referenced an undefined variable for the preferred value, so every browser used the fallback: on a phone with a dynamic toolbar or a notch, a tall layer could run past the visible screen or under a declared bottom bar. Desktop sizes are unchanged. createMarkdownFrontmatternow hands itsparsefunction a plain object, so a parser that returns the decoded fields unchanged (parse: fields => fields) is accepted as metadata. Before, the record had no prototype, failed the JSON-like metadata check, and the document fell back to readable text with its frontmatter still showing.MultiSelector: the row action cell the keyboard reaches with the inline-end arrow draws the standard focus ring. Before, its outline read four CSS variables that nothing declared, so no ring showed on the active action cell.- PowerSearch: clear every filter with one press of the clear-all button instead of removing only the last filter.
- Prevent pressing a built-in PowerSearch filter token with the mouse from opening search suggestions before the filter editor. Token editing, removal, and keyboard navigation retain their existing behavior.
- Keep built-in PowerSearch value controls disabled in read-only filter editors, matching custom editors.
- RadioList keeps a caller's
aria-labelledby. The radiogroup always replaced it with its own label id, so the caller's ids never reached the accessible name. The group is now named by its label and then the caller's ids, the same order TimeInput uses. - Restore focus to the element that opened a Dialog when its content mounts in the open commit. The opener was captured in the Dialog's passive effect, which runs after a freshly mounted DialogHeader's autofocus effect had already moved focus to the dialog's own title — closing then restored focus to that detached title and the user's focus landed on
<body>. The capture now runs in a layout effect, before any descendant's passive effect. (#5637) astryx searchfinds more of what a reader means when the words differ from the catalog's.astryx searchranks a match on more of your words above a shorter named entry.SideNavItemkeeps a caller'sclassNameon its row element (the link or button, and the collapsed rail item) next to its own classes. Before, the row's generated class replaced it, so a class passed to style the row (for example, a cursor while a row is dragged) never reached the DOM, even thoughstyle, ARIA, data attributes and handlers did.- Shrink Token's invisible remove-button target from 44px to 24px without changing the visible icon. Clicking adjacent text or values in PowerSearch now edits the filter instead of accidentally removing it.
- DropdownMenu submenu flyouts close with their menu when it is light-dismissed: previously a submenu opened by tap or a fast click stayed open (and re-anchored to the viewport corner) after the menu was dismissed and reopened. A hover-open scheduled on a submenu trigger before the menu closed from elsewhere is also cancelled, so it can no longer reopen a flyout behind the dismissed menu
Switchnow adds a caller'saria-describedbyto the switch control, ahead of its own description, status, and disabled-reason ids. Before, the value landed on the field wrapper, so a hint rendered elsewhere on the page could not describe the switch to assistive technology.Switchnow puts a caller'saria-labelledbyon the switch control. Before, the value landed on the field wrapper, so a visible title elsewhere in the row could not name the switch for assistive technology.- A truncated
TextorHeading(maxLines) now re-measures when its content changes, not only when its box resizes. A fixed-width single-line status whose message changed kept showing the first message in its truncation tooltip, and a new short message could keep a tooltip while a new long one lacked one.useTruncationnow also observes the element's text, so the tooltip text and the truncated state follow the current content. ToggleButtonkeeps toggling when it also receives anonClick, for example from a wrapper that renders it as its trigger. ThatonClickused to replace the toggle's own click handling, soonPressedChangenever ran and aToggleButtonGroupmember never asked its group to toggle (pressedChangeActionstill ran). The caller'sonClicknow runs first and the toggle request follows. On a standaloneToggleButton, callingpreventDefault()in thatonClickcancels the request: neitheronPressedChangenorpressedChangeActionruns.useTooltip(and every component built on it, such asButton'stooltipprop) now drops a show that is still waiting out its delay whenisEnabledturnsfalse. Before, hovering a trigger and then disabling its tooltip within the delay let the timer fire anyway: the tooltip opened after its triggers were turned off, with no pointer-leave listener left to close it. A pending hide still runs, and an enabled tooltip is unchanged.- Tooltip: an icon-only trigger now opens instead of throwing. The layer passed its trigger to
showPopoveras the invokersource, which the Popover API declares as anHTMLElement; a caller-rendered icon is anSVGElement, whose dictionary conversion throws before the popover opens, so the hint never appeared. An icon trigger now reachesshowPopoverwithout a source — positioning is unchanged, since the layer is anchored by its anchor-name pair, and only the invoker's focus order is given up. - A collapsed
TopNavMenuorTopNavMegaMenusection in the mobile drawer is nowinertand hidden from assistive technology, so Tab no longer moves focus onto links that are not shown and screen readers no longer list them under a section announced as collapsed. - An expanded
TopNavMenuorTopNavMegaMenusection in the mobile drawer no longer clips the focus ring of its items. The section still clips while collapsed and while it animates open or closed. Typeahead,Tokenizer, andPowerSearch: clear loading state and stop busy indicator when search source is replaced (#7457)
Performance
TextandHeadingwithmaxLinesandhasTruncateTooltip={false}no longer measure their text or observe it for resizes and content changes. Only the tooltip uses that measurement, so with the tooltip off the text is cut by CSS alone, and a long table of truncated cells no longer pays a layout read per cell. Rendering is unchanged; with the tooltip enabled (the default) nothing changes.
Documentation
AvatarandAvatarGroupdocs list the numeric sizessizeaccepts (16, 20, 24, 32, 36, 40, 48, 60, 64, 72, 96, 128, 144, 180) instead of implying any pixel value, and say that anAvatarGroup's size always overrides a childAvatar's size, including the group's default.- Docs and CLI examples import each Core export from the path
astryx component <Name>prints. ContextMenudocs now state that data-drivenitemsand compoundmenuContentare mutually exclusive choices instead of markingitemsas unconditionally required.- Document DropdownMenuGroup's complete wrapper props, group semantics, and non-interactive heading guidance.
- Document FieldLabel's complete public prop surface, group-label semantics, and supporting descriptions.
- Make
FormLayoutdocumentation match logical fractional grid tracks and viewport collapse, and make the public layout target discoverable from component anatomy. - Make
GridandGridSpandocumentation match fractional track sizing, responsive repeat behavior, implicit rows, and explicit-column spans. useCombobox, the single-select combobox hook exported from@astryxdesign/core/Selectorthat powersSelectorandCommandPalette, now has hook docs, soastryx hook useComboboxandastryx search comboboxreturn it with its options, its return fields, and how to wirearia-activedescendantwhile focus stays on the control.- The
useMultiComboboxhook docs now say that ArrowDown or ArrowUp opening the list lands on the first or last option even withhasSearchor a disabled end option, and that the hook still handles Home and End withhasSearch, so a search input that keeps those keys for the caret stops them first and relies on PageUp and PageDown. useMultiCombobox, the multi-select combobox hook exported from@astryxdesign/core/MultiSelectorthat powersMultiSelector, now has hook docs, soastryx hook useMultiComboboxandastryx search comboboxreturn it with its options, including the grid rows with an action cell, its return fields, and how to wirearia-activedescendantwhile focus stays on the control.- InternationalizationProvider documentation now names its nonvisual provider boundary so the new component contract can map its anatomy without implying rendered DOM. (#6048)
ListItem's docs now listlabelas aReactNode, matching its props type: a string is truncated to one line, and any other node renders as given. They used to saystring, which told readers a rich label had to be restructured away.
Other Changes
VStackandHStackcome from@astryxdesign/core/VStackand@astryxdesign/core/HStack,Headingfrom@astryxdesign/core/Heading,Textfrom@astryxdesign/core/Text, andThemeanddefineThemefrom@astryxdesign/core/theme.- This covers the guides, the
Carddocs, the next stepsastryx initprints, the install exampleastryx theme buildprints, the wiring exampletheme addprints, the build rules, the theme-module fixastryx doctorprints, and the annotated theme template. - Every path was already exported. Nothing else changes.
- The "run init to finish setup" reminder no longer prints where agents already have the Astryx prompt. In a git repository it looks for init's block in the agent docs from the project up to the repository root, because coding agents read every agent doc in between, so a package in a monorepo that ran
initat its root stays quiet. This holds for every command and for the reminder printed when@astryxdesign/coreor@astryxdesign/cliis installed. Running the CLI from its own source checkout, inside that checkout, prints no reminder. A project with no block in reach still gets it, and--jsonnever prints it. astryx swizzleno longer says StyleX components "render unstyled (no error)" without a StyleX compiler. Importing them throws StyleX's "Unexpected 'stylex.create' call at runtime" error and the page does not render, and the note now says so.- In an integration package, where the package's own manifest loads,
astryx doctor's implicit-integrations line no longer says that "every loaded integration is named in astryx.config". It names the package's own manifest: as the only loaded integration, or beside the integrations astryx.config names.Classification: contract-restoring. Only message text changes: JSON keys, check ids, statuses, and exit codes are unchanged. The doctor line's new text also appears in its--jsonmessage. - Internal groundwork for a sub-menu's header and footer:
DropdownMenu's Tab walk through its header, menu and footer moves, unchanged, into a module of its own, so another menu level with regions can share it.DropdownMenu's behavior does not change. - Adjacent query words that join into a component, hook, or template name, or into a one-word keyword, match it:
table header cell with sort arrowfindsTableHeaderCell,tree view foldersthetreeviewkeyword, and a hook answers to its words withoutuse. Most of a name, a name's leading words, or a run of its words also count for components and hooks, a step below the full name. - A query that is one camelCase identifier and matches nothing as typed is read as the words it spells, so an unknown API name such as
useTablePaginationStatereachesuseTablePagination. In a query of several words each identifier stays one term. - When the whole query is an entry's name, these readings add no near siblings beside it. A match on a joined keyword never ranks above an entry the query names, and a match on part of another name does only when it spans more query words than that entry's name.
- A gerund matches its verb (
spacingandspace,dragginganddrag), and a plural can start a longer word through its singular (tokensandTokenizer). - Core component docs declare more keywords: other libraries' names (
scrollarea,togglegroup,pageheader,splitpane,circularprogress,linearprogress,commandmenu,relativetime,sidesheet,descriptionlist,inlinecode) and common glyph names onIcon, since any icon library's glyph renders through it. - The JSON shape is unchanged.
- A match on part of a longer name that reads more of the query than the entry the query names is no longer held below it:
dropdown menu radio optionsleads withDropdownMenuRadioItem, notDropdownMenu. useResizabledrops thesplitviewkeyword, which put it ahead of the side-panels guide.
Contributors
Thanks to everyone who contributed to this release:
0.7.1
New Features
- Chat: mention people and topics by multi-word names with opt-in
hasMultiWordQueryonChatComposerTrigger(#6128) SethasMultiWordQuery: trueon a trigger whose suggestions contain spaces, and typing@Jordan Lekeeps narrowing the menu instead of closing it at the first space. The query runs until a line break or about 64 characters, typed text is never changed unless a row is picked, and an unmatched multi-word phrase hides the menu unless the trigger setsemptySearchText. Triggers that don't opt in still end their query at a space.For every trigger: while results for the current query are still loading, Enter sends the message as typed and never picks a row from an earlier query. Results that arrive after a send or after the editor clears are dropped, so the menu never reopens over an empty composer. Escape and the arrow keys pass through while the menu is hidden, and IME keystrokes never pick a row. CodeBlockgainsisDiff, a diff layer over anylanguage, and Markdown renders a ```diff fence as tinted diff rows instead of plain text. (#7389) WithisDiff, lines starting with+sit on a success-tinted row,-on an error-tinted row,@@hunk headers (and a---/+++file-header pair directly before one) on a quiet muted row, and the rest of every line keeps the language's syntax highlighting. The glyph renders in its own column so the code's indentation lines up on every row and stays in the copied text. A changed row's margin reads the change: the tint runs under the line-number gutter too and spans the full scroll width of a long line, and the line number and the glyph take the row's marker colour, while the code keeps the syntax theme's colours. These are five new syntax-theme slots —--color-syntax-added,--color-syntax-removed,--color-syntax-diff-header(row paints, defaulting to--color-success-mutedand--color-error-mutedat 25% strength and to--color-background-muted; a defined syntax theme that leaves the header paint unset gets none, its header rows sitting on its own background in its punctuation colour) and--color-syntax-added-marker,--color-syntax-removed-marker(defaulting to--color-text-greenand--color-text-redin the default syntax theme; a defined syntax theme that leaves them unset keeps its own line-number colour) — so existing and custom syntax themes need no change and may override them.Markdown maps adiff-<lang> fence to the layer over `<lang>` (labelled `<lang> diff`) and adiff fence to the layer over plaintext (labelleddiff), so a diff keeps its header, copy button, disclosure, and a viewport name that still saysdiff.Adiff fence that should stay plain text can usetext. A customcomponents.coderenderer is unchanged: it keeps receiving the fence's leading word characters inlanguage(difffor bothdiff anddiff-tsx, as today), so an existinglanguage === 'diff'check still matches, and receives nothing new.- Clearable inputs: the clear button's tooltip now reads just "Clear" (localized) instead of repeating the field's label, so a long label no longer turns into awkward tooltip copy such as "Clear Assigned engineering partner". The button's accessible name is unchanged and still names the field, such as "Clear Search". Applies to every input that renders the shared clear button, including
[TextInput](/components/TextInput),[NumberInput](/components/NumberInput), the date and time inputs,[FileInput](/components/FileInput),[Selector](/components/Selector),[MultiSelector](/components/MultiSelector),[Typeahead](/components/Typeahead), and[Tokenizer](/components/Tokenizer). Override the new@astryx.inputClearButton.tooltipcatalog key to change the wording. (#7476) [Markdown](/components/Markdown)fenced code blocks wrap long lines instead of scrolling them sideways. A reader on a narrow screen sees the whole line without a horizontal scroll, and where[Markdown](/components/Markdown)and RichText give a code block the same width, a long line takes the same number of lines in both. Only the appearance changes: the code's text, line numbers, syntax colours and what Copy returns are unchanged, and a code block whose lines no longer overflow also no longer takes the scroll region's Tab stop, as a code block that fits never has. To keep the old sideways-scrolling look, render code yourself through thecomponents.codeprop with a[CodeBlock](/components/CodeBlock)that leavesisWrappedoff. (#7564)- Selector, MultiSelector, and ComplexSelector gain a
secondaryvariant: a borderless, neutral-filled trigger matching secondary buttons in navigation and toolbar compositions. Inside an[InputGroup](/components/InputGroup), a secondary Selector or MultiSelector keeps its fill and takes the group's row height and connected edges. Existinginput(default) andghostbehavior is unchanged. (#7252)
Fixes
[Typeahead](/components/Typeahead),[Tokenizer](/components/Tokenizer), and[PowerSearch](/components/PowerSearch): focusing an empty field withhasEntriesOnFocusafter its search source changed now bootstraps entries from the new source. Previously the results cached from the old source were already invalidated but still blocked the bootstrap, so focusing or clicking into the field opened nothing until the user typed. Cached results that are still current are re-shown without a new bootstrap, as before. (#7157)[BottomSheet](/components/BottomSheet)returns focus without a focus ring after a pointer close (a tap in WebKit, or a pointer close of a sheet opened from the keyboard) and keeps the ring after a keyboard close, including on a[DropdownMenu](/components/DropdownMenu)bottom-sheet trigger the caller renders (renderTrigger). The sheet now asks the browser not to treat that focus as keyboard focus, the way Dialog's focus moves do. (#7388)- Keep DateInput's calendar selection empty after clearing the field. (#6935)
[Calendar](/components/Calendar): PageUp and PageDown move the focused day by a month — into the month the grid shows, on the same day of the month where it exists — instead of by a week; a page from a borrowed adjacent-month day lands on that day of the month now shown rather than on the month's first day. With two months, a page or an arrow crossing a month edge from the first month now lands on the correct day (the second grid no longer overrides the first grid's target). An arrow or page pastmin/maxchanges nothing, and a page into a month with no enabled day keeps focus in the grid. (#7467)[Calendar](/components/Calendar): the arrow keys, Home and End no longer land on a borrowed adjacent-month day (shown dimmed, exposed as disabled, and inert to Enter, Space and clicks). An arrow crosses into that month and focuses the real day there, including across the two grids of a two-month view; Home and End stop at the first or last enabled day of the week in the month shown. A month with no enabled day holds no Tab stop. (#7511)[Calendar](/components/Calendar)withhasWeekNumbers: the blank cell above the week-number column is now acolumnheadernamed with the locale's own word for the week field (from CLDR, visually hidden), so every cell in the header row has a grid role and assistive technology reads the weekday header row without a stray unnamed cell. (#7509)[ChatMessage](/components/ChatMessage)no longer leaves empty space for an avatar, name, or metadata that renders nothing. Booleans and empty strings create no slot, and any other slot content that renders nothing, such as an empty Fragment or a component that returnsnull, collapses its wrapper. A name that renders no text falls back to the translated sender label, while numeric values such as0still render. (#6597)[CodeBlock](/components/CodeBlock)'s code viewport is a keyboard Tab stop only while its content actually overflows, through the shared scroll capability: a short snippet no longer adds an unexplained stop to the page's Tab order, a wide or capped block still does, and a viewport that stops overflowing keeps focus where it is. Role and accessible name are unchanged. (#7424)[CommandPaletteInput](/components/CommandPaletteInput)now exposes the semantics and name that its visible state promises. (#7321)- A standalone field with no popup attributes was
role="combobox"witharia-expanded="true"andaria-autocomplete="list"; it is nowrole="searchbox"with no popup state. Passrole="combobox", or your popup's own ARIA attributes, to keep the old semantics. A field that already passes popup attributes (aria-expanded,aria-controls,aria-owns,aria-haspopup, and the like) stays acomboboxand keeps them, and a field inside[CommandPalette](/components/CommandPalette)is unchanged. - The field's default accessible name was its placeholder (
Search…, or the caller'splaceholder); it is nowSearch commands, translated. Passlabelto keep a specific name, for examplelabel="Search…"for the old default. A caller whose customplaceholderserved as the name keeps working code and hears the generic name until it passeslabel. - The CLI's async-search CommandPalette block names its field
Search files. endContent={true}no longer renders an empty trailing slot, andendContent={0}renders inside the trailing slot instead of after it.
- A standalone field with no popup attributes was
- A standalone
[CommandPaletteItem](/components/CommandPaletteItem)now keeps a caller-supplied id on its rendered option and ignores click callbacks while disabled, so labels and test hooks keep pointing at the option and a disabled command cannot run. (#7324) [CommandPalette](/components/CommandPalette)now keeps dismissal, text entry, result focus, and empty-state announcements aligned with what the reader sees. (#6950)- While no selectable result exists, the results container no longer exposes an empty
listbox, and the query field reportsaria-expanded="false"with noaria-controlsoraria-activedescendant. It was an expanded combobox controlling an empty listbox. - Home and End move the caret in the query field, as in any text field; they used to jump to the first and last result. Page Up and Page Down still jump to the first and last result.
- A search with no results announces the empty message the palette renders (
No resultsby default, or the caller'semptySearchText), once the search settles. It used to announceNo results for <query>, whatever the palette showed. An override of the@astryx.commandPalette.noResultsForcatalog entry no longer has any effect; useemptySearchTextto customize the message.
- While no selectable result exists, the results container no longer exposes an empty
[ContextMenu](/components/ContextMenu)paints in Safari when its trigger sits inside a scroll container. The menu is anchored to a box at the pointer, and that box was empty: WebKit counts an empty anchor box inside a scroller as clipped, so the defaultposition-visibility: anchors-visiblehid the open menu. The anchor is now 1px, kept inside the trigger, so the menu still hides while a scroller clips the pointer position and paints again when it scrolls back. A pointer-opened menu now starts 1px lower, below the pixel under the pointer. (#7369)[ContextMenu](/components/ContextMenu)now lets Escape dismiss the topmost nested overlay before the menu itself, and preserves consumer trigger handlers while adding its own, so an overlay opened from a menu stays usable and product event logic still runs. (#7167)- The touch month scroller shared by
[DateInput](/components/DateInput)and[DateTimeInput](/components/DateTimeInput): under RTL the horizontal arrows follow the reading direction (ArrowLeft moves to the next day, ArrowRight to the previous), and every keyboard move — arrows and Home/End — now lands on the real day in its own month pane rather than on the dimmed, disabled copy a neighbouring pane shows at its edge. Touch scrolling is unchanged. (#7466) [DateRangeInput](/components/DateRangeInput): activating the clear button with the keyboard now returns focus to the range trigger. Previously the button unmounted once the range was cleared and focus fell to<body>, so a keyboard user had to Tab back in from the top of the page. Pointer clears are unchanged. (#7507)[Dialog](/components/Dialog)now preserves consumeronClickhandlers while retaining its controlled backdrop-dismissal behavior. (#7452)[DialogHeader](/components/DialogHeader)now keeps valid numeric zero content inside itsstartContentandendContentwrappers and theme targets. (#7454)[Divider](/components/Divider)now keeps numeric zero labels inside the labelled separator and omits boolean or empty-string labels without leaving empty label spacing. (#7572)[DropdownMenuCheckboxItem](/components/DropdownMenuCheckboxItem)now preserves consumer click and pointer-move handlers while keeping its checked-state, disabled, hover-focus, and close-menu behavior. (#7573)- A
[DropdownMenu](/components/DropdownMenu)withheaderorfooteris now exposed as a modal dialog around its menu, as the APG Dialog pattern requires. The popover is a namedrole="dialog"witharia-modaland therole="menu"inside it; the trigger saysaria-haspopup="dialog"and itsaria-controlsnames the popover holding the dialog. Tab and Shift+Tab wrap through the header, the menu and the footer instead of closing the menu at either end. Escape still closes and returns focus to the trigger. A menu without either prop is unchanged. (#7515) - A
[DropdownMenu](/components/DropdownMenu)whose trigger the caller renders (renderTrigger) returns focus to it without a focus ring after a pointer pick (a mouse click in Chromium, a click or a tap in WebKit), as the built-in trigger already did: the menu now asks the browser not to treat that focus as keyboard focus, the way Dialog's focus moves do. (#7382) [DropdownMenu](/components/DropdownMenu)and[MoreMenu](/components/MoreMenu): a disabled trigger no longer opens the menu. A disabled trigger with a tooltip stays focusable (aria-disabled), and Button swallowed only Enter and Space, so ArrowDown, ArrowUp, a press, or a click could still open the anchored menu; the anchored open path and the bottom-sheet trigger's click now check the trigger's availability first, for the default Button and for a natively oraria-disabledcustom trigger. (#7475)[FormLayout](/components/FormLayout): below the 480px collapse,direction="horizontal-labels"controls now fill the column the way they do in a vertical[FormLayout](/components/FormLayout). Previously each control shrank to its content, so a[Selector](/components/Selector)was only as wide as its current value. The two-column layout above 480px is unchanged. (#7501)- Buttons used as InputGroup addons now share the group's outer shape, with square inner corners where they meet the adjacent input. (#7233) Standalone buttons and buttons rendered inside an input keep their existing shape and behavior.
- Keep
[useHoverCard](/components/useHoverCard)()trigger refs stable across unchanged rerenders. The hook returned a freshref/interactionRefon every render because its callbacks depended on the wholelayerandtouchobjects, which are rebuilt each render — React detached and re-attached every trigger listener and rewrote the trigger's inlineanchor-nameon each rerender. Hooks now depend on the stable layer and touch members instead, mirroring the Tooltip fix in #5951. (#6472) (#6606) - MobileNav: return focus to the element that opened the drawer when it closes. The drawer relied entirely on the browser's implicit
<dialog>focus restore, which was reported failing in Safari 26.5.2:document.activeElementbecame<body>after close, stranding keyboard and screen-reader users at the top of the document. MobileNav now captures the opener beforeshowModal()moves focus into the top layer and hands it back as soon as the native dialog has closed, matching what[Dialog](/components/Dialog)already does. The close is deferred until the slide-out has played, so the restore waits for it too; until then the rest of the document is inert and an earlierfocus()would be silently dropped. The restore also covers the AppShell path, where the drawer is torn down by an<Activity>switching tomode="hidden"rather than by the close branch re-running. No API change. Focus is left untouched when there was no real opener (activeElementwas<body>), when the opener has since left the DOM, or when the drawer is reopened before its pending close runs. (#3343) (#4410) [MultiSelector](/components/MultiSelector): activating the clear button with the keyboard now returns focus to the trigger, ashasCleardocuments. Previously the button unmounted once the selection was empty and focus fell to<body>, so a keyboard user had to Tab back in from the top of the page. Pointer clears are unchanged. (#7506)[NumberInput](/components/NumberInput): the screen-reader "Invalid number" alert now goes through the i18n translator, so an[InternationalizationProvider](/components/InternationalizationProvider)locale or override can replace it. Adds@astryx.numberInput.invalidNumberto theencatalog. Locales without a translation yet still fall back to English. (#7482)astryx.css,reset.css, and every other package stylesheet (richtext.css,lab.css,charts.css) now open with@layer reset, astryx-base, astryx-theme;, the same line theme stylesheets carry. The Astryx layer order holds whichever Astryx stylesheet loads first: loadingreset.cssafterastryx.cssno longer lets the reset override component styles, and theme overrides keep winning. Setups that already declare the order on their own first line are unchanged. (#7585)plainDateToInstantnow resolves skipped and repeated wall times the way Temporal's default"compatible"disambiguation does. (#7081)- A skipped wall time moves forward by the length of the gap. In a zone that springs forward from a negative offset at local midnight, such as America/Santiago on September 6, 2026 or America/Havana on March 8, 2026, the start of that day came back as 11:00 PM the day before, so a week or day range landed on the wrong date; it is now the day's first instant (1:00 AM).
- A repeated wall time resolves to its earlier occurrence in every zone. In zones with a positive offset, such as Europe/Berlin on October 25, 2026, it resolved to the later one.
[Calendar](/components/Calendar): dates in years 1-99 now show their own year instead of 1900-1999. A value of0001-01-15was captioned "January 1901" with 1901's weekday layout and day labels, whileonChangestill emitted the year-1 ISO date. The shared date helpers behind the caption, day grid, week numbers, day counts, and timezone instants now keep years 1-99 as given. One limitation remains: in a timezone west of UTC, the instant for January 1 of year 1 still comes out a year early, because its timezone offset is read from a 1 BC wall clock without the era. (#7465)[PowerSearch](/components/PowerSearch): pressing Enter on a focused button in the filter editor now activates that button. Enter on Cancel closes the editor without applying the draft, and Enter on Delete removes the filter; before, both applied the draft instead. Enter in a text or number value field still applies the filter; Enter on the date picker's calendar button now opens the calendar. (#7500)[CommandPaletteList](/components/CommandPaletteList)now preserves a caller-supplied id when used standalone, while a managed[CommandPalette](/components/CommandPalette)still assigns the ARIA id its search field controls. External labels and test hooks stay attached without breaking the palette's combobox relationship. (#6988)reset.cssno longer hideshidden="until-found"content withdisplay: none. The browser's own rendering,content-visibility: hidden, now applies, so find in page and text fragment links can find the content and reveal it, as the HTML Standard specifies. Plainhiddenelements are stilldisplay: none, and a browser without until-found support still hides the content with its own[hidden]rule. (#7520)[ResizeHandle](/components/ResizeHandle): on a collapsed pane, the arrow that grows it opens it one step above its minimum, or at itscollapsedSizewhen that is larger (a single step below the collapse threshold used to leave it collapsed); the arrow that shrinks it stays a no-op. Enter and double-click still restore the previous size. (#7512)[ResizeHandle](/components/ResizeHandle): Enter and double-click on a collapsed pane restore it to the size it had before it collapsed, not to its minimum, and reopen it even whenminSizeis belowcollapsedSize. The handle uses[useResizable](/components/useResizable)'s own collapse and expand transitions;ResizablePropsis unchanged, and a hand-built props object keeps the previous resize-to-minimum behavior. (#7479)[ResizeHandle](/components/ResizeHandle): with snap points set, an arrow key moves the pane to the adjacent snap point in its direction (Shift moves two), a point beyond the bounds counting as that bound — a 10px step used to snap straight back to the point it started on. With snap points, a shrink arrow at the lowest point no longer collapses a collapsible pane; Enter, double-click and dragging still do. (#7514)[ResizeHandle](/components/ResizeHandle): a separator whose region sets nomaxSizenow reports anaria-valuemax— a measured extent standing in for the missing maximum (the window's extent on the region's axis, or the container's content box while a percentage bound observes it), never below the current size or, while collapsed, the minimum. Pixel-only regions inside a container still report no maximum (measuring one would add an observer).ResizablePropsis unchanged; End still moves only to a configured maximum. (#7481)[useScrollOverflow](/components/useScrollOverflow)(the strip of[TabList](/components/TabList), the scroller of[Carousel](/components/Carousel)) measures a resize, and its container at registration, only while the container is rendered. Inside adisplay: noneancestor or acontent-visibility: hiddensubtree the hook keeps its last state instead of reading layout, since a layout read there made the browser render the whole hidden subtree for the answer; the resize observation that comes with the reveal measures again, one frame after the reveal paints. A scroll is measured hidden or not, so a container script scrolled while hidden (a selected tab's reveal) is right at a reveal that brings no resize. Before, a hidden container reported no overflow. (#7518)- A
secondarySelector, MultiSelector, or ComplexSelector now matches the theme's secondary Button: under butter, chocolate, gothic, stone, and y2k it takes that Button's border, fill, text color, and hover instead of the default borderless neutral fill, so a toolbar mixing secondary buttons and selectors reads as one set of controls. Disabled and read-only triggers keep a still fill on hover, as a disabled Button does, and a Selector or MultiSelector inside an InputGroup keeps the group's neutral fill and edges. The default theme is unchanged, the selector docs now saysecondaryfollows the theme's secondary Button, and themes added with the CLI get the same parity. (#7548) [Selector](/components/Selector): activating the clear button with the keyboard now returns focus to the trigger, ashasCleardocuments. Previously the button unmounted once the value was cleared and focus fell to<body>, so a keyboard user had to Tab back in from the top of the page. Pointer clears are unchanged. (#7455)[SideNav](/components/SideNav): the resize handle now names the navigation pane it resizes witharia-controls(the nav gets a generated id when the consumer gives none), as the APG window splitter pattern requires, so assistive technology can relate the separator to the pane. (#7473)[Slider](/components/Slider): End now reachesmaxeven when the step grid does not land on it (formax={100}withstep={3}, End stopped at 99). Arrow and Page key results still snap to the nearest step and then clamp. (#7484)[Slider](/components/Slider): on a horizontal track under RTL the arrow keys now follow the mirrored track — ArrowLeft increases the value and ArrowRight decreases it, matching where the thumb moves on screen. ArrowUp/ArrowDown, PageUp/PageDown, Home/End, and vertical sliders are unchanged. (#7461)- Stop Tokenizer's
hasCreate"Create X" entry from offering a label that is already tokenized under a different id. The duplicate check compared the typed text against selected ids, but real selections usually carry an opaque id (u1under the label "Alice"), and the search results could not catch the match because they are pre-filtered to remove already-selected items — so typing an existing token's label offered "Create", which committed a second, duplicate token with a new id. The check now also compares against selected labels (case-insensitive), in both the Create entry and the stale-entry commit guard. (#6367) - Keep Toolbar keyboard navigation and roving tab stops outside nested popover menus, without disabling toolbar navigation inside an outer popover. (#7446)
[TreeList](/components/TreeList): each row is now named by its label alone and described by its description (aria-labelledby/aria-describedbyon thetreeitem), so screen readers no longer read the chevron toggle's label or the description as part of a row's name, and link and action rows are named as rows, not only through their inner control. Typeahead matches the label rather than the row's whole text. (#7472)
Documentation
[AlertDialog](/components/AlertDialog)'s anatomy lists the dialog surface — the modal panel that holds the title, description, and buttons — and[Calendar](/components/Calendar)'s anatomy lists the calendar root and the day button, so every part that carries a theming target (alert-dialog,calendar,calendar-day) is named in the component docs. (#7464)- List
[DateInput](/components/DateInput)'scontainerClassName,containerStyle,controlClassName, andcontrolStyleprops in its API reference, alongsidecontainerXstyleandcontrolXstyle. (#7372) - Grid's
columnsdocs now lead with the shape that reflows: a numericcolumnsis exactly N columns at every width and never reflows, andcolumns={{minWidth, max}}is the form for columns that must survive a phone. Theastryx docs layout/responsivetopic gains a "Columns that reflow" section with a reflowing stat row beside a fixed week row. No behavior changes. (#7340)
Other Changes
- The core build now fails when StyleX rejects a declaration such as a
border,background, orallshorthand, instead of silently dropping it from the shipped CSS. The emitteddist/is unchanged. No API change. (#6830)
Contributors
Thanks to everyone who contributed to this release:
0.7.0
Breaking Changes
- Stop deriving live-region roles from
[Banner](/components/Banner).status. Banners are non-live by default; call[useAnnounce](/components/useAnnounce)from the actual async transition handler, or provide an explicitrole="status"for a persistent semantic mirror. (#6630)role="alert"is now opt-in rather than automatic for warning and error banners.Old usage:[Banner](/components/Banner)derivedrole="status"orrole="alert"from itsstatusvariant.Replacement: The caller sets the role explicitly, or announces with[useAnnounce](/components/useAnnounce).Migration: Call[useAnnounce](/components/useAnnounce)from the actual async transition handler, or provide an explicitrole="status"for a persistent semantic mirror.Codemod: None — the right announcement depends on the callsite. - Layout, MetadataList, NavHeadingMenuItem and TopNavMegaMenuItem now apply the BaseProps they accept (id, role, aria-*, data-*, hidden, inert, dir, event handlers; TopNavMegaMenuItem also xstyle/className/style) instead of silently dropping them; NavHeadingMenu keeps arrow navigation when an item handler cancels. (#7331) Migration: remove any of those props you passed that you relied on being ignored; a TopNavMegaMenuItem styled through xstyle/className/style now shows that styling.From #5656 by @harjothkhara.
- BottomSheet pads its content by default, like Dialog. With no
paddingprop and no theme padding, the content box now pads by--spacing-4(it had no padding before) and publishes that inset. (#6884) A sheet whose only child is a padded[Section](/components/Section)or a[Layout](/components/Layout)renders as before, because both escape the inset. Content that supplies its own inset is now padded twice: drop that inset, or passpadding={0}to keep the unpadded content box.astryx upgradeshipspreserve-bottom-sheet-content-padding, which addspadding={0}where needed.Migration: passpadding={0}to keep the unpadded content box, or drop your own inset to take the default;astryx upgradeaddspadding={0}to every BottomSheet that sets no padding unless its only child is a padded Section or a Layout. An app whose theme already setsbottom-sheetpadding on every edge is not affected by the new default; the codemod cannot see the theme, so remove thepadding={0}it adds there to keep the theme inset. A sheet whose content wraps a[Layout](/components/Layout)gets a TODO:padding={0}also removes the inset between that Layout's regions, which the Layout's ownpaddingdoes not restore. - Require
uploadon completeIconRegistrytypes (#7329) Old usage: A custom complete icon registry typed asIconRegistrythat omitted theuploadkey.Replacement:IconRegistrynow requires all semanticIconNamekeys, includingupload.Migration: Add anuploadentry drawn in your registry's icon style to complete icon registries typed asIconRegistry.Codemod: Noastryx upgradecodemod applies because icon artwork is bespoke design artwork tailored to each theme and cannot be automatically synthesized. - Move canonical data-color defaults from generated theme CSS to the public StyleX
dataVarsgroup. (#6834) ImportdataVarsfrom@astryxdesign/core/theme/dataTokens.stylexfor CSS-capable code. Canvas and other non-CSS APIs continue to useresolveThemeToken()or[useTheme](/components/useTheme)().token(). Rebuild committed theme CSS withastryx theme build; concrete themes now emit only explicitly authored data-color overrides.Old usage: Generated theme CSS owned the canonical--color-data-*root defaults.Replacement: The public StyleXdataVarsgroup in@astryxdesign/core/theme/dataTokens.stylexowns the defaults; concrete themes emit only explicitly authored data-color overrides.Migration: ImportdataVarsfrom@astryxdesign/core/theme/dataTokens.stylexfor CSS-capable code. Canvas and other non-CSS APIs continue to useresolveThemeToken()or[useTheme](/components/useTheme)().token(). Rebuild committed theme CSS withastryx theme build.Codemod:astryx upgraderunsvalidate-data-token-ownership, which rewrites nothing and reports fallback-lessvar(--color-data-*)uses (whole or embedded source strings, and stylesheets) and stale generated theme CSS for manual migration. - DateInput, DateRangeInput, DateTimeInput, and TimeInput no longer accept root
xstyle,className, orstyle. Style the field withcontainerXstyle/containerClassName/containerStyle(the Field box; no effect inside InputGroup or ahorizontal-labelsFormLayout) and the visual control box withcontrolXstyle/controlClassName/controlStyle. Base props such asref,id,data-*,aria-*, and DOM handlers reach the field's semantic control on every surface (the date, time, or date-time input; DateRangeInput's range trigger) instead of the wrapper, TimeInput no longer drops them, and a calleridis now honored there. A calleraria-describedbyis added to the component's own description ids, and a calleraria-labelledbyis read after the field's own label (on DateRangeInput, after its label and selected range); a calleraria-labelon DateRangeInput replaces the trigger's name. (#7337) Migration: rename rootxstyle/className/styleon these components tocontrolXstyle/controlClassName/controlStyle, which style the same element as before (for DateTimeInput, the row holding the date and time segments). Rename by hand, or runastryx upgrade; it runsmigrate-field-input-styling, which rewrites JSX usage; styling passed through a wrapper's own props or a spread is never rewritten and now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored. A DOM handler ordata-*attribute that relied on landing on the wrapper now lands on the control; a handler still runs after the component's own and still receives events the component handled.From #5656 by @harjothkhara. - Typeahead, Tokenizer, CheckboxList, RadioList, and Slider no longer accept root
xstyle,className, orstyle. Style the field withcontainerXstyle/containerClassName/containerStyle(the Field box; no effect inside InputGroup or ahorizontal-labelsFormLayout) and the visual control box withcontrolXstyle/controlClassName/controlStyle. Base props now reach the primary semantic control: the combobox input for Typeahead and Tokenizer, therole="group"/role="radiogroup"element for CheckboxList and RadioList, and therole="slider"thumb for Slider (therole="group"control in range mode). A calleraria-describedbyis kept alongside the field's own description and status, on these components and on TextInput, TextArea, and NumberInput, which previously dropped it. CLI templates use the new props. (#7339) Migration: rename rootxstyle/className/styleto the part they styled before:containerXstyle/containerClassName/containerStyleon all five components, except a Typeahead inside InputGroup, whose root styling painted the control surface and moves tocontrolXstyle/controlClassName/controlStyle. The release'sastryx upgradecodemod,migrate-field-input-styling, performs these renames on JSX usage.Not rewritten by the codemod, so update by hand:refandid, plusdata-*(except Typeahead and Tokenizerdata-testid, which marked the control surface),aria-*, and DOM event handlers such asonClick, previously landed on the outer Field (or were dropped by RadioList and Slider). They now land on the primary semantic control. Update code that measured, queried, or listened on the outer field, and wrap the component in your own element when you need an outer boundary.- Typeahead and Tokenizer refs are now
HTMLInputElement. - A consumer
onKeyDownon Typeahead or Tokenizer still runs after the built-in key handling, cannot cancel it, and still fires for keys on the clear button and tokens; for keys on the input it now runs on the combobox input itself. - RadioList and Slider used to drop DOM event handlers; they now run after the component's own handling, so a Slider
onPointerDown,onKeyDown,onFocus, oronBlurthat never fired before now fires (on the thumb, or on the group in range mode). - Tokenizer's
onFocus/onBlurkeep their meaning: focus entering or leaving the field. - Styling passed through a wrapper's own props or a spread is not rewritten and now fails type-checking at that callsite.
Untyped callers get a development warning and the value is ignored.From #5656 by @harjothkhara. - Selector, MultiSelector, and ComplexSelector no longer accept root
xstyle,className, orstyle. Style the field withcontainerXstyle/containerClassName/containerStyle(the Field box; no effect inside InputGroup, ahorizontal-labelsFormLayout, or withrenderTrigger) and the visual control box withcontrolXstyle/controlClassName/controlStyle. Base props such asref,id,data-*(includingdata-testid),aria-*, and DOM handlers reach the trigger button that carries the combobox role (or, withrenderTrigger, the caller's control), and a calleraria-describedbyis kept alongside the field's own description and status instead of being replaced. Handlers keep their existing order: a ComplexSelectoronClickon its own trigger can still cancel opening, and newly forwarded handlers (including those reaching arenderTriggercontrol) run after the built-in toggle and keyboard handling. CLI templates use the new props. (#7341) Migration: rename rootxstyle/className/styleon these components tocontrolXstyle/controlClassName/controlStyle, which style the same element as before. Not a rename: adata-testidor other base prop now lands on the trigger button rather than the bordered box around it (query the box with.closest()if a test measured it), and withrenderTriggerbase props andrefnow reach the caller's control. Rename JSX usage by hand, or runastryx upgrade; it runsmigrate-field-input-styling, which does not follow styling passed through a wrapper's own props or a spread, which now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored.From #5656 by @harjothkhara. - TextInput, TextArea, NumberInput, and FileInput no longer accept root
xstyle,className, orstyle. Style the field withcontainerXstyle/containerClassName/containerStyle(the Field box; no effect inside InputGroup or ahorizontal-labelsFormLayout) and the visual control box withcontrolXstyle/controlClassName/controlStyle. Base props such asref,id,data-*,aria-*, and DOM handlers reach the native control, and a calleridis now honored there. CLI templates use the new props. (#7336) Migration: rename rootxstyle/className/styleon these components tocontrolXstyle/controlClassName/controlStyle, which style the same element as before.astryx upgraderewrites JSX usage; styling passed through a wrapper's own props or a spread is not rewritten and now fails type-checking at that callsite, so rename it there. Untyped callers get a development warning and the value is ignored. Not rewritten by the codemod: a calleridused to be replaced by a generated one and now reaches the native control (the label stays associated), so remove anidyou passed but relied on being ignored. Other base props already reached the native control and are unchanged.From #5656 by @harjothkhara. PowerSearchFilterEditorno longer callsonSavewhen it opens on an already-complete empty-operator filter (such as "is empty"). (#7347) Old usage: opening a standalonePowerSearchFilterEditoron a complete empty-operator filter saved that filter immediately, with no Apply rendered for it, and saved it again whenever the editor remounted.Replacement: the editor saves only from a user choice in it. Opening it saves nothing.Migration: if you relied on that save-on-open, call your ownonSavehandler with the filter at the point where you open the editor (or skip opening the editor for empty-operator filters, as PowerSearch now does). This cannot be rewritten by a codemod, because the right place to commit depends on your code.- Remove the deprecated component-theming compatibility surface scheduled for 0.7.0. Components now emit only canonical target classes and reflected
data-*prop/state selectors. Theme discovery and build output no longer expose deprecated targets, andThemePropsOptionsplusComponentThemingTarget.deprecatedForare removed. Thetheme targets --jsonresponse drops theThemeTargetEntry.deprecatedForfield, because no target it lists is deprecated. (#7302) Migration: run the required codemodmigrate-deprecated-theme-surfacewithastryx upgrade --from <your 0.6 version> --apply --path .after upgrading.The codemod renames removed target keys inside themecomponentsmaps (an importeddefineTheme()call, an object typed as an Astryx theme, or a theme object with a staticname), renames target classes in CSS, and replaces target-qualified bare prop/value/state classes with reflecteddata-*selectors, using every bare class the final 0.6 release emitted. It leaves dynamic/computed theme keys, unqualified or unknown classes, and CSS embedded in JavaScript/TypeScript strings for manual review. It addsTODO(astryx upgrade)when old and canonical keys coexist, and when a bare class Astryx once emitted has no known meaning on the target it qualifies.The four per-component clear-icon aliases all become the sharedinput-clear-icon, which styles every input's clear icon. In CSS the codemod keeps each rule on its component with:where(.astryx-<component> *), which adds no specificity. Theme keys cannot carry that scope, so the codemod adds a TODO naming the CSS selector to use.Code that passed{legacyNames}tothemeProps()or setdeprecatedForin a component doc should delete that argument or field; the canonical target is unchanged.Rename theme keys and CSS target classes with this complete mapping:base-table→tablecheckbox→checkbox-indicatorcodeblock→code-blockcodeblock-copy-button→code-block-copy-buttoncodeblock-header→code-block-headercodeblock-title→code-block-titledate-input-clear-icon→input-clear-icondate-range-input-clear-icon→input-clear-iconhovercard→hover-cardmulti-selector-clear-icon→input-clear-iconnavicon→nav-iconpopover-surface→popoverprogressbar→progress-barprogressbar-fill→progress-bar-fillprogressbar-mark→progress-bar-markprogressbar-track→progress-bar-trackradio→radio-indicatorradio-dot→radio-indicator-dotselector-clear-icon→input-clear-iconstatusdot→status-dottextarea→text-area
For custom CSS, replace removed bare selectors with the corresponding reflected attribute on a canonical target—for example,.astryx-button.primary.smbecomes.astryx-button[data-variant="primary"][data-size="sm"], and.astryx-switch.checkedbecomes.astryx-switch[data-checked="checked"]. Review unqualified classes such as.primarymanually because they may be application-owned. - Remove the deprecated
emptySearchResultsTextprop. UseemptySearchText. (#7289) Old usage:emptySearchResultsTexton[Tokenizer](/components/Tokenizer),[Typeahead](/components/Typeahead), and[BaseTypeahead](/components/BaseTypeahead), and theemptySearchResultsTextkey on a[ChatComposerInput](/components/ChatComposerInput)trigger.Replacement:emptySearchText, shipped in 0.6.6. It takes aReactNode, so every old string value stays valid. The old name is no longer in the types and is no longer read; a JavaScript caller that still passes it sees the default empty message.Migration: RenameemptySearchResultsTexttoemptySearchText. Where both are set, keepemptySearchTextand delete the old one — unlessemptySearchTextcould benullorundefined: 0.6.x then fell back to the old value, so move that value intoemptySearchText(for exampleemptySearchText={value ?? 'Old copy'}).Codemod:astryx upgraderunsrename-empty-search-results-text, a straight rename at the JSX boundary: the prop on imported[Tokenizer](/components/Tokenizer),[Typeahead](/components/Typeahead), and[BaseTypeahead](/components/BaseTypeahead)elements, and the key on trigger objects written inline in[ChatComposerInput](/components/ChatComposerInput)'striggers, each renamed as written. Like every Astryx codemod it does not follow variables, helpers, spreads, wrappers, or types; where it cannot attribute the value —emptySearchTextalready set, any spread onto one of these elements (whether or not the element writes the old name), atriggersvalue not written inline, a trigger object with a spread or computed key (whether or not it writes the old name) — it leaves a TODO instead of choosing a winner. The type checker reports any literalemptySearchResultsTextit did not reach; the TODOs cover the values that reach an element through a spread, which it cannot. reset.cssnow reaches::before,::after,::placeholderand the search field's cancel button, as its comments document. Three of its rules wrote the pseudo-element inside:where(), where pseudo-elements are invalid, so browsers dropped those parts of the selector and the rules never applied to them. Each pseudo-element now follows the:where(), as in:where(*)::before, and the rules stay in@layer reset, so any later layer or unlayered style still overrides them. (#7355) What changes on a page that loads the reset: a::beforeor::afterwith padding or a border used to size ascontent-boxand now sizes asborder-box; setting onlyborder-widthon one used to draw nothing and now draws a solidcurrentColorborder; a placeholder with no color of its own used to show the browser's grey and now shows--color-text-secondary(or that token's own default,light-dark([#4](https://github.com/meta/astryx/pull/4)E606F, #AAAFB5), when no Astryx CSS defines it); and atype="search"field no longer shows the browser's cancel button.To keep the old result for one of your own elements, set it in your own CSS:box-sizing: content-boxorborder-style: noneon the pseudo-element, acoloron the::placeholder, orappearance: autoon the field's::-webkit-search-cancel-button. There is no codemod: whether a stylesheet relied on the old result cannot be read from its source.- Spacing tokens are rem (
--spacing-2: 0.5rem), so gaps and padding follow the reader's root font size the way the type scale does. Every token value is unchanged at the default 16px root. (#7359) One change shows at the default root: the[useTableRowExpansion](/components/useTableRowExpansion)chevron now sits centered in its fixed 40px column instead of running past its edge (its button moves from 24–48px to 8–32px of the column). Under a theme with a larger spacing scale, such as matcha, the chevron is visible again and the detail panel lines up with the first column instead of starting 20px past it.Old usage: The--spacing-*defaults were fixed px (--spacing-2: 8px), so[useTheme](/components/useTheme)().token(),resolveThemeToken(),tokenDefaultsandspacingDefaultsreturned px strings, and spacing stayed the same size when a reader raised the browser font size.Replacement: The defaults are rem with the same value at a 16px root (--spacing-2: 0.5rem,--spacing-4: 1rem), and those readers return the rem string.Migration: CSS that readsvar(--spacing-*)needs no change. Code that parses a spacing token as a px number converts the rem value with the root font size, or reads the element's computed length. A theme that wants fixed px spacing sets the tokens back, for exampledefineTheme({tokens: {'--spacing-2': '8px'}}).Codemod: None. A token read and parsed at runtime cannot be found and rewritten statically, and CSS uses need no rewrite.
New Features
[DropdownMenu](/components/DropdownMenu)takesheaderandfooter: content above and below the rows that sits in the popover beside the menu, never inside it. This is the place for a filter field or a "Create" button. The menu still holds only its rows, so it stays a valid menu to a screen reader. The controls keep their own keys and presses, and Tab walks header, menu, footer. The bottom sheet shows them above and below the actions. (#7344)[DropdownMenuSubMenu](/components/DropdownMenuSubMenu)passes host attributes, DOM event handlers and arefto its trigger row, as[DropdownMenuItem](/components/DropdownMenuItem)does: a sub-menu row can carryaria-keyshortcuts, adata-*mark or anid, and a caller can reach the row element. The row keeps its own role, tab stop and popup state; a caller'sonClick,onKeyDown,onPointerMove,onMouseEnterandonMouseLeaverun after the row's own handling, except for an event the row consumes: the keys that open the flyout (the open arrow, Enter and Space) and a click on a disabled row. A caller'sidnames the row the flyout is labelled by. (#7318)
Fixes
- A standalone
[BottomSheet](/components/BottomSheet)now joins the shared layer dismissal stack, so one Escape press closes only the top-most layer. A Popover, Dialog, or menu opened inside the sheet closes first, and the next press closes the sheet.purpose="required"still blocks Escape without letting the press close a layer behind it, a sheet that is animating out keeps the press, and the native close request answers with the same top-most and IME composition rules. (#7225) [ContextMenu](/components/ContextMenu)puts only its four touch handlers on the trigger element. It used to spread everything[useLongPress](/components/useLongPress)returns, which since the press model includes the hook's imperativestart,moveToandcancel, so React warned "does not recognize themoveToprop" and "Invalid values for propsstart,cancel" on the first ContextMenu of a page. Long-press opening is unchanged. (#7322)- DateInput: run changeAction with optimistic busy feedback on the native picker surface (#7243)
- Dialog's initial focus and the focus it returns on close now follow the last input: the shared focus indicator is hidden after a mouse click or tap and shown after keyboard input, including focus returned after a keyboard open and a mouse close (#7306). Text fields keep their own focus treatment. (#7313)
- A DropdownMenu hung off its own control through
renderTriggernames a drilled-in sub-menu's Back row after the menu: "Back to <the menu's aria-label>", or the name of the control it hangs off, instead of "Back to Menu". (#7304) - Lightbox shows the next or previous image unzoomed from its first frame. The zoom and pan reset when the image changes now happens in the same update, instead of painting the new image at the previous image's zoom for one frame. (#7351)
- With
markdownSourceLinesPlugininstalled, a transform plugin no longer falls back to its readable fallback on documents that contain a list or a quote. Blocks nested in a list item or a quote carry lines without offsets, and the transform check now accepts those Core-assigned lines while still refusing a transform that adds, shifts, or forges them. (#7345) - A two-finger pinch over an open DropdownMenu, sub-menu flyout, ContextMenu or Selector list now zooms the page. The menus declared
touch-action: nonewhile their rows fit andpan-yonce they scroll, and neither allows a pinch, so a phone could not zoom the page while a menu was open. They now declarepinch-zoomandpan-y pinch-zoom; a one-finger slide over the rows and the press model behave as before. (#7201) - DropdownMenu, ContextMenu and sub-menus no longer special-case text fields and buttons placed among their rows. This reverts an unreleased change. A menu holds only menu items; a control that is not a row belongs outside the menu. (#7338)
- The PowerSearch filter editor saves an "empty" operator filter (such as "is empty") exactly once, from the choice that completes it. Choosing such an operator, or switching to a field whose default operator is one, now saves from that choice instead of from an effect. The filter is no longer saved again when the parent re-renders with a new
onSave, or twice in React StrictMode. Re-choosing the current operator or field saves nothing, and focus still returns to the search input after the editor closes. Clicking an existing empty-operator token in PowerSearch commits it once without opening the built-in editor; acomponents.empty.Editoroverride still opens. (#7347) - The PowerSearch filter editor saves once when a value that saves on choice is picked (an enum option, a relative-date preset, a suggestion). The save no longer runs inside a React state updater, which React may call more than once, so it no longer fires twice in StrictMode. (#7350)
- Toasts stay visible and clickable while a Dialog is open. The
ToastViewportfrom[LayerProvider](/components/LayerProvider)(or the one[useToast](/components/useToast)mounts on its own) now moves into the open Dialog, and back when it closes. Before, a Dialog opened after the viewport mounted painted over it, and clicking a toast's close button hit the backdrop and closed the Dialog. Moving the viewport does not reset visible toasts or their timers. A viewport rendered withisTopLayer={false}keeps rendering in place. (#7238) - DateTimeInput's touch picker no longer paints a stale frame. Clearing the value from outside clears the time display in the same update, instead of showing the previous time for one frame, and narrowing
max(or raisingmin) while the sheet is open keeps the visible month in range in the same update, instead of showing the out-of-range month and then jumping. (#7349)
Performance
- An
[Item](/components/Item)withoutswipeActionsno longer bundles the swipe gesture. The panels and the drag that uncovers them now live in a module[Item](/components/Item)loads on demand the first time a row has swipe actions, so an app whose rows never swipe ships about 2.7 KB (gzip) less on its first load and a row that does swipe keeps its DOM, props and behavior; its gesture becomes live once that module has arrived, which on a first load is a moment after the row paints. (#7296)
Documentation
- Describe
[CommandPaletteList](/components/CommandPaletteList)as the list[CommandPalette](/components/CommandPalette)renders itself, and as a component to render directly only for a standalone results list. (#7370)
Contributors
Thanks to everyone who contributed to this release:
0.6.8
New Features
[useTableColumnResize](/components/useTableColumnResize)now reveals its handles when the pointer enters the header. The boundaries were only drawn once the pointer was already within a handle's 8px hit area, so a resizable column gave no sign it could be resized. Every boundary now appears at border weight while the header is hovered, and the handle under the pointer still takes accent. The reveal holds while the table is scrolling sideways, so a boundary arriving under a still pointer is not mistaken for intent, and focusing a handle emphasizes that one boundary without drawing its neighbours. Pointer-only: where nothing can hover, nothing is revealed. (#6194)[DropdownMenuItem](/components/DropdownMenuItem)passes host attributes and DOM event handlers to its row, as[DropdownMenuCheckboxItem](/components/DropdownMenuCheckboxItem),[DropdownMenuRadioItem](/components/DropdownMenuRadioItem)and[Item](/components/Item)already do (#7196): a row can carryaria-current,aria-busy, adata-*mark, anid, or drag-and-drop handlers. The row keeps its own role and tab stop; a caller'sonPointerMoveandonAuxClickrun after the row's hover focus and middle-click close.- Add
markdownSourceLinesPluginto@astryxdesign/core/[Markdown](/components/Markdown)/plugins(#7286). With it installed, every block[Markdown](/components/Markdown)renders, nested blocks included, carriesdata-source-lineanddata-source-line-end: the 1-based, inclusive lines it came from. That lets a host map a selection, search hit, or comment back to the exact Markdown lines.componentsblock renderers receive a matchingsourceLinesprop, and plugin renderers read lines fromnode.position. The lines come from the parse[Markdown](/components/Markdown)already runs, and without the plugin nothing changes.
Fixes
- Preserve AppShell page content, local state, and input focus when the elevated layout crosses the mobile navigation breakpoint (#7236).
- Calendar now accepts null as an explicit controlled empty value (#7297). DateRangeInput announces required state through a valid button description, keeps pending values in its accessible name, and clears Calendar selection without reviving the previous range.
- Keep DateTimeInput's calendar selection empty after clearing the field (#7298).
- A DropdownMenu that a finger held on its trigger opens (after the long-press delay) stays open when that finger lifts on the trigger (#7241). The browser's light dismiss read the lift, outside the menu, as a press outside and closed the menu at once; the trigger is now held as the menu's invoker through the press, as it already was for a mouse press.
- A mouse press on a
[DropdownMenuItem](/components/DropdownMenuItem)link row (href) that moves a few pixels no longer starts the browser's link drag (#7197). The drag cancelled the press, so the highlight stopped following the mouse and the row under the release never acted; a press dragged from one link row to another now acts on the second, as it already did for rows without an address. Link rows renderdraggable="false". - Kbd: use primary text color token to meet WCAG AA contrast over neutral keycaps (#7100)
The default
<kbd>text color has been updated to--color-text-primary, ensuring visible key glyphs exceed the 4.5:1 WCAG AA contrast ratio against the--color-neutralkeycap background across all light and dark themes. - Stepper: a Stepper inside a layer opened from a step no longer picks up the outer Stepper's
--step-connector-gap(#7287). Layer content roots (Popover and other[useLayer](/components/useLayer)surfaces, Dialog, BottomSheet, MobileNav, Lightbox, and the toast viewport) now stop that value, so the inner track starts from its0pxdefault. Setting the gap on the inner Stepper or through thesteppertheme target still works, and the gap still inherits normally outside layers. [Markdown](/components/Markdown)renders a fence that acreateMarkdownFenceTransformplugin claims through that plugin even whencomponents.codeis supplied (#7284). A host that drew its own code blocks lost every semantic fence, so a diagram or chart fence showed as code.components.codenow renders every fence no plugin claims, and stays the fallback when a claimed fence's renderer declines, throws, or suspends. Hosts with only one of the two render as before.- Keep Table column resize handles accessible, contained, and compatible with sticky columns (#6194). Resize handles stay keyboard-reachable on touch-first devices instead of disappearing from the accessibility tree. They no longer extend below the table and create stray vertical scrolling, and sticky headers keep their pinned positioning regardless of plugin order.
Contributors
Thanks to everyone who contributed to this release:
0.6.7
New Features
[Item](/components/Item)gains swipe actions for touch, perspec:AST-057.swipeActionsdeclares, per side, the verbs a sideways drag uncovers asItemSwipeAction[]({id?, label, icon?, onActivate, isDisabled?, variant?: 'neutral' | 'accent' | 'destructive', hasRemoval?}, outermost last);swipeBehaviorisreveal(the row rests open with every entry a real button; a long drag or a fling fires the outermost) orcommit(the row slides out and the outermost fires; nothing rests). After an entry fires the row springs back, or holds out when the entry hashasRemoval. A mouse never starts the drag, a mostly vertical drag stays the scroller's, a resting row closes on a pointer outside it. Available on a row whose role permits interactive descendants (alistitem, a role-less row);[ListItem](/components/ListItem)passes both props through. No element is added to a row: its root translates and its panels counter-translate.[List](/components/List)clips its rows in the inline axis (overflow-inline: clip). TypesItemSwipeAction,ItemSwipeActions,ItemSwipeActionVariantandItemSwipeBehaviorare exported.- Drawer is a container, like Dialog. A new
paddingprop takes a spacing step, and a theme'spaddingondrawerpads the drawer's scrolling content area through container tokens instead of padding the panel. The padded content area publishes its inset, so a Section that is the drawer's only child, and bleed children such as Table and Divider, align against it, and a Layout inside picks the value up for its header, content, and footer regions. With neither set, the inset is--spacing-4, as in Dialog; passpadding={0}for a full-bleed content area. The block-end safe-area inset is preserved in every mode. - An option can carry a secondary action;
[MultiSelector](/components/MultiSelector)renders it in a grid.SelectorOptionDataandSearchableItemgainaction?: ReactNode: one node the caller renders and names — an[IconButton](/components/IconButton), a[Button](/components/Button), a menu trigger. In[MultiSelector](/components/MultiSelector), once any option carries one the popup is arole="grid"whose rows pair the option with its action: Up/Down move rows, the inline-end arrow reaches the action (following RTL), Enter fires it, pointer and touch press it directly, and pressing it never changes the selection. The trigger advertisesaria-haspopup="grid". Nothing changes for options without an action.[Selector](/components/Selector)and the typeahead panel do not render the key yet and warn in development when an item carries one. [useTableRowExpansion](/components/useTableRowExpansion)acceptspanelVariant, and the detail panel now sits on the surface behind the table by default instead of on a wash of its own. (#5995) The panel row painted--color-background-mutedunconditionally, and being a<tr>the plugin builds itself, nothing a caller rendered could reach it.The panel is the row's continuation, not a surface of its own, so it now takes whatever the table sits on — the same thing the row does. That keeps the plugin unopinionated about the table's background: a table on a[Card](/components/Card)no longer stacks a third surface, and a striped table no longer paints a band in the same token as its own stripe, which read as a data row rather than as a detail.panelVariant: 'muted'keeps the wash for the case that wanted it — a bare table with no card, no dividers and no striping, where nothing else separates the panel from the data around it.This changes the default appearance. A table relying on the wash gets it back withpanelVariant: 'muted'; in dark themes there is nothing to get back, because--color-background-mutedis a low-alpha near-black that is close to invisible over a dark card — dark has effectively been renderingtransparentall along.[useTableRowExpansion](/components/useTableRowExpansion)acceptshasRowClickExpansion, so a row opens when you click anywhere on it and not only on its chevron. (#5995)[useTableTreeData](/components/useTableTreeData)has had this since it shipped, under the same name and with the same behaviour. The detail-panel plugin is the other half of the same pair — one expands into child rows, one expands into a panel — and a caller who moved between them lost whole-row clicking without anything saying why. There was no way to add it back either: a click handler on the row has to know not to fire on a checkbox, a link or the end of a text drag, and none of that is reachable from the outside.Off by default, and pointer-only when on. The chevron button stays the accessible control, so keyboard and assistive-tech users are unaffected — this adds a shortcut for a mouse, not a second way to operate the table. Clicks that land on interactive cell content, clicks that end a text selection, and clicks on rowsgetIsItemExpandablehas ruled out all pass through untouched. The chevron already stops propagation, so it does not toggle twice.Collapsed rows are wired up as well as expanded ones, which is most of the point: the row you want to click is the one that has not opened yet.
Fixes
- A BottomSheet drag writes its transform straight to the sheet once per input sample and renders nothing in between (React state changes when the drag begins and ends, and when its layout split changes). Measured in Chromium: 4 commits for a 24-sample drag, down from 49. The release still animates from wherever the finger left the sheet.
- BottomSheet hands a touch to the sheet at the scroll edge of the box under the finger, not the body's alone. Content that scrolls inside the body (a pinned header and footer around a scrolling middle, a grid) never moved the body's
scrollTop, so every pull down over that scrolled box dragged the sheet and the box could not be scrolled back by hand. From the box's top the pull still drags the sheet. - BottomSheet no longer blocks pinch-zoom. A pinch that started on an open sheet (its handle, its content, or across both) did nothing, because the sheet claimed every touch gesture:
touch-action: noneon the sheet and handle,pan-yon the content. The sheet now leaves pinch to the browser (pinch-zoom, andpan-y pinch-zoomon the content), and a second finger (on the handle, on the content, or off the sheet, whichever lands first) ends any sheet drag in flight or about to start, so the page zooms and the sheet stays at its detent. One-finger drag and scroll are unchanged. - A BottomSheet release is judged where the sheet would coast to at the finger's speed, not where the finger left it: a medium throw dismisses from short of the dismiss line and a gentle throw lands on the next detent instead of snapping back, the release speed is read over the finger's last 100ms rather than its last two samples, and a finger that rests before lifting releases no throw. A nudge under 48px still projects nothing.
- A DropdownMenu opened by a mouse press returns focus to its trigger when it closes, instead of to the control that was focused before the press. A mouse opens the menu on press-down, before the browser's own mousedown has focused the trigger, so the popover remembered the previously focused control and handed focus back there on Escape or after a pick. The trigger now takes focus as the press opens the menu, the state a click-open already had; keyboard opens, taps and the menu's own behavior are unchanged.
- A field status shown with
statusVariant="tooltip"is now announced to screen readers when it appears or changes, the same way the attached and detached message boxes are: errors assertively, warnings and successes politely. Before, the tooltip placement only described the control, so a screen-reader user was not told that a validation message had appeared until they left and re-entered the field. This affects every input that offers the tooltip placement. The attached and detached placements are unchanged and are still announced once. - FileInput: invoke changeAction and update optimistic state on clear and file selection
- swizzle: rewrite every .stylex import to a deep path
astryx swizzle [Button](/components/Button)(and any component that imports a.stylexmodule from outside its own directory) emitted an import that collapsed to the directory barrel — e.g.@astryxdesign/core/utilsinstead of@astryxdesign/core/utils/interactionOverlay.stylex. The barrel does not re-export those StyleX symbols, so the swizzled file could not compile.rewriteImportsnow gives every*.stylexmodule the deep subpath. The exports generator (scripts/sync-exports.js) adds 16 specific subpath exports for the.stylexmodules swizzled components actually reference across directories:[DateInput](/components/DateInput)/tokens.stylex,[Icon](/components/Icon)/IconSize.stylex,Indicator/indicator.markers.stylex,Layer/layerAnimations.stylex,Layer/layerTextReset.stylex,Layer/layerViewportInset.stylex,[Layout](/components/Layout)/container.stylex,[Layout](/components/Layout)/edgeCompensation.stylex,[Layout](/components/Layout)/padding.stylex,NavItem/navItemStyles.stylex,[Selector](/components/Selector)/selectorPresentation.stylex,[Stack](/components/Stack)/stack.stylex,[Stack](/components/Stack)/stackItem.stylex,[Text](/components/Text)/text.stylex,utils/focusOutline.stylex,utils/interactionOverlay.stylexThese are public API additions. Each module already ships in the npm tarball (indist/); only the exports map entry is new. No wildcard — a future cross-directory.styleximport needs a deliberate entry inSTATIC_EXPORTS. Precedent:./theme/dataTokens.stylex(AST-066 FR2). - Keep grouped-row custom headers full-width while pinning their 16px disclosure button, and expose expansion state on the button. (#6251)
- Keep grouped-row collapse chevrons pinned without shrinking custom headers, and increase them from 12px to 16px (#6222)
- Keep layer portals inside their nearest dialog
- Markdown: read an indented table with its own columns
[Markdown](/components/Markdown)no longer adds an empty first column to a table whose rows are indented, such as| a | b |. The indentation before a row's first pipe used to read as a cell of its own. - Markdown: keep a definition-shaped line whose label is over 999 characters
[Markdown](/components/Markdown)no longer drops a line shaped like a link reference definition whose label holds more than 999 characters. CommonMark allows no such definition, so the line now shows as text, as a reference with that label already did. - Markdown: end a code block left open at the end of a message on its last line of code
When a message ended inside a code block that was never closed,
[Markdown](/components/Markdown)read the message's final line ending as one more, empty line of code, unlike a closed code block and unlike the streamed render of the same message. A real blank line before the end is still code, and while a message streams, an open code block now shows the blank lines already written instead of adding them later. - Markdown: keep a quoted blank line at the end of a code block left open A code block left open inside a block quote keeps a blank quoted line at its end as code, as CommonMark reads it. Only the document's own final line ending is left out of an open code block.
- Markdown: keep two lists apart while streaming when their bullets or indentation differ
While a message streamed,
[Markdown](/components/Markdown)joined two lists a blank line apart whenever both were bulleted, or both numbered with the same delimiter — even when their bullets (-then*) or indentation differed, where the finished document shows two lists. The streamed render now keeps them apart, as the finished document does. - MobileNav no longer blocks pinch-zoom while it is open. The open nav covers the whole viewport and declared
touch-action: none(withpan-yon its content), so a pinch anywhere on screen did nothing. It now declarespinch-zoom(andpan-y pinch-zoomon the content): pans are still kept from reaching the page behind, and a pinch zooms the page. - MultiSelector: name the listbox of a bottom sheet without search from the component's label, so screen readers announce it
- Added a
@astryx.richTextEditor.*catalog namespace to the shared message catalog, so the RichText editor's toolbar labels, block-format options, link dialog, and Tab escape hint can be translated and overridden through[InternationalizationProvider](/components/InternationalizationProvider). The editor's character counter now announces through the existing@astryx.textArea.characters*messages, so it is translated in every locale TextArea already ships. - In a collapsed SideNav, pressing a SideNavHeading menu trigger right after hovering it now keeps the hover-opened menu open, as the click guard intends. The browser was dismissing the menu on the press because the trigger sat outside the panel; the collapsed trigger is now the panel's native invoker, the same wiring TopNavMenu uses.
- Keep editable content from toggling tree and expansion rows
The shared click guard that row-expansion and tree-data use to decide whether a row click should toggle missed
[contenteditable]elements. Clicking or typing inside editable content in a row toggled it. Restored the exclusion with tests on both paths. - Whole-row-click expansion reuses the shared clickable-container guards instead of its own selector list. (#5995)
[useTableRowExpansion](/components/useTableRowExpansion)and[useTableTreeData](/components/useTableTreeData)each carried a hand-rolled copy of "did this click belong to something else" — the same nine selectors, written twice.[useClickableContainer](/components/useClickableContainer)already owns that rule for every clickable surface in the system, and itsINTERACTIVE_SELECTORSlist is the fuller one: it also coversrole="link",radio,switch,tab,menuitem,option,combobox,listbox,slider,spinbuttonand[data-pressable-container], and it excludes[aria-readonly="true"].Both plugins now call the hook'shasInteractiveAncestorandhasTextSelection, newly exported for containers that cannot use the hook itself — a<tr>assembled insidetransformBodyRowhas no ref to hand it.Two behaviour changes fall out of sharing, both fixes: - Turn only the chevron glyph in
[useTableRowExpansion](/components/useTableRowExpansion), not the button beneath it. (#5995) The rotation was on the<button>, which is the hit target and carries the hover chip, so opening a row swung that rounded rectangle and its highlight a quarter turn along with the arrow — most visible mid-animation, where the chip passes through a diamond. A finished 90° turn on a 24px rounded square lands back on itself, which is why this only shows up in motion.The transform now sits on the glyph and the button stays put. The two transitions move onto--duration-fastand--ease-standardin the same pass, matching what[TableRow](/components/TableRow)already uses for its own hover transition. - Draw the row divider below a
[useTableRowExpansion](/components/useTableRowExpansion)detail panel rather than above it. (#5995) An expanded row and its panel are one unit, but the divider was landing between them: the row drew its own bottom border, which put a line between the row and the detail it had just opened, and the panel drew none, so it ran flush into the next row. Both halves of that are backwards — the pair was split down the middle and then fused to the row below.The expanded row now gives up its border and the panel takes one. On a table with no row dividers the suppression removes a border that was never there and the panel's is never applied, so neither side has to consult the divider mode; only the panel does, to know whether to draw at all. The panel row carriestableRowMarker, which is how[TableCell](/components/TableCell)scopes its "no trailing line under the last row" rule, so an expanded last row still ends the table cleanly. - Start the
[useTableRowExpansion](/components/useTableRowExpansion)detail panel at the first column rather than at the row edge. (#5995) The panel is one cell spanning the whole row with a flat20pxinline padding, so its content began under the chevron — a column to the left of every label it describes.It now indents by the chevron column's fixed width plus the inline padding a cell of that density gives its own content, read off the table context so it followsdensity, and written as a logical property so RTL mirrors it. It is not configurable: a panel starting anywhere else reads as a misalignment rather than as a choice.The chevron column's width cannot be a token reference — the layout does arithmetic on it — but it is the pixel value of--spacing-10, which is how the indent spells it. A test pins the two together so a change to the scale cannot silently unalign them. [Table](/components/Table)zebra striping counts data rows only, so expanding a row no longer inverts the stripe of every row below it. (#5995) A row-expansion detail panel is appended as a sibling<tr>in the same<tbody>, and striping is:nth-child(even)— so the panel took a stripe turn of its own and pushed every row after it onto the opposite one. Opening a single row repainted half the table.The stripe now counts:nth-child(even of :not([data-expansion-panel])). A panel is not a row and is not counted as one, so the data rows keep their parity whatever is open.of Shas been Baseline since 2023, inside Astryx's support floor (AST-013). Below it the stripe rule is dropped rather than misapplied: an unstriped table, not a mis-striped one.Tables without the row-expansion plugin are unaffected — nothing else in the system emitsdata-expansion-panel.- Table columns without an explicit width now keep a compact readability floor and use the existing horizontal Scroll region when their combined minimums do not fit.
Documentation
- The README's CDN template command and the icon and token hints in the DropdownMenu item and Indicator docs name the scoped
npx @astryxdesign/cli, which runs this CLI whether or not it is installed. Barenpx astryxfetches an unrelated npm package until the CLI is a dependency. - align statusVariant documentation and test coverage across ComplexSelector, Tokenizer, and Typeahead
Other Changes
- A click on a composed control the short list missed — a
role="tab", a segmentedrole="radio", a[Slider](/components/Slider)in a cell — no longer toggles the row underneath it. - The text-selection guard is scoped to the row instead of asking the document for any selection at all. Text selected elsewhere on the page no longer makes every row in the table inert.The walk also stops at the row rather than climbing to
document.body, so an interactive ancestor of the whole table cannot suppress row clicks.
Contributors
Thanks to everyone who contributed to this release: