streamlit-nightly 1.45.1.dev20250508__py3-none-any.whl → 1.45.1.dev20250510__py3-none-any.whl

streamlit/file_util.py

@@ -19,15 +19,16 @@ import errno
 import io
 import os
 from pathlib import Path
+from typing import Final
 
 from streamlit import env_util, errors
 from streamlit.string_util import is_binary_string
 
 # Configuration and credentials are stored inside the ~/.streamlit folder
-CONFIG_FOLDER_NAME = ".streamlit"
+CONFIG_FOLDER_NAME: Final = ".streamlit"
 
 # If enableStaticServing is enabled, static file served from the ./static folder
-APP_STATIC_FOLDER_NAME = "static"
+APP_STATIC_FOLDER_NAME: Final = "static"
 
 
 def get_encoded_file_data(
@@ -128,12 +129,11 @@ def get_static_dir() -> str:
 
 def get_app_static_dir(main_script_path: str) -> str:
     """Get the folder where app static files live."""
-    main_script_path = Path(main_script_path)
-    static_dir = main_script_path.parent / APP_STATIC_FOLDER_NAME
+    static_dir = Path(main_script_path).parent / APP_STATIC_FOLDER_NAME
     return os.path.abspath(static_dir)
 
 
-def get_streamlit_file_path(*filepath) -> str:
+def get_streamlit_file_path(*filepath: str) -> str:
     """Return the full path to a file in ~/.streamlit.
 
     This doesn't guarantee that the file (or its directory) exists.
@@ -145,7 +145,7 @@ def get_streamlit_file_path(*filepath) -> str:
     return str(home / CONFIG_FOLDER_NAME / Path(*filepath))
 
 
-def get_project_streamlit_file_path(*filepath):
+def get_project_streamlit_file_path(*filepath: str) -> str:
     """Return the full path to a filepath in ${CWD}/.streamlit.
 
     This doesn't guarantee that the file (or its directory) exists.
@@ -214,7 +214,7 @@ def file_in_pythonpath(filepath: str) -> bool:
     )
 
 
-def normalize_path_join(*args):
+def normalize_path_join(*args: str) -> str:
     """Return the normalized path of the joined path.
 
     Parameters
@@ -230,7 +230,7 @@ def normalize_path_join(*args):
     return os.path.normpath(os.path.join(*args))
 
 
-def get_main_script_directory(main_script):
+def get_main_script_directory(main_script: str) -> str:
     """Return the full path to the main script directory.
 
     Parameters

streamlit/git_util.py

@@ -41,7 +41,7 @@ class GitRepo:
 
             # GitPython is not fully typed, and mypy is outputting inconsistent
             # type errors on Mac and Linux. We bypass type checking entirely
-            # by re-declaring the `git` import as an "Any".
+            # by redeclaring the `git` import as an "Any".
             git_package: Any = git
             self.repo = git_package.Repo(path, search_parent_directories=True)
             self.git_version = self.repo.git.version_info
@@ -145,7 +145,7 @@ class GitRepo:
 
         return False
 
-    def get_repo_info(self):
+    def get_repo_info(self) -> tuple[str, str, str] | None:
         if not self.is_valid():
             return None
 

streamlit/hello/dataframe_demo.py

@@ -23,7 +23,7 @@ from streamlit.hello.utils import show_code
 
 def data_frame_demo():
     @st.cache_data
-    def get_un_data():
+    def get_un_data() -> pd.DataFrame:
         AWS_BUCKET_URL = "https://streamlit-demo-data.s3-us-west-2.amazonaws.com"
         df = pd.read_csv(AWS_BUCKET_URL + "/agri.csv.gz")
         return df.set_index("Region")

streamlit/hello/mapping_demo.py

@@ -23,7 +23,7 @@ from streamlit.hello.utils import show_code
 
 def mapping_demo():
     @st.cache_data
-    def from_data_file(filename):
+    def from_data_file(filename: str) -> pd.DataFrame:
         url = (
             "https://raw.githubusercontent.com/streamlit/"
             "example-data/master/hello/v1/%s" % filename

streamlit/navigation/page.py

@@ -167,7 +167,7 @@ class StreamlitPage:
         icon: str | None = None,
         url_path: str | None = None,
         default: bool = False,
-    ):
+    ) -> None:
         # Must appear before the return so all pages, even if running in bare Python,
         # have a _default property. This way we can always tell which script needs to run.
         self._default: bool = default

streamlit/proto/Block_pb2.py

@@ -12,9 +12,12 @@ from google.protobuf.internal import builder as _builder
 _sym_db = _symbol_database.Default()
 
 
