streamlit 1.48.0__py3-none-any.whl → 1.49.0__py3-none-any.whl

streamlit/elements/bokeh_chart.py

@@ -19,6 +19,9 @@ from __future__ import annotations
 import json
 from typing import TYPE_CHECKING, Final, cast
 
+from streamlit.deprecation_util import (
+    show_deprecation_warning,
+)
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.BokehChart_pb2 import BokehChart as BokehChartProto
 from streamlit.runtime.metrics_util import gather_metrics
@@ -50,10 +53,11 @@ class BokehMixin:
 
         .. Important::
             You must install ``bokeh==2.4.3`` and ``numpy<2`` to use this
-            command.
+            command, which is deprecated and will be removed in a future
+            version.
 
-            If you need a newer version of Bokeh, use our |streamlit-bokeh|_
-            custom component instead.
+            For more current updates, use the |streamlit-bokeh|_ custom
+            component instead.
 
         .. |streamlit-bokeh| replace:: ``streamlit-bokeh``
         .. _streamlit-bokeh: https://github.com/streamlit/streamlit-bokeh
@@ -101,6 +105,12 @@ class BokehMixin:
                 f"[streamlit-bokeh](https://github.com/streamlit/streamlit-bokeh)."
             )
 
+        show_deprecation_warning(
+            "st.bokeh_chart is deprecated and will be removed in a future version. "
+            "Please use our custom component, "
+            "[streamlit-bokeh](https://github.com/streamlit/streamlit-bokeh), "
+            "instead."
+        )
         # Generate element ID from delta path
         delta_path = self.dg._get_delta_path_str()
 

streamlit/elements/deck_gl_json_chart.py

@@ -521,7 +521,6 @@ class PydeckMixin:
                 selection_mode=selection_mode,
                 use_container_width=use_container_width,
                 spec=spec,
-                form_id=pydeck_proto.form_id,
             )
 
             serde = PydeckSelectionSerde()

streamlit/elements/dialog_decorator.py

@@ -21,10 +21,6 @@ from streamlit.delta_generator_singletons import (
     get_dg_singleton_instance,
     get_last_dg_added_to_context_stack,
 )
-from streamlit.deprecation_util import (
-    make_deprecated_name_warning,
-    show_deprecation_warning,
-)
 from streamlit.errors import StreamlitAPIException
 from streamlit.runtime.fragment import _fragment
 from streamlit.runtime.metrics_util import gather_metrics
@@ -67,7 +63,6 @@ def _dialog_decorator(
     title: str,
     *,
     width: DialogWidth = "small",
-    should_show_deprecation_warning: bool = False,
     dismissible: bool = True,
     on_dismiss: Literal["ignore", "rerun"] | WidgetCallback = "ignore",
 ) -> F:
