sourcey 3.6.5 → 3.6.6

package/README.md

@@ -32,7 +32,7 @@ npx sourcey init
 - **Rust and rustdoc**: native API documentation from nightly rustdoc JSON, with doctests as a first-class extracted view. URL-encoded parametric impl anchors for deep-link parity with doc.rust-lang.org. Snapshot mode lets CI build on stable Rust toolchains. Aggregated doctests index across the workspace
 - **Context exports**: auto-generate llms.txt and llms-full.txt alongside your HTML as alternate views of the same documentation graph
 - **TypeScript config**: `sourcey.config.ts` with `defineConfig()` autocomplete; theme, navbar, CTA buttons, footer
-- **Theme presets**: default (sidebar + TOC), minimal (single column), api-first (Stripe-style three column); colors, fonts, layout dimensions, and custom CSS on top
+- **Themes**: default (sidebar + TOC), minimal (single column), api-first (three column), and reader (editorial specification); colors, fonts, layout dimensions, and custom CSS on top
 - **Vite dev server**: SSR hot reload on every component and CSS change; spec and markdown changes trigger instant refresh
 - **Dark mode**: semantic design tokens, light/dark logo variants, localStorage persistence
 - **Client-side search**: instant fuzzy search across all pages and API operations; Cmd+K
@@ -177,11 +177,11 @@ Guides support rich components in standard markdown:
 
 ### Theme
 
-All visual configuration lives under `theme`. Colors, fonts, layout dimensions, and a preset that controls page structure:
+All visual configuration lives under `theme`. `theme.name` selects the complete renderer; colors, fonts, layout dimensions, and custom CSS apply on top:
 
 ```typescript
 theme: {
-  preset: "api-first",
+  name: "api-first",
   colors: { primary: "#f59e0b", light: "#fbbf24", dark: "#d97706" },
   fonts: { sans: "'Lexend', sans-serif", mono: "'Fira Code', monospace" },
   layout: { sidebar: "16rem", content: "48rem" },
@@ -189,7 +189,7 @@ theme: {
 }
 ```
 
-Presets control layout structure: `"default"` (sidebar + TOC), `"minimal"` (single centered column), `"api-first"` (three-column with persistent code panels). Everything else applies on top.
+Themes control the complete layout structure: `"default"` (sidebar + TOC), `"minimal"` (single centered column), `"api-first"` (three-column with persistent code panels), and `"reader"` (editorial specification reader). Shared brand settings apply on top. Theme-specific options are only interpreted by the selected theme.
 
 ## CLI
 

package/dist/adapters/shared.js

@@ -97,7 +97,7 @@ async function expandGlob(pattern, configDir) {
     }
     catch (err) {
         if (err.code === "ENOENT") {
-            throw new Error(`Glob directory not found: ${dir}`);
+            throw new Error(`Glob directory not found: ${dir}`, { cause: err });
         }
         throw err;
     }

package/dist/astro/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/astro/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/astro/index.ts"],"names":[],"mappings":"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"}

package/dist/astro/index.js

@@ -59,6 +59,7 @@ export default function sourceyAstro(options = {}) {
                     outputRoot: fileURLToPath(dir),
                     outputDir,
                     routeBase: preparedSourcey.routeBase,
+                    publicBase: preparedSourcey.config.baseUrl,
                 });
                 logger.info(`Sourcey: wrote ${sourceySite.pageCount} page${sourceySite.pageCount === 1 ? "" : "s"}`);
             },
