sourcey 2.1.0 → 3.0.1

package/dist/client/scroll-tracker.js

@@ -6,9 +6,23 @@
 (function () {
   var navLinks = document.querySelectorAll('#nav .nav-link');
   var targets = document.querySelectorAll('[data-traverse-target]');
-  if (!targets.length || !navLinks.length) return;
+
+  // For prose pages, also track heading elements that TOC links point to
+  var tocHeadingEls = [];
+  document.querySelectorAll('#toc .toc-item').forEach(function (link) {
+    var href = link.getAttribute('href');
+    if (href && href.indexOf('#') !== -1) {
+      var el = document.getElementById(href.split('#')[1]);
+      if (el) tocHeadingEls.push(el);
+    }
+  });
+
+  if (!targets.length && !tocHeadingEls.length) return;
+  if (!navLinks.length && !tocHeadingEls.length) return;
 
   var currentId = null;
+  var clickedId = null; // When set, overrides scroll-based activation
+  var clickTimer = null;
 
   // Map traverse-target id → nav link element (by matching href fragment)
   var linkMap = {};
@@ -19,70 +33,141 @@
     }
   });
 
-  // If no fragment-based links found, bail (e.g. markdown pages)
-  if (!Object.keys(linkMap).length) return;
+  // If no fragment-based nav links AND no TOC headings, nothing to track
+  if (!Object.keys(linkMap).length && !tocHeadingEls.length) return;
+
+  // TOC links (right sidebar) — share the same scroll tracking
+  var tocLinks = document.querySelectorAll('#toc .toc-item');
+  var tocMap = {};
+  tocLinks.forEach(function (link) {
+    var href = link.getAttribute('href');
+    if (href && href.indexOf('#') !== -1) {
+      tocMap[href.split('#')[1]] = link;
+    }
+  });
+
+  // Only manage active state on fragment-linked nav items and TOC items.
+  // Doc page nav links keep their SSR-set active class untouched.
+  var fragmentNavLinks = Object.values(linkMap);
 
