/**
 * Copyright (c) 2026, Salesforce, Inc.,
 * All rights reserved.
 * For full license text, see the LICENSE.txt file
 */
/**
 * Component Matcher Module
 * Handles mapping DOM elements to source-locatable elements (data-source-*).
 */
export interface ComponentMatcherOptions {
    allowlist?: string[];
}
export declare class ComponentMatcher {
    private allowlist;
    constructor(options?: ComponentMatcherOptions);
    /**
     * Check whether an element contains compile-time source metadata attributes.
     * @param element - The element to check
     * @returns True if the data-source-file attribute is present
     */
    hasSourceMetadata(element: HTMLElement | null | undefined): boolean;
    private matchesList;
    /**
     * Checks if a label represents a component name (not a fallback like tag name, ID, or text content)
     * @param label - The label to check
     * @param tagName - The element's tag name (lowercase)
     * @returns True if the label is a component name
     */
    isComponentNameLabel(label: string, tagName: string): boolean;
    /**
     * Check if an element is highlightable.
     * @param element - The element to check
     * @returns True if the element should be highlighted
     */
    isHighlightableElement(element: HTMLElement | null | undefined): boolean;
    /**
     * Find the nearest highlightable element by walking up the DOM tree
     * @param target - The target element
     * @returns The highlightable element or null
     */
    findHighlightableElement(target: HTMLElement | null | undefined): HTMLElement | null;
}
//# sourceMappingURL=componentMatcher.d.ts.map