bahlint 28.58.6934-dev-001

package/bin/eslint.js

@@ -0,0 +1,194 @@
+
+/**
+ * @fileoverview Main CLI that is run via the eslint command.
+ * @author Nicholas C. Zakas
+ */
+
+/* eslint no-console:off -- CLI */
+
+"use strict";
+
+const mod = require("node:module");
+
+// to use V8's code cache to speed up instantiation time
+mod.enableCompileCache?.();
+
+// must do this initialization *before* other requires in order to work
+if (process.argv.includes("--debug")) {
+	require("debug").enable("eslint:*,-eslint:code-path,eslintrc:*");
+}
+
+//------------------------------------------------------------------------------
+// Helpers
+//------------------------------------------------------------------------------
+
+/**
+ * Read data from stdin til the end.
+ *
+ * Note: See
+ * - https://github.com/nodejs/node/blob/master/doc/api/process.md#processstdin
+ * - https://github.com/nodejs/node/blob/master/doc/api/process.md#a-note-on-process-io
+ * - https://lists.gnu.org/archive/html/bug-gnu-emacs/2016-01/msg00419.html
+ * - https://github.com/nodejs/node/issues/7439 (historical)
+ *
+ * On Windows using `fs.readFileSync(STDIN_FILE_DESCRIPTOR, "utf8")` seems
+ * to read 4096 bytes before blocking and never drains to read further data.
+ *
+ * The investigation on the Emacs thread indicates:
+ *
+ * > Emacs on MS-Windows uses pipes to communicate with subprocesses; a
+ * > pipe on Windows has a 4K buffer. So as soon as Emacs writes more than
+ * > 4096 bytes to the pipe, the pipe becomes full, and Emacs then waits for
+ * > the subprocess to read its end of the pipe, at which time Emacs will
+ * > write the rest of the stuff.
+ * @returns {Promise<string>} The read text.
+ */
+function readStdin() {
+	return new Promise((resolve, reject) => {
+		let content = "";
+		let chunk = "";
+
+		process.stdin
+			.setEncoding("utf8")
+			.on("readable", () => {
+				while ((chunk = process.stdin.read()) !== null) {
+					content += chunk;
+				}
+			})
+			.on("end", () => resolve(content))
+			.on("error", reject);
+	});
+}
+
+/**
+ * Get the error message of a given value.
+ * @param {any} error The value to get.
+ * @returns {string} The error message.
+ */
+function getErrorMessage(error) {
+	// Lazy loading because this is used only if an error happened.
+	const util = require("node:util");
+
+	// Foolproof -- third-party module might throw non-object.
+	if (typeof error !== "object" || error === null) {
+		return String(error);
+	}
+
+	// Use templates if `error.messageTemplate` is present.
+	if (typeof error.messageTemplate === "string") {
+		try {
+			const template = require(`../messages/${error.messageTemplate}.js`);
+
+			return template(error.messageData || {});
+		} catch {
+			// Ignore template error then fallback to use `error.stack`.
+		}
+	}
+
+	// Use the stacktrace if it's an error object.
+	if (typeof error.stack === "string") {
+		return error.stack;
+	}
+
+	// Otherwise, dump the object.
+	return util.format("%o", error);
+}
+
+/**
+ * Tracks error messages that are shown to the user so we only ever show the
+ * same message once.
+ * @type {Set<string>}
+ */
+const displayedErrors = new Set();
+
+/**
+ * Tracks whether an unexpected error was caught
+ * @type {boolean}
+ */
+let hadFatalError = false;
+
+/**
+ * Catch and report unexpected error.
+ * @param {any} error The thrown error object.
+ * @returns {void}
+ */
+function onFatalError(error) {
+	process.exitCode = 2;
+	hadFatalError = true;
+
+	const { version } = require("../package.json");
+	const message = `
+Oops! Something went wrong! :(
+
+ESLint: ${version}
+
+${getErrorMessage(error)}`;
+
+	if (!displayedErrors.has(message)) {
+		console.error(message);
+		displayedErrors.add(message);
+	}
+}
+
+//------------------------------------------------------------------------------
+// Execution
+//------------------------------------------------------------------------------
+
+(async function main() {
+	process.on("uncaughtException", onFatalError);
+	process.on("unhandledRejection", onFatalError);
+
+	// Call the config initializer if `--init` is present.
+	if (process.argv.includes("--init")) {
+		// `eslint --init` has been moved to `@eslint/create-config`
+		console.warn(
+			"You can also run this command directly using 'npm init @eslint/config@latest'.",
+		);
+
+		const spawn = require("cross-spawn");
+
+		spawn.sync("npm", ["init", "@eslint/config@latest"], {
+			encoding: "utf8",
+			stdio: "inherit",
+		});
+		return;
+	}
+
+	// start the MCP server if `--mcp` is present
+	if (process.argv.includes("--mcp")) {
+		console.warn(
+			"You can also run this command directly using 'npx @eslint/mcp@latest'.",
+		);
+
+		const spawn = require("cross-spawn");
+
+		spawn.sync("npx", ["@eslint/mcp@latest"], {
+			encoding: "utf8",
+			stdio: "inherit",
+		});
+		return;
+	}
+
+	// Otherwise, call the CLI.
+	const cli = require("../lib/cli");
+	const exitCode = await cli.execute(
+		process.argv,
+		process.argv.includes("--stdin") ? await readStdin() : void 0,
+	);
+
+	/*
+	 * If an uncaught exception or unhandled rejection was detected in the meantime,
+	 * keep the fatal exit code 2 that is already assigned to `process.exitCode`.
+	 * Without this condition, exit code 2 (unsuccessful execution) could be overwritten with
+	 * 1 (successful execution, lint problems found) or even 0 (successful execution, no lint problems found).
+	 * This ensures that unexpected errors that seemingly don't affect the success
+	 * of the execution will still cause a non-zero exit code, as it's a common
+	 * practice and the default behavior of Node.js to exit with non-zero
+	 * in case of an uncaught exception or unhandled rejection.
+	 *
+	 * Otherwise, assign the exit code returned from CLI.
+	 */
+	if (!hadFatalError) {
+		process.exitCode = exitCode;
+	}
+})().catch(onFatalError);

