fix(metadata): strip directory prefix when converting nested .md link to .html

Author: TusharThakur04

src/generators/metadata/utils/__tests__/parse.test.mjs

@@ -220,6 +220,34 @@ describe('parseApiDoc', () => {
 
       assert.strictEqual(findLink(entry)?.url, 'events.html#some-section');
     });
+
+    it('strips subdirectory prefix from nested .md links', () => {
+      const tree = u('root', [
+        h('fs'),
+        u('paragraph', [
+          u('link', { url: 'namespaces/comparators.md' }, [
+            u('text', 'comparators'),
+          ]),
+        ]),
+      ]);
+      const [entry] = parseApiDoc({ path, tree }, typeMap);
+
+      assert.strictEqual(findLink(entry)?.url, 'comparators.html');
+    });
+
+    it('strips subdirectory prefix and preserves hash fragments', () => {
+      const tree = u('root', [
+        h('fs'),
+        u('paragraph', [
+          u('link', { url: 'namespaces/comparators.md#some-section' }, [
+            u('text', 'comparators'),
+          ]),
+        ]),
+      ]);
+      const [entry] = parseApiDoc({ path, tree }, typeMap);
+
+      assert.strictEqual(findLink(entry)?.url, 'comparators.html#some-section');
+    });
   });
 
   describe('document without headings', () => {

src/generators/metadata/utils/visitors.mjs

@@ -1,4 +1,5 @@
 'use strict';
+import { basename } from 'node:path/posix';
 
 import { SKIP } from 'unist-util-visit';
 
@@ -18,7 +19,7 @@ import { transformNodesToString } from '../../../utils/unist.mjs';
 export const visitMarkdownLink = node => {
   node.url = node.url.replace(
     QUERIES.markdownUrl,
-    (_, filename, hash = '') => `${filename}.html${hash}`
+    (_, filename, hash = '') => `${basename(filename)}.html${hash}`
   );
 
   return [SKIP];