@@ -149,15 +150,16 @@ function sourceyAstroDevPlugin(options) {
                     const err = error instanceof Error ? error : new Error(String(error));
                     server.ssrFixStacktrace(err);
                     logger.error(`Sourcey: ${err.message}`);
-                    server.ws.send({ type: "error", err: { message: err.message, stack: err.stack ?? "" } });
+                    server.ws.send({
+                        type: "error",
+                        err: { message: err.message, stack: err.stack ?? "" },
+                    });
                 });
             });
             server.middlewares.use(async (req, res, next) => {
                 const url = req.url ?? "/";
                 const pathname = url.split("?", 1)[0] ?? "/";
-                if (url.startsWith("/@") ||
-                    url.startsWith("/__vite") ||
-                    url.startsWith("/node_modules/")) {
+                if (url.startsWith("/@") || url.startsWith("/__vite") || url.startsWith("/node_modules/")) {
                     return next();
                 }
                 if (!requestPathMatchesBase(pathname, prepared.config.baseUrl)) {
@@ -244,7 +246,7 @@ async function writeAstroRouteAlias(options) {
     const aliasPath = resolve(options.outputRoot, `${route}.html`);
     const html = await readFile(indexPath, "utf-8");
     await mkdir(dirname(aliasPath), { recursive: true });
-    await writeFile(aliasPath, renderAstroRouteAlias(html, options.routeBase));
+    await writeFile(aliasPath, renderAstroRouteAlias(html, options.publicBase));
 }
 function renderAstroRouteAlias(html, routeBase) {
     const basePath = routeBase.endsWith("/") ? routeBase : `${routeBase}/`;
@@ -272,7 +274,7 @@ function phaseEnabled(phase, defaultEnabled) {
     return phase?.enabled ?? defaultEnabled;
 }
 function phaseGenerateOgImages(phase, defaultEnabled) {
-    return typeof phase === "object" ? phase.generateOgImages ?? defaultEnabled : defaultEnabled;
+    return typeof phase === "object" ? (phase.generateOgImages ?? defaultEnabled) : defaultEnabled;
 }
 function shouldRebuildForChange(file, watchPaths) {
     if (watchPaths.includes(file))

package/dist/client/reader-controls.js

@@ -0,0 +1,81 @@
+(function () {
+  var root = document.querySelector(".sourcey-reader");
+  if (!root) return;
+  root.querySelectorAll("[data-reader-enhancement]").forEach(function (el) {
+    el.hidden = false;
+  });
+  root.querySelectorAll("[data-reader-fallback]").forEach(function (el) {
+    el.hidden = true;
+  });
+  var toggle = root.querySelector(".menu-toggle");
+  var menu = root.querySelector("#reader-mobile-nav");
+  function closeMenu() {
+    menu.hidden = true;
+    toggle.setAttribute("aria-expanded", "false");
+    toggle.setAttribute("aria-label", "Open navigation");
+  }
+  toggle.addEventListener("click", function () {
+    var open = toggle.getAttribute("aria-expanded") !== "true";
+    menu.hidden = !open;
+    toggle.setAttribute("aria-expanded", String(open));
+    toggle.setAttribute("aria-label", open ? "Close navigation" : "Open navigation");
+  });
+  window.matchMedia("(min-width: 901px)").addEventListener("change", function (event) {
+    if (event.matches) closeMenu();
+  });
+  document.addEventListener("keydown", function (event) {
+    if (event.key === "Escape" && !menu.hidden) {
+      closeMenu();
+      toggle.focus();
+    }
+    var search = root.querySelector("a.search-link");
+    if (
+      search &&
+      event.key === "/" &&
+      !event.metaKey &&
+      !event.ctrlKey &&
+      !event.altKey &&
+      !event.target.closest("input, textarea, select, [contenteditable]")
+    ) {
+      event.preventDefault();
+      window.location.href = search.href;
+    }
+  });
+  var select = root.querySelector("#chapter-select");
+  select.addEventListener("change", function () {
+    window.location.href = select.value;
+  });
+  var copy = root.querySelector("[data-copy-page]");
+  if (copy)
+    copy.addEventListener("click", async function () {
+      var label = copy.querySelector("span");
+      try {
+        await navigator.clipboard.writeText(window.location.href);
+        label.textContent = "Copied";
+      } catch {
+        label.textContent = "Copy the address bar URL";
+      }
+      setTimeout(function () {
+        label.textContent = "Copy link";
+      }, 2500);
+    });
+  var links = Array.from(root.querySelectorAll(".docs-toc nav a"));
+  if ("IntersectionObserver" in window) {
+    var observer = new window.IntersectionObserver(
+      function (entries) {
+        var active = entries.find(function (entry) {
+          return entry.isIntersecting;
+        });
+        if (!active) return;
+        links.forEach(function (link) {
+          if (link.hash === "#" + active.target.id) link.setAttribute("aria-current", "location");
+          else link.removeAttribute("aria-current");
+        });
+      },
+      { rootMargin: "-100px 0px -65% 0px" },
+    );
+    root.querySelectorAll(".reader-prose h2, .reader-prose h3").forEach(function (heading) {
+      observer.observe(heading);
+    });
+  }
+})();

package/dist/client/reader.d.ts

@@ -0,0 +1,5 @@
+import "../themes/default/main.css";
+import "./tabs.js";
+import "./search.js";
+import "./reader-controls.js";
+//# sourceMappingURL=reader.d.ts.map

package/dist/client/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../../src/client/reader.ts"],"names":[],"mappings":"AACA,OAAO,4BAA4B,CAAC;AACpC,OAAO,WAAW,CAAC;AACnB,OAAO,aAAa,CAAC;AACrB,OAAO,sBAAsB,CAAC"}

package/dist/client/reader.js

@@ -0,0 +1,5 @@
+// Shared content primitives, with the reader's own progressive enhancements.
+import "../themes/default/main.css";
+import "./tabs.js";
+import "./search.js";
+import "./reader-controls.js";

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;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"}
+{"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,gCAwB7E"}

package/dist/components/App.js

@@ -7,6 +7,6 @@ import { Page } from "./layout/Page.js";
  * When embeddable, renders just the page content without html/body wrapper.
  */
 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 })] })] }));
+    const content = options.embeddable ? (_jsx(Page, {})) : (_jsxs("html", { lang: "en", children: [_jsx(Head, {}), _jsxs("body", { id: "sourcey", "data-sourcey-theme": site.theme.name, children: [_jsx(Page, {}), _jsx("script", { src: `${options.assetBase}sourcey.js`, defer: true })] })] }));
     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 }) }) }) }) }));
 }

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":"AAKA,wBAAgB,IAAI,iCA+FnB"}
+{"version":3,"file":"Head.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Head.tsx"],"names":[],"mappings":"AAWA,wBAAgB,IAAI,iCA4HnB"}

package/dist/components/layout/Head.js

@@ -1,6 +1,6 @@
-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, SiteContext, NavigationContext } from "../../renderer/context.js";
+import { SpecContext, OptionsContext, PageContext, SiteContext, NavigationContext, } from "../../renderer/context.js";
 import { langIconCSS } from "../../utils/lang-icons.js";
 import pkg from "../../../package.json" with { type: "json" };
 export function Head() {
@@ -27,7 +27,7 @@ export function Head() {
         ? page.markdown.description || pageTitle
         : page.kind === "changelog"
             ? changelogVersion?.summary || page.changelog.description || pageTitle
-            : spec.info.summary ?? spec.info.description ?? `${siteName} API Documentation`;
+            : (spec.info.summary ?? spec.info.description ?? `${siteName} API Documentation`);
     const nav = useContext(NavigationContext);
     const { colors, fonts, layout } = site.theme;
     // Desktop: h-16 row + h-12 tabs (when multi-tab) = 7rem, or h-16 alone = 4rem.
@@ -57,7 +57,9 @@ export function Head() {
     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: "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 })] }));
+    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}`))), fonts.googleFont && (_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: `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.theme.name !== "reader" && site.customCSS && (_jsx("style", { dangerouslySetInnerHTML: { __html: site.customCSS } })), site.theme.name !== "reader" && (_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.theme.name === "reader" && site.customCSS && (_jsx("style", { dangerouslySetInnerHTML: { __html: site.customCSS } })), site.favicon && _jsx("link", { rel: "icon", href: site.favicon })] }));
 }
 function composePageTitle(title, siteName, separator) {
     if (!siteName)

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

@@ -1 +1 @@
-{"version":3,"file":"Page.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Page.tsx"],"names":[],"mappings":"AAuRA,wBAAgB,IAAI,iCAqCnB"}
+{"version":3,"file":"Page.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Page.tsx"],"names":[],"mappings":"AAuXA,wBAAgB,IAAI,iCA+BnB"}

package/dist/components/layout/Page.js

@@ -1,6 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "preact/jsx-runtime";
+import { ReaderPage } from "./Reader.js";
+import { SearchDialog } from "./SearchDialog.js";
 import { useContext } from "preact/hooks";
