chore: migrate VuePress 1.x to 2.x #1022
Merged
+2,035
−6,279
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
sarahdayan
force-pushed
the
chore/update-node-20
branch
from
d2ee3da to
d148d82
Compare
sarahdayan
force-pushed
the
chore/migrate-vuepress
branch
from
1738759 to
8749972
Compare
Update testing and transpilation tooling: Jest ecosystem: - jest: 26.0.1 → 29.7.0 - babel-jest: 26.0.1 → 29.7.0 - jest-watch-typeahead: 0.6.0 → 2.2.2 Babel ecosystem (required for Jest 29 compatibility): - @babel/core: 7.10.2 → 7.26.9 - @babel/preset-env: 7.10.2 → 7.26.9 - @babel/plugin-transform-runtime: 7.10.1 → 7.26.9 - @babel/runtime: ^7.6.3 → ^7.28.6 Co-Authored-By: Claude Opus 4.5 <[email protected]>
Jest 29 changed snapshot serialization format:
- Object {} → {}
- Array [] → []
Co-Authored-By: Claude Opus 4.5 <[email protected]>
sarahdayan
requested review from
a team,
FabienMotte,
dhayab and
shaejaz
and removed request for
a team
Update build tooling for shipjs-lib: - rollup: 2.14.0 → 4.34.8 - rollup-plugin-commonjs → @rollup/[email protected] - rollup-plugin-node-resolve → @rollup/[email protected] Updated rollup.config.js to use the new scoped plugin packages and createRequire for JSON imports (ESM compatible). Co-Authored-By: Claude Opus 4.5 <[email protected]>
Update linting tooling: ESLint: - eslint: 7.2.0 → 8.57.1 - eslint-config-algolia: 16.0.0 → 20.0.0 - eslint-config-prettier: 6.11.0 → 8.10.0 - eslint-plugin-import: 2.20.2 → 2.31.0 - eslint-plugin-jest: 23.13.2 → 27.9.0 - eslint-plugin-prettier: 3.1.3 → 4.2.1 - eslint-plugin-jsdoc: added 46.10.1 Parser: - babel-eslint → @babel/[email protected] Updated .eslintrc.cjs to use @babel/eslint-parser and disable removed/incompatible rules. Note: Prettier remains at 2.x due to ESM compatibility issues with Jest. Prettier 3.x upgrade can be done in a future PR. Co-Authored-By: Claude Opus 4.5 <[email protected]>
Auto-fixed lint errors from ESLint 8 stricter rules: - import/order: Sorted imports by group (builtin, external, internal) - import/newline-after-import: Added newlines after imports - no-else-return: Removed unnecessary else after return - jest/prefer-to-be: Use toBe/toBeNull for primitive checks Also fixed a buggy mock in updateVersionMonorepo.spec.js that was attempting to spy on a non-existent property. Co-Authored-By: Claude Opus 4.5 <[email protected]>
Modernize monorepo tooling by upgrading Lerna to v8. This update: - Updates lerna.json configuration format for Lerna 8 compatibility - Removes deprecated useWorkspaces option (Lerna 8 auto-detects workspaces) - Adds $schema reference for better IDE support Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Convert require() to dynamic import() in updateChangelog.js - Replace .toString() with 'utf-8' encoding parameter in readFileSync calls - Fix 'require' to 'import' in updateChangelog.spec.js Co-Authored-By: Claude Opus 4.5 <[email protected]>
Exclude test directories from security-focused rules. Tests legitimately use dynamic paths (e.g., __dirname + path.resolve) to load fixtures, which triggers false positive "path injection" warnings. Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Update .nvmrc and .node-version to Node 20 - Update engines field in root and shipjs package.json to >=20 - Update CircleCI config to use cimg/node:20.18 Co-Authored-By: Claude Opus 4.5 <[email protected]>
sarahdayan
force-pushed
the
chore/update-node-20
branch
from
d148d82 to
39a93ec
Compare
- Update .nvmrc and .node-version to Node 20 - Update engines field in root and shipjs package.json to >=20 - Update CircleCI config to use cimg/node:20.18 Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Update vuepress from 1.9.10 to 2.0.0-rc.26 - Add @vuepress/bundler-vite, @vuepress/theme-default - Replace @vuepress/plugin-google-analytics v1 with v2 - Add @vuepress/plugin-docsearch for Algolia search - Rewrite config.js for VuePress 2 ESM format - Update homepage frontmatter (actionText → actions array) - Convert deploy script to ESM - Remove NODE_OPTIONS=--openssl-legacy-provider hack VuePress 2 requires Node.js 20+. Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Update Node version to 20.19 (required by @vitejs/[email protected]) - Add sass-embedded dependency (required by VuePress default theme) Co-Authored-By: Claude Opus 4.5 <[email protected]>
sarahdayan
force-pushed
the
chore/migrate-vuepress
branch
from
8749972 to
25710b5
Compare
Update build tooling for shipjs-lib: - rollup: 2.14.0 → 4.34.8 - rollup-plugin-commonjs → @rollup/[email protected] - rollup-plugin-node-resolve → @rollup/[email protected] Updated rollup.config.js to use the new scoped plugin packages and createRequire for JSON imports (ESM compatible). Co-Authored-By: Claude Opus 4.5 <[email protected]>
Update linting tooling: ESLint: - eslint: 7.2.0 → 8.57.1 - eslint-config-algolia: 16.0.0 → 20.0.0 - eslint-config-prettier: 6.11.0 → 8.10.0 - eslint-plugin-import: 2.20.2 → 2.31.0 - eslint-plugin-jest: 23.13.2 → 27.9.0 - eslint-plugin-prettier: 3.1.3 → 4.2.1 - eslint-plugin-jsdoc: added 46.10.1 Parser: - babel-eslint → @babel/[email protected] Updated .eslintrc.cjs to use @babel/eslint-parser and disable removed/incompatible rules. Note: Prettier remains at 2.x due to ESM compatibility issues with Jest. Prettier 3.x upgrade can be done in a future PR. Co-Authored-By: Claude Opus 4.5 <[email protected]>
Auto-fixed lint errors from ESLint 8 stricter rules: - import/order: Sorted imports by group (builtin, external, internal) - import/newline-after-import: Added newlines after imports - no-else-return: Removed unnecessary else after return - jest/prefer-to-be: Use toBe/toBeNull for primitive checks Also fixed a buggy mock in updateVersionMonorepo.spec.js that was attempting to spy on a non-existent property. Co-Authored-By: Claude Opus 4.5 <[email protected]>
Update testing and transpilation tooling: Jest ecosystem: - jest: 26.0.1 → 29.7.0 - babel-jest: 26.0.1 → 29.7.0 - jest-watch-typeahead: 0.6.0 → 2.2.2 Babel ecosystem (required for Jest 29 compatibility): - @babel/core: 7.10.2 → 7.26.9 - @babel/preset-env: 7.10.2 → 7.26.9 - @babel/plugin-transform-runtime: 7.10.1 → 7.26.9 - @babel/runtime: ^7.6.3 → ^7.28.6 Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Convert require() to dynamic import() in updateChangelog.js - Replace .toString() with 'utf-8' encoding parameter in readFileSync calls - Fix 'require' to 'import' in updateChangelog.spec.js Co-Authored-By: Claude Opus 4.5 <[email protected]>
Exclude test directories from security-focused rules. Tests legitimately use dynamic paths (e.g., __dirname + path.resolve) to load fixtures, which triggers false positive "path injection" warnings. Co-Authored-By: Claude Opus 4.5 <[email protected]>
- Update .nvmrc and .node-version to Node 20 - Update engines field in root and shipjs package.json to >=20 - Update CircleCI config to use cimg/node:20.18 Co-Authored-By: Claude Opus 4.5 <[email protected]>
sarahdayan
force-pushed
the
chore/update-node-20
branch
from
39a93ec to
db3b45e
Compare
shaejaz
approved these changes
Feb 3, 2026
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Migrates the documentation site from VuePress 1.9.10 to VuePress 2.0.0-rc.26.
Changes
vuepressfrom 1.9.10 to 2.0.0-rc.26@vuepress/bundler-vitefor Vite-based builds@vuepress/theme-default(now a separate package)@vuepress/plugin-google-analyticsv1 with v2@vuepress/plugin-docsearchfor Algolia search integrationconfig.jsfor VuePress 2 ESM formatactionText→actionsarray)NODE_OPTIONS=--openssl-legacy-providerhackFiles changed
website/package.json- updated dependencieswebsite/.vuepress/config.js- rewritten for VuePress 2 formatwebsite/README.md- updated frontmatterwebsite/scripts/deploy-gh.js- converted to ESMyarn.lock- updatedNote
VuePress 2 requires Node.js 20+, which aligns with PR #1021 (Node.js 20 update).