-  function activate(id) {
-    if (id === currentId) return;
+  function activate(id, force) {
+    if (id === currentId && !force) return;
     currentId = id;
 
-    navLinks.forEach(function (link) {
+    fragmentNavLinks.forEach(function (link) {
+      link.classList.remove('active');
+    });
+    tocLinks.forEach(function (link) {
       link.classList.remove('active');
     });
 
     var active = linkMap[id];
     if (active) {
       active.classList.add('active');
-      // Scroll the sidebar so the active link stays visible
       active.scrollIntoView({ block: 'nearest', behavior: 'auto' });
     }
+
+    var tocActive = tocMap[id];
+    if (tocActive) {
+      tocActive.classList.add('active');
+    }
   }
 
-  // Track which sections are visible; pick the topmost one
-  var visibleSections = new Map();
+  // Handle anchor clicks: activate highlight, scroll with header offset, lock scroll tracker.
+  function handleAnchorClick(e, selector) {
+    var link = e.target.closest(selector);
+    if (!link) return;
+    var href = link.getAttribute('href');
+    if (!href || href.indexOf('#') === -1) return;
+    var id = href.split('#')[1];
+    if (!id) return;
 
-  var observer = new IntersectionObserver(function (entries) {
-    entries.forEach(function (entry) {
-      var id = entry.target.getAttribute('data-traverse-target');
-      if (entry.isIntersecting) {
-        visibleSections.set(id, entry.target);
-      } else {
-        visibleSections.delete(id);
-      }
-    });
+    e.preventDefault();
+    clickedId = id;
+    activate(id, true);
 
-    // Pick the topmost visible section (smallest boundingClientRect.top)
+    var el = document.getElementById(id);
+    if (el) {
+      var header = document.getElementById('header');
+      var offset = (header ? header.offsetHeight : 112) + 16;
+      window.scrollTo({ top: el.getBoundingClientRect().top + window.scrollY - offset, behavior: 'smooth' });
+      history.replaceState(null, '', '#' + id);
+    }
+
+    clearTimeout(clickTimer);
+    clickTimer = setTimeout(function () { clickedId = null; }, 800);
+  }
+
+  var tocEl = document.getElementById('toc');
+  if (tocEl) tocEl.addEventListener('click', function (e) { handleAnchorClick(e, '.toc-item'); });
+
+  var navEl = document.getElementById('nav');
+  if (navEl) navEl.addEventListener('click', function (e) { handleAnchorClick(e, '.nav-link'); });
+
+  // Use scroll event for reliable activation at all positions.
+  function onScroll() {
+    // If a nav link was just clicked, don't override it until scroll settles
+    if (clickedId) return;
+
+    // Measure the actual header element to handle any template/theme height
+    var header = document.getElementById('header');
+    var threshold = (header ? header.offsetHeight : 112) + 20;
     var best = null;
-    var bestTop = Infinity;
-    visibleSections.forEach(function (el, id) {
-      var top = el.getBoundingClientRect().top;
-      if (top < bestTop) { bestTop = top; best = id; }
-    });
 
-    // Fallback: if nothing visible, find the last section above viewport
-    if (!best) {
-      for (var i = targets.length - 1; i >= 0; i--) {
-        if (targets[i].getBoundingClientRect().top < 10) {
-          best = targets[i].getAttribute('data-traverse-target');
-          break;
-        }
+    // Check API traverse targets
+    for (var i = 0; i < targets.length; i++) {
+      var top = targets[i].getBoundingClientRect().top;
+      if (top <= threshold) {
+        best = targets[i].getAttribute('data-traverse-target');
+      } else {
+        break;
+      }
+    }
+
+    // Check TOC heading elements (prose pages)
+    for (var j = 0; j < tocHeadingEls.length; j++) {
+      var hTop = tocHeadingEls[j].getBoundingClientRect().top;
+      if (hTop <= threshold) {
+        best = tocHeadingEls[j].id;
+      } else {
+        break;
       }
     }
 
+    // At top of page, default to first section
+    var allTargets = targets.length ? targets : tocHeadingEls;
+    if (!best && allTargets.length) {
+      best = targets.length
+        ? allTargets[0].getAttribute('data-traverse-target')
+        : allTargets[0].id;
+    }
+
+    // At bottom of page, force last section active
+    if (window.innerHeight + window.scrollY >= document.body.scrollHeight - 10) {
+      var last = allTargets[allTargets.length - 1];
+      best = targets.length ? last.getAttribute('data-traverse-target') : last.id;
+    }
+
     if (best) activate(best);
-  }, {
-    // Trigger when section header enters top 20% of viewport
-    rootMargin: '0px 0px -80% 0px',
-    threshold: 0
-  });
+  }
 
-  targets.forEach(function (el) { observer.observe(el); });
+  // Throttle scroll handler
+  var ticking = false;
+  window.addEventListener('scroll', function () {
+    if (!ticking) {
+      ticking = true;
+      requestAnimationFrame(function () {
+        onScroll();
+        ticking = false;
+      });
+    }
+  }, { passive: true });
 
-  // Activate on initial load based on URL hash or first section
+  // Activate on initial load based on URL hash or scroll position
   var hash = window.location.hash.slice(1);
   if (hash && linkMap[hash]) {
     activate(hash);
-  } else if (targets.length) {
-    activate(targets[0].getAttribute('data-traverse-target'));
+  } else {
+    onScroll();
   }
 })();

package/dist/client/search.js

@@ -68,12 +68,29 @@
       });
     }
 
