v1.45.2

What's Changed

Bug Fixes 🐞

• fix(plugin-preview): preview demo should not include too much css like tailwind for css confliction by @SoonIter in #2520

Other Changes

• Release v1.45.2 by @SoonIter in #2522

Full Changelog: v1.45.1...v1.45.2

v2.0.0-beta.28

What's Changed

New Features 🎉

• feat: generate Open Graph title and type tags by default by @chenjiahan in #2490

Bug Fixes 🐞

• fix(deps): remove unused dependencies from multiple packages by @chenjiahan in #2493
• fix(theme): move rspress-logo and some other styles out of rp-base layer by @SoonIter in #2488

Document 📖

• docs: upgrade readme and add npm link to docsite by @SoonIter in #2491

Other Changes

• refactor: remove unused normalizeHrefInRuntime by @SoonIter in #2482
• refactor: normalizeThemeConfig code style by @SoonIter in #2481
• chore(deps): update all patch dependencies by @renovate[bot] in #2483
• chore(deps): update actions/checkout action to v4.3.0 by @renovate[bot] in #2484
• chore(deps): update dependency @rslib/core to v0.12.1 by @renovate[bot] in #2486
• chore(deps): update dependency @biomejs/biome to ^2.2.0 by @renovate[bot] in #2485
• refactor(virtual-module): move searchIndex to rsbuild-plugin-virtual-module by @SoonIter in #2487
• refactor(virtual-module): update lark icon and virtual-social-links by @SoonIter in #2492
• chore(search): polish search jump logic and add searchHooks e2e by @SoonIter in #2496
• Release v2.0.0-beta.28 by @SoonIter in #2497

Full Changelog: v2.0.0-beta.27...v2.0.0-beta.28

v2.0.0-beta.27

Highlights ✨

Add layer for base.css to support tailwind v4

related PR: #2477

What's Changed

New Features 🎉

• feat(theme)!: add layer for base.css to support tailwind v4 by @SoonIter in #2477

Bug Fixes 🐞

• fix: export usePage to replace deprecated usePageData by @JounQin in #2471
• fix: revert asset link support and fix the corner case when filename contains dot by @SoonIter in #2473

Document 📖

• docs(mdx): add markdown container part by @SoonIter in #2467

Other Changes

• chore(core): add runtime alias by default for multi-instance problem in monorepo by @SoonIter in #2463
• chore: remove unused constant by @SoonIter in #2465
• refactor(theme): usePageData => usePage by @SoonIter in #2466
• chore(theme): rename useSiteData to useSite by @SoonIter in #2474
• chore(infra/script): update css typed modules by @SoonIter in #2476
• chore: move website to the workspace root by @chenjiahan in #2478
• Release v2.0.0-beta.27 by @SoonIter in #2480

Full Changelog: v2.0.0-beta.26...v2.0.0-beta.27

v2.0.0-beta.26

What's Changed

Bug Fixes 🐞

• fix(auto-nav-sidebar): correct both _meta.json and _nav.json exist behavior by @SoonIter in #2453
• fix(plugin-llms): support dark mode by @SoonIter in #2455
• fix(theme/Link): Link and HomeHero should support relative url by @SoonIter in #2456

Document 📖

• docs: add Rslint and version badges to Rstack tools table by @chenjiahan in #2451

Other Changes

• refactor(runtime): split hooks into several files by @SoonIter in #2454
• chore(deps): update all patch dependencies by @renovate[bot] in #2457
• chore(deps): update dependency zx to ^8.8.0 by @renovate[bot] in #2458
• chore(deps): update rsbuild by @renovate[bot] in #2459
• chore(deps): update dependency react-router-dom to ^6.30.1 by @renovate[bot] in #2338
• chore(deps): update shiki monorepo to ^3.9.2 by @renovate[bot] in #2460
• Release v2.0.0-beta.26 by @SoonIter in #2461

Full Changelog: v2.0.0-beta.25...v2.0.0-beta.26

v2.0.0-beta.25

Highlights ✨

Enable trusted publishing for npm packages OIDC ♻️

related PR: #2444

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

UI Display of plugin-llms update 🆕️

related PR: #2439

What's Changed

New Features 🎉

• feat(plugin-llms/runtime): add markdownLink for copy by @SoonIter in #2439
• feat: add npm icon to social links by @saseungmin in #2441
• feat(plugin-llms)!: default value for i18n by @SoonIter in #2448

Bug Fixes 🐞

