chore(parsing): better use of code spans

[avivkeller]

Fixes #839 by only outputting the code spans on the outermost resolution

Note: This changes the output slightly, from <MyType> to <MyType>

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
api-docs-tooling	Error		Jun 15, 2026 9:25pm

[cursor]

PR Summary

Low Risk
Output-format change for generated docs only; behavior is covered by updated unit tests with no runtime API changes.

Overview
Refactors metadata type-to-markdown parsing so one outer <code><…></code> wraps the whole type instead of nesting backticks around every linked segment.

parseInner now builds plain inner markup: type links become [Name](url) (no `[`<Name>`]`), generics and => use literal characters instead of HTML entities, and unresolved names stay as bare text. The exported parseType only adds the outer code wrapper. Test expectations in transformers.test.mjs are updated to match the new rendered shape (fixes #839).

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

[cursor]

Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit f394719. Configure here.}

[cursor]

Type output breaks typed list parsing

High Severity

Wrapping resolved types as <code><…></code> with inner markdown links like [string](url) no longer matches what downstream code expects: link nodes whose child is inlineCode starting with <. Typed parameter lists then fail strongly-typed detection and extractTypeAnnotations leaves type unset, so signature tables and legacy HTML type-link handling break.

 

^{Reviewed by Cursor Bugbot for commit f394719. Configure here.}

[codecov]

Codecov Report

❌ Patch coverage is 90.00000% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 84.60%. Comparing base (f97991b) to head (f394719).
⚠️ Report is 31 commits behind head on main.

Files with missing lines	Patch %	Lines
src/generators/metadata/utils/typeParser.mjs	84.61%	4 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #840      +/-   ##
==========================================
+ Coverage   82.80%   84.60%   +1.80%     
==========================================
  Files         171      176       +5     
  Lines       14904    15813     +909     
  Branches     1305     1412     +107     
==========================================
+ Hits        12341    13379    +1038     
+ Misses       2555     2424     -131     
- Partials        8       10       +2     

☔ View full report in Codecov by Harness.
📢 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.