grab 0.1.35 → 0.1.36

package/dist/create-element-selector-ChuWL5x4.cjs

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ *
+ * Copyright (c) 2025 Aiden Bai
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+const e=require(`./freeze-updates-F-dFqbvY.cjs`),t=e=>e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`),n=(n,r)=>{let i=r?.componentName??`div`,a={version:e.pt,content:n,entries:r?.entries??[{tagName:r?.tagName,componentName:i,content:n,commentText:r?.commentText}],timestamp:Date.now()},o=e=>{e.preventDefault(),e.clipboardData?.setData(`text/plain`,n),e.clipboardData?.setData(`text/html`,`<meta charset='utf-8'><pre><code>${t(n)}</code></pre>`),e.clipboardData?.setData(`application/x-react-grab`,JSON.stringify(a))};document.addEventListener(`copy`,o);let s=document.createElement(`textarea`);s.value=n,s.style.position=`fixed`,s.style.left=`-9999px`,s.ariaHidden=`true`,document.body.appendChild(s),s.select();try{return typeof document.execCommand==`function`?document.execCommand(`copy`):!1}finally{document.removeEventListener(`copy`,o),s.remove()}},r=new Set([`role`,`name`,`aria-label`,`rel`,`href`]),i=e=>{if(!/^[a-z-]{3,}$/i.test(e))return!1;let t=e.split(/-|[A-Z]/);for(let e of t)if(e.length<=2||/[^aeiou]{4,}/i.test(e))return!1;return!0},a=(e,t)=>{let n=r.has(e)||e.startsWith(`data-`)&&i(e),a=i(t)&&t.length<100||t.startsWith(`#`)&&i(t.slice(1));return n&&a},o=e=>{let t=e[0].name;for(let n=1;n<e.length;n++)t=`${e[n].name} > ${t}`;return t},s=e=>{let t=0;for(let n of e)t+=n.penalty;return t},c=(e,t)=>s(e)-s(t),l=(e,t)=>{let n=e.parentNode;if(!n)return;let r=n.firstChild;if(!r)return;let i=0;for(;r&&(r.nodeType===Node.ELEMENT_NODE&&(t===void 0||r.tagName.toLowerCase()===t)&&i++,r!==e);)r=r.nextSibling;return i},u=(e,t)=>e===`html`?`html`:`${e}:nth-child(${t})`,d=(e,t)=>e===`html`?`html`:`${e}:nth-of-type(${t})`,f=(e,t)=>{let n=[],r=e.getAttribute(`id`),a=e.tagName.toLowerCase();r&&i(r)&&n.push({name:`#${CSS.escape(r)}`,penalty:0});for(let t of e.classList)i(t)&&n.push({name:`.${CSS.escape(t)}`,penalty:1});for(let r of e.attributes)t(r.name,r.value)&&n.push({name:`[${CSS.escape(r.name)}="${CSS.escape(r.value)}"]`,penalty:2});n.push({name:a,penalty:5});let o=l(e,a);o!==void 0&&n.push({name:d(a,o),penalty:10});let s=l(e);return s!==void 0&&n.push({name:u(a,s),penalty:50}),n},p=(t,n=e.X,r=[])=>{if(n<=0)return[];if(t.length===0)return[r];let i=[];for(let e of t[0]){let a=n-i.length;if(a<=0)break;i.push(...p(t.slice(1),a,[...r,e]))}return i},m=(e,t)=>{let n=t.getRootNode?.();return n instanceof ShadowRoot?n:e.nodeType===Node.DOCUMENT_NODE?e:e.ownerDocument},h=(e,t)=>t.querySelectorAll(o(e)).length===1,g=(e,t)=>{let n=e,r=[];for(;n&&n!==t;){let e=n.tagName.toLowerCase(),t=l(n,e);if(t===void 0)return;r.push({name:d(e,t),penalty:10}),n=n.parentElement}return h(r,t)?r:void 0},_=(e,t,n,r)=>{if(e.nodeType!==Node.ELEMENT_NODE)throw Error(`Can't generate CSS selector for non-element node type.`);if(e.tagName.toLowerCase()===`html`)return`html`;let i=m(t,e),a=Date.now(),s=[],l=e,u=0,d;for(;l&&l!==i&&!d;)if(s.push(f(l,r)),l=l.parentElement,u++,u>=3){let t=p(s);t.sort(c);for(let r of t){if(Date.now()-a>n){let t=g(e,i);if(!t)throw Error(`Timeout: Can't find a unique selector after ${n}ms`);return o(t)}if(h(r,i)){d=r;break}}}if(!d&&u<3){let e=p(s);e.sort(c);for(let t of e){if(Date.now()-a>n)break;if(h(t,i)){d=t;break}}}if(!d)throw Error(`Selector was not found.`);return o(d)},v=e=>typeof CSS<`u`&&typeof CSS.escape==`function`?CSS.escape(e):e.replace(/[^a-zA-Z0-9_-]/g,e=>`\\${e}`),y=e=>e.ownerDocument.body??e.ownerDocument.documentElement,b=new Set([`data-testid`,`data-test-id`,`data-test`,`data-cy`,`data-qa`,`aria-label`,`role`,`name`,`title`,`alt`]),x=e=>e.length>0&&e.length<=120,S=(e,t)=>{try{let n=e.ownerDocument.querySelectorAll(t);return n.length===1&&n[0]===e}catch{return!1}},C=e=>{if(e instanceof HTMLElement&&e.id){let t=`#${v(e.id)}`;if(S(e,t))return t}for(let t of b){let n=e.getAttribute(t);if(!n||!x(n))continue;let r=`[${t}=${JSON.stringify(n)}]`;if(S(e,r))return r;let i=`${e.tagName.toLowerCase()}${r}`;if(S(e,i))return i}return null},w=e=>{let t=[],n=y(e),r=e;for(;r;){if(r instanceof HTMLElement&&r.id){t.unshift(`#${v(r.id)}`);break}let e=r.parentElement;if(!e){t.unshift(r.tagName.toLowerCase());break}let i=Array.from(e.children).indexOf(r),a=i>=0?i+1:1;if(t.unshift(`${r.tagName.toLowerCase()}:nth-child(${a})`),e===n){t.unshift(n.tagName.toLowerCase());break}r=e}return t.join(` > `)},T=(e,t=!0)=>{let n=C(e);if(n)return n;if(t)try{let t=_(e,y(e),200,(e,t)=>a(e,t)||b.has(e)&&x(t));if(t)return t}catch{}return w(e)};Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return T}});

