streamlit-nightly 1.45.2.dev20250527__py3-none-any.whl → 1.45.2.dev20250530__py3-none-any.whl

streamlit/elements/lib/streamlit_plotly_theme.py

@@ -15,6 +15,60 @@
 from __future__ import annotations
 
 import contextlib
+from typing import Final
+
+# This is the streamlit theme for plotly where we pass in a template.data
+# and a template.layout.
+# Template.data is for changing specific graph properties in a general aspect
+# such as Contour plots or Waterfall plots.
+# Template.layout is for changing things such as the x axis and fonts and other
+# general layout properties for general graphs.
+# We pass in temporary colors to the frontend and the frontend will replace
+# those colors because we want to change colors based on the background color.
+# Start at #0000001 because developers may be likely to use #000000
+CATEGORY_0: Final = "#000001"
+CATEGORY_1: Final = "#000002"
+CATEGORY_2: Final = "#000003"
+CATEGORY_3: Final = "#000004"
+CATEGORY_4: Final = "#000005"
+CATEGORY_5: Final = "#000006"
+CATEGORY_6: Final = "#000007"
+CATEGORY_7: Final = "#000008"
+CATEGORY_8: Final = "#000009"
+CATEGORY_9: Final = "#000010"
+
+SEQUENTIAL_0: Final = "#000011"
+SEQUENTIAL_1: Final = "#000012"
+SEQUENTIAL_2: Final = "#000013"
+SEQUENTIAL_3: Final = "#000014"
+SEQUENTIAL_4: Final = "#000015"
+SEQUENTIAL_5: Final = "#000016"
+SEQUENTIAL_6: Final = "#000017"
+SEQUENTIAL_7: Final = "#000018"
+SEQUENTIAL_8: Final = "#000019"
+SEQUENTIAL_9: Final = "#000020"
+
+DIVERGING_0: Final = "#000021"
+DIVERGING_1: Final = "#000022"
+DIVERGING_2: Final = "#000023"
+DIVERGING_3: Final = "#000024"
+DIVERGING_4: Final = "#000025"
+DIVERGING_5: Final = "#000026"
+DIVERGING_6: Final = "#000027"
+DIVERGING_7: Final = "#000028"
+DIVERGING_8: Final = "#000029"
+DIVERGING_9: Final = "#000030"
+DIVERGING_10: Final = "#000031"
+
+INCREASING: Final = "#000032"
+DECREASING: Final = "#000033"
+TOTAL: Final = "#000034"
+
+GRAY_70: Final = "#000036"
+GRAY_90: Final = "#000037"
+BG_COLOR: Final = "#000038"
+FADED_TEXT_05: Final = "#000039"
+BG_MIX: Final = "#000040"
 
 
 def configure_streamlit_plotly_theme() -> None:
@@ -27,59 +81,6 @@ def configure_streamlit_plotly_theme() -> None:
         import plotly.graph_objects as go
         import plotly.io as pio
 
-        # This is the streamlit theme for plotly where we pass in a template.data
-        # and a template.layout.
-        # Template.data is for changing specific graph properties in a general aspect
-        # such as Contour plots or Waterfall plots.
-        # Template.layout is for changing things such as the x axis and fonts and other
-        # general layout properties for general graphs.
-        # We pass in temporary colors to the frontend and the frontend will replace
-        # those colors because we want to change colors based on the background color.
-        # Start at #0000001 because developers may be likely to use #000000
-        CATEGORY_0 = "#000001"
-        CATEGORY_1 = "#000002"
-        CATEGORY_2 = "#000003"
-        CATEGORY_3 = "#000004"
-        CATEGORY_4 = "#000005"
-        CATEGORY_5 = "#000006"
-        CATEGORY_6 = "#000007"
-        CATEGORY_7 = "#000008"
-        CATEGORY_8 = "#000009"
-        CATEGORY_9 = "#000010"
-
-        SEQUENTIAL_0 = "#000011"
-        SEQUENTIAL_1 = "#000012"
-        SEQUENTIAL_2 = "#000013"
-        SEQUENTIAL_3 = "#000014"
-        SEQUENTIAL_4 = "#000015"
-        SEQUENTIAL_5 = "#000016"
-        SEQUENTIAL_6 = "#000017"
-        SEQUENTIAL_7 = "#000018"
-        SEQUENTIAL_8 = "#000019"
-        SEQUENTIAL_9 = "#000020"
-
-        DIVERGING_0 = "#000021"
-        DIVERGING_1 = "#000022"
-        DIVERGING_2 = "#000023"
-        DIVERGING_3 = "#000024"
-        DIVERGING_4 = "#000025"
-        DIVERGING_5 = "#000026"
-        DIVERGING_6 = "#000027"
-        DIVERGING_7 = "#000028"
-        DIVERGING_8 = "#000029"
-        DIVERGING_9 = "#000030"
-        DIVERGING_10 = "#000031"
-
-        INCREASING = "#000032"
-        DECREASING = "#000033"
-        TOTAL = "#000034"
-
-        GRAY_70 = "#000036"
-        GRAY_90 = "#000037"
-        BG_COLOR = "#000038"
-        FADED_TEXT_05 = "#000039"
-        BG_MIX = "#000040"
-
         # Plotly represents continuous colorscale through an array of pairs.
         # The pair's first index is the starting point and the next pair's first index is the end point.
         # The pair's second index is the starting color and the next pair's second index is the end color.

