Merge remote-tracking branch 'origin/master' into v4.0

Author: camdecoster

.github/workflows/ci.yml

@@ -23,6 +23,7 @@ jobs:
     outputs:
       stackgl_modules: ${{ steps.check.outputs.stackgl_modules }}
       topojson: ${{ steps.check.outputs.topojson }}
+      regl_codegen: ${{ steps.check.outputs.regl_codegen }}
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
         with:
@@ -42,6 +43,12 @@ jobs:
           if git diff --name-only "$BASE"...HEAD -- stackgl_modules/ | grep -q .; then
             echo "stackgl_modules=true" >> "$GITHUB_OUTPUT"
           fi
+          # If any of the directories listed below have changed, we need to re-run the regl-codegen step
+          # stackgl_modules/ is listed here too because the regl-* shader libs live there;
+          # changes can alter shader output and require regenerating the precompiled shaders.
+          if git diff --name-only "$BASE"...HEAD -- src/traces/scattergl/ src/traces/scatterpolargl/ src/traces/splom/ src/traces/parcoords/ src/lib/prepare_regl.js stackgl_modules/ devtools/regl_codegen/ | grep -q .; then
+            echo "regl_codegen=true" >> "$GITHUB_OUTPUT"
+          fi
 
   # ============================================================
   # Root build job - all dependent jobs fan out from here
@@ -636,3 +643,54 @@ jobs:
           name: topojson-dist
           retention-days: 7
           path: topojson/dist/
