@alexlit/lint-kit 126.5.0 → 126.7.0

package/packages/config-eslint/node_modules/eslint/lib/linter/source-code-fixer.js

@@ -0,0 +1,152 @@
+/**
+ * @fileoverview An object that caches and applies source code fixes.
+ * @author Nicholas C. Zakas
+ */
+"use strict";
+
+//------------------------------------------------------------------------------
+// Requirements
+//------------------------------------------------------------------------------
+
+const debug = require("debug")("eslint:source-code-fixer");
+
+//------------------------------------------------------------------------------
+// Helpers
+//------------------------------------------------------------------------------
+
+const BOM = "\uFEFF";
+
+/**
+ * Compares items in a messages array by range.
+ * @param {Message} a The first message.
+ * @param {Message} b The second message.
+ * @returns {int} -1 if a comes before b, 1 if a comes after b, 0 if equal.
+ * @private
+ */
+function compareMessagesByFixRange(a, b) {
+    return a.fix.range[0] - b.fix.range[0] || a.fix.range[1] - b.fix.range[1];
+}
+
+/**
+ * Compares items in a messages array by line and column.
+ * @param {Message} a The first message.
+ * @param {Message} b The second message.
+ * @returns {int} -1 if a comes before b, 1 if a comes after b, 0 if equal.
+ * @private
+ */
+function compareMessagesByLocation(a, b) {
+    return a.line - b.line || a.column - b.column;
+}
+
+//------------------------------------------------------------------------------
+// Public Interface
+//------------------------------------------------------------------------------
+
+/**
+ * Utility for apply fixes to source code.
+ * @constructor
+ */
+function SourceCodeFixer() {
+    Object.freeze(this);
+}
+
+/**
+ * Applies the fixes specified by the messages to the given text. Tries to be
+ * smart about the fixes and won't apply fixes over the same area in the text.
+ * @param {string} sourceText The text to apply the changes to.
+ * @param {Message[]} messages The array of messages reported by ESLint.
+ * @param {boolean|Function} [shouldFix=true] Determines whether each message should be fixed
+ * @returns {Object} An object containing the fixed text and any unfixed messages.
+ */
+SourceCodeFixer.applyFixes = function(sourceText, messages, shouldFix) {
+    debug("Applying fixes");
+
+    if (shouldFix === false) {
+        debug("shouldFix parameter was false, not attempting fixes");
+        return {
+            fixed: false,
+            messages,
+            output: sourceText
+        };
+    }
+
+    // clone the array
+    const remainingMessages = [],
+        fixes = [],
+        bom = sourceText.startsWith(BOM) ? BOM : "",
+        text = bom ? sourceText.slice(1) : sourceText;
+    let lastPos = Number.NEGATIVE_INFINITY,
+        output = bom;
+
+    /**
+     * Try to use the 'fix' from a problem.
+     * @param {Message} problem The message object to apply fixes from
+     * @returns {boolean} Whether fix was successfully applied
+     */
+    function attemptFix(problem) {
+        const fix = problem.fix;
+        const start = fix.range[0];
+        const end = fix.range[1];
+
+        // Remain it as a problem if it's overlapped or it's a negative range
+        if (lastPos >= start || start > end) {
+            remainingMessages.push(problem);
+            return false;
+        }
+
+        // Remove BOM.
+        if ((start < 0 && end >= 0) || (start === 0 && fix.text.startsWith(BOM))) {
+            output = "";
+        }
+
+        // Make output to this fix.
+        output += text.slice(Math.max(0, lastPos), Math.max(0, start));
+        output += fix.text;
+        lastPos = end;
+        return true;
+    }
+
+    messages.forEach(problem => {
+        if (Object.hasOwn(problem, "fix")) {
+            fixes.push(problem);
+        } else {
+            remainingMessages.push(problem);
+        }
+    });
+
+    if (fixes.length) {
+        debug("Found fixes to apply");
+        let fixesWereApplied = false;
+
+        for (const problem of fixes.sort(compareMessagesByFixRange)) {
+            if (typeof shouldFix !== "function" || shouldFix(problem)) {
+                attemptFix(problem);
+
+                /*
+                 * The only time attemptFix will fail is if a previous fix was
+                 * applied which conflicts with it.  So we can mark this as true.
+                 */
+                fixesWereApplied = true;
+            } else {
+                remainingMessages.push(problem);
+            }
+        }
+        output += text.slice(Math.max(0, lastPos));
+
+        return {
+            fixed: fixesWereApplied,
+            messages: remainingMessages.sort(compareMessagesByLocation),
+            output
+        };
+    }
+
+    debug("No fixes to apply");
+    return {
+        fixed: false,
+        messages,
+        output: bom + text
+    };
+
+};
+
+module.exports = SourceCodeFixer;

