js-dev-tool 1.0.0 → 1.0.3

package/basic-types.d.ts

@@ -8,8 +8,6 @@
 /**
  * @file basic-types/index.d.ts
  */
-
-// --------------------- define primative types.
 /**
  * #### To Be Defined
  *
@@ -24,10 +22,7 @@ type TBD<T> = T | undefined;
  *   + 2 character shorten
  */
 type TBC<T> = T | null;
-
-// needed?
 type DecideType<T> = T extends infer P? P : T;
-
 /**
  * T is falsy then return A, trusy then B
  * 
@@ -36,7 +31,7 @@ type DecideType<T> = T extends infer P? P : T;
  * type Conditional<T, A, B> = void extends T ? A : T extends (void | false | undefined) ? A : B;
  * 
  * function x<T extends true | void, R extends ConditionalX<T, string, string[]>>(need?: T): R {
- *     return (need? "": [""]) as R;
+ *   return (need? "": [""]) as R;
  * }
  * // string | string[]
  * const xret = x();
@@ -44,7 +39,7 @@ type DecideType<T> = T extends infer P? P : T;
  * const xret2 = x(true);
  * 
  * function ok<T extends true | void, R extends Conditional<T, string, string[]>>(need?: T): R {
- *     return (need? "": [""]) as R;
+ *   return (need? "": [""]) as R;
  * }
  * // string
  * const okret = ok();
@@ -55,30 +50,14 @@ type DecideType<T> = T extends infer P? P : T;
  * @date 20/03/31
  */
 type Conditional<T, A, B> = void extends T ? A : T extends (void | false | undefined) ? A : B;
-// or
-// /**
-//  * @deprecated often not working properly (maybe)
-//  */
-// type Conditional<T, A, B> = undefined extends T ? B : false extends T ? B : A;
-
 type BasicIterator<T> = Iterator<T, T, T>;
-
 /**
  * Remove readonly
  */
 type Writable<T> = {
-    -readonly [P in keyof T]: T[P];
+  -readonly [P in keyof T]: T[P];
 };
-
-// 2020/3/12 20:36:52
 type JsonValueTypes = string | number | boolean | object | Array<number | string | boolean | object>;
-
-// /**
-//  * get property type.
-//  */
-// type TypeOf<T, K extends keyof T> = T[K];
-// // -> same as like SkillPlanDataType["plans"]
-
 /**
  * pickup public fields and methods from `typescript` class.
  *
@@ -94,14 +73,9 @@ type JsonValueTypes = string | number | boolean | object | Array<number | string
  * @see ReadOnly
  */
 type InterfaceType<T> = {
-    [P in keyof T]: T[P];
+  [P in keyof T]: T[P];
 };
-// or
-// type InterfaceType<T> = Pick<T, keyof T>;
-
 type TStdFunction<R = any> = (...args: any[]) => R;
-
-
 /**
  * mark a specific property as `required`
  */
@@ -118,60 +92,40 @@ type RequiredPick<T, K extends keyof T> = Required<Pick<T, K>>;
  * pick any `property` as partial
  */
 type PartialPick<T, K extends keyof T> = Partial<Pick<T, K>>;
-
-// // The opposite of Pick. Return type without specified property
 /**
  * NOTE: can use ts builtin `Omit` instead
  */
 type Flip<T, K extends keyof T> = {
-    [P in Exclude<keyof T, K>]: T[P];
+  [P in Exclude<keyof T, K>]: T[P];
 };
-
 /**
  *
  * @date 2019/8/19
  * @see Parameters
  */
 type RequiredParameters<TFunction extends (...args: any) => any> = Required<
-    Parameters<TFunction>
+  Parameters<TFunction>
 >;