+from streamlit.proto import WidthConfig_pb2 as streamlit_dot_proto_dot_WidthConfig__pb2
+from streamlit.proto import HeightConfig_pb2 as streamlit_dot_proto_dot_HeightConfig__pb2
+from streamlit.proto import GapSize_pb2 as streamlit_dot_proto_dot_GapSize__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1bstreamlit/proto/Block.proto\"\x86\n\n\x05\x42lock\x12#\n\x08vertical\x18\x01 \x01(\x0b\x32\x0f.Block.VerticalH\x00\x12\'\n\nhorizontal\x18\x02 \x01(\x0b\x32\x11.Block.HorizontalH\x00\x12\x1f\n\x06\x63olumn\x18\x03 \x01(\x0b\x32\r.Block.ColumnH\x00\x12\'\n\nexpandable\x18\x04 \x01(\x0b\x32\x11.Block.ExpandableH\x00\x12\x1b\n\x04\x66orm\x18\x05 \x01(\x0b\x32\x0b.Block.FormH\x00\x12,\n\rtab_container\x18\x06 \x01(\x0b\x32\x13.Block.TabContainerH\x00\x12\x19\n\x03tab\x18\x07 \x01(\x0b\x32\n.Block.TabH\x00\x12*\n\x0c\x63hat_message\x18\t \x01(\x0b\x32\x12.Block.ChatMessageH\x00\x12!\n\x07popover\x18\n \x01(\x0b\x32\x0e.Block.PopoverH\x00\x12\x1f\n\x06\x64ialog\x18\x0b \x01(\x0b\x32\r.Block.DialogH\x00\x12\x13\n\x0b\x61llow_empty\x18\x08 \x01(\x08\x12\x0f\n\x02id\x18\x0c \x01(\tH\x01\x88\x01\x01\x1a*\n\x08Vertical\x12\x0e\n\x06\x62order\x18\x01 \x01(\x08\x12\x0e\n\x06height\x18\x02 \x01(\r\x1a\x19\n\nHorizontal\x12\x0b\n\x03gap\x18\x01 \x01(\t\x1a\xad\x01\n\x06\x43olumn\x12\x0e\n\x06weight\x18\x01 \x01(\x01\x12\x0b\n\x03gap\x18\x02 \x01(\t\x12;\n\x12vertical_alignment\x18\x03 \x01(\x0e\x32\x1f.Block.Column.VerticalAlignment\x12\x13\n\x0bshow_border\x18\x04 \x01(\x08\"4\n\x11VerticalAlignment\x12\x07\n\x03TOP\x10\x00\x12\n\n\x06\x43\x45NTER\x10\x01\x12\n\n\x06\x42OTTOM\x10\x02\x1aM\n\nExpandable\x12\r\n\x05label\x18\x01 \x01(\t\x12\x15\n\x08\x65xpanded\x18\x02 \x01(\x08H\x00\x88\x01\x01\x12\x0c\n\x04icon\x18\x03 \x01(\tB\x0b\n\t_expanded\x1a\x9d\x01\n\x06\x44ialog\x12\r\n\x05title\x18\x01 \x01(\t\x12\x13\n\x0b\x64ismissible\x18\x02 \x01(\x08\x12(\n\x05width\x18\x03 \x01(\x0e\x32\x19.Block.Dialog.DialogWidth\x12\x14\n\x07is_open\x18\x04 \x01(\x08H\x00\x88\x01\x01\"#\n\x0b\x44ialogWidth\x12\t\n\x05SMALL\x10\x00\x12\t\n\x05LARGE\x10\x01\x42\n\n\x08_is_open\x1aY\n\x04\x46orm\x12\x0f\n\x07\x66orm_id\x18\x01 \x01(\t\x12\x17\n\x0f\x63lear_on_submit\x18\x02 \x01(\x08\x12\x0e\n\x06\x62order\x18\x03 \x01(\x08\x12\x17\n\x0f\x65nter_to_submit\x18\x04 \x01(\x08\x1a\x0e\n\x0cTabContainer\x1a\x14\n\x03Tab\x12\r\n\x05label\x18\x01 \x01(\t\x1a\x63\n\x07Popover\x12\r\n\x05label\x18\x01 \x01(\t\x12\x1b\n\x13use_container_width\x18\x02 \x01(\x08\x12\x0c\n\x04help\x18\x03 \x01(\t\x12\x10\n\x08\x64isabled\x18\x04 \x01(\x08\x12\x0c\n\x04icon\x18\x05 \x01(\t\x1a\x8d\x01\n\x0b\x43hatMessage\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06\x61vatar\x18\x02 \x01(\t\x12\x32\n\x0b\x61vatar_type\x18\x03 \x01(\x0e\x32\x1d.Block.ChatMessage.AvatarType\",\n\nAvatarType\x12\t\n\x05IMAGE\x10\x00\x12\t\n\x05\x45MOJI\x10\x01\x12\x08\n\x04ICON\x10\x02\x42\x06\n\x04typeB\x05\n\x03_idB*\n\x1c\x63om.snowflake.apps.streamlitB\nBlockProtob\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1bstreamlit/proto/Block.proto\x1a!streamlit/proto/WidthConfig.proto\x1a\"streamlit/proto/HeightConfig.proto\x1a\x1dstreamlit/proto/GapSize.proto\"\xb6\r\n\x05\x42lock\x12#\n\x08vertical\x18\x01 \x01(\x0b\x32\x0f.Block.VerticalH\x00\x12\'\n\nhorizontal\x18\x02 \x01(\x0b\x32\x11.Block.HorizontalH\x00\x12\x1f\n\x06\x63olumn\x18\x03 \x01(\x0b\x32\r.Block.ColumnH\x00\x12\'\n\nexpandable\x18\x04 \x01(\x0b\x32\x11.Block.ExpandableH\x00\x12\x1b\n\x04\x66orm\x18\x05 \x01(\x0b\x32\x0b.Block.FormH\x00\x12,\n\rtab_container\x18\x06 \x01(\x0b\x32\x13.Block.TabContainerH\x00\x12\x19\n\x03tab\x18\x07 \x01(\x0b\x32\n.Block.TabH\x00\x12*\n\x0c\x63hat_message\x18\t \x01(\x0b\x32\x12.Block.ChatMessageH\x00\x12!\n\x07popover\x18\n \x01(\x0b\x32\x0e.Block.PopoverH\x00\x12\x1f\n\x06\x64ialog\x18\x0b \x01(\x0b\x32\r.Block.DialogH\x00\x12.\n\x0e\x66lex_container\x18\r \x01(\x0b\x32\x14.Block.FlexContainerH\x00\x12\x13\n\x0b\x61llow_empty\x18\x08 \x01(\x08\x12\x0f\n\x02id\x18\x0c \x01(\tH\x01\x88\x01\x01\x1a*\n\x08Vertical\x12\x0e\n\x06\x62order\x18\x01 \x01(\x08\x12\x0e\n\x06height\x18\x02 \x01(\r\x1a\x19\n\nHorizontal\x12\x0b\n\x03gap\x18\x01 \x01(\t\x1a\xbb\x02\n\rFlexContainer\x12\x0e\n\x06\x62order\x18\x01 \x01(\x08\x12.\n\rheight_config\x18\x02 \x01(\x0b\x32\x17.streamlit.HeightConfig\x12,\n\x0cwidth_config\x18\x03 \x01(\x0b\x32\x16.streamlit.WidthConfig\x12(\n\ngap_config\x18\x04 \x01(\x0b\x32\x14.streamlit.GapConfig\x12\r\n\x05scale\x18\x05 \x01(\x02\x12\x31\n\tdirection\x18\x06 \x01(\x0e\x32\x1e.Block.FlexContainer.Direction\x12\x0c\n\x04wrap\x18\x07 \x01(\x08\"B\n\tDirection\x12\x17\n\x13\x44IRECTION_UNDEFINED\x10\x00\x12\x0c\n\x08VERTICAL\x10\x01\x12\x0e\n\nHORIZONTAL\x10\x02\x1a\xef\x01\n\x06\x43olumn\x12\x0e\n\x06weight\x18\x01 \x01(\x01\x12\x0f\n\x03gap\x18\x02 \x01(\tB\x02\x18\x01\x12;\n\x12vertical_alignment\x18\x03 \x01(\x0e\x32\x1f.Block.Column.VerticalAlignment\x12\x13\n\x0bshow_border\x18\x04 \x01(\x08\x12-\n\ngap_config\x18\x05 \x01(\x0b\x32\x14.streamlit.GapConfigH\x00\x88\x01\x01\"4\n\x11VerticalAlignment\x12\x07\n\x03TOP\x10\x00\x12\n\n\x06\x43\x45NTER\x10\x01\x12\n\n\x06\x42OTTOM\x10\x02\x42\r\n\x0b_gap_config\x1aM\n\nExpandable\x12\r\n\x05label\x18\x01 \x01(\t\x12\x15\n\x08\x65xpanded\x18\x02 \x01(\x08H\x00\x88\x01\x01\x12\x0c\n\x04icon\x18\x03 \x01(\tB\x0b\n\t_expanded\x1a\x9d\x01\n\x06\x44ialog\x12\r\n\x05title\x18\x01 \x01(\t\x12\x13\n\x0b\x64ismissible\x18\x02 \x01(\x08\x12(\n\x05width\x18\x03 \x01(\x0e\x32\x19.Block.Dialog.DialogWidth\x12\x14\n\x07is_open\x18\x04 \x01(\x08H\x00\x88\x01\x01\"#\n\x0b\x44ialogWidth\x12\t\n\x05SMALL\x10\x00\x12\t\n\x05LARGE\x10\x01\x42\n\n\x08_is_open\x1aY\n\x04\x46orm\x12\x0f\n\x07\x66orm_id\x18\x01 \x01(\t\x12\x17\n\x0f\x63lear_on_submit\x18\x02 \x01(\x08\x12\x0e\n\x06\x62order\x18\x03 \x01(\x08\x12\x17\n\x0f\x65nter_to_submit\x18\x04 \x01(\x08\x1a\x0e\n\x0cTabContainer\x1a\x14\n\x03Tab\x12\r\n\x05label\x18\x01 \x01(\t\x1a\x63\n\x07Popover\x12\r\n\x05label\x18\x01 \x01(\t\x12\x1b\n\x13use_container_width\x18\x02 \x01(\x08\x12\x0c\n\x04help\x18\x03 \x01(\t\x12\x10\n\x08\x64isabled\x18\x04 \x01(\x08\x12\x0c\n\x04icon\x18\x05 \x01(\t\x1a\x8d\x01\n\x0b\x43hatMessage\x12\x0c\n\x04name\x18\x01 \x01(\t\x12\x0e\n\x06\x61vatar\x18\x02 \x01(\t\x12\x32\n\x0b\x61vatar_type\x18\x03 \x01(\x0e\x32\x1d.Block.ChatMessage.AvatarType\",\n\nAvatarType\x12\t\n\x05IMAGE\x10\x00\x12\t\n\x05\x45MOJI\x10\x01\x12\x08\n\x04ICON\x10\x02\x42\x06\n\x04typeB\x05\n\x03_idB*\n\x1c\x63om.snowflake.apps.streamlitB\nBlockProtob\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -22,32 +25,38 @@ _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'streamlit.proto.Block_pb2',
 if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
   _globals['DESCRIPTOR']._serialized_options = b'\n\034com.snowflake.apps.streamlitB\nBlockProto'
