less 3.10.1 → 3.11.1

package/packages/less/node_modules/eslint/lib/util/config-comment-parser.js

@@ -0,0 +1,141 @@
+/**
+ * @fileoverview Config Comment Parser
+ * @author Nicholas C. Zakas
+ */
+
+/* eslint-disable class-methods-use-this*/
+"use strict";
+
+//------------------------------------------------------------------------------
+// Requirements
+//------------------------------------------------------------------------------
+
+const levn = require("levn"),
+    ConfigOps = require("../config/config-ops");
+
+const debug = require("debug")("eslint:config-comment-parser");
+
+//------------------------------------------------------------------------------
+// Public Interface
+//------------------------------------------------------------------------------
+
+/**
+ * Object to parse ESLint configuration comments inside JavaScript files.
+ * @name ConfigCommentParser
+ */
+module.exports = class ConfigCommentParser {
+
+    /**
+     * Parses a list of "name:string_value" or/and "name" options divided by comma or
+     * whitespace. Used for "global" and "exported" comments.
+     * @param {string} string The string to parse.
+     * @param {Comment} comment The comment node which has the string.
+     * @returns {Object} Result map object of names and string values, or null values if no value was provided
+     */
+    parseStringConfig(string, comment) {
+        debug("Parsing String config");
+
+        const items = {};
+
+        // Collapse whitespace around `:` and `,` to make parsing easier
+        const trimmedString = string.replace(/\s*([:,])\s*/gu, "$1");
+
+        trimmedString.split(/\s|,+/u).forEach(name => {
+            if (!name) {
+                return;
+            }
+
+            // value defaults to null (if not provided), e.g: "foo" => ["foo", null]
+            const [key, value = null] = name.split(":");
+
+            items[key] = { value, comment };
+        });
+        return items;
+    }
+
+    /**
+     * Parses a JSON-like config.
+     * @param {string} string The string to parse.
+     * @param {Object} location Start line and column of comments for potential error message.
+     * @returns {({success: true, config: Object}|{success: false, error: Problem})} Result map object
+     */
+    parseJsonConfig(string, location) {
+        debug("Parsing JSON config");
+
+        let items = {};
+
+        // Parses a JSON-like comment by the same way as parsing CLI option.
+        try {
+            items = levn.parse("Object", string) || {};
+
+            // Some tests say that it should ignore invalid comments such as `/*eslint no-alert:abc*/`.
+            // Also, commaless notations have invalid severity:
+            //     "no-alert: 2 no-console: 2" --> {"no-alert": "2 no-console: 2"}
+            // Should ignore that case as well.
+            if (ConfigOps.isEverySeverityValid(items)) {
+                return {
+                    success: true,
+                    config: items
+                };
+            }
+        } catch (ex) {
+
+            debug("Levn parsing failed; falling back to manual parsing.");
+
+            // ignore to parse the string by a fallback.
+        }
+
+        /*
+         * Optionator cannot parse commaless notations.
+         * But we are supporting that. So this is a fallback for that.
+         */
+        items = {};
+        const normalizedString = string.replace(/([a-zA-Z0-9\-/]+):/gu, "\"$1\":").replace(/(\]|[0-9])\s+(?=")/u, "$1,");
+
+        try {
+            items = JSON.parse(`{${normalizedString}}`);
+        } catch (ex) {
+            debug("Manual parsing failed.");
+
+            return {
+                success: false,
+                error: {
+                    ruleId: null,
+                    fatal: true,
+                    severity: 2,
+                    message: `Failed to parse JSON from '${normalizedString}': ${ex.message}`,
+                    line: location.start.line,
+                    column: location.start.column + 1
+                }
+            };
+
+        }
+
+        return {
+            success: true,
+            config: items
+        };
+    }
+
+    /**
+     * Parses a config of values separated by comma.
+     * @param {string} string The string to parse.
+     * @returns {Object} Result map of values and true values
+     */
+    parseListConfig(string) {
+        debug("Parsing list config");
+
+        const items = {};
+
+        // Collapse whitespace around commas
+        string.replace(/\s*,\s*/gu, ",").split(/,+/u).forEach(name => {
+            const trimmedName = name.trim();
+
+            if (trimmedName) {
+                items[trimmedName] = true;
+            }
+        });
+        return items;
+    }
+
+};

package/packages/less/node_modules/eslint/lib/util/file-finder.js

@@ -0,0 +1,144 @@
+/**
+ * @fileoverview Util class to find config files.
+ * @author Aliaksei Shytkin
+ */
+
+"use strict";
+
+//------------------------------------------------------------------------------
+// Requirements
+//------------------------------------------------------------------------------
+
+const fs = require("fs"),
+    path = require("path");
+
+//------------------------------------------------------------------------------
+// Helpers
+//------------------------------------------------------------------------------
+
+/**
+ * Get the entries for a directory. Including a try-catch may be detrimental to
+ * function performance, so move it out here a separate function.
+ * @param {string} directory The directory to search in.
+ * @returns {string[]} The entries in the directory or an empty array on error.
+ * @private
+ */
+function getDirectoryEntries(directory) {
+    try {
+
+        return fs.readdirSync(directory);
+    } catch (ex) {
+        return [];
+    }
+}
+
+/**
+ * Create a hash of filenames from a directory listing
+ * @param {string[]} entries Array of directory entries.
+ * @param {string} directory Path to a current directory.
+ * @param {string[]} supportedConfigs List of support filenames.
+ * @returns {Object} Hashmap of filenames
+ */
+function normalizeDirectoryEntries(entries, directory, supportedConfigs) {
+    const fileHash = {};
+
+    entries.forEach(entry => {
+        if (supportedConfigs.indexOf(entry) >= 0) {
+            const resolvedEntry = path.resolve(directory, entry);
+
+            if (fs.statSync(resolvedEntry).isFile()) {
+                fileHash[entry] = resolvedEntry;
+            }
+        }
+    });
+    return fileHash;
+}
+
+//------------------------------------------------------------------------------
+// API
+//------------------------------------------------------------------------------
+
+/**
+ * FileFinder class
+ */
+class FileFinder {
+
+    /**
+     * @param {string[]} files The basename(s) of the file(s) to find.
+     * @param {stirng} cwd Current working directory
+     */
+    constructor(files, cwd) {
+        this.fileNames = Array.isArray(files) ? files : [files];
+        this.cwd = cwd || process.cwd();
+        this.cache = {};
+    }
+
+    /**
+     * Find all instances of files with the specified file names, in directory and
+     * parent directories. Cache the results.
+     * Does not check if a matching directory entry is a file.
+     * Searches for all the file names in this.fileNames.
+     * Is currently used by lib/config.js to find .eslintrc and package.json files.
+     * @param  {string} relativeDirectory The directory to start the search from.
+     * @returns {GeneratorFunction} to iterate the file paths found
+     */
+    *findAllInDirectoryAndParents(relativeDirectory) {
+        const cache = this.cache;
+
+        const initialDirectory = relativeDirectory
+            ? path.resolve(this.cwd, relativeDirectory)
+            : this.cwd;
+
+        if (Object.prototype.hasOwnProperty.call(cache, initialDirectory)) {
+            yield* cache[initialDirectory];
+            return; // to avoid doing the normal loop afterwards
+        }
+
+        const dirs = [];
+        const fileNames = this.fileNames;
+        let searched = 0;
+        let directory = initialDirectory;
+
+        do {
+            dirs[searched++] = directory;
+            cache[directory] = [];
+
+            const filesMap = normalizeDirectoryEntries(getDirectoryEntries(directory), directory, fileNames);
+
+            if (Object.keys(filesMap).length) {
+                for (let k = 0; k < fileNames.length; k++) {
+
+                    if (filesMap[fileNames[k]]) {
+                        const filePath = filesMap[fileNames[k]];
+
+                        // Add the file path to the cache of each directory searched.
+                        for (let j = 0; j < searched; j++) {
+                            cache[dirs[j]].push(filePath);
+                        }
+                        yield filePath;
+                        break;
+                    }
+                }
+            }
+
+            const child = directory;
+
+            // Assign parent directory to directory.
+            directory = path.dirname(directory);
+
+            if (directory === child) {
+                return;
+            }
+
+        } while (!Object.prototype.hasOwnProperty.call(cache, directory));
+
+        // Add what has been cached previously to the cache of each directory searched.
+        for (let i = 0; i < searched; i++) {
+            cache[dirs[i]].push(...cache[directory]);
+        }
+
+        yield* cache[dirs[0]];
+    }
+}
+
+module.exports = FileFinder;

package/packages/less/node_modules/eslint/lib/util/fix-tracker.js

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview Helper class to aid in constructing fix commands.
+ * @author Alan Pierce
+ */
+"use strict";
+
+//------------------------------------------------------------------------------
+// Requirements
+//------------------------------------------------------------------------------
+
+const astUtils = require("../util/ast-utils");
+
+//------------------------------------------------------------------------------
+// Public Interface
+//------------------------------------------------------------------------------
+
+/**
+ * A helper class to combine fix options into a fix command. Currently, it
+ * exposes some "retain" methods that extend the range of the text being
+ * replaced so that other fixes won't touch that region in the same pass.
+ */
+class FixTracker {
+
+    /**
+     * Create a new FixTracker.
+     *
+     * @param {ruleFixer} fixer A ruleFixer instance.
+     * @param {SourceCode} sourceCode A SourceCode object for the current code.
+     */
+    constructor(fixer, sourceCode) {
+        this.fixer = fixer;
+        this.sourceCode = sourceCode;
+        this.retainedRange = null;
+    }
+
+    /**
+     * Mark the given range as "retained", meaning that other fixes may not
+     * may not modify this region in the same pass.
+     *
+     * @param {int[]} range The range to retain.
+     * @returns {FixTracker} The same RuleFixer, for chained calls.
+     */
+    retainRange(range) {
+        this.retainedRange = range;
+        return this;
+    }
+
+    /**
+     * Given a node, find the function containing it (or the entire program) and
+     * mark it as retained, meaning that other fixes may not modify it in this
+     * pass. This is useful for avoiding conflicts in fixes that modify control
+     * flow.
+     *
+     * @param {ASTNode} node The node to use as a starting point.
+     * @returns {FixTracker} The same RuleFixer, for chained calls.
+     */
+    retainEnclosingFunction(node) {
+        const functionNode = astUtils.getUpperFunction(node);
+
+        return this.retainRange(functionNode ? functionNode.range : this.sourceCode.ast.range);
+    }
+
+    /**
+     * Given a node or token, find the token before and afterward, and mark that
+     * range as retained, meaning that other fixes may not modify it in this
+     * pass. This is useful for avoiding conflicts in fixes that make a small
+     * change to the code where the AST should not be changed.
+     *
+     * @param {ASTNode|Token} nodeOrToken The node or token to use as a starting
+     *      point. The token to the left and right are use in the range.
+     * @returns {FixTracker} The same RuleFixer, for chained calls.
+     */
+    retainSurroundingTokens(nodeOrToken) {
+        const tokenBefore = this.sourceCode.getTokenBefore(nodeOrToken) || nodeOrToken;
+        const tokenAfter = this.sourceCode.getTokenAfter(nodeOrToken) || nodeOrToken;
+
+        return this.retainRange([tokenBefore.range[0], tokenAfter.range[1]]);
+    }
+
+    /**
+     * Create a fix command that replaces the given range with the given text,
+     * accounting for any retained ranges.
+     *
+     * @param {int[]} range The range to remove in the fix.
+     * @param {string} text The text to insert in place of the range.
+     * @returns {Object} The fix command.
+     */
+    replaceTextRange(range, text) {
+        let actualRange;
+
+        if (this.retainedRange) {
+            actualRange = [
+                Math.min(this.retainedRange[0], range[0]),
+                Math.max(this.retainedRange[1], range[1])
+            ];
+        } else {
+            actualRange = range;
+        }
+
+        return this.fixer.replaceTextRange(
+            actualRange,
+            this.sourceCode.text.slice(actualRange[0], range[0]) +
+                text +
+                this.sourceCode.text.slice(range[1], actualRange[1])
+        );
+    }
+
+    /**
+     * Create a fix command that removes the given node or token, accounting for
+     * any retained ranges.
+     *
+     * @param {ASTNode|Token} nodeOrToken The node or token to remove.
+     * @returns {Object} The fix command.
+     */
+    remove(nodeOrToken) {
+        return this.replaceTextRange(nodeOrToken.range, "");
+    }
+}
+
+module.exports = FixTracker;

package/packages/less/node_modules/eslint/lib/util/glob-utils.js

@@ -0,0 +1,285 @@
+/**
+ * @fileoverview Utilities for working with globs and the filesystem.
+ * @author Ian VanSchooten
+ */
+"use strict";
+
+//------------------------------------------------------------------------------
+// Requirements
+//------------------------------------------------------------------------------
+
+const lodash = require("lodash"),
+    fs = require("fs"),
+    path = require("path"),
+    GlobSync = require("./glob"),
+
+    pathUtils = require("./path-utils"),
+    IgnoredPaths = require("./ignored-paths");
+
+const debug = require("debug")("eslint:glob-utils");
+
+//------------------------------------------------------------------------------
+// Helpers
+//------------------------------------------------------------------------------
+
+/**
+ * Checks whether a directory exists at the given location
+ * @param {string} resolvedPath A path from the CWD
+ * @returns {boolean} `true` if a directory exists
+ */
+function directoryExists(resolvedPath) {
+    return fs.existsSync(resolvedPath) && fs.statSync(resolvedPath).isDirectory();
+}
+
+/**
+ * Checks if a provided path is a directory and returns a glob string matching
+ * all files under that directory if so, the path itself otherwise.
+ *
+ * Reason for this is that `glob` needs `/**` to collect all the files under a
+ * directory where as our previous implementation without `glob` simply walked
+ * a directory that is passed. So this is to maintain backwards compatibility.
+ *
+ * Also makes sure all path separators are POSIX style for `glob` compatibility.
+ *
+ * @param {Object}   [options]                    An options object
+ * @param {string[]} [options.extensions=[".js"]] An array of accepted extensions
+ * @param {string}   [options.cwd=process.cwd()]  The cwd to use to resolve relative pathnames
+ * @returns {Function} A function that takes a pathname and returns a glob that
+ *                     matches all files with the provided extensions if
+ *                     pathname is a directory.
+ */
+function processPath(options) {
+    const cwd = (options && options.cwd) || process.cwd();
+    let extensions = (options && options.extensions) || [".js"];
+
+    extensions = extensions.map(ext => ext.replace(/^\./u, ""));
+
+    let suffix = "/**";
+
+    if (extensions.length === 1) {
+        suffix += `/*.${extensions[0]}`;
+    } else {
+        suffix += `/*.{${extensions.join(",")}}`;
+    }
+
+    /**
+     * A function that converts a directory name to a glob pattern
+     *
+     * @param {string} pathname The directory path to be modified
+     * @returns {string} The glob path or the file path itself
+     * @private
+     */
+    return function(pathname) {
+        if (pathname === "") {
+            return "";
+        }
+
+        let newPath = pathname;
+        const resolvedPath = path.resolve(cwd, pathname);
+
+        if (directoryExists(resolvedPath)) {
+            newPath = pathname.replace(/[/\\]$/u, "") + suffix;
+        }
+
+        return pathUtils.convertPathToPosix(newPath);
+    };
+}
+
+/**
+ * The error type when no files match a glob.
+ */
+class NoFilesFoundError extends Error {
+
+    /**
+     * @param {string} pattern - The glob pattern which was not found.
+     */
+    constructor(pattern) {
+        super(`No files matching '${pattern}' were found.`);
+
+        this.messageTemplate = "file-not-found";
+        this.messageData = { pattern };
+    }
+
+}
+
+/**
+ * The error type when there are files matched by a glob, but all of them have been ignored.
+ */
+class AllFilesIgnoredError extends Error {
+
+    /**
+     * @param {string} pattern - The glob pattern which was not found.
+     */
+    constructor(pattern) {
+        super(`All files matched by '${pattern}' are ignored.`);
+        this.messageTemplate = "all-files-ignored";
+        this.messageData = { pattern };
+    }
+}
+
+const NORMAL_LINT = {};
+const SILENTLY_IGNORE = {};
+const IGNORE_AND_WARN = {};
+
+/**
+ * Tests whether a file should be linted or ignored
+ * @param {string} filename The file to be processed
+ * @param {{ignore: (boolean|null)}} options If `ignore` is false, updates the behavior to
+ * not process custom ignore paths, and lint files specified by direct path even if they
+ * match the default ignore path
+ * @param {boolean} isDirectPath True if the file was provided as a direct path
+ * (as opposed to being resolved from a glob)
+ * @param {IgnoredPaths} ignoredPaths An instance of IgnoredPaths to check whether a given
+ * file is ignored.
+ * @returns {(NORMAL_LINT|SILENTLY_IGNORE|IGNORE_AND_WARN)} A directive for how the
+ * file should be processed (either linted normally, or silently ignored, or ignored
+ * with a warning that it is being ignored)
+ */
+function testFileAgainstIgnorePatterns(filename, options, isDirectPath, ignoredPaths) {
+    const shouldProcessCustomIgnores = options.ignore !== false;
+    const shouldLintIgnoredDirectPaths = options.ignore === false;
+    const fileMatchesIgnorePatterns = ignoredPaths.contains(filename, "default") ||
+        (shouldProcessCustomIgnores && ignoredPaths.contains(filename, "custom"));
+
+    if (fileMatchesIgnorePatterns && isDirectPath && !shouldLintIgnoredDirectPaths) {
+        return IGNORE_AND_WARN;
+    }
+
+    if (!fileMatchesIgnorePatterns || (isDirectPath && shouldLintIgnoredDirectPaths)) {
+        return NORMAL_LINT;
+    }
+
+    return SILENTLY_IGNORE;
+}
+
+//------------------------------------------------------------------------------
+// Public Interface
+//------------------------------------------------------------------------------
+
+/**
+ * Resolves any directory patterns into glob-based patterns for easier handling.
+ * @param   {string[]} patterns               File patterns (such as passed on the command line).
+ * @param   {Object} options                  An options object.
+ * @param   {string} [options.globInputPaths] False disables glob resolution.
+ * @returns {string[]} The equivalent glob patterns and filepath strings.
+ */
+function resolveFileGlobPatterns(patterns, options) {
+    if (options.globInputPaths === false) {
+        return patterns;
+    }
+
+    const processPathExtensions = processPath(options);
+
+    return patterns.map(processPathExtensions);
+}
+
+const dotfilesPattern = /(?:(?:^\.)|(?:[/\\]\.))[^/\\.].*/u;
+
+/**
+ * Build a list of absolute filesnames on which ESLint will act.
+ * Ignored files are excluded from the results, as are duplicates.
+ *
+ * @param   {string[]} globPatterns                     Glob patterns.
+ * @param   {Object}   [providedOptions]                An options object.
+ * @param   {string}   [providedOptions.cwd]            CWD (considered for relative filenames)
+ * @param   {boolean}  [providedOptions.ignore]         False disables use of .eslintignore.
+ * @param   {string}   [providedOptions.ignorePath]     The ignore file to use instead of .eslintignore.
+ * @param   {string}   [providedOptions.ignorePattern]  A pattern of files to ignore.
+ * @param   {string}   [providedOptions.globInputPaths] False disables glob resolution.
+ * @returns {string[]} Resolved absolute filenames.
+ */
+function listFilesToProcess(globPatterns, providedOptions) {
+    const options = providedOptions || { ignore: true };
+    const cwd = options.cwd || process.cwd();
+
+    const getIgnorePaths = lodash.memoize(
+        optionsObj =>
+            new IgnoredPaths(optionsObj)
+    );
+
+    /*
+     * The test "should use default options if none are provided" (source-code-utils.js) checks that 'module.exports.resolveFileGlobPatterns' was called.
+     * So it cannot use the local function "resolveFileGlobPatterns".
+     */
+    const resolvedGlobPatterns = module.exports.resolveFileGlobPatterns(globPatterns, options);
+
+    debug("Creating list of files to process.");
+    const resolvedPathsByGlobPattern = resolvedGlobPatterns.map(pattern => {
+        if (pattern === "") {
+            return [{
+                filename: "",
+                behavior: SILENTLY_IGNORE
+            }];
+        }
+
+        const file = path.resolve(cwd, pattern);
+
+        if (options.globInputPaths === false || (fs.existsSync(file) && fs.statSync(file).isFile())) {
+            const ignoredPaths = getIgnorePaths(options);
+            const fullPath = options.globInputPaths === false ? file : fs.realpathSync(file);
+
+            return [{
+                filename: fullPath,
+                behavior: testFileAgainstIgnorePatterns(fullPath, options, true, ignoredPaths)
+            }];
+        }
+
+        // regex to find .hidden or /.hidden patterns, but not ./relative or ../relative
+        const globIncludesDotfiles = dotfilesPattern.test(pattern);
+        let newOptions = options;
+
+        if (!options.dotfiles) {
+            newOptions = Object.assign({}, options, { dotfiles: globIncludesDotfiles });
+        }
+
+        const ignoredPaths = getIgnorePaths(newOptions);
+        const shouldIgnore = ignoredPaths.getIgnoredFoldersGlobChecker();
+        const globOptions = {
+            nodir: true,
+            dot: true,
+            cwd
+        };
+
+        return new GlobSync(pattern, globOptions, shouldIgnore).found.map(globMatch => {
+            const relativePath = path.resolve(cwd, globMatch);
+
+            return {
+                filename: relativePath,
+                behavior: testFileAgainstIgnorePatterns(relativePath, options, false, ignoredPaths)
+            };
+        });
+    });
+
+    const allPathDescriptors = resolvedPathsByGlobPattern.reduce((pathsForAllGlobs, pathsForCurrentGlob, index) => {
+        if (pathsForCurrentGlob.every(pathDescriptor => pathDescriptor.behavior === SILENTLY_IGNORE && pathDescriptor.filename !== "")) {
+            throw new (pathsForCurrentGlob.length ? AllFilesIgnoredError : NoFilesFoundError)(globPatterns[index]);
+        }
+
+        pathsForCurrentGlob.forEach(pathDescriptor => {
+            switch (pathDescriptor.behavior) {
+                case NORMAL_LINT:
+                    pathsForAllGlobs.push({ filename: pathDescriptor.filename, ignored: false });
+                    break;
+                case IGNORE_AND_WARN:
+                    pathsForAllGlobs.push({ filename: pathDescriptor.filename, ignored: true });
+                    break;
+                case SILENTLY_IGNORE:
+
+                    // do nothing
+                    break;
+
+                default:
+                    throw new Error(`Unexpected file behavior for ${pathDescriptor.filename}`);
+            }
+        });
+
+        return pathsForAllGlobs;
+    }, []);
+
+    return lodash.uniqBy(allPathDescriptors, pathDescriptor => pathDescriptor.filename);
+}
+
+module.exports = {
+    resolveFileGlobPatterns,
+    listFilesToProcess
+};