From 2bd98cfb339ea865ee9372302b1f66b8ab77a20f Mon Sep 17 00:00:00 2001
From: Joel Natividad <1980690+jqnatividad@users.noreply.github.com>
Date: Sat, 11 Jul 2026 09:06:39 -0400
Subject: [PATCH 1/8] refactor(traces): consolidate Selection/SelectionMarker
 into common
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The scatter_geo, scatter_map, and scatter_mapbox modules each defined a
byte-identical Selection/SelectionMarker pair. Move the single definition
to crate::common and re-export it from each module (pub use) so the public
paths plotly::traces::scatter_geo::Selection etc. keep resolving — no
serialized-output change, all existing trace tests pass unchanged.

This is the shared building block for backfilling selected/unselected
styling onto the older cartesian traces.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Andrei Gherghescu <8067229+andrei-ng@users.noreply.github.com>
---
 plotly/src/common/mod.rs            | 40 +++++++++++++++++++++++++++++
 plotly/src/traces/scatter_geo.rs    | 40 +++--------------------------
 plotly/src/traces/scatter_map.rs    | 40 +++--------------------------
 plotly/src/traces/scatter_mapbox.rs | 40 +++--------------------------
 4 files changed, 52 insertions(+), 108 deletions(-)

diff --git a/plotly/src/common/mod.rs b/plotly/src/common/mod.rs
index db2fa08e..d7cae3bd 100644
--- a/plotly/src/common/mod.rs
+++ b/plotly/src/common/mod.rs
@@ -645,6 +645,46 @@ impl Gradient {
     }
 }
 
