padrone 1.8.2 → 2.0.0

package/dist/extension/progress.mjs

@@ -0,0 +1,225 @@
+import { defineInterceptor } from "../core/interceptors.mjs";
+import { createTerminalProgress } from "./progress-renderer.mjs";
+//#region src/extension/progress.ts
+const noopIndicator = {
+	update() {},
+	eta: {
+		start() {},
+		stop() {},
+		reset() {}
+	},
+	succeed() {},
+	fail() {},
+	stop() {},
+	pause() {},
+	resume() {}
+};
+function resolveMessage(field, value, fallback) {
+	const raw = typeof field === "function" ? field(value) : field;
+	if (raw === void 0) return { message: fallback };
+	if (raw === null || typeof raw === "string") return { message: raw };
+	if (typeof raw === "object" && raw !== null) {
+		const obj = raw;
+		return {
+			message: obj.message,
+			indicator: obj.indicator
+		};
+	}
+	return { message: fallback };
+}
+function cleanup(indicator, successConfig, errorConfig, error, result, isError) {
+	if (isError) {
+		const { message: errorMsg, indicator: errorIcon } = resolveMessage(errorConfig, error, error instanceof Error ? error.message : String(error));
+		indicator.fail(errorMsg, errorIcon !== void 0 ? { indicator: errorIcon } : void 0);
+	} else {
+		const { message: successMsg, indicator: successIcon } = resolveMessage(successConfig, result);
+		indicator.succeed(successMsg, successIcon !== void 0 ? { indicator: successIcon } : void 0);
+	}
+}
+function resolveMessages(raw) {
+	if (!raw || typeof raw === "string") return {
+		progress: raw || "Working...",
+		validation: "",
+		success: void 0,
+		error: void 0
+	};
+	return {
+		progress: raw.progress ?? "Working...",
+		validation: raw.validation ?? "",
+		success: raw.success,
+		error: raw.error
+	};
+}
+function mergeMessages(cmd, ctx, cmdRaw) {
+	if (typeof cmdRaw === "string") return cmd;
+	const obj = typeof cmdRaw === "object" ? cmdRaw : void 0;
+	return {
+		progress: obj?.progress !== void 0 ? cmd.progress : ctx.progress ?? cmd.progress,
+		validation: obj?.validation !== void 0 ? cmd.validation : ctx.validation || cmd.validation,
+		success: obj?.success !== void 0 ? cmd.success : ctx.success ?? cmd.success,
+		error: obj?.error !== void 0 ? cmd.error : ctx.error ?? cmd.error
+	};
+}
+function progressInterceptor(config) {
+	const isObj = typeof config === "object";
+	const rawMessage = typeof config === "string" ? config : isObj ? config.message : void 0;
+	const rawSpinner = isObj ? config.spinner : void 0;
+	const rawBar = isObj ? config.bar : void 0;
+	const rawRenderer = isObj ? config.renderer : void 0;
+	const rawTime = isObj ? config.time : void 0;
+	const rawEta = isObj ? config.eta : void 0;
+	const rawSilent = isObj ? config.silent : void 0;
+	return defineInterceptor({
+		id: "padrone:progress",
+		name: "padrone:progress"
+	}).requires().factory(() => {
+		let indicator;
+		let restoreOutput;
+		let resolvedRenderer;
+		let resolvedOptions;
+		let resolvedSilent = false;
+		let msgs;
+		function resolve(ctx) {
+			if (resolvedRenderer) return;
+			const ctxCfg = ctx.context?.progressConfig;
+			resolvedSilent = rawSilent ?? ctxCfg?.silent ?? false;
+			const spinner = rawSpinner ?? ctxCfg?.spinner;
+			const bar = rawBar ?? ctxCfg?.bar;
+			const time = rawTime ?? ctxCfg?.time;
+			const eta = rawEta ?? ctxCfg?.eta;
+			resolvedRenderer = rawRenderer ?? ctxCfg?.renderer ?? createTerminalProgress;
+			resolvedOptions = spinner !== void 0 || bar !== void 0 || time !== void 0 || eta !== void 0 ? {
+				spinner,
+				bar,
+				time,
+				eta
+			} : void 0;
+			msgs = mergeMessages(resolveMessages(rawMessage), resolveMessages(ctxCfg?.message), rawMessage);
+		}
+		const teardown = () => {
+			restoreOutput?.();
+			indicator = void 0;
+			restoreOutput = void 0;
+		};
+		return {
+			validate(ctx, next) {
+				resolve(ctx);
+				if (resolvedSilent) return next();
+				indicator = resolvedRenderer(msgs.validation || msgs.progress, resolvedOptions);
+				const originalOutput = ctx.runtime.output;
+				const originalError = ctx.runtime.error;
+				ctx.runtime.output = (...args) => {
+					indicator.pause();
+					originalOutput(...args);
+					indicator.resume();
+				};
+				ctx.runtime.error = (text) => {
+					indicator.pause();
+					originalError(text);
+					indicator.resume();
+				};
+				restoreOutput = () => {
+					ctx.runtime.output = originalOutput;
+					ctx.runtime.error = originalError;
+				};
+				const onValidationFailure = (error) => {
+					if (indicator) {
+						cleanup(indicator, msgs.success, msgs.error, error, void 0, true);
+						teardown();
+					}
+				};
+				const checkResult = (result) => {
+					if (result.argsResult?.issues) onValidationFailure(/* @__PURE__ */ new Error("Validation failed"));
+					return result;
+				};
+				let result;
+				try {
+					result = next();
+				} catch (err) {
+					onValidationFailure(err);
+					throw err;
+				}
+				if (result instanceof Promise) return result.then(checkResult, (err) => {
+					onValidationFailure(err);
+					throw err;
+				});
+				return checkResult(result);
+			},
+			execute(_ctx, next) {
+				if (resolvedSilent) return next({ context: { progress: noopIndicator } });
+				if (indicator && msgs.validation) indicator.update(msgs.progress);
+				const effectiveIndicator = indicator ?? noopIndicator;
+				const onSuccess = (value) => {
+					cleanup(effectiveIndicator, msgs.success, msgs.error, void 0, value, false);
+					teardown();
+				};
+				const onError = (err) => {
+					if (indicator) {
+						cleanup(indicator, msgs.success, msgs.error, err, void 0, true);
+						teardown();
+					}
+					throw err;
+				};
+				let result;
+				try {
+					result = next({ context: { progress: effectiveIndicator } });
+				} catch (err) {
+					onError(err);
+				}
+				if (result instanceof Promise) return result.then((r) => {
+					if (r.result instanceof Promise) return { result: r.result.then((value) => {
+						onSuccess(value);
+						return value;
+					}, (err) => onError(err)) };
+					onSuccess(r.result);
+					return r;
+				}, (err) => onError(err));
+				if (result.result instanceof Promise) return { result: result.result.then((value) => {
+					onSuccess(value);
+					return value;
+				}, (err) => onError(err)) };
+				onSuccess(result.result);
+				return result;
+			},
+			shutdown(ctx) {
+				if (indicator) {
+					cleanup(indicator, msgs.success, msgs.error, ctx.error, ctx.result, !!ctx.error);
+					teardown();
+				}
+			}
+		};
+	}).provides();
+}
+/**
+* Extension that adds an auto-managed progress indicator to the command pipeline.
+*
+* - `string` — a single message used for all states.
+* - `PadroneProgressConfig` — separate messages for validation, progress, success, and error.
+*
+* The indicator is automatically started before validation, updated at each phase transition,
+* and stopped on success (`.succeed()`) or failure (`.fail()`).
+*
+* Provides `{ progress: PadroneProgress }` on the command context.
+* Access it in action handlers as `ctx.context.progress`.
+*
+* Uses the built-in terminal renderer by default. Pass a custom `renderer` for non-terminal
+* environments (web UIs, testing, etc).
+*
+* Usage:
+* ```ts
+* createPadrone('my-cli')
+*   .command('sync', (c) =>
+*     c.extend(padroneProgress('Syncing...'))
+*       .action((_args, ctx) => {
+*         ctx.context.progress.update('halfway');
+*       })
+*   )
+* ```
+*/
+function padroneProgress(config) {
+	return ((builder) => builder.intercept(progressInterceptor(config ?? "Working...")));
+}
+//#endregion
+export { padroneProgress };
+
+//# sourceMappingURL=progress.mjs.map

