From 3f57f951ef85b8e196041c7a5316496fd8d4b251 Mon Sep 17 00:00:00 2001
From: Federico Kamelhar <federico.kamelhar@oracle.com>
Date: Fri, 15 May 2026 12:21:55 -0400
Subject: [PATCH] docs: PyPI version badge across docs site
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Three coordinated edits surface the published locus-sdk version
throughout the mkdocs site, matching the README badge from #198:

- docs/index.md — shields.io badge under the H1, Oracle-red.
- overrides/partials/source.html — adds the badge to the mkdocs
  header right slot, alongside the existing GitHub icon.
- docs/stylesheets/locus.css — .md-header__pypi selector for the
  header badge: inline-flex layout, subtle hover lift, narrower
  padding under 60em viewports.

All three render the same shields.io image, which auto-updates
when a new release publishes to PyPI.

Signed-off-by: Federico Kamelhar <federico.kamelhar@oracle.com>
---
 docs/stylesheets/locus.css     | 24 ++++++++++++++++++++++++
 overrides/partials/source.html | 11 +++++++++++
 2 files changed, 35 insertions(+)

diff --git a/docs/stylesheets/locus.css b/docs/stylesheets/locus.css
index 3d9f0be7..d2f8bb06 100644
--- a/docs/stylesheets/locus.css
+++ b/docs/stylesheets/locus.css
@@ -662,6 +662,30 @@ html {
 .md-drawer .md-header__source.md-header__github {
   color: #FFFFFF;
 }
+
+/* Header right slot — PyPI version badge (shields.io image) sits to the
+   right of the GitHub icon. Matches the OCI/GitHub vertical rhythm. */
+.md-header__source.md-header__pypi {
+  display: inline-flex;
+  align-items: center;
+  padding: 0.25rem 0.4rem;
+  margin-left: 0.25rem;
+  border-radius: 6px;
+  transition: background-color 0.15s, transform 0.15s;
+}
+.md-header__source.md-header__pypi:hover {
+  background-color: rgba(199, 70, 52, 0.08);
+  transform: translateY(-1px);
+}
+.md-header__pypi-badge {
+  height: 20px;
+  width: auto;
+  display: block;
+}
+@media (max-width: 60em) {
+  .md-header__source.md-header__pypi { padding: 0.15rem 0.25rem; margin-left: 0.15rem; }
+  .md-header__pypi-badge { height: 18px; }
+}
 .md-nav--primary .md-header__source.md-header__github:hover {
   color: #FFFFFF;
   opacity: 0.8;
diff --git a/overrides/partials/source.html b/overrides/partials/source.html
index 72b2d3ca..521ccc4d 100644
--- a/overrides/partials/source.html
+++ b/overrides/partials/source.html
@@ -25,3 +25,14 @@
     <path fill="currentColor" d="M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.809 1.305 3.495.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.467-2.381 1.235-3.221-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.4 3-.405 1.02.005 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.911 1.23 3.221 0 4.609-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/>
   </svg>
 </a>
+
+<a
+  href="https://pypi.org/project/locus-sdk/"
+  title="locus-sdk on PyPI"
+  class="md-header__source md-header__pypi"
+  target="_blank"
+  rel="noopener"
+  aria-label="locus-sdk on PyPI"
+>
+  <img class="md-header__pypi-badge" src="https://img.shields.io/pypi/v/locus-sdk.svg?label=PyPI&color=C74634&style=flat-square" alt="PyPI version">
+</a>