-import { SpecContext, PageContext, NavigationContext, OptionsContext, SiteContext } from "../../renderer/context.js";
+import { SpecContext, PageContext, NavigationContext, OptionsContext, SiteContext, } from "../../renderer/context.js";
 import { Markdown } from "../ui/Markdown.js";
 import { Header } from "./Header.js";
 import { Sidebar } from "./Sidebar.js";
@@ -23,7 +25,7 @@ function MarkdownPageContent({ page, className = "" }) {
     const eyebrow = activeGroup?.label;
     return (_jsxs("div", { class: `relative grow box-border flex-col w-full mx-auto px-1 min-w-0 ${className}`, id: "content-area", children: [_jsxs("header", { class: "relative leading-none", children: [_jsxs("div", { class: "mt-0.5 space-y-2.5", children: [eyebrow && (_jsx("div", { class: "h-5 text-[rgb(var(--color-primary-ink))] dark:text-[rgb(var(--color-primary-light))] text-sm font-semibold", children: eyebrow })), _jsx("div", { class: "flex flex-col sm:flex-row items-start sm:items-center relative gap-2 min-w-0", children: _jsx("h1", { class: "text-2xl sm:text-3xl text-[rgb(var(--color-gray-900))] tracking-tight dark:text-[rgb(var(--color-gray-200))] font-bold", style: "overflow-wrap: anywhere", children: page.title }) })] }), page.description && (_jsx("div", { class: "page-description mt-2 text-lg prose prose-gray dark:prose-invert", style: "overflow-wrap: anywhere", children: _jsx(Markdown, { content: page.description, inline: true }) }))] }), _jsx("div", { class: "prose prose-gray dark:prose-invert relative mt-8 mb-14 max-w-none", dangerouslySetInnerHTML: { __html: page.html } }), _jsx(PageNavigation, {}), _jsx(ContentFooter, {})] }));
 }
