chore(deps): update dependency @rspress/plugin-sitemap to v2.0.0 #1321

Closed
renovate wants to merge 1 commit from renovate/rspress-plugin-sitemap-2.x-lockfile into main
Collaborator

This PR contains the following updates:

Package Change Age Confidence
@rspress/plugin-sitemap (source) 2.0.0-beta.232.0.0 age confidence

Release Notes

web-infra-dev/rspress (@​rspress/plugin-sitemap)

v2.0.0-rc.8

Compare Source

What's Changed
New Features 🎉
  • feat(theme/HomeHero): add new hero image slot and add interactive to document by @​SoonIter in #​3051
  • feat(plugin-playground)!: change defaultRenderMode to 'pure' and support combined usage with plugin-preview by @​SoonIter in #​3059
Document 📖
  • docs(css-vars): improve generateThemeCssVariables scope matching for better theme color extraction by @​SoonIter in #​3058
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.7...v2.0.0-rc.8

v2.0.0-rc.7

Compare Source

What's Changed
New Features 🎉
Bug Fixes 🐞
Document 📖
Other Changes
New Contributors

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.6...v2.0.0-rc.7

v2.0.0-rc.6

Compare Source

What's Changed
New Features 🎉
Performance 🚀
Bug Fixes 🐞
  • fix(theme): fix inline code style in Callout when code is direct child of content by @​SoonIter in #​2997
  • fix(config/types): defineConfig should support asyncFn by @​SoonIter in #​3000
  • fix(core): improve i18n missing keys warning with configuration hints by @​SoonIter in #​3030
  • fix(ssg): collapse experimentalExcludeRoutePaths log when too many routes are ignored by @​SoonIter in #​3032
Document 📖
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.5...v2.0.0-rc.6

v2.0.0-rc.5

Compare Source

What's Changed
New Features 🎉
  • feat(theme): support clickable badge in HomeHero by @​SoonIter in #​2969
  • feat(ssg-md): add SSG-MD support to OverviewGroup and FallbackHeading components (Vibe Kanban) by @​SoonIter in #​2966
Bug Fixes 🐞
Document 📖
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.4...v2.0.0-rc.5

v2.0.0-rc.4

Compare Source

What's Changed
New Features 🎉
Bug Fixes 🐞
Document 📖
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.3...v2.0.0-rc.4

v2.0.0-rc.3

Compare Source

Highlights
🆕️ Support common tags

related PR: #​2879

You can use it in the frontmatter, and it also supports customization:

---
tag: new, experimental, ejectable
---
image
🌏 Enable text-autospace: normal; by default

related PR: #​2920

The text-autospace CSS property allows you to specify the space applied between Chinese/Japanese/Korean (CJK) and non-CJK characters.

/* If you don't like it, you can cancel it via `:root { text-autospace: unset; }` */
:root {
   text-autospace: normal;
}
What's Changed
New Features 🎉
Bug Fixes 🐞
Document 📖
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.2...v2.0.0-rc.3

v2.0.0-rc.2

Compare Source

Breaking Changes🚨
theme folder should use @rspress/core/theme-original

related PR: #​2860

In Rspress V1 document, @theme is the alias for rspress/theme, but @theme is an alias which points to theme/index.tsx and falls back to rspress/theme.

rspress/theme or @rspress/core/theme points to Rspress's theme-default, they are actually different things.

We standardize this behavior, which is the same as docusaurus.

  1. In docs directory, @theme or @rspress/core/theme should be used, which points to theme/index.tsx and falls back to theme-default

  2. In theme directory , @theme-original or @rspress/core/theme-original should be used, which always points to Rspress's theme-default, used for users to customize themes, which is very useful for users who publish npm theme packages.

 // theme/index.tsx
- import { Layout as BasicLayout } from 'rspress/theme'; // or @​rspress/core/theme
+ import { Layout } from '@​rspress/core/theme-original';

 const Layout = () => {
    return <BasicLayout {...} />
 }
 
 export { Layout }
- export * from 'rspress/theme' // or @&#8203;rspress/core/theme
+ export * from '@&#8203;rspress/core/theme-original';
Merge @theme-assets to @theme

Before

We have a separate entry for exporting @​theme-assets

import { SvgWrapper } from '@&#8203;theme'
import SearchSvg from '@&#8203;theme-assets/Search';

<SvgWrapper icon={SearchSvg} />

After

@theme-assets has been removed. Icons are exported from @theme and prefixed with Icon, for example: IconSearch

import { SvgWrapper, IconSearch } from '@&#8203;theme';

<SvgWrapper icon={IconSearch} />
                   ^? type Icon = React.FC<React.SVGProps<SVGSVGElement>> | string;
Refactor @rspress/plugin-preview and simplify usage

related PR: #​2806

Before: Required declarations in both config file and MDX file.

pluginPreview({
  previewMode: 'iframe',
  iframeOptions: { position: 'fixed' },
});
```tsx preview

```

After: Only declare in the MDX file.

```tsx preview="iframe-fixed"

```
What's Changed
New Features 🎉
Performance 🚀
  • perf(theme/useWindowSize): optimize useWindowSize with debounce to reduce resize handler calls by @​Copilot in #​2849
Bug Fixes 🐞
Document 📖
Other Changes
New Contributors

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.1...v2.0.0-rc.2

v2.0.0-rc.1

Compare Source

What's Changed

New Features 🎉
  • feat(theme): add transition isPending UI to Sidebar by @​SoonIter in #​2778
  • feat(plugin-twoslash): Make it possible to configure compilerOptions for TypeScript in twoslash by @​Karibash in #​2773
Bug Fixes 🐞
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.0...v2.0.0-rc.1

v2.0.0-rc.0

Compare Source

Highlights

💄 Brand new theme

related PR: #​2738, #​2719, #​2698, #​2690, #​2533, #​2656

1. BEM classname 🕶

All built-in components now adopt BEM naming. This is a rather old-school choice, but a deliberate one based on user feedback.

Compared with Tailwind CSS, it allows you to flexibly adjust styles anywhere using standard CSS selectors, without restrictions.
For user-side customized doc components, you are free to choose any styling approach — including Tailwind CSS — without worrying about conflicts with Rspress’s default styles.


2. Built-in Default i18n Text 🌏

related PR: #​2738

The new theme includes a set of default translation strings and supports "treeshaking" based on the languages configured in your project:

  • If your documentation includes only en and zh, only those languages will be bundled.

  • For languages not supported by Rspress, it automatically falls back to en.

In most cases, you barely need to configure any i18n text manually, which significantly improves usability. You only need to configure i18nSource in rspress.config.ts when a language is missing or when you want to override built-in texts.

In 2.0.0-rc.0, based on contributions from the community, Rspress now includes four built-in languages: zh, en, ja, and ko.

Welcome more contributors to help improve and expand the default language texts.

More info: https://github.com/web-infra-dev/rspress/discussions/1891#discussioncomment-14933678


3. More CSS Variables 💄

Rspress now exposes additional CSS variables covering theme colors, shiki, code blocks, the homepage, and more — greatly enhancing customization capabilities.

You can experiment with them interactively at https://v2.rspress.rs/ui/vars, preview the results in real time, and copy the variables directly into your project.


4. rspress eject 🆕

related PR: #​2726

rspress eject is a brand-new CLI command that copies the source code of Rspress’s built-in components into your project’s theme/components directory.

For example:

rspress eject DocFooter

This gives you the full source of the DocFooter component, enabling you to customize it freely, such as adding license information.

Deep customization becomes effortless.

The rspress eject feature is still in testing, and we’ll continue improving the documentation and providing more good customization examples.


5. Improved Documentation Reading Experience 📖

Most colors and visual styles have been redesigned and refined by our designers, significantly enhancing the overall visual appeal and reading experience.

What's Changed

New Features 🎉
Performance 🚀
Bug Fixes 🐞
Document 📖
Other Changes

New Contributors

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.35...v2.0.0-rc.0

v2.0.0-beta.35

Compare Source

What's Changed

New Features 🎉
  • feat(theme): add prop dlx to PackageManagerTabs for npx pnpm dlx etc by @​Nsttt in #​2623
  • feat(auto-nav-sidebar): add new type: "dir-section-header" by @​SoonIter in #​2643
  • chore: cherry-pick ssg-md to beta.34 in #​2680
Bug Fixes 🐞
  • fix(auto-nav-sidebar): should extract tag and fix the chunks word break by @​SoonIter in #​2652
Document 📖
Other Changes

New Contributors

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.34...v2.0.0-beta.35

v2.0.0-beta.34

Compare Source

Highlights

💄 Upgrade to docsearch@4 within @​rspress/plugin-algolia

related PR: #​2620

This will improve Rspress's UI, and you can use new docsearch features such as askAi.

DocSearch v4 provides a significant upgrade over previous versions, offering enhanced accessibility, responsiveness, and an improved search experience for your documentation. Built on Algolia Autocomplete, DocSearch v4 ensures a seamless integration trusted by leading documentation sites worldwide.

ref: https://docsearch.algolia.com/docs/migrating-from-v3

image image

What's Changed

New Features 🎉
Bug Fixes 🐞
Document 📖
Other Changes

New Contributors

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.33...v2.0.0-beta.34

v2.0.0-beta.33

Compare Source

Breaking Changes🚨

Make raw HTML in md styled

related PR: #​2600

Rspress is now driven by CSS for style, ref: https://github.com/web-infra-dev/rspress/blob/main/packages/theme-default/src/styles/doc.scss

So you can:

  • Use original html tag like <ul><li>this is a line</li></ul>, they will now be styled the same as * this is a line
  • do not need to use Rspress's built-in const { h1: H1 } = getCustomMdxComponents() to annotate styles
  • For components that do not wish to be polluted by Rspress prose CSS, .rp-not-doc is all you needed

## List

- list item 1   <------ styled
- list item 2

<ul>
  <li>list item 1</li>       <------ styled
  <li>list item 2</li>
</ul>

<div className="rp-not-doc">        <----- not styled
  <ul>
    <li>list item 1</li>
    <li>list item 2</li>
  </ul>
</div>

<ul className="rp-not-doc>   <----- not styled
  <li>list item 1</li>
  <li>list item 2</li>
</ul>

What's Changed