• fix(tab-list): Fix tabs scrolling when not overflowing by @howlettt in #2433
• fix(link): should support public folder asset by @SoonIter in #2440
• fix(plugin-llms): some md files sometimes do not emit by @SoonIter in #2443

Document 📖

• docs(typo): update plugin-llms by @SoonIter in #2432
• docs(v2): update code block line highlighting syntax to v2 by @saseungmin in #2431
• docs: add npm icon to social links in theme config documentation by @saseungmin in #2442

Other Changes

• chore(deps): update all patch dependencies by @renovate[bot] in #2435
• chore(deps): update dependency @types/babel__traverse to ^7.28.0 by @renovate[bot] in #2436
• chore(deps): update dependency memfs to ^4.36.0 by @renovate[bot] in #2437
• chore(deps): update pnpm to v10.14.0 by @renovate[bot] in #2438
• chore: enable trusted publishing for npm packages by @Timeless0911 in #2444
• Release v2.0.0-beta.25 by @SoonIter in #2449

New Contributors

• @howlettt made their first contribution in #2433
• @saseungmin made their first contribution in #2431

Full Changelog: v2.0.0-beta.24...v2.0.0-beta.25

v1.45.1

What's Changed

Other Changes

• chore: enable trusted publishing for npm packages by @Timeless0911 in #2445
• Release v1.45.1 by @Timeless0911 in #2447

Full Changelog: v1.45.0...v1.45.1

v2.0.0-beta.24

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

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

What's Changed

New Features 🎉

• feat(plugin-llms): add LlmsCopyButton by @SoonIter in #2426

Bug Fixes 🐞

• fix(plugin-llms)!: default value change mdxToMd: false by @SoonIter in #2428

Document 📖

• docs: polish the use-mdx/components by @SoonIter in #2425

Other Changes

• chore(deps): update rsbuild 1.4.12 and more accurate persistent cache by @SoonIter in #2429
• Release v2.0.0-beta.24 by @SoonIter in #2430

Full Changelog: v2.0.0-beta.23...v2.0.0-beta.24

v2.0.0-beta.23

Breaking Changes 🚨

Enable markdown.link.checkDeadLinks by default

related PR: #2423

Rspress V2 now re-implements the dead link check feature. More information is obtained during compilation, resulting in more accurate results and more beautiful logs.

Ref: https://v2.rspress.rs/guide/basic/use-mdx/link, https://v2.rspress.rs/zh/api/config/config-build#markdownlinkcheckdeadlinks

MDX fragments usage (ignore "_" prefix routes via route.excludeConvention)

related PR: #2149

In the docs directory, MDX fragments or React components need to be excluded from routing through the route.exclude configuration. For convenience, we agree that files starting with "_" will be excluded by default.

Ref: https://v2.rspress.rs/guide/basic/use-mdx/components

Highlights ✨

New plugin @rspress/plugin-sitemap 🗺️

related PR: #2416

thanks to @jl917, he created rspress-plugin-sitemap during Rspress V1 for generating sitemap.

@rspress/plugin-sitemap is a forked version of rspress-plugin-sitemap and it is compatible with Rspress V2. During Rspress V2, it will be maintained as an official Rspress plugin.

Ref: https://v2.rspress.rs/plugin/official-plugins/sitemap

Documentation of Rspress V2 is happening📚

Most of the breaking changes in Rspress V2 have been completed, and we are now gradually enriching the documentation and standardizing various features provided to Rspress users such as links and mdx fragments usage

What's Changed

New Features 🎉

• feat(plugin-sitemap): init @rspress/plugin-sitemap by @SoonIter in #2416
• feat!: enable checkDeadLinks by default and add markdown.link.autoPrefix by @SoonIter in #2415
• feat(core)!: routeService ignore "_" prefix files by default by @SoonIter in #2149

Performance 🚀

• perf(mdx/crossCompilerCache): free the memory after one read by @SoonIter in #2418

Bug Fixes 🐞

• fix(fileCodeBlock): should support hmr by @SoonIter in #2423

Document 📖

• docs: beta.22 @rspress/core breakingchange fix by @SoonIter in #2414
• docs: add @rspress/plugin-sitemap by @SoonIter in #2417

Other Changes

• chore: add open collective funding link by @chenjiahan in #2411
• chore(deps): update Biome to v2 by @Timeless0911 in #2412
• chore(deps): update all patch dependencies by @renovate[bot] in #2420
• chore(deps): update dependency @rslib/core to v0.11.0 by @renovate[bot] in #2421
• Release v2.0.0-beta.23 by @SoonIter in #2424

