@buoy-gg/focus-inspector 7.0.41 → 7.0.42

package/lib/module/scan/focusableScanner.js

@@ -1,497 +1 @@
-"use strict";
-
-import { getDOMNodeHandle, getDOMPublicInstance, isDOMElement } from "@buoy-gg/shared-ui/utils";
-/**
- * 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.
- */
-
-import { Dimensions } from "react-native";
-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) {
-  const dom = getDOMPublicInstance(stateNode);
-  if (dom) return dom;
-  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) {
-  const dom = getDOMNodeHandle(stateNode);
-  if (dom !== null) return dom;
-  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 || isDOMElement(fiber.stateNode) && fiber.stateNode.matches('a[href],button,input,select,textarea,[tabindex],[contenteditable="true"]') && !fiber.stateNode.matches(':disabled,[inert], [tabindex="-1"]');
-      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 || props["aria-label"] || 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 || props["data-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;
-export 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 = 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.
- */
-export 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
+"use strict";import{getDOMNodeHandle as O,getDOMPublicInstance as R,isDOMElement as E}from"@buoy-gg/shared-ui/utils";import{Dimensions as M}from"react-native";const H=22;const x=new Set(["View","RCTView","ScrollView","RCTScrollView","RCTScrollContentView","SafeAreaView","RCTSafeAreaView","AndroidHorizontalScrollContentView","KeyboardAvoidingView","Pressable","PlatformPressable","TouchableOpacity","TouchableHighlight","TouchableWithoutFeedback","TouchableNativeFeedback","AnimatedComponent","Wrapper"]);const y="TVFocusGuideView";function L(){if(typeof global==="undefined")return null;return global.__REACT_DEVTOOLS_GLOBAL_HOOK__??null}function U(){const e=L();if(!e)return[];const o=[];try{if(e.renderers&&typeof e.renderers.forEach==="function"){e.renderers.forEach((n,r)=>{try{const s=e.getFiberRoots?.(r);if(s)s.forEach(i=>o.push(i))}catch{}})}if(o.length===0&&e.getFiberRoots){const n=e.getFiberRoots(1);if(n)n.forEach(r=>o.push(r))}}catch{}return o}function W(e){return e.tag===H&&e.memoizedState!==null}function q(e){const o=e.memoizedProps?.activityState;if(o===0||o===1)return true;if(e.memoizedProps?.isPageFocused===false)return true;return false}function b(e){return e?.memoizedProps??e?.pendingProps??null}function P(e){const o=e?.type;if(!o)return null;if(typeof o==="string")return o;return o.displayName||o.name||null}function _(e){let o=e?._debugOwner||e?.return;let n=0;while(o&&n<30){n++;const r=P(o);if(r&&!x.has(r)&&typeof o.type!=="string")return r;o=o.return}return null}function v(e){const o=R(e);if(o)return o;if(!e)return null;const n=e;if(n.canonical?.publicInstance)return n.canonical.publicInstance;if(n.canonical&&typeof n.canonical.measure==="function")return n.canonical;if(typeof n.measure==="function"||typeof n.measureInWindow==="function"){return n}return null}function V(e){const o=O(e);if(o!==null)return o;if(e==null)return null;const n=e;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}function z(e){const o=v(e.stateNode);if(o){return{instance:o,nativeTag:V(e.stateNode)}}const n=[];if(e.child)n.push(e.child);let r=0;while(n.length>0&&r<4e3){r++;const s=n.pop();if(!s)continue;const i=v(s.stateNode);if(i)return{instance:i,nativeTag:V(s.stateNode)};if(s.child)n.push(s.child);if(s.sibling)n.push(s.sibling)}return null}function G(e){if(typeof e.isTVSelectable==="boolean")return e.isTVSelectable;if(typeof e.focusable==="boolean")return e.focusable;if(typeof e.tvFocusable==="boolean")return e.tvFocusable;return void 0}function j(e){const o=typeof e.nextFocusUp==="number";const n=typeof e.nextFocusDown==="number";const r=typeof e.nextFocusLeft==="number";const s=typeof e.nextFocusRight==="number";if(!o&&!n&&!r&&!s)return void 0;return{up:o||void 0,down:n||void 0,left:r||void 0,right:s||void 0}}function S(e){if(!e)return void 0;const o=n=>{if(typeof n==="string")return n.trim()?n.trim().slice(0,60):void 0;if(typeof n==="number"&&Number.isFinite(n))return String(n);return void 0};return o(e.children)??o(e.title)??o(e.label)??void 0}function B(e,o){const n=[];const r=(i,t)=>{if(!i||t>o||n.length>=3)return;if(i!==e){const c=b(i);if(c&&typeof c.onPress==="function")return}const u=S(b(i));if(u&&!n.includes(u))n.push(u);if(i.child)r(i.child,t+1);if(i!==e&&i.sibling)r(i.sibling,t)};if(e.child)r(e.child,1);const s=n.join(" ").trim();return s?s.slice(0,60):void 0}function K(e){return new Promise(o=>{let n=false;const r=s=>{if(n)return;n=true;o(s)};setTimeout(()=>r(null),1e3);try{if(typeof e.measureInWindow==="function"){e.measureInWindow((s,i,t,u)=>{r(t>0&&u>0?{x:s,y:i,width:t,height:u}:null)})}else if(typeof e.measure==="function"){e.measure((s,i,t,u,c,f)=>{r(t>0&&u>0&&c!=null&&f!=null?{x:c,y:f,width:t,height:u}:null)})}else{r(null)}}catch{r(null)}})}const T=new Map;function J(e,o,n){const r=[{fiber:e,context:o,depth:0}];const s=new Set;while(r.length>0){const i=r.pop();if(!i)continue;const{fiber:t,depth:u}=i;if(!t||s.has(t)||u>500)continue;s.add(t);if(W(t)||q(t)){if(t.sibling){r.push({fiber:t.sibling,context:i.context,depth:u})}continue}const c=n(t,i.context);if(t.sibling)r.push({fiber:t.sibling,context:i.context,depth:u});if(t.child)r.push({fiber:t.child,context:c,depth:u+1})}}function Q(){const e=U();if(e.length===0)return[];const o=[];const n=new Set;for(const r of e){J(r.current,{guideTag:null},(s,i)=>{const t=b(s);if(!t)return i;const u=P(s);const c=u===y;const f=G(t);const d=typeof t.onPress==="function"||typeof t.onLongPress==="function";const p=t.hasTVPreferredFocus===true;const g=j(t);const I=c||f===true||p||!!g||d&&f!==false||E(s.stateNode)&&s.stateNode.matches('a[href],button,input,select,textarea,[tabindex],[contenteditable="true"]')&&!s.stateNode.matches(':disabled,[inert], [tabindex="-1"]');if(!I)return i;const h=z(s);const l=h?.nativeTag??null;if(l===null)return i;const w=c?{guideTag:l}:i;if(n.has(l)){const a=o.find(C=>C.node.nativeTag===l);if(a){if(f!==void 0&&a.node.focusProps.focusable===void 0){a.node.focusProps.focusable=f}if(p)a.node.focusProps.hasTVPreferredFocus=true;if(g&&!a.node.focusProps.nextFocus){a.node.focusProps.nextFocus=g}if(d)a.node.pressable=true;if(!a.node.testID&&t.testID)a.node.testID=t.testID;if(c&&!a.node.guide){a.node.guide=D(t);a.node.name=y}}return w}n.add(l);let F=u??"Unknown";if(!u||x.has(u)||typeof s.type==="string"){F=_(s)??u??"Unknown"}const k=t.accessibilityLabel||t["aria-label"]||void 0;const A=S(t)??(d?B(s,6):void 0);const N={nativeTag:l,name:c?y:F,owner:_(s)??void 0,testID:t.testID||t["data-testid"]||void 0,label:k,text:A,focusProps:{focusable:f,hasTVPreferredFocus:p||void 0,nextFocus:g},guide:c?D(t):void 0,guideAncestorTag:i.guideTag??void 0,pressable:d||void 0};if(h?.instance)T.set(l,h.instance);o.push({node:N,instance:h?.instance??null});return w})}return o}function D(e){return{autoFocus:e.autoFocus===true,hasDestinations:Array.isArray(e.destinations)&&e.destinations.length>0,enabled:e.enabled!==false,trap:{up:e.trapFocusUp===true,down:e.trapFocusDown===true,left:e.trapFocusLeft===true,right:e.trapFocusRight===true}}}function m(e){return Math.round(e*1e3)/1e3}const X=400;export async function scanFocusables(){T.clear();const e=Q();await Promise.all(e.map(async i=>{if(!i.instance)return;const t=await K(i.instance);if(!t)return;i.node.frame=t}));const o=M.get("window");const n=Math.round(o.width)||1;const r=Math.round(o.height)||1;const s=[];for(const i of e){const t=i.node.frame;if(t){const u=t.x+t.width/2;const c=t.y+t.height/2;i.node.onScreen=c>=0&&c<=r&&u>=0&&u<=n;i.node.frame={x:m(t.x/n),y:m(t.y/r),width:m(t.width/n),height:m(t.height/r)}}s.push(i.node);if(s.length>=X)break}s.sort((i,t)=>{const u=i.frame?.y??2;const c=t.frame?.y??2;if(Math.abs(u-c)>.01)return u-c;return(i.frame?.x??2)-(t.frame?.x??2)});return{screen:{width:n,height:r},nodes:s,scannedAt:Date.now()}}export function requestFocusForTag(e){const o=T.get(e);if(!o){return{ok:false,reason:"Unknown tag \u2014 rescan and try again."}}if(typeof o.requestTVFocus!=="function"){return{ok:false,reason:"This element exposes no requestTVFocus()."}}try{o.requestTVFocus();return{ok:true}}catch(n){return{ok:false,reason:n?.message??"requestTVFocus() threw."}}}