@jslint-org/jslint 2024.11.24 → 2025.10.31

package/CHANGELOG.md

@@ -2,11 +2,24 @@
 
 # Todo
 - doc - document supported/unsupported es6+ features
-- coverage - add macros `/*coverage-disable*/` and `/*coverage-enable*/`.
 - jslint - add html and css linting back into jslint.
 - jslint - add new warning requiring paren around plus-separated concatenations.
 - jslint - try to improve parser to be able to parse jquery.js without stopping.
 
+# v2025.10.31
+- coverage - Add coverage-directives '/*coverage-disable*/', '/*coverage-enable*/'. '//coverage-ignore-line'.
+
+# v2025.3.31
+- ci - Upgrade nodejs used in ci to v22.
+- ubuntu-ci - bugfix - Fix out-of-date apt-list when installing graphicsmagick.
+- jslint - Cleanup ci-shell-function shRollupFetch().
+- jslint - Update ci-shell-function shDirHttplinkValidate() with pragma <\!!--novalidate--\>.
+- ci - Upgrade python used in ci to v3.12.
+- ci - Auto-create asset_image_logo_256.png from asset_image_logo_256.html.
+- ci - Fix shell-function shRollupFetch() from making excessive github-api-request.
+- ci - Fix improperly-cropped jslint-logo, auto-generated by headless-chrome.
+- ci - Fix failed-ci from missing graphicsmagick library in latest Ubuntu image.
+
 # v2024.11.24
 - jslint - bugfix - Fix optional dynamic-property/function-call not recognized.
 - quickstart - bugfix - Fix broken quickstart-jslint-in-codemirror demo.

package/README.md

@@ -1,13 +1,13 @@
-# [<img align="left" height="80" src="asset_image_logo_512.svg"/>](https://github.com/jslint-org/jslint) JSLint, The JavaScript Code Quality and Coverage Tool
+# [<img align="left" height="80" src="asset_image_logo_256.svg"/>](https://github.com/jslint-org/jslint) JSLint, The JavaScript Code Quality and Coverage Tool
 Douglas Crockford <douglas@crockford.com>
 
 
 # Status
