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

streamlit/dataframe_util.py

@@ -153,7 +153,7 @@ class DataFrameGenericAlias(Protocol[V_co]):
 class PandasCompatible(Protocol):
     """Protocol for Pandas compatible objects that have a `to_pandas` method."""
 
-    def to_pandas(self) -> DataFrame | Series: ...
+    def to_pandas(self) -> DataFrame | Series[Any]: ...
 
 
 class DataframeInterchangeCompatible(Protocol):
@@ -177,9 +177,9 @@ OptionSequence: TypeAlias = (
 # st.line_chart`...
 Data: TypeAlias = Union[
     "DataFrame",
-    "Series",
+    "Series[Any]",
     "Styler",
-    "Index",
+    "Index[Any]",
     "pa.Table",
     "pa.Array",
     "np.ndarray[Any, np.dtype[Any]]",
@@ -502,7 +502,7 @@ def _fix_column_naming(data_df: DataFrame) -> DataFrame:
     which is not very descriptive.
     """
 
-    if len(data_df.columns) == 1 and data_df.columns[0] == 0:
+    if len(data_df.columns) == 1 and cast("Any", data_df.columns[0]) == 0:
         # Pandas automatically names the first column with 0 if it is not named.
         # We rename it to "value" to make it more descriptive if there is only
         # one column in the dataframe.
@@ -566,13 +566,13 @@ def convert_anything_to_pandas_df(
     import pandas as pd
 
     if isinstance(data, pd.DataFrame):
-        return data.copy() if ensure_copy else cast("pd.DataFrame", data)
+        return data.copy() if ensure_copy else data
 
     if isinstance(data, (pd.Series, pd.Index, pd.api.extensions.ExtensionArray)):
         return pd.DataFrame(data)
 
     if is_pandas_styler(data):
-        return cast("pd.DataFrame", data.data.copy() if ensure_copy else data.data)
+        return cast("pd.DataFrame", data.data.copy() if ensure_copy else data.data)  # type: ignore
 
     if isinstance(data, np.ndarray):
         return (
@@ -583,11 +583,11 @@ def convert_anything_to_pandas_df(
 
     if is_polars_dataframe(data):
         data = data.clone() if ensure_copy else data
-        return data.to_pandas()
+        return cast("pd.DataFrame", data.to_pandas())
 
     if is_polars_series(data):
         data = data.clone() if ensure_copy else data
-        return data.to_pandas().to_frame()
+        return cast("pd.DataFrame", data.to_pandas().to_frame())
 
     if is_polars_lazyframe(data):
         data = data.limit(max_unevaluated_rows).collect().to_pandas()
@@ -601,12 +601,12 @@ def convert_anything_to_pandas_df(
     if is_xarray_dataset(data):
         if ensure_copy:
             data = data.copy(deep=True)
-        return data.to_dataframe()
+        return cast("pd.DataFrame", data.to_dataframe())
 
     if is_xarray_data_array(data):
         if ensure_copy:
             data = data.copy(deep=True)
-        return data.to_series().to_frame()
+        return cast("pd.DataFrame", data.to_series().to_frame())
 
     if is_dask_object(data):
         data = data.head(max_unevaluated_rows, compute=True)
@@ -684,7 +684,7 @@ def convert_anything_to_pandas_df(
                 f"⚠️ Showing only {string_util.simplify_number(max_unevaluated_rows)} "
                 "rows. Call `df()` on the relation to show more."
             )
-        return data
+        return cast("pd.DataFrame", data)
 
     if is_dbapi_cursor(data):
         # Based on the specification, the first item in the description is the
@@ -698,7 +698,7 @@ def convert_anything_to_pandas_df(
                 f"⚠️ Showing only {string_util.simplify_number(max_unevaluated_rows)} "
                 "rows. Call `fetchall()` on the Cursor to show more."
             )
-        return data
+        return cast("DataFrame", data)  # ty: ignore[redundant-cast]
 
     if is_snowpark_row_list(data):
         return pd.DataFrame([row.as_dict() for row in data])
@@ -727,7 +727,7 @@ def convert_anything_to_pandas_df(
                 f"⚠️ Showing only {string_util.simplify_number(max_unevaluated_rows)} "
                 "rows. Convert the data to a list to show more."
             )
-        return data
+        return cast("DataFrame", data)  # ty: ignore[redundant-cast]
 
     if isinstance(data, EnumMeta):
         # Support for enum classes
@@ -859,7 +859,7 @@ def convert_arrow_bytes_to_pandas_df(source: bytes) -> DataFrame:
     import pyarrow as pa
 
     reader = pa.RecordBatchStreamReader(source)
-    return reader.read_pandas()
+    return cast("DataFrame", reader.read_pandas())
 
 
 def _show_data_information(msg: str) -> None:
@@ -1040,7 +1040,7 @@ def _maybe_truncate_table(
     return table
 
 
-def is_colum_type_arrow_incompatible(column: Series[Any] | Index) -> bool:
+def is_colum_type_arrow_incompatible(column: Series[Any] | Index[Any]) -> bool:
     """Return True if the column type is known to cause issues during
     Arrow conversion.
     """
@@ -1281,7 +1281,7 @@ def _unify_missing_values(df: DataFrame) -> DataFrame:
     # then infer objects without creating a separate copy:
     # For performance reasons, we could use copy=False here.
     # However, this is only available in pandas >=2.
-    return df.replace([pd.NA, pd.NaT, np.nan], None).infer_objects()
+    return df.replace([pd.NA, pd.NaT, np.nan], None).infer_objects()  # type: ignore
 
 
 def _pandas_df_to_series(df: DataFrame) -> Series[Any]:
@@ -1297,7 +1297,7 @@ def _pandas_df_to_series(df: DataFrame) -> Series[Any]:
         raise ValueError(
             f"DataFrame is expected to have a single column but has {len(df.columns)}."
         )
-    return df[df.columns[0]]
+    return df.iloc[:, 0]
 
 
 def convert_pandas_df_to_data_format(
@@ -1404,7 +1404,7 @@ def convert_pandas_df_to_data_format(
         return_list = []
         if len(df.columns) == 1:
             #  Get the first column and convert to list
-            return_list = df[df.columns[0]].tolist()
+            return_list = df.iloc[:, 0].tolist()
         elif len(df.columns) >= 1:
             raise ValueError(
                 "DataFrame is expected to have a single column but "

streamlit/delta_generator.py

@@ -64,7 +64,9 @@ from streamlit.elements.layouts import LayoutsMixin
 from streamlit.elements.lib.form_utils import FormData, current_form_id
 from streamlit.elements.lib.layout_utils import (
     get_height_config,
+    get_text_alignment_config,
     get_width_config,
+    validate_text_alignment,
 )
 from streamlit.elements.map import MapMixin
 from streamlit.elements.markdown import MarkdownMixin
@@ -495,6 +497,11 @@ class DeltaGenerator(
                 msg.delta.new_element.width_config.CopyFrom(
                     get_width_config(layout_config.width)
                 )
+            if layout_config.text_alignment is not None:
+                validate_text_alignment(layout_config.text_alignment)
+                msg.delta.new_element.text_alignment_config.CopyFrom(
+                    get_text_alignment_config(layout_config.text_alignment)
+                )
 
         # Only enqueue message and fill in metadata if there's a container.
         msg_was_enqueued = False

streamlit/delta_generator_singletons.py

@@ -145,28 +145,22 @@ class ContextVarWithLazyDefault(Generic[_T]):
         self._default = default
         self._context_var: ContextVar[_T] | None = None
 
-    def _init_context_var(self) -> None:
-        self._context_var = ContextVar(self._name, default=self._default())  # noqa: B039
+    def _ensure_context_var(self) -> ContextVar[_T]:
+        if self._context_var is None:
+            self._context_var = ContextVar(self._name, default=self._default())  # noqa: B039
+        return self._context_var
 
     def get(self) -> _T:
-        if self._context_var is None:
-            self._init_context_var()
-        return self._context_var.get()  # type: ignore[union-attr]
+        return self._ensure_context_var().get()
 
     def set(self, value: _T) -> Token[_T]:
-        if self._context_var is None:
-            self._init_context_var()
-        return self._context_var.set(value)  # type: ignore[union-attr]
+        return self._ensure_context_var().set(value)
 
     def reset(self, token: Token[_T]) -> None:
-        if self._context_var is None:
-            self._init_context_var()
-        self._context_var.reset(token)  # type: ignore[union-attr]
+        self._ensure_context_var().reset(token)
 
     def __hash__(self) -> int:
-        if self._context_var is None:
-            self._init_context_var()
-        return self._context_var.__hash__()
+        return self._ensure_context_var().__hash__()
 
 
 # we don't use the default factory here because `main_dg` is not initialized when this

streamlit/elements/alert.py

@@ -50,6 +50,7 @@ class AlertMixin:
 
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
+
         icon : str, None
             An optional emoji or icon to display next to the alert. If ``icon``
             is ``None`` (default), no icon is displayed. If ``icon`` is a
@@ -66,6 +67,9 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
+
+            - ``"spinner"``: Displays a spinner as an icon.
+
         width : "stretch" or int
             The width of the alert element. This can be one of the following:
 
@@ -123,6 +127,7 @@ class AlertMixin:
 
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
+
         icon : str, None
             An optional emoji or icon to display next to the alert. If ``icon``
             is ``None`` (default), no icon is displayed. If ``icon`` is a
@@ -139,6 +144,9 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
+
+            - ``"spinner"``: Displays a spinner as an icon.
+
         width : "stretch" or int
             The width of the warning element. This can be one of the following:
 
@@ -195,6 +203,7 @@ class AlertMixin:
 
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
+
         icon : str, None
             An optional emoji or icon to display next to the alert. If ``icon``
             is ``None`` (default), no icon is displayed. If ``icon`` is a
@@ -211,6 +220,9 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
+
+            - ``"spinner"``: Displays a spinner as an icon.
+
         width : "stretch" or int
             The width of the info element. This can be one of the following:
 
@@ -268,6 +280,7 @@ class AlertMixin:
 
             .. |st.markdown| replace:: ``st.markdown``
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
+
         icon : str, None
             An optional emoji or icon to display next to the alert. If ``icon``
             is ``None`` (default), no icon is displayed. If ``icon`` is a
@@ -284,6 +297,9 @@ class AlertMixin:
               Thumb Up icon. Find additional icons in the `Material Symbols \
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
+
+            - ``"spinner"``: Displays a spinner as an icon.
+
         width : "stretch" or int
             The width of the success element. This can be one of the following:
 

streamlit/elements/arrow.py

@@ -42,7 +42,7 @@ from streamlit.elements.lib.column_config_utils import (
 )
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.elements.lib.layout_utils import (
-    HeightWithoutContent,
+    Height,
     LayoutConfig,
     Width,
     validate_height,
@@ -287,7 +287,7 @@ class ArrowMixin:
         self,
         data: Data = None,
         width: Width = "stretch",
-        height: HeightWithoutContent | Literal["auto"] = "auto",
+        height: Height | Literal["auto"] = "auto",
         *,
         use_container_width: bool | None = None,
         hide_index: bool | None = None,
@@ -297,6 +297,7 @@ class ArrowMixin:
         on_select: Literal["ignore"] = "ignore",
         selection_mode: SelectionMode | Iterable[SelectionMode] = "multi-row",
         row_height: int | None = None,
+        placeholder: str | None = None,
     ) -> DeltaGenerator: ...
 
     @overload
@@ -304,7 +305,7 @@ class ArrowMixin:
         self,
         data: Data = None,
         width: Width = "stretch",
-        height: HeightWithoutContent | Literal["auto"] = "auto",
+        height: Height | Literal["auto"] = "auto",
         *,
         use_container_width: bool | None = None,
         hide_index: bool | None = None,
@@ -314,6 +315,7 @@ class ArrowMixin:
         on_select: Literal["rerun"] | WidgetCallback,
         selection_mode: SelectionMode | Iterable[SelectionMode] = "multi-row",
         row_height: int | None = None,
+        placeholder: str | None = None,
     ) -> DataframeState: ...
 
     @gather_metrics("dataframe")
@@ -321,7 +323,7 @@ class ArrowMixin:
         self,
         data: Data = None,
         width: Width = "stretch",
-        height: HeightWithoutContent | Literal["auto"] = "auto",
+        height: Height | Literal["auto"] = "auto",
         *,
         use_container_width: bool | None = None,
         hide_index: bool | None = None,
@@ -331,6 +333,7 @@ class ArrowMixin:
         on_select: Literal["ignore", "rerun"] | WidgetCallback = "ignore",
         selection_mode: SelectionMode | Iterable[SelectionMode] = "multi-row",
         row_height: int | None = None,
+        placeholder: str | None = None,
     ) -> DeltaGenerator | DataframeState:
         """Display a dataframe as an interactive table.
 
@@ -389,11 +392,14 @@ class ArrowMixin:
               the parent container, the width of the element matches the width
               of the parent container.
 
-        height : "auto", "stretch", or int
+        height : "auto", "content", "stretch", or int
             The height of the dataframe element. This can be one of the following:
 
             - ``"auto"`` (default): Streamlit sets the height to show at most
               ten rows.
+            - ``"content"``: The height of the element matches the height of
+              its content. The height is capped at 10,000 pixels to prevent
+              performance issues with very large dataframes.
             - ``"stretch"``: The height of the element expands to fill the
               available vertical space in its parent container. When multiple
               elements with stretch height are in the same container, they
@@ -510,6 +516,12 @@ class ArrowMixin:
             is ``None`` (default), Streamlit will use a default row height,
             which fits one line of text.
 
+        placeholder : str or None
+            The text that should be shown for missing values. If this is
+            ``None`` (default), missing values are displayed as "None". To
+            leave a cell empty, use an empty string (``""``). Other common
+            values are ``"null"``, ``"NaN"`` and ``"-"``.
+
         Returns
         -------
         element or dict
@@ -676,7 +688,7 @@ class ArrowMixin:
         validate_width(width, allow_content=True)
         validate_height(
             height,
-            allow_content=False,
+            allow_content=True,
             additional_allowed=["auto"],
         )
 
@@ -691,6 +703,9 @@ class ArrowMixin:
         if column_order:
             proto.column_order[:] = column_order
 
+        if placeholder is not None:
+            proto.placeholder = placeholder
+
         proto.editing_mode = ArrowProto.EditingMode.READ_ONLY
 
         has_range_index: bool = False
@@ -767,6 +782,7 @@ class ArrowMixin:
                 selection_mode=selection_mode,
                 is_selection_activated=is_selection_activated,
                 row_height=row_height,
+                placeholder=placeholder,
             )
 
             serde = DataframeSelectionSerde()
@@ -895,6 +911,12 @@ class ArrowMixin:
     def add_rows(self, data: Data = None, **kwargs: Any) -> DeltaGenerator | None:
         """Concatenate a dataframe to the bottom of the current one.
 
+        .. important::
+            ``add_rows`` is deprecated and might be removed in a future version.
+            If you have a specific use-case that requires the ``add_rows``
+            functionality, please tell us via this
+            [issue on Github](https://github.com/streamlit/streamlit/issues/13063).
+
         Parameters
         ----------
         data : pandas.DataFrame, pandas.Styler, pyarrow.Table, numpy.ndarray, pyspark.sql.DataFrame, snowflake.snowpark.dataframe.DataFrame, Iterable, dict, or None
@@ -947,6 +969,14 @@ class ArrowMixin:
         >>> my_chart.add_rows(some_fancy_name=df2)  # <-- name used as keyword
 
         """  # noqa: E501
+        show_deprecation_warning(
+            "`add_rows` is deprecated and might be removed in a future version."
+            " If you have a specific use-case that requires the `add_rows` "
+            "functionality, please tell us via this "
+            "[issue on Github](https://github.com/streamlit/streamlit/issues/13063).",
+            show_in_browser=False,
+        )
+
         return _arrow_add_rows(self.dg, data, **kwargs)
 
     @property

streamlit/elements/bokeh_chart.py

@@ -16,48 +16,33 @@
 
 from __future__ import annotations
 
-import json
-from typing import TYPE_CHECKING, Final, cast
+from typing import TYPE_CHECKING, cast
 
 from streamlit.deprecation_util import (
     show_deprecation_warning,
 )
-from streamlit.errors import StreamlitAPIException
-from streamlit.proto.BokehChart_pb2 import BokehChart as BokehChartProto
 from streamlit.runtime.metrics_util import gather_metrics
-from streamlit.util import calc_md5
 
 if TYPE_CHECKING:
-    from bokeh.plotting.figure import Figure
-
     from streamlit.delta_generator import DeltaGenerator
 
-ST_BOKEH_VERSION: Final = "2.4.3"
-
 
 class BokehMixin:
     @gather_metrics("bokeh_chart")
     def bokeh_chart(
         self,
-        figure: Figure,
-        use_container_width: bool = True,
+        figure: object,  # noqa: ARG002
+        use_container_width: bool = True,  # noqa: ARG002
     ) -> DeltaGenerator:
         """Display an interactive Bokeh chart.
 
-        Bokeh is a charting library for Python. The arguments to this function
-        closely follow the ones for Bokeh's ``show`` function. You can find
+        Bokeh is a charting library for Python. You can find
         more about Bokeh at https://bokeh.pydata.org.
 
-        To show Bokeh charts in Streamlit, call ``st.bokeh_chart``
-        wherever you would call Bokeh's ``show``.
-
         .. Important::
-            You must install ``bokeh==2.4.3`` and ``numpy<2`` to use this
-            command, which is deprecated and will be removed in a future
-            version.
-
-            For more current updates, use the |streamlit-bokeh|_ custom
-            component instead.
+            This command has been deprecated and removed. Please use our custom
+            component, |streamlit-bokeh|_, instead. Calling st.bokeh_chart will
+            do nothing.
 
         .. |streamlit-bokeh| replace:: ``streamlit-bokeh``
         .. _streamlit-bokeh: https://github.com/streamlit/streamlit-bokeh
@@ -74,70 +59,17 @@ class BokehMixin:
             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.
-
-        Example
-        -------
-        >>> import streamlit as st
-        >>> from bokeh.plotting import figure
-        >>>
-        >>> x = [1, 2, 3, 4, 5]
-        >>> y = [6, 7, 2, 4, 5]
-        >>>
-        >>> p = figure(title="simple line example", x_axis_label="x", y_axis_label="y")
-        >>> p.line(x, y, legend_label="Trend", line_width=2)
-        >>>
-        >>> st.bokeh_chart(p)
-
-        .. output::
-           https://doc-bokeh-chart.streamlit.app/
-           height: 700px
-
         """
-        import bokeh
-
-        if bokeh.__version__ != ST_BOKEH_VERSION:
-            raise StreamlitAPIException(
-                f"Streamlit only supports Bokeh version {ST_BOKEH_VERSION}, "
-                f"but you have version {bokeh.__version__} installed. Please "
-                f"run `pip install --force-reinstall --no-deps bokeh=="
-                f"{ST_BOKEH_VERSION}` to install the correct version.\n\n\n"
-                f"To use the latest version of Bokeh, install our custom component, "
-                f"[streamlit-bokeh](https://github.com/streamlit/streamlit-bokeh)."
-            )
 
         show_deprecation_warning(
-            "st.bokeh_chart is deprecated and will be removed in a future version. "
+            "st.bokeh_chart has been deprecated and removed. "
             "Please use our custom component, "
             "[streamlit-bokeh](https://github.com/streamlit/streamlit-bokeh), "
-            "instead."
+            "instead. Calling st.bokeh_chart will do nothing."
         )
-        # Generate element ID from delta path
-        delta_path = self.dg._get_delta_path_str()
-
-        element_id = calc_md5(delta_path.encode())
-        bokeh_chart_proto = BokehChartProto()
-        marshall(bokeh_chart_proto, figure, use_container_width, element_id)
-        return self.dg._enqueue("bokeh_chart", bokeh_chart_proto)
+        return self.dg
 
     @property
     def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)
