@clack/prompts

Minor Changes

• #574 8f1c380 Thanks @dreyfus92! - Add showInstructions option to select, multiselect, and groupMultiselect. Keyboard hints remain shown by default; pass showInstructions: false to hide them.

Patch Changes

• #582 4b24953 Thanks @43081j! - Handle empty arrays in various prompts and utilities.

• Updated dependencies [4b24953]:

  • @clack/core@1.4.3

Minor Changes

• #568 f87933f Thanks @florian-lefebvre! - Updates default formatter of note() to note dim lines anymore

  If you want the old behavior, provide a format() function:

  import { note } from '@clack/prompts';
  +import { styleText } from 'node:util';
  
  note(
    'You can edit the file src/index.jsx',
    'Next steps.'
  +  { format: (text) => styleText('dim', text) }
  );

• #567 cc6aab5 Thanks @dreyfus92! - Add keyboard instruction footers to select, multiselect, and groupMultiselect in the active state, matching autocomplete. No option — always shown.

Patch Changes

• Updated dependencies [2f2b52f, e1b6ee7]:
  • @clack/core@1.4.2

Patch Changes

• 8bd9129 Thanks @gameroman! - Return type for prompts now correctly specifies CANCEL_SYMBOL instead of symbol

Minor Changes

• #543 83428ac Thanks @florian-lefebvre! - Adds support for Standard Schema validation

  Prompts accept an optional validate() function to validate user input. While a function provides more flexibility and customization over your validation, it can be a bit verbose. To help solve this, there are libraries that provide schema-based validation to make shorthand and type-strict validation substantially easier.

  Libraries following the Standard Schema specification are now natively supported. For example, using Arktype:

  import { text } from '@clack/prompts';
  import { type } from 'arktype';
  
  const name = await text({
  	message: 'Enter your email',
  +	validate: type('string.email').describe('Invalid email'),
  });

Patch Changes

• #542 adb6af9 Thanks @ghostdevv! - docs: add jsdoc for box, group, and group-multi-select

• #534 3dcb31a Thanks @MattStypa! - Fixed spaces and uppercase characters in multiline prompt

• #540 3170ed9 Thanks @ghostdevv! - docs: add jsdoc for autocomplete, confirm, and path prompts

• Updated dependencies [83428ac, 3dcb31a]:

  • @clack/core@1.4.0

Minor Changes

• #543 83428ac Thanks @florian-lefebvre! - Adds support for Standard Schema validation

  Prompts accept an optional validate() function to validate user input. While a function provides more flexibility and customization over your validation, it can be a bit verbose. To help solve this, there are libraries that provide schema-based validation to make shorthand and type-strict validation substantially easier.

  Libraries following the Standard Schema specification are now natively supported. For example, using Arktype:

  import { text } from '@clack/prompts';
  import { type } from 'arktype';
  
  const name = await text({
  	message: 'Enter your email',
  +	validate: type('string.email').describe('Invalid email'),
  });

Patch Changes

• #534 3dcb31a Thanks @MattStypa! - Fixed spaces and uppercase characters in multiline prompt

Minor Changes

• ea5702e: fix: add engines field expressing node >=20.12 requirement
• 814ab9a: Add new multiline prompt for multi-line text input.

Patch Changes

• 5b897a7: Fix mixed type-only and runtime exports from @clack/core.
• Updated dependencies [78fd3ae]
• Updated dependencies [ea5702e]
• Updated dependencies [814ab9a]
  • @clack/core@1.3.0

Minor Changes

• 9786226: Externalize fast-string-width and fast-wrap-ansi to avoid double dependencies
• 090902c: Adds date prompt with format support (YMD, MDY, DMY)

Patch Changes

