build: upgrade to yarn 3

.circleci/config.yml

@@ -24,9 +24,12 @@ commands:
             - restore_cache:
                   keys:
                       - v3b-<< pipeline.parameters.wireit_cache_name >>-{{ arch }}-{{ checksum "package.json" }}-
+            - run:
+                  name: Enable Corepack
+                  command: corepack enable
             - run:
                   name: Installing Dependencies
-                  command: yarn --frozen-lockfile --cache-folder ~/.cache/yarn
+                  command: yarn install --immutable
             - save_cache:
                   paths:
                       - ~/.cache/yarn
@@ -123,9 +126,12 @@ jobs:
             - restore_cache:
                   keys:
                       - v3b-dependencies-{{ arch }}-{{ checksum "yarn.lock" }}
+            - run:
+                  name: Enable Corepack
+                  command: corepack enable
             - run:
                   name: Installing Dependencies
-                  command: yarn --ignore-scripts --frozen-lockfile --cache-folder ~/.cache/yarn
+                  command: yarn install --immutable
             - save_cache:
                   paths:
                       - ~/.cache/yarn

.github/workflows/pr-update.yml

@@ -15,8 +15,10 @@ jobs:
               with:
                   cache: yarn
                   node-version: 18
+            - name: Enable Corepack
+              run: corepack enable
             - name: Install dependencies
-              run: yarn install --frozen-lockfile
+              run: yarn install --immutable
               # README: https://github.com/castastrophe/actions-pr-auto-update#auto-update-pull-requests
             - uses: castastrophe/actions-pr-auto-update@v1.1.0
               with:

.github/workflows/publish.yml

@@ -19,9 +19,10 @@ jobs:
                   node-version: '18'
                   cache: 'yarn'
                   registry-url: 'https://registry.npmjs.org'
-
+            - name: Enable Corepack
+              run: corepack enable
             - name: Install dependencies
-              run: yarn --frozen-lockfile
+              run: yarn install --immutable
 
             - name: Generate Docs
               run: yarn docs:ci

.github/workflows/smoke.yml

@@ -15,9 +15,10 @@ jobs:
                   node-version: 18
                   cache: 'yarn'
                   registry-url: 'https://registry.npmjs.org'
-
+            - name: Enable Corepack
+              run: corepack enable
             - name: Install dependencies
-              run: yarn --frozen-lockfile
+              run: yarn install --immutable
             - name: Install Playwright Browsers
               run: npx playwright install --with-deps
             - name: Run Playwright tests

.github/workflows/test.yml

@@ -26,9 +26,10 @@ jobs:
                   node-version: '18'
                   cache: 'yarn'
                   registry-url: 'https://registry.npmjs.org'
-
+            - name: Enable Corepack
+              run: corepack enable
             - name: Install dependencies
-              run: yarn --frozen-lockfile
+              run: yarn install --immutable
 
             - name: Post Previews
               uses: actions/github-script@v7
@@ -74,9 +75,10 @@ jobs:
                   node-version: '18'
                   cache: 'yarn'
                   registry-url: 'https://registry.npmjs.org'
-
+            - name: Enable Corepack
+              run: corepack enable
             - name: Install dependencies
-              run: yarn --frozen-lockfile
+              run: yarn install --immutable
 
             - name: Extract branch name
               shell: bash
@@ -146,9 +148,10 @@ jobs:
                   node-version: '18'
                   cache: 'yarn'
                   registry-url: 'https://registry.npmjs.org'
-
+            - name: Enable Corepack
+              run: corepack enable
             - name: Install dependencies
-              run: yarn --frozen-lockfile
+              run: yarn install --immutable
 
             - run: firefox --version
 
@@ -187,9 +190,10 @@ jobs:
                   node-version: '18'
                   cache: 'yarn'
                   registry-url: 'https://registry.npmjs.org'
-
+            - name: Enable Corepack
+              run: corepack enable
             - name: Install dependencies
-              run: yarn --frozen-lockfile
+              run: yarn install --immutable
 
             - name: Tachometer the changed packages
               run: yarn test:changed
@@ -227,9 +231,10 @@ jobs:
                   node-version: '18'
                   cache: 'yarn'
                   registry-url: 'https://registry.npmjs.org'
-
+            - name: Enable Corepack
+              run: corepack enable
             - name: Install dependencies
-              run: yarn --frozen-lockfile
+              run: yarn install --immutable
 
             - name: Retrieve tachometer results archives
               uses: actions/download-artifact@v4

.gitignore

@@ -93,3 +93,13 @@ test/visual/test.js
 node_modules
 npm-debug.log
 package-lock.json
+
+
+# yarn 3
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions

.yarnrc.yml

@@ -0,0 +1,6 @@
+nodeLinker: node-modules
+yarnPath: .yarn/releases/yarn-4.1.0.cjs
+cacheFolder: ./.yarn/cache
+npmScopes:
+    '@adobe':
+        npmRegistryServer: 'https://registry.npmjs.org/'

README.md

@@ -6,6 +6,20 @@ To this end, Spectrum Web Components only targets _modern_, evergreen browsers t
 
 # Requirements
 
+This project uses **Node** and modern **yarn**. You must enable [corepack](https://yarnpkg.com/corepack) to use modern yarn. This only needs to be done once; to check if you've already enabled corepack:
+
+```sh
+yarn exec env
+```
+
+if you get a path as output, Corepack is properly installed. Otherwise, try:
+
+```shell
+corepack enable
+```
+
+Read more about [installing yarn](https://yarnpkg.com/getting-started/install);
+
 -   NodeJS >= 18.17.0
 -   Typescript
 -   Browsers with Custom Elements V1 and Shadow DOM support, e.g. Chrome, Firefox, Safari, Edge (79+)

package.json

@@ -92,7 +92,6 @@
     "peerDependencies": {
         "common-tags": "^1.8.0"
     },
-    "dependencies": {},
     "devDependencies": {
         "@commitlint/cli": "^19.0.1",
         "@commitlint/config-conventional": "^19.0.0",
@@ -194,6 +193,7 @@
         "wireit": "^0.14.3",
         "yargs": "^17.2.1"
     },
+    "packageManager": "yarn@4.1.0",
     "wireit": {
         "build:css:watch": {
             "command": "node ./tasks/watch-css.js",

projects/css-custom-vars-viewer/package.json

@@ -1,7 +1,6 @@
 {
     "name": "@spectrum-web-components/custom-vars-viewer",
     "version": "0.41.1",
-    "private": "true",
     "description": "Demo app created with Spectrum Web Components, following open-wc guidelines",
     "license": "Apache-2.0",
     "author": "najikahalsema",