package/packages/config-eslint/node_modules/eslint/lib/linter/timing.js

@@ -0,0 +1,169 @@
+/**
+ * @fileoverview Tracks performance of individual rules.
+ * @author Brandon Mills
+ */
+
+"use strict";
+
+const { startTime, endTime } = require("../shared/stats");
+
+//------------------------------------------------------------------------------
+// Helpers
+//------------------------------------------------------------------------------
+
+/* c8 ignore next */
+/**
+ * Align the string to left
+ * @param {string} str string to evaluate
+ * @param {int} len length of the string
+ * @param {string} ch delimiter character
+ * @returns {string} modified string
+ * @private
+ */
+function alignLeft(str, len, ch) {
+    return str + new Array(len - str.length + 1).join(ch || " ");
+}
+
+/* c8 ignore next */
+/**
+ * Align the string to right
+ * @param {string} str string to evaluate
+ * @param {int} len length of the string
+ * @param {string} ch delimiter character
+ * @returns {string} modified string
+ * @private
+ */
+function alignRight(str, len, ch) {
+    return new Array(len - str.length + 1).join(ch || " ") + str;
+}
+
+//------------------------------------------------------------------------------
+// Module definition
+//------------------------------------------------------------------------------
+
+const enabled = !!process.env.TIMING;
+
+const HEADERS = ["Rule", "Time (ms)", "Relative"];
+const ALIGN = [alignLeft, alignRight, alignRight];
+
+/**
+ * Decide how many rules to show in the output list.
+ * @returns {number} the number of rules to show
+ */
+function getListSize() {
+    const MINIMUM_SIZE = 10;
+
+    if (typeof process.env.TIMING !== "string") {
+        return MINIMUM_SIZE;
+    }
+
+    if (process.env.TIMING.toLowerCase() === "all") {
+        return Number.POSITIVE_INFINITY;
+    }
+
+    const TIMING_ENV_VAR_AS_INTEGER = Number.parseInt(process.env.TIMING, 10);
+
+    return TIMING_ENV_VAR_AS_INTEGER > 10 ? TIMING_ENV_VAR_AS_INTEGER : MINIMUM_SIZE;
+}
+
+/* c8 ignore next */
+/**
+ * display the data
+ * @param {Object} data Data object to be displayed
+ * @returns {void} prints modified string with console.log
+ * @private
+ */
+function display(data) {
+    let total = 0;
+    const rows = Object.keys(data)
+        .map(key => {
+            const time = data[key];
+
+            total += time;
+            return [key, time];
+        })
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, getListSize());
+
+    rows.forEach(row => {
+        row.push(`${(row[1] * 100 / total).toFixed(1)}%`);
+        row[1] = row[1].toFixed(3);
+    });
+
+    rows.unshift(HEADERS);
+
+    const widths = [];
+
+    rows.forEach(row => {
+        const len = row.length;
+
+        for (let i = 0; i < len; i++) {
+            const n = row[i].length;
+
+            if (!widths[i] || n > widths[i]) {
+                widths[i] = n;
+            }
+        }
+    });
+
+    const table = rows.map(row => (
+        row
+            .map((cell, index) => ALIGN[index](cell, widths[index]))
+            .join(" | ")
+    ));
+
+    table.splice(1, 0, widths.map((width, index) => {
+        const extraAlignment = index !== 0 && index !== widths.length - 1 ? 2 : 1;
+
+        return ALIGN[index](":", width + extraAlignment, "-");
+    }).join("|"));
+
+    console.log(table.join("\n")); // eslint-disable-line no-console -- Debugging function
+}
+
+/* c8 ignore next */
+module.exports = (function() {
+
+    const data = Object.create(null);
+
+    /**
+     * Time the run
+     * @param {any} key key from the data object
+     * @param {Function} fn function to be called
+     * @param {boolean} stats if 'stats' is true, return the result and the time difference
+     * @returns {Function} function to be executed
+     * @private
+     */
+    function time(key, fn, stats) {
+
+        return function(...args) {
+
+            const t = startTime();
+            const result = fn(...args);
+            const tdiff = endTime(t);
+
+            if (enabled) {
+                if (typeof data[key] === "undefined") {
+                    data[key] = 0;
+                }
+
+                data[key] += tdiff;
+            }
+
+            return stats ? { result, tdiff } : result;
+        };
+    }
+
+    if (enabled) {
+        process.on("exit", () => {
+            display(data);
+        });
+    }
+
+    return {
+        time,
+        enabled,
+        getListSize
+    };
+
+}());

