import type { ClickArea, ClickAreaValue, ClickOffset, FindImageMatch, Rect, Point } from './types';
/** 解析单个 ClickAreaValue 为像素偏移量 */
export declare function resolveAreaValue(v: ClickAreaValue | undefined, total: number): number;
/**
 * 根据命中矩形和 ClickArea 计算最终点击点（屏幕绝对坐标）。
 *
 * - `clickArea` 不传：返回命中矩形中心（findImage 返回的 x/y 已是中心）
 * - `clickArea` 传了：各边内缩后形成子矩形，返回该子矩形中心
 *   （randomRange 由后端在该点周围抖动）
 *
 * @example
 * // 命中矩形 200×100，中心 (500,300)
 * // { left: '50%', top: '50%' } → 右下 1/4 子矩形中心 = (550, 325)
 */
export declare function computeImageClickPoint(match: FindImageMatch, area?: ClickArea): {
    x: number;
    y: number;
};
/**
 * 根据矩形（Rect 左上角原点）和 ClickArea 计算点击点（屏幕绝对坐标）。
 *
 * 与 `computeImageClickPoint` 语义一致，但输入是标准 `Rect`（x/y 为左上角），
 * 而非图像命中矩形（x/y 为中心）。正值内缩，负值外扩。
 *
 * - `clickArea` 不传：返回矩形中心
 * - `clickArea` 传了：各边内缩后形成子矩形，返回该子矩形中心
 *
 * @example
 * // Rect 200×100，左上角 (500,300)
 * // { left: '50%', top: '50%' } → 右下 1/4 子矩形中心 = (600, 350)
 */
export declare function computeRectClickPoint(rect: Rect, area?: ClickArea): Point;
/**
 * 根据 ClickOffset 表达式计算最终点击点（屏幕绝对坐标）。
 *
 * ClickOffset 语义：
 * - 预设位置：'top' | 'bottom' | 'left' | 'right' | 'center'
 * - 表达式：`<edge>[+-]<value>[unit]`
 *   - edge: top | bottom | left | right（参考边）
 *   - +/-: 偏移方向
 *   - value: 数值
 *   - unit: '%'（相对元素宽/高）或 'px'（绝对像素，默认）
 *
 * 表达式语义：从参考边的坐标出发，加上/减去偏移量。
 * - 'left+20%'  → left_edge + 0.2*width（向内）
 * - 'left-10px' → left_edge - 10px（向外）
 * - 'right-5%'  → right_edge - 0.05*width（向内）
 * - 'top+10px'  → top_edge + 10px（向内）
 *
 * @param match 命中矩形（x/y 为中心，width/height 为尺寸）
 * @param offset 偏移表达式
 * @returns 屏幕绝对坐标
 */
export declare function resolveOffsetPoint(match: FindImageMatch, offset: ClickOffset): {
    x: number;
    y: number;
};