Fix search; fix zensical dependency

docs/.overrides/main.html

@@ -61,6 +61,9 @@ Replace the mkdocs header entirely to look more like Mintlify's theme
       {% include ".icons/material/menu.svg" %}
     </label>
 
+    <!-- Hidden checkbox for search toggle -->
+    <input class="md-toggle" type="checkbox" id="__search">
+
     <!-- Site title -->
     <div class="md-header__title" data-md-component="header-title">
       <div class="md-header__ellipsis">
@@ -91,6 +94,11 @@ Replace the mkdocs header entirely to look more like Mintlify's theme
     </div>
     {% include "partials/search.html" %}
 
+    <!-- Mobile search button -->
+    <label class="md-header__button md-icon" for="__search">
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"></path></svg>
+    </label>
+
     <!-- Navigation links container -->
     <div class="md-header__nav-links">
       <!-- Discord (icon only) -->

docs/requirements.in

@@ -1,5 +1,5 @@
 black>=23.10.0
-zensical
+zensical>=0.0.5
 mdformat>=0.7.17
 mdformat-mkdocs>=2.0.4
 mdformat-admon>=2.0.2

docs/requirements.txt

@@ -1,47 +1,39 @@
 # This file was autogenerated by uv via the following command:
 #    uv pip compile docs/requirements.in -o docs/requirements.txt --universal -p 3.12
 babel==2.15.0
-    # via
+    # via mkdocs-git-revision-date-localized-plugin
-    #   mkdocs-git-revision-date-localized-plugin
-    #   mkdocs-material
 beautifulsoup4==4.13.4
     # via
     #   markdownify
     #   mkdocs-llmstxt
 black==24.4.2
     # via -r docs/requirements.in
-certifi==2024.7.4
+click==8.3.0
-    # via requests
-charset-normalizer==3.3.2
-    # via requests
-click==8.1.7
     # via
     #   black
     #   mkdocs
-colorama==0.4.6
+    #   zensical
+colorama==0.4.6 ; sys_platform == 'win32'
     # via
     #   click
     #   mkdocs
-    #   mkdocs-material
+deepmerge==2.0
+    # via zensical
 ghp-import==2.1.0
     # via mkdocs
 gitdb==4.0.12
     # via gitpython
 gitpython==3.1.44
     # via mkdocs-git-revision-date-localized-plugin
-idna==3.7
-    # via requests
 jinja2==3.1.4
-    # via
+    # via mkdocs
-    #   mkdocs
-    #   mkdocs-material
 linkify-it-py==2.0.3
     # via markdown-it-py
-markdown==3.6
+markdown==3.10
     # via
     #   mkdocs
-    #   mkdocs-material
     #   pymdown-extensions
+    #   zensical
 markdown-it-py==3.0.0
     # via
     #   mdformat
@@ -84,9 +76,7 @@ mergedeep==1.3.4
     #   mkdocs-get-deps
 mkdocs==1.6.0
     # via
-    #   -r docs/requirements.in
     #   mkdocs-git-revision-date-localized-plugin
-    #   mkdocs-material
     #   mkdocs-redirects
 mkdocs-get-deps==0.2.0
     # via mkdocs
@@ -94,10 +84,6 @@ mkdocs-git-revision-date-localized-plugin==1.3.0
     # via -r docs/requirements.in
 mkdocs-llmstxt==0.2.0
     # via -r docs/requirements.in
-mkdocs-material==9.5.29
-    # via -r docs/requirements.in
-mkdocs-material-extensions==1.3.1
-    # via mkdocs-material
 mkdocs-redirects==1.2.2
     # via -r docs/requirements.in
 more-itertools==10.3.0
@@ -108,8 +94,6 @@ packaging==24.1
     # via
     #   black
     #   mkdocs
-paginate==0.5.6
-    # via mkdocs-material
 pathspec==0.12.1
     # via
     #   black
@@ -119,25 +103,22 @@ platformdirs==4.2.2
     #   black
     #   mkdocs-get-deps
 pygments==2.18.0
