sourcey 3.6.0 → 3.6.1

package/README.md

@@ -12,6 +12,8 @@ No dashboard. No runtime. No API calls to render your own documentation.
 [![license](https://img.shields.io/npm/l/sourcey)](LICENSE)
 [![Go Reference](https://pkg.go.dev/badge/github.com/sourcey/sourcey/go/sourcey-godoc.svg)](https://pkg.go.dev/github.com/sourcey/sourcey/go/sourcey-godoc)
 [![Go Report Card](https://goreportcard.com/badge/github.com/sourcey/sourcey/go/sourcey-godoc)](https://goreportcard.com/report/github.com/sourcey/sourcey/go/sourcey-godoc)
+[![crates.io](https://img.shields.io/crates/v/sourcey.svg)](https://crates.io/crates/sourcey)
+[![docs.rs](https://docs.rs/sourcey/badge.svg)](https://docs.rs/sourcey)
 
 ```bash
 npx sourcey init
@@ -31,6 +33,7 @@ npx sourcey init
 - **Product story pages**: changelog, roadmap pages, examples, reference material, search, and portable context exports in one source-owned site
 - **C++ and Doxygen**: feed Doxygen XML output, get modern searchable API docs with exact member search, source links, templates, qualifiers, examples, inherited members, and relationship sections. No new parser, no four-tool Breathe/Exhale/Sphinx pipeline
 - **Go and godoc**: native package documentation extracted from Go source via the toolchain. Render Go modules as Sourcey tabs, generate standalone static Go docs sites, or commit `godoc.json` snapshots for JS-only docs hosts. No Doxygen detour
+- **Rust and rustdoc**: native API documentation from nightly rustdoc JSON, with doctests as a first-class extracted view. URL-encoded parametric impl anchors for deep-link parity with doc.rust-lang.org. Snapshot mode lets CI build on stable Rust toolchains. Aggregated doctests index across the workspace
 - **Context exports**: auto-generate llms.txt and llms-full.txt alongside your HTML as alternate views of the same documentation graph
 - **TypeScript config**: `sourcey.config.ts` with `defineConfig()` autocomplete; theme, navbar, CTA buttons, footer
 - **Theme presets**: default (sidebar + TOC), minimal (single column), api-first (Stripe-style three column); colors, fonts, layout dimensions, and custom CSS on top
@@ -44,7 +47,7 @@ npx sourcey init
 
 ### Sourcey CLI
 
-The full Sourcey binary handles OpenAPI, Doxygen, godoc, MCP, and Markdown sources.
+The full Sourcey binary handles OpenAPI, MCP, Doxygen, godoc, rustdoc, MkDocs, and Markdown sources.
 
 | Path     | Command                                        | Requires          |
 | -------- | ---------------------------------------------- | ----------------- |
@@ -93,7 +96,7 @@ export default defineConfig({
 });
 ```
 
-Each tab has one `source`, usually created with `markdown()`, `mkdocs()`, `openapi()`, `mcp()`, `doxygen()`, or `godoc()`. Pages are referenced by slug (e.g. `"quickstart"` resolves to `quickstart.md`). See [docs/configuration.md](docs/configuration.md) for theme, navbar, footer, logo, and full tab options.
+Each tab has one `source`, usually created with `markdown()`, `mkdocs()`, `openapi()`, `mcp()`, `doxygen()`, `godoc()`, or `rustdoc()`. Pages are referenced by slug (e.g. `"quickstart"` resolves to `quickstart.md`). See [docs/configuration.md](docs/configuration.md) for theme, navbar, footer, logo, and full tab options.
 
 ### Go documentation (godoc)
 

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import type { DoxygenSourceOptions, GodocSourceOptions, MarkdownSourceOptions, McpSourceOptions, MkDocsSourceOptions, OpenApiSourceOptions, SourceAdapter } from "./types.js";
+import type { DoxygenSourceOptions, GodocSourceOptions, MarkdownSourceOptions, McpSourceOptions, MkDocsSourceOptions, OpenApiSourceOptions, RustdocSourceOptions, SourceAdapter } from "./types.js";
 import { assertLocalPath } from "./shared.js";
 export declare function openapi(specOrOptions: string | OpenApiSourceOptions): SourceAdapter;
 export declare function mcp(specOrOptions: string | McpSourceOptions): SourceAdapter;
@@ -6,6 +6,7 @@ export declare function markdown(options: MarkdownSourceOptions): SourceAdapter;
 export declare function mkdocs(configOrOptions: string | MkDocsSourceOptions): SourceAdapter;
 export declare function doxygen(options: DoxygenSourceOptions): SourceAdapter;
 export declare function godoc(configOrPath: GodocSourceOptions): SourceAdapter;
+export declare function rustdoc(configOrPath: RustdocSourceOptions): SourceAdapter;
 export { assertLocalPath };
-export type { DoxygenSourceOptions, GodocSourceOptions, MarkdownSourceOptions, McpSourceOptions, MkDocsSourceOptions, OpenApiSourceOptions, PageMarkdownOptions, ResolvedTabSource, SourceAdapter, SourceAdapterContext, } from "./types.js";
+export type { DoxygenSourceOptions, GodocSourceOptions, MarkdownSourceOptions, McpSourceOptions, MkDocsSourceOptions, OpenApiSourceOptions, PageMarkdownOptions, ResolvedTabSource, RustdocSourceOptions, SourceAdapter, SourceAdapterContext, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAuC,MAAM,aAAa,CAAC;AAGnF,wBAAgB,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,GAAG,aAAa,CAanF;AAED,wBAAgB,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,GAAG,aAAa,CAa3E;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,CAWtE;AAED,wBAAgB,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,mBAAmB,GAAG,aAAa,CAInF;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAsBpE;AAED,wBAAgB,KAAK,CAAC,YAAY,EAAE,kBAAkB,GAAG,aAAa,CA6BrE;AAMD,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,EACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,eAAe,EAAuC,MAAM,aAAa,CAAC;AAGnF,wBAAgB,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,oBAAoB,GAAG,aAAa,CAanF;AAED,wBAAgB,GAAG,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,GAAG,aAAa,CAa3E;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa,CAWtE;AAED,wBAAgB,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,mBAAmB,GAAG,aAAa,CAInF;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAsBpE;AAED,wBAAgB,KAAK,CAAC,YAAY,EAAE,kBAAkB,GAAG,aAAa,CA6BrE;AAED,wBAAgB,OAAO,CAAC,YAAY,EAAE,oBAAoB,GAAG,aAAa,CAmCzE;AAMD,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/adapters/index.js

@@ -1,4 +1,3 @@
-import { resolve } from "node:path";
 import { assertLocalPath, resolveMarkdownGroups, toWatchPaths } from "./shared.js";
 import { mkdocs as mkdocsAdapter } from "./mkdocs.js";
 export function openapi(specOrOptions) {
@@ -49,7 +48,7 @@ export function doxygen(options) {
     return {
         name: "doxygen",
         async resolve(ctx) {
-            const absXml = ctx.resolvePath(options.xml);
+            const absXml = assertLocalPath(ctx, options.xml, "Doxygen XML directory");
             await ctx.assertExists(absXml, `Doxygen XML directory "${options.xml}" in tab "${ctx.tabName}"`);
             return {
                 kind: "doxygen",
@@ -70,7 +69,7 @@ export function godoc(configOrPath) {
         name: "godoc",
         async resolve(ctx) {
             const cfg = typeof configOrPath === "string" ? { module: configOrPath } : configOrPath;
-            const moduleAbs = resolve(ctx.configDir, cfg.module ?? ".");
+            const moduleAbs = assertLocalPath(ctx, cfg.module ?? ".", "Go module directory");
             await ctx.assertExists(moduleAbs, `Go module directory "${cfg.module ?? "."}" in tab "${ctx.tabName}"`);
             const snapshotAbs = cfg.snapshot ? ctx.resolvePath(cfg.snapshot) : undefined;
             return {
@@ -92,6 +91,39 @@ export function godoc(configOrPath) {
         },
     };
 }
+export function rustdoc(configOrPath) {
+    return {
+        name: "rustdoc",
+        async resolve(ctx) {
+            const cfg = typeof configOrPath === "string" ? { manifest: configOrPath } : configOrPath;
+            const manifestAbs = assertLocalPath(ctx, cfg.manifest ?? ".", "Cargo manifest");
+            await ctx.assertExists(manifestAbs, `Cargo manifest "${cfg.manifest ?? "."}" in tab "${ctx.tabName}"`);
+            const snapshotAbs = cfg.snapshot ? ctx.resolvePath(cfg.snapshot) : undefined;
+            const features = {
+                default: cfg.features?.default ?? true,
+                list: cfg.features?.list ?? [],
+                all: cfg.features?.all ?? false,
+            };
+            return {
+                kind: "rustdoc",
+                config: {
+                    manifest: manifestAbs,
+                    crates: cfg.crates?.length ? cfg.crates : [],
+                    snapshot: snapshotAbs,
+                    mode: cfg.mode ?? "auto",
+                    features,
+                    includePrivate: cfg.includePrivate ?? false,
+                    includeHidden: cfg.includeHidden ?? false,
+                    target: cfg.target,
+                    toolchain: cfg.toolchain ?? "nightly",
+                    sourceBasePath: trimSlashes(cfg.sourceBasePath ?? ""),
+                    doctestsIndex: cfg.doctestsIndex ?? true,
+                },
+                watchPaths: toWatchPaths([snapshotAbs]),
+            };
+        },
+    };
+}
 function trimSlashes(value) {
     return value.replace(/^\/+|\/+$/g, "");
 }

package/dist/adapters/types.d.ts

@@ -1,5 +1,5 @@
 import type { MarkdownPreprocessor } from "../core/markdown-loader.js";
-import type { DoxygenConfig, GodocConfig, GroupConfig, ResolvedDoxygenConfig, ResolvedGodocConfig, ResolvedGroup } from "../config.js";
+import type { DoxygenConfig, GodocConfig, GroupConfig, ResolvedDoxygenConfig, ResolvedGodocConfig, ResolvedGroup, ResolvedRustdocConfig, RustdocConfig } from "../config.js";
 export interface SourceAdapterContext {
     configDir: string;
     tabName: string;
@@ -46,7 +46,12 @@ export interface ResolvedGodocSource {
     config: ResolvedGodocConfig;
     watchPaths?: string[];
 }
-export type ResolvedTabSource = ResolvedOpenApiSource | ResolvedMcpSource | ResolvedMarkdownSource | ResolvedDoxygenSource | ResolvedGodocSource;
+export interface ResolvedRustdocSource {
+    kind: "rustdoc";
+    config: ResolvedRustdocConfig;
+    watchPaths?: string[];
+}
+export type ResolvedTabSource = ResolvedOpenApiSource | ResolvedMcpSource | ResolvedMarkdownSource | ResolvedDoxygenSource | ResolvedGodocSource | ResolvedRustdocSource;
 export interface MarkdownSourceOptions {
     groups: GroupConfig[];
 }
@@ -61,6 +66,7 @@ export interface MkDocsSourceOptions {
 }
 export type DoxygenSourceOptions = DoxygenConfig;
 export type GodocSourceOptions = GodocConfig | string;
+export type RustdocSourceOptions = RustdocConfig | string;
 export interface PageMarkdownOptions {
     sourceRoot?: string;
     preprocess?: MarkdownPreprocessor[];

package/dist/adapters/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACvE,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,aAAa,EACd,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAClC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,aAAa,CAAC,SAAS,SAAS,iBAAiB,GAAG,iBAAiB;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,GACrB,iBAAiB,GACjB,sBAAsB,GACtB,qBAAqB,GACrB,mBAAmB,CAAC;AAExB,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,CAAC;AACjD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACrC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -7,7 +7,7 @@ import { loadConfig } from "./config.js";
 import { runIntrospector, GodocIntrospectorError } from "./core/godoc-introspector.js";
 import { GODOC_SCHEMA_VERSION } from "./core/godoc-types.js";
 import { init } from "./init.js";
-import { formatChangelogDiagnostic, formatGodocDiagnostic } from "./site-assembly.js";
+import { formatChangelogDiagnostic, formatGodocDiagnostic, formatRustdocDiagnostic, } from "./site-assembly.js";
 import pkg from "../package.json" with { type: "json" };
 const build = defineCommand({
     meta: {
@@ -84,6 +84,7 @@ const build = defineCommand({
                 if (!args.quiet) {
                     logChangelogDiagnostics(result.changelogDiagnostics);
                     logGodocDiagnostics(result.godocDiagnostics);
+                    logRustdocDiagnostics(result.rustdocDiagnostics);
                     const elapsed = ((Date.now() - startTime) / 1000).toFixed(1);
                     console.log(`  Pages:  ${result.pageCount}`);
                     console.log(`  Output: ${result.outputDir}`);
@@ -129,8 +130,9 @@ const dev = defineCommand({
     },
     async run({ args }) {
         const { startDevServer } = await import("./dev-server.js");
+        const port = parsePort(args.port);
         await startDevServer({
-            port: parseInt(args.port, 10),
+            port,
             host: args.host ?? process.env.HOST,
             config: args.config,
             strictChangelog: args.strictChangelog,
@@ -214,9 +216,15 @@ const godoc = defineCommand({
     },
     async run({ args }) {
         const moduleDir = resolve(process.cwd(), args.module);
-        const patterns = args.packages.split(",").map((p) => p.trim()).filter(Boolean);
+        const patterns = args.packages
+            .split(",")
+            .map((p) => p.trim())
+            .filter(Boolean);
         const exclude = args.exclude
-            ? args.exclude.split(",").map((p) => p.trim()).filter(Boolean)
+            ? args.exclude
+                .split(",")
+                .map((p) => p.trim())
+                .filter(Boolean)
             : [];
         const outputPath = resolve(process.cwd(), args.out);
         try {
@@ -282,36 +290,6 @@ const main = defineCommand({
         validate,
         godoc,
     },
-    args: {
-        spec: {
-            type: "positional",
-            description: "Path to an OpenAPI spec (shorthand for 'sourcey build <spec>')",
-            required: false,
-        },
-    },
-    async run({ args, rawArgs }) {
-        if (rawArgs.includes("init") ||
-            rawArgs.includes("build") ||
-            rawArgs.includes("dev") ||
-            rawArgs.includes("validate") ||
-            rawArgs.includes("godoc"))
-            return;
-        if (args.spec) {
-            await build.run({
-                args: {
-                    _: [],
-                    spec: args.spec,
-                    output: "dist",
-                    embed: false,
-                    config: undefined,
-                    quiet: false,
-                    strictChangelog: false,
-                },
-                rawArgs: [],
-                cmd: build,
-            });
-        }
-    },
 });
 function logChangelogDiagnostics(diagnostics) {
     for (const diagnostic of diagnostics) {
@@ -324,4 +302,20 @@ function logGodocDiagnostics(diagnostics) {
         writer(`  ${formatGodocDiagnostic(diagnostic)}`);
     }
 }
+function logRustdocDiagnostics(diagnostics) {
+    for (const diagnostic of diagnostics) {
+        const writer = diagnostic.severity === "error" ? console.error : console.log;
+        writer(`  ${formatRustdocDiagnostic(diagnostic)}`);
+    }
+}
+function parsePort(value) {
+    if (!/^\d+$/.test(value)) {
+        throw new Error(`Invalid port "${value}". Expected an integer from 1 to 65535.`);
+    }
+    const port = Number(value);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid port "${value}". Expected an integer from 1 to 65535.`);
+    }
+    return port;
+}
 runMain(main);