streamlit/elements/lib/utils.py

@@ -31,6 +31,7 @@ from streamlit import config
 from streamlit.errors import StreamlitDuplicateElementId, StreamlitDuplicateElementKey
 from streamlit.proto.ChatInput_pb2 import ChatInput
 from streamlit.proto.LabelVisibilityMessage_pb2 import LabelVisibilityMessage
+from streamlit.proto.RootContainer_pb2 import RootContainer
 from streamlit.runtime.scriptrunner_utils.script_run_context import (
     ScriptRunContext,
     get_script_run_ctx,
@@ -45,6 +46,8 @@ if TYPE_CHECKING:
     from builtins import ellipsis
     from collections.abc import Iterable
 
+    from streamlit.delta_generator import DeltaGenerator
+
 
 Key: TypeAlias = Union[str, int]
 
@@ -182,6 +185,7 @@ def compute_and_register_element_id(
     *,
     user_key: str | None,
     form_id: str | None,
+    dg: DeltaGenerator | None = None,
     **kwargs: SAFE_VALUES | Iterable[SAFE_VALUES],
 ) -> str:
     """Compute and register the ID for the given element.
@@ -212,6 +216,9 @@ def compute_and_register_element_id(
         The ID of the form that the element belongs to. `None` or empty string
         if the element doesn't belong to a form or doesn't support forms.
 
+    dg : DeltaGenerator | None
+        The DeltaGenerator of each element. `None` if the element is not a widget.
+
     kwargs : SAFE_VALUES | Iterable[SAFE_VALUES]
         The arguments to use to compute the element ID.
         The arguments must be stable, deterministic values.
@@ -229,6 +236,14 @@ def compute_and_register_element_id(
         # pages unique IDs.
         kwargs_to_use["active_script_hash"] = ctx.active_script_hash
 
+    if dg:
+        # If no key is provided and the widget element is inside the sidebar area
+        # add it to the kwargs
+        # allowing the same widget to be both in main area and sidebar.
+        active_dg_root_container = dg._active_dg._root_container
+        if active_dg_root_container == RootContainer.SIDEBAR and user_key is None:
+            kwargs_to_use["active_dg_root_container"] = str(active_dg_root_container)
+
     element_id = _compute_element_id(
         element_type,
         user_key,

streamlit/elements/markdown.py

@@ -16,6 +16,12 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, Final, Literal, cast
 
+from streamlit.elements.lib.layout_utils import (
+    LayoutConfig,
+    Width,
+    WidthWithoutContent,
+    validate_width,
+)
 from streamlit.proto.Markdown_pb2 import Markdown as MarkdownProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import clean_text, validate_icon_or_emoji
@@ -212,6 +218,7 @@ class MarkdownMixin:
         body: SupportsStr | sympy.Expr,
         *,  # keyword-only arguments:
         help: str | None = None,
+        width: Width = "stretch",
     ) -> DeltaGenerator:
         # This docstring needs to be "raw" because of the backslashes in the
         # example below.
@@ -235,6 +242,12 @@ class MarkdownMixin:
             including the Markdown directives described in the ``body``
             parameter of ``st.markdown``.
 
+        width : int or "stretch" or "content"
+            The width of the LaTeX expression. If "stretch" (default), the
+            expression will take up the full width of the container. If "content",
+            the expression will take up only as much width as needed. If an integer,
+            the width will be set to that number of pixels.
+
         Example
         -------
         >>> import streamlit as st
@@ -246,22 +259,34 @@ class MarkdownMixin:
         ...     ''')
 
         """
+
         if is_sympy_expression(body):
             import sympy
 
             body = sympy.latex(body)
 
         latex_proto = MarkdownProto()
-        latex_proto.body = "$$\n%s\n$$" % clean_text(body)
+        latex_proto.body = f"$$\n{clean_text(body)}\n$$"
         latex_proto.element_type = MarkdownProto.Type.LATEX
         if help:
             latex_proto.help = help
-        return self.dg._enqueue("markdown", latex_proto)
+
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width)
+
+        return self.dg._enqueue("markdown", latex_proto, layout_config=layout_config)
 
     @gather_metrics("divider")
