js-dev-tool 1.2.10 → 1.2.11

package/extras/cc-map.d.ts

@@ -0,0 +1,141 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  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 = {
+  /** `\u0001` */ 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

@@ -0,0 +1,140 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  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}  */({
+  /** `\u0001` */ 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,
+});

package/extras/jsonl.d.ts

@@ -113,4 +113,11 @@ export function readJsonlMapByKey<TRow = any, TOut = TRow>(fileName: string, opt
  *
  * Intended for performance-sensitive hot paths where full `JSON.parse` is unnecessary.
  */
-export function fastGetIntFieldCheap(line: string, key: string): number | undefined;
+export function fastGetIntFieldCheap(line: string, key: string): number | undefined;
+/**
+ * Minify JSON or JSONL text by removing JSON whitespace outside strings.
+ *
+ * - A single top-level value is returned as minified JSON.
+ * - Multiple top-level values are returned as minified JSONL separated by `"\n"`.
+ */
+export function jsonMinify(source: string): string;

package/extras/jsonl.js

@@ -11,6 +11,7 @@
  */
 const fs = require("fs");
 const path = require("path");
+const ccMap = require("./cc-map");
 /**
  * @import { TJsonlReadOption, TJsonlReadBaseOption } from "./jsonl.js";
  */
@@ -71,6 +72,231 @@ function fastGetIntFieldCheap(line, key) {
   }
   return ok ? sign * n : undefined;
 }
