@rsdoctor/docs 1.4.0 → 1.5.0

package/docs/en/blog/release/release-note-1_0.mdx

@@ -46,7 +46,7 @@ Based on the above situation, we decided to develop a build analyzer focused on
 
 We designed an intuitive user interface for Rsdoctor, and Rsdoctor extends the **loader profiling capability** by combining the advantages of multiple tools to more deeply analyze the loader behavior in the compilation phase, **built-in the scanning and detection rules for artifacts and compilation**, and supports user **custom rules**.
 
-Rsdoctor not only supports Rspack and webpack, but also supports all tools and frameworks based on Rspack or webpack, such as: [Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor), [Rspeedy (Lynx)](https://lynxjs.org/rspeedy/), [Storybook](https://github.com/rspack-contrib/storybook-rsbuild), [Next.js](https://nextjs.org/), [Nuxt](https://nuxt.com/), [Re.Pack](https://re-pack.dev/), [Modern.js](https://modernjs.dev/), [Rsbuild](https://rsbuild.rs/), [Rspress](https://rspress.rs/) and [Rslib](https://rslib.rs/).
+Rsdoctor not only supports Rspack and webpack, but also supports all tools and frameworks based on Rspack or webpack, such as: [Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor), [Rspeedy (Lynx)](https://lynxjs.org/rspeedy/), [Storybook](https://github.com/rstackjs/storybook-rsbuild), [Next.js](https://nextjs.org/), [Nuxt](https://nuxt.com/), [Re.Pack](https://re-pack.dev/), [Modern.js](https://modernjs.dev/), [Rsbuild](https://rsbuild.rs/), [Rspress](https://rspress.rs/) and [Rslib](https://rslib.rs/).
 
 Rsdoctor can be used to:
 

package/docs/en/config/options/experiments.mdx

@@ -8,7 +8,7 @@ import { Badge } from '@theme';
 
 - **Type:** `boolean`
 - **Optional:** `true`
-- **Default:** `false`
+- **Default:** `true`
 
 By enabling the enableNativePlugin option, the Rspack native plugin moves the time-consuming data processing logic from Rsdoctor to the Rspack build stage, significantly improving build analysis efficiency and greatly reducing Rsdoctor's own analysis time.
 

package/docs/en/config/options/options.mdx

@@ -122,7 +122,7 @@ interface RsdoctorWebpackPluginOptions<
 interface RsdoctorRspackPluginExperiments {
   /**
    * Whether to enable native plugin to improve performance
-   * @default false
+   * @default true
    */
   enableNativePlugin?: boolean;
 }

package/docs/en/config/options/output.mdx

@@ -194,7 +194,9 @@ NormalModeOptions currently has an empty Object type.
 
 ```js
 new RsdoctorRspackPlugin({
-  reportCodeType: { noModuleSource: true } // { noAssetsAndModuleSource: true }
+  output: {
+    reportCodeType: { noModuleSource: true } // { noAssetsAndModuleSource: true }
+  }
 }),
 ```
 

package/docs/en/guide/rules/rules.mdx

@@ -31,11 +31,9 @@ Please refer to the [Linter Type](#linter-type) in this document for the type de
 <img src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-alerts.png" />
 
 - Clicking the icon to expand the duplicate package details allows you to see: the name, version, size, and reference files of the duplicate package.
-
   - Clicking the **「Show Relations」** on the far right can view the specific reference chain and the corresponding reference file code position of this third-party package.
 
   <img src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-alters-relations.png" />
-
   - Clicking the **「!（exclamation mark）」** icon on the far right can view the specific explanation of the rule for the duplicate third-party package.
 
   <img src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-alters-rule.png" />
@@ -203,7 +201,7 @@ type CheckSyntaxOptions = {
 };
 ```
 
-For more `ECMA Version Check` configuration options, please refer to [ECMA Version Check Options](https://github.com/rspack-contrib/rsbuild-plugin-check-syntax?tab=readme-ov-file#options)
+For more `ECMA Version Check` configuration options, please refer to [ECMA Version Check Options](https://github.com/rstackjs/rsbuild-plugin-check-syntax?tab=readme-ov-file#options)
 
 ### [E1005] Default import check
 

package/docs/en/guide/start/action.mdx

@@ -58,9 +58,12 @@ Create a `.github/workflows/ci.yml` file in your GitHub repository as shown in t
 target_branch: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || github.event.repository.default_branch }}
 ```
 
-- `on` indicates when the workflow runs, commonly set to `pull_request` and `push`.
+- `dispatch_target_branch`: Optional, used to specify the target branch when manually triggered (workflow_dispatch).
+
+- `on` indicates when the workflow runs, commonly set to `pull_request` and `push`, and also supports `workflow_dispatch` for manual triggering.
   - On `pull_request`, Rsdoctor Action fetches baseline and current and performs bundle diff analysis.
   - On `push` (i.e., after PR merge), it updates and uploads the baseline.
+  - `workflow_dispatch` allows you to manually trigger the workflow from the GitHub Actions page. This mode combines the behavior of `push` and `pull_request`: it uploads baseline data, and if `dispatch_target_branch` is specified, it also performs baseline comparison analysis.
 - Before executing rsdoctor-action, build your project with the Rsdoctor plugin enabled to generate the Rsdoctor JSON data file.
 
 ```yaml
@@ -72,6 +75,13 @@ on:
   push:
     branches:
       - main # or your target branch name
+  workflow_dispatch: # Optional, allows manual triggering
+    inputs:
+      target_branch:
+        description: 'Target branch to compare against'
+        required: false
+        default: 'main'
+        type: string
 
 jobs:
   bundle-analysis:
@@ -115,6 +125,8 @@ jobs:
           # Default 'main'. If you want to use a dynamic target branch, i.e., automatically get the target branch of the current pull request instead of a fixed main branch, you can use the following configuration:
           # ${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || github.event.repository.default_branch }}
           target_branch: 'main'
+          # Target branch for manual trigger
+          dispatch_target_branch: ${{ github.event.inputs.target_branch }}
 ```
 
 ## View Reports

package/docs/en/guide/start/intro.mdx

@@ -4,7 +4,7 @@ Rsdoctor is a build analyzer tailored for the [Rspack](https://rspack.rs/) ecosy
 
 Rsdoctor is committed to being a one-stop, intelligent build analyzer that makes the build process transparent, predictable, and optimizable through visualization and smart analysis, helping development teams precisely identify bottlenecks, optimize performance, and improve engineering quality.
 
-Rsdoctor supports all tools and frameworks based on Rspack or webpack, such as: [Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor), [Rspeedy (Lynx)](https://lynxjs.org/rspeedy/), [Storybook](https://github.com/rspack-contrib/storybook-rsbuild), [Next.js](https://nextjs.org/), [Nuxt](https://nuxt.com/), [Re.Pack](https://re-pack.dev/), [Modern.js](https://modernjs.dev/), [Rsbuild](https://rsbuild.rs/), [Rspress](https://rspress.rs/) and [Rslib](https://rslib.rs/).
+Rsdoctor supports all tools and frameworks based on Rspack or webpack, such as: [Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor), [Rspeedy (Lynx)](https://lynxjs.org/rspeedy/), [Storybook](https://github.com/rstackjs/storybook-rsbuild), [Next.js](https://nextjs.org/), [Nuxt](https://nuxt.com/), [Re.Pack](https://re-pack.dev/), [Modern.js](https://modernjs.dev/), [Rsbuild](https://rsbuild.rs/), [Rspress](https://rspress.rs/) and [Rslib](https://rslib.rs/).
 
 <video
   src="https://assets.rspack.rs/others/assets/rsdoctor/rsdoctor-1.0-ui.mp4"

package/docs/zh/blog/release/release-note-1_0.mdx

@@ -46,7 +46,7 @@ Rsdoctor 致力于成为一站式、智能化的构建分析工具，通过可
 
 我们为 Rsdoctor 设计了直观的用户界面，将构建数据可视化。同时，Rsdoctor 在结合多种工具的基础上，额外扩展了 loader 分析能力以更深入 loader 的编译行为，内置了产物及编译的扫描和检测规则，并支持用户自定义规则。
 
-Rsdoctor 不仅支持 Rspack 和 webpack，也支持所有基于 Rspack 或 webpack 的工具和框架，例如：[Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor)、[Rspeedy (Lynx)](https://lynxjs.org/rspeedy/)、[Storybook](https://github.com/rspack-contrib/storybook-rsbuild)、[Next.js](https://nextjs.org/)、[Nuxt](https://nuxt.com/)、[Re.Pack](https://re-pack.dev/)、[Modern.js](https://modernjs.dev/)、[Rsbuild](https://rsbuild.rs/)、[Rspress](https://rspress.rs/) 和 [Rslib](https://rslib.rs/) 等。
+Rsdoctor 不仅支持 Rspack 和 webpack，也支持所有基于 Rspack 或 webpack 的工具和框架，例如：[Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor)、[Rspeedy (Lynx)](https://lynxjs.org/rspeedy/)、[Storybook](https://github.com/rstackjs/storybook-rsbuild)、[Next.js](https://nextjs.org/)、[Nuxt](https://nuxt.com/)、[Re.Pack](https://re-pack.dev/)、[Modern.js](https://modernjs.dev/)、[Rsbuild](https://rsbuild.rs/)、[Rspress](https://rspress.rs/) 和 [Rslib](https://rslib.rs/) 等。
 
 Rsdoctor 可以被用于：
 

package/docs/zh/config/options/experiments.mdx

@@ -8,7 +8,7 @@ import { Badge } from '@theme';
 
 - **类型：** `boolean`
 - **可选：** `true`
-- **默认值：** `false`
+- **默认值：** `true`
 
 通过 enableNativePlugin 选项开启 Rspack 原生插件，将 Rsdoctor 中耗时较大的数据处理逻辑前置到 Rspack 构建阶段，从而显著提升构建分析效率并大幅降低 Rsdoctor 自身的分析耗时。
 

package/docs/zh/config/options/options.mdx

@@ -121,7 +121,7 @@ interface RsdoctorWebpackPluginOptions<
 interface RsdoctorRspackPluginExperiments {
   /**
    * 是否启用原生插件以提高性能
-   * @default false
+   * @default true
    */
   enableNativePlugin?: boolean;
 }

package/docs/zh/config/options/output.mdx

@@ -191,7 +191,9 @@ NormalModeOptions 目前类型为空 Object。
 
 ```js
 new RsdoctorRspackPlugin({
-  reportCodeType: { noModuleSource: true } // { noAssetsAndModuleSource: true }
+  output: {
+     reportCodeType: { noModuleSource: true } // { noAssetsAndModuleSource: true }
+  }
 }),
 ```
 

package/docs/zh/guide/rules/rules.mdx

@@ -28,11 +28,9 @@
 <img src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-alerts.png" />
 
 - 点击图标展开重复包详情，可以看到：重复包的包名、版本、大小、引用文件。
-
   - 点击最右侧 **「Show Relations」** 可以查看具体这个第三方的引用链路和对应的引用文件代码位置。
 
   <img src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-alters-relations.png" />
-
   - 点击最右侧 **「!（叹号）」** 图标，可以查看重复第三方包的规则的具体解释。
 
   <img src="https://assets.rspack.rs/others/assets/rsdoctor/bundle-alters-rule.png" />
@@ -200,7 +198,7 @@ type CheckSyntaxOptions = {
 };
 ```
 
-更多 `ECMA Version Check` 配置请参考 [ECMA Version Check Options](https://github.com/rspack-contrib/rsbuild-plugin-check-syntax?tab=readme-ov-file#options)
+更多 `ECMA Version Check` 配置请参考 [ECMA Version Check Options](https://github.com/rstackjs/rsbuild-plugin-check-syntax?tab=readme-ov-file#options)
 
 ### [E1005] Default import check
 

package/docs/zh/guide/start/action.mdx

@@ -58,9 +58,12 @@ export default defineConfig({
 target_branch: ${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || github.event.repository.default_branch }}
 ```
 
-- `on` 是指 workflow 运行的时机，通常设置为 `pull_request` 和 `push`。
+- `dispatch_target_branch`：非必需，用于手动触发 (workflow_dispatch) 时指定目标分支。
+
+- `on` 是指 workflow 运行的时机，通常设置为 `pull_request` 和 `push`，也支持 `workflow_dispatch` 手动触发。
   - 在 `pull_request` 时，Rsdoctor Action 会拉取 baseline 和 current，进行 bundle diff 分析。
   - 在 `push`（即 PR 合并）时，会进行 baseline 的更新和上传操作。
+  - `workflow_dispatch` 允许在 GitHub Actions 页面手动触发工作流。此模式结合了 `push` 和 `pull_request` 的行为：会上传 baseline 数据，同时如果指定了 `dispatch_target_branch`，还会进行 baseline 对比分析。
 - 在执行 rsdoctor-action 之前，需要先将项目进行构建，构建时需要开启 Rsdoctor 插件，并生成 Rsdoctor JSON 数据文件。
 
 ```yaml
@@ -72,6 +75,13 @@ on:
   push:
     branches:
       - main # 或者其他目标分支
+  workflow_dispatch: # 可选，允许手动触发
+    inputs:
+      target_branch:
+        description: '用于对比的目标分支'
+        required: false
+        default: 'main'
+        type: string
 
 jobs:
   bundle-analysis:
@@ -115,6 +125,8 @@ jobs:
           # 默认 'main'，如果想用不固定的目标分支，即自动获取当前 pull request 的 target branch，则可以使用下方配置：
           # ${{ github.event_name == 'pull_request' && github.event.pull_request.base.ref || github.event.repository.default_branch }}
           target_branch: 'main'
+          # 手动触发时使用的目标分支
+          dispatch_target_branch: ${{ github.event.inputs.target_branch }}
 ```
 
 ## 查看报告

package/docs/zh/guide/start/intro.mdx

@@ -4,7 +4,7 @@ Rsdoctor 是一款为 [Rspack](https://rspack.rs/) 生态量身打造的构建
 
 Rsdoctor 致力于成为一站式、智能化的构建分析工具，通过可视化与智能分析，使整个构建流程变得透明、可预测和可优化，从而帮助开发团队精准定位瓶颈、优化性能并提升工程质量。
 
-Rsdoctor 支持所有基于 Rspack 或 webpack 的工具和框架，例如：[Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor)、[Rspeedy (Lynx)](https://lynxjs.org/rspeedy/)、[Storybook](https://github.com/rspack-contrib/storybook-rsbuild)、[Next.js](https://nextjs.org/)、[Nuxt](https://nuxt.com/)、[Re.Pack](https://re-pack.dev/)、[Modern.js](https://modernjs.dev/)、[Rsbuild](https://rsbuild.rs/)、[Rspress](https://rspress.rs/) 和 [Rslib](https://rslib.rs/) 等。
+Rsdoctor 支持所有基于 Rspack 或 webpack 的工具和框架，例如：[Docusaurus](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-rsdoctor)、[Rspeedy (Lynx)](https://lynxjs.org/rspeedy/)、[Storybook](https://github.com/rstackjs/storybook-rsbuild)、[Next.js](https://nextjs.org/)、[Nuxt](https://nuxt.com/)、[Re.Pack](https://re-pack.dev/)、[Modern.js](https://modernjs.dev/)、[Rsbuild](https://rsbuild.rs/)、[Rspress](https://rspress.rs/) 和 [Rslib](https://rslib.rs/) 等。
 
 <video
   src="https://assets.rspack.rs/others/assets/rsdoctor/rsdoctor-1.0-ui.mp4"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsdoctor/docs",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/web-infra-dev/rsdoctor",
@@ -18,8 +18,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@rspress/plugin-algolia": "2.0.0-rc.3",
-    "@rspress/plugin-llms": "2.0.0-rc.3",
+    "@rspress/plugin-algolia": "2.0.0-rc.5",
+    "@rspress/plugin-llms": "2.0.0-rc.5",
     "@rspress/plugin-rss": "2.0.0-rc.0",
     "@types/node": "^22.8.1",
     "@types/react": "^18.3.27",
@@ -33,13 +33,13 @@
     "rspress-plugin-sitemap": "^1.2.1",
     "typescript": "^5.9.2",
     "@rsbuild/plugin-sass": "^1.4.0",
-    "@rsdoctor/types": "1.4.0"
+    "@rsdoctor/types": "1.5.0"
   },
   "dependencies": {
     "@rstack-dev/doc-ui": "1.12.2",
     "clsx": "^2.1.1",
     "react-markdown": "^9.1.0",
-    "@rspress/core": "2.0.0-rc.3"
+    "@rspress/core": "2.0.0-rc.5"
   },
   "scripts": {
     "dev": "cross-env RSPRESS_PERSIST_CACHE=false rspress dev",