fix(no-undefined-types): add Intl to global types and ensure arbitrary properties of globals can be addressed; fixes #1423 (#1424)

brettz9 · web-flow · commit feb65e4e845e · 2025-07-02T21:01:17.000+08:00
diff --git a/docs/rules/no-undefined-types.md b/docs/rules/no-undefined-types.md
@@ -989,5 +989,12 @@ class SomeClass {
  * {@link SomeClass.someMethod}
  * @returns something
  */
+
+/**
+ * The internationalized collator object that will be used.
+ * Intl.Collator(null, {numeric: true, sensitivity: 'base'}) is used by default;.
+ *
+ * @member {Intl.Collator}
+ */
 ````
 
diff --git a/src/rules/noUndefinedTypes.js b/src/rules/noUndefinedTypes.js
@@ -17,7 +17,7 @@ const extraTypes = [
   'number', 'bigint', 'NaN', 'Infinity',
   'any', '*', 'never', 'unknown', 'const',
   'this', 'true', 'false',
-  'Array', 'Object', 'RegExp', 'Date', 'Function',
+  'Array', 'Object', 'RegExp', 'Date', 'Function', 'Intl',
 ];
 
 const typescriptGlobals = [
@@ -471,6 +471,7 @@ export default iterateJsdoc(({
           //  check their properties which may or may not exist
           !imports.includes(val) && !globals.includes(val) &&
           !importTags.includes(val) &&
+          !extraTypes.includes(val) &&
           !typedefDeclarations.includes(val) &&
           currNode && 'right' in currNode &&
           currNode.right?.type === 'JsdocTypeProperty') {
diff --git a/test/rules/assertions/noUndefinedTypes.js b/test/rules/assertions/noUndefinedTypes.js
@@ -1719,5 +1719,15 @@ export default /** @type {import('../index.js').TestCases} */ ({
          */
       `,
     },
+    {
+      code: `
+        /**
+         * The internationalized collator object that will be used.
+         * Intl.Collator(null, {numeric: true, sensitivity: 'base'}) is used by default;.
+         *
+         * @member {Intl.Collator}
+         */
+      `,
+    },
   ],
 });
