padrone 1.8.2 → 2.0.0

package/dist/util/utils.mjs

@@ -0,0 +1,43 @@
+//#region src/util/utils.ts
+function getRootCommand(cmd) {
+	let current = cmd;
+	while (current.parent) current = current.parent;
+	return current;
+}
+async function readVersionFromPackageJson() {
+	try {
+		const fs = await import("node:fs");
+		const path = await import("node:path");
+		let dir = process.cwd();
+		for (let i = 0; i < 10; i++) {
+			const pkgPath = path.join(dir, "package.json");
+			if (fs.existsSync(pkgPath)) {
+				const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+				if (pkg.version) return pkg.version;
+			}
+			const parentDir = path.dirname(dir);
+			if (parentDir === dir) break;
+			dir = parentDir;
+		}
+	} catch {}
+	return "0.0.0";
+}
+/**
+* Attempts to get the version from various sources:
+* 1. Explicit version set on the command
+* 2. npm_package_version environment variable (set by npm/yarn/pnpm when running scripts)
+* 3. package.json in current or parent directories
+*
+* Returns synchronously when an explicit version or env var is available.
+* Falls back to async package.json discovery otherwise.
+*/
+function getVersion(explicitVersion) {
+	if (explicitVersion) return explicitVersion;
+	if (typeof process !== "undefined" && process.env?.npm_package_version) return process.env.npm_package_version;
+	if (typeof process !== "undefined") return readVersionFromPackageJson();
+	return "0.0.0";
+}
+//#endregion
+export { getRootCommand, getVersion };
+
+//# sourceMappingURL=utils.mjs.map

