chore(deps): update supported engines; upgrade yargs-parser

Node.js 18 is EOL, and yargs-parser requires recent versions of Node.js 20 and 22.
2025-12-08 19:46:11 +00:00 · 2025-05-30 21:51:32 -07:00 · 2025-05-30 21:51:32 -07:00 · ee53851057
commit ee53851057
parent 68d5ee6a96
17 changed files with 46 additions and 36 deletions
--- a/.github/workflows/ci.yaml
+++ b/.github/workflows/ci.yaml
@ -24,7 +24,7 @@ jobs:
    strategy:
      matrix:
        os: [ubuntu-latest]
-        node: [20]
+        node: ['20']
    steps:
      - uses: actions/checkout@v4
        with:
@ -42,7 +42,7 @@ jobs:
    strategy:
      matrix:
        os: [ubuntu-latest]
-        node: [20]
+        node: ['20']
    steps:
      - uses: actions/checkout@v4
        with:
@ -60,7 +60,7 @@ jobs:
    strategy:
      matrix:
        os: [ubuntu-latest]
-        node: [18, 20]
+        node: ['20.19.0', '22.12.0', '24']
    steps:
      - uses: actions/checkout@v4
        with:
--- a/package-lock.json
+++ b/package-lock.json
@ -55,7 +55,7 @@
        "prettier": "^3.5.3"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "node_modules/@aashutoshrathi/word-wrap": {
@ -6187,6 +6187,7 @@
      "version": "21.1.1",
      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-21.1.1.tgz",
      "integrity": "sha512-tVpsJW7DdjecAiFpbIB1e3qxIQsE6NoPc5/eTdrbbIC4h0LVsWhnoa3g+m2HclBIujHzsxZ4VJVA+GUuc2/LBw==",
+      "dev": true,
      "engines": {
        "node": ">=12"
      }
@ -6234,7 +6235,7 @@
        "jsdoc": "jsdoc.js"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-ast": {
@ -6249,7 +6250,7 @@
        "lodash": "^4.17.21"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-cli": {
@ -6262,10 +6263,19 @@
        "lodash": "^4.17.21",
        "ow": "^2.0.0",
        "strip-bom": "^5.0.0",
-        "yargs-parser": "^21.1.1"
+        "yargs-parser": "^22.0.0"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
+      }
+    },
+    "packages/jsdoc-cli/node_modules/yargs-parser": {
+      "version": "22.0.0",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-22.0.0.tgz",
+      "integrity": "sha512-rwu/ClNdSMpkSrUb+d6BRsSkLUq1fmfsY6TOpYzTwvwkg1/NRG85KBy3kq++A8LKQwX6lsu+aWad+2khvuXrqw==",
+      "license": "ISC",
+      "engines": {
+        "node": "^20.19.0 || ^22.12.0 || >=23"
      }
    },
    "packages/jsdoc-core": {
@ -6283,7 +6293,7 @@
        "strip-json-comments": "^5.0.2"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-doclet": {
@ -6300,7 +6310,7 @@
        "strip-bom": "^5.0.0"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-eslint-config": {
@ -6315,7 +6325,7 @@
        "globals": "^16.2.0"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      },
      "peerDependencies": {
        "eslint": "^9.28.0",
@ -6343,7 +6353,7 @@
        "lodash": "^4.17.21"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-parse": {
@ -6358,7 +6368,7 @@
        "escape-string-regexp": "^5.0.0"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-plugins": {
@ -6373,7 +6383,7 @@
        "@jsdoc/parse": "^0.3.13"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-prettier-config": {
@ -6411,7 +6421,7 @@
        "memize": "^2.1.0"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-task-runner": {
@ -6425,7 +6435,7 @@
        "p-queue": "^8.1.0"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-template-legacy": {
@ -6448,7 +6458,7 @@
        "markdown-it-anchor": "^9.2.0"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-test-matchers": {
@ -6459,7 +6469,7 @@
        "lodash": "^4.17.21"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    },
    "packages/jsdoc-util": {
@ -6471,7 +6481,7 @@
        "ow": "^2.0.0"
      },
      "engines": {
-        "node": ">=v18.12.0"
+        "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
      }
    }
  }
