import type { ArtifactSyncExecutionOptions, SyncBlockMetadataFailure, SyncBlockMetadataOptions } from './metadata-core.js';
export interface ResolvedSyncBlockMetadataPaths {
    blockJsonPath: string;
    jsonSchemaPath: string | null;
    manifestPath: string;
    openApiPath: string | null;
    phpValidatorPath: string;
    projectRoot: string;
}
export interface GeneratedArtifactFile {
    content: string;
    path: string;
}
export interface GeneratedArtifactDriftIssue {
    path: string;
    reason: 'missing' | 'stale';
}
export declare class GeneratedArtifactDriftError extends Error {
    readonly issues: GeneratedArtifactDriftIssue[];
    constructor(issues: GeneratedArtifactDriftIssue[]);
}
export declare function reconcileGeneratedArtifacts(artifacts: readonly GeneratedArtifactFile[], executionOptions: ArtifactSyncExecutionOptions | undefined, preexistingIssues?: GeneratedArtifactDriftIssue[]): void;
export declare function resolveSyncBlockMetadataPaths(options: SyncBlockMetadataOptions): ResolvedSyncBlockMetadataPaths;
export declare function normalizeSyncBlockMetadataFailure(error: unknown): SyncBlockMetadataFailure;