@buoy-gg/tv-remote 7.0.31

package/LICENSE

@@ -0,0 +1,58 @@
+PROPRIETARY SOFTWARE LICENSE
+
+Copyright (c) 2024-present Buoy. All rights reserved.
+
+This software and its source code are proprietary and confidential.
+
+NOTICE: This is NOT open source software. This software is licensed,
+not sold, and is protected by copyright laws and international treaties.
+
+TERMS AND CONDITIONS:
+
+1. LICENSE GRANT
+   Subject to the terms of this Agreement and payment of applicable fees,
+   Buoy grants you a limited, non-exclusive, non-transferable license
+   to use the compiled software packages in your applications.
+
+2. RESTRICTIONS
+   You may NOT:
+   - Copy, modify, or distribute the source code
+   - Reverse engineer, decompile, or disassemble the software
+   - Remove or alter any proprietary notices or labels
+   - Sublicense, rent, lease, or lend the software
+   - Use the software to create competing products
+   - Share access credentials with unauthorized parties
+
+3. OWNERSHIP
+   React Buoy retains all right, title, and interest in the software,
+   including all intellectual property rights. This license does not
+   grant you any rights to trademarks or service marks.
+
+4. TERMINATION
+   This license is effective until terminated. Your rights under this
+   license will terminate automatically without notice if you fail to
+   comply with any of its terms. Upon termination, you must cease all
+   use and destroy all copies of the software.
+
+5. DISCLAIMER OF WARRANTIES
+   THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND,
+   EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+6. LIMITATION OF LIABILITY
+   IN NO EVENT SHALL BUOY BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
+   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR IN
+   CONNECTION WITH THIS LICENSE OR THE USE OF THE SOFTWARE.
+
+7. GOVERNING LAW
+   This Agreement shall be governed by and construed in accordance with
+   the laws of the United States, without regard to its conflict of
+   law provisions.
+
+For licensing inquiries and subscription information:
+- Website: https://buoy.gg
+- Email: AustinLovesWorking@gmail.com
+
+Unauthorized reproduction or distribution of this software, or any
+portion of it, may result in severe civil and criminal penalties,
+and will be prosecuted to the maximum extent possible under the law.

package/README.md

