streamlit 1.50.0__py3-none-any.whl → 1.52.0__py3-none-any.whl

streamlit/elements/vega_charts.py

@@ -18,11 +18,22 @@ from __future__ import annotations
 
 import json
 import re
+import threading
 from contextlib import nullcontext
 from dataclasses import dataclass
-from typing import TYPE_CHECKING, Any, Final, Literal, TypedDict, Union, cast, overload
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Final,
+    Literal,
+    TypeAlias,
+    TypedDict,
+    Union,
+    cast,
+    overload,
+)
 
-from typing_extensions import Required, TypeAlias
+from typing_extensions import Required
 
 from streamlit import dataframe_util, type_util
 from streamlit.deprecation_util import (
@@ -106,6 +117,8 @@ AltairChart: TypeAlias = Union[
     "alt.VConcatChart",
 ]
 
+_altair_globals_lock = threading.Lock()
+
 
 class VegaLiteState(TypedDict, total=False):
     """
@@ -323,7 +336,7 @@ def _marshall_chart_data(
             dataset = proto.datasets.add()
             dataset.name = str(dataset_name)
             dataset.has_name = True
-            # The ID transformer (id_transform function registered before conversion to dict)
+            # The ID transformer (_to_arrow_dataset function registered before conversion to dict)
             # already serializes the data into Arrow IPC format (bytes) when the Altair object
             # gets converted into the vega-lite spec dict.
             # If its already in bytes, we don't need to serialize it here again.
@@ -364,41 +377,46 @@ def _convert_altair_to_vega_lite_spec(
     """Convert an Altair chart object to a Vega-Lite chart spec."""
     import altair as alt
 
+    # alt.themes was deprecated in Altair 5.5.0 in favor of alt.theme
+    if type_util.is_altair_version_less_than("5.5.0"):
+        alt_theme = alt.themes  # ty: ignore[unresolved-attribute]
+    else:
+        alt_theme = alt.theme
+
+    # This is where we'll store Arrow-serialized versions of the chart data.
+    # This happens in _to_arrow_dataset().
+    datasets: dict[str, Any] = {}
+
     # Normally altair_chart.to_dict() would transform the dataframe used by the
     # chart into an array of dictionaries. To avoid that, we install a
     # transformer that replaces datasets with a reference by the object id of
     # the dataframe. We then fill in the dataset manually later on.
+    #
+    # Note: it's OK to re-register this every time we run this function since
+    # transformers are stored in a dict. So there's no duplication.
+    #
+    # type: ignore[arg-type,attr-defined,unused-ignore]
+    alt.data_transformers.register("to_arrow_dataset", _to_arrow_dataset)
+
+    # Settings like alt.theme.enable and alt.data_transformers.enable are global to all
+    # threads. So this lock makes sure that whatever we set those to only apply to the
+    # current thread.
+    with _altair_globals_lock:
+        # The default altair theme has some width/height defaults defined
+        # which are not useful for Streamlit. Therefore, we change the theme to
+        # "none" to avoid those defaults.
+        theme_context = (
+            alt_theme.enable("none") if alt_theme.active == "default" else nullcontext()
+        )
 
-    datasets = {}
-
-    def id_transform(data: Any) -> dict[str, str]:
-        """Altair data transformer that serializes the data,
-        creates a stable name based on the hash of the data,
-        stores the bytes into the datasets mapping and
-        returns this name to have it be used in Altair.
-        """
-        # Already serialize the data to be able to create a stable
-        # dataset name:
-        data_bytes = dataframe_util.convert_anything_to_arrow_bytes(data)
-        # Use the md5 hash of the data as the name:
-        name = calc_md5(str(data_bytes))
-
-        datasets[name] = data_bytes
-        return {"name": name}
-
-    alt.data_transformers.register("id", id_transform)  # type: ignore[arg-type,attr-defined,unused-ignore]
-
-    # alt.themes was deprecated in Altair 5.5.0 in favor of alt.theme
-    alt_theme = (
-        alt.themes if type_util.is_altair_version_less_than("5.5.0") else alt.theme  # ty: ignore[unresolved-attribute]
-    )
+        data_transformer = alt.data_transformers.enable(
+            "to_arrow_dataset", datasets=datasets
+        )
 
-    # The default altair theme has some width/height defaults defined
-    # which are not useful for Streamlit. Therefore, we change the theme to
-    # "none" to avoid those defaults.
-    with alt_theme.enable("none") if alt_theme.active == "default" else nullcontext():  # ty: ignore
-        with alt.data_transformers.enable("id"):  # type: ignore[attr-defined,unused-ignore]
-            chart_dict = altair_chart.to_dict()
+        with theme_context:  # ty: ignore[invalid-context-manager]
+            # type: ignore[attr-defined,unused-ignore]
+            with data_transformer:  # ty: ignore[invalid-context-manager]
+                chart_dict = altair_chart.to_dict()
 
     # Put datasets back into the chart dict:
     chart_dict["datasets"] = datasets
@@ -501,7 +519,10 @@ def _reset_counter_pattern(prefix: str, vega_spec: str) -> str:
     We need to reset these counters on a spec-level to make the
     spec stable across reruns and avoid changes to the element ID.
     """
-    pattern = re.compile(rf'"{prefix}\d+"')
+
+    # Altair 6.0.0 introduced a new way to handle parameters,
+    # by using hashes instead of pure counters:
+    pattern = re.compile(rf'"{prefix}[0-9a-z]+"')
     # Get all matches without duplicates in order of appearance.
     # Using a set here would not guarantee the order of appearance,
     # which might lead to different replacements on each run.
@@ -704,17 +725,21 @@ class VegaChartsMixin:
               fixed height. If the content is larger than the specified
               height, scrolling is enabled.
 
-        use_container_width : bool
-            Whether to override ``width`` with the width of the parent
-            container. If ``use_container_width`` is ``True`` (default),
-            Streamlit sets the width of the chart to match the width of the
-            parent container. If ``use_container_width`` is ``False``,
-            Streamlit sets the chart's width according to ``width``.
+        use_container_width : bool or None
+            Whether to override the chart's native width with the width of
+            the parent container. This can be one of the following:
+
+            - ``None`` (default): Streamlit will use the chart's default behavior.
+            - ``True``: Streamlit sets the width of the chart to match the
+              width of the parent container.
+            - ``False``: Streamlit sets the width of the chart to fit its
+              contents according to the plotting library, up to the width of
+              the parent container.
 
             .. deprecated::
-                The ``use_container_width`` parameter is deprecated and will
-                be removed in a future version. Use the ``width`` parameter
-                with ``width="stretch"`` instead.
+               ``use_container_width`` is deprecated and will be removed in a
+                future release. For ``use_container_width=True``, use
+                ``width="stretch"``.
 
         Examples
         --------
@@ -791,25 +816,6 @@ class VegaChartsMixin:
            height: 440px
 
         """
-        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):
-                # This preserves the existing behavior of setting use_container_width
-                # to False combined with an integer width.
-                width = "content"
-
         chart, add_rows_metadata = generate_chart(
             chart_type=ChartType.LINE,
             data=data,
@@ -824,12 +830,11 @@ class VegaChartsMixin:
             use_container_width=(width == "stretch"),
         )
 
-        validate_width(width, allow_content=True)
-        validate_height(height, allow_content=True)
         return cast(
             "DeltaGenerator",
             self._altair_chart(
                 chart,
+                use_container_width=use_container_width,
                 theme="streamlit",
                 add_rows_metadata=add_rows_metadata,
                 width=width,
@@ -848,9 +853,9 @@ class VegaChartsMixin:
         y_label: str | None = None,
         color: str | Color | list[Color] | None = None,
         stack: bool | ChartStackType | None = None,
-        width: int | None = None,
-        height: int | None = None,
-        use_container_width: bool = True,
+        width: Width = "stretch",
+        height: Height = "content",
+        use_container_width: bool | None = None,
     ) -> DeltaGenerator:
         """Display an area chart.
 
@@ -941,27 +946,46 @@ class VegaChartsMixin:
             - ``"center"``: The areas are stacked and shifted to center their
               baseline, which creates a steamgraph.
 
-        width : int or None
-            Desired width of the chart expressed in pixels. If ``width`` is
-            ``None`` (default), Streamlit sets the width of the chart to fit
-            its contents according to the plotting library, up to the width of
-            the parent container. If ``width`` is greater than the width of the
-            parent container, Streamlit sets the chart width to match the width
-            of the parent container.
+        width : "stretch", "content", or int
+            The width of the chart element. This can be one of the following:
 
-            To use ``width``, you must set ``use_container_width=False``.
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - ``"content"``: The width of the element matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
 
-        height : int or None
-            Desired height of the chart expressed in pixels. If ``height`` is
-            ``None`` (default), Streamlit sets the height of the chart to fit
-            its contents according to the plotting library.
+        height : "stretch", "content", or int
+            The height of the chart element. This can be one of the following:
 
-        use_container_width : bool
-            Whether to override ``width`` with the width of the parent
-            container. If ``use_container_width`` is ``True`` (default),
-            Streamlit sets the width of the chart to match the width of the
-            parent container. If ``use_container_width`` is ``False``,
-            Streamlit sets the chart's width according to ``width``.
+            - ``"content"`` (default): The height of the element matches the
+              height of its content.
+            - ``"stretch"``: The height of the element matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the element is not in a parent container, the height
+              of the element matches the height of its content.
+            - An integer specifying the height in pixels: The element has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled.
+
+        use_container_width : bool or None
+            Whether to override the chart's native width with the width of
+            the parent container. This can be one of the following:
+
+            - ``None`` (default): Streamlit will use the chart's default behavior.
+            - ``True``: Streamlit sets the width of the chart to match the
+              width of the parent container.
+            - ``False``: Streamlit sets the width of the chart to fit its
+              contents according to the plotting library, up to the width of
+              the parent container.
+
+            .. deprecated::
+               ``use_container_width`` is deprecated and will be removed in a
+                future release. For ``use_container_width=True``, use
+                ``width="stretch"``.
 
         Examples
         --------
@@ -1062,7 +1086,6 @@ class VegaChartsMixin:
            height: 440px
 
         """
-
         # Check that the stack parameter is valid, raise more informative error message if not
         maybe_raise_stack_warning(
             stack,
@@ -1092,7 +1115,7 @@ class VegaChartsMixin:
             width=width,
             height=height,
             stack=stack,
-            use_container_width=use_container_width,
+            use_container_width=(width == "stretch"),
         )
         return cast(
             "DeltaGenerator",
@@ -1101,6 +1124,8 @@ class VegaChartsMixin:
                 use_container_width=use_container_width,
                 theme="streamlit",
                 add_rows_metadata=add_rows_metadata,
+                width=width,
+                height=height,
             ),
         )
 
@@ -1117,9 +1142,9 @@ class VegaChartsMixin:
         horizontal: bool = False,
         sort: bool | str = True,
         stack: bool | ChartStackType | None = None,
-        width: int | None = None,
-        height: int | None = None,
-        use_container_width: bool = True,
+        width: Width = "stretch",
+        height: Height = "content",
+        use_container_width: bool | None = None,
     ) -> DeltaGenerator:
         """Display a bar chart.
 
@@ -1230,27 +1255,46 @@ class VegaChartsMixin:
             - ``"center"``: The bars are stacked and shifted to center the
               total height around an axis.
 
-        width : int or None
-            Desired width of the chart expressed in pixels. If ``width`` is
-            ``None`` (default), Streamlit sets the width of the chart to fit
-            its contents according to the plotting library, up to the width of
-            the parent container. If ``width`` is greater than the width of the
-            parent container, Streamlit sets the chart width to match the width
-            of the parent container.
+        width : "stretch", "content", or int
+            The width of the chart element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - ``"content"``: The width of the element matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+
+        height : "stretch", "content", or int
+            The height of the chart element. This can be one of the following:
+
+            - ``"content"`` (default): The height of the element matches the
+              height of its content.
+            - ``"stretch"``: The height of the element matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the element is not in a parent container, the height
+              of the element matches the height of its content.
+            - An integer specifying the height in pixels: The element has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled.
 
-            To use ``width``, you must set ``use_container_width=False``.
+        use_container_width : bool or None
+            Whether to override the chart's native width with the width of
+            the parent container. This can be one of the following:
 
-        height : int or None
-            Desired height of the chart expressed in pixels. If ``height`` is
-            ``None`` (default), Streamlit sets the height of the chart to fit
-            its contents according to the plotting library.
+            - ``None`` (default): Streamlit will use the chart's default behavior.
+            - ``True``: Streamlit sets the width of the chart to match the
+              width of the parent container.
+            - ``False``: Streamlit sets the width of the chart to fit its
+              contents according to the plotting library, up to the width of
+              the parent container.
 
-        use_container_width : bool
-            Whether to override ``width`` with the width of the parent
-            container. If ``use_container_width`` is ``True`` (default),
-            Streamlit sets the width of the chart to match the width of the
-            parent container. If ``use_container_width`` is ``False``,
-            Streamlit sets the chart's width according to ``width``.
+            .. deprecated::
+               ``use_container_width`` is deprecated and will be removed in a
+                future release. For ``use_container_width=True``, use
+                ``width="stretch"``.
 
         Examples
         --------
@@ -1368,7 +1412,6 @@ class VegaChartsMixin:
            height: 440px
 
         """
-
         # Check that the stack parameter is valid, raise more informative error message if not
         maybe_raise_stack_warning(
             stack,
@@ -1410,6 +1453,8 @@ class VegaChartsMixin:
                 use_container_width=use_container_width,
                 theme="streamlit",
                 add_rows_metadata=add_rows_metadata,
+                width=width,
+                height=height,
             ),
         )
 
@@ -1424,9 +1469,9 @@ class VegaChartsMixin:
         y_label: str | None = None,
         color: str | Color | list[Color] | None = None,
         size: str | float | int | None = None,
-        width: int | None = None,
-        height: int | None = None,
-        use_container_width: bool = True,
+        width: Width = "stretch",
+        height: Height = "content",
+        use_container_width: bool | None = None,
     ) -> DeltaGenerator:
         """Display a scatterplot chart.
 
@@ -1511,27 +1556,46 @@ class VegaChartsMixin:
             - The name of the column to use for the size. This allows each
               datapoint to be represented by a circle of a different size.
 
-        width : int or None
-            Desired width of the chart expressed in pixels. If ``width`` is
-            ``None`` (default), Streamlit sets the width of the chart to fit
-            its contents according to the plotting library, up to the width of
-            the parent container. If ``width`` is greater than the width of the
-            parent container, Streamlit sets the chart width to match the width
-            of the parent container.
+        width : "stretch", "content", or int
+            The width of the chart element. This can be one of the following:
+
+            - ``"stretch"`` (default): The width of the element matches the
+              width of the parent container.
+            - ``"content"``: The width of the element matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+
+        height : "stretch", "content", or int
+            The height of the chart element. This can be one of the following:
 
-            To use ``width``, you must set ``use_container_width=False``.
+            - ``"content"`` (default): The height of the element matches the
+              height of its content.
+            - ``"stretch"``: The height of the element matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the element is not in a parent container, the height
+              of the element matches the height of its content.
+            - An integer specifying the height in pixels: The element has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled.
+
+        use_container_width : bool or None
+            Whether to override the chart's native width with the width of
+            the parent container. This can be one of the following:
 
-        height : int or None
-            Desired height of the chart expressed in pixels. If ``height`` is
-            ``None`` (default), Streamlit sets the height of the chart to fit
-            its contents according to the plotting library.
+            - ``None`` (default): Streamlit will use the chart's default behavior.
+            - ``True``: Streamlit sets the width of the chart to match the
+              width of the parent container.
+            - ``False``: Streamlit sets the width of the chart to fit its
+              contents according to the plotting library, up to the width of
+              the parent container.
 
-        use_container_width : bool
-            Whether to override ``width`` with the width of the parent
-            container. If ``use_container_width`` is ``True`` (default),
-            Streamlit sets the width of the chart to match the width of the
-            parent container. If ``use_container_width`` is ``False``,
-            Streamlit sets the chart's width according to ``width``.
+            .. deprecated::
+               ``use_container_width`` is deprecated and will be removed in a
+                future release. For ``use_container_width=True``, use
+                ``width="stretch"``.
 
         Examples
         --------
@@ -1616,7 +1680,6 @@ class VegaChartsMixin:
            height: 440px
 
         """
-
         chart, add_rows_metadata = generate_chart(
             chart_type=ChartType.SCATTER,
             data=data,
@@ -1628,7 +1691,7 @@ class VegaChartsMixin:
             size_from_user=size,
             width=width,
             height=height,
-            use_container_width=use_container_width,
+            use_container_width=(width == "stretch"),
         )
         return cast(
             "DeltaGenerator",
@@ -1637,6 +1700,8 @@ class VegaChartsMixin:
                 use_container_width=use_container_width,
                 theme="streamlit",
                 add_rows_metadata=add_rows_metadata,
+                width=width,
+                height=height,
             ),
         )
 
@@ -1646,6 +1711,8 @@ class VegaChartsMixin:
         self,
         altair_chart: AltairChart,
         *,
+        width: Width | None = None,
+        height: Height = "content",
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,
@@ -1659,6 +1726,8 @@ class VegaChartsMixin:
         self,
         altair_chart: AltairChart,
         *,
+        width: Width | None = None,
+        height: Height = "content",
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,
@@ -1671,6 +1740,8 @@ class VegaChartsMixin:
         self,
         altair_chart: AltairChart,
         *,
+        width: Width | None = None,
+        height: Height = "content",
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,
@@ -1690,6 +1761,39 @@ class VegaChartsMixin:
             https://altair-viz.github.io/gallery/ for examples of graph
             descriptions.
 
+        width : "stretch", "content", int, or None
+            The width of the chart element. This can be one of the following:
+
+            - ``"stretch"``: The width of the element matches the width of the
+              parent container.
+            - ``"content"``: The width of the element matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+            - ``None`` (default): Streamlit uses ``"stretch"`` for most charts,
+              and uses ``"content"`` for the following multi-view charts:
+
+                - Facet charts: the spec contains ``"facet"`` or encodings for
+                  ``"row"``, ``"column"``, or ``"facet"``.
+                - Horizontal concatenation charts: the spec contains
+                  ``"hconcat"``.
+                - Repeat charts: the spec contains ``"repeat"``.
+
+        height : "content", "stretch", or int
+            The height of the chart element. This can be one of the following:
+
+            - ``"content"`` (default): The height of the element matches the
+              height of its content.
+            - ``"stretch"``: The height of the element matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the element is not in a parent container, the height
+              of the element matches the height of its content.
+            - An integer specifying the height in pixels: The element has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled.
+
         use_container_width : bool or None
             Whether to override the chart's native width with the width of
             the parent container. This can be one of the following:
@@ -1704,6 +1808,11 @@ class VegaChartsMixin:
               contents according to the plotting library, up to the width of
               the parent container.
 
+            .. deprecated::
+               ``use_container_width`` is deprecated and will be removed in a
+                future release. For ``use_container_width=True``, use
+                ``width="stretch"``.
+
         theme : "streamlit" or None
             The theme of the chart. If ``theme`` is ``"streamlit"`` (default),
             Streamlit uses its own design default. If ``theme`` is ``None``,
@@ -1796,6 +1905,8 @@ class VegaChartsMixin:
         """
         return self._altair_chart(
             altair_chart=altair_chart,
+            width=width,
+            height=height,
             use_container_width=use_container_width,
             theme=theme,
             key=key,
@@ -1810,6 +1921,8 @@ class VegaChartsMixin:
         data: Data = None,
         spec: VegaLiteSpec | None = None,
         *,
+        width: Width | None = None,
+        height: Height = "content",
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,
@@ -1825,6 +1938,8 @@ class VegaChartsMixin:
         data: Data = None,
         spec: VegaLiteSpec | None = None,
         *,
+        width: Width | None = None,
+        height: Height = "content",
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,
@@ -1839,6 +1954,8 @@ class VegaChartsMixin:
         data: Data = None,
         spec: VegaLiteSpec | None = None,
         *,
+        width: Width | None = None,
+        height: Height = "content",
         use_container_width: bool | None = None,
         theme: Literal["streamlit"] | None = "streamlit",
         key: Key | None = None,
@@ -1863,6 +1980,39 @@ class VegaChartsMixin:
             to both ``data`` and ``spec``. See
             https://vega.github.io/vega-lite/docs/ for more info.
 
+        width : "stretch", "content", int, or None
+            The width of the chart element. This can be one of the following:
+
+            - ``"stretch"``: The width of the element matches the width of the
+              parent container.
+            - ``"content"``: The width of the element matches the width of its
+              content, but doesn't exceed the width of the parent container.
+            - An integer specifying the width in pixels: The element has a
+              fixed width. If the specified width is greater than the width of
+              the parent container, the width of the element matches the width
+              of the parent container.
+            - ``None`` (default): Streamlit uses ``"stretch"`` for most charts,
+              and uses ``"content"`` for the following multi-view charts:
+
+                - Facet charts: the spec contains ``"facet"`` or encodings for
+                  ``"row"``, ``"column"``, or ``"facet"``.
+                - Horizontal concatenation charts: the spec contains
+                  ``"hconcat"``.
+                - Repeat charts: the spec contains ``"repeat"``.
+
+        height : "content", "stretch", or int
+            The height of the chart element. This can be one of the following:
+
+            - ``"content"`` (default): The height of the element matches the
+              height of its content.
+            - ``"stretch"``: The height of the element matches the height of
+              its content or the height of the parent container, whichever is
+              larger. If the element is not in a parent container, the height
+              of the element matches the height of its content.
+            - An integer specifying the height in pixels: The element has a
+              fixed height. If the content is larger than the specified
+              height, scrolling is enabled.
+
         use_container_width : bool or None
             Whether to override the chart's native width with the width of
             the parent container. This can be one of the following:
@@ -1877,6 +2027,11 @@ class VegaChartsMixin:
               contents according to the plotting library, up to the width of
               the parent container.
 
+            .. deprecated::
+               ``use_container_width`` is deprecated and will be removed in a
+                future release. For ``use_container_width=True``, use
+                ``width="stretch"``.
+
         theme : "streamlit" or None
             The theme of the chart. If ``theme`` is ``"streamlit"`` (default),
             Streamlit uses its own design default. If ``theme`` is ``None``,
@@ -1938,6 +2093,11 @@ class VegaChartsMixin:
             The Vega-Lite spec for the chart as keywords. This is an alternative
             to ``spec``.
 
+            .. deprecated::
+               ``**kwargs`` are deprecated and will be removed in a future
+               release. To specify Vega-Lite configuration options, use the
+               ``spec`` argument instead.
+
         Returns
         -------
         element or dict
@@ -1978,6 +2138,14 @@ class VegaChartsMixin:
         translated to the syntax shown above.
 
         """
+        if kwargs:
+            show_deprecation_warning(
+                "Variable keyword arguments for `st.vega_lite_chart` have been "
+                "deprecated and will be removed in a future release. Use the "
+                "`spec` argument instead to specify Vega-Lite configuration "
+                "options."
+            )
+
         return self._vega_lite_chart(
             data=data,
             spec=spec,
@@ -1986,6 +2154,8 @@ class VegaChartsMixin:
             key=key,
             on_select=on_select,
             selection_mode=selection_mode,
+            width=width,
+            height=height,
             **kwargs,
         )
 
@@ -1999,7 +2169,7 @@ class VegaChartsMixin:
         selection_mode: str | Iterable[str] | None = None,
         add_rows_metadata: AddRowsMetadata | None = None,
         width: Width | None = None,
-        height: Height | None = None,
+        height: Height = "content",
     ) -> DeltaGenerator | VegaLiteState:
         """Internal method to enqueue a vega-lite chart element based on an Altair chart.
 
@@ -2039,14 +2209,13 @@ class VegaChartsMixin:
         selection_mode: str | Iterable[str] | None = None,
         add_rows_metadata: AddRowsMetadata | None = None,
         width: Width | None = None,
-        height: Height | None = None,
+        height: Height = "content",
         **kwargs: Any,
     ) -> DeltaGenerator | VegaLiteState:
         """Internal method to enqueue a vega-lite chart element based on a vega-lite spec.
 
         See the `vega_lite_chart` method docstring for more information.
         """
-
         if theme not in ["streamlit", None]:
             raise StreamlitAPIException(
                 f'You set theme="{theme}" while Streamlit charts only support '
@@ -2085,22 +2254,48 @@ class VegaChartsMixin:
         if spec is None:
             spec = {}
 
-        # Set the default value for `use_container_width`.
+        # Set the default value for width. Altair and Vega charts have different defaults depending on the chart type,
+        # so they don't default the value in the function signature and width could be None here.
         if use_container_width is None and width is None:
             # Some multi-view charts (facet, horizontal concatenation, and repeat;
             # see https://altair-viz.github.io/user_guide/compound_charts.html)
-            # don't work well with `use_container_width=True`, so we disable it for
+            # don't work well with `width=stretch`, so we disable it for
             # those charts (see https://github.com/streamlit/streamlit/issues/9091).
             # All other charts (including vertical concatenation) default to
-            # `use_container_width=True` unless width is provided.
+            # `width=stretch` unless width is provided.
             is_facet_chart = "facet" in spec or (
                 "encoding" in spec
                 and (any(x in spec["encoding"] for x in ["row", "column", "facet"]))
             )
-            use_container_width = not (
-                is_facet_chart or "hconcat" in spec or "repeat" in spec
+            width = (
+                "stretch"
+                if not (is_facet_chart or "hconcat" in spec or "repeat" in spec)
+                else "content"
             )
 
+        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'` or specify an integer width.",
+                    include_st_prefix=False,
+                ),
+                show_in_browser=False,
+            )
+            if use_container_width:
+                width = "stretch"
+            elif not isinstance(width, int):
+                # No specific width provided, use content width
+                width = "content"
+                # Otherwise keep the integer width - user explicitly set both use_container_width=False and width=int
+
+        if width is not None:
+            validate_width(width, allow_content=True)
+        validate_height(height, allow_content=True)
+
         vega_lite_proto = ArrowVegaLiteChartProto()
 
         use_container_width_for_spec = (
@@ -2108,11 +2303,13 @@ class VegaChartsMixin:
             if use_container_width is not None
             else width == "stretch"
         )
+
         spec = _prepare_vega_lite_spec(spec, use_container_width_for_spec, **kwargs)
         _marshall_chart_data(vega_lite_proto, spec, data)
 
         # Prevent the spec from changing across reruns:
         vega_lite_proto.spec = _stabilize_vega_json_spec(json.dumps(spec))
+
         if use_container_width is not None:
             vega_lite_proto.use_container_width = use_container_width
         vega_lite_proto.theme = theme or ""
@@ -2158,32 +2355,42 @@ class VegaChartsMixin:
                 value_type="string_value",
             )
 
