react-native-tapline 0.0.0-stage → 1.1.0

package/dist/register.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commitRevision = commitRevision;
+exports.onCommit = onCommit;
+exports.installHook = installHook;
+exports.getRoots = getRoots;
+exports.resetRegistry = resetRegistry;
+/**
+ * Import this FIRST in the app's entry file, before React / React Native:
+ *
+ *   import 'react-native-tapline/register';
+ *
+ * It installs a minimal React DevTools global hook (or wraps the existing one,
+ * chaining every call) so Tapline can see the app's fiber roots. This file must
+ * not import react or react-native.
+ */
+const fiber_1 = require("./fiber");
+const types_1 = require("./types");
+const WRAPPED = Symbol.for('tapline.hookWrapped');
+/** renderer id -> roots seen via onCommitFiberRoot */
+const rootsByRenderer = new Map();
+let installedHook = null;
+/** How many React commits have happened: the screen's revision, for the live viewer. */
+let revision = 0;
+const commitListeners = new Set();
+function committed() {
+    revision += 1;
+    for (const listener of commitListeners)
+        safely(() => listener(revision));
+}
+/** The number of React commits so far; it changes whenever the UI may have changed. */
+function commitRevision() {
+    return revision;
+}
+/** Called after every React commit with the new revision; returns a function that stops it. */
+function onCommit(listener) {
+    commitListeners.add(listener);
+    return () => {
+        commitListeners.delete(listener);
+    };
+}
+function record(rendererId, root) {
+    if (!(0, fiber_1.isFiberRoot)(root))
+        return;
+    let set = rootsByRenderer.get(rendererId);
+    if (!set) {
+        set = new Set();
+        rootsByRenderer.set(rendererId, set);
+    }
+    // A root with no children has been unmounted.
+    if (root.current.child === null)
+        set.delete(root);
+    else
+        set.add(root);
+}
+function forgetByFiber(fiber) {
+    if (!(0, fiber_1.isFiber)(fiber) || fiber.tag !== fiber_1.HostRoot)
+        return;
+    for (const set of rootsByRenderer.values()) {
+        for (const root of set) {
+            if (root.current === fiber || root.current.alternate === fiber || root === fiber.stateNode) {
+                set.delete(root);
+            }
+        }
+    }
+}
+function numberArg(value) {
+    return typeof value === 'number' ? value : 0;
+}
+function safely(fn) {
+    try {
+        fn();
+    }
+    catch {
+        // never break React because of Tapline
+    }
+}
+function wrap(hook, name, before) {
+    const previous = hook[name];
+    const wrapped = function (...args) {
+        safely(() => before(args));
+        return typeof previous === 'function' ? previous.apply(hook, args) : undefined;
+    };
+    hook[name] = wrapped;
+}
+function createHook() {
+    let nextId = 1;
+    const hook = {
+        supportsFiber: true,
+        renderers: new Map(),
+        inject(renderer) {
+            const id = nextId++;
+            hook.renderers?.set(id, renderer);
+            return id;
+        },
+        onCommitFiberRoot() { },
+        onCommitFiberUnmount() { },
+        onPostCommitFiberRoot() { },
+        checkDCE() { },
+        onScheduleFiberRoot() { },
+        setStrictMode() { },
+        sub() {
+            return () => { };
+        },
+        on() { },
+        off() { },
+        emit() { },
+        getFiberRoots(rendererId) {
+            return rootsByRenderer.get(rendererId) ?? new Set();
+        },
+    };
+    return hook;
+}
+/**
+ * Install (or wrap) the hook on `target` (default: globalThis). Idempotent per
+ * hook object. Returns the hook in effect.
+ */
+function installHook(target = globalThis) {
+    const holder = target;
+    const existing = holder.__REACT_DEVTOOLS_GLOBAL_HOOK__;
+    let hook;
+    if ((0, types_1.isRecord)(existing)) {
+        hook = existing;
+        if (Object.prototype.hasOwnProperty.call(hook, WRAPPED)) {
+            installedHook = hook;
+            return hook;
+        }
+    }
+    else {
+        hook = createHook();
+        try {
+            Object.defineProperty(target, '__REACT_DEVTOOLS_GLOBAL_HOOK__', {
+                configurable: true,
+                enumerable: false,
+                writable: true,
+                value: hook,
+            });
+        }
+        catch {
+            holder.__REACT_DEVTOOLS_GLOBAL_HOOK__ = hook;
+        }
+    }
+    wrap(hook, 'onCommitFiberRoot', (args) => {
+        record(numberArg(args[0]), args[1]);
+        committed();
+    });
+    wrap(hook, 'onCommitFiberUnmount', (args) => forgetByFiber(args[1]));
+    Object.defineProperty(hook, WRAPPED, { value: true, enumerable: false });
+    installedHook = hook;
+    return hook;
+}
+/** All live fiber roots known to Tapline. */
+function getRoots() {
+    const found = new Set();
+    for (const set of rootsByRenderer.values())
+        for (const root of set)
+            found.add(root);
+    // An already-present DevTools hook may know roots committed before we wrapped it.
+    const hook = installedHook;
+    if (hook && hook.renderers instanceof Map && typeof hook.getFiberRoots === 'function') {
+        for (const id of hook.renderers.keys()) {
+            safely(() => {
+                const roots = hook.getFiberRoots?.(id);
+                if (roots instanceof Set) {
+                    for (const root of roots)
+                        if ((0, fiber_1.isFiberRoot)(root))
+                            found.add(root);
+                }
+            });
+        }
+    }
+    return [...found].filter((root) => root.current.child !== null);
+}
+/** Test helper: forget recorded roots and the installed-hook memory. */
+function resetRegistry() {
+    rootsByRenderer.clear();
+    installedHook = null;
+}
+installHook();
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

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

