@alexlit/lint-kit 127.0.0 → 127.2.0

package/packages/config-eslint/node_modules/eslint/lib/rules/spaced-comment.js

@@ -1,385 +0,0 @@
-/**
- * @fileoverview Source code for spaced-comments rule
- * @author Gyandeep Singh
- * @deprecated in ESLint v8.53.0
- */
-"use strict";
-
-const escapeRegExp = require("escape-string-regexp");
-const astUtils = require("./utils/ast-utils");
-
-//------------------------------------------------------------------------------
-// Helpers
-//------------------------------------------------------------------------------
-
-/**
- * Escapes the control characters of a given string.
- * @param {string} s A string to escape.
- * @returns {string} An escaped string.
- */
-function escape(s) {
-    return `(?:${escapeRegExp(s)})`;
-}
-
-/**
- * Escapes the control characters of a given string.
- * And adds a repeat flag.
- * @param {string} s A string to escape.
- * @returns {string} An escaped string.
- */
-function escapeAndRepeat(s) {
-    return `${escape(s)}+`;
-}
-
-/**
- * Parses `markers` option.
- * If markers don't include `"*"`, this adds `"*"` to allow JSDoc comments.
- * @param {string[]} [markers] A marker list.
- * @returns {string[]} A marker list.
- */
-function parseMarkersOption(markers) {
-
-    // `*` is a marker for JSDoc comments.
-    if (!markers.includes("*")) {
-        return markers.concat("*");
-    }
-
-    return markers;
-}
-
-/**
- * Creates string pattern for exceptions.
- * Generated pattern:
- *
- * 1. A space or an exception pattern sequence.
- * @param {string[]} exceptions An exception pattern list.
- * @returns {string} A regular expression string for exceptions.
- */
-function createExceptionsPattern(exceptions) {
-    let pattern = "";
-
-    /*
-     * A space or an exception pattern sequence.
-     * []                 ==> "\s"
-     * ["-"]              ==> "(?:\s|\-+$)"
-     * ["-", "="]         ==> "(?:\s|(?:\-+|=+)$)"
-     * ["-", "=", "--=="] ==> "(?:\s|(?:\-+|=+|(?:\-\-==)+)$)" ==> https://jex.im/regulex/#!embed=false&flags=&re=(%3F%3A%5Cs%7C(%3F%3A%5C-%2B%7C%3D%2B%7C(%3F%3A%5C-%5C-%3D%3D)%2B)%24)
-     */
-    if (exceptions.length === 0) {
-
-        // a space.
-        pattern += "\\s";
-    } else {
-
-        // a space or...
-        pattern += "(?:\\s|";
-
-        if (exceptions.length === 1) {
-
-            // a sequence of the exception pattern.
-            pattern += escapeAndRepeat(exceptions[0]);
-        } else {
-
-            // a sequence of one of the exception patterns.
-            pattern += "(?:";
-            pattern += exceptions.map(escapeAndRepeat).join("|");
-            pattern += ")";
-        }
-        pattern += `(?:$|[${Array.from(astUtils.LINEBREAKS).join("")}]))`;
-    }
-
-    return pattern;
-}
-
-/**
- * Creates RegExp object for `always` mode.
- * Generated pattern for beginning of comment:
- *
- * 1. First, a marker or nothing.
- * 2. Next, a space or an exception pattern sequence.
- * @param {string[]} markers A marker list.
- * @param {string[]} exceptions An exception pattern list.
- * @returns {RegExp} A RegExp object for the beginning of a comment in `always` mode.
- */
-function createAlwaysStylePattern(markers, exceptions) {
-    let pattern = "^";
-
-    /*
-     * A marker or nothing.
-     * ["*"]            ==> "\*?"
-     * ["*", "!"]       ==> "(?:\*|!)?"
-     * ["*", "/", "!<"] ==> "(?:\*|\/|(?:!<))?" ==> https://jex.im/regulex/#!embed=false&flags=&re=(%3F%3A%5C*%7C%5C%2F%7C(%3F%3A!%3C))%3F
-     */
-    if (markers.length === 1) {
-
-        // the marker.
-        pattern += escape(markers[0]);
-    } else {
-
-        // one of markers.
-        pattern += "(?:";
-        pattern += markers.map(escape).join("|");
-        pattern += ")";
-    }
-
-    pattern += "?"; // or nothing.
-    pattern += createExceptionsPattern(exceptions);
-
-    return new RegExp(pattern, "u");
-}
-
-/**
- * Creates RegExp object for `never` mode.
- * Generated pattern for beginning of comment:
- *
- * 1. First, a marker or nothing (captured).
- * 2. Next, a space or a tab.
- * @param {string[]} markers A marker list.
- * @returns {RegExp} A RegExp object for `never` mode.
- */
-function createNeverStylePattern(markers) {
-    const pattern = `^(${markers.map(escape).join("|")})?[ \t]+`;
-
-    return new RegExp(pattern, "u");
-}
-
-//------------------------------------------------------------------------------
-// Rule Definition
-//------------------------------------------------------------------------------
-
-/** @type {import('../shared/types').Rule} */
-module.exports = {
-    meta: {
-        deprecated: true,
-        replacedBy: [],
-        type: "suggestion",
-
-        docs: {
-            description: "Enforce consistent spacing after the `//` or `/*` in a comment",
-            recommended: false,
-            url: "https://eslint.org/docs/latest/rules/spaced-comment"
-        },
-
-        fixable: "whitespace",
-
-        schema: [
-            {
-                enum: ["always", "never"]
-            },
-            {
-                type: "object",
-                properties: {
-                    exceptions: {
-                        type: "array",
-                        items: {
-                            type: "string"
-                        }
-                    },
-                    markers: {
-                        type: "array",
-                        items: {
-                            type: "string"
-                        }
-                    },
-                    line: {
-                        type: "object",
-                        properties: {
-                            exceptions: {
-                                type: "array",
-                                items: {
-                                    type: "string"
-                                }
-                            },
-                            markers: {
-                                type: "array",
-                                items: {
-                                    type: "string"
-                                }
-                            }
-                        },
-                        additionalProperties: false
-                    },
-                    block: {
-                        type: "object",
-                        properties: {
-                            exceptions: {
-                                type: "array",
-                                items: {
-                                    type: "string"
-                                }
-                            },
-                            markers: {
-                                type: "array",
-                                items: {
-                                    type: "string"
-                                }
-                            },
-                            balanced: {
-                                type: "boolean",
-                                default: false
-                            }
-                        },
-                        additionalProperties: false
-                    }
-                },
-                additionalProperties: false
-            }
-        ],
-
-        messages: {
-            unexpectedSpaceAfterMarker: "Unexpected space or tab after marker ({{refChar}}) in comment.",
-            expectedExceptionAfter: "Expected exception block, space or tab after '{{refChar}}' in comment.",
-            unexpectedSpaceBefore: "Unexpected space or tab before '*/' in comment.",
-            unexpectedSpaceAfter: "Unexpected space or tab after '{{refChar}}' in comment.",
-            expectedSpaceBefore: "Expected space or tab before '*/' in comment.",
-            expectedSpaceAfter: "Expected space or tab after '{{refChar}}' in comment."
-        }
-    },
-
-    create(context) {
-
-        const sourceCode = context.sourceCode;
-
-        // Unless the first option is never, require a space
-        const requireSpace = context.options[0] !== "never";
-
-        /*
-         * Parse the second options.
-         * If markers don't include `"*"`, it's added automatically for JSDoc
-         * comments.
-         */
-        const config = context.options[1] || {};
-        const balanced = config.block && config.block.balanced;
-
-        const styleRules = ["block", "line"].reduce((rule, type) => {
-            const markers = parseMarkersOption(config[type] && config[type].markers || config.markers || []);
-            const exceptions = config[type] && config[type].exceptions || config.exceptions || [];
-            const endNeverPattern = "[ \t]+$";
-
-            // Create RegExp object for valid patterns.
-            rule[type] = {
-                beginRegex: requireSpace ? createAlwaysStylePattern(markers, exceptions) : createNeverStylePattern(markers),
-                endRegex: balanced && requireSpace ? new RegExp(`${createExceptionsPattern(exceptions)}$`, "u") : new RegExp(endNeverPattern, "u"),
-                hasExceptions: exceptions.length > 0,
-                captureMarker: new RegExp(`^(${markers.map(escape).join("|")})`, "u"),
-                markers: new Set(markers)
-            };
-
-            return rule;
-        }, {});
-
-        /**
-         * Reports a beginning spacing error with an appropriate message.
-         * @param {ASTNode} node A comment node to check.
-         * @param {string} messageId An error message to report.
-         * @param {Array} match An array of match results for markers.
-         * @param {string} refChar Character used for reference in the error message.
-         * @returns {void}
-         */
-        function reportBegin(node, messageId, match, refChar) {
-            const type = node.type.toLowerCase(),
-                commentIdentifier = type === "block" ? "/*" : "//";
-
-            context.report({
-                node,
-                fix(fixer) {
-                    const start = node.range[0];
-                    let end = start + 2;
-
-                    if (requireSpace) {
-                        if (match) {
-                            end += match[0].length;
-                        }
-                        return fixer.insertTextAfterRange([start, end], " ");
-                    }
-                    end += match[0].length;
-                    return fixer.replaceTextRange([start, end], commentIdentifier + (match[1] ? match[1] : ""));
-
-                },
-                messageId,
-                data: { refChar }
-            });
-        }
-
-        /**
-         * Reports an ending spacing error with an appropriate message.
-         * @param {ASTNode} node A comment node to check.
-         * @param {string} messageId An error message to report.
-         * @param {string} match An array of the matched whitespace characters.
-         * @returns {void}
-         */
-        function reportEnd(node, messageId, match) {
-            context.report({
-                node,
-                fix(fixer) {
-                    if (requireSpace) {
-                        return fixer.insertTextAfterRange([node.range[0], node.range[1] - 2], " ");
-                    }
-                    const end = node.range[1] - 2,
-                        start = end - match[0].length;
-
-                    return fixer.replaceTextRange([start, end], "");
-
-                },
-                messageId
-            });
-        }
-
-        /**
-         * Reports a given comment if it's invalid.
-         * @param {ASTNode} node a comment node to check.
-         * @returns {void}
-         */
-        function checkCommentForSpace(node) {
-            const type = node.type.toLowerCase(),
-                rule = styleRules[type],
-                commentIdentifier = type === "block" ? "/*" : "//";
-
-            // Ignores empty comments and comments that consist only of a marker.
-            if (node.value.length === 0 || rule.markers.has(node.value)) {
-                return;
-            }
-
-            const beginMatch = rule.beginRegex.exec(node.value);
-            const endMatch = rule.endRegex.exec(node.value);
-
-            // Checks.
-            if (requireSpace) {
-                if (!beginMatch) {
-                    const hasMarker = rule.captureMarker.exec(node.value);
-                    const marker = hasMarker ? commentIdentifier + hasMarker[0] : commentIdentifier;
-
-                    if (rule.hasExceptions) {
-                        reportBegin(node, "expectedExceptionAfter", hasMarker, marker);
-                    } else {
-                        reportBegin(node, "expectedSpaceAfter", hasMarker, marker);
-                    }
-                }
-
-                if (balanced && type === "block" && !endMatch) {
-                    reportEnd(node, "expectedSpaceBefore");
-                }
-            } else {
-                if (beginMatch) {
-                    if (!beginMatch[1]) {
-                        reportBegin(node, "unexpectedSpaceAfter", beginMatch, commentIdentifier);
-                    } else {
-                        reportBegin(node, "unexpectedSpaceAfterMarker", beginMatch, beginMatch[1]);
-                    }
-                }
-
-                if (balanced && type === "block" && endMatch) {
-                    reportEnd(node, "unexpectedSpaceBefore", endMatch);
-                }
-            }
-        }
-
-        return {
-            Program() {
-                const comments = sourceCode.getAllComments();
-
-                comments.filter(token => token.type !== "Shebang").forEach(checkCommentForSpace);
-            }
-        };
-    }
-};

