/**
 * The key a `press` sends when neither `text` nor `key` was named.
 *
 * Enter is the historical default. It is also the one key that must NEVER be treated as a
 * document key without a locator: on a focused field inside a form it submits it.
 */
export declare const DEFAULT_PRESS_KEY = "Enter";
/**
 * Keys a real user sends at the page, not at a control. Escape dismisses, Tab moves focus.
 * A press of one of these with no ref is valid; a press of Enter or a letter is not.
 */
export declare const GLOBAL_PRESS_KEYS: readonly ["Escape", "Tab"];
/**
 * Which key a `press` is asking for.
 *
 * `text` FIRST, because that is what the tool description documents ("{ text } for type/press")
 * and therefore what agents send. `key` still works — it is what anyone reading the source would
 * have sent — and the default only applies when neither was named.
 */
export declare function pressKeyFromArgs(args: Record<string, unknown>): string;
/**
 * A press that is a document key, not an element action: Escape, Tab, or any key with modifiers
 * (Cmd+K). Requiring a ref for these forced a snapshot just to name an element the keystroke is
 * not about.
 */
export declare function isGlobalPress(args: Record<string, unknown>): boolean;
/**
 * The tool/step shape `{ action, args }` — a press of a document key, so no locator is required.
 */
export declare function isGlobalPressCall(args: Record<string, unknown>): boolean;