npm - xshell - Versions diffs - 0.0.10 → 0.0.14 - Mend

xshell 0.0.10 → 0.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (28) hide show

package/process.js CHANGED Viewed

@@ -1,31 +1,33 @@
 "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 = (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);
@@ -41,28 +43,31 @@ function start(exe, args = [], { cwd = 'd:/', encoding = 'UTF-8', print = true,
     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,59 +81,48 @@ 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,
@@ -147,14 +141,14 @@ exports.call = call;
     - options
         - 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 CHANGED Viewed

	@@ -1 +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"]}
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\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 CHANGED Viewed

@@ -1,3 +1,4 @@
+/// <reference types="node" />
 declare global {
     interface String {
         readonly width: number;
@@ -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;