@optique/inquirer 1.3.0-dev.2468 → 1.3.0-dev.2469

package/dist/index.cjs

@@ -21,6 +21,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
+const node_process = __toESM(require("node:process"));
 const __inquirer_prompts = __toESM(require("@inquirer/prompts"));
 const __optique_core_message = __toESM(require("@optique/core/message"));
 const __optique_prompt = __toESM(require("@optique/prompt"));
@@ -64,7 +65,7 @@ function getPromptFunctions() {
 	} : defaultPromptFunctions;
 }
 /**
-* Determines whether an error came from an interrupted Inquirer prompt.
+* Determines whether an error came from an interrupted Inquirer.js prompt.
 */
 function isExitPromptError(error) {
 	return typeof error === "object" && error != null && "name" in error && error.name === "ExitPromptError";
@@ -85,35 +86,40 @@ const validPromptTypes = new Set([
 *
 * When the inner parser finds a value in the CLI arguments, that value is used
 * directly.  When no CLI value is found, an interactive prompt is shown to the
-* user.
+* user.  If the supplied signal is aborted, parsing rejects with the signal's
+* reason.
 *
 * @param parser Inner parser that reads CLI values.
 * @param config Type-safe Inquirer.js prompt configuration, or a
 *               configuration derived from dependency sources via
 *               `derivePromptConfig()`.
+* @param options Shared validation, retry, and abort options for the
+*                interactive fallback.
 * @returns A parser with interactive prompt fallback, always in async mode.
+* @throws {RangeError} If `options.maxAttempts` is not a positive integer.
 * @throws {Error} If prompt execution fails with an unexpected error or if the
 *                 inner parser throws while parsing or completing.
 * @since 1.0.0
+* @since 1.3.0 Added the `options` parameter.
 */
-function prompt(parser, config) {
+function prompt(parser, config, options) {
 	const promptWithAdapter = (0, __optique_prompt.createPromptAdapter)({
 		execute: executePromptRaw,
 		getDefaultValue: getConfigDefault
 	});
-	return promptWithAdapter(parser, config);
+	return promptWithAdapter(parser, config, options);
 }
 function getConfigDefault(config) {
 	if (config != null && typeof config === "object" && "default" in config) return config.default;
 	return void 0;
 }
-async function executePromptRaw(config) {
+async function executePromptRaw(config, context) {
 	const cfg = config;
 	const prompts = getPromptFunctions();
 	try {
 		if (!validPromptTypes.has(cfg.type)) throw new TypeError(`Unsupported prompt type: ${String(cfg.type)}.`);
 		if ("prompter" in cfg && cfg.prompter != null) {
-			const value = await cfg.prompter();
+			const value = await cfg.prompter(context);
 			if (cfg.type === "number" && value === void 0) return {
 				success: false,
 				error: __optique_core_message.message`No number provided.`
@@ -123,13 +129,15 @@ async function executePromptRaw(config) {
 				value
 			};
 		}
+		if (context.previousValidationMessage !== void 0) node_process.default.stderr.write((0, __optique_core_message.formatMessage)(context.previousValidationMessage) + "\n");
+		const inquirerContext = { ...context.signal === void 0 ? {} : { signal: context.signal } };
 		switch (cfg.type) {
 			case "confirm": return {
 				success: true,
 				value: await prompts.confirm({
 					message: cfg.message,
 					...cfg.default !== void 0 ? { default: cfg.default } : {}
-				})
+				}, inquirerContext)
 			};
 			case "number": {
 				const numResult = await prompts.number({
@@ -138,7 +146,7 @@ async function executePromptRaw(config) {
 					...cfg.min !== void 0 ? { min: cfg.min } : {},
 					...cfg.max !== void 0 ? { max: cfg.max } : {},
 					...cfg.step !== void 0 ? { step: cfg.step } : {}
-				});
+				}, inquirerContext);
 				if (numResult === void 0) return {
 					success: false,
 					error: __optique_core_message.message`No number provided.`
@@ -154,7 +162,7 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					...cfg.default !== void 0 ? { default: cfg.default } : {},
 					...cfg.validate !== void 0 ? { validate: cfg.validate } : {}
-				})
+				}, inquirerContext)
 			};
 			case "password": return {
 				success: true,
@@ -162,7 +170,7 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					...cfg.mask !== void 0 ? { mask: cfg.mask } : {},
 					...cfg.validate !== void 0 ? { validate: cfg.validate } : {}
-				})
+				}, inquirerContext)
 			};
 			case "editor": return {
 				success: true,
@@ -170,7 +178,7 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					...cfg.default !== void 0 ? { default: cfg.default } : {},
 					...cfg.validate !== void 0 ? { validate: cfg.validate } : {}
-				})
+				}, inquirerContext)
 			};
 			case "select": return {
 				success: true,
@@ -178,7 +186,7 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					choices: normalizeChoices(cfg.choices),
 					...cfg.default !== void 0 ? { default: cfg.default } : {}
-				})
+				}, inquirerContext)
 			};
 			case "rawlist": return {
 				success: true,
@@ -186,7 +194,7 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					choices: normalizeChoices(cfg.choices),
 					...cfg.default !== void 0 ? { default: cfg.default } : {}
-				})
+				}, inquirerContext)
 			};
 			case "expand": return {
 				success: true,
@@ -194,14 +202,14 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					choices: cfg.choices,
 					...cfg.default !== void 0 ? { default: cfg.default } : {}
-				})
+				}, inquirerContext)
 			};
 			case "checkbox": return {
 				success: true,
 				value: await prompts.checkbox({
 					message: cfg.message,
 					choices: normalizeChoices(cfg.choices)
-				})
+				}, inquirerContext)
 			};
 		}
 	} catch (error) {

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { Separator } from "@inquirer/prompts";
 import { FluentParser } from "@optique/core/fluent";
 import { Mode, Parser } from "@optique/core/parser";
-import { DerivePromptConfigContext, DerivePromptConfigOptions, DerivePromptConfigsContext, DerivePromptConfigsOptions, DerivedPromptConfig, DerivedPromptConfig as DerivedPromptConfig$1, PromptCondition, derivePromptConfig, isDerivedPromptConfig } from "@optique/prompt";
+import { DerivePromptConfigContext, DerivePromptConfigOptions, DerivePromptConfigsContext, DerivePromptConfigsOptions, DerivedPromptConfig, DerivedPromptConfig as DerivedPromptConfig$1, PromptCondition, PromptExecutionContext, PromptExecutionContext as PromptExecutionContext$1, PromptOptions, PromptOptions as PromptOptions$1, PromptValidator, derivePromptConfig, isDerivedPromptConfig } from "@optique/prompt";
 
 //#region src/index.d.ts
 
@@ -75,8 +75,11 @@ interface ConfirmConfig {
   readonly message: string;
   /** Default answer when the user just presses Enter. */
   readonly default?: boolean;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<boolean>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<boolean>;
 }
 /**
  * Configuration for a `number` prompt.
@@ -95,8 +98,11 @@ interface NumberPromptConfig {
   readonly max?: number;
   /** Granularity of valid values. Use `"any"` for arbitrary decimals. */
   readonly step?: number | "any";
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<number | undefined>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<number | undefined>;
 }
 /**
  * Configuration for an `input` prompt (free-text string).
@@ -111,8 +117,11 @@ interface InputConfig {
   readonly default?: string;
   /** Validation function called when the user submits. */
   readonly validate?: (value: string) => boolean | string | Promise<boolean | string>;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for a `password` prompt (masked input).
