chore(node): migrate dev and CI runtime to Node 24 LTS

.changeset/codemod-node-24.md

@@ -0,0 +1,5 @@
+---
+'@vapor-ui/codemod': minor
+---
+
+Require Node.js 24 or later

.gemini/styleguide.md

@@ -7,7 +7,7 @@
 ---
 
 - **Package Manager**: PNPM (workspace 기반 모노레포)
-- **Node.js**: `>=20.19` (`.nvmrc`, `package.json` engines 기준)
+- **Node.js**: `>=24` (`.nvmrc`, `package.json` engines 기준)
 - **UI Primitives**: `@base-ui/react` (Accessible unstyled components)
 - **Styling**: Vanilla Extract (`@vanilla-extract/css`, `@vanilla-extract/recipes`)
 - **Testing**: Vitest + React Testing Library + vitest-axe

.github/composite/install/action.yml

@@ -11,7 +11,7 @@ runs:
         - name: Install Node.js
           uses: actions/setup-node@v4
           with:
-              node-version-file: 'package.json'
+              node-version-file: '.nvmrc'
               cache: 'pnpm'
 
         - name: Install Dependencies

.nvmrc

@@ -1 +1 @@
-20.20.2
+24

CONTRIBUTING.md

@@ -40,12 +40,14 @@ cd vapor-ui
 git remote add upstream https://github.com/goorm-dev/vapor-ui.git
 ```
 
-2. Ensure your Node version matches the [.nvmrc](../.nvmrc):
+2. Switch to the Node version in [.nvmrc](../.nvmrc) (`pnpm install` refuses to run on any other major version):
 
 ```bash
-node -v
+nvm use   # or: fnm use
 ```
 
+pnpm itself is pinned by the `packageManager` field in `package.json` and switches automatically.
+
 3. Install dependencies:
 
 ```bash

apps/website/package.json

@@ -57,7 +57,7 @@
         "@tailwindcss/postcss": "^4.3.3",
         "@types/lodash-es": "^4.17.12",
         "@types/mdx": "^2.0.14",
-        "@types/node": "^22.20.1",
+        "@types/node": "^24.13.3",
         "@types/react": "catalog:",
         "@types/react-dom": "catalog:",
         "@vapor-ui/ts-api-extractor": "workspace:*",

package.json

@@ -50,7 +50,7 @@
         "@changesets/cli": "^2.31.1",
         "@changesets/get-github-info": "^0.8.0",
         "@trivago/prettier-plugin-sort-imports": "^5.2.2",
-        "@types/node": "^22.20.1",
+        "@types/node": "^24.13.3",
         "dotenv": "^17.4.2",
         "husky": "^9.1.7",
         "lodash-es": "^4.18.1",
@@ -61,8 +61,8 @@
         "turbo": "^2.10.9",
         "typescript": "catalog:"
     },
-    "packageManager": "pnpm@10.34.5",
+    "packageManager": "pnpm@11.21.0",
     "engines": {
-        "node": ">=20.20.2"
+        "node": ">=24"
     }
 }

packages/codemod/package.json

@@ -43,7 +43,7 @@
         "@types/is-git-clean": "^1.1.2",
         "@types/jest": "^29.5.14",
         "@types/jscodeshift": "^17.3.0",
-        "@types/node": "^20.19.43",
+        "@types/node": "^24.13.3",
         "@vapor-ui/core": "workspace:*",
         "@vapor-ui/icons": "workspace:*",
         "eslint": "catalog:",
@@ -53,7 +53,7 @@
         "tsup": "^8.5.1"
     },
     "engines": {
-        "node": ">=14.21.3"
+        "node": ">=24"
     },
     "publishConfig": {
         "access": "public"

packages/codemod/tsup.config.ts

@@ -5,6 +5,7 @@ export default defineConfig([
     {
         entry: { 'bin/cli': 'src/bin/cli.ts' },
         format: ['esm'],
+        target: 'node24',
         outDir: './dist',
         clean: true,
         sourcemap: false,
@@ -16,6 +17,7 @@ export default defineConfig([
     {
         entry: ['src/transforms/**/*.ts', '!src/**/*.test.ts', '!src/**/*.spec.ts'],
         format: ['esm'],
+        target: 'node24',
         outDir: './dist/transforms',
         clean: true,
         sourcemap: false,