js-dev-tool 1.2.24 → 1.2.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-dev-tool",
-  "version": "1.2.24",
+  "version": "1.2.26",
   "type": "commonjs",
   "bin": {
     "jstool": "tools.js",
@@ -39,6 +39,14 @@
       "import": "./progress/*.js",
       "require": "./progress/*.js"
     },
+    "./scripts/wp/*": {
+      "types": "./scripts/wp/*.d.mts",
+      "import": "./scripts/wp/*.mjs"
+    },
+    "./scripts/vitest/*": {
+      "types": "./scripts/vitest/*.d.mts",
+      "import": "./scripts/vitest/*.mjs"
+    },
     "./basic-types": {
       "types": "./basic-types.d.ts"
     }
@@ -66,18 +74,18 @@
     "progress",
     "scripts",
     "tool-lib",
-    "./index.js",
-    "./tools.js",
-    "./utils.js",
-    "./tsconfig.json",
+    "index.js",
+    "tools.js",
+    "utils.js",
+    "tsconfig.json",
     "!tool-lib/cjbm-*",
-    "!unzip.ts",
+    "!*zip.{j,t}s",
     "!scripts/bin",
     "!publish-version.json",
     "!scripts/*.mjs",
     "!scripts/smoke",
     "!regex-test.ts",
-    "!extras/npm",
+    "!extras/{npm,navigator-uadata*}",
     "!/**/*.png",
     "!*@*.*",
     "!*fragments*",
@@ -85,16 +93,15 @@
   ],
   "peerDependencies": {
     "archiver": "^7.0.1",
-    "webpack": "*"
+    "webpack": "*",
+    "typescript": "^6"
   },
   "dependencies": {
-    "colors.ts": "^1.0.20",
-    "fflate": "^0.8.3",
+    "colors.tsz": "^1.6.4",
     "literate-regex": "^0.6.11",
-    "mini-semaphore": "^1.5.4",
     "replace": "^1.2.2",
     "rm-cstyle-cmts": "^3.4.4",
-    "terser": "^5.48.0",
+    "terser": "^5.49.0",
     "tin-args": "^0.1.7",
     "ts-cc-map": "^1.1.0"
   }

package/scripts/vitest/ts-const-enum-transform.d.mts

@@ -0,0 +1,17 @@
+import type ts from "typescript";
+/**
+ * + when could refers `vite` types
+ *
+ * @import * as NsVite from "vite";
+ *
+ * ```
+ * import * as NsVite from "vite";
+ * // @ returns {NsVite.Plugin}
+ * ```
+ *
+ * @template {unknown} R
+ * @param {string=} cwd
+ * @param {ts.CompilerOptions=} compilerOpt
+ * @param {(tsEmitFileName: string) => boolean=} validateFileName
+ */
+export declare function tsConstEnumPlugin<R>(cwd?: string, compilerOpt?: ts.CompilerOptions, validateFileName?: (fileName: string) => boolean): R;

package/scripts/vitest/ts-const-enum-transform.mjs

@@ -0,0 +1,78 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2026 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file lib/ts-const-enum-transform.mjs
+ */
+import path from "node:path";
+import ts from "typescript";
+/** @type {ts.CompilerOptions} */
+const compilerOptDefault = {
+  declaration: false,
+  declarationMap: false,
+  emitDeclarationOnly: false,
+  noEmit: false,
+  preserveConstEnums: false,
+  sourceMap: false,
+};
+/**
+ * + when could refers `vite` types
+ *
+ * &#64;import * as NsVite from "vite";
+ *
+ * ```
+ * import * as NsVite from "vite";
+ * // @ returns {NsVite.Plugin} 
+ * ```
+ *
+ * @template {unknown} R
+ * @param {string=} cwd
+ * @param {ts.CompilerOptions=} compilerOpt
+ * @param {(tsEmitFileName: string) => boolean=} validateFileName
+ */
+export function tsConstEnumPlugin(
+  cwd,
+  compilerOpt,
+  validateFileName = (fileName) => /\.(?:c|m)?jsx?$/.test(fileName)
+) {
+  /** @type {ts.Program | undefined} */
+  let program;
+  const dirname = path.dirname;
+  const normalize = path.normalize;
+  cwd ??= process.cwd();
+  const getProgram = () => {
+    if (program) return program;
+    const configPath = ts.findConfigFile(cwd, ts.sys.fileExists, "tsconfig.json");
+    if (!configPath) throw new Error("tsconfig.json was not found.");
+    const configFile = ts.readConfigFile(configPath, ts.sys.readFile);
+    const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, dirname(configPath), {
+      ...compilerOptDefault, ...compilerOpt
+    });
+    program = ts.createProgram(parsed.fileNames, parsed.options);
+    return program;
+  };
+  return /** @type {R} */({
+    name: "ts-const-enum-transform",
+    enforce: "pre",
+    handleHotUpdate() {
+      program = undefined;
+    },
+    /** @type {(code: string, id: string) => { code: string, map: null } | null} */
+    transform(_code, id) {
+      const tsc = getProgram();
+      const sourceFile = tsc.getSourceFile(
+        normalize(id.split("?")[0])
+      );
+      if (!sourceFile) return null;
+      let code = "";
+      tsc.emit(sourceFile, (outputName, outputText) => {
+        if (validateFileName(outputName)) code = outputText;
+      });
+      return code ? { code, map: null } : null;
+    },
+  });
+}

