enya-agent 0.1.0

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

@@ -0,0 +1,107 @@
+{# Sidebar with Table of Contents for Docs Mode #}
+<aside id="sidebar" class="sidebar" role="complementary" aria-labelledby="sidebar-title">
+    {# Resize handle (desktop only) #}
+    <div class="sidebar__resize-handle" aria-hidden="true" title="Drag to resize sidebar width"></div>
+
+    <div class="sidebar__header">
+        <span id="sidebar-title" class="sidebar__title">Table of contents</span>
+        <button class="sidebar__close" type="button" aria-label="Close sidebar" title="Close">
+            <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="sidebar__content" aria-label="Documentation navigation">
+        <div class="toc">
+            {# Get the root section for docs #}
+            {% set root_section = get_section(path="_index.md") %}
+
+            {% if root_section %}
+            <div class="toc__section">
+                <ol class="toc__list toc__list--numbered" start="0">
+                    {% for pg in root_section.pages %}
+                    {% if pg.extra.hide_from_toc is not defined or not pg.extra.hide_from_toc %}
+                    <li class="toc__item">
+                        <a href="{{ pg.permalink | safe }}" class="toc__link {% if current_path is defined and current_path == pg.path %}active{% endif %}">
+                            <span class="toc__number">{{ loop.index0 }}.</span>
+                            {{ pg.title }}
+                        </a>
+                    </li>
+                    {% endif %}
+                    {% endfor %}
+                </ol>
+            </div>
+
+            {# Subsections - Zola automatically sorts section.subsections by weight #}
+            {% if root_section.subsections %}
+            {% for subsection_path in root_section.subsections %}
+            {% set subsection = get_section(path=subsection_path) %}
+            <div class="toc__section">
+                <a href="{{ subsection.permalink | safe }}" class="toc__section-title {% if current_path is defined and current_path == subsection.path %}active{% endif %}">{{ subsection.title }}</a>
+                <ul class="toc__list">
+                    {% for pg in subsection.pages %}
+                    <li class="toc__item">
+                        <a href="{{ pg.permalink | safe }}" class="toc__link {% if current_path is defined and current_path == pg.path %}active{% endif %}">
+                            {{ pg.title }}
+                        </a>
+                    </li>
+                    {% endfor %}
+                </ul>
+            </div>
+            {% endfor %}
+            {% endif %}
+            {% endif %}
+        </div>
+    </nav>
+
+    <div class="sidebar__footer">
+        {# Mobile-only actions (hidden on desktop where they're in header) #}
+        <div class="sidebar__actions-mobile">
+            {# Version picker #}
+            {% if config.extra.versions is defined %}
+            <div class="sidebar__action">
+                <span class="sidebar__action-label">Version</span>
+                <div class="sidebar__version">
+                    <span class="sidebar__version-current">v{{ config.extra.versions.current }}</span>
+                    {% for v in config.extra.versions.list %}
+                    {% if v.version != config.extra.versions.current %}
+                    <a href="{{ v.url | safe }}" class="sidebar__version-link">v{{ v.version }}</a>
+                    {% endif %}
+                    {% endfor %}
+                </div>
+            </div>
+            {% endif %}
+
+            {# Theme toggle #}
+            {% if config.extra.show_theme_toggle | default(value=true) %}
+            <div class="sidebar__action">
+                <span class="sidebar__action-label">Theme</span>
+                {% include "partials/theme-toggle.html" %}
+            </div>
+            {% endif %}
+
+            {# GitHub link #}
+            {% if config.extra.github %}
+            <a href="{{ config.extra.github }}" class="sidebar__github" target="_blank" rel="noopener noreferrer" aria-label="View project on GitHub (opens in new tab)">
+                <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" 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>
+                <span>View on GitHub</span>
+            </a>
+            {% endif %}
+        </div>
+
+        {# Print button #}
+        <a href="{{ get_url(path='print') | safe }}?auto=true" class="print-button" target="_blank" rel="noopener" aria-label="Print all documentation pages (opens print dialog)">
+            <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" aria-hidden="true">
+                <polyline points="6 9 6 2 18 2 18 9"/>
+                <path d="M6 18H4a2 2 0 0 1-2-2v-5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v5a2 2 0 0 1-2 2h-2"/>
+                <rect width="12" height="8" x="6" y="14"/>
+            </svg>
+            <span>Print all pages</span>
+        </a>
+    </div>
+</aside>

package/docs/themes/tanuki/templates/partials/theme-toggle.html

@@ -0,0 +1,35 @@
+{# Theme Toggle Button - Nintendo-style whimsical #}
+<button class="theme-toggle" type="button" aria-label="Toggle color theme: cycles through light, dark, and auto modes" aria-live="polite" title="Toggle theme">
+    <span class="theme-toggle__icons">
+        {# Sun icon (for switching to light mode) #}
+        <span class="theme-toggle__sun" 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="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>
+
+        {# Moon icon (for switching to dark mode) #}
+        <span class="theme-toggle__moon" 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="M12 3a6 6 0 0 0 9 9 9 9 0 1 1-9-9Z"/>
+            </svg>
+        </span>
+
+        {# Eclipse icon (for switching to auto/system mode) #}
+        <span class="theme-toggle__auto" 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="12" cy="12" r="10"/>
+                <path d="M12 2a7 7 0 1 0 7 7"/>
+            </svg>
+        </span>
+    </span>
+    <span class="sr-only theme-toggle__status">Current theme: auto</span>
+</button>

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

@@ -0,0 +1,146 @@
+{# Full-screen Table of Contents overlay for docs/book mode #}
+{% set mode = config.extra.mode | default(value="site") %}
+
+<div id="toc-overlay" class="toc-overlay" aria-hidden="true" role="dialog" aria-label="Table of Contents">
+    <div class="toc-overlay__backdrop"></div>
+    <div class="toc-overlay__panel">
+        <div class="toc-overlay__header">
+            <h2 class="toc-overlay__title">{{ config.title }}</h2>
+            <button class="toc-overlay__close" 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">
+                    <path d="M18 6 6 18"/>
+                    <path d="m6 6 12 12"/>
+                </svg>
+            </button>
+        </div>
+
+        <nav class="toc-overlay__nav" aria-label="{% if mode == 'docs' %}Table of contents{% else %}Book chapters{% endif %}">
+            {% set root_section = get_section(path="_index.md") %}
+
+            {% if mode == "docs" %}
+            {# Docs mode: numbered chapters #}
+            {% if root_section %}
+            <ul class="toc-overlay__list">
+                {% for pg in root_section.pages %}
+                {% if pg.extra.hide_from_toc is not defined or not pg.extra.hide_from_toc %}
+                <li class="toc-overlay__item">
+                    <a href="{{ pg.permalink | safe }}" class="toc-overlay__link{% if current_path is defined and current_path == pg.path %} toc-overlay__link--active{% endif %}">
+                        <span class="toc-overlay__chapter">{{ loop.index0 }}.</span>
+                        <span class="toc-overlay__page-title">{{ pg.title }}</span>
+                    </a>
+                </li>
+                {% endif %}
+                {% endfor %}
+            </ul>
+
+            {# Subsections - collect and sort by weight #}
+            {% if root_section.subsections %}
+            {% set_global subsection_data = [] %}
+            {% for subsection_path in root_section.subsections %}
+                {% set sec = get_section(path=subsection_path) %}
+                {% set w = sec.weight | default(value=999) %}
+                {# Pad weight to 3 digits for proper string sorting, then concat with path #}
+                {% if w < 10 %}
+                    {% set w_str = "00" ~ w %}
+                {% elif w < 100 %}
+                    {% set w_str = "0" ~ w %}
+                {% else %}
+                    {% set w_str = w %}
+                {% endif %}
+                {% set_global subsection_data = subsection_data | concat(with=[w_str ~ "|" ~ subsection_path]) %}
+            {% endfor %}
+            {% set_global subsection_data = subsection_data | sort %}
+
+            {% for item in subsection_data %}
+            {% set parts = item | split(pat="|") %}
+            {% set subsection = get_section(path=parts.1) %}
+            <div class="toc-overlay__section">
+                <div class="toc-overlay__section-title">{{ subsection.title }}</div>
+                <ul class="toc-overlay__list">
+                    {% for pg in subsection.pages %}
+                    <li class="toc-overlay__item">
+                        <a href="{{ pg.permalink | safe }}" class="toc-overlay__link{% if current_path is defined and current_path == pg.path %} toc-overlay__link--active{% endif %}">
+                            <span class="toc-overlay__page-title">{{ pg.title }}</span>
+                        </a>
+                    </li>
+                    {% endfor %}
+                </ul>
+            </div>
+            {% endfor %}
+            {% endif %}
+            {% endif %}
+
+            {% else %}
+            {# Book mode: chapters #}
+            {% if root_section %}
+            <ul class="toc-overlay__list">
+                <li class="toc-overlay__item">
+                    <a href="{{ root_section.permalink | safe }}" class="toc-overlay__link toc-overlay__link--section">
+                        {{ root_section.title }}
+                    </a>
+                </li>
+                {% for page in root_section.pages %}
+                {% if page.extra.hide_from_toc is not defined or not page.extra.hide_from_toc %}
+                <li class="toc-overlay__item">
+                    <a href="{{ page.permalink | safe }}" class="toc-overlay__link{% if current_path is defined and current_path == page.path %} toc-overlay__link--active{% endif %}">
+                        <span class="toc-overlay__chapter">Chapter {{ loop.index }}</span>
+                        <span class="toc-overlay__page-title">{{ page.title }}</span>
+                    </a>
+                </li>
+                {% endif %}
+                {% endfor %}
+            </ul>
+            {% endif %}
+            {% endif %}
+        </nav>
+
+        {# Footer with actions #}
+        <div class="toc-overlay__footer">
+            {# Version picker (docs mode only) #}
+            {% if mode == "docs" and config.extra.versions is defined %}
+            <div class="toc-overlay__action">
+                <span class="toc-overlay__action-label">Version</span>
+                <div class="toc-overlay__version">
+                    <span class="toc-overlay__version-current">v{{ config.extra.versions.current }}</span>
+                    {% for v in config.extra.versions.list %}
+                    {% if v.version != config.extra.versions.current %}
+                    <a href="{{ v.url | safe }}" class="toc-overlay__version-link">v{{ v.version }}</a>
+                    {% endif %}
+                    {% endfor %}
+                </div>
+            </div>
+            {% endif %}
+
+            {# Theme toggle #}
+            {% if config.extra.show_theme_toggle | default(value=true) %}
+            <div class="toc-overlay__action">
+                <span class="toc-overlay__action-label">Theme</span>
+                {% include "partials/theme-toggle.html" %}
+            </div>
+            {% endif %}
+
+            {# GitHub link #}
+            {% if config.extra.github %}
+            <a href="{{ config.extra.github }}" class="toc-overlay__github" target="_blank" rel="noopener">
+                <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="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 %}
+
+            {# Print all pages (docs and book modes) #}
+            {% if mode == "docs" or mode == "book" %}
+            <a href="{{ get_url(path='print') | safe }}?auto=true" class="toc-overlay__print" target="_blank">
+                <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">
+                    <polyline points="6 9 6 2 18 2 18 9"/>
+                    <path d="M6 18H4a2 2 0 0 1-2-2v-5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2v5a2 2 0 0 1-2 2h-2"/>
+                    <rect width="12" height="8" x="6" y="14"/>
+                </svg>
+                <span>Print all pages</span>
+            </a>
+            {% endif %}
+        </div>
+    </div>
+</div>

package/docs/themes/tanuki/templates/partials/version-picker.html

@@ -0,0 +1,38 @@
+{# Version Picker Dropdown (docs mode only) #}
+{% if config.extra.versions %}
+{% set current_version = config.extra.versions.current | default(value="latest") %}
+
+<div class="version-picker">
+    <button class="version-picker__button" aria-haspopup="listbox" aria-expanded="false">
+        <span>v{{ current_version }}</span>
+        {% for v in config.extra.versions.list %}
+        {% if v.version == current_version and v.label is defined %}
+        <span class="version-picker__badge">{{ v.label }}</span>
+        {% endif %}
+        {% endfor %}
+        <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="m6 9 6 6 6-6"/>
+        </svg>
+    </button>
+
+    <div class="version-picker__dropdown" role="listbox">
+        {% for v in config.extra.versions.list %}
+        <a href="{{ v.url | safe }}" class="version-picker__item {% if v.version == current_version %}active{% endif %}" role="option">
+            v{{ v.version }}
+            {% if v.label is defined and v.label %}
+            <span class="version-picker__badge">{{ v.label }}</span>
+            {% endif %}
+        </a>
+        {% endfor %}
+        <hr class="version-picker__divider">
+        <a href="{{ get_url(path='appendix/versioning/') | safe }}" class="version-picker__item version-picker__item--link">
+            All versions
+            <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">
+                <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" y1="14" x2="21" y2="3"/>
+            </svg>
+        </a>
+    </div>
+</div>
+{% endif %}

package/docs/themes/tanuki/templates/print.html

@@ -0,0 +1,244 @@
+<!DOCTYPE html>
+<html lang="{{ lang | default(value='en') }}">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta name="robots" content="noindex">
+    <title>{{ config.title }} - Print Version</title>
+
+    <link rel="stylesheet" href="{{ get_url(path='style.css') | safe }}">
+
+    <style>
+        /* Print-specific overrides */
+        body {
+            background: white;
+            color: black;
+        }
+
+        .print-page {
+            max-width: 800px;
+            margin: 0 auto;
+            padding: 2rem;
+        }
+
+        .print-page__header {
+            text-align: center;
+            margin-bottom: 3rem;
+            padding-bottom: 2rem;
+            border-bottom: 2px solid #ddd;
+        }
+
+        .print-page__header h1 {
+            color: #333;
+            margin-bottom: 0.5rem;
+        }
+
+        .print-page__meta {
+            color: #666;
+            font-size: 0.9rem;
+        }
+
+        .print-page__toc {
+            margin-bottom: 3rem;
+            padding: 1.5rem;
+            background: #f5f5f5;
+            border-radius: 8px;
+        }
+
+        .print-page__toc h2 {
+            margin-top: 0;
+            border-bottom: none;
+        }
+
+        .print-page__toc-section {
+            margin-top: 1rem;
+        }
+
+        .print-page__toc-section-title {
+            font-weight: 600;
+            color: #555;
+            margin-bottom: 0.5rem;
+        }
+
+        .print-page__toc ol {
+            margin: 0;
+            padding-left: 1.5rem;
+        }
+
+        .print-page__toc li {
+            margin: 0.25rem 0;
+        }
+
+        .print-page__section {
+            margin-bottom: 2rem;
+        }
+
+        .print-page__section-title {
+            font-size: 1.5rem;
+            color: #555;
+            border-bottom: 2px solid #ddd;
+            padding-bottom: 0.5rem;
+            margin-bottom: 2rem;
+            page-break-after: avoid;
+        }
+
+        .print-page__chapter {
+            margin-bottom: 3rem;
+            padding-bottom: 2rem;
+            border-bottom: 1px solid #ddd;
+            page-break-after: always;
+        }
+
+        .print-page__chapter:last-child {
+            border-bottom: none;
+            page-break-after: auto;
+        }
+
+        .print-page__chapter h1 {
+            color: #333;
+            page-break-after: avoid;
+        }
+
+        /* Hide interactive elements */
+        .no-print,
+        .code-buttons {
+            display: none !important;
+        }
+
+        @media print {
+            body {
+                font-size: 11pt;
+            }
+
+            .print-page {
+                padding: 0;
+            }
+
+            .print-page__toc {
+                background: none;
+                border: 1px solid #ddd;
+            }
+
+            pre {
+                background: #f5f5f5 !important;
+                border: 1px solid #ddd !important;
+                white-space: pre-wrap;
+                word-wrap: break-word;
+            }
+
+            a {
+                color: #333;
+                text-decoration: underline;
+            }
+
+            @page {
+                margin: 2cm;
+            }
+        }
+    </style>
+</head>
+<body>
+    <div class="print-page">
+        <header class="print-page__header">
+            <h1>{{ config.title }}</h1>
+            <p class="print-page__meta">
+                {{ config.description }}
+                <br>
+                Generated on {{ now() | date(format="%B %d, %Y") }}
+            </p>
+        </header>
+
+        {# Build Table of Contents #}
+        <nav class="print-page__toc">
+            <h2>Table of Contents</h2>
+
+            {% set root = get_section(path="_index.md") %}
+
+            {# Root pages #}
+            {% if root.pages | length > 0 %}
+            <ol>
+                {% for page in root.pages %}
+                {% if page.extra.hide_from_toc is not defined or not page.extra.hide_from_toc %}
+                {% if page.slug != "print" %}
+                <li><a href="#page-{{ page.slug }}">{{ page.title }}</a></li>
+                {% endif %}
+                {% endif %}
+                {% endfor %}
+            </ol>
+            {% endif %}
+
+            {# Subsections #}
+            {% for subsection_path in root.subsections %}
+            {% set subsection = get_section(path=subsection_path) %}
+            <div class="print-page__toc-section">
+                <div class="print-page__toc-section-title">{{ subsection.title }}</div>
+                <ol>
+                    {% for page in subsection.pages %}
+                    {% if page.extra.hide_from_toc is not defined or not page.extra.hide_from_toc %}
+                    <li><a href="#page-{{ page.slug }}">{{ page.title }}</a></li>
+                    {% endif %}
+                    {% endfor %}
+                </ol>
+            </div>
+            {% endfor %}
+        </nav>
+
+        {# Render all content #}
+        {% set root = get_section(path="_index.md") %}
+
+        {# Root pages first #}
+        {% for page in root.pages %}
+        {% if page.extra.hide_from_toc is not defined or not page.extra.hide_from_toc %}
+        {% if page.slug != "print" %}
+        <article class="print-page__chapter" id="page-{{ page.slug }}">
+            <h1>{{ page.title }}</h1>
+            {{ page.content | safe }}
+        </article>
+        {% endif %}
+        {% endif %}
+        {% endfor %}
+
+        {# Then each subsection #}
+        {% for subsection_path in root.subsections %}
+        {% set subsection = get_section(path=subsection_path) %}
+        <div class="print-page__section">
+            <h2 class="print-page__section-title">{{ subsection.title }}</h2>
+
+            {% for page in subsection.pages %}
+            {% if page.extra.hide_from_toc is not defined or not page.extra.hide_from_toc %}
+            <article class="print-page__chapter" id="page-{{ page.slug }}">
+                <h1>{{ page.title }}</h1>
+                {{ page.content | safe }}
+            </article>
+            {% endif %}
+            {% endfor %}
+        </div>
+        {% endfor %}
+
+        <footer class="print-page__footer">
+            <p>&copy; {{ now() | date(format="%Y") }} {{ config.extra.author | default(value=config.title) }}</p>
+        </footer>
+    </div>
+
+    <script>
+        // Auto-print when page loads (if triggered from print button)
+        if (window.location.search.includes('auto=true')) {
+            window.onload = function() {
+                // Close the tab after print dialog is closed (print or cancel)
+                window.addEventListener('afterprint', function() {
+                    window.close();
+                });
+
+                // Trigger print dialog
+                window.print();
+
+                // Fallback for browsers that don't fire afterprint reliably
+                // Close after a short delay if still open
+                setTimeout(function() {
+                    window.close();
+                }, 1000);
+            };
+        }
+    </script>
+</body>
+</html>