package/dist/util/utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","names":[],"sources":["../../src/util/utils.ts"],"sourcesContent":["import type { AnyPadroneCommand } from '../types/index.ts';\n\nexport function getRootCommand(cmd: AnyPadroneCommand): AnyPadroneCommand {\n  let current = cmd;\n  while (current.parent) current = current.parent;\n  return current;\n}\n\nasync function readVersionFromPackageJson(): Promise<string> {\n  try {\n    const fs = await import('node:fs');\n    const path = await import('node:path');\n    let dir = process.cwd();\n\n    // Walk up the directory tree looking for package.json\n    for (let i = 0; i < 10; i++) {\n      const pkgPath = path.join(dir, 'package.json');\n      if (fs.existsSync(pkgPath)) {\n        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));\n        if (pkg.version) return pkg.version;\n      }\n      const parentDir = path.dirname(dir);\n      if (parentDir === dir) break; // Reached root\n      dir = parentDir;\n    }\n  } catch {\n    // Ignore errors (e.g., fs not available in browser)\n  }\n  return '0.0.0';\n}\n\n/**\n * Attempts to get the version from various sources:\n * 1. Explicit version set on the command\n * 2. npm_package_version environment variable (set by npm/yarn/pnpm when running scripts)\n * 3. package.json in current or parent directories\n *\n * Returns synchronously when an explicit version or env var is available.\n * Falls back to async package.json discovery otherwise.\n */\nexport function getVersion(explicitVersion?: string): string | Promise<string> {\n  if (explicitVersion) return explicitVersion;\n\n  if (typeof process !== 'undefined' && process.env?.npm_package_version) {\n    return process.env.npm_package_version;\n  }\n\n  if (typeof process !== 'undefined') return readVersionFromPackageJson();\n\n  return '0.0.0';\n}\n"],"mappings":";AAEA,SAAgB,eAAe,KAA2C;CACxE,IAAI,UAAU;CACd,OAAO,QAAQ,QAAQ,UAAU,QAAQ;CACzC,OAAO;AACT;AAEA,eAAe,6BAA8C;CAC3D,IAAI;EACF,MAAM,KAAK,MAAM,OAAO;EACxB,MAAM,OAAO,MAAM,OAAO;EAC1B,IAAI,MAAM,QAAQ,IAAI;EAGtB,KAAK,IAAI,IAAI,GAAG,IAAI,IAAI,KAAK;GAC3B,MAAM,UAAU,KAAK,KAAK,KAAK,cAAc;GAC7C,IAAI,GAAG,WAAW,OAAO,GAAG;IAC1B,MAAM,MAAM,KAAK,MAAM,GAAG,aAAa,SAAS,OAAO,CAAC;IACxD,IAAI,IAAI,SAAS,OAAO,IAAI;GAC9B;GACA,MAAM,YAAY,KAAK,QAAQ,GAAG;GAClC,IAAI,cAAc,KAAK;GACvB,MAAM;EACR;CACF,QAAQ,CAER;CACA,OAAO;AACT;;;;;;;;;;AAWA,SAAgB,WAAW,iBAAoD;CAC7E,IAAI,iBAAiB,OAAO;CAE5B,IAAI,OAAO,YAAY,eAAe,QAAQ,KAAK,qBACjD,OAAO,QAAQ,IAAI;CAGrB,IAAI,OAAO,YAAY,aAAa,OAAO,2BAA2B;CAEtE,OAAO;AACT"}

package/dist/zod.d.mts

@@ -1,32 +1 @@
-import { ut as PadroneSchema } from "./index-D-Dpz7l_.mjs";
-import * as z from "zod/v4";
-
-//#region src/schema/zod.d.ts
-/**
- * Creates a Zod schema for an async stream field, ready to use in `.arguments()`.
- * Wraps `z.custom<AsyncIterable<T>>()` with the `asyncStream()` metadata automatically.
- *
- * @param itemSchema - Optional item schema for per-item validation.
- *
- * @example
- * ```ts
- * import { zodAsyncStream } from 'padrone/zod';
- *
- * // String lines
- * z.object({ lines: zodAsyncStream() })
- *
- * // Typed items — each line JSON.parse'd and validated
- * const recordSchema = z.object({ name: z.string(), age: z.number() });
- * z.object({ records: zodAsyncStream(jsonCodec(recordSchema)) })
- * ```
- */
-declare function zodAsyncStream<T = string>(itemSchema?: PadroneSchema<unknown, T>): z.ZodCustom<AsyncIterable<T>, AsyncIterable<T>>;
-/**
- * JSON codec for Zod schemas
- * @see https://zod.dev/codecs?id=jsonschema
- * Unlike the example in the docs, this codec also handles the case where the input is already an object
- */
-declare const jsonCodec: <T extends z.ZodType>(schema: T) => z.ZodCodec<z.ZodUnion<readonly [z.ZodString, z.ZodUnknown]>, T>;
-//#endregion
-export { jsonCodec, zodAsyncStream };
-//# sourceMappingURL=zod.d.mts.map
+export { };

package/dist/zod.mjs

@@ -1,50 +1,2 @@
-import { t as asyncStream } from "./stream-DC4H8YTx.mjs";
-import * as z from "zod/v4";
-//#region src/schema/zod.ts
-/**
-* Creates a Zod schema for an async stream field, ready to use in `.arguments()`.
-* Wraps `z.custom<AsyncIterable<T>>()` with the `asyncStream()` metadata automatically.
-*
-* @param itemSchema - Optional item schema for per-item validation.
-*
-* @example
-* ```ts
-* import { zodAsyncStream } from 'padrone/zod';
-*
-* // String lines
-* z.object({ lines: zodAsyncStream() })
-*
-* // Typed items — each line JSON.parse'd and validated
-* const recordSchema = z.object({ name: z.string(), age: z.number() });
-* z.object({ records: zodAsyncStream(jsonCodec(recordSchema)) })
-* ```
-*/
-function zodAsyncStream(itemSchema) {
-	return z.custom().meta(asyncStream(itemSchema));
-}
-/**
-* JSON codec for Zod schemas
-* @see https://zod.dev/codecs?id=jsonschema
-* Unlike the example in the docs, this codec also handles the case where the input is already an object
-*/
-const jsonCodec = (schema) => z.codec(z.union([z.string(), z.unknown()]), schema, {
-	decode: (jsonString, ctx) => {
-		try {
-			if (typeof jsonString !== "string") return jsonString;
-			return JSON.parse(jsonString);
-		} catch (err) {
-			ctx.issues.push({
-				code: "invalid_format",
-				format: "json",
-				input: typeof jsonString === "string" ? jsonString : JSON.stringify(jsonString),
-				message: err.message
-			});
-			return z.NEVER;
-		}
-	},
-	encode: (value) => JSON.stringify(value)
-});
-//#endregion
+import { jsonCodec, zodAsyncStream } from "./schema/zod.mjs";
 export { jsonCodec, zodAsyncStream };
-
-//# sourceMappingURL=zod.mjs.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "padrone",
-  "version": "1.8.2",
+  "version": "2.0.0",
   "description": "Create type-safe, interactive CLI apps with Zod schemas",
   "license": "MIT",
   "type": "module",
@@ -21,13 +21,13 @@
     "vercel-ai",
     "standard-schema"
   ],
-  "homepage": "https://github.com/KurtGokhan/padrone",
+  "homepage": "https://github.com/gkurt/padrone",
   "bugs": {
-    "url": "https://github.com/KurtGokhan/padrone/issues"
+    "url": "https://github.com/gkurt/padrone/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/KurtGokhan/padrone.git"
+    "url": "git+https://github.com/gkurt/padrone.git"
   },
   "author": {
     "name": "Gokhan Kurt",
@@ -68,16 +68,16 @@
     "./codegen": {
       "padrone@dev": "./src/codegen/index.ts",
       "import": {
-        "types": "./dist/codegen.d.mts",
-        "default": "./dist/codegen.mjs"
+        "types": "./dist/codegen/index.d.mts",
+        "default": "./dist/codegen/index.mjs"
       },
       "source": "./src/codegen/index.ts"
     },
     "./docs": {
       "padrone@dev": "./src/docs/index.ts",
       "import": {
-        "types": "./dist/docs.d.mts",
-        "default": "./dist/docs.mjs"
+        "types": "./dist/docs/index.d.mts",
+        "default": "./dist/docs/index.mjs"
       },
       "source": "./src/docs/index.ts"
     },
@@ -89,10 +89,58 @@
       },
       "source": "./src/zod.ts"
     },
