@crustjs/core 0.0.10 → 0.0.11

package/dist/index.d.ts

@@ -377,7 +377,7 @@ type MergeFlags<
 type EffectiveFlags<
 	Inherited extends FlagsDef,
 	Local extends FlagsDef
-> = MergeFlags<InheritableFlags<Inherited>, Local>;
+> = string extends keyof Inherited ? Local : MergeFlags<InheritableFlags<Inherited>, Local>;
 /**
 * Infer the resolved type for a single ArgDef:
 *
@@ -615,6 +615,7 @@ declare const VALIDATION_MODE_ENV = "CRUST_INTERNAL_VALIDATE_ONLY";
 * - `Inherited` — flags inherited from a parent command (populated by `.command()`)
 * - `Local` — flags defined on this command via `.flags()`
 * - `A` — positional argument definitions
+* - `Eff` — effective flags (merged inherited + local flags, computed internally)
 *
 * @example
 * ```ts
@@ -631,13 +632,15 @@ declare const VALIDATION_MODE_ENV = "CRUST_INTERNAL_VALIDATE_ONLY";
 declare class Crust<
 	Inherited extends FlagsDef = FlagsDef,
 	Local extends FlagsDef = FlagsDef,
-	A extends ArgsDef = ArgsDef
+	A extends ArgsDef = ArgsDef,
+	Eff extends FlagsDef = EffectiveFlags<Inherited, Local>
 > {
 	/** @internal — Phantom property exposing generic parameters for type-level testing */
 	readonly _types: {
 		inherited: Inherited;
 		local: Local;
 		args: A;
+		effective: Eff;
 	};
 	/** @internal */
 	readonly _node: CommandNode;
@@ -654,7 +657,7 @@ declare class Crust<
 	* @internal — Create a child builder with pre-populated inherited flags.
 	* Used by `.command()` to propagate parent flags to the child.
 	*/
-	static _createChild<I extends FlagsDef>(name: string, inheritedFlags: FlagsDef): Crust<I, {}, []>;
+	static _createChild<I extends FlagsDef>(name: string, inheritedFlags: FlagsDef): Crust<I, {}, [], EffectiveFlags<I, {}>>;
 	/**
 	* @internal — Clone this builder with a new node, preserving generics.
 	*/
@@ -671,18 +674,22 @@ declare class Crust<
 	* @param meta - Metadata fields to set (description, usage)
 	* @returns A new `Crust` instance with updated metadata
 	*/
-	meta(meta: Omit<CommandMeta, "name">): Crust<Inherited, Local, A>;
+	meta(meta: Omit<CommandMeta, "name">): Crust<Inherited, Local, A, Eff>;
 	/**
 	* Define local flags for this command.
 	*
 	* Returns a new builder with updated local flag types. The original
 	* builder is not mutated.
 	*
+	* NOTE: Compile-time inherited/local cross-collision checks are intentionally
+	* omitted here to reduce TypeScript type-check cost in large projects.
+	* Runtime collision checks still run during parsing and command-tree validation.
+	*
 	* @param defs - Flag definitions record
 	* @returns A new `Crust` instance with the given flags
 	* @throws {CrustError} `DEFINITION` if flag names/aliases violate constraints
 	*/
-	flags<const F extends FlagsDef>(defs: F & ValidateNoPrefixedFlags<ValidateFlagAliases<F>> & ValidateCrossCollisions<Inherited, F>): Crust<Inherited, F, A>;
+	flags<const F extends FlagsDef>(defs: F & ValidateNoPrefixedFlags<ValidateFlagAliases<F>>): Crust<Inherited, F, A, EffectiveFlags<Inherited, F>>;
 	/**
 	* Define positional arguments for this command.
 	*
@@ -692,7 +699,7 @@ declare class Crust<
 	* @param defs - Ordered tuple of positional argument definitions
 	* @returns A new `Crust` instance with the given args
 	*/