-  _globals['_BLOCK']._serialized_start=32
-  _globals['_BLOCK']._serialized_end=1318
-  _globals['_BLOCK_VERTICAL']._serialized_start=445
-  _globals['_BLOCK_VERTICAL']._serialized_end=487
-  _globals['_BLOCK_HORIZONTAL']._serialized_start=489
-  _globals['_BLOCK_HORIZONTAL']._serialized_end=514
-  _globals['_BLOCK_COLUMN']._serialized_start=517
-  _globals['_BLOCK_COLUMN']._serialized_end=690
-  _globals['_BLOCK_COLUMN_VERTICALALIGNMENT']._serialized_start=638
-  _globals['_BLOCK_COLUMN_VERTICALALIGNMENT']._serialized_end=690
-  _globals['_BLOCK_EXPANDABLE']._serialized_start=692
-  _globals['_BLOCK_EXPANDABLE']._serialized_end=769
-  _globals['_BLOCK_DIALOG']._serialized_start=772
-  _globals['_BLOCK_DIALOG']._serialized_end=929
-  _globals['_BLOCK_DIALOG_DIALOGWIDTH']._serialized_start=882
-  _globals['_BLOCK_DIALOG_DIALOGWIDTH']._serialized_end=917
-  _globals['_BLOCK_FORM']._serialized_start=931
-  _globals['_BLOCK_FORM']._serialized_end=1020
-  _globals['_BLOCK_TABCONTAINER']._serialized_start=1022
-  _globals['_BLOCK_TABCONTAINER']._serialized_end=1036
-  _globals['_BLOCK_TAB']._serialized_start=1038
-  _globals['_BLOCK_TAB']._serialized_end=1058
-  _globals['_BLOCK_POPOVER']._serialized_start=1060
-  _globals['_BLOCK_POPOVER']._serialized_end=1159
-  _globals['_BLOCK_CHATMESSAGE']._serialized_start=1162
-  _globals['_BLOCK_CHATMESSAGE']._serialized_end=1303
-  _globals['_BLOCK_CHATMESSAGE_AVATARTYPE']._serialized_start=1259
-  _globals['_BLOCK_CHATMESSAGE_AVATARTYPE']._serialized_end=1303
+  _globals['_BLOCK_COLUMN'].fields_by_name['gap']._loaded_options = None
+  _globals['_BLOCK_COLUMN'].fields_by_name['gap']._serialized_options = b'\030\001'
+  _globals['_BLOCK']._serialized_start=134
+  _globals['_BLOCK']._serialized_end=1852
+  _globals['_BLOCK_VERTICAL']._serialized_start=595
+  _globals['_BLOCK_VERTICAL']._serialized_end=637
+  _globals['_BLOCK_HORIZONTAL']._serialized_start=639
+  _globals['_BLOCK_HORIZONTAL']._serialized_end=664
+  _globals['_BLOCK_FLEXCONTAINER']._serialized_start=667
+  _globals['_BLOCK_FLEXCONTAINER']._serialized_end=982
+  _globals['_BLOCK_FLEXCONTAINER_DIRECTION']._serialized_start=916
+  _globals['_BLOCK_FLEXCONTAINER_DIRECTION']._serialized_end=982
+  _globals['_BLOCK_COLUMN']._serialized_start=985
+  _globals['_BLOCK_COLUMN']._serialized_end=1224
+  _globals['_BLOCK_COLUMN_VERTICALALIGNMENT']._serialized_start=1157
+  _globals['_BLOCK_COLUMN_VERTICALALIGNMENT']._serialized_end=1209
+  _globals['_BLOCK_EXPANDABLE']._serialized_start=1226
+  _globals['_BLOCK_EXPANDABLE']._serialized_end=1303
+  _globals['_BLOCK_DIALOG']._serialized_start=1306
+  _globals['_BLOCK_DIALOG']._serialized_end=1463
+  _globals['_BLOCK_DIALOG_DIALOGWIDTH']._serialized_start=1416
+  _globals['_BLOCK_DIALOG_DIALOGWIDTH']._serialized_end=1451
+  _globals['_BLOCK_FORM']._serialized_start=1465
+  _globals['_BLOCK_FORM']._serialized_end=1554
+  _globals['_BLOCK_TABCONTAINER']._serialized_start=1556
+  _globals['_BLOCK_TABCONTAINER']._serialized_end=1570
+  _globals['_BLOCK_TAB']._serialized_start=1572
+  _globals['_BLOCK_TAB']._serialized_end=1592
+  _globals['_BLOCK_POPOVER']._serialized_start=1594
+  _globals['_BLOCK_POPOVER']._serialized_end=1693
+  _globals['_BLOCK_CHATMESSAGE']._serialized_start=1696
+  _globals['_BLOCK_CHATMESSAGE']._serialized_end=1837
+  _globals['_BLOCK_CHATMESSAGE_AVATARTYPE']._serialized_start=1793
+  _globals['_BLOCK_CHATMESSAGE_AVATARTYPE']._serialized_end=1837
 # @@protoc_insertion_point(module_scope)

