@library/dom 0.0.6

package/coverage/lcov-report/sorter.js

@@ -0,0 +1,205 @@
+/* eslint-disable */
+var addSorting = (function () {
+  "use strict";
+  var cols,
+    currentSort = {
+      index: 0,
+      desc: false,
+    };
+
+  // returns the summary table element
+  function getTable() {
+    return document.querySelector(".coverage-summary");
+  }
+  // returns the thead element of the summary table
+  function getTableHeader() {
+    return getTable().querySelector("thead tr");
+  }
+  // returns the tbody element of the summary table
+  function getTableBody() {
+    return getTable().querySelector("tbody");
+  }
+  // returns the th element for nth column
+  function getNthColumn(n) {
+    return getTableHeader().querySelectorAll("th")[n];
+  }
+
+  function onFilterInput() {
+    const searchValue = document.getElementById("fileSearch").value;
+    const rows = document.getElementsByTagName("tbody")[0].children;
+
+    // Try to create a RegExp from the searchValue. If it fails (invalid regex),
+    // it will be treated as a plain text search
+    let searchRegex;
+    try {
+      searchRegex = new RegExp(searchValue, "i"); // 'i' for case-insensitive
+    } catch (error) {
+      searchRegex = null;
+    }
+
+    for (let i = 0; i < rows.length; i++) {
+      const row = rows[i];
+      let isMatch = false;
+
+      if (searchRegex) {
+        // If a valid regex was created, use it for matching
+        isMatch = searchRegex.test(row.textContent);
+      } else {
+        // Otherwise, fall back to the original plain text search
+        isMatch = row.textContent.toLowerCase().includes(searchValue.toLowerCase());
+      }
+
+      row.style.display = isMatch ? "" : "none";
+    }
+  }
+
+  // loads the search box
+  function addSearchBox() {
+    var template = document.getElementById("filterTemplate");
+    var templateClone = template.content.cloneNode(true);
+    templateClone.getElementById("fileSearch").oninput = onFilterInput;
+    template.parentElement.appendChild(templateClone);
+  }
+
+  // loads all columns
+  function loadColumns() {
+    var colNodes = getTableHeader().querySelectorAll("th"),
+      colNode,
+      cols = [],
+      col,
+      i;
+
+    for (i = 0; i < colNodes.length; i += 1) {
+      colNode = colNodes[i];
+      col = {
+        key: colNode.getAttribute("data-col"),
+        sortable: !colNode.getAttribute("data-nosort"),
+        type: colNode.getAttribute("data-type") || "string",
+      };
+      cols.push(col);
+      if (col.sortable) {
+        col.defaultDescSort = col.type === "number";
+        colNode.innerHTML = colNode.innerHTML + '<span class="sorter"></span>';
+      }
+    }
+    return cols;
+  }
+  // attaches a data attribute to every tr element with an object
+  // of data values keyed by column name
+  function loadRowData(tableRow) {
+    var tableCols = tableRow.querySelectorAll("td"),
+      colNode,
+      col,
+      data = {},
+      i,
+      val;
+    for (i = 0; i < tableCols.length; i += 1) {
+      colNode = tableCols[i];
+      col = cols[i];
+      val = colNode.getAttribute("data-value");
+      if (col.type === "number") {
+        val = Number(val);
+      }
+      data[col.key] = val;
+    }
+    return data;
+  }
+  // loads all row data
+  function loadData() {
+    var rows = getTableBody().querySelectorAll("tr"),
+      i;
+
+    for (i = 0; i < rows.length; i += 1) {
+      rows[i].data = loadRowData(rows[i]);
+    }
+  }
+  // sorts the table using the data for the ith column
+  function sortByIndex(index, desc) {
+    var key = cols[index].key,
+      sorter = function (a, b) {
+        a = a.data[key];
+        b = b.data[key];
+        return a < b ? -1 : a > b ? 1 : 0;
+      },
+      finalSorter = sorter,
+      tableBody = document.querySelector(".coverage-summary tbody"),
+      rowNodes = tableBody.querySelectorAll("tr"),
+      rows = [],
+      i;
+
+    if (desc) {
+      finalSorter = function (a, b) {
+        return -1 * sorter(a, b);
+      };
+    }
+
+    for (i = 0; i < rowNodes.length; i += 1) {
+      rows.push(rowNodes[i]);
+      tableBody.removeChild(rowNodes[i]);
+    }
+
+    rows.sort(finalSorter);
+
+    for (i = 0; i < rows.length; i += 1) {
+      tableBody.appendChild(rows[i]);
+    }
+  }
+  // removes sort indicators for current column being sorted
+  function removeSortIndicators() {
+    var col = getNthColumn(currentSort.index),
+      cls = col.className;
+
+    cls = cls.replace(/ sorted$/, "").replace(/ sorted-desc$/, "");
+    col.className = cls;
+  }
+  // adds sort indicators for current column being sorted
+  function addSortIndicators() {
+    getNthColumn(currentSort.index).className += currentSort.desc ? " sorted-desc" : " sorted";
+  }
+  // adds event listeners for all sorter widgets
+  function enableUI() {
+    var i,
+      el,
+      ithSorter = function ithSorter(i) {
+        var col = cols[i];
+
+        return function () {
+          var desc = col.defaultDescSort;
+
+          if (currentSort.index === i) {
+            desc = !currentSort.desc;
+          }
+          sortByIndex(i, desc);
+          removeSortIndicators();
+          currentSort.index = i;
+          currentSort.desc = desc;
+          addSortIndicators();
+        };
+      };
+    for (i = 0; i < cols.length; i += 1) {
+      if (cols[i].sortable) {
+        // add the click event handler on the th so users
+        // dont have to click on those tiny arrows
+        el = getNthColumn(i).querySelector(".sorter").parentElement;
+        if (el.addEventListener) {
+          el.addEventListener("click", ithSorter(i));
+        } else {
+          el.attachEvent("onclick", ithSorter(i));
+        }
+      }
+    }
+  }
+  // adds sorting functionality to the UI
+  return function () {
+    if (!getTable()) {
+      return;
+    }
+    cols = loadColumns();
+    loadData();
+    addSearchBox();
+    addSortIndicators();
+    enableUI();
+  };
+})();
+
+window.addEventListener("load", addSorting);