package/dist/create-element-selector-CufggNcJ.js

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ *
+ * Copyright (c) 2025 Aiden Bai
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import{Y as e,ft as t}from"./freeze-updates-D7wc1FFo.js";const n=e=>e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`),r=(e,r)=>{let i=r?.componentName??`div`,a={version:t,content:e,entries:r?.entries??[{tagName:r?.tagName,componentName:i,content:e,commentText:r?.commentText}],timestamp:Date.now()},o=t=>{t.preventDefault(),t.clipboardData?.setData(`text/plain`,e),t.clipboardData?.setData(`text/html`,`<meta charset='utf-8'><pre><code>${n(e)}</code></pre>`),t.clipboardData?.setData(`application/x-react-grab`,JSON.stringify(a))};document.addEventListener(`copy`,o);let s=document.createElement(`textarea`);s.value=e,s.style.position=`fixed`,s.style.left=`-9999px`,s.ariaHidden=`true`,document.body.appendChild(s),s.select();try{return typeof document.execCommand==`function`?document.execCommand(`copy`):!1}finally{document.removeEventListener(`copy`,o),s.remove()}},i=new Set([`role`,`name`,`aria-label`,`rel`,`href`]),a=e=>{if(!/^[a-z-]{3,}$/i.test(e))return!1;let t=e.split(/-|[A-Z]/);for(let e of t)if(e.length<=2||/[^aeiou]{4,}/i.test(e))return!1;return!0},o=(e,t)=>{let n=i.has(e)||e.startsWith(`data-`)&&a(e),r=a(t)&&t.length<100||t.startsWith(`#`)&&a(t.slice(1));return n&&r},s=e=>{let t=e[0].name;for(let n=1;n<e.length;n++)t=`${e[n].name} > ${t}`;return t},c=e=>{let t=0;for(let n of e)t+=n.penalty;return t},l=(e,t)=>c(e)-c(t),u=(e,t)=>{let n=e.parentNode;if(!n)return;let r=n.firstChild;if(!r)return;let i=0;for(;r&&(r.nodeType===Node.ELEMENT_NODE&&(t===void 0||r.tagName.toLowerCase()===t)&&i++,r!==e);)r=r.nextSibling;return i},d=(e,t)=>e===`html`?`html`:`${e}:nth-child(${t})`,f=(e,t)=>e===`html`?`html`:`${e}:nth-of-type(${t})`,p=(e,t)=>{let n=[],r=e.getAttribute(`id`),i=e.tagName.toLowerCase();r&&a(r)&&n.push({name:`#${CSS.escape(r)}`,penalty:0});for(let t of e.classList)a(t)&&n.push({name:`.${CSS.escape(t)}`,penalty:1});for(let r of e.attributes)t(r.name,r.value)&&n.push({name:`[${CSS.escape(r.name)}="${CSS.escape(r.value)}"]`,penalty:2});n.push({name:i,penalty:5});let o=u(e,i);o!==void 0&&n.push({name:f(i,o),penalty:10});let s=u(e);return s!==void 0&&n.push({name:d(i,s),penalty:50}),n},m=(t,n=e,r=[])=>{if(n<=0)return[];if(t.length===0)return[r];let i=[];for(let e of t[0]){let a=n-i.length;if(a<=0)break;i.push(...m(t.slice(1),a,[...r,e]))}return i},h=(e,t)=>{let n=t.getRootNode?.();return n instanceof ShadowRoot?n:e.nodeType===Node.DOCUMENT_NODE?e:e.ownerDocument},g=(e,t)=>t.querySelectorAll(s(e)).length===1,_=(e,t)=>{let n=e,r=[];for(;n&&n!==t;){let e=n.tagName.toLowerCase(),t=u(n,e);if(t===void 0)return;r.push({name:f(e,t),penalty:10}),n=n.parentElement}return g(r,t)?r:void 0},v=(e,t,n,r)=>{if(e.nodeType!==Node.ELEMENT_NODE)throw Error(`Can't generate CSS selector for non-element node type.`);if(e.tagName.toLowerCase()===`html`)return`html`;let i=h(t,e),a=Date.now(),o=[],c=e,u=0,d;for(;c&&c!==i&&!d;)if(o.push(p(c,r)),c=c.parentElement,u++,u>=3){let t=m(o);t.sort(l);for(let r of t){if(Date.now()-a>n){let t=_(e,i);if(!t)throw Error(`Timeout: Can't find a unique selector after ${n}ms`);return s(t)}if(g(r,i)){d=r;break}}}if(!d&&u<3){let e=m(o);e.sort(l);for(let t of e){if(Date.now()-a>n)break;if(g(t,i)){d=t;break}}}if(!d)throw Error(`Selector was not found.`);return s(d)},y=e=>typeof CSS<`u`&&typeof CSS.escape==`function`?CSS.escape(e):e.replace(/[^a-zA-Z0-9_-]/g,e=>`\\${e}`),b=e=>e.ownerDocument.body??e.ownerDocument.documentElement,x=new Set([`data-testid`,`data-test-id`,`data-test`,`data-cy`,`data-qa`,`aria-label`,`role`,`name`,`title`,`alt`]),S=e=>e.length>0&&e.length<=120,C=(e,t)=>{try{let n=e.ownerDocument.querySelectorAll(t);return n.length===1&&n[0]===e}catch{return!1}},w=e=>{if(e instanceof HTMLElement&&e.id){let t=`#${y(e.id)}`;if(C(e,t))return t}for(let t of x){let n=e.getAttribute(t);if(!n||!S(n))continue;let r=`[${t}=${JSON.stringify(n)}]`;if(C(e,r))return r;let i=`${e.tagName.toLowerCase()}${r}`;if(C(e,i))return i}return null},T=e=>{let t=[],n=b(e),r=e;for(;r;){if(r instanceof HTMLElement&&r.id){t.unshift(`#${y(r.id)}`);break}let e=r.parentElement;if(!e){t.unshift(r.tagName.toLowerCase());break}let i=Array.from(e.children).indexOf(r),a=i>=0?i+1:1;if(t.unshift(`${r.tagName.toLowerCase()}:nth-child(${a})`),e===n){t.unshift(n.tagName.toLowerCase());break}r=e}return t.join(` > `)},E=(e,t=!0)=>{let n=w(e);if(n)return n;if(t)try{let t=v(e,b(e),200,(e,t)=>o(e,t)||x.has(e)&&S(t));if(t)return t}catch{}return T(e)};export{r as n,E as t};

