type TargetingFilePath = string | {
    filePath: string;
};
export type TargetingElementContext = {
    tagName: string;
    className?: string;
    id?: string;
    textContent?: string;
    componentTree?: Array<{
        name: string;
    }>;
    attributes?: Record<string, string>;
    parentElementSummary?: {
        tagName: string;
        className: string;
        textSnippet: string;
    };
    filePaths?: TargetingFilePath[];
};
export type ElementTargetingFormatOptions = {
    includeFilePaths?: boolean;
    markUntrusted?: boolean;
};
export declare const formatUntrustedValue: (value: string, maxLength: number) => string;
/**
 * Builds a compact CSS-like selector: `tag#id.class1.class2.class3`.
 */
export declare const buildElementSelector: (ctx: Pick<TargetingElementContext, "tagName" | "className" | "id">) => string;
/**
 * Builds compact targeting lines for agent prompts and UI apply summaries.
 */
export declare const formatElementTargetingLines: (ctx: TargetingElementContext, options?: ElementTargetingFormatOptions) => string[];
export {};
//# sourceMappingURL=formatElementTargetingContext.d.ts.map