package/dist/extension/progress.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.mjs","names":[],"sources":["../../src/extension/progress.ts"],"sourcesContent":["import { defineInterceptor } from '../core/interceptors.ts';\nimport type { PadroneBarConfig, PadroneProgress, PadroneProgressOptions, PadroneSpinnerConfig } from '../core/runtime.ts';\nimport type { AnyPadroneBuilder, CommandTypesBase } from '../types/index.ts';\nimport type { WithInterceptor } from '../util/type-utils.ts';\nimport type { PadroneProgressRenderer } from './progress-renderer.ts';\nimport { createTerminalProgress } from './progress-renderer.ts';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\n/** A progress message value: a plain string, `null` to suppress, or an object with a message and custom indicator icon. */\nexport type PadroneProgressMessage = string | null | { message?: string | null; indicator?: string };\n\n/** Per-phase message configuration for progress indicators. */\nexport type PadroneProgressMessages<TRes = unknown> = {\n  /** Message shown during async validation. Defaults to `''` (spinner only). */\n  validation?: string;\n  /** Message shown while the command's action is running. */\n  progress?: string;\n  /** Message shown when the command succeeds. `null` to suppress. Defaults to the `progress` message. */\n  success?: PadroneProgressMessage | ((result: TRes) => PadroneProgressMessage);\n  /** Message shown when the command fails. `null` to suppress. Defaults to the error message. */\n  error?: PadroneProgressMessage | ((error: unknown) => PadroneProgressMessage);\n};\n\n/**\n * Progress indicator configuration with messages, visual options, and renderer.\n */\nexport type PadroneProgressConfig<TRes = unknown> = {\n  /** Per-phase messages. A string sets the `progress` message; an object configures individual phases. */\n  message?: string | PadroneProgressMessages<TRes>;\n  /** Spinner configuration. Default `show` is `'auto'` (visible when bar is not shown). `true` forces spinner to always show (even alongside a bar). */\n  spinner?: PadroneSpinnerConfig;\n  /** Enable a progress bar. `true` for defaults (`show: 'always'`), or a `PadroneBarConfig` object. `false` to disable entirely. When omitted, bar defaults to `show: 'auto'`. */\n  bar?: boolean | PadroneBarConfig;\n  /** Show elapsed time since the indicator started. Can also be started on demand via `update({ time: true })`. */\n  time?: boolean;\n  /** Show estimated time remaining based on progress rate. Requires numeric `update()` calls. */\n  eta?: boolean;\n  /**\n   * Custom renderer factory. Called to create the progress indicator.\n   * Defaults to the built-in terminal renderer (`createTerminalProgress`).\n   */\n  renderer?: PadroneProgressRenderer;\n  /** Suppress all progress output. The `progress` interface is still provided on the context as a no-op. */\n  silent?: boolean;\n};\n\n/**\n * Shared progress defaults that can be provided via context instead of repeating\n * at each call site. Per-instance message fields are excluded — those always come\n * from the constructor argument.\n *\n * Provide via context as `{ progressConfig: PadroneProgressDefaults }`.\n */\nexport type PadroneProgressDefaults = Pick<PadroneProgressConfig, 'message' | 'spinner' | 'bar' | 'time' | 'eta' | 'renderer' | 'silent'>;\n\n/** Builder/program type after applying `padroneProgress()`. Adds `{ progress: PadroneProgress }` to the command context. */\nexport type WithProgress<T> = WithInterceptor<T, { progress: PadroneProgress }>;\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nconst noopEta = { start() {}, stop() {}, reset() {} };\nconst noopIndicator: PadroneProgress = {\n  update() {},\n  eta: noopEta,\n  succeed() {},\n  fail() {},\n  stop() {},\n  pause() {},\n  resume() {},\n};\n\nfunction resolveMessage(field: unknown, value: unknown, fallback?: string): { message: string | null | undefined; indicator?: string } {\n  const raw = typeof field === 'function' ? (field as (v: unknown) => unknown)(value) : field;\n  if (raw === undefined) return { message: fallback };\n  if (raw === null || typeof raw === 'string') return { message: raw };\n  if (typeof raw === 'object' && raw !== null) {\n    const obj = raw as { message?: string | null; indicator?: string };\n    return { message: obj.message, indicator: obj.indicator };\n  }\n  return { message: fallback };\n}\n\nfunction cleanup(\n  indicator: PadroneProgress,\n  successConfig: unknown,\n  errorConfig: unknown,\n  error: unknown,\n  result: unknown,\n  isError: boolean,\n) {\n  if (isError) {\n    const fallback = error instanceof Error ? error.message : String(error);\n    const { message: errorMsg, indicator: errorIcon } = resolveMessage(errorConfig, error, fallback);\n    indicator.fail(errorMsg, errorIcon !== undefined ? { indicator: errorIcon } : undefined);\n  } else {\n    const { message: successMsg, indicator: successIcon } = resolveMessage(successConfig, result);\n    indicator.succeed(successMsg, successIcon !== undefined ? { indicator: successIcon } : undefined);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Interceptor\n// ---------------------------------------------------------------------------\n\nfunction resolveMessages(raw: string | PadroneProgressMessages | undefined): {\n  progress: string;\n  validation: string;\n  success: unknown;\n  error: unknown;\n} {\n  if (!raw || typeof raw === 'string') {\n    return { progress: raw || 'Working...', validation: '', success: undefined, error: undefined };\n  }\n  return {\n    progress: raw.progress ?? 'Working...',\n    validation: raw.validation ?? '',\n    success: raw.success,\n    error: raw.error,\n  };\n}\n\nfunction mergeMessages(\n  cmd: ReturnType<typeof resolveMessages>,\n  ctx: ReturnType<typeof resolveMessages>,\n  cmdRaw: string | PadroneProgressMessages | undefined,\n): ReturnType<typeof resolveMessages> {\n  // String shorthand: all fields come from the string, no context fallback for individual fields\n  if (typeof cmdRaw === 'string') return cmd;\n  // Object: per-field fallback to context\n  const obj = (typeof cmdRaw === 'object' ? cmdRaw : undefined) as PadroneProgressMessages | undefined;\n  return {\n    progress: obj?.progress !== undefined ? cmd.progress : (ctx.progress ?? cmd.progress),\n    validation: obj?.validation !== undefined ? cmd.validation : ctx.validation || cmd.validation,\n    success: obj?.success !== undefined ? cmd.success : (ctx.success ?? cmd.success),\n    error: obj?.error !== undefined ? cmd.error : (ctx.error ?? cmd.error),\n  };\n}\n\nfunction progressInterceptor(config: string | PadroneProgressConfig) {\n  const isObj = typeof config === 'object';\n  const rawMessage = typeof config === 'string' ? config : isObj ? config.message : undefined;\n  // Raw constructor values — undefined means \"not set by caller\"\n  const rawSpinner = isObj ? config.spinner : undefined;\n  const rawBar = isObj ? config.bar : undefined;\n  const rawRenderer = isObj ? config.renderer : undefined;\n  const rawTime = isObj ? config.time : undefined;\n  const rawEta = isObj ? config.eta : undefined;\n  const rawSilent = isObj ? config.silent : undefined;\n\n  return defineInterceptor({ id: 'padrone:progress', name: 'padrone:progress' })\n    .requires<{ progressConfig?: PadroneProgressDefaults }>()\n    .factory(() => {\n      let indicator: PadroneProgress | undefined;\n      let restoreOutput: (() => void) | undefined;\n      // Lazily resolved from context + constructor args\n      let resolvedRenderer: PadroneProgressRenderer | undefined;\n      let resolvedOptions: PadroneProgressOptions | undefined;\n      let resolvedSilent = false;\n      let msgs: ReturnType<typeof resolveMessages> | undefined;\n\n      function resolve(ctx: { context?: { progressConfig?: PadroneProgressDefaults } }) {\n        if (resolvedRenderer) return;\n        const ctxCfg = (ctx.context as Record<string, unknown> | undefined)?.progressConfig as PadroneProgressDefaults | undefined;\n        resolvedSilent = rawSilent ?? ctxCfg?.silent ?? false;\n        const spinner = rawSpinner ?? ctxCfg?.spinner;\n        const bar = rawBar ?? ctxCfg?.bar;\n        const time = rawTime ?? ctxCfg?.time;\n        const eta = rawEta ?? ctxCfg?.eta;\n        resolvedRenderer = rawRenderer ?? ctxCfg?.renderer ?? createTerminalProgress;\n        resolvedOptions =\n          spinner !== undefined || bar !== undefined || time !== undefined || eta !== undefined ? { spinner, bar, time, eta } : undefined;\n        msgs = mergeMessages(resolveMessages(rawMessage), resolveMessages(ctxCfg?.message), rawMessage);\n      }\n\n      const teardown = () => {\n        restoreOutput?.();\n        indicator = undefined;\n        restoreOutput = undefined;\n      };\n\n      return {\n        validate(ctx, next) {\n          resolve(ctx);\n          if (resolvedSilent) return next();\n          indicator = resolvedRenderer!(msgs!.validation || msgs!.progress, resolvedOptions);\n\n          const originalOutput = ctx.runtime.output;\n          const originalError = ctx.runtime.error;\n          ctx.runtime.output = (...args: unknown[]) => {\n            indicator!.pause();\n            originalOutput(...args);\n            indicator!.resume();\n          };\n          ctx.runtime.error = (text: string) => {\n            indicator!.pause();\n            originalError(text);\n            indicator!.resume();\n          };\n          restoreOutput = () => {\n            ctx.runtime.output = originalOutput;\n            ctx.runtime.error = originalError;\n          };\n\n          const onValidationFailure = (error: unknown) => {\n            if (indicator) {\n              cleanup(indicator, msgs!.success, msgs!.error, error, undefined, true);\n              teardown();\n            }\n          };\n\n          const checkResult = (result: any) => {\n            if (result.argsResult?.issues) onValidationFailure(new Error('Validation failed'));\n            return result;\n          };\n\n          let result: any;\n          try {\n            result = next();\n          } catch (err) {\n            onValidationFailure(err);\n            throw err;\n          }\n          if (result instanceof Promise) {\n            return result.then(checkResult, (err: unknown) => {\n              onValidationFailure(err);\n              throw err;\n            });\n          }\n          return checkResult(result);\n        },\n\n        execute(_ctx, next) {\n          if (resolvedSilent) return next({ context: { progress: noopIndicator } });\n\n          // Transition from validation message to progress message\n          if (indicator && msgs!.validation) indicator.update(msgs!.progress);\n\n          const effectiveIndicator = indicator ?? noopIndicator;\n\n          const onSuccess = (value: unknown) => {\n            cleanup(effectiveIndicator, msgs!.success, msgs!.error, undefined, value, false);\n            teardown();\n          };\n          const onError = (err: unknown) => {\n            if (indicator) {\n              cleanup(indicator, msgs!.success, msgs!.error, err, undefined, true);\n              teardown();\n            }\n            throw err;\n          };\n\n          let result: any;\n          try {\n            result = next({ context: { progress: effectiveIndicator } });\n          } catch (err) {\n            onError(err);\n          }\n          if (result instanceof Promise) {\n            return result.then(\n              (r) => {\n                if (r.result instanceof Promise) {\n                  return {\n                    result: r.result.then(\n                      (value: unknown) => {\n                        onSuccess(value);\n                        return value;\n                      },\n                      (err: unknown) => onError(err),\n                    ),\n                  };\n                }\n                onSuccess(r.result);\n                return r;\n              },\n              (err: unknown) => onError(err),\n            );\n          }\n          if (result!.result instanceof Promise) {\n            return {\n              result: result!.result.then(\n                (value: unknown) => {\n                  onSuccess(value);\n                  return value;\n                },\n                (err: unknown) => onError(err),\n              ),\n            };\n          }\n          onSuccess(result!.result);\n          return result;\n        },\n\n        shutdown(ctx) {\n          // Safety net: if validate/execute cleanup paths were bypassed (e.g., outer interceptor\n          // threw during execute before reaching this interceptor's execute handler), stop the indicator.\n          if (indicator) {\n            cleanup(indicator, msgs!.success, msgs!.error, ctx.error, ctx.result, !!ctx.error);\n            teardown();\n          }\n        },\n      };\n    })\n    .provides<{ progress: PadroneProgress }>();\n}\n\n// ---------------------------------------------------------------------------\n// Extension\n// ---------------------------------------------------------------------------\n\n/**\n * Extension that adds an auto-managed progress indicator to the command pipeline.\n *\n * - `string` — a single message used for all states.\n * - `PadroneProgressConfig` — separate messages for validation, progress, success, and error.\n *\n * The indicator is automatically started before validation, updated at each phase transition,\n * and stopped on success (`.succeed()`) or failure (`.fail()`).\n *\n * Provides `{ progress: PadroneProgress }` on the command context.\n * Access it in action handlers as `ctx.context.progress`.\n *\n * Uses the built-in terminal renderer by default. Pass a custom `renderer` for non-terminal\n * environments (web UIs, testing, etc).\n *\n * Usage:\n * ```ts\n * createPadrone('my-cli')\n *   .command('sync', (c) =>\n *     c.extend(padroneProgress('Syncing...'))\n *       .action((_args, ctx) => {\n *         ctx.context.progress.update('halfway');\n *       })\n *   )\n * ```\n */\nexport function padroneProgress<T extends CommandTypesBase>(config?: string | PadroneProgressConfig): (builder: T) => WithProgress<T> {\n  return ((builder: AnyPadroneBuilder) => builder.intercept(progressInterceptor(config ?? 'Working...'))) as any;\n}\n"],"mappings":"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"}

package/dist/extension/repl.d.mts

@@ -0,0 +1,26 @@
+import { PadroneSchema } from "../types/schema.mjs";
+import { WithCommand } from "../util/type-utils.mjs";
+import { CommandTypesBase, PadroneCommand } from "../types/command.mjs";
+import { PadroneReplPreferences } from "../types/preferences.mjs";
+//#region src/extension/repl.d.ts
+type ReplArgs = {
+  scope?: string;
+};
+type ReplCommand = PadroneCommand<'repl', '', PadroneSchema<ReplArgs>, void, [], [], true>;
+type WithRepl<T> = WithCommand<T, 'repl', ReplCommand>;
+/**
+ * Extension that adds REPL support:
+ * - `repl` command that starts an interactive REPL
+ * - `--repl` flag that starts the REPL from any invocation
+ *
+ * Usage:
+ * ```ts
+ * createPadrone('my-cli').extend(padroneRepl())
+ * ```
+ */
+declare function padroneRepl(defaults?: PadroneReplPreferences & {
+  disabled?: boolean;
+}): <T extends CommandTypesBase>(builder: T) => WithRepl<T>;
+//#endregion
+export { WithRepl, padroneRepl };
+//# sourceMappingURL=repl.d.mts.map

package/dist/extension/repl.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.mts","names":[],"sources":["../../src/extension/repl.ts"],"mappings":";;;;;KAiBK,QAAA;EAAa,KAAK;AAAA;AAAA,KAElB,WAAA,GAAc,cAAA,aAA2B,aAAA,CAAc,QAAA;AAAA,KAEhD,QAAA,MAAc,WAAA,CAAY,CAAA,UAAW,WAAA;;;;AAJ1B;AAAA;;;;;;iBAkBP,WAAA,CACd,QAAA,GAAW,sBAAA;EAA2B,QAAA;AAAA,eAC1B,gBAAA,EAAkB,OAAA,EAAS,CAAA,KAAM,QAAA,CAAS,CAAA"}

package/dist/extension/repl.mjs

@@ -0,0 +1,67 @@
+import { withDrain } from "../core/results.mjs";
+import { defineInterceptor } from "../core/interceptors.mjs";
+import { parseCliInputToParts } from "../core/parse.mjs";
+import { passthroughSchema } from "./utils.mjs";
+//#region src/extension/repl.ts
+/**
+* Extension that adds REPL support:
+* - `repl` command that starts an interactive REPL
+* - `--repl` flag that starts the REPL from any invocation
+*
+* Usage:
+* ```ts
+* createPadrone('my-cli').extend(padroneRepl())
+* ```
+*/
+function padroneRepl(defaults) {
+	const disabled = defaults?.disabled;
+	return ((builder) => builder.command("repl", (c) => c.configure({
+		description: "Start an interactive REPL",
+		hidden: true
+	}).arguments(passthroughSchema({ scope: "string" }), { positional: ["scope"] }).async().action(async (args, ctx) => {
+		const prefs = {
+			...defaults,
+			scope: args.scope ?? defaults?.scope
+		};
+		const { value } = await ctx.program.repl(prefs).drain();
+		return value;
+	})).intercept(createReplInterceptor(defaults, disabled)));
+}
+function createReplInterceptor(defaults, disabled) {
+	return defineInterceptor({
+		id: "padrone:repl",
+		name: "padrone:repl",
+		order: -1e3,
+		disabled
+	}, () => ({ start(ctx, next) {
+		const replInfo = checkReplFlag(ctx.input, ctx.command);
+		if (!replInfo) return next();
+		const program = ctx.program;
+		if (!program?.repl) return next();
+		const prefs = {
+			...defaults,
+			scope: replInfo.scope ?? defaults?.scope
+		};
+		return program.repl(prefs).drain().then((r) => withDrain({
+			command: ctx.command,
+			args: void 0,
+			result: r.value
+		}));
+	} }));
+}
+/** Check for --repl flag in input. */
+function checkReplFlag(input, rootCommand) {
+	if (!input) return null;
+	const parts = parseCliInputToParts(input);
+	const terms = parts.filter((p) => p.type === "term").map((p) => p.value);
+	const args = parts.filter((p) => p.type === "named");
+	const keyIs = (key, name) => key.length === 1 && key[0] === name;
+	if (!args.some((p) => p.type === "named" && keyIs(p.key, "repl"))) return null;
+	const normalizedTerms = [...terms];
+	if (normalizedTerms[0] === rootCommand.name) normalizedTerms.shift();
+	return { scope: normalizedTerms.length > 0 ? normalizedTerms.join(" ") : void 0 };
+}
+//#endregion
+export { padroneRepl };
+
+//# sourceMappingURL=repl.mjs.map

package/dist/extension/repl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.mjs","names":[],"sources":["../../src/extension/repl.ts"],"sourcesContent":["import { defineInterceptor } from '../core/interceptors.ts';\nimport { parseCliInputToParts } from '../core/parse.ts';\nimport { withDrain } from '../core/results.ts';\nimport type {\n  AnyPadroneBuilder,\n  AnyPadroneCommand,\n  CommandTypesBase,\n  InterceptorStartContext,\n  PadroneCommand,\n  PadroneReplPreferences,\n} from '../types/index.ts';\nimport type { PadroneSchema } from '../types/schema.ts';\nimport type { WithCommand } from '../util/type-utils.ts';\nimport { passthroughSchema } from './utils.ts';\n\n// ── Types ────────────────────────────────────────────────────────────────\n\ntype ReplArgs = { scope?: string };\n\ntype ReplCommand = PadroneCommand<'repl', '', PadroneSchema<ReplArgs>, void, [], [], true>;\n\nexport type WithRepl<T> = WithCommand<T, 'repl', ReplCommand>;\n\n// ── Extension ────────────────────────────────────────────────────────────\n\n/**\n * Extension that adds REPL support:\n * - `repl` command that starts an interactive REPL\n * - `--repl` flag that starts the REPL from any invocation\n *\n * Usage:\n * ```ts\n * createPadrone('my-cli').extend(padroneRepl())\n * ```\n */\nexport function padroneRepl(\n  defaults?: PadroneReplPreferences & { disabled?: boolean },\n): <T extends CommandTypesBase>(builder: T) => WithRepl<T> {\n  const disabled = defaults?.disabled;\n  return ((builder: AnyPadroneBuilder) =>\n    builder\n      .command('repl', (c) =>\n        c\n          .configure({ description: 'Start an interactive REPL', hidden: true })\n          .arguments(passthroughSchema({ scope: 'string' }), { positional: ['scope'] })\n          .async()\n          .action(async (args, ctx) => {\n            const prefs: PadroneReplPreferences = { ...defaults, scope: args.scope ?? defaults?.scope };\n            const repl = ctx.program.repl(prefs);\n            const { value } = await repl.drain();\n            return value;\n          }),\n      )\n      .intercept(createReplInterceptor(defaults, disabled))) as any;\n}\n\nfunction createReplInterceptor(defaults?: PadroneReplPreferences, disabled?: boolean) {\n  return defineInterceptor({ id: 'padrone:repl', name: 'padrone:repl', order: -1000, disabled }, () => ({\n    start(ctx: InterceptorStartContext, next: () => unknown) {\n      const replInfo = checkReplFlag(ctx.input, ctx.command);\n      if (!replInfo) return next();\n\n      const program = ctx.program;\n      if (!program?.repl) return next();\n\n      const prefs: PadroneReplPreferences = { ...defaults, scope: replInfo.scope ?? defaults?.scope };\n\n      // Return a Promise so the pipeline awaits the REPL result\n      return program\n        .repl(prefs)\n        .drain()\n        .then((r: any) => withDrain({ command: ctx.command, args: undefined, result: r.value }));\n    },\n  }));\n}\n\n/** Check for --repl flag in input. */\nfunction checkReplFlag(input: string | undefined, rootCommand: AnyPadroneCommand): { scope?: string } | null {\n  if (!input) return null;\n\n  const parts = parseCliInputToParts(input);\n  const terms = parts.filter((p) => p.type === 'term').map((p) => p.value);\n  const args = parts.filter((p) => p.type === 'named');\n  const keyIs = (key: string[], name: string) => key.length === 1 && key[0] === name;\n\n  const hasReplFlag = args.some((p) => p.type === 'named' && keyIs(p.key, 'repl'));\n  if (!hasReplFlag) return null;\n\n  const normalizedTerms = [...terms];\n  if (normalizedTerms[0] === rootCommand.name) normalizedTerms.shift();\n\n  const scope = normalizedTerms.length > 0 ? normalizedTerms.join(' ') : undefined;\n  return { scope };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAmCA,SAAgB,YACd,UACyD;CACzD,MAAM,WAAW,UAAU;CAC3B,SAAS,YACP,QACG,QAAQ,SAAS,MAChB,EACG,UAAU;EAAE,aAAa;EAA6B,QAAQ;CAAK,CAAC,CAAC,CACrE,UAAU,kBAAkB,EAAE,OAAO,SAAS,CAAC,GAAG,EAAE,YAAY,CAAC,OAAO,EAAE,CAAC,CAAC,CAC5E,MAAM,CAAC,CACP,OAAO,OAAO,MAAM,QAAQ;EAC3B,MAAM,QAAgC;GAAE,GAAG;GAAU,OAAO,KAAK,SAAS,UAAU;EAAM;EAE1F,MAAM,EAAE,UAAU,MADL,IAAI,QAAQ,KAAK,KACH,CAAC,CAAC,MAAM;EACnC,OAAO;CACT,CAAC,CACL,CAAC,CACA,UAAU,sBAAsB,UAAU,QAAQ,CAAC;AAC1D;AAEA,SAAS,sBAAsB,UAAmC,UAAoB;CACpF,OAAO,kBAAkB;EAAE,IAAI;EAAgB,MAAM;EAAgB,OAAO;EAAO;CAAS,UAAU,EACpG,MAAM,KAA8B,MAAqB;EACvD,MAAM,WAAW,cAAc,IAAI,OAAO,IAAI,OAAO;EACrD,IAAI,CAAC,UAAU,OAAO,KAAK;EAE3B,MAAM,UAAU,IAAI;EACpB,IAAI,CAAC,SAAS,MAAM,OAAO,KAAK;EAEhC,MAAM,QAAgC;GAAE,GAAG;GAAU,OAAO,SAAS,SAAS,UAAU;EAAM;EAG9F,OAAO,QACJ,KAAK,KAAK,CAAC,CACX,MAAM,CAAC,CACP,MAAM,MAAW,UAAU;GAAE,SAAS,IAAI;GAAS,MAAM,KAAA;GAAW,QAAQ,EAAE;EAAM,CAAC,CAAC;CAC3F,EACF,EAAE;AACJ;;AAGA,SAAS,cAAc,OAA2B,aAA2D;CAC3G,IAAI,CAAC,OAAO,OAAO;CAEnB,MAAM,QAAQ,qBAAqB,KAAK;CACxC,MAAM,QAAQ,MAAM,QAAQ,MAAM,EAAE,SAAS,MAAM,CAAC,CAAC,KAAK,MAAM,EAAE,KAAK;CACvE,MAAM,OAAO,MAAM,QAAQ,MAAM,EAAE,SAAS,OAAO;CACnD,MAAM,SAAS,KAAe,SAAiB,IAAI,WAAW,KAAK,IAAI,OAAO;CAG9E,IAAI,CADgB,KAAK,MAAM,MAAM,EAAE,SAAS,WAAW,MAAM,EAAE,KAAK,MAAM,CAC/D,GAAG,OAAO;CAEzB,MAAM,kBAAkB,CAAC,GAAG,KAAK;CACjC,IAAI,gBAAgB,OAAO,YAAY,MAAM,gBAAgB,MAAM;CAGnE,OAAO,EAAE,OADK,gBAAgB,SAAS,IAAI,gBAAgB,KAAK,GAAG,IAAI,KAAA,EACxD;AACjB"}

package/dist/extension/serve.d.mts

@@ -0,0 +1,27 @@
+import { PadroneSchema } from "../types/schema.mjs";
+import { WithCommand } from "../util/type-utils.mjs";
+import { PadroneServePreferences } from "../feature/serve.mjs";
+import { CommandTypesBase, PadroneCommand } from "../types/command.mjs";
+//#region src/extension/serve.d.ts
+type ServeArgs = {
+  port?: string;
+  host?: string;
+  basePath?: string;
+};
+type ServeCommand = PadroneCommand<'serve', '', PadroneSchema<ServeArgs>, void, [], [], true>;
+type WithServe<T> = WithCommand<T, 'serve', ServeCommand>;
+/**
+ * Extension that adds the `serve` command for starting a REST HTTP server.
+ *
+ * Usage:
+ * ```ts
+ * import { createPadrone } from 'padrone';
+ * import { padroneServe } from 'padrone/serve';
+ *
+ * createPadrone('my-cli').extend(padroneServe())
+ * ```
+ */
+declare function padroneServe(defaults?: PadroneServePreferences): <T extends CommandTypesBase>(builder: T) => WithServe<T>;
+//#endregion
+export { WithServe, padroneServe };
+//# sourceMappingURL=serve.d.mts.map

package/dist/extension/serve.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.mts","names":[],"sources":["../../src/extension/serve.ts"],"mappings":";;;;;KAUK,SAAA;EAAc,IAAA;EAAe,IAAA;EAAe,QAAA;AAAA;AAAA,KAE5C,YAAA,GAAe,cAAA,cAA4B,aAAA,CAAc,SAAA;AAAA,KAElD,SAAA,MAAe,WAAA,CAAY,CAAA,WAAY,YAAA;;;;;AAJM;AAAA;;;;;;iBAmBzC,YAAA,CAAa,QAAA,GAAW,uBAAA,cAAqC,gBAAA,EAAkB,OAAA,EAAS,CAAA,KAAM,SAAA,CAAU,CAAA"}

package/dist/extension/serve.mjs

@@ -0,0 +1,41 @@
+import { resolveAllCommands } from "../core/commands.mjs";
+import { getRootCommand } from "../util/utils.mjs";
+import { passthroughSchema } from "./utils.mjs";
+//#region src/extension/serve.ts
+/**
+* Extension that adds the `serve` command for starting a REST HTTP server.
+*
+* Usage:
+* ```ts
+* import { createPadrone } from 'padrone';
+* import { padroneServe } from 'padrone/serve';
+*
+* createPadrone('my-cli').extend(padroneServe())
+* ```
+*/
+function padroneServe(defaults) {
+	return ((builder) => builder.command("serve", (c) => c.configure({
+		description: "Start a REST HTTP server",
+		hidden: true
+	}).arguments(passthroughSchema({
+		port: "string",
+		host: "string",
+		"base-path": "string"
+	})).async().action(async (args, ctx) => {
+		const rootCommand = getRootCommand(ctx.command);
+		resolveAllCommands(rootCommand);
+		const { startServeServer } = await import("../feature/serve.mjs");
+		const port = args.port ? parseInt(args.port, 10) : void 0;
+		const prefs = {
+			...defaults,
+			port: port && !Number.isNaN(port) ? port : defaults?.port,
+			host: args.host ?? defaults?.host,
+			basePath: args["base-path"] ?? defaults?.basePath
+		};
+		await startServeServer(ctx.program, rootCommand, ctx.program.eval, prefs);
+	})));
+}
+//#endregion
+export { padroneServe };
+
+//# sourceMappingURL=serve.mjs.map

package/dist/extension/serve.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.mjs","names":[],"sources":["../../src/extension/serve.ts"],"sourcesContent":["import { resolveAllCommands } from '../core/commands.ts';\nimport type { PadroneServePreferences } from '../feature/serve.ts';\nimport type { AnyPadroneBuilder, CommandTypesBase, PadroneCommand } from '../types/index.ts';\nimport type { PadroneSchema } from '../types/schema.ts';\nimport type { WithCommand } from '../util/type-utils.ts';\nimport { getRootCommand } from '../util/utils.ts';\nimport { passthroughSchema } from './utils.ts';\n\n// ── Types ────────────────────────────────────────────────────────────────\n\ntype ServeArgs = { port?: string; host?: string; basePath?: string };\n\ntype ServeCommand = PadroneCommand<'serve', '', PadroneSchema<ServeArgs>, void, [], [], true>;\n\nexport type WithServe<T> = WithCommand<T, 'serve', ServeCommand>;\n\n// ── Extension ────────────────────────────────────────────────────────────\n\n/**\n * Extension that adds the `serve` command for starting a REST HTTP server.\n *\n * Usage:\n * ```ts\n * import { createPadrone } from 'padrone';\n * import { padroneServe } from 'padrone/serve';\n *\n * createPadrone('my-cli').extend(padroneServe())\n * ```\n */\nexport function padroneServe(defaults?: PadroneServePreferences): <T extends CommandTypesBase>(builder: T) => WithServe<T> {\n  return ((builder: AnyPadroneBuilder) =>\n    builder.command('serve', (c) =>\n      c\n        .configure({ description: 'Start a REST HTTP server', hidden: true })\n        .arguments(passthroughSchema({ port: 'string', host: 'string', 'base-path': 'string' }))\n        .async()\n        .action(async (args, ctx) => {\n          const rootCommand = getRootCommand(ctx.command);\n          resolveAllCommands(rootCommand);\n          const { startServeServer } = await import('../feature/serve.ts');\n          const port = args.port ? parseInt(args.port, 10) : undefined;\n          const prefs: PadroneServePreferences = {\n            ...defaults,\n            port: port && !Number.isNaN(port) ? port : defaults?.port,\n            host: args.host ?? defaults?.host,\n            basePath: args['base-path'] ?? defaults?.basePath,\n          };\n          await startServeServer(ctx.program, rootCommand, ctx.program.eval, prefs);\n        }),\n    )) as any;\n}\n"],"mappings":";;;;;;;;;;;;;;;AA6BA,SAAgB,aAAa,UAA8F;CACzH,SAAS,YACP,QAAQ,QAAQ,UAAU,MACxB,EACG,UAAU;EAAE,aAAa;EAA4B,QAAQ;CAAK,CAAC,CAAC,CACpE,UAAU,kBAAkB;EAAE,MAAM;EAAU,MAAM;EAAU,aAAa;CAAS,CAAC,CAAC,CAAC,CACvF,MAAM,CAAC,CACP,OAAO,OAAO,MAAM,QAAQ;EAC3B,MAAM,cAAc,eAAe,IAAI,OAAO;EAC9C,mBAAmB,WAAW;EAC9B,MAAM,EAAE,qBAAqB,MAAM,OAAO;EAC1C,MAAM,OAAO,KAAK,OAAO,SAAS,KAAK,MAAM,EAAE,IAAI,KAAA;EACnD,MAAM,QAAiC;GACrC,GAAG;GACH,MAAM,QAAQ,CAAC,OAAO,MAAM,IAAI,IAAI,OAAO,UAAU;GACrD,MAAM,KAAK,QAAQ,UAAU;GAC7B,UAAU,KAAK,gBAAgB,UAAU;EAC3C;EACA,MAAM,iBAAiB,IAAI,SAAS,aAAa,IAAI,QAAQ,MAAM,KAAK;CAC1E,CAAC,CACL;AACJ"}

package/dist/extension/signal.d.mts

@@ -0,0 +1,19 @@
+import { CommandTypesBase } from "../types/command.mjs";
+//#region src/extension/signal.d.ts
+/**
+ * Extension that wires process signal handling (SIGINT, SIGTERM, SIGHUP) into the interceptor lifecycle.
+ *
+ * - Creates an `AbortController` whose signal is propagated to all downstream phases.
+ * - Subscribes to `runtime.onSignal` to forward OS signals to the abort controller.
+ * - Implements SIGINT double-tap: two SIGINTs within 2 seconds force-exits the process.
+ * - Attaches `signal` and `exitCode` to results and errors when interrupted.
+ * - Cleans up the signal subscription on completion or failure.
+ *
+ * Included in the default extensions. Runs at order `-2000` (outermost).
+ */
+declare function padroneSignalHandling(options?: {
+  disabled?: boolean;
+}): <T extends CommandTypesBase>(builder: T) => T;
+//#endregion
+export { padroneSignalHandling };
+//# sourceMappingURL=signal.d.mts.map

package/dist/extension/signal.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.d.mts","names":[],"sources":["../../src/extension/signal.ts"],"mappings":";;;;;AAmFA;;;;;;;;iBAAgB,qBAAA,CAAsB,OAAA;EAAY,QAAA;AAAA,eAAkC,gBAAA,EAAkB,OAAA,EAAS,CAAA,KAAM,CAAA"}

package/dist/extension/signal.mjs

@@ -0,0 +1,81 @@
+import { thenMaybe } from "../core/results.mjs";
+import { defineInterceptor } from "../core/interceptors.mjs";
+import { SignalError, signalExitCode } from "../core/errors.mjs";
+//#region src/extension/signal.ts
+const signalMeta = {
+	id: "padrone:signal",
+	name: "padrone:signal",
+	order: -2e3
+};
+const signalInterceptor = defineInterceptor(signalMeta, () => {
+	const abortController = new AbortController();
+	let receivedSignal;
+	let lastSigintTime = 0;
+	let unsubscribe;
+	const DOUBLE_SIGINT_MS = 2e3;
+	const cleanup = () => {
+		unsubscribe?.();
+		unsubscribe = void 0;
+	};
+	const attachSignalInfo = (result) => {
+		if (receivedSignal && result && typeof result === "object") {
+			result.signal = receivedSignal;
+			result.exitCode = signalExitCode(receivedSignal);
+		}
+		return result;
+	};
+	return {
+		start(ctx, next) {
+			const runtimeExit = ctx.runtime.exit;
+			unsubscribe = ctx.runtime.onSignal?.((sig) => {
+				if (abortController.signal.aborted) {
+					if (sig === "SIGINT") {
+						const elapsed = Date.now() - lastSigintTime;
+						if (elapsed > 0 && elapsed < DOUBLE_SIGINT_MS) runtimeExit?.(signalExitCode(sig));
+						lastSigintTime = Date.now();
+					}
+					return;
+				}
+				if (sig === "SIGINT") lastSigintTime = Date.now();
+				receivedSignal = sig;
+				abortController.abort(sig);
+			});
+			return thenMaybe(next({ signal: abortController.signal }), (r) => {
+				cleanup();
+				return attachSignalInfo(r);
+			});
+		},
+		error(_ctx, next) {
+			return thenMaybe(next(), (er) => {
+				if (receivedSignal && er.error instanceof Error) er.error = new SignalError(receivedSignal, { cause: er.error });
+				return er;
+			});
+		},
+		shutdown(_ctx, next) {
+			cleanup();
+			return next();
+		}
+	};
+});
+/**
+* Extension that wires process signal handling (SIGINT, SIGTERM, SIGHUP) into the interceptor lifecycle.
+*
+* - Creates an `AbortController` whose signal is propagated to all downstream phases.
+* - Subscribes to `runtime.onSignal` to forward OS signals to the abort controller.
+* - Implements SIGINT double-tap: two SIGINTs within 2 seconds force-exits the process.
+* - Attaches `signal` and `exitCode` to results and errors when interrupted.
+* - Cleans up the signal subscription on completion or failure.
+*
+* Included in the default extensions. Runs at order `-2000` (outermost).
+*/
+function padroneSignalHandling(options) {
+	const interceptor = options?.disabled ? defineInterceptor({
+		...signalMeta,
+		disabled: true
+	}, () => ({})) : signalInterceptor;
+	return ((builder) => builder.intercept(interceptor));
+}
+//#endregion
+export { padroneSignalHandling };
+
+//# sourceMappingURL=signal.mjs.map

package/dist/extension/signal.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"signal.mjs","names":[],"sources":["../../src/extension/signal.ts"],"sourcesContent":["import { SignalError, signalExitCode } from '../core/errors.ts';\nimport { defineInterceptor } from '../core/interceptors.ts';\nimport { thenMaybe } from '../core/results.ts';\nimport type { PadroneSignal } from '../core/runtime.ts';\nimport type { AnyPadroneBuilder, CommandTypesBase } from '../types/index.ts';\n\n// ── Interceptor ─────────────────────────────────────────────────────────\n\nconst signalMeta = { id: 'padrone:signal', name: 'padrone:signal', order: -2000 } as const;\n\nconst signalInterceptor = defineInterceptor(signalMeta, () => {\n  const abortController = new AbortController();\n  let receivedSignal: PadroneSignal | undefined;\n  let lastSigintTime = 0;\n  let unsubscribe: (() => void) | undefined;\n  const DOUBLE_SIGINT_MS = 2000;\n\n  const cleanup = () => {\n    unsubscribe?.();\n    unsubscribe = undefined;\n  };\n\n  const attachSignalInfo = <T>(result: T): T => {\n    if (receivedSignal && result && typeof result === 'object') {\n      (result as any).signal = receivedSignal;\n      (result as any).exitCode = signalExitCode(receivedSignal);\n    }\n    return result;\n  };\n\n  return {\n    start(ctx, next) {\n      const runtimeExit = ctx.runtime.exit;\n      unsubscribe = ctx.runtime.onSignal?.((sig) => {\n        if (abortController.signal.aborted) {\n          if (sig === 'SIGINT') {\n            const elapsed = Date.now() - lastSigintTime;\n            if (elapsed > 0 && elapsed < DOUBLE_SIGINT_MS) {\n              runtimeExit?.(signalExitCode(sig));\n            }\n            lastSigintTime = Date.now();\n          }\n          return;\n        }\n        if (sig === 'SIGINT') lastSigintTime = Date.now();\n        receivedSignal = sig;\n        abortController.abort(sig);\n      });\n\n      const result = next({ signal: abortController.signal });\n      return thenMaybe(result, (r) => {\n        cleanup();\n        return attachSignalInfo(r);\n      });\n    },\n    error(_ctx, next) {\n      return thenMaybe(next(), (er) => {\n        if (receivedSignal && er.error instanceof Error) {\n          er.error = new SignalError(receivedSignal, { cause: er.error });\n        }\n        return er;\n      });\n    },\n    shutdown(_ctx, next) {\n      cleanup();\n      return next();\n    },\n  };\n});\n\n// ── Extension ───────────────────────────────────────────────────────────\n\n/**\n * Extension that wires process signal handling (SIGINT, SIGTERM, SIGHUP) into the interceptor lifecycle.\n *\n * - Creates an `AbortController` whose signal is propagated to all downstream phases.\n * - Subscribes to `runtime.onSignal` to forward OS signals to the abort controller.\n * - Implements SIGINT double-tap: two SIGINTs within 2 seconds force-exits the process.\n * - Attaches `signal` and `exitCode` to results and errors when interrupted.\n * - Cleans up the signal subscription on completion or failure.\n *\n * Included in the default extensions. Runs at order `-2000` (outermost).\n */\nexport function padroneSignalHandling(options?: { disabled?: boolean }): <T extends CommandTypesBase>(builder: T) => T {\n  const interceptor = options?.disabled ? defineInterceptor({ ...signalMeta, disabled: true }, () => ({})) : signalInterceptor;\n  return ((builder: AnyPadroneBuilder) => builder.intercept(interceptor)) as any;\n}\n"],"mappings":";;;;AAQA,MAAM,aAAa;CAAE,IAAI;CAAkB,MAAM;CAAkB,OAAO;AAAM;AAEhF,MAAM,oBAAoB,kBAAkB,kBAAkB;CAC5D,MAAM,kBAAkB,IAAI,gBAAgB;CAC5C,IAAI;CACJ,IAAI,iBAAiB;CACrB,IAAI;CACJ,MAAM,mBAAmB;CAEzB,MAAM,gBAAgB;EACpB,cAAc;EACd,cAAc,KAAA;CAChB;CAEA,MAAM,oBAAuB,WAAiB;EAC5C,IAAI,kBAAkB,UAAU,OAAO,WAAW,UAAU;GAC1D,OAAgB,SAAS;GACzB,OAAgB,WAAW,eAAe,cAAc;EAC1D;EACA,OAAO;CACT;CAEA,OAAO;EACL,MAAM,KAAK,MAAM;GACf,MAAM,cAAc,IAAI,QAAQ;GAChC,cAAc,IAAI,QAAQ,YAAY,QAAQ;IAC5C,IAAI,gBAAgB,OAAO,SAAS;KAClC,IAAI,QAAQ,UAAU;MACpB,MAAM,UAAU,KAAK,IAAI,IAAI;MAC7B,IAAI,UAAU,KAAK,UAAU,kBAC3B,cAAc,eAAe,GAAG,CAAC;MAEnC,iBAAiB,KAAK,IAAI;KAC5B;KACA;IACF;IACA,IAAI,QAAQ,UAAU,iBAAiB,KAAK,IAAI;IAChD,iBAAiB;IACjB,gBAAgB,MAAM,GAAG;GAC3B,CAAC;GAGD,OAAO,UADQ,KAAK,EAAE,QAAQ,gBAAgB,OAAO,CAC/B,IAAI,MAAM;IAC9B,QAAQ;IACR,OAAO,iBAAiB,CAAC;GAC3B,CAAC;EACH;EACA,MAAM,MAAM,MAAM;GAChB,OAAO,UAAU,KAAK,IAAI,OAAO;IAC/B,IAAI,kBAAkB,GAAG,iBAAiB,OACxC,GAAG,QAAQ,IAAI,YAAY,gBAAgB,EAAE,OAAO,GAAG,MAAM,CAAC;IAEhE,OAAO;GACT,CAAC;EACH;EACA,SAAS,MAAM,MAAM;GACnB,QAAQ;GACR,OAAO,KAAK;EACd;CACF;AACF,CAAC;;;;;;;;;;;;AAeD,SAAgB,sBAAsB,SAAiF;CACrH,MAAM,cAAc,SAAS,WAAW,kBAAkB;EAAE,GAAG;EAAY,UAAU;CAAK,UAAU,CAAC,EAAE,IAAI;CAC3G,SAAS,YAA+B,QAAQ,UAAU,WAAW;AACvE"}

package/dist/extension/stdin.d.mts

@@ -0,0 +1,19 @@
+import { CommandTypesBase } from "../types/command.mjs";
+//#region src/extension/stdin.d.ts
+/**
+ * Extension that reads stdin data into the argument field specified by `meta.stdin`.
+ * Included by default via `createPadrone()`.
+ *
+ * Read mode is inferred from the schema type:
+ * - `string` field → reads all stdin as a single string
+ * - `string[]` field → reads stdin line-by-line into an array
+ * - `AsyncIterable` field → returns a stream for line-by-line async consumption
+ *
+ * Stdin is only read when piped (not a TTY) and the field wasn't already provided via CLI flags.
+ */
+declare function padroneStdin(options?: {
+  disabled?: boolean;
+}): <T extends CommandTypesBase>(builder: T) => T;
+//#endregion
+export { padroneStdin };
+//# sourceMappingURL=stdin.d.mts.map

package/dist/extension/stdin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.d.mts","names":[],"sources":["../../src/extension/stdin.ts"],"mappings":";;;;;AA0DA;;;;;;;;iBAAgB,YAAA,CAAa,OAAA;EAAY,QAAA;AAAA,eAAkC,gBAAA,EAAkB,OAAA,EAAS,CAAA,KAAM,CAAA"}

package/dist/extension/stdin.mjs

@@ -0,0 +1,52 @@
+import { createStdinStream } from "../util/stream.mjs";
+import { applyValues, isArrayField, isAsyncStreamField } from "../core/args.mjs";
+import { resolveStdin, resolveStdinAlways } from "../core/default-runtime.mjs";
+import { defineInterceptor } from "../core/interceptors.mjs";
+//#region src/extension/stdin.ts
+const stdinInterceptor = defineInterceptor({
+	id: "padrone:stdin",
+	name: "padrone:stdin",
+	order: -1001
+}, () => ({ validate(ctx, next) {
+	const stdinField = ctx.command.meta?.stdin;
+	if (!stdinField) return next();
+	if (stdinField in ctx.rawArgs && ctx.rawArgs[stdinField] !== void 0) return next();
+	const streamInfo = isAsyncStreamField(ctx.command.argsSchema, stdinField);
+	if (streamInfo) {
+		const stdinForStream = resolveStdinAlways(ctx.runtime);
+		return next({ rawArgs: applyValues(ctx.rawArgs, { [stdinField]: createStdinStream(stdinForStream, streamInfo.itemSchema) }) });
+	}
+	const stdin = resolveStdin(ctx.runtime);
+	if (!stdin) return next();
+	if (isArrayField(ctx.command.argsSchema, stdinField)) return (async () => {
+		const lines = [];
+		for await (const line of stdin.lines()) lines.push(line);
+		return next({ rawArgs: applyValues(ctx.rawArgs, { [stdinField]: lines }) });
+	})();
+	return stdin.text().then((text) => {
+		if (!text) return next();
+		return next({ rawArgs: applyValues(ctx.rawArgs, { [stdinField]: text }) });
+	});
+} }));
+/**
+* Extension that reads stdin data into the argument field specified by `meta.stdin`.
+* Included by default via `createPadrone()`.
+*
+* Read mode is inferred from the schema type:
+* - `string` field → reads all stdin as a single string
+* - `string[]` field → reads stdin line-by-line into an array
+* - `AsyncIterable` field → returns a stream for line-by-line async consumption
+*
+* Stdin is only read when piped (not a TTY) and the field wasn't already provided via CLI flags.
+*/
+function padroneStdin(options) {
+	const interceptor = options?.disabled ? defineInterceptor({
+		...stdinInterceptor,
+		disabled: true
+	}, () => ({})) : stdinInterceptor;
+	return ((builder) => builder.intercept(interceptor));
+}
+//#endregion
+export { padroneStdin };
+
+//# sourceMappingURL=stdin.mjs.map