@buoy-gg/focus-inspector 7.0.38 → 7.0.39

package/lib/commonjs/observe/keyEventObserver.js

@@ -1 +1,94 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.attachKeyObserver=attachKeyObserver,exports.detachKeyObserver=detachKeyObserver,exports.isKeyObserverListening=isKeyObserverListening,exports.platformOS=exports.isTV=void 0;var ReactNative=_interopRequireWildcard(require("react-native")),_focusStore=require("../store/focusStore");function _interopRequireWildcard(e,t){if("function"==typeof WeakMap)var r=new WeakMap,n=new WeakMap;return(_interopRequireWildcard=function(e,t){if(!t&&e&&e.__esModule)return e;var o,i,s={__proto__:null,default:e};if(null===e||"object"!=typeof e&&"function"!=typeof e)return s;if(o=t?n:r){if(o.has(e))return o.get(e);o.set(e,s)}for(const t in e)"default"!==t&&{}.hasOwnProperty.call(e,t)&&((i=(o=Object.defineProperty)&&Object.getOwnPropertyDescriptor(e,t))&&(i.get||i.set)?o(s,t,i):s[t]=e[t]);return s})(e,t)}const RN=ReactNative,isTV=exports.isTV=!0===RN.Platform?.isTV,platformOS=exports.platformOS=RN.Platform?.OS??"unknown",DIRECTION_BY_EVENT_TYPE={up:"up",down:"down",left:"left",right:"right",longUp:"up",longDown:"down",longLeft:"left",longRight:"right"};let subscription=null;function handleEvent(e){const t=e,r=t?.eventType;if("string"!=typeof r)return;if(0===t?.eventKeyAction)return;if("focus"===r||"blur"===r){if("number"!=typeof t?.tag)return;return void("focus"===r?(0,_focusStore.recordFocus)(t.tag):(0,_focusStore.recordBlur)(t.tag))}const n=DIRECTION_BY_EVENT_TYPE[r];n&&(0,_focusStore.recordKey)(n)}function attachKeyObserver(){!subscription&&isTV&&RN.TVEventHandler&&(subscription=RN.TVEventHandler.addListener(handleEvent))}function detachKeyObserver(){if(subscription){try{subscription.remove()}catch{}subscription=null}}function isKeyObserverListening(){return null!==subscription}
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.attachKeyObserver = attachKeyObserver;
+exports.detachKeyObserver = detachKeyObserver;
+exports.isKeyObserverListening = isKeyObserverListening;
+exports.platformOS = exports.isTV = void 0;
+var ReactNative = _interopRequireWildcard(require("react-native"));
+var _focusStore = require("../store/focusStore");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * keyEventObserver — the direction half of the stream.
+ *
+ * D-pad HWEvents carry NO tag on either platform (an Android payload is exactly
+ * `{"eventKeyAction":1,"eventType":"right"}`), and focus events carry no
+ * direction. So key events tell you *which way the user pushed* and focus
+ * events tell you *where focus went*; the store joins them on time.
+ *
+ * `TVEventHandler.addListener` (not the `useTVEventHandler` hook) because sync
+ * adapters are not React components — nothing here mounts.
+ *
+ * On the 0.83 fork line iOS Fabric ALSO still emits tagged `focus`/`blur`
+ * HWEvents here. Those are folded into the same store as enrichment so the
+ * older line gets a focus source even if the RawEventEmitter path ever fails —
+ * never depended on, because 0.85 deleted them.
+ */
+
+/**
+ * `TVEventHandler` only exists on the react-native-tvos fork. A namespace read
+ * (rather than a named import) keeps this module importable on stock RN.
+ */
+const RN = ReactNative;
+const isTV = exports.isTV = RN.Platform?.isTV === true;
+const platformOS = exports.platformOS = RN.Platform?.OS ?? "unknown";
+
+/**
+ * Long-press variants move focus the same way a tap does, so they map to the
+ * same direction. Everything else (select, menu, playPause, pans, swipes) never
+ * moves focus and is dropped rather than logged as a probe that can't resolve.
+ */
+const DIRECTION_BY_EVENT_TYPE = {
+  up: "up",
+  down: "down",
+  left: "left",
+  right: "right",
+  longUp: "up",
+  longDown: "down",
+  longLeft: "left",
+  longRight: "right"
+};
+let subscription = null;
+function handleEvent(raw) {
+  const event = raw;
+  const eventType = event?.eventType;
+  if (typeof eventType !== "string") return;
+
+  /**
+   * Dedupe by ignoring key DOWN, never key UP. tvOS emits keyAction 1 (up)
+   * ONLY for button presses — filtering to "down" would swallow every tvOS
+   * event — while Android's key-down dispatch sits behind a feature flag that
+   * is off by default. One press must open exactly one probe.
+   */
+  if (event?.eventKeyAction === 0) return;
+
+  // 0.83-line iOS bonus: tagged focus/blur HWEvents. Guarded on the tag being
+  // present so 0.85's tag-less variants (if any ever return) can't record a
+  // transition to nowhere.
+  if (eventType === "focus" || eventType === "blur") {
+    if (typeof event?.tag !== "number") return;
+    if (eventType === "focus") (0, _focusStore.recordFocus)(event.tag);else (0, _focusStore.recordBlur)(event.tag);
+    return;
+  }
+  const direction = DIRECTION_BY_EVENT_TYPE[eventType];
+  if (direction) (0, _focusStore.recordKey)(direction);
+}
+function attachKeyObserver() {
+  if (subscription || !isTV || !RN.TVEventHandler) return;
+  subscription = RN.TVEventHandler.addListener(handleEvent);
+}
+function detachKeyObserver() {
+  if (!subscription) return;
+  try {
+    subscription.remove();
+  } catch {
+    /* already gone */
+  }
+  subscription = null;
+}
+function isKeyObserverListening() {
+  return subscription !== null;
+}
+//# sourceMappingURL=keyEventObserver.js.map

