@bleedingdev/modern-js-main-doc 3.2.0-ultramodern.119 → 3.2.0-ultramodern.120

package/docs/en/configure/app/tools/ts-checker.mdx

@@ -2,6 +2,8 @@
 title: tsChecker
 ---
 
+import { PackageManagerTabs } from '@theme';
+
 # tools.tsChecker
 
 - **Type:** `Object | Function`
@@ -14,6 +16,8 @@ const defaultOptions = {
     memoryLimit: 8192,
     // use tsconfig of user project
     configFile: tsconfigPath,
+    // use TypeScript Go checker by default
+    tsgo: true,
     // use TS-Go native preview of user project
     typescriptPath: require.resolve('@typescript/native-preview/package.json'),
   },
@@ -35,7 +39,7 @@ const defaultOptions = {
 },
 ```
 
-By default, Modern.js type checking is aligned with the TS-Go native preview used by this fork. You can use `output.disableTsChecker` config to disable build-time checking.
+By default, the [@rsbuild/plugin-type-check](https://github.com/rstackjs/rsbuild-plugin-type-check) is enabled for type checking. You can use `output.disableTsChecker` config to disable it.
 
 ## Example
 
@@ -53,4 +57,28 @@ export default {
 };
 ```
 
-> This fork keeps the TypeScript toolchain on `@typescript/native-preview` / `tsgo`; do not install the classic `typescript` compiler for application type checking.
+## TypeScript Go by Default
+
+Type checking runs on [TypeScript Go](https://github.com/microsoft/typescript-go) (`tsgo`) by default in this fork. The capability is provided by [`ts-checker-rspack-plugin`](https://github.com/rstackjs/ts-checker-rspack-plugin), which is integrated by [`@rsbuild/plugin-type-check`](https://github.com/rstackjs/rsbuild-plugin-type-check), and reduces type-checking time by about 5-10x.
+
+`@typescript/native-preview` ships with the builder, so no extra install is needed. To pin your own version, install it in your project:
+
+<PackageManagerTabs command="install @typescript/native-preview -D" />
+
+When `tsgo` is enabled, the default `typescript.typescriptPath` resolves to `@typescript/native-preview/package.json`. If you manually set `typescript.typescriptPath`, it must be an absolute path to `@typescript/native-preview/package.json`.
+
+To fall back to the classic TypeScript checker, set `typescript.tsgo` to `false` and make sure `typescript` is installed in your project:
+
+```ts
+export default {
+  tools: {
+    tsChecker: {
+      typescript: {
+        tsgo: false,
+      },
+    },
+  },
+};
+```
+
+For supported options and limitations, please refer to [ts-checker-rspack-plugin - TypeScript Go support](https://github.com/rstackjs/ts-checker-rspack-plugin#typescript-go-support).

package/docs/zh/configure/app/tools/ts-checker.mdx

@@ -2,6 +2,8 @@
 title: tsChecker
 ---
 
+import { PackageManagerTabs } from '@theme';
+
 # tools.tsChecker
 
 - **类型：** `Object | Function`
@@ -14,6 +16,8 @@ const defaultOptions = {
     memoryLimit: 8192,
     // use tsconfig of user project
     configFile: tsconfigPath,
+    // use TypeScript Go checker by default
+    tsgo: true,
     // use TS-Go native preview of user project
     typescriptPath: require.resolve('@typescript/native-preview/package.json'),
   },
@@ -35,7 +39,7 @@ const defaultOptions = {
 },
 ```
 
-默认情况下，Modern.js 会开启 [@rsbuild/plugin-type-check](https://github.com/rspack-contrib/rsbuild-plugin-type-check) 进行类型检查。你可以通过 `output.disableTsChecker` 配置项来关闭类型检查。
+默认情况下，Modern.js 会开启 [@rsbuild/plugin-type-check](https://github.com/rstackjs/rsbuild-plugin-type-check) 进行类型检查。你可以通过 `output.disableTsChecker` 配置项来关闭类型检查。
 
 ## 示例
 
@@ -53,4 +57,28 @@ export default {
 };
 ```
 
-> 请参考 [@rsbuild/plugin-type-check](https://github.com/rspack-contrib/rsbuild-plugin-type-check) 了解更多用法。
+## TypeScript Go 默认开启
+
+类型检查默认使用 [TypeScript Go](https://github.com/microsoft/typescript-go)（`tsgo`）。该能力由 [`@rsbuild/plugin-type-check`](https://github.com/rstackjs/rsbuild-plugin-type-check) 底层集成的 [`ts-checker-rspack-plugin`](https://github.com/rstackjs/ts-checker-rspack-plugin) 提供，可以将类型检查耗时减少约 5-10 倍。
+
+`@typescript/native-preview` 已随构建器内置，无需额外安装。如需固定版本，可在项目中自行安装：
+
+<PackageManagerTabs command="install @typescript/native-preview -D" />
+
+开启 `tsgo` 后，默认的 `typescript.typescriptPath` 会解析到 `@typescript/native-preview/package.json`。如果你手动设置了 `typescript.typescriptPath`，它必须是指向 `@typescript/native-preview/package.json` 的绝对路径。
+
+如需回退到经典 TypeScript 检查器，请将 `typescript.tsgo` 设置为 `false`，并确保项目中安装了 `typescript`：
+
+```ts
+export default {
+  tools: {
+    tsChecker: {
+      typescript: {
+        tsgo: false,
+      },
+    },
+  },
+};
+```
+
+关于 `tsgo` 模式下生效的配置项和相关限制，请参考 [ts-checker-rspack-plugin - TypeScript Go support](https://github.com/rstackjs/ts-checker-rspack-plugin#typescript-go-support)。

package/package.json

@@ -18,24 +18,24 @@
     "modern",
     "modern.js"
   ],
-  "version": "3.2.0-ultramodern.119",
+  "version": "3.2.0-ultramodern.120",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
     "access": "public"
   },
   "dependencies": {
     "mermaid": "^11.15.0",
-    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.2.0-ultramodern.119"
+    "@modern-js/sandpack-react": "npm:@bleedingdev/modern-js-sandpack-react@3.2.0-ultramodern.120"
   },
   "devDependencies": {
     "@rsbuild/plugin-sass": "1.5.3",
-    "@rspress/core": "2.0.13",
-    "@rspress/plugin-llms": "2.0.13",
-    "@rspress/shared": "2.0.13",
-    "@shikijs/transformers": "^4.1.0",
+    "@rspress/core": "2.0.14",
+    "@rspress/plugin-llms": "2.0.14",
+    "@rspress/shared": "2.0.14",
+    "@shikijs/transformers": "^4.2.0",
     "@types/fs-extra": "11.0.4",
-    "@types/node": "^25.9.1",
-    "@typescript/native-preview": "7.0.0-dev.20260606.1",
+    "@types/node": "^25.9.3",
+    "@typescript/native-preview": "7.0.0-dev.20260610.1",
     "classnames": "^2.5.1",
     "clsx": "^2.1.1",
     "fs-extra": "^11.3.5",