xshell 0.0.9 → 0.0.13

package/process.d.ts

@@ -3,13 +3,14 @@ import type { ChildProcess } from 'child_process';
 import './prototype';
 import { Encoding } from './file';
 import { inspect } from './utils';
-export declare const EXE_NODE: string;
+export declare const fp_root: string;
+export declare const exe_node: string;
 interface StartOptions {
-    /** `'D:/'` */
+    /** `'d:/'` */
     cwd?: string;
     /** `process.env` overwrite/add to process.env */
     env?: Record<string, string>;
-    /** `'UTF-8'` child output encoding */
+    /** `'utf-8'` child output encoding */
     encoding?: Encoding;
     /** `true` print option (with details) */
     print?: boolean | {
@@ -25,12 +26,12 @@ interface StartOptions {
     detached?: boolean;
 }
 /** start process
-    - exe: .exe path or filename (full path is recommanded to skip PATH searching for better perf)
+    - exe: .exe path or filename (full path is recommanded to skip path searching for better perf)
     - args: `[]` arguments list
     - options
-        - cwd?: `'D:/'`
+        - cwd?: `fp_root`
         - env?: `process.env` overwrite/add to process.env
-        - encoding?: `'UTF-8'` child output encoding
+        - encoding?: `'utf-8'` child output encoding
         - print?: `true` print option (with details)
         - stdio?: `'pipe'` when 'ignore' then ignore stdio processing
         - detached?: `false` whether to break the connection with child (ignore stdio, unref)
@@ -50,12 +51,12 @@ export interface CallResult<T = string> {
     [inspect.custom](): string;
 }
 /** call process for result
-    - exe: .exe path or filename (full path is recommanded to skip PATH searching for better perf)
+    - exe: .exe path or filename (full path is recommanded to skip path searching for better perf)
     - args: `[]` arguments list
     - options
-        - cwd?: `'D:/'`
+        - cwd?: `'d:/'`
         - env?: `process.env` overwrite/add to process.env
-        - encoding?: `'UTF-8'` child output encoding
+        - encoding?: `'utf-8'` child output encoding
         - print?: `true` print option (with details)
         - stdio?: `'pipe'` when 'ignore' then ignore stdio processing
         - detached?: `false` whether to break the connection with child (ignore stdio, unref)
@@ -63,25 +64,24 @@ export interface CallResult<T = string> {
 */
 export declare function call(exe: string, args?: string[]): Promise<CallResult<string>>;
 export declare function call(exe: string, args?: string[], options?: CallOptions & {
-    encoding: 'BINARY';
-    init_buffer_size?: number;
-}): Promise<CallResult<Buffer>>;
-export declare function call(exe: string, args?: string[], options?: CallOptions & {
-    encoding?: 'UTF-8' | 'GB18030';
+    encoding?: 'utf-8' | 'gb18030';
 }): Promise<CallResult<string>>;
+export declare function call(exe: string, args?: string[], options?: CallOptions & {
+    encoding: 'binary';
+}): Promise<CallResult<Buffer>>;
 /** call node <js> for result
     - js: .js path (relative path will resolve based on cwd)
     - args: `[]` arguments list
     - options
-        - cwd?: `'D:/'`
+        - cwd?: `'d:/'`
         - env?: `process.env` overwrite/add to process.env
-        - encoding?: `'UTF-8'` child process output encoding
+        - encoding?: `'utf-8'` child process output encoding
         - print?: `true` print option (with details)
         - stdio?: `'pipe'` when 'ignore' then ignore stdio processing
         - detached?: `false` whether to break the connection with child (ignore stdio, unref)
         - throw_code?: `true` whether to throw Error when code is not 0
 */
 export declare function call_node(js: string, args?: string[], options?: CallOptions & {
-    encoding?: 'UTF-8' | 'GB18030';
+    encoding?: 'utf-8' | 'gb18030';
 }): Promise<CallResult<string>>;
 export {};

package/process.js

@@ -1,36 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.call_node = exports.call = exports.start = exports.EXE_NODE = void 0;
+exports.call_node = exports.call = exports.start = exports.exe_node = exports.fp_root = void 0;
 const tslib_1 = require("tslib");
 const child_process_1 = require("child_process");
-const stream_buffers_1 = require("stream-buffers");
-const iconv_lite_1 = tslib_1.__importDefault(require("iconv-lite"));
+const iconv_lite_1 = (0, tslib_1.__importDefault)(require("iconv-lite"));
 require("./prototype");
 const utils_1 = require("./utils");
-exports.EXE_NODE = process.execPath.to_slash();
+exports.fp_root = `${__dirname}/`.to_slash();
+exports.exe_node = process.execPath.to_slash();
 /** start process
-    - exe: .exe path or filename (full path is recommanded to skip PATH searching for better perf)
+    - exe: .exe path or filename (full path is recommanded to skip path searching for better perf)
     - args: `[]` arguments list
     - options
-        - cwd?: `'D:/'`
+        - cwd?: `fp_root`
         - env?: `process.env` overwrite/add to process.env
-        - encoding?: `'UTF-8'` child output encoding
+        - encoding?: `'utf-8'` child output encoding
         - print?: `true` print option (with details)
         - stdio?: `'pipe'` when 'ignore' then ignore stdio processing
         - detached?: `false` whether to break the connection with child (ignore stdio, unref)
 */
-function start(exe, args = [], { cwd = 'D:/', encoding = 'UTF-8', print = true, stdio = 'pipe', detached = false, env, } = {}) {
+function start(exe, args = [], { cwd = exports.fp_root, encoding = 'utf-8', print = true, stdio = 'pipe', detached = false, env, } = {}) {
     const options = {
         cwd,
         shell: false,
-        windowsHide: true,
+        windowsHide: !detached,
         stdio,
-        ...env ? { ...process.env, ...env } : {},
+        ...env ? {
+            env: { ...process.env, ...env }
+        } : {},
     };
     if (print)
         console.log(`${exe} ${args.map(arg => arg.includes(' ') ? arg.quote() : arg).join(' ')}`.blue);
     if (detached) {
-        let child = child_process_1.spawn(exe, args, {
+        let child = (0, child_process_1.spawn)(exe, args, {
             ...options,
             stdio: 'ignore',
             detached: true,
@@ -38,31 +40,34 @@ function start(exe, args = [], { cwd = 'D:/', encoding = 'UTF-8', print = true,
         child.unref();
         return child;
     }
-    let child = child_process_1.spawn(exe, args, options);
+    let child = (0, child_process_1.spawn)(exe, args, options);
     if (stdio === 'pipe')
         child.stdin.setDefaultEncoding('utf8');
-    // prevent child spawn error crashing NodeJS process
+    // prevent child spawn error crashing nodejs process
     child.on('error', error => {
         console.error(error);
     });
     if (stdio === 'ignore')
         return child;
-    if (encoding !== 'BINARY') {
-        child.stdout = child.stdout.pipe(iconv_lite_1.default.decodeStream(encoding));
-        child.stderr = child.stderr.pipe(iconv_lite_1.default.decodeStream(encoding));
+    if (encoding !== 'binary') {
+        if (encoding === 'utf-8') {
+            child.stdout.setEncoding('utf-8');
+            child.stderr.setEncoding('utf-8');
+        }
+        else {
+            child.stdout = child.stdout.pipe(iconv_lite_1.default.decodeStream(encoding));
+            child.stderr = child.stderr.pipe(iconv_lite_1.default.decodeStream(encoding));
+        }
         if (print) {
-            child.stdout.on('data', (chunk) => {
-                process.stdout.write(chunk);
-            });
-            child.stderr.on('data', (chunk) => {
-                process.stderr.write(chunk);
-            });
+            child.stdout.pipe(process.stdout, { end: false });
+            child.stderr.pipe(process.stderr, { end: false });
         }
     }
     return child;
 }
 exports.start = start;
-async function call(exe, args = [], { encoding = 'UTF-8', print = true, init_buffer_size, throw_code = true, } = {}) {
+async function call(exe, args = [], options = {}) {
+    const { encoding = 'utf-8', print = true, throw_code = true, } = options;
     const print_options = typeof print === 'boolean' ?
         {
             command: print,
@@ -76,64 +81,53 @@ async function call(exe, args = [], { encoding = 'UTF-8', print = true, init_buf
     const cmd = `${exe} ${args.map(arg => arg.includes(' ') ? arg.quote() : arg).join(' ')}`;
     if (print_options.command)
         console.log(cmd.blue);
-    let child = start(exe, args, Object.assign(arguments[2] || {}, { print: false }));
+    options.print = false;
+    let child = start(exe, args, options);
     // --- collect output
-    let stdout;
-    let stderr;
-    if (encoding !== 'BINARY') {
-        stdout = '';
-        stderr = '';
-        child.stdout.on('data', chunk => {
-            if (print_options.stdout)
-                process.stdout.write(chunk);
-            stdout += chunk;
-        });
-        child.stderr.on('data', chunk => {
-            if (print_options.stderr)
-                process.stderr.write(chunk);
-            stderr += chunk;
-        });
-    }
-    else {
-        const stream_buffer_options = init_buffer_size ? {
-            initialSize: init_buffer_size,
-            incrementAmount: init_buffer_size,
-        } : {};
-        stdout = new stream_buffers_1.WritableStreamBuffer(stream_buffer_options);
-        stderr = new stream_buffers_1.WritableStreamBuffer(stream_buffer_options);
-        if (print_options.stdout)
-            child.stdout.pipe(stdout);
-        if (print_options.stderr)
-            child.stderr.pipe(stderr);
-    }
+    let stdouts = [];
+    let stderrs = [];
     let code, signal;
     await Promise.all([
-        new Promise(resolve => {
-            child.stdout.on('end', () => { resolve(); });
-        }),
-        new Promise(resolve => {
-            child.stderr.on('end', () => { resolve(); });
-        }),
         new Promise(resolve => {
             child.on('exit', (_code, _signal) => {
                 code = _code;
                 signal = _signal;
                 resolve();
             });
-        })
+        }),
+        (async () => {
+            for await (const chunk of child.stdout) {
+                if (encoding !== 'binary' && print_options.stdout)
+                    process.stdout.write(chunk);
+                stdouts.push(chunk);
+            }
+        })(),
+        (async () => {
+            for await (const chunk of child.stderr) {
+                if (encoding !== 'binary' && print_options.stderr)
+                    process.stderr.write(chunk);
+                stderrs.push(chunk);
+            }
+        })()
     ]);
-    const message = `Process(${child.pid}) '${cmd}' exited ${code}${signal ? `, by signal ${signal}` : ''}.  `;
+    const message = `process(${child.pid}) '${cmd}' exited ${code}${signal ? `, by signal ${signal}` : ''}.`;
     if (print_options.code || code || signal)
-        console.log(message[!code && !signal ? 'green' : 'red'].pad(global.WIDTH || 240, { character: '─' }));
+        console.log(message[code || signal ? 'red' : 'blue']);
     const result = {
         pid: child.pid,
-        stdout: encoding !== 'BINARY' ? stdout : (stdout.getContents() || Buffer.alloc(0)),
-        stderr: encoding !== 'BINARY' ? stderr : (stderr.getContents() || Buffer.alloc(0)),
+        stdout: encoding === 'binary' ?
+            Buffer.concat(stdouts)
+            :
+                stdouts.join(''),
+        stderr: encoding === 'binary' ?
+            Buffer.concat(stderrs)
+            :
+                stderrs.join(''),
         code,
         signal,
         child,
         [utils_1.inspect.custom]() {
-            return utils_1.inspect(this, { omit: ['child'] });
+            return (0, utils_1.inspect)(this, { omit: ['child'] });
         }
     };
     if (code && throw_code)
@@ -145,16 +139,16 @@ exports.call = call;
     - js: .js path (relative path will resolve based on cwd)
     - args: `[]` arguments list
     - options
-        - cwd?: `'D:/'`
+        - cwd?: `'d:/'`
         - env?: `process.env` overwrite/add to process.env
-        - encoding?: `'UTF-8'` child process output encoding
+        - encoding?: `'utf-8'` child process output encoding
         - print?: `true` print option (with details)
         - stdio?: `'pipe'` when 'ignore' then ignore stdio processing
         - detached?: `false` whether to break the connection with child (ignore stdio, unref)
         - throw_code?: `true` whether to throw Error when code is not 0
 */
 async function call_node(js, args = [], options) {
-    return call(exports.EXE_NODE, [js, ...args], options);
+    return call(exports.exe_node, [js, ...args], options);
 }
 exports.call_node = call_node;
 //# sourceMappingURL=process.js.map

package/process.js.map

@@ -1 +1 @@
-{"version":3,"file":"process.js","sourceRoot":"","sources":["process.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'child_process'\nimport type { SpawnOptions, ChildProcess } from 'child_process'\nimport { Readable, Writable } from 'stream'\n\n\nimport { WritableStreamBuffer } from 'stream-buffers'\nimport type { WritableStreamBufferOptions } from 'stream-buffers'\nimport iconv from 'iconv-lite'\n\n\nimport './prototype'\nimport { Encoding } from './file'\nimport { inspect } from './utils'\n\n\nexport const EXE_NODE = process.execPath.to_slash()\n\n// ------------------------------------ Start & Call\ninterface StartOptions {\n    /** `'D:/'` */\n    cwd?: string\n    \n    /** `process.env` overwrite/add to process.env */\n    env?: Record<string, string>\n    \n    /** `'UTF-8'` child output encoding */\n    encoding?: Encoding\n    \n    /** `true` print option (with details) */\n    print?: boolean | {\n            command?: boolean\n            stdout?: boolean\n            stderr?: boolean\n            code?: boolean\n            error?: boolean\n        }\n    \n    /** `'pipe'` when 'ignore' then ignore stdio processing */\n    stdio?: 'pipe' | 'ignore'\n    \n    /** `false` whether to break the connection with child (ignore stdio, unref) */\n    detached?: boolean\n}\n\n/** start process \n    - exe: .exe path or filename (full path is recommanded to skip PATH searching for better perf)\n    - args: `[]` arguments list\n    - options\n        - cwd?: `'D:/'`\n        - env?: `process.env` overwrite/add to process.env\n        - encoding?: `'UTF-8'` child output encoding\n        - print?: `true` print option (with details)\n        - stdio?: `'pipe'` when 'ignore' then ignore stdio processing\n        - detached?: `false` whether to break the connection with child (ignore stdio, unref)\n*/\nexport function start (exe: string, args: string[] = [], {\n    cwd = 'D:/',\n    \n    encoding = 'UTF-8',\n    \n    print = true,\n    \n    stdio = 'pipe',\n    \n    detached = false,\n    \n    env,\n    \n}: StartOptions = { }): ChildProcess {\n    const options: SpawnOptions = {\n        cwd,\n        shell: false,\n        windowsHide: true,\n        stdio,\n        ... env  ?  { ...process.env, ...env }  :  { },\n    }\n    \n    if (print)\n        console.log(`${exe} ${ args.map(arg => arg.includes(' ') ? arg.quote() : arg).join(' ') }`.blue)\n    \n    if (detached) {\n        let child = spawn(exe, args, {\n            ...options,\n            stdio: 'ignore',\n            detached: true,\n        })\n        \n        child.unref()\n        return child\n    }\n    \n    let child = spawn(exe, args, options)\n    \n    if (stdio === 'pipe')\n        child.stdin.setDefaultEncoding('utf8')\n    \n    // prevent child spawn error crashing NodeJS process\n    child.on('error', error => {\n        console.error(error)\n    })\n    \n    if (stdio === 'ignore') return child\n    \n    if (encoding !== 'BINARY') {\n        child.stdout = child.stdout.pipe(iconv.decodeStream(encoding)) as any as Readable\n        child.stderr = child.stderr.pipe(iconv.decodeStream(encoding)) as any as Readable\n        \n        if (print) {\n            child.stdout.on('data', (chunk) => {\n                process.stdout.write(chunk)\n            })\n            child.stderr.on('data', (chunk) => {\n                process.stderr.write(chunk)\n            })\n        }\n    }\n    \n    return child\n}\n\n\nexport interface CallOptions extends StartOptions {\n    /** `true` whether to throw Error when code is not 0 */\n    throw_code?: boolean\n}\n\nexport interface CallResult<T = string> {\n    pid: number\n    stdout: T\n    stderr: T\n    code: number | null\n    signal: NodeJS.Signals | null\n    child: ChildProcess\n    [inspect.custom] (): string\n}\n\n\n/** call process for result\n    - exe: .exe path or filename (full path is recommanded to skip PATH searching for better perf)\n    - args: `[]` arguments list\n    - options\n        - cwd?: `'D:/'`\n        - env?: `process.env` overwrite/add to process.env\n        - encoding?: `'UTF-8'` child output encoding\n        - print?: `true` print option (with details)\n        - stdio?: `'pipe'` when 'ignore' then ignore stdio processing\n        - detached?: `false` whether to break the connection with child (ignore stdio, unref)\n        - throw_code?: `true` whether to throw Error when code is not 0\n*/\nexport async function call (exe: string, args?: string[]): Promise<CallResult<string>>\nexport async function call (exe: string, args?: string[], options?: CallOptions & { encoding: 'BINARY', init_buffer_size?: number }): Promise<CallResult<Buffer>>\nexport async function call (exe: string, args?: string[], options?: CallOptions & { encoding?: 'UTF-8' | 'GB18030' }): Promise<CallResult<string>>\nexport async function call (exe: string, args: string[] = [], {\n    encoding = 'UTF-8', \n    \n    print = true,\n    \n    init_buffer_size,\n    \n    throw_code = true,\n}: CallOptions & { init_buffer_size?: number } = { }): Promise<CallResult<string | Buffer>> {\n    const print_options = typeof print === 'boolean' ?\n            {\n                command: print,\n                stdout: print,\n                stderr: print,\n                code: print,\n                error: print\n            }\n        :\n            print\n    \n    const cmd = `${exe} ${ args.map(arg => arg.includes(' ') ? arg.quote() : arg).join(' ') }`\n    \n    if (print_options.command)\n        console.log(cmd.blue)\n    \n    let child = start(exe, args, Object.assign(arguments[2] || { }, { print: false }))\n    \n    // --- collect output\n    let stdout: string | WritableStreamBuffer\n    let stderr: string | WritableStreamBuffer\n    \n    \n    if (encoding !== 'BINARY') {\n        stdout = ''\n        stderr = ''\n        \n        child.stdout.on('data', chunk => {\n            if (print_options.stdout)\n                process.stdout.write(chunk)\n            \n            stdout += chunk\n        })\n        \n        child.stderr.on('data', chunk => {\n            if (print_options.stderr)\n                process.stderr.write(chunk)\n            \n            stderr += chunk\n        })\n    } else {\n        const stream_buffer_options: WritableStreamBufferOptions = init_buffer_size ? {\n            initialSize: init_buffer_size,\n            incrementAmount: init_buffer_size,\n        } : { }\n        \n        stdout = new WritableStreamBuffer(stream_buffer_options)\n        stderr = new WritableStreamBuffer(stream_buffer_options)\n        \n        if (print_options.stdout)\n            child.stdout.pipe(stdout as WritableStreamBuffer)\n        if (print_options.stderr)\n            child.stderr.pipe(stderr as WritableStreamBuffer)\n    }\n    \n    \n    let code: number | null, \n        signal: NodeJS.Signals\n    \n    await Promise.all([\n        new Promise<void>( resolve => {\n            child.stdout.on('end', () => { resolve() })\n        }),\n        new Promise<void>( resolve => {\n            child.stderr.on('end', () => { resolve() })\n        }),\n        new Promise<void>( resolve => {\n            child.on('exit', (_code, _signal: NodeJS.Signals) => {\n                code = _code\n                signal = _signal\n                resolve()\n            })\n        })\n    ])\n    \n    const message = `Process(${ child.pid }) '${ cmd }' exited ${ code }${ signal ? `, by signal ${ signal }` : '' }.  `\n    \n    if (print_options.code || code || signal)\n        console.log(message[!code && !signal ? 'green' : 'red'].pad(global.WIDTH || 240, { character: '─' }))\n    \n    const result = {\n        pid: child.pid,\n        stdout: encoding !== 'BINARY' ? (stdout as string) : ((stdout as WritableStreamBuffer).getContents() || Buffer.alloc(0)),\n        stderr: encoding !== 'BINARY' ? (stderr as string) : ((stderr as WritableStreamBuffer).getContents() || Buffer.alloc(0)),\n        code,\n        signal,\n        child,\n        [inspect.custom] () {\n            return inspect(this, { omit: ['child'] })\n        }\n    }\n    \n    if (code && throw_code)\n        throw Object.assign(new Error(message), result)\n    \n    return result\n}\n\n\n/** call node <js> for result\n    - js: .js path (relative path will resolve based on cwd)\n    - args: `[]` arguments list\n    - options\n        - cwd?: `'D:/'`\n        - env?: `process.env` overwrite/add to process.env\n        - encoding?: `'UTF-8'` child process output encoding\n        - print?: `true` print option (with details)\n        - stdio?: `'pipe'` when 'ignore' then ignore stdio processing\n        - detached?: `false` whether to break the connection with child (ignore stdio, unref)\n        - throw_code?: `true` whether to throw Error when code is not 0\n*/\nexport async function call_node (js: string, args: string[] = [], options?: CallOptions & { encoding?: 'UTF-8' | 'GB18030' }) {\n    return call(EXE_NODE, [js, ...args], options)\n}\n\n"]}
+{"version":3,"file":"process.js","sourceRoot":"","sources":["process.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'child_process'\nimport type { SpawnOptions, ChildProcess } from 'child_process'\nimport { Readable, Writable } from 'stream'\n\nimport iconv from 'iconv-lite'\n\nimport './prototype'\nimport { Encoding } from './file'\nimport { inspect } from './utils'\n\nexport const fp_root = `${__dirname}/`.to_slash()\n\nexport const exe_node = process.execPath.to_slash()\n\n\n// ------------------------------------ start & call\ninterface StartOptions {\n    /** `'d:/'` */\n    cwd?: string\n    \n    /** `process.env` overwrite/add to process.env */\n    env?: Record<string, string>\n    \n    /** `'utf-8'` child output encoding */\n    encoding?: Encoding\n    \n    /** `true` print option (with details) */\n    print?: boolean | {\n            command?: boolean\n            stdout?: boolean\n            stderr?: boolean\n            code?: boolean\n            error?: boolean\n        }\n    \n    /** `'pipe'` when 'ignore' then ignore stdio processing */\n    stdio?: 'pipe' | 'ignore'\n    \n    /** `false` whether to break the connection with child (ignore stdio, unref) */\n    detached?: boolean\n}\n\n/** start process \n    - exe: .exe path or filename (full path is recommanded to skip path searching for better perf)\n    - args: `[]` arguments list\n    - options\n        - cwd?: `fp_root`\n        - env?: `process.env` overwrite/add to process.env\n        - encoding?: `'utf-8'` child output encoding\n        - print?: `true` print option (with details)\n        - stdio?: `'pipe'` when 'ignore' then ignore stdio processing\n        - detached?: `false` whether to break the connection with child (ignore stdio, unref)\n*/\nexport function start (exe: string, args: string[] = [], {\n    cwd = fp_root,\n    \n    encoding = 'utf-8',\n    \n    print = true,\n    \n    stdio = 'pipe',\n    \n    detached = false,\n    \n    env,\n    \n}: StartOptions = { }): ChildProcess {\n    const options: SpawnOptions = {\n        cwd,\n        shell: false,\n        windowsHide: !detached,\n        stdio,\n        ... env ? {\n            env: { ...process.env, ...env }\n        } : { },\n    }\n    \n    if (print)\n        console.log(`${exe} ${ args.map(arg => arg.includes(' ') ? arg.quote() : arg).join(' ') }`.blue)\n    \n    if (detached) {\n        let child = spawn(exe, args, {\n            ...options,\n            stdio: 'ignore',\n            detached: true,\n        })\n        \n        child.unref()\n        return child\n    }\n    \n    let child = spawn(exe, args, options)\n    \n    if (stdio === 'pipe')\n        child.stdin.setDefaultEncoding('utf8')\n    \n    // prevent child spawn error crashing nodejs process\n    child.on('error', error => {\n        console.error(error)\n    })\n    \n    if (stdio === 'ignore') return child\n    \n    if (encoding !== 'binary') {\n        if (encoding === 'utf-8') {\n            child.stdout.setEncoding('utf-8')\n            child.stderr.setEncoding('utf-8')\n        } else {\n            child.stdout = child.stdout.pipe(\n                iconv.decodeStream(encoding)\n            ) as any as Readable\n            child.stderr = child.stderr.pipe(\n                iconv.decodeStream(encoding)\n            ) as any as Readable\n        }\n        \n        if (print) {\n            child.stdout.pipe(process.stdout, { end: false })\n            child.stderr.pipe(process.stderr, { end: false })\n        }\n    }\n    \n    return child\n}\n\n\nexport interface CallOptions extends StartOptions {\n    /** `true` whether to throw Error when code is not 0 */\n    throw_code?: boolean\n}\n\nexport interface CallResult<T = string> {\n    pid: number\n    stdout: T\n    stderr: T\n    code: number | null\n    signal: NodeJS.Signals | null\n    child: ChildProcess\n    [inspect.custom] (): string\n}\n\n\n/** call process for result\n    - exe: .exe path or filename (full path is recommanded to skip path searching for better perf)\n    - args: `[]` arguments list\n    - options\n        - cwd?: `'d:/'`\n        - env?: `process.env` overwrite/add to process.env\n        - encoding?: `'utf-8'` child output encoding\n        - print?: `true` print option (with details)\n        - stdio?: `'pipe'` when 'ignore' then ignore stdio processing\n        - detached?: `false` whether to break the connection with child (ignore stdio, unref)\n        - throw_code?: `true` whether to throw Error when code is not 0\n*/\nexport async function call (exe: string, args?: string[]): Promise<CallResult<string>>\nexport async function call (exe: string, args?: string[], options?: CallOptions & { encoding?: 'utf-8' | 'gb18030' }): Promise<CallResult<string>>\nexport async function call (exe: string, args?: string[], options?: CallOptions & { encoding: 'binary' }): Promise<CallResult<Buffer>>\nexport async function call (exe: string, args: string[] = [], options: CallOptions = { }): Promise<CallResult<string | Buffer>> {\n    const {\n        encoding = 'utf-8', \n        print = true,\n        throw_code = true,\n    } = options\n    \n    const print_options = typeof print === 'boolean' ?\n            {\n                command: print,\n                stdout: print,\n                stderr: print,\n                code: print,\n                error: print\n            }\n        :\n            print\n    \n    const cmd = `${exe} ${ args.map(arg => arg.includes(' ') ? arg.quote() : arg).join(' ') }`\n    \n    if (print_options.command)\n        console.log(cmd.blue)\n    \n    options.print = false\n    \n    let child = start(exe, args, options)\n    \n    \n    // --- collect output\n    let stdouts: (string | Buffer)[] = [ ]\n    let stderrs: (string | Buffer)[] = [ ]\n    \n    let code: number | null, \n        signal: NodeJS.Signals\n    \n    await Promise.all([\n        new Promise<void>(resolve => {\n            child.on('exit', (_code, _signal) => {\n                code = _code\n                signal = _signal\n                resolve()\n            })\n        }),\n        (async () => {\n            for await (const chunk of child.stdout as AsyncIterable<string | Buffer>) {\n                if (encoding !== 'binary' && print_options.stdout)\n                    process.stdout.write(chunk)\n                stdouts.push(chunk)\n            }\n        })(),\n        (async () => {\n            for await (const chunk of child.stderr as AsyncIterable<string | Buffer>) {\n                if (encoding !== 'binary' && print_options.stderr)\n                    process.stderr.write(chunk)\n                stderrs.push(chunk)\n            }\n        })()\n    ])\n    \n    const message = `process(${ child.pid }) '${ cmd }' exited ${ code }${ signal ? `, by signal ${ signal }` : '' }.`\n    \n    if (print_options.code || code || signal)\n        console.log(message[code || signal ? 'red' : 'blue'])\n    \n    const result = {\n        pid: child.pid,\n        \n        stdout: encoding === 'binary' ?\n            Buffer.concat(stdouts as Buffer[])\n        :\n            (stdouts as string[]).join(''),\n        \n        stderr: encoding === 'binary' ?\n            Buffer.concat(stderrs as Buffer[])\n        :\n            (stderrs as string[]).join(''),\n        \n        code,\n        \n        signal,\n        \n        child,\n        \n        [inspect.custom] () {\n            return inspect(this, { omit: ['child'] })\n        }\n    }\n    \n    if (code && throw_code)\n        throw Object.assign(\n            new Error(message), \n            result\n        )\n    \n    return result\n}\n\n\n/** call node <js> for result\n    - js: .js path (relative path will resolve based on cwd)\n    - args: `[]` arguments list\n    - options\n        - cwd?: `'d:/'`\n        - env?: `process.env` overwrite/add to process.env\n        - encoding?: `'utf-8'` child process output encoding\n        - print?: `true` print option (with details)\n        - stdio?: `'pipe'` when 'ignore' then ignore stdio processing\n        - detached?: `false` whether to break the connection with child (ignore stdio, unref)\n        - throw_code?: `true` whether to throw Error when code is not 0\n*/\nexport async function call_node (js: string, args: string[] = [], options?: CallOptions & { encoding?: 'utf-8' | 'gb18030' }) {\n    return call(exe_node, [js, ...args], options)\n}\n\n"]}

package/prototype.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 declare global {
     interface String {
         readonly width: number;
@@ -26,9 +27,9 @@ declare global {
             - pattern_placeholder?: `/\{.*?\}/g`
             
             ```ts
-            'E:/ACGN/海贼王/[Skytree][海贼王][One_Piece][893][GB_BIG5_JP][X264_AAC][1080P][CRRIP][天空树双语字幕组].mkv'.reformat(
+            'g:/acgn/海贼王/[Skytree][海贼王][One_Piece][893][GB_BIG5_JP][X264_AAC][1080P][CRRIP][天空树双语字幕组].mkv'.reformat(
                 '{dirp}/[Skytree][海贼王][{ en_name: \\w+ }][{ episode: \\d+ }][GB_BIG5_JP][{encoding}_AAC][1080P][CRRIP][天空树双语字幕组].{format}',
-                'G:/ACGN/海贼王/{episode} {encoding}.{format}',
+                'g:/acgn/海贼王/{episode} {encoding}.{format}',
                 '\\+',
                 'i',
                 (name, value) => name === 'episode'  ?  String(+value + 1)  :  value.toLowerCase()
@@ -57,10 +58,10 @@ declare global {
         find(this: string, pattern: string, preservations?: string, flags?: string, pattern_placeholder?: RegExp): {
             [name: string]: string;
         };
-        /** - type?: `'SINGLE'` */
-        quote(this: string, type?: keyof typeof QUOTES | 'PSH'): string;
-        /** - shape?: `'PARENTHESIS'` */
-        bracket(this: string, shape?: keyof typeof BRACKETS): string;
+        /** - type?: `'single'` */
+        quote(this: string, type?: keyof typeof quotes | 'psh'): string;
+        /** - shape?: `'parenthesis'` */
+        bracket(this: string, shape?: keyof typeof brackets): string;
         surround(this: string, left: string, right?: string): string;
         surround_tag(this: string, tag_name: string): string;
         to_lf(this: string): string;
@@ -70,14 +71,21 @@ declare global {
         */
         rm(this: string, pattern: string | RegExp, flags?: string): string;
         readonly red: string;
+        readonly red_: string;
         readonly green: string;
+        readonly green_: string;
         readonly yellow: string;
+        readonly yellow_: string;
         readonly blue: string;
+        readonly blue_: string;
         readonly magenta: string;
+        readonly magenta_: string;
         readonly cyan: string;
+        readonly cyan_: string;
         readonly grey: string;
         readonly underline: string;
         strip_ansi(this: string): string;
+        /** split string to lines and strip last '' after last \n */
         split_lines(this: string): string[];
         trim_doc_comment(this: string): string;
         split_indent(this: string): {
@@ -85,7 +93,10 @@ declare global {
             text: string;
         };
         to_base64(this: string): string;
+        /** - buffer: `false` return raw Buffer */
         decode_base64(this: string): string;
+        decode_base64(this: string, buffer: true): Buffer;
+        decode_base64(this: string, buffer?: boolean): string | Buffer;
         space(this: string): string;
         fdir: string;
         /** path.basename, e.g.
@@ -137,29 +148,29 @@ declare global {
         join_lines(): string;
     }
 }
-import colors from 'colors/safe';
-export declare const EMOJI_REGEX: RegExp;
-export { colors };
+import chalk from 'chalk';
+export declare const emoji_regex: RegExp;
+export { chalk };
 export declare function to_method_property_descriptors(methods: {
     [name: string]: Function;
 }): PropertyDescriptorMap;
 export declare function to_getter_property_descriptors(getters: {
     [name: string]: Function;
 }): PropertyDescriptorMap;
-export declare const CJK = "([\u2E80-\u9FFF\uF900-\uFAFF])";
-export declare const QUOTES: {
-    SINGLE: string;
-    DOUBLE: string;
-    BACKTICK: string;
+export declare const cjk = "([\u2E80-\u9FFF\uF900-\uFAFF])";
+export declare const quotes: {
+    single: string;
+    double: string;
+    backtick: string;
 };
-export declare const BRACKETS: {
-    readonly ROUND: readonly ["(", ")"];
-    readonly SQUARE: readonly ["[", "]"];
-    readonly CURLY: readonly ["{", "}"];
-    readonly POINTY: readonly ["<", ">"];
-    readonly CORNER: readonly ["「", "」"];
-    readonly FAT: readonly ["【", "】"];
-    readonly TORTOISE_SHELL: readonly ["〔", "〕"];
+export declare const brackets: {
+    readonly round: readonly ["(", ")"];
+    readonly square: readonly ["[", "]"];
+    readonly curly: readonly ["{", "}"];
+    readonly pointy: readonly ["<", ">"];
+    readonly corner: readonly ["「", "」"];
+    readonly fat: readonly ["【", "】"];
+    readonly tortoise_shell: readonly ["〔", "〕"];
 };
 export declare function to_json(obj: any, replacer?: any): string;
 export declare function to_json_safely(obj: any, replacer?: any): string;