merge master; revise this branch following narwhals changes

Author: emilykl

.circleci/config.yml

@@ -46,6 +46,9 @@ commands:
             . venv/bin/activate
             pip install --upgrade pip wheel
             pip install -r ./test_requirements/requirements_<<parameters.py>>_optional.txt
+            cd js
+            npm ci
+            npm run build
       - run:
           name: Install plotly-geo
           command: |
@@ -249,6 +252,14 @@ jobs:
       - test_optional:
           py: "312_no_numpy"
 
+  python_312_np2:
+    docker:
+      - image: cimg/python:3.12-browsers
+    steps:
+      - test_optional:
+          py: "312_np2"
+
+
   # Percy
   python_39_percy:
     docker:
@@ -339,9 +350,9 @@ jobs:
             . venv/bin/activate
             pip install --upgrade pip wheel
             pip install -r ./test_requirements/requirements_38_core.txt black inflect
-            pip install jupyterlab~=3.0
+            pip install jupyterlab
       - run:
-          name: Update jupyterlab-plotly version
+          name: Update jupyter widget plotly.js version
           command: |
             cd packages/python/plotly
             . venv/bin/activate
@@ -395,7 +406,7 @@ jobs:
             conda config --remove channels defaults
             conda config --add channels conda-forge
             conda create -n env --yes python=3.9 conda-build=3.28.4 conda-verify
-            conda install -n env -c conda-forge jupyterlab=3 nodejs=16
+            conda install -n env -c conda-forge jupyterlab nodejs=16
             conda init bash
             mkdir output
 
@@ -404,9 +415,9 @@ jobs:
           command: |
             eval "$(conda shell.bash hook)"
             conda activate env
-            cd packages/javascript/jupyterlab-plotly
+            cd packages/python/plotly/js
             npm ci
-            npm run build:prod
+            npm run build
             git status
 
       - run:
@@ -430,13 +441,13 @@ jobs:
             git status
 
       - run:
-          name: NPM Pack
+          name: Build Widget javascript bundle
           command: |
             eval "$(conda shell.bash hook)"
             conda activate env
-            cd packages/javascript/jupyterlab-plotly
-            npm pack
-            mv jupyterlab-plotly*.tgz ../../../output
+            cd packages/python/plotly/js
+            npm ci
+            npm run build
 
       - run:
           name: Zip output
@@ -483,7 +494,12 @@ jobs:
             pip install -r requirements.txt
             if [ "${CIRCLE_BRANCH}" != "doc-prod" ]; then
               pip uninstall -y plotly
-              pip install -e ../packages/python/plotly
+              cd ../packages/python/plotly
+              pip install -e .
+              cd js
+              npm ci
+              npm run build
+              cd ../../../../doc
             fi
             cd ..
       - run:
@@ -607,4 +623,5 @@ workflows:
       - python_39_pandas_2_optional
       - python_39_percy
       - python_312_no_numpy
+      - python_312_np2
       - build-doc

.gitignore

@@ -59,6 +59,7 @@ doc/check-or-enforce-order.py
 packages/javascript/jupyterlab-plotly/lib/
 packages/python/plotly/jupyterlab_plotly/labextension/
 packages/python/plotly/jupyterlab_plotly/nbextension/index.js*