--- a/package.json
+++ b/package.json
@ -34,7 +34,7 @@
  },
  "type": "module",
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  },
  "scripts": {
    "coverage": "node_modules/.bin/hereby coverage",
--- a/packages/jsdoc-ast/package.json
+++ b/packages/jsdoc-ast/package.json
@ -38,6 +38,6 @@
    "lodash": "^4.17.21"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  }
 }
--- a/packages/jsdoc-cli/package.json
+++ b/packages/jsdoc-cli/package.json
@ -36,10 +36,10 @@
    "lodash": "^4.17.21",
    "ow": "^2.0.0",
    "strip-bom": "^5.0.0",
-    "yargs-parser": "^21.1.1"
+    "yargs-parser": "^22.0.0"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  },
  "gitHead": "a595f7f2a525f32da9a0498a027667af3d938158"
 }
--- a/packages/jsdoc-core/package.json
+++ b/packages/jsdoc-core/package.json
@ -41,7 +41,7 @@
    "strip-json-comments": "^5.0.2"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  },
  "gitHead": "a595f7f2a525f32da9a0498a027667af3d938158"
 }
--- a/packages/jsdoc-doclet/package.json
+++ b/packages/jsdoc-doclet/package.json
@ -40,6 +40,6 @@
    "strip-bom": "^5.0.0"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  }
 }
--- a/packages/jsdoc-eslint-config/package.json
+++ b/packages/jsdoc-eslint-config/package.json
@ -41,7 +41,7 @@
    }
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  },
  "gitHead": "81a824eb0968851f836fc6069376d0337775f9ba"
 }
--- a/packages/jsdoc-name/package.json
+++ b/packages/jsdoc-name/package.json
@ -35,7 +35,7 @@
    "lodash": "^4.17.21"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  },
  "gitHead": "a595f7f2a525f32da9a0498a027667af3d938158"
 }
--- a/packages/jsdoc-parse/package.json
+++ b/packages/jsdoc-parse/package.json
@ -20,7 +20,7 @@
    "escape-string-regexp": "^5.0.0"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  },
  "repository": {
    "type": "git",
--- a/packages/jsdoc-plugins/package.json
+++ b/packages/jsdoc-plugins/package.json
@ -28,7 +28,7 @@
    }
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  },
  "devDependencies": {
    "@jsdoc/core": "^0.5.10",
--- a/packages/jsdoc-tag/package.json
+++ b/packages/jsdoc-tag/package.json
@ -43,6 +43,6 @@
    "memize": "^2.1.0"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  }
 }
--- a/packages/jsdoc-task-runner/package.json
+++ b/packages/jsdoc-task-runner/package.json
@ -38,6 +38,6 @@
    "p-queue": "^8.1.0"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  }
 }
--- a/packages/jsdoc-template-legacy/package.json
+++ b/packages/jsdoc-template-legacy/package.json
@ -28,7 +28,7 @@
    "markdown-it-anchor": "^9.2.0"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  },
  "repository": {
    "type": "git",
--- a/packages/jsdoc-test-matchers/package.json
+++ b/packages/jsdoc-test-matchers/package.json
@ -29,6 +29,6 @@
    "lodash": "^4.17.21"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  }
 }
--- a/packages/jsdoc-util/package.json
+++ b/packages/jsdoc-util/package.json
@ -35,7 +35,7 @@
    "ow": "^2.0.0"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  },
  "gitHead": "a595f7f2a525f32da9a0498a027667af3d938158"
 }
--- a/packages/jsdoc/package.json
+++ b/packages/jsdoc/package.json
@ -2,7 +2,7 @@
  "name": "jsdoc",
  "private": true,
  "version": "5.0.0-dev.19",
-  "revision": "1667509813080",
+  "revision": "1748665787180",
  "description": "An API documentation generator for JavaScript.",
  "keywords": [
    "documentation",
@ -26,7 +26,7 @@
    "strip-json-comments": "^5.0.2"
  },
  "engines": {
-    "node": ">=v18.12.0"
+    "node": "^20.19.0 || ^22.12.0 || >=23.0.0"
  },
  "type": "module",
  "bin": {