+/// Styles the marker of `selected`/`unselected` points, used by the
+/// `selected` and `unselected` attributes of point-marker traces.
+#[serde_with::skip_serializing_none]
+#[derive(Serialize, Clone, Debug, Default)]
+pub struct SelectionMarker {
+    color: Option<Box<dyn Color>>,
+    opacity: Option<f64>,
+    size: Option<Dim<usize>>,
+}
+
+/// Sets the style of `selected`/`unselected` points.
+#[derive(Serialize, Clone, Debug, Default)]
+pub struct Selection {
+    marker: SelectionMarker,
+}
+
+impl Selection {
+    pub fn new() -> Self {
+        Default::default()
+    }
+
+    /// Sets the marker color of un/selected points.
+    pub fn color<C: Color>(mut self, color: C) -> Self {
+        self.marker.color = Some(Box::new(color));
+        self
+    }
+
+    /// Sets the marker opacity of un/selected points.
+    pub fn opacity(mut self, opacity: f64) -> Self {
+        self.marker.opacity = Some(opacity);
+        self
+    }
+
+    /// Sets the marker size of un/selected points.
+    pub fn size(mut self, size: usize) -> Self {
+        self.marker.size = Some(Dim::Scalar(size));
+        self
+    }
+}
+
 #[serde_with::skip_serializing_none]
 #[derive(Serialize, Clone, Debug, FieldSetter)]
 pub struct TickFormatStop {
diff --git a/plotly/src/traces/scatter_geo.rs b/plotly/src/traces/scatter_geo.rs
index 6e0cd8c7..0a0dc1ec 100644
--- a/plotly/src/traces/scatter_geo.rs
+++ b/plotly/src/traces/scatter_geo.rs
@@ -17,42 +17,10 @@ pub enum Fill {
     ToSelf,
 }
 
-#[serde_with::skip_serializing_none]
-#[derive(Serialize, Clone, Debug, Default)]
-pub struct SelectionMarker {
-    color: Option<Box<dyn Color>>,
-    opacity: Option<f64>,
-    size: Option<Dim<usize>>,
-}
-
-#[derive(Serialize, Clone, Debug, Default)]
-pub struct Selection {
-    marker: SelectionMarker,
-}
-
-impl Selection {
-    pub fn new() -> Self {
-        Default::default()
-    }
-
-    /// Sets the marker color of un/selected points.
-    pub fn color<C: Color>(mut self, color: C) -> Self {
-        self.marker.color = Some(Box::new(color));
-        self
-    }
-
-    /// Sets the marker opacity of un/selected points.
-    pub fn opacity(mut self, opacity: f64) -> Self {
-        self.marker.opacity = Some(opacity);
-        self
-    }
-
-    /// Sets the marker size of un/selected points.
-    pub fn size(mut self, size: usize) -> Self {
-        self.marker.size = Some(Dim::Scalar(size));
-        self
-    }
-}
+// `Selection` and `SelectionMarker` are defined in `crate::common` and
+// re-exported here for backward compatibility (they used to live in this
+// module).
+pub use crate::common::{Selection, SelectionMarker};
 
 #[serde_with::skip_serializing_none]
 #[derive(Serialize, Clone, Debug, FieldSetter)]
diff --git a/plotly/src/traces/scatter_map.rs b/plotly/src/traces/scatter_map.rs
index d9f8708f..b63c1386 100644
--- a/plotly/src/traces/scatter_map.rs
+++ b/plotly/src/traces/scatter_map.rs
@@ -17,42 +17,10 @@ pub enum Fill {
     ToSelf,
 }
 
-#[serde_with::skip_serializing_none]
-#[derive(Serialize, Clone, Debug, Default)]
-pub struct SelectionMarker {
-    color: Option<Box<dyn Color>>,
-    opacity: Option<f64>,
-    size: Option<Dim<usize>>,
-}
-
-#[derive(Serialize, Clone, Debug, Default)]
-pub struct Selection {
-    marker: SelectionMarker,
-}
-
-impl Selection {
-    pub fn new() -> Self {
-        Default::default()
-    }
-
-    /// Sets the marker color of un/selected points.
-    pub fn color<C: Color>(mut self, color: C) -> Self {
-        self.marker.color = Some(Box::new(color));
-        self
-    }
-
-    /// Sets the marker opacity of un/selected points.
-    pub fn opacity(mut self, opacity: f64) -> Self {
-        self.marker.opacity = Some(opacity);
-        self
-    }
-
-    /// Sets the marker size of un/selected points.
-    pub fn size(mut self, size: usize) -> Self {
-        self.marker.size = Some(Dim::Scalar(size));
-        self
-    }
-}
+// `Selection` and `SelectionMarker` are defined in `crate::common` and
+// re-exported here for backward compatibility (they used to live in this
+// module).
+pub use crate::common::{Selection, SelectionMarker};
 
 /// Native point-clustering options for a [`ScatterMap`] trace.
 ///
diff --git a/plotly/src/traces/scatter_mapbox.rs b/plotly/src/traces/scatter_mapbox.rs
index ef65b891..8a7f5d4c 100644
--- a/plotly/src/traces/scatter_mapbox.rs
+++ b/plotly/src/traces/scatter_mapbox.rs
@@ -17,42 +17,10 @@ pub enum Fill {
     ToSelf,
 }
 
-#[serde_with::skip_serializing_none]
-#[derive(Serialize, Clone, Debug, Default)]
-pub struct SelectionMarker {
-    color: Option<Box<dyn Color>>,
-    opacity: Option<f64>,
-    size: Option<Dim<usize>>,
-}
-
-#[derive(Serialize, Clone, Debug, Default)]
-pub struct Selection {
-    marker: SelectionMarker,
-}
-
-impl Selection {
-    pub fn new() -> Self {
-        Default::default()
-    }
-
-    /// Sets the marker color of un/selected points.
-    pub fn color<C: Color>(mut self, color: C) -> Self {
-        self.marker.color = Some(Box::new(color));
-        self
-    }
-
-    /// Sets the marker opacity of un/selected points.
-    pub fn opacity(mut self, opacity: f64) -> Self {
-        self.marker.opacity = Some(opacity);
-        self
-    }
-
-    /// Sets the marker size of un/selected points.
-    pub fn size(mut self, size: usize) -> Self {
-        self.marker.size = Some(Dim::Scalar(size));
-        self
-    }
-}
+// `Selection` and `SelectionMarker` are defined in `crate::common` and
+// re-exported here for backward compatibility (they used to live in this
+// module).
+pub use crate::common::{Selection, SelectionMarker};
 
 #[serde_with::skip_serializing_none]
 #[derive(Serialize, Clone, Debug, FieldSetter)]

From 4cf45feb239b8f9b6fed461822be4a7ff9e6e6d8 Mon Sep 17 00:00:00 2001
From: Joel Natividad <1980690+jqnatividad@users.noreply.github.com>
Date: Sat, 11 Jul 2026 09:23:24 -0400
Subject: [PATCH 2/8] feat(traces): backfill legendrank/legendwidth/uirevision
 + grouping

Bring the older trace types up to plotly.js 3.7.0 parity on the common
"universal" attributes that the newer traces already expose:

- legendrank, legendwidth, uirevision on Scatter, Bar, BoxPlot, Violin,
  Histogram, HeatMap, Contour, Candlestick, Ohlc, Scatter3D, Surface,
  ScatterPolar (Scatter3D already had legendrank).
- uirevision only on Sunburst, Treemap, Table (these do not participate
  in the legend, so legendrank/legendwidth do not apply).
- offsetgroup/alignmentgroup on Scatter (Bar/BoxPlot/Violin/Histogram
  already had them).

All fields are additive Option<T> with serde renames; existing tests pass
unchanged. Contour uses a hand-written builder (no FieldSetter derive), so
its fields, Default impl, and setters were added by hand. Added focused
rename-guard tests for Scatter and Contour.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Andrei Gherghescu <8067229+andrei-ng@users.noreply.github.com>
---
 CHANGELOG.md                       |  1 +
 plotly/src/traces/bar.rs           | 14 +++++++++
 plotly/src/traces/box_plot.rs      | 14 +++++++++
 plotly/src/traces/candlestick.rs   | 14 +++++++++
 plotly/src/traces/contour.rs       | 47 +++++++++++++++++++++++++++++-
 plotly/src/traces/heat_map.rs      | 13 +++++++++
 plotly/src/traces/histogram.rs     | 14 +++++++++
 plotly/src/traces/ohlc.rs          | 14 +++++++++
 plotly/src/traces/scatter.rs       | 38 ++++++++++++++++++++++++
 plotly/src/traces/scatter3d.rs     |  8 +++++
 plotly/src/traces/scatter_polar.rs | 13 +++++++++
 plotly/src/traces/sunburst.rs      |  4 +++
 plotly/src/traces/surface.rs       | 14 +++++++++
 plotly/src/traces/table.rs         |  5 ++++
 plotly/src/traces/treemap.rs       |  4 +++
 plotly/src/traces/violin.rs        | 13 +++++++++
 16 files changed, 229 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ac055798..ea098163 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,6 +14,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 - [[#414](https://github.com/plotly/plotly.rs/issues/414)] Add `DensityMap` (MapLibre `map` subplot) trace type — density heatmaps with full color-scale and hover support
 - [[#417](https://github.com/plotly/plotly.rs/issues/417)] Add `ScatterMap` (MapLibre `map` subplot) trace type — the modern counterpart to `ScatterMapbox`
 - [[#418](https://github.com/plotly/plotly.rs/issues/418)] Add native point clustering to `ScatterMap` via a `Cluster` option
+- [TBD] Backfill common trace attributes for plotly.js parity: add `legendrank`, `legendwidth`, and `uirevision` to the older trace types that lacked them (`Scatter`, `Bar`, `BoxPlot`, `Violin`, `Histogram`, `HeatMap`, `Contour`, `Candlestick`, `Ohlc`, `Scatter3D`, `Surface`, `ScatterPolar`; `uirevision` only for `Sunburst`, `Treemap`, `Table`), plus `offsetgroup`/`alignmentgroup` on `Scatter`. Consolidate the duplicated `Selection`/`SelectionMarker` structs into `common` (re-exported from their original modules for backward compatibility)
 
 ### Changed
 
diff --git a/plotly/src/traces/bar.rs b/plotly/src/traces/bar.rs
index a3e91fe0..9d665194 100644
--- a/plotly/src/traces/bar.rs
+++ b/plotly/src/traces/bar.rs
@@ -8,6 +8,7 @@ use crate::{
         Calendar, ConstrainText, Dim, ErrorData, Font, HoverInfo, Label, LegendGroupTitle, Marker,
         Orientation, PlotType, TextAnchor, TextPosition, Visible, XAxisId, YAxisId,
     },
+    private::NumOrString,
     Trace,
 };
 
@@ -105,6 +106,19 @@ where
     x_calendar: Option<Calendar>,
     #[serde(rename = "ycalendar")]
     y_calendar: Option<Calendar>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<X, Y> Bar<X, Y>
diff --git a/plotly/src/traces/box_plot.rs b/plotly/src/traces/box_plot.rs
index f65ff33f..d6aea5b0 100644
--- a/plotly/src/traces/box_plot.rs
+++ b/plotly/src/traces/box_plot.rs
@@ -9,6 +9,7 @@ use crate::{
         Calendar, Dim, HoverInfo, Label, LegendGroupTitle, Line, Marker, Orientation, PlotType,
         Visible, XAxisId, YAxisId,
     },
+    private::NumOrString,
     Trace,
 };
 
@@ -172,6 +173,19 @@ where
     x_calendar: Option<Calendar>,
     #[serde(rename = "ycalendar")]
     y_calendar: Option<Calendar>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<Y> BoxPlot<f64, Y>
diff --git a/plotly/src/traces/candlestick.rs b/plotly/src/traces/candlestick.rs
index 8728a741..c9ff4e50 100644
--- a/plotly/src/traces/candlestick.rs
+++ b/plotly/src/traces/candlestick.rs
@@ -3,6 +3,7 @@
 use plotly_derive::FieldSetter;
 use serde::Serialize;
 
+use crate::private::NumOrString;
 use crate::{
     color::NamedColor,
     common::{
@@ -89,6 +90,19 @@ where
     hover_label: Option<Label>,
     #[serde(rename = "xcalendar")]
     x_calendar: Option<Calendar>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<T, O> Candlestick<T, O>
diff --git a/plotly/src/traces/contour.rs b/plotly/src/traces/contour.rs
index 59eddf99..28e0588c 100644
--- a/plotly/src/traces/contour.rs
+++ b/plotly/src/traces/contour.rs
@@ -9,7 +9,8 @@ use crate::{
         Calendar, ColorBar, ColorScale, Dim, Font, HoverInfo, Label, LegendGroupTitle, Line,
         PlotType, Visible, XAxisId, YAxisId,
     },
-    private, Trace,
+    private::{self, NumOrString},
+    Trace,
 };
 
 #[derive(Serialize, Debug, Clone)]
@@ -177,6 +178,19 @@ where
     x_calendar: Option<Calendar>,
     #[serde(rename = "ycalendar")]
     y_calendar: Option<Calendar>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<Z, X, Y> Default for Contour<Z, X, Y>
@@ -229,6 +243,9 @@ where
             transpose: None,
             x_calendar: None,
             y_calendar: None,
+            legend_rank: None,
+            legend_width: None,
+            ui_revision: None,
         }
     }
 }
@@ -436,6 +453,21 @@ where
         Box::new(self)
     }
 
+    pub fn legend_rank(mut self, legend_rank: usize) -> Box<Self> {
+        self.legend_rank = Some(legend_rank);
+        Box::new(self)
+    }
+
+    pub fn legend_width(mut self, legend_width: f64) -> Box<Self> {
+        self.legend_width = Some(legend_width);
+        Box::new(self)
+    }
+
+    pub fn ui_revision(mut self, ui_revision: impl Into<NumOrString>) -> Box<Self> {
+        self.ui_revision = Some(ui_revision.into());
+        Box::new(self)
+    }
+
     pub fn y0(mut self, y0: Y) -> Box<Self> {
         self.y0 = Some(y0);
         Box::new(self)
@@ -683,4 +715,17 @@ mod tests {
 
         assert_eq!(to_value(trace).unwrap(), expected);
     }
+
+    #[test]
+    fn serialize_contour_backfilled_attributes() {
+        let trace = Contour::new(vec![0.], vec![0.], vec![1.])
+            .legend_rank(1000)
+            .legend_width(50.0)
+            .ui_revision(6);
+
+        let json = to_value(trace).unwrap();
+        assert_eq!(json["legendrank"], json!(1000));
+        assert_eq!(json["legendwidth"], json!(50.0));
+        assert_eq!(json["uirevision"], json!(6));
+    }
 }
diff --git a/plotly/src/traces/heat_map.rs b/plotly/src/traces/heat_map.rs
index 3279dfda..3652fcf4 100644
--- a/plotly/src/traces/heat_map.rs
+++ b/plotly/src/traces/heat_map.rs
@@ -129,6 +129,19 @@ where
     zmid: Option<f64>,
     zmin: Option<f64>,
     zsmooth: Option<Smoothing>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<Z> HeatMap<f64, f64, Z>
diff --git a/plotly/src/traces/histogram.rs b/plotly/src/traces/histogram.rs
index 5dcbfe0f..9b4ad01d 100644
--- a/plotly/src/traces/histogram.rs
+++ b/plotly/src/traces/histogram.rs
@@ -12,6 +12,7 @@ use crate::{
         Calendar, Dim, ErrorData, HoverInfo, Label, LegendGroupTitle, Marker, Orientation,
         PlotType, Visible, XAxisId, YAxisId,
     },
+    private::NumOrString,
     Trace,
 };
 
@@ -169,6 +170,19 @@ where
     y_bins: Option<Bins>,
     #[serde(rename = "ycalendar")]
     y_calendar: Option<Calendar>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<H> Histogram<H>
diff --git a/plotly/src/traces/ohlc.rs b/plotly/src/traces/ohlc.rs
index 01ccca25..3d5a5185 100644
--- a/plotly/src/traces/ohlc.rs
+++ b/plotly/src/traces/ohlc.rs
@@ -3,6 +3,7 @@
 use plotly_derive::FieldSetter;
 use serde::Serialize;
 
+use crate::private::NumOrString;
 use crate::{
     common::{
         Calendar, Dim, Direction, HoverInfo, Label, LegendGroupTitle, Line, PlotType, Visible,
@@ -77,6 +78,19 @@ where
     visible: Option<Visible>,
     #[serde(rename = "xcalendar")]
     x_calendar: Option<Calendar>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<X, O> Ohlc<X, O>
diff --git a/plotly/src/traces/scatter.rs b/plotly/src/traces/scatter.rs
index e3e8c31a..e7245041 100644
--- a/plotly/src/traces/scatter.rs
+++ b/plotly/src/traces/scatter.rs
@@ -291,6 +291,27 @@ where
     /// Sets the calendar system to use with `y` date data.
     #[serde(rename = "ycalendar")]
     y_calendar: Option<Calendar>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
+    /// Sets the offset group for this trace. Traces in the same group are
+    /// bumped so they don't overlap.
+    #[serde(rename = "offsetgroup")]
+    offset_group: Option<String>,
+    /// Sets the alignment group for this trace. Traces sharing a group align
+    /// their positions.
+    #[serde(rename = "alignmentgroup")]
+    alignment_group: Option<String>,
 }
 
 impl<X, Y> Scatter<X, Y>
@@ -558,4 +579,21 @@ mod tests {
 
         assert_eq!(to_value(trace).unwrap(), expected);
     }
+
+    #[test]
+    fn serialize_scatter_backfilled_attributes() {
+        let trace = Scatter::new(vec![0], vec![0])
+            .legend_rank(1000)
+            .legend_width(50.0)
+            .ui_revision(6)
+            .offset_group("group1")
+            .alignment_group("group2");
+
+        let json = to_value(trace).unwrap();
+        assert_eq!(json["legendrank"], json!(1000));
+        assert_eq!(json["legendwidth"], json!(50.0));
+        assert_eq!(json["uirevision"], json!(6));
+        assert_eq!(json["offsetgroup"], json!("group1"));
+        assert_eq!(json["alignmentgroup"], json!("group2"));
+    }
 }
diff --git a/plotly/src/traces/scatter3d.rs b/plotly/src/traces/scatter3d.rs
index d4203cb6..e5aaae44 100644
--- a/plotly/src/traces/scatter3d.rs
+++ b/plotly/src/traces/scatter3d.rs
@@ -5,6 +5,7 @@ use ndarray::{Array, Ix1};
 use plotly_derive::FieldSetter;
 use serde::Serialize;
 
+use crate::private::NumOrString;
 use crate::{
     color::Color,
     common::{
@@ -270,6 +271,13 @@ where
     /// Sets the calendar system to use with `z` date data.
     #[serde(rename = "zcalendar")]
     z_calendar: Option<Calendar>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<X, Y, Z> Scatter3D<X, Y, Z>
diff --git a/plotly/src/traces/scatter_polar.rs b/plotly/src/traces/scatter_polar.rs
index f8ea1c9a..3bd47e6e 100644
--- a/plotly/src/traces/scatter_polar.rs
+++ b/plotly/src/traces/scatter_polar.rs
@@ -221,6 +221,19 @@ where
     /// "fills", otherwise it is "points".
     #[serde(rename = "hoveron")]
     hover_on: Option<HoverOn>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<Theta, R> ScatterPolar<Theta, R>
diff --git a/plotly/src/traces/sunburst.rs b/plotly/src/traces/sunburst.rs
index f9e62145..b49571af 100644
--- a/plotly/src/traces/sunburst.rs
+++ b/plotly/src/traces/sunburst.rs
@@ -169,6 +169,10 @@ where
     /// Assign an id to this trace. Use this to provide object constancy between
     /// traces during animations and transitions.
     uid: Option<String>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<V> Sunburst<V>
diff --git a/plotly/src/traces/surface.rs b/plotly/src/traces/surface.rs
index 90edc1f5..5e9a11d0 100644
--- a/plotly/src/traces/surface.rs
+++ b/plotly/src/traces/surface.rs
@@ -3,6 +3,7 @@
 use plotly_derive::FieldSetter;
 use serde::Serialize;
 
+use crate::private::NumOrString;
 use crate::{
     color::Color,
     common::{
@@ -174,6 +175,19 @@ where
     y_calendar: Option<Calendar>,
     #[serde(rename = "zcalendar")]
     z_calendar: Option<Calendar>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<X, Y, Z> Surface<X, Y, Z>
diff --git a/plotly/src/traces/table.rs b/plotly/src/traces/table.rs
index c2da7a51..0da9d89f 100644
--- a/plotly/src/traces/table.rs
+++ b/plotly/src/traces/table.rs
@@ -3,6 +3,7 @@
 use plotly_derive::FieldSetter;
 use serde::Serialize;
 
+use crate::private::NumOrString;
 use crate::{
     color::Color,
     common::{Dim, PlotType, Visible},
@@ -46,6 +47,10 @@ where
     /// must be the same (longer vectors, will be truncated). Each value
     /// must be a finite number or a string.
     cells: Option<Cells<N>>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<T, N> Table<T, N>
diff --git a/plotly/src/traces/treemap.rs b/plotly/src/traces/treemap.rs
index 367dc96b..dd2a0650 100644
--- a/plotly/src/traces/treemap.rs
+++ b/plotly/src/traces/treemap.rs
@@ -342,6 +342,10 @@ where
     /// Assign an id to this trace. Use this to provide object constancy between
     /// traces during animations and transitions.
     uid: Option<String>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<V> Treemap<V>
diff --git a/plotly/src/traces/violin.rs b/plotly/src/traces/violin.rs
index f5575b4b..3d49357b 100644
--- a/plotly/src/traces/violin.rs
+++ b/plotly/src/traces/violin.rs
@@ -239,6 +239,19 @@ where
     quartile_method: Option<QuartileMethod>,
     #[serde(rename = "zorder")]
     z_order: Option<i32>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
+    /// Controls persistence of user-driven changes to the trace. Defaults to
+    /// `layout.uirevision`.
+    #[serde(rename = "uirevision")]
+    ui_revision: Option<NumOrString>,
 }
 
 impl<Y> Violin<f64, Y>

From 0d910539373eda36af49252051fd93fce225732c Mon Sep 17 00:00:00 2001
From: Joel Natividad <1980690+jqnatividad@users.noreply.github.com>
Date: Sat, 11 Jul 2026 09:29:33 -0400
Subject: [PATCH 3/8] feat(traces): backfill selection styling and zorder on
 cartesian traces

Add plotly.js interaction/layering attributes to the cartesian traces
that lacked them, reusing the shared common::Selection struct:

- selected, unselected, selectedpoints on Scatter, Bar, BoxPlot, Histogram.
- selectedpoints only on Candlestick and Ohlc (finance traces expose the
  selection array but not selected/unselected marker styling).
- zorder on Scatter, Bar, BoxPlot, Histogram, HeatMap, Contour, Candlestick,
  Ohlc (SVG draw order; Violin already had it).

Additive Option<T> fields with serde renames. Contour (hand-written builder)
got its field, Default entry, and setter by hand. Extended the Scatter and
Contour rename-guard tests.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Andrei Gherghescu <8067229+andrei-ng@users.noreply.github.com>
---
 plotly/src/traces/bar.rs         | 15 +++++++++++++--
 plotly/src/traces/box_plot.rs    | 15 +++++++++++++--
 plotly/src/traces/candlestick.rs |  9 ++++++++-
 plotly/src/traces/contour.rs     | 14 +++++++++++++-
 plotly/src/traces/heat_map.rs    |  4 ++++
 plotly/src/traces/histogram.rs   | 15 +++++++++++++--
 plotly/src/traces/ohlc.rs        |  9 ++++++++-
 plotly/src/traces/scatter.rs     | 25 +++++++++++++++++++++++--
 8 files changed, 95 insertions(+), 11 deletions(-)

diff --git a/plotly/src/traces/bar.rs b/plotly/src/traces/bar.rs
index 9d665194..8dc1a277 100644
--- a/plotly/src/traces/bar.rs
+++ b/plotly/src/traces/bar.rs
@@ -6,9 +6,9 @@ use serde::Serialize;
 use crate::{
     common::{
         Calendar, ConstrainText, Dim, ErrorData, Font, HoverInfo, Label, LegendGroupTitle, Marker,
-        Orientation, PlotType, TextAnchor, TextPosition, Visible, XAxisId, YAxisId,
+        Orientation, PlotType, Selection, TextAnchor, TextPosition, Visible, XAxisId, YAxisId,
     },
-    private::NumOrString,
+    private::{NumOrString, NumOrStringCollection},
     Trace,
 };
 
@@ -119,6 +119,17 @@ where
     /// `layout.uirevision`.
     #[serde(rename = "uirevision")]
     ui_revision: Option<NumOrString>,
+    /// Array of integer indices of the points in this trace that are selected.
+    #[serde(rename = "selectedpoints")]
+    selected_points: Option<NumOrStringCollection>,
+    /// Sets the style of selected points.
+    selected: Option<Selection>,
+    /// Sets the style of unselected points.
+    unselected: Option<Selection>,
+    /// Sets the layer on which this trace is displayed relative to other SVG
+    /// traces on the same subplot. A higher `zorder` appears on top.
+    #[serde(rename = "zorder")]
+    z_order: Option<i32>,
 }
 
 impl<X, Y> Bar<X, Y>
diff --git a/plotly/src/traces/box_plot.rs b/plotly/src/traces/box_plot.rs
index d6aea5b0..2187c678 100644
--- a/plotly/src/traces/box_plot.rs
+++ b/plotly/src/traces/box_plot.rs
@@ -7,9 +7,9 @@ use crate::{
     color::Color,
     common::{
         Calendar, Dim, HoverInfo, Label, LegendGroupTitle, Line, Marker, Orientation, PlotType,
-        Visible, XAxisId, YAxisId,
+        Selection, Visible, XAxisId, YAxisId,
     },
-    private::NumOrString,
+    private::{NumOrString, NumOrStringCollection},
     Trace,
 };
 
@@ -186,6 +186,17 @@ where
     /// `layout.uirevision`.
     #[serde(rename = "uirevision")]
     ui_revision: Option<NumOrString>,
+    /// Array of integer indices of the points in this trace that are selected.
+    #[serde(rename = "selectedpoints")]
+    selected_points: Option<NumOrStringCollection>,
+    /// Sets the style of selected points.
+    selected: Option<Selection>,
+    /// Sets the style of unselected points.
+    unselected: Option<Selection>,
+    /// Sets the layer on which this trace is displayed relative to other SVG
+    /// traces on the same subplot. A higher `zorder` appears on top.
+    #[serde(rename = "zorder")]
+    z_order: Option<i32>,
 }
 
 impl<Y> BoxPlot<f64, Y>
diff --git a/plotly/src/traces/candlestick.rs b/plotly/src/traces/candlestick.rs
index c9ff4e50..a82ae137 100644
--- a/plotly/src/traces/candlestick.rs
+++ b/plotly/src/traces/candlestick.rs
@@ -3,7 +3,7 @@
 use plotly_derive::FieldSetter;
 use serde::Serialize;
 
-use crate::private::NumOrString;
+use crate::private::{NumOrString, NumOrStringCollection};
 use crate::{
     color::NamedColor,
     common::{
@@ -103,6 +103,13 @@ where
     /// `layout.uirevision`.
     #[serde(rename = "uirevision")]
     ui_revision: Option<NumOrString>,
+    /// Array of integer indices of the points in this trace that are selected.
+    #[serde(rename = "selectedpoints")]
+    selected_points: Option<NumOrStringCollection>,
+    /// Sets the layer on which this trace is displayed relative to other SVG
+    /// traces on the same subplot. A higher `zorder` appears on top.
+    #[serde(rename = "zorder")]
+    z_order: Option<i32>,
 }
 
 impl<T, O> Candlestick<T, O>
diff --git a/plotly/src/traces/contour.rs b/plotly/src/traces/contour.rs
index 28e0588c..022316ec 100644
--- a/plotly/src/traces/contour.rs
+++ b/plotly/src/traces/contour.rs
@@ -191,6 +191,10 @@ where
     /// `layout.uirevision`.
     #[serde(rename = "uirevision")]
     ui_revision: Option<NumOrString>,
+    /// Sets the layer on which this trace is displayed relative to other SVG
+    /// traces on the same subplot. A higher `zorder` appears on top.
+    #[serde(rename = "zorder")]
+    z_order: Option<i32>,
 }
 
 impl<Z, X, Y> Default for Contour<Z, X, Y>
@@ -246,6 +250,7 @@ where
             legend_rank: None,
             legend_width: None,
             ui_revision: None,
+            z_order: None,
         }
     }
 }
