@stricli/core 1.2.3 → 1.2.5

package/dist/index.d.cts

@@ -581,6 +581,15 @@ interface BaseBooleanFlagParameter extends BaseFlagParameter {
      * If no value is provided, boolean flags default to `false`.
      */
     readonly default?: boolean;
+    /**
+     * Whether to generate a negated version of this flag (e.g., `--no-foo` for `--foo`).
+     *
+     * By default, boolean flags with a non-false default value automatically generate a negated version.
+     * Set this to `false` to disable the negated flag generation.
+     *
+     * Defaults to `true`.
+     */
+    readonly withNegated?: boolean;
 }
 type RequiredBooleanFlagParameter = BaseBooleanFlagParameter & {
     /**
@@ -660,8 +669,9 @@ interface BaseEnumFlagParameter<T extends string> extends BaseFlagParameter {
     readonly values: readonly T[];
     /**
      * Default input value if one is not provided at runtime.
+     * For variadic flags, this can be an array of default values.
      */
-    readonly default?: T;
+    readonly default?: T | readonly T[];
     readonly optional?: boolean;
     readonly hidden?: boolean;
     readonly variadic?: boolean | string;
@@ -697,9 +707,10 @@ interface OptionalEnumFlagParameter<T extends string> extends BaseEnumFlagParame
 }
 interface OptionalVariadicEnumFlagParameter<T extends string> extends BaseEnumFlagParameter<T> {
     /**
-     * Default values are not supported for variadic parameters.
+     * Default values to use if no arguments are provided at runtime.
+     * Values must be valid members of the enum values array.
      */
-    readonly default?: undefined;
+    readonly default?: readonly T[];
     /**
      * Optional variadic parameter will parse to an empty array if no arguments are found.
      */
@@ -719,16 +730,18 @@ interface OptionalVariadicEnumFlagParameter<T extends string> extends BaseEnumFl
 }
 interface RequiredVariadicEnumFlagParameter<T extends string> extends BaseEnumFlagParameter<T> {
     /**
-     * Default values are not supported for variadic parameters.
+     * Default values to use if no arguments are provided at runtime.
+     * Values must be valid members of the enum values array.
+     * If a default is provided, the parameter becomes optional at runtime.
      */
-    readonly default?: undefined;
+    readonly default?: readonly T[];
     /**
      * Parameter is required and cannot be set as optional.
      * Expects at least one value to be satisfied.
      */
     readonly optional?: false;
     /**
-     * Parameter is required and cannot be set as hidden.
+     * Parameter is required and cannot be set as hidden without a default value.
      */
     readonly hidden?: false;
     /**
@@ -747,8 +760,9 @@ interface BaseParsedFlagParameter<T, CONTEXT extends CommandContext> extends Par
     readonly kind: "parsed";
     /**
      * Default input value if one is not provided at runtime.
+     * For variadic flags, this can be an array of input strings to be parsed.
      */
-    readonly default?: string;
+    readonly default?: string | readonly string[];
     /**
      * If flag is specified with no corresponding input, infer an empty string `""` as the input.
      */
@@ -816,9 +830,10 @@ interface OptionalVariadicParsedFlagParameter<T, CONTEXT extends CommandContext>
      */
     readonly variadic: true | string;
     /**
-     * Default values are not supported for variadic parameters.
+     * Default input values to parse if no arguments are provided at runtime.
+     * These will be parsed using the flag's parse function.
      */
-    readonly default?: undefined;
+    readonly default?: readonly string[];
 }
 interface RequiredVariadicParsedFlagParameter<T, CONTEXT extends CommandContext> extends BaseParsedFlagParameter<T, CONTEXT> {
     /**
@@ -835,9 +850,11 @@ interface RequiredVariadicParsedFlagParameter<T, CONTEXT extends CommandContext>
      */
     readonly variadic: true | string;
     /**
-     * Default values are not supported for variadic parameters.
+     * Default input values to parse if no arguments are provided at runtime.
+     * These will be parsed using the flag's parse function.
+     * If a default is provided, the parameter becomes optional at runtime.
      */
-    readonly default?: undefined;
+    readonly default?: readonly string[];
 }
 type TypedFlagParameter_Optional<T, CONTEXT extends CommandContext> = [T] extends [readonly (infer A)[]] ? [A] extends [string] ? OptionalVariadicParsedFlagParameter<A, CONTEXT> | OptionalParsedFlagParameter<T, CONTEXT> | OptionalVariadicEnumFlagParameter<A> : OptionalVariadicParsedFlagParameter<A, CONTEXT> | OptionalParsedFlagParameter<T, CONTEXT> : [T] extends [boolean] ? OptionalBooleanFlagParameter | OptionalParsedFlagParameter<boolean, CONTEXT> : [T] extends [number] ? OptionalCounterFlagParameter | OptionalParsedFlagParameter<number, CONTEXT> : string extends T ? OptionalParsedFlagParameter<string, CONTEXT> : [T] extends [string] ? OptionalEnumFlagParameter<T> | OptionalParsedFlagParameter<T, CONTEXT> : OptionalParsedFlagParameter<T, CONTEXT>;
 type TypedFlagParameter_Required<T, CONTEXT extends CommandContext> = [T] extends [readonly (infer A)[]] ? [A] extends [string] ? RequiredVariadicParsedFlagParameter<A, CONTEXT> | RequiredParsedFlagParameter<readonly A[], CONTEXT> | RequiredVariadicEnumFlagParameter<A> : RequiredVariadicParsedFlagParameter<A, CONTEXT> | RequiredParsedFlagParameter<readonly A[], CONTEXT> : [T] extends [boolean] ? RequiredBooleanFlagParameter | RequiredParsedFlagParameter<boolean, CONTEXT> : [T] extends [number] ? RequiredCounterFlagParameter | RequiredParsedFlagParameter<number, CONTEXT> : string extends T ? RequiredParsedFlagParameter<string, CONTEXT> : [T] extends [string] ? RequiredEnumFlagParameter<T> | RequiredParsedFlagParameter<T, CONTEXT> : RequiredParsedFlagParameter<T, CONTEXT>;