package/coverage/lcov-report/uniqueSelectorOf.ts.html

@@ -0,0 +1,322 @@
+
+<!doctype html>
+<html lang="en">
+
+<head>
+    <title>Code coverage report for uniqueSelectorOf.ts</title>
+    <meta charset="utf-8" />
+    <link rel="stylesheet" href="prettify.css" />
+    <link rel="stylesheet" href="base.css" />
+    <link rel="shortcut icon" type="image/x-icon" href="favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <style type='text/css'>
+        .coverage-summary .sorter {
+            background-image: url(sort-arrow-sprite.png);
+        }
+    </style>
+</head>
+    
+<body>
+<div class='wrapper'>
+    <div class='pad1'>
+        <h1><a href="index.html">All files</a> uniqueSelectorOf.ts</h1>
+        <div class='clearfix'>
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Statements</span>
+                <span class='fraction'>32/32</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Branches</span>
+                <span class='fraction'>20/20</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Functions</span>
+                <span class='fraction'>3/3</span>
+            </div>
+        
+            
+            <div class='fl pad1y space-right2'>
+                <span class="strong">100% </span>
+                <span class="quiet">Lines</span>
+                <span class='fraction'>31/31</span>
+            </div>
+        
+            
+        </div>
+        <p class="quiet">
+            Press <em>n</em> or <em>j</em> to go to the next uncovered block, <em>b</em>, <em>p</em> or <em>k</em> for the previous block.
+        </p>
+        <template id="filterTemplate">
+            <div class="quiet">
+                Filter:
+                <input type="search" id="fileSearch">
+            </div>
+        </template>
+    </div>
+    <div class='status-line high'></div>
+    <pre><table class="coverage">
+<tr><td class="line-count quiet"><a name='L1'></a><a href='#L1'>1</a>
+<a name='L2'></a><a href='#L2'>2</a>
+<a name='L3'></a><a href='#L3'>3</a>
+<a name='L4'></a><a href='#L4'>4</a>
+<a name='L5'></a><a href='#L5'>5</a>
+<a name='L6'></a><a href='#L6'>6</a>
+<a name='L7'></a><a href='#L7'>7</a>
+<a name='L8'></a><a href='#L8'>8</a>
+<a name='L9'></a><a href='#L9'>9</a>
+<a name='L10'></a><a href='#L10'>10</a>
+<a name='L11'></a><a href='#L11'>11</a>
+<a name='L12'></a><a href='#L12'>12</a>
+<a name='L13'></a><a href='#L13'>13</a>
+<a name='L14'></a><a href='#L14'>14</a>
+<a name='L15'></a><a href='#L15'>15</a>
+<a name='L16'></a><a href='#L16'>16</a>
+<a name='L17'></a><a href='#L17'>17</a>
+<a name='L18'></a><a href='#L18'>18</a>
+<a name='L19'></a><a href='#L19'>19</a>
+<a name='L20'></a><a href='#L20'>20</a>
+<a name='L21'></a><a href='#L21'>21</a>
+<a name='L22'></a><a href='#L22'>22</a>
+<a name='L23'></a><a href='#L23'>23</a>
+<a name='L24'></a><a href='#L24'>24</a>
+<a name='L25'></a><a href='#L25'>25</a>
+<a name='L26'></a><a href='#L26'>26</a>
+<a name='L27'></a><a href='#L27'>27</a>
+<a name='L28'></a><a href='#L28'>28</a>
+<a name='L29'></a><a href='#L29'>29</a>
+<a name='L30'></a><a href='#L30'>30</a>
+<a name='L31'></a><a href='#L31'>31</a>
+<a name='L32'></a><a href='#L32'>32</a>
+<a name='L33'></a><a href='#L33'>33</a>
+<a name='L34'></a><a href='#L34'>34</a>
+<a name='L35'></a><a href='#L35'>35</a>
+<a name='L36'></a><a href='#L36'>36</a>
+<a name='L37'></a><a href='#L37'>37</a>
+<a name='L38'></a><a href='#L38'>38</a>
+<a name='L39'></a><a href='#L39'>39</a>
+<a name='L40'></a><a href='#L40'>40</a>
+<a name='L41'></a><a href='#L41'>41</a>
+<a name='L42'></a><a href='#L42'>42</a>
+<a name='L43'></a><a href='#L43'>43</a>
+<a name='L44'></a><a href='#L44'>44</a>
+<a name='L45'></a><a href='#L45'>45</a>
+<a name='L46'></a><a href='#L46'>46</a>
+<a name='L47'></a><a href='#L47'>47</a>
+<a name='L48'></a><a href='#L48'>48</a>
+<a name='L49'></a><a href='#L49'>49</a>
+<a name='L50'></a><a href='#L50'>50</a>
+<a name='L51'></a><a href='#L51'>51</a>
+<a name='L52'></a><a href='#L52'>52</a>
+<a name='L53'></a><a href='#L53'>53</a>
+<a name='L54'></a><a href='#L54'>54</a>
+<a name='L55'></a><a href='#L55'>55</a>
+<a name='L56'></a><a href='#L56'>56</a>
+<a name='L57'></a><a href='#L57'>57</a>
+<a name='L58'></a><a href='#L58'>58</a>
+<a name='L59'></a><a href='#L59'>59</a>
+<a name='L60'></a><a href='#L60'>60</a>
+<a name='L61'></a><a href='#L61'>61</a>
+<a name='L62'></a><a href='#L62'>62</a>
+<a name='L63'></a><a href='#L63'>63</a>
+<a name='L64'></a><a href='#L64'>64</a>
+<a name='L65'></a><a href='#L65'>65</a>
+<a name='L66'></a><a href='#L66'>66</a>
+<a name='L67'></a><a href='#L67'>67</a>
+<a name='L68'></a><a href='#L68'>68</a>
+<a name='L69'></a><a href='#L69'>69</a>
+<a name='L70'></a><a href='#L70'>70</a>
+<a name='L71'></a><a href='#L71'>71</a>
+<a name='L72'></a><a href='#L72'>72</a>
+<a name='L73'></a><a href='#L73'>73</a>
+<a name='L74'></a><a href='#L74'>74</a>
+<a name='L75'></a><a href='#L75'>75</a>
+<a name='L76'></a><a href='#L76'>76</a>
+<a name='L77'></a><a href='#L77'>77</a>
+<a name='L78'></a><a href='#L78'>78</a>
+<a name='L79'></a><a href='#L79'>79</a>
+<a name='L80'></a><a href='#L80'>80</a></td><td class="line-coverage quiet"><span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">21x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">6x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">6x</span>
+<span class="cline-any cline-yes">9x</span>
+<span class="cline-any cline-yes">9x</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">3x</span>
+<span class="cline-any cline-yes">4x</span>
+<span class="cline-any cline-yes">2x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">16x</span>
+<span class="cline-any cline-yes">16x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">16x</span>
+<span class="cline-any cline-yes">22x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">22x</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">37x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">20x</span>
+<span class="cline-any cline-yes">14x</span>
+<span class="cline-any cline-yes">14x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">22x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">22x</span>
+<span class="cline-any cline-yes">22x</span>
+<span class="cline-any cline-yes">14x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">8x</span>
+<span class="cline-any cline-yes">8x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">/**
+ * Generate the shortest unique querySelector string that identifies the given element.
+ * Priority: id &gt; unique class &gt; path with nth-of-type
+ * @param {HTMLElement} element - The HTML element to generate a query selector for.
+ * @returns {string | null} - A unique query selector string that can be used with document.querySelector.
+ * @example
+ * ```
+ * import { queryKeyOf } from "@library/dom";
+ *
+ * const el = document.getElementById('myId');
+ * queryKeyOf(el); // "#myId"
+ *
+ * const el2 = document.querySelector('.unique-class');
+ * queryKeyOf(el2); // ".unique-class"
+ * ```
+ */
+export function uniqueSelectorOf(element: HTMLElement): string | null {
+  // 1. ID is the shortest and always unique
+  if (element.id) {
+    return `#${element.id}`;
+  }
+&nbsp;
+  // 2. Check for unique class combinations
+  if (element.className) {
+    const classes = element.className.trim().split(/\s+/).filter(Boolean);
+&nbsp;
+    // Try single classes first
+    for (const cls of classes) {
+      const selector = `.${cls}`;
+      if (document.querySelectorAll(selector).length === 1) {
+        return selector;
+      }
+    }
+&nbsp;
+    // Try class combinations
+    if (classes.length &gt; 1) {
+      const selector = classes.map((c) =&gt; `.${c}`).join("");
+      if (document.querySelectorAll(selector).length === 1) {
+        return selector;
+      }
+    }
+  }
+&nbsp;
+  // 3. Build path from root until unique
+  const path: string[] = [];
+  let current: HTMLElement | null = element;
+&nbsp;
+  while (current &amp;&amp; current.nodeType === Node.ELEMENT_NODE) {
+    let selector = current.tagName.toLowerCase();
+&nbsp;
+    // If parent exists, add nth-of-type
+    if (current.parentElement) {
+      const siblings = Array.from(current.parentElement.children).filter(
+        (el) =&gt; el.tagName === current!.tagName,
+      );
+&nbsp;
+      if (siblings.length &gt; 1) {
+        const index = siblings.indexOf(current) + 1;
+        selector += `:nth-of-type(${index})`;
+      }
+    }
+&nbsp;
+    path.unshift(selector);
+&nbsp;
+    // Check if current path is unique
+    const currentPath = path.join(" &gt; ");
+    if (document.querySelectorAll(currentPath).length === 1) {
+      return currentPath;
+    }
+&nbsp;
+    // Move to parent, but stop at elements with ID
+    current = current.parentElement;
+    if (current?.id) {
+      path.unshift(`#${current.id}`);
+      return path.join(" &gt; ");
+    }
+  }
+  return null;
+}
+&nbsp;</pre></td></tr></table></pre>
+
+                <div class='push'></div><!-- for sticky footer -->
+            </div><!-- /wrapper -->
+            <div class='footer quiet pad2 space-top1 center small'>
+                Code coverage generated by
+                <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
+                at 2026-10-04T09:32:32.477Z
+            </div>
+        <script src="prettify.js"></script>
+        <script>
+            window.onload = function () {
+                prettyPrint();
+            };
+        </script>
+        <script src="sorter.js"></script>
+        <script src="block-navigation.js"></script>
+    </body>
+</html>
+    