package/dist/settle.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AGENT-TOOLS §6: the screen counts as still after `quietMs` without a React commit, with a cap.
+ * Resolves with the milliseconds waited. Native-driver animations don't commit, so the tree can be
+ * still while pixels move; that's fine for an element list.
+ */
+export declare function waitUntilStill(options: {
+    quietMs: number;
+    capMs: number;
+    onCommit: (listener: () => void) => () => void;
+    now: () => number;
+    /** Called when the wait ended at the cap, with the screen still changing. */
+    onCap?: () => void;
+}): Promise<number>;
+/**
+ * After the commits stop, a native-driver animation (a sheet sliding up) can still be moving.
+ * Polls `measure` every `pollMs` and resolves with the milliseconds waited once two readings in a
+ * row agree within 1 pt in x and y, or at `capMs`. A null reading (can't be measured) ends the wait.
+ */
+export declare function waitUntilSteady(measure: () => Promise<{
+    x: number;
+    y: number;
+} | null>, options: {
+    pollMs: number;
+    capMs: number;
+    now: () => number;
+    onCap?: () => void;
+}): Promise<number>;

package/dist/settle.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitUntilStill = waitUntilStill;
+exports.waitUntilSteady = waitUntilSteady;
+/**
+ * AGENT-TOOLS §6: the screen counts as still after `quietMs` without a React commit, with a cap.
+ * Resolves with the milliseconds waited. Native-driver animations don't commit, so the tree can be
+ * still while pixels move; that's fine for an element list.
+ */
+function waitUntilStill(options) {
+    const started = options.now();
+    return new Promise((resolve) => {
+        let done = false;
+        let quiet;
+        let unsubscribe = () => undefined;
+        const finish = () => {
+            if (done)
+                return;
+            done = true;
+            if (quiet !== undefined)
+                clearTimeout(quiet);
+            clearTimeout(cap);
+            unsubscribe();
+            resolve(Math.max(0, Math.min(options.capMs, options.now() - started)));
+        };
+        const cap = setTimeout(() => {
+            if (!done)
+                options.onCap?.();
+            finish();
+        }, options.capMs);
+        const restart = () => {
+            if (done)
+                return;
+            if (quiet !== undefined)
+                clearTimeout(quiet);
+            quiet = setTimeout(finish, options.quietMs);
+        };
+        unsubscribe = options.onCommit(restart);
+        restart();
+    });
+}
+/**
+ * After the commits stop, a native-driver animation (a sheet sliding up) can still be moving.
+ * Polls `measure` every `pollMs` and resolves with the milliseconds waited once two readings in a
+ * row agree within 1 pt in x and y, or at `capMs`. A null reading (can't be measured) ends the wait.
+ */
+async function waitUntilSteady(measure, options) {
+    const started = options.now();
+    const elapsed = () => Math.max(0, Math.min(options.capMs, options.now() - started));
+    if (options.capMs <= 0)
+        return 0;
+    let previous = await measure();
+    if (previous === null)
+        return 0;
+    for (;;) {
+        const left = options.capMs - (options.now() - started);
+        if (left <= 0) {
+            options.onCap?.();
+            return elapsed();
+        }
+        await new Promise((resolve) => setTimeout(resolve, Math.min(options.pollMs, left)));
+        const next = await measure();
+        if (next === null)
+            return elapsed();
+        if (Math.abs(next.x - previous.x) <= 1 && Math.abs(next.y - previous.y) <= 1)
+            return elapsed();
+        previous = next;
+    }
+}
+//# sourceMappingURL=settle.js.map

