js-dev-tool 1.2.16 → 1.2.19

package/README.md

@@ -34,7 +34,6 @@ This section reflects the current `package.json#exports` and `package.json#files
 | `js-dev-tool/progress` | Progress renderer, spinner helpers, webpack / browserify progress hooks |
 | `js-dev-tool/progress/progress-extras` | Environment and webpack-version helpers |
 | `js-dev-tool/extras/algorithms` | Binary-search helper |
-| `js-dev-tool/extras/cc-map` | Character-code map |
 | `js-dev-tool/extras/jsonl` | JSONL readers, JSONL-to-array/map helpers, and `jsonMinify` |
 | `js-dev-tool/extras/json-minify` | `jsonMinify` |
 | `js-dev-tool/extras/progress-light` | Small fixed-frame spinner |
@@ -133,17 +132,6 @@ const index = bnSearch(values, 7, (left, right) => left - right);
 console.log(index); // 2
 ```
 
-### `js-dev-tool/extras/cc-map`
-
-Exports a character-code map object. It is most useful when you want named constants for ASCII / control-character comparisons.
-
-```js
-const CC_MAP = require("js-dev-tool/extras/cc-map");
-
-console.log(CC_MAP.LF); // 10
-console.log(CC_MAP.DOUBLE_QUOTE); // 34
-```
-
 ### `js-dev-tool/extras/jsonl`
 
 Exports:

package/common/index.d.ts

@@ -41,4 +41,39 @@ export function renderLine(msg?: string, row?: number): void;
  * @param {boolean} enabled
  * @param {NodeJS.WriteStream} [output]
  */
-export function cursor(enabled: boolean, output?: NodeJS.WriteStream): void;
+export function cursor(enabled: boolean, output?: NodeJS.WriteStream): void;
+/**
+ * Returns `true` if the given module is the entry point of the current process.
+ *
+ * Accepts either a `module` object (CommonJS) or a file path string,
+ * making it usable from both CommonJS and ESM contexts.
+ *
+ * Equivalent to `import.meta.main` in Deno / Bun,
+ * or `process.argv[1] === fileURLToPath(import.meta.url)` in ESM.
+ *
+ * @param {Partial<NodeJS.Module> | string} modOrFilePath
+ *   Pass `module` or `__filename` (CommonJS),
+ *   or `fileURLToPath(import.meta.url)` (ESM).
+ * @returns {boolean} `true` if the calling module is the entry point.
+ *
+ * @example
+ * // CommonJS — via module object:
+ * const { isMain } = require("js-dev-tool/common");
+ * if (isMain(module)) { main(); }
+ *
+ * @example
+ * // CommonJS — via __filename:
+ * const { isMain } = require("js-dev-tool/common");
+ * if (isMain(__filename)) { main(); }
+ *
+ * @example
+ * // ESM — via fileURLToPath:
+ * import { isMain } from "js-dev-tool/common";
+ * import { fileURLToPath } from "node:url";
+ * if (isMain(fileURLToPath(import.meta.url))) { main(); }
+ *
+ * @since Node.js v0.1.16
+ * @verified CJS: Confirmed working on Node.js v11.15.0 — v26.3.0.
+ * @verified ESM: Confirmed working on Node.js v12.22.11 — v26.3.0.
+ */
+export function isMain(modOrFilePath: Partial<NodeJS.Module> | string): boolean;

package/common/index.js

@@ -55,9 +55,50 @@ const cursor = (enabled, output = process.stderr) => {
     output.write("\x1B[?25l");
   }
 };
+/**
+ * Returns `true` if the given module is the entry point of the current process.
+ *
+ * Accepts either a `module` object (CommonJS) or a file path string,
+ * making it usable from both CommonJS and ESM contexts.
+ *
+ * Equivalent to `import.meta.main` in Deno / Bun,
+ * or `process.argv[1] === fileURLToPath(import.meta.url)` in ESM.
+ *
+ * @param {Partial<NodeJS.Module> | string} modOrFilePath
+ *   Pass `module` or `__filename` (CommonJS),
+ *   or `fileURLToPath(import.meta.url)` (ESM).
+ * @returns {boolean} `true` if the calling module is the entry point.
+ *
+ * @example
+ * // CommonJS — via module object:
+ * const { isMain } = require("js-dev-tool/common");
+ * if (isMain(module)) { main(); }
+ *
+ * @example
+ * // CommonJS — via __filename:
+ * const { isMain } = require("js-dev-tool/common");
+ * if (isMain(__filename)) { main(); }
+ *
+ * @example
+ * // ESM — via fileURLToPath:
+ * import { isMain } from "js-dev-tool/common";
+ * import { fileURLToPath } from "node:url";
+ * if (isMain(fileURLToPath(import.meta.url))) { main(); }
+ *
+ * @since Node.js v0.1.16
+ * @verified CJS: Confirmed working on Node.js v11.15.0 — v26.3.0.
+ * @verified ESM: Confirmed working on Node.js v12.22.11 — v26.3.0.
+ */
+function isMain(modOrFilePath) {
+  if (typeof modOrFilePath === "string") {
+    return process.argv[1] === modOrFilePath;
+  }
+  return require.main === modOrFilePath;
+}
 module.exports = {
   checkParentDirectory,
   createLogStreamAndResolvePath,
   renderLine,
   cursor,
+  isMain,
 };

