sourcey 3.5.9 → 3.6.0

package/dist/dev-server.js

@@ -30,7 +30,12 @@ async function exists(path) {
     }
 }
 function log(msg) {
-    const t = new Date().toLocaleTimeString([], { hour12: false, hour: "2-digit", minute: "2-digit", second: "2-digit" });
+    const t = new Date().toLocaleTimeString([], {
+        hour12: false,
+        hour: "2-digit",
+        minute: "2-digit",
+        second: "2-digit",
+    });
     console.log(`  \x1b[2m${t}\x1b[0m ${msg}`);
 }
 function shortPath(path) {
@@ -44,20 +49,13 @@ export async function startDevServer(options) {
         : resolve(options.config ?? process.cwd(), "sourcey.config.ts");
     const watchPaths = [configPath];
     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.godoc) {
-            if (tab.godoc.snapshot)
-                watchPaths.push(tab.godoc.snapshot);
+        watchPaths.push(...(tab.source.watchPaths ?? []));
+        if (tab.source.kind === "godoc") {
             // The Go module directory is large; watching every .go file slows the
             // dev server. Restart manually after broad source edits.
         }
-        if (tab.groups) {
-            for (const group of tab.groups) {
+        if (tab.source.kind === "markdown") {
+            for (const group of tab.source.groups) {
                 for (const page of group.pages) {
                     watchPaths.push(page.file);
                 }
@@ -68,22 +66,41 @@ export async function startDevServer(options) {
         const map = new Map();
         map.set(configPath, { kind: "config" });
         for (const tab of cfg.tabs) {
-            if (tab.openapi) {
-                map.set(resolve(tab.openapi), { kind: "openapi", tabSlug: tab.slug, specPath: tab.openapi });
+            for (const watchPath of tab.source.watchPaths ?? []) {
+                map.set(resolve(watchPath), { kind: "config" });
+            }
+            if (tab.source.kind === "openapi") {
+                map.set(resolve(tab.source.spec), {
+                    kind: "openapi",
+                    tabSlug: tab.slug,
+                    specPath: tab.source.spec,
+                });
             }
-            if (tab.mcp) {
-                map.set(resolve(tab.mcp), { kind: "mcp", tabSlug: tab.slug, specPath: tab.mcp });
+            if (tab.source.kind === "mcp") {
+                map.set(resolve(tab.source.spec), {
+                    kind: "mcp",
+                    tabSlug: tab.slug,
+                    specPath: tab.source.spec,
+                });
             }
-            if (tab.doxygen) {
-                map.set(resolve(tab.doxygen.xml), { kind: "doxygen", tabSlug: tab.slug, xmlDir: tab.doxygen.xml });
+            if (tab.source.kind === "doxygen") {
+                map.set(resolve(tab.source.config.xml), {
+                    kind: "doxygen",
+                    tabSlug: tab.slug,
+                    xmlDir: tab.source.config.xml,
+                });
             }
-            if (tab.godoc?.snapshot) {
-                map.set(resolve(tab.godoc.snapshot), { kind: "godoc", tabSlug: tab.slug, snapshotPath: tab.godoc.snapshot });
+            if (tab.source.kind === "godoc" && tab.source.config.snapshot) {
+                map.set(resolve(tab.source.config.snapshot), {
+                    kind: "godoc",
+                    tabSlug: tab.slug,
+                    snapshotPath: tab.source.config.snapshot,
+                });
             }
-            if (tab.groups) {
-                for (const group of tab.groups) {
+            if (tab.source.kind === "markdown") {
+                for (const group of tab.source.groups) {
                     for (const page of group.pages) {
-                        map.set(resolve(page.file), { kind: "markdown", tabSlug: tab.slug, pagePath: page.file, pageSlug: page.slug });
+                        map.set(resolve(page.file), { kind: "markdown", tabSlug: tab.slug, page });
                     }
                 }
             }
@@ -143,11 +160,13 @@ export async function startDevServer(options) {
         const { data } = snapshot;
         const start = performance.now();
         if (content.kind === "markdown") {
-            const slug = slugFromPath(content.pageSlug);
-            log(`reloading ${shortPath(content.pagePath)}`);
-            const page = await loadDocsPage(content.pagePath, slug, {
+            const slug = slugFromPath(content.page.slug);
+            log(`reloading ${shortPath(content.page.file)}`);
+            const page = await loadDocsPage(content.page.file, slug, {
                 changelog: config.changelog.enabled,
                 repoUrl: config.repo,
+                sourceRoot: content.page.sourceRoot,
+                preprocess: content.page.preprocess,
             });
             if (cache !== snapshot)
                 return;
@@ -166,10 +185,10 @@ export async function startDevServer(options) {
         }
         else if (content.kind === "doxygen") {
             const tab = config.tabs.find((candidate) => candidate.slug === content.tabSlug);
-            if (!tab?.doxygen)
+            if (!tab || tab.source.kind !== "doxygen")
                 return;
             log(`rebuilding doxygen tab "${tab.label}"`);
-            const { pages, navTab } = await loadDoxygenTab(tab.doxygen, tab.slug, tab.label);
+            const { pages, navTab } = await loadDoxygenTab(tab.source.config, tab.slug, tab.label);
             if (cache !== snapshot)
                 return;
             for (const [key, page] of data.pageMap) {
@@ -194,13 +213,13 @@ export async function startDevServer(options) {
         }
         else if (content.kind === "godoc") {
             const tab = config.tabs.find((candidate) => candidate.slug === content.tabSlug);
-            if (!tab?.godoc)
+            if (!tab || tab.source.kind !== "godoc")
                 return;
             log(`rebuilding godoc tab "${tab.label}"`);
-            const { pages, navTab } = await loadGodocTab(tab.godoc, tab.slug, tab.label, {
+            const { pages, navTab } = await loadGodocTab(tab.source.config, tab.slug, tab.label, {
                 repo: config.repo,
                 editBranch: config.editBranch,
-                editBasePath: tab.godoc.sourceBasePath,
+                editBasePath: tab.source.config.sourceBasePath,
             });
             if (cache !== snapshot)
                 return;
@@ -280,7 +299,7 @@ export async function startDevServer(options) {
         return resolveConfigFromRaw(configMod.default, dirname(configPath));
     }
     async function render(url) {
-        const { renderPage } = await vite.ssrLoadModule(ssrRendererPath);
+        const { renderPage } = (await vite.ssrLoadModule(ssrRendererPath));
         const { data, siteConfig: site } = await getCached();
         const navigation = buildSiteNavigation(data.siteTabs);
         const requestPath = stripBaseUrl(new URL(url, "http://sourcey.local").pathname, config.baseUrl);
@@ -300,7 +319,10 @@ export async function startDevServer(options) {
             }
         }
         let pageData = data.pageMap.get(pagePath);
-        if (!pageData && config.prettyUrls === "slash" && pagePath.endsWith(".html") && !pagePath.endsWith("/index.html")) {
+        if (!pageData &&
+            config.prettyUrls === "slash" &&
+            pagePath.endsWith(".html") &&
+            !pagePath.endsWith("/index.html")) {
             // Fallback for stale `.html` links when prettyUrls is enabled.
             const pretty = pagePath.replace(/\.html$/, "/index.html");
             pageData = data.pageMap.get(pretty);
@@ -324,6 +346,10 @@ export async function startDevServer(options) {
         const docsPagesByTab = collectDocsPagesByTab(data.pageMap, config.tabs);
         return buildSearchIndex(data.specsBySlug, docsPagesByTab, navigation, config.baseUrl || "/", config.search.featured);
     }
+    async function loadExtraFileForDev(outputPath) {
+        const { data } = await getCached();
+        return data.extraFiles.get(outputPath);
+    }
     const viteConfig = {
         root: process.cwd(),
         server: {
@@ -343,6 +369,7 @@ export async function startDevServer(options) {
                 baseUrl: () => config.baseUrl,
                 render,
                 searchIndex: buildSearchIndexForDev,
+                extraFile: loadExtraFileForDev,
             }),
         ],
         clearScreen: false,

package/dist/index.d.ts

@@ -36,6 +36,8 @@ export interface SiteBuildResult {
 }
 export declare function buildSiteDocs(options?: SiteBuildOptions): Promise<SiteBuildResult>;
 export { defineConfig } from "./config.js";
+export { doxygen, godoc, markdown, mcp, mkdocs, openapi } from "./adapters/index.js";
 export { resolveInternalLinks } from "./site-assembly.js";
 export type { NormalizedSpec, NormalizedOperation, NormalizedTag, NormalizedSchema, NormalizedParameter, NormalizedRequestBody, NormalizedResponse, } from "./core/types.js";
+export type { DoxygenSourceOptions, GodocSourceOptions, MarkdownSourceOptions, McpSourceOptions, MkDocsSourceOptions, OpenApiSourceOptions, ResolvedTabSource, SourceAdapter, SourceAdapterContext, } from "./adapters/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAA8B,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAiBlD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAkB3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,OAAO,wBAAwB,EAAE,qBAAqB,EAAE,CAAC;IAC3E,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,CAoF5F;AA4CD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAiBlD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAkB3E;AAMD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,OAAO,wBAAwB,EAAE,qBAAqB,EAAE,CAAC;IAC3E,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,CAwF5F;AA8CD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG1D,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -29,7 +29,7 @@ export async function buildDocs(options) {
 }
 export async function buildSiteDocs(options = {}) {
     const outputDir = resolve(options.outputDir ?? "dist");
-    const config = options.config ?? await loadConfig(options.configDir);
+    const config = options.config ?? (await loadConfig(options.configDir));
     const assembled = await assembleSite(config);
     const site = await buildSiteConfig(config);
     const sitePages = Array.from(assembled.pageMap.values());
@@ -65,7 +65,9 @@ export async function buildSiteDocs(options = {}) {
     }
     else {
         const staticOg = config.ogImage;
-        if (staticOg.startsWith("http://") || staticOg.startsWith("https://") || staticOg.startsWith("data:")) {
+        if (staticOg.startsWith("http://") ||
+            staticOg.startsWith("https://") ||
+            staticOg.startsWith("data:")) {
             for (const page of sitePages) {
                 page.ogImagePath = staticOg;
             }
@@ -131,4 +133,5 @@ function summarizeVersion(version) {
     return summary || undefined;
 }
 export { defineConfig } from "./config.js";
+export { doxygen, godoc, markdown, mcp, mkdocs, openapi } from "./adapters/index.js";
 export { resolveInternalLinks } from "./site-assembly.js";

package/dist/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AA4DA,eAAO,MAAM,IAAI,qDAyPf,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AA4DA,eAAO,MAAM,IAAI,qDAoQf,CAAC"}

package/dist/init.js

@@ -79,7 +79,9 @@ export const init = defineCommand({
             }
         }
         if (existsSync(resolve(targetDir, "sourcey.config.ts"))) {
-            consola.error("sourcey.config.ts already exists in " + (targetDir === cwd ? "this directory" : relative(cwd, targetDir)) + ".");
+            consola.error("sourcey.config.ts already exists in " +
+                (targetDir === cwd ? "this directory" : relative(cwd, targetDir)) +
+                ".");
             process.exit(1);
         }
         // -- Auto-detect sources --
@@ -155,42 +157,45 @@ export const init = defineCommand({
                 process.exit(0);
         }
         // -- Generate files --
-        const pages = withExample
-            ? `["introduction", "quickstart"]`
-            : `["introduction"]`;
+        const pages = withExample ? `["introduction", "quickstart"]` : `["introduction"]`;
         // Build tabs array — paths relative from targetDir to cwd
         const relPath = (file) => {
             const abs = resolve(cwd, file);
             const rel = relative(targetDir, abs);
             return rel.startsWith(".") ? rel : "./" + rel;
         };
+        const imports = new Set(["defineConfig", "markdown"]);
         let tabs = `      {
         tab: "Documentation",
         slug: "",
-        groups: [
-          {
-            group: "Getting Started",
-            pages: ${pages},
-          },
-        ],
+        source: markdown({
+          groups: [
+            {
+              group: "Getting Started",
+              pages: ${pages},
+            },
+          ],
+        }),
       },`;
         if (addOpenAPI) {
+            imports.add("openapi");
             tabs += `
       {
         tab: "API Reference",
         slug: "api",
-        openapi: "${relPath(addOpenAPI)}",
+        source: openapi("${relPath(addOpenAPI)}"),
       },`;
         }
         if (addDoxygen) {
+            imports.add("doxygen");
             tabs += `
       {
         tab: "API Reference",
         slug: "api",
-        doxygen: { xml: "${relPath(addDoxygen.xmlDir)}" },
+        source: doxygen({ xml: "${relPath(addDoxygen.xmlDir)}" }),
       },`;
         }
-        const config = `import { defineConfig } from "sourcey";
+        const config = `import { ${[...imports].join(", ")} } from "sourcey";
 
 export default defineConfig({
   name: "${name}",
@@ -247,7 +252,7 @@ import { myFunction } from "my-package";
                     build: "sourcey build",
                 },
                 dependencies: {
-                    sourcey: "^3.4.3",
+                    sourcey: "^3.6.0",
                 },
             }, null, 2);
             writeFileSync(resolve(targetDir, "package.json"), pkg + "\n");

package/dist/site-assembly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site-assembly.d.ts","sourceRoot":"","sources":["../src/site-assembly.ts"],"names":[],"mappings":"AASA,OAAO,EAAgB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAIlF,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAiB,QAAQ,EAAgB,MAAM,2BAA2B,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAA8B,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACvG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;IAC1C,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CA2HhF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAKzE;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9B,IAAI,EAAE,WAAW,EAAE,GAClB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAgBzB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,WAAW,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN;AAaD,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,mBAAmB,EAAE,EAClC,eAAe,UAAQ,GACtB,IAAI,CAYN;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAIjF;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAI9E;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAEvF;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BjF;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAUlD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAuEpF"}
+{"version":3,"file":"site-assembly.d.ts","sourceRoot":"","sources":["../src/site-assembly.ts"],"names":[],"mappings":"AASA,OAAO,EAAgB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAIlF,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EAAiB,QAAQ,EAAgB,MAAM,2BAA2B,CAAC;AAEvF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EACV,mBAAmB,EAEnB,cAAc,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAGxD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,cAAc,CAAC;IAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,oBAAoB,EAAE,mBAAmB,EAAE,CAAC;IAC5C,gBAAgB,EAAE,qBAAqB,EAAE,CAAC;IAC1C,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAmIhF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAKzE;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9B,IAAI,EAAE,WAAW,EAAE,GAClB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAoBzB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,IAAI,EAAE,WAAW,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,GACrB,IAAI,CAsBN;AAaD,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,mBAAmB,EAAE,EAClC,eAAe,UAAQ,GACtB,IAAI,CAYN;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAIjF;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAI9E;AAED,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,MAAM,EAAE,CAEvF;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA4BjF;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAUlD;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CA6FpF"}

package/dist/site-assembly.js

@@ -1,5 +1,5 @@
 import { readFile } from "node:fs/promises";
-import { extname, posix, resolve } from "node:path";
+import { extname, posix, relative, resolve } from "node:path";
 import { loadSpec } from "./core/loader.js";
 import { convertToOpenApi3 } from "./core/converter.js";
 import { parseSpec } from "./core/parser.js";
@@ -20,7 +20,7 @@ export async function assembleSite(config) {
     const changelogDiagnostics = [];
     const godocDiagnostics = [];
     for (const tab of config.tabs) {
-        if (tab.openapi || tab.mcp) {
+        if (tab.source.kind === "openapi" || tab.source.kind === "mcp") {
             const spec = specsBySlug.get(tab.slug);
             const navTab = buildNavFromSpec(spec, tab.slug, config.prettyUrls);
             navTab.label = tab.label;
@@ -35,8 +35,8 @@ export async function assembleSite(config) {
             });
             continue;
         }
-        if (tab.doxygen) {
-            const { pages, navTab } = await loadDoxygenTab(tab.doxygen, tab.slug, tab.label);
+        if (tab.source.kind === "doxygen") {
+            const { pages, navTab } = await loadDoxygenTab(tab.source.config, tab.slug, tab.label);
             for (const [slug, page] of pages) {
                 const outputPath = pageOutputPath(tab.slug, slug, config.prettyUrls);
                 pageMap.set(outputPath, {
@@ -50,11 +50,11 @@ export async function assembleSite(config) {
             siteTabs.push(navTab);
             continue;
         }
-        if (tab.godoc) {
-            const { pages, navTab, diagnostics } = await loadGodocTab(tab.godoc, tab.slug, tab.label, {
+        if (tab.source.kind === "godoc") {
+            const { pages, navTab, diagnostics } = await loadGodocTab(tab.source.config, tab.slug, tab.label, {
                 repo: config.repo,
                 editBranch: config.editBranch,
-                editBasePath: tab.godoc.sourceBasePath,
+                editBasePath: tab.source.config.sourceBasePath,
             });
             godocDiagnostics.push(...diagnostics);
             for (const [slug, page] of pages) {
@@ -70,15 +70,17 @@ export async function assembleSite(config) {
             siteTabs.push(navTab);
             continue;
         }
-        if (!tab.groups)
+        if (tab.source.kind !== "markdown")
             continue;
         const pagesByPath = new Map();
-        for (const group of tab.groups) {
+        for (const group of tab.source.groups) {
             for (const rp of group.pages) {
                 const slug = slugFromPath(rp.slug);
                 const page = await loadDocsPage(rp.file, slug, {
                     changelog: config.changelog.enabled,
                     repoUrl: config.repo,
+                    sourceRoot: rp.sourceRoot,
+                    preprocess: rp.preprocess,
                 });
                 pagesByPath.set(rp.slug, page);
                 const outputPath = pageOutputPath(tab.slug, slug, config.prettyUrls);
@@ -111,6 +113,7 @@ export async function assembleSite(config) {
     const sitePages = Array.from(pageMap.values());
     resolveInternalLinks(sitePages, config);
     const extraFiles = attachChangelogFeeds(sitePages, config);
+    await attachSourceAssets(extraFiles, config.tabs);
     return {
         siteTabs,
         primarySpec,
@@ -130,13 +133,15 @@ export function formatGodocDiagnostic(diag) {
 export function collectDocsPagesByTab(pageMap, tabs) {
     const docsPagesByTab = new Map();
     for (const tab of tabs) {
-        if (!tab.groups && !tab.doxygen && !tab.godoc)
+        if (!isDocsSource(tab.source.kind))
             continue;
         const tabPages = [];
         for (const [, page] of pageMap) {
             if (page.tabSlug !== tab.slug || !isSearchableDocsSitePage(page))
                 continue;
-            tabPages.push(page.currentPage.kind === "markdown" ? page.currentPage.markdown : page.currentPage.changelog);
+            tabPages.push(page.currentPage.kind === "markdown"
+                ? page.currentPage.markdown
+                : page.currentPage.changelog);
         }
         docsPagesByTab.set(tab.slug, tabPages);
     }
@@ -144,10 +149,10 @@ export function collectDocsPagesByTab(pageMap, tabs) {
 }
 export function rebuildMarkdownTabNavigation(pageMap, siteTabs, tabs, tabSlug, prettyUrls) {
     const tab = tabs.find((candidate) => candidate.slug === tabSlug);
-    if (!tab?.groups)
+    if (!tab || tab.source.kind !== "markdown")
         return;
     const pagesByPath = new Map();
-    for (const group of tab.groups) {
+    for (const group of tab.source.groups) {
         for (const rp of group.pages) {
             const slug = slugFromPath(rp.slug);
             const entry = pageMap.get(pageOutputPath(tab.slug, slug, prettyUrls));
@@ -241,6 +246,7 @@ export function createMinimalSpec() {
 }
 export function resolveInternalLinks(pages, config) {
     const pathMap = new Map();
+    addSourceAssetAliases(pathMap, config.tabs ?? []);
     for (const page of pages) {
         const out = page.outputPath;
         const clean = out.replace(/\/index\.html$/, "").replace(/\.html$/, "");
@@ -253,6 +259,10 @@ export function resolveInternalLinks(pages, config) {
             .replace(/^\/+/, "")
             .replace(/\.(md|mdx)$/, "");
         pathMap.set(sourceClean, out);
+        const sourceRelativeClean = getSourceRootRelativePath(page);
+        if (sourceRelativeClean) {
+            pathMap.set(sourceRelativeClean, out);
+        }
     }
     const repoBase = config.repo?.replace(/\/$/, "");
     const branch = config.editBranch;
@@ -263,6 +273,7 @@ export function resolveInternalLinks(pages, config) {
         if (!docsSourcePath)
             continue;
         if (page.currentPage.kind === "markdown") {
+            page.currentPage.markdown.description = rewriteMarkdownLinks(page.currentPage.markdown.description, page.outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls);
             page.currentPage.markdown.html = rewriteHtmlLinks(page.currentPage.markdown.html, page.outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls);
             continue;
         }
@@ -338,6 +349,15 @@ function attachChangelogFeeds(pages, config) {
     }
     return extraFiles;
 }
+async function attachSourceAssets(extraFiles, tabs) {
+    for (const tab of tabs) {
+        if (tab.source.kind !== "markdown")
+            continue;
+        for (const asset of tab.source.assets ?? []) {
+            extraFiles.set(tabPath(tab.slug, asset.outputPath), await readFile(asset.file));
+        }
+    }
+}
 function addPermalinkPages(pageMap, prettyUrls) {
     const changelogPages = Array.from(pageMap.values()).filter(isMainChangelogSitePage);
     for (const page of changelogPages) {
@@ -364,15 +384,15 @@ function addPermalinkPages(pageMap, prettyUrls) {
 async function loadSpecs(tabs) {
     const specsBySlug = new Map();
     for (const tab of tabs) {
-        if (tab.openapi) {
-            const loaded = await loadSpec(tab.openapi);
+        if (tab.source.kind === "openapi") {
+            const loaded = await loadSpec(tab.source.spec);
             const parsed = await parseSpec(loaded);
             const openapi3 = await convertToOpenApi3(parsed);
             specsBySlug.set(tab.slug, normalizeSpec(openapi3));
         }
-        else if (tab.mcp) {
+        else if (tab.source.kind === "mcp") {
             const { parse } = await import("mcp-parser");
-            const mcpSpec = await parse(tab.mcp);
+            const mcpSpec = await parse(tab.source.spec);
             specsBySlug.set(tab.slug, normalizeMcpSpec(mcpSpec));
         }
     }
@@ -395,7 +415,10 @@ const MIME_TYPES = {
     ".ico": "image/x-icon",
 };
 async function resolveAssetUrl(pathOrUrl) {
-    if (!pathOrUrl || pathOrUrl.startsWith("data:") || pathOrUrl.startsWith("http://") || pathOrUrl.startsWith("https://")) {
+    if (!pathOrUrl ||
+        pathOrUrl.startsWith("data:") ||
+        pathOrUrl.startsWith("http://") ||
+        pathOrUrl.startsWith("https://")) {
         return pathOrUrl;
     }
     const abs = resolve(pathOrUrl);
@@ -409,6 +432,9 @@ function isMainChangelogSitePage(page) {
 function isSearchableDocsSitePage(page) {
     return page.currentPage.kind === "markdown" || isMainChangelogSitePage(page);
 }
+function isDocsSource(kind) {
+    return kind === "markdown" || kind === "doxygen" || kind === "godoc";
+}
 function createFeedLinks(atomPath, rssPath, title) {
     return [
         { href: atomPath, type: "application/atom+xml", title: `${title} Atom Feed` },
@@ -429,26 +455,74 @@ function getDocsSourcePath(page) {
         return page.currentPage.changelog.sourcePath;
     return undefined;
 }
+function getSourceRootRelativePath(page) {
+    if (page.currentPage.kind !== "markdown")
+        return undefined;
+    const markdown = page.currentPage.markdown;
+    if (!markdown.sourceRoot)
+        return undefined;
+    const sourceRoot = normalizeSourcePath(markdown.sourceRoot);
+    const sourcePath = normalizeSourcePath(markdown.sourcePath);
+    if (!sourcePath.startsWith(`${sourceRoot}/`))
+        return undefined;
+    return stripMarkdownExtension(sourcePath.slice(sourceRoot.length + 1));
+}
+function addSourceAssetAliases(pathMap, tabs) {
+    for (const tab of tabs) {
+        if (tab.source.kind !== "markdown")
+            continue;
+        for (const asset of tab.source.assets ?? []) {
+            const outputPath = tabPath(tab.slug, asset.outputPath);
+            pathMap.set(normalizeSourcePath(asset.outputPath), outputPath);
+            for (const sourceRoot of sourceRootsForMarkdownSource(tab.source)) {
+                const sourceRootPath = normalizeSourcePath(relative(process.cwd(), sourceRoot));
+                pathMap.set(posix.join(sourceRootPath, normalizeSourcePath(asset.outputPath)), outputPath);
+            }
+        }
+    }
+}
+function sourceRootsForMarkdownSource(source) {
+    const roots = new Set();
+    for (const group of source.groups) {
+        for (const page of group.pages) {
+            if (page.sourceRoot)
+                roots.add(page.sourceRoot);
+        }
+    }
+    return [...roots];
+}
+function normalizeSourcePath(value) {
+    return value.replace(/\\/g, "/").replace(/^\/+/, "");
+}
+function stripMarkdownExtension(value) {
+    return value.replace(/\.(md|mdx)$/, "");
+}
 function rewriteHtmlLinks(html, outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls) {
-    return html.replace(/href="([^"]+)"/g, (match, href) => {
+    return html.replace(/\b(href|src)="([^"]+)"/g, (match, attr, href) => {
         const resolved = resolveInternalHref(href, outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls);
-        return resolved ? `href="${resolved}"` : match;
+        return resolved ? `${attr}="${resolved}"` : match;
     });
 }
 function rewriteMarkdownLinks(markdown, outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls) {
-    return markdown.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (match, label, href) => {
+    return markdown.replace(/\[((?:`[^`]*`|[^\]])+)\]\(([^)]+)\)/g, (match, label, href) => {
         const resolved = resolveInternalHref(href, outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls);
         return resolved ? `[${label}](${resolved})` : match;
     });
 }
 function resolveInternalHref(href, outputPath, docsSourcePath, pathMap, sourceBase, prettyUrls) {
-    if (href.startsWith("http://") || href.startsWith("https://") || href.startsWith("#") || href.startsWith("mailto:")) {
+    if (href.startsWith("http://") ||
+        href.startsWith("https://") ||
+        href.startsWith("#") ||
+        href.startsWith("mailto:")) {
         return null;
     }
     const [path, hash] = href.split("#", 2);
     const hashSuffix = hash ? `#${hash}` : "";
-    const sourcePath = path.replace(/\\/g, "/");
-    const clean = sourcePath.replace(/^\/+/, "").replace(/\/+$/, "").replace(/\.(md|mdx|html)$/, "");
+    const sourcePath = decodeHrefPath(path).replace(/\\/g, "/");
+    const clean = sourcePath
+        .replace(/^\/+/, "")
+        .replace(/\/+$/, "")
+        .replace(/\.(md|mdx|html)$/, "");
     const pageDir = outputPath.includes("/")
         ? outputPath.substring(0, outputPath.lastIndexOf("/"))
         : "";
@@ -490,6 +564,14 @@ function resolveInternalHref(href, outputPath, docsSourcePath, pathMap, sourceBa
     }
     return null;
 }
+function decodeHrefPath(path) {
+    try {
+        return decodeURIComponent(path);
+    }
+    catch {
+        return path;
+    }
+}
 /**
  * Rewrite an on-disk output path into the relative href that a user visits.
  * - `"slash"`: trims trailing `index.html`, leaves a directory-style `foo/`.
@@ -506,7 +588,7 @@ function toPrettyLink(target, prettyUrls) {
         return prettyUrls === "strip" ? withSlash.slice(0, -1) : withSlash;
     }
     if (prettyUrls === "strip" && target.endsWith(".html")) {
-        return target.slice(0, -(".html".length));
+        return target.slice(0, -".html".length);
     }
     return target;
 }

package/dist/utils/markdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,KAAK,EAAe,MAAM,QAAQ,CAAC;AAKzD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CASnE;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAgJD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAGnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAe5D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D"}
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/utils/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,KAAK,EAAe,MAAM,QAAQ,CAAC;AAOzD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CASnE;AAED,4CAA4C;AAC5C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AA2JD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAGnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAe5D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/utils/markdown.js

@@ -2,6 +2,7 @@ import { Marked } from "marked";
 import { highlightCode } from "./highlighter.js";
 import { COPY_ICON_SVG } from "./copy-svg.js";
 import { htmlId } from "./html-id.js";
+const MARKDOWN_LINK_RE = /\[((?:`[^`]*`|[^\]])+)\]\(([^)]+)\)/g;
 /**
  * Shared code block renderer used by all markdown rendering.
  * Outputs the prose-code-block wrapper with copy button and Shiki highlighting.
@@ -98,7 +99,13 @@ const iframeExtension = {
                     return undefined;
                 const attrs = parseDirectiveAttrs(match[2] ?? "");
                 const height = parseInt(attrs.height ?? "", 10);
-                return { type: "iframe", raw: match[0], url: match[1], title: attrs.title ?? "", height: Number.isFinite(height) ? height : 400 };
+                return {
+                    type: "iframe",
+                    raw: match[0],
+                    url: match[1],
+                    title: attrs.title ?? "",
+                    height: Number.isFinite(height) ? height : 400,
+                };
             },
             renderer(token) {
                 const { url, title, height } = token;
@@ -124,8 +131,12 @@ const marked = new Marked(videoExtension, iframeExtension, {
             return `<h${depth} id="${id}">${this.parser.parseInline(tokens)}</h${depth}>\n`;
         },
         table(token) {
-            const header = token.header.map((cell) => `<th>${this.parser.parseInline(cell.tokens)}</th>`).join("");
-            const body = token.rows.map((row) => `<tr>${row.map((cell) => `<td>${this.parser.parseInline(cell.tokens)}</td>`).join("")}</tr>`).join("\n");
+            const header = token.header
+                .map((cell) => `<th>${this.parser.parseInline(cell.tokens)}</th>`)
+                .join("");
+            const body = token.rows
+                .map((row) => `<tr>${row.map((cell) => `<td>${this.parser.parseInline(cell.tokens)}</td>`).join("")}</tr>`)
+                .join("\n");
             return `<div class="table-wrap"><table><thead><tr>${header}</tr></thead><tbody>${body}</tbody></table></div>`;
         },
         link({ href, title, tokens }) {
@@ -193,7 +204,7 @@ export function extractFirstParagraph(input) {
 export function stripMarkdownLinks(input) {
     if (!input)
         return "";
-    return input.replace(/\[([^\]]+)\]\(([^)]+)\)/g, "$1");
+    return input.replace(MARKDOWN_LINK_RE, "$1");
 }
 /**
  * Render Markdown to HTML.