fix: pin en-US locale in builtin MDN type links

[btea]

Description

MDN URLs without a locale prefix get redirected to the visitor's preferred language, where heading anchor IDs are translated (e.g. #number_type becomes #number_类型). The original hash fragment no longer matches any anchor after the redirect, so type links fail to jump to the target section.

Pin the en-US locale on all MDN links that carry a hash fragment in the builtin type map, so the anchors resolve consistently.

Validation

Related Issues

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:check & 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	Aug 4, 2026 4:26am

[cursor]

PR Summary

Low Risk
Documentation URL map and test expectation updates only; no runtime logic or security-sensitive code changes.

Overview
Fixes broken deep links for primitive and related builtin types (number, string, null, any, etc.) in generated docs.

builtin.json now uses https://developer.mozilla.org/en-US/docs/... for MDN entries that include a hash fragment (including iterable). Locale-less MDN URLs redirect to the visitor’s language, where heading anchor IDs differ, so fragments like #number_type no longer match and the link does not jump to the right section.

MDN URLs without a fragment (e.g. void, this) are unchanged. Unit tests in resolveTypes.test.mjs and transformers.test.mjs expect the updated URLs. A patch changeset records the @node-core/doc-kit release note.

^{Reviewed by Cursor Bugbot for commit 81a7c16. 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.}

Want fixes drafted automatically? Bugbot Autofix can create code changes for findings. A team admin can enable Autofix in the Cursor dashboard.

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

[Copilot]

Pull request overview

Pins the en-US locale for MDN URLs in the builtin type link map when those URLs include hash fragments, avoiding locale-based redirects that can translate heading IDs and break in-page anchor navigation.

Changes:

• Updated builtin MDN type links with hash fragments to use https://developer.mozilla.org/en-US/... URLs.
• Added a changeset describing the user-facing fix and rationale.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File	Description
packages/core/src/generators/metadata/maps/builtin.json	Pins en-US on MDN URLs with fragments so anchor hashes remain stable across locales.
.changeset/mdn-type-link-locale.md	Adds release notes for the locale-pinning fix.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.60%. Comparing base (e46e3cf) to head (81a7c16).

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #997   +/-   ##
=======================================
  Coverage   89.60%   89.60%           
=======================================
  Files         197      197           
  Lines       18418    18418           
  Branches     1724     1724           
=======================================
  Hits        16503    16503           
  Misses       1908     1908           
  Partials        7        7           

☔ 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.

[Copilot]

Pull request overview

Copilot reviewed 2 out of 2 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 4 out of 4 changed files in this pull request and generated no new comments.

[AugustinMauroy]

LGMT !