fix(docs): drop deprecated-badge tooltip instead of sanitizing it

Removing the `title=` tooltip on the deprecated badge avoids the reST
markup leak entirely, so the `plainifyForTooltip()` helper added in
ce02c8a is no longer needed. This mirrors the approach taken in PR
#6421 (commit 2a794af).

- Revert drag_target.py docs_reason strings to mkdocs-style links.
- Drop `title` from the SummarySection Badge and stop carrying
  `deprecation` through `memberSummary`.
- Remove the now-unused `plainifyForTooltip` from crocodocs utils.

Author: FeodorFitsner

sdk/python/packages/flet/src/flet/controls/core/drag_target.py

@@ -77,12 +77,8 @@ def __post_init__(self):
     @deprecated(
         reason="Use `local_position.x` for target-relative coordinates or "
         "`global_position.x` for global coordinates instead.",
-        docs_reason=(
-            "Use :attr:`~flet.DragTargetEvent.local_position`.x for "
-            "target-relative coordinates or "
-            ":attr:`~flet.DragTargetEvent.global_position`.x for global "
-            "coordinates instead."
-        ),
+        docs_reason="Use [`local_position.x`](../types/dragtargetevent.md#flet.DragTargetEvent.local_position) for target-relative coordinates or "  # noqa: E501
+        "[`global_position.x`](../types/dragtargetevent.md#flet.DragTargetEvent.global_position) for global coordinates instead.",  # noqa: E501
         version="0.85.0",
         delete_version="0.88.0",
     )
@@ -97,12 +93,8 @@ def x(self) -> float:
     @deprecated(
         reason="Use `local_position.y` for target-relative coordinates or "
         "`global_position.y` for global coordinates instead.",
-        docs_reason=(
-            "Use :attr:`~flet.DragTargetEvent.local_position`.y for "
-            "target-relative coordinates or "
-            ":attr:`~flet.DragTargetEvent.global_position`.y for global "
-            "coordinates instead."
-        ),
+        docs_reason="Use [`local_position.y`](../types/dragtargetevent.md#flet.DragTargetEvent.local_position) for target-relative coordinates or "  # noqa: E501
+        "[`global_position.y`](../types/dragtargetevent.md#flet.DragTargetEvent.global_position) for global coordinates instead.",  # noqa: E501
         version="0.85.0",
         delete_version="0.88.0",
     )
@@ -117,12 +109,8 @@ def y(self) -> float:
     @deprecated(
         reason="Use `local_position` for target-relative coordinates or "
         "`global_position` for global coordinates instead.",
-        docs_reason=(
-            "Use :attr:`~flet.DragTargetEvent.local_position` for "
-            "target-relative coordinates or "
-            ":attr:`~flet.DragTargetEvent.global_position` for global "
-            "coordinates instead."
-        ),
+        docs_reason="Use [`local_position`](../types/dragtargetevent.md#flet.DragTargetEvent.local_position) for target-relative coordinates or "  # noqa: E501
+        "[`global_position`](../types/dragtargetevent.md#flet.DragTargetEvent.global_position) for global coordinates instead.",  # noqa: E501
         version="0.85.0",
         delete_version="0.88.0",
     )

website/src/components/crocodocs/ClassBlock.js

@@ -6,7 +6,6 @@ import {
   firstSentenceFromDocstring,
   getApiData,
   memberAnchor,
-  plainifyForTooltip,
   renderCodeExpression,
   renderDocstring,
   renderDocstringSections,
@@ -291,14 +290,13 @@ function renderMethod(item, classSymbol, docId) {
 
 /**
  * Build the compact member data used by ClassSummary lists.
- * Carries labels/deprecation metadata so summary rows can show important badges
- * without requiring readers to scroll to the full member documentation.
+ * Carries labels so summary rows can show important badges without requiring
+ * readers to scroll to the full member documentation.
  */
 function memberSummary(item, kind) {
   return {
     name: item.name,
     kind,
-    deprecation: item.deprecation,
     labels: item.labels ?? [],
     summary: firstSentenceFromDocstring(item.docstring, item.docstring_sections),
   };
@@ -338,12 +336,7 @@ function SummarySection({title, items, classSymbol}) {
                   {" "}
                   <span className="crocodocs-member-badges crocodocs-summary-badges">
                     {labels.map((label) => (
-                      <Badge
-                        key={label}
-                        title={label === "deprecated" ? plainifyForTooltip(item.deprecation) : undefined}
-                      >
-                        {label}
-                      </Badge>
+                      <Badge key={label}>{label}</Badge>
                     ))}
                   </span>
                 </>

website/src/components/crocodocs/utils.js

@@ -396,20 +396,6 @@ function formatRestXrefLabel(target) {
   return hasCall ? `${display}()` : display;
 }
 
-/**
- * Flatten reST xrefs and inline backticks to plain text for use in HTML `title`
- * attributes (tooltips), which don't render Markdown or reST.
- */
-export function plainifyForTooltip(text) {
-  if (!text) {
-    return text;
-  }
-  const roleRe = /:(?:py:)?(?:class|attr|meth|func|data|mod|obj):`([^`\n]+)`/g;
-  return text
-    .replace(roleRe, (_, target) => formatRestXrefLabel(target))
-    .replace(/`([^`\n]+)`/g, "$1");
-}
-
 /**
  * Resolve a reStructuredText cross-reference (:py:class:`Foo`, :attr:`bar`, etc.) to a href and label.
  * Tries local member resolution, then class context, then full symbol lookup, then base class walking.