@typescript-eslint/tsconfig-utils 8.32.2-alpha.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 typescript-eslint and other contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,12 @@
+# `@typescript-eslint/tsconfig-utils`
+
+> Utilities for collecting TSConfigs for linting scenarios.
+
+[![NPM Version](https://img.shields.io/npm/v/@typescript-eslint/tsconfig-utils.svg?style=flat-square)](https://www.npmjs.com/package/@typescript-eslint/tsconfig-utils)
+[![NPM Downloads](https://img.shields.io/npm/dm/@typescript-eslint/tsconfig-utils.svg?style=flat-square)](https://www.npmjs.com/package/@typescript-eslint/tsconfig-utils)
+
+The utilities in this package are separated from `@typescript-eslint/utils` so that they do not have a dependency on `eslint` or `@typescript-eslint/typescript-estree`.
+
+> See https://typescript-eslint.io for general documentation on typescript-eslint, the tooling that allows you to run ESLint and Prettier on TypeScript code.
+
+<!-- Local path for docs: docs/packages/TSConfig_Utils.mdx -->

package/dist/compilerOptions.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Compiler options required to avoid critical functionality issues
+ */
+export declare const CORE_COMPILER_OPTIONS: {
+    noEmit: true;
+    noUnusedLocals: true;
+    noUnusedParameters: true;
+};
+//# sourceMappingURL=compilerOptions.d.ts.map

package/dist/compilerOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compilerOptions.d.ts","sourceRoot":"","sources":["../src/compilerOptions.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;CAOJ,CAAC"}

package/dist/compilerOptions.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CORE_COMPILER_OPTIONS = void 0;
+/**
+ * Compiler options required to avoid critical functionality issues
+ */
+exports.CORE_COMPILER_OPTIONS = {
+    // Required to avoid parse from causing emit to occur
+    noEmit: true,
+    // Flags required to make no-unused-vars work
+    noUnusedLocals: true,
+    noUnusedParameters: true,
+};

package/dist/getParsedConfigFile.d.ts

@@ -0,0 +1,9 @@
+import type * as ts from 'typescript/lib/tsserverlibrary';
+/**
+ * Parses a TSConfig file using the same logic as tsserver.
+ *
+ * @param configFile the path to the tsconfig.json file, relative to `projectDirectory`
+ * @param projectDirectory the project directory to use as the CWD, defaults to `process.cwd()`
+ */
+export declare function getParsedConfigFile(tsserver: typeof ts, configFile: string, projectDirectory?: string): ts.ParsedCommandLine;
+//# sourceMappingURL=getParsedConfigFile.d.ts.map

package/dist/getParsedConfigFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getParsedConfigFile.d.ts","sourceRoot":"","sources":["../src/getParsedConfigFile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,gCAAgC,CAAC;AAO1D;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,OAAO,EAAE,EACnB,UAAU,EAAE,MAAM,EAClB,gBAAgB,CAAC,EAAE,MAAM,GACxB,EAAE,CAAC,iBAAiB,CA6CtB"}

package/dist/getParsedConfigFile.js

@@ -0,0 +1,76 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getParsedConfigFile = getParsedConfigFile;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const compilerOptions_1 = require("./compilerOptions");
+/**
+ * Parses a TSConfig file using the same logic as tsserver.
+ *
+ * @param configFile the path to the tsconfig.json file, relative to `projectDirectory`
+ * @param projectDirectory the project directory to use as the CWD, defaults to `process.cwd()`
+ */
+function getParsedConfigFile(tsserver, configFile, projectDirectory) {
+    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition, @typescript-eslint/internal/eqeq-nullish
+    if (tsserver.sys === undefined) {
+        throw new Error('`getParsedConfigFile` is only supported in a Node-like environment.');
+    }
+    const parsed = tsserver.getParsedCommandLineOfConfigFile(configFile, compilerOptions_1.CORE_COMPILER_OPTIONS, {
+        fileExists: fs.existsSync,
+        getCurrentDirectory,
+        onUnRecoverableConfigFileDiagnostic: diag => {
+            throw new Error(formatDiagnostics([diag])); // ensures that `parsed` is defined.
+        },
+        readDirectory: tsserver.sys.readDirectory,
+        readFile: file => fs.readFileSync(path.isAbsolute(file) ? file : path.join(getCurrentDirectory(), file), 'utf-8'),
+        useCaseSensitiveFileNames: tsserver.sys.useCaseSensitiveFileNames,
+    });
+    if (parsed?.errors.length) {
+        throw new Error(formatDiagnostics(parsed.errors));
+    }
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    return parsed;
+    function getCurrentDirectory() {
+        return projectDirectory ? path.resolve(projectDirectory) : process.cwd();
+    }
+    function formatDiagnostics(diagnostics) {
+        return tsserver.formatDiagnostics(diagnostics, {
+            getCanonicalFileName: f => f,
+            getCurrentDirectory,
+            getNewLine: () => '\n',
+        });
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './compilerOptions';
+export * from './getParsedConfigFile';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./compilerOptions"), exports);
+__exportStar(require("./getParsedConfigFile"), exports);

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@typescript-eslint/tsconfig-utils",
+  "version": "8.32.2-alpha.12",
+  "description": "Utilities for collecting TSConfigs for linting scenarios.",
+  "files": [
+    "dist",
+    "!*.tsbuildinfo",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "commonjs",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": "^18.18.0 || ^20.9.0 || >=21.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/typescript-eslint/typescript-eslint.git",
+    "directory": "packages/tsconfig-utils"
+  },
+  "bugs": {
+    "url": "https://github.com/typescript-eslint/typescript-eslint/issues"
+  },
+  "homepage": "https://typescript-eslint.io",
+  "license": "MIT",
+  "keywords": [
+    "eslint",
+    "typescript",
+    "estree"
+  ],
+  "scripts": {
+    "//": "These package scripts are mostly here for convenience. Task running is handled by Nx at the root level.",
+    "build": "yarn run -BT nx build",
+    "clean": "rimraf dist/ coverage/",
+    "format": "yarn run -T format",
+    "lint": "yarn run -BT nx lint",
+    "test": "yarn run -BT nx test",
+    "typecheck": "yarn run -BT nx typecheck"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.8.4 <5.9.0"
+  },
+  "funding": {
+    "type": "opencollective",
+    "url": "https://opencollective.com/typescript-eslint"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "nx": {
+    "name": "tsconfig-utils",
+    "includedScripts": [
+      "clean"
+    ]
+  }
+}