react-native-mcp-kit 4.1.0 → 4.2.1

package/dist/modules/fiberTree/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/constants.ts"],"names":[],"mappings":";AAAA,mFAAmF;AACnF,+EAA+E;AAC/E,+EAA+E;AAC/E,gCAAgC;;;AAEnB,QAAA,cAAc,GAAG,CAAC,CAAC;AACnB,QAAA,SAAS,GAAG,CAAC,CAAC;AACd,QAAA,kBAAkB,GAAG,CAAC,CAAC;AACvB,QAAA,eAAe,GAAG,CAAC,CAAC;AACpB,QAAA,WAAW,GAAG,EAAE,CAAC;AACjB,QAAA,IAAI,GAAG,EAAE,CAAC;AACV,QAAA,WAAW,GAAG,EAAE,CAAC"}

package/dist/modules/fiberTree/utils/index.d.ts

@@ -0,0 +1,9 @@
+export { findAllByQuery, matchesQuery } from './match';
+export { getComponentName, getComponentType } from './naming';
+export { getAvailableMethods, getNativeInstance, measureFiber } from './native';
+export { projectFiberValue } from './projection';
+export { getFiberRoot, setRootRef } from './root';
+export { findScreenFiberByRouteKey } from './screen';
+export { serializeFiber } from './serialize';
+export { findAllFibers, findByMcpId, findByName, findByTestID, findByText, findFiber, findHostFiber, getAncestors, getDirectChildren, getSiblings, } from './traverse';
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/fiberTree/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,WAAW,EACX,UAAU,EACV,YAAY,EACZ,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/modules/fiberTree/utils/index.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSiblings = exports.getDirectChildren = exports.getAncestors = exports.findHostFiber = exports.findFiber = exports.findByText = exports.findByTestID = exports.findByName = exports.findByMcpId = exports.findAllFibers = exports.serializeFiber = exports.findScreenFiberByRouteKey = exports.setRootRef = exports.getFiberRoot = exports.projectFiberValue = exports.measureFiber = exports.getNativeInstance = exports.getAvailableMethods = exports.getComponentType = exports.getComponentName = exports.matchesQuery = exports.findAllByQuery = void 0;
+var match_1 = require("./match");
+Object.defineProperty(exports, "findAllByQuery", { enumerable: true, get: function () { return match_1.findAllByQuery; } });
+Object.defineProperty(exports, "matchesQuery", { enumerable: true, get: function () { return match_1.matchesQuery; } });
+var naming_1 = require("./naming");
+Object.defineProperty(exports, "getComponentName", { enumerable: true, get: function () { return naming_1.getComponentName; } });
+Object.defineProperty(exports, "getComponentType", { enumerable: true, get: function () { return naming_1.getComponentType; } });
+var native_1 = require("./native");
+Object.defineProperty(exports, "getAvailableMethods", { enumerable: true, get: function () { return native_1.getAvailableMethods; } });
+Object.defineProperty(exports, "getNativeInstance", { enumerable: true, get: function () { return native_1.getNativeInstance; } });
+Object.defineProperty(exports, "measureFiber", { enumerable: true, get: function () { return native_1.measureFiber; } });
+var projection_1 = require("./projection");
+Object.defineProperty(exports, "projectFiberValue", { enumerable: true, get: function () { return projection_1.projectFiberValue; } });
+var root_1 = require("./root");
+Object.defineProperty(exports, "getFiberRoot", { enumerable: true, get: function () { return root_1.getFiberRoot; } });
+Object.defineProperty(exports, "setRootRef", { enumerable: true, get: function () { return root_1.setRootRef; } });
+var screen_1 = require("./screen");
+Object.defineProperty(exports, "findScreenFiberByRouteKey", { enumerable: true, get: function () { return screen_1.findScreenFiberByRouteKey; } });
+var serialize_1 = require("./serialize");
+Object.defineProperty(exports, "serializeFiber", { enumerable: true, get: function () { return serialize_1.serializeFiber; } });
+var traverse_1 = require("./traverse");
+Object.defineProperty(exports, "findAllFibers", { enumerable: true, get: function () { return traverse_1.findAllFibers; } });
+Object.defineProperty(exports, "findByMcpId", { enumerable: true, get: function () { return traverse_1.findByMcpId; } });
+Object.defineProperty(exports, "findByName", { enumerable: true, get: function () { return traverse_1.findByName; } });
+Object.defineProperty(exports, "findByTestID", { enumerable: true, get: function () { return traverse_1.findByTestID; } });
+Object.defineProperty(exports, "findByText", { enumerable: true, get: function () { return traverse_1.findByText; } });
+Object.defineProperty(exports, "findFiber", { enumerable: true, get: function () { return traverse_1.findFiber; } });
+Object.defineProperty(exports, "findHostFiber", { enumerable: true, get: function () { return traverse_1.findHostFiber; } });
+Object.defineProperty(exports, "getAncestors", { enumerable: true, get: function () { return traverse_1.getAncestors; } });
+Object.defineProperty(exports, "getDirectChildren", { enumerable: true, get: function () { return traverse_1.getDirectChildren; } });
+Object.defineProperty(exports, "getSiblings", { enumerable: true, get: function () { return traverse_1.getSiblings; } });
+//# sourceMappingURL=index.js.map

