streamlit-nightly 1.42.3.dev20250225__py2.py3-none-any.whl → 1.42.3.dev20250226__py2.py3-none-any.whl

streamlit/config.py

@@ -1021,6 +1021,7 @@ _create_option(
 _create_option(
     "theme.linkColor",
     description="Color used for all links.",
+    visibility="hidden",
 )
 
 _create_option(
@@ -1038,6 +1039,7 @@ _create_option(
         The font family to use for code (monospace) in the app.
         To use a custom font, it needs to be added via [theme.fontFaces].
     """,
+    visibility="hidden",
 )
 
 _create_option(
@@ -1045,16 +1047,18 @@ _create_option(
     description="""
     Configure a list of font faces that you can use for the app & code fonts.
 """,
+    visibility="hidden",
 )
 
 
 _create_option(
-    "theme.roundness",
+    "theme.baseRadius",
     description="""
-        The roundness of the corners for most UI elements. Can be between 0 and 1,
-        where 0 is no-roundness and 1 is maximum roundness.
+        The radius used as basis for the corners of most UI elements. Can be:
+        "none", "small", "medium", "large", "full", or the number in pixel or rem.
+        For example: "10px", "0.5rem", "1.2rem", "2rem".
     """,
-    type_=float,
+    visibility="hidden",
 )
 
 _create_option(
@@ -1062,6 +1066,7 @@ _create_option(
     description="""
         The color of the border around elements.
     """,
+    visibility="hidden",
 )
 
 _create_option(
@@ -1071,6 +1076,7 @@ _create_option(
         file_uploader, etc).
     """,
     type_=bool,
+    visibility="hidden",
 )
 
 _create_option(
@@ -1080,6 +1086,7 @@ _create_option(
         scale of text and UI elements. The default base font size is 16.
     """,
     type_=int,
+    visibility="hidden",
 )
 
 # Config Section: Secrets #

streamlit/elements/widgets/chat.py

@@ -374,9 +374,9 @@ class ChatMixin:
         Parameters
         ----------
         placeholder : str
-            A placeholder text shown when the chat input is empty. Defaults to
-            "Your message". For accessibility reasons, you should not use an
-            empty string.
+            A placeholder text shown when the chat input is empty. This
+            defaults to ``"Your message"``. For accessibility reasons, you
+            should not use an empty string.
 
         key : str or int
             An optional string or integer to use as the unique key for the widget.
@@ -384,19 +384,44 @@ class ChatMixin:
             its content. No two widgets may have the same key.
 
         max_chars : int or None
-            The maximum number of characters that can be entered. If ``None``
-            (default), there will be no maximum.
+            The maximum number of characters that can be entered. If this is
+            ``None`` (default), there will be no maximum.
 
-        accept_file : bool | str
-            Whether the chat input should accept files. ``True`` to accept a single
-            file, ``"multiple"`` to accept multiple files.
+        accept_file : bool or str
+            Whether the chat input should accept files. This can be one of the
+            following values:
 
-        disabled : bool
-            Whether the chat input should be disabled. Defaults to ``False``.
+            - ``False`` (default): No files are accepted and the user can only
+              submit a message.
+            - ``True``: The user can add a single file to their submission.
+            - ``"multiple"``: The user can add multiple files to their
+              submission.
+
+            When the widget is configured to accept files, the accepted file
+            types can be configured with the ``file_type`` parameter.
+
+            By default, uploaded files are limited to 200 MB each. You can
+            configure this using the ``server.maxUploadSize`` config option.
+            For more information on how to set config options, see
+            |config.toml|_.
+
+            .. |config.toml| replace:: ``config.toml``
+            .. _config.toml: https://docs.streamlit.io/develop/api-reference/configuration/config.toml
+
+        file_type : str, Sequence[str], or None
+            The allowed file extension(s) for uploaded files. This can be one
+            of the following types:
 
-        file_type : str or list[str] or None
-            Array of allowed extensions. ['png', 'jpg']
-            The default is None, which means all extensions are allowed.
+            - ``None`` (default): All file extensions are allowed.
+            - A string: A single file extension is allowed. For example, to
+              only accept CSV files, use ``"csv"``.
+            - A sequence of strings: Multiple file extensions are allowed. For
+              example, to only accept JPG/JPEG and PNG files, use
+              ``["jpg", "jpeg", "png"]``.
+
+        disabled : bool
+            Whether the chat input should be disabled. This defaults to
+            ``False``.
 
         on_submit : callable
             An optional callback invoked when the chat input's value is submitted.
@@ -409,12 +434,41 @@ class ChatMixin:
 
         Returns
         -------
-        str or None
-            The current (non-empty) value of the text input widget on the last
-            run of the app. Otherwise, ``None``.
+        None, str, or dict-like
+            The user's submission. This is one of the following types:
+
+            - ``None``: If the user didn't submit a message or file in the last
+              rerun, the widget returns ``None``.
+            - A string: When the widget is not configured to accept files and
+              the user submitted a message in the last rerun, the widget
+              returns the user's message as a string.
+            - A dict-like object: When the widget is configured to accept files
+              and the user submitted a message and/or file(s) in the last
+              rerun, the widget returns a dict-like object with two attributes,
+              ``text`` and ``files``.
+
+            When the widget is configured to accept files and the user submits
+            something in the last rerun, you can access the user's submission
+            with key or attribute notation from the dict-like object. This is
+            shown in Example 3 below.
+
+            The ``text`` attribute holds a string, which is the user's message.
+            This is an empty string if the user only submitted one or more
+            files.
+
+            The ``files`` attribute holds a list of UploadedFile objects.
+            The list is empty if the user only submitted a message. Unlike
+            ``st.file_uploader``, this attribute always returns a list, even
+            when the widget is configured to accept only one file at a time.
+
+            The UploadedFile class is a subclass of BytesIO, and therefore is
+            "file-like". This means you can pass an instance of it anywhere a
+            file is expected.
 
         Examples
         --------
+        **Example 1: Pin the the chat input widget to the bottom of your app**
+
         When ``st.chat_input`` is used in the main body of an app, it will be
         pinned to the bottom of the page.
 
@@ -428,9 +482,11 @@ class ChatMixin:
             https://doc-chat-input.streamlit.app/
             height: 350px
 
+        **Example 2: Use the chat input widget inline**
+
         The chat input can also be used inline by nesting it inside any layout
         container (container, columns, tabs, sidebar, etc) or fragment. Create
-        chat interfaces embedded next to other content or have multiple
+        chat interfaces embedded next to other content, or have multiple
         chatbots!
 
         >>> import streamlit as st
@@ -444,6 +500,32 @@ class ChatMixin:
         .. output ::
             https://doc-chat-input-inline.streamlit.app/
             height: 350px
+
+        **Example 3: Let users upload files**
+
+        When you configure your chat input widget to allow file attachments, it
+        will return a dict-like object when the user sends a submission. You
+        can access the user's message through the ``text`` attribute of this
+        dictionary. You can access a list of the user's submitted file(s)
+        through the ``files`` attribute. Similar to ``st.session_state``, you
+        can use key or attribute notation.
+
+        >>> import streamlit as st
+        >>>
+        >>> prompt = st.chat_input(
+        >>>     "Say something and/or attach an image",
+        >>>     accept_file=True,
+        >>>     file_type=["jpg", "jpeg", "png"],
+        >>> )
+        >>> if prompt and prompt.text:
+        >>>     st.markdown(prompt.text)
+        >>> if prompt and prompt["files"]:
+        >>>     st.image(prompt["files"][0])
+
+        .. output ::
+            https://doc-chat-input-file-uploader.streamlit.app/
+            height: 350px
+
         """
         # We default to an empty string here and disallow user choice intentionally
         default = ""

streamlit/elements/widgets/file_uploader.py

@@ -235,10 +235,12 @@ class FileUploaderMixin:
         label_visibility: LabelVisibility = "visible",
     ) -> UploadedFile | list[UploadedFile] | None:
         r"""Display a file uploader widget.
-        By default, uploaded files are limited to 200MB. You can configure
-        this using the ``server.maxUploadSize`` config option. For more info
-        on how to set config options, see
-        https://docs.streamlit.io/develop/api-reference/configuration/config.toml
+        By default, uploaded files are limited to 200 MB each. You can
+        configure this using the ``server.maxUploadSize`` config option. For
+        more information on how to set config options, see |config.toml|_.
+
+        .. |config.toml| replace:: ``config.toml``
+        .. _config.toml: https://docs.streamlit.io/develop/api-reference/configuration/config.toml
 
         Parameters
         ----------
@@ -265,13 +267,21 @@ class FileUploaderMixin:
             .. _st.markdown: https://docs.streamlit.io/develop/api-reference/text/st.markdown
 
         type : str or list of str or None
-            Array of allowed extensions. ['png', 'jpg']
-            The default is None, which means all extensions are allowed.
+            The allowed file extension(s) for uploaded files. This can be one
+            of the following types:
+
+            - ``None`` (default): All file extensions are allowed.
+            - A string: A single file extension is allowed. For example, to
+              only accept CSV files, use ``"csv"``.
+            - A sequence of strings: Multiple file extensions are allowed. For
+              example, to only accept JPG/JPEG and PNG files, use
+              ``["jpg", "jpeg", "png"]``.
 
         accept_multiple_files : bool
-            If True, allows the user to upload multiple files at the same time,
-            in which case the return value will be a list of files.
-            Default: False
+            Whether to accept more than one file in a submission. If this is
+            ``False`` (default), the user can only submit one file at a time.
+            If this is ``True``, the user can upload multiple files at the same
+            time, in which case the return value will be a list of files.
 
         key : str or int
             An optional string or integer to use as the unique key for the widget.
@@ -309,7 +319,7 @@ class FileUploaderMixin:
 
         Returns
         -------
-        None or UploadedFile or list of UploadedFile
+        None, UploadedFile, or list of UploadedFile
             - If accept_multiple_files is False, returns either None or
               an UploadedFile object.
             - If accept_multiple_files is True, returns a list with the

streamlit/proto/ClientState_pb2.py

@@ -15,7 +15,7 @@ _sym_db = _symbol_database.Default()
 from streamlit.proto import WidgetStates_pb2 as streamlit_dot_proto_dot_WidgetStates__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!streamlit/proto/ClientState.proto\x1a\"streamlit/proto/WidgetStates.proto\"\xa2\x01\n\x0b\x43lientState\x12\x14\n\x0cquery_string\x18\x01 \x01(\t\x12$\n\rwidget_states\x18\x02 \x01(\x0b\x32\r.WidgetStates\x12\x18\n\x10page_script_hash\x18\x03 \x01(\t\x12\x11\n\tpage_name\x18\x04 \x01(\t\x12\x13\n\x0b\x66ragment_id\x18\x05 \x01(\t\x12\x15\n\ris_auto_rerun\x18\x06 \x01(\x08\x42\x30\n\x1c\x63om.snowflake.apps.streamlitB\x10\x43lientStateProtob\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n!streamlit/proto/ClientState.proto\x1a\"streamlit/proto/WidgetStates.proto\"c\n\x0b\x43ontextInfo\x12\x15\n\x08timezone\x18\x01 \x01(\tH\x00\x88\x01\x01\x12\x1c\n\x0ftimezone_offset\x18\x02 \x01(\x05H\x01\x88\x01\x01\x42\x0b\n\t_timezoneB\x12\n\x10_timezone_offset\"\xc6\x01\n\x0b\x43lientState\x12\x14\n\x0cquery_string\x18\x01 \x01(\t\x12$\n\rwidget_states\x18\x02 \x01(\x0b\x32\r.WidgetStates\x12\x18\n\x10page_script_hash\x18\x03 \x01(\t\x12\x11\n\tpage_name\x18\x04 \x01(\t\x12\x13\n\x0b\x66ragment_id\x18\x05 \x01(\t\x12\x15\n\ris_auto_rerun\x18\x06 \x01(\x08\x12\"\n\x0c\x63ontext_info\x18\x08 \x01(\x0b\x32\x0c.ContextInfoB0\n\x1c\x63om.snowflake.apps.streamlitB\x10\x43lientStateProtob\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -23,6 +23,8 @@ _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'streamlit.proto.ClientState
 if not _descriptor._USE_C_DESCRIPTORS:
   _globals['DESCRIPTOR']._loaded_options = None
   _globals['DESCRIPTOR']._serialized_options = b'\n\034com.snowflake.apps.streamlitB\020ClientStateProto'
-  _globals['_CLIENTSTATE']._serialized_start=74
-  _globals['_CLIENTSTATE']._serialized_end=236
+  _globals['_CONTEXTINFO']._serialized_start=73
+  _globals['_CONTEXTINFO']._serialized_end=172
+  _globals['_CLIENTSTATE']._serialized_start=175
+  _globals['_CLIENTSTATE']._serialized_end=373
 # @@protoc_insertion_point(module_scope)

streamlit/proto/ClientState_pb2.pyi

@@ -25,6 +25,29 @@ import typing
 
 DESCRIPTOR: google.protobuf.descriptor.FileDescriptor
 
+@typing.final
+class ContextInfo(google.protobuf.message.Message):
+    DESCRIPTOR: google.protobuf.descriptor.Descriptor
+
+    TIMEZONE_FIELD_NUMBER: builtins.int
+    TIMEZONE_OFFSET_FIELD_NUMBER: builtins.int
+    timezone: builtins.str
+    timezone_offset: builtins.int
+    def __init__(
+        self,
+        *,
+        timezone: builtins.str | None = ...,
+        timezone_offset: builtins.int | None = ...,
+    ) -> None: ...
+    def HasField(self, field_name: typing.Literal["_timezone", b"_timezone", "_timezone_offset", b"_timezone_offset", "timezone", b"timezone", "timezone_offset", b"timezone_offset"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["_timezone", b"_timezone", "_timezone_offset", b"_timezone_offset", "timezone", b"timezone", "timezone_offset", b"timezone_offset"]) -> None: ...
+    @typing.overload
+    def WhichOneof(self, oneof_group: typing.Literal["_timezone", b"_timezone"]) -> typing.Literal["timezone"] | None: ...
+    @typing.overload
+    def WhichOneof(self, oneof_group: typing.Literal["_timezone_offset", b"_timezone_offset"]) -> typing.Literal["timezone_offset"] | None: ...
+
+global___ContextInfo = ContextInfo
+
 @typing.final
 class ClientState(google.protobuf.message.Message):
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
@@ -35,6 +58,7 @@ class ClientState(google.protobuf.message.Message):
     PAGE_NAME_FIELD_NUMBER: builtins.int
     FRAGMENT_ID_FIELD_NUMBER: builtins.int
     IS_AUTO_RERUN_FIELD_NUMBER: builtins.int
+    CONTEXT_INFO_FIELD_NUMBER: builtins.int
     query_string: builtins.str
     page_script_hash: builtins.str
     page_name: builtins.str
@@ -42,6 +66,8 @@ class ClientState(google.protobuf.message.Message):
     is_auto_rerun: builtins.bool
     @property
     def widget_states(self) -> streamlit.proto.WidgetStates_pb2.WidgetStates: ...
+    @property
+    def context_info(self) -> global___ContextInfo: ...
     def __init__(
         self,
         *,
@@ -51,8 +77,9 @@ class ClientState(google.protobuf.message.Message):
         page_name: builtins.str = ...,
         fragment_id: builtins.str = ...,
         is_auto_rerun: builtins.bool = ...,
+        context_info: global___ContextInfo | None = ...,
     ) -> None: ...
-    def HasField(self, field_name: typing.Literal["widget_states", b"widget_states"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing.Literal["fragment_id", b"fragment_id", "is_auto_rerun", b"is_auto_rerun", "page_name", b"page_name", "page_script_hash", b"page_script_hash", "query_string", b"query_string", "widget_states", b"widget_states"]) -> None: ...
+    def HasField(self, field_name: typing.Literal["context_info", b"context_info", "widget_states", b"widget_states"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["context_info", b"context_info", "fragment_id", b"fragment_id", "is_auto_rerun", b"is_auto_rerun", "page_name", b"page_name", "page_script_hash", b"page_script_hash", "query_string", b"query_string", "widget_states", b"widget_states"]) -> None: ...
 
 global___ClientState = ClientState

streamlit/proto/NewSession_pb2.py

@@ -16,7 +16,7 @@ from streamlit.proto import AppPage_pb2 as streamlit_dot_proto_dot_AppPage__pb2
 from streamlit.proto import SessionStatus_pb2 as streamlit_dot_proto_dot_SessionStatus__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n streamlit/proto/NewSession.proto\x1a\x1dstreamlit/proto/AppPage.proto\x1a#streamlit/proto/SessionStatus.proto\"\xa5\x02\n\nNewSession\x12\x1f\n\ninitialize\x18\x01 \x01(\x0b\x32\x0b.Initialize\x12\x15\n\rscript_run_id\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x18\n\x10main_script_path\x18\x04 \x01(\t\x12\x17\n\x06\x63onfig\x18\x06 \x01(\x0b\x32\x07.Config\x12(\n\x0c\x63ustom_theme\x18\x07 \x01(\x0b\x32\x12.CustomThemeConfig\x12\x1b\n\tapp_pages\x18\x08 \x03(\x0b\x32\x08.AppPage\x12\x18\n\x10page_script_hash\x18\t \x01(\t\x12\x1d\n\x15\x66ragment_ids_this_run\x18\n \x03(\t\x12\x18\n\x10main_script_hash\x18\x0b \x01(\tJ\x04\x08\x05\x10\x06\"\xba\x01\n\nInitialize\x12\x1c\n\tuser_info\x18\x01 \x01(\x0b\x32\t.UserInfo\x12*\n\x10\x65nvironment_info\x18\x03 \x01(\x0b\x32\x10.EnvironmentInfo\x12&\n\x0esession_status\x18\x04 \x01(\x0b\x32\x0e.SessionStatus\x12\x14\n\x0c\x63ommand_line\x18\x05 \x01(\t\x12\x12\n\nsession_id\x18\x06 \x01(\t\x12\x10\n\x08is_hello\x18\x07 \x01(\x08\"\x97\x02\n\x06\x43onfig\x12\x1a\n\x12gather_usage_stats\x18\x02 \x01(\x08\x12\x1e\n\x16max_cached_message_age\x18\x03 \x01(\x05\x12\x14\n\x0cmapbox_token\x18\x04 \x01(\t\x12\x19\n\x11\x61llow_run_on_save\x18\x05 \x01(\x08\x12\x14\n\x0chide_top_bar\x18\x06 \x01(\x08\x12\x18\n\x10hide_sidebar_nav\x18\x07 \x01(\x08\x12)\n\x0ctoolbar_mode\x18\x08 \x01(\x0e\x32\x13.Config.ToolbarMode\"?\n\x0bToolbarMode\x12\x08\n\x04\x41UTO\x10\x00\x12\r\n\tDEVELOPER\x10\x01\x12\n\n\x06VIEWER\x10\x02\x12\x0b\n\x07MINIMAL\x10\x03J\x04\x08\x01\x10\x02\"\xfc\x05\n\x11\x43ustomThemeConfig\x12\x15\n\rprimary_color\x18\x01 \x01(\t\x12\"\n\x1asecondary_background_color\x18\x02 \x01(\t\x12\x18\n\x10\x62\x61\x63kground_color\x18\x03 \x01(\t\x12\x12\n\ntext_color\x18\x04 \x01(\t\x12+\n\x04\x66ont\x18\x05 \x01(\x0e\x32\x1d.CustomThemeConfig.FontFamily\x12*\n\x04\x62\x61se\x18\x06 \x01(\x0e\x32\x1c.CustomThemeConfig.BaseTheme\x12\x1f\n\x17widget_background_color\x18\x07 \x01(\t\x12\x1b\n\x13widget_border_color\x18\x08 \x01(\t\x12\x15\n\x05radii\x18\t \x01(\x0b\x32\x06.Radii\x12\x11\n\tbody_font\x18\r \x01(\t\x12\x11\n\tcode_font\x18\x0e \x01(\t\x12\x1d\n\nfont_faces\x18\x0f \x03(\x0b\x32\t.FontFace\x12\x1e\n\nfont_sizes\x18\x10 \x01(\x0b\x32\n.FontSizes\x12!\n\x19skeleton_background_color\x18\x11 \x01(\t\x12\x16\n\troundness\x18\x12 \x01(\x02H\x00\x88\x01\x01\x12\x19\n\x0c\x62order_color\x18\x13 \x01(\tH\x01\x88\x01\x01\x12&\n\x19show_border_around_inputs\x18\x14 \x01(\x08H\x02\x88\x01\x01\x12\x17\n\nlink_color\x18\x15 \x01(\tH\x03\x88\x01\x01\x12\x1b\n\x0e\x62\x61se_font_size\x18\x16 \x01(\x05H\x04\x88\x01\x01\" \n\tBaseTheme\x12\t\n\x05LIGHT\x10\x00\x12\x08\n\x04\x44\x41RK\x10\x01\"6\n\nFontFamily\x12\x0e\n\nSANS_SERIF\x10\x00\x12\t\n\x05SERIF\x10\x01\x12\r\n\tMONOSPACE\x10\x02\x42\x0c\n\n_roundnessB\x0f\n\r_border_colorB\x1c\n\x1a_show_border_around_inputsB\r\n\x0b_link_colorB\x11\n\x0f_base_font_size\"F\n\x08\x46ontFace\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x0e\n\x06\x66\x61mily\x18\x02 \x01(\t\x12\x0e\n\x06weight\x18\x03 \x01(\x05\x12\r\n\x05style\x18\x04 \x01(\t\"<\n\x05Radii\x12\x1a\n\x12\x62\x61se_widget_radius\x18\x01 \x01(\x05\x12\x17\n\x0f\x63heckbox_radius\x18\x02 \x01(\x05\"T\n\tFontSizes\x12\x16\n\x0etiny_font_size\x18\x01 \x01(\x05\x12\x17\n\x0fsmall_font_size\x18\x02 \x01(\x05\x12\x16\n\x0e\x62\x61se_font_size\x18\x03 \x01(\x05\"E\n\x08UserInfo\x12\x17\n\x0finstallation_id\x18\x01 \x01(\t\x12\x1a\n\x12installation_id_v3\x18\x05 \x01(\tJ\x04\x08\x02\x10\x03\"D\n\x0f\x45nvironmentInfo\x12\x19\n\x11streamlit_version\x18\x01 \x01(\t\x12\x16\n\x0epython_version\x18\x02 \x01(\tB/\n\x1c\x63om.snowflake.apps.streamlitB\x0fNewSessionProtob\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n streamlit/proto/NewSession.proto\x1a\x1dstreamlit/proto/AppPage.proto\x1a#streamlit/proto/SessionStatus.proto\"\xa5\x02\n\nNewSession\x12\x1f\n\ninitialize\x18\x01 \x01(\x0b\x32\x0b.Initialize\x12\x15\n\rscript_run_id\x18\x02 \x01(\t\x12\x0c\n\x04name\x18\x03 \x01(\t\x12\x18\n\x10main_script_path\x18\x04 \x01(\t\x12\x17\n\x06\x63onfig\x18\x06 \x01(\x0b\x32\x07.Config\x12(\n\x0c\x63ustom_theme\x18\x07 \x01(\x0b\x32\x12.CustomThemeConfig\x12\x1b\n\tapp_pages\x18\x08 \x03(\x0b\x32\x08.AppPage\x12\x18\n\x10page_script_hash\x18\t \x01(\t\x12\x1d\n\x15\x66ragment_ids_this_run\x18\n \x03(\t\x12\x18\n\x10main_script_hash\x18\x0b \x01(\tJ\x04\x08\x05\x10\x06\"\xba\x01\n\nInitialize\x12\x1c\n\tuser_info\x18\x01 \x01(\x0b\x32\t.UserInfo\x12*\n\x10\x65nvironment_info\x18\x03 \x01(\x0b\x32\x10.EnvironmentInfo\x12&\n\x0esession_status\x18\x04 \x01(\x0b\x32\x0e.SessionStatus\x12\x14\n\x0c\x63ommand_line\x18\x05 \x01(\t\x12\x12\n\nsession_id\x18\x06 \x01(\t\x12\x10\n\x08is_hello\x18\x07 \x01(\x08\"\x97\x02\n\x06\x43onfig\x12\x1a\n\x12gather_usage_stats\x18\x02 \x01(\x08\x12\x1e\n\x16max_cached_message_age\x18\x03 \x01(\x05\x12\x14\n\x0cmapbox_token\x18\x04 \x01(\t\x12\x19\n\x11\x61llow_run_on_save\x18\x05 \x01(\x08\x12\x14\n\x0chide_top_bar\x18\x06 \x01(\x08\x12\x18\n\x10hide_sidebar_nav\x18\x07 \x01(\x08\x12)\n\x0ctoolbar_mode\x18\x08 \x01(\x0e\x32\x13.Config.ToolbarMode\"?\n\x0bToolbarMode\x12\x08\n\x04\x41UTO\x10\x00\x12\r\n\tDEVELOPER\x10\x01\x12\n\n\x06VIEWER\x10\x02\x12\x0b\n\x07MINIMAL\x10\x03J\x04\x08\x01\x10\x02\"\x80\x06\n\x11\x43ustomThemeConfig\x12\x15\n\rprimary_color\x18\x01 \x01(\t\x12\"\n\x1asecondary_background_color\x18\x02 \x01(\t\x12\x18\n\x10\x62\x61\x63kground_color\x18\x03 \x01(\t\x12\x12\n\ntext_color\x18\x04 \x01(\t\x12+\n\x04\x66ont\x18\x05 \x01(\x0e\x32\x1d.CustomThemeConfig.FontFamily\x12*\n\x04\x62\x61se\x18\x06 \x01(\x0e\x32\x1c.CustomThemeConfig.BaseTheme\x12\x1f\n\x17widget_background_color\x18\x07 \x01(\t\x12\x1b\n\x13widget_border_color\x18\x08 \x01(\t\x12\x15\n\x05radii\x18\t \x01(\x0b\x32\x06.Radii\x12\x11\n\tbody_font\x18\r \x01(\t\x12\x11\n\tcode_font\x18\x0e \x01(\t\x12\x1d\n\nfont_faces\x18\x0f \x03(\x0b\x32\t.FontFace\x12\x1e\n\nfont_sizes\x18\x10 \x01(\x0b\x32\n.FontSizes\x12!\n\x19skeleton_background_color\x18\x11 \x01(\t\x12\x18\n\x0b\x62\x61se_radius\x18\x12 \x01(\tH\x00\x88\x01\x01\x12\x19\n\x0c\x62order_color\x18\x13 \x01(\tH\x01\x88\x01\x01\x12&\n\x19show_border_around_inputs\x18\x14 \x01(\x08H\x02\x88\x01\x01\x12\x17\n\nlink_color\x18\x15 \x01(\tH\x03\x88\x01\x01\x12\x1b\n\x0e\x62\x61se_font_size\x18\x16 \x01(\x05H\x04\x88\x01\x01\" \n\tBaseTheme\x12\t\n\x05LIGHT\x10\x00\x12\x08\n\x04\x44\x41RK\x10\x01\"6\n\nFontFamily\x12\x0e\n\nSANS_SERIF\x10\x00\x12\t\n\x05SERIF\x10\x01\x12\r\n\tMONOSPACE\x10\x02\x42\x0e\n\x0c_base_radiusB\x0f\n\r_border_colorB\x1c\n\x1a_show_border_around_inputsB\r\n\x0b_link_colorB\x11\n\x0f_base_font_size\"F\n\x08\x46ontFace\x12\x0b\n\x03url\x18\x01 \x01(\t\x12\x0e\n\x06\x66\x61mily\x18\x02 \x01(\t\x12\x0e\n\x06weight\x18\x03 \x01(\x05\x12\r\n\x05style\x18\x04 \x01(\t\"<\n\x05Radii\x12\x1a\n\x12\x62\x61se_widget_radius\x18\x01 \x01(\x05\x12\x17\n\x0f\x63heckbox_radius\x18\x02 \x01(\x05\"T\n\tFontSizes\x12\x16\n\x0etiny_font_size\x18\x01 \x01(\x05\x12\x17\n\x0fsmall_font_size\x18\x02 \x01(\x05\x12\x16\n\x0e\x62\x61se_font_size\x18\x03 \x01(\x05\"E\n\x08UserInfo\x12\x17\n\x0finstallation_id\x18\x01 \x01(\t\x12\x1a\n\x12installation_id_v3\x18\x05 \x01(\tJ\x04\x08\x02\x10\x03\"D\n\x0f\x45nvironmentInfo\x12\x19\n\x11streamlit_version\x18\x01 \x01(\t\x12\x16\n\x0epython_version\x18\x02 \x01(\tB/\n\x1c\x63om.snowflake.apps.streamlitB\x0fNewSessionProtob\x06proto3')
 
 _globals = globals()
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, _globals)
@@ -33,19 +33,19 @@ if not _descriptor._USE_C_DESCRIPTORS:
   _globals['_CONFIG_TOOLBARMODE']._serialized_start=800
   _globals['_CONFIG_TOOLBARMODE']._serialized_end=863
   _globals['_CUSTOMTHEMECONFIG']._serialized_start=872
-  _globals['_CUSTOMTHEMECONFIG']._serialized_end=1636
-  _globals['_CUSTOMTHEMECONFIG_BASETHEME']._serialized_start=1453
-  _globals['_CUSTOMTHEMECONFIG_BASETHEME']._serialized_end=1485
-  _globals['_CUSTOMTHEMECONFIG_FONTFAMILY']._serialized_start=1487
-  _globals['_CUSTOMTHEMECONFIG_FONTFAMILY']._serialized_end=1541
-  _globals['_FONTFACE']._serialized_start=1638
-  _globals['_FONTFACE']._serialized_end=1708
-  _globals['_RADII']._serialized_start=1710
-  _globals['_RADII']._serialized_end=1770
-  _globals['_FONTSIZES']._serialized_start=1772
-  _globals['_FONTSIZES']._serialized_end=1856
-  _globals['_USERINFO']._serialized_start=1858
-  _globals['_USERINFO']._serialized_end=1927
-  _globals['_ENVIRONMENTINFO']._serialized_start=1929
-  _globals['_ENVIRONMENTINFO']._serialized_end=1997
+  _globals['_CUSTOMTHEMECONFIG']._serialized_end=1640
+  _globals['_CUSTOMTHEMECONFIG_BASETHEME']._serialized_start=1455
+  _globals['_CUSTOMTHEMECONFIG_BASETHEME']._serialized_end=1487
+  _globals['_CUSTOMTHEMECONFIG_FONTFAMILY']._serialized_start=1489
+  _globals['_CUSTOMTHEMECONFIG_FONTFAMILY']._serialized_end=1543
+  _globals['_FONTFACE']._serialized_start=1642
+  _globals['_FONTFACE']._serialized_end=1712
+  _globals['_RADII']._serialized_start=1714
+  _globals['_RADII']._serialized_end=1774
+  _globals['_FONTSIZES']._serialized_start=1776
+  _globals['_FONTSIZES']._serialized_end=1860
+  _globals['_USERINFO']._serialized_start=1862
+  _globals['_USERINFO']._serialized_end=1931
+  _globals['_ENVIRONMENTINFO']._serialized_start=1933
+  _globals['_ENVIRONMENTINFO']._serialized_end=2001
 # @@protoc_insertion_point(module_scope)

streamlit/proto/NewSession_pb2.pyi

@@ -283,7 +283,7 @@ class CustomThemeConfig(google.protobuf.message.Message):
     FONT_FACES_FIELD_NUMBER: builtins.int
     FONT_SIZES_FIELD_NUMBER: builtins.int
     SKELETON_BACKGROUND_COLOR_FIELD_NUMBER: builtins.int
-    ROUNDNESS_FIELD_NUMBER: builtins.int
+    BASE_RADIUS_FIELD_NUMBER: builtins.int
     BORDER_COLOR_FIELD_NUMBER: builtins.int
     SHOW_BORDER_AROUND_INPUTS_FIELD_NUMBER: builtins.int
     LINK_COLOR_FIELD_NUMBER: builtins.int
@@ -303,14 +303,14 @@ class CustomThemeConfig(google.protobuf.message.Message):
     code_font: builtins.str
     skeleton_background_color: builtins.str
     """DEPRECATED: This color is not applied anymore:"""
-    roundness: builtins.float
+    base_radius: builtins.str
     border_color: builtins.str
     show_border_around_inputs: builtins.bool
     link_color: builtins.str
     base_font_size: builtins.int
     @property
     def radii(self) -> global___Radii:
-        """DEPRECATED: Please use the roundness theme config instead:"""
+        """DEPRECATED: Please use the base_radius theme config instead:"""
 
     @property
     def font_faces(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___FontFace]: ...
@@ -335,23 +335,23 @@ class CustomThemeConfig(google.protobuf.message.Message):
         font_faces: collections.abc.Iterable[global___FontFace] | None = ...,
         font_sizes: global___FontSizes | None = ...,
         skeleton_background_color: builtins.str = ...,
-        roundness: builtins.float | None = ...,
+        base_radius: builtins.str | None = ...,
         border_color: builtins.str | None = ...,
         show_border_around_inputs: builtins.bool | None = ...,
         link_color: builtins.str | None = ...,
         base_font_size: builtins.int | None = ...,
     ) -> None: ...
-    def HasField(self, field_name: typing.Literal["_base_font_size", b"_base_font_size", "_border_color", b"_border_color", "_link_color", b"_link_color", "_roundness", b"_roundness", "_show_border_around_inputs", b"_show_border_around_inputs", "base_font_size", b"base_font_size", "border_color", b"border_color", "font_sizes", b"font_sizes", "link_color", b"link_color", "radii", b"radii", "roundness", b"roundness", "show_border_around_inputs", b"show_border_around_inputs"]) -> builtins.bool: ...
-    def ClearField(self, field_name: typing.Literal["_base_font_size", b"_base_font_size", "_border_color", b"_border_color", "_link_color", b"_link_color", "_roundness", b"_roundness", "_show_border_around_inputs", b"_show_border_around_inputs", "background_color", b"background_color", "base", b"base", "base_font_size", b"base_font_size", "body_font", b"body_font", "border_color", b"border_color", "code_font", b"code_font", "font", b"font", "font_faces", b"font_faces", "font_sizes", b"font_sizes", "link_color", b"link_color", "primary_color", b"primary_color", "radii", b"radii", "roundness", b"roundness", "secondary_background_color", b"secondary_background_color", "show_border_around_inputs", b"show_border_around_inputs", "skeleton_background_color", b"skeleton_background_color", "text_color", b"text_color", "widget_background_color", b"widget_background_color", "widget_border_color", b"widget_border_color"]) -> None: ...
+    def HasField(self, field_name: typing.Literal["_base_font_size", b"_base_font_size", "_base_radius", b"_base_radius", "_border_color", b"_border_color", "_link_color", b"_link_color", "_show_border_around_inputs", b"_show_border_around_inputs", "base_font_size", b"base_font_size", "base_radius", b"base_radius", "border_color", b"border_color", "font_sizes", b"font_sizes", "link_color", b"link_color", "radii", b"radii", "show_border_around_inputs", b"show_border_around_inputs"]) -> builtins.bool: ...
+    def ClearField(self, field_name: typing.Literal["_base_font_size", b"_base_font_size", "_base_radius", b"_base_radius", "_border_color", b"_border_color", "_link_color", b"_link_color", "_show_border_around_inputs", b"_show_border_around_inputs", "background_color", b"background_color", "base", b"base", "base_font_size", b"base_font_size", "base_radius", b"base_radius", "body_font", b"body_font", "border_color", b"border_color", "code_font", b"code_font", "font", b"font", "font_faces", b"font_faces", "font_sizes", b"font_sizes", "link_color", b"link_color", "primary_color", b"primary_color", "radii", b"radii", "secondary_background_color", b"secondary_background_color", "show_border_around_inputs", b"show_border_around_inputs", "skeleton_background_color", b"skeleton_background_color", "text_color", b"text_color", "widget_background_color", b"widget_background_color", "widget_border_color", b"widget_border_color"]) -> None: ...
     @typing.overload
     def WhichOneof(self, oneof_group: typing.Literal["_base_font_size", b"_base_font_size"]) -> typing.Literal["base_font_size"] | None: ...
     @typing.overload
+    def WhichOneof(self, oneof_group: typing.Literal["_base_radius", b"_base_radius"]) -> typing.Literal["base_radius"] | None: ...
+    @typing.overload
     def WhichOneof(self, oneof_group: typing.Literal["_border_color", b"_border_color"]) -> typing.Literal["border_color"] | None: ...
     @typing.overload
     def WhichOneof(self, oneof_group: typing.Literal["_link_color", b"_link_color"]) -> typing.Literal["link_color"] | None: ...
     @typing.overload
-    def WhichOneof(self, oneof_group: typing.Literal["_roundness", b"_roundness"]) -> typing.Literal["roundness"] | None: ...
-    @typing.overload
     def WhichOneof(self, oneof_group: typing.Literal["_show_border_around_inputs", b"_show_border_around_inputs"]) -> typing.Literal["show_border_around_inputs"] | None: ...
 
 global___CustomThemeConfig = CustomThemeConfig
@@ -382,7 +382,7 @@ global___FontFace = FontFace
 
 @typing.final
 class Radii(google.protobuf.message.Message):
-    """DEPRECATED: Please use the roundness theme config instead."""
+    """DEPRECATED: Please use the base_radius theme config instead."""
 
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 

streamlit/runtime/app_session.py

@@ -353,6 +353,7 @@ class AppSession:
             to use previous client state.
 
         """
+
         if self._state == AppSessionState.SHUTDOWN_REQUESTED:
             _LOGGER.warning("Discarding rerun request after shutdown")
             return
@@ -382,6 +383,9 @@ class AppSession:
                 )
                 return
 
+            if client_state.HasField("context_info"):
+                self._client_state.context_info.CopyFrom(client_state.context_info)
+
             rerun_data = RerunData(
                 client_state.query_string,
                 client_state.widget_states,
@@ -389,6 +393,7 @@ class AppSession:
                 client_state.page_name,
                 fragment_id=fragment_id if fragment_id else None,
                 is_auto_rerun=client_state.is_auto_rerun,
+                context_info=client_state.context_info,
             )
         else:
             rerun_data = RerunData()

streamlit/runtime/context.py

@@ -205,3 +205,22 @@ class ContextProxy:
 
         cookies = session_client_request.cookies
         return StreamlitCookies.from_tornado_cookies(cookies)
+
+    @property
+    @gather_metrics("context.timezone")
+    def timezone(self) -> str | None:
+        """The timezone of the user's browser, read-only."""
+        ctx = get_script_run_ctx()
+
+        if ctx is None or ctx.context_info is None:
+            return None
+        return ctx.context_info.timezone
+
+    @property
+    @gather_metrics("context.timezone_offset")
+    def timezone_offset(self) -> int | None:
+        """The timezone offset of the user's browser, read-only."""
+        ctx = get_script_run_ctx()
+        if ctx is None or ctx.context_info is None:
+            return None
+        return ctx.context_info.timezone_offset

streamlit/runtime/scriptrunner/script_runner.py

@@ -310,6 +310,7 @@ class ScriptRunner:
             gather_usage_stats=bool(config.get_option("browser.gatherUsageStats")),
             fragment_storage=self._fragment_storage,
             pages_manager=self._pages_manager,
+            context_info=None,
         )
         add_script_run_ctx(threading.current_thread(), ctx)
 
@@ -468,6 +469,7 @@ class ScriptRunner:
                 query_string=rerun_data.query_string,
                 page_script_hash=page_script_hash,
                 fragment_ids_this_run=fragment_ids_this_run,
+                context_info=rerun_data.context_info,
             )
 
             self.on_event.send(

streamlit/runtime/scriptrunner_utils/script_requests.py

@@ -17,13 +17,16 @@ from __future__ import annotations
 import threading
 from dataclasses import dataclass, field, replace
 from enum import Enum
-from typing import cast
+from typing import TYPE_CHECKING, cast
 
 from streamlit import util
 from streamlit.proto.Common_pb2 import ChatInputValue as ChatInputValueProto
 from streamlit.proto.Common_pb2 import StringTriggerValue as StringTriggerValueProto
 from streamlit.proto.WidgetStates_pb2 import WidgetState, WidgetStates
 
+if TYPE_CHECKING:
+    from streamlit.proto.ClientState_pb2 import ContextInfo
+
 
 class ScriptRequestType(Enum):
     # The ScriptRunner should continue running its script.
@@ -55,6 +58,8 @@ class RerunData:
     is_fragment_scoped_rerun: bool = False
     # set to true when a script is rerun by the fragment auto-rerun mechanism
     is_auto_rerun: bool = False
+    # context_info is used to store information from the user browser (e.g. timezone)
+    context_info: ContextInfo | None = None
 
     def __repr__(self) -> str:
         return util.repr_(self)
@@ -233,6 +238,7 @@ class ScriptRequests:
                     fragment_id_queue=fragment_id_queue,
                     is_fragment_scoped_rerun=new_data.is_fragment_scoped_rerun,
                     is_auto_rerun=new_data.is_auto_rerun,
+                    context_info=new_data.context_info,
                 )
 
                 return True

