Merge remote-tracking branch 'upstream/live-docs' into mkdocs-conversion

Author: daexs

.circleci/config.yml

@@ -303,6 +303,7 @@ jobs:
       - run:
           name: Compare pixels
           command: .circleci/test.sh test-image ; find build -maxdepth 1 -type f -delete
+      - image-diff-message
       - store_artifacts:
           path: build
           destination: /
@@ -317,6 +318,7 @@ jobs:
       - run:
           name: Compare pixels
           command: .circleci/test.sh test-image-virtual-webgl ; find build -maxdepth 1 -type f -delete
+      - image-diff-message
       - store_artifacts:
           path: build
           destination: /
@@ -331,6 +333,7 @@ jobs:
       - run:
           name: Compare pixels
           command: .circleci/test.sh test-image ; find build -maxdepth 1 -type f -delete
+      - image-diff-message
       - store_artifacts:
           path: build
           destination: /
@@ -345,6 +348,7 @@ jobs:
       - run:
           name: Compare pixels of mathjax v3 baselines
           command: .circleci/test.sh test-image-mathjax3
+      - image-diff-message
       - store_artifacts:
           path: build
           destination: /
@@ -515,6 +519,16 @@ jobs:
       - store_artifacts:
           path: topojson.tar
 
+commands:
+  image-diff-message:
+    steps:
+      - run:
+          name: IMAGE DIFF DETECTED - SEE NOTE BELOW
+          when: on_fail
+          command: |
+            echo "Image Diff Detected: baseline images may need to be updated. Run 'tasks/circleci_image_artifact_download.sh' to download the baseline images generated by this job."
+            echo "Add the new images to 'test/image/baselines/' and commit them to this pull request."
+
 workflows:
   version: 2
   build-and-test:

.github/ISSUE_TEMPLATE.md

