hacksh 0.14.0 → 0.16.0

package/dist/{command-CfWrbHLN.d.ts → command-B-Ok_6KW.d.ts}

@@ -1,4 +1,78 @@
-import { $ZodIssue, $ZodObject, output } from "zod/v4/core";
+import { $ZodIssue, $ZodObject, JSONSchemaMeta, output } from "zod/v4/core";
+//#region src/exec.d.ts
+type Environment = Readonly<Record<string, string | undefined>>;
+interface ExecOptions {
+  cwd?: string;
+  env?: Environment;
+  input?: string;
+  reject?: boolean;
+  timeout?: number;
+  signal?: AbortSignal;
+  maxBuffer?: number;
+  forceKillAfterDelay?: number;
+  stdin?: "pipe" | "inherit";
+  stdout?: "pipe" | "inherit";
+  stderr?: "pipe" | "inherit";
+  interactive?: boolean;
+  display?: boolean;
+  redact?: readonly string[];
+  dryRun?: boolean;
+}
+interface ExecCommand {
+  file: string;
+  args: readonly string[];
+  cwd: string | undefined;
+}
+interface ExecSuccess {
+  status: "succeeded";
+  command: ExecCommand;
+  stdout: string;
+  stderr: string;
+  exitCode: 0;
+}
+type ExecFailure = {
+  status: "failed";
+  command: ExecCommand;
+  stdout: string;
+  stderr: string;
+} & ({
+  reason: "exit-code";
+  exitCode: number;
+} | {
+  reason: "signal";
+  signal: string;
+} | {
+  reason: "spawn";
+  error: Error;
+} | {
+  reason: "timeout" | "aborted" | "output-limit";
+} | {
+  reason: "json-output" | "non-interactive" | "overlapping";
+});
+type ExecFailureReason = ExecFailure["reason"];
+type ExecResult = ExecSuccess | ExecFailure;
+interface ExecSkipped {
+  status: "skipped";
+  command: ExecCommand;
+}
+type ExecOutcome<O extends ExecOptions> = "reject" extends keyof O ? false extends O["reject"] ? ExecResult : ExecSuccess : ExecSuccess;
+type SpecifiedDryRun<O> = "dryRun" extends keyof O ? O["dryRun"] : false;
+type ReturnsFailure<O extends ExecOptions> = "reject" extends keyof O ? false extends O["reject"] ? true : false : false;
+type AbortedFailure = {
+  status: "failed";
+  command: ExecCommand;
+  stdout: string;
+  stderr: string;
+  reason: "aborted";
+};
+type DefiniteSkip<O extends ExecOptions> = ReturnsFailure<O> extends true ? ExecSkipped | AbortedFailure : ExecSkipped;
+type ExecReturn<O extends ExecOptions> = true extends SpecifiedDryRun<O> ? false extends SpecifiedDryRun<O> ? ExecSkipped | ExecOutcome<O> : undefined extends SpecifiedDryRun<O> ? ExecSkipped | ExecOutcome<O> : DefiniteSkip<O> : ExecOutcome<O>;
+type RejectInheritedInput<O> = O extends {
+  input: string;
+  stdin: "inherit";
+} ? never : unknown;
+type Exec = <const O extends ExecOptions = {}>(file: string, args?: readonly string[], options?: O & { [K in Exclude<keyof O, keyof ExecOptions>]: never; } & RejectInheritedInput<O>) => Promise<ExecReturn<O>>;
+//#endregion
 //#region src/errors.d.ts
 interface HackshIssue {
   arg: string;
@@ -136,16 +210,21 @@ declare function showUsage(command: AnyCommandDef, options: ShowUsageOptions): P
 type PrintStream = "stdout" | "stderr";
 type OutputPreference = "auto" | "pretty" | "json";
 type OutputFormat = Exclude<OutputPreference, "auto">;
+interface StreamColors {
+  stdout: boolean;
+  stderr: boolean;
+}
 interface OutputMode {
   format: OutputFormat;
   interactive: boolean;
-  color: boolean;
+  color: StreamColors;
 }
 interface ResolveOutputModeOptions {
   output?: OutputPreference;
   env?: Readonly<Record<string, string | undefined>>;
   inputIsTTY?: boolean;
   outputIsTTY?: boolean;
+  errorOutputIsTTY?: boolean;
 }
 /** Resolve output behavior once, before command routing or argument parsing. */
 declare function resolveOutputMode(options?: ResolveOutputModeOptions): OutputMode;
@@ -199,6 +278,16 @@ interface PromptPrintEvent {
   type: "prompt";
   prompt: PromptState;
 }
+/** Command output: exact text written to stdout, or a JSON value. */
+type OutputPrintEvent = {
+  type: "output";
+  kind: "text";
+  text: string;
+} | {
+  type: "output";
+  kind: "json";
+  data: unknown;
+};
 interface ExecPrintEvent {
   type: "exec";
   phase: "start" | "skip";
@@ -213,7 +302,7 @@ interface ExecPrintEvent {
   interactive: boolean;
 }
 /** A semantic, command- and schema-free output value emitted by hacksh. */
-type PrintEvent = UsagePrintEvent | VersionPrintEvent | ErrorPrintEvent | LogPrintEvent | PromptPrintEvent | ExecPrintEvent;
+type PrintEvent = UsagePrintEvent | VersionPrintEvent | ErrorPrintEvent | LogPrintEvent | PromptPrintEvent | OutputPrintEvent | ExecPrintEvent;
 /** Receives every output event produced by one command invocation. */
 interface Printer {
   print(event: PrintEvent): void | Promise<void>;
@@ -242,79 +331,16 @@ interface JsonPrinterOptions {
 /** Create a one-semantic-event-per-line JSON printer. */
 declare function createJsonPrinter(options?: JsonPrinterOptions): Printer;
 //#endregion
-//#region src/exec.d.ts
-type Environment = Readonly<Record<string, string | undefined>>;
-interface ExecOptions {
-  cwd?: string;
-  env?: Environment;
-  input?: string;
-  reject?: boolean;
-  timeout?: number;
-  signal?: AbortSignal;
-  maxBuffer?: number;
-  forceKillAfterDelay?: number;
-  stdin?: "pipe" | "inherit";
-  stdout?: "pipe" | "inherit";
-  stderr?: "pipe" | "inherit";
-  interactive?: boolean;
-  display?: boolean;
-  redact?: readonly string[];
-  dryRun?: boolean;
+//#region src/command-output.d.ts
+/** Writes a command's results to stdout, separately from logs. */
+interface Output {
+  /** Write text exactly as given. */
+  print(text: string): void;
+  /** Write text followed by a newline. */
+  println(text?: string): void;
+  /** Write a JSON value. */
+  json(value: unknown): void;
 }
-interface ExecCommand {
-  file: string;
-  args: readonly string[];
-  cwd: string | undefined;
-}
-interface ExecSuccess {
-  status: "succeeded";
-  command: ExecCommand;
-  stdout: string;
-  stderr: string;
-  exitCode: 0;
-}
-type ExecFailure = {
-  status: "failed";
-  command: ExecCommand;
-  stdout: string;
-  stderr: string;
-} & ({
-  reason: "exit-code";
-  exitCode: number;
-} | {
-  reason: "signal";
-  signal: string;
-} | {
-  reason: "spawn";
-  error: Error;
-} | {
-  reason: "timeout" | "aborted" | "output-limit";
-} | {
-  reason: "json-output" | "non-interactive" | "overlapping";
-});
-type ExecFailureReason = ExecFailure["reason"];
-type ExecResult = ExecSuccess | ExecFailure;
-interface ExecSkipped {
-  status: "skipped";
-  command: ExecCommand;
-}
-type ExecOutcome<O extends ExecOptions> = "reject" extends keyof O ? false extends O["reject"] ? ExecResult : ExecSuccess : ExecSuccess;
-type SpecifiedDryRun<O> = "dryRun" extends keyof O ? O["dryRun"] : false;
-type ReturnsFailure<O extends ExecOptions> = "reject" extends keyof O ? false extends O["reject"] ? true : false : false;
-type AbortedFailure = {
-  status: "failed";
-  command: ExecCommand;
-  stdout: string;
-  stderr: string;
-  reason: "aborted";
-};
-type DefiniteSkip<O extends ExecOptions> = ReturnsFailure<O> extends true ? ExecSkipped | AbortedFailure : ExecSkipped;
-type ExecReturn<O extends ExecOptions> = true extends SpecifiedDryRun<O> ? false extends SpecifiedDryRun<O> ? ExecSkipped | ExecOutcome<O> : undefined extends SpecifiedDryRun<O> ? ExecSkipped | ExecOutcome<O> : DefiniteSkip<O> : ExecOutcome<O>;
-type RejectInheritedInput<O> = O extends {
-  input: string;
-  stdin: "inherit";
-} ? never : unknown;
-type Exec = <const O extends ExecOptions = {}>(file: string, args?: readonly string[], options?: O & { [K in Exclude<keyof O, keyof ExecOptions>]: never; } & RejectInheritedInput<O>) => Promise<ExecReturn<O>>;
 //#endregion
 //#region src/prompts.d.ts
 interface SelectOption<T extends string> {
@@ -343,6 +369,17 @@ interface Prompter {
 }
 //#endregion
 //#region src/schema.d.ts
+interface ArgumentMeta extends JSONSchemaMeta {
+  alias?: string | readonly string[];
+  env?: string | false;
+  valueName?: string;
+}
+declare module "zod" {
+  interface GlobalMeta extends ArgumentMeta {}
+}
+declare module "zod/v4" {
+  interface GlobalMeta extends ArgumentMeta {}
+}
 type ArgsSchema = $ZodObject;
 type EmptyArgs = $ZodObject<{}>;
 //#endregion
@@ -355,6 +392,7 @@ interface CommandContext<S extends ArgsSchema> {
     unknown: string[];
     passthrough: string[];
   };
+  output: Output;
   logger: Logger;
   prompt: Prompter;
   exec: Exec;
@@ -374,5 +412,5 @@ interface CommandDef<S extends ArgsSchema = EmptyArgs, R = unknown, Children ext
 type AnyCommandDef = CommandDef<ArgsSchema>;
 declare function defineCommand<S extends ArgsSchema = EmptyArgs, R = never, Children extends Record<string, AnyCommandDef> = {}>(def: CommandDef<S, R, Children>): CommandDef<S, NoInfer<R>, NoInfer<Children>>;
 //#endregion
-export { LogKind as $, PrintStream as A, TextPromptState as B, JsonPrinterOptions as C, OutputPreference as D, OutputMode as E, PromptStatus as F, ShowUsageOptions as G, VersionPrintEvent as H, ResolveOutputModeOptions as I, UsageOptionSummary as J, UsageArgumentSummary as K, SelectPromptState as L, PromptChoiceState as M, PromptPrintEvent as N, OutputWriter as O, PromptState as P, summarizeUsage as Q, TerminalInput as R, ExecPrintEvent as S, OutputFormat as T, createJsonPrinter as U, UsagePrintEvent as V, resolveOutputMode as W, renderUsage as X, UsageSummary as Y, showUsage as Z, ExecReturn as _, ArgsSchema as a, HackshErrorSummary as at, ConfirmPromptState as b, SelectOption as c, HackshIssue as ct, Exec as d, HackshUsageError as dt, LogLevel as et, ExecCommand as f, HackshValidationError as ft, ExecResult as g, ExecOptions as h, ValidationIssueSummary as ht, defineCommand as i, HackshErrorKind as it, Printer as j, PrintEvent as k, SelectOptions as l, HackshPromptError as lt, ExecFailureReason as m, PromptKind as mt, CommandContext as n, LogRecord as nt, ConfirmOptions as o, HackshExecError as ot, ExecFailure as p, PromptErrorDetails as pt, UsageCommandSummary as q, CommandDef as r, Logger as rt, Prompter as s, HackshExitError as st, AnyCommandDef as t, LogProperties as tt, TextOptions as u, HackshPromptErrorReason as ut, ExecSkipped as v, LogPrintEvent as w, ErrorPrintEvent as x, ExecSuccess as y, TerminalOutput as z };
-//# sourceMappingURL=command-CfWrbHLN.d.ts.map
+export { HackshErrorSummary as $, SelectPromptState as A, UsageArgumentSummary as B, PrintStream as C, PromptState as D, PromptPrintEvent as E, UsagePrintEvent as F, showUsage as G, UsageOptionSummary as H, VersionPrintEvent as I, LogLevel as J, summarizeUsage as K, createJsonPrinter as L, TerminalInput as M, TerminalOutput as N, PromptStatus as O, TextPromptState as P, HackshErrorKind as Q, resolveOutputMode as R, PrintEvent as S, PromptChoiceState as T, UsageSummary as U, UsageCommandSummary as V, renderUsage as W, LogRecord as X, LogProperties as Y, Logger as Z, OutputFormat as _, ExecSkipped as _t, ArgsSchema as a, HackshUsageError as at, OutputPrintEvent as b, SelectOption as c, PromptKind as ct, Output as d, ExecCommand as dt, HackshExecError as et, ConfirmPromptState as f, ExecFailure as ft, LogPrintEvent as g, ExecReturn as gt, JsonPrinterOptions as h, ExecResult as ht, defineCommand as i, HackshPromptErrorReason as it, StreamColors as j, ResolveOutputModeOptions as k, SelectOptions as l, ValidationIssueSummary as lt, ExecPrintEvent as m, ExecOptions as mt, CommandContext as n, HackshIssue as nt, ConfirmOptions as o, HackshValidationError as ot, ErrorPrintEvent as p, ExecFailureReason as pt, LogKind as q, CommandDef as r, HackshPromptError as rt, Prompter as s, PromptErrorDetails as st, AnyCommandDef as t, HackshExitError as tt, TextOptions as u, Exec as ut, OutputMode as v, ExecSuccess as vt, Printer as w, OutputWriter as x, OutputPreference as y, ShowUsageOptions as z };
+//# sourceMappingURL=command-B-Ok_6KW.d.ts.map

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { D as OutputPreference, G as ShowUsageOptions, O as OutputWriter, Q as summarizeUsage, R as TerminalInput, X as renderUsage, Z as showUsage, _ as ExecReturn, a as ArgsSchema, c as SelectOption, ct as HackshIssue, d as Exec, dt as HackshUsageError, f as ExecCommand, ft as HackshValidationError, g as ExecResult, h as ExecOptions, i as defineCommand, j as Printer, l as SelectOptions, lt as HackshPromptError, m as ExecFailureReason, mt as PromptKind, n as CommandContext, o as ConfirmOptions, ot as HackshExecError, p as ExecFailure, pt as PromptErrorDetails, r as CommandDef, rt as Logger, s as Prompter, st as HackshExitError, t as AnyCommandDef, u as TextOptions, ut as HackshPromptErrorReason, v as ExecSkipped, y as ExecSuccess, z as TerminalOutput } from "./command-CfWrbHLN.js";
+import { G as showUsage, K as summarizeUsage, M as TerminalInput, N as TerminalOutput, W as renderUsage, Z as Logger, _t as ExecSkipped, a as ArgsSchema, at as HackshUsageError, c as SelectOption, ct as PromptKind, d as Output, dt as ExecCommand, et as HackshExecError, ft as ExecFailure, gt as ExecReturn, ht as ExecResult, i as defineCommand, it as HackshPromptErrorReason, l as SelectOptions, mt as ExecOptions, n as CommandContext, nt as HackshIssue, o as ConfirmOptions, ot as HackshValidationError, pt as ExecFailureReason, r as CommandDef, rt as HackshPromptError, s as Prompter, st as PromptErrorDetails, t as AnyCommandDef, tt as HackshExitError, u as TextOptions, ut as Exec, vt as ExecSuccess, w as Printer, y as OutputPreference, z as ShowUsageOptions } from "./command-B-Ok_6KW.js";
 import { output } from "zod/v4/core";
 //#region src/parser.d.ts
 /**
@@ -17,7 +17,7 @@ interface OutputOptions {
   env?: Readonly<Record<string, string | undefined>>;
   stdin?: TerminalInput;
   stdout?: TerminalOutput;
-  stderr?: OutputWriter;
+  stderr?: TerminalOutput;
 }
 //#endregion
 //#region src/run.d.ts
@@ -39,5 +39,5 @@ interface RunMainOptions extends OutputOptions {
 }
 declare function runMain<S extends ArgsSchema>(command: CommandDef<S>, options?: RunMainOptions): Promise<void>;
 //#endregion
-export { type CommandContext, type CommandDef, type ConfirmOptions, type Exec, type ExecCommand, type ExecFailure, type ExecFailureReason, type ExecOptions, type ExecResult, type ExecReturn, type ExecSkipped, type ExecSuccess, HackshExecError, HackshExitError, type HackshIssue, HackshPromptError, type HackshPromptErrorReason, HackshUsageError, HackshValidationError, type Logger, type OutputOptions, type PromptErrorDetails, type PromptKind, type Prompter, type RunCommandOptions, type RunMainOptions, type SelectOption, type SelectOptions, type ShowUsageOptions, type TextOptions, defineCommand, parseArgs, renderUsage, runCommand, runMain, showUsage, summarizeUsage };
+export { type CommandContext, type CommandDef, type ConfirmOptions, type Exec, type ExecCommand, type ExecFailure, type ExecFailureReason, type ExecOptions, type ExecResult, type ExecReturn, type ExecSkipped, type ExecSuccess, HackshExecError, HackshExitError, type HackshIssue, HackshPromptError, type HackshPromptErrorReason, HackshUsageError, HackshValidationError, type Logger, type Output, type OutputOptions, type PromptErrorDetails, type PromptKind, type Prompter, type RunCommandOptions, type RunMainOptions, type SelectOption, type SelectOptions, type ShowUsageOptions, type TextOptions, defineCommand, parseArgs, renderUsage, runCommand, runMain, showUsage, summarizeUsage };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as createExec, c as HackshPromptError, d as summarizeError, f as summarizeErrors, i as resolveOutputMode, l as HackshUsageError, n as createJsonPrinter, o as HackshExecError, r as createPrintQueue, s as HackshExitError, t as createPrettyPrinter, u as HackshValidationError } from "./pretty-BFub611x.js";
+import { a as createExec, c as HackshPromptError, d as summarizeError, f as summarizeErrors, i as resolveOutputMode, l as HackshUsageError, n as createJsonPrinter, o as HackshExecError, r as createPrintQueue, s as HackshExitError, t as createPrettyPrinter, u as HackshValidationError } from "./pretty-DJ2CE6TU.js";
 import { globalRegistry, safeParseAsync } from "zod/v4/core";
 import { parseArgs as parseArgs$1 } from "node:util";
 import { readFile, realpath } from "node:fs/promises";
@@ -475,6 +475,27 @@ async function parseArgs(command, argv, options) {
 	return (await parseCommandArgs(command, argv, tokenizeCommandArgs(command, argv), options?.env, envPath)).args;
 }
 //#endregion
+//#region src/command-output.ts
+/** Create the output for one command invocation. */
+function createOutput(printer) {
+	function print(text) {
+		printer.print({
+			type: "output",
+			kind: "text",
+			text
+		});
+	}
+	return {
+		print,
+		println: (text = "") => print(`${text}\n`),
+		json: (data) => void printer.print({
+			type: "output",
+			kind: "json",
+			data
+		})
+	};
+}
+//#endregion
 //#region src/terminal.ts
 var TerminalLock = class {
 	#owner;
@@ -885,7 +906,8 @@ function selectOutputPrinter(options, override, resolvedMode) {
 		output: options.output,
 		env: options.env,
 		inputIsTTY: stdin.isTTY,
-		outputIsTTY: stdout.isTTY
+		outputIsTTY: stdout.isTTY,
+		errorOutputIsTTY: stderr.isTTY
 	});
 	if (override) return override;
 	if (mode.format === "json") return createJsonPrinter({
@@ -1109,6 +1131,7 @@ async function executeCommand(root, argv, output, env, signal, fallbackVersion =
 			unknown: parsed.extraArgs,
 			passthrough: parsed.passthrough
 		},
+		output: createOutput(printer),
 		logger: createLogger(printer, category),
 		prompt: new PromptController({
 			interactive: output.interactive,
@@ -1136,7 +1159,8 @@ function prepareOutput(options, env) {
 		output: options.output,
 		env,
 		inputIsTTY: input.isTTY,
-		outputIsTTY: (options.stdout ?? process.stdout).isTTY
+		outputIsTTY: (options.stdout ?? process.stdout).isTTY,
+		errorOutputIsTTY: (options.stderr ?? process.stderr).isTTY
 	});
 	return {
 		...createPrintQueue(selectOutputPrinter(options, options.printer, mode)),