Full Changelog: v2.0.0-beta.22...v2.0.0-beta.23

v2.0.0-beta.22

Breaking Changes 🚨

Merge rspress package to @rspress/core package

related PR: #2386

It means rspress package will be deprecated, please migrate the package name to the following package name.

rspress => @rspress/core
rspress/config => @rspress/core
rspress/theme => @rspress/core/theme
rspress/runtime => @rspress/core/runtime
rspress/shiki-transformers => @rspress/core/shiki-transformers

before

// rspress.config.ts
import { defineConfig } from 'rspress/config';
export default defineConfig({
});

// theme/index.ts
import { usePageData, useDark } from 'rspress/runtime';
import { HomeLayout } from 'rspress/theme'

after

// rspress.config.ts
import { defineConfig } from '@rspress/core';
export default defineConfig({
});

// theme/index.ts
import { usePageData, useDark } from '@rspress/core/runtime';
import { HomeLayout } from '@rspress/core/theme'

Migration Steps from V1

You can use the search and replace feature of the IDE to search for and replace the above package name.

Highlights ✨

ssg.experimentalWorker based on tinypool to speed up ssg process

related PR: #2394

it is inspired by docusaurus 3.8, we introduced it so that large document sites (>=500 pages) can reduce memory usage and decrease SSG time.

it introduced a Node.js Worker Thread pool to run the SSG. With this new strategy, we can better leverage all the available CPUs, reduce static site generation time, and contain potential memory leaks.

// rspress.config.ts
import { defineConfig } from '@rspress/core';
export default defineConfig({
   ssg: {
     experimentalWorker: true
   }
});

What's Changed

New Features 🎉

• feat(ssg): add ssg.experimentalExcludeRoutePaths by @SoonIter in #2405

Performance 🚀

• perf(ssg): add ssg.experimentalWorker based on tinypool to speed up ssg process by @SoonIter in #2394

Bug Fixes 🐞

• fix(auto-nav-sidebar): custom link should support collapsible and collapsed like "type": dir by @SoonIter in #2382
• fix!: remove rspress package, rspress => @rspress/core rspress/theme => @rspress/core/theme rspress/runtime => @rspress/core/runtime by @SoonIter in #2386
• fix(fileCodeBlock): optimize the error message and fix .length is not defined by @SoonIter in #2387
• fix: use _nav.json in template by @Timeless0911 in #2391
• fix(ssg): ssg error with "base" configuration by @SoonIter in #2392
• fix(ssg): regression in V2, csr should also output html files for deploy by @SoonIter in #2393
• fix: use SocialLinks & SwitchAppearance components from theme by @jbroma in #2395
• fix(theme): aside should not cover the top buttons by @SoonIter in #2400
• fix(theme): aside should not cover the top buttons (#2400) by @SoonIter in #2401
• fix: directive node should have name field by @JounQin in #2403
• fix: search link with base by @JounQin in #2406

Other Changes

• chore(auto-nav-sidebar): update custom-link types by @SoonIter in #2383
• chore(deps): update dependency @rsbuild/plugin-less to ~1.3.0 by @renovate[bot] in #2397
• chore(deps): update shiki monorepo to ^3.8.1 by @renovate[bot] in #2398
• chore(deps): update all patch dependencies by @renovate[bot] in #2396
• Release v2.0.0-beta.22 by @SoonIter in #2407
• chore: remove types reference to fix tsc circular issue by @Timeless0911 in #2408

Full Changelog: v2.0.0-beta.21...v2.0.0-beta.22

v1.45.0

What's Changed

New Features 🎉

• feat: support file:// protocol and URL for icon by @JounQin in #2170
• feat!: expose type RspressPlugin from "rspress/core", "@rspress/shared" which is a private package should not be installed by users by @SoonIter in #2384

Bug Fixes 🐞

• fix(core/mdx-loader): due to frontmatter stack error loc and remove useless hmr old codes (#2168) by @JounQin in #2171
• fix(plugin-preview): fixed-per-comp "internal" prop should work by @SoonIter in #2181

Document 📖

• docs(plugin-shiki): update package.json description by @SoonIter in #2183
• docs: incorrect usage of socialLinks (#2192) by @JounQin in #2198
• docs: use escape character to bypass HTML render by @fi3ework in #2237

Other Changes

• chore(theme): export type CodeProps to use getCustomMDXComponent() by @JounQin in #2166
• Release v1.45.0 by @SoonIter in #2385

Full Changelog: v1.44.0...v1.45.0