@clerc/parser 1.0.0-beta.24 → 1.0.0-beta.25

package/dist/index.d.ts

@@ -10,9 +10,6 @@ declare class MissingRequiredFlagError extends Error {
 type Prettify<T> = { [K in keyof T]: T[K] } & {};
 type IsAny<T> = 0 extends 1 & T ? true : false;
 //#endregion
-//#region ../utils/src/types/index.d.ts
-type MaybeArray<T> = T | T[];
-//#endregion
 //#region src/iterator.d.ts
 declare const KNOWN_FLAG = "known-flag";
 declare const UNKNOWN_FLAG = "unknown-flag";
@@ -54,8 +51,8 @@ interface BaseFlagOptions<T extends TypeValue = TypeValue> {
   * e.g., String, Number, [String], (val) => val.split(',')
   */
   type: T;
-  /** Aliases for the flag. */
-  alias?: MaybeArray<string>;
+  /** Short flag alias (single character). */
+  short?: string;
   /** The default value of the flag. */
   default?: unknown;
   /** Whether the flag is required. */

package/dist/index.js

@@ -122,7 +122,6 @@ function iterateArgs(args, result, shouldProcessAsFlag, isKnownFlag, ignore, cal
 //#endregion
 //#region ../utils/src/index.ts
 const looseIsArray = (arr) => Array.isArray(arr);
-const toArray = (a) => Array.isArray(a) ? a : [a];
 /**
 * Converts a dash- or space-separated string to camelCase.
 * Not using regexp for better performance, because this function is used in parser.
@@ -161,8 +160,12 @@ function buildConfigsAndAliases(delimiters, flags) {
 	function validateFlagOptions(name, options) {
 		const prefix = `Flag "${name}"`;
 		if (Array.isArray(options.type) && options.type.length > 1) throw new InvalidSchemaError(`${prefix} has an invalid type array. Only single-element arrays are allowed to denote multiple occurrences.`);
+		if (name.length < 2) throw new InvalidSchemaError(`${prefix} name must be at least 2 characters long.`);
 		const names = [name];
-		if (options.alias) names.push(...toArray(options.alias));
+		if (options.short) {
+			if (options.short.length !== 1) throw new InvalidSchemaError(`${prefix} short flag must be exactly 1 character long.`);
+			names.push(options.short);
+		}
 		if (names.some(isNameInvalid)) throw new InvalidSchemaError(`${prefix} contains reserved characters, which are used as delimiters.`);
 	}
 	for (const [name, config] of Object.entries(flags)) {
@@ -171,10 +174,7 @@ function buildConfigsAndAliases(delimiters, flags) {
 		configs.set(name, normalized);
 		aliases.set(name, name);
 		aliases.set(camelCase(name), name);
-		if (normalized.alias) {
-			const list = Array.isArray(normalized.alias) ? normalized.alias : [normalized.alias];
-			for (const a of list) aliases.set(a, name);
-		}
+		if (normalized.short) aliases.set(normalized.short, name);
 	}
 	return {
 		configs,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerc/parser",
-  "version": "1.0.0-beta.24",
+  "version": "1.0.0-beta.25",
   "author": "Ray <i@mk1.io> (https://github.com/so1ve)",
   "type": "module",
   "description": "Clerc parser",
@@ -56,6 +56,6 @@
     "nopt": "^9.0.0",
     "type-flag": "^4.0.3",
     "yargs-parser": "^22.0.0",
-    "@clerc/utils": "1.0.0-beta.24"
+    "@clerc/utils": "1.0.0-beta.25"
   }
 }