first commit

.venv/Lib/site-packages/plotly/graph_objs/surface/__init__.py

@@ -0,0 +1,31 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._colorbar import ColorBar
+    from ._contours import Contours
+    from ._hoverlabel import Hoverlabel
+    from ._legendgrouptitle import Legendgrouptitle
+    from ._lighting import Lighting
+    from ._lightposition import Lightposition
+    from ._stream import Stream
+    from . import colorbar
+    from . import contours
+    from . import hoverlabel
+    from . import legendgrouptitle
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(
+        __name__,
+        [".colorbar", ".contours", ".hoverlabel", ".legendgrouptitle"],
+        [
+            "._colorbar.ColorBar",
+            "._contours.Contours",
+            "._hoverlabel.Hoverlabel",
+            "._legendgrouptitle.Legendgrouptitle",
+            "._lighting.Lighting",
+            "._lightposition.Lightposition",
+            "._stream.Stream",
+        ],
+    )

.venv/Lib/site-packages/plotly/graph_objs/surface/_contours.py

@@ -0,0 +1,272 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Contours(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface"
+    _path_str = "surface.contours"
+    _valid_props = {"x", "y", "z"}
+
+    # x
+    # -
+    @property
+    def x(self):
+        """
+        The 'x' property is an instance of X
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.surface.contours.X`
+          - A dict of string/value properties that will be passed
+            to the X constructor
+
+            Supported dict properties:
+
+                color
+                    Sets the color of the contour lines.
+                end
+                    Sets the end contour level value. Must be more
+                    than `contours.start`
+                highlight
+                    Determines whether or not contour lines about
+                    the x dimension are highlighted on hover.
+                highlightcolor
+                    Sets the color of the highlighted contour
+                    lines.
+                highlightwidth
+                    Sets the width of the highlighted contour
+                    lines.
+                project
+                    :class:`plotly.graph_objects.surface.contours.x
+                    .Project` instance or dict with compatible
+                    properties
+                show
+                    Determines whether or not contour lines about
+                    the x dimension are drawn.
+                size
+                    Sets the step between each contour level. Must
+                    be positive.
+                start
+                    Sets the starting contour level value. Must be
+                    less than `contours.end`
+                usecolormap
+                    An alternate to "color". Determines whether or
+                    not the contour lines are colored using the
+                    trace "colorscale".
+                width
+                    Sets the width of the contour lines.
+
+        Returns
+        -------
+        plotly.graph_objs.surface.contours.X
+        """
+        return self["x"]
+
+    @x.setter
+    def x(self, val):
+        self["x"] = val
+
+    # y
+    # -
+    @property
+    def y(self):
+        """
+        The 'y' property is an instance of Y
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.surface.contours.Y`
+          - A dict of string/value properties that will be passed
+            to the Y constructor
+
+            Supported dict properties:
+
+                color
+                    Sets the color of the contour lines.
+                end
+                    Sets the end contour level value. Must be more
+                    than `contours.start`
+                highlight
+                    Determines whether or not contour lines about
+                    the y dimension are highlighted on hover.
+                highlightcolor
+                    Sets the color of the highlighted contour
+                    lines.
+                highlightwidth
+                    Sets the width of the highlighted contour
+                    lines.
+                project
+                    :class:`plotly.graph_objects.surface.contours.y
+                    .Project` instance or dict with compatible
+                    properties
+                show
+                    Determines whether or not contour lines about
+                    the y dimension are drawn.
+                size
+                    Sets the step between each contour level. Must
+                    be positive.
+                start
+                    Sets the starting contour level value. Must be
+                    less than `contours.end`
+                usecolormap
+                    An alternate to "color". Determines whether or
+                    not the contour lines are colored using the
+                    trace "colorscale".
+                width
+                    Sets the width of the contour lines.
+
+        Returns
+        -------
+        plotly.graph_objs.surface.contours.Y
+        """
+        return self["y"]
+
+    @y.setter
+    def y(self, val):
+        self["y"] = val
+
+    # z
+    # -
+    @property
+    def z(self):
+        """
+        The 'z' property is an instance of Z
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.surface.contours.Z`
+          - A dict of string/value properties that will be passed
+            to the Z constructor
+
+            Supported dict properties:
+
+                color
+                    Sets the color of the contour lines.
+                end
+                    Sets the end contour level value. Must be more
+                    than `contours.start`
+                highlight
+                    Determines whether or not contour lines about
+                    the z dimension are highlighted on hover.
+                highlightcolor
+                    Sets the color of the highlighted contour
+                    lines.
+                highlightwidth
+                    Sets the width of the highlighted contour
+                    lines.
+                project
+                    :class:`plotly.graph_objects.surface.contours.z
+                    .Project` instance or dict with compatible
+                    properties
+                show
+                    Determines whether or not contour lines about
+                    the z dimension are drawn.
+                size
+                    Sets the step between each contour level. Must
+                    be positive.
+                start
+                    Sets the starting contour level value. Must be
+                    less than `contours.end`
+                usecolormap
+                    An alternate to "color". Determines whether or
+                    not the contour lines are colored using the
+                    trace "colorscale".
+                width
+                    Sets the width of the contour lines.
+
+        Returns
+        -------
+        plotly.graph_objs.surface.contours.Z
+        """
+        return self["z"]
+
+    @z.setter
+    def z(self, val):
+        self["z"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        x
+            :class:`plotly.graph_objects.surface.contours.X`
+            instance or dict with compatible properties
+        y
+            :class:`plotly.graph_objects.surface.contours.Y`
+            instance or dict with compatible properties
+        z
+            :class:`plotly.graph_objects.surface.contours.Z`
+            instance or dict with compatible properties
+        """
+
+    def __init__(self, arg=None, x=None, y=None, z=None, **kwargs):
+        """
+        Construct a new Contours object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.Contours`
+        x
+            :class:`plotly.graph_objects.surface.contours.X`
+            instance or dict with compatible properties
+        y
+            :class:`plotly.graph_objects.surface.contours.Y`
+            instance or dict with compatible properties
+        z
+            :class:`plotly.graph_objects.surface.contours.Z`
+            instance or dict with compatible properties
+
+        Returns
+        -------
+        Contours
+        """
+        super(Contours, self).__init__("contours")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.Contours
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.Contours`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("x", None)
+        _v = x if x is not None else _v
+        if _v is not None:
+            self["x"] = _v
+        _v = arg.pop("y", None)
+        _v = y if y is not None else _v
+        if _v is not None:
+            self["y"] = _v
+        _v = arg.pop("z", None)
+        _v = z if z is not None else _v
+        if _v is not None:
+            self["z"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/_hoverlabel.py

@@ -0,0 +1,503 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Hoverlabel(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface"
+    _path_str = "surface.hoverlabel"
+    _valid_props = {
+        "align",
+        "alignsrc",
+        "bgcolor",
+        "bgcolorsrc",
+        "bordercolor",
+        "bordercolorsrc",
+        "font",
+        "namelength",
+        "namelengthsrc",
+    }
+
+    # align
+    # -----
+    @property
+    def align(self):
+        """
+        Sets the horizontal alignment of the text content within hover
+        label box. Has an effect only if the hover label text spans
+        more two or more lines
+
+        The 'align' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['left', 'right', 'auto']
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        Any|numpy.ndarray
+        """
+        return self["align"]
+
+    @align.setter
+    def align(self, val):
+        self["align"] = val
+
+    # alignsrc
+    # --------
+    @property
+    def alignsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `align`.
+
+        The 'alignsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["alignsrc"]
+
+    @alignsrc.setter
+    def alignsrc(self, val):
+        self["alignsrc"] = val
+
+    # bgcolor
+    # -------
+    @property
+    def bgcolor(self):
+        """
+        Sets the background color of the hover labels for this trace
+
+        The 'bgcolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["bgcolor"]
+
+    @bgcolor.setter
+    def bgcolor(self, val):
+        self["bgcolor"] = val
+
+    # bgcolorsrc
+    # ----------
+    @property
+    def bgcolorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `bgcolor`.
+
+        The 'bgcolorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["bgcolorsrc"]
+
+    @bgcolorsrc.setter
+    def bgcolorsrc(self, val):
+        self["bgcolorsrc"] = val
+
+    # bordercolor
+    # -----------
+    @property
+    def bordercolor(self):
+        """
+        Sets the border color of the hover labels for this trace.
+
+        The 'bordercolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["bordercolor"]
+
+    @bordercolor.setter
+    def bordercolor(self, val):
+        self["bordercolor"] = val
+
+    # bordercolorsrc
+    # --------------
+    @property
+    def bordercolorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `bordercolor`.
+
+        The 'bordercolorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["bordercolorsrc"]
+
+    @bordercolorsrc.setter
+    def bordercolorsrc(self, val):
+        self["bordercolorsrc"] = val
+
+    # font
+    # ----
+    @property
+    def font(self):
+        """
+        Sets the font used in hover labels.
+
+        The 'font' property is an instance of Font
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.surface.hoverlabel.Font`
+          - A dict of string/value properties that will be passed
+            to the Font constructor
+
+            Supported dict properties:
+
+                color
+
+                colorsrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `color`.
+                family
+                    HTML font family - the typeface that will be
+                    applied by the web browser. The web browser
+                    will only be able to apply a font if it is
+                    available on the system which it operates.
+                    Provide multiple font families, separated by
+                    commas, to indicate the preference in which to
+                    apply fonts if they aren't available on the
+                    system. The Chart Studio Cloud (at
+                    https://chart-studio.plotly.com or on-premise)
+                    generates images on a server, where only a
+                    select number of fonts are installed and
+                    supported. These include "Arial", "Balto",
+                    "Courier New", "Droid Sans",, "Droid Serif",
+                    "Droid Sans Mono", "Gravitas One", "Old
+                    Standard TT", "Open Sans", "Overpass", "PT Sans
+                    Narrow", "Raleway", "Times New Roman".
+                familysrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `family`.
+                size
+
+                sizesrc
+                    Sets the source reference on Chart Studio Cloud
+                    for `size`.
+
+        Returns
+        -------
+        plotly.graph_objs.surface.hoverlabel.Font
+        """
+        return self["font"]
+
+    @font.setter
+    def font(self, val):
+        self["font"] = val
+
+    # namelength
+    # ----------
+    @property
+    def namelength(self):
+        """
+        Sets the default length (in number of characters) of the trace
+        name in the hover labels for all traces. -1 shows the whole
+        name regardless of length. 0-3 shows the first 0-3 characters,
+        and an integer >3 will show the whole name if it is less than
+        that many characters, but if it is longer, will truncate to
+        `namelength - 3` characters and add an ellipsis.
+
+        The 'namelength' property is a integer and may be specified as:
+          - An int (or float that will be cast to an int)
+            in the interval [-1, 9223372036854775807]
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        int|numpy.ndarray
+        """
+        return self["namelength"]
+
+    @namelength.setter
+    def namelength(self, val):
+        self["namelength"] = val
+
+    # namelengthsrc
+    # -------------
+    @property
+    def namelengthsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for
+        `namelength`.
+
+        The 'namelengthsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["namelengthsrc"]
+
+    @namelengthsrc.setter
+    def namelengthsrc(self, val):
+        self["namelengthsrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        align
+            Sets the horizontal alignment of the text content
+            within hover label box. Has an effect only if the hover
+            label text spans more two or more lines
+        alignsrc
+            Sets the source reference on Chart Studio Cloud for
+            `align`.
+        bgcolor
+            Sets the background color of the hover labels for this
+            trace
+        bgcolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bgcolor`.
+        bordercolor
+            Sets the border color of the hover labels for this
+            trace.
+        bordercolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bordercolor`.
+        font
+            Sets the font used in hover labels.
+        namelength
+            Sets the default length (in number of characters) of
+            the trace name in the hover labels for all traces. -1
+            shows the whole name regardless of length. 0-3 shows
+            the first 0-3 characters, and an integer >3 will show
+            the whole name if it is less than that many characters,
+            but if it is longer, will truncate to `namelength - 3`
+            characters and add an ellipsis.
+        namelengthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `namelength`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        align=None,
+        alignsrc=None,
+        bgcolor=None,
+        bgcolorsrc=None,
+        bordercolor=None,
+        bordercolorsrc=None,
+        font=None,
+        namelength=None,
+        namelengthsrc=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Hoverlabel object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.Hoverlabel`
+        align
+            Sets the horizontal alignment of the text content
+            within hover label box. Has an effect only if the hover
+            label text spans more two or more lines
+        alignsrc
+            Sets the source reference on Chart Studio Cloud for
+            `align`.
+        bgcolor
+            Sets the background color of the hover labels for this
+            trace
+        bgcolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bgcolor`.
+        bordercolor
+            Sets the border color of the hover labels for this
+            trace.
+        bordercolorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `bordercolor`.
+        font
+            Sets the font used in hover labels.
+        namelength
+            Sets the default length (in number of characters) of
+            the trace name in the hover labels for all traces. -1
+            shows the whole name regardless of length. 0-3 shows
+            the first 0-3 characters, and an integer >3 will show
+            the whole name if it is less than that many characters,
+            but if it is longer, will truncate to `namelength - 3`
+            characters and add an ellipsis.
+        namelengthsrc
+            Sets the source reference on Chart Studio Cloud for
+            `namelength`.
+
+        Returns
+        -------
+        Hoverlabel
+        """
+        super(Hoverlabel, self).__init__("hoverlabel")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.Hoverlabel
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.Hoverlabel`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("align", None)
+        _v = align if align is not None else _v
+        if _v is not None:
+            self["align"] = _v
+        _v = arg.pop("alignsrc", None)
+        _v = alignsrc if alignsrc is not None else _v
+        if _v is not None:
+            self["alignsrc"] = _v
+        _v = arg.pop("bgcolor", None)
+        _v = bgcolor if bgcolor is not None else _v
+        if _v is not None:
+            self["bgcolor"] = _v
+        _v = arg.pop("bgcolorsrc", None)
+        _v = bgcolorsrc if bgcolorsrc is not None else _v
+        if _v is not None:
+            self["bgcolorsrc"] = _v
+        _v = arg.pop("bordercolor", None)
+        _v = bordercolor if bordercolor is not None else _v
+        if _v is not None:
+            self["bordercolor"] = _v
+        _v = arg.pop("bordercolorsrc", None)
+        _v = bordercolorsrc if bordercolorsrc is not None else _v
+        if _v is not None:
+            self["bordercolorsrc"] = _v
+        _v = arg.pop("font", None)
+        _v = font if font is not None else _v
+        if _v is not None:
+            self["font"] = _v
+        _v = arg.pop("namelength", None)
+        _v = namelength if namelength is not None else _v
+        if _v is not None:
+            self["namelength"] = _v
+        _v = arg.pop("namelengthsrc", None)
+        _v = namelengthsrc if namelengthsrc is not None else _v
+        if _v is not None:
+            self["namelengthsrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/_legendgrouptitle.py

@@ -0,0 +1,154 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Legendgrouptitle(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface"
+    _path_str = "surface.legendgrouptitle"
+    _valid_props = {"font", "text"}
+
+    # font
+    # ----
+    @property
+    def font(self):
+        """
+        Sets this legend group's title font.
+
+        The 'font' property is an instance of Font
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.surface.legendgrouptitle.Font`
+          - A dict of string/value properties that will be passed
+            to the Font constructor
+
+            Supported dict properties:
+
+                color
+
+                family
+                    HTML font family - the typeface that will be
+                    applied by the web browser. The web browser
+                    will only be able to apply a font if it is
+                    available on the system which it operates.
+                    Provide multiple font families, separated by
+                    commas, to indicate the preference in which to
+                    apply fonts if they aren't available on the
+                    system. The Chart Studio Cloud (at
+                    https://chart-studio.plotly.com or on-premise)
+                    generates images on a server, where only a
+                    select number of fonts are installed and
+                    supported. These include "Arial", "Balto",
+                    "Courier New", "Droid Sans",, "Droid Serif",
+                    "Droid Sans Mono", "Gravitas One", "Old
+                    Standard TT", "Open Sans", "Overpass", "PT Sans
+                    Narrow", "Raleway", "Times New Roman".
+                size
+
+        Returns
+        -------
+        plotly.graph_objs.surface.legendgrouptitle.Font
+        """
+        return self["font"]
+
+    @font.setter
+    def font(self, val):
+        self["font"] = val
+
+    # text
+    # ----
+    @property
+    def text(self):
+        """
+        Sets the title of the legend group.
+
+        The 'text' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+
+        Returns
+        -------
+        str
+        """
+        return self["text"]
+
+    @text.setter
+    def text(self, val):
+        self["text"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        font
+            Sets this legend group's title font.
+        text
+            Sets the title of the legend group.
+        """
+
+    def __init__(self, arg=None, font=None, text=None, **kwargs):
+        """
+        Construct a new Legendgrouptitle object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.Legendgrouptitle`
+        font
+            Sets this legend group's title font.
+        text
+            Sets the title of the legend group.
+
+        Returns
+        -------
+        Legendgrouptitle
+        """
+        super(Legendgrouptitle, self).__init__("legendgrouptitle")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.Legendgrouptitle
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.Legendgrouptitle`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("font", None)
+        _v = font if font is not None else _v
+        if _v is not None:
+            self["font"] = _v
+        _v = arg.pop("text", None)
+        _v = text if text is not None else _v
+        if _v is not None:
+            self["text"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/_lighting.py

@@ -0,0 +1,240 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Lighting(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface"
+    _path_str = "surface.lighting"
+    _valid_props = {"ambient", "diffuse", "fresnel", "roughness", "specular"}
+
+    # ambient
+    # -------
+    @property
+    def ambient(self):
+        """
+        Ambient light increases overall color visibility but can wash
+        out the image.
+
+        The 'ambient' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["ambient"]
+
+    @ambient.setter
+    def ambient(self, val):
+        self["ambient"] = val
+
+    # diffuse
+    # -------
+    @property
+    def diffuse(self):
+        """
+        Represents the extent that incident rays are reflected in a
+        range of angles.
+
+        The 'diffuse' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["diffuse"]
+
+    @diffuse.setter
+    def diffuse(self, val):
+        self["diffuse"] = val
+
+    # fresnel
+    # -------
+    @property
+    def fresnel(self):
+        """
+        Represents the reflectance as a dependency of the viewing
+        angle; e.g. paper is reflective when viewing it from the edge
+        of the paper (almost 90 degrees), causing shine.
+
+        The 'fresnel' property is a number and may be specified as:
+          - An int or float in the interval [0, 5]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["fresnel"]
+
+    @fresnel.setter
+    def fresnel(self, val):
+        self["fresnel"] = val
+
+    # roughness
+    # ---------
+    @property
+    def roughness(self):
+        """
+        Alters specular reflection; the rougher the surface, the wider
+        and less contrasty the shine.
+
+        The 'roughness' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["roughness"]
+
+    @roughness.setter
+    def roughness(self, val):
+        self["roughness"] = val
+
+    # specular
+    # --------
+    @property
+    def specular(self):
+        """
+        Represents the level that incident rays are reflected in a
+        single direction, causing shine.
+
+        The 'specular' property is a number and may be specified as:
+          - An int or float in the interval [0, 2]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["specular"]
+
+    @specular.setter
+    def specular(self, val):
+        self["specular"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        ambient
+            Ambient light increases overall color visibility but
+            can wash out the image.
+        diffuse
+            Represents the extent that incident rays are reflected
+            in a range of angles.
+        fresnel
+            Represents the reflectance as a dependency of the
+            viewing angle; e.g. paper is reflective when viewing it
+            from the edge of the paper (almost 90 degrees), causing
+            shine.
+        roughness
+            Alters specular reflection; the rougher the surface,
+            the wider and less contrasty the shine.
+        specular
+            Represents the level that incident rays are reflected
+            in a single direction, causing shine.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        ambient=None,
+        diffuse=None,
+        fresnel=None,
+        roughness=None,
+        specular=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Lighting object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.Lighting`
+        ambient
+            Ambient light increases overall color visibility but
+            can wash out the image.
+        diffuse
+            Represents the extent that incident rays are reflected
+            in a range of angles.
+        fresnel
+            Represents the reflectance as a dependency of the
+            viewing angle; e.g. paper is reflective when viewing it
+            from the edge of the paper (almost 90 degrees), causing
+            shine.
+        roughness
+            Alters specular reflection; the rougher the surface,
+            the wider and less contrasty the shine.
+        specular
+            Represents the level that incident rays are reflected
+            in a single direction, causing shine.
+
+        Returns
+        -------
+        Lighting
+        """
+        super(Lighting, self).__init__("lighting")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.Lighting
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.Lighting`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("ambient", None)
+        _v = ambient if ambient is not None else _v
+        if _v is not None:
+            self["ambient"] = _v
+        _v = arg.pop("diffuse", None)
+        _v = diffuse if diffuse is not None else _v
+        if _v is not None:
+            self["diffuse"] = _v
+        _v = arg.pop("fresnel", None)
+        _v = fresnel if fresnel is not None else _v
+        if _v is not None:
+            self["fresnel"] = _v
+        _v = arg.pop("roughness", None)
+        _v = roughness if roughness is not None else _v
+        if _v is not None:
+            self["roughness"] = _v
+        _v = arg.pop("specular", None)
+        _v = specular if specular is not None else _v
+        if _v is not None:
+            self["specular"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/_lightposition.py

@@ -0,0 +1,161 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Lightposition(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface"
+    _path_str = "surface.lightposition"
+    _valid_props = {"x", "y", "z"}
+
+    # x
+    # -
+    @property
+    def x(self):
+        """
+        Numeric vector, representing the X coordinate for each vertex.
+
+        The 'x' property is a number and may be specified as:
+          - An int or float in the interval [-100000, 100000]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["x"]
+
+    @x.setter
+    def x(self, val):
+        self["x"] = val
+
+    # y
+    # -
+    @property
+    def y(self):
+        """
+        Numeric vector, representing the Y coordinate for each vertex.
+
+        The 'y' property is a number and may be specified as:
+          - An int or float in the interval [-100000, 100000]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["y"]
+
+    @y.setter
+    def y(self, val):
+        self["y"] = val
+
+    # z
+    # -
+    @property
+    def z(self):
+        """
+        Numeric vector, representing the Z coordinate for each vertex.
+
+        The 'z' property is a number and may be specified as:
+          - An int or float in the interval [-100000, 100000]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["z"]
+
+    @z.setter
+    def z(self, val):
+        self["z"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        x
+            Numeric vector, representing the X coordinate for each
+            vertex.
+        y
+            Numeric vector, representing the Y coordinate for each
+            vertex.
+        z
+            Numeric vector, representing the Z coordinate for each
+            vertex.
+        """
+
+    def __init__(self, arg=None, x=None, y=None, z=None, **kwargs):
+        """
+        Construct a new Lightposition object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.Lightposition`
+        x
+            Numeric vector, representing the X coordinate for each
+            vertex.
+        y
+            Numeric vector, representing the Y coordinate for each
+            vertex.
+        z
+            Numeric vector, representing the Z coordinate for each
+            vertex.
+
+        Returns
+        -------
+        Lightposition
+        """
+        super(Lightposition, self).__init__("lightposition")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.Lightposition
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.Lightposition`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("x", None)
+        _v = x if x is not None else _v
+        if _v is not None:
+            self["x"] = _v
+        _v = arg.pop("y", None)
+        _v = y if y is not None else _v
+        if _v is not None:
+            self["y"] = _v
+        _v = arg.pop("z", None)
+        _v = z if z is not None else _v
+        if _v is not None:
+            self["z"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/_stream.py

@@ -0,0 +1,141 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Stream(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface"
+    _path_str = "surface.stream"
+    _valid_props = {"maxpoints", "token"}
+
+    # maxpoints
+    # ---------
+    @property
+    def maxpoints(self):
+        """
+        Sets the maximum number of points to keep on the plots from an
+        incoming stream. If `maxpoints` is set to 50, only the newest
+        50 points will be displayed on the plot.
+
+        The 'maxpoints' property is a number and may be specified as:
+          - An int or float in the interval [0, 10000]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["maxpoints"]
+
+    @maxpoints.setter
+    def maxpoints(self, val):
+        self["maxpoints"] = val
+
+    # token
+    # -----
+    @property
+    def token(self):
+        """
+        The stream id number links a data trace on a plot with a
+        stream. See https://chart-studio.plotly.com/settings for more
+        details.
+
+        The 'token' property is a string and must be specified as:
+          - A non-empty string
+
+        Returns
+        -------
+        str
+        """
+        return self["token"]
+
+    @token.setter
+    def token(self, val):
+        self["token"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        maxpoints
+            Sets the maximum number of points to keep on the plots
+            from an incoming stream. If `maxpoints` is set to 50,
+            only the newest 50 points will be displayed on the
+            plot.
+        token
+            The stream id number links a data trace on a plot with
+            a stream. See https://chart-studio.plotly.com/settings
+            for more details.
+        """
+
+    def __init__(self, arg=None, maxpoints=None, token=None, **kwargs):
+        """
+        Construct a new Stream object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.Stream`
+        maxpoints
+            Sets the maximum number of points to keep on the plots
+            from an incoming stream. If `maxpoints` is set to 50,
+            only the newest 50 points will be displayed on the
+            plot.
+        token
+            The stream id number links a data trace on a plot with
+            a stream. See https://chart-studio.plotly.com/settings
+            for more details.
+
+        Returns
+        -------
+        Stream
+        """
+        super(Stream, self).__init__("stream")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.Stream
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.Stream`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("maxpoints", None)
+        _v = maxpoints if maxpoints is not None else _v
+        if _v is not None:
+            self["maxpoints"] = _v
+        _v = arg.pop("token", None)
+        _v = token if token is not None else _v
+        if _v is not None:
+            self["token"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/colorbar/__init__.py

@@ -0,0 +1,16 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._tickfont import Tickfont
+    from ._tickformatstop import Tickformatstop
+    from ._title import Title
+    from . import title
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(
+        __name__,
+        [".title"],
+        ["._tickfont.Tickfont", "._tickformatstop.Tickformatstop", "._title.Title"],
+    )

.venv/Lib/site-packages/plotly/graph_objs/surface/colorbar/_tickfont.py

@@ -0,0 +1,227 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Tickfont(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.colorbar"
+    _path_str = "surface.colorbar.tickfont"
+    _valid_props = {"color", "family", "size"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # family
+    # ------
+    @property
+    def family(self):
+        """
+        HTML font family - the typeface that will be applied by the web
+        browser. The web browser will only be able to apply a font if
+        it is available on the system which it operates. Provide
+        multiple font families, separated by commas, to indicate the
+        preference in which to apply fonts if they aren't available on
+        the system. The Chart Studio Cloud (at https://chart-
+        studio.plotly.com or on-premise) generates images on a server,
+        where only a select number of fonts are installed and
+        supported. These include "Arial", "Balto", "Courier New",
+        "Droid Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+        One", "Old Standard TT", "Open Sans", "Overpass", "PT Sans
+        Narrow", "Raleway", "Times New Roman".
+
+        The 'family' property is a string and must be specified as:
+          - A non-empty string
+
+        Returns
+        -------
+        str
+        """
+        return self["family"]
+
+    @family.setter
+    def family(self, val):
+        self["family"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [1, inf]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        size
+
+        """
+
+    def __init__(self, arg=None, color=None, family=None, size=None, **kwargs):
+        """
+        Construct a new Tickfont object
+
+        Sets the color bar's tick label font
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.colorbar.Tickfont`
+        color
+
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        size
+
+
+        Returns
+        -------
+        Tickfont
+        """
+        super(Tickfont, self).__init__("tickfont")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.colorbar.Tickfont
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.colorbar.Tickfont`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("family", None)
+        _v = family if family is not None else _v
+        if _v is not None:
+            self["family"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/colorbar/_tickformatstop.py

@@ -0,0 +1,283 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Tickformatstop(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.colorbar"
+    _path_str = "surface.colorbar.tickformatstop"
+    _valid_props = {"dtickrange", "enabled", "name", "templateitemname", "value"}
+
+    # dtickrange
+    # ----------
+    @property
+    def dtickrange(self):
+        """
+            range [*min*, *max*], where "min", "max" - dtick values which
+            describe some zoom level, it is possible to omit "min" or "max"
+            value by passing "null"
+
+            The 'dtickrange' property is an info array that may be specified as:
+
+            * a list or tuple of 2 elements where:
+        (0) The 'dtickrange[0]' property accepts values of any type
+        (1) The 'dtickrange[1]' property accepts values of any type
+
+            Returns
+            -------
+            list
+        """
+        return self["dtickrange"]
+
+    @dtickrange.setter
+    def dtickrange(self, val):
+        self["dtickrange"] = val
+
+    # enabled
+    # -------
+    @property
+    def enabled(self):
+        """
+        Determines whether or not this stop is used. If `false`, this
+        stop is ignored even within its `dtickrange`.
+
+        The 'enabled' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["enabled"]
+
+    @enabled.setter
+    def enabled(self, val):
+        self["enabled"] = val
+
+    # name
+    # ----
+    @property
+    def name(self):
+        """
+        When used in a template, named items are created in the output
+        figure in addition to any items the figure already has in this
+        array. You can modify these items in the output figure by
+        making your own item with `templateitemname` matching this
+        `name` alongside your modifications (including `visible: false`
+        or `enabled: false` to hide it). Has no effect outside of a
+        template.
+
+        The 'name' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+
+        Returns
+        -------
+        str
+        """
+        return self["name"]
+
+    @name.setter
+    def name(self, val):
+        self["name"] = val
+
+    # templateitemname
+    # ----------------
+    @property
+    def templateitemname(self):
+        """
+        Used to refer to a named item in this array in the template.
+        Named items from the template will be created even without a
+        matching item in the input figure, but you can modify one by
+        making an item with `templateitemname` matching its `name`,
+        alongside your modifications (including `visible: false` or
+        `enabled: false` to hide it). If there is no template or no
+        matching item, this item will be hidden unless you explicitly
+        show it with `visible: true`.
+
+        The 'templateitemname' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+
+        Returns
+        -------
+        str
+        """
+        return self["templateitemname"]
+
+    @templateitemname.setter
+    def templateitemname(self, val):
+        self["templateitemname"] = val
+
+    # value
+    # -----
+    @property
+    def value(self):
+        """
+        string - dtickformat for described zoom level, the same as
+        "tickformat"
+
+        The 'value' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+
+        Returns
+        -------
+        str
+        """
+        return self["value"]
+
+    @value.setter
+    def value(self, val):
+        self["value"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        dtickrange
+            range [*min*, *max*], where "min", "max" - dtick values
+            which describe some zoom level, it is possible to omit
+            "min" or "max" value by passing "null"
+        enabled
+            Determines whether or not this stop is used. If
+            `false`, this stop is ignored even within its
+            `dtickrange`.
+        name
+            When used in a template, named items are created in the
+            output figure in addition to any items the figure
+            already has in this array. You can modify these items
+            in the output figure by making your own item with
+            `templateitemname` matching this `name` alongside your
+            modifications (including `visible: false` or `enabled:
+            false` to hide it). Has no effect outside of a
+            template.
+        templateitemname
+            Used to refer to a named item in this array in the
+            template. Named items from the template will be created
+            even without a matching item in the input figure, but
+            you can modify one by making an item with
+            `templateitemname` matching its `name`, alongside your
+            modifications (including `visible: false` or `enabled:
+            false` to hide it). If there is no template or no
+            matching item, this item will be hidden unless you
+            explicitly show it with `visible: true`.
+        value
+            string - dtickformat for described zoom level, the same
+            as "tickformat"
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        dtickrange=None,
+        enabled=None,
+        name=None,
+        templateitemname=None,
+        value=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Tickformatstop object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.surface.colorb
+            ar.Tickformatstop`
+        dtickrange
+            range [*min*, *max*], where "min", "max" - dtick values
+            which describe some zoom level, it is possible to omit
+            "min" or "max" value by passing "null"
+        enabled
+            Determines whether or not this stop is used. If
+            `false`, this stop is ignored even within its
+            `dtickrange`.
+        name
+            When used in a template, named items are created in the
+            output figure in addition to any items the figure
+            already has in this array. You can modify these items
+            in the output figure by making your own item with
+            `templateitemname` matching this `name` alongside your
+            modifications (including `visible: false` or `enabled:
+            false` to hide it). Has no effect outside of a
+            template.
+        templateitemname
+            Used to refer to a named item in this array in the
+            template. Named items from the template will be created
+            even without a matching item in the input figure, but
+            you can modify one by making an item with
+            `templateitemname` matching its `name`, alongside your
+            modifications (including `visible: false` or `enabled:
+            false` to hide it). If there is no template or no
+            matching item, this item will be hidden unless you
+            explicitly show it with `visible: true`.
+        value
+            string - dtickformat for described zoom level, the same
+            as "tickformat"
+
+        Returns
+        -------
+        Tickformatstop
+        """
+        super(Tickformatstop, self).__init__("tickformatstops")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.colorbar.Tickformatstop
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.colorbar.Tickformatstop`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("dtickrange", None)
+        _v = dtickrange if dtickrange is not None else _v
+        if _v is not None:
+            self["dtickrange"] = _v
+        _v = arg.pop("enabled", None)
+        _v = enabled if enabled is not None else _v
+        if _v is not None:
+            self["enabled"] = _v
+        _v = arg.pop("name", None)
+        _v = name if name is not None else _v
+        if _v is not None:
+            self["name"] = _v
+        _v = arg.pop("templateitemname", None)
+        _v = templateitemname if templateitemname is not None else _v
+        if _v is not None:
+            self["templateitemname"] = _v
+        _v = arg.pop("value", None)
+        _v = value if value is not None else _v
+        if _v is not None:
+            self["value"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/colorbar/_title.py

@@ -0,0 +1,210 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Title(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.colorbar"
+    _path_str = "surface.colorbar.title"
+    _valid_props = {"font", "side", "text"}
+
+    # font
+    # ----
+    @property
+    def font(self):
+        """
+        Sets this color bar's title font. Note that the title's font
+        used to be set by the now deprecated `titlefont` attribute.
+
+        The 'font' property is an instance of Font
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.surface.colorbar.title.Font`
+          - A dict of string/value properties that will be passed
+            to the Font constructor
+
+            Supported dict properties:
+
+                color
+
+                family
+                    HTML font family - the typeface that will be
+                    applied by the web browser. The web browser
+                    will only be able to apply a font if it is
+                    available on the system which it operates.
+                    Provide multiple font families, separated by
+                    commas, to indicate the preference in which to
+                    apply fonts if they aren't available on the
+                    system. The Chart Studio Cloud (at
+                    https://chart-studio.plotly.com or on-premise)
+                    generates images on a server, where only a
+                    select number of fonts are installed and
+                    supported. These include "Arial", "Balto",
+                    "Courier New", "Droid Sans",, "Droid Serif",
+                    "Droid Sans Mono", "Gravitas One", "Old
+                    Standard TT", "Open Sans", "Overpass", "PT Sans
+                    Narrow", "Raleway", "Times New Roman".
+                size
+
+        Returns
+        -------
+        plotly.graph_objs.surface.colorbar.title.Font
+        """
+        return self["font"]
+
+    @font.setter
+    def font(self, val):
+        self["font"] = val
+
+    # side
+    # ----
+    @property
+    def side(self):
+        """
+        Determines the location of color bar's title with respect to
+        the color bar. Defaults to "top" when `orientation` if "v" and
+        defaults to "right" when `orientation` if "h". Note that the
+        title's location used to be set by the now deprecated
+        `titleside` attribute.
+
+        The 'side' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['right', 'top', 'bottom']
+
+        Returns
+        -------
+        Any
+        """
+        return self["side"]
+
+    @side.setter
+    def side(self, val):
+        self["side"] = val
+
+    # text
+    # ----
+    @property
+    def text(self):
+        """
+        Sets the title of the color bar. Note that before the existence
+        of `title.text`, the title's contents used to be defined as the
+        `title` attribute itself. This behavior has been deprecated.
+
+        The 'text' property is a string and must be specified as:
+          - A string
+          - A number that will be converted to a string
+
+        Returns
+        -------
+        str
+        """
+        return self["text"]
+
+    @text.setter
+    def text(self, val):
+        self["text"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        font
+            Sets this color bar's title font. Note that the title's
+            font used to be set by the now deprecated `titlefont`
+            attribute.
+        side
+            Determines the location of color bar's title with
+            respect to the color bar. Defaults to "top" when
+            `orientation` if "v" and  defaults to "right" when
+            `orientation` if "h". Note that the title's location
+            used to be set by the now deprecated `titleside`
+            attribute.
+        text
+            Sets the title of the color bar. Note that before the
+            existence of `title.text`, the title's contents used to
+            be defined as the `title` attribute itself. This
+            behavior has been deprecated.
+        """
+
+    def __init__(self, arg=None, font=None, side=None, text=None, **kwargs):
+        """
+        Construct a new Title object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.colorbar.Title`
+        font
+            Sets this color bar's title font. Note that the title's
+            font used to be set by the now deprecated `titlefont`
+            attribute.
+        side
+            Determines the location of color bar's title with
+            respect to the color bar. Defaults to "top" when
+            `orientation` if "v" and  defaults to "right" when
+            `orientation` if "h". Note that the title's location
+            used to be set by the now deprecated `titleside`
+            attribute.
+        text
+            Sets the title of the color bar. Note that before the
+            existence of `title.text`, the title's contents used to
+            be defined as the `title` attribute itself. This
+            behavior has been deprecated.
+
+        Returns
+        -------
+        Title
+        """
+        super(Title, self).__init__("title")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.colorbar.Title
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.colorbar.Title`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("font", None)
+        _v = font if font is not None else _v
+        if _v is not None:
+            self["font"] = _v
+        _v = arg.pop("side", None)
+        _v = side if side is not None else _v
+        if _v is not None:
+            self["side"] = _v
+        _v = arg.pop("text", None)
+        _v = text if text is not None else _v
+        if _v is not None:
+            self["text"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/colorbar/title/__init__.py

@@ -0,0 +1,9 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._font import Font
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._font.Font"])

.venv/Lib/site-packages/plotly/graph_objs/surface/colorbar/title/_font.py

@@ -0,0 +1,228 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Font(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.colorbar.title"
+    _path_str = "surface.colorbar.title.font"
+    _valid_props = {"color", "family", "size"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # family
+    # ------
+    @property
+    def family(self):
+        """
+        HTML font family - the typeface that will be applied by the web
+        browser. The web browser will only be able to apply a font if
+        it is available on the system which it operates. Provide
+        multiple font families, separated by commas, to indicate the
+        preference in which to apply fonts if they aren't available on
+        the system. The Chart Studio Cloud (at https://chart-
+        studio.plotly.com or on-premise) generates images on a server,
+        where only a select number of fonts are installed and
+        supported. These include "Arial", "Balto", "Courier New",
+        "Droid Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+        One", "Old Standard TT", "Open Sans", "Overpass", "PT Sans
+        Narrow", "Raleway", "Times New Roman".
+
+        The 'family' property is a string and must be specified as:
+          - A non-empty string
+
+        Returns
+        -------
+        str
+        """
+        return self["family"]
+
+    @family.setter
+    def family(self, val):
+        self["family"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [1, inf]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        size
+
+        """
+
+    def __init__(self, arg=None, color=None, family=None, size=None, **kwargs):
+        """
+        Construct a new Font object
+
+        Sets this color bar's title font. Note that the title's font
+        used to be set by the now deprecated `titlefont` attribute.
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.colorbar.title.Font`
+        color
+
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        size
+
+
+        Returns
+        -------
+        Font
+        """
+        super(Font, self).__init__("font")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.colorbar.title.Font
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.colorbar.title.Font`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("family", None)
+        _v = family if family is not None else _v
+        if _v is not None:
+            self["family"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/contours/__init__.py

@@ -0,0 +1,16 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._x import X
+    from ._y import Y
+    from ._z import Z
+    from . import x
+    from . import y
+    from . import z
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(
+        __name__, [".x", ".y", ".z"], ["._x.X", "._y.Y", "._z.Z"]
+    )

.venv/Lib/site-packages/plotly/graph_objs/surface/contours/_x.py

@@ -0,0 +1,525 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class X(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.contours"
+    _path_str = "surface.contours.x"
+    _valid_props = {
+        "color",
+        "end",
+        "highlight",
+        "highlightcolor",
+        "highlightwidth",
+        "project",
+        "show",
+        "size",
+        "start",
+        "usecolormap",
+        "width",
+    }
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        Sets the color of the contour lines.
+
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # end
+    # ---
+    @property
+    def end(self):
+        """
+        Sets the end contour level value. Must be more than
+        `contours.start`
+
+        The 'end' property is a number and may be specified as:
+          - An int or float
+
+        Returns
+        -------
+        int|float
+        """
+        return self["end"]
+
+    @end.setter
+    def end(self, val):
+        self["end"] = val
+
+    # highlight
+    # ---------
+    @property
+    def highlight(self):
+        """
+        Determines whether or not contour lines about the x dimension
+        are highlighted on hover.
+
+        The 'highlight' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["highlight"]
+
+    @highlight.setter
+    def highlight(self, val):
+        self["highlight"] = val
+
+    # highlightcolor
+    # --------------
+    @property
+    def highlightcolor(self):
+        """
+        Sets the color of the highlighted contour lines.
+
+        The 'highlightcolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["highlightcolor"]
+
+    @highlightcolor.setter
+    def highlightcolor(self, val):
+        self["highlightcolor"] = val
+
+    # highlightwidth
+    # --------------
+    @property
+    def highlightwidth(self):
+        """
+        Sets the width of the highlighted contour lines.
+
+        The 'highlightwidth' property is a number and may be specified as:
+          - An int or float in the interval [1, 16]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["highlightwidth"]
+
+    @highlightwidth.setter
+    def highlightwidth(self, val):
+        self["highlightwidth"] = val
+
+    # project
+    # -------
+    @property
+    def project(self):
+        """
+        The 'project' property is an instance of Project
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.surface.contours.x.Project`
+          - A dict of string/value properties that will be passed
+            to the Project constructor
+
+            Supported dict properties:
+
+                x
+                    Determines whether or not these contour lines
+                    are projected on the x plane. If `highlight` is
+                    set to True (the default), the projected lines
+                    are shown on hover. If `show` is set to True,
+                    the projected lines are shown in permanence.
+                y
+                    Determines whether or not these contour lines
+                    are projected on the y plane. If `highlight` is
+                    set to True (the default), the projected lines
+                    are shown on hover. If `show` is set to True,
+                    the projected lines are shown in permanence.
+                z
+                    Determines whether or not these contour lines
+                    are projected on the z plane. If `highlight` is
+                    set to True (the default), the projected lines
+                    are shown on hover. If `show` is set to True,
+                    the projected lines are shown in permanence.
+
+        Returns
+        -------
+        plotly.graph_objs.surface.contours.x.Project
+        """
+        return self["project"]
+
+    @project.setter
+    def project(self, val):
+        self["project"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Determines whether or not contour lines about the x dimension
+        are drawn.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        Sets the step between each contour level. Must be positive.
+
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [0, inf]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # start
+    # -----
+    @property
+    def start(self):
+        """
+        Sets the starting contour level value. Must be less than
+        `contours.end`
+
+        The 'start' property is a number and may be specified as:
+          - An int or float
+
+        Returns
+        -------
+        int|float
+        """
+        return self["start"]
+
+    @start.setter
+    def start(self, val):
+        self["start"] = val
+
+    # usecolormap
+    # -----------
+    @property
+    def usecolormap(self):
+        """
+        An alternate to "color". Determines whether or not the contour
+        lines are colored using the trace "colorscale".
+
+        The 'usecolormap' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["usecolormap"]
+
+    @usecolormap.setter
+    def usecolormap(self, val):
+        self["usecolormap"] = val
+
+    # width
+    # -----
+    @property
+    def width(self):
+        """
+        Sets the width of the contour lines.
+
+        The 'width' property is a number and may be specified as:
+          - An int or float in the interval [1, 16]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["width"]
+
+    @width.setter
+    def width(self, val):
+        self["width"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+            Sets the color of the contour lines.
+        end
+            Sets the end contour level value. Must be more than
+            `contours.start`
+        highlight
+            Determines whether or not contour lines about the x
+            dimension are highlighted on hover.
+        highlightcolor
+            Sets the color of the highlighted contour lines.
+        highlightwidth
+            Sets the width of the highlighted contour lines.
+        project
+            :class:`plotly.graph_objects.surface.contours.x.Project
+            ` instance or dict with compatible properties
+        show
+            Determines whether or not contour lines about the x
+            dimension are drawn.
+        size
+            Sets the step between each contour level. Must be
+            positive.
+        start
+            Sets the starting contour level value. Must be less
+            than `contours.end`
+        usecolormap
+            An alternate to "color". Determines whether or not the
+            contour lines are colored using the trace "colorscale".
+        width
+            Sets the width of the contour lines.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        color=None,
+        end=None,
+        highlight=None,
+        highlightcolor=None,
+        highlightwidth=None,
+        project=None,
+        show=None,
+        size=None,
+        start=None,
+        usecolormap=None,
+        width=None,
+        **kwargs,
+    ):
+        """
+        Construct a new X object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.contours.X`
+        color
+            Sets the color of the contour lines.
+        end
+            Sets the end contour level value. Must be more than
+            `contours.start`
+        highlight
+            Determines whether or not contour lines about the x
+            dimension are highlighted on hover.
+        highlightcolor
+            Sets the color of the highlighted contour lines.
+        highlightwidth
+            Sets the width of the highlighted contour lines.
+        project
+            :class:`plotly.graph_objects.surface.contours.x.Project
+            ` instance or dict with compatible properties
+        show
+            Determines whether or not contour lines about the x
+            dimension are drawn.
+        size
+            Sets the step between each contour level. Must be
+            positive.
+        start
+            Sets the starting contour level value. Must be less
+            than `contours.end`
+        usecolormap
+            An alternate to "color". Determines whether or not the
+            contour lines are colored using the trace "colorscale".
+        width
+            Sets the width of the contour lines.
+
+        Returns
+        -------
+        X
+        """
+        super(X, self).__init__("x")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.contours.X
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.contours.X`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("end", None)
+        _v = end if end is not None else _v
+        if _v is not None:
+            self["end"] = _v
+        _v = arg.pop("highlight", None)
+        _v = highlight if highlight is not None else _v
+        if _v is not None:
+            self["highlight"] = _v
+        _v = arg.pop("highlightcolor", None)
+        _v = highlightcolor if highlightcolor is not None else _v
+        if _v is not None:
+            self["highlightcolor"] = _v
+        _v = arg.pop("highlightwidth", None)
+        _v = highlightwidth if highlightwidth is not None else _v
+        if _v is not None:
+            self["highlightwidth"] = _v
+        _v = arg.pop("project", None)
+        _v = project if project is not None else _v
+        if _v is not None:
+            self["project"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+        _v = arg.pop("start", None)
+        _v = start if start is not None else _v
+        if _v is not None:
+            self["start"] = _v
+        _v = arg.pop("usecolormap", None)
+        _v = usecolormap if usecolormap is not None else _v
+        if _v is not None:
+            self["usecolormap"] = _v
+        _v = arg.pop("width", None)
+        _v = width if width is not None else _v
+        if _v is not None:
+            self["width"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/contours/_y.py

@@ -0,0 +1,525 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Y(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.contours"
+    _path_str = "surface.contours.y"
+    _valid_props = {
+        "color",
+        "end",
+        "highlight",
+        "highlightcolor",
+        "highlightwidth",
+        "project",
+        "show",
+        "size",
+        "start",
+        "usecolormap",
+        "width",
+    }
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        Sets the color of the contour lines.
+
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # end
+    # ---
+    @property
+    def end(self):
+        """
+        Sets the end contour level value. Must be more than
+        `contours.start`
+
+        The 'end' property is a number and may be specified as:
+          - An int or float
+
+        Returns
+        -------
+        int|float
+        """
+        return self["end"]
+
+    @end.setter
+    def end(self, val):
+        self["end"] = val
+
+    # highlight
+    # ---------
+    @property
+    def highlight(self):
+        """
+        Determines whether or not contour lines about the y dimension
+        are highlighted on hover.
+
+        The 'highlight' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["highlight"]
+
+    @highlight.setter
+    def highlight(self, val):
+        self["highlight"] = val
+
+    # highlightcolor
+    # --------------
+    @property
+    def highlightcolor(self):
+        """
+        Sets the color of the highlighted contour lines.
+
+        The 'highlightcolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["highlightcolor"]
+
+    @highlightcolor.setter
+    def highlightcolor(self, val):
+        self["highlightcolor"] = val
+
+    # highlightwidth
+    # --------------
+    @property
+    def highlightwidth(self):
+        """
+        Sets the width of the highlighted contour lines.
+
+        The 'highlightwidth' property is a number and may be specified as:
+          - An int or float in the interval [1, 16]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["highlightwidth"]
+
+    @highlightwidth.setter
+    def highlightwidth(self, val):
+        self["highlightwidth"] = val
+
+    # project
+    # -------
+    @property
+    def project(self):
+        """
+        The 'project' property is an instance of Project
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.surface.contours.y.Project`
+          - A dict of string/value properties that will be passed
+            to the Project constructor
+
+            Supported dict properties:
+
+                x
+                    Determines whether or not these contour lines
+                    are projected on the x plane. If `highlight` is
+                    set to True (the default), the projected lines
+                    are shown on hover. If `show` is set to True,
+                    the projected lines are shown in permanence.
+                y
+                    Determines whether or not these contour lines
+                    are projected on the y plane. If `highlight` is
+                    set to True (the default), the projected lines
+                    are shown on hover. If `show` is set to True,
+                    the projected lines are shown in permanence.
+                z
+                    Determines whether or not these contour lines
+                    are projected on the z plane. If `highlight` is
+                    set to True (the default), the projected lines
+                    are shown on hover. If `show` is set to True,
+                    the projected lines are shown in permanence.
+
+        Returns
+        -------
+        plotly.graph_objs.surface.contours.y.Project
+        """
+        return self["project"]
+
+    @project.setter
+    def project(self, val):
+        self["project"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Determines whether or not contour lines about the y dimension
+        are drawn.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        Sets the step between each contour level. Must be positive.
+
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [0, inf]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # start
+    # -----
+    @property
+    def start(self):
+        """
+        Sets the starting contour level value. Must be less than
+        `contours.end`
+
+        The 'start' property is a number and may be specified as:
+          - An int or float
+
+        Returns
+        -------
+        int|float
+        """
+        return self["start"]
+
+    @start.setter
+    def start(self, val):
+        self["start"] = val
+
+    # usecolormap
+    # -----------
+    @property
+    def usecolormap(self):
+        """
+        An alternate to "color". Determines whether or not the contour
+        lines are colored using the trace "colorscale".
+
+        The 'usecolormap' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["usecolormap"]
+
+    @usecolormap.setter
+    def usecolormap(self, val):
+        self["usecolormap"] = val
+
+    # width
+    # -----
+    @property
+    def width(self):
+        """
+        Sets the width of the contour lines.
+
+        The 'width' property is a number and may be specified as:
+          - An int or float in the interval [1, 16]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["width"]
+
+    @width.setter
+    def width(self, val):
+        self["width"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+            Sets the color of the contour lines.
+        end
+            Sets the end contour level value. Must be more than
+            `contours.start`
+        highlight
+            Determines whether or not contour lines about the y
+            dimension are highlighted on hover.
+        highlightcolor
+            Sets the color of the highlighted contour lines.
+        highlightwidth
+            Sets the width of the highlighted contour lines.
+        project
+            :class:`plotly.graph_objects.surface.contours.y.Project
+            ` instance or dict with compatible properties
+        show
+            Determines whether or not contour lines about the y
+            dimension are drawn.
+        size
+            Sets the step between each contour level. Must be
+            positive.
+        start
+            Sets the starting contour level value. Must be less
+            than `contours.end`
+        usecolormap
+            An alternate to "color". Determines whether or not the
+            contour lines are colored using the trace "colorscale".
+        width
+            Sets the width of the contour lines.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        color=None,
+        end=None,
+        highlight=None,
+        highlightcolor=None,
+        highlightwidth=None,
+        project=None,
+        show=None,
+        size=None,
+        start=None,
+        usecolormap=None,
+        width=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Y object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.contours.Y`
+        color
+            Sets the color of the contour lines.
+        end
+            Sets the end contour level value. Must be more than
+            `contours.start`
+        highlight
+            Determines whether or not contour lines about the y
+            dimension are highlighted on hover.
+        highlightcolor
+            Sets the color of the highlighted contour lines.
+        highlightwidth
+            Sets the width of the highlighted contour lines.
+        project
+            :class:`plotly.graph_objects.surface.contours.y.Project
+            ` instance or dict with compatible properties
+        show
+            Determines whether or not contour lines about the y
+            dimension are drawn.
+        size
+            Sets the step between each contour level. Must be
+            positive.
+        start
+            Sets the starting contour level value. Must be less
+            than `contours.end`
+        usecolormap
+            An alternate to "color". Determines whether or not the
+            contour lines are colored using the trace "colorscale".
+        width
+            Sets the width of the contour lines.
+
+        Returns
+        -------
+        Y
+        """
+        super(Y, self).__init__("y")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.contours.Y
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.contours.Y`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("end", None)
+        _v = end if end is not None else _v
+        if _v is not None:
+            self["end"] = _v
+        _v = arg.pop("highlight", None)
+        _v = highlight if highlight is not None else _v
+        if _v is not None:
+            self["highlight"] = _v
+        _v = arg.pop("highlightcolor", None)
+        _v = highlightcolor if highlightcolor is not None else _v
+        if _v is not None:
+            self["highlightcolor"] = _v
+        _v = arg.pop("highlightwidth", None)
+        _v = highlightwidth if highlightwidth is not None else _v
+        if _v is not None:
+            self["highlightwidth"] = _v
+        _v = arg.pop("project", None)
+        _v = project if project is not None else _v
+        if _v is not None:
+            self["project"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+        _v = arg.pop("start", None)
+        _v = start if start is not None else _v
+        if _v is not None:
+            self["start"] = _v
+        _v = arg.pop("usecolormap", None)
+        _v = usecolormap if usecolormap is not None else _v
+        if _v is not None:
+            self["usecolormap"] = _v
+        _v = arg.pop("width", None)
+        _v = width if width is not None else _v
+        if _v is not None:
+            self["width"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/contours/_z.py

@@ -0,0 +1,525 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Z(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.contours"
+    _path_str = "surface.contours.z"
+    _valid_props = {
+        "color",
+        "end",
+        "highlight",
+        "highlightcolor",
+        "highlightwidth",
+        "project",
+        "show",
+        "size",
+        "start",
+        "usecolormap",
+        "width",
+    }
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        Sets the color of the contour lines.
+
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # end
+    # ---
+    @property
+    def end(self):
+        """
+        Sets the end contour level value. Must be more than
+        `contours.start`
+
+        The 'end' property is a number and may be specified as:
+          - An int or float
+
+        Returns
+        -------
+        int|float
+        """
+        return self["end"]
+
+    @end.setter
+    def end(self, val):
+        self["end"] = val
+
+    # highlight
+    # ---------
+    @property
+    def highlight(self):
+        """
+        Determines whether or not contour lines about the z dimension
+        are highlighted on hover.
+
+        The 'highlight' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["highlight"]
+
+    @highlight.setter
+    def highlight(self, val):
+        self["highlight"] = val
+
+    # highlightcolor
+    # --------------
+    @property
+    def highlightcolor(self):
+        """
+        Sets the color of the highlighted contour lines.
+
+        The 'highlightcolor' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["highlightcolor"]
+
+    @highlightcolor.setter
+    def highlightcolor(self, val):
+        self["highlightcolor"] = val
+
+    # highlightwidth
+    # --------------
+    @property
+    def highlightwidth(self):
+        """
+        Sets the width of the highlighted contour lines.
+
+        The 'highlightwidth' property is a number and may be specified as:
+          - An int or float in the interval [1, 16]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["highlightwidth"]
+
+    @highlightwidth.setter
+    def highlightwidth(self, val):
+        self["highlightwidth"] = val
+
+    # project
+    # -------
+    @property
+    def project(self):
+        """
+        The 'project' property is an instance of Project
+        that may be specified as:
+          - An instance of :class:`plotly.graph_objs.surface.contours.z.Project`
+          - A dict of string/value properties that will be passed
+            to the Project constructor
+
+            Supported dict properties:
+
+                x
+                    Determines whether or not these contour lines
+                    are projected on the x plane. If `highlight` is
+                    set to True (the default), the projected lines
+                    are shown on hover. If `show` is set to True,
+                    the projected lines are shown in permanence.
+                y
+                    Determines whether or not these contour lines
+                    are projected on the y plane. If `highlight` is
+                    set to True (the default), the projected lines
+                    are shown on hover. If `show` is set to True,
+                    the projected lines are shown in permanence.
+                z
+                    Determines whether or not these contour lines
+                    are projected on the z plane. If `highlight` is
+                    set to True (the default), the projected lines
+                    are shown on hover. If `show` is set to True,
+                    the projected lines are shown in permanence.
+
+        Returns
+        -------
+        plotly.graph_objs.surface.contours.z.Project
+        """
+        return self["project"]
+
+    @project.setter
+    def project(self, val):
+        self["project"] = val
+
+    # show
+    # ----
+    @property
+    def show(self):
+        """
+        Determines whether or not contour lines about the z dimension
+        are drawn.
+
+        The 'show' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["show"]
+
+    @show.setter
+    def show(self, val):
+        self["show"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        Sets the step between each contour level. Must be positive.
+
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [0, inf]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # start
+    # -----
+    @property
+    def start(self):
+        """
+        Sets the starting contour level value. Must be less than
+        `contours.end`
+
+        The 'start' property is a number and may be specified as:
+          - An int or float
+
+        Returns
+        -------
+        int|float
+        """
+        return self["start"]
+
+    @start.setter
+    def start(self, val):
+        self["start"] = val
+
+    # usecolormap
+    # -----------
+    @property
+    def usecolormap(self):
+        """
+        An alternate to "color". Determines whether or not the contour
+        lines are colored using the trace "colorscale".
+
+        The 'usecolormap' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["usecolormap"]
+
+    @usecolormap.setter
+    def usecolormap(self, val):
+        self["usecolormap"] = val
+
+    # width
+    # -----
+    @property
+    def width(self):
+        """
+        Sets the width of the contour lines.
+
+        The 'width' property is a number and may be specified as:
+          - An int or float in the interval [1, 16]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["width"]
+
+    @width.setter
+    def width(self, val):
+        self["width"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+            Sets the color of the contour lines.
+        end
+            Sets the end contour level value. Must be more than
+            `contours.start`
+        highlight
+            Determines whether or not contour lines about the z
+            dimension are highlighted on hover.
+        highlightcolor
+            Sets the color of the highlighted contour lines.
+        highlightwidth
+            Sets the width of the highlighted contour lines.
+        project
+            :class:`plotly.graph_objects.surface.contours.z.Project
+            ` instance or dict with compatible properties
+        show
+            Determines whether or not contour lines about the z
+            dimension are drawn.
+        size
+            Sets the step between each contour level. Must be
+            positive.
+        start
+            Sets the starting contour level value. Must be less
+            than `contours.end`
+        usecolormap
+            An alternate to "color". Determines whether or not the
+            contour lines are colored using the trace "colorscale".
+        width
+            Sets the width of the contour lines.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        color=None,
+        end=None,
+        highlight=None,
+        highlightcolor=None,
+        highlightwidth=None,
+        project=None,
+        show=None,
+        size=None,
+        start=None,
+        usecolormap=None,
+        width=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Z object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.contours.Z`
+        color
+            Sets the color of the contour lines.
+        end
+            Sets the end contour level value. Must be more than
+            `contours.start`
+        highlight
+            Determines whether or not contour lines about the z
+            dimension are highlighted on hover.
+        highlightcolor
+            Sets the color of the highlighted contour lines.
+        highlightwidth
+            Sets the width of the highlighted contour lines.
+        project
+            :class:`plotly.graph_objects.surface.contours.z.Project
+            ` instance or dict with compatible properties
+        show
+            Determines whether or not contour lines about the z
+            dimension are drawn.
+        size
+            Sets the step between each contour level. Must be
+            positive.
+        start
+            Sets the starting contour level value. Must be less
+            than `contours.end`
+        usecolormap
+            An alternate to "color". Determines whether or not the
+            contour lines are colored using the trace "colorscale".
+        width
+            Sets the width of the contour lines.
+
+        Returns
+        -------
+        Z
+        """
+        super(Z, self).__init__("z")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.contours.Z
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.contours.Z`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("end", None)
+        _v = end if end is not None else _v
+        if _v is not None:
+            self["end"] = _v
+        _v = arg.pop("highlight", None)
+        _v = highlight if highlight is not None else _v
+        if _v is not None:
+            self["highlight"] = _v
+        _v = arg.pop("highlightcolor", None)
+        _v = highlightcolor if highlightcolor is not None else _v
+        if _v is not None:
+            self["highlightcolor"] = _v
+        _v = arg.pop("highlightwidth", None)
+        _v = highlightwidth if highlightwidth is not None else _v
+        if _v is not None:
+            self["highlightwidth"] = _v
+        _v = arg.pop("project", None)
+        _v = project if project is not None else _v
+        if _v is not None:
+            self["project"] = _v
+        _v = arg.pop("show", None)
+        _v = show if show is not None else _v
+        if _v is not None:
+            self["show"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+        _v = arg.pop("start", None)
+        _v = start if start is not None else _v
+        if _v is not None:
+            self["start"] = _v
+        _v = arg.pop("usecolormap", None)
+        _v = usecolormap if usecolormap is not None else _v
+        if _v is not None:
+            self["usecolormap"] = _v
+        _v = arg.pop("width", None)
+        _v = width if width is not None else _v
+        if _v is not None:
+            self["width"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/contours/x/__init__.py

@@ -0,0 +1,9 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._project import Project
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._project.Project"])

.venv/Lib/site-packages/plotly/graph_objs/surface/contours/x/_project.py

@@ -0,0 +1,188 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Project(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.contours.x"
+    _path_str = "surface.contours.x.project"
+    _valid_props = {"x", "y", "z"}
+
+    # x
+    # -
+    @property
+    def x(self):
+        """
+        Determines whether or not these contour lines are projected on
+        the x plane. If `highlight` is set to True (the default), the
+        projected lines are shown on hover. If `show` is set to True,
+        the projected lines are shown in permanence.
+
+        The 'x' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["x"]
+
+    @x.setter
+    def x(self, val):
+        self["x"] = val
+
+    # y
+    # -
+    @property
+    def y(self):
+        """
+        Determines whether or not these contour lines are projected on
+        the y plane. If `highlight` is set to True (the default), the
+        projected lines are shown on hover. If `show` is set to True,
+        the projected lines are shown in permanence.
+
+        The 'y' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["y"]
+
+    @y.setter
+    def y(self, val):
+        self["y"] = val
+
+    # z
+    # -
+    @property
+    def z(self):
+        """
+        Determines whether or not these contour lines are projected on
+        the z plane. If `highlight` is set to True (the default), the
+        projected lines are shown on hover. If `show` is set to True,
+        the projected lines are shown in permanence.
+
+        The 'z' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["z"]
+
+    @z.setter
+    def z(self, val):
+        self["z"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        x
+            Determines whether or not these contour lines are
+            projected on the x plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        y
+            Determines whether or not these contour lines are
+            projected on the y plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        z
+            Determines whether or not these contour lines are
+            projected on the z plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        """
+
+    def __init__(self, arg=None, x=None, y=None, z=None, **kwargs):
+        """
+        Construct a new Project object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.contours.x.Project`
+        x
+            Determines whether or not these contour lines are
+            projected on the x plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        y
+            Determines whether or not these contour lines are
+            projected on the y plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        z
+            Determines whether or not these contour lines are
+            projected on the z plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+
+        Returns
+        -------
+        Project
+        """
+        super(Project, self).__init__("project")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.contours.x.Project
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.contours.x.Project`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("x", None)
+        _v = x if x is not None else _v
+        if _v is not None:
+            self["x"] = _v
+        _v = arg.pop("y", None)
+        _v = y if y is not None else _v
+        if _v is not None:
+            self["y"] = _v
+        _v = arg.pop("z", None)
+        _v = z if z is not None else _v
+        if _v is not None:
+            self["z"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/contours/y/__init__.py

@@ -0,0 +1,9 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._project import Project
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._project.Project"])

.venv/Lib/site-packages/plotly/graph_objs/surface/contours/y/_project.py

@@ -0,0 +1,188 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Project(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.contours.y"
+    _path_str = "surface.contours.y.project"
+    _valid_props = {"x", "y", "z"}
+
+    # x
+    # -
+    @property
+    def x(self):
+        """
+        Determines whether or not these contour lines are projected on
+        the x plane. If `highlight` is set to True (the default), the
+        projected lines are shown on hover. If `show` is set to True,
+        the projected lines are shown in permanence.
+
+        The 'x' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["x"]
+
+    @x.setter
+    def x(self, val):
+        self["x"] = val
+
+    # y
+    # -
+    @property
+    def y(self):
+        """
+        Determines whether or not these contour lines are projected on
+        the y plane. If `highlight` is set to True (the default), the
+        projected lines are shown on hover. If `show` is set to True,
+        the projected lines are shown in permanence.
+
+        The 'y' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["y"]
+
+    @y.setter
+    def y(self, val):
+        self["y"] = val
+
+    # z
+    # -
+    @property
+    def z(self):
+        """
+        Determines whether or not these contour lines are projected on
+        the z plane. If `highlight` is set to True (the default), the
+        projected lines are shown on hover. If `show` is set to True,
+        the projected lines are shown in permanence.
+
+        The 'z' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["z"]
+
+    @z.setter
+    def z(self, val):
+        self["z"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        x
+            Determines whether or not these contour lines are
+            projected on the x plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        y
+            Determines whether or not these contour lines are
+            projected on the y plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        z
+            Determines whether or not these contour lines are
+            projected on the z plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        """
+
+    def __init__(self, arg=None, x=None, y=None, z=None, **kwargs):
+        """
+        Construct a new Project object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.contours.y.Project`
+        x
+            Determines whether or not these contour lines are
+            projected on the x plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        y
+            Determines whether or not these contour lines are
+            projected on the y plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        z
+            Determines whether or not these contour lines are
+            projected on the z plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+
+        Returns
+        -------
+        Project
+        """
+        super(Project, self).__init__("project")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.contours.y.Project
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.contours.y.Project`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("x", None)
+        _v = x if x is not None else _v
+        if _v is not None:
+            self["x"] = _v
+        _v = arg.pop("y", None)
+        _v = y if y is not None else _v
+        if _v is not None:
+            self["y"] = _v
+        _v = arg.pop("z", None)
+        _v = z if z is not None else _v
+        if _v is not None:
+            self["z"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/contours/z/__init__.py

@@ -0,0 +1,9 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._project import Project
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._project.Project"])

.venv/Lib/site-packages/plotly/graph_objs/surface/contours/z/_project.py

@@ -0,0 +1,188 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Project(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.contours.z"
+    _path_str = "surface.contours.z.project"
+    _valid_props = {"x", "y", "z"}
+
+    # x
+    # -
+    @property
+    def x(self):
+        """
+        Determines whether or not these contour lines are projected on
+        the x plane. If `highlight` is set to True (the default), the
+        projected lines are shown on hover. If `show` is set to True,
+        the projected lines are shown in permanence.
+
+        The 'x' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["x"]
+
+    @x.setter
+    def x(self, val):
+        self["x"] = val
+
+    # y
+    # -
+    @property
+    def y(self):
+        """
+        Determines whether or not these contour lines are projected on
+        the y plane. If `highlight` is set to True (the default), the
+        projected lines are shown on hover. If `show` is set to True,
+        the projected lines are shown in permanence.
+
+        The 'y' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["y"]
+
+    @y.setter
+    def y(self, val):
+        self["y"] = val
+
+    # z
+    # -
+    @property
+    def z(self):
+        """
+        Determines whether or not these contour lines are projected on
+        the z plane. If `highlight` is set to True (the default), the
+        projected lines are shown on hover. If `show` is set to True,
+        the projected lines are shown in permanence.
+
+        The 'z' property must be specified as a bool
+        (either True, or False)
+
+        Returns
+        -------
+        bool
+        """
+        return self["z"]
+
+    @z.setter
+    def z(self, val):
+        self["z"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        x
+            Determines whether or not these contour lines are
+            projected on the x plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        y
+            Determines whether or not these contour lines are
+            projected on the y plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        z
+            Determines whether or not these contour lines are
+            projected on the z plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        """
+
+    def __init__(self, arg=None, x=None, y=None, z=None, **kwargs):
+        """
+        Construct a new Project object
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.contours.z.Project`
+        x
+            Determines whether or not these contour lines are
+            projected on the x plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        y
+            Determines whether or not these contour lines are
+            projected on the y plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+        z
+            Determines whether or not these contour lines are
+            projected on the z plane. If `highlight` is set to True
+            (the default), the projected lines are shown on hover.
+            If `show` is set to True, the projected lines are shown
+            in permanence.
+
+        Returns
+        -------
+        Project
+        """
+        super(Project, self).__init__("project")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.contours.z.Project
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.contours.z.Project`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("x", None)
+        _v = x if x is not None else _v
+        if _v is not None:
+            self["x"] = _v
+        _v = arg.pop("y", None)
+        _v = y if y is not None else _v
+        if _v is not None:
+            self["y"] = _v
+        _v = arg.pop("z", None)
+        _v = z if z is not None else _v
+        if _v is not None:
+            self["z"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/hoverlabel/__init__.py

@@ -0,0 +1,9 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._font import Font
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._font.Font"])

.venv/Lib/site-packages/plotly/graph_objs/surface/hoverlabel/_font.py

@@ -0,0 +1,330 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Font(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.hoverlabel"
+    _path_str = "surface.hoverlabel.font"
+    _valid_props = {"color", "colorsrc", "family", "familysrc", "size", "sizesrc"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+          - A list or array of any of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # colorsrc
+    # --------
+    @property
+    def colorsrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `color`.
+
+        The 'colorsrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["colorsrc"]
+
+    @colorsrc.setter
+    def colorsrc(self, val):
+        self["colorsrc"] = val
+
+    # family
+    # ------
+    @property
+    def family(self):
+        """
+        HTML font family - the typeface that will be applied by the web
+        browser. The web browser will only be able to apply a font if
+        it is available on the system which it operates. Provide
+        multiple font families, separated by commas, to indicate the
+        preference in which to apply fonts if they aren't available on
+        the system. The Chart Studio Cloud (at https://chart-
+        studio.plotly.com or on-premise) generates images on a server,
+        where only a select number of fonts are installed and
+        supported. These include "Arial", "Balto", "Courier New",
+        "Droid Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+        One", "Old Standard TT", "Open Sans", "Overpass", "PT Sans
+        Narrow", "Raleway", "Times New Roman".
+
+        The 'family' property is a string and must be specified as:
+          - A non-empty string
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        str|numpy.ndarray
+        """
+        return self["family"]
+
+    @family.setter
+    def family(self, val):
+        self["family"] = val
+
+    # familysrc
+    # ---------
+    @property
+    def familysrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `family`.
+
+        The 'familysrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["familysrc"]
+
+    @familysrc.setter
+    def familysrc(self, val):
+        self["familysrc"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [1, inf]
+          - A tuple, list, or one-dimensional numpy array of the above
+
+        Returns
+        -------
+        int|float|numpy.ndarray
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # sizesrc
+    # -------
+    @property
+    def sizesrc(self):
+        """
+        Sets the source reference on Chart Studio Cloud for `size`.
+
+        The 'sizesrc' property must be specified as a string or
+        as a plotly.grid_objs.Column object
+
+        Returns
+        -------
+        str
+        """
+        return self["sizesrc"]
+
+    @sizesrc.setter
+    def sizesrc(self, val):
+        self["sizesrc"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        familysrc
+            Sets the source reference on Chart Studio Cloud for
+            `family`.
+        size
+
+        sizesrc
+            Sets the source reference on Chart Studio Cloud for
+            `size`.
+        """
+
+    def __init__(
+        self,
+        arg=None,
+        color=None,
+        colorsrc=None,
+        family=None,
+        familysrc=None,
+        size=None,
+        sizesrc=None,
+        **kwargs,
+    ):
+        """
+        Construct a new Font object
+
+        Sets the font used in hover labels.
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of
+            :class:`plotly.graph_objs.surface.hoverlabel.Font`
+        color
+
+        colorsrc
+            Sets the source reference on Chart Studio Cloud for
+            `color`.
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        familysrc
+            Sets the source reference on Chart Studio Cloud for
+            `family`.
+        size
+
+        sizesrc
+            Sets the source reference on Chart Studio Cloud for
+            `size`.
+
+        Returns
+        -------
+        Font
+        """
+        super(Font, self).__init__("font")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.hoverlabel.Font
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.hoverlabel.Font`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("colorsrc", None)
+        _v = colorsrc if colorsrc is not None else _v
+        if _v is not None:
+            self["colorsrc"] = _v
+        _v = arg.pop("family", None)
+        _v = family if family is not None else _v
+        if _v is not None:
+            self["family"] = _v
+        _v = arg.pop("familysrc", None)
+        _v = familysrc if familysrc is not None else _v
+        if _v is not None:
+            self["familysrc"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+        _v = arg.pop("sizesrc", None)
+        _v = sizesrc if sizesrc is not None else _v
+        if _v is not None:
+            self["sizesrc"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False

.venv/Lib/site-packages/plotly/graph_objs/surface/legendgrouptitle/__init__.py

@@ -0,0 +1,9 @@
+import sys
+from typing import TYPE_CHECKING
+
+if sys.version_info < (3, 7) or TYPE_CHECKING:
+    from ._font import Font
+else:
+    from _plotly_utils.importers import relative_import
+
+    __all__, __getattr__, __dir__ = relative_import(__name__, [], ["._font.Font"])

.venv/Lib/site-packages/plotly/graph_objs/surface/legendgrouptitle/_font.py

@@ -0,0 +1,227 @@
+from plotly.basedatatypes import BaseTraceHierarchyType as _BaseTraceHierarchyType
+import copy as _copy
+
+
+class Font(_BaseTraceHierarchyType):
+
+    # class properties
+    # --------------------
+    _parent_path_str = "surface.legendgrouptitle"
+    _path_str = "surface.legendgrouptitle.font"
+    _valid_props = {"color", "family", "size"}
+
+    # color
+    # -----
+    @property
+    def color(self):
+        """
+        The 'color' property is a color and may be specified as:
+          - A hex string (e.g. '#ff0000')
+          - An rgb/rgba string (e.g. 'rgb(255,0,0)')
+          - An hsl/hsla string (e.g. 'hsl(0,100%,50%)')
+          - An hsv/hsva string (e.g. 'hsv(0,100%,100%)')
+          - A named CSS color:
+                aliceblue, antiquewhite, aqua, aquamarine, azure,
+                beige, bisque, black, blanchedalmond, blue,
+                blueviolet, brown, burlywood, cadetblue,
+                chartreuse, chocolate, coral, cornflowerblue,
+                cornsilk, crimson, cyan, darkblue, darkcyan,
+                darkgoldenrod, darkgray, darkgrey, darkgreen,
+                darkkhaki, darkmagenta, darkolivegreen, darkorange,
+                darkorchid, darkred, darksalmon, darkseagreen,
+                darkslateblue, darkslategray, darkslategrey,
+                darkturquoise, darkviolet, deeppink, deepskyblue,
+                dimgray, dimgrey, dodgerblue, firebrick,
+                floralwhite, forestgreen, fuchsia, gainsboro,
+                ghostwhite, gold, goldenrod, gray, grey, green,
+                greenyellow, honeydew, hotpink, indianred, indigo,
+                ivory, khaki, lavender, lavenderblush, lawngreen,
+                lemonchiffon, lightblue, lightcoral, lightcyan,
+                lightgoldenrodyellow, lightgray, lightgrey,
+                lightgreen, lightpink, lightsalmon, lightseagreen,
+                lightskyblue, lightslategray, lightslategrey,
+                lightsteelblue, lightyellow, lime, limegreen,
+                linen, magenta, maroon, mediumaquamarine,
+                mediumblue, mediumorchid, mediumpurple,
+                mediumseagreen, mediumslateblue, mediumspringgreen,
+                mediumturquoise, mediumvioletred, midnightblue,
+                mintcream, mistyrose, moccasin, navajowhite, navy,
+                oldlace, olive, olivedrab, orange, orangered,
+                orchid, palegoldenrod, palegreen, paleturquoise,
+                palevioletred, papayawhip, peachpuff, peru, pink,
+                plum, powderblue, purple, red, rosybrown,
+                royalblue, rebeccapurple, saddlebrown, salmon,
+                sandybrown, seagreen, seashell, sienna, silver,
+                skyblue, slateblue, slategray, slategrey, snow,
+                springgreen, steelblue, tan, teal, thistle, tomato,
+                turquoise, violet, wheat, white, whitesmoke,
+                yellow, yellowgreen
+
+        Returns
+        -------
+        str
+        """
+        return self["color"]
+
+    @color.setter
+    def color(self, val):
+        self["color"] = val
+
+    # family
+    # ------
+    @property
+    def family(self):
+        """
+        HTML font family - the typeface that will be applied by the web
+        browser. The web browser will only be able to apply a font if
+        it is available on the system which it operates. Provide
+        multiple font families, separated by commas, to indicate the
+        preference in which to apply fonts if they aren't available on
+        the system. The Chart Studio Cloud (at https://chart-
+        studio.plotly.com or on-premise) generates images on a server,
+        where only a select number of fonts are installed and
+        supported. These include "Arial", "Balto", "Courier New",
+        "Droid Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+        One", "Old Standard TT", "Open Sans", "Overpass", "PT Sans
+        Narrow", "Raleway", "Times New Roman".
+
+        The 'family' property is a string and must be specified as:
+          - A non-empty string
+
+        Returns
+        -------
+        str
+        """
+        return self["family"]
+
+    @family.setter
+    def family(self, val):
+        self["family"] = val
+
+    # size
+    # ----
+    @property
+    def size(self):
+        """
+        The 'size' property is a number and may be specified as:
+          - An int or float in the interval [1, inf]
+
+        Returns
+        -------
+        int|float
+        """
+        return self["size"]
+
+    @size.setter
+    def size(self, val):
+        self["size"] = val
+
+    # Self properties description
+    # ---------------------------
+    @property
+    def _prop_descriptions(self):
+        return """\
+        color
+
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        size
+
+        """
+
+    def __init__(self, arg=None, color=None, family=None, size=None, **kwargs):
+        """
+        Construct a new Font object
+
+        Sets this legend group's title font.
+
+        Parameters
+        ----------
+        arg
+            dict of properties compatible with this constructor or
+            an instance of :class:`plotly.graph_objs.surface.legend
+            grouptitle.Font`
+        color
+
+        family
+            HTML font family - the typeface that will be applied by
+            the web browser. The web browser will only be able to
+            apply a font if it is available on the system which it
+            operates. Provide multiple font families, separated by
+            commas, to indicate the preference in which to apply
+            fonts if they aren't available on the system. The Chart
+            Studio Cloud (at https://chart-studio.plotly.com or on-
+            premise) generates images on a server, where only a
+            select number of fonts are installed and supported.
+            These include "Arial", "Balto", "Courier New", "Droid
+            Sans",, "Droid Serif", "Droid Sans Mono", "Gravitas
+            One", "Old Standard TT", "Open Sans", "Overpass", "PT
+            Sans Narrow", "Raleway", "Times New Roman".
+        size
+
+
+        Returns
+        -------
+        Font
+        """
+        super(Font, self).__init__("font")
+
+        if "_parent" in kwargs:
+            self._parent = kwargs["_parent"]
+            return
+
+        # Validate arg
+        # ------------
+        if arg is None:
+            arg = {}
+        elif isinstance(arg, self.__class__):
+            arg = arg.to_plotly_json()
+        elif isinstance(arg, dict):
+            arg = _copy.copy(arg)
+        else:
+            raise ValueError(
+                """\
+The first argument to the plotly.graph_objs.surface.legendgrouptitle.Font
+constructor must be a dict or
+an instance of :class:`plotly.graph_objs.surface.legendgrouptitle.Font`"""
+            )
+
+        # Handle skip_invalid
+        # -------------------
+        self._skip_invalid = kwargs.pop("skip_invalid", False)
+        self._validate = kwargs.pop("_validate", True)
+
+        # Populate data dict with properties
+        # ----------------------------------
+        _v = arg.pop("color", None)
+        _v = color if color is not None else _v
+        if _v is not None:
+            self["color"] = _v
+        _v = arg.pop("family", None)
+        _v = family if family is not None else _v
+        if _v is not None:
+            self["family"] = _v
+        _v = arg.pop("size", None)
+        _v = size if size is not None else _v
+        if _v is not None:
+            self["size"] = _v
+
+        # Process unknown kwargs
+        # ----------------------
+        self._process_kwargs(**dict(arg, **kwargs))
+
+        # Reset skip_invalid
+        # ------------------
+        self._skip_invalid = False