+    "./ink": {
+      "padrone@dev": "./src/ink.ts",
+      "import": {
+        "types": "./dist/ink.d.mts",
+        "default": "./dist/ink.mjs"
+      },
+      "source": "./src/ink.ts"
+    },
+    "./mcp": {
+      "padrone@dev": "./src/mcp.ts",
+      "import": {
+        "types": "./dist/mcp.d.mts",
+        "default": "./dist/mcp.mjs"
+      },
+      "source": "./src/mcp.ts"
+    },
+    "./serve": {
+      "padrone@dev": "./src/serve.ts",
+      "import": {
+        "types": "./dist/serve.d.mts",
+        "default": "./dist/serve.mjs"
+      },
+      "source": "./src/serve.ts"
+    },
+    "./tracing": {
+      "padrone@dev": "./src/tracing.ts",
+      "import": {
+        "types": "./dist/tracing.d.mts",
+        "default": "./dist/tracing.mjs"
+      },
+      "source": "./src/tracing.ts"
+    },
+    "./completion": {
+      "padrone@dev": "./src/completion.ts",
+      "import": {
+        "types": "./dist/completion.d.mts",
+        "default": "./dist/completion.mjs"
+      },
+      "source": "./src/completion.ts"
+    },
+    "./man": {
+      "padrone@dev": "./src/man.ts",
+      "import": {
+        "types": "./dist/man.d.mts",
+        "default": "./dist/man.mjs"
+      },
+      "source": "./src/man.ts"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {
-    "build": "tsdown src/index.ts src/test.ts src/zod.ts src/codegen/index.ts src/docs/index.ts --dts --sourcemap",
+    "build": "tsdown src/index.ts src/test.ts src/zod.ts src/ink.ts src/mcp.ts src/serve.ts src/tracing.ts src/completion.ts src/man.ts src/codegen/index.ts src/docs/index.ts --dts --sourcemap --unbundle",
     "start": "bun --conditions=padrone@dev src/cli/index.ts",
     "dev": "bun --conditions=padrone@dev --watch src/cli/index.ts",
     "test": "bun test --conditions=padrone@dev",
@@ -105,16 +153,16 @@
     "enquirer": "^2.4.1"
   },
   "devDependencies": {
-    "@types/react": "^19.2.14",
-    "ai": "^6.0.146",
-    "ink": "^6.8.0",
-    "react": "^19.2.4",
-    "tsdown": "^0.21.7",
-    "zod": "^4.3.6"
+    "@types/react": "^19.2.17",
+    "ai": "^7.0.8",
+    "ink": "^7.1.0",
+    "react": "^19.2.7",
+    "tsdown": "^0.22.3",
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "ai": "5 || 6",
-    "ink": "^6.0.0",
+    "ai": "5 || 6 || 7",
+    "ink": "^6.0.0 || ^7.0.0",
     "react": ">=18.0.0",
     "zod": "^3.25.0 || ^4.0.0"
   },

package/src/completion.ts

@@ -0,0 +1,2 @@
+export type { WithCompletion } from './extension/completion.ts';
+export { padroneCompletion } from './extension/completion.ts';

package/src/core/args.ts

@@ -208,10 +208,58 @@ export function preprocessArgs(
   return result;
 }
 
+/**
+ * Walk a JSON schema fragment and collect the set of allowed primitive types,
+ * descending into `anyOf` / `oneOf` (used for unions). For variants whose type
+ * is `array`, item types are collected separately into `itemTypes`.
+ */
+function collectAllowedTypes(prop: Record<string, any> | undefined, types: Set<string>, itemTypes: Set<string>): void {
+  if (!prop) return;
+
+  if (prop.type !== undefined) {
+    const list = Array.isArray(prop.type) ? prop.type : [prop.type];
+    for (const t of list) {
+      if (typeof t === 'string') types.add(t);
+    }
+    if (list.includes('array') && prop.items) {
+      collectAllowedTypes(prop.items, itemTypes, new Set());
+    }
+  }
+
+  const variants = prop.anyOf ?? prop.oneOf;
+  if (Array.isArray(variants)) {
+    for (const variant of variants) collectAllowedTypes(variant, types, itemTypes);
+  }
+}
+
+/** Coerce a single CLI string to a primitive based on the set of allowed types. */
+function coerceScalar(value: unknown, allowedTypes: Set<string>): unknown {
+  if (typeof value !== 'string') return value;
+
+  if (allowedTypes.has('boolean')) {
+    const lower = value.toLowerCase();
+    if (lower === 'true' || lower === '1' || lower === 'yes' || lower === 'on') return true;
+    if (lower === 'false' || lower === '0' || lower === 'no' || lower === 'off') return false;
+  }
+
+  if (allowedTypes.has('number') || allowedTypes.has('integer')) {
+    const trimmed = value.trim();
+    if (trimmed !== '') {
+      const num = Number(trimmed);
+      if (!Number.isNaN(num)) return num;
+    }
+  }
+
+  return value;
+}
+
 /**
  * Auto-coerce CLI string values to match the expected schema types.
  * Handles: string → number, string → boolean for primitive schema fields.
  * Arrays of primitives are also coerced element-wise.
+ * Union types (`anyOf` / `oneOf`) are coerced to the most specific matching
+ * primitive — e.g. `--test true` for `z.union([z.boolean(), z.string()])`
+ * becomes the boolean `true` rather than the string "true".
  */
 export function coerceArgs(data: Record<string, unknown>, schema: StandardJSONSchemaV1): Record<string, unknown> {
   let properties: Record<string, any>;
@@ -229,43 +277,21 @@ export function coerceArgs(data: Record<string, unknown>, schema: StandardJSONSc
     const prop = properties[key];
     if (!prop) continue;
 
-    const targetType = prop.type as string | undefined;
-
-    if (targetType === 'number' || targetType === 'integer') {
-      if (typeof value === 'string') {
-        const num = Number(value);
-        if (!Number.isNaN(num)) result[key] = num;
-      }
-    } else if (targetType === 'boolean') {
-      if (typeof value === 'string') {
-        const lower = value.toLowerCase();
-        if (lower === 'true' || lower === '1' || lower === 'yes' || lower === 'on') result[key] = true;
-        else if (lower === 'false' || lower === '0' || lower === 'no' || lower === 'off') result[key] = false;
-      }
-    } 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] = arr.map((v) => {
-          if (typeof v === 'string') {
-            const num = Number(v);
-            return Number.isNaN(num) ? v : num;
-          }
-          return v;
-        });
-      } else if (itemType === 'boolean') {
-        result[key] = arr.map((v) => {
-          if (typeof v === 'string') {
-            const lower = v.toLowerCase();
-            if (lower === 'true' || lower === '1' || lower === 'yes' || lower === 'on') return true;
-            if (lower === 'false' || lower === '0' || lower === 'no' || lower === 'off') return false;
-          }
-          return v;
-        });
-      } else if (!Array.isArray(value)) {
-        result[key] = arr;
-      }
+    const types = new Set<string>();
+    const itemTypes = new Set<string>();
+    collectAllowedTypes(prop, types, itemTypes);
+
+    const isArrayValue = Array.isArray(value);
+    const allowsArray = types.has('array');
+    const allowsScalar = types.has('string') || types.has('boolean') || types.has('number') || types.has('integer');
+
+    if (isArrayValue && allowsArray) {
+      result[key] = value.map((v) => coerceScalar(v, itemTypes));
+    } else if (!isArrayValue && allowsArray && !allowsScalar) {
+      // Wrap single value into an array when only array shapes are allowed
+      result[key] = [coerceScalar(value, itemTypes)];
+    } else if (!isArrayValue) {
+      result[key] = coerceScalar(value, types);
     }
   }
 

