fix(typing): Add @sentry_sdk.traces.trace overloads to fix typing (#6236)

Changing `sentry_sdk.trace` to `sentry_sdk.traces.trace` introduced a
whole avalanche of [typing
issues](https://github.com/getsentry/seer/actions/runs/25495762136/job/74814929830?pr=6291).

Adding the overloads we have for the original `trace`.

Author: sentrivana

sentry_sdk/traces.py

@@ -37,6 +37,7 @@
         Callable,
         Iterator,
         Optional,
+        overload,
         ParamSpec,
         TypeVar,
         Union,
@@ -703,6 +704,23 @@ def timestamp(self) -> "Optional[datetime]":
         return None
 
 
+if TYPE_CHECKING:
+
+    @overload
+    def trace(
+        func: "Callable[P, R]",
+    ) -> "Callable[P, R]": ...
+
+    @overload
+    def trace(
+        func: None = None,
+        *,
+        name: "Optional[str]" = None,
+        attributes: "Optional[dict[str, Any]]" = None,
+        active: bool = True,
+    ) -> "Callable[[Callable[P, R]], Callable[P, R]]": ...
+
+
 def trace(
     func: "Optional[Callable[P, R]]" = None,
     *,