feat(html): external jsdoc module linking (#622)

examples/ddoc/main.rs

@@ -203,6 +203,14 @@ impl HrefResolver for EmptyResolver {
   fn resolve_source(&self, location: &deno_doc::Location) -> Option<String> {
     Some(location.filename.to_string())
   }
+
+  fn resolve_external_jsdoc_module(
+    &self,
+    _module: &str,
+    _symbol: Option<&str>,
+  ) -> Option<(String, String)> {
+    None
+  }
 }
 
 fn generate_docs_directory(

src/html/jsdoc.rs

@@ -155,6 +155,14 @@ fn parse_links<'a>(md: &'a str, ctx: &RenderContext) -> Cow<'a, str> {
             title = short_path.display_name().to_string();
           }
         }
+      } else if let Some((external_link, external_title)) =
+        ctx.ctx.href_resolver.resolve_external_jsdoc_module(
+          module_link,
+          symbol_match.map(|symbol_match| symbol_match.as_str()),
+        )
+      {
+        link = external_link;
+        title = external_title;
       }
 
       link
@@ -767,6 +775,14 @@ mod test {
     fn resolve_source(&self, _location: &Location) -> Option<String> {
       None
     }
+
+    fn resolve_external_jsdoc_module(
+      &self,
+      _module: &str,
+      _symbol: Option<&str>,
+    ) -> Option<(String, String)> {
+      None
+    }
   }
 
   #[test]

src/html/render_context.rs

@@ -398,6 +398,14 @@ mod test {
     fn resolve_source(&self, location: &Location) -> Option<String> {
       Some(location.filename.clone().into_string())
     }
+
+    fn resolve_external_jsdoc_module(
+      &self,
+      _module: &str,
+      _symbol: Option<&str>,
+    ) -> Option<(String, String)> {
+      None
+    }
   }
 
   #[test]

src/html/util.rs

@@ -316,6 +316,14 @@ pub trait HrefResolver {
 
   /// Resolve the URL used in source code link buttons.
   fn resolve_source(&self, location: &crate::Location) -> Option<String>;
+
+  /// Resolve external JSDoc module links.
+  /// Returns a tuple with link and title.
+  fn resolve_external_jsdoc_module(
+    &self,
+    module: &str,
+    symbol: Option<&str>,
+  ) -> Option<(String, String)>;
 }
 
 #[derive(Debug, Serialize, Clone)]

tests/html_test.rs

@@ -77,6 +77,14 @@ impl HrefResolver for EmptyResolver {
   fn resolve_source(&self, _location: &deno_doc::Location) -> Option<String> {
     None
   }
+
+  fn resolve_external_jsdoc_module(
+    &self,
+    _module: &str,
+    _symbol: Option<&str>,
+  ) -> Option<(String, String)> {
+    None
+  }
 }
 
 async fn get_files(subpath: &str) -> IndexMap<ModuleSpecifier, Vec<DocNode>> {