+/**
+ * @typedef {{ src: string }} TJsonSourceEnvelop
+ */
+/**
+ * Minify JSON or JSONL text by removing JSON whitespace outside double-quoted strings.
+ *
+ * - A single top-level value is returned as minified JSON.
+ * - Multiple top-level values are returned as minified JSONL separated by `"\n"`.
+ *
+ * @param {string} source
+ * @returns {string}
+ */
+function jsonMinify(source) {
+  if (typeof source !== "string") {
+    throw new TypeError("jsonMinify(source): source must be a string");
+  }
+  /** @type {TJsonSourceEnvelop} */
+  const out = { src: "" };
+  const sourceLen = source.length;
+  let offset = 0;
+  let count = 0;
+  while (true) {
+    const next = skipWhitespaces(source, offset);
+    if (next >= sourceLen) {
+      break;
+    }
+    if (count > 0) {
+      if (next === offset) {
+        throwJsonSyntaxError("Missing whitespace between top-level JSON values", next);
+      }
+      out.src += "\n";
+    }
+    offset = scanJsonValue(source, next, out);
+    count++;
+  }
+  return out.src;
+}
+/**
+ * @param {string} source
+ * @param {number} offset
+ * @param {TJsonSourceEnvelop} out
+ * @returns {number}
+ */
+function scanJsonValue(source, offset, out) {
+  offset = skipWhitespaces(source, offset);
+  if (offset >= source.length) {
+    throwJsonSyntaxError("Unexpected end of JSON input", offset);
+  }
+  switch (source[offset]) {
+    case "\"": {
+      const next = skipQuotedString(source, offset);
+      out.src += source.slice(offset, next);
+      return next;
+    }
+    case "{": return scanJsonObject(source, offset, out);
+    case "[": return scanJsonArray(source, offset, out);
+    default: {
+      const next = skipOthers(source, offset);
+      out.src += source.slice(offset, next);
+      return next;
+    }
+  }
+}
+/**
+ * @param {string} source
+ * @param {number} offset
+ * @param {TJsonSourceEnvelop} out
+ * @returns {number}
+ * @throws {SyntaxError}
+ */
+function scanJsonObject(source, offset, out) {
+  out.src += "{";
+  offset = skipWhitespaces(source, offset + 1);
+  if (offset >= source.length) {
+    throwJsonSyntaxError("Unterminated JSON object", offset);
+  }
+  if (source[offset] === "}") {
+    out.src += "}";
+    return offset + 1;
+  }
+  while (offset < source.length) {
+    if (source.charCodeAt(offset) !== ccMap.DOUBLE_QUOTE) {
+      throwJsonSyntaxError("JSON object key must start with a double quote", offset);
+    }
+    const keyEnd = skipQuotedString(source, offset);
+    out.src += source.slice(offset, keyEnd);
+    offset = skipWhitespaces(source, keyEnd);
+    if (source[offset] !== ":") {
+      throwJsonSyntaxError("Missing colon after JSON object key", offset);
+    }
+    out.src += ":";
+    offset = scanJsonValue(source, offset + 1, out);
+    offset = skipWhitespaces(source, offset);
+    if (offset >= source.length) {
+      break;
+    }
+    const ch = source[offset];
+    if (ch === ",") {
+      out.src += ",";
+      offset = skipWhitespaces(source, offset + 1);
+      continue;
+    }
+    if (ch === "}") {
+      out.src += "}";
+      return offset + 1;
+    }
+    throwJsonSyntaxError("Unexpected token in JSON object", offset);
+  }
+  throwJsonSyntaxError("Unterminated JSON object", offset);
+}
+/**
+ * @param {string} source
+ * @param {number} offset
+ * @param {TJsonSourceEnvelop} out
+ * @returns {number}
+ */
+function scanJsonArray(source, offset, out) {
+  out.src += "[";
+  offset = skipWhitespaces(source, offset + 1);
+  if (offset >= source.length) {
+    throwJsonSyntaxError("Unterminated JSON array", offset);
+  }
+  if (source[offset] === "]") {
+    out.src += "]";
+    return offset + 1;
+  }
+  while (offset < source.length) {
+    offset = scanJsonValue(source, offset, out);
+    offset = skipWhitespaces(source, offset);
+    if (offset >= source.length) {
+      break;
+    }
+    const ch = source[offset];
+    if (ch === ",") {
+      out.src += ",";
+      offset = skipWhitespaces(source, offset + 1);
+      continue;
+    }
+    if (ch === "]") {
+      out.src += "]";
+      return offset + 1;
+    }
+    throwJsonSyntaxError("Unexpected token in JSON array", offset);
+  }
+  throwJsonSyntaxError("Unterminated JSON array", offset);
+}
+/**
+ * @param {string} source
+ * @param {number} offset
+ * @returns {number}
+ */
+function skipOthers(source, offset) {
+  const sourceLen = source.length;
+  let next = offset;
+  while (next < sourceLen) {
+    const code = source.charCodeAt(next++);
+    if (
+      isWhitespaceCode(code) ||
+      code === ccMap.COMMA ||
+      code === ccMap.COLON ||
+      code === ccMap.LEFT_BRACKET ||
+      code === ccMap.RIGHT_BRACKET ||
+      code === ccMap.LEFT_BRACE ||
+      code === ccMap.RIGHT_BRACE ||
+      code === ccMap.DOUBLE_QUOTE
+    ) {
+      next -= 1;
+      break;
+    }
+  }
+  if (next === offset) throwJsonSyntaxError("Invalid JSON primitive", offset);
+  return next;
+}
+/**
+ * Scan a JSON double-quoted string and return the next offset.
+ *
+ * @param {string} source
+ * @param {number} offset
+ * @returns {number}
+ */
+function skipQuotedString(source, offset) {
+  const srcLen = source.length;
+  let next = offset + 1;
+  let inEscape = false;
+  while (next < srcLen) {
+    const ch = source[next++];
+    if (ch === "\\") {
+      inEscape = !inEscape;
+    } else if (inEscape) {
+      inEscape = false;
+    } else if (ch === "\"") {
+      return next;
+    }
+  }
+  throwJsonSyntaxError("Incomplete JSON string", offset);
+}
+/**
+ * @param {number} code
+ * @returns {boolean}
+ */
+const isWhitespaceCode = (code) => code === ccMap.SPACE || code === ccMap.TAB || code === ccMap.LF || code === ccMap.CR;
+/**
+ * @param {string} source
+ * @param {number} offset
+ * @returns {number}
+ */
+const skipWhitespaces = (source, offset) => {
+  const srcLen = source.length;
+  while (offset < srcLen) {
+    if (!isWhitespaceCode(source.charCodeAt(offset++))) {
+      offset -= 1;
+      break;
+    }
+  }
+  return offset;
+};
+/**
+ * @param {string} message
+ * @param {number} offset
+ * @returns {never}
+ * @throws {SyntaxError}
+ */
+const throwJsonSyntaxError = (message, offset) => {
+  throw new SyntaxError(`${message}, offset=${offset}`);
+};
 const HIGHWATERMARK_MIN = 128;
 /**
  * @param {unknown} n 
@@ -201,4 +427,5 @@ module.exports = {
   readJsonlArray,
   readJsonlMapByKey,
   fastGetIntFieldCheap,
+  jsonMinify,
 };

package/extras/progress-light.d.ts

@@ -0,0 +1,29 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2026 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file progress-light.d.ts
+ */
+export type ProgressFormatOptions = {
+    fmt: string;
+    payload?: Record<string, string>;
+};
+export type TProgressLight = {
+    updateOptions(newFrames?: string[], newOpt?: ProgressFormatOptions): void;
+    deadline(): void;
+    newLine(): void;
+    setFPS(fps: number): void;
+    renderSync(): void;
+    run(): void;
+    stop(): void;
+    isRunning(): boolean;
+};
+/**
+ * @param {number} [fps]
+ * @param {() => string} [messageEmitter]
+ */
+export function create(fps?: number, messageEmitter?: () => string): TProgressLight;

