npm - @topcli/prompts - Versions diffs - 2.0.0 → 2.1.0 - Mend

@topcli/prompts 2.0.0 → 2.1.0

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 (7) hide show

package/LICENSE CHANGED Viewed

@@ -1,13 +1,13 @@
-Copyright 2023-2024 TopCli
-Permission to use, copy, modify, and/or distribute this software for any purpose
-with or without fee is hereby granted, provided that the above copyright notice
-and this permission notice appear in all copies.
-THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
-REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
-FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
-INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
-OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
-TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
-THIS SOFTWARE.
+Copyright 2023-2025 TopCli
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted, provided that the above copyright notice
+and this permission notice appear in all copies.
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.

package/README.md CHANGED Viewed

@@ -1,264 +1,274 @@
-<div align="center">
-  <img src="./public/banner.png" alt="@topcli/prompts">
-  ![version](https://img.shields.io/badge/dynamic/json.svg?style=for-the-badge&url=https://raw.githubusercontent.com/TopCli/prompts/main/package.json&query=$.version&label=Version)
-  [![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg?style=for-the-badge)](https://github.com/TopCli/prompts/commit-activity)
-  [![isc](https://img.shields.io/badge/License-ISC-blue.svg?style=for-the-badge)](https://github.com/TopCli/prompts/blob/main/LICENSE)
-  [![scorecard](https://api.securityscorecards.dev/projects/github.com/TopCli/prompts/badge?style=for-the-badge)](https://ossf.github.io/scorecard-visualizer/#/projects/github.com/TopCli/prompts)
-  ![build](https://img.shields.io/github/actions/workflow/status/TopCli/prompts/node.js.yml?style=for-the-badge)
-  <img src="./public/topcli.gif" alt="demo">
-</div>
-## Requirements
-- [Node.js](https://nodejs.org/en/) v18 or higher
-## Getting Started
-This package is available in the Node Package Repository and can be easily installed with [npm](https://docs.npmjs.com/getting-started/what-is-npm) or [yarn](https://yarnpkg.com).
-```bash
-$ npm i @topcli/prompts
-# or
-$ yarn add @topcli/prompts
-```
-## Usage exemple
-You can locally run `node ./demo.js`
-```js
-import { question, confirm, select, multiselect } from "@topcli/prompts";
-const kTestRunner = ["node", "tap", "tape", "vitest", "mocha", "ava"];
-const name = await question("Project name ?", { defaultValue: "foo" });
-const runner = await select("Choose a test runner", { choices: kTestRunner, maxVisible: 5 });
-const isCLI = await confirm("Your project is a CLI ?", { initial: true });
-const os = await multiselect("Choose OS", {
-  choices: ["linux", "mac", "windows"],
-  preSelectedChoices: ["linux"]
-});
-console.log(name, runner, isCLI, os);
-```
-## API
-### `question()`
-```ts
-question(message: string, options?: PromptOptions): Promise<string>
-```
-Simple prompt, similar to `rl.question()` with an improved UI.
-Use `options.secure` if you need to hide both input and answer.
-Use `options.signal` to set an `AbortSignal` (throws a [AbortError](#aborterror)).
-Use `options.validators` to handle user input.
-**Example**
-```js
-const packageName = await question('Package name', {
-  validators: [
-    {
-      validate: (value) => {
-        if (!existsSync(join(process.cwd(), value))) {
-          return `Folder ${value} already exists`
-        }
-      }
-    }
-  ]
-});
-```
-**This package provide some validators for common usage**
-- required
-```js
-import { prompt, required } from "@topcli/prompts";
-const name = await prompt("What's your name ?", {
-  validators: [required()]
-});
-```
-### `select()`
-```ts
-select(message: string, options: SelectOptions): Promise<string>
-```
-Scrollable select depending `maxVisible` (default `8`).
-Use `ignoreValues` to skip result render & clear lines after a selected one.
-Use `validators` to handle user input.
-Use `autocomplete` to allow filtered choices. This can be useful for a large list of choices.
-Use `caseSensitive` to make autocomplete filters case sensitive. Default `false`
-Use `options.signal` to set an `AbortSignal` (throws a [AbortError](#aborterror)).
-### `multiselect()`
-```ts
-multiselect(message: string, options: MultiselectOptions): Promise<[string]>
-```
-Scrollable multiselect depending `maxVisible` (default `8`).<br>
-Use `preSelectedChoices` to pre-select choices.
-Use `validators` to handle user input.
-Use `showHint: false` to disable hint (this option is truthy by default).
-Use `autocomplete` to allow filtered choices. This can be useful for a large list of choices.
-Use `caseSensitive` to make autocomplete filters case sensitive. Default `false`.
-Use `options.signal` to set an `AbortSignal` (throws a [AbortError](#aborterror)).
-### `confirm()`
-```ts
-confirm(message: string, options?: ConfirmOptions): Promise<boolean>
-```
-Boolean prompt, default to `options.initial` (`false`).
-> [!TIP]
-> You can answer pressing <kbd>Y</kbd> or <kbd>N</kbd>
-Use `options.signal` to set an `AbortSignal` (throws a [AbortError](#aborterror)).
-### `PromptAgent`
-The `PromptAgent` class allows to programmatically set the next answers for any prompt function, this can be useful for testing.
-```ts
-const agent = PromptAgent.agent();
-agent.nextAnswer("John");
-const input = await question("What's your name?");
-assert.equal(input, "John");
-```
-> [!WARNING]
-> Answers set with `PromptAgent` will **bypass** any logical & validation rules.
-> Examples:
-> - When using `question()`, `validators` functions will not be executed.
-> - When using `select()`, the answer can be different from the available choices.
-> - When using `confirm()`, the answer can be any type other than boolean.
-> - etc<br>
-> **Use with caution**
-## Errors
-### `AbortError`
-```ts
-export class AbortError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = "AbortError";
-  }
-}
-```
-## Interfaces
-```ts
-type Stdin = NodeJS.ReadStream & {
-  fd: 0;
-};
-type Stdout = NodeJS.WriteStream & {
-  fd: 1;
-}
-export interface AbstractPromptOptions {
-  stdin?: Stdin;
-  stdout?: Stdout;
-  message: string;
-  sginal?: AbortSignal;
-}
-export interface PromptValidator<T = string | string[] | boolean> {
-    validate: (input: T) => boolean;
-    error: (input: T) => string;
-}
-export interface QuestionOptions extends SharedOptions {
-  defaultValue?: string;
-  validators?: Validator[];
-  secure?: boolean;
-}
-export interface Choice {
-  value: any;
-  label: string;
-  description?: string;
-}
-export interface SelectOptions extends SharedOptions  {
-  choices: (Choice | string)[];
-  maxVisible?: number;
-  ignoreValues?: (string | number | boolean)[];
-  validators?: Validator[];
-  autocomplete?: boolean;
-  caseSensitive?: boolean;
-}
-export interface MultiselectOptions extends SharedOptions  {
-  choices: (Choice | string)[];
-  maxVisible?: number;
-  preSelectedChoices?: (Choice | string)[];
-  validators?: Validator[];
-  autocomplete?: boolean;
-  caseSensitive?: boolean;
-  showHint?: boolean;
-}
-export interface ConfirmOptions extends SharedOptions  {
-  initial?: boolean;
-}
-```
-## Contributing
-Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
-Open an issue if you want to provide feedback such as bug reports or enchancements.
-## Contributors
-<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
-<!-- prettier-ignore-start -->
-<!-- markdownlint-disable -->
-<table>
-  <tbody>
-    <tr>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/PierreDemailly"><img src="https://avatars.githubusercontent.com/u/39910767?v=4?s=100" width="100px;" alt="PierreDemailly"/><br /><sub><b>PierreDemailly</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=PierreDemailly" title="Code">💻</a> <a href="https://github.com/TopCli/prompts/commits?author=PierreDemailly" title="Tests">⚠️</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/thomas-gentilhomme/"><img src="https://avatars.githubusercontent.com/u/4438263?v=4?s=100" width="100px;" alt="Gentilhomme"/><br /><sub><b>Gentilhomme</b></sub></a><br /><a href="https://github.com/TopCli/prompts/pulls?q=is%3Apr+reviewed-by%3Afraxken" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/TopCli/prompts/commits?author=fraxken" title="Code">💻</a> <a href="https://github.com/TopCli/prompts/commits?author=fraxken" title="Documentation">📖</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="http://tonygo.dev"><img src="https://avatars0.githubusercontent.com/u/22824417?v=4?s=100" width="100px;" alt="Tony Gorez"/><br /><sub><b>Tony Gorez</b></sub></a><br /><a href="https://github.com/TopCli/prompts/pulls?q=is%3Apr+reviewed-by%3Atony-go" title="Reviewed Pull Requests">👀</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="http://sofiand.github.io/portfolio-client/"><img src="https://avatars.githubusercontent.com/u/39944043?v=4?s=100" width="100px;" alt="Yefis"/><br /><sub><b>Yefis</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=SofianD" title="Code">💻</a> <a href="https://github.com/TopCli/prompts/commits?author=SofianD" title="Documentation">📖</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="http://justie.dev"><img src="https://avatars.githubusercontent.com/u/7118300?v=4?s=100" width="100px;" alt="Ben"/><br /><sub><b>Ben</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=JUSTIVE" title="Documentation">📖</a> <a href="#maintenance-JUSTIVE" title="Maintenance">🚧</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ncukondo"><img src="https://avatars.githubusercontent.com/u/17022138?v=4?s=100" width="100px;" alt="Takeshi Kondo"/><br /><sub><b>Takeshi Kondo</b></sub></a><br /><a href="#maintenance-ncukondo" title="Maintenance">🚧</a></td>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/FredGuiou"><img src="https://avatars.githubusercontent.com/u/99122562?v=4?s=100" width="100px;" alt="FredGuiou"/><br /><sub><b>FredGuiou</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=FredGuiou" title="Code">💻</a> <a href="https://github.com/TopCli/prompts/commits?author=FredGuiou" title="Tests">⚠️</a> <a href="https://github.com/TopCli/prompts/commits?author=FredGuiou" title="Documentation">📖</a></td>
-    </tr>
-    <tr>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/noxify"><img src="https://avatars.githubusercontent.com/u/521777?v=4?s=100" width="100px;" alt="Marcus Reinhardt"/><br /><sub><b>Marcus Reinhardt</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=noxify" title="Code">💻</a> <a href="https://github.com/TopCli/prompts/commits?author=noxify" title="Tests">⚠️</a> <a href="https://github.com/TopCli/prompts/commits?author=noxify" title="Documentation">📖</a></td>
-    </tr>
-  </tbody>
-</table>
-<!-- markdownlint-restore -->
-<!-- prettier-ignore-end -->
-<!-- ALL-CONTRIBUTORS-LIST:END -->
+<div align="center">
+  <img src="./public/banner.png" alt="@topcli/prompts">
+  ![version](https://img.shields.io/badge/dynamic/json.svg?style=for-the-badge&url=https://raw.githubusercontent.com/TopCli/prompts/main/package.json&query=$.version&label=Version)
+  [![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg?style=for-the-badge)](https://github.com/TopCli/prompts/commit-activity)
+  [![isc](https://img.shields.io/badge/License-ISC-blue.svg?style=for-the-badge)](https://github.com/TopCli/prompts/blob/main/LICENSE)
+  [![scorecard](https://api.securityscorecards.dev/projects/github.com/TopCli/prompts/badge?style=for-the-badge)](https://ossf.github.io/scorecard-visualizer/#/projects/github.com/TopCli/prompts)
+  ![build](https://img.shields.io/github/actions/workflow/status/TopCli/prompts/node.js.yml?style=for-the-badge)
+  <img src="./public/topcli.gif" alt="demo">
+</div>
+## Requirements
+- [Node.js](https://nodejs.org/en/) v20 or higher
+## Getting Started
+This package is available in the Node Package Repository and can be easily installed with [npm](https://docs.npmjs.com/getting-started/what-is-npm) or [yarn](https://yarnpkg.com).
+```bash
+$ npm i @topcli/prompts
+# or
+$ yarn add @topcli/prompts
+```
+## Usage exemple
+You can locally run `node ./demo.js`
+```js
+import { question, confirm, select, multiselect } from "@topcli/prompts";
+const kTestRunner = ["node", "tap", "tape", "vitest", "mocha", "ava"];
+const name = await question("Project name ?", { defaultValue: "foo" });
+const runner = await select("Choose a test runner", { choices: kTestRunner, maxVisible: 5 });
+const isCLI = await confirm("Your project is a CLI ?", { initial: true });
+const os = await multiselect("Choose OS", {
+  choices: ["linux", "mac", "windows"],
+  preSelectedChoices: ["linux"]
+});
+console.log(name, runner, isCLI, os);
+```
+## API
+### `question()`
+```ts
+question(message: string, options?: PromptOptions): Promise<string>
+```
+Simple prompt, similar to `rl.question()` with an improved UI.
+Use `options.defaultValue` to set a default value.
+Use `options.secure` if you need to hide both input and answer.
+Use `options.signal` to set an `AbortSignal` (throws a [AbortError](#aborterror)).
+Use `options.validators` to handle user input.
+Use `options.skip` to skip prompt. It will return `options.defaultValue` if given, `""` otherwise.
+**Example**
+```js
+const packageName = await question('Package name', {
+  validators: [
+    {
+      validate: (value) => {
+        if (!existsSync(join(process.cwd(), value))) {
+          return `Folder ${value} already exists`
+        }
+      }
+    }
+  ]
+});
+```
+**This package provide some validators for common usage**
+- required
+```js
+import { prompt, required } from "@topcli/prompts";
+const name = await prompt("What's your name ?", {
+  validators: [required()]
+});
+```
+### `select()`
+```ts
+select(message: string, options: SelectOptions): Promise<string>
+```
+Scrollable select depending `maxVisible` (default `8`).
+Use `options.ignoreValues` to skip result render & clear lines after a selected one.
+Use `options.validators` to handle user input.
+Use `options.autocomplete` to allow filtered choices. This can be useful for a large list of choices.
+Use `options.caseSensitive` to make autocomplete filters case sensitive. Default `false`
+Use `options.signal` to set an `AbortSignal` (throws a [AbortError](#aborterror)).
+Use `options.skip` to skip prompt. It will return the first choice.
+### `multiselect()`
+```ts
+multiselect(message: string, options: MultiselectOptions): Promise<[string]>
+```
+Scrollable multiselect depending `options.maxVisible` (default `8`).<br>
+Use `options.preSelectedChoices` to pre-select choices.
+Use `options.validators` to handle user input.
+Use `options.showHint: false` to disable hint (this option is truthy by default).
+Use `options.autocomplete` to allow filtered choices. This can be useful for a large list of choices.
+Use `options.caseSensitive` to make autocomplete filters case sensitive. Default `false`.
+Use `options.signal` to set an `AbortSignal` (throws a [AbortError](#aborterror)).
+Use `options.skip` to skip prompt. It will return `options.preSelectedChoices` if given, `[]` otherwise.
+### `confirm()`
+```ts
+confirm(message: string, options?: ConfirmOptions): Promise<boolean>
+```
+Boolean prompt, default to `options.initial` (`false`).
+> [!TIP]
+> You can answer pressing <kbd>Y</kbd> or <kbd>N</kbd>
+Use `options.signal` to set an `AbortSignal` (throws a [AbortError](#aborterror)).
+Use `options.skip` to skip prompt. It will return `options.initial` (`false` by default)
+### `PromptAgent`
+The `PromptAgent` class allows to programmatically set the next answers for any prompt function, this can be useful for testing.
+```ts
+const agent = PromptAgent.agent();
+agent.nextAnswer("John");
+const input = await question("What's your name?");
+assert.equal(input, "John");
+```
+> [!WARNING]
+> Answers set with `PromptAgent` will **bypass** any logical & validation rules.
+> Examples:
+> - When using `question()`, `validators` functions will not be executed.
+> - When using `select()`, the answer can be different from the available choices.
+> - When using `confirm()`, the answer can be any type other than boolean.
+> - etc<br>
+> **Use with caution**
+## Errors
+### `AbortError`
+```ts
+export class AbortError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "AbortError";
+  }
+}
+```
+## Interfaces
+```ts
+type Stdin = NodeJS.ReadStream & {
+  fd: 0;
+};
+type Stdout = NodeJS.WriteStream & {
+  fd: 1;
+}
+export interface AbstractPromptOptions {
+  stdin?: Stdin;
+  stdout?: Stdout;
+  message: string;
+  sginal?: AbortSignal;
+}
+export interface PromptValidator<T = string | string[] | boolean> {
+    validate: (input: T) => boolean;
+    error: (input: T) => string;
+}
+export interface QuestionOptions extends SharedOptions {
+  defaultValue?: string;
+  validators?: Validator[];
+  secure?: boolean;
+}
+export interface Choice {
+  value: any;
+  label: string;
+  description?: string;
+}
+export interface SelectOptions extends SharedOptions  {
+  choices: (Choice | string)[];
+  maxVisible?: number;
+  ignoreValues?: (string | number | boolean)[];
+  validators?: Validator[];
+  autocomplete?: boolean;
+  caseSensitive?: boolean;
+}
+export interface MultiselectOptions extends SharedOptions  {
+  choices: (Choice | string)[];
+  maxVisible?: number;
+  preSelectedChoices?: (Choice | string)[];
+  validators?: Validator[];
+  autocomplete?: boolean;
+  caseSensitive?: boolean;
+  showHint?: boolean;
+}
+export interface ConfirmOptions extends SharedOptions  {
+  initial?: boolean;
+}
+```
+## Contributing
+Please read [CONTRIBUTING.md](./CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.
+Open an issue if you want to provide feedback such as bug reports or enchancements.
+## Contributors
+<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
+<!-- prettier-ignore-start -->
+<!-- markdownlint-disable -->
+<table>
+  <tbody>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/PierreDemailly"><img src="https://avatars.githubusercontent.com/u/39910767?v=4?s=100" width="100px;" alt="PierreDemailly"/><br /><sub><b>PierreDemailly</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=PierreDemailly" title="Code">💻</a> <a href="https://github.com/TopCli/prompts/commits?author=PierreDemailly" title="Tests">⚠️</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/thomas-gentilhomme/"><img src="https://avatars.githubusercontent.com/u/4438263?v=4?s=100" width="100px;" alt="Gentilhomme"/><br /><sub><b>Gentilhomme</b></sub></a><br /><a href="https://github.com/TopCli/prompts/pulls?q=is%3Apr+reviewed-by%3Afraxken" title="Reviewed Pull Requests">👀</a> <a href="https://github.com/TopCli/prompts/commits?author=fraxken" title="Code">💻</a> <a href="https://github.com/TopCli/prompts/commits?author=fraxken" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://tonygo.dev"><img src="https://avatars0.githubusercontent.com/u/22824417?v=4?s=100" width="100px;" alt="Tony Gorez"/><br /><sub><b>Tony Gorez</b></sub></a><br /><a href="https://github.com/TopCli/prompts/pulls?q=is%3Apr+reviewed-by%3Atony-go" title="Reviewed Pull Requests">👀</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://sofiand.github.io/portfolio-client/"><img src="https://avatars.githubusercontent.com/u/39944043?v=4?s=100" width="100px;" alt="Yefis"/><br /><sub><b>Yefis</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=SofianD" title="Code">💻</a> <a href="https://github.com/TopCli/prompts/commits?author=SofianD" title="Documentation">📖</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="http://justie.dev"><img src="https://avatars.githubusercontent.com/u/7118300?v=4?s=100" width="100px;" alt="Ben"/><br /><sub><b>Ben</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=JUSTIVE" title="Documentation">📖</a> <a href="#maintenance-JUSTIVE" title="Maintenance">🚧</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ncukondo"><img src="https://avatars.githubusercontent.com/u/17022138?v=4?s=100" width="100px;" alt="Takeshi Kondo"/><br /><sub><b>Takeshi Kondo</b></sub></a><br /><a href="#maintenance-ncukondo" title="Maintenance">🚧</a></td>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/FredGuiou"><img src="https://avatars.githubusercontent.com/u/99122562?v=4?s=100" width="100px;" alt="FredGuiou"/><br /><sub><b>FredGuiou</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=FredGuiou" title="Code">💻</a> <a href="https://github.com/TopCli/prompts/commits?author=FredGuiou" title="Tests">⚠️</a> <a href="https://github.com/TopCli/prompts/commits?author=FredGuiou" title="Documentation">📖</a></td>
+    </tr>
+    <tr>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/noxify"><img src="https://avatars.githubusercontent.com/u/521777?v=4?s=100" width="100px;" alt="Marcus Reinhardt"/><br /><sub><b>Marcus Reinhardt</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=noxify" title="Code">💻</a> <a href="https://github.com/TopCli/prompts/commits?author=noxify" title="Tests">⚠️</a> <a href="https://github.com/TopCli/prompts/commits?author=noxify" title="Documentation">📖</a></td>
+    </tr>
+  </tbody>
+</table>
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+<!-- ALL-CONTRIBUTORS-LIST:END -->

package/dist/index.cjs CHANGED Viewed

@@ -28,8 +28,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 // index.ts
-var prompts_exports = {};
-__export(prompts_exports, {
+var index_exports = {};
+__export(index_exports, {
   PromptAgent: () => PromptAgent,
   confirm: () => confirm,
   multiselect: () => multiselect,
@@ -37,7 +37,7 @@ __export(prompts_exports, {
   required: () => required,
   select: () => select
 });
-module.exports = __toCommonJS(prompts_exports);
+module.exports = __toCommonJS(index_exports);
 // src/prompts/question.ts
 var import_node_os2 = require("os");
@@ -128,6 +128,7 @@ var AbstractPrompt = class _AbstractPrompt extends import_node_events.default {
   stdout;
   message;
   signal;
+  skip;
   history;
   agent;
   mute;
@@ -142,7 +143,8 @@ var AbstractPrompt = class _AbstractPrompt extends import_node_events.default {
       stdin: input = process.stdin,
       stdout: output = process.stdout,
       message,
-      signal
+      signal,
+      skip = false
     } = options;
     if (typeof message !== "string") {
       throw new TypeError(`message must be string, ${typeof message} given.`);
@@ -157,6 +159,7 @@ var AbstractPrompt = class _AbstractPrompt extends import_node_events.default {
     this.stdout = output;
     this.message = message;
     this.signal = signal;
+    this.skip = skip;
     this.history = [];
     this.agent = PromptAgent.agent();
     this.mute = false;
@@ -340,7 +343,11 @@ var QuestionPrompt = class extends AbstractPrompt {
     this.answerBuffer = void 0;
     this.#writeAnswer();
   }
-  question() {
+  async question() {
+    if (this.skip) {
+      this.destroy();
+      return this.defaultValue ?? "";
+    }
     return new Promise(async (resolve, reject) => {
       this.answer = this.agent.nextAnswers.shift();
       if (this.answer !== void 0) {
@@ -417,7 +424,7 @@ var ConfirmPrompt = class extends AbstractPrompt {
       process.once("exit", this.#boundExitEvent);
     });
   }
-  #onKeypress(resolve, value, key) {
+  #onKeypress(resolve, _value, key) {
     this.stdout.moveCursor(
       -this.stdout.columns,
       -Math.floor((0, import_wcwidth2.default)(stripAnsi(this.#getQuestionQuery())) / this.stdout.columns)
@@ -459,7 +466,11 @@ var ConfirmPrompt = class extends AbstractPrompt {
     this.stdout.clearScreenDown();
     this.write(`${this.selectedValue ? SYMBOLS.Tick : SYMBOLS.Cross} ${(0, import_node_util3.styleText)("bold", this.message)}${import_node_os3.EOL}`);
   }
-  confirm() {
+  async confirm() {
+    if (this.skip) {
+      this.destroy();
+      return this.initial;
+    }
     return new Promise(async (resolve, reject) => {
       const answer = this.agent.nextAnswers.shift();
       if (answer !== void 0) {
@@ -653,7 +664,12 @@ var SelectPrompt = class extends AbstractPrompt {
       render();
     }
   }
-  select() {
+  async select() {
+    if (this.skip) {
+      this.destroy();
+      const answer = this.options.choices[0];
+      return typeof answer === "string" ? answer : answer.value;
+    }
     return new Promise((resolve, reject) => {
       const answer = this.agent.nextAnswers.shift();
       if (answer !== void 0) {
@@ -773,7 +789,7 @@ var MultiselectPrompt = class extends AbstractPrompt {
   constructor(options) {
     const {
       choices,
-      preSelectedChoices,
+      preSelectedChoices = [],
       validators = [],
       showHint = true,
       ...baseOptions
@@ -797,9 +813,6 @@ var MultiselectPrompt = class extends AbstractPrompt {
         }
       }
     }
-    if (!preSelectedChoices) {
-      return;
-    }
     for (const choice of preSelectedChoices) {
       const choiceIndex = this.filteredChoices.findIndex((item) => {
         if (typeof item === "string") {
@@ -864,6 +877,25 @@ var MultiselectPrompt = class extends AbstractPrompt {
     const formattedChoice = (0, import_node_util5.styleText)("yellow", choices);
     this.write(`${prefix}${choices ? ` ${formattedChoice}` : ""}${import_node_os5.EOL}`);
   }
+  #selectedChoices() {
+    return [...this.selectedIndexes].reduce(
+      (acc, index) => {
+        const choice = this.filteredChoices[index];
+        if (typeof choice === "string") {
+          acc.values.push(choice);
+          acc.labels.push(choice);
+        } else {
+          acc.values.push(choice.value);
+          acc.labels.push(choice.label);
+        }
+        return acc;
+      },
+      {
+        values: [],
+        labels: []
+      }
+    );
+  }
   #onProcessExit() {
     this.stdin.off("keypress", this.#boundKeyPressEvent);
     this.stdout.moveCursor(-this.stdout.columns, 0);
@@ -888,14 +920,7 @@ var MultiselectPrompt = class extends AbstractPrompt {
       this.selectedIndexes = new Set([...this.selectedIndexes].filter((index) => index !== this.activeIndex));
       render();
     } else if (key.name === "return") {
-      const labels = [...this.selectedIndexes].map((index) => {
-        const choice = this.filteredChoices[index];
-        return typeof choice === "string" ? choice : choice.label;
-      });
-      const values = [...this.selectedIndexes].map((index) => {
-        const choice = this.filteredChoices[index];
-        return typeof choice === "string" ? choice : choice.value;
-      });
+      const { values, labels } = this.#selectedChoices();
       for (const validator of this.#validators) {
         const validationResult = validator.validate(values);
         if (isValid(validationResult) === false) {
@@ -923,7 +948,12 @@ var MultiselectPrompt = class extends AbstractPrompt {
       render();
     }
   }
-  multiselect() {
+  async multiselect() {
+    if (this.skip) {
+      this.destroy();
+      const { values } = this.#selectedChoices();
+      return values;
+    }
     return new Promise((resolve, reject) => {
       const answer = this.agent.nextAnswers.shift();
       if (answer !== void 0) {

package/dist/index.d.cts CHANGED Viewed

@@ -49,6 +49,7 @@ interface AbstractPromptOptions {
     stdin?: Stdin;
     stdout?: Stdout;
     message: string;
+    skip?: boolean;
     signal?: AbortSignal;
 }

package/dist/index.d.ts CHANGED Viewed

@@ -49,6 +49,7 @@ interface AbstractPromptOptions {
     stdin?: Stdin;
     stdout?: Stdout;
     message: string;
+    skip?: boolean;
     signal?: AbortSignal;
 }

package/dist/index.js CHANGED Viewed

@@ -1,16 +1,16 @@
 // src/prompts/question.ts
-import { EOL as EOL2 } from "os";
-import { styleText as styleText2 } from "util";
+import { EOL as EOL2 } from "node:os";
+import { styleText as styleText2 } from "node:util";
 import wcwidth from "@topcli/wcwidth";
 // src/prompts/abstract.ts
-import { EOL } from "os";
-import { createInterface } from "readline";
-import { Writable } from "stream";
-import EventEmitter from "events";
+import { EOL } from "node:os";
+import { createInterface } from "node:readline";
+import { Writable } from "node:stream";
+import EventEmitter from "node:events";
 // src/utils.ts
-import process2 from "process";
+import process2 from "node:process";
 var kAnsiRegex = ansiRegex();
 function ansiRegex({ onlyFirst = false } = {}) {
   const pattern = [
@@ -87,6 +87,7 @@ var AbstractPrompt = class _AbstractPrompt extends EventEmitter {
   stdout;
   message;
   signal;
+  skip;
   history;
   agent;
   mute;
@@ -101,7 +102,8 @@ var AbstractPrompt = class _AbstractPrompt extends EventEmitter {
       stdin: input = process.stdin,
       stdout: output = process.stdout,
       message,
-      signal
+      signal,
+      skip = false
     } = options;
     if (typeof message !== "string") {
       throw new TypeError(`message must be string, ${typeof message} given.`);
@@ -116,6 +118,7 @@ var AbstractPrompt = class _AbstractPrompt extends EventEmitter {
     this.stdout = output;
     this.message = message;
     this.signal = signal;
+    this.skip = skip;
     this.history = [];
     this.agent = PromptAgent.agent();
     this.mute = false;
@@ -173,7 +176,7 @@ var AbstractPrompt = class _AbstractPrompt extends EventEmitter {
 };
 // src/constants.ts
-import { styleText } from "util";
+import { styleText } from "node:util";
 var kMainSymbols = {
   tick: "\u2714",
   cross: "\u2716",
@@ -299,7 +302,11 @@ var QuestionPrompt = class extends AbstractPrompt {
     this.answerBuffer = void 0;
     this.#writeAnswer();
   }
-  question() {
+  async question() {
+    if (this.skip) {
+      this.destroy();
+      return this.defaultValue ?? "";
+    }
     return new Promise(async (resolve, reject) => {
       this.answer = this.agent.nextAnswers.shift();
       if (this.answer !== void 0) {
@@ -327,8 +334,8 @@ var QuestionPrompt = class extends AbstractPrompt {
 };
 // src/prompts/confirm.ts
-import { EOL as EOL3 } from "os";
-import { styleText as styleText3 } from "util";
+import { EOL as EOL3 } from "node:os";
+import { styleText as styleText3 } from "node:util";
 import wcwidth2 from "@topcli/wcwidth";
 var kToggleKeys = /* @__PURE__ */ new Set([
   "left",
@@ -376,7 +383,7 @@ var ConfirmPrompt = class extends AbstractPrompt {
       process.once("exit", this.#boundExitEvent);
     });
   }
-  #onKeypress(resolve, value, key) {
+  #onKeypress(resolve, _value, key) {
     this.stdout.moveCursor(
       -this.stdout.columns,
       -Math.floor(wcwidth2(stripAnsi(this.#getQuestionQuery())) / this.stdout.columns)
@@ -418,7 +425,11 @@ var ConfirmPrompt = class extends AbstractPrompt {
     this.stdout.clearScreenDown();
     this.write(`${this.selectedValue ? SYMBOLS.Tick : SYMBOLS.Cross} ${styleText3("bold", this.message)}${EOL3}`);
   }
-  confirm() {
+  async confirm() {
+    if (this.skip) {
+      this.destroy();
+      return this.initial;
+    }
     return new Promise(async (resolve, reject) => {
       const answer = this.agent.nextAnswers.shift();
       if (answer !== void 0) {
@@ -447,8 +458,8 @@ var ConfirmPrompt = class extends AbstractPrompt {
 };
 // src/prompts/select.ts
-import { EOL as EOL4 } from "os";
-import { styleText as styleText4 } from "util";
+import { EOL as EOL4 } from "node:os";
+import { styleText as styleText4 } from "node:util";
 import wcwidth3 from "@topcli/wcwidth";
 var kRequiredChoiceProperties = ["label", "value"];
 var SelectPrompt = class extends AbstractPrompt {
@@ -612,7 +623,12 @@ var SelectPrompt = class extends AbstractPrompt {
       render();
     }
   }
-  select() {
+  async select() {
+    if (this.skip) {
+      this.destroy();
+      const answer = this.options.choices[0];
+      return typeof answer === "string" ? answer : answer.value;
+    }
     return new Promise((resolve, reject) => {
       const answer = this.agent.nextAnswers.shift();
       if (answer !== void 0) {
@@ -682,8 +698,8 @@ var SelectPrompt = class extends AbstractPrompt {
 };
 // src/prompts/multiselect.ts
-import { EOL as EOL5 } from "os";
-import { styleText as styleText5 } from "util";
+import { EOL as EOL5 } from "node:os";
+import { styleText as styleText5 } from "node:util";
 import wcwidth4 from "@topcli/wcwidth";
 var kRequiredChoiceProperties2 = ["label", "value"];
 var MultiselectPrompt = class extends AbstractPrompt {
@@ -732,7 +748,7 @@ var MultiselectPrompt = class extends AbstractPrompt {
   constructor(options) {
     const {
       choices,
-      preSelectedChoices,
+      preSelectedChoices = [],
       validators = [],
       showHint = true,
       ...baseOptions
@@ -756,9 +772,6 @@ var MultiselectPrompt = class extends AbstractPrompt {
         }
       }
     }
-    if (!preSelectedChoices) {
-      return;
-    }
     for (const choice of preSelectedChoices) {
       const choiceIndex = this.filteredChoices.findIndex((item) => {
         if (typeof item === "string") {
@@ -823,6 +836,25 @@ var MultiselectPrompt = class extends AbstractPrompt {
     const formattedChoice = styleText5("yellow", choices);
     this.write(`${prefix}${choices ? ` ${formattedChoice}` : ""}${EOL5}`);
   }
+  #selectedChoices() {
+    return [...this.selectedIndexes].reduce(
+      (acc, index) => {
+        const choice = this.filteredChoices[index];
+        if (typeof choice === "string") {
+          acc.values.push(choice);
+          acc.labels.push(choice);
+        } else {
+          acc.values.push(choice.value);
+          acc.labels.push(choice.label);
+        }
+        return acc;
+      },
+      {
+        values: [],
+        labels: []
+      }
+    );
+  }
   #onProcessExit() {
     this.stdin.off("keypress", this.#boundKeyPressEvent);
     this.stdout.moveCursor(-this.stdout.columns, 0);
@@ -847,14 +879,7 @@ var MultiselectPrompt = class extends AbstractPrompt {
       this.selectedIndexes = new Set([...this.selectedIndexes].filter((index) => index !== this.activeIndex));
       render();
     } else if (key.name === "return") {
-      const labels = [...this.selectedIndexes].map((index) => {
-        const choice = this.filteredChoices[index];
-        return typeof choice === "string" ? choice : choice.label;
-      });
-      const values = [...this.selectedIndexes].map((index) => {
-        const choice = this.filteredChoices[index];
-        return typeof choice === "string" ? choice : choice.value;
-      });
+      const { values, labels } = this.#selectedChoices();
       for (const validator of this.#validators) {
         const validationResult = validator.validate(values);
         if (isValid(validationResult) === false) {
@@ -882,7 +907,12 @@ var MultiselectPrompt = class extends AbstractPrompt {
       render();
     }
   }
-  multiselect() {
+  async multiselect() {
+    if (this.skip) {
+      this.destroy();
+      const { values } = this.#selectedChoices();
+      return values;
+    }
     return new Promise((resolve, reject) => {
       const answer = this.agent.nextAnswers.shift();
       if (answer !== void 0) {

package/package.json CHANGED Viewed

@@ -1,54 +1,54 @@
-{
-  "name": "@topcli/prompts",
-  "version": "2.0.0",
-  "description": "Node.js user input library for command-line interfaces.",
-  "scripts": {
-    "build": "tsup index.ts --format cjs,esm --dts --clean",
-    "prepublishOnly": "npm run build",
-    "test": "glob -c \"tsx --no-warnings=ExperimentalWarning --loader=esmock --test\" \"./test/**/*.test.ts\"",
-    "coverage": "c8 -r html npm run test",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
-  },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "require": "./dist/index.cjs",
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "keywords": [
-    "node.js",
-    "cli",
-    "prompt"
-  ],
-  "files": [
-    "dist"
-  ],
-  "author": "PierreDemailly <pierredemailly.pro@gmail.com>",
-  "license": "ISC",
-  "type": "module",
-  "devDependencies": {
-    "@openally/config.eslint": "^1.0.0",
-    "@openally/config.typescript": "^1.0.3",
-    "@types/node": "^22.3.0",
-    "c8": "^10.1.2",
-    "esmock": "^2.6.7",
-    "glob": "^11.0.0",
-    "tsup": "^8.2.4",
-    "tsx": "^4.17.0",
-    "typescript": "^5.5.4"
-  },
-  "dependencies": {
-    "@topcli/wcwidth": "^1.0.1"
-  },
-  "engines": {
-    "node": "^20.12.0 || >=21.7.0"
-  },
-  "bugs": {
-    "url": "https://github.com/TopCli/prompts/issues"
-  },
-  "homepage": "https://github.com/TopCli/prompts#readme"
-}
+{
+  "name": "@topcli/prompts",
+  "version": "2.1.0",
+  "description": "Node.js user input library for command-line interfaces.",
+  "scripts": {
+    "build": "tsup index.ts --format cjs,esm --dts --clean",
+    "prepublishOnly": "npm run build",
+    "test": "glob -c \"tsx --no-warnings=ExperimentalWarning --loader=esmock --test\" \"./test/**/*.test.ts\"",
+    "coverage": "c8 -r html npm run test",
+    "lint": "eslint src test",
+    "lint:fix": "eslint . --fix"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "node.js",
+    "cli",
+    "prompt"
+  ],
+  "files": [
+    "dist"
+  ],
+  "author": "PierreDemailly <pierredemailly.pro@gmail.com>",
+  "license": "ISC",
+  "type": "module",
+  "devDependencies": {
+    "@openally/config.eslint": "^1.3.0",
+    "@openally/config.typescript": "^1.0.3",
+    "@types/node": "^22.10.5",
+    "c8": "^10.1.3",
+    "esmock": "^2.6.9",
+    "glob": "^11.0.0",
+    "tsup": "^8.3.5",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "dependencies": {
+    "@topcli/wcwidth": "^1.0.1"
+  },
+  "engines": {
+    "node": "^20.12.0 || >=21.7.0"
+  },
+  "bugs": {
+    "url": "https://github.com/TopCli/prompts/issues"
+  },
+  "homepage": "https://github.com/TopCli/prompts#readme"
+}