Merge pull request #30 from rollup/sync-28c7b7cf

docs(en): merge rollup/master into rollup-docs-cn/master @ 28c7b7c

Author: waynzh

.github/workflows/deploy-website.yml

@@ -57,7 +57,7 @@ jobs:
           comment-author: 'github-actions[bot]'
           body-includes: 'Thank you for your contribution!'
       - name: Create or update comment
-        uses: peter-evans/create-or-update-comment@v2
+        uses: peter-evans/create-or-update-comment@v3
         id: createInitialComment
         with:
           comment-id: ${{ steps.findComment.outputs.comment-id }}
@@ -74,14 +74,14 @@ jobs:
 
             or load it into the REPL:
             https://rollupjs.org/repl/?pr=${{ github.event.number }}
-      - name: Update comment for Netlify deploy
-        uses: jakepartusch/wait-for-netlify-action@v1
-        id: waitForNetlify
+      - name: Find Vercel preview URL
+        uses: patrickedqvist/wait-for-vercel-preview@v1.3.1
+        id: waitForVercel
         with:
-          site_name: "rollupjs"
-      - name: Update comment for Netlify
-        uses: peter-evans/create-or-update-comment@v2
-        if: ${{ steps.waitForNetlify.outputs.url }}
+          token: ${{ secrets.GITHUB_TOKEN }}
+      - name: Update comment with Vercel preview URL
+        uses: peter-evans/create-or-update-comment@v3
+        if: ${{ steps.waitForVercel.outputs.url }}
         with:
           comment-id: ${{ steps.createInitialComment.outputs.comment-id }}
           issue-number: ${{ github.event.number }}
