enya-agent 0.1.0

package/docs/themes/tanuki/templates/partials/header.html

@@ -0,0 +1,366 @@
+{# Header / Navigation - raskell.io style #}
+{% set mode = config.extra.mode | default(value="site") %}
+
+{% if mode == "site" or mode == "blog" %}
+{# raskell.io style header for site/blog mode #}
+<header class="navbar" role="banner">
+    <div class="container">
+        <div class="flex">
+            <div>
+                <a class="brand" href="{{ config.base_url | safe }}" aria-label="{{ config.title }} Home">
+                    {% if config.extra.logo %}
+                    <img src="{{ get_url(path=config.extra.logo) }}" alt="" class="brand-logo" aria-hidden="true" />
+                    {% endif %}
+                    <span class="brand-text">{{ config.title }}</span>
+                </a>
+            </div>
+            <nav class="flex nav-links" role="navigation" aria-label="Main navigation">
+                {% if config.extra.nav %}
+                    {% for link in config.extra.nav %}
+                    <a href="{{ link.url | safe }}">{{ link.name }}</a>
+                    {% endfor %}
+                {% elif config.extra.nav_links %}
+                    {% for link in config.extra.nav_links %}
+                        {% if link.children %}
+                        <div class="nav-dropdown">
+                            <button class="nav-dropdown__trigger" type="button" aria-expanded="false" aria-haspopup="true">
+                                {{ link.name }}
+                                <svg class="nav-dropdown__chevron" xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg>
+                            </button>
+                            <div class="nav-dropdown__menu" role="menu">
+                                {% for child in link.children %}
+                                <a href="{{ child.url | safe }}" role="menuitem"{% if child.external %} target="_blank" rel="noopener noreferrer"{% endif %}>
+                                    {{ child.name }}
+                                    {% if child.external %}
+                                    <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/><polyline points="15 3 21 3 21 9"/><line x1="10" x2="21" y1="14" y2="3"/></svg>
+                                    {% endif %}
+                                </a>
+                                {% endfor %}
+                            </div>
+                        </div>
+                        {% else %}
+                        <a href="{{ link.url | safe }}"{% if link.external %} target="_blank" rel="noopener noreferrer"{% endif %}>
+                            {{ link.name }}
+                            {% if link.external %}
+                            <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/><polyline points="15 3 21 3 21 9"/><line x1="10" x2="21" y1="14" y2="3"/></svg>
+                            {% endif %}
+                        </a>
+                        {% endif %}
+                    {% endfor %}
+                {% endif %}
+                {% if config.build_search_index %}
+                <button class="search-toggle" type="button" aria-label="Search" title="Search (/)">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                        <circle cx="11" cy="11" r="8"/>
+                        <path d="m21 21-4.3-4.3"/>
+                    </svg>
+                </button>
+                {% endif %}
+                {% if config.extra.color_scheme_toggle | default(value=true) %}
+                <button class="theme-toggle" type="button" aria-label="Toggle color theme" aria-live="polite" title="Toggle theme">
+                    <span class="theme-toggle__icons">
+                        <span class="theme-toggle__sun" aria-hidden="true">
+                            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                                <circle cx="12" cy="12" r="4"/>
+                                <path d="M12 2v2"/>
+                                <path d="M12 20v2"/>
+                                <path d="m4.93 4.93 1.41 1.41"/>
+                                <path d="m17.66 17.66 1.41 1.41"/>
+                                <path d="M2 12h2"/>
+                                <path d="M20 12h2"/>
+                                <path d="m6.34 17.66-1.41 1.41"/>
+                                <path d="m19.07 4.93-1.41 1.41"/>
+                            </svg>
+                        </span>
+                        <span class="theme-toggle__moon" aria-hidden="true">
+                            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                                <path d="M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z"/>
+                            </svg>
+                        </span>
+                        <span class="theme-toggle__auto" aria-hidden="true">
+                            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                                <circle cx="12" cy="12" r="10"/>
+                                <path d="M12 2a7 7 0 1 0 7 7"/>
+                            </svg>
+                        </span>
+                    </span>
+                </button>
+                {% endif %}
+            </nav>
+            <button id="mobile-menu-button" class="mobile-menu-button" aria-label="Open navigation menu" aria-expanded="false" aria-controls="mobile-menu-overlay">
+                <svg class="menu-icon" aria-hidden="true" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                    <line x1="3" y1="6" x2="21" y2="6"></line>
+                    <line x1="3" y1="12" x2="21" y2="12"></line>
+                    <line x1="3" y1="18" x2="21" y2="18"></line>
+                </svg>
+                <svg class="close-icon" aria-hidden="true" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                    <line x1="18" y1="6" x2="6" y2="18"></line>
+                    <line x1="6" y1="6" x2="18" y2="18"></line>
+                </svg>
+            </button>
+        </div>
+    </div>
+</header>
+
+<div id="mobile-menu-overlay" class="mobile-menu-overlay" role="dialog" aria-modal="true" aria-label="Navigation menu" aria-hidden="true">
+    <nav class="mobile-menu-content" role="navigation" aria-label="Mobile navigation">
+        {% if config.extra.nav %}
+            {% for link in config.extra.nav %}
+            <a href="{{ link.url | safe }}">{{ link.name }}</a>
+            {% endfor %}
+        {% elif config.extra.nav_links %}
+            {% for link in config.extra.nav_links %}
+                {% if link.children %}
+                <div class="mobile-nav-group">
+                    <span class="mobile-nav-group__label">{{ link.name }}</span>
+                    {% for child in link.children %}
+                    <a href="{{ child.url | safe }}"{% if child.external %} target="_blank" rel="noopener noreferrer"{% endif %}>
+                        {{ child.name }}
+                        {% if child.external %}
+                        <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/><polyline points="15 3 21 3 21 9"/><line x1="10" x2="21" y1="14" y2="3"/></svg>
+                        {% endif %}
+                    </a>
+                    {% endfor %}
+                </div>
+                {% else %}
+                <a href="{{ link.url | safe }}"{% if link.external %} target="_blank" rel="noopener noreferrer"{% endif %}>
+                    {{ link.name }}
+                    {% if link.external %}
+                    <svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/><polyline points="15 3 21 3 21 9"/><line x1="10" x2="21" y1="14" y2="3"/></svg>
+                    {% endif %}
+                </a>
+                {% endif %}
+            {% endfor %}
+        {% endif %}
+        {% if config.build_search_index %}
+        <button class="search-toggle mobile-search-toggle" type="button" aria-label="Search">
+            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                <circle cx="11" cy="11" r="8"/>
+                <path d="m21 21-4.3-4.3"/>
+            </svg>
+            <span class="search-label">Search</span>
+        </button>
+        {% endif %}
+        {% if config.extra.color_scheme_toggle | default(value=true) %}
+        <button class="theme-toggle mobile-theme-toggle" type="button" aria-label="Toggle theme">
+            <span class="theme-toggle__icons">
+                <span class="theme-toggle__sun" aria-hidden="true">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                        <circle cx="12" cy="12" r="4"/>
+                        <path d="M12 2v2"/>
+                        <path d="M12 20v2"/>
+                        <path d="m4.93 4.93 1.41 1.41"/>
+                        <path d="m17.66 17.66 1.41 1.41"/>
+                        <path d="M2 12h2"/>
+                        <path d="M20 12h2"/>
+                        <path d="m6.34 17.66-1.41 1.41"/>
+                        <path d="m19.07 4.93-1.41 1.41"/>
+                    </svg>
+                </span>
+                <span class="theme-toggle__moon" aria-hidden="true">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                        <path d="M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z"/>
+                    </svg>
+                </span>
+                <span class="theme-toggle__auto" aria-hidden="true">
+                    <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                        <circle cx="12" cy="12" r="10"/>
+                        <path d="M12 2a7 7 0 1 0 7 7"/>
+                    </svg>
+                </span>
+            </span>
+            <span class="theme-label">Toggle theme</span>
+        </button>
+        {% endif %}
+    </nav>
+</div>
+
+{% if config.build_search_index %}
+<div class="search-overlay" role="dialog" aria-modal="true" aria-labelledby="search-title">
+    <div class="search">
+        <h2 id="search-title" class="sr-only">Search</h2>
+        <div class="search__input-wrapper">
+            <span class="search__icon" aria-hidden="true">
+                <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                    <circle cx="11" cy="11" r="8"/>
+                    <path d="m21 21-4.3-4.3"/>
+                </svg>
+            </span>
+            <input type="search" class="search__input" placeholder="Search articles..." autocomplete="off" aria-label="Search query">
+            <span class="search__shortcut" aria-hidden="true">/</span>
+            <button class="search__close" type="button" aria-label="Close search" title="Close (Esc)">
+                <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                    <path d="M18 6 6 18"/>
+                    <path d="m6 6 12 12"/>
+                </svg>
+            </button>
+        </div>
+        <div class="search__results" role="listbox" aria-label="Search results"></div>
+        <footer class="search__footer">
+            <nav class="search__hints" aria-label="Keyboard shortcuts">
+                <span class="search__hint"><kbd>↑</kbd><kbd>↓</kbd> Navigate</span>
+                <span class="search__hint"><kbd>↵</kbd> Select</span>
+                <span class="search__hint"><kbd>esc</kbd> Close</span>
+            </nav>
+        </footer>
+    </div>
+</div>
+{% endif %}
+
+{% else %}
+{# Original tanuki header for docs/book/product modes #}
+<header class="header" role="banner">
+    <div class="header__left">
+        {# Sidebar toggle for docs mode - desktop only #}
+        {% if mode == "docs" %}
+        <button class="sidebar-toggle" type="button" aria-label="Toggle sidebar navigation" aria-expanded="true" aria-controls="sidebar" title="Toggle sidebar">
+            <svg class="sidebar-toggle__icon sidebar-toggle__icon--open" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                <rect width="18" height="18" x="3" y="3" rx="2"/>
+                <path d="M9 3v18"/>
+                <path d="m16 15-3-3 3-3"/>
+            </svg>
+            <svg class="sidebar-toggle__icon sidebar-toggle__icon--closed" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                <rect width="18" height="18" x="3" y="3" rx="2"/>
+                <path d="M9 3v18"/>
+                <path d="m14 9 3 3-3 3"/>
+            </svg>
+        </button>
+        {% endif %}
+
+        {# ToC button for docs mode (mobile only) - opens sidebar #}
+        {% if mode == "docs" %}
+        <button class="toc-toggle toc-toggle--docs" type="button" aria-label="Open table of contents" aria-expanded="false" aria-controls="sidebar" title="Table of contents">
+            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                <rect width="18" height="18" x="3" y="3" rx="2"/>
+                <path d="M9 3v18"/>
+                <path d="m16 15-3-3 3-3"/>
+            </svg>
+        </button>
+        {% endif %}
+
+        {# ToC button for book mode - opens ToC overlay #}
+        {% if mode == "book" %}
+        <button class="toc-toggle" type="button" aria-label="Open table of contents" aria-expanded="false" aria-controls="toc-overlay" title="Table of contents">
+            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                <path d="M16 5H3"/>
+                <path d="M16 12H3"/>
+                <path d="M16 19H3"/>
+                <path d="M21 5h.01"/>
+                <path d="M21 12h.01"/>
+                <path d="M21 19h.01"/>
+            </svg>
+        </button>
+        {% endif %}
+
+        {# Home site link (e.g., back to main landing page) #}
+        {% if config.extra.home_site %}
+        <a href="{{ config.extra.home_site.url | safe }}" class="header__home" aria-label="Go to {{ config.extra.home_site.name | default(value='home') }}" title="{{ config.extra.home_site.name | default(value='Home') }}">
+            {% if config.extra.home_site.logo %}
+            {% set home_logo_path = config.extra.home_site.logo %}
+            {% if not home_logo_path is containing("/") %}
+                {% set home_logo_path = "assets/" ~ home_logo_path %}
+            {% endif %}
+            <img src="{{ get_url(path=home_logo_path) | safe }}" alt="{{ config.extra.home_site.name | default(value='Home') }}" class="header__home-logo">
+            {% else %}
+            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                <path d="m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"/>
+                <polyline points="9 22 9 12 15 12 15 22"/>
+            </svg>
+            {% endif %}
+        </a>
+        <span class="header__separator" aria-hidden="true"></span>
+        {% endif %}
+
+        {# Logo / Title #}
+        <a href="{{ config.base_url | safe }}" class="header__logo" aria-label="{{ config.title }} - Go to homepage">
+            {% if config.extra.logo %}
+            {% set logo_path = config.extra.logo %}
+            {% if not logo_path is containing("/") %}
+                {% set logo_path = "assets/" ~ logo_path %}
+            {% endif %}
+            <img src="{{ get_url(path=logo_path) | safe }}" alt="" aria-hidden="true">
+            {% endif %}
+            <span>{{ config.title }}</span>
+        </a>
+    </div>
+
+    {# Navigation Links #}
+    <nav class="header__nav" role="navigation" aria-label="Main navigation">
+        {% if config.extra.nav %}
+            {% for link in config.extra.nav %}
+            <a href="{{ link.url | safe }}" class="header__link {% if current_path is defined and current_path == link.url %}active{% endif %}">
+                {{ link.name }}
+            </a>
+            {% endfor %}
+        {% elif config.extra.nav_links %}
+            {% for link in config.extra.nav_links %}
+                {% if link.children %}
+                <div class="nav-dropdown">
+                    <button class="nav-dropdown__trigger header__link" type="button" aria-expanded="false" aria-haspopup="true">
+                        {{ link.name }}
+                        <svg class="nav-dropdown__chevron" xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg>
+                    </button>
+                    <div class="nav-dropdown__menu" role="menu">
+                        {% for child in link.children %}
+                        <a href="{{ child.url | safe }}" role="menuitem"{% if child.external %} target="_blank" rel="noopener noreferrer"{% endif %}>
+                            {{ child.name }}
+                        </a>
+                        {% endfor %}
+                    </div>
+                </div>
+                {% else %}
+                <a href="{{ link.url | safe }}" class="header__link {% if current_path is defined and current_path == link.url %}active{% endif %}"{% if link.external %} target="_blank" rel="noopener noreferrer"{% endif %}>
+                    {{ link.name }}
+                </a>
+                {% endif %}
+            {% endfor %}
+        {% endif %}
+    </nav>
+
+    {# Actions #}
+    <div class="header__actions" role="group" aria-label="Site actions">
+        {# Search toggle #}
+        {% if config.build_search_index %}
+        <button class="search-toggle" type="button" aria-label="Open search dialog" aria-keyshortcuts="/" aria-haspopup="dialog" title="Search (press /)">
+            <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                <circle cx="11" cy="11" r="8"/>
+                <path d="m21 21-4.3-4.3"/>
+            </svg>
+        </button>
+        {% endif %}
+
+        {# Desktop-only actions for docs mode #}
+        <div class="header__actions-desktop">
+            {# Version picker (for docs mode only) #}
+            {% if mode == "docs" and config.extra.versions is defined %}
+            {% include "partials/version-picker.html" %}
+            {% endif %}
+
+            {# Theme toggle #}
+            {% if config.extra.show_theme_toggle | default(value=true) %}
+            {% include "partials/theme-toggle.html" %}
+            {% endif %}
+
+            {# Edit on GitHub link #}
+            {% if config.extra.edit_url and page %}
+            <a href="{{ config.extra.edit_url }}/{{ page.relative_path }}" class="btn btn--icon btn--ghost" aria-label="Edit this page on GitHub (opens in new tab)" target="_blank" rel="noopener noreferrer" title="Edit this page">
+                <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                    <path d="M17 3a2.85 2.83 0 1 1 4 4L7.5 20.5 2 22l1.5-5.5Z"/>
+                    <path d="m15 5 4 4"/>
+                </svg>
+            </a>
+            {% endif %}
+
+            {# GitHub link #}
+            {% if config.extra.github %}
+            <a href="{{ config.extra.github }}" class="btn btn--icon btn--ghost" aria-label="View project on GitHub (opens in new tab)" target="_blank" rel="noopener noreferrer" title="GitHub">
+                <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                    <path d="M15 22v-4a4.8 4.8 0 0 0-1-3.5c3 0 6-2 6-5.5.08-1.25-.27-2.48-1-3.5.28-1.15.28-2.35 0-3.5 0 0-1 0-3 1.5-2.64-.5-5.36-.5-8 0C6 2 5 2 5 2c-.3 1.15-.3 2.35 0 3.5A5.403 5.403 0 0 0 4 9c0 3.5 3 5.5 6 5.5-.39.49-.68 1.05-.85 1.65-.17.6-.22 1.23-.15 1.85v4"/>
+                    <path d="M9 18c-4.51 2-5-2-7-2"/>
+                </svg>
+            </a>
+            {% endif %}
+        </div>
+    </div>
+</header>
+{% endif %}

package/docs/themes/tanuki/templates/partials/nav-buttons.html

@@ -0,0 +1,55 @@
+{# Previous/Next Navigation Buttons #}
+{% if page %}
+{# Determine prev/next based on sorting: weight-sorted uses lower/higher, date-sorted uses earlier/later #}
+{# Skip pages with hide_from_nav set #}
+{% if page.lower and (page.lower.extra.hide_from_nav is not defined or not page.lower.extra.hide_from_nav) %}
+    {% set prev_page = page.lower %}
+{% elif page.earlier and (page.earlier.extra.hide_from_nav is not defined or not page.earlier.extra.hide_from_nav) %}
+    {% set prev_page = page.earlier %}
+{% endif %}
+{% if page.higher and (page.higher.extra.hide_from_nav is not defined or not page.higher.extra.hide_from_nav) %}
+    {% set next_page = page.higher %}
+{% elif page.later and (page.later.extra.hide_from_nav is not defined or not page.later.extra.hide_from_nav) %}
+    {% set next_page = page.later %}
+{% endif %}
+
+<nav class="nav-buttons" aria-label="Page navigation">
+    {# Previous button #}
+    {% if prev_page %}
+    <a href="{{ prev_page.permalink | safe }}" class="nav-button nav-button--prev" aria-label="Previous: {{ prev_page.title }}">
+        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+            <path d="m15 18-6-6 6-6"/>
+        </svg>
+        <span class="nav-button__label">
+            {{ prev_page.title | truncate(length=30) }}
+            <span class="nav-button__shortcut">←</span>
+        </span>
+    </a>
+    {% else %}
+    <div class="nav-button nav-button--prev disabled" aria-hidden="true">
+        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+            <path d="m15 18-6-6 6-6"/>
+        </svg>
+    </div>
+    {% endif %}
+
+    {# Next button #}
+    {% if next_page %}
+    <a href="{{ next_page.permalink | safe }}" class="nav-button nav-button--next" aria-label="Next: {{ next_page.title }}">
+        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+            <path d="m9 18 6-6-6-6"/>
+        </svg>
+        <span class="nav-button__label">
+            {{ next_page.title | truncate(length=30) }}
+            <span class="nav-button__shortcut">→</span>
+        </span>
+    </a>
+    {% else %}
+    <div class="nav-button nav-button--next disabled" aria-hidden="true">
+        <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+            <path d="m9 18 6-6-6-6"/>
+        </svg>
+    </div>
+    {% endif %}
+</nav>
+{% endif %}

package/docs/themes/tanuki/templates/partials/nav-overlay.html

@@ -0,0 +1,81 @@
+{# Full-screen navigation overlay for mobile #}
+{% set mode = config.extra.mode | default(value="site") %}
+
+<div id="nav-overlay" class="nav-overlay" aria-hidden="true">
+    <div class="nav-overlay__backdrop"></div>
+    <div class="nav-overlay__panel">
+        <div class="nav-overlay__header">
+            <span class="nav-overlay__title">{{ config.title }}</span>
+            <button class="nav-overlay__close" aria-label="Close navigation">
+                <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                    <path d="M18 6 6 18"/>
+                    <path d="m6 6 12 12"/>
+                </svg>
+            </button>
+        </div>
+
+        <nav class="nav-overlay__nav">
+            <ul class="nav-overlay__list">
+                {% if config.extra.nav %}
+                    {% for link in config.extra.nav %}
+                    <li class="nav-overlay__item">
+                        <a href="{{ link.url | safe }}" class="nav-overlay__link {% if current_path is defined and current_path == link.url %}nav-overlay__link--active{% endif %}">
+                            {{ link.name }}
+                        </a>
+                    </li>
+                    {% endfor %}
+                {% elif config.extra.nav_links %}
+                    {% for link in config.extra.nav_links %}
+                        {% if link.children %}
+                        <li class="nav-overlay__group">
+                            <span class="nav-overlay__group-label">{{ link.name }}</span>
+                            <ul class="nav-overlay__sublist">
+                                {% for child in link.children %}
+                                <li class="nav-overlay__item">
+                                    <a href="{{ child.url | safe }}" class="nav-overlay__link {% if current_path is defined and current_path == child.url %}nav-overlay__link--active{% endif %}"{% if child.external %} target="_blank" rel="noopener noreferrer"{% endif %}>
+                                        {{ child.name }}
+                                        {% if child.external %}
+                                        <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/><polyline points="15 3 21 3 21 9"/><line x1="10" x2="21" y1="14" y2="3"/></svg>
+                                        {% endif %}
+                                    </a>
+                                </li>
+                                {% endfor %}
+                            </ul>
+                        </li>
+                        {% else %}
+                        <li class="nav-overlay__item">
+                            <a href="{{ link.url | safe }}" class="nav-overlay__link {% if current_path is defined and current_path == link.url %}nav-overlay__link--active{% endif %}"{% if link.external %} target="_blank" rel="noopener noreferrer"{% endif %}>
+                                {{ link.name }}
+                                {% if link.external %}
+                                <svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"/><polyline points="15 3 21 3 21 9"/><line x1="10" x2="21" y1="14" y2="3"/></svg>
+                                {% endif %}
+                            </a>
+                        </li>
+                        {% endif %}
+                    {% endfor %}
+                {% endif %}
+            </ul>
+        </nav>
+
+        <div class="nav-overlay__footer">
+            {# Theme toggle #}
+            {% if config.extra.show_theme_toggle | default(value=true) %}
+            <div class="nav-overlay__theme">
+                <span class="nav-overlay__theme-label">Theme</span>
+                {% include "partials/theme-toggle.html" %}
+            </div>
+            {% endif %}
+
+            {# GitHub link #}
+            {% if config.extra.github %}
+            <a href="{{ config.extra.github }}" class="nav-overlay__github" target="_blank" rel="noopener">
+                <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                    <path d="M15 22v-4a4.8 4.8 0 0 0-1-3.5c3 0 6-2 6-5.5.08-1.25-.27-2.48-1-3.5.28-1.15.28-2.35 0-3.5 0 0-1 0-3 1.5-2.64-.5-5.36-.5-8 0C6 2 5 2 5 2c-.3 1.15-.3 2.35 0 3.5A5.403 5.403 0 0 0 4 9c0 3.5 3 5.5 6 5.5-.39.49-.68 1.05-.85 1.65-.17.6-.22 1.23-.15 1.85v4"/>
+                    <path d="M9 18c-4.51 2-5-2-7-2"/>
+                </svg>
+                <span>View on GitHub</span>
+            </a>
+            {% endif %}
+        </div>
+    </div>
+</div>

package/docs/themes/tanuki/templates/partials/page-toc-panel.html

@@ -0,0 +1,43 @@
+{# Right sidebar for "On this page" headings - docs mode (supports both pages and sections) #}
+{% set toc_items = page.toc | default(value=[]) %}
+{% if not toc_items and section %}
+    {% set toc_items = section.toc | default(value=[]) %}
+{% endif %}
+
+{% if toc_items %}
+<aside id="page-toc-panel" class="page-toc-panel" aria-hidden="true" aria-label="On this page">
+    <div class="page-toc-panel__content">
+        <div class="page-toc-panel__header">
+            <span class="page-toc-panel__title">On this page</span>
+            <button class="page-toc-panel__close" type="button" aria-label="Close table of contents">
+                <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                    <path d="M18 6 6 18"/>
+                    <path d="m6 6 12 12"/>
+                </svg>
+            </button>
+        </div>
+        <nav class="page-toc-panel__nav" aria-label="Page sections">
+            <ul class="page-toc-panel__list">
+                {% for item in toc_items %}
+                <li class="page-toc-panel__item">
+                    <a href="#{{ item.id }}" class="page-toc-panel__link">
+                        {{ item.title }}
+                    </a>
+                    {% if item.children %}
+                    <ul class="page-toc-panel__list page-toc-panel__list--nested">
+                        {% for child in item.children %}
+                        <li class="page-toc-panel__item">
+                            <a href="#{{ child.id }}" class="page-toc-panel__link">
+                                {{ child.title }}
+                            </a>
+                        </li>
+                        {% endfor %}
+                    </ul>
+                    {% endif %}
+                </li>
+                {% endfor %}
+            </ul>
+        </nav>
+    </div>
+</aside>
+{% endif %}

package/docs/themes/tanuki/templates/partials/search.html

@@ -0,0 +1,52 @@
+{# Search Modal #}
+<div class="search-overlay" role="dialog" aria-modal="true" aria-labelledby="search-title" aria-describedby="search-description">
+    <div class="search">
+        <h2 id="search-title" class="sr-only">Search documentation</h2>
+        <p id="search-description" class="sr-only">Type to search. Use arrow keys to navigate results, Enter to select, Escape to close.</p>
+
+        <div class="search__input-wrapper">
+            <span class="search__icon" aria-hidden="true">
+                <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
+                    <circle cx="11" cy="11" r="8"/>
+                    <path d="m21 21-4.3-4.3"/>
+                </svg>
+            </span>
+            <input
+                type="search"
+                class="search__input"
+                placeholder="Search documentation..."
+                autocomplete="off"
+                autofocus
+                aria-label="Search query"
+                aria-controls="search-results"
+                aria-autocomplete="list"
+            >
+            <span class="search__shortcut" aria-hidden="true">/</span>
+            <button class="search__close" type="button" aria-label="Close search dialog" title="Close (Esc)">
+                <svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true">
+                    <path d="M18 6 6 18"/>
+                    <path d="m6 6 12 12"/>
+                </svg>
+            </button>
+        </div>
+
+        <div id="search-results" class="search__results" role="listbox" aria-label="Search results">
+            {# Results populated by JavaScript #}
+        </div>
+
+        <footer class="search__footer">
+            <nav class="search__hints" aria-label="Keyboard shortcuts">
+                <span class="search__hint">
+                    <kbd aria-label="Up and down arrows">↑</kbd><kbd aria-hidden="true">↓</kbd> <span>Navigate</span>
+                </span>
+                <span class="search__hint">
+                    <kbd aria-label="Enter">↵</kbd> <span>Select</span>
+                </span>
+                <span class="search__hint">
+                    <kbd aria-label="Escape">esc</kbd> <span>Close</span>
+                </span>
+            </nav>
+            <span class="search__powered-by">Powered by <a href="https://github.com/weixsong/elasticlunr.js" target="_blank" rel="noopener noreferrer" aria-label="elasticlunr.js on GitHub (opens in new tab)">elasticlunr</a></span>
+        </footer>
+    </div>
+</div>