js-dev-tool 1.2.2 → 1.2.3

package/common/index.js

@@ -9,6 +9,7 @@
  * @file js-dev-scripts/common/index.js
  */
 // @ts-check
+"use strict";
 const fs = require("fs");
 const path = require("path");
 const rl = require("readline");

package/extras/list-deps-of.js

@@ -5,6 +5,7 @@
 //  https://opensource.org/licenses/mit-license.php
 // - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
+"use strict";
 /**
  * @file list-deps-of.js
  * @command node list-deps-of.mjs typescript-jsdoctag-completions-plugin

package/extras/tiny-progress.js

@@ -5,6 +5,7 @@
   https://opensource.org/licenses/mit-license.php
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
+"use strict";
 /** [usage]
 > node -i
 let t = require("./extras/progress-sample");

package/index.js

@@ -5,6 +5,7 @@
   https://opensource.org/licenses/mit-license.php
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
+"use strict";
 const progress = require("./progress");
 const common = require("./common");
 const utils = require("./utils");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-dev-tool",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "bin": {
     "jstool": "tools.js"
   },
@@ -85,11 +85,11 @@
   "dependencies": {
     "colors.ts": "^1.0.20",
     "fflate": "^0.8.2",
-    "literate-regex": "^0.5.1",
-    "mini-semaphore": "^1.4.4",
+    "literate-regex": "^0.6.9",
+    "mini-semaphore": "^1.5.1",
     "replace": "^1.2.2",
-    "rm-cstyle-cmts": "^3.3.26",
-    "terser": "^5.44.1",
+    "rm-cstyle-cmts": "^3.4.2",
+    "terser": "^5.46.0",
     "tin-args": "^0.1.1"
   }
 }

package/progress/index.js

@@ -6,6 +6,7 @@
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 /// <reference path="./index.d.ts" preserve="true"/>
+"use strict";
 const lib = require("../common");
 const {
   checkENV,

package/progress/progress-extras.js

@@ -6,6 +6,7 @@
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 /// <reference path="./index.d.ts"/>
+"use strict";
 const lib = require("../common");
 const checkENV = () => {
   const env = process.env;

package/progress/rnd-spinner.js

@@ -5,6 +5,7 @@
   https://opensource.org/licenses/mit-license.php
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
+"use strict";
 /**
  * @file random spinner
  * @author jeffy-g <hirotom1107@gmail.com>

package/progress/test.js

@@ -5,6 +5,7 @@
   https://opensource.org/licenses/mit-license.php
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
+"use strict";
 /** [usage]
 > node -i
 let t = require("./progress/test");

package/tool-lib/cjbm.js

@@ -6,6 +6,7 @@
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 /// <reference path="./tools.d.ts"/>
+"use strict";
 // @ts-check
 /**
  * @file (C)onvert (J)S to (B)rowser (M)odule
@@ -56,7 +57,7 @@ const reImportExportDetection = compilePCREStyleRegExpLiteral(RE_TEXT);
 /**
  * @typedef {typeof reImportExportDetection} TImportExportDetectorRegex
  * @typedef {TImportExportDetectorRegex["types"]["exec"]} TImportExportDetectorRegexExecResult
- * @typedef {XRegex.StringReplacerFunction<TImportExportDetectorRegex>} TImportExportDetectRegexReplacer
+ * @typedef {XRegex.StringReplacerType<TImportExportDetectorRegex>} TImportExportDetectRegexReplacer
  */
 /**
  * Generates a replacer function to update import/export statements with a new file extension.

package/tool-lib/cmt-trick.js

@@ -6,6 +6,7 @@
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 /// <reference path="./tools.d.ts"/>
+"use strict";
 // @ts-check
 /**
  * @file comment trick toggle

package/tool-lib/ps.js

@@ -7,6 +7,7 @@
 */
 /// <reference path="./tools.d.ts"/>
 // @ts-check