-
-
-def marshall(
-    proto: BokehChartProto,
-    figure: Figure,
-    use_container_width: bool,
-    element_id: str,
-) -> None:
-    """Construct a Bokeh chart object.
-
-    See DeltaGenerator.bokeh_chart for docs.
-    """
-    from bokeh.embed import json_item
-
-    data = json_item(figure)
-    proto.figure = json.dumps(data)
-    proto.use_container_width = use_container_width
-    proto.element_id = element_id

streamlit/elements/code.py

@@ -109,7 +109,7 @@ class CodeMixin:
         ...     print("Hello, Streamlit!")'''
         >>> st.code(code, language="python")
 
-        .. output ::
+        .. output::
             https://doc-code.streamlit.app/
             height: 220px
 
@@ -129,7 +129,7 @@ class CodeMixin:
         ... '''
         >>> st.code(code, language=None)
 
-        .. output ::
+        .. output::
             https://doc-code-ascii.streamlit.app/
             height: 380px
         """

streamlit/elements/deck_gl_json_chart.py

@@ -182,7 +182,7 @@ class PydeckSelectionState(TypedDict, total=False):
     >>>
     >>> event.selection
 
-    .. output ::
+    .. output::
         https://doc-pydeck-event-state-selections.streamlit.app/
         height: 700px
 

streamlit/elements/exception.py

@@ -79,7 +79,7 @@ class ExceptionMixin:
         >>> e = RuntimeError("This is an exception of type RuntimeError")
         >>> st.exception(e)
 
-        .. output ::
+        .. output::
             https://doc-status-exception.streamlit.app/
             height: 220px
 

streamlit/elements/form.py

@@ -250,6 +250,7 @@ class FormMixin:
         disabled: bool = False,
         use_container_width: bool | None = None,
         width: Width = "content",
+        shortcut: str | None = None,
     ) -> bool:
         r"""Display a form submit button.
 
