sourcey 3.6.4 → 3.6.5

package/dist/client/tabs.js

@@ -11,15 +11,15 @@
     // ── Language Dropdown ──────────────────────────────────────────────
 
     // Toggle dropdown open/close
-    document.addEventListener('click', function (e) {
-      var trigger = e.target.closest('.code-lang-trigger');
+    document.addEventListener("click", function (e) {
+      var trigger = e.target.closest(".code-lang-trigger");
 
       // Close all open dropdowns first
-      document.querySelectorAll('.code-lang-menu').forEach(function (menu) {
+      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');
+          closeMenu(menu);
+          var btn = menu.parentElement.querySelector(".code-lang-trigger");
+          if (btn) btn.setAttribute("aria-expanded", "false");
         }
       });
 
@@ -29,26 +29,31 @@
       var menu = trigger.nextElementSibling;
       if (!menu) return;
 
-      var isOpen = !menu.classList.contains('hidden');
-      menu.classList.toggle('hidden', isOpen);
-      trigger.setAttribute('aria-expanded', isOpen ? 'false' : 'true');
+      var isOpen = !menu.classList.contains("hidden");
+      if (isOpen) {
+        closeMenu(menu);
+      } else {
+        menu.classList.remove("hidden");
+        positionMenu(trigger, menu);
+      }
+      trigger.setAttribute("aria-expanded", isOpen ? "false" : "true");
     });
 
     // Select a language / example variant from the dropdown
-    document.addEventListener('click', function (e) {
-      var option = e.target.closest('.code-lang-option');
+    document.addEventListener("click", function (e) {
+      var option = e.target.closest(".code-lang-option");
       if (!option) return;
 
-      var dropdown = option.closest('.code-lang-dropdown');
-      var canSync = !!(dropdown && dropdown.hasAttribute('data-lang-sync'));
+      var dropdown = option.closest(".code-lang-dropdown");
+      var canSync = !!(dropdown && dropdown.hasAttribute("data-lang-sync"));
       var lang = option.textContent.trim();
 
       // Close the menu
-      var menu = option.closest('.code-lang-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');
+        closeMenu(menu);
+        var trigger = menu.parentElement.querySelector(".code-lang-trigger");
+        if (trigger) trigger.setAttribute("aria-expanded", "false");
       }
 
       var scrollY = window.scrollY;
@@ -57,10 +62,11 @@
       // Sync language across code-sample groups only (not example variants).
       if (canSync && lang !== selectedLang) {
         selectedLang = lang;
-        var ownGroup = option.closest('.code-group');
-        document.querySelectorAll('.code-group').forEach(function (group) {
-          if (group === ownGroup || !group.querySelector('.code-lang-dropdown[data-lang-sync]')) return;
-          group.querySelectorAll('.code-lang-option').forEach(function (opt) {
+        var ownGroup = option.closest(".code-group");
+        document.querySelectorAll(".code-group").forEach(function (group) {
+          if (group === ownGroup || !group.querySelector(".code-lang-dropdown[data-lang-sync]"))
+            return;
+          group.querySelectorAll(".code-lang-option").forEach(function (opt) {
             if (opt.textContent.trim() === lang) activateLang(opt);
           });
         });
@@ -69,78 +75,115 @@
       window.scrollTo(0, scrollY);
     });
 
+    function closeMenu(menu) {
+      menu.classList.add("hidden");
+      menu.style.position = "";
+      menu.style.top = "";
+      menu.style.right = "";
+      menu.style.bottom = "";
+      menu.style.maxHeight = "";
+    }
+
+    function positionMenu(trigger, menu) {
+      var rect = trigger.getBoundingClientRect();
+      var gap = 4;
+      var viewportPadding = 8;
+      var below = window.innerHeight - rect.bottom - viewportPadding;
+      var above = rect.top - viewportPadding;
+      var openUp = below < 160 && above > below;
+
+      menu.style.position = "fixed";
+      menu.style.right = Math.max(viewportPadding, window.innerWidth - rect.right) + "px";
+      menu.style.maxHeight = Math.max(96, Math.floor((openUp ? above : below) - gap)) + "px";
+
+      if (openUp) {
+        menu.style.top = "";
+        menu.style.bottom = Math.max(viewportPadding, window.innerHeight - rect.top + gap) + "px";
+      } else {
+        menu.style.bottom = "";
+        menu.style.top = Math.min(window.innerHeight - viewportPadding, rect.bottom + gap) + "px";
+      }
+    }
+
     // The panels a dropdown controls. A header variant dropdown (in the shared
     // card header) drives the matching response status panel; otherwise panels
     // live in the dropdown's own `.code-lang-scope` or `.code-group`.
     function panelScopeForOption(option) {
-      var headerWrap = option.closest('[data-response-dropdown]');
+      var headerWrap = option.closest("[data-response-dropdown]");
       if (headerWrap) {
-        var idx = headerWrap.getAttribute('data-response-dropdown');
-        var group = headerWrap.closest('.code-group');
-        var panel = group && group.querySelector('.response-panel[data-response-panel="' + idx + '"]');
+        var idx = headerWrap.getAttribute("data-response-dropdown");
+        var group = headerWrap.closest(".code-group");
+        var panel =
+          group && group.querySelector('.response-panel[data-response-panel="' + idx + '"]');
         if (panel) return panel;
       }
-      return option.closest('.code-lang-scope') || option.closest('.code-group');
+      return option.closest(".code-lang-scope") || option.closest(".code-group");
     }
 
     function activateLang(option) {
-      var dropdown = option.closest('.code-lang-dropdown');
+      var dropdown = option.closest(".code-lang-dropdown");
       var scope = panelScopeForOption(option);
-      var index = option.getAttribute('data-lang-index');
+      var index = option.getAttribute("data-lang-index");
 
       // Update the dropdown label + options (label/trigger live in the dropdown,
       // which for a header variant switcher is separate from the panel scope).
       if (dropdown) {
-        var label = dropdown.querySelector('.code-lang-label');
-        dropdown.querySelectorAll('.code-lang-option').forEach(function (opt) {
-          var isActive = opt.getAttribute('data-lang-index') === index;
-          opt.setAttribute('aria-selected', isActive ? 'true' : 'false');
-          opt.className = opt.className.replace(/(dark:)?text-\[rgb\([^\]]+\)\]/g, '').trim();
+        var label = dropdown.querySelector(".code-lang-label");
+        dropdown.querySelectorAll(".code-lang-option").forEach(function (opt) {
+          var isActive = opt.getAttribute("data-lang-index") === index;
+          opt.setAttribute("aria-selected", isActive ? "true" : "false");
+          opt.className = opt.className.replace(/(dark:)?text-\[rgb\([^\]]+\)\]/g, "").trim();
           if (isActive) {
-            opt.classList.add('text-[rgb(var(--color-primary))]', 'dark:text-[rgb(var(--color-primary-light))]');
+            opt.classList.add(
+              "text-[rgb(var(--color-primary))]",
+              "dark:text-[rgb(var(--color-primary-light))]",
+            );
             if (label) label.textContent = opt.textContent.trim();
-            var triggerIcon = dropdown.querySelector('.code-lang-trigger .code-lang-icon');
-            var optIcon = opt.querySelector('.lang-icon');
+            var triggerIcon = dropdown.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))]', 'dark:text-[rgb(var(--color-stone-400))]');
+            opt.classList.add(
+              "text-[rgb(var(--color-stone-600))]",
+              "dark:text-[rgb(var(--color-stone-400))]",
+            );
           }
         });
       }
 
       // Update panels within the controlled scope.
       if (scope) {
-        scope.querySelectorAll('.code-lang-panel').forEach(function (p) {
-          p.classList.toggle('active', p.getAttribute('data-lang-panel') === index);
+        scope.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');
+    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 container = tab.closest(".response-tabs");
+      var index = tab.getAttribute("data-response-index");
       var scrollY = window.scrollY;
 
       // Update tabs
-      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');
+      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('.response-panel').forEach(function (p) {
-        p.classList.toggle('active', p.getAttribute('data-response-panel') === index);
+      container.querySelectorAll(".response-panel").forEach(function (p) {
+        p.classList.toggle("active", p.getAttribute("data-response-panel") === index);
       });
 
       // Show only the active status's variant switcher in the header.
-      container.querySelectorAll('[data-response-dropdown]').forEach(function (d) {
-        d.classList.toggle('hidden', d.getAttribute('data-response-dropdown') !== index);
+      container.querySelectorAll("[data-response-dropdown]").forEach(function (d) {
+        d.classList.toggle("hidden", d.getAttribute("data-response-dropdown") !== index);
       });
 
       window.scrollTo(0, scrollY);
@@ -148,35 +191,37 @@
 
     // ── Copy Button ────────────────────────────────────────────────────
 
-    document.addEventListener('click', function (e) {
-      var btn = e.target.closest('.copy-btn');
+    document.addEventListener("click", function (e) {
+      var btn = e.target.closest(".copy-btn");
       if (!btn) return;
 
-      var container = btn.closest('.code-group') || btn.closest('.prose-code-block');
+      var container = btn.closest(".code-group") || btn.closest(".prose-code-block");
       if (!container) return;
 
       // Find the active panel's code, or the nearest code element. With nested
       // panels (a variant switcher inside a response tab), prefer the deepest
       // active panel, which is last in document order.
-      var activePanels = container.querySelectorAll('.code-lang-panel.active, .response-panel.active');
+      var activePanels = container.querySelectorAll(
+        ".code-lang-panel.active, .response-panel.active",
+      );
       var activePanel = activePanels.length ? activePanels[activePanels.length - 1] : null;
       var codeEl = activePanel
-        ? activePanel.querySelector('code, .code-block, .font-mono')
-        : container.querySelector('code, .code-block, .font-mono');
+        ? activePanel.querySelector("code, .code-block, .font-mono")
+        : container.querySelector("code, .code-block, .font-mono");
 
       if (!codeEl) return;
 
-      var text = codeEl.textContent || '';
+      var text = codeEl.textContent || "";
       navigator.clipboard.writeText(text).then(function () {
-        btn.classList.add('copied');
+        btn.classList.add("copied");
         var tooltip = btn.nextElementSibling;
-        if (tooltip && tooltip.classList.contains('copy-tooltip')) {
-          tooltip.textContent = 'Copied!';
+        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';
+          btn.classList.remove("copied");
+          if (tooltip && tooltip.classList.contains("copy-tooltip")) {
+            tooltip.textContent = "Copy";
           }
         }, 2000);
       });
@@ -185,64 +230,68 @@
     // ── Rust Doctest Hidden-Line Toggle ──────────────────────────────
     // (Copy is handled by the shared .copy-btn inside each code block.)
 
-    document.addEventListener('click', function (e) {
-      var toggleBtn = e.target.closest('.rust-doctest-toggle-hidden');
+    document.addEventListener("click", function (e) {
+      var toggleBtn = e.target.closest(".rust-doctest-toggle-hidden");
       if (!toggleBtn) return;
-      var fullSel = toggleBtn.getAttribute('data-target');
-      var displaySel = toggleBtn.getAttribute('data-display');
-      var fullEl = fullSel ? document.getElementById(fullSel.replace(/^#/, '')) : null;
-      var displayEl = displaySel ? document.getElementById(displaySel.replace(/^#/, '')) : null;
+      var fullSel = toggleBtn.getAttribute("data-target");
+      var displaySel = toggleBtn.getAttribute("data-display");
+      var fullEl = fullSel ? document.getElementById(fullSel.replace(/^#/, "")) : null;
+      var displayEl = displaySel ? document.getElementById(displaySel.replace(/^#/, "")) : null;
       if (!fullEl || !displayEl) return;
-      var fullHidden = fullEl.hasAttribute('hidden');
+      var fullHidden = fullEl.hasAttribute("hidden");
       if (fullHidden) {
-        fullEl.removeAttribute('hidden');
-        displayEl.setAttribute('hidden', '');
-        toggleBtn.textContent = 'Hide hidden lines';
+        fullEl.removeAttribute("hidden");
+        displayEl.setAttribute("hidden", "");
+        toggleBtn.textContent = "Hide hidden lines";
       } else {
-        fullEl.setAttribute('hidden', '');
-        displayEl.removeAttribute('hidden');
-        toggleBtn.textContent = 'Show hidden lines';
+        fullEl.setAttribute("hidden", "");
+        displayEl.removeAttribute("hidden");
+        toggleBtn.textContent = "Show hidden lines";
       }
     });
 
     // 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');
+    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');
+    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 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);
-      });
+      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);
-      });
+      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);
     });
   }
 
-  if ('requestIdleCallback' in window) {
+  if ("requestIdleCallback" in window) {
     window.requestIdleCallback(init, { timeout: 250 });
   } else {
-    window.addEventListener('load', init, { once: true });
+    window.addEventListener("load", init, { once: true });
   }
 })();

package/dist/components/openapi/Tags.js

@@ -11,6 +11,6 @@ export function Tags({ tags, serverUrl }) {
             .map((tag) => {
             const parents = tagLineage(tag, tagsByName);
             const displayName = tagDisplayName(tag);
-            return (_jsxs("div", { class: tag.parent ? "mt-8" : "mt-12", children: [_jsxs("div", { id: `tag-${htmlId(tag.name)}`, "data-traverse-target": `tag-${htmlId(tag.name)}`, class: "mb-6", children: [parents.length > 0 && (_jsx("div", { class: "mb-2 text-xs font-medium uppercase tracking-[0.12em] text-[rgb(var(--color-gray-500))]", children: parents.map(tagDisplayName).join(" / ") })), _jsxs("div", { class: "mb-2 flex flex-wrap items-center gap-2", children: [_jsx("h1", { class: "text-xl font-bold text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: displayName }), tag.summary && tag.summary !== tag.name && (_jsx(Badge, { children: _jsx("code", { children: tag.name }) })), tag.kind && _jsx(Badge, { children: tag.kind })] }), tag.description && (_jsx(Markdown, { content: tag.description, class: "text-sm max-w-none" }))] }), tag.operations.map((op) => (_jsx(Operation, { operation: op, serverUrl: serverUrl }, `${op.method}-${op.path}`)))] }, tag.name));
+            return (_jsxs("div", { class: tag.parent ? "mt-8" : "mt-12", children: [_jsxs("div", { id: `tag-${htmlId(tag.name)}`, "data-traverse-target": `tag-${htmlId(tag.name)}`, class: "mb-6", children: [parents.length > 0 && (_jsx("div", { class: "mb-2 text-xs font-medium uppercase tracking-[0.12em] text-[rgb(var(--color-gray-500))]", children: parents.map(tagDisplayName).join(" / ") })), _jsxs("div", { class: "mb-2 flex flex-wrap items-center gap-2", children: [_jsx("h1", { class: "text-2xl sm:text-3xl font-bold tracking-tight text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))]", children: displayName }), tag.summary && tag.summary !== tag.name && (_jsx(Badge, { children: _jsx("code", { children: tag.name }) })), tag.kind && _jsx(Badge, { children: tag.kind })] }), tag.description && (_jsx(Markdown, { content: tag.description, class: "text-sm max-w-none" }))] }), tag.operations.map((op) => (_jsx(Operation, { operation: op, serverUrl: serverUrl }, `${op.method}-${op.path}`)))] }, tag.name));
         }) }));
 }

package/dist/index.d.ts

@@ -25,6 +25,7 @@ export interface SiteBuildOptions {
     skipWrite?: boolean;
     embeddable?: boolean;
     strictChangelog?: boolean;
+    generateOgImages?: boolean;
 }
 export interface SiteBuildResult {
     outputDir: string;
@@ -39,6 +40,8 @@ export declare function buildSiteDocs(options?: SiteBuildOptions): Promise<SiteB
 export { defineConfig } from "./config.js";
 export { doxygen, godoc, markdown, mcp, mkdocs, openapi, rustdoc } from "./adapters/index.js";
 export { resolveInternalLinks } from "./site-assembly.js";
+export { buildSourceySite, collectSourceyWatchPaths, writeSourceySite } from "./site.js";
+export type { SourceySiteArtifacts, SourceySiteOptions, SourceySiteWriteOptions } from "./site.js";
 export type { NormalizedSpec, NormalizedOperation, NormalizedTag, NormalizedSchema, NormalizedParameter, NormalizedRequestBody, NormalizedResponse, } from "./core/types.js";
 export type { DoxygenSourceOptions, GodocSourceOptions, MarkdownSourceOptions, McpSourceOptions, MkDocsSourceOptions, OpenApiSourceOptions, ResolvedTabSource, RustdocSourceOptions, SourceAdapter, SourceAdapterContext, } from "./adapters/index.js";
 export type { RustdocConfig, ResolvedRustdocConfig, RustdocMode, RustdocFeatures, } from "./config.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAmBlD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAkB3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,OAAO,wBAAwB,EAAE,qBAAqB,EAAE,CAAC;IAC3E,kBAAkB,EAAE,OAAO,0BAA0B,EAAE,uBAAuB,EAAE,CAAC;IACjF,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgG5F;AA8CD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,eAAe,GAChB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AASlD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAkB3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,OAAO,wBAAwB,EAAE,qBAAqB,EAAE,CAAC;IAC3E,kBAAkB,EAAE,OAAO,0BAA0B,EAAE,uBAAuB,EAAE,CAAC;IACjF,wDAAwD;IACxD,MAAM,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACtC;AAED,wBAAsB,aAAa,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,eAAe,CAAC,CAsB5F;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACzF,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAGnG,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,11 +1,7 @@
-import { readFile } from "node:fs/promises";
-import { extname, resolve } from "node:path";
-import { buildSite as buildSiteHtml } from "./renderer/html-builder.js";
+import { resolve } from "node:path";
 import { loadConfig, configFromSpec } from "./config.js";
-import { buildSiteNavigation } from "./core/navigation.js";
-import { buildSearchIndex } from "./core/search-indexer.js";
-import { generateLlmsTxt, generateLlmsFullTxt } from "./renderer/llms.js";
-import { assembleSite, buildSiteConfig, collectDocsPagesByTab, createMinimalSpec, enforceChangelogDiagnostics, enforceGodocDiagnostics, enforceRustdocDiagnostics, } from "./site-assembly.js";
+import { buildSourceySite, writeSourceySite } from "./site.js";
+import { createMinimalSpec } from "./site-assembly.js";
 /**
  * Build API documentation from a single OpenAPI/Swagger spec.
  * Wraps the spec in a single-tab site and renders through the modern layout.
@@ -30,117 +26,25 @@ export async function buildDocs(options) {
 export async function buildSiteDocs(options = {}) {
     const outputDir = resolve(options.outputDir ?? "dist");
     const config = options.config ?? (await loadConfig(options.configDir));
-    const assembled = await assembleSite(config);
-    const site = await buildSiteConfig(config);
-    const sitePages = Array.from(assembled.pageMap.values());
-    const navigation = buildSiteNavigation(assembled.siteTabs);
-    enforceChangelogDiagnostics(assembled.changelogDiagnostics, options.strictChangelog);
-    enforceGodocDiagnostics(assembled.godocDiagnostics);
-    enforceRustdocDiagnostics(assembled.rustdocDiagnostics);
-    const docsPagesByTab = collectDocsPagesByTab(assembled.pageMap, config.tabs);
-    const searchIndex = buildSearchIndex(assembled.specsBySlug, docsPagesByTab, navigation, config.baseUrl || "/", config.search.featured, config.prettyUrls);
-    const llmsTxt = generateLlmsTxt(sitePages, navigation, site);
-    const llmsFullTxt = generateLlmsFullTxt(sitePages, navigation, site);
-    const extraFiles = new Map(assembled.extraFiles);
-    const ogImages = new Map();
-    if (!config.ogImage) {
-        const { generateOgImage } = await import("./og/generate-og-image.js");
-        const CONCURRENCY = 8;
-        for (let i = 0; i < sitePages.length; i += CONCURRENCY) {
-            const batch = sitePages.slice(i, i + CONCURRENCY);
-            await Promise.all(batch.map(async (page) => {
-                const ogMeta = describePageForOg(page, config.name || "API", config.changelog.ogImages);
-                if (!ogMeta)
-                    return;
-                try {
-                    const ogPath = `_og/${page.outputPath.replace(/\.html$/, ".png")}`;
-                    const png = await generateOgImage({
-                        title: ogMeta.title,
-                        description: ogMeta.description,
-                        siteName: config.name,
-                        theme: config.theme,
-                        logo: site.logo?.light,
-                    });
-                    page.ogImagePath = ogPath;
-                    ogImages.set(ogPath, png);
-                }
-                catch (error) {
-                    const message = error instanceof Error ? error.message : String(error);
-                    console.warn(`Sourcey: skipping OG image for ${page.outputPath}: ${message}`);
-                }
-            }));
-        }
-    }
-    else {
-        const staticOg = config.ogImage;
-        if (staticOg.startsWith("http://") ||
-            staticOg.startsWith("https://") ||
-            staticOg.startsWith("data:")) {
-            for (const page of sitePages) {
-                page.ogImagePath = staticOg;
-            }
-        }
-        else {
-            const ogPath = `_og/static${extname(staticOg) || ".png"}`;
-            extraFiles.set(ogPath, await readFile(staticOg));
-            for (const page of sitePages) {
-                page.ogImagePath = ogPath;
-            }
-        }
-    }
+    const sourceySite = await buildSourceySite({
+        config,
+        outputDir,
+        strictChangelog: options.strictChangelog,
+        generateOgImages: options.generateOgImages,
+    });
     if (!options.skipWrite) {
-        await buildSiteHtml(sitePages, navigation, outputDir, site, {
-            searchIndex,
-            llmsTxt,
-            llmsFullTxt,
-            embeddable: options.embeddable,
-            ogImages,
-            extraFiles,
-        });
+        await writeSourceySite(sourceySite, { embeddable: options.embeddable });
     }
     return {
         outputDir,
-        pageCount: sitePages.length,
-        changelogDiagnostics: assembled.changelogDiagnostics,
-        godocDiagnostics: assembled.godocDiagnostics,
-        rustdocDiagnostics: assembled.rustdocDiagnostics,
-        _specs: assembled.specsBySlug,
+        pageCount: sourceySite.pageCount,
+        changelogDiagnostics: sourceySite.changelogDiagnostics,
+        godocDiagnostics: sourceySite.godocDiagnostics,
+        rustdocDiagnostics: sourceySite.rustdocDiagnostics,
+        _specs: sourceySite.specsBySlug,
     };
 }
-function describePageForOg(page, defaultSiteName, changelogPermalinkOg) {
-    if (page.currentPage.kind === "markdown") {
-        return {
-            title: page.currentPage.markdown.title,
-            description: page.currentPage.markdown.description || undefined,
-        };
-    }
-    if (page.currentPage.kind === "changelog") {
-        const changelog = page.currentPage.changelog;
-        if (changelog.permalinkVersionId) {
-            if (!changelogPermalinkOg)
-                return null;
-            const version = changelog.changelog.versions.find((candidate) => candidate.id === changelog.permalinkVersionId);
-            if (!version)
-                return null;
-            return {
-                title: `${version.version ?? "Unreleased"} - ${changelog.title}`,
-                description: version.summary || summarizeVersion(version),
-            };
-        }
-        return {
-            title: changelog.title,
-            description: changelog.description || changelog.changelog.description,
-        };
-    }
-    return { title: `${defaultSiteName} Reference` };
-}
-function summarizeVersion(version) {
-    if (version.summary)
-        return version.summary;
-    const texts = version.sections.flatMap((section) => section.entries.map((entry) => entry.text));
-    const summary = texts.slice(0, 3).join(" ");
-    return summary || undefined;
-}
 export { defineConfig } from "./config.js";
 export { doxygen, godoc, markdown, mcp, mkdocs, openapi, rustdoc } from "./adapters/index.js";
 export { resolveInternalLinks } from "./site-assembly.js";
+export { buildSourceySite, collectSourceyWatchPaths, writeSourceySite } from "./site.js";

package/dist/renderer/static-files.d.ts

@@ -0,0 +1,6 @@
+import type { PrettyUrls } from "../site-url.js";
+export declare function outputPathFromRequestPath(pathname: string, baseUrl: string): string;
+export declare function outputPathCandidatesForRequest(pathname: string, baseUrl: string, prettyUrls: PrettyUrls): string[];
+export declare function requestPathMatchesBase(pathname: string, baseUrl: string): boolean;
+export declare function contentTypeForPath(path: string): string;
+//# sourceMappingURL=static-files.d.ts.map

package/dist/renderer/static-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-files.d.ts","sourceRoot":"","sources":["../../src/renderer/static-files.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGjD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAcnF;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GACrB,MAAM,EAAE,CAYV;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAMjF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwCvD"}