package/scripts/wp/webpack.config.util.d.mts

@@ -0,0 +1,52 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2020 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/// <reference path="../../basic-types.d.ts" preserve="true"/>
+import type webpack from "webpack";
+export type TWpConfigRequiredKeys = "name" | "mode" | "target" | "entry" | "output" | "module" | "externalsPresets" | "resolve" | "devtool" | "plugins" | "profile" | "cache" | "recordsPath" | "externals" | "experiments";
+export type WpConfig = RequireKeys<webpack.Configuration, TWpConfigRequiredKeys>;
+export type TExtraOptions = { beautify?: true; forceSourceMap?: true, altEntry?: WpConfig["entry"]; tsconfig?: string; logsSubDir?: string };
+export type TModuleIdMaker = (originId: string, module: webpack.Module) => string | number;
+export declare const CWD: string;
+/**
+ * __reduce webpack size by shorten modId__
+ *
+ * @param {TModuleIdMaker} maker
+ */
+export declare const mapModuleIds: (maker: TModuleIdMaker) => (compiler: webpack.Compiler) => void;
+export declare const numberMaker: TModuleIdMaker;
+/**
+ * + About `entry` shape
+ * 
+ * ```
+ * // "index.js"
+ * getIndexName("./src/index.js");
+ * getIndexName({ index: "./src/index.js" });
+ * getIndexName(["./src/index.js"]);
+ *
+ * // "hoge"
+ * getIndexName({ hoge: "./src/index.js" });
+ *
+ * // undefined
+ * getIndexName({});
+ * ```
+ * @param entry
+ */
+export declare function getIndexName(entry: NonNullable<WpConfig["entry"]>): string | undefined;
+/**
+ * CAVEAT: `resolve`, `entry`, `externals`, `module`, `optimization` property is __empty object__
+ *
+ * @param target
+ * @param output NOTE: On config name creation refers of `library.type`. if not specified use `commonjs2`
+ * @param [mode] default is __`"production"`__
+ * @param {TExtraOptions=} extraOpt see {@link TExtraOptions}
+ * @return {WpConfig}
+ * @version 2.0
+ */
+export declare const createWebpackConfig: (target: WpConfig["target"], output: WpConfig["output"], mode?: WpConfig["mode"], extraOpt?: TExtraOptions) => WpConfig;
+export type TCreateWebpackConfigParameters = Parameters<typeof createWebpackConfig>;
+export type TWebpackConfigParameters = [TCreateWebpackConfigParameters[0], TCreateWebpackConfigParameters[1], altEntry?: webpack.EntryObject, tsconfig?: string];

package/scripts/wp/webpack.config.util.mjs

