feat(api): Deprecate panel_well() in favor of card()

CHANGELOG.md

@@ -9,6 +9,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### New features
 
+* Added support for python 3.13. (#1711)
+
 * `ui.sidebar()` is now interactively resizable. (#2020)
 
 * `ui.update_*()` functions now accept `ui.TagChild` (i.e., HTML) as input to the `label` and `icon` arguments. (#2020)
@@ -33,6 +35,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 * Fixed `set()` method of `InputSelectize` controller so it clears existing selections before applying new values. (#2024)
 
+### Deprecations
+
+* `ui.panel_well()` is deprecated in favor of `ui.card()`. (#2038)
+
 
 ## [1.4.0] - 2025-04-08
 

shiny/express/ui/_cm_components.py

@@ -7,6 +7,7 @@
 from htmltools import Tag, TagAttrs, TagAttrValue, TagChild, TagFunction, TagList
 
 from ... import ui
+from ..._deprecated import warn_deprecated
 from ..._docstring import add_example, no_example
 from ...types import DEPRECATED, MISSING, MISSING_TYPE
 from ...ui._accordion import AccordionPanel
@@ -1363,13 +1364,9 @@ def value_box(
 @no_example()
 def panel_well(**kwargs: TagAttrValue) -> RecallContextManager[Tag]:
     """
-    Context manager for a well panel
-
-    This function wraps :func:`~shiny.ui.panel_well`.
-
-    A well panel is a simple container with a border and some padding. It's useful for
-    grouping related content together.
+    Deprecated. Use :func:`~shiny.express.ui.card` instead.
     """
+    warn_deprecated("panel_well() is deprecated. Use shiny.express.ui.card() instead.")
     return RecallContextManager(
         ui.panel_well,
         kwargs=dict(

shiny/ui/_bootstrap.py

@@ -11,7 +11,6 @@
     "help_text",
 )
 
-
 from typing import Literal, Optional
 
 from htmltools import (
@@ -27,6 +26,7 @@
     tags,
 )
 
+from .._deprecated import warn_deprecated
 from .._docstring import add_example, no_example
 from ..module import current_namespace
 from ..types import MISSING, MISSING_TYPE
@@ -112,23 +112,9 @@ def column(
 @no_example()
 def panel_well(*args: TagChild | TagAttrs, **kwargs: TagAttrValue) -> Tag:
     """
-    Create a well panel.
-
-    Creates a panel with a slightly inset border and gray background. Equivalent to
-    Bootstrap's ``well`` CSS class.
-
-    Parameters
-    ----------
-    *args
-        UI elements to include inside the panel.
-    **kwargs
-        Attributes to place on the panel tag.
-
-    Returns
-    -------
-    :
-        A UI element.
+    Deprecated. Use :func:`~shiny.ui.card` instead.
     """
+    warn_deprecated("panel_well() is deprecated. Use shiny.ui.card() instead.")
     return div({"class": "well"}, *args, **kwargs)