@@ -332,6 +333,8 @@ class FormMixin:
               <https://fonts.google.com/icons?icon.set=Material+Symbols&icon.style=Rounded>`_
               font library.
 
+            - ``"spinner"``: Displays a spinner as an icon.
+
         disabled : bool
             Whether to disable the button. If this is ``False`` (default), the
             user can interact with the button. If this is ``True``, the button
@@ -369,6 +372,27 @@ class FormMixin:
               the parent container, the width of the button matches the width
               of the parent container.
 
+        shortcut : str or None
+            An optional keyboard shortcut that triggers the button. This can be
+            one of the following strings:
+
+            - A single alphanumeric key like ``"K"`` or ``"4"``.
+            - A function key like ``"F11"``.
+            - A special key like ``"Enter"``, ``"Esc"``, or ``"Tab"``.
+            - Any of the above combined with modifiers. For example, you can use
+              ``"Ctrl+K"`` or ``"Cmd+Shift+O"``.
+
+            .. important::
+                The keys ``"C"`` and ``"R"`` are reserved and can't be used,
+                even with modifiers. Punctuation keys like ``"."`` and ``","``
+                aren't currently supported.
+
+            For a list of supported keys and modifiers, see the documentation
+            for |st.button|_.
+
+            .. |st.button| replace:: ``st.button``
+            .. _st.button: https://docs.streamlit.io/develop/api-reference/widgets/st.button
+
         Returns
         -------
         bool
@@ -398,6 +422,7 @@ class FormMixin:
             ctx=ctx,
             width=width,
             key=key,
+            shortcut=shortcut,
         )
 
     def _form_submit_button(
@@ -414,6 +439,7 @@ class FormMixin:
         disabled: bool = False,
         ctx: ScriptRunContext | None = None,
         width: Width = "content",
+        shortcut: str | None = None,
     ) -> bool:
         form_id = current_form_id(self.dg)
         submit_button_key = to_key(key) or f"FormSubmitter:{form_id}-{label}"
@@ -430,6 +456,7 @@ class FormMixin:
             disabled=disabled,
             ctx=ctx,
             width=width,
+            shortcut=shortcut,
         )
 
     @property