Override webpackbar to v7 and add notice

Temporarily add an overrides entry to package.json to force webpackbar ^7 for @docusaurus/bundler and add a postinstall script that prints a notice when @docusaurus/bundler declares webpackbar v7+, so the override can be removed. Update package.json (scripts, spelling) and package-lock.json accordingly. This is a short-term workaround for facebook/docusaurus#11923.

Signed-off-by: Patrice Chalin <pchalin@gmail.com>

Author: chalin

package-lock.json

@@ -37,6 +37,7 @@
     "docusaurus": "docusaurus",
     "fix:format": "npm run _check:format -- --write",
     "fix": "npm run seq -- $(npm -s run _list:fix:*)",
+    "postinstall": "node scripts/postinstall-webpackbar-notice.mjs",
     "precheck:links": "npm run build",
     "seq": "bash -c 'for cmd in \"$@\"; do npm run $cmd || exit 1; done' - ",
     "serve": "npm run docus:serve",
@@ -67,8 +68,14 @@
     "prettier": "^3.8.3",
     "typescript": "~6.0.2"
   },
+  "//": "TEMP overrides (webpackbar): remove after @docusaurus/* ships webpackbar ^7 — https://github.com/facebook/docusaurus/issues/11923",
+  "overrides": {
+    "@docusaurus/bundler": {
+      "webpackbar": "^7.0.0"
+    }
+  },
   "private": true,
-  "spelling": "cSpell:ignore ACMR docus HTMLTEST loglevel -",
+  "spelling": "cSpell:ignore ACMR docus HTMLTEST loglevel webpackbar -",
   "prettier": {
     "proseWrap": "always",
     "singleQuote": true

package.json

@@ -0,0 +1,39 @@
+/**
+ * After install: if @docusaurus/bundler declares webpackbar ^7+, print that our
+ * temporary package.json overrides can be removed. Otherwise stay silent.
+ * @see https://github.com/facebook/docusaurus/issues/11923
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const root = path.join(__dirname, '..');
+const bundlerPkgPath = path.join(
+  root,
+  'node_modules/@docusaurus/bundler/package.json',
+);
+
+function bundlerDeclaresWebpackbarV7Plus(range) {
+  if (!range || typeof range !== 'string') return false;
+  const m = range.match(/^[~^]?(\d+)/) || range.match(/>=\s*(\d+)/);
+  return m ? Number(m[1]) >= 7 : false;
+}
+
+let range = '';
+try {
+  const pkg = JSON.parse(fs.readFileSync(bundlerPkgPath, 'utf8'));
+  range = pkg.dependencies?.webpackbar ?? '';
+} catch {
+  process.exit(0);
+}
+
+if (!bundlerDeclaresWebpackbarV7Plus(range)) {
+  process.exit(0);
+}
+
+const tag = '[techdocs] Docusaurus / webpackbar';
+console.log(
+  `${tag}: @docusaurus/bundler now declares webpackbar ${range}. Remove the temporary "overrides" block and the "//" comment from package.json, then run npm install.`,
+);
+console.log('  https://github.com/facebook/docusaurus/issues/11923');