streamlit/runtime/scriptrunner_utils/script_run_context.py

@@ -41,6 +41,7 @@ if TYPE_CHECKING:
     from pathlib import Path
 
     from streamlit.cursor import RunningCursor
+    from streamlit.proto.ClientState_pb2 import ContextInfo
     from streamlit.proto.ForwardMsg_pb2 import ForwardMsg
     from streamlit.proto.PageProfile_pb2 import Command
     from streamlit.runtime.fragment import FragmentStorage
@@ -85,6 +86,7 @@ class ScriptRunContext:
     fragment_storage: FragmentStorage
     pages_manager: PagesManager
 
+    context_info: ContextInfo | None = None
     gather_usage_stats: bool = False
     command_tracking_deactivated: bool = False
     tracked_commands: list[Command] = field(default_factory=list)
@@ -138,12 +140,14 @@ class ScriptRunContext:
         query_string: str = "",
         page_script_hash: str = "",
         fragment_ids_this_run: list[str] | None = None,
+        context_info: ContextInfo | None = None,
     ) -> None:
         self.cursors = {}
         self.widget_ids_this_run = set()
         self.widget_user_keys_this_run = set()
         self.form_ids_this_run = set()
         self.query_string = query_string
+        self.context_info = context_info
         self.pages_manager.set_current_page_script_hash(page_script_hash)
         self._active_script_hash = self.pages_manager.initial_active_script_hash
         # Permit set_page_config when the ScriptRunContext is reused on a rerun