-function ChangelogPageContent({ page, className = "" }) {
+function ChangelogPageContent({ page, className = "", }) {
     return (_jsxs("div", { class: `relative grow box-border flex-col w-full mx-auto px-1 min-w-0 ${className}`, id: "content-area", children: [_jsx(ChangelogPage, { page: page }), _jsx(PageNavigation, {}), _jsx(ContentFooter, {})] }));
 }
 /**
@@ -53,7 +55,7 @@ function PageNavigation() {
     const labelClass = "text-xs text-[rgb(var(--color-gray-500))] dark:text-[rgb(var(--color-gray-400))]";
     const titleClass = "text-sm font-medium text-[rgb(var(--color-gray-700))] dark:text-[rgb(var(--color-gray-300))] group-hover:text-[rgb(var(--color-primary-ink))] dark:group-hover:text-[rgb(var(--color-primary-light))] transition-colors";
     const base = options.assetBase;
-    return (_jsxs("nav", { class: "mt-12 flex items-stretch justify-between gap-4", children: [prev ? (_jsxs("a", { href: `${base}${prev.href}`, class: linkClass, children: [_jsx("span", { class: labelClass, children: "\u2190 Previous" }), _jsx("span", { class: titleClass, children: prev.label })] })) : _jsx("span", {}), next ? (_jsxs("a", { href: `${base}${next.href}`, class: `${linkClass} text-right ml-auto`, children: [_jsx("span", { class: labelClass, children: "Next \u2192" }), _jsx("span", { class: titleClass, children: next.label })] })) : null] }));
+    return (_jsxs("nav", { class: "mt-12 flex items-stretch justify-between gap-4", children: [prev ? (_jsxs("a", { href: `${base}${prev.href}`, class: linkClass, children: [_jsx("span", { class: labelClass, children: "\u2190 Previous" }), _jsx("span", { class: titleClass, children: prev.label })] })) : (_jsx("span", {})), next ? (_jsxs("a", { href: `${base}${next.href}`, class: `${linkClass} text-right ml-auto`, children: [_jsx("span", { class: labelClass, children: "Next \u2192" }), _jsx("span", { class: titleClass, children: next.label })] })) : null] }));
 }
 function ContentFooter() {
     const site = useContext(SiteContext);
@@ -62,9 +64,13 @@ function ContentFooter() {
     // Build "Edit this page" URL when repo + editBranch are configured
     let editUrl;
     const editPath = page.kind === "markdown"
-        ? (page.markdown.editPath === undefined ? page.markdown.sourcePath : page.markdown.editPath)
+        ? page.markdown.editPath === undefined
+            ? page.markdown.sourcePath
+            : page.markdown.editPath
         : page.kind === "changelog"
-            ? (page.changelog.editPath === undefined ? page.changelog.sourcePath : page.changelog.editPath)
+            ? page.changelog.editPath === undefined
+                ? page.changelog.sourcePath
+                : page.changelog.editPath
             : undefined;
     if (site.repo && site.editBranch && editPath) {
         const repoBase = site.repo.replace(/\/$/, "");
@@ -75,12 +81,10 @@ function ContentFooter() {
         editUrl = `${repoBase}/edit/${site.editBranch}/${basePath}${editPath}`;
     }
     const linkStyle = "hover:text-[rgb(var(--color-gray-600))] dark:hover:text-[rgb(var(--color-gray-300))] transition-colors";
-    return (_jsxs("div", { class: "mt-16 mb-8 flex items-center justify-between border-t border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-gray-800)/0.5)] pt-6 text-xs text-[rgb(var(--color-gray-500))] dark:text-[rgb(var(--color-gray-400))]", children: [_jsxs("a", { href: "https://sourcey.com", target: "_blank", rel: "noopener noreferrer", class: `flex items-center gap-1.5 ${linkStyle}`, children: ["Built with", _jsx("img", { src: "https://sourcey.com/sourcey-logo.png", alt: "Sourcey", class: "h-4 w-4" })] }), _jsxs("div", { class: "flex items-center gap-4", children: [editUrl && (_jsxs("a", { href: editUrl, target: "_blank", rel: "noopener noreferrer", class: `${linkStyle} flex items-center gap-1`, children: [_jsx("svg", { xmlns: "http://www.w3.org/2000/svg", fill: "none", viewBox: "0 0 24 24", "stroke-width": "1.5", stroke: "currentColor", class: "w-3 h-3 mr-0.5", children: _jsx("path", { "stroke-linecap": "round", "stroke-linejoin": "round", d: "m16.862 4.487 1.687-1.688a1.875 1.875 0 1 1 2.652 2.652L6.832 19.82a4.5 4.5 0 0 1-1.897 1.13l-2.685.8.8-2.685a4.5 4.5 0 0 1 1.13-1.897L16.863 4.487Zm0 0L19.5 7.125" }) }), "Edit this page"] })), links.map((link) => (_jsx("a", { href: link.href, target: "_blank", rel: "noopener noreferrer", "aria-label": link.label ?? socialLabels[link.type] ?? link.href, class: linkStyle, children: link.type === "link"
-                            ? (link.label ?? link.href)
-                            : (_jsxs(_Fragment, { children: [_jsx(SocialIcon, { type: link.type }), link.label && _jsx("span", { class: "ml-1", children: link.label })] })) }, link.href)))] })] }));
+    return (_jsxs("div", { class: "mt-16 mb-8 flex items-center justify-between border-t border-[rgb(var(--color-gray-200)/0.7)] dark:border-[rgb(var(--color-gray-800)/0.5)] pt-6 text-xs text-[rgb(var(--color-gray-500))] dark:text-[rgb(var(--color-gray-400))]", children: [_jsxs("span", { children: ["Docs by", " ", _jsx("a", { href: "https://sourcey.com", target: "_blank", rel: "noopener noreferrer", class: linkStyle, children: "Sourcey" })] }), _jsxs("div", { class: "flex items-center gap-4", children: [editUrl && (_jsxs("a", { href: editUrl, target: "_blank", rel: "noopener noreferrer", class: `${linkStyle} flex items-center gap-1`, children: [_jsx("svg", { xmlns: "http://www.w3.org/2000/svg", fill: "none", viewBox: "0 0 24 24", "stroke-width": "1.5", stroke: "currentColor", class: "w-3 h-3 mr-0.5", children: _jsx("path", { "stroke-linecap": "round", "stroke-linejoin": "round", d: "m16.862 4.487 1.687-1.688a1.875 1.875 0 1 1 2.652 2.652L6.832 19.82a4.5 4.5 0 0 1-1.897 1.13l-2.685.8.8-2.685a4.5 4.5 0 0 1 1.13-1.897L16.863 4.487Zm0 0L19.5 7.125" }) }), "Edit this page"] })), links.map((link) => (_jsx("a", { href: link.href, target: "_blank", rel: "noopener noreferrer", "aria-label": link.label ?? socialLabels[link.type] ?? link.href, class: linkStyle, children: link.type === "link" ? ((link.label ?? link.href)) : (_jsxs(_Fragment, { children: [_jsx(SocialIcon, { type: link.type }), link.label && _jsx("span", { class: "ml-1", children: link.label })] })) }, link.href)))] })] }));
 }
 // ---------------------------------------------------------------------------
-// Layout presets
+// Built-in theme layouts
 // ---------------------------------------------------------------------------
 function DefaultLayout() {
     const page = useContext(PageContext);
@@ -99,9 +103,11 @@ function ApiFirstLayout() {
 // ---------------------------------------------------------------------------
 export function Page() {
     const site = useContext(SiteContext);
-    const preset = site.theme.preset;
-    const Layout = preset === "minimal" ? MinimalLayout
-        : preset === "api-first" ? ApiFirstLayout
-            : DefaultLayout;
-    return (_jsxs("div", { id: "page", class: "relative antialiased text-[rgb(var(--color-gray-500))] dark:text-[rgb(var(--color-gray-400))]", children: [_jsx(Header, {}), _jsx("span", { class: "fixed inset-0 bg-[rgb(var(--color-background-light))] dark:bg-[rgb(var(--color-background-dark))] -z-10 pointer-events-none" }), _jsx(Layout, {}), _jsx("div", { id: "search-dialog", role: "dialog", "aria-label": "Search", children: _jsxs("div", { class: "search-dialog-inner", children: [_jsxs("div", { class: "search-input-row", children: [_jsx("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 20 20", fill: "currentColor", class: "search-input-icon", children: _jsx("path", { "fill-rule": "evenodd", d: "M9 3.5a5.5 5.5 0 1 0 0 11 5.5 5.5 0 0 0 0-11ZM2 9a7 7 0 1 1 12.452 4.391l3.328 3.329a.75.75 0 1 1-1.06 1.06l-3.329-3.328A7 7 0 0 1 2 9Z", "clip-rule": "evenodd" }) }), _jsx("input", { id: "search-input", type: "text", placeholder: "Search docs...", autocomplete: "off", spellcheck: false })] }), _jsx("div", { id: "search-results" }), _jsxs("div", { class: "search-footer", children: [_jsxs("span", { class: "search-footer-hint", children: [_jsx("kbd", { children: "\u2191\u2193" }), " navigate"] }), _jsxs("span", { class: "search-footer-hint", children: [_jsx("kbd", { children: "\u21B5" }), " select"] }), _jsxs("span", { class: "search-footer-hint", children: [_jsx("kbd", { children: "esc" }), " close"] })] })] }) })] }));
+    const theme = site.theme.name;
+    const page = useContext(PageContext);
+    if (theme === "reader") {
+        return (_jsx(ReaderPage, { children: page.kind === "spec" ? (_jsx(SpecPageContent, {})) : page.kind === "changelog" ? (_jsx(ChangelogPageContent, { page: page.changelog })) : null }));
+    }
+    const Layout = theme === "minimal" ? MinimalLayout : theme === "api-first" ? ApiFirstLayout : DefaultLayout;
+    return (_jsxs("div", { id: "page", class: "relative antialiased text-[rgb(var(--color-gray-500))] dark:text-[rgb(var(--color-gray-400))]", children: [_jsx(Header, {}), _jsx("span", { class: "fixed inset-0 bg-[rgb(var(--color-background-light))] dark:bg-[rgb(var(--color-background-dark))] -z-10 pointer-events-none" }), _jsx(Layout, {}), _jsx(SearchDialog, {})] }));
 }

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

@@ -0,0 +1,5 @@
+import type { ComponentChildren } from "preact";
+export declare function ReaderPage({ children }: {
+    children?: ComponentChildren;
+}): import("preact").JSX.Element;
+//# sourceMappingURL=Reader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Reader.d.ts","sourceRoot":"","sources":["../../../src/components/layout/Reader.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AA0DhD,wBAAgB,UAAU,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAAE,gCAiUxE"}

package/dist/components/layout/Reader.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "preact/jsx-runtime";
+import { useContext } from "preact/hooks";
+import { NavigationContext, OptionsContext, PageContext, SiteContext, } from "../../renderer/context.js";
+import { SearchDialog } from "./SearchDialog.js";
+import { safeUrl } from "../../utils/html.js";
+function Icon({ name = "arrow", size = 20 }) {
+    const paths = {
+        arrow: ["M4 12h15m-6-6 6 6-6 6"],
+        chevron: ["m9 5 7 7-7 7"],
+        northeast: ["M6 18 18 6M6 6h12v12"],
+        menu: ["M4 7h16M4 12h16M4 17h16"],
+        search: ["m21 21-5-5", "M18 10a8 8 0 1 1-16 0 8 8 0 0 1 16 0"],
+        layers: ["m12 3 10 6-10 6L2 9l10-6Zm-10 10 10 6 10-6m-20 4 10 6 10-6"],
+        copy: ["M9 9h12v12H9zM15 5V2H2v13h3"],
+        code: ["m8 6-6 6 6 6m8-12 6 6-6 6m-3-15-2 18"],
+    };
+    return (_jsx("svg", { width: size, height: size, viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", "stroke-width": "1.5", "stroke-linecap": "round", "stroke-linejoin": "round", "aria-hidden": "true", children: (paths[name] ?? paths.arrow).map((path) => (_jsx("path", { d: path }))) }));
+}
+function Link({ link, children, className, }) {
+    return (_jsx("a", { href: safeUrl(link.href) ?? undefined, class: className, children: children ?? link.label }));
+}
+export function ReaderPage({ children }) {
+    const site = useContext(SiteContext);
+    const nav = useContext(NavigationContext);
+    const page = useContext(PageContext);
+    const { assetBase: base } = useContext(OptionsContext);
+    const settings = site.theme.reader ?? {};
+    const document = settings.document;
+    const tab = nav.tabs.find((item) => item.slug === nav.activeTabSlug);
+    const items = tab?.groups.flatMap((group) => group.items) ?? [];
+    const index = items.findIndex((item) => item.id === nav.activePageSlug);
+    const previous = items[index - 1];
+    const next = items[index + 1];
+    const label = document?.label ?? tab?.label ?? site.name;
+    const edition = [label, document?.version].filter(Boolean).join(" ");
+    const href = (path) => `${base}${path}` || "./";
+    const activeHref = href(items[index]?.href ?? tab?.href ?? "");
+    const home = safeUrl(site.logo?.href ?? href(nav.tabs[0]?.href ?? "")) ?? "/";
+    const searchHref = settings.searchHref ? safeUrl(settings.searchHref) : null;
+    const before = previous
+        ? { label: previous.label, href: href(previous.href), description: "← Previous" }
+        : settings.pagination?.before;
+    const after = next
+        ? { label: next.label, href: href(next.href), description: "Next →" }
+        : settings.pagination?.after;
+    const isCurrent = (target) => {
+        if (target.startsWith("/") && site.baseUrl)
+            return site.baseUrl.startsWith(target);
+        return target === activeHref;
+    };
+    const navigationLinks = site.navbar.links.map((link) => ({
+        ...link,
+        label: link.label ?? link.type,
+    }));
+    const docPage = page.kind === "markdown" ? page.markdown : null;
+    const headings = docPage?.headings ?? (page.kind === "changelog" ? page.changelog.headings : []);
+    return (_jsxs("div", { class: "sourcey-reader", id: "page", children: [_jsx("a", { class: "skip-link", href: "#main", children: "Skip to content" }), _jsxs("header", { class: "site-header", children: [_jsxs("div", { class: "header-inner", children: [_jsx("a", { class: "home-link", href: home, "aria-label": `${site.name} home`, children: _jsxs("span", { class: "brand", children: [site.logo?.light && (_jsx("img", { class: settings.logoMark ? "brand-mark" : "brand-logo", src: site.logo.light, alt: settings.logoMark ? "" : site.name })), (!site.logo?.light || settings.logoMark) && _jsx("span", { children: site.name })] }) }), _jsx("nav", { class: "desktop-nav", "aria-label": "Main navigation", children: navigationLinks.map((link) => (_jsx("a", { href: safeUrl(link.href) ?? undefined, "aria-current": isCurrent(link.href) ? "page" : undefined, children: link.label }, link.href))) }), _jsxs("div", { class: "header-actions", children: [searchHref ? (_jsxs("a", { class: "search-link", href: searchHref, "aria-label": "Search documentation", children: [_jsx(Icon, { name: "search", size: 17 }), _jsx("span", { children: "Search" }), _jsx("kbd", { children: "/" })] })) : (_jsxs("button", { class: "search-link", id: "search-open", "aria-label": "Search documentation", "data-reader-enhancement": true, hidden: true, children: [_jsx(Icon, { name: "search", size: 17 }), _jsx("span", { children: "Search" }), _jsx("kbd", { children: "/" })] })), site.navbar.primary && (_jsxs("a", { class: "header-cta", href: safeUrl(site.navbar.primary.href) ?? undefined, children: [site.navbar.primary.label, _jsx(Icon, { size: 15 })] })), _jsx("button", { class: "menu-toggle", "aria-label": "Open navigation", "aria-controls": "reader-mobile-nav", "aria-expanded": "false", "data-reader-enhancement": true, hidden: true, children: _jsx(Icon, { name: "menu" }) })] })] }), _jsxs("nav", { id: "reader-mobile-nav", "aria-label": "Mobile navigation", hidden: true, children: [navigationLinks.map((link) => (_jsxs(Link, { link: link, children: [link.label, _jsx(Icon, {})] }, link.href))), searchHref && (_jsxs("a", { href: searchHref, children: ["Search documentation", _jsx(Icon, { name: "search" })] }))] }), _jsx("nav", { class: "reader-mobile-fallback", "aria-label": "Site links", "data-reader-fallback": true, children: navigationLinks.map((link) => (_jsx(Link, { link: link }, link.href))) })] }), _jsxs("div", { class: "docs-shell", children: [_jsxs("aside", { class: "docs-sidebar", "aria-label": `${tab?.label ?? "Documentation"} navigation`, children: [_jsxs("div", { class: "docs-project", children: [_jsxs("a", { class: `docs-map${document ? "" : " docs-project-title"}`, href: href(tab?.href ?? ""), children: [_jsx("strong", { class: "docs-map-label", children: label }), document?.title && _jsx("span", { class: "docs-map-title", children: document.title })] }), (document?.version || document?.status) && (_jsxs("span", { class: "docs-version", children: [_jsx("span", { class: "small-dot" }), [document.version, document.status?.toLowerCase()].filter(Boolean).join(" ")] }))] }), nav.tabs.length > 1 && (_jsx("nav", { class: "reader-tabs", "aria-label": "Documentation sections", children: nav.tabs.map((item) => (_jsx("a", { href: href(item.href), "aria-current": item.slug === nav.activeTabSlug ? "page" : undefined, children: item.label }))) })), _jsx("nav", { "aria-label": "Chapters", children: tab?.groups.map((group) => (_jsxs(_Fragment, { children: [group.href ? (_jsx("a", { class: "nav-section", href: href(group.href), children: group.label })) : (_jsx("span", { class: "nav-section", children: group.label })), group.items.map((item) => (_jsxs("a", { href: href(item.href), "aria-current": item.id === nav.activePageSlug ? "page" : undefined, children: [_jsx("span", { children: item.label }), item.id === nav.activePageSlug && _jsx("span", { class: "active-nav-dot" })] })))] }))) }), (settings.sidebar?.links?.length || settings.sidebar?.note) && (_jsxs("div", { class: "docs-sidebar-bottom", children: [settings.sidebar.links?.map((link) => (_jsxs(Link, { link: link, children: [link.icon && _jsx(Icon, { name: link.icon, size: 16 }), link.label, _jsx(Icon, { name: "northeast", size: 13 })] }, link.href))), settings.sidebar.note && _jsx("p", { children: settings.sidebar.note })] }))] }), _jsxs("div", { class: "mobile-doc-nav", children: [_jsx("label", { for: "chapter-select", children: edition }), _jsx("select", { id: "chapter-select", "aria-label": `${tab?.label ?? "Documentation"} chapter`, "data-reader-enhancement": true, hidden: true, children: nav.tabs.map((section) => (_jsx("optgroup", { label: section.label, children: section.groups
+                                        .flatMap((group) => group.items)
+                                        .map((item) => (_jsx("option", { value: href(item.href), selected: section.slug === nav.activeTabSlug && item.id === nav.activePageSlug, children: item.label }))) }))) }), _jsxs("details", { class: "reader-chapter-fallback", "data-reader-fallback": true, children: [_jsx("summary", { children: "Chapters" }), _jsx("nav", { children: nav.tabs.map((section) => (_jsxs(_Fragment, { children: [nav.tabs.length > 1 && _jsx("strong", { children: section.label }), section.groups
+                                                    .flatMap((group) => group.items)
+                                                    .map((item) => (_jsx("a", { href: href(item.href), children: item.label })))] }))) })] })] }), _jsx("main", { id: "main", class: "docs-main", children: docPage ? (_jsxs(_Fragment, { children: [_jsxs("div", { class: "doc-breadcrumb", children: [_jsx("span", { children: tab?.label }), _jsx(Icon, { name: "chevron", size: 12 }), _jsx("span", { children: edition }), document?.status && (_jsx("span", { class: "pill soft", children: document.badge ?? document.status }))] }), _jsxs("header", { class: "doc-title", children: [_jsx("h1", { children: docPage.title }), docPage.description && _jsx("p", { children: docPage.description })] }), _jsxs("div", { class: "doc-metadata", children: [document?.status && _jsx("span", { children: document.status }), document?.updated && _jsx("span", { children: document.updated }), _jsxs("button", { "data-copy-page": true, "data-reader-enhancement": true, hidden: true, children: [_jsx(Icon, { name: "copy", size: 12 }), _jsx("span", { "aria-live": "polite", children: "Copy link" })] })] }), _jsx("article", { class: "reader-prose", dangerouslySetInnerHTML: { __html: docPage.html } }), (before || after) && (_jsxs("nav", { class: "doc-pagination", "aria-label": "Previous and next chapter", children: [before ? (_jsxs(Link, { link: before, children: [_jsx("span", { children: before.description }), _jsx("strong", { children: before.label })] })) : (_jsx("span", {})), after && (_jsxs(Link, { link: after, children: [_jsx("span", { children: after.description }), _jsx("strong", { children: after.label })] }))] })), _jsxs("footer", { class: "doc-footer", children: [_jsx("span", { children: settings.footer?.text ?? site.name }), _jsxs("span", { class: "doc-footer-links", children: [settings.footer?.links?.map((link) => (_jsxs(Link, { link: link, children: [link.label, _jsx(Icon, { name: "northeast", size: 12 })] }, link.href))), _jsxs("span", { class: "sourcey-attribution", children: ["Docs by", " ", _jsxs("a", { href: "https://sourcey.com", target: "_blank", rel: "noopener noreferrer", children: ["Sourcey", _jsx(Icon, { name: "northeast", size: 12 })] })] })] })] })] })) : (children) }), _jsxs("aside", { class: "docs-toc", "aria-label": "On this page", children: [headings.length > 0 && (_jsxs(_Fragment, { children: [_jsx("span", { class: "eyebrow", children: "On this page" }), _jsx("nav", { children: headings
+                                            .filter((heading) => heading.level === Math.min(...headings.map((h) => h.level)))
+                                            .map((heading) => (_jsx("a", { href: `#${heading.id}`, children: heading.text }))) })] })), settings.aside?.links?.map((link) => (_jsxs(Link, { className: "toc-example", link: link, children: [link.icon && _jsx(Icon, { name: link.icon, size: 19 }), link.description && _jsx("strong", { children: link.description }), _jsxs("span", { children: [link.label, _jsx(Icon, { size: 12 })] })] }, link.href)))] })] }), !searchHref && _jsx(SearchDialog, {})] }));
+}

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

@@ -0,0 +1,2 @@
+export declare function SearchDialog(): import("preact").JSX.Element;
+//# sourceMappingURL=SearchDialog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SearchDialog.d.ts","sourceRoot":"","sources":["../../../src/components/layout/SearchDialog.tsx"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,iCAyC3B"}

package/dist/components/layout/SearchDialog.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx, jsxs as _jsxs } from "preact/jsx-runtime";
+export function SearchDialog() {
+    return (_jsx("div", { id: "search-dialog", role: "dialog", "aria-label": "Search", children: _jsxs("div", { class: "search-dialog-inner", children: [_jsxs("div", { class: "search-input-row", children: [_jsx("svg", { xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 20 20", fill: "currentColor", class: "search-input-icon", children: _jsx("path", { "fill-rule": "evenodd", d: "M9 3.5a5.5 5.5 0 1 0 0 11 5.5 5.5 0 0 0 0-11ZM2 9a7 7 0 1 1 12.452 4.391l3.328 3.329a.75.75 0 1 1-1.06 1.06l-3.329-3.328A7 7 0 0 1 2 9Z", "clip-rule": "evenodd" }) }), _jsx("input", { id: "search-input", "aria-label": "Search documentation", type: "text", placeholder: "Search docs...", autocomplete: "off", spellcheck: false })] }), _jsx("div", { id: "search-results" }), _jsxs("div", { class: "search-footer", children: [_jsxs("span", { class: "search-footer-hint", children: [_jsx("kbd", { children: "\u2191\u2193" }), " navigate"] }), _jsxs("span", { class: "search-footer-hint", children: [_jsx("kbd", { children: "\u21B5" }), " select"] }), _jsxs("span", { class: "search-footer-hint", children: [_jsx("kbd", { children: "esc" }), " close"] })] })] }) }));
+}

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

@@ -1 +1 @@
-{"version":3,"file":"Operation.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Operation.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAyB,MAAM,qBAAqB,CAAC;AAgBtF,UAAU,cAAc;IACtB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,cAAc,gCA0FrE"}
+{"version":3,"file":"Operation.d.ts","sourceRoot":"","sources":["../../../src/components/openapi/Operation.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAyB,MAAM,qBAAqB,CAAC;AAgBtF,UAAU,cAAc;IACtB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,cAAc,gCAuGrE"}

package/dist/components/openapi/Operation.js

@@ -21,12 +21,12 @@ import { McpReturnsCopy, McpReturnsExample } from "../mcp/McpReturns.js";
  */
 export function Operation({ operation: op, serverUrl }) {
     const site = useContext(SiteContext);
-    const apiFirst = site.theme.preset === "api-first";
+    const apiFirst = site.theme.name === "api-first";
     const id = `operation-${htmlId(op.path)}-${htmlId(op.method)}`;
     const hasParams = op.parameters.length > 0;
     const hasBody = !!op.requestBody;
     const mcp = op.mcpExtras;
-    return (_jsxs("div", { id: id, class: "py-8 border-t border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))]", "data-traverse-target": id, children: [_jsx("header", { class: "mb-6", children: op.summary && (_jsxs("div", { class: "flex items-baseline gap-2 flex-wrap", children: [_jsx("h2", { class: "text-2xl sm:text-3xl text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))] tracking-tight font-bold mb-2", children: _jsx(Markdown, { content: op.summary, inline: true }) }), op.deprecated && _jsx(DeprecatedBadge, {}), mcp?.annotations && _jsx(AnnotationBadges, { annotations: mcp.annotations })] })) }), mcp ? (_jsx(McpEndpointBar, { method: op.method, path: op.path })) : (_jsx(EndpointBar, { method: op.method, path: op.path, serverUrl: serverUrl })), _jsxs("div", { class: `flex flex-col ${apiFirst ? "lg:flex-row" : "xl:flex-row"} gap-8`, children: [_jsxs("div", { class: "flex-1 min-w-0", children: [op.description && (_jsx(Markdown, { content: op.description, class: "mb-6 max-w-none" })), hasBody && (_jsxs("div", { class: "mt-6", children: [_jsx(SectionLabel, { meta: bodyMediaType(op.requestBody), children: "Body" }), _jsx(RequestBody, { body: op.requestBody })] })), hasParams && (_jsxs("div", { class: "mt-6", children: [_jsx(SectionLabel, { children: "Parameters" }), _jsx(Parameters, { parameters: op.parameters })] })), mcp ? (_jsx(McpReturnsCopy, { schema: mcp.outputSchema })) : (op.responses.length > 0 && (_jsxs("div", { class: "mt-6", children: [_jsx(SectionLabel, { children: "Response" }), _jsx(ResponsesCopy, { responses: op.responses })] }))), !mcp && _jsx(SecurityCopy, { security: op.security })] }), _jsxs("aside", { class: `hidden ${apiFirst ? "lg:block" : "xl:block"} w-[28rem] shrink-0 sticky self-start overflow-y-auto space-y-4`, style: "top: calc(var(--header-height) + 2.5rem); max-height: calc(100vh - var(--header-height) - 5rem)", children: [_jsx(CodeSamplesExamples, { operation: op, serverUrl: serverUrl, codeSampleLangs: site.codeSamples }), hasBody && _jsx(RequestBodyExample, { body: op.requestBody }), mcp ? (_jsx(McpReturnsExample, { schema: mcp.outputSchema })) : (_jsx(ResponsesExamples, { responses: op.responses }))] })] }), _jsxs("div", { class: `${apiFirst ? "lg:hidden" : "xl:hidden"} mt-8 space-y-4`, children: [_jsx(CodeSamplesExamples, { operation: op, serverUrl: serverUrl, codeSampleLangs: site.codeSamples }), hasBody && _jsx(RequestBodyExample, { body: op.requestBody }), mcp ? (_jsx(McpReturnsExample, { schema: mcp.outputSchema })) : (_jsx(ResponsesExamples, { responses: op.responses }))] })] }));
+    return (_jsxs("div", { id: id, class: "py-8 border-t border-[rgb(var(--color-gray-100))] dark:border-[rgb(var(--color-gray-800))]", "data-traverse-target": id, children: [_jsx("header", { class: "mb-6", children: op.summary && (_jsxs("div", { class: "flex items-baseline gap-2 flex-wrap", children: [_jsx("h2", { class: "text-2xl sm:text-3xl text-[rgb(var(--color-gray-900))] dark:text-[rgb(var(--color-gray-200))] tracking-tight font-bold mb-2", children: _jsx(Markdown, { content: op.summary, inline: true }) }), op.deprecated && _jsx(DeprecatedBadge, {}), mcp?.annotations && _jsx(AnnotationBadges, { annotations: mcp.annotations })] })) }), mcp ? (_jsx(McpEndpointBar, { method: op.method, path: op.path })) : (_jsx(EndpointBar, { method: op.method, path: op.path, serverUrl: serverUrl })), _jsxs("div", { class: `flex flex-col ${apiFirst ? "lg:flex-row" : "xl:flex-row"} gap-8`, children: [_jsxs("div", { class: "flex-1 min-w-0", children: [op.description && _jsx(Markdown, { content: op.description, class: "mb-6 max-w-none" }), hasBody && (_jsxs("div", { class: "mt-6", children: [_jsx(SectionLabel, { meta: bodyMediaType(op.requestBody), children: "Body" }), _jsx(RequestBody, { body: op.requestBody })] })), hasParams && (_jsxs("div", { class: "mt-6", children: [_jsx(SectionLabel, { children: "Parameters" }), _jsx(Parameters, { parameters: op.parameters })] })), mcp ? (_jsx(McpReturnsCopy, { schema: mcp.outputSchema })) : (op.responses.length > 0 && (_jsxs("div", { class: "mt-6", children: [_jsx(SectionLabel, { children: "Response" }), _jsx(ResponsesCopy, { responses: op.responses })] }))), !mcp && _jsx(SecurityCopy, { security: op.security })] }), _jsxs("aside", { class: `hidden ${apiFirst ? "lg:block" : "xl:block"} w-[28rem] shrink-0 sticky self-start overflow-y-auto space-y-4`, style: "top: calc(var(--header-height) + 2.5rem); max-height: calc(100vh - var(--header-height) - 5rem)", children: [_jsx(CodeSamplesExamples, { operation: op, serverUrl: serverUrl, codeSampleLangs: site.codeSamples }), hasBody && _jsx(RequestBodyExample, { body: op.requestBody }), mcp ? (_jsx(McpReturnsExample, { schema: mcp.outputSchema })) : (_jsx(ResponsesExamples, { responses: op.responses }))] })] }), _jsxs("div", { class: `${apiFirst ? "lg:hidden" : "xl:hidden"} mt-8 space-y-4`, children: [_jsx(CodeSamplesExamples, { operation: op, serverUrl: serverUrl, codeSampleLangs: site.codeSamples }), hasBody && _jsx(RequestBodyExample, { body: op.requestBody }), mcp ? (_jsx(McpReturnsExample, { schema: mcp.outputSchema })) : (_jsx(ResponsesExamples, { responses: op.responses }))] })] }));
 }
 function bodyMediaType(body) {
     const types = Object.keys(body.content);

package/dist/config.d.ts

@@ -1,10 +1,58 @@
 import type { PrettyUrls } from "./site-url.js";
 import type { MarkdownPreprocessor } from "./core/markdown-loader.js";
 import type { ResolvedTabSource, SourceAdapter } from "./adapters/types.js";
+import { type ThemeName } from "./themes/registry.js";
 export type { PrettyUrls } from "./site-url.js";
-export type ThemePreset = "default" | "minimal" | "api-first";
+export type { ThemeName } from "./themes/registry.js";
+/** @deprecated Use ThemeName. */
+export type ThemePreset = ThemeName;
+export interface ReaderLink {
+    /** Optional icon for reader sidebar and aside links. */
+    icon?: "code" | "layers";
+    label: string;
+    href: string;
+    /** Optional supporting line for an aside or pagination link. */
+    description?: string;
+}
+/** Editorial chrome for long-form documentation. All fields are optional. */
+export interface ReaderThemeConfig {
+    document?: {
+        label: string;
+        title?: string;
+        version?: string;
+        status?: string;
+        /** Short badge when the full status is longer (for example, Draft). */
+        badge?: string;
+        /** Human-readable publication or revision date; never inferred from build time. */
+        updated?: string;
+    };
+    /** Show the site name beside a mark-only logo. Full wordmarks remain the default. */
+    logoMark?: boolean;
+    /** Host-authored links and note rendered below the chapter navigation. */
+    sidebar?: {
+        links?: ReaderLink[];
+        note?: string;
+    };
+    /** Host-authored links rendered below the generated table of contents. */
+    aside?: {
+        links?: ReaderLink[];
+    };
+    pagination?: {
+        before?: ReaderLink;
+        after?: ReaderLink;
+    };
+    footer?: {
+        text?: string;
+        links?: ReaderLink[];
+    };
+    /** Use a host site's search route instead of Sourcey's search dialog. */
+    searchHref?: string;
+}
 export interface ThemeConfig {
-    preset?: ThemePreset;
+    /** Selects the complete rendering theme. */
+    name?: ThemeName;
+    /** @deprecated Use `name`. Retained for compatibility through the 3.x line. */
+    preset?: ThemeName;
     colors?: {
         primary: string;
         light?: string;
@@ -13,6 +61,8 @@ export interface ThemeConfig {
     fonts?: {
         sans?: string;
         mono?: string;
+        /** Disable Google Fonts when fonts are supplied through custom CSS. */
+        google?: boolean;
     };
     layout?: {
         sidebar?: string;
@@ -20,6 +70,7 @@ export interface ThemeConfig {
         content?: string;
     };
     css?: string[];
+    reader?: ReaderThemeConfig;
 }
 export interface ChangelogConfig {
     /** Disable changelog auto-detection for CHANGELOG.md and layout: changelog pages. */
@@ -268,7 +319,7 @@ export interface NavbarLink {
 }
 export declare function defineConfig(config: SourceyConfig): SourceyConfig;
 export interface ResolvedTheme {
-    preset: ThemePreset;
+    name: ThemeName;
     colors: {
         primary: string;
         light: string;
@@ -277,7 +328,7 @@ export interface ResolvedTheme {
     fonts: {
         sans: string;
         mono: string;
-        googleFont: string;
+        googleFont: string | false;
     };
     layout: {
         sidebar: string;
@@ -285,6 +336,7 @@ export interface ResolvedTheme {
         content: string;
     };
     css: string[];
+    reader?: ReaderThemeConfig;
 }
 export interface ResolvedChangelogConfig {
     enabled: boolean;