@@ -1043,6 +1060,7 @@ interface HelpFormattingArguments extends UsageFormattingArguments {
 }
 interface DocumentedTarget {
     readonly brief: string;
+    readonly fullDescription: string | undefined;
     readonly formatUsageLine: (args: UsageFormattingArguments) => string;
     readonly formatHelp: (args: HelpFormattingArguments) => string;
 }

package/dist/index.d.ts

@@ -581,6 +581,15 @@ interface BaseBooleanFlagParameter extends BaseFlagParameter {
      * If no value is provided, boolean flags default to `false`.
      */
     readonly default?: boolean;
+    /**
+     * Whether to generate a negated version of this flag (e.g., `--no-foo` for `--foo`).
+     *
+     * By default, boolean flags with a non-false default value automatically generate a negated version.
+     * Set this to `false` to disable the negated flag generation.
+     *
+     * Defaults to `true`.
+     */
+    readonly withNegated?: boolean;
 }
 type RequiredBooleanFlagParameter = BaseBooleanFlagParameter & {
     /**
@@ -660,8 +669,9 @@ interface BaseEnumFlagParameter<T extends string> extends BaseFlagParameter {
     readonly values: readonly T[];
     /**
      * Default input value if one is not provided at runtime.
+     * For variadic flags, this can be an array of default values.
      */
-    readonly default?: T;
+    readonly default?: T | readonly T[];
     readonly optional?: boolean;
     readonly hidden?: boolean;
     readonly variadic?: boolean | string;
@@ -697,9 +707,10 @@ interface OptionalEnumFlagParameter<T extends string> extends BaseEnumFlagParame
 }
 interface OptionalVariadicEnumFlagParameter<T extends string> extends BaseEnumFlagParameter<T> {
     /**
-     * Default values are not supported for variadic parameters.
+     * Default values to use if no arguments are provided at runtime.
+     * Values must be valid members of the enum values array.
      */
-    readonly default?: undefined;
+    readonly default?: readonly T[];
     /**
      * Optional variadic parameter will parse to an empty array if no arguments are found.
      */
@@ -719,16 +730,18 @@ interface OptionalVariadicEnumFlagParameter<T extends string> extends BaseEnumFl
 }
 interface RequiredVariadicEnumFlagParameter<T extends string> extends BaseEnumFlagParameter<T> {
     /**
-     * Default values are not supported for variadic parameters.
+     * Default values to use if no arguments are provided at runtime.
+     * Values must be valid members of the enum values array.
+     * If a default is provided, the parameter becomes optional at runtime.
      */
-    readonly default?: undefined;
+    readonly default?: readonly T[];
     /**
      * Parameter is required and cannot be set as optional.
      * Expects at least one value to be satisfied.
      */
     readonly optional?: false;
     /**
-     * Parameter is required and cannot be set as hidden.
+     * Parameter is required and cannot be set as hidden without a default value.
      */
     readonly hidden?: false;
     /**
@@ -747,8 +760,9 @@ interface BaseParsedFlagParameter<T, CONTEXT extends CommandContext> extends Par
     readonly kind: "parsed";
     /**
      * Default input value if one is not provided at runtime.
+     * For variadic flags, this can be an array of input strings to be parsed.
      */
-    readonly default?: string;
+    readonly default?: string | readonly string[];
     /**
      * If flag is specified with no corresponding input, infer an empty string `""` as the input.
      */
@@ -816,9 +830,10 @@ interface OptionalVariadicParsedFlagParameter<T, CONTEXT extends CommandContext>
      */
     readonly variadic: true | string;
     /**
-     * Default values are not supported for variadic parameters.
+     * Default input values to parse if no arguments are provided at runtime.
+     * These will be parsed using the flag's parse function.
      */
-    readonly default?: undefined;
+    readonly default?: readonly string[];
 }
 interface RequiredVariadicParsedFlagParameter<T, CONTEXT extends CommandContext> extends BaseParsedFlagParameter<T, CONTEXT> {
     /**
@@ -835,9 +850,11 @@ interface RequiredVariadicParsedFlagParameter<T, CONTEXT extends CommandContext>
      */
     readonly variadic: true | string;
     /**
-     * Default values are not supported for variadic parameters.
+     * Default input values to parse if no arguments are provided at runtime.
+     * These will be parsed using the flag's parse function.
+     * If a default is provided, the parameter becomes optional at runtime.
      */
-    readonly default?: undefined;
+    readonly default?: readonly string[];
 }
 type TypedFlagParameter_Optional<T, CONTEXT extends CommandContext> = [T] extends [readonly (infer A)[]] ? [A] extends [string] ? OptionalVariadicParsedFlagParameter<A, CONTEXT> | OptionalParsedFlagParameter<T, CONTEXT> | OptionalVariadicEnumFlagParameter<A> : OptionalVariadicParsedFlagParameter<A, CONTEXT> | OptionalParsedFlagParameter<T, CONTEXT> : [T] extends [boolean] ? OptionalBooleanFlagParameter | OptionalParsedFlagParameter<boolean, CONTEXT> : [T] extends [number] ? OptionalCounterFlagParameter | OptionalParsedFlagParameter<number, CONTEXT> : string extends T ? OptionalParsedFlagParameter<string, CONTEXT> : [T] extends [string] ? OptionalEnumFlagParameter<T> | OptionalParsedFlagParameter<T, CONTEXT> : OptionalParsedFlagParameter<T, CONTEXT>;
 type TypedFlagParameter_Required<T, CONTEXT extends CommandContext> = [T] extends [readonly (infer A)[]] ? [A] extends [string] ? RequiredVariadicParsedFlagParameter<A, CONTEXT> | RequiredParsedFlagParameter<readonly A[], CONTEXT> | RequiredVariadicEnumFlagParameter<A> : RequiredVariadicParsedFlagParameter<A, CONTEXT> | RequiredParsedFlagParameter<readonly A[], CONTEXT> : [T] extends [boolean] ? RequiredBooleanFlagParameter | RequiredParsedFlagParameter<boolean, CONTEXT> : [T] extends [number] ? RequiredCounterFlagParameter | RequiredParsedFlagParameter<number, CONTEXT> : string extends T ? RequiredParsedFlagParameter<string, CONTEXT> : [T] extends [string] ? RequiredEnumFlagParameter<T> | RequiredParsedFlagParameter<T, CONTEXT> : RequiredParsedFlagParameter<T, CONTEXT>;
@@ -1043,6 +1060,7 @@ interface HelpFormattingArguments extends UsageFormattingArguments {
 }
 interface DocumentedTarget {
     readonly brief: string;
+    readonly fullDescription: string | undefined;
     readonly formatUsageLine: (args: UsageFormattingArguments) => string;
     readonly formatHelp: (args: HelpFormattingArguments) => string;
 }