chore: Move to yarn 4 and workspaces

.github/workflows/release.yml

@@ -48,13 +48,14 @@ jobs:
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           node-version-file: '.nvmrc'
-          cache: 'yarn'
 
       - name: Enable Corepack
-        run: corepack enable yarn
+        run: corepack enable
 
       - name: Install dependencies
-        run: yarn
+        run: |
+          yarn install --immutable
+          yarn bootstrap
 
       - name: Build packages
         run: yarn build

.github/workflows/test.yml

@@ -24,13 +24,14 @@ jobs:
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           node-version-file: '.nvmrc'
-          cache: 'yarn'
 
       - name: Enable Corepack
-        run: corepack enable yarn
+        run: corepack enable
 
       - name: Install dependencies
-        run: yarn bootstrap
+        run: |
+          yarn install --immutable
+          yarn bootstrap
 
       - name: Build packages
         run: yarn build
@@ -73,13 +74,14 @@ jobs:
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           node-version-file: '.nvmrc'
-          cache: 'yarn'
 
       - name: Enable Corepack
-        run: corepack enable yarn
+        run: corepack enable
 
       - name: Install dependencies
-        run: yarn bootstrap
+        run: |
+          yarn install --immutable
+          yarn bootstrap
 
       - name: Build packages
         run: yarn build
@@ -97,16 +99,17 @@ jobs:
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           node-version-file: '.nvmrc'
-          cache: 'yarn'
 
       - name: Enable Corepack
-        run: corepack enable yarn
+        run: corepack enable
 
       - name: Install uv
         uses: astral-sh/setup-uv@d4b2f3b6ecc6e67c4457f6d3e41ec42d3d0fcb86 # v5
 
       - name: Install dependencies
         run: |
+          yarn install --immutable
+          yarn bootstrap
           cd bindings/pydeck
           make setup-env
           make init

.github/workflows/website.yml

@@ -36,15 +36,15 @@ jobs:
         uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           node-version-file: '.nvmrc'
-          cache: 'yarn'
 
       - name: Enable Corepack
-        run: corepack enable yarn
+        run: corepack enable
 
       - name: Install dependencies
         run: |
+          yarn install --immutable
           yarn bootstrap
-          (cd website && yarn)
+          (cd website && yarn install --immutable)
 
       - name: Build website
         env:

.gitignore

@@ -27,6 +27,8 @@ showcases/**/yarn.lock
 test/**/yarn.lock
 yarn-error.log
 package-lock.json
+.yarn/
+*/**/.yarn/
 
 .claude/
 .vscode/

.yarnrc.yml

@@ -0,0 +1,11 @@
+enableScripts: true
+
+nodeLinker: node-modules
+
+logFilters:
+  - code: YN0002
+    level: discard
+  - code: YN0060
+    level: discard
+  - code: YN0086
+    level: discard

CONTRIBUTING.md

@@ -50,15 +50,16 @@ Run the website:
 ```bash
 yarn build
 cd website
-yarn
+yarn install
 yarn start
 ```
 
 Run the layer browser application:
 
 ```bash
+cd deck.gl
+yarn install
 cd examples/layer-browser
-yarn
 yarn start-local
 ```
 
@@ -71,7 +72,7 @@ If you consider opening a PR, here is some documentation to get you started:
 
 Each example can be run so that it is built against the deck.gl source code in this repo instead of building against the installed version of deck.gl. This enables using the examples to debug the main deck.gl library source.
 
-To do so use the `yarn start-local` command present in each example's directory. See [vite.config.local.mjs](https://github.com/visgl/deck.gl/blob/master/examples/vite.config.local.mjs) for details.
+To do so, run `yarn install` once from the repository root, then use the `yarn start-local` command present in each example's directory. See [vite.config.local.mjs](https://github.com/visgl/deck.gl/blob/master/examples/vite.config.local.mjs) for details.
 
 ### Working with other vis.gl dependencies
 

docs/get-started/getting-started.md

