bahlint 28.58.6934

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,22 @@
+[
+  {
+    "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."
+  },
+  {
+    "name": "gasoline",
+    "description": "BAHLINT gasoline-themed human-readable"
+  }
+]

package/lib/cli-engine/formatters/gasoline.js

@@ -0,0 +1,168 @@
+/**
+ * @fileoverview Gasoline-themed reporter for Bahlint.
+ * Inspired by the default stylish formatter, but with a fuel-oriented twist.
+ * @author ESLint
+ */
+"use strict";
+
+const util = require("node:util"),
+	table = require("../../shared/text-table");
+
+//------------------------------------------------------------------------------
+// Helpers
+//------------------------------------------------------------------------------
+
+/**
+ * Returns a styling function based on the color option.
+ * @param {boolean|undefined} color Indicates whether to use colors.
+ * @returns {Function} A function that styles text.
+ */
+function getStyleText(color) {
+	if (typeof color === "undefined") {
+		return (format, text) =>
+			util.styleText(format, text, { validateStream: true });
+	}
+	if (color) {
+		return (format, text) =>
+			util.styleText(format, text, { validateStream: false });
+	}
+	return (_, text) => text;
+}
+
+/**
+ * Given a word and a count, append an s if count is not one.
+ * @param {string} word A word in its singular form.
+ * @param {number} count A number controlling whether word should be pluralized.
+ * @returns {string} The original word with an s on the end if count is not one.
+ */
+function pluralize(word, count) {
+	return count === 1 ? word : `${word}s`;
+}
+
+//------------------------------------------------------------------------------
+// Public Interface
+//------------------------------------------------------------------------------
+
+module.exports = function (results, data) {
+	const styleText = getStyleText(data?.color);
+
+	let output = "\n",
+		errorCount = 0,
+		warningCount = 0,
+		fixableErrorCount = 0,
+		fixableWarningCount = 0;
+
+	results.forEach(result => {
+		const messages = result.messages;
+
+		if (messages.length === 0) {
+			return;
+		}
+
+		errorCount += result.errorCount;
+		warningCount += result.warningCount;
+		fixableErrorCount += result.fixableErrorCount;
+		fixableWarningCount += result.fixableWarningCount;
+
+		// Highlight file path like a fuel line.
+		output += `${styleText(
+			"underline",
+			styleText("yellow", result.filePath),
+		)}\n`;
+
+		output += `${table(
+			messages.map(message => {
+				const line = String(message.line || 0);
+				const column = String(message.column || 0);
+				const isError = message.fatal || message.severity === 2;
+
+				const messageType = styleText(
+					isError ? "red" : "yellow",
+					isError ? "ERR" : "WARN",
+				);
+
+				return [
+					"",
+					line,
+					column,
+					messageType,
+					message.message.replace(/([^ ])\.$/u, "$1"),
+					message.ruleId ? styleText("dim", message.ruleId) : "",
+				];
+			}),
+			{
+				align: ["", "r", "l"],
+				stringLength(str) {
+					return util.stripVTControlCharacters(str).length;
+				},
+			},
+		)
+			.split("\n")
+			.map(el =>
+				el.replace(/(\d+)\s+(\d+)/u, (m, p1, p2) =>
+					styleText("dim", `${p1}:${p2}`),
+				),
+			)
+			.join("\n")}\n\n`;
+	});
+
+	const total = errorCount + warningCount;
+
+	/*
+	 * We can't use a single `styleText` call like `styleText([summaryColor, "bold"], text)` here.
+	 * This is a bug in `util.styleText` in Node.js versions earlier than v22.15.0 (https://github.com/nodejs/node/issues/56717).
+	 * As a workaround, we use nested `styleText` calls.
+	 */
+	if (total > 0) {
+		let summaryColor;
+		let statusLabel;
+
+		if (errorCount > 0) {
+			summaryColor = "red";
+			statusLabel = "ENGINE KNOCK";
+		} else {
+			summaryColor = "yellow";
+			statusLabel = "LOW OCTANE";
+		}
+
+		const summaryText = [
+			"[BAHLINT] FUEL STATUS: ",
+			statusLabel,
+			" - ",
+			total,
+			pluralize(" issue", total),
+			" (",
+			errorCount,
+			pluralize(" error", errorCount),
+			", ",
+			warningCount,
+			pluralize(" warning", warningCount),
+			")",
+		].join("");
+
+		output += `${styleText(
+			summaryColor,
+			styleText("bold", summaryText),
+		)}\n`;
+
+		if (fixableErrorCount > 0 || fixableWarningCount > 0) {
+			const fixSummaryText = [
+				"[BAHLINT]  ",
+				fixableErrorCount,
+				pluralize(" error", fixableErrorCount),
+				" and ",
+				fixableWarningCount,
+				pluralize(" warning", fixableWarningCount),
+				" potentially fixable with the `--fix` pit stop.",
+			].join("");
+
+			output += `${styleText(
+				summaryColor,
+				styleText("bold", fixSummaryText),
+			)}\n`;
+		}
+	}
+
+	// Resets output color, to prevent changes on the top level
+	return total > 0 ? styleText("reset", output) : "";
+};