+packages/python/plotly/plotly/package_data/widgetbundle.js
 
 test/percy/*.html
 test/percy/pandas2/*.html

CHANGELOG.md

@@ -2,15 +2,21 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+### Removed
+- Drop deprecated `pointcloud` and `heatmapgl` traces from the API
+- Drop `tenacity` dependency [#4831](https://github.com/plotly/plotly.js/pull/4831)
+
 ### Updated
 
-- Updated plotly.py to use base64 encoding of arrays in plotly JSON to improve performance. 
+- Updated plotly.py to use base64 encoding of arrays in plotly JSON to improve performance.
+- Add `subtitle` attribute to all Plotly Express traces
+- Make plotly-express dataframe agnostic via Narwhals [#4790](https://github.com/plotly/plotly.py/pull/4790)
 
 ## [5.24.1] - 2024-09-12
 
 ### Updated
 
-- Updated Plotly.js from version 2.35.0 to version 2.35.2. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#2352----2024-09-10) for more information.
+- Updated Plotly.js from version 2.35.0 to version 3.0.0-rc.0. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#2352----2024-11-11) for more information.
 
 ## [5.24.0] - 2024-08-29
 
@@ -25,6 +31,10 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 - Fixed a bug in integer validation of arrays that threw an error when an array contained a mix of strings and integers.
 
+- Fixed a bug in JupyterLab >= 4 and Jupyter Notebook >= 7 that caused latex to not render in plotly charts. 
+
+- Use modern [native ES6 import](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) to load plotly.js bundle instead of requirejs which is [no longer under active development](https://github.com/requirejs/r.js/compare/2.3.6...2.3.7)
+
 ## [5.23.0] - 2024-07-23
 
 ### Updated

README.md

@@ -37,13 +37,10 @@
   </a>
 </div>
 
-
 ## Quickstart
 
 `pip install plotly==5.24.1`
 
-Inside [Jupyter](https://jupyter.org/install) (installable with `pip install "jupyterlab>=3" "ipywidgets>=7.6"`):
-
 ```python
 import plotly.express as px
 fig = px.bar(x=["a", "b", "c"], y=[1, 3, 2])
@@ -52,7 +49,6 @@ fig.show()
 
 See the [Python documentation](https://plotly.com/python/) for more examples.
 
-
 ## Overview
 
 [plotly.py](https://plotly.com/python/) is an interactive, open-source, and browser-based graphing library for Python :sparkles:
@@ -82,7 +78,7 @@ Built on top of [plotly.js](https://github.com/plotly/plotly.js), `plotly.py` is
 
 ## Installation
 
-plotly.py may be installed using pip...
+plotly.py may be installed using pip
 
 ```
 pip install plotly==5.24.1
@@ -94,43 +90,19 @@ or conda.
 conda install -c plotly plotly=5.24.1
 ```
 
-### JupyterLab Support
+### Jupyter Widget Support
 
-For use in [JupyterLab](https://jupyterlab.readthedocs.io/en/stable/), install the `jupyterlab` and `ipywidgets`
+For use as a Jupyter widget, install `jupyter` and `anywidget`
 packages using `pip`:
 
 ```
-pip install "jupyterlab>=3" "ipywidgets>=7.6"
+pip install jupyter anywidget
 ```
 
 or `conda`:
 
 ```
-conda install "jupyterlab>=3" "ipywidgets>=7.6"
-```
-
-The instructions above apply to JupyterLab 3.x. **For JupyterLab 2 or earlier**, run the following commands to install the required JupyterLab extensions (note that this will require [`node`](https://nodejs.org/) to be installed):
-
-```
-# JupyterLab 2.x renderer support
-jupyter labextension install jupyterlab-plotly@5.24.1 @jupyter-widgets/jupyterlab-manager
-```
-
-Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.
-
-### Jupyter Notebook Support
-
-For use in the Jupyter Notebook, install the `notebook` and `ipywidgets`
-packages using `pip`:
-
-```
-pip install "notebook>=5.3" "ipywidgets>=7.5"
-```
-
-or `conda`:
-
-```
-conda install "notebook>=5.3" "ipywidgets>=7.5"
+conda install jupyter anywidget
 ```
 
 ### Static Image Export
@@ -143,41 +115,18 @@ command line utility (legacy as of `plotly` version 4.9).
 #### Kaleido
 
 The [`kaleido`](https://github.com/plotly/Kaleido) package has no dependencies and can be installed
-using pip...
+using pip
 
 ```
 pip install -U kaleido
 ```
 
-or conda.
+or conda
 
 ```
 conda install -c conda-forge python-kaleido
 ```
 
-#### Orca
-
-While Kaleido is now the recommended image export approach because it is easier to install
-and more widely compatible, [static image export](https://plotly.com/python/static-image-export/)
-can also be supported
-by the legacy [orca](https://github.com/plotly/orca) command line utility and the
- [`psutil`](https://github.com/giampaolo/psutil) Python package.
-
-These dependencies can both be installed using conda:
-
-```
-conda install -c plotly plotly-orca==1.3.1 psutil
-```
-
-Or, `psutil` can be installed using pip...
-
-```
-pip install psutil
-```
-
-and orca can be installed according to the instructions in the [orca README](https://github.com/plotly/orca).
-
-
 ### Extended Geo Support
 
 Some plotly.py features rely on fairly large geographic shape files. The county

contributing.md

@@ -157,7 +157,14 @@ complete installation and avoid gdal-config errors.
 (plotly_dev) $ pip install -e packages/python/chart-studio/
 (plotly_dev) $ pip install -e packages/python/plotly-geo/
 ```
-This will ensure that the installed packages links to your local development
+
+**Note**: To test `go.FigureWidget` locally, you'll need to generate the javascript bundle as follows:
+```
+cd packages/python/plotly/js
+npm install && npm run build
+```
+
+Running `pip install -e` will ensure that the installed packages links to your local development
 directory, meaning that all changes you make reflect directly in your
 environment (don't forget to restart the Jupyter kernel though!). For more
 information see the
@@ -211,7 +218,7 @@ make that pull request!
 
 
 ## Update to a new version of Plotly.js
-First update the version of the `plotly.js` dependency in `packages/javascript/jupyterlab-plotly/package.json`.
+First update the version of the `plotly.js` dependency in `packages/python/plotly/js/package.json`.
 
 Then run the `updateplotlyjs` command with:
 

doc/apidoc/plotly.graph_objects.rst

@@ -43,7 +43,6 @@ Simple Traces
    Bar
    Pie
    Heatmap
-   Heatmapgl
    Image
    Contour
    Table