withastro · Jun 11, 2024 · Jun 11, 2024 · Jun 11, 2024 · Jun 11, 2024 · Jun 11, 2024
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -12,10 +12,12 @@ We welcome contributions of any size and skill level. As an open source project,
 
 ```shell
 node: "^>=18.17.1"
-pnpm: "^8.6.12"
+pnpm: "^9.3.0"
 # otherwise, your build will fail
 ```
 
+We recommend using Corepack, [read PNPM docs](https://pnpm.io/installation#using-corepack).
+
 ### Setting up your local repo
 
 Astro uses pnpm workspaces, so you should **always run `pnpm install` from the top-level project directory**. Running `pnpm install` in the top-level project root will install dependencies for `astro`, and every package in the repo.
@@ -109,6 +111,53 @@ pnpm run test -m "$STRING_MATCH"
 node --test ./test/foo.test.js
 ```
 
+#### Running a single test
+
+Sometimes you want to run a single test case (`it` or `describe`) or a single test file. You can do so by using Node.js.
+
+To run a single test file, for example `test/astro-basic.test.js`:
+
+```shell
+node --test test/astro-basic.test.js
+```
+
+If you wish to run a single test case, you have to postfix `it` and `describe` functions with `.only`:
+
+```diff
+// test/astro-basic.test.js
+- describe("description", () => {
++ describe.only("description", () => {
+-  it("description", () => {
++  it.only("description", () => {})
+})
+```
+
+Then, you have to pass the `--test-only` option to the Node.js:
+
+```shell
+node --test --test-only test/astro-basic.test.js
+```
+
+> [!WARNING]
+>
+> 1. If you have nested `describe`, all of them must postfix with `.only`
+> 2. `--test-only` and `--test` must be placed **before** declaring the path to the file. Failing to do so will test all files
+
+#### Debugging tests in CI
+
+There might be occasions where some tests fail in certain CI runs due to some timeout issue. If this happens, it will be very difficult to understand which file cause the timeout. That's caused by come quirks of the Node.js test runner combined with our architecture.
+
+To understand which file causes the issue, you can modify the `test` script inside the `package.json` by adding the `--parallel` option:
+
+```diff
+{
+-  "test": "astro-scripts test \"test/**/*.test.js\"",
++  "test": "astro-scripts test --parallel \"test/**/*.test.js\"",
+}
+```
+
+Save the change and **push it** to your PR. This change will make the test CI slower, but it will allow to see which files causes the timeout. Once you fixed the issue **revert the change and push it**.
+
 #### E2E tests
 
 Certain features, like HMR and client hydration, need end-to-end tests to verify functionality in the dev server. [Playwright](https://playwright.dev/) is used to test against the dev server.
@@ -127,6 +176,12 @@ Any tests for `astro build` output should use the main `mocha` tests rather than
 
 If a test needs to validate what happens on the page after it's loading in the browser, that's a perfect use for E2E dev server tests, i.e. to verify that hot-module reloading works in `astro dev` or that components were client hydrated and are interactive.
 
+#### Creating tests
+
+When creating new tests, it's best to reference other existing test files and replicate the same setup. Some other tips include:
+
+- When re-using a fixture multiple times with different configurations, you should also configure unique `outDir`, `build.client`, and `build.server` values so the build output runtime isn't cached and shared by ESM between test runs.
+
 ### Other useful commands
 
 ```shell

diff --git a/README.md b/README.md
@@ -10,7 +10,7 @@
 
 <div align="center">
 
-![Build Status](https://github.com/withastro/astro/actions/workflows/ci.yml/badge.svg)
+[![CI](https://github.com/withastro/astro/actions/workflows/ci.yml/badge.svg)](https://github.com/withastro/astro/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/withastro/astro/blob/main/LICENSE)
 [![npm version](https://badge.fury.io/js/astro.svg)](https://badge.fury.io/js/astro)
 

diff --git a/examples/basics/package.json b/examples/basics/package.json
@@ -11,6 +11,6 @@
     "astro": "astro"
   },
   "dependencies": {
-    "astro": "^4.10.2"
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/blog/package.json b/examples/blog/package.json
@@ -11,9 +11,9 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/mdx": "^3.1.0",
+    "@astrojs/mdx": "^3.1.1",
     "@astrojs/rss": "^4.0.6",
-    "@astrojs/sitemap": "^3.1.5",
-    "astro": "^4.10.2"
+    "@astrojs/sitemap": "^3.1.6",
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/component/package.json b/examples/component/package.json
@@ -15,7 +15,7 @@
   ],
   "scripts": {},
   "devDependencies": {
-    "astro": "^4.10.2"
+    "astro": "^4.10.3"
   },
   "peerDependencies": {
     "astro": "^4.0.0"

diff --git a/examples/container-with-vitest/package.json b/examples/container-with-vitest/package.json
@@ -12,8 +12,8 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "astro": "^4.10.2",
-    "@astrojs/react": "^3.5.0",
+    "astro": "^4.10.3",
+    "@astrojs/react": "^3.6.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "vitest": "^1.6.0"

diff --git a/examples/framework-alpine/package.json b/examples/framework-alpine/package.json
@@ -14,6 +14,6 @@
     "@astrojs/alpinejs": "^0.4.0",
     "@types/alpinejs": "^3.13.10",
     "alpinejs": "^3.14.0",
-    "astro": "^4.10.2"
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/framework-lit/package.json b/examples/framework-lit/package.json
@@ -11,9 +11,9 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/lit": "^4.2.0",
+    "@astrojs/lit": "^4.3.0",
     "@webcomponents/template-shadowroot": "^0.2.1",
-    "astro": "^4.10.2",
+    "astro": "^4.10.3",
     "lit": "^3.1.4"
   }
 }
diff --git a/examples/framework-multiple/package.json b/examples/framework-multiple/package.json
@@ -11,19 +11,19 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/preact": "^3.4.0",
-    "@astrojs/react": "^3.5.0",
-    "@astrojs/solid-js": "^4.3.0",
-    "@astrojs/svelte": "^5.5.0",
-    "@astrojs/vue": "^4.4.0",
+    "@astrojs/preact": "^3.5.0",
+    "@astrojs/react": "^3.6.0",
+    "@astrojs/solid-js": "^4.4.0",
+    "@astrojs/svelte": "^5.6.0",
+    "@astrojs/vue": "^4.5.0",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
-    "astro": "^4.10.2",
+    "astro": "^4.10.3",
     "preact": "^10.22.0",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "solid-js": "^1.8.17",
     "svelte": "^4.2.18",
-    "vue": "^3.4.27"
+    "vue": "^3.4.29"
   }
 }
diff --git a/examples/framework-preact/package.json b/examples/framework-preact/package.json
@@ -11,9 +11,9 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/preact": "^3.4.0",
+    "@astrojs/preact": "^3.5.0",
     "@preact/signals": "^1.2.3",
-    "astro": "^4.10.2",
+    "astro": "^4.10.3",
     "preact": "^10.22.0"
   }
 }
diff --git a/examples/framework-react/package.json b/examples/framework-react/package.json
@@ -11,10 +11,10 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/react": "^3.5.0",
+    "@astrojs/react": "^3.6.0",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
-    "astro": "^4.10.2",
+    "astro": "^4.10.3",
     "react": "^18.3.1",
     "react-dom": "^18.3.1"
   }

diff --git a/examples/framework-solid/package.json b/examples/framework-solid/package.json
@@ -11,8 +11,8 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/solid-js": "^4.3.0",
-    "astro": "^4.10.2",
+    "@astrojs/solid-js": "^4.4.0",
+    "astro": "^4.10.3",
     "solid-js": "^1.8.17"
   }
 }
diff --git a/examples/framework-svelte/package.json b/examples/framework-svelte/package.json
@@ -11,8 +11,8 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/svelte": "^5.5.0",
-    "astro": "^4.10.2",
+    "@astrojs/svelte": "^5.6.0",
+    "astro": "^4.10.3",
     "svelte": "^4.2.18"
   }
 }