New Features 🎉
  • feat(theme-default): Make the tab component usable in layouts other than DocLayout by @​Karibash in #​2589
  • feat(theme/style)!: keep the html style be consistent with markdown syntax and .rp-not-doc escape hatch (#​2579) by @​SoonIter in #​2600
Bug Fixes 🐞
Document 📖
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.32...v2.0.0-beta.33

v2.0.0-beta.32

Compare Source

Highlights

️ Support _meta.json and _nav.json HMR

related PR: #​2549

After a period of refactoring around virtual modules, Rspress now supports HMR for both *meta.json and *nav.json files.

This means you no longer need to restart the dev server when modifying _meta.json files, which will significantly improve your debugging speed for nav and sidebar configurations.

img_v3_02pq_a42d8229-315d-49b0-a72a-b739a586cb6g

What's Changed

New Features 🎉
Bug Fixes 🐞
Document 📖
Other Changes

New Contributors

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.31...v2.0.0-beta.32

v2.0.0-beta.31

Compare Source

What's Changed

New Features 🎉
Bug Fixes 🐞
Document 📖
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.30...v2.0.0-beta.31

v2.0.0-beta.30

Compare Source

Highlights

🆕@​rspress/plugin-twoslash

related PR: #​2527

Thanks to Shiki's excellent Twoslash integration, we're excited to introduce @rspress/plugin-twoslash in this milestone 2.0.0-beta.30 release! Now you can easily add rich type annotations to your code blocks using "```ts twoslash"

Special thanks to Rspress contributor @​Karibash for making this possible. Check out the @​rspress/plugin-twoslash documentation to get started!

ref: https://v2.rspress.rs/plugin/official-plugins/twoslash

Frame 1912054720
️Enable Rspack native watcher by default and bump Rspack@1.5.2

related PR: #​2472

Previously, Rspack relied on the watchpack file system watcher to track file changes. However, we identified performance bottlenecks with watchpack. For example, each file change triggers the creation of a new instance, consuming significant CPU and memory in large projects (see #​7490).

Now Rspress has been upgraded to Rspack 1.5.2 and enable native watcher by default, it will have better HMR perf and lazy compilation perf.

ref: https://rspack.rs/blog/announcing-1-5#faster-file-system-watcher

What's Changed

New Features 🎉
Bug Fixes 🐞
  • fix(core): allow user can deploy to both http://a.com/base/ and http://a.com/base by @​SoonIter in #​2536
  • fix(native-watcher): Infinite watch removed i18n.json by @​SoonIter in #​2540
  • fix(plugin-twoslash): Prevent the contents of the popup from being copied when copying code by @​Karibash in #​2538
Other Changes

New Contributors

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.29...v2.0.0-beta.30

v2.0.0-beta.29

Compare Source

What's Changed

New Features 🎉
Bug Fixes 🐞
  • fix(virtual-module): should addDependencies in virtual-module for persistent cache by @​SoonIter in #​2519
  • fix: command using object fully customize don't call normalize by @​zoolsher in #​2528
Document 📖
Other Changes

New Contributors

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.28...v2.0.0-beta.29

v2.0.0-beta.28

Compare Source

What's Changed

New Features 🎉
Bug Fixes 🐞
Document 📖
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.27...v2.0.0-beta.28

v2.0.0-beta.27

Compare Source

Highlights

Add layer for base.css to support tailwind v4

related PR: #​2477

What's Changed

New Features 🎉
Bug Fixes 🐞
Document 📖
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.26...v2.0.0-beta.27

v2.0.0-beta.26

Compare Source

What's Changed

Bug Fixes 🐞
Document 📖
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.25...v2.0.0-beta.26

v2.0.0-beta.25

Compare Source

Highlights

Enable trusted publishing for npm packages OIDC ♻️

related PR: #​2444

ref: https://docs.npmjs.com/trusted-publishers

image
UI Display of plugin-llms update 🆕

related PR: #​2439

image

What's Changed

New Features 🎉
Bug Fixes 🐞
Document 📖
Other Changes

New Contributors

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.24...v2.0.0-beta.25

v2.0.0-beta.24

Compare Source

Highlights

UI LlmsCopyButton of llms.txt 🤖

related PR: #​2426

We hope that llms.txt will have a greater role in AI era. Thanks to fumadocs, it is inspired from fumadocs's docsite

image

ref: https://v2.rspress.rs/plugin/official-plugins/llms#2-ui-display

What's Changed

New Features 🎉
Bug Fixes 🐞
Document 📖
Other Changes

Full Changelog: https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.23...v2.0.0-beta.24


Configuration

📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.


  • If you want to rebase/retry this PR, check this box

This PR has been generated by Renovate Bot.

This PR contains the following updates: | Package | Change | [Age](https://docs.renovatebot.com/merge-confidence/) | [Confidence](https://docs.renovatebot.com/merge-confidence/) | |---|---|---|---| | [@rspress/plugin-sitemap](https://github.com/web-infra-dev/rspress) ([source](https://github.com/web-infra-dev/rspress/tree/HEAD/packages/plugin-sitemap)) | [`2.0.0-beta.23` → `2.0.0`](https://renovatebot.com/diffs/npm/@rspress%2fplugin-sitemap/2.0.0-beta.23/2.0.0) | ![age](https://developer.mend.io/api/mc/badges/age/npm/@rspress%2fplugin-sitemap/2.0.0?slim=true) | ![confidence](https://developer.mend.io/api/mc/badges/confidence/npm/@rspress%2fplugin-sitemap/2.0.0-beta.23/2.0.0?slim=true) | --- ### Release Notes <details> <summary>web-infra-dev/rspress (@&#8203;rspress/plugin-sitemap)</summary> ### [`v2.0.0-rc.8`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-rc.8) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.7...v2.0.0-rc.8) <!-- Release notes generated using configuration in .github/release.yml at main --> ##### What's Changed ##### New Features 🎉 - feat(theme/HomeHero): add new hero image slot and add interactive to document by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3051](https://github.com/web-infra-dev/rspress/pull/3051) - feat(plugin-playground)!: change defaultRenderMode to 'pure' and support combined usage with plugin-preview by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3059](https://github.com/web-infra-dev/rspress/pull/3059) ##### Document 📖 - docs(css-vars): improve generateThemeCssVariables scope matching for better theme color extraction by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3058](https://github.com/web-infra-dev/rspress/pull/3058) ##### Other Changes - chore(deps): update dependency [@&#8203;docsearch/css](https://github.com/docsearch/css) to ^4.5.3 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;3055](https://github.com/web-infra-dev/rspress/pull/3055) - chore(deps): update dependency [@&#8203;docsearch/react](https://github.com/docsearch/react) to ^4.5.3 ([#&#8203;3055](https://github.com/web-infra-dev/rspress/issues/3055)) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3056](https://github.com/web-infra-dev/rspress/pull/3056) - chore(theme/nav): fix hover menu exit transition in nav dropdowns by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;3043](https://github.com/web-infra-dev/rspress/pull/3043) - refactor(theme): remove navbar compatibility class names and update Algolia docs by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3057](https://github.com/web-infra-dev/rspress/pull/3057) - Release v2.0.0-rc.8 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3061](https://github.com/web-infra-dev/rspress/pull/3061) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.7...v2.0.0-rc.8> ### [`v2.0.0-rc.7`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-rc.7) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.6...v2.0.0-rc.7) <!-- Release notes generated using configuration in .github/release.yml at main --> ##### What's Changed ##### New Features 🎉 - feat(theme/SvgWrapper): icon field support svg and img icon in HomeLayout by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3036](https://github.com/web-infra-dev/rspress/pull/3036) - feat(theme/icon): extract IconLink use in LlmsViewOptions by [@&#8203;jaworek](https://github.com/jaworek) in [#&#8203;3046](https://github.com/web-infra-dev/rspress/pull/3046) ##### Bug Fixes 🐞 - fix(theme/Llms): use SvgWrapper in Llms by [@&#8203;jaworek](https://github.com/jaworek) in [#&#8203;3045](https://github.com/web-infra-dev/rspress/pull/3045) ##### Document 📖 - docs: fix custom theme examples and update documentation by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3035](https://github.com/web-infra-dev/rspress/pull/3035) - docs: improve Overview page and custom-theme related pages by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3037](https://github.com/web-infra-dev/rspress/pull/3037) - docs: improve documentation and sync zh/en by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3040](https://github.com/web-infra-dev/rspress/pull/3040) - docs(ssg-md): improve document structure for better usability by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3047](https://github.com/web-infra-dev/rspress/pull/3047) ##### Other Changes - chore(deps): update dependency lodash-es to v4.17.23 \[security] by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;3038](https://github.com/web-infra-dev/rspress/pull/3038) - chore(theme): remove unused icons and update docs by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3048](https://github.com/web-infra-dev/rspress/pull/3048) - chore(theme): standardize link icon SVG attributes format by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3049](https://github.com/web-infra-dev/rspress/pull/3049) - chore(deps): upgrade rsbuild to 2.0.0-alpha.2 by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;3050](https://github.com/web-infra-dev/rspress/pull/3050) - Release v2.0.0-rc.7 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3052](https://github.com/web-infra-dev/rspress/pull/3052) ##### New Contributors - [@&#8203;jaworek](https://github.com/jaworek) made their first contribution in [#&#8203;3045](https://github.com/web-infra-dev/rspress/pull/3045) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.6...v2.0.0-rc.7> ### [`v2.0.0-rc.6`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-rc.6) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.5...v2.0.0-rc.6) <!-- Release notes generated using configuration in .github/release.yml at main --> ##### What's Changed ##### New Features 🎉 - feat(core): auto-extract description from first contentful line in extractPageData by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3006](https://github.com/web-infra-dev/rspress/pull/3006) - feat(theme/nav): Added fancy transition to nav background by [@&#8203;elliotcourant](https://github.com/elliotcourant) in [#&#8203;3017](https://github.com/web-infra-dev/rspress/pull/3017) - feat(theme): make NavTitle component ejectable by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3022](https://github.com/web-infra-dev/rspress/pull/3022) - feat(core): add `markdown.extractDescription` config by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3023](https://github.com/web-infra-dev/rspress/pull/3023) - feat(core): move Llms runtime components from plugin-llms to core/theme by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3026](https://github.com/web-infra-dev/rspress/pull/3026) - feat(core): add logoHref config option by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3012](https://github.com/web-infra-dev/rspress/pull/3012) - feat(ssg-md)!: add llmsUI config option to automatically show LlmsCopyButton and LlmsViewOptions when set `llms: true` by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3029](https://github.com/web-infra-dev/rspress/pull/3029) ##### Performance 🚀 - perf(core): skip search index generation when search is disabled by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3031](https://github.com/web-infra-dev/rspress/pull/3031) ##### Bug Fixes 🐞 - fix(theme): fix inline code style in Callout when code is direct child of content by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2997](https://github.com/web-infra-dev/rspress/pull/2997) - fix(config/types): defineConfig should support asyncFn by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3000](https://github.com/web-infra-dev/rspress/pull/3000) - fix(core): improve i18n missing keys warning with configuration hints by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3030](https://github.com/web-infra-dev/rspress/pull/3030) - fix(ssg): collapse experimentalExcludeRoutePaths log when too many routes are ignored by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3032](https://github.com/web-infra-dev/rspress/pull/3032) ##### Document 📖 - docs: add troubleshooting tip for @&#8203;rspress/core/theme-original export errors in migration guide by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2984](https://github.com/web-infra-dev/rspress/pull/2984) - docs(guide): rewrite SSG documentation with comprehensive explanations by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2985](https://github.com/web-infra-dev/rspress/pull/2985) - docs(ssg): add 404.html to output structure and troubleshooting for page refresh 404 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2987](https://github.com/web-infra-dev/rspress/pull/2987) - docs: improve conventional route documentation with better examples and best practices by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2995](https://github.com/web-infra-dev/rspress/pull/2995) - docs: add Callout component documentation by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2998](https://github.com/web-infra-dev/rspress/pull/2998) - docs: add tip for pageType: doc-wide usage with outline: false by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3005](https://github.com/web-infra-dev/rspress/pull/3005) - docs: add frontmatter description to guide docs (zh & en) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3007](https://github.com/web-infra-dev/rspress/pull/3007) - docs: Update documentation and improve frontmatter references by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3009](https://github.com/web-infra-dev/rspress/pull/3009) - docs: improve static assets documentation structure and clarifiy public folder usage by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3011](https://github.com/web-infra-dev/rspress/pull/3011) - docs: simplify CSS modification state management by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3014](https://github.com/web-infra-dev/rspress/pull/3014) - docs(zh): rename "预览页" to "Overview 页" for terminology consistency by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3016](https://github.com/web-infra-dev/rspress/pull/3016) - docs(theme): refactor home page and component documentation by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3015](https://github.com/web-infra-dev/rspress/pull/3015) - docs: remove URL parameters as switches section from custom page docs by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3024](https://github.com/web-infra-dev/rspress/pull/3024) - docs(description): add description frontmatter to ui documentation files by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3008](https://github.com/web-infra-dev/rspress/pull/3008) ##### Other Changes - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2991](https://github.com/web-infra-dev/rspress/pull/2991) - chore(deps): update dependency react-router-dom to ^7.12.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2992](https://github.com/web-infra-dev/rspress/pull/2992) - chore(deps): update pnpm to v10.28.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2993](https://github.com/web-infra-dev/rspress/pull/2993) - chore(deps): update shiki monorepo to ^3.21.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2994](https://github.com/web-infra-dev/rspress/pull/2994) - chore(deps): upgrade [@&#8203;rslib/core](https://github.com/rslib/core) 0.19.2 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3002](https://github.com/web-infra-dev/rspress/pull/3002) - refactor(plugin-rss)!: requires the `ssg` config, and remove `_html` field by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3003](https://github.com/web-infra-dev/rspress/pull/3003) - refactor(core): replace [@&#8203;rspress/mdx-rs](https://github.com/rspress/mdx-rs) and html-to-text with [@&#8203;mdx-js/mdx](https://github.com/mdx-js/mdx) createProcessor for toc and searchIndex generation by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3001](https://github.com/web-infra-dev/rspress/pull/3001) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;3018](https://github.com/web-infra-dev/rspress/pull/3018) - chore(deps): update actions/setup-node action to v6.2.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;3019](https://github.com/web-infra-dev/rspress/pull/3019) - chore(deps): update dependency cspell to ^9.6.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;3021](https://github.com/web-infra-dev/rspress/pull/3021) - chore(deps): update dependency [@&#8203;rsdoctor/rspack-plugin](https://github.com/rsdoctor/rspack-plugin) to v1.5.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;3020](https://github.com/web-infra-dev/rspress/pull/3020) - chore(ssg): `experimentalExcludeRoutePaths` warning level to info by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3025](https://github.com/web-infra-dev/rspress/pull/3025) - Release v2.0.0-rc.6 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;3033](https://github.com/web-infra-dev/rspress/pull/3033) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.5...v2.0.0-rc.6> ### [`v2.0.0-rc.5`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-rc.5) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.4...v2.0.0-rc.5) <!-- Release notes generated using configuration in .github/release.yml at main --> ##### What's Changed ##### New Features 🎉 - feat(theme): support clickable badge in HomeHero by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2969](https://github.com/web-infra-dev/rspress/pull/2969) - feat(ssg-md): add SSG-MD support to OverviewGroup and FallbackHeading components (Vibe Kanban) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2966](https://github.com/web-infra-dev/rspress/pull/2966) ##### Bug Fixes 🐞 - fix: use layout effect for theme sync by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2961](https://github.com/web-infra-dev/rspress/pull/2961) - fix(theme): use modern sidebar CSS to respect system scrollbar settings by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2973](https://github.com/web-infra-dev/rspress/pull/2973) - fix(theme/nav): Fixed small layout shift on scroll by [@&#8203;elliotcourant](https://github.com/elliotcourant) in [#&#8203;2980](https://github.com/web-infra-dev/rspress/pull/2980) - fix(theme): Fixed step counter text alignment by [@&#8203;elliotcourant](https://github.com/elliotcourant) in [#&#8203;2981](https://github.com/web-infra-dev/rspress/pull/2981) ##### Document 📖 - docs: update links from rspack-contrib to rstackjs by [@&#8203;chenjiahan](https://github.com/chenjiahan) in [#&#8203;2953](https://github.com/web-infra-dev/rspress/pull/2953) - docs: add migrate from V1 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2954](https://github.com/web-infra-dev/rspress/pull/2954) - docs: add missing Layout slots (beforeNavMenu, afterNav) and add Layout Slots heading (Vibe Kanban) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2964](https://github.com/web-infra-dev/rspress/pull/2964) - docs: remove work-in-progress warning from CSS variables documentation (Vibe Kanban) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2972](https://github.com/web-infra-dev/rspress/pull/2972) - docs: add prettier-ignore to wrapCode examples in code-blocks documentation by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2974](https://github.com/web-infra-dev/rspress/pull/2974) - docs: improve plugin-llms warning about implementation limitations and SSR compatibility by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2975](https://github.com/web-infra-dev/rspress/pull/2975) - docs: add rspress-plugin-file-tree and use tree syntax for file tree code blocks by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2976](https://github.com/web-infra-dev/rspress/pull/2976) - docs: update auto-nav-sidebar to recommend index.mdx for dir, index convention by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2978](https://github.com/web-infra-dev/rspress/pull/2978) - docs: Update introduction and index for Rspress V2 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2971](https://github.com/web-infra-dev/rspress/pull/2971) - docs: add documentation for markdown.crossCompilerCache option by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2979](https://github.com/web-infra-dev/rspress/pull/2979) ##### Other Changes - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2957](https://github.com/web-infra-dev/rspress/pull/2957) - chore(deps): update dependency [@&#8203;rslib/core](https://github.com/rslib/core) to v0.19.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2959](https://github.com/web-infra-dev/rspress/pull/2959) - chore(deps): update dependency [@&#8203;unhead/react](https://github.com/unhead/react) to ^2.1.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2960](https://github.com/web-infra-dev/rspress/pull/2960) - chore(deps): update dependency [@&#8203;rsbuild/core](https://github.com/rsbuild/core) to \~1.7.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2958](https://github.com/web-infra-dev/rspress/pull/2958) - refactor(theme/dark): simplify useThemeState hook and avoid dark mode flash by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2955](https://github.com/web-infra-dev/rspress/pull/2955) - refactor!: merge [@&#8203;rspress/runtime](https://github.com/rspress/runtime) into [@&#8203;rspress/core](https://github.com/rspress/core) package and remove [@&#8203;rspress/runtime](https://github.com/rspress/runtime) package by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2935](https://github.com/web-infra-dev/rspress/pull/2935) - chore(core): expose routePathToMdPath utility in runtime by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2967](https://github.com/web-infra-dev/rspress/pull/2967) - chore(deps): update rspress-plugin-file-tree to ^1.0.3 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2977](https://github.com/web-infra-dev/rspress/pull/2977) - Release v2.0.0-rc.5 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2982](https://github.com/web-infra-dev/rspress/pull/2982) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.4...v2.0.0-rc.5> ### [`v2.0.0-rc.4`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-rc.4) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.3...v2.0.0-rc.4) <!-- Release notes generated using configuration in .github/release.yml at main --> ##### What's Changed ##### New Features 🎉 - feat(ssg-md): support Overview and HomeLayout by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2933](https://github.com/web-infra-dev/rspress/pull/2933) - feat(core): add import.meta.env.SSR and import.meta.env.SSG\_MD by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2948](https://github.com/web-infra-dev/rspress/pull/2948) - feat(theme/nav): support multiple level nested navigation items by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2943](https://github.com/web-infra-dev/rspress/pull/2943) - feat(nodejs)!: drop support of node 18, upgrade engines to `node >= 20.9.0` by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2924](https://github.com/web-infra-dev/rspress/pull/2924) ##### Bug Fixes 🐞 - fix(core): `Iterator#map` is only available on Node 22+ by [@&#8203;JounQin](https://github.com/JounQin) in [#&#8203;2923](https://github.com/web-infra-dev/rspress/pull/2923) - fix(theme/Sidebar): sidebar should also listen location changes by [@&#8203;JounQin](https://github.com/JounQin) in [#&#8203;2922](https://github.com/web-infra-dev/rspress/pull/2922) - fix(theme): improve SSR compatibility by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2934](https://github.com/web-infra-dev/rspress/pull/2934) - fix: hover group links should also calc active with matchNavbar by default by [@&#8203;JounQin](https://github.com/JounQin) in [#&#8203;2930](https://github.com/web-infra-dev/rspress/pull/2930) - fix(theme/Nav): render empty nav items correctly not link by [@&#8203;JounQin](https://github.com/JounQin) in [#&#8203;2929](https://github.com/web-infra-dev/rspress/pull/2929) - fix(theme/Layout): render `beforeNavMenu` correctly by [@&#8203;JounQin](https://github.com/JounQin) in [#&#8203;2822](https://github.com/web-infra-dev/rspress/pull/2822) - fix(ssg-md): use .md links instead of .html in Overview SSG-MD mode by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2944](https://github.com/web-infra-dev/rspress/pull/2944) - fix(plugin-algolia): upgrade docsearch and fix the css regression by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2946](https://github.com/web-infra-dev/rspress/pull/2946) - fix(theme/Codeblock): revert the code shadow and enhance the separator line by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2931](https://github.com/web-infra-dev/rspress/pull/2931) - fix(plugin-algolia): should remove base by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2949](https://github.com/web-infra-dev/rspress/pull/2949) ##### Document 📖 - docs: Add wrap vs eject guides for customizing Rspress theme by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2906](https://github.com/web-infra-dev/rspress/pull/2906) - docs: upgrade custom-theme and add wrap and eject by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2925](https://github.com/web-infra-dev/rspress/pull/2925) - docs: upgrade llms.txt and ssg-md by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2927](https://github.com/web-infra-dev/rspress/pull/2927) - docs: fix og-image cjk wrong font and title slice logic by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2919](https://github.com/web-infra-dev/rspress/pull/2919) - docs: typo translate by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2932](https://github.com/web-infra-dev/rspress/pull/2932) - docs: fix the shiki highlighter ansi "/" by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2947](https://github.com/web-infra-dev/rspress/pull/2947) - docs: add SSG vs SSG-MD comparison table by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2950](https://github.com/web-infra-dev/rspress/pull/2950) ##### Other Changes - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2938](https://github.com/web-infra-dev/rspress/pull/2938) - chore(deps): update dependency [@&#8203;docsearch/css](https://github.com/docsearch/css) to ^4.4.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2939](https://github.com/web-infra-dev/rspress/pull/2939) - chore(deps): update dependency [@&#8203;docsearch/react](https://github.com/docsearch/react) to ^4.4.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2941](https://github.com/web-infra-dev/rspress/pull/2941) - chore(deps): update dependency [@&#8203;rsdoctor/rspack-plugin](https://github.com/rsdoctor/rspack-plugin) to v1.4.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2942](https://github.com/web-infra-dev/rspress/pull/2942) - Release v2.0.0-rc.4 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2936](https://github.com/web-infra-dev/rspress/pull/2936) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.3...v2.0.0-rc.4> ### [`v2.0.0-rc.3`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-rc.3) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.2...v2.0.0-rc.3) <!-- Release notes generated using configuration in .github/release.yml at main --> ##### Highlights ✨ ##### 🆕️ Support common tags > related PR: [#&#8203;2879](https://github.com/web-infra-dev/rspress/pull/2879) - ref: <https://v2.rspress.rs/ui/components/tag> You can use it in the frontmatter, and it also supports customization: ```md --- tag: new, experimental, ejectable --- ``` <img width="3057" height="1981" alt="image" src="https://github.com/user-attachments/assets/2cb32161-a659-474f-a97f-84320f09b537" /> ##### 🌏 Enable `text-autospace: normal;` by default > related PR: [#&#8203;2920](https://github.com/web-infra-dev/rspress/pull/2920) The text-autospace CSS property allows you to specify the space applied between Chinese/Japanese/Korean (CJK) and non-CJK characters. - ref: <https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/text-autospace> ```css /* If you don't like it, you can cancel it via `:root { text-autospace: unset; }` */ :root { text-autospace: normal; } ``` ##### What's Changed ##### New Features 🎉 - feat(plugin-typedoc): allow customize the docs/api/\_meta.json and track in git by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2869](https://github.com/web-infra-dev/rspress/pull/2869) - feat(theme/tags): allow frontmatter tag by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2879](https://github.com/web-infra-dev/rspress/pull/2879) - feat(theme): add text-autospace: normal; by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2920](https://github.com/web-infra-dev/rspress/pull/2920) ##### Bug Fixes 🐞 - fix(core): Fix an issue where llms.txt was not generated when locales was not set by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2866](https://github.com/web-infra-dev/rspress/pull/2866) - fix(plugin-algolia): add missing constant by [@&#8203;dragomano](https://github.com/dragomano) in [#&#8203;2865](https://github.com/web-infra-dev/rspress/pull/2865) - fix(theme/Link): add forwardRef for react 18 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2871](https://github.com/web-infra-dev/rspress/pull/2871) - fix(theme/NavScreen): Disable clicks on active language/version entries in mobile nav by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2883](https://github.com/web-infra-dev/rspress/pull/2883) - fix(cli/eject): fix the component path not right by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2896](https://github.com/web-infra-dev/rspress/pull/2896) - fix(theme/CodeBlockRuntime): Render SSR fallback for CodeBlockRuntime to avoid first-paint empty DOM/CLS by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2902](https://github.com/web-infra-dev/rspress/pull/2902) - fix: do not modify singleton global sidebar by [@&#8203;JounQin](https://github.com/JounQin) in [#&#8203;2911](https://github.com/web-infra-dev/rspress/pull/2911) ##### Document 📖 - docs(codeblock): a typo by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2868](https://github.com/web-infra-dev/rspress/pull/2868) - docs(temp-fix-workaround): add shiki langs for markdown codeblock unstable bundle size by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2874](https://github.com/web-infra-dev/rspress/pull/2874) - docs: Polish Rspress V2 bilingual docs for navigation, MDX usage, and UI components by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2875](https://github.com/web-infra-dev/rspress/pull/2875) - docs: add Chinese guide for llms.txt SSG-MD output by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2877](https://github.com/web-infra-dev/rspress/pull/2877) - docs: adjust structure by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2884](https://github.com/web-infra-dev/rspress/pull/2884) - docs(ui): Add PackageManagerTabs component docs in en/zh UI sections by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2882](https://github.com/web-infra-dev/rspress/pull/2882) - docs(api): add rspress eject command documentation by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2886](https://github.com/web-infra-dev/rspress/pull/2886) - docs: Split runtime hook docs into dedicated UI hook pages by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2885](https://github.com/web-infra-dev/rspress/pull/2885) - docs: describe useSite/usePage runtime hooks by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2887](https://github.com/web-infra-dev/rspress/pull/2887) - docs: add components by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2891](https://github.com/web-infra-dev/rspress/pull/2891) - docs(theme): Clarify LastUpdated configuration and customization guidance by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2901](https://github.com/web-infra-dev/rspress/pull/2901) - docs: add preview for some codeblocks by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2907](https://github.com/web-infra-dev/rspress/pull/2907) - docs: Add usePages and useFrontmatter hook docs with overview example and HMR note by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2905](https://github.com/web-infra-dev/rspress/pull/2905) - docs: add pluginOg and og-image to rspress docsite by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2835](https://github.com/web-infra-dev/rspress/pull/2835) ##### Other Changes - chore(theme/CodeBlock): add box-shadow to codeblock by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2863](https://github.com/web-infra-dev/rspress/pull/2863) - test: use Rstest as Rspress's test framework by [@&#8203;9aoy](https://github.com/9aoy) in [#&#8203;2413](https://github.com/web-infra-dev/rspress/pull/2413) - chore(theme/Codeblock): beautify the shiki highlight by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2864](https://github.com/web-infra-dev/rspress/pull/2864) - chore(theme/Tabs): update style when nested Tabs in Tabs by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2870](https://github.com/web-infra-dev/rspress/pull/2870) - chore(create-rspress): Add React 19 dependencies to create-rspress template by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2873](https://github.com/web-infra-dev/rspress/pull/2873) - chore(deps): upgrade rsbuild and not show warning for \_\_dirname and \_\_filename when bundling for web by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2878](https://github.com/web-infra-dev/rspress/pull/2878) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2889](https://github.com/web-infra-dev/rspress/pull/2889) - chore(deps): update pnpm to v10.25.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2890](https://github.com/web-infra-dev/rspress/pull/2890) - chore(deps): update shiki monorepo to ^3.20.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2892](https://github.com/web-infra-dev/rspress/pull/2892) - chore(deps): update actions/cache action to v5 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2893](https://github.com/web-infra-dev/rspress/pull/2893) - chore(auto-nav-sidebar): Improve missing page error readability by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2880](https://github.com/web-infra-dev/rspress/pull/2880) - chore(ci): update playwright test config by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2897](https://github.com/web-infra-dev/rspress/pull/2897) - chore: remove unused view transition code by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2898](https://github.com/web-infra-dev/rspress/pull/2898) - test(e2e): playwright support lazyCompilation after Rsbuild 1.4.0, remove RSPRESS\_LAZY\_COMPILATION=false by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2319](https://github.com/web-infra-dev/rspress/pull/2319) - chore(theme): better UI for overview items without headers case by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2899](https://github.com/web-infra-dev/rspress/pull/2899) - refactor(ssg-md): redesign the remarkSplitMdx split logic by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2903](https://github.com/web-infra-dev/rspress/pull/2903) - chore: remove unused min-height style by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2917](https://github.com/web-infra-dev/rspress/pull/2917) - chore(deps): update dependency react-router-dom to ^7.11.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2914](https://github.com/web-infra-dev/rspress/pull/2914) - chore(deps): update pnpm to v10.26.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2915](https://github.com/web-infra-dev/rspress/pull/2915) - chore(deps): update actions/upload-artifact action to v6 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2916](https://github.com/web-infra-dev/rspress/pull/2916) - chore(deps): update all patch dependencies - autoclosed by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2913](https://github.com/web-infra-dev/rspress/pull/2913) - chore(e2e): stable plugin-preview-custom-entry test by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2918](https://github.com/web-infra-dev/rspress/pull/2918) - Release v2.0.0-rc.3 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2921](https://github.com/web-infra-dev/rspress/pull/2921) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.2...v2.0.0-rc.3> ### [`v2.0.0-rc.2`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-rc.2) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.1...v2.0.0-rc.2) <!-- Release notes generated using configuration in .github/release.yml at main --> ##### Breaking Changes🚨 ##### `theme` folder should use `@rspress/core/theme-original` > related PR: [#&#8203;2860](https://github.com/web-infra-dev/rspress/pull/2860) In Rspress V1 document, `@theme` is the alias for `rspress/theme`, but `@theme` is an alias which points to `theme/index.tsx` and falls back to `rspress/theme`. `rspress/theme` or `@rspress/core/theme` points to Rspress's `theme-default`, they are actually different things. We standardize this behavior, which is the same as docusaurus. 1. In `docs` directory, `@theme` or `@rspress/core/theme` should be used, which points to `theme/index.tsx` and falls back to `theme-default` 2. In `theme` directory , `@theme-original` or `@rspress/core/theme-original` should be used, which always points to Rspress's `theme-default`, used for users to customize themes, which is very useful for users who publish npm theme packages. ```diff // theme/index.tsx - import { Layout as BasicLayout } from 'rspress/theme'; // or @&#8203;rspress/core/theme + import { Layout } from '@&#8203;rspress/core/theme-original'; const Layout = () => { return <BasicLayout {...} /> } export { Layout } - export * from 'rspress/theme' // or @&#8203;rspress/core/theme + export * from '@&#8203;rspress/core/theme-original'; ``` ##### Merge `@theme-assets` to `@theme` **Before** We have a separate entry for exporting [@&#8203;theme-assets](https://github.com/theme-assets) ```tsx import { SvgWrapper } from '@&#8203;theme' import SearchSvg from '@&#8203;theme-assets/Search'; <SvgWrapper icon={SearchSvg} /> ``` **After** `@theme-assets` has been removed. Icons are exported from `@theme` and prefixed with `Icon`, for example: `IconSearch` ```tsx import { SvgWrapper, IconSearch } from '@&#8203;theme'; <SvgWrapper icon={IconSearch} /> ^? type Icon = React.FC<React.SVGProps<SVGSVGElement>> | string; ``` ##### Refactor `@rspress/plugin-preview` and simplify usage > related PR: [#&#8203;2806](https://github.com/web-infra-dev/rspress/pull/2806) **Before: Required declarations in both config file and MDX file.** ```ts pluginPreview({ previewMode: 'iframe', iframeOptions: { position: 'fixed' }, }); ``` ````mdx ```tsx preview ``` ```` **After: Only declare in the MDX file.** ````mdx ```tsx preview="iframe-fixed" ``` ```` ##### What's Changed ##### New Features 🎉 - feat(plugin-preview)!: simplify the usage via `tsx preview="iframe-fixed"` and support hmr by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2806](https://github.com/web-infra-dev/rspress/pull/2806) - feat(plugin-preview): should support dark mode by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2816](https://github.com/web-infra-dev/rspress/pull/2816) - feat(i18n): add Russian translation for built-in i18n text by [@&#8203;dragomano](https://github.com/dragomano) in [#&#8203;2827](https://github.com/web-infra-dev/rspress/pull/2827) - feat(rspack)!: revert Rspack native watcher by default by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2830](https://github.com/web-infra-dev/rspress/pull/2830) - feat(plugin-typedoc): Upgrade to TypeDoc v0.28 with new API by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2790](https://github.com/web-infra-dev/rspress/pull/2790) - feat(mdx): support absolute paths with `<root>/` prefix in remarkFileCodeBlock by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2665](https://github.com/web-infra-dev/rspress/pull/2665) - feat(theme)!: custom theme should use `@rspress/core/theme-original` by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2860](https://github.com/web-infra-dev/rspress/pull/2860) - feat(theme/Root): add ejectable <Root /> component to theme by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2858](https://github.com/web-infra-dev/rspress/pull/2858) - feat(theme/Toc): Add data-depth attribute to TOC items by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2859](https://github.com/web-infra-dev/rspress/pull/2859) - feat(plugin-typedoc): Add setup callback for TypeDoc customization by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2841](https://github.com/web-infra-dev/rspress/pull/2841) ##### Performance 🚀 - perf(theme/useWindowSize): optimize useWindowSize with debounce to reduce resize handler calls by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2849](https://github.com/web-infra-dev/rspress/pull/2849) ##### Bug Fixes 🐞 - fix(theme): css vars color by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2791](https://github.com/web-infra-dev/rspress/pull/2791) - fix(theme): table should be scrollable and startTransition should not be a html attribute by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2792](https://github.com/web-infra-dev/rspress/pull/2792) - fix(theme): th width should be same with td by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2804](https://github.com/web-infra-dev/rspress/pull/2804) - fix(theme): plugin-preview should hide the toc by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2803](https://github.com/web-infra-dev/rspress/pull/2803) - fix(theme/Sidebar): pass down `onClick` prop by [@&#8203;JounQin](https://github.com/JounQin) in [#&#8203;2811](https://github.com/web-infra-dev/rspress/pull/2811) - fix(plugin-twoslash): Make twoslashOptions optional by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2819](https://github.com/web-infra-dev/rspress/pull/2819) - fix(ssg): wrong html selector for crawlers regression due to react\@&#8203;19.2.0 `progressiveChunkSize` change by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2831](https://github.com/web-infra-dev/rspress/pull/2831) - fix(theme/callout): link in callout should use currentColor by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2838](https://github.com/web-infra-dev/rspress/pull/2838) - fix(plugin-typedoc): allow typedoc plugin interface as usual by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2836](https://github.com/web-infra-dev/rspress/pull/2836) - fix(theme/outline): line-height of toc item by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2840](https://github.com/web-infra-dev/rspress/pull/2840) - fix(cli): should not restart when public folder change files by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2847](https://github.com/web-infra-dev/rspress/pull/2847) - fix(core): Fix an issue where the PackageManagerTabs component outputs broken Markdown by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2861](https://github.com/web-infra-dev/rspress/pull/2861) ##### Document 📖 - docs: update package manager command from beta to rc by [@&#8203;chenjiahan](https://github.com/chenjiahan) in [#&#8203;2800](https://github.com/web-infra-dev/rspress/pull/2800) - docs: Add "new" tag to plugin documentation for new v1 plugins by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2851](https://github.com/web-infra-dev/rspress/pull/2851) ##### Other Changes - chore(theme/doc): add border to inline text code by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2796](https://github.com/web-infra-dev/rspress/pull/2796) - chore(deps)!: update dependency react-router-dom to v7 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;1802](https://github.com/web-infra-dev/rspress/pull/1802) - chore(deps): update actions/checkout digest to [`34e1148`](https://github.com/web-infra-dev/rspress/commit/34e1148) by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2798](https://github.com/web-infra-dev/rspress/pull/2798) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2799](https://github.com/web-infra-dev/rspress/pull/2799) - chore(deps): update dependency [@&#8203;rstack-dev/doc-ui](https://github.com/rstack-dev/doc-ui) to ^1.12.0 - autoclosed by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2802](https://github.com/web-infra-dev/rspress/pull/2802) - chore(deps): update dependency [@&#8203;rslib/core](https://github.com/rslib/core) to v0.18.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2801](https://github.com/web-infra-dev/rspress/pull/2801) - chore(infra): use [@&#8203;rslib/core](https://github.com/rslib/core) preserveModules by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2805](https://github.com/web-infra-dev/rspress/pull/2805) - chore(build): enable `redirect.dts.extension` to fix type issue by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2814](https://github.com/web-infra-dev/rspress/pull/2814) - chore(deps): update dependency prettier to v3.7.3 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2825](https://github.com/web-infra-dev/rspress/pull/2825) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2824](https://github.com/web-infra-dev/rspress/pull/2824) - chore: fix the diff.yml event by [@&#8203;yifancong](https://github.com/yifancong) in [#&#8203;2828](https://github.com/web-infra-dev/rspress/pull/2828) - chore(theme): export `FallbackHeading` for reusing by [@&#8203;JounQin](https://github.com/JounQin) in [#&#8203;2813](https://github.com/web-infra-dev/rspress/pull/2813) - chore: bump pnpm 10.24.0 and remove trust policy config by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2829](https://github.com/web-infra-dev/rspress/pull/2829) - chore(deps): update actions/checkout action to v6 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2833](https://github.com/web-infra-dev/rspress/pull/2833) - chore(deps): update actions/setup-node action to v6 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2834](https://github.com/web-infra-dev/rspress/pull/2834) - chore(theme/Tabs): upgrade hover style by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2837](https://github.com/web-infra-dev/rspress/pull/2837) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2842](https://github.com/web-infra-dev/rspress/pull/2842) - chore(deps): update dependency lint-staged to v16 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2844](https://github.com/web-infra-dev/rspress/pull/2844) - chore(deps): update playwright monorepo to v1.57.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2843](https://github.com/web-infra-dev/rspress/pull/2843) - chore(theme/Table): narrow table padding by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2845](https://github.com/web-infra-dev/rspress/pull/2845) - chore(Theme/outline): add shadow by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2846](https://github.com/web-infra-dev/rspress/pull/2846) - chore(plugin-algolia): Add Russian translation for plugin-algolia by [@&#8203;dragomano](https://github.com/dragomano) in [#&#8203;2832](https://github.com/web-infra-dev/rspress/pull/2832) - chore(core): truncate some error stack traces to 5 lines by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2821](https://github.com/web-infra-dev/rspress/pull/2821) - chore(build): use advanced ESM by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2848](https://github.com/web-infra-dev/rspress/pull/2848) - chore(deps): update dependency cspell to ^9.4.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2854](https://github.com/web-infra-dev/rspress/pull/2854) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2853](https://github.com/web-infra-dev/rspress/pull/2853) - chore(deps): update dependency react-router-dom to ^7.10.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2855](https://github.com/web-infra-dev/rspress/pull/2855) - chore(deps): update dependency rimraf to ^6.1.2 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2856](https://github.com/web-infra-dev/rspress/pull/2856) - Release v2.0.0-rc.2 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2862](https://github.com/web-infra-dev/rspress/pull/2862) ##### New Contributors - [@&#8203;dragomano](https://github.com/dragomano) made their first contribution in [#&#8203;2827](https://github.com/web-infra-dev/rspress/pull/2827) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.1...v2.0.0-rc.2> ### [`v2.0.0-rc.1`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-rc.1) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.0...v2.0.0-rc.1) <!-- Release notes generated using configuration in .github/release.yml at main --> #### What's Changed ##### New Features 🎉 - feat(theme): add transition isPending UI to Sidebar by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2778](https://github.com/web-infra-dev/rspress/pull/2778) - feat(plugin-twoslash): Make it possible to configure compilerOptions for TypeScript in twoslash by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2773](https://github.com/web-infra-dev/rspress/pull/2773) ##### Bug Fixes 🐞 - fix(theme): nprogress bar color by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2770](https://github.com/web-infra-dev/rspress/pull/2770) - fix(theme): button gradient color and add line-height back by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2771](https://github.com/web-infra-dev/rspress/pull/2771) - fix(theme): Link click area should be same by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2777](https://github.com/web-infra-dev/rspress/pull/2777) - fix(search): SearchPanel Enter keyboard not work regression by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2775](https://github.com/web-infra-dev/rspress/pull/2775) - fix(route): should be compatiable to lowercase routePath by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2776](https://github.com/web-infra-dev/rspress/pull/2776) - fix(theme): scroll should work in afterNav by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2779](https://github.com/web-infra-dev/rspress/pull/2779) - fix(theme): line-height of SourceCode component by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2783](https://github.com/web-infra-dev/rspress/pull/2783) - fix(theme): adjust line-height of sidebar and outline by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2784](https://github.com/web-infra-dev/rspress/pull/2784) - fix(theme): unused code by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2781](https://github.com/web-infra-dev/rspress/pull/2781) - fix(theme): section-header margin-top wrong selector by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2782](https://github.com/web-infra-dev/rspress/pull/2782) - fix(theme): h2 gap and twoslash codeblock style by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2786](https://github.com/web-infra-dev/rspress/pull/2786) - fix(theme): moon svg white border by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2788](https://github.com/web-infra-dev/rspress/pull/2788) ##### Other Changes - Release v2.0.0-rc.0 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2756](https://github.com/web-infra-dev/rspress/pull/2756) - chore(theme): NavScreenItem should handle external link by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2780](https://github.com/web-infra-dev/rspress/pull/2780) - chore(deps): update glob and rollup to solve security vulnerabilities by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2785](https://github.com/web-infra-dev/rspress/pull/2785) - Release v2.0.0-rc.1 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2789](https://github.com/web-infra-dev/rspress/pull/2789) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-rc.0...v2.0.0-rc.1> ### [`v2.0.0-rc.0`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-rc.0) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.35...v2.0.0-rc.0) <!-- Release notes generated using configuration in .github/release.yml at release_v2.0.0-rc.0 --> #### Highlights ✨ ##### 💄 Brand new theme > related PR: [#&#8203;2738](https://github.com/web-infra-dev/rspress/issues/2738), [#&#8203;2719](https://github.com/web-infra-dev/rspress/issues/2719), [#&#8203;2698](https://github.com/web-infra-dev/rspress/issues/2698), [#&#8203;2690](https://github.com/web-infra-dev/rspress/issues/2690), [#&#8203;2533](https://github.com/web-infra-dev/rspress/issues/2533), [#&#8203;2656](https://github.com/web-infra-dev/rspress/issues/2656) ##### 1. BEM classname 🕶 All built-in components now adopt BEM naming. This is a rather old-school choice, but a deliberate one based on user feedback. Compared with Tailwind CSS, it allows you to flexibly adjust styles anywhere using standard CSS selectors, without restrictions. For user-side customized doc components, you are free to choose any styling approach — including Tailwind CSS — without worrying about conflicts with Rspress’s default styles. *** ##### 2. Built-in Default i18n Text 🌏 > related PR: [#&#8203;2738](https://github.com/web-infra-dev/rspress/issues/2738) The new theme includes a set of default translation strings and supports "treeshaking" based on the languages configured in your project: - If your documentation includes only en and zh, only those languages will be bundled. - For languages not supported by Rspress, it automatically falls back to en. In most cases, you barely need to configure any i18n text manually, which significantly improves usability. You only need to configure i18nSource in rspress.config.ts when a language is missing or when you want to override built-in texts. In 2.0.0-rc.0, based on contributions from the community, Rspress now includes four built-in languages: zh, en, ja, and ko. Welcome more contributors to help improve and expand the default language texts. More info: <https://github.com/web-infra-dev/rspress/discussions/1891#discussioncomment-14933678> *** ##### 3. More CSS Variables 💄 Rspress now exposes additional CSS variables covering theme colors, shiki, code blocks, the homepage, and more — greatly enhancing customization capabilities. You can experiment with them interactively at <https://v2.rspress.rs/ui/vars>, preview the results in real time, and copy the variables directly into your project. *** ##### 4. `rspress eject` 🆕 > related PR: [#&#8203;2726](https://github.com/web-infra-dev/rspress/issues/2726) `rspress eject` is a brand-new CLI command that copies the source code of Rspress’s built-in components into your project’s theme/components directory. For example: `rspress eject DocFooter` This gives you the full source of the DocFooter component, enabling you to customize it freely, such as adding license information. > Deep customization becomes effortless. The `rspress eject` feature is still in testing, and we’ll continue improving the documentation and providing more good customization examples. *** ##### 5. Improved Documentation Reading Experience 📖 Most colors and visual styles have been redesigned and refined by our designers, significantly enhancing the overall visual appeal and reading experience. #### What's Changed ##### New Features 🎉 - feat(theme)!: fully theme refactor by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2533](https://github.com/web-infra-dev/rspress/pull/2533) - feat(theme): add Banner Component by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2654](https://github.com/web-infra-dev/rspress/pull/2654) - feat(theme)!: add CodeBlock / CodeButtonGroup components and migrate `.rp-doc-outline` to `rp-toc-include` by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2656](https://github.com/web-infra-dev/rspress/pull/2656) - feat(theme): add Deno support to PackageManagerTabs component by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2663](https://github.com/web-infra-dev/rspress/pull/2663) - style: deno svg adapt to dark mode by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2676](https://github.com/web-infra-dev/rspress/pull/2676) - feat: add new Component <PageTabs /> and fix link should have search query by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2683](https://github.com/web-infra-dev/rspress/pull/2683) - feat: ssg-md by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2666](https://github.com/web-infra-dev/rspress/pull/2666) - feat(plugin-twoslash): add `cache` options by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2712](https://github.com/web-infra-dev/rspress/pull/2712) - feat(theme)!: add `config.i18nSource` and default i18n text and remove serveral i18nKeys in themeConfig by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2738](https://github.com/web-infra-dev/rspress/pull/2738) - feat(codeblock): lineNumbers and wrapCode meta props support `'''tsx lineNumbers wrapCode` by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2746](https://github.com/web-infra-dev/rspress/pull/2746) - feat(CLI): Add `rspress eject` CLI command for theme component customization by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2726](https://github.com/web-infra-dev/rspress/pull/2726) - feat(theme): add pageType: doc-wide by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2759](https://github.com/web-infra-dev/rspress/pull/2759) ##### Performance 🚀 - perf: simple matchRoutes alternative [#&#8203;1863](https://github.com/web-infra-dev/rspress/issues/1863) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2673](https://github.com/web-infra-dev/rspress/pull/2673) - perf(ssg): regression after output.asyncChunks = true by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2674](https://github.com/web-infra-dev/rspress/pull/2674) ##### Bug Fixes 🐞 - fix(theme): add --rp-banner-height to scroll-padding-top by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2678](https://github.com/web-infra-dev/rspress/pull/2678) - fix(theme/Tabs): keepDOM default value should be true by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2682](https://github.com/web-infra-dev/rspress/pull/2682) - fix(theme/code): fix the table code font-size and separate inline-code-block and code-block by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2688](https://github.com/web-infra-dev/rspress/pull/2688) - fix(theme): hydration error in NavHamburger and fix Search color by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2697](https://github.com/web-infra-dev/rspress/pull/2697) - fix(theme)!: add frontmatter UI control back and remove uiSwitch by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2698](https://github.com/web-infra-dev/rspress/pull/2698) - fix(theme): OverviewGroup and title margin by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2699](https://github.com/web-infra-dev/rspress/pull/2699) - fix(theme/Banner): cannot be closed due to hydration error by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2703](https://github.com/web-infra-dev/rspress/pull/2703) - fix(mdx): preserve error stack traces from MDX plugins and limit output to 10 lines by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2711](https://github.com/web-infra-dev/rspress/pull/2711) - fix(mdx): error stack is empty by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2716](https://github.com/web-infra-dev/rspress/pull/2716) - fix(theme): Outline font family was hardcoded by [@&#8203;elliotcourant](https://github.com/elliotcourant) in [#&#8203;2739](https://github.com/web-infra-dev/rspress/pull/2739) - fix(plugin-preview): [@&#8203;theme](https://github.com/theme) module not found regression by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2741](https://github.com/web-infra-dev/rspress/pull/2741) - fix(theme): use pointer cursor for menu by [@&#8203;fi3ework](https://github.com/fi3ework) in [#&#8203;2750](https://github.com/web-infra-dev/rspress/pull/2750) - fix: pathnameToRouteService to handle URLs with hash and search parameters by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2743](https://github.com/web-infra-dev/rspress/pull/2743) - fix: do not expose scrollToTarget as public API by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2761](https://github.com/web-infra-dev/rspress/pull/2761) - fix(theme): Edit link should show by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2763](https://github.com/web-infra-dev/rspress/pull/2763) ##### Document 📖 - docs: stabilize the codeblock css vars by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2689](https://github.com/web-infra-dev/rspress/pull/2689) - docs: update logo references to use SVG version by [@&#8203;chenjiahan](https://github.com/chenjiahan) in [#&#8203;2737](https://github.com/web-infra-dev/rspress/pull/2737) ##### Other Changes - chore(theme): migrate more .module.scss to BEM and remove tailwind CSS by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2653](https://github.com/web-infra-dev/rspress/pull/2653) - chore(deps): update dependency create-rstack to v1.7.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2668](https://github.com/web-infra-dev/rspress/pull/2668) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2667](https://github.com/web-infra-dev/rspress/pull/2667) - chore(deps): update playwright monorepo to v1.56.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2670](https://github.com/web-infra-dev/rspress/pull/2670) - chore(deps): update dependency memfs to ^4.49.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2669](https://github.com/web-infra-dev/rspress/pull/2669) - chore(deps): upgrade to react\@&#8203;19.2.0 (react,react-dom,[@&#8203;types/react](https://github.com/types/react),[@&#8203;types/react-dom](https://github.com/types/react-dom)) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2671](https://github.com/web-infra-dev/rspress/pull/2671) - chore(theme/Tabs): keepDOM in Tabs and stablize the Tabs classname by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2679](https://github.com/web-infra-dev/rspress/pull/2679) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2684](https://github.com/web-infra-dev/rspress/pull/2684) - chore(deps): update dependency [@&#8203;biomejs/biome](https://github.com/biomejs/biome) to ^2.3.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2685](https://github.com/web-infra-dev/rspress/pull/2685) - chore(deps): update dependency [@&#8203;rsbuild/plugin-vue](https://github.com/rsbuild/plugin-vue) to ^1.2.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2686](https://github.com/web-infra-dev/rspress/pull/2686) - chore(deps): update dependency [@&#8203;rslib/core](https://github.com/rslib/core) to v0.16.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2687](https://github.com/web-infra-dev/rspress/pull/2687) - chore!: move `@rspress/theme-default` to `@rspress/core/theme` by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2690](https://github.com/web-infra-dev/rspress/pull/2690) - chore(theme/HomeLayout): polish styles by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2693](https://github.com/web-infra-dev/rspress/pull/2693) - chore(theme/Search): add backdrop-filter by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2696](https://github.com/web-infra-dev/rspress/pull/2696) - chore(deps): update flexsearch to v0.8.212 by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2691](https://github.com/web-infra-dev/rspress/pull/2691) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2706](https://github.com/web-infra-dev/rspress/pull/2706) - chore(deps): update dependency [@&#8203;rsbuild/core](https://github.com/rsbuild/core) to \~1.6.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2707](https://github.com/web-infra-dev/rspress/pull/2707) - chore(remarkContainerSyntax): throw an error when the type is unknown by [@&#8203;Copilot](https://github.com/Copilot) in [#&#8203;2708](https://github.com/web-infra-dev/rspress/pull/2708) - chore: preEntry to ensures css order and splitChunks for perf by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2714](https://github.com/web-infra-dev/rspress/pull/2714) - ci: add ecosystem CI by [@&#8203;fi3ework](https://github.com/fi3ework) in [#&#8203;2710](https://github.com/web-infra-dev/rspress/pull/2710) - refactor(theme/Tabs)!: reimplement Tabs and PageTabs to bypass hydration error due to localStorage by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2719](https://github.com/web-infra-dev/rspress/pull/2719) - chore(theme/sidebar): use 1fr to toggleCollapse the sidebarGroup by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2723](https://github.com/web-infra-dev/rspress/pull/2723) - chore(theme/Toc): upgrade Toc border line in mobile by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2724](https://github.com/web-infra-dev/rspress/pull/2724) - chore(infra): add Rsdoctor bundle diff CI by [@&#8203;yifancong](https://github.com/yifancong) in [#&#8203;2722](https://github.com/web-infra-dev/rspress/pull/2722) - chore(theme/homehero): upgrade home feature style and expose CSS vars by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2728](https://github.com/web-infra-dev/rspress/pull/2728) - chore: fix diff yaml by [@&#8203;yifancong](https://github.com/yifancong) in [#&#8203;2732](https://github.com/web-infra-dev/rspress/pull/2732) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2733](https://github.com/web-infra-dev/rspress/pull/2733) - chore(deps): update dependency [@&#8203;docsearch/css](https://github.com/docsearch/css) to ^4.3.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2734](https://github.com/web-infra-dev/rspress/pull/2734) - chore(deps): update dependency [@&#8203;microsoft/api-extractor](https://github.com/microsoft/api-extractor) to ^7.54.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2736](https://github.com/web-infra-dev/rspress/pull/2736) - chore(deps): update dependency [@&#8203;docsearch/react](https://github.com/docsearch/react) to ^4.3.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2735](https://github.com/web-infra-dev/rspress/pull/2735) - chore(theme): expose base css variables by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2731](https://github.com/web-infra-dev/rspress/pull/2731) - chore(plugin-api-docgen): add default translation text for table comp associated with i18n refactor by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2744](https://github.com/web-infra-dev/rspress/pull/2744) - test: remove unused files by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2745](https://github.com/web-infra-dev/rspress/pull/2745) - chore(theme/Tabs): polish Tabs style to ::after instead of border-bottom by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2748](https://github.com/web-infra-dev/rspress/pull/2748) - security: enable pnpm's no-downgrade trustPolicy by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2751](https://github.com/web-infra-dev/rspress/pull/2751) - chore(infra): run pnpm dedupe by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2752](https://github.com/web-infra-dev/rspress/pull/2752) - chore(theme): simplify scss structure by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2753](https://github.com/web-infra-dev/rspress/pull/2753) - chore(ssg): add filepath error message by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2754](https://github.com/web-infra-dev/rspress/pull/2754) - chore(theme): polish theme colors by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2755](https://github.com/web-infra-dev/rspress/pull/2755) - chore: update pnpm trust policy exclusions by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2758](https://github.com/web-infra-dev/rspress/pull/2758) - chore(mdx): revert containerSynatx unknown types error by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2764](https://github.com/web-infra-dev/rspress/pull/2764) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2766](https://github.com/web-infra-dev/rspress/pull/2766) - chore(deps): update dependency [@&#8203;microsoft/api-extractor](https://github.com/microsoft/api-extractor) to ^7.55.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2767](https://github.com/web-infra-dev/rspress/pull/2767) - chore(deps): update dependency cspell to ^9.3.2 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2768](https://github.com/web-infra-dev/rspress/pull/2768) - chore(deps): update dependency memfs to ^4.51.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2769](https://github.com/web-infra-dev/rspress/pull/2769) - chore(deps): update dependency [@&#8203;rslib/core](https://github.com/rslib/core) to v0.17.2 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2760](https://github.com/web-infra-dev/rspress/pull/2760) #### New Contributors - [@&#8203;elliotcourant](https://github.com/elliotcourant) made their first contribution in [#&#8203;2739](https://github.com/web-infra-dev/rspress/pull/2739) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.35...v2.0.0-rc.0> ### [`v2.0.0-beta.35`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.35) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.34...v2.0.0-beta.35) <!-- Release notes generated using configuration in .github/release.yml at release_v2.0.0-beta.35 --> #### What's Changed ##### New Features 🎉 - feat(theme): add prop `dlx` to `PackageManagerTabs` for `npx` `pnpm dlx` etc by [@&#8203;Nsttt](https://github.com/Nsttt) in [#&#8203;2623](https://github.com/web-infra-dev/rspress/pull/2623) - feat(auto-nav-sidebar): add new type: "dir-section-header" by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2643](https://github.com/web-infra-dev/rspress/pull/2643) - chore: cherry-pick ssg-md to beta.34 in [#&#8203;2680](https://github.com/web-infra-dev/rspress/pull/2680) ##### Bug Fixes 🐞 - fix(auto-nav-sidebar): should extract tag and fix the chunks word break by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2652](https://github.com/web-infra-dev/rspress/pull/2652) ##### Document 📖 - docs: fixed navbar example typo by [@&#8203;ulivz](https://github.com/ulivz) in [#&#8203;2645](https://github.com/web-infra-dev/rspress/pull/2645) ##### Other Changes - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2629](https://github.com/web-infra-dev/rspress/pull/2629) - chore(deps): update dependency memfs to ^4.47.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2631](https://github.com/web-infra-dev/rspress/pull/2631) - chore(deps): update pnpm to v10.17.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2632](https://github.com/web-infra-dev/rspress/pull/2632) - chore(deps): update dependency [@&#8203;rslib/core](https://github.com/rslib/core) to v0.15.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2630](https://github.com/web-infra-dev/rspress/pull/2630) - chore(deps): update dependency [@&#8203;microsoft/api-extractor](https://github.com/microsoft/api-extractor) to ^7.53.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2637](https://github.com/web-infra-dev/rspress/pull/2637) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2636](https://github.com/web-infra-dev/rspress/pull/2636) - chore(deps): update dependency cross-env to ^10.1.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2638](https://github.com/web-infra-dev/rspress/pull/2638) - chore(deps): update dependency memfs to ^4.48.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2639](https://github.com/web-infra-dev/rspress/pull/2639) - chore(deps): update pnpm to v10.18.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2641](https://github.com/web-infra-dev/rspress/pull/2641) - chore(deps): update dependency nx to v21.6.3 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2640](https://github.com/web-infra-dev/rspress/pull/2640) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2648](https://github.com/web-infra-dev/rspress/pull/2648) - chore(deps): update dependency [@&#8203;docsearch/css](https://github.com/docsearch/css) to ^4.2.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2649](https://github.com/web-infra-dev/rspress/pull/2649) - chore(deps): update dependency tm-themes to v1.10.11 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2650](https://github.com/web-infra-dev/rspress/pull/2650) - chore(deps): update dependency [@&#8203;docsearch/react](https://github.com/docsearch/react) to ^4.2.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2651](https://github.com/web-infra-dev/rspress/pull/2651) #### New Contributors - [@&#8203;ulivz](https://github.com/ulivz) made their first contribution in [#&#8203;2645](https://github.com/web-infra-dev/rspress/pull/2645) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.34...v2.0.0-beta.35> ### [`v2.0.0-beta.34`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.34) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.33...v2.0.0-beta.34) <!-- Release notes generated using configuration in .github/release.yml at main --> #### Highlights ✨ ##### 💄 Upgrade to `docsearch@4` within [@&#8203;rspress/plugin-algolia](https://github.com/rspress/plugin-algolia) > related PR: [#&#8203;2620](https://github.com/web-infra-dev/rspress/pull/2620) This will improve Rspress's UI, and you can use new docsearch features such as askAi. > DocSearch v4 provides a significant upgrade over previous versions, offering enhanced accessibility, responsiveness, and an improved search experience for your documentation. Built on [Algolia Autocomplete](https://www.algolia.com/doc/ui-libraries/autocomplete/introduction/what-is-autocomplete/), DocSearch v4 ensures a seamless integration trusted by leading documentation sites worldwide. ref: <https://docsearch.algolia.com/docs/migrating-from-v3> <img width="1547" height="637" alt="image" src="https://github.com/user-attachments/assets/c8343bbf-5363-4825-a964-c76b66dc9788" /> <img width="1499" height="563" alt="image" src="https://github.com/user-attachments/assets/839ce4c1-7657-4277-a1f6-5ae78879e9c9" /> #### What's Changed ##### New Features 🎉 * feat!: update @&#8203;rspress/plugin-algolia to docsearch v4.1.0 by @&#8203;Copilot in https://github.com/web-infra-dev/rspress/pull/2620 * feat: support basic usage of remark-lint for link plugin by @&#8203;JounQin in https://github.com/web-infra-dev/rspress/pull/2618 ##### Bug Fixes 🐞 * fix(plugin-llms): should be compilatable to user manual nav and sidebar configuration by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2606 * fix: render HTML entities correctly in dynamic TOC by @&#8203;JounQin in https://github.com/web-infra-dev/rspress/pull/2613 * fix(theme): llms component should not be included in rp-doc by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2614 * fix(auto-nav-sidebar): watch h1 change for sidebar by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2619 ##### Document 📖 * docs: fix the ui dark mode color by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2621 * docs: adjust the folder layout by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2622 ##### Other Changes * chore(deps): update dependency rsbuild-plugin-virtual-module to v0.4.1 by @&#8203;renovate[bot] in https://github.com/web-infra-dev/rspress/pull/2596 * chore(infra): Creation of AGENTS.md for Rspress Project by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2612 * chore(deps): update all patch dependencies by @&#8203;renovate[bot] in https://github.com/web-infra-dev/rspress/pull/2616 * chore(deps): update dependency memfs to ^4.43.0 by @&#8203;renovate[bot] in https://github.com/web-infra-dev/rspress/pull/2617 * chore(deps): update dependency create-rstack to v1.6.1 by @&#8203;renovate[bot] in https://github.com/web-infra-dev/rspress/pull/2576 * chore(deps): upgrade @&#8203;rsbuild/core@1.5.12 by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2624 * refactor: replace enhanced-resolve with rspack resolver by @&#8203;stormslowly in https://github.com/web-infra-dev/rspress/pull/2578 * Release v2.0.0-beta.34 by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2626 #### New Contributors * @&#8203;stormslowly made their first contribution in https://github.com/web-infra-dev/rspress/pull/2578 **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.33...v2.0.0-beta.34> ### [`v2.0.0-beta.33`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.33) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.32...v2.0.0-beta.33) <!-- Release notes generated using configuration in .github/release.yml at main --> #### Breaking Changes🚨 ##### Make raw HTML in md styled > related PR: [#&#8203;2600](https://github.com/web-infra-dev/rspress/pull/2600) Rspress is now driven by CSS for style, ref: <https://github.com/web-infra-dev/rspress/blob/main/packages/theme-default/src/styles/doc.scss> So you can: - Use original html tag like `<ul><li>this is a line</li></ul>`, they will now be styled the same as `* this is a line` - do not need to use Rspress's built-in `const { h1: H1 } = getCustomMdxComponents()` to annotate styles - For components that do not wish to be polluted by Rspress prose CSS, `.rp-not-doc` is all you needed ```md ## List - list item 1 <------ styled - list item 2 <ul> <li>list item 1</li> <------ styled <li>list item 2</li> </ul> <div className="rp-not-doc"> <----- not styled <ul> <li>list item 1</li> <li>list item 2</li> </ul> </div> <ul className="rp-not-doc> <----- not styled <li>list item 1</li> <li>list item 2</li> </ul> ``` - Even if Rspress supports it, it's still better not to use raw HTML: <https://github.com/DavidAnson/markdownlint/blob/v0.38.0/doc/md033.md> #### What's Changed ##### New Features 🎉 - feat(theme-default): Make the tab component usable in layouts other than DocLayout by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2589](https://github.com/web-infra-dev/rspress/pull/2589) - feat(theme/style)!: keep the html style be consistent with markdown syntax and `.rp-not-doc` escape hatch ([#&#8203;2579](https://github.com/web-infra-dev/rspress/issues/2579)) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2600](https://github.com/web-infra-dev/rspress/pull/2600) ##### Bug Fixes 🐞 - fix(theme/style): some components should not be included in rp-doc by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2602](https://github.com/web-infra-dev/rspress/pull/2602) ##### Document 📖 - docs(ui): upgrade Rspress UI part by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2591](https://github.com/web-infra-dev/rspress/pull/2591) - docs(ui): upgrade shiki vars by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2598](https://github.com/web-infra-dev/rspress/pull/2598) ##### Other Changes - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2575](https://github.com/web-infra-dev/rspress/pull/2575) - chore(deps): upgrade nx to upgrade axios and form-data by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2592](https://github.com/web-infra-dev/rspress/pull/2592) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2593](https://github.com/web-infra-dev/rspress/pull/2593) - chore(deps): update dependency memfs to ^4.39.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2595](https://github.com/web-infra-dev/rspress/pull/2595) - chore(deps): update dependency [@&#8203;rslib/core](https://github.com/rslib/core) to v0.13.2 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2594](https://github.com/web-infra-dev/rspress/pull/2594) - chore(deps): update dependency [@&#8203;mdx-js/react](https://github.com/mdx-js/react) to v3 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2558](https://github.com/web-infra-dev/rspress/pull/2558) - test(e2e): inline-markdown add "link" example by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2601](https://github.com/web-infra-dev/rspress/pull/2601) - refactor(theme-default)!: remove unused low-frequency components LinkCard and Card by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2603](https://github.com/web-infra-dev/rspress/pull/2603) - chore(theme/style): nav group and add word-break: keep-all to navItem ([#&#8203;2568](https://github.com/web-infra-dev/rspress/issues/2568)) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2604](https://github.com/web-infra-dev/rspress/pull/2604) - Release v2.0.0-beta.33 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2605](https://github.com/web-infra-dev/rspress/pull/2605) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.32...v2.0.0-beta.33> ### [`v2.0.0-beta.32`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.32) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.31...v2.0.0-beta.32) <!-- Release notes generated using configuration in .github/release.yml at main --> #### Highlights ✨ ##### ⚡️ Support \_meta.json and \_nav.json HMR > related PR: [#&#8203;2549](https://github.com/web-infra-dev/rspress/pull/2549) After a period of refactoring around virtual modules, Rspress now supports HMR for both \*meta.json and \*nav.json files. This means you no longer need to restart the dev server when modifying \_meta.json files, which will significantly improve your debugging speed for nav and sidebar configurations. ![img\_v3\_02pq\_a42d8229-315d-49b0-a72a-b739a586cb6g](https://github.com/user-attachments/assets/162906cc-9b1d-4c47-b1d8-040a0e40a33b) #### What's Changed ##### New Features 🎉 - feat(auto-nav-sidebar): support \_meta.json and \_nav.json hmr by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2549](https://github.com/web-infra-dev/rspress/pull/2549) - feat(twoslash): improve underline styling and adjust popup docs font-size by [@&#8203;chenjiahan](https://github.com/chenjiahan) in [#&#8203;2554](https://github.com/web-infra-dev/rspress/pull/2554) - feat: export star from react-router-dom by [@&#8203;zoolsher](https://github.com/zoolsher) in [#&#8203;2577](https://github.com/web-infra-dev/rspress/pull/2577) - feat(plugin-twoslash): Make the popup that is always displayed not flip its display position by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2580](https://github.com/web-infra-dev/rspress/pull/2580) ##### Bug Fixes 🐞 - fix(plugin-api-docgen): too much apiDocMap clone in pageData cause performance issue in runtime by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2524](https://github.com/web-infra-dev/rspress/pull/2524) - fix(plugin-playground): normalizeUrl skip protocol([#&#8203;2563](https://github.com/web-infra-dev/rspress/issues/2563)) ([#&#8203;2565](https://github.com/web-infra-dev/rspress/issues/2565)) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2584](https://github.com/web-infra-dev/rspress/pull/2584) - fix: suggestions object key with constructor by [@&#8203;zoolsher](https://github.com/zoolsher) in [#&#8203;2586](https://github.com/web-infra-dev/rspress/pull/2586) ##### Document 📖 - docs(codeblocks): add diff block by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2551](https://github.com/web-infra-dev/rspress/pull/2551) - docs: add Zephyr to docs by [@&#8203;Nsttt](https://github.com/Nsttt) in [#&#8203;2555](https://github.com/web-infra-dev/rspress/pull/2555) - docs: add zh docs of deploy with Zephyr Cloud by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2572](https://github.com/web-infra-dev/rspress/pull/2572) ##### Other Changes - chore(deps): update actions/setup-node action to v5 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2557](https://github.com/web-infra-dev/rspress/pull/2557) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2556](https://github.com/web-infra-dev/rspress/pull/2556) - chore(deps): update dependency [@&#8203;types/jest](https://github.com/types/jest) to v30 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2559](https://github.com/web-infra-dev/rspress/pull/2559) - chore(deps): update dependency cspell to v9 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2561](https://github.com/web-infra-dev/rspress/pull/2561) - chore(deps): remove unused [@&#8203;types/jest](https://github.com/types/jest) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2562](https://github.com/web-infra-dev/rspress/pull/2562) - chore(infra): upgrade pnpm configuration to remove hoist by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2564](https://github.com/web-infra-dev/rspress/pull/2564) - chore(deps): update dependency cross-env to v10 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2560](https://github.com/web-infra-dev/rspress/pull/2560) - test(e2e): fix ci case sensitivity by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2566](https://github.com/web-infra-dev/rspress/pull/2566) - chore(persistent-cache): add rspress version to cacheDigest to make it more safe by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2582](https://github.com/web-infra-dev/rspress/pull/2582) - chore(infra): use strictPeerDependencies: false by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2587](https://github.com/web-infra-dev/rspress/pull/2587) - Release v2.0.0-beta.32 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2588](https://github.com/web-infra-dev/rspress/pull/2588) #### New Contributors - [@&#8203;Nsttt](https://github.com/Nsttt) made their first contribution in [#&#8203;2555](https://github.com/web-infra-dev/rspress/pull/2555) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.31...v2.0.0-beta.32> ### [`v2.0.0-beta.31`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.31) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.30...v2.0.0-beta.31) <!-- Release notes generated using configuration in .github/release.yml at main --> #### What's Changed ##### New Features 🎉 - feat(plugin-twoslash): Improve error handling with enhanced logging by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2544](https://github.com/web-infra-dev/rspress/pull/2544) ##### Bug Fixes 🐞 - fix(theme-default/style): add `color: inherit` back by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2546](https://github.com/web-infra-dev/rspress/pull/2546) - fix: hmr not work by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2545](https://github.com/web-infra-dev/rspress/pull/2545) ##### Document 📖 - docs: polish twoslash usage doc by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2542](https://github.com/web-infra-dev/rspress/pull/2542) - docs(plugin-twoslash): fix typo by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2543](https://github.com/web-infra-dev/rspress/pull/2543) ##### Other Changes - Release v2.0.0-beta.31 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2548](https://github.com/web-infra-dev/rspress/pull/2548) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.30...v2.0.0-beta.31> ### [`v2.0.0-beta.30`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.30) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.29...v2.0.0-beta.30) <!-- Release notes generated using configuration in .github/release.yml at main --> #### Highlights ✨ ##### 🆕️ [@&#8203;rspress/plugin-twoslash](https://github.com/rspress/plugin-twoslash) > related PR: [#&#8203;2527](https://github.com/web-infra-dev/rspress/pull/2527) Thanks to Shiki's excellent [Twoslash](https://twoslash.netlify.app/guide/) integration, we're excited to introduce `@rspress/plugin-twoslash` in this milestone 2.0.0-beta.30 release! Now you can easily add rich type annotations to your code blocks using "\`\`\`ts twoslash" Special thanks to Rspress contributor [@&#8203;Karibash](https://github.com/Karibash) for making this possible. Check out the [@&#8203;rspress/plugin-twoslash documentation](https://v2.rspress.rs/plugin/official-plugins/twoslash) to get started! ref: <https://v2.rspress.rs/plugin/official-plugins/twoslash> <img width="1358" height="835" alt="Frame 1912054720" src="https://github.com/user-attachments/assets/30bcdcb8-4722-4820-bc17-d34be4e327f3" /> ##### ⚡️Enable Rspack native watcher by default and bump Rspack@1.5.2 > related PR: [#&#8203;2472](https://github.com/web-infra-dev/rspress/pull/2472) > Previously, Rspack relied on the [watchpack](https://github.com/webpack/watchpack) file system watcher to track file changes. However, we identified performance bottlenecks with watchpack. For example, each file change triggers the creation of a new instance, consuming significant CPU and memory in large projects (see [#&#8203;7490](https://github.com/web-infra-dev/rspack/issues/7490)). Now Rspress has been upgraded to Rspack 1.5.2 and enable native watcher by default, it will have better HMR perf and lazy compilation perf. ref: <https://rspack.rs/blog/announcing-1-5#faster-file-system-watcher> #### What's Changed ##### New Features 🎉 - feat: Add a twoslash plugin by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2527](https://github.com/web-infra-dev/rspress/pull/2527) - feat: enable rspack native watcher by default by [@&#8203;GiveMe-A-Name](https://github.com/GiveMe-A-Name) in [#&#8203;2472](https://github.com/web-infra-dev/rspress/pull/2472) ##### Bug Fixes 🐞 - fix(core): allow user can deploy to both `http://a.com/base/` and `http://a.com/base` by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2536](https://github.com/web-infra-dev/rspress/pull/2536) - fix(native-watcher): Infinite watch removed i18n.json by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2540](https://github.com/web-infra-dev/rspress/pull/2540) - fix(plugin-twoslash): Prevent the contents of the popup from being copied when copying code by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2538](https://github.com/web-infra-dev/rspress/pull/2538) ##### Other Changes - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2530](https://github.com/web-infra-dev/rspress/pull/2530) - chore(deps): update rsbuild by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2531](https://github.com/web-infra-dev/rspress/pull/2531) - chore(deps): update actions/checkout action to v5 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2535](https://github.com/web-infra-dev/rspress/pull/2535) - chore(deps): update shiki monorepo to ^3.12.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2534](https://github.com/web-infra-dev/rspress/pull/2534) - chore(plugin-llms): add animation to LlmsViewOptions by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2532](https://github.com/web-infra-dev/rspress/pull/2532) - chore(deps): upgrade [@&#8203;rsbuild/core](https://github.com/rsbuild/core) to 1.5.3 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2539](https://github.com/web-infra-dev/rspress/pull/2539) - chore(plugin-twoslash): add hover style back by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2541](https://github.com/web-infra-dev/rspress/pull/2541) - Release v2.0.0-beta.30 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2537](https://github.com/web-infra-dev/rspress/pull/2537) #### New Contributors - [@&#8203;GiveMe-A-Name](https://github.com/GiveMe-A-Name) made their first contribution in [#&#8203;2472](https://github.com/web-infra-dev/rspress/pull/2472) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.29...v2.0.0-beta.30> ### [`v2.0.0-beta.29`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.29) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.28...v2.0.0-beta.29) <!-- Release notes generated using configuration in .github/release.yml at main --> #### What's Changed ##### New Features 🎉 - feat(link): support asset link by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2498](https://github.com/web-infra-dev/rspress/pull/2498) - style(theme): update primary text color for better contrast by [@&#8203;chenjiahan](https://github.com/chenjiahan) in [#&#8203;2499](https://github.com/web-infra-dev/rspress/pull/2499) - feat(create-rspress): update tsconfig.json by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2509](https://github.com/web-infra-dev/rspress/pull/2509) - feat(theme): Make it possible to mark elements to be excluded when copying by [@&#8203;Karibash](https://github.com/Karibash) in [#&#8203;2512](https://github.com/web-infra-dev/rspress/pull/2512) - feat(plugin-llms): support `mdFiles.remarkPlugins` by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2516](https://github.com/web-infra-dev/rspress/pull/2516) ##### Bug Fixes 🐞 - fix(virtual-module): should addDependencies in virtual-module for persistent cache by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2519](https://github.com/web-infra-dev/rspress/pull/2519) - fix: command using object fully customize don't call normalize by [@&#8203;zoolsher](https://github.com/zoolsher) in [#&#8203;2528](https://github.com/web-infra-dev/rspress/pull/2528) ##### Document 📖 - docs: add asset links and format with biome by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2507](https://github.com/web-infra-dev/rspress/pull/2507) - docs: add codeblock by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2500](https://github.com/web-infra-dev/rspress/pull/2500) - docs(codeblocks): polish some write style by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2508](https://github.com/web-infra-dev/rspress/pull/2508) - docs: polish codeblocks doc V2 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2517](https://github.com/web-infra-dev/rspress/pull/2517) ##### Other Changes - refactor: add usePage hook by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2494](https://github.com/web-infra-dev/rspress/pull/2494) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2501](https://github.com/web-infra-dev/rspress/pull/2501) - chore(deps): update dependency [@&#8203;rstack-dev/doc-ui](https://github.com/rstack-dev/doc-ui) to ^1.11.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2502](https://github.com/web-infra-dev/rspress/pull/2502) - chore(deps): update dependency memfs to ^4.38.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2503](https://github.com/web-infra-dev/rspress/pull/2503) - chore(deps): update playwright monorepo to v1.55.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2504](https://github.com/web-infra-dev/rspress/pull/2504) - chore(deps): update pnpm to v10.15.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2505](https://github.com/web-infra-dev/rspress/pull/2505) - chore(deps): update shiki monorepo to ^3.11.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2506](https://github.com/web-infra-dev/rspress/pull/2506) - chore(deps): bump Rsbuild 1.5.0 by [@&#8203;Timeless0911](https://github.com/Timeless0911) in [#&#8203;2511](https://github.com/web-infra-dev/rspress/pull/2511) - chore(plugin-preview)!: remove [@&#8203;rsbuild/plugin-less](https://github.com/rsbuild/plugin-less) and [@&#8203;rsbuild/plugin-sass](https://github.com/rsbuild/plugin-sass) by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2513](https://github.com/web-infra-dev/rspress/pull/2513) - chore(deps): revert [@&#8203;rsbuild/core](https://github.com/rsbuild/core)@&#8203;1.5.0 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2515](https://github.com/web-infra-dev/rspress/pull/2515) - Release v2.0.0-beta.29 by [@&#8203;chenjiahan](https://github.com/chenjiahan) in [#&#8203;2529](https://github.com/web-infra-dev/rspress/pull/2529) #### New Contributors - [@&#8203;Karibash](https://github.com/Karibash) made their first contribution in [#&#8203;2512](https://github.com/web-infra-dev/rspress/pull/2512) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.28...v2.0.0-beta.29> ### [`v2.0.0-beta.28`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.28) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.27...v2.0.0-beta.28) <!-- Release notes generated using configuration in .github/release.yml at main --> #### What's Changed ##### New Features 🎉 - feat: generate Open Graph title and type tags by default by [@&#8203;chenjiahan](https://github.com/chenjiahan) in [#&#8203;2490](https://github.com/web-infra-dev/rspress/pull/2490) ##### Bug Fixes 🐞 - fix(deps): remove unused dependencies from multiple packages by [@&#8203;chenjiahan](https://github.com/chenjiahan) in [#&#8203;2493](https://github.com/web-infra-dev/rspress/pull/2493) - fix(theme): move rspress-logo and some other styles out of rp-base layer by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2488](https://github.com/web-infra-dev/rspress/pull/2488) ##### Document 📖 - docs: upgrade readme and add npm link to docsite by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2491](https://github.com/web-infra-dev/rspress/pull/2491) ##### Other Changes - refactor: remove unused normalizeHrefInRuntime by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2482](https://github.com/web-infra-dev/rspress/pull/2482) - refactor: normalizeThemeConfig code style by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2481](https://github.com/web-infra-dev/rspress/pull/2481) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2483](https://github.com/web-infra-dev/rspress/pull/2483) - chore(deps): update actions/checkout action to v4.3.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2484](https://github.com/web-infra-dev/rspress/pull/2484) - chore(deps): update dependency [@&#8203;rslib/core](https://github.com/rslib/core) to v0.12.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2486](https://github.com/web-infra-dev/rspress/pull/2486) - chore(deps): update dependency [@&#8203;biomejs/biome](https://github.com/biomejs/biome) to ^2.2.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2485](https://github.com/web-infra-dev/rspress/pull/2485) - refactor(virtual-module): move searchIndex to rsbuild-plugin-virtual-module by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2487](https://github.com/web-infra-dev/rspress/pull/2487) - refactor(virtual-module): update lark icon and virtual-social-links by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2492](https://github.com/web-infra-dev/rspress/pull/2492) - chore(search): polish search jump logic and add searchHooks e2e by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2496](https://github.com/web-infra-dev/rspress/pull/2496) - Release v2.0.0-beta.28 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2497](https://github.com/web-infra-dev/rspress/pull/2497) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.27...v2.0.0-beta.28> ### [`v2.0.0-beta.27`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.27) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.26...v2.0.0-beta.27) <!-- Release notes generated using configuration in .github/release.yml at main --> #### Highlights ✨ ##### Add layer for base.css to support tailwind v4 > related PR: [#&#8203;2477](https://github.com/web-infra-dev/rspress/pull/2477) #### What's Changed ##### New Features 🎉 - feat(theme)!: add layer for base.css to support tailwind v4 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2477](https://github.com/web-infra-dev/rspress/pull/2477) ##### Bug Fixes 🐞 - fix: export `usePage` to replace deprecated `usePageData` by [@&#8203;JounQin](https://github.com/JounQin) in [#&#8203;2471](https://github.com/web-infra-dev/rspress/pull/2471) - fix: revert asset link support and fix the corner case when filename contains dot by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2473](https://github.com/web-infra-dev/rspress/pull/2473) ##### Document 📖 - docs(mdx): add markdown container part by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2467](https://github.com/web-infra-dev/rspress/pull/2467) ##### Other Changes - chore(core): add runtime alias by default for multi-instance problem in monorepo by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2463](https://github.com/web-infra-dev/rspress/pull/2463) - chore: remove unused constant by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2465](https://github.com/web-infra-dev/rspress/pull/2465) - refactor(theme): usePageData => usePage by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2466](https://github.com/web-infra-dev/rspress/pull/2466) - chore(theme): rename useSiteData to useSite by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2474](https://github.com/web-infra-dev/rspress/pull/2474) - chore(infra/script): update css typed modules by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2476](https://github.com/web-infra-dev/rspress/pull/2476) - chore: move website to the workspace root by [@&#8203;chenjiahan](https://github.com/chenjiahan) in [#&#8203;2478](https://github.com/web-infra-dev/rspress/pull/2478) - Release v2.0.0-beta.27 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2480](https://github.com/web-infra-dev/rspress/pull/2480) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.26...v2.0.0-beta.27> ### [`v2.0.0-beta.26`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.26) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.25...v2.0.0-beta.26) <!-- Release notes generated using configuration in .github/release.yml at main --> #### What's Changed ##### Bug Fixes 🐞 - fix(auto-nav-sidebar): correct both \_meta.json and \_nav.json exist behavior by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2453](https://github.com/web-infra-dev/rspress/pull/2453) - fix(plugin-llms): support dark mode by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2455](https://github.com/web-infra-dev/rspress/pull/2455) - fix(theme/Link): Link and HomeHero should support relative url by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2456](https://github.com/web-infra-dev/rspress/pull/2456) ##### Document 📖 - docs: add Rslint and version badges to Rstack tools table by [@&#8203;chenjiahan](https://github.com/chenjiahan) in [#&#8203;2451](https://github.com/web-infra-dev/rspress/pull/2451) ##### Other Changes - refactor(runtime): split hooks into several files by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2454](https://github.com/web-infra-dev/rspress/pull/2454) - chore(deps): update all patch dependencies by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2457](https://github.com/web-infra-dev/rspress/pull/2457) - chore(deps): update dependency zx to ^8.8.0 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2458](https://github.com/web-infra-dev/rspress/pull/2458) - chore(deps): update rsbuild by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2459](https://github.com/web-infra-dev/rspress/pull/2459) - chore(deps): update dependency react-router-dom to ^6.30.1 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2338](https://github.com/web-infra-dev/rspress/pull/2338) - chore(deps): update shiki monorepo to ^3.9.2 by [@&#8203;renovate](https://github.com/renovate)\[bot] in [#&#8203;2460](https://github.com/web-infra-dev/rspress/pull/2460) - Release v2.0.0-beta.26 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2461](https://github.com/web-infra-dev/rspress/pull/2461) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.25...v2.0.0-beta.26> ### [`v2.0.0-beta.25`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.25) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.24...v2.0.0-beta.25) <!-- Release notes generated using configuration in .github/release.yml at main --> #### Highlights ✨ ##### Enable trusted publishing for npm packages OIDC ♻️ > related PR: [#&#8203;2444](https://github.com/web-infra-dev/rspress/pull/2444) ref: <https://docs.npmjs.com/trusted-publishers> <img width="660" height="117" alt="image" src="https://github.com/user-attachments/assets/16b388a7-28bf-4076-b863-3003c2972cbb" /> ##### UI Display of plugin-llms update 🆕️ > related PR: [#&#8203;2439](https://github.com/web-infra-dev/rspress/pull/2439) <img width="1510" height="428" alt="image" src="https://github.com/user-attachments/assets/46018528-ddd9-462a-8c4a-c8f7a8e612ce" /> #### What's Changed ##### New Features 🎉 * feat(plugin-llms/runtime): add markdownLink for copy by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2439 * feat: add npm icon to social links by @&#8203;saseungmin in https://github.com/web-infra-dev/rspress/pull/2441 * feat(plugin-llms)!: default value for i18n by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2448 ##### Bug Fixes 🐞 * fix(tab-list): Fix tabs scrolling when not overflowing by @&#8203;howlettt in https://github.com/web-infra-dev/rspress/pull/2433 * fix(link): should support public folder asset by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2440 * fix(plugin-llms): some md files sometimes do not emit by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2443 ##### Document 📖 * docs(typo): update plugin-llms by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2432 * docs(v2): update code block line highlighting syntax to v2 by @&#8203;saseungmin in https://github.com/web-infra-dev/rspress/pull/2431 * docs: add npm icon to social links in theme config documentation by @&#8203;saseungmin in https://github.com/web-infra-dev/rspress/pull/2442 ##### Other Changes * chore(deps): update all patch dependencies by @&#8203;renovate[bot] in https://github.com/web-infra-dev/rspress/pull/2435 * chore(deps): update dependency @&#8203;types/babel__traverse to ^7.28.0 by @&#8203;renovate[bot] in https://github.com/web-infra-dev/rspress/pull/2436 * chore(deps): update dependency memfs to ^4.36.0 by @&#8203;renovate[bot] in https://github.com/web-infra-dev/rspress/pull/2437 * chore(deps): update pnpm to v10.14.0 by @&#8203;renovate[bot] in https://github.com/web-infra-dev/rspress/pull/2438 * chore: enable trusted publishing for npm packages by @&#8203;Timeless0911 in https://github.com/web-infra-dev/rspress/pull/2444 * Release v2.0.0-beta.25 by @&#8203;SoonIter in https://github.com/web-infra-dev/rspress/pull/2449 #### New Contributors * @&#8203;howlettt made their first contribution in https://github.com/web-infra-dev/rspress/pull/2433 * @&#8203;saseungmin made their first contribution in https://github.com/web-infra-dev/rspress/pull/2431 **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.24...v2.0.0-beta.25> ### [`v2.0.0-beta.24`](https://github.com/web-infra-dev/rspress/releases/tag/v2.0.0-beta.24) [Compare Source](https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.23...v2.0.0-beta.24) <!-- Release notes generated using configuration in .github/release.yml at main --> #### Highlights ✨ ##### UI LlmsCopyButton of llms.txt 🤖 > related PR: [#&#8203;2426](https://github.com/web-infra-dev/rspress/pull/2426) We hope that llms.txt will have a greater role in AI era. Thanks to fumadocs, it is inspired from fumadocs's docsite <img width="700" height="583" alt="image" src="https://github.com/user-attachments/assets/892c5766-64b9-4b07-b860-d52962b3c19f" /> ref: <https://v2.rspress.rs/plugin/official-plugins/llms#2-ui-display> #### What's Changed ##### New Features 🎉 - feat(plugin-llms): add LlmsCopyButton by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2426](https://github.com/web-infra-dev/rspress/pull/2426) ##### Bug Fixes 🐞 - fix(plugin-llms)!: default value change mdxToMd: false by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2428](https://github.com/web-infra-dev/rspress/pull/2428) ##### Document 📖 - docs: polish the use-mdx/components by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2425](https://github.com/web-infra-dev/rspress/pull/2425) ##### Other Changes - chore(deps): update rsbuild 1.4.12 and more accurate persistent cache by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2429](https://github.com/web-infra-dev/rspress/pull/2429) - Release v2.0.0-beta.24 by [@&#8203;SoonIter](https://github.com/SoonIter) in [#&#8203;2430](https://github.com/web-infra-dev/rspress/pull/2430) **Full Changelog**: <https://github.com/web-infra-dev/rspress/compare/v2.0.0-beta.23...v2.0.0-beta.24> </details> --- ### Configuration 📅 **Schedule**: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined). 🚦 **Automerge**: Disabled by config. Please merge this manually once you are satisfied. ♻ **Rebasing**: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox. 🔕 **Ignore**: Close this PR and you won't be reminded about this update again. --- - [ ] <!-- rebase-check -->If you want to rebase/retry this PR, check this box --- This PR has been generated by [Renovate Bot](https://github.com/renovatebot/renovate). <!--renovate-debug:eyJjcmVhdGVkSW5WZXIiOiI0Mi43MC4yIiwidXBkYXRlZEluVmVyIjoiNDIuNzAuMiIsInRhcmdldEJyYW5jaCI6Im1haW4iLCJsYWJlbHMiOlsiRGVwZW5kZW5jaWVzIiwiRGVwZW5kZW5jaWVzL1Jlbm92YXRlIl19-->
chore(deps): update dependency @rspress/plugin-sitemap to v2.0.0
Some checks failed
Documentation / Build and Deploy Documentation (pull_request) Failing after 2m3s
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 5m13s
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 51m28s
71c3af43d4
ginger closed this pull request 2026-01-29 15:47:06 +00:00
Some checks failed
Documentation / Build and Deploy Documentation (pull_request) Failing after 2m3s
Checks / Prek / Pre-commit & Formatting (pull_request) Successful in 5m13s
Required
Details
Checks / Prek / Clippy and Cargo Tests (pull_request) Successful in 51m28s
Required
Details

Pull request closed

Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
continuwuation/continuwuity!1321
No description provided.