fix(globals): use globals for globals

[avivkeller]

Description

The globals library is updated with every builtin global every month (https://github.com/sindresorhus/globals/blob/main/.github/workflows/update.yml), so we can safely rely on it to populate our builtin globals.

IMO this is a safer alternative than having us manually update this list.

Related Issues

Ref #319

[vercel]

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

Project	Deployment	Preview	Updated (UTC)
api-docs-tooling	Ready	Preview	Aug 15, 2025 8:17pm

[Copilot]

Pull Request Overview

This PR refactors the hardcoded list of JavaScript global objects to use the globals library, which automatically updates with new ES specifications monthly. This change simplifies maintenance by removing the need to manually track and update global objects.

• Replaces hardcoded arrays of JavaScript globals with dynamic imports from the globals library
• Moves the globals dependency from devDependencies to dependencies
• Simplifies the primitive types mapping from an object to an array structure

Reviewed Changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 3 comments.

File	Description
src/utils/parser/constants.mjs	Replaces manual global object lists with globals.builtin and converts primitive mapping to array
src/utils/parser/index.mjs	Updates primitive type transformation to work with new array-based mapping
package.json	Moves globals from devDependencies to dependencies
.github/dependabot.yml	Removes globals from linting dependency group

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 74.22%. Comparing base (dc92c22) to head (53c09d8).
⚠️ Report is 1 commits behind head on main.
✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #397      +/-   ##
==========================================
- Coverage   74.29%   74.22%   -0.08%     
==========================================
  Files         118      118              
  Lines       11025    10994      -31     
  Branches      695      696       +1     
==========================================
- Hits         8191     8160      -31     
  Misses       2831     2831              
  Partials        3        3              

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

[avivkeller]

Blocked by nodejs/node#59421

[avivkeller]

Unrelated, but https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Data_structures#Data_types isn't a valid URL, which is also defined in this file

[ovflowd]

If we're going down this approach, wouldn't it be easier to use Object.keys(self)?

[ovflowd]

cc @aduh95 / @nodejs/collaborators

[avivkeller]

If we're going down this approach, wouldn't it be easier to use Object.keys(self)?

No, firstly, see #397 (comment). Secondly, we aren't building the docs on for same version of Node.js as we are on, so the list would be incomplete

[avivkeller]

Need to fix one thing, then this'll be good to go

[ovflowd]

@avivkeller conflicts?