@@ -468,6 +473,11 @@ where
         Box::new(self)
     }
 
+    pub fn z_order(mut self, z_order: i32) -> Box<Self> {
+        self.z_order = Some(z_order);
+        Box::new(self)
+    }
+
     pub fn y0(mut self, y0: Y) -> Box<Self> {
         self.y0 = Some(y0);
         Box::new(self)
@@ -721,11 +731,13 @@ mod tests {
         let trace = Contour::new(vec![0.], vec![0.], vec![1.])
             .legend_rank(1000)
             .legend_width(50.0)
-            .ui_revision(6);
+            .ui_revision(6)
+            .z_order(3);
 
         let json = to_value(trace).unwrap();
         assert_eq!(json["legendrank"], json!(1000));
         assert_eq!(json["legendwidth"], json!(50.0));
         assert_eq!(json["uirevision"], json!(6));
+        assert_eq!(json["zorder"], json!(3));
     }
 }
diff --git a/plotly/src/traces/heat_map.rs b/plotly/src/traces/heat_map.rs
index 3652fcf4..dfcce7f5 100644
--- a/plotly/src/traces/heat_map.rs
+++ b/plotly/src/traces/heat_map.rs
@@ -142,6 +142,10 @@ where
     /// `layout.uirevision`.
     #[serde(rename = "uirevision")]
     ui_revision: Option<NumOrString>,
