/**
 * Copyright (c) 2026, Salesforce, Inc.,
 * All rights reserved.
 * For full license text, see the LICENSE.txt file
 */
export interface SourceLocation {
    fileName: string;
    lineNumber: number | null;
    columnNumber: number | null;
}
/**
 * Extract source location information from data attributes.
 * @param element - The DOM element
 * @returns Source location information, or null if missing.
 */
export declare function getSourceFromDataAttributes(element: HTMLElement | null | undefined): SourceLocation | null;
/**
 * Find all DOM elements whose `data-source-file` attribute matches the given source location.
 * @param location - The source location to match against
 * @returns All matching elements (may be empty)
 */
export declare function findElementsBySourceLocation(location: SourceLocation): HTMLElement[];
/**
 * Derive a human-readable label from the injected source file name, if present.
 * @param element - The DOM element
 * @returns A label suitable for UI display
 */
/**
 * Parse an untyped message payload object into a SourceLocation.
 * Used by the entry point to convert raw postMessage data into typed values.
 * @param sl - The raw source location object from a message payload
 * @returns A SourceLocation, or undefined if the input is not a valid object
 */
export declare function parseSourceLocation(sl: unknown): SourceLocation | undefined;
export declare function getLabelFromSource(element: HTMLElement | null | undefined): string;
//# sourceMappingURL=sourceUtils.d.ts.map