@shell-shock/plugin-prompts 0.3.0 → 0.3.2

package/dist/components/index.cjs

@@ -7,4 +7,5 @@ exports.PasswordPromptDeclaration = require_components_prompts_builtin.PasswordP
 exports.PromptsBuiltin = require_components_prompts_builtin.PromptsBuiltin;
 exports.SelectPromptDeclarations = require_components_prompts_builtin.SelectPromptDeclarations;
 exports.TextPromptDeclarations = require_components_prompts_builtin.TextPromptDeclarations;
-exports.TogglePromptDeclarations = require_components_prompts_builtin.TogglePromptDeclarations;
+exports.TogglePromptDeclarations = require_components_prompts_builtin.TogglePromptDeclarations;
+exports.WaitForKeyPressDeclaration = require_components_prompts_builtin.WaitForKeyPressDeclaration;

package/dist/components/index.d.cts

@@ -1,2 +1,2 @@
-import { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations } from "./prompts-builtin.cjs";
-export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations };
+import { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations, WaitForKeyPressDeclaration } from "./prompts-builtin.cjs";
+export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations, WaitForKeyPressDeclaration };

package/dist/components/index.d.mts

@@ -1,2 +1,2 @@
-import { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations } from "./prompts-builtin.mjs";
-export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations };
+import { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations, WaitForKeyPressDeclaration } from "./prompts-builtin.mjs";
+export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations, WaitForKeyPressDeclaration };

package/dist/components/index.mjs

@@ -1,3 +1,3 @@
-import { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations } from "./prompts-builtin.mjs";
+import { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations, WaitForKeyPressDeclaration } from "./prompts-builtin.mjs";
 
-export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations };
+export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations, WaitForKeyPressDeclaration };

package/dist/components/prompts-builtin.cjs

