@crustjs/core 0.0.7 → 0.0.8

package/dist/index.d.ts

@@ -375,8 +375,8 @@ interface Command<
 	readonly args?: A;
 	/** Flag definitions */
 	readonly flags?: F;
-	/** Named subcommands */
-	readonly subCommands?: Record<string, AnyCommand>;
+	/** Named subcommands (always initialized, may be empty) */
+	readonly subCommands: Record<string, AnyCommand>;
 	/** Called before `run()` — useful for initialization */
 	preRun?(context: CommandContext<A, F>): void | Promise<void>;
 	/** The main command handler */
@@ -567,6 +567,19 @@ interface SetupActions {
 	* @param def - The flag definition
 	*/
 	addFlag(command: AnyCommand, name: string, def: FlagDef): void;
+	/**
+	* Inject a subcommand into a command's `subCommands` record.
+	*
+	* Use this in plugin `setup()` hooks to register plugin-provided commands
+	* (e.g. a "skill" management command). If the parent already has a
+	* subcommand with the same name (user-defined), the call is silently
+	* skipped — user definitions always take priority over plugin injections.
+	*
+	* @param parent - The parent command to add the subcommand to
+	* @param name - The subcommand name (used for routing)
+	* @param command - The subcommand to register
+	*/
+	addSubCommand(parent: AnyCommand, name: string, command: AnyCommand): void;
 }
 /** Shared context fields available in both setup and middleware phases. */
 interface BaseContext {
@@ -594,4 +607,4 @@ interface RunOptions {
 }
 declare function runCommand(command: AnyCommand, options?: RunOptions): Promise<void>;
 declare function runMain(command: AnyCommand, options?: RunOptions): Promise<void>;
-export { runMain, runCommand, resolveCommand, parseArgs, defineCommand, ValueType, ValidateVariadicArgs, ValidateNoPrefixedFlags, ValidateFlagAliases, SetupContext, RunOptions, PluginMiddleware, ParseResult, MiddlewareContext, InferFlags, InferArgs, FlagsDef, FlagDef, CrustPlugin, CrustErrorCode, CrustError, CommandRoute, CommandMeta, CommandDef, CommandContext, Command, ArgsDef, ArgDef, AnyCommand };
+export { runMain, runCommand, resolveCommand, parseArgs, defineCommand, ValueType, ValidateVariadicArgs, ValidateNoPrefixedFlags, ValidateFlagAliases, SetupContext, SetupActions, RunOptions, PluginMiddleware, ParseResult, MiddlewareContext, InferFlags, InferArgs, FlagsDef, FlagDef, CrustPlugin, CrustErrorCode, CrustError, CommandRoute, CommandMeta, CommandDef, CommandContext, Command, ArgsDef, ArgDef, AnyCommand };

package/dist/index.js

@@ -47,9 +47,7 @@ function defineCommand(config) {
       args: config.args.map((def) => ({ ...def }))
     },
     flags: config.flags ? Object.fromEntries(Object.entries(config.flags).map(([k, v]) => [k, { ...v }])) : {},
-    ...config.subCommands && {
-      subCommands: { ...config.subCommands }
-    }
+    subCommands: config.subCommands ? { ...config.subCommands } : {}
   };
   return Object.freeze(copy);
 }
@@ -392,6 +390,14 @@ async function runCommand(command, options) {
         throw new CrustError("DEFINITION", `Cannot add flag "${name}": command "${target.meta.name}" has no flags object.`);
       }
       target.flags[name] = def;
+    },
+    addSubCommand(parent, name, subCommand) {
+      if (!name.trim()) {
+        throw new CrustError("DEFINITION", "addSubCommand: name is required and must be a non-empty string");
+      }
+      if (parent.subCommands[name])
+        return;
+      parent.subCommands[name] = subCommand;
     }
   };
   const middlewareContext = {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@crustjs/core",
-	"version": "0.0.7",
+	"version": "0.0.8",
 	"description": "Core library for the Crust CLI framework",
 	"type": "module",
 	"license": "MIT",