package/extras/gzip-tool.d.ts

@@ -0,0 +1,34 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2026 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file extras/gzip-tool.d.ts
+ */
+import type { InputType } from "zlib";
+/**
+ * Compresses input data as gzip and optionally normalizes the header timestamp.
+ *
+ * The compressed output is produced with level 9 and the default zlib strategy.  
+ * When `useZeroTimestamp` is enabled, the gzip `mtime` header is overwritten with `0`
+ * so repeated runs with the same input produce stable binary output.
+ *
+ * @param {InputType} data raw data to compress
+ * @param {boolean=} [useZeroTimestamp=true] when `true`, zeroes the gzip `mtime` header. (default __`true`__)
+ * @returns {Buffer} gzip-compressed binary data
+ */
+export function gzip(data: InputType, useZeroTimestamp?: boolean): Buffer;
+/**
+ * Encodes binary data as Base64 and formats it as a JavaScript string-literal fragment.
+ *
+ * Each wrapped line ends with a trailing backslash so the returned text can be pasted
+ * directly into source code as a multi-line continued string literal.
+ *
+ * @param {Uint8Array} rawData raw bytes to encode
+ * @param {number=} [wrapSize=100] max Base64 characters per physical line. (default __`100`__)
+ * @returns {string} Base64 text wrapped with `\\\n` line continuations
+ */
+export function toBase64SourceLiteral(rawData: Uint8Array, wrapSize?: number): string;

package/extras/gzip-tool.js

@@ -0,0 +1,60 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2026 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+"use strict";
+/**
+ * @file extras/gzip-tool.js
+ */
+const { gzipSync, constants } = require("zlib");
+/**
+ * @import { InputType } from "zlib";
+ */
+/**
+ * Compresses input data as gzip and optionally normalizes the header timestamp.
+ *
+ * The compressed output is produced with level 9 and the default zlib strategy.  
+ * When `useZeroTimestamp` is enabled, the gzip `mtime` header is overwritten with `0`
+ * so repeated runs with the same input produce stable binary output.
+ *
+ * @param {InputType} data raw data to compress
+ * @param {boolean=} [useZeroTimestamp=true] when `true`, zeroes the gzip `mtime` header. (default __`true`__)
+ * @returns {Buffer} gzip-compressed binary data
+ */
+function gzip(data, useZeroTimestamp = true) {
+  const compressed = gzipSync(data, {
+    level: 9, strategy: constants.Z_DEFAULT_STRATEGY
+  });
+  if (useZeroTimestamp) {
+    compressed.writeUInt32LE(0, 4);
+  }
+  return compressed;
+}
+/**
+ * Encodes binary data as Base64 and formats it as a JavaScript string-literal fragment.
+ *
+ * Each wrapped line ends with a trailing backslash so the returned text can be pasted
+ * directly into source code as a multi-line continued string literal.
+ *
+ * @param {Uint8Array} rawData raw bytes to encode
+ * @param {number=} [wrapSize=100] max Base64 characters per physical line. (default __`100`__)
+ * @returns {string} Base64 text wrapped with `\\\n` line continuations
+ */
+function toBase64SourceLiteral(rawData, wrapSize = 100) {
+  if (!Number.isFinite(wrapSize)) throw new Error(`Invalid wrapSize: ${wrapSize}`);
+  if (!Number.isInteger(wrapSize)) throw new Error(`wrapSize is not a integer - ${wrapSize}`);
+  if (wrapSize > 2048) throw new Error(`"wrapSize" is expected to be 2048 or less - ${wrapSize}`);
+  if (wrapSize < 1) throw new Error(`A wrapSize of 0 or less will result in an infinite loop, so please make it 1 or greater. - ${wrapSize}`);
+  const base64 = Buffer.from(rawData).toString("base64");
+  let wrapped = "";
+  for (let offset = 0, L = base64.length; offset < L;) {
+    wrapped += `${base64.slice(offset, offset += wrapSize)}\\\n`;
+  }
+  return wrapped.slice(0, -2);
+}
+module.exports = {
+  gzip, toBase64SourceLiteral
+};

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "js-dev-tool",
-  "version": "1.2.16",
+  "version": "1.2.19",
+  "type": "commonjs",
   "bin": {
     "jstool": "tools.js",
     "tgl-jsonl": "extras/toggle-jsonl.js"
@@ -74,6 +75,7 @@
     "!scripts/bin",
     "!publish-version.json",
     "!scripts/*.mjs",
+    "!scripts/smoke",
     "!regex-test.ts",
     "!extras/npm",
     "!/**/*.png",
@@ -87,12 +89,12 @@
   },
   "dependencies": {
     "colors.ts": "^1.0.20",
-    "fflate": "^0.8.2",
+    "fflate": "^0.8.3",
     "literate-regex": "^0.6.11",
     "mini-semaphore": "^1.5.4",
     "replace": "^1.2.2",
     "rm-cstyle-cmts": "^3.4.4",
-    "terser": "^5.47.1",
+    "terser": "^5.48.0",
     "tin-args": "^0.1.6",
     "ts-cc-map": "^1.1.0"
   }

