@shell-shock/plugin-prompts 0.3.51 → 0.3.52

package/dist/components/prompts-builtin.cjs

@@ -3,7 +3,6 @@ const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 let _alloy_js_core_jsx_runtime = require("@alloy-js/core/jsx-runtime");
 let _alloy_js_core = require("@alloy-js/core");
 let _alloy_js_typescript = require("@alloy-js/typescript");
-let _powerlines_deepkit_vendor_type = require("@powerlines/deepkit/vendor/type");
 let _powerlines_plugin_alloy_core_components_spacing = require("@powerlines/plugin-alloy/core/components/spacing");
 let _powerlines_plugin_alloy_typescript_components_builtin_file = require("@powerlines/plugin-alloy/typescript/components/builtin-file");
 let _powerlines_plugin_alloy_typescript_components_class_declaration = require("@powerlines/plugin-alloy/typescript/components/class-declaration");
@@ -91,7 +90,7 @@ 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_interface_declaration.InterfaceMember, {
 						name: "errorMessage",
-						optional: true,
+						required: false,
 						type: "string",
 						doc: "If the prompt is in an error state, this will contain the error message to display"
 					}),
@@ -129,14 +128,14 @@ function BasePromptDeclarations() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "input",
-						optional: true,
+						required: false,
 						type: "NodeJS.ReadStream",
 						doc: "The readable stream to use for prompt input, defaults to process.stdin"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "output",
-						optional: true,
+						required: false,
 						type: "NodeJS.WriteStream",
 						doc: "The writable stream to use for prompt output, defaults to process.stdout"
 					}),
@@ -149,63 +148,63 @@ 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_interface_declaration.InterfaceMember, {
 						name: "description",
-						optional: true,
+						required: false,
 						type: "string",
 						doc: "The prompt description message to display"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "initialValue",
-						optional: true,
+						required: false,
 						type: "TValue",
 						doc: "The initial value of the prompt"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "validate",
-						optional: true,
+						required: false,
 						type: "(value: TValue) => boolean | string | null | undefined | Promise<boolean | string | null | undefined>",
 						doc: "A validation function that returns true if the input is valid, false or a string error message if the input is invalid"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "parse",
-						optional: true,
+						required: false,
 						type: "PromptParser<TValue>",
 						doc: "A function that parses the input value and returns the parsed result or throws an error if the input is invalid"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "format",
-						optional: true,
+						required: false,
 						type: "PromptFormatter<TValue>",
 						doc: "A function that formats the input value and returns the formatted result or throws an error if the input is invalid"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "mask",
-						optional: true,
+						required: false,
 						type: "(input: string) => string",
 						doc: "A function that masks the input value and returns the masked result. This can be used to create password inputs or other sensitive input types where the actual input value should not be displayed. If not provided, the prompt will display the input as is without masking."
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "maskCompleted",
-						optional: true,
+						required: false,
 						type: "(input: string) => string",
 						doc: "A function that masks the value submitted by the user so that it can then be used in the console output or elsewhere without exposing sensitive information. If not provided, the prompt will use the same mask function for both input and submitted value masking."
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "defaultErrorMessage",
-						optional: true,
+						required: false,
 						type: "string",
 						doc: "The default error message to display when validation fails"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "timeout",
-						optional: true,
+						required: false,
 						type: "number",
 						doc: "The timeout duration in milliseconds for the prompt. If none is provided, the prompt will not time out."
 					})
