chore(deps): update dependency @astrojs/starlight to v0.42.0 - #267
Open
renovate[bot] wants to merge 1 commit into
Open
chore(deps): update dependency @astrojs/starlight to v0.42.0#267renovate[bot] wants to merge 1 commit into
renovate[bot] wants to merge 1 commit into
Conversation
Contributor
Author
|
renovate
Bot
force-pushed
the
renovate/astrojs-starlight-0.x
branch
16 times, most recently
from
July 4, 2026 14:00
e0d236b to
6d377af
Compare
renovate
Bot
force-pushed
the
renovate/astrojs-starlight-0.x
branch
4 times, most recently
from
July 6, 2026 21:53
eeafc15 to
f75b1aa
Compare
renovate
Bot
force-pushed
the
renovate/astrojs-starlight-0.x
branch
from
July 25, 2026 17:10
f75b1aa to
a8f9841
Compare
renovate
Bot
force-pushed
the
renovate/astrojs-starlight-0.x
branch
from
July 31, 2026 10:47
a8f9841 to
a3f409e
Compare
renovate
Bot
force-pushed
the
renovate/astrojs-starlight-0.x
branch
2 times, most recently
from
August 8, 2026 13:01
836b4be to
ae3c647
Compare
renovate
Bot
force-pushed
the
renovate/astrojs-starlight-0.x
branch
from
August 27, 2026 23:28
ae3c647 to
4ac562a
Compare
renovate
Bot
force-pushed
the
renovate/astrojs-starlight-0.x
branch
13 times, most recently
from
August 28, 2026 22:41
2c93dd4 to
6d19caa
Compare
renovate
Bot
force-pushed
the
renovate/astrojs-starlight-0.x
branch
4 times, most recently
from
August 31, 2026 16:38
dfa7d4a to
14de149
Compare
renovate
Bot
force-pushed
the
renovate/astrojs-starlight-0.x
branch
from
September 4, 2026 19:24
14de149 to
b448d82
Compare
renovate
Bot
force-pushed
the
renovate/astrojs-starlight-0.x
branch
from
September 5, 2026 14:12
b448d82 to
3cb029d
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
0.37.7→0.42.0Release Notes
withastro/starlight (@astrojs/starlight)
v0.42.0Compare Source
Minor Changes
#3572
292fb17Thanks @HiDeoo! - Distributes package as JavaScript files with dedicated type declaration files instead of TypeScript source files.#4121
2623ae6Thanks @delucis! - Simplifies markup for Starlight’s mobile menu toggleMobileMenuTogglebutton orPageFramecomponents, you may need to adjust these for the new markup. The button is no longer wrapped in a<starlight-menu-button>custom element and no longer uses thearia-expandedattribute. Instead, you can use the.sl-menu-buttonclass name to target the button and the:popover-openpseudo-class to style the menu open state specifically.In the following example, custom styles for the menu button are updated for the new approach:
See
MobileMenuToggle.astroandPageFrame.astroon GitHub for the full source code of the updated components.#3572
292fb17Thanks @HiDeoo! - Removes thetaglineconfiguration option, which was never used.If your configuration included a
taglineoption, you can safely remove it without any replacement.#4134
6135f01Thanks @HiDeoo! - Updates internal@astrojs/mdx,@astrojs/markdown-satteri, andsatteridependencies.astrov7.2.10 or later@astrojs/markdown-satteri0.4.0 or later (if you use it)@astrojs/markdown-remark7.3.0 or later (if you use it)Please update Starlight and Astro together:
#4121
2623ae6Thanks @delucis! - Refactors Starlight’s mobile menu toggle to work when JavaScript fails or is disabledThis change also removes the
data-mobile-menu-expandedattribute, which was previously added to<body>while the mobile menu is open. If you have custom code that was depending on this attribute, you will need to update it to use a new selector to check if the mobile menu is open.In the following example, a custom background colour for the site header while the menu is open is updated for the new approach:
v0.41.11Compare Source
Patch Changes
#4167
32a5e29Thanks @HiDeoo! - Fixes a layout issue and anchor links appearing for hidden headings, e.g. footnote headings, whenmarkdown.headingLinksis enabled or the<AnchorHeading>component is used.#4148
cdfafd8Thanks @ematipico! - Optimizes sidebar data generation logic to speed up sites with large sidebarsv0.41.10Compare Source
Patch Changes
#4160
88442c3Thanks @ArmandPhilippot! - Adds the missing translations for Expressive Code in the following locales:ar,hi,it,ja,ko,pt,zh-CN, andzh-TW.#4156
57af92dThanks @pyxelr! - Adds 1 new icon:hypothesis#4159
a0e0ba2Thanks @trueberryless! - Adds 1 new icon:npmxv0.41.9Compare Source
Patch Changes
1c90d69Thanks @pyxelr! - Adds 1 new icon:goodreadsv0.41.8Compare Source
Patch Changes
#4142
cacbc9fThanks @alebelcor! - Adds 1 new icon:whatsApp#4133
3944311Thanks @delucis! - Internal refactor: numberedidattributes in the<Tabs>component are now page-specific instead of using a global counter#4138
cd4b665Thanks @delucis! - Fixes localisation of code block UI elements when using the Sätteri Markdown processorv0.41.7Compare Source
Patch Changes
3e486fbThanks @delucis! - Fixes processing of code examples in RTL languages when using Astro’s Sätteri Markdown processorv0.41.6Compare Source
Patch Changes
f1dddc0Thanks @delucis! - Adds 1 new icon:forgejov0.41.5Compare Source
Patch Changes
bb06434Thanks @HiDeoo! - Fixes a regression when using a union to extend Starlight’sdocsSchema().v0.41.4Compare Source
Patch Changes
#3936
712eeddThanks @miichom! - Fixes support for modifying Zod enums when passing anextendoption to Starlight’sdocsSchema()#4092
0896b91Thanks @delucis! - Fixes support for links containing a protocol likemailto:in the sidebar#4088
4486ba4Thanks @delucis! - Simplifies Starlight’s client-side sidebar state persistence script slightlyv0.41.3Compare Source
Patch Changes
1686eccThanks @timothyjordan! - Keeps keyboard focus inside the mobile menu while it is open, preventing focus moving to hidden interactive elements in page content.v0.41.2Compare Source
Patch Changes
#4008
58a3520Thanks @FrancoKaddour! - Fixes the table of contents overflowing the right edge of the viewport when a custom--sl-content-widthvalue exceeds available space#4015
bdbfffcThanks @delucis! - Fixes an issue where aside icons were rendered incorrectly in projects where Astro’s MDX integration had optimization disabledv0.41.1Compare Source
Patch Changes
#3967
72e63dcThanks @HiDeoo! - Adds 2 new icons:linkandlink-alt.#3988
ac55cfaThanks @delucis! - Fixes a dependency resolution issue introduced in Starlight v0.41#3967
72e63dcThanks @HiDeoo! - Optimizes the icons of Markdown asides.v0.41.0Compare Source
Minor Changes
1202dd4Thanks @HiDeoo! - Adds support for Astro v7, drops support for Astro v6.Upgrade Astro and dependencies
Community Starlight plugins and Astro integrations may also need to be manually updated to work with Astro v7. If you encounter any issues, please reach out to the plugin or integration author to see if it is a known issue or if an updated version is being worked on.
Patch Changes
a935d33Thanks @HiDeoo! - Fixes Starlight Markdown processing being potentially applied to files that should not be processed.v0.40.0Compare Source
Minor Changes
#3923
edf2e6bThanks @Princesseuh! - Adds support for Astro 6.4 and the new Sätteri Markdown processor.It is now possible to opt into using Astro's 6.4 Sätteri Markdown processor by installing the
@astrojs/markdown-satteripackage and configuring it in yourastro.config.mjsfile:Please update Starlight and Astro together:
Community Starlight plugins and Astro integrations may also need to be manually updated to work with Sätteri. If you encounter any issues, please reach out to the plugin or integration author to see if it is a known issue or if an updated version is being worked on.
Patch Changes
edf2e6bThanks @Princesseuh! - Updates Expressive Code to version 0.43.1.v0.39.3Compare Source
Patch Changes
#3910
dddf405Thanks @andreialba! - Improves Romanian UI translations#3924
02f2ce1Thanks @BouRock! - Improves Turkish UI translations#3928
11a7ed2Thanks @delucis! - Updates Pagefind to v1.5 and adds support for Pagefind’s newdiacriticSimilarityandmetaWeightsadvanced ranking options#3927
e944870Thanks @HiDeoo! - Refactors internal file path handling for Starlight content collections.v0.39.2Compare Source
Patch Changes
2d05e18Thanks @tats-u! - Fixes CSS selector fortext-autospacestyles in Chromium browsersv0.39.1Compare Source
Patch Changes
#3885
010eed1Thanks @ArmandPhilippot! - Fixes the version mentioned in an error message related to autogenerated sidebar groups support.#3887
b3c6990Thanks @delucis! - Adds 13 new icons:clock,desktop,mobile-android,window,database,server,code-branch,notes,question,question-circle,analytics,padlock, andsolidjs.v0.39.0Compare Source
Minor Changes
#3618⚠️ BREAKING CHANGE: This release changes how autogenerated links work in Starlight’s sidebar configuration.
dcf6d09Thanks @HiDeoo! -If you have sidebar groups using the
autogeneratekey, you must now wrap that configuration in anitemsarray:{ label: 'My group', - autogenerate: { directory: 'some-dir' }, + items: [{ autogenerate: { directory: 'some-dir' } }], }This change unlocks the possibility to mix autogenerated links and other links in a single group, for example:
This release also updates the shape of autogenerated sidebar entries in route data. Autogenerated links and groups in
Astro.locals.starlightRoute.sidebarnow include anautogenerateobject with the configureddirectoryvalue:#3618⚠️ BREAKING CHANGE: This release changes the default collapsed state of autogenerated sidebar subgroups.
dcf6d09Thanks @HiDeoo! -Autogenerated subgroups no longer inherit the
collapsedvalue from their parent group. They are now expanded by default unless explicitly configured withautogenerate.collapsed.If your sidebar configuration relies on a collapsed parent group to also collapse its autogenerated subgroups, update your configuration to set
autogenerate.collapsedtotrue:{ label: 'Reference', collapsed: true, items: [ - { autogenerate: { directory: 'reference' } }, + { autogenerate: { directory: 'reference', collapsed: true } }, ], }#3845
4d755f5Thanks @delucis! - Adds a<link rel="alternate" hreflang="x-default" href="...">tag pointing to the default locale in multilingual sites. Thex-defaultalternate is used as a signal of which language to fall back to if no other is available. Learn more in Google’s SEO localization docs.#3862
ec70630Thanks @itrew! - Makes spacing of items in nested lists more consistent#3872
417a66cThanks @tats-u! - Enables the CSS propertytext-autospacein Chinese and Japanese documents.If you would prefer to disable autospacing in Chinese and Japanese pages, you can add the following custom CSS to your site:
#3797
9764ebdThanks @delucis! - Avoids the risk of layout shift when users expand and collapse sidebar groupsThis release can introduce additional padding to the site sidebar on certain devices to reserve space for scrollbars. You may wish to inspect your site sidebar visually when upgrading.
If you would prefer to keep the previous styling, you can add the following custom CSS to your site:
#3858
6672c35Thanks @delucis! - Updatesi18next, used for Starlight’s localization APIs, from v23 to v26There should not be any user-facing changes from this update
v0.38.5Compare Source
Patch Changes
ccf6000, #387747451bcThanks @delucis! - Updates internal dependenciesv0.38.4Compare Source
Patch Changes
#3828
342038bThanks @MangelMaxime! - Fixes aside styling when used without any content#3853
563e11bThanks @delucis! - Fixes a type-checking issue for users on newer versions of TypeScriptv0.38.3Compare Source
Patch Changes
#3799
313611bThanks @JosefJezek! - Improves Czech UI translations#3770
6e7bed1Thanks @gameroman! - Adds examples to the inline documentation fortitlein the Starlight configuration object#3801
fedd48bThanks @delucis! - Fixes missing draft content warning in dev on pages using the hero layoutv0.38.2Compare Source
Patch Changes
#3759
f24ce99Thanks @MilesChou! - Fixes an issue where monolingual sites using a region-specific locale (e.g.,zh-TW) as the default would incorrectly display base language translations (e.g.,zhSimplified Chinese) instead of the region-specific ones (e.g.,zh-TWTraditional Chinese).#3768
a4c6c20Thanks @delucis! - Improves performance of sidebar generation for sites with very large sidebarsv0.38.1Compare Source
Patch Changes
fb955ffThanks @pyxelr! - Fixes a regression causing globaltableOfContentsconfig to be ignoredv0.38.0Compare Source
Minor Changes
0d2e7edThanks @HiDeoo! - Adds support for Astro v6, drops support for Astro v5.Upgrade Astro and dependencies
Community Starlight plugins and Astro integrations may also need to be manually updated to work with Astro v6. If you encounter any issues, please reach out to the plugin or integration author to see if it is a known issue or if an updated version is being worked on.
Update your collections
In Astro 5.x, projects could delay upgrading to the new Content Layer API introduced for content collections because of some existing automatic backwards compatibility that was not previously behind a flag. This meant that it was possible to upgrade from Astro 4 to Astro 5 without updating your content collections, even if you had not enabled the
legacy.collectionsflag. Projects would continue to build, and no errors or warnings would be displayed.Astro v6.0 now removes this automatic legacy content collections support, along with the
legacy.collectionsflag.If you experience content collections errors after updating to v6, check your project for any removed legacy features that may need updating to the Content Layer API. See the Starlight v0.30.0 upgrade guide for detailed instructions on upgrading legacy collections to the new Content Layer API.
If you are unable to make any changes to your collections at this time, including Starlight's default
docsandi18ncollections, you can enable thelegacy.collectionsBackwardsCompatflag to upgrade to v6 without updating your collections. This temporary flag preserves some legacy v4 content collections features, and will allow you to keep your collections in their current state until the legacy flag is no longer supported.#3704
375edccThanks @florian-lefebvre! - Fixes autocomplete for components exported from@astrojs/starlight/components/*components/directory. Direct use of these files was not and is not officially supported. If you previously importedTableOfContents/starlight-toc.ts,TableOfContents/TableOfContentsList.astro,Icons.ts, orSidebarPersistState.ts, please review your code when updating.#3729
3642625Thanks @delucis! - Improves Starlight’s default body font stack to better support languages such as Chinese, Japanese, and Korean on Windows.For most users there should be no visible change.
If you would prefer to keep the previous font stack, you can add the following custom CSS to your site:
#3598
fff38d5Thanks @HiDeoo! - Makes hover styles consistent in Starlight’s navigation barPreviously, the social icon links and language/theme switchers in Starlight’s navigation bar, dimmed on hover.
After this change, they now increase in contrast on hover instead.
This matches hover behavior elsewhere, for example in the sidebar, table of contents, or search button.
If you want to preserve the previous styling, you can add the following custom CSS to your site:
Configuration
📅 Schedule: (UTC)
🚦 Automerge: Enabled.
♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.