• 134a1a1: Fix the path prompt so directory: true correctly enforces directory-only selection while still allowing directory navigation, and add regression tests for both directory and default file selection behavior.
• bdf89a5: Adds placeholder option to autocomplete. When the placeholder is set and the input is empty, pressing tab will set the value to placeholder.
• 336495a: Apply guide to wrapped multi-line messages in confirm prompt.
• 9fe8de6: Respect withGuide: false in autocomplete and multiselect prompts.
• 29a50cb: Fix path directory mode so pressing Enter with an existing directory initialValue submits that current directory instead of the first child option, and add regression coverage for immediate submit and child-directory navigation.
• Updated dependencies [9786226]
• Updated dependencies [bdf89a5]
• Updated dependencies [417b451]
• Updated dependencies [090902c]
  • @clack/core@1.2.0

Minor Changes

• e3333fb: Replaces picocolors with Node.js built-in styleText.

Patch Changes

• c3666e2: destruct limitOption param for better code readability, tweak types definitions
• ba3df8e: Fixes withGuide support in intro, outro, and cancel messages.
• Updated dependencies [e3333fb]
  • @clack/core@1.1.0

Patch Changes

• 6404dc1: Disallows selection of disabled options in autocomplete.
• 86e36d8: Adds withGuide support to select prompt.
• c697439: Fixes line wrapping behavior in autocomplete.
• 0ded19c: Simplifies withGuide option checks.
• 0e4ddc9: Fixes withGuide support in password and path prompts.
• 76550d6: Adds withGuide support to selectKey prompt.
• f9b9953: Adds withGuide support to password prompt.
• 0e93ccb: Adds vertical arrangement option to confirm prompt.
• 4e9ae13: Adds withGuide support to confirm prompt.
• 0256238: Adds withGuide support to spinner prompt.
• Updated dependencies [6404dc1]
• Updated dependencies [2533180]
  • @clack/core@1.0.1

Major Changes

• c713fd5: The package is now distributed as ESM-only. In v0 releases, the package was dual-published as CJS and ESM.

  For existing CJS projects using Node v20+, please see Node's guide on Loading ECMAScript modules using require().

Minor Changes

• 415410b: This adds a custom filter function to autocompleteMultiselect. It could be used, for example, to support fuzzy searching logic.

• 7bc3301: Prompts now have a userInput stored separately from their value.

• 8409f2c: feat: add styleFrame option for spinner

• 2837845: Adds suggestion and path prompts

• 99c3530: Adds format option to the note prompt to allow formatting of individual lines

• 0aaee4c: Added new taskLog prompt for log output which is cleared on success

• 729bbb6: Add support for customizable spinner cancel and error messages. Users can now customize these messages either per spinner instance or globally via the updateSettings function to support multilingual CLIs.

  This update also improves the architecture by exposing the core settings to the prompts package, enabling more consistent default message handling across the codebase.

  // Per-instance customization
  const spinner = prompts.spinner({
    cancelMessage: "Operación cancelada", // "Operation cancelled" in Spanish
    errorMessage: "Se produjo un error", // "An error occurred" in Spanish
  });
  
  // Global customization via updateSettings
  prompts.updateSettings({
    messages: {
      cancel: "Operación cancelada", // "Operation cancelled" in Spanish
      error: "Se produjo un error", // "An error occurred" in Spanish
    },
  });
  
  // Settings can now be accessed directly
  console.log(prompts.settings.messages.cancel); // "Operación cancelada"
  
  // Direct options take priority over global settings
  const spinner = prompts.spinner({
    cancelMessage: "Cancelled", // This will be used instead of the global setting
  });
  

• 44df9af: Adds a new groupSpacing option to grouped multi-select prompts. If set to an integer greater than 0, it will add that number of new lines between each group.

• 55645c2: Support wrapping autocomplete and select prompts.

• 9e5bc6c: Add support for signals in prompts, allowing them to be aborted.

• f2c2b89: Adds AutocompletePrompt to core with comprehensive tests and implement both autocomplete and autocomplete-multiselect components in prompts package.