@@ -0,0 +1,89 @@
+# @buoy-gg/tv-remote
+
+[![npm version](https://img.shields.io/npm/v/@buoy-gg/tv-remote?style=flat-square&labelColor=1c1c1c&color=10B981)](https://www.npmjs.com/package/@buoy-gg/tv-remote) [![npm downloads](https://img.shields.io/npm/dm/@buoy-gg/tv-remote?style=flat-square&labelColor=1c1c1c&color=10B981)](https://www.npmjs.com/package/@buoy-gg/tv-remote)
+
+**Press the TV remote from Buoy Desktop — drive your Apple TV / Android TV app's D-pad, record press sequences as macros, and replay them across every connected device.**
+
+Part of [Buoy](https://github.com/Buoy-gg/buoy) — devtools that live inside your React Native app. Install it and the TV Remote panel lights up in Buoy Desktop for that device.
+
+## Install
+
+```bash
+npm install @buoy-gg/core @buoy-gg/tv-remote
+```
+
+```tsx
+import { FloatingDevTools } from "@buoy-gg/core";
+
+export default function App() {
+  return (
+    <>
+      {/* your app */}
+      <FloatingDevTools headless />  {/* TV apps run headless — no bubble */}
+    </>
+  );
+}
+```
+
+## What this package does — and deliberately does not
+
+This package **only observes**. It captures the remote events your app receives
+(`up`/`down`/`left`/`right`/`select`/`menu`/`playPause`) and streams them to Buoy Desktop.
+
+**Presses are injected from the host**, by Buoy Desktop shelling out to `adb shell input keyevent`
+(Android TV) or `idb ui key` (Apple TV simulator). That is the only honest path:
+
+- On tvOS, the two things an app *can* do in-process are post the internal `onHWKeyEvent`
+  notification (fires the JS event, but focus never moves) and `requestTVFocus` (jumps focus,
+  but fires no event and traverses nothing). Each is half of a press, and the missing half is
+  the half QA cares about.
+- On Android, directional focus navigation for unconsumed D-pad keys happens in `ViewRootImpl`,
+  *above* the Activity — so an in-process `dispatchKeyEvent` would fire JS events **without
+  moving focus** exactly on the screens that are broken.
+
+Host-side injection goes through `InputManager` / the simulator's HID layer — the same pipeline
+as a physical remote, driving the real focus engine.
+
+The package also renders **nothing**. On Android TV any focusable view in an overlay becomes a
+D-pad stop in the host app's focus order, so a visible tool would alter the navigation it is
+supposed to be testing.
+
+## Support matrix
+
+| Target | Drive-able? | Via |
+|---|---|---|
+| Android TV emulator | ✅ full fidelity | `adb -s <serial> shell input keyevent` |
+| Android TV device | ✅ full fidelity | same, over `adb connect <ip>:5555` |
+| Apple TV simulator | ✅ arrows / select / menu — ❌ play-pause | `idb ui key --udid <udid>` |
+| Apple TV device | ❌ replay unsupported — **record only** | (future: an XCUITest `XCUIRemote` companion) |
+
+Capture is pure JS and works on every target, including retail hardware — so the
+**record-on-retail** workflow holds: press the physical remote on a rack device, get a macro,
+replay it against emulators and simulators.
+
+`idb` is not part of Xcode. Without it on `PATH` the Apple TV lane is disabled with an install
+hint (`brew install idb-companion` + `pipx install fb-idb`).
+
+## API
+
+Everything is driven from Buoy Desktop; these exports exist for custom integrations.
+
+```ts
+import {
+  arm,          // start capturing
+  disarm,       // stop capturing, hand the Menu key back to the platform
+  clear,
+  setMenuCapture, // tvOS: route Menu to JS (opt-in, always undone on disarm)
+  getEventsSince, // (seq) => events newer than seq
+  getState,
+  subscribe,
+  tvRemoteSyncAdapter, // auto-discovered by @buoy-gg/core
+} from "@buoy-gg/tv-remote";
+```
+
+On non-TV platforms `getState().supported` is `false`, the native listener is never attached,
+and the package costs one boolean.
+
+## Docs
+
+Full documentation: <https://buoy.gg/buoy/latest/docs/tools/tv-remote>

package/lib/commonjs/index.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "arm", {
+  enumerable: true,
+  get: function () {
+    return _tvEventStore.arm;
+  }
+});
+Object.defineProperty(exports, "clear", {
+  enumerable: true,
+  get: function () {
+    return _tvEventStore.clear;
+  }
+});
+Object.defineProperty(exports, "disarm", {
+  enumerable: true,
+  get: function () {
+    return _tvEventStore.disarm;
+  }
+});
+Object.defineProperty(exports, "getEventsSince", {
+  enumerable: true,
+  get: function () {
+    return _tvEventStore.getEventsSince;
+  }
+});
+Object.defineProperty(exports, "getState", {
+  enumerable: true,
+  get: function () {
+    return _tvEventStore.getState;
+  }
+});
+Object.defineProperty(exports, "setMenuCapture", {
+  enumerable: true,
+  get: function () {
+    return _tvEventStore.setMenuCapture;
+  }
+});
+Object.defineProperty(exports, "subscribe", {
+  enumerable: true,
+  get: function () {
+    return _tvEventStore.subscribe;
+  }
+});
+Object.defineProperty(exports, "tvRemoteSyncAdapter", {
+  enumerable: true,
+  get: function () {
+    return _tvRemoteSyncAdapter.tvRemoteSyncAdapter;
+  }
+});
+var _tvRemoteSyncAdapter = require("./sync/tvRemoteSyncAdapter");
+var _tvEventStore = require("./store/tvEventStore");
+//# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_tvRemoteSyncAdapter","require","_tvEventStore"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,IAAAA,oBAAA,GAAAC,OAAA;AAKA,IAAAC,aAAA,GAAAD,OAAA","ignoreList":[]}

package/lib/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/commonjs/store/tvEventStore.js

@@ -0,0 +1,167 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.arm = arm;
+exports.clear = clear;
+exports.disarm = disarm;
+exports.getEventsSince = getEventsSince;
+exports.getState = getState;
+exports.setMenuCapture = setMenuCapture;
+exports.subscribe = subscribe;
+var ReactNative = _interopRequireWildcard(require("react-native"));
+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); }
+/**
+ * tvEventStore — the whole device-side half of the TV remote tool.
+ *
+ * CONTRACT: this store only ever OBSERVES. It never injects, synthesizes, or
+ * fakes a remote press. Presses come from the host (Buoy Desktop shells out to
+ * `adb shell input keyevent` / `idb ui key`), because those go through the real
+ * platform focus engine; anything we could fake in-process would move focus
+ * without firing events, or fire events without moving focus. See
+ * TV_REMOTE_DRIVER_PLAN.md §2.
+ *
+ * It is also deliberately UI-less. On Android TV any focusable view we rendered
+ * would become a D-pad stop in the host app's focus order, so the tool would
+ * alter the navigation it is supposed to be replaying.
+ *
+ * Safe to ship in non-TV apps: the native event emitter is never touched unless
+ * `Platform.isTV` is true, so the cost on a phone is one boolean.
+ */
+
+/** One captured remote event, as it goes over the wire to the dashboard. */
+
+/**
+ * Ring buffer depth. Replay polls `getEventsSince` every few dozen ms with a
+ * ~2s budget per step, so 50 is many times more than any echo needs; it exists
+ * so a human scrubbing the echo strip has some scrollback.
+ */
+const MAX_EVENTS = 50;
+
+/**
+ * Continuous gestures are not presses and are never recorded — the macro format
+ * is discrete keys. Dropping them here keeps them out of the ring buffer so
+ * they can't push real presses out of it during a replay.
+ */
+const IGNORED_EVENT_TYPES = new Set(["pan", "swipeUp", "swipeDown", "swipeLeft", "swipeRight"]);
+/**
+ * `TVEventHandler` / `TVEventControl` only exist on the react-native-tvos fork.
+ * A namespace read (rather than a named import) keeps this module importable on
+ * stock react-native, where those exports are absent.
+ */
+const RN = ReactNative;
+const isTV = RN.Platform?.isTV === true;
+let events = [];
+let seq = 0;
+let armed = false;
+let menuCaptureArmed = false;
+let subscription = null;
+const listeners = new Set();
+function emitChange() {
+  listeners.forEach(listener => {
+    listener();
+  });
+}
+function handleEvent(raw) {
+  // Disarming removes the subscription, but don't take that on trust: a native
+  // emitter that delivered one more event after `remove()` would land a stray
+  // press in the buffer, and a stray press is exactly what a replay would
+  // mistake for a step's echo.
+  if (!armed) return;
+  const event = raw;
+  const eventType = event?.eventType;
+  if (typeof eventType !== "string") return;
+  if (IGNORED_EVENT_TYPES.has(eventType)) return;
+
+  /**
+   * Dedupe by ignoring key DOWN, never key UP. tvOS emits keyAction 1 (up)
+   * ONLY — taps reach the gesture recognizer at StateEnded — so filtering to
+   * "down" would swallow every tvOS event. Android's down-emit is
+   * feature-flagged off by default, but dropping it here is the correct
+   * invariant either way: one press must produce exactly one echo.
+   */
+  if (event?.eventKeyAction === 0) return;
+  seq += 1;
+  const next = {
+    seq,
+    t: Date.now(),
+    eventType,
+    eventKeyAction: event?.eventKeyAction
+  };
+  events = events.length >= MAX_EVENTS ? [...events.slice(1), next] : [...events, next];
+  emitChange();
+}
+
+/** Start pushing remote events into the buffer. Idempotent. */
+function arm() {
+  if (armed) return;
+  armed = true;
+  if (isTV && RN.TVEventHandler && !subscription) {
+    subscription = RN.TVEventHandler.addListener(handleEvent);
+  }
+  emitChange();
+}
+
+/**
+ * Stop capturing and hand the Menu key back to the platform. Every teardown
+ * path funnels through here — leaving menu capture on would leave the app
+ * unable to navigate back, which is an App Store behavior change.
+ */
+function disarm() {
+  if (subscription) {
+    subscription.remove();
+    subscription = null;
+  }
+  if (menuCaptureArmed) setMenuCapture(false);
+  if (!armed) return;
+  armed = false;
+  emitChange();
+}
+
+/**
+ * tvOS: route the Menu key to JS so it can be recorded, instead of letting it
+ * pop the navigation stack (and background the app at the root). This changes
+ * how the app under test behaves, so it is opt-in per recording session and is
+ * always undone on disarm.
+ */
+function setMenuCapture(on) {
+  if (!isTV || RN.Platform.OS !== "ios" || !RN.TVEventControl) return;
+  if (on === menuCaptureArmed) return;
+  if (on) {
+    RN.TVEventControl.enableTVMenuKey();
+  } else {
+    RN.TVEventControl.disableTVMenuKey();
+  }
+  menuCaptureArmed = on;
+  emitChange();
+}
+function clear() {
+  if (events.length === 0) return;
+  events = [];
+  emitChange();
+}
+
+/** Events strictly newer than `sinceSeq` — the replay echo cursor. */
+function getEventsSince(sinceSeq) {
+  if (!Number.isFinite(sinceSeq)) return events.slice();
+  return events.filter(event => event.seq > sinceSeq);
+}
+function getState() {
+  return {
+    supported: isTV,
+    platform: RN.Platform?.OS ?? "unknown",
+    captureArmed: armed,
+    listening: subscription !== null,
+    menuCaptureArmed,
+    seq,
+    recent: events.slice()
+  };
+}
+function subscribe(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+//# sourceMappingURL=tvEventStore.js.map

package/lib/commonjs/store/tvEventStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ReactNative","_interopRequireWildcard","require","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","MAX_EVENTS","IGNORED_EVENT_TYPES","Set","RN","isTV","Platform","events","seq","armed","menuCaptureArmed","subscription","listeners","emitChange","forEach","listener","handleEvent","raw","event","eventType","eventKeyAction","next","Date","now","length","slice","arm","TVEventHandler","addListener","disarm","remove","setMenuCapture","on","OS","TVEventControl","enableTVMenuKey","disableTVMenuKey","clear","getEventsSince","sinceSeq","Number","isFinite","filter","getState","supported","platform","captureArmed","listening","recent","subscribe","add","delete"],"sourceRoot":"../../../src","sources":["store/tvEventStore.ts"],"mappings":";;;;;;;;;;;;AAkBA,IAAAA,WAAA,GAAAC,uBAAA,CAAAC,OAAA;AAA4C,SAAAD,wBAAAE,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAJ,uBAAA,YAAAA,CAAAE,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;AAlB5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA;;AA8BA;AACA;AACA;AACA;AACA;AACA,MAAMkB,UAAU,GAAG,EAAE;;AAErB;AACA;AACA;AACA;AACA;AACA,MAAMC,mBAAmB,GAAG,IAAIC,GAAG,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AAe/F;AACA;AACA;AACA;AACA;AACA,MAAMC,EAAE,GAAGzB,WAIV;AAED,MAAM0B,IAAI,GAAGD,EAAE,CAACE,QAAQ,EAAED,IAAI,KAAK,IAAI;AAEvC,IAAIE,MAAuB,GAAG,EAAE;AAChC,IAAIC,GAAG,GAAG,CAAC;AACX,IAAIC,KAAK,GAAG,KAAK;AACjB,IAAIC,gBAAgB,GAAG,KAAK;AAC5B,IAAIC,YAAiC,GAAG,IAAI;AAE5C,MAAMC,SAAS,GAAG,IAAIT,GAAG,CAAa,CAAC;AAEvC,SAASU,UAAUA,CAAA,EAAS;EAC1BD,SAAS,CAACE,OAAO,CAAEC,QAAQ,IAAK;IAC9BA,QAAQ,CAAC,CAAC;EACZ,CAAC,CAAC;AACJ;AAEA,SAASC,WAAWA,CAACC,GAAY,EAAQ;EACvC;EACA;EACA;EACA;EACA,IAAI,CAACR,KAAK,EAAE;EAEZ,MAAMS,KAAK,GAAGD,GAA6D;EAC3E,MAAME,SAAS,GAAGD,KAAK,EAAEC,SAAS;EAClC,IAAI,OAAOA,SAAS,KAAK,QAAQ,EAAE;EACnC,IAAIjB,mBAAmB,CAACT,GAAG,CAAC0B,SAAS,CAAC,EAAE;;EAExC;AACF;AACA;AACA;AACA;AACA;AACA;EACE,IAAID,KAAK,EAAEE,cAAc,KAAK,CAAC,EAAE;EAEjCZ,GAAG,IAAI,CAAC;EACR,MAAMa,IAAmB,GAAG;IAC1Bb,GAAG;IACHzB,CAAC,EAAEuC,IAAI,CAACC,GAAG,CAAC,CAAC;IACbJ,SAAS;IACTC,cAAc,EAAEF,KAAK,EAAEE;EACzB,CAAC;EACDb,MAAM,GAAGA,MAAM,CAACiB,MAAM,IAAIvB,UAAU,GAAG,CAAC,GAAGM,MAAM,CAACkB,KAAK,CAAC,CAAC,CAAC,EAAEJ,IAAI,CAAC,GAAG,CAAC,GAAGd,MAAM,EAAEc,IAAI,CAAC;EACrFR,UAAU,CAAC,CAAC;AACd;;AAEA;AACO,SAASa,GAAGA,CAAA,EAAS;EAC1B,IAAIjB,KAAK,EAAE;EACXA,KAAK,GAAG,IAAI;EACZ,IAAIJ,IAAI,IAAID,EAAE,CAACuB,cAAc,IAAI,CAAChB,YAAY,EAAE;IAC9CA,YAAY,GAAGP,EAAE,CAACuB,cAAc,CAACC,WAAW,CAACZ,WAAW,CAAC;EAC3D;EACAH,UAAU,CAAC,CAAC;AACd;;AAEA;AACA;AACA;AACA;AACA;AACO,SAASgB,MAAMA,CAAA,EAAS;EAC7B,IAAIlB,YAAY,EAAE;IAChBA,YAAY,CAACmB,MAAM,CAAC,CAAC;IACrBnB,YAAY,GAAG,IAAI;EACrB;EACA,IAAID,gBAAgB,EAAEqB,cAAc,CAAC,KAAK,CAAC;EAC3C,IAAI,CAACtB,KAAK,EAAE;EACZA,KAAK,GAAG,KAAK;EACbI,UAAU,CAAC,CAAC;AACd;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASkB,cAAcA,CAACC,EAAW,EAAQ;EAChD,IAAI,CAAC3B,IAAI,IAAID,EAAE,CAACE,QAAQ,CAAC2B,EAAE,KAAK,KAAK,IAAI,CAAC7B,EAAE,CAAC8B,cAAc,EAAE;EAC7D,IAAIF,EAAE,KAAKtB,gBAAgB,EAAE;EAC7B,IAAIsB,EAAE,EAAE;IACN5B,EAAE,CAAC8B,cAAc,CAACC,eAAe,CAAC,CAAC;EACrC,CAAC,MAAM;IACL/B,EAAE,CAAC8B,cAAc,CAACE,gBAAgB,CAAC,CAAC;EACtC;EACA1B,gBAAgB,GAAGsB,EAAE;EACrBnB,UAAU,CAAC,CAAC;AACd;AAEO,SAASwB,KAAKA,CAAA,EAAS;EAC5B,IAAI9B,MAAM,CAACiB,MAAM,KAAK,CAAC,EAAE;EACzBjB,MAAM,GAAG,EAAE;EACXM,UAAU,CAAC,CAAC;AACd;;AAEA;AACO,SAASyB,cAAcA,CAACC,QAAgB,EAAmB;EAChE,IAAI,CAACC,MAAM,CAACC,QAAQ,CAACF,QAAQ,CAAC,EAAE,OAAOhC,MAAM,CAACkB,KAAK,CAAC,CAAC;EACrD,OAAOlB,MAAM,CAACmC,MAAM,CAAExB,KAAK,IAAKA,KAAK,CAACV,GAAG,GAAG+B,QAAQ,CAAC;AACvD;AAEO,SAASI,QAAQA,CAAA,EAAkB;EACxC,OAAO;IACLC,SAAS,EAAEvC,IAAI;IACfwC,QAAQ,EAAEzC,EAAE,CAACE,QAAQ,EAAE2B,EAAE,IAAI,SAAS;IACtCa,YAAY,EAAErC,KAAK;IACnBsC,SAAS,EAAEpC,YAAY,KAAK,IAAI;IAChCD,gBAAgB;IAChBF,GAAG;IACHwC,MAAM,EAAEzC,MAAM,CAACkB,KAAK,CAAC;EACvB,CAAC;AACH;AAEO,SAASwB,SAASA,CAAClC,QAAoB,EAAc;EAC1DH,SAAS,CAACsC,GAAG,CAACnC,QAAQ,CAAC;EACvB,OAAO,MAAM;IACXH,SAAS,CAACuC,MAAM,CAACpC,QAAQ,CAAC;EAC5B,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/sync/tvRemoteSyncAdapter.js

@@ -0,0 +1,57 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.tvRemoteSyncAdapter = void 0;
+var _tvEventStore = require("../store/tvEventStore");
+/**
+ * tvRemoteSyncAdapter — streams captured TV remote events to Buoy Desktop via
+ * @buoy-gg/external-sync.
+ *
+ * Structurally matches external-sync's `ToolSyncAdapter` WITHOUT importing the
+ * package (same as every other tool's adapter). Auto-discovery in @buoy-gg/core
+ * picks it up by export name and announces the "tv-remote" capability.
+ *
+ * `getEventsSince` exists because snapshots are throttled 200ms trailing-edge
+ * per tool, which is too coarse to time a replay step's echo. Replay polls this
+ * awaited action instead and gets the real latency.
+ */
+
+const tvRemoteSyncAdapter = exports.tvRemoteSyncAdapter = {
+  version: 1,
+  getSnapshot() {
+    return (0, _tvEventStore.getState)();
+  },
+  subscribe(onChange) {
+    return (0, _tvEventStore.subscribe)(onChange);
+  },
+  actions: {
+    arm() {
+      (0, _tvEventStore.arm)();
+      return (0, _tvEventStore.getState)();
+    },
+    disarm() {
+      (0, _tvEventStore.disarm)();
+      return (0, _tvEventStore.getState)();
+    },
+    /** Cursor-paged echo poll. `seq: 0` returns everything buffered. */
+    getEventsSince(params) {
+      const since = typeof params?.seq === "number" ? params.seq : 0;
+      const state = (0, _tvEventStore.getState)();
+      return {
+        seq: state.seq,
+        events: (0, _tvEventStore.getEventsSince)(since)
+      };
+    },
+    setMenuCapture(params) {
+      (0, _tvEventStore.setMenuCapture)(params?.on === true);
+      return (0, _tvEventStore.getState)();
+    },
+    clear() {
+      (0, _tvEventStore.clear)();
+      return (0, _tvEventStore.getState)();
+    }
+  }
+};
+//# sourceMappingURL=tvRemoteSyncAdapter.js.map

package/lib/commonjs/sync/tvRemoteSyncAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_tvEventStore","require","tvRemoteSyncAdapter","exports","version","getSnapshot","getState","subscribe","onChange","actions","arm","disarm","getEventsSince","params","since","seq","state","events","setMenuCapture","on","clear"],"sourceRoot":"../../../src","sources":["sync/tvRemoteSyncAdapter.ts"],"mappings":";;;;;;AAaA,IAAAA,aAAA,GAAAC,OAAA;AAbA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAcO,MAAMC,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,GAAG;EACjCE,OAAO,EAAE,CAAC;EAEVC,WAAWA,CAAA,EAAkB;IAC3B,OAAO,IAAAC,sBAAQ,EAAC,CAAC;EACnB,CAAC;EAEDC,SAASA,CAACC,QAAoB,EAAc;IAC1C,OAAO,IAAAD,uBAAS,EAACC,QAAQ,CAAC;EAC5B,CAAC;EAEDC,OAAO,EAAE;IACPC,GAAGA,CAAA,EAAkB;MACnB,IAAAA,iBAAG,EAAC,CAAC;MACL,OAAO,IAAAJ,sBAAQ,EAAC,CAAC;IACnB,CAAC;IAEDK,MAAMA,CAAA,EAAkB;MACtB,IAAAA,oBAAM,EAAC,CAAC;MACR,OAAO,IAAAL,sBAAQ,EAAC,CAAC;IACnB,CAAC;IAED;IACAM,cAAcA,CAACC,MAAyB,EAGtC;MACA,MAAMC,KAAK,GAAG,OAAOD,MAAM,EAAEE,GAAG,KAAK,QAAQ,GAAGF,MAAM,CAACE,GAAG,GAAG,CAAC;MAC9D,MAAMC,KAAK,GAAG,IAAAV,sBAAQ,EAAC,CAAC;MACxB,OAAO;QAAES,GAAG,EAAEC,KAAK,CAACD,GAAG;QAAEE,MAAM,EAAE,IAAAL,4BAAc,EAACE,KAAK;MAAE,CAAC;IAC1D,CAAC;IAEDI,cAAcA,CAACL,MAAyB,EAAiB;MACvD,IAAAK,4BAAc,EAACL,MAAM,EAAEM,EAAE,KAAK,IAAI,CAAC;MACnC,OAAO,IAAAb,sBAAQ,EAAC,CAAC;IACnB,CAAC;IAEDc,KAAKA,CAAA,EAAkB;MACrB,IAAAA,mBAAK,EAAC,CAAC;MACP,OAAO,IAAAd,sBAAQ,EAAC,CAAC;IACnB;EACF;AACF,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,23 @@
+"use strict";
+
+/**
+ * @buoy-gg/tv-remote
+ *
+ * The device-side half of Buoy's TV remote driver: it CAPTURES the D-pad /
+ * select / menu / play-pause events the app actually receives and streams them
+ * to Buoy Desktop, which is where presses are injected from (adb / idb) and
+ * where macros are recorded and replayed.
+ *
+ * This package renders nothing and injects nothing. See the README for why.
+ */
+
+// =============================================================================
+// EXTERNAL SYNC (device → desktop dashboard)
+// =============================================================================
+export { tvRemoteSyncAdapter } from "./sync/tvRemoteSyncAdapter";
+
+// =============================================================================
+// CAPTURE STORE (arm/disarm + types)
+// =============================================================================
+export { arm, disarm, clear, setMenuCapture, getEventsSince, getState, subscribe } from "./store/tvEventStore";
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["tvRemoteSyncAdapter","arm","disarm","clear","setMenuCapture","getEventsSince","getState","subscribe"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;AACA;AACA,SAASA,mBAAmB,QAAQ,4BAA4B;;AAEhE;AACA;AACA;AACA,SACEC,GAAG,EACHC,MAAM,EACNC,KAAK,EACLC,cAAc,EACdC,cAAc,EACdC,QAAQ,EACRC,SAAS,QACJ,sBAAsB","ignoreList":[]}

package/lib/module/store/tvEventStore.js

@@ -0,0 +1,157 @@
+"use strict";
+
+/**
+ * tvEventStore — the whole device-side half of the TV remote tool.
+ *
+ * CONTRACT: this store only ever OBSERVES. It never injects, synthesizes, or
+ * fakes a remote press. Presses come from the host (Buoy Desktop shells out to
+ * `adb shell input keyevent` / `idb ui key`), because those go through the real
+ * platform focus engine; anything we could fake in-process would move focus
+ * without firing events, or fire events without moving focus. See
+ * TV_REMOTE_DRIVER_PLAN.md §2.
+ *
+ * It is also deliberately UI-less. On Android TV any focusable view we rendered
+ * would become a D-pad stop in the host app's focus order, so the tool would
+ * alter the navigation it is supposed to be replaying.
+ *
+ * Safe to ship in non-TV apps: the native event emitter is never touched unless
+ * `Platform.isTV` is true, so the cost on a phone is one boolean.
+ */
+
+import * as ReactNative from "react-native";
+
+/** One captured remote event, as it goes over the wire to the dashboard. */
+
+/**
+ * Ring buffer depth. Replay polls `getEventsSince` every few dozen ms with a
+ * ~2s budget per step, so 50 is many times more than any echo needs; it exists
+ * so a human scrubbing the echo strip has some scrollback.
+ */
+const MAX_EVENTS = 50;
+
+/**
+ * Continuous gestures are not presses and are never recorded — the macro format
+ * is discrete keys. Dropping them here keeps them out of the ring buffer so
+ * they can't push real presses out of it during a replay.
+ */
+const IGNORED_EVENT_TYPES = new Set(["pan", "swipeUp", "swipeDown", "swipeLeft", "swipeRight"]);
+/**
+ * `TVEventHandler` / `TVEventControl` only exist on the react-native-tvos fork.
+ * A namespace read (rather than a named import) keeps this module importable on
+ * stock react-native, where those exports are absent.
+ */
+const RN = ReactNative;
+const isTV = RN.Platform?.isTV === true;
+let events = [];
+let seq = 0;
+let armed = false;
+let menuCaptureArmed = false;
+let subscription = null;
+const listeners = new Set();
+function emitChange() {
+  listeners.forEach(listener => {
+    listener();
+  });
+}
+function handleEvent(raw) {
+  // Disarming removes the subscription, but don't take that on trust: a native
+  // emitter that delivered one more event after `remove()` would land a stray
+  // press in the buffer, and a stray press is exactly what a replay would
+  // mistake for a step's echo.
+  if (!armed) return;
+  const event = raw;
+  const eventType = event?.eventType;
+  if (typeof eventType !== "string") return;
+  if (IGNORED_EVENT_TYPES.has(eventType)) return;
+
+  /**
+   * Dedupe by ignoring key DOWN, never key UP. tvOS emits keyAction 1 (up)
+   * ONLY — taps reach the gesture recognizer at StateEnded — so filtering to
+   * "down" would swallow every tvOS event. Android's down-emit is
+   * feature-flagged off by default, but dropping it here is the correct
+   * invariant either way: one press must produce exactly one echo.
+   */
+  if (event?.eventKeyAction === 0) return;
+  seq += 1;
+  const next = {
+    seq,
+    t: Date.now(),
+    eventType,
+    eventKeyAction: event?.eventKeyAction
+  };
+  events = events.length >= MAX_EVENTS ? [...events.slice(1), next] : [...events, next];
+  emitChange();
+}
+
+/** Start pushing remote events into the buffer. Idempotent. */
+export function arm() {
+  if (armed) return;
+  armed = true;
+  if (isTV && RN.TVEventHandler && !subscription) {
+    subscription = RN.TVEventHandler.addListener(handleEvent);
+  }
+  emitChange();
+}
+
+/**
+ * Stop capturing and hand the Menu key back to the platform. Every teardown
+ * path funnels through here — leaving menu capture on would leave the app
+ * unable to navigate back, which is an App Store behavior change.
+ */
+export function disarm() {
+  if (subscription) {
+    subscription.remove();
+    subscription = null;
+  }
+  if (menuCaptureArmed) setMenuCapture(false);
+  if (!armed) return;
+  armed = false;
+  emitChange();
+}
+
+/**
+ * tvOS: route the Menu key to JS so it can be recorded, instead of letting it
+ * pop the navigation stack (and background the app at the root). This changes
+ * how the app under test behaves, so it is opt-in per recording session and is
+ * always undone on disarm.
+ */
+export function setMenuCapture(on) {
+  if (!isTV || RN.Platform.OS !== "ios" || !RN.TVEventControl) return;
+  if (on === menuCaptureArmed) return;
+  if (on) {
+    RN.TVEventControl.enableTVMenuKey();
+  } else {
+    RN.TVEventControl.disableTVMenuKey();
+  }
+  menuCaptureArmed = on;
+  emitChange();
+}
+export function clear() {
+  if (events.length === 0) return;
+  events = [];
+  emitChange();
+}
+
+/** Events strictly newer than `sinceSeq` — the replay echo cursor. */
+export function getEventsSince(sinceSeq) {
+  if (!Number.isFinite(sinceSeq)) return events.slice();
+  return events.filter(event => event.seq > sinceSeq);
+}
+export function getState() {
+  return {
+    supported: isTV,
+    platform: RN.Platform?.OS ?? "unknown",
+    captureArmed: armed,
+    listening: subscription !== null,
+    menuCaptureArmed,
+    seq,
+    recent: events.slice()
+  };
+}
+export function subscribe(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+//# sourceMappingURL=tvEventStore.js.map

package/lib/module/store/tvEventStore.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ReactNative","MAX_EVENTS","IGNORED_EVENT_TYPES","Set","RN","isTV","Platform","events","seq","armed","menuCaptureArmed","subscription","listeners","emitChange","forEach","listener","handleEvent","raw","event","eventType","has","eventKeyAction","next","t","Date","now","length","slice","arm","TVEventHandler","addListener","disarm","remove","setMenuCapture","on","OS","TVEventControl","enableTVMenuKey","disableTVMenuKey","clear","getEventsSince","sinceSeq","Number","isFinite","filter","getState","supported","platform","captureArmed","listening","recent","subscribe","add","delete"],"sourceRoot":"../../../src","sources":["store/tvEventStore.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/sync/tvRemoteSyncAdapter.js

@@ -0,0 +1,53 @@
+"use strict";
+
+/**
+ * tvRemoteSyncAdapter — streams captured TV remote events to Buoy Desktop via
+ * @buoy-gg/external-sync.
+ *
+ * Structurally matches external-sync's `ToolSyncAdapter` WITHOUT importing the
+ * package (same as every other tool's adapter). Auto-discovery in @buoy-gg/core
+ * picks it up by export name and announces the "tv-remote" capability.
+ *
+ * `getEventsSince` exists because snapshots are throttled 200ms trailing-edge
+ * per tool, which is too coarse to time a replay step's echo. Replay polls this
+ * awaited action instead and gets the real latency.
+ */
+
+import { arm, clear, disarm, getEventsSince, getState, setMenuCapture, subscribe } from "../store/tvEventStore";
+export const tvRemoteSyncAdapter = {
+  version: 1,
+  getSnapshot() {
+    return getState();
+  },
+  subscribe(onChange) {
+    return subscribe(onChange);
+  },
+  actions: {
+    arm() {
+      arm();
+      return getState();
+    },
+    disarm() {
+      disarm();
+      return getState();
+    },
+    /** Cursor-paged echo poll. `seq: 0` returns everything buffered. */
+    getEventsSince(params) {
+      const since = typeof params?.seq === "number" ? params.seq : 0;
+      const state = getState();
+      return {
+        seq: state.seq,
+        events: getEventsSince(since)
+      };
+    },
+    setMenuCapture(params) {
+      setMenuCapture(params?.on === true);
+      return getState();
+    },
+    clear() {
+      clear();
+      return getState();
+    }
+  }
+};
+//# sourceMappingURL=tvRemoteSyncAdapter.js.map

package/lib/module/sync/tvRemoteSyncAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["arm","clear","disarm","getEventsSince","getState","setMenuCapture","subscribe","tvRemoteSyncAdapter","version","getSnapshot","onChange","actions","params","since","seq","state","events","on"],"sourceRoot":"../../../src","sources":["sync/tvRemoteSyncAdapter.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SACEA,GAAG,EACHC,KAAK,EACLC,MAAM,EACNC,cAAc,EACdC,QAAQ,EACRC,cAAc,EACdC,SAAS,QAGJ,uBAAuB;AAE9B,OAAO,MAAMC,mBAAmB,GAAG;EACjCC,OAAO,EAAE,CAAC;EAEVC,WAAWA,CAAA,EAAkB;IAC3B,OAAOL,QAAQ,CAAC,CAAC;EACnB,CAAC;EAEDE,SAASA,CAACI,QAAoB,EAAc;IAC1C,OAAOJ,SAAS,CAACI,QAAQ,CAAC;EAC5B,CAAC;EAEDC,OAAO,EAAE;IACPX,GAAGA,CAAA,EAAkB;MACnBA,GAAG,CAAC,CAAC;MACL,OAAOI,QAAQ,CAAC,CAAC;IACnB,CAAC;IAEDF,MAAMA,CAAA,EAAkB;MACtBA,MAAM,CAAC,CAAC;MACR,OAAOE,QAAQ,CAAC,CAAC;IACnB,CAAC;IAED;IACAD,cAAcA,CAACS,MAAyB,EAGtC;MACA,MAAMC,KAAK,GAAG,OAAOD,MAAM,EAAEE,GAAG,KAAK,QAAQ,GAAGF,MAAM,CAACE,GAAG,GAAG,CAAC;MAC9D,MAAMC,KAAK,GAAGX,QAAQ,CAAC,CAAC;MACxB,OAAO;QAAEU,GAAG,EAAEC,KAAK,CAACD,GAAG;QAAEE,MAAM,EAAEb,cAAc,CAACU,KAAK;MAAE,CAAC;IAC1D,CAAC;IAEDR,cAAcA,CAACO,MAAyB,EAAiB;MACvDP,cAAc,CAACO,MAAM,EAAEK,EAAE,KAAK,IAAI,CAAC;MACnC,OAAOb,QAAQ,CAAC,CAAC;IACnB,CAAC;IAEDH,KAAKA,CAAA,EAAkB;MACrBA,KAAK,CAAC,CAAC;MACP,OAAOG,QAAQ,CAAC,CAAC;IACnB;EACF;AACF,CAAC","ignoreList":[]}

package/lib/typescript/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @buoy-gg/tv-remote
+ *
+ * The device-side half of Buoy's TV remote driver: it CAPTURES the D-pad /
+ * select / menu / play-pause events the app actually receives and streams them
+ * to Buoy Desktop, which is where presses are injected from (adb / idb) and
+ * where macros are recorded and replayed.
+ *
+ * This package renders nothing and injects nothing. See the README for why.
+ */
+export { tvRemoteSyncAdapter } from "./sync/tvRemoteSyncAdapter";
+export { arm, disarm, clear, setMenuCapture, getEventsSince, getState, subscribe, } from "./store/tvEventStore";
+export type { TvRemoteEvent, TvRemoteState } from "./store/tvEventStore";
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAKjE,OAAO,EACL,GAAG,EACH,MAAM,EACN,KAAK,EACL,cAAc,EACd,cAAc,EACd,QAAQ,EACR,SAAS,GACV,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}

package/lib/typescript/store/tvEventStore.d.ts

@@ -0,0 +1,66 @@
+/**
+ * tvEventStore — the whole device-side half of the TV remote tool.
+ *
+ * CONTRACT: this store only ever OBSERVES. It never injects, synthesizes, or
+ * fakes a remote press. Presses come from the host (Buoy Desktop shells out to
+ * `adb shell input keyevent` / `idb ui key`), because those go through the real
+ * platform focus engine; anything we could fake in-process would move focus
+ * without firing events, or fire events without moving focus. See
+ * TV_REMOTE_DRIVER_PLAN.md §2.
+ *
+ * It is also deliberately UI-less. On Android TV any focusable view we rendered
+ * would become a D-pad stop in the host app's focus order, so the tool would
+ * alter the navigation it is supposed to be replaying.
+ *
+ * Safe to ship in non-TV apps: the native event emitter is never touched unless
+ * `Platform.isTV` is true, so the cost on a phone is one boolean.
+ */
+/** One captured remote event, as it goes over the wire to the dashboard. */
+export interface TvRemoteEvent {
+    /** Monotonic counter — the cursor `getEventsSince` pages from. */
+    seq: number;
+    /** Capture time (ms epoch). */
+    t: number;
+    /** Raw RN event type: "up" | "down" | "left" | "right" | "select" | "playPause" | "menu" | "longSelect" | … */
+    eventType: string;
+    /** 0 = key down, 1 = key up. tvOS only ever emits 1. */
+    eventKeyAction?: number;
+}
+export interface TvRemoteState {
+    /** False on phones/tablets/web — the tool renders as unavailable. */
+    supported: boolean;
+    platform: string;
+    captureArmed: boolean;
+    /**
+     * Whether a native listener is actually attached. Distinct from
+     * `captureArmed` on purpose: if the RN build has no TVEventHandler, arming
+     * would otherwise look successful while nothing was ever captured, and the
+     * desktop would report every replay step as swallowed input.
+     */
+    listening: boolean;
+    /** tvOS only: Menu is being routed to JS instead of popping the stack. */
+    menuCaptureArmed: boolean;
+    seq: number;
+    recent: TvRemoteEvent[];
+}
+/** Start pushing remote events into the buffer. Idempotent. */
+export declare function arm(): void;
+/**
+ * Stop capturing and hand the Menu key back to the platform. Every teardown
+ * path funnels through here — leaving menu capture on would leave the app
+ * unable to navigate back, which is an App Store behavior change.
+ */
+export declare function disarm(): void;
+/**
+ * tvOS: route the Menu key to JS so it can be recorded, instead of letting it
+ * pop the navigation stack (and background the app at the root). This changes
+ * how the app under test behaves, so it is opt-in per recording session and is
+ * always undone on disarm.
+ */
+export declare function setMenuCapture(on: boolean): void;
+export declare function clear(): void;
+/** Events strictly newer than `sinceSeq` — the replay echo cursor. */
+export declare function getEventsSince(sinceSeq: number): TvRemoteEvent[];
+export declare function getState(): TvRemoteState;
+export declare function subscribe(listener: () => void): () => void;
+//# sourceMappingURL=tvEventStore.d.ts.map

package/lib/typescript/store/tvEventStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tvEventStore.d.ts","sourceRoot":"","sources":["../../../src/store/tvEventStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,kEAAkE;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,+GAA+G;IAC/G,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAwFD,+DAA+D;AAC/D,wBAAgB,GAAG,IAAI,IAAI,CAO1B;AAED;;;;GAIG;AACH,wBAAgB,MAAM,IAAI,IAAI,CAS7B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAUhD;AAED,wBAAgB,KAAK,IAAI,IAAI,CAI5B;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,EAAE,CAGhE;AAED,wBAAgB,QAAQ,IAAI,aAAa,CAUxC;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK1D"}

package/lib/typescript/sync/tvRemoteSyncAdapter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * tvRemoteSyncAdapter — streams captured TV remote events to Buoy Desktop via
+ * @buoy-gg/external-sync.
+ *
+ * Structurally matches external-sync's `ToolSyncAdapter` WITHOUT importing the
+ * package (same as every other tool's adapter). Auto-discovery in @buoy-gg/core
+ * picks it up by export name and announces the "tv-remote" capability.
+ *
+ * `getEventsSince` exists because snapshots are throttled 200ms trailing-edge
+ * per tool, which is too coarse to time a replay step's echo. Replay polls this
+ * awaited action instead and gets the real latency.
+ */
+import { type TvRemoteEvent, type TvRemoteState } from "../store/tvEventStore";
+export declare const tvRemoteSyncAdapter: {
+    version: number;
+    getSnapshot(): TvRemoteState;
+    subscribe(onChange: () => void): () => void;
+    actions: {
+        arm(): TvRemoteState;
+        disarm(): TvRemoteState;
+        /** Cursor-paged echo poll. `seq: 0` returns everything buffered. */
+        getEventsSince(params?: {
+            seq?: number;
+        }): {
+            seq: number;
+            events: TvRemoteEvent[];
+        };
+        setMenuCapture(params?: {
+            on?: boolean;
+        }): TvRemoteState;
+        clear(): TvRemoteState;
+    };
+};
+//# sourceMappingURL=tvRemoteSyncAdapter.d.ts.map

package/lib/typescript/sync/tvRemoteSyncAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tvRemoteSyncAdapter.d.ts","sourceRoot":"","sources":["../../../src/sync/tvRemoteSyncAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAQL,KAAK,aAAa,EAClB,KAAK,aAAa,EACnB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,mBAAmB;;mBAGf,aAAa;wBAIR,MAAM,IAAI,GAAG,MAAM,IAAI;;eAKlC,aAAa;kBAKV,aAAa;QAKvB,oEAAoE;gCAC5C;YAAE,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG;YACzC,GAAG,EAAE,MAAM,CAAC;YACZ,MAAM,EAAE,aAAa,EAAE,CAAC;SACzB;gCAMuB;YAAE,EAAE,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,aAAa;iBAK/C,aAAa;;CAKzB,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@buoy-gg/tv-remote",
+  "version": "7.0.31",
+  "description": "TV remote capture for React Native TV apps — records the D-pad/select/menu events the app actually receives, so Buoy Desktop can drive and replay real remote presses. Part of Buoy devtools.",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "lib/module/index.js",
+  "source": "src/index.tsx",
+  "files": [
+    "lib"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "devDependencies": {
+    "@types/react": "^19.1.0",
+    "@types/react-native": "^0.73.0",
+    "typescript": "~5.8.3"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Buoy-gg/buoy.git",
+    "directory": "packages/tv-remote"
+  },
+  "bugs": {
+    "url": "https://github.com/LovesWorking/react-native-buoy/issues"
+  },
+  "homepage": "https://buoy.gg/buoy/latest/docs/tools/tv-remote",
+  "publishConfig": {
+    "access": "public",
+    "tag": "latest"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "devtools",
+    "debugging",
+    "react-native-devtools",
+    "tvos",
+    "android-tv",
+    "react-native-tvos",
+    "remote",
+    "d-pad",
+    "focus"
+  ],
+  "scripts": {
+    "build": "bob build",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf lib",
+    "test": "pnpm run typecheck",
+    "postinstall": "echo \"Run pnpm build to compile this package\""
+  }
+}