package/conf/ecma-version.js

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Configuration related to ECMAScript versions
+ * @author Milos Djermanovic
+ */
+
+"use strict";
+
+/**
+ * The latest ECMAScript version supported by ESLint.
+ * @type {number} year-based ECMAScript version
+ */
+const LATEST_ECMA_VERSION = 2026;
+
+module.exports = {
+	LATEST_ECMA_VERSION,
+};

package/conf/globals.js

@@ -0,0 +1,169 @@
+/**
+ * @fileoverview Globals for ecmaVersion/sourceType
+ * @author Nicholas C. Zakas
+ */
+
+"use strict";
+
+//-----------------------------------------------------------------------------
+// Globals
+//-----------------------------------------------------------------------------
+
+const commonjs = {
+	exports: true,
+	global: false,
+	module: false,
+	require: false,
+};
+
+const es3 = {
+	Array: false,
+	Boolean: false,
+	constructor: false,
+	Date: false,
+	decodeURI: false,
+	decodeURIComponent: false,
+	encodeURI: false,
+	encodeURIComponent: false,
+	Error: false,
+	escape: false,
+	eval: false,
+	EvalError: false,
+	Function: false,
+	hasOwnProperty: false,
+	Infinity: false,
+	isFinite: false,
+	isNaN: false,
+	isPrototypeOf: false,
+	Math: false,
+	NaN: false,
+	Number: false,
+	Object: false,
+	parseFloat: false,
+	parseInt: false,
+	propertyIsEnumerable: false,
+	RangeError: false,
+	ReferenceError: false,
+	RegExp: false,
+	String: false,
+	SyntaxError: false,
+	toLocaleString: false,
+	toString: false,
+	TypeError: false,
+	undefined: false,
+	unescape: false,
+	URIError: false,
+	valueOf: false,
+};
+
+const es5 = {
+	...es3,
+	JSON: false,
+};
+
+const es2015 = {
+	...es5,
+	ArrayBuffer: false,
+	DataView: false,
+	Float32Array: false,
+	Float64Array: false,
+	Int16Array: false,
+	Int32Array: false,
+	Int8Array: false,
+	Intl: false,
+	Map: false,
+	Promise: false,
+	Proxy: false,
+	Reflect: false,
+	Set: false,
+	Symbol: false,
+	Uint16Array: false,
+	Uint32Array: false,
+	Uint8Array: false,
+	Uint8ClampedArray: false,
+	WeakMap: false,
+	WeakSet: false,
+};
+
+// no new globals in ES2016
+const es2016 = {
+	...es2015,
+};
+
+const es2017 = {
+	...es2016,
+	Atomics: false,
+	SharedArrayBuffer: false,
+};
+
+// no new globals in ES2018
+const es2018 = {
+	...es2017,
+};
+
+// no new globals in ES2019
+const es2019 = {
+	...es2018,
+};
+
+const es2020 = {
+	...es2019,
+	BigInt: false,
+	BigInt64Array: false,
+	BigUint64Array: false,
+	globalThis: false,
+};
+
+const es2021 = {
+	...es2020,
+	AggregateError: false,
+	FinalizationRegistry: false,
+	WeakRef: false,
+};
+
+const es2022 = {
+	...es2021,
+};
+
+const es2023 = {
+	...es2022,
+};
+
+const es2024 = {
+	...es2023,
+};
+
+const es2025 = {
+	...es2024,
+	Float16Array: false,
+	Iterator: false,
+};
+
+const es2026 = {
+	...es2025,
+	AsyncDisposableStack: false,
+	DisposableStack: false,
+	SuppressedError: false,
+};
+
+//-----------------------------------------------------------------------------
+// Exports
+//-----------------------------------------------------------------------------
+
+module.exports = {
+	commonjs,
+	es3,
+	es5,
+	es2015,
+	es2016,
+	es2017,
+	es2018,
+	es2019,
+	es2020,
+	es2021,
+	es2022,
+	es2023,
+	es2024,
+	es2025,
+	es2026,
+};