-            self.dg._enqueue(
-                "arrow_vega_lite_chart",
-                vega_lite_proto,
-                add_rows_metadata=add_rows_metadata,
-            )
-            return widget_state.value
-
-        # Handle layout config for width/height parameters
-        if width is not None or height is not None:
             layout_config = LayoutConfig(width=width, height=height)
-            return self.dg._enqueue(
+            self.dg._enqueue(
                 "arrow_vega_lite_chart",
                 vega_lite_proto,
                 add_rows_metadata=add_rows_metadata,
                 layout_config=layout_config,
             )
+            return widget_state.value
 
         # If its not used with selections activated, just return
         # the delta generator related to this element.
+        layout_config = LayoutConfig(width=width, height=height)
         return self.dg._enqueue(
             "arrow_vega_lite_chart",
             vega_lite_proto,
             add_rows_metadata=add_rows_metadata,
+            layout_config=layout_config,
         )
 
     @property
     def dg(self) -> DeltaGenerator:
         """Get our DeltaGenerator."""
         return cast("DeltaGenerator", self)
+
+
+def _to_arrow_dataset(data: Any, datasets: dict[str, Any]) -> dict[str, str]:
+    """Altair data transformer that serializes the data,
+    creates a stable name based on the hash of the data,
+    stores the bytes into the datasets mapping and
+    returns this name to have it be used in Altair.
+    """
+    # Already serialize the data to be able to create a stable
+    # dataset name:
+    data_bytes = dataframe_util.convert_anything_to_arrow_bytes(data)
+    # Use the md5 hash of the data as the name:
+    name = calc_md5(str(data_bytes))
+
+    datasets[name] = data_bytes
+    return {"name": name}