Merge pull request #1005 from vitejs/sync-ebcefc9f-1

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

Author: waynzh

.vitepress/theme/composables/sponsor.ts

@@ -47,33 +47,7 @@ const viteSponsors: Pick<Sponsors, 'special' | 'gold'> = {
     },
   ],
   gold: [
-    // through GitHub -> OpenCollective
-    {
-      name: 'Remix',
-      url: 'https://remix.run/',
-      img: '/remix.svg',
-    },
-    {
-      name: 'Nx',
-      url: 'https://nx.dev/',
-      img: '/nx.svg',
-    },
-    {
-      name: 'Transloadit',
-      url: 'https://transloadit.com/?utm_source=vite&utm_medium=referral&utm_campaign=sponsorship&utm_content=website',
-      img: '/transloadit.svg',
-      hasDark: true,
-    },
-    {
-      name: 'Huly',
-      url: 'https://huly.io/',
-      img: '/huly.svg',
-    },
-    {
-      name: 'Handsontable',
-      url: 'https://handsontable.com/docs/react-data-grid/?utm_source=vite_docs&utm_medium=sponsorship&utm_campaign=library_sponsorship_2024',
-      img: '/handsontable.svg',
-    },
+    // now automated via sponsors.vuejs.org too
   ],
 }
 

config/build-options.md

@@ -41,12 +41,13 @@ type ResolveModulePreloadDependenciesFn = (
   url: string,
   deps: string[],
   context: {
-    importer: string
+    hostId: string
+    hostType: 'html' | 'js'
   },
 ) => string[]
 ```
 
-`resolveDependencies` 函数将为每个动态导入调用，同时带着一个它所依赖的 chunk 列表。并且它还会为每个在入口 HTML 文件中导入的 chunk 调用。 可以返回一个新的依赖关系数组，可能被过滤后变少了，也可能有更多依赖注入进来了，同时它们的路径也被修改过。`deps` 路径是相对于 `build.outDir` 的。若在注入该模块到 HTML head 时使用 `new URL(dep, import.meta.url)` 获取绝对路径，则对于 `hostType === 'js'`，允许返回一个相对于 `hostId` 的路径。
+`resolveDependencies` 函数会在每次动态导入时被调用，并包含其依赖的 chunk 列表。同时，它也会在入口 HTML 文件中导入每个 chunk 时被调用。你可以返回一个新的依赖数组，其中可以过滤掉或注入更多的依赖，或修改它们的路径。`deps` 路径是相对于 `build.outDir` 的。返回值应是对于 `build.outDir` 的相对路径。
 
 ```js twoslash
 /** @type {import('vite').UserConfig} */

guide/api-plugin.md

@@ -431,7 +431,6 @@ Vite 插件也可以提供钩子来服务于特定的 Vite 目标。这些钩子
 
     ```js
     handleHotUpdate({ server, modules, timestamp }) {
-      server.ws.send({ type: 'full-reload' })
       // 手动使模块失效
       const invalidatedModules = new Set()
       for (const mod of modules) {
@@ -442,6 +441,7 @@ Vite 插件也可以提供钩子来服务于特定的 Vite 目标。这些钩子
           true
         )
       }
+      server.ws.send({ type: 'full-reload' })
       return []
     }
     ```

package.json

@@ -8,11 +8,11 @@
 	"private": true,
 	"license": "CC BY-NC-SA 4.0",
 	"devDependencies": {
-		"@shikijs/vitepress-twoslash": "^1.12.0",
+		"@shikijs/vitepress-twoslash": "^1.14.1",
 		"@types/express": "^4.17.21",
 		"feed": "^4.2.2",
-		"vitepress": "1.3.1",
-		"vue": "^3.4.34",
+		"vitepress": "1.3.3",
+		"vue": "^3.4.38",
 		"@types/node": "^20.9.2",
 		"chalk": "^4.1.2",
 		"gray-matter": "^4.0.3",