padrone 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# padrone
+
+## 1.0.0
+
+Initial stable release of Padrone - a TypeScript CLI framework with Zod schema support.
+
+### Features
+
+- Type-safe argument and option parsing with Zod schemas
+- Interactive prompts with validation
+- AI integration support via Vercel AI SDK
+- Standard Schema compatibility
+- Terminal UI components
+- Command builder pattern

package/README.md

@@ -51,7 +51,7 @@ import * as z from 'zod/v4';
 const program = createPadrone('myapp')
   .command('greet', (c) =>
     c
-      .options(
+      .arguments(
         z.object({
           names: z.array(z.string()).describe('Names to greet'),
           prefix: z
@@ -120,7 +120,7 @@ api.greet({ names: ['Alice', 'Bob'], prefix: 'Dr.' });
 const program = createPadrone('weather')
   .command('forecast', (c) =>
     c
-      .options(
+      .arguments(
         z.object({
           city: z.string().describe('City name'),
           days: z.number().optional().default(3).describe('Number of days'),
@@ -132,7 +132,7 @@ const program = createPadrone('weather')
       })
       .command('extended', (c) =>
         c
-          .options(
+          .arguments(
             z.object({
               city: z.string().describe('City name'),
             }),
@@ -154,7 +154,7 @@ program.cli('forecast extended London');
 const program = createPadrone('app')
   .command('serve', (c) =>
     c
-      .options(
+      .arguments(
         z.object({
           port: z
             .number()
@@ -181,26 +181,37 @@ const program = createPadrone('app')
 
 ### Environment Variables and Config Files
 
-Padrone supports binding options to environment variables and config files:
+Padrone supports loading options from environment variables and config files using dedicated schema methods:
 
 ```typescript
 const program = createPadrone('app')
-  .configure({
-    configFiles: ['app.config.json', '.apprc'],
-  })
   .command('serve', (c) =>
     c
-      .options(
+      .arguments(
         z.object({
           port: z.number().default(3000).describe('Port to listen on'),
           apiKey: z.string().describe('API key for authentication'),
         }),
-        {
-          options: {
-            port: { env: 'APP_PORT', configKey: 'server.port' },
-            apiKey: { env: ['API_KEY', 'APP_API_KEY'] },
-          },
-        },
+      )
+      // Map environment variables to options
+      .env(
+        z
+          .object({
+            APP_PORT: z.coerce.number().optional(),
+            API_KEY: z.string().optional(),
+          })
+          .transform((env) => ({
+            port: env.APP_PORT,
+            apiKey: env.API_KEY,
+          })),
+      )
+      // Load config from JSON file with matching schema
+      .configFile(
+        'app.config.json',
+        z.object({
+          port: z.number().optional(),
+          apiKey: z.string().optional(),
+        }),
       )
       .action((options) => {
         console.log(`Server running on port ${options.port}`);
@@ -208,6 +219,8 @@ const program = createPadrone('app')
   );
 ```
 
+**Precedence order** (highest to lowest): CLI args > environment variables > config file
+
 ## 🤖 AI SDK Integration
 
 Padrone provides first-class support for the [Vercel AI SDK](https://ai-sdk.dev/), making it easy to expose your CLI as an AI tool:
@@ -220,7 +233,7 @@ import * as z from 'zod/v4';
 const weatherCli = createPadrone('weather')
   .command('current', (c) =>
     c
-      .options(
+      .arguments(
         z.object({
           city: z.string().describe('City name'),
         }),
@@ -271,9 +284,11 @@ Creates a new CLI program with the given name.
 
 | Method | Description |
 |--------|-------------|
-| `.configure(config)` | Configure program properties (title, description, version, configFiles) |
+| `.configure(config)` | Configure program properties (title, description, version) |
 | `.command(name, builder)` | Add a command to the program |
-| `.options(schema, meta?)` | Define options schema with optional positional args |
+| `.arguments(schema, meta?)` | Define options schema with optional positional args |
+| `.env(schema)` | Define schema for parsing environment variables into options |
+| `.configFile(file, schema?)` | Configure config file path(s) and schema |
 | `.action(handler)` | Set the command handler function |
 | `.cli(input?)` | Run as CLI (parses `process.argv` or input string) |
 | `.run(command, options)` | Run a command programmatically |
@@ -286,14 +301,14 @@ Creates a new CLI program with the given name.
 
 ### Options Meta
 
-Use the second argument of `.options()` to configure positional arguments and per-option metadata:
+Use the second argument of `.arguments()` to configure positional arguments and per-option metadata:
 
 ```typescript
-.options(schema, {
+.arguments(schema, {
   positional: ['source', '...files', 'dest'],  // '...files' is variadic
   options: {
-    verbose: { alias: 'v', env: 'VERBOSE' },
-    config: { configKey: 'settings.config' },
+    verbose: { alias: 'v' },
+    format: { deprecated: 'Use --output instead' },
   },
 })
 ```
@@ -308,8 +323,6 @@ z.string().meta({
   examples: ['value'],   // Example values for help text
   deprecated: 'message', // Mark as deprecated
   hidden: true,          // Hide from help output
-  env: 'MY_VAR',         // Bind to environment variable
-  configKey: 'path.key', // Bind to config file key
 })
 ```
 

package/dist/index.d.mts

@@ -89,7 +89,7 @@ type PositionalArgs<TObj> = TObj extends Record<string, any> ? { [K in keyof TOb
  *
  * @example
  * ```ts
- * .options(schema, {
+ * .arguments(schema, {
  *   positional: ['source', '...files', 'dest'],  // '...files' is variadic
  * })
  * ```
@@ -154,6 +154,59 @@ type CommandIsUnknownable<TCommand> = IsGeneric<TCommand> extends true ? true :
  */
 type PickCommandByPossibleCommands<TCommands extends AnyPadroneCommand[], TCommand extends PossibleCommands<TCommands, true, true> | SafeString> = CommandIsUnknownable<TCommand> extends true ? FlattenCommands<TCommands> : TCommand extends AnyPadroneCommand ? TCommand : TCommand extends string ? TCommand extends GetCommandPathsOrAliases<TCommands> ? PickCommandByName<TCommands, TCommand> : SplitLastSpace<TCommand> extends [infer Prefix extends string, infer Rest] ? IsNever<Rest> extends true ? PickCommandByName<TCommands, Prefix> : PickCommandByPossibleCommands<TCommands, Prefix> : never : never;
 //#endregion
+//#region src/wrap.d.ts
+/**
+ * Configuration options for wrapping an external CLI tool.
+ */
+type WrapConfig<TCommandOpts extends PadroneSchema = PadroneSchema, TWrapOpts extends PadroneSchema = TCommandOpts> = {
+  /**
+   * The command to execute (e.g., 'git', 'docker', 'npm').
+   */
+  command: string;
+  /**
+   * Optional fixed arguments that always precede the options (e.g., ['commit'] for 'git commit').
+   */
+  args?: string[];
+  /**
+   * Positional argument configuration for the external command.
+   * If not provided, defaults to the wrapping command's positional configuration.
+   */
+  positional?: string[];
+  /**
+   * Whether to inherit stdio streams (stdin, stdout, stderr) from the parent process.
+   * Default: true
+   */
+  inheritStdio?: boolean;
+  /**
+   * Optional schema that transforms command options to external CLI arguments.
+   * The schema's input type should match the command options, and its output type defines
+   * the arguments expected by the external command.
+   * If not provided, command options are passed through as-is.
+   */
+  schema?: TWrapOpts | ((commandOptions: TCommandOpts) => TWrapOpts);
+};
+/**
+ * Result from executing a wrapped CLI tool.
+ */
+type WrapResult = {
+  /**
+   * The exit code of the process.
+   */
+  exitCode: number;
+  /**
+   * Standard output from the process (only if inheritStdio is false).
+   */
+  stdout?: string;
+  /**
+   * Standard error from the process (only if inheritStdio is false).
+   */
+  stderr?: string;
+  /**
+   * Whether the process exited successfully (exit code 0).
+   */
+  success: boolean;
+};
+//#endregion
 //#region src/types.d.ts
 type UnknownRecord = Record<string, unknown>;
 type EmptyRecord = Record<string, never>;
@@ -253,7 +306,7 @@ type PadroneBuilderMethods<TProgramName extends string, TName extends string, TP
    * @example
    * ```ts
    * // Direct schema
-   * .options(z.object({
+   * .arguments(z.object({
    *   source: z.string(),
    *   files: z.string().array(),
    *   dest: z.string(),
@@ -266,7 +319,7 @@ type PadroneBuilderMethods<TProgramName extends string, TName extends string, TP
    * @example
    * ```ts
    * // Function-based schema extending parent options
-   * .options((parentOpts) => {
+   * .arguments((parentOpts) => {
    *   return z.object({
    *     ...parentOpts.shape,
    *     verbose: z.boolean().default(false),
@@ -274,7 +327,7 @@ type PadroneBuilderMethods<TProgramName extends string, TName extends string, TP
    * })
    * ```
    */
-  options: <TNewOpts extends PadroneSchema = PadroneSchema<void>>(options?: TNewOpts | ((parentOptions: TParentOpts) => TNewOpts), meta?: GetMeta<TNewOpts>) => BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TNewOpts, TRes, TCommands, TParentOpts, TConfig, TEnv>;
+  arguments: <TNewOpts extends PadroneSchema = PadroneSchema<void>>(options?: TNewOpts | ((parentOptions: TParentOpts) => TNewOpts), meta?: GetMeta<TNewOpts>) => BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TNewOpts, TRes, TCommands, TParentOpts, TConfig, TEnv>;
   /**
    * Configures config file path(s) and schema for parsing config files.
    * @example
@@ -297,6 +350,63 @@ type PadroneBuilderMethods<TProgramName extends string, TName extends string, TP
    * Defines the handler function to be executed when the command is run.
    */
   action: <TNewRes>(handler?: (options: StandardSchemaV1.InferOutput<TOpts>) => TNewRes) => BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TOpts, TNewRes, TCommands, TParentOpts, TConfig, TEnv>;
+  /**
+   * Wraps an external CLI tool with optional schema transformation.
+   * The config can include a schema that transforms command options to external CLI arguments.
+   *
+   * @example
+   * ```ts
+   * // No transformation - pass options as-is
+   * .arguments(z.object({
+   *   message: z.string(),
+   * }))
+   * .wrap({
+   *   command: 'echo',
+   * })
+   * ```
+   *
+   * @example
+   * ```ts
+   * // With transformation schema
+   * .arguments(z.object({
+   *   message: z.string(),
+   *   all: z.boolean().optional(),
+   * }), {
+   *   positional: ['message'],
+   * })
+   * .wrap({
+   *   command: 'git',
+   *   args: ['commit'],
+   *   positional: ['m'],
+   *   schema: z.object({
+   *     message: z.string(),
+   *     all: z.boolean().optional(),
+   *   }).transform(opts => ({
+   *     m: opts.message,
+   *     a: opts.all,
+   *   })),
+   * })
+   * ```
+   *
+   * @example
+   * ```ts
+   * // Using function-based schema for type inference
+   * .arguments(z.object({
+   *   image: z.string(),
+   *   detach: z.boolean().optional(),
+   * }))
+   * .wrap({
+   *   command: 'docker',
+   *   args: ['run'],
+   *   positional: ['image'],
+   *   schema: (cmdOpts) => cmdOpts.transform(opts => ({
+   *     d: opts.detach,
+   *     image: opts.image,
+   *   })),
+   * })
+   * ```
+   */
+  wrap: <TWrapOpts extends PadroneSchema = TOpts>(config: WrapConfig<TOpts, TWrapOpts>) => BuilderOrProgram<TReturn, TProgramName, TName, TParentName, TOpts, Promise<WrapResult>, TCommands, TParentOpts, TConfig, TEnv>;
   /**
    * Creates a nested command within the current command with the given name and builder function.
    * The name can be a single string or a tuple of [name, ...aliases] where additional strings are aliases.
@@ -478,8 +588,8 @@ type InferEnvOutput<T extends AnyPadroneCommand> = T['envSchema'] extends Padron
  * ```ts
  * const program = createPadrone('cli')
  *   .command('config', c => c
- *     .command('set', c => c.options(...).action(...))
- *     .command('get', c => c.options(...).action(...))
+ *     .command('set', c => c.arguments(...).action(...))
+ *     .command('get', c => c.arguments(...).action(...))
  *   );
  *
  * type SetCommand = InferCommand<typeof program, 'config set'>;
@@ -488,5 +598,5 @@ type InferEnvOutput<T extends AnyPadroneCommand> = T['envSchema'] extends Padron
  */
 type InferCommand<T extends AnyPadroneCommand | AnyPadroneProgram, TPath extends PossibleCommands<T extends AnyPadroneCommand ? [T] : T['~types']['commands'], true, true>> = T extends AnyPadroneProgram ? PickCommandByName<[PadroneCommand<'', '', any, any, T['~types']['commands']>], TPath> : T extends AnyPadroneCommand ? PickCommandByName<[T], TPath> : never;
 //#endregion
-export { type AnyPadroneCommand, type AnyPadroneProgram, type HelpArgumentInfo, type HelpFormat, type HelpInfo, type HelpOptionInfo, type HelpOptions, type HelpSubcommandInfo, type InferCommand, type InferConfigInput, type InferConfigOutput, type InferEnvInput, type InferEnvOutput, type InferOptionsInput, type InferOptionsOutput, type PadroneBuilder, type PadroneCommand, type PadroneCommandConfig, type PadroneCommandResult, type PadroneOptionsMeta, type PadroneParseOptions, type PadroneParseResult, type PadroneProgram, type PadroneSchema, createPadrone };
+export { type AnyPadroneCommand, type AnyPadroneProgram, type HelpArgumentInfo, type HelpFormat, type HelpInfo, type HelpOptionInfo, type HelpOptions, type HelpSubcommandInfo, type InferCommand, type InferConfigInput, type InferConfigOutput, type InferEnvInput, type InferEnvOutput, type InferOptionsInput, type InferOptionsOutput, type PadroneBuilder, type PadroneCommand, type PadroneCommandConfig, type PadroneCommandResult, type PadroneOptionsMeta, type PadroneParseOptions, type PadroneParseResult, type PadroneProgram, type PadroneSchema, type WrapConfig, type WrapResult, createPadrone };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/formatter.ts","../src/help.ts","../src/options.ts","../src/type-utils.ts","../src/types.ts","../src/create.ts","../src/type-helpers.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/formatter.ts","../src/help.ts","../src/options.ts","../src/type-utils.ts","../src/wrap.ts","../src/types.ts","../src/create.ts","../src/type-helpers.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -1147,6 +1147,80 @@ function parseArrayItems(input) {
 	return items;
 }
 
+//#endregion
+//#region src/wrap.ts
+/**
+* Converts parsed options to CLI arguments for an external command.
+*/
+function optionsToArgs(options, positional = []) {
+	const args = [];
+	if (!options) return args;
+	const positionalValues = {};
+	const regularOptions = {};
+	for (const [key, value] of Object.entries(options)) if (positional.includes(key) || positional.includes(`...${key}`)) positionalValues[key] = value;
+	else regularOptions[key] = value;
+	for (const [key, value] of Object.entries(regularOptions)) {
+		if (value === void 0 || value === null) continue;
+		const flag = `--${key}`;
+		if (typeof value === "boolean") {
+			if (value) args.push(flag);
+		} else if (Array.isArray(value)) for (const item of value) args.push(flag, String(item));
+		else args.push(flag, String(value));
+	}
+	for (const posKey of positional) {
+		const isVariadic = posKey.startsWith("...");
+		const value = positionalValues[isVariadic ? posKey.slice(3) : posKey];
+		if (value === void 0 || value === null) continue;
+		if (isVariadic && Array.isArray(value)) args.push(...value.map(String));
+		else args.push(String(value));
+	}
+	return args;
+}
+/**
+* Creates an action handler that wraps an external CLI tool.
+* @param config - Configuration for wrapping the external command (includes optional schema)
+* @param commandOptions - The command's options schema
+* @param commandPositional - Default positional config from the wrapping command
+*/
+function createWrapHandler(config, commandOptions, commandPositional) {
+	return async (options) => {
+		const { command, args: fixedArgs = [], inheritStdio = true, positional = commandPositional, schema: wrapSchema } = config;
+		const result = (wrapSchema ? typeof wrapSchema === "function" ? wrapSchema(commandOptions) : wrapSchema : commandOptions)["~standard"].validate(options);
+		if (result instanceof Promise) throw new Error("Async validation is not supported. Wrap schema validate() must return a synchronous result.");
+		if (result.issues) {
+			const issueMessages = result.issues.map((i) => `  - ${i.path?.join(".") || "root"}: ${i.message}`).join("\n");
+			throw new Error(`Wrap schema validation failed:\n${issueMessages}`);
+		}
+		const externalOptions = result.value;
+		const optionArgs = optionsToArgs(externalOptions, positional);
+		const allArgs = [...fixedArgs, ...optionArgs];
+		const proc = Bun.spawn([command, ...allArgs], {
+			stdout: inheritStdio ? "inherit" : "pipe",
+			stderr: inheritStdio ? "inherit" : "pipe",
+			stdin: inheritStdio ? "inherit" : "ignore"
+		});
+		const exitCode = await proc.exited;
+		let stdout;
+		let stderr;
+		if (!inheritStdio) {
+			if (proc.stdout) {
+				const stdoutBuffer = await new Response(proc.stdout).arrayBuffer();
+				stdout = new TextDecoder().decode(stdoutBuffer);
+			}
+			if (proc.stderr) {
+				const stderrBuffer = await new Response(proc.stderr).arrayBuffer();
+				stderr = new TextDecoder().decode(stderrBuffer);
+			}
+		}
+		return {
+			exitCode,
+			stdout,
+			stderr,
+			success: exitCode === 0
+		};
+	};
+}
+
 //#endregion
 //#region src/create.ts
 const commandSymbol = Symbol("padrone_command");
@@ -1519,6 +1593,21 @@ function createPadroneBuilder(existingCommand) {
 			envData,
 			configData
 		});
+		if (optionsResult?.issues) {
+			const issueMessages = optionsResult.issues.map((i) => `  - ${i.path?.join(".") || "root"}: ${i.message}`).join("\n");
+			if (input === void 0) {
+				const helpText = generateHelp(existingCommand, command, { format: "text" });
+				console.error(`Validation error:\n${issueMessages}`);
+				console.error(helpText);
+				throw new Error(`Validation error:\n${issueMessages}`);
+			}
+			return {
+				command,
+				options: void 0,
+				optionsResult,
+				result: void 0
+			};
+		}
 		return {
 			...run(command, options),
 			optionsResult
@@ -1589,7 +1678,7 @@ ${generateHelp(existingCommand, void 0, {
 				...config
 			});
 		},
-		options(options, meta) {
+		arguments(options, meta) {
 			const resolvedOptions = typeof options === "function" ? options(existingCommand.options) : options;
 			return createPadroneBuilder({
 				...existingCommand,
@@ -1619,6 +1708,13 @@ ${generateHelp(existingCommand, void 0, {
 				handler
 			});
 		},
+		wrap(config) {
+			const handler = createWrapHandler(config, existingCommand.options, existingCommand.meta?.positional);
+			return createPadroneBuilder({
+				...existingCommand,
+				handler
+			});
+		},
 		command(nameOrNames, builderFn) {
 			const name = Array.isArray(nameOrNames) ? nameOrNames[0] : nameOrNames;
 			const aliases = Array.isArray(nameOrNames) && nameOrNames.length > 1 ? nameOrNames.slice(1) : void 0;