package/dist/settle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settle.js","sourceRoot":"","sources":["../src/settle.ts"],"names":[],"mappings":";;AAKA,wCAiCC;AAOD,0CAqBC;AAlED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,OAO9B;IACC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,IAAI,KAAgD,CAAC;QACrD,IAAI,WAAW,GAAe,GAAG,EAAE,CAAC,SAAS,CAAC;QAC9C,MAAM,MAAM,GAAG,GAAS,EAAE;YACxB,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,IAAI,KAAK,KAAK,SAAS;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC7C,YAAY,CAAC,GAAG,CAAC,CAAC;YAClB,WAAW,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACzE,CAAC,CAAC;QACF,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,EAAE;YAC1B,IAAI,CAAC,IAAI;gBAAE,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YAC7B,MAAM,EAAE,CAAC;QACX,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAClB,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,KAAK,KAAK,SAAS;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC7C,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC,CAAC;QACF,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,eAAe,CACnC,OAAuD,EACvD,OAAiF;IAEjF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC;IAC5F,IAAI,OAAO,CAAC,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACjC,IAAI,QAAQ,GAAG,MAAM,OAAO,EAAE,CAAC;IAC/B,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAChC,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;QACvD,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACd,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;YAClB,OAAO,OAAO,EAAE,CAAC;QACnB,CAAC;QACD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1F,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;QAC7B,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,OAAO,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;YAAE,OAAO,OAAO,EAAE,CAAC;QAC/F,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/source.d.ts

@@ -0,0 +1,60 @@
+import { type Fiber } from './fiber';
+/**
+ * Source locations (Tapline 1.1, development builds): which component draws an element and which line of
+ * the app's code wrote it. React 19 keeps, on every fiber, the stack captured where its JSX element was
+ * created (`_debugStack`). The frames point into the bundle Metro serves; Metro's own `/symbolicate`
+ * turns them back into the app's files and lines. The first frame outside node_modules is the line that
+ * wrote the element. Nothing here runs unless the agent asks.
+ */
+export interface SourceLocation {
+    /** The file as Metro reports it (absolute on the computer that serves the bundle). */
+    file: string;
+    line: number;
+    column: number;
+    /** The component whose render wrote the element, e.g. "SignUpScreen". */
+    component: string | null;
+    /** True when this is the element's own line; false when a library drew it and this is the app line around it. */
+    direct: boolean;
+}
+export interface ElementSource {
+    /** Components from the screen down to the element, app components first (at most 6). */
+    components: string[];
+    /** Where the app's code wrote this element (or its nearest ancestor the app wrote); null when unknown. */
+    location: SourceLocation | null;
+    /**
+     * When `location` is inside one of the app's own components (a shared button): where the screen uses that
+     * component, so a developer goes straight to the use as well as to the inside. Absent otherwise.
+     */
+    usedAt?: SourceLocation[];
+    /** The props of the component the app wrote, in short: strings, numbers, booleans, handler names. */
+    props: Record<string, string>;
+}
+interface Frame {
+    file: string;
+    lineNumber: number;
+    column: number;
+    methodName: string;
+}
+type FetchLike = (url: string, init: {
+    method: string;
+    headers: Record<string, string>;
+    body: string;
+}) => Promise<{
+    ok: boolean;
+    json(): Promise<unknown>;
+}>;
+/** Replace the HTTP client (tests); null restores the global fetch. */
+export declare function setSourceFetch(next: FetchLike | null): void;
+/** The stack React captured where this fiber's element was created, as frames; empty when there is none. */
+export declare function framesOf(fiber: Fiber): Frame[];
+/** A file of the app's own code (not a library, not React's internals). */
+export declare function isAppFile(file: string): boolean;
+/**
+ * Where the app wrote these elements. One request to Metro for all of them. `fibers` are the host fibers
+ * of the elements; for one written inside a library component (a TextInput's native view), the nearest
+ * ancestor the app's code wrote is used.
+ */
+export declare function sourcesOf(fibers: Fiber[]): Promise<ElementSource[]>;
+/** Forget mapped positions (after a reload the bundle's lines change; tests). */
+export declare function clearSourceCache(): void;
+export {};