@@ -0,0 +1,165 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2020 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/// <reference path="../../basic-types.d.ts" preserve="true"/>
+/**
+ * @file scripts/wp/webpack.config.util.mjs
+ */
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import webpack from "webpack";
+import * as progress from "./wp-progress.mjs";
+const configFileName = fileURLToPath(import.meta.url);
+export const CWD = process.cwd();
+/**
+ * @typedef {(originId: string, module: webpack.Module) => string | number} TModuleIdMaker
+ */
+/**
+ * __reduce webpack size by shorten modId__
+ * 
+ * @param {TModuleIdMaker} maker 
+ * @returns 
+ */
+export const mapModuleIds = maker => (/** @type {webpack.Compiler} */compiler) => {
+  const context = /** @type {string} */(compiler.options.context);
+  compiler.hooks.compilation.tap("ChangeModuleIdsPlugin", compilation => {
+    compilation.hooks.beforeModuleIds.tap("ChangeModuleIdsPlugin", modules => {
+      const chunkGraph = compilation.chunkGraph;
+      for (const module of modules) {
+        if (module.libIdent) {
+          const origId = module.libIdent({ context });
+          if (!origId) continue;
+          chunkGraph.setModuleId(module, maker(origId, module));
+        }
+      }
+    });
+  });
+};
+/** @type {TModuleIdMaker} */
+export const numberMaker = ((cache) => {
+  let idx = 0;
+  return (oid, mod) => {
+    let nid = cache.get(oid);
+    if (typeof nid !== "number") {
+      cache.set(oid, (nid = idx++));
+    }
+    return nid;
+  };
+})(/** @type {Map<string, number>} */(new Map()));
+/**
+ * + About `entry` shape
+ * 
+ * ```
+ * // "index.js"
+ * getIndexName("./src/index.js");
+ * getIndexName({ index: "./src/index.js" });
+ * getIndexName(["./src/index.js"]);
+ *
+ * // "hoge"
+ * getIndexName({ hoge: "./src/index.js" });
+ *
+ * // undefined
+ * getIndexName({});
+ * ```
+ * @param {NonNullable<WpConfig["entry"]>} entry 
+ */
+export function getIndexName(entry) {
+  /** @type {string=} */
+  let indexPath;
+  if (typeof entry === "string") indexPath = entry;
+  else {
+    const path = /** @type {webpack.EntryObject} */(entry).index || /** @type {webpack.EntryObject} */(entry).main;
+    if (typeof path === "string") indexPath = path;
+    else {
+      if (Array.isArray(entry)) indexPath = entry[0];
+      else if (typeof entry === "object") return Object.keys(entry)[0];
+    }
+  }
+  if (typeof indexPath === "string") return path.basename(indexPath);
+}
+/**
+ * @typedef {"name" | "mode" | "target" | "entry" | "output" | "module" | "externalsPresets" | "resolve" | "devtool" | "plugins" | "profile" | "cache" | "recordsPath" | "externals" | "experiments"} TWpConfigRequiredKeys
+ * @typedef {RequireKeys<webpack.Configuration, TWpConfigRequiredKeys>} WpConfig
+ * @typedef {{ beautify?: true; forceSourceMap?: true, altEntry?: WpConfig["entry"]; tsconfig?: string; logsSubDir?: string }} TExtraOptions
+ */
+/**
+ * @typedef {"standard" | "custom"=} TWPProgressType
+ */
+/**
+ * @date 2026/06/19 09:55:39
+ */
+const wpProgressType = /** @type {TWPProgressType} */(process.env.WP_PROGRESS_TYPE);
+/**
+ * CAVEAT: `resolve`, `entry`, `externals`, `module`, `optimization` property is __empty object__
+ * 
+ * @param {WpConfig["target"]} target 
+ * @param {WpConfig["output"]} output NOTE: On config name creation refers of `library.type`. if not specified use `commonjs2`
+ * @param {WpConfig["mode"]=} mode default is __`"production"`__
+ * @param {TExtraOptions=} extraOpt see {@link TExtraOptions}
+ * @return {WpConfig}
+ * @version 2.0
+ * @date 2022/3/20 - update jsdoc, added new parameter `extraOpt`
+ */
+export const createWebpackConfig = (target, output, mode = "production", extraOpt = {}) => {
+  const {
+    altEntry,
+    forceSourceMap,
+    logsSubDir = "webpack"
+  } = extraOpt;
+  /**
+   * @type {WpConfig["entry"]}
+   */
+  const entry = altEntry ?? {};
+  const mtype = /** @type {webpack.LibraryOptions} */(output.library)?.type ?? "commonjs2";
+  const mainName = `${target}@${mtype}_${getIndexName(entry) ?? "anonymous"}`;
+  const outputModule = mtype === "module";
+  /** @type {WpConfig} */
+  const configObject = {
+    name: `${mainName}-${mode}`,
+    mode,
+    target,
+    entry,
+    output,
+    module: {
+      rules: []
+    },
+    externals: {},
+    experiments: {},
+    externalsPresets: { node: true },
+    resolve: {
+    },
+    devtool: (forceSourceMap || mode === "development") ? "source-map" : false,
+    plugins: [],
+    optimization: {
+    },
+    profile: false,
+    cache: {
+      type: "filesystem",
+      buildDependencies: {
+        config: [configFileName],
+      },
+    },
+    recordsPath: `${CWD}/logs/${logsSubDir? logsSubDir + "/" : "" }webpack-module-ids_${mainName}.json`
+  };
+  if (outputModule) {
+    configObject.experiments = {
+      outputModule
+    };
+  }
+  if (wpProgressType === "custom") {
+    configObject.plugins.push(
+      new webpack.ProgressPlugin(
+        progress.getWebpackProgressPluginHandler(mainName)
+      )
+    );
+  }
+  return configObject;
+};
+/**
+ * @typedef {Parameters<typeof createWebpackConfig>} TCreateWebpackConfigParameters
+ * @typedef {[TCreateWebpackConfigParameters[0], TCreateWebpackConfigParameters[1], altEntry?: webpack.EntryObject, tsconfig?: string]} TWebpackConfigParameters
+ */

