Function getFullElementPath

package/src/utils/element-identification.ts:586–615

(target: HTMLElement)

 * Supports elements inside shadow DOM by marking shadow boundary crossings.
 */
export function getFullElementPath(target: HTMLElement): string {
  const parts: string[] = [];
  let current: HTMLElement | null = target;

  while (current && current.tagName.toLowerCase() !== "html") {
    const tag = current.tagName.toLowerCase();
    let identifier = tag;

    if (current.id) {
      identifier = `${tag}#${current.id}`;
    } else if (current.className && typeof current.className === "string") {
      const cls = current.className
        .split(/\s+/)
        .map(c => c.replace(/[_][a-zA-Z0-9]{5,}.*$/, ""))
        .find(c => c.length > 2);
      if (cls) identifier = `${tag}.${cls}`;
    }

    // Mark shadow boundary crossings
    const nextParent = getParentElement(current);
    if (!current.parentElement && nextParent) {
      identifier = `⟨shadow⟩ ${identifier}`;
    }

    parts.unshift(identifier);
    current = nextParent as HTMLElement | null;
  }

  return parts.join(" > ");
}