package/dist/create-element-selector-D1FizysC.js

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ *
+ * Copyright (c) 2025 Aiden Bai
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import{X as e,pt as t}from"./freeze-updates-DFjQ3htO.js";const n=e=>e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`),r=(e,r)=>{let i=r?.componentName??`div`,a={version:t,content:e,entries:r?.entries??[{tagName:r?.tagName,componentName:i,content:e,commentText:r?.commentText}],timestamp:Date.now()},o=t=>{t.preventDefault(),t.clipboardData?.setData(`text/plain`,e),t.clipboardData?.setData(`text/html`,`<meta charset='utf-8'><pre><code>${n(e)}</code></pre>`),t.clipboardData?.setData(`application/x-react-grab`,JSON.stringify(a))};document.addEventListener(`copy`,o);let s=document.createElement(`textarea`);s.value=e,s.style.position=`fixed`,s.style.left=`-9999px`,s.ariaHidden=`true`,document.body.appendChild(s),s.select();try{return typeof document.execCommand==`function`?document.execCommand(`copy`):!1}finally{document.removeEventListener(`copy`,o),s.remove()}},i=new Set([`role`,`name`,`aria-label`,`rel`,`href`]),a=e=>{if(!/^[a-z-]{3,}$/i.test(e))return!1;let t=e.split(/-|[A-Z]/);for(let e of t)if(e.length<=2||/[^aeiou]{4,}/i.test(e))return!1;return!0},o=(e,t)=>{let n=i.has(e)||e.startsWith(`data-`)&&a(e),r=a(t)&&t.length<100||t.startsWith(`#`)&&a(t.slice(1));return n&&r},s=e=>{let t=e[0].name;for(let n=1;n<e.length;n++)t=`${e[n].name} > ${t}`;return t},c=e=>{let t=0;for(let n of e)t+=n.penalty;return t},l=(e,t)=>c(e)-c(t),u=(e,t)=>{let n=e.parentNode;if(!n)return;let r=n.firstChild;if(!r)return;let i=0;for(;r&&(r.nodeType===Node.ELEMENT_NODE&&(t===void 0||r.tagName.toLowerCase()===t)&&i++,r!==e);)r=r.nextSibling;return i},d=(e,t)=>e===`html`?`html`:`${e}:nth-child(${t})`,f=(e,t)=>e===`html`?`html`:`${e}:nth-of-type(${t})`,p=(e,t)=>{let n=[],r=e.getAttribute(`id`),i=e.tagName.toLowerCase();r&&a(r)&&n.push({name:`#${CSS.escape(r)}`,penalty:0});for(let t of e.classList)a(t)&&n.push({name:`.${CSS.escape(t)}`,penalty:1});for(let r of e.attributes)t(r.name,r.value)&&n.push({name:`[${CSS.escape(r.name)}="${CSS.escape(r.value)}"]`,penalty:2});n.push({name:i,penalty:5});let o=u(e,i);o!==void 0&&n.push({name:f(i,o),penalty:10});let s=u(e);return s!==void 0&&n.push({name:d(i,s),penalty:50}),n},m=(t,n=e,r=[])=>{if(n<=0)return[];if(t.length===0)return[r];let i=[];for(let e of t[0]){let a=n-i.length;if(a<=0)break;i.push(...m(t.slice(1),a,[...r,e]))}return i},h=(e,t)=>{let n=t.getRootNode?.();return n instanceof ShadowRoot?n:e.nodeType===Node.DOCUMENT_NODE?e:e.ownerDocument},g=(e,t)=>t.querySelectorAll(s(e)).length===1,_=(e,t)=>{let n=e,r=[];for(;n&&n!==t;){let e=n.tagName.toLowerCase(),t=u(n,e);if(t===void 0)return;r.push({name:f(e,t),penalty:10}),n=n.parentElement}return g(r,t)?r:void 0},v=(e,t,n,r)=>{if(e.nodeType!==Node.ELEMENT_NODE)throw Error(`Can't generate CSS selector for non-element node type.`);if(e.tagName.toLowerCase()===`html`)return`html`;let i=h(t,e),a=Date.now(),o=[],c=e,u=0,d;for(;c&&c!==i&&!d;)if(o.push(p(c,r)),c=c.parentElement,u++,u>=3){let t=m(o);t.sort(l);for(let r of t){if(Date.now()-a>n){let t=_(e,i);if(!t)throw Error(`Timeout: Can't find a unique selector after ${n}ms`);return s(t)}if(g(r,i)){d=r;break}}}if(!d&&u<3){let e=m(o);e.sort(l);for(let t of e){if(Date.now()-a>n)break;if(g(t,i)){d=t;break}}}if(!d)throw Error(`Selector was not found.`);return s(d)},y=e=>typeof CSS<`u`&&typeof CSS.escape==`function`?CSS.escape(e):e.replace(/[^a-zA-Z0-9_-]/g,e=>`\\${e}`),b=e=>e.ownerDocument.body??e.ownerDocument.documentElement,x=new Set([`data-testid`,`data-test-id`,`data-test`,`data-cy`,`data-qa`,`aria-label`,`role`,`name`,`title`,`alt`]),S=e=>e.length>0&&e.length<=120,C=(e,t)=>{try{let n=e.ownerDocument.querySelectorAll(t);return n.length===1&&n[0]===e}catch{return!1}},w=e=>{if(e instanceof HTMLElement&&e.id){let t=`#${y(e.id)}`;if(C(e,t))return t}for(let t of x){let n=e.getAttribute(t);if(!n||!S(n))continue;let r=`[${t}=${JSON.stringify(n)}]`;if(C(e,r))return r;let i=`${e.tagName.toLowerCase()}${r}`;if(C(e,i))return i}return null},T=e=>{let t=[],n=b(e),r=e;for(;r;){if(r instanceof HTMLElement&&r.id){t.unshift(`#${y(r.id)}`);break}let e=r.parentElement;if(!e){t.unshift(r.tagName.toLowerCase());break}let i=Array.from(e.children).indexOf(r),a=i>=0?i+1:1;if(t.unshift(`${r.tagName.toLowerCase()}:nth-child(${a})`),e===n){t.unshift(n.tagName.toLowerCase());break}r=e}return t.join(` > `)},E=(e,t=!0)=>{let n=w(e);if(n)return n;if(t)try{let t=v(e,b(e),200,(e,t)=>o(e,t)||x.has(e)&&S(t));if(t)return t}catch{}return T(e)};export{r as n,E as t};