package/scripts/wp/wp-progress.d.mts

@@ -0,0 +1,3 @@
+export type TWebpackProgressHandler = (percentage: number, message: string, ...args: string[]) => void;
+declare const getWebpackProgressPluginHandler: (bunner: string) => TWebpackProgressHandler;
+export { getWebpackProgressPluginHandler };

package/scripts/wp/wp-progress.mjs

@@ -0,0 +1,95 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2025 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file scripts/wp/wp-progress.mjs
+ * @CAVEATS To enable `progress`, you need to install webpack and webpack-cli in package local.
+ */
+import * as extras from "../../progress/progress-extras.js";
+import * as lib from "../../common/index.js";
+/**
+ * @typedef {(percentage: number, message: string, ...args: string[]) => void} TWebpackProgressHandler
+ * @typedef {(percentage: number, message: string, ...args: string[]) => Promise<void>} TWebpackProgressHandlerPromise unused
+ */
+const PROGRESS_ROW_START = 4;
+let rowStart = PROGRESS_ROW_START;
+/**
+ * @param {number} pct
+ * @returns {string}
+ */
+const formatPercentage = pct => `processing ${(pct * 100).toFixed(4)}%`;
+/**
+ * @param {NodeJS.WriteStream} stream 
+ */
+const preparProgress = async (stream = process.stdout) => {
+  stream.write(`\x1b[${PROGRESS_ROW_START};1H`);
+  stream.write("\x1b[J");
+};
+/** @type {Map<string, number>} */
+const rowsMap = new Map();
+/** @type {(bunner: string) => TWebpackProgressHandler} */
+const getWebpackProgressPluginHandler = ((bunner) => {
+  const cwd = process.cwd();
+  const render = lib.renderLine;
+  const cwdLen = cwd.length;
+  let dotted = 0;
+  const renderDot = () => {
+    process.stderr.write(".");
+    dotted++;
+    if (dotted % 100 === 0) {
+      process.stderr.write("\n");
+    }
+  };
+  const shortenProgress = (/** @type {number} */pct) => {
+    render(formatPercentage(pct));
+    pct >= 1 && (console.log(), dotted = 0);
+  };
+  let prepar = 0;
+  /**
+   * NOTE: 2025/11/17 15:58:11 - 複数の webpack process を確実に render する最適解だろう
+   * 
+   * cursor position の取得、moveCursorTo などを試したが、期待する挙動に達するには壁があった...
+   * 
+   * @type {TWebpackProgressHandler}
+   */
+  const v5Progress = /* async */ (percentage, message, ...args) => {
+    if (!prepar) {
+      /* await */ preparProgress();
+      prepar = 1;
+    }
+    if (!message) {
+      message = "- done -";
+    }
+    let pathOrPluginName = args.shift() || "";
+    if (pathOrPluginName) {
+      const x = pathOrPluginName.lastIndexOf(cwd) + 1;
+      if (x > 0) {
+        pathOrPluginName = pathOrPluginName.slice(x + cwdLen);
+      }
+    }
+    let row = rowsMap.get(bunner);
+    if (typeof row !== "number") {
+      rowsMap.set(bunner, (row = rowStart++));
+    }
+    render(
+      `[${bunner}]: ${(percentage * 100).toFixed(4)}%, process: [${message}]${pathOrPluginName ? `, info: [${pathOrPluginName}]` : ""}${args.length ? " - " : ""}${args.join(", ")}`, row
+    );
+    percentage >= 1 && console.log();
+  };
+  const processType = extras.checkENV();
+  if (processType === "ci" || process.env.CI_CODEX) {
+    return renderDot;
+  } else {
+    if (processType === "gitpod") {
+      return shortenProgress;
+    }
+    return v5Progress;
+  }
+});
+export {
+  getWebpackProgressPluginHandler
+};

