docs: implement native-style version badge in header

docs/assets/stylesheets/extra.css

@@ -638,6 +638,36 @@
   border-bottom-color: var(--zz-muted-color);
 }
 
+/* ── Version fact in header source widget ─────────────────────────────────── */
+
+/* Layout: repo name on row 1, stars+version on row 2 side by side */
+.md-source__repository {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  row-gap: 0;
+}
+
+.zz-repo-name {
+  width: 100%;      /* forces repo name onto its own line */
+  order: 0;
+}
+
+/* JS-injected stars/forks <ul>: row 2, left */
+.md-source__repository > .md-source__facts:not(.zz-version-facts) {
+  order: 1;
+  margin-top: 0.1rem;
+  flex-shrink: 0;
+}
+
+/* Static version <ul>: row 2, right — separator via gap */
+.zz-version-facts {
+  order: 2;
+  margin-top: 0.1rem;
+  margin-left: 0.4rem;
+  flex-shrink: 0;
+}
+
 /* ── Footer copyright ─────────────────────────────────────────────────────── */
 
 .md-copyright__highlight {

mkdocs.yml

@@ -39,6 +39,7 @@ theme:
     - navigation.indexes
     - navigation.path
     - navigation.top
+    - navigation.header.version
     - navigation.footer
     - search.highlight
     - search.suggest
@@ -141,7 +142,7 @@ extra_css:
 extra:
   build_date: !ENV [BUILD_DATE, "dev"]
   generator: false
-  project_version: "0.4.0rc4"
+  version: "0.4.0rc4"
   social:
     - icon: fontawesome/brands/github
       link: https://github.com/PythonWoods/zenzic

overrides/partials/source.html

@@ -0,0 +1,23 @@
+{# SPDX-FileCopyrightText: 2026 PythonWoods <dev@pythonwoods.dev> #}
+{# SPDX-License-Identifier: Apache-2.0 #}
+{#
+  source.html — extends Material's default with a version fact row.
+  The version fact mirrors .md-source__facts (stars/forks) so it aligns
+  at the same left edge as those items (inside .md-source__repository).
+#}
+<a href="{{ config.repo_url }}" title="{{ lang.t('source') }}" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    {% set icon = config.theme.icon.repo or "fontawesome/brands/git-alt" %}
+    {% include ".icons/" ~ icon ~ ".svg" %}
+  </div>
+  <div class="md-source__repository">
+    <span class="zz-repo-name">{{ config.repo_name }}</span>
+    {% if config.extra.version %}
+      <ul class="md-source__facts zz-version-facts">
+        <li class="md-source__fact md-source__fact--version">
+          {{ config.extra.version }}
+        </li>
+      </ul>
+    {% endif %}
+  </div>
+</a>

pyproject.toml

@@ -182,8 +182,8 @@ replace = '__version__ = "{new_version}"'
 
 [[tool.bumpversion.files]]
 filename = "mkdocs.yml"
-search = 'project_version: "{current_version}"'
-replace = 'project_version: "{new_version}"'
+search = 'version: "{current_version}"'
+replace = 'version: "{new_version}"'
 
 [[tool.bumpversion.files]]
 filename = "CITATION.cff"