/**
 * Reads + parses the JSON file `docker buildx build` writes via
 * `--metadata-file`. Returns the raw metadata blob; consumer code (e.g.
 * `projectBuildxResult.ts`) is responsible for extracting specific keys
 * such as `containerimage.digest`.
 *
 * Three failure shapes mapped to distinct DockerCliError kinds:
 *   - `metadata_missing`   — file does not exist (ENOENT)
 *   - `metadata_malformed` — file exists but contents are not valid JSON
 *   - `inspect_failed`     — any other read I/O error
 *
 * Out of scope: writing the metadata file (buildx does that), choosing the
 * tmp path (the DockerCli caller does that), digest extraction (projection).
 */
import { type DockerCliError } from "./dockerCliSchemas.js";
import { type Result } from "./result.js";
export declare function parseMetadataFile(path: string): Promise<Result<Record<string, unknown>, DockerCliError>>;