package/tools.js

@@ -9,7 +9,7 @@
 */
 // @ts-check
 "use strict";
-require("colors.ts");
+require("colors.tsz");
 const fs = require("fs");
 const path = require("path");
 const rmc = require("rm-cstyle-cmts");

package/scripts/unzip.js

@@ -1,29 +0,0 @@
-"use strict";
-const fs = require("fs");
-const fflate = require("fflate");
-const { unzip } = fflate;
-/**
- * @param {string} fileName
- */
-const decompress = (fileName) => {
-  fs.readFile(fileName, null, (err, data) => {
-    if (err) {
-      console.error(err);
-    } else {
-      console.time(fileName);
-      unzip(data, (err, unzipped) => {
-        console.timeEnd(fileName);
-        if (err) {
-          console.error(err);
-          return;
-        }
-        Object.entries(unzipped).forEach(([filename, data]) => {
-          fs.writeFile(filename, data, null, () => {
-            console.log("write:", filename);
-          });
-        });
-      });
-    }
-  });
-};
-module.exports = decompress;

package/scripts/zip.js

@@ -1,86 +0,0 @@
-const fs = require("fs");
-const path = require("path");
-const fflate = require("fflate");
-const { TextEncoder } = require("util");
-const ALREADY_COMPRESSED = [
-  "7z",   "aifc", "bz2",  "doc",  "docx",
-  "gif",  "gz",   "heic", "heif", "jpeg",
-  "jpg",  "mov",  "mp3",  "mp4",  "pdf",
-  "png",  "ppt",  "pptx", "rar",  "webm",
-  "webp", "xls",  "xlsx", "zip"
-];
-/**
- * @param {string} fileName
- * @param {(out: Uint8Array | NodeJS.ErrnoException) => void} cb
- */
-const fileToU8 = (fileName, cb /* : (out: Uint8Array) => void */) => {
-  fs.readFile(fileName, "utf8", (err, data) => {
-    if (err) {
-      cb(err);
-    } else {
-      cb(new TextEncoder().encode(data));
-    }
-  });
-};
-/**
- * @param {path.ParsedPath} parsedPath
- * @param {(out: Uint8Array | null) => void} callback
- * @param {string} [comment]
- */
-const processFile = function (parsedPath, callback, comment) {
-  const filePath = `${parsedPath.dir}/${parsedPath.base}`;
-  fileToU8(filePath, function (data) {
-    if (data instanceof Uint8Array) {
-      /** @type {fflate.AsyncZippable} */
-      const zipObj = {
-        [parsedPath.base]: [
-          data, {
-            level: ALREADY_COMPRESSED.indexOf(parsedPath.ext) === -1 ? 6 : 0,
-            comment,
-          },
-        ],
-      };
-      console.time(filePath);
-      fflate.zip(
-        zipObj,
-        {
-        },
-        function (err, out) {
-          if (err) {
-            console.log(err);
-            callback(null);
-            console.timeEnd(filePath);
-          } else {
-            console.timeEnd(filePath);
-            callback(out);
-          }
-        },
-      );
-    } else {
-      console.error(data);
-    }
-  });
-};
-/**
- * @param {string} inputPath
- * @param {string} [comment]
- * @param {string} [dest]
- */
-module.exports = function zip(inputPath, comment, dest) {
-  let actualOutput = dest;
-  const pp = path.parse(inputPath);
-  processFile(
-    pp,
-    (out) => {
-      if (out) {
-        if (!actualOutput) {
-          actualOutput = `${pp.dir ? pp.dir + "/" : ""}${pp.name}.zip`;
-        }
-        fs.writeFile(actualOutput, out, "binary", () => {
-          console.log("done!!");
-        });
-      }
-    },
-    comment,
-  );
-};