package/src/core/runtime.ts

@@ -4,14 +4,14 @@ import type { HelpFormat } from '../output/formatter.ts';
 /** Process signals that Padrone can handle for graceful shutdown. */
 export type PadroneSignal = 'SIGINT' | 'SIGTERM' | 'SIGHUP';
 
-/** Value accepted by `PadroneProgressIndicator.update()`. */
+/** Value accepted by `PadroneProgress.update()`. */
 export type PadroneProgressUpdate = string | number | { message?: string; progress?: number; indeterminate?: boolean; time?: boolean };
 
 /**
  * A progress indicator instance (spinner, progress bar, etc).
  * Created by the runtime's `progress` factory and used to show loading state during command execution.
  */
-export type PadroneProgressIndicator = {
+export type PadroneProgress = {
   /**
    * Update the indicator.
    * - `string` — update the displayed message.
@@ -31,6 +31,15 @@ export type PadroneProgressIndicator = {
   succeed: (message?: string | null, options?: { indicator?: string }) => void;
   /** Mark as failed and stop. Pass `null` to stop without rendering a final message. */
   fail: (message?: string | null, options?: { indicator?: string }) => void;
+  /** Control ETA (estimated time remaining) display at runtime. */
+  eta: {
+    /** Enable ETA tracking. Starts collecting samples from subsequent `update()` calls. */
+    start: () => void;
+    /** Disable ETA display. */
+    stop: () => void;
+    /** Clear collected samples and restart estimation. Useful between operation phases. */
+    reset: () => void;
+  };
   /** Stop without success/fail status. */
   stop: () => void;
   /** Temporarily hide the indicator so other output can be written cleanly. */

package/src/extension/completion.ts

@@ -21,6 +21,9 @@ export type WithCompletion<T> = WithCommand<T, 'completion', CompletionCommand>;
  *
  * Usage:
  * ```ts
+ * import { createPadrone } from 'padrone';
+ * import { padroneCompletion } from 'padrone/completion';
+ *
  * createPadrone('my-cli').extend(padroneCompletion())
  * ```
  */

package/src/extension/index.ts

@@ -2,23 +2,15 @@ export type { WithAsync } from '../util/type-utils.ts';
 export type { PadroneAutoOutputOptions } from './auto-output.ts';
 export { padroneAutoOutput } from './auto-output.ts';
 export { padroneColor } from './color.ts';
-export type { WithCompletion } from './completion.ts';
-export { padroneCompletion } from './completion.ts';
 export type { PadroneConfigOptions } from './config.ts';
 export { padroneConfig } from './config.ts';
 export type { PadroneEnvOptions } from './env.ts';
 export { padroneEnv } from './env.ts';
 export type { HelpCommand, WithHelp } from './help.ts';
 export { padroneHelp } from './help.ts';
-export type { InkOptions } from './ink.ts';
-export { isReactElement, padroneInk } from './ink.ts';
 export { padroneInteractive } from './interactive.ts';
 export type { PadroneLogger, PadroneLoggerConfig, PadroneLogLevel, WithLogger } from './logger.ts';
 export { padroneLogger } from './logger.ts';
-export type { WithMan } from './man.ts';
-export { padroneMan } from './man.ts';
-export type { WithMcp } from './mcp.ts';
-export { padroneMcp } from './mcp.ts';
 export type {
   PadroneProgressConfig,
   PadroneProgressDefaults,
@@ -31,15 +23,11 @@ export type { PadroneProgressRenderer } from './progress-renderer.ts';
 export { createTerminalProgress } from './progress-renderer.ts';
 export type { WithRepl } from './repl.ts';
 export { padroneRepl } from './repl.ts';
-export type { WithServe } from './serve.ts';
-export { padroneServe } from './serve.ts';
 export { padroneSignalHandling } from './signal.ts';
 export { padroneStdin } from './stdin.ts';
 export { padroneSuggestions } from './suggestions.ts';
 export type { PadroneTimingOptions } from './timing.ts';
 export { padroneTiming } from './timing.ts';
-export type { OtelSpan, OtelTracer, OtelTracerProvider, PadroneTracer, PadroneTracingConfig, WithTracing } from './tracing.ts';
-export { padroneTracing } from './tracing.ts';
 export { padroneUpdateCheck } from './update-check.ts';
 export type { VersionCommand, WithVersion } from './version.ts';
 export { padroneVersion } from './version.ts';

package/src/extension/ink.ts

@@ -78,7 +78,8 @@ function createInkInterceptor(rawOptions?: InkOptions) {
  * Requires `ink` and `react` as peer dependencies.
  *
  * ```ts
- * import { createPadrone, padroneInk } from 'padrone';
+ * import { createPadrone } from 'padrone';
+ * import { padroneInk } from 'padrone/ink';
  *
  * const program = createPadrone('my-tui')
  *   .extend(padroneInk())

package/src/extension/man.ts

@@ -20,6 +20,9 @@ export type WithMan<T> = WithCommand<T, 'man', ManCommand>;
  *
  * Usage:
  * ```ts
+ * import { createPadrone } from 'padrone';
+ * import { padroneMan } from 'padrone/man';
+ *
  * createPadrone('my-cli').extend(padroneMan())
  * ```
  */

package/src/extension/mcp.ts

@@ -21,6 +21,9 @@ export type WithMcp<T> = WithCommand<T, 'mcp', McpCommand>;
  *
  * Usage:
  * ```ts
+ * import { createPadrone } from 'padrone';
+ * import { padroneMcp } from 'padrone/mcp';
+ *
  * createPadrone('my-cli').extend(padroneMcp())
  * ```
  */

package/src/extension/progress-renderer.ts

@@ -1,6 +1,6 @@
 import type {
   PadroneBarConfig,
-  PadroneProgressIndicator,
+  PadroneProgress,
   PadroneProgressOptions,
   PadroneProgressShow,
   PadroneProgressUpdate,
@@ -134,8 +134,8 @@ function estimateEta(samples: { time: number; progress: number }[]): number | un
 // Factory type
 // ---------------------------------------------------------------------------
 
-/** Factory function that creates a `PadroneProgressIndicator`. */
-export type PadroneProgressRenderer = (message: string, options?: PadroneProgressOptions) => PadroneProgressIndicator;
+/** Factory function that creates a `PadroneProgress`. */
+export type PadroneProgressRenderer = (message: string, options?: PadroneProgressOptions) => PadroneProgress;
 
 // ---------------------------------------------------------------------------
 // Default terminal renderer
@@ -145,7 +145,7 @@ export type PadroneProgressRenderer = (message: string, options?: PadroneProgres
  * Creates a terminal progress indicator (spinner, bar, or both).
  * Returns a no-op indicator in non-TTY/CI environments.
  */
-export function createTerminalProgress(message: string, options?: PadroneProgressOptions): PadroneProgressIndicator {
+export function createTerminalProgress(message: string, options?: PadroneProgressOptions): PadroneProgress {
   const spinnerCfg = resolveSpinnerConfig(options?.spinner);
   const successIcon = options?.successIndicator ?? '✔';
   const errorIcon = options?.errorIndicator ?? '✖';
@@ -154,8 +154,10 @@ export function createTerminalProgress(message: string, options?: PadroneProgres
   const formatFinal = (icon: string, msg: string) => (icon ? `${icon} ${msg}\n` : `${msg}\n`);
 
   if (typeof process === 'undefined' || !process.stderr?.isTTY) {
+    const noopEta = { start() {}, stop() {}, reset() {} };
     return {
       update() {},
+      eta: noopEta,
       succeed(msg, opts) {
         if (msg === null) return;
         const icon = opts?.indicator ?? successIcon;
@@ -176,11 +178,11 @@ export function createTerminalProgress(message: string, options?: PadroneProgres
   const ansiPattern = /\x1b\[[0-9;]*m/g;
 
   if (spinnerCfg.show === 'never' && (!barCfg || barCfg.show === 'never') && !message) {
-    return { update() {}, succeed() {}, fail() {}, stop() {}, pause() {}, resume() {} };
+    return { update() {}, eta: { start() {}, stop() {}, reset() {} }, succeed() {}, fail() {}, stop() {}, pause() {}, resume() {} };
   }
 
   const showTime = options?.time ?? false;
-  const showEta = options?.eta ?? false;
+  let etaEnabled = options?.eta ?? false;
 
   let spinnerFrame = 0;
   let barFrame = 0;
@@ -224,7 +226,7 @@ export function createTerminalProgress(message: string, options?: PadroneProgres
 
     let line = '';
     if (barVisible) line += formatBar(progress, barCfg!, barFrame);
-    const hasEta = showEta && progress !== undefined && progress < 1 && etaMs !== undefined;
+    const hasEta = etaEnabled && progress !== undefined && progress < 1 && etaMs !== undefined;
     if (timeEnabled || hasEta) {
       const parts: string[] = [];
       if (timeEnabled) parts.push(`⏱ ${formatDuration(Date.now() - startTime)}`);
@@ -278,6 +280,27 @@ export function createTerminalProgress(message: string, options?: PadroneProgres
     clearLines();
   };
 
+  const eta = {
+    start() {
+      if (stopped) return;
+      etaEnabled = true;
+      render();
+    },
+    stop() {
+      if (stopped) return;
+      etaEnabled = false;
+      etaMs = undefined;
+      render();
+    },
+    reset() {
+      if (stopped) return;
+      etaSamples.length = 0;
+      etaMs = undefined;
+      etaCalculatedAt = 0;
+      render();
+    },
+  };
+
   return {
     update(value) {
       if (stopped) return;
@@ -285,7 +308,7 @@ export function createTerminalProgress(message: string, options?: PadroneProgres
       if (parsed.message !== undefined) text = parsed.message;
       if (parsed.progress !== undefined) {
         progress = parsed.progress;
-        if (showEta) {
+        if (etaEnabled) {
           const now = Date.now();
           etaSamples.push({ time: now, progress: parsed.progress });
           const estimated = estimateEta(etaSamples);
@@ -309,6 +332,7 @@ export function createTerminalProgress(message: string, options?: PadroneProgres
       }
       render();
     },
+    eta,
     succeed(msg, opts) {
       clear();
       if (msg === null) return;