package/coverage/lcov.info

@@ -0,0 +1,75 @@
+TN:
+SF:src/index.ts
+FNF:0
+FNH:0
+LF:0
+LH:0
+BRF:0
+BRH:0
+end_of_record
+TN:
+SF:src/uniqueSelectorOf.ts
+FN:17,uniqueSelectorOf
+FN:37,(anonymous_1)
+FN:54,(anonymous_2)
+FNF:3
+FNH:3
+FNDA:21,uniqueSelectorOf
+FNDA:4,(anonymous_1)
+FNDA:37,(anonymous_2)
+DA:19,21
+DA:20,1
+DA:24,20
+DA:25,6
+DA:28,6
+DA:29,9
+DA:30,9
+DA:31,3
+DA:36,3
+DA:37,4
+DA:38,2
+DA:39,1
+DA:45,16
+DA:46,16
+DA:48,16
+DA:49,22
+DA:52,22
+DA:53,20
+DA:54,37
+DA:57,20
+DA:58,14
+DA:59,14
+DA:63,22
+DA:66,22
+DA:67,22
+DA:68,14
+DA:72,8
+DA:73,8
+DA:74,1
+DA:75,1
+DA:78,1
+LF:31
+LH:31
+BRDA:19,0,0,1
+BRDA:19,0,1,20
+BRDA:24,1,0,6
+BRDA:24,1,1,14
+BRDA:30,2,0,3
+BRDA:30,2,1,6
+BRDA:36,3,0,2
+BRDA:36,3,1,1
+BRDA:38,4,0,1
+BRDA:38,4,1,1
+BRDA:48,5,0,16
+BRDA:48,5,1,22
+BRDA:52,6,0,20
+BRDA:52,6,1,2
+BRDA:57,7,0,14
+BRDA:57,7,1,6
+BRDA:67,8,0,14
+BRDA:67,8,1,8
+BRDA:73,9,0,1
+BRDA:73,9,1,7
+BRF:20
+BRH:20
+end_of_record

