From 677348c0c232c3e473537ae45b41746313722c21 Mon Sep 17 00:00:00 2001
From: eduardocamacho10 <eddy10cam@gmail.com>
Date: Fri, 8 Aug 2025 21:12:43 -0400
Subject: [PATCH] DOC: Add docstring for asarray_tuplesafe in common.py

---
 pandas/core/common.py | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/pandas/core/common.py b/pandas/core/common.py
index c25d910b73100..c0b6ce556e0c5 100644
--- a/pandas/core/common.py
+++ b/pandas/core/common.py
@@ -232,6 +232,27 @@ def asarray_tuplesafe(values: Iterable, dtype: NpDtype | None = ...) -> ArrayLik
 
 
 def asarray_tuplesafe(values: Iterable, dtype: NpDtype | None = None) -> ArrayLike:
+    """
+    Convert input values to a NumPy array or ExtensionArray,
+    preserving tuples as single elements.
+
+    Parameters
+    ----------
+    values : iterable or array-like
+        The data to be converted. Tuples preserved as single elements.
+    dtype : numpy.dtype or None, default None
+        Data type for the result. If None, the dtype is inferred.
+
+    Returns
+    -------
+    ndarray or ExtensionArray
+        The converted array or extension array.
+
+    Notes
+    -----
+    For object dtype lists, uses
+    `construct_1d_object_array_from_listlike` to preserve structure.
+    """
     if not (isinstance(values, (list, tuple)) or hasattr(values, "__array__")):
         values = list(values)
     elif isinstance(values, ABCIndex):