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

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
@@ -112,6 +112,7 @@ class Dialog(DeltaGenerator):
             element_id = compute_and_register_element_id(
                 "dialog",
                 user_key=None,
+                key_as_main_identity=False,
                 dg=parent,
                 title=title,
                 dismissible=dismissible,

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/pandas_styler_utils.py

@@ -14,6 +14,7 @@
 
 from __future__ import annotations
 
+from collections import defaultdict
 from collections.abc import Mapping
 from typing import TYPE_CHECKING, Any, TypeVar
 
@@ -258,21 +259,36 @@ def _use_display_values(df: DataFrame, styles: Mapping[str, Any]) -> DataFrame:
     # If values in a column are not of the same type, Arrow
     # serialization would fail. Thus, we need to cast all values
     # of the dataframe to strings before assigning them display values.
-    new_df = df.astype(str)
 
+    new_df = df.astype(str)
     cell_selector_regex = re.compile(r"row(\d+)_col(\d+)")
-    if "body" in styles:
-        rows = styles["body"]
-        for row in rows:
-            for cell in row:
-                if "id" in cell and (match := cell_selector_regex.match(cell["id"])):
-                    r, c = map(int, match.groups())
-                    # Check if the display value is an Enum type. Enum values need to be
-                    # converted to their `.value` attribute to ensure proper serialization
-                    # and display logic.
-                    if isinstance(cell["display_value"], Enum):
-                        new_df.iloc[r, c] = str(cell["display_value"].value)
-                    else:
-                        new_df.iloc[r, c] = str(cell["display_value"])
+    # Outer key = column index; inner key = row index -> target string value
+    updates_by_col: defaultdict[int, dict[int, str]] = defaultdict(dict)
+    for row in styles.get("body", []):
+        for cell in row:
+            cell_id = cell.get("id")
+            if not cell_id:
+                continue
+            match = cell_selector_regex.match(cell_id)
+            if not match:
+                continue
+            row_idx, col_idx = map(int, match.groups())
+            display_value = cell.get("display_value")
+
+            str_value = (
+                str(display_value.value)
+                # Check if the display value is an Enum type. Enum values need to be
+                # converted to their `.value` attribute to ensure proper serialization
+                # and display logic.
+                if isinstance(display_value, Enum)
+                else str(display_value)
+            )
+            updates_by_col[col_idx][row_idx] = str_value
+
+    for col_idx, values_by_row in updates_by_col.items():
+        row_indices = list(values_by_row.keys())
+        values = list(values_by_row.values())
+        # Batch-assign updates for this column using iloc for performance.
+        new_df.iloc[row_indices, col_idx] = values
 
     return new_df

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,
@@ -187,7 +187,7 @@ def compute_and_register_element_id(
     *,
     user_key: str | None,
     dg: DeltaGenerator | None,
-    key_as_main_identity: bool = False,
+    key_as_main_identity: bool | set[str],
     **kwargs: SAFE_VALUES | Iterable[SAFE_VALUES],
 ) -> str:
     """Compute and register the ID for the given element.
@@ -224,15 +224,27 @@ def compute_and_register_element_id(
         format_func, label_visibility, args, kwargs, on_change, and
         the active_script_hash are not supposed to be added here
 
-    key_as_main_identity : bool
-        If True, if a key is provided by the user, we don't include
+    key_as_main_identity : bool | set[str]
+        If True and a key is provided by the user, we don't include
         command kwargs in the element ID computation.
+        If a set of kwarg names is provided and a key is provided,
+        only the kwargs with names in this set will be included
+        in the element ID computation.
     """
     ctx = get_script_run_ctx()
 
-    ignore_command_kwargs = key_as_main_identity and user_key
+    # When a user_key is present and key_as_main_identity is True OR a set (even empty),
+    # we should ignore general command kwargs and form/sidebar context. For the set case,
+    # only explicitly whitelisted kwargs will be included below.
+    ignore_command_kwargs = user_key is not None and (
+        (key_as_main_identity is True) or isinstance(key_as_main_identity, set)
+    )
 
-    kwargs_to_use = {} if ignore_command_kwargs else {**kwargs}
+    if isinstance(key_as_main_identity, set) and user_key:
+        # Only include the explicitly whitelisted kwargs in the computation
+        kwargs_to_use = {k: v for k, v in kwargs.items() if k in key_as_main_identity}
+    else:
+        kwargs_to_use = {} if ignore_command_kwargs else {**kwargs}
 
     if ctx:
         # Add the active script hash to give elements on different

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:
@@ -399,9 +447,7 @@ def _convert_color_arg_or_column(
 
     if color_col_name is not None:
         # Convert color column to the right format.
-        if len(data[color_col_name]) > 0 and is_color_like(
-            data[color_col_name].iloc[0]
-        ):
+        if len(data[color_col_name]) > 0 and is_color_like(data[color_col_name].iat[0]):
             # Use .loc[] to avoid a SettingWithCopyWarning in some cases.
             data.loc[:, color_col_name] = data.loc[:, color_col_name].map(
                 to_int_color_tuple
@@ -466,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. "
@@ -639,6 +637,7 @@ def marshall_video(
             "video",
             # video does not yet allow setting a user-defined key
             user_key=None,
+            key_as_main_identity=False,
             dg=dg,
             url=proto.url,
             mimetype=mimetype,
@@ -831,6 +830,7 @@ def marshall_audio(
         proto.id = compute_and_register_element_id(
             "audio",
             user_key=None,
+            key_as_main_identity=False,
             dg=dg,
             url=proto.url,
             mimetype=mimetype,

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 (
@@ -36,16 +34,14 @@ from streamlit.elements.lib.utils import (
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.Metric_pb2 import Metric as MetricProto
 from streamlit.runtime.metrics_util import gather_metrics
-from streamlit.string_util import clean_text
+from streamlit.string_util import AnyNumber, clean_text, from_number
 
 if TYPE_CHECKING:
-    import numpy as np
-
     from streamlit.delta_generator import DeltaGenerator
 
 
-Value: TypeAlias = Union["np.integer[Any]", "np.floating[Any]", float, int, str, None]
-Delta: TypeAlias = Union[float, int, str, None]
+Value: TypeAlias = AnyNumber | str | None
+Delta: TypeAlias = AnyNumber | str | None
 DeltaColor: TypeAlias = Literal["normal", "inverse", "off"]
 
 
@@ -98,10 +94,10 @@ class MetricMixin:
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
 
-        value : int, float, str, or None
-             Value of the metric. None is rendered as a long dash.
+        value : int, float, decimal.Decimal, str, or None
+             Value of the metric. ``None`` is rendered as a long dash.
 
-        delta : int, float, str, or None
+        delta : int, float, decimal.Decimal, str, or None
             Indicator of how the metric changed, rendered with an arrow below
             the metric. If delta is negative (int/float) or starts with a minus
             sign (str), the arrow points down and the text is red; else the
@@ -338,23 +334,9 @@ def _parse_label(label: str) -> str:
 def _parse_value(value: Value) -> str:
     if value is None:
         return "—"
-    if isinstance(value, (int, float, str)):
-        return str(value)
-    if hasattr(value, "item"):
-        # Add support for numpy values (e.g. int16, float64, etc.)
-        try:
-            # Item could also be just a variable, so we use try, except
-            if isinstance(value.item(), (float, int)):
-                return str(value.item())
-        except Exception:  # noqa: S110
-            # If the numpy item is not a valid value, the TypeError below will be raised.
-            pass
-
-    raise TypeError(
-        f"'{value}' is of type {type(value)}, which is not an accepted type."
-        " value only accepts: int, float, str, or None."
-        " Please convert the value to an accepted type."
-    )
+    if isinstance(value, str):
+        return value
+    return from_number(value)
 
 
 def _parse_delta(delta: Delta) -> str:
@@ -362,13 +344,7 @@ def _parse_delta(delta: Delta) -> str:
         return ""
     if isinstance(delta, str):
         return dedent(delta)
-    if isinstance(delta, (int, float)):
-        return str(delta)
-    raise TypeError(
-        f"'{delta}' is of type {type(delta)}, which is not an accepted type."
-        " delta only accepts: int, float, str, or None."
-        " Please convert the value to an accepted type."
-    )
+    return from_number(delta)
 
 
 def _determine_delta_color_and_direction(

streamlit/elements/pdf.py

@@ -16,9 +16,7 @@ from __future__ import annotations
 
 import io
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Union, cast
-
-from typing_extensions import TypeAlias
+from typing import TYPE_CHECKING, Any, TypeAlias, cast
 
 from streamlit import url_util
 from streamlit.elements.lib.layout_utils import validate_height
@@ -29,7 +27,7 @@ if TYPE_CHECKING:
     from streamlit.delta_generator import DeltaGenerator
     from streamlit.elements.lib.layout_utils import HeightWithoutContent
 
-PdfData: TypeAlias = Union[str, Path, bytes, io.BytesIO]
+PdfData: TypeAlias = str | Path | bytes | io.BytesIO
 
 
 def _get_pdf_component() -> Any | None: