streamlit-nightly 1.53.2.dev20260128__py3-none-any.whl → 1.53.2.dev20260202__py3-none-any.whl

streamlit/commands/execution_control.py

@@ -133,7 +133,7 @@ def _set_query_params_for_switch(
 def rerun(  # type: ignore[misc]
     *,  # The scope argument can only be passed via keyword.
     scope: Literal["app", "fragment"] = "app",
-) -> NoReturn:  # ty: ignore[invalid-return-type]
+) -> NoReturn:  # ty: ignore[empty-body]
     """Rerun the script immediately.
 
     When ``st.rerun()`` is called, Streamlit halts the current script run and
@@ -189,7 +189,7 @@ def switch_page(  # type: ignore[misc]
     page: str | Path | StreamlitPage,
     *,
     query_params: QueryParamsInput | None = None,
-) -> NoReturn:  # ty: ignore[invalid-return-type]
+) -> NoReturn:  # ty: ignore[empty-body]
     """Programmatically switch the current page in a multipage app.
 
     When ``st.switch_page`` is called, the current page execution stops and

streamlit/config.py

@@ -2705,7 +2705,8 @@ def get_config_options(
 
         # Values set in files later in the CONFIG_FILENAMES list overwrite those
         # set earlier.
-        for filename in get_config_files("config.toml"):
+        config_files = get_config_files("config.toml")
+        for filename in config_files:
             if not os.path.exists(filename):
                 continue
 
@@ -2723,7 +2724,7 @@ def get_config_options(
         # This happens AFTER all config sources (files, env vars, flags) are processed
         # so theme.base can be set via any of those
         config_util.process_theme_inheritance(
-            _config_options, _config_options_template, _set_option
+            _config_options, _config_options_template, _set_option, config_files
         )
 
         if old_options and config_util.server_option_changed(

streamlit/config_util.py

@@ -19,10 +19,10 @@ import os
 import re
 import urllib.error
 import urllib.request
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, TypedDict
 
 if TYPE_CHECKING:
-    from collections.abc import Iterator
+    from collections.abc import Iterator, Sequence
 
 from streamlit import cli_util, url_util
 from streamlit.config_option import ConfigOption
@@ -36,6 +36,31 @@ from streamlit.errors import (
 # Maximum size for theme files (1MB). Theme files should be small configuration
 # files containing only theme options, not large data files.
 _MAX_THEME_FILE_SIZE_BYTES = 1024 * 1024  # 1MB
+_CONFIG_FILE_SCOPES = ("global", "project", "script")
+
+
+class _ThemeOverride(TypedDict):
+    value: Any
+    where_defined: str
+
+
+def _format_config_file_label(
+    where_defined: str | None, config_file_paths: Sequence[str] | None
+) -> str | None:
+    """Return a scope-labeled config.toml path if where_defined matches a config file."""
+    if not where_defined or not config_file_paths:
+        return None
+
+    for index, path in enumerate(config_file_paths):
+        if where_defined == path:
+            scope = (
+                _CONFIG_FILE_SCOPES[index] if index < len(_CONFIG_FILE_SCOPES) else None
+            )
+            if scope:
+                return f"config.toml ({scope}): {path}"
+            return f"config.toml: {path}"
+
+    return None
 
 
 def _get_logger() -> Any:
@@ -720,6 +745,7 @@ def process_theme_inheritance(
     config_options: dict[str, ConfigOption] | None,
     config_options_template: dict[str, ConfigOption],
     set_option_func: Any,
+    config_file_paths: Sequence[str] | None = None,
 ) -> None:
     """
     Process theme inheritance if theme.base points to a theme file.
@@ -729,6 +755,18 @@ def process_theme_inheritance(
     current config.toml values override the theme.base file values.
 
     Sets the merged theme options to the config.
+
+    Parameters
+    ----------
+    config_options : dict[str, ConfigOption] | None
+        Current configuration options.
+    config_options_template : dict[str, ConfigOption]
+        Template of all valid config options.
+    set_option_func : Any
+        Function to set config option values.
+    config_file_paths : Sequence[str] | None, optional
+        Ordered list of config.toml file paths (global, project, script).
+        Used to label where_defined with scope for clearer provenance.
     """
     # Get the current theme.base value
     if config_options is None:
@@ -770,7 +808,8 @@ def process_theme_inheritance(
         )
 
         # Preserve theme options set by env vars and command line flags (higher precedence)
-        high_precedence_theme_options = {}
+        high_precedence_theme_options: dict[str, _ThemeOverride] = {}
+        config_theme_overrides: dict[str, _ThemeOverride] = {}
         if config_options is not None:
             for opt_name, opt_config in config_options.items():
                 if (
@@ -786,6 +825,18 @@ def process_theme_inheritance(
                         "value": opt_config.value,
                         "where_defined": opt_config.where_defined,
                     }
+                config_label = _format_config_file_label(
+                    opt_config.where_defined, config_file_paths
+                )
+                if (
+                    opt_name.startswith("theme.")
+                    and opt_name != "theme.base"
+                    and config_label is not None
+                ):
+                    config_theme_overrides[opt_name] = {
+                        "value": opt_config.value,
+                        "where_defined": config_label,
+                    }
 
             # Clear existing theme options (except base) to prepare for inheritance
             theme_options_to_remove = [
@@ -799,19 +850,23 @@ def process_theme_inheritance(
         # Handle theme.base - always set it to a valid value ("light" or "dark", not a path/URL)
         theme_file_base = theme_file_content.get("theme", {}).get("base")
         if theme_file_base:
-            set_option_func("theme.base", theme_file_base, f"theme file: {base_value}")
-        else:
-            # Theme file doesn't specify a base, default to "light"
             set_option_func(
-                "theme.base", "light", f"theme file: {base_value} (default)"
+                "theme.base", theme_file_base, f"base theme file: {base_value}"
             )
+        else:
+            # Theme file doesn't specify a base, default to "light"
+            set_option_func("theme.base", "light", "default light theme")
 
         # Set the merged theme options using recursive helper
         theme_section = merged_theme.get("theme", {})
         _set_theme_options_recursive(
-            theme_section, "theme", set_option_func, f"theme file: {base_value}"
+            theme_section, "theme", set_option_func, f"base theme file: {base_value}"
         )
 
+        # Restore theme options set in config.toml (override base theme file)
+        for opt_name, opt_data in config_theme_overrides.items():
+            set_option_func(opt_name, opt_data["value"], opt_data["where_defined"])
+
         # Finally, restore theme options set by env vars and command line flags (highest precedence)
         for opt_name, opt_data in high_precedence_theme_options.items():
             set_option_func(opt_name, opt_data["value"], opt_data["where_defined"])

streamlit/delta_generator.py

@@ -91,6 +91,7 @@ from streamlit.elements.widgets.chat import ChatMixin
 from streamlit.elements.widgets.checkbox import CheckboxMixin
 from streamlit.elements.widgets.color_picker import ColorPickerMixin
 from streamlit.elements.widgets.data_editor import DataEditorMixin
+from streamlit.elements.widgets.feedback import FeedbackMixin
 from streamlit.elements.widgets.file_uploader import FileUploaderMixin
 from streamlit.elements.widgets.multiselect import MultiSelectMixin
 from streamlit.elements.widgets.number_input import NumberInputMixin
@@ -189,6 +190,7 @@ class DeltaGenerator(
     ColorPickerMixin,
     EmptyMixin,
     ExceptionMixin,
+    FeedbackMixin,
     FileUploaderMixin,
     FormMixin,
     GraphvizMixin,

streamlit/elements/deck_gl_json_chart.py

@@ -556,7 +556,11 @@ class PydeckMixin:
             pydeck_proto.id = compute_and_register_element_id(
                 "deck_gl_json_chart",
                 user_key=key,
-                key_as_main_identity=False,
+                # When a key is provided, only selection_mode affects the element ID.
+                # This allows selection state to persist across data/spec changes.
+                # Note: This can lead to orphaned selections if data length shrinks,
+                # but the frontend handles this by sanitizing invalid indices.
+                key_as_main_identity={"selection_mode"},
                 dg=self.dg,
                 is_selection_activated=is_selection_activated,
                 selection_mode=selection_mode,

streamlit/elements/lib/built_in_chart_utils.py

@@ -24,6 +24,7 @@ from typing import TYPE_CHECKING, Any, Final, Literal, TypeAlias, TypedDict, cas
 from streamlit import dataframe_util, type_util
 from streamlit.elements.lib.color_util import (
     Color,
+    is_builtin_color_name,
     is_color_like,
     is_color_tuple_like,
     is_hex_color_like,
@@ -1080,6 +1081,14 @@ def _get_color_encoding(
 
             return alt.ColorValue(to_css_color(cast("Any", color_value)))
 
+        # Check for built-in color names (resolved on frontend, not converted here)
+        if isinstance(color_value, str) and is_builtin_color_name(color_value):
+            if len(y_column_list) != 1:
+                raise StreamlitColorLengthError(
+                    [color_value] if color_value else [], y_column_list
+                )
+            return alt.ColorValue(color_value)
+
         # If the color value is a list of colors of appropriate length, return that.
         if isinstance(color_value, (list, tuple)):
             color_values = cast("Collection[Color]", color_value)
@@ -1088,12 +1097,23 @@ def _get_color_encoding(
                 raise StreamlitColorLengthError(color_values, y_column_list)
 
             if len(color_values) == 1:
-                return alt.ColorValue(to_css_color(cast("Any", color_value[0])))
+                first_color = cast("Any", color_value[0])
+                # Pass through built-in color names as-is (resolved on frontend)
+                if isinstance(first_color, str) and is_builtin_color_name(first_color):
+                    return alt.ColorValue(first_color)
+                return alt.ColorValue(to_css_color(first_color))
+
+            # Convert colors, but pass through built-in color names as-is
+            resolved_colors: list[Color] = []
+            for c in color_values:
+                if isinstance(c, str) and is_builtin_color_name(c):
+                    resolved_colors.append(c)
+                else:
+                    resolved_colors.append(to_css_color(c))
+
             return alt.Color(
                 field=color_column if color_column is not None else alt.Undefined,
-                scale=alt.Scale(
-                    domain=y_column_list, range=[to_css_color(c) for c in color_values]
-                ),
+                scale=alt.Scale(domain=y_column_list, range=resolved_colors),
                 legend=_COLOR_LEGEND_SETTINGS,
                 type="nominal",
                 title=" ",

streamlit/elements/lib/color_util.py

@@ -15,10 +15,16 @@
 from __future__ import annotations
 
 from collections.abc import Callable, Collection
-from typing import Any, TypeAlias, cast
+from typing import Any, Final, TypeAlias, cast
 
 from streamlit.errors import StreamlitInvalidColorError
 
+# Built-in color names that map to Streamlit theme colors.
+# These are resolved to actual color values on the frontend.
+BUILTIN_COLOR_NAMES: Final[frozenset[str]] = frozenset(
+    {"red", "orange", "yellow", "green", "blue", "violet", "gray", "grey", "primary"}
+)
+
 # components go from 0.0 to 1.0
 # Supported by Pillow and pretty common.
 FloatRGBColorTuple: TypeAlias = tuple[float, float, float]
@@ -131,11 +137,24 @@ def is_color_tuple_like(color: MaybeColor) -> bool:
     )
 
 
+def is_builtin_color_name(color: MaybeColor) -> bool:
+    """Check whether the input is a built-in Streamlit color name.
+
+    Built-in color names (red, orange, yellow, green, blue, violet, gray/grey, primary)
+    are resolved to theme colors on the frontend.
+    """
+    return isinstance(color, str) and color.lower() in BUILTIN_COLOR_NAMES
+
+
 def is_color_like(color: MaybeColor) -> bool:
     """A fairly lightweight check of whether the input is a color.
 
     This isn't meant to be a definitive answer. The definitive solution is to
     try to convert and see if an error is thrown.
+
+    NOTE: This does NOT include built-in color names (red, blue, etc.) because
+    those require special handling and cannot be converted via to_css_color().
+    Use is_builtin_color_name() separately when validating color parameter arguments.
     """
     return is_css_color_like(color) or is_color_tuple_like(color)
 

streamlit/elements/lib/column_types.py

@@ -529,7 +529,9 @@ def NumberColumn(
           specifier, like ``"%d"`` to show a signed integer (e.g. "1234") or
           ``"%X"`` to show an unsigned hexadecimal integer (e.g. "4D2"). You
           can also add prefixes and suffixes. To show British pounds, use
-          ``"£ %.2f"`` (e.g. "£ 1234.57"). For more information, see `sprint-js
+          ``"£ %.2f"`` (e.g. "£ 1234.57"). Use ``,`` for thousand separators
+          (e.g. ``"%,d"`` yields ``"1,234"``). For more information, see
+          `sprintf-js
           <https://github.com/alexei/sprintf.js?tab=readme-ov-file#format-specification>`_.
 
         Formatting from ``column_config`` always takes precedence over
@@ -2517,7 +2519,9 @@ def ProgressColumn(
           specifier, like ``"%d"`` to show a signed integer (e.g. "1234") or
           ``"%X"`` to show an unsigned hexadecimal integer (e.g. "4D2"). You
           can also add prefixes and suffixes. To show British pounds, use
-          ``"£ %.2f"`` (e.g. "£ 1234.57"). For more information, see `sprint-js
+          ``"£ %.2f"`` (e.g. "£ 1234.57"). Use ``,`` for thousand separators
+          (e.g. ``"%,d"`` yields ``"1,234"``). For more information, see
+          `sprintf-js
           <https://github.com/alexei/sprintf.js?tab=readme-ov-file#format-specification>`_.
 
         Number formatting from ``column_config`` always takes precedence over

streamlit/elements/lib/utils.py

@@ -31,7 +31,7 @@ from streamlit import config
 from streamlit.elements.lib.form_utils import current_form_id
 from streamlit.errors import StreamlitDuplicateElementId, StreamlitDuplicateElementKey
 from streamlit.proto.ChatInput_pb2 import ChatInput
-from streamlit.proto.LabelVisibilityMessage_pb2 import LabelVisibilityMessage
+from streamlit.proto.LabelVisibility_pb2 import LabelVisibility as LabelVisibilityProto
 from streamlit.runtime.scriptrunner_utils.script_run_context import (
     ScriptRunContext,
     get_script_run_ctx,
@@ -68,15 +68,15 @@ SAFE_VALUES: TypeAlias = Union[
 
 def get_label_visibility_proto_value(
     label_visibility_string: LabelVisibility,
-) -> LabelVisibilityMessage.LabelVisibilityOptions.ValueType:
-    """Returns one of LabelVisibilityMessage enum constants.py based on string value."""
+) -> LabelVisibilityProto.LabelVisibilityOptions.ValueType:
+    """Returns one of LabelVisibilityProto enum constants based on string value."""
 
     if label_visibility_string == "visible":
-        return LabelVisibilityMessage.LabelVisibilityOptions.VISIBLE
+        return LabelVisibilityProto.LabelVisibilityOptions.VISIBLE
     if label_visibility_string == "hidden":
-        return LabelVisibilityMessage.LabelVisibilityOptions.HIDDEN
+        return LabelVisibilityProto.LabelVisibilityOptions.HIDDEN
     if label_visibility_string == "collapsed":
-        return LabelVisibilityMessage.LabelVisibilityOptions.COLLAPSED
+        return LabelVisibilityProto.LabelVisibilityOptions.COLLAPSED
 
     raise ValueError(f"Unknown label visibility value: {label_visibility_string}")
 

streamlit/elements/markdown.py

@@ -270,7 +270,6 @@ class MarkdownMixin:
         caption_proto = MarkdownProto()
         caption_proto.body = clean_text(body)
         caption_proto.allow_html = unsafe_allow_html
-        caption_proto.is_caption = True
         caption_proto.element_type = MarkdownProto.Type.CAPTION
         if help:
             caption_proto.help = help

streamlit/elements/metric.py

@@ -259,7 +259,8 @@ class MetricMixin:
             - ``"engineering"``: Show the number in engineering notation (e.g. "1.235E3").
             - printf-style format string: Format the number with a printf
               specifier, like ``"%d"`` to show a signed integer (e.g. "1234") or
-              ``"%.2f"`` to show a float with 2 decimal places.
+              ``"%.2f"`` to show a float with 2 decimal places. Use ``,`` for
+              thousand separators (e.g. ``"%,d"`` yields ``"1,234"``).
 
         Examples
         --------

streamlit/elements/vega_charts.py

@@ -725,6 +725,10 @@ class VegaChartsMixin:
             - An RGB or RGBA tuple with the red, green, blue, and alpha
               components specified as ints from 0 to 255 or floats from 0.0 to
               1.0.
+            - A built-in color name: "red", "orange", "yellow", "green",
+              "blue", "violet", "gray"/"grey", or "primary". These map to
+              theme colors that you can customize using ``theme.<color>Color``
+              configuration options.
 
             For a line chart with multiple lines, where the dataframe is in
             long format (that is, y is None or just one column), this can be:
@@ -753,7 +757,8 @@ class VegaChartsMixin:
             - A list of string colors or color tuples to be used for each of
               the lines in the chart. This list should have the same length
               as the number of y values (e.g. ``color=["#fd0", "#f0f", "#04f"]``
-              for three lines).
+              for three lines). You can also use built-in color names in the
+              list (e.g. ``color=["red", "blue", "green"]``).
 
             You can set the default colors in the ``theme.chartCategoryColors``
             configuration option.
@@ -959,6 +964,10 @@ class VegaChartsMixin:
             - An RGB or RGBA tuple with the red, green, blue, and alpha
               components specified as ints from 0 to 255 or floats from 0.0 to
               1.0.
+            - A built-in color name: "red", "orange", "yellow", "green",
+              "blue", "violet", "gray"/"grey", or "primary". These map to
+              theme colors that you can customize using ``theme.<color>Color``
+              configuration options.
 
             For an area chart with multiple series, where the dataframe is in
             long format (that is, y is None or just one column), this can be:
@@ -987,7 +996,8 @@ class VegaChartsMixin:
             - A list of string colors or color tuples to be used for each of
               the series in the chart. This list should have the same length
               as the number of y values (e.g. ``color=["#fd0", "#f0f", "#04f"]``
-              for three lines).
+              for three lines). You can also use built-in color names in the
+              list (e.g. ``color=["red", "blue", "green"]``).
 
             You can set the default colors in the ``theme.chartCategoryColors``
             configuration option.
@@ -1248,6 +1258,10 @@ class VegaChartsMixin:
             - An RGB or RGBA tuple with the red, green, blue, and alpha
               components specified as ints from 0 to 255 or floats from 0.0 to
               1.0.
+            - A built-in color name: "red", "orange", "yellow", "green",
+              "blue", "violet", "gray"/"grey", or "primary". These map to
+              theme colors that you can customize using ``theme.<color>Color``
+              configuration options.
 
             For a bar chart with multiple series, where the dataframe is in
             long format (that is, y is None or just one column), this can be:
@@ -1276,7 +1290,8 @@ class VegaChartsMixin:
             - A list of string colors or color tuples to be used for each of
               the series in the chart. This list should have the same length
               as the number of y values (e.g. ``color=["#fd0", "#f0f", "#04f"]``
-              for three lines).
+              for three lines). You can also use built-in color names in the
+              list (e.g. ``color=["red", "blue", "green"]``).
 
             You can set the default colors in the ``theme.chartCategoryColors``
             configuration option.
@@ -1575,6 +1590,10 @@ class VegaChartsMixin:
             - An RGB or RGBA tuple with the red, green, blue, and alpha
               components specified as ints from 0 to 255 or floats from 0.0 to
               1.0.
+            - A built-in color name: "red", "orange", "yellow", "green",
+              "blue", "violet", "gray"/"grey", or "primary". These map to
+              theme colors that you can customize using ``theme.<color>Color``
+              configuration options.
             - The name of a column in the dataset where the color of that
               datapoint will come from.
 
@@ -1602,7 +1621,8 @@ class VegaChartsMixin:
             - A list of string colors or color tuples to be used for each of
               the series in the chart. This list should have the same length
               as the number of y values (e.g. ``color=["#fd0", "#f0f", "#04f"]``
-              for three series).
+              for three series). You can also use built-in color names in the
+              list (e.g. ``color=["red", "blue", "green"]``).
 
         size : str, float, int, or None
             The size of the circles representing each point.