@buoy-gg/focus-inspector 7.0.40 → 7.0.42

package/lib/module/store/focusStore.js

@@ -1,312 +1 @@
-"use strict";
-
-/**
- * focusStore — the device-side memory of the TV focus inspector.
- *
- * CONTRACT: this store only ever OBSERVES. It never adds a view, never sets a
- * prop, never calls a focus command on its own. On Android TV any focusable
- * view we rendered would become a D-pad stop in the host app's focus order, so
- * a tool that measures focus by participating in it would measure itself. The
- * only thing that ever moves focus is the explicit `focusElement` action a
- * human triggers from the dashboard.
- *
- * It is deliberately react-native-free: observers push events in, so every rule
- * below (transition pairing, direction attribution, dead-end probes) is a pure
- * function of a timestamped event stream and is unit-testable without a device.
- */
-
-/** The four D-pad directions. Select/menu never move focus, so they're dropped. */
-
-/**
- * One D-pad press, recorded against the element that held focus when it
- * happened, plus what it did. A probe with `movedTo: null` is one piece of
- * dead-end evidence; N consecutive ones in the same direction is a flag.
- */
-
-/**
- * Why nothing is reported as focused. These are NOT the same thing and must
- * never be rendered the same way:
- *
- * - "never-observed": we have not seen a single focus event yet. Focus is
- *   almost certainly fine — there is no API for "which view has focus", so the
- *   tool learns the answer only when focus MOVES. Attaching to an app that is
- *   sitting still looks exactly like this until the first press.
- * - "lost": we WATCHED a view blur with nothing taking over. That is the real
- *   "focus vanished" bug.
- */
-
-/**
- * A D-pad press and the focus pair it caused arrive in EITHER order, a few ms
- * apart — both `HWEvent → blur → focus` and `blur → focus → HWEvent` were
- * observed live on the same session. So direction attribution is a time-window
- * join in both directions, never a sequence assumption.
- */
-export const DIRECTION_WINDOW_MS = 250;
-
-/**
- * The window for crediting a press to a move that was ALREADY recorded — the
- * `blur → focus → HWEvent` ordering. Much tighter than the forward window on
- * purpose: forward attribution is waiting for a consequence, but backward
- * attribution is claiming a cause, and a press 200ms after a move is far more
- * likely to be the NEXT press than a late-delivered echo of the last one.
- * Delivery races were observed at a few ms.
- */
-export const BACKFILL_WINDOW_MS = 60;
-
-/**
- * How long a blur waits for its matching focus before we call it a loss. Focus
- * pairs land within a frame or two; anything past this really has left the RN
- * tree (system alert, another window, an unmounted subtree).
- */
-export const FOCUS_LOST_MS = 400;
-const MAX_TRANSITIONS = 300;
-const MAX_PROBES = 400;
-let currentTag = null;
-let currentSince = null;
-let transitions = [];
-let probes = [];
-let visited = new Set();
-let lostCount = 0;
-let transitionSeq = 0;
-let probeSeq = 0;
-let tracking = true;
-
-/** Blur is always dispatched before the matching focus — this is that half. */
-let pendingBlur = null;
-let lostTimer = null;
-const probeTimers = new Set();
-const listeners = new Set();
-function emitChange() {
-  listeners.forEach(listener => {
-    listener();
-  });
-}
-function pushTransition(transition) {
-  transitions = transitions.length >= MAX_TRANSITIONS ? [...transitions.slice(1), transition] : [...transitions, transition];
-}
-function pushProbe(probe) {
-  probes = probes.length >= MAX_PROBES ? [...probes.slice(1), probe] : [...probes, probe];
-}
-
-/**
- * Credit a just-recorded transition to a press that arrived BEFORE it, and
- * close that press's probe. Returns the direction, if one was found.
- */
-function claimPendingProbe(fromTag, toTag, at) {
-  for (let i = probes.length - 1; i >= 0; i--) {
-    const probe = probes[i];
-    if (at - probe.at > DIRECTION_WINDOW_MS) break;
-    if (probe.resolved) continue;
-    if (probe.tag !== fromTag) continue;
-    probe.resolved = true;
-    probe.movedTo = toTag;
-    return probe.direction;
-  }
-  return null;
-}
-function recordTransition(fromTag, toTag, at) {
-  transitionSeq += 1;
-  const dwellMs = fromTag !== null && currentSince !== null ? Math.max(0, at - currentSince) : undefined;
-  const transition = {
-    seq: transitionSeq,
-    fromTag,
-    toTag,
-    direction: claimPendingProbe(fromTag, toTag, at),
-    at,
-    dwellMs
-  };
-  pushTransition(transition);
-  if (toTag === null) lostCount += 1;
-}
-function clearLostTimer() {
-  if (lostTimer !== null) {
-    clearTimeout(lostTimer);
-    lostTimer = null;
-  }
-}
-
-/** A view took focus. `tag` is the native tag from the raw event's target. */
-export function recordFocus(tag, at = Date.now()) {
-  if (!tracking || !Number.isFinite(tag)) return;
-  clearLostTimer();
-
-  // Prefer the pending blur as the source: on a real move the blur fires first
-  // and names the element focus actually left. `currentTag` is the fallback for
-  // the boot case (a first focus with no blur) and for platforms that skip the
-  // blur when focus moves between windows.
-  const fromTag = pendingBlur?.tag ?? currentTag;
-  pendingBlur = null;
-
-  // A focus event for the element that already has focus is a re-notification
-  // (re-entering the same view, a re-render), not a transition.
-  if (fromTag === tag && currentTag === tag) return;
-  recordTransition(fromTag, tag, at);
-  currentTag = tag;
-  currentSince = at;
-  visited.add(tag);
-  emitChange();
-}
-
-/**
- * A view lost focus. Held rather than recorded: the matching focus lands within
- * a frame or two and turns this into a normal transition. Only a blur with NO
- * follow-up is the "focus vanished" bug, and that is worth reporting.
- *
- * THE ORDERING TRAP: blur does NOT reliably precede its focus. On tvOS Fabric
- * 0.85 the emitter delivers `topFocus(new)` and only THEN `topBlur(old)`, ~1ms
- * apart (verified on the Apple TV simulator). A blur for a tag that no longer
- * holds focus is therefore a late echo of a move already recorded — swallowing
- * it is what keeps the tool from arming a loss timer for an element that was
- * never actually orphaned, and then reporting a phantom "focus lost" plus a
- * wrong `fromTag` on the next real move. Only a blur for the CURRENT holder can
- * mean focus is leaving, and that test is order-agnostic on both platforms.
- */
-export function recordBlur(tag, at = Date.now()) {
-  if (!tracking || !Number.isFinite(tag)) return;
-  if (currentTag !== null && tag !== currentTag) return;
-  pendingBlur = {
-    tag,
-    at
-  };
-  clearLostTimer();
-  lostTimer = setTimeout(() => {
-    lostTimer = null;
-    if (!pendingBlur) return;
-    const lostFrom = pendingBlur.tag;
-    pendingBlur = null;
-    recordTransition(lostFrom, null, Date.now());
-    currentTag = null;
-    currentSince = null;
-    emitChange();
-  }, FOCUS_LOST_MS);
-}
-
-/**
- * A D-pad direction was pressed. Opens a probe against whatever holds focus,
- * which resolves either to the element focus moved to or to `null` — "this
- * direction did nothing from here", the raw material of every dead-end flag.
- */
-export function recordKey(direction, at = Date.now()) {
-  if (!tracking) return;
-
-  // The `blur → focus → HWEvent` ordering: the move is already recorded and
-  // still uncredited, so this press is its cause. Credit it and log the probe
-  // against the element focus left, NOT against `currentTag` (which the
-  // transition already advanced past).
-  //
-  // `fromTag !== null` is the guard that keeps this from eating the wrong
-  // press: a transition out of nowhere (boot-time focus, focus regained after a
-  // loss) has no source element, so no D-pad direction can have caused it —
-  // without the check, the first press after app launch would be swallowed by
-  // the launch's own focus event and never open a probe.
-  const latest = transitions[transitions.length - 1];
-  if (latest && latest.direction === null && latest.fromTag !== null && at - latest.at <= BACKFILL_WINDOW_MS) {
-    latest.direction = direction;
-    probeSeq += 1;
-    pushProbe({
-      seq: probeSeq,
-      tag: latest.fromTag,
-      direction,
-      at,
-      resolved: true,
-      movedTo: latest.toTag
-    });
-    emitChange();
-    return;
-  }
-  probeSeq += 1;
-  const probe = {
-    seq: probeSeq,
-    tag: currentTag,
-    direction,
-    at,
-    resolved: false,
-    movedTo: null
-  };
-  pushProbe(probe);
-  const timer = setTimeout(() => {
-    probeTimers.delete(timer);
-    if (probe.resolved) return;
-    probe.resolved = true;
-    probe.movedTo = null;
-    emitChange();
-  }, DIRECTION_WINDOW_MS);
-  probeTimers.add(timer);
-  emitChange();
-}
-export function getState() {
-  return {
-    currentTag,
-    // `currentTag` is only ever nulled by the loss path, so a null with no
-    // transitions behind it means we simply have not seen focus yet.
-    presence: currentTag !== null ? "focused" : transitionSeq === 0 ? "never-observed" : "lost",
-    currentSince,
-    transitions,
-    probes,
-    visited: Array.from(visited),
-    lostCount,
-    transitionCount: transitionSeq,
-    tracking
-  };
-}
-
-/**
- * Wipe the history but KEEP where focus currently is — clearing is how a user
- * starts a clean traversal run, and forgetting the current element would blank
- * the Now card until the next press.
- */
-export function clearHistory() {
-  transitions = [];
-  probes = [];
-  visited = currentTag !== null ? new Set([currentTag]) : new Set();
-  lostCount = 0;
-  transitionSeq = 0;
-  probeSeq = 0;
-  emitChange();
-}
-
-/**
- * Pause/resume recording without detaching the native listeners. Useful when a
- * user is driving the app by hand and doesn't want that traversal scored.
- */
-export function setTracking(enabled) {
-  if (tracking === enabled) return;
-  tracking = enabled;
-  if (!enabled) {
-    clearLostTimer();
-    pendingBlur = null;
-  }
-  emitChange();
-}
-
-/** Full reset, including timers — the observers' detach path and tests. */
-export function resetStore() {
-  clearLostTimer();
-  probeTimers.forEach(timer => {
-    clearTimeout(timer);
-  });
-  probeTimers.clear();
-  pendingBlur = null;
-  currentTag = null;
-  currentSince = null;
-  transitions = [];
-  probes = [];
-  visited = new Set();
-  lostCount = 0;
-  transitionSeq = 0;
-  probeSeq = 0;
-  tracking = true;
-  emitChange();
-}
-export function subscribe(listener) {
-  listeners.add(listener);
-  return () => {
-    listeners.delete(listener);
-  };
-}
-
-/** Exposed so the scanner can nudge a rescan when focus lands on a stranger. */
-export function notifyChange() {
-  emitChange();
-}
-//# sourceMappingURL=focusStore.js.map
+"use strict";export const DIRECTION_WINDOW_MS=250;export const BACKFILL_WINDOW_MS=60;export const FOCUS_LOST_MS=400;const g=300;const _=400;let r=null;let d=null;let u=[];let i=[];let S=new Set;let T=0;let a=0;let m=0;let f=true;let c=null;let p=null;const v=new Set;const h=new Set;function s(){h.forEach(e=>{e()})}function C(e){u=u.length>=g?[...u.slice(1),e]:[...u,e]}function w(e){i=i.length>=_?[...i.slice(1),e]:[...i,e]}function D(e,t,n){for(let l=i.length-1;l>=0;l--){const o=i[l];if(n-o.at>DIRECTION_WINDOW_MS)break;if(o.resolved)continue;if(o.tag!==e)continue;o.resolved=true;o.movedTo=t;return o.direction}return null}function b(e,t,n){a+=1;const l=e!==null&&d!==null?Math.max(0,n-d):void 0;const o={seq:a,fromTag:e,toTag:t,direction:D(e,t,n),at:n,dwellMs:l};C(o);if(t===null)T+=1}function x(){if(p!==null){clearTimeout(p);p=null}}export function recordFocus(e,t=Date.now()){if(!f||!Number.isFinite(e))return;x();const n=c?.tag??r;c=null;if(n===e&&r===e)return;b(n,e,t);r=e;d=t;S.add(e);s()}export function recordBlur(e,t=Date.now()){if(!f||!Number.isFinite(e))return;if(r!==null&&e!==r)return;c={tag:e,at:t};x();p=setTimeout(()=>{p=null;if(!c)return;const n=c.tag;c=null;b(n,null,Date.now());r=null;d=null;s()},FOCUS_LOST_MS)}export function recordKey(e,t=Date.now()){if(!f)return;const n=u[u.length-1];if(n&&n.direction===null&&n.fromTag!==null&&t-n.at<=BACKFILL_WINDOW_MS){n.direction=e;m+=1;w({seq:m,tag:n.fromTag,direction:e,at:t,resolved:true,movedTo:n.toTag});s();return}m+=1;const l={seq:m,tag:r,direction:e,at:t,resolved:false,movedTo:null};w(l);const o=setTimeout(()=>{v.delete(o);if(l.resolved)return;l.resolved=true;l.movedTo=null;s()},DIRECTION_WINDOW_MS);v.add(o);s()}export function getState(){return{currentTag:r,presence:r!==null?"focused":a===0?"never-observed":"lost",currentSince:d,transitions:u,probes:i,visited:Array.from(S),lostCount:T,transitionCount:a,tracking:f}}export function clearHistory(){u=[];i=[];S=r!==null?new Set([r]):new Set;T=0;a=0;m=0;s()}export function setTracking(e){if(f===e)return;f=e;if(!e){x();c=null}s()}export function resetStore(){x();v.forEach(e=>{clearTimeout(e)});v.clear();c=null;r=null;d=null;u=[];i=[];S=new Set;T=0;a=0;m=0;f=true;s()}export function subscribe(e){h.add(e);return()=>{h.delete(e)}}export function notifyChange(){s()}