package/extras/progress-light.js

@@ -0,0 +1,207 @@
+/*!
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+  Copyright (C) 2026 jeffy-g <hirotom1107@gmail.com>
+  Released under the MIT license
+  https://opensource.org/licenses/mit-license.php
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+"use strict";
+/**
+ * [usage]
+ * > node -i
+ * let t = require("./extras/progress-light");
+ * let p = t.create();
+ * p.run();
+ * p.stop();
+ */
+const rl = require("readline");
+/**
+ * @typedef {{ fmt: string, payload?: Record<string, string> }} ProgressFormatOptions
+ */
+/**
+ * @typedef {{
+ *   updateOptions(newFrames?: string[], newOpt?: ProgressFormatOptions): void;
+ *   deadline(): void;
+ *   newLine(): void;
+ *   setFPS(fps: number): void;
+ *   renderSync(): void;
+ *   run(): void;
+ *   stop(): void;
+ *   isRunning(): boolean;
+ * }} TProgressLight
+ */
+/**
+ * @param {boolean} enabled
+ * @param {NodeJS.WriteStream} [output]
+ */
+const cursor = (enabled, output = process.stderr) => {
+  if (enabled) {
+    output.write("\x1B[?25h");
+  } else {
+    output.write("\x1B[?25l");
+  }
+};
+/**
+ * @param {string=} msg
+ * @param {number=} row
+ */
+const renderLine = (msg, row) => {
+  const output = process.stderr || process.stdout;
+  rl.cursorTo(output, 0, row);
+  msg && (output.write(msg), rl.clearLine(output, 1));
+};
+/**
+ * @param {string[]} frames
+ * @param {ProgressFormatOptions} [formatOpt]
+ */
+const createProgressSync = (frames, formatOpt) => {
+  const fsize = frames.length;
+  let index = 0;
+  /** @type {string | undefined} */
+  let fmt;
+  /** @type {Record<string, string>} */
+  let payload = {};
+  /** @type {string[]} */
+  let keys = [];
+  if (formatOpt) {
+    fmt = formatOpt.fmt;
+    payload = formatOpt.payload || {};
+    keys = Object.keys(payload);
+  }
+  /**
+   * @param {string} tick
+   * @param {string} msg
+   */
+  const formatter = (tick, msg) => {
+    if (fmt) {
+      let content = fmt;
+      for (let i = 0, end = keys.length; i < end; ) {
+        const key = keys[i++];
+        content = content.replace("{" + key + "}", payload[key]);
+      }
+      return content.replace("{tick}", tick).replace("{msg}", msg);
+    }
+    return `[${tick}]: ${msg}`;
+  };
+  return /** @type {(msg: string, done?: boolean) => void} */ ((msg, done = false) => {
+    const tick = done ? "-done-" : frames[index++ % fsize];
+    const line = msg ? formatter(tick, msg) : "";
+    renderLine(line);
+  });
+};
+/**
+ * @param {string[]} frames
+ * @param {ProgressFormatOptions} formatOpt
+ * @param {() => string} messageEmitter
+ * @returns {TProgressLight}
+ */
+const createProgressObject = (frames, formatOpt, messageEmitter) => {
+  let done = false;
+  const render = () => {
+    progress(messageEmitter(), done);
+  };
+  let progress = createProgressSync(frames, formatOpt);
+  /** @type {ReturnType<typeof setInterval> | undefined} */
+  let timer;
+  let ms = 33;
+  return {
+    updateOptions(newFrames, newOpt) {
+      if (Array.isArray(newFrames) && typeof newFrames[0] === "string") {
+        frames = newFrames;
+      }
+      if (typeof newOpt === "object" && newOpt && newOpt.fmt) {
+        formatOpt = newOpt;
+      }
+      done = false;
+      progress = createProgressSync(frames, formatOpt);
+    },
+    deadline() {
+      (done = true), render();
+    },
+    newLine() {
+      console.log();
+    },
+    setFPS(fps) {
+      ms = (1000 / fps) | 0;
+      if (timer) {
+        clearInterval(timer);
+        timer = setInterval(render, ms);
+      }
+    },
+    renderSync() {
+      progress(messageEmitter(), done);
+    },
+    run() {
+      cursor(false);
+      done = false;
+      if (timer) {
+        return;
+      }
+      timer = setInterval(render, ms);
+    },
+    stop() {
+      done = true;
+      clearInterval(timer);
+      timer = void 0;
+      cursor(true);
+    },
+    isRunning() {
+      return !!timer;
+    },
+  };
+};
+let fired = 0;
+let pending = 0;
+/** @type {() => { fired: number; pending: number; errors?: number; }} */
+const cb = () => {
+  return {
+    fired: ++fired,
+    pending: ++pending,
+  };
+};
+let tag = "progress test";
+/**
+ * progress callback
+ * @type {() => string}
+ */
+const pcb = () => {
+  if (cb) {
+    const { fired, pending, errors } = cb();
+    return `${tag} | error: ${(errors + "").padEnd(3)} | send: ${(fired + "").padStart(3)}, pending: ${(pending + "").padEnd(5)}`;
+  } else {
+    return "- - error - -";
+  }
+};
+/**
+ * @param {number} [fps]
+ * @param {() => string} [messageEmitter]
+ * @returns {TProgressLight}
+ */
+const create = (fps = 30, messageEmitter) => {
+  const frames = [
+    "⠋",
+    "⠙",
+    "⠹",
+    "⠸",
+    "⠼",
+    "⠴",
+    "⠦",
+    "⠧",
+    "⠇",
+    "⠏",
+  ];
+  !messageEmitter && (messageEmitter = pcb);
+  /** @type {TProgressLight} */
+  const progress = createProgressObject(
+    frames, {
+      fmt: "{tick} - {msg}",
+      payload: {},
+    },
+    messageEmitter,
+  );
+  progress.setFPS(fps);
+  return progress;
+};
+module.exports = {
+  create,
+};