package/conf/replacements.json

@@ -0,0 +1,26 @@
+{
+  "rules": {
+    "generator-star": ["generator-star-spacing"],
+    "global-strict": ["strict"],
+    "no-arrow-condition": ["no-confusing-arrow", "no-constant-condition"],
+    "no-comma-dangle": ["comma-dangle"],
+    "no-empty-class": ["no-empty-character-class"],
+    "no-empty-label": ["no-labels"],
+    "no-extra-strict": ["strict"],
+    "no-reserved-keys": ["quote-props"],
+    "no-space-before-semi": ["semi-spacing"],
+    "no-wrap-func": ["no-extra-parens"],
+    "space-after-function-name": ["space-before-function-paren"],
+    "space-after-keywords": ["keyword-spacing"],
+    "space-before-function-parentheses": ["space-before-function-paren"],
+    "space-before-keywords": ["keyword-spacing"],
+    "space-in-brackets": [
+      "object-curly-spacing",
+      "array-bracket-spacing",
+      "computed-property-spacing"
+    ],
+    "space-return-throw-case": ["keyword-spacing"],
+    "space-unary-word-ops": ["space-unary-ops"],
+    "spaced-line-comment": ["spaced-comment"]
+  }
+}

package/conf/rule-type-list.json

@@ -0,0 +1,91 @@
+{
+  "types": {
+    "problem": [],
+    "suggestion": [],
+    "layout": []
+  },
+  "deprecated": [],
+  "removed": [
+    {
+      "removed": "generator-star",
+      "replacedBy": [{ "rule": { "name": "generator-star-spacing" } }]
+    },
+    {
+      "removed": "global-strict",
+      "replacedBy": [{ "rule": { "name": "strict" } }]
+    },
+    {
+      "removed": "no-arrow-condition",
+      "replacedBy": [
+        { "rule": { "name": "no-confusing-arrow" } },
+        { "rule": { "name": "no-constant-condition" } }
+      ]
+    },
+    {
+      "removed": "no-comma-dangle",
+      "replacedBy": [{ "rule": { "name": "comma-dangle" } }]
+    },
+    {
+      "removed": "no-empty-class",
+      "replacedBy": [{ "rule": { "name": "no-empty-character-class" } }]
+    },
+    {
+      "removed": "no-empty-label",
+      "replacedBy": [{ "rule": { "name": "no-labels" } }]
+    },
+    {
+      "removed": "no-extra-strict",
+      "replacedBy": [{ "rule": { "name": "strict" } }]
+    },
+    {
+      "removed": "no-reserved-keys",
+      "replacedBy": [{ "rule": { "name": "quote-props" } }]
+    },
+    {
+      "removed": "no-space-before-semi",
+      "replacedBy": [{ "rule": { "name": "semi-spacing" } }]
+    },
+    {
+      "removed": "no-wrap-func",
+      "replacedBy": [{ "rule": { "name": "no-extra-parens" } }]
+    },
+    {
+      "removed": "space-after-function-name",
+      "replacedBy": [{ "rule": { "name": "space-before-function-paren" } }]
+    },
+    {
+      "removed": "space-after-keywords",
+      "replacedBy": [{ "rule": { "name": "keyword-spacing" } }]
+    },
+    {
+      "removed": "space-before-function-parentheses",
+      "replacedBy": [{ "rule": { "name": "space-before-function-paren" } }]
+    },
+    {
+      "removed": "space-before-keywords",
+      "replacedBy": [{ "rule": { "name": "keyword-spacing" } }]
+    },
+    {
+      "removed": "space-in-brackets",
+      "replacedBy": [
+        { "rule": { "name": "object-curly-spacing" } },
+        { "rule": { "name": "array-bracket-spacing" } },
+        { "rule": { "name": "computed-property-spacing" } }
+      ]
+    },
+    {
+      "removed": "space-return-throw-case",
+      "replacedBy": [{ "rule": { "name": "keyword-spacing" } }]
+    },
+    {
+      "removed": "space-unary-word-ops",
+      "replacedBy": [{ "rule": { "name": "space-unary-ops" } }]
+    },
+    {
+      "removed": "spaced-line-comment",
+      "replacedBy": [{ "rule": { "name": "spaced-comment" } }]
+    },
+    { "removed": "valid-jsdoc", "replacedBy": [] },
+    { "removed": "require-jsdoc", "replacedBy": [] }
+  ]
+}

