fix(globals): use \globals\ for globals

Author: avivkeller

.github/dependabot.yml

@@ -38,7 +38,6 @@ updates:
           - 'eslint'
           - 'eslint-*'
           - 'lint-staged'
-          - 'globals'
           - '@eslint/*'
       unist:
         patterns:

package-lock.json

@@ -32,7 +32,6 @@
     "eslint": "^9.31.0",
     "eslint-plugin-import-x": "^4.16.1",
     "eslint-plugin-jsdoc": "^51.4.1",
-    "globals": "^16.3.0",
     "husky": "^9.1.7",
     "lint-staged": "^16.1.2",
     "prettier": "3.6.2"
@@ -55,6 +54,7 @@
     "estree-util-visit": "^2.0.0",
     "github-slugger": "^2.0.0",
     "glob": "^11.0.3",
+    "globals": "^16.3.0",
     "hast-util-to-string": "^3.0.1",
     "hastscript": "^9.0.1",
     "lightningcss": "^1.30.1",

package.json

@@ -1,4 +1,4 @@
-'use strict';
+import globals from 'globals';
 
 // These are string replacements specific to Node.js API docs for anchor IDs
 export const DOC_API_SLUGS_REPLACEMENTS = [
@@ -71,62 +71,32 @@ export const DOC_API_HEADING_TYPES = [
 
 // This is a mapping for types within the Markdown content and their respective
 // JavaScript primitive types within the MDN JavaScript docs
-// @see DOC_MDN_BASE_URL_JS_PRIMITIVES
-export const DOC_TYPES_MAPPING_PRIMITIVES = {
-  boolean: 'Boolean',
-  integer: 'Number', // Not a primitive, used for clarification.
-  null: 'Null',
-  number: 'Number',
-  string: 'String',
-  symbol: 'Symbol',
-  undefined: 'Undefined',
-};
+// @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Data_structures#primitive_values
+export const DOC_TYPES_MAPPING_PRIMITIVES = [
+  'null',
+  'undefined',
+  'boolean',
+  'number',
+  'bigint',
+  'string',
+  'symbol',
+];
 
 // This is a mapping for types within the Markdown content and their respective
 // JavaScript globals types within the MDN JavaScript docs
 // @see DOC_MDN_BASE_URL_JS_GLOBALS
 export const DOC_TYPES_MAPPING_GLOBALS = {
   ...Object.fromEntries(
     [
-      'AggregateError',
-      'Array',
-      'ArrayBuffer',
-      'DataView',
-      'Date',
-      'Error',
-      'EvalError',
-      'Function',
-      'Map',
-      'NaN',
-      'Object',
-      'Promise',
-      'Proxy',
-      'RangeError',
-      'ReferenceError',
-      'RegExp',
-      'Set',
-      'SharedArrayBuffer',
-      'SyntaxError',
-      'Symbol',
-      'TypeError',
-      'URIError',
-      'WeakMap',
-      'WeakSet',
-
-      'TypedArray',
-      'Float16Array',
-      'Float32Array',
-      'Float64Array',
-      'Int8Array',
-      'Int16Array',
-      'Int32Array',
-      'Uint8Array',
-      'Uint8ClampedArray',
-      'Uint16Array',
-      'Uint32Array',
+      // This is updated with every ES-spec, so, as long as the
+      // `globals` package is up-to-date, so will our globals
+      // list.
+      ...Object.keys(globals.builtin),
+      'AsyncGeneratorFunction',
+      'AsyncIterator',
+      'AsyncFunction',
     ].map(e => [e, e])
   ),
-  bigint: 'BigInt',
   'WebAssembly.Instance': 'WebAssembly/Instance',
 };
 
@@ -331,18 +301,12 @@ export const DOC_TYPES_MAPPING_OTHER = {
 
   ArrayBufferView: `${DOC_MDN_BASE_URL}/API/ArrayBufferView`,
 
-  AsyncIterator: 'https://tc39.github.io/ecma262/#sec-asynciterator-interface',
   AsyncIterable: 'https://tc39.github.io/ecma262/#sec-asynciterable-interface',
-  AsyncFunction: 'https://tc39.es/ecma262/#sec-async-function-constructor',
 
   'Module Namespace Object':
     'https://tc39.github.io/ecma262/#sec-module-namespace-exotic-objects',
 
-  AsyncGeneratorFunction:
-    'https://tc39.es/proposal-async-iteration/#sec-asyncgeneratorfunction-constructor',
-
   Iterable: `${DOC_MDN_BASE_URL_JS}Reference/Iteration_protocols#The_iterable_protocol`,
-  Iterator: `${DOC_MDN_BASE_URL_JS}Reference/Iteration_protocols#The_iterator_protocol`,
 
   CloseEvent: `${DOC_MDN_BASE_URL}/API/CloseEvent`,
   EventSource: `${DOC_MDN_BASE_URL}/API/EventSource`,

src/utils/parser/constants.mjs

@@ -82,9 +82,7 @@ export const transformTypeToReferenceLink = type => {
   const transformType = lookupPiece => {
     // Transform JS primitive type references into Markdown links (MDN)
     if (lookupPiece.toLowerCase() in DOC_TYPES_MAPPING_PRIMITIVES) {
-      const typeValue = DOC_TYPES_MAPPING_PRIMITIVES[lookupPiece.toLowerCase()];
-
-      return `${DOC_MDN_BASE_URL_JS_PRIMITIVES}#${typeValue}_type`;
+      return `${DOC_MDN_BASE_URL_JS_PRIMITIVES}#${lookupPiece.toLowerCase()}_type`;
     }
 
     // Transforms JS Global type references into Markdown links (MDN)