streamlit-nightly 1.45.2.dev20250514__py3-none-any.whl → 1.45.2.dev20250515__py3-none-any.whl

streamlit/connections/sql_connection.py

@@ -319,13 +319,16 @@ class SQLConnection(BaseConnection["Engine"]):
             import pandas as pd
 
             instance = self._instance.connect()
-            return pd.read_sql(
-                text(sql),
-                instance,
-                index_col=index_col,
-                chunksize=chunksize,
-                params=params,
-                **kwargs,
+            return cast(
+                "DataFrame",
+                pd.read_sql(
+                    text(sql),
+                    instance,
+                    index_col=index_col,
+                    chunksize=chunksize,
+                    params=params,
+                    **kwargs,
+                ),
             )
 
         # We modify our helper function's `__qualname__` here to work around default

streamlit/connections/util.py

@@ -21,7 +21,7 @@
 from __future__ import annotations
 
 import os
-from typing import TYPE_CHECKING, Any, cast
+from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
     from collections.abc import Collection
@@ -92,6 +92,6 @@ def running_in_sis() -> bool:
             is_in_stored_procedure,
         )
 
-        return cast("bool", is_in_stored_procedure())
+        return is_in_stored_procedure()  # type: ignore
     except ModuleNotFoundError:
         return False

streamlit/elements/lib/options_selector_utils.py

@@ -185,7 +185,11 @@ def maybe_coerce_enum(
 ) -> RegisterWidgetResult[T]: ...
 
 
-def maybe_coerce_enum(register_widget_result, options, opt_sequence):
+def maybe_coerce_enum(
+    register_widget_result: RegisterWidgetResult[Any],
+    options: OptionSequence[Any],
+    opt_sequence: Sequence[Any],
+) -> RegisterWidgetResult[Any]:
     """Maybe Coerce a RegisterWidgetResult with an Enum member value to
     RegisterWidgetResult[option] if option is an EnumType, otherwise just return
     the original RegisterWidgetResult.
@@ -227,7 +231,11 @@ def maybe_coerce_enum_sequence(
 ) -> RegisterWidgetResult[tuple[T, T]]: ...
 
 
-def maybe_coerce_enum_sequence(register_widget_result, options, opt_sequence):
+def maybe_coerce_enum_sequence(
+    register_widget_result: RegisterWidgetResult[list[Any] | tuple[Any, ...]],
+    options: OptionSequence[Any],
+    opt_sequence: Sequence[Any],
+) -> RegisterWidgetResult[list[Any] | tuple[Any, ...]]:
     """Maybe Coerce a RegisterWidgetResult with a sequence of Enum members as value
     to RegisterWidgetResult[Sequence[option]] if option is an EnumType, otherwise just
     return the original RegisterWidgetResult.

streamlit/elements/markdown.py

@@ -22,7 +22,7 @@ from streamlit.string_util import clean_text, validate_icon_or_emoji
 from streamlit.type_util import SupportsStr, is_sympy_expression
 
 if TYPE_CHECKING:
-    import sympy  # type: ignore
+    import sympy
 
     from streamlit.delta_generator import DeltaGenerator
 

streamlit/elements/plotly_chart.py

@@ -29,7 +29,7 @@ from typing import (
     overload,
 )
 
-from typing_extensions import TypeAlias
+from typing_extensions import Required, TypeAlias
 
 from streamlit import type_util
 from streamlit.deprecation_util import show_deprecation_warning
@@ -159,10 +159,10 @@ class PlotlySelectionState(TypedDict, total=False):
 
     """
 
-    points: list[dict[str, Any]]
-    point_indices: list[int]
-    box: list[dict[str, Any]]
-    lasso: list[dict[str, Any]]
+    points: Required[list[dict[str, Any]]]
+    point_indices: Required[list[int]]
+    box: Required[list[dict[str, Any]]]
+    lasso: Required[list[dict[str, Any]]]
 
 
 class PlotlyState(TypedDict, total=False):
@@ -205,7 +205,7 @@ class PlotlyState(TypedDict, total=False):
 
     """
 
