@buoy-gg/highlight-updates 7.0.38 → 7.0.40

package/lib/commonjs/highlight-updates/utils/tapMatch.js

@@ -1 +1,83 @@
-"use strict";function isOnScreenTap(e){return!!e&&e.x>=-.1&&e.x<=1.1&&e.y>=-.1&&e.y<=1.1}function isRectCenterOnScreen(e,t,r){if(!e||t<=0||r<=0)return!1;const s=e.x+e.width/2,a=e.y+e.height/2,n=.1*t,o=.1*r;return s>=-n&&s<=t+n&&a>=-o&&a<=r+o}function looseText(e){return String(e??"").toLowerCase().replace(/\s+/g," ").replace(/(\d)[,\u00a0\u202f](?=\d{3}\b)/g,"$1").trim()}function scoreTapMatch(e,t){if(null!=t.nativeTag&&e.nativeTag===t.nativeTag)return 1e3;const r=String(t.query??t.testID??"").trim().toLowerCase();if(!r)return 0;const s=[e.testID,e.label,e.text,e.name].filter(Boolean).map(e=>e.toLowerCase());let a=0;for(const e of s)e===r?a=Math.max(a,100):e.startsWith(r)?a=Math.max(a,50):e.includes(r)&&(a=Math.max(a,25));const n=looseText(r);if(n)for(const e of s){const t=looseText(e);t===n?a=Math.max(a,90):t.startsWith(n)?a=Math.max(a,45):t.includes(n)&&(a=Math.max(a,22))}return t.testID&&e.testID&&e.testID.toLowerCase()===t.testID.toLowerCase()&&(a=Math.max(a,200)),0===a?0:((e.testID??"").toLowerCase().startsWith("buoy-dial-")&&(a+=40),e.tap&&(isOnScreenTap(e.tap)?a+=20:a-=40),a)}Object.defineProperty(exports,"__esModule",{value:!0}),exports.isOnScreenTap=isOnScreenTap,exports.isRectCenterOnScreen=isRectCenterOnScreen,exports.looseText=looseText,exports.scoreTapMatch=scoreTapMatch;
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isOnScreenTap = isOnScreenTap;
+exports.isRectCenterOnScreen = isRectCenterOnScreen;
+exports.looseText = looseText;
+exports.scoreTapMatch = scoreTapMatch;
+/**
+ * Shared tap-target scoring for describe_screen / tap_element.
+ *
+ * Ranking used to be substring-on-testID only, so `tap: "ASSETS"` preferred
+ * `nav-assets-tool-test` (score 25) over a visible dial icon, and off-screen
+ * Expo Router screens (y > 1) stayed in the candidate list.
+ */
+
+/** True when the measured center is inside the window (10% slack for home-indicator / portal hosts). */
+function isOnScreenTap(tap) {
+  if (!tap) return false;
+  return tap.x >= -0.1 && tap.x <= 1.1 && tap.y >= -0.1 && tap.y <= 1.1;
+}
+
+/**
+ * Point-in-window test in *points* (measureInWindow coords), with slack so
+ * the floating menu and rows clipped at the home indicator still count.
+ * Previous Expo Router screens typically measure at y > 1.2× window height.
+ */
+function isRectCenterOnScreen(rect, screenW, screenH) {
+  if (!rect || screenW <= 0 || screenH <= 0) return false;
+  const cx = rect.x + rect.width / 2;
+  const cy = rect.y + rect.height / 2;
+  const slackX = screenW * 0.1;
+  const slackY = screenH * 0.1;
+  return cx >= -slackX && cx <= screenW + slackX && cy >= -slackY && cy <= screenH + slackY;
+}
+
+/**
+ * The comparable form of a piece of text.
+ *
+ * "1,450", `1450` and "1,450 Points" are one request as far as a person is
+ * concerned. Measured on a live QA run: waits for BOTH "1,450" and 1450 failed
+ * against a balance that was on screen, because the thousands separator made
+ * every comparison miss. Lowercased, whitespace collapsed, digit-group
+ * separators dropped. A number arrives here as a number often enough that the
+ * coercion is not optional — `.trim()` on one is a crash.
+ */
+function looseText(value) {
+  return String(value ?? "").toLowerCase().replace(/\s+/g, " ").replace(/(\d)[,\u00a0\u202f](?=\d{3}\b)/g, "$1").trim();
+}
+function scoreTapMatch(c, params) {
+  if (params.nativeTag != null && c.nativeTag === params.nativeTag) return 1000;
+  const q = String(params.query ?? params.testID ?? "").trim().toLowerCase();
+  if (!q) return 0;
+  const fields = [c.testID, c.label, c.text, c.name].filter(Boolean).map(s => s.toLowerCase());
+  let best = 0;
+  for (const f of fields) {
+    if (f === q) best = Math.max(best, 100);else if (f.startsWith(q)) best = Math.max(best, 50);else if (f.includes(q)) best = Math.max(best, 25);
+  }
+  // Same tiers on the loose form, one notch lower so an exact hit still wins
+  // when both match. Skipped when the loose query is empty, or `includes("")`
+  // would score every candidate on the screen.
+  const looseQuery = looseText(q);
+  if (looseQuery) {
+    for (const f of fields) {
+      const loose = looseText(f);
+      if (loose === looseQuery) best = Math.max(best, 90);else if (loose.startsWith(looseQuery)) best = Math.max(best, 45);else if (loose.includes(looseQuery)) best = Math.max(best, 22);
+    }
+  }
+  if (params.testID && c.testID && c.testID.toLowerCase() === params.testID.toLowerCase()) {
+    best = Math.max(best, 200);
+  }
+  if (best === 0) return 0;
+  const id = (c.testID ?? "").toLowerCase();
+  // Dial icons are the thing agents mean when they tap a tool name. (No
+  // penalties for app testID patterns — this ships in the library, and we
+  // don't know consumer apps' naming conventions.)
+  if (id.startsWith("buoy-dial-")) best += 40;
+  if (c.tap) {
+    if (isOnScreenTap(c.tap)) best += 20;else best -= 40;
+  }
+  return best;
+}

