@h3ravel/musket 0.8.0-alpha.2 → 0.8.0-alpha.4

package/dist/index.cjs

@@ -71,11 +71,28 @@ var Command = class {
 	};
 	/**
 	* Execute the console command.
+	* 
+	* @param _args The command arguments
 	*/
 	async handle(..._args) {}
+	/**
+	* Set the application instance
+	* 
+	* @param app The application instance
+	*/
 	setApplication(app) {
 		this.app = app;
 	}
+	/**
+	* Set the command input
+	* 
+	* @param options    The command options
+	* @param args       The command arguments
+	* @param regArgs    The registered arguments
+	* @param dictionary The dictionary of signatures or what not
+	* @param program    The underlying commander program
+	* @returns 
+	*/
 	setInput(options, args, regArgs, dictionary, program) {
 		this.program = program;
 		this.dictionary = dictionary;
@@ -89,34 +106,84 @@ var Command = class {
 		});
 		return this;
 	}
+	/**
+	* Set a specific option
+	* 
+	* @param key   The option key
+	* @param value The option value
+	* @returns 
+	*/
 	setOption(key, value) {
 		this.program.setOptionValue(key, value);
 		return this;
 	}
+	/**
+	* Set the underlying commander program
+	* 
+	* @param program The underlying commander program
+	* @returns 
+	*/
 	setProgram(program) {
 		this.program = program;
 		return this;
 	}
+	/**
+	* Get the command signature
+	* 
+	* @returns 
+	*/
 	getSignature() {
 		return this.signature;
 	}
+	/**
+	* Get the command description
+	* 
+	* @returns 
+	*/
 	getDescription() {
 		return this.description;
 	}