package/extras/cc-map.d.ts

@@ -1,141 +0,0 @@
-/*!
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-//  Copyright (C) 2026 jeffy-g <hirotom1107@gmail.com>
-//  Released under the MIT license
-//  https://opensource.org/licenses/mit-license.php
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-*/
-/**
- * @file extras/cc-map.d.ts
- */
-export declare type TCC_MAP = {
-  /** `\u0000` */ NULL: 0;
-  /** `\u0001` */ SOH: 1;
-  /** `\u0002` */ STX: 2;
-  /** `\u0003` */ ETX: 3;
-  /** `\u0004` */ EOT: 4;
-  /** `\u0005` */ ENQ: 5;
-  /** `\u0006` */ ACK: 6;
-  /** `\u0007` */ BEL: 7;
-  /** `\u0008` */ BS: 8;
-  /** `\t` */     TAB: 9;
-  /** `\n` */     LF: 10;
-  /** `\u000b` */ VT: 11;
-  /** `\f` */     FF: 12;
-  /** `\r` */     CR: 13;
-  /** `\u000e` */ SO: 14;
-  /** `\u000f` */ SI: 15;
-  /** `\u0010` */ DLE: 16;
-  /** `\u0011` */ DC1: 17;
-  /** `\u0012` */ DC2: 18;
-  /** `\u0013` */ DC3: 19;
-  /** `\u0014` */ DC4: 20;
-  /** `\u0015` */ NAK: 21;
-  /** `\u0016` */ SYN: 22;
-  /** `\u0017` */ ETB: 23;
-  /** `\u0018` */ CAN: 24;
-  /** `\u0019` */ EM: 25;
-  /** `\u001a` */ SUB: 26;
-  /** `\u001b` */ ESC: 27;
-  /** `\u001c` */ FS: 28;
-  /** `\u001d` */ GS: 29;
-  /** `\u001e` */ RS: 30;
-  /** `\u001f` */ US: 31;
-  /** ` ` */ SPACE: 32;
-  /** `!` */ EXCLAMATION: 33;
-  /** `"` */ DOUBLE_QUOTE: 34;
-  /** `#` */ HASH: 35;
-  /** `$` */ DOLLAR: 36;
-  /** `%` */ PERCENT: 37;
-  /** `&` */ AMPERSAND: 38;
-  /** `'` */ SINGLE_QUOTE: 39;
-  /** `(` */ LEFT_PAREN: 40;
-  /** `)` */ RIGHT_PAREN: 41;
-  /** `*` */ ASTERISK: 42;
-  /** `+` */ PLUS: 43;
-  /** `,` */ COMMA: 44;
-  /** `-` */ MINUS: 45;
-  /** `.` */ PERIOD: 46;
-  /** `/` */ SLASH: 47;
-  /** `0` */ ZERO: 48;
-  /** `1` */ ONE: 49;
-  /** `2` */ TWO: 50;
-  /** `3` */ THREE: 51;
-  /** `4` */ FOUR: 52;
-  /** `5` */ FIVE: 53;
-  /** `6` */ SIX: 54;
-  /** `7` */ SEVEN: 55;
-  /** `8` */ EIGHT: 56;
-  /** `9` */ NINE: 57;
-  /** `:` */ COLON: 58;
-  /** `;` */ SEMICOLON: 59;
-  /** `<` */ LESS_THAN: 60;
-  /** `=` */ EQUAL: 61;
-  /** `>` */ GREATER_THAN: 62;
-  /** `?` */ QUESTION: 63;
-  /** `@` */ AT: 64;
-  /** `A` */ A: 65;
-  /** `B` */ B: 66;
-  /** `C` */ C: 67;
-  /** `D` */ D: 68;
-  /** `E` */ E: 69;
-  /** `F` */ F: 70;
-  /** `G` */ G: 71;
-  /** `H` */ H: 72;
-  /** `I` */ I: 73;
-  /** `J` */ J: 74;
-  /** `K` */ K: 75;
-  /** `L` */ L: 76;
-  /** `M` */ M: 77;
-  /** `N` */ N: 78;
-  /** `O` */ O: 79;
-  /** `P` */ P: 80;
-  /** `Q` */ Q: 81;
-  /** `R` */ R: 82;
-  /** `S` */ S: 83;
-  /** `T` */ T: 84;
-  /** `U` */ U: 85;
-  /** `V` */ V: 86;
-  /** `W` */ W: 87;
-  /** `X` */ X: 88;
-  /** `Y` */ Y: 89;
-  /** `Z` */ Z: 90;
-  /** `[` */ LEFT_BRACKET: 91;
-  /** `\` */ BACKSLASH: 92;
-  /** `]` */ RIGHT_BRACKET: 93;
-  /** `^` */ CARET: 94;
-  /** `_` */ UNDERSCORE: 95;
-  /** __`__ */ GRAVE: 96;
-  /** `a` */ a: 97;
-  /** `b` */ b: 98;
-  /** `c` */ c: 99;
-  /** `d` */ d: 100;
-  /** `e` */ e: 101;
-  /** `f` */ f: 102;
-  /** `g` */ g: 103;
-  /** `h` */ h: 104;
-  /** `i` */ i: 105;
-  /** `j` */ j: 106;
-  /** `k` */ k: 107;
-  /** `l` */ l: 108;
-  /** `m` */ m: 109;
-  /** `n` */ n: 110;
-  /** `o` */ o: 111;
-  /** `p` */ p: 112;
-  /** `q` */ q: 113;
-  /** `r` */ r: 114;
-  /** `s` */ s: 115;
-  /** `t` */ t: 116;
-  /** `u` */ u: 117;
-  /** `v` */ v: 118;
-  /** `w` */ w: 119;
-  /** `x` */ x: 120;
-  /** `y` */ y: 121;
-  /** `z` */ z: 122;
-  /** `{` */ LEFT_BRACE: 123;
-  /** `|` */ PIPE: 124;
-  /** `}` */ RIGHT_BRACE: 125;
-  /** `~` */ TILDE: 126;
-};
-declare const CC_MAP: TCC_MAP;
-export = CC_MAP;

