Merge pull request #877 from vitest-dev/sync-7e382ef5-1

docs(en): merge docs-cn/sync-docs into docs-cn/dev @ 7e382ef

Author: NoiseFan

api/expect-typeof.md

@@ -552,3 +552,24 @@ expectTypeOf(obj).toHaveProperty('a').toBeNumber()
 expectTypeOf(obj).toHaveProperty('b').toBeString()
 expectTypeOf(obj).toHaveProperty('a').not.toBeString()
 ```
+
+<!-- TODO: translation -->
+## branded
+
+- **Type:** `ExpectTypeOf<BrandedType>`
+
+You can use `.branded` to allow type assertions to succeed for types that are semantically equivalent but differ in representation.
+
+```ts
+import { expectTypeOf } from 'vitest'
+
+// Without .branded, this fails even though the types are effectively the same
+expectTypeOf<{ a: { b: 1 } & { c: 1 } }>().toEqualTypeOf<{ a: { b: 1; c: 1 } }>()
+
+// With .branded, the assertion succeeds
+expectTypeOf<{ a: { b: 1 } & { c: 1 } }>().branded.toEqualTypeOf<{ a: { b: 1; c: 1 } }>()
+```
+
+::: warning
+This helper comes at a performance cost and can cause the TypeScript compiler to 'give up' if used with excessively deep types. Use it sparingly and only when necessary.
+:::

config/experimental.md

@@ -2,11 +2,16 @@
 title: experimental | Config
 outline: deep
 ---
+<!-- TODO: translation -->
 
 # experimental
 
 ## experimental.fsModuleCache <Version type="experimental">4.0.11</Version> {#experimental-fsmodulecache}
 
+::: tip 功能反馈
+请将关于此功能反馈提交至 [GitHub Discussion](https://github.com/vitest-dev/vitest/discussions/9221)。
+:::
+
 - **Type:** `boolean`
 - **Default:** `false`
 
@@ -103,6 +108,10 @@ At the moment, Vitest ignores the [test.cache.dir](/config/cache) or [cacheDir](
 
 ## experimental.openTelemetry <Version type="experimental">4.0.11</Version> {#experimental-opentelemetry}
 
+::: tip 功能反馈
+请将关于此功能反馈提交至 [GitHub Discussion](https://github.com/vitest-dev/vitest/discussions/9222)。
+:::
+
 - **Type:**
 
 ```ts
@@ -168,6 +177,10 @@ It's important that Node can process `sdkPath` content because it is not transfo
 
 ## experimental.printImportBreakdown <Version type="experimental">4.0.15</Version> {#experimental-printimportbreakdown}
 
+::: tip 功能反馈
+请将关于此功能反馈提交至 [GitHub Discussion](https://github.com/vitest-dev/vitest/discussions/9224)。
+:::
+
 - **Type:** `boolean`
 - **Default:** `false`
 

config/onstacktrace.md

@@ -2,12 +2,12 @@
 title: onStackTrace | Config
 outline: deep
 ---
-
+<!-- TODO: translation -->
 # onStackTrace <CRoot />
 
 - **Type**: `(error: Error, frame: ParsedStack) => boolean | void`
 
-Apply a filtering function to each frame of each stack trace when handling errors. This does not apply to stack traces printed by [`printConsoleTrace`](#printConsoleTrace). The first argument, `error`, is a `TestError`.
+Apply a filtering function to each frame of each stack trace when handling errors. This does not apply to stack traces printed by [`printConsoleTrace`](/config/printconsoletrace#printconsoletrace). The first argument, `error`, is a `TestError`.
 
 Can be useful for filtering out stack trace frames from third-party libraries.
 

guide/open-telemetry.md

@@ -1,9 +1,11 @@
 # Open Telemetry Support <Experimental /> {#open-telemetry-support}
+<!-- TODO: translation -->
+::: tip 功能反馈
+请将关于此功能反馈提交至 [GitHub Discussion](https://github.com/vitest-dev/vitest/discussions/9222)。
+:::
 
-::: tip Example Project
-
+::: tip 示例项目
 [GitHub](https://github.com/vitest-dev/vitest/tree/main/examples/opentelemetry)
-
 :::
 
 [OpenTelemetry](https://opentelemetry.io/) traces can be a useful tool to debug the performance and behavior of your application inside tests.

guide/ui.md

@@ -129,6 +129,10 @@ npx vite preview --outDir ./html
 
 ### 导入耗时分析 {#import-breakdown}
 
+::: tip 功能反馈
+请将关于此功能反馈提交至 [GitHub Discussion](https://github.com/vitest-dev/vitest/discussions/9224)。
+:::
+
 模块图选项卡还会提供导入耗时分析功能，默认显示加载时间最长的10个模块（点击"显示更多"可追加10个），按总耗时排序。
 
 <img alt="Import breakdown with a list of top 10 modules that take the longest time to load" img-light src="/ui/light-import-breakdown.png">

netlify.toml

@@ -3,7 +3,7 @@ publish = ".vitepress/dist"
 command = "npx pnpm i --ignore-scripts && pnpm run build"
 
 [build.environment]
-NODE_VERSION = "20"
+NODE_VERSION = "24"
 
 [[redirects]]
 from = "https://cn-vitest.netlify.app/*"