refactor: Moved some inplace JSDoc imports out into custom typedefs

espree.js

@@ -66,6 +66,8 @@ import { getLatestEcmaVersion, getSupportedEcmaVersions } from "./lib/options.js
 /**
  * @typedef {import("acorn")} acorn
  * @typedef {import("./lib/options").ParserOptions} ParserOptions
+ * @typedef {import("./lib/token-translator").EsprimaToken} EsprimaToken
+ * @typedef {import("./lib/token-translator").TokenRange} TokenRange
  */
 
 
@@ -107,7 +109,7 @@ const parsers = {
  * Tokenizes the given code.
  * @param {string} code The code to tokenize.
  * @param {ParserOptions} options Options defining how to tokenize.
- * @returns {import("./lib/token-translator.js").EsprimaToken[]} An array of tokens.
+ * @returns {EsprimaToken[]} An array of tokens.
  * @throws {SyntaxError} If the input code is invalid.
  * @private
  */

lib/espree.js

@@ -5,6 +5,7 @@ import { normalizeOptions } from "./options.js";
 
 /**
  * @typedef {import("acorn")} acorn
+ * @typedef {import("./token-translator").Range} Range
  */
 
 const STATE = Symbol("espree's internal state");
@@ -16,7 +17,7 @@ const ESPRIMA_FINISH_NODE = Symbol("espree's esprimaFinishNode");
  * @property {string} text Contents of the comment.
  * @property {number|undefined} start Start column of a comment.
  * @property {number|undefined} end End column of the comment.
- * @property {[number, number]|undefined} range The [start, end] range of a comment.
+ * @property {Range|undefined} range The [start, end] range of a comment.
  * @property {acorn.Position} startLoc End location of the comment.
  * @property {acorn.Position} endLoc End location of the comment.
  */

lib/options.js

@@ -81,6 +81,10 @@ function normalizeSourceType(sourceType = "script") {
     throw new Error("Invalid sourceType.");
 }
 
+/**
+ * @typedef {import("./features").EcmaFeatures} EcmaFeatures
+ */
+
 /**
  * @typedef {Object} ParserOptions
  * @property {boolean} range Whether to include the range information for each node.
@@ -90,7 +94,7 @@ function normalizeSourceType(sourceType = "script") {
  * @property {number|"latest"} ecmaVersion The ECMAScript version to use (between 3 and 13, or 2015 and 2022, or "latest").
  * @property {boolean} allowReserved Only allowed when `ecmaVersion` is set to 3.
  * @property {"script"|"module"|"commonjs"} sourceType The kind of the source string being parsed.
- * @property {import("./features").EcmaFeatures} ecmaFeatures The additional features to enable.
+ * @property {EcmaFeatures} ecmaFeatures The additional features to enable.
  */
 
 /**

lib/token-translator.js

@@ -24,14 +24,18 @@
  * @property {acorn.Position} end The end position.
  */
 
+/**
+ * @typedef {[number, number]} Range
+ */
+
 /**
  * @typedef {Object} EsprimaToken
  * @property {string} type The type of this token.
  * @property {string} value The string content of the token.
  * @property {Location|undefined} loc Location in source text.
  * @property {number|undefined} start start column.
  * @property {number|undefined} end end column.
- * @property {[number, number]|undefined} range [start, end] range
+ * @property {Range|undefined} range [start, end] range
  */
 
 // Esprima Token Types

package.json

@@ -20,8 +20,10 @@
   "files": [
     "lib",
     "dist/espree.cjs",
+    "dist/espree.d.ts",
     "espree.js"
   ],
+  "types": "dist/espree.d.ts",
   "engines": {
     "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
   },