+    /// Sets the layer on which this trace is displayed relative to other SVG
+    /// traces on the same subplot. A higher `zorder` appears on top.
+    #[serde(rename = "zorder")]
+    z_order: Option<i32>,
 }
 
 impl<Z> HeatMap<f64, f64, Z>
diff --git a/plotly/src/traces/histogram.rs b/plotly/src/traces/histogram.rs
index 9b4ad01d..32adb1d4 100644
--- a/plotly/src/traces/histogram.rs
+++ b/plotly/src/traces/histogram.rs
@@ -10,9 +10,9 @@ use crate::ndarray::ArrayTraces;
 use crate::{
     common::{
         Calendar, Dim, ErrorData, HoverInfo, Label, LegendGroupTitle, Marker, Orientation,
-        PlotType, Visible, XAxisId, YAxisId,
+        PlotType, Selection, Visible, XAxisId, YAxisId,
     },
-    private::NumOrString,
+    private::{NumOrString, NumOrStringCollection},
     Trace,
 };
 
@@ -183,6 +183,17 @@ where
     /// `layout.uirevision`.
     #[serde(rename = "uirevision")]
     ui_revision: Option<NumOrString>,
+    /// Array of integer indices of the points in this trace that are selected.
+    #[serde(rename = "selectedpoints")]
+    selected_points: Option<NumOrStringCollection>,
+    /// Sets the style of selected points.
+    selected: Option<Selection>,
+    /// Sets the style of unselected points.
+    unselected: Option<Selection>,
+    /// Sets the layer on which this trace is displayed relative to other SVG
+    /// traces on the same subplot. A higher `zorder` appears on top.
+    #[serde(rename = "zorder")]
+    z_order: Option<i32>,
 }
 
 impl<H> Histogram<H>
diff --git a/plotly/src/traces/ohlc.rs b/plotly/src/traces/ohlc.rs
index 3d5a5185..aa2336d9 100644
--- a/plotly/src/traces/ohlc.rs
+++ b/plotly/src/traces/ohlc.rs
@@ -3,7 +3,7 @@
 use plotly_derive::FieldSetter;
 use serde::Serialize;
 