package/lib/commonjs/highlight-updates/utils/testIDs.js

@@ -1 +1,68 @@
-"use strict";function identifierSlug(e){return String(e).toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function renderRowTestID(e){return`buoy-highlight-row-${identifierSlug(e)}`}function detectedItemTestID(e,t){return`buoy-highlight-detected-${identifierSlug(e)}-${identifierSlug(t)}`}function patternChipTestID(e,t,i){return`buoy-highlight-${e}-chip-${identifierSlug(t)}-${identifierSlug(i)}`}function settingTestID(e){return`buoy-highlight-setting-${e}`}Object.defineProperty(exports,"__esModule",{value:!0}),exports.detectedItemTestID=detectedItemTestID,exports.identifierSlug=identifierSlug,exports.patternChipTestID=patternChipTestID,exports.renderRowTestID=renderRowTestID,exports.settingTestID=settingTestID;
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.detectedItemTestID = detectedItemTestID;
+exports.identifierSlug = identifierSlug;
+exports.patternChipTestID = patternChipTestID;
+exports.renderRowTestID = renderRowTestID;
+exports.settingTestID = settingTestID;
+/**
+ * Stable e2e handles for the Render Highlighter (highlight-updates).
+ *
+ * This tool's list is the hardest thing in Buoy to address, because the thing
+ * it lists is a NATIVE VIEW and the only key it has for one is the fiber's
+ * `nativeTag` — a per-session counter that changes on every launch, on every
+ * remount, and (on a dynamic screen) between two runs of the same test. A
+ * handle built from it would name a different component every time.
+ *
+ * So rows are addressed by their IDENTIFIER, in exactly the priority the list
+ * item itself uses to label them: testID → nativeID → component name →
+ * accessibility label → nativeTag. That is the same string the developer sees
+ * on the row, it is stable as long as the component is, and it is what a test
+ * can name up front. `nativeTag` remains the last resort for an anonymous host
+ * view, which no test should be naming anyway.
+ *
+ * Slug rules are mirrored in `example-dev-build/utils/renderBench.js` so the
+ * fixture and the tool agree about what a row is called; the suite's
+ * `fixture.js` spot-checks that they still do.
+ */
+
+/** Any identifier string → a testID-safe slug. */
+function identifierSlug(value) {
+  return String(value).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "unknown";
+}
+
+/**
+ * `buoy-highlight-row-<slug>` for one row of the render list.
+ *
+ * Sub-handles hang off it: `-name`, `-count`, `-type`, `-cause`, `-identifier`,
+ * `-time`. The count is the tool's whole claim, so it gets its own handle
+ * rather than living inside the row's merged label.
+ */
+function renderRowTestID(identifier) {
+  return `buoy-highlight-row-${identifierSlug(identifier)}`;
+}
+
+/**
+ * `buoy-highlight-detected-<type>-<slug>` for one chip in DETECTED ITEMS.
+ *
+ * The type is in the handle because the same string legitimately appears under
+ * two categories — a component called `Pressable` and a viewType called
+ * `Pressable` are different filters with the same name, and a suite that added
+ * the wrong one would still see "a pattern was added".
+ */
+function detectedItemTestID(type, value) {
+  return `buoy-highlight-detected-${identifierSlug(type)}-${identifierSlug(value)}`;
+}
+
+/** `buoy-highlight-<mode>-chip-<type>-<slug>` for an active filter pattern. */
+function patternChipTestID(mode, type, value) {
+  return `buoy-highlight-${mode}-chip-${identifierSlug(type)}-${identifierSlug(value)}`;
+}
+
+/** `buoy-highlight-setting-<key>` for a settings row's control. */
+function settingTestID(key) {
+  return `buoy-highlight-setting-${key}`;
+}

package/lib/commonjs/highlight-updates/utils/touchCapture.js

@@ -1 +1,277 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.clearTouchCapture=clearTouchCapture,exports.getTouchCaptureStatus=getTouchCaptureStatus,exports.readTouchCapture=readTouchCapture,exports.startTouchCapture=startTouchCapture,exports.stopTouchCapture=stopTouchCapture;var _screenElements=require("./screenElements"),_rawEventEmitter=require("./rawEventEmitter");const TAP_SLOP_PT=14,LONG_PRESS_MS=550,MAX_TAP_MS=4e3,TEXT_COALESCE_MS=8e3,MAX_RECORDS=600;let emitter=null,emitterResolved=!1,unavailableReason=null,subscriptions=[],status="idle",records=[],seq=0,pending=null;function getEmitter(){if(emitterResolved)return emitter;emitterResolved=!0;const t=(0,_rawEventEmitter.resolveRawEventEmitter)();return emitter=t.emitter,unavailableReason=t.reason,emitter}function num(t){return"number"==typeof t&&Number.isFinite(t)?t:null}function tagOf(t){const e=t?.nativeEvent;return e?num(e.target)??num(e.tag):null}function pointOf(t){const e=t?.nativeEvent;if(!e)return null;const n={x:num(e.pageX),y:num(e.pageY)};if(null!==n.x&&null!==n.y)return{x:n.x,y:n.y};for(const t of["changedTouches","touches"]){const n=e[t];if(Array.isArray(n)&&n.length){const t=n[0],e=num(t?.pageX),r=num(t?.pageY);if(null!==e&&null!==r)return{x:e,y:r}}}return null}function push(t){records.push({...t,seq:++seq}),records.length>600&&(records=records.slice(-600))}function onTouchStart(t){const e=tagOf(t);if(null===e)return;const n=pointOf(t);let r=null;try{r=(0,_screenElements.resolveTouchTarget)(e)}catch{}pending={tag:e,x:n?.x??0,y:n?.y??0,t:Date.now(),drift:0,target:r}}function onTouchMove(t){if(!pending)return;const e=pointOf(t);if(!e)return;const n=e.x-pending.x,r=e.y-pending.y;pending.drift=Math.max(pending.drift,Math.sqrt(n*n+r*r))}function onTouchEnd(t){const e=pending;if(pending=null,!e||!e.target)return;const n=pointOf(t);if(n){const t=n.x-e.x,r=n.y-e.y;e.drift=Math.max(e.drift,Math.sqrt(t*t+r*r))}if(e.drift>14)return;const r=Date.now()-e.t;r>4e3||"text"!==e.target.control&&"toggle"!==e.target.control&&"slider"!==e.target.control&&push({t:Date.now(),kind:r>=550?"longPress":"press",target:e.target})}function onTouchCancel(){pending=null}function onChange(t){const e=tagOf(t);if(null===e)return;const n=t.nativeEvent;let r,u;if("string"==typeof n.text)r="text",u=n.text;else if("boolean"==typeof n.value)r="toggle",u=n.value;else{if("number"!=typeof n.value)return;r="slider",u=n.value}const o=records[records.length-1];if(o&&o.kind===r&&o.target.nativeTag===e&&Date.now()-o.t<8e3)return o.value=u,void(o.t=Date.now());let a=null;try{a=(0,_screenElements.resolveTouchTarget)(e)}catch{}a&&push({t:Date.now(),kind:r,target:a,value:u})}function startTouchCapture(){if("capturing"===status)return getTouchCaptureStatus();const t=getEmitter();if(!t)return status="unavailable",getTouchCaptureStatus();try{subscriptions=[t.addListener("topTouchStart",onTouchStart),t.addListener("topTouchMove",onTouchMove),t.addListener("topTouchEnd",onTouchEnd),t.addListener("topTouchCancel",onTouchCancel),t.addListener("topChange",onChange),t.addListener("topValueChange",onChange),t.addListener("topSlidingComplete",onChange)],pending=null,status="capturing"}catch(t){subscriptions=[],status="unavailable",unavailableReason=t?.message??"addListener failed"}return getTouchCaptureStatus()}function stopTouchCapture(){subscriptions.forEach(t=>{try{t.remove()}catch{}}),subscriptions=[],pending=null,"capturing"===status&&(status="idle")}function clearTouchCapture(){records=[],seq=0}function getTouchCaptureStatus(){return{status:status,reason:"unavailable"===status?unavailableReason:null}}function readTouchCapture(t=0){return{...getTouchCaptureStatus(),records:records.filter(e=>e.seq>t),seq:seq}}
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.clearTouchCapture = clearTouchCapture;
+exports.getTouchCaptureStatus = getTouchCaptureStatus;
+exports.readTouchCapture = readTouchCapture;
+exports.startTouchCapture = startTouchCapture;
+exports.stopTouchCapture = stopTouchCapture;
+var _screenElements = require("./screenElements");
+var _rawEventEmitter = require("./rawEventEmitter");
+/**
+ * touchCapture — what a HUMAN is doing to the app, as replayable intents.
+ *
+ * This is the recording half of the pair whose playback half is `tapElement`:
+ * it watches real finger input and names each interaction in exactly the
+ * vocabulary `tapElement` searches by, so a recorded macro can be replayed
+ * without a second guess about what "that button" meant.
+ *
+ * Why RawEventEmitter and not the obvious alternatives:
+ * - A capture-phase responder on a root View would be the textbook answer, but
+ *   Buoy mounts as a SIBLING of the app tree, not a parent. There is no root to
+ *   wrap without changing every host app's integration.
+ * - Patching `Pressability`, or rewriting `onPress` props on the fly, breaks the
+ *   moment a component re-renders (props are rebuilt every render) and misses
+ *   everything driven by react-native-gesture-handler anyway.
+ * - RawEventEmitter mirrors every dispatched event before React's plugins see
+ *   it, needs zero app instrumentation, and is already proven in-tree by
+ *   focus-inspector's TV focus observer.
+ *
+ * Three rules the recorder above depends on:
+ *
+ *   THE TARGET IS RESOLVED AT touchStart, NOT touchEnd. A press handler can
+ *   navigate synchronously, so resolving after the fact names an element on the
+ *   screen the app moved TO. We resolve while the finger is still down and emit
+ *   when it lifts.
+ *
+ *   A DRAG IS NOT A TAP. Scrolling a list produces the same touchStart the
+ *   button above it does. Movement past a threshold, or an explicit
+ *   touchCancel when a ScrollView steals the responder, drops the record —
+ *   otherwise every recording is half scroll noise.
+ *
+ *   KEYSTROKES ARE NOT INTENTS. Typing "SAVE10" fires six change events; a
+ *   macro step wants the finished string. Consecutive edits to the same input
+ *   collapse into the latest value as they arrive.
+ */
+
+/** Points of finger travel past which the gesture stops being a tap. */
+const TAP_SLOP_PT = 14;
+/** Hold time at or past which a tap is recorded as a long-press. */
+const LONG_PRESS_MS = 550;
+/** A tap that outlasts this was a gesture we don't model — drop it. */
+const MAX_TAP_MS = 4_000;
+/** Consecutive edits to the same input within this window are one intent. */
+const TEXT_COALESCE_MS = 8_000;
+/** Ring buffer size. A recording longer than this is not a macro anyway. */
+const MAX_RECORDS = 600;
+let emitter = null;
+let emitterResolved = false;
+let unavailableReason = null;
+let subscriptions = [];
+let status = "idle";
+let records = [];
+let seq = 0;
+let pending = null;
+function getEmitter() {
+  if (emitterResolved) return emitter;
+  emitterResolved = true;
+  const resolution = (0, _rawEventEmitter.resolveRawEventEmitter)();
+  emitter = resolution.emitter;
+  unavailableReason = resolution.reason;
+  return emitter;
+}
+function num(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : null;
+}
+
+/** Fabric puts the touched view on `target`; `tag` is the older shape. */
+function tagOf(event) {
+  const native = event?.nativeEvent;
+  if (!native) return null;
+  return num(native.target) ?? num(native.tag);
+}
+
+/**
+ * Touch coordinates. A touch event carries them at the top level on the
+ * synthesized event and inside `touches`/`changedTouches` on the raw one, and
+ * which of those is populated differs by platform and architecture — so read
+ * whichever answers rather than betting on one.
+ */
+function pointOf(event) {
+  const native = event?.nativeEvent;
+  if (!native) return null;
+  const direct = {
+    x: num(native.pageX),
+    y: num(native.pageY)
+  };
+  if (direct.x !== null && direct.y !== null) return {
+    x: direct.x,
+    y: direct.y
+  };
+  for (const key of ["changedTouches", "touches"]) {
+    const list = native[key];
+    if (Array.isArray(list) && list.length) {
+      const first = list[0];
+      const x = num(first?.pageX);
+      const y = num(first?.pageY);
+      if (x !== null && y !== null) return {
+        x,
+        y
+      };
+    }
+  }
+  return null;
+}
+function push(record) {
+  records.push({
+    ...record,
+    seq: ++seq
+  });
+  if (records.length > MAX_RECORDS) records = records.slice(-MAX_RECORDS);
+}
+function onTouchStart(event) {
+  const tag = tagOf(event);
+  if (tag === null) return;
+  const point = pointOf(event);
+  let target = null;
+  try {
+    target = (0, _screenElements.resolveTouchTarget)(tag);
+  } catch {
+    // A fiber walk that throws must never break the app's touch handling.
+  }
+  pending = {
+    tag,
+    x: point?.x ?? 0,
+    y: point?.y ?? 0,
+    t: Date.now(),
+    drift: 0,
+    target
+  };
+}
+function onTouchMove(event) {
+  if (!pending) return;
+  const point = pointOf(event);
+  if (!point) return;
+  const dx = point.x - pending.x;
+  const dy = point.y - pending.y;
+  pending.drift = Math.max(pending.drift, Math.sqrt(dx * dx + dy * dy));
+}
+function onTouchEnd(event) {
+  const p = pending;
+  pending = null;
+  if (!p || !p.target) return;
+  const point = pointOf(event);
+  if (point) {
+    const dx = point.x - p.x;
+    const dy = point.y - p.y;
+    p.drift = Math.max(p.drift, Math.sqrt(dx * dx + dy * dy));
+  }
+  if (p.drift > TAP_SLOP_PT) return; // a drag, a scroll, a swipe — not a step
+
+  const held = Date.now() - p.t;
+  if (held > MAX_TAP_MS) return;
+
+  // A text input's tap is just "focus this field"; the intent is the text it
+  // ends up with, which arrives separately as a change event. Recording the
+  // focus tap too would put a step in every macro that does nothing on replay.
+  if (p.target.control === "text") return;
+  // Same for a toggle/slider: the tap and the value change are one intent, and
+  // the change event is the half that carries what it became.
+  if (p.target.control === "toggle" || p.target.control === "slider") return;
+  push({
+    t: Date.now(),
+    kind: held >= LONG_PRESS_MS ? "longPress" : "press",
+    target: p.target
+  });
+}
+function onTouchCancel() {
+  // A ScrollView (or any ancestor) taking the responder terminates the touch.
+  pending = null;
+}
+
+/**
+ * `topChange` is the shared channel for "this control's value became X" —
+ * TextInput sends `text`, Switch sends `value`. Sliders arrive on their own
+ * channel. All three are the same idea: a control the user set.
+ */
+function onChange(event) {
+  const tag = tagOf(event);
+  if (tag === null) return;
+  const native = event.nativeEvent;
+  let kind;
+  let value;
+  if (typeof native.text === "string") {
+    kind = "text";
+    value = native.text;
+  } else if (typeof native.value === "boolean") {
+    kind = "toggle";
+    value = native.value;
+  } else if (typeof native.value === "number") {
+    kind = "slider";
+    value = native.value;
+  } else {
+    return;
+  }
+  const last = records[records.length - 1];
+  if (last && last.kind === kind && last.target.nativeTag === tag && Date.now() - last.t < TEXT_COALESCE_MS) {
+    // Same control, still typing/dragging: this IS the previous intent, further
+    // along. Replace rather than append, or "SAVE10" becomes six macro steps.
+    last.value = value;
+    last.t = Date.now();
+    return;
+  }
+  let target = null;
+  try {
+    target = (0, _screenElements.resolveTouchTarget)(tag);
+  } catch {
+    /* see onTouchStart */
+  }
+  if (!target) return;
+  push({
+    t: Date.now(),
+    kind,
+    target,
+    value
+  });
+}
+function startTouchCapture() {
+  if (status === "capturing") return getTouchCaptureStatus();
+  const raw = getEmitter();
+  if (!raw) {
+    status = "unavailable";
+    return getTouchCaptureStatus();
+  }
+  try {
+    subscriptions = [raw.addListener("topTouchStart", onTouchStart), raw.addListener("topTouchMove", onTouchMove), raw.addListener("topTouchEnd", onTouchEnd), raw.addListener("topTouchCancel", onTouchCancel), raw.addListener("topChange", onChange), raw.addListener("topValueChange", onChange), raw.addListener("topSlidingComplete", onChange)];
+    pending = null;
+    status = "capturing";
+  } catch (e) {
+    subscriptions = [];
+    status = "unavailable";
+    unavailableReason = e?.message ?? "addListener failed";
+  }
+  return getTouchCaptureStatus();
+}
+function stopTouchCapture() {
+  subscriptions.forEach(s => {
+    try {
+      s.remove();
+    } catch {
+      /* already gone is fine */
+    }
+  });
+  subscriptions = [];
+  pending = null;
+  if (status === "capturing") status = "idle";
+}
+function clearTouchCapture() {
+  records = [];
+  seq = 0;
+}
+function getTouchCaptureStatus() {
+  return {
+    status,
+    reason: status === "unavailable" ? unavailableReason : null
+  };
+}
+
+/** Everything recorded after `sinceSeq`, plus where the caller now is. */
+function readTouchCapture(sinceSeq = 0) {
+  return {
+    ...getTouchCaptureStatus(),
+    records: records.filter(r => r.seq > sinceSeq),
+    seq
+  };
+}