@@ -233,8 +232,7 @@ function BasePromptDeclarations() {
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_class_declaration.ClassField, {
 						name: "value",
 						isPrivateMember: true,
-						optional: true,
-						type: "TValue"
+						type: "TValue | undefined"
 					}),
 					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_class_declaration.ClassField, {
@@ -916,21 +914,21 @@ function BasePromptDeclarations() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "onState",
-						optional: true,
+						required: false,
 						type: "(state: PromptState<TValue>) => any",
 						doc: "A function that is called when the prompt state changes, useful for updating the prompt message or other properties dynamically"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "onSubmit",
-						optional: true,
+						required: false,
 						type: "(value: TValue) => any",
 						doc: "A function that is called when the prompt is submitted, useful for handling the submitted value or performing actions based on the prompt state"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "onCancel",
-						optional: true,
+						required: false,
 						type: "(event: any) => any",
 						doc: "A function that is called when the prompt is canceled, useful for handling the canceled value or performing actions based on the prompt state"
 					})
@@ -979,14 +977,14 @@ function TextPromptDeclarations() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "initialValue",
-						optional: true,
+						required: false,
 						type: "string",
 						doc: "The initial value of the prompt"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "mask",
-						optional: true,
+						required: false,
 						type: "(input: string) => string",
 						doc: "A function that masks the input value and returns the masked result"
 					})
@@ -1233,15 +1231,15 @@ function SelectPromptDeclarations() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "label",
-						optional: true,
-						type: "string",
+						schema: { type: "string" },
+						required: false,
 						doc: "The message label for the option"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "icon",
-						optional: true,
-						type: "string",
+						schema: { type: "string" },
+						required: false,
 						doc: "An icon for the option"
 					}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
@@ -1253,22 +1251,22 @@ function SelectPromptDeclarations() {
 					(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_interface_declaration.InterfaceMember, {
 						name: "description",
-						optional: true,
-						type: "string",
+						schema: { type: "string" },
+						required: false,
 						doc: "The description of the option"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "selected",
-						optional: true,
-						type: "boolean",
+						schema: { type: "boolean" },
+						required: false,
 						doc: "Whether the option is selected"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "disabled",
-						optional: true,
-						type: "boolean",
+						schema: { type: "boolean" },
+						required: false,
 						doc: "Whether the option is disabled"
 					})
 				];
@@ -1324,7 +1322,7 @@ function SelectPromptDeclarations() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "hint",
-						optional: true,
+						required: false,
 						type: "string",
 						doc: "A hint to display to the user"
 					}),
