What's New
Release notes and changelog for all packages.0.7.11
New Features
astryx buildranks Core blocks of component families its picker was not fitted with somewhat better: the block picker's doc-side word weights are refitted from paraphrases of each block's own source. (#10355)
Fixes
astryx buildnames its two alternative page templates in the same order it chooses the start from, so the three templates it shows for a whole page are its best three. The start, the number of alternatives, the blocks and the JSON shape are unchanged. (#10357)astryx build --type docand--type themenow point toastryx search <query> --type docor--type theme: a build kit has no docs or themes, so build says so once on stderr and names the search that finds them. Stdout, JSON output and exit codes are unchanged. (#10401)astryx doctorno longer warns that no theme is wired in an app that imports its themes itself. Without a generated theme module or a package.jsonastryx.theme, thethemescheck now passes when the source of the app imports a theme's built module or stylesheet (the importstheme addwrites) or passes a theme toTheme, followed through module-scope variables,defineTheme({extends}), re-exports and installed packages to its package, and names the file. Only a theme whose package is installed, or a local theme, counts. A theme passed toThemethat doctor cannot trace (a prop, a function result, a variable declared inside a component) is reported as not confirmed (info), not as missing. (#10353)- The CLI's semver range check reads
^0as any 0.x.y and^0.0as any 0.0.y, and reads a hyphen range (1.0.0 - 2.0.0) as inclusive bounds, with a partial upper bound (1.0.0 - 2) covering its whole series as npm does. Before,^0and^0.0were locked to a single patch version and a hyphen range could never match, soastryx doctorand the peer-version checks reported a false mismatch for projects that declare those ranges. (#10184) - The reminder to run
astryx initin a project that has not run it no longer prints before every command. It now prints after a command that succeeds, at most once a day per project, recorded in the per-user state as the daily hints are. It does not print with--json, after a command that fails, or whenCIis set.astryx doctorstill reports the missing setup in its agent-docs check every time. No JSON shape or exit code changes. (#10343) - In a folder inside an Astryx project whose own
package.jsondeclares no Astryx package, such as a tool folder that installs its own@astryxdesign/core, the setup reminder'sinitcommand now names the project's release, as run from the project's folder: the project's own CLI when it installs one, otherwise the package runner pinned to the project's Core, such asnpx @astryxdesign/cli@0.7.3 init. It used to pin the release of the CLI that answered the run, whatever the project records. No JSON shape or exit code changes. (#10343) astryx experimental render: a page outside a project now renders. Outside a project (no Core or CLI the folder reads, and no package.json that declares one), the page takes the@astryxdesign/*packages its folder lacks, and the integrations a host approves, from the copy the CLI itself runs with, instead of failing with ERR_RENDER_MISSING_DEPENDENCY. React and StyleX come from that copy too, so the page loads one copy of each, even in a React app that installs its own. When that copy's Core cannot be downloaded, a page that needs it fails with ERR_VERSIONS_UNAVAILABLE, as other commands that read Core do. Inside a project, the page uses only the project's own packages. (#10362)- A link to a topic that an integration replaces under the same name opens the replacement. In an app whose integration replaced
themeorgetting-started,doctorreported Core's links to them as naming no doc. (#10342) swizzleno longer copies a component's browser test harnesses (*.spec.ts,*.spec.tsx, such as Item'sItemMarkerColumns.a11y.chromium.spec.ts) when the installed Core source holds them:@astryxdesign/core0.7.5 and earlier, or Core's repository source. They import Playwright and an unpublished test package, so a project that swizzled such a component failed to type-check or build. Core 0.7.6 and later ship no harnesses, so swizzling from them is unchanged. (#10230)astryx theme buildno longer depends on the order it loads the core component docs. A parent doc that lists a sub-component by name only, such asAvatar.doc.mjslistingAvatarStatusDot, erased the values the sub-component's own doc declares when it loaded after that doc; whenAvatar.doc.mjsloaded last,avatar-status-dotvariant:successcounted as a custom value. The build now merges every doc's entry for a component. (#10288)astryx integration verifyno longer reportstheme_module_stalefor a theme whose built module differs only in the command its comment says built it, such as a theme built withyarn astryxand verified wherepnpm exec astryxruns. Any other difference still fails. (#10344)
Performance
- A compact or full hook list, and the suggestions for an unknown hook name, list each of Core's folders once. Before, they listed a folder again for each hook they looked up. (#10324)
- A search, build or component read lists each folder once. A process that runs several reads, such as a docs site's search or an agent harness, reuses a folder's listing once the folder has stayed unchanged for two seconds. A later read lists the folder again after an entry is added, removed or renamed. (#10274)
- Within one operation, component discovery reads each component doc once, and the component matcher looks for each component's doc once, not once for each name they resolve. Resolving 30 names that only the matcher finds, such as names in another case, makes 14,794 file-system calls instead of 305,108. Results are unchanged. (#10277)
Documentation
- The Authoring guides (Quick Start, Field reference, Building Blocks, Ship, Help, and Make your integration work globally) now carry the keyword "authoring", so
astryx search authoringlists them right after the Authoring overview instead of after API function pages. (#10354) astryx build --helplists every value--typeaccepts (component, hook, doc, template, theme), matching the invalid-type error and what build actually runs, and says thatdocandthemegive an empty kit, since the kit has no doc or theme group. A test keeps the help text, the choices, the API doc and the error message on build and search naming the same set, and checks what each value returns. (#10361)- Getting Started has an Upgrade section: upgrade every Astryx package your app lists in one command, to the same release, then run
astryx upgrade. If your package manager holds new releases back, exempt the whole@astryxdesign/*scope, not only some of its packages. (#10241) - The custom theme guide names the files of a local theme, including the same-stem descriptor
theme addreads. (#10347) - The CLI's bundled colour token docs say the status icon colours (
--color-icon-<status>) paint status marks on the page or a card, such as a StatusDot. (#10204) - New block, "Table — Selection in the Leading Mark": row selection with no checkbox column. Each row shows its avatar, and the checkbox takes the avatar's slot while a mouse is over it, on keyboard focus, and on every row once anything is selected. On touch screens the checkbox always shows. It uses the existing
useTableSelectionStateand renders the checkboxes in the name column, so no new Table API is involved. (#10395)
Other Changes
- Internal: the export reader can report type-only exports and map a module's whole public surface in one pass. No change to any command's output. (#10365)
Contributors
Thanks to everyone who contributed to this release:
0.7.10
New Features
astryx discoverlists the experimental PageControl component from@astryxdesign/lab. (#9684)createDragToSnapPointsand its hookuseDragToSnapPointslet a drag move an element along one axis and settle it on snap points (px offsets from its resting position) at the release: the nearest one, the next one in its direction after a flick faster thanflickThreshold(default 1008 px/s), or the one it started from when the release moves back. The settle continues the release velocity,settleTo(index)settles without a drag, andonSettle(index)reports where it landed.createDragToSnapPointsis exported from the package root anduseDragToSnapPointsfrom@astryxdesign/core/hooks; the CLI's templates gain a playing-card example of each. (#8658)
Fixes
- Inserting a token through
ChatComposerInput's handle (insertToken) now reports the new value throughonChangeonce, as typing does, and hides the placeholder. Before, a controlled host's Send button stayed disabled or sent a stale prompt. Theai-chat-landingpage template drops the input-event workaround it used to sync the composer after an insert. (#10167) - The CLI no longer lists
@astryxdesign/theme-neutral,@astryxdesign/labor@astryxdesign/chartsas optional peers. Before, a package manager could keep a theme from an older release as the CLI's peer after an app removed the theme and upgraded Core, and then warn that the theme's Core peer was not met.@astryxdesign/corestays the CLI's one optional peer. In a Yarn Plug'n'Play workspace member, or a pnpm workspace member withhoist: false, a legacypackage.json#astryx.themeofneutralnow makesastryx componentwarn that it cannot resolve the theme. Add the theme to the app withastryx theme add neutralinstead. (#10232)
Documentation
- A new
useMultiCombobox — Issue Labelsexample block builds a Labels field onuseMultiCombobox: typing filters the labels, the arrow keys move the active option while focus stays in the field, Enter or a click toggles a label and the list stays open, and selected labels show as removable tokens above the field. Copy it withastryx template useMultiComboboxHookUsage <path>. (#9578) - A
useSnapPaging — Onboarding Pagesexample block: onboarding cards in a Carousel withhasSnap={useSnapPaging()}move one view per flick, and a switch moves one card per flick through the hook'spagesoption. Copy it withastryx template CarouselSnapPaging <path>. (#8153)
Contributors
Thanks to everyone who contributed to this release:
0.7.9
Experimental APIs
astryx discoverlists the experimental NavigationStack and NavigationScreen components from@astryxdesign/lab.
New Features
astryx discoverlists the experimental CircleCheckIndicator component from@astryxdesign/lab.astryx theme buildkeeps a theme'scomponentIconsslot functions. The built module imports each slot function from the module the theme source imports it from, writes static slot values beside it as JSON, and reads back the same staticcomponentIconsview, so component icon slots resolve the same for the built theme as for the runtime theme. This includes slots inherited from a built, package, or family base. A slot function defined in the theme file still fails the build: move it to its own module and import it. In--familyoutput, a member supplies its own slot functions through a named import of its wholecomponentIconsmap. The module keeps each slot import as the theme source spells it (--icons-specifierrewrites only the icon registry import), so with--outin another directory, a module must answer to that specifier from the output directory.- A theme chooses which shared icon a component's own icon role uses, by slot, with
defineTheme({componentIcons}). The first slot iscode-block-copy: CodeBlock's copy button passes{copied}and, with no theme entry, drawscopy, thencheckwhile copied. A slot value is a shared icon name,nullto hide the icon, a partial{icon, variant, size}request, or a pure function of the slot's state that returns one; a field the request leaves out keeps the component's own value. For the copy button,nullhides only the glyph.theme.componentIconsreads back the static values.ComponentIconSlotMapand the slot value types are exported from@astryxdesign/core/Icon.astryx theme buildcarries static slot values into built themes and fails on a slot function, andastryx componentlists a component's slots. createPanGesture(element, {axis?, onPan})andusePanGesture(ref, {axis?, onPan})report a drag on an element as values:onPangets{state, translation, velocity}as the drag begins, changes, ends at the release, or is cancelled, and a finger, a mouse and a pen all drive it. A mouse or pen drag that starts on selectable text selects it instead; give text the drag should moveuser-select: none.axislimits the drag to'x'or'y'; a drag along the other axis is not reported.translationcounts from where the drag began, so an element that follows it does not jump, andvelocityatendedis the release velocity in pixels per second. The drag claims its touch at UIKit's 10 pt and leaves presses and long presses alone.destroy()removes every listener; the hook creates one pan for the element behindrefand destroys it at unmount.- Motion: a theme's
temponow times the springs of touch motion as well as its CSS durations. Each spring keeps its shape and takestempotimes as long, and so does the animated-layout glide. Finger tracking and busy loops stay as measured. A theme with only a duration scale keeps its springs at tempo 1, even inside a theme with a tempo. The springs don't followcharacteryet. The motion doc says so.
Fixes
astryx docs <namespace> <section>loads the project once instead of once for every guide below the namespace, so on a namespace with many guides, such asastryx docs authoring <section>, the read itself takes tens of milliseconds instead of hundreds. The answer is unchanged.- A run that takes over a crashed run's release-cache lock now also recognizes the npm install that run left behind by its original command line, as npm shows it before renaming its process, when Node's own file is not named
node, such asnodejsornode-linux-x64. - The lexical ranker behind
astryx build's search ranks the candidates search gathers, reused the same way. A later query in the same folder, for the sametype, gathers again only when an input changed. In a long-running caller, a build that follows a build or a search no longer reads every component, hook, doc, template and theme again. A search that follows a build no longer reads them again either. Results are unchanged. - Under the Neutral theme, a selected row, a calendar range and the other selected fills on Neutral's surfaces are visible again, and highlighted code lines are stronger.
--color-accent-mutedmatched the surface in dark mode and barely differed from the hover tint in light mode; it is now#d4d4d4in light and[#474747](https://github.com/meta/astryx/pull/474747)in dark. In dark mode a selected Item, TreeListItem or checked CheckboxListItem row, a numbered Citation and a FileInput dropzone lift their secondary text so it stays readable on the fill; a dropzone's hint is slightly lighter at rest too. Neutral's code comments, operators and punctuation are slightly less muted so they stay readable on a highlighted line. The CLI's Neutral theme template carries the same values. - The stock theme's dark-mode accent (
--color-accent) is now[#0171](https://github.com/meta/astryx/pull/0171)E3instead of[#2694](https://github.com/meta/astryx/pull/2694)FE, so white text on an accent fill, such as a primary Button's label at rest, meets 4.5:1 (4.70:1, was 3.11:1). Hovered and pressed primary Buttons improve too (about 4.36:1 and 4.03:1, from under 3:1) but stay under 4.5:1. Light mode keeps[#0064](https://github.com/meta/astryx/pull/0064)E0. Everything else painted with--color-accentin dark mode also darkens: accent fills, focus rings and accent icons. MetadataList's "Show more", Table's sort rank and DateRangeInput's applied preset now use--color-text-accent, so their text stays readable on dark surfaces. The theme template thatastryx theme templatewrites uses the same dark accent, and the generated color token docs list it. To keep the previous look, a theme can set'--color-accent': ['[#0064](https://github.com/meta/astryx/pull/0064)E0', '[#2694](https://github.com/meta/astryx/pull/2694)FE']. astryx swizzleno longer runsgh auth statusbefore it reports: the readygh issue createline appears whenghis on your PATH, found without running it, so a copy never waits on a process start or on GitHub. The line now also appears whenghis installed but not logged in; running it, gh asks you to log in.astryx swizzlenow copies the private attribute owner modules a component imports, and the unexported style modules they need, beside the copy in the package's layout. A swizzledItem,CheckboxList,RadioListorTreeListno longer imports aprivateAttributes/*.stylexsubpath that@astryxdesign/coredoes not export. A second swizzle reuses an identical copy and refuses a changed one without--overwrite. The receipt'sfilesandfilesCopiedinclude the modules it copied.astryx theme buildreads the theme's icon import from the source it loaded: a theme saved in place while it builds now builds with its import, or fails and builds on the next save, instead of producing a module without the import.- theme: support
CustomTextTypesmodule augmentation for custom Text variants (#5013)
Performance
astryx searchandastryx buildread Core's exports map once per run, not once per component. With the other readers, a search now reads Core's package.json 10 times instead of 183. Results are unchanged.- When no loaded integration ships templates, the integration-issue check no longer imports every Core template doc.
astryx doctorin a project whose integrations only ship icon sets now imports none of them. - With no integration loaded, the integration-issue check no longer imports every Core template doc.
astryx discover, andastryx componentwithout--showcaseor--blocks, now import none of them. - The integration manifest writer loads the code-rewrite toolkit only when it patches a manifest.
astryx component,astryx theme listandastryx doctoroutside a project no longer load it, and a component lookup loads about 70 fewer modules. astryx searchandastryx buildlook for a component's doc only in the Core folders whose listing holds its name, not in every folder. A search makes about a quarter of the file checks it made before. Results are unchanged.- Outside a project whose config names
debugorintegrations,astryx --versionno longer loads the project, integration and code-rewrite modules. In a folder with no project config, it uses about three quarters less CPU. When no integration is installed,astryx docsandastryx hook --listload the project but not the code-rewrite modules. Output and exit codes are unchanged. astryx searchandastryx buildwork out a query word's forms once per entry they score, not once per word compared. Answers are unchanged.astryx searchandastryx buildcompute a typo's edit distance only up to the most edits that can count. A fuzzy match now computes far fewer table cells, with unchanged answers.- A standalone
astryx theme buildagainst the current Core loads Core's root entry only when the theme imports it. A theme that imports only@astryxdesign/core/themeno longer loads all of Core and its components. Family builds and builds against an older Core still load the root. Some builds hand the theme its Core: family builds, builds against an older Core, and themes whose folder has no Core. There, a theme that imports a Core rootrequire()cannot load, such as one that awaits at its top level, fails withERR_THEME_LOAD. The error names that root. astryx doctor's theme checks, family builds and builds against an older Core defer an installed Core's root entry. It loads only when the theme or one of its.cjsdependencies imports it. A theme that does not import Core's root no longer loads all of Core and its components for them.
Documentation
- The calendars guide says
Calendar,DateInput,DateRangeInput, andDateTimeInputshow the Gregorian calendar unless the application chooses another one. (#9842) - Hook docs for
useCalendarDays, soastryx hook useCalendarDaysandastryx searchreturn it, and auseCalendarDays — Month Gridexample block: a compact month table built from the hook'sweeksanddayNames, with the previous and next months' days dimmed and a Week starts on control (Sunday or Monday) that reorders both the header and the grid. Copy it withastryx template useCalendarDaysHookUsage <path>. - Hook docs for
useIcon, soastryx hook useIconandastryx searchreturn it, and auseIcon — Status Rowexample block: a custom status row draws the success, warning and error icons withuseIcon, and under a Theme that overrides those icons the same row draws the theme's icons. Copy it withastryx template useIconHookUsage <path>. - Hook docs for
useLinkComponent, soastryx hook useLinkComponentandastryx searchreturn it, and auseLinkComponent — Article Cardsexample block: custom Article cards render their title link with the component the hook resolves. Inside a LinkProvider wired to a client-side router the title navigates without a page load,as="a"gives a native anchor even inside the provider, and outside the provider the title falls back to the next provider up or a native anchor. Copy it withastryx template useLinkComponentHookUsage <path>. - Hook docs for
useOverlay, soastryx hook useOverlayandastryx searchreturn it, and auseOverlay — Product Quick Viewexample block: a product Card spreads the hook'scontainerRefandcontainerPropsand renders the returned scrim once over its image. Hovering the card, or moving keyboard focus into it, reveals a Quick view button, and the image link before it lets Tab reach the button. Copy it withastryx template useOverlayHookUsage <path>. - Hook docs for
useTableSortableState, soastryx hook useTableSortableStateandastryx searchreturn it, and auseTableSortableState — Multi-Sort Ordersexample block: an orders Table with no sort code of its own, where clicking Customer and then Shift-clicking Total sorts by customer and then by total. Copy it withastryx template useTableSortableStateHookUsage <path>. - Internationalization gains a short Other calendars guide: choose a calendar on
InternationalizationProviderorCalendar, values stay Gregorian ISO dates, and most calendars needTemporal(loadtemporal-polyfill/full/globalwhere it is missing). A newastryx docs calendarsnamespace has the detail: the supported calendars, loadingTemporalon the server and in the browser, why the lunisolar calendars (chinese,dangi) can differ by a day between runtimes, and ISO 8601 week numbers. The guide andCalendar'scalendarprop docs say how to get identical server and browser markup for those calendars:installImplementation()fromtemporal-polyfill/full/shimon both sides, since thefull/globalimport keeps a nativeTemporal. - InfoTip: the component page,
astryx component InfoTip --showcase, andastryx component InfoTip --blocksnow have worked examples — a showcase metric label, a row of metric definitions, and read-only settings with permission notes. InfoTip's docs list its anatomy (trigger button, info icon, help surface) and say it follows the toggletip pattern: the button reportsaria-expanded="true"while the help is pinned, and a screen reader hears the help once when it pins. - The
usePanGesturepage opens with a draggable box in two forms side by side: the hook andcreatePanGesture, which takes any element, with the same StyleX styles and Astryx tokens. The playing card follows as the advanced example. ThecreatePanGesturepage points to that example, and theusePanGestureguidance warns against holding the drag offset in a large component's state. - A new
useClickableContainer — Clickable Project Cardexample block makes a project card clickable anywhere withuseClickableContainer: a click on the card follows its title link, while the Star button, the owner link and a text selection keep their own behavior, and Ctrl/Cmd+click or middle-click opens the project in a new tab. Copy it withastryx template useClickableContainerHookUsage <path>. - A new
useImageMode — Photo Captionexample block shows a caption over a photo's sky.useImageModesamples only the strip under the caption, andMediaThemegives the caption light or dark text from the result. A Beach photo switch swaps a night photo for a bright beach photo, and the caption keeps the dark fallback while the new photo loads. Copy it withastryx template useImageModeHookUsage <path>. - A new
useInputContainer — Search Field Wrapperexample block builds a custom search field with a leading search icon, padding and a trailing Clear button.useInputContainerputs focus in the input when the icon or the padding is clicked, and a click on Clear stays with Clear. Copy it withastryx template useInputContainerHookUsage <path>. - A
useMergedRefs — AutoGrowTextAreaexample block: an AutoGrowTextArea forwards the caller's ref and keeps its own ref to measure its height, and the merged ref attaches both to the same textarea, so it resizes itself while a parent button focuses it through the forwarded ref. Copy it withastryx template useMergedRefsHookUsage <path>. - A new
useScrollLock — Full-screen Mobile Menuexample block opens a custom full-screen menu from a Menu button and locks the page behind it withuseScrollLock, so the page neither scrolls nor shifts sideways, and closing the menu returns the reader to the same scroll position. Copy it withastryx template useScrollLockHookUsage <path>. - A new
useScrollOverflow — Filter Strip Edge Fadesexample block shows a row of active filters that scrolls sideways and fades only the edge whereuseScrollOverflowreports hidden filters. Adding or removing a filter updates the fades, and a right-to-left switch moves the start edge to the right. Copy it withastryx template useScrollOverflowHookUsage <path>.
Other Changes
- Internal: the search gather runs in its own listing-cache operation, so a caller that gathers candidates directly lists each folder about once, as
astryx searchalready does. The command's results and output are unchanged. Not exported from the package entry point. - Internal: the CLI's in-process test helper builds only the commands its arguments need, as a run of the bin does.
- The CLI's test setup rebuilds Core when its build is older than Core's sources or translations. It does so before any test starts, so a reused checkout no longer tests the CLI against an old Core build. A test waiting on another's build reads it only once that build is finished. One checkout's build no longer holds up another's tests. A run that cannot rebuild a stale Core, while an earlier run in the checkout uses it, stops with an error naming that run.
- The PowerSearch blocks fit a phone-sized screen. Each sizes its field through a grid column,
minmax(0, <width>): the old width where there is room, and the container's width where there is not. The Search with Table block's table scrolls inside its own frame on a narrow screen instead of widening the example. - Internal: the main searcher's test checks the count contract for each query, not a byte total over eight queries.
- The Tokenizer blocks and the table-inbox and work-item-detail page templates follow Tokenizer's
'adaptive'default, so on a compact touch screen they show the bottom sheet. TheirendContentandrenderTokenwork there as in the inline field;hasClearand the overflow modes apply to the inline field, and the Clear and Overflow blocks say so. The rule: docs examples followadaptive; the stories that are fixtures for inline-field geometry (Caret placement, Logical order, RTL end lane, Long token beside the end lane) keeppresentation="popover". The table-inbox and work-item-detail back arrows mirror in right-to-left.
Contributors
Thanks to everyone who contributed to this release:
0.7.8
Experimental APIs
astryxdiscovery lists the lab's newSelectableCardGroup.
New Features
- In Chrome on Android, on a touch screen, a Tall BottomSheet places the focused field just above the on-screen keyboard when Chrome reports it, then rides the rest of Gboard's slide; through the hide the sheet's scroll room stays while its content rides down, so nothing jumps while the keyboard is still on screen. Under Reduce Motion it cross-fades instead of moving. The browser-support guide says so.
- A component doc can mark its component deprecated with
deprecated: {replacement, description}: thenameof the component to use instead and the modernization route.astryx searchresults andastryx buildkit entries for that component carry the field asdeprecated(adeprecated:line in their text output), and the docsite shows a Deprecated badge in the component's page header (beside any stability badge) and a notice at the top of its page that names and links the replacement, and labels it Deprecated on its components index tile and in site search.BottomSheetSwitchersets it, namingBottomSheet; the component keeps working unchanged. createAnimator(element)and its hookuseAnimator(ref)animate one element with the motion Astryx's components use; the hook takes the element's ref, so a gesture hook can share the element.animatespringsx,y,scale,rotateandopacityto a target on the state-change motion,decaycoasts any of them from a release velocity,setjumps,getandgetVelocityread, andstophalts;animateanddecayreturn a promise. Reduce Motion is planned for every call.createAnimatoris exported from the package root anduseAnimatorfrom@astryxdesign/core/hooks; the CLI's templates gain a playing-cards example of each.astryx upgradegains thepromote-tokenizer-presentationcodemod. It rewrites a staticexperimental={{presentation: x}}on Tokenizer, the 0.7.7 spelling that Tokenizer no longer reads, topresentation={x}. Where it cannot prove the rewrite, including any Tokenizer that spreads props (a spread may also setpresentation), it leaves the call unchanged with a TODO.
Fixes
astryx componenttakes a component's exact name in another case as that component's, never a module's that only shares the spelling.tokenizeropens Tokenizer's doc instead of CodeBlock's, which it reached throughCodeBlock/tokenizer.ts.--sourcewithtokenizer,slider,switchorprogressBarno longer printsCodeBlock/tokenizer.tsor the motion tables inmotion/uikit/, and answersERR_NO_SOURCE, as--source badgedoes.- The theme token
--duration-exit, the standard dismissal duration, now exists. It defaults tovar(--duration-fast), so it follows a theme'stempothrough that token, and a theme can set it like any duration token. Before, a theme or component that readvar(--duration-exit)found no value. The motion and token docs, and the theme template's token list, name it.
Performance
integrationComponentConflicts(),integrationDocConflicts()andintegrationCheck()from@astryxdesign/cli/api, anddoctor integration components,doctor integration docsandintegration check, find Core's components from the folder listings they already read, with far fewer file system calls. Their results are unchanged.- A run of
astryxloads only the command it names, so it starts with less work:astryx --versionuses about 0.31 s less CPU, andastryx docs --json,astryx component --listandastryx theme buildabout 0.25–0.3 s less. Help, the manifest and an unknown command still load every command. Output and exit codes are unchanged. astryx searchandastryx buildparse a page template's source for the components it renders only when the query could match one of them. A query no page renders parses only the few pages whose source holds an escape, and a first search for it uses about 20% less CPU. A query whose words name components on most pages still parses most of them and can take up to about 4% more. Results are unchanged.
Documentation
- The browser-support guide has a section on the on-screen keyboard: a fully expanded Tall BottomSheet measures it as the layout viewport's height minus the visual viewport's, and keeps the focused field above it in Safari on iOS, Firefox for Android and Chrome on Android. In Chrome, by default (
interactive-widget=resizes-visual), the sheet adds its scroll room once Chrome reports the keyboard; withinteractive-widget=resizes-contentChrome shrinks the page for the keyboard itself and the sheet changes nothing. Your app owns its viewport<meta>element; Astryx never sets it. - Hook docs for
useLightbox, soastryx hook useLightboxandastryx searchreturn it, and auseLightbox — Gallery Gridexample block: a grid of photo thumbnails that opens a fullscreen gallery at the clicked item. - A new
useAnnounce — Filter Result Countexample block shows the hook on a product filter: once typing pauses for 500 ms, a screen reader hears the result count ("3 results", or "No results"). The count has its ownhasReplaceinstance, as the hook's docs advise for a changing value. Copy it withastryx template useAnnounceHookUsage <path>. - A new
useClipboard — Share Linkexample block shows the hook on a share card: Copy writes the invite link, the button reads "Copied" whileisCopiedis true and resets on the hook's timer, and a screen reader hears "Link copied". Copy it withastryx template useClipboardHookUsage <path>. - A new
useFocusTrap — Quick Edit Panelexample block traps focus in a custom quick-edit panel that is not built on Dialog:focusFirstmoves focus to its field on open, Tab and Shift+Tab stay inside it, Escape closes it throughonEscape, and closing returns focus to the Quick edit button. Copy it withastryx template useFocusTrapHookUsage <path>. - A new
useHotkeys — Search and Help Shortcutsexample block shows the hook on a page header: "/" focuses the search field and "?" opens the shortcut help, typing either character in the field does not trigger them, and a switch turns the single-key shortcuts off throughisDisabled. Copy it withastryx template useHotkeysHookUsage <path>. - A new
useInputStatusIcon — Coupon Code Statusexample block shows a custom bordered input that takes its status affordance fromuseInputStatusIcon: a wrong code shows the error status and the valid code shows success, and the variant switch moves between a glyph with a message below (attached), no icon on the field (detached), and a focusable button with a tooltip that keyboard and screen-reader users can reach (tooltip). Copy it withastryx template useInputStatusIconHookUsage <path>. - The
useKeyboardHint — Arrow-key Hintexample block now callsuseKeyboardHintitself instead of relying on Toolbar, which calls the hook internally. It is a five-star rating with one Tab stop, where Left and Right change the rating: tabbing into it shows the "← → to navigate" hint, the first arrow press dismisses it, and tabbing back in does not show it again. Copy it withastryx template useKeyboardHintHookUsage <path>. - A new
useLocale — Invoice Summaryexample block formats an invoice date and amount withIntlusing the locale fromuseLocale, so switching the provider from English to German changes "Nov 2, 2026 · $1,234.50" to "2. Nov. 2026 · 1.234,50 $" with no second locale source. Copy it withastryx template useLocaleHookUsage <path>. - A new
useScrollableArea — Activity Log Panelexample block shows a fixed-height Activity log whose entries scroll.useScrollableAreamakes the panel a keyboard tab stop only when its entries overflow, shows a top or bottom edge shadow only where entries are hidden, and stops a scroll at the end from scrolling the page. Add entry flips it from not scrollable to scrollable. Copy it withastryx template useScrollableAreaHookUsage <path>. - A new
useTreeFocus — Keyboard File Treeexample block builds a small file tree from plain rows with tree roles and gives it the WAI-ARIA tree keyboard model withuseTreeFocus: arrow keys move over the visible rows and open, enter, leave or close folders, Home and End jump to the ends, a typed letter jumps to a matching name, Enter opens a file, and one row is the tab stop. Copy it withastryx template useTreeFocusHookUsage <path>. - A new
useTypeahead — Type to Focus a Countryexample block adds type-to-focus to a country list of buttons. Typing "can" focuses Canada, pressing "b" again and again cycles through Belgium, Brazil and Bulgaria, and "e" finds Éire with the accent ignored.useTypeaheadreports each match throughonMatch, anduseListFocusmoves focus. Copy it withastryx template useTypeaheadHookUsage <path>.
Other Changes
- Internal: the file read behind
astryx doctor --builttakes its file limit as an option, 20,000 unless a caller passes one, and the checks' messages name the limit the read used. The command's checks and output are unchanged. Not exported from the package entry point. astryx discoverno longer lists the Lab componentsMobileTokenizerandMobilePowerSearch, which are removed from@astryxdesign/lab; their touch flows are Core's Tokenizer and PowerSearchpresentationsheets.- Internal: the public-import check's
declaredTargetsandmissingNamesare exported from their foundation module, so the docsite's production registry judges a copied example's imports by the same rule. The CLI's checks and their output are unchanged. Not exported from the package entry point. - Internal: a gap-report handler's time budget starts once its module has loaded. Starting its worker and loading the module have the default deadline, so a short budget in a contract test no longer covers a slow start on a busy machine. The 30-second handler budget is unchanged.
- Internal: generating the CLI's type declarations no longer fails when builds in two checkouts run at once on one machine, and it no longer needs pnpm on PATH.
- The Tokenizer blocks and page templates that show a prop the bottom sheet does not render (
hasClear,endContent,tokenOverflowBehavior,hasEntriesOnFocus,renderToken) passpresentation="popover", so they keep the inline field on phones under Tokenizer's new'adaptive'default.
Contributors
Thanks to everyone who contributed to this release:
0.7.7
New Components
astryx discoverno longer listsInfoTipamong the components@astryxdesign/labcontributes: InfoTip is a Core component now, described byastryx component InfoTip.
Performance
- With TypeScript 5.3 or later,
validateIntegration(),integrationComponentConflicts()andintegrationCheck()from@astryxdesign/cli/api, and the commands that run them, reuse each TypeScript file a check parsed for later checks in the same process that parse it the same way, while the file is unchanged, instead of parsing it again for every check. Their results are unchanged.
Documentation
- Hook docs for
useOutlineFromMarkdown, soastryx hook useOutlineFromMarkdownandastryx searchreturn it, and auseOutlineFromMarkdown — Docs Articleexample block: a Markdown article and an Outline built from the same string through the hook, with a button that adds a section and its linked entry. - The
usePressFeedback — Pressable Cardexample now shows a small card in real playing-card proportions, with corner indices, a full face and a patterned back, and a line under it that says what to try: press and hold to see the press, tap, click, Enter or Space to flip. Copying the example (astryx template, the docsite's Code tab and Install) still gives you only the hook on a Card (width={120},padding={1}) with one<Text>placeholder: the hint line is left out, not replaced. - A new
useCombobox — Assign To Fieldexample block spreads the field, listbox and option props fromuseComboboxonto aTextInputand a list ofItemrows: typing filters a list of teammates, ArrowUp and ArrowDown move the active option while focus stays in the input, Enter or a press picks one, and Escape closes the list. Copy it withastryx template useComboboxHookUsage <path>. - A new
useGridFocus — Color Swatch Gridexample block wiresuseGridFocusto a color swatch picker in rows of eight: the grid has one Tab stop, the arrow keys move focus cell to cell, Home and End jump within a row, Ctrl+Home and Ctrl+End jump to the corners. Each swatch is a button, so Enter or a click picks it. Copy it withastryx template useGridFocusHookUsage <path>. - A new
useListFocus — Recent Filesexample block gives a list of buttons keyboard navigation fromuseListFocus: ArrowUp and ArrowDown move between rows, Home and End jump to the first and last row, focus wraps at the ends, and only one row is in the tab order. Copy it withastryx template useListFocusHookUsage <path>. - A new
useOverflow — Editor Toolbarexample block shows the hook on its own: eight toolbar actions sit in a card you can resize, a hidden copy of the row holds every action plus theMoremenu markeddata-overflow-indicator, and the actions that do not fit move into theMoremenu with no flicker. Copy it withastryx template useOverflowHookUsage <path>.
Contributors
Thanks to everyone who contributed to this release: