/**
 * Image Debugging Utilities for Grid3 Files
 *
 * These utilities help developers understand why images might not be resolving
 * correctly in Grid3 gridsets.
 */
import { FileAdapter, type ProcessorInput } from '../../utils/io';
import { ZipAdapter } from '../../utils/zip';
export interface ImageIssue {
    gridName: string;
    cellX: number;
    cellY: number;
    declaredImage: string | undefined;
    expectedPaths: string[];
    issue: 'not_found' | 'symbol_library' | 'external_reference';
    suggestion: string;
}
export interface ImageAuditResult {
    totalCells: number;
    cellsWithImages: number;
    resolvedImages: number;
    unresolvedImages: number;
    issues: ImageIssue[];
    availableImages: string[];
}
/**
 * Audit a gridset file to find image resolution issues
 *
 * @param gridsetBuffer - The gridset file as a Buffer
 * @returns Detailed audit report of image issues
 *
 * @example
 * const audit = await auditGridsetImages(gridsetBuffer);
 * console.log(`Found ${audit.unresolvedImages} unresolved images`);
 * audit.issues.forEach(issue => {
 *   console.log(`Cell (${issue.cellX}, ${issue.cellY}): ${issue.suggestion}`);
 * });
 */
export declare function auditGridsetImages(gridsetBuffer: Uint8Array, password?: string | undefined, fileAdapter?: FileAdapter, zipAdapter?: (input: ProcessorInput) => Promise<ZipAdapter>): Promise<ImageAuditResult>;
/**
 * Get a human-readable summary of image audit results
 */
export declare function formatImageAuditSummary(audit: ImageAuditResult): string;