-use crate::private::NumOrString;
+use crate::private::{NumOrString, NumOrStringCollection};
 use crate::{
     common::{
         Calendar, Dim, Direction, HoverInfo, Label, LegendGroupTitle, Line, PlotType, Visible,
@@ -91,6 +91,13 @@ where
     /// `layout.uirevision`.
     #[serde(rename = "uirevision")]
     ui_revision: Option<NumOrString>,
+    /// Array of integer indices of the points in this trace that are selected.
+    #[serde(rename = "selectedpoints")]
+    selected_points: Option<NumOrStringCollection>,
+    /// Sets the layer on which this trace is displayed relative to other SVG
+    /// traces on the same subplot. A higher `zorder` appears on top.
+    #[serde(rename = "zorder")]
+    z_order: Option<i32>,
 }
 
 impl<X, O> Ohlc<X, O>
diff --git a/plotly/src/traces/scatter.rs b/plotly/src/traces/scatter.rs
index e7245041..87014507 100644
--- a/plotly/src/traces/scatter.rs
+++ b/plotly/src/traces/scatter.rs
@@ -11,7 +11,7 @@ use crate::{
     color::Color,
     common::{
         Calendar, Dim, ErrorData, Fill, Font, HoverInfo, HoverOn, Label, LegendGroupTitle, Line,
-        Marker, Mode, Orientation, PlotType, Position, Visible, XAxisId, YAxisId,
+        Marker, Mode, Orientation, PlotType, Position, Selection, Visible, XAxisId, YAxisId,
     },
     private::{NumOrString, NumOrStringCollection},
     Trace,
@@ -312,6 +312,17 @@ where
     /// their positions.
     #[serde(rename = "alignmentgroup")]
     alignment_group: Option<String>,
+    /// Array of integer indices of the points in this trace that are selected.
+    #[serde(rename = "selectedpoints")]
+    selected_points: Option<NumOrStringCollection>,
+    /// Sets the style of selected points.
+    selected: Option<Selection>,
+    /// Sets the style of unselected points.
+    unselected: Option<Selection>,
+    /// Sets the layer on which this trace is displayed relative to other SVG
+    /// traces on the same subplot. A higher `zorder` appears on top.
+    #[serde(rename = "zorder")]
+    z_order: Option<i32>,
 }
 
 impl<X, Y> Scatter<X, Y>
@@ -582,12 +593,18 @@ mod tests {
 
     #[test]
     fn serialize_scatter_backfilled_attributes() {
+        use crate::common::Selection;
+
         let trace = Scatter::new(vec![0], vec![0])
             .legend_rank(1000)
             .legend_width(50.0)
             .ui_revision(6)
             .offset_group("group1")
-            .alignment_group("group2");
+            .alignment_group("group2")
+            .selected_points(vec![0])
+            .selected(Selection::new().opacity(1.0))
+            .unselected(Selection::new().opacity(0.2))
+            .z_order(3);
 
         let json = to_value(trace).unwrap();
         assert_eq!(json["legendrank"], json!(1000));
@@ -595,5 +612,9 @@ mod tests {
         assert_eq!(json["uirevision"], json!(6));
         assert_eq!(json["offsetgroup"], json!("group1"));
         assert_eq!(json["alignmentgroup"], json!("group2"));
+        assert_eq!(json["selectedpoints"], json!([0]));
+        assert_eq!(json["selected"], json!({"marker": {"opacity": 1.0}}));
+        assert_eq!(json["unselected"], json!({"marker": {"opacity": 0.2}}));
+        assert_eq!(json["zorder"], json!(3));
     }
 }

From 759eac3d04836573381d5bb1ba63b3e0163858a7 Mon Sep 17 00:00:00 2001
From: Joel Natividad <1980690+jqnatividad@users.noreply.github.com>
Date: Sat, 11 Jul 2026 09:33:18 -0400
Subject: [PATCH 4/8] feat(traces): backfill date-axis period positioning
 attributes

Add a PeriodAlignment enum to common and the plotly.js period-positioning
attributes to the cartesian traces that support them:

- xperiod/xperiod0/xperiodalignment and yperiod/yperiod0/yperiodalignment
  on Scatter, Bar, BoxPlot, HeatMap, Contour.
- x-period only on Candlestick and Ohlc (x is the date axis for finance
  traces; they have no y-period).

Histogram is intentionally excluded (it bins raw data via xbins and has no
period attributes). Additive Option<T> fields; Contour's hand-written
builder got fields, Default entries, and setters by hand. Extended the
Scatter rename-guard test.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Andrei Gherghescu <8067229+andrei-ng@users.noreply.github.com>
---
 plotly/src/common/mod.rs         | 11 ++++++
 plotly/src/traces/bar.rs         | 25 ++++++++++++-
 plotly/src/traces/box_plot.rs    | 26 ++++++++++++--
 plotly/src/traces/candlestick.rs | 15 ++++++--
 plotly/src/traces/contour.rs     | 60 +++++++++++++++++++++++++++++++-
 plotly/src/traces/heat_map.rs    | 26 ++++++++++++--
 plotly/src/traces/ohlc.rs        | 14 +++++++-
 plotly/src/traces/scatter.rs     | 35 +++++++++++++++++--
 8 files changed, 200 insertions(+), 12 deletions(-)

diff --git a/plotly/src/common/mod.rs b/plotly/src/common/mod.rs
index d7cae3bd..da87ed02 100644
--- a/plotly/src/common/mod.rs
+++ b/plotly/src/common/mod.rs
@@ -685,6 +685,17 @@ impl Selection {
     }
 }
 
+/// Alignment of the period on a date axis, controlling where within each
+/// period the point is drawn (used by the `xperiodalignment` /
+/// `yperiodalignment` trace attributes).
+#[derive(Serialize, Clone, Debug)]
+#[serde(rename_all = "lowercase")]
+pub enum PeriodAlignment {
+    Start,
+    Middle,
+    End,
+}
+
 #[serde_with::skip_serializing_none]
 #[derive(Serialize, Clone, Debug, FieldSetter)]
 pub struct TickFormatStop {
diff --git a/plotly/src/traces/bar.rs b/plotly/src/traces/bar.rs
index 8dc1a277..4089f204 100644
--- a/plotly/src/traces/bar.rs
+++ b/plotly/src/traces/bar.rs
@@ -6,7 +6,8 @@ use serde::Serialize;
 use crate::{
     common::{
         Calendar, ConstrainText, Dim, ErrorData, Font, HoverInfo, Label, LegendGroupTitle, Marker,
-        Orientation, PlotType, Selection, TextAnchor, TextPosition, Visible, XAxisId, YAxisId,
+        Orientation, PeriodAlignment, PlotType, Selection, TextAnchor, TextPosition, Visible,
+        XAxisId, YAxisId,
     },
     private::{NumOrString, NumOrStringCollection},
     Trace,
@@ -130,6 +131,28 @@ where
     /// traces on the same subplot. A higher `zorder` appears on top.
     #[serde(rename = "zorder")]
     z_order: Option<i32>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the x axis.
+    #[serde(rename = "xperiod")]
+    x_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the x axis.
+    #[serde(rename = "xperiod0")]
+    x_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the x axis relative to the period.
+    #[serde(rename = "xperiodalignment")]
+    x_period_alignment: Option<PeriodAlignment>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the y axis.
+    #[serde(rename = "yperiod")]
+    y_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the y axis.
+    #[serde(rename = "yperiod0")]
+    y_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the y axis relative to the period.
+    #[serde(rename = "yperiodalignment")]
+    y_period_alignment: Option<PeriodAlignment>,
 }
 
 impl<X, Y> Bar<X, Y>
diff --git a/plotly/src/traces/box_plot.rs b/plotly/src/traces/box_plot.rs
index 2187c678..346b6b9f 100644
--- a/plotly/src/traces/box_plot.rs
+++ b/plotly/src/traces/box_plot.rs
@@ -6,8 +6,8 @@ use serde::{Serialize, Serializer};
 use crate::{
     color::Color,
     common::{
-        Calendar, Dim, HoverInfo, Label, LegendGroupTitle, Line, Marker, Orientation, PlotType,
-        Selection, Visible, XAxisId, YAxisId,
+        Calendar, Dim, HoverInfo, Label, LegendGroupTitle, Line, Marker, Orientation,
+        PeriodAlignment, PlotType, Selection, Visible, XAxisId, YAxisId,
     },
     private::{NumOrString, NumOrStringCollection},
     Trace,
@@ -197,6 +197,28 @@ where
     /// traces on the same subplot. A higher `zorder` appears on top.
     #[serde(rename = "zorder")]
     z_order: Option<i32>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the x axis.
+    #[serde(rename = "xperiod")]
+    x_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the x axis.
+    #[serde(rename = "xperiod0")]
+    x_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the x axis relative to the period.
+    #[serde(rename = "xperiodalignment")]
+    x_period_alignment: Option<PeriodAlignment>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the y axis.
+    #[serde(rename = "yperiod")]
+    y_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the y axis.
+    #[serde(rename = "yperiod0")]
+    y_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the y axis relative to the period.
+    #[serde(rename = "yperiodalignment")]
+    y_period_alignment: Option<PeriodAlignment>,
 }
 
 impl<Y> BoxPlot<f64, Y>
diff --git a/plotly/src/traces/candlestick.rs b/plotly/src/traces/candlestick.rs
index a82ae137..0213a861 100644
--- a/plotly/src/traces/candlestick.rs
+++ b/plotly/src/traces/candlestick.rs
@@ -7,8 +7,8 @@ use crate::private::{NumOrString, NumOrStringCollection};
 use crate::{
     color::NamedColor,
     common::{
-        Calendar, Dim, Direction, HoverInfo, Label, LegendGroupTitle, Line, PlotType, Visible,
-        XAxisId, YAxisId,
+        Calendar, Dim, Direction, HoverInfo, Label, LegendGroupTitle, Line, PeriodAlignment,
+        PlotType, Visible, XAxisId, YAxisId,
     },
     Trace,
 };
@@ -110,6 +110,17 @@ where
     /// traces on the same subplot. A higher `zorder` appears on top.
     #[serde(rename = "zorder")]
     z_order: Option<i32>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the x axis.
+    #[serde(rename = "xperiod")]
+    x_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the x axis.
+    #[serde(rename = "xperiod0")]
+    x_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the x axis relative to the period.
+    #[serde(rename = "xperiodalignment")]
+    x_period_alignment: Option<PeriodAlignment>,
 }
 
 impl<T, O> Candlestick<T, O>
diff --git a/plotly/src/traces/contour.rs b/plotly/src/traces/contour.rs
index 022316ec..c39f9659 100644
--- a/plotly/src/traces/contour.rs
+++ b/plotly/src/traces/contour.rs
@@ -7,7 +7,7 @@ use crate::{
     color::Color,
     common::{
         Calendar, ColorBar, ColorScale, Dim, Font, HoverInfo, Label, LegendGroupTitle, Line,
-        PlotType, Visible, XAxisId, YAxisId,
+        PeriodAlignment, PlotType, Visible, XAxisId, YAxisId,
     },
     private::{self, NumOrString},
     Trace,
@@ -195,6 +195,28 @@ where
     /// traces on the same subplot. A higher `zorder` appears on top.
     #[serde(rename = "zorder")]
     z_order: Option<i32>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the x axis.
+    #[serde(rename = "xperiod")]
+    x_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the x axis.
+    #[serde(rename = "xperiod0")]
+    x_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the x axis relative to the period.
+    #[serde(rename = "xperiodalignment")]
+    x_period_alignment: Option<PeriodAlignment>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the y axis.
+    #[serde(rename = "yperiod")]
+    y_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the y axis.
+    #[serde(rename = "yperiod0")]
+    y_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the y axis relative to the period.
+    #[serde(rename = "yperiodalignment")]
+    y_period_alignment: Option<PeriodAlignment>,
 }
 
 impl<Z, X, Y> Default for Contour<Z, X, Y>
@@ -251,6 +273,12 @@ where
             legend_width: None,
             ui_revision: None,
             z_order: None,
+            x_period: None,
+            x_period0: None,
+            x_period_alignment: None,
+            y_period: None,
+            y_period0: None,
+            y_period_alignment: None,
         }
     }
 }
