Merge branch 'main' into fix-single-color-palette-5805

Author: MokiMeow

.github/workflows/build-package.yml

@@ -11,46 +11,6 @@ permissions:
   contents: read
 
 jobs:
-  plotlyjs-dev-build:
-    name: plotly.js dev build
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
-      - name: Set up Python
-        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
-        with:
-          python-version: "3.12"
-      - name: Set up Node
-        uses: actions/setup-node@820762786026740c76f36085b0efc47a31fe5020  # v7.0.0
-        with:
-          node-version: "22"
-      - name: Set up uv
-        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7  # v10.2.0
-      - name: Install dependencies
-        run: |
-          uv venv
-          source .venv/bin/activate
-          uv sync --locked --extra dev_optional
-      - name: Update plotly.js to dev
-        run: |
-          source .venv/bin/activate
-          python commands.py updateplotlyjsdev
-      - name: Test core (excluding nodev)
-        run: |
-          source .venv/bin/activate
-          pytest -k 'not nodev' tests/test_core
-      - name: Build source distribution packages
-        run: |
-          source .venv/bin/activate
-          uv sync --locked --extra dev_build
-          python -m build --sdist --wheel -o dist
-      - name: Upload dist artifacts
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a  # v7.0.1
-        with:
-          name: plotlyjs-dev-build-dist
-          path: dist/
-          if-no-files-found: error
-
   full-build:
     name: Full prod build
     runs-on: ubuntu-latest

.github/workflows/test-plotlyjs-dev.yml

@@ -0,0 +1,78 @@
+name: Test plotly.js dev
+
+# Run codegen and the core tests against the plot-schema.json on plotly.js main
+# once a week. This catches plotly.js schema changes that break codegen or
+# validation before the next plotly.js release.
+on:
+  schedule:
+    - cron: "0 9 * * 1"  # Monday 09:00 UTC
+  workflow_dispatch:
+    inputs:
+      plotlyjs_ref:
+        description: "plotly.js branch, tag, or commit SHA to test"
+        required: false
+        default: "main"
+
+permissions:
+  contents: read
+
+jobs:
+  test-plotlyjs-dev:
+    name: Test against plotly.js dev schema
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1  # v7.0.1
+        with:
+          persist-credentials: false
+      - name: Set up Python
+        uses: actions/setup-python@5fda3b95a4ea91299a34e894583c3862153e4b97  # v7.0.0
+        with:
+          python-version: "3.12"
+      - name: Set up uv
+        uses: astral-sh/setup-uv@c18668ad3cf93ea998bef934396af7bb5c839dc7  # v10.2.0
+      - name: Install dependencies
+        run: |
+          uv venv
+          source .venv/bin/activate
+          uv sync --locked --extra dev_optional
+      - name: Download plot-schema.json from plotly.js
+        # plotly.js CI keeps test/plot-schema.json identical to the built schema
+        env:
+          PLOTLYJS_REF: ${{ inputs.plotlyjs_ref || 'main' }}
+        run: |
+          curl -fsSL -o codegen/resources/plot-schema.json \
+            "https://raw.githubusercontent.com/plotly/plotly.js/${PLOTLYJS_REF}/test/plot-schema.json"
+      - name: Run codegen
+        run: |
+          source .venv/bin/activate
+          python commands.py codegen
+      - name: Test core (excluding nodev)
+        run: |
+          source .venv/bin/activate
+          pytest -k 'not nodev' tests/test_core
+
+  report-failure:
+    name: Open an issue for a failed scheduled run
+    needs: test-plotlyjs-dev
+    # Manual runs can test any plotly.js ref, so only report scheduled runs
+    if: failure() && github.event_name == 'schedule'
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      - name: Open or update the failure issue
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+          RUN_URL: ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
+          TITLE: "Weekly plotly.js dev test failed"
+        run: |
+          BODY="The weekly test against the plot-schema.json on plotly.js main failed: ${RUN_URL}"
+          # Comment on an open issue from an earlier failure instead of opening a duplicate
+          EXISTING=$(gh issue list --state open --search "in:title \"${TITLE}\"" \
+            --json number,title --jq "map(select(.title == \"${TITLE}\")) | .[0].number // empty")
+          if [ -n "${EXISTING}" ]; then
+            gh issue comment "${EXISTING}" --body "${BODY}"
+          else
+            gh issue create --title "${TITLE}" --body "${BODY}"
+          fi

CHANGELOG.md

@@ -4,6 +4,9 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## Unreleased
 