• 38019c7: Updates the API for stopping spinners and progress bars to be clearer

  Previously, both the spinner and progress bar components used a single stop method that accepted a code to indicate success, cancellation, or error. This update separates these into distinct methods: stop(), cancel(), and error():

  const spinner = prompts.spinner();
  spinner.start();
  
  // Cancelling a spinner
  - spinner.stop(undefined, 1);
  + spinner.cancel();
  
  // Stopping with an error
  - spinner.stop(undefined, 2);
  + spinner.error();
  

  As before, you can pass a message to each method to customize the output displayed:

  spinner.cancel("Operation cancelled by user");
  progressBar.error("An error occurred during processing");
  

• c45b9fb: Adds support for detecting spinner cancellation via CTRL+C. This allows for graceful handling of user interruptions during long-running operations.

• f10071e: Using the group method, task logs can now have groups which themselves can have scrolling windows of logs.

• df4eea1: Remove suggestion prompt and change path prompt to be an autocomplete prompt.

• 76fd17f: Added new box prompt for rendering boxed text, similar a note.

• 9a09318: Adds new progress prompt to display a progess-bar

• 1604f97: Add clearOnError option to password prompt to automatically clear input when validation fails

• 9bd8072: Add a required option to autocomplete multiselect.

• 19558b9: Added support for custom frames in spinner prompt

Patch Changes

• 46dc0a4: Fixes multiselect only shows hints on the first item in the options list. Now correctly shows hints for all selected options with hint property.
• aea4573: Clamp scrolling windows to 5 rows.
• bfe0dd3: Prevents placeholder from being used as input value in text prompts
• 55eb280: Fix placeholder rendering when using autocomplete.
• 4d1d83b: Fixes rendering of multi-line messages and options in select prompt.
• 6176ced: Add withGuide support to note prompt
• 7b009df: Fix spinner clearing too many lines upwards when non-wrapping.
• 43aed55: Change styling of disabled multi-select options to have strikethrough.
• 17342d2: Exposes a new SpinnerResult type to describe the return type of spinner
• 282b39e: Wrap spinner output to allow for multi-line/wrapped messages.
• 2feaebb: Fix duplicated logs when scrolling through options with multiline messages by calculating rowPadding dynamically based on actual rendered lines instead of using a hardcoded value.
• 69681ea: Strip destructive ANSI codes from task log messages.
• b0fa7d8: Add support for wrapped messages in multi line prompts
• 9999adf: fix note component overflow bug
• 6868c1c: Adds a new selectableGroups boolean to the group multi-select prompt. Using selectableGroups: false will disable the ability to select a top-level group, but still allow every child to be selected individually.
• 7df841d: Removed all trailing space in prompt output and fixed various padding rendering bugs.
• 2839c66: fix(note): hard wrap text to column limit
• 7a556ad: Updates all prompts to accept a custom output and input stream
• 17d3650: Use a default import for picocolors to avoid run time errors in some environments.
• 7cc8a55: Messages passed to the stop method of a spinner no longer have dots stripped.
• b103ad3: Allow disabled options in multi-select and select prompts.
• 71b5029: Add missing nullish checks around values.
• 1a45f93: Switched from wrap-ansi to fast-wrap-ansi
• f952592: Fixes missing guide when rendering empty log lines.
• 372b526: Add clear method to spinner for stopping and clearing.
• d25f6d0: fix(note, box): handle CJK correctly
• 94fee2a: Changes placeholder to be a visual hint rather than a tabbable value.
• 7530af0: Fixes wrapping of cancelled and success messages of select prompt
• 4c89dd7: chore: use more accurate type to replace any in group select
• 0b852e1: Handle stop calls on spinners which have not yet been started.
• 42adff8: fix: add missing guide line in autocomplete-multiselect
• 8e2e30a: fix: fix autocomplete bar color when validate
• 2048eb1: Fix spinner's dots behavior with custom frames
• acc4c3a: Add a new withGuide option to all prompts to disable the default clack border
• 9b92161: Show symbol when withGuide is true for log messages
• 68dbf9b: select-key: Fixed wrapping and added new caseSensitive option
• 09e596c: refactor(progress): remove unnecessary return statement in start function
• 2310b43: Allow custom writables as output stream.
• ae84dd0: Update key binding text to show tab/space when navigating, and tab otherwise.
• Updated dependency on @clack/core to 1.0.0

