padrone 1.2.0 → 1.4.0

package/dist/test.d.mts

@@ -1,4 +1,4 @@
-import { b as PadroneRuntime, n as AnyPadroneCommand } from "./types-qrtt0135.mjs";
+import { b as PadroneRuntime, n as AnyPadroneCommand } from "./types-DjIdJN5G.mjs";
 
 //#region src/test.d.ts
 /**

package/dist/{types-qrtt0135.d.mts → types-DjIdJN5G.d.mts}

@@ -1,16 +1,22 @@
-import { n as HelpFormat, t as HelpDetail } from "./formatter-Dvx7jFXr.mjs";
+import { n as HelpFormat, t as HelpDetail } from "./formatter-ClUK5hcQ.mjs";
 import { StandardJSONSchemaV1, StandardSchemaV1 } from "@standard-schema/spec";
 import { Tool } from "ai";
 
 //#region src/args.d.ts
+type Letter = 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z';
+/** A single letter character, valid as a short CLI flag (e.g. `'v'`, `'n'`, `'V'`). */
+type SingleChar = Letter | Uppercase<Letter>;
 interface PadroneFieldMeta {
   description?: string;
+  /** Single-character short flags (stackable: `-abc` = `-a -b -c`). Used with single dash. */
+  flags?: SingleChar[] | SingleChar;
+  /** Multi-character alternative long names. Used with double dash (e.g. `--dry-run` for `--dryRun`). */
   alias?: string[] | string;
   deprecated?: boolean | string;
   hidden?: boolean;
   examples?: unknown[];
 }
-type PositionalArgs<TObj> = TObj extends Record<string, any> ? { [K in keyof TObj]: TObj[K] extends Array<any> ? `...${K & string}` : K & string }[keyof TObj] : string;
+type PositionalArgs<TObj> = TObj extends Record<string, any> ? { [K in keyof TObj]: NonNullable<TObj[K]> extends Array<any> ? `...${K & string}` | (K & string) : K & string }[keyof TObj] : string;
 /**
  * Meta configuration for arguments, including positional arguments.
  * The `positional` array defines which arguments are positional and their order.
@@ -46,6 +52,22 @@ interface PadroneArgsSchemaMeta<TObj = Record<string, any>> {
    * Per-argument metadata.
    */
   fields?: { [K in keyof TObj]?: PadroneFieldMeta };
+  /**
+   * Automatically generate kebab-case aliases for camelCase option names.
+   * For example, `dryRun` automatically gets `--dry-run` as an alias.
+   * Defaults to `true`. Set to `false` to disable.
+   *
+   * @default true
+   * @example
+   * ```ts
+   * // Auto-aliases enabled (default): --dry-run → dryRun
+   * .arguments(z.object({ dryRun: z.boolean() }))
+   *
+   * // Disable auto-aliases
+   * .arguments(z.object({ dryRun: z.boolean() }), { autoAlias: false })
+   * ```
+   */
+  autoAlias?: boolean;
   /**
    * Read from stdin and inject the data into the specified argument field.
    * Only reads when stdin is piped (not a TTY) and the field wasn't already provided via CLI flags.
@@ -240,11 +262,11 @@ type OrAsyncMeta<TExisting extends boolean, TMeta> = TExisting extends true ? tr
 /**
  * Conditionally wraps a type in Promise based on the TAsync flag.
  * - `true` → `Promise<T>`
- * - `false` → `T`
+ * - `false` → `T & PromiseLike<T>` (thenable: supports `.then()` and `await`)
  * - `boolean` (union of true|false) → `Promise<T>` (safe default when async-ness is uncertain)
  * - `any` → `T` (for generic/any typed commands like AnyPadroneCommand)
  */
-type MaybePromise<T, TAsync> = IsAny<TAsync> extends true ? T : true extends TAsync ? Promise<T> : T;
+type MaybePromise<T, TAsync> = IsAny<TAsync> extends true ? T : true extends TAsync ? Promise<T> : T & PromiseLike<T>;
 type SplitString<TName extends string, TSplitBy extends string = ' '> = TName extends `${infer FirstPart}${TSplitBy}${infer RestParts}` ? [FirstPart, ...SplitString<RestParts, TSplitBy>] : [TName];
 type JoinString<TParts extends string[], TJoinBy extends string = ' '> = TParts extends [infer FirstPart extends string, ...infer RestParts extends string[]] ? RestParts extends [] ? FirstPart : `${FirstPart}${TJoinBy}${JoinString<RestParts, TJoinBy>}` : TParts extends [] ? '' : TParts[number];
 type SplitLastSpace<S extends string> = SplitString<S> extends [...infer Init extends string[], infer Last extends string] ? Init extends [] ? [S, never] : [JoinString<Init>, Last] : [S, never];
@@ -1034,4 +1056,4 @@ type PadronePlugin = {
 };
 //#endregion
 export { PossibleCommands as _, PadroneActionContext as a, PadroneRuntime as b, PadroneCommandResult as c, PadroneProgram as d, PadroneSchema as f, PickCommandByName as g, UpdateCheckConfig as h, AsyncPadroneSchema as i, PadroneParseResult as l, WrapResult as m, AnyPadroneCommand as n, PadroneBuilder as o, WrapConfig as p, AnyPadroneProgram as r, PadroneCommand as s, AnyPadroneBuilder as t, PadronePlugin as u, InteractiveMode as v, REPL_SIGINT as x, InteractivePromptConfig as y };
-//# sourceMappingURL=types-qrtt0135.d.mts.map
+//# sourceMappingURL=types-DjIdJN5G.d.mts.map

