import { type ElementSummary, type QueryElementItemJSON } from '../types.js';
/**
 * Options for {@link getQueryElementSummary}.
 *
 * @internal
 */
export type GetQueryElementSummaryOptions = {
    /**
     * Distinguishes filter vs highlight when `item` is a `filterFactory.*` call.
     * Ignored for dimensions and measures. Defaults to `'filter'`.
     */
    readonly role?: 'filter' | 'highlight';
};
/**
 * Derives a human-readable name and element kind from a query JSON item.
 *
 * @param item - Dimension, measure, filter, or highlight JSON entry
 * @param options - When `item` is a filter/highlight `FunctionCall`, `role` selects the returned kind
 * @returns Summary with display name and type, or `null` when `item` is not a recognized shape
 *
 * @internal
 */
export declare function getQueryElementSummary(item: QueryElementItemJSON, options?: GetQueryElementSummaryOptions): ElementSummary | null;