streamlit/static/index.html

@@ -51,7 +51,7 @@
     <script>
       window.prerenderReady = false
     </script>
-    <script type="module" crossorigin src="./static/js/index.BDSGWkr0.js"></script>
+    <script type="module" crossorigin src="./static/js/index.KPwXWqBk.js"></script>
     <link rel="stylesheet" crossorigin href="./static/css/index.DpJG_94W.css">
   </head>
   <body>

streamlit/static/static/js/{FileDownload.esm.BlYgQAwd.js → FileDownload.esm.CWn5B5ZN.js}

@@ -1 +1 @@
-import{r as e,E as n,_ as a}from"./index.BDSGWkr0.js";var o=e.forwardRef(function(t,r){var l={fill:"currentColor",xmlns:"http://www.w3.org/2000/svg"};return e.createElement(n,a({iconAttrs:l,iconVerticalAlign:"middle",iconViewBox:"0 0 24 24"},t,{ref:r}),e.createElement("path",{fill:"none",d:"M0 0h24v24H0V0z"}),e.createElement("path",{d:"M16 9v10H8V9h8m-1.5-6h-5l-1 1H5v2h14V4h-3.5l-1-1zM18 7H6v12c0 1.1.9 2 2 2h8c1.1 0 2-.9 2-2V7z"}))});o.displayName="Delete";var i=e.forwardRef(function(t,r){var l={fill:"currentColor",xmlns:"http://www.w3.org/2000/svg"};return e.createElement(n,a({iconAttrs:l,iconVerticalAlign:"middle",iconViewBox:"0 0 24 24"},t,{ref:r}),e.createElement("rect",{width:24,height:24,fill:"none"}),e.createElement("path",{d:"M18 15v3H6v-3H4v3c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2v-3h-2zm-1-4l-1.41-1.41L13 12.17V4h-2v8.17L8.41 9.59 7 11l5 5 5-5z"}))});i.displayName="FileDownload";export{o as D,i as F};
+import{r as e,E as n,_ as a}from"./index.KPwXWqBk.js";var o=e.forwardRef(function(t,r){var l={fill:"currentColor",xmlns:"http://www.w3.org/2000/svg"};return e.createElement(n,a({iconAttrs:l,iconVerticalAlign:"middle",iconViewBox:"0 0 24 24"},t,{ref:r}),e.createElement("path",{fill:"none",d:"M0 0h24v24H0V0z"}),e.createElement("path",{d:"M16 9v10H8V9h8m-1.5-6h-5l-1 1H5v2h14V4h-3.5l-1-1zM18 7H6v12c0 1.1.9 2 2 2h8c1.1 0 2-.9 2-2V7z"}))});o.displayName="Delete";var i=e.forwardRef(function(t,r){var l={fill:"currentColor",xmlns:"http://www.w3.org/2000/svg"};return e.createElement(n,a({iconAttrs:l,iconVerticalAlign:"middle",iconViewBox:"0 0 24 24"},t,{ref:r}),e.createElement("rect",{width:24,height:24,fill:"none"}),e.createElement("path",{d:"M18 15v3H6v-3H4v3c0 1.1.9 2 2 2h12c1.1 0 2-.9 2-2v-3h-2zm-1-4l-1.41-1.41L13 12.17V4h-2v8.17L8.41 9.59 7 11l5 5 5-5z"}))});i.displayName="FileDownload";export{o as D,i as F};