+    // Sort by category so groups stay together
+    var categoryOrder = { Pages: 0, Sections: 1, Endpoints: 2, Models: 3 };
+    filtered.sort(function (a, b) {
+      return (categoryOrder[a.category] || 9) - (categoryOrder[b.category] || 9);
+    });
+
     activeIndex = filtered.length ? 0 : -1;
     render();
   }
 
   function render() {
-    results.innerHTML = filtered.map(function (e, i) {
+    var html = '';
+    var lastCategory = '';
+
+    for (var i = 0; i < filtered.length; i++) {
+      var e = filtered[i];
+      var cat = e.category || 'Results';
+
+      if (cat !== lastCategory) {
+        html += '<div class="search-category">' + escapeHtml(cat) + '</div>';
+        lastCategory = cat;
+      }
+
       var cls = 'search-result' + (i === activeIndex ? ' active' : '');
       var label = e.method
         ? '<span class="search-result-method method-' + e.method.toLowerCase() + '">' + e.method + '</span> ' +
@@ -81,10 +98,17 @@
         : '<span class="search-result-path">' + escapeHtml(e.summary) + '</span>';
       var tagLine = e.tag ? '<span class="search-result-tag">' + escapeHtml(e.tag) + '</span>' : '';
       var summaryLine = e.method && e.summary ? '<span class="search-result-summary">' + escapeHtml(e.summary) + '</span>' : '';
-      return '<a href="' + e.url + '" class="' + cls + '" data-index="' + i + '">' +
+
+      html += '<a href="' + e.url + '" class="' + cls + '" data-index="' + i + '">' +
         '<div class="search-result-main">' + label + summaryLine + '</div>' +
         tagLine + '</a>';
-    }).join('');
+    }
+
+    results.innerHTML = html;
+
+    // Scroll active result into view
+    var activeEl = results.querySelector('.search-result.active');
+    if (activeEl) activeEl.scrollIntoView({ block: 'nearest' });
   }
 
   function escapeHtml(s) {

package/dist/client/tabs.js

@@ -1,32 +1,66 @@
-// Code sample tabs — switches active tab and syncs language across groups.
+// Code sample language dropdown + response code tabs + copy button.
 //
-// Toggles .active on .code-samples-tab and .code-samples-panel elements.
-// All visual styling (color, underline indicator) is in sourcey.css;
-// this file only manages the .active class and aria-selected attribute.
+// Handles three interaction patterns:
+// 1. Language dropdown — toggles .code-lang-menu, switches .code-lang-panel
+// 2. Response tabs — switches .response-tab active state + .response-panel
+// 3. Copy button — copies code from the active panel to clipboard
 (function () {
   var selectedLang = null;
 
+  // ── Language Dropdown ──────────────────────────────────────────────
+
+  // Toggle dropdown open/close
   document.addEventListener('click', function (e) {
-    var tab = e.target.closest('.code-samples-tab');
-    if (!tab) return;
+    var trigger = e.target.closest('.code-lang-trigger');
 
-    var container = tab.closest('.code-samples');
-    var index = tab.getAttribute('data-tab-index');
-    var lang = tab.textContent.trim();
+    // Close all open dropdowns first
+    document.querySelectorAll('.code-lang-menu').forEach(function (menu) {
+      if (!trigger || !menu.parentElement.contains(trigger)) {
+        menu.classList.add('hidden');
+        var btn = menu.parentElement.querySelector('.code-lang-trigger');
+        if (btn) btn.setAttribute('aria-expanded', 'false');
+      }
+    });
 
-    // Preserve scroll position so panel height changes don't shift the page
-    var scrollY = window.scrollY;
+    if (!trigger) return;
+    e.stopPropagation();
+
+    var menu = trigger.nextElementSibling;
+    if (!menu) return;
 
-    activateTab(container, index);
+    var isOpen = !menu.classList.contains('hidden');
+    menu.classList.toggle('hidden', isOpen);
+    trigger.setAttribute('aria-expanded', isOpen ? 'false' : 'true');
+  });
 
-    // Sync: activate same language in all other code-sample groups on the page
+  // Select a language from the dropdown
+  document.addEventListener('click', function (e) {
+    var option = e.target.closest('.code-lang-option');
+    if (!option) return;
+
+    var container = option.closest('.code-group');
+    var index = option.getAttribute('data-lang-index');
+    var lang = option.textContent.trim();
+
+    // Close the menu
+    var menu = option.closest('.code-lang-menu');
+    if (menu) {
+      menu.classList.add('hidden');
+      var trigger = menu.parentElement.querySelector('.code-lang-trigger');
+      if (trigger) trigger.setAttribute('aria-expanded', 'false');
+    }
+
+    var scrollY = window.scrollY;
+    activateLang(container, index);
+
+    // Sync language across all code-sample groups
     if (lang !== selectedLang) {
       selectedLang = lang;
-      document.querySelectorAll('.code-samples').forEach(function (group) {
-        if (group === container) return;
-        group.querySelectorAll('.code-samples-tab').forEach(function (t) {
-          if (t.textContent.trim() === lang) {
-            activateTab(group, t.getAttribute('data-tab-index'));
+      document.querySelectorAll('.code-group').forEach(function (group) {
+        if (group === container || !group.querySelector('.code-lang-dropdown')) return;
+        group.querySelectorAll('.code-lang-option').forEach(function (opt) {
+          if (opt.textContent.trim() === lang) {
+            activateLang(group, opt.getAttribute('data-lang-index'));
           }
         });
       });
@@ -35,17 +69,123 @@
     window.scrollTo(0, scrollY);
   });
 
-  function activateTab(container, index) {
+  function activateLang(container, index) {
+    // Update dropdown label
+    var options = container.querySelectorAll('.code-lang-option');
+    var label = container.querySelector('.code-lang-label');
+    options.forEach(function (opt) {
+      var isActive = opt.getAttribute('data-lang-index') === index;
+      opt.setAttribute('aria-selected', isActive ? 'true' : 'false');
+      opt.className = opt.className.replace(/text-\[rgb\([^\)]+\)\]/g, '');
+      if (isActive) {
+        opt.classList.add('text-[rgb(var(--color-primary))]');
+        if (label) label.textContent = opt.textContent.trim();
+        // Update trigger icon to match selected language
+        var triggerIcon = container.querySelector('.code-lang-trigger .code-lang-icon');
+        var optIcon = opt.querySelector('.lang-icon');
+        if (triggerIcon && optIcon) {
+          triggerIcon.innerHTML = optIcon.outerHTML;
+        }
+      } else {
+        opt.classList.add('text-[rgb(var(--color-stone-600))]');
+      }
+    });
+
+    // Update panels
+    container.querySelectorAll('.code-lang-panel').forEach(function (p) {
+      p.classList.toggle('active', p.getAttribute('data-lang-panel') === index);
+    });
+  }
+
+  // ── Response Tabs ──────────────────────────────────────────────────
+
+  document.addEventListener('click', function (e) {
+    var tab = e.target.closest('.response-tab');
+    if (!tab) return;
+
+    var container = tab.closest('.response-tabs');
+    var index = tab.getAttribute('data-response-index');
+    var scrollY = window.scrollY;
+
     // Update tabs
-    container.querySelectorAll('.code-samples-tab').forEach(function (t) {
-      var isActive = t.getAttribute('data-tab-index') === index;
+    container.querySelectorAll('.response-tab').forEach(function (t) {
+      var isActive = t.getAttribute('data-response-index') === index;
       t.classList.toggle('active', isActive);
       t.setAttribute('aria-selected', isActive ? 'true' : 'false');
     });
 
     // Update panels
-    container.querySelectorAll('.code-samples-panel').forEach(function (p) {
-      p.classList.toggle('active', p.getAttribute('data-panel-index') === index);
+    container.querySelectorAll('.response-panel').forEach(function (p) {
+      p.classList.toggle('active', p.getAttribute('data-response-panel') === index);
     });
-  }
+
+    window.scrollTo(0, scrollY);
+  });
+
+  // ── Copy Button ────────────────────────────────────────────────────
+
+  document.addEventListener('click', function (e) {
+    var btn = e.target.closest('.copy-btn');
+    if (!btn) return;
+
+    var container = btn.closest('.code-group') || btn.closest('.code-block-wrapper');
+    if (!container) return;
+
+    // Find the active panel's code, or the nearest code block
+    var activePanel = container.querySelector('.code-lang-panel.active, .response-panel.active');
+    var codeEl = activePanel
+      ? activePanel.querySelector('.code-block, .font-mono')
+      : container.querySelector('.code-block, .font-mono');
+
+    if (!codeEl) return;
+
+    var text = codeEl.textContent || '';
+    navigator.clipboard.writeText(text).then(function () {
+      btn.classList.add('copied');
+      var tooltip = btn.nextElementSibling;
+      if (tooltip && tooltip.classList.contains('copy-tooltip')) {
+        tooltip.textContent = 'Copied!';
+      }
+      setTimeout(function () {
+        btn.classList.remove('copied');
+        if (tooltip && tooltip.classList.contains('copy-tooltip')) {
+          tooltip.textContent = 'Copy';
+        }
+      }, 2000);
+    });
+  });
+
+  // Close dropdowns on Escape
+  document.addEventListener('keydown', function (e) {
+    if (e.key === 'Escape') {
+      document.querySelectorAll('.code-lang-menu').forEach(function (menu) {
+        menu.classList.add('hidden');
+        var btn = menu.parentElement.querySelector('.code-lang-trigger');
+        if (btn) btn.setAttribute('aria-expanded', 'false');
+      });
+    }
+  });
+
+  // ── Directive Tabs (:::tabs and :::code-group) ────────────────────
+
+  document.addEventListener('click', function (e) {
+    var tab = e.target.closest('.directive-tab');
+    if (!tab) return;
+
+    var group = tab.getAttribute('data-tab-group');
+    var index = tab.getAttribute('data-tab-index');
+    var scrollY = window.scrollY;
+
+    // Update tab buttons
+    document.querySelectorAll('.directive-tab[data-tab-group="' + group + '"]').forEach(function (t) {
+      t.classList.toggle('active', t.getAttribute('data-tab-index') === index);
+    });
+
+    // Update panels
+    document.querySelectorAll('.directive-tab-panel[data-tab-group="' + group + '"]').forEach(function (p) {
+      p.classList.toggle('active', p.getAttribute('data-tab-index') === index);
+    });
+
+    window.scrollTo(0, scrollY);
+  });
 })();

package/dist/components/App.d.ts

@@ -1,15 +1,16 @@
 import type { NormalizedSpec } from "../core/types.js";
 import type { SiteNavigation } from "../core/navigation.js";
-import type { RenderOptions, CurrentPage } from "../renderer/context.js";
+import type { RenderOptions, CurrentPage, SiteConfig } from "../renderer/context.js";
 export interface AppProps {
     spec: NormalizedSpec;
     options: RenderOptions;
     navigation: SiteNavigation;
     currentPage: CurrentPage;
+    site: SiteConfig;
 }
 /**
  * Root component. Renders a complete HTML document with modern layout.
  * When embeddable, renders just the page content without html/body wrapper.
  */
-export declare function App({ spec, options, navigation, currentPage }: AppProps): import("preact").JSX.Element;
+export declare function App({ spec, options, navigation, currentPage, site }: AppProps): import("preact").JSX.Element;
 //# sourceMappingURL=App.d.ts.map

package/dist/components/App.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/components/App.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAIzE,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,cAAc,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,EAAE,QAAQ,gCAwBvE"}
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../src/components/App.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAQ5D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIrF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,cAAc,CAAC;IAC3B,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,QAAQ,gCA0B7E"}

package/dist/components/App.js

@@ -1,13 +1,13 @@
 import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
-import { SpecContext, OptionsContext, NavigationContext, PageContext, } from "../renderer/context.js";
+import { SpecContext, OptionsContext, NavigationContext, PageContext, SiteContext, } from "../renderer/context.js";
 import { Head } from "./layout/Head.js";
 import { Page } from "./layout/Page.js";
 /**
  * Root component. Renders a complete HTML document with modern layout.
  * When embeddable, renders just the page content without html/body wrapper.
  */
-export function App({ spec, options, navigation, currentPage }) {
+export function App({ spec, options, navigation, currentPage, site }) {
     const content = options.embeddable ? (_jsx(Page, {})) : (_jsxs("html", { lang: "en", children: [_jsx(Head, {}), _jsxs("body", { id: "sourcey", children: [_jsx(Page, {}), _jsx("script", { src: `${options.assetBase}sourcey.js`, defer: true })] })] }));
-    return (_jsx(SpecContext.Provider, { value: spec, children: _jsx(OptionsContext.Provider, { value: options, children: _jsx(NavigationContext.Provider, { value: navigation, children: _jsx(PageContext.Provider, { value: currentPage, children: content }) }) }) }));
+    return (_jsx(SiteContext.Provider, { value: site, children: _jsx(SpecContext.Provider, { value: spec, children: _jsx(OptionsContext.Provider, { value: options, children: _jsx(NavigationContext.Provider, { value: navigation, children: _jsx(PageContext.Provider, { value: currentPage, children: content }) }) }) }) }));
 }
 //# sourceMappingURL=App.js.map

package/dist/components/App.js.map

@@ -1 +1 @@
-{"version":3,"file":"App.js","sourceRoot":"","sources":["../../src/components/App.tsx"],"names":[],"mappings":";AAEA,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AASxC;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAY;IACtE,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CACnC,KAAC,IAAI,KAAG,CACT,CAAC,CAAC,CAAC,CACF,gBAAM,IAAI,EAAC,IAAI,aACb,KAAC,IAAI,KAAG,EACR,gBAAM,EAAE,EAAC,SAAS,aAChB,KAAC,IAAI,KAAG,EACR,iBAAQ,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,KAAK,SAAG,IAClD,IACF,CACR,CAAC;IAEF,OAAO,CACL,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAC/B,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YACrC,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,UAAU,YAC3C,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,WAAW,YACrC,OAAO,GACa,GACI,GACL,GACL,CACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"App.js","sourceRoot":"","sources":["../../src/components/App.tsx"],"names":[],"mappings":";AAEA,OAAO,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,WAAW,EACX,WAAW,GACZ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAUxC;;;GAGG;AACH,MAAM,UAAU,GAAG,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,IAAI,EAAY;IAC5E,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CACnC,KAAC,IAAI,KAAG,CACT,CAAC,CAAC,CAAC,CACF,gBAAM,IAAI,EAAC,IAAI,aACb,KAAC,IAAI,KAAG,EACR,gBAAM,EAAE,EAAC,SAAS,aAChB,KAAC,IAAI,KAAG,EACR,iBAAQ,GAAG,EAAE,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,KAAK,SAAG,IAClD,IACF,CACR,CAAC;IAEF,OAAO,CACL,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAC/B,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,YAC/B,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,OAAO,YACrC,KAAC,iBAAiB,CAAC,QAAQ,IAAC,KAAK,EAAE,UAAU,YAC3C,KAAC,WAAW,CAAC,QAAQ,IAAC,KAAK,EAAE,WAAW,YACrC,OAAO,GACa,GACI,GACL,GACL,GACF,CACxB,CAAC;AACJ,CAAC"}

package/dist/components/layout/Head.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Head.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Head.tsx"],"names":[],"mappings":"AAGA,wBAAgB,IAAI,iCA6CnB"}
+{"version":3,"file":"Head.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Head.tsx"],"names":[],"mappings":"AAIA,wBAAgB,IAAI,iCAuEnB"}

package/dist/components/layout/Head.js

@@ -1,29 +1,50 @@
-import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "preact/jsx-runtime";
 import { useContext } from "preact/hooks";
-import { SpecContext, OptionsContext, PageContext } from "../../renderer/context.js";
+import { SpecContext, OptionsContext, PageContext, SiteContext, NavigationContext } from "../../renderer/context.js";
+import { langIconCSS } from "../../utils/lang-icons.js";
 export function Head() {
+    const site = useContext(SiteContext);
     const spec = useContext(SpecContext);
     const options = useContext(OptionsContext);
     const page = useContext(PageContext);
-    // Page title: use markdown page title, or spec title
-    const siteName = spec.info.title || "";
+    const siteName = site.name || spec.info.title || "";
     const pageTitle = page.kind === "markdown"
         ? (siteName ? `${page.markdown.title} — ${siteName}` : page.markdown.title)
         : `${siteName} — API Reference`;
     const pageDescription = page.kind === "markdown"
         ? page.markdown.description || pageTitle
         : spec.info.description ?? `${siteName} API Documentation`;
-    // Blocking style to prevent flash: sets body bg from design tokens
-    // before the main stylesheet loads. The tokens are defined here as
-    // fallback values matching main.css so there's no hardcoded hex.
-    const antiFlashCSS = `
+    const nav = useContext(NavigationContext);
+    const { colors, fonts, layout } = site.theme;
+    const headerHeight = nav.tabs.length > 1 ? "7rem" : "4rem";
+    // Extract font family names for Google Fonts loading
+    const systemFonts = new Set(["system-ui", "sans-serif", "serif", "monospace", "-apple-system", "BlinkMacSystemFont", "Segoe UI", "Consolas", "SF Mono", "Fira Code", "Cascadia Code"]);
+    function extractFontName(stack) {
+        const m = stack.match(/^'([^']+)'/);
+        return m && !systemFonts.has(m[1]) ? m[1] : null;
+    }
+    const googleFonts = [extractFontName(fonts.sans), extractFontName(fonts.mono)].filter(Boolean);
+    const googleFontsUrl = googleFonts.length
+        ? "https://fonts.googleapis.com/css2?" + googleFonts.map(f => `family=${encodeURIComponent(f)}:wght@300;400;500;600;700`).join("&") + "&display=swap"
+        : null;
+    const themeCSS = `
     :root {
+      --color-primary: ${colors.primary};
+      --color-primary-light: ${colors.light};
+      --color-primary-dark: ${colors.dark};
       --color-background-light: 255 255 255;
       --color-background-dark: 11 12 16;
+      --font-sans: ${fonts.sans};
+      --font-mono: ${fonts.mono};
+      --sidebar-width: ${layout.sidebar};
+      --toc-width: ${layout.toc};
+      --content-max-width: ${layout.content};
+      --header-height: ${headerHeight};
     }
+    html { scroll-padding-top: ${headerHeight}; }
     body { margin: 0; background: rgb(var(--color-background-light)); }
     .dark body { background: rgb(var(--color-background-dark)); }
   `;
-    return (_jsxs("head", { children: [_jsx("meta", { charset: "utf-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsx("title", { children: pageTitle }), _jsx("meta", { name: "description", content: pageDescription }), _jsx("meta", { name: "sourcey-search", content: `${options.assetBase}search-index.json` }), _jsx("style", { dangerouslySetInnerHTML: { __html: antiFlashCSS } }), _jsx("script", { dangerouslySetInnerHTML: { __html: `(function(){var t=localStorage.getItem('sourcey-theme');if(t==='dark')document.documentElement.classList.add('dark')})()` } }), _jsx("link", { rel: "preconnect", href: "https://fonts.googleapis.com" }), _jsx("link", { rel: "preconnect", href: "https://fonts.gstatic.com", crossOrigin: "anonymous" }), _jsx("link", { rel: "stylesheet", href: "https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" }), _jsx("link", { rel: "stylesheet", href: `${options.assetBase}sourcey.css` }), spec.info.favicon && _jsx("link", { rel: "icon", href: spec.info.favicon })] }));
+    return (_jsxs("head", { children: [_jsx("meta", { charset: "utf-8" }), _jsx("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }), _jsx("title", { children: pageTitle }), _jsx("meta", { name: "description", content: pageDescription }), _jsx("meta", { name: "sourcey-search", content: `${options.assetBase}search-index.json` }), _jsx("style", { dangerouslySetInnerHTML: { __html: themeCSS } }), _jsx("style", { dangerouslySetInnerHTML: { __html: langIconCSS() } }), site.customCSS && _jsx("style", { dangerouslySetInnerHTML: { __html: site.customCSS } }), _jsx("script", { dangerouslySetInnerHTML: { __html: `(function(){var t=localStorage.getItem('sourcey-theme');if(t==='dark')document.documentElement.classList.add('dark')})()` } }), googleFontsUrl && (_jsxs(_Fragment, { children: [_jsx("link", { rel: "preconnect", href: "https://fonts.googleapis.com" }), _jsx("link", { rel: "preconnect", href: "https://fonts.gstatic.com", crossOrigin: "anonymous" }), _jsx("link", { rel: "stylesheet", href: googleFontsUrl })] })), _jsx("link", { rel: "stylesheet", href: `${options.assetBase}sourcey.css` }), site.favicon && _jsx("link", { rel: "icon", href: site.favicon })] }));
 }
 //# sourceMappingURL=Head.js.map

package/dist/components/layout/Head.js.map

@@ -1 +1 @@
-{"version":3,"file":"Head.js","sourceRoot":"","sources":["../../../src/components/layout/Head.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAErF,MAAM,UAAU,IAAI;IAClB,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAErC,qDAAqD;IACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,KAAK,UAAU;QACxC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAS,CAAC,KAAK,MAAM,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAS,CAAC,KAAK,CAAC;QAC7E,CAAC,CAAC,GAAG,QAAQ,kBAAkB,CAAC;IAElC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,KAAK,UAAU;QAC9C,CAAC,CAAC,IAAI,CAAC,QAAS,CAAC,WAAW,IAAI,SAAS;QACzC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,GAAG,QAAQ,oBAAoB,CAAC;IAE7D,mEAAmE;IACnE,mEAAmE;IACnE,iEAAiE;IACjE,MAAM,YAAY,GAAG;;;;;;;GAOpB,CAAC;IAEF,OAAO,CACL,2BACE,eAAM,OAAO,EAAC,OAAO,GAAG,EACxB,eAAM,IAAI,EAAC,UAAU,EAAC,OAAO,EAAC,qCAAqC,GAAG,EACtE,0BAAQ,SAAS,GAAS,EAC1B,eAAM,IAAI,EAAC,aAAa,EAAC,OAAO,EAAE,eAAe,GAAI,EACrD,eAAM,IAAI,EAAC,gBAAgB,EAAC,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,mBAAmB,GAAI,EAEhF,gBAAO,uBAAuB,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,GAAI,EAE5D,iBAAQ,uBAAuB,EAAE,EAAE,MAAM,EAAE,0HAA0H,EAAE,GAAI,EAC3K,eAAM,GAAG,EAAC,YAAY,EAAC,IAAI,EAAC,8BAA8B,GAAG,EAC7D,eAAM,GAAG,EAAC,YAAY,EAAC,IAAI,EAAC,2BAA2B,EAAC,WAAW,EAAC,WAAW,GAAG,EAClF,eAAM,GAAG,EAAC,YAAY,EAAC,IAAI,EAAC,sFAAsF,GAAG,EACrH,eAAM,GAAG,EAAC,YAAY,EAAC,IAAI,EAAE,GAAG,OAAO,CAAC,SAAS,aAAa,GAAI,EACjE,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,eAAM,GAAG,EAAC,MAAM,EAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,GAAI,IAC7D,CACR,CAAC;AACJ,CAAC"}
+{"version":3,"file":"Head.js","sourceRoot":"","sources":["../../../src/components/layout/Head.tsx"],"names":[],"mappings":"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"}

package/dist/components/layout/Header.d.ts

@@ -1,13 +1,8 @@
 /**
- * Two-row site header two-row layout.
- * Row 1 (h-16): logo, search, theme toggle
+ * Two-row site header.
+ * Row 1 (h-16): logo, search, navbar links, theme toggle
  * Row 2 (h-12): navigation tabs
  * Total: 7rem (header-height)
  */
 export declare function Header(): import("preact").JSX.Element;
-/**
- * Mobile header is now integrated into the main Header component.
- * This is kept as a no-op for backward compatibility.
- */
-export declare function MobileHeader(): null;
 //# sourceMappingURL=Header.d.ts.map

package/dist/components/layout/Header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Header.tsx"],"names":[],"mappings":"AAsCA;;;;;GAKG;AACH,wBAAgB,MAAM,iCAwHrB;AAED;;;GAGG;AACH,wBAAgB,YAAY,SAE3B"}
+{"version":3,"file":"Header.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Header.tsx"],"names":[],"mappings":"AAuCA;;;;;GAKG;AACH,wBAAgB,MAAM,iCAiKrB"}