react-native-tapline 0.0.0-stage → 1.0.0

package/dist/fiber.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleMemoComponent = exports.MemoComponent = exports.ForwardRef = exports.HostText = exports.HostComponent = exports.HostRoot = exports.IndeterminateComponent = exports.ClassComponent = exports.FunctionComponent = void 0;
+exports.isFiber = isFiber;
+exports.isFiberRoot = isFiberRoot;
+exports.isCompositeTag = isCompositeTag;
+exports.propsOf = propsOf;
+exports.firstHostChild = firstHostChild;
+exports.hostChildren = hostChildren;
+exports.componentName = componentName;
+exports.fiberName = fiberName;
+exports.sameFiber = sameFiber;
+const types_1 = require("./types");
+// Fiber tags (stable across React 17-19).
+exports.FunctionComponent = 0;
+exports.ClassComponent = 1;
+exports.IndeterminateComponent = 2;
+exports.HostRoot = 3;
+exports.HostComponent = 5;
+exports.HostText = 6;
+exports.ForwardRef = 11;
+exports.MemoComponent = 14;
+exports.SimpleMemoComponent = 15;
+function isFiber(value) {
+    return ((0, types_1.isRecord)(value) &&
+        typeof value.tag === 'number' &&
+        'memoizedProps' in value &&
+        'child' in value &&
+        'sibling' in value);
+}
+function isFiberRoot(value) {
+    return (0, types_1.isRecord)(value) && isFiber(value.current);
+}
+function isCompositeTag(tag) {
+    return (tag === exports.FunctionComponent ||
+        tag === exports.ClassComponent ||
+        tag === exports.IndeterminateComponent ||
+        tag === exports.ForwardRef ||
+        tag === exports.MemoComponent ||
+        tag === exports.SimpleMemoComponent);
+}
+/** Props of a fiber as a plain record ({} when absent or a text string). */
+function propsOf(fiber) {
+    return (0, types_1.isRecord)(fiber.memoizedProps) ? fiber.memoizedProps : {};
+}
+/** The first host fiber below `fiber` in tree order (a scroll view's content container); null when none. */
+function firstHostChild(fiber) {
+    for (let child = fiber.child; child; child = child.sibling) {
+        if (child.tag === exports.HostComponent)
+            return child;
+        const nested = firstHostChild(child);
+        if (nested)
+            return nested;
+    }
+    return null;
+}
+/** The host fibers directly below `fiber`, looking through non-host wrappers but not into hosts. */
+function hostChildren(fiber) {
+    const found = [];
+    const visit = (first) => {
+        for (let child = first; child; child = child.sibling) {
+            if (child.tag === exports.HostComponent)
+                found.push(child);
+            else
+                visit(child.child);
+        }
+    };
+    visit(fiber.child);
+    return found;
+}
+/** Best-effort display name of a component type; null when anonymous. */
+function componentName(type, depth = 0) {
+    if (depth > 4 || type == null)
+        return null;
+    if (typeof type === 'string')
+        return type;
+    if (typeof type === 'function') {
+        const named = type;
+        if (typeof named.displayName === 'string' && named.displayName)
+            return named.displayName;
+        if (typeof named.name === 'string' && named.name)
+            return named.name;
+        return null;
+    }
+    if ((0, types_1.isRecord)(type)) {
+        if (typeof type.displayName === 'string' && type.displayName)
+            return type.displayName;
+        // forwardRef({render}) / memo({type}) wrappers
+        return componentName(type.render, depth + 1) ?? componentName(type.type, depth + 1);
+    }
+    return null;
+}
+function fiberName(fiber) {
+    return componentName(fiber.type) ?? componentName(fiber.elementType);
+}
+/** Whether `fiber` is `other` or its alternate (the same logical fiber). */
+function sameFiber(fiber, other) {
+    return fiber === other || fiber === other.alternate || fiber.alternate === other;
+}
+//# sourceMappingURL=fiber.js.map