package/lib/unzip.min.js

@@ -1,4 +1,6 @@
-/*! @license zlib.js 2012 - imaya [ https://github.com/imaya/zlib.js ] The MIT License */ /*! (C) 2022 jeffy-g https://github.com/jeffy-g Released under the MIT license https://opensource.org/licenses/mit-license.php */ (function () {
+/*! @license zlib.js 2012 - imaya [ https://github.com/imaya/zlib.js ] The MIT License */ /*! (C) 2022 jeffy-g https://github.com/jeffy-g Released under the MIT license https://opensource.org/licenses/mit-license.php */
+// @ts-nocheck
+(function () {
   var m,
     aa = this;
   Math.floor(2147483648 * Math.random()).toString(36);

package/lib/zip.min.js

@@ -1,5 +1,6 @@
 /*! @license zlib.js 2012 - imaya [ https://github.com/imaya/zlib.js ] The MIT License */
 /*! Copyright (C) 2018 jeffy-g <hirotom1107@gmail.com> Released under the MIT license https://opensource.org/licenses/mit-license.php */
+// @ts-nocheck
 (function () {
   "use strict";
   var n = void 0,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-dev-tool",
-  "version": "1.2.10",
+  "version": "1.2.11",
   "bin": {
     "jstool": "tools.js"
   },

package/progress/spinners.d.ts

@@ -64,7 +64,7 @@ type TSpinners = {
     grenade: Dots;
     point: Dots;
     layer: Dots;
-}
+};
 interface Dots {
     interval: number;
     frames: string[];

package/tool-lib/rws.js

@@ -151,9 +151,8 @@ module.exports = (fs, utils) => {
           msg = `${this.taskName}: webpack size record created: [%s]`;
         }
         if (needWrite) {
-          utils.writeText(
-            JSON.stringify(sizeRecord, null, 2),
-            recordPath,
+          utils.writeJson(
+            sizeRecord, recordPath,
             () => {
               console.log(msg, recordPath, entry);
             },

package/tsconfig.json

@@ -15,6 +15,9 @@
     "module": "nodenext",
     "outDir": "./dts",
     // "baseUrl": ".",
+    "types": [
+      "node"
+    ],
     "rootDir": ".",
     "paths": {
       "*": [
@@ -32,5 +35,7 @@
   ],
   "exclude": [
     "./**/npm-outdated*.js",
+    "./scripts/*.js",
+    "./lib/*.js",
   ]
 }