Merge branch 'main' into fix-5615-splom-colorbar-restyle

Author: emilykl

CHANGELOG.md

@@ -5,9 +5,22 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 ## Unreleased
 
 ### 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!
+- 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!
 - Stop emitting leftover empty `{}` containers when a nested property is set to `None`, which could make a later `Plotly.restyle` of `marker.colorbar` attributes collapse the scatter-matrix layout [[#5615](https://github.com/plotly/plotly.py/issues/5615)]
 
+## [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!
+
 
 ## [6.8.0] - 2026-06-03
 

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(

codegen/resources/plot-schema.json

@@ -279,7 +279,7 @@
       "valType": "number"
     },
     "plotlyServerURL": {
-      "description": "When set it determines base URL for the 'Edit in Chart Studio' `showEditInChartStudio`/`showSendToCloud` mode bar button and the showLink/sendData on-graph link. To enable sending your data to Chart Studio Cloud, you need to set both `plotlyServerURL` to 'https://chart-studio.plotly.com' and also set `showSendToCloud` to true.",
+      "description": "Sets the URL for the `sendChartToCloud` modebar button. When clicked, the button will send the chart data to this URL.",
       "dflt": "",
       "valType": "string"
     },
@@ -331,7 +331,7 @@
       "valType": "boolean"
     },
     "showEditInChartStudio": {
-      "description": "Same as `showSendToCloud`, but use a pencil icon instead of a floppy-disk. Note that if both `showSendToCloud` and `showEditInChartStudio` are turned, only `showEditInChartStudio` will be honored.",
+      "description": "Deprecated. Use `showSendToCloud` instead.",
       "dflt": false,
       "valType": "boolean"
     },
@@ -341,7 +341,7 @@
       "valType": "boolean"
     },
     "showSendToCloud": {
-      "description": "Should we include a ModeBar button, labeled \"Edit in Chart Studio\", that sends this chart to chart-studio.plotly.com (formerly plot.ly) or another plotly server as specified by `plotlyServerURL` for editing, export, etc? Prior to version 1.43.0 this button was included by default, now it is opt-in using this flag. Note that this button can (depending on `plotlyServerURL` being set) send your data to an external server. However that server does not persist your data until you arrive at the Chart Studio and explicitly click \"Save\".",
+      "description": "Should we include a modebar button that sends this chart to a URL specified by `plotlyServerURL`, for sharing the chart with others? Note that this button will (after a confirmation step) send chart data to an external server.",
       "dflt": false,
       "valType": "boolean"
     },
@@ -4639,7 +4639,7 @@
         },
         "remove": {
           "arrayOk": true,
-          "description": "Determines which predefined modebar buttons to remove. Similar to `config.modeBarButtonsToRemove` option. This may include *autoScale2d*, *autoscale*, *editInChartStudio*, *editinchartstudio*, *hoverCompareCartesian*, *hovercompare*, *lasso*, *lasso2d*, *orbitRotation*, *orbitrotation*, *pan*, *pan2d*, *pan3d*, *reset*, *resetCameraDefault3d*, *resetCameraLastSave3d*, *resetGeo*, *resetSankeyGroup*, *resetScale2d*, *resetViewMap*, *resetViewMapbox*, *resetViews*, *resetcameradefault*, *resetcameralastsave*, *resetsankeygroup*, *resetscale*, *resetview*, *resetviews*, *select*, *select2d*, *sendDataToCloud*, *senddatatocloud*, *tableRotation*, *tablerotation*, *toImage*, *toggleHover*, *toggleSpikelines*, *togglehover*, *togglespikelines*, *toimage*, *zoom*, *zoom2d*, *zoom3d*, *zoomIn2d*, *zoomInGeo*, *zoomInMap*, *zoomInMapbox*, *zoomOut2d*, *zoomOutGeo*, *zoomOutMap*, *zoomOutMapbox*, *zoomin*, *zoomout*.",
+          "description": "Determines which predefined modebar buttons to remove. Similar to `config.modeBarButtonsToRemove` option. This may include *autoScale2d*, *autoscale*, *hoverCompareCartesian*, *hovercompare*, *lasso*, *lasso2d*, *orbitRotation*, *orbitrotation*, *pan*, *pan2d*, *pan3d*, *reset*, *resetCameraDefault3d*, *resetCameraLastSave3d*, *resetGeo*, *resetSankeyGroup*, *resetScale2d*, *resetViewMap*, *resetViewMapbox*, *resetViews*, *resetcameradefault*, *resetcameralastsave*, *resetsankeygroup*, *resetscale*, *resetview*, *resetviews*, *select*, *select2d*, *sendChartToCloud*, *sendcharttocloud*, *tableRotation*, *tablerotation*, *toImage*, *toggleHover*, *toggleSpikelines*, *togglehover*, *togglespikelines*, *toimage*, *zoom*, *zoom2d*, *zoom3d*, *zoomIn2d*, *zoomInGeo*, *zoomInMap*, *zoomInMapbox*, *zoomOut2d*, *zoomOutGeo*, *zoomOutMap*, *zoomOutMapbox*, *zoomin*, *zoomout*.",
           "dflt": "",
           "editType": "modebar",
           "valType": "string"

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

js/lib/mimeExtension.js

@@ -1,7 +1,7 @@
 {
   "name": "jupyterlab-plotly",
   "main": "lib/mimeExtension.js",
-  "version": "6.8.0",
+  "version": "6.9.0",
   "repository": {
     "type": "git",
     "url": "https://github.com/plotly/plotly.py"
@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "lodash-es": "^4.17.21",
-    "plotly.js": "3.6.0",
+    "plotly.js": "3.7.0",
     "@lumino/widgets": "~2.4.0"
   },
   "devDependencies": {