package/dist/source.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setSourceFetch = setSourceFetch;
+exports.framesOf = framesOf;
+exports.isAppFile = isAppFile;
+exports.sourcesOf = sourcesOf;
+exports.clearSourceCache = clearSourceCache;
+const fiber_1 = require("./fiber");
+const types_1 = require("./types");
+let fetcher = null;
+/** Replace the HTTP client (tests); null restores the global fetch. */
+function setSourceFetch(next) {
+    fetcher = next;
+}
+function http() {
+    if (fetcher)
+        return fetcher;
+    const global = globalThis.fetch;
+    return typeof global === 'function' ? global : null;
+}
+/** The stack React captured where this fiber's element was created, as frames; empty when there is none. */
+function framesOf(fiber) {
+    const stack = fiber._debugStack;
+    const text = (0, types_1.isRecord)(stack) && typeof stack.stack === 'string' ? stack.stack : typeof stack === 'string' ? stack : '';
+    const frames = [];
+    for (const line of text.split('\n')) {
+        // Hermes and V8: "at name (url:line:col)" or "at url:line:col"
+        const m = /^\s*at\s+(?:(.*?)\s+\()?(.+?):(\d+):(\d+)\)?\s*$/.exec(line);
+        if (!m)
+            continue;
+        const file = m[2].replace(/^address at\s+/, '');
+        frames.push({ methodName: m[1] ?? '', file, lineNumber: Number(m[3]), column: Number(m[4]) });
+    }
+    return frames;
+}
+/** Metro's address, from a bundle URL in a frame: "http://192.168.1.20:8081". */
+function metroOrigin(frames) {
+    for (const frame of frames) {
+        const m = /^(https?:\/\/[^/]+)\//.exec(frame.file);
+        if (m)
+            return m[1];
+    }
+    return null;
+}
+const cache = new Map();
+const keyOf = (f) => `${f.file}:${f.lineNumber}:${f.column}`;
+/** Asks Metro for the original positions of these frames; frames it can't map come back null. */
+async function symbolicate(frames) {
+    const missing = frames.filter((f) => !cache.has(keyOf(f)));
+    const origin = metroOrigin(missing);
+    const client = http();
+    if (missing.length > 0 && origin && client) {
+        try {
+            const res = await client(`${origin}/symbolicate`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ stack: missing }),
+            });
+            const body = res.ok ? await res.json() : null;
+            const out = (0, types_1.isRecord)(body) && Array.isArray(body.stack) ? body.stack : [];
+            missing.forEach((frame, i) => {
+                const mapped = out[i];
+                cache.set(keyOf(frame), (0, types_1.isRecord)(mapped) && typeof mapped.file === 'string' && typeof mapped.lineNumber === 'number'
+                    ? {
+                        file: mapped.file,
+                        lineNumber: mapped.lineNumber,
+                        column: typeof mapped.column === 'number' ? mapped.column : 0,
+                        methodName: typeof mapped.methodName === 'string' ? mapped.methodName : '',
+                    }
+                    : null);
+            });
+        }
+        catch {
+            // Metro unreachable: no locations this time; try again next call.
+            return frames.map(() => null);
+        }
+    }
+    return frames.map((f) => cache.get(keyOf(f)) ?? null);
+}
+/** A file of the app's own code (not a library, not React's internals). */
+function isAppFile(file) {
+    return !/[\\/]node_modules[\\/]/.test(file) && !/^https?:/.test(file) && !/^\[native code\]$/.test(file);
+}
+const INTERNAL = /^(View|Text|RCT|Animated|Virtualized|ScrollView|Pressable|TouchableOpacity|TouchableHighlight|TouchableWithoutFeedback|TextInput|Image|Context|Provider|Consumer|Fragment)/;
+/** The composite components above a fiber, nearest first. */
+function compositesAbove(fiber, limit) {
+    const out = [];
+    for (let f = fiber; f && out.length < limit; f = f.return) {
+        if ((0, fiber_1.isCompositeTag)(f.tag))
+            out.push(f);
+    }
+    return out;
+}
+function shortProps(fiber) {
+    const out = {};
+    for (const [key, value] of Object.entries((0, fiber_1.propsOf)(fiber))) {
+        if (key === 'children' || key === 'style' || Object.keys(out).length >= 8)
+            continue;
+        if (typeof value === 'string')
+            out[key] = JSON.stringify(value.length > 40 ? `${value.slice(0, 40)}…` : value);
+        else if (typeof value === 'number' || typeof value === 'boolean')
+            out[key] = String(value);
+        else if (typeof value === 'function')
+            out[key] = `${value.name || 'function'}()`;
+    }
+    return out;
+}
+/**
+ * Whether the component the app wrote is the element itself, wrapped: it was given the element's own
+ * testID, accessibility label or text (a Pressable, a TextInput, a Text). A tab bar button gets its testID
+ * from the navigator's options instead, so the navigator's line is only the line around it.
+ */
+function sameIdentity(host, wrote) {
+    const own = (0, fiber_1.propsOf)(host);
+    const given = (0, fiber_1.propsOf)(wrote);
+    for (const key of ['testID', 'nativeID', 'accessibilityLabel', 'aria-label']) {
+        const value = own[key];
+        if (typeof value === 'string' && value !== '' && given[key] === value)
+            return true;
+    }
+    return typeof own.children === 'string' && own.children !== '' && given.children === own.children;
+}
+/**
+ * Where the app wrote these elements. One request to Metro for all of them. `fibers` are the host fibers
+ * of the elements; for one written inside a library component (a TextInput's native view), the nearest
+ * ancestor the app's code wrote is used.
+ */
+async function sourcesOf(fibers) {
+    // For each element: the fibers to try, nearest first (the host fiber, then the composites above it, up to
+    // the screen). An element a library drew (a tab bar button) maps to the app line that set the library up.
+    const chains = fibers.map((fiber) => [fiber, ...compositesAbove(fiber.return ?? fiber, 60)]);
+    const allFrames = [];
+    const spans = chains.map((chain) => chain.map((f) => {
+        const frames = framesOf(f).slice(0, 4);
+        const start = allFrames.length;
+        allFrames.push(...frames);
+        return { fiber: f, start, count: frames.length };
+    }));
+    const mapped = await symbolicate(allFrames);
+    /** The first frame of the app's own code in a fiber's stack: the app line that created that fiber's element. */
+    const appFrame = (span) => {
+        for (let k = span.start; k < span.start + span.count; k++) {
+            const frame = mapped[k];
+            if (frame && isAppFile(frame.file))
+                return frame;
+        }
+        return null;
+    };
+    return fibers.map((fiber, i) => {
+        let location = null;
+        let wrote = null;
+        // The app's own components, nearest first: the ones whose render wrote an element on this path.
+        const names = [];
+        for (const [n, span] of spans[i].entries()) {
+            const frame = appFrame(span);
+            if (frame === null)
+                continue;
+            if (frame.methodName !== '' && !INTERNAL.test(frame.methodName))
+                names.push(frame.methodName);
+            if (location === null) {
+                location = {
+                    file: frame.file,
+                    line: frame.lineNumber,
+                    column: frame.column,
+                    component: frame.methodName || null,
+                    // the element's own line, or (a library drew it) the app line around it
+                    direct: n <= 1 || sameIdentity(fiber, span.fiber),
+                };
+                wrote = span.fiber;
+            }
+            else if (location.direct && wrote !== null && sameIdentity(fiber, span.fiber)) {
+                // The app's own wrapper component got the same identity from further up (a shared <Button testID>
+                // used on a screen): the line that wrote the value is that call site, not the wrapper's inside.
+                location = { file: frame.file, line: frame.lineNumber, column: frame.column, component: frame.methodName || null, direct: true };
+                wrote = span.fiber;
+            }
+        }
+        const components = [...new Set(names)].slice(0, 6).reverse();
+        const propsFrom = wrote && (0, fiber_1.isCompositeTag)(wrote.tag) ? wrote : compositesAbove(fiber, 1)[0] ?? null;
+        // Inside an app component (LabButton): the first app line further up written by another component is
+        // where that component is used (<LabButton …> in LabScreen).
+        // Up to four call sites further up, nearest first: a shared component may sit inside another one
+        // (PressButton › LabButton), and the host picks the line that names the element.
+        const usedAt = [];
+        const chosen = location;
+        if (chosen !== null && chosen.direct && chosen.component !== null) {
+            let past = false;
+            let last = chosen.component;
+            for (const span of spans[i]) {
+                if (span.fiber === wrote) {
+                    past = true;
+                    continue;
+                }
+                if (!past)
+                    continue;
+                const frame = appFrame(span);
+                if (frame === null || frame.methodName === '' || INTERNAL.test(frame.methodName))
+                    continue;
+                if (frame.methodName === last)
+                    continue;
+                usedAt.push({ file: frame.file, line: frame.lineNumber, column: frame.column, component: frame.methodName, direct: true });
+                last = frame.methodName;
+                if (usedAt.length >= 4)
+                    break;
+            }
+        }
+        return { components, location, ...(usedAt.length > 0 ? { usedAt } : {}), props: propsFrom ? shortProps(propsFrom) : {} };
+    });
+}
+/** Forget mapped positions (after a reload the bundle's lines change; tests). */
+function clearSourceCache() {
+    cache.clear();
+}
+//# sourceMappingURL=source.js.map

