@buoy-gg/highlight-updates 7.0.35 → 7.0.38

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

@@ -1,58 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.isOnScreenTap = isOnScreenTap;
-exports.isRectCenterOnScreen = isRectCenterOnScreen;
-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;
-}
-function scoreTapMatch(c, params) {
-  if (params.nativeTag != null && c.nativeTag === params.nativeTag) return 1000;
-  const q = (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);
-  }
-  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;
-}
+"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;

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

@@ -1,68 +1 @@
-"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}`;
-}
+"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;

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

@@ -1,277 +1 @@
-"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
-  };
-}
+"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}}