-// /**
-//  * Extracts the type of the 'this' parameter of a function type, or 'unknown' if the function type has no 'this' parameter.
-//  */
-// type ThisParameterType<T> = T extends (this: unknown, ...args: any[]) => any ? unknown : T extends (this: infer U, ...args: any[]) => any ? U : unknown;
-// /**
-//  * Removes the 'this' parameter from a function type.
-//  */
-// type OmitThisParameter<T> = unknown extends ThisParameterType<T> ? T : T extends (...args: infer A) => infer R ? (...args: A) => R : T;
-
 type PickProperties<P, T> = { [K in keyof T]-?: T[K] extends P ? K : never }[keyof T];
 type PickNumberProperties<T> = PickProperties<number, T>;
 type PickStringProperties<T> = PickProperties<string, T>;
-
 type NonFunctionPropertyNames<T> = { [K in keyof T]-?: T[K] extends Function ? never : K }[keyof T];
 type NonFunctionProperties<T> = Pick<T, NonFunctionPropertyNames<T>>;
-
 /**
  * extract () => number | string functoin names from T
  */
 type NorSFunctions<T> = { [K in keyof T]: T[K] extends (() => number | string) ? K : never }[keyof T];
-// type FunctionPropertyNames<T> = { [K in keyof T]: T[K] extends Function ? K : never }[keyof T];
-// type FunctionProperties<T> = Pick<T, FunctionPropertyNames<T>>;
-// type OKKK<T> = Exclude<FunctionProperties<T>, never>;
 type Unpacked<T> =
-    T extends Array<infer U> ? U :
-    T extends (...args: any[]) => infer U ? U :
-    T extends Promise<infer U> ? U :
-    T;
-
+  T extends Array<infer U> ? U :
+  T extends (...args: any[]) => infer U ? U :
+  T extends Promise<infer U> ? U :
+  T;
 /**
  * cannot apply to parameter required function. (?)
  */
 type SimpleUnpack<T> = T extends (...args: any[]) => infer U ? U :
-    T extends Promise<infer U> ? U :
-    // T extends null ? null:
-    T;
-
+  T extends Promise<infer U> ? U :
+  T;
 /**
  * usage:
  * ```
@@ -183,78 +137,55 @@ type SimpleUnpack<T> = T extends (...args: any[]) => infer U ? U :
  * ```
  */
 type UnpackReturnType<T extends (...args: any[]) => any> = Unpacked<ReturnType<T>>;
-// type XUnpackReturnType<T> = T extends (...args: any[]) => any? Unpacked<ReturnType<T>>: T;
-
-// // ERROR: TS2345
-// type AvoidTS2345<T, K extends keyof T> = T[K];
-// // OK, but... . .  .    .
-// type AvoidTS2345<T, K extends keyof T> = K extends infer X? T[K]: any;
-
-// 1/30/2019, 4:14:25 PM
 /**
  * http query parameter types. (maybe not enough.
  */
 type QueryValueTypes = string | number | boolean | Date;
-
 /**
  * means can convert to Date object.
  */
 type DateString = string;
-
 /**
  * document.querySelector etc
  */
 type TQuerySelector = string;
-
-// --------------------- define unique types.
 type NumberMap<T> = {
-    [index: number]: T;
+  [index: number]: T;
 };
-
 type UndefableStringMap<T> = TBD<Record<string, T>>;
-
 /**
  * for lazy assign class.
  */
 type TypedCtor<T> = {
-    new (...args: any[]): T;
-    prototype: T;
+  new (...args: any[]): T;
+  prototype: T;
 };
-// DEVNOTE: 2022/02/15 its a same declare, so marged
 interface ITypedCtor<T> extends TypedCtor<T> {}
-
 /**
  * Array.sort etc...
  */
 declare type TComparator<T> = (a: T, b: T) => number;
