sourcey 3.3.10 → 3.4.1

package/dist/dev-server.js

@@ -7,6 +7,7 @@ import { loadSpec } from "./core/loader.js";
 import { convertToOpenApi3 } from "./core/converter.js";
 import { parseSpec } from "./core/parser.js";
 import { normalizeSpec } from "./core/normalizer.js";
+import { normalizeMcpSpec } from "./core/mcp-normalizer.js";
 import { buildNavFromSpec, buildNavFromPages, buildSiteNavigation, withActivePage } from "./core/navigation.js";
 import { loadMarkdownPage, slugFromPath } from "./core/markdown-loader.js";
 import { loadDoxygenTab } from "./core/doxygen-loader.js";
@@ -40,6 +41,8 @@ export async function startDevServer(options) {
     for (const tab of config.tabs) {
         if (tab.openapi)
             watchPaths.push(tab.openapi);
+        if (tab.mcp)
+            watchPaths.push(tab.mcp);
         if (tab.doxygen)
             watchPaths.push(tab.doxygen.xml);
         if (tab.groups) {
@@ -57,6 +60,9 @@ export async function startDevServer(options) {
             if (tab.openapi) {
                 map.set(resolve(tab.openapi), { kind: "openapi", tabSlug: tab.slug, specPath: tab.openapi });
             }
+            if (tab.mcp) {
+                map.set(resolve(tab.mcp), { kind: "mcp", tabSlug: tab.slug, specPath: tab.mcp });
+            }
             if (tab.doxygen) {
                 map.set(resolve(tab.doxygen.xml), { kind: "doxygen", tabSlug: tab.slug, xmlDir: tab.doxygen.xml });
             }
@@ -183,6 +189,29 @@ export async function startDevServer(options) {
                     data.siteTabs[idx] = navTab;
             }
         }
+        else if (content.kind === "mcp") {
+            log(`reparsing mcp spec ${shortPath(content.specPath)}`);
+            const { parse } = await import("mcp-parser");
+            const mcpSpec = await parse(content.specPath);
+            const spec = normalizeMcpSpec(mcpSpec);
+            if (cache !== snapshot)
+                return;
+            data.specsBySlug.set(content.tabSlug, spec);
+            const pageKey = tabPath(content.tabSlug, "index.html");
+            const existing = data.pageMap.get(pageKey);
+            if (existing) {
+                existing.currentPage = { kind: "spec", spec };
+                existing.spec = spec;
+            }
+            const tab = config.tabs.find((t) => t.slug === content.tabSlug);
+            if (tab) {
+                const navTab = buildNavFromSpec(spec, tab.slug);
+                navTab.label = tab.label;
+                const idx = data.siteTabs.findIndex((t) => t.slug === content.tabSlug);
+                if (idx !== -1)
+                    data.siteTabs[idx] = navTab;
+            }
+        }
         const ms = Math.round(performance.now() - start);
         log(`updated \x1b[2m(${ms}ms)\x1b[0m`);
     }
@@ -257,7 +286,7 @@ export async function startDevServer(options) {
                 markdownPagesByTab.set(tab.slug, tabPages);
             }
         }
-        return buildSearchIndex(specsBySlug, markdownPagesByTab, navigation);
+        return buildSearchIndex(specsBySlug, markdownPagesByTab, navigation, "/", config.search.featured);
     }
     const viteConfig = {
         root: process.cwd(),
@@ -265,6 +294,9 @@ export async function startDevServer(options) {
             port,
             strictPort: true,
             hmr: true,
+            fs: {
+                allow: [process.cwd(), projectRoot],
+            },
         },
         plugins: [
             preact(),
@@ -330,20 +362,26 @@ async function loadSiteData(tabs) {
     const siteTabs = [];
     const pageMap = new Map();
     for (const tab of tabs) {
-        if (!tab.openapi)
-            continue;
-        const loaded = await loadSpec(tab.openapi);
-        const parsed = await parseSpec(loaded);
-        const openapi3 = await convertToOpenApi3(parsed);
-        const spec = normalizeSpec(openapi3);
-        specsBySlug.set(tab.slug, spec);
+        if (tab.openapi) {
+            const loaded = await loadSpec(tab.openapi);
+            const parsed = await parseSpec(loaded);
+            const openapi3 = await convertToOpenApi3(parsed);
+            const spec = normalizeSpec(openapi3);
+            specsBySlug.set(tab.slug, spec);
+        }
+        else if (tab.mcp) {
+            const { parse } = await import("mcp-parser");
+            const mcpSpec = await parse(tab.mcp);
+            const spec = normalizeMcpSpec(mcpSpec);
+            specsBySlug.set(tab.slug, spec);
+        }
     }
     const primarySpec = specsBySlug.values().next().value ?? {
         info: { title: "", version: "", description: "" },
         servers: [], tags: [], operations: [], schemas: {}, securitySchemes: {}, webhooks: [],
     };
     for (const tab of tabs) {
-        if (tab.openapi) {
+        if (tab.openapi || tab.mcp) {
             const spec = specsBySlug.get(tab.slug);
             const navTab = buildNavFromSpec(spec, tab.slug);
             navTab.label = tab.label;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AAc/D,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;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAY3E;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;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,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,CA0G5F;AAgKD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,aAAa,CAAC;AAe/D,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;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAY3E;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;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,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,CAoH5F;AAgKD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -4,6 +4,7 @@ import { loadSpec } from "./core/loader.js";
 import { convertToOpenApi3 } from "./core/converter.js";
 import { parseSpec } from "./core/parser.js";
 import { normalizeSpec } from "./core/normalizer.js";
+import { normalizeMcpSpec } from "./core/mcp-normalizer.js";
 import { buildSite as buildSiteHtml } from "./renderer/html-builder.js";
 import { tabPath } from "./config.js";
 import { loadConfig, configFromSpec } from "./config.js";
@@ -11,6 +12,7 @@ import { loadMarkdownPage, slugFromPath } from "./core/markdown-loader.js";
 import { loadDoxygenTab } from "./core/doxygen-loader.js";
 import { buildNavFromSpec, buildNavFromPages, buildSiteNavigation } from "./core/navigation.js";
 import { buildSearchIndex } from "./core/search-indexer.js";
+import { generateLlmsTxt, generateLlmsFullTxt } from "./renderer/llms.js";
 /**
  * Build API documentation from a single OpenAPI/Swagger spec.
  * Wraps the spec in a single-tab site and renders through the modern layout.
@@ -33,15 +35,21 @@ export async function buildSiteDocs(options = {}) {
     const sitePages = [];
     const siteTabs = [];
     const specsBySlug = new Map();
-    // Load all specs
+    // Load all specs (OpenAPI and MCP)
     for (const tab of tabs) {
-        if (!tab.openapi)
-            continue;
-        const loaded = await loadSpec(tab.openapi);
-        const parsed = await parseSpec(loaded);
-        const openapi3 = await convertToOpenApi3(parsed);
-        const spec = normalizeSpec(openapi3);
-        specsBySlug.set(tab.slug, spec);
+        if (tab.openapi) {
+            const loaded = await loadSpec(tab.openapi);
+            const parsed = await parseSpec(loaded);
+            const openapi3 = await convertToOpenApi3(parsed);
+            const spec = normalizeSpec(openapi3);
+            specsBySlug.set(tab.slug, spec);
+        }
+        else if (tab.mcp) {
+            const { parse } = await import("mcp-parser");
+            const mcpSpec = await parse(tab.mcp);
+            const spec = normalizeMcpSpec(mcpSpec);
+            specsBySlug.set(tab.slug, spec);
+        }
     }
     // Primary spec for SpecContext on markdown pages
     const primarySpec = specsBySlug.values().next().value ?? createMinimalSpec();
@@ -49,7 +57,7 @@ export async function buildSiteDocs(options = {}) {
     const site = await buildSiteConfig(config);
     // Process all tabs
     for (const tab of tabs) {
-        if (tab.openapi) {
+        if (tab.openapi || tab.mcp) {
             const spec = specsBySlug.get(tab.slug);
             const navTab = buildNavFromSpec(spec, tab.slug);
             navTab.label = tab.label;
@@ -110,10 +118,14 @@ export async function buildSiteDocs(options = {}) {
             markdownPagesByTab.set(tab.slug, tabPages);
         }
     }
-    const searchIndex = buildSearchIndex(specsBySlug, markdownPagesByTab, navigation);
+    const searchIndex = buildSearchIndex(specsBySlug, markdownPagesByTab, navigation, "/", config.search.featured);
+    const llmsTxt = generateLlmsTxt(sitePages, navigation, site);
+    const llmsFullTxt = generateLlmsFullTxt(sitePages, navigation, site);
     if (!options.skipWrite) {
         await buildSiteHtml(sitePages, navigation, outputDir, site, {
             searchIndex,
+            llmsTxt,
+            llmsFullTxt,
             embeddable: options.embeddable,
         });
     }

package/dist/renderer/html-builder.d.ts

@@ -18,5 +18,7 @@ export interface SitePage {
 export declare function buildSite(pages: SitePage[], navigation: SiteNavigation, outputDir: string, site: SiteConfig, options?: {
     embeddable?: boolean;
     searchIndex?: string;
+    llmsTxt?: string;
+    llmsFullTxt?: string;
 }): Promise<BuildOutput>;
 //# sourceMappingURL=html-builder.d.ts.map

package/dist/renderer/html-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-builder.d.ts","sourceRoot":"","sources":["../../src/renderer/html-builder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAiB,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA0B5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,WAAW,CAAC,CAoCtB"}
+{"version":3,"file":"html-builder.d.ts","sourceRoot":"","sources":["../../src/renderer/html-builder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAiB,WAAW,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AA0B5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/F,OAAO,CAAC,WAAW,CAAC,CAsDtB"}

package/dist/renderer/html-builder.js

@@ -60,6 +60,21 @@ export async function buildSite(pages, navigation, outputDir, site, options) {
     if (options?.searchIndex) {
         await writeFile(resolve(resolvedDir, "search-index.json"), options.searchIndex, "utf-8");
     }
+    if (options?.llmsTxt) {
+        await writeFile(resolve(resolvedDir, "llms.txt"), options.llmsTxt, "utf-8");
+    }
+    if (options?.llmsFullTxt) {
+        await writeFile(resolve(resolvedDir, "llms-full.txt"), options.llmsFullTxt, "utf-8");
+    }
+    const urls = pages.map(p => `  <url><loc>${p.outputPath}</loc></url>`);
+    const sitemap = [
+        `<?xml version="1.0" encoding="UTF-8"?>`,
+        `<!-- Generated by Sourcey https://sourcey.com -->`,
+        `<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">`,
+        ...urls,
+        `</urlset>`,
+    ].join("\n");
+    await writeFile(resolve(resolvedDir, "sitemap.xml"), sitemap, "utf-8");
     return { htmlPath: resolve(resolvedDir, "index.html"), outputDir: resolvedDir };
 }
 /**

package/dist/renderer/llms.d.ts

@@ -0,0 +1,6 @@
+import type { SiteNavigation } from "../core/navigation.js";
+import type { SiteConfig } from "./context.js";
+import type { SitePage } from "./html-builder.js";
+export declare function generateLlmsTxt(pages: SitePage[], navigation: SiteNavigation, site: SiteConfig): string;
+export declare function generateLlmsFullTxt(pages: SitePage[], navigation: SiteNavigation, site: SiteConfig): string;
+//# sourceMappingURL=llms.d.ts.map

package/dist/renderer/llms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llms.d.ts","sourceRoot":"","sources":["../../src/renderer/llms.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,UAAU,GACf,MAAM,CA4CR;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,QAAQ,EAAE,EACjB,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,UAAU,GACf,MAAM,CA8BR"}

package/dist/renderer/llms.js

@@ -0,0 +1,247 @@
+import { htmlId } from "../utils/html-id.js";
+export function generateLlmsTxt(pages, navigation, site) {
+    const lines = [];
+    const title = resolveSiteTitle(pages, site);
+    const summary = resolveSiteSummary(pages, site);
+    lines.push(`# ${title}`);
+    lines.push("");
+    if (summary) {
+        lines.push(`> ${firstLine(summary)}`);
+        lines.push("");
+    }
+    for (const tab of navigation.tabs) {
+        const tabPages = pages.filter((page) => page.tabSlug === tab.slug);
+        if (!tabPages.length)
+            continue;
+        lines.push(`## ${tab.label}`);
+        lines.push("");
+        for (const page of tabPages) {
+            if (page.currentPage.kind === "markdown" && page.currentPage.markdown) {
+                const doc = page.currentPage.markdown;
+                const desc = doc.description || excerpt(stripHtml(doc.html));
+                lines.push(`- [${doc.title}](${page.outputPath})${desc ? `: ${desc}` : ""}`);
+                continue;
+            }
+            const spec = page.currentPage.spec ?? page.spec;
+            const overview = spec.info.description ? firstLine(spec.info.description) : `${spec.operations.length} documented operations`;
+            lines.push(`- [${spec.info.title}](${page.outputPath})${overview ? `: ${overview}` : ""}`);
+            for (const op of spec.operations) {
+                if (op.hidden)
+                    continue;
+                const opLabel = op.summary ?? operationDisplayName(op);
+                const opSummary = [operationKind(op), firstLine(op.description)].filter(Boolean).join(" — ");
+                lines.push(`- [${opLabel}](${page.outputPath}#${operationAnchor(op)})${opSummary ? `: ${opSummary}` : ""}`);
+            }
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+export function generateLlmsFullTxt(pages, navigation, site) {
+    const lines = [];
+    const title = resolveSiteTitle(pages, site);
+    const summary = resolveSiteSummary(pages, site);
+    lines.push(`# ${title}`);
+    lines.push("");
+    if (summary) {
+        lines.push(summary);
+        lines.push("");
+    }
+    for (const tab of navigation.tabs) {
+        const tabPages = pages.filter((page) => page.tabSlug === tab.slug);
+        if (!tabPages.length)
+            continue;
+        lines.push(`## ${tab.label}`);
+        lines.push("");
+        for (const page of tabPages) {
+            if (page.currentPage.kind === "markdown" && page.currentPage.markdown) {
+                appendMarkdownPage(lines, page);
+            }
+            else {
+                appendSpecPage(lines, page);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+function appendMarkdownPage(lines, page) {
+    const doc = page.currentPage.markdown;
+    lines.push(`### ${doc.title}`);
+    lines.push("");
+    lines.push(`Path: \`${page.outputPath}\``);
+    lines.push("");
+    if (doc.description) {
+        lines.push(doc.description);
+        lines.push("");
+    }
+    const body = stripHtml(doc.html);
+    if (body) {
+        lines.push(body);
+        lines.push("");
+    }
+}
+function appendSpecPage(lines, page) {
+    const spec = page.currentPage.spec ?? page.spec;
+    lines.push(`### ${spec.info.title}`);
+    lines.push("");
+    lines.push(`Path: \`${page.outputPath}\``);
+    if (spec.info.version) {
+        lines.push(`Version: ${spec.info.version}`);
+    }
+    lines.push("");
+    if (spec.info.description) {
+        lines.push(spec.info.description);
+        lines.push("");
+    }
+    if (spec.operations.length) {
+        lines.push("#### Operations");
+        lines.push("");
+        for (const op of spec.operations) {
+            if (op.hidden)
+                continue;
+            appendOperation(lines, op);
+        }
+    }
+    const schemas = Object.entries(spec.schemas);
+    if (schemas.length) {
+        lines.push("#### Models");
+        lines.push("");
+        for (const [name, schema] of schemas) {
+            const desc = schema.description ? `: ${schema.description}` : "";
+            lines.push(`- ${name}${desc}`);
+        }
+        lines.push("");
+    }
+}
+function appendOperation(lines, op) {
+    lines.push(`##### ${operationDisplayName(op)}`);
+    lines.push("");
+    if (op.summary && op.summary !== operationDisplayName(op)) {
+        lines.push(`Summary: ${op.summary}`);
+        lines.push("");
+    }
+    if (op.description) {
+        lines.push(op.description);
+        lines.push("");
+    }
+    if (op.parameters.length) {
+        lines.push("Parameters:");
+        for (const param of op.parameters) {
+            const req = param.required ? "required" : "optional";
+            const type = param.schema ? formatSchemaType(param.schema) : "unknown";
+            const desc = param.description ? ` — ${firstLine(param.description)}` : "";
+            lines.push(`- \`${param.name}\` (${param.in}, ${type}, ${req})${desc}`);
+        }
+        lines.push("");
+    }
+    if (op.requestBody) {
+        const mediaTypes = Object.keys(op.requestBody.content);
+        if (mediaTypes.length) {
+            lines.push(`Request body: ${mediaTypes.join(", ")}`);
+            lines.push("");
+        }
+    }
+    if (op.mcpExtras?.outputSchema) {
+        lines.push("Returns:");
+        lines.push("```json");
+        lines.push(JSON.stringify(op.mcpExtras.outputSchema, null, 2));
+        lines.push("```");
+        lines.push("");
+    }
+    else if (op.responses.length) {
+        lines.push("Responses:");
+        for (const response of op.responses) {
+            lines.push(`- ${formatResponse(response)}`);
+        }
+        lines.push("");
+    }
+}
+function resolveSiteTitle(pages, site) {
+    if (site.name && site.name !== "API Reference")
+        return site.name;
+    const specPages = pages.filter((page) => page.currentPage.kind === "spec");
+    if (specPages.length === 1) {
+        const spec = specPages[0].currentPage.spec ?? specPages[0].spec;
+        if (spec.info.title)
+            return spec.info.title;
+    }
+    const firstMarkdown = pages.find((page) => page.currentPage.kind === "markdown" && page.currentPage.markdown);
+    if (firstMarkdown?.currentPage.markdown?.title)
+        return firstMarkdown.currentPage.markdown.title;
+    return site.name || "Documentation";
+}
+function resolveSiteSummary(pages, site) {
+    const firstMarkdown = pages.find((page) => page.currentPage.kind === "markdown" && page.currentPage.markdown?.description);
+    if (firstMarkdown?.currentPage.markdown?.description)
+        return firstMarkdown.currentPage.markdown.description;
+    const firstSpec = pages.find((page) => page.currentPage.kind === "spec");
+    const spec = firstSpec ? (firstSpec.currentPage.spec ?? firstSpec.spec) : undefined;
+    if (spec?.info.description)
+        return spec.info.description;
+    return site.name ? `${site.name} documentation generated by Sourcey.` : undefined;
+}
+function operationDisplayName(op) {
+    if (op.mcpExtras?.type === "tool")
+        return `TOOL ${op.path}`;
+    if (op.mcpExtras?.type === "resource")
+        return `RESOURCE ${op.path}`;
+    if (op.mcpExtras?.type === "prompt")
+        return `PROMPT ${op.path}`;
+    return `${op.method.toUpperCase()} ${op.path}`;
+}
+function operationKind(op) {
+    if (op.mcpExtras?.type === "tool")
+        return "tool";
+    if (op.mcpExtras?.type === "resource")
+        return "resource";
+    if (op.mcpExtras?.type === "prompt")
+        return "prompt";
+    return `${op.method.toUpperCase()} ${op.path}`;
+}
+function operationAnchor(op) {
+    return `operation-${htmlId(op.path)}-${htmlId(op.method)}`;
+}
+function formatResponse(response) {
+    const desc = response.description ? firstLine(response.description) : "";
+    return desc ? `${response.statusCode}: ${desc}` : response.statusCode;
+}
+function formatSchemaType(schema) {
+    if (Array.isArray(schema.type))
+        return schema.type.join(" | ");
+    if (schema.type)
+        return schema.type;
+    if (schema.oneOf?.length)
+        return schema.oneOf.map(formatSchemaType).join(" | ");
+    if (schema.anyOf?.length)
+        return schema.anyOf.map(formatSchemaType).join(" | ");
+    if (schema.allOf?.length)
+        return "object";
+    if (schema.properties)
+        return "object";
+    return "unknown";
+}
+function stripHtml(html) {
+    return decodeEntities(html)
+        .replace(/<pre[\s\S]*?<\/pre>/gi, (match) => match.replace(/<[^>]+>/g, " "))
+        .replace(/<code[\s\S]*?<\/code>/gi, (match) => match.replace(/<[^>]+>/g, " "))
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function decodeEntities(text) {
+    return text
+        .replace(/&nbsp;/g, " ")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, "\"")
+        .replace(/&#39;/g, "'");
+}
+function excerpt(text, max = 140) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max - 1).trimEnd()}…`;
+}
+function firstLine(text) {
+    return text?.split("\n").map((line) => line.trim()).find(Boolean) ?? "";
+}

package/dist/themes/default/main.css

@@ -65,6 +65,9 @@
   --method-put: #d97706;
   --method-delete: #dc2626;
   --method-patch: #9333ea;
+  --method-tool: #9333ea;
+  --method-resource: #16a34a;
+  --method-prompt: #2563eb;
 
   /* Typography */
   --font-sans: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', system-ui, sans-serif;