fix(imports-as-dependencies): support Node builtins; fixes #1112

Author: brettz9

docs/rules/imports-as-dependencies.md

@@ -83,5 +83,17 @@ The following patterns are not considered problems:
 /**
  * @type {null|import('./relativePath.js').Program}
  */
+
+/**
+ * @type {null|import('fs').PathLike}
+ */
+
+/**
+ * @type {null|import('fs/promises').FileHandle}
+ */
+
+/**
+ * @type {null|import('node:fs').PathLike}
+ */
 ````
 

package.json

@@ -11,6 +11,7 @@
     "debug": "^4.3.4",
     "escape-string-regexp": "^4.0.0",
     "esquery": "^1.5.0",
+    "is-builtin-module": "^3.2.1",
     "semver": "^7.5.1",
     "spdx-expression-parse": "^3.0.1"
   },
@@ -37,7 +38,7 @@
     "@types/estree": "^1.0.1",
     "@types/lodash.defaultsdeep": "^4.6.7",
     "@types/mocha": "^10.0.1",
-    "@types/node": "^20.2.3",
+    "@types/node": "^20.2.5",
     "@types/semver": "^7.5.0",
     "@types/spdx-expression-parse": "^3.0.2",
     "@typescript-eslint/parser": "^5.59.6",

pnpm-lock.yaml

@@ -7,6 +7,7 @@ import {
 import {
   readFileSync,
 } from 'fs';
+import isBuiltinModule from 'is-builtin-module';
 import {
   join,
 } from 'path';
@@ -71,7 +72,11 @@ export default iterateJsdoc(({
           return;
         }
 
-        if (!moduleCheck.has(mod)) {
+        if (isBuiltinModule(mod)) {
+          // mod = '@types/node';
+          // moduleCheck.set(mod, !deps.has(mod));
+          return;
+        } else if (!moduleCheck.has(mod)) {
           let pkg;
           try {
             pkg = JSON.parse(

src/rules/importsAsDependencies.js

@@ -116,5 +116,26 @@ export default {
          */
       `,
     },
+    {
+      code: `
+        /**
+         * @type {null|import('fs').PathLike}
+         */
+      `,
+    },
+    {
+      code: `
+        /**
+         * @type {null|import('fs/promises').FileHandle}
+         */
+      `,
+    },
+    {
+      code: `
+        /**
+         * @type {null|import('node:fs').PathLike}
+         */
+      `,
+    },
   ],
 };