Merge remote-tracking branch 'origin/main' into doc-prod

Author: camdecoster

.github/workflows/build-doc.yml

@@ -38,12 +38,9 @@ jobs:
 
 
       - name: Build HTML docs
-        env:
-          MAPBOX_TOKEN: ${{ secrets.MAPBOX_TOKEN }}
         run: |
           cd doc
           source .venv/bin/activate
-          echo "${MAPBOX_TOKEN}" > python/.mapbox_token
           make -kj8 || make -kj8
           curl https://raw.githubusercontent.com/plotly/graphing-library-docs/master/front-matter-ci.py > front-matter-ci.py
           curl https://raw.githubusercontent.com/plotly/graphing-library-docs/master/check-or-enforce-order.py > check-or-enforce-order.py

.github/workflows/check-codegen.yml

@@ -0,0 +1,46 @@
+name: Check Python codegen
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    types: [opened, reopened, synchronize]
+
+jobs:
+  check-python-codegen:
+    name: Check Python codegen
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
+    - name: Set up Python
+      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
+      with:
+        python-version: "3.x"
+
+    - name: Set up uv
+      uses: astral-sh/setup-uv@cec208311dfd045dd5311c1add060b2062131d57  # v8.0.0
+
+    - name: Install dependencies
+      run: |
+        uv venv
+        source .venv/bin/activate
+        uv lock --check
+        uv sync --extra dev_codegen
+    - name: Run codegen
+      run: |
+        source .venv/bin/activate
+        python commands.py codegen
+    - name: Check for changes
+      run: |
+        # Fail if codegen produced any changes to the working directory.
+        # This means the committed generated files are out of date and codegen
+        # needs to be re-run locally and the results committed.
+        if [ -n "$(git status --porcelain)" ]; then
+          echo "::error::Generated files are out of date. Please run 'python commands.py codegen' locally and commit the result."
+          echo "The following files differ after running codegen:"
+          git status --porcelain
+          echo ""
+          exit 1
+        fi
+        echo "Generated files are up to date."

.github/workflows/check-js-build.yml

@@ -49,7 +49,9 @@ jobs:
       run: |
         uv venv
         source .venv/bin/activate
-        uv pip install jupyterlab
+        # Technically, we only need the `jupyter-builder` package, but using the dev_build extra
+        # keeps build behavior consistent across all CI jobs
+        uv sync --extra dev_build
         cd js
         npm ci
         npm run build

.github/workflows/run-pytest.yml

@@ -135,7 +135,7 @@ jobs:
           python -m pytest -x test_init/test_lazy_imports.py
 
   test-kaleido-v0:
-    name: Optional tests (Kaleido only), Kaleido v0 (Python 3.12, kaleido 0.2.1)
+    name: Kaleido v0 RuntimeError verification (Python 3.12, kaleido 0.2.1)
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
@@ -157,7 +157,7 @@ jobs:
           uv pip uninstall kaleido
           uv pip install kaleido==0.2.1
           python --version
-      - name: Test plotly.io image output with Kaleido v0
+      - name: Test that plotly.io raises correct error with Kaleido v0
         run: |
           source .venv/bin/activate
-          python -m pytest tests/test_optional/test_kaleido
+          python -m pytest tests/test_optional/test_kaleido/test_kaleido_v0_error.py

.gitignore

@@ -1,7 +1,6 @@
 0
 0.html
 iframe_figures/
-tests/test_orca/images/linux/failed/
 
 *.egg-info
 
@@ -49,13 +48,10 @@ plotly.egg-info/
 # macOS utility file
 **/.DS_Store
 
-tests/test_orca/images/*/failed
-tests/test_orca/images/*/tmp
 tests/test_core/test_offline/plotly.min.js
 temp-plot.html
 .vscode
 doc/python/.ipynb_checkpoints
-doc/python/.mapbox_token
 doc/.ipynb_checkpoints
 tags
 doc/check-or-enforce-order.py

CHANGELOG.md