@@ -1337,7 +1335,7 @@ function SelectPromptDeclarations() {
 					(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_interface_declaration.InterfaceMember, {
 						name: "optionsPerPage",
-						optional: true,
+						required: false,
 						type: "number",
 						doc: "The number of options to display per page, defaults to 8"
 					})
@@ -1683,6 +1681,416 @@ run(); ` }),
 	];
 }
 /**
+* Declarations for a multi-select prompt that allows users to choose multiple options from a list, with support for disabled options, bulk selection shortcuts, and required validation. This prompt type is useful for scenarios where users need to select one or more values from a predefined set.
+*/
+function MultiSelectPromptDeclarations() {
+	return [
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceDeclaration, {
+			name: "MultiSelectPromptConfig",
+			"extends": "PromptConfig<TValue[]>",
+			doc: "An options object for configuring a multi-select prompt",
+			typeParameters: [{
+				name: "TValue",
+				default: "string"
+			}],
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
+						name: "options",
+						type: "Array<string | PromptOptionConfig<TValue>>",
+						doc: "The options available for the multi-select prompt"
+					}),
+					(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_interface_declaration.InterfaceMember, {
+						name: "required",
+						required: false,
+						type: "boolean",
+						doc: "Whether at least one option must be selected, defaults to true"
+					}),
+					(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_interface_declaration.InterfaceMember, {
+						name: "initialValue",
+						required: false,
+						type: "TValue[]",
+						doc: "The initial selected values"
+					}),
+					(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_interface_declaration.InterfaceMember, {
+						name: "cursorAt",
+						required: false,
+						type: "TValue",
+						doc: "A value indicating which option should be focused initially"
+					}),
+					(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_interface_declaration.InterfaceMember, {
+						name: "optionsPerPage",
+						required: false,
+						type: "number",
+						doc: "The number of options to display per page, defaults to 8"
+					})
+				];
+			}
+		}),
+		(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.ClassDeclaration, {
+			name: "MultiSelectPrompt",
+			doc: "A prompt for selecting multiple options from a list",
+			"extends": "Prompt<TValue[]>",
+			typeParameters: [{
+				name: "TValue",
+				default: "string"
+			}],
+			get children() {
+				return [
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_class_declaration.ClassField, {
+						name: "initialValue",
+						"protected": true,
+						override: true,
+						type: "TValue[]",
+						children: _alloy_js_core.code`[]; `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_class_declaration.ClassField, {
+						name: "required",
+						"protected": true,
+						type: "boolean",
+						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: "optionsPerPage",
+						"protected": true,
+						type: "number",
+						children: _alloy_js_core.code`8; `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_class_declaration.ClassField, {
+						name: "options",
+						"protected": true,
+						type: "PromptOption<TValue>[]",
+						children: _alloy_js_core.code`[]; `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createIntrinsic)("hbr", {}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_class_declaration.ClassField, {
+						name: "cursorHidden",
+						"protected": true,
+						override: true,
+						type: "boolean",
+						children: _alloy_js_core.code`true; `
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+					_alloy_js_core.code`constructor(config: MultiSelectPromptConfig<TValue>) {
+          super(config);
+
+          this.required = config.required ?? true;
+          this.initialValue = Array.isArray(config.initialValue) ? [...config.initialValue] : [];
+
+          if (config.optionsPerPage) {
+            this.optionsPerPage = config.optionsPerPage;
+          }
+
+          this.options = config.options.map((opt, index) => {
+            let option = {} as Partial<PromptOption<TValue>>;
+            if (typeof opt === "string") {
+              option = {
+                label: opt,
+                value: opt as TValue,
+                selected: this.initialValue.includes(opt as TValue),
+                disabled: false
+              };
+            } else if (typeof opt === "object" && opt !== null) {
+              option = {
+                ...opt,
+                selected: this.initialValue.includes(opt.value as TValue) || !!opt.selected
+              };
+            } else {
+              throw new Error("Invalid option provided to MultiSelectPrompt at index #" + index);
+            }
+
+            return {
+              label: option.label || String(option.value),
+              ...option,
+              description: option.description,
+              selected: !!option.selected,
+              disabled: !!option.disabled,
+              index
+            } as PromptOption<TValue>;
+          });
+
+          if (config.cursorAt !== undefined) {
+            const index = this.options.findIndex(option => option.value === config.cursorAt);
+            if (index > -1) {
+              this.cursor = index;
+            }
+          }
+
+          if (this.options[this.cursor]?.disabled) {
+            this.moveCursor(this.findNextEnabled(this.cursor, 1));
+          } else {
+            this.changeValue(this.getSelectedValues());
+          }
+
+          this.sync();
+        }
+
+        protected getAction(key: Key): string | false {
+          let action = super.getAction(key);
+          if (!action) {
+            if (key.name === "j") action = "down";
+            if (key.name === "k") action = "up";
+            if (key.name === "a") action = "toggleAll";
+            if (key.name === "i") action = "toggleInvert";
+            if (key.name === "space") action = "toggleCurrent";
+          }
+
+          return action || false;
+        }
+
+        protected override async submit() {
+          const selectedValues = this.getSelectedValues();
+          if (this.required && selectedValues.length === 0) {
+            this.error(
+              "Please select at least one option. Press <space> to toggle and <enter> to submit."
+            );
+            this.bell();
+            return;
+          }
+
+          this.changeValue(selectedValues);
+          await super.submit();
+        }
+
+        protected toggleCurrent() {
+          const option = this.options[this.cursor];
+          if (!option || option.disabled) {
+            this.bell();
+            return;
+          }
+
+          option.selected = !option.selected;
+          this.changeValue(this.getSelectedValues());
+          this.sync();
+        }
+
+        protected toggleAll() {
+          const enabled = this.options.filter(option => !option.disabled);
+          const areAllSelected = enabled.every(option => option.selected);
+          for (const option of enabled) {
+            option.selected = !areAllSelected;
+          }
+
+          this.changeValue(this.getSelectedValues());
+          this.sync();
+        }
+
+        protected toggleInvert() {
+          for (const option of this.options) {
+            if (!option.disabled) {
+              option.selected = !option.selected;
+            }
+          }
+
+          this.changeValue(this.getSelectedValues());
+          this.sync();
+        }
+
+        protected findNextEnabled(from: number, direction: 1 | -1): number {
+          if (this.options.length === 0) {
+            return 0;
+          }
+
+          let index = from;
+          for (let i = 0; i < this.options.length; i++) {
+            index = (index + direction + this.options.length) % this.options.length;
+            if (!this.options[index]?.disabled) {
+              return index;
+            }
+          }
+
+          return from;
+        }
+
+        protected getSelectedValues(): TValue[] {
+          return this.options
+            .filter(option => option.selected)
+            .map(option => option.value as TValue);
+        }
+
+        protected next() {
+          this.moveCursor(this.findNextEnabled(this.cursor, 1));
+          this.sync();
+        }
+
+        protected up() {
+          this.moveCursor(this.findNextEnabled(this.cursor, -1));
+          this.sync();
+        }
+
+        protected down() {
+          this.moveCursor(this.findNextEnabled(this.cursor, 1));
+          this.sync();
+        }
+
+        protected first() {
+          this.moveCursor(this.findNextEnabled(0, 1));
+          this.sync();
+        }
+
+        protected last() {
+          this.moveCursor(this.findNextEnabled(this.options.length - 1, -1));
+          this.sync();
+        }
+
+        protected override moveCursor(count: number) {
+          this.cursor = count;
+          this.changeValue(this.getSelectedValues());
+          this.sync();
+        }
+
+        protected override onRender() {
+          const spacing = Math.max(...this.options.map(option => option.label?.length || 0), 0) + 2;
+          const startIndex = Math.max(
+            Math.min(
+              this.options.length - this.optionsPerPage,
+              this.cursor - Math.floor(this.optionsPerPage / 2)
+            ),
+            0
+          );
+          const endIndex = Math.min(startIndex + this.optionsPerPage, this.options.length);
+
+          let output = "";
+          if (!this.isCompleted) {
+            output += " \\\n";
+
+            for (let index = startIndex; index < endIndex; index++) {
+              const option = this.options[index]!;
+              const active = this.cursor === index;
+              const selected = !!option.selected;
+              const disabled = !!option.disabled;
+
+              const pointer = disabled
+                ? active
+                  ? bold(textColors.prompt.input.disabled(">"))
+                  : index === startIndex
+                    ? borderColors.app.divider.tertiary("↑")
+                    : index === endIndex - 1
+                      ? borderColors.app.divider.tertiary("↓")
+                      : " "
+                : active
+                  ? bold(textColors.prompt.input.active(">"))
+                  : index === startIndex
+                    ? borderColors.app.divider.tertiary("↑")
+                    : index === endIndex - 1
+                      ? borderColors.app.divider.tertiary("↓")
+                      : " ";
+
+              const marker = isUnicodeSupported ? (selected ? "🗹" : "☐") : (selected ? "[x]" : "[ ]");
+              const markerText = disabled
+                ? active
+                  ? bold(textColors.prompt.input.disabled(marker))
+                  : textColors.prompt.input.disabled(marker)
+                : active
+                  ? bold(textColors.prompt.input.active(marker))
+                  : textColors.prompt.input.inactive(marker);
+
+              const labelText = disabled
+                ? active
+                  ? bold(underline(textColors.prompt.input.disabled(option.label)))
+                  : strikethrough(textColors.prompt.input.disabled(option.label))
+                : active
+                  ? bold(underline(textColors.prompt.input.active(option.label)))
+                  : selected
+                    ? textColors.prompt.input.active(option.label)
+                    : textColors.prompt.input.inactive(option.label);
+
+              output +=
+                pointer +
+                " " +
+                markerText +
+                " " +
+                labelText +
+                " " +
+                " ".repeat(Math.max(0, spacing - option.label.length)) +
+                (option.description && active
+                  ? italic(textColors.prompt.description.active(option.description))
+                  : "") +
+                " \\\n";
+            }
+          } else {
+            const selected = this.options.filter(option => option.selected);
+            this.displayValue =
+              selected.length > 0
+                ? selected.map(option => option.label).join(", ")
+                : "(none)";
+            output += super.onRender();
+          }
+
+          return output;
+        }`
+				];
+			}
+		}),
+		(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.TSDoc, { heading: "A type definition for the configuration options to pass to the multi-select prompt, which extends the base PromptConfig with additional options specific to multi-select prompts." }),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_type_declaration.TypeDeclaration, {
+			"export": true,
+			name: "MultiSelectConfig",
+			children: _alloy_js_core.code`PromptFactoryConfig<string[]> & MultiSelectPromptConfig; `
+		}),
+		(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.TSDoc, {
+			heading: "A function to create and run a multi-select prompt, which returns a promise that resolves with the submitted values or 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.TSDocExample, { children: `import { multiselect, isCancel } from "shell-shock:prompts";
+
+async function run() {
+  const tools = await multiselect({
+    message: "Select tools",
+    options: [
+      { value: "eslint", label: "ESLint" },
+      { value: "prettier", label: "Prettier" },
+      { value: "vitest", label: "Vitest", disabled: true }
+    ]
+  });
+
+  if (isCancel(tools)) {
+    console.log("Prompt was cancelled");
+    return;
+  }
+
+  console.log("Selected tools:", tools.join(", "));
+}
+
+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: "config",
+						children: `The configuration options to pass to the multi-select prompt`
+					}),
+					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocReturns, { children: `A promise that resolves with the selected values or a {@link CANCEL_SYMBOL | cancel symbol} if the prompt is cancelled` })
+				];
+			}
+		}),
+		(0, _alloy_js_core_jsx_runtime.createComponent)(_alloy_js_typescript.FunctionDeclaration, {
+			name: "multiselect",
+			"export": true,
+			parameters: [{
+				name: "config",
+				type: "MultiSelectConfig"
+			}],
+			returnType: "Promise<string[] | symbol>",
+			children: _alloy_js_core.code`return new Promise<string[] | symbol>((response, reject) => {
+            const prompt = new MultiSelectPrompt(config);
+
+            prompt.on("state", state => config.onState?.(state));
+            prompt.on("submit", value => response(value));
+            prompt.on("cancel", event => response(CANCEL_SYMBOL));
+          });`
+		})
+	];
+}
+/**
 * A component that renders the declarations for the built-in numeric prompt, which allows users to input and select numeric values with various configuration options such as floating point support, precision, increment, and min/max values.
 */
 function NumericPromptDeclarations() {
@@ -1695,35 +2103,35 @@ function NumericPromptDeclarations() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "isFloat",
-						optional: true,
+						required: false,
 						type: "boolean",
 						doc: "Whether the prompt should accept floating point numbers"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "precision",
-						optional: true,
+						required: false,
 						type: "number",
 						doc: "The number of decimal places to round the input to, defaults to 2"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "increment",
-						optional: true,
+						required: false,
 						type: "number",
 						doc: "The increment value for the number prompt, defaults to 1"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "min",
-						optional: true,
+						required: false,
 						type: "number",
 						doc: "The minimum value for the number prompt, defaults to -Infinity"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "max",
-						optional: true,
+						required: false,
 						type: "number",
 						doc: "The maximum value for the number prompt, defaults to Infinity"
 					})