streamlit/proto/Block_pb2.pyi

@@ -21,6 +21,9 @@ import builtins
 import google.protobuf.descriptor
 import google.protobuf.internal.enum_type_wrapper
 import google.protobuf.message
+import streamlit.proto.GapSize_pb2
+import streamlit.proto.HeightConfig_pb2
+import streamlit.proto.WidthConfig_pb2
 import sys
 import typing
 
@@ -65,6 +68,56 @@ class Block(google.protobuf.message.Message):
         ) -> None: ...
         def ClearField(self, field_name: typing.Literal["gap", b"gap"]) -> None: ...
 
+    @typing.final
+    class FlexContainer(google.protobuf.message.Message):
+        DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+        class _Direction:
+            ValueType = typing.NewType("ValueType", builtins.int)
+            V: typing_extensions.TypeAlias = ValueType
+
+        class _DirectionEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[Block.FlexContainer._Direction.ValueType], builtins.type):
+            DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+            DIRECTION_UNDEFINED: Block.FlexContainer._Direction.ValueType  # 0
+            VERTICAL: Block.FlexContainer._Direction.ValueType  # 1
+            HORIZONTAL: Block.FlexContainer._Direction.ValueType  # 2
+
+        class Direction(_Direction, metaclass=_DirectionEnumTypeWrapper): ...
+        DIRECTION_UNDEFINED: Block.FlexContainer.Direction.ValueType  # 0
+        VERTICAL: Block.FlexContainer.Direction.ValueType  # 1
+        HORIZONTAL: Block.FlexContainer.Direction.ValueType  # 2
+
+        BORDER_FIELD_NUMBER: builtins.int
+        HEIGHT_CONFIG_FIELD_NUMBER: builtins.int
+        WIDTH_CONFIG_FIELD_NUMBER: builtins.int
+        GAP_CONFIG_FIELD_NUMBER: builtins.int
+        SCALE_FIELD_NUMBER: builtins.int
+        DIRECTION_FIELD_NUMBER: builtins.int
+        WRAP_FIELD_NUMBER: builtins.int
+        border: builtins.bool
+        scale: builtins.float
+        direction: global___Block.FlexContainer.Direction.ValueType
+        wrap: builtins.bool
+        @property
+        def height_config(self) -> streamlit.proto.HeightConfig_pb2.HeightConfig: ...
+        @property
+        def width_config(self) -> streamlit.proto.WidthConfig_pb2.WidthConfig: ...
+        @property
+        def gap_config(self) -> streamlit.proto.GapSize_pb2.GapConfig: ...
+        def __init__(
+            self,
+            *,
+            border: builtins.bool = ...,
+            height_config: streamlit.proto.HeightConfig_pb2.HeightConfig | None = ...,
+            width_config: streamlit.proto.WidthConfig_pb2.WidthConfig | None = ...,
+            gap_config: streamlit.proto.GapSize_pb2.GapConfig | None = ...,
+            scale: builtins.float = ...,
+            direction: global___Block.FlexContainer.Direction.ValueType = ...,
+            wrap: builtins.bool = ...,
+        ) -> None: ...
+        def HasField(self, field_name: typing.Literal["gap_config", b"gap_config", "height_config", b"height_config", "width_config", b"width_config"]) -> builtins.bool: ...
+        def ClearField(self, field_name: typing.Literal["border", b"border", "direction", b"direction", "gap_config", b"gap_config", "height_config", b"height_config", "scale", b"scale", "width_config", b"width_config", "wrap", b"wrap"]) -> None: ...
+
     @typing.final
     class Column(google.protobuf.message.Message):
         DESCRIPTOR: google.protobuf.descriptor.Descriptor