@@ -478,6 +506,36 @@ where
         Box::new(self)
     }
 
+    pub fn x_period(mut self, x_period: impl Into<NumOrString>) -> Box<Self> {
+        self.x_period = Some(x_period.into());
+        Box::new(self)
+    }
+
+    pub fn x_period0(mut self, x_period0: impl Into<NumOrString>) -> Box<Self> {
+        self.x_period0 = Some(x_period0.into());
+        Box::new(self)
+    }
+
+    pub fn x_period_alignment(mut self, x_period_alignment: PeriodAlignment) -> Box<Self> {
+        self.x_period_alignment = Some(x_period_alignment);
+        Box::new(self)
+    }
+
+    pub fn y_period(mut self, y_period: impl Into<NumOrString>) -> Box<Self> {
+        self.y_period = Some(y_period.into());
+        Box::new(self)
+    }
+
+    pub fn y_period0(mut self, y_period0: impl Into<NumOrString>) -> Box<Self> {
+        self.y_period0 = Some(y_period0.into());
+        Box::new(self)
+    }
+
+    pub fn y_period_alignment(mut self, y_period_alignment: PeriodAlignment) -> Box<Self> {
+        self.y_period_alignment = Some(y_period_alignment);
+        Box::new(self)
+    }
+
     pub fn y0(mut self, y0: Y) -> Box<Self> {
         self.y0 = Some(y0);
         Box::new(self)
diff --git a/plotly/src/traces/heat_map.rs b/plotly/src/traces/heat_map.rs
index dfcce7f5..18c6e414 100644
--- a/plotly/src/traces/heat_map.rs
+++ b/plotly/src/traces/heat_map.rs
@@ -5,8 +5,8 @@ use serde::Serialize;
 
 use crate::{
     common::{
-        Calendar, ColorBar, ColorScale, Dim, HoverInfo, Label, LegendGroupTitle, PlotType, Visible,
-        XAxisId, YAxisId,
+        Calendar, ColorBar, ColorScale, Dim, HoverInfo, Label, LegendGroupTitle, PeriodAlignment,
+        PlotType, Visible, XAxisId, YAxisId,
     },
     private::{NumOrString, NumOrStringCollection},
     Trace,
@@ -146,6 +146,28 @@ where
     /// traces on the same subplot. A higher `zorder` appears on top.
     #[serde(rename = "zorder")]
     z_order: Option<i32>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the x axis.
+    #[serde(rename = "xperiod")]
+    x_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the x axis.
+    #[serde(rename = "xperiod0")]
+    x_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the x axis relative to the period.
+    #[serde(rename = "xperiodalignment")]
+    x_period_alignment: Option<PeriodAlignment>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the y axis.
+    #[serde(rename = "yperiod")]
+    y_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the y axis.
+    #[serde(rename = "yperiod0")]
+    y_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the y axis relative to the period.
+    #[serde(rename = "yperiodalignment")]
+    y_period_alignment: Option<PeriodAlignment>,
 }
 
 impl<Z> HeatMap<f64, f64, Z>
diff --git a/plotly/src/traces/ohlc.rs b/plotly/src/traces/ohlc.rs
index aa2336d9..299db2b3 100644
--- a/plotly/src/traces/ohlc.rs
+++ b/plotly/src/traces/ohlc.rs
@@ -6,7 +6,8 @@ use serde::Serialize;
 use crate::private::{NumOrString, NumOrStringCollection};
 use crate::{
     common::{
-        Calendar, Dim, Direction, HoverInfo, Label, LegendGroupTitle, Line, PlotType, Visible,
+        Calendar, Dim, Direction, HoverInfo, Label, LegendGroupTitle, Line, PeriodAlignment,
+        PlotType, Visible,
     },
     Trace,
 };
@@ -98,6 +99,17 @@ where
     /// traces on the same subplot. A higher `zorder` appears on top.
     #[serde(rename = "zorder")]
     z_order: Option<i32>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the x axis.
+    #[serde(rename = "xperiod")]
+    x_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the x axis.
+    #[serde(rename = "xperiod0")]
+    x_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the x axis relative to the period.
+    #[serde(rename = "xperiodalignment")]
+    x_period_alignment: Option<PeriodAlignment>,
 }
 
 impl<X, O> Ohlc<X, O>
diff --git a/plotly/src/traces/scatter.rs b/plotly/src/traces/scatter.rs
index 87014507..45b6ccad 100644
--- a/plotly/src/traces/scatter.rs
+++ b/plotly/src/traces/scatter.rs
@@ -11,7 +11,8 @@ use crate::{
     color::Color,
     common::{
         Calendar, Dim, ErrorData, Fill, Font, HoverInfo, HoverOn, Label, LegendGroupTitle, Line,
-        Marker, Mode, Orientation, PlotType, Position, Selection, Visible, XAxisId, YAxisId,
+        Marker, Mode, Orientation, PeriodAlignment, PlotType, Position, Selection, Visible,
+        XAxisId, YAxisId,
     },
     private::{NumOrString, NumOrStringCollection},
     Trace,
@@ -323,6 +324,28 @@ where
     /// traces on the same subplot. A higher `zorder` appears on top.
     #[serde(rename = "zorder")]
     z_order: Option<i32>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the x axis.
+    #[serde(rename = "xperiod")]
+    x_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the x axis.
+    #[serde(rename = "xperiod0")]
+    x_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the x axis relative to the period.
+    #[serde(rename = "xperiodalignment")]
+    x_period_alignment: Option<PeriodAlignment>,
+    /// Only relevant when the corresponding axis `type` is "date". Sets the
+    /// period positioning in milliseconds or "M<n>" on the y axis.
+    #[serde(rename = "yperiod")]
+    y_period: Option<NumOrString>,
+    /// Only relevant when the axis `type` is "date". Sets the base for period
+    /// positioning on the y axis.
+    #[serde(rename = "yperiod0")]
+    y_period0: Option<NumOrString>,
+    /// Sets the alignment of data points on the y axis relative to the period.
+    #[serde(rename = "yperiodalignment")]
+    y_period_alignment: Option<PeriodAlignment>,
 }
 
 impl<X, Y> Scatter<X, Y>