+### Added
+- Add support for converting matplotlib reference lines (`axhline`, `axvline`, and horizontal/vertical `axline`) as well as axes-coordinate lines into Plotly layout shapes in `mpl_to_plotly`, including support for date axes [[#5719](https://github.com/plotly/plotly.py/pull/5719)], with thanks to @robertoffmoura for the contribution!
+
 ### Fixed
 - Fix single-color requests in `n_colors` and `sample_colorscale` raising `ZeroDivisionError` [[#5805](https://github.com/plotly/plotly.py/issues/5805)].
 - Fix `mpl_to_plotly` tick marker mirroring, axis positioning, and trace visibility for twinned and overlaid subplots (such as `twinx` and `twiny`) [[#5310](https://github.com/plotly/plotly.py/pull/5310)], with thanks to @robertoffmoura for the contribution!
@@ -14,10 +17,15 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 - Fix `mpl_to_plotly` dropping matplotlib stairs plots by rendering `StepPatch` artists as step lines or filled step areas from their path vertices and edge style [[#5698](https://github.com/plotly/plotly.py/pull/5698)], with thanks to @robertoffmoura for the contribution!
 - Fix `mpl_to_plotly` showing unwanted legends with placeholder or internal label entries (`_nolegend_`, `_childN`) by defaulting `layout.showlegend=False` unless the matplotlib figure explicitly defines a legend [[#5699](https://github.com/plotly/plotly.py/pull/5699)], with thanks to @robertoffmoura for the contribution!
 - Fix `mpl_to_plotly` crashing on figures with fully transparent or alpha-carrying colors, such as boxplot outlier markers (`facecolor="none"`), rgba line colors, and `color="none"` text and axis labels; all matplotlib colors are now exported through a single helper that maps `"none"` to transparent rgba and keeps or overrides alpha as matplotlib does [[#5700](https://github.com/plotly/plotly.py/pull/5700)], with thanks to @robertoffmoura for the contribution!
+- Fix serialization of box/lasso select data for figures with multiple subplots [[#5710](https://github.com/plotly/plotly.py/pull/5710)], with thanks to @flpi-sun for the contribution!
 - Export tick label colors to the plotly tickfont in `mpl_to_plotly` [[#5716](https://github.com/plotly/plotly.py/pull/5716)], with thanks to @robertoffmoura for the contribution!
+- Fix `convert_dash` mapping dotted lines (`linestyle=':'`) to invalid `'circle'` in Plotly, correctly converting them to `'dot'` and preserving custom dash patterns as pixel lists, [[#5719](https://github.com/plotly/plotly.py/pull/5719)] with thanks to @robertoffmoura for the contribution!
 - Fix Plotly Express mutating lists passed to the `x` or `y` arguments in wide mode [[#5727](https://github.com/plotly/plotly.py/pull/5727)], with thanks to @cpruijsen for the contribution!
 - Fix `px.sunburst`, `px.treemap` and `px.icicle` listing sectors in a different order on every run when `path` is used with a Polars DataFrame; sectors now follow their order of first appearance for all dataframe backends [[#5766](https://github.com/plotly/plotly.py/pull/5766)], with thanks to @Irahan2 for the contribution!
 - Fix `mpl_to_plotly` conversion of matplotlib contour lines and line collections: close contour rings ending with `Z` codes, support dash styles, convert date x-axes, separate disjoint subpaths with `None` separators, hide line collection traces from the legend by default, and group consecutive same-style lines into single traces [[#5770](https://github.com/plotly/plotly.py/pull/5770)], with thanks to @robertoffmoura for the contribution!
+- Fix `plotly.io.write_images` ignoring `layout.width`/`layout.height` (and the template's) and exporting every figure at the default 700x500 size; it now uses the same width/height priority as `write_image` and `to_image` [[#5784](https://github.com/plotly/plotly.py/pull/5784)], with thanks to @breken-ai for the contribution!
+- Fix color utilities mutating the list of colors passed to them [[#5836](https://github.com/plotly/plotly.py/pull/5836)], with thanks to @Enesuygurs for the contribution!
+
 
 ## [7.1.0] - 2026-09-15
 

CONTRIBUTING.md

@@ -283,7 +283,7 @@ Steps to update plotly.js:
 
     This command does the following:
 
-    - Downloads new versions of `plot-schema.json` and `plotly.min.js` from the [plotly.js GitHub repository](https://github.com/plotly/plotly.js)
+    - Downloads new versions of `plot-schema.json` and `plotly.min.js` from the [`plotly.js` npm package](https://www.npmjs.com/package/plotly.js)
 and places them in `codegen/resources/` and `plotly/package_data/`, respectively.
     - Updates `plotly/offline/_plotlyjs_version.py` with the new version
     - Regenerates all of the classes under `graph_objs/` (`go.Figure`, `go.Layout`, etc.), and `plotly/validators/_validators.json`, based on the new schema 
@@ -318,23 +318,9 @@ and places them in `codegen/resources/` and `plotly/package_data/`, respectively
 
 7. Add a changelog entry to `CHANGELOG.md` with a link to the PR. We typically mention the version update, link to the plotly.js GitHub release page, and list out the most important changes. Follow the format of previous plotly.js version bump changelog updates.
 
-### Using a Development Branch of Plotly.js
+### Using a Development Version of Plotly.js
 
-If your development branch is in [the plotly.js repository](https://github.com/plotly/plotly.js)
-you can update to development versions of `plotly.js` with this command:
-
-```bash
-python commands.py updateplotlyjsdev --devrepo reponame --devbranch branchname
-```
-
-This downloads `dist/plotly.min.js` and `dist/plot-schema.json` from the latest commit of the branch `branchname` of the repo `reponame`.
-If `--devrepo` or `--devbranch` are omitted,
-`updateplotlyjsdev` defaults to `plotly/plotly.js` and `main` respectively.
-
-### Local Repository
-
-If you have a local repository of `plotly.js` you'd like to try,
-you can prepare the package by running the following commands
+To test plotly.py against a local repository of `plotly.js`, prepare the package by running the following commands
 *in your local plotly.js repository*:
 
 ```bash
@@ -347,7 +333,7 @@ You can then run the following command
 *in your local plotly.py repository*:
 
 ```bash
-python commands.py updateplotlyjsdev --local /path/to/your/plotly.js/
+python commands.py updateplotlyjsdev /path/to/your/plotly.js/
 ```
 
 ## Documentation for `commands.py`
@@ -362,5 +348,5 @@ Usage: `python commands.py <subcommand> <args>`
 | `lint` | Lint all Python code in `plotly/`. |
 | `format` | Format all Python code in `plotly/`. |
 | `updateplotlyjs` | Update `plotly.min.js` and `plot-schema.json` to match the `plotly.js` version specified in `js/package.json`, run codegen to regenerate the Python files, then run `npm install` in `js/` to refresh `js/package-lock.json`. Set `SKIP_NPM=1` to skip the npm step. |
-| `updateplotlyjsdev [--devrepo REPONAME --devbranch BRANCHNAME] \| [--local PATH]` | Update `plot-schema.json` and `plotly.min.js` to match the version in the provided plotly.js repo name and branch name, OR local path. Then, run codegen to regenerate the Python files. |
+| `updateplotlyjsdev PATH` | Update `plot-schema.json` and `plotly.min.js` from the local plotly.js repository at `PATH`. Then, run codegen to regenerate the Python files. |
 | `bumpversion X.Y.Z` | Update the plotly.py version number to X.Y.Z across all files where it needs to be updated. |

_plotly_utils/colors/__init__.py

@@ -338,6 +338,11 @@ def validate_colors(colors, colortype="tuple"):
         else:
             colors = list(colors)
 
+    else:
+        # copy the list so that neither the caller's list nor
+        # DEFAULT_PLOTLY_COLORS is modified in place below
+        colors = list(colors)
+
     # convert color elements in list to tuple color
     for j, each_color in enumerate(colors):
         if "rgb" in each_color:
@@ -377,6 +382,9 @@ def validate_colors_dict(colors, colortype="tuple"):
     """
     Validates dictionary of color(s)
     """
+    # copy the dict so that the caller's dict is not modified in place below
+    colors = dict(colors)
+
     # validate each color element in the dictionary
     for key in colors:
         if "rgb" in colors[key]:
@@ -454,7 +462,7 @@ def convert_colors_to_same_type(
             colors_list = list(colors)
 
     elif isinstance(colors, list):
-        colors_list = colors
+        colors_list = list(colors)
 
     # validate scale
     if scale is not None:
@@ -498,6 +506,9 @@ def convert_dict_colors_to_same_type(colors_dict, colortype="rgb"):
 
     :param (dict) colors_dict: a dictionary whose values are single colors
     """
+    # copy the dict so that the caller's dict is not modified in place below
+    colors_dict = dict(colors_dict)
+
     for key in colors_dict:
         if "#" in colors_dict[key]:
             colors_dict[key] = color_parser(colors_dict[key], hex_to_rgb)
@@ -820,6 +831,10 @@ def convert_colorscale_to_rgb(colorscale):
     converting a colorscale with tuple colors (each coordinate between 0
     and 1) into a colorscale with the colors transformed into rgb colors
     """
+    # copy the colorscale and its [scale, color] pairs so that the caller's
+    # colorscale is not modified in place below
+    colorscale = [list(color) for color in colorscale]
+
     for color in colorscale:
         color[1] = convert_to_RGB_255(color[1])