Merge branch 'main' into print-helpful-error-in-worst-case

Author: mark-wiemer

.github/release-please/config.json

@@ -3,9 +3,6 @@
   "release-type": "node",
   "include-component-in-tag": false,
 
-  "prerelease": true,
-  "versioning": "prerelease",
-
   "changelog-sections": [
     { "type": "feat", "section": "🌟 Features", "hidden": false },
     { "type": "fix", "section": "🩹 Fixes", "hidden": false },

.github/release-please/manifest.json

@@ -1 +1 @@
-{".":"11.2.2"}
+{".":"11.6.0"}

.github/workflows/nightly-site-deploy.yml

@@ -1,5 +1,6 @@
 # Deploy `mochajs.org` branch nightly by hitting a netlify build URL.
 # This updates the list of supporters
+# It uses commands from netlify.toml at root of repo
 
 name: Nightly mochajs.org Deploy
 

.github/workflows/release-please.yml

@@ -45,6 +45,6 @@ jobs:
       - name: Install dependencies
         run: npm ci --ignore-scripts --force --no-fund --no-audit
 
-      - run: npm publish --provenance --access public --tag=next
+      - run: npm publish --provenance --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## [11.6.0](https://github.com/mochajs/mocha/compare/v11.5.0...v11.6.0) (2025-06-09)
+
+
+### 🌟 Features
+
+* bump workerpool from ^6.5.1 to ^9.2.0 ([#5350](https://github.com/mochajs/mocha/issues/5350)) ([581a3c5](https://github.com/mochajs/mocha/commit/581a3c554489855ac02860689d3f4ae772c2ea79))
+
+## [11.5.0](https://github.com/mochajs/mocha/compare/v11.4.0...v11.5.0) (2025-05-22)
+
+
+### 🌟 Features
+
+* bump mimimatch from ^5.1.6 to ^9.0.5 ([#5349](https://github.com/mochajs/mocha/issues/5349)) ([a3dea85](https://github.com/mochajs/mocha/commit/a3dea85b316e229ea95f51c715ad61708e9ab9a3))
+
+## [11.4.0](https://github.com/mochajs/mocha/compare/v11.3.0...v11.4.0) (2025-05-19)
+
+
+### 🌟 Features
+
+* bump diff from ^5.2.0 to ^7.0.0 ([#5348](https://github.com/mochajs/mocha/issues/5348)) ([554d6bb](https://github.com/mochajs/mocha/commit/554d6bbec92c3c938af0a533109749b6f3b7bd2c))
+
+
+### 📚 Documentation
+
+* added CHANGELOG.md note around 11.1 yargs-parser update ([#5362](https://github.com/mochajs/mocha/issues/5362)) ([618415d](https://github.com/mochajs/mocha/commit/618415d9c6fa3ef4e959207c8dd404f4703de7a7))
+
+## [11.3.0](https://github.com/mochajs/mocha/compare/v11.2.2...v11.3.0) (2025-05-16)
+
+
+### 🌟 Features
+
+* add option to use posix exit code upon fatal signal ([#4989](https://github.com/mochajs/mocha/issues/4989)) ([91bbf85](https://github.com/mochajs/mocha/commit/91bbf855012ee9b83700d3c563b517483de0831c))
+
+
+### 📚 Documentation
+
+* Deploy new site alongside old one ([#5360](https://github.com/mochajs/mocha/issues/5360)) ([6c96545](https://github.com/mochajs/mocha/commit/6c96545aee03efeee78c55feedcf70664426514c))
+* mention explicit browser support range ([#5354](https://github.com/mochajs/mocha/issues/5354)) ([c514c0b](https://github.com/mochajs/mocha/commit/c514c0bfad044f8450a63b2f9c6c781b9ce6f164))
+* update Node.js version requirements for 11.x ([#5329](https://github.com/mochajs/mocha/issues/5329)) ([abf3dd9](https://github.com/mochajs/mocha/commit/abf3dd921544b45c4c09eef8f7c9c3c4481a3d66))
+
+
+### 🧹 Chores
+
+* remove prerelease setting in release-please config ([#5363](https://github.com/mochajs/mocha/issues/5363)) ([8878f22](https://github.com/mochajs/mocha/commit/8878f222c418a0bf4fe170c17573c30b5ea2d567))
+
 ## [11.2.2](https://github.com/mochajs/mocha/compare/v11.2.1...v11.2.2) (2025-04-10)
 
 
@@ -58,6 +103,8 @@
 ### 🌟 Features
 
 * bump yargs to 17 ([#5165](https://github.com/mochajs/mocha/issues/5165)) ([8f1c8d8](https://github.com/mochajs/mocha/commit/8f1c8d888b0104afcd95ca55a517320399755749))
+  * Note that this also included a version bump of [`yargs-parser`](http://npmjs.com/package/yargs-parser) from `^20.2.9` to `^21.1.`, which fixed a bug that caused extra quotes in file paths to be removed.
+    See [#5341](https://github.com/mochajs/mocha/issues/5341) for more information.
 * replace `strip-ansi` with `util.stripVTControlCharacters` ([#5267](https://github.com/mochajs/mocha/issues/5267)) ([3c191c0](https://github.com/mochajs/mocha/commit/3c191c05d9db1e99aec9b600edac2ce10a6b6d71)), closes [#5265](https://github.com/mochajs/mocha/issues/5265)
 
 ## [11.0.2](https://github.com/mochajs/mocha/compare/v11.0.1...v11.0.2) (2024-12-09)

bin/mocha.js

@@ -10,6 +10,7 @@
  * @private
  */
 
+const os = require('node:os');
 const {loadOptions} = require('../lib/cli/options');
 const {
   unparseNodeFlags,
@@ -22,6 +23,7 @@ const {aliases} = require('../lib/cli/run-option-metadata');
 
 const mochaArgs = {};
 const nodeArgs = {};
+const SIGNAL_OFFSET = 128;
 let hasInspect = false;
 
 const opts = loadOptions(process.argv.slice(2));
@@ -109,9 +111,13 @@ if (mochaArgs['node-option'] || Object.keys(nodeArgs).length || hasInspect) {
   proc.on('exit', (code, signal) => {
     process.on('exit', () => {
       if (signal) {
+        signal = typeof signal === 'string' ? os.constants.signals[signal] : signal;
+        if (mochaArgs['posix-exit-codes'] === true) {
+          process.exitCode = SIGNAL_OFFSET + signal;
+        }
         process.kill(process.pid, signal);
       } else {
-        process.exit(code);
+        process.exit(Math.min(code, mochaArgs['posix-exit-codes'] ? 1 : 255));
       }
     });
   });
@@ -126,7 +132,7 @@ if (mochaArgs['node-option'] || Object.keys(nodeArgs).length || hasInspect) {
     // be needed.
     if (!args.parallel || args.jobs < 2) {
       // win32 does not support SIGTERM, so use next best thing.
-      if (require('node:os').platform() === 'win32') {
+      if (os.platform() === 'win32') {
         proc.kill('SIGKILL');
       } else {
         // using SIGKILL won't cleanly close the output streams, which can result

docs-next/README.md

@@ -7,3 +7,19 @@ npm i
 npm run generate
 npm run dev
 ```
+
+To merge with the old site:
+
+```shell
+npm i
+npm run build-with-old
+```
+
+To preview the old and new site:
+
+```shell
+cd .. # back to root dir
+npm run docs:preview
+```
+
+The new site will be at `http://localhost:8080/next`

docs-next/astro.config.ts

@@ -2,9 +2,7 @@ import { defineConfig } from "astro/config";
 import starlight from "@astrojs/starlight";
 
 export default defineConfig({
-  // For now, this is only being deployed to mocha-docs-next.netlify.app.
-  // Soon we'll move it onto mochajs.org/next.
-  ...(!process.env.NETLIFY_BUILD_BASE && { base: "/next" }),
+  base: "/next",
   integrations: [
     starlight({
       components: {

docs-next/package.json

@@ -9,6 +9,7 @@
     "docs": "cd .. && npm i && cd docs-next && npm run generate && npm run build",
     "build": "astro check && astro build",
     "preview": "astro preview",
+    "build-with-old": "npm run generate && npm run build -- --outDir ../docs/_site/next",
     "astro": "astro"
   },
   "dependencies": {

docs-next/src/content/docs/running/browsers.mdx

@@ -37,6 +37,14 @@ A typical setup might look something like the following, where we call `mocha.se
 </html>
 ```
 
+Mocha supports the latest major versions of evergreen browsers available when Mocha's oldest supported Node.js major version was released.
+As of Mocha v11.0.0, that includes the following browser versions that were stable as of [Node.js 18.10.0](https://nodejs.org/en/blog/release/v18.0.0)'s release on April 19, 2022:
+
+- [Chrome 100](https://developer.chrome.com/blog/new-in-chrome-100)
+- [Edge 100](https://learn.microsoft.com/en-us/deployedge/microsoft-edge-relnote-archive-stable-channel#version-1000118544-april-15)
+- [Firefox 99](https://www.mozilla.org/en-US/firefox/99.0/releasenotes)
+- [Safari 15.4](https://developer.apple.com/documentation/safari-release-notes/safari-15_4-release-notes)
+
 ## Grep
 
 The browser may use the `--grep` as functionality.