package/dist/source.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,10 @@
+/** Where Tapline remembers the paired computer and this install's id. */
+export interface TaplineStorage {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+}
+/** expo-secure-store when the app has it (keychain on iOS), else null. */
+export declare function secureStoreStorage(): TaplineStorage | null;
+/** Kept only while the app runs. */
+export declare function memoryStorage(): TaplineStorage;

package/dist/storage.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.secureStoreStorage = secureStoreStorage;
+exports.memoryStorage = memoryStorage;
+const types_1 = require("./types");
+function isSecureStore(value) {
+    return ((0, types_1.isRecord)(value) &&
+        typeof value.getItemAsync === 'function' &&
+        typeof value.setItemAsync === 'function' &&
+        typeof value.deleteItemAsync === 'function');
+}
+/** expo-secure-store when the app has it (keychain on iOS), else null. */
+function secureStoreStorage() {
+    let loaded;
+    try {
+        loaded = require('expo-secure-store');
+    }
+    catch {
+        return null;
+    }
+    const store = (0, types_1.isRecord)(loaded) && isSecureStore(loaded.default) ? loaded.default : loaded;
+    if (!isSecureStore(store))
+        return null;
+    return {
+        getItem: (key) => store.getItemAsync(key),
+        setItem: (key, value) => store.setItemAsync(key, value),
+        removeItem: (key) => store.deleteItemAsync(key),
+    };
+}
+/** Kept only while the app runs. */
+function memoryStorage() {
+    const items = new Map();
+    return {
+        getItem: (key) => Promise.resolve(items.get(key) ?? null),
+        setItem: (key, value) => {
+            items.set(key, value);
+            return Promise.resolve();
+        },
+        removeItem: (key) => {
+            items.delete(key);
+            return Promise.resolve();
+        },
+    };
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":";;AAyBA,gDAcC;AAGD,sCAaC;AAvDD,mCAAmC;AAenC,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,IAAA,gBAAQ,EAAC,KAAK,CAAC;QACf,OAAO,KAAK,CAAC,YAAY,KAAK,UAAU;QACxC,OAAO,KAAK,CAAC,YAAY,KAAK,UAAU;QACxC,OAAO,KAAK,CAAC,eAAe,KAAK,UAAU,CAC5C,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,SAAgB,kBAAkB;IAChC,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,IAAA,gBAAQ,EAAC,MAAM,CAAC,IAAI,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1F,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,CAAC;QACzC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC;QACvD,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,SAAgB,aAAa;IAC3B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QACzD,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACtB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QACD,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE;YAClB,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAClB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC"}