react-native-instant-webview 0.1.0

package/README.md

@@ -0,0 +1,170 @@
+# react-native-instant-webview
+
+WebView pooling library for React Native. Keeps WebView instances alive across screen transitions so users never see a loading spinner twice.
+
+## How It Works
+
+```
+[WebViewPoolProvider] ─── children (your app)
+       |
+       └── WebViewSlot[0]  (hidden or positioned)
+       └── WebViewSlot[1]
+       └── WebViewSlot[2]
+
+[PooledWebView] ─── placeholder View
+       |              borrow() → slot moves to placeholder position
+       └── unmount → release() → cleanup → idle
+```
+
+WebView instances live at the Provider root with absolute positioning. When a `PooledWebView` mounts, it borrows an idle instance and positions it over the placeholder using `measureInWindow`. On unmount, the instance is cleaned up and returned to the pool — the underlying WKWebView/Android WebView is never destroyed.
+
+## Installation
+
+```bash
+npm install react-native-instant-webview
+```
+
+### Peer Dependencies
+
+```bash
+npm install react react-native react-native-webview
+```
+
+| Dependency | Version |
+|---|---|
+| react | >= 18.0.0 |
+| react-native | >= 0.70.0 |
+| react-native-webview | >= 13.0.0 |
+
+## Quick Start
+
+Wrap your app with `WebViewPoolProvider` and use `PooledWebView` as a drop-in replacement for `WebView`:
+
+```tsx
+import { WebViewPoolProvider, PooledWebView } from 'react-native-instant-webview';
+
+function App() {
+  return (
+    <WebViewPoolProvider config={{ poolSize: 3 }}>
+      <Navigation />
+    </WebViewPoolProvider>
+  );
+}
+
+function DetailScreen({ url }: { url: string }) {
+  return (
+    <View style={{ flex: 1 }}>
+      <PooledWebView
+        source={{ uri: url }}
+        containerStyle={StyleSheet.absoluteFill}
+        onPoolExhausted={() => console.warn('Pool exhausted')}
+      />
+    </View>
+  );
+}
+```
+
+When the pool is exhausted, `PooledWebView` automatically falls back to a regular `WebView` so the user always sees content.
+
+## API
+
+### `<WebViewPoolProvider>`
+
+Wrap your app root. Initializes the pool and renders hidden WebView slots.
+
+```tsx
+<WebViewPoolProvider config={{ poolSize: 3, cleanupOnReturn: true }}>
+  <App />
+</WebViewPoolProvider>
+```
+
+#### Config
+
+| Prop | Type | Default | Description |
+|---|---|---|---|
+| `poolSize` | `number` | `3` | Number of WebView instances to keep in the pool |
+| `cleanupOnReturn` | `boolean` | `true` | Run cleanup script when returning to pool |
+| `customCleanupScript` | `string` | built-in | Custom JS to run during cleanup |
+| `defaultWebViewProps` | `Partial<WebViewProps>` | — | Default props applied to all pooled WebViews |
+
+### `<PooledWebView>`
+
+Drop-in replacement for `<WebView>`. Accepts all `WebViewProps` plus:
+
+| Prop | Type | Description |
+|---|---|---|
+| `containerStyle` | `StyleProp<ViewStyle>` | Style for the placeholder container |
+| `poolKey` | `string` | Stable identifier for the borrower |
+| `onPoolExhausted` | `() => void` | Called when no idle instances are available |
+| `onBorrowed` | `(instanceId: string) => void` | Called when an instance is borrowed |
+| `onReturned` | `(instanceId: string) => void` | Called when an instance is returned |
+
+```tsx
+<PooledWebView
+  source={{ uri: 'https://example.com' }}
+  containerStyle={StyleSheet.absoluteFill}
+  onLoadEnd={() => setLoading(false)}
+  onBorrowed={(id) => console.log('Borrowed:', id)}
+  onReturned={(id) => console.log('Returned:', id)}
+  onPoolExhausted={() => console.warn('Falling back to regular WebView')}
+/>
+```
+
+### `usePooledWebView()`
+
+Imperative hook for manual borrow/release control.
+
+```tsx
+function MyComponent() {
+  const { borrow, release, instanceId, webViewRef } = usePooledWebView();
+
+  useEffect(() => {
+    const result = borrow();
+    if (result) {
+      // Use result.webViewRef to interact with the WebView
+    }
+    return () => release();
+  }, []);
+}
+```
+
+### `useWebViewPool()`
+
+Access the pool context directly for advanced use cases.
+
+```tsx
+const { state, borrow, release } = useWebViewPool();
+console.log(state.availableCount, state.borrowedCount);
+```
+
+## Pool Lifecycle
+
+```
+idle ──borrow()──> borrowed ──release()──> cleaning ──done──> idle
+                      │                                         │
+                      │         WebView stays alive             │
+                      └─────────────────────────────────────────┘
+```
+
+1. **idle** — Instance is available. WebView is hidden (1x1px at -9999).
+2. **borrowed** — Instance is positioned over the `PooledWebView` placeholder.
+3. **cleaning** — Cleanup script runs (scroll reset, timer cleanup, DOM clear), then returns to idle.
+
+On the first borrow of each slot, the WebView is lazily created to avoid a [Fabric crash](https://github.com/react-native-webview/react-native-webview/issues) where `didMoveToWindow` fires before the `source` prop is applied.
+
+## Example
+
+See [`example/bare/App.tsx`](example/bare/App.tsx) for a full navigation example comparing pooled vs normal WebViews side by side.
+
+## Development
+
+```bash
+npm install
+npm run typecheck    # TypeScript check
+npm test             # Run tests (20 tests)
+npm run build        # Build with react-native-builder-bob
+```
+
+## License
+
+MIT

package/lib/commonjs/PooledWebView.js

@@ -0,0 +1,112 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _reactNativeWebview = require("react-native-webview");
+var _WebViewPoolProvider = require("./WebViewPoolProvider");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+let borrowerIdCounter = 0;
+const PooledWebView = ({
+  poolKey,
+  containerStyle,
+  onPoolExhausted,
+  onBorrowed,
+  onReturned,
+  source,
+  ...webViewProps
+}) => {
+  const pool = (0, _WebViewPoolProvider.useWebViewPool)();
+  const instanceIdRef = (0, _react.useRef)(null);
+  const placeholderRef = (0, _react.useRef)(null);
+  const borrowerIdRef = (0, _react.useRef)(poolKey ?? `borrower-${++borrowerIdCounter}`);
+  const propsRef = (0, _react.useRef)({
+    source,
+    ...webViewProps
+  });
+  const [borrowed, setBorrowed] = (0, _react.useState)(false);
+  const [fallback, setFallback] = (0, _react.useState)(false);
+
+  // Keep propsRef in sync without triggering re-renders
+  propsRef.current = {
+    source,
+    ...webViewProps
+  };
+
+  // Borrow on mount
+  (0, _react.useEffect)(() => {
+    const result = pool.borrow(borrowerIdRef.current);
+    if (!result) {
+      setFallback(true);
+      onPoolExhausted?.();
+      return;
+    }
+    instanceIdRef.current = result.instanceId;
+    pool.setInstanceProps(result.instanceId, propsRef.current);
+    setBorrowed(true);
+    onBorrowed?.(result.instanceId);
+    return () => {
+      const id = instanceIdRef.current;
+      if (id) {
+        pool.setInstanceLayout(id, null);
+        pool.release(id);
+        onReturned?.(id);
+        instanceIdRef.current = null;
+      }
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  // Update props when source changes (the primary prop that changes)
+  (0, _react.useEffect)(() => {
+    const id = instanceIdRef.current;
+    if (!id || !borrowed) return;
+    pool.setInstanceProps(id, propsRef.current);
+    // Only re-sync when source actually changes
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [source]);
+
+  // Measure placeholder position
+  const handleLayout = (0, _react.useCallback)(_event => {
+    const id = instanceIdRef.current;
+    if (!id || !placeholderRef.current) return;
+    placeholderRef.current.measureInWindow((x, y, width, height) => {
+      if (width > 0 && height > 0) {
+        pool.setInstanceLayout(id, {
+          top: y,
+          left: x,
+          width,
+          height
+        });
+      }
+    });
+  }, [pool]);
+
+  // Pool exhausted — fall back to a regular WebView
+  if (fallback) {
+    return /*#__PURE__*/_react.default.createElement(_reactNative.View, {
+      style: [{
+        flex: 1
+      }, containerStyle]
+    }, /*#__PURE__*/_react.default.createElement(_reactNativeWebview.WebView, _extends({
+      source: source
+    }, webViewProps, {
+      style: {
+        flex: 1
+      }
+    })));
+  }
+  return /*#__PURE__*/_react.default.createElement(_reactNative.View, {
+    ref: placeholderRef,
+    style: [{
+      flex: 1
+    }, containerStyle],
+    onLayout: handleLayout
+  });
+};
+var _default = exports.default = /*#__PURE__*/_react.default.memo(PooledWebView);
+//# sourceMappingURL=PooledWebView.js.map

package/lib/commonjs/PooledWebView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_reactNativeWebview","_WebViewPoolProvider","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","_extends","assign","bind","arguments","length","apply","borrowerIdCounter","PooledWebView","poolKey","containerStyle","onPoolExhausted","onBorrowed","onReturned","source","webViewProps","pool","useWebViewPool","instanceIdRef","useRef","placeholderRef","borrowerIdRef","propsRef","borrowed","setBorrowed","useState","fallback","setFallback","current","useEffect","result","borrow","instanceId","setInstanceProps","id","setInstanceLayout","release","handleLayout","useCallback","_event","measureInWindow","x","y","width","height","top","left","createElement","View","style","flex","WebView","ref","onLayout","_default","exports","React","memo"],"sourceRoot":"../../src","sources":["PooledWebView.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/WebViewManager.js

@@ -0,0 +1,102 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = require("react");
+var _constants = require("./constants");
+class WebViewManager {
+  static instance = null;
+  config = _constants.DEFAULT_POOL_CONFIG;
+  instances = [];
+  listeners = new Set();
+  initialized = false;
+  constructor() {}
+  static getInstance() {
+    if (!WebViewManager.instance) {
+      WebViewManager.instance = new WebViewManager();
+    }
+    return WebViewManager.instance;
+  }
+  static resetInstance() {
+    WebViewManager.instance = null;
+  }
+  initialize(config) {
+    if (this.initialized) return;
+    this.config = {
+      ..._constants.DEFAULT_POOL_CONFIG,
+      ...config
+    };
+    this.instances = [];
+    for (let i = 0; i < this.config.poolSize; i++) {
+      this.instances.push({
+        id: `webview-pool-${i}`,
+        status: 'idle',
+        webViewRef: /*#__PURE__*/(0, _react.createRef)(),
+        borrowerId: null,
+        createdAt: Date.now(),
+        borrowedAt: null
+      });
+    }
+    this.initialized = true;
+    this.notify();
+  }
+  borrow(borrowerId) {
+    const idle = this.instances.find(inst => inst.status === 'idle');
+    if (!idle) return null;
+    idle.status = 'borrowed';
+    idle.borrowerId = borrowerId;
+    idle.borrowedAt = Date.now();
+    this.notify();
+    return {
+      instanceId: idle.id,
+      webViewRef: idle.webViewRef
+    };
+  }
+  release(instanceId) {
+    const inst = this.instances.find(i => i.id === instanceId);
+    if (!inst || inst.status !== 'borrowed') return;
+    if (this.config.cleanupOnReturn) {
+      inst.status = 'cleaning';
+    } else {
+      inst.status = 'idle';
+      inst.borrowerId = null;
+      inst.borrowedAt = null;
+    }
+    this.notify();
+  }
+  markIdle(instanceId) {
+    const inst = this.instances.find(i => i.id === instanceId);
+    if (!inst) return;
+    inst.status = 'idle';
+    inst.borrowerId = null;
+    inst.borrowedAt = null;
+    this.notify();
+  }
+  getState() {
+    return {
+      instances: [...this.instances],
+      availableCount: this.instances.filter(i => i.status === 'idle').length,
+      borrowedCount: this.instances.filter(i => i.status === 'borrowed').length,
+      initialized: this.initialized
+    };
+  }
+  getConfig() {
+    return {
+      ...this.config
+    };
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  notify() {
+    const state = this.getState();
+    this.listeners.forEach(listener => listener(state));
+  }
+}
+var _default = exports.default = WebViewManager;
+//# sourceMappingURL=WebViewManager.js.map

package/lib/commonjs/WebViewManager.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_constants","WebViewManager","instance","config","DEFAULT_POOL_CONFIG","instances","listeners","Set","initialized","constructor","getInstance","resetInstance","initialize","i","poolSize","push","id","status","webViewRef","createRef","borrowerId","createdAt","Date","now","borrowedAt","notify","borrow","idle","find","inst","instanceId","release","cleanupOnReturn","markIdle","getState","availableCount","filter","length","borrowedCount","getConfig","subscribe","listener","add","delete","state","forEach","_default","exports","default"],"sourceRoot":"../../src","sources":["WebViewManager.ts"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/WebViewPoolProvider.js

@@ -0,0 +1,102 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.WebViewPoolProvider = void 0;
+exports.useWebViewPool = useWebViewPool;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _constants = require("./constants");
+var _WebViewManager = _interopRequireDefault(require("./WebViewManager"));
+var _WebViewSlot = _interopRequireDefault(require("./WebViewSlot"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+const WebViewPoolContext = /*#__PURE__*/(0, _react.createContext)(null);
+function useWebViewPool() {
+  const ctx = (0, _react.useContext)(WebViewPoolContext);
+  if (!ctx) {
+    throw new Error('useWebViewPool must be used within a WebViewPoolProvider');
+  }
+  return ctx;
+}
+const WebViewPoolProvider = ({
+  config,
+  children
+}) => {
+  const managerRef = (0, _react.useRef)(_WebViewManager.default.getInstance());
+  const mergedConfig = (0, _react.useRef)({
+    ..._constants.DEFAULT_POOL_CONFIG,
+    ...config
+  }).current;
+  const [poolState, setPoolState] = (0, _react.useState)(() => {
+    const mgr = managerRef.current;
+    mgr.initialize(mergedConfig);
+    return mgr.getState();
+  });
+  const layoutsRef = (0, _react.useRef)(new Map());
+  const propsRef = (0, _react.useRef)(new Map());
+  const [, forceRender] = (0, _react.useState)(0);
+  (0, _react.useEffect)(() => {
+    const mgr = managerRef.current;
+    const unsub = mgr.subscribe(state => {
+      setPoolState(state);
+    });
+    return unsub;
+  }, []);
+  const borrow = (0, _react.useCallback)(borrowerId => {
+    return managerRef.current.borrow(borrowerId);
+  }, []);
+  const release = (0, _react.useCallback)(instanceId => {
+    layoutsRef.current.delete(instanceId);
+    propsRef.current.delete(instanceId);
+    managerRef.current.release(instanceId);
+  }, []);
+  const setInstanceLayout = (0, _react.useCallback)((instanceId, layout) => {
+    layoutsRef.current.set(instanceId, layout);
+    forceRender(c => c + 1);
+  }, []);
+  const setInstanceProps = (0, _react.useCallback)((instanceId, props) => {
+    propsRef.current.set(instanceId, props);
+    // No forceRender here — the slot reads from propsRef on next render
+    // triggered by the Manager's state change (borrow/release).
+  }, []);
+  const getInstanceLayout = (0, _react.useCallback)(instanceId => {
+    return layoutsRef.current.get(instanceId) ?? null;
+  }, []);
+  const getInstanceProps = (0, _react.useCallback)(instanceId => {
+    return propsRef.current.get(instanceId);
+  }, []);
+  const handleCleanupComplete = (0, _react.useCallback)(instanceId => {
+    managerRef.current.markIdle(instanceId);
+  }, []);
+  const contextValue = {
+    state: poolState,
+    borrow,
+    release,
+    setInstanceLayout,
+    setInstanceProps,
+    getInstanceLayout,
+    getInstanceProps
+  };
+  return /*#__PURE__*/_react.default.createElement(WebViewPoolContext.Provider, {
+    value: contextValue
+  }, /*#__PURE__*/_react.default.createElement(_reactNative.View, {
+    style: styles.container
+  }, children, poolState.instances.map(instance => /*#__PURE__*/_react.default.createElement(_WebViewSlot.default, {
+    key: instance.id,
+    instance: instance,
+    layout: layoutsRef.current.get(instance.id) ?? null,
+    instanceProps: propsRef.current.get(instance.id),
+    config: mergedConfig,
+    onCleanupComplete: handleCleanupComplete
+  }))));
+};
+exports.WebViewPoolProvider = WebViewPoolProvider;
+const styles = _reactNative.StyleSheet.create({
+  container: {
+    flex: 1
+  }
+});
+var _default = exports.default = WebViewPoolProvider;
+//# sourceMappingURL=WebViewPoolProvider.js.map

package/lib/commonjs/WebViewPoolProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_constants","_WebViewManager","_interopRequireDefault","_WebViewSlot","e","__esModule","default","t","WeakMap","r","n","o","i","f","__proto__","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","WebViewPoolContext","createContext","useWebViewPool","ctx","useContext","Error","WebViewPoolProvider","config","children","managerRef","useRef","WebViewManager","getInstance","mergedConfig","DEFAULT_POOL_CONFIG","current","poolState","setPoolState","useState","mgr","initialize","getState","layoutsRef","Map","propsRef","forceRender","useEffect","unsub","subscribe","state","borrow","useCallback","borrowerId","release","instanceId","delete","setInstanceLayout","layout","c","setInstanceProps","props","getInstanceLayout","getInstanceProps","handleCleanupComplete","markIdle","contextValue","createElement","Provider","value","View","style","styles","container","instances","map","instance","key","id","instanceProps","onCleanupComplete","exports","StyleSheet","create","flex","_default"],"sourceRoot":"../../src","sources":["WebViewPoolProvider.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/WebViewSlot.js

@@ -0,0 +1,91 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _reactNativeWebview = require("react-native-webview");
+var _constants = require("./constants");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+const WebViewSlot = ({
+  instance,
+  layout,
+  instanceProps,
+  config,
+  onCleanupComplete
+}) => {
+  const isVisible = instance.status === 'borrowed' && layout != null;
+  const prevStatusRef = (0, _react.useRef)(instance.status);
+
+  // Track whether this slot has ever had a WebView rendered.
+  // On first borrow the WebView is created with a valid user source,
+  // avoiding the Fabric crash where didMoveToWindow fires before
+  // the source prop is applied (causing loadFileURL: with nil URL).
+  // After the first borrow, the WebView stays alive through
+  // cleaning → idle cycles.
+  const [hasWebView, setHasWebView] = (0, _react.useState)(false);
+  (0, _react.useEffect)(() => {
+    if (instance.status === 'borrowed' && !hasWebView) {
+      setHasWebView(true);
+    }
+  }, [instance.status, hasWebView]);
+
+  // When entering cleaning state, inject cleanup script then mark idle
+  (0, _react.useEffect)(() => {
+    if (prevStatusRef.current !== 'cleaning' && instance.status === 'cleaning') {
+      const ref = instance.webViewRef.current;
+      if (ref) {
+        const script = config.customCleanupScript ?? _constants.CLEANUP_SCRIPT;
+        ref.injectJavaScript(script);
+      }
+      const timer = setTimeout(() => {
+        onCleanupComplete(instance.id);
+      }, 100);
+      return () => clearTimeout(timer);
+    }
+    prevStatusRef.current = instance.status;
+  }, [instance.status, instance.id, instance.webViewRef, config.customCleanupScript, onCleanupComplete]);
+  const containerStyle = (0, _react.useMemo)(() => {
+    if (!isVisible || !layout) {
+      return _constants.HIDDEN_STYLE;
+    }
+    return {
+      position: 'absolute',
+      top: layout.top,
+      left: layout.left,
+      width: layout.width,
+      height: layout.height
+    };
+  }, [isVisible, layout]);
+  const handleNavigationStateChange = (0, _react.useCallback)(navState => {
+    instanceProps?.onNavigationStateChange?.(navState);
+  }, [instanceProps]);
+  const source = (0, _react.useMemo)(() => {
+    if (instance.status === 'borrowed' && instanceProps?.source) {
+      return instanceProps.source;
+    }
+    return _constants.BLANK_HTML_SOURCE;
+  }, [instance.status, instanceProps?.source]);
+
+  // Don't render WebView until the first borrow.
+  // This avoids the Fabric crash where didMoveToWindow → visitSource
+  // fires before _source prop is applied on the native side.
+  const shouldRenderWebView = hasWebView;
+  return /*#__PURE__*/_react.default.createElement(_reactNative.View, {
+    style: containerStyle,
+    pointerEvents: isVisible ? 'auto' : 'none'
+  }, shouldRenderWebView && /*#__PURE__*/_react.default.createElement(_reactNativeWebview.WebView, _extends({
+    ref: instance.webViewRef
+  }, instance.status === 'borrowed' ? instanceProps : undefined, {
+    source: source,
+    onNavigationStateChange: handleNavigationStateChange,
+    style: {
+      flex: 1
+    }
+  }, config.defaultWebViewProps || {})));
+};
+var _default = exports.default = /*#__PURE__*/_react.default.memo(WebViewSlot);
+//# sourceMappingURL=WebViewSlot.js.map

package/lib/commonjs/WebViewSlot.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_reactNativeWebview","_constants","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","_extends","assign","bind","arguments","length","apply","WebViewSlot","instance","layout","instanceProps","config","onCleanupComplete","isVisible","status","prevStatusRef","useRef","hasWebView","setHasWebView","useState","useEffect","current","ref","webViewRef","script","customCleanupScript","CLEANUP_SCRIPT","injectJavaScript","timer","setTimeout","id","clearTimeout","containerStyle","useMemo","HIDDEN_STYLE","position","top","left","width","height","handleNavigationStateChange","useCallback","navState","onNavigationStateChange","source","BLANK_HTML_SOURCE","shouldRenderWebView","createElement","View","style","pointerEvents","WebView","undefined","flex","defaultWebViewProps","_default","exports","React","memo"],"sourceRoot":"../../src","sources":["WebViewSlot.tsx"],"mappings":"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","ignoreList":[]}