@@ -2073,14 +2481,14 @@ function TogglePromptDeclarations() {
 				return [
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "trueMessage",
-						optional: true,
+						required: false,
 						type: "string",
 						doc: "The message for the true state of the prompt"
 					}),
 					(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_interface_declaration.InterfaceMember, {
 						name: "falseMessage",
-						optional: true,
+						required: false,
 						type: "string",
 						doc: "The message for the false state of the prompt"
 					}),
@@ -2329,16 +2737,14 @@ function ConfirmPromptDeclarations() {
 						heading: "The message for the \\`Yes\\` state of the prompt",
 						get children() {
 							return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocDefaultValue, {
-								get type() {
-									return _powerlines_deepkit_vendor_type.ReflectionKind.string;
-								},
+								type: "string",
 								defaultValue: "Yes"
 							});
 						}
 					}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "yesMessage",
-						optional: true,
+						required: false,
 						type: "string"
 					}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
@@ -2346,16 +2752,14 @@ function ConfirmPromptDeclarations() {
 						heading: "The \\`Yes\\` option when choosing between yes/no",
 						get children() {
 							return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocDefaultValue, {
-								get type() {
-									return _powerlines_deepkit_vendor_type.ReflectionKind.string;
-								},
+								type: "string",
 								defaultValue: "1"
 							});
 						}
 					}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "yesOption",
