import { FileParseResult } from '../types/blocks';
type FileWithMetadata = FileParseResult & {
    relative_path?: string;
    output_path?: string;
    output_dir?: string;
};
interface MetadataOptions {
    dirPath: string;
    files: FileWithMetadata[];
    perFileBase?: string;
    ext: '.json' | '.yaml';
    cwd?: string;
}
/**
 * Attaches relative path metadata to per-file results and module blocks.
 * - Adds relative paths for files and their output targets (when split outputs are enabled).
 * - Adds `source_output_dir` to module blocks that point to local directories within the parsed tree.
 */
export declare function annotateOutputMetadata(options: MetadataOptions): void;
export {};