package/lib/commonjs/observe/keyEventObserver.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ReactNative","_interopRequireWildcard","require","_focusStore","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","RN","isTV","exports","Platform","platformOS","OS","DIRECTION_BY_EVENT_TYPE","up","down","left","right","longUp","longDown","longLeft","longRight","subscription","handleEvent","raw","event","eventType","eventKeyAction","tag","recordFocus","recordBlur","direction","recordKey","attachKeyObserver","TVEventHandler","addListener","detachKeyObserver","remove","isKeyObserverListening"],"sourceRoot":"../../../src","sources":["observe/keyEventObserver.ts"],"mappings":";;;;;;;;;AAiBA,IAAAA,WAAA,GAAAC,uBAAA,CAAAC,OAAA;AAEA,IAAAC,WAAA,GAAAD,OAAA;AAA8F,SAAAD,wBAAAG,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAL,uBAAA,YAAAA,CAAAG,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAnB9F;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcA;AACA;AACA;AACA;AACA,MAAMkB,EAAE,GAAGvB,WAGV;AAEM,MAAMwB,IAAI,GAAAC,OAAA,CAAAD,IAAA,GAAGD,EAAE,CAACG,QAAQ,EAAEF,IAAI,KAAK,IAAI;AACvC,MAAMG,UAAU,GAAAF,OAAA,CAAAE,UAAA,GAAGJ,EAAE,CAACG,QAAQ,EAAEE,EAAE,IAAI,SAAS;;AAEtD;AACA;AACA;AACA;AACA;AACA,MAAMC,uBAAuD,GAAG;EAC9DC,EAAE,EAAE,IAAI;EACRC,IAAI,EAAE,MAAM;EACZC,IAAI,EAAE,MAAM;EACZC,KAAK,EAAE,OAAO;EACdC,MAAM,EAAE,IAAI;EACZC,QAAQ,EAAE,MAAM;EAChBC,QAAQ,EAAE,MAAM;EAChBC,SAAS,EAAE;AACb,CAAC;AAED,IAAIC,YAAiC,GAAG,IAAI;AAE5C,SAASC,WAAWA,CAACC,GAAY,EAAQ;EACvC,MAAMC,KAAK,GAAGD,GAEN;EACR,MAAME,SAAS,GAAGD,KAAK,EAAEC,SAAS;EAClC,IAAI,OAAOA,SAAS,KAAK,QAAQ,EAAE;;EAEnC;AACF;AACA;AACA;AACA;AACA;EACE,IAAID,KAAK,EAAEE,cAAc,KAAK,CAAC,EAAE;;EAEjC;EACA;EACA;EACA,IAAID,SAAS,KAAK,OAAO,IAAIA,SAAS,KAAK,MAAM,EAAE;IACjD,IAAI,OAAOD,KAAK,EAAEG,GAAG,KAAK,QAAQ,EAAE;IACpC,IAAIF,SAAS,KAAK,OAAO,EAAE,IAAAG,uBAAW,EAACJ,KAAK,CAACG,GAAG,CAAC,CAAC,KAC7C,IAAAE,sBAAU,EAACL,KAAK,CAACG,GAAG,CAAC;IAC1B;EACF;EAEA,MAAMG,SAAS,GAAGlB,uBAAuB,CAACa,SAAS,CAAC;EACpD,IAAIK,SAAS,EAAE,IAAAC,qBAAS,EAACD,SAAS,CAAC;AACrC;AAEO,SAASE,iBAAiBA,CAAA,EAAS;EACxC,IAAIX,YAAY,IAAI,CAACd,IAAI,IAAI,CAACD,EAAE,CAAC2B,cAAc,EAAE;EACjDZ,YAAY,GAAGf,EAAE,CAAC2B,cAAc,CAACC,WAAW,CAACZ,WAAW,CAAC;AAC3D;AAEO,SAASa,iBAAiBA,CAAA,EAAS;EACxC,IAAI,CAACd,YAAY,EAAE;EACnB,IAAI;IACFA,YAAY,CAACe,MAAM,CAAC,CAAC;EACvB,CAAC,CAAC,MAAM;IACN;EAAA;EAEFf,YAAY,GAAG,IAAI;AACrB;AAEO,SAASgB,sBAAsBA,CAAA,EAAY;EAChD,OAAOhB,YAAY,KAAK,IAAI;AAC9B","ignoreList":[]}

package/lib/commonjs/observe/rawEventEmitter.js