-    def divider(self) -> DeltaGenerator:
+    def divider(self, *, width: WidthWithoutContent = "stretch") -> DeltaGenerator:
         """Display a horizontal rule.
 
+        Parameters
+        ----------
+        width : int or "stretch"
+            The width of the divider. If "stretch" (default), the divider will
+            take up the full width of the container. If an integer, the width
+            will be set to that number of pixels.
+
         .. note::
             You can achieve the same effect with st.write("---") or
             even just "---" in your script (via magic).
@@ -273,10 +298,15 @@ class MarkdownMixin:
         >>> st.divider()
 
         """
+
         divider_proto = MarkdownProto()
         divider_proto.body = MARKDOWN_HORIZONTAL_RULE_EXPRESSION
         divider_proto.element_type = MarkdownProto.Type.DIVIDER
-        return self.dg._enqueue("markdown", divider_proto)
+
+        validate_width(width, allow_content=False)
+        layout_config = LayoutConfig(width=width)
+
+        return self.dg._enqueue("markdown", divider_proto, layout_config=layout_config)
 
     @gather_metrics("badge")
     def badge(

streamlit/elements/media.py

@@ -478,7 +478,7 @@ def _marshall_av_media(
     elif type_util.is_type(data, "numpy.ndarray"):
         data_or_filename = cast("npt.NDArray[Any]", data).tobytes()
     else:
-        raise RuntimeError("Invalid binary data format: %s" % type(data))
+        raise RuntimeError(f"Invalid binary data format: {type(data)}")
 
     if runtime.exists():
         file_url = runtime.get_instance().media_file_mgr.add(

streamlit/elements/plotly_chart.py

@@ -510,6 +510,7 @@ class PlotlyMixin:
             "plotly_chart",
             user_key=key,
             form_id=plotly_chart_proto.form_id,
+            dg=self.dg,
             plotly_spec=plotly_chart_proto.spec,
             plotly_config=plotly_chart_proto.config,
             selection_mode=selection_mode,

streamlit/elements/progress.py

@@ -19,10 +19,9 @@ from typing import TYPE_CHECKING, Union, cast
 
 from typing_extensions import TypeAlias
 
-from streamlit.elements.lib.layout_utils import validate_width
+from streamlit.elements.lib.layout_utils import LayoutConfig, validate_width
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.Progress_pb2 import Progress as ProgressProto
-from streamlit.proto.WidthConfig_pb2 import WidthConfig
 from streamlit.string_util import clean_text
 
 if TYPE_CHECKING:
@@ -66,17 +65,17 @@ def _get_value(value: FloatOrInt) -> int:
         if 0 <= value <= 100:
             return value
         raise StreamlitAPIException(
-            "Progress Value has invalid value [0, 100]: %d" % value
+            f"Progress Value has invalid value [0, 100]: {value}"
         )
 
     if isinstance(value, float):
         if _check_float_between(value, low=0.0, high=1.0):
             return int(value * 100)
         raise StreamlitAPIException(
-            "Progress Value has invalid value [0.0, 1.0]: %f" % value
+            f"Progress Value has invalid value [0.0, 1.0]: {value}"
         )
     raise StreamlitAPIException(
-        "Progress Value has invalid type: %s" % type(value).__name__
+        f"Progress Value has invalid type: {type(value).__name__}"
     )
 
 
@@ -158,18 +157,10 @@ class ProgressMixin:
         if text is not None:
             progress_proto.text = text
 
-        width_config = WidthConfig()
-
         validate_width(width)
+        layout_config = LayoutConfig(width=width)
 
-        if isinstance(width, int):
-            width_config.pixel_width = width
-        else:
-            width_config.use_stretch = True
-
-        progress_proto.width_config.CopyFrom(width_config)
-
-        return self.dg._enqueue("progress", progress_proto)
+        return self.dg._enqueue("progress", progress_proto, layout_config=layout_config)
 
     @property
     def dg(self) -> DeltaGenerator:

streamlit/elements/spinner.py

@@ -16,7 +16,7 @@ from __future__ import annotations
 
 import contextlib
 import threading
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Final
 
 import streamlit as st
 from streamlit.runtime.scriptrunner import add_script_run_ctx
@@ -24,6 +24,10 @@ from streamlit.runtime.scriptrunner import add_script_run_ctx
 if TYPE_CHECKING:
     from collections.abc import Iterator
 
+# Set the message 0.5 seconds in the future to avoid annoying
+# flickering if this spinner runs too quickly.
+DELAY_SECS: Final = 0.5
+
 
 @contextlib.contextmanager
 def spinner(
@@ -75,9 +79,6 @@ def spinner(
 
     message = st.empty()
 
-    # Set the message 0.5 seconds in the future to avoid annoying
-    # flickering if this spinner runs too quickly.
-    DELAY_SECS = 0.5
     display_message = True
     display_message_lock = threading.Lock()
 

streamlit/elements/vega_charts.py

@@ -1947,6 +1947,7 @@ class VegaChartsMixin:
                 "arrow_vega_lite_chart",
                 user_key=key,
                 form_id=vega_lite_proto.form_id,
+                dg=self.dg,
                 vega_lite_spec=vega_lite_proto.spec,
                 # The data is either in vega_lite_proto.data.data
                 # or in a named dataset in vega_lite_proto.datasets

streamlit/elements/widgets/audio_input.py

@@ -22,7 +22,7 @@ from typing_extensions import TypeAlias
 
 from streamlit.elements.lib.file_uploader_utils import enforce_filename_restriction
 from streamlit.elements.lib.form_utils import current_form_id
-from streamlit.elements.lib.layout_utils import validate_width
+from streamlit.elements.lib.layout_utils import LayoutConfig, validate_width
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,
@@ -38,7 +38,6 @@ from streamlit.elements.widgets.file_uploader import _get_upload_files
 from streamlit.proto.AudioInput_pb2 import AudioInput as AudioInputProto
 from streamlit.proto.Common_pb2 import FileUploaderState as FileUploaderStateProto
 from streamlit.proto.Common_pb2 import UploadedFileInfo as UploadedFileInfoProto
-from streamlit.proto.WidthConfig_pb2 import WidthConfig
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner import ScriptRunContext, get_script_run_ctx
 from streamlit.runtime.state import (
@@ -236,6 +235,7 @@ class AudioInputMixin:
             "audio_input",
             user_key=key,
             form_id=current_form_id(self.dg),
+            dg=self.dg,
             label=label,
             help=help,
             width=width,
@@ -253,14 +253,8 @@ class AudioInputMixin:
         if label and help is not None:
             audio_input_proto.help = dedent(help)
 
-        # Set width configuration
         validate_width(width)
-        width_config = WidthConfig()
-        if isinstance(width, int):
-            width_config.pixel_width = width
-        else:
-            width_config.use_stretch = True
-        audio_input_proto.width_config.CopyFrom(width_config)
+        layout_config = LayoutConfig(width=width)
 
         serde = AudioInputSerde()
 
@@ -275,7 +269,7 @@ class AudioInputMixin:
             value_type="file_uploader_state_value",
         )
 
-        self.dg._enqueue("audio_input", audio_input_proto)
+        self.dg._enqueue("audio_input", audio_input_proto, layout_config=layout_config)
 
         if isinstance(audio_input_state.value, DeletedFile):
             return None

streamlit/elements/widgets/button.py

@@ -818,6 +818,7 @@ class ButtonMixin:
             user_key=key,
             # download_button is not allowed to be used in a form.
             form_id=None,
+            dg=self.dg,
             label=label,
             icon=icon,
             file_name=file_name,
@@ -1009,6 +1010,7 @@ class ButtonMixin:
             user_key=key,
             # Only the
             form_id=form_id,
+            dg=self.dg,
             label=label,
             icon=icon,
             help=help,
@@ -1105,7 +1107,7 @@ def marshall_file(
         data_as_bytes = data.read() or b""
         mimetype = mimetype or "application/octet-stream"
     else:
-        raise StreamlitAPIException("Invalid binary data format: %s" % type(data))
+        raise StreamlitAPIException(f"Invalid binary data format: {type(data)}")
 
     if runtime.exists():
         file_url = runtime.get_instance().media_file_mgr.add(

streamlit/elements/widgets/button_group.py

@@ -984,6 +984,7 @@ class ButtonGroupMixin:
             widget_name,
             user_key=key,
             form_id=form_id,
+            dg=self.dg,
             options=formatted_options,
             default=default,
             click_mode=parsed_selection_mode,

streamlit/elements/widgets/camera_input.py

@@ -22,7 +22,7 @@ from typing_extensions import TypeAlias
 
 from streamlit.elements.lib.file_uploader_utils import enforce_filename_restriction
 from streamlit.elements.lib.form_utils import current_form_id
-from streamlit.elements.lib.layout_utils import validate_width
+from streamlit.elements.lib.layout_utils import LayoutConfig, validate_width
 from streamlit.elements.lib.policies import (
     check_widget_policies,
     maybe_raise_label_warnings,
@@ -38,7 +38,6 @@ from streamlit.elements.widgets.file_uploader import _get_upload_files
 from streamlit.proto.CameraInput_pb2 import CameraInput as CameraInputProto
 from streamlit.proto.Common_pb2 import FileUploaderState as FileUploaderStateProto
 from streamlit.proto.Common_pb2 import UploadedFileInfo as UploadedFileInfoProto
-from streamlit.proto.WidthConfig_pb2 import WidthConfig
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner import ScriptRunContext, get_script_run_ctx
 from streamlit.runtime.state import (
@@ -230,6 +229,7 @@ class CameraInputMixin:
             "camera_input",
             user_key=key,
             form_id=current_form_id(self.dg),
+            dg=self.dg,
             label=label,
             help=help,
             width=width,
@@ -248,12 +248,7 @@ class CameraInputMixin:
             camera_input_proto.help = dedent(help)
 
         validate_width(width)
-        width_config = WidthConfig()
-        if isinstance(width, int):
-            width_config.pixel_width = width
-        else:
-            width_config.use_stretch = True
-        camera_input_proto.width_config.CopyFrom(width_config)
+        layout_config = LayoutConfig(width=width)
 
         serde = CameraInputSerde()
 
@@ -268,7 +263,9 @@ class CameraInputMixin:
             value_type="file_uploader_state_value",
         )
 
-        self.dg._enqueue("camera_input", camera_input_proto)
+        self.dg._enqueue(
+            "camera_input", camera_input_proto, layout_config=layout_config
+        )
 
         if isinstance(camera_input_state.value, DeletedFile):
             return None

streamlit/elements/widgets/chat.py

@@ -34,6 +34,7 @@ from streamlit.elements.lib.file_uploader_utils import (
 from streamlit.elements.lib.form_utils import is_in_form
 from streamlit.elements.lib.image_utils import AtomicImage, WidthBehavior, image_to_url
 from streamlit.elements.lib.layout_utils import (
+    LayoutConfig,
     Width,
     WidthWithoutContent,
     validate_width,
@@ -123,7 +124,7 @@ def _process_avatar_input(
     Tuple[AvatarType, str]
         The detected avatar type and the prepared avatar data.
     """
-    AvatarType = BlockProto.ChatMessage.AvatarType
+    AvatarType = BlockProto.ChatMessage.AvatarType  # noqa: N806
 
     if avatar is None:
         return AvatarType.ICON, ""
@@ -350,11 +351,11 @@ class ChatMixin:
             width_config.use_content = True
         else:
             width_config.use_stretch = True
-        message_container_proto.width_config.CopyFrom(width_config)
 
         block_proto = BlockProto()
         block_proto.allow_empty = True
         block_proto.chat_message.CopyFrom(message_container_proto)
+        block_proto.width_config.CopyFrom(width_config)
 
         return self.dg._block(block_proto=block_proto)
 
@@ -582,8 +583,6 @@ class ChatMixin:
             writes_allowed=False,
         )
 
-        validate_width(width)
-
         if accept_file not in {True, False, "multiple"}:
             raise StreamlitAPIException(
                 "The `accept_file` parameter must be a boolean or 'multiple'."
@@ -596,6 +595,7 @@ class ChatMixin:
             user_key=key,
             # chat_input is not allowed to be used in a form.
             form_id=None,
+            dg=self.dg,
             placeholder=placeholder,
             max_chars=max_chars,
             accept_file=accept_file,
@@ -644,13 +644,6 @@ class ChatMixin:
         chat_input_proto.file_type[:] = file_type if file_type is not None else []
         chat_input_proto.max_upload_size_mb = config.get_option("server.maxUploadSize")
 
-        width_config = WidthConfig()
-        if isinstance(width, int):
-            width_config.pixel_width = width
-        else:
-            width_config.use_stretch = True
-        chat_input_proto.width_config.CopyFrom(width_config)
-
         serde = ChatInputSerde(
             accept_files=bool(accept_file),
             allowed_types=file_type,
@@ -666,6 +659,9 @@ class ChatMixin:
             value_type="chat_input_value",
         )
 
+        validate_width(width)
+        layout_config = LayoutConfig(width=width)
+
         chat_input_proto.disabled = disabled
         if widget_state.value_changed and widget_state.value is not None:
             chat_input_proto.value = widget_state.value
@@ -677,10 +673,12 @@ class ChatMixin:
             # We need to enqueue the chat input into the bottom container
             # instead of the currently active dg.
             get_dg_singleton_instance().bottom_dg._enqueue(
-                "chat_input", chat_input_proto
+                "chat_input", chat_input_proto, layout_config=layout_config
             )
         else:
-            self.dg._enqueue("chat_input", chat_input_proto)
+            self.dg._enqueue(
+                "chat_input", chat_input_proto, layout_config=layout_config
+            )
 
         return widget_state.value if not widget_state.value_changed else None
 

streamlit/elements/widgets/checkbox.py

@@ -307,6 +307,7 @@ class CheckboxMixin:
             "toggle" if type == CheckboxProto.StyleType.TOGGLE else "checkbox",
             user_key=key,
             form_id=current_form_id(self.dg),
+            dg=self.dg,
             label=label,
             value=bool(value),
             help=help,

streamlit/elements/widgets/color_picker.py

@@ -195,6 +195,7 @@ class ColorPickerMixin:
             "color_picker",
             user_key=key,
             form_id=current_form_id(self.dg),
+            dg=self.dg,
             label=label,
             value=str(value),
             help=help,
@@ -206,25 +207,19 @@ class ColorPickerMixin:
 
         # make sure the value is a string
         if not isinstance(value, str):
-            raise StreamlitAPIException(
-                """
-                Color Picker Value has invalid type: %s. Expects a hex string
-                like '#00FFAA' or '#000'.
-                """
-                % type(value).__name__
-            )
+            raise StreamlitAPIException(f"""
+Color Picker Value has invalid type: {type(value).__name__}. Expects a hex string
+like '#00FFAA' or '#000'.
+""")
 
         # validate the value and expects a hex string
         match = re.match(r"^#(?:[0-9a-fA-F]{3}){1,2}$", value)
 
         if not match:
-            raise StreamlitAPIException(
-                """
-                '%s' is not a valid hex code for colors. Valid ones are like
-                '#00FFAA' or '#000'.
-                """
-                % value
-            )
+            raise StreamlitAPIException(f"""
+'{value}' is not a valid hex code for colors. Valid ones are like
+'#00FFAA' or '#000'.
+""")
 
         color_picker_proto = ColorPickerProto()
         color_picker_proto.id = element_id