@alterior/terminal 3.1.7

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017-2018 William Lahti
+
+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,24 @@
+# @alterior/terminal
+
+Provides utilities useful for terminal applications, including reading input and styling output.
+
+# Reading input
+
+```typescript
+import { read } from '@alterior/terminal';
+
+let name = await read({ prompt: `What's your name? ` });
+
+console.log(`Hello ${name}!`);
+```
+
+# Styling output
+
+```typescript
+import { styled, style } from '@alterior/terminal';
+
+console.log(
+    styled(`Hello `, style.$blue(`world`), `, how are `, style.$green(`you`), `?`)
+);
+
+```

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './style';
+export * from './read';

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./style"), exports);
+__exportStar(require("./read"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,yCAAuB"}

package/dist/read/basic.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/read/basic.test.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const razmin_1 = require("razmin");
+const fixtures_1 = require("./fixtures");
+const read_1 = __importDefault(require("./read"));
+if (process.argv[2] === 'child') {
+    child();
+}
+else {
+    (0, razmin_1.describe)('read', it => {
+        it('basic', async () => {
+            const { stdout, stderr } = await (0, fixtures_1.spawnRead)(__filename, {
+                'Username: (test-user)': 'a user',
+                'Password: (<default hidden>)': 'a password',
+                'Password again: (<default hidden>)': 'a password',
+            });
+            (0, chai_1.expect)(JSON.parse(stderr)).to.eql({ user: 'a user', pass: 'a password', verify: 'a password', passMatch: true });
+            (0, chai_1.expect)(stdout).to.equal('Username: (test-user) Password: (<default hidden>) Password again: (<default hidden>) ');
+        });
+        it('defaults', async () => {
+            const { stdout, stderr } = await (0, fixtures_1.spawnRead)(__filename, {
+                'Username: (test-user)': '',
+                'Password: (<default hidden>)': '',
+                'Password again: (<default hidden>)': '',
+            });
+            (0, chai_1.expect)(JSON.parse(stderr)).to.eql({ user: 'test-user', pass: 'test-pass', verify: 'test-pass', passMatch: true });
+            (0, chai_1.expect)(stdout).to.equal('Username: (test-user) Password: (<default hidden>) Password again: (<default hidden>) ');
+        });
+        it('errors', async () => {
+            try {
+                await (0, read_1.default)({ default: {} });
+            }
+            catch (e) {
+                return;
+            }
+            throw new Error(`Expected rejection`);
+        });
+    });
+}
+async function child() {
+    const user = await (0, read_1.default)({ prompt: 'Username: ', default: 'test-user' });
+    const pass = await (0, read_1.default)({ prompt: 'Password: ', default: 'test-pass', silent: true });
+    const verify = await (0, read_1.default)({ prompt: 'Password again: ', default: 'test-pass', silent: true });
+    console.error(JSON.stringify({
+        user,
+        pass,
+        verify,
+        passMatch: pass === verify,
+    }));
+    if (process.stdin.unref) {
+        process.stdin.unref();
+    }
+}
+//# sourceMappingURL=basic.test.js.map

package/dist/read/basic.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic.test.js","sourceRoot":"","sources":["../../src/read/basic.test.ts"],"names":[],"mappings":";;;;;AAAA,+BAA6B;AAC7B,mCAAiC;AACjC,yCAAuC;AAEvC,kDAA0B;AAE1B,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE;IAC/B,KAAK,EAAE,CAAA;CACR;KAAM;IACL,IAAA,iBAAQ,EAAC,MAAM,EAAE,EAAE,CAAC,EAAE;QACpB,EAAE,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE;YACrB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,oBAAS,EAAC,UAAU,EAAE;gBACrD,uBAAuB,EAAE,QAAQ;gBACjC,8BAA8B,EAAE,YAAY;gBAC5C,oCAAoC,EAAE,YAAY;aACnD,CAAC,CAAA;YAEF,IAAA,aAAM,EAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACjH,IAAA,aAAM,EAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,wFAAwF,CAAC,CAAC;QACpH,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;YACxB,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,oBAAS,EAAC,UAAU,EAAE;gBACrD,uBAAuB,EAAE,EAAE;gBAC3B,8BAA8B,EAAE,EAAE;gBAClC,oCAAoC,EAAE,EAAE;aACzC,CAAC,CAAA;YAEF,IAAA,aAAM,EAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClH,IAAA,aAAM,EAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,wFAAwF,CAAC,CAAC;QACpH,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YACtB,IAAI;gBACF,MAAM,IAAA,cAAI,EAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAA;aAC5B;YAAC,OAAO,CAAC,EAAE;gBACV,OAAO;aACR;YAED,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACxC,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;CACH;AAED,KAAK,UAAU,KAAK;IAClB,MAAM,IAAI,GAAG,MAAM,IAAA,cAAI,EAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAA;IACvE,MAAM,IAAI,GAAG,MAAM,IAAA,cAAI,EAAC,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IACrF,MAAM,MAAM,GAAG,MAAM,IAAA,cAAI,EAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IAE7F,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;QAC3B,IAAI;QACJ,IAAI;QACJ,MAAM;QACN,SAAS,EAAE,IAAI,KAAK,MAAM;KAC3B,CAAC,CAAC,CAAA;IAEH,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;KACtB;AACH,CAAC"}

package/dist/read/fixtures.d.ts

@@ -0,0 +1,4 @@
+export declare function spawnRead(filename: any, writes: any): Promise<{
+    stdout: string;
+    stderr: string;
+}>;

package/dist/read/fixtures.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spawnRead = void 0;
+const spawn = require('child_process').spawn;
+const esc = (str) => str
+    .replace(/\(/g, '\\(')
+    .replace(/\)/g, '\\)');
+async function spawnRead(filename, writes) {
+    const proc = spawn(process.execPath, [filename, 'child']);
+    return new Promise((resolve, reject) => {
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (c) => {
+            stdout += c;
+            for (const [prompt, write] of Object.entries(writes)) {
+                if (stdout.match(new RegExp(`${esc(prompt)} $`))) {
+                    return process.nextTick(() => proc.stdin.write(`${write}\n`));
+                }
+            }
+            reject(new Error(`unknown prompt:\n${stdout}\n${JSON.stringify(writes)}`));
+        });
+        proc.stderr.on('data', (c) => {
+            stderr += c;
+        });
+        proc.on('close', () => resolve({
+            stdout,
+            stderr,
+        }));
+    });
+}
+exports.spawnRead = spawnRead;
+//# sourceMappingURL=fixtures.js.map

package/dist/read/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../../src/read/fixtures.ts"],"names":[],"mappings":";;;AAAA,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,KAAK,CAAA;AAC5C,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;KACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;KACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AAEjB,KAAK,UAAU,SAAS,CAAC,QAAQ,EAAE,MAAM;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAA;IAEzD,OAAO,IAAI,OAAO,CAAqC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzE,IAAI,MAAM,GAAG,EAAE,CAAA;QACf,IAAI,MAAM,GAAG,EAAE,CAAA;QAEf,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YAC3B,MAAM,IAAI,CAAC,CAAA;YACX,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;gBACpD,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE;oBAChD,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAA;iBAC9D;aACF;YACD,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,MAAM,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAA;QAC5E,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YAC3B,MAAM,IAAI,CAAC,CAAA;QACb,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC;YAC7B,MAAM;YACN,MAAM;SACP,CAAC,CAAC,CAAA;IACL,CAAC,CAAC,CAAA;AACJ,CAAC;AA1BD,8BA0BC"}

package/dist/read/index.d.ts

@@ -0,0 +1 @@
+export * from './read';

package/dist/read/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./read"), exports);
+//# sourceMappingURL=index.js.map

package/dist/read/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB"}

package/dist/read/many.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/read/many.test.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const razmin_1 = require("razmin");
+const fixtures_1 = require("./fixtures");
+const read_1 = __importDefault(require("./read"));
+const times = new Array(18).fill(null).map((_, i) => (i + 1).toString());
+if (process.argv[2] === 'child') {
+    child();
+}
+else {
+    (0, razmin_1.describe)('read', it => {
+        it('many reads', async () => {
+            const writes = times.reduce((acc, k) => {
+                acc[`num ${k}`] = k;
+                return acc;
+            }, {});
+            const { stdout, stderr } = await (0, fixtures_1.spawnRead)(__filename, writes);
+            (0, chai_1.expect)(stdout).to.equal(Object.keys(writes).join(' ') + ' ');
+            (0, chai_1.expect)(stderr).to.equal(times.join(' ') + '\n');
+        });
+    });
+}
+async function child() {
+    const res = [];
+    for (const t of times) {
+        const r = await (0, read_1.default)({ prompt: `num ${t}` });
+        res.push(r);
+    }
+    console.error(...res);
+    if (process.stdin.unref) {
+        process.stdin.unref();
+    }
+}
+//# sourceMappingURL=many.test.js.map

package/dist/read/many.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"many.test.js","sourceRoot":"","sources":["../../src/read/many.test.ts"],"names":[],"mappings":";;;;;AAAA,+BAA8B;AAC9B,mCAAkC;AAClC,yCAAuC;AACvC,kDAA0B;AAE1B,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAA;AAExE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE;IAC/B,KAAK,EAAE,CAAC;CACT;KAAM;IACL,IAAA,iBAAQ,EAAC,MAAM,EAAE,EAAE,CAAC,EAAE;QACpB,EAAE,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;YAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;gBACrC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;gBACnB,OAAO,GAAG,CAAA;YACZ,CAAC,EAAE,EAAE,CAAC,CAAA;YACN,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAA,oBAAS,EAAC,UAAU,EAAE,MAAM,CAAC,CAAA;YAE9D,IAAA,aAAM,EAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;YAC7D,IAAA,aAAM,EAAC,MAAM,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAA;CAEH;AAED,KAAK,UAAU,KAAK;IAClB,MAAM,GAAG,GAAG,EAAE,CAAA;IACd,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE;QACrB,MAAM,CAAC,GAAG,MAAM,IAAA,cAAI,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;QAC5C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;KACZ;IAED,OAAO,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAA;IAErB,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE;QACvB,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;KACtB;AACH,CAAC"}

package/dist/read/read.d.ts

@@ -0,0 +1,41 @@
+/// <reference types="node" />
+import { ReadStream, WriteStream } from 'tty';
+export interface ReadOptions {
+    /**
+     * The default value if the user enters nothing.
+     */
+    default?: any;
+    /**
+     * Readable stream to get input data from. (default `process.stdin`)
+     */
+    input?: ReadStream;
+    /**
+     * Writable stream to write prompts to. (default: `process.stdout`)
+     */
+    output?: WriteStream;
+    /**
+     * What to write to stdout before reading input.
+     */
+    prompt?: string;
+    /**
+     * Don't echo the output as the user types it.
+     */
+    silent?: boolean;
+    /**
+     * Number of ms to wait for user input before giving up.
+     */
+    timeout?: number;
+    /**
+     * Allow the user to edit the default value.
+     */
+    edit?: boolean;
+    /**
+     * Treat the output as a TTY, whether it is or not.
+     */
+    terminal?: boolean;
+    /**
+     * Replace silenced characters with the supplied character value.
+     */
+    replace?: string;
+}
+export default function read(options?: ReadOptions): Promise<string>;

package/dist/read/read.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const readline_1 = __importDefault(require("readline"));
+const mute_stream_1 = __importDefault(require("mute-stream"));
+async function read(options) {
+    var _a, _b;
+    let opts = { prompt: '', ...options };
+    (_a = opts.input) !== null && _a !== void 0 ? _a : (opts.input = process.stdin);
+    (_b = opts.output) !== null && _b !== void 0 ? _b : (opts.output = process.stdout);
+    if (typeof opts.default !== 'undefined' && typeof opts.default !== 'string' && typeof opts.default !== 'number') {
+        throw new Error('default value must be string or number');
+    }
+    let editDef = false;
+    opts.prompt = opts.prompt.trim() + ' ';
+    opts.terminal = !!(opts.terminal || opts.output.isTTY);
+    if (opts.default) {
+        if (opts.silent) {
+            opts.prompt += '(<default hidden>) ';
+        }
+        else if (opts.edit) {
+            editDef = true;
+        }
+        else {
+            opts.prompt += '(' + opts.default + ') ';
+        }
+    }
+    const input = opts.input;
+    const output = new mute_stream_1.default({ replace: opts.replace, prompt: opts.prompt });
+    output.pipe(opts.output, { end: false });
+    return new Promise((resolve, reject) => {
+        const rl = readline_1.default.createInterface({ input, output, terminal: opts.terminal });
+        const timer = opts.timeout && setTimeout(() => onError(new Error('timed out')), opts.timeout);
+        output.unmute();
+        rl.setPrompt(opts.prompt);
+        rl.prompt();
+        if (opts.silent) {
+            output.mute();
+        }
+        else if (editDef) {
+            rl.line = opts.default;
+            rl.cursor = opts.default.length;
+            rl._refreshLine();
+        }
+        const done = () => {
+            rl.close();
+            clearTimeout(timer);
+            output.mute();
+            output.end();
+        };
+        const onError = (er) => {
+            done();
+            reject(er);
+        };
+        rl.on('error', onError);
+        rl.on('line', (line) => {
+            if (opts.silent && opts.terminal) {
+                output.unmute();
+                output.write('\r\n');
+            }
+            done();
+            // truncate the \n at the end.
+            const res = line.replace(/\r?\n$/, '') || opts.default || '';
+            return resolve(res);
+        });
+        rl.on('SIGINT', () => {
+            rl.close();
+            onError(new Error('canceled'));
+        });
+    });
+}
+exports.default = read;
+//# sourceMappingURL=read.js.map

package/dist/read/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/read/read.ts"],"names":[],"mappings":"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"}

package/dist/style.d.ts

@@ -0,0 +1,48 @@
+declare const STYLE_CODES: {
+    reset: number[];
+    bold: number[];
+    dim: number[];
+    italic: number[];
+    underline: number[];
+    inverse: number[];
+    hidden: number[];
+    strikethrough: number[];
+    black: number[];
+    red: number[];
+    green: number[];
+    yellow: number[];
+    blue: number[];
+    magenta: number[];
+    cyan: number[];
+    white: number[];
+    gray: number[];
+    grey: number[];
+    bgBlack: number[];
+    bgRed: number[];
+    bgGreen: number[];
+    bgYellow: number[];
+    bgBlue: number[];
+    bgMagenta: number[];
+    bgCyan: number[];
+    bgWhite: number[];
+};
+export type BoundStyler = (...contents: (StyledString | string)[]) => StyledString;
+export type StyleShortcuts = {
+    [P in keyof typeof STYLE_CODES as `$${P}`]: (...contents: (StyledString | string)[]) => StyledString;
+};
+export type Styler = BoundStyler & StyleShortcuts;
+export type Style = keyof typeof STYLE_CODES;
+export declare const startStyle: (key: keyof typeof STYLE_CODES) => string;
+export declare const endStyle: (key: keyof typeof STYLE_CODES) => string;
+export declare function styleIndicator(key: keyof typeof STYLE_CODES, index: number): string;
+export declare class StyledString {
+    readonly style?: keyof typeof STYLE_CODES;
+    readonly parts: (StyledString | string)[];
+    constructor(style?: keyof typeof STYLE_CODES, parts?: (StyledString | string)[]);
+    start(): string;
+    end(): string;
+    toString(): string;
+}
+export declare const style: Styler;
+export declare function styled(...contents: (string | StyledString)[]): string;
+export {};

package/dist/style.js

@@ -0,0 +1,75 @@
+"use strict";
+/*
+ * Portions are Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+ *  https://github.com/Marak/colors.js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.styled = exports.style = exports.StyledString = exports.styleIndicator = exports.endStyle = exports.startStyle = void 0;
+const STYLE_CODES = {
+    reset: [0, 0],
+    bold: [1, 22],
+    dim: [2, 22],
+    italic: [3, 23],
+    underline: [4, 24],
+    inverse: [7, 27],
+    hidden: [8, 28],
+    strikethrough: [9, 29],
+    black: [30, 39],
+    red: [31, 39],
+    green: [32, 39],
+    yellow: [33, 39],
+    blue: [34, 39],
+    magenta: [35, 39],
+    cyan: [36, 39],
+    white: [37, 39],
+    gray: [90, 39],
+    grey: [90, 39],
+    bgBlack: [40, 49],
+    bgRed: [41, 49],
+    bgGreen: [42, 49],
+    bgYellow: [43, 49],
+    bgBlue: [44, 49],
+    bgMagenta: [45, 49],
+    bgCyan: [46, 49],
+    bgWhite: [47, 49]
+};
+const startStyle = (key) => styleIndicator(key, 0);
+exports.startStyle = startStyle;
+const endStyle = (key) => styleIndicator(key, 1);
+exports.endStyle = endStyle;
+function styleIndicator(key, index) {
+    var _a;
+    if (key === undefined)
+        return '';
+    if (!(key in STYLE_CODES))
+        throw new Error(`No such style '${key}'`);
+    return `\u001b[${(_a = STYLE_CODES[key]) === null || _a === void 0 ? void 0 : _a[index]}m`;
+}
+exports.styleIndicator = styleIndicator;
+class StyledString {
+    constructor(style, parts = []) {
+        this.style = style;
+        this.parts = parts;
+    }
+    start() {
+        return (0, exports.startStyle)(this.style);
+    }
+    end() {
+        return (0, exports.endStyle)(this.style);
+    }
+    toString() {
+        return `${this.start()}${this.parts.join('')}${this.end()}`;
+    }
+}
+exports.StyledString = StyledString;
+let _style = (style, ...contents) => {
+    return new StyledString(style, contents);
+};
+for (let key of Object.keys(STYLE_CODES))
+    _style[`$${key}`] = (...contents) => new StyledString(key, contents);
+exports.style = _style;
+function styled(...contents) {
+    return (0, exports.style)(undefined, ...contents).toString();
+}
+exports.styled = styled;
+//# sourceMappingURL=style.js.map

package/dist/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../src/style.ts"],"names":[],"mappings":"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"}

package/dist/test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const razmin_1 = require("razmin");
+(0, razmin_1.suite)().include(['**/*.test.js']).run();
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":";;AAAA,mCAA+B;AAC/B,IAAA,cAAK,GAAE,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@alterior/terminal",
+  "version": "3.1.7",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "mute-stream": "~1.0.0"
+  },
+  "devDependencies": {
+    "@types/mute-stream": "^0.0.1"
+  },
+  "engines": {
+    "node": "^14.17.0 || ^16.13.0 || >=18.0.0"
+  },
+  "author": "The Alterior Project (https://github.com/alterior-mvc)",
+  "description": "Utilities for terminal applications",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alterior-mvc/alterior.git"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -b .",
+    "test": "npm run build && node dist/test",
+    "prepublishOnly": "npm test"
+  },
+  "gitHead": "ec71d565d6fceb5054bbefe1f1c6648e713dcca9"
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './style';
+export * from './read';

package/src/read/basic.test.ts

@@ -0,0 +1,60 @@
+import { expect } from "chai"
+import { describe } from "razmin"
+import { spawnRead } from './fixtures';
+
+import read from './read';
+
+if (process.argv[2] === 'child') {
+  child()
+} else {
+  describe('read', it => {
+    it('basic', async () => {
+      const { stdout, stderr } = await spawnRead(__filename, {
+        'Username: (test-user)': 'a user',
+        'Password: (<default hidden>)': 'a password',
+        'Password again: (<default hidden>)': 'a password',
+      })
+    
+      expect(JSON.parse(stderr)).to.eql({ user: 'a user', pass: 'a password', verify: 'a password', passMatch: true });
+      expect(stdout).to.equal('Username: (test-user) Password: (<default hidden>) Password again: (<default hidden>) ');
+    })
+    
+    it('defaults', async () => {
+      const { stdout, stderr } = await spawnRead(__filename, {
+        'Username: (test-user)': '',
+        'Password: (<default hidden>)': '',
+        'Password again: (<default hidden>)': '',
+      })
+    
+      expect(JSON.parse(stderr)).to.eql({ user: 'test-user', pass: 'test-pass', verify: 'test-pass', passMatch: true });
+      expect(stdout).to.equal('Username: (test-user) Password: (<default hidden>) Password again: (<default hidden>) ');
+    })
+    
+    it('errors', async () => {
+      try {
+        await read({ default: {} })
+      } catch (e) {
+        return;
+      }
+
+      throw new Error(`Expected rejection`);
+    })
+  })
+}
+
+async function child () {
+  const user = await read({ prompt: 'Username: ', default: 'test-user' })
+  const pass = await read({ prompt: 'Password: ', default: 'test-pass', silent: true })
+  const verify = await read({ prompt: 'Password again: ', default: 'test-pass', silent: true })
+
+  console.error(JSON.stringify({
+    user,
+    pass,
+    verify,
+    passMatch: pass === verify,
+  }))
+
+  if (process.stdin.unref) {
+    process.stdin.unref()
+  }
+}

package/src/read/fixtures.ts

@@ -0,0 +1,32 @@
+const spawn = require('child_process').spawn
+const esc = (str) => str
+  .replace(/\(/g, '\\(')
+  .replace(/\)/g, '\\)')
+
+export async function spawnRead(filename, writes) {
+  const proc = spawn(process.execPath, [filename, 'child'])
+
+  return new Promise<{ stdout: string, stderr: string }>((resolve, reject) => {
+    let stdout = ''
+    let stderr = ''
+
+    proc.stdout.on('data', (c) => {
+      stdout += c
+      for (const [prompt, write] of Object.entries(writes)) {
+        if (stdout.match(new RegExp(`${esc(prompt)} $`))) {
+          return process.nextTick(() => proc.stdin.write(`${write}\n`))
+        }
+      }
+      reject(new Error(`unknown prompt:\n${stdout}\n${JSON.stringify(writes)}`))
+    })
+
+    proc.stderr.on('data', (c) => {
+      stderr += c
+    })
+
+    proc.on('close', () => resolve({
+      stdout,
+      stderr,
+    }))
+  })
+}

package/src/read/index.ts

@@ -0,0 +1 @@
+export * from './read';

package/src/read/many.test.ts

@@ -0,0 +1,38 @@
+import { expect } from 'chai';
+import { describe } from 'razmin';
+import { spawnRead } from './fixtures';
+import read from './read';
+
+const times = new Array(18).fill(null).map((_, i) => (i + 1).toString())
+
+if (process.argv[2] === 'child') {
+  child();
+} else {
+  describe('read', it => {
+    it('many reads', async () => {
+      const writes = times.reduce((acc, k) => {
+        acc[`num ${k}`] = k
+        return acc
+      }, {})
+      const { stdout, stderr } = await spawnRead(__filename, writes)
+    
+      expect(stdout).to.equal(Object.keys(writes).join(' ') + ' ');
+      expect(stderr).to.equal(times.join(' ') + '\n');
+    });
+  })
+  
+}
+
+async function child () {
+  const res = []
+  for (const t of times) {
+    const r = await read({ prompt: `num ${t}` })
+    res.push(r)
+  }
+
+  console.error(...res)
+
+  if (process.stdin.unref) {
+    process.stdin.unref()
+  }
+}

package/src/read/read.ts

@@ -0,0 +1,124 @@
+import readline from 'readline';
+import Mute from 'mute-stream';
+import { ReadStream, WriteStream } from 'tty';
+
+export interface ReadOptions {
+  /**
+   * The default value if the user enters nothing.
+   */
+  default?: any;
+
+  /**
+   * Readable stream to get input data from. (default `process.stdin`)
+   */
+  input?: ReadStream;
+
+  /**
+   * Writable stream to write prompts to. (default: `process.stdout`)
+   */
+  output?: WriteStream;
+
+  /**
+   * What to write to stdout before reading input.
+   */
+  prompt?: string;
+
+  /**
+   * Don't echo the output as the user types it.
+   */
+  silent?: boolean;
+
+  /**
+   * Number of ms to wait for user input before giving up.
+   */
+  timeout?: number;
+
+  /**
+   * Allow the user to edit the default value.
+   */
+  edit?: boolean;
+
+  /**
+   * Treat the output as a TTY, whether it is or not.
+   */
+  terminal?: boolean;
+
+  /**
+   * Replace silenced characters with the supplied character value.
+   */
+  replace?: string;
+}
+
+export default async function read (options?: ReadOptions): Promise<string> {
+  let opts = { prompt: '', ...options };
+  opts.input ??= process.stdin;
+  opts.output ??= process.stdout;
+
+  if (typeof opts.default !== 'undefined' && typeof opts.default !== 'string' && typeof opts.default !== 'number') {
+    throw new Error('default value must be string or number')
+  }
+
+  let editDef = false;
+  opts.prompt = opts.prompt.trim() + ' '
+  opts.terminal = !!(opts.terminal || opts.output.isTTY)
+
+  if (opts.default) {
+    if (opts.silent) {
+      opts.prompt += '(<default hidden>) '
+    } else if (opts.edit) {
+      editDef = true
+    } else {
+      opts.prompt += '(' + opts.default + ') '
+    }
+  }
+
+  const input = opts.input;
+  const output = new Mute({ replace: opts.replace, prompt: opts.prompt })
+  output.pipe(opts.output, { end: false });
+
+  return new Promise<string>((resolve, reject) => {
+    const rl = readline.createInterface({ input, output, terminal: opts.terminal })
+    const timer = opts.timeout && setTimeout(() => onError(new Error('timed out')), opts.timeout)
+
+    output.unmute();
+    rl.setPrompt(opts.prompt);
+    rl.prompt();
+
+    if (opts.silent) {
+      output.mute();
+    } else if (editDef) {
+      (rl as any).line = opts.default;
+      (rl as any).cursor = opts.default!.length;
+      (rl as any)._refreshLine();
+    }
+
+    const done = () => {
+      rl.close()
+      clearTimeout(timer)
+      output.mute()
+      output.end()
+    }
+
+    const onError = (er) => {
+      done()
+      reject(er)
+    }
+
+    rl.on('error', onError)
+    rl.on('line', (line) => {
+      if (opts.silent && opts.terminal) {
+        output.unmute()
+        output.write('\r\n')
+      }
+      done()
+      // truncate the \n at the end.
+      const res = line.replace(/\r?\n$/, '') || opts.default || ''
+      return resolve(res)
+    })
+
+    rl.on('SIGINT', () => {
+      rl.close()
+      onError(new Error('canceled'))
+    })
+  })
+}

package/src/style.ts

@@ -0,0 +1,88 @@
+/*
+ * Portions are Copyright (c) Sindre Sorhus <sindresorhus@gmail.com> (sindresorhus.com)
+ *  https://github.com/Marak/colors.js
+ */
+
+const STYLE_CODES = {
+    reset: [0, 0],
+
+    bold: [1, 22],
+    dim: [2, 22],
+    italic: [3, 23],
+    underline: [4, 24],
+    inverse: [7, 27],
+    hidden: [8, 28],
+    strikethrough: [9, 29],
+
+    black: [30, 39],
+    red: [31, 39],
+    green: [32, 39],
+    yellow: [33, 39],
+    blue: [34, 39],
+    magenta: [35, 39],
+    cyan: [36, 39],
+    white: [37, 39],
+    gray: [90, 39],
+    grey: [90, 39],
+
+    bgBlack: [40, 49],
+    bgRed: [41, 49],
+    bgGreen: [42, 49],
+    bgYellow: [43, 49],
+    bgBlue: [44, 49],
+    bgMagenta: [45, 49],
+    bgCyan: [46, 49],
+    bgWhite: [47, 49]
+};
+
+export type BoundStyler = (...contents: (StyledString | string)[]) => StyledString;
+export type StyleShortcuts = {
+    [P in keyof typeof STYLE_CODES as `$${P}`]: (...contents: (StyledString | string)[]) => StyledString;
+}
+
+export type Styler = BoundStyler & StyleShortcuts;
+
+export type Style = keyof typeof STYLE_CODES;
+export const startStyle = (key: keyof typeof STYLE_CODES) => styleIndicator(key, 0);
+export const endStyle = (key: keyof typeof STYLE_CODES) => styleIndicator(key, 1);
+
+export function styleIndicator(key: keyof typeof STYLE_CODES, index: number) {
+    if (key === undefined)
+        return '';
+    if (!(key in STYLE_CODES))
+        throw new Error(`No such style '${key}'`);
+    return `\u001b[${STYLE_CODES[key]?.[index]}m`;
+}
+
+export class StyledString {
+    constructor(
+        readonly style?: keyof typeof STYLE_CODES,
+        readonly parts: (StyledString | string)[] = []
+    ) {
+    }
+
+    start() {
+        return startStyle(this.style);
+    }
+
+    end() {
+        return endStyle(this.style);
+    }
+
+    toString() {
+        return `${this.start()}${this.parts.join('')}${this.end()}`;
+    }
+}
+
+let _style = (style: Style, ...contents: (string | StyledString)[]): Readonly<StyledString> => {
+    return new StyledString(style, contents);
+}
+
+for (let key of <Style[]>Object.keys(STYLE_CODES))
+    _style[`$${key}`] = (...contents: (string | StyledString)[]) => new StyledString(key, contents);
+
+export const style = <Styler>_style;
+
+export function styled(...contents: (string | StyledString)[]): string {
+    return style(undefined, ...contents).toString();
+}

package/src/test.ts

@@ -0,0 +1,2 @@
+import { suite } from "razmin";
+suite().include(['**/*.test.js']).run();

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+    "compilerOptions": {
+        "target": "ES2019",
+        "module": "CommonJS",
+        "moduleResolution": "node",
+        "esModuleInterop": true,
+        "sourceMap": true,
+        "declaration": true,
+        "outDir": "dist"
+    },
+    "include": [
+        "./src/**/*.ts"
+    ]
+}