@@ -1 +1,44 @@
-"use strict";function resolveRawEventEmitter(){let e;try{e=require("react-native/Libraries/Core/RawEventEmitter")}catch(e){return{emitter:null,reason:e?.message??"RawEventEmitter is unavailable"}}const t=e?.default??e;return"function"!=typeof t?.addListener?{emitter:null,reason:"RawEventEmitter has no addListener"}:{emitter:t,reason:null}}Object.defineProperty(exports,"__esModule",{value:!0}),exports.resolveRawEventEmitter=resolveRawEventEmitter;
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.resolveRawEventEmitter = resolveRawEventEmitter;
+/**
+ * The one guarded require for React Native's RawEventEmitter, kept in its own
+ * module for two reasons.
+ *
+ * 1. `react-native/Libraries/Core/RawEventEmitter` is a DEEP import. It warns
+ *    under 0.85's export map and could move in any release, so the failure has
+ *    to degrade to "observer unavailable" in the snapshot rather than taking
+ *    the host app's bundle down. Metro only treats a require as optional when
+ *    it sits LEXICALLY inside a try statement — wrapping it in a helper or an
+ *    arrow makes Metro hard-fail the bundle instead.
+ * 2. It gives the unit suite a seam. Node's `require` resolves through the
+ *    filesystem and ignores Vitest's module mocks, so the emitter can only be
+ *    faked by mocking a module that is reached with a real `import`.
+ */
+
+function resolveRawEventEmitter() {
+  let mod;
+  try {
+    mod = require("react-native/Libraries/Core/RawEventEmitter");
+  } catch (e) {
+    return {
+      emitter: null,
+      reason: e?.message ?? "RawEventEmitter is unavailable"
+    };
+  }
+  const candidate = mod?.default ?? mod;
+  if (typeof candidate?.addListener !== "function") {
+    return {
+      emitter: null,
+      reason: "RawEventEmitter has no addListener"
+    };
+  }
+  return {
+    emitter: candidate,
+    reason: null
+  };
+}
+//# sourceMappingURL=rawEventEmitter.js.map

