sqlmath 2022.4.28 → 2022.8.20

package/jslint.mjs

@@ -1,14 +1,15 @@
 // #!/usr/bin/env node
 // JSLint
-// Original Author: Douglas Crockford (https://www.jslint.com).
 
+// The Unlicense
+//
 // This is free and unencumbered software released into the public domain.
-
+//
 // Anyone is free to copy, modify, publish, use, compile, sell, or
 // distribute this software, either in source code form or as a compiled
 // binary, for any purpose, commercial or non-commercial, and by any
 // means.
-
+//
 // In jurisdictions that recognize copyright laws, the author or authors
 // of this software dedicate any and all copyright interest in the
 // software to the public domain. We make this dedication for the benefit
@@ -16,7 +17,7 @@
 // successors. We intend this dedication to be an overt act of
 // relinquishment in perpetuity of all present and future rights to this
 // software under copyright law.
-
+//
 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 // EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
@@ -24,7 +25,7 @@
 // OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 // ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 // OTHER DEALINGS IN THE SOFTWARE.
-
+//
 // For more information, please refer to <https://unlicense.org/>
 
 
@@ -92,7 +93,6 @@
 // WARNING: JSLint will hurt your feelings.
 
 /*jslint beta, node*/
-
 /*property
     JSLINT_BETA, NODE_V8_COVERAGE, a, all, argv, arity, artifact,
     assertErrorThrownAsync, assertJsonEqual, assertOrThrow, assign, async, b,
@@ -100,59 +100,60 @@
     catch_stack, causes, char, children, clear, closer, closure, code, column,
     concat, consoleError, console_error, console_log, constant, context,
     convert, count, coverageDir, create, cwd, d, dead, debugInline, default,
-    delta, devel, directive, directive_list, directive_quiet, directives,
+    delta, devel, directive, directive_ignore_line, directive_list, directives,
     dirname, disrupt, dot, edition, elem_list, ellipsis, else, end, endOffset,
-    endsWith, entries, env, error, eval, every, example_list, exec, execArgv,
-    exit, exitCode, export_dict, exports, expression, extra, file, fileList,
-    fileURLToPath, filter, finally, flag, floor, for, forEach,
+    endsWith, entries, env, error, eval, every, example_list, excludeList, exec,
+    execArgv, exit, exitCode, export_dict, exports, expression, extra, file,
+    fileList, fileURLToPath, filter, finally, flag, floor, for, forEach,
     formatted_message, free, freeze, from, froms, fsWriteFileWithParents,
     fud_stmt, functionName, function_list, function_stack, functions, get,
-    getset, github_repo, global, global_dict, global_list, holeList, htmlEscape,
-    id, identifier, import, import_list, inc, indent2, index, indexOf, init,
-    initial, isArray, isBlockCoverage, isHole, isNaN, is_equal, is_fart,
-    is_weird, join, jslint, jslint_apidoc, jslint_assert, jslint_charset_ascii,
-    jslint_cli, jslint_edition, jslint_phase1_split, jslint_phase2_lex,
-    jslint_phase3_parse, jslint_phase4_walk, jslint_phase5_whitage,
-    jslint_report, json, jstestDescribe, jstestIt, jstestOnExit, keys, label,
-    lbp, led_infix, length, level, line, lineList, line_list, line_offset,
-    line_source, lines, linesCovered, linesTotal, live, log, long, loop, m, map,
-    margin, match, max, message, meta, min, mkdir, modeCoverageIgnoreFile,
-    modeIndex, mode_cli, mode_conditional, mode_json, mode_module, mode_noop,
-    mode_property, mode_shebang, mode_stop, module, moduleFsInit, moduleName,
-    module_list, name, names, node, noop, now, nr, nud_prefix,
+    getset, github_repo, globExclude, global, global_dict, global_list,
+    holeList, htmlEscape, id, identifier, import, import_list, import_meta_url,
+    inc, includeList, indent2, index, indexOf, init, initial, isArray,
+    isBlockCoverage, isHole, isNaN, is_equal, is_fart, is_weird, join, jslint,
+    jslint_apidoc, jslint_assert, jslint_charset_ascii, jslint_cli,
+    jslint_edition, jslint_phase1_split, jslint_phase2_lex, jslint_phase3_parse,
+    jslint_phase4_walk, jslint_phase5_whitage, jslint_report, json,
+    jstestDescribe, jstestIt, jstestOnExit, keys, label, lbp, led_infix, length,
+    level, line, lineList, line_list, line_offset, line_source, lines,
+    linesCovered, linesTotal, live, log, long, loop, m, map, margin, match, max,
+    message, meta, min, mkdir, modeCoverageIgnoreFile, modeIndex, mode_cli,
+    mode_conditional, mode_json, mode_module, mode_noop, mode_property,
+    mode_shebang, mode_stop, module, moduleFsInit, moduleName, module_list,
+    name, names, node, nomen, noop, now, nr, nud_prefix,
     objectDeepCopyWithKeysSorted, ok, on, open, opening, option, option_dict,
     order, package_name, padEnd, padStart, parameters, parent, parentIi, parse,
-    pathname, platform, pop, processArgv, process_argv, process_env,
-    process_exit, promises, property, property_dict, push, quote, ranges,
-    readFile, readdir, readonly, recursive, reduce, repeat, replace, resolve,
-    result, reverse, role, round, scriptId, search, set, shebang, shift,
-    signature, single, slice, some, sort, source, spawn, splice, split, stack,
-    stack_trace, start, startOffset, startsWith, statement, statement_prv,
-    stdio, stop, stop_at, stringify, switch, syntax_dict, tenure, test,
-    test_cause, test_internal_error, this, thru, toString, token, token_global,
-    token_list, token_nxt, token_tree, tokens, trace, tree, trim, trimEnd,
-    trimRight, try, type, unlink, unordered, unshift, url, used,
-    v8CoverageListMerge, v8CoverageReportCreate, value, variable, version,
-    versions, warn, warn_at, warning, warning_list, warnings, white, wrapped,
-    writeFile
+    pathname, pathnameList, platform, pop, processArgv, process_argv,
+    process_env, process_exit, promises, property, property_dict, push, quote,
+    ranges, readFile, readdir, readonly, recursive, reduce, repeat, replace,
+    resolve, result, reverse, role, round, scriptId, search, set, shebang,
+    shift, signature, single, slice, some, sort, source, spawn, splice, split,
+    stack, stack_trace, start, startOffset, startsWith, statement,
+    statement_prv, stdio, stop, stop_at, stringify, subscript, switch,
+    syntax_dict, tenure, test, test_cause, test_internal_error, this, thru,
+    toString, token, token_global, token_list, token_nxt, token_tree, tokens,
+    trace, tree, trim, trimEnd, trimRight, try, type, unlink, unordered,
+    unshift, url, used, v8CoverageListMerge, v8CoverageReportCreate, value,
+    variable, version, versions, warn, warn_at, warning, warning_list, warnings,
+    white, wrapped, writeFile
 */
 
 // init debugInline
 let debugInline = (function () {
-    let consoleError = function () {
+    let __consoleError = function () {
         return;
     };
     function debug(...argv) {
 
 // This function will print <argv> to stderr and then return <argv>[0].
 
-        consoleError("\n\ndebugInline");
-        consoleError(...argv);
-        consoleError("\n");
+        __consoleError("\n\ndebugInline");
+        __consoleError(...argv);
+        __consoleError("\n");
         return argv[0];
     }
     debug(); // Coverage-hack.
-    consoleError = console.error;
+    __consoleError = console.error; //jslint-ignore-line
     return debug;
 }());
 let jslint_charset_ascii = (
@@ -164,7 +165,7 @@ let jslint_charset_ascii = (
     + "@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_"
     + "`abcdefghijklmnopqrstuvwxyz{|}~\u007f"
 );
-let jslint_edition = "v2022.5.1-beta";
+let jslint_edition = "v2022.7.20";
 let jslint_export;                      // The jslint object to be exported.
 let jslint_fudge = 1;                   // Fudge starting line and starting
                                         // ... column to 1.
@@ -251,6 +252,9 @@ let jslint_rgx_token = new RegExp(
     + ")"
     + "(.*)$"
 );
+let jslint_rgx_url_search_window_jslint = (
+    /[&?]window_jslint=1(?:$|&)/m
+);
 let jslint_rgx_weird_property = (
     /^_|\$|Sync$|_$/m
 );
@@ -349,6 +353,226 @@ async function fsWriteFileWithParents(pathname, data) {
     console.error("wrote file " + pathname);
 }
 
+function globExclude({
+    excludeList = [],
+    includeList = [],
+    pathnameList = []
+}) {
+
+// This function will
+// 1. Exclude pathnames in <pathnameList> that don't match glob-patterns in
+//    <includeList>.
+// 2. Exclude pathnames in <pathnameList> that match glob-patterns in
+//    <excludeList>.
+
+    function globAssertNotWeird(list, name) {
+
+// This function will check if <list> of strings contain weird characters.
+
+        [
+            [
+                "\n", (
+                    /^.*?([\u0000-\u0007\r]).*/gm
+                )
+            ],
+            [
+                "\r", (
+                    /^.*?([\n]).*/gm
+                )
+            ]
+        ].forEach(function ([
+            separator, rgx
+        ]) {
+            list.join(separator).replace(rgx, function (match0, char) {
+                throw new Error(
+                    "Weird character "
+                    + JSON.stringify(char)
+                    + " found in " + name + " "
+                    + JSON.stringify(match0)
+                );
+            });
+        });
+    }
+
+    function globToRegexp(pattern) {
+
+// This function will translate glob <pattern> to javascript-regexp,
+// which javascript can then use to "glob" pathnames.
+
+        let ii = 0;
+        let isClass = false;
+        let strClass = "";
+        let strRegex = "";
+        pattern = pattern.replace((
+            /\/\/+/g
+        ), "/");
+        pattern = pattern.replace((
+            /\*\*\*+/g
+        ), "**");
+        pattern.replace((
+            /\\\\|\\\[|\\\]|\[|\]|./g
+        ), function (match0) {
+            switch (match0) {
+            case "[":
+                if (isClass) {
+                    strClass += "[";
+                    return;
+                }
+                strClass += "\u0000";
+                strRegex += "\u0000";
+                isClass = true;
+                return;
+            case "]":
+                if (isClass) {
+                    isClass = false;
+                    return;
+                }
+                strRegex += "]";
+                return;
+            default:
+                if (isClass) {
+                    strClass += match0;
+                    return;
+                }
+                strRegex += match0;
+            }
+            return "";
+        });
+        strClass += "\u0000";
+
+// An expression "[!...]" matches a single character, namely any character that
+// is not matched by the expression obtained by removing the first '!' from it.
+// (Thus, "[!a-]" matches any single character except 'a', and '-'.)
+
+        strClass = strClass.replace((
+            /\u0000!/g
+        ), "\u0000^");
+
+// One may include '-' in its literal meaning by making it the first or last
+// character between the brackets.
+
+        strClass = strClass.replace((
+            /\u0000-/g
+        ), "\u0000\\-");
+        strClass = strClass.replace((
+            /-\u0000/g
+        ), "\\-\u0000");
+
+// Escape brackets '[', ']' in character class.
+
+        strClass = strClass.replace((
+            /[\[\]]/g
+        ), "\\$&");
+
+// https://stackoverflow.com/questions/3561493
+// /is-there-a-regexp-escape-function-in-javascript
+// $()*+-./?[\]^{|}
+
+        strRegex = strRegex.replace((
+
+// Ignore [-/].
+
+            /[$()*+.?\[\\\]\^{|}]/g
+        ), "\\$&");
+
+// Expand wildcard '**/*'.
+
+        strRegex = strRegex.replace((
+            /\\\*\\\*\/(?:\\\*)+/g
+        ), ".*?");
+
+// Expand wildcard '**'.
+
+        strRegex = strRegex.replace((
+            /(^|\/)\\\*\\\*(\/|$)/gm
+        ), "$1.*?$2");
+
+// Expand wildcard '*'.
+
+        strRegex = strRegex.replace((
+            /(?:\\\*)+/g
+        ), "[^\\/]*?");
+
+// Expand wildcard '?'.
+
+        strRegex = strRegex.replace((
+            /\\\?/g
+        ), "[^\\/]");
+
+// Expand directory-with-trailing-slash '.../'.
+
+        strRegex = strRegex.replace((
+            /\/$/gm
+        ), "\\/.*?");
+
+// Merge strClass into strRegex.
+
+        ii = 0;
+        strClass = strClass.split("\u0000");
+        strRegex = strRegex.replace((
+            /\u0000/g
+        ), function () {
+            ii += 1;
+            if (strClass[ii] === "") {
+                return "";
+            }
+            return "[" + strClass[ii] + "]";
+        });
+
+// Change strRegex from string to regexp.
+
+        strRegex = new RegExp("^" + strRegex + "$", "gm");
+        return strRegex;
+    }
+
+// Validate excludeList, includeList, pathnameList.
+
+    globAssertNotWeird(excludeList, "pattern");
+    globAssertNotWeird(includeList, "pattern");
+    globAssertNotWeird(pathnameList, "pathname");
+
+// Optimization
+// Concat pathnames into a single, newline-separated string,
+// whose pathnames can all be filtered with a single, regexp-pass.
+
+    pathnameList = pathnameList.join("\n");
+
+// 1. Exclude pathnames in <pathnameList> that don't match glob-patterns in
+//    <includeList>.
+
+    if (includeList.length > 0) {
+        includeList = includeList.map(globToRegexp);
+        includeList.forEach(function (pattern) {
+            pathnameList = pathnameList.replace(pattern, "\u0000$&");
+        });
+        pathnameList = pathnameList.replace((
+            /^[^\u0000].*/gm
+        ), "");
+        pathnameList = pathnameList.replace((
+            /^\u0000+/gm
+        ), "");
+    }
+
+// 2. Exclude pathnames in <pathnameList> that match glob-patterns in
+//    <excludeList>.
+
+    excludeList = excludeList.map(globToRegexp);
+    excludeList.forEach(function (pattern) {
+        pathnameList = pathnameList.replace(pattern, "");
+    });
+
+// Split newline-separated pathnames back to list.
+
+    pathnameList = pathnameList.split("\n").filter(function (elem) {
+        return elem;
+    });
+    return {
+        excludeList,
+        includeList,
+        pathnameList
+    };
+}
+
 function htmlEscape(str) {
 
 // This function will make <str> html-safe by escaping & < >.
@@ -491,10 +715,11 @@ function jslint(
             return false;
         }
         if (aa.arity === bb.arity && aa.id === bb.id) {
-            if (aa.id === ".") {
+            if (aa.id === "." || aa.id === "?.") {
 
 // test_cause:
 // ["aa.bb&&aa.bb", "is_equal", "recurse_arity_id", "", 0]
+// ["aa?.bb&&aa?.bb", "is_equal", "recurse_arity_id", "", 0]
 
                 test_cause("recurse_arity_id");
                 return (
@@ -635,11 +860,22 @@ function jslint(
             c,
             d
         );
-        if (the_token.warning === undefined) {
-            the_token.warning = the_warning;
-        } else {
+
+// Issue #408
+// Warnings that should be ignored sometimes suppress legitimate warnings.
+
+        if (the_warning.directive_ignore_line) {
+            return the_warning;
+        }
+
+// If there is already a warning on this token, suppress the new one. It is
+// likely that the first warning will be the most meaningful.
+
+        if (the_token.warning) {
             warning_list.pop();
+            return the_warning;
         }
+        the_token.warning = the_warning;
         return the_warning;
     }
 
@@ -789,6 +1025,7 @@ function jslint(
             break;
 
 // PR-347 - Disable warning "missing_browser".
+//
 //         case "missing_browser":
 //             mm = `/*global*/ requires the Assume a browser option.`;
 //             break;
@@ -873,6 +1110,7 @@ function jslint(
             break;
 
 // PR-347 - Disable warning "unexpected_directive_a".
+//
 //         case "unexpected_directive_a":
 //             mm = `When using modules, don't use directive '/\u002a${a}'.`;
 //             break;
@@ -994,12 +1232,12 @@ function jslint(
         if (option_dict.trace) {
             warning.stack_trace = new Error().stack;
         }
-        if (warning.directive_quiet) {
+        if (warning.directive_ignore_line) {
 
 // test_cause:
-// ["0 //jslint-quiet", "semicolon", "directive_quiet", "", 0]
+// ["0 //jslint-ignore-line", "semicolon", "directive_ignore_line", "", 0]
 
-            test_cause("directive_quiet");
+            test_cause("directive_ignore_line");
             return warning;
         }
         warning_list.push(warning);
@@ -1033,7 +1271,7 @@ function jslint(
             mode_json: false,           // true if parsing JSON.
             mode_module: false,         // true if import or export was used.
             mode_property: false,       // true if directive /*property*/ is
-                                        // used.
+                                        // ... used.
             mode_shebang: false,        // true if #! is seen on the first line.
             option_dict,
             property_dict,
@@ -1103,6 +1341,7 @@ function jslint(
         );
 
 // PR-347 - Disable warning "missing_browser".
+//
 //         if (!option_dict.browser) {
 //             directive_list.forEach(function (comment) {
 //                 if (comment.directive === "global") {
@@ -1537,6 +1776,7 @@ async function jslint_cli({
     console_error,
     console_log,
     file,
+    import_meta_url,
     mode_cli,
     mode_noop,
     option,
@@ -1705,11 +1945,26 @@ async function jslint_cli({
         return count;
     }
 
+// PR-396 - window.jslint
+// Check import.meta.url for directive to export jslint to window-object.
+// Useful for ES5-era browser-scripts that rely on window.jslint,
+// like CodeMirror.
+//
+// Example usage:
+// <script type="module" src="./jslint.mjs?window_jslint=1"></script>
+
+    import_meta_url = import_meta_url || jslint_import_meta_url;
+    if (
+        jslint_rgx_url_search_window_jslint.test(import_meta_url)
+        && (typeof globalThis === "object" && globalThis)
+    ) {
+        globalThis.jslint = jslint;
+    }
+
 // Feature-detect nodejs.
 
     if (!(
-        typeof process === "object"
-        && process
+        (typeof process === "object" && process)
         && process.versions
         && typeof process.versions.node === "string"
         && !mode_noop
@@ -1735,7 +1990,7 @@ async function jslint_cli({
                 ).test(process_argv[1])
                 || mode_cli
             )
-            && moduleUrl.fileURLToPath(jslint_import_meta_url)
+            && moduleUrl.fileURLToPath(import_meta_url)
             === modulePath.resolve(process_argv[1])
         )
         && !mode_cli
@@ -1881,7 +2136,9 @@ async function jslint_cli({
         option
     });
     if (mode_report) {
-        await fsWriteFileWithParents(mode_report, jslint_report(result));
+        result = jslint.jslint_report(result);
+        result = `<body class="JSLINT_ JSLINT_REPORT_">\n${result}</body>\n`;
+        await fsWriteFileWithParents(mode_report, result);
     }
     process_exit(exit_code);
     return exit_code;
@@ -2170,7 +2427,7 @@ function jslint_phase2_lex(state) {
         if (!option_dict.devel && jslint_rgx_todo.test(snippet)) {
 
 // test_cause:
-// ["//todo", "lex_comment", "todo_comment", "(comment)", 1] //jslint-quiet
+// ["//todo", "lex_comment", "todo_comment", "(comment)", 1] //jslint-ignore-line
 
             warn("todo_comment", the_comment);
         }
@@ -2230,6 +2487,7 @@ function jslint_phase2_lex(state) {
                 global_dict[key] = "user-defined";
 
 // PR-347 - Disable warning "unexpected_directive_a".
+//
 //                 state.mode_module = the_comment;
 
                 break;
@@ -2456,6 +2714,7 @@ function jslint_phase2_lex(state) {
                     return char_after("]");
 
 // PR-362 - Relax regexp-warning against using <space>.
+//
 //                 case " ":
 //
 // // test_cause:
@@ -2536,6 +2795,7 @@ function jslint_phase2_lex(state) {
                     return;
 
 // PR-362 - Relax regexp-warning against using <space>.
+//
 //                 case " ":
 //
 // // test_cause:
@@ -3045,9 +3305,10 @@ function jslint_phase2_lex(state) {
         case "getset":          // Allow get() and set().
         case "indent2":         // Use 2-space indent.
         case "long":            // Allow long lines.
-        case "name":            // Allow weird property names.
         case "node":            // Assume Node.js environment.
+        case "nomen":           // Allow weird property names.
         case "single":          // Allow single-quote strings.
+        case "subscript":       // Allow identifier in subscript-notation.
         case "test_cause":      // Test jslint's causes.
         case "test_internal_error":     // Test jslint's internal-error
                                         // ... handling-ability.
@@ -3060,6 +3321,16 @@ function jslint_phase2_lex(state) {
         case "white":           // Allow messy whitespace.
             option_dict[key] = val;
             break;
+
+// PR-404 - Alias "evil" to jslint-directive "eval" for backwards-compat.
+
+        case "evil":
+            return option_set_item("eval", val);
+
+// PR-404 - Alias "nomen" to jslint-directive "name" for backwards-compat.
+
+        case "name":
+            return option_set_item("nomen", val);
         default:
             return false;
         }
@@ -3081,12 +3352,16 @@ console.log(JSON.stringify(Object.keys(window).sort(), undefined, 4));
 
                 "AbortController",
                 // "Buffer",
-                "DOMException",
+                // "Crypto",
+                // "CryptoKey",
                 "Event",
                 "EventTarget",
                 "MessageChannel",
                 "MessageEvent",
                 "MessagePort",
+                // "Request",
+                // "Response",
+                // "SubtleCrypto",
                 "TextDecoder",
                 "TextEncoder",
                 "URL",
@@ -3100,7 +3375,9 @@ console.log(JSON.stringify(Object.keys(window).sort(), undefined, 4));
                 "clearInterval",
                 "clearTimeout",
                 // "console",
+                // "crypto",
                 // "exports",
+                // "fetch",
                 // "global",
                 // "module",
                 "performance",
@@ -3110,7 +3387,6 @@ console.log(JSON.stringify(Object.keys(window).sort(), undefined, 4));
                 // "setImmediate",
                 "setInterval",
                 "setTimeout",
-                "structuredClone",
 
 // Web worker only.
 // https://github.com/mdn/content/blob/main/files/en-us/web/api
@@ -3148,10 +3424,12 @@ console.log(JSON.stringify(Object.keys(window).sort(), undefined, 4));
                 "location",
                 // "name",
                 "navigator",
+                "postMessage",
                 // "screen",
                 "sessionStorage",
                 // "setInterval",
                 // "setTimeout",
+                "structuredClone",
                 "window"
             ], "browser");
             break;
@@ -3213,6 +3491,7 @@ import https from "https";
 
         case "ecma":
             object_assign_from_list(global_dict, [
+                "AggregateError",
                 "Array",
                 "ArrayBuffer",
                 "Atomics",
@@ -3283,7 +3562,7 @@ import moduleHttps from "https";
     let result = "";
     await new Promise(function (resolve) {
         moduleHttps.get((
-            "https://raw.githubusercontent.com/nodejs/node/master/doc/api"
+            "https://raw.githubusercontent.com/nodejs/node/v16.x/doc/api"
             + "/globals.md"
         ), function (res) {
             res.on("data", function (chunk) {
@@ -3306,12 +3585,16 @@ import moduleHttps from "https";
             object_assign_from_list(global_dict, [
                 "AbortController",
                 "Buffer",
-                "DOMException",
+                // "Crypto",
+                // "CryptoKey",
                 "Event",
                 "EventTarget",
                 "MessageChannel",
                 "MessageEvent",
                 "MessagePort",
+                // "Request",
+                // "Response",
+                // "SubtleCrypto",
                 "TextDecoder",
                 "TextEncoder",
                 "URL",
@@ -3325,7 +3608,9 @@ import moduleHttps from "https";
                 "clearInterval",
                 "clearTimeout",
                 "console",
+                // "crypto",
                 "exports",
+                // "fetch",
                 "global",
                 "module",
                 "performance",
@@ -3334,8 +3619,7 @@ import moduleHttps from "https";
                 "require",
                 "setImmediate",
                 "setInterval",
-                "setTimeout",
-                "structuredClone"
+                "setTimeout"
             ], "Node.js");
             break;
         }
@@ -3402,7 +3686,7 @@ import moduleHttps from "https";
         ) {
 
 // test_cause:
-// ["/////////////////////////////////////////////////////////////////////////////////", "read_line", "too_long", "", 1] //jslint-quiet
+// ["/////////////////////////////////////////////////////////////////////////////////", "read_line", "too_long", "", 1] //jslint-ignore-line
 
             warn_at("too_long", line);
         }
@@ -3420,7 +3704,7 @@ import moduleHttps from "https";
 // Scan each line for following ignore-directives:
 // "/*jslint-disable*/"
 // "/*jslint-enable*/"
-// "//jslint-quiet"
+// "//jslint-ignore-line"
 
         if (line_source === "/*jslint-disable*/") {
 
@@ -3438,13 +3722,16 @@ import moduleHttps from "https";
                 stop_at("unopened_enable", line);
             }
             line_disable = undefined;
-        } else if (line_source.endsWith(" //jslint-quiet")) {
+        } else if (
+            line_source.endsWith(" //jslint-ignore-line")
+            || line_source.endsWith(" //jslint-quiet")
+        ) {
 
 // test_cause:
-// ["0 //jslint-quiet", "read_line", "jslint_quiet", "", 0]
+// ["0 //jslint-ignore-line", "read_line", "jslint_ignore_line", "", 0]
 
-            test_cause("jslint_quiet");
-            line_list[line].directive_quiet = true;
+            test_cause("jslint_ignore_line");
+            line_list[line].directive_ignore_line = true;
         }
         if (line_disable !== undefined) {
 
@@ -4244,6 +4531,8 @@ function jslint_phase3_parse(state) {
                 left.id !== "["
                 || (
                     name.id !== "concat"
+                    && name.id !== "flat"
+                    && name.id !== "flatMap"
                     && name.id !== "forEach"
                     && name.id !== "join"
                     && name.id !== "map"
@@ -4303,7 +4592,10 @@ function jslint_phase3_parse(state) {
         let the_subscript = parse_expression(0);
         if (the_subscript.id === "(string)" || the_subscript.id === "`") {
             name = survey(the_subscript);
-            if (jslint_rgx_identifier.test(name)) {
+
+// PR-404 - Add new directive "subscript" to play nice with Google Closure.
+
+            if (!option_dict.subscript && jslint_rgx_identifier.test(name)) {
 
 // test_cause:
 // ["aa[`aa`]", "infix_lbracket", "subscript_a", "aa", 4]
@@ -5032,10 +5324,13 @@ function jslint_phase3_parse(state) {
             functionage.async += 1;
         }
         if (the_await.arity === "statement") {
-            the_await.block = parse_expression();
+
+// PR-405 - Bugfix - fix expression after "await" mis-identified as statement.
+
+            the_await.expression = parse_expression(150);
             semicolon();
         } else {
-            the_await.expression = parse_expression();
+            the_await.expression = parse_expression(150);
         }
         return the_await;
     }
@@ -6101,6 +6396,7 @@ function jslint_phase3_parse(state) {
         let names;
 
 // PR-347 - Disable warning "unexpected_directive_a".
+//
 //         if (typeof state.mode_module === "object") {
 //
 // // test_cause:
@@ -6458,12 +6754,16 @@ function jslint_phase3_parse(state) {
 // Restore previous catch-scope after catch-block.
 
             catchage = catch_stack.pop();
-        } else {
 
-// test_cause:
-// ["try{}finally{break;}", "stmt_try", "expected_a_before_b", "finally", 6]
+// PR-404 - Relax warning about missing `catch` in `try...finally` statement.
+//
+//         } else {
+//
+// // test_cause:
+// // ["try{}finally{break;}", "stmt_try", "expected_a_before_b", "finally", 6]
+//
+//             warn("expected_a_before_b", token_nxt, "catch", artifact());
 
-            warn("expected_a_before_b", token_nxt, "catch", artifact());
         }
         if (token_nxt.id === "finally") {
             functionage.finally += 1;
@@ -6584,12 +6884,14 @@ function jslint_phase3_parse(state) {
                             return stop("expected_identifier_a");
                         }
 
-// PR-363 - Bugfix - fix false-warning
-// <uninitialized 'bb'> in code '/*jslint node*/\nlet {aa:bb} = {}; bb();'
+// PR-363 - Bugfix
+// Add test against false-warning <uninitialized 'bb'> in code
+// '/*jslint node*/\nlet {aa:bb} = {}; bb();'.
+//
+//                         token_nxt.label = name;
+//                         the_variable.names.push(token_nxt);
+//                         enroll(token_nxt, "variable", mode_const);
 
-                        // token_nxt.label = name;
-                        // the_variable.names.push(token_nxt);
-                        // enroll(token_nxt, "variable", mode_const);
                         name = token_nxt;
                         the_variable.names.push(name);
                         survey(name);
@@ -6812,7 +7114,7 @@ function jslint_phase3_parse(state) {
                     warn("unregistered_property_a", name);
                 }
             } else if (
-                !option_dict.name
+                !option_dict.nomen
                 && name.identifier
                 && jslint_rgx_weird_property.test(id)
             ) {
@@ -8225,9 +8527,6 @@ function jslint_phase4_walk(state) {
 // ["+[]", "walk_statement", "unexpected_expression_a", "+", 1]
 // ["+new aa()", "walk_statement", "unexpected_expression_a", "+", 1]
 // ["0", "walk_statement", "unexpected_expression_a", "0", 1]
-// ["
-// async function aa(){await 0;}
-// ", "walk_statement", "unexpected_expression_a", "0", 27]
 // ["typeof 0", "walk_statement", "unexpected_expression_a", "typeof", 1]
 
                     warn("unexpected_expression_a", thing);
@@ -8969,6 +9268,7 @@ function jslint_report({
 
 // This function will create human-readable, html-report
 // for warnings, properties, and functions from jslint-result-object.
+//
 // Example usage:
 //  let result = jslint("console.log('hello world')");
 //  let html = jslint_report(result);
@@ -9001,7 +9301,6 @@ function jslint_report({
         );
     }
 
-    html += "<div class=\"JSLINT_\" id=\"JSLINT_REPORT_HTML\">\n";
     html += String(`
 <style class="JSLINT_REPORT_STYLE">
 /* jslint utility2:true */
@@ -9150,19 +9449,38 @@ pyNj+JctcQLXenBOCms46aMkenIx45WpXqxxVJQLz/vgpmAVa0fmDv6Pue9xVTBPfVxCUGfj\
 /7xoEqvL+2E8VOyCTuT/7j269Zy4jUtN+g4="
     ) format("woff2");
 }
-*,
-*:after,
-*:before {
+.JSLINT_,
+.JSLINT_ address,
+.JSLINT_ button,
+.JSLINT_ cite,
+.JSLINT_ dd,
+.JSLINT_ dfn,
+.JSLINT_ dl,
+.JSLINT_ dt,
+.JSLINT_ fieldset,
+.JSLINT_ fieldset > div,
+.JSLINT_ input,
+.JSLINT_ label,
+.JSLINT_ legend,
+.JSLINT_ ol,
+.JSLINT_ samp,
+.JSLINT_ style,
+.JSLINT_ textarea,
+.JSLINT_ ul {
     border: 0;
     box-sizing: border-box;
     margin: 0;
     padding: 0;
 }
+/* disable text inflation algorithm used on some smartphones and tablets */
 .JSLINT_ {
     -ms-text-size-adjust: none;
     -webkit-text-size-adjust: none;
     text-size-adjust: none;
 }
+.JSLINT_REPORT_ div {
+    box-sizing: border-box;
+}
 /*csslint ignore:end*/
 
 /* css - jslint_report - font */
@@ -9196,7 +9514,7 @@ pyNj+JctcQLXenBOCms46aMkenIx45WpXqxxVJQLz/vgpmAVa0fmDv6Pue9xVTBPfVxCUGfj\
 }
 
 /* css - jslint_report - general */
-body {
+.JSLINT_ {
     background: antiquewhite;
 }
 .JSLINT_ fieldset {
@@ -9533,7 +9851,6 @@ body {
     });
     html += "</div>\n";
     html += "</fieldset>\n";
-    html += "</div>\n";
     return html;
 }
 
@@ -9544,6 +9861,7 @@ async function jstestDescribe(description, testFunction) {
 
     let message;
     let result;
+    let timerTimeout;
 
 // Init jstestTimeStart.
 
@@ -9559,7 +9877,9 @@ async function jstestDescribe(description, testFunction) {
 
 // Wait for jstestItList to resolve.
 
+    timerTimeout = setTimeout(noop, 0x7fffffff);
     result = await Promise.all(jstestItList);
+    clearTimeout(timerTimeout);
 
 // Print test results.
 
@@ -9925,7 +10245,7 @@ function v8CoverageListMerge(processCovs) {
             let resultTree;
             let rightChildren;
 
-// TODO(perf): Binary search (check overhead) //jslint-quiet
+// TODO(perf): Binary search (check overhead) //jslint-ignore-line
 
             while (ii < tree.children.length) {
                 child = tree.children[ii];
@@ -10003,7 +10323,7 @@ function v8CoverageListMerge(processCovs) {
 
 // This function will normalize-and-sort <funcCov>.ranges.
 // Sorts the ranges (pre-order sort).
-// TODO: Tree-based normalization of the ranges. //jslint-quiet
+// TODO: Tree-based normalization of the ranges. //jslint-ignore-line
 // @param funcCov Function coverage to normalize.
 
         funcCov.ranges = treeToRanges(treeFromSortedRanges(
@@ -10349,11 +10669,11 @@ async function v8CoverageReportCreate({
 // 3. Create html-coverage-reports in <coverageDir>.
 
     let cwd;
+    let excludeList = [];
     let exitCode = 0;
     let fileDict;
-    let fileExcludeList = [];
-    let fileIncludeList = [];
-    let fileIncludeNodeModules;
+    let includeList = [];
+    let modeIncludeNodeModules;
     let processArgElem;
     let promiseList = [];
     let v8CoverageObj;
@@ -10378,9 +10698,19 @@ async function v8CoverageReportCreate({
 <style>
 /* jslint utility2:true */
 /*csslint ignore:start*/
-* {
-box-sizing: border-box;
-    font-family: consolas, menlo, monospace;
+.coverage,
+.coverage a,
+.coverage div,
+.coverage pre,
+.coverage span,
+.coverage table,
+.coverage tbody,
+.coverage td,
+.coverage th,
+.coverage thead,
+.coverage tr {
+    box-sizing: border-box;
+    font-family: monospace;
 }
 /*csslint ignore:end*/
 
@@ -10526,6 +10856,7 @@ body {
         }
         txtBorder = (
             "+" + "-".repeat(padPathname + 2) + "+"
+            + "-".repeat(padLines + 2) + "+"
             + "-".repeat(padLines + 2) + "+\n"
         );
         txt = "";
@@ -10533,7 +10864,8 @@ body {
         txt += txtBorder;
         txt += (
             "| " + String("Files covered").padEnd(padPathname, " ") + " | "
-            + String("Lines").padStart(padLines, " ") + " |\n"
+            + String("Lines").padStart(padLines, " ") + " | "
+            + String("Remaining").padStart(padLines, " ") + " |\n"
         );
         txt += txtBorder;
         fileList.forEach(function ({
@@ -10613,7 +10945,8 @@ body {
                 + String("./" + pathname).padEnd(padPathname, " ") + " | "
                 + String(
                     modeCoverageIgnoreFile + " " + coveragePct + " %"
-                ).padStart(padLines, " ") + " |\n"
+                ).padStart(padLines, " ") + " | "
+                + " ".repeat(padLines) + " |\n"
             );
             txt += (
                 "| " + "*".repeat(
@@ -10621,6 +10954,9 @@ body {
                 ).padEnd(padPathname, "_") + " | "
                 + String(
                     linesCovered + " / " + linesTotal
+                ).padStart(padLines, " ") + " | "
+                + String(
+                    (linesTotal - linesCovered) + " / " + linesTotal
                 ).padStart(padLines, " ") + " |\n"
             );
             txt += txtBorder;
@@ -10784,21 +11120,6 @@ ${String(count || "-0").padStart(7, " ")}
         ), txt));
     }
 
-    function pathnameRelativeCwd(pathname) {
-
-// This function will if <pathname> is inside <cwd>,
-// return it relative to <cwd>, else empty-string.
-
-        pathname = modulePath.resolve(pathname).replace((
-            /\\/g
-        ), "/");
-        if (!pathname.startsWith(cwd)) {
-            return;
-        }
-        pathname = pathname.slice(cwd.length);
-        return pathname;
-    }
-
 /*
 function sentinel() {}
 */
@@ -10830,28 +11151,26 @@ function sentinel() {}
         processArgElem[1] = processArgElem.slice(1).join("=");
         switch (processArgElem[0]) {
 
-// PR-371 - add cli-option `--exclude=aa,bb`
+// PR-371 - Add cli-option `--exclude=...`.
 
         case "--exclude":
-            fileExcludeList = fileExcludeList.concat(
-                processArgElem[1].split(",")
-            );
+            excludeList.push(processArgElem[1]);
             break;
 
-// PR-371 - add cli-option `--exclude-node-modules=false`
+// PR-371 - Add cli-option `--include=...`
 
-        case "--exclude-node-modules":
-            fileIncludeNodeModules = (
-                /0|false|null|undefined/
-            ).test(processArgElem[1]);
+        case "--include":
+            includeList.push(processArgElem[1]);
             break;
 
-// PR-371 - add cli-option `--include=aa,bb`
+// PR-400
+// Disable default-coverage of directory `node_modules`,
+// but allow override with cli-option `--include-node-modules=1`.
 
-        case "--include":
-            fileIncludeList = fileIncludeList.concat(
-                processArgElem[1].split(",")
-            );
+        case "--include-node-modules":
+            modeIncludeNodeModules = !(
+                /0|false|null|undefined/
+            ).test(processArgElem[1]);
             break;
         }
     }
@@ -10905,9 +11224,11 @@ function sentinel() {}
         ).test(file);
     });
     v8CoverageObj = await Promise.all(v8CoverageObj.map(async function (file) {
-        let data = await moduleFs.promises.readFile(coverageDir + file, "utf8");
+        let data;
+        let pathnameDict = Object.create(null);
+        data = await moduleFs.promises.readFile(coverageDir + file, "utf8");
         data = JSON.parse(data);
-        data.result = data.result.filter(function (scriptCov) {
+        data.result.forEach(function (scriptCov) {
             let pathname = scriptCov.url;
 
 // Filter out internal coverages.
@@ -10918,38 +11239,38 @@ function sentinel() {}
 
 // Normalize pathname.
 
-            pathname = pathnameRelativeCwd(moduleUrl.fileURLToPath(pathname));
-            if (
+            pathname = moduleUrl.fileURLToPath(pathname);
+            pathname = modulePath.resolve(pathname).replace((
+                /\\/g
+            ), "/");
 
 // Filter files outside of cwd.
 
-                !pathname
-                || pathname.startsWith("[")
+            if (pathname.indexOf("[") >= 0 || !pathname.startsWith(cwd)) {
+                return;
+            }
 
-// PR-371 - Filter directory node_modules.
+// Normalize pathname relative to cwd.
 
-                || (
-                    !fileIncludeNodeModules
-                    && (
-                        /(?:^|\/)node_modules\//m
-                    ).test(pathname)
-                )
+            pathname = pathname.slice(cwd.length);
+            scriptCov.url = pathname;
+            pathnameDict[pathname] = scriptCov;
+        });
 
-// PR-371 - Filter fileExcludeList.
+// PR-400 - Filter directory `node_modules`.
 
-                || fileExcludeList.indexOf(pathname) >= 0
+        if (!modeIncludeNodeModules) {
+            excludeList.push("node_modules/");
+        }
 
-// PR-371 - Filter fileIncludeList.
+// PR-400 - Filter files by glob-patterns in excludeList, includeList.
 
-                || (
-                    fileIncludeList.length > 0
-                    && fileIncludeList.indexOf(pathname) === -1
-                )
-            ) {
-                return;
-            }
-            scriptCov.url = pathname;
-            return true;
+        data.result = globExclude({
+            excludeList,
+            includeList,
+            pathnameList: Object.keys(pathnameDict)
+        }).pathnameList.map(function (pathname) {
+            return pathnameDict[pathname];
         });
         return data;
     }));
@@ -10958,7 +11279,7 @@ function sentinel() {}
 
     v8CoverageObj = v8CoverageListMerge(v8CoverageObj);
 
-// debug v8CoverageObj.
+// Debug v8CoverageObj.
 
     await fsWriteFileWithParents(
         coverageDir + "v8_coverage_merged.json",
@@ -11098,6 +11419,7 @@ jslint_export = Object.freeze(Object.assign(jslint, {
     assertOrThrow,
     debugInline,
     fsWriteFileWithParents,
+    globExclude,
     htmlEscape,
     jslint,
     jslint_apidoc,