import { type TemplateMetadata } from './metadata.js';
export interface FillOptions {
    templateDir: string;
    values: Record<string, unknown>;
    outputPath: string;
    postProcess?: (outputPath: string) => void | Promise<void>;
}
export interface FillResult {
    outputPath: string;
    metadata: TemplateMetadata;
    /** Prepared data keys actually referenced by fill commands in the document. */
    fieldsUsed: string[];
    /** Subset of fieldsUsed whose values the caller actually supplied. */
    providedFieldsUsed: string[];
    /** Fill commands found in the final pre-fill document; 0 = nothing was substituted. */
    fillCommandCount: number;
    /** Guardrail warnings (zero-fill-command, verify failures, unknown keys). */
    warnings: string[];
}
export declare function fillTemplate(options: FillOptions): Promise<FillResult>;
//# sourceMappingURL=engine.d.ts.map