package/dist/types-DjIdJN5G.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-DjIdJN5G.d.mts","names":[],"sources":["../src/args.ts","../src/help.ts","../src/runtime.ts","../src/type-utils.ts","../src/update-check.ts","../src/wrap.ts","../src/types.ts"],"mappings":";;;;;KAEK,MAAA;;KA6BO,UAAA,GAAa,MAAA,GAAS,SAAA,CAAU,MAAA;AAAA,UAE3B,gBAAA;EACf,WAAA;EAhCS;EAkCT,KAAA,GAAQ,UAAA,KAAe,UAAA;EAlCd;EAoCT,KAAA;EACA,UAAA;EACA,MAAA;EACA,QAAA;AAAA;AAAA,KAGG,cAAA,SACH,IAAA,SAAa,MAAA,8BAEK,IAAA,GAAO,WAAA,CAAY,IAAA,CAAK,CAAA,WAAY,KAAA,cAAmB,CAAA,eAAgB,CAAA,aAAc,CAAA,kBAC3F,IAAA;;;;;;;AAfd;;;;;;;;;KAiCY,WAAA,QAAmB,MAAA,wBACpB,IAAA;EA3BT,sDA8BI,KAAA,QAAa,IAAA;EA7BT;;AACT;;;EAkCK,EAAA;AAAA;AAAA,UAGW,qBAAA,QAA6B,MAAA;EAhCP;;;;;EAsCrC,UAAA,GAAa,cAAA,CAAe,IAAA;EAtC2E;;;EA0CvG,MAAA,iBAAuB,IAAA,IAAQ,gBAAA;EA5ClB;;;;;;;;;;;;;AAqBf;;EAuCE,SAAA;EAvC6B;;;;;;;;;;;;;AAa/B;;;;;;;;EAgDE,KAAA,GAAQ,WAAA,CAAY,IAAA;EAAZ;;;;;;;;;;;;;;;;EAiBR,WAAA,iBAA4B,IAAA;EAjBR;;;;;;;;;;AChHtB;;;;EDgJE,mBAAA,iBAAoC,IAAA;AAAA;;;KChJ1B,eAAA;EACV,MAAA,GAAS,UAAA;EACT,MAAA,GAAS,UAAA;AAAA;;;;;;;ADjBuD;;;KEUtD,eAAA;;AFqBZ;;;KEfY,uBAAA;EFegC,qCEb1C,IAAA,UFayC;EEXzC,OAAA,UFWuB;EETvB,IAAA,+DFS0C;EEP1C,OAAA;IAAY,KAAA;IAAe,KAAA;EAAA;EAE3B,OAAA;AAAA;;;;;;;;KAUU,cAAA;EFKF,uGEHR,MAAA,OAAa,IAAA,sBFMI;EEJjB,KAAA,IAAS,IAAA,mBFKT;EEHA,IAAA,mBFKkB;EEHlB,GAAA,SAAY,MAAA,8BFG8B;EED1C,MAAA,GAAS,UAAA,WFC6C;EECtD,cAAA,IAAkB,IAAA,aAAiB,MAAA,+BFDsD;EEGzF,QAAA,IAAY,KAAA;EFFA;;;;;;;;EEWZ,KAAA;IFZqC,oEEcnC,KAAA,YFdoD;IEgBpD,IAAA,QAAY,OAAA,UFhB2E;IEkBvF,KAAA,QAAa,aAAA;EAAA;EFjBC;;AAkBlB;;;;;;;;EEWE,WAAA,GAAc,eAAA;EFXe;;;;EEgB7B,MAAA,IAAU,MAAA,EAAQ,uBAAA,KAA4B,OAAA;EFNxC;;AAGR;;;;;;;EEaE,QAAA,IAAY,MAAA,aAAmB,OAAA,iBAAwB,WAAA;AAAA;;;;;KAO7C,sBAAA,GAAyB,QAAA,CAAS,IAAA,CAAK,cAAA,sDACjD,IAAA,CAAK,cAAA;;;;;;;;;;cA+CM,WAAA;;;KC3ID,UAAA;AAAA,KACP,SAAA,sBAA+B,CAAA;AAAA,KAC/B,KAAA,kBAAuB,CAAA;AAAA,KACvB,OAAA,OAAc,CAAA;AAAA,KAEP,SAAA,MAAe,KAAA,CAAM,CAAA,wBAAyB,SAAA,CAAU,CAAA,wBAAyB,OAAA,CAAQ,CAAA;;;;;;;;KASzF,aAAA,MAAmB,KAAA,CAAM,CAAA,yBAA0B,CAAA;EAAY,QAAA;AAAA;;;AHW3E;;KGLY,OAAA,uCAA8C,SAAA,uBAEtD,aAAA,CAAc,OAAA;;;;;KAQN,cAAA,UAAwB,KAAA;EAAgB,WAAA;AAAA,WAEhD,KAAA;EAAgB,mBAAA;AAAA;;;AHEnB;;KGMW,WAAA,qCAAgD,SAAA,uBAExD,cAAA,CAAe,KAAA;;;;;;;;KAWP,YAAA,cAA0B,KAAA,CAAM,MAAA,iBAAuB,CAAA,gBAAiB,MAAA,GAAS,OAAA,CAAQ,CAAA,IAAK,CAAA,GAAI,WAAA,CAAY,CAAA;AAAA,KAErH,WAAA,wDAAmE,KAAA,8BAAmC,QAAA,wBACtG,SAAA,KAAc,WAAA,CAAY,SAAA,EAAW,QAAA,MACrC,KAAA;AAAA,KAEA,UAAA,0DAAoE,MAAA,iFAIrE,SAAA,cACE,SAAA,MACG,SAAA,GAAY,OAAA,GAAU,UAAA,CAAW,SAAA,EAAW,OAAA,MACjD,MAAA,mBAEE,MAAA;AAAA,KAED,cAAA,qBACH,WAAA,CAAY,CAAA,wEACR,IAAA,eACG,CAAA,YACA,UAAA,CAAW,IAAA,GAAO,IAAA,KACpB,CAAA;AAAA,KAEF,cAAA,UAAwB,CAAA,4BAA6B,CAAA,gBAAiB,CAAA,SAAU,CAAA;AAAA,KAEzE,eAAA,0DAAyE,WAAA,cACjF,KAAA,MACG,WAAA,IAAe,KAAA;;;;KAKjB,cAAA,+DAA6E,QAAA,wEAI9E,eAAA,CAAgB,KAAA,EAAO,WAAA,IAAe,cAAA,CAAe,IAAA,EAAM,WAAA;;;;KAM1D,yBAAA,kBAA2C,iBAAA,IAAqB,QAAA,uDACjE,QAAA,+DACE,QAAA,mEACE,IAAA,GAAO,cAAA,CAAe,OAAA,EAAS,UAAA,IAC/B,IAAA,GACF,IAAA;;AH3CN;;;KGkDY,eAAA,mBAAkC,iBAAA,4BAA6C,SAAA,8BACrE,iBAAA,wBACE,iBAAA,MAEpB,KAAA,2BAAgC,KAAA,GAC9B,KAAA,GACA,eAAA,CAAgB,IAAA,EAAM,KAAA;;;;;KAOhB,sBAAA,uBAA6C,iBAAA,wCAAyD,iBAAA,IAChH,cAAA,CAAe,SAAA,EAAW,KAAA,iBAAsB,cAAA,CAAe,SAAA,EAAW,KAAA,EAAO,IAAA,QAAY,SAAA,EAAW,IAAA;AAAA,KAErG,cAAA,mBAAiC,iBAAA,4BAA6C,SAAA,8BAC7D,iBAAA,wBACE,iBAAA,MAEpB,KAAA,2BAAgC,KAAA,UAE9B,cAAA,CAAe,IAAA,EAAM,KAAA;AAAA,KAGtB,cAAA,mBAAiC,iBAAA,uCAAwD,iBAAA,IAAqB,SAAA,8BAC7F,iBAAA,wBACE,iBAAA,MAEpB,KAAA,2BAAgC,KAAA,IAC7B,IAAA,KAAS,IAAA,KACT,KAAA,KAAU,cAAA,CAAe,IAAA,EAAM,KAAA,EAAO,IAAA;AAAA,KAGjC,iBAAA,mBACQ,iBAAA,2BACK,iBAAA,IACrB,KAAA,SAAc,iBAAA,GACd,KAAA,GACA,eAAA,CAAgB,SAAA,4BAAqC,iBAAA,GACnD,GAAA,SAAY,iBAAA,GACV,KAAA,SAAc,yBAAA,CAA0B,GAAA,IACtC,GAAA;AAAA,KAKE,eAAA,mBAAkC,iBAAA,MAAuB,SAAA,sBAEjE,SAAA,wDAEO,YAAA,SAAqB,iBAAA,KAAsB,eAAA,CAAgB,YAAA,cAC3D,YAAA,SAAqB,iBAAA,GAAoB,eAAA,CAAgB,YAAA,0BAAsC,YAAA,YACpG,KAAA,CAAM,SAAA,iCAEJ,SAAA;;;;KAKH,wBAAA,mBAA2C,iBAAA,MAAuB,yBAAA,CAA0B,eAAA,CAAgB,SAAA;;;;;;;;;KAU5G,gBAAA,mBAAmC,iBAAA,MACtC,wBAAA,CAAyB,SAAA,+BACrB,YAAA,kBACE,cAAA,CAAe,wBAAA,CAAyB,SAAA,MAAe,YAAA,wCAElD,YAAA;;;;;KAQD,gBAAA,mBACQ,iBAAA,yHAKhB,wBAAA,CAAyB,SAAA,KACxB,aAAA,gBAA6B,gBAAA,CAAiB,SAAA,cAC9C,YAAA,gBAA4B,eAAA,CAAgB,SAAA,cAC5C,aAAA,gBAA6B,UAAA;AAAA,KAE7B,oBAAA,aACH,SAAA,CAAU,QAAA,uCAA+C,QAAA,UAAkB,UAAA,SAAmB,QAAA;;;;;;;;;;KAWpF,cAAA,uBAAqC,iBAAA,sCAAuD,SAAA,8BAClF,iBAAA,wBACE,iBAAA,OAEnB,aAAA,CAAc,KAAA,EAAO,cAAA,MAAoB,cAAA,CAAe,IAAA,EAAM,cAAA;AAAA,KAG9D,aAAA,kBAA+B,iBAAA,mCAAoD,cAAA,CACtF,QAAA,oBACA,cAAA,EACA,QAAA,0BACA,QAAA,sBACA,cAAA,CAAe,QAAA,wBAAgC,eAAA,CAAgB,QAAA,oBAA4B,cAAA,IAC3F,QAAA,uBACA,QAAA,4BACA,QAAA,yBACA,QAAA;AAAA,KAGU,6BAAA,mBACQ,iBAAA,qBACD,gBAAA,CAAiB,SAAA,gBAAyB,UAAA,IAE3D,oBAAA,CAAqB,QAAA,iBACjB,eAAA,CAAgB,SAAA,IAChB,QAAA,SAAiB,iBAAA,GACf,QAAA,GACA,QAAA,kBACE,QAAA,SAAiB,wBAAA,CAAyB,SAAA,IACxC,iBAAA,CAAkB,SAAA,EAAW,QAAA,IAC7B,cAAA,CAAe,QAAA,sDACb,OAAA,CAAQ,IAAA,iBACN,iBAAA,CAAkB,SAAA,EAAW,MAAA,IAC7B,6BAAA,CAA8B,SAAA,EAAW,MAAA;;;;;;KC1P7C,iBAAA;EJHP;;;EIOH,WAAA;EJPS;AA6BX;;;;EIhBE,QAAA;EJgBgC;;;;EIXhC,QAAA;EJW0C;;;AAE5C;EIRE,KAAA;;;;;;EAMA,aAAA;AAAA;;;;;;KCxBU,UAAA,sBAAgC,aAAA,GAAgB,aAAA,oBAAiC,aAAA,GAAgB,YAAA;ELLlG;;;EKST,OAAA;ELoBU;;;EKhBV,IAAA;ELgB0C;;;;EKX1C,UAAA;ELWgC;;;;EKNhC,YAAA;ELQ+B;;;;;;EKD/B,MAAA,GAAS,SAAA,KAAc,gBAAA,EAAkB,YAAA,KAAiB,SAAA;AAAA;;;;KAMhD,UAAA;ELGF;AACT;;EKAC,QAAA;ELGA;;;EKCA,MAAA;ELC0C;;;EKG1C,MAAA;ELHyF;;;EKOzF,OAAA;AAAA;;;KC/BG,aAAA,GAAgB,MAAA;AAAA,KAChB,WAAA,GAAc,MAAA;AAAA,KACd,WAAA,GAAc,aAAA;;;;;KAMP,oBAAA;ENA+B,sEMEzC,OAAA,EAAS,sBAAA,ENFc;EMIvB,OAAA,EAAS,iBAAA,ENJiC;EMM1C,OAAA,EAAS,iBAAA;AAAA;ANJX;;;;AAAA,KMWY,aAAA,2BAAwC,KAAA,IAAS,gBAAA,CAAiB,KAAA,EAAO,MAAA,IAAU,oBAAA,CAAqB,KAAA,EAAO,MAAA;;;;;;;;;;ANF1H;KMcW,kBAAA,2BAA6C,KAAA,IAAS,aAAA,CAAc,KAAA,EAAO,MAAA;EAAY,QAAA;AAAA;;;;;KAM9F,WAAA,kBAA6B,iBAAA,+BAAgD,IAAA,CAAK,QAAA;EACrF,OAAA,GAAU,QAAA;EACV,QAAA,EAAU,IAAA,CAAK,QAAA;IAAmC,OAAA,EAAS,QAAA;EAAA;AAAA;;;;;KAOxD,eAAA,uBACmB,iBAAA,8DAGpB,QAAA,cACA,eAAA,CAAgB,SAAA,EAAW,WAAA,0BAAqC,iBAAA,GAC9D,CAAA,6BAEF,QAAA;;;;;;KAOC,qBAAA,0GAIiB,aAAA,wBACE,iBAAA,QACnB,eAAA,CAAgB,SAAA,EAAW,WAAA,qBAC5B,cAAA,CACE,YAAA,EACA,WAAA,EACA,WAAA,EACA,aAAA,kBAGA,WAAA,EACA,aAAA,QACA,aAAA,iBAGF,eAAA,CAAgB,SAAA,EAAW,WAAA,0BAAqC,iBAAA,GAC9D,cAAA,CACE,YAAA,EACA,WAAA,EACA,WAAA,EACA,CAAA,0BACA,CAAA,sBACA,CAAA,wBACA,WAAA,EACA,CAAA,4BACA,CAAA,yBACA,CAAA,uBAEF,cAAA,CACE,YAAA,EACA,WAAA,EACA,WAAA,EACA,aAAA,kBAGA,WAAA,EACA,aAAA,QACA,aAAA;AAAA,KAII,iBAAA,GAAoB,qBAAA,kCAAuD,iBAAA;;;;ANjEvF;KMuEK,qBAAA,0GAIiB,aAAA,wBACE,iBAAA,QACnB,eAAA,CAAgB,SAAA,EAAW,WAAA,qBAC5B,cAAA,CAAe,YAAA,EAAc,WAAA,EAAa,WAAA,iBAA4B,WAAA,qBACtE,eAAA,CAAgB,SAAA,EAAW,WAAA,0BAAqC,iBAAA,GAC9D,cAAA,CACE,YAAA,EACA,WAAA,EACA,WAAA,EACA,CAAA,0BACA,CAAA,sBACA,CAAA,wBACA,WAAA,EACA,CAAA,4BACA,CAAA,yBACA,CAAA,uBAEF,cAAA,CAAe,YAAA,EAAc,WAAA,EAAa,WAAA,iBAA4B,WAAA;AAAA,KAEhE,cAAA,+EAGI,aAAA,GAAgB,aAAA,CAAc,WAAA,sCAEtB,iBAAA,gEAEN,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,KAAU,aAAA,qBAChE,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,KAAU,aAAA;EAG1E,IAAA,EAAM,KAAA;EACN,IAAA,EAAM,eAAA,CAAgB,KAAA,EAAO,WAAA;EAC7B,KAAA;EACA,WAAA;EACA,OAAA,WN7GsB;EM+GtB,OAAA,GAAU,QAAA;EACV,UAAA;EACA,MAAA;EACA,aAAA,eAA4B,IAAA,EAAM,KAAA,KAAU,OAAA;EAC5C,UAAA;EACA,UAAA,GAAa,KAAA;EACb,YAAA,GAAe,OAAA;EACf,SAAA,GAAY,IAAA;EACZ,IAAA,GAAO,WAAA,CAAY,KAAA;EACnB,MAAA,IAAU,IAAA,EAAM,gBAAA,CAAiB,WAAA,CAAY,KAAA,GAAQ,GAAA,EAAK,oBAAA,KAAyB,IAAA,EN3GvC;EM6G5C,WAAA,aNvGa;EMyGb,OAAA,YNrG+B;EMuG/B,OAAA,GAAU,cAAA,ENjEF;EMoER,OAAA,GAAU,aAAA,INpC0B;EMuCpC,WAAA,GAAc,iBAAA;EAEd,MAAA,GAAS,iBAAA;EACT,QAAA,GAAW,SAAA,EN1HiC;EM6H5C,QAAA;IACE,IAAA,EAAM,KAAA;IACN,UAAA,EAAY,WAAA;IACZ,IAAA,EAAM,eAAA,CAAgB,KAAA,EAAO,WAAA;IAC7B,OAAA,EAAS,QAAA;IACT,UAAA,EAAY,KAAA;IACZ,SAAA,EAAW,gBAAA,CAAiB,UAAA,CAAW,KAAA;IACvC,UAAA,EAAY,gBAAA,CAAiB,WAAA,CAAY,KAAA;IACzC,MAAA,EAAQ,IAAA;IACR,QAAA,EAAU,SAAA;IACV,YAAA,EAAc,OAAA;IACd,SAAA,EAAW,IAAA;IACX,KAAA,EAAO,MAAA;EAAA;AAAA;AAAA,KAIC,iBAAA,GAAoB,cAAA,4BAA0C,iBAAA;;;;;KAMrE,gBAAA;EACH,QAAA;IACE,OAAA,EAAS,iBAAA;EAAA;AAAA;;;;KAOD,oBAAA;EL1NS,wDK4NnB,KAAA;EAEA,WAAA,WJrOU;EIuOV,OAAA;EAEA,UAAA,qBJzOyB;EI2OzB,MAAA;EJrOiC;;;;;EI2OjC,UAAA;AAAA;;;;;KAOG,gBAAA,qIAKW,aAAA,8BAEQ,iBAAA,yBACF,aAAA,kBACJ,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,iBACtD,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,8BAE9D,OAAA,qBACA,cAAA,CAAe,YAAA,EAAc,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,IAAA,EAAM,SAAA,EAAW,WAAA,EAAa,OAAA,EAAS,IAAA,EAAM,MAAA,IACrG,cAAA,CAAe,YAAA,EAAc,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,IAAA,EAAM,SAAA,EAAW,WAAA,EAAa,OAAA,EAAS,IAAA,EAAM,MAAA;AJ5OzG;;;;AAAA,KIkPY,qBAAA,8FAII,aAAA,8BAEQ,iBAAA,yBACF,aAAA,kBACJ,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,iBACtD,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA;EJ9NjD;;;;;;;;;;;;;;;;;;;;;;EIyPf,WAAA,GACE,MAAA,GAAS,iBAAA,KACN,gBAAA,CAAiB,OAAA,EAAS,YAAA,EAAc,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,IAAA,EAAM,SAAA,EAAW,WAAA,EAAa,OAAA,EAAS,IAAA,EAAM,MAAA;EJ/PnH;;;;;;;;EIyQF,GAAA,GACE,MAAA,EAAQ,aAAA,KACL,gBAAA,CAAiB,OAAA,EAAS,YAAA,EAAc,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,IAAA,EAAM,SAAA,EAAW,WAAA,EAAa,OAAA,EAAS,IAAA,EAAM,MAAA;EAErH,SAAA,GACE,MAAA,EAAQ,oBAAA,KACL,gBAAA,CAAiB,OAAA,EAAS,YAAA,EAAc,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,IAAA,EAAM,SAAA,EAAW,WAAA,EAAa,OAAA,EAAS,IAAA,EAAM,MAAA;EJ1PvE;;;;;;;AAiBhD;;;;;;;EIyPE,OAAA,GACE,OAAA,EAAS,cAAA,KACN,gBAAA,CAAiB,OAAA,EAAS,YAAA,EAAc,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,IAAA,EAAM,SAAA,EAAW,WAAA,EAAa,OAAA,EAAS,IAAA,EAAM,MAAA;EJ1PjH;;;;;;;;;AA+CN;;;;;;EI4NE,KAAA,QAAa,gBAAA,CAAiB,OAAA,EAAS,YAAA,EAAc,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,IAAA,EAAM,SAAA,EAAW,WAAA,EAAa,OAAA,EAAS,IAAA;;AHvWzH;;;;;AAAqC;;;;;AACA;;;;;AACR;;;;;AAG7B;;;;;;;;;EGkYE,SAAA,oBAA6B,aAAA,GAAgB,aAAA,sBAAmC,WAAA,CAAY,QAAA,IAAY,WAAA,CAAY,QAAA,GAClH,MAAA,GAAS,QAAA,KAAa,YAAA,EAAc,WAAA,KAAgB,QAAA,GACpD,IAAA,GAAO,KAAA,KACJ,gBAAA,CACH,OAAA,EACA,YAAA,EACA,KAAA,EACA,WAAA,EACA,QAAA,EACA,IAAA,EACA,SAAA,EACA,WAAA,EACA,OAAA,EACA,IAAA,EACA,WAAA,CAAY,OAAA,CAAQ,MAAA,EAAQ,QAAA,GAAW,KAAA;EHhZyD;;;;;;;EG0ZlG,UAAA,sBAAgC,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,KAAU,KAAA,EAC3F,IAAA,iCACA,MAAA,GAAS,UAAA,KAAe,UAAA,EAAY,KAAA,KAAU,UAAA,MAC3C,gBAAA,CACH,OAAA,EACA,YAAA,EACA,KAAA,EACA,WAAA,EACA,KAAA,EACA,IAAA,EACA,SAAA,EACA,WAAA,EACA,UAAA,EACA,IAAA,EACA,OAAA,CAAQ,MAAA,EAAQ,UAAA;EHxakF;;AAStG;;;;;;;EG2aE,GAAA,mBAAsB,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,KAAU,KAAA,EACjF,MAAA,EAAQ,OAAA,KAAY,UAAA,EAAY,KAAA,KAAU,OAAA,MACvC,gBAAA,CACH,OAAA,EACA,YAAA,EACA,KAAA,EACA,WAAA,EACA,KAAA,EACA,IAAA,EACA,SAAA,EACA,WAAA,EACA,OAAA,EACA,OAAA,EACA,OAAA,CAAQ,MAAA,EAAQ,OAAA;EHxbM;;;;EG+bxB,MAAA,YACE,OAAA,IACE,IAAA,EAAM,gBAAA,CAAiB,WAAA,CAAY,KAAA,GACnC,GAAA,EAAK,oBAAA,EACL,IAAA,GAAO,IAAA,EAAM,gBAAA,CAAiB,WAAA,CAAY,KAAA,GAAQ,GAAA,EAAK,oBAAA,KAAyB,IAAA,KAC7E,OAAA,KACF,gBAAA,CAAiB,OAAA,EAAS,YAAA,EAAc,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,OAAA,EAAS,SAAA,EAAW,WAAA,EAAa,OAAA,EAAS,IAAA,EAAM,MAAA;EHrcvC;;AAMnF;;;;;;;;;;;;;;;AAUA;;;;;;;;;;;AAUA;;;;;;;;;;;;;;;AAaA;;;;;;;;;;;;;EGwdE,IAAA,qBAAyB,aAAA,GAAgB,KAAA,EACvC,MAAA,EAAQ,UAAA,CAAW,KAAA,EAAO,SAAA,MACvB,gBAAA,CACH,OAAA,EACA,YAAA,EACA,KAAA,EACA,WAAA,EACA,KAAA,EACA,OAAA,CAAQ,UAAA,GACR,SAAA,EACA,WAAA,EACA,OAAA,EACA,IAAA,EACA,MAAA;EHreqB;;;;;;;;;;;;;AAAoG;;;;;;;;;;;EGggB3H,OAAA,gFAGmB,gBAAA,GAAmB,qBAAA,CAClC,YAAA,EACA,WAAA,EACA,eAAA,CAAgB,KAAA,EAAO,WAAA,GACvB,KAAA,EACA,SAAA,GAGF,IAAA,EAAM,WAAA,aAAwB,WAAA,KAAgB,QAAA,GAC9C,SAAA,IACE,OAAA,EAAS,qBAAA,CAAsB,YAAA,EAAc,WAAA,EAAa,eAAA,CAAgB,KAAA,EAAO,WAAA,GAAc,KAAA,EAAO,SAAA,MACnG,QAAA,KACF,gBAAA,CACH,OAAA,EACA,YAAA,EACA,KAAA,EACA,WAAA,EACA,KAAA,EACA,IAAA,EACA,SAAA,eACK,WAAA,CAAY,QAAA,uBAA+B,QAAA,KAC5C,iBAAA,WAA4B,SAAA,IACzB,WAAA,CAAY,QAAA,uBAA+B,QAAA,KAC5C,sBAAA,CACE,SAAA,EACA,WAAA,EACA,WAAA,CAAY,QAAA,uBAA+B,eAAA,CAAgB,SAAA,EAAW,WAAA,EAAa,QAAA,KAE3F,WAAA,EACA,OAAA,EACA,IAAA,EACA,MAAA;EHhiBa;;;;;;;;;;;;;AAEP;;;;;;;EGqjBR,KAAA,gFAAqF,gBAAA,GAAmB,gBAAA,EACtG,IAAA,EAAM,WAAA,aAAwB,WAAA,KAAgB,QAAA,GAC9C,OAAA,EAAS,QAAA,KACN,gBAAA,CACH,OAAA,EACA,YAAA,EACA,KAAA,EACA,WAAA,EACA,KAAA,EACA,IAAA,EACA,SAAA,eAEM,WAAA,CACE,cAAA,CACE,WAAA,EACA,eAAA,CAAgB,KAAA,EAAO,WAAA,GACvB,QAAA,+CACA,QAAA,2CACA,cAAA,CACE,QAAA,6CACA,eAAA,CAAgB,WAAA,EAAa,eAAA,CAAgB,KAAA,EAAO,WAAA,SAGtD,QAAA,iDACA,QAAA,8CACA,QAAA,2CAEF,QAAA,KAGJ,iBAAA,WAA4B,SAAA,IAExB,WAAA,CACE,cAAA,CACE,WAAA,EACA,eAAA,CAAgB,KAAA,EAAO,WAAA,GACvB,QAAA,+CACA,QAAA,2CACA,cAAA,CACE,QAAA,6CACA,eAAA,CAAgB,WAAA,EAAa,eAAA,CAAgB,KAAA,EAAO,WAAA,SAGtD,QAAA,iDACA,QAAA,8CACA,QAAA,2CAEF,QAAA,KAGJ,sBAAA,CACE,SAAA,EACA,WAAA,EACA,WAAA,CACE,cAAA,CACE,WAAA,EACA,eAAA,CAAgB,KAAA,EAAO,WAAA,GACvB,QAAA,+CACA,QAAA,2CACA,cAAA,CACE,QAAA,6CACA,eAAA,CAAgB,WAAA,EAAa,eAAA,CAAgB,KAAA,EAAO,WAAA,SAGtD,QAAA,iDACA,QAAA,8CACA,QAAA,2CAEF,eAAA,CAAgB,SAAA,EAAW,WAAA,EAAa,QAAA,KAGlD,WAAA,EACA,OAAA,EACA,IAAA,EACA,MAAA,GH7nBqE;EGioBvE,QAAA;IACE,WAAA,EAAa,YAAA;IACb,IAAA,EAAM,KAAA;IACN,UAAA,EAAY,WAAA;IACZ,IAAA,EAAM,eAAA,CAAgB,KAAA,EAAO,WAAA;IAC7B,OAAA;IACA,UAAA,EAAY,KAAA;IACZ,MAAA,EAAQ,IAAA;IACR,QAAA,EAAU,SAAA;IACV,KAAA,EAAO,MAAA;IACP,OAAA,EAAS,cAAA,CAAe,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,IAAA,EAAM,SAAA,MAAe,OAAA,EAAS,IAAA,EAAM,MAAA;EAAA;AAAA;AAAA,KAI/E,cAAA,iHAII,aAAA,GAAgB,aAAA,CAAc,WAAA,sCAEtB,iBAAA,8BACF,aAAA,GAAgB,aAAA,wBACpB,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,KAAU,aAAA,qBAChE,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,KAAU,aAAA,0CAExE,qBAAA,CAAsB,YAAA,EAAc,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,IAAA,EAAM,SAAA,EAAW,WAAA,EAAa,OAAA,EAAS,IAAA,EAAM,MAAA;AAAA,KAEpG,cAAA,iHAII,aAAA,GAAgB,aAAA,CAAc,WAAA,sCAEtB,iBAAA,8BACF,aAAA,GAAgB,aAAA,wBACpB,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,KAAU,aAAA,qBAChE,aAAA,UAAuB,gBAAA,CAAiB,UAAA,CAAW,KAAA,KAAU,aAAA,0CAExE,qBAAA,CAAsB,YAAA,EAAc,KAAA,EAAO,WAAA,EAAa,KAAA,EAAO,IAAA,EAAM,SAAA,EAAW,WAAA,EAAa,OAAA,EAAS,IAAA,EAAM,MAAA;EH5pB7F;;;EGgqBjB,GAAA,0BAA6B,gBAAA,EAAkB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,iBACjF,IAAA,EAAM,QAAA,GAAW,UAAA,EACjB,IAAA,EAAM,OAAA,CAAQ,YAAA,OAAmB,iBAAA,EAAmB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,IAAa,QAAA,QAClG,oBAAA,CAAqB,iBAAA,EAAmB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,IAAa,QAAA;EH/pB5E;;;;;;;;;;;;;EG8qBlB,IAAA,0BAA8B,gBAAA,EAAkB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,iBAClF,KAAA,EAAO,QAAA,GAAW,UAAA,EAClB,KAAA,GAAQ,sBAAA,KACL,YAAA,CACH,oBAAA,CAAqB,6BAAA,EAA+B,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,IAAa,QAAA,IACrG,6BAAA,EAA+B,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,IAAa,QAAA;EHnrBhE;;;;;EG2rBlB,GAAA,GACE,KAAA,GAAQ,qBAAA,CAAsB,gBAAA,EAAkB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,SACjF,YAAA,CAAa,oBAAA,CAAqB,eAAA,EAAiB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,MAAe,MAAA;EH1rB1F;;;EG+rBjB,KAAA,0BAA+B,gBAAA,EAAkB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,kBACnF,KAAA,GAAQ,QAAA,GAAW,UAAA,KAChB,YAAA,CACH,kBAAA,CAAmB,6BAAA,EAA+B,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,IAAa,QAAA,IACnG,6BAAA,EAA+B,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,IAAa,QAAA;EHnsBT;;;EGysBzE,SAAA,0BAAmC,gBAAA,EAAkB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,kBACvF,OAAA,GAAU,QAAA,GAAW,UAAA,EACrB,IAAA,GAAO,YAAA,QAAoB,6BAAA,EAA+B,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,IAAa,QAAA;EH3sB3F;;;EGitBlB,IAAA,uBAA2B,gBAAA,EAAkB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,kBAC/E,OAAA,EAAS,KAAA,GAAQ,UAAA,KACd,6BAAA,EAA+B,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,IAAa,KAAA;EHntBZ;;;EGwtBzE,GAAA,QAAW,UAAA,CAAW,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA;EHttBhD;;;;;;;;;;;;;;;;;AAEkB;EGwuB5B,IAAA,GACE,OAAA,GAAU,sBAAA,CAAuB,gBAAA,EAAkB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,SACpF,aAAA,CAAc,oBAAA,CAAqB,eAAA,EAAiB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA;EHruB5E;;;EG0uBjB,IAAA,QAAY,IAAA;IAAO,OAAA;EAAA;EHtuB0C;;;EG2uB7D,IAAA,0BAA8B,gBAAA,EAAkB,cAAA,SAAuB,KAAA,EAAO,IAAA,EAAM,SAAA,kBAClF,OAAA,GAAU,QAAA,EACV,KAAA,GAAQ,eAAA;EHjvBQ;;;;;;;;;;;;;AAIsD;EG8vBxE,UAAA,GAAa,KAAA,8CAAmD,OAAA;AAAA;AAAA,KAGtD,iBAAA,GAAoB,cAAA,uCAAqD,iBAAA;;;;;KAMzE,kBAAA;AAAA,KAEA,sBAAA;EHhwBG,kHGkwBb,MAAA;EHlwB2B;;;;;EGwwB3B,QAAA;EH1wB8C;;;;;EGgxB9C,IAAA,mBH9wBqC;EGgxBrC,OAAA,aH9wBI;EGgxBJ,UAAA;EHhxBQ;AAOV;;;;;;;;EGmxBE,OAAA,GAAU,kBAAA;IAAuB,MAAA,GAAS,kBAAA;IAAoB,KAAA,GAAQ,kBAAA;EAAA,GH7wBnD;EG+wBnB,YAAA;EHrxB0B;;;;;EG2xB1B,KAAA,GAAQ,MAAA;EHzxBC;;;;;EGgyBT,UAAA;AAAA;;;;KAMU,sBAAA;EH3xBsB;;;;;;;;EGoyBhC,WAAA;EHnyBiF;;;;;;;;;;EG+yBjF,UAAA;EH/yBA;;;;;EGszBA,OAAA,GAAU,cAAA;AAAA;;;;KAMA,qBAAA,mCAAwD,sBAAA;EH1zB/D,uGG4zBH,IAAA,GAAO,sBAAA,CAAuB,MAAA;AAAA;AAAA,KAGpB,oBAAA,kBAAsC,iBAAA,GAAoB,iBAAA,IAAqB,kBAAA,CAAmB,QAAA;EAC5G,MAAA,EAAQ,UAAA,CAAW,QAAA;AAAA;AAAA,KAGT,kBAAA,kBAAoC,iBAAA,GAAoB,iBAAA;EAClE,OAAA,EAAS,QAAA;EACT,IAAA,GAAO,YAAA,QAAoB,QAAA;EAC3B,UAAA,GAAa,gBAAA,CAAiB,MAAA,CAAO,YAAA,QAAoB,QAAA;AAAA;AAAA,KAG/C,UAAA,kBAA4B,iBAAA,IAAqB,iBAAA,CAAkB,QAAA,YACvE,QAAA,kCAA0C,CAAA,WAAY,UAAA,CAAW,CAAA;AAAA,KAGpE,iBAAA,kBAAmC,iBAAA,KAAsB,IAAA,EAAM,YAAA,OAAmB,QAAA,MAAc,UAAA,CAAW,QAAA;AAAA,KAE3G,kBAAA,UAA4B,SAAA,CAAU,KAAA,wBAA6B,WAAA,GAAc,KAAA;AAAA,KACjF,YAAA,6CAAyD,iBAAA,IAAqB,IAAA,gBAC/E,kBAAA,CAAmB,QAAA,2BACnB,kBAAA,CAAmB,QAAA;AAAA,KAElB,UAAA,kBAA4B,iBAAA,IAAqB,UAAA,CAAW,WAAA,CAAY,QAAA;AAAA,KAExE,WAAA,eAA0B,aAAA,IAAiB,qBAAA,CAAsB,WAAA,CAAY,gBAAA,CAAiB,UAAA,CAAW,KAAA;;KAOlG,iBAAA;EH31BY,6FG61BtB,OAAA,EAAS,iBAAA,EH31ByB;EG61BlC,KAAA,EAAO,MAAA;AAAA;;KAIG,kBAAA,GAAqB,iBAAA;EH/1BD,uEGi2B9B,KAAA;AAAA;;KAIU,iBAAA;EACV,OAAA,EAAS,iBAAA;EACT,OAAA,EAAS,MAAA;EACT,cAAA;AAAA;;KAIU,qBAAA,GAAwB,iBAAA;EHp2B7B,+GGs2BL,OAAA,EAAS,MAAA,mBHr2BJ;EGu2BL,cAAA;AAAA;;KAIU,oBAAA;EACV,IAAA;EACA,UAAA,EAAY,gBAAA,CAAiB,MAAA;AAAA;;KAInB,oBAAA,GAAuB,iBAAA;EHv3B8C,2GGy3B/E,IAAA;AAAA;;KAIU,mBAAA;EACV,MAAA;AAAA;;KAIU,kBAAA,GAAqB,iBAAA;EH73B1B,uEG+3BL,KAAA;AAAA;;KAIU,kBAAA,GAAqB,iBAAA;EHl4BK,iCGo4BpC,KAAA;AAAA;;KAIU,iBAAA;EHr4BiB,kFGu4B3B,KAAA,YHt4BkB;EGw4BlB,MAAA;AAAA;;KAIU,qBAAA,GAAwB,iBAAA;EHx4BhB,wEG04BlB,KAAA,YH14BuD;EG44BvD,MAAA;AAAA;AAAA,KAGG,kBAAA,mBAAqC,GAAA,EAAK,IAAA,EAAM,IAAA,QAAY,OAAA,GAAU,OAAA,CAAQ,OAAA,MAAa,OAAA,GAAU,OAAA,CAAQ,OAAA;;;;;;;;;;;;KAatG,aAAA;EH55BiC,gGG85B3C,IAAA;EH75BI;;;;EGk6BJ,KAAA;EHh6BQ;;;AAKV;EGg6BE,KAAA,GAAQ,kBAAA,CAAmB,kBAAA,YHh6BF;EGk6BzB,KAAA,GAAQ,kBAAA,CAAmB,kBAAA,EAAoB,iBAAA,GHl6BoB;EGo6BnE,QAAA,GAAW,kBAAA,CAAmB,qBAAA,EAAuB,oBAAA,GHh6BvB;EGk6B9B,OAAA,GAAU,kBAAA,CAAmB,oBAAA,EAAsB,mBAAA;EHl6BC;;;;EGu6BpD,KAAA,GAAQ,kBAAA,CAAmB,kBAAA,EAAoB,iBAAA;EHr6BrC;;;;EG06BV,QAAA,GAAW,kBAAA,CAAmB,qBAAA;AAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "padrone",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Create type-safe, interactive CLI apps with Zod schemas",
   "license": "MIT",
   "type": "module",