Minor Changes

• 613179d: Adds a new indicator option to spinner, which supports the original "dots" loading animation or a new "timer" loading animation.

  import * as p from "@clack/prompts";
  
  const spin = p.spinner({ indicator: "timer" });
  spin.start("Loading");
  await sleep(3000);
  spin.stop("Loaded");
  

• a38b2bc: Adds stream API which provides the same methods as log, but for iterable (even async) message streams. This is particularly useful for AI responses which are dynamically generated by LLMs.

  import * as p from "@clack/prompts";
  
  await p.stream.step(
    (async function* () {
      yield* generateLLMResponse(question);
    })()
  );
  

Patch Changes

• 8093f3c: Adds Error support to the validate function
• 98925e3: Exports the Option type and improves JSDocannotations
• 1904e57: Replace custom utility for stripping ANSI control sequences with Node's built-in stripVTControlCharacters utility.
• Updated dependencies [8093f3c]
• Updated dependencies [e5ba09a]
• Updated dependencies [8cba8e3]
  • @clack/core@0.4.1

Minor Changes

• a83d2f8: Adds a new updateSettings() function to support new global keybindings.

  updateSettings() accepts an aliases object that maps custom keys to an action (up | down | left | right | space | enter | cancel).

  import { updateSettings } from "@clack/prompts";
  
  // Support custom keybindings
  updateSettings({
    aliases: {
      w: "up",
      a: "left",
      s: "down",
      d: "right",
    },
  });
  

[!WARNING] In order to enforce consistent, user-friendly defaults across the ecosystem, updateSettings does not support disabling Clack's default keybindings.

• 801246b: Adds a new signal option to support programmatic prompt cancellation with an abort controller.

  One example use case is automatically cancelling a prompt after a timeout.

  const shouldContinue = await confirm({
    message: "This message will self destruct in 5 seconds",
    signal: AbortSignal.timeout(5000),
  });
  

  Another use case is racing a long running task with a manual prompt.

  const abortController = new AbortController();
  
  const projectType = await Promise.race([
    detectProjectType({
      signal: abortController.signal,
    }),
    select({
      message: "Pick a project type.",
      options: [
        { value: "ts", label: "TypeScript" },
        { value: "js", label: "JavaScript" },
        { value: "coffee", label: "CoffeeScript", hint: "oh no" },
      ],
      signal: abortController.signal,
    }),
  ]);
  
  abortController.abort();
  

• a83d2f8: Updates default keybindings to support Vim motion shortcuts and map the escape key to cancel (ctrl+c).

  alias	action
  k	up
  l	right
  j	down
  h	left
  esc	cancel

Patch Changes

• f9f139d: Adapts spinner output for static CI environments
• Updated dependencies [a83d2f8]
• Updated dependencies [801246b]
• Updated dependencies [a83d2f8]
• Updated dependencies [51e12bc]
  • @clack/core@0.4.0

Patch Changes

• Updated dependencies [4845f4f]
• Updated dependencies [d7b2fb9]
  • @clack/core@0.3.5

Patch Changes

• 360afeb: feat: adaptative max items

Minor Changes

• b27a701: add maxItems option to select prompt
• 89371be: added a new method called spinner.message(msg: string)

Patch Changes

• 52183c4: Fix spinner conflict with terminal on error between spinner.start() and spinner.stop()
• ab51d29: Fixes cases where the note title length was miscalculated due to ansi characters
• Updated dependencies [cd79076]
  • @clack/core@0.3.3

Patch Changes

• c96eda5: Enable hard line-wrapping behavior for long words without spaces
• Updated dependencies [c96eda5]
  • @clack/core@0.3.2

Patch Changes

