Remove stubs and add xpx method for IDE support

Author: FBumann

pyproject.toml

@@ -23,7 +23,6 @@ dependencies = [
     "xarray>=2023.1.0",
     "plotly>=5.0.0",
     "pandas>=1.5.0",
-    "xarray-plotly-stubs>=0.1.0",
 ]
 
 [project.urls]

stubs/README.md

@@ -27,7 +27,7 @@
 
 from importlib.metadata import version
 
-from xarray import register_dataarray_accessor
+from xarray import DataArray, register_dataarray_accessor
 
 from xarray_plotly.accessor import DataArrayPlotlyAccessor
 from xarray_plotly.common import SLOT_ORDERS, auto
@@ -36,8 +36,35 @@
     "DataArrayPlotlyAccessor",
     "SLOT_ORDERS",
     "auto",
+    "xpx",
 ]
 
+
+def xpx(da: DataArray) -> DataArrayPlotlyAccessor:
+    """
+    Get the plotly accessor for a DataArray with full IDE code completion.
+
+    This is an alternative to `da.plotly` that provides proper type hints
+    and code completion in IDEs.
+
+    Parameters
+    ----------
+    da : DataArray
+        The DataArray to plot.
+
+    Returns
+    -------
+    DataArrayPlotlyAccessor
+        The accessor with plotting methods.
+
+    Examples
+    --------
+    >>> from xarray_plotly import xpx
+    >>> fig = xpx(da).line()  # Full code completion works here
+    """
+    return DataArrayPlotlyAccessor(da)
+
+
 __version__ = version("xarray_plotly")
 
 # Register the accessor