[Tests] cover eslint 10 getTokenOrComment and listFilesToProcess fallbacks

Exercise both branches of the `getTokenOrComment{Before,After}` shims,
and the `listFilesToProcess` fallback to
`listFilesWithNodeFs` when the legacy `glob-utils` module is no longer exported
(`ERR_PACKAGE_PATH_NOT_EXPORTED`, eslint 10)
in addition to the existing `MODULE_NOT_FOUND` case.

Author: captaindonald

CHANGELOG.md

@@ -25,6 +25,7 @@ This change log adheres to standards from [Keep a CHANGELOG](https://keepachange
 ### Changed
 - [Refactor] [`order`]: extract the ESLint 10 token/comment compatibility shims into a reusable `getTokenOrComment` util ([#3230], thanks [@captaindonald])
 - [Tests] add parser version guards for ESLint v10 (TS_NEW / ANGULAR / BABEL_NEW) ([#3230], thanks [@rasmi])
+- [Tests] cover ESLint 10 `getTokenOrComment` and `listFilesToProcess` API fallbacks ([#3230], thanks [@captaindonald])
 - [Docs] `no-unused-modules`: Fix docs of `ignoreUnusedTypeExports` option ([#3233], thanks [@ej612])
 
 ## [2.32.0] - 2025-06-20

tests/src/core/getTokenOrComment.js

@@ -0,0 +1,62 @@
+import { expect } from 'chai';
+
+import { getTokenOrCommentAfter, getTokenOrCommentBefore } from 'core/getTokenOrComment';
+
+// These helpers feature-detect the `SourceCode` API that ESLint v10 removed, so both
+// branches need to be exercised regardless of which `eslint` version the tests run on.
+describe('getTokenOrComment', function () {
+  const node = { type: 'Node' };
+  const token = { type: 'Token' };
+
+  describe('getTokenOrCommentAfter', function () {
+    it('uses sourceCode.getTokenOrCommentAfter when present (ESLint < 10)', function () {
+      const calls = [];
+      const sourceCode = {
+        getTokenOrCommentAfter(nodeOrToken) {
+          calls.push(nodeOrToken);
+          return token;
+        },
+      };
+      expect(getTokenOrCommentAfter(sourceCode, node)).to.equal(token);
+      expect(calls).to.deep.equal([node]);
+    });
+
+    it('falls back to getTokenAfter with includeComments (ESLint >= 10)', function () {
+      let received;
+      const sourceCode = {
+        getTokenAfter(nodeOrToken, options) {
+          received = { nodeOrToken, options };
+          return token;
+        },
+      };
+      expect(getTokenOrCommentAfter(sourceCode, node)).to.equal(token);
+      expect(received).to.deep.equal({ nodeOrToken: node, options: { includeComments: true } });
+    });
+  });
+
+  describe('getTokenOrCommentBefore', function () {
+    it('uses sourceCode.getTokenOrCommentBefore when present (ESLint < 10)', function () {
+      const calls = [];
+      const sourceCode = {
+        getTokenOrCommentBefore(nodeOrToken) {
+          calls.push(nodeOrToken);
+          return token;
+        },
+      };
+      expect(getTokenOrCommentBefore(sourceCode, node)).to.equal(token);
+      expect(calls).to.deep.equal([node]);
+    });
+
+    it('falls back to getTokenBefore with includeComments (ESLint >= 10)', function () {
+      let received;
+      const sourceCode = {
+        getTokenBefore(nodeOrToken, options) {
+          received = { nodeOrToken, options };
+          return token;
+        },
+      };
+      expect(getTokenOrCommentBefore(sourceCode, node)).to.equal(token);
+      expect(received).to.deep.equal({ nodeOrToken: node, options: { includeComments: true } });
+    });
+  });
+});

tests/src/core/listFilesToProcess.js

@@ -33,6 +33,14 @@ function moduleNotFound() {
   throw e;
 }
 
+// ESLint v10 removed the legacy `glob-utils` from the package's `exports` map, so
+// requiring it throws `ERR_PACKAGE_PATH_NOT_EXPORTED` rather than `MODULE_NOT_FOUND`.
+function packagePathNotExported() {
+  const e = new Error('Package subpath \'./lib/util/glob-utils\' is not defined by "exports"');
+  e.code = 'ERR_PACKAGE_PATH_NOT_EXPORTED';
+  throw e;
+}
+
 describe('listFilesToProcess', function () {
   describe('listFilesUsingFileEnumerator', function () {
     const originalFlatConfig = process.env.ESLINT_USE_FLAT_CONFIG;
@@ -93,6 +101,15 @@ describe('listFilesToProcess', function () {
       expect(result).to.deep.equal([f('src', 'a.js')]);
     });
 
+    // ESLint v10+: requiring the removed legacy module throws ERR_PACKAGE_PATH_NOT_EXPORTED.
+    it('falls back to listFilesWithNodeFs when the legacy module is no longer exported', function () {
+      const result = listFilesToProcess([f('src', 'a*.js')], ['.js'], {
+        getFileEnumerator: () => undefined,
+        getLegacyFiles: packagePathNotExported,
+      });
+      expect(result).to.deep.equal([f('src', 'a.js')]);
+    });
+
     it('rethrows non-module-resolution errors from the legacy path', function () {
       expect(() => listFilesToProcess([root], ['.js'], {
         getFileEnumerator: () => undefined,