diff --git a/examples/framework-vue/package.json b/examples/framework-vue/package.json
@@ -11,8 +11,8 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/vue": "^4.4.0",
-    "astro": "^4.10.2",
-    "vue": "^3.4.27"
+    "@astrojs/vue": "^4.5.0",
+    "astro": "^4.10.3",
+    "vue": "^3.4.29"
   }
 }
diff --git a/examples/hackernews/package.json b/examples/hackernews/package.json
@@ -11,7 +11,7 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/node": "^8.3.0",
-    "astro": "^4.10.2"
+    "@astrojs/node": "^8.3.1",
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/integration/package.json b/examples/integration/package.json
@@ -15,7 +15,7 @@
   ],
   "scripts": {},
   "devDependencies": {
-    "astro": "^4.10.2"
+    "astro": "^4.10.3"
   },
   "peerDependencies": {
     "astro": "^4.0.0"

diff --git a/examples/middleware/package.json b/examples/middleware/package.json
@@ -12,8 +12,8 @@
     "server": "node dist/server/entry.mjs"
   },
   "dependencies": {
-    "@astrojs/node": "^8.3.0",
-    "astro": "^4.10.2",
+    "@astrojs/node": "^8.3.1",
+    "astro": "^4.10.3",
     "html-minifier": "^4.0.0"
   },
   "devDependencies": {

diff --git a/examples/minimal/package.json b/examples/minimal/package.json
@@ -11,6 +11,6 @@
     "astro": "astro"
   },
   "dependencies": {
-    "astro": "^4.10.2"
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/non-html-pages/package.json b/examples/non-html-pages/package.json
@@ -11,6 +11,6 @@
     "astro": "astro"
   },
   "dependencies": {
-    "astro": "^4.10.2"
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/portfolio/package.json b/examples/portfolio/package.json
@@ -11,6 +11,6 @@
     "astro": "astro"
   },
   "dependencies": {
-    "astro": "^4.10.2"
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/ssr/package.json b/examples/ssr/package.json
@@ -12,9 +12,9 @@
     "server": "node dist/server/entry.mjs"
   },
   "dependencies": {
-    "@astrojs/node": "^8.3.0",
-    "@astrojs/svelte": "^5.5.0",
-    "astro": "^4.10.2",
+    "@astrojs/node": "^8.3.1",
+    "@astrojs/svelte": "^5.6.0",
+    "astro": "^4.10.3",
     "svelte": "^4.2.18"
   }
 }