• 58a1df1: Fix line duplication bug by automatically wrapping prompts to process.stdout.columns
• Updated dependencies [58a1df1]
  • @clack/core@0.3.1

Patch Changes

• ca08fb6: Support complex value types for select, multiselect and groupMultiselect.

Minor Changes

• 8a4a12f: add groupMultiselect prompt
• 165a1b3: Add log APIs. Supports log.info, log.success, log.warn, and log.error. For low-level control, log.message is also exposed.

Patch Changes

• Updated dependencies [8a4a12f]
• Updated dependencies [8a4a12f]
  • @clack/core@0.3.0

Patch Changes

• cc11917: Update default password mask
• Updated dependencies [ec812b6]
  • @clack/core@0.2.1

Minor Changes

• d74dd05: Adds a selectKey prompt type
• 54c1bc3: Breaking Change multiselect has renamed initialValue to initialValues

Patch Changes

• Updated dependencies [d74dd05]
• Updated dependencies [54c1bc3]
  • @clack/core@0.2.0

Patch Changes

• 1251132: Multiselect: return Value[] instead of Option[].
• 8994382: Add a password prompt to @clack/prompts
• Updated dependencies [1251132]
• Updated dependencies [8994382]
  • @clack/core@0.1.9

Patch Changes

• d96071c: Don't mutate initialValue in multiselect, fix parameter type for validate().

  Credits to @banjo for the bug report and initial PR!

• Updated dependencies [d96071c]

  • @clack/core@0.1.8

Patch Changes

• 83d890e: Fix text cancel display bug

Patch Changes

• Update README

Patch Changes

• 7fb5375: Adds a new defaultValue option to the text prompt, removes automatic usage of the placeholder value.
• Updated dependencies [7fb5375]
  • @clack/core@0.1.6

Minor Changes

• 61b88b6: Add group construct to group many prompts together

Patch Changes

• de1314e: Support required option for multi-select
• Updated dependencies [de1314e]
  • @clack/core@0.1.5

Minor Changes

• 493c592: Improve types for select/multiselect prompts. Numbers and booleans are now supported as the value option.
• 15558e3: Improved Windows/non-unicode support

Patch Changes

• ca77da1: Fix multiselect initial value logic
• Updated dependencies [ca77da1]
• Updated dependencies [8aed606]
  • @clack/core@0.1.4

Patch Changes

• 94b24d9: Fix CJS ansi-regex interop

Patch Changes

• a99c458: Support initialValue option for text prompt
• Updated dependencies [a99c458]
  • @clack/core@0.1.3

Minor Changes

• Improved type safety
• b1341d6: Updated styles, new note component

Patch Changes

• Updated dependencies [7dcad8f]
• Updated dependencies [2242f13]
• Updated dependencies [b1341d6]
  • @clack/core@0.1.2

Patch Changes

• fa09bf5: Use circle for radio, square for checkbox
• Updated dependencies [4be7dbf]
• Updated dependencies [b480679]
  • @clack/core@0.1.1

Minor Changes

• 7015ec9: Create new prompt: multi-select

Patch Changes

• Updated dependencies [7015ec9]
  • @clack/core@0.1.0

Patch Changes

• e0b49e5: Update spinner so it actually spins

Patch Changes

• Update README

Patch Changes

• Updated dependencies [9d371c3]
  • @clack/core@0.0.12

Patch Changes

• Update README

Patch Changes

• d20ef2a: Update keywords, URLs
• Updated dependencies [441d5b7]
• Updated dependencies [d20ef2a]
• Updated dependencies [fe13c2f]
  • @clack/core@0.0.11

Patch Changes

• Update README

Patch Changes

• 80404ab: Update README

Patch Changes

• a0cb382: Add main entrypoint
• Updated dependencies [a0cb382]
  • @clack/core@0.0.10

Patch Changes

• Updated dependencies
  • @clack/core@0.0.9

Patch Changes

• a4b5e13: Initial release
• Updated dependencies [a4b5e13]
  • @clack/core@0.0.8