@@ -61,6 +61,8 @@ If the example uses a mapbox base map you need a [Mapbox access token](./using-w
 export MapboxAccessToken={Your Token Here} && npm start
 ```
 
+When working from a deck.gl repository checkout, run `yarn install` once at the repository root. Package-managed examples are part of the root Yarn workspace and can then be run from their own directories with `yarn start`.
+
 If you want to build the example against the latest deck.gl source code in the cloned repo (rather than the published version of deck.gl listed in the examples `package.json`)
 
 ```bash
@@ -69,7 +71,7 @@ npm run start-local
 
 > The examples on the `master` branch are updated to use features from the latest, unreleased version of deck.gl. If some example doesn't work using `npm start` it can be worth trying `npm run start-local`.
 
-> While all examples support `npm run start-local`, there are some caveats when running against local source. Most importantly, you must make sure to run `npm install` or `yarn` in the deck.gl root folder before running `npm run start-local` in an example folder.
+> While all examples support `npm run start-local`, there are some caveats when running against local source. Most importantly, you must make sure to run `yarn install` in the deck.gl root folder before running `npm run start-local` in an example folder.
 
 
 ## Selectively Install Dependencies

examples/README.md

@@ -50,7 +50,9 @@ These are examples that use experimental deck.gl features, or implement features
 
 ## Installing and Running
 
-Most example apps can be run by installing the dependencies with either `yarn` or with `npm install`, then `npm run start`. Refer to the README in each example directory for app-specific instructions.
+Most example apps can be run by installing the dependencies with either `yarn` or with `npm install`, then `npm run start`. When working from a deck.gl repository checkout, run `yarn install` once from the repository root before starting examples.
+
+Refer to the README in each example directory for app-specific instructions.
 
 
 ### Running Examples Against deck.gl Source Code

examples/gallery/package.json

@@ -1,13 +1,14 @@
 {
+  "name": "deckgl-examples-gallery",
   "description": "deck.gl scripting examples",
   "version": "0.0.0",
+  "private": true,
   "license": "MIT",
   "scripts": {
     "build": "rm -rf dist && mkdir dist && cp -r images dist && node build-tools/build",
     "start": "node build-tools/serve",
     "start-local": "node build-tools/serve --version=local"
   },
-  "dependencies": {},
   "devDependencies": {
     "express": "^4.16.3",
     "mustache": "^2.3.0"

examples/get-started/pure-js/mapbox/app.js

@@ -4,6 +4,7 @@
 
 import {MapboxOverlay as DeckOverlay} from '@deck.gl/mapbox';
 import {GeoJsonLayer, ArcLayer} from '@deck.gl/layers';
+// eslint-disable-next-line import/default
 import mapboxgl from 'mapbox-gl';
 import 'mapbox-gl/dist/mapbox-gl.css';
 

modules/geo-layers/src/s2-layer/s2-utils.ts

@@ -18,10 +18,10 @@ import Long from 'long';
  * Given an S2 token this function convert the token to 64 bit id
    https://github.com/google/s2-geometry-library-java/blob/c04b68bf3197a9c34082327eeb3aec7ab7c85da1/src/com/google/common/geometry/S2CellId.java#L439
  * */
-function getIdFromToken(token: string): number {
+function getIdFromToken(token: string): string {
   // pad token with zeros to make the length 16
   const paddedToken = token.padEnd(16, '0');
-  return Long.fromString(paddedToken, 16);
+  return Long.fromString(paddedToken, 16).toString();
 }
 
 const MAX_RESOLUTION = 100;

modules/jupyter-widget/package.json

@@ -23,8 +23,9 @@
   ],
   "sideEffects": false,
   "scripts": {
-    "watch": "npm run build -- --watch",
-    "build": "ocular-bundle ./src/index.js --output=./dist/index.js --globalName= --sourcemap --format=umd --externals=@jupyter-widgets/base",
+    "watch": "npm run build-bundle -- --watch",
+    "build": "npm run build-bundle",
+    "build-bundle": "ocular-bundle ./src/index.js --output=./dist/index.js --globalName= --sourcemap --format=umd --externals=@jupyter-widgets/base",
     "build:labextension": "npm pack",
     "prepublishOnly": "npm run build"
   },

package.json

@@ -15,13 +15,14 @@
     "url": "https://github.com/visgl/deck.gl.git"
   },
   "workspaces": [
-    "modules/*"
+    "modules/*",
+    "examples/**"
   ],
   "scripts": {
     "postinstall": "npx playwright install chromium",
-    "bootstrap": "yarn && ocular-bootstrap",
+    "bootstrap": "ocular-bootstrap",
     "clean": "ocular-clean",
-    "build": "npm run clean && ocular-build && lerna run build",
+    "build": "ocular-clean && ocular-build && npx lerna run build",
     "lint": "ocular-lint",
     "publish-beta": "ocular-publish version-only-beta",
     "publish-prod": "ocular-publish version-only-prod",
@@ -33,7 +34,7 @@
     "test-ci": "vitest run --project node --project headless --project render --coverage",
     "test-browser": "vitest run --project browser",
     "test-tape-compat": "DECK_TEST_UTILS_USE_PROBE_GL=1 ocular-test tape-compat",
-    "test-website": "cd website && yarn && yarn test-build && cd ..",
+    "test-website": "cd website && yarn install --immutable && yarn test-build && cd ..",
     "metrics": "ocular-metrics",
     "link-luma": "yarn && (cd node_modules && mv luma.gl luma.orig && ln -s ../../luma.gl/modules/core)",
     "unlink-luma": "(cd node_modules && mv luma.gl luma.ln && mv luma.orig luma.gl)",
@@ -69,10 +70,25 @@
     "puppeteer": "^24.26.1",
     "s2-geometry": "^1.2.10",
     "sharp": "^0.34.5",
-    "vitest": "^4.0.18",
-    "vite-bundle-analyzer": "^1.3.6"
+    "typescript": "5.5.4",
+    "vite-bundle-analyzer": "^1.3.6",
+    "vitest": "^4.0.18"
   },
   "resolutions": {
+    "@deck.gl/aggregation-layers": "9.3.0-beta.2",
+    "@deck.gl/arcgis": "9.3.0-beta.2",
+    "@deck.gl/carto": "9.3.0-beta.2",
+    "@deck.gl/core": "9.3.0-beta.2",
+    "@deck.gl/extensions": "9.3.0-beta.2",
+    "@deck.gl/geo-layers": "9.3.0-beta.2",
+    "@deck.gl/google-maps": "9.3.0-beta.2",
+    "@deck.gl/json": "9.3.0-beta.2",
+    "@deck.gl/layers": "9.3.0-beta.2",
+    "@deck.gl/mapbox": "9.3.0-beta.2",
+    "@deck.gl/mesh-layers": "9.3.0-beta.2",
+    "@deck.gl/react": "9.3.0-beta.2",
+    "@deck.gl/widgets": "9.3.0-beta.2",
+    "deck.gl": "9.3.0-beta.2",
     "vite": "^7.3.1"
   },
   "pre-commit": [
@@ -82,5 +98,5 @@
   "engines": {
     "node": ">=22"
   },
-  "packageManager": "yarn@1.22.19"
+  "packageManager": "yarn@4.15.0"
 }

website/.yarnrc.yml

@@ -0,0 +1,3 @@
+enableScripts: true
+
+nodeLinker: node-modules

website/ocular-docusaurus-plugin/index.js

@@ -44,8 +44,9 @@ module.exports = function (
       // Load existing source maps
       _config.module.rules.push({
         test: /\/dist\/.+\.js$/,
-        enforce: "pre",
-        use: ["source-map-loader"],
+        exclude: /node_modules/,
+        enforce: 'pre',
+        use: ['source-map-loader']
       });
 
       const devtool = debug ? 'source-map' : false;

website/package.json

@@ -60,7 +60,7 @@
     ">0.2% and supports async-functions",
     "not dead"
   ],
-  "packageManager": "yarn@1.22.19",
+  "packageManager": "yarn@4.15.0",
   "engines": {
     "node": ">=22"
   }

website/scripts/build.sh

@@ -34,7 +34,6 @@ BABEL_ENV=es5 npx babel ./static/workers --out-dir ./$OUTPUT_DIR/workers
 # build gallery (scripting) examples
 (
   cd ../examples/gallery
-  yarn
   yarn build
 )
 mkdir $OUTPUT_DIR/gallery

website/scripts/test-build.sh

@@ -19,6 +19,5 @@ docusaurus build
 # build gallery (scripting) examples
 (
   cd ../examples/gallery
-  yarn
   yarn build
 )