package/extras/cc-map.js

@@ -1,140 +0,0 @@
-/*!
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-//  Copyright (C) 2026 jeffy-g <hirotom1107@gmail.com>
-//  Released under the MIT license
-//  https://opensource.org/licenses/mit-license.php
-// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-*/
-/**
- * @file extras/cc-map.js
- * @import { TCC_MAP } from "./cc-map";
- */
-module.exports = /** @type {TCC_MAP}  */({
-  /** `\u0000` */ NULL: 0,
-  /** `\u0001` */ SOH: 1,
-  /** `\u0002` */ STX: 2,
-  /** `\u0003` */ ETX: 3,
-  /** `\u0004` */ EOT: 4,
-  /** `\u0005` */ ENQ: 5,
-  /** `\u0006` */ ACK: 6,
-  /** `\u0007` */ BEL: 7,
-  /** `\u0008` */ BS: 8,
-  /** `\t` */     TAB: 9,
-  /** `\n` */     LF: 10,
-  /** `\u000b` */ VT: 11,
-  /** `\f` */     FF: 12,
-  /** `\r` */     CR: 13,
-  /** `\u000e` */ SO: 14,
-  /** `\u000f` */ SI: 15,
-  /** `\u0010` */ DLE: 16,
-  /** `\u0011` */ DC1: 17,
-  /** `\u0012` */ DC2: 18,
-  /** `\u0013` */ DC3: 19,
-  /** `\u0014` */ DC4: 20,
-  /** `\u0015` */ NAK: 21,
-  /** `\u0016` */ SYN: 22,
-  /** `\u0017` */ ETB: 23,
-  /** `\u0018` */ CAN: 24,
-  /** `\u0019` */ EM: 25,
-  /** `\u001a` */ SUB: 26,
-  /** `\u001b` */ ESC: 27,
-  /** `\u001c` */ FS: 28,
-  /** `\u001d` */ GS: 29,
-  /** `\u001e` */ RS: 30,
-  /** `\u001f` */ US: 31,
-  /** " " */ SPACE: 32,
-  /** `!` */ EXCLAMATION: 33,
-  /** `"` */ DOUBLE_QUOTE: 34,
-  /** `#` */ HASH: 35,
-  /** `$` */ DOLLAR: 36,
-  /** `%` */ PERCENT: 37,
-  /** `&` */ AMPERSAND: 38,
-  /** `'` */ SINGLE_QUOTE: 39,
-  /** `(` */ LEFT_PAREN: 40,
-  /** `)` */ RIGHT_PAREN: 41,
-  /** `*` */ ASTERISK: 42,
-  /** `+` */ PLUS: 43,
-  /** `,` */ COMMA: 44,
-  /** `-` */ MINUS: 45,
-  /** `.` */ PERIOD: 46,
-  /** `/` */ SLASH: 47,
-  /** `0` */ ZERO: 48,
-  /** `1` */ ONE: 49,
-  /** `2` */ TWO: 50,
-  /** `3` */ THREE: 51,
-  /** `4` */ FOUR: 52,
-  /** `5` */ FIVE: 53,
-  /** `6` */ SIX: 54,
-  /** `7` */ SEVEN: 55,
-  /** `8` */ EIGHT: 56,
-  /** `9` */ NINE: 57,
-  /** `:` */ COLON: 58,
-  /** `;` */ SEMICOLON: 59,
-  /** `<` */ LESS_THAN: 60,
-  /** `=` */ EQUAL: 61,
-  /** `>` */ GREATER_THAN: 62,
-  /** `?` */ QUESTION: 63,
-  /** `@` */ AT: 64,
-  /** `A` */ A: 65,
-  /** `B` */ B: 66,
-  /** `C` */ C: 67,
-  /** `D` */ D: 68,
-  /** `E` */ E: 69,
-  /** `F` */ F: 70,
-  /** `G` */ G: 71,
-  /** `H` */ H: 72,
-  /** `I` */ I: 73,
-  /** `J` */ J: 74,
-  /** `K` */ K: 75,
-  /** `L` */ L: 76,
-  /** `M` */ M: 77,
-  /** `N` */ N: 78,
-  /** `O` */ O: 79,
-  /** `P` */ P: 80,
-  /** `Q` */ Q: 81,
-  /** `R` */ R: 82,
-  /** `S` */ S: 83,
-  /** `T` */ T: 84,
-  /** `U` */ U: 85,
-  /** `V` */ V: 86,
-  /** `W` */ W: 87,
-  /** `X` */ X: 88,
-  /** `Y` */ Y: 89,
-  /** `Z` */ Z: 90,
-  /** `[` */ LEFT_BRACKET: 91,
-  /** `\` */ BACKSLASH: 92,
-  /** `]` */ RIGHT_BRACKET: 93,
-  /** `^` */ CARET: 94,
-  /** `_` */ UNDERSCORE: 95,
-  /** __`__ */ GRAVE: 96,
-  /** `a` */ a: 97,
-  /** `b` */ b: 98,
-  /** `c` */ c: 99,
-  /** `d` */ d: 100,
-  /** `e` */ e: 101,
-  /** `f` */ f: 102,
-  /** `g` */ g: 103,
-  /** `h` */ h: 104,
-  /** `i` */ i: 105,
-  /** `j` */ j: 106,
-  /** `k` */ k: 107,
-  /** `l` */ l: 108,
-  /** `m` */ m: 109,
-  /** `n` */ n: 110,
-  /** `o` */ o: 111,
-  /** `p` */ p: 112,
-  /** `q` */ q: 113,
-  /** `r` */ r: 114,
-  /** `s` */ s: 115,
-  /** `t` */ t: 116,
-  /** `u` */ u: 117,
-  /** `v` */ v: 118,
-  /** `w` */ w: 119,
-  /** `x` */ x: 120,
-  /** `y` */ y: 121,
-  /** `z` */ z: 122,
-  /** `{` */ LEFT_BRACE: 123,
-  /** `|` */ PIPE: 124,
-  /** `}` */ RIGHT_BRACE: 125,
-  /** `~` */ TILDE: 126,
-});