feat: add support for signals to prompts (#340)

Author: 43081j

.changeset/mean-years-remain.md

@@ -0,0 +1,5 @@
+---
+"@clack/prompts": minor
+---
+
+Add support for signals in prompts, allowing them to be aborted.

packages/prompts/src/autocomplete.ts

@@ -83,6 +83,7 @@ export const autocomplete = <Value>(opts: AutocompleteOptions<Value>) => {
 		filter: (search: string, opt: Option<Value>) => {
 			return getFilteredOption(search, opt);
 		},
+		signal: opts.signal,
 		input: opts.input,
 		output: opts.output,
 		validate: opts.validate,
@@ -230,6 +231,7 @@ export const autocompleteMultiselect = <Value>(opts: AutocompleteMultiSelectOpti
 			return undefined;
 		},
 		initialValue: opts.initialValues,
+		signal: opts.signal,
 		input: opts.input,
 		output: opts.output,
 		render() {

packages/prompts/src/common.ts

@@ -49,4 +49,5 @@ export const symbol = (state: State) => {
 export interface CommonOptions {
 	input?: Readable;
 	output?: Writable;
+	signal?: AbortSignal;
 }

packages/prompts/src/confirm.ts

@@ -21,6 +21,7 @@ export const confirm = (opts: ConfirmOptions) => {
 	return new ConfirmPrompt({
 		active,
 		inactive,
+		signal: opts.signal,
 		input: opts.input,
 		output: opts.output,
 		initialValue: opts.initialValue ?? true,

packages/prompts/src/group-multi-select.ts

@@ -78,6 +78,7 @@ export const groupMultiselect = <Value>(opts: GroupMultiSelectOptions<Value>) =>
 
 	return new GroupMultiSelectPrompt({
 		options: opts.options,
+		signal: opts.signal,
 		input: opts.input,
 		output: opts.output,
 		initialValues: opts.initialValues,

packages/prompts/src/multi-select.ts

@@ -53,6 +53,7 @@ export const multiselect = <Value>(opts: MultiSelectOptions<Value>) => {
 
 	return new MultiSelectPrompt({
 		options: opts.options,
+		signal: opts.signal,
 		input: opts.input,
 		output: opts.output,
 		initialValues: opts.initialValues,

packages/prompts/src/password.ts

@@ -11,6 +11,7 @@ export const password = (opts: PasswordOptions) => {
 	return new PasswordPrompt({
 		validate: opts.validate,
 		mask: opts.mask ?? S_PASSWORD_MASK,
+		signal: opts.signal,
 		input: opts.input,
 		output: opts.output,
 		render() {

packages/prompts/src/select-key.ts

@@ -27,6 +27,7 @@ export const selectKey = <Value extends string>(opts: SelectOptions<Value>) => {
 
 	return new SelectKeyPrompt({
 		options: opts.options,
+		signal: opts.signal,
 		input: opts.input,
 		output: opts.output,
 		initialValue: opts.initialValue,

packages/prompts/src/select.ts

@@ -76,6 +76,7 @@ export const select = <Value>(opts: SelectOptions<Value>) => {
 
 	return new SelectPrompt({
 		options: opts.options,
+		signal: opts.signal,
 		input: opts.input,
 		output: opts.output,
 		initialValue: opts.initialValue,

packages/prompts/src/spinner.ts

@@ -35,6 +35,7 @@ export const spinner = ({
 	errorMessage,
 	frames = unicode ? ['◒', '◐', '◓', '◑'] : ['•', 'o', 'O', '0'],
 	delay = unicode ? 80 : 120,
+	signal,
 }: SpinnerOptions = {}): SpinnerResult => {
 	const isCI = isCIFn();
 
@@ -72,6 +73,10 @@ export const spinner = ({
 		process.on('SIGINT', signalEventHandler);
 		process.on('SIGTERM', signalEventHandler);
 		process.on('exit', handleExit);
+
+		if (signal) {
+			signal.addEventListener('abort', signalEventHandler);
+		}
 	};
 
 	const clearHooks = () => {
@@ -80,6 +85,10 @@ export const spinner = ({
 		process.removeListener('SIGINT', signalEventHandler);
 		process.removeListener('SIGTERM', signalEventHandler);
 		process.removeListener('exit', handleExit);
+
+		if (signal) {
+			signal.removeEventListener('abort', signalEventHandler);
+		}
 	};
 
 	const clearPrevMessage = () => {