package/dist/fiber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fiber.js","sourceRoot":"","sources":["../src/fiber.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+import { type TaplineStorage } from './storage';
+import type { AppInfo } from './types';
+export interface TaplineOptions {
+    /**
+     * The on switch: Tapline does nothing at all unless this is true. Turn it on in development
+     * and test builds only, e.g. `enabled: process.env.EXPO_PUBLIC_TAPLINE_ENABLED === '1'`.
+     * The build carries no address or token: a phone connects by scanning a pairing code.
+     */
+    enabled: boolean;
+    app?: AppInfo;
+    /**
+     * Where the paired computer is remembered. Default: expo-secure-store when the app has it,
+     * else memory (pair again after each restart).
+     */
+    storage?: TaplineStorage;
+    /** Connect straight to this host instead of pairing (e.g. a simulator on the same computer). Needs `token`. */
+    url?: string;
+    /** The host's token, for `url` (`tapline token`). Keep it out of source files. */
+    token?: string;
+    /**
+     * Alerts (Alert.alert / Alert.prompt): 'record' (default) shows them as usual and tells the
+     * agent what is open; 'stand-in' shows Tapline's own in-app version instead, whose buttons an
+     * agent can press. Tapline's own prompts always stay native.
+     */
+    alerts?: 'record' | 'stand-in';
+}
+/**
+ * Start the in-app agent: it reconnects to the computer this app was paired with, and pairs
+ * when a Tapline pairing link opens the app. Safe to call more than once; never throws.
+ */
+export declare function startTapline(options: TaplineOptions): void;
+export declare function stopTapline(): void;
+export { registerTaplineCommand } from './commands';
+export type { TaplineCommand } from './commands';
+export { isTaplineLink, parseTaplineLink } from './link';
+export type { TaplineLink } from './link';
+export { memoryStorage, secureStoreStorage } from './storage';
+export type { TaplineStorage } from './storage';
+export { TaplineAgent } from './agent';
+export type { AgentDeps, AgentOptions, LinkingLike, Pairing } from './agent';
+export { TaplineClient, collectDeviceInfo, defaultCapabilities, backoffDelay } from './client';
+export type { ClientOptions, ClientDeps, WebSocketLike } from './client';
+export { methods } from './methods';
+export { press, longPress, typeText, scroll, toggle, openURL, getLogs, reload, screenshot, resolveTarget, configureActions, } from './actions';
+export { tree, setMeasurer, defaultMeasurer } from './inspect';
+export type { Measurer } from './inspect';
+export { getRoots } from './register';
+export { getLogEntries, installLogs, uninstallLogs } from './logs';
+export { TaplineError, PROTOCOL_VERSION } from './types';
+export type { Action, AppInfo, DeviceInfo, ErrorCode, Frame, LogEntry, ScreenInfo, Target, TaplineElement, TreeResult, } from './types';