-    # via mkdocs-material
+    # via zensical
-pymdown-extensions==10.8.1
+pymdown-extensions==10.16.1
-    # via mkdocs-material
+    # via zensical
 python-dateutil==2.9.0.post0
     # via ghp-import
 pytz==2025.1
     # via mkdocs-git-revision-date-localized-plugin
-pyyaml==6.0.1
+pyyaml==6.0.3
     # via
     #   mkdocs
     #   mkdocs-get-deps
     #   pymdown-extensions
     #   pyyaml-env-tag
+    #   zensical
 pyyaml-env-tag==0.1
     # via mkdocs
-regex==2024.5.15
-    # via mkdocs-material
-requests==2.32.3
-    # via mkdocs-material
 six==1.16.0
     # via
     #   markdownify
@@ -150,7 +131,7 @@ typing-extensions==4.14.0
     # via beautifulsoup4
 uc-micro-py==1.0.3
     # via linkify-it-py
-urllib3==2.2.2
-    # via requests
 watchdog==4.0.1
     # via mkdocs
+zensical==0.0.5
+    # via -r docs/requirements.in

docs/stylesheets/extra.css

@@ -258,7 +258,7 @@ modifications */
   It has no children, so it is not considered a section */
   .md-nav--primary > .md-nav__list > .md-nav__item:first-of-type {
     font-size: 0.85rem;
-    margin-bottom: 0.75em;
+    margin-bottom: 0.25em;
     font-weight: bold;
   }
 }
@@ -366,10 +366,6 @@ modifications */
   margin-left: auto;
 }
 
-/* Enhanced search bar styling for better prominence */
-.md-search {
-  order: 2;
-}
 
 /* Make search field more prominent and centered */
 @media screen and (min-width: 60em) {
@@ -554,7 +550,6 @@ modifications */
   box-shadow: 0 1px 0 0 rgba(255, 255, 255, 0.025);
 }
 
-/* Refine header layout for centered search */
 @media screen and (min-width: 76.25em) {
 
   /* Hide the search modal's button that appears in the header */
@@ -647,4 +642,54 @@ modifications */
     margin-left: 0.5rem;
     flex-shrink: 0;
   }
+
+  /* Show and style mobile search button */
+  .md-header__button.md-icon[for="__search"] {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 1.875rem;
+    height: 1.75rem;
+    padding: 0;
+    background-color: transparent;
+    border: 1px solid rgba(0, 0, 0, 0.08);
+    border-radius: 0.5rem;
+    order: 9;
+    margin-left: 0.5rem;
+    margin-right: 0.75rem; /* Extra spacing from Discord/GitHub */
+    transition: all 0.15s ease;
+  }
+
+  .md-header__button.md-icon[for="__search"]:hover {
+    background-color: rgba(0, 0, 0, 0.03);
+    border-color: rgba(0, 0, 0, 0.15);
+  }
+
+  .md-header__button.md-icon[for="__search"] svg {
+    width: 16px;
+    height: 16px;
+    color: rgba(0, 0, 0, 0.6);
+  }
+
+  .md-header__button.md-icon[for="__search"]:hover svg {
+    color: rgba(0, 0, 0, 0.85);
+  }
+
+  /* Dark mode mobile search button */
+  [data-md-color-scheme="astral-dark"] .md-header__button.md-icon[for="__search"] {
+    border-color: rgba(255, 255, 255, 0.1);
+  }
+
+  [data-md-color-scheme="astral-dark"] .md-header__button.md-icon[for="__search"]:hover {
+    background-color: rgba(255, 255, 255, 0.05);
+    border-color: rgba(255, 255, 255, 0.2);
+  }
+
+  [data-md-color-scheme="astral-dark"] .md-header__button.md-icon[for="__search"] svg {
+    color: rgba(255, 255, 255, 0.6);
+  }
+
+  [data-md-color-scheme="astral-dark"] .md-header__button.md-icon[for="__search"]:hover svg {
+    color: rgba(255, 255, 255, 0.85);
+  }
 }