Merge pull request #8153 from plotly/release-v4.2.0

Chore: v4.2.0

Author: KoolADE85

CHANGELOG.md

@@ -9,6 +9,32 @@ To see all merged commits on the main branch that will be part of the next plotl
 
 where X.Y.Z is the semver of most recent plotly.js release.
 
+## [4.2.0] -- 2026-10-29
+
+### Added
+- Add `layout.legend.itemheight` to set the height of the legend fill swatch, so more of a trace `fillpattern` is visible in the legend [[#7925](https://github.com/plotly/plotly.js/pull/7925)], with thanks to @MannXo for the contribution!
+- Add spikelines to ternary plots [[#8041](https://github.com/plotly/plotly.js/pull/8041)], with thanks to @Lexachoc for the contribution!
+ - Add TypeScript declarations for lifecycle and WebGL context events [[#8145](https://github.com/plotly/plotly.js/pull/8145)]
+
+### Fixed
+- Respect explicit `node.x`/`node.y` positions in Sankey traces that contain unlinked or grouped nodes [[#7826](https://github.com/plotly/plotly.js/pull/7826)], with thanks to @kyo5uke for the contribution!
+- Fix incorrect positioning of tick labels when using `ticklabelindex` on period axes [[#7934](https://github.com/plotly/plotly.js/pull/7934)], with thanks to @my-tien for the contribution!
+- Fix tick label format sometimes being incompatible with the labeled tick when using `ticklabelindex` [[#7935](https://github.com/plotly/plotly.js/pull/7935)], with thanks to @my-tien for the contribution!
+- Fix unified hover swatch color and pattern for bar `marker.pattern` arrays [[#8039](https://github.com/plotly/plotly.js/pull/8039)], with thanks to @Dmao233 for the contribution!
+- Keep cartesian traces aligned with their axes when an automargin title is combined with any component that expands the margins [[#8045](https://github.com/plotly/plotly.js/pull/8045)]
+- Fix hover labels ignoring MathJax for text that is a single tex expression [[#8051](https://github.com/plotly/plotly.js/pull/8051)], with thanks to @SergeyAxiomatic 
+- Fix XSS via `javascript:` URLs in MathJax `\href` macros by sanitizing links in MathJax-rendered text [[#8051](https://github.com/plotly/plotly.js/pull/8051)], with thanks to @SergeyAxiomatic 
+- Fix issue causing `scattergl` plot to freeze up when hovering over points [[#8052](https://github.com/plotly/plotly.js/pull/8052)], with thanks to @emilykl for the contribution!
+ - Fix quiver arrow colors for a discrete `marker.color` array [[#8069](https://github.com/plotly/plotly.js/pull/8069)], with thanks to @Yahiro025 for the contribution!
+- Fix numeric and numeric-string marker symbol variant detection in `scattergl` [[#8071](https://github.com/plotly/plotly.js/pull/8071)]
+ - Fix `hoverlabel.align` so that it aligns the item text in `x unified` and `y unified` hover labels [[#8104](https://github.com/plotly/plotly.js/pull/8104)], with thanks to @MannXo for the contribution!
+ - Convert modern CSS color formats to rgba for scattergl based traces [[#8119](https://github.com/plotly/plotly.js/pull/8119)]
+- Update TypeScript types so that `Plotly.relayout`, `Plotly.restyle`, `Plotly.update`, and the `plotly_relayout` event accept attribute paths such as `'xaxis.autorange'` [[#8126](https://github.com/plotly/plotly.js/pull/8126)]
+  - Add the `LayoutUpdate` and `DataUpdate` types for these update objects
+  - Add the `(root, attribute, value)` call form to the types of `Plotly.relayout` and `Plotly.restyle`
+ - Fix funnel `percentTotal` text formatting to display formatted percentages instead of raw ratios [[#8139](https://github.com/plotly/plotly.js/pull/8139)], with thanks to @ORITOMI for the contribution!
+
+
 ## [4.1.2] -- 2026-10-05
 
 ### Changed

CITATION.cff

@@ -9,7 +9,7 @@ authors:
 - family-names: "Samimi"
   given-names: "Mojtaba"
 title: "Open source Plotly charting library"
-version: 4.1.2
+version: 4.2.0
 doi: 10.5281/zenodo.13964707
-date-released: 2026-10-05
+date-released: 2026-10-29
 url: "https://github.com/plotly/plotly.js"

README.md

@@ -62,7 +62,7 @@ You may also consider using [`plotly.js-dist`](https://www.npmjs.com/package/plo
 
 ```html
 <head>
-    <script src="https://cdn.plot.ly/plotly-4.1.2.min.js" charset="utf-8"></script>
+    <script src="https://cdn.plot.ly/plotly-4.2.0.min.js" charset="utf-8"></script>
 </head>
 <body>
     <div id="gd"></div>
@@ -79,7 +79,7 @@ You may also consider using [`plotly.js-dist`](https://www.npmjs.com/package/plo
 Alternatively, you may consider using [native ES6 import](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) in the script tag.
 ```html
 <script type="module">
-    import "https://cdn.plot.ly/plotly-4.1.2.min.js"
+    import "https://cdn.plot.ly/plotly-4.2.0.min.js"
     Plotly.newPlot("gd", [{ y: [1, 2, 3] }])
 </script>
 ```
@@ -89,7 +89,7 @@ Fastly supports Plotly.js with free CDN service. Read more at <https://www.fastl
 ### Un-minified versions are also available on CDN
 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-4.1.2.js" charset="utf-8"></script>
+<script src="https://cdn.plot.ly/plotly-4.2.0.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.

dist/README.md

@@ -43,12 +43,12 @@ The main plotly.js bundles weight in at:
 
 | plotly.js | plotly.min.js | plotly.min.js + gzip | plotly-with-meta.js |
 |-----------|---------------|----------------------|---------------------|
-| 10.1 MB | 4.83 MB | 1.49 MB | 10.5 MB |
+| 10.2 MB | 4.84 MB | 1.49 MB | 10.5 MB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-4.1.2.js
+> https://cdn.plot.ly/plotly-4.2.0.js
 
-> https://cdn.plot.ly/plotly-4.1.2.min.js
+> https://cdn.plot.ly/plotly-4.2.0.min.js
 
 
 #### npm packages
@@ -91,12 +91,12 @@ The `basic` partial bundle contains trace modules `bar`, `pie` and `scatter`.
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 2.96 MB | 1.2 MB | 401 kB |
+| 2.97 MB | 1.2 MB | 402 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-basic-4.1.2.js
+> https://cdn.plot.ly/plotly-basic-4.2.0.js
 
-> https://cdn.plot.ly/plotly-basic-4.1.2.min.js
+> https://cdn.plot.ly/plotly-basic-4.2.0.min.js
 
 
 #### npm packages
@@ -114,12 +114,12 @@ The `cartesian` partial bundle contains trace modules `bar`, `box`, `contour`, `
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 3.72 MB | 1.51 MB | 504 kB |
+| 3.74 MB | 1.51 MB | 506 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-cartesian-4.1.2.js
+> https://cdn.plot.ly/plotly-cartesian-4.2.0.js
 
-> https://cdn.plot.ly/plotly-cartesian-4.1.2.min.js
+> https://cdn.plot.ly/plotly-cartesian-4.2.0.min.js
 
 
 #### npm packages
@@ -137,12 +137,12 @@ The `geo` partial bundle contains trace modules `choropleth`, `scatter` and `sca
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 3.4 MB | 1.41 MB | 470 kB |
+| 3.41 MB | 1.41 MB | 472 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-geo-4.1.2.js
+> https://cdn.plot.ly/plotly-geo-4.2.0.js
 
-> https://cdn.plot.ly/plotly-geo-4.1.2.min.js
+> https://cdn.plot.ly/plotly-geo-4.2.0.min.js
 
 
 #### npm packages
@@ -160,12 +160,12 @@ The `gl3d` partial bundle contains trace modules `cone`, `isosurface`, `mesh3d`,
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 4.46 MB | 1.76 MB | 564 kB |
+| 4.47 MB | 1.76 MB | 566 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-gl3d-4.1.2.js
+> https://cdn.plot.ly/plotly-gl3d-4.2.0.js
 
-> https://cdn.plot.ly/plotly-gl3d-4.1.2.min.js
+> https://cdn.plot.ly/plotly-gl3d-4.2.0.min.js
 
 
 #### npm packages
@@ -183,12 +183,12 @@ The `gl2d` partial bundle contains trace modules `parcoords`, `scatter`, `scatte
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 3.7 MB | 1.49 MB | 502 kB |
+| 3.71 MB | 1.5 MB | 504 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-gl2d-4.1.2.js
+> https://cdn.plot.ly/plotly-gl2d-4.2.0.js
 
-> https://cdn.plot.ly/plotly-gl2d-4.1.2.min.js
+> https://cdn.plot.ly/plotly-gl2d-4.2.0.min.js
 
 
 #### npm packages
@@ -206,12 +206,12 @@ The `map` partial bundle contains trace modules `choroplethmap`, `densitymap`, `
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 5.41 MB | 2.98 MB | 892 kB |
+| 5.42 MB | 2.98 MB | 894 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-map-4.1.2.js
+> https://cdn.plot.ly/plotly-map-4.2.0.js
 
-> https://cdn.plot.ly/plotly-map-4.1.2.min.js
+> https://cdn.plot.ly/plotly-map-4.2.0.min.js
 
 
 #### npm packages
@@ -229,12 +229,12 @@ The `finance` partial bundle contains trace modules `bar`, `candlestick`, `funne
 
 | Raw size | Minified size | Minified + gzip size |
 |------|-----------------|------------------------|
-| 3.21 MB | 1.3 MB | 436 kB |
+| 3.22 MB | 1.31 MB | 437 kB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-finance-4.1.2.js
+> https://cdn.plot.ly/plotly-finance-4.2.0.js
 
-> https://cdn.plot.ly/plotly-finance-4.1.2.min.js
+> https://cdn.plot.ly/plotly-finance-4.2.0.min.js
 
 
 #### npm packages
@@ -255,9 +255,9 @@ The `strict` partial bundle contains trace modules `bar`, `barpolar`, `box`, `ca
 | 11 MB | 5.18 MB | 1.59 MB |
 
 #### CDN links
-> https://cdn.plot.ly/plotly-strict-4.1.2.js
+> https://cdn.plot.ly/plotly-strict-4.2.0.js
 
-> https://cdn.plot.ly/plotly-strict-4.1.2.min.js
+> https://cdn.plot.ly/plotly-strict-4.2.0.min.js
 
 
 #### npm packages