package/dist/index.js

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROTOCOL_VERSION = exports.TaplineError = exports.uninstallLogs = exports.installLogs = exports.getLogEntries = exports.getRoots = exports.defaultMeasurer = exports.setMeasurer = exports.tree = exports.configureActions = exports.resolveTarget = exports.screenshot = exports.reload = exports.getLogs = exports.openURL = exports.toggle = exports.scroll = exports.typeText = exports.longPress = exports.press = exports.methods = exports.backoffDelay = exports.defaultCapabilities = exports.collectDeviceInfo = exports.TaplineClient = exports.TaplineAgent = exports.secureStoreStorage = exports.memoryStorage = exports.parseTaplineLink = exports.isTaplineLink = exports.registerTaplineCommand = void 0;
+exports.startTapline = startTapline;
+exports.stopTapline = stopTapline;
+const react_native_1 = require("react-native");
+const agent_1 = require("./agent");
+const alerts_1 = require("./alerts");
+const logs_1 = require("./logs");
+const network_1 = require("./network");
+const wait_1 = require("./wait");
+const storage_1 = require("./storage");
+let agent = null;
+let stopNetworkLog = null;
+/** Failed requests go into the app's logs, so `logs` explains a broken screen. */
+function watchNetwork() {
+    (0, network_1.installNetworkTracking)();
+    (0, wait_1.setNetworkIdleProvider)(() => (0, network_1.inFlight)() === 0);
+    stopNetworkLog?.();
+    stopNetworkLog = (0, network_1.onNetworkFailure)((failure) => {
+        const outcome = failure.status ?? failure.error ?? 'failed';
+        const level = failure.status !== null && failure.status < 500 ? 'warn' : 'error';
+        (0, logs_1.addLog)(level, `[network] ${failure.method} ${failure.url} → ${outcome}`);
+    });
+}
+function unwatchNetwork() {
+    stopNetworkLog?.();
+    stopNetworkLog = null;
+    (0, wait_1.setNetworkIdleProvider)(null);
+    (0, network_1.uninstallNetworkTracking)();
+}
+function trimmed(value) {
+    return typeof value === 'string' ? value.trim() : '';
+}
+function confirmWithAlert(title, message, ok) {
+    return new Promise((resolve) => {
+        (0, alerts_1.nativeAlert)(title, message, [
+            { text: 'Cancel', style: 'cancel', onPress: () => resolve(false) },
+            { text: ok, onPress: () => resolve(true) },
+        ], { cancelable: true, onDismiss: () => resolve(false) });
+    });
+}
+function notifyWithAlert(title, message) {
+    (0, alerts_1.nativeAlert)(title, message);
+}
+/**
+ * Start the in-app agent: it reconnects to the computer this app was paired with, and pairs
+ * when a Tapline pairing link opens the app. Safe to call more than once; never throws.
+ */
+function startTapline(options) {
+    if (options?.enabled !== true)
+        return;
+    try {
+        stopTapline();
+        const url = trimmed(options.url);
+        const token = trimmed(options.token);
+        if ((url === '') !== (token === '')) {
+            (0, logs_1.originalLog)(`[tapline] url and token go together; ignoring the ${url ? 'url' : 'token'} and waiting for a pairing link`);
+        }
+        let storage = options.storage ?? (0, storage_1.secureStoreStorage)();
+        if (storage === null) {
+            (0, logs_1.originalLog)('[tapline] expo-secure-store is not installed, so a pairing lasts until the app restarts (or pass `storage`)');
+            storage = (0, storage_1.memoryStorage)();
+        }
+        (0, logs_1.installLogs)();
+        (0, alerts_1.installAlertTracking)({ standIn: options.alerts === 'stand-in' });
+        watchNetwork();
+        const next = new agent_1.TaplineAgent({ app: options.app, ...(url !== '' && token !== '' ? { direct: { url, token } } : {}) }, { storage, linking: react_native_1.Linking, confirm: confirmWithAlert, notify: notifyWithAlert });
+        agent = next;
+        void next.start();
+    }
+    catch {
+        // never throw into the app
+    }
+}
+function stopTapline() {
+    const current = agent;
+    agent = null;
+    try {
+        current?.stop();
+        if (current) {
+            (0, logs_1.uninstallLogs)();
+            (0, alerts_1.uninstallAlertTracking)();
+            unwatchNetwork();
+        }
+    }
+    catch {
+        // ignore
+    }
+}
+var commands_1 = require("./commands");
+Object.defineProperty(exports, "registerTaplineCommand", { enumerable: true, get: function () { return commands_1.registerTaplineCommand; } });
+var link_1 = require("./link");
+Object.defineProperty(exports, "isTaplineLink", { enumerable: true, get: function () { return link_1.isTaplineLink; } });
+Object.defineProperty(exports, "parseTaplineLink", { enumerable: true, get: function () { return link_1.parseTaplineLink; } });
+var storage_2 = require("./storage");
+Object.defineProperty(exports, "memoryStorage", { enumerable: true, get: function () { return storage_2.memoryStorage; } });
+Object.defineProperty(exports, "secureStoreStorage", { enumerable: true, get: function () { return storage_2.secureStoreStorage; } });
+var agent_2 = require("./agent");
+Object.defineProperty(exports, "TaplineAgent", { enumerable: true, get: function () { return agent_2.TaplineAgent; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "TaplineClient", { enumerable: true, get: function () { return client_1.TaplineClient; } });
+Object.defineProperty(exports, "collectDeviceInfo", { enumerable: true, get: function () { return client_1.collectDeviceInfo; } });
+Object.defineProperty(exports, "defaultCapabilities", { enumerable: true, get: function () { return client_1.defaultCapabilities; } });
+Object.defineProperty(exports, "backoffDelay", { enumerable: true, get: function () { return client_1.backoffDelay; } });
+var methods_1 = require("./methods");
+Object.defineProperty(exports, "methods", { enumerable: true, get: function () { return methods_1.methods; } });
+var actions_1 = require("./actions");
+Object.defineProperty(exports, "press", { enumerable: true, get: function () { return actions_1.press; } });
+Object.defineProperty(exports, "longPress", { enumerable: true, get: function () { return actions_1.longPress; } });
+Object.defineProperty(exports, "typeText", { enumerable: true, get: function () { return actions_1.typeText; } });
+Object.defineProperty(exports, "scroll", { enumerable: true, get: function () { return actions_1.scroll; } });
+Object.defineProperty(exports, "toggle", { enumerable: true, get: function () { return actions_1.toggle; } });
+Object.defineProperty(exports, "openURL", { enumerable: true, get: function () { return actions_1.openURL; } });
+Object.defineProperty(exports, "getLogs", { enumerable: true, get: function () { return actions_1.getLogs; } });
+Object.defineProperty(exports, "reload", { enumerable: true, get: function () { return actions_1.reload; } });
+Object.defineProperty(exports, "screenshot", { enumerable: true, get: function () { return actions_1.screenshot; } });
+Object.defineProperty(exports, "resolveTarget", { enumerable: true, get: function () { return actions_1.resolveTarget; } });
+Object.defineProperty(exports, "configureActions", { enumerable: true, get: function () { return actions_1.configureActions; } });
+var inspect_1 = require("./inspect");
+Object.defineProperty(exports, "tree", { enumerable: true, get: function () { return inspect_1.tree; } });
+Object.defineProperty(exports, "setMeasurer", { enumerable: true, get: function () { return inspect_1.setMeasurer; } });
+Object.defineProperty(exports, "defaultMeasurer", { enumerable: true, get: function () { return inspect_1.defaultMeasurer; } });
+var register_1 = require("./register");
+Object.defineProperty(exports, "getRoots", { enumerable: true, get: function () { return register_1.getRoots; } });
+var logs_2 = require("./logs");
+Object.defineProperty(exports, "getLogEntries", { enumerable: true, get: function () { return logs_2.getLogEntries; } });
+Object.defineProperty(exports, "installLogs", { enumerable: true, get: function () { return logs_2.installLogs; } });
+Object.defineProperty(exports, "uninstallLogs", { enumerable: true, get: function () { return logs_2.uninstallLogs; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "TaplineError", { enumerable: true, get: function () { return types_1.TaplineError; } });
+Object.defineProperty(exports, "PROTOCOL_VERSION", { enumerable: true, get: function () { return types_1.PROTOCOL_VERSION; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/inspect.d.ts

@@ -0,0 +1,245 @@
+import { type Fiber, type FiberRootLike } from './fiber';
+import { type Action, type Frame, type ScreenInfo, type TaplineElement, type TreeResult } from './types';
+/** How much of an element's text a line shows (AGENT-TOOLS v1.5); a cut ends with `…(+N)`, the count left out. */
+export declare const MAX_TEXT = 200;
+/**
+ * How much text a container keeps for matching, and how much of any text goes over the wire. A Text
+ * host keeps all of its own text, so `wait_for` and `{text}` targets check all of it.
+ */
+export declare const MAX_KEPT_TEXT = 2000;
+/** The first `max` UTF-16 units of a text, one fewer when that would cut a character (an emoji) in half. */
+export declare function sliceWhole(text: string, max: number): string;
+/** Text as a line quotes it: whitespace flattened, cut at `max` with `…(+N)` (N counts `more` too: what was cut off before). */
+export declare function cutText(raw: string, more?: number, max?: number): string;
+/** One host component (View, Text, TextInput, ...) in the current fiber tree. */
+export interface HostNode {
+    /** Position in document order. */
+    index: number;
+    /** Index of the nearest host ancestor, -1 for top-level. */
+    parent: number;
+    fiber: Fiber;
+    hostType: string;
+    /** Composite fibers between this host and the previous host, innermost first. */
+    owners: Fiber[];
+    /** Descendant text, whitespace-collapsed and trimmed: all of it for a Text host, at most MAX_KEPT_TEXT chars otherwise. */
+    text: string;
+    isText: boolean;
+    insideText: boolean;
+}
+/** Text as an agent sees and matches it: without the invisible direction marks. */
+export declare function displayText(raw: string): string;
+/**
+ * Whether a host element and everything inside it is out of the user's reach, so Tapline leaves
+ * it out: hidden from accessibility (React Native Screens marks a screen covered by another this
+ * way, React Navigation its unfocused screens), not displayed, an inactive screen, or a tab that
+ * isn't selected (native tabs keep every tab mounted and turn off touches on the hidden ones).
+ */
+export declare function hidesSubtree(hostType: string, props: Record<string, unknown>): boolean;
+/** The navigation object React Navigation hands each screen (only what Tapline calls). */
+export interface NavigationLike {
+    isFocused?: () => boolean;
+    canGoBack?: () => boolean;
+    goBack?: () => void;
+    navigate?: (name: string) => void;
+    getState?: () => unknown;
+}
+/** A visible screen component that received React Navigation's `route` and `navigation` props. */
+export interface RouteFound {
+    key: string;
+    name: string;
+    params: unknown;
+    navigation: NavigationLike;
+    focused: boolean;
+    /** Route names from the outermost navigator to this one. */
+    chain: string[];
+}
+/** One tab of a native tab bar (drawn by the OS, so not in the host tree as a button). */
+export interface TabFound {
+    fiber: Fiber;
+    title: string;
+    screenKey: string | null;
+    selected: boolean;
+}
+export declare function collectNodes(roots?: FiberRootLike[]): HostNode[];
+/** The focused screen: the deepest focused route, the last one on ties (drawn on top). */
+export declare function currentRoute(routes: RouteFound[]): RouteFound | null;
+/** First defined prop `key` on the host fiber, then on its owners (innermost first). */
+export declare function findProp(node: HostNode, key: string): unknown;
+export declare function findHandler(node: HostNode, key: string): ((...args: unknown[]) => unknown) | null;
+export declare function isScrollNode(node: HostNode): boolean;
+export declare function isInputNode(node: HostNode): boolean;
+export declare function isSwitchNode(node: HostNode): boolean;
+export declare function rememberTyped(node: HostNode, text: string): void;
+export declare function currentInputValue(node: HostNode): string;
+export declare function roleName(info: Pick<Entry['info'], 'role' | 'type' | 'actions'>): string;
+export interface NodeInfo {
+    type: string;
+    role: string | null;
+    testID: string | null;
+    label: string | null;
+    text: string;
+    value: string | null;
+    /** An empty input's placeholder, else null. */
+    placeholder: string | null;
+    actions: Action[];
+    disabled: boolean;
+    selected: boolean;
+    checked: boolean | 'mixed' | null;
+    /** Shown in `tree` without `all`. */
+    interesting: boolean;
+}
+export declare function describeNodes(nodes: HostNode[]): NodeInfo[];
+export type Measurer = (fiber: Fiber) => Promise<Frame | null>;
+/**
+ * Public instances of a host fiber, in preference order:
+ *  - old architecture: `stateNode` itself
+ *  - Fabric: `stateNode.canonical.publicInstance` (null until a ref was requested)
+ */
+export declare function publicInstancesOf(fiber: Fiber): unknown[];
+export declare const defaultMeasurer: Measurer;
+/** Inject a measuring function (tests); pass null to restore the default. */
+export declare function setMeasurer(next: Measurer | null): void;
+export declare function measureFiber(fiber: Fiber): Promise<Frame | null>;
+/**
+ * The host fiber a real touch at window point (x, y) would land on: null when nothing there
+ * takes touches, undefined when this can't be told (old architecture, tests, a timeout).
+ */
+export type HitTester = (x: number, y: number) => Promise<Fiber | null | undefined>;
+/**
+ * The host fibers of mounted `Modal`s, in tree order. A closed `Modal` renders nothing, but one
+ * that is being dismissed stays mounted (with `visible` false) until iOS ends the animation; it
+ * still covers the screen, so it is listed here too (see `closingModalHosts`).
+ */
+export declare function openModalHosts(): Fiber[];
+/** The mounted modal hosts that are on their way out: `visible` is false while the dismiss animation runs. */
+export declare function closingModalHosts(): Fiber[];
+/** Whether a `Modal` is open: its window covers the whole app, the native tab bar included. */
+export declare function modalOpen(): boolean;
+/**
+ * Fabric's own hit test (`findNodeAtPoint`, as React Native's element inspector uses): open modals
+ * first (a modal's window covers the whole screen, so a touch never reaches what's behind it),
+ * then the roots, topmost first.
+ */
+export declare const defaultHitTester: HitTester;
+/** Inject a hit tester (tests); pass null to restore the default. */
+export declare function setHitTester(next: HitTester | null): void;
+export declare function hitTest(x: number, y: number): Promise<Fiber | null | undefined>;
+/** Whether `inner` is `outer` or inside it (following `return` links). */
+export declare function isWithin(inner: Fiber, outer: Fiber): boolean;
+export declare function getScreen(): ScreenInfo;
+export declare function isOnScreen(frame: Frame, screen: ScreenInfo): boolean;
+export declare function frameContains(frame: Frame, x: number, y: number): boolean;
+export interface Entry {
+    node: HostNode;
+    info: NodeInfo;
+    /** Set for a tab of a native tab bar: pressing it switches tabs through navigation. */
+    tab?: TabFound;
+    /** Set for the back button of the native navigation bar: pressing it goes back. */
+    navBack?: true;
+}
+export interface Snapshot {
+    nodes: HostNode[];
+    entries: Entry[];
+    screen: ScreenInfo;
+    /** Visible screens that got React Navigation's props, in tree order. */
+    routes: RouteFound[];
+    /**
+     * Set while a modal (a sheet) is open: what the open sheet hides, worked out on first call. The
+     * look leaves the screen behind a sheet out, so `entries` don't hold it; this does, with the
+     * `nodes` they index into (the sheet's own elements are among them, in tree order).
+     */
+    behind?: () => BehindSheet;
+}
+/** The screen behind the topmost open modal, which the element list leaves out. */
+export interface BehindSheet {
+    /** The topmost modal's host fiber. */
+    sheet: Fiber;
+    /** Everything walked (behind and inside the sheet); `entries[i]` describes `nodes[i]`. */
+    nodes: HostNode[];
+    entries: Entry[];
+    /** Only the elements outside the sheet: what it covers. */
+    hidden: Entry[];
+}
+/**
+ * An object that stays the same for a host element across re-renders: Fabric clones `stateNode`
+ * on every update but keeps its `canonical`; elsewhere the stateNode, else the fiber itself.
+ */
+export declare function stableObjectKey(fiber: Fiber): object;
+/** Take a fresh view of the current fiber tree (no measuring). */
+export declare function takeSnapshot(): Snapshot;
+/** Where iOS draws the native tab bar: from `top` to the bottom of the screen, `tabs` spread evenly. */
+export interface NativeTabBar {
+    top: number;
+    tabs: Entry[];
+}
+/**
+ * The native tab bar, which iOS draws outside React's tree: on an iPhone in portrait, 49 points
+ * above the home-indicator inset, its items spread evenly across the width (the classic and the
+ * iOS 26 bars alike). Null without native tabs, on other platforms, in landscape, and while a
+ * modal's window covers it.
+ */
+export declare function nativeTabBar(snapshot: Snapshot): NativeTabBar | null;
+/** The tab under x on the bar. */
+export declare function tabAt(bar: NativeTabBar, x: number, width: number): Entry | undefined;
+/** Where iOS draws the native navigation bar: from the top of the screen to `bottom`. */
+export interface NativeNavBar {
+    top: 0;
+    bottom: number;
+    title?: string;
+    canGoBack: boolean;
+    /** The header config fiber; what is inside it is drawn in the bar and stays reachable. */
+    header: Fiber;
+}
+/**
+ * The native navigation bar react-native-screens draws for the visible screen, outside React's
+ * layout. The visible header is the deepest `RNSScreenStackHeaderConfig` reached by walking each
+ * root and, at an `RNSScreenStack`, descending only into its last (top) `RNSScreen`. Null without
+ * one, with `hidden` set, on other platforms, in landscape, and while a modal's window covers it.
+ */
+export declare function nativeNavBar(snapshot: Snapshot): NativeNavBar | null;
+/** Whether a fiber is drawn inside the navigation bar (a custom header item): it stays reachable. */
+export declare function inNavBarHeader(bar: NativeNavBar, fiber: Fiber): boolean;
+export declare function resetRefs(): void;
+/** The ref for a fiber in the remembered snapshot, allocating a new one when unseen. */
+export declare function refFor(fiber: Fiber): string;
+export interface OverlayElement {
+    ref: string | null;
+    type: string;
+    label: string | null;
+    id: string | null;
+    frame: Frame;
+}
+/**
+ * `overlay`: the elements on screen with their frames and the UI revision, for the live
+ * viewer's boxes. Unlike `tree` it leaves refs and the change baseline alone.
+ */
+export declare function overlay(): Promise<{
+    rev: number;
+    screen: ScreenInfo;
+    elements: OverlayElement[];
+}>;
+export declare function fiberForRef(ref: string): Fiber | null;
+/** An entry as an element. `ref` is the fiber's ref unless one is passed ('' for an element that isn't listed). */
+export declare function toElement(entry: Entry, frame: Frame | null, ref?: string): TaplineElement;
+/** Forget the previous tree (tests; a new connection). */
+export declare function forgetLastTree(): void;
+/** An entry about to be listed, with its measured frame. */
+export interface Listed {
+    entry: Entry;
+    frame: Frame | null;
+}
+/**
+ * AGENT-TOOLS v1.3 "Duplicates": when an element and its nearest listed ancestor have the same
+ * quoted text and the same rect (within 1 pt), only one is listed: the one that takes an action,
+ * else (both or neither do) the ancestor. Roles may differ: a labelled wrapper around an input
+ * lists only the input. Elements are in tree order, so an ancestor comes before its descendants.
+ */
+export declare function foldDuplicates(snapshot: Snapshot, listed: Listed[]): Listed[];
+/**
+ * `tree`: the screen as elements. A look (no `changes`) starts the refs at e1 again. With
+ * `changes: true`, which the host asks for in an action's answer, elements still on screen keep
+ * their refs and new ones count on from the highest ref handed out since the last look, so an old
+ * ref never lands on another element; it also reports what changed since the previous call. A new
+ * host session has no previous call (`forgetLastTree`), so its first list starts over like a look.
+ */
+export declare function tree(params?: unknown): Promise<TreeResult>;