-	args<const NewA extends ArgsDef>(defs: NewA & ValidateVariadicArgs<NewA>): Crust<Inherited, Local, NewA>;
+	args<const NewA extends ArgsDef>(defs: NewA & ValidateVariadicArgs<NewA>): Crust<Inherited, Local, NewA, Eff>;
 	/**
 	* Set the main command handler.
 	*
@@ -706,7 +713,7 @@ declare class Crust<
 	* @param handler - The main command handler function
 	* @returns A new `Crust` instance with the handler registered
 	*/
-	run(handler: (ctx: NoInfer<CrustCommandContext<A, EffectiveFlags<Inherited, Local>>>) => void | Promise<void>): Crust<Inherited, Local, A>;
+	run(handler: (ctx: NoInfer<CrustCommandContext<A, Eff>>) => void | Promise<void>): Crust<Inherited, Local, A, Eff>;
 	/**
 	* Set the pre-run lifecycle hook.
 	*
@@ -716,7 +723,7 @@ declare class Crust<
 	* @param handler - The pre-run handler function
 	* @returns A new `Crust` instance with the preRun handler registered
 	*/
-	preRun(handler: (ctx: NoInfer<CrustCommandContext<A, EffectiveFlags<Inherited, Local>>>) => void | Promise<void>): Crust<Inherited, Local, A>;
+	preRun(handler: (ctx: NoInfer<CrustCommandContext<A, Eff>>) => void | Promise<void>): Crust<Inherited, Local, A, Eff>;
 	/**
 	* Set the post-run lifecycle hook.
 	*
@@ -726,7 +733,7 @@ declare class Crust<
 	* @param handler - The post-run handler function
 	* @returns A new `Crust` instance with the postRun handler registered
 	*/
-	postRun(handler: (ctx: NoInfer<CrustCommandContext<A, EffectiveFlags<Inherited, Local>>>) => void | Promise<void>): Crust<Inherited, Local, A>;
+	postRun(handler: (ctx: NoInfer<CrustCommandContext<A, Eff>>) => void | Promise<void>): Crust<Inherited, Local, A, Eff>;
 	/**
 	* Register a plugin on this command.
 	*
@@ -740,7 +747,7 @@ declare class Crust<
 	* @param plugin - The plugin to register
 	* @returns A new `Crust` instance with the plugin registered
 	*/
-	use(plugin: CrustPlugin): Crust<Inherited, Local, A>;
+	use(plugin: CrustPlugin): Crust<Inherited, Local, A, Eff>;
 	/**
 	* Create a subcommand builder pre-typed with this command's inheritable flags.
 	*
@@ -773,7 +780,7 @@ declare class Crust<
 	* app.command(deployCmd).execute();
 	* ```
 	*/
-	sub<N extends string>(name: N): Crust<EffectiveFlags<Inherited, Local>, {}, []>;
+	sub<N extends string>(name: N): Crust<Eff, {}, [], EffectiveFlags<Eff, {}>>;
 	/**
 	* Register a named subcommand via inline callback.
 	*
@@ -786,7 +793,7 @@ declare class Crust<
 	* @returns A new `Crust` instance with the subcommand registered
 	* @throws {CrustError} `DEFINITION` if name is empty or already registered
 	*/
-	command<N extends string>(name: N, cb: (cmd: Crust<EffectiveFlags<Inherited, Local>, {}, []>) => Crust<any, any, any>): Crust<Inherited, Local, A>;
+	command<N extends string>(name: N, cb: (cmd: Crust<Eff, {}, [], EffectiveFlags<Eff, {}>>) => Crust<any, any, any>): Crust<Inherited, Local, A, Eff>;
 	/**
 	* Register a pre-built subcommand builder (from `.sub()`).
 	*
@@ -798,7 +805,7 @@ declare class Crust<
 	* @returns A new `Crust` instance with the subcommand registered
 	* @throws {CrustError} `DEFINITION` if builder name is empty or already registered
 	*/
-	command(builder: Crust<any, any, any>): Crust<Inherited, Local, A>;
+	command(builder: Crust<any, any, any>): Crust<Inherited, Local, A, Eff>;
 	/**
 	* Parse `process.argv`, resolve subcommands, run plugins and middleware,
 	* and execute the matched command handler.

package/package.json

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