@@ -88,10 +141,14 @@ class Block(google.protobuf.message.Message):
         GAP_FIELD_NUMBER: builtins.int
         VERTICAL_ALIGNMENT_FIELD_NUMBER: builtins.int
         SHOW_BORDER_FIELD_NUMBER: builtins.int
+        GAP_CONFIG_FIELD_NUMBER: builtins.int
         weight: builtins.float
         gap: builtins.str
+        """Deprecated. Use gap_size"""
         vertical_alignment: global___Block.Column.VerticalAlignment.ValueType
         show_border: builtins.bool
+        @property
+        def gap_config(self) -> streamlit.proto.GapSize_pb2.GapConfig: ...
         def __init__(
             self,
             *,
@@ -99,8 +156,11 @@ class Block(google.protobuf.message.Message):
             gap: builtins.str = ...,
             vertical_alignment: global___Block.Column.VerticalAlignment.ValueType = ...,
             show_border: builtins.bool = ...,
+            gap_config: streamlit.proto.GapSize_pb2.GapConfig | None = ...,
         ) -> None: ...
-        def ClearField(self, field_name: typing.Literal["gap", b"gap", "show_border", b"show_border", "vertical_alignment", b"vertical_alignment", "weight", b"weight"]) -> None: ...
+        def HasField(self, field_name: typing.Literal["_gap_config", b"_gap_config", "gap_config", b"gap_config"]) -> builtins.bool: ...
+        def ClearField(self, field_name: typing.Literal["_gap_config", b"_gap_config", "gap", b"gap", "gap_config", b"gap_config", "show_border", b"show_border", "vertical_alignment", b"vertical_alignment", "weight", b"weight"]) -> None: ...
+        def WhichOneof(self, oneof_group: typing.Literal["_gap_config", b"_gap_config"]) -> typing.Literal["gap_config"] | None: ...
 
     @typing.final
     class Expandable(google.protobuf.message.Message):