package/packages/config-eslint/node_modules/eslint/lib/linter/vfile.js

@@ -0,0 +1,111 @@
+/**
+ * @fileoverview Virtual file
+ * @author Nicholas C. Zakas
+ */
+
+"use strict";
+
+//-----------------------------------------------------------------------------
+// Type Definitions
+//-----------------------------------------------------------------------------
+
+/** @typedef {import("@eslint/core").File} File */
+
+//------------------------------------------------------------------------------
+// Helpers
+//------------------------------------------------------------------------------
+
+/**
+ * Determines if a given value has a byte order mark (BOM).
+ * @param {string|Uint8Array} value The value to check.
+ * @returns {boolean} `true` if the value has a BOM, `false` otherwise.
+ */
+function hasUnicodeBOM(value) {
+    return typeof value === "string"
+        ? value.charCodeAt(0) === 0xFEFF
+        : value[0] === 0xEF && value[1] === 0xBB && value[2] === 0xBF;
+}
+
+/**
+ * Strips Unicode BOM from the given value.
+ * @param {string|Uint8Array} value The value to remove the BOM from.
+ * @returns {string|Uint8Array} The stripped value.
+ */
+function stripUnicodeBOM(value) {
+
+    if (!hasUnicodeBOM(value)) {
+        return value;
+    }
+
+    if (typeof value === "string") {
+
+        /*
+         * Check Unicode BOM.
+         * In JavaScript, string data is stored as UTF-16, so BOM is 0xFEFF.
+         * http://www.ecma-international.org/ecma-262/6.0/#sec-unicode-format-control-characters
+         */
+        return value.slice(1);
+    }
+
+    /*
+     * In a Uint8Array, the BOM is represented by three bytes: 0xEF, 0xBB, and 0xBF,
+     * so we can just remove the first three bytes.
+     */
+    return value.slice(3);
+}
+
+//------------------------------------------------------------------------------
+// Exports
+//------------------------------------------------------------------------------
+
+/**
+ * Represents a virtual file inside of ESLint.
+ * @implements {File}
+ */
+class VFile {
+
+    /**
+     * The file path including any processor-created virtual path.
+     * @type {string}
+     * @readonly
+     */
+    path;
+
+    /**
+     * The file path on disk.
+     * @type {string}
+     * @readonly
+     */
+    physicalPath;
+
+    /**
+     * The file contents.
+     * @type {string|Uint8Array}
+     * @readonly
+     */
+    body;
+
+    /**
+     * Indicates whether the file has a byte order mark (BOM).
+     * @type {boolean}
+     * @readonly
+     */
+    bom;
+
+    /**
+     * Creates a new instance.
+     * @param {string} path The file path.
+     * @param {string|Uint8Array} body The file contents.
+     * @param {Object} [options] Additional options.
+     * @param {string} [options.physicalPath] The file path on disk.
+     */
+    constructor(path, body, { physicalPath } = {}) {
+        this.path = path;
+        this.physicalPath = physicalPath ?? path;
+        this.bom = hasUnicodeBOM(body);
+        this.body = stripUnicodeBOM(body);
+    }
+
+}
+
+module.exports = { VFile };