hjw 6c42b6a025 first commit 1 week ago
..
dist 6c42b6a025 first commit 1 week ago
LICENSE 6c42b6a025 first commit 1 week ago
README.md 6c42b6a025 first commit 1 week ago
package.json 6c42b6a025 first commit 1 week ago

README.md

@inquirer/number

Interactive free number input component for command line interfaces. Supports validation, filtering, transformation, etc.

Special Thanks

[![Graphite](https://github.com/user-attachments/assets/53db40ca-2254-481a-a094-6597f8716e)](https://graphite.dev/?utm_source=npmjs&utm_medium=repo&utm_campaign=inquirerjs)
### [Graphite is the AI developer productivity platform helping teams on GitHub ship higher quality software, faster](https://graphite.dev/?utm_source=npmjs&utm_medium=repo&utm_campaign=inquirerjs)

Installation

npm yarn
```sh npm install @inquirer/prompts ``` ```sh yarn add @inquirer/prompts ```
Or
```sh npm install @inquirer/number ``` ```sh yarn add @inquirer/number ```

Usage

import { number } from '@inquirer/prompts';
// Or
// import number from '@inquirer/number';

const answer = await number({ message: 'Enter your age' });

Options

Property Type Required Description
message string yes The question to ask
default number no Default value if no answer is provided (clear it by pressing backspace)
min number no The minimum value to accept for this input.
max number no The maximum value to accept for this input.
step number \| 'any' no The step option is a number that specifies the granularity that the value must adhere to. Only values which are equal to the basis for stepping (min if specified) are valid. This value defaults to 1, meaning by default the prompt will only allow integers.
required boolean no Defaults to false. If set to true, undefined (empty) will not be accepted for this.
validate (number \| undefined) => boolean \| string \| Promise<boolean \| string> no On submit, validate the filtered answered content. When returning a string, it'll be used as the error message displayed to the user. Note: returning a rejected promise, we'll assume a code error happened and crash.
theme See Theming no Customize look of the prompt.

Theming

You can theme a prompt by passing a theme object option. The theme object only need to includes the keys you wish to modify, we'll fallback on the defaults for the rest.

type Theme = {
  prefix: string | { idle: string; done: string };
  spinner: {
    interval: number;
    frames: string[];
  };
  style: {
    answer: (text: string) => string;
    message: (text: string, status: 'idle' | 'done' | 'loading') => string;
    error: (text: string) => string;
    defaultAnswer: (text: string) => string;
  };
};

License

Copyright (c) 2023 Simon Boudrias (twitter: @vaxilart)
Licensed under the MIT license.