@@ -369,21 +369,21 @@ function BasePromptDeclarations() {
 					}),
 					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_class_declaration.ClassField, {
-						name: "validator",
+						name: "validate",
 						"protected": true,
 						type: "(value: TValue) => boolean | string | null | undefined | Promise<boolean | string | null | undefined>",
 						children: __alloy_js_core.code`() => true; `
 					}),
 					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_class_declaration.ClassField, {
-						name: "parser",
+						name: "parse",
 						"protected": true,
 						type: "PromptParser<TValue>",
 						children: __alloy_js_core.code`(value: string) => value as TValue; `
 					}),
 					(0, __alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_class_declaration.ClassField, {
-						name: "formatter",
+						name: "format",
 						"protected": true,
 						type: "PromptFormatter<TValue>",
 						children: __alloy_js_core.code`(value: TValue) => String(value); `
@@ -440,13 +440,13 @@ function BasePromptDeclarations() {
             this.description = config.description;
           }
           if (config.validate) {
-            this.validator = config.validate;
+            this.validate = config.validate;
           }
           if (config.parse) {
-            this.parser = config.parse.bind(this);
+            this.parse = config.parse.bind(this);
           }
           if (config.format) {
-            this.formatter = config.format.bind(this);
+            this.format = config.format.bind(this);
           }
 
           if (config.maskCompleted) {
@@ -516,7 +516,7 @@ function BasePromptDeclarations() {
 						"protected": true,
 						name: "isPlaceholder",
 						type: "boolean",
-						children: __alloy_js_core.code`return (this.displayValue === this.formatter(this.parser(this.initialValue)) && !this.#isDirty) || !this.#isKeyPressed; `
+						children: __alloy_js_core.code`return (this.displayValue === this.format(this.initialValue) && !this.#isDirty) || !this.#isKeyPressed; `
 					}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_class_declaration.ClassPropertyGet, {
@@ -569,7 +569,7 @@ function BasePromptDeclarations() {
             updatedValue = value;
           }
 
-          this.displayValue = this.mask(this.formatter(updatedValue));
+          this.displayValue = this.mask(this.format(updatedValue));
           this.#value = updatedValue;
 
           if (!this.#isDirty && this.#value !== this.initialValue) {
@@ -578,7 +578,7 @@ function BasePromptDeclarations() {
 
           this.onChange(previousValue);
           setTimeout(() => {
-            Promise.resolve(this.validate(updatedValue)).then(() => this.sync());
+            Promise.resolve(this.checkValidations(updatedValue)).then(() => this.sync());
           }, 0);
 
           this.sync(); `
@@ -675,14 +675,14 @@ function BasePromptDeclarations() {
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_class_declaration.ClassMethod, {
 						doc: "A method to validate the prompt input using the provided validator function, which updates the error message and error state based on the validation result. This method is called whenever the prompt value changes and needs to be validated.",
-						name: "validate",
+						name: "checkValidations",
 						async: true,
 						"protected": true,
 						parameters: [{
 							name: "value",
 							type: "TValue"
 						}],
-						children: __alloy_js_core.code`let result = await this.validator(value);
+						children: __alloy_js_core.code`let result = await this.validate(value);
           if (typeof result === "string") {
             this.errorMessage = result;
           } else if (typeof result === "boolean") {
@@ -759,11 +759,11 @@ function BasePromptDeclarations() {
             return this.bell();
           }
 
-          this.changeValue(\`\${
+          this.changeValue(this.parse(\`\${
             this.displayValue.slice(0, this.cursor - 1)
           }\${
             this.displayValue.slice(this.cursor)
-          }\`);
+          }\`));
 
           if (this.isCursorAtStart) {
             this.cursorOffset = 0;
@@ -783,11 +783,11 @@ function BasePromptDeclarations() {
             return this.bell();
           }
 
-          this.changeValue(\`\${
+          this.changeValue(this.parse(\`\${
             this.displayValue.slice(0, this.cursor)
           }\${
             this.displayValue.slice(this.cursor + 1)
-          }\`);
+          }\`));
 
           if (this.isCursorAtEnd) {
             this.cursorOffset = 0;
@@ -833,7 +833,7 @@ function BasePromptDeclarations() {
 						children: __alloy_js_core.code`this.cursorOffset = 0;
           this.cursor = this.displayValue.length;
 
-          await this.validate(this.value);
+          await this.checkValidations(this.value);
           if (this.isError) {
             this.sync();
             this.bell();
@@ -1084,7 +1084,7 @@ function TextPromptDeclarations() {
 						"protected": true,
 						parameters: [{
 							name: "previousValue",
-							type: "TValue"
+							type: "string"
 						}],
 						children: __alloy_js_core.code`this.#isInvalid = false;
           this.cursor = this.displayValue.slice(0, this.cursor).length + 1; `
@@ -1101,11 +1101,11 @@ function TextPromptDeclarations() {
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_class_declaration.ClassMethod, {
 						doc: "A method to validate the prompt input",
-						name: "validate",
+						name: "checkValidations",
 						override: true,
 						async: true,
 						"protected": true,
-						children: __alloy_js_core.code`await super.validate(this.value);
+						children: __alloy_js_core.code`await super.checkValidations(this.value);
           this.#isInvalid = this.isError; `
 					}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
@@ -1834,17 +1834,17 @@ function NumericPromptDeclarations() {
           }
 
           if (config.parse) {
-            this.parser = config.parse.bind(this);
+            this.parse = config.parse.bind(this);
           } else {
-            const parser = (value: string) => this.isFloat ? Math.round(Math.pow(10, this.precision) * Number.parseFloat(value)) / Math.pow(10, this.precision) : Number.parseInt(value);
-            this.parser = parser.bind(this);
+            const parse = (value: string) => this.isFloat ? Math.round(Math.pow(10, this.precision) * Number.parseFloat(value)) / Math.pow(10, this.precision) : Number.parseInt(value);
+            this.parse = parse.bind(this);
           }
 
           if (config.validate) {
-            this.validator = config.validate.bind(this);
+            this.validate = config.validate.bind(this);
           } else {
-            const validator = (value: number) => !Number.isNaN(value) && value >= this.min && value <= this.max;
-            this.validator = validator.bind(this);
+            const validate = (value: number) => !Number.isNaN(value) && value >= this.min && value <= this.max;
+            this.validate = validate.bind(this);
           }
 
           this.changeValue(this.initialValue);
@@ -1880,7 +1880,7 @@ function NumericPromptDeclarations() {
             this.displayValue.slice(this.cursor)
           }\`;
 
-          let value = this.parser(displayValue);
+          let value = this.parse(displayValue);
           if (!Number.isNaN(value)) {
 
             value = Math.min(value, this.max);
@@ -1903,7 +1903,7 @@ function NumericPromptDeclarations() {
 						"protected": true,
 						parameters: [{
 							name: "previousValue",
-							type: "TValue"
+							type: "number"
 						}],
 						children: __alloy_js_core.code`this.#isInvalid = false;
           this.cursor = this.displayValue.slice(0, this.cursor).length + 1; `
@@ -1911,11 +1911,11 @@ function NumericPromptDeclarations() {
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_class_declaration.ClassMethod, {
 						doc: "A method to validate the prompt input",
-						name: "validate",
+						name: "checkValidations",
 						override: true,
 						async: true,
 						"protected": true,
-						children: __alloy_js_core.code`await super.validate(this.value);
+						children: __alloy_js_core.code`await super.checkValidations(this.value);
           this.#isInvalid = this.isError; `
 					}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
@@ -2501,16 +2501,14 @@ function ConfirmPromptDeclarations() {
           }
 
           if (char.toLowerCase() === "y" || char.toLowerCase() === "t" || char.toLowerCase() === "0") {
-            this.value = true;
+            this.changeValue(true);
             return this.submit();
           } else if (char.toLowerCase() === "n" || char.toLowerCase() === "f" || char.toLowerCase() === "1") {
-            this.value = false;
+            this.changeValue(false);
             return this.submit();
           } else {
             return this.bell();
-          }
-
-          this.sync(); `
+          } `
 					}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 					(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_class_declaration.ClassMethod, {
@@ -2652,6 +2650,50 @@ run(); ` }),
 		})
 	];
 }
+function WaitForKeyPressDeclaration() {
+	return [(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDoc, {
+		heading: "A function to create and run a wait-for-key-press prompt, which returns a promise that resolves when any key is pressed or rejects with a {@link CANCEL_SYMBOL | cancel symbol} if the prompt is cancelled.",
+		get children() {
+			return [
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocRemarks, { children: __alloy_js_core.code`This function creates an instance of the Prompt class with a custom onKeyPress handler that resolves the promise when any key is pressed. It sets up event listeners for state updates and cancellation to handle the prompt interactions and return the appropriate results. The wait-for-key-press prompt is useful for scenarios where you want to pause execution until the user presses any key, such as waiting for user input before proceeding with a task.` }),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocExample, { children: `import { waitForKeyPress } from "shell-shock:prompts";
+
+async function run() {
+  const result = await waitForKeyPress();
+  console.log("A key was pressed!");
+}
+
+run(); ` }),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocParam, {
+					name: "timeout",
+					children: `The amount of time in milliseconds to wait before automatically resolving the prompt, defaults to 2 hours (7200000 ms)`
+				}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: `A promise that resolves when any key is pressed` })
+			];
+		}
+	}), (0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_typescript.FunctionDeclaration, {
+		name: "waitForKeyPress",
+		"export": true,
+		parameters: [{
+			name: "timeout",
+			default: "7200000"
+		}],
+		children: __alloy_js_core.code`process.stdin.setRawMode(true);
+        return new Promise(resolve => process.stdin.once("data", () => {
+          if (timeout >= 0) {
+            setTimeout(() => {
+              process.stdin.setRawMode(false);
+              resolve(void 0);
+            }, timeout);
+          }
+
+          process.stdin.setRawMode(false);
+          resolve(void 0);
+        })); `
+	})];
+}
 /**
 * A built-in prompts module for Shell Shock.
 */
@@ -2705,6 +2747,8 @@ function PromptsBuiltin(props) {
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(ConfirmPromptDeclarations, {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(WaitForKeyPressDeclaration, {}),
+				(0, __alloy_js_core_jsx_runtime.createComponent)(__powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, __alloy_js_core_jsx_runtime.createComponent)(__alloy_js_core.Show, {
 					get when() {
 						return Boolean(children);
@@ -2724,4 +2768,5 @@ exports.PasswordPromptDeclaration = PasswordPromptDeclaration;
 exports.PromptsBuiltin = PromptsBuiltin;
 exports.SelectPromptDeclarations = SelectPromptDeclarations;
 exports.TextPromptDeclarations = TextPromptDeclarations;
-exports.TogglePromptDeclarations = TogglePromptDeclarations;
+exports.TogglePromptDeclarations = TogglePromptDeclarations;
+exports.WaitForKeyPressDeclaration = WaitForKeyPressDeclaration;

package/dist/components/prompts-builtin.d.cts

@@ -31,10 +31,11 @@ declare function ConfirmPromptDeclarations(): _alloy_js_core0.Children;
  * Declarations for a password prompt that allows users to input and edit text, with support for cursor movement, deletion, and custom masking. This prompt type can be used for various text input scenarios, such as entering a password or any other string input. The PasswordPrompt class extends the base Prompt class and implements specific logic for handling password input and editing interactions.
  */
 declare function PasswordPromptDeclaration(): _alloy_js_core0.Children;
+declare function WaitForKeyPressDeclaration(): _alloy_js_core0.Children;
 /**
  * A built-in prompts module for Shell Shock.
  */
 declare function PromptsBuiltin(props: PromptsBuiltinProps): _alloy_js_core0.Children;
 //#endregion
-export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations };
+export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations, WaitForKeyPressDeclaration };
 //# sourceMappingURL=prompts-builtin.d.cts.map

package/dist/components/prompts-builtin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts-builtin.d.cts","names":[],"sources":["../../src/components/prompts-builtin.tsx"],"sourcesContent":[],"mappings":";;;;UA8CiB,mBAAA,SAA4B,KAC3C;;AADF;AAQA;AA21BgB,iBA31BA,sBAAA,CAAA,CA21BsB,EA31BA,eAAA,CAAA,QA21BA;AAoPtC;AAobA;AAyVA;AA4OgB,iBA7uCA,sBAAA,CAAA,CA6uCyB,EA7uCH,eAAA,CAAA,QA6uCG;AA8LzC;AAsEA;;iBA7vCgB,wBAAA,CAAA,GAAwB,eAAA,CAAA;;;;iBAobxB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBAyVzB,wBAAA,CAAA,GAAwB,eAAA,CAAA;;;;iBA4OxB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBA8LzB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBAsEzB,cAAA,QAAsB,sBAAmB,eAAA,CAAA"}
+{"version":3,"file":"prompts-builtin.d.cts","names":[],"sources":["../../src/components/prompts-builtin.tsx"],"sourcesContent":[],"mappings":";;;;UA8CiB,mBAAA,SAA4B,KAC3C;;AADF;AAQA;AA21BgB,iBA31BA,sBAAA,CAAA,CA21BsB,EA31BA,eAAA,CAAA,QA21BA;AAoPtC;AAobA;AAyVA;AA4OgB,iBA7uCA,sBAAA,CAAA,CA6uCyB,EA7uCH,eAAA,CAAA,QA6uCG;AA4LzC;AAmEA;AAuDA;iBA/yCgB,wBAAA,CAAA,GAAwB,eAAA,CAAA;;;;iBAobxB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBAyVzB,wBAAA,CAAA,GAAwB,eAAA,CAAA;;;;iBA4OxB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBA4LzB,yBAAA,CAAA,GAAyB,eAAA,CAAA;iBAmEzB,0BAAA,CAAA,GAA0B,eAAA,CAAA;;;;iBAuD1B,cAAA,QAAsB,sBAAmB,eAAA,CAAA"}

package/dist/components/prompts-builtin.d.mts

@@ -31,10 +31,11 @@ declare function ConfirmPromptDeclarations(): _alloy_js_core0.Children;
  * Declarations for a password prompt that allows users to input and edit text, with support for cursor movement, deletion, and custom masking. This prompt type can be used for various text input scenarios, such as entering a password or any other string input. The PasswordPrompt class extends the base Prompt class and implements specific logic for handling password input and editing interactions.
  */
 declare function PasswordPromptDeclaration(): _alloy_js_core0.Children;
+declare function WaitForKeyPressDeclaration(): _alloy_js_core0.Children;
 /**
  * A built-in prompts module for Shell Shock.
  */
 declare function PromptsBuiltin(props: PromptsBuiltinProps): _alloy_js_core0.Children;
 //#endregion
-export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations };
+export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, PromptsBuiltinProps, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations, WaitForKeyPressDeclaration };
 //# sourceMappingURL=prompts-builtin.d.mts.map

package/dist/components/prompts-builtin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts-builtin.d.mts","names":[],"sources":["../../src/components/prompts-builtin.tsx"],"sourcesContent":[],"mappings":";;;;UA8CiB,mBAAA,SAA4B,KAC3C;;AADF;AAQA;AA21BgB,iBA31BA,sBAAA,CAAA,CA21BsB,EA31BA,eAAA,CAAA,QA21BA;AAoPtC;AAobA;AAyVA;AA4OgB,iBA7uCA,sBAAA,CAAA,CA6uCyB,EA7uCH,eAAA,CAAA,QA6uCG;AA8LzC;AAsEA;;iBA7vCgB,wBAAA,CAAA,GAAwB,eAAA,CAAA;;;;iBAobxB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBAyVzB,wBAAA,CAAA,GAAwB,eAAA,CAAA;;;;iBA4OxB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBA8LzB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBAsEzB,cAAA,QAAsB,sBAAmB,eAAA,CAAA"}
+{"version":3,"file":"prompts-builtin.d.mts","names":[],"sources":["../../src/components/prompts-builtin.tsx"],"sourcesContent":[],"mappings":";;;;UA8CiB,mBAAA,SAA4B,KAC3C;;AADF;AAQA;AA21BgB,iBA31BA,sBAAA,CAAA,CA21BsB,EA31BA,eAAA,CAAA,QA21BA;AAoPtC;AAobA;AAyVA;AA4OgB,iBA7uCA,sBAAA,CAAA,CA6uCyB,EA7uCH,eAAA,CAAA,QA6uCG;AA4LzC;AAmEA;AAuDA;iBA/yCgB,wBAAA,CAAA,GAAwB,eAAA,CAAA;;;;iBAobxB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBAyVzB,wBAAA,CAAA,GAAwB,eAAA,CAAA;;;;iBA4OxB,yBAAA,CAAA,GAAyB,eAAA,CAAA;;;;iBA4LzB,yBAAA,CAAA,GAAyB,eAAA,CAAA;iBAmEzB,0BAAA,CAAA,GAA0B,eAAA,CAAA;;;;iBAuD1B,cAAA,QAAsB,sBAAmB,eAAA,CAAA"}

package/dist/components/prompts-builtin.mjs

@@ -367,21 +367,21 @@ function BasePromptDeclarations() {
 					}),
 					createIntrinsic("hbr", {}),
 					createComponent(ClassField, {
-						name: "validator",
+						name: "validate",
 						"protected": true,
 						type: "(value: TValue) => boolean | string | null | undefined | Promise<boolean | string | null | undefined>",
 						children: code`() => true; `
 					}),
 					createIntrinsic("hbr", {}),
 					createComponent(ClassField, {
-						name: "parser",
+						name: "parse",
 						"protected": true,
 						type: "PromptParser<TValue>",
 						children: code`(value: string) => value as TValue; `
 					}),
 					createIntrinsic("hbr", {}),
 					createComponent(ClassField, {
-						name: "formatter",
+						name: "format",
 						"protected": true,
 						type: "PromptFormatter<TValue>",
 						children: code`(value: TValue) => String(value); `
@@ -438,13 +438,13 @@ function BasePromptDeclarations() {
             this.description = config.description;
           }
           if (config.validate) {
-            this.validator = config.validate;
+            this.validate = config.validate;
           }
           if (config.parse) {
-            this.parser = config.parse.bind(this);
+            this.parse = config.parse.bind(this);
           }
           if (config.format) {
-            this.formatter = config.format.bind(this);
+            this.format = config.format.bind(this);
           }
 
           if (config.maskCompleted) {
@@ -514,7 +514,7 @@ function BasePromptDeclarations() {
 						"protected": true,
 						name: "isPlaceholder",
 						type: "boolean",
-						children: code`return (this.displayValue === this.formatter(this.parser(this.initialValue)) && !this.#isDirty) || !this.#isKeyPressed; `
+						children: code`return (this.displayValue === this.format(this.initialValue) && !this.#isDirty) || !this.#isKeyPressed; `
 					}),
 					createComponent(Spacing, {}),
 					createComponent(ClassPropertyGet, {
@@ -567,7 +567,7 @@ function BasePromptDeclarations() {
             updatedValue = value;
           }
 
-          this.displayValue = this.mask(this.formatter(updatedValue));
+          this.displayValue = this.mask(this.format(updatedValue));
           this.#value = updatedValue;
 
           if (!this.#isDirty && this.#value !== this.initialValue) {
@@ -576,7 +576,7 @@ function BasePromptDeclarations() {
 
           this.onChange(previousValue);
           setTimeout(() => {
-            Promise.resolve(this.validate(updatedValue)).then(() => this.sync());
+            Promise.resolve(this.checkValidations(updatedValue)).then(() => this.sync());
           }, 0);
 
           this.sync(); `
@@ -673,14 +673,14 @@ function BasePromptDeclarations() {
 					createComponent(Spacing, {}),
 					createComponent(ClassMethod, {
 						doc: "A method to validate the prompt input using the provided validator function, which updates the error message and error state based on the validation result. This method is called whenever the prompt value changes and needs to be validated.",
-						name: "validate",
+						name: "checkValidations",
 						async: true,
 						"protected": true,
 						parameters: [{
 							name: "value",
 							type: "TValue"
 						}],
-						children: code`let result = await this.validator(value);
+						children: code`let result = await this.validate(value);
           if (typeof result === "string") {
             this.errorMessage = result;
           } else if (typeof result === "boolean") {
@@ -757,11 +757,11 @@ function BasePromptDeclarations() {
             return this.bell();
           }
 
-          this.changeValue(\`\${
+          this.changeValue(this.parse(\`\${
             this.displayValue.slice(0, this.cursor - 1)
           }\${
             this.displayValue.slice(this.cursor)
-          }\`);
+          }\`));
 
           if (this.isCursorAtStart) {
             this.cursorOffset = 0;
@@ -781,11 +781,11 @@ function BasePromptDeclarations() {
             return this.bell();
           }
 
-          this.changeValue(\`\${
+          this.changeValue(this.parse(\`\${
             this.displayValue.slice(0, this.cursor)
           }\${
             this.displayValue.slice(this.cursor + 1)
-          }\`);
+          }\`));
 
           if (this.isCursorAtEnd) {
             this.cursorOffset = 0;
@@ -831,7 +831,7 @@ function BasePromptDeclarations() {
 						children: code`this.cursorOffset = 0;
           this.cursor = this.displayValue.length;
 
-          await this.validate(this.value);
+          await this.checkValidations(this.value);
           if (this.isError) {
             this.sync();
             this.bell();
@@ -1082,7 +1082,7 @@ function TextPromptDeclarations() {
 						"protected": true,
 						parameters: [{
 							name: "previousValue",
-							type: "TValue"
+							type: "string"
 						}],
 						children: code`this.#isInvalid = false;
           this.cursor = this.displayValue.slice(0, this.cursor).length + 1; `
@@ -1099,11 +1099,11 @@ function TextPromptDeclarations() {
 					createComponent(Spacing, {}),
 					createComponent(ClassMethod, {
 						doc: "A method to validate the prompt input",
-						name: "validate",
+						name: "checkValidations",
 						override: true,
 						async: true,
 						"protected": true,
-						children: code`await super.validate(this.value);
+						children: code`await super.checkValidations(this.value);
           this.#isInvalid = this.isError; `
 					}),
 					createComponent(Spacing, {}),
@@ -1832,17 +1832,17 @@ function NumericPromptDeclarations() {
           }
 
           if (config.parse) {
-            this.parser = config.parse.bind(this);
+            this.parse = config.parse.bind(this);
           } else {
-            const parser = (value: string) => this.isFloat ? Math.round(Math.pow(10, this.precision) * Number.parseFloat(value)) / Math.pow(10, this.precision) : Number.parseInt(value);
-            this.parser = parser.bind(this);
+            const parse = (value: string) => this.isFloat ? Math.round(Math.pow(10, this.precision) * Number.parseFloat(value)) / Math.pow(10, this.precision) : Number.parseInt(value);
+            this.parse = parse.bind(this);
           }
 
           if (config.validate) {
-            this.validator = config.validate.bind(this);
+            this.validate = config.validate.bind(this);
           } else {
-            const validator = (value: number) => !Number.isNaN(value) && value >= this.min && value <= this.max;
-            this.validator = validator.bind(this);
+            const validate = (value: number) => !Number.isNaN(value) && value >= this.min && value <= this.max;
+            this.validate = validate.bind(this);
           }
 
           this.changeValue(this.initialValue);
@@ -1878,7 +1878,7 @@ function NumericPromptDeclarations() {
             this.displayValue.slice(this.cursor)
           }\`;
 
-          let value = this.parser(displayValue);
+          let value = this.parse(displayValue);
           if (!Number.isNaN(value)) {
 
             value = Math.min(value, this.max);
@@ -1901,7 +1901,7 @@ function NumericPromptDeclarations() {
 						"protected": true,
 						parameters: [{
 							name: "previousValue",
-							type: "TValue"
+							type: "number"
 						}],
 						children: code`this.#isInvalid = false;
           this.cursor = this.displayValue.slice(0, this.cursor).length + 1; `
@@ -1909,11 +1909,11 @@ function NumericPromptDeclarations() {
 					createComponent(Spacing, {}),
 					createComponent(ClassMethod, {
 						doc: "A method to validate the prompt input",
-						name: "validate",
+						name: "checkValidations",
 						override: true,
 						async: true,
 						"protected": true,
-						children: code`await super.validate(this.value);
+						children: code`await super.checkValidations(this.value);
           this.#isInvalid = this.isError; `
 					}),
 					createComponent(Spacing, {}),
@@ -2499,16 +2499,14 @@ function ConfirmPromptDeclarations() {
           }
 
           if (char.toLowerCase() === "y" || char.toLowerCase() === "t" || char.toLowerCase() === "0") {
-            this.value = true;
+            this.changeValue(true);
             return this.submit();
           } else if (char.toLowerCase() === "n" || char.toLowerCase() === "f" || char.toLowerCase() === "1") {
-            this.value = false;
+            this.changeValue(false);
             return this.submit();
           } else {
             return this.bell();
-          }
-
-          this.sync(); `
+          } `
 					}),
 					createComponent(Spacing, {}),
 					createComponent(ClassMethod, {
@@ -2650,6 +2648,50 @@ run(); ` }),
 		})
 	];
 }
+function WaitForKeyPressDeclaration() {
+	return [createComponent(TSDoc, {
+		heading: "A function to create and run a wait-for-key-press prompt, which returns a promise that resolves when any key is pressed or rejects with a {@link CANCEL_SYMBOL | cancel symbol} if the prompt is cancelled.",
+		get children() {
+			return [
+				createComponent(TSDocRemarks, { children: code`This function creates an instance of the Prompt class with a custom onKeyPress handler that resolves the promise when any key is pressed. It sets up event listeners for state updates and cancellation to handle the prompt interactions and return the appropriate results. The wait-for-key-press prompt is useful for scenarios where you want to pause execution until the user presses any key, such as waiting for user input before proceeding with a task.` }),
+				createComponent(Spacing, {}),
+				createComponent(TSDocExample, { children: `import { waitForKeyPress } from "shell-shock:prompts";
+
+async function run() {
+  const result = await waitForKeyPress();
+  console.log("A key was pressed!");
+}
+
+run(); ` }),
+				createComponent(Spacing, {}),
+				createComponent(TSDocParam, {
+					name: "timeout",
+					children: `The amount of time in milliseconds to wait before automatically resolving the prompt, defaults to 2 hours (7200000 ms)`
+				}),
+				createComponent(TSDocReturns, { children: `A promise that resolves when any key is pressed` })
+			];
+		}
+	}), createComponent(FunctionDeclaration, {
+		name: "waitForKeyPress",
+		"export": true,
+		parameters: [{
+			name: "timeout",
+			default: "7200000"
+		}],
+		children: code`process.stdin.setRawMode(true);
+        return new Promise(resolve => process.stdin.once("data", () => {
+          if (timeout >= 0) {
+            setTimeout(() => {
+              process.stdin.setRawMode(false);
+              resolve(void 0);
+            }, timeout);
+          }
+
+          process.stdin.setRawMode(false);
+          resolve(void 0);
+        })); `
+	})];
+}
 /**
 * A built-in prompts module for Shell Shock.
 */
@@ -2703,6 +2745,8 @@ function PromptsBuiltin(props) {
 				createComponent(Spacing, {}),
 				createComponent(ConfirmPromptDeclarations, {}),
 				createComponent(Spacing, {}),
+				createComponent(WaitForKeyPressDeclaration, {}),
+				createComponent(Spacing, {}),
 				createComponent(Show, {
 					get when() {
 						return Boolean(children);
@@ -2715,5 +2759,5 @@ function PromptsBuiltin(props) {
 }
 
 //#endregion
-export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations };
+export { BasePromptDeclarations, ConfirmPromptDeclarations, NumericPromptDeclarations, PasswordPromptDeclaration, PromptsBuiltin, SelectPromptDeclarations, TextPromptDeclarations, TogglePromptDeclarations, WaitForKeyPressDeclaration };
 //# sourceMappingURL=prompts-builtin.mjs.map