sourcey 3.5.1 → 3.5.3

package/dist/dev-server.js

@@ -2,7 +2,7 @@ import { createServer as createViteServer } from "vite";
 import { resolve, dirname, extname, basename, relative } from "node:path";
 import { access } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
-import { loadConfig, pageOutputPath, resolveConfigFromRaw, tabPath } from "./config.js";
+import { loadConfig, pageOutputPath, resolveConfigFromRaw, tabIndexOutputPath } from "./config.js";
 import { loadSpec } from "./core/loader.js";
 import { convertToOpenApi3 } from "./core/converter.js";
 import { parseSpec } from "./core/parser.js";
@@ -11,6 +11,7 @@ import { normalizeMcpSpec } from "./core/mcp-normalizer.js";
 import { buildNavFromSpec, buildSiteNavigation, withActivePage } from "./core/navigation.js";
 import { loadDocsPage, slugFromPath } from "./core/markdown-loader.js";
 import { loadDoxygenTab } from "./core/doxygen-loader.js";
+import { loadGodocTab } from "./core/godoc-loader.js";
 import { buildSearchIndex } from "./core/search-indexer.js";
 import { createRenderOptions } from "./renderer/html-builder.js";
 import { assembleSite, buildSiteConfig, collectDocsPagesByTab, enforceChangelogDiagnostics, formatChangelogDiagnostic, rebuildMarkdownTabNavigation, resolveInternalLinks, } from "./site-assembly.js";
