npmpackage.info

Gathering detailed insights and metrics for inquirer-autocomplete-standalone

Other packages similar to inquirer-autocomplete-standalone

inquirer-autocomplete-demo

0.3.0

Simplified demo of inquirer-autocomplete-standalone prompt. Run with npx inquirer-autocomplete-demo

@ajuvercr/inquirer-autocomplete-standalone

0.8.1

Standalone autocomplete cli prompt based on inquirer core

Gathering detailed insights and metrics for inquirer-autocomplete-standalone

inquirer-autocomplete-standalone

Autocomplete prompt for inquirer

0.8.1

355

ISC

JavaScript

22.72 kB

6,406,832 2.7

Installations

npm install inquirer-autocomplete-standalone

Developer Guide

BETA

Typescript

No

Module System

ESM

Min. Node Version

>=16

Node Version

18.18.0

NPM Version

9.8.1 Score

97.9

Supply Chain

97.8

Quality

75.8

Maintenance

100

Vulnerability

99.6

License

Pull Requests

Open

6

Total

100

Closed

41

Merged

53

Issues

Open

8

Total

61

Closed

53

Releases

2.0.1 Bugfix out of order results shown

v2.0.1

Updated on Sep 25, 2023

3.0.1 Bugfix out of order results shown

v3.0.1

Updated on Sep 25, 2023

3.0.0 Support ESM and inquirer v9

v3.0.0

Updated on Sep 28, 2022

v2.0.0

Updated on Sep 28, 2022

View All 4 releases

Contributors

Unable to fetch Contributors

View All 23 Contributors

Languages

JavaScript

TypeScript

JavaScript (57.16%)

TypeScript (42.84%)

Love this project? Help keep it running — sponsor us today! 🚀

Developer

mokkabonna

Download Statistics

Total Downloads

6,406,832

Last Day

31,080

Last Week

160,643

Last Month

670,462

Last Year

5,550,174

GitHub Statistics

ISC License

355 Stars

311 Commits

80 Forks

3 Watchers

8 Branches

23 Contributors

Updated on Feb 02, 2025

Bundle Size

77.56 kB

Minified

22.72 kB

Minified + Gzipped

Bundlephobia

Maintainers

Package Meta Information

Latest Version

0.8.1

Package Id

inquirer-autocomplete-standalone@0.8.1

Unpacked Size

21.00 kB

Size

5.68 kB

File Count

NPM Version

9.8.1

Node Version

18.18.0

Published on

Oct 17, 2023

Total Downloads

Cumulative downloads

Total Downloads

6,406,832

Last Day

5.6%

31,080

Compared to previous day

Last Week

160,643

Compared to previous week

Last Month

45.3%

670,462

Compared to previous month

Last Year

547.9%

5,550,174

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

@inquirer/core @inquirer/type figures picocolors

Dev Dependencies

@inquirer/prompts @inquirer/testing

inquirer-autocomplete-standalone

Standalone autocomplete prompt for the CLI based on inquirer core.

Allows you do do show dynamic choices in a list based on user input, both synchronous or asynchronous allowing you to connect to an external service.

Installation

npm install inquirer-autocomplete-standalone

This is a native ES module package. If you are using it with commonjs you need to import it like this:

1async function main() {
2  const { default: autocomplete, Separator } = await import(
3    'inquirer-autocomplete-standalone'
4  );
5  const answer = await autocomplete({});
6}
7
8main();

If you are using it with typescript see here for examples of how to use it if emitting commonjs or esm from your typescript.

If you want the legacy version used with inquirer version 9 and below then that is located here and can be installed with:

1npm install inquirer-autocomplete-prompt

That version will still be maintained for bugs and other issues, but is not the recommended way to use this prompt. This is following the change that Inquirer itself chose. Now the preferred way is to have standalone prompts that you can pick and choose from.

Demo

Run a quick demo locally with

1npx inquirer-autocomplete-demo

Usage

1import autocomplete from 'inquirer-autocomplete-standalone';
2import { searchCountries } = './some-external-api';
3
4const answer = await autocomplete({
5  message: 'Travel from what country?',
6  source: async (input) => {
7    const filteredCountries = await searchCountries(input)
8    return filteredCountries.map(country => {
9      return {
10        value: country,
11        description: `${country} is a great place to visit`
12      }
13    })
14  }
15})
16
17// user searches and selects a country from the returned list
18console.log(answer) // Norway

Example render

Options

The generic type Value is whatever type the value of your choices are.

Property	Type	Required	Description
message	`string`	yes	The question to ask
source	`(input?: string) => Promise<Choice<Value> \| Separator> \| Choice<Value> \| Separator`	yes	A function that will be called first once with `undefined` at the start. Then later with whatever value the user has typed. See table below for full description of the `Choice<Value>` type. Can also return choices synchronous.
transformer	`(string, { isFinal: boolean }) => string`	no	Transform/Format the raw value entered by the user. Once the prompt is completed, isFinal will be true. This function is purely visual, modify the answer in your code if needed.
validate	`(value: Value) => boolean \| string \| Promise<string \| boolean>`	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.
default	`string`	no	If `suggestOnly` is `true`: will select that value if pressing enter and no input. If `false`: will select the choice with this value in the list when `source` resolves.
emptyText	`string`	no	The text shown if the source function returns no results. Default: No results...
pageSize	`number`	no	By default, lists of choice longer than 7 will be paginated. Use this option to control how many choices will appear on the screen at once.
searchText	`string`	no	The text shown when the promise is pending. Default: Searching...
suggestOnly	`boolean`	no	Default `false`. If `false` you must select one of the supplied choices in the list. You select by pressing enter. If `true`, pressing enter will select any text currently entered, regardless if of what is selected in the list. To choose one of the choices in the list, press tab to make your input the value of that choice.

Choice type and description

1type Choice<Value> = {
2  value: Value;
3  name?: string;
4  description?: string;
5  disabled?: boolean | string;
6};

Property	Type	Required	Description
value	`any`	yes	The value that will be returned from the prompt when the question has been answered. Should be `string` if name is absent. If not it is stringified for display.
name	`string`	no	The text to display for the choice.
description	`string`	no	Any extra description to show below the list when that choice is selected.
disabled	`boolean \| string`	no	Set to false to disable the choice for selection and to a string to disable it but with a custom text.

Separator

You can also render any Separator to group choices.

1import autocomplete, { Separator } from 'inquirer-autocomplete-standalone';
2
3const answer = await autocomplete({
4  message: 'Travel from what country?',
5  source: async (input) => {
6    return [
7      new Separator('Africa'),
8      new Separator(),
9      {
10        value: 'Egypt',
11      },
12      new Separator('Europe'),
13      new Separator(),
14      {
15        value: 'Norway',
16      },
17    ];
18  },
19});

? Travel from what country? (Use arrow keys or type to search)
 Africa
 ──────────────
❯ Egypt
 Europe
 ──────────────
  Norway

Credits

Martin Hansen

License

ISC

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

4

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Maintained

Determines if the project is "actively maintained".

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

License

Determines if the project has defined a license.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

2.7

/10

Last Scanned on 2025-02-03

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More