package/dist/modules/fiberTree/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/index.ts"],"names":[],"mappings":";;;AAAA,iCAAuD;AAA9C,uGAAA,cAAc,OAAA;AAAE,qGAAA,YAAY,OAAA;AACrC,mCAA8D;AAArD,0GAAA,gBAAgB,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAC3C,mCAAgF;AAAvE,6GAAA,mBAAmB,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,sGAAA,YAAY,OAAA;AAC7D,2CAAiD;AAAxC,+GAAA,iBAAiB,OAAA;AAC1B,+BAAkD;AAAzC,oGAAA,YAAY,OAAA;AAAE,kGAAA,UAAU,OAAA;AACjC,mCAAqD;AAA5C,mHAAA,yBAAyB,OAAA;AAClC,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AACvB,uCAWoB;AAVlB,yGAAA,aAAa,OAAA;AACb,uGAAA,WAAW,OAAA;AACX,sGAAA,UAAU,OAAA;AACV,wGAAA,YAAY,OAAA;AACZ,sGAAA,UAAU,OAAA;AACV,qGAAA,SAAS,OAAA;AACT,yGAAA,aAAa,OAAA;AACb,wGAAA,YAAY,OAAA;AACZ,6GAAA,iBAAiB,OAAA;AACjB,uGAAA,WAAW,OAAA"}

package/dist/modules/fiberTree/utils/match.d.ts

@@ -0,0 +1,4 @@
+import { type ComponentQuery, type Fiber } from '../../../modules/fiberTree/types';
+export declare const matchesQuery: (fiber: Fiber, query: ComponentQuery) => boolean;
+export declare const findAllByQuery: (root: Fiber, query: ComponentQuery) => Fiber[];
+//# sourceMappingURL=match.d.ts.map

package/dist/modules/fiberTree/utils/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/match.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,KAAK,EAAoB,MAAM,2BAA2B,CAAC;AAgG9F,eAAO,MAAM,YAAY,UAAW,KAAK,SAAS,cAAc,KAAG,OA8DlE,CAAC;AAEF,eAAO,MAAM,cAAc,SAAU,KAAK,SAAS,cAAc,KAAG,KAAK,EAIxE,CAAC"}