-| Branch | [master<br>(v2024.11.24)](https://github.com/jslint-org/jslint/tree/master) | [beta<br>(Web Demo)](https://github.com/jslint-org/jslint/tree/beta) | [alpha<br>(Development)](https://github.com/jslint-org/jslint/tree/alpha) |
+| Branch | [master<br>(v2025.10.31)](https://github.com/jslint-org/jslint/tree/master) | [beta<br>(Web Demo)](https://github.com/jslint-org/jslint/tree/beta) | [alpha<br>(Development)](https://github.com/jslint-org/jslint/tree/alpha) |
 |--:|:--:|:--:|:--:|
 | CI | [![ci](https://github.com/jslint-org/jslint/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/jslint-org/jslint/actions?query=branch%3Amaster) | [![ci](https://github.com/jslint-org/jslint/actions/workflows/ci.yml/badge.svg?branch=beta)](https://github.com/jslint-org/jslint/actions?query=branch%3Abeta) | [![ci](https://github.com/jslint-org/jslint/actions/workflows/ci.yml/badge.svg?branch=alpha)](https://github.com/jslint-org/jslint/actions?query=branch%3Aalpha) |
 | Coverage | [![coverage](https://jslint-org.github.io/jslint/branch-master/.artifact/coverage/coverage_badge.svg)](https://jslint-org.github.io/jslint/branch-master/.artifact/coverage/index.html) | [![coverage](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage/coverage_badge.svg)](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage/index.html) | [![coverage](https://jslint-org.github.io/jslint/branch-alpha/.artifact/coverage/coverage_badge.svg)](https://jslint-org.github.io/jslint/branch-alpha/.artifact/coverage/index.html) |
-| Demo | [<img src="asset_image_logo_512.svg" height="32">](https://jslint-org.github.io/jslint/branch-master/index.html) | [<img src="asset_image_logo_512.svg" height="32">](https://jslint-org.github.io/jslint/branch-beta/index.html) | [<img src="asset_image_logo_512.svg" height="32">](https://jslint-org.github.io/jslint/branch-alpha/index.html) |
+| Demo | [<img src="asset_image_logo_256.svg" height="32">](https://jslint-org.github.io/jslint/branch-master/index.html) | [<img src="asset_image_logo_256.svg" height="32">](https://jslint-org.github.io/jslint/branch-beta/index.html) | [<img src="asset_image_logo_256.svg" height="32">](https://jslint-org.github.io/jslint/branch-alpha/index.html) |
 | Artifacts | [<img src="asset_image_folder_open_solid.svg" height="30">](https://github.com/jslint-org/jslint/tree/gh-pages/branch-master/.artifact) | [<img src="asset_image_folder_open_solid.svg" height="30">](https://github.com/jslint-org/jslint/tree/gh-pages/branch-beta/.artifact) | [<img src="asset_image_folder_open_solid.svg" height="30">](https://github.com/jslint-org/jslint/tree/gh-pages/branch-alpha/.artifact) |
 
 
@@ -66,6 +66,8 @@ Douglas Crockford <douglas@crockford.com>
     - [Directive `/*property*/`](#directive-property)
     - [Directive `/*jslint-disable*/.../*jslint-enable*/`](#directive-jslint-disablejslint-enable)
     - [Directive `//jslint-ignore-line`](#directive-jslint-ignore-line)
+    - [Directive `/*coverage-disable*/.../*coverage-enable*/`](#directive-coverage-disablecoverage-enable)
+    - [Directive `//coverage-ignore-line`](#directive-coverage-ignore-line)
 
 10. [Package Listing](#package-listing)
 
@@ -891,6 +893,34 @@ eval("1"); //jslint-ignore-line
 ```
 
 
+<br><br>
+### Directive `/*coverage-disable*/.../*coverage-enable*/`
+
+```js
+/*coverage-disable*/
+
+// JSLint will ignore code-coverage in this region.
+
+if (false) {
+    console.log("hello world");
+}
+
+/*coverage-enable*/
+```
+
+
+<br><br>
+### Directive `//coverage-ignore-line`
+
+```js
+// JSLint will ignore code-coverage at given line.
+
+if (false) {
+    console.log("hello world"); //coverage-ignore-line
+}
+```
+
+
 <br><br>
 # Package Listing
 ![screenshot_package_listing.svg](https://jslint-org.github.io/jslint/branch-beta/.artifact/screenshot_package_listing.svg)
@@ -923,7 +953,7 @@ eval("1"); //jslint-ignore-line
 - `git push upstream alpha -f`
     - verify ci-success for upstream-branch-alpha
     - https://github.com/jslint-org/jslint/actions
-- goto https://github.com/jslint-org/jslint/compare/beta...kaizhu256:jslint:branch-p2024.11.24
+- goto https://github.com/jslint-org/jslint/compare/beta...kaizhu256:jslint:branch-p2025.10.28
 - click `Create pull request`
 - input `Add your description here...` with:
 ```
@@ -963,7 +993,7 @@ This PR will additionally:
 - `git push upstream alpha -f`
     - verify ci-success for upstream-branch-alpha
     - https://github.com/jslint-org/jslint/actions
-- goto https://github.com/jslint-org/jslint/compare/beta...kaizhu256:jslint:branch-v2024.11.24
+- goto https://github.com/jslint-org/jslint/compare/beta...kaizhu256:jslint:branch-v2025.10.31
 - click `Create pull request`
 - input `Add a title` with: `# v20yy.mm.dd`
 - input `Add a description` with:

package/{asset_image_logo_512.html → asset_image_logo_256.html}

@@ -3,13 +3,17 @@
 <head>
 <title>logo</title>
 <style>
-/* sh jslint_ci.sh shBrowserScreenshot asset_image_logo_512.html --window-size=512x512 */
+/* sh jslint_ci.sh shBrowserScreenshot asset_image_logo_256.html --window-size=256x256 */
 /* csslint box-model:false */
 /* csslint ignore:start */
 *,
 *:after,
 *:before {
+    background: rgba(0, 0, 0, 0);
+    border: 0;
     box-sizing: border-box;
+    margin: 0;
+    padding: 0;
 }
 @font-face {
     font-family: Daley;
@@ -155,45 +159,35 @@ pyNj+JctcQLXenBOCms46aMkenIx45WpXqxxVJQLz/vgpmAVa0fmDv6Pue9xVTBPfVxCUGfj\
     ") format("woff2");
 }
 /* csslint ignore:end */
-body,
-div {
-    margin: 0;
-}
 .container1 {
     background: antiquewhite;
-    border: 24px solid darkslategray;
-    border-radius: 96px;
+    border: 16px solid darkslategray;
+    border-radius: 48px;
     color: darkslategray;
     font-family: Daley;
-    height: 512px;
-    margin: 0;
+    height: 256px;
     position: relative;
-    width: 512px;
+    width: 256px;
     zoom: 100%;
-/*
-    background: transparent;
-    border: 24px solid black;
-    color: black;
-*/
 }
 .text1 {
-    font-size: 256px;
-    left: 44px;
+    font-size: 112px;
+    left: 36px;
     position: absolute;
-    top: 32px;
+    top: 12px;
 }
 .text2 {
     bottom: 8px;
-    font-size: 192px;
-    left: 44px;
+    font-size: 96px;
+    left: 18px;
     position: absolute;
 }
 </style>
 </head>
 <body>
 <div class="container1">
-<div class="text1">JS</div>
-<div class="text2">Lint</div>
+    <div class="text1">JS</div>
+    <div class="text2">Lint</div>
 </div>
 </body>
 </html>

package/asset_image_logo_256.svg

@@ -0,0 +1,35 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
+ "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
+<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
+ width="256.000000pt" height="256.000000pt" viewBox="0 0 256.000000 256.000000"
+ preserveAspectRatio="xMidYMid meet">
+
+<rect height="256" fill="antiquewhite" rx="48" ry="48" width="256"></rect>
+<g transform="translate(0.000000,256.000000) scale(0.100000,-0.100000)"
+fill="darkslategray" stroke="none">
+<path d="M374 2545 c-175 -38 -317 -179 -359 -356 -12 -54 -15 -190 -15 -909
+0 -918 0 -911 56 -1022 61 -120 207 -226 340 -248 78 -13 1690 -13 1768 0 191
+31 355 196 385 390 7 41 11 369 11 890 0 908 0 906 -61 1021 -38 70 -128 158
+-201 195 -105 53 -115 54 -1023 53 -659 0 -853 -3 -901 -14z m1821 -166 c68
+-25 147 -99 178 -166 l22 -48 0 -885 0 -885 -22 -47 c-26 -57 -95 -128 -155
+-160 l-43 -23 -895 0 -895 0 -43 23 c-60 32 -129 103 -155 160 l-22 47 0 885
+0 885 22 48 c30 65 110 141 175 166 52 19 75 20 915 20 849 1 863 1 918 -20z"/>
+<path d="M990 1815 l0 -375 -95 0 -95 0 0 140 0 140 -95 0 -95 0 0 -116 0
+-116 67 -69 66 -69 146 0 147 0 67 68 67 68 0 352 0 352 -90 0 -90 0 0 -375z"/>
+<path d="M1427 2122 l-67 -68 0 -94 0 -95 140 -140 140 -140 0 -72 0 -73 -45
+0 c-34 0 -68 12 -135 45 -49 25 -92 45 -95 45 -3 0 -5 -10 -5 -23 0 -15 24
+-46 68 -90 l68 -67 100 0 100 0 67 68 67 68 0 94 0 95 -140 140 -140 140 0 72
+0 73 45 0 c34 0 68 -12 135 -45 49 -25 92 -45 95 -45 3 0 5 10 5 23 0 15 -24
+46 -68 90 l-68 67 -100 0 -100 0 -67 -68z"/>
+<path d="M420 760 l0 -360 200 0 200 0 0 40 0 40 -120 0 -120 0 0 320 0 320
+-80 0 -80 0 0 -360z"/>
+<path d="M980 1080 l0 -40 80 0 80 0 0 40 0 40 -80 0 -80 0 0 -40z"/>
+<path d="M1940 1040 l0 -80 -40 0 -40 0 0 -40 0 -40 40 0 40 0 0 -182 0 -182
+57 -58 57 -58 63 0 63 0 0 40 0 40 -40 0 -40 0 0 200 0 200 40 0 40 0 0 40 0
+40 -40 0 -40 0 0 80 0 80 -80 0 -80 0 0 -80z"/>
+<path d="M980 680 l0 -280 80 0 80 0 0 280 0 280 -80 0 -80 0 0 -280z"/>
+<path d="M1300 680 l0 -280 80 0 80 0 0 240 0 240 80 0 80 0 0 -240 0 -240 80
+0 80 0 0 223 0 223 -58 57 -58 57 -182 0 -182 0 0 -280z"/>
+</g>
+</svg>

package/jslint.mjs

@@ -106,9 +106,9 @@
     formatted_message, free, freeze, from, froms, fsWriteFileWithParents,
     fud_stmt, functionName, function_list, function_stack, functions, get,
     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_weird, join, jslint,
+    holeList, htmlEscape, id, identifier, ignoreLine, import, import_list,
+    import_meta_url, inc, includeList, indent2, index, indexOf, init, initial,
+    isArray, isBlockCoverage, isHole, isNaN, is_equal, 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,
@@ -163,7 +163,7 @@ let jslint_charset_ascii = (
     + "@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_"
     + "`abcdefghijklmnopqrstuvwxyz{|}~\u007f"
 );
-let jslint_edition = "v2024.11.24";
+let jslint_edition = "v2025.10.31";
 let jslint_export;                      // The jslint object to be exported.
 let jslint_fudge = 1;                   // Fudge starting line and starting
                                         // ... column to 1.
@@ -10882,12 +10882,15 @@ body {
     background: #9d9;
 }
 .coverage .count {
-    color: #666;
+    color: #333;
 }
 .coverage .coverageIgnore {
     background: #ccc;
 }
 .coverage .coverageLow,
+.coverage .ignore {
+    background: #ccc;
+}
 .coverage .uncovered {
     background: #ebb;
 }
@@ -10911,6 +10914,10 @@ body {
 .coverage tr:hover td {
     background: #7d7;
 }
+.coverage pre:hover span.ignore,
+.coverage tr:hover td.coverageIgnore {
+    background: #ccc;
+}
 .coverage pre:hover span.uncovered,
 .coverage tr:hover td.coverageLow {
     background: #f99;
@@ -11112,6 +11119,7 @@ body {
             lineList.forEach(function ({
                 count,
                 holeList,
+                ignoreLine,
                 line,
                 startOffset
             }, ii) {
@@ -11159,7 +11167,11 @@ body {
 // true.
 
                             if (isHole) {
-                                lineHtml += " class=\"uncovered\"";
+                                lineHtml += (
+                                    ignoreLine
+                                    ? " class=\"ignore\""
+                                    : " class=\"uncovered\""
+                                );
                             }
                             lineHtml += ">";
                             chunk = "";
@@ -11179,7 +11191,9 @@ body {
 </span>
 <span class="count
                 ${(
-                    count <= 0
+                    (count <= 0 && ignoreLine)
+                    ? "ignore"
+                    : count <= 0
                     ? "uncovered"
                     : ""
                 )}"
@@ -11416,6 +11430,7 @@ function sentinel() {}
         functions,
         url: pathname
     }) {
+        let ignoreBlock = false;
         let lineList;
         let linesCovered;
         let linesTotal;
@@ -11425,14 +11440,23 @@ function sentinel() {}
         source.replace((
             /^.*$/gm
         ), function (line, startOffset) {
+            if (line === "/*coverage-disable*/") {
+                ignoreBlock = true;
+            }
             lineList[lineList.length - 1].endOffset = startOffset - 1;
             lineList.push({
                 count: -1,
                 endOffset: 0,
                 holeList: [],
+                ignoreLine: (
+                    ignoreBlock || line.endsWith("//coverage-ignore-line")
+                ),
                 line,
                 startOffset
             });
+            if (line === "/*coverage-enable*/") {
+                ignoreBlock = false;
+            }
             return "";
         });
         lineList.shift();
@@ -11485,11 +11509,13 @@ function sentinel() {}
             });
         });
         linesTotal = lineList.length;
-        linesCovered = lineList.filter(function ({
-            count
+        linesCovered = 0;
+        lineList.forEach(function ({
+            count,
+            ignoreLine
         }) {
-            return count > 0;
-        }).length;
+            linesCovered += count > 0 || ignoreLine;
+        });
         await moduleFs.promises.mkdir((
             modulePath.dirname(coverageDir + pathname)
         ), {

package/package.json

@@ -35,5 +35,5 @@
     "shCiArtifactUpload": 1,
     "shCiPublishNpm": 1,
     "type": "module",
-    "version": "2024.11.24"
+    "version": "2025.10.31"
 }

package/asset_image_logo_512.svg

@@ -1,39 +0,0 @@
-<?xml version="1.0" standalone="no"?>
-<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20010904//EN"
- "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
-<svg version="1.0" xmlns="http://www.w3.org/2000/svg"
- width="512.000000pt" height="512.000000pt" viewBox="0 0 512.000000 512.000000"
- preserveAspectRatio="xMidYMid meet">
-
-<rect height="512" fill="antiquewhite" rx="96" ry="96" width="512"></rect>
-<g transform="translate(0.000000,512.000000) scale(0.100000,-0.100000)"
-fill="darkslategray" stroke="none">
-<path d="M795 5104 c-196 -35 -360 -119 -503 -258 -127 -123 -213 -271 -264
--456 l-23 -85 0 -1745 0 -1745 22 -84 c95 -353 348 -606 703 -703 l85 -23
-1745 0 1745 0 85 23 c352 96 608 352 702 702 l23 85 0 1745 c0 1938 5 1781
--66 1959 -103 259 -338 475 -609 560 -133 41 -133 41 -1889 40 -1406 -1 -1689
--3 -1756 -15z m3513 -240 c44 -9 117 -35 172 -61 80 -39 108 -59 186 -137 78
--78 98 -106 137 -186 83 -172 78 -37 75 -1955 -4 -1903 3 -1728 -78 -1891 -68
--140 -220 -281 -365 -341 -131 -55 -66 -53 -1875 -53 -1809 0 -1744 -2 -1875
-53 -145 60 -297 201 -365 341 -81 163 -74 -12 -78 1891 -3 1919 -8 1785 75
-1955 39 80 60 109 137 186 78 78 106 98 186 137 167 81 33 75 1913 76 1483 1
-1687 -1 1755 -15z"/>
-<path d="M1748 3498 l-3 -853 -212 -3 -213 -2 0 320 0 320 -215 0 -215 0 0
--273 0 -272 153 -153 152 -152 340 0 340 0 148 148 147 147 0 813 0 812 -210
-0 -210 0 -2 -852z"/>
-<path d="M2752 4197 l-152 -152 0 -220 0 -220 320 -320 320 -320 0 -162 0
--163 -100 0 -100 0 -210 105 c-115 58 -214 105 -220 105 -6 0 -10 -26 -10 -58
-l0 -57 153 -153 152 -152 230 0 230 0 153 153 152 152 0 220 0 220 -320 320
--320 320 0 162 0 163 105 0 105 0 210 -105 c115 -58 212 -105 215 -105 3 0 5
-26 5 58 l0 57 -153 153 -152 152 -230 0 -230 0 -153 -153z"/>
-<path d="M840 1360 l0 -720 400 0 400 0 0 80 0 80 -240 0 -240 0 0 640 0 640
--160 0 -160 0 0 -720z"/>
-<path d="M1960 2000 l0 -80 160 0 160 0 0 80 0 80 -160 0 -160 0 0 -80z"/>
-<path d="M3880 1920 l0 -160 -80 0 -80 0 0 -80 0 -80 80 0 80 0 0 -368 0 -367
-113 -113 112 -112 128 0 127 0 0 80 0 80 -80 0 -80 0 0 400 0 400 80 0 80 0 0
-80 0 80 -80 0 -80 0 0 160 0 160 -160 0 -160 0 0 -160z"/>
-<path d="M1960 1200 l0 -560 160 0 160 0 0 560 0 560 -160 0 -160 0 0 -560z"/>
-<path d="M2600 1200 l0 -560 160 0 160 0 0 480 0 480 160 0 160 0 0 -480 0
--480 160 0 160 0 0 448 0 447 -113 113 -112 112 -368 0 -367 0 0 -560z"/>
-</g>
-</svg>