badges+fastmcp(css): Subtle buffed-pill inset shadow on solid badges

why: Colored pills read flat on white page backgrounds; light top highlight
and soft inner shade add depth without heavy skeuomorphism.
what:
- :root --sab-buff-shadow / --sab-buff-shadow-dark-ui in sphinx_autodoc_badges
- Apply to .sab-badge excluding outline and inline-icon variants
- Mirror with !important on FastMCP safety/type rules for load-order parity

Author: tony

packages/sphinx-autodoc-badges/src/sphinx_autodoc_badges/_static/css/sphinx_autodoc_badges.css

@@ -5,6 +5,14 @@
  * (--sab-bg, --sab-fg, --sab-border).
  */
 
+:root {
+  /* Subtle “buffed pill”: top highlight + soft inner shade (light UI / white page bg) */
+  --sab-buff-shadow: inset 0 1px 0 rgba(255, 255, 255, 0.2),
+    inset 0 -1px 2px rgba(0, 0, 0, 0.12);
+  --sab-buff-shadow-dark-ui: inset 0 1px 0 rgba(255, 255, 255, 0.1),
+    inset 0 -1px 2px rgba(0, 0, 0, 0.28);
+}
+
 /* ── Base badge ─────────────────────────────────────────── */
 .sab-badge {
   display: inline-flex;
@@ -30,6 +38,20 @@
   box-sizing: border-box;
 }
 
+.sab-badge:not(.sab-outline):not(.sab-inline-icon) {
+  box-shadow: var(--sab-buff-shadow);
+}
+
+@media (prefers-color-scheme: dark) {
+  body:not([data-theme="light"]) .sab-badge:not(.sab-outline):not(.sab-inline-icon) {
+    box-shadow: var(--sab-buff-shadow-dark-ui);
+  }
+}
+
+body[data-theme="dark"] .sab-badge:not(.sab-outline):not(.sab-inline-icon) {
+  box-shadow: var(--sab-buff-shadow-dark-ui);
+}
+
 .sab-badge:focus-visible {
   outline: 2px solid var(--color-link, #2962ff);
   outline-offset: 2px;

packages/sphinx-autodoc-fastmcp/src/sphinx_autodoc_fastmcp/_static/css/sphinx_autodoc_fastmcp.css

@@ -93,35 +93,53 @@ h4.smf-tool-title .sab-badge.smf-badge--type,
   background-color: #1f7a3f !important;
   color: #f3fff7 !important;
   border: 1px solid #2a8d4d !important;
+  box-shadow: var(--sab-buff-shadow) !important;
 }
 
 .sab-badge.smf-safety-mutating:not(.sab-inline-icon) {
   background-color: #b96a1a !important;
   color: #fff8ef !important;
   border: 1px solid #cf7a23 !important;
+  box-shadow: var(--sab-buff-shadow) !important;
 }
 
 .sab-badge.smf-safety-destructive:not(.sab-inline-icon) {
   background-color: #b4232c !important;
   color: #fff5f5 !important;
   border: 1px solid #cb3640 !important;
+  box-shadow: var(--sab-buff-shadow) !important;
 }
 
 /* MCP "tool": white label (never use --sd-color-info-text; it is dark on light teal) */
 .sab-badge.smf-type-tool:not(.sab-inline-icon) {
   background-color: #0e7490 !important;
   color: #ffffff !important;
   border: 1px solid #0f766e !important;
+  box-shadow: var(--sab-buff-shadow) !important;
 }
 
 @media (prefers-color-scheme: dark) {
+  body:not([data-theme="light"]) .sab-badge.smf-safety-readonly:not(.sab-inline-icon),
+  body:not([data-theme="light"]) .sab-badge.smf-safety-mutating:not(.sab-inline-icon),
+  body:not([data-theme="light"]) .sab-badge.smf-safety-destructive:not(.sab-inline-icon),
+  body:not([data-theme="light"]) .sab-badge.smf-type-tool:not(.sab-inline-icon) {
+    box-shadow: var(--sab-buff-shadow-dark-ui) !important;
+  }
+
   body:not([data-theme="light"]) .sab-badge.smf-type-tool:not(.sab-inline-icon) {
     background-color: #0d9488 !important;
     color: #ffffff !important;
     border: 1px solid #14b8a6 !important;
   }
 }
 
+body[data-theme="dark"] .sab-badge.smf-safety-readonly:not(.sab-inline-icon),
+body[data-theme="dark"] .sab-badge.smf-safety-mutating:not(.sab-inline-icon),
+body[data-theme="dark"] .sab-badge.smf-safety-destructive:not(.sab-inline-icon),
+body[data-theme="dark"] .sab-badge.smf-type-tool:not(.sab-inline-icon) {
+  box-shadow: var(--sab-buff-shadow-dark-ui) !important;
+}
+
 body[data-theme="dark"] .sab-badge.smf-type-tool:not(.sab-inline-icon) {
   background-color: #0d9488 !important;
   color: #ffffff !important;