@h3ravel/musket 2.2.5 → 2.2.7

package/dist/index.cjs

@@ -114,19 +114,54 @@ var SignatureBuilder = class {
 		});
 		return this;
 	}
-	/** 
-	* Add an option/flag. 
-	* 
-	* @param name 
-	* @returns 
+	/**
+	* Add an option/flag.
+	*
+	* By default an option is a boolean flag. The name accepts an optional short
+	* alias inline using the DSL's `short|long` syntax, with or without leading
+	* dashes:
+	*
+	* ```ts
+	* sig.option('dev')          // --dev
+	* sig.option('--dev')        // --dev
+	* sig.option('--d|dev')      // -d, --dev
+	* sig.option('d|dev')        // -d, --dev
+	* ```
+	*
+	* A `short` provided in the {@link OptionDefinition} takes precedence over
+	* one parsed from the name.
+	*
+	* @param name
+	* @returns
 	*/
 	option(name, definition = {}) {
+		const { long, short } = this.parseOptionName(name);
 		this.opts.push({
-			name: name.replace(/^--?/, "").trim(),
-			...definition
+			...definition,
+			name: long,
+			short: definition.short ?? short
 		});
 		return this;
 	}
+	/**
+	* Parse an option name into its long name and optional short alias. Supports
+	* the `short|long` DSL syntax (e.g. `--d|dev`), independent of dash prefixes
+	* and part ordering. A single-character part is treated as the short alias;
+	* a multi-character part is the long name.
+	*/
+	parseOptionName(raw) {
+		const parts = raw.split("|").map((part) => part.replace(/^--?/, "").trim()).filter(Boolean);
+		let long;
+		let short;
+		for (const part of parts) if (part.length === 1 && short === void 0) short = part;
+		else long ??= part;
+		long ??= short ?? "";
+		if (long === short) short = void 0;
+		return {
+			long,
+			short
+		};
+	}
 	/** 
 	* The configured command name (empty when unset). 
 	* 

package/dist/index.d.ts

@@ -435,11 +435,32 @@ declare class SignatureBuilder {
   argument(name: string, definition?: ArgumentDefinition): this;
   /**
    * Add an option/flag.
-    *
-    * @param name
-    * @returns
-    */
+   *
+   * By default an option is a boolean flag. The name accepts an optional short
+   * alias inline using the DSL's `short|long` syntax, with or without leading
+   * dashes:
+   *
+   * ```ts
+   * sig.option('dev')          // --dev
+   * sig.option('--dev')        // --dev
+   * sig.option('--d|dev')      // -d, --dev
+   * sig.option('d|dev')        // -d, --dev
+   * ```
+   *
+   * A `short` provided in the {@link OptionDefinition} takes precedence over
+   * one parsed from the name.
+   *
+   * @param name
+   * @returns
+   */
   option(name: string, definition?: OptionDefinition): this;
+  /**
+   * Parse an option name into its long name and optional short alias. Supports
+   * the `short|long` DSL syntax (e.g. `--d|dev`), independent of dash prefixes
+   * and part ordering. A single-character part is treated as the short alias;
+   * a multi-character part is the long name.
+   */
+  private parseOptionName;
   /**
    * The configured command name (empty when unset).
    *

package/dist/index.js

@@ -90,19 +90,54 @@ var SignatureBuilder = class {
 		});
 		return this;
 	}
-	/** 
-	* Add an option/flag. 
-	* 
-	* @param name 
-	* @returns 
+	/**
+	* Add an option/flag.
+	*
+	* By default an option is a boolean flag. The name accepts an optional short
+	* alias inline using the DSL's `short|long` syntax, with or without leading
+	* dashes:
+	*
+	* ```ts
+	* sig.option('dev')          // --dev
+	* sig.option('--dev')        // --dev
+	* sig.option('--d|dev')      // -d, --dev
+	* sig.option('d|dev')        // -d, --dev
+	* ```
+	*
+	* A `short` provided in the {@link OptionDefinition} takes precedence over
+	* one parsed from the name.
+	*
+	* @param name
+	* @returns
 	*/
 	option(name, definition = {}) {
+		const { long, short } = this.parseOptionName(name);
 		this.opts.push({
-			name: name.replace(/^--?/, "").trim(),
-			...definition
+			...definition,
+			name: long,
+			short: definition.short ?? short
 		});
 		return this;
 	}
+	/**
+	* Parse an option name into its long name and optional short alias. Supports
+	* the `short|long` DSL syntax (e.g. `--d|dev`), independent of dash prefixes
+	* and part ordering. A single-character part is treated as the short alias;
+	* a multi-character part is the long name.
+	*/
+	parseOptionName(raw) {
+		const parts = raw.split("|").map((part) => part.replace(/^--?/, "").trim()).filter(Boolean);
+		let long;
+		let short;
+		for (const part of parts) if (part.length === 1 && short === void 0) short = part;
+		else long ??= part;
+		long ??= short ?? "";
+		if (long === short) short = void 0;
+		return {
+			long,
+			short
+		};
+	}
 	/** 
 	* The configured command name (empty when unset). 
 	* 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h3ravel/musket",
-  "version": "2.2.5",
+  "version": "2.2.7",
   "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",
@@ -73,7 +73,6 @@
     "execa": "^9.6.0",
     "glob": "^13.0.6",
     "preferred-pm": "^4.1.1",
-    "radashi": "^12.6.2",
     "resolve-from": "^5.0.0",
     "tsx": "^4.20.5"
   },