-
 declare const enum ETypeOf {
-    VBigInt = "bigint",
-    VBool = "boolean",
-    VFn = "function",
-    VNum = "number",
-    VO = "object",
-    VS = "string",
-    VSym = "symbol",
-    VUndef = "undefined"
+  VBigInt = "bigint",
+  VBool = "boolean",
+  VFn = "function",
+  VNum = "number",
+  VO = "object",
+  VS = "string",
+  VSym = "symbol",
+  VUndef = "undefined"
 }
 declare namespace ETypeOf {
-    export type Values = "bigint" | "boolean" | "function" | "number" | "object" | "string" | "symbol" | "undefined";
-    export type Bi = bigint;
-    export type B = boolean;
-    export type F = Function;
-    export type N = number;
-    export type O = object;
-    export type S = string;
-    export type Sym = symbol;
-    export type U = undefined;
+  export type Values = "bigint" | "boolean" | "function" | "number" | "object" | "string" | "symbol" | "undefined";
+  export type Bi = bigint;
+  export type B = boolean;
+  export type F = Function;
+  export type N = number;
+  export type O = object;
+  export type S = string;
+  export type Sym = symbol;
+  export type U = undefined;
 }
-// /**
-//  * @param {ETypeOf.S} v
-//  */
-//  function isOK(v: ETypeOf.S): v is ETypeOf.S
-//  let x: bigint;
-
 /**
  * Generates all combinations of the string S. The order of characters does not matter.
  * @template S - The target string type
@@ -263,17 +194,15 @@ declare namespace ETypeOf {
 type Combination<
   S extends string, Pre extends string = "",
 > = S extends `${infer First}${infer Post}` ?
-    `${First}${Combination<`${Pre}${Post}`>}` | Combination<Post, `${Pre}${First}`> : "";
-
+  `${First}${Combination<`${Pre}${Post}`>}` | Combination<Post, `${Pre}${First}`> : "";
 /**
  * Generates all fixed combinations of the string S. The order of characters is preserved.
  * @template S - The target string type
  * @template Pre - The prefix string (used internally)
  */
-// DEVNOTE: 2025/01/27 - これは文字の順序が限定される
 type FixedCombination<
   S extends string,
   Pre extends string = ""
-> = S extends `${infer First}${infer Post}` ?
-    `${Pre}${First}${FixedCombination<Post, "">}` | FixedCombination<Post, `${Pre}${First}`> : "";
-
+> = S extends `${infer First}${infer Post}`
+  ? `${Pre}${First}${FixedCombination<Post, "">}` | FixedCombination<Post, `${Pre}${First}`>
+  : "";

package/common/index.d.ts

@@ -40,4 +40,4 @@ export function renderLine(msg?: string): 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;

package/common/index.js

@@ -9,21 +9,15 @@
  * @file js-dev-scripts/common/index.js
  */
 // @ts-check
-
-// NOTE: fs-extra are bit slower.
 const fs = require("fs");
-// const util = require('util');
 const path = require("path");
-// for clearLine...
 const rl = require("readline");
-
 /**
  * @param {string} dest
  */
 function checkParentDirectory(dest) {
   const parent = path.dirname(dest);
   if (!fs.existsSync(parent)) {
-    // DEVNOTE: fix Error: ENOENT: no such file or directory, mkdir ./path/to/dir
     fs.mkdirSync(parent, { recursive: true });
   }
 }
@@ -34,52 +28,19 @@ function createLogStreamAndResolvePath(logPath) {
   checkParentDirectory(logPath);
   return fs.createWriteStream(logPath);
 }
-
 /**
  * use process.stderr stream
  *
  * @param {string} [msg] if empty string or undefined then only clear line and move cursor to head.
  */
-// CHANGES: 2020/2/18 18:28:17 - fix ちらつき
-// dir <number>
-//   -1: to the left from cursor
-//    1: to the right from cursor
-//    0: the entire line
-//
-// function renderLine(msg) {
-//     const output = process.stderr;
-//     // move cursor to line head
-//     // @ts-ignore
-//     rl.cursorTo(output, 0);
-//     // write the message.
-//     msg && output.write(msg);
-//     // clear line to the right from cursor
-//     // @ts-ignore
-//     rl.clearLine(output, 0);
-// }
-
-// FIX: 2025/5/13 output.clearLine is not a function
 function renderLine(msg /*, del = "\x1B[?25l"*/) {
   const output = process.stderr || process.stdout;
-  // output.write(del); // clear cursol
-  // clear line to the right from cursor
   // @ts-ignore
   rl.clearLine(output, 0);
-  // output.clearLine(0);
-
-  // move cursor to line head
   // @ts-ignore
   rl.cursorTo(output, 0);
-  // output.cursorTo(0);
-
   msg && output.write(msg);
-  // // write the message.
-  // // msg && output.write(msg);
-  // output.write(`${spin_char[spin_count]} ${msg}`);
-  // spin_count++;
-  // spin_count >= spin_char.length && (spin_count = 0);
 }
