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

[TusharThakur04]

Description

This PR reinforce the link conversion logic for nested .md files by stripping the directory prefix.

Validation

before :

Screencast.from.2026-04-14.05-00-18.webm

after :

Screencast.from.2026-04-14.04-36-15.webm

Related Issues

n/a

Check List

• I have read the Contributing Guidelines and made commit messages that follow the guideline.
• I have run node --run test and all tests passed.
• I have check code formatting with node --run format & node --run lint.
• I've covered new added functionality with unit tests if necessary.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
api-docs-tooling	Ready	Preview	Apr 27, 2026 10:27pm

[cursor]

PR Summary

Low Risk
Low risk: small, localized change to Markdown link normalization plus added unit coverage; main risk is unintended link rewriting differences for edge-case relative URLs.

Overview
Fixes API-doc Markdown link rewriting so namespaces/foo.md (and #fragments) become foo.html by stripping any directory prefix during conversion.

Adds a safeguard to skip rewriting any link that already includes a protocol (e.g. http:, https:, file:), and extends unit tests to cover nested paths, fragment preservation, and protocol URLs.

^{Reviewed by Cursor Bugbot for commit f2f1fc1. Bugbot is set up for automated code reviews on this repo. Configure here.}

[avivkeller]

Can you elaborate on this?

[TusharThakur04]

earlier a markdown link such as namespaces/compileBooleanMatcher.md was converted to
namespaces/compileBooleanMatcher.html
but all pages are generated at root -- compileBooleanMatcher.html
so we need namespaces/compileBooleanMatcher.md to be converted to compileBooleanMatcher.html instead of namespaces/compileBooleanMatcher.html

this pr strips the directory prefix

[avivkeller]

But doesn't this break cases where a full URL is needed?

[codecov]

Codecov Report

❌ Patch coverage is 94.73684% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 78.01%. Comparing base (3d00fa8) to head (f2f1fc1).
⚠️ Report is 9 commits behind head on main.

Files with missing lines	Patch %	Lines
src/generators/metadata/utils/visitors.mjs	50.00%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #768      +/-   ##
==========================================
- Coverage   78.43%   78.01%   -0.42%     
==========================================
  Files         157      159       +2     
  Lines       13962    14112     +150     
  Branches     1152     1157       +5     
==========================================
+ Hits        10951    11010      +59     
- Misses       3006     3097      +91     
  Partials        5        5              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[TusharThakur04]

i can add guard for :
eg: https://github.com/facebook/react/blob/main/README.md
these type of links will be ignored