Merge branch 'main' into v7.0

Author: emilykl

CHANGELOG.md

@@ -13,8 +13,22 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - 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)]
 
+### 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!
+
+
+## [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)]. NOTE: The Plotly Cloud endpoint for receiving charts is not yet functional, so this button won't complete the upload.
+  - Fix stale `scattergl` error bars after toggling traces with mixed error bar visibility [[#7773](https://github.com/plotly/plotly.js/issues/7773)], with thanks to @JulienIcon for the contribution!
+  - Fix geo `fitbounds` to choose a compact longitude range when point data straddles the antimeridian [[#7837](https://github.com/plotly/plotly.js/pull/7837)], with thanks to @SharadhNaidu for the contribution!
 
 ### 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:

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: 6.9.0
 doi: 10.5281/zenodo.14503524
-date-released: 2026-06-03
+date-released: 2026-07-09
 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.
 
@@ -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
 

_plotly_utils/colors/__init__.py

@@ -752,11 +752,20 @@ def hex_to_rgb(value):
     """
     Calculates rgb values from a hex color code.
 
-    :param (string) value: Hex color string
+    :param (string) value: Hex color string. May be a full 6-character code
+        or a 3-character shorthand code.
 
     :rtype (tuple) (r_value, g_value, b_value): tuple of rgb values
+
+    Example:
+
+        '#FFFFFF' --> (255, 255, 255)
+        '#FFF'    --> (255, 255, 255)
+
     """
     value = value.lstrip("#")
+    if len(value) == 3:
+        value = "".join(c * 2 for c in value)
     hex_total_length = len(value)
     rgb_section_length = hex_total_length // 3
     return tuple(

commands.py

@@ -50,8 +50,8 @@ def install_js_deps(local, build=True):
     When ``build`` is True (the default), also runs ``npm run build`` to
     rebuild the JupyterLab extension and FigureWidget bundles and verifies
     that the widget bundle exists. Pass ``build=False`` when you only need
-    to refresh ``node_modules`` / ``package-lock.json`` (e.g. after a
-    plotly.js version bump) and don't need the bundles rebuilt.
+    to refresh ``node_modules`` / ``package-lock.json`` but don't
+    need the bundles rebuilt.
     """
 
     npmName = "npm"
@@ -224,7 +224,7 @@ def update_plotlyjs(plotly_js_version, outdir):
     update_bundle(plotly_js_version)
     update_schema(plotly_js_version)
     perform_codegen(outdir)
-    install_js_deps(local=None, build=False)
+    install_js_deps(local=None, build=True)
 
 
 # FIXME: switch to argparse

doc/README.md

@@ -17,6 +17,8 @@ Python packages required to build the docs are listed in
 Before building the documentation locally, you need to set up a dedicated
 environment with the doc-specific dependencies.
 
+> You will need the [`gdal`](https://gdal.org/) system library installed (it's a build dependency of `geopandas`, a required dependency). The `uv pip install` step below will fail without it.
+
 ```bash
 cd doc
 uv venv --python 3.9