js-dev-tool 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 jeffy-g
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,150 @@
+# js-tool
+
+A collection of command-line tools to assist in JavaScript project development.
+
+This utility, `jstool`, provides various functions for file manipulation, versioning, and building.
+
+## Usage
+
+The primary way to use these tools is through the `jstool` command, which is an alias for `node tools.js`.
+
+```bash
+# General syntax
+node tools.js -cmd <command_name> [options]
+
+# Or if installed globally or via package.json scripts
+jstool -cmd <command_name> [options]
+```
+
+To see the help for a specific command:
+```bash
+node tools.js -help <command_name>
+```
+
+## Commands
+
+Here is a list of available commands registered in `ToolFunctions`:
+
+```bash
+zip help: jstool -cmd zip [-comment "the comment"] lib/webpack.js lib/type-ids.js
+rws help: (R)ecord(W)ebpack(S)ize
+  ex - jstool -cmd rws [-webpack lib/webpack.js -umd umd/webpack.js -dest "./dev-extras/webpack-size.json"] [-rws-tags "web/login:./dist/es/web/login.mjs,webpack-esm:./dist/webpack-esm/index.mjs"]
+  note:
+    webpack  - if not specified then apply "./dist/webpack/index.js"
+    umd      - if not specified then apply "./dist/umd/index.js"
+    bin      - if not specified then apply "./dist/bin/index.js"
+    rws-tags - It is treated as parameter array separated by ":", e.g - "web/login:./dist/es/web/login.mjs,webpack-esm:./dist/webpack-esm/index.mjs"
+    dest     - if not specified then apply "./logs/webpack-size.json"
+
+cjbm help: (C)onvert (J)S to (B)rowser (M)odule
+  ex - jstool -cmd cjbm [-root ./build | -basePath "./dist/esm,extra-tests/mini-semaphore"] [-ext js] [-targets "['core.js', 'object.js']"]
+  note:
+    root     - Recursively searches for files.
+               This option is useful, but if there are directories that need to be avoided, use the 'basePath' option
+    basePath - can be "<path>,<path>,..." (array type arg)
+    ext      - specifies the module extension for import clauses. default is "js"
+    targets  - specify this if you want to apply it only to a specific file.
+               the file specified here should be directly under `basePath`!
+               value must be array type arg, "['<path>', '<path>',...]" or "<path>,<path>,..."
+
+cmtTrick help: Do comment trick toggle
+  It recognizes three markers: `ctt | comment-toggle-trick | https://coderwall`
+  jstool -cmd cmtTrick[:clean] (-base <source dir> | -bases "<source dir>,<source dir>,...") [-test re/\\.js$/]
+  note:
+    :clean - remove comment token etc leaving the currently enabled code
+    base (or root) - scan single source folder
+    bases          - must be array type arg, "['<path>', '<path>',...]" or "<path>,<path>,..."
+    test           - terget extension, default is /\\.js$/
+
+stripWebpack help: jstool -cmd stripWebpack -regex "%npm_package_defs_regex%"
+stripSome help: jstool -cmd stripSome [-after <replacement>] -regex "/^\s+<!--[\s\S]+?-->(?:\r?\n)?/gm" [-targets "<path>,<path>,..." | <args: file, file file...>]
+  note:
+    targets - must be array type arg, "['<path>', '<path>',...]" or "<path>,<path>,..."
+    note: targets - can use args parameter instead
+       It is better to use the <args: file, file file...>
+       e.g - jstool -cmd stripSome -after ".." -regex "re/(?<=reference path=")(\.)(?=\/index.d.ts")/" build/**/*.js
+                                                                                                         ^^^^^^^^^^^^^
+
+version help: jstool -cmd version [-major | -minor] [-pkgJsons "./package.json,../package.json"] [-extras "test/web/index.html"]
+  bump top level package.json version(can specify "package.json" paths by `pkgJsons` option if need), specify patch version is unnecessary.
+  note:
+    extras - can be "<path>,<path>,..." (array type arg)
+
+minify help: jstool -cmd minify -basePath extra-tests/web/mini-semaphore [-test "re/\.js$/"] [-suffix ".mini"]
+  note:
+    basePath - can be "<path>,<path>,..." (array type arg)
+    test     - can be omit, default is `/\.js$/`
+    suffix   - can be omit, default is ".mini"
+
+rmc help: $ jstool -cmd rmc -basePath "./dist/cjs,./dist/cjs/gulp" -test "/\.(js|d\.ts)$/"
+  note: basePath - can be "<path>,<path>,..." (array type arg)
+    test     - can be omit, defulat `/.js$/`
+    rmc4ts   - for typescript source.
+      keep comment that start with "/*" when "*/" end mark appears in same line.
+      if start with "/*-" remove it
+```
+
+---
+
+### `zip`
+Creates a zip archive of specified files.
+*   **Usage:** `jstool -cmd zip [-comment "the comment"] file1.js file2.js ...`
+
+---
+
+### `rws`
+Records the size of webpack bundles or other files. The name stands for (r)ecord(W)ebpack(S)ize.
+*   **Usage:** `jstool -cmd rws -webpack lib/webpack.js -dest "./dev-extras/webpack-size.json"`
+
+---
+
+### `cjbm`
+Converts JavaScript files to browser-compatible modules. The name stands for (C)onvert (J)S to (B)rowser (M)odule.
+*   **Usage:** `jstool -cmd cjbm -basePath <source_dir> -targets "['file1.js', 'file2.js']"`
+
+---
+
+### `cmtTrick`
+Toggles "comment tricks" in the code, useful for conditional code execution during development.
+*   **Usage:** `jstool -cmd cmtTrick -basePath <source_dir> -targets "['file1.js', 'file2.js']"`
+
+---
+
+### `stripSome`
+Performs generic string replacement on a set of target files using a regular expression.
+*   **Usage:** `jstool -cmd stripSome [-after <replacement>] -regex "<regex>" [-targets "<path1>,<path2>" | <file1> <file2> ...]`
+*   **Note:** It's often better to pass target files as direct arguments instead of using the `-targets` option.
+
+---
+
+### `version`
+Bumps the version number in `package.json` and optionally in other files.
+*   **Usage:** `jstool -cmd version [-major | -minor] [-pkgJsons "./package.json,../other/package.json"] [-extras "file.html"]`
+*   **Note:** Bumps the patch version by default. Use `-major` or `-minor` to bump those instead.
+
+---
+
+### `minify`
+Minifies JavaScript files using Terser.
+*   **Usage:** `jstool -cmd minify -basePath <source_dir> [-test "<regex>"] [-suffix ".min"]`
+*   **Note:** `basePath` can be a comma-separated list. The default suffix is `.mini`.
+
+---
+
+### `rmc`
+Removes C-style comments from files.
+*   **Usage:** `jstool -cmd rmc -basePath "./dist/cjs,./dist/other" -test "/\\.(js|d\\.ts)$/"`
+*   **Note:** Use the `-rmc4ts` flag for special handling of TypeScript comments (e.g., `/// <reference>`).
+
+---
+
+### `stripWebpack` (deprecated)
+Strips webpack-specific boilerplate from bundled files.
+*   **Usage:** `jstool -cmd stripWebpack -regex "%npm_package_defs_regex%"`
+
+
+## 📜 License
+
+Released under the MIT License.  
+See [LICENSE](./LICENSE) for details.
+

package/basic-types.d.ts

@@ -0,0 +1,279 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2018 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @file basic-types/index.d.ts
+ */
+
+// --------------------- define primative types.
+/**
+ * #### To Be Defined
+ *
+ *   + can be `undefined`.
+ *   + 7 character shorten
+ */
+type TBD<T> = T | undefined;
+/**
+ * #### To Be Completed
+ *
+ *   + can be `null`.
+ *   + 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
+ * 
+ * ```ts
+ * type ConditionalX<T, A, B> = T extends (void | false | undefined) ? A : B // <- maybe not works
+ * 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;
+ * }
+ * // string | string[]
+ * const xret = x();
+ * // string[]
+ * const xret2 = x(true);
+ * 
+ * function ok<T extends true | void, R extends Conditional<T, string, string[]>>(need?: T): R {
+ *     return (need? "": [""]) as R;
+ * }
+ * // string
+ * const okret = ok();
+ * // string[]
+ * const okret2 = ok(true);
+ * ```
+ * 
+ * @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];
+};
+
+// 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.
+ *
+ * shorthand of:
+ * ```ts
+ * const someValue: Pick<T, keyof T>;
+ * ```
+ *
+ * NOTE: cannot listed `protected` and `private` modifier
+ *
+ * @see Partial
+ * @see Required
+ * @see ReadOnly
+ */
+type InterfaceType<T> = {
+    [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`
+ */
+type RequireThese<T, K extends keyof T> = T & Required<Pick<T, K>>;
+/**
+ * pick any `property` as excludes
+ */
+type ExcludePick<T, K extends keyof T> = Exclude<Pick<T, K>, T>;
+/**
+ * pick any `property` as required
+ */
+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];
+};
+
+/**
+ *
+ * @date 2019/8/19
+ * @see Parameters
+ */
+type RequiredParameters<TFunction extends (...args: any) => any> = Required<
+    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;
+
+/**
+ * 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;
+
+/**
+ * usage:
+ * ```
+ * async function some(): Promise<string> {
+ *   return "OK";
+ * };
+ * type RT = UnpackReturnType<typeof some>;
+ *
+ * ```
+ */
+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;
+};
+
+type UndefableStringMap<T> = TBD<Record<string, T>>;
+
+/**
+ * for lazy assign class.
+ */
+type TypedCtor<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"
+}
+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;
+}
+// /**
+//  * @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
+ * @template Pre - The prefix string (used internally)
+ */
+type Combination<
+  S extends string, Pre extends string = "",
+> = S extends `${infer First}${infer Post}` ?
+    `${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}`> : "";
+

package/common/index.d.ts

@@ -0,0 +1,43 @@
+/*!
+  The MIT License (MIT)
+
+  Copyright (c) 2022 jeffy-g hirotom1107@gmail.com
+
+  Permission is hereby granted, free of charge, to any person obtaining a copy
+  of this software and associated documentation files (the "Software"), to deal
+  in the Software without restriction, including without limitation the rights
+  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+  copies of the Software, and to permit persons to whom the Software is
+  furnished to do so, subject to the following conditions:
+
+  The above copyright notice and this permission notice shall be included in
+  all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+  THE SOFTWARE.
+*/
+/**
+ * @param {string} dest
+ */
+export function checkParentDirectory(dest: string): void;
+/**
+ * @param {string} logPath
+ */
+export function createLogStreamAndResolvePath(logPath: string): any;
+/**
+ * use process.stderr stream
+ *
+ * @param {string} [msg] if empty string or undefined then only clear line and move cursor to head.
+ */
+export function renderLine(msg?: string): void;
+/**
+ *
+ * @param {boolean} enabled
+ * @param {NodeJS.WriteStream} [output]
+ */
+export function cursor(enabled: boolean, output?: NodeJS.WriteStream): void;

package/common/index.js

@@ -0,0 +1,101 @@
+/*!
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+//  Copyright (C) 2022 jeffy-g <hirotom1107@gmail.com>
+//  Released under the MIT license
+//  https://opensource.org/licenses/mit-license.php
+// - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/**
+ * @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 });
+  }
+}
+/**
+ * @param {string} logPath
+ */
+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
+ * @param {NodeJS.WriteStream} [output]
+ */
+const cursor = (enabled, output = process.stderr) => {
+  if (enabled) {
+    output.write("\x1B[?25h");
+  } else {
+    output.write("\x1B[?25l");
+  }
+};
+
+module.exports = {
+  checkParentDirectory,
+  createLogStreamAndResolvePath,
+  renderLine,
+  cursor,
+};

package/extras/tiny-progress.d.ts

@@ -0,0 +1,14 @@
+/*!
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+  Copyright (C) 2023 jeffy-g <hirotom1107@gmail.com>
+  Released under the MIT license
+  https://opensource.org/licenses/mit-license.php
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+import * as progress from "../progress/";
+/**
+ * @param {number} [fps]
+ * @param {() => string} [messageEmiter]
+ */
+export function create(fps?: number, messageEmiter?: () => string): ReturnType<typeof progress.createProgressObject>;
+export type Progress = ReturnType<typeof progress.createProgressObject>;

package/extras/tiny-progress.js

@@ -0,0 +1,74 @@
+/*!
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+  Copyright (C) 2022 jeffy-g <hirotom1107@gmail.com>
+  Released under the MIT license
+  https://opensource.org/licenses/mit-license.php
+ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+*/
+/** [usage]
+> node -i
+let t = require("./extras/progress-sample");
+let p = t.create();
+p.run();
+p.stop();
+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 {
+    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 {
+    // 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,
+    {
+      fmt: "{tick} - {frameName} - {msg}",
+      payload: { frameName: spinner.name },
+    },
+    messageEmiter,
+  );
+  progress.setFPS(fps);
+  return progress;
+};
+
+module.exports = {
+  create,
+};