-
 /**
  *
  * @param {boolean} enabled
@@ -92,10 +53,9 @@ const cursor = (enabled, output = process.stderr) => {
     output.write("\x1B[?25l");
   }
 };
-
 module.exports = {
   checkParentDirectory,
   createLogStreamAndResolvePath,
   renderLine,
   cursor,
-};
+};

package/extras/tiny-progress.d.ts

@@ -11,4 +11,4 @@ import * as progress from "../progress/";
  * @param {() => string} [messageEmiter]
  */
 export function create(fps?: number, messageEmiter?: () => string): ReturnType<typeof progress.createProgressObject>;
-export type Progress = ReturnType<typeof progress.createProgressObject>;
+export type Progress = ReturnType<typeof progress.createProgressObject>;

package/extras/tiny-progress.js

@@ -15,13 +15,10 @@ p = t.create();
 p.run();
 p.stop();
 */
-
 const p = require("../progress/");
 const rndSpinners = require("../progress/rnd-spinner");
-
 let fired = 0;
 let pending = 0;
-
 /** @type {() => { fired: number; pending: number; errors?: number; }} */
 const cb = () => {
   return {
@@ -29,9 +26,7 @@ const cb = () => {
     pending: ++pending,
   };
 };
-
 let tag = "progress test";
-
 /**
  * progress callback
  * @type {() => string}
@@ -41,21 +36,17 @@ const pcb = () => {
     const { fired, pending, errors } = cb();
     return `${tag} | error: ${(errors + "").padEnd(3)} | send: ${(fired + "").padStart(3)}, pending: ${(pending + "").padEnd(5)}`;
   } else {
-    // error
     return "- - error - -";
   }
 };
-
 /** @type {ReturnType<typeof p.createProgressObject>} */
 let progress;
-
 /**
  * @param {number} [fps]
  * @param {() => string} [messageEmiter]
  */
 const create = (fps = 30, messageEmiter) => {
   const spinner = rndSpinners.getRandomFrame();
-  // const pong = rndSpinners.pong;
   !messageEmiter && (messageEmiter = pcb);
   progress = p.createProgressObject(
     spinner.frames,
@@ -68,7 +59,6 @@ const create = (fps = 30, messageEmiter) => {
   progress.setFPS(fps);
   return progress;
 };
-
 module.exports = {
   create,
-};
+};

package/index.d.ts

@@ -17,11 +17,6 @@
   along with this program.  If not, see <https://www.gnu.org/licenses/>.
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 */
-
 export * as progress from "./progress";
 export * as common from "./common";
-export * as utils from "./utils";
-// declare namespace progress {
-//     export * as spinners from "./progress/spinners.json";
-// }
-
+export * as utils from "./utils";

package/index.js

@@ -12,4 +12,4 @@ module.exports = {
   progress,
   common,
   utils,
-};
+};

package/lib/unzip.min.js

@@ -322,7 +322,6 @@
             0 < F[c] && (h += N(a, F[c])),
             e >= f && ((a.g = e), (d = P(a)), (e = a.g));
           k--;
-
         )
           d[e] = d[e++ - h];
     for (; 8 <= a.j; ) (a.j -= 8), a.i--;
@@ -344,7 +343,6 @@
             0 < F[c] && (h += N(a, F[c])),
             e + k > f && ((d = ra(a)), (f = d.length));
           k--;
-
         )
           d[e] = d[e++ - h];
     for (; 8 <= a.j; ) (a.j -= 8), a.i--;
