Deprecate panel_well() in favor of card()

Author: cpsievert

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)