@@ -5,6 +5,69 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 ## Unreleased
 
 
+## [7.0.0] - 2026-08-25
+
+### Fixed
+- Fix `hex_to_rgb` parsing of 3-digit shorthand hexadecimal colors such as `#FFF` [[#5662](https://github.com/plotly/plotly.py/pull/5662)], with thanks to @genrichez for the contribution!
+- Improve `px.*_map()` auto-fitting behavior when `zoom` and `center` are not specified [[#5686](https://github.com/plotly/plotly.py/pull/5686)]
+- Add `<!doctype html>` to the `to_html()` template to comply with modern web standards [[#5693](https://github.com/plotly/plotly.py/pull/5693)], with thanks to @mishrakushal for the contribution!
+- Apply `histfunc`/`z` aggregation to `marginal_x`/`marginal_y="histogram"` subplots in `density_heatmap`/`density_contour`, instead of always showing raw bin counts [[#3521](https://github.com/plotly/plotly.py/issues/3521)], with thanks to @lucasjamar for the contribution!
+- Fix `mpl_to_plotly` silently dropping matplotlib path collections in data coordinates (such as violin plots, pcolor, event plots, stack plots, fill_between, and stem plots) by rendering them as filled polygons or lines [[#5702](https://github.com/plotly/plotly.py/pull/5702)], with thanks to @robertoffmoura for the contribution!
+
+### Updated
+- Update plotly.js from version 3.6.0 to version 4.0.0 [[#5673](https://github.com/plotly/plotly.py/pull/5673)]. This is a major-version release with many changes. See the [plotly.js release notes](https://github.com/plotly/plotly.js/releases/tag/v4.0.0) for the full list. The most significant changes include:
+  - Add `quiver` trace type to visualize vector fields using arrows [[#7710](https://github.com/plotly/plotly.js/pull/7710), [#7945](https://github.com/plotly/plotly.js/issues/7945)]
+  - Add "Share Chart" modebar button for generating a chart-sharing link via Plotly Cloud [[#7909](https://github.com/plotly/plotly.js/pull/7909)]
+  - Remove `scattermapbox`, `choroplethmapbox`, `densitymapbox` trace types, the `mapbox` subplot, and the `mapboxAccessToken` config option [[#7860](https://github.com/plotly/plotly.js/pull/7860)]. Use the equivalent `*map` traces instead.
+    - The corresponding `graph_objects` and Plotly Express functions have also been removed in plotly.py; use the `map` versions instead
+  - Drop support for MathJax v2, and add support for v4 [[#7898](https://github.com/plotly/plotly.js/pull/7898)]. MathJax is the JavaScript library used for rendering mathematical equations in plotly charts.
+  - Switch color processing library from [TinyColor](https://github.com/bgrins/TinyColor) to [culori](https://culorijs.org) [[#7536](https://github.com/plotly/plotly.js/pull/7536), [#7962](https://github.com/plotly/plotly.js/pull/7962)]. There are some changes to supported color string formats as a result:
+    - `rgb()`/`rgba()` strings with decimal 0–1 fractions are no longer supported
+    - `hsv()` color strings are no longer supported
+    - Strings with invalid syntax such as `hsl(120, 50% 50%)` are no longer supported
+    - New supported formats: `'#ff0000aa'`, `'#f00a'`, `'rgb(255 0 0)'`, `'rgba(255 0 0 / 0.5)'`, `'hsl(0 100% 50% / 0.5)'`, `'hsla(0, 100%, 50%, 0.5)'`, `'hwb(0 0% 0%)'`, `lab()`, `lch()`, `oklab()`, `oklch()`, `color()`, `hsl(0.5turn 60% 40%)`, `hsl(none 60% 40%)`
+  - Replace `country-regex` with `country-iso-search` to search for country names in choropleth, scattergeo traces [[#7856](https://github.com/plotly/plotly.js/pull/7856)]. Most country names are handled exactly the same; a small number of legacy entries have been removed.
+  - Change `layout.geo.fitbounds` default from `false` to `'locations'` [[#7895](https://github.com/plotly/plotly.js/pull/7895)]. `geo` subplots will now auto-fit the initial view to the trace data by default.
+  - Dynamically compute `center` and `zoom` values for `scattermap` and `densitymap` traces. The initial map view will now auto-fit to the trace data by default. Add `layout.map.fitbounds` attribute (default `'locations'`) to enable or disable auto-fitting behavior [[#7884](https://github.com/plotly/plotly.js/pull/7884), [#7913](https://github.com/plotly/plotly.js/pull/7913)]
+  - Fix GeoJSON bounding-box computation for `choropleth` and `scattergeo` traces whose geometry crosses the antimeridian [[#7891](https://github.com/plotly/plotly.js/pull/7891)]
+
+## [7.0.0rc0] - 2026-07-29
+
+### Removed
+- Remove the deprecated Figure Factory functions `create_2d_density`, `create_annotated_heatmap`, `create_bullet`, `create_candlestick`, `create_choropleth`, `create_distplot`, `create_facet_grid`, `create_gantt`, `create_hexbin_mapbox`, `create_ohlc`, `create_scatterplotmatrix`, and `create_violin` [[#5627](https://github.com/plotly/plotly.py/pull/5627)]
+- Remove support for Kaleido versions less than v1.0.0 for static image generation [[#5677](https://github.com/plotly/plotly.py/pull/5677)]
+- Remove support for Orca for static image generation [[#5677](https://github.com/plotly/plotly.py/pull/5677)]
+- Remove `engine` argument from functions `fig.write_image()`,`fig.to_image()`, `pio.write_image()`, `pio.write_images()`, `pio.to_image()`, `pio.full_figure_for_development()`, and from renderer constructors [[#5677](https://github.com/plotly/plotly.py/pull/5677)]
+
+### Updated
+- Update plotly.js from version 3.6.0 to version 4.0.0-rc.0 [[#5673](https://github.com/plotly/plotly.py/pull/5673)]. This is a major-version release candidate with many changes. See the [plotly.js release notes](https://github.com/plotly/plotly.js/releases/tag/v4.0.0-rc.0) for the full list. The most significant changes include:
+  - Add `quiver` trace type to visualize vector fields using arrows [[#7710](https://github.com/plotly/plotly.js/pull/7710)]
+  - Add "Share Chart" modebar button for generating a chart-sharing link via Plotly Cloud [[#7909](https://github.com/plotly/plotly.js/pull/7909)]
+  - Remove `scattermapbox`, `choroplethmapbox`, `densitymapbox` trace types, the `mapbox` subplot, and the `mapboxAccessToken` config option [[#7860](https://github.com/plotly/plotly.js/pull/7860)]. Use the equivalent `*map` traces instead.
+    - The corresponding `graph_objects` and Plotly Express functions have also been removed in plotly.py; use the `map` versions instead
+  - Drop support for MathJax v2, and add support for v4 [[#7898](https://github.com/plotly/plotly.js/pull/7898)]. MathJax is the JavaScript library used for rendering mathematical equations in plotly charts.
+  - Switch color processing library from [TinyColor](https://github.com/bgrins/TinyColor) to [color](https://github.com/Qix-/color) [[#7536](https://github.com/plotly/plotly.js/pull/7536)]. There are some changes to supported color string formats as a result:
+    - `rgb()`/`rgba()` strings with decimal 0–1 fractions are no longer supported
+    - `hsv()` color strings are no longer supported
+    - New supported formats: `'#ff0000aa'`, `'#f00a'`, `'rgb(255 0 0)'`, `'rgba(255 0 0 / 0.5)'`, `'hsl(0 100% 50% / 0.5)'`, `'hsla(0, 100%, 50%, 0.5)'`, `'hwb(0, 0%, 0%)'` 
+  - Replace `country-regex` with `country-iso-search` to search for country names in choropleth, scattergeo traces [[#7856](https://github.com/plotly/plotly.js/pull/7856)]. Most country names are handled exactly the same; a small number of legacy entries have been removed.
+  - Change `layout.geo.fitbounds` default from `false` to `'locations'` [[#7895](https://github.com/plotly/plotly.js/pull/7895)]. `geo` subplots will now auto-fit the initial view to the trace data by default.
+  - Dynamically compute `center` and `zoom` values for `scattermap` and `densitymap` traces. The initial map view will now auto-fit to the trace data by default. Add `layout.map.fitbounds` attribute (default `'locations'`) to enable or disable auto-fitting behavior [[#7884](https://github.com/plotly/plotly.js/pull/7884), [#7913](https://github.com/plotly/plotly.js/pull/7913)]
+  - Fix GeoJSON bounding-box computation for `choropleth` and `scattergeo` traces whose geometry crosses the antimeridian [[#7891](https://github.com/plotly/plotly.js/pull/7891)]
+
+## [6.9.0] - 2026-07-09
+
+### Fixed
+- Raise a clear `ValueError` when an unsupported marginal plot type is passed to Plotly Express, instead of failing later with a cryptic `'NoneType' object has no attribute 'constructor'` message [[#5625](https://github.com/plotly/plotly.py/pull/5625)], with thanks to @eugen-goebel for the contribution!
+- Read and write figure JSON files as UTF-8 in `read_json`/`write_json` so figures containing non-ASCII text are handled correctly on platforms whose default encoding is not UTF-8 (e.g. cp1252 on Windows) [[#5633](https://github.com/plotly/plotly.py/pull/5633)]
+
+
+### Updated
+- Update plotly.js from version 3.6.0 to version 3.7.0. See the plotly.js [release notes](https://github.com/plotly/plotly.js/releases/tag/v3.7.0) for more information [[#5639](https://github.com/plotly/plotly.py/pull/5639)]. Notable changes include:
+  - Rename `sendDataToCloud` modebar button to `sendChartToCloud`, and update to upload chart to Plotly Cloud [[#7802](https://github.com/plotly/plotly.js/pull/7802), [#7852](https://github.com/plotly/plotly.js/pull/7852), [#7854](https://github.com/plotly/plotly.js/pull/7854)]
+  - Fix stale `scattergl` error bars after toggling traces with mixed error bar visibility [[#7773](https://github.com/plotly/plotly.js/issues/7773)]
+  - Fix geo `fitbounds` to choose a compact longitude range when point data straddles the antimeridian [[#7837](https://github.com/plotly/plotly.js/pull/7837)]
+
 ## [6.8.0] - 2026-06-03
 
 ### Added
@@ -186,7 +249,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
   - Drop deprecated `zauto`, `zmin` and `zmax` from the surface trace [[#7234](https://github.com/plotly/plotly.js/pull/7234)]
   - Drop deprecated `autotick` attributes from cartesian axes [[#7236](https://github.com/plotly/plotly.js/pull/7236)]
   - Drop `transforms` from the API [[#7240](https://github.com/plotly/plotly.js/pull/7240), [#7254](https://github.com/plotly/plotly.js/pull/7254)]
-- Deprecate Mapbox-based traces.[[#4900](https://github.com/plotly/plotly.py/pull/4900)]. See the [MapLibre Migration](https://plotly.com/python/mapbox-to-maplibre/) page for details on migrating from Mapbox to Maplibre.
+- Deprecate Mapbox-based traces.[[#4900](https://github.com/plotly/plotly.py/pull/4900)]. See the [MapLibre Migration](https://plotly.com/python/mapbox-to-maplibre/) page for details on migrating from Mapbox to MapLibre.
 - Update plotly.py to use base64 encoding of typed arrays e.g. numpy in plotly JSON to keep precision intact and improve performance [[#4470](https://github.com/plotly/plotly.py/pull/4470)].
 - Make plotly-express dataframe agnostic via Narwhals [[#4790](https://github.com/plotly/plotly.py/pull/4790)].
 - Update `go.FigureWidget` to use `anywidget` [[#4823](https://github.com/plotly/plotly.py/pull/4823)]

CITATION.cff

@@ -9,7 +9,7 @@ authors:
 - family-names: "Parmer"
   given-names: "Chris"
 title: "An interactive, open-source, and browser-based graphing library for Python"
-version: 6.8.0
+version: 7.0.0
 doi: 10.5281/zenodo.14503524
-date-released: 2026-06-03
+date-released: 2026-08-25
 url: "https://github.com/plotly/plotly.py"

CONTRIBUTING.md

@@ -67,7 +67,7 @@ you can do it directly on GitHub by clicking on the "Edit this page on GitHub" l
 
 We use Git and GitHub to manage our project;
 if you are not familiar with them,
-there are great resources like <http://try.github.io/> to get you started.
+there are great resources like <https://try.github.io/> to get you started.
 
 The first step is to [fork the repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo) on GitHub
 so that you have your own copy to work with.
@@ -99,7 +99,7 @@ source .venv/bin/activate
 
 Alternatively,
 you can use [conda](https://docs.conda.io/projects/conda/en/latest/user-guide/tasks/manage-environments.html#creating-an-environment-with-commands)
-or [virtualenv](http://docs.python-guide.org/en/latest/dev/virtualenvs/)
+or [virtualenv](https://docs.python-guide.org/en/latest/dev/virtualenvs/)
 to create and manage your virtual environment;
 see those tools' documentation for more information.
 
@@ -251,7 +251,7 @@ Two kinds of Jupyter support are included:
     which allows us to avoid embedding `plotly.js` in the notebook output.
     The JupyterLab extension source code is located at `js/src/mimeExtension.ts`
     and the compiled extension code is located at `plotly/labextension` in the built Python package.
-    The command `jupyter labextension build` (which is one of the steps called by `npm run build`) compiles the extension
+    The command `jupyter-builder build` (which is one of the steps called by `npm run build`) compiles the extension
     and places the build artifacts in `plotly/labextension`. 
 
 2.  **FigureWidget**:
@@ -273,22 +273,30 @@ python commands.py updateplotlyjs
 ```
 
 This downloads new versions of `plot-schema.json` and `plotly.min.js` from the `plotly/plotly.js` GitHub repository
-and places them in `plotly/package_data`.
-It then regenerates all of the `graph_objs` classes based on the new schema,
-and finally runs `npm install` in `js/` to refresh `js/package-lock.json` against the new `plotly.js`.
-Commit the updated `js/package-lock.json` along with the regenerated files.
-
-The JupyterLab extension and FigureWidget bundles in `plotly/labextension` and `plotly/package_data/widgetbundle.js`
-are rebuilt as part of the release flow (see [RELEASE.md](RELEASE.md)) rather than on every plotly.js bump.
-
-If you need to skip the `npm install` step entirely (e.g. `npm` isn't available),
+and places them in `codegen/resources/` and `plotly/package_data/`, respectively.
+
+It then does the following:
+ - Regenerates all of the `graph_objs` classes based on the new schema
+ - Runs `npm install` in `js/` to refresh `js/package-lock.json` against the new `plotly.js`
+ - Runs `npm run build` to rebuild the JupyterLab extension and FigureWidget bundles in `plotly/labextension` and `plotly/package_data/widgetbundle.js`.
+
+Commit the updated files under:
+ - `codegen/resources/`
+ - `js/`
+ - `plotly/graph_objs/`
+ - `plotly/labextension/`
+ - `plotly/offline/`
+ - `plotly/package_data/`
+
+If you need to skip the `npm` steps entirely (e.g. `npm` isn't available),
 set the `SKIP_NPM=1` environment variable:
 
 ```bash
 SKIP_NPM=1 python commands.py updateplotlyjs
 ```
 
-If you do skip it, you'll need to run `npm install` in `js/` yourself before committing so the lockfile stays in sync.
+If you do skip it, you'll need to find a way to manually run `npm install && npm run build` in `js/` before committing,
+so that the lockfile and build artifacts stay in sync with `js/package.json`.
 
 ### Using a Development Branch of Plotly.js
 
@@ -301,7 +309,7 @@ python commands.py updateplotlyjsdev --devrepo reponame --devbranch branchname
 
 This fetches the `plotly.js` in the CircleCI artifact of the branch `branchname` of the repo `reponame`.
 If `--devrepo` or `--devbranch` are omitted,
-`updateplotlyjsdev` defaults to `plotly/plotly.js` and `master` respectively.
+`updateplotlyjsdev` defaults to `plotly/plotly.js` and `main` respectively.
 
 ### Local Repository