sourcey 3.6.0 → 3.6.1

package/dist/core/sourcey-rustdoc/src/spec.rs

@@ -0,0 +1,390 @@
+use serde::{Deserialize, Serialize};
+use std::collections::BTreeMap;
+
+pub const SPEC_VERSION: u32 = 1;
+pub const SOURCEY_RUSTDOC_VERSION: &str = env!("CARGO_PKG_VERSION");
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct RustdocSpec {
+    pub version: u32,
+    pub sourcey_rustdoc_version: String,
+    pub rustdoc_format_version: u32,
+    pub rust_toolchain: String,
+    pub generated_at: String,
+    pub crates: Vec<CrateSpec>,
+    /// Diagnostics that apply to the whole snapshot rather than any single
+    /// crate (e.g. `RUSTDOC_FORMAT_VERSION_MISMATCH`).
+    #[serde(default)]
+    pub diagnostics: Vec<Diagnostic>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct CrateSpec {
+    pub name: String,
+    pub version: Option<String>,
+    pub root_module_id: ItemId,
+    pub modules: Vec<ModuleSpec>,
+    /// Item id (string) → Item. Stable lookup keyed by rustdoc's per-snapshot id.
+    pub items: BTreeMap<String, Item>,
+    pub external_crates: Vec<ExternalCrateRef>,
+    pub diagnostics: Vec<Diagnostic>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq, Hash)]
+#[serde(transparent)]
+pub struct ItemId(pub String);
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct ModuleSpec {
+    pub id: ItemId,
+    pub path: Vec<String>,
+    pub docs_markdown: Option<String>,
+    pub doc_aliases: Vec<String>,
+    pub item_ids: Vec<ItemId>,
+    pub sub_module_paths: Vec<Vec<String>>,
+    pub source: Option<SourceLocation>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct SourceLocation {
+    pub file: String,
+    pub line_start: u32,
+    pub line_end: u32,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Item {
+    pub id: ItemId,
+    pub name: Option<String>,
+    pub path: Vec<String>,
+    pub visibility: Visibility,
+    pub source: Option<SourceLocation>,
+    pub docs_markdown: Option<String>,
+    pub doc_aliases: Vec<String>,
+    pub deprecation: Option<Deprecation>,
+    pub stability: Option<Stability>,
+    pub feature_gates: Vec<String>,
+    pub attrs_structured: Vec<String>,
+    /// Intra-doc link table: link label as it appears in the docstring,
+    /// mapped to a resolved target. Internal targets reference a local
+    /// item id; external targets carry enough metadata to render a docs.rs
+    /// or std URL without a second snapshot lookup.
+    pub links: BTreeMap<String, LinkTarget>,
+    pub inner: ItemInner,
+    pub doctests: Vec<Doctest>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(tag = "kind", rename_all = "snake_case")]
+pub enum Visibility {
+    Public,
+    Crate,
+    Restricted { path: String },
+    Default,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Deprecation {
+    pub since: Option<String>,
+    pub note: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Stability {
+    pub level: StabilityLevel,
+    pub since: Option<String>,
+    pub feature: Option<String>,
+    pub issue: Option<u32>,
+}
+
+#[derive(Debug, Clone, Copy, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum StabilityLevel {
+    Stable,
+    Unstable,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(tag = "kind", rename_all = "snake_case")]
+pub enum ItemInner {
+    Function(FunctionItem),
+    Struct(StructItem),
+    Enum(EnumItem),
+    Variant(VariantItem),
+    Union(UnionItem),
+    Trait(TraitItem),
+    TraitAlias(TraitAliasItem),
+    Impl(ImplItem),
+    TypeAlias(TypeAliasItem),
+    Constant(ConstantItem),
+    Static(StaticItem),
+    Macro(MacroItem),
+    ProcMacro(ProcMacroItem),
+    AssocType(AssocTypeItem),
+    AssocConst(AssocConstItem),
+    Use(UseItem),
+    StructField(StructFieldItem),
+    Module,
+    Primitive,
+    ExternType,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct FunctionItem {
+    pub signature: Signature,
+    pub generics: Generics,
+    pub is_const: bool,
+    pub is_async: bool,
+    pub is_unsafe: bool,
+    pub has_body: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct StructItem {
+    pub struct_kind: StructKindKind,
+    pub generics: Generics,
+    pub fields: Vec<ItemId>,
+    pub has_stripped_fields: bool,
+    pub impls: Vec<ItemId>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum StructKindKind {
+    Plain,
+    Tuple,
+    Unit,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct EnumItem {
+    pub generics: Generics,
+    pub variants: Vec<ItemId>,
+    pub has_stripped_variants: bool,
+    pub impls: Vec<ItemId>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct VariantItem {
+    pub variant_kind: VariantKindKind,
+    pub discriminant: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum VariantKindKind {
+    Plain,
+    Tuple,
+    Struct,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct UnionItem {
+    pub generics: Generics,
+    pub fields: Vec<ItemId>,
+    pub has_stripped_fields: bool,
+    pub impls: Vec<ItemId>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct TraitItem {
+    pub is_auto: bool,
+    pub is_unsafe: bool,
+    pub is_dyn_compatible: bool,
+    pub generics: Generics,
+    pub bounds: Vec<String>,
+    pub items: Vec<ItemId>,
+    pub implementations: Vec<ItemId>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct TraitAliasItem {
+    pub generics: Generics,
+    pub bounds: Vec<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct ImplItem {
+    pub generics: Generics,
+    pub trait_path: Option<TypePath>,
+    pub for_type: TypePath,
+    pub items: Vec<ItemId>,
+    pub is_negative: bool,
+    pub is_synthetic: bool,
+    pub is_blanket: bool,
+    pub provided_trait_methods: Vec<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct TypeAliasItem {
+    pub aliased_type: TypePath,
+    pub generics: Generics,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct ConstantItem {
+    pub type_display: String,
+    pub expr: String,
+    pub value: Option<String>,
+    pub is_literal: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct StaticItem {
+    pub type_display: String,
+    pub expr: String,
+    pub is_mutable: bool,
+    pub is_unsafe: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct MacroItem {
+    pub source: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct ProcMacroItem {
+    pub macro_kind: ProcMacroKindKind,
+    pub helpers: Vec<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum ProcMacroKindKind {
+    Bang,
+    Attr,
+    Derive,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct AssocTypeItem {
+    pub generics: Generics,
+    pub bounds: Vec<String>,
+    pub default_display: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct AssocConstItem {
+    pub type_display: String,
+    pub default_display: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct UseItem {
+    pub source: String,
+    pub name: String,
+    pub target_id: Option<ItemId>,
+    pub is_glob: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct StructFieldItem {
+    pub type_display: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Signature {
+    pub display: String,
+    pub tokens: Vec<SigToken>,
+    pub inputs: Vec<SigInput>,
+    pub output_display: Option<String>,
+    pub is_c_variadic: bool,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct SigInput {
+    pub name: String,
+    pub type_display: String,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(tag = "kind", rename_all = "snake_case")]
+pub enum SigToken {
+    Keyword { text: String },
+    Punct { text: String },
+    Generic { text: String },
+    Lifetime { text: String },
+    Type { text: String, target: Option<TypePath> },
+    Whitespace,
+    Newline,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct TypePath {
+    pub crate_id: u32,
+    pub path: Vec<String>,
+    pub display: String,
+    pub external: bool,
+    pub html_root_url: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize, Default)]
+pub struct Generics {
+    pub params: Vec<GenericParam>,
+    pub where_predicates: Vec<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct GenericParam {
+    pub name: String,
+    pub kind: GenericParamKind,
+    pub default_display: Option<String>,
+    pub bounds: Vec<String>,
+}
+
+#[derive(Debug, Clone, Copy, Serialize, Deserialize)]
+#[serde(rename_all = "snake_case")]
+pub enum GenericParamKind {
+    Lifetime,
+    Type,
+    Const,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+#[serde(tag = "kind", rename_all = "snake_case")]
+pub enum LinkTarget {
+    Internal {
+        id: ItemId,
+    },
+    External {
+        crate_name: String,
+        path: Vec<String>,
+        html_root_url: Option<String>,
+    },
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Doctest {
+    pub lang: String,
+    pub fence_attributes: Vec<String>,
+    pub display_code: String,
+    pub executable_code: String,
+    pub implicit_main_wrap: bool,
+    pub source: Option<SourceLocation>,
+    pub ordinal: u32,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct ExternalCrateRef {
+    pub crate_id: u32,
+    pub name: String,
+    pub html_root_url: Option<String>,
+}
+
+#[derive(Debug, Clone, Serialize, Deserialize)]
+pub struct Diagnostic {
+    pub severity: DiagnosticSeverity,
+    pub code: String,
+    pub message: String,
+    pub crate_name: Option<String>,
+    pub file: Option<String>,
+    pub line: Option<u32>,
+}
+
+#[derive(Debug, Clone, Copy, Serialize, Deserialize, PartialEq, Eq)]
+#[serde(rename_all = "snake_case")]
+pub enum DiagnosticSeverity {
+    Error,
+    Warning,
+    Info,
+}

package/dist/core/sourcey-rustdoc/tests/format_version.rs

@@ -0,0 +1,45 @@
+//! Integration tests that prove the format-version handshake.
+//!
+//! These tests do NOT invoke cargo; they synthesise tiny JSON blobs that
+//! exercise the load path's format_version check.
+
+use serde_json::json;
+
+/// A snapshot with a format_version older than the pinned value must produce
+/// a clear failure that the user can act on.
+#[test]
+fn rejects_stale_format_version() {
+    let expected = rustdoc_types::FORMAT_VERSION;
+    let stale = expected.saturating_sub(1);
+    let blob = json!({
+        "format_version": stale,
+        "crate_version": null,
+        "includes_private": false,
+        "index": {},
+        "paths": {},
+        "external_crates": {},
+        "target": { "triple": "x86_64-unknown-linux-gnu", "target_features": {} },
+        "root": "0"
+    });
+    let parsed: serde_json::Value = serde_json::from_str(&blob.to_string()).unwrap();
+    let observed = parsed
+        .get("format_version")
+        .and_then(|v| v.as_u64())
+        .map(|v| v as u32)
+        .unwrap();
+    assert!(observed < expected, "test must use a strictly older version");
+}
+
+/// A snapshot whose format_version matches the pinned value must round-trip
+/// through `rustdoc_types::FORMAT_VERSION` without complaint.
+#[test]
+fn accepts_matching_format_version() {
+    let expected = rustdoc_types::FORMAT_VERSION;
+    let blob = json!({ "format_version": expected });
+    let observed = blob
+        .get("format_version")
+        .and_then(|v| v.as_u64())
+        .map(|v| v as u32)
+        .unwrap();
+    assert_eq!(observed, expected);
+}

package/dist/dev-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AAyDA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2c7E"}
+{"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AA0DA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+f7E"}

package/dist/dev-server.js

@@ -12,6 +12,7 @@ import { buildNavFromSpec, buildSiteNavigation, withActivePage } from "./core/na
 import { loadDocsPage, slugFromPath } from "./core/markdown-loader.js";
 import { loadDoxygenTab } from "./core/doxygen-loader.js";
 import { loadGodocTab } from "./core/godoc-loader.js";
+import { loadRustdocTab } from "./core/rustdoc-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";
@@ -54,6 +55,15 @@ export async function startDevServer(options) {
             // The Go module directory is large; watching every .go file slows the
             // dev server. Restart manually after broad source edits.
         }
+        if (tab.source.kind === "rustdoc") {
+            // Cargo manifest is the watch surface; .rs files are intentionally not
+            // watched because rustdoc recompile is expensive. Restart manually
+            // after broad source edits, matching the godoc policy.
+            watchPaths.push(resolve(tab.source.config.manifest));
+            if (tab.source.config.snapshot) {
+                watchPaths.push(resolve(tab.source.config.snapshot));
+            }
+        }
         if (tab.source.kind === "markdown") {
             for (const group of tab.source.groups) {
                 for (const page of group.pages) {
@@ -97,6 +107,13 @@ export async function startDevServer(options) {
                     snapshotPath: tab.source.config.snapshot,
                 });
             }
+            if (tab.source.kind === "rustdoc" && tab.source.config.snapshot) {
+                map.set(resolve(tab.source.config.snapshot), {
+                    kind: "rustdoc",
+                    tabSlug: tab.slug,
+                    snapshotPath: tab.source.config.snapshot,
+                });
+            }
             if (tab.source.kind === "markdown") {
                 for (const group of tab.source.groups) {
                     for (const page of group.pages) {
@@ -243,6 +260,38 @@ export async function startDevServer(options) {
             else
                 data.siteTabs.push(navTab);
         }
+        else if (content.kind === "rustdoc") {
+            const tab = config.tabs.find((candidate) => candidate.slug === content.tabSlug);
+            if (!tab || tab.source.kind !== "rustdoc")
+                return;
+            log(`rebuilding rustdoc tab "${tab.label}"`);
+            const { pages, navTab } = await loadRustdocTab(tab.source.config, tab.slug, tab.label, {
+                repo: config.repo,
+                editBranch: config.editBranch,
+                editBasePath: tab.source.config.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);

package/dist/index.d.ts

@@ -31,13 +31,15 @@ export interface SiteBuildResult {
     pageCount: number;
     changelogDiagnostics: ChangelogDiagnostic[];
     godocDiagnostics: import("./core/godoc-loader.js").GodocLoaderDiagnostic[];
+    rustdocDiagnostics: import("./core/rustdoc-loader.js").RustdocLoaderDiagnostic[];
     /** @internal specs by tab slug, for buildDocs compat */
     _specs?: Map<string, NormalizedSpec>;
 }
 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 { doxygen, godoc, markdown, mcp, mkdocs, openapi, rustdoc } 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";
+export type { DoxygenSourceOptions, GodocSourceOptions, MarkdownSourceOptions, McpSourceOptions, MkDocsSourceOptions, OpenApiSourceOptions, ResolvedTabSource, RustdocSourceOptions, SourceAdapter, SourceAdapterContext, } from "./adapters/index.js";
+export type { RustdocConfig, ResolvedRustdocConfig, RustdocMode, RustdocFeatures, } from "./config.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,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"}
+{"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;AAmBlD,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,kBAAkB,EAAE,OAAO,0BAA0B,EAAE,uBAAuB,EAAE,CAAC;IACjF,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,CAgG5F;AA8CD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9F,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,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,eAAe,GAChB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -5,7 +5,7 @@ import { loadConfig, configFromSpec } from "./config.js";
 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 { assembleSite, buildSiteConfig, collectDocsPagesByTab, createMinimalSpec, enforceChangelogDiagnostics, enforceGodocDiagnostics, enforceRustdocDiagnostics, } from "./site-assembly.js";
 /**
  * Build API documentation from a single OpenAPI/Swagger spec.
  * Wraps the spec in a single-tab site and renders through the modern layout.
@@ -35,6 +35,8 @@ export async function buildSiteDocs(options = {}) {
     const sitePages = Array.from(assembled.pageMap.values());
     const navigation = buildSiteNavigation(assembled.siteTabs);
     enforceChangelogDiagnostics(assembled.changelogDiagnostics, options.strictChangelog);
+    enforceGodocDiagnostics(assembled.godocDiagnostics);
+    enforceRustdocDiagnostics(assembled.rustdocDiagnostics);
     const docsPagesByTab = collectDocsPagesByTab(assembled.pageMap, config.tabs);
     const searchIndex = buildSearchIndex(assembled.specsBySlug, docsPagesByTab, navigation, config.baseUrl || "/", config.search.featured, config.prettyUrls);
     const llmsTxt = generateLlmsTxt(sitePages, navigation, site);
@@ -50,16 +52,22 @@ export async function buildSiteDocs(options = {}) {
                 const ogMeta = describePageForOg(page, config.name || "API", config.changelog.ogImages);
                 if (!ogMeta)
                     return;
-                const ogPath = `_og/${page.outputPath.replace(/\.html$/, ".png")}`;
-                const png = await generateOgImage({
-                    title: ogMeta.title,
-                    description: ogMeta.description,
-                    siteName: config.name,
-                    theme: config.theme,
-                    logo: site.logo?.light,
-                });
-                page.ogImagePath = ogPath;
-                ogImages.set(ogPath, png);
+                try {
+                    const ogPath = `_og/${page.outputPath.replace(/\.html$/, ".png")}`;
+                    const png = await generateOgImage({
+                        title: ogMeta.title,
+                        description: ogMeta.description,
+                        siteName: config.name,
+                        theme: config.theme,
+                        logo: site.logo?.light,
+                    });
+                    page.ogImagePath = ogPath;
+                    ogImages.set(ogPath, png);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    console.warn(`Sourcey: skipping OG image for ${page.outputPath}: ${message}`);
+                }
             }));
         }
     }
@@ -95,6 +103,7 @@ export async function buildSiteDocs(options = {}) {
         pageCount: sitePages.length,
         changelogDiagnostics: assembled.changelogDiagnostics,
         godocDiagnostics: assembled.godocDiagnostics,
+        rustdocDiagnostics: assembled.rustdocDiagnostics,
         _specs: assembled.specsBySlug,
     };
 }
@@ -114,7 +123,7 @@ function describePageForOg(page, defaultSiteName, changelogPermalinkOg) {
             if (!version)
                 return null;
             return {
-                title: `${version.version ?? "Unreleased"} — ${changelog.title}`,
+                title: `${version.version ?? "Unreleased"} - ${changelog.title}`,
                 description: version.summary || summarizeVersion(version),
             };
         }
@@ -133,5 +142,5 @@ function summarizeVersion(version) {
     return summary || undefined;
 }
 export { defineConfig } from "./config.js";
-export { doxygen, godoc, markdown, mcp, mkdocs, openapi } from "./adapters/index.js";
+export { doxygen, godoc, markdown, mcp, mkdocs, openapi, rustdoc } from "./adapters/index.js";
 export { resolveInternalLinks } from "./site-assembly.js";

package/dist/init.js

@@ -190,8 +190,8 @@ export const init = defineCommand({
             imports.add("doxygen");
             tabs += `
       {
-        tab: "API Reference",
-        slug: "api",
+        tab: "C++ Reference",
+        slug: "cpp-api",
         source: doxygen({ xml: "${relPath(addDoxygen.xmlDir)}" }),
       },`;
         }

package/dist/renderer/changelog-feed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changelog-feed.d.ts","sourceRoot":"","sources":["../../src/renderer/changelog-feed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAEnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CAsEpB"}
+{"version":3,"file":"changelog-feed.d.ts","sourceRoot":"","sources":["../../src/renderer/changelog-feed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAGnE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,oBAAoB,GAC5B,kBAAkB,CA8EpB"}