docula 1.2.0 → 1.6.0

package/templates/modern/includes/header-bar.hbs

@@ -4,24 +4,24 @@
       <button class="mobile-menu-toggle" id="mobile-menu-toggle" aria-label="Toggle navigation menu">
         <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"><line x1="4" x2="20" y1="12" y2="12"/><line x1="4" x2="20" y1="6" y2="6"/><line x1="4" x2="20" y1="18" y2="18"/></svg>
       </button>
-      <a href="/">
-        <img alt="{{siteTitle}}" class="logo__img" src="/logo.svg">
+      <a href="{{baseUrl}}/">
+        <img alt="{{siteTitle}}" class="logo__img" src="{{baseUrl}}/logo.svg">
       </a>
       <nav class="header-bottom__nav">
         {{#if hasDocuments}}
-        <a class="header-bottom__item" href="/docs/" id="nav-docs">
+        <a class="header-bottom__item" href="{{docsUrl}}/" id="nav-docs">
           <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 7v14"/><path d="M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z"/></svg>
           <span>Documentation</span>
         </a>
         {{/if}}
         {{#if openApiUrl}}
-        <a class="header-bottom__item" href="/api" id="nav-api">
+        <a class="header-bottom__item" href="{{apiUrl}}" id="nav-api">
           <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m16 18 6-6-6-6"/><path d="m8 6-6 6 6 6"/></svg>
           <span>API Reference</span>
         </a>
         {{/if}}
         {{#if hasChangelog}}
-        <a class="header-bottom__item" href="/changelog" id="nav-changelog">
+        <a class="header-bottom__item" href="{{changelogUrl}}" id="nav-changelog">
           <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 6a13 13 0 0 0 8.4-2.8A1 1 0 0 1 21 4v12a1 1 0 0 1-1.6.8A13 13 0 0 0 11 14H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2z"/><path d="M6 14a12 12 0 0 0 2.4 7.2 2 2 0 0 0 3.2-2.4A8 8 0 0 1 10 14"/><path d="M8 6v8"/></svg>
           <span>Changelog</span>
         </a>
@@ -39,37 +39,48 @@
         {{/each}}
         {{/if}}
       </nav>
-      {{#if cookieAuth.loginUrl}}
-      <a href="{{cookieAuth.loginUrl}}" class="cookie-auth-btn" id="cookie-auth-login">
-        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M15 3h4a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2h-4"/><polyline points="10 17 15 12 10 7"/><line x1="15" x2="3" y1="12" y2="12"/></svg>
-        <span>Log In</span>
-      </a>
-      <span class="cookie-auth-user" id="cookie-auth-user" style="display:none"></span>
-      <button class="cookie-auth-btn" id="cookie-auth-logout" style="display:none">
-        <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4"/><polyline points="16 17 21 12 16 7"/><line x1="21" x2="9" y1="12" y2="12"/></svg>
-        <span>Log Out</span>
-      </button>
-      {{/if}}
-      {{> theme-toggle }}
+      <div class="header-actions">
+        {{#if cookieAuth.loginUrl}}
+        <div class="cookie-auth">
+          <a href="{{cookieAuth.loginUrl}}" class="cookie-auth-btn" id="cookie-auth-login">
+            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M15 3h4a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2h-4"/><polyline points="10 17 15 12 10 7"/><line x1="15" x2="3" y1="12" y2="12"/></svg>
+            <span>Log In</span>
+          </a>
+          <span class="cookie-auth-user" id="cookie-auth-user"></span>
+          <script>
+            var auth = window.__doculaAuth;
+            if (auth && auth.displayName) {
+              var userEl = document.getElementById('cookie-auth-user');
+              if (userEl) userEl.textContent = auth.displayName;
+            }
+          </script>
+          <button class="cookie-auth-btn cookie-auth-logout" id="cookie-auth-logout">
+            <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4"/><polyline points="16 17 21 12 16 7"/><line x1="21" x2="9" y1="12" y2="12"/></svg>
+            <span>Log Out</span>
+          </button>
+        </div>
+        {{/if}}
+        {{> theme-toggle }}
+      </div>
     </div>
   </div>
 </header>
 <aside class="mobile-sidebar" id="mobile-sidebar">
   <nav class="mobile-nav">
     {{#if hasDocuments}}
-    <a class="mobile-nav__item" href="/docs/">
+    <a class="mobile-nav__item" href="{{docsUrl}}/">
       <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 7v14"/><path d="M3 18a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h5a4 4 0 0 1 4 4 4 4 0 0 1 4-4h5a1 1 0 0 1 1 1v13a1 1 0 0 1-1 1h-6a3 3 0 0 0-3 3 3 3 0 0 0-3-3z"/></svg>
       <span>Documentation</span>
     </a>
     {{/if}}
     {{#if openApiUrl}}
-    <a class="mobile-nav__item" href="/api">
+    <a class="mobile-nav__item" href="{{apiUrl}}">
       <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m16 18 6-6-6-6"/><path d="m8 6-6 6 6 6"/></svg>
       <span>API Reference</span>
     </a>
     {{/if}}
     {{#if hasChangelog}}
-    <a class="mobile-nav__item" href="/changelog">
+    <a class="mobile-nav__item" href="{{changelogUrl}}">
       <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M11 6a13 13 0 0 0 8.4-2.8A1 1 0 0 1 21 4v12a1 1 0 0 1-1.6.8A13 13 0 0 0 11 14H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2z"/><path d="M6 14a12 12 0 0 0 2.4 7.2 2 2 0 0 0 3.2-2.4A8 8 0 0 1 10 14"/><path d="M8 6v8"/></svg>
       <span>Changelog</span>
     </a>
@@ -91,8 +102,15 @@
       <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M15 3h4a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2h-4"/><polyline points="10 17 15 12 10 7"/><line x1="15" x2="3" y1="12" y2="12"/></svg>
       <span>Log In</span>
     </a>
-    <span class="cookie-auth-user" id="cookie-auth-user-mobile" style="display:none"></span>
-    <button class="mobile-nav__item cookie-auth-btn--mobile" id="cookie-auth-logout-mobile" style="display:none">
+    <span class="cookie-auth-user" id="cookie-auth-user-mobile"></span>
+    <script>
+      var auth = window.__doculaAuth;
+      if (auth && auth.displayName) {
+        var userEl = document.getElementById('cookie-auth-user-mobile');
+        if (userEl) userEl.textContent = auth.displayName;
+      }
+    </script>
+    <button class="mobile-nav__item cookie-auth-btn--mobile" id="cookie-auth-logout-mobile">
       <svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M9 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h4"/><polyline points="16 17 21 12 16 7"/><line x1="21" x2="9" y1="12" y2="12"/></svg>
       <span>Log Out</span>
     </button>

package/templates/modern/includes/header.hbs

@@ -1,9 +1,10 @@
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="description" content="{{siteDescription}}">
-<link rel="stylesheet" href="/css/styles.css">
-<link rel="stylesheet" href="/css/highlight/styles/base16/docula.css">
-<link rel="icon" href="/favicon.ico">
+<link rel="stylesheet" href="{{baseUrl}}/css/variables.css">
+<link rel="stylesheet" href="{{baseUrl}}/css/styles.css">
+<link rel="stylesheet" href="{{baseUrl}}/css/highlight/styles/base16/docula.css">
+<link rel="icon" href="{{baseUrl}}/favicon.ico">
 <script>
   (function(){
     window.__doculaThemeKey = 'docula:theme:' + ({{#if siteUrl}}'{{siteUrl}}'{{else}}location.origin{{/if}}).replace(/^https?:\/\//, '');
@@ -12,5 +13,19 @@
       ? (window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark')
       : mode;
     if (resolved === 'light') document.documentElement.setAttribute('data-theme', 'light');
+    try {
+      var authState = JSON.parse(localStorage.getItem('docula-auth-state'));
+      if (authState) {
+        window.__doculaAuth = authState;
+        if (authState.loggedIn) {
+          document.documentElement.classList.add('docula-auth-logged-in');
+        }
+      }
+    } catch (e) {
+      // Ignore localStorage parsing errors
+    }
+    if (!window.__doculaAuth) {
+      window.__doculaAuth = { loggedIn: false, displayName: null };
+    }
   })();
 </script>

package/templates/modern/includes/home.hbs

@@ -34,7 +34,7 @@
 
     {{#if (gt github.releases.length 6)}}
     <div>
-      <a class="release-btn" href="/changelog">
+      <a class="release-btn" href="{{changelogUrl}}">
         Full Changelog
         <span>&rarr;</span>
       </a>

package/templates/modern/includes/scripts.hbs

@@ -1,4 +1,4 @@
-<script src="/css/highlight/highlight.min.js"></script>
+<script src="{{baseUrl}}/css/highlight/highlight.min.js"></script>
 <script>
   document.addEventListener('DOMContentLoaded', () => {
     document.querySelectorAll('pre code').forEach(el => { el.textContent = el.textContent.trimEnd(); });
@@ -90,43 +90,32 @@
   })();
 </script>
 {{#if cookieAuth}}
-<div id="cookie-auth-config" hidden data-cookie-name="{{#if cookieAuth.cookieName}}{{cookieAuth.cookieName}}{{else}}token{{/if}}"{{#if cookieAuth.logoutUrl}} data-logout-url="{{cookieAuth.logoutUrl}}"{{/if}}></div>
+<div id="cookie-auth-config" hidden{{#if cookieAuth.logoutUrl}} data-logout-url="{{cookieAuth.logoutUrl}}"{{/if}}{{#if cookieAuth.authCheckUrl}} data-auth-check-url="{{cookieAuth.authCheckUrl}}"{{/if}}{{#if cookieAuth.authCheckMethod}} data-auth-check-method="{{cookieAuth.authCheckMethod}}"{{/if}}{{#if cookieAuth.authCheckUserPath}} data-auth-check-user-path="{{cookieAuth.authCheckUserPath}}"{{/if}}></div>
 <script>
   (function() {
     var configEl = document.getElementById('cookie-auth-config');
     if (!configEl) return;
-    var cookieName = configEl.getAttribute('data-cookie-name');
     var logoutUrl = configEl.getAttribute('data-logout-url');
-    function isSafeUrl(url) {
-      if (!url) return false;
-      try {
-        var parsed = new URL(url, window.location.origin);
-        return parsed.origin === window.location.origin;
-      } catch (e) {
-        return false;
+    var authCheckUrl = configEl.getAttribute('data-auth-check-url');
+    var authCheckMethod = configEl.getAttribute('data-auth-check-method') || 'GET';
+    var authCheckUserPath = configEl.getAttribute('data-auth-check-user-path');
+    function getNestedValue(obj, path) {
+      if (!path) return null;
+      var parts = path.split('.');
+      var current = obj;
+      for (var i = 0; i < parts.length; i++) {
+        if (current == null || typeof current !== 'object') return null;
+        current = current[parts[i]];
       }
+      return current || null;
     }
-    function getCookieValue() {
-      var match = document.cookie.split(';').find(function(c) {
-        return c.trim().startsWith(cookieName + '=');
-      });
-      return match ? match.trim().substring(cookieName.length + 1) : null;
-    }
-    function getDisplayName(token) {
-      try {
-        var payload = token.split('.')[1];
-        if (!payload) return null;
-        var json = atob(payload.replace(/-/g, '+').replace(/_/g, '/'));
-        var claims = JSON.parse(json);
-        return claims.name || claims.preferred_username || claims.email || null;
-      } catch (e) {
-        return null;
-      }
-    }
-    function updateAuthUI() {
-      var token = getCookieValue();
-      var loggedIn = !!token;
-      var displayName = loggedIn ? getDisplayName(token) : null;
+    var cachedAuth = null;
+    try { cachedAuth = JSON.parse(localStorage.getItem('docula-auth-state')); } catch(e) {}
+    window.__doculaAuth = cachedAuth || { loggedIn: false, displayName: null };
+    function setAuthUI(loggedIn, displayName) {
+      window.__doculaAuth = { loggedIn: loggedIn, displayName: displayName };
+      try { localStorage.setItem('docula-auth-state', JSON.stringify(window.__doculaAuth)); } catch(e) {}
+      document.dispatchEvent(new CustomEvent('docula-auth-change'));
       var els = [
         { login: document.getElementById('cookie-auth-login'), logout: document.getElementById('cookie-auth-logout'), user: document.getElementById('cookie-auth-user') },
         { login: document.getElementById('cookie-auth-login-mobile'), logout: document.getElementById('cookie-auth-logout-mobile'), user: document.getElementById('cookie-auth-user-mobile') }
@@ -140,8 +129,29 @@
         }
       });
     }
+    function checkAuth() {
+      if (!authCheckUrl) return;
+      fetch(authCheckUrl, { method: authCheckMethod, credentials: 'include' }).then(function(res) {
+        if (!res.ok) {
+          setAuthUI(false, null);
+          return;
+        }
+        if (authCheckUserPath) {
+          res.json().then(function(data) {
+            setAuthUI(true, getNestedValue(data, authCheckUserPath));
+          }).catch(function() {
+            setAuthUI(true, null);
+          });
+        } else {
+          setAuthUI(true, null);
+        }
+      }).catch(function() {
+        setAuthUI(false, null);
+      });
+    }
     document.addEventListener('DOMContentLoaded', function() {
-      updateAuthUI();
+      if (cachedAuth) setAuthUI(cachedAuth.loggedIn, cachedAuth.displayName);
+      checkAuth();
       var logoutEls = [
         document.getElementById('cookie-auth-logout'),
         document.getElementById('cookie-auth-logout-mobile')
@@ -149,10 +159,9 @@
       logoutEls.forEach(function(el) {
         if (el) {
           el.addEventListener('click', function() {
-            if (isSafeUrl(logoutUrl)) {
+            if (logoutUrl) {
               window.location.href = logoutUrl;
             } else {
-              document.cookie = cookieName + '=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/';
               window.location.reload();
             }
           });

package/templates/modern/js/api.js

@@ -130,11 +130,9 @@ document.addEventListener('DOMContentLoaded', function() {
         authValueInput.value = '';
         if (cookieStatusEl) {
           cookieStatusEl.classList.remove('api-auth__cookie-status--hidden');
-          var configEl = document.getElementById('cookie-auth-config');
-          var cookieName = configEl ? configEl.getAttribute('data-cookie-name') : (data.name || 'token');
-          var hasCookie = document.cookie.split(';').some(function(c) { return c.trim().startsWith(cookieName + '='); });
-          cookieStatusEl.textContent = hasCookie ? 'Logged in' : 'Not logged in — use Login button above';
-          cookieStatusEl.className = 'api-auth__cookie-status' + (hasCookie ? ' api-auth__cookie-status--ok' : ' api-auth__cookie-status--warn');
+          var auth = window.__doculaAuth || { loggedIn: false };
+          cookieStatusEl.textContent = auth.loggedIn ? 'Logged in' : 'Not logged in — use Login button above';
+          cookieStatusEl.className = 'api-auth__cookie-status' + (auth.loggedIn ? ' api-auth__cookie-status--ok' : ' api-auth__cookie-status--warn');
         }
       } else {
         authValueInput.classList.remove('api-auth__value--hidden');
@@ -148,7 +146,20 @@ document.addEventListener('DOMContentLoaded', function() {
         if (cookieStatusEl) cookieStatusEl.classList.add('api-auth__cookie-status--hidden');
       }
     }
-    authTypeSelect.addEventListener('change', updateAuthUI);
+    var savedAuth = localStorage.getItem('docula-api-auth-type');
+    if (savedAuth) {
+      for (var i = 0; i < authTypeSelect.options.length; i++) {
+        if (authTypeSelect.options[i].value === savedAuth) {
+          authTypeSelect.selectedIndex = i;
+          break;
+        }
+      }
+    }
+    authTypeSelect.addEventListener('change', function() {
+      localStorage.setItem('docula-api-auth-type', authTypeSelect.value);
+      updateAuthUI();
+    });
+    document.addEventListener('docula-auth-change', updateAuthUI);
     updateAuthUI();
   }