/**
 * Build Execution Tools
 * Project build and compilation tools.
 *
 * Provides:
 * - buildProject: Compiles firmware binaries.
 * - cleanProject: Scrubs compilation artifacts.
 * - buildTarget: Compiles specific PIO lifecycle targets.
 * - listTargets: Discovers valid compilation targets.
 */
import type { BuildResult, CleanResult } from "../types.js";
import type { DiagnosticResult } from "../core/diagnostics/types.js";
/**
 * Builds a PlatformIO project.
 *
 * @param projectDir - The target location of the PIO project.
 * @param environment - Optional specific platformio.ini environment target.
 * @param verbose - If true, returns the complete verbose build log in the result instead of truncating it.
 * @returns Resulting build status and output log payloads.
 */
export declare function buildProject(projectDir: string, environment?: string, verbose?: boolean, background?: boolean): Promise<BuildResult>;
/**
 * Runs static analysis on a PlatformIO project.
 *
 * @param projectDir - The target location of the PIO project.
 * @param environment - Optional specific platformio.ini environment target.
 * @param background - If true, dispatches the execution to the background.
 * @returns Resulting status payload.
 */
export declare function checkProject(projectDir: string, environment?: string, background?: boolean): Promise<BuildResult>;
/**
 * Runs unit tests on a PlatformIO project.
 *
 * @param projectDir - The target location of the PIO project.
 * @param environment - Optional specific platformio.ini environment target.
 * @param background - If true, dispatches the execution to the background.
 * @returns Resulting status payload.
 */
export declare function runTests(projectDir: string, environment?: string, background?: boolean): Promise<BuildResult>;
/**
 * Cleans build artifacts from a project.

 *
 * @param projectDir - Discard compilation output for this project workspace.
 * @returns Indicates successful cleanup execution metadata.
 */
export declare function cleanProject(projectDir: string, background?: boolean): Promise<CleanResult>;
/**
 * Builds project for a specific target (e.g., 'upload', 'monitor', 'test').
 *
 * @param projectDir - Project workspace to run the target against.
 * @param target - Build operation target designation.
 * @param environment - Associated subset configuration to use.
 * @param verbose - If true, returns full output payload instead of truncating on success.
 * @returns Completed build execution status outcome.
 */
export declare function buildTarget(projectDir: string, target: string, environment?: string, verbose?: boolean): Promise<BuildResult>;
/**
 * Gets list of available build targets for a project.
 *
 * @param projectDir - Applicable initialized source map directory.
 * @param environment - Particular platform configuration to read targets from.
 * @returns Plain array strings of build execution routines.
 */
export declare function listTargets(projectDir: string, environment?: string): Promise<string[]>;
/**
 * Polling tool to check background task status and return recent logs.
 */
export declare function checkTaskStatus(taskId?: string, logPath?: string, projectDir?: string): Promise<{
    status: string;
    targetStatus: string;
    taskId: string | undefined;
    logPaths: string[];
    output: string;
    diagnostic: DiagnosticResult;
}>;
//# sourceMappingURL=build.d.ts.map