import { type Diagnostic } from "@aotter/mantle-spec";
export declare function mediaNotConfiguredDiagnostic(opPath: string): Diagnostic;
export declare function mediaMimeRejectedDiagnostic(opPath: string, mime: string): Diagnostic;
export declare function mediaSvgRejectedDiagnostic(opPath: string): Diagnostic;
export declare function mediaSizeExceededDiagnostic(opPath: string, byteSize: number, maxBytes: number): Diagnostic;
export declare function mediaUploadExpiredDiagnostic(opPath: string, uploadGroupId: string): Diagnostic;
export declare function mediaObjectNotFoundDiagnostic(opPath: string, uploadGroupId: string): Diagnostic;
/** Caller supplied a `purpose` that this deployment did not declare in
 *  `siteDefaults.media.purposes`. Fail-closed per #262: alpha has no
 *  production consumers, so there is no warn-and-allow compatibility
 *  mode — undeclared purposes are always rejected. The `expected`
 *  field carries the declared set so agents can self-correct without
 *  another round trip. */
export declare function mediaPurposeRejectedDiagnostic(opPath: string, purpose: string | undefined, declared: readonly string[]): Diagnostic;
/** Caller's variants manifest is missing one or more mimes the
 *  purpose policy declares as required. The expected field carries
 *  the declared required set + the supplied set so the agent script
 *  can self-correct without another round trip. */
export declare function mediaVariantsIncompleteDiagnostic(opPath: string, purpose: string, required: readonly string[], supplied: readonly string[]): Diagnostic;
export declare function mediaVariantSizeExceededDiagnostic(opPath: string, mime: string, byteSize: number, maxBytes: number): Diagnostic;
/**
 * Variant byte sizes don't match the format hierarchy the uploader
 * promised — typically avif > webp > jpeg (each modern format
 * smaller). When the upload manifest claims a modern format that's
 * larger than the universal-fallback (e.g. `avif` weighing more than
 * `jpeg`), the uploader almost certainly skipped optimization for
 * that variant. Fail hard rather than emit a `<picture>` that's
 * slower than the bare `<img>` fallback.
 */
export declare function mediaVariantsSuspiciousSizeDiagnostic(opPath: string, detail: string): Diagnostic;
export declare function mediaAssetNotFoundDiagnostic(opPath: string, id: string): Diagnostic;
//# sourceMappingURL=diagnostics.d.ts.map