respec 35.1.1 → 35.2.0

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "respec",
-  "version": "35.1.1",
+  "version": "35.2.0",
   "license": "W3C",
   "description": "A technical specification pre-processor.",
   "engines": {
     "node": ">=20.12.1"
   },
-  "packageManager": "pnpm@9.0.6",
+  "packageManager": "pnpm@9.14.2",
   "bin": {
     "respec": "tools/respec2html.js",
     "respec2html": "tools/respec2html.js"
@@ -24,26 +24,26 @@
     "Robin Berjon"
   ],
   "devDependencies": {
-    "@rollup/plugin-alias": "^5.1.0",
-    "@rollup/plugin-commonjs": "^25.0.8",
-    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-commonjs": "^28.0.1",
+    "@rollup/plugin-node-resolve": "^15.3.0",
     "@rollup/plugin-terser": "^0.4.4",
     "@types/pluralize": "0.0.33",
-    "boxen": "^7.1.1",
-    "chokidar": "^3.6.0",
+    "boxen": "^8.0.1",
+    "chokidar": "^4.0.1",
     "clean-css": "^5.3.3",
     "epipebomb": "^1.0.0",
     "eslint": "^8.57.0",
     "eslint-config-prettier": "^9.1.0",
-    "eslint-plugin-import": "^2.29.1",
-    "eslint-plugin-jasmine": "^4.1.3",
-    "eslint-plugin-prettier": "^5.1.3",
-    "highlight.js": "^11.9.0",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jasmine": "^4.2.2",
+    "eslint-plugin-prettier": "^5.2.1",
+    "highlight.js": "^11.10.0",
     "hyperhtml": "^2.34.2",
     "idb": "^8.0.0",
-    "jasmine": "^5.1.0",
-    "jasmine-core": "^5.1.2",
-    "karma": "^6.4.3",
+    "jasmine": "^5.4.0",
+    "jasmine-core": "^5.4.0",
+    "karma": "^6.4.4",
     "karma-chrome-launcher": "^3.2.0",
     "karma-firefox-launcher": "^2.1.3",
     "karma-jasmine": "^5.1.0",
@@ -52,15 +52,15 @@
     "karma-safari-launcher": "^1.0.0",
     "loading-indicator": "^2.0.0",
     "pluralize": "^8.0.0",
-    "prettier": "^3.3.0",
+    "prettier": "^3.4.0",
     "prompt": "^1.3.0",
-    "rollup": "^4.18.0",
+    "rollup": "^4.27.4",
     "rollup-plugin-minify-html-literals": "^1.2.6",
-    "serve": "^14.2.3",
-    "serve-handler": "^6.1.5",
+    "serve": "^14.2.4",
+    "serve-handler": "^6.1.6",
     "sniffy-mimetype": "^1.1.1",
-    "typescript": "^5.4.5",
-    "vnu-jar": "^23.4.11",
+    "typescript": "^5.7.2",
+    "vnu-jar": "^24.10.17",
     "webidl2": "^24.4.1"
   },
   "scripts": {
@@ -87,11 +87,11 @@
   },
   "dependencies": {
     "colors": "1.4.0",
-    "finalhandler": "^1.2.0",
+    "finalhandler": "^1.3.1",
     "marked": "^12.0.2",
-    "puppeteer": "^22.10.0",
+    "puppeteer": "^23.9.0",
     "sade": "^1.8.1",
-    "serve-static": "^1.15.0"
+    "serve-static": "^1.16.2"
   },
   "files": [
     "builds/",

package/tools/respec2html.js

@@ -90,15 +90,32 @@ class Logger {
 
   /** @param {import("./respecDocWriter").ReSpecError} rsError */
   _printDetails(rsError) {
+    const shouldPrintStacktrace = this._shouldPrintStacktrace(rsError);
     const print = (title, value) => {
       if (!value) return;
-      const padWidth = "Plugin".length + 1; // "Plugin" is the longest title
+      const longestTitle = shouldPrintStacktrace ? "Stacktrace" : "Plugin";
+      const padWidth = longestTitle.length + 1;
       const paddedTitle = `${title}:`.padStart(padWidth);
       console.error(" ", colors.bold(paddedTitle), this._formatMarkdown(value));
     };
     print("Count", rsError.elements && String(rsError.elements.length));
     print("Plugin", rsError.plugin);
     print("Hint", rsError.hint);
+    if (shouldPrintStacktrace) {
+      let stacktrace = `${rsError.stack}`;
+      if (rsError.cause) {
+        stacktrace += `\n    ${colors.bold("Caused by:")} ${rsError.cause.stack.split("\n").join("\n   ")}`;
+      }
+      print("Stacktrace", stacktrace);
+    }
+  }
+
+  _shouldPrintStacktrace(rsError) {
+    return (
+      this.verbose &&
+      !!rsError.stack &&
+      (!!rsError.cause?.stack || rsError.plugin === "unknown")
+    );
   }
 }
 

package/tools/respecDocWriter.js

@@ -309,6 +309,25 @@ function handleConsoleMessages(page, onError, onWarning) {
       if (typeof obj === "string") {
         // Old ReSpec versions might report errors as strings.
         return JSON.stringify({ message: String(obj) });
+      } else if (obj instanceof Error && !obj.plugin) {
+        let cause;
+        if (obj.cause instanceof Error) {
+          cause = {
+            name: obj.cause.name,
+            message: obj.cause.message,
+            stack: obj.cause.stack,
+          };
+        }
+        return JSON.stringify({
+          message: obj.message,
+          plugin: "unknown",
+          name: obj.name,
+          cause,
+          stack: obj.stack?.replace(
+            obj.message,
+            `${obj.message.slice(0, 30)}…`
+          ),
+        });
       } else {
         // Ideally: `obj instanceof RsError` and `RsError instanceof Error`.
         return JSON.stringify(obj);
@@ -335,6 +354,7 @@ function handleConsoleMessages(page, onError, onWarning) {
     switch (type) {
       case "error":
         return onError(JSON.parse(text));
+      case "warn":
       case "warning":
         return onWarning(JSON.parse(text));
     }