import type { CollectionDefinition, CollectionHooks, CollectionHooksLoader, FileField, ImageField, ServerHooksConfig, SingletonHooks, SingletonHooksLoader, UploadHooks, UploadHooksLoader } from '../@types/index.js';
type DocumentHookValue = CollectionHooks | CollectionHooksLoader | SingletonHooks | SingletonHooksLoader;
type UploadHookValue = UploadHooks | UploadHooksLoader;
type UploadField = ImageField | FileField;
export type HookAttachmentOperation = {
    kind: 'collection';
    target: CollectionDefinition;
    hooks: DocumentHookValue | undefined;
} | {
    kind: 'upload';
    target: UploadField;
    hooks: UploadHookValue | undefined;
};
/**
 * Validate a server hook registry and prepare its in-place definition updates.
 * This phase never mutates definitions, so callers may safely abandon the plan
 * when later initialization work fails.
 */
export declare function prepareHookAttachment(config: {
    collections: readonly CollectionDefinition[];
    hooks?: ServerHooksConfig;
}): HookAttachmentOperation[];
/** Commit a previously validated attachment plan synchronously. */
export declare function commitHookAttachment(operations: readonly HookAttachmentOperation[]): void;
export {};