@@ -127,8 +136,11 @@ interface PasswordConfig {
   readonly mask?: boolean;
   /** Validation function called when the user submits. */
   readonly validate?: (value: string) => boolean | string | Promise<boolean | string>;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for an `editor` prompt (external editor).
@@ -143,8 +155,11 @@ interface EditorConfig {
   readonly default?: string;
   /** Validation function called when the editor is closed. */
   readonly validate?: (value: string) => boolean | string | Promise<boolean | string>;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for a `select` prompt (arrow-key single-select).
@@ -159,8 +174,11 @@ interface SelectConfig {
   readonly choices: readonly (string | Choice | Separator)[];
   /** Initially highlighted choice value. */
   readonly default?: string;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for a `rawlist` prompt (numbered list).
@@ -175,8 +193,11 @@ interface RawlistConfig {
   readonly choices: readonly (string | Choice)[];
   /** Pre-selected choice value. */
   readonly default?: string;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for an `expand` prompt (keyboard shortcut single-select).
@@ -191,8 +212,11 @@ interface ExpandConfig {
   readonly choices: readonly ExpandChoice[];
   /** Default choice key. */
   readonly default?: string;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for a `checkbox` prompt (multi-select).
@@ -205,8 +229,11 @@ interface CheckboxConfig {
   readonly message: string;
   /** Available choices. */
   readonly choices: readonly (string | CheckboxChoice | Separator)[];
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<readonly string[]>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<readonly string[]>;
 }
 /**
  * A union of all string-input prompt configurations.
@@ -239,17 +266,22 @@ type RuntimePromptConfig = ConfirmConfig | NumberPromptConfig | StringPromptConf
  *
  * When the inner parser finds a value in the CLI arguments, that value is used
  * directly.  When no CLI value is found, an interactive prompt is shown to the
- * user.
+ * user.  If the supplied signal is aborted, parsing rejects with the signal's
+ * reason.
  *
  * @param parser Inner parser that reads CLI values.
  * @param config Type-safe Inquirer.js prompt configuration, or a
  *               configuration derived from dependency sources via
  *               `derivePromptConfig()`.
+ * @param options Shared validation, retry, and abort options for the
+ *                interactive fallback.
  * @returns A parser with interactive prompt fallback, always in async mode.
+ * @throws {RangeError} If `options.maxAttempts` is not a positive integer.
  * @throws {Error} If prompt execution fails with an unexpected error or if the
  *                 inner parser throws while parsing or completing.
  * @since 1.0.0
+ * @since 1.3.0 Added the `options` parameter.
  */
-declare function prompt<M extends Mode, TValue, TState>(parser: Parser<M, TValue, TState>, config: PromptConfig<TValue> | DerivedPromptConfig$1<RuntimePromptConfig, NoInfer<TValue>>): FluentParser<"async", TValue, TState>;
+declare function prompt<M extends Mode, TValue, TState>(parser: Parser<M, TValue, TState>, config: PromptConfig<TValue> | DerivedPromptConfig$1<RuntimePromptConfig, NoInfer<TValue>>, options?: PromptOptions$1<NoInfer<TValue>>): FluentParser<"async", TValue, TState>;
 //#endregion
-export { CheckboxChoice, CheckboxConfig, Choice, ConfirmConfig, type DerivePromptConfigContext, type DerivePromptConfigOptions, type DerivePromptConfigsContext, type DerivePromptConfigsOptions, type DerivedPromptConfig, EditorConfig, ExpandChoice, ExpandConfig, InputConfig, NumberPromptConfig, PasswordConfig, PromptConfig, RawlistConfig, RuntimePromptConfig, SelectConfig, Separator, StringPromptConfig, derivePromptConfig, isDerivedPromptConfig, prompt };
+export { CheckboxChoice, CheckboxConfig, Choice, ConfirmConfig, type DerivePromptConfigContext, type DerivePromptConfigOptions, type DerivePromptConfigsContext, type DerivePromptConfigsOptions, type DerivedPromptConfig, EditorConfig, ExpandChoice, ExpandConfig, InputConfig, NumberPromptConfig, PasswordConfig, PromptConfig, type PromptExecutionContext, type PromptOptions, type PromptValidator, RawlistConfig, RuntimePromptConfig, SelectConfig, Separator, StringPromptConfig, derivePromptConfig, isDerivedPromptConfig, prompt };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { Separator } from "@inquirer/prompts";
-import { DerivePromptConfigContext, DerivePromptConfigOptions, DerivePromptConfigsContext, DerivePromptConfigsOptions, DerivedPromptConfig, DerivedPromptConfig as DerivedPromptConfig$1, PromptCondition, derivePromptConfig, isDerivedPromptConfig } from "@optique/prompt";
+import { DerivePromptConfigContext, DerivePromptConfigOptions, DerivePromptConfigsContext, DerivePromptConfigsOptions, DerivedPromptConfig, DerivedPromptConfig as DerivedPromptConfig$1, PromptCondition, PromptExecutionContext, PromptExecutionContext as PromptExecutionContext$1, PromptOptions, PromptOptions as PromptOptions$1, PromptValidator, derivePromptConfig, isDerivedPromptConfig } from "@optique/prompt";
 import { FluentParser } from "@optique/core/fluent";
 import { Mode, Parser } from "@optique/core/parser";
 
@@ -75,8 +75,11 @@ interface ConfirmConfig {
   readonly message: string;
   /** Default answer when the user just presses Enter. */
   readonly default?: boolean;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<boolean>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<boolean>;
 }
 /**
  * Configuration for a `number` prompt.
@@ -95,8 +98,11 @@ interface NumberPromptConfig {
   readonly max?: number;
   /** Granularity of valid values. Use `"any"` for arbitrary decimals. */
   readonly step?: number | "any";
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<number | undefined>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<number | undefined>;
 }
 /**
  * Configuration for an `input` prompt (free-text string).
@@ -111,8 +117,11 @@ interface InputConfig {
   readonly default?: string;
   /** Validation function called when the user submits. */
   readonly validate?: (value: string) => boolean | string | Promise<boolean | string>;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for a `password` prompt (masked input).
@@ -127,8 +136,11 @@ interface PasswordConfig {
   readonly mask?: boolean;
   /** Validation function called when the user submits. */
   readonly validate?: (value: string) => boolean | string | Promise<boolean | string>;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for an `editor` prompt (external editor).
@@ -143,8 +155,11 @@ interface EditorConfig {
   readonly default?: string;
   /** Validation function called when the editor is closed. */
   readonly validate?: (value: string) => boolean | string | Promise<boolean | string>;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for a `select` prompt (arrow-key single-select).
@@ -159,8 +174,11 @@ interface SelectConfig {
   readonly choices: readonly (string | Choice | Separator)[];
   /** Initially highlighted choice value. */
   readonly default?: string;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for a `rawlist` prompt (numbered list).
@@ -175,8 +193,11 @@ interface RawlistConfig {
   readonly choices: readonly (string | Choice)[];
   /** Pre-selected choice value. */
   readonly default?: string;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for an `expand` prompt (keyboard shortcut single-select).
@@ -191,8 +212,11 @@ interface ExpandConfig {
   readonly choices: readonly ExpandChoice[];
   /** Default choice key. */
   readonly default?: string;
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<string>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<string>;
 }
 /**
  * Configuration for a `checkbox` prompt (multi-select).
@@ -205,8 +229,11 @@ interface CheckboxConfig {
   readonly message: string;
   /** Available choices. */
   readonly choices: readonly (string | CheckboxChoice | Separator)[];
-  /** Override the prompt execution. Useful for testing. */
-  readonly prompter?: () => Promise<readonly string[]>;
+  /**
+   * Override the prompt execution. Useful for testing.
+   * @since 1.3.0 The callback receives the current attempt context.
+   */
+  readonly prompter?: (context: PromptExecutionContext$1) => Promise<readonly string[]>;
 }
 /**
  * A union of all string-input prompt configurations.
@@ -239,17 +266,22 @@ type RuntimePromptConfig = ConfirmConfig | NumberPromptConfig | StringPromptConf
  *
  * When the inner parser finds a value in the CLI arguments, that value is used
  * directly.  When no CLI value is found, an interactive prompt is shown to the
- * user.
+ * user.  If the supplied signal is aborted, parsing rejects with the signal's
+ * reason.
  *
  * @param parser Inner parser that reads CLI values.
  * @param config Type-safe Inquirer.js prompt configuration, or a
  *               configuration derived from dependency sources via
  *               `derivePromptConfig()`.
+ * @param options Shared validation, retry, and abort options for the
+ *                interactive fallback.
  * @returns A parser with interactive prompt fallback, always in async mode.
+ * @throws {RangeError} If `options.maxAttempts` is not a positive integer.
  * @throws {Error} If prompt execution fails with an unexpected error or if the
  *                 inner parser throws while parsing or completing.
  * @since 1.0.0
+ * @since 1.3.0 Added the `options` parameter.
  */
-declare function prompt<M extends Mode, TValue, TState>(parser: Parser<M, TValue, TState>, config: PromptConfig<TValue> | DerivedPromptConfig$1<RuntimePromptConfig, NoInfer<TValue>>): FluentParser<"async", TValue, TState>;
+declare function prompt<M extends Mode, TValue, TState>(parser: Parser<M, TValue, TState>, config: PromptConfig<TValue> | DerivedPromptConfig$1<RuntimePromptConfig, NoInfer<TValue>>, options?: PromptOptions$1<NoInfer<TValue>>): FluentParser<"async", TValue, TState>;
 //#endregion
-export { CheckboxChoice, CheckboxConfig, Choice, ConfirmConfig, type DerivePromptConfigContext, type DerivePromptConfigOptions, type DerivePromptConfigsContext, type DerivePromptConfigsOptions, type DerivedPromptConfig, EditorConfig, ExpandChoice, ExpandConfig, InputConfig, NumberPromptConfig, PasswordConfig, PromptConfig, RawlistConfig, RuntimePromptConfig, SelectConfig, Separator, StringPromptConfig, derivePromptConfig, isDerivedPromptConfig, prompt };
+export { CheckboxChoice, CheckboxConfig, Choice, ConfirmConfig, type DerivePromptConfigContext, type DerivePromptConfigOptions, type DerivePromptConfigsContext, type DerivePromptConfigsOptions, type DerivedPromptConfig, EditorConfig, ExpandChoice, ExpandConfig, InputConfig, NumberPromptConfig, PasswordConfig, PromptConfig, type PromptExecutionContext, type PromptOptions, type PromptValidator, RawlistConfig, RuntimePromptConfig, SelectConfig, Separator, StringPromptConfig, derivePromptConfig, isDerivedPromptConfig, prompt };

package/dist/index.js

@@ -1,5 +1,6 @@
+import process from "node:process";
 import { Separator, checkbox, confirm, editor, expand, input, number, password, rawlist, select } from "@inquirer/prompts";
-import { message } from "@optique/core/message";
+import { formatMessage, message } from "@optique/core/message";
 import { createPromptAdapter, derivePromptConfig, isDerivedPromptConfig } from "@optique/prompt";
 
 //#region src/index.ts
@@ -41,7 +42,7 @@ function getPromptFunctions() {
 	} : defaultPromptFunctions;
 }
 /**
-* Determines whether an error came from an interrupted Inquirer prompt.
+* Determines whether an error came from an interrupted Inquirer.js prompt.
 */
 function isExitPromptError(error) {
 	return typeof error === "object" && error != null && "name" in error && error.name === "ExitPromptError";
@@ -62,35 +63,40 @@ const validPromptTypes = new Set([
 *
 * When the inner parser finds a value in the CLI arguments, that value is used
 * directly.  When no CLI value is found, an interactive prompt is shown to the
-* user.
+* user.  If the supplied signal is aborted, parsing rejects with the signal's
+* reason.
 *
 * @param parser Inner parser that reads CLI values.
 * @param config Type-safe Inquirer.js prompt configuration, or a
 *               configuration derived from dependency sources via
 *               `derivePromptConfig()`.
+* @param options Shared validation, retry, and abort options for the
+*                interactive fallback.
 * @returns A parser with interactive prompt fallback, always in async mode.
+* @throws {RangeError} If `options.maxAttempts` is not a positive integer.
 * @throws {Error} If prompt execution fails with an unexpected error or if the
 *                 inner parser throws while parsing or completing.
 * @since 1.0.0
+* @since 1.3.0 Added the `options` parameter.
 */
-function prompt(parser, config) {
+function prompt(parser, config, options) {
 	const promptWithAdapter = createPromptAdapter({
 		execute: executePromptRaw,
 		getDefaultValue: getConfigDefault
 	});
-	return promptWithAdapter(parser, config);
+	return promptWithAdapter(parser, config, options);
 }
 function getConfigDefault(config) {
 	if (config != null && typeof config === "object" && "default" in config) return config.default;
 	return void 0;
 }
-async function executePromptRaw(config) {
+async function executePromptRaw(config, context) {
 	const cfg = config;
 	const prompts = getPromptFunctions();
 	try {
 		if (!validPromptTypes.has(cfg.type)) throw new TypeError(`Unsupported prompt type: ${String(cfg.type)}.`);
 		if ("prompter" in cfg && cfg.prompter != null) {
-			const value = await cfg.prompter();
+			const value = await cfg.prompter(context);
 			if (cfg.type === "number" && value === void 0) return {
 				success: false,
 				error: message`No number provided.`
@@ -100,13 +106,15 @@ async function executePromptRaw(config) {
 				value
 			};
 		}
+		if (context.previousValidationMessage !== void 0) process.stderr.write(formatMessage(context.previousValidationMessage) + "\n");
+		const inquirerContext = { ...context.signal === void 0 ? {} : { signal: context.signal } };
 		switch (cfg.type) {
 			case "confirm": return {
 				success: true,
 				value: await prompts.confirm({
 					message: cfg.message,
 					...cfg.default !== void 0 ? { default: cfg.default } : {}
-				})
+				}, inquirerContext)
 			};
 			case "number": {
 				const numResult = await prompts.number({
@@ -115,7 +123,7 @@ async function executePromptRaw(config) {
 					...cfg.min !== void 0 ? { min: cfg.min } : {},
 					...cfg.max !== void 0 ? { max: cfg.max } : {},
 					...cfg.step !== void 0 ? { step: cfg.step } : {}
-				});
+				}, inquirerContext);
 				if (numResult === void 0) return {
 					success: false,
 					error: message`No number provided.`
@@ -131,7 +139,7 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					...cfg.default !== void 0 ? { default: cfg.default } : {},
 					...cfg.validate !== void 0 ? { validate: cfg.validate } : {}
-				})
+				}, inquirerContext)
 			};
 			case "password": return {
 				success: true,
@@ -139,7 +147,7 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					...cfg.mask !== void 0 ? { mask: cfg.mask } : {},
 					...cfg.validate !== void 0 ? { validate: cfg.validate } : {}
-				})
+				}, inquirerContext)
 			};
 			case "editor": return {
 				success: true,
@@ -147,7 +155,7 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					...cfg.default !== void 0 ? { default: cfg.default } : {},
 					...cfg.validate !== void 0 ? { validate: cfg.validate } : {}
-				})
+				}, inquirerContext)
 			};
 			case "select": return {
 				success: true,
@@ -155,7 +163,7 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					choices: normalizeChoices(cfg.choices),
 					...cfg.default !== void 0 ? { default: cfg.default } : {}
-				})
+				}, inquirerContext)
 			};
 			case "rawlist": return {
 				success: true,
@@ -163,7 +171,7 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					choices: normalizeChoices(cfg.choices),
 					...cfg.default !== void 0 ? { default: cfg.default } : {}
-				})
+				}, inquirerContext)
 			};
 			case "expand": return {
 				success: true,
@@ -171,14 +179,14 @@ async function executePromptRaw(config) {
 					message: cfg.message,
 					choices: cfg.choices,
 					...cfg.default !== void 0 ? { default: cfg.default } : {}
-				})
+				}, inquirerContext)
 			};
 			case "checkbox": return {
 				success: true,
 				value: await prompts.checkbox({
 					message: cfg.message,
 					choices: normalizeChoices(cfg.choices)
-				})
+				}, inquirerContext)
 			};
 		}
 	} catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/inquirer",
-  "version": "1.3.0-dev.2468",
+  "version": "1.3.0-dev.2469",
   "description": "Inquirer.js prompt support for Optique",
   "keywords": [
     "CLI",
@@ -62,13 +62,13 @@
   "sideEffects": false,
   "dependencies": {
     "@inquirer/prompts": "^8.3.0",
-    "@optique/core": "1.3.0-dev.2468+65894aa9",
-    "@optique/prompt": "1.3.0-dev.2468+65894aa9"
+    "@optique/core": "1.3.0-dev.2469+77a16530",
+    "@optique/prompt": "1.3.0-dev.2469+77a16530"
   },
   "devDependencies": {
-    "@optique/config": "1.3.0-dev.2468+65894aa9",
-    "@optique/env": "1.3.0-dev.2468+65894aa9",
-    "@optique/run": "1.3.0-dev.2468+65894aa9",
+    "@optique/config": "1.3.0-dev.2469+77a16530",
+    "@optique/env": "1.3.0-dev.2469+77a16530",
+    "@optique/run": "1.3.0-dev.2469+77a16530",
     "@types/node": "^24.0.0",
     "fast-check": "^4.7.0",
     "tsdown": "^0.13.0",