@@ -49,6 +50,12 @@ export async function startDevServer(options) {
             watchPaths.push(tab.mcp);
         if (tab.doxygen)
             watchPaths.push(tab.doxygen.xml);
+        if (tab.godoc) {
+            if (tab.godoc.snapshot)
+                watchPaths.push(tab.godoc.snapshot);
+            // 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) {
                 for (const page of group.pages) {
@@ -70,6 +77,9 @@ export async function startDevServer(options) {
             if (tab.doxygen) {
                 map.set(resolve(tab.doxygen.xml), { kind: "doxygen", tabSlug: tab.slug, xmlDir: tab.doxygen.xml });
             }
+            if (tab.godoc?.snapshot) {
+                map.set(resolve(tab.godoc.snapshot), { kind: "godoc", tabSlug: tab.slug, snapshotPath: tab.godoc.snapshot });
+            }
             if (tab.groups) {
                 for (const group of tab.groups) {
                     for (const page of group.pages) {
@@ -182,6 +192,38 @@ export async function startDevServer(options) {
             else
                 data.siteTabs.push(navTab);
         }
+        else if (content.kind === "godoc") {
+            const tab = config.tabs.find((candidate) => candidate.slug === content.tabSlug);
+            if (!tab?.godoc)
+                return;
+            log(`rebuilding godoc tab "${tab.label}"`);
+            const { pages, navTab } = await loadGodocTab(tab.godoc, tab.slug, tab.label, {
+                repo: config.repo,
+                editBranch: config.editBranch,
+                editBasePath: tab.godoc.sourceBasePath,
+            });
+            if (cache !== snapshot)
+                return;
+            for (const [key, page] of data.pageMap) {
+                if (page.tabSlug === content.tabSlug)
+                    data.pageMap.delete(key);
+            }
+            for (const [slug, page] of pages) {
+                const outputPath = pageOutputPath(tab.slug, slug, config.prettyUrls);
+                data.pageMap.set(outputPath, {
+                    outputPath,
+                    spec: data.primarySpec,
+                    currentPage: { kind: "markdown", markdown: page },
+                    tabSlug: tab.slug,
+                    pageSlug: slug,
+                });
+            }
+            const idx = data.siteTabs.findIndex((candidate) => candidate.slug === content.tabSlug);
+            if (idx !== -1)
+                data.siteTabs[idx] = navTab;
+            else
+                data.siteTabs.push(navTab);
+        }
         else if (content.kind === "openapi") {
             log(`reparsing spec ${shortPath(content.specPath)}`);
             const loaded = await loadSpec(content.specPath);
@@ -191,7 +233,7 @@ export async function startDevServer(options) {
             if (cache !== snapshot)
                 return;
             data.specsBySlug.set(content.tabSlug, spec);
-            const pageKey = tabPath(content.tabSlug, "index.html");
+            const pageKey = tabIndexOutputPath(content.tabSlug, config.prettyUrls);
             const existing = data.pageMap.get(pageKey);
             if (existing) {
                 existing.currentPage = { kind: "spec", spec };
@@ -214,7 +256,7 @@ export async function startDevServer(options) {
             if (cache !== snapshot)
                 return;
             data.specsBySlug.set(content.tabSlug, spec);
-            const pageKey = tabPath(content.tabSlug, "index.html");
+            const pageKey = tabIndexOutputPath(content.tabSlug, config.prettyUrls);
             const existing = data.pageMap.get(pageKey);
             if (existing) {
                 existing.currentPage = { kind: "spec", spec };
@@ -250,10 +292,15 @@ export async function startDevServer(options) {
             pagePath = firstKey;
         }
         if (!pagePath.endsWith(".html")) {
-            pagePath += "/index.html";
+            if (config.prettyUrls === "strip") {
+                pagePath += ".html";
+            }
+            else {
+                pagePath += "/index.html";
+            }
         }
         let pageData = data.pageMap.get(pagePath);
-        if (!pageData && 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);

package/dist/index.d.ts

@@ -30,6 +30,7 @@ export interface SiteBuildResult {
     outputDir: string;
     pageCount: number;
     changelogDiagnostics: ChangelogDiagnostic[];
+    godocDiagnostics: import("./core/godoc-loader.js").GodocLoaderDiagnostic[];
     /** @internal specs by tab slug, for buildDocs compat */
     _specs?: Map<string, NormalizedSpec>;
 }

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;AAkBlD,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,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;AAyED,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,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"}

package/dist/index.js

@@ -6,7 +6,6 @@ import { buildSiteNavigation } from "./core/navigation.js";
 import { buildSearchIndex } from "./core/search-indexer.js";
 import { generateLlmsTxt, generateLlmsFullTxt } from "./renderer/llms.js";
 import { assembleSite, buildSiteConfig, collectDocsPagesByTab, createMinimalSpec, enforceChangelogDiagnostics, } from "./site-assembly.js";
-import { toPublicPath } from "./site-url.js";
 /**
  * Build API documentation from a single OpenAPI/Swagger spec.
  * Wraps the spec in a single-tab site and renders through the modern layout.
@@ -42,11 +41,6 @@ export async function buildSiteDocs(options = {}) {
     const llmsFullTxt = generateLlmsFullTxt(sitePages, navigation, site);
     const extraFiles = new Map(assembled.extraFiles);
     const ogImages = new Map();
-    if (config.prettyUrls === "strip") {
-        const rules = buildStripRedirectRules(sitePages, config.baseUrl);
-        if (rules)
-            extraFiles.set("_redirects", rules);
-    }
     if (!config.ogImage) {
         const { generateOgImage } = await import("./og/generate-og-image.js");
         const CONCURRENCY = 8;
@@ -98,6 +92,7 @@ export async function buildSiteDocs(options = {}) {
         outputDir,
         pageCount: sitePages.length,
         changelogDiagnostics: assembled.changelogDiagnostics,
+        godocDiagnostics: assembled.godocDiagnostics,
         _specs: assembled.specsBySlug,
     };
 }
@@ -128,33 +123,6 @@ function describePageForOg(page, defaultSiteName, changelogPermalinkOg) {
     }
     return { title: `${defaultSiteName} Reference` };
 }
-/**
- * Build Netlify/Cloudflare-Pages redirect rules that canonicalise every page onto
- * its extensionless, slash-less URL. Emitted only when `prettyUrls === "strip"`.
- *
- * For each page at `dir/slug/index.html` the user sees `/dir/slug`; redirect
- * `/dir/slug/` and (for backwards compatibility with pre-rename bookmarks)
- * `/dir/slug.html` onto it.
- */
-function buildStripRedirectRules(pages, baseUrl) {
-    const lines = [
-        "# Generated by Sourcey: pretty URL canonicalisation",
-    ];
-    const seen = new Set();
-    for (const page of pages) {
-        const canonical = toPublicPath(page.outputPath, baseUrl, "strip");
-        if (canonical === "/" || canonical === "")
-            continue;
-        if (seen.has(canonical))
-            continue;
-        seen.add(canonical);
-        // Trailing-slash variant (what the file system would naturally serve).
-        lines.push(`${canonical}/ ${canonical} 301`);
-        // Stale `.html` bookmarks from before the migration.
-        lines.push(`${canonical}.html ${canonical} 301`);
-    }
-    return lines.length > 1 ? `${lines.join("\n")}\n` : null;
-}
 function summarizeVersion(version) {
     if (version.summary)
         return version.summary;

package/dist/site-assembly.d.ts

@@ -1,3 +1,4 @@
+import { type GodocLoaderDiagnostic } from "./core/godoc-loader.js";
 import type { PrettyUrls, ResolvedConfig, ResolvedTab } from "./config.js";
 import type { DocsPage } from "./core/markdown-loader.js";
 import type { SiteTab } from "./core/navigation.js";
@@ -10,9 +11,11 @@ export interface SiteAssembly {
     specsBySlug: Map<string, NormalizedSpec>;
     pageMap: Map<string, SitePage>;
     changelogDiagnostics: ChangelogDiagnostic[];
+    godocDiagnostics: GodocLoaderDiagnostic[];
     extraFiles: Map<string, string | Buffer>;
 }
 export declare function assembleSite(config: ResolvedConfig): Promise<SiteAssembly>;
+export declare function formatGodocDiagnostic(diag: GodocLoaderDiagnostic): string;
 export declare function collectDocsPagesByTab(pageMap: Map<string, SitePage>, tabs: ResolvedTab[]): Map<string, DocsPage[]>;
 export declare function rebuildMarkdownTabNavigation(pageMap: Map<string, SitePage>, siteTabs: SiteTab[], tabs: ResolvedTab[], tabSlug: string, prettyUrls: PrettyUrls): void;
 export declare function enforceChangelogDiagnostics(diagnostics: ChangelogDiagnostic[], strictChangelog?: boolean): void;

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

@@ -1 +1 @@
-{"version":3,"file":"site-assembly.d.ts","sourceRoot":"","sources":["../src/site-assembly.ts"],"names":[],"mappings":"AAYA,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,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;CAC1C;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAgGhF;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;AAED,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;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,CA0HhF;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;AAED,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"}

package/dist/site-assembly.js

@@ -7,9 +7,10 @@ import { normalizeSpec } from "./core/normalizer.js";
 import { normalizeMcpSpec } from "./core/mcp-normalizer.js";
 import { loadDocsPage, slugFromPath } from "./core/markdown-loader.js";
 import { loadDoxygenTab } from "./core/doxygen-loader.js";
+import { loadGodocTab } from "./core/godoc-loader.js";
 import { buildNavFromSpec, buildNavFromPages } from "./core/navigation.js";
 import { generateChangelogFeeds } from "./renderer/changelog-feed.js";
-import { pageOutputPath, tabPath } from "./config.js";
+import { pageOutputPath, tabIndexOutputPath, tabPath } from "./config.js";
 import { toPublicUrl } from "./site-url.js";
 export async function assembleSite(config) {
     const specsBySlug = await loadSpecs(config.tabs);
@@ -17,14 +18,16 @@ export async function assembleSite(config) {
     const pageMap = new Map();
     const siteTabs = [];
     const changelogDiagnostics = [];
+    const godocDiagnostics = [];
     for (const tab of config.tabs) {
         if (tab.openapi || tab.mcp) {
             const spec = specsBySlug.get(tab.slug);
             const navTab = buildNavFromSpec(spec, tab.slug, config.prettyUrls);
             navTab.label = tab.label;
             siteTabs.push(navTab);
-            pageMap.set(tabPath(tab.slug, "index.html"), {
-                outputPath: tabPath(tab.slug, "index.html"),
+            const outputPath = tabIndexOutputPath(tab.slug, config.prettyUrls);
+            pageMap.set(outputPath, {
+                outputPath,
                 currentPage: { kind: "spec", spec },
                 spec,
                 tabSlug: tab.slug,
@@ -47,6 +50,26 @@ export async function assembleSite(config) {
             siteTabs.push(navTab);
             continue;
         }
+        if (tab.godoc) {
+            const { pages, navTab, diagnostics } = await loadGodocTab(tab.godoc, tab.slug, tab.label, {
+                repo: config.repo,
+                editBranch: config.editBranch,
+                editBasePath: tab.godoc.sourceBasePath,
+            });
+            godocDiagnostics.push(...diagnostics);
+            for (const [slug, page] of pages) {
+                const outputPath = pageOutputPath(tab.slug, slug, config.prettyUrls);
+                pageMap.set(outputPath, {
+                    outputPath,
+                    currentPage: { kind: "markdown", markdown: page },
+                    spec: primarySpec,
+                    tabSlug: tab.slug,
+                    pageSlug: slug,
+                });
+            }
+            siteTabs.push(navTab);
+            continue;
+        }
         if (!tab.groups)
             continue;
         const pagesByPath = new Map();
@@ -82,7 +105,7 @@ export async function assembleSite(config) {
         siteTabs.push(buildNavFromPages(tab, pagesByPath, config.prettyUrls));
     }
     if (config.changelog.permalinks) {
-        addPermalinkPages(pageMap);
+        addPermalinkPages(pageMap, config.prettyUrls);
     }
     const sitePages = Array.from(pageMap.values());
     resolveInternalLinks(sitePages, config);
@@ -93,13 +116,20 @@ export async function assembleSite(config) {
         specsBySlug,
         pageMap,
         changelogDiagnostics,
+        godocDiagnostics,
         extraFiles,
     };
 }
+export function formatGodocDiagnostic(diag) {
+    const sev = diag.severity.toUpperCase();
+    const where = diag.package ? ` [${diag.package}]` : "";
+    const loc = diag.file ? ` ${diag.file}${diag.line ? `:${diag.line}` : ""}` : "";
+    return `[${sev}] ${diag.code}${where}${loc} ${diag.message}`;
+}
 export function collectDocsPagesByTab(pageMap, tabs) {
     const docsPagesByTab = new Map();
     for (const tab of tabs) {
-        if (!tab.groups && !tab.doxygen)
+        if (!tab.groups && !tab.doxygen && !tab.godoc)
             continue;
         const tabPages = [];
         for (const [, page] of pageMap) {
@@ -256,7 +286,7 @@ function attachChangelogFeeds(pages, config) {
         const changelog = page.currentPage.changelog;
         const versionHref = (version) => {
             if (config.changelog.permalinks) {
-                return toPublicUrl(tabPath(page.tabSlug, `${changelog.slug}/${version.id}/index.html`), config.siteUrl, config.baseUrl, config.prettyUrls);
+                return toPublicUrl(pageOutputPath(page.tabSlug, `${changelog.slug}/${version.id}`, config.prettyUrls), config.siteUrl, config.baseUrl, config.prettyUrls);
             }
             return `${toPublicUrl(page.outputPath, config.siteUrl, config.baseUrl, config.prettyUrls)}#${version.id}`;
         };
@@ -297,7 +327,7 @@ function attachChangelogFeeds(pages, config) {
     }
     return extraFiles;
 }
-function addPermalinkPages(pageMap) {
+function addPermalinkPages(pageMap, prettyUrls) {
     const changelogPages = Array.from(pageMap.values()).filter(isMainChangelogSitePage);
     for (const page of changelogPages) {
         const changelog = page.currentPage.changelog;
@@ -309,7 +339,7 @@ function addPermalinkPages(pageMap) {
                 headings: [],
                 permalinkVersionId: version.id,
             };
-            const outputPath = tabPath(page.tabSlug, `${changelog.slug}/${version.id}/index.html`);
+            const outputPath = pageOutputPath(page.tabSlug, `${changelog.slug}/${version.id}`, prettyUrls);
             pageMap.set(outputPath, {
                 outputPath,
                 currentPage: { kind: "changelog", changelog: permalinkPage },
@@ -407,9 +437,7 @@ function resolveInternalHref(href, outputPath, docsSourcePath, pathMap, sourceBa
     const [path, hash] = href.split("#", 2);
     const hashSuffix = hash ? `#${hash}` : "";
     const sourcePath = path.replace(/\\/g, "/");
-    const clean = sourcePath.replace(/^\/+/, "").replace(/\/+$/, "").replace(/\.(md|mdx)$/, "");
-    if (clean.endsWith(".html"))
-        return null;
+    const clean = sourcePath.replace(/^\/+/, "").replace(/\/+$/, "").replace(/\.(md|mdx|html)$/, "");
     const pageDir = outputPath.includes("/")
         ? outputPath.substring(0, outputPath.lastIndexOf("/"))
         : "";
@@ -457,6 +485,9 @@ function resolveInternalHref(href, outputPath, docsSourcePath, pathMap, sourceBa
 function toPrettyLink(target, prettyUrls) {
     if (!prettyUrls)
         return target;
+    if (prettyUrls === "strip" && target.endsWith(".html")) {
+        return target.slice(0, -(".html".length));
+    }
     if (target === "index.html")
         return "";
     if (target.endsWith("/index.html")) {

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

@@ -1 +1 @@
-{"version":3,"file":"site-url.d.ts","sourceRoot":"","sources":["../src/site-url.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoBrE;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,SAAK,EAAE,UAAU,GAAE,UAAkB,GAAG,MAAM,CAkBrG;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,SAAK,EACZ,UAAU,GAAE,UAAkB,GAC7B,MAAM,CAER;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,CAcnE"}
+{"version":3,"file":"site-url.d.ts","sourceRoot":"","sources":["../src/site-url.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;AAEnD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAoBrE;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,SAAK,EAAE,UAAU,GAAE,UAAkB,GAAG,MAAM,CAsBrG;AAED,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1E;AAED,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,SAAK,EACZ,UAAU,GAAE,UAAkB,GAC7B,MAAM,CAER;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,CAcnE"}

package/dist/site-url.js

@@ -41,6 +41,9 @@ export function toPublicPath(outputPath, baseUrl = "", prettyUrls = false) {
         }
         return `${prefix}${withSlash}`;
     }
+    if (prettyUrls === "strip" && cleanOutputPath.endsWith(".html")) {
+        return `${prefix}${cleanOutputPath.slice(0, -(".html".length))}`;
+    }
     return `${prefix}${cleanOutputPath}`;
 }
 export function toAbsoluteUrl(publicPath, siteUrl) {

package/dist/themes/default/sourcey.css

@@ -1593,3 +1593,247 @@ h1[id], h2[id], h3[id], h4[id], h5[id], h6[id] {
   color: rgb(var(--color-gray-500));
   font-size: 0.8125rem;
 }
+
+/* ── Godoc rendering ─────────────────────────────────────────────── */
+
+#sourcey .godoc-import,
+#sourcey .godoc-import-path {
+  font-size: 0.8125rem;
+  color: rgb(var(--color-gray-500));
+  margin: 0.25rem 0 1.5rem;
+}
+
+#sourcey .godoc-import code,
+#sourcey .godoc-import-path code {
+  font-family: var(--font-mono);
+  background: rgba(var(--color-gray-100), 0.6);
+  padding: 0.125rem 0.375rem;
+  border-radius: 3px;
+}
+
+#sourcey .godoc-source {
+  margin: -0.25rem 0 0.625rem;
+  font-size: 0.75rem;
+  color: rgb(var(--color-gray-500));
+}
+
+#sourcey .godoc-source a {
+  color: inherit;
+  text-decoration: none;
+}
+
+#sourcey .godoc-source a:hover {
+  color: rgb(var(--color-primary-ink));
+}
+
+#sourcey .godoc-toc {
+  margin: 1.5rem 0 2.5rem;
+  padding: 0.875rem 1rem;
+  border: 1px solid rgb(var(--color-gray-200));
+  border-radius: 6px;
+  background: rgba(var(--color-gray-50), 0.5);
+}
+
+#sourcey .godoc-toc h4 {
+  margin: 0 0 0.5rem;
+  font-size: 0.6875rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: rgb(var(--color-gray-500));
+}
+
+#sourcey .godoc-toc ul {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  font-size: 0.8125rem;
+}
+
+#sourcey .godoc-toc li {
+  margin: 0.125rem 0;
+}
+
+#sourcey .godoc-toc li.godoc-toc-sub {
+  padding-left: 1rem;
+  font-family: var(--font-mono);
+  font-size: 0.75rem;
+  color: rgb(var(--color-gray-600));
+}
+
+#sourcey .godoc-toc a {
+  color: inherit;
+  text-decoration: none;
+  border-bottom: 1px dotted transparent;
+}
+
+#sourcey .godoc-toc a:hover {
+  color: rgb(var(--color-primary));
+  border-bottom-color: currentColor;
+}
+
+#sourcey .godoc-symbol {
+  font-family: var(--font-mono);
+  font-size: 0.95rem;
+  font-weight: 600;
+  margin: 1.75rem 0 0.5rem;
+  color: rgb(var(--color-gray-900));
+  scroll-margin-top: 5rem;
+}
+
+#sourcey .godoc-doc {
+  margin: 0.5rem 0 0.75rem;
+  color: rgb(var(--color-gray-700));
+  font-size: 0.9375rem;
+  line-height: 1.65;
+}
+
+#sourcey .godoc-doc p:first-child {
+  margin-top: 0;
+}
+
+#sourcey .godoc-doc p:last-child {
+  margin-bottom: 0;
+}
+
+#sourcey .godoc-value,
+#sourcey .godoc-func,
+#sourcey .godoc-type {
+  margin: 1rem 0 1.5rem;
+  scroll-margin-top: 5rem;
+}
+
+#sourcey .godoc-type {
+  border-top: 1px solid rgb(var(--color-gray-200));
+  padding-top: 1.25rem;
+  margin-top: 2rem;
+}
+
+#sourcey .godoc-anchor {
+  display: block;
+  height: 0;
+  scroll-margin-top: 5rem;
+}
+
+#sourcey .godoc-fields {
+  margin: 0.75rem 0 1rem;
+  padding: 0;
+  border: 1px solid rgb(var(--color-gray-200));
+  border-radius: 6px;
+  background: rgba(var(--color-gray-50), 0.4);
+}
+
+#sourcey .godoc-fields > summary {
+  cursor: pointer;
+  padding: 0.5rem 0.875rem;
+  font-size: 0.75rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: rgb(var(--color-gray-600));
+  list-style: none;
+}
+
+#sourcey .godoc-fields > summary::-webkit-details-marker {
+  display: none;
+}
+
+#sourcey .godoc-fields > ul {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  border-top: 1px solid rgb(var(--color-gray-200));
+}
+
+#sourcey .godoc-field {
+  padding: 0.625rem 0.875rem;
+  border-bottom: 1px solid rgb(var(--color-gray-200));
+  font-size: 0.875rem;
+}
+
+#sourcey .godoc-field:last-child {
+  border-bottom: none;
+}
+
+#sourcey .godoc-field-sig {
+  font-family: var(--font-mono);
+  font-size: 0.8125rem;
+  font-weight: 600;
+  color: rgb(var(--color-gray-900));
+  background: transparent;
+  padding: 0;
+}
+
+#sourcey .godoc-field-type {
+  font-weight: 400;
+  color: rgb(var(--color-gray-700));
+}
+
+#sourcey .godoc-tag {
+  font-family: var(--font-mono);
+  font-size: 0.75rem;
+  color: rgb(var(--color-gray-500));
+  background: transparent;
+  padding: 0;
+  margin-left: 0.5rem;
+}
+
+#sourcey .godoc-field-doc {
+  margin-top: 0.25rem;
+  font-size: 0.8125rem;
+  color: rgb(var(--color-gray-600));
+  line-height: 1.55;
+}
+
+#sourcey .godoc-example {
+  margin: 0.75rem 0 1.25rem;
+  padding: 0;
+  border: 1px solid rgb(var(--color-gray-200));
+  border-radius: 6px;
+  background: rgba(var(--color-gray-50), 0.4);
+}
+
+#sourcey .godoc-example > summary {
+  cursor: pointer;
+  padding: 0.5rem 0.875rem;
+  font-size: 0.75rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: rgb(var(--color-gray-600));
+  list-style: none;
+}
+
+#sourcey .godoc-example > summary::-webkit-details-marker {
+  display: none;
+}
+
+#sourcey .godoc-example > summary::before {
+  content: "▸ ";
+  color: rgb(var(--color-gray-400));
+  margin-right: 0.25rem;
+}
+
+#sourcey .godoc-example[open] > summary::before {
+  content: "▾ ";
+}
+
+#sourcey .godoc-example > pre,
+#sourcey .godoc-example > .godoc-doc,
+#sourcey .godoc-example > p {
+  margin: 0.5rem 0.875rem;
+}
+
+#sourcey .godoc-example-output-label {
+  margin: 0.5rem 0.875rem 0;
+  font-size: 0.6875rem;
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.04em;
+  color: rgb(var(--color-gray-500));
+}
+
+#sourcey .godoc-func .godoc-symbol,
+#sourcey .godoc-type .godoc-symbol {
+  word-break: break-word;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sourcey",
-  "version": "3.5.1",
-  "description": "Precision documentation from OpenAPI, MCP, Doxygen, and Markdown. Static HTML you own.",
+  "version": "3.5.3",
+  "description": "Precision documentation from OpenAPI, MCP, Doxygen, godoc, and Markdown. Static HTML you own.",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -20,13 +20,16 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "tsc && cp -r src/themes dist/ && cp src/client/*.js dist/client/ && cp -r src/og/fonts dist/og/",
+    "build": "tsc && cp -r src/themes dist/ && cp src/client/*.js dist/client/ && cp -r src/og/fonts dist/og/ && rm -rf dist/core/sourcey-godoc dist/core/godoc-introspect && mkdir -p dist/core/sourcey-godoc && cp -R go/sourcey-godoc/go.mod go/sourcey-godoc/doc.go go/sourcey-godoc/cmd dist/core/sourcey-godoc/",
     "watch": "npm run build && tsc --watch --preserveWatchOutput",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src/ test/",
     "lint:fix": "eslint src/ test/ --fix",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "godoc:go:test": "cd go/sourcey-godoc && go test ./...",
+    "godoc:go:vet": "cd go/sourcey-godoc && go vet ./...",
+    "godoc:packages:test": "packaging/sourcey-godoc/render-package-managers.test.sh",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },
@@ -72,7 +75,14 @@
     "markdown",
     "api-docs",
     "developer-documentation",
-    "doxygen"
+    "doxygen",
+    "godoc",
+    "golang",
+    "go-docs",
+    "go-documentation",
+    "mcp",
+    "llms-txt",
+    "static-docs"
   ],
   "funding": {
     "url": "https://sourcey.com"