@@ -809,4 +807,4 @@
   n("Zlib.Unzip.prototype.getCommentAsString", X.prototype.J);
   n("Zlib.Unzip.FileHeader.prototype.getComment", Y.prototype.s);
   n("Zlib.Unzip.FileHeader.prototype.getCommentAsString", Y.prototype.m);
-}).call(this);
+}).call(this);

package/lib/zip.min.js

@@ -261,7 +261,6 @@
             for (
               m = new Uint8Array(this.c.buffer);
               m.length <= h + f.length + 5;
-
             )
               m = new Uint8Array(m.length << 1);
             m.set(this.c);
@@ -1033,4 +1032,4 @@
   G("Zlib.Zip.prototype.setPassword", $.prototype.q);
   Ra("Zlib.Zip.CompressionMethod", { STORE: 0, DEFLATE: 8 });
   Ra("Zlib.Zip.OperatingSystem", { MSDOS: 0, UNIX: 3, MACINTOSH: 7 });
-}).call(this);
+}).call(this);

package/lib/zlibjs.d.ts

@@ -31,4 +31,4 @@ declare namespace Zlib {
 }
 interface Window {
     Zlib: typeof Zlib;
-}
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "js-dev-tool",
-  "version": "1.0.0",
+  "version": "1.0.3",
   "bin": {
     "jstool": "./tools.js"
   },
@@ -46,6 +46,6 @@
     "replace": "^1.2.2",
     "rm-cstyle-cmts": "^3.3.22",
     "terser": "^5.44.1",
-    "tin-args": "^0.0.15"
+    "tin-args": "^0.0.16"
   }
 }

package/progress/index.d.ts

@@ -28,7 +28,6 @@ export function createProgressSync(frames: string[], formatOpt?: {
     fmt: string;
     payload?: Record<string, string>;
 }): (msg: string, done?: boolean) => void;
-
 /**
  *
  * @param {string[]} frames progress frame.
@@ -73,7 +72,6 @@ export function createProgressObject(frames: string[], formatOpt: TProgressForma
      */
     stop(): void;
 };
-
 declare global {
     type TWebpackProgressHandler = (percentage: number, message: string, ...args: string[]) => void;
 }