@@ -89,15 +84,6 @@ def _dialog_decorator(
         dialog.open()
 
         def dialog_content() -> None:
-            if should_show_deprecation_warning:
-                show_deprecation_warning(
-                    make_deprecated_name_warning(
-                        "experimental_dialog",
-                        "dialog",
-                        "2025-01-01",
-                    )
-                )
-
             # if the dialog should be closed, st.rerun() has to be called
             # (same behavior as with st.fragment)
             _ = non_optional_func(*args, **kwargs)
@@ -212,10 +198,13 @@ def dialog_decorator(
         .. |st.markdown| replace:: ``st.markdown``
         .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
 
-    width : "small", "large"
-        The width of the modal dialog. If ``width`` is ``"small`` (default), the
-        modal dialog will be 500 pixels wide. If ``width`` is ``"large"``, the
-        modal dialog will be about 750 pixels wide.
+    width : "small", "medium", "large"
+        The width of the modal dialog. This can be one of the following:
+
+        - ``"small"`` (default): The modal dialog will be a maximum of 500
+          pixels wide.
+        - ``"medium"``: The modal dialog will be up to 750 pixels wide.
+        - ``"large"``: The modal dialog will be up to 1280 pixels wide.
 
     dismissible : bool
         Whether the modal dialog can be dismissed by the user. If this is
@@ -295,44 +284,3 @@ def dialog_decorator(
     return _dialog_decorator(
         func, "", width=width, dismissible=dismissible, on_dismiss=on_dismiss
     )
-
-
-@overload
-def experimental_dialog_decorator(
-    title: str, *, width: DialogWidth = "small"
-) -> Callable[[F], F]: ...
-
-
-# 'title' can be a function since `dialog_decorator` is a decorator. We just call it
-# 'title' here though to make the user-doc more friendly as we want the user to pass a
-#  title, not a function. The user is supposed to call it like @st.dialog("my_title"),
-#  which makes 'title' a positional arg, hence this 'trick'. The overload is required to
-#  have a good type hint for the decorated function args.
-@overload
-def experimental_dialog_decorator(title: F, *, width: DialogWidth = "small") -> F: ...
-
-
-@gather_metrics("experimental_dialog")
-def experimental_dialog_decorator(
-    title: F | str, *, width: DialogWidth = "small"
-) -> F | Callable[[F], F]:
-    """Deprecated alias for @st.dialog.
-    See the docstring for the decorator's new name.
-    """
-    func_or_title = title
-    if isinstance(func_or_title, str):
-        # Support passing the params via function decorator
-        def wrapper(f: F) -> F:
-            return _dialog_decorator(
-                non_optional_func=f,
-                title=func_or_title,
-                width=width,
-                should_show_deprecation_warning=True,
-            )
-
-        return wrapper
-
-    func: F = func_or_title
-    return _dialog_decorator(
-        func, "", width=width, should_show_deprecation_warning=True
-    )

streamlit/elements/form.py

@@ -29,6 +29,7 @@ from streamlit.elements.lib.policies import (
     check_cache_replay_rules,
     check_session_state_rules,
 )
+from streamlit.elements.lib.utils import Key, to_key
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto import Block_pb2
 from streamlit.runtime.metrics_util import gather_metrics
@@ -243,6 +244,7 @@ class FormMixin:
         args: WidgetArgs | None = None,
         kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
+        key: Key | None = None,
         type: Literal["primary", "secondary", "tertiary"] = "secondary",
         icon: str | None = None,
         disabled: bool = False,
@@ -297,6 +299,11 @@ class FormMixin:
         kwargs : dict
             An optional dict of kwargs to pass to the callback.
 
+        key : str or int
+            An optional string or integer to use as the unique key for the widget.
+            If this is omitted, a key will be generated for the widget
+            based on its content. No two widgets may have the same key.
+
         type : "primary", "secondary", or "tertiary"
             An optional string that specifies the button type. This can be one
             of the following:
@@ -390,6 +397,7 @@ class FormMixin:
             disabled=disabled,
             ctx=ctx,
             width=width,
+            key=key,
         )
 
     def _form_submit_button(
@@ -400,6 +408,7 @@ class FormMixin:
         args: WidgetArgs | None = None,
         kwargs: WidgetKwargs | None = None,
         *,  # keyword-only arguments:
+        key: Key | None = None,
         type: Literal["primary", "secondary", "tertiary"] = "secondary",
         icon: str | None = None,
         disabled: bool = False,
@@ -407,7 +416,7 @@ class FormMixin:
         width: Width = "content",
     ) -> bool:
         form_id = current_form_id(self.dg)
-        submit_button_key = f"FormSubmitter:{form_id}-{label}"
+        submit_button_key = to_key(key) or f"FormSubmitter:{form_id}-{label}"
         return self.dg._button(
             label=label,
             key=submit_button_key,

streamlit/elements/graphviz_chart.py

@@ -21,6 +21,15 @@ from typing import TYPE_CHECKING, Union, cast
 from typing_extensions import TypeAlias
 
 from streamlit import type_util
+from streamlit.deprecation_util import (
+    make_deprecated_name_warning,
+    show_deprecation_warning,
+)
+from streamlit.elements.lib.layout_utils import (
+    LayoutConfig,
+    Width,
+    validate_width,
+)
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.GraphVizChart_pb2 import GraphVizChart as GraphVizChartProto
 from streamlit.runtime.metrics_util import gather_metrics
@@ -41,7 +50,9 @@ class GraphvizMixin:
     def graphviz_chart(
         self,
         figure_or_dot: FigureOrDot,
-        use_container_width: bool = False,
+        use_container_width: bool | None = None,
+        *,  # keyword-only arguments:
+        width: Width = "content",
     ) -> DeltaGenerator:
         """Display a graph using the dagre-d3 library.
 
@@ -50,7 +61,9 @@ class GraphvizMixin:
             install all charting dependencies (except Bokeh) as an extra with
             Streamlit:
 
-            >>> pip install streamlit[charts]
+            .. code-block:: shell
+
+               pip install streamlit[charts]
 
         Parameters
         ----------
@@ -65,6 +78,25 @@ class GraphvizMixin:
             container. If ``use_container_width`` is ``True``, Streamlit sets
             the width of the figure to match the width of the parent container.
 
+        width : "content", "stretch", or int
+            The width of the chart element. This can be one of the following:
+
+            - ``"content"`` (default): The width of the element matches the
+              width of its content, but doesn't exceed the width of the parent
+              container.
+            - ``"stretch"``: The width of the element matches the width of the
+              parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+
+        .. deprecated::
+            ``use_container_width`` is deprecated and will be removed in a
+            future release. For ``use_container_width=True``, use
+            ``width="stretch"``. For ``use_container_width=False``, use
+            ``width="content"``.
+
         Example
         -------
         >>> import streamlit as st
@@ -114,14 +146,35 @@ class GraphvizMixin:
            height: 600px
 
         """
+        if use_container_width is not None:
+            show_deprecation_warning(
+                make_deprecated_name_warning(
+                    "use_container_width",
+                    "width",
+                    "2025-12-31",
+                    "For `use_container_width=True`, use `width='stretch'`. "
+                    "For `use_container_width=False`, use `width='content'`.",
+                    include_st_prefix=False,
+                ),
+                show_in_browser=False,
+            )
+            width = "stretch" if use_container_width else "content"
+
         # Generate element ID from delta path
         delta_path = self.dg._get_delta_path_str()
         element_id = calc_md5(delta_path.encode())
 
         graphviz_chart_proto = GraphVizChartProto()
 
-        marshall(graphviz_chart_proto, figure_or_dot, use_container_width, element_id)
-        return self.dg._enqueue("graphviz_chart", graphviz_chart_proto)
+        marshall(graphviz_chart_proto, figure_or_dot, element_id)
+
+        # Validate and set layout configuration
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width)
+
+        return self.dg._enqueue(
+            "graphviz_chart", graphviz_chart_proto, layout_config=layout_config
+        )
 
     @property
     def dg(self) -> DeltaGenerator:
@@ -132,7 +185,6 @@ class GraphvizMixin:
 def marshall(
     proto: GraphVizChartProto,
     figure_or_dot: FigureOrDot,
-    use_container_width: bool,
     element_id: str,
 ) -> None:
     """Construct a GraphViz chart object.
@@ -153,5 +205,4 @@ def marshall(
 
     proto.spec = dot
     proto.engine = engine
-    proto.use_container_width = use_container_width
     proto.element_id = element_id

streamlit/elements/heading.py

@@ -79,13 +79,13 @@ class HeadingMixin:
             including the Markdown directives described in the ``body``
             parameter of ``st.markdown``.
 
-        divider : bool, “blue”, “green”, “orange”, “red”, “violet”, “gray”/"grey", or “rainbow”
-            Shows a colored divider below the header. If True, successive
-            headers will cycle through divider colors. That is, the first
-            header will have a blue line, the second header will have a
-            green line, and so on. If a string, the color can be set to one of
-            the following: blue, green, orange, red, violet, gray/grey, or
-            rainbow.
+        divider : bool, "blue", "green", "orange", "red", "violet", "yellow", "gray"/"grey", or "rainbow"
+            Shows a colored divider below the header. If this is ``True``,
+            successive headers will cycle through divider colors, except gray
+            and rainbow. That is, the first header will have a blue line, the
+            second header will have a green line, and so on. If this is a
+            string, the color can be set to one of the following: blue, green,
+            orange, red, violet, yellow, gray/grey, or rainbow.
 
         width : "stretch", "content", or int
             The width of the header element. This can be one of the following:
@@ -168,13 +168,13 @@ class HeadingMixin:
             including the Markdown directives described in the ``body``
             parameter of ``st.markdown``.
 
-        divider : bool or “blue”, “green”, “orange”, “red”, “violet”, “gray”/"grey", or “rainbow”
-            Shows a colored divider below the header. If True, successive
-            headers will cycle through divider colors. That is, the first
-            header will have a blue line, the second header will have a
-            green line, and so on. If a string, the color can be set to one of
-            the following: blue, green, orange, red, violet, gray/grey, or
-            rainbow.
+        divider : bool, "blue", "green", "orange", "red", "violet", "yellow", "gray"/"grey", or "rainbow"
+            Shows a colored divider below the header. If this is ``True``,
+            successive headers will cycle through divider colors, except gray
+            and rainbow. That is, the first header will have a blue line, the
+            second header will have a green line, and so on. If this is a
+            string, the color can be set to one of the following: blue, green,
+            orange, red, violet, yellow, gray/grey, or rainbow.
 
         width : "stretch", "content", or int
             The width of the subheader element. This can be one of the following:
@@ -304,10 +304,11 @@ class HeadingMixin:
         if divider is True:
             return "auto"
         valid_colors = [
+            "red",
+            "orange",
+            "yellow",
             "blue",
             "green",
-            "orange",
-            "red",
             "violet",
             "gray",
             "grey",

streamlit/elements/iframe.py

@@ -16,6 +16,7 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, cast
 
+from streamlit.elements.lib.layout_utils import LayoutConfig
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.IFrame_pb2 import IFrame as IFrameProto
 from streamlit.runtime.metrics_util import gather_metrics
@@ -95,12 +96,15 @@ class IframeMixin:
         marshall(
             iframe_proto,
             src=src,
-            width=width,
-            height=height,
             scrolling=scrolling,
             tab_index=tab_index,
         )
-        return self.dg._enqueue("iframe", iframe_proto)
+        # When no width is specified, we want the iframe to stretch to fill the container.
+        layout_config = LayoutConfig(
+            width=width if width is not None else "stretch",
+            height=height if height is not None else 150,
+        )
+        return self.dg._enqueue("iframe", iframe_proto, layout_config=layout_config)
 
     @gather_metrics("_html")
     def _html(
@@ -177,12 +181,15 @@ class IframeMixin:
         marshall(
             iframe_proto,
             srcdoc=html,
-            width=width,
-            height=height,
             scrolling=scrolling,
             tab_index=tab_index,
         )
-        return self.dg._enqueue("iframe", iframe_proto)
+        # When no width is specified, we want the html to stretch to fill the container.
+        layout_config = LayoutConfig(
+            width=width if width is not None else "stretch",
+            height=height if height is not None else 150,
+        )
+        return self.dg._enqueue("iframe", iframe_proto, layout_config=layout_config)
 
     @property
     def dg(self) -> DeltaGenerator:
@@ -194,8 +201,6 @@ def marshall(
     proto: IFrameProto,
     src: str | None = None,
     srcdoc: str | None = None,
-    width: int | None = None,
-    height: int | None = None,
     scrolling: bool = False,
     tab_index: int | None = None,
 ) -> None:
@@ -213,11 +218,6 @@ def marshall(
         The URL of the page to embed.
     srcdoc : str
         Inline HTML to embed. Overrides src.
-    width : int
-        The width of the frame in CSS pixels. Defaults to the app's
-        default element width.
-    height : int
-        The height of the frame in CSS pixels. Defaults to 150.
     scrolling : bool
         If true, show a scrollbar when the content is larger than the iframe.
         Otherwise, never show a scrollbar.
@@ -231,15 +231,6 @@ def marshall(
     if srcdoc is not None:
         proto.srcdoc = srcdoc
 
-    if width is not None:
-        proto.width = width
-        proto.has_width = True
-
-    if height is not None:
-        proto.height = height
-    else:
-        proto.height = 150
-
     proto.scrolling = scrolling
 
     if tab_index is not None:

streamlit/elements/image.py

@@ -25,14 +25,17 @@ from typing import TYPE_CHECKING, Literal, Union, cast
 
 from typing_extensions import TypeAlias
 
-from streamlit.deprecation_util import show_deprecation_warning
+from streamlit.deprecation_util import (
+    make_deprecated_name_warning,
+    show_deprecation_warning,
+)
 from streamlit.elements.lib.image_utils import (
     Channels,
     ImageFormatOrAuto,
     ImageOrImageList,
-    WidthBehavior,
     marshall_images,
 )
+from streamlit.elements.lib.layout_utils import LayoutConfig, Width, validate_width
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.Image_pb2 import ImageList as ImageListProto
 from streamlit.runtime.metrics_util import gather_metrics
@@ -51,13 +54,13 @@ class ImageMixin:
         # TODO: Narrow type of caption, dependent on type of image,
         #  by way of overload
         caption: str | list[str] | None = None,
-        width: int | None = None,
+        width: Width = "content",
         use_column_width: UseColumnWith = None,
         clamp: bool = False,
         channels: Channels = "RGB",
         output_format: ImageFormatOrAuto = "auto",
         *,
-        use_container_width: bool = False,
+        use_container_width: bool | None = None,
     ) -> DeltaGenerator:
         """Display an image or list of images.
 
@@ -91,11 +94,21 @@ class ImageMixin:
 
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
-        width : int or None
-            Image width. If this is ``None`` (default), Streamlit will use the
-            image's native width, up to the width of the parent container.
-            When using an SVG image without a default width, you should declare
-            ``width`` or use ``use_container_width=True``.
+        width : "content", "stretch", or int
+            The width of the image element. This can be one of the following:
+
+            - ``"content"`` (default): The width of the element matches the
+              width of its content, but doesn't exceed the width of the parent
+              container.
+            - ``"stretch"``: The width of the element matches the width of the
+              parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+
+            When using an SVG image without a default width, use ``"stretch"``
+            or an integer.
         use_column_width : "auto", "always", "never", or bool
             If "auto", set the image's width to its natural size,
             but do not exceed the width of the column.
@@ -129,9 +142,15 @@ class ImageMixin:
             ``use_container_width`` is ``True``, Streamlit sets the width of
             the image to match the width of the parent container.
 
+        .. deprecated::
+            ``use_container_width`` is deprecated and will be removed in a
+            future release. For ``use_container_width=True``, use
+            ``width="stretch"``. For ``use_container_width=False``, use
+            ``width="content"``.
+
         .. deprecated::
             ``use_column_width`` is deprecated and will be removed in a future
-            release. Please use the ``use_container_width`` parameter instead.
+            release. Please use the ``width`` parameter instead.
 
         Example
         -------
@@ -144,50 +163,58 @@ class ImageMixin:
 
         """
 
-        if use_container_width is True and use_column_width is not None:
-            raise StreamlitAPIException(
-                "`use_container_width` and `use_column_width` cannot be set at the same time.",
-                "Please utilize `use_container_width` since `use_column_width` is deprecated.",
-            )
-
-        image_width: int = (
-            WidthBehavior.ORIGINAL if (width is None or width <= 0) else width
-        )
-
         if use_column_width is not None:
+            if use_container_width is not None:
+                raise StreamlitAPIException(
+                    "`use_container_width` and `use_column_width` cannot be set at the same time.",
+                    "Please utilize `use_container_width` since `use_column_width` is deprecated.",
+                )
+
             show_deprecation_warning(
                 "The `use_column_width` parameter has been deprecated and will be removed "
                 "in a future release. Please utilize the `use_container_width` parameter instead."
             )
-
-            if use_column_width == "auto":
-                image_width = WidthBehavior.AUTO
+            if use_column_width in {"auto", "never"} or use_column_width is False:
+                width = "content"
             elif use_column_width == "always" or use_column_width is True:
-                image_width = WidthBehavior.COLUMN
-            elif use_column_width == "never" or use_column_width is False:
-                image_width = WidthBehavior.ORIGINAL
-
-        elif use_container_width is True:
-            image_width = WidthBehavior.MAX_IMAGE_OR_CONTAINER
-        elif image_width is not None and image_width > 0:
-            # Use the given width. It will be capped on the frontend if it
-            # exceeds the container width.
-            pass
-        elif use_container_width is False:
-            image_width = WidthBehavior.MIN_IMAGE_OR_CONTAINER
+                width = "stretch"
+
+        if use_container_width is not None:
+            show_deprecation_warning(
+                make_deprecated_name_warning(
+                    "use_container_width",
+                    "width",
+                    "2025-12-31",
+                    "For `use_container_width=True`, use `width='stretch'`. "
+                    "For `use_container_width=False`, use `width='content'`.",
+                    include_st_prefix=False,
+                ),
+                show_in_browser=False,
+            )
+            if use_container_width is True:
+                width = "stretch"
+            elif isinstance(width, int):
+                # Preserve the existing behavior with respect to use_container_width=False
+                # and width=int.
+                pass
+            else:
+                width = "content"
+
+        validate_width(width, allow_content=True)
+        layout_config = LayoutConfig(width=width)
 
         image_list_proto = ImageListProto()
         marshall_images(
             self.dg._get_delta_path_str(),
             image,
             caption,
-            image_width,
+            layout_config,
             image_list_proto,
             clamp,
             channels,
             output_format,
         )
-        return self.dg._enqueue("imgs", image_list_proto)
+        return self.dg._enqueue("imgs", image_list_proto, layout_config=layout_config)
 
     @property
     def dg(self) -> DeltaGenerator:

streamlit/elements/layouts.py

@@ -323,7 +323,7 @@ class LayoutsMixin:
             # in the future. This might require including more container
             # parameters in the ID calculation.
             block_proto.id = compute_and_register_element_id(
-                "container", user_key=key, form_id=None
+                "container", user_key=key, dg=None
             )
 
         return self.dg._block(block_proto)
@@ -1112,7 +1112,7 @@ class LayoutsMixin:
         title: str,
         *,
         dismissible: bool = True,
-        width: Literal["small", "large"] = "small",
+        width: Literal["small", "large", "medium"] = "small",
         on_dismiss: Literal["ignore", "rerun"] | WidgetCallback = "ignore",
     ) -> Dialog:
         """Inserts the dialog container.

streamlit/elements/lib/built_in_chart_utils.py

@@ -118,11 +118,8 @@ _MELTED_Y_COLUMN_TITLE: Final = "value"
 _MELTED_COLOR_COLUMN_TITLE: Final = "color"
 
 # Crazy internal (non-user-visible) names for the index and melted columns, in order to
-# avoid collision with existing column names. The suffix below was generated with an
-# online random number generator. Rationale: because it makes it even less likely to
-# lead to a conflict than something that's human-readable (like "--streamlit-fake-field"
-# or something).
-_PROTECTION_SUFFIX: Final = "--p5bJXXpQgvPz6yvQMFiy"
+# avoid collision with existing column names.
+_PROTECTION_SUFFIX: Final = " -- streamlit-generated"
 _SEPARATED_INDEX_COLUMN_NAME: Final = _SEPARATED_INDEX_COLUMN_TITLE + _PROTECTION_SUFFIX
 _MELTED_Y_COLUMN_NAME: Final = _MELTED_Y_COLUMN_TITLE + _PROTECTION_SUFFIX
 _MELTED_COLOR_COLUMN_NAME: Final = _MELTED_COLOR_COLUMN_TITLE + _PROTECTION_SUFFIX