@rn-dev-inspector/rn-compat 0.0.0-stage → 1.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Vahe Saroyan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# @rn-dev-inspector/rn-compat
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+React Native version compatibility layer for [React Native Dev Inspector](https://github.com/VaheSaroyan/react-native-dev-inspector).
+
+A Metro resolver shim that keeps the inspector hierarchy working across React Native versions — the internal `getInspectorDataForViewAtPoint` module moved to a new private path on RN 0.82+, and its fiber contract differs between Paper (≤ 0.72) and Fabric (0.73+).
+
+## Supported RN versions
+
+| RN version | Architecture | Status | Notes |
+| --- | --- | --- | --- |
+| ≤ 0.72 | Paper | ✅ Supported | Rebuilds the hierarchy by looking the tapped host fiber up via `touchedViewTag`; wrapper components that don't forward props (e.g. `Button`) still resolve to the business JSX line |
+| 0.73 – 0.81 | Fabric | ✅ Supported | Restores hierarchy fibers and finds source in the subtree |
+| 0.82+ | Fabric | ✅ Supported | Intercepts the new private devsupport path; shim rebuilds the hierarchy (verified on 0.86) |
+
+> **Compatibility caveat:** the layer intercepts react-native's *internal* module paths (`react-native/src/private/...`, `react-native/Libraries/Inspector/...`). These are not public API and can move in any release. When upgrading RN past the versions listed above, verify the inspector still works; if a path moved, the compat layer will log a warning and degrade to the stock inspector instead of breaking the bundler.
+
+## Usage
+
+```js
+// metro.config.js
+const { getDefaultConfig } = require('@react-native/metro-config');
+const { withInspector } = require('react-native-dev-inspector/metro');
+const { withInspectorCompat } = require('@rn-dev-inspector/rn-compat');
+
+module.exports = withInspector(withInspectorCompat(getDefaultConfig(__dirname)));
+```
+
+`withInspectorCompat` never mutates the config you pass in (it returns a new object) and never throws at config load time: if the react-native implementation cannot be located it logs a warning and returns the config without the compat resolver, so the bundler keeps running.
+
+Options:
+
+- `root` — app root directory used to locate react-native; defaults to `config.projectRoot` or `process.cwd()`. In a monorepo the lookup walks up parent directories, so a hoisted react-native in the workspace root's `node_modules` is found automatically.
+
+## How it works
+
+1. **Interception** — the resolver redirects react-native's inspector module (both the legacy `Libraries/Inspector` path and the 0.82+ `src/private` path) to a bundled shim.
+2. **Shim** — the shim requires the *real* implementation through the marker name `__rn_dev_inspector_original_impl__`, which the resolver maps back to the actual file in the project's react-native install (resolved to an absolute path at config time, since the shim is not on the project's node_modules chain).
+3. **Polyfills** — `@rn-dev-inspector/rn-compat/runtime` (re-exported as `react-native-dev-inspector/rn-compat`) contains runtime fixes for Paper/Fabric differences.
+4. **Watch folders** — the shim package (and the react-native package, when it lives outside the project, e.g. in a monorepo workspace root) is appended to `config.watchFolders` so it participates in bundling.
+5. **Optional peers** — `expo-dev-menu` / `expo-dev-client` are resolved to an empty module when not installed, so Metro doesn't generate a stub that throws "Requiring unknown module" at runtime.

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @rn-dev-inspector/rn-compat
+ *
+ * React Native version compatibility layer. One-line integration in
+ * metro.config.js:
+ *
+ *   const { withInspector } = require('react-native-dev-inspector/metro');
+ *   const { withInspectorCompat } = require('@rn-dev-inspector/rn-compat');
+ *   module.exports = withInspector(withInspectorCompat(getDefaultConfig(__dirname)));
+ *
+ * Adaptation matrix:
+ *   RN <= 0.72 (Paper)      : fix Metro optional-dependency mis-resolution +
+ *                             rebuild hierarchy by looking the host fiber up
+ *                             via touchedViewTag (wrapper components that do
+ *                             not forward props, like Button, also resolve to
+ *                             the business JSX line)
+ *   RN 0.73-0.81 (Fabric)   : fix optional-dependency mis-resolution + restore
+ *                             hierarchy fibers + find source in subtree
+ *   RN 0.82+                : intercept the new private path -> shim rebuilds
+ *                             the hierarchy (verified on 0.86)
+ *
+ * The shim refers back to the current RN's real getInspectorDataForViewAtPoint
+ * implementation through the marker module name
+ * `__rn_dev_inspector_original_impl__`; the marker name is resolved to an
+ * absolute path at config time, so the shim is decoupled from the project's
+ * location (the shim file is not on the project's node_modules chain — a bare
+ * module name would fail to resolve).
+ */
+interface WithInspectorCompatOptions {
+    /** App root directory; defaults to config.projectRoot or process.cwd() */
+    root?: string;
+}
+type MetroResolver = (context: any, moduleName: string, platform: string | null) => {
+    type: string;
+    filePath: string;
+} | any;
+interface MetroConfigLike {
+    projectRoot?: string;
+    watchFolders?: string[];
+    resolver?: {
+        resolveRequest?: MetroResolver;
+        [key: string]: any;
+    };
+    [key: string]: any;
+}
+/**
+ * Wrap the metro config:
+ * - intercept the 0.82 private path -> bundled shim (the shim requires the
+ *   real implementation internally)
+ * - intercept the marker module name -> real implementation file
+ * - all other requests continue with the original resolveRequest (if any)
+ *
+ * Never throws and never mutates the input config: the returned object is a
+ * shallow copy, so it composes safely
+ * (`withInspector(withInspectorCompat(config))`). When the react-native
+ * implementation cannot be located it warns and returns the config with the
+ * compat resolver omitted — a broken integration must not take down the
+ * entire bundler.
+ */
+export declare function withInspectorCompat<T extends MetroConfigLike = MetroConfigLike>(config: T, options?: WithInspectorCompatOptions): T;
+export default withInspectorCompat;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAuBH,UAAU,0BAA0B;IAClC,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,KAAK,aAAa,GAAG,CACnB,OAAO,EAAE,GAAG,EACZ,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,KACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,GAAG,CAAC;AAE9C,UAAU,eAAe;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE;QACT,cAAc,CAAC,EAAE,aAAa,CAAC;QAC/B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AA+BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAC7E,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,0BAA+B,GACvC,CAAC,CAkFH;AAED,eAAe,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * @rn-dev-inspector/rn-compat
+ *
+ * React Native version compatibility layer. One-line integration in
+ * metro.config.js:
+ *
+ *   const { withInspector } = require('react-native-dev-inspector/metro');
+ *   const { withInspectorCompat } = require('@rn-dev-inspector/rn-compat');
+ *   module.exports = withInspector(withInspectorCompat(getDefaultConfig(__dirname)));
+ *
+ * Adaptation matrix:
+ *   RN <= 0.72 (Paper)      : fix Metro optional-dependency mis-resolution +
+ *                             rebuild hierarchy by looking the host fiber up
+ *                             via touchedViewTag (wrapper components that do
+ *                             not forward props, like Button, also resolve to
+ *                             the business JSX line)
+ *   RN 0.73-0.81 (Fabric)   : fix optional-dependency mis-resolution + restore
+ *                             hierarchy fibers + find source in subtree
+ *   RN 0.82+                : intercept the new private path -> shim rebuilds
+ *                             the hierarchy (verified on 0.86)
+ *
+ * The shim refers back to the current RN's real getInspectorDataForViewAtPoint
+ * implementation through the marker module name
+ * `__rn_dev_inspector_original_impl__`; the marker name is resolved to an
+ * absolute path at config time, so the shim is decoupled from the project's
+ * location (the shim file is not on the project's node_modules chain — a bare
+ * module name would fail to resolve).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withInspectorCompat = withInspectorCompat;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// New private path on RN 0.82+, which Inspector.js requires first
+const PRIVATE_082 = 'react-native/src/private/devsupport/devmenu/elementinspector/getInspectorDataForViewAtPoint';
+// Public path on RN <= 0.80, required by core on Paper projects (e.g. 0.72).
+// Intercepted to the shim so Paper can rebuild the hierarchy too (the shim
+// comes back to this file via MARKER).
+const PUBLIC_LE080 = 'react-native/Libraries/Inspector/getInspectorDataForViewAtPoint';
+// The shim requires the real implementation through this marker name; the
+// adapter resolves it to an absolute path at config time
+const MARKER = '__rn_dev_inspector_original_impl__';
+// Optional peers: resolve to an empty module when not installed so core's
+// try/catch degrades gracefully (otherwise Metro generates a stub that throws
+// at runtime and dev reports "Requiring unknown module")
+const OPTIONAL_PEERS = ['expo-dev-menu', 'expo-dev-client'];
+/**
+ * Probe the project's react-native for the real getInspectorDataForViewAtPoint
+ * implementation, by priority:
+ *   0.82+ : src/private/devsupport/devmenu/elementinspector/...
+ *   <=0.80: Libraries/Inspector/...
+ *
+ * Walks up from `root` (node resolution style) so a monorepo app whose
+ * react-native is hoisted into a workspace root's node_modules is found too;
+ * in that case the impl package lives outside the project root and must be
+ * added to watchFolders separately (see withInspectorCompat).
+ */
+function findRealImpl(root) {
+    // Derived from the intercepted module specifiers above so the two stay in sync
+    const candidates = [PRIVATE_082, PUBLIC_LE080].map(moduleName => `node_modules/${moduleName}.js`);
+    let dir = path.resolve(root);
+    for (;;) {
+        for (const rel of candidates) {
+            const p = path.join(dir, rel);
+            if (fs.existsSync(p))
+                return p;
+        }
+        const parent = path.dirname(dir);
+        // Reached the filesystem root without a hit
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+/**
+ * Wrap the metro config:
+ * - intercept the 0.82 private path -> bundled shim (the shim requires the
+ *   real implementation internally)
+ * - intercept the marker module name -> real implementation file
+ * - all other requests continue with the original resolveRequest (if any)
+ *
+ * Never throws and never mutates the input config: the returned object is a
+ * shallow copy, so it composes safely
+ * (`withInspector(withInspectorCompat(config))`). When the react-native
+ * implementation cannot be located it warns and returns the config with the
+ * compat resolver omitted — a broken integration must not take down the
+ * entire bundler.
+ */
+function withInspectorCompat(config, options = {}) {
+    // Prefer Metro's projectRoot (in a monorepo the repo root is not the app
+    // root; the real implementation must be found in the app's own node_modules)
+    const root = options.root || config.projectRoot || process.cwd();
+    const realImpl = findRealImpl(root);
+    if (!realImpl) {
+        // Degrade instead of throwing: without the real implementation the shim
+        // cannot resolve back to RN's own code, so compat interception is skipped
+        // entirely and the bundler keeps working with the stock inspector.
+        console.warn('[rn-dev-inspector] @rn-dev-inspector/rn-compat: could not find the ' +
+            'react-native getInspectorDataForViewAtPoint implementation under ' +
+            root +
+            ' — skipping the compat resolver. Pass { root } if your project ' +
+            'root is not where react-native is installed.');
+        return { ...config };
+    }
+    // After compilation this file lives in dist/; the shim is in the package
+    // root's shims/ directory
+    const shimPath = path.resolve(__dirname, '..', 'shims', 'inspectorDataShim.js');
+    const emptyModulePath = path.resolve(__dirname, '..', 'shims', 'emptyModule.js');
+    // Approximate Metro's resolution with Node's rules (config time, node side):
+    // an expo package counts as "installed" only if resolvable from the project
+    // (or the monorepo root)
+    const isInstalled = (name) => {
+        try {
+            require.resolve(`${name}/package.json`, { paths: [root] });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const prev = (config.resolver && config.resolver.resolveRequest) || null;
+    // Both the shim and the real implementation file must be within Metro's
+    // watch scope to participate in bundling (in a monorepo the real
+    // implementation may sit in the workspace root's node_modules).
+    // Not needed when the react-native package is inside the project (Metro
+    // 0.76's TreeFS throws "Could not add directory" because watchFolders
+    // duplicates a directory already under the project root), and adding it is
+    // actively harmful; only add it when the package lives outside the project
+    // (monorepo).
+    const pkgRoot = path.resolve(__dirname, '..');
+    const implPkgRoot = realImpl.match(/^.*node_modules[\\/]react-native/);
+    const implOutsideProject = implPkgRoot &&
+        (() => {
+            const rel = path.relative(root, implPkgRoot[0]);
+            return !!rel && (rel.startsWith('..') || path.isAbsolute(rel));
+        })();
+    const extraWatch = [
+        pkgRoot,
+        ...(implOutsideProject ? [implPkgRoot[0]] : []),
+    ];
+    // Build a new config object instead of mutating the input, so wrapping is
+    // idempotent-safe and composes with other with* helpers
+    const nextConfig = {
+        ...config,
+        watchFolders: [
+            ...new Set([...(config.watchFolders || []), ...extraWatch]),
+        ],
+        resolver: {
+            ...(config.resolver || {}),
+            resolveRequest(context, moduleName, platform) {
+                if (moduleName === PRIVATE_082 || moduleName === PUBLIC_LE080) {
+                    return { type: 'sourceFile', filePath: shimPath };
+                }
+                if (moduleName === MARKER) {
+                    return { type: 'sourceFile', filePath: realImpl };
+                }
+                if (OPTIONAL_PEERS.includes(moduleName) && !isInstalled(moduleName)) {
+                    return { type: 'sourceFile', filePath: emptyModulePath };
+                }
+                if (prev)
+                    return prev(context, moduleName, platform);
+                return context.resolveRequest(context, moduleName, platform);
+            },
+        },
+    };
+    return nextConfig;
+}
+exports.default = withInspectorCompat;
+//# 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/runtime.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @rn-dev-inspector/rn-compat — runtime patch entry
+ *
+ * Decoupled from withInspectorCompat (the build-time resolver adaptation in
+ * metro.config.js). This file collects side-effect polyfills for "runtime API
+ * gaps on older RN".
+ * Usage (already imported by default by the umbrella package
+ * react-native-dev-inspector, no manual import needed):
+ *
+ *   import '@rn-dev-inspector/rn-compat/dist/runtime';
+ *
+ * Constraint: the build output of this file gets bundled into any RN project,
+ * so it must stay ES5-compatible (plain for loops, no destructuring/spread/
+ * async) to avoid tsc downleveling to @babel/runtime helpers — rn-compat is a
+ * zero-runtime-dependency config package that may not resolve in every
+ * project. Each patch must feature-detect and only fill in what is missing;
+ * it is a no-op on Node/newer RN.
+ */
+/**
+ * React Native defines this in every bundle; it is absent under plain Node
+ * (tests), where we treat the environment as development.
+ */
+declare const __DEV__: boolean | undefined;
+/**
+ * URLSearchParams polyfill for RN <= 0.72 (react-native/Libraries/Blob/URL.js):
+ * only get/getAll/has/append exist; set() throws outright with
+ * "URLSearchParams.set is not implemented". The inspector's Open-in-editor
+ * needs set() to build the query string, so the missing write methods are
+ * filled in here with WHATWG semantics.
+ */
+declare function patchURLSearchParams(): void;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;GAGG;AACH,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,iBAAS,oBAAoB,IAAI,IAAI,CAkEpC"}

package/dist/runtime.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * @rn-dev-inspector/rn-compat — runtime patch entry
+ *
+ * Decoupled from withInspectorCompat (the build-time resolver adaptation in
+ * metro.config.js). This file collects side-effect polyfills for "runtime API
+ * gaps on older RN".
+ * Usage (already imported by default by the umbrella package
+ * react-native-dev-inspector, no manual import needed):
+ *
+ *   import '@rn-dev-inspector/rn-compat/dist/runtime';
+ *
+ * Constraint: the build output of this file gets bundled into any RN project,
+ * so it must stay ES5-compatible (plain for loops, no destructuring/spread/
+ * async) to avoid tsc downleveling to @babel/runtime helpers — rn-compat is a
+ * zero-runtime-dependency config package that may not resolve in every
+ * project. Each patch must feature-detect and only fill in what is missing;
+ * it is a no-op on Node/newer RN.
+ */
+/**
+ * URLSearchParams polyfill for RN <= 0.72 (react-native/Libraries/Blob/URL.js):
+ * only get/getAll/has/append exist; set() throws outright with
+ * "URLSearchParams.set is not implemented". The inspector's Open-in-editor
+ * needs set() to build the query string, so the missing write methods are
+ * filled in here with WHATWG semantics.
+ */
+function patchURLSearchParams() {
+    const ParamsAny = globalThis.URLSearchParams;
+    if (typeof ParamsAny !== 'function')
+        return;
+    const proto = ParamsAny.prototype;
+    // Behavioral probe: RN 0.72's polyfill "has" set() on its prototype, but
+    // calling it throws "URLSearchParams.set is not implemented" — a typeof
+    // check alone would be a false positive.
+    let setWorks = false;
+    try {
+        const probe = new ParamsAny('a=1');
+        probe.set('a', '2');
+        setWorks = probe.toString() === 'a=2';
+    }
+    catch {
+        setWorks = false;
+    }
+    // set: replace the first same-name entry (keeping order), or append at the end
+    if (!setWorks) {
+        proto.set = function set(name, value) {
+            name = String(name);
+            value = String(value);
+            const hasGet = typeof this.get === 'function';
+            if (hasGet && this.get(name) === null) {
+                this.append(name, value);
+                return;
+            }
+            const internal = this._searchParams;
+            if (Array.isArray(internal)) {
+                let replaced = false;
+                const kept = [];
+                for (let i = 0; i < internal.length; i++) {
+                    const pair = internal[i];
+                    if (pair && pair.name === name) {
+                        if (!replaced) {
+                            pair.value = value;
+                            replaced = true;
+                            kept.push(pair);
+                        }
+                    }
+                    else {
+                        kept.push(pair);
+                    }
+                }
+                this._searchParams = kept;
+            }
+            else {
+                // Unknown internal structure: cannot replace precisely when get()
+                // returns a value, degrade to append (get() returns the first
+                // same-name entry, so the result is still correct)
+                this.append(name, value);
+            }
+        };
+    }
+    if (typeof proto.delete !== 'function') {
+        proto.delete = function deleteParam(name) {
+            const internal = this._searchParams;
+            if (Array.isArray(internal)) {
+                const kept = [];
+                for (let i = 0; i < internal.length; i++) {
+                    const pair = internal[i];
+                    if (!(pair && pair.name === String(name)))
+                        kept.push(pair);
+                }
+                this._searchParams = kept;
+            }
+        };
+    }
+}
+// Dev-only. This mutates a global prototype, so it must never run in a
+// release build: a developer tool has no business changing the runtime
+// semantics of the shipped app. The inspector's own use of URLSearchParams
+// is already safe without this patch - buildEditorQueryString (see
+// packages/core/src/editorQuery.ts) probes behaviourally and falls back to
+// manual percent-encoding - so the patch is a convenience for app code on
+// old RN, not something the inspector depends on.
+if (typeof __DEV__ === 'undefined' || __DEV__) {
+    patchURLSearchParams();
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@rn-dev-inspector/rn-compat",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.3.0",
+  "description": "React Native version compatibility layer for React Native Dev Inspector - Metro resolver shim that rebuilds the inspector hierarchy on Fabric (RN 0.73+/0.86+)",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "shims"
+  ],
+  "keywords": [
+    "react-native",
+    "inspector",
+    "devtools",
+    "metro",
+    "fabric",
+    "compat"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VaheSaroyan/react-native-dev-inspector.git",
+    "directory": "packages/rn-compat"
+  },
+  "bugs": {
+    "url": "https://github.com/VaheSaroyan/react-native-dev-inspector/issues"
+  },
+  "homepage": "https://github.com/VaheSaroyan/react-native-dev-inspector#readme",
+  "devDependencies": {
+    "@types/node": "^20.10.0"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./runtime": "./dist/runtime.js",
+    "./runtime.js": "./dist/runtime.js",
+    "./dist/runtime": "./dist/runtime.js",
+    "./dist/runtime.js": "./dist/runtime.js",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm build && node --test \"test/*.test.js\""
+  }
 }

package/shims/emptyModule.js

@@ -0,0 +1,7 @@
+/**
+ * Empty module placeholder. The rn-compat resolver maps optional peer
+ * dependencies (expo-dev-menu / expo-dev-client) here when they are not
+ * installed, so core's `try { require('expo-dev-menu') } catch {}`
+ * degrades to a no-op instead of Metro's runtime-throwing stub.
+ */
+module.exports = {};

package/shims/inspectorDataShim.js

@@ -0,0 +1,358 @@
+/**
+ * Adaptation shim for getInspectorDataForViewAtPoint (works on both Fabric and Paper).
+ *
+ * Adaptation point 2: the inspector hierarchy on RN 0.8x/0.86 Fabric has two problems:
+ * 1. Hierarchy items carry only {props, measure} and no fiber, and _debugSource was
+ *    removed in React 19, so the library has to rely on the babel-injected
+ *    __callerSource — without the fiber there is no source info at all;
+ * 2. The owner chain RN provides may skip levels (intermediate composite components
+ *    are omitted by RN's implementation), so the panel breadcrumb jumps from Text
+ *    straight to an ancestor, missing intermediate levels.
+ *
+ * Adaptation point 3 (Paper, RN <= 0.72): RN Paper's createHierarchy only provides
+ * the props of the "nearest host descendant" (getHostProps) for each owner-chain
+ * fiber, never the fiber itself. Wrapper components such as RN's Button/Touchable
+ * that do not forward props have the babel-injected __callerSource on their
+ * composite fiber, but their inner host elements (rendered from node_modules) do
+ * not — so the nearest item with codeInfo on the tapped chain jumps straight to the
+ * business screen component. Fix: use the container view's
+ * _internalFiberInstanceHandleDEV (fiber) plus viewData.touchedViewTag (native tag)
+ * to find the tapped host fiber, then rebuild the hierarchy along the owner chain
+ * (composite components included), with each item reading fiber.memoizedProps
+ * directly, so __callerSource on <Button> becomes visible.
+ *
+ * Implementation (both architectures share one rebuild path):
+ *   - Fabric: start from viewData.closestInstance (the real fiber); pickSourceFiber
+ *     finds the target fiber carrying __callerSource;
+ *   - Paper: walk up from inspectedView._internalFiberInstanceHandleDEV to the root,
+ *     find the host fiber whose stateNode._nativeTag === touchedViewTag, then walk
+ *     up .return for the nearest fiber carrying __callerSource (subtree DFS fallback);
+ *   - then collect the full composite chain via _debugOwner and rebuild the
+ *     hierarchy (host components included);
+ *   - each item's getInspectorData returns {props: fiber.memoizedProps, measure,
+ *     fiber}, with measure taken from the first host node (stateNode) in that
+ *     fiber's subtree.
+ */
+const mod = require('__rn_dev_inspector_original_impl__');
+const original = mod.default || mod;
+
+function nameOfFiber(fiber) {
+  try {
+    const t = fiber.type;
+    if (typeof t === 'string') return t;
+    if (typeof t === 'function') return t.displayName || t.name || null;
+    if (t && typeof t === 'object') {
+      return t.displayName || (t.render && (t.render.displayName || t.render.name)) || null;
+    }
+  } catch (e) {}
+  return null;
+}
+
+// Shared bounded DFS over a fiber subtree. visit(node) returns a truthy value
+// to stop the walk with that result, or a falsy value to keep going. maxDepth
+// (levels below root, undefined = unlimited) and maxVisited mirror the caps
+// the individual walkers used before they were deduplicated.
+function walkFiberTree(root, maxVisited, visit, maxDepth) {
+  try {
+    let found = null;
+    let visited = 0;
+    (function dfs(node, depth) {
+      if (found || !node || visited > maxVisited) return;
+      if (maxDepth !== undefined && depth > maxDepth) return;
+      visited++;
+      const result = visit(node);
+      if (result) {
+        found = result;
+        return;
+      }
+      dfs(node.child, depth + 1);
+      if (!found) dfs(node.sibling, depth + 1);
+    })(root, 0);
+    return found;
+  } catch (e) {
+    return null;
+  }
+}
+
+function pickSourceFiber(fiber) {
+  try {
+    if (fiber && fiber.memoizedProps && fiber.memoizedProps.__callerSource) {
+      return fiber;
+    }
+    // DFS from the child (the root fiber itself was already checked above);
+    // depth cap 11 = 12 levels below the child, same as before deduplication
+    const found = walkFiberTree(
+      fiber && fiber.child,
+      300,
+      node => {
+        const p = node.memoizedProps;
+        return p && p.__callerSource ? node : null;
+      },
+      11
+    );
+    return found || fiber;
+  } catch (e) {
+    return fiber;
+  }
+}
+
+// Paper: on the parent chain (.return) of the tapped host fiber, find the
+// nearest fiber carrying __callerSource. Wrapper component elements written in
+// business JSX, like <Button>, get __callerSource injected by babel, which
+// lands on the wrapper's composite fiber memoizedProps, while its inner host
+// elements (rendered from node_modules) have none — so the first hop up from
+// the host hits it.
+function pickSourceUpChain(fiber) {
+  try {
+    let f = fiber;
+    let n = 0;
+    while (f && typeof f.tag === 'number' && n < 40) {
+      if (parseCallerSourceRaw(f.memoizedProps)) return f;
+      f = f.return;
+      n++;
+    }
+  } catch (e) {}
+  return null;
+}
+
+// Paper: find the tapped host fiber in the subtree of the container fiber
+// (walked up to the root). On Paper a host fiber's stateNode is a
+// ReactNativeFiberHostComponent whose _nativeTag is the native view tag,
+// matching viewData.touchedViewTag.
+function findTouchedHostFiber(containerFiber, nativeTag) {
+  try {
+    // Walk up to the root, covering nodes rendered outside the container's
+    // subtree (Modal/Portal and friends)
+    let root = containerFiber;
+    let up = 0;
+    while (root && root.return && up < 200) {
+      root = root.return;
+      up++;
+    }
+    return walkFiberTree(root, 5000, node => {
+      if (node.tag === 5 && node.stateNode) {
+        const sn = node.stateNode;
+        const tag =
+          sn._nativeTag != null ? sn._nativeTag : typeof sn.getTag === 'function' ? sn.getTag() : null;
+        return tag === nativeTag ? node : null;
+      }
+      return null;
+    });
+  } catch (e) {
+    return null;
+  }
+}
+
+// First host node (tag 5 = HostComponent) within this fiber's subtree.
+// A host fiber's stateNode carries measure(cb) itself (Fabric wraps it on the
+// ShadowNode side, Paper uses ReactNativeFiberHostComponent — both go through
+// UIManager.measure), so require('react-native') is not needed here (the shim
+// lives outside the project directory and Metro would fail to resolve it).
+function findHostStateNode(fiber) {
+  return walkFiberTree(fiber, 300, node => {
+    return node.tag === 5 && node.stateNode ? node.stateNode : null;
+  });
+}
+
+function measureFor(stateNode) {
+  return function measure(callback) {
+    if (!stateNode || typeof stateNode.measure !== 'function') return;
+    try {
+      stateNode.measure((x, y, width, height, pageX, pageY) => {
+        callback(x, y, width, height, pageX, pageY);
+      });
+    } catch (e) {
+      // Node may already be unmounted; ignore
+    }
+  };
+}
+
+// Composite components named like RN native components (e.g. a business
+// ui/Text wrapper) must be renamed, otherwise core's isUserComponentName
+// filters them out as native and the hierarchy loses a level
+const NATIVE_NAMES = new Set([
+  'View',
+  'Text',
+  'TouchableOpacity',
+  'ScrollView',
+  'Image',
+  'TextInput',
+  'Animated',
+]);
+
+// __callerSource may be an object {fileName,lineNumber,columnNumber} or a JSON string
+function parseCallerSourceRaw(props) {
+  try {
+    const cs = props && props.__callerSource;
+    if (!cs) return null;
+    return typeof cs === 'string' ? JSON.parse(cs) : cs;
+  } catch (e) {
+    return null;
+  }
+}
+
+function baseNameToComponentName(fileName) {
+  if (!fileName) return null;
+  const base = String(fileName).replace(/\\/g, '/').split('/').pop() || '';
+  let stem = base.replace(/\.(tsx?|jsx?)$/, '');
+  if (stem === 'index') {
+    // index.tsx: use the parent directory name
+    const dir = String(fileName).replace(/\\/g, '/').split('/');
+    stem = dir[dir.length - 2] || stem;
+  }
+  if (!stem) return null;
+  return stem.charAt(0).toUpperCase() + stem.slice(1);
+}
+
+// Anonymous composite components (typically React.forwardRef((props)=>...)
+// with no function name, common in business code): derive the component name
+// from the file name of the first child carrying __callerSource inside its
+// render, e.g. <AnimatedBaseButton> at button.tsx:161 -> "Button"
+function deriveAnonymousName(fiber) {
+  try {
+    const fileName = walkFiberTree(fiber && fiber.child, 60, node => {
+      const parsed = parseCallerSourceRaw(node.memoizedProps);
+      return parsed && parsed.fileName ? parsed.fileName : null;
+    });
+    return fileName ? baseNameToComponentName(fileName) : null;
+  } catch (e) {
+    return null;
+  }
+}
+
+function displayNameForFiber(fiber, name) {
+  const t = fiber.type;
+  const isComposite = typeof t === 'function' || (t && typeof t === 'object');
+  if (isComposite && NATIVE_NAMES.has(name)) {
+    return `${name} (custom)`;
+  }
+  return name;
+}
+
+// ---- Source filtering (breadcrumb shows only business-source levels) ----
+// The babel plugin does not inject __callerSource into node_modules, so "the
+// fiber's own props carry __callerSource" implies the element was written in
+// business-source JSX. Wrapper components instantiated inside third-party
+// libraries (e.g. ViewHolderCollection / ViewHolderInternal) lack the marker
+// and are hidden from the breadcrumb; the deepest tapped element is always
+// kept, so picking itself is unaffected.
+const PROJECT_SOURCE_ONLY = true;
+
+function isProjectSourceFiber(fiber) {
+  const parsed = parseCallerSourceRaw(fiber.memoizedProps);
+  if (!parsed || !parsed.fileName) return false;
+  return !String(parsed.fileName).includes('node_modules');
+}
+
+// Some library wrappers still get instantiated in business
+// JSX (e.g. nativewind's styled(Pressable), written on a button.tsx render
+// line, so the fiber carries __callerSource) and a path check would mistake
+// them for business source — filter them out by name as a fallback;
+// 'Xxx (custom)' is a business marker and is never filtered.
+// Note the prefix is "AnimatedComponent", not "Animated" — business
+// components may legitimately be named AnimatedXxx.
+const LIB_WRAPPER_NAMES = new Set([
+  'Pressable', 'TouchableHighlight', 'TouchableNativeFeedback',
+  'TouchableWithoutFeedback', 'FlatList', 'SectionList',
+  'KeyboardAvoidingView', 'Switch', 'StatusBar', 'MaskedView',
+  'RefreshControl', 'ActivityIndicator', 'ProgressBar',
+  'GestureHandlerButton',
+]);
+
+function isLibraryWrapperName(name) {
+  if (!name) return false;
+  if (name.endsWith(' (custom)')) return false;
+  if (name.includes('(')) return true; // wrapper levels like AnimatedComponent(Pressable)
+  if (name.startsWith('AnimatedComponent')) return true;
+  return LIB_WRAPPER_NAMES.has(name);
+}
+
+// Collect the full owner chain up from the source fiber via _debugOwner and
+// rebuild the hierarchy (shared by Fabric and Paper; on Paper the composite
+// fibers of wrappers like Button join the chain so core can read the
+// __callerSource on their memoizedProps)
+function rebuildHierarchyFromSource(sourceFiber) {
+  const chain = [];
+  let f = sourceFiber;
+  while (f && typeof f.tag === 'number' && chain.length < 40) {
+    chain.push(f);
+    f = f._debugOwner;
+  }
+  chain.reverse(); // [0] = closest to root, last = deepest (the tapped element)
+  return chain
+    .map((fiber, idx) => {
+      let raw = nameOfFiber(fiber);
+      const t = fiber.type;
+      const isComposite = typeof t === 'function' || (t && typeof t === 'object');
+      if (!raw && isComposite) {
+        raw = deriveAnonymousName(fiber);
+      }
+      if (!raw) return null;
+      // Hide intermediate levels that are not business source or are library
+      // wrappers (last item = tapped element, always kept)
+      if (
+        PROJECT_SOURCE_ONLY &&
+        idx < chain.length - 1 &&
+        (!isProjectSourceFiber(fiber) || isLibraryWrapperName(raw))
+      ) {
+        return null;
+      }
+      // nativewind's CssInterop wrapper is pure forwarding, and its
+      // __callerSource points inside the wrapper implementation (e.g. a
+      // ui/Text/index.tsx render line) — meaningless to users, skip it
+      if (raw.startsWith('CssInterop')) return null;
+      return {
+        name: displayNameForFiber(fiber, raw),
+        getInspectorData: () => ({
+          props: fiber.memoizedProps,
+          measure: measureFor(findHostStateNode(fiber)),
+          fiber,
+        }),
+      };
+    })
+    .filter(Boolean);
+}
+
+function getInspectorDataForViewAtPoint(inspectedView, locationX, locationY, callback) {
+  original(inspectedView, locationX, locationY, viewData => {
+    try {
+      if (viewData && viewData.closestInstance && typeof viewData.closestInstance.tag === 'number') {
+        // Fabric (RN 0.73+): closestInstance is the real fiber
+        const sourceFiber = pickSourceFiber(viewData.closestInstance);
+        viewData.hierarchy = rebuildHierarchyFromSource(sourceFiber);
+      } else if (
+        viewData &&
+        typeof viewData.touchedViewTag === 'number' &&
+        inspectedView &&
+        inspectedView._internalFiberInstanceHandleDEV &&
+        typeof inspectedView._internalFiberInstanceHandleDEV.tag === 'number'
+      ) {
+        // Paper (RN <= 0.72): RN provides only host-descendant props, not the
+        // fiber. Look the host fiber up via touchedViewTag, then walk the
+        // parent chain for the nearest business element fiber
+        const touched = findTouchedHostFiber(
+          inspectedView._internalFiberInstanceHandleDEV,
+          viewData.touchedViewTag
+        );
+        if (touched) {
+          const sourceFiber = pickSourceUpChain(touched) || pickSourceFiber(touched);
+          viewData.hierarchy = rebuildHierarchyFromSource(sourceFiber);
+        }
+      }
+      if (__DEV__) {
+        try {
+          console.log(
+            '[rn-inspector-adapter] chain:',
+            (viewData && viewData.hierarchy ? viewData.hierarchy : []).map(h => h.name).join(' > ')
+          );
+        } catch (e) {}
+      }
+    } catch (e) {
+      if (__DEV__) console.log('[rn-inspector-adapter] augment error', e && e.message);
+    }
+    callback(viewData);
+  });
+}
+
+module.exports = getInspectorDataForViewAtPoint;
+module.exports.default = getInspectorDataForViewAtPoint;