v0.57.0

Author: aDotInTheVoid

CHANGELOG.md

@@ -1,3 +1,13 @@
+<a name="v0.57.0"></a>
+# [v0.57.0](https://github.com/rust-lang/rustdoc-types/releases/tag/v0.57.0) - 2025-11-22
+
+**Breaking Change**: Add `ExternalCrate::path` field.
+This can be used to enable robust resolution of external crates.
+
+- Format Version: 57
+- Upstream Commit: [`361af821ab169a98e9fc1db5d3a57978504ed379`](https://github.com/rust-lang/rust/commit/361af821ab169a98e9fc1db5d3a57978504ed379)
+- Diff: [v0.56.0...v0.57.0](https://github.com/rust-lang/rustdoc-types/compare/v0.56.0...v0.57.0)
+
 <a name="v0.56.0"></a>
 # [v0.56.0](https://github.com/rust-lang/rustdoc-types/releases/tag/v0.56.0) - 2025-09-05
 

COMMIT.txt

@@ -1 +1 @@
-ab0ee84eac9732e4e81e559c688846b4c1bd400a
+361af821ab169a98e9fc1db5d3a57978504ed379

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rustdoc-types"
-version = "0.56.0"
+version = "0.57.0"
 edition = "2018"
 license = "MIT OR Apache-2.0"
 description = "Types for rustdoc's json output"

src/lib.rs

@@ -36,8 +36,8 @@ use serde_derive::{Deserialize, Serialize};
 // will instead cause conflicts. See #94591 for more. (This paragraph and the "Latest feature" line
 // are deliberately not in a doc comment, because they need not be in public docs.)
 //
-// Latest feature: Add `ItemKind::Attribute`.
-pub const FORMAT_VERSION: u32 = 56;
+// Latest feature: Add `ExternCrate::path`.
+pub const FORMAT_VERSION: u32 = 57;
 
 /// The root of the emitted JSON blob.
 ///
@@ -134,6 +134,12 @@ pub struct ExternalCrate {
     pub name: String,
     /// The root URL at which the crate's documentation lives.
     pub html_root_url: Option<String>,
+
+    /// A path from where this crate was loaded.
+    ///
+    /// This will typically be a `.rlib` or `.rmeta`. It can be used to determine which crate
+    /// this was in terms of whatever build-system invoked rustc.
+    pub path: PathBuf,
 }
 
 /// Information about an external (not defined in the local crate) [`Item`].