@@ -272,6 +332,7 @@ class Block(google.protobuf.message.Message):
     CHAT_MESSAGE_FIELD_NUMBER: builtins.int
     POPOVER_FIELD_NUMBER: builtins.int
     DIALOG_FIELD_NUMBER: builtins.int
+    FLEX_CONTAINER_FIELD_NUMBER: builtins.int
     ALLOW_EMPTY_FIELD_NUMBER: builtins.int
     ID_FIELD_NUMBER: builtins.int
     allow_empty: builtins.bool
@@ -296,6 +357,8 @@ class Block(google.protobuf.message.Message):
     def popover(self) -> global___Block.Popover: ...
     @property
     def dialog(self) -> global___Block.Dialog: ...
+    @property
+    def flex_container(self) -> global___Block.FlexContainer: ...
     def __init__(
         self,
         *,
@@ -309,14 +372,15 @@ class Block(google.protobuf.message.Message):
         chat_message: global___Block.ChatMessage | None = ...,
         popover: global___Block.Popover | None = ...,
         dialog: global___Block.Dialog | None = ...,
+        flex_container: global___Block.FlexContainer | None = ...,
         allow_empty: builtins.bool = ...,
         id: builtins.str | None = ...,
     ) -> None: ...
-    def HasField(self, field_name: typing.Literal["_id", b"_id", "chat_message", b"chat_message", "column", b"column", "dialog", b"dialog", "expandable", b"expandable", "form", b"form", "horizontal", b"horizontal", "id", b"id", "popover", b"popover", "tab", b"tab", "tab_container", b"tab_container", "type", b"type", "vertical", b"vertical"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing.Literal["_id", b"_id", "allow_empty", b"allow_empty", "chat_message", b"chat_message", "column", b"column", "dialog", b"dialog", "expandable", b"expandable", "form", b"form", "horizontal", b"horizontal", "id", b"id", "popover", b"popover", "tab", b"tab", "tab_container", b"tab_container", "type", b"type", "vertical", b"vertical"]) -> None: ...
+    def HasField(self, field_name: typing.Literal["_id", b"_id", "chat_message", b"chat_message", "column", b"column", "dialog", b"dialog", "expandable", b"expandable", "flex_container", b"flex_container", "form", b"form", "horizontal", b"horizontal", "id", b"id", "popover", b"popover", "tab", b"tab", "tab_container", b"tab_container", "type", b"type", "vertical", b"vertical"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["_id", b"_id", "allow_empty", b"allow_empty", "chat_message", b"chat_message", "column", b"column", "dialog", b"dialog", "expandable", b"expandable", "flex_container", b"flex_container", "form", b"form", "horizontal", b"horizontal", "id", b"id", "popover", b"popover", "tab", b"tab", "tab_container", b"tab_container", "type", b"type", "vertical", b"vertical"]) -> None: ...
     @typing.overload
     def WhichOneof(self, oneof_group: typing.Literal["_id", b"_id"]) -> typing.Literal["id"] | None: ...
     @typing.overload
-    def WhichOneof(self, oneof_group: typing.Literal["type", b"type"]) -> typing.Literal["vertical", "horizontal", "column", "expandable", "form", "tab_container", "tab", "chat_message", "popover", "dialog"] | None: ...
+    def WhichOneof(self, oneof_group: typing.Literal["type", b"type"]) -> typing.Literal["vertical", "horizontal", "column", "expandable", "form", "tab_container", "tab", "chat_message", "popover", "dialog", "flex_container"] | None: ...
 
 global___Block = Block

streamlit/proto/DataFrame_pb2.pyi

@@ -29,7 +29,7 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class DataFrame(google.protobuf.message.Message):
-    """DEPRECATED: This proto message is deprecated and unsused. Use Arrow.proto instead.
+    """DEPRECATED: This proto message is deprecated and unused. Use Arrow.proto instead.
     Represents a pandas DataFrame.
     """
 

streamlit/proto/GapSize_pb2.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: streamlit/proto/GapSize.proto
+# Protobuf Python Version: 5.26.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x1dstreamlit/proto/GapSize.proto\x12\tstreamlit\"?\n\tGapConfig\x12&\n\x08gap_size\x18\x01 \x01(\x0e\x32\x12.streamlit.GapSizeH\x00\x42\n\n\x08gap_spec*H\n\x07GapSize\x12\x11\n\rGAP_UNDEFINED\x10\x00\x12\t\n\x05SMALL\x10\x01\x12\n\n\x06MEDIUM\x10\x02\x12\t\n\x05LARGE\x10\x03\x12\x08\n\x04NONE\x10\x04\x42,\n\x1c\x63om.snowflake.apps.streamlitB\x0cGapSizeProtob\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'streamlit.proto.GapSize_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\034com.snowflake.apps.streamlitB\014GapSizeProto'
+  _globals['_GAPSIZE']._serialized_start=109
+  _globals['_GAPSIZE']._serialized_end=181
+  _globals['_GAPCONFIG']._serialized_start=44
+  _globals['_GAPCONFIG']._serialized_end=107
+# @@protoc_insertion_point(module_scope)

streamlit/proto/GapSize_pb2.pyi

@@ -0,0 +1,70 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+*!
+Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+import builtins
+import google.protobuf.descriptor
+import google.protobuf.internal.enum_type_wrapper
+import google.protobuf.message
+import sys
+import typing
+
+if sys.version_info >= (3, 10):
+    import typing as typing_extensions
+else:
+    import typing_extensions
+
+DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
+
+class _GapSize:
+    ValueType = typing.NewType("ValueType", builtins.int)
+    V: typing_extensions.TypeAlias = ValueType
+
+class _GapSizeEnumTypeWrapper(google.protobuf.internal.enum_type_wrapper._EnumTypeWrapper[_GapSize.ValueType], builtins.type):
+    DESCRIPTOR: google.protobuf.descriptor.EnumDescriptor
+    GAP_UNDEFINED: _GapSize.ValueType  # 0
+    SMALL: _GapSize.ValueType  # 1
+    MEDIUM: _GapSize.ValueType  # 2
+    LARGE: _GapSize.ValueType  # 3
+    NONE: _GapSize.ValueType  # 4
+
+class GapSize(_GapSize, metaclass=_GapSizeEnumTypeWrapper): ...
+
+GAP_UNDEFINED: GapSize.ValueType  # 0
+SMALL: GapSize.ValueType  # 1
+MEDIUM: GapSize.ValueType  # 2
+LARGE: GapSize.ValueType  # 3
+NONE: GapSize.ValueType  # 4
+global___GapSize = GapSize
+
+@typing.final
+class GapConfig(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    GAP_SIZE_FIELD_NUMBER: builtins.int
+    gap_size: global___GapSize.ValueType
+    def __init__(
+        self,
+        *,
+        gap_size: global___GapSize.ValueType = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["gap_size", b"gap_size", "gap_spec", b"gap_spec"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["gap_size", b"gap_size", "gap_spec", b"gap_spec"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing.Literal["gap_spec", b"gap_spec"]) -> typing.Literal["gap_size"] | None: ...
+
+global___GapConfig = GapConfig

streamlit/proto/HeightConfig_pb2.py

@@ -0,0 +1,27 @@
+# -*- coding: utf-8 -*-
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: streamlit/proto/HeightConfig.proto
+# Protobuf Python Version: 5.26.1
+"""Generated protocol buffer code."""
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import descriptor_pool as _descriptor_pool
+from google.protobuf import symbol_database as _symbol_database
+from google.protobuf.internal import builder as _builder
+# @@protoc_insertion_point(imports)
+
+_sym_db = _symbol_database.Default()
+
+
+
+
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\"streamlit/proto/HeightConfig.proto\x12\tstreamlit\"c\n\x0cHeightConfig\x12\x15\n\x0buse_stretch\x18\x01 \x01(\x08H\x00\x12\x15\n\x0buse_content\x18\x02 \x01(\x08H\x00\x12\x16\n\x0cpixel_height\x18\x03 \x01(\rH\x00\x42\r\n\x0bheight_specB1\n\x1c\x63om.snowflake.apps.streamlitB\x11HeightConfigProtob\x06proto3')
+
+_globals = globals()
+_builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
+_builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'streamlit.proto.HeightConfig_pb2', _globals)
+if not _descriptor._USE_C_DESCRIPTORS:
+  _globals['DESCRIPTOR']._loaded_options = None
+  _globals['DESCRIPTOR']._serialized_options = b'\n\034com.snowflake.apps.streamlitB\021HeightConfigProto'
+  _globals['_HEIGHTCONFIG']._serialized_start=49
+  _globals['_HEIGHTCONFIG']._serialized_end=148
+# @@protoc_insertion_point(module_scope)

streamlit/proto/HeightConfig_pb2.pyi

@@ -0,0 +1,48 @@
+"""
+@generated by mypy-protobuf.  Do not edit manually!
+isort:skip_file
+*!
+Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
+
+import builtins
+import google.protobuf.descriptor
+import google.protobuf.message
+import typing
+
+DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
+
+@typing.final
+class HeightConfig(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    USE_STRETCH_FIELD_NUMBER: builtins.int
+    USE_CONTENT_FIELD_NUMBER: builtins.int
+    PIXEL_HEIGHT_FIELD_NUMBER: builtins.int
+    use_stretch: builtins.bool
+    use_content: builtins.bool
+    pixel_height: builtins.int
+    def __init__(
+        self,
+        *,
+        use_stretch: builtins.bool = ...,
+        use_content: builtins.bool = ...,
+        pixel_height: builtins.int = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["height_spec", b"height_spec", "pixel_height", b"pixel_height", "use_content", b"use_content", "use_stretch", b"use_stretch"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["height_spec", b"height_spec", "pixel_height", b"pixel_height", "use_content", b"use_content", "use_stretch", b"use_stretch"]) -> None: ...
+    def WhichOneof(self, oneof_group: typing.Literal["height_spec", b"height_spec"]) -> typing.Literal["use_stretch", "use_content", "pixel_height"] | None: ...
+
+global___HeightConfig = HeightConfig

streamlit/proto/NamedDataSet_pb2.pyi

@@ -27,7 +27,7 @@ DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
 @typing.final
 class NamedDataSet(google.protobuf.message.Message):
-    """DEPRECATED: This proto message is deprecated and unsused.
+    """DEPRECATED: This proto message is deprecated and unused.
     A dataset that can be referenced by name.
     """
 

streamlit/proto/WidthConfig_pb2.py

@@ -14,14 +14,14 @@ _sym_db = _symbol_database.Default()
 
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!streamlit/proto/WidthConfig.proto\x12\tstreamlit\"`\n\x0bWidthConfig\x12\x15\n\x0buse_stretch\x18\x01 \x01(\x08H\x00\x12\x15\n\x0buse_content\x18\x02 \x01(\x08H\x00\x12\x15\n\x0bpixel_width\x18\x03 \x01(\rH\x00\x42\x0c\n\nwidth_specB+\n\x1c\x63om.snowflake.apps.streamlitB\x0bLayoutProtob\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!streamlit/proto/WidthConfig.proto\x12\tstreamlit\"`\n\x0bWidthConfig\x12\x15\n\x0buse_stretch\x18\x01 \x01(\x08H\x00\x12\x15\n\x0buse_content\x18\x02 \x01(\x08H\x00\x12\x15\n\x0bpixel_width\x18\x03 \x01(\rH\x00\x42\x0c\n\nwidth_specB0\n\x1c\x63om.snowflake.apps.streamlitB\x10WidthConfigProtob\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'streamlit.proto.WidthConfig_pb2', _globals)
 if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
-  _globals['DESCRIPTOR']._serialized_options = b'\n\034com.snowflake.apps.streamlitB\013LayoutProto'
+  _globals['DESCRIPTOR']._serialized_options = b'\n\034com.snowflake.apps.streamlitB\020WidthConfigProto'
   _globals['_WIDTHCONFIG']._serialized_start=48
   _globals['_WIDTHCONFIG']._serialized_end=144
 # @@protoc_insertion_point(module_scope)

streamlit/proto/WidthConfig_pb2.pyi

@@ -1,7 +1,21 @@
 """
 @generated by mypy-protobuf.  Do not edit manually!
 isort:skip_file
-Common layout-related enums and messages that can be reused across different elements."""
+*!
+Copyright (c) Streamlit Inc. (2018-2022) Snowflake Inc. (2022-2025)
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+"""
 
 import builtins
 import google.protobuf.descriptor

streamlit/runtime/app_session.py

@@ -20,7 +20,7 @@ import os
 import sys
 import uuid
 from enum import Enum
-from typing import TYPE_CHECKING, Callable, Final
+from typing import TYPE_CHECKING, Any, Callable, Final
 
 from google.protobuf.json_format import ParseDict
 
@@ -480,7 +480,7 @@ class AppSession:
         else:
             self._enqueue_forward_msg(self._create_file_change_message())
 
-    def _on_secrets_file_changed(self, _) -> None:
+    def _on_secrets_file_changed(self, _: Any) -> None:
         """Called when `secrets.file_change_listener` emits a Signal."""
 
         # NOTE: At the time of writing, this function only calls

streamlit/runtime/caching/cache_data_api.py

@@ -83,6 +83,10 @@ CachePersistType: TypeAlias = Union[Literal["disk"], None]
 class CachedDataFuncInfo(CachedFuncInfo):
     """Implements the CachedFuncInfo interface for @st.cache_data."""
 
+    persist: CachePersistType
+    max_entries: int | None
+    ttl: float | timedelta | str | None
+
     def __init__(
         self,
         func: types.FunctionType,
@@ -91,7 +95,7 @@ class CachedDataFuncInfo(CachedFuncInfo):
         max_entries: int | None,
         ttl: float | timedelta | str | None,
         hash_funcs: HashFuncsDict | None = None,
-    ):
+    ) -> None:
         super().__init__(
             func,
             show_spinner=show_spinner,
@@ -317,7 +321,7 @@ class CacheDataAPI:
     st.cache_data.clear().
     """
 
-    def __init__(self, decorator_metric_name: str):
+    def __init__(self, decorator_metric_name: str) -> None:
         """Create a CacheDataAPI instance.
 
         Parameters
@@ -363,7 +367,7 @@ class CacheDataAPI:
         persist: CachePersistType | bool = None,
         experimental_allow_widgets: bool = False,
         hash_funcs: HashFuncsDict | None = None,
-    ):
+    ) -> F | Callable[[F], F]:
         return self._decorator(
             func,
             ttl=ttl,
@@ -384,7 +388,7 @@ class CacheDataAPI:
         persist: CachePersistType | bool,
         experimental_allow_widgets: bool,
         hash_funcs: HashFuncsDict | None = None,
-    ):
+    ) -> F | Callable[[F], F]:
         """Decorator to cache functions that return data (e.g. dataframe transforms, database queries, ML inference).
 
         Cached objects are stored in "pickled" form, which means that the return
@@ -605,7 +609,7 @@ class DataCache(Cache):
         max_entries: int | None,
         ttl_seconds: float | None,
         display_name: str,
-    ):
+    ) -> None:
         super().__init__()
         self.key = key
         self.display_name = display_name