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

streamlit/elements/lib/built_in_chart_utils.py

@@ -19,9 +19,7 @@ from __future__ import annotations
 from dataclasses import dataclass
 from datetime import date
 from enum import Enum
-from typing import TYPE_CHECKING, Any, Final, Literal, TypedDict, cast
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Any, Final, Literal, TypeAlias, TypedDict, cast
 
 from streamlit import dataframe_util, type_util
 from streamlit.elements.lib.color_util import (

streamlit/elements/lib/color_util.py

@@ -14,10 +14,8 @@
 
 from __future__ import annotations
 
-from collections.abc import Collection
-from typing import Any, Callable, Union, cast
-
-from typing_extensions import TypeAlias
+from collections.abc import Callable, Collection
+from typing import Any, TypeAlias, cast
 
 from streamlit.errors import StreamlitInvalidColorError
 
@@ -35,26 +33,18 @@ IntRGBAColorTuple: TypeAlias = tuple[int, int, int, int]
 # CSS uses these.
 MixedRGBAColorTuple: TypeAlias = tuple[int, int, int, float]
 
-Color4Tuple: TypeAlias = Union[
-    FloatRGBAColorTuple,
-    IntRGBAColorTuple,
-    MixedRGBAColorTuple,
-]
+Color4Tuple: TypeAlias = FloatRGBAColorTuple | IntRGBAColorTuple | MixedRGBAColorTuple
 
-Color3Tuple: TypeAlias = Union[
-    FloatRGBColorTuple,
-    IntRGBColorTuple,
-]
+Color3Tuple: TypeAlias = FloatRGBColorTuple | IntRGBColorTuple
 
-ColorTuple: TypeAlias = Union[Color4Tuple, Color3Tuple]
+ColorTuple: TypeAlias = Color4Tuple | Color3Tuple
 
-IntColorTuple = Union[IntRGBColorTuple, IntRGBAColorTuple]
-CSSColorStr = Union[IntRGBAColorTuple, MixedRGBAColorTuple]
+IntColorTuple: TypeAlias = IntRGBColorTuple | IntRGBAColorTuple
 
 ColorStr: TypeAlias = str
 
-Color: TypeAlias = Union[ColorTuple, ColorStr]
-MaybeColor: TypeAlias = Union[str, Collection[Any]]
+Color: TypeAlias = ColorTuple | ColorStr
+MaybeColor: TypeAlias = str | Collection[Any]
 
 
 def to_int_color_tuple(color: MaybeColor) -> IntColorTuple:

streamlit/elements/lib/column_config_utils.py

@@ -18,9 +18,7 @@ import copy
 import json
 from collections.abc import Mapping
 from enum import Enum
-from typing import TYPE_CHECKING, Final, Literal, Union
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Final, Literal, TypeAlias
 
 from streamlit.dataframe_util import DataFormat
 from streamlit.elements.lib.column_types import ColumnConfig, ColumnType
@@ -405,16 +403,14 @@ def determine_dataframe_schema(
 
 
 # A mapping of column names/IDs to column configs.
-ColumnConfigMapping: TypeAlias = dict[
-    Union[IndexIdentifierType, str, int], ColumnConfig
-]
+ColumnConfigMapping: TypeAlias = dict[IndexIdentifierType | str | int, ColumnConfig]
 ColumnConfigMappingInput: TypeAlias = Mapping[
     # TODO(lukasmasuch): This should also use int here to
     # correctly type the support for positional index. However,
     # allowing int here leads mypy to complain about simple dict[str, ...]
     # as input -> which seems like a mypy bug.
-    Union[IndexIdentifierType, str],
-    Union[ColumnConfig, None, str],
+    IndexIdentifierType | str,
+    ColumnConfig | None | str,
 ]
 
 

streamlit/elements/lib/column_types.py

@@ -19,9 +19,9 @@ from __future__ import annotations
 
 import datetime
 import itertools
-from typing import TYPE_CHECKING, Callable, Literal, TypedDict, Union
+from typing import TYPE_CHECKING, Literal, TypeAlias, TypedDict
 
-from typing_extensions import NotRequired, TypeAlias
+from typing_extensions import NotRequired
 
 from streamlit.elements.lib.color_util import is_css_color_like
 from streamlit.errors import StreamlitValueError
@@ -29,7 +29,7 @@ from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import validate_material_icon
 
 if TYPE_CHECKING:
-    from collections.abc import Iterable, Iterator
+    from collections.abc import Callable, Iterable, Iterator
 
 NumberFormat: TypeAlias = Literal[
     "plain",
@@ -45,7 +45,7 @@ NumberFormat: TypeAlias = Literal[
     "bytes",
 ]
 
-ColumnWidth: TypeAlias = Union[Literal["small", "medium", "large"], int]
+ColumnWidth: TypeAlias = Literal["small", "medium", "large"] | int
 
 # Type alias that represents all available column types
 # which are configurable by the user.
@@ -83,11 +83,7 @@ ThemeColor: TypeAlias = Literal[
 ]
 
 # Color options for chart columns:
-ChartColor: TypeAlias = Union[
-    Literal["auto", "auto-inverse"],
-    ThemeColor,
-    str,
-]
+ChartColor: TypeAlias = Literal["auto", "auto-inverse"] | ThemeColor | str
 
 
 def _validate_chart_color(maybe_color: str) -> None:
@@ -135,7 +131,7 @@ class CheckboxColumnConfig(TypedDict):
     type: Literal["checkbox"]
 
 
-SelectboxOptionValue: TypeAlias = Union[str, int, float, bool]
+SelectboxOptionValue: TypeAlias = str | int | float | bool
 
 
 class SelectboxOption(TypedDict):
@@ -187,7 +183,7 @@ class ListColumnConfig(TypedDict):
 class MultiselectOption(TypedDict):
     value: str
     label: NotRequired[str | None]
-    color: NotRequired[str | ThemeColor | None]
+    color: NotRequired[str | Literal["auto"] | ThemeColor | None]
 
 
 class MultiselectColumnConfig(TypedDict):
@@ -229,6 +225,7 @@ class ProgressColumnConfig(TypedDict):
     min_value: NotRequired[int | float | None]
     max_value: NotRequired[int | float | None]
     step: NotRequired[int | float | None]
+    color: NotRequired[ChartColor | None]
 
 
 class JsonColumnConfig(TypedDict):
@@ -1732,10 +1729,15 @@ def MultiselectColumn(
     help: str | None = None,
     disabled: bool | None = None,
     required: bool | None = None,
+    pinned: bool | None = None,
     default: Iterable[str] | None = None,
     options: Iterable[str] | None = None,
     accept_new_options: bool | None = None,
-    color: str | ThemeColor | Iterable[str | ThemeColor] | None = None,
+    color: str
+    | Literal["auto"]
+    | ThemeColor
+    | Iterable[str | ThemeColor]
+    | None = None,
     format_func: Callable[[str], str] | None = None,
 ) -> ColumnConfig:
     """Configure a multiselect column in ``st.dataframe`` or ``st.data_editor``.
@@ -1788,6 +1790,12 @@ def MultiselectColumn(
         Whether edited cells in the column need to have a value. If True, an edited cell
         can only be submitted if it has a value other than None. Defaults to False.
 
+    pinned : bool or None
+        Whether the column is pinned. A pinned column will stay visible on the
+        left side no matter where the user scrolls. If this is ``None``
+        (default), Streamlit will decide: index columns are pinned, and data
+        columns are not pinned.
+
     default : Iterable of str or None
         Specifies the default value in this column when a new row is added by the user.
 
@@ -1808,6 +1816,7 @@ def MultiselectColumn(
         The color to use for different options. This can be:
 
         - None (default): The options are displayed without color.
+        - ``"auto"``: The options are colored based on the configured categorical chart colors.
         - A single color value that is used for all options. This can be one of
           the following strings:
 
@@ -1943,6 +1952,7 @@ def MultiselectColumn(
         help=help,
         disabled=disabled,
         required=required,
+        pinned=pinned,
         default=None if default is None else list(default),
         type_config=MultiselectColumnConfig(
             type="multiselect",
@@ -2446,6 +2456,7 @@ def ProgressColumn(
     min_value: int | float | None = None,
     max_value: int | float | None = None,
     step: int | float | None = None,
+    color: ChartColor | None = None,
 ) -> ColumnConfig:
     """Configure a progress column in ``st.dataframe`` or ``st.data_editor``.
 
@@ -2528,6 +2539,19 @@ def ProgressColumn(
         Setting ``step`` for float columns will ensure a consistent number of
         digits after the decimal are displayed.
 
+    color : "auto", "auto-inverse", str, or None
+        The color to use for the chart. This can be one of the following:
+
+        - ``None`` (default): The primary color is used.
+        - ``"auto"``: If the value is more than half, the bar is green; if the
+          value is less than half, the bar is red.
+        - ``"auto-inverse"``: If the value is more than half, the bar is red;
+          if the value is less than half, the bar is green.
+        - A single color value that is applied to all charts in the column.
+          In addition to the basic color palette (red, orange, yellow, green,
+          blue, violet, gray/grey, and primary), this supports hex codes like
+          ``"#483d8b"``.
+
     Examples
     --------
     >>> import pandas as pd
@@ -2558,6 +2582,9 @@ def ProgressColumn(
         height: 300px
     """  # noqa: E501
 
+    if color is not None:
+        _validate_chart_color(color)
+
     return ColumnConfig(
         label=label,
         width=width,
@@ -2569,6 +2596,7 @@ def ProgressColumn(
             min_value=min_value,
             max_value=max_value,
             step=step,
+            color=color,
         ),
     )
 

streamlit/elements/lib/dialog.py

@@ -14,9 +14,9 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Literal, cast
+from typing import TYPE_CHECKING, Literal, TypeAlias, cast
 
-from typing_extensions import Self, TypeAlias
+from typing_extensions import Self
 
 from streamlit.delta_generator import DeltaGenerator
 from streamlit.elements.lib.utils import compute_and_register_element_id

streamlit/elements/lib/image_utils.py

@@ -20,9 +20,7 @@ import re
 from collections.abc import Sequence
 from enum import IntEnum
 from pathlib import Path
-from typing import TYPE_CHECKING, Final, Literal, Union, cast
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Final, Literal, TypeAlias, Union, cast
 
 from streamlit import runtime, url_util
 from streamlit.errors import StreamlitAPIException
@@ -48,7 +46,7 @@ AtomicImage: TypeAlias = Union[
 Channels: TypeAlias = Literal["RGB", "BGR"]
 ImageFormat: TypeAlias = Literal["JPEG", "PNG", "GIF"]
 ImageFormatOrAuto: TypeAlias = Literal[ImageFormat, "auto"]
-ImageOrImageList: TypeAlias = Union[AtomicImage, Sequence[AtomicImage]]
+ImageOrImageList: TypeAlias = AtomicImage | Sequence[AtomicImage]
 
 # This constant is related to the frontend maximum content width specified
 # in App.jsx main container
@@ -434,7 +432,7 @@ def marshall_images(
 
     # Each image in an image list needs to be kept track of at its own coordinates.
     for coord_suffix, (single_image, single_caption) in enumerate(
-        zip(images, captions)
+        zip(images, captions, strict=False)
     ):
         proto_img = proto_imgs.imgs.add()
         if single_caption is not None:

streamlit/elements/lib/layout_utils.py

@@ -14,14 +14,13 @@
 from __future__ import annotations
 
 from dataclasses import dataclass
-from typing import Literal, Union, cast
-
-from typing_extensions import TypeAlias
+from typing import Literal, TypeAlias, cast
 
 from streamlit.errors import (
     StreamlitInvalidColumnGapError,
     StreamlitInvalidHeightError,
     StreamlitInvalidHorizontalAlignmentError,
+    StreamlitInvalidSizeError,
     StreamlitInvalidVerticalAlignmentError,
     StreamlitInvalidWidthError,
 )
@@ -30,19 +29,29 @@ from streamlit.proto.GapSize_pb2 import GapSize
 from streamlit.proto.HeightConfig_pb2 import HeightConfig
 from streamlit.proto.WidthConfig_pb2 import WidthConfig
 
-WidthWithoutContent: TypeAlias = Union[int, Literal["stretch"]]
-Width: TypeAlias = Union[int, Literal["stretch", "content"]]
-HeightWithoutContent: TypeAlias = Union[int, Literal["stretch"]]
-Height: TypeAlias = Union[int, Literal["stretch", "content"]]
+WidthWithoutContent: TypeAlias = int | Literal["stretch"]
+Width: TypeAlias = int | Literal["stretch", "content"]
+HeightWithoutContent: TypeAlias = int | Literal["stretch"]
+Height: TypeAlias = int | Literal["stretch", "content"]
+SpaceSize: TypeAlias = int | Literal["stretch", "small", "medium", "large"]
 Gap: TypeAlias = Literal["small", "medium", "large"]
 HorizontalAlignment: TypeAlias = Literal["left", "center", "right", "distribute"]
 VerticalAlignment: TypeAlias = Literal["top", "center", "bottom", "distribute"]
 
+# Mapping of size literals to rem values for st.space
+# If changing these, also check streamlit/frontend/lib/src/theme/primitives/sizes.ts
+# to ensure sizes are kept in sync.
+SIZE_TO_REM_MAPPING = {
+    "small": 0.75,  # Height of widget label minus gap
+    "medium": 2.5,  # Height of button/input field
+    "large": 4.25,  # Height of large widget without label
+}
+
 
 @dataclass
 class LayoutConfig:
-    width: Width | None = None
-    height: Height | None = None
+    width: Width | SpaceSize | None = None
+    height: Height | SpaceSize | None = None
 
 
 def validate_width(width: Width, allow_content: bool = False) -> None:
@@ -117,9 +126,35 @@ def validate_height(
         raise StreamlitInvalidHeightError(height, allow_content)
 
 
-def get_width_config(width: Width) -> WidthConfig:
+def validate_space_size(size: SpaceSize) -> None:
+    """Validate the size parameter for st.space.
+
+    Parameters
+    ----------
+    size : Any
+        The size value to validate.
+
+    Raises
+    ------
+    StreamlitInvalidSizeError
+        If the size value is invalid.
+    """
+    if not isinstance(size, (int, str)):
+        raise StreamlitInvalidSizeError(size)
+
+    if isinstance(size, str):
+        valid_strings = ["stretch", "small", "medium", "large"]
+        if size not in valid_strings:
+            raise StreamlitInvalidSizeError(size)
+    elif isinstance(size, int) and size <= 0:
+        raise StreamlitInvalidSizeError(size)
+
+
+def get_width_config(width: Width | SpaceSize) -> WidthConfig:
     width_config = WidthConfig()
-    if isinstance(width, (int, float)):
+    if isinstance(width, str) and width in SIZE_TO_REM_MAPPING:
+        width_config.rem_width = SIZE_TO_REM_MAPPING[width]
+    elif isinstance(width, (int, float)):
         width_config.pixel_width = int(width)
     elif width == "content":
         width_config.use_content = True
@@ -128,9 +163,11 @@ def get_width_config(width: Width) -> WidthConfig:
     return width_config
 
 
-def get_height_config(height: Height) -> HeightConfig:
+def get_height_config(height: Height | SpaceSize) -> HeightConfig:
     height_config = HeightConfig()
-    if isinstance(height, (int, float)):
+    if isinstance(height, str) and height in SIZE_TO_REM_MAPPING:
+        height_config.rem_height = SIZE_TO_REM_MAPPING[height]
+    elif isinstance(height, (int, float)):
         height_config.pixel_height = int(height)
     elif height == "content":
         height_config.use_content = True

streamlit/elements/lib/mutable_status_container.py

@@ -15,9 +15,9 @@
 from __future__ import annotations
 
 import time
-from typing import TYPE_CHECKING, Literal, cast
+from typing import TYPE_CHECKING, Literal, TypeAlias, cast
 
-from typing_extensions import Self, TypeAlias
+from typing_extensions import Self
 
 from streamlit.delta_generator import DeltaGenerator
 from streamlit.elements.lib.layout_utils import (

streamlit/elements/lib/options_selector_utils.py

@@ -15,7 +15,7 @@
 from __future__ import annotations
 
 from enum import Enum, EnumMeta
-from typing import TYPE_CHECKING, Any, Callable, Final, TypeVar, overload
+from typing import TYPE_CHECKING, Any, Final, TypeVar, overload
 
 from streamlit import config, logger
 from streamlit.dataframe_util import OptionSequence, convert_anything_to_list
@@ -26,7 +26,7 @@ from streamlit.type_util import (
 )
 
 if TYPE_CHECKING:
-    from collections.abc import Iterable, Sequence
+    from collections.abc import Callable, Iterable, Sequence
 
 _LOGGER: Final = logger.get_logger(__name__)
 

streamlit/elements/lib/utils.py

@@ -20,12 +20,12 @@ from typing import (
     TYPE_CHECKING,
     Any,
     Literal,
+    TypeAlias,
     Union,
     overload,
 )
 
 from google.protobuf.message import Message
-from typing_extensions import TypeAlias
 
 from streamlit import config
 from streamlit.elements.lib.form_utils import current_form_id
@@ -49,12 +49,12 @@ if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator
 
 
-Key: TypeAlias = Union[str, int]
+Key: TypeAlias = str | int
 
 LabelVisibility: TypeAlias = Literal["visible", "hidden", "collapsed"]
 
-PROTO_SCALAR_VALUE = Union[float, int, bool, str, bytes]
-SAFE_VALUES = Union[
+PROTO_SCALAR_VALUE: TypeAlias = float | int | bool | str | bytes
+SAFE_VALUES: TypeAlias = Union[
     date,
     time,
     datetime,

streamlit/elements/map.py

@@ -21,6 +21,10 @@ import json
 from typing import TYPE_CHECKING, Any, Final, cast
 
 from streamlit import config, dataframe_util
+from streamlit.deprecation_util import (
+    make_deprecated_name_warning,
+    show_deprecation_warning,
+)
 from streamlit.elements import deck_gl_json_chart
 from streamlit.elements.lib.color_util import (
     Color,
@@ -28,6 +32,13 @@ from streamlit.elements.lib.color_util import (
     is_color_like,
     to_int_color_tuple,
 )
+from streamlit.elements.lib.layout_utils import (
+    HeightWithoutContent,
+    LayoutConfig,
+    WidthWithoutContent,
+    validate_height,
+    validate_width,
+)
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.DeckGlJsonChart_pb2 import DeckGlJsonChart as DeckGlJsonChartProto
 from streamlit.runtime.metrics_util import gather_metrics
@@ -85,9 +96,9 @@ class MapMixin:
         color: None | str | Color = None,
         size: None | str | float = None,
         zoom: int | None = None,
-        use_container_width: bool = True,
-        width: int | None = None,
-        height: int | None = None,
+        width: WidthWithoutContent = "stretch",
+        height: HeightWithoutContent = 500,
+        use_container_width: bool | None = None,
     ) -> DeltaGenerator:
         """Display a map with a scatterplot overlaid onto it.
 
@@ -163,28 +174,42 @@ class MapMixin:
             Zoom level as specified in
             https://wiki.openstreetmap.org/wiki/Zoom_levels.
 
-        use_container_width : bool
+        width : "stretch" or int
+            The width of the chart element. This can be one of the following:
+
+            - ``"stretch"`` (default): 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.
+
+        height : "stretch" or int
+            The height of the chart element. This can be one of the following:
+
+            - An integer specifying the height in pixels: The element has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled. This is ``500`` by default.
+            - ``"stretch"``: The height of the element matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the element is not in a parent container, the height
+              of the element matches the height of its content.
+
+        use_container_width : bool or None
             Whether to override the map's native width with the width of
-            the parent container. If ``use_container_width`` is ``True``
-            (default), Streamlit sets the width of the map to match the width
-            of the parent container. If ``use_container_width`` is ``False``,
-            Streamlit sets the width of the chart to fit its contents according
-            to the plotting library, up to the width of the parent container.
-
-        width : int or None
-            Desired width of the chart expressed in pixels. If ``width`` is
-            ``None`` (default), Streamlit sets the width of the chart to fit
-            its contents according to the plotting library, up to the width of
-            the parent container. If ``width`` is greater than the width of the
-            parent container, Streamlit sets the chart width to match the width
-            of the parent container.
-
-            To use ``width``, you must set ``use_container_width=False``.
-
-        height : int or None
-            Desired height of the chart expressed in pixels. If ``height`` is
-            ``None`` (default), Streamlit sets the height of the chart to fit
-            its contents according to the plotting library.
+            the parent container. This can be one of the following:
+
+            - ``None`` (default): Streamlit will use the map's default behavior.
+            - ``True``: Streamlit sets the width of the map to match the
+              width of the parent container.
+            - ``False``: Streamlit sets the width of the map to fit its
+              contents according to the plotting library, up to 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"``.
 
         Examples
         --------
@@ -231,12 +256,35 @@ class MapMixin:
            height: 600px
 
         """
+        # Handle use_container_width deprecation (for elements that already had width parameter)
+        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`, specify an integer width.",
+                    include_st_prefix=False,
+                ),
+                show_in_browser=False,
+            )
+            if use_container_width:
+                width = "stretch"
+            # For use_container_width=False, preserve any integer width that was set.
+
+        validate_width(width, allow_content=False)
+        validate_height(height, allow_content=False)
+
         map_proto = DeckGlJsonChartProto()
         deck_gl_json = to_deckgl_json(data, latitude, longitude, size, color, zoom)
-        marshall(
-            map_proto, deck_gl_json, use_container_width, width=width, height=height
+
+        marshall(map_proto, deck_gl_json)
+
+        layout_config = LayoutConfig(width=width, height=height)
+        return self.dg._enqueue(
+            "deck_gl_json_chart", map_proto, layout_config=layout_config
         )
-        return self.dg._enqueue("deck_gl_json_chart", map_proto)
 
     @property
     def dg(self) -> DeltaGenerator:
@@ -464,18 +512,13 @@ def _get_zoom_level(distance: float) -> int:
 def marshall(
     pydeck_proto: DeckGlJsonChartProto,
     pydeck_json: str,
-    use_container_width: bool,
-    height: int | None = None,
-    width: int | None = None,
 ) -> None:
-    pydeck_proto.json = pydeck_json
-    pydeck_proto.use_container_width = use_container_width
-
-    if width:
-        pydeck_proto.width = width
-    if height:
-        pydeck_proto.height = height
+    """Marshall a map proto with the given pydeck JSON specification.
 
+    Layout configuration (width, height, etc.) is handled by the LayoutConfig
+    system and not through proto fields.
+    """
+    pydeck_proto.json = pydeck_json
     pydeck_proto.id = ""
 
     mapbox_token = config.get_option("mapbox.token")

streamlit/elements/media.py

@@ -18,9 +18,7 @@ import io
 import re
 from datetime import timedelta
 from pathlib import Path
-from typing import TYPE_CHECKING, Final, Union, cast
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Final, TypeAlias, Union, cast
 
 from streamlit import runtime, type_util, url_util
 from streamlit.elements.lib.layout_utils import WidthWithoutContent, validate_width
@@ -53,11 +51,11 @@ MediaData: TypeAlias = Union[
     None,
 ]
 
-SubtitleData: TypeAlias = Union[
-    str, Path, bytes, io.BytesIO, dict[str, Union[str, Path, bytes, io.BytesIO]], None
-]
+SubtitleData: TypeAlias = (
+    str | Path | bytes | io.BytesIO | dict[str, str | Path | bytes | io.BytesIO] | None
+)
 
-MediaTime: TypeAlias = Union[int, float, timedelta, str]
+MediaTime: TypeAlias = int | float | timedelta | str
 
 TIMEDELTA_PARSE_ERROR_MESSAGE: Final = (
     "Failed to convert '{param_name}' to a timedelta. "

streamlit/elements/metric.py

@@ -16,9 +16,7 @@ from __future__ import annotations
 
 from dataclasses import dataclass
 from textwrap import dedent
-from typing import TYPE_CHECKING, Any, Literal, Union, cast
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Any, Literal, TypeAlias, cast
 
 from streamlit.dataframe_util import OptionSequence, convert_anything_to_list
 from streamlit.elements.lib.layout_utils import (
@@ -42,8 +40,8 @@ if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator
 
 
-Value: TypeAlias = Union[AnyNumber, str, None]
-Delta: TypeAlias = Union[AnyNumber, str, None]
+Value: TypeAlias = AnyNumber | str | None
+Delta: TypeAlias = AnyNumber | str | None
 DeltaColor: TypeAlias = Literal["normal", "inverse", "off"]