/**
 * Finds the closest ancestor matching a selector, crossing shadow DOM boundaries.
 */
export declare function closestCrossingShadow(element: Element, selector: string): Element | null;
/**
 * Checks if an element is inside a shadow DOM
 */
export declare function isInShadowDOM(element: Element): boolean;
/**
 * Gets the shadow host for an element, or null if not in shadow DOM
 */
export declare function getShadowHost(element: Element): Element | null;
/**
 * Gets a readable path for an element (e.g., "article > section > p")
 * Supports elements inside shadow DOM by crossing shadow boundaries.
 */
export declare function getElementPath(target: HTMLElement, maxDepth?: number): string;
/**
 * Identifies an element and returns a human-readable name + path
 */
export declare function identifyElement(target: HTMLElement): {
    name: string;
    path: string;
};
/**
 * Gets text content from element and siblings for context
 */
export declare function getNearbyText(element: HTMLElement): string;
/**
 * Simplified element identifier for animation feedback (less verbose)
 */
export declare function identifyAnimationElement(target: HTMLElement): string;
/**
 * Gets nearby sibling elements for structural context.
 * Supports elements inside shadow DOM.
 */
export declare function getNearbyElements(element: HTMLElement): string;
/**
 * Gets CSS class names from an element (cleaned of module hashes)
 */
export declare function getElementClasses(target: HTMLElement): string;
/**
 * Gets key computed styles for an element (useful for styling issues)
 */
export declare function getComputedStylesSnapshot(target: HTMLElement): string;
/**
 * Gets key computed styles for the annotation popup display.
 * Returns different properties based on element type to show the most relevant
 * CSS properties for debugging (e.g., typography for text, layout for containers).
 */
export declare function getDetailedComputedStyles(target: HTMLElement): Record<string, string>;
/**
 * Gets full computed styles for forensic output.
 * Returns a comprehensive semicolon-separated string of all relevant CSS properties
 * for maximum debugging detail in the forensic output format.
 */
export declare function getForensicComputedStyles(target: HTMLElement): string;
/**
 * Parses a forensic computed styles string back into a Record.
 * Inverse of getForensicComputedStyles - used when editing annotations.
 */
export declare function parseComputedStylesString(stylesStr: string | undefined): Record<string, string> | undefined;
/**
 * Gets accessibility information for an element
 */
export declare function getAccessibilityInfo(target: HTMLElement): string;
/**
 * Gets full DOM ancestry path (for forensic mode).
 * Supports elements inside shadow DOM by marking shadow boundary crossings.
 */
export declare function getFullElementPath(target: HTMLElement): string;
//# sourceMappingURL=element-identification.d.ts.map