package/lib/module/sync/focusInspectorSyncAdapter.js

@@ -1,244 +1 @@
-"use strict";
-
-/**
- * focusInspectorSyncAdapter — streams the focus picture to Buoy Desktop.
- *
- * Structurally matches external-sync's `ToolSyncAdapter` WITHOUT importing the
- * package (the house rule every tool's adapter follows). Auto-discovery in
- * @buoy-gg/core picks it up by export name and announces the "focus-inspector"
- * capability.
- *
- * There is NO on-device UI and there never will be: on Android TV a focusable
- * view in an overlay becomes a D-pad stop in the host app's focus order
- * (`pointerEvents="box-none"` gates touch, not focus), so an on-device panel
- * would corrupt the measurement. Everything device-side therefore lives in
- * module scope and in this adapter's `subscribe` — headless FloatingDevTools
- * mounts the adapters and NONE of the overlay components, so instrumentation
- * inside a component would simply never run on TV.
- *
- * WORK SPLIT: the two event listeners attach at module load and stay attached;
- * the fiber scan only runs while a dashboard is watching.
- *
- * That asymmetry is deliberate and was learned the hard way. Focus cannot be
- * QUERIED on either platform — the tool only ever learns where focus is by
- * watching it arrive. So an observer that attached on first `subscribe` knows
- * nothing until focus next MOVES, which means opening the panel on a running
- * app shows nothing, and, far worse, the tool is blind in precisely the case it
- * exists for: focus is stuck, you press a direction, nothing moves, and so
- * nothing is ever learned. Listening from the start is what makes "what holds
- * focus right now" answerable at all.
- *
- * The cost is two event-emitter listeners and a bounded ring-buffer append per
- * focus change — nothing next to the fiber walk, which stays gated on a
- * dashboard actually watching. `setTracking(false)` is the off switch.
- */
-
-import { approxJsonSize } from "@buoy-gg/shared-ui";
-import { clearHistory, getState, setTracking, subscribe as subscribeStore, notifyChange } from "../store/focusStore";
-import { attachFocusObserver, getFocusObserverStatus } from "../observe/focusEventObserver";
-import { attachKeyObserver, isKeyObserverListening, isTV, platformOS } from "../observe/keyEventObserver";
-import { requestFocusForTag, scanFocusables } from "../scan/focusableScanner";
-import { computeCoverage, detectFlags, observedEdges } from "../detect/detectors";
-
-/**
- * Self-truncation budget. `attachDeviceSync` SILENTLY DROPS any snapshot over
- * 2MB — the panel just goes stale with no error — so the adapter trims to fit
- * rather than hoping it does.
- */
-const MAX_SNAPSHOT_BYTES = 1.5 * 1024 * 1024;
-
-/** A rescan after focus lands on a stranger, debounced so a fast traversal doesn't thrash. */
-const RESCAN_DEBOUNCE_MS = 500;
-// Attach the moment the package is loaded — which is when @buoy-gg/core's
-// adapter discovery requires it, i.e. only in builds that ship Buoy at all.
-// Guarded on TV so a phone build pays literally nothing.
-if (isTV) {
-  attachFocusObserver();
-  attachKeyObserver();
-}
-let lastScan = null;
-let scanning = false;
-let rescanTimer = null;
-let subscriberCount = 0;
-function nodesByTag() {
-  const map = new Map();
-  for (const node of lastScan?.nodes ?? []) map.set(node.nativeTag, node);
-  return map;
-}
-async function runScan() {
-  if (scanning) return lastScan;
-  scanning = true;
-  try {
-    lastScan = await scanFocusables();
-    return lastScan;
-  } catch {
-    return lastScan;
-  } finally {
-    scanning = false;
-    notifyChange();
-  }
-}
-
-/**
- * Focus landed on a tag the inventory doesn't know. Either the screen changed
- * or focus is on an element we never collected — both are worth a rescan, and
- * the second is the invisible-stop case the panel needs a name for.
- */
-function scheduleRescanIfStranger() {
-  if (subscriberCount === 0) return;
-  const {
-    currentTag
-  } = getState();
-  if (currentTag === null) return;
-  if (nodesByTag().has(currentTag)) return;
-  if (rescanTimer !== null) return;
-  rescanTimer = setTimeout(() => {
-    rescanTimer = null;
-    void runScan();
-  }, RESCAN_DEBOUNCE_MS);
-}
-
-/**
- * Newest-fitting trim, walking backwards from the most recent transition. A
- * dropped snapshot is invisible on the dashboard, so the budget is spent on the
- * transitions a person is actually looking at.
- */
-function fittingTransitions(transitions, budget) {
-  const out = [];
-  let bytes = 0;
-  for (let i = transitions.length - 1; i >= 0; i--) {
-    const size = approxJsonSize(transitions[i], budget).bytes;
-    if (bytes + size > budget && out.length > 0) break;
-    out.push(transitions[i]);
-    bytes += size;
-  }
-  out.reverse();
-  return out;
-}
-function buildSnapshot() {
-  const state = getState();
-  const nodes = lastScan?.nodes ?? [];
-  const observer = getFocusObserverStatus();
-  const flags = detectFlags(state.transitions, state.probes, nodes, state.lostCount, lastScan?.scannedAt ?? 0);
-  const coverage = computeCoverage(nodes, state.visited, state.transitions, state.probes);
-  const byTag = nodesByTag();
-
-  // Focusables come first in the budget — they are the smaller, bounded half
-  // (capped at 400 by the scanner) and the panel is unusable without them.
-  const focusablesBytes = approxJsonSize(nodes, MAX_SNAPSHOT_BYTES).bytes;
-  const transitions = fittingTransitions(state.transitions, Math.max(64 * 1024, MAX_SNAPSHOT_BYTES - focusablesBytes));
-  const flagged = flags.deadEnds.filter(flag => !flag.atEdge).length + flags.traps.length + flags.invisibleStops.length + (flags.lostCount > 0 ? 1 : 0);
-  return {
-    supported: isTV,
-    platform: platformOS,
-    observer: observer.status,
-    observerReason: observer.reason,
-    keysListening: isKeyObserverListening(),
-    tracking: state.tracking,
-    presence: state.presence,
-    current: state.currentTag === null ? null : {
-      tag: state.currentTag,
-      node: byTag.get(state.currentTag) ?? null,
-      since: state.currentSince ?? Date.now(),
-      edges: observedEdges(state.currentTag, state.transitions)
-    },
-    transitions,
-    focusables: nodes,
-    screen: lastScan?.screen ?? null,
-    scannedAt: lastScan?.scannedAt ?? null,
-    flags,
-    coverage,
-    stats: {
-      focusables: coverage.focusables,
-      visited: coverage.visited,
-      transitions: state.transitionCount,
-      flagged
-    },
-    capturedAt: Date.now()
-  };
-}
-export const focusInspectorSyncAdapter = {
-  version: 1,
-  getSnapshot() {
-    return buildSnapshot();
-  },
-  subscribe(onChange) {
-    subscriberCount += 1;
-    if (subscriberCount === 1) {
-      // Observers are already attached (module load). Only the scan is gated.
-      void runScan();
-    }
-    const unsubscribeStore = subscribeStore(() => {
-      scheduleRescanIfStranger();
-      onChange();
-    });
-
-    // A dashboard can attach before the app's first screen has mounted, in
-    // which case the first scan finds nothing. Poll briefly so the inventory
-    // fills in without the user having to press anything.
-    let retries = 0;
-    let pollTimer = null;
-    const poll = () => {
-      retries += 1;
-      if ((lastScan?.nodes.length ?? 0) > 0 || retries >= 100) {
-        pollTimer = null;
-        return;
-      }
-      void runScan();
-      pollTimer = setTimeout(poll, 100);
-    };
-    pollTimer = setTimeout(poll, 100);
-    return () => {
-      unsubscribeStore();
-      if (pollTimer !== null) clearTimeout(pollTimer);
-      subscriberCount = Math.max(0, subscriberCount - 1);
-      if (subscriberCount === 0) {
-        if (rescanTimer !== null) {
-          clearTimeout(rescanTimer);
-          rescanTimer = null;
-        }
-        // The observers stay attached on purpose — see the note at the top.
-        // Detaching here would make the tool forget where focus is every time
-        // the panel is closed, and re-open blind.
-      }
-    };
-  },
-  actions: {
-    async rescan() {
-      const scan = await runScan();
-      return {
-        ok: true,
-        focusables: scan?.nodes.length ?? 0
-      };
-    },
-    clearHistory() {
-      clearHistory();
-      return {
-        ok: true
-      };
-    },
-    setTracking(params) {
-      setTracking(params?.enabled !== false);
-      return {
-        tracking: getState().tracking
-      };
-    },
-    /**
-     * Put focus on an element and watch what the D-pad does from there — the
-     * only write this tool ever performs, and only when a human asks for it.
-     */
-    focusElement(params) {
-      const tag = params?.nativeTag;
-      if (typeof tag !== "number") return {
-        ok: false,
-        reason: "nativeTag is required."
-      };
-      if (!isTV) return {
-        ok: false,
-        reason: "Not a TV build — there is no focus engine."
-      };
-      return requestFocusForTag(tag);
-    }
-  }
-};
-//# sourceMappingURL=focusInspectorSyncAdapter.js.map
+"use strict";import{approxJsonSize as d}from"@buoy-gg/shared-ui";import{clearHistory as w,getState as f,setTracking as O,subscribe as A,notifyChange as C}from"../store/focusStore";import{attachFocusObserver as p,detachFocusObserver as E,getFocusObserverStatus as F}from"../observe/focusEventObserver";import{attachKeyObserver as m,detachKeyObserver as M,isKeyObserverListening as x,isTV as g,platformOS as c}from"../observe/keyEventObserver";import{requestFocusForTag as B,scanFocusables as N}from"../scan/focusableScanner";import{computeCoverage as _,detectFlags as D,observedEdges as H}from"../detect/detectors";const T=1.5*1024*1024;const K=500;if(g){p();m()}let o=null;let b=false;let a=null;let i=0;function v(){const e=new Map;for(const t of o?.nodes??[])e.set(t.nativeTag,t);return e}async function l(){if(b)return o;b=true;try{o=await N();return o}catch{return o}finally{b=false;C()}}function R(){if(i===0)return;const{currentTag:e}=f();if(e===null)return;if(v().has(e))return;if(a!==null)return;a=setTimeout(()=>{a=null;void l()},K)}function q(e,t){const r=[];let n=0;for(let s=e.length-1;s>=0;s--){const u=d(e[s],t).bytes;if(n+u>t&&r.length>0)break;r.push(e[s]);n+=u}r.reverse();return r}function z(){const e=f();const t=o?.nodes??[];const r=F();const n=D(e.transitions,e.probes,t,e.lostCount,o?.scannedAt??0);const s=_(t,e.visited,e.transitions,e.probes);const u=v();const h=d(t,T).bytes;const y=q(e.transitions,Math.max(64*1024,T-h));const S=n.deadEnds.filter(k=>!k.atEdge).length+n.traps.length+n.invisibleStops.length+(n.lostCount>0?1:0);return{supported:g||c==="web",platform:c,observer:r.status,observerReason:r.reason,keysListening:x(),tracking:e.tracking,presence:e.presence,current:e.currentTag===null?null:{tag:e.currentTag,node:u.get(e.currentTag)??null,since:e.currentSince??Date.now(),edges:H(e.currentTag,e.transitions,e.probes)},transitions:y,focusables:t,screen:o?.screen??null,scannedAt:o?.scannedAt??null,flags:n,coverage:s,stats:{focusables:s.focusables,visited:s.visited,transitions:e.transitionCount,flagged:S},capturedAt:Date.now()}}export const focusInspectorSyncAdapter={version:1,getSnapshot(){return z()},subscribe(e){i+=1;if(i===1){if(c==="web"){p();m()}void l()}const t=A(()=>{R();e()});let r=0;let n=null;const s=()=>{r+=1;if((o?.nodes.length??0)>0||r>=100){n=null;return}void l();n=setTimeout(s,100)};n=setTimeout(s,100);return()=>{t();if(n!==null)clearTimeout(n);i=Math.max(0,i-1);if(i===0){if(a!==null){clearTimeout(a);a=null}if(c==="web"){E();M()}}}},actions:{async rescan(){const e=await l();return{ok:true,focusables:e?.nodes.length??0}},clearHistory(){w();return{ok:true}},setTracking(e){O(e?.enabled!==false);return{tracking:f().tracking}},focusElement(e){const t=e?.nativeTag;if(typeof t!=="number")return{ok:false,reason:"nativeTag is required."};if(!g&&c!=="web")return{ok:false,reason:"Not a TV build \u2014 there is no focus engine."};return B(t)}}};

