js-dev-tool 1.2.1 → 1.2.3

package/basic-types.d.ts

@@ -85,10 +85,10 @@ type Constructor<T> = new (...args: any[]) => T;
  *   - If it is **1**, the types are displayed concatenated.
  *   - If it is **0**, the types are displayed separated by "&".
  */
-type RequireThese<T, K extends keyof T, Merge extends 1 | 0 = 0> =
-  Merge extends 1 ? Prettify<
-  T & Required<Pick<T, K>>
-> : T & Required<Pick<T, K>>;
+type RequireThese<
+  T, K extends keyof T, Merge extends 1 | 0 = 0,
+  Intersected = T & Required<Pick<T, K>>
+> = Merge extends 1 ? Prettify<Intersected> : Intersected;
 /**
  * pick any `property` as excludes
  */

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

@@ -0,0 +1,213 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2026 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+"use strict";
+/**
+ * @file list-deps-of.js
+ * @command node list-deps-of.mjs typescript-jsdoctag-completions-plugin
+ *
+ * CAVEAT: yarn v1.x lock file 専用
+ */
+const fs = require("fs");
+const path = require("path");
+/** @param {string} raw */
+function parseSelectors(raw) {
+  if (raw.includes("\"")) {
+    const selectors = [];
+    const regex = /"([^"]+)"/g;
+    let match = regex.exec(raw);
+    while (match) {
+      selectors.push(match[1]);
+      match = regex.exec(raw);
+    }
+    if (selectors.length > 0) {
+      return selectors;
+    }
+  }
+  return raw.split(/\s?,\s?/)
+}
+/** @param {string} selector */
+function selectorToName(selector) {
+  const npmIndex = selector.indexOf("@npm:");
+  if (npmIndex !== -1) {
+    return selector.slice(0, npmIndex);
+  }
+  const lastAt = selector.lastIndexOf("@");
+  if (lastAt > 0) {
+    return selector.slice(0, lastAt);
+  }
+  return selector;
+}
+/**
+ * ```
+ * /^[^\s].+:/;
+ * ```
+ */
+const re_ModuleStart = /^[^\s].+:/;
+/**
+ * ```
+ * /^\x20{2}(?:(?:optionalD|d)ependencies):$/;
+ * ```
+ */
+const re_DepsStart = /^\x20{2}(?:(?:optionalD|d)ependencies):$/;
+/**
+ * ```
+ * /\x20{4}/;
+ * ```
+ */
+const re_DepsEntryIndent = /^\x20{4}[^\s]/;
+/**
+ * @typedef {{
+ *  name?: string;
+ *  selectors: string[];
+ *  deps: { name: string; range: string; }[]
+ * }} TDependenciesEntry
+ */
+/** @param {string} yarnLockSource */
+function parseLockfile(yarnLockSource) {
+  /** @type {TDependenciesEntry[]} */
+  const entries = [];
+  const lines = yarnLockSource.split(/\r?\n/);
+  /** @type {TDependenciesEntry | null} */
+  let current = null;
+  let inDepsSection = false;
+  const modEntryChecker = re_ModuleStart;
+  const depsStartChecker = re_DepsStart;
+  const depsEntryChecker = re_DepsEntryIndent;
+  const reDepsExtractor = /(?:"([^"]+)"|([^"\s]+))\s+"([^"]+)"\s*$/;
+  const commitCurrent = () => {
+    if (current) {
+      entries.push(current);
+    }
+  };
+  for (const line of lines) {
+    if (line.length === 0) {
+      inDepsSection = false;
+      continue;
+    }
+    if (line.startsWith("#")) {
+      continue;
+    }
+    if (modEntryChecker.test(line)) {
+      commitCurrent();
+      const rawKeys = line.slice(0, -1);
+      const selectors = parseSelectors(rawKeys);
+      current = { selectors, deps: [] };
+      inDepsSection = false;
+      continue;
+    }
+    if (!current) {
+      continue;
+    }
+    if (depsStartChecker.test(line)) {
+      inDepsSection = true;
+      continue;
+    }
+    if (inDepsSection && depsEntryChecker.test(line)) {
+      const trimmed = line.trim();
+      const match = reDepsExtractor.exec(trimmed);
+      if (match) {
+        const name = match[1] || match[2];
+        const range = match[3];
+        current.deps.push({ name, range });
+      }
+    }
+  }
+  commitCurrent();
+  /** @type {Map<string, TDependenciesEntry>} */
+  const selectorToEntry = new Map();
+  /** @type {Map<string, TDependenciesEntry[]>} */
+  const nameToEntries = new Map();
+  for (const entry of entries) {
+    if (entry.selectors.length === 0) {
+      continue;
+    }
+    const name = selectorToName(entry.selectors[0]);
+    entry.name = name;
+    for (const selector of entry.selectors) {
+      selectorToEntry.set(selector, entry);
+    }
+    if (!nameToEntries.has(name)) {
+      nameToEntries.set(name, []);
+    }
+    // @ts-expect-error
+    nameToEntries.get(name).push(entry);
+  }
+  return { entries, selectorToEntry, nameToEntries };
+}
+/**
+ * @param {string} depName 
+ * @param {string} depRange 
+ * @param {Map<string, TDependenciesEntry>} selectorToEntry 
+ * @param {Map<string, TDependenciesEntry[]>} nameToEntries 
+ */
+function resolveEntries(depName, depRange, selectorToEntry, nameToEntries) {
+  const exactSelector = depName + "@" + depRange;
+  const exactEntry = selectorToEntry.get(exactSelector);
+  if (exactEntry) {
+    return [exactEntry];
+  }
+  const entries = nameToEntries.get(depName);
+  if (entries) {
+    return entries;
+  }
+  return [];
+}
+/**
+ * @param {TDependenciesEntry[]} startEntries 
+ * @param {Map<string, TDependenciesEntry>} selectorToEntry 
+ * @param {Map<string, TDependenciesEntry[]>} nameToEntries 
+ */
+function collectDependencies(startEntries, selectorToEntry, nameToEntries) {
+  /** @type {Set<string>} */
+  const result = new Set();
+  /** @type {Set<TDependenciesEntry>} */
+  const visitedEntries = new Set();
+  const stack = [...startEntries];
+  while (stack.length > 0) {
+    const entry = stack.pop();
+    if (!entry || visitedEntries.has(entry)) {
+      continue;
+    }
+    visitedEntries.add(entry);
+    for (const dep of entry.deps) {
+      result.add(dep.name);
+      const resolvedEntries = resolveEntries(
+        dep.name,
+        dep.range,
+        selectorToEntry,
+        nameToEntries
+      );
+      for (const resolvedEntry of resolvedEntries) {
+        if (!visitedEntries.has(resolvedEntry)) {
+          stack.push(resolvedEntry);
+        }
+      }
+    }
+  }
+  return result;
+}
+const lockfilePath = "yarn.lock";
+/**
+ * @param {string} targetName
+ * @returns {string[]}
+ */
+function listDependenciesOf(targetName) {
+  const resolvedLockfilePath = path.resolve(process.cwd(), lockfilePath);
+  if (!fs.existsSync(resolvedLockfilePath)) {
+    console.error("Lockfile not found: " + resolvedLockfilePath);
+  }
+  const lockText = fs.readFileSync(resolvedLockfilePath, "utf8");
+  const { selectorToEntry, nameToEntries } = parseLockfile(lockText);
+  const startEntries = nameToEntries.get(targetName) || [];
+  if (startEntries.length === 0) {
+    console.error("Module not found in yarn.lock: " + targetName);
+  }
+  const deps = collectDependencies(startEntries, selectorToEntry, nameToEntries);
+  return Array.from(deps).sort();
+}
+module.exports = { listDependenciesOf };

package/extras/list-deps-of.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+list-deps-of() {
+  local module_name="${1:-}"
+  if [ -z "${module_name}" ]; then
+    echo "Usage: list-deps-of <module-name> [--lockfile <path>]" >&2
+    return 1
+  fi
+
+  local script_dir
+  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  node "${script_dir}/list-deps-of.js" "$@"
+}
+
+if [ "${BASH_SOURCE[0]}" = "$0" ]; then
+  list-deps-of "$@"
+fi

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.1",
+  "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.d.ts

@@ -159,4 +159,5 @@ export const CI: boolean;
 /**
  * Nothing is logged in a CI environment.
  */
-export const log: typeof console.log;
+export const log: typeof console.log;
+export const listDependenciesOf: typeof import("./extras/list-deps-of").listDependenciesOf;

package/utils.js

@@ -20,10 +20,12 @@
 /// <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");
 const tinArgs = require("tin-args");
+const { listDependenciesOf } = require("./extras/list-deps-of");
 const CI = !!process.env.CI;
 /**
  * Nothing is logged in a CI environment.
@@ -406,4 +408,5 @@ module.exports = {
   fireReplace,
   CI,
   log,
+  listDependenciesOf
 };