docs(_ext[sphinx_pytest_fixtures]): right-align badges, reorder sig elements, restore FIXTURE visibility

why: Badges should be right-aligned in the card header with [source]
at the very end. The FIXTURE badge at opacity 0.55 was too dim. The
signature elements needed tighter flow with badges pushed right.

what:
- Reorder sig children in _on_doctree_resolved: detach [source] and
  headerlink, re-append as ¶ → badges → [source]
- Restore margin-left: auto on spf-badge-group for right alignment
- Increase FIXTURE badge opacity from 0.55 to 0.82
- Keep align-items: center for vertical middle alignment
- Keep gap: 0.35rem for tight signature element spacing

Author: tony

docs/_ext/sphinx_pytest_fixtures.py

@@ -1812,27 +1812,31 @@ def _on_doctree_resolved(
 
             badge_group = _build_badge_group_node(scope, kind, autouse)
 
-            # Insert badges after the headerlink (¶) but before the [source]
-            # viewcode link.  Desired order:
-            #   name → return → ¶ → badges → [source]
-            # The [source] link is a ``reference`` with a ``viewcode-link``
-            # child span.  If found, move it to the end after the badge group.
+            # Reorder signature children to:
+            #   name → return → ¶ → badges (right-aligned) → [source]
+            # Detach [source] and ¶ links, then re-append in desired order.
             viewcode_ref = None
+            headerlink_ref = None
             for child in list(sig_node.children):
-                if (
-                    isinstance(child, nodes.reference)
-                    and child.get("internal") is not True
-                    and any(
+                if isinstance(child, nodes.reference):
+                    # [source] link: external reference with viewcode-link child
+                    if child.get("internal") is not True and any(
                         "viewcode-link"
                         in getattr(gc, "get", lambda *_: "")("classes", [])
                         for gc in child.children
                         if isinstance(gc, nodes.inline)
-                    )
-                ):
-                    viewcode_ref = child
-                    sig_node.remove(child)
-                    break
-
+                    ):
+                        viewcode_ref = child
+                        sig_node.remove(child)
+                    # ¶ headerlink: internal reference with "headerlink" class
+                    elif "headerlink" in child.get("classes", []):
+                        headerlink_ref = child
+                        sig_node.remove(child)
+
+            # Re-append: ¶ first (inline with signature), then badges
+            # (right-aligned via margin-left:auto), then [source] last.
+            if headerlink_ref is not None:
+                sig_node += headerlink_ref
             sig_node += badge_group
             if viewcode_ref is not None:
                 sig_node += viewcode_ref

docs/_static/css/custom.css

@@ -373,7 +373,7 @@ dl.py.fixture > dt span.spf-badge-group {
   align-items: center;
   gap: 0.3rem;
   flex-shrink: 0;
-  margin-left: auto;  /* push badges to the right edge */
+  margin-left: auto;
   white-space: nowrap;
   user-select: none;
   -webkit-user-select: none;
@@ -410,7 +410,7 @@ dl.py.fixture > dt span.spf-badge--fixture {
   background-color: var(--spf-fixture-bg);
   color: var(--spf-fixture-fg);
   border-color: var(--spf-fixture-border);
-  opacity: 0.55;
+  opacity: 0.82;
   font-size: calc(var(--spf-badge-font-size) * 0.85);
 }