@@ -96,4 +96,4 @@ jobs:
             ```
 
             or load it into the REPL:
-            ${{ steps.waitForNetlify.outputs.url }}/repl/?pr=${{ github.event.number }}
+            ${{ steps.waitForVercel.outputs.url }}/repl/?pr=${{ github.event.number }}

.github/workflows/repl-artefacts.yml

@@ -6,6 +6,7 @@ on:
       - master
   pull_request:
     types: [synchronize, opened, reopened]
+  merge_group:
 
 permissions:
   contents: read

.github/workflows/tests.yml

@@ -1,5 +1,88 @@
 # rollup changelog
 
+## 3.21.0
+
+_2023-04-23_
+
+### Features
+
+- Support tree-shaking of named exports in dynamic imports when using destructuring and similar patterns (#4952)
+
+### Pull Requests
+
+- [#4952](https://github.com/rollup/rollup/pull/4952): feat: tree-shake deterministic dynamic imports (@antfu)
+
+## 3.20.7
+
+_2023-04-21_
+
+### Bug Fixes
+
+- Properly track array element mutations when iterating with a for-of loop (#4949)
+- Handle default exporting an anonymous class that extends another class (#4950)
+
+### Pull Requests
+
+- [#4943](https://github.com/rollup/rollup/pull/4943): Add a test for reserved keywords used as import/export specifiers (@Andarist)
+- [#4949](https://github.com/rollup/rollup/pull/4949): Deoptimize right side in for-of loops (@lukastaegert)
+- [#4950](https://github.com/rollup/rollup/pull/4950): Support default exported classes that extend other classes (@lukastaegert)
+
+## 3.20.6
+
+_2023-04-18_
+
+### Bug Fixes
+
+- Revert handling of non-JS import and export names due to regressions (#4914)
+
+### Pull Requests
+
+- [#4914](https://github.com/rollup/rollup/pull/4914): feat: add locales in vitepress config (@iDestin)
+- [#4946](https://github.com/rollup/rollup/pull/4946): Revert #4939 for now (@lukastaegert)
+
+## 3.20.5
+
+_2023-04-18_
+
+### Bug Fixes
+
+- Handle import and export names that are not valid JavaScript identifiers (#4939)
+
+### Pull Requests
+
+- [#4939](https://github.com/rollup/rollup/pull/4939): Fixed imports/exports that are illegal identifiers in the es output (@Andarist)
+- [#4941](https://github.com/rollup/rollup/pull/4941): Reinstate global styles (@lukastaegert)
+
+## 3.20.4
+
+_2023-04-17_
+
+### Bug Fixes
+
+- Do not remove breaks statements after switch statements with conditional breaks (#4937)
+
+### Pull Requests
+
+- [#4937](https://github.com/rollup/rollup/pull/4937): fix: handle conditional breaks in nested switch statement cases (@TrickyPi and @lukastaegert)
+
+## 3.20.3
+
+_2023-04-16_
+
+### Bug Fixes
+
+- Reduce memory consumption for function call parameter analysis (#4938)
+- Fix types for `shouldTransformCachedModule` (#4932)
+
+### Pull Requests
+
+- [#4925](https://github.com/rollup/rollup/pull/4925): chore: repl style add scoped (@btea)
+- [#4926](https://github.com/rollup/rollup/pull/4926): docs: Update the x_google_ignorelist url (@jecfish)
+- [#4932](https://github.com/rollup/rollup/pull/4932): Allow shouldTransformCachedModule to return null (@bluwy)
+- [#4935](https://github.com/rollup/rollup/pull/4935): Bump peter-evans/create-or-update-comment from 2 to 3 (@dependabot[bot])
+- [#4936](https://github.com/rollup/rollup/pull/4936): Disable puppeteer sandbox to fix Vercel deployment (@lukastaegert)
+- [#4938](https://github.com/rollup/rollup/pull/4938): Improve memory usage for parameter deoptimizations (@lukastaegert)
+
 ## 3.20.2
 
 _2023-03-24_

.zhlintignore

@@ -1,6 +1,6 @@
 {
   "name": "@rollup/browser",
-  "version": "3.20.2",
+  "version": "3.21.0",
   "description": "Next-generation ES module bundler browser build",
   "main": "dist/rollup.browser.js",
   "module": "dist/es/rollup.browser.js",

.zhlintrc

@@ -25,6 +25,10 @@ export default defineConfig({
 		['meta', { content: 'The JavaScript module bundler', name: 'twitter:description' }],
 		['meta', { content: 'https://rollupjs.org/twitter-card.jpg', name: 'twitter:image' }]
 	],
+	locales: {
+		root: { label: '简体中文' },
+		zh: { label: 'English', link: 'https://rollupjs.org' }
+	},
 	markdown: {
 		anchor: {
 			callback,
@@ -129,7 +133,6 @@ export default defineConfig({
 	title: 'Rollup 中文文档',
 	transformPageData,
 	vite: {
-		optimizeDeps: { include: ['moment-mini', '@braintree/sanitize-url'] },
 		plugins: [
 			renderMermaidGraphsPlugin(),
 			{

CHANGELOG.md

@@ -1419,7 +1419,7 @@ export default {
 | --: | :-- |
 | 类型： | `boolean \| (relativeSourcePath: string, sourcemapPath: string) => boolean` |
 
-该选项决定是否忽略 sourcemap 中列出的源文件，用于填充 [`x_google_ignoreList` source map 扩展](https://developer.chrome.com/blog/devtools-better-angular-debugging/#the-x_google_ignorelist-source-map-extension)。`relativeSourcePath` 是生成的 `.map` 文件到相应源文件的相对路径，而 `sourcemapPath` 是生成的 sourcemap 文件的绝对路径。
+该选项决定是否忽略 sourcemap 中列出的源文件，用于填充 [`x_google_ignoreList` source map 扩展](https://developer.chrome.com/articles/x-google-ignore-list/)。`relativeSourcePath` 是生成的 `.map` 文件到相应源文件的相对路径，而 `sourcemapPath` 是生成的 sourcemap 文件的绝对路径。
 
 ```js
 import path from 'node:path';

browser/package.json

@@ -564,14 +564,14 @@ type ShouldTransformCachedModuleHook = (options: {
 	meta: { [plugin: string]: any };
 	moduleSideEffects: boolean | 'no-treeshake';
 	syntheticNamedExports: boolean | string;
-}) => boolean;
+}) => boolean | NullValue;
 ```
 
 如果使用 Rollup 缓存（例如在观察模式下或通过 JavaScript API 明确使用），如果在 [`load`](#transform) 钩子之后，加载的 `code` 与缓存副本的代码相同，则 Rollup 将跳过模块的 [`transform`](#transform) 钩子。为了防止这种情况，插件可以实现此钩子并返回 `true`，以丢弃缓存副本并转换模块。
 
 此钩子还可用于查找已缓存的模块并访问其缓存的元信息。
 
-如果插件没有返回 `true`，则 Rollup 将为其他插件触发此钩子，否则所有剩余的插件都将被跳过。
+如果插件没有返回布尔值，则 Rollup 将为其他插件触发此钩子，否则所有剩余的插件都将被跳过。
 
 ### transform