package/dist/cjs/index.cjs

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var u=Object.getOwnPropertyNames;var a=Object.prototype.hasOwnProperty;var m=(n,t)=>{for(var e in t)s(n,e,{get:t[e],enumerable:!0})},d=(n,t,e,l)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of u(t))!a.call(n,r)&&r!==e&&s(n,r,{get:()=>t[r],enumerable:!(l=f(t,r))||l.enumerable});return n};var h=n=>d(s({},"__esModule",{value:!0}),n);var g={};m(g,{uniqueSelectorOf:()=>c});module.exports=h(g);function c(n){if(n.id)return`#${n.id}`;if(n.className){let l=n.className.trim().split(/\s+/).filter(Boolean);for(let r of l){let o=`.${r}`;if(document.querySelectorAll(o).length===1)return o}if(l.length>1){let r=l.map(o=>`.${o}`).join("");if(document.querySelectorAll(r).length===1)return r}}let t=[],e=n;for(;e&&e.nodeType===Node.ELEMENT_NODE;){let l=e.tagName.toLowerCase();if(e.parentElement){let o=Array.from(e.parentElement.children).filter(i=>i.tagName===e.tagName);if(o.length>1){let i=o.indexOf(e)+1;l+=`:nth-of-type(${i})`}}t.unshift(l);let r=t.join(" > ");if(document.querySelectorAll(r).length===1)return r;if(e=e.parentElement,e!=null&&e.id)return t.unshift(`#${e.id}`),t.join(" > ")}return null}0&&(module.exports={uniqueSelectorOf});

