@breadc/core 1.0.0-beta.3 → 1.0.0-beta.4

package/dist/index.d.mts

@@ -657,6 +657,7 @@ declare function printVersion(context: Context): string;
 //#region src/error.d.ts
 declare abstract class BreadcError extends Error {}
 type BreadcAppErrorCause = {
+  group?: InternalGroup;
   command?: InternalCommand;
   commands?: (InternalCommand | InternalGroup)[];
 };
@@ -665,6 +666,7 @@ type BreadcAppErrorInput = BreadcAppErrorCause & {
 };
 declare class BreadcAppError extends BreadcError {
   static DUPLICATED_DEFAULT_COMMAND: string;
+  static DUPLICATED_DEFAULT_GROUP_COMMAND: string;
   static DUPLICATED_GROUP: string;
   static DUPLICATED_COMMAND: string;
   static NO_ACTION_BOUND: string;

package/dist/index.mjs

@@ -38,6 +38,7 @@ function rawOption(spec, type, long, short, init) {
 //#region src/error.ts
 var BreadcError = class extends Error {};
 var RuntimeError = class extends BreadcError {
+	static UNEXPECTED_ARGUMENTS = "Detect unexpected redundant arguments";
 	static REQUIRED_ARGUMENT_MISSING = "Missing required argument";
 	static OPTIONAL_ARGUMENT_ACCEPT_ONCE = "Optional argument can only be assigned once";
 	static REQUIRED_ARGUMENT_ACCEPT_ONCE = "Required argument can only be assigned once";
@@ -60,6 +61,7 @@ var RuntimeError = class extends BreadcError {
 };
 var BreadcAppError = class extends BreadcError {
 	static DUPLICATED_DEFAULT_COMMAND = `Find duplicated default commands`;
+	static DUPLICATED_DEFAULT_GROUP_COMMAND = `Find duplicated default group commands`;
 	static DUPLICATED_GROUP = `Find duplicated groups`;
 	static DUPLICATED_COMMAND = `Find duplicated commands`;
 	static NO_ACTION_BOUND = `There is no action function bound in this command`;
@@ -117,12 +119,10 @@ var ResolveOptionError = class extends BreadcError {
 function resolveOptionInput(spec, description, init) {
 	return typeof spec === "string" ? option(spec, description, init) : spec;
 }
-function defaultUnknownOptionMiddleware() {
-	return (_ctx, key, value) => ({
-		name: key,
-		value
-	});
-}
+const defaultUnknownOptionMiddleware = (_ctx, key, value) => ({
+	name: key,
+	value
+});
 
 //#endregion
 //#region src/breadc/command.ts
@@ -157,7 +157,7 @@ function command(spec, init) {
 	run.allowUnknownOption = (middleware) => {
 		if (!run._unknownOptionMiddlewares) run._unknownOptionMiddlewares = [];
 		if (typeof middleware === "function") run._unknownOptionMiddlewares.push(middleware);
-		else run._unknownOptionMiddlewares.push(defaultUnknownOptionMiddleware());
+		else run._unknownOptionMiddlewares.push(defaultUnknownOptionMiddleware);
 		return run;
 	};
 	run.action = (fn) => {
@@ -970,10 +970,14 @@ function parse(app, argv) {
 		commands: defaultCommands
 	});
 	const defaultCommand = defaultCommands[0];
-	doParse(context$1, defaultCommand !== void 0 && context$1.breadc._commands.length === 1 ? defaultCommand : void 0);
-	if (context$1.command || isVersion(context$1) || isHelp(context$1)) {} else if (defaultCommand) {
+	doParse(context$1, void 0, defaultCommand !== void 0 && context$1.breadc._commands.length === 1 ? defaultCommand : void 0);
+	if (context$1.command || isVersion(context$1) || isHelp(context$1)) {} else if (context$1.group) {
+		const matchedGroup = context$1.group;
+		reset(context$1);
+		doParse(context$1, matchedGroup, void 0);
+	} else if (defaultCommand) {
 		reset(context$1);
-		doParse(context$1, defaultCommand);
+		doParse(context$1, void 0, defaultCommand);
 	}
 	return context$1;
 }
@@ -993,7 +997,7 @@ function isVersion(context) {
 	if (version && context.options.get(version.long)?.value()) return true;
 	else return false;
 }
-function doParse(context, defaultCommand) {
+function doParse(context, defaultGroup, defaultCommand) {
 	const { breadc, tokens, options: matchedOptions } = context;
 	let index = 0;
 	let matchedGroup = void 0;
@@ -1030,10 +1034,8 @@ function doParse(context, defaultCommand) {
 	}
 	if (defaultCommand) {
 		matchedCommand = defaultCommand;
-		for (const command of breadc._commands) if (command._default) {
-			buildCommand(command);
-			addPendingOptions(command._options);
-		}
+		buildCommand(defaultCommand);
+		addPendingOptions(defaultCommand._options);
 	} else for (const command of breadc._commands) if (!command._default) for (let alias = 0; alias < command._pieces.length; alias++) addPendingCommand(command, alias);
 	while (!tokens.isEnd) {
 		const token = tokens.next();
@@ -1055,7 +1057,22 @@ function doParse(context, defaultCommand) {
 					});
 					buildGroup(group);
 					addPendingOptions(group._options);
-					for (const command of group._commands) for (let alias = 0; alias < command._pieces.length; alias++) addPendingCommand(command, alias);
+					if (matchedGroup && matchedGroup === defaultGroup) {
+						const defaultCommands = matchedGroup._commands.filter((command) => command._pieces.some((p) => p.length === index));
+						if (defaultCommands.length === 1) {
+							const defaultCommand = defaultCommands[0];
+							matchedCommand = defaultCommand;
+							buildCommand(defaultCommand);
+							addPendingOptions(defaultCommand._options);
+						} else if (defaultCommands.length > 1) throw new BreadcAppError(BreadcAppError.DUPLICATED_DEFAULT_GROUP_COMMAND, {
+							context,
+							group: matchedGroup,
+							commands: defaultCommands
+						});
+					} else for (const command of group._commands) for (let alias = 0; alias < command._pieces.length; alias++) {
+						if (command._pieces[alias].length === index) continue;
+						addPendingCommand(command, alias);
+					}
 				} else {
 					if (!matchedCommand || matchedCommand === command) matchedCommand = command;
 					else throw new BreadcAppError(BreadcAppError.DUPLICATED_COMMAND, {
@@ -1095,6 +1112,7 @@ function doParse(context, defaultCommand) {
 	context.group = matchedGroup;
 	context.command = matchedCommand;
 	if (matchedCommand) {
+		if (unknown.length > 0) throw new RuntimeError(RuntimeError.UNEXPECTED_ARGUMENTS, { context });
 		let i = 0;
 		for (; i < matchedCommand._arguments.length; i++) {
 			const argument = matchedCommand._arguments[i];
@@ -1192,8 +1210,11 @@ function group(spec, init) {
 			options.push(resolveOptionInput(spec, description, init));
 			return group;
 		},
-		command(spec, init) {
-			const command$2 = typeof spec === "string" ? command(spec, init) : spec;
+		command(spec, description, init) {
+			const command$2 = typeof spec === "string" ? command(spec, description || init ? {
+				description,
+				...init
+			} : void 0) : spec;
 			command$2._group = group;
 			commands.push(command$2);
 			return command$2;
@@ -1204,7 +1225,7 @@ function group(spec, init) {
 		},
 		allowUnknownOption(middleware) {
 			if (typeof middleware === "function") unknownOptionMiddlewares.push(middleware);
-			else unknownOptionMiddlewares.push(defaultUnknownOptionMiddleware());
+			else unknownOptionMiddlewares.push(defaultUnknownOptionMiddleware);
 			return group;
 		}
 	};
@@ -1255,7 +1276,7 @@ function breadc(name, init = {}) {
 		},
 		allowUnknownOption(middleware) {
 			if (typeof middleware === "function") unknownOptionMiddlewares.push(middleware);
-			else unknownOptionMiddlewares.push(defaultUnknownOptionMiddleware());
+			else unknownOptionMiddlewares.push(defaultUnknownOptionMiddleware);
 			return app;
 		},
 		parse(argv) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@breadc/core",
-  "version": "1.0.0-beta.3",
+  "version": "1.0.0-beta.4",
   "description": "Yet another Command Line Application Framework with fully strong TypeScript support",
   "keywords": [
     "breadc",
@@ -33,7 +33,7 @@
     "dist"
   ],
   "dependencies": {
-    "@breadc/color": "1.0.0-beta.3"
+    "@breadc/color": "1.0.0-beta.4"
   },
   "size-limit": [
     {