arcy.js 0.1.0 → 0.1.2

package/dist/chunk-NY3NXM2V.js

@@ -0,0 +1,213 @@
+/* arcy.js — https://arcyai.com */
+
+// src/fingerprint/model.ts
+var FINGERPRINT_TEXT_MAX = 80;
+var SELECTOR_CANDIDATES_MAX = 5;
+var PRECISION_DEFAULT = 3;
+var ORDINAL_DEFAULT = 1;
+function createTargetFingerprint(core) {
+  return {
+    v: 1,
+    core,
+    selector: null,
+    selectorCandidates: [],
+    ordinal: ORDINAL_DEFAULT,
+    precision: PRECISION_DEFAULT,
+    dynamicText: false
+  };
+}
+
+// src/fingerprint/shadow.ts
+function parentOrHost(el) {
+  if (el.parentElement !== null) return el.parentElement;
+  const parentNode = el.parentNode;
+  if (parentNode !== null && "host" in parentNode) {
+    return parentNode.host;
+  }
+  return null;
+}
+function closestAcrossShadow(el, selector) {
+  let current = el;
+  while (current !== null) {
+    if (current.matches(selector)) return current;
+    current = parentOrHost(current);
+  }
+  return null;
+}
+function containsAcrossShadow(ancestor, descendant) {
+  let current = descendant;
+  while (current !== null) {
+    if (current === ancestor) return true;
+    current = parentOrHost(current);
+  }
+  return false;
+}
+var MAX_SHADOW_DEPTH = 100;
+function collectElementsDeep(root, depth = 0) {
+  const out = [];
+  const all = root.querySelectorAll("*");
+  for (let i = 0; i < all.length; i += 1) {
+    const el = all[i];
+    out.push(el);
+    if (el.shadowRoot !== null && depth < MAX_SHADOW_DEPTH)
+      out.push(...collectElementsDeep(el.shadowRoot, depth + 1));
+  }
+  return out;
+}
+function querySelectorAllDeep(root, selector, depth = 0) {
+  const out = Array.from(root.querySelectorAll(selector));
+  const all = root.querySelectorAll("*");
+  for (let i = 0; i < all.length; i += 1) {
+    const el = all[i];
+    if (el.shadowRoot !== null && depth < MAX_SHADOW_DEPTH)
+      out.push(...querySelectorAllDeep(el.shadowRoot, selector, depth + 1));
+  }
+  return out;
+}
+
+// src/fingerprint/capture.ts
+var PII_PATTERNS = [
+  // Email
+  /[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,
+  // US SSN: 123-45-6789
+  /\b\d{3}-\d{2}-\d{4}\b/g,
+  // Card shapes: 13-19 digits, optionally grouped. A denylist, not a Luhn check.
+  /\b\d(?:[ -]?\d){12,18}\b/g
+];
+var MASK = "[masked]";
+function containsPii(raw) {
+  return PII_PATTERNS.some((pattern) => {
+    pattern.lastIndex = 0;
+    return pattern.test(raw);
+  });
+}
+var NORMALIZE_RAW_MAX = 4096;
+var NORMALIZE_RAW_MARGIN = 100;
+var ROLE_MAX = 64;
+function normalizeText(raw) {
+  if (!raw) return void 0;
+  let bounded = raw.slice(0, NORMALIZE_RAW_MAX);
+  if (raw.length > NORMALIZE_RAW_MAX) {
+    const lastSpace = bounded.search(/\s\S*$/);
+    bounded = lastSpace === -1 ? bounded.slice(0, NORMALIZE_RAW_MAX - NORMALIZE_RAW_MARGIN) : bounded.slice(0, lastSpace);
+  }
+  let text = bounded.replace(/\s+/g, " ").trim();
+  if (!text) return void 0;
+  for (const pattern of PII_PATTERNS) {
+    text = text.replace(pattern, MASK);
+  }
+  return text.slice(0, FINGERPRINT_TEXT_MAX);
+}
+function isStableId(id) {
+  if (id.length === 0 || id.length > 64) return false;
+  if (id.includes(":")) return false;
+  if (id.startsWith("radix-")) return false;
+  if (/^\d+$/.test(id)) return false;
+  if (/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)) return false;
+  return true;
+}
+var INTERACTIVE_TAGS = /* @__PURE__ */ new Set(["button", "input", "select", "textarea", "label", "summary"]);
+var INTERACTIVE_ROLES = /* @__PURE__ */ new Set(["button", "link", "menuitem", "tab", "option"]);
+function isInteractive(el) {
+  const tag = el.tagName.toLowerCase();
+  if (INTERACTIVE_TAGS.has(tag)) return true;
+  if (tag === "a" && el.hasAttribute("href")) return true;
+  const role = el.getAttribute("role");
+  if (role !== null && INTERACTIVE_ROLES.has(role)) return true;
+  const editable = el.getAttribute("contenteditable");
+  if (editable === "" || editable === "true") return true;
+  return false;
+}
+function resolveInteractiveTarget(el) {
+  let current = el;
+  while (current !== null && current !== current.ownerDocument.documentElement) {
+    if (isInteractive(current)) return current;
+    current = parentOrHost(current);
+  }
+  return el;
+}
+var ANCESTOR_ATTRS = ["data-testid", "data-test", "data-cy", "id", "name", "aria-label"];
+var TEST_ATTRS = ["data-testid", "data-test", "data-cy"];
+var TEST_ID_MAX = 64;
+function firstTestId(el) {
+  for (const attr of TEST_ATTRS) {
+    const raw = el.getAttribute(attr);
+    if (raw === null) continue;
+    const trimmed = raw.trim();
+    if (trimmed === "" || trimmed.length > TEST_ID_MAX) continue;
+    if (containsPii(trimmed)) continue;
+    return trimmed;
+  }
+  return void 0;
+}
+var LANDMARK_ROLES = /* @__PURE__ */ new Set([
+  "navigation",
+  "main",
+  "banner",
+  "contentinfo",
+  "search",
+  "form",
+  "region",
+  "dialog"
+]);
+function findSemanticAncestor(el) {
+  let current = parentOrHost(el);
+  while (current !== null) {
+    const tag = current.tagName.toLowerCase();
+    if (tag === "body" || tag === "html") return void 0;
+    for (const attr of ANCESTOR_ATTRS) {
+      const raw = current.getAttribute(attr);
+      if (raw === null) continue;
+      if (attr === "id" && !isStableId(raw)) continue;
+      const value = normalizeText(raw);
+      if (value !== void 0) return { tag, attr, value };
+    }
+    const role = current.getAttribute("role");
+    if (role !== null && LANDMARK_ROLES.has(role)) {
+      return { tag, attr: "role", value: role };
+    }
+    current = parentOrHost(current);
+  }
+  return void 0;
+}
+function siblingIndexOf(el) {
+  let index = 0;
+  let sibling = el.previousElementSibling;
+  while (sibling !== null) {
+    if (sibling.tagName === el.tagName) index += 1;
+    sibling = sibling.previousElementSibling;
+  }
+  return index;
+}
+function captureEventFingerprint(el) {
+  const fingerprint = {
+    tag: el.tagName.toLowerCase(),
+    siblingIndex: siblingIndexOf(el)
+  };
+  const text = normalizeText(el.textContent);
+  if (text !== void 0) fingerprint.text = text;
+  const ariaLabel = normalizeText(el.getAttribute("aria-label"));
+  if (ariaLabel !== void 0) fingerprint.ariaLabel = ariaLabel;
+  const placeholder = normalizeText(el.getAttribute("placeholder"));
+  if (placeholder !== void 0) fingerprint.placeholder = placeholder;
+  const id = el.getAttribute("id");
+  if (id !== null && isStableId(id) && !containsPii(id)) fingerprint.id = id;
+  const role = el.getAttribute("role");
+  if (role !== null) {
+    const trimmed = role.trim();
+    if (trimmed !== "" && trimmed.length <= ROLE_MAX && !containsPii(trimmed)) {
+      fingerprint.role = trimmed;
+    }
+  }
+  const testId = firstTestId(el);
+  if (testId !== void 0) fingerprint.testId = testId;
+  const ancestor = findSemanticAncestor(el);
+  if (ancestor !== void 0) {
+    fingerprint.ancestorTag = ancestor.tag;
+    fingerprint.ancestorAttr = ancestor.attr;
+    fingerprint.ancestorValue = ancestor.value;
+  }
+  return fingerprint;
+}
+
+export { FINGERPRINT_TEXT_MAX, MASK, SELECTOR_CANDIDATES_MAX, captureEventFingerprint, closestAcrossShadow, collectElementsDeep, containsAcrossShadow, containsPii, createTargetFingerprint, isInteractive, isStableId, querySelectorAllDeep, resolveInteractiveTarget };

