npm - goke - Versions diffs - 6.5.1 → 6.6.0 - Mend

goke 6.5.1 → 6.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (16) hide show

package/README.md +39 -9
package/dist/__test__/index.test.js +16 -6
package/dist/__test__/readme-examples.test.d.ts +5 -0
package/dist/__test__/readme-examples.test.d.ts.map +1 -0
package/dist/__test__/readme-examples.test.js +169 -0
package/dist/__test__/types.test-d.js +242 -1
package/dist/goke.d.ts +122 -17
package/dist/goke.d.ts.map +1 -1
package/dist/goke.js +35 -5
package/dist/runtime-node.js +2 -2
package/package.json +2 -2
package/src/__test__/index.test.ts +16 -6
package/src/__test__/readme-examples.test.ts +225 -0
package/src/__test__/types.test-d.ts +271 -1
package/src/goke.ts +186 -20
package/src/runtime-node.ts +2 -2

package/dist/goke.d.ts CHANGED Viewed

@@ -73,6 +73,86 @@ type OptionEntry<RawName extends string, Schema> = IsOptionalOption<RawName> ext
 } : {
     [K in ExtractOptionName<RawName>]: InferSchemaOutput<Schema>;
 };
+/**
+ * Infer the raw runtime value shape for an option declared without a schema.
+ *
+ * Required value options (`--port <port>`) always reach actions as strings.
+ * Optional value options (`--host [host]`) reach actions as strings: the
+ * empty string `''` when the flag is passed bare (`--host`), the given
+ * value when passed with one (`--host example.com`), and `undefined` when
+ * the flag is omitted entirely. This lets callers use a single `typeof`
+ * check and, if they really care, distinguish "omitted" from "present but
+ * empty" via `=== undefined` vs `=== ''`.
+ * Plain flags (`--verbose`) are booleans.
+ */
+type UntypedOptionValue<RawName extends string> = RawName extends `${string}<${string}>` ? string : RawName extends `${string}[${string}]` ? string : boolean | undefined;
+/**
+ * Build the option type entry for a `.option()` call that uses a plain
+ * description (no schema).
+ */
+type UntypedOptionEntry<RawName extends string> = RawName extends `${string}<${string}>` ? {
+    [K in ExtractOptionName<RawName>]: UntypedOptionValue<RawName>;
+} : {
+    [K in ExtractOptionName<RawName>]?: UntypedOptionValue<RawName>;
+};
+/**
+ * Tokenize a command raw name by splitting on whitespace.
+ * "mcp getNodeXml <id>" → ["mcp", "getNodeXml", "<id>"]
+ * "" → []
+ */
+type TokenizeName<S extends string, Acc extends readonly string[] = []> = S extends `${infer Head} ${infer Rest}` ? TokenizeName<Rest, [...Acc, Head]> : S extends '' ? Acc : [...Acc, S];
+/**
+ * Given a single token, return the corresponding positional arg type or
+ * `never` if the token is not a bracketed arg.
+ *
+ * `<id>`       → string          (required)
+ * `[id]`       → string | undefined (optional)
+ * `<...files>` → string[]        (variadic required)
+ * `[...files]` → string[]        (variadic optional)
+ * Anything else → never (filtered out by ExtractCommandArgs)
+ */
+type TokenToArgType<T extends string> = T extends `<...${string}>` ? string[] : T extends `[...${string}]` ? string[] : T extends `<${string}>` ? string : T extends `[${string}]` ? string | undefined : never;
+/**
+ * Filter a tokenized command raw name down to the positional arg tokens
+ * and map each to its inferred type.
+ */
+type ExtractCommandArgs<T extends readonly string[]> = T extends readonly [infer Head extends string, ...infer Tail extends string[]] ? [TokenToArgType<Head>] extends [never] ? ExtractCommandArgs<Tail> : [TokenToArgType<Head>, ...ExtractCommandArgs<Tail>] : [];
+/**
+ * Extract the tuple of positional arg types from a command raw name.
+ *
+ * "mcp getNodeXml <id>"    → [string]
+ * "convert <input> <output>" → [string, string]
+ * "run [script]"           → [string | undefined]
+ * "exec [...args]"         → [string[]]
+ * "deploy"                 → []
+ */
+type ExtractPositionalArgs<RawName extends string> = ExtractCommandArgs<TokenizeName<RawName>>;
+/**
+ * Everything after a literal `--` on the command line is collected into
+ * `options['--']` as a string array (empty when `--` is absent). This key
+ * is always present at runtime, so it's merged into every action's options
+ * type regardless of which options the user declared.
+ */
+type DoubleDashOptions = {
+    '--': string[];
+};
+/**
+ * Build the full argument tuple passed to a command's action callback.
+ *
+ * Format: [...positionalArgs, options, executionContext]
+ *
+ * This matches the runtime behavior in Goke.runMatchedCommand(): the action
+ * is called with positional args from the parsed command, then the parsed
+ * options object, then the injected GokeExecutionContext.
+ *
+ * The options type is always extended with `{ '--': string[] }` because the
+ * parser always populates that key (see `Goke.parse()`).
+ */
+type ActionArgs<RawName extends string, Opts> = [
+    ...ExtractPositionalArgs<RawName>,
+    Opts & DoubleDashOptions,
+    GokeExecutionContext
+];
 interface CommandArg {
     required: boolean;
     value: string;
@@ -88,8 +168,8 @@ interface CommandConfig {
 }
 type HelpCallback = (sections: HelpSection[]) => void | HelpSection[];
 type CommandExample = ((bin: string) => string) | string;
-declare class Command {
-    rawName: string;
+declare class Command<RawName extends string = string, Opts = {}> {
+    rawName: RawName;
     description: string;
     config: CommandConfig;
     cli: Goke<any>;
@@ -104,7 +184,7 @@ declare class Command {
     helpCallback?: HelpCallback;
     globalCommand?: GlobalCommand;
     _hidden?: boolean;
-    constructor(rawName: string, description: string, config: CommandConfig | undefined, cli: Goke<any>);
+    constructor(rawName: RawName, description: string, config: CommandConfig | undefined, cli: Goke<any>);
     usage(text: string): this;
     allowUnknownOptions(): this;
     ignoreOptionDefaultValue(): this;
@@ -115,7 +195,9 @@ declare class Command {
      *
      * The second argument is either a description string or a StandardJSONSchemaV1
      * schema. When a schema is provided, description and default are extracted from
-     * the JSON Schema automatically.
+     * the JSON Schema automatically, and the option's type is tracked on the
+     * Command's `Opts` type parameter so that subsequent `.action()` callbacks
+     * receive a fully-typed options object.
      *
      * @example
      * ```ts
@@ -126,13 +208,26 @@ declare class Command {
      * cmd.option('--verbose', 'Verbose output')
      * ```
      */
-    option<RawName extends string, S extends StandardJSONSchemaV1>(rawName: RawName, schema: S): Command & {
-        __opts: OptionEntry<RawName, S>;
-    };
-    option(rawName: string, descriptionOrSchema?: string | StandardJSONSchemaV1): this;
+    option<OptionRawName extends string, S extends StandardJSONSchemaV1>(rawName: OptionRawName, schema: S): Command<RawName, Opts & OptionEntry<OptionRawName, S>>;
+    option<OptionRawName extends string>(rawName: OptionRawName, description?: string): Command<RawName, Opts & UntypedOptionEntry<OptionRawName>>;
     alias(name: string): this;
     hidden(): this;
-    action(callback: (...args: any[]) => any): this;
+    /**
+     * Register the action callback that runs when this command is matched.
+     *
+     * The callback receives positional args extracted from the command's raw name,
+     * followed by the parsed options object and the injected GokeExecutionContext.
+     *
+     * Positional arg types are inferred from the raw name at the type level:
+     *   `command('convert <input> <output>')` → `(input: string, output: string, options, ctx)`
+     *   `command('run [script]')`              → `(script: string | undefined, options, ctx)`
+     *   `command('exec [...args]')`            → `(args: string[], options, ctx)`
+     *
+     * The options object is typed according to every `.option()` call chained
+     * on this command, plus any global options declared on the parent Goke
+     * instance before `.command()` was called.
+     */
+    action(callback: (...args: ActionArgs<RawName, Opts>) => unknown | Promise<unknown>): this;
     isMatched(args: string[]): {
         matched: boolean;
         consumedArgs: number;
@@ -242,17 +337,17 @@ interface ParsedArgv {
         [k: string]: any;
     };
 }
-declare class Goke<Opts extends Record<string, any> = {}> extends EventEmitter {
+declare class Goke<Opts = {}> extends EventEmitter {
     #private;
     /** The program name to display in help and version message */
     name: string;
-    commands: Command[];
+    commands: Command<any, any>[];
     /** Middleware functions that run before the matched command action, in registration order */
     middlewares: Array<{
         action: (options: any, context: GokeExecutionContext) => void | Promise<void>;
     }>;
     globalCommand: GlobalCommand;
-    matchedCommand?: Command;
+    matchedCommand?: Command<any, any>;
     matchedCommandName?: string;
     /**
      * Raw CLI arguments
@@ -303,19 +398,29 @@ declare class Goke<Opts extends Record<string, any> = {}> extends EventEmitter {
      */
     usage(text: string): this;
     /**
-     * Add a sub-command
+     * Add a sub-command.
+     *
+     * The returned Command is parameterized by the literal `rawName` (so positional
+     * args can be inferred at the type level) and by this Goke's accumulated global
+     * `Opts` (so global options declared before `.command()` are visible inside
+     * `.action()` callbacks alongside the command's own options).
      */
-    command(rawName: string, description?: string, config?: CommandConfig): Command;
+    command<CommandRawName extends string>(rawName: CommandRawName, description?: string, config?: CommandConfig): Command<CommandRawName, Opts>;
     /**
      * Add a global CLI option.
      *
      * Which is also applied to sub-commands.
      *
      * When a StandardJSONSchemaV1 schema is provided, the return type is narrowed
-     * to include the inferred option type — enabling type-safe `.use()` callbacks.
+     * to include the inferred option type — enabling type-safe `.use()` callbacks
+     * and typed `options` params inside command `.action()` handlers.
+     *
+     * When a plain description string is provided, the option is still tracked on
+     * the Goke's `Opts` type, but with a loose `string | boolean | undefined` value
+     * type (since no coercion schema is available).
      */
     option<RawName extends string, S extends StandardJSONSchemaV1>(rawName: RawName, schema: S): Goke<Opts & OptionEntry<RawName, S>>;
-    option(rawName: string, descriptionOrSchema?: string | StandardJSONSchemaV1): this;
+    option<RawName extends string>(rawName: RawName, description?: string): Goke<Opts & UntypedOptionEntry<RawName>>;
     /**
      * Register a middleware function that runs before the matched command action.
      *
@@ -338,7 +443,7 @@ declare class Goke<Opts extends Record<string, any> = {}> extends EventEmitter {
      *   })
      * ```
      */
-    use(callback: (options: Opts, context: GokeExecutionContext) => void | Promise<void>): this;
+    use(callback: (options: Opts & DoubleDashOptions, context: GokeExecutionContext) => void | Promise<void>): this;
     /**
      * Show help message when `-h, --help` flags appear.
      *

package/dist/goke.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"goke.d.ts","sourceRoot":"","sources":["../src/goke.ts"],"names":[],"mappings":"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~~IAeF~~,OAAO,EAAE,~~MAAM~~;~~IACf~~,WAAW,EAAE,MAAM;IACnB,MAAM,EAAE,aAAa;IACrB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;IAjBvB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,EAAE,MAAM,EAAE,CAAA;IAEpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB,aAAa,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAA;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;gBAGR,OAAO,EAAE,~~MAAM~~,~~EACf~~,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,aAAa,YAAK,EAC1B,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;IASvB,KAAK,CAAC,IAAI,EAAE,MAAM;IAKlB,mBAAmB;IAKnB,wBAAwB;IAKxB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,SAAkB;IAMtD,OAAO,CAAC,OAAO,EAAE,cAAc;IAK/B~~;;;;;;;;;;;;;;;OAeG~~;IACH,MAAM,CACJ,~~OAAO~~,SAAS,MAAM,~~EACtB~~,CAAC,SAAS,oBAAoB,~~EAC9B~~,OAAO,EAAE,~~OAAO~~,~~EAAE~~,MAAM,EAAE,CAAC,~~GAAG~~,OAAO,~~GAAG;QAAE~~,~~MAAM~~,EAAE,WAAW,CAAC,~~OAAO~~,EAAE,CAAC,CAAC,~~CAAA~~;~~KAAE;IAC7E~~,MAAM,CAAC,~~OAAO~~,~~EAAE~~,MAAM,EAAE,~~mBAAmB~~,CAAC,EAAE,MAAM,~~GAAG~~,~~oBAAoB~~,GAAG,~~IAAI~~;~~IAOlF~~,KAAK,CAAC,IAAI,EAAE,MAAM;IAKlB,MAAM;IAKN,MAAM,~~CAAC~~,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,~~GAAG~~,EAAE,KAAK,GAAG;~~IAKxC~~,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAuBrE,IAAI,gBAAgB,YAEnB;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM;IAOtB;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAwLlB,UAAU;IAIV,aAAa;IAQb,iBAAiB;IAUjB;;;;OAIG;IACH,mBAAmB;IAkBnB;;OAEG;IACH,gBAAgB;CAwBjB;AAED,cAAM,aAAc,SAAQ,OAAO;gBACrB,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC;CAG3B;AAsBD;;;GAGG;AACH,UAAU,gBAAgB;IACxB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B;AAED;;;;GAIG;AACH,UAAU,WAAW;IACnB,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC7B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC9B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAC/B;AAED,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACvC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,gBAAgB,CAAA;IACxB,MAAM,EAAE,gBAAgB,CAAA;IACxB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAAA;CACjC;AAED,UAAU,oBAAoB;IAC5B,OAAO,EAAE,WAAW,CAAA;IACpB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,WAAW,CAAA;CACrB;AAED,cAAM,eAAgB,SAAQ,KAAK;IACjC,IAAI,EAAE,MAAM,CAAA;gBAEA,IAAI,EAAE,MAAM;CAKzB;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uEAAuE;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,+EAA+E;IAC/E,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,uDAAuD;IACvD,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,gHAAgH;IAChH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC9B;AAED;;;;;;GAMG;AACH,iBAAS,aAAa,CAAC,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAetF;AAwBD,UAAU,UAAU;IAClB,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC3B,OAAO,EAAE;QACP,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,CAAA;KACjB,CAAA;CACF;AAED,cAAM,IAAI,CAAC,IAAI,~~SAAS,MAAM,CAAC,MAAM,EAAE,~~GAAG,~~CAAC,GAAG,~~EAAE,CAAE,SAAQ,YAAY;;~~IACpE~~,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,EAAE,CAAA;~~IACnB~~,6FAA6F;IAC7F,WAAW,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,oBAAoB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAA;IACrG,aAAa,EAAE,aAAa,CAAA;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAA;~~IACxB~~,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;OAEG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;IACxB;;OAEG;IACH,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IAE9B,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAE3B,sEAAsE;IACtE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACjD,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,4DAA4D;IAC5D,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAIrC;;;OAGG;gBACS,IAAI,SAAK,EAAE,OAAO,CAAC,EAAE,WAAW;IAsB5C,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW;IA+B3B,OAAO,CAAC,sBAAsB;IAmBxB,qBAAqB,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;IAIvD;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM;IAKlB~~;;OAEG~~;IACH,OAAO,CAAC,~~OAAO~~,~~EAAE~~,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,~~EAAE~~,MAAM,CAAC,EAAE,aAAa;~~IAOrE;;;;;;;OAOG~~;IACH,MAAM,CACJ,OAAO,SAAS,MAAM,EACtB,CAAC,SAAS,oBAAoB,EAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACpE,MAAM,CAAC,OAAO,~~EAAE~~,MAAM,EAAE,~~mBAAmB~~,CAAC,EAAE,MAAM,~~GAAG~~,~~oBAAoB~~,GAAG,~~IAAI~~;~~IAOlF~~;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,~~CAAC~~,QAAQ,EAAE,~~CAAC~~,OAAO,EAAE,IAAI,~~EAAE~~,OAAO,EAAE,oBAAoB,~~KAAK~~,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,~~GAAG~~,IAAI;~~IAK3F~~;;;OAGG;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,YAAY;IAO5B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,SAAkB;IAMtD;;;;OAIG;IACH,OAAO,CAAC,OAAO,EAAE,cAAc;IAK/B;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAOlB;;;;OAIG;IACH,UAAU;IAIV;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,EAAE,YAAY,UAAQ;IAwBrF;;;OAGG;IACH,aAAa;IAIb,OAAO,CAAC,aAAa;IAgBrB,mBAAmB;IAKnB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,KAAK,CACH,IAAI,WAAoB,EACxB;IACE,oDAAoD;IACpD,GAAU,GACX;;KAAK,GACL,UAAU;IA2Ib,OAAO,CAAC,GAAG;~~IA6HX~~,iBAAiB;CA0FlB;AAID,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,EAAE,CAAA;AACrG,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,CAAA;AACjE,eAAe,IAAI,CAAA"}
1	+ {"version":3,"file":"goke.d.ts","sourceRoot":"","sources":["../src/goke.ts"],"names":[],"mappings":"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"}

package/dist/goke.js CHANGED Viewed

@@ -306,6 +306,21 @@ class Command {
         this._hidden = true;
         return this;
     }
+    /**
+     * Register the action callback that runs when this command is matched.
+     *
+     * The callback receives positional args extracted from the command's raw name,
+     * followed by the parsed options object and the injected GokeExecutionContext.
+     *
+     * Positional arg types are inferred from the raw name at the type level:
+     *   `command('convert <input> <output>')` → `(input: string, output: string, options, ctx)`
+     *   `command('run [script]')`              → `(script: string | undefined, options, ctx)`
+     *   `command('exec [...args]')`            → `(args: string[], options, ctx)`
+     *
+     * The options object is typed according to every `.option()` call chained
+     * on this command, plus any global options declared on the parent Goke
+     * instance before `.command()` was called.
+     */
     action(callback) {
         this.commandAction = callback;
         return this;
@@ -745,7 +760,12 @@ class Goke extends EventEmitter {
         return this;
     }
     /**
-     * Add a sub-command
+     * Add a sub-command.
+     *
+     * The returned Command is parameterized by the literal `rawName` (so positional
+     * args can be inferred at the type level) and by this Goke's accumulated global
+     * `Opts` (so global options declared before `.command()` are visible inside
+     * `.action()` callbacks alongside the command's own options).
      */
     command(rawName, description, config) {
         const command = new Command(rawName, description || '', config, this);
@@ -1082,7 +1102,9 @@ class Goke extends EventEmitter {
         //
         // When mri returns `true` for value-taking options, it means "flag present, no value given".
         // For required options (<...>), the sentinel is preserved so checkOptionValue() throws.
-        // For optional options ([...]) with a schema, we replace `true` with `undefined`.
+        // For optional options ([...]) we want a single, uniform shape: `string`
+        // with `''` meaning "flag present but no value" — callers get clean
+        // `string | undefined` types instead of `string | boolean | undefined`.
         const requiredValueOptions = new Set();
         const optionalValueOptions = new Set();
         for (const cliOption of cliOptions) {
@@ -1107,21 +1129,29 @@ class Goke extends EventEmitter {
                 // When value is boolean `true` and the option takes a value, it's mri's sentinel
                 // for "flag present, no value given":
                 //   - Required options (<...>): preserve `true` so checkOptionValue() throws
-                //   - Optional options ([...]) with schema: replace with `undefined` (no typed value)
-                //   - Optional options ([...]) without schema: preserve `true` (original goke behavior)
+                //   - Optional options ([...]) with schema: replace with `undefined` so
+                //     any `.default(...)` on the schema kicks in (e.g. z.number().default(30)
+                //     should produce 30, not try to coerce the `''` empty-string sentinel).
                 const schemaInfo = schemaMap.get(key);
                 if (schemaInfo && value !== undefined) {
                     if (value === true && requiredValueOptions.has(key)) {
                         // Keep sentinel for checkOptionValue() to detect
                     }
                     else if (value === true && optionalValueOptions.has(key)) {
-                        // Optional value not given — schema expects a typed value, so return undefined
                         value = undefined;
                     }
                     else {
                         value = coerceBySchema(value, schemaInfo.jsonSchema, schemaInfo.optionName);
                     }
                 }
+                else if (value === true && optionalValueOptions.has(key)) {
+                    // Untyped optional-value flag with no schema: normalize bare `true`
+                    // to `''` so callers get a clean `string | undefined` shape. `''`
+                    // means "flag passed with no argument", distinct from `undefined`
+                    // (flag omitted). This matches the new type inference that treats
+                    // `[value]` as `string` instead of `string | boolean`.
+                    value = '';
+                }
                 setDotProp(options, keys, value);
             }
         }

package/dist/runtime-node.js CHANGED Viewed

@@ -8,7 +8,7 @@ const process = globalThis.process;
 const fs = nodeFs;
 function openInBrowser(url) {
     if (!process.stdout.isTTY) {
-        process.stderr.write(url + '\n');
+        process.stdout.write(url + '\n');
         return;
     }
     try {
@@ -23,7 +23,7 @@ function openInBrowser(url) {
         }
     }
     catch {
-        process.stderr.write(url + '\n');
+        process.stdout.write(url + '\n');
     }
 }
 export { EventEmitter, fs, openInBrowser, process };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "goke",
-  "version": "6.5.1",
+  "version": "6.6.0",
   "type": "module",
   "description": "Simple yet powerful framework for building command-line apps. Inspired by cac.",
   "repository": {
@@ -23,7 +23,7 @@
   "types": "./dist/index.d.ts",
   "imports": {
     "#runtime": {
-      "types": "./src/runtime-node.ts",
+      "types": "./dist/runtime-node.d.ts",
       "development": "./src/runtime-node.ts",
       "node": "./dist/runtime-node.js",
       "default": "./dist/runtime-browser.js"

package/src/__test__/index.test.ts CHANGED Viewed

@@ -278,7 +278,9 @@ test('dot-nested options', () => {
     `node bin --externals.env.prod production --scale`.split(' ')
   )
   expect(options1.externals).toEqual({ env: { prod: 'production' } })
-  expect(options1.scale).toEqual(true)
+  // Bare `--scale` normalizes to `''` (new uniform string-or-undefined shape
+  // for untyped optional-value flags).
+  expect(options1.scale).toEqual('')
 })
 describe('schema-based options', () => {
@@ -418,11 +420,14 @@ describe('no-schema behavior (mri no longer auto-converts)', () => {
     expect(options.verbose).toBe(true)
   })
-  test('optional value flag returns true when no value given', () => {
+  test('optional value flag returns empty string when no value given', () => {
+    // Bare `--format` is normalized from the mri `true` sentinel to `''` so
+    // callers see a uniform `string | undefined` shape. `''` still lets them
+    // distinguish "flag present but no value" from "flag omitted entirely".
     const cli = goke()
     cli.option('--format [fmt]', 'Format')
     const { options } = cli.parse('node bin --format'.split(' '))
-    expect(options.format).toBe(true)
+    expect(options.format).toBe('')
   })
   test('optional value flag returns string when value given', () => {
@@ -699,14 +704,19 @@ describe('regression: oracle-found issues', () => {
     expect(options.count).toBe(undefined)
   })
-  test('optional value option without schema preserves true sentinel', () => {
+  test('optional value option without schema normalizes bare flag to empty string', () => {
     const cli = goke()
     cli.option('--count [count]', 'Count')
-    // Without schema, original goke behavior: true means "flag present"
+    // Untyped optional-value flags uniformly expose `string | undefined`:
+    //   - `--count`       → ''          (flag present, no value)
+    //   - `--count 42`    → '42'        (flag present, with value)
+    //   - (omitted)       → undefined   (flag absent)
+    // This lets callers use a single `typeof options.count === 'string'`
+    // check and distinguish the three cases via `=== ''` if they need to.
     const { options } = cli.parse('node bin --count'.split(' '))
-    expect(options.count).toBe(true)
+    expect(options.count).toBe('')
   })
   test('optional value option with schema coerces when value given', () => {

package/src/__test__/readme-examples.test.ts ADDED Viewed

@@ -0,0 +1,225 @@
+/**
+ * Smoke tests that keep README examples and documented APIs executable.
+ */
+import { describe, expect, test } from 'vitest'
+import { z } from 'zod'
+import goke, { openInBrowser } from '../index.js'
+import type { GokeOptions, GokeOutputStream } from '../index.js'
+const ANSI_RE = /\x1B\[[0-9;]*m/g
+const stripAnsi = (text: string) => text.replace(ANSI_RE, '')
+function createTestOutputStream(): GokeOutputStream & { lines: string[]; readonly text: string } {
+  const lines: string[] = []
+  return {
+    lines,
+    get text() { return stripAnsi(lines.join('')) },
+    write(data: string) { lines.push(data) },
+  }
+}
+function gokeTestable(name = '', options?: Partial<GokeOptions>) {
+  return goke(name, {
+    ...options,
+    exit: () => {},
+  })
+}
+describe('README smoke tests', () => {
+  test('intro example runs middleware and both command forms', async () => {
+    const stdout = createTestOutputStream()
+    const cli = gokeTestable('deploy', { stdout })
+    cli
+      .option('--env <env>', z.enum(['staging', 'production']).default('staging').describe('Target environment'))
+      .use((options, { console }) => {
+        console.log(`Environment: ${options.env}`)
+      })
+    cli
+      .command('up', 'Deploy the app')
+      .option('--dry-run', 'Preview without deploying')
+      .action((options, { console, process }) => {
+        console.log(`Deploying from ${process.cwd} dryRun=${String(options.dryRun)}`)
+      })
+    cli
+      .command('logs <deploymentId>', 'Stream logs')
+      .option('--lines <n>', z.number().default(100).describe('Lines to tail'))
+      .action((deploymentId, options, { console }) => {
+        console.log(`logs ${deploymentId} ${options.lines}`)
+      })
+    cli.parse(['node', 'bin', '--env', 'production', 'up', '--dry-run'], { run: false })
+    await cli.runMatchedCommand()
+    expect(stdout.text).toBe(
+      `Environment: production\nDeploying from ${process.cwd()} dryRun=true\n`,
+    )
+    stdout.lines.length = 0
+    cli.parse(['node', 'bin', 'logs', 'dep_123'], { run: false })
+    await cli.runMatchedCommand()
+    expect(stdout.text).toBe('Environment: staging\nlogs dep_123 100\n')
+  })
+  test('simple parsing example stays executable and keeps examples in help output', async () => {
+    const stdout = createTestOutputStream()
+    const cli = gokeTestable('mycli', { stdout })
+    cli.option(
+      '--type [type]',
+      z.string().default('node').describe('Choose a project type'),
+    )
+    cli.option('--name <name>', 'Provide your name')
+    cli.command('lint [...files]', 'Lint files').action((files, options, { console, process }) => {
+      console.log(JSON.stringify({ files, options, cwd: process.cwd }))
+    })
+    cli
+      .command('build [entry]', 'Build your app')
+      .option('--minify', 'Minify output')
+      .example('build src/index.ts')
+      .example('build src/index.ts --minify')
+      .action(async (entry, options, { console, process }) => {
+        console.log(JSON.stringify({ entry, options, nodeEnv: process.env.NODE_ENV }))
+      })
+    cli.example((bin) => `${bin} lint src/**/*.ts`)
+    cli.help()
+    cli.version('0.0.0')
+    expect(stripAnsi(cli.helpText())).toContain('mycli lint src/**/*.ts')
+    cli.parse(['node', 'bin', '--type', 'bun', '--name', 'Tommy', 'build', 'src/index.ts', '--minify'], { run: false })
+    await cli.runMatchedCommand()
+    expect(stdout.text).toBe(
+      `${JSON.stringify({
+        entry: 'src/index.ts',
+        options: {
+          '--': [],
+          type: 'bun',
+          name: 'Tommy',
+          minify: true,
+        },
+        nodeEnv: process.env.NODE_ENV,
+      })}\n`,
+    )
+  })
+  test('many-commands README example runs root and nested commands', async () => {
+    const stdout = createTestOutputStream()
+    const cli = gokeTestable('deploy', { stdout })
+    cli
+      .command('', 'Deploy the current project')
+      .option('--env <env>', z.string().default('production').describe('Target environment'))
+      .option('--dry-run', 'Preview without deploying')
+      .action((options, { console, process }) => {
+        console.log(`Deploying to ${options.env} from ${process.cwd} dryRun=${String(options.dryRun)}`)
+      })
+    cli
+      .command('logs <deploymentId>', 'Stream logs for a deployment')
+      .option('--follow', 'Follow log output')
+      .option('--lines <n>', z.number().default(100).describe('Number of lines'))
+      .action((deploymentId, options, { console, process }) => {
+        console.log(
+          `Streaming logs for ${deploymentId} from ${process.cwd} follow=${String(options.follow)} lines=${options.lines}`,
+        )
+      })
+    cli.parse(['node', 'bin', '--env', 'staging', '--dry-run'], { run: false })
+    await cli.runMatchedCommand()
+    expect(stdout.text).toBe(
+      `Deploying to staging from ${process.cwd()} dryRun=true\n`,
+    )
+    stdout.lines.length = 0
+    cli.parse(['node', 'bin', 'logs', 'abc123', '--follow'], { run: false })
+    await cli.runMatchedCommand()
+    expect(stdout.text).toBe(
+      `Streaming logs for abc123 from ${process.cwd()} follow=true lines=100\n`,
+    )
+  })
+})
+describe('documented command APIs', () => {
+  test('alias runs the same command through a short name', () => {
+    const cli = gokeTestable('mycli')
+    let seen = ''
+    cli.command('install', 'Install packages').alias('i').action(() => {
+      seen = 'install'
+    })
+    cli.parse(['node', 'bin', 'i'], { run: true })
+    expect(seen).toBe('install')
+  })
+  test('command helpText returns command-specific help without printing', () => {
+    const stdout = createTestOutputStream()
+    const cli = goke('mycli', { stdout })
+    const command = cli
+      .command('deploy <env>', 'Deploy to an environment')
+      .option('--dry-run', 'Preview without deploying')
+      .example('# Deploy safely first')
+      .example('mycli deploy staging --dry-run')
+    cli.help()
+    const help = stripAnsi(command.helpText())
+    expect(help).toContain('$ mycli deploy <env>')
+    expect(help).toContain('--dry-run')
+    expect(help).toContain('Deploy safely first')
+    expect(stdout.text).toBe('')
+  })
+  test('openInBrowser prints the URL to stdout in non-tty environments', () => {
+    const url = 'https://example.com/dashboard'
+    const originalStdoutWrite = process.stdout.write
+    const originalStderrWrite = process.stderr.write
+    const originalIsTTY = process.stdout.isTTY
+    let stdout = ''
+    let stderr = ''
+    Object.defineProperty(process.stdout, 'isTTY', {
+      configurable: true,
+      value: false,
+    })
+    process.stdout.write = ((chunk: string | Uint8Array) => {
+      stdout += String(chunk)
+      return true
+    }) as typeof process.stdout.write
+    process.stderr.write = ((chunk: string | Uint8Array) => {
+      stderr += String(chunk)
+      return true
+    }) as typeof process.stderr.write
+    try {
+      openInBrowser(url)
+    } finally {
+      process.stdout.write = originalStdoutWrite
+      process.stderr.write = originalStderrWrite
+      Object.defineProperty(process.stdout, 'isTTY', {
+        configurable: true,
+        value: originalIsTTY,
+      })
+    }
+    expect(stdout).toBe(`${url}\n`)
+    expect(stderr).toBe('')
+  })
+})