package/lib/commonjs/observe/rawEventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["resolveRawEventEmitter","mod","require","e","emitter","reason","message","candidate","default","addListener"],"sourceRoot":"../../../src","sources":["observe/rawEventEmitter.ts"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAkBO,SAASA,sBAAsBA,CAAA,EAAyB;EAC7D,IAAIC,GAAY;EAChB,IAAI;IACFA,GAAG,GAAGC,OAAO,CAAC,6CAA6C,CAAC;EAC9D,CAAC,CAAC,OAAOC,CAAC,EAAE;IACV,OAAO;MAAEC,OAAO,EAAE,IAAI;MAAEC,MAAM,EAAGF,CAAC,EAAYG,OAAO,IAAI;IAAiC,CAAC;EAC7F;EACA,MAAMC,SAAS,GAAKN,GAAG,EAA4BO,OAAO,IAAIP,GAEjD;EACb,IAAI,OAAOM,SAAS,EAAEE,WAAW,KAAK,UAAU,EAAE;IAChD,OAAO;MAAEL,OAAO,EAAE,IAAI;MAAEC,MAAM,EAAE;IAAqC,CAAC;EACxE;EACA,OAAO;IAAED,OAAO,EAAEG,SAAS;IAAEF,MAAM,EAAE;EAAK,CAAC;AAC7C","ignoreList":[]}

package/lib/commonjs/scan/focusableScanner.js

@@ -1 +1,497 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.requestFocusForTag=requestFocusForTag,exports.scanFocusables=scanFocusables;var _reactNative=require("react-native");const OffscreenComponent=22,INTERNAL_NAMES=new Set(["View","RCTView","ScrollView","RCTScrollView","RCTScrollContentView","SafeAreaView","RCTSafeAreaView","AndroidHorizontalScrollContentView","KeyboardAvoidingView","Pressable","PlatformPressable","TouchableOpacity","TouchableHighlight","TouchableWithoutFeedback","TouchableNativeFeedback","AnimatedComponent","Wrapper"]),GUIDE_NAME="TVFocusGuideView";function getReactDevToolsHook(){return"undefined"==typeof global?null:global.__REACT_DEVTOOLS_GLOBAL_HOOK__??null}function getAllFiberRoots(){const e=getReactDevToolsHook();if(!e)return[];const n=[];try{if(e.renderers&&"function"==typeof e.renderers.forEach&&e.renderers.forEach((t,o)=>{try{const t=e.getFiberRoots?.(o);t&&t.forEach(e=>n.push(e))}catch{}}),0===n.length&&e.getFiberRoots){const t=e.getFiberRoots(1);t&&t.forEach(e=>n.push(e))}}catch{}return n}function isHiddenOffscreen(e){return 22===e.tag&&null!==e.memoizedState}function isInactiveScreen(e){const n=e.memoizedProps?.activityState;return 0===n||1===n||!1===e.memoizedProps?.isPageFocused}function getProps(e){return e?.memoizedProps??e?.pendingProps??null}function getComponentName(e){const n=e?.type;return n?"string"==typeof n?n:n.displayName||n.name||null:null}function getOwningComponentName(e){let n=e?._debugOwner||e?.return,t=0;for(;n&&t<30;){t++;const e=getComponentName(n);if(e&&!INTERNAL_NAMES.has(e)&&"string"!=typeof n.type)return e;n=n.return}return null}function getPublicInstance(e){if(!e)return null;const n=e;return n.canonical?.publicInstance?n.canonical.publicInstance:n.canonical&&"function"==typeof n.canonical.measure?n.canonical:"function"==typeof n.measure||"function"==typeof n.measureInWindow?n:null}function getNativeTag(e){if(null==e)return null;const n=e;if("number"==typeof n.__nativeTag)return n.__nativeTag;if("number"==typeof n._nativeTag)return n._nativeTag;if("number"==typeof n.nativeTag)return n.nativeTag;if(n.canonical){if("number"==typeof n.canonical.__nativeTag)return n.canonical.__nativeTag;if("number"==typeof n.canonical._nativeTag)return n.canonical._nativeTag;if("number"==typeof n.canonical.nativeTag)return n.canonical.nativeTag}return null}function findHostInstance(e){const n=getPublicInstance(e.stateNode);if(n)return{instance:n,nativeTag:getNativeTag(e.stateNode)};const t=[];e.child&&t.push(e.child);let o=0;for(;t.length>0&&o<4e3;){o++;const e=t.pop();if(!e)continue;const n=getPublicInstance(e.stateNode);if(n)return{instance:n,nativeTag:getNativeTag(e.stateNode)};e.child&&t.push(e.child),e.sibling&&t.push(e.sibling)}return null}function focusableFlag(e){return"boolean"==typeof e.isTVSelectable?e.isTVSelectable:"boolean"==typeof e.focusable?e.focusable:"boolean"==typeof e.tvFocusable?e.tvFocusable:void 0}function nextFocusFlags(e){const n="number"==typeof e.nextFocusUp,t="number"==typeof e.nextFocusDown,o="number"==typeof e.nextFocusLeft,i="number"==typeof e.nextFocusRight;if(n||t||o||i)return{up:n||void 0,down:t||void 0,left:o||void 0,right:i||void 0}}function getVisibleText(e){if(!e)return;const n=e=>"string"==typeof e?e.trim()?e.trim().slice(0,60):void 0:"number"==typeof e&&Number.isFinite(e)?String(e):void 0;return n(e.children)??n(e.title)??n(e.label)??void 0}function collectDescendantText(e,n){const t=[],o=(i,s)=>{if(!i||s>n||t.length>=3)return;if(i!==e){const e=getProps(i);if(e&&"function"==typeof e.onPress)return}const r=getVisibleText(getProps(i));r&&!t.includes(r)&&t.push(r),i.child&&o(i.child,s+1),i!==e&&i.sibling&&o(i.sibling,s)};e.child&&o(e.child,1);const i=t.join(" ").trim();return i?i.slice(0,60):void 0}function measureInstance(e){return new Promise(n=>{let t=!1;const o=e=>{t||(t=!0,n(e))};setTimeout(()=>o(null),1e3);try{"function"==typeof e.measureInWindow?e.measureInWindow((e,n,t,i)=>{o(t>0&&i>0?{x:e,y:n,width:t,height:i}:null)}):"function"==typeof e.measure?e.measure((e,n,t,i,s,r)=>{o(t>0&&i>0&&null!=s&&null!=r?{x:s,y:r,width:t,height:i}:null)}):o(null)}catch{o(null)}})}const instancesByTag=new Map;function walk(e,n,t){const o=[{fiber:e,context:n,depth:0}],i=new Set;for(;o.length>0;){const e=o.pop();if(!e)continue;const{fiber:n,depth:s}=e;if(!n||i.has(n)||s>500)continue;if(i.add(n),isHiddenOffscreen(n)||isInactiveScreen(n)){n.sibling&&o.push({fiber:n.sibling,context:e.context,depth:s});continue}const r=t(n,e.context);n.sibling&&o.push({fiber:n.sibling,context:e.context,depth:s}),n.child&&o.push({fiber:n.child,context:r,depth:s+1})}}function collectCandidates(){const e=getAllFiberRoots();if(0===e.length)return[];const n=[],t=new Set;for(const o of e)walk(o.current,{guideTag:null},(e,o)=>{const i=getProps(e);if(!i)return o;const s=getComponentName(e),r=s===GUIDE_NAME,a=focusableFlag(i),c="function"==typeof i.onPress||"function"==typeof i.onLongPress,u=!0===i.hasTVPreferredFocus,l=nextFocusFlags(i);if(!(r||!0===a||u||l||c&&!1!==a))return o;const f=findHostInstance(e),d=f?.nativeTag??null;if(null===d)return o;const g=r?{guideTag:d}:o;if(t.has(d)){const e=n.find(e=>e.node.nativeTag===d);return e&&(void 0!==a&&void 0===e.node.focusProps.focusable&&(e.node.focusProps.focusable=a),u&&(e.node.focusProps.hasTVPreferredFocus=!0),l&&!e.node.focusProps.nextFocus&&(e.node.focusProps.nextFocus=l),c&&(e.node.pressable=!0),!e.node.testID&&i.testID&&(e.node.testID=i.testID),r&&!e.node.guide&&(e.node.guide=readGuide(i),e.node.name=GUIDE_NAME)),g}t.add(d);let p=s??"Unknown";s&&!INTERNAL_NAMES.has(s)&&"string"!=typeof e.type||(p=getOwningComponentName(e)??s??"Unknown");const h=i.accessibilityLabel||void 0,b=getVisibleText(i)??(c?collectDescendantText(e,6):void 0),m={nativeTag:d,name:r?GUIDE_NAME:p,owner:getOwningComponentName(e)??void 0,testID:i.testID||void 0,label:h,text:b,focusProps:{focusable:a,hasTVPreferredFocus:u||void 0,nextFocus:l},guide:r?readGuide(i):void 0,guideAncestorTag:o.guideTag??void 0,pressable:c||void 0};return f?.instance&&instancesByTag.set(d,f.instance),n.push({node:m,instance:f?.instance??null}),g});return n}function readGuide(e){return{autoFocus:!0===e.autoFocus,hasDestinations:Array.isArray(e.destinations)&&e.destinations.length>0,enabled:!1!==e.enabled,trap:{up:!0===e.trapFocusUp,down:!0===e.trapFocusDown,left:!0===e.trapFocusLeft,right:!0===e.trapFocusRight}}}function round3(e){return Math.round(1e3*e)/1e3}const MAX_NODES=400;async function scanFocusables(){instancesByTag.clear();const e=collectCandidates();await Promise.all(e.map(async e=>{if(!e.instance)return;const n=await measureInstance(e.instance);n&&(e.node.frame=n)}));const n=_reactNative.Dimensions.get("window"),t=Math.round(n.width)||1,o=Math.round(n.height)||1,i=[];for(const n of e){const e=n.node.frame;if(e){const i=e.x+e.width/2,s=e.y+e.height/2;n.node.onScreen=s>=0&&s<=o&&i>=0&&i<=t,n.node.frame={x:round3(e.x/t),y:round3(e.y/o),width:round3(e.width/t),height:round3(e.height/o)}}if(i.push(n.node),i.length>=MAX_NODES)break}return i.sort((e,n)=>{const t=e.frame?.y??2,o=n.frame?.y??2;return Math.abs(t-o)>.01?t-o:(e.frame?.x??2)-(n.frame?.x??2)}),{screen:{width:t,height:o},nodes:i,scannedAt:Date.now()}}function requestFocusForTag(e){const n=instancesByTag.get(e);if(!n)return{ok:!1,reason:"Unknown tag — rescan and try again."};if("function"!=typeof n.requestTVFocus)return{ok:!1,reason:"This element exposes no requestTVFocus()."};try{return n.requestTVFocus(),{ok:!0}}catch(e){return{ok:!1,reason:e?.message??"requestTVFocus() threw."}}}
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.requestFocusForTag = requestFocusForTag;
+exports.scanFocusables = scanFocusables;
+var _reactNative = require("react-native");
+/**
+ * focusableScanner — a read-only fiber walk that inventories everything on
+ * screen the TV focus engine could land on.
+ *
+ * Provably inert: it reads `memoizedProps` and calls `measureInWindow`. It adds
+ * no views, sets no props, and calls no focus command — which matters more here
+ * than anywhere else in Buoy, because on Android TV a single focusable view we
+ * rendered would insert itself into the host app's focus order and change the
+ * very navigation this tool measures.
+ *
+ * Traversal (multi-renderer roots, the Fabric/Paper/CLI-dev instance triad,
+ * Offscreen + inactive-`react-native-screens` pruning, measure-with-a-hang-
+ * guard) follows the house pattern from
+ * `packages/highlight-updates/src/highlight-updates/utils/screenElements.ts`.
+ * The repo convention is a per-package copy trimmed to the tool's needs rather
+ * than a shared walker library — see packages/CLAUDE.md.
+ *
+ * There is no JS API for "which view has focus" and none for "if focus is here
+ * and the user presses RIGHT, where does it go" (Android has
+ * `FabricUIManager.findNextFocusableElement` natively but never exposes it to
+ * JS; tvOS's UIKit engine decides at runtime and answers nothing). So this
+ * inventory is the *candidate set* — the observed transition stream is what
+ * says which of them focus actually reaches.
+ */
+
+const OffscreenComponent = 22;
+
+/** Host wrappers whose own name says nothing — fall through to the owner. */
+const INTERNAL_NAMES = new Set(["View", "RCTView", "ScrollView", "RCTScrollView", "RCTScrollContentView", "SafeAreaView", "RCTSafeAreaView", "AndroidHorizontalScrollContentView", "KeyboardAvoidingView", "Pressable", "PlatformPressable", "TouchableOpacity", "TouchableHighlight", "TouchableWithoutFeedback", "TouchableNativeFeedback", "AnimatedComponent", "Wrapper"]);
+
+/** The composite that renders an invisible focus stop. */
+const GUIDE_NAME = "TVFocusGuideView";
+// --- fiber plumbing -------------------------------------------------------
+
+function getReactDevToolsHook() {
+  if (typeof global === "undefined") return null;
+  return global.__REACT_DEVTOOLS_GLOBAL_HOOK__ ?? null;
+}
+
+/**
+ * Roots across ALL renderers. A single renderer id is not safe to assume:
+ * secondary reconcilers (skia, svg) register their own, sometimes first.
+ */
+function getAllFiberRoots() {
+  const hook = getReactDevToolsHook();
+  if (!hook) return [];
+  const roots = [];
+  try {
+    if (hook.renderers && typeof hook.renderers.forEach === "function") {
+      hook.renderers.forEach((_r, rendererId) => {
+        try {
+          const set = hook.getFiberRoots?.(rendererId);
+          if (set) set.forEach(root => roots.push(root));
+        } catch {
+          /* one renderer failing must not lose the others */
+        }
+      });
+    }
+    if (roots.length === 0 && hook.getFiberRoots) {
+      const legacy = hook.getFiberRoots(1);
+      if (legacy) legacy.forEach(root => roots.push(root));
+    }
+  } catch {
+    /* ignore */
+  }
+  return roots;
+}
+function isHiddenOffscreen(fiber) {
+  return fiber.tag === OffscreenComponent && fiber.memoizedState !== null;
+}
+function isInactiveScreen(fiber) {
+  // react-native-screens: activityState 0/1 = inactive/transitioning. A card
+  // sitting behind the current screen still has focusable props but is not a
+  // focus target — counting it would tank the coverage number forever.
+  const activityState = fiber.memoizedProps?.activityState;
+  if (activityState === 0 || activityState === 1) return true;
+  if (fiber.memoizedProps?.isPageFocused === false) return true;
+  return false;
+}
+function getProps(fiber) {
+  return fiber?.memoizedProps ?? fiber?.pendingProps ?? null;
+}
+function getComponentName(fiber) {
+  const type = fiber?.type;
+  if (!type) return null;
+  if (typeof type === "string") return type;
+  return type.displayName || type.name || null;
+}
+function getOwningComponentName(fiber) {
+  let cur = fiber?._debugOwner || fiber?.return;
+  let depth = 0;
+  while (cur && depth < 30) {
+    depth++;
+    const name = getComponentName(cur);
+    if (name && !INTERNAL_NAMES.has(name) && typeof cur.type !== "string") return name;
+    cur = cur.return;
+  }
+  return null;
+}
+/** The Fabric / Paper / RN-CLI-dev instance triad — always check all three. */
+function getPublicInstance(stateNode) {
+  if (!stateNode) return null;
+  const node = stateNode;
+  if (node.canonical?.publicInstance) return node.canonical.publicInstance;
+  if (node.canonical && typeof node.canonical.measure === "function") return node.canonical;
+  if (typeof node.measure === "function" || typeof node.measureInWindow === "function") {
+    return node;
+  }
+  return null;
+}
+function getNativeTag(stateNode) {
+  if (stateNode == null) return null;
+  const n = stateNode;
+  if (typeof n.__nativeTag === "number") return n.__nativeTag;
+  if (typeof n._nativeTag === "number") return n._nativeTag;
+  if (typeof n.nativeTag === "number") return n.nativeTag;
+  if (n.canonical) {
+    if (typeof n.canonical.__nativeTag === "number") return n.canonical.__nativeTag;
+    if (typeof n.canonical._nativeTag === "number") return n.canonical._nativeTag;
+    if (typeof n.canonical.nativeTag === "number") return n.canonical.nativeTag;
+  }
+  return null;
+}
+
+/** First host node at or below a fiber (self first, then a bounded subtree DFS). */
+function findHostInstance(fiber) {
+  const selfInstance = getPublicInstance(fiber.stateNode);
+  if (selfInstance) {
+    return {
+      instance: selfInstance,
+      nativeTag: getNativeTag(fiber.stateNode)
+    };
+  }
+  const stack = [];
+  if (fiber.child) stack.push(fiber.child);
+  let guard = 0;
+  while (stack.length > 0 && guard < 4000) {
+    guard++;
+    const f = stack.pop();
+    if (!f) continue;
+    const instance = getPublicInstance(f.stateNode);
+    if (instance) return {
+      instance,
+      nativeTag: getNativeTag(f.stateNode)
+    };
+    if (f.child) stack.push(f.child);
+    if (f.sibling) stack.push(f.sibling);
+  }
+  return null;
+}
+
+// --- candidate predicate --------------------------------------------------
+
+/**
+ * The props that make a view a focus candidate, per the fork's own mapping:
+ * on iOS `View` writes `focusable ?? isTVSelectable` into `isTVSelectable` and
+ * DELETES `focusable`; on Android it writes `focusable` and deletes
+ * `isTVSelectable`. So both names have to be accepted — the host fiber only
+ * ever carries one of them, and which one depends on the platform.
+ */
+function focusableFlag(props) {
+  if (typeof props.isTVSelectable === "boolean") return props.isTVSelectable;
+  if (typeof props.focusable === "boolean") return props.focusable;
+  if (typeof props.tvFocusable === "boolean") return props.tvFocusable;
+  return undefined;
+}
+function nextFocusFlags(props) {
+  const up = typeof props.nextFocusUp === "number";
+  const down = typeof props.nextFocusDown === "number";
+  const left = typeof props.nextFocusLeft === "number";
+  const right = typeof props.nextFocusRight === "number";
+  if (!up && !down && !left && !right) return undefined;
+  return {
+    up: up || undefined,
+    down: down || undefined,
+    left: left || undefined,
+    right: right || undefined
+  };
+}
+function getVisibleText(props) {
+  if (!props) return undefined;
+  const pick = value => {
+    if (typeof value === "string") return value.trim() ? value.trim().slice(0, 60) : undefined;
+    if (typeof value === "number" && Number.isFinite(value)) return String(value);
+    return undefined;
+  };
+  return pick(props.children) ?? pick(props.title) ?? pick(props.label) ?? undefined;
+}
+
+/** A focusable's own label, gathered from descendants without crossing into another stop. */
+function collectDescendantText(root, maxDepth) {
+  const parts = [];
+  const visit = (fiber, depth) => {
+    if (!fiber || depth > maxDepth || parts.length >= 3) return;
+    if (fiber !== root) {
+      const props = getProps(fiber);
+      if (props && typeof props.onPress === "function") return;
+    }
+    const text = getVisibleText(getProps(fiber));
+    if (text && !parts.includes(text)) parts.push(text);
+    if (fiber.child) visit(fiber.child, depth + 1);
+    if (fiber !== root && fiber.sibling) visit(fiber.sibling, depth);
+  };
+  if (root.child) visit(root.child, 1);
+  const joined = parts.join(" ").trim();
+  return joined ? joined.slice(0, 60) : undefined;
+}
+
+// --- measurement ----------------------------------------------------------
+
+function measureInstance(instance) {
+  return new Promise(resolve => {
+    let settled = false;
+    const done = rect => {
+      if (settled) return;
+      settled = true;
+      resolve(rect);
+    };
+    // Detached / off-screen nodes can fire NEITHER callback — without this the
+    // whole scan would hang on one stale node.
+    setTimeout(() => done(null), 1000);
+    try {
+      if (typeof instance.measureInWindow === "function") {
+        instance.measureInWindow((x, y, width, height) => {
+          done(width > 0 && height > 0 ? {
+            x,
+            y,
+            width,
+            height
+          } : null);
+        });
+      } else if (typeof instance.measure === "function") {
+        instance.measure((_x, _y, width, height, pageX, pageY) => {
+          done(width > 0 && height > 0 && pageX != null && pageY != null ? {
+            x: pageX,
+            y: pageY,
+            width,
+            height
+          } : null);
+        });
+      } else {
+        done(null);
+      }
+    } catch {
+      done(null);
+    }
+  });
+}
+
+// --- collection -----------------------------------------------------------
+
+/**
+ * A live handle on the element behind a native tag, kept out of the wire
+ * snapshot. `focusElement` needs the public INSTANCE (Commands take instance
+ * refs, never tags), so the last scan's instances are the lookup table.
+ */
+const instancesByTag = new Map();
+function walk(fiber, context, visit) {
+  const stack = [{
+    fiber,
+    context,
+    depth: 0
+  }];
+  const seen = new Set();
+  while (stack.length > 0) {
+    const entry = stack.pop();
+    if (!entry) continue;
+    const {
+      fiber: current,
+      depth
+    } = entry;
+    if (!current || seen.has(current) || depth > 500) continue;
+    seen.add(current);
+    if (isHiddenOffscreen(current) || isInactiveScreen(current)) {
+      // Prune the subtree, keep walking siblings.
+      if (current.sibling) {
+        stack.push({
+          fiber: current.sibling,
+          context: entry.context,
+          depth
+        });
+      }
+      continue;
+    }
+    const childContext = visit(current, entry.context);
+    if (current.sibling) stack.push({
+      fiber: current.sibling,
+      context: entry.context,
+      depth
+    });
+    if (current.child) stack.push({
+      fiber: current.child,
+      context: childContext,
+      depth: depth + 1
+    });
+  }
+}
+function collectCandidates() {
+  const roots = getAllFiberRoots();
+  if (roots.length === 0) return [];
+  const out = [];
+  const seenTags = new Set();
+  for (const root of roots) {
+    walk(root.current, {
+      guideTag: null
+    }, (fiber, context) => {
+      const props = getProps(fiber);
+      if (!props) return context;
+      const componentName = getComponentName(fiber);
+      const isGuide = componentName === GUIDE_NAME;
+      const flag = focusableFlag(props);
+      const pressable = typeof props.onPress === "function" || typeof props.onLongPress === "function";
+      const hasPreferred = props.hasTVPreferredFocus === true;
+      const nextFocus = nextFocusFlags(props);
+
+      // A composite Pressable and its host View both match; the host is the one
+      // that carries the native tag focus events report, so dedupe on the tag.
+      const isCandidate = isGuide || flag === true || hasPreferred || !!nextFocus || pressable && flag !== false;
+      if (!isCandidate) return context;
+      const host = findHostInstance(fiber);
+      const nativeTag = host?.nativeTag ?? null;
+      if (nativeTag === null) return context;
+      const nextContext = isGuide ? {
+        guideTag: nativeTag
+      } : context;
+      if (seenTags.has(nativeTag)) {
+        // Merge the richer signal onto the row already recorded for this tag —
+        // the composite knows the name, the host knows the focus props.
+        const existing = out.find(c => c.node.nativeTag === nativeTag);
+        if (existing) {
+          if (flag !== undefined && existing.node.focusProps.focusable === undefined) {
+            existing.node.focusProps.focusable = flag;
+          }
+          if (hasPreferred) existing.node.focusProps.hasTVPreferredFocus = true;
+          if (nextFocus && !existing.node.focusProps.nextFocus) {
+            existing.node.focusProps.nextFocus = nextFocus;
+          }
+          if (pressable) existing.node.pressable = true;
+          if (!existing.node.testID && props.testID) existing.node.testID = props.testID;
+          if (isGuide && !existing.node.guide) {
+            existing.node.guide = readGuide(props);
+            existing.node.name = GUIDE_NAME;
+          }
+        }
+        return nextContext;
+      }
+      seenTags.add(nativeTag);
+      let name = componentName ?? "Unknown";
+      if (!componentName || INTERNAL_NAMES.has(componentName) || typeof fiber.type === "string") {
+        name = getOwningComponentName(fiber) ?? componentName ?? "Unknown";
+      }
+      const label = props.accessibilityLabel || undefined;
+      const text = getVisibleText(props) ?? (pressable ? collectDescendantText(fiber, 6) : undefined);
+      const node = {
+        nativeTag,
+        name: isGuide ? GUIDE_NAME : name,
+        owner: getOwningComponentName(fiber) ?? undefined,
+        testID: props.testID || undefined,
+        label,
+        text,
+        focusProps: {
+          focusable: flag,
+          hasTVPreferredFocus: hasPreferred || undefined,
+          nextFocus
+        },
+        guide: isGuide ? readGuide(props) : undefined,
+        guideAncestorTag: context.guideTag ?? undefined,
+        pressable: pressable || undefined
+      };
+      if (host?.instance) instancesByTag.set(nativeTag, host.instance);
+      out.push({
+        node,
+        instance: host?.instance ?? null
+      });
+      return nextContext;
+    });
+  }
+  return out;
+}
+function readGuide(props) {
+  return {
+    autoFocus: props.autoFocus === true,
+    hasDestinations: Array.isArray(props.destinations) && props.destinations.length > 0,
+    enabled: props.enabled !== false,
+    trap: {
+      up: props.trapFocusUp === true,
+      down: props.trapFocusDown === true,
+      left: props.trapFocusLeft === true,
+      right: props.trapFocusRight === true
+    }
+  };
+}
+function round3(n) {
+  return Math.round(n * 1000) / 1000;
+}
+
+/** Cap the inventory so a pathological screen can't blow the snapshot budget. */
+const MAX_NODES = 400;
+async function scanFocusables() {
+  instancesByTag.clear();
+  const candidates = collectCandidates();
+  await Promise.all(candidates.map(async candidate => {
+    if (!candidate.instance) return;
+    const rect = await measureInstance(candidate.instance);
+    if (!rect) return;
+    candidate.node.frame = rect;
+  }));
+  const window = _reactNative.Dimensions.get("window");
+  const screenW = Math.round(window.width) || 1;
+  const screenH = Math.round(window.height) || 1;
+  const nodes = [];
+  for (const candidate of candidates) {
+    const rect = candidate.node.frame;
+    if (rect) {
+      // A guide's own box is often a 1x1 sliver (its StyleSheet minWidth), so
+      // there is no minimum-size filter here — the invisible stop IS the point.
+      //
+      // Off-window elements are KEPT, unlike in the describe-screen walker this
+      // is adapted from. A tile below a ScrollView's fold is still somewhere the
+      // D-pad goes (the engine scrolls to it), so dropping it would under-report
+      // the coverage denominator — the tool's headline number — and would make
+      // rows vanish from the inventory as the user scrolls. Previous router
+      // screens are already pruned by the inactive-`react-native-screens` check
+      // during the walk, which is the case the drop existed for.
+      const cx = rect.x + rect.width / 2;
+      const cy = rect.y + rect.height / 2;
+      candidate.node.onScreen = cy >= 0 && cy <= screenH && cx >= 0 && cx <= screenW;
+      candidate.node.frame = {
+        x: round3(rect.x / screenW),
+        y: round3(rect.y / screenH),
+        width: round3(rect.width / screenW),
+        height: round3(rect.height / screenH)
+      };
+    }
+    nodes.push(candidate.node);
+    if (nodes.length >= MAX_NODES) break;
+  }
+
+  // Reading order, so the inventory table matches how a person scans the screen.
+  nodes.sort((a, b) => {
+    const ay = a.frame?.y ?? 2;
+    const by = b.frame?.y ?? 2;
+    if (Math.abs(ay - by) > 0.01) return ay - by;
+    return (a.frame?.x ?? 2) - (b.frame?.x ?? 2);
+  });
+  return {
+    screen: {
+      width: screenW,
+      height: screenH
+    },
+    nodes,
+    scannedAt: Date.now()
+  };
+}
+
+/**
+ * Move focus to a native tag. Source-verified only until this runs on a device:
+ * `Commands.requestTVFocus` takes an instance ref, never a tag, so the last
+ * scan's instance table is the only way to get from one to the other.
+ */
+function requestFocusForTag(nativeTag) {
+  const instance = instancesByTag.get(nativeTag);
+  if (!instance) {
+    return {
+      ok: false,
+      reason: "Unknown tag — rescan and try again."
+    };
+  }
+  if (typeof instance.requestTVFocus !== "function") {
+    // `requestTVFocus` is attached by RN's View to its instance; a host that
+    // isn't a View (Text, Image) never gets one.
+    return {
+      ok: false,
+      reason: "This element exposes no requestTVFocus()."
+    };
+  }
+  try {
+    instance.requestTVFocus();
+    return {
+      ok: true
+    };
+  } catch (e) {
+    return {
+      ok: false,
+      reason: e?.message ?? "requestTVFocus() threw."
+    };
+  }
+}
+//# sourceMappingURL=focusableScanner.js.map