package/lib/typescript/detect/detectors.d.ts

@@ -118,5 +118,5 @@ export declare function computeCoverage(nodes: FocusableNode[], visited: number[
  * renders. A direction with no entry is UNKNOWN (dim), which is a different
  * statement from a dead end (pressed, went nowhere).
  */
-export declare function observedEdges(tag: number, transitions: FocusTransition[]): Partial<Record<FocusDirection, number | null>>;
+export declare function observedEdges(tag: number, transitions: FocusTransition[], probes?: FocusProbe[]): Partial<Record<FocusDirection, number | null>>;
 //# sourceMappingURL=detectors.d.ts.map

package/lib/typescript/observe/keyEventObserver.web.d.ts

@@ -0,0 +1,6 @@
+export declare const isTV = false;
+export declare const platformOS = "web";
+export declare function attachKeyObserver(): void;
+export declare function detachKeyObserver(): void;
+export declare function isKeyObserverListening(): boolean;
+//# sourceMappingURL=keyEventObserver.web.d.ts.map

package/lib/typescript/observe/rawEventEmitter.web.d.ts

@@ -0,0 +1,3 @@
+export { resolveDOMEventEmitter as resolveRawEventEmitter } from '@buoy-gg/shared-ui/utils';
+export type { RawEventSubscription, RawEventEmitterLike, RawEmitterResolution } from './rawEventEmitter';
+//# sourceMappingURL=rawEventEmitter.web.d.ts.map

package/lib/typescript/scan/focusableScanner.d.ts

@@ -1,27 +1,3 @@
-/**
- * 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.
- */
 export interface FocusFrame {
     x: number;
     y: number;

package/lib/web/index.mjs

@@ -0,0 +1 @@
+"use client";var Z=Object.defineProperty;var _e=Object.getOwnPropertyDescriptor;var Be=Object.getOwnPropertyNames;var He=Object.prototype.hasOwnProperty;var ze=(e,n)=>{for(var t in n)Z(e,t,{get:n[t],enumerable:true})},X=(e,n,t,r)=>{if(n&&typeof n=="object"||typeof n=="function")for(let i of Be(n))!He.call(e,i)&&i!==t&&Z(e,i,{get:()=>n[i],enumerable:!(r=_e(n,i))||r.enumerable});return e},We=(e,n,t)=>(X(e,n,"default"),t&&X(t,n,"default"));typeof window<"u"&&typeof globalThis.global>"u"&&(globalThis.global=globalThis);import{approxJsonSize as ee}from"@buoy-gg/shared-ui/web";var b=null,E=null,w=[],T=[],O=new Set,R=0,F=0,P=0,k=true,S=null,C=null,_=new Set,j=new Set;function x(){j.forEach(e=>{e()})}function je(e){w=w.length>=300?[...w.slice(1),e]:[...w,e]}function te(e){T=T.length>=400?[...T.slice(1),e]:[...T,e]}function Ke(e,n,t){for(let r=T.length-1;r>=0;r--){let i=T[r];if(t-i.at>250)break;if(!i.resolved&&i.tag===e)return i.resolved=true,i.movedTo=n,i.direction}return null}function ne(e,n,t){F+=1;let r=e!==null&&E!==null?Math.max(0,t-E):void 0,i={seq:F,fromTag:e,toTag:n,direction:Ke(e,n,t),at:t,dwellMs:r};je(i),n===null&&(R+=1)}function B(){C!==null&&(clearTimeout(C),C=null)}function ae(e,n=Date.now()){if(!k||!Number.isFinite(e))return;B();let t=S?.tag??b;S=null,!(t===e&&b===e)&&(ne(t,e,n),b=e,E=n,O.add(e),x())}function re(e,n=Date.now()){!k||!Number.isFinite(e)||b!==null&&e!==b||(S={tag:e,at:n},B(),C=setTimeout(()=>{if(C=null,!S)return;let t=S.tag;S=null,ne(t,null,Date.now()),b=null,E=null,x()},400))}function ie(e,n=Date.now()){if(!k)return;let t=w[w.length-1];if(t&&t.direction===null&&t.fromTag!==null&&n-t.at<=60){t.direction=e,P+=1,te({seq:P,tag:t.fromTag,direction:e,at:n,resolved:true,movedTo:t.toTag}),x();return}P+=1;let r={seq:P,tag:b,direction:e,at:n,resolved:false,movedTo:null};te(r);let i=setTimeout(()=>{_.delete(i),!r.resolved&&(r.resolved=true,r.movedTo=null,x())},250);_.add(i),x()}function H(){return{currentTag:b,presence:b!==null?"focused":F===0?"never-observed":"lost",currentSince:E,transitions:w,probes:T,visited:Array.from(O),lostCount:R,transitionCount:F,tracking:k}}function oe(){w=[],T=[],O=b!==null?new Set([b]):new Set,R=0,F=0,P=0,x()}function le(e){k!==e&&(k=e,e||(B(),S=null),x())}function Ue(){B(),_.forEach(e=>{clearTimeout(e)}),_.clear(),S=null,b=null,E=null,w=[],T=[],O=new Set,R=0,F=0,P=0,k=true,x()}function se(e){return j.add(e),()=>{j.delete(e)}}function qe(){x()}import{resolveDOMEventEmitter as $e}from"@buoy-gg/shared-ui/web/utils";var K=null,ue=false,D=[],A="idle",U=null;function Ge(){if(ue)return K;ue=true;let e=$e();return K=e.emitter,U=e.reason,K}function ce(e){let n=e?.nativeEvent;if(!n)return null;let t=n.target??n.tag;return typeof t=="number"&&Number.isFinite(t)?t:null}function de(){if(D.length>0)return;let e=Ge();if(!e){A="unavailable";return}try{D=[e.addListener("topFocus",n=>{let t=ce(n);t!==null&&ae(t)}),e.addListener("topBlur",n=>{let t=ce(n);t!==null&&re(t)})],A="listening"}catch(n){D=[],A="unavailable",U=n?.message??"addListener failed"}}function Ye(){D.forEach(e=>{try{e.remove()}catch{}}),D=[],A==="listening"&&(A="idle")}function Je(){return{status:A,reason:A==="unavailable"?U:null}}var q=false,I="web",L=false,Qe={ArrowUp:"up",ArrowDown:"down",ArrowLeft:"left",ArrowRight:"right"};function fe(e){let n=Qe[e.key];n&&ie(n)}function ge(){L||typeof document>"u"||(L=true,document.addEventListener("keydown",fe,true))}function Ze(){L&&(L=false,document.removeEventListener("keydown",fe,true))}function Xe(){return L}import{getDOMNodeHandle as et,getDOMPublicInstance as tt,isDOMElement as nt}from"@buoy-gg/shared-ui/web/utils";var he={};ze(he,{AccessibilityInfo:()=>ot,ActivityIndicator:()=>on,Alert:()=>un,Animated:()=>lt,AppRegistry:()=>ut,AppState:()=>ct,Appearance:()=>st,BackHandler:()=>dt,Button:()=>ln,CheckBox:()=>Ft,Clipboard:()=>ft,DeviceEventEmitter:()=>jt,Dimensions:()=>pe,Easing:()=>gt,FlatList:()=>Pt,I18nManager:()=>ht,Image:()=>Mt,ImageBackground:()=>Vt,InteractionManager:()=>mt,Keyboard:()=>pt,KeyboardAvoidingView:()=>Ct,LayoutAnimation:()=>bt,Linking:()=>vt,LogBox:()=>Wt,Modal:()=>an,NativeEventEmitter:()=>yt,NativeModules:()=>it,PanResponder:()=>wt,Picker:()=>Dt,PixelRatio:()=>Tt,Platform:()=>xt,Pressable:()=>tn,ProgressBar:()=>It,RefreshControl:()=>Lt,SafeAreaView:()=>Nt,ScrollView:()=>nn,SectionList:()=>Ot,Share:()=>St,StatusBar:()=>Rt,StyleSheet:()=>kt,Switch:()=>rn,Text:()=>Jt,TextInput:()=>Qt,Touchable:()=>_t,TouchableHighlight:()=>Xt,TouchableNativeFeedback:()=>Bt,TouchableOpacity:()=>Zt,TouchableWithoutFeedback:()=>en,UIManager:()=>At,Vibration:()=>Et,View:()=>Yt,VirtualizedList:()=>Ht,YellowBox:()=>zt,findNodeHandle:()=>sn,unstable_createElement:()=>rt,useColorScheme:()=>Kt,useLocaleContext:()=>Ut,useWindowDimensions:()=>qt});We(he,at);import*as at from"react-native-web";import{unstable_createElement as rt,NativeModules as it,AccessibilityInfo as ot,Animated as lt,Appearance as st,AppRegistry as ut,AppState as ct,BackHandler as dt,Clipboard as ft,Dimensions as pe,Easing as gt,I18nManager as ht,Keyboard as pt,InteractionManager as mt,LayoutAnimation as bt,Linking as vt,NativeEventEmitter as yt,PanResponder as wt,PixelRatio as Tt,Platform as xt,Share as St,StyleSheet as kt,UIManager as At,Vibration as Et,CheckBox as Ft,FlatList as Pt,Image as Mt,ImageBackground as Vt,KeyboardAvoidingView as Ct,Picker as Dt,ProgressBar as It,RefreshControl as Lt,SafeAreaView as Nt,SectionList as Ot,StatusBar as Rt,Touchable as _t,TouchableNativeFeedback as Bt,VirtualizedList as Ht,YellowBox as zt,LogBox as Wt,DeviceEventEmitter as jt,useColorScheme as Kt,useLocaleContext as Ut,useWindowDimensions as qt}from"react-native-web";import*as h from"react-native-web";import{createElement as $t,forwardRef as Gt}from"react";function v(e){let n=Gt((r,i)=>{let{accessibilityState:a,accessibilityValue:o,...l}=r;for(let s of["busy","checked","disabled","expanded","selected"])a?.[s]!==void 0&&l[`aria-${s}`]===void 0&&(l[`aria-${s}`]=a[s]);for(let[s,u]of Object.entries({min:"valuemin",max:"valuemax",now:"valuenow",text:"valuetext"}))o?.[s]!==void 0&&l[`aria-${u}`]===void 0&&(l[`aria-${u}`]=o[s]);return $t(e,{...l,ref:i})}),t=e.State;return t&&Object.assign(n,{State:t}),n.displayName=e.displayName??e.name??"NativeWebView",n}var Yt=v(h.View),Jt=v(h.Text),Qt=v(h.TextInput),Zt=v(h.TouchableOpacity),Xt=v(h.TouchableHighlight),en=v(h.TouchableWithoutFeedback),tn=v(h.Pressable),nn=v(h.ScrollView),an=v(h.Modal),rn=v(h.Switch),on=v(h.ActivityIndicator),ln=v(h.Button),sn=h.findNodeHandle,un={alert(e,n,t,r){if(typeof document>"u")return;let i=document.createElement("dialog");i.dataset.buoyRoot="",i.setAttribute("aria-label",e),i.style.cssText="position:fixed;inset:0;margin:auto;width:min(440px,90vw);padding:24px;border:1px solid #475569;border-radius:14px;background:#17212e;color:#f1f5f9;font:14px system-ui;box-shadow:0 20px 80px #0008;z-index:2147483647";let a=document.createElement("h2");if(a.textContent=e,a.style.cssText="font-size:18px;margin:0 0 12px",i.appendChild(a),n){let u=document.createElement("p");u.textContent=n,u.style.cssText="line-height:1.5;white-space:pre-wrap;margin:0 0 20px",i.appendChild(u)}let o=document.createElement("div");o.style.cssText="display:flex;justify-content:flex-end;flex-wrap:wrap;gap:8px";let l=t?.length?t:[{text:"OK"}],s=()=>{i.close?.(),i.remove()};for(let u of l){let f=document.createElement("button");f.type="button",f.textContent=u.text??"OK",f.style.cssText=`padding:9px 14px;border:1px solid #64748b;border-radius:7px;color:white;background:${u.style==="destructive"?"#a52b38":"#283a4d"};cursor:pointer;font:inherit`,f.onclick=()=>{s(),u.onPress?.()},o.appendChild(f)}i.addEventListener("cancel",u=>{u.preventDefault(),r?.cancelable!==false&&(s(),r?.onDismiss?.())}),i.appendChild(o),document.body.appendChild(i),i.showModal?i.showModal():i.setAttribute("open","")}};var cn=22,me=new Set(["View","RCTView","ScrollView","RCTScrollView","RCTScrollContentView","SafeAreaView","RCTSafeAreaView","AndroidHorizontalScrollContentView","KeyboardAvoidingView","Pressable","PlatformPressable","TouchableOpacity","TouchableHighlight","TouchableWithoutFeedback","TouchableNativeFeedback","AnimatedComponent","Wrapper"]),$="TVFocusGuideView";function dn(){return typeof globalThis>"u"?null:globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__??null}function fn(){let e=dn();if(!e)return[];let n=[];try{if(e.renderers&&typeof e.renderers.forEach=="function"&&e.renderers.forEach((t,r)=>{try{let i=e.getFiberRoots?.(r);i&&i.forEach(a=>n.push(a))}catch{}}),n.length===0&&e.getFiberRoots){let t=e.getFiberRoots(1);t&&t.forEach(r=>n.push(r))}}catch{}return n}function gn(e){return e.tag===cn&&e.memoizedState!==null}function hn(e){let n=e.memoizedProps?.activityState;return n===0||n===1||e.memoizedProps?.isPageFocused===false}function G(e){return e?.memoizedProps??e?.pendingProps??null}function be(e){let n=e?.type;return n?typeof n=="string"?n:n.displayName||n.name||null:null}function ve(e){let n=e?._debugOwner||e?.return,t=0;for(;n&&t<30;){t++;let r=be(n);if(r&&!me.has(r)&&typeof n.type!="string")return r;n=n.return}return null}function ye(e){let n=tt(e);if(n)return n;if(!e)return null;let t=e;return t.canonical?.publicInstance?t.canonical.publicInstance:t.canonical&&typeof t.canonical.measure=="function"?t.canonical:typeof t.measure=="function"||typeof t.measureInWindow=="function"?t:null}function we(e){let n=et(e);if(n!==null)return n;if(e==null)return null;let t=e;if(typeof t.__nativeTag=="number")return t.__nativeTag;if(typeof t._nativeTag=="number")return t._nativeTag;if(typeof t.nativeTag=="number")return t.nativeTag;if(t.canonical){if(typeof t.canonical.__nativeTag=="number")return t.canonical.__nativeTag;if(typeof t.canonical._nativeTag=="number")return t.canonical._nativeTag;if(typeof t.canonical.nativeTag=="number")return t.canonical.nativeTag}return null}function pn(e){let n=ye(e.stateNode);if(n)return{instance:n,nativeTag:we(e.stateNode)};let t=[];e.child&&t.push(e.child);let r=0;for(;t.length>0&&r<4e3;){r++;let i=t.pop();if(!i)continue;let a=ye(i.stateNode);if(a)return{instance:a,nativeTag:we(i.stateNode)};i.child&&t.push(i.child),i.sibling&&t.push(i.sibling)}return null}function mn(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}function bn(e){let n=typeof e.nextFocusUp=="number",t=typeof e.nextFocusDown=="number",r=typeof e.nextFocusLeft=="number",i=typeof e.nextFocusRight=="number";if(!(!n&&!t&&!r&&!i))return{up:n||void 0,down:t||void 0,left:r||void 0,right:i||void 0}}function Te(e){if(!e)return;let n=t=>{if(typeof t=="string")return t.trim()?t.trim().slice(0,60):void 0;if(typeof t=="number"&&Number.isFinite(t))return String(t)};return n(e.children)??n(e.title)??n(e.label)??void 0}function vn(e,n){let t=[],r=(a,o)=>{if(!a||o>n||t.length>=3)return;if(a!==e){let s=G(a);if(s&&typeof s.onPress=="function")return}let l=Te(G(a));l&&!t.includes(l)&&t.push(l),a.child&&r(a.child,o+1),a!==e&&a.sibling&&r(a.sibling,o)};e.child&&r(e.child,1);let i=t.join(" ").trim();return i?i.slice(0,60):void 0}function yn(e){return new Promise(n=>{let t=false,r=i=>{t||(t=true,n(i))};setTimeout(()=>r(null),1e3);try{typeof e.measureInWindow=="function"?e.measureInWindow((i,a,o,l)=>{r(o>0&&l>0?{x:i,y:a,width:o,height:l}:null)}):typeof e.measure=="function"?e.measure((i,a,o,l,s,u)=>{r(o>0&&l>0&&s!=null&&u!=null?{x:s,y:u,width:o,height:l}:null)}):r(null)}catch{r(null)}})}var Y=new Map;function wn(e,n,t){let r=[{fiber:e,context:n,depth:0}],i=new Set;for(;r.length>0;){let a=r.pop();if(!a)continue;let{fiber:o,depth:l}=a;if(!o||i.has(o)||l>500)continue;if(i.add(o),gn(o)||hn(o)){o.sibling&&r.push({fiber:o.sibling,context:a.context,depth:l});continue}let s=t(o,a.context);o.sibling&&r.push({fiber:o.sibling,context:a.context,depth:l}),o.child&&r.push({fiber:o.child,context:s,depth:l+1})}}function Tn(){let e=fn();if(e.length===0)return[];let n=[],t=new Set;for(let r of e)wn(r.current,{guideTag:null},(i,a)=>{let o=G(i);if(!o)return a;let l=be(i),s=l===$,u=mn(o),f=typeof o.onPress=="function"||typeof o.onLongPress=="function",c=o.hasTVPreferredFocus===true,p=bn(o);if(!(s||u===true||c||!!p||f&&u!==false||nt(i.stateNode)&&i.stateNode.matches('a[href],button,input,select,textarea,[tabindex],[contenteditable="true"]')&&!i.stateNode.matches(':disabled,[inert], [tabindex="-1"]')))return a;let d=pn(i),g=d?.nativeTag??null;if(g===null)return a;let N=s?{guideTag:g}:a;if(t.has(g)){let m=n.find(Re=>Re.node.nativeTag===g);return m&&(u!==void 0&&m.node.focusProps.focusable===void 0&&(m.node.focusProps.focusable=u),c&&(m.node.focusProps.hasTVPreferredFocus=true),p&&!m.node.focusProps.nextFocus&&(m.node.focusProps.nextFocus=p),f&&(m.node.pressable=true),!m.node.testID&&o.testID&&(m.node.testID=o.testID),s&&!m.node.guide&&(m.node.guide=xe(o),m.node.name=$)),N}t.add(g);let Q=l??"Unknown";(!l||me.has(l)||typeof i.type=="string")&&(Q=ve(i)??l??"Unknown");let Le=o.accessibilityLabel||o["aria-label"]||void 0,Ne=Te(o)??(f?vn(i,6):void 0),Oe={nativeTag:g,name:s?$:Q,owner:ve(i)??void 0,testID:o.testID||o["data-testid"]||void 0,label:Le,text:Ne,focusProps:{focusable:u,hasTVPreferredFocus:c||void 0,nextFocus:p},guide:s?xe(o):void 0,guideAncestorTag:a.guideTag??void 0,pressable:f||void 0};return d?.instance&&Y.set(g,d.instance),n.push({node:Oe,instance:d?.instance??null}),N});return n}function xe(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 z(e){return Math.round(e*1e3)/1e3}var xn=400;async function Se(){Y.clear();let e=Tn();await Promise.all(e.map(async a=>{if(!a.instance)return;let o=await yn(a.instance);o&&(a.node.frame=o)}));let n=pe.get("window"),t=Math.round(n.width)||1,r=Math.round(n.height)||1,i=[];for(let a of e){let o=a.node.frame;if(o){let l=o.x+o.width/2,s=o.y+o.height/2;a.node.onScreen=s>=0&&s<=r&&l>=0&&l<=t,a.node.frame={x:z(o.x/t),y:z(o.y/r),width:z(o.width/t),height:z(o.height/r)}}if(i.push(a.node),i.length>=xn)break}return i.sort((a,o)=>{let l=a.frame?.y??2,s=o.frame?.y??2;return Math.abs(l-s)>.01?l-s:(a.frame?.x??2)-(o.frame?.x??2)}),{screen:{width:t,height:r},nodes:i,scannedAt:Date.now()}}function Sn(e){let n=Y.get(e);if(!n)return{ok:false,reason:"Unknown tag \u2014 rescan and try again."};if(typeof n.requestTVFocus!="function")return{ok:false,reason:"This element exposes no requestTVFocus()."};try{return n.requestTVFocus(),{ok:true}}catch(t){return{ok:false,reason:t?.message??"requestTVFocus() threw."}}}var ke=["up","down","left","right"];function kn(e,n){return`${e}:${n}`}function Ae(e,n,t=3,r=0){let i=new Map;for(let l of e){if(!l.resolved||l.tag===null||l.at<r)continue;let s=kn(l.tag,l.direction);l.movedTo===null?i.set(s,(i.get(s)??0)+1):i.set(s,0)}let a=new Map;for(let l of n)a.set(l.nativeTag,l);let o=[];return i.forEach((l,s)=>{if(l<t)return;let[u,f]=s.split(":"),c=Number(u),p=f;o.push({tag:c,direction:p,attempts:l,atEdge:An(a.get(c),p,n)})}),o.sort((l,s)=>s.attempts-l.attempts)}function An(e,n,t){let r=e?.frame;if(!r)return false;let i=r.x+r.width/2,a=r.y+r.height/2;for(let o of t){if(o.nativeTag===e.nativeTag||o.guide)continue;let l=o.frame;if(!l)continue;let s=l.x+l.width/2,u=l.y+l.height/2;switch(n){case"up":if(u<r.y)return false;break;case"down":if(u>r.y+r.height)return false;break;case"left":if(s<r.x)return false;break;case"right":if(s>r.x+r.width)return false;break}}return true}function En(e){if(e.length===0)return null;let n=1/0,t=1/0,r=-1/0,i=-1/0;for(let a of e)n=Math.min(n,a.x),t=Math.min(t,a.y),r=Math.max(r,a.x+a.width),i=Math.max(i,a.y+a.height);return{x:n,y:t,width:r-n,height:i-t}}function Fn(e,n,t){switch(t){case"up":return n.y<e.y;case"down":return n.y>e.y+e.height;case"left":return n.x<e.x;case"right":return n.x>e.x+e.width;default:return false}}var Pn=2;function Ee(e,n){let t=new Map;for(let a of n)t.set(a.nativeTag,a);let r=new Map;for(let a of e){let o=t.get(a.tag)?.guideAncestorTag??a.tag,l=r.get(o)??{containerTag:o,tags:new Set,directions:new Set};l.tags.add(a.tag),l.directions.add(a.direction),r.set(o,l)}let i=[];return r.forEach(a=>{if(a.directions.size<Pn)return;let o=new Set(a.tags);for(let d of n)d.guideAncestorTag===a.containerTag&&o.add(d.nativeTag);o.add(a.containerTag);let l=t.get(a.containerTag),s=l?.guide&&l.frame?l.frame:En(Array.from(o).map(d=>t.get(d)?.frame).filter(d=>!!d));if(!s)return;let u=0,f=0;for(let d of ke)n.some(g=>{if(g.guide||o.has(g.nativeTag)||!g.frame)return false;let N={x:g.frame.x+g.frame.width/2,y:g.frame.y+g.frame.height/2};return Fn(s,N,d)})&&(f+=1,a.directions.has(d)||(u+=1));if(f===0||u>0)return;let c=l?.guide,p=c!==void 0&&(c.trap.up||c.trap.down||c.trap.left||c.trap.right);i.push({tags:Array.from(a.tags).sort((d,g)=>d-g),containerTag:a.containerTag,directions:ke.filter(d=>a.directions.has(d)),guideTrapTag:p?a.containerTag:void 0})}),i}function Fe(e,n,t=0){let r=new Map;for(let a of n)r.set(a.nativeTag,a);let i=new Map;for(let a of e){let o=a.toTag;if(o===null||a.at<t)continue;let l=r.get(o),s=l?l.guide?"guide":null:n.length>0?"unknown":null;if(!s)continue;let u=i.get(o);u?(u.count+=1,u.at=a.at):i.set(o,{tag:o,reason:s,at:a.at,count:1})}return Array.from(i.values()).sort((a,o)=>o.at-a.at)}function Pe(e,n,t,r,i=0){let a=Ae(n,t,3,i);return{deadEnds:a,traps:Ee(a,t),invisibleStops:Fe(e,t,i),lostCount:r}}function Me(e,n,t,r){let i=new Set(n),a=e.filter(c=>!c.guide),o=a.filter(c=>!i.has(c.nativeTag)).map(c=>c.nativeTag),l=r.length>=12,s=new Set;for(let c of t)c.toTag!==null&&s.add(c.toTag);let u=new Map;for(let c of e)u.set(c.nativeTag,c);let f=l?o.filter(c=>{if(s.has(c))return false;let p=u.get(c);return p?.frame?a.some(d=>d.nativeTag!==c&&i.has(d.nativeTag)&&Mn(p,d)):false}):[];return{focusables:a.length,visited:a.filter(c=>i.has(c.nativeTag)).length,unvisited:o,suspectedUnreachable:f,meaningful:l}}var Ve=.12;function Mn(e,n){let t=e.frame,r=n.frame;if(!t||!r)return false;let i=t.x<r.x+r.width&&r.x<t.x+t.width,a=t.y<r.y+r.height&&r.y<t.y+t.height;return!!(i&&Math.max(t.y-(r.y+r.height),r.y-(t.y+t.height))<=Ve||a&&Math.max(t.x-(r.x+r.width),r.x-(t.x+t.width))<=Ve)}function Ce(e,n,t=[]){let r=[];for(let a of n)a.fromTag!==e||a.direction===null||r.push({at:a.at,direction:a.direction,to:a.toTag});for(let a of t)a.tag!==e||!a.resolved||a.movedTo!==null||r.push({at:a.at,direction:a.direction,to:null});r.sort((a,o)=>a.at-o.at);let i={};for(let a of r)i[a.direction]=a.to;return i}var De=1.5*1024*1024,Vn=500;q&&(de(),ge());var y=null,J=false,M=null,V=0;function Ie(){let e=new Map;for(let n of y?.nodes??[])e.set(n.nativeTag,n);return e}async function W(){if(J)return y;J=true;try{return y=await Se(),y}catch{return y}finally{J=false,qe()}}function Cn(){if(V===0)return;let{currentTag:e}=H();e!==null&&(Ie().has(e)||M===null&&(M=setTimeout(()=>{M=null,W()},Vn)))}function Dn(e,n){let t=[],r=0;for(let i=e.length-1;i>=0;i--){let a=ee(e[i],n).bytes;if(r+a>n&&t.length>0)break;t.push(e[i]),r+=a}return t.reverse(),t}function In(){let e=H(),n=y?.nodes??[],t=Je(),r=Pe(e.transitions,e.probes,n,e.lostCount,y?.scannedAt??0),i=Me(n,e.visited,e.transitions,e.probes),a=Ie(),o=ee(n,De).bytes,l=Dn(e.transitions,Math.max(64*1024,De-o)),s=r.deadEnds.filter(u=>!u.atEdge).length+r.traps.length+r.invisibleStops.length+(r.lostCount>0?1:0);return{supported:q||I==="web",platform:I,observer:t.status,observerReason:t.reason,keysListening:Xe(),tracking:e.tracking,presence:e.presence,current:e.currentTag===null?null:{tag:e.currentTag,node:a.get(e.currentTag)??null,since:e.currentSince??Date.now(),edges:Ce(e.currentTag,e.transitions,e.probes)},transitions:l,focusables:n,screen:y?.screen??null,scannedAt:y?.scannedAt??null,flags:r,coverage:i,stats:{focusables:i.focusables,visited:i.visited,transitions:e.transitionCount,flagged:s},capturedAt:Date.now()}}var Ln={version:1,getSnapshot(){return In()},subscribe(e){V+=1,V===1&&(I==="web"&&(de(),ge()),W());let n=se(()=>{Cn(),e()}),t=0,r=null,i=()=>{if(t+=1,(y?.nodes.length??0)>0||t>=100){r=null;return}W(),r=setTimeout(i,100)};return r=setTimeout(i,100),()=>{n(),r!==null&&clearTimeout(r),V=Math.max(0,V-1),V===0&&(M!==null&&(clearTimeout(M),M=null),I==="web"&&(Ye(),Ze()))}},actions:{async rescan(){return{ok:true,focusables:(await W())?.nodes.length??0}},clearHistory(){return oe(),{ok:true}},setTracking(e){return le(e?.enabled!==false),{tracking:H().tracking}},focusElement(e){let n=e?.nativeTag;return typeof n!="number"?{ok:false,reason:"nativeTag is required."}:!q&&I!=="web"?{ok:false,reason:"Not a TV build \u2014 there is no focus engine."}:Sn(n)}}};export{oe as clearHistory,Me as computeCoverage,Ae as detectDeadEnds,Pe as detectFlags,Fe as detectInvisibleStops,Ee as detectTraps,Ln as focusInspectorSyncAdapter,H as getState,Ce as observedEdges,re as recordBlur,ae as recordFocus,ie as recordKey,Ue as resetStore,Se as scanFocusables,le as setTracking,se as subscribe};