package/src/args.ts

@@ -1,7 +1,41 @@
 import type { StandardJSONSchemaV1 } from '@standard-schema/spec';
 
+type Letter =
+  | 'a'
+  | 'b'
+  | 'c'
+  | 'd'
+  | 'e'
+  | 'f'
+  | 'g'
+  | 'h'
+  | 'i'
+  | 'j'
+  | 'k'
+  | 'l'
+  | 'm'
+  | 'n'
+  | 'o'
+  | 'p'
+  | 'q'
+  | 'r'
+  | 's'
+  | 't'
+  | 'u'
+  | 'v'
+  | 'w'
+  | 'x'
+  | 'y'
+  | 'z';
+
+/** A single letter character, valid as a short CLI flag (e.g. `'v'`, `'n'`, `'V'`). */
+export type SingleChar = Letter | Uppercase<Letter>;
+
 export interface PadroneFieldMeta {
   description?: string;
+  /** Single-character short flags (stackable: `-abc` = `-a -b -c`). Used with single dash. */
+  flags?: SingleChar[] | SingleChar;
+  /** Multi-character alternative long names. Used with double dash (e.g. `--dry-run` for `--dryRun`). */
   alias?: string[] | string;
   deprecated?: boolean | string;
   hidden?: boolean;
@@ -11,7 +45,7 @@ export interface PadroneFieldMeta {
 type PositionalArgs<TObj> =
   TObj extends Record<string, any>
     ? {
-        [K in keyof TObj]: TObj[K] extends Array<any> ? `...${K & string}` : K & string;
+        [K in keyof TObj]: NonNullable<TObj[K]> extends Array<any> ? `...${K & string}` | (K & string) : K & string;
       }[keyof TObj]
     : string;
 
@@ -54,6 +88,22 @@ export interface PadroneArgsSchemaMeta<TObj = Record<string, any>> {
    * Per-argument metadata.
    */
   fields?: { [K in keyof TObj]?: PadroneFieldMeta };
+  /**
+   * Automatically generate kebab-case aliases for camelCase option names.
+   * For example, `dryRun` automatically gets `--dry-run` as an alias.
+   * Defaults to `true`. Set to `false` to disable.
+   *
+   * @default true
+   * @example
+   * ```ts
+   * // Auto-aliases enabled (default): --dry-run → dryRun
+   * .arguments(z.object({ dryRun: z.boolean() }))
+   *
+   * // Disable auto-aliases
+   * .arguments(z.object({ dryRun: z.boolean() }), { autoAlias: false })
+   * ```
+   */
+  autoAlias?: boolean;
   /**
    * Read from stdin and inject the data into the specified argument field.
    * Only reads when stdin is piped (not a TTY) and the field wasn't already provided via CLI flags.
@@ -110,6 +160,15 @@ export interface PadroneArgsSchemaMeta<TObj = Record<string, any>> {
   optionalInteractive?: true | (keyof TObj & string)[];
 }
 
+/**
+ * Convert a camelCase string to kebab-case.
+ * Returns null if the string has no uppercase letters (no conversion needed).
+ */
+export function camelToKebab(str: string): string | null {
+  if (!/[A-Z]/.test(str)) return null;
+  return str.replace(/[A-Z]/g, (ch) => `-${ch.toLowerCase()}`);
+}
+
 /**
  * Normalizes stdin config into its explicit form.
  */
@@ -133,17 +192,32 @@ export function parsePositionalConfig(positional: string[]): { name: string; var
  * Result type for extractSchemaMetadata function.
  */
 interface SchemaMetadataResult {
+  /** Single-char flags: maps flag char → full arg name (e.g. `{ v: 'verbose' }`) */
+  flags: Record<string, string>;
+  /** Multi-char aliases: maps alias → full arg name (e.g. `{ 'dry-run': 'dryRun' }`) */
   aliases: Record<string, string>;
 }
 
+function addEntries(target: Record<string, string>, key: string, items: string | string[], filter?: (item: string) => boolean) {
+  const list = typeof items === 'string' ? [items] : items;
+  for (const item of list) {
+    if (typeof item === 'string' && item && item !== key && !(item in target) && (!filter || filter(item))) {
+      target[item] = key;
+    }
+  }
+}
+
 /**
  * Extract all arg metadata from schema and meta in a single pass.
- * This consolidates aliases, env bindings, and config keys extraction.
+ * Returns flags (single-char, stackable) and aliases (multi-char, long names) separately.
+ * When `autoAlias` is true (default), camelCase property names automatically get kebab-case aliases.
  */
 export function extractSchemaMetadata(
   schema: StandardJSONSchemaV1,
   meta?: Record<string, PadroneFieldMeta | undefined>,
+  autoAlias?: boolean,
 ): SchemaMetadataResult {
+  const flags: Record<string, string> = {};
   const aliases: Record<string, string> = {};
 
   // Extract from meta object
@@ -151,14 +225,11 @@ export function extractSchemaMetadata(
     for (const [key, value] of Object.entries(meta)) {
       if (!value) continue;
 
-      // Extract aliases
+      if (value.flags) {
+        addEntries(flags, key, value.flags, (item) => item.length === 1);
+      }
       if (value.alias) {
-        const list = typeof value.alias === 'string' ? [value.alias] : value.alias;
-        for (const aliasKey of list) {
-          if (typeof aliasKey === 'string' && aliasKey && aliasKey !== key) {
-            aliases[aliasKey] = key;
-          }
-        }
+        addEntries(aliases, key, value.alias, (item) => item.length > 1);
       }
     }
   }
@@ -170,16 +241,26 @@ export function extractSchemaMetadata(
       for (const [propertyName, propertySchema] of Object.entries(jsonSchema.properties as Record<string, any>)) {
         if (!propertySchema) continue;
 
-        // Extract aliases from schema
+        // Extract flags from schema `.meta({ flags: ... })`
+        const propFlags = propertySchema.flags;
+        if (propFlags) {
+          addEntries(flags, propertyName, propFlags, (item) => item.length === 1);
+        }
+
+        // Extract aliases from schema `.meta({ alias: ... })`
         const propAlias = propertySchema.alias;
         if (propAlias) {
           const list = typeof propAlias === 'string' ? [propAlias] : propAlias;
           if (Array.isArray(list)) {
-            for (const aliasKey of list) {
-              if (typeof aliasKey === 'string' && aliasKey && aliasKey !== propertyName && !(aliasKey in aliases)) {
-                aliases[aliasKey] = propertyName;
-              }
-            }
+            addEntries(aliases, propertyName, list, (item) => item.length > 1);
+          }
+        }
+
+        // Auto-generate kebab-case alias for camelCase property names
+        if (autoAlias !== false) {
+          const kebab = camelToKebab(propertyName);
+          if (kebab && !(kebab in aliases)) {
+            aliases[kebab] = propertyName;
           }
         }
       }
@@ -188,18 +269,18 @@ export function extractSchemaMetadata(
     // Ignore errors from JSON schema generation
   }
 
-  return { aliases };
+  return { flags, aliases };
 }
 
-function preprocessAliases(data: Record<string, unknown>, aliases: Record<string, string>): Record<string, unknown> {
+function preprocessMappings(data: Record<string, unknown>, mappings: Record<string, string>): Record<string, unknown> {
   const result = { ...data };
 
-  for (const [aliasKey, fullArgName] of Object.entries(aliases)) {
-    if (aliasKey in data && aliasKey !== fullArgName) {
-      const aliasValue = data[aliasKey];
+  for (const [mappedKey, fullArgName] of Object.entries(mappings)) {
+    if (mappedKey in data && mappedKey !== fullArgName) {
+      const mappedValue = data[mappedKey];
       // Prefer full arg name if it exists
-      if (!(fullArgName in result)) result[fullArgName] = aliasValue;
-      delete result[aliasKey];
+      if (!(fullArgName in result)) result[fullArgName] = mappedValue;
+      delete result[mappedKey];
     }
   }
 
@@ -207,6 +288,7 @@ function preprocessAliases(data: Record<string, unknown>, aliases: Record<string
 }
 
 interface ParseArgsContext {
+  flags?: Record<string, string>;
   aliases?: Record<string, string>;
   stdinData?: Record<string, unknown>;
   envData?: Record<string, unknown>;
@@ -238,9 +320,12 @@ function applyValues(data: Record<string, unknown>, values: Record<string, unkno
 export function preprocessArgs(data: Record<string, unknown>, ctx: ParseArgsContext): Record<string, unknown> {
   let result = { ...data };
 
-  // 1. Apply aliases first
+  // 1. Apply flags and aliases first
+  if (ctx.flags && Object.keys(ctx.flags).length > 0) {
+    result = preprocessMappings(result, ctx.flags);
+  }
   if (ctx.aliases && Object.keys(ctx.aliases).length > 0) {
-    result = preprocessAliases(result, ctx.aliases);
+    result = preprocessMappings(result, ctx.aliases);
   }
 
   // 2. Apply stdin data (higher precedence than env)
@@ -297,10 +382,12 @@ export function coerceArgs(data: Record<string, unknown>, schema: StandardJSONSc
         if (value === 'true' || value === '1') result[key] = true;
         else if (value === 'false' || value === '0') result[key] = false;
       }
-    } else if (targetType === 'array' && Array.isArray(value)) {
+    } else if (targetType === 'array') {
+      // Coerce single items to array
+      const arr = Array.isArray(value) ? value : [value];
       const itemType = prop.items?.type as string | undefined;
       if (itemType === 'number' || itemType === 'integer') {
-        result[key] = value.map((v) => {
+        result[key] = arr.map((v) => {
           if (typeof v === 'string') {
             const num = Number(v);
             return Number.isNaN(num) ? v : num;
@@ -308,13 +395,15 @@ export function coerceArgs(data: Record<string, unknown>, schema: StandardJSONSc
           return v;
         });
       } else if (itemType === 'boolean') {
-        result[key] = value.map((v) => {
+        result[key] = arr.map((v) => {
           if (typeof v === 'string') {
             if (v === 'true' || v === '1') return true;
             if (v === 'false' || v === '0') return false;
           }
           return v;
         });
+      } else if (!Array.isArray(value)) {
+        result[key] = arr;
       }
     }
   }
@@ -333,6 +422,7 @@ const frameworkReservedKeys = new Set(['config', 'c']);
 export function detectUnknownArgs(
   data: Record<string, unknown>,
   schema: StandardJSONSchemaV1,
+  flags: Record<string, string>,
   aliases: Record<string, string>,
   suggestFn: (input: string, candidates: string[]) => string,
 ): { key: string; suggestion: string }[] {
@@ -350,7 +440,13 @@ export function detectUnknownArgs(
 
   if (isLoose) return [];
 
-  const knownKeys = new Set<string>([...Object.keys(properties), ...Object.keys(aliases), ...Object.values(aliases)]);
+  const knownKeys = new Set<string>([
+    ...Object.keys(properties),
+    ...Object.keys(flags),
+    ...Object.values(flags),
+    ...Object.keys(aliases),
+    ...Object.values(aliases),
+  ]);
   const propertyNames = Object.keys(properties);
   const unknowns: { key: string; suggestion: string }[] = [];
 

package/src/cli/doctor.ts

@@ -160,18 +160,36 @@ function checkShadowedOptionNames(commands: AnyPadroneCommand[], diagnostics: Di
       }
     }
 
-    // Also check field aliases from meta
+    // Also check field flags and aliases from meta
     if (cmd.meta?.fields) {
       for (const [fieldName, fieldMeta] of Object.entries(cmd.meta.fields)) {
-        if (!fieldMeta?.alias) continue;
-        const aliases = typeof fieldMeta.alias === 'string' ? [fieldMeta.alias] : fieldMeta.alias;
-        for (const alias of aliases) {
-          if (builtins.has(alias)) {
-            diagnostics.push({
-              severity: 'warning',
-              command: commandDisplayName(cmd),
-              message: `Alias "${alias}" on field "${fieldName}" shadows the built-in --${alias} flag.`,
-            });
+        if (!fieldMeta) continue;
+
+        // Check flags (single-char)
+        if (fieldMeta.flags) {
+          const flagList = typeof fieldMeta.flags === 'string' ? [fieldMeta.flags] : fieldMeta.flags;
+          for (const flag of flagList) {
+            if (builtins.has(flag)) {
+              diagnostics.push({
+                severity: 'warning',
+                command: commandDisplayName(cmd),
+                message: `Flag "${flag}" on field "${fieldName}" shadows the built-in --${flag} flag.`,
+              });
+            }
+          }
+        }
+
+        // Check aliases (multi-char)
+        if (fieldMeta.alias) {
+          const aliasList = typeof fieldMeta.alias === 'string' ? [fieldMeta.alias] : fieldMeta.alias;
+          for (const alias of aliasList) {
+            if (builtins.has(alias)) {
+              diagnostics.push({
+                severity: 'warning',
+                command: commandDisplayName(cmd),
+                message: `Alias "${alias}" on field "${fieldName}" shadows the built-in --${alias} flag.`,
+              });
+            }
           }
         }
       }

package/src/codegen/generators/command-file.ts

@@ -173,10 +173,23 @@ function buildFieldsMap(fields: FieldMeta[]): string | null {
   const entries: string[] = [];
   for (const field of fields) {
     if (field.aliases && field.aliases.length > 0) {
-      const alias =
-        field.aliases.length === 1 ? JSON.stringify(field.aliases[0]) : `[${field.aliases.map((a) => JSON.stringify(a)).join(', ')}]`;
+      // Split into flags (single-char) and aliases (multi-char)
+      const singleChar = field.aliases.filter((a) => a.replace(/^-+/, '').length === 1).map((a) => a.replace(/^-+/, ''));
+      const multiChar = field.aliases.filter((a) => a.replace(/^-+/, '').length > 1).map((a) => a.replace(/^-+/, ''));
+
       const key = /^[a-zA-Z_$][\w$]*$/.test(field.name) ? field.name : JSON.stringify(field.name);
-      entries.push(`${key}: { alias: ${alias} }`);
+      const parts: string[] = [];
+      if (singleChar.length > 0) {
+        const flags = singleChar.length === 1 ? JSON.stringify(singleChar[0]) : `[${singleChar.map((a) => JSON.stringify(a)).join(', ')}]`;
+        parts.push(`flags: ${flags}`);
+      }
+      if (multiChar.length > 0) {
+        const alias = multiChar.length === 1 ? JSON.stringify(multiChar[0]) : `[${multiChar.map((a) => JSON.stringify(a)).join(', ')}]`;
+        parts.push(`alias: ${alias}`);
+      }
+      if (parts.length > 0) {
+        entries.push(`${key}: { ${parts.join(', ')} }`);
+      }
     }
   }
   if (entries.length === 0) return null;

package/src/command-utils.ts

@@ -103,6 +103,34 @@ export function thenMaybe<T, U>(value: T | Promise<T>, fn: (v: T) => U | Promise
   return fn(value);
 }
 
+/**
+ * Makes a sync result object thenable by adding a `.then()` method.
+ * If the value is already a Promise, returns it as-is.
+ * This allows users to write `await program.cli()` or `program.cli().then(...)` regardless of sync/async.
+ *
+ * The `.then()` resolves with a plain copy (without `.then`) to avoid infinite
+ * recursive unwrapping by the Promise resolution algorithm.
+ */
+export function makeThenable<T>(value: T | Promise<T>): T & PromiseLike<T> {
+  if (value instanceof Promise) return value as any;
+  if (value !== null && typeof value === 'object' && !('then' in value)) {
+    // biome-ignore lint/suspicious/noThenProperty: intentional thenable shim for sync results
+    (value as any).then = (onfulfilled?: (v: T) => any, onrejected?: (reason: any) => any) => {
+      try {
+        // Resolve with a plain copy to prevent infinite thenable unwrapping
+        const plain = { ...value } as any;
+        delete plain.then;
+        const result = onfulfilled ? onfulfilled(plain) : plain;
+        return Promise.resolve(result);
+      } catch (err) {
+        if (onrejected) return Promise.resolve(onrejected(err));
+        return Promise.reject(err);
+      }
+    };
+  }
+  return value as any;
+}
+
 export function isIterator(value: unknown): value is Iterator<unknown> {
   return typeof value === 'object' && value !== null && Symbol.iterator in value && typeof (value as any)[Symbol.iterator] === 'function';
 }
@@ -364,14 +392,17 @@ export function buildReplCompleter(
       if (targetCommand.argsSchema) {
         try {
           const argsMeta = targetCommand.meta?.fields;
-          const { aliases } = extractSchemaMetadata(targetCommand.argsSchema, argsMeta);
+          const { flags, aliases } = extractSchemaMetadata(targetCommand.argsSchema, argsMeta, targetCommand.meta?.autoAlias);
           const jsonSchema = targetCommand.argsSchema['~standard'].jsonSchema.input({ target: 'draft-2020-12' }) as Record<string, any>;
           if (jsonSchema.type === 'object' && jsonSchema.properties) {
             for (const key of Object.keys(jsonSchema.properties)) {
               options.push(`--${key}`);
             }
+            for (const flag of Object.keys(flags)) {
+              options.push(`-${flag}`);
+            }
             for (const alias of Object.keys(aliases)) {
-              options.push(`-${alias}`);
+              options.push(`--${alias}`);
             }
           }
         } catch {

package/src/completion.ts

@@ -32,7 +32,7 @@ function extractArguments(cmd: AnyPadroneCommand): { name: string; alias?: strin
 
   try {
     const argsMeta = cmd.meta?.fields;
-    const { aliases } = extractSchemaMetadata(cmd.argsSchema, argsMeta);
+    const { aliases } = extractSchemaMetadata(cmd.argsSchema, argsMeta, cmd.meta?.autoAlias);
 
     // Reverse aliases map (alias -> arg name)
     const aliasToArgument: Record<string, string> = {};

package/src/create.ts

@@ -7,6 +7,7 @@ import {
   getCommandRuntime,
   hasInteractiveConfig,
   isAsyncBranded,
+  makeThenable,
   mergeCommands,
   noop,
   outputValue,
@@ -126,8 +127,10 @@ export function createPadroneBuilder<TBuilder extends PadroneProgram = PadronePr
 
     // Extract argument metadata from the nested arguments object in meta
     const argsMeta = curCommand.meta?.fields;
-    const schemaMetadata = curCommand.argsSchema ? extractSchemaMetadata(curCommand.argsSchema, argsMeta) : { aliases: {} };
-    const { aliases } = schemaMetadata;
+    const schemaMetadata = curCommand.argsSchema
+      ? extractSchemaMetadata(curCommand.argsSchema, argsMeta, curCommand.meta?.autoAlias)
+      : { flags: {}, aliases: {} };
+    const { flags, aliases } = schemaMetadata;
 
     // Get array arguments from schema (arrays are always variadic)
     const arrayArguments = new Set<string>();
@@ -148,9 +151,15 @@ export function createPadroneBuilder<TBuilder extends PadroneProgram = PadronePr
     const rawArgs: Record<string, unknown> = {};
 
     for (const arg of argParts) {
-      // For aliases, resolve to the full key name (aliases map single char to full key name)
-      // arg.key is now a string[] - for aliases it's always single element like ['v']
-      const key: string[] = arg.type === 'alias' && arg.key.length === 1 && aliases[arg.key[0]!] ? [aliases[arg.key[0]!]!] : arg.key;
+      // Resolve flags (single-char, from alias parts: -v) and aliases (multi-char, from named parts: --dry-run)
+      let key: string[];
+      if (arg.type === 'alias' && arg.key.length === 1 && flags[arg.key[0]!]) {
+        key = [flags[arg.key[0]!]!];
+      } else if (arg.type === 'named' && arg.key.length === 1 && aliases[arg.key[0]!]) {
+        key = [aliases[arg.key[0]!]!];
+      } else {
+        key = arg.key;
+      }
 
       const rootKey = key[0]!;
 
@@ -202,7 +211,8 @@ export function createPadroneBuilder<TBuilder extends PadroneProgram = PadronePr
   ): Record<string, unknown> => {
     // Apply preprocessing (stdin, env, and config bindings)
     let preprocessedArgs = preprocessArgs(rawArgs, {
-      aliases: {}, // Already resolved aliases in parseCommand
+      flags: {}, // Already resolved in parseCommand
+      aliases: {}, // Already resolved in parseCommand
       stdinData: context?.stdinData,
       envData: context?.envData,
       configData: context?.configData,
@@ -255,9 +265,9 @@ export function createPadroneBuilder<TBuilder extends PadroneProgram = PadronePr
     if (!command.argsSchema) return [];
 
     const argsMeta = command.meta?.fields;
-    const { aliases } = extractSchemaMetadata(command.argsSchema, argsMeta);
+    const { flags, aliases } = extractSchemaMetadata(command.argsSchema, argsMeta, command.meta?.autoAlias);
 
-    return detectUnknownArgs(preprocessedArgs, command.argsSchema, aliases, suggestSimilar);
+    return detectUnknownArgs(preprocessedArgs, command.argsSchema, flags, aliases, suggestSimilar);
   };
 
   /**
@@ -408,7 +418,7 @@ export function createPadroneBuilder<TBuilder extends PadroneProgram = PadronePr
       );
     };
 
-    return thenMaybe(parsedOrPromise, continueAfterParse) as any;
+    return makeThenable(thenMaybe(parsedOrPromise, continueAfterParse)) as any;
   };
 
   const stringify: AnyPadroneProgram['stringify'] = (command = '' as any, args) => {
@@ -1128,7 +1138,7 @@ export function createPadroneBuilder<TBuilder extends PadroneProgram = PadronePr
           });
         };
 
-        return warnIfUnexpectedAsync(thenMaybe(validatedOrPromise, continueAfterValidate), command) as any;
+        return thenMaybe(warnIfUnexpectedAsync(validatedOrPromise, command), continueAfterValidate) as any;
       };
 
       return thenMaybe(parsedOrPromise, continueAfterParse) as any;
@@ -1143,7 +1153,7 @@ export function createPadroneBuilder<TBuilder extends PadroneProgram = PadronePr
   };
 
   const evalCommand: AnyPadroneProgram['eval'] = (input, evalOptions) => {
-    return execCommand(input as string, evalOptions, 'soft');
+    return makeThenable(execCommand(input as string, evalOptions, 'soft'));
   };
 
   /**
@@ -1229,7 +1239,7 @@ export function createPadroneBuilder<TBuilder extends PadroneProgram = PadronePr
       updateCheckPromise.then((show) => show?.());
     }
 
-    return result;
+    return makeThenable(result);
   };
 
   const run: AnyPadroneProgram['run'] = (command, args) => {