@@ -593,7 +616,7 @@ mod tests {
 
     #[test]
     fn serialize_scatter_backfilled_attributes() {
-        use crate::common::Selection;
+        use crate::common::{PeriodAlignment, Selection};
 
         let trace = Scatter::new(vec![0], vec![0])
             .legend_rank(1000)
@@ -604,7 +627,10 @@ mod tests {
             .selected_points(vec![0])
             .selected(Selection::new().opacity(1.0))
             .unselected(Selection::new().opacity(0.2))
-            .z_order(3);
+            .z_order(3)
+            .x_period(86400000)
+            .x_period_alignment(PeriodAlignment::Start)
+            .y_period_alignment(PeriodAlignment::End);
 
         let json = to_value(trace).unwrap();
         assert_eq!(json["legendrank"], json!(1000));
@@ -616,5 +642,8 @@ mod tests {
         assert_eq!(json["selected"], json!({"marker": {"opacity": 1.0}}));
         assert_eq!(json["unselected"], json!({"marker": {"opacity": 0.2}}));
         assert_eq!(json["zorder"], json!(3));
+        assert_eq!(json["xperiod"], json!(86400000));
+        assert_eq!(json["xperiodalignment"], json!("start"));
+        assert_eq!(json["yperiodalignment"], json!("end"));
     }
 }

From b94ed1f2fa7784265a72dd00c464446d4ec04182 Mon Sep 17 00:00:00 2001
From: Joel Natividad <1980690+jqnatividad@users.noreply.github.com>
Date: Sat, 11 Jul 2026 09:36:00 -0400
Subject: [PATCH 5/8] feat(traces): add fillpattern and fillgradient to Scatter

Expose plotly.js scatter fill styling beyond a solid fillcolor:

- fillpattern reuses the existing common::Pattern struct.
- fillgradient uses a new common::FillGradient struct (type/start/stop/
  colorscale), distinct from the marker-oriented common::Gradient.

Additive Option<T> fields on Scatter; extended the rename-guard test.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Andrei Gherghescu <8067229+andrei-ng@users.noreply.github.com>
---
 plotly/src/common/mod.rs     | 44 ++++++++++++++++++++++++++++++++++++
 plotly/src/traces/scatter.rs | 21 +++++++++++++----
 2 files changed, 60 insertions(+), 5 deletions(-)

diff --git a/plotly/src/common/mod.rs b/plotly/src/common/mod.rs
index da87ed02..05345710 100644
--- a/plotly/src/common/mod.rs
+++ b/plotly/src/common/mod.rs
@@ -696,6 +696,50 @@ pub enum PeriodAlignment {
     End,
 }
 
+/// Sets a fill gradient for a scatter trace's filled area, as an alternative to
+/// a solid `fill_color`.
+#[serde_with::skip_serializing_none]
+#[derive(Serialize, Clone, Debug, Default)]
+pub struct FillGradient {
+    #[serde(rename = "type")]
+    r#type: Option<GradientType>,
+    start: Option<f64>,
+    stop: Option<f64>,
+    #[serde(rename = "colorscale")]
+    color_scale: Option<ColorScale>,
+}
+
+impl FillGradient {
+    pub fn new() -> Self {
+        Default::default()
+    }
+
+    /// Sets the direction of the gradient (`radial`, `horizontal`, `vertical`).
+    pub fn type_(mut self, gradient_type: GradientType) -> Self {
+        self.r#type = Some(gradient_type);
+        self
+    }
+
+    /// Sets the gradient start value (in the units of the axis the gradient is
+    /// aligned with).
+    pub fn start(mut self, start: f64) -> Self {
+        self.start = Some(start);
+        self
+    }
+
+    /// Sets the gradient stop value.
+    pub fn stop(mut self, stop: f64) -> Self {
+        self.stop = Some(stop);
+        self
+    }
+
+    /// Sets the color scale used across the gradient.
+    pub fn color_scale(mut self, color_scale: ColorScale) -> Self {
+        self.color_scale = Some(color_scale);
+        self
+    }
+}
+
 #[serde_with::skip_serializing_none]
 #[derive(Serialize, Clone, Debug, FieldSetter)]
 pub struct TickFormatStop {
diff --git a/plotly/src/traces/scatter.rs b/plotly/src/traces/scatter.rs
index 45b6ccad..ca239333 100644
--- a/plotly/src/traces/scatter.rs
+++ b/plotly/src/traces/scatter.rs
@@ -10,9 +10,9 @@ use crate::ndarray::ArrayTraces;
 use crate::{
     color::Color,
     common::{
-        Calendar, Dim, ErrorData, Fill, Font, HoverInfo, HoverOn, Label, LegendGroupTitle, Line,
-        Marker, Mode, Orientation, PeriodAlignment, PlotType, Position, Selection, Visible,
-        XAxisId, YAxisId,
+        Calendar, Dim, ErrorData, Fill, FillGradient, Font, HoverInfo, HoverOn, Label,
+        LegendGroupTitle, Line, Marker, Mode, Orientation, Pattern, PeriodAlignment, PlotType,
+        Position, Selection, Visible, XAxisId, YAxisId,
     },
     private::{NumOrString, NumOrStringCollection},
     Trace,
@@ -267,6 +267,13 @@ where
     /// color, marker color, or marker line color, whichever is available.
     #[serde(rename = "fillcolor")]
     fill_color: Option<Box<dyn Color>>,
+    /// Sets a pattern used to fill the area, as an alternative to `fill_color`.
+    #[serde(rename = "fillpattern")]
+    fill_pattern: Option<Pattern>,
+    /// Sets a color gradient used to fill the area, as an alternative to
+    /// `fill_color`.
+    #[serde(rename = "fillgradient")]
+    fill_gradient: Option<FillGradient>,
     /// Properties of label displayed on mouse hover.
     #[serde(rename = "hoverlabel")]
     hover_label: Option<Label>,
@@ -616,7 +623,7 @@ mod tests {
 
     #[test]
     fn serialize_scatter_backfilled_attributes() {
-        use crate::common::{PeriodAlignment, Selection};
+        use crate::common::{FillGradient, GradientType, Pattern, PeriodAlignment, Selection};
 
         let trace = Scatter::new(vec![0], vec![0])
             .legend_rank(1000)
@@ -630,7 +637,9 @@ mod tests {
             .z_order(3)
             .x_period(86400000)
             .x_period_alignment(PeriodAlignment::Start)
-            .y_period_alignment(PeriodAlignment::End);
+            .y_period_alignment(PeriodAlignment::End)
+            .fill_pattern(Pattern::new())
+            .fill_gradient(FillGradient::new().type_(GradientType::Horizontal));
 
         let json = to_value(trace).unwrap();
         assert_eq!(json["legendrank"], json!(1000));
@@ -645,5 +654,7 @@ mod tests {
         assert_eq!(json["xperiod"], json!(86400000));
         assert_eq!(json["xperiodalignment"], json!("start"));
         assert_eq!(json["yperiodalignment"], json!("end"));
+        assert_eq!(json["fillpattern"], json!({}));
+        assert_eq!(json["fillgradient"], json!({"type": "horizontal"}));
     }
 }

From de2abc9cd50dc6a45542e659b144b334d8825c74 Mon Sep 17 00:00:00 2001
From: Joel Natividad <1980690+jqnatividad@users.noreply.github.com>
Date: Sat, 11 Jul 2026 09:36:28 -0400
Subject: [PATCH 6/8] docs(changelog): expand trace attribute backfill entry

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: Andrei Gherghescu <8067229+andrei-ng@users.noreply.github.com>
---
 CHANGELOG.md | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index ea098163..783c6847 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,7 +14,13 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 - [[#414](https://github.com/plotly/plotly.rs/issues/414)] Add `DensityMap` (MapLibre `map` subplot) trace type — density heatmaps with full color-scale and hover support
 - [[#417](https://github.com/plotly/plotly.rs/issues/417)] Add `ScatterMap` (MapLibre `map` subplot) trace type — the modern counterpart to `ScatterMapbox`
 - [[#418](https://github.com/plotly/plotly.rs/issues/418)] Add native point clustering to `ScatterMap` via a `Cluster` option
-- [TBD] Backfill common trace attributes for plotly.js parity: add `legendrank`, `legendwidth`, and `uirevision` to the older trace types that lacked them (`Scatter`, `Bar`, `BoxPlot`, `Violin`, `Histogram`, `HeatMap`, `Contour`, `Candlestick`, `Ohlc`, `Scatter3D`, `Surface`, `ScatterPolar`; `uirevision` only for `Sunburst`, `Treemap`, `Table`), plus `offsetgroup`/`alignmentgroup` on `Scatter`. Consolidate the duplicated `Selection`/`SelectionMarker` structs into `common` (re-exported from their original modules for backward compatibility)
+- [TBD] Backfill common trace attributes on the older trace types for plotly.js 3.7 parity:
+  - `legendrank`, `legendwidth`, `uirevision` on `Scatter`, `Bar`, `BoxPlot`, `Violin`, `Histogram`, `HeatMap`, `Contour`, `Candlestick`, `Ohlc`, `Scatter3D`, `Surface`, `ScatterPolar` (`uirevision` only for `Sunburst`, `Treemap`, `Table`, which do not participate in the legend); `offsetgroup`/`alignmentgroup` on `Scatter`
+  - `selected`/`unselected`/`selectedpoints` on `Scatter`, `Bar`, `BoxPlot`, `Histogram` (`selectedpoints` only on `Candlestick`, `Ohlc`)
+  - `zorder` on `Scatter`, `Bar`, `BoxPlot`, `Histogram`, `HeatMap`, `Contour`, `Candlestick`, `Ohlc`
+  - date-axis period positioning (`xperiod`/`xperiod0`/`xperiodalignment` and the `y` variants) on `Scatter`, `Bar`, `BoxPlot`, `HeatMap`, `Contour` (x-only on `Candlestick`, `Ohlc`), via a new `PeriodAlignment` enum
+  - `fillpattern` (reusing `Pattern`) and `fillgradient` (new `FillGradient` struct) on `Scatter`
+  - Consolidate the duplicated `Selection`/`SelectionMarker` structs into `common` (re-exported from their original modules for backward compatibility)
 
 ### Changed
 

From 9c7be347f270219fe517f7b5e2a7342126449bd2 Mon Sep 17 00:00:00 2001
From: Joel Natividad <1980690+jqnatividad@users.noreply.github.com>
Date: Sat, 11 Jul 2026 09:48:41 -0400
Subject: [PATCH 7/8] fix(backfill): add legendrank/legendwidth to Sunburst,
 Treemap, Table

These hierarchy/table traces lack a `showlegend` attribute but DO expose
`legendrank`, `legendwidth`, `legend`, and `legendgrouptitle` in the
plotly.js 3.7.0 schema, so they participate in the legend. The initial
backfill wrongly gated legend participation on `showlegend` presence and
gave them `uirevision` only.

Verified against the authoritative plotly.js 3.7.0 plot-schema.json.
Adds rename-guard tests for the three traces.

Signed-off-by: Andrei Gherghescu <8067229+andrei-ng@users.noreply.github.com>
---
 CHANGELOG.md                  |  2 +-
 plotly/src/traces/sunburst.rs | 22 ++++++++++++++++++++++
 plotly/src/traces/table.rs    | 23 +++++++++++++++++++++++
 plotly/src/traces/treemap.rs  | 22 ++++++++++++++++++++++
 4 files changed, 68 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 783c6847..6dfe5004 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -15,7 +15,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 - [[#417](https://github.com/plotly/plotly.rs/issues/417)] Add `ScatterMap` (MapLibre `map` subplot) trace type — the modern counterpart to `ScatterMapbox`
 - [[#418](https://github.com/plotly/plotly.rs/issues/418)] Add native point clustering to `ScatterMap` via a `Cluster` option
 - [TBD] Backfill common trace attributes on the older trace types for plotly.js 3.7 parity:
-  - `legendrank`, `legendwidth`, `uirevision` on `Scatter`, `Bar`, `BoxPlot`, `Violin`, `Histogram`, `HeatMap`, `Contour`, `Candlestick`, `Ohlc`, `Scatter3D`, `Surface`, `ScatterPolar` (`uirevision` only for `Sunburst`, `Treemap`, `Table`, which do not participate in the legend); `offsetgroup`/`alignmentgroup` on `Scatter`
+  - `legendrank`, `legendwidth`, `uirevision` on `Scatter`, `Bar`, `BoxPlot`, `Violin`, `Histogram`, `HeatMap`, `Contour`, `Candlestick`, `Ohlc`, `Scatter3D`, `Surface`, `ScatterPolar`, `Sunburst`, `Treemap`, `Table`; `offsetgroup`/`alignmentgroup` on `Scatter`
   - `selected`/`unselected`/`selectedpoints` on `Scatter`, `Bar`, `BoxPlot`, `Histogram` (`selectedpoints` only on `Candlestick`, `Ohlc`)
   - `zorder` on `Scatter`, `Bar`, `BoxPlot`, `Histogram`, `HeatMap`, `Contour`, `Candlestick`, `Ohlc`
   - date-axis period positioning (`xperiod`/`xperiod0`/`xperiodalignment` and the `y` variants) on `Scatter`, `Bar`, `BoxPlot`, `HeatMap`, `Contour` (x-only on `Candlestick`, `Ohlc`), via a new `PeriodAlignment` enum
diff --git a/plotly/src/traces/sunburst.rs b/plotly/src/traces/sunburst.rs
index b49571af..b0815cc7 100644
--- a/plotly/src/traces/sunburst.rs
+++ b/plotly/src/traces/sunburst.rs
@@ -169,6 +169,15 @@ where
     /// Assign an id to this trace. Use this to provide object constancy between
     /// traces during animations and transitions.
     uid: Option<String>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
     /// Controls persistence of user-driven changes to the trace. Defaults to
     /// `layout.uirevision`.
     #[serde(rename = "uirevision")]
@@ -277,4 +286,17 @@ mod tests {
 
         assert_eq!(to_value(trace).unwrap(), expected);
     }
+
+    #[test]
+    fn serialize_sunburst_legend_and_uirevision() {
+        let trace = Sunburst::new(vec!["Eve"], vec![""])
+            .values(vec![10])
+            .legend_rank(7)
+            .legend_width(2.0)
+            .ui_revision("rev");
+        let v = to_value(trace).unwrap();
+        assert_eq!(v["legendrank"], json!(7));
+        assert_eq!(v["legendwidth"], json!(2.0));
+        assert_eq!(v["uirevision"], json!("rev"));
+    }
 }
diff --git a/plotly/src/traces/table.rs b/plotly/src/traces/table.rs
index 0da9d89f..2ecd6584 100644
--- a/plotly/src/traces/table.rs
+++ b/plotly/src/traces/table.rs
@@ -47,6 +47,15 @@ where
     /// must be the same (longer vectors, will be truncated). Each value
     /// must be a finite number or a string.
     cells: Option<Cells<N>>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
     /// Controls persistence of user-driven changes to the trace. Defaults to
     /// `layout.uirevision`.
     #[serde(rename = "uirevision")]
@@ -362,4 +371,18 @@ mod tests {
 
         assert_eq!(to_value(trace).unwrap(), expected);
     }
+
+    #[test]
+    fn serialize_table_legend_and_uirevision() {
+        let columns = Header::new(vec![String::from("col1")]);
+        let values = Cells::new(vec![vec![1, 2]]);
+        let trace = Table::new(columns, values)
+            .legend_rank(7)
+            .legend_width(2.0)
+            .ui_revision("rev");
+        let v = to_value(trace).unwrap();
+        assert_eq!(v["legendrank"], json!(7));
+        assert_eq!(v["legendwidth"], json!(2.0));
+        assert_eq!(v["uirevision"], json!("rev"));
+    }
 }
diff --git a/plotly/src/traces/treemap.rs b/plotly/src/traces/treemap.rs
index dd2a0650..d71e8912 100644
--- a/plotly/src/traces/treemap.rs
+++ b/plotly/src/traces/treemap.rs
@@ -342,6 +342,15 @@ where
     /// Assign an id to this trace. Use this to provide object constancy between
     /// traces during animations and transitions.
     uid: Option<String>,
+    /// Sets the legend rank for this trace. Items and groups with smaller ranks
+    /// are presented on top/left side while with `"reversed"`
+    /// `legend.trace_order` they are on bottom/right side. The default
+    /// legendrank is 1000.
+    #[serde(rename = "legendrank")]
+    legend_rank: Option<usize>,
+    /// Sets the width (in px or fraction) of the legend for this trace.
+    #[serde(rename = "legendwidth")]
+    legend_width: Option<f64>,
     /// Controls persistence of user-driven changes to the trace. Defaults to
     /// `layout.uirevision`.
     #[serde(rename = "uirevision")]
@@ -530,4 +539,17 @@ mod tests {
 
         assert_eq!(to_value(trace).unwrap(), expected);
     }
+
+    #[test]
+    fn serialize_treemap_legend_and_uirevision() {
+        let trace = Treemap::new(vec!["Eve"], vec![""])
+            .values(vec![10])
+            .legend_rank(7)
+            .legend_width(2.0)
+            .ui_revision("rev");
+        let v = to_value(trace).unwrap();
+        assert_eq!(v["legendrank"], json!(7));
+        assert_eq!(v["legendwidth"], json!(2.0));
+        assert_eq!(v["uirevision"], json!("rev"));
+    }
 }

From ab500796c54d40387f32158636aa997d91a4bf88 Mon Sep 17 00:00:00 2001
From: Joel Natividad <1980690+jqnatividad@users.noreply.github.com>
Date: Sat, 11 Jul 2026 10:01:51 -0400
Subject: [PATCH 8/8] docs(changelog): update changelog with PR description

Signed-off-by: Andrei Gherghescu <8067229+andrei-ng@users.noreply.github.com>
---
 CHANGELOG.md | 8 +-------
 1 file changed, 1 insertion(+), 7 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6dfe5004..a5ed842b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,13 +14,7 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/) a
 - [[#414](https://github.com/plotly/plotly.rs/issues/414)] Add `DensityMap` (MapLibre `map` subplot) trace type — density heatmaps with full color-scale and hover support
 - [[#417](https://github.com/plotly/plotly.rs/issues/417)] Add `ScatterMap` (MapLibre `map` subplot) trace type — the modern counterpart to `ScatterMapbox`
 - [[#418](https://github.com/plotly/plotly.rs/issues/418)] Add native point clustering to `ScatterMap` via a `Cluster` option
-- [TBD] Backfill common trace attributes on the older trace types for plotly.js 3.7 parity:
-  - `legendrank`, `legendwidth`, `uirevision` on `Scatter`, `Bar`, `BoxPlot`, `Violin`, `Histogram`, `HeatMap`, `Contour`, `Candlestick`, `Ohlc`, `Scatter3D`, `Surface`, `ScatterPolar`, `Sunburst`, `Treemap`, `Table`; `offsetgroup`/`alignmentgroup` on `Scatter`
-  - `selected`/`unselected`/`selectedpoints` on `Scatter`, `Bar`, `BoxPlot`, `Histogram` (`selectedpoints` only on `Candlestick`, `Ohlc`)
-  - `zorder` on `Scatter`, `Bar`, `BoxPlot`, `Histogram`, `HeatMap`, `Contour`, `Candlestick`, `Ohlc`
-  - date-axis period positioning (`xperiod`/`xperiod0`/`xperiodalignment` and the `y` variants) on `Scatter`, `Bar`, `BoxPlot`, `HeatMap`, `Contour` (x-only on `Candlestick`, `Ohlc`), via a new `PeriodAlignment` enum
-  - `fillpattern` (reusing `Pattern`) and `fillgradient` (new `FillGradient` struct) on `Scatter`
-  - Consolidate the duplicated `Selection`/`SelectionMarker` structs into `common` (re-exported from their original modules for backward compatibility)
+- [[#421](https://github.com/plotly/plotly.rs/pull/421)] Backfill trace attributes on trace types to bring them to parity with  plotly.js 3.7 
 
 ### Changed