import { ErrorSourceLocation } from "./error-diagnostics.mjs";
//#region src/cli/shared/github-actions.d.ts
/**
 * Attach the source location a failure points at.
 *
 * Consumed when the command's failure is annotated; the error is otherwise
 * unchanged, so its message and formatting stay the caller's own.
 * @param error - Failure to annotate
 * @param location - Absolute file, and the 1-based line when known
 * @returns The same error
 */
export declare function withSourceLocation<T extends Error>(error: T, location: ErrorSourceLocation): T;
/**
 * Annotate the failure that ended the command, when running in GitHub Actions.
 * @param error - Failure that ended the command
 * @param options - JSON mode state and the suggestion shown for a plain error
 * @param options.jsonMode - Whether the CLI is producing a JSON document
 * @param options.suggestion - Suggestion shown for a plain error
 */
export declare function annotateTerminalError(error: unknown, options: {
  jsonMode: boolean;
  suggestion?: string;
}): void;
//#endregion