streamlit 1.48.1__py3-none-any.whl → 1.49.0__py3-none-any.whl

streamlit/elements/widgets/camera_input.py

@@ -234,7 +234,6 @@ class CameraInputMixin:
         element_id = compute_and_register_element_id(
             "camera_input",
             user_key=key,
-            form_id=current_form_id(self.dg),
             dg=self.dg,
             label=label,
             help=help,

streamlit/elements/widgets/chat.py

@@ -32,7 +32,7 @@ from streamlit.elements.lib.file_uploader_utils import (
     normalize_upload_file_type,
 )
 from streamlit.elements.lib.form_utils import is_in_form
-from streamlit.elements.lib.image_utils import AtomicImage, WidthBehavior, image_to_url
+from streamlit.elements.lib.image_utils import AtomicImage, image_to_url
 from streamlit.elements.lib.layout_utils import (
     LayoutConfig,
     Width,
@@ -147,7 +147,7 @@ def _process_avatar_input(
     try:
         return AvatarType.IMAGE, image_to_url(
             avatar,
-            width=WidthBehavior.ORIGINAL,
+            layout_config=LayoutConfig(width="content"),
             clamp=False,
             channels="RGB",
             output_format="auto",
@@ -391,7 +391,7 @@ class ChatMixin:
         *,
         key: Key | None = None,
         max_chars: int | None = None,
-        accept_file: Literal[True, "multiple"],
+        accept_file: Literal[True, "multiple", "directory"],
         file_type: str | Sequence[str] | None = None,
         disabled: bool = False,
         on_submit: WidgetCallback | None = None,
@@ -407,7 +407,7 @@ class ChatMixin:
         *,
         key: Key | None = None,
         max_chars: int | None = None,
-        accept_file: bool | Literal["multiple"] = False,
+        accept_file: bool | Literal["multiple", "directory"] = False,
         file_type: str | Sequence[str] | None = None,
         disabled: bool = False,
         on_submit: WidgetCallback | None = None,
@@ -433,7 +433,7 @@ class ChatMixin:
             The maximum number of characters that can be entered. If this is
             ``None`` (default), there will be no maximum.
 
-        accept_file : bool or str
+        accept_file : bool, "multiple", or "directory"
             Whether the chat input should accept files. This can be one of the
             following values:
 
@@ -442,9 +442,9 @@ class ChatMixin:
             - ``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.
+            - ``"directory"``: The user can add multiple files to their
+              submission by selecting a directory. If ``file_type`` is set,
+              only files matching those type(s) will be uploaded.
 
             By default, uploaded files are limited to 200 MB each. You can
             configure this using the ``server.maxUploadSize`` config option.
@@ -614,9 +614,9 @@ class ChatMixin:
             writes_allowed=True,
         )
 
-        if accept_file not in {True, False, "multiple"}:
+        if accept_file not in {True, False, "multiple", "directory"}:
             raise StreamlitAPIException(
-                "The `accept_file` parameter must be a boolean or 'multiple'."
+                "The `accept_file` parameter must be a boolean or 'multiple' or 'directory'."
             )
 
         ctx = get_script_run_ctx()
@@ -624,8 +624,6 @@ class ChatMixin:
         element_id = compute_and_register_element_id(
             "chat_input",
             user_key=key,
-            # chat_input is not allowed to be used in a form.
-            form_id=None,
             dg=self.dg,
             placeholder=placeholder,
             max_chars=max_chars,
@@ -677,7 +675,7 @@ class ChatMixin:
         chat_input_proto.max_upload_size_mb = config.get_option("server.maxUploadSize")
 
         serde = ChatInputSerde(
-            accept_files=bool(accept_file),
+            accept_files=accept_file in {True, "multiple", "directory"},
             allowed_types=file_type,
         )
         widget_state = register_widget(  # type: ignore[misc]

streamlit/elements/widgets/checkbox.py

@@ -342,7 +342,6 @@ class CheckboxMixin:
         element_id = compute_and_register_element_id(
             "toggle" if type == CheckboxProto.StyleType.TOGGLE else "checkbox",
             user_key=key,
-            form_id=current_form_id(self.dg),
             dg=self.dg,
             label=label,
             value=bool(value),

streamlit/elements/widgets/color_picker.py

@@ -219,7 +219,6 @@ class ColorPickerMixin:
         element_id = compute_and_register_element_id(
             "color_picker",
             user_key=key,
-            form_id=current_form_id(self.dg),
             dg=self.dg,
             label=label,
             value=str(value),

streamlit/elements/widgets/data_editor.py

@@ -33,6 +33,10 @@ from typing_extensions import TypeAlias
 
 from streamlit import dataframe_util
 from streamlit import logger as _logger
+from streamlit.deprecation_util import (
+    make_deprecated_name_warning,
+    show_deprecation_warning,
+)
 from streamlit.elements.lib.column_config_utils import (
     INDEX_IDENTIFIER,
     ColumnConfigMapping,
@@ -47,6 +51,12 @@ from streamlit.elements.lib.column_config_utils import (
     update_column_config,
 )
 from streamlit.elements.lib.form_utils import current_form_id
+from streamlit.elements.lib.layout_utils import (
+    LayoutConfig,
+    Width,
+    validate_height,
+    validate_width,
+)
 from streamlit.elements.lib.pandas_styler_utils import marshall_styler
 from streamlit.elements.lib.policies import check_widget_policies
 from streamlit.elements.lib.utils import Key, compute_and_register_element_id, to_key
@@ -60,7 +70,7 @@ from streamlit.runtime.state import (
     WidgetKwargs,
     register_widget,
 )
-from streamlit.type_util import is_type
+from streamlit.type_util import is_list_like, is_type
 from streamlit.util import calc_md5
 
 if TYPE_CHECKING:
@@ -170,14 +180,14 @@ class DataEditorSerde:
 
 
 def _parse_value(
-    value: str | int | float | bool | None,
+    value: str | int | float | bool | list[str] | None,
     column_data_kind: ColumnDataKind,
 ) -> Any:
     """Convert a value to the correct type.
 
     Parameters
     ----------
-    value : str | int | float | bool | None
+    value : str | int | float | bool | list[str] | None
         The value to convert.
 
     column_data_kind : ColumnDataKind
@@ -194,9 +204,20 @@ def _parse_value(
     import pandas as pd
 
     try:
+        if column_data_kind == ColumnDataKind.LIST:
+            return list(value) if is_list_like(value) else [value]  # ty: ignore
+
         if column_data_kind == ColumnDataKind.STRING:
             return str(value)
 
+        # List values aren't supported for anything else than list column data kind.
+        # To make the type checker happy, we raise a TypeError here. However,
+        # This isn't expected to happen.
+        if isinstance(value, list):
+            raise TypeError(  # noqa: TRY301
+                "List values are only supported by list and string columns."
+            )
+
         if column_data_kind == ColumnDataKind.INTEGER:
             return int(value)
 
@@ -234,7 +255,7 @@ def _parse_value(
             if column_data_kind == ColumnDataKind.TIME:
                 return datetime_value.time()
 
-    except (ValueError, pd.errors.ParserError) as ex:
+    except (ValueError, pd.errors.ParserError, TypeError) as ex:
         _LOGGER.warning(
             "Failed to parse value %s as %s.",
             value,
@@ -247,7 +268,9 @@ def _parse_value(
 
 def _apply_cell_edits(
     df: pd.DataFrame,
-    edited_rows: Mapping[int, Mapping[str, str | int | float | bool | None]],
+    edited_rows: Mapping[
+        int, Mapping[str, str | int | float | bool | list[str] | None]
+    ],
     dataframe_schema: DataframeSchema,
 ) -> None:
     """Apply cell edits to the provided dataframe (inplace).
@@ -278,7 +301,7 @@ def _apply_cell_edits(
                 )
             else:
                 col_pos = df.columns.get_loc(col_name)
-                df.iloc[row_pos, col_pos] = _parse_value(
+                df.iat[row_pos, col_pos] = _parse_value(
                     value, dataframe_schema[col_name]
                 )
 
@@ -578,14 +601,14 @@ class DataEditorMixin:
         self,
         data: EditableData,
         *,
-        width: int | None = None,
-        height: int | None = None,
+        width: Width = "stretch",
+        height: int | Literal["auto"] = "auto",
         use_container_width: bool | None = None,
         hide_index: bool | None = None,
         column_order: Iterable[str] | None = None,
         column_config: ColumnConfigMappingInput | None = None,
         num_rows: Literal["fixed", "dynamic"] = "fixed",
-        disabled: bool | Iterable[str] = False,
+        disabled: bool | Iterable[str | int] = False,
         key: Key | None = None,
         on_change: WidgetCallback | None = None,
         args: WidgetArgs | None = None,
@@ -599,14 +622,14 @@ class DataEditorMixin:
         self,
         data: Any,
         *,
-        width: int | None = None,
-        height: int | None = None,
+        width: Width = "stretch",
+        height: int | Literal["auto"] = "auto",
         use_container_width: bool | None = None,
         hide_index: bool | None = None,
         column_order: Iterable[str] | None = None,
         column_config: ColumnConfigMappingInput | None = None,
         num_rows: Literal["fixed", "dynamic"] = "fixed",
-        disabled: bool | Iterable[str] = False,
+        disabled: bool | Iterable[str | int] = False,
         key: Key | None = None,
         on_change: WidgetCallback | None = None,
         args: WidgetArgs | None = None,
@@ -620,14 +643,14 @@ class DataEditorMixin:
         self,
         data: DataTypes,
         *,
-        width: int | None = None,
-        height: int | None = None,
+        width: Width = "stretch",
+        height: int | Literal["auto"] = "auto",
         use_container_width: bool | None = None,
         hide_index: bool | None = None,
         column_order: Iterable[str] | None = None,
         column_config: ColumnConfigMappingInput | None = None,
         num_rows: Literal["fixed", "dynamic"] = "fixed",
-        disabled: bool | Iterable[str] = False,
+        disabled: bool | Iterable[str | int] = False,
         key: Key | None = None,
         on_change: WidgetCallback | None = None,
         args: WidgetArgs | None = None,
@@ -649,7 +672,7 @@ class DataEditorMixin:
                   precedence over text and number formatting from ``pandas.Styler``.
                 - Mixing data types within a column can make the column uneditable.
                 - Additionally, the following data types are not yet supported for editing:
-                  ``complex``, ``list``, ``tuple``, ``bytes``, ``bytearray``,
+                  ``complex``, ``tuple``, ``bytes``, ``bytearray``,
                   ``memoryview``, ``dict``, ``set``, ``frozenset``,
                   ``fractions.Fraction``, ``pandas.Interval``, and
                   ``pandas.Period``.
@@ -658,18 +681,28 @@ class DataEditorMixin:
                   default to uneditable, but this can be changed through column
                   configuration.
 
-        width : int or None
-            Desired width of the data editor expressed in pixels. If ``width``
-            is ``None`` (default), Streamlit sets the data editor width to fit
-            its contents up to the width of the parent container. If ``width``
-            is greater than the width of the parent container, Streamlit sets
-            the data editor width to match the width of the parent container.
+        width : "stretch", "content", or int
+            The width of the data editor. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the editor matches the
+              width of the parent container.
+            - ``"content"``: The width of the editor matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The editor has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the editor matches the width
+              of the parent container.
 
-        height : int or None
-            Desired height of the data editor expressed in pixels. If ``height``
-            is ``None`` (default), Streamlit sets the height to show at most
-            ten rows. Vertical scrolling within the data editor element is
-            enabled when the height does not accommodate all rows.
+        height : int or "auto"
+            The height of the data editor. This can be one of the following:
+
+            - ``"auto"`` (default): Streamlit sets the height to show at most
+              ten rows.
+            - An integer specifying the height in pixels: The editor has a
+              fixed height.
+
+            Vertical scrolling within the data editor is enabled when the
+            height does not accommodate all rows.
 
         use_container_width : bool
             Whether to override ``width`` with the width of the parent
@@ -683,28 +716,42 @@ class DataEditorMixin:
             (default), the visibility of index columns is automatically
             determined based on the data.
 
-        column_order : Iterable of str or None
-            Specifies the display order of columns. This also affects which columns are
-            visible. For example, ``column_order=("col2", "col1")`` will display 'col2'
-            first, followed by 'col1', and will hide all other non-index columns. If
-            None (default), the order is inherited from the original data structure.
+        column_order : Iterable[str] or None
+            The ordered list of columns to display. If this is ``None``
+            (default), Streamlit displays all columns in the order inherited
+            from the underlying data structure. If this is a list, the
+            indicated columns will display in the order they appear within the
+            list. Columns may be omitted or repeated within the list.
+
+            For example, ``column_order=("col2", "col1")`` will display
+            ``"col2"`` first, followed by ``"col1"``, and will hide all other
+            non-index columns.
+
+            ``column_order`` does not accept positional column indices and
+            can't move the index column(s).
 
         column_config : dict or None
-            Configures how columns are displayed, e.g. their title, visibility, type, or
-            format, as well as editing properties such as min/max value or step.
-            This needs to be a dictionary where each key is a column name and the value
-            is one of:
+            Configuration to customize how columns are displayed. If this is
+            ``None`` (default), columns are styled based on the underlying data
+            type of each column.
 
-            - ``None`` to hide the column.
+            Column configuration can modify column names, visibility, type,
+            width, format, editing properties like min/max, and more. If this
+            is a dictionary, the keys are column names (strings) and/or
+            positional column indices (integers), and the values are one of the
+            following:
 
+            - ``None`` to hide the column.
             - A string to set the display label of the column.
+            - One of the column types defined under ``st.column_config``. For
+              example, to show a column as dollar amounts, use
+              ``st.column_config.NumberColumn("Dollar values", format="$ %d")``.
+              See more info on the available column types and config options
+              `here <https://docs.streamlit.io/develop/api-reference/data/st.column_config>`_.
 
-            - One of the column types defined under ``st.column_config``, e.g.
-              ``st.column_config.NumberColumn("Dollar values", format="$ %d")`` to show
-              a column as dollar amounts. See more info on the available column types
-              and config options `here <https://docs.streamlit.io/develop/api-reference/data/st.column_config>`_.
-
-            To configure the index column(s), use ``_index`` as the column name.
+            To configure the index column(s), use ``"_index"`` as the column
+            name, or use a positional column index where ``0`` refers to the
+            first index column.
 
         num_rows : "fixed" or "dynamic"
             Specifies if the user can add and delete rows in the data editor.
@@ -712,11 +759,20 @@ class DataEditorMixin:
             add and delete rows in the data editor, but column sorting is disabled.
             Defaults to "fixed".
 
-        disabled : bool or Iterable of str
-            Controls the editing of columns. If True, editing is disabled for all columns.
-            If an Iterable of column names is provided (e.g., ``disabled=("col1", "col2"))``,
-            only the specified columns will be disabled for editing. If False (default),
-            all columns that support editing are editable.
+        disabled : bool or Iterable[str | int]
+            Controls the editing of columns. This can be one of the following:
+
+            - ``False`` (default): All columns that support editing are editable.
+            - ``True``: All columns are disabled for editing.
+            - An Iterable of column names and/or positional indices: The
+              specified columns are disabled for editing while the remaining
+              columns are editable where supported. For example,
+              ``disabled=["col1", "col2"]`` will disable editing for the
+              columns named "col1" and "col2".
+
+            To disable editing for the index column(s), use ``"_index"`` as the
+            column name, or use a positional column index where ``0`` refers to
+            the first index column.
 
         key : str
             An optional string to use as the unique key for this widget. If this
@@ -737,6 +793,11 @@ class DataEditorMixin:
             is ``None`` (default), Streamlit will use a default row height,
             which fits one line of text.
 
+        .. deprecated::
+            ``use_container_width`` is deprecated and will be removed in a
+            future release. For ``use_container_width=True``, use
+            ``width="stretch"``.
+
         Returns
         -------
         pandas.DataFrame, pandas.Series, pyarrow.Table, numpy.ndarray, list, set, tuple, or dict.
@@ -839,6 +900,14 @@ class DataEditorMixin:
 
         key = to_key(key)
 
+        validate_width(width, allow_content=True)
+        validate_height(
+            height,
+            allow_content=False,
+            allow_stretch=False,
+            additional_allowed=["auto"],
+        )
+
         check_widget_policies(
             self.dg,
             key,
@@ -847,6 +916,23 @@ class DataEditorMixin:
             writes_allowed=False,
         )
 
+        if use_container_width is not None:
+            show_deprecation_warning(
+                make_deprecated_name_warning(
+                    "use_container_width",
+                    "width",
+                    "2025-12-31",
+                    "For `use_container_width=True`, use `width='stretch'`. "
+                    "For `use_container_width=False`, use `width='content'`.",
+                    include_st_prefix=False,
+                ),
+                show_in_browser=False,
+            )
+            if use_container_width:
+                width = "stretch"
+            elif not isinstance(width, int):
+                width = "content"
+
         if column_order is not None:
             column_order = list(column_order)
 
@@ -942,7 +1028,6 @@ class DataEditorMixin:
         element_id = compute_and_register_element_id(
             "data_editor",
             user_key=key,
-            form_id=current_form_id(self.dg),
             dg=self.dg,
             data=arrow_bytes,
             width=width,
@@ -957,18 +1042,6 @@ class DataEditorMixin:
         proto = ArrowProto()
         proto.id = element_id
 
-        if use_container_width is None:
-            # If use_container_width was not explicitly set by the user, we set
-            # it to True if width was not set explicitly, and False otherwise.
-            use_container_width = width is None
-
-        proto.use_container_width = use_container_width
-
-        if width:
-            proto.width = width
-        if height:
-            proto.height = height
-
         if row_height:
             proto.row_height = row_height
 
@@ -1005,6 +1078,13 @@ class DataEditorMixin:
 
         marshall_column_config(proto, column_config_mapping)
 
+        # Create layout configuration
+        # For height, only include it in LayoutConfig if it's not "auto"
+        # "auto" is the default behavior and doesn't need to be sent
+        layout_config = LayoutConfig(
+            width=width, height=height if height != "auto" else None
+        )
+
         serde = DataEditorSerde()
 
         widget_state = register_widget(
@@ -1019,7 +1099,7 @@ class DataEditorMixin:
         )
 
         _apply_dataframe_edits(data_df, widget_state.value, dataframe_schema)
-        self.dg._enqueue("arrow_data_frame", proto)
+        self.dg._enqueue("arrow_data_frame", proto, layout_config=layout_config)
         return dataframe_util.convert_pandas_df_to_data_format(data_df, data_format)
 
     @property