package/dist/design-mode.js

@@ -1,127 +1,2 @@
-/* arcy.js — https://arcyai.com */
-
-// src/fingerprint/model.ts
-var FINGERPRINT_TEXT_MAX = 80;
-var SELECTOR_CANDIDATES_MAX = 5;
-
-// src/fingerprint/capture.ts
-var MASK = "[masked]";
-
-// src/picker/message.ts
-var DESIGN_MODE_PROTOCOL = 2;
-var DESIGN_MODE_READY = "arcy:design-mode:ready";
-var DESIGN_MODE_PICK = "arcy:design-mode:pick";
-var DESIGN_MODE_EXIT = "arcy:design-mode:exit";
-var DESIGN_MODE_SCREENSHOT = "arcy:design-mode:screenshot";
-var TAG_MAX = 64;
-var ROUTE_MAX = 2048;
-var SELECTOR_MAX = 512;
-var ORDINAL_MAX = 1e4;
-var SIBLING_INDEX_MAX = 1e5;
-var SCREENSHOT_DATA_URL_MAX = 4e6;
-var SCREENSHOT_PREFIX = "data:image/png;base64,";
-var MATCH_COUNT_MAX = 1e6;
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function isBoundedString(value, max) {
-  return typeof value === "string" && value.length > 0 && value.length <= max;
-}
-function isOptionalBoundedString(value, max) {
-  return value === void 0 || isBoundedString(value, max);
-}
-function isBoundedInteger(value, min, max) {
-  return typeof value === "number" && Number.isInteger(value) && value >= min && value <= max;
-}
-function readCore(value) {
-  if (!isRecord(value)) return null;
-  if (!isBoundedString(value.tag, TAG_MAX)) return null;
-  if (!isBoundedInteger(value.siblingIndex, 0, SIBLING_INDEX_MAX)) return null;
-  const optional = [
-    "text",
-    "ariaLabel",
-    "placeholder",
-    "id",
-    "role",
-    "testId",
-    "ancestorTag",
-    "ancestorAttr",
-    "ancestorValue"
-  ];
-  for (const key of optional) {
-    if (!isOptionalBoundedString(value[key], FINGERPRINT_TEXT_MAX)) return null;
-  }
-  const core = {
-    tag: value.tag,
-    siblingIndex: value.siblingIndex
-  };
-  for (const key of optional) {
-    const field = value[key];
-    if (typeof field === "string") core[key] = field;
-  }
-  return core;
-}
-function readTarget(value) {
-  if (!isRecord(value)) return null;
-  if (value.v !== 1) return null;
-  const core = readCore(value.core);
-  if (!core) return null;
-  const { selector, selectorCandidates, ordinal, precision, dynamicText } = value;
-  if (selector !== null && !isBoundedString(selector, SELECTOR_MAX)) return null;
-  if (!Array.isArray(selectorCandidates)) return null;
-  if (selectorCandidates.length > SELECTOR_CANDIDATES_MAX) return null;
-  if (!selectorCandidates.every((c) => isBoundedString(c, SELECTOR_MAX)))
-    return null;
-  if (!isBoundedInteger(ordinal, 1, ORDINAL_MAX)) return null;
-  if (!isBoundedInteger(precision, 1, 5)) return null;
-  if (typeof dynamicText !== "boolean") return null;
-  return {
-    v: 1,
-    core,
-    selector,
-    selectorCandidates,
-    ordinal,
-    precision,
-    dynamicText
-  };
-}
-function readDesignModeMessage(data) {
-  if (!isRecord(data)) return null;
-  if (data.protocol !== DESIGN_MODE_PROTOCOL) return null;
-  switch (data.type) {
-    case DESIGN_MODE_READY:
-      return { type: DESIGN_MODE_READY, protocol: DESIGN_MODE_PROTOCOL };
-    case DESIGN_MODE_EXIT:
-      return { type: DESIGN_MODE_EXIT, protocol: DESIGN_MODE_PROTOCOL };
-    case DESIGN_MODE_PICK: {
-      const target = readTarget(data.target);
-      if (!target) return null;
-      const { route, matchCount } = data;
-      if (!isBoundedString(route, ROUTE_MAX)) return null;
-      if (!route.startsWith("/")) return null;
-      if (route.startsWith("//")) return null;
-      if (!isBoundedInteger(matchCount, 0, MATCH_COUNT_MAX)) return null;
-      return {
-        type: DESIGN_MODE_PICK,
-        protocol: DESIGN_MODE_PROTOCOL,
-        target,
-        route,
-        matchCount
-      };
-    }
-    case DESIGN_MODE_SCREENSHOT: {
-      const { screenshot } = data;
-      if (!isBoundedString(screenshot, SCREENSHOT_DATA_URL_MAX)) return null;
-      if (!screenshot.startsWith(SCREENSHOT_PREFIX)) return null;
-      return {
-        type: DESIGN_MODE_SCREENSHOT,
-        protocol: DESIGN_MODE_PROTOCOL,
-        screenshot
-      };
-    }
-    default:
-      return null;
-  }
-}
-
-export { DESIGN_MODE_EXIT, DESIGN_MODE_PICK, DESIGN_MODE_PROTOCOL, DESIGN_MODE_READY, DESIGN_MODE_SCREENSHOT, MASK, readDesignModeMessage };
+export { DESIGN_MODE_EXIT, DESIGN_MODE_PICK, DESIGN_MODE_PROTOCOL, DESIGN_MODE_READY, DESIGN_MODE_SCREENSHOT, readDesignModeMessage } from './chunk-7VVKR3AO.js';
+export { MASK } from './chunk-NY3NXM2V.js';