doc: fix conversion of source only links from md to html

jonchurch · jonchurch · commit adb32a00a271 · 2025-12-02T15:44:28.000-05:00
diff --git a/lib/main/build-site.js b/lib/main/build-site.js
@@ -184,9 +184,16 @@ function build() {
     .readFileSync(readmePath, 'utf8')
     // Uncomment docdown HTML hints.
     .replace(/(<)!--\s*|\s*--(>)/g, '$1$2')
-    // Convert source and npm package links to anchors.
-    .replace(/\[source\]\(([^)]+)\) \[npm package\]\(([^)]+)\)/g, (match, href1, href2) =>
-      `<p><a href="${ href1 }">source</a> <a href="${ href2 }">npm package</a></p>`
+    // Convert docdown-generated [source] and [npm package] links to HTML.
+    // These appear as markdown immediately after h3 tags, which marky-markdown
+    // doesn't process (it treats content after HTML blocks as plain text).
+    // Pattern 1: Dual links for methods with npm packages.
+    .replace(/(<h3[^>]*>.*?<\/h3>)\n\[source\]\(([^)]+)\) \[npm package\]\(([^)]+)\)/g, (match, h3, href1, href2) =>
+      `${h3}\n<p><a href="${ href1 }">source</a> <a href="${ href2 }">npm package</a></p>`
+    )
+    // Pattern 2: Standalone [source] links for properties without npm packages.
+    .replace(/(<h3[^>]*>.*?<\/h3>)\n\[source\]\(([^)]+)\)(?! \[npm package\])/g, (match, h3, href) =>
+      `${h3}\n<p><a href="${ href }">source</a></p>`
     );
 
   const $ = cheerio.load(marky(markdown, {