-    selection: PlotlySelectionState
+    selection: Required[PlotlySelectionState]
 
 
 @dataclass
@@ -231,7 +231,7 @@ class PlotlyChartSelectionSerde:
         )
 
         if "selection" not in selection_state:
-            selection_state = empty_selection_state
+            selection_state = empty_selection_state  # type: ignore[unreachable]
 
         return cast("PlotlyState", AttributeDictionary(selection_state))
 

streamlit/elements/vega_charts.py

@@ -31,7 +31,7 @@ from typing import (
     overload,
 )
 
-from typing_extensions import TypeAlias
+from typing_extensions import Required, TypeAlias
 
 from streamlit import dataframe_util, type_util
 from streamlit.elements.lib import dicttools
@@ -218,7 +218,7 @@ class VegaLiteState(TypedDict, total=False):
 
     """
 
-    selection: AttributeDictionary
+    selection: Required[AttributeDictionary]
 
 
 @dataclass
@@ -242,7 +242,7 @@ class VegaLiteStateSerde:
         )
 
         if "selection" not in selection_state:
-            selection_state = empty_selection_state
+            selection_state = empty_selection_state  # type: ignore[unreachable]
 
         return cast("VegaLiteState", AttributeDictionary(selection_state))
 
@@ -1479,7 +1479,7 @@ class VegaChartsMixin:
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,
-        on_select: Literal["ignore"],  # No default value here to make it work with mypy
+        on_select: Literal["ignore"] = "ignore",
         selection_mode: str | Iterable[str] | None = None,
     ) -> DeltaGenerator: ...
 
@@ -1492,7 +1492,7 @@ class VegaChartsMixin:
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,
-        on_select: Literal["rerun"] | WidgetCallback = "rerun",
+        on_select: Literal["rerun"] | WidgetCallback,
         selection_mode: str | Iterable[str] | None = None,
     ) -> VegaLiteState: ...
 
@@ -1638,7 +1638,7 @@ class VegaChartsMixin:
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,
-        on_select: Literal["ignore"],  # No default value here to make it work with mypy
+        on_select: Literal["ignore"] = "ignore",
         selection_mode: str | Iterable[str] | None = None,
         **kwargs: Any,
     ) -> DeltaGenerator: ...
@@ -1653,7 +1653,7 @@ class VegaChartsMixin:
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,
-        on_select: Literal["rerun"] | WidgetCallback = "rerun",
+        on_select: Literal["rerun"] | WidgetCallback,
         selection_mode: str | Iterable[str] | None = None,
         **kwargs: Any,
     ) -> VegaLiteState: ...

streamlit/elements/widgets/file_uploader.py

@@ -170,7 +170,7 @@ class FileUploaderMixin:
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
         width: WidthWithoutContent = "stretch",
-    ) -> list[UploadedFile] | None: ...
+    ) -> list[UploadedFile]: ...
 
     # 1. type is given as not a keyword-only argument
     # 2. accept_multiple_files = False or omitted
@@ -213,7 +213,7 @@ class FileUploaderMixin:
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
         width: WidthWithoutContent = "stretch",
-    ) -> list[UploadedFile] | None: ...
+    ) -> list[UploadedFile]: ...
 
     # 1. type is skipped or a keyword argument
     # 2. accept_multiple_files = False or omitted

streamlit/elements/widgets/number_input.py

@@ -116,7 +116,7 @@ class NumberInputMixin:
     def number_input(
         self,
         label: str,
-        min_value: int | None = None,
+        min_value: None = None,
         *,
         max_value: int,
         value: IntOrNone | Literal["min"] = "min",
@@ -166,8 +166,8 @@ class NumberInputMixin:
     def number_input(
         self,
         label: str,
-        min_value: int | None = None,
-        max_value: int | None = None,
+        min_value: None = None,
+        max_value: None = None,
         value: IntOrNone | Literal["min"] = "min",
         *,
         step: int,

streamlit/elements/widgets/radio.py

@@ -18,6 +18,8 @@ from dataclasses import dataclass
 from textwrap import dedent
 from typing import TYPE_CHECKING, Any, Callable, Generic, cast, overload
 
+from typing_extensions import Never
+
 from streamlit.dataframe_util import OptionSequence, convert_anything_to_list
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.options_selector_utils import index_, maybe_coerce_enum
@@ -79,6 +81,25 @@ class RadioSerde(Generic[T]):
 
 
 class RadioMixin:
+    @overload
+    def radio(
+        self,
+        label: str,
+        options: Sequence[Never],
+        index: int = 0,
+        format_func: Callable[[Any], Any] = str,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,  # keyword-only args:
+        disabled: bool = False,
+        horizontal: bool = False,
+        captions: Sequence[str] | None = None,
+        label_visibility: LabelVisibility = "visible",
+    ) -> None: ...
+
     @overload
     def radio(
         self,

streamlit/elements/widgets/select_slider.py

@@ -107,7 +107,7 @@ class SelectSliderSerde(Generic[T]):
 
 class SelectSliderMixin:
     @overload
-    def select_slider(  # type: ignore[overload-overlap]
+    def select_slider(
         self,
         label: str,
         options: OptionSequence[T],
@@ -124,18 +124,6 @@ class SelectSliderMixin:
         width: WidthWithoutContent = "stretch",
     ) -> tuple[T, T]: ...
 
-    # The overload-overlap error given by mypy here stems from
-    # the fact that
-    #
-    # > opt:List[object] = [1, 2, "3"]
-    # > select_slider("foo", options=opt, value=[1, 2])
-    #
-    # matches both overloads; "opt" matches
-    # OptionsSequence[T] in each case, binding T to object.
-    # However, the list[int] type of "value" can be interpreted
-    # as subtype of object, or as a subtype of List[object],
-    # meaning it matches both signatures.
-
     @overload
     def select_slider(
         self,

streamlit/elements/widgets/selectbox.py

@@ -16,6 +16,8 @@ from __future__ import annotations
 from textwrap import dedent
 from typing import TYPE_CHECKING, Any, Callable, Generic, Literal, cast, overload
 
+from typing_extensions import Never
+
 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 WidthWithoutContent, validate_width
@@ -132,6 +134,26 @@ class SelectboxSerde(Generic[T]):
 
 
 class SelectboxMixin:
+    @overload
+    def selectbox(
+        self,
+        label: str,
+        options: Sequence[Never],  # Type for empty or Never-inferred options
+        index: int = 0,
+        format_func: Callable[[Any], str] = str,
+        key: Key | None = None,
+        help: str | None = None,
+        on_change: WidgetCallback | None = None,
+        args: WidgetArgs | None = None,
+        kwargs: WidgetKwargs | None = None,
+        *,  # keyword-only arguments:
+        placeholder: str | None = None,
+        disabled: bool = False,
+        label_visibility: LabelVisibility = "visible",
+        accept_new_options: Literal[False] = False,
+        width: WidthWithoutContent = "stretch",
+    ) -> None: ...  # Returns None if options is empty and accept_new_options is False
+
     @overload
     def selectbox(
         self,

streamlit/elements/widgets/slider.py

@@ -23,6 +23,7 @@ from typing import (
     TYPE_CHECKING,
     Any,
     Final,
+    TypedDict,
     TypeVar,
     Union,
     cast,
@@ -155,6 +156,13 @@ def _micros_to_datetime(micros: int, orig_tz: tzinfo | None) -> datetime:
     return utc_dt.replace(tzinfo=orig_tz)
 
 
+class SliderDefaultValues(TypedDict):
+    min_value: SliderScalar
+    max_value: SliderScalar
+    step: SliderStep
+    format: str
+
+
 @dataclass
 class SliderSerde:
     value: list[float]
@@ -192,14 +200,21 @@ class SliderSerde:
 
     def serialize(self, v: Any) -> list[Any]:
         range_value = isinstance(v, (list, tuple))
-        value = list(v) if range_value else [v]
+        # Convert to list to handle tuples
+        processed_value = list(v) if range_value else [v]
+
         if self.data_type == SliderProto.DATE:
-            value = [_datetime_to_micros(_date_to_datetime(v)) for v in value]
+            return [
+                _datetime_to_micros(_date_to_datetime(val)) for val in processed_value
+            ]
         if self.data_type == SliderProto.TIME:
-            value = [_datetime_to_micros(_time_to_datetime(v)) for v in value]
+            return [
+                _datetime_to_micros(_time_to_datetime(val)) for val in processed_value
+            ]
         if self.data_type == SliderProto.DATETIME:
-            value = [_datetime_to_micros(v) for v in value]
-        return value
+            return [_datetime_to_micros(val) for val in processed_value]
+        # For numeric types, ensure they are floats if not already
+        return [float(val) for val in processed_value]
 
 
 class SliderMixin:
@@ -222,6 +237,7 @@ class SliderMixin:
         *,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: WidthWithoutContent = "stretch",
     ) -> int: ...
 
     # If min-value or max_value is provided and a numeric type, and value (if provided)
@@ -243,6 +259,7 @@ class SliderMixin:
         *,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: WidthWithoutContent = "stretch",
     ) -> SliderNumericT: ...
 
     # If value is provided and a sequence of numeric type,
@@ -264,6 +281,7 @@ class SliderMixin:
         kwargs: WidgetKwargs | None = None,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: WidthWithoutContent = "stretch",
     ) -> tuple[SliderNumericT, SliderNumericT]: ...
 
     # If value is provided positionally and a sequence of numeric type,
@@ -285,6 +303,7 @@ class SliderMixin:
         *,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: WidthWithoutContent = "stretch",
     ) -> tuple[SliderNumericT, SliderNumericT]: ...
 
     # If min-value is provided and a datelike type, and value (if provided)
@@ -306,6 +325,7 @@ class SliderMixin:
         *,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: WidthWithoutContent = "stretch",
     ) -> SliderDatelikeT: ...
 
     # If max-value is provided and a datelike type, and value (if provided)
@@ -314,7 +334,7 @@ class SliderMixin:
     def slider(
         self,
         label: str,
-        min_value: SliderDatelikeT | None = None,
+        min_value: None = None,
         *,
         max_value: SliderDatelikeT,
         value: SliderDatelikeT | None = None,
@@ -327,6 +347,7 @@ class SliderMixin:
         kwargs: WidgetKwargs | None = None,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: WidthWithoutContent = "stretch",
     ) -> SliderDatelikeT: ...
 
     # If value is provided and a datelike type, return the same datelike type.
@@ -334,8 +355,8 @@ class SliderMixin:
     def slider(
         self,
         label: str,
-        min_value: SliderDatelikeT | None = None,
-        max_value: SliderDatelikeT | None = None,
+        min_value: None = None,
+        max_value: None = None,
         *,
         value: SliderDatelikeT,
         step: StepDatelikeT | None = None,
@@ -347,6 +368,7 @@ class SliderMixin:
         kwargs: WidgetKwargs | None = None,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: WidthWithoutContent = "stretch",
     ) -> SliderDatelikeT: ...
 
     # If value is provided and a sequence of datelike type,
@@ -358,7 +380,9 @@ class SliderMixin:
         min_value: SliderDatelikeT | None = None,
         max_value: SliderDatelikeT | None = None,
         *,
-        value: SliderDatelikeSpanT[SliderDatelikeT],
+        value: list[SliderDatelikeT]
+        | tuple[SliderDatelikeT]
+        | tuple[SliderDatelikeT, SliderDatelikeT],
         step: StepDatelikeT | None = None,
         format: str | None = None,
         key: Key | None = None,
@@ -368,6 +392,7 @@ class SliderMixin:
         kwargs: WidgetKwargs | None = None,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: WidthWithoutContent = "stretch",
     ) -> tuple[SliderDatelikeT, SliderDatelikeT]: ...
 
     # If value is provided positionally and a sequence of datelike type,
@@ -390,6 +415,7 @@ class SliderMixin:
         *,
         disabled: bool = False,
         label_visibility: LabelVisibility = "visible",
+        width: WidthWithoutContent = "stretch",
     ) -> tuple[SliderDatelikeT, SliderDatelikeT]: ...
 
     # https://github.com/python/mypy/issues/17614

streamlit/runtime/caching/cache_data_api.py

@@ -316,6 +316,11 @@ def get_data_cache_stats_provider() -> CacheStatsProvider:
     return _data_caches
 
 
+# Type-annotate the decorator function.
+# (See https://mypy.readthedocs.io/en/stable/generics.html#decorator-factories)
+F = TypeVar("F", bound=Callable[..., Any])
+
+
 class CacheDataAPI:
     """Implements the public st.cache_data API: the @st.cache_data decorator, and
     st.cache_data.clear().
