chore: patch release 3.3.0 alpha.4 (#3588)

* add lerna to update version

Signed-off-by: Ihor Dykhta <ihordykhta@Ihors-MacBook-Pro.local>

* bump script impr

Signed-off-by: Ihor Dykhta <ihordykhta@Ihors-MacBook-Pro.local>

* changelog; script yarn fix

Signed-off-by: Ihor Dykhta <ihordykhta@Ihors-MacBook-Pro.local>

* bump

Signed-off-by: Ihor Dykhta <ihordykhta@Ihors-MacBook-Pro.local>

* follow up

Signed-off-by: Ihor Dykhta <ihordykhta@Ihors-MacBook-Pro.local>

---------

Signed-off-by: Ihor Dykhta <ihordykhta@Ihors-MacBook-Pro.local>
Co-authored-by: Ihor Dykhta <ihordykhta@Ihors-MacBook-Pro.local>

Author: igorDykhta

.gitignore

@@ -31,6 +31,7 @@ package-lock.json
 /index.html
 
 npm-debug.log
+lerna-debug.log
 .history/
 .yarn
 .npmrc

CHANGELOG.md

@@ -15,6 +15,59 @@ Each version should:
 Ref: http://keepachangelog.com/en/0.3.0/
 -->
 
+## [3.3.0-alpha.4] - July 28 2026
+
+- ea966330 chore: upgrade to webpack 5 (#3587)
+- 952d7c43 fix: swipe layer doesn't work in dual/swipe modes as expected (#3552)
+- c76881e8 fix: WMS layer fixes in globe mode (#3557)
+- 46c787f6 chore(deps): bump basic-ftp from 5.0.5 to 5.3.1 (#3571)
+- 897d3149 chore(deps-dev): bump @babel/core from 7.24.9 to 7.29.6 (#3493)
+- e44e49c6 chore(deps): bump lodash from 4.17.23 to 4.18.1 in /src/components (#3567)
+- 802aff8e chore(deps): bump esbuild from 0.25.0 to 0.28.1 in /examples/demo-app (#3484)
+- 9dd717a6 chore(deps): bump glob from 10.4.5 to 10.5.0 in /examples/demo-app (#3582)
+- c3c18e04 chore(deps): bump flatted from 3.3.1 to 3.4.3 (#3577)
+- c7dea273 chore(deps-dev): bump @babel/runtime from 7.25.0 to 7.26.10 (#3585)
+- 4b36ee89 chore(deps): bump picomatch in /bindings/kepler.gl-jupyter/js (#3572)
+- 6f51f84e chore(deps): bump underscore in /bindings/kepler.gl-jupyter/js (#3575)
+- 01c9b720 chore(deps): bump minimatch from 9.0.5 to 9.0.9 in /examples/demo-app (#3576)
+- 3c778810 chore(deps): bump bn.js in /bindings/kepler.gl-jupyter/js (#3579)
+- 449ae691 chore(deps): bump min-document in /examples/demo-app (#3583)
+- ac8d3d4a chore(deps): bump sha.js in /bindings/kepler.gl-jupyter/js (#3584)
+- 4825748f chore(deps): bump handlebars from 4.7.8 to 4.7.9 (#3574)
+- 667fcea9 chore(deps): bump yaml from 1.10.2 to 1.10.3 (#3573)
+- 938547ac chore(deps): bump pbkdf2 from 3.1.2 to 3.1.6 (#3580)
+- b0087674 chore(deps-dev): bump @babel/core from 7.26.0 to 7.29.6 in /website (#3560)
+- b677609e chore(deps-dev): bump esbuild from 0.23.1 to 0.28.1 in /website (#3485)
+- ad8587b6 chore(deps): bump protocol-buffers-schema from 3.6.0 to 3.6.1 (#3570)
+- 618af3c6 chore(deps): bump nbconvert from 7.17.0 to 7.17.1 in /bindings/python (#3562)
+- a7224500 chore(deps): bump protocol-buffers-schema (#3565)
+- c9807ae0 chore(deps): bump fast-xml-parser in /bindings/kepler.gl-jupyter/js (#3563)
+- a8705b2d chore(deps): bump protocol-buffers-schema in /examples/demo-app (#3564)
+- 8a280a48 chore(deps): bump brace-expansion in /bindings/kepler.gl-jupyter/js (#3558)
+- 40dd7fea chore(deps): bump ws from 5.2.4 to 5.2.7 (#3561)
+- 9a70d370 chore(deps): bump websocket-driver from 0.7.4 to 0.7.5 in /website (#3559)
+- da0f5958 chore(deps): bump tar from 7.5.16 to 7.5.22 in /examples/demo-app (#3555)
+- 9e3f5d21 chore(deps): bump brace-expansion in /examples/demo-app (#3556)
+- 05c4db18 chore(deps): bump jupyterlab from 4.5.9 to 4.5.10 in /bindings/python (#3554)
+- 1c49c29d fix: globe mode LOD, high-zoom rendering, pan jump, and annotation occlusion (#3551)
+- e3c200c0 fix: attribution fixes and refactoring (#3550)
+- bcfe975c fix: mutually exclusive map control menus + consistent split-mode menu styling (#3547)
+- 0d0673b6 fix: Preserve custom basemap style attributions (#3515) (#3543)
+- 67216fad fix: polygon filter - add missing layer types (#3545)
+- e177a475 fix: remove mirrored control buttons in double view (#3546)
+- 200baa97 fix: heatmap issues on zoom out (#3544)
+- 2d3a003f feat: optional background stars in globe mode (#3542)
+- c571999d chore(deps): bump shell-quote from 1.8.4 to 1.10.0 (#3538)
+- 494c785f chore(deps): bump js-yaml from 3.14.2 to 3.15.0 (#3541)
+- ea00a61a chore(deps): bump tar from 7.5.7 to 7.5.20 in /website (#3536)
+- 6fa1dd2c chore(deps): bump fast-uri from 3.1.2 to 3.1.4 in /website (#3539)
+- 8318bb66 chore(deps): bump websocket-driver in /bindings/kepler.gl-jupyter/js (#3531)
+- 263c1919 feat: Globe view mode (#3486)
+- 4297396b chore(deps): bump brace-expansion from 1.1.12 to 1.1.16 in /website (#3534)
+- 32c354aa chore(deps): bump brace-expansion from 1.1.12 to 1.1.16 (#3535)
+- 5161a694 Update translation for '3dBuilding' to '3D Building' (#3529)
+- b6ed6633 chore(deps): bump websocket-driver from 0.7.4 to 0.7.5 (#3530)
+
 ## [3.3.0-alpha.3] - July 12 2026
 
 - 9e027002 chore(deps): upgrade editable-layers to 9.3.7, h3-js to v4, turf to v7 (#3526)

contributing/DEVELOPERS.md

@@ -392,7 +392,15 @@ Setup `gh-release` with your github api token ([instructions](https://www.npmjs.
 
 In order to publish a new version of kepler.gl a developer must perform the following steps:
 
-1. Update **package.json** file with the new version value. Run `npm version major | minor | patch` to update version accordingly.
+1. Bump the version across all workspace packages and the root `package.json`:
+
+```bash
+yarn bump-version <new-version>
+# e.g. yarn bump-version 3.3.0
+```
+
+This updates `"version"` and all `@kepler.gl/*` cross-references in every `src/*/package.json` and in the root `package.json`.
+
 2. Update **CHANGELOG.md** with the latest commit changes. Print commits with `git log --pretty=oneline --abbrev-commit`
 3. Create a new PR for review.
 4. Once the PR is reviewed and merged, pull the latest changes locally.
@@ -401,10 +409,10 @@ In order to publish a new version of kepler.gl a developer must perform the foll
 
 **After Release is completed and pushed**
 
-- Update each of the example folder package.json kepler.gl dependency with the newer. To update all examples, run
+- Update each of the example folder `package.json` kepler.gl dependency with the new version. To update all examples, run:
 
 ```bash
-npm run example-version
+yarn example-version
 ```
 
 This step is required after the new version is published otherwise it would fail.

lerna.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "node_modules/lerna/schemas/lerna-schema.json",
+  "version": "3.3.0-alpha.4",
+  "packages": [
+    "src/*"
+  ],
+  "npmClient": "yarn",
+  "command": {
+    "version": {
+      "syncDistVersion": true,
+      "allowBranch": "**"
+    }
+  }
+}

package.json

@@ -1,7 +1,7 @@
 {
   "name": "kepler.gl",
   "author": "Shan He <shan@uber.com>",
-  "version": "3.3.0-alpha.3",
+  "version": "3.3.0-alpha.4",
   "description": "kepler.gl is a webgl based application to visualize large scale location data in the browser",
   "license": "MIT",
   "main": "dist/index.js",
@@ -93,7 +93,8 @@
     "deploy": "yarn install:web && cd website && yarn build",
     "clean": "rm -rf node_modules examples/**/node_modules website/node_modules .nyc_output coverage jest-coverage tape-coverage",
     "release:patch": "git add CHANGELOG.md && git commit -m 'updated CHANGELOG.md' && npm version patch && git push origin && git push origin --tags",
-    "fix-dependencies": "./scripts/fix-dependencies.sh"
+    "fix-dependencies": "./scripts/fix-dependencies.sh",
+    "bump-version": "node ./scripts/bump-version.js"
   },
   "files": [
     "dist",
@@ -102,7 +103,7 @@
   ],
   "dependencies": {
     "@deck.gl/mapbox": "^9.3.1",
-    "@kepler.gl/components": "3.3.0-alpha.3",
+    "@kepler.gl/components": "3.3.0-alpha.4",
     "@loaders.gl/polyfills": "^4.4.1",
     "@types/mapbox__geo-viewport": "^0.4.1",
     "html-webpack-plugin": "^5.6.3",
@@ -188,6 +189,7 @@
     "jest-environment-jsdom": "^29.5.0",
     "jsdom": "^24.1.1",
     "json-loader": "^0.5.4",
+    "lerna": "8",
     "mapbox-gl": "1.13.1",
     "maplibre-gl": "^4.0.0",
     "minimist": "^1.2.6",

scripts/bump-version.js

@@ -0,0 +1,48 @@
+// SPDX-License-Identifier: MIT
+// Copyright contributors to the kepler.gl project
+
+const {execSync} = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const repoRoot = path.resolve(__dirname, '..');
+const newVersion = process.argv[2];
+
+if (!newVersion) {
+  console.error('Usage: node scripts/bump-version.js <new-version>');
+  console.error('Example: node scripts/bump-version.js 3.3.0-alpha.4');
+  process.exit(1);
+}
+
+// Run lerna to bump all src/* workspace packages
+console.log(`\nBumping workspace packages to ${newVersion}...`);
+execSync(
+  `yarn lerna version ${newVersion} --no-git-tag-version --no-push --exact --yes --sync-dist-version --allow-branch '**'`,
+  {stdio: 'inherit', cwd: repoRoot}
+);
+
+// Update root package.json: version + any @kepler.gl/* dependency references
+const rootPkgPath = path.resolve(__dirname, '../package.json');
+const rootPkg = JSON.parse(fs.readFileSync(rootPkgPath, 'utf8'));
+const oldVersion = rootPkg.version;
+
+rootPkg.version = newVersion;
+
+const depFields = ['dependencies', 'devDependencies', 'peerDependencies', 'resolutions'];
+for (const field of depFields) {
+  if (!rootPkg[field]) continue;
+  for (const name of Object.keys(rootPkg[field])) {
+    if (name.startsWith('@kepler.gl/') && rootPkg[field][name] === oldVersion) {
+      rootPkg[field][name] = newVersion;
+    }
+  }
+}
+
+fs.writeFileSync(rootPkgPath, JSON.stringify(rootPkg, null, 2) + '\n');
+console.log(`Updated root package.json: ${oldVersion} => ${newVersion}`);
+
+// Re-run yarn install so the lockfile is properly resolved (Lerna's internal
+// lockfile sync creates imperfect entries for workspace packages; this cleans them up)
+console.log('\nRunning yarn install to clean up yarn.lock...');
+execSync('yarn install', {stdio: 'inherit', cwd: repoRoot});
+console.log('\nDone. Review the changes, then commit and push.');

src/actions/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kepler.gl/actions",
   "author": "Shan He <shan@uber.com>",
-  "version": "3.3.0-alpha.3",
+  "version": "3.3.0-alpha.4",
   "description": "kepler.gl constants used by kepler.gl components, actions and reducers",
   "license": "MIT",
   "main": "dist/index.js",
@@ -31,13 +31,13 @@
   ],
   "dependencies": {
     "@deck.gl/core": "^9.3.1",
-    "@kepler.gl/cloud-providers": "3.3.0-alpha.3",
-    "@kepler.gl/constants": "3.3.0-alpha.3",
-    "@kepler.gl/layers": "3.3.0-alpha.3",
-    "@kepler.gl/processors": "3.3.0-alpha.3",
-    "@kepler.gl/table": "3.3.0-alpha.3",
-    "@kepler.gl/types": "3.3.0-alpha.3",
-    "@kepler.gl/utils": "3.3.0-alpha.3",
+    "@kepler.gl/cloud-providers": "3.3.0-alpha.4",
+    "@kepler.gl/constants": "3.3.0-alpha.4",
+    "@kepler.gl/layers": "3.3.0-alpha.4",
+    "@kepler.gl/processors": "3.3.0-alpha.4",
+    "@kepler.gl/table": "3.3.0-alpha.4",
+    "@kepler.gl/types": "3.3.0-alpha.4",
+    "@kepler.gl/utils": "3.3.0-alpha.4",
     "@reduxjs/toolkit": "^1.7.2",
     "@types/lodash": "4.17.5",
     "@types/react-redux": "^7.1.23",

src/ai-assistant/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kepler.gl/ai-assistant",
   "author": "Xun Li<lixun910@gmail.com>",
-  "version": "3.3.0-alpha.3",
+  "version": "3.3.0-alpha.4",
   "description": "kepler.gl AI assistant",
   "license": "MIT",
   "main": "dist/index.js",
@@ -34,12 +34,12 @@
     "@ai-sdk/deepseek": "^0.2.14",
     "@ai-sdk/google": "^1.2.18",
     "@ai-sdk/xai": "^1.2.16",
-    "@kepler.gl/components": "3.3.0-alpha.3",
-    "@kepler.gl/constants": "3.3.0-alpha.3",
-    "@kepler.gl/layers": "3.3.0-alpha.3",
-    "@kepler.gl/table": "3.3.0-alpha.3",
-    "@kepler.gl/types": "3.3.0-alpha.3",
-    "@kepler.gl/utils": "3.3.0-alpha.3",
+    "@kepler.gl/components": "3.3.0-alpha.4",
+    "@kepler.gl/constants": "3.3.0-alpha.4",
+    "@kepler.gl/layers": "3.3.0-alpha.4",
+    "@kepler.gl/table": "3.3.0-alpha.4",
+    "@kepler.gl/types": "3.3.0-alpha.4",
+    "@kepler.gl/utils": "3.3.0-alpha.4",
     "@openassistant/core": "^0.5.17",
     "@openassistant/duckdb": "^0.5.17",
     "@openassistant/echarts": "^0.5.17",

src/cloud-providers/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kepler.gl/cloud-providers",
   "author": "Shan He <shan@uber.com>",
-  "version": "3.3.0-alpha.3",
+  "version": "3.3.0-alpha.4",
   "description": "kepler.gl constants used by kepler.gl components, actions and reducers",
   "license": "MIT",
   "main": "dist/index.js",
@@ -30,7 +30,7 @@
     "umd"
   ],
   "dependencies": {
-    "@kepler.gl/types": "3.3.0-alpha.3",
+    "@kepler.gl/types": "3.3.0-alpha.4",
     "react": "^19.0.0"
   },
   "nyc": {

src/common-utils/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kepler.gl/common-utils",
   "author": "Shan He <heshan0131@gmail.com>",
-  "version": "3.3.0-alpha.3",
+  "version": "3.3.0-alpha.4",
   "description": "kepler.gl common utils",
   "license": "MIT",
   "main": "dist/index.js",
@@ -30,8 +30,8 @@
     "umd"
   ],
   "dependencies": {
-    "@kepler.gl/constants": "3.3.0-alpha.3",
-    "@kepler.gl/types": "3.3.0-alpha.3",
+    "@kepler.gl/constants": "3.3.0-alpha.4",
+    "@kepler.gl/types": "3.3.0-alpha.4",
     "d3-array": "^2.8.0",
     "global": "^4.3.0",
     "h3-js": "^4.4.0",