+"use strict";
 const DEBUG = 0;
 /** @type {(err: NodeJS.ErrnoException, cb: () => void) => void} */
 const handleError = (err, done) => {

package/tool-lib/rws.js

@@ -7,6 +7,7 @@
 */
 /// <reference path="./tools.d.ts"/>
 // @ts-check
+"use strict";
 /**
  * @file (R)ecord(W)ebpack(S)ize
  */

package/tool-lib/tools.d.ts

@@ -5,7 +5,7 @@
   https://opensource.org/licenses/mit-license.php
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
-/// <reference types="literate-regex"/>
+/// <reference types="literate-regex/global"/>
 /**
  * @date 2023-10-25
  */

package/tool-lib/zip-task.js

@@ -7,6 +7,7 @@
 */
 /// <reference path="./tools.d.ts"/>
 // @ts-check
+"use strict";
 /**
  * @file zip compression task
  */

package/tools.js

@@ -8,8 +8,10 @@
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
 // @ts-check
+"use strict";
 const fs = require("fs");
 const path = require("path");
+const rmc = require("rm-cstyle-cmts");
 /* utilities module by own. */
 const utils = require("./utils");
 // @ts-expect- error
@@ -203,14 +205,16 @@ const ToolFunctions = {
   rmc: {
     taskName: "rm-cstyle-cmts",
     fn() {
-      const rmc = require("rm-cstyle-cmts");
+      rmc.reset();
       if (params.rmc4ts) {
         const keepBangLine = params.rmc4ts === "keepBangLine";
+        const reMultiLineChcker = /^\/\*(\*|!)\s|^\/\*(?!-).+\*\/$/;
+        const reSingleLineChecer = /^\/\/+!/;
         rmc.setListener(({ event, fragment }) => {
           if (event === /*EScannerEvent.MultiLineComment*/ 1) {
-            return /^\/\*(\*|!)\s|^\/\*(?!-).+\*\/$/.test(fragment);
+            return reMultiLineChcker.test(fragment);
           } else if (keepBangLine && event === /*EScannerEvent.SingleLineComment*/0) {
-            return /^\/\/+!/.test(fragment);
+            return reSingleLineChecer.test(fragment);
           }
           return false;
         });
@@ -220,7 +224,8 @@ const ToolFunctions = {
       processSources(
         /** @type {string} */ (this.taskName),
         (data) => {
-          return rmc(data);
+          let result = rmc(data);
+          return preserveTsReferenceDirectives(result);
         },
         {
           bases: basePaths,
@@ -236,12 +241,45 @@ const ToolFunctions = {
     rmc4ts- for typescript source.
       keep comment that start with "/*" when "*/" end mark appears in same line.
       if start with "/*-" remove it
+      keep leading "/// <reference ...>" directives above a top-level "use strict" line in CJS emit.(2026/02/03)
     rmc4ts=keepBangLine (2025/12/24)
           - In addition to the "rmc4ts" processing, it also preserves line comments that start with "//!".
 `,
   },
   zip: require("./tool-lib/zip-task")(utils),
 };
+/**
+ * Preserve TypeScript `/// <reference ...>` directives when a leading
+ * "use strict" line would otherwise push them below the directive zone
+ * after C-style comment stripping.
+ *
+ * It hoists any header reference directives back above "use strict" so the
+ * TypeScript compiler can still see them in CommonJS outputs.
+ *
+ * @param {string} jsSource - JavaScript source after comment removal.
+ * @param {true=} debug - Log when code is executed.
+ * @returns {string} Source with reference directives restored to the header.
+ * @date 2026/02/03 14:45:49
+ */
+function preserveTsReferenceDirectives(jsSource, debug) {
+  const m = /^(["'])use strict\1;?[\r\n]/.exec(jsSource);
+  if (m) {
+    const usLen = m[0].length;
+    const usLine = jsSource.slice(m.index, usLen);
+    /** @type {string[]} */
+    const knownDirectives = [];
+    const reReferenceDirectiveChecker = /^\/\/\/\s*<reference.+[\r\n]/gm;
+    let purgedSource = jsSource.slice(usLen).replace(reReferenceDirectiveChecker, (match) => {
+      knownDirectives.push(match);
+      return "";
+    });
+    if (knownDirectives.length) {
+      debug && utils.log("preserveTsReferenceDirectives applied");
+      return knownDirectives.join("") + usLine + purgedSource;
+    }
+  }
+  return jsSource;
+}
 /**
  * @param {TJSToolEntry} entry
  * @returns {entry is TJSToolEntry}

package/utils.js

@@ -20,6 +20,7 @@
 /// <reference types="./basic-types"/>
 /// <reference types="./lib/zlibjs.d.ts"/>
 // @ts-check
+"use strict";
 const fs = require("fs");
 const path = require("path");
 const lib = require("./common");