@@ -336,10 +341,6 @@ class CacheDataAPI:
             decorator_metric_name, self._decorator
         )
 
-    # Type-annotate the decorator function.
-    # (See https://mypy.readthedocs.io/en/stable/generics.html#decorator-factories)
-    F = TypeVar("F", bound=Callable[..., Any])
-
     # Bare decorator usage
     @overload
     def __call__(self, func: F) -> F: ...
@@ -566,16 +567,19 @@ class CacheDataAPI:
         if experimental_allow_widgets:
             show_widget_replay_deprecation("cache_data")
 
-        def wrapper(f):  # noqa: ANN001, ANN202
-            return make_cached_func_wrapper(
-                CachedDataFuncInfo(
-                    func=f,
-                    persist=persist_string,
-                    show_spinner=show_spinner,
-                    max_entries=max_entries,
-                    ttl=ttl,
-                    hash_funcs=hash_funcs,
-                )
+        def wrapper(f: F) -> F:
+            return cast(
+                "F",
+                make_cached_func_wrapper(
+                    CachedDataFuncInfo(
+                        func=f,  # type: ignore
+                        persist=persist_string,
+                        show_spinner=show_spinner,
+                        max_entries=max_entries,
+                        ttl=ttl,
+                        hash_funcs=hash_funcs,
+                    )
+                ),
             )
 
         if func is None:

streamlit/runtime/connection_factory.py

@@ -202,7 +202,7 @@ def connection_factory(
     pass
 
 
-def connection_factory(
+def connection_factory(  # type: ignore
     name,
     type=None,
     max_entries=None,

streamlit/runtime/scriptrunner/script_runner.py

@@ -134,11 +134,10 @@ def _mpa_v1(main_script_path: str) -> None:
     PAGES_FOLDER = MAIN_SCRIPT_PATH.parent / "pages"
 
     # Read out the my_pages folder and create a page for every script:
-    pages = PAGES_FOLDER.glob("*.py")
     pages = sorted(
         [
             page
-            for page in pages
+            for page in PAGES_FOLDER.glob("*.py")
             if page.name.endswith(".py")
             and not page.name.startswith(".")
             and page.name != "__init__.py"

streamlit/runtime/secrets.py

@@ -45,29 +45,31 @@ class SecretErrorMessages:
     """
 
     def __init__(self) -> None:
-        self.missing_attr_message = lambda attr_name: (
+        self.missing_attr_message: Callable[[str], str] = lambda attr_name: (
             f'st.secrets has no attribute "{attr_name}". '
             "Did you forget to add it to secrets.toml, mount it to secret directory, or the app settings "
             "on Streamlit Cloud? More info: "
             "https://docs.streamlit.io/deploy/streamlit-community-cloud/deploy-your-app/secrets-management"
         )
-        self.missing_key_message = lambda key: (
+        self.missing_key_message: Callable[[str], str] = lambda key: (
             f'st.secrets has no key "{key}". '
             "Did you forget to add it to secrets.toml, mount it to secret directory, or the app settings "
             "on Streamlit Cloud? More info: "
             "https://docs.streamlit.io/deploy/streamlit-community-cloud/deploy-your-app/secrets-management"
         )
-        self.no_secrets_found = lambda file_paths: (
+        self.no_secrets_found: Callable[[list[str]], str] = lambda file_paths: (
             f"No secrets found. Valid paths for a secrets.toml file or secret directories are: {', '.join(file_paths)}"
         )
-        self.error_parsing_file_at_path = (
+        self.error_parsing_file_at_path: Callable[[str, Exception], str] = (
             lambda path, ex: f"Error parsing secrets file at {path}: {ex}"
         )
-        self.subfolder_path_is_not_a_folder = lambda sub_folder_path: (
-            f"{sub_folder_path} is not a folder. "
-            "To use directory based secrets, mount every secret in a subfolder under the secret directory"
+        self.subfolder_path_is_not_a_folder: Callable[[str], str] = (
+            lambda sub_folder_path: (
+                f"{sub_folder_path} is not a folder. "
+                "To use directory based secrets, mount every secret in a subfolder under the secret directory"
+            )
         )
-        self.invalid_secret_path = lambda path: (
+        self.invalid_secret_path: Callable[[str], str] = lambda path: (
             f"Invalid secrets path: {path}: path is not a .toml file or a directory"
         )
 

streamlit/runtime/state/query_params_proxy.py

@@ -15,7 +15,7 @@
 from __future__ import annotations
 
 from collections.abc import Iterable, Iterator, MutableMapping
-from typing import TYPE_CHECKING, overload
+from typing import TYPE_CHECKING, Any, overload
 
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.state.session_state_proxy import get_session_state
@@ -55,7 +55,7 @@ class QueryParamsProxy(MutableMapping[str, str]):
             del qp[key]
 
     @gather_metrics("query_params.set_item")
-    def __setitem__(self, key: str, value: str | Iterable[str]) -> None:
+    def __setitem__(self, key: str, value: Any) -> None:
         with get_session_state().query_params() as qp:
             qp[key] = value
 
@@ -76,18 +76,18 @@ class QueryParamsProxy(MutableMapping[str, str]):
 
     @overload
     def update(
-        self, mapping: SupportsKeysAndGetItem[str, str | Iterable[str]], /, **kwds: str
+        self, params: SupportsKeysAndGetItem[str, str | Iterable[str]], /, **kwds: str
     ) -> None: ...
 
     @overload
     def update(
-        self, keys_and_values: Iterable[tuple[str, str | Iterable[str]]], /, **kwds: str
+        self, params: Iterable[tuple[str, str | Iterable[str]]], /, **kwds: str
     ) -> None: ...
 
     @overload
     def update(self, **kwds: str | Iterable[str]) -> None: ...
 
-    def update(self, other=(), /, **kwds):
+    def update(self, params=(), /, **kwds) -> None:  # type: ignore
         """
         Update one or more values in query_params at once from a dictionary or
         dictionary-like object.
@@ -102,10 +102,10 @@ class QueryParamsProxy(MutableMapping[str, str]):
             Additional key/value pairs to update passed as keyword arguments.
         """
         with get_session_state().query_params() as qp:
-            qp.update(other, **kwds)
+            qp.update(params, **kwds)
 
     @gather_metrics("query_params.set_attr")
-    def __setattr__(self, key: str, value: str | Iterable[str]) -> None:
+    def __setattr__(self, key: str, value: Any) -> None:
         with get_session_state().query_params() as qp:
             qp[key] = value
 
@@ -165,17 +165,19 @@ class QueryParamsProxy(MutableMapping[str, str]):
             return qp.to_dict()
 
     @overload
-    def from_dict(
-        self, keys_and_values: Iterable[tuple[str, str | Iterable[str]]]
-    ) -> None: ...
+    def from_dict(self, params: Iterable[tuple[str, str | Iterable[str]]]) -> None: ...
 
     @overload
     def from_dict(
-        self, mapping: SupportsKeysAndGetItem[str, str | Iterable[str]]
+        self, params: SupportsKeysAndGetItem[str, str | Iterable[str]]
     ) -> None: ...
 
     @gather_metrics("query_params.from_dict")
-    def from_dict(self, params):
+    def from_dict(
+        self,
+        params: SupportsKeysAndGetItem[str, str | Iterable[str]]
+        | Iterable[tuple[str, str | Iterable[str]]],
+    ) -> None:
         """
         Set all of the query parameters from a dictionary or dictionary-like object.