@@ -89,4 +87,4 @@ export function createWebpackProgressPluginHandler(logFilePath?: string, disable
  *
  * @param {string} logFilePath log output path name.
  */
-export function createBrowserifyFileEventLogger(logFilePath: string): (counter: number, message: string, ...args: string[]) => void;
+export function createBrowserifyFileEventLogger(logFilePath: string): (counter: number, message: string, ...args: string[]) => void;

package/progress/index.js

@@ -5,6 +5,7 @@
   https://opensource.org/licenses/mit-license.php
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 */
+/// <reference path="./index.d.ts" preserve="true"/>
 const lib = require("../common");
 const {
   checkENV,
@@ -12,7 +13,6 @@ const {
   wppHandlerV4,
   isWebpackV5later,
 } = require("./progress-extras");
-
 /**
  *
  * @param {string[]} frames progress frame.
@@ -32,7 +32,6 @@ const createProgressSync = (frames, formatOpt) => {
   let keys;
   if (formatOpt) {
     fmt = formatOpt.fmt;
-    // FIXME: 2023/10/27 - which use payload?
     payload = formatOpt.payload || {};
     keys = Object.keys(payload);
   }
@@ -51,7 +50,6 @@ const createProgressSync = (frames, formatOpt) => {
     }
     return `[${tick}]: ${msg}`;
   };
-  // let prev = "";
   return /**@type {(msg: string, done?: boolean) => void}*/ (
     msg,
     done = false,
@@ -59,19 +57,8 @@ const createProgressSync = (frames, formatOpt) => {
     const tick = done ? "-done-" : frames[index++ % fsize];
     const line = msg ? formater(tick, msg) : "";
     lib.renderLine(line);
-    // if (line) {
-    //     // if (prev !== line) {
-    //     //     renderLine(line);
-    //     //     prev = line;
-    //     // }
-    //     lib.renderLine(line);
-    // } else {
-    //     lib.renderLine();
-    // }
-    // // !line && (renderLine(), 1) || renderLine(line);
   };
 };
-
 /**
  * @typedef {{ fmt: string, payload?: Record<string, string> }} TProgressFormatOptions
  */
@@ -87,17 +74,12 @@ const createProgressSync = (frames, formatOpt) => {
 const createProgressObject = (frames, formatOpt, callback) => {
   let done = false;
   const render = () => {
-    // DEVNOTE: 2025/01/24 - やはりこれがいいね...
     process.nextTick(progress, callback(), done);
-    // progress(callback(), done);
   };
-
   let progress = createProgressSync(frames, formatOpt);
   /** @type {ReturnType<typeof setInterval> | undefined} */
   let timer;
   let ms = 33;
-
-  // progressObject
   return {
     /**
      * @param {string[]} [newFrames]
@@ -167,7 +149,6 @@ const createProgressObject = (frames, formatOpt, callback) => {
     },
   };
 };
-
 /**
  * create async progress
  *
@@ -175,13 +156,7 @@ const createProgressObject = (frames, formatOpt, callback) => {
  * @param {string[]} frames progress frame.
  */
 const createProgress = (timeSpanMS, frames) => {
-  // let index = 0;
-  // return /**@type {(text: string) => void}*/ text => {
-  //     const line = text === void 0? "" : `[${frames[index++ % frames.length]}]: ${text}`;
-  //     !line && (progress(), 1) || process.nextTick(progress, line);
-  // }
   const { performance } = require("perf_hooks");
-
   let index = 0;
   const fsize = frames.length;
   let x = performance.now();
@@ -195,7 +170,6 @@ const createProgress = (timeSpanMS, frames) => {
     (!line && (lib.renderLine(), 1)) || process.nextTick(lib.renderLine, line);
   };
 };
-
 /**
  * see https://webpack.js.org/plugins/progress-plugin/
  *
@@ -211,11 +185,9 @@ function createWebpackProgressPluginHandler(
   const formatPercentage = (/** @type {number} */ pct) => {
     return `processing ${(pct * 100).toFixed(4)}%`;
   };
-
   let dotted = 0;
   const renderDot = () => {
     process.stderr.write(".");
-    // FIXME: first renderDot line length is not 100
     dotted++;
     if (dotted % 100 === 0) {
       process.stderr.write("\n");
@@ -223,8 +195,6 @@ function createWebpackProgressPluginHandler(
   };
   /** @type {((msg?: string) => void) | undefined} */
   const renderer = process.env.CI ? renderDot : lib.renderLine;
-
-  // (percentage: number, msg: string, moduleProgress?: string, activeModules?: string, moduleName?: string) => void
   /** @type {TWebpackProgressHandler} */
   let wppHandler;
   {
@@ -236,7 +206,6 @@ function createWebpackProgressPluginHandler(
       const wppLogger = lib.createLogStreamAndResolvePath(logFilePath);
       /** @type {((p: number) => void) | undefined} */
       let writeCallback;
-
       if (!disableRenderLine) {
         writeCallback = shorttenProgress;
       }
@@ -251,7 +220,6 @@ function createWebpackProgressPluginHandler(
       };
     } else {
       if (disableRenderLine) {
-        // DEVNOTE: 2022/02/16 ignore CI process
         wppHandler = () => {};
       } else {
         const processType = checkENV();
@@ -267,10 +235,8 @@ function createWebpackProgressPluginHandler(
       }
     }
   }
-
   return wppHandler;
 }
-
 /**
  * logger for browserify
  *
@@ -294,12 +260,10 @@ function createBrowserifyFileEventLogger(logFilePath) {
   };
   return logger;
 }
-
 module.exports = {
   createProgress,
   createProgressSync,
   createProgressObject,
-
   createWebpackProgressPluginHandler,
   createBrowserifyFileEventLogger,
-};
+};