package/lib/api.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Expose out ESLint and CLI to require.
+ * @author Ian Christian Myers
+ */
+
+"use strict";
+
+//-----------------------------------------------------------------------------
+// Requirements
+//-----------------------------------------------------------------------------
+
+const { ESLint } = require("./eslint/eslint");
+const { Linter } = require("./linter");
+const { RuleTester } = require("./rule-tester");
+const { SourceCode } = require("./languages/js/source-code");
+
+//-----------------------------------------------------------------------------
+// Functions
+//-----------------------------------------------------------------------------
+
+/**
+ * Loads the correct `ESLint` constructor.
+ * @returns {Promise<ESLint>} The ESLint constructor.
+ */
+async function loadESLint() {
+	return ESLint;
+}
+
+//-----------------------------------------------------------------------------
+// Exports
+//-----------------------------------------------------------------------------
+
+module.exports = {
+	Linter,
+	loadESLint,
+	ESLint,
+	RuleTester,
+	SourceCode,
+};

package/lib/cli-engine/formatters/formatters-meta.json

@@ -0,0 +1,18 @@
+[
+  {
+    "name": "html",
+    "description": "Outputs results to HTML. The `html` formatter is useful for visual presentation in the browser."
+  },
+  {
+    "name": "json-with-metadata",
+    "description": "Outputs JSON-serialized results. The `json-with-metadata` provides the same linting results as the [`json`](#json) formatter with additional metadata about the rules applied. The linting results are included in the `results` property and the rules metadata is included in the `metadata` property.\n\nAlternatively, you can use the [ESLint Node.js API](../../integrate/nodejs-api) to programmatically use ESLint."
+  },
+  {
+    "name": "json",
+    "description": "Outputs JSON-serialized results. The `json` formatter is useful when you want to programmatically work with the CLI's linting results.\n\nAlternatively, you can use the [ESLint Node.js API](../../integrate/nodejs-api) to programmatically use ESLint."
+  },
+  {
+    "name": "stylish",
+    "description": "Human-readable output format. This is the default formatter."
+  }
+]