doc: fix unresolved intra-doc links in doc comments

Several doc comments referenced types and constants by short name
without an import in scope, or referenced a private-only item from a
context where it wouldn't resolve, leaving broken rustdoc links.
Qualify the paths and clarify the OPFS worker JS reference so the
generated docs link correctly on every target.

Author: farhan-syah

src/btree/node.rs

@@ -27,7 +27,7 @@ impl NodeKind {
     }
 
     /// Stable lowercase name, for naming both sides of a kind disagreement in
-    /// [`CorruptionDetail::NodeKindMismatch`].
+    /// [`crate::errors::CorruptionDetail::NodeKindMismatch`].
     #[must_use]
     pub const fn name(self) -> &'static str {
         match self {
@@ -123,7 +123,8 @@ pub fn read_header(body: &[u8]) -> Result<NodeHeader> {
 /// entry are attacker- or bug-controlled `u16`s that the decoders and the
 /// zero-copy accessors use directly as slice indices. Without this pass a
 /// malformed-but-authenticated page panics the library (an out-of-range slice
-/// index) instead of surfacing as [`CorruptionDetail::NodeBodyMalformed`],
+/// index) instead of surfacing as
+/// [`crate::errors::CorruptionDetail::NodeBodyMalformed`],
 /// which is a strictly worse failure than the one it would report.
 ///
 /// Every constructor that turns raw bytes into a node runs this first, so the

src/txn/db/misc.rs

@@ -80,7 +80,7 @@ impl<V: Vfs + Clone> Db<V> {
     /// truncates `main.db` if no reader pins the old high-water range, and
     /// repacks segment files whose garbage ratio exceeds 5%.
     ///
-    /// Returns a [`CompactStats`] summary of what was reclaimed.
+    /// Returns a [`crate::CompactStats`] summary of what was reclaimed.
     pub async fn compact_now(&self) -> Result<crate::compaction::CompactStats> {
         self.ensure_usable()?;
         crate::compaction::compact_now(self).await
@@ -93,8 +93,9 @@ impl<V: Vfs + Clone> Db<V> {
     /// each call, so a crash mid-compaction is safe: call `compact_step` again
     /// after reopening to resume from where it left off.
     ///
-    /// Returns a [`CompactProgress`] describing what was done and whether more
-    /// work remains. Loop until `progress.more_work == false` to compact fully.
+    /// Returns a [`crate::CompactProgress`] describing what was done and
+    /// whether more work remains. Loop until `progress.more_work == false` to
+    /// compact fully.
     pub async fn compact_step(
         &self,
         budget: crate::compaction::CompactBudget,

src/txn/db/reader.rs

@@ -33,7 +33,7 @@ impl<V: Vfs + Clone> Db<V> {
         ))
     }
 
-    /// Like [`begin_read`] but marks the reader as non-abortable. The
+    /// Like [`Self::begin_read`] but marks the reader as non-abortable. The
     /// `AbortOldest` stall policy skips non-abortable readers; if all blocking
     /// readers are non-abortable, the policy falls through to `Reject`
     /// semantics for the writer.

src/vfs/opfs/mod.rs

@@ -4,7 +4,9 @@
 //!
 //! The embedder must serve `opfs_worker.js` at a URL the browser can load as
 //! a dedicated Web Worker. The JS source is embedded in this crate and
-//! accessible via [`OPFS_WORKER_JS`]. A minimal bootstrap:
+//! accessible via the `OPFS_WORKER_JS` constant, which — like the rest of the
+//! backend — exists only under the compile gating described below, so it does
+//! not appear in documentation built for a native target. A minimal bootstrap:
 //!
 //! ```js
 //! // Write OPFS_WORKER_JS to a blob URL or serve it statically, then:

src/vfs/wasi.rs

@@ -4,7 +4,8 @@
 //!
 //! The full implementation is compiled only for `cfg(target_os = "wasi")`.
 //! On every other target a thin shim is compiled instead; the constructor
-//! returns [`PagedbError::Unsupported`] and every method is unreachable.
+//! returns [`crate::PagedbError::Unsupported`] and every method is
+//! unreachable.
 //!
 //! # Locking
 //!