build: update node dependency from v18 to v20 (#2671)

* build: update node dependency from v18 to v20
* chore: add changeset

Author: castastrophe

.changeset/five-panthers-wonder.md

@@ -0,0 +1,7 @@
+---
+"@spectrum-css/preview": major
+"@spectrum-css/generator": major
+"@spectrum-tools/documentation": major
+---
+
+Support for Node v18 dropped; upgraded to Node v20

.github/workflows/build.yml

@@ -4,7 +4,7 @@ name: Validate successful build
 # in several environments:
 #
 #   Systems:    Ubuntu, MacOS, // Windows
-#   Node:       18
+#   Node:       20
 #
 # After the build is successful, the compiled assets are uploaded as an artifact
 # to the workflow run. This allows us to download the compiled assets and use
@@ -21,7 +21,7 @@ on:
                 default: "macos-latest"
             node-version:
                 required: false
-                default: "18"
+                default: "20"
             experimental:
                 required: false
                 default: "false"
@@ -37,7 +37,7 @@ on:
             node-version:
                 required: false
                 type: string
-                default: "18"
+                default: "20"
             experimental:
                 required: false
                 type: boolean

.github/workflows/compare-results.yml

@@ -52,7 +52,7 @@ jobs:
             - name: Use Node LTS version
               uses: actions/setup-node@v4
               with:
-                  node-version: 18
+                  node-version: 20
                   cache: yarn
                   cache-dependency-path: yarn.lock
 
@@ -68,7 +68,7 @@ jobs:
                   path: |
                       .cache/yarn
                       node_modules
-                  key: ubuntu-latest-node18-${{ hashFiles('yarn.lock') }}
+                  key: ubuntu-latest-node20-${{ hashFiles('yarn.lock') }}
 
             ## --- INSTALL --- ##
             # note: if cache-hit isn't needed b/c yarn will leverage the cache if it exists
@@ -88,13 +88,13 @@ jobs:
             - name: Download build artifacts for head
               uses: actions/download-artifact@v4
               with:
-                  name: ubuntu-latest-node18-compiled-assets-${{ steps.derive-key.outputs.head-path }}
+                  name: ubuntu-latest-node20-compiled-assets-${{ steps.derive-key.outputs.head-path }}
                   path: ${{ github.workspace }}/${{ steps.derive-key.outputs.head-path }}
 
             - name: Download build artifacts for base
               uses: actions/download-artifact@v4
               with:
-                  name: ubuntu-latest-node18-compiled-assets-${{ steps.derive-key.outputs.base-path }}
+                  name: ubuntu-latest-node20-compiled-assets-${{ steps.derive-key.outputs.base-path }}
                   path: ${{ github.workspace }}/${{ steps.derive-key.outputs.base-path }}
 
             - name: Compare compiled output file size
@@ -153,7 +153,7 @@ jobs:
               run: |
                   BRANCH=${{ matrix.branch }}
                   BRANCH=${BRANCH//\//_}
-                  echo "key=ubuntu-latest-node18-compiled-assets-${BRANCH}" >> "$GITHUB_OUTPUT"
+                  echo "key=ubuntu-latest-node20-compiled-assets-${BRANCH}" >> "$GITHUB_OUTPUT"
 
             - name: Check if build artifacts already exist
               uses: actions/download-artifact@v4
@@ -177,7 +177,7 @@ jobs:
             - name: Use Node LTS version
               uses: actions/setup-node@v4
               with:
-                  node-version: 18
+                  node-version: 20
                   cache: yarn
 
             - name: Enable Corepack
@@ -192,7 +192,7 @@ jobs:
                   path: |
                       .cache/yarn
                       node_modules
-                  key: ubuntu-latest-node18-${{ hashFiles('yarn.lock') }}
+                  key: ubuntu-latest-node20-${{ hashFiles('yarn.lock') }}
 
             ## --- INSTALL --- ##
             # note: if cache-hit isn't needed b/c yarn will leverage the cache if it exists

.github/workflows/development.yml

@@ -54,17 +54,11 @@ jobs:
                     - ubuntu-latest
                     # - windows-latest # todo: debug token style-dictionary failures on windows
                 node-version:
-                    - 18
-                experimental:
-                    - false
-                include:
-                    - node-version: 20
-                      experimental: true
+                    - 20
         uses: ./.github/workflows/build.yml
         with:
             system: ${{ matrix.system }}
             node-version: ${{ matrix.node-version }}
-            experimental: ${{ matrix.experimental }}
         secrets: inherit
 
     # -------------------------------------------------------------

.github/workflows/lint.yml

@@ -53,7 +53,7 @@ jobs:
             - name: Use Node LTS version
               uses: actions/setup-node@v4
               with:
-                  node-version: 18
+                  node-version: 20
                   cache: yarn
 
             - name: Enable Corepack
@@ -68,7 +68,7 @@ jobs:
                   path: |
                       .cache/yarn
                       node_modules
-                  key: ubuntu-latest-node18-${{ hashFiles('yarn.lock') }}
+                  key: ubuntu-latest-node20-${{ hashFiles('yarn.lock') }}
 
             ## --- INSTALL --- ##
             # If statement isn't needed here b/c yarn will leverage the cache if it exists

.github/workflows/production.yml

@@ -37,7 +37,7 @@ jobs:
                     - macos-latest
                     - ubuntu-latest
                 node-version:
-                    - 18
+                    - 20
         uses: ./.github/workflows/build.yml
         with:
             system: ${{ matrix.system }}

.github/workflows/publish-site.yml

@@ -51,7 +51,7 @@ jobs:
             - name: Use Node LTS version
               uses: actions/setup-node@v4
               with:
-                  node-version: 18
+                  node-version: 20
                   cache: yarn
 
             - name: Enable Corepack
@@ -66,7 +66,7 @@ jobs:
                   path: |
                       .cache/yarn
                       node_modules
-                  key: ubuntu-latest-node18-${{ hashFiles('yarn.lock') }}
+                  key: ubuntu-latest-node20-${{ hashFiles('yarn.lock') }}
 
             ## --- INSTALL --- ##
             # note: if cache-hit isn't needed b/c yarn will leverage the cache if it exists

.github/workflows/vrt.yml

@@ -35,7 +35,7 @@ jobs:
             - name: Use Node LTS version
               uses: actions/setup-node@v4
               with:
-                  node-version: 18
+                  node-version: 20
                   cache: yarn
 
             - name: Enable Corepack
@@ -50,7 +50,7 @@ jobs:
                   path: |
                       .cache/yarn
                       node_modules
-                  key: ubuntu-latest-node18-${{ hashFiles('yarn.lock') }}
+                  key: ubuntu-latest-node20-${{ hashFiles('yarn.lock') }}
 
             ## --- INSTALL --- ##
             - name: Install dependencies

.nvmrc

@@ -1 +1 @@
-18.*
+20.*

.storybook/guides/develop.mdx

@@ -24,7 +24,7 @@ For more general information about how to contribute to the Spectrum CSS project
 
 ## Prerequisites
 
-- [Node.js](https://nodejs.org/en/) (v18 or later)
+- [Node.js](https://nodejs.org/en/) (v20 or later)
 - [Yarn](https://yarnpkg.com/getting-started/install)
 
 ## Architecture