package/dist/cjs/index.d.cts

@@ -0,0 +1,19 @@
+/**
+ * Generate the shortest unique querySelector string that identifies the given element.
+ * Priority: id > unique class > path with nth-of-type
+ * @param {HTMLElement} element - The HTML element to generate a query selector for.
+ * @returns {string | null} - A unique query selector string that can be used with document.querySelector.
+ * @example
+ * ```
+ * import { queryKeyOf } from "@library/dom";
+ *
+ * const el = document.getElementById('myId');
+ * queryKeyOf(el); // "#myId"
+ *
+ * const el2 = document.querySelector('.unique-class');
+ * queryKeyOf(el2); // ".unique-class"
+ * ```
+ */
+declare function uniqueSelectorOf(element: HTMLElement): string | null;
+
+export { uniqueSelectorOf };

package/dist/esm/chunk-GHJADCBS.js

@@ -0,0 +1 @@
+function s(l){if(l.id)return`#${l.id}`;if(l.className){let r=l.className.trim().split(/\s+/).filter(Boolean);for(let t of r){let n=`.${t}`;if(document.querySelectorAll(n).length===1)return n}if(r.length>1){let t=r.map(n=>`.${n}`).join("");if(document.querySelectorAll(t).length===1)return t}}let o=[],e=l;for(;e&&e.nodeType===Node.ELEMENT_NODE;){let r=e.tagName.toLowerCase();if(e.parentElement){let n=Array.from(e.parentElement.children).filter(i=>i.tagName===e.tagName);if(n.length>1){let i=n.indexOf(e)+1;r+=`:nth-of-type(${i})`}}o.unshift(r);let t=o.join(" > ");if(document.querySelectorAll(t).length===1)return t;if(e=e.parentElement,e?.id)return o.unshift(`#${e.id}`),o.join(" > ")}return null}export{s as a};

package/dist/esm/index.d.ts

@@ -0,0 +1 @@
+export { uniqueSelectorOf } from './uniqueSelectorOf.js';

package/dist/esm/index.js

@@ -0,0 +1 @@
+import{a as e}from"./chunk-GHJADCBS.js";export{e as uniqueSelectorOf};

package/dist/esm/uniqueSelectorOf.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generate the shortest unique querySelector string that identifies the given element.
+ * Priority: id > unique class > path with nth-of-type
+ * @param {HTMLElement} element - The HTML element to generate a query selector for.
+ * @returns {string | null} - A unique query selector string that can be used with document.querySelector.
+ * @example
+ * ```
+ * import { queryKeyOf } from "@library/dom";
+ *
+ * const el = document.getElementById('myId');
+ * queryKeyOf(el); // "#myId"
+ *
+ * const el2 = document.querySelector('.unique-class');
+ * queryKeyOf(el2); // ".unique-class"
+ * ```
+ */
+declare function uniqueSelectorOf(element: HTMLElement): string | null;
+
+export { uniqueSelectorOf };

package/dist/esm/uniqueSelectorOf.js

@@ -0,0 +1 @@
+import{a}from"./chunk-GHJADCBS.js";export{a as uniqueSelectorOf};