streamlit 1.49.1__py3-none-any.whl → 1.51.0__py3-none-any.whl

streamlit/elements/widgets/multiselect.py

@@ -19,7 +19,6 @@ from textwrap import dedent
 from typing import (
     TYPE_CHECKING,
     Any,
-    Callable,
     Generic,
     Literal,
     TypeVar,
@@ -64,7 +63,7 @@ from streamlit.type_util import (
 )
 
 if TYPE_CHECKING:
-    from collections.abc import Sequence
+    from collections.abc import Callable, Sequence
 
     from streamlit.dataframe_util import OptionSequence
     from streamlit.delta_generator import DeltaGenerator
@@ -370,7 +369,9 @@ class MultiSelectMixin:
         Returns
         -------
         list
-            A list with the selected options
+            A list of the selected options.
+
+            The list contains copies of the selected options, not the originals.
 
         Examples
         --------
@@ -492,6 +493,16 @@ class MultiSelectMixin:
         element_id = compute_and_register_element_id(
             widget_name,
             user_key=key,
+            # Treat the provided key as the main identity. Only include
+            # changes to the options, accept_new_options, and max_selections
+            # in the identity computation as those can invalidate the
+            # current selection.
+            key_as_main_identity={
+                "options",
+                "max_selections",
+                "accept_new_options",
+                "format_func",
+            },
             dg=self.dg,
             label=label,
             options=formatted_options,

streamlit/elements/widgets/number_input.py

@@ -17,9 +17,7 @@ from __future__ import annotations
 import numbers
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import TYPE_CHECKING, Literal, TypeVar, Union, cast, overload
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Literal, TypeAlias, TypeVar, cast, overload
 
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.js_number import JSNumber, JSNumberBoundsException
@@ -62,7 +60,7 @@ if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator
 
 
-Number: TypeAlias = Union[int, float]
+Number: TypeAlias = int | float
 IntOrNone = TypeVar("IntOrNone", int, None)
 FloatOrNone = TypeVar("FloatOrNone", float, None)
 
@@ -452,6 +450,9 @@ class NumberInputMixin:
         element_id = compute_and_register_element_id(
             "number_input",
             user_key=key,
+            # Ensure stable ID when key is provided; explicitly whitelist parameters
+            # that might invalidate the current widget state.
+            key_as_main_identity={"min_value", "max_value", "step"},
             dg=self.dg,
             label=label,
             min_value=min_value,

streamlit/elements/widgets/radio.py

@@ -16,7 +16,7 @@ from __future__ import annotations
 
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import TYPE_CHECKING, Any, Callable, Generic, TypeVar, cast, overload
+from typing import TYPE_CHECKING, Any, Generic, TypeVar, cast, overload
 
 from typing_extensions import Never
 
@@ -56,7 +56,7 @@ from streamlit.type_util import (
 )
 
 if TYPE_CHECKING:
-    from collections.abc import Sequence
+    from collections.abc import Callable, Sequence
 
     from streamlit.delta_generator import DeltaGenerator
 
@@ -272,6 +272,8 @@ class RadioMixin:
         any
             The selected option or ``None`` if no option is selected.
 
+            This is a copy of the selected option, not the original.
+
         Example
         -------
         >>> import streamlit as st
@@ -369,6 +371,12 @@ class RadioMixin:
         element_id = compute_and_register_element_id(
             "radio",
             user_key=key,
+            # Treat provided key as the main widget identity. Only include the
+            # following parameters in the identity computation since they can
+            # invalidate the current selection mapping.
+            # Changes to format_func also invalidate the current selection,
+            # but this is already handled via the `options` parameter below:
+            key_as_main_identity={"options"},
             dg=self.dg,
             label=label,
             options=[str(format_func(option)) for option in opt],

streamlit/elements/widgets/select_slider.py

@@ -19,15 +19,13 @@ from textwrap import dedent
 from typing import (
     TYPE_CHECKING,
     Any,
-    Callable,
     Generic,
+    TypeGuard,
     TypeVar,
     cast,
     overload,
 )
 
-from typing_extensions import TypeGuard
-
 from streamlit.dataframe_util import OptionSequence, convert_anything_to_list
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.layout_utils import LayoutConfig, validate_width
@@ -61,7 +59,7 @@ from streamlit.runtime.state import (
 from streamlit.type_util import check_python_comparable
 
 if TYPE_CHECKING:
-    from collections.abc import Sequence
+    from collections.abc import Callable, Sequence
 
     from streamlit.delta_generator import DeltaGenerator
     from streamlit.elements.lib.layout_utils import WidthWithoutContent
@@ -264,6 +262,8 @@ class SelectSliderMixin:
             The current value of the slider widget. The return type will match
             the data type of the value parameter.
 
+            This contains copies of the selected options, not the originals.
+
         Examples
         --------
         >>> import streamlit as st
@@ -377,6 +377,10 @@ class SelectSliderMixin:
         element_id = compute_and_register_element_id(
             "select_slider",
             user_key=key,
+            # Treat the provided key as the main identity; only include
+            # changes to the options (and implicitly their formatting) in the
+            # identity computation as those can invalidate the current value.
+            key_as_main_identity={"options", "format_func"},
             dg=self.dg,
             label=label,
             options=[str(format_func(option)) for option in opt],

streamlit/elements/widgets/selectbox.py

@@ -17,7 +17,6 @@ from textwrap import dedent
 from typing import (
     TYPE_CHECKING,
     Any,
-    Callable,
     Generic,
     Literal,
     TypeVar,
@@ -67,7 +66,7 @@ from streamlit.type_util import (
 )
 
 if TYPE_CHECKING:
-    from collections.abc import Sequence
+    from collections.abc import Callable, Sequence
 
     from streamlit.delta_generator import DeltaGenerator
 
@@ -404,6 +403,8 @@ class SelectboxMixin:
         any
             The selected option or ``None`` if no option is selected.
 
+            This is a copy of the selected option, not the original.
+
         Examples
         --------
         **Example 1: Use a basic selectbox widget**
@@ -541,6 +542,12 @@ class SelectboxMixin:
         element_id = compute_and_register_element_id(
             "selectbox",
             user_key=key,
+            # Treat the provided key as the main identity. Only include
+            # the options and accept_new_options in the identity computation
+            # as those can invalidate the current selection.
+            # Changes to format_func also invalidate the current selection,
+            # but this is already handled via the `options` parameter below:
+            key_as_main_identity={"options", "accept_new_options"},
             dg=self.dg,
             label=label,
             options=formatted_options,

streamlit/elements/widgets/slider.py

@@ -23,15 +23,13 @@ from typing import (
     TYPE_CHECKING,
     Any,
     Final,
+    TypeAlias,
     TypedDict,
     TypeVar,
-    Union,
     cast,
     overload,
 )
 
-from typing_extensions import TypeAlias
-
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.js_number import JSNumber, JSNumberBoundsException
 from streamlit.elements.lib.layout_utils import LayoutConfig, validate_width
@@ -69,48 +67,43 @@ if TYPE_CHECKING:
 SliderNumericT = TypeVar("SliderNumericT", int, float)
 SliderDatelikeT = TypeVar("SliderDatelikeT", date, time, datetime)
 
-SliderNumericSpanT: TypeAlias = Union[
-    list[SliderNumericT],
-    tuple[()],
-    tuple[SliderNumericT],
-    tuple[SliderNumericT, SliderNumericT],
-]
-SliderDatelikeSpanT: TypeAlias = Union[
-    list[SliderDatelikeT],
-    tuple[()],
-    tuple[SliderDatelikeT],
-    tuple[SliderDatelikeT, SliderDatelikeT],
-]
+SliderNumericSpanT: TypeAlias = (
+    list[SliderNumericT]
+    | tuple[()]
+    | tuple[SliderNumericT]
+    | tuple[SliderNumericT, SliderNumericT]
+)
+SliderDatelikeSpanT: TypeAlias = (
+    list[SliderDatelikeT]
+    | tuple[()]
+    | tuple[SliderDatelikeT]
+    | tuple[SliderDatelikeT, SliderDatelikeT]
+)
 
 StepNumericT: TypeAlias = SliderNumericT
 StepDatelikeT: TypeAlias = timedelta
 
-SliderStep: TypeAlias = Union[int, float, timedelta]
-SliderScalar: TypeAlias = Union[int, float, date, time, datetime]
+SliderStep: TypeAlias = int | float | timedelta
+SliderScalar: TypeAlias = int | float | date | time | datetime
 SliderValueT = TypeVar("SliderValueT", int, float, date, time, datetime)
-SliderValueGeneric: TypeAlias = Union[
-    SliderValueT,
-    Sequence[SliderValueT],
-]
-SliderValue: TypeAlias = Union[
-    SliderValueGeneric[int],
-    SliderValueGeneric[float],
-    SliderValueGeneric[date],
-    SliderValueGeneric[time],
-    SliderValueGeneric[datetime],
-]
-SliderReturnGeneric: TypeAlias = Union[
-    SliderValueT,
-    tuple[SliderValueT],
-    tuple[SliderValueT, SliderValueT],
-]
-SliderReturn: TypeAlias = Union[
-    SliderReturnGeneric[int],
-    SliderReturnGeneric[float],
-    SliderReturnGeneric[date],
-    SliderReturnGeneric[time],
-    SliderReturnGeneric[datetime],
-]
+SliderValueGeneric: TypeAlias = SliderValueT | Sequence[SliderValueT]
+SliderValue: TypeAlias = (
+    SliderValueGeneric[int]
+    | SliderValueGeneric[float]  # ty: ignore
+    | SliderValueGeneric[date]
+    | SliderValueGeneric[time]
+    | SliderValueGeneric[datetime]
+)
+SliderReturnGeneric: TypeAlias = (
+    SliderValueT | tuple[SliderValueT] | tuple[SliderValueT, SliderValueT]
+)
+SliderReturn: TypeAlias = (
+    SliderReturnGeneric[int]
+    | SliderReturnGeneric[float]  # ty: ignore
+    | SliderReturnGeneric[date]
+    | SliderReturnGeneric[time]
+    | SliderReturnGeneric[datetime]
+)
 
 SECONDS_TO_MICROS: Final = 1000 * 1000
 DAYS_TO_MICROS: Final = 24 * 60 * 60 * SECONDS_TO_MICROS
@@ -680,6 +673,10 @@ class SliderMixin:
         element_id = compute_and_register_element_id(
             "slider",
             user_key=key,
+            # Treat the provided key as the main identity; only include
+            # changes to the value-shaping arguments in the identity
+            # computation as those can invalidate the current value.
+            key_as_main_identity={"min_value", "max_value", "step"},
             dg=self.dg,
             label=label,
             min_value=min_value,
@@ -801,7 +798,7 @@ class SliderMixin:
             if data_type in (
                 SliderProto.DATETIME,
                 SliderProto.DATE,
-            ) and max_value - min_value < timedelta(days=1):
+            ) and max_value - min_value < timedelta(days=1):  # ty: ignore[unsupported-operator]
                 step = timedelta(minutes=15)
         if format is None:
             format = cast("str", defaults[data_type]["format"])  # noqa: A001

streamlit/elements/widgets/text_widgets.py

@@ -328,6 +328,9 @@ class TextWidgetsMixin:
         element_id = compute_and_register_element_id(
             "text_input",
             user_key=key,
+            # Explicitly whitelist max_chars to make sure the ID changes when it changes
+            # since the widget value might become invalid based on a different max_chars
+            key_as_main_identity={"max_chars"},
             dg=self.dg,
             label=label,
             value=value,
@@ -642,6 +645,9 @@ class TextWidgetsMixin:
         element_id = compute_and_register_element_id(
             "text_area",
             user_key=key,
+            # Explicitly whitelist max_chars to make sure the ID changes when it changes
+            # since the widget value might become invalid based on a different max_chars
+            key_as_main_identity={"max_chars"},
             dg=self.dg,
             label=label,
             value=value,

streamlit/elements/widgets/time_widgets.py

@@ -23,13 +23,11 @@ from typing import (
     Any,
     Final,
     Literal,
-    Union,
+    TypeAlias,
     cast,
     overload,
 )
 
-from typing_extensions import TypeAlias
-
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.layout_utils import (
     LayoutConfig,
@@ -65,21 +63,17 @@ if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator
 
 # Type for things that point to a specific time (even if a default time, though not None).
-TimeValue: TypeAlias = Union[time, datetime, str, Literal["now"]]
+TimeValue: TypeAlias = time | datetime | str | Literal["now"]
 
 # Type for things that point to a specific date (even if a default date, including None).
-NullableScalarDateValue: TypeAlias = Union[date, datetime, str, Literal["today"], None]
+NullableScalarDateValue: TypeAlias = date | datetime | str | Literal["today"] | None
 
 # The accepted input value for st.date_input. Can be a date scalar or a date range.
-DateValue: TypeAlias = Union[NullableScalarDateValue, Sequence[NullableScalarDateValue]]
+DateValue: TypeAlias = NullableScalarDateValue | Sequence[NullableScalarDateValue]
 
 # The return value of st.date_input.
-DateWidgetRangeReturn: TypeAlias = Union[
-    tuple[()],
-    tuple[date],
-    tuple[date, date],
-]
-DateWidgetReturn: TypeAlias = Union[date, DateWidgetRangeReturn, None]
+DateWidgetRangeReturn: TypeAlias = tuple[()] | tuple[date] | tuple[date, date]
+DateWidgetReturn: TypeAlias = date | DateWidgetRangeReturn | None
 
 
 DEFAULT_STEP_MINUTES: Final = 15
@@ -529,6 +523,9 @@ class TimeWidgetsMixin:
         element_id = compute_and_register_element_id(
             "time_input",
             user_key=key,
+            # Ensure stable ID when key is provided; only whitelist step since it
+            # affects the selection granularity and available options.
+            key_as_main_identity={"step"},
             dg=self.dg,
             label=label,
             value=parsed_time if isinstance(value, (datetime, time)) else value,
@@ -911,6 +908,12 @@ class TimeWidgetsMixin:
         element_id = compute_and_register_element_id(
             "date_input",
             user_key=key,
+            # Ensure stable ID when key is provided; explicitly whitelist parameters
+            # that might invalidate the current widget state.
+            # format should be supported. However, there is a bug in baseweb where
+            # changing the format dynamically leads to a wrongly formatted date.
+            # So, we whitelist it for now until we migrate this away from baseweb.
+            key_as_main_identity={"min_value", "max_value", "format"},
             dg=self.dg,
             label=label,
             value=parsed,

streamlit/elements/write.py

@@ -20,6 +20,7 @@ import types
 from collections import ChainMap, UserDict, UserList
 from collections.abc import (
     AsyncGenerator,
+    Callable,
     Generator,
     ItemsView,
     Iterable,
@@ -30,14 +31,12 @@ from io import StringIO
 from typing import (
     TYPE_CHECKING,
     Any,
-    Callable,
     Final,
     cast,
 )
 
 from streamlit import dataframe_util, type_util
 from streamlit.errors import StreamlitAPIException
-from streamlit.logger import get_logger
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import (
     is_mem_address_str,
@@ -56,10 +55,6 @@ HELP_TYPES: Final[tuple[type[Any], ...]] = (
     types.ModuleType,
 )
 
-_LOGGER: Final = get_logger(__name__)
-
-_TEXT_CURSOR: Final = " ▏"
-
 
 class StreamingOutput(list[Any]):
     pass
@@ -73,8 +68,10 @@ class WriteMixin:
         | Generator[Any, Any, Any]
         | Iterable[Any]
         | AsyncGenerator[Any, Any],
+        *,
+        cursor: str | None = None,
     ) -> list[Any] | str:
-        """Stream a generator, iterable, or stream-like sequence to the app.
+        r"""Stream a generator, iterable, or stream-like sequence to the app.
 
         ``st.write_stream`` iterates through the given sequences and writes all
         chunks to the app. String chunks will be written using a typewriter effect.
@@ -94,6 +91,27 @@ class WriteMixin:
                 manually define a generator function and include custom output
                 parsing.
 
+        cursor : str or None
+            A string to append to text as it's being written. If this is
+            ``None`` (default), no cursor is shown. Otherwise, the string is
+            rendered as Markdown and appears as a cursor at the end of the
+            streamed text. For example, you can use an emoji, emoji shortcode,
+            or Material icon.
+
+            The first line of the cursor string can contain GitHub-flavored
+            Markdown of the following types: Bold, Italics, Strikethroughs,
+            Inline Code, Links, and Images. Images display like icons, with a
+            max height equal to the font height. If you pass a multiline
+            string, additional lines display after the text with the full
+            Markdown rendering capabilities of ``st.markdown``.
+
+            See the ``body`` parameter of |st.markdown|_ for additional,
+            supported Markdown directives.
+
+            .. |st.markdown| replace:: ``st.markdown``
+            .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
+
+
         Returns
         -------
         str or list
@@ -153,6 +171,7 @@ class WriteMixin:
                 "this data type."
             )
 
+        cursor_str = cursor or ""
         stream_container: DeltaGenerator | None = None
         streamed_response: str = ""
         written_content: list[Any] = StreamingOutput()
@@ -231,7 +250,7 @@ class WriteMixin:
                 streamed_response += chunk
                 # Only add the streaming symbol on the second text chunk
                 stream_container.markdown(
-                    streamed_response + ("" if first_text else _TEXT_CURSOR),
+                    streamed_response + ("" if first_text else cursor_str),
                 )
             elif callable(chunk):
                 flush_stream_response()
@@ -254,7 +273,7 @@ class WriteMixin:
         return written_content
 
     @gather_metrics("write")
-    def write(self, *args: Any, unsafe_allow_html: bool = False, **kwargs: Any) -> None:
+    def write(self, *args: Any, unsafe_allow_html: bool = False) -> None:
         """Displays arguments in the app.
 
         This is the Swiss Army knife of Streamlit commands: it does different
@@ -323,13 +342,6 @@ class WriteMixin:
                 If you only want to insert HTML or CSS without Markdown text,
                 we recommend using ``st.html`` instead.
 
-        **kwargs : any
-            Keyword arguments. Not used.
-
-        .. deprecated::
-            ``**kwargs`` is deprecated and will be removed in a later version.
-            Use other, more specific Streamlit commands to pass additional
-            keyword arguments.
 
         Returns
         -------
@@ -400,13 +412,6 @@ class WriteMixin:
             height: 300px
 
         """
-        if kwargs:
-            _LOGGER.warning(
-                'Invalid arguments were passed to "st.write" function. Support for '
-                "passing such unknown keywords arguments will be dropped in future. "
-                "Invalid arguments were: %s",
-                kwargs,
-            )
 
         if len(args) == 1 and isinstance(args[0], str):
             # Optimization: If there is only one arg, and it's a string,