package/dist/create-element-selector-D4_cMOfX.cjs

@@ -0,0 +1,307 @@
+/**
+ * @license MIT
+ *
+ * Copyright (c) 2025 Aiden Bai
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+const require_freeze_updates = require('./freeze-updates-DC22uWxG.cjs');
+
+//#region src/utils/copy-content.ts
+const REACT_GRAB_MIME_TYPE = "application/x-react-grab";
+const escapeHtml = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+const copyContent = (content, options) => {
+	const elementName = options?.componentName ?? "div";
+	const reactGrabMetadata = {
+		version: require_freeze_updates.VERSION,
+		content,
+		entries: options?.entries ?? [{
+			tagName: options?.tagName,
+			componentName: elementName,
+			content,
+			commentText: options?.commentText
+		}],
+		timestamp: Date.now()
+	};
+	const copyHandler = (event) => {
+		event.preventDefault();
+		event.clipboardData?.setData("text/plain", content);
+		event.clipboardData?.setData("text/html", `<meta charset='utf-8'><pre><code>${escapeHtml(content)}</code></pre>`);
+		event.clipboardData?.setData(REACT_GRAB_MIME_TYPE, JSON.stringify(reactGrabMetadata));
+	};
+	document.addEventListener("copy", copyHandler);
+	const textarea = document.createElement("textarea");
+	textarea.value = content;
+	textarea.style.position = "fixed";
+	textarea.style.left = "-9999px";
+	textarea.ariaHidden = "true";
+	document.body.appendChild(textarea);
+	textarea.select();
+	try {
+		if (typeof document.execCommand !== "function") return false;
+		return document.execCommand("copy");
+	} finally {
+		document.removeEventListener("copy", copyHandler);
+		textarea.remove();
+	}
+};
+
+//#endregion
+//#region src/utils/find-unique-selector.ts
+const SEED_MIN_LENGTH = 3;
+const ATTR_VALUE_MAX_LENGTH_CHARS = 100;
+const PENALTY_ID = 0;
+const PENALTY_CLASS = 1;
+const PENALTY_ATTR = 2;
+const PENALTY_TAG = 5;
+const PENALTY_NTH_OF_TYPE = 10;
+const PENALTY_NTH_CHILD = 50;
+const ACCEPTED_ATTR_NAMES = new Set([
+	"role",
+	"name",
+	"aria-label",
+	"rel",
+	"href"
+]);
+const isWordLike = (text) => {
+	if (!/^[a-z-]{3,}$/i.test(text)) return false;
+	const segments = text.split(/-|[A-Z]/);
+	for (const segment of segments) {
+		if (segment.length <= 2) return false;
+		if (/[^aeiou]{4,}/i.test(segment)) return false;
+	}
+	return true;
+};
+const isAcceptedAttr = (attributeName, attributeValue) => {
+	const nameIsAccepted = ACCEPTED_ATTR_NAMES.has(attributeName) || attributeName.startsWith("data-") && isWordLike(attributeName);
+	const valueIsAccepted = isWordLike(attributeValue) && attributeValue.length < ATTR_VALUE_MAX_LENGTH_CHARS || attributeValue.startsWith("#") && isWordLike(attributeValue.slice(1));
+	return nameIsAccepted && valueIsAccepted;
+};
+const buildSelectorString = (path) => {
+	let result = path[0].name;
+	for (let index = 1; index < path.length; index++) result = `${path[index].name} > ${result}`;
+	return result;
+};
+const calculatePenalty = (path) => {
+	let total = 0;
+	for (const selectorNode of path) total += selectorNode.penalty;
+	return total;
+};
+const comparePenalty = (pathA, pathB) => calculatePenalty(pathA) - calculatePenalty(pathB);
+const getChildIndex = (element, filterTagName) => {
+	const parentNode = element.parentNode;
+	if (!parentNode) return void 0;
+	let sibling = parentNode.firstChild;
+	if (!sibling) return void 0;
+	let position = 0;
+	while (sibling) {
+		if (sibling.nodeType === Node.ELEMENT_NODE && (filterTagName === void 0 || sibling.tagName.toLowerCase() === filterTagName)) position++;
+		if (sibling === element) break;
+		sibling = sibling.nextSibling;
+	}
+	return position;
+};
+const formatNthChild = (tagName, childPosition) => tagName === "html" ? "html" : `${tagName}:nth-child(${childPosition})`;
+const formatNthOfType = (tagName, typePosition) => tagName === "html" ? "html" : `${tagName}:nth-of-type(${typePosition})`;
+const collectCandidateNodes = (element, attrFilter) => {
+	const candidates = [];
+	const elementId = element.getAttribute("id");
+	const elementTagName = element.tagName.toLowerCase();
+	if (elementId && isWordLike(elementId)) candidates.push({
+		name: `#${CSS.escape(elementId)}`,
+		penalty: PENALTY_ID
+	});
+	for (const className of element.classList) if (isWordLike(className)) candidates.push({
+		name: `.${CSS.escape(className)}`,
+		penalty: PENALTY_CLASS
+	});
+	for (const attribute of element.attributes) if (attrFilter(attribute.name, attribute.value)) candidates.push({
+		name: `[${CSS.escape(attribute.name)}="${CSS.escape(attribute.value)}"]`,
+		penalty: PENALTY_ATTR
+	});
+	candidates.push({
+		name: elementTagName,
+		penalty: PENALTY_TAG
+	});
+	const typePosition = getChildIndex(element, elementTagName);
+	if (typePosition !== void 0) candidates.push({
+		name: formatNthOfType(elementTagName, typePosition),
+		penalty: PENALTY_NTH_OF_TYPE
+	});
+	const childPosition = getChildIndex(element);
+	if (childPosition !== void 0) candidates.push({
+		name: formatNthChild(elementTagName, childPosition),
+		penalty: PENALTY_NTH_CHILD
+	});
+	return candidates;
+};
+const collectCombinations = (stack, budget = require_freeze_updates.MAX_SELECTOR_COMBINATIONS, currentPath = []) => {
+	if (budget <= 0) return [];
+	if (stack.length === 0) return [currentPath];
+	const results = [];
+	for (const selectorNode of stack[0]) {
+		const remainingBudget = budget - results.length;
+		if (remainingBudget <= 0) break;
+		results.push(...collectCombinations(stack.slice(1), remainingBudget, [...currentPath, selectorNode]));
+	}
+	return results;
+};
+const resolveRootDocument = (rootNode, targetElement) => {
+	const attachedRoot = targetElement.getRootNode?.();
+	if (attachedRoot instanceof ShadowRoot) return attachedRoot;
+	if (rootNode.nodeType === Node.DOCUMENT_NODE) return rootNode;
+	return rootNode.ownerDocument;
+};
+const isSelectorUnique = (selectorPath, rootDocument) => rootDocument.querySelectorAll(buildSelectorString(selectorPath)).length === 1;
+const buildFallbackPath = (targetElement, rootDocument) => {
+	let currentElement = targetElement;
+	const path = [];
+	while (currentElement && currentElement !== rootDocument) {
+		const currentTagName = currentElement.tagName.toLowerCase();
+		const typePosition = getChildIndex(currentElement, currentTagName);
+		if (typePosition === void 0) return void 0;
+		path.push({
+			name: formatNthOfType(currentTagName, typePosition),
+			penalty: PENALTY_NTH_OF_TYPE
+		});
+		currentElement = currentElement.parentElement;
+	}
+	return isSelectorUnique(path, rootDocument) ? path : void 0;
+};
+const findUniqueSelector = (targetElement, root, timeoutMs, attrFilter) => {
+	if (targetElement.nodeType !== Node.ELEMENT_NODE) throw new Error("Can't generate CSS selector for non-element node type.");
+	if (targetElement.tagName.toLowerCase() === "html") return "html";
+	const rootDocument = resolveRootDocument(root, targetElement);
+	const startTime = Date.now();
+	const ancestorStack = [];
+	let currentElement = targetElement;
+	let depth = 0;
+	let foundPath;
+	while (currentElement && currentElement !== rootDocument && !foundPath) {
+		ancestorStack.push(collectCandidateNodes(currentElement, attrFilter));
+		currentElement = currentElement.parentElement;
+		depth++;
+		if (depth >= SEED_MIN_LENGTH) {
+			const candidatePaths = collectCombinations(ancestorStack);
+			candidatePaths.sort(comparePenalty);
+			for (const candidatePath of candidatePaths) {
+				if (Date.now() - startTime > timeoutMs) {
+					const fallbackPath = buildFallbackPath(targetElement, rootDocument);
+					if (!fallbackPath) throw new Error(`Timeout: Can't find a unique selector after ${timeoutMs}ms`);
+					return buildSelectorString(fallbackPath);
+				}
+				if (isSelectorUnique(candidatePath, rootDocument)) {
+					foundPath = candidatePath;
+					break;
+				}
+			}
+		}
+	}
+	if (!foundPath && depth < SEED_MIN_LENGTH) {
+		const remainingPaths = collectCombinations(ancestorStack);
+		remainingPaths.sort(comparePenalty);
+		for (const candidatePath of remainingPaths) {
+			if (Date.now() - startTime > timeoutMs) break;
+			if (isSelectorUnique(candidatePath, rootDocument)) {
+				foundPath = candidatePath;
+				break;
+			}
+		}
+	}
+	if (!foundPath) throw new Error("Selector was not found.");
+	return buildSelectorString(foundPath);
+};
+
+//#endregion
+//#region src/utils/create-element-selector.ts
+const escapeCssIdentifier = (value) => {
+	if (typeof CSS !== "undefined" && typeof CSS.escape === "function") return CSS.escape(value);
+	return value.replace(/[^a-zA-Z0-9_-]/g, (character) => `\\${character}`);
+};
+const getFinderRoot = (element) => element.ownerDocument.body ?? element.ownerDocument.documentElement;
+const PREFERRED_SELECTOR_ATTRIBUTE_NAMES = new Set([
+	"data-testid",
+	"data-test-id",
+	"data-test",
+	"data-cy",
+	"data-qa",
+	"aria-label",
+	"role",
+	"name",
+	"title",
+	"alt"
+]);
+const isPreferredAttributeValueSafe = (value) => value.length > 0 && value.length <= 120;
+const isSelectorUniqueForElement = (element, selector) => {
+	try {
+		const matchingElements = element.ownerDocument.querySelectorAll(selector);
+		return matchingElements.length === 1 && matchingElements[0] === element;
+	} catch {
+		return false;
+	}
+};
+const createFastElementSelector = (element) => {
+	if (element instanceof HTMLElement && element.id) {
+		const idSelector = `#${escapeCssIdentifier(element.id)}`;
+		if (isSelectorUniqueForElement(element, idSelector)) return idSelector;
+	}
+	for (const attributeName of PREFERRED_SELECTOR_ATTRIBUTE_NAMES) {
+		const attributeValue = element.getAttribute(attributeName);
+		if (!attributeValue) continue;
+		if (!isPreferredAttributeValueSafe(attributeValue)) continue;
+		const attributeOnlySelector = `[${attributeName}=${JSON.stringify(attributeValue)}]`;
+		if (isSelectorUniqueForElement(element, attributeOnlySelector)) return attributeOnlySelector;
+		const tagSelector = `${element.tagName.toLowerCase()}${attributeOnlySelector}`;
+		if (isSelectorUniqueForElement(element, tagSelector)) return tagSelector;
+	}
+	return null;
+};
+const createNthChildSelector = (element) => {
+	const segments = [];
+	const root = getFinderRoot(element);
+	let currentElement = element;
+	while (currentElement) {
+		if (currentElement instanceof HTMLElement && currentElement.id) {
+			segments.unshift(`#${escapeCssIdentifier(currentElement.id)}`);
+			break;
+		}
+		const parentElement = currentElement.parentElement;
+		if (!parentElement) {
+			segments.unshift(currentElement.tagName.toLowerCase());
+			break;
+		}
+		const siblingIndex = Array.from(parentElement.children).indexOf(currentElement);
+		const nthChild = siblingIndex >= 0 ? siblingIndex + 1 : 1;
+		segments.unshift(`${currentElement.tagName.toLowerCase()}:nth-child(${nthChild})`);
+		if (parentElement === root) {
+			segments.unshift(root.tagName.toLowerCase());
+			break;
+		}
+		currentElement = parentElement;
+	}
+	return segments.join(" > ");
+};
+const createElementSelector = (element, shouldUseFinder = true) => {
+	const fastSelector = createFastElementSelector(element);
+	if (fastSelector) return fastSelector;
+	if (shouldUseFinder) try {
+		const selector = findUniqueSelector(element, getFinderRoot(element), 200, (attributeName, attributeValue) => isAcceptedAttr(attributeName, attributeValue) || PREFERRED_SELECTOR_ATTRIBUTE_NAMES.has(attributeName) && isPreferredAttributeValueSafe(attributeValue));
+		if (selector) return selector;
+	} catch {}
+	return createNthChildSelector(element);
+};
+
+//#endregion
+Object.defineProperty(exports, 'copyContent', {
+  enumerable: true,
+  get: function () {
+    return copyContent;
+  }
+});
+Object.defineProperty(exports, 'createElementSelector', {
+  enumerable: true,
+  get: function () {
+    return createElementSelector;
+  }
+});

package/dist/create-element-selector-Dw4Hh5vX.cjs

@@ -0,0 +1,307 @@
+/**
+ * @license MIT
+ *
+ * Copyright (c) 2025 Aiden Bai
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+const require_freeze_updates = require('./freeze-updates-1bWq0iRj.cjs');
+
+//#region src/utils/copy-content.ts
+const REACT_GRAB_MIME_TYPE = "application/x-react-grab";
+const escapeHtml = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+const copyContent = (content, options) => {
+	const elementName = options?.componentName ?? "div";
+	const reactGrabMetadata = {
+		version: require_freeze_updates.VERSION,
+		content,
+		entries: options?.entries ?? [{
+			tagName: options?.tagName,
+			componentName: elementName,
+			content,
+			commentText: options?.commentText
+		}],
+		timestamp: Date.now()
+	};
+	const copyHandler = (event) => {
+		event.preventDefault();
+		event.clipboardData?.setData("text/plain", content);
+		event.clipboardData?.setData("text/html", `<meta charset='utf-8'><pre><code>${escapeHtml(content)}</code></pre>`);
+		event.clipboardData?.setData(REACT_GRAB_MIME_TYPE, JSON.stringify(reactGrabMetadata));
+	};
+	document.addEventListener("copy", copyHandler);
+	const textarea = document.createElement("textarea");
+	textarea.value = content;
+	textarea.style.position = "fixed";
+	textarea.style.left = "-9999px";
+	textarea.ariaHidden = "true";
+	document.body.appendChild(textarea);
+	textarea.select();
+	try {
+		if (typeof document.execCommand !== "function") return false;
+		return document.execCommand("copy");
+	} finally {
+		document.removeEventListener("copy", copyHandler);
+		textarea.remove();
+	}
+};
+
+//#endregion
+//#region src/utils/find-unique-selector.ts
+const SEED_MIN_LENGTH = 3;
+const ATTR_VALUE_MAX_LENGTH_CHARS = 100;
+const PENALTY_ID = 0;
+const PENALTY_CLASS = 1;
+const PENALTY_ATTR = 2;
+const PENALTY_TAG = 5;
+const PENALTY_NTH_OF_TYPE = 10;
+const PENALTY_NTH_CHILD = 50;
+const ACCEPTED_ATTR_NAMES = new Set([
+	"role",
+	"name",
+	"aria-label",
+	"rel",
+	"href"
+]);
+const isWordLike = (text) => {
+	if (!/^[a-z-]{3,}$/i.test(text)) return false;
+	const segments = text.split(/-|[A-Z]/);
+	for (const segment of segments) {
+		if (segment.length <= 2) return false;
+		if (/[^aeiou]{4,}/i.test(segment)) return false;
+	}
+	return true;
+};
+const isAcceptedAttr = (attributeName, attributeValue) => {
+	const nameIsAccepted = ACCEPTED_ATTR_NAMES.has(attributeName) || attributeName.startsWith("data-") && isWordLike(attributeName);
+	const valueIsAccepted = isWordLike(attributeValue) && attributeValue.length < ATTR_VALUE_MAX_LENGTH_CHARS || attributeValue.startsWith("#") && isWordLike(attributeValue.slice(1));
+	return nameIsAccepted && valueIsAccepted;
+};
+const buildSelectorString = (path) => {
+	let result = path[0].name;
+	for (let index = 1; index < path.length; index++) result = `${path[index].name} > ${result}`;
+	return result;
+};
+const calculatePenalty = (path) => {
+	let total = 0;
+	for (const selectorNode of path) total += selectorNode.penalty;
+	return total;
+};
+const comparePenalty = (pathA, pathB) => calculatePenalty(pathA) - calculatePenalty(pathB);
+const getChildIndex = (element, filterTagName) => {
+	const parentNode = element.parentNode;
+	if (!parentNode) return void 0;
+	let sibling = parentNode.firstChild;
+	if (!sibling) return void 0;
+	let position = 0;
+	while (sibling) {
+		if (sibling.nodeType === Node.ELEMENT_NODE && (filterTagName === void 0 || sibling.tagName.toLowerCase() === filterTagName)) position++;
+		if (sibling === element) break;
+		sibling = sibling.nextSibling;
+	}
+	return position;
+};
+const formatNthChild = (tagName, childPosition) => tagName === "html" ? "html" : `${tagName}:nth-child(${childPosition})`;
+const formatNthOfType = (tagName, typePosition) => tagName === "html" ? "html" : `${tagName}:nth-of-type(${typePosition})`;
+const collectCandidateNodes = (element, attrFilter) => {
+	const candidates = [];
+	const elementId = element.getAttribute("id");
+	const elementTagName = element.tagName.toLowerCase();
+	if (elementId && isWordLike(elementId)) candidates.push({
+		name: `#${CSS.escape(elementId)}`,
+		penalty: PENALTY_ID
+	});
+	for (const className of element.classList) if (isWordLike(className)) candidates.push({
+		name: `.${CSS.escape(className)}`,
+		penalty: PENALTY_CLASS
+	});
+	for (const attribute of element.attributes) if (attrFilter(attribute.name, attribute.value)) candidates.push({
+		name: `[${CSS.escape(attribute.name)}="${CSS.escape(attribute.value)}"]`,
+		penalty: PENALTY_ATTR
+	});
+	candidates.push({
+		name: elementTagName,
+		penalty: PENALTY_TAG
+	});
+	const typePosition = getChildIndex(element, elementTagName);
+	if (typePosition !== void 0) candidates.push({
+		name: formatNthOfType(elementTagName, typePosition),
+		penalty: PENALTY_NTH_OF_TYPE
+	});
+	const childPosition = getChildIndex(element);
+	if (childPosition !== void 0) candidates.push({
+		name: formatNthChild(elementTagName, childPosition),
+		penalty: PENALTY_NTH_CHILD
+	});
+	return candidates;
+};
+const collectCombinations = (stack, budget = require_freeze_updates.MAX_SELECTOR_COMBINATIONS, currentPath = []) => {
+	if (budget <= 0) return [];
+	if (stack.length === 0) return [currentPath];
+	const results = [];
+	for (const selectorNode of stack[0]) {
+		const remainingBudget = budget - results.length;
+		if (remainingBudget <= 0) break;
+		results.push(...collectCombinations(stack.slice(1), remainingBudget, [...currentPath, selectorNode]));
+	}
+	return results;
+};
+const resolveRootDocument = (rootNode, targetElement) => {
+	const attachedRoot = targetElement.getRootNode?.();
+	if (attachedRoot instanceof ShadowRoot) return attachedRoot;
+	if (rootNode.nodeType === Node.DOCUMENT_NODE) return rootNode;
+	return rootNode.ownerDocument;
+};
+const isSelectorUnique = (selectorPath, rootDocument) => rootDocument.querySelectorAll(buildSelectorString(selectorPath)).length === 1;
+const buildFallbackPath = (targetElement, rootDocument) => {
+	let currentElement = targetElement;
+	const path = [];
+	while (currentElement && currentElement !== rootDocument) {
+		const currentTagName = currentElement.tagName.toLowerCase();
+		const typePosition = getChildIndex(currentElement, currentTagName);
+		if (typePosition === void 0) return void 0;
+		path.push({
+			name: formatNthOfType(currentTagName, typePosition),
+			penalty: PENALTY_NTH_OF_TYPE
+		});
+		currentElement = currentElement.parentElement;
+	}
+	return isSelectorUnique(path, rootDocument) ? path : void 0;
+};
+const findUniqueSelector = (targetElement, root, timeoutMs, attrFilter) => {
+	if (targetElement.nodeType !== Node.ELEMENT_NODE) throw new Error("Can't generate CSS selector for non-element node type.");
+	if (targetElement.tagName.toLowerCase() === "html") return "html";
+	const rootDocument = resolveRootDocument(root, targetElement);
+	const startTime = Date.now();
+	const ancestorStack = [];
+	let currentElement = targetElement;
+	let depth = 0;
+	let foundPath;
+	while (currentElement && currentElement !== rootDocument && !foundPath) {
+		ancestorStack.push(collectCandidateNodes(currentElement, attrFilter));
+		currentElement = currentElement.parentElement;
+		depth++;
+		if (depth >= SEED_MIN_LENGTH) {
+			const candidatePaths = collectCombinations(ancestorStack);
+			candidatePaths.sort(comparePenalty);
+			for (const candidatePath of candidatePaths) {
+				if (Date.now() - startTime > timeoutMs) {
+					const fallbackPath = buildFallbackPath(targetElement, rootDocument);
+					if (!fallbackPath) throw new Error(`Timeout: Can't find a unique selector after ${timeoutMs}ms`);
+					return buildSelectorString(fallbackPath);
+				}
+				if (isSelectorUnique(candidatePath, rootDocument)) {
+					foundPath = candidatePath;
+					break;
+				}
+			}
+		}
+	}
+	if (!foundPath && depth < SEED_MIN_LENGTH) {
+		const remainingPaths = collectCombinations(ancestorStack);
+		remainingPaths.sort(comparePenalty);
+		for (const candidatePath of remainingPaths) {
+			if (Date.now() - startTime > timeoutMs) break;
+			if (isSelectorUnique(candidatePath, rootDocument)) {
+				foundPath = candidatePath;
+				break;
+			}
+		}
+	}
+	if (!foundPath) throw new Error("Selector was not found.");
+	return buildSelectorString(foundPath);
+};
+
+//#endregion
+//#region src/utils/create-element-selector.ts
+const escapeCssIdentifier = (value) => {
+	if (typeof CSS !== "undefined" && typeof CSS.escape === "function") return CSS.escape(value);
+	return value.replace(/[^a-zA-Z0-9_-]/g, (character) => `\\${character}`);
+};
+const getFinderRoot = (element) => element.ownerDocument.body ?? element.ownerDocument.documentElement;
+const PREFERRED_SELECTOR_ATTRIBUTE_NAMES = new Set([
+	"data-testid",
+	"data-test-id",
+	"data-test",
+	"data-cy",
+	"data-qa",
+	"aria-label",
+	"role",
+	"name",
+	"title",
+	"alt"
+]);
+const isPreferredAttributeValueSafe = (value) => value.length > 0 && value.length <= 120;
+const isSelectorUniqueForElement = (element, selector) => {
+	try {
+		const matchingElements = element.ownerDocument.querySelectorAll(selector);
+		return matchingElements.length === 1 && matchingElements[0] === element;
+	} catch {
+		return false;
+	}
+};
+const createFastElementSelector = (element) => {
+	if (element instanceof HTMLElement && element.id) {
+		const idSelector = `#${escapeCssIdentifier(element.id)}`;
+		if (isSelectorUniqueForElement(element, idSelector)) return idSelector;
+	}
+	for (const attributeName of PREFERRED_SELECTOR_ATTRIBUTE_NAMES) {
+		const attributeValue = element.getAttribute(attributeName);
+		if (!attributeValue) continue;
+		if (!isPreferredAttributeValueSafe(attributeValue)) continue;
+		const attributeOnlySelector = `[${attributeName}=${JSON.stringify(attributeValue)}]`;
+		if (isSelectorUniqueForElement(element, attributeOnlySelector)) return attributeOnlySelector;
+		const tagSelector = `${element.tagName.toLowerCase()}${attributeOnlySelector}`;
+		if (isSelectorUniqueForElement(element, tagSelector)) return tagSelector;
+	}
+	return null;
+};
+const createNthChildSelector = (element) => {
+	const segments = [];
+	const root = getFinderRoot(element);
+	let currentElement = element;
+	while (currentElement) {
+		if (currentElement instanceof HTMLElement && currentElement.id) {
+			segments.unshift(`#${escapeCssIdentifier(currentElement.id)}`);
+			break;
+		}
+		const parentElement = currentElement.parentElement;
+		if (!parentElement) {
+			segments.unshift(currentElement.tagName.toLowerCase());
+			break;
+		}
+		const siblingIndex = Array.from(parentElement.children).indexOf(currentElement);
+		const nthChild = siblingIndex >= 0 ? siblingIndex + 1 : 1;
+		segments.unshift(`${currentElement.tagName.toLowerCase()}:nth-child(${nthChild})`);
+		if (parentElement === root) {
+			segments.unshift(root.tagName.toLowerCase());
+			break;
+		}
+		currentElement = parentElement;
+	}
+	return segments.join(" > ");
+};
+const createElementSelector = (element, shouldUseFinder = true) => {
+	const fastSelector = createFastElementSelector(element);
+	if (fastSelector) return fastSelector;
+	if (shouldUseFinder) try {
+		const selector = findUniqueSelector(element, getFinderRoot(element), 200, (attributeName, attributeValue) => isAcceptedAttr(attributeName, attributeValue) || PREFERRED_SELECTOR_ATTRIBUTE_NAMES.has(attributeName) && isPreferredAttributeValueSafe(attributeValue));
+		if (selector) return selector;
+	} catch {}
+	return createNthChildSelector(element);
+};
+
+//#endregion
+Object.defineProperty(exports, 'copyContent', {
+  enumerable: true,
+  get: function () {
+    return copyContent;
+  }
+});
+Object.defineProperty(exports, 'createElementSelector', {
+  enumerable: true,
+  get: function () {
+    return createElementSelector;
+  }
+});