package/dist/modules/fiberTree/utils/match.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findAllByQuery = exports.matchesQuery = void 0;
+const naming_1 = require("./naming");
+const serialize_1 = require("./serialize");
+const traverse_1 = require("./traverse");
+// Cap for object/array serialization used by contains/regex matchers.
+// Large fiber props (e.g. deep Redux state, Reanimated shared values) would
+// otherwise turn into megabyte-strings per fiber.
+const MATCH_STRING_CAP = 10_000;
+/**
+ * Turn any prop value into a string usable by `contains` / `regex` matchers.
+ * - Primitives and functions/symbols go through String(), preserving the
+ *   "substring on text props" intuition (e.g. placeholder = "Search" stays
+ *   "Search", not '"Search"').
+ * - Objects and arrays are JSON-serialized with circular refs replaced, so a
+ *   regex like `"title":"Hello"` or `\\bonPress\\b` can still land. Functions
+ *   and symbols become placeholders; bigint becomes its decimal string.
+ * - Output is capped at MATCH_STRING_CAP characters to keep response costs
+ *   bounded on large prop graphs.
+ */
+const stringifyForMatching = (value) => {
+    if (value === null || value === undefined)
+        return String(value);
+    const type = typeof value;
+    if (type !== 'object')
+        return String(value);
+    try {
+        const seen = new WeakSet();
+        const serialized = JSON.stringify(value, (_key, v) => {
+            if (v && typeof v === 'object') {
+                if (seen.has(v))
+                    return '[Circular]';
+                seen.add(v);
+            }
+            if (typeof v === 'function')
+                return '[Function]';
+            if (typeof v === 'symbol')
+                return v.toString();
+            if (typeof v === 'bigint')
+                return v.toString();
+            return v;
+        });
+        if (typeof serialized !== 'string')
+            return String(value);
+        return serialized.length > MATCH_STRING_CAP
+            ? serialized.slice(0, MATCH_STRING_CAP)
+            : serialized;
+    }
+    catch {
+        return String(value);
+    }
+};
+const matchPropValue = (actual, matcher) => {
+    if (matcher !== null && typeof matcher === 'object') {
+        if (actual === undefined || actual === null)
+            return false;
+        const isPrimitive = typeof actual !== 'object';
+        const deep = matcher.deep === true;
+        // Non-primitive values only participate when the caller opts in with
+        // `deep: true`. This keeps naive placeholder/testID matchers from
+        // accidentally hitting stringified objects.
+        if (!isPrimitive && !deep)
+            return false;
+        const asString = isPrimitive ? String(actual) : stringifyForMatching(actual);
+        if ('contains' in matcher && typeof matcher.contains === 'string') {
+            return asString.includes(matcher.contains);
+        }
+        if ('regex' in matcher && typeof matcher.regex === 'string') {
+            try {
+                return new RegExp(matcher.regex).test(asString);
+            }
+            catch {
+                return false;
+            }
+        }
+        return false;
+    }
+    return actual === matcher;
+};
+// Match a string criterion against an actual value with `/regex/flags`-aware
+// semantics. Matches step-level `name` / `mcpId` / `testID` against
+// strict equality OR a slash-delimited regex; `text` against substring OR
+// regex. Mirrors the syntax used by `select.hooks.names` / `mcpIds` so the
+// agent has one consistent rule across the tool.
+const matchStringCriterion = (actual, pattern, mode) => {
+    if (actual === undefined)
+        return false;
+    const re = pattern.match(/^\/(.+)\/([gimsuy]*)$/);
+    if (re && re[1] !== undefined) {
+        try {
+            return new RegExp(re[1], re[2] ?? '').test(actual);
+        }
+        catch {
+            // Malformed regex — fall through to literal comparison so users get
+            // exact-equality semantics rather than silent no-match.
+        }
+    }
+    return mode === 'equals' ? actual === pattern : actual.includes(pattern);
+};
+const matchesQuery = (fiber, query) => {
+    try {
+        if (query.mcpId &&
+            !matchStringCriterion(fiber.memoizedProps?.['data-mcp-id'], query.mcpId, 'equals')) {
+            return false;
+        }
+        if (query.testID &&
+            !matchStringCriterion(fiber.memoizedProps?.testID, query.testID, 'equals')) {
+            return false;
+        }
+        if (query.name && !matchStringCriterion((0, naming_1.getComponentName)(fiber), query.name, 'equals')) {
+            return false;
+        }
+        if (query.text) {
+            const content = (0, serialize_1.getTextContent)(fiber);
+            if (!matchStringCriterion(content ?? undefined, query.text, 'includes'))
+                return false;
+        }
+        if (query.hasProps && Array.isArray(query.hasProps)) {
+            const props = fiber.memoizedProps;
+            if (!props || typeof props !== 'object')
+                return false;
+            for (const prop of query.hasProps) {
+                if (!(prop in props))
+                    return false;
+            }
+        }
+        if (query.props && typeof query.props === 'object') {
+            const props = fiber.memoizedProps;
+            if (!props || typeof props !== 'object')
+                return false;
+            for (const key of Object.keys(query.props)) {
+                if (!matchPropValue(props[key], query.props[key]))
+                    return false;
+            }
+        }
+        if (Array.isArray(query.any) && query.any.length > 0) {
+            const anyMatched = query.any.some((sub) => {
+                return (0, exports.matchesQuery)(fiber, sub);
+            });
+            if (!anyMatched)
+                return false;
+        }
+        if (query.not) {
+            if (Array.isArray(query.not)) {
+                for (const sub of query.not) {
+                    if ((0, exports.matchesQuery)(fiber, sub))
+                        return false;
+                }
+            }
+            else if (typeof query.not === 'object') {
+                if ((0, exports.matchesQuery)(fiber, query.not))
+                    return false;
+            }
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+exports.matchesQuery = matchesQuery;
+const findAllByQuery = (root, query) => {
+    return (0, traverse_1.findAllFibers)(root, (fiber) => {
+        return (0, exports.matchesQuery)(fiber, query);
+    });
+};
+exports.findAllByQuery = findAllByQuery;
+//# sourceMappingURL=match.js.map

package/dist/modules/fiberTree/utils/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/match.ts"],"names":[],"mappings":";;;AAEA,qCAA4C;AAC5C,2CAA6C;AAC7C,yCAA2C;AAE3C,sEAAsE;AACtE,4EAA4E;AAC5E,kDAAkD;AAClD,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAU,EAAE;IACtD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC;IAC1B,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;QACnC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACnD,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBAAE,OAAO,YAAY,CAAC;gBACrC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACd,CAAC;YACD,IAAI,OAAO,CAAC,KAAK,UAAU;gBAAE,OAAO,YAAY,CAAC;YACjD,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC/C,IAAI,OAAO,CAAC,KAAK,QAAQ;gBAAE,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC/C,OAAO,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QACH,IAAI,OAAO,UAAU,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO,UAAU,CAAC,MAAM,GAAG,gBAAgB;YACzC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC;YACvC,CAAC,CAAC,UAAU,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,MAAe,EAAE,OAAoB,EAAW,EAAE;IACxE,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACpD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QAC1D,MAAM,WAAW,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC;QAC/C,MAAM,IAAI,GAAI,OAA8B,CAAC,IAAI,KAAK,IAAI,CAAC;QAC3D,qEAAqE;QACrE,kEAAkE;QAClE,4CAA4C;QAC5C,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACxC,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC7E,IAAI,UAAU,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAClE,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC5D,IAAI,CAAC;gBACH,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,KAAK,OAAO,CAAC;AAC5B,CAAC,CAAC;AAEF,6EAA6E;AAC7E,oEAAoE;AACpE,0EAA0E;AAC1E,2EAA2E;AAC3E,iDAAiD;AACjD,MAAM,oBAAoB,GAAG,CAC3B,MAA0B,EAC1B,OAAe,EACf,IAA2B,EAClB,EAAE;IACX,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAClD,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,OAAO,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,wDAAwD;QAC1D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3E,CAAC,CAAC;AAEK,MAAM,YAAY,GAAG,CAAC,KAAY,EAAE,KAAqB,EAAW,EAAE;IAC3E,IAAI,CAAC;QACH,IACE,KAAK,CAAC,KAAK;YACX,CAAC,oBAAoB,CACnB,KAAK,CAAC,aAAa,EAAE,CAAC,aAAa,CAAuB,EAC1D,KAAK,CAAC,KAAK,EACX,QAAQ,CACT,EACD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IACE,KAAK,CAAC,MAAM;YACZ,CAAC,oBAAoB,CACnB,KAAK,CAAC,aAAa,EAAE,MAA4B,EACjD,KAAK,CAAC,MAAM,EACZ,QAAQ,CACT,EACD,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,oBAAoB,CAAC,IAAA,yBAAgB,EAAC,KAAK,CAAC,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;YACvF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,IAAA,0BAAc,EAAC,KAAK,CAAC,CAAC;YACtC,IAAI,CAAC,oBAAoB,CAAC,OAAO,IAAI,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;gBAAE,OAAO,KAAK,CAAC;QACxF,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpD,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC;YAClC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACtD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAClC,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC;oBAAE,OAAO,KAAK,CAAC;YACrC,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACnD,MAAM,KAAK,GAAG,KAAK,CAAC,aAAa,CAAC;YAClC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YACtD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAE,CAAC;oBAAE,OAAO,KAAK,CAAC;YACnE,CAAC;QACH,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;gBACxC,OAAO,IAAA,oBAAY,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,UAAU;gBAAE,OAAO,KAAK,CAAC;QAChC,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;oBAC5B,IAAI,IAAA,oBAAY,EAAC,KAAK,EAAE,GAAG,CAAC;wBAAE,OAAO,KAAK,CAAC;gBAC7C,CAAC;YACH,CAAC;iBAAM,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACzC,IAAI,IAAA,oBAAY,EAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC;oBAAE,OAAO,KAAK,CAAC;YACnD,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AA9DW,QAAA,YAAY,gBA8DvB;AAEK,MAAM,cAAc,GAAG,CAAC,IAAW,EAAE,KAAqB,EAAW,EAAE;IAC5E,OAAO,IAAA,wBAAa,EAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;QACnC,OAAO,IAAA,oBAAY,EAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAJW,QAAA,cAAc,kBAIzB"}

package/dist/modules/fiberTree/utils/naming.d.ts

@@ -0,0 +1,4 @@
+import { type ComponentType, type Fiber } from '../../../modules/fiberTree/types';
+export declare const getComponentName: (fiber: Fiber) => string;
+export declare const getComponentType: (fiber: Fiber) => ComponentType;
+//# sourceMappingURL=naming.d.ts.map

package/dist/modules/fiberTree/utils/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/naming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAY3E,eAAO,MAAM,gBAAgB,UAAW,KAAK,KAAG,MAqC/C,CAAC;AAEF,eAAO,MAAM,gBAAgB,UAAW,KAAK,KAAG,aAa/C,CAAC"}

package/dist/modules/fiberTree/utils/naming.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getComponentType = exports.getComponentName = void 0;
+const constants_1 = require("./constants");
+const getComponentName = (fiber) => {
+    // Host root has no `type` and no `return` parent. Surface it as
+    // "FiberRoot" instead of "Unknown" so dumps via scope:'root' read
+    // sensibly (and the name doesn't collide with a real component).
+    if (!fiber.type) {
+        if (!fiber.return)
+            return 'FiberRoot';
+        return 'Unknown';
+    }
+    if (typeof fiber.type === 'string') {
+        return fiber.type;
+    }
+    if (typeof fiber.type === 'function') {
+        return fiber.type.displayName || fiber.type.name || 'Anonymous';
+    }
+    if (typeof fiber.type === 'object') {
+        // ForwardRef
+        if (fiber.type.render) {
+            return (fiber.type.displayName ||
+                fiber.type.render.displayName ||
+                fiber.type.render.name ||
+                'ForwardRef');
+        }
+        // Memo
+        if (fiber.type.type) {
+            return (fiber.type.displayName || fiber.type.type.displayName || fiber.type.type.name || 'Memo');
+        }
+        return fiber.type.displayName || 'Unknown';
+    }
+    return 'Unknown';
+};
+exports.getComponentName = getComponentName;
+const getComponentType = (fiber) => {
+    if (fiber.tag === constants_1.HOST_TEXT)
+        return 'text';
+    if (fiber.tag === constants_1.HOST_COMPONENT)
+        return 'host';
+    if (fiber.tag === constants_1.FUNCTION_COMPONENT ||
+        fiber.tag === constants_1.CLASS_COMPONENT ||
+        fiber.tag === constants_1.FORWARD_REF ||
+        fiber.tag === constants_1.MEMO ||
+        fiber.tag === constants_1.SIMPLE_MEMO) {
+        return 'composite';
+    }
+    return 'other';
+};
+exports.getComponentType = getComponentType;
+//# sourceMappingURL=naming.js.map

package/dist/modules/fiberTree/utils/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/naming.ts"],"names":[],"mappings":";;;AAEA,2CAQqB;AAEd,MAAM,gBAAgB,GAAG,CAAC,KAAY,EAAU,EAAE;IACvD,gEAAgE;IAChE,kEAAkE;IAClE,iEAAiE;IACjE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,WAAW,CAAC;QACtC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,CAAC;IAClE,CAAC;IAED,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACnC,aAAa;QACb,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,CACL,KAAK,CAAC,IAAI,CAAC,WAAW;gBACtB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;gBAC7B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI;gBACtB,YAAY,CACb,CAAC;QACJ,CAAC;QACD,OAAO;QACP,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO,CACL,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,MAAM,CACxF,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,SAAS,CAAC;IAC7C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AArCW,QAAA,gBAAgB,oBAqC3B;AAEK,MAAM,gBAAgB,GAAG,CAAC,KAAY,EAAiB,EAAE;IAC9D,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAS;QAAE,OAAO,MAAM,CAAC;IAC3C,IAAI,KAAK,CAAC,GAAG,KAAK,0BAAc;QAAE,OAAO,MAAM,CAAC;IAChD,IACE,KAAK,CAAC,GAAG,KAAK,8BAAkB;QAChC,KAAK,CAAC,GAAG,KAAK,2BAAe;QAC7B,KAAK,CAAC,GAAG,KAAK,uBAAW;QACzB,KAAK,CAAC,GAAG,KAAK,gBAAI;QAClB,KAAK,CAAC,GAAG,KAAK,uBAAW,EACzB,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAbW,QAAA,gBAAgB,oBAa3B"}

package/dist/modules/fiberTree/utils/native.d.ts

@@ -0,0 +1,5 @@
+import { type Bounds, type Fiber } from '../../../modules/fiberTree/types';
+export declare const getNativeInstance: (fiber: Fiber) => unknown;
+export declare const measureFiber: (fiber: Fiber) => Promise<Bounds | null>;
+export declare const getAvailableMethods: (instance: unknown) => string[];
+//# sourceMappingURL=native.d.ts.map

package/dist/modules/fiberTree/utils/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/native.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAMpE,eAAO,MAAM,iBAAiB,UAAW,KAAK,KAAG,OAoBhD,CAAC;AAYF,eAAO,MAAM,YAAY,UAAiB,KAAK,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAgDtE,CAAC;AAEF,eAAO,MAAM,mBAAmB,aAAc,OAAO,KAAG,MAAM,EAiB7D,CAAC"}

package/dist/modules/fiberTree/utils/native.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAvailableMethods = exports.measureFiber = exports.getNativeInstance = void 0;
+const core_1 = require("../../../shared/rn/core");
+const traverse_1 = require("./traverse");
+// Get the native instance (stateNode) or ref from a fiber
+const getNativeInstance = (fiber) => {
+    // For host components, stateNode has the native instance
+    const hostFiber = (0, traverse_1.findHostFiber)(fiber);
+    if (hostFiber?.stateNode) {
+        // Fabric (new architecture): stateNode.canonical.publicInstance
+        const canonical = hostFiber.stateNode.canonical;
+        if (canonical?.publicInstance) {
+            return canonical.publicInstance;
+        }
+        // Old architecture: stateNode directly
+        return hostFiber.stateNode;
+    }
+    // Check for ref on the fiber
+    if (fiber.ref) {
+        if (typeof fiber.ref === 'function')
+            return null;
+        if (fiber.ref.current)
+            return fiber.ref.current;
+    }
+    return null;
+};
+exports.getNativeInstance = getNativeInstance;
+// Measure the on-screen rect of the host view backing a fiber, in PHYSICAL
+// pixels (top-left origin). Uses `UIManager.measure(node, cb)` which yields
+// `pageX/pageY` — coordinates relative to the React root view, mapped to
+// `View.getLocationOnScreen` on Android. This is what `adb shell input tap`
+// expects (and `xcrun simctl io ... tap` on iOS), unlike `measureInWindow`
+// whose origin is the visible window and shifts depending on translucent
+// status-bar / SafeArea insets.
+//
+// Returns null when the fiber has no mounted host view (unmounted, virtualized
+// off-screen, etc.) or when measure throws.
+const measureFiber = async (fiber) => {
+    const hostFiber = (0, traverse_1.findHostFiber)(fiber);
+    if (!hostFiber?.stateNode)
+        return null;
+    // Mirror the Fabric / old-arch fork from getNativeInstance.
+    const canonical = hostFiber.stateNode.canonical;
+    const instance = canonical?.publicInstance ?? hostFiber.stateNode;
+    if (!instance)
+        return null;
+    const RN = (0, core_1.getRN)();
+    const { PixelRatio, UIManager, findNodeHandle } = RN;
+    const handle = typeof findNodeHandle === 'function' ? findNodeHandle(instance) : null;
+    if (handle == null)
+        return null;
+    return new Promise((resolve) => {
+        try {
+            UIManager.measure(handle, (_x, _y, width, height, pageX, pageY) => {
+                if (!Number.isFinite(pageX) ||
+                    !Number.isFinite(pageY) ||
+                    !Number.isFinite(width) ||
+                    !Number.isFinite(height)) {
+                    resolve(null);
+                    return;
+                }
+                const ratio = PixelRatio.get();
+                const px = Math.round(pageX * ratio);
+                const py = Math.round(pageY * ratio);
+                const pw = Math.round(width * ratio);
+                const ph = Math.round(height * ratio);
+                resolve({
+                    centerX: Math.round(px + pw / 2),
+                    centerY: Math.round(py + ph / 2),
+                    height: ph,
+                    width: pw,
+                    x: px,
+                    y: py,
+                });
+            });
+        }
+        catch {
+            resolve(null);
+        }
+    });
+};
+exports.measureFiber = measureFiber;
+const getAvailableMethods = (instance) => {
+    if (!instance || typeof instance !== 'object')
+        return [];
+    const methods = [];
+    let proto = Object.getPrototypeOf(instance);
+    while (proto && proto !== Object.prototype) {
+        for (const key of Object.getOwnPropertyNames(proto)) {
+            if (key !== 'constructor' &&
+                typeof instance[key] === 'function') {
+                methods.push(key);
+            }
+        }
+        proto = Object.getPrototypeOf(proto);
+    }
+    return [...new Set(methods)].sort();
+};
+exports.getAvailableMethods = getAvailableMethods;
+//# sourceMappingURL=native.js.map

package/dist/modules/fiberTree/utils/native.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.js","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/native.ts"],"names":[],"mappings":";;;AACA,2CAAyC;AAEzC,yCAA2C;AAE3C,0DAA0D;AACnD,MAAM,iBAAiB,GAAG,CAAC,KAAY,EAAW,EAAE;IACzD,yDAAyD;IACzD,MAAM,SAAS,GAAG,IAAA,wBAAa,EAAC,KAAK,CAAC,CAAC;IACvC,IAAI,SAAS,EAAE,SAAS,EAAE,CAAC;QACzB,gEAAgE;QAChE,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC;QAChD,IAAI,SAAS,EAAE,cAAc,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC,cAAc,CAAC;QAClC,CAAC;QACD,uCAAuC;QACvC,OAAO,SAAS,CAAC,SAAS,CAAC;IAC7B,CAAC;IAED,6BAA6B;IAC7B,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QACjD,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC;IAClD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AApBW,QAAA,iBAAiB,qBAoB5B;AAEF,2EAA2E;AAC3E,4EAA4E;AAC5E,yEAAyE;AACzE,4EAA4E;AAC5E,2EAA2E;AAC3E,yEAAyE;AACzE,gCAAgC;AAChC,EAAE;AACF,+EAA+E;AAC/E,4CAA4C;AACrC,MAAM,YAAY,GAAG,KAAK,EAAE,KAAY,EAA0B,EAAE;IACzE,MAAM,SAAS,GAAG,IAAA,wBAAa,EAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,SAAS,EAAE,SAAS;QAAE,OAAO,IAAI,CAAC;IAEvC,4DAA4D;IAC5D,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC;IAChD,MAAM,QAAQ,GAAG,SAAS,EAAE,cAAc,IAAI,SAAS,CAAC,SAAS,CAAC;IAClE,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,EAAE,GAAG,IAAA,YAAK,GAAE,CAAC;IACnB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC;IACrD,MAAM,MAAM,GACV,OAAO,cAAc,KAAK,UAAU,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IAEhC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,CAAC;YACH,SAAS,CAAC,OAAO,CACf,MAAM,EACN,CAAC,EAAU,EAAE,EAAU,EAAE,KAAa,EAAE,MAAc,EAAE,KAAa,EAAE,KAAa,EAAE,EAAE;gBACtF,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACvB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACvB,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;oBACvB,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EACxB,CAAC;oBACD,OAAO,CAAC,IAAI,CAAC,CAAC;oBACd,OAAO;gBACT,CAAC;gBACD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC;gBAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;gBACrC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;gBACrC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;gBACrC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC;gBACtC,OAAO,CAAC;oBACN,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;oBAChC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;oBAChC,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,EAAE;oBACT,CAAC,EAAE,EAAE;oBACL,CAAC,EAAE,EAAE;iBACN,CAAC,CAAC;YACL,CAAC,CACF,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAhDW,QAAA,YAAY,gBAgDvB;AAEK,MAAM,mBAAmB,GAAG,CAAC,QAAiB,EAAY,EAAE;IACjE,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAEzD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,IACE,GAAG,KAAK,aAAa;gBACrB,OAAQ,QAAoC,CAAC,GAAG,CAAC,KAAK,UAAU,EAChE,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QACD,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtC,CAAC,CAAC;AAjBW,QAAA,mBAAmB,uBAiB9B"}

package/dist/modules/fiberTree/utils/projection.d.ts

@@ -0,0 +1,9 @@
+import { type ProjectOptions } from '../../../shared/projection/projectValue';
+/**
+ * Projection helper used everywhere fiber values are serialised (props, hook
+ * values, fiber refs). Pre-applies the fiber-aware collapse rule + skip list
+ * over the shared `projectValue`. Callers can pass `path` / `depth` / etc.
+ * through `options` like with `projectValue` directly.
+ */
+export declare const projectFiberValue: (value: unknown, options?: ProjectOptions) => unknown;
+//# sourceMappingURL=projection.d.ts.map

package/dist/modules/fiberTree/utils/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/projection.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,kCAAkC,CAAC;AA8D1C;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,UAAW,OAAO,YAAW,cAAc,KAAQ,OAMhF,CAAC"}

package/dist/modules/fiberTree/utils/projection.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.projectFiberValue = void 0;
+const projectValue_1 = require("../../../shared/projection/projectValue");
+// Props/values to drop — internal React/RN bookkeeping that bloats output.
+// Used by `projectFiberValue` below as `skipKeys`. Anything matching the
+// `__`-prefix regex is also dropped (covers `__nativeTag`, `__reactProps$...`,
+// react-refresh internal markers, etc.).
+const SKIP_KEYS_FIBER = [
+    '__internalInstanceHandle',
+    '__nativeTag',
+    'children',
+    'collapsableChildren',
+    'ref',
+    /^__/,
+];
+// Collapse rule: detect React elements / fiber nodes / native instances and
+// replace them with compact `${...}`-keyed marker objects. Stops projectValue
+// from descending into ~unbounded React internals graph and emits something
+// the agent can act on (mcpId / componentName).
+const fiberCollapseRule = (value) => {
+    if (!value || typeof value !== 'object')
+        return undefined;
+    const obj = value;
+    // React element — has `$$typeof` symbol
+    if ('$$typeof' in obj) {
+        return { ['${ReactElement}']: true };
+    }
+    // Fiber-like or native-instance — try to extract a compact ref
+    const looksLikeFiberOrNative = 'stateNode' in obj || 'memoizedProps' in obj || '__nativeTag' in obj;
+    if (!looksLikeFiberOrNative)
+        return undefined;
+    // pull a fiber out — direct, or via internal handle on a native view
+    const fiber = obj._reactInternals ??
+        obj._reactInternalFiber ??
+        obj._internalFiberInstanceHandleDEV ??
+        obj._internalInstanceHandle ??
+        ('memoizedProps' in obj ? obj : undefined);
+    const meta = {};
+    if (fiber) {
+        const props = fiber.memoizedProps;
+        const mcpId = props?.['data-mcp-id'];
+        const testID = props?.testID;
+        if (mcpId)
+            meta.mcpId = mcpId;
+        if (testID)
+            meta.testID = testID;
+        const typeName = fiber.type?.displayName ??
+            fiber.type?.name;
+        if (typeName)
+            meta.name = typeName;
+    }
+    if ('__nativeTag' in obj) {
+        meta.nativeTag = obj.__nativeTag;
+        const viewConfig = obj.viewConfig;
+        if (viewConfig?.uiViewClassName)
+            meta.viewClass = viewConfig.uiViewClassName;
+    }
+    return { ['${ref}']: Object.keys(meta).length > 0 ? meta : true };
+};
+/**
+ * Projection helper used everywhere fiber values are serialised (props, hook
+ * values, fiber refs). Pre-applies the fiber-aware collapse rule + skip list
+ * over the shared `projectValue`. Callers can pass `path` / `depth` / etc.
+ * through `options` like with `projectValue` directly.
+ */
+const projectFiberValue = (value, options = {}) => {
+    return (0, projectValue_1.projectValue)(value, {
+        ...options,
+        collapse: [fiberCollapseRule, ...(options.collapse ?? [])],
+        skipKeys: [...SKIP_KEYS_FIBER, ...(options.skipKeys ?? [])],
+    }).value;
+};
+exports.projectFiberValue = projectFiberValue;
+//# sourceMappingURL=projection.js.map

package/dist/modules/fiberTree/utils/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/projection.ts"],"names":[],"mappings":";;;AACA,mEAI0C;AAE1C,2EAA2E;AAC3E,yEAAyE;AACzE,+EAA+E;AAC/E,yCAAyC;AACzC,MAAM,eAAe,GAA2B;IAC9C,0BAA0B;IAC1B,aAAa;IACb,UAAU;IACV,qBAAqB;IACrB,KAAK;IACL,KAAK;CACN,CAAC;AAEF,4EAA4E;AAC5E,8EAA8E;AAC9E,4EAA4E;AAC5E,gDAAgD;AAChD,MAAM,iBAAiB,GAAiB,CAAC,KAAc,EAAE,EAAE;IACzD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAE7C,wCAAwC;IACxC,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,+DAA+D;IAC/D,MAAM,sBAAsB,GAC1B,WAAW,IAAI,GAAG,IAAI,eAAe,IAAI,GAAG,IAAI,aAAa,IAAI,GAAG,CAAC;IACvE,IAAI,CAAC,sBAAsB;QAAE,OAAO,SAAS,CAAC;IAE9C,qEAAqE;IACrE,MAAM,KAAK,GACR,GAAG,CAAC,eAAqC;QACzC,GAAG,CAAC,mBAAyC;QAC7C,GAAG,CAAC,+BAAqD;QACzD,GAAG,CAAC,uBAA6C;QAClD,CAAC,eAAe,IAAI,GAAG,CAAC,CAAC,CAAE,GAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAExD,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,KAAK,GAAG,KAAK,CAAC,aAA2D,CAAC;QAChF,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC,aAAa,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,CAAC;QAC7B,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAC9B,IAAI,MAAM;YAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACjC,MAAM,QAAQ,GACX,KAAK,CAAC,IAAmE,EAAE,WAAW;YACtF,KAAK,CAAC,IAAmE,EAAE,IAAI,CAAC;QACnF,IAAI,QAAQ;YAAE,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC;IACrC,CAAC;IACD,IAAI,aAAa,IAAI,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC,WAAW,CAAC;QACjC,MAAM,UAAU,GAAG,GAAG,CAAC,UAAsD,CAAC;QAC9E,IAAI,UAAU,EAAE,eAAe;YAAE,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,eAAe,CAAC;IAC/E,CAAC;IAED,OAAO,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACpE,CAAC,CAAC;AAEF;;;;;GAKG;AACI,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAE,UAA0B,EAAE,EAAW,EAAE;IACzF,OAAO,IAAA,2BAAY,EAAC,KAAK,EAAE;QACzB,GAAG,OAAO;QACV,QAAQ,EAAE,CAAC,iBAAiB,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QAC1D,QAAQ,EAAE,CAAC,GAAG,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;KAC5D,CAAC,CAAC,KAAK,CAAC;AACX,CAAC,CAAC;AANW,QAAA,iBAAiB,qBAM5B"}

package/dist/modules/fiberTree/utils/root.d.ts

@@ -0,0 +1,4 @@
+import { type Fiber } from '../../../modules/fiberTree/types';
+export declare const setRootRef: (ref: unknown) => void;
+export declare const getFiberRoot: () => Fiber | null;
+//# sourceMappingURL=root.d.ts.map

package/dist/modules/fiberTree/utils/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAKvD,eAAO,MAAM,UAAU,QAAS,OAAO,KAAG,IAEzC,CAAC;AAeF,eAAO,MAAM,YAAY,QAAO,KAAK,GAAG,IAKvC,CAAC"}

package/dist/modules/fiberTree/utils/root.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFiberRoot = exports.setRootRef = void 0;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let rootRefStore = null;
+const setRootRef = (ref) => {
+    rootRefStore = ref;
+};
+exports.setRootRef = setRootRef;
+const getFiberFromRef = (ref) => {
+    if (!ref)
+        return null;
+    const r = ref;
+    const fiber = r._internalInstanceHandle ?? r.__internalInstanceHandle ?? r._reactInternals;
+    if (!fiber)
+        return null;
+    let current = fiber;
+    while (current.return) {
+        current = current.return;
+    }
+    return current;
+};
+const getFiberRoot = () => {
+    if (rootRefStore?.current) {
+        return getFiberFromRef(rootRefStore.current);
+    }
+    return null;
+};
+exports.getFiberRoot = getFiberRoot;
+//# sourceMappingURL=root.js.map

package/dist/modules/fiberTree/utils/root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.js","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/root.ts"],"names":[],"mappings":";;;AAEA,8DAA8D;AAC9D,IAAI,YAAY,GAAQ,IAAI,CAAC;AAEtB,MAAM,UAAU,GAAG,CAAC,GAAY,EAAQ,EAAE;IAC/C,YAAY,GAAG,GAAG,CAAC;AACrB,CAAC,CAAC;AAFW,QAAA,UAAU,cAErB;AAEF,MAAM,eAAe,GAAG,CAAC,GAAY,EAAgB,EAAE;IACrD,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,CAAC,GAAG,GAA8B,CAAC;IACzC,MAAM,KAAK,GAAG,CAAC,CAAC,uBAAuB,IAAI,CAAC,CAAC,wBAAwB,IAAI,CAAC,CAAC,eAAe,CAAC;IAC3F,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,IAAI,OAAO,GAAG,KAAc,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;QACtB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAC3B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEK,MAAM,YAAY,GAAG,GAAiB,EAAE;IAC7C,IAAI,YAAY,EAAE,OAAO,EAAE,CAAC;QAC1B,OAAO,eAAe,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AALW,QAAA,YAAY,gBAKvB"}

package/dist/modules/fiberTree/utils/screen.d.ts

@@ -0,0 +1,10 @@
+import { type Fiber } from '../../../modules/fiberTree/types';
+/**
+ * Locate the screen fiber rendering the given React Navigation route key.
+ * Route keys are unique per mounted screen; React Navigation forwards the
+ * `route` prop down a short wrapper chain (SceneView → StaticContainer → …→
+ * user component). Returns the deepest non-wrapper match so queries land on
+ * the developer's screen component, not on a generated wrapper.
+ */
+export declare const findScreenFiberByRouteKey: (root: Fiber, routeKey: string) => Fiber | null;
+//# sourceMappingURL=screen.d.ts.map

package/dist/modules/fiberTree/utils/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../../../src/modules/fiberTree/utils/screen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAgBvD;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,SAAU,KAAK,YAAY,MAAM,KAAG,KAAK,GAAG,IAajF,CAAC"}

package/dist/modules/fiberTree/utils/screen.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findScreenFiberByRouteKey = void 0;
+const naming_1 = require("./naming");
+const traverse_1 = require("./traverse");
+// React Navigation internals that appear in the route.key match chain but
+// are not the user's screen component — we walk past them to the real leaf.
+const RN_NAV_WRAPPERS = new Set([
+    'Anonymous',
+    'ForwardRef',
+    'Memo',
+    'SceneView',
+    'Screen',
+    'StaticContainer',
+]);
+/**
+ * Locate the screen fiber rendering the given React Navigation route key.
+ * Route keys are unique per mounted screen; React Navigation forwards the
+ * `route` prop down a short wrapper chain (SceneView → StaticContainer → …→
+ * user component). Returns the deepest non-wrapper match so queries land on
+ * the developer's screen component, not on a generated wrapper.
+ */
+const findScreenFiberByRouteKey = (root, routeKey) => {
+    const matches = (0, traverse_1.findAllFibers)(root, (f) => {
+        const props = f.memoizedProps;
+        return props?.route?.key === routeKey;
+    });
+    if (matches.length === 0)
+        return null;
+    for (let i = matches.length - 1; i >= 0; i--) {
+        const candidate = matches[i];
+        if (!RN_NAV_WRAPPERS.has((0, naming_1.getComponentName)(candidate))) {
+            return candidate;
+        }
+    }
+    return matches[matches.length - 1];
+};
+exports.findScreenFiberByRouteKey = findScreenFiberByRouteKey;
+//# sourceMappingURL=screen.js.map