@gunshi/definition 0.27.0-beta.3 → 0.27.0-beta.5

package/lib/index.d.ts

@@ -473,10 +473,10 @@ interface Args {
  *
  * @typeParam T - {@link Args | Arguments} which is an object that defines the command line arguments.
  */
-type ArgValues<T> = T extends Args ? ResolveArgValues<T, { [Arg in keyof T]: ExtractOptionValue<T[Arg]> }> : {
+type ArgValues<T$1> = T$1 extends Args ? ResolveArgValues<T$1, { [Arg in keyof T$1]: ExtractOptionValue<T$1[Arg]> }> : {
   [option: string]: string | boolean | number | (string | boolean | number)[] | undefined;
 };
-type IsFunction<T> = T extends ((...args: any[]) => any) ? true : false;
+type IsFunction<T$1> = T$1 extends ((...args: any[]) => any) ? true : false;
 /**
  * Extracts the value type from the argument schema.
  *
@@ -484,8 +484,8 @@ type IsFunction<T> = T extends ((...args: any[]) => any) ? true : false;
  *
  * @internal
  */
-type ExtractOptionValue<A extends ArgSchema> = A['type'] extends 'string' ? ResolveOptionValue<A, string> : A['type'] extends 'boolean' ? ResolveOptionValue<A, boolean> : A['type'] extends 'number' ? ResolveOptionValue<A, number> : A['type'] extends 'positional' ? ResolveOptionValue<A, string> : A['type'] extends 'enum' ? A['choices'] extends string[] | readonly string[] ? ResolveOptionValue<A, A['choices'][number]> : never : A['type'] extends 'custom' ? IsFunction<A['parse']> extends true ? ResolveOptionValue<A, ReturnType<NonNullable<A['parse']>>> : never : ResolveOptionValue<A, string | boolean | number>;
-type ResolveOptionValue<A extends ArgSchema, T> = A['multiple'] extends true ? T[] : T;
+type ExtractOptionValue<A$1 extends ArgSchema> = A$1['type'] extends 'string' ? ResolveOptionValue<A$1, string> : A$1['type'] extends 'boolean' ? ResolveOptionValue<A$1, boolean> : A$1['type'] extends 'number' ? ResolveOptionValue<A$1, number> : A$1['type'] extends 'positional' ? ResolveOptionValue<A$1, string> : A$1['type'] extends 'enum' ? A$1['choices'] extends string[] | readonly string[] ? ResolveOptionValue<A$1, A$1['choices'][number]> : never : A$1['type'] extends 'custom' ? IsFunction<A$1['parse']> extends true ? ResolveOptionValue<A$1, ReturnType<NonNullable<A$1['parse']>>> : never : ResolveOptionValue<A$1, string | boolean | number>;
+type ResolveOptionValue<A$1 extends ArgSchema, T$1> = A$1['multiple'] extends true ? T$1[] : T$1;
 /**
  * Resolved argument values.
  *
@@ -494,7 +494,7 @@ type ResolveOptionValue<A extends ArgSchema, T> = A['multiple'] extends true ? T
  *
  * @internal
  */
-type ResolveArgValues<A extends Args, V extends Record<keyof A, unknown>> = { -readonly [Arg in keyof A]?: V[Arg] } & FilterArgs<A, V, 'default'> & FilterArgs<A, V, 'required'> & FilterPositionalArgs<A, V> extends infer P ? { [K in keyof P]: P[K] } : never;
+type ResolveArgValues<A$1 extends Args, V extends Record<keyof A$1, unknown>> = { -readonly [Arg in keyof A$1]?: V[Arg] } & FilterArgs<A$1, V, 'default'> & FilterArgs<A$1, V, 'required'> & FilterPositionalArgs<A$1, V> extends infer P ? { [K in keyof P]: P[K] } : never;
 /**
  * Filters the arguments based on their default values.
  *
@@ -504,7 +504,7 @@ type ResolveArgValues<A extends Args, V extends Record<keyof A, unknown>> = { -r
  *
  * @internal
  */
-type FilterArgs<A extends Args, V extends Record<keyof A, unknown>, K extends keyof ArgSchema> = { [Arg in keyof A as A[Arg][K] extends {} ? Arg : never]: V[Arg] };
+type FilterArgs<A$1 extends Args, V extends Record<keyof A$1, unknown>, K$1 extends keyof ArgSchema> = { [Arg in keyof A$1 as A$1[Arg][K$1] extends {} ? Arg : never]: V[Arg] };
 /**
  * Filters positional arguments from the argument schema.
  *
@@ -513,7 +513,7 @@ type FilterArgs<A extends Args, V extends Record<keyof A, unknown>, K extends ke
  *
  * @internal
  */
-type FilterPositionalArgs<A extends Args, V extends Record<keyof A, unknown>> = { [Arg in keyof A as A[Arg]['type'] extends 'positional' ? Arg : never]: V[Arg] };
+type FilterPositionalArgs<A$1 extends Args, V extends Record<keyof A$1, unknown>> = { [Arg in keyof A$1 as A$1[Arg]['type'] extends 'positional' ? Arg : never]: V[Arg] };
 /**
  * An arguments for {@link resolveArgs | resolve arguments}.
  */
@@ -526,7 +526,7 @@ type FilterPositionalArgs<A extends Args, V extends Record<keyof A, unknown>> =
  *
  * @typeParam A - {@link Args | Arguments}, which is an object that defines the command line arguments.
  */
-type ArgExplicitlyProvided<A extends Args> = { [K in keyof A]: boolean };
+type ArgExplicitlyProvided<A$1 extends Args> = { [K in keyof A$1]: boolean };
 /**
  * Resolve command line arguments.
  *
@@ -682,11 +682,11 @@ type PluginFunction<G extends GunshiParams = DefaultGunshiParams> = (ctx: Readon
  *
  * @since v0.27.0
  */
-type Plugin<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> = PluginFunction & {
+type Plugin<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> = PluginFunction & {
   id: string;
   name?: string;
   dependencies?: (PluginDependency | string)[];
-  extension?: CommandContextExtension<E>;
+  extension?: CommandContextExtension<E$1>;
 };
 //#endregion
 //#region ../gunshi/src/types.d.ts
@@ -695,13 +695,13 @@ type Plugin<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensio
  *
  * @typeParam T - The type of the value that can be awaited.
  */
-type Awaitable<T> = T | Promise<T>;
+type Awaitable<T$1> = T$1 | Promise<T$1>;
 /**
  * Prettify a type by flattening its structure.
  *
  * @typeParam T - The type to be prettified.
  */
-type Prettify<T> = { [K in keyof T]: T[K] } & {};
+type Prettify<T$1> = { [K in keyof T$1]: T$1[K] } & {};
 /**
  * Extend command context type. This type is used to extend the command context with additional properties at {@linkcode CommandContext.extensions}.
  *
@@ -717,7 +717,7 @@ type ExtendContext = Record<string, unknown>;
  *
  * @since v0.27.0
  */
-interface GunshiParams<P extends {
+interface GunshiParams<P$1 extends {
   args?: Args;
   extensions?: ExtendContext;
 } = {
@@ -727,13 +727,13 @@ interface GunshiParams<P extends {
   /**
    * Command argument definitions.
    */
-  args: P extends {
+  args: P$1 extends {
     args: infer A extends Args;
   } ? A : Args;
   /**
    * Command context extensions.
    */
-  extensions: P extends {
+  extensions: P$1 extends {
     extensions: infer E extends ExtendContext;
   } ? E : {};
 }
@@ -1099,7 +1099,7 @@ type CommandContextCore<G extends GunshiParamsConstraint = DefaultGunshiParams>
  *
  * @since v0.27.0
  */
-interface CommandContextExtension<E extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> {
+interface CommandContextExtension<E$1 extends GunshiParams['extensions'] = DefaultGunshiParams['extensions']> {
   /**
    * Plugin identifier
    */
@@ -1107,7 +1107,7 @@ interface CommandContextExtension<E extends GunshiParams['extensions'] = Default
   /**
    * Plugin extension factory
    */
-  readonly factory: (ctx: CommandContextCore, cmd: Command) => Awaitable<E>;
+  readonly factory: (ctx: CommandContextCore, cmd: Command) => Awaitable<E$1>;
   /**
    * Plugin extension factory after hook
    */
@@ -1256,7 +1256,7 @@ type CommandLoader<G extends GunshiParamsConstraint = DefaultGunshiParams> = ()
  *
  * @internal
  */
-type ExtractExtensions$1<E extends Record<string, CommandContextExtension>> = { [K in keyof E]: E[K] extends CommandContextExtension<infer T> ? T : never };
+type ExtractExtensions$1<E$1 extends Record<string, CommandContextExtension>> = { [K in keyof E$1]: E$1[K] extends CommandContextExtension<infer T> ? T : never };
 /**
  * Parameters of {@link createCommandContext}
  */
@@ -1264,7 +1264,7 @@ interface CommandContextParams<G extends GunshiParams | {
   args: Args;
 } | {
   extensions: ExtendContext;
-}, V extends ArgValues<ExtractArgs<G>>, C extends Command<G> | LazyCommand<G> = Command<G>, E extends Record<string, CommandContextExtension> = Record<string, CommandContextExtension>> {
+}, V extends ArgValues<ExtractArgs<G>>, C extends Command<G> | LazyCommand<G> = Command<G>, E$1 extends Record<string, CommandContextExtension> = Record<string, CommandContextExtension>> {
   /**
    * An arguments of target command
    */
@@ -1308,7 +1308,7 @@ interface CommandContextParams<G extends GunshiParams | {
   /**
    * Plugin extensions to apply as the command context extension.
    */
-  extensions?: E;
+  extensions?: E$1;
   /**
    * A command options, which is spicialized from `cli` function
    */
@@ -1324,7 +1324,7 @@ interface CommandContextParams<G extends GunshiParams | {
  * @param param - A {@link CommandContextParams | parameters} to create a command context.
  * @returns A {@link CommandContext | command context}, which is readonly.
  */
-declare function createCommandContext<G extends GunshiParamsConstraint = DefaultGunshiParams, V extends ArgValues<ExtractArgs<G>> = ArgValues<ExtractArgs<G>>, C extends Command<G> | LazyCommand<G> = Command<G>, E extends Record<string, CommandContextExtension> = {}>({
+declare function createCommandContext<G extends GunshiParamsConstraint = DefaultGunshiParams, V extends ArgValues<ExtractArgs<G>> = ArgValues<ExtractArgs<G>>, C extends Command<G> | LazyCommand<G> = Command<G>, E$1 extends Record<string, CommandContextExtension> = {}>({
   args,
   explicit,
   values,
@@ -1338,9 +1338,9 @@ declare function createCommandContext<G extends GunshiParamsConstraint = Default
   callMode,
   omitted,
   validationError
-}: CommandContextParams<G, V, C, E>): Promise<{} extends ExtractExtensions$1<E> ? Readonly<CommandContext<G>> : Readonly<CommandContext<GunshiParams<{
+}: CommandContextParams<G, V, C, E$1>): Promise<{} extends ExtractExtensions$1<E$1> ? Readonly<CommandContext<G>> : Readonly<CommandContext<GunshiParams<{
   args: ExtractArgs<G>;
-  extensions: ExtractExtensions$1<E>;
+  extensions: ExtractExtensions$1<E$1>;
 }>>>>;
 //#endregion
 //#region ../gunshi/src/definition.d.ts
@@ -1386,8 +1386,8 @@ type CommandDefinitionResult<G extends GunshiParamsConstraint = DefaultGunshiPar
  * @param definition - A {@link Command | command} definition
  * @returns A defined {@link Command | command}
  */
-declare function define<G extends GunshiParamsConstraint = DefaultGunshiParams, A extends Args = ExtractArgs<G>, C extends InferCommandProps<G> = InferCommandProps<G>>(definition: C & Command<{
-  args: A;
+declare function define<G extends GunshiParamsConstraint = DefaultGunshiParams, A$1 extends Args = ExtractArgs<G>, C extends InferCommandProps<G> = InferCommandProps<G>>(definition: C & Command<{
+  args: A$1;
   extensions: ExtractExtensions<G>;
 }>): CommandDefinitionResult<G, C>;
 /**
@@ -1397,14 +1397,14 @@ declare function define<G extends GunshiParamsConstraint = DefaultGunshiParams,
  *
  * @internal
  */
-type DefineWithTypesReturn<DefaultExtensions extends ExtendContext, DefaultArgs extends Args> = <A extends DefaultArgs = DefaultArgs, C extends Partial<Command<{
-  args: A;
+type DefineWithTypesReturn<DefaultExtensions extends ExtendContext, DefaultArgs extends Args> = <A$1 extends DefaultArgs = DefaultArgs, C extends Partial<Command<{
+  args: A$1;
   extensions: DefaultExtensions;
 }>> = {}>(definition: C & Command<{
-  args: A;
+  args: A$1;
   extensions: DefaultExtensions;
 }>) => CommandDefinitionResult<{
-  args: A;
+  args: A$1;
   extensions: DefaultExtensions;
 }, C>;
 /**
@@ -1451,11 +1451,11 @@ declare function defineWithTypes<G extends GunshiParamsConstraint>(): DefineWith
  * @param loader - A {@link CommandLoader | command loader}
  * @returns A {@link LazyCommand | lazy command} with loader
  */
-declare function lazy<A extends Args>(loader: CommandLoader<{
-  args: A;
+declare function lazy<A$1 extends Args>(loader: CommandLoader<{
+  args: A$1;
   extensions: {};
 }>): LazyCommand<{
-  args: A;
+  args: A$1;
   extensions: {};
 }, {}>;
 /**
@@ -1493,17 +1493,17 @@ declare function lazy<A extends Args>(loader: CommandLoader<{
  * @param definition - An optional {@link Command | command} definition
  * @returns A {@link LazyCommand | lazy command} that can be executed later
  */
-declare function lazy<G extends GunshiParamsConstraint = DefaultGunshiParams, A extends ExtractArgs<G> = ExtractArgs<G>, D extends Partial<Command<{
-  args: A;
+declare function lazy<G extends GunshiParamsConstraint = DefaultGunshiParams, A$1 extends ExtractArgs<G> = ExtractArgs<G>, D extends Partial<Command<{
+  args: A$1;
   extensions: {};
 }>> = Partial<Command<{
-  args: A;
+  args: A$1;
   extensions: {};
 }>>>(loader: CommandLoader<{
-  args: A;
+  args: A$1;
   extensions: {};
 }>, definition: D): LazyCommand<{
-  args: A;
+  args: A$1;
   extensions: {};
 }, D>;
 /**

package/lib/index.js

@@ -70,6 +70,21 @@ function deepFreeze(obj, ignores = []) {
 //#endregion
 //#region ../gunshi/src/context.ts
 /**
+* The entry for gunshi context.
+* This module is exported for the purpose of testing the command.
+*
+* @example
+* ```js
+* import { createCommandContext } from 'gunshi/context'
+* ```
+*
+* @module
+*/
+/**
+* @author kazuya kawaguchi (a.k.a. kazupon)
+* @license MIT
+*/
+/**
 * Create a command context.
 *
 * @param param - A {@link CommandContextParams | parameters} to create a command context.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@gunshi/definition",
   "description": "utilities for gunshi command definition",
-  "version": "0.27.0-beta.3",
+  "version": "0.27.0-beta.5",
   "author": {
     "name": "kazuya kawaguchi",
     "email": "kawakazu80@gmail.com"
@@ -52,12 +52,12 @@
     }
   },
   "devDependencies": {
-    "deno": "^2.5.4",
+    "deno": "^2.5.6",
     "jsr": "^0.13.5",
     "jsr-exports-lint": "^0.4.1",
-    "publint": "^0.3.14",
-    "tsdown": "0.15.9",
-    "gunshi": "0.27.0-beta.3"
+    "publint": "^0.3.15",
+    "tsdown": "0.15.12",
+    "gunshi": "0.27.0-beta.5"
   },
   "scripts": {
     "build": "tsdown",