-	option(key, def) {
-		const option = this.input.options[key] ?? def;
+	/**
+	* Get a specific option
+	* 
+	* @param key          The option key
+	* @param defaultValue The default value
+	* @returns 
+	*/
+	option(key, defaultValue) {
+		const option = this.input.options[key] ?? defaultValue;
 		return option === "null" || option === "undefined" ? void 0 : option;
 	}
+	/**
+	* Get all options
+	* 
+	* @param key The option key
+	* @returns 
+	*/
 	options(key) {
 		if (key) return this.input.options[key];
 		return this.input.options;
 	}
-	argument(key, def) {
-		return this.input.arguments[key] ?? def;
+	/**
+	* Get a specific argument
+	* 
+	* @param key          The argument key
+	* @param defaultValue The default value
+	* @returns 
+	*/
+	argument(key, defaultValue) {
+		return this.input.arguments[key] ?? defaultValue;
 	}
+	/**
+	* Get all arguments
+	* @returns 
+	*/
 	arguments() {
 		return this.input.arguments;
 	}
+	/**
+	* Load base flags into the command input
+	*/
 	loadBaseFlags() {
 		let verbose = 0;
 		if (this.program.getOptionValue("verbose") == "v") verbose = 2;
@@ -161,6 +228,9 @@ var Command = class {
 	}
 	/**
 	* Log an info message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	info(message) {
 		__h3ravel_shared.Logger.info(message);
@@ -168,6 +238,9 @@ var Command = class {
 	}
 	/**
 	* Log a warning message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	warn(message) {
 		__h3ravel_shared.Logger.warn(message);
@@ -175,6 +248,9 @@ var Command = class {
 	}
 	/**
 	* Log a line message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	line(message) {
 		__h3ravel_shared.Logger.log(message, "white");
@@ -182,6 +258,9 @@ var Command = class {
 	}
 	/**
 	* Log a new line
+	* 
+	* @param count Number of new lines to log
+	* @returns 
 	*/
 	newLine(count = 1) {
 		if (Number(this.getVerbosity()) >= 3 || !this.isSilent() && !this.isQuiet()) for (let i = 0; i < count; i++) console.log("");
@@ -189,6 +268,9 @@ var Command = class {
 	}
 	/**
 	* Log a success message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	success(message) {
 		__h3ravel_shared.Logger.success(message);
@@ -196,6 +278,9 @@ var Command = class {
 	}
 	/**
 	* Log an error message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	error(message) {
 		__h3ravel_shared.Logger.error(message, false);
@@ -206,6 +291,9 @@ var Command = class {
 	* return an exit code of 1
 	* 
 	* This method is not chainable
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	fail(message) {
 		this.error(message);
@@ -213,6 +301,9 @@ var Command = class {
 	}
 	/**
 	* Log a debug message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	debug(message) {
 		__h3ravel_shared.Logger.debug(message);
@@ -221,36 +312,92 @@ var Command = class {
 	/**
 	* Prompt the user with the given question, accept their input, and 
 	* then return the user's input back to your command.
+	* 
+	* @param message      Message to display
+	* @param defaultValue The default value 
+	* @returns 
 	*/
-	ask(message, def) {
-		return __h3ravel_shared.Prompts.ask(message, def);
+	ask(message, defaultValue) {
+		return __h3ravel_shared.Prompts.ask(message, defaultValue);
 	}
 	/**
 	* Allows users to pick from a predefined set of choices when asked a question.
+	* 
+	* @param message      Message to display
+	* @param choices      The choices available to the user
+	* @param defaultIndex Item index front of which the cursor will initially appear
+	* @returns 
 	*/
-	choice(message, choices, defaultIndex) {
-		return __h3ravel_shared.Prompts.choice(message, choices, defaultIndex);
+	choice(message, choices, defaultIndex, pageSize) {
+		return __h3ravel_shared.Prompts.choice(message, choices, defaultIndex, pageSize);
 	}
 	/**
 	* Ask the user for a simple "yes or no" confirmation. By default, this method returns `false`. 
 	* However, if the user enters y or yes in response to the prompt, the method would return `true`.
+	* 
+	* @param message      Message to display
+	* @param defaultValue The default value 
+	* @returns 
 	*/
-	confirm(message, def) {
-		return __h3ravel_shared.Prompts.confirm(message, def);
+	confirm(message, defaultValue) {
+		return __h3ravel_shared.Prompts.confirm(message, defaultValue);
 	}
 	/**
-	* Prompt the user with the given question, accept their input which will 
-	* not be visible to them as they type in the console, and then return the user's input back to your command.
+	* Prompt the user with the given question, accept their input which will be visible 
+	* to them as they type in the console, and then return the user's input back to your command.
+	* 
+	* @param message Message to display
+	* @param mask    Mask the user input
+	* @returns 
 	*/
 	secret(message, mask) {
 		return __h3ravel_shared.Prompts.secret(message, mask);
 	}
 	/**
+	* Display a spinner while performing a long task
+	* 
+	* @param options The spinner options
+	* @returns 
+	*/
+	spinner(options) {
+		return __h3ravel_shared.Prompts.spinner(options);
+	}
+	/**
 	* Provide auto-completion for possible choices. The user can still provide any 
 	* answer, regardless of the auto-completion hints.
+	* 
+	* @param message      Message to dislpay
+	* @param source       The source of completions
+	* @param defaultValue Set a default value 
+	* @returns 
 	*/
-	anticipate(message, source, def) {
-		return __h3ravel_shared.Prompts.anticipate(message, source, def);
+	anticipate(message, source, defaultValue, pageSize) {
+		return __h3ravel_shared.Prompts.anticipate(message, source, defaultValue, pageSize);
+	}
+	/**
+	* Allows users to select multiple options from a predefined list of choices.
+	* 
+	* @param message  Message to display
+	* @param choices  The choices available to the user
+	* @param required Whether at least one choice is required
+	* @param prefix   Prefix to display before the message
+	* @param pageSize The number of items to show per page
+	* @returns
+	*/
+	checkbox(message, choices, required, prefix, pageSize) {
+		return __h3ravel_shared.Prompts.checkbox(message, choices, required, prefix, pageSize);
+	}
+	/**
+	* Open the user's default text editor to accept multi-line input.
+	* 
+	* @param message  Message to display
+	* @param postfix  The postfix of the file being edited [e.g., '.txt', '.md']
+	* @param defaultValue The default value to pre-fill in the editor
+	* @param validate A function to validate the input text
+	* @returns
+	*/
+	editor(message, postfix, defaultValue, validate) {
+		return __h3ravel_shared.Prompts.editor(message, postfix, defaultValue, validate);
 	}
 };
 
@@ -510,10 +657,18 @@ var Signature = class Signature {
 					} else flags.push(part);
 				}
 			}
-			const desc = description.match(/^([^:]+?)\s*:\s*\[?([\w\s,]+)\]?$/);
-			if (match) {
-				description = desc?.[1].trim() ?? description;
-				choices = desc?.[2].split(",").map((s) => s.trim()).filter(Boolean) ?? choices;
+			/**
+			* Extract choices from the descriptions.
+			* 
+			* Choices can be in the format: 
+			* [choice1, choice2, choice3]
+			* choice1, choice2, choice3
+			* choices can have dots as well: [opt1.val, opt2.val]
+			*/
+			const desc = description.match(/\[([^\]]+)\]/) || description.match(/: ([^:\[\]]+(?:,[^:\[\]]+)*)$/);
+			if (desc) {
+				description = description.replace(desc[0], "").trim();
+				choices = desc[1].split(",").map((c) => c.trim());
 			}
 			options.push({
 				name: isFlag ? flags[flags.length - 1] : name,
@@ -636,7 +791,7 @@ var Musket = class Musket {
 	}
 	async loadDiscoveredCommands() {
 		const commands = [...(this.app.registeredCommands ?? []).map((cmd) => new cmd(this.app, this.kernel))];
-		const paths = Array.isArray(this.config.discoveryPaths) ? this.config.discoveryPaths : [this.config.discoveryPaths];
+		const paths = (Array.isArray(this.config.discoveryPaths) ? this.config.discoveryPaths : [this.config.discoveryPaths]).filter((e) => typeof e === "string");
 		/**
 		* CLI Commands auto registration
 		*/

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as commander0 from "commander";
 import { Argument, Command as Command$1 } from "commander";
-import { ChoiceOrSeparatorArray, Choices } from "@h3ravel/shared";
+import { ChoiceOrSeparatorArray, Choices, Spinner } from "@h3ravel/shared";
 import { UserConfig } from "tsdown";
 
 //#region src/Contracts/ICommand.d.ts
@@ -264,18 +264,85 @@ declare class Command<A extends Application = Application> {
   private input;
   /**
    * Execute the console command.
+   *
+   * @param _args The command arguments
    */
   handle(..._args: any[]): Promise<void>;
+  /**
+   * Set the application instance
+   *
+   * @param app The application instance
+   */
   setApplication(app: A): void;
+  /**
+   * Set the command input
+   *
+   * @param options    The command options
+   * @param args       The command arguments
+   * @param regArgs    The registered arguments
+   * @param dictionary The dictionary of signatures or what not
+   * @param program    The underlying commander program
+   * @returns
+   */
   setInput(options: XGeneric, args: string[], regArgs: readonly Argument[], dictionary: Record<string, any>, program: Command$1): this;
+  /**
+   * Set a specific option
+   *
+   * @param key   The option key
+   * @param value The option value
+   * @returns
+   */
   setOption(key: string, value: unknown): this;
+  /**
+   * Set the underlying commander program
+   *
+   * @param program The underlying commander program
+   * @returns
+   */
   setProgram(program: Command$1): this;
+  /**
+   * Get the command signature
+   *
+   * @returns
+   */
   getSignature(): string;
+  /**
+   * Get the command description
+   *
+   * @returns
+   */
   getDescription(): string | undefined;
-  option(key: string, def?: any): any;
+  /**
+   * Get a specific option
+   *
+   * @param key          The option key
+   * @param defaultValue The default value
+   * @returns
+   */
+  option(key: string, defaultValue?: any): any;
+  /**
+   * Get all options
+   *
+   * @param key The option key
+   * @returns
+   */
   options(key?: string): any;
-  argument(key: string, def?: any): any;
+  /**
+   * Get a specific argument
+   *
+   * @param key          The argument key
+   * @param defaultValue The default value
+   * @returns
+   */
+  argument(key: string, defaultValue?: any): any;
+  /**
+   * Get all arguments
+   * @returns
+   */
   arguments(): Record<string, any>;
+  /**
+   * Load base flags into the command input
+   */
   loadBaseFlags(): void;
   /**
    * Check if the command is quiet
@@ -303,26 +370,44 @@ declare class Command<A extends Application = Application> {
   getVerbosity(): number;
   /**
    * Log an info message
+   *
+   * @param message The message to log
+   * @returns
    */
   info(message: string): this;
   /**
    * Log a warning message
+   *
+   * @param message The message to log
+   * @returns
    */
   warn(message: string): this;
   /**
    * Log a line message
+   *
+   * @param message The message to log
+   * @returns
    */
   line(message: string): this;
   /**
    * Log a new line
+   *
+   * @param count Number of new lines to log
+   * @returns
    */
   newLine(count?: number): this;
   /**
    * Log a success message
+   *
+   * @param message The message to log
+   * @returns
    */
   success(message: string): this;
   /**
    * Log an error message
+   *
+   * @param message The message to log
+   * @returns
    */
   error(message: string): this;
   /**
@@ -330,86 +415,92 @@ declare class Command<A extends Application = Application> {
    * return an exit code of 1
    *
    * This method is not chainable
+   *
+   * @param message The message to log
+   * @returns
    */
   fail(message: string): void;
   /**
    * Log a debug message
+   *
+   * @param message The message to log
+   * @returns
    */
   debug(message: string | string[]): this;
   /**
    * Prompt the user with the given question, accept their input, and
    * then return the user's input back to your command.
+   *
+   * @param message      Message to display
+   * @param defaultValue The default value
+   * @returns
    */
-  ask(
-  /**
-   * Message to dislpay
-   */
-  message: string,
-  /**
-   * The default value
-   */
-  def?: string | undefined): Promise<string>;
+  ask(message: string, defaultValue?: string | undefined): Promise<string>;
   /**
    * Allows users to pick from a predefined set of choices when asked a question.
+   *
+   * @param message      Message to display
+   * @param choices      The choices available to the user
+   * @param defaultIndex Item index front of which the cursor will initially appear
+   * @returns
    */
-  choice(
-  /**
-   * Message to dislpay
-   */
-  message: string,
-  /**
-   * The choices available to the user
-   */
-  choices: Choices,
-  /**
-   * Item index front of which the cursor will initially appear
-   */
-  defaultIndex?: number): Promise<string>;
+  choice(message: string, choices: Choices, defaultIndex?: number, pageSize?: number): Promise<string>;
   /**
    * Ask the user for a simple "yes or no" confirmation. By default, this method returns `false`.
    * However, if the user enters y or yes in response to the prompt, the method would return `true`.
+   *
+   * @param message      Message to display
+   * @param defaultValue The default value
+   * @returns
    */
-  confirm(
-  /**
-   * Message to dislpay
-   */
-  message: string,
-  /**
-   * The default value
-   */
-  def?: boolean | undefined): Promise<boolean>;
+  confirm(message: string, defaultValue?: boolean | undefined): Promise<boolean>;
   /**
-   * Prompt the user with the given question, accept their input which will
-   * not be visible to them as they type in the console, and then return the user's input back to your command.
+   * Prompt the user with the given question, accept their input which will be visible
+   * to them as they type in the console, and then return the user's input back to your command.
+   *
+   * @param message Message to display
+   * @param mask    Mask the user input
+   * @returns
    */
-  secret(
-  /**
-  * Message to dislpay
-  */
-  message: string,
+  secret(message: string, mask?: string | boolean): Promise<string>;
   /**
-   * Mask the user input
+   * Display a spinner while performing a long task
    *
-   * @default true
+   * @param options The spinner options
+   * @returns
    */
-  mask?: string | boolean): Promise<string>;
+  spinner(options?: string): Spinner;
   /**
    * Provide auto-completion for possible choices. The user can still provide any
    * answer, regardless of the auto-completion hints.
+   *
+   * @param message      Message to dislpay
+   * @param source       The source of completions
+   * @param defaultValue Set a default value
+   * @returns
    */
-  anticipate(
-  /**
-   * Message to dislpay
-   */
-  message: string,
+  anticipate(message: string, source: string[] | ((input?: string | undefined) => Promise<ChoiceOrSeparatorArray<any>>), defaultValue?: string, pageSize?: number): Promise<any>;
   /**
-   * The source of completions
+   * Allows users to select multiple options from a predefined list of choices.
+   *
+   * @param message  Message to display
+   * @param choices  The choices available to the user
+   * @param required Whether at least one choice is required
+   * @param prefix   Prefix to display before the message
+   * @param pageSize The number of items to show per page
+   * @returns
    */
-  source: string[] | ((input?: string | undefined) => Promise<ChoiceOrSeparatorArray<any>>),
+  checkbox(message: string, choices: Choices, required?: boolean, prefix?: string, pageSize?: number): Promise<string[]>;
   /**
-   * Set a default value
+   * Open the user's default text editor to accept multi-line input.
+   *
+   * @param message  Message to display
+   * @param postfix  The postfix of the file being edited [e.g., '.txt', '.md']
+   * @param defaultValue The default value to pre-fill in the editor
+   * @param validate A function to validate the input text
+   * @returns
    */
-  def?: string): Promise<any>;
+  editor(message?: string, postfix?: string, defaultValue?: string, validate?: (text: string) => boolean | string): Promise<string>;
 }
 //#endregion
 //#region src/Musket.d.ts

package/dist/index.js

@@ -47,11 +47,28 @@ var Command = class {
 	};
 	/**
 	* Execute the console command.
+	* 
+	* @param _args The command arguments
 	*/
 	async handle(..._args) {}
+	/**
+	* Set the application instance
+	* 
+	* @param app The application instance
+	*/
 	setApplication(app) {
 		this.app = app;
 	}
+	/**
+	* Set the command input
+	* 
+	* @param options    The command options
+	* @param args       The command arguments
+	* @param regArgs    The registered arguments
+	* @param dictionary The dictionary of signatures or what not
+	* @param program    The underlying commander program
+	* @returns 
+	*/
 	setInput(options, args, regArgs, dictionary, program) {
 		this.program = program;
 		this.dictionary = dictionary;
@@ -65,34 +82,84 @@ var Command = class {
 		});
 		return this;
 	}
+	/**
+	* Set a specific option
+	* 
+	* @param key   The option key
+	* @param value The option value
+	* @returns 
+	*/
 	setOption(key, value) {
 		this.program.setOptionValue(key, value);
 		return this;
 	}
+	/**
+	* Set the underlying commander program
+	* 
+	* @param program The underlying commander program
+	* @returns 
+	*/
 	setProgram(program) {
 		this.program = program;
 		return this;
 	}
+	/**
+	* Get the command signature
+	* 
+	* @returns 
+	*/
 	getSignature() {
 		return this.signature;
 	}
+	/**
+	* Get the command description
+	* 
+	* @returns 
+	*/
 	getDescription() {
 		return this.description;
 	}
-	option(key, def) {
-		const option = this.input.options[key] ?? def;
+	/**
+	* Get a specific option
+	* 
+	* @param key          The option key
+	* @param defaultValue The default value
+	* @returns 
+	*/
+	option(key, defaultValue) {
+		const option = this.input.options[key] ?? defaultValue;
 		return option === "null" || option === "undefined" ? void 0 : option;
 	}
+	/**
+	* Get all options
+	* 
+	* @param key The option key
+	* @returns 
+	*/
 	options(key) {
 		if (key) return this.input.options[key];
 		return this.input.options;
 	}
-	argument(key, def) {
-		return this.input.arguments[key] ?? def;
+	/**
+	* Get a specific argument
+	* 
+	* @param key          The argument key
+	* @param defaultValue The default value
+	* @returns 
+	*/
+	argument(key, defaultValue) {
+		return this.input.arguments[key] ?? defaultValue;
 	}
+	/**
+	* Get all arguments
+	* @returns 
+	*/
 	arguments() {
 		return this.input.arguments;
 	}
+	/**
+	* Load base flags into the command input
+	*/
 	loadBaseFlags() {
 		let verbose = 0;
 		if (this.program.getOptionValue("verbose") == "v") verbose = 2;
@@ -137,6 +204,9 @@ var Command = class {
 	}
 	/**
 	* Log an info message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	info(message) {
 		Logger.info(message);
@@ -144,6 +214,9 @@ var Command = class {
 	}
 	/**
 	* Log a warning message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	warn(message) {
 		Logger.warn(message);
@@ -151,6 +224,9 @@ var Command = class {
 	}
 	/**
 	* Log a line message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	line(message) {
 		Logger.log(message, "white");
@@ -158,6 +234,9 @@ var Command = class {
 	}
 	/**
 	* Log a new line
+	* 
+	* @param count Number of new lines to log
+	* @returns 
 	*/
 	newLine(count = 1) {
 		if (Number(this.getVerbosity()) >= 3 || !this.isSilent() && !this.isQuiet()) for (let i = 0; i < count; i++) console.log("");
@@ -165,6 +244,9 @@ var Command = class {
 	}
 	/**
 	* Log a success message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	success(message) {
 		Logger.success(message);
@@ -172,6 +254,9 @@ var Command = class {
 	}
 	/**
 	* Log an error message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	error(message) {
 		Logger.error(message, false);
@@ -182,6 +267,9 @@ var Command = class {
 	* return an exit code of 1
 	* 
 	* This method is not chainable
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	fail(message) {
 		this.error(message);
@@ -189,6 +277,9 @@ var Command = class {
 	}
 	/**
 	* Log a debug message
+	* 
+	* @param message The message to log
+	* @returns 
 	*/
 	debug(message) {
 		Logger.debug(message);
@@ -197,36 +288,92 @@ var Command = class {
 	/**
 	* Prompt the user with the given question, accept their input, and 
 	* then return the user's input back to your command.
+	* 
+	* @param message      Message to display
+	* @param defaultValue The default value 
+	* @returns 
 	*/
-	ask(message, def) {
-		return Prompts.ask(message, def);
+	ask(message, defaultValue) {
+		return Prompts.ask(message, defaultValue);
 	}
 	/**
 	* Allows users to pick from a predefined set of choices when asked a question.
+	* 
+	* @param message      Message to display
+	* @param choices      The choices available to the user
+	* @param defaultIndex Item index front of which the cursor will initially appear
+	* @returns 
 	*/
-	choice(message, choices, defaultIndex) {
-		return Prompts.choice(message, choices, defaultIndex);
+	choice(message, choices, defaultIndex, pageSize) {
+		return Prompts.choice(message, choices, defaultIndex, pageSize);
 	}
 	/**
 	* Ask the user for a simple "yes or no" confirmation. By default, this method returns `false`. 
 	* However, if the user enters y or yes in response to the prompt, the method would return `true`.
+	* 
+	* @param message      Message to display
+	* @param defaultValue The default value 
+	* @returns 
 	*/
-	confirm(message, def) {
-		return Prompts.confirm(message, def);
+	confirm(message, defaultValue) {
+		return Prompts.confirm(message, defaultValue);
 	}
 	/**
-	* Prompt the user with the given question, accept their input which will 
-	* not be visible to them as they type in the console, and then return the user's input back to your command.
+	* Prompt the user with the given question, accept their input which will be visible 
+	* to them as they type in the console, and then return the user's input back to your command.
+	* 
+	* @param message Message to display
+	* @param mask    Mask the user input
+	* @returns 
 	*/
 	secret(message, mask) {
 		return Prompts.secret(message, mask);
 	}
 	/**
+	* Display a spinner while performing a long task
+	* 
+	* @param options The spinner options
+	* @returns 
+	*/
+	spinner(options) {
+		return Prompts.spinner(options);
+	}
+	/**
 	* Provide auto-completion for possible choices. The user can still provide any 
 	* answer, regardless of the auto-completion hints.
+	* 
+	* @param message      Message to dislpay
+	* @param source       The source of completions
+	* @param defaultValue Set a default value 
+	* @returns 
 	*/
-	anticipate(message, source, def) {
-		return Prompts.anticipate(message, source, def);
+	anticipate(message, source, defaultValue, pageSize) {
+		return Prompts.anticipate(message, source, defaultValue, pageSize);
+	}
+	/**
+	* Allows users to select multiple options from a predefined list of choices.
+	* 
+	* @param message  Message to display
+	* @param choices  The choices available to the user
+	* @param required Whether at least one choice is required
+	* @param prefix   Prefix to display before the message
+	* @param pageSize The number of items to show per page
+	* @returns
+	*/
+	checkbox(message, choices, required, prefix, pageSize) {
+		return Prompts.checkbox(message, choices, required, prefix, pageSize);
+	}
+	/**
+	* Open the user's default text editor to accept multi-line input.
+	* 
+	* @param message  Message to display
+	* @param postfix  The postfix of the file being edited [e.g., '.txt', '.md']
+	* @param defaultValue The default value to pre-fill in the editor
+	* @param validate A function to validate the input text
+	* @returns
+	*/
+	editor(message, postfix, defaultValue, validate) {
+		return Prompts.editor(message, postfix, defaultValue, validate);
 	}
 };
 
@@ -486,10 +633,18 @@ var Signature = class Signature {
 					} else flags.push(part);
 				}
 			}
-			const desc = description.match(/^([^:]+?)\s*:\s*\[?([\w\s,]+)\]?$/);
-			if (match) {
-				description = desc?.[1].trim() ?? description;
-				choices = desc?.[2].split(",").map((s) => s.trim()).filter(Boolean) ?? choices;
+			/**
+			* Extract choices from the descriptions.
+			* 
+			* Choices can be in the format: 
+			* [choice1, choice2, choice3]
+			* choice1, choice2, choice3
+			* choices can have dots as well: [opt1.val, opt2.val]
+			*/
+			const desc = description.match(/\[([^\]]+)\]/) || description.match(/: ([^:\[\]]+(?:,[^:\[\]]+)*)$/);
+			if (desc) {
+				description = description.replace(desc[0], "").trim();
+				choices = desc[1].split(",").map((c) => c.trim());
 			}
 			options.push({
 				name: isFlag ? flags[flags.length - 1] : name,
@@ -612,7 +767,7 @@ var Musket = class Musket {
 	}
 	async loadDiscoveredCommands() {
 		const commands = [...(this.app.registeredCommands ?? []).map((cmd) => new cmd(this.app, this.kernel))];
-		const paths = Array.isArray(this.config.discoveryPaths) ? this.config.discoveryPaths : [this.config.discoveryPaths];
+		const paths = (Array.isArray(this.config.discoveryPaths) ? this.config.discoveryPaths : [this.config.discoveryPaths]).filter((e) => typeof e === "string");
 		/**
 		* CLI Commands auto registration
 		*/

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h3ravel/musket",
-  "version": "0.8.0-alpha.2",
+  "version": "0.8.0-alpha.4",
   "description": "Musket CLI is a framework-agnostic CLI framework designed to allow you build artisan-like CLI apps and for use in the H3ravel framework.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -63,7 +63,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@h3ravel/shared": "^0.29.0-alpha.8",
+    "@h3ravel/shared": "^0.29.0-alpha.9",
     "chalk": "^5.6.2",
     "commander": "^14.0.1",
     "dayjs": "^1.11.18",