diff --git a/examples/starlog/package.json b/examples/starlog/package.json
@@ -10,8 +10,8 @@
     "astro": "astro"
   },
   "dependencies": {
-    "astro": "^4.10.2",
-    "sass": "^1.77.4",
+    "astro": "^4.10.3",
+    "sass": "^1.77.5",
     "sharp": "^0.33.3"
   }
 }
diff --git a/examples/toolbar-app/package.json b/examples/toolbar-app/package.json
@@ -15,6 +15,6 @@
     "./app": "./dist/app.js"
   },
   "devDependencies": {
-    "astro": "^4.10.2"
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/view-transitions/package.json b/examples/view-transitions/package.json
@@ -11,7 +11,7 @@
   },
   "devDependencies": {
     "@astrojs/tailwind": "^5.1.0",
-    "@astrojs/node": "^8.3.0",
-    "astro": "^4.10.2"
+    "@astrojs/node": "^8.3.1",
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/with-markdoc/package.json b/examples/with-markdoc/package.json
@@ -12,6 +12,6 @@
   },
   "dependencies": {
     "@astrojs/markdoc": "^0.11.0",
-    "astro": "^4.10.2"
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/with-markdown-plugins/package.json b/examples/with-markdown-plugins/package.json
@@ -12,7 +12,7 @@
   },
   "dependencies": {
     "@astrojs/markdown-remark": "^5.1.0",
-    "astro": "^4.10.2",
+    "astro": "^4.10.3",
     "hast-util-select": "^6.0.2",
     "rehype-autolink-headings": "^7.1.0",
     "rehype-slug": "^6.0.0",

diff --git a/examples/with-markdown-shiki/package.json b/examples/with-markdown-shiki/package.json
@@ -11,6 +11,6 @@
     "astro": "astro"
   },
   "dependencies": {
-    "astro": "^4.10.2"
+    "astro": "^4.10.3"
   }
 }
diff --git a/examples/with-mdx/package.json b/examples/with-mdx/package.json
@@ -11,9 +11,9 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/mdx": "^3.1.0",
-    "@astrojs/preact": "^3.4.0",
-    "astro": "^4.10.2",
+    "@astrojs/mdx": "^3.1.1",
+    "@astrojs/preact": "^3.5.0",
+    "astro": "^4.10.3",
     "preact": "^10.22.0"
   }
 }
diff --git a/examples/with-nanostores/package.json b/examples/with-nanostores/package.json
@@ -11,9 +11,9 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/preact": "^3.4.0",
+    "@astrojs/preact": "^3.5.0",
     "@nanostores/preact": "^0.5.1",
-    "astro": "^4.10.2",
+    "astro": "^4.10.3",
     "nanostores": "^0.10.3",
     "preact": "^10.22.0"
   }

diff --git a/examples/with-tailwindcss/package.json b/examples/with-tailwindcss/package.json
@@ -11,10 +11,10 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/mdx": "^3.1.0",
+    "@astrojs/mdx": "^3.1.1",
     "@astrojs/tailwind": "^5.1.0",
     "@types/canvas-confetti": "^1.6.4",
-    "astro": "^4.10.2",
+    "astro": "^4.10.3",
     "autoprefixer": "^10.4.19",
     "canvas-confetti": "^1.9.3",
     "postcss": "^8.4.38",