sourcey 3.5.1 → 3.5.2

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,CAyHhF;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,6 +7,7 @@ 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";
@@ -17,6 +18,7 @@ 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);
@@ -47,6 +49,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();
@@ -93,13 +115,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) {

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.2",
+  "description": "Precision documentation from OpenAPI, MCP, Doxygen, godoc, and Markdown. Static HTML you own.",
   "type": "module",
   "engines": {
     "node": ">=20"
@@ -20,13 +20,15 @@
     "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 ./...",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },
@@ -72,7 +74,14 @@
     "markdown",
     "api-docs",
     "developer-documentation",
-    "doxygen"
+    "doxygen",
+    "godoc",
+    "golang",
+    "go-docs",
+    "go-documentation",
+    "mcp",
+    "llms-txt",
+    "static-docs"
   ],
   "funding": {
     "url": "https://sourcey.com"