sourcey 3.5.10 → 3.6.1

package/dist/cli.js

@@ -7,7 +7,7 @@ import { loadConfig } from "./config.js";
 import { runIntrospector, GodocIntrospectorError } from "./core/godoc-introspector.js";
 import { GODOC_SCHEMA_VERSION } from "./core/godoc-types.js";
 import { init } from "./init.js";
-import { formatChangelogDiagnostic, formatGodocDiagnostic } from "./site-assembly.js";
+import { formatChangelogDiagnostic, formatGodocDiagnostic, formatRustdocDiagnostic, } from "./site-assembly.js";
 import pkg from "../package.json" with { type: "json" };
 const build = defineCommand({
     meta: {
@@ -84,6 +84,7 @@ const build = defineCommand({
                 if (!args.quiet) {
                     logChangelogDiagnostics(result.changelogDiagnostics);
                     logGodocDiagnostics(result.godocDiagnostics);
+                    logRustdocDiagnostics(result.rustdocDiagnostics);
                     const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
                     console.log(`  Pages:  ${result.pageCount}`);
                     console.log(`  Output: ${result.outputDir}`);
@@ -129,8 +130,9 @@ const dev = defineCommand({
     },
     async run({ args }) {
         const { startDevServer } = await import("./dev-server.js");
+        const port = parsePort(args.port);
         await startDevServer({
-            port: parseInt(args.port, 10),
+            port,
             host: args.host ?? process.env.HOST,
             config: args.config,
             strictChangelog: args.strictChangelog,
@@ -214,9 +216,15 @@ const godoc = defineCommand({
     },
     async run({ args }) {
         const moduleDir = resolve(process.cwd(), args.module);
-        const patterns = args.packages.split(",").map((p) => p.trim()).filter(Boolean);
+        const patterns = args.packages
+            .split(",")
+            .map((p) => p.trim())
+            .filter(Boolean);
         const exclude = args.exclude
-            ? args.exclude.split(",").map((p) => p.trim()).filter(Boolean)
+            ? args.exclude
+                .split(",")
+                .map((p) => p.trim())
+                .filter(Boolean)
             : [];
         const outputPath = resolve(process.cwd(), args.out);
         try {
@@ -282,36 +290,6 @@ const main = defineCommand({
         validate,
         godoc,
     },
-    args: {
-        spec: {
-            type: "positional",
-            description: "Path to an OpenAPI spec (shorthand for 'sourcey build <spec>')",
-            required: false,
-        },
-    },
-    async run({ args, rawArgs }) {
-        if (rawArgs.includes("init") ||
-            rawArgs.includes("build") ||
-            rawArgs.includes("dev") ||
-            rawArgs.includes("validate") ||
-            rawArgs.includes("godoc"))
-            return;
-        if (args.spec) {
-            await build.run({
-                args: {
-                    _: [],
-                    spec: args.spec,
-                    output: "dist",
-                    embed: false,
-                    config: undefined,
-                    quiet: false,
-                    strictChangelog: false,
-                },
-                rawArgs: [],
-                cmd: build,
-            });
-        }
-    },
 });
 function logChangelogDiagnostics(diagnostics) {
     for (const diagnostic of diagnostics) {
@@ -324,4 +302,20 @@ function logGodocDiagnostics(diagnostics) {
         writer(`  ${formatGodocDiagnostic(diagnostic)}`);
     }
 }
+function logRustdocDiagnostics(diagnostics) {
+    for (const diagnostic of diagnostics) {
+        const writer = diagnostic.severity === "error" ? console.error : console.log;
+        writer(`  ${formatRustdocDiagnostic(diagnostic)}`);
+    }
+}
+function parsePort(value) {
+    if (!/^\d+$/.test(value)) {
+        throw new Error(`Invalid port "${value}". Expected an integer from 1 to 65535.`);
+    }
+    const port = Number(value);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid port "${value}". Expected an integer from 1 to 65535.`);
+    }
+    return port;
+}
 runMain(main);

package/dist/client/search.js

@@ -1,10 +1,10 @@
 // Search — client-side search dialog with keyboard navigation
 (function () {
   function init() {
-    var dialog = document.getElementById('search-dialog');
-    var input = document.getElementById('search-input');
-    var results = document.getElementById('search-results');
-    var openBtn = document.getElementById('search-open');
+    var dialog = document.getElementById("search-dialog");
+    var input = document.getElementById("search-input");
+    var results = document.getElementById("search-results");
+    var openBtn = document.getElementById("search-open");
     if (!dialog || !input || !results) return;
 
     var entries = [];
@@ -16,127 +16,254 @@
     var searchMeta = document.querySelector('meta[name="sourcey-search"]');
 
     function loadJsonIndex(callback) {
-      if (indexLoaded) { callback(); return; }
-      if (!searchMeta) { indexLoaded = true; callback(); return; }
-      var url = searchMeta.getAttribute('content');
-      fetch(url).then(function (r) { return r.json(); }).then(function (data) {
-        entries = data.map(function (e) {
-          return {
-            url: e.url,
-            method: e.method || '',
-            path: e.path || '',
-            summary: e.title || '',
-            tag: e.tab || '',
-            content: e.content || '',
-            category: e.category || '',
-            featured: !!e.featured,
-            searchText: [e.method || '', e.path || '', e.title || '', e.content || '', e.tab || ''].join(' ').toLowerCase()
-          };
-        });
-        indexLoaded = true;
+      if (indexLoaded) {
         callback();
-      }).catch(function () {
+        return;
+      }
+      if (!searchMeta) {
         indexLoaded = true;
         callback();
-      });
+        return;
+      }
+      var url = searchMeta.getAttribute("content");
+      fetch(url)
+        .then(function (r) {
+          return r.json();
+        })
+        .then(function (data) {
+          entries = data.map(function (e) {
+            var title = e.title || "";
+            var qualifiedName = e.qualifiedName || "";
+            var owner = e.owner || "";
+            var tab = e.tab || "";
+            return {
+              url: e.url,
+              method: e.method || "",
+              path: e.path || "",
+              title: title,
+              summary: qualifiedName || title,
+              tag: owner ? owner : tab,
+              content: e.content || "",
+              category: e.category || "",
+              featured: !!e.featured,
+              symbolKind: e.symbolKind || "",
+              owner: owner,
+              ownerKind: e.ownerKind || "",
+              namespace: e.namespace || "",
+              qualifiedName: qualifiedName,
+              titleLower: title.toLowerCase(),
+              pathLower: (e.path || "").toLowerCase(),
+              qualifiedLower: qualifiedName.toLowerCase(),
+              ownerLower: owner.toLowerCase(),
+              searchText: [
+                e.method || "",
+                e.path || "",
+                title,
+                qualifiedName,
+                owner,
+                e.ownerKind || "",
+                e.namespace || "",
+                e.symbolKind || "",
+                e.content || "",
+                tab,
+              ]
+                .join(" ")
+                .toLowerCase(),
+            };
+          });
+          indexLoaded = true;
+          callback();
+        })
+        .catch(function () {
+          indexLoaded = true;
+          callback();
+        });
     }
 
-    var dialogInner = dialog.querySelector('.search-dialog-inner');
+    var dialogInner = dialog.querySelector(".search-dialog-inner");
 
     function positionDialog() {
       if (!openBtn || !dialogInner) return;
       var rect = openBtn.getBoundingClientRect();
-      dialogInner.style.position = 'absolute';
-      dialogInner.style.top = (rect.top - 4) + 'px';
+      dialogInner.style.position = "absolute";
+      dialogInner.style.top = rect.top - 4 + "px";
       var extraWidth = Math.min(rect.width * 0.5, 200);
-      dialogInner.style.left = (rect.left - extraWidth / 2) + 'px';
-      dialogInner.style.width = (rect.width + extraWidth) + 'px';
-      dialogInner.style.maxWidth = 'none';
-      dialogInner.style.transform = 'none';
-      dialogInner.style.margin = '0';
+      dialogInner.style.left = rect.left - extraWidth / 2 + "px";
+      dialogInner.style.width = rect.width + extraWidth + "px";
+      dialogInner.style.maxWidth = "none";
+      dialogInner.style.transform = "none";
+      dialogInner.style.margin = "0";
     }
 
     function open() {
       positionDialog();
-      dialog.classList.add('open');
-      input.value = '';
+      dialog.classList.add("open");
+      input.value = "";
       input.focus();
       if (!indexLoaded) {
         results.innerHTML = '<div class="search-loading">Loading…</div>';
-        loadJsonIndex(function () { showResults(''); });
+        loadJsonIndex(function () {
+          showResults("");
+        });
       } else {
-        showResults('');
+        showResults("");
       }
-      document.addEventListener('keydown', onDialogKey);
+      document.addEventListener("keydown", onDialogKey);
     }
 
     function close() {
-      dialog.classList.remove('open');
-      document.removeEventListener('keydown', onDialogKey);
+      dialog.classList.remove("open");
+      document.removeEventListener("keydown", onDialogKey);
     }
 
     function showResults(query) {
       var q = query.toLowerCase().trim();
       if (!q) {
         // Show featured pages first, then endpoints
-        var featured = entries.filter(function (e) { return e.featured; });
-        var rest = entries.filter(function (e) { return !e.featured && e.category !== 'Sections'; });
+        var featured = entries.filter(function (e) {
+          return e.featured;
+        });
+        var rest = entries.filter(function (e) {
+          return !e.featured && e.category !== "Sections";
+        });
         filtered = featured.concat(rest).slice(0, 30);
       } else {
         var terms = q.split(/\s+/);
-        filtered = entries.filter(function (e) {
-          return terms.every(function (t) { return e.searchText.indexOf(t) !== -1; });
-        });
-        // Sort by category so groups stay together (only for search results)
-        var categoryOrder = { Pages: 0, Sections: 1, Endpoints: 2, Models: 3 };
+        filtered = entries
+          .map(function (e) {
+            return { entry: e, score: scoreEntry(e, q, terms) };
+          })
+          .filter(function (result) {
+            return result.score > 0;
+          });
+        var categoryOrder = {
+          Pages: 0,
+          Endpoints: 1,
+          Models: 2,
+          Functions: 3,
+          Types: 4,
+          Enums: 5,
+          "Enum Values": 6,
+          Variables: 7,
+          Friends: 8,
+          Properties: 9,
+          Members: 10,
+          Sections: 20,
+        };
         filtered.sort(function (a, b) {
-          return (categoryOrder[a.category] || 9) - (categoryOrder[b.category] || 9);
+          if (b.score !== a.score) return b.score - a.score;
+          return (categoryOrder[a.entry.category] || 19) - (categoryOrder[b.entry.category] || 19);
         });
+        filtered = filtered
+          .map(function (result) {
+            return result.entry;
+          })
+          .slice(0, 50);
       }
 
       activeIndex = filtered.length ? 0 : -1;
       render();
     }
 
+    function scoreEntry(e, q, terms) {
+      if (
+        !terms.every(function (t) {
+          return e.searchText.indexOf(t) !== -1;
+        })
+      )
+        return 0;
+
+      var compactQuery = q.replace(/\s+/g, "");
+      var qualified = e.qualifiedLower || "";
+      var title = e.titleLower || "";
+      var path = e.pathLower || "";
+      var owner = e.ownerLower || "";
+      var score = 1;
+
+      if (qualified && qualified === compactQuery) score += 1200;
+      if (title && title === q) score += 900;
+      if (path && path === q) score += 850;
+      if (qualified && qualified.endsWith("::" + compactQuery)) score += 780;
+      if (owner && compactQuery === owner + "::" + title) score += 760;
+      if (qualified && compactQuery.indexOf("::") !== -1 && qualified.indexOf(compactQuery) !== -1)
+        score += 700;
+      if (title && title.indexOf(q) === 0) score += 500;
+      if (qualified && qualified.indexOf(compactQuery) !== -1) score += 420;
+      if (owner && owner.indexOf(compactQuery) !== -1) score += 240;
+      if (path && path.indexOf(q) !== -1) score += 180;
+      if (e.content.toLowerCase().indexOf(q) !== -1) score += 80;
+
+      if (e.category === "Sections") score -= 70;
+      if (e.symbolKind) score += 35;
+      if (e.featured) score += 20;
+      return score;
+    }
+
     function render() {
-      var html = '';
-      var lastCategory = '';
+      var html = "";
+      var lastCategory = "";
 
       for (var i = 0; i < filtered.length; i++) {
         var e = filtered[i];
-        var cat = e.category || 'Results';
+        var cat = e.category || "Results";
 
         if (cat !== lastCategory) {
-          html += '<div class="search-category">' + escapeHtml(cat) + '</div>';
+          html += '<div class="search-category">' + escapeHtml(cat) + "</div>";
           lastCategory = cat;
         }
 
-        var cls = 'search-result' + (i === activeIndex ? ' active' : '');
+        var cls = "search-result" + (i === activeIndex ? " active" : "");
         var label = e.method
-          ? '<span class="search-result-method method-' + e.method.toLowerCase() + '">' + e.method + '</span> ' +
-            '<span class="search-result-path">' + escapeHtml(e.path) + '</span>'
-          : '<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>' : '';
-
-        html += '<a href="' + e.url + '" class="' + cls + '" data-index="' + i + '">' +
-          '<div class="search-result-main">' + label + summaryLine + '</div>' +
-          tagLine + '</a>';
+          ? '<span class="search-result-method method-' +
+            e.method.toLowerCase() +
+            '">' +
+            e.method +
+            "</span> " +
+            '<span class="search-result-path">' +
+            escapeHtml(e.path) +
+            "</span>"
+          : '<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>"
+            : "";
+
+        html +=
+          '<a href="' +
+          escapeAttr(e.url) +
+          '" class="' +
+          cls +
+          '" data-index="' +
+          i +
+          '">' +
+          '<div class="search-result-main">' +
+          label +
+          summaryLine +
+          "</div>" +
+          tagLine +
+          "</a>";
       }
 
       results.innerHTML = html;
 
       // Scroll active result into view
-      var activeEl = results.querySelector('.search-result.active');
-      if (activeEl) activeEl.scrollIntoView({ block: 'nearest' });
+      var activeEl = results.querySelector(".search-result.active");
+      if (activeEl) activeEl.scrollIntoView({ block: "nearest" });
     }
 
     function escapeHtml(s) {
-      var el = document.createElement('span');
+      var el = document.createElement("span");
       el.textContent = s;
       return el.innerHTML;
     }
 
+    function escapeAttr(s) {
+      return escapeHtml(s).replace(/"/g, "&quot;").replace(/'/g, "&#39;");
+    }
+
     function navigate(index) {
       if (index < 0 || index >= filtered.length) return;
       var entry = filtered[index];
@@ -145,71 +272,75 @@
     }
 
     function onDialogKey(e) {
-      if (e.key === 'Escape') { close(); e.preventDefault(); return; }
-      if (e.key === 'ArrowDown') {
+      if (e.key === "Escape") {
+        close();
+        e.preventDefault();
+        return;
+      }
+      if (e.key === "ArrowDown") {
         e.preventDefault();
         activeIndex = Math.min(activeIndex + 1, filtered.length - 1);
         render();
         return;
       }
-      if (e.key === 'ArrowUp') {
+      if (e.key === "ArrowUp") {
         e.preventDefault();
         activeIndex = Math.max(activeIndex - 1, 0);
         render();
         return;
       }
-      if (e.key === 'Enter') {
+      if (e.key === "Enter") {
         e.preventDefault();
         if (activeIndex >= 0) navigate(activeIndex);
         return;
       }
     }
 
-    input.addEventListener('input', function () {
+    input.addEventListener("input", function () {
       showResults(input.value);
     });
 
-    results.addEventListener('click', function (e) {
-      var result = e.target.closest('.search-result');
+    results.addEventListener("click", function (e) {
+      var result = e.target.closest(".search-result");
       if (result) {
         e.preventDefault();
-        navigate(parseInt(result.getAttribute('data-index'), 10));
+        navigate(parseInt(result.getAttribute("data-index"), 10));
       }
     });
 
     // Open search
-    if (openBtn) openBtn.addEventListener('click', open);
+    if (openBtn) openBtn.addEventListener("click", open);
 
     // Also bind mobile search button
-    var mobileBtn = document.getElementById('search-open-mobile');
-    if (mobileBtn) mobileBtn.addEventListener('click', open);
+    var mobileBtn = document.getElementById("search-open-mobile");
+    if (mobileBtn) mobileBtn.addEventListener("click", open);
 
     // Keyboard shortcut: Ctrl+K or /
-    document.addEventListener('keydown', function (e) {
-      if ((e.ctrlKey || e.metaKey) && e.key === 'k') {
+    document.addEventListener("keydown", function (e) {
+      if ((e.ctrlKey || e.metaKey) && e.key === "k") {
         e.preventDefault();
         open();
       }
-      if (e.key === '/' && !isEditable(e.target)) {
+      if (e.key === "/" && !isEditable(e.target)) {
         e.preventDefault();
         open();
       }
     });
 
     // Close on backdrop click
-    dialog.addEventListener('click', function (e) {
+    dialog.addEventListener("click", function (e) {
       if (e.target === dialog) close();
     });
 
     function isEditable(el) {
       var tag = el.tagName;
-      return tag === 'INPUT' || tag === 'TEXTAREA' || tag === 'SELECT' || el.isContentEditable;
+      return tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT" || el.isContentEditable;
     }
   }
 
-  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/client/tabs.js

@@ -156,6 +156,29 @@
       });
     });
 
+    // ── 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');
+      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;
+      if (!fullEl || !displayEl) return;
+      var fullHidden = fullEl.hasAttribute('hidden');
+      if (fullHidden) {
+        fullEl.removeAttribute('hidden');
+        displayEl.setAttribute('hidden', '');
+        toggleBtn.textContent = 'Hide hidden lines';
+      } else {
+        fullEl.setAttribute('hidden', '');
+        displayEl.removeAttribute('hidden');
+        toggleBtn.textContent = 'Show hidden lines';
+      }
+    });
+
     // Close dropdowns on Escape
     document.addEventListener('keydown', function (e) {
       if (e.key === 'Escape') {

package/dist/components/layout/Head.js

@@ -13,15 +13,15 @@ export function Head() {
         : undefined;
     const siteName = site.name || spec.info.title || "";
     const pageTitle = page.kind === "markdown"
-        ? (siteName ? `${page.markdown.title} — ${siteName}` : page.markdown.title)
+        ? composePageTitle(page.markdown.title, siteName)
         : page.kind === "changelog"
             ? (() => {
                 const baseTitle = changelogVersion
-                    ? `${changelogVersion.version ?? "Unreleased"} — ${page.changelog.title}`
+                    ? `${changelogVersion.version ?? "Unreleased"} - ${page.changelog.title}`
                     : page.changelog.title;
-                return siteName ? `${baseTitle} — ${siteName}` : baseTitle;
+                return composePageTitle(baseTitle, siteName);
             })()
-            : `${siteName} — API Reference`;
+            : composePageTitle(siteName, "API Reference");
     const pageDescription = page.kind === "markdown"
         ? page.markdown.description || pageTitle
         : page.kind === "changelog"
@@ -58,3 +58,16 @@ export function Head() {
   `;
     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: "generator", content: `Sourcey ${pkg.version}` }), options.pageUrl && _jsx("link", { rel: "canonical", href: options.pageUrl }), _jsx("meta", { property: "og:title", content: pageTitle }), _jsx("meta", { property: "og:description", content: pageDescription }), _jsx("meta", { property: "og:type", content: "website" }), siteName && _jsx("meta", { property: "og:site_name", content: siteName }), options.pageUrl && _jsx("meta", { property: "og:url", content: options.pageUrl }), options.ogImageUrl && _jsx("meta", { property: "og:image", content: options.ogImageUrl }), options.ogImageUrl && _jsx("meta", { property: "og:image:width", content: "1200" }), options.ogImageUrl && _jsx("meta", { property: "og:image:height", content: "630" }), options.ogImageUrl && _jsx("meta", { property: "og:image:type", content: "image/png" }), _jsx("meta", { name: "twitter:card", content: options.ogImageUrl ? "summary_large_image" : "summary" }), _jsx("meta", { name: "twitter:title", content: pageTitle }), _jsx("meta", { name: "twitter:description", content: pageDescription }), options.ogImageUrl && _jsx("meta", { name: "twitter:image", content: options.ogImageUrl }), _jsx("meta", { name: "sourcey-search", content: `${options.assetBase}search-index.json` }), options.alternateLinks?.map((link) => (_jsx("link", { rel: "alternate", type: link.type, href: link.href, title: link.title }, `${link.type}-${link.href}`))), _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=${encodeURIComponent(fonts.googleFont)}:wght@100..900&display=swap` }), _jsx("style", { dangerouslySetInnerHTML: { __html: themeCSS } }), showLangIconCSS && _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')})()` } }), _jsx("link", { rel: "stylesheet", href: `${options.assetBase}sourcey.css` }), site.favicon && _jsx("link", { rel: "icon", href: site.favicon })] }));
 }
+function composePageTitle(title, siteName) {
+    if (!siteName)
+        return title;
+    if (!title)
+        return siteName;
+    return sameTitle(title, siteName) ? title : `${title} - ${siteName}`;
+}
+function sameTitle(left, right) {
+    return normalizeTitle(left) === normalizeTitle(right);
+}
+function normalizeTitle(value) {
+    return value.trim().replace(/\s+/g, " ").toLowerCase();
+}

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

@@ -1 +1 @@
-{"version":3,"file":"TableOfContents.d.ts","sourceRoot":"","sources":["../../../src/components/layout/TableOfContents.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAyCjE,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,WAAW,EAAE,CAAA;CAAE,uCAuBxE"}
+{"version":3,"file":"TableOfContents.d.ts","sourceRoot":"","sources":["../../../src/components/layout/TableOfContents.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AA2CjE,wBAAgB,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,WAAW,EAAE,CAAA;CAAE,uCAuBxE"}

package/dist/components/layout/TableOfContents.js

@@ -7,10 +7,12 @@ import { iconPath } from "../../utils/icons.js";
  */
 const tocLink = "toc-item break-words block hover:text-[rgb(var(--color-gray-900))] dark:hover:text-[rgb(var(--color-gray-300))] dark:text-[rgb(var(--color-gray-400))] transition-colors";
 function TocList({ headings }) {
-    // Group: each root heading (level 2) followed by its sub-headings (level 3+)
+    // Group by the shallowest heading present. Moxygen C++ pages often use
+    // h1 for the page title and h3 for sections, with no h2 in between.
+    const rootLevel = Math.min(...headings.map((h) => h.level));
     const groups = [];
     for (const h of headings) {
-        if (h.level < 3) {
+        if (h.level <= rootLevel) {
             groups.push({ root: h, children: [] });
         }
         else if (groups.length) {

package/dist/components/openapi/Introduction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Introduction.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Introduction.tsx"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,YAAY,iCAqC3B"}
+{"version":3,"file":"Introduction.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Introduction.tsx"],"names":[],"mappings":"AAKA;;;GAGG;AACH,wBAAgB,YAAY,iCAmE3B"}

package/dist/components/openapi/Introduction.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
 import { useContext } from "preact/hooks";
 import { SpecContext } from "../../renderer/context.js";
+import { safeUrl } from "../../utils/html.js";
 import { Markdown } from "../ui/Markdown.js";
 /**
  * API introduction: description, contact info, server URLs.
@@ -9,5 +10,19 @@ import { Markdown } from "../ui/Markdown.js";
 export function Introduction() {
     const spec = useContext(SpecContext);
     const { info, servers } = spec;
-    return (_jsxs("div", { id: "introduction", "data-traverse-target": "introduction", class: "mb-8", children: [info.termsOfService && (_jsx("p", { class: "mt-4 text-sm text-[rgb(var(--color-gray-500))]", children: _jsx("a", { href: info.termsOfService, class: "text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))]", children: "Terms of Service" }) })), info.contact?.email && (_jsxs("p", { class: "mt-2 text-sm text-[rgb(var(--color-gray-500))]", children: ["Contact: ", _jsx("a", { href: `mailto:${info.contact.email}`, class: "text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))]", children: info.contact.email })] })), servers.length > 0 && (_jsxs("div", { class: "mt-6 rounded-[var(--radius)] border border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)] overflow-x-auto", children: [_jsxs("div", { class: "px-4 py-2.5 text-xs font-semibold text-[rgb(var(--color-gray-600))] dark:text-[rgb(var(--color-gray-300))] border-b border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)]", children: ["Base URL", servers.length > 1 ? "s" : ""] }), servers.map((s, i) => (_jsxs("div", { class: `flex items-baseline gap-3 px-4 py-2 ${i > 0 ? "border-t border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))]" : ""}`, children: [_jsx("code", { class: "font-mono text-sm text-[rgb(var(--color-gray-800))] dark:text-[rgb(var(--color-gray-200))]", children: s.url }), s.description && (_jsx("span", { class: "text-xs text-[rgb(var(--color-gray-500))]", children: s.description }))] }, i)))] })), info.description && _jsx(Markdown, { content: info.description, class: "max-w-none mt-8" })] }));
+    const termsUrl = info.termsOfService
+        ? safeUrl(info.termsOfService, {
+            allowedProtocols: ["http:", "https:"],
+            allowRelative: false,
+            allowAnchor: false,
+        })
+        : null;
+    const contactEmailUrl = info.contact?.email
+        ? safeUrl(`mailto:${info.contact.email}`, {
+            allowedProtocols: ["mailto:"],
+            allowRelative: false,
+            allowAnchor: false,
+        })
+        : null;
+    return (_jsxs("div", { id: "introduction", "data-traverse-target": "introduction", class: "mb-8", children: [termsUrl && (_jsx("p", { class: "mt-4 text-sm text-[rgb(var(--color-gray-500))]", children: _jsx("a", { href: termsUrl, class: "text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))]", children: "Terms of Service" }) })), info.contact?.email && contactEmailUrl && (_jsxs("p", { class: "mt-2 text-sm text-[rgb(var(--color-gray-500))]", children: ["Contact:", " ", _jsx("a", { href: contactEmailUrl, class: "text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))]", children: info.contact.email })] })), servers.length > 0 && (_jsxs("div", { class: "mt-6 rounded-[var(--radius)] border border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)] overflow-x-auto", children: [_jsxs("div", { class: "px-4 py-2.5 text-xs font-semibold text-[rgb(var(--color-gray-600))] dark:text-[rgb(var(--color-gray-300))] border-b border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-border-dark-subtle)/0.1)]", children: ["Base URL", servers.length > 1 ? "s" : ""] }), servers.map((s, i) => (_jsxs("div", { class: `flex items-baseline gap-3 px-4 py-2 ${i > 0 ? "border-t border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))]" : ""}`, children: [_jsx("code", { class: "font-mono text-sm text-[rgb(var(--color-gray-800))] dark:text-[rgb(var(--color-gray-200))]", children: s.url }), s.description && (_jsx("span", { class: "text-xs text-[rgb(var(--color-gray-500))]", children: s.description }))] }, i)))] })), info.description && _jsx(Markdown, { content: info.description, class: "max-w-none mt-8" })] }));
 }