import { Editor } from '../core/types/index.js';
/**
 * Log a console.warn once per key. Subsequent calls with the same key are no-ops.
 */
export declare function warnOnce(key: string, message: string): void;
/**
 * Wrap an Editor instance in a Proxy that emits one-time deprecation
 * warnings when consumers access ProseMirror internals or editor commands.
 *
 * The proxy is fully transparent — all property access and method calls are
 * forwarded to the underlying editor. Only the warning side-effect is added.
 *
 * @returns Proxied editor (or the original if null/already wrapped)
 */
export declare function createDeprecatedEditorProxy<T extends Editor | null | undefined>(editor: T): T;
/**
 * Unwrap a potentially proxied editor back to the raw Editor instance.
 * Safe to call on an already-raw editor — returns it unchanged.
 */
export declare function unwrapEditor(editor: Editor | null | undefined): Editor | null | undefined;