package/packages/config-eslint/node_modules/eslint/lib/rules/strict.js

@@ -1,277 +0,0 @@
-/**
- * @fileoverview Rule to control usage of strict mode directives.
- * @author Brandon Mills
- */
-
-"use strict";
-
-//------------------------------------------------------------------------------
-// Requirements
-//------------------------------------------------------------------------------
-
-const astUtils = require("./utils/ast-utils");
-
-//------------------------------------------------------------------------------
-// Helpers
-//------------------------------------------------------------------------------
-
-/**
- * Gets all of the Use Strict Directives in the Directive Prologue of a group of
- * statements.
- * @param {ASTNode[]} statements Statements in the program or function body.
- * @returns {ASTNode[]} All of the Use Strict Directives.
- */
-function getUseStrictDirectives(statements) {
-    const directives = [];
-
-    for (let i = 0; i < statements.length; i++) {
-        const statement = statements[i];
-
-        if (
-            statement.type === "ExpressionStatement" &&
-            statement.expression.type === "Literal" &&
-            statement.expression.value === "use strict"
-        ) {
-            directives[i] = statement;
-        } else {
-            break;
-        }
-    }
-
-    return directives;
-}
-
-/**
- * Checks whether a given parameter is a simple parameter.
- * @param {ASTNode} node A pattern node to check.
- * @returns {boolean} `true` if the node is an Identifier node.
- */
-function isSimpleParameter(node) {
-    return node.type === "Identifier";
-}
-
-/**
- * Checks whether a given parameter list is a simple parameter list.
- * @param {ASTNode[]} params A parameter list to check.
- * @returns {boolean} `true` if the every parameter is an Identifier node.
- */
-function isSimpleParameterList(params) {
-    return params.every(isSimpleParameter);
-}
-
-//------------------------------------------------------------------------------
-// Rule Definition
-//------------------------------------------------------------------------------
-
-/** @type {import('../shared/types').Rule} */
-module.exports = {
-    meta: {
-        type: "suggestion",
-
-        docs: {
-            description: "Require or disallow strict mode directives",
-            recommended: false,
-            url: "https://eslint.org/docs/latest/rules/strict"
-        },
-
-        schema: [
-            {
-                enum: ["never", "global", "function", "safe"]
-            }
-        ],
-
-        fixable: "code",
-        messages: {
-            function: "Use the function form of 'use strict'.",
-            global: "Use the global form of 'use strict'.",
-            multiple: "Multiple 'use strict' directives.",
-            never: "Strict mode is not permitted.",
-            unnecessary: "Unnecessary 'use strict' directive.",
-            module: "'use strict' is unnecessary inside of modules.",
-            implied: "'use strict' is unnecessary when implied strict mode is enabled.",
-            unnecessaryInClasses: "'use strict' is unnecessary inside of classes.",
-            nonSimpleParameterList: "'use strict' directive inside a function with non-simple parameter list throws a syntax error since ES2016.",
-            wrap: "Wrap {{name}} in a function with 'use strict' directive."
-        }
-    },
-
-    create(context) {
-
-        const ecmaFeatures = context.parserOptions.ecmaFeatures || {},
-            scopes = [],
-            classScopes = [];
-        let mode = context.options[0] || "safe";
-
-        if (ecmaFeatures.impliedStrict) {
-            mode = "implied";
-        } else if (mode === "safe") {
-            mode = ecmaFeatures.globalReturn || context.languageOptions.sourceType === "commonjs" ? "global" : "function";
-        }
-
-        /**
-         * Determines whether a reported error should be fixed, depending on the error type.
-         * @param {string} errorType The type of error
-         * @returns {boolean} `true` if the reported error should be fixed
-         */
-        function shouldFix(errorType) {
-            return errorType === "multiple" || errorType === "unnecessary" || errorType === "module" || errorType === "implied" || errorType === "unnecessaryInClasses";
-        }
-
-        /**
-         * Gets a fixer function to remove a given 'use strict' directive.
-         * @param {ASTNode} node The directive that should be removed
-         * @returns {Function} A fixer function
-         */
-        function getFixFunction(node) {
-            return fixer => fixer.remove(node);
-        }
-
-        /**
-         * Report a slice of an array of nodes with a given message.
-         * @param {ASTNode[]} nodes Nodes.
-         * @param {string} start Index to start from.
-         * @param {string} end Index to end before.
-         * @param {string} messageId Message to display.
-         * @param {boolean} fix `true` if the directive should be fixed (i.e. removed)
-         * @returns {void}
-         */
-        function reportSlice(nodes, start, end, messageId, fix) {
-            nodes.slice(start, end).forEach(node => {
-                context.report({ node, messageId, fix: fix ? getFixFunction(node) : null });
-            });
-        }
-
-        /**
-         * Report all nodes in an array with a given message.
-         * @param {ASTNode[]} nodes Nodes.
-         * @param {string} messageId Message id to display.
-         * @param {boolean} fix `true` if the directive should be fixed (i.e. removed)
-         * @returns {void}
-         */
-        function reportAll(nodes, messageId, fix) {
-            reportSlice(nodes, 0, nodes.length, messageId, fix);
-        }
-
-        /**
-         * Report all nodes in an array, except the first, with a given message.
-         * @param {ASTNode[]} nodes Nodes.
-         * @param {string} messageId Message id to display.
-         * @param {boolean} fix `true` if the directive should be fixed (i.e. removed)
-         * @returns {void}
-         */
-        function reportAllExceptFirst(nodes, messageId, fix) {
-            reportSlice(nodes, 1, nodes.length, messageId, fix);
-        }
-
-        /**
-         * Entering a function in 'function' mode pushes a new nested scope onto the
-         * stack. The new scope is true if the nested function is strict mode code.
-         * @param {ASTNode} node The function declaration or expression.
-         * @param {ASTNode[]} useStrictDirectives The Use Strict Directives of the node.
-         * @returns {void}
-         */
-        function enterFunctionInFunctionMode(node, useStrictDirectives) {
-            const isInClass = classScopes.length > 0,
-                isParentGlobal = scopes.length === 0 && classScopes.length === 0,
-                isParentStrict = scopes.length > 0 && scopes.at(-1),
-                isStrict = useStrictDirectives.length > 0;
-
-            if (isStrict) {
-                if (!isSimpleParameterList(node.params)) {
-                    context.report({ node: useStrictDirectives[0], messageId: "nonSimpleParameterList" });
-                } else if (isParentStrict) {
-                    context.report({ node: useStrictDirectives[0], messageId: "unnecessary", fix: getFixFunction(useStrictDirectives[0]) });
-                } else if (isInClass) {
-                    context.report({ node: useStrictDirectives[0], messageId: "unnecessaryInClasses", fix: getFixFunction(useStrictDirectives[0]) });
-                }
-
-                reportAllExceptFirst(useStrictDirectives, "multiple", true);
-            } else if (isParentGlobal) {
-                if (isSimpleParameterList(node.params)) {
-                    context.report({ node, messageId: "function" });
-                } else {
-                    context.report({
-                        node,
-                        messageId: "wrap",
-                        data: { name: astUtils.getFunctionNameWithKind(node) }
-                    });
-                }
-            }
-
-            scopes.push(isParentStrict || isStrict);
-        }
-
-        /**
-         * Exiting a function in 'function' mode pops its scope off the stack.
-         * @returns {void}
-         */
-        function exitFunctionInFunctionMode() {
-            scopes.pop();
-        }
-
-        /**
-         * Enter a function and either:
-         * - Push a new nested scope onto the stack (in 'function' mode).
-         * - Report all the Use Strict Directives (in the other modes).
-         * @param {ASTNode} node The function declaration or expression.
-         * @returns {void}
-         */
-        function enterFunction(node) {
-            const isBlock = node.body.type === "BlockStatement",
-                useStrictDirectives = isBlock
-                    ? getUseStrictDirectives(node.body.body) : [];
-
-            if (mode === "function") {
-                enterFunctionInFunctionMode(node, useStrictDirectives);
-            } else if (useStrictDirectives.length > 0) {
-                if (isSimpleParameterList(node.params)) {
-                    reportAll(useStrictDirectives, mode, shouldFix(mode));
-                } else {
-                    context.report({ node: useStrictDirectives[0], messageId: "nonSimpleParameterList" });
-                    reportAllExceptFirst(useStrictDirectives, "multiple", true);
-                }
-            }
-        }
-
-        const rule = {
-            Program(node) {
-                const useStrictDirectives = getUseStrictDirectives(node.body);
-
-                if (node.sourceType === "module") {
-                    mode = "module";
-                }
-
-                if (mode === "global") {
-                    if (node.body.length > 0 && useStrictDirectives.length === 0) {
-                        context.report({ node, messageId: "global" });
-                    }
-                    reportAllExceptFirst(useStrictDirectives, "multiple", true);
-                } else {
-                    reportAll(useStrictDirectives, mode, shouldFix(mode));
-                }
-            },
-            FunctionDeclaration: enterFunction,
-            FunctionExpression: enterFunction,
-            ArrowFunctionExpression: enterFunction
-        };
-
-        if (mode === "function") {
-            Object.assign(rule, {
-
-                // Inside of class bodies are always strict mode.
-                ClassBody() {
-                    classScopes.push(true);
-                },
-                "ClassBody:exit"() {
-                    classScopes.pop();
-                },
-
-                "FunctionDeclaration:exit": exitFunctionInFunctionMode,
-                "FunctionExpression:exit": exitFunctionInFunctionMode,
-                "ArrowFunctionExpression:exit": exitFunctionInFunctionMode
-            });
-        }
-
-        return rule;
-    }
-};