@topcli/prompts 2.4.1 → 3.0.0

package/README.md

@@ -1,275 +1,348 @@
-<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. You can provide either a **boolean** or an **object** which allows to configure a `placeholder` such as `*`.
-
-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 (fs.existsSync(path.join(process.cwd(), value))) {
-          return `Folder ${value} already exists`;
-        }
-      }
-    }
-  ]
-});
-```
-
-**This package provide some validators for common usage**
-
-- required
-
-```js
-import { question, required } from "@topcli/prompts";
-
-const name = await question("What's your name ?", {
-  validators: [required()]
-});
-```
-
-### `select()`
-
-```ts
-select<T extends string>(message: string, options: SelectOptions<T>): Promise<T>
-```
-
-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<T extends string>(message: string, options: MultiselectOptions<T>): Promise<T[]>
-```
-
-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;
-  skip?: boolean;
-  signal?: AbortSignal;
-}
-
-export interface PromptValidator<T extends string | string[]> {
-  validate: (input: T) => boolean;
-}
-
-export interface QuestionOptions extends SharedOptions {
-  defaultValue?: string;
-  validators?: PromptValidator<string>[];
-  secure?: boolean;
-}
-
-export interface Choice<T = any> {
-  value: T;
-  label: string;
-  description?: string;
-}
-
-export interface SelectOptions<T extends string> extends AbstractPromptOptions {
-  choices: (Choice<T> | T)[];
-  maxVisible?: number;
-  ignoreValues?: (T | number | boolean)[];
-  validators?: PromptValidator<string>[];
-  autocomplete?: boolean;
-  caseSensitive?: boolean;
-}
-
-export interface MultiselectOptions<T extends string> extends AbstractPromptOptions {
-  choices: (Choice<T> | T)[];
-  maxVisible?: number;
-  preSelectedChoices?: (Choice<T> | T)[];
-  validators?: PromptValidator<string[]>[];
-  autocomplete?: boolean;
-  caseSensitive?: boolean;
-  showHint?: boolean;
-}
-
-export interface ConfirmOptions extends AbstractPromptOptions {
-  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>
-      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ItsHarper"><img src="https://avatars.githubusercontent.com/u/10224994?v=4?s=100" width="100px;" alt="Harper Andrews"/><br /><sub><b>Harper Andrews</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=ItsHarper" 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/) v22 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<T = string>(message: string, options?: QuestionOptions<T>): Promise<T>
+```
+
+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. You can provide either a **boolean** or an **object** which allows to configure a `placeholder` such as `*`.
+
+Use `options.signal` to set an `AbortSignal` (throws a [AbortError](#aborterror)).
+
+Use `options.validators` to validate user input and re-prompt on failure.
+
+Use `options.transformer` to parse and validate user input in a single step, returning a typed value. **Mutually exclusive with `validators`.**
+
+Use `options.skip` to skip prompt. It will return `options.defaultValue` if given, `""` otherwise.
+
+**Validators examples**
+
+```js
+const packageName = await question('Package name', {
+  validators: [
+    {
+      validate: (value) => {
+        if (fs.existsSync(path.join(process.cwd(), value))) {
+          return `Folder ${value} already exists`;
+        }
+      }
+    }
+  ]
+});
+```
+
+Validators can also be async, for example to validate against an API:
+
+```js
+const userId = await question('User ID', {
+  validators: [
+    {
+      validate: async(userId) => {
+        const res = await fetch(`https://api.com/users/${userId}`);
+        if (!res.ok) {
+          return {
+            isValid: false,
+            error: `User '${userId}' not found`
+          }
+        }
+      }
+    }
+  ]
+});
+```
+
+**Transformers examples**
+
+```js
+import { question, transformers } from "@topcli/prompts";
+
+const port = await question("Port", { transformer: transformers.number() });
+```
+
+Custom transformer:
+
+```js
+const date = await question("Choose date (YYYY-MM-DD)", {
+  transformer: {
+    transform: (input) => {
+      const date = new Date(input);
+
+      if (isNaN(date.getTime())) {
+        return { isValid: false, error: "invalid date" };
+      }
+
+      return { isValid: true, transformed: date };
+    }
+  }
+});
+```
+
+**Built-in validators**
+
+- `validators.required()` : rejects empty input
+
+```js
+import { question, validators } from "@topcli/prompts";
+
+const name = await question("What's your name ?", {
+  validators: [validators.required()]
+});
+```
+
+**Built-in transformers**
+
+- `transformers.number()`: parses input as a number, rejects non-numeric and empty strings
+- `transformers.integer()`: parses input as an integer, rejects floats, non-numeric and empty strings
+- `transformers.url()`: parses input as a `URL` object, rejects invalid URLs
+
+```js
+import { question, transformers } from "@topcli/prompts";
+
+const count = await question("Count", { transformer: transformers.integer() });
+const url = await question("Url", { transformer: transformers.url() });
+```
+
+### `select()`
+
+```ts
+select<T extends string>(message: string, options: SelectOptions<T>): Promise<T>
+```
+
+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<T extends string>(message: string, options: MultiselectOptions<T>): Promise<T[]>
+```
+
+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;
+  skip?: boolean;
+  signal?: AbortSignal;
+}
+
+export interface PromptValidator<T extends string | string[]> {
+  validate: (input: T) => ValidationResponse | Promise<ValidationResponse>;
+}
+
+export interface PromptTransformer<T> {
+  transform: (input: string) => TransformationResponse<T> | Promise<TransformationResponse<T>>;
+}
+
+export type ValidTransformationResponse<T> = {
+  isValid: true;
+  transformed: T;
+};
+
+export type TransformationResponse<T> = InvalidResponse | ValidTransformationResponse<T>;
+
+export interface QuestionOptions<T = string> extends AbstractPromptOptions {
+  defaultValue?: string;
+  validators?: PromptValidator<string>[];
+  transformer?: PromptTransformer<T>;
+  secure?: boolean | { placeholder: string };
+}
+
+export interface Choice<T = any> {
+  value: T;
+  label: string;
+  description?: string;
+}
+
+export interface SelectOptions<T extends string> extends AbstractPromptOptions {
+  choices: (Choice<T> | T)[];
+  maxVisible?: number;
+  ignoreValues?: (T | number | boolean)[];
+  validators?: PromptValidator<string>[];
+  autocomplete?: boolean;
+  caseSensitive?: boolean;
+}
+
+export interface MultiselectOptions<T extends string> extends AbstractPromptOptions {
+  choices: (Choice<T> | T)[];
+  maxVisible?: number;
+  preSelectedChoices?: (Choice<T> | T)[];
+  validators?: PromptValidator<string[]>[];
+  autocomplete?: boolean;
+  caseSensitive?: boolean;
+  showHint?: boolean;
+}
+
+export interface ConfirmOptions extends AbstractPromptOptions {
+  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>
+      <td align="center" valign="top" width="14.28%"><a href="https://github.com/ItsHarper"><img src="https://avatars.githubusercontent.com/u/10224994?v=4?s=100" width="100px;" alt="Harper Andrews"/><br /><sub><b>Harper Andrews</b></sub></a><br /><a href="https://github.com/TopCli/prompts/commits?author=ItsHarper" title="Documentation">📖</a></td>
+    </tr>
+  </tbody>
+</table>
+
+<!-- markdownlint-restore -->
+<!-- prettier-ignore-end -->
+
+<!-- ALL-CONTRIBUTORS-LIST:END -->