-						optional: true,
+						required: false,
 						type: "string"
 					}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
@@ -2363,16 +2767,14 @@ function ConfirmPromptDeclarations() {
 						heading: "The message for the \\`No\\` state of the prompt",
 						get children() {
 							return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocDefaultValue, {
-								get type() {
-									return _powerlines_deepkit_vendor_type.ReflectionKind.string;
-								},
+								type: "string",
 								defaultValue: "(Y/n)"
 							});
 						}
 					}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "noMessage",
-						optional: true,
+						required: false,
 						type: "string"
 					}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
@@ -2380,16 +2782,14 @@ function ConfirmPromptDeclarations() {
 						heading: "The \\`No\\` option when choosing between yes/no",
 						get children() {
 							return (0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_tsdoc.TSDocDefaultValue, {
-								get type() {
-									return _powerlines_deepkit_vendor_type.ReflectionKind.string;
-								},
+								type: "string",
 								defaultValue: "(y/N)"
 							});
 						}
 					}),
 					(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_typescript_components_interface_declaration.InterfaceMember, {
 						name: "noOption",
-						optional: true,
+						required: false,
 						type: "string"
 					})
 				];
@@ -2718,6 +3118,7 @@ function PromptsBuiltin(props) {
 					"splitText",
 					"error"
 				],
+				utils: ["isUnicodeSupported"],
 				env: [
 					"env",
 					"isCI",
@@ -2737,6 +3138,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)(SelectPromptDeclarations, {}),
 				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(MultiSelectPromptDeclarations, {}),
+				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, _alloy_js_core_jsx_runtime.createComponent)(NumericPromptDeclarations, {}),
 				(0, _alloy_js_core_jsx_runtime.createComponent)(_powerlines_plugin_alloy_core_components_spacing.Spacing, {}),
 				(0, _alloy_js_core_jsx_runtime.createComponent)(TogglePromptDeclarations, {}),
@@ -2761,6 +3164,7 @@ function PromptsBuiltin(props) {
 //#endregion
 exports.BasePromptDeclarations = BasePromptDeclarations;
 exports.ConfirmPromptDeclarations = ConfirmPromptDeclarations;
+exports.MultiSelectPromptDeclarations = MultiSelectPromptDeclarations;
 exports.NumericPromptDeclarations = NumericPromptDeclarations;
 exports.PasswordPromptDeclaration = PasswordPromptDeclaration;
 exports.PromptsBuiltin = PromptsBuiltin;