@buoy-gg/focus-inspector 7.0.36 → 7.0.38

package/lib/commonjs/observe/focusEventObserver.js

@@ -1,105 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.attachFocusObserver = attachFocusObserver;
-exports.detachFocusObserver = detachFocusObserver;
-exports.getFocusObserverStatus = getFocusObserverStatus;
-var _focusStore = require("../store/focusStore");
-var _rawEventEmitter = require("./rawEventEmitter");
-/**
- * focusEventObserver — the global, zero-instrumentation focus source.
- *
- * `react-native/Libraries/Core/RawEventEmitter` mirrors every Fabric-dispatched
- * event BEFORE React's plugins or components see it, and on both tvOS and
- * Android TV every focus change arrives there as `topFocus` / `topBlur` with
- * the focused view's native tag. Its own source comment blesses exactly this
- * use ("app-specific perf monitoring … and maybe debugging").
- *
- * Why not the obvious alternatives:
- * - `onFocus`/`onBlur` props would require instrumenting the app's components,
- *   and would MISS the interesting cases: focus really does park on views with
- *   no handler (a TVFocusGuideView with `destinations` is an invisible focus
- *   stop). A per-component observer reports "focus is nowhere" for the exact
- *   bug this tool exists to catch.
- * - `TVEventHandler`'s `focus`/`blur` HWEvents are deprecated and 0.85 deleted
- *   the Fabric calls that emitted them (fork issue #1037). They still fire on
- *   the 0.83 line, so they're folded in as optional enrichment below — never
- *   required, or the tool would work on one app and not the other.
- * - There is no root-level capture View to wrap the app in: Buoy mounts as a
- *   SIBLING of the app tree, not a parent.
- *
- * The deep import is guarded. If it ever moves, the snapshot degrades to
- * `observer: "unavailable"` and the panel says so, rather than the tool taking
- * the app's bundle down.
- */
-
-let emitter = null;
-let emitterResolved = false;
-let subscriptions = [];
-let status = "idle";
-let unavailableReason = null;
-function getEmitter() {
-  if (emitterResolved) return emitter;
-  emitterResolved = true;
-  const resolution = (0, _rawEventEmitter.resolveRawEventEmitter)();
-  emitter = resolution.emitter;
-  unavailableReason = resolution.reason;
-  return emitter;
-}
-
-/**
- * Pull the native tag out of a raw event. Fabric puts it on `nativeEvent.target`
- * on both platforms (probe-verified); `nativeEvent.tag` is the older shape and
- * costs nothing to accept.
- */
-function tagOf(event) {
-  const native = event?.nativeEvent;
-  if (!native) return null;
-  const target = native.target ?? native.tag;
-  return typeof target === "number" && Number.isFinite(target) ? target : null;
-}
-function attachFocusObserver() {
-  if (subscriptions.length > 0) return;
-  const raw = getEmitter();
-  if (!raw) {
-    status = "unavailable";
-    return;
-  }
-  try {
-    // Two named listeners rather than the `*` wildcard channel: the wildcard
-    // exists, but its payload contract was never runtime-verified, and named
-    // channels sidestep the question entirely.
-    subscriptions = [raw.addListener("topFocus", event => {
-      const tag = tagOf(event);
-      if (tag !== null) (0, _focusStore.recordFocus)(tag);
-    }), raw.addListener("topBlur", event => {
-      const tag = tagOf(event);
-      if (tag !== null) (0, _focusStore.recordBlur)(tag);
-    })];
-    status = "listening";
-  } catch (e) {
-    subscriptions = [];
-    status = "unavailable";
-    unavailableReason = e?.message ?? "addListener failed";
-  }
-}
-function detachFocusObserver() {
-  subscriptions.forEach(subscription => {
-    try {
-      subscription.remove();
-    } catch {
-      /* a listener that's already gone is fine */
-    }
-  });
-  subscriptions = [];
-  if (status === "listening") status = "idle";
-}
-function getFocusObserverStatus() {
-  return {
-    status,
-    reason: status === "unavailable" ? unavailableReason : null
-  };
-}
-//# sourceMappingURL=focusEventObserver.js.map
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.attachFocusObserver=attachFocusObserver,exports.detachFocusObserver=detachFocusObserver,exports.getFocusObserverStatus=getFocusObserverStatus;var _focusStore=require("../store/focusStore"),_rawEventEmitter=require("./rawEventEmitter");let emitter=null,emitterResolved=!1,subscriptions=[],status="idle",unavailableReason=null;function getEmitter(){if(emitterResolved)return emitter;emitterResolved=!0;const t=(0,_rawEventEmitter.resolveRawEventEmitter)();return emitter=t.emitter,unavailableReason=t.reason,emitter}function tagOf(t){const e=t?.nativeEvent;if(!e)return null;const s=e.target??e.tag;return"number"==typeof s&&Number.isFinite(s)?s:null}function attachFocusObserver(){if(subscriptions.length>0)return;const t=getEmitter();if(t)try{subscriptions=[t.addListener("topFocus",t=>{const e=tagOf(t);null!==e&&(0,_focusStore.recordFocus)(e)}),t.addListener("topBlur",t=>{const e=tagOf(t);null!==e&&(0,_focusStore.recordBlur)(e)})],status="listening"}catch(t){subscriptions=[],status="unavailable",unavailableReason=t?.message??"addListener failed"}else status="unavailable"}function detachFocusObserver(){subscriptions.forEach(t=>{try{t.remove()}catch{}}),subscriptions=[],"listening"===status&&(status="idle")}function getFocusObserverStatus(){return{status:status,reason:"unavailable"===status?unavailableReason:null}}

package/lib/commonjs/observe/keyEventObserver.js

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

package/lib/commonjs/observe/rawEventEmitter.js

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