Implemented diagram series .node_width properties.

Author: hcpchris

highcharts_core/options/plot_options/arcdiagram.py

@@ -221,16 +221,32 @@ def min_link_width(self, value):
                                                   minimum = 0)
 
     @property
-    def node_width(self) -> Optional[int | float | Decimal]:
+    def node_width(self) -> Optional[str | int | float | Decimal]:
         """The pixel width of each node in a sankey diagram or dependency wheel, or the
-        height in case the chart is inverted. Defaults to ``20``.
+        height in case the chart is inverted.
 
-        :rtype: numeric or :obj:`None <python:None>`
+        Can be a number or a percentage string.
+        
+        Defaults to ``20``.
+
+        :rtype: :class:`str <python:str>` or numeric or :obj:`None <python:None>`
         """
         return self._node_width
 
     @node_width.setter
     def node_width(self, value):
+        if value is None:
+            self._node_width = None
+        else:
+            try:
+                value = validators.string(value)
+                if "%" not in value:
+                    raise ValueError
+            except (TypeError, ValueError):
+                value = validators.numeric(value)
+            
+            self._node_width = value
+
         self._node_width = validators.numeric(value,
                                               allow_empty = True,
                                               minimum = 0)

highcharts_core/options/plot_options/dependencywheel.py

@@ -277,19 +277,31 @@ def node_padding(self, value):
                                                 allow_empty = True)
 
     @property
-    def node_width(self) -> Optional[int | float | Decimal]:
+    def node_width(self) -> Optional[str | int | float | Decimal]:
         """The pixel width of each node in a sankey diagram or dependency wheel, or the
-        height in case the chart is inverted. Defaults to ``20``.
+        height in case the chart is inverted.
 
-        :rtype: numeric or :obj:`None <python:None>`
+        Can be a number or a percentage string.
+
+        Defaults to ``20``.
+
+        :rtype: :class:`str <python:str>` or numeric or :obj:`None <python:None>`
         """
         return self._node_width
 
     @node_width.setter
     def node_width(self, value):
-        self._node_width = validators.numeric(value,
-                                              allow_empty = True,
-                                              minimum = 0)
+        if value is None:
+            self._node_width = None
+        else:
+            try:
+                value = validators.string(value)
+                if "%" not in value:
+                    raise ValueError
+            except (TypeError, ValueError):
+                value = validators.numeric(value)
+
+            self._node_width = value
 
     @property
     def start_angle(self) -> Optional[int | float | Decimal]:

highcharts_core/options/plot_options/sankey.py

@@ -145,6 +145,34 @@ def node_distance(self, value):
 
             self._node_distance = value
 
+    @property
+    def node_width(self) -> Optional[str | int | float | Decimal]:
+        """The pixel width of each node in a sankey diagram, or the height in case 
+        the chart is inverted. Defaults to ``20``.
+
+        Can be a number, a percentage string, or ``'auto'``. If ``'auto'``, the nodes 
+        are sized to fill up the plot area in the longitudinal direction, regardless 
+        of the number of levels.
+
+        :rtype: :class:`str <python:str>` or numeric or :obj:`None <python:None>`
+        """
+        return self._node_width
+
+    @node_width.setter
+    def node_width(self, value):
+        if value is None:
+            self._node_width = None
+        else:
+            try:
+                value = validators.string(value)
+                value = value.lower()
+                if value != 'auto' and "%" not in value:
+                    raise ValueError
+            except (TypeError, ValueError):
+                value = validators.numeric(value)
+
+            self._node_width = value
+
     @classmethod
     def _get_kwargs_from_dict(cls, as_dict):
         kwargs = {

highcharts_core/options/plot_options/treegraph.py

@@ -123,6 +123,7 @@ def __init__(self, **kwargs):
 
         self._levels = None
         self._node_distance = None
+        self._node_width = None
 
         self.animation_limit = kwargs.get('animation_limit', None)
         self.boost_blending = kwargs.get('boost_blending', None)
@@ -150,6 +151,7 @@ def __init__(self, **kwargs):
 
         self.levels = kwargs.get('levels', None)
         self.node_distance = kwargs.get('node_distance', None)
+        self.node_width = kwargs.get('node_width', None)
 
         super().__init__(**kwargs)
 
@@ -690,6 +692,37 @@ def node_distance(self, value):
 
             self._node_distance = value
 
+    @property
+    def node_width(self) -> Optional[str | int | float | Decimal]:
+        """The pixel width of each node in a treegraph, or the height in case the chart is
+        inverted. Defaults to :obj:`None <python:None>`.
+
+        For tree graphs, the node width is only applied if the marker symbol is ``'rect'``,
+        otherwise the marker sizing options apply.
+
+        Can be a number or a percentage string, or ``'auto'``. If ``'auto'``, the nodes are 
+        sized to fill up the plot area in the longitudinal direction, regardless of the 
+        number of levels.
+
+        :rtype: :class:`str <python:str>` or numeric or :obj:`None <python:None>`
+        """
+        return self._node_width
+
+    @node_width.setter
+    def node_width(self, value):
+        if value is None:
+            self._node_width = None
+        else:
+            try:
+                value = validators.string(value)
+                value = value.lower()
+                if value != "auto" and "%" not in value:
+                    raise ValueError
+            except (TypeError, ValueError):
+                value = validators.numeric(value)
+
+            self._node_width = value
+
     @classmethod
     def _get_kwargs_from_dict(cls, as_dict):
         """Convenience method which returns the keyword arguments used to initialize the
@@ -764,6 +797,7 @@ class from a Highcharts Javascript-compatible :class:`dict <python:dict>` object
             'reversed': as_dict.get('reversed', None),
             'levels': as_dict.get('levels', None),
             'node_distance': as_dict.get('nodeDistance', None),
+            'node_width': as_dict.get('nodeWidth', None),
         }
 
         return kwargs
@@ -829,6 +863,7 @@ def _to_untrimmed_dict(self, in_cls = None) -> dict:
             'reversed': self.reversed,
             'levels': self.levels,
             'nodeDistance': self.node_distance,
+            'nodeWidth': self.node_width,
         }
 
         return untrimmed