@@ -0,0 +1,37 @@
+---
+name: Bug report
+about: Create a bug report for a plotly.js issue
+title: "[BUG]: "
+labels: bug
+
+---
+
+### Instructions (remove this section before submitting report)
+
+Thanks for your interest in plotly.js!
+
+- Before submitting a new bug report, please search for existing and closed issues. If your bug is not addressed yet, fill out the sections below and submit a new issue.
+- Issues found on the example pages from **https://plotly.com/javascript/** should be filed in our [documentation repo](https://github.com/plotly/documentation/issues) with the exception of **https://plotly.com/javascript/reference** which should be filed here.
+- Implementation questions ("How do I do ...?") should be asked on our [Community Forum](https://community.plotly.com/c/plotly-js/6) or on [Stack Overflow](https://stackoverflow.com/questions/tagged/plotly) (tagged 'plotly').
+- Comments should add content to the discussions. Approbation comments such as *+1* or *I would like this feature to be implemented as well* will be deleted by the maintainers. Please use [GitHub reactions](https://github.com/blog/2119-add-reactions-to-pull-requests-issues-and-comments) instead.
+
+### Description
+
+_Add a clear description of the issue that you're having._
+
+### Screenshots/Video
+
+_Add screenshots or a video of the issue._
+
+### Steps to reproduce
+
+_Reports **must** include steps to reproduce the issue. Alternatively, you can use [codepen](http://codepen.io/), [jsfiddle](https://jsfiddle.net/) or [jsbin](https://jsbin.com) to share your example. Please use the [latest (un-minified) version](https://github.com/plotly/plotly.js/releases) of plotly.js in your report unless not applicable._
+
+- Go to '...'
+- Click on X
+- Note the issue with Y
+
+
+### Notes
+
+_Add info here that doesn't fit in the other sections._

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Feature request
+about: Submit a new feature request for plotly.js
+title: "[FEATURE]: "
+labels: feature
+
+---
+
+### Instructions (remove this section before submitting an issue)
+
+Thanks for your interest in plotly.js!
+
+- Before submitting a new feature request, please search for existing and closed requests. If your request is novel, fill out the sections below and submit a new request.
+- Comments should add content to the discussions. Approbation comments such as *+1* or *I would like this feature to be implemented as well* will be deleted by the maintainers. Please use [GitHub reactions](https://github.com/blog/2119-add-reactions-to-pull-requests-issues-and-comments) instead.
+
+### Description
+
+_Add a clear description of the feature that you're requesting._
+
+
+### Why should this feature be added?
+
+_Provide an argument for why this feature should be added. We can't add everything, so this will help us determine what gets worked on. Please also consider creating a PR and adding the feature yourself. Help is always appreciated._
+
+### Mocks/Designs
+
+_Please add any mocks or designs you might have for the feature._
+
+### Notes
+
+_Add info here that doesn't fit in the other sections._

.github/ISSUE_TEMPLATE/feature_request.md

@@ -17,6 +17,7 @@ tags
 
 .*
 !.circleci
+!.github/
 !.gitignore
 !.npmignore
 

.gitignore

@@ -9,7 +9,35 @@ To see all merged commits on the master branch that will be part of the next plo
 
 where X.Y.Z is the semver of most recent plotly.js release.
 
-## [3.1.0]
+## [3.1.2] -- 2025-10-16
+
+### Added
+- Add "SI extended" formatting rule for tick exponents on axis labels, allowing values to be displayed with extended SI prefixes (e.g., femto, pico, atto) [[#7249](https://github.com/plotly/plotly.js/pull/7249)], with thanks to @dberardi99 for the contribution!
+
+### Fixed
+- Fix editable `title.text` for `ternary`, `polar`, `colorbar`, and `rangeslider` (regression introduced in 3.0.0) [[#7513](https://github.com/plotly/plotly.js/pull/7513)], with thanks to @Lexachoc for the contribution!
+- Fix `layout.title.subtitle` does not properly clear/remove from the chart when `subtitle` object is not in place, or `subtitle.text` set to `null`, empty string, or whitespace-only values [[#7571](https://github.com/plotly/plotly.js/pull/7571)], with thanks to @cminn10 for the contribution!
+- Fix issue where `visible` property of one legend was affecting another. [[#7574](https://github.com/plotly/plotly.js/pull/7574)]
+- Resolve incorrect shape clipping for domain-referenced shapes on n*10th subplot. [[#7576](https://github.com/plotly/plotly.js/pull/7576)]
+- Update config diff check method to handle nested arrays [[#7579](https://github.com/plotly/plotly.js/pull/7579)]
+
+
+## [3.1.1] -- 2025-09-29
+
+### Fixed
+- Update plot with all config changes during call to `Plotly.react` [[#7475](https://github.com/plotly/plotly.js/pull/7475)]
+- Fix wheel event handler `Violation` in Chromium by setting `passive: true` [[#7517](https://github.com/plotly/plotly.js/pull/7517)]
+- Fix `locationmode` warning to be less aggressive: show warning only when `locationmode` is `'country names'` [[#7520](https://github.com/plotly/plotly.js/pull/7520)]
+- Refactor `drawMainTitle` to use context-specific selections for title and subtitle, avoiding conflicts when multiple plots are present on the same page [[#7522](https://github.com/plotly/plotly.js/pull/7522)], with thanks to @davibarbosa2 for the contribution!
+- Fix broken styling of map attributions [[#7526](https://github.com/plotly/plotly.js/pull/7526)]
+- Calculate colorscale properly for histogram when marker `cmin`/`cmax`/`cmid` values are undefined [[#7534](https://github.com/plotly/plotly.js/pull/7534)]
+- Tidy up some stray characters in attribute descriptions [[#7539](https://github.com/plotly/plotly.js/pull/7539)], [[#7540](https://github.com/plotly/plotly.js/pull/7540)]
+- Fix some typos (and a conditional check) [[#7542](https://github.com/plotly/plotly.js/pull/7542)], with thanks to @musvaage for the contribution!
+- Fix cropping of subunits in USA topojson, clean up land and coastlines layers for all topojson [[#7555](https://github.com/plotly/plotly.js/pull/7555)]
+- Fix issue causing empty ScatterGL plots when using text elements [#7563](https://github.com/plotly/plotly.js/pull/7563)
+
+
+## [3.1.0]  -- 2025-08-08
 
 ### Added
 - Add property `zerolinelayer` to cartesian axes to allow drawing zeroline above traces [[#7269](https://github.com/plotly/plotly.js/pull/7269)]

CHANGELOG.md

@@ -9,7 +9,7 @@ authors:
 - family-names: "Samimi"
   given-names: "Mojtaba"
 title: "Open source Plotly charting library"
-version: 3.1.0
+version: 3.1.2
 doi: 10.5281/zenodo.13964707
-date-released: 2025-08-07
+date-released: 2025-10-16
 url: "https://github.com/plotly/plotly.js"

CITATION.cff

@@ -60,7 +60,7 @@ You may also consider using [`plotly.js-dist`](https://www.npmjs.com/package/plo
 
 ```html
 <head>
-    <script src="https://cdn.plot.ly/plotly-3.1.0.min.js" charset="utf-8"></script>
+    <script src="https://cdn.plot.ly/plotly-3.1.2.min.js" charset="utf-8"></script>
 </head>
 <body>
     <div id="gd"></div>
@@ -78,7 +78,7 @@ Alternatively you may consider using [native ES6 import](https://developer.mozil
 
 ```html
 <script type="module">
-    import "https://cdn.plot.ly/plotly-3.1.0.min.js"
+    import "https://cdn.plot.ly/plotly-3.1.2.min.js"
     Plotly.newPlot("gd", [{ y: [1, 2, 3] }])
 </script>
 ```
@@ -90,7 +90,7 @@ Fastly supports Plotly.js with free CDN service. Read more at <https://www.fastl
 While non-minified source files may contain characters outside UTF-8, it is recommended that you specify the `charset` when loading those bundles.
 
 ```html
-<script src="https://cdn.plot.ly/plotly-3.1.0.js" charset="utf-8"></script>
+<script src="https://cdn.plot.ly/plotly-3.1.2.js" charset="utf-8"></script>
 ```
 
 > Please note that as of v2 the "plotly-latest" outputs (e.g. https://cdn.plot.ly/plotly-latest.min.js) will no longer be updated on the CDN, and will stay at the last v1 patch v1.58.5. Therefore, to use the CDN with plotly.js v2 and higher, you must specify an exact plotly.js version.
@@ -144,34 +144,35 @@ Please read through our [contributing guidelines](https://github.com/plotly/plot
 
 Plotly.js is at the core of a large and dynamic ecosystem with many contributors who file issues, reproduce bugs, suggest improvements, write code in this repo (and other upstream or downstream ones) and help users in the Plotly community forum. The following people deserve special recognition for their outsized contributions to this ecosystem:
 
-|   | GitHub | Twitter | Status |
-|---|--------|---------|--------|
-|**Alex C. Johnson**| [@alexcjohnson](https://github.com/alexcjohnson) | | Active, Maintainer |
-|**Mojtaba Samimi** | [@archmoj](https://github.com/archmoj) | [@solarchvision](https://twitter.com/solarchvision) | Active, Maintainer |
-|**Emily Kellison-Linn** | [@emilykl](https://github.com/emilykl) | | Active, Maintainer |
-|**My-Tien Nguyen**| [@my-tien](https://github.com/my-tien) | | Active, Community Contributor |
-|**Birk Skyum**| [@birkskyum](https://github.com/birkskyum) | | Active, Community Contributor |
-|**Étienne Tétreault-Pinard**| [@etpinard](https://github.com/etpinard) | [@etpinard](https://twitter.com/etpinard) | Hall of Fame |
-|**Antoine Roy-Gobeil** | [@antoinerg](https://github.com/antoinerg) | | Hall of Fame |
-|**Jack Parmer**| [@jackparmer](https://github.com/jackparmer) | | Hall of Fame |
-|**Nicolas Kruchten** | [@nicolaskruchten](https://github.com/nicolaskruchten) | [@nicolaskruchten](https://twitter.com/nicolaskruchten) | Hall of Fame |
-|**Mikola Lysenko**| [@mikolalysenko](https://github.com/mikolalysenko) | [@MikolaLysenko](https://twitter.com/MikolaLysenko) | Hall of Fame |
-|**Ricky Reusser**| [@rreusser](https://github.com/rreusser) | [@rickyreusser](https://twitter.com/rickyreusser) | Hall of Fame |
-|**Dmitry Yv.** | [@dy](https://github.com/dy) | [@DimaYv](https://twitter.com/dimayv)| Hall of Fame |
-|**Jon Mease** | [@jonmmease](https://github.com/jonmmease) | [@jonmmease](https://twitter.com/jonmmease) | Hall of Fame |
-|**Robert Monfera**| [@monfera](https://github.com/monfera) | [@monfera](https://twitter.com/monfera) | Hall of Fame |
-|**Robert Möstl** | [@rmoestl](https://github.com/rmoestl) | [@rmoestl](https://twitter.com/rmoestl) | Hall of Fame |
-|**Nicolas Riesco**| [@n-riesco](https://github.com/n-riesco) | | Hall of Fame |
-|**Miklós Tusz**| [@mdtusz](https://github.com/mdtusz) | [@mdtusz](https://twitter.com/mdtusz)| Hall of Fame |
-|**Chelsea Douglas**| [@cldougl](https://github.com/cldougl) | | Hall of Fame |
-|**Ben Postlethwaite**| [@bpostlethwaite](https://github.com/bpostlethwaite) | | Hall of Fame |
-|**Hannah Ker** | [@hannahker](https://github.com/hannahker) | [@hannahker11](https://twitter.com/hannahker11)| Hall of Fame |
-|**Chris Parmer**| [@chriddyp](https://github.com/chriddyp) | | Hall of Fame |
-|**Alex Vados**| [@alexander-daniel](https://github.com/alexander-daniel) | | Hall of Fame |
+| Contributor | GitHub |  Status |
+|-------------|--------|---------|
+|**Alex C. Johnson**| [@alexcjohnson](https://github.com/alexcjohnson) | Active, Maintainer |
+|**Emily Kellison-Linn** | [@emilykl](https://github.com/emilykl) | Active, Maintainer |
+|**Cameron DeCoster** | [@camdecoster](https://github.com/camdecoster) | Active, Maintainer |
+|**My-Tien Nguyen**| [@my-tien](https://github.com/my-tien) | Active, Community Contributor |
+|**Birk Skyum**| [@birkskyum](https://github.com/birkskyum) | Active, Community Contributor |
+|**Étienne Tétreault-Pinard**| [@etpinard](https://github.com/etpinard) | Hall of Fame |
+|**Antoine Roy-Gobeil** | [@antoinerg](https://github.com/antoinerg) | Hall of Fame |
+|**Jack Parmer**| [@jackparmer](https://github.com/jackparmer) | Hall of Fame |
+|**Nicolas Kruchten** | [@nicolaskruchten](https://github.com/nicolaskruchten) | Hall of Fame |
+|**Mikola Lysenko**| [@mikolalysenko](https://github.com/mikolalysenko) | Hall of Fame |
+|**Ricky Reusser**| [@rreusser](https://github.com/rreusser) | Hall of Fame |
+|**Dmitry Yv.** | [@dy](https://github.com/dy) | Hall of Fame |
+|**Jon Mease** | [@jonmmease](https://github.com/jonmmease) | Hall of Fame |
+|**Robert Monfera**| [@monfera](https://github.com/monfera) | Hall of Fame |
+|**Robert Möstl** | [@rmoestl](https://github.com/rmoestl) | Hall of Fame |
+|**Nicolas Riesco**| [@n-riesco](https://github.com/n-riesco) | Hall of Fame |
+|**Miklós Tusz**| [@mdtusz](https://github.com/mdtusz) | Hall of Fame |
+|**Chelsea Douglas**| [@cldougl](https://github.com/cldougl) | Hall of Fame |
+|**Ben Postlethwaite**| [@bpostlethwaite](https://github.com/bpostlethwaite) | Hall of Fame |
+|**Hannah Ker** | [@hannahker](https://github.com/hannahker) | Hall of Fame |
+|**Chris Parmer**| [@chriddyp](https://github.com/chriddyp) | Hall of Fame |
+|**Alex Vados**| [@alexander-daniel](https://github.com/alexander-daniel) | Hall of Fame |
+|**Mojtaba Samimi** | [@archmoj](https://github.com/archmoj) | Hall of Fame |
 
 ## Copyright and license
 
-Code and documentation copyright Plotly, Inc.
+Code and documentation copyright 2025 Plotly, Inc.
 
 Code released under the [MIT license](https://github.com/plotly/plotly.js/blob/master/LICENSE).
 
@@ -183,5 +184,7 @@ See the [Releases section](https://github.com/plotly/plotly.js/releases) of our
 
 ## Community
 
-* Implementation help may be found on community.plot.com (tagged [`plotly-js`](https://community.plotly.com/c/plotly-js)) or on Stack Overflow (tagged [`plotly`](https://stackoverflow.com/questions/tagged/plotly)).
-* Developers should use the keyword `plotly` on packages which modify or add to the functionality of plotly.js when distributing through [npm](https://www.npmjs.com/browse/keyword/plotly).
+* Follow us on [X](https://x.com/plotlygraphs) and [LinkedIn](https://www.linkedin.com/company/plotly/) for the latest Plotly news.
+* Implementation help may be found on our community forum (tagged [`plotly-js`](https://community.plotly.com/c/plotly-js)) or
+  on Stack Overflow (tagged [`plotly.js`](https://stackoverflow.com/questions/tagged/plotly.js)).
+* Developers should use the keyword `plotly` on packages which modify or add to the functionality of plotly.js when distributing through [npm](https://www.npmjs.com/search?q=keywords:plotly).

README.md

@@ -4,11 +4,13 @@
   "files": {
     "maxSize": 10000000,
     "includes": [
+      "**/esbuild-config.js",
       "**/src/**",
       "**/lib/**",
       "**/test/**",
       "**/tasks/**",
       "**/devtools/**",
+      "**/topojson/**",
       "!**/test/plot-schema.json",
       "!**/dist",
       "!**/stackgl_modules",
@@ -88,17 +90,7 @@
         "noVar": "off",
         "noConsole": { "level": "off", "options": { "allow": ["log"] } }
       }
-    },
-    "includes": [
-      "**",
-      "!**/stackgl_modules",
-      "!**/node_modules",
-      "!**/dist",
-      "!**/build",
-      "!**/tasks/test_amdefine.js",
-      "!**/tasks/test_requirejs.js",
-      "!**/test/jasmine/assets/jquery-1.8.3.min.js"
-    ]
+    }
   },
   "javascript": {
     "globals": [
@@ -131,7 +123,7 @@
     "formatter": {
       "enabled": true,
       "indentStyle": "space",
-      "indentWidth": 1,
+      "indentWidth": 2,
       "lineEnding": "lf",
       "lineWidth": 80
     }