+
+  check-regl-codegen:
+    needs: [detect-changes, install-and-cibuild]
+    if: >-
+      (github.event_name == 'push' && github.ref_name == github.event.repository.default_branch) ||
+      needs.detect-changes.outputs.regl_codegen == 'true'
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6
+      - uses: ./.github/actions/setup-workspace
+      - uses: ./.github/actions/setup-chrome
+
+      - name: Run regl codegen
+        run: |
+          # Wipe the codegen output dir so orphaned shader files surface as deletions in the diff below.
+          rm -rf src/generated/regl-codegen/*
+          node devtools/regl_codegen/server.mjs &
+          SERVER_PID=$!
+          until curl -sf -o /dev/null http://localhost:3000/build/regl_codegen-bundle.js 2>/dev/null; do
+            sleep 1
+          done
+          $CHROME_BIN --headless=new --no-sandbox --enable-unsafe-swiftshader --ignore-gpu-blocklist http://localhost:3000/devtools/regl_codegen/index.html &
+          wait $SERVER_PID
+
+      - name: Check regl precompiled shaders are up to date
+        run: |
+          # git add -N so newly-generated (untracked) shader files show up in git diff
+          git add -N src/generated/regl-codegen/
+          if ! git diff --exit-code \
+              src/generated/regl-codegen/ \
+              src/traces/scattergl/regl_precompiled.js \
+              src/traces/scatterpolargl/regl_precompiled.js \
+              src/traces/splom/regl_precompiled.js \
+              src/traces/parcoords/regl_precompiled.js; then
+            echo "::error::Regl precompiled shaders are out of date. Download the 'regl-codegen' artifact from this workflow run, extract it into src/, and commit the updated files to this pull request."
+            exit 1
+          fi
+
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7
+        name: Upload updated regl codegen files
+        if: failure()
+        with:
+          name: regl-codegen
+          retention-days: 7
+          path: |
+            src/generated/regl-codegen/
+            src/traces/scattergl/regl_precompiled.js
+            src/traces/scatterpolargl/regl_precompiled.js
+            src/traces/splom/regl_precompiled.js
+            src/traces/parcoords/regl_precompiled.js

.github/workflows/upload-dev-build.yml

@@ -39,7 +39,7 @@ jobs:
           GH_TOKEN: ${{ github.token }}
           GH_EVENT_NAME: ${{ github.event_name }}
           GH_REPO: ${{ github.repository }}
-          SHA: ${{ github.event.workflow_run.sha }}
+          SHA: ${{ github.event.workflow_run.head_sha }}
           RUN_ID: ${{ github.event.workflow_run.id }}
           PR_NUM: ${{ github.event.workflow_run.pull_requests[0].number || inputs.pr_number }}
         run: |

CHANGELOG.md

@@ -9,6 +9,20 @@ To see all merged commits on the master branch that will be part of the next plo
 
 where X.Y.Z is the semver of most recent plotly.js release.
 
+## [3.6.0] -- 2026-06-01
+
+### Added
+- Add support for arrays for the pie property `legendrank`, so that it can be configured per slice [[#7723](https://github.com/plotly/plotly.js/pull/7723)], with thanks to @my-tien for the contribution!
+- Add `hoversort` layout attribute to sort unified hover label items by value [[#7734](https://github.com/plotly/plotly.js/pull/7734)], with thanks to @kimsehwan96 for the contribution!
+
+### Fixed
+- Fix unexpected `ticklabelindex` behavior when minor ticks are not shown [[#7735](https://github.com/plotly/plotly.js/pull/7735)], with thanks to @my-tien for the contribution!
+- Fix issue where `hoveranywhere` / `clickanywhere` would not emit hover and click events over editable shapes [[#7788](https://github.com/plotly/plotly.js/pull/7788)]
+- Handle 'pixel' size mode for shape labels [[#7790](https://github.com/plotly/plotly.js/pull/7790)]
+- Update box plot defaults to fix issue with calling `Plotly.react` to switch from box to violin plot [[#7811](https://github.com/plotly/plotly.js/pull/7811)]
+- Include shapes with `legendgroup` specified when handling legend visibility toggling [[#7813](https://github.com/plotly/plotly.js/pull/7813)]
+
+
 ## [3.5.1] -- 2026-05-01
 
 ### Changed

CITATION.cff

@@ -9,7 +9,7 @@ authors:
 - family-names: "Samimi"
   given-names: "Mojtaba"
 title: "Open source Plotly charting library"
-version: 3.5.1
+version: 3.6.0
 doi: 10.5281/zenodo.13964707
-date-released: 2026-05-01
+date-released: 2026-06-01
 url: "https://github.com/plotly/plotly.js"

CONTRIBUTING.md

@@ -163,19 +163,54 @@ npm run schema
 #### Step 9: REGL - Review & commit potential changes to precompiled regl shaders
 
 If you are implementing a new feature that involves regl shaders, or if you are
-making changes that affect the usage of regl shaders, you would need to run
+making changes that affect the usage of regl shaders, you will need to regenerate the precompiled regl shader code. In practice, that means edits under:
 
-```bash
-npm run regl-codegen
-```
+- `src/traces/{scattergl,scatterpolargl,splom,parcoords}/`
+- `src/lib/prepare_regl.js`
+- `stackgl_modules/` (where the `regl-*` shader libs live)
+- `devtools/regl_codegen/`
 
-to regenerate the regl code. This will prompt you to open a browser window. This will then run through all
-traces with 'regl' in the tags, and store the captured code into 
-[src/generated/regl-codegen](https://github.com/plotly/plotly.js/blob/master/src/generated/regl-codegen). If no updates are necessary, it will be a no-op, but if there are changes, you will need to commit them.
+CI's `check-regl-codegen` job uses this same list as its trigger — see [`.github/workflows/ci.yml`](.github/workflows/ci.yml) for the authoritative version.
 
 This is needed because regl performs codegen in runtime which breaks CSP
 compliance, and so for strict builds we pre-generate regl shader code here.
 
+The CI pipeline will automatically detect when regl-related files have changed and
+run the codegen process. If the precompiled shaders are out of date, the
+`check-regl-codegen` job will fail and upload a `regl-codegen` artifact containing
+the updated files. The artifact represents the full desired state of the codegen
+output (CI wipes the output directory before regenerating, so any orphaned shader
+files are pruned). To fix this:
+
+1. Download the `regl-codegen` artifact from the failed workflow run
+2. Delete `src/generated/regl-codegen/` in your working tree, then unzip the
+   artifact into `src/` so it replaces (rather than merges into) the existing
+   directory. Note that `actions/upload-artifact` strips the longest common
+   parent path from the uploaded paths, so the zip's root contains
+   `generated/regl-codegen/` and `traces/{scattergl,scatterpolargl,splom,parcoords}/regl_precompiled.js`
+   directly — extracting into `src/` restores the correct layout and
+   overwrites the four `regl_precompiled.js` files in one step.
+3. Commit and push the changes to your pull request
+
+Alternatively, you can regenerate the code locally:
+
+```bash
+rm -rf src/generated/regl-codegen/*
+npm run regl-codegen
+```
+
+The `rm -rf` step is needed to clean up any orphaned shader files left over from
+previous changes. `npm run regl-codegen` will prompt you to open
+a browser window, run through the mocks for each regl-using trace
+(`parcoords`, `scattergl`, `scatterpolargl`, `splom`), and store the captured
+shader code into
+[src/generated/regl-codegen](https://github.com/plotly/plotly.js/blob/master/src/generated/regl-codegen).
+The four `src/traces/{parcoords,scattergl,scatterpolargl,splom}/regl_precompiled.js`
+files are rewritten in the same pass so their imports point at the freshly
+generated shader files. Commit any changes that result — both the
+`src/generated/regl-codegen/` updates and any modified `regl_precompiled.js`
+files.
+
 #### Other npm scripts that may be of interest in development
 
 - `npm run preprocess`: pre-processes the css and svg source file in js. This

README.md

@@ -62,7 +62,7 @@ You may also consider using [`plotly.js-dist`](https://www.npmjs.com/package/plo
 
 ```html
 <head>
-    <script src="https://cdn.plot.ly/plotly-3.5.1.min.js" charset="utf-8"></script>
+    <script src="https://cdn.plot.ly/plotly-3.6.0.min.js" charset="utf-8"></script>
 </head>
 <body>
     <div id="gd"></div>
@@ -79,7 +79,7 @@ You may also consider using [`plotly.js-dist`](https://www.npmjs.com/package/plo
 Alternatively, you may consider using [native ES6 import](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) in the script tag.
 ```html
 <script type="module">
-    import "https://cdn.plot.ly/plotly-3.5.1.min.js"
+    import "https://cdn.plot.ly/plotly-3.6.0.min.js"
     Plotly.newPlot("gd", [{ y: [1, 2, 3] }])
 </script>
 ```
@@ -89,7 +89,7 @@ Fastly supports Plotly.js with free CDN service. Read more at <https://www.fastl
 ### Un-minified versions are also available on CDN
 While non-minified source files may contain characters outside UTF-8, it is recommended that you specify the `charset` when loading those bundles.
 ```html
-<script src="https://cdn.plot.ly/plotly-3.5.1.js" charset="utf-8"></script>
+<script src="https://cdn.plot.ly/plotly-3.6.0.js" charset="utf-8"></script>
 ```
 
 > Please note that as of v2 the "plotly-latest" outputs (e.g. https://cdn.plot.ly/plotly-latest.min.js) will no longer be updated on the CDN, and will stay at the last v1 patch v1.58.5. Therefore, to use the CDN with plotly.js v2 and higher, you must specify an exact plotly.js version.

devtools/regl_codegen/server.mjs

@@ -85,16 +85,20 @@ function handleCodegen(data) {
     var exports = ['', '/* eslint-disable quote-props */', 'module.exports = {', ''].join('\n');
     var varId = 0;
 
-    Object.entries(generated).forEach(function (kv) {
-        var key = kv[0];
-        var value = kv[1];
-        var filePath = path.join(pathToReglCodegenSrc, key);
-        fs.writeFileSync(filePath, 'module.exports = ' + value);
-
-        imports += 'var v' + varId + " = require('../../" + path.join(constants.reglCodegenSubdir, key) + "');\n";
-        exports += "    '" + key + "': v" + varId + ',\n';
-        varId++;
-    });
+    // Sort by shader-hash key so the emitted import/export order is deterministic
+    // across machines (fs.readdir mock order varies by OS/filesystem, which would
+    // otherwise leak into regl_precompiled.js).
+    Object.keys(generated)
+        .sort()
+        .forEach((key) => {
+            var value = generated[key];
+            var filePath = path.join(pathToReglCodegenSrc, key);
+            fs.writeFileSync(filePath, 'module.exports = ' + value);
+
+            imports += 'var v' + varId + " = require('../../" + path.join(constants.reglCodegenSubdir, key) + "');\n";
+            exports += "    '" + key + "': v" + varId + ',\n';
+            varId++;
+        });
 
     if (varId > 0) {
         exports = exports.slice(0, -2) + '\n};\n';

dist/README.md

@@ -46,9 +46,9 @@ The main plotly.js bundles weight in at:
 | 10.7 MB | 4.6 MB | 1.4 MB | 11 MB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-3.5.1.js
+> https://cdn.plot.ly/plotly-3.6.0.js
 
-> https://cdn.plot.ly/plotly-3.5.1.min.js
+> https://cdn.plot.ly/plotly-3.6.0.min.js
 
 
 #### npm packages
@@ -91,12 +91,12 @@ The `basic` partial bundle contains trace modules `bar`, `pie` and `scatter`.
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 2.7 MB | 1.1 MB | 364.8 kB |
+| 2.7 MB | 1.1 MB | 365.3 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-basic-3.5.1.js
+> https://cdn.plot.ly/plotly-basic-3.6.0.js
 
-> https://cdn.plot.ly/plotly-basic-3.5.1.min.js
+> https://cdn.plot.ly/plotly-basic-3.6.0.min.js
 
 
 #### npm packages
@@ -114,12 +114,12 @@ The `cartesian` partial bundle contains trace modules `bar`, `box`, `contour`, `
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 3.4 MB | 1.4 MB | 463 kB |
+| 3.4 MB | 1.4 MB | 463.5 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-cartesian-3.5.1.js
+> https://cdn.plot.ly/plotly-cartesian-3.6.0.js
 
-> https://cdn.plot.ly/plotly-cartesian-3.5.1.min.js
+> https://cdn.plot.ly/plotly-cartesian-3.6.0.min.js
 
 
 #### npm packages
@@ -137,12 +137,12 @@ The `geo` partial bundle contains trace modules `choropleth`, `scatter` and `sca
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 3 MB | 1.2 MB | 415.2 kB |
+| 3 MB | 1.2 MB | 415.7 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-geo-3.5.1.js
+> https://cdn.plot.ly/plotly-geo-3.6.0.js
 
-> https://cdn.plot.ly/plotly-geo-3.5.1.min.js
+> https://cdn.plot.ly/plotly-geo-3.6.0.min.js
 
 
 #### npm packages
@@ -160,12 +160,12 @@ The `gl3d` partial bundle contains trace modules `cone`, `isosurface`, `mesh3d`,
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 4.2 MB | 1.6 MB | 527.4 kB |
+| 4.2 MB | 1.6 MB | 527.9 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-gl3d-3.5.1.js
+> https://cdn.plot.ly/plotly-gl3d-3.6.0.js
 
-> https://cdn.plot.ly/plotly-gl3d-3.5.1.min.js
+> https://cdn.plot.ly/plotly-gl3d-3.6.0.min.js
 
 
 #### npm packages
@@ -183,12 +183,12 @@ The `gl2d` partial bundle contains trace modules `parcoords`, `scatter`, `scatte
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 3.8 MB | 1.5 MB | 521.2 kB |
+| 3.8 MB | 1.5 MB | 521.8 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-gl2d-3.5.1.js
+> https://cdn.plot.ly/plotly-gl2d-3.6.0.js
 
-> https://cdn.plot.ly/plotly-gl2d-3.5.1.min.js
+> https://cdn.plot.ly/plotly-gl2d-3.6.0.min.js
 
 
 #### npm packages
@@ -206,12 +206,12 @@ The `mapbox` partial bundle contains trace modules `choroplethmapbox`, `densitym
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 4.5 MB | 1.9 MB | 580.1 kB |
+| 4.5 MB | 1.9 MB | 580.7 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-mapbox-3.5.1.js
+> https://cdn.plot.ly/plotly-mapbox-3.6.0.js
 
-> https://cdn.plot.ly/plotly-mapbox-3.5.1.min.js
+> https://cdn.plot.ly/plotly-mapbox-3.6.0.min.js
 
 
 #### npm packages
@@ -229,12 +229,12 @@ The `finance` partial bundle contains trace modules `bar`, `candlestick`, `funne
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 2.9 MB | 1.2 MB | 398.5 kB |
+| 2.9 MB | 1.2 MB | 398.9 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-finance-3.5.1.js
+> https://cdn.plot.ly/plotly-finance-3.6.0.js
 
-> https://cdn.plot.ly/plotly-finance-3.5.1.min.js
+> https://cdn.plot.ly/plotly-finance-3.6.0.min.js
 
 
 #### npm packages
@@ -255,9 +255,9 @@ The `strict` partial bundle contains trace modules `bar`, `barpolar`, `box`, `ca
 | 11.5 MB | 4.9 MB | 1.5 MB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-strict-3.5.1.js
+> https://cdn.plot.ly/plotly-strict-3.6.0.js
 
-> https://cdn.plot.ly/plotly-strict-3.5.1.min.js
+> https://cdn.plot.ly/plotly-strict-3.6.0.min.js
 
 
 #### npm packages