@oxyhq/bloom 1.7.0 → 1.8.0

package/docs/teleport.mdx

@@ -0,0 +1,72 @@
+---
+title: Teleport
+description: react-native-teleport, vendored — one view moved between hosts, not rebuilt at each end
+---
+
+# Teleport
+
+`@oxyhq/bloom/teleport` is **a copy of [react-native-teleport][upstream] 1.2.0**,
+by Kiryl Ziusko, MIT-licensed. It is not a reimplementation and not an
+adaptation: the files under `src/teleport/` are theirs, each one carrying a
+header that names the file it came from and what changed — import paths, in
+almost every case, and nothing else.
+
+The full licence is in `NOTICE` at the repository root, and it ships in the
+published tarball.
+
+[upstream]: https://github.com/kirillzyusko/react-native-teleport
+
+## Why Bloom carries it rather than depending on it
+
+Bloom needs its **native re-parenting**: moving one platform view between hosts
+instead of mounting a second one somewhere else. That arrives as Fabric
+components — C++ shadow nodes, Kotlin, Objective-C++ — not as JavaScript, and
+Bloom's media flight is the consumer.
+
+Vendoring is a decision with a cost, and the cost is that **this is a fork**.
+Their fixes will not arrive here on their own; their repository is active. Read
+theirs before rewriting anything here.
+
+## The one thing Bloom does differently, and it is not their code
+
+**Bloom mounts these portals from its ROOT LAYER. Never from the origin screen.**
+
+Their `<Portal>` renders `createPortal(children, …)` inside the component that
+mounts it, so the children belong to that component's tree. Their Instagram
+recipe mounts it inside the screen the media starts on and keeps that screen
+alive with `presentation: 'transparentModal'`, which is correct for a navigator
+that behaves that way — and it is the premise the design needs.
+
+Under expo-router on **web** the origin route is unmounted the moment the URL
+changes. Measured against their library, with the origin unmounting:
+
+```
+origin UNMOUNTS   count 1 -> 0 -> 0                      the media is gone
+origin STAYS      stamps ["1","1","1"], ct 0.93 -> 1.73  one element, still playing
+```
+
+The portal is not what fails there; the **ownership** is. Same piece, mounted
+where it does not die — which is what `MediaFlightLayer` does.
+
+`src/__tests__/Teleport.test.tsx` pins all three behaviours, including that last
+one, so nobody re-discovers it in an app.
+
+## Status
+
+- **Web: in, and used.** The move primitive in `media-flight/media-node.web.ts`
+  is theirs (`moveBefore` with an `insertBefore` fallback).
+- **Native: not yet.** The Fabric components are not in this repo. Until they
+  are, Bloom's native flight keeps its three surfaces on one player.
+- **Their own test suite is not here yet, and the reason is measured.** It is
+  written for `preset: react-native`, and Bloom's jest resolves no platform
+  extensions, so it reaches the web files instead. Moving their tests to a web
+  renderer does not work either: they depend on react-native-testing-library's
+  API, not only its renderer — `fireEvent.press` and `toBeOnTheScreen` appear
+  37 times in one 221-line file, and neither exists in
+  `@testing-library/react`. Rewriting those is rewriting every interaction and
+  every assertion, which is not vendoring their tests, it is writing ours.
+
+  So they arrive with the native side, which is what they were written for. They
+  are held, not `.skip`ped: a skipped vendored test claims coverage that does not
+  exist. Meanwhile `src/__tests__/Teleport.test.tsx` covers their code on the
+  path Bloom uses today. See `AGENTS.md`, "Jest resolves no platform extensions".

package/lib/commonjs/teleport/Portal.js

@@ -0,0 +1,109 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = require("react");
+var _portalManager = require("./portal-manager.js");
+var _context = _interopRequireDefault(require("./scroll-view-context/context"));
+var _PortalView = _interopRequireDefault(require("./PortalView"));
+var _useId = _interopRequireDefault(require("./use-id.js"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * COPIED FROM react-native-teleport 1.2.0 — `src/components/Portal.tsx`
+ * MIT, Copyright (c) 2025 Kiryl Ziusko. Full licence in `NOTICE` at the root.
+ *
+ * Changed: import paths only, for this flat directory.
+ */
+
+/**
+ * Portal helps you to render a component in a different place in the view hierarchy.
+ * This is useful when you need a view to visually “break out” of its parent container (for example: modals, toasts, floating UI, popovers).
+ *
+ * @category components
+ * @param hostName - The `name` of the `PortalHost`. It's used to identify the host where the content should be rendered.
+ * @param name - The name of the portal. It's used to identify the portal.
+ * @param children - The content that should be rendered in the portal.
+ * @example
+ * ```tsx
+ * import { useState } from "react";
+ * import { View, StyleSheet, Button } from "react-native";
+ * import { Portal } from "react-native-teleport";
+ * export default function InstantRootExample() {
+ *   const [shouldBeTeleported, setTeleported] = useState(true);
+ *   return (
+ *     <View style={styles.container}>
+ *       {shouldBeTeleported && (
+ *         <Portal hostName={"overlay"}>
+ *           <View style={styles.box} />
+ *         </Portal>
+ *       )}
+ *       <Button
+ *         title={shouldBeTeleported ? "Hide" : "Show"}
+ *         onPress={() => setTeleported((t) => !t)}
+ *       />
+ *     </View>
+ *   );
+ * }
+ * const styles = StyleSheet.create({
+ *   container: {
+ *     flex: 1,
+ *     alignItems: "center",
+ *     justifyContent: "center",
+ *   },
+ *   box: {
+ *     width: 160,
+ *     height: 160,
+ *     marginVertical: 20,
+ *     backgroundColor: "blue",
+ *   },
+ * });
+ * ```
+ */
+const PortalComponent = ({
+  hostName,
+  name,
+  style,
+  children
+}) => {
+  const sourceScrollViewContext = (0, _react.useContext)(_context.default);
+  const {
+    state,
+    dispatch
+  } = (0, _portalManager.usePortalManagerContext)();
+  const instanceId = (0, _useId.default)();
+  const scrollViewContext = hostName && state.hosts[hostName] ? state.hostScrollViewContexts[hostName] ?? null : sourceScrollViewContext;
+  const isRemoved = hostName && name ? state.removed[hostName]?.[name]?.[instanceId] : false;
+  (0, _react.useEffect)(() => {
+    if (!hostName || !name) {
+      return;
+    }
+    dispatch({
+      type: "REGISTER_PORTAL",
+      hostName,
+      name,
+      instanceId
+    });
+    return () => {
+      dispatch({
+        type: "CLEAR_REMOVED_ON_UNMOUNT",
+        hostName,
+        name,
+        instanceId
+      });
+    };
+  }, [dispatch, hostName, name, instanceId]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_context.default.Provider, {
+    value: scrollViewContext,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_PortalView.default, {
+      hostName: hostName,
+      name: name,
+      style: style,
+      children: isRemoved ? null : children
+    })
+  });
+};
+var _default = exports.default = PortalComponent;
+//# sourceMappingURL=Portal.js.map

package/lib/commonjs/teleport/Portal.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_portalManager","_context","_interopRequireDefault","_PortalView","_useId","_jsxRuntime","e","__esModule","default","PortalComponent","hostName","name","style","children","sourceScrollViewContext","useContext","ScrollViewContext","state","dispatch","usePortalManagerContext","instanceId","useId","scrollViewContext","hosts","hostScrollViewContexts","isRemoved","removed","useEffect","type","jsx","Provider","value","_default","exports"],"sourceRoot":"../../../src","sources":["teleport/Portal.tsx"],"mappings":";;;;;;AAMA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,cAAA,GAAAD,OAAA;AACA,IAAAE,QAAA,GAAAC,sBAAA,CAAAH,OAAA;AACA,IAAAI,WAAA,GAAAD,sBAAA,CAAAH,OAAA;AACA,IAAAK,MAAA,GAAAF,sBAAA,CAAAH,OAAA;AAA6B,IAAAM,WAAA,GAAAN,OAAA;AAAA,SAAAG,uBAAAI,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAV7B;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMG,eAAe,GAAGA,CAAC;EAAEC,QAAQ;EAAEC,IAAI;EAAEC,KAAK;EAAEC;AAAsB,CAAC,KAAK;EAC5E,MAAMC,uBAAuB,GAAG,IAAAC,iBAAU,EAACC,gBAAiB,CAAC;EAC7D,MAAM;IAAEC,KAAK;IAAEC;EAAS,CAAC,GAAG,IAAAC,sCAAuB,EAAC,CAAC;EACrD,MAAMC,UAAU,GAAG,IAAAC,cAAK,EAAC,CAAC;EAE1B,MAAMC,iBAAiB,GACrBZ,QAAQ,IAAIO,KAAK,CAACM,KAAK,CAACb,QAAQ,CAAC,GAC5BO,KAAK,CAACO,sBAAsB,CAACd,QAAQ,CAAC,IAAI,IAAI,GAC/CI,uBAAuB;EAE7B,MAAMW,SAAS,GACbf,QAAQ,IAAIC,IAAI,GAAGM,KAAK,CAACS,OAAO,CAAChB,QAAQ,CAAC,GAAGC,IAAI,CAAC,GAAGS,UAAU,CAAC,GAAG,KAAK;EAE1E,IAAAO,gBAAS,EAAC,MAAM;IACd,IAAI,CAACjB,QAAQ,IAAI,CAACC,IAAI,EAAE;MACtB;IACF;IAEAO,QAAQ,CAAC;MAAEU,IAAI,EAAE,iBAAiB;MAAElB,QAAQ;MAAEC,IAAI;MAAES;IAAW,CAAC,CAAC;IAEjE,OAAO,MAAM;MACXF,QAAQ,CAAC;QACPU,IAAI,EAAE,0BAA0B;QAChClB,QAAQ;QACRC,IAAI;QACJS;MACF,CAAC,CAAC;IACJ,CAAC;EACH,CAAC,EAAE,CAACF,QAAQ,EAAER,QAAQ,EAAEC,IAAI,EAAES,UAAU,CAAC,CAAC;EAE1C,oBACE,IAAAf,WAAA,CAAAwB,GAAA,EAAC5B,QAAA,CAAAO,OAAiB,CAACsB,QAAQ;IAACC,KAAK,EAAET,iBAAkB;IAAAT,QAAA,eACnD,IAAAR,WAAA,CAAAwB,GAAA,EAAC1B,WAAA,CAAAK,OAAU;MAACE,QAAQ,EAAEA,QAAS;MAACC,IAAI,EAAEA,IAAK;MAACC,KAAK,EAAEA,KAAM;MAAAC,QAAA,EACtDY,SAAS,GAAG,IAAI,GAAGZ;IAAQ,CAClB;EAAC,CACa,CAAC;AAEjC,CAAC;AAAC,IAAAmB,QAAA,GAAAC,OAAA,CAAAzB,OAAA,GAEaC,eAAe","ignoreList":[]}

package/lib/commonjs/teleport/PortalHost.js

@@ -0,0 +1,75 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = require("react");
+var _portalManager = require("./portal-manager.js");
+var _context = _interopRequireDefault(require("./scroll-view-context/context"));
+var _PortalHostView = _interopRequireDefault(require("./PortalHostView"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * COPIED FROM react-native-teleport 1.2.0 — `src/components/PortalHost.tsx`
+ * MIT, Copyright (c) 2025 Kiryl Ziusko. Full licence in `NOTICE` at the root.
+ *
+ * Changed: import paths only, for this flat directory.
+ */
+
+/**
+ * PortalHost is a component that acts as an anchor for the portals.
+ * You can define multiple portal hosts in your app and use them to render different portals.
+ * Each portal host has a unique name that you can use to identify a necessary one among the others.
+ *
+ * @category components
+ * @param name - The name of the portal host. It's used by `<Portal />` component to identify the host.
+ *
+ * @example
+ * ```tsx
+ * import { StyleSheet, View } from "react-native";
+ * import { PortalHost, PortalProvider } from "react-native-teleport";
+ * export default function App() {
+ *   return (
+ *     <PortalProvider>
+ *        <PortalHost style={StyleSheet.absoluteFillObject} name="overlay" />
+ *     </PortalProvider>
+ *   );
+ * }
+ * ```
+ */const PortalHostComponent = ({
+  name,
+  children,
+  style
+}) => {
+  const {
+    dispatch
+  } = (0, _portalManager.usePortalManagerContext)();
+  const scrollViewContext = (0, _react.useContext)(_context.default);
+  (0, _react.useEffect)(() => {
+    dispatch({
+      type: "REGISTER_HOST",
+      hostName: name
+    });
+    return () => {
+      dispatch({
+        type: "UNREGISTER_HOST",
+        hostName: name
+      });
+    };
+  }, [name, dispatch]);
+  (0, _react.useEffect)(() => {
+    dispatch({
+      type: "SET_HOST_SCROLL_VIEW_CONTEXT",
+      hostName: name,
+      value: scrollViewContext
+    });
+  }, [name, dispatch, scrollViewContext]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PortalHostView.default, {
+    name: name,
+    style: style,
+    children: children
+  });
+};
+var _default = exports.default = PortalHostComponent;
+//# sourceMappingURL=PortalHost.js.map

package/lib/commonjs/teleport/PortalHost.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_portalManager","_context","_interopRequireDefault","_PortalHostView","_jsxRuntime","e","__esModule","default","PortalHostComponent","name","children","style","dispatch","usePortalManagerContext","scrollViewContext","useContext","ScrollViewContext","useEffect","type","hostName","value","jsx","_default","exports"],"sourceRoot":"../../../src","sources":["teleport/PortalHost.tsx"],"mappings":";;;;;;AAMA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,cAAA,GAAAD,OAAA;AACA,IAAAE,QAAA,GAAAC,sBAAA,CAAAH,OAAA;AAEA,IAAAI,eAAA,GAAAD,sBAAA,CAAAH,OAAA;AAA0C,IAAAK,WAAA,GAAAL,OAAA;AAAA,SAAAG,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAV1C;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,GACA,MAAMG,mBAAmB,GAAGA,CAAC;EAAEC,IAAI;EAAEC,QAAQ;EAAEC;AAAuB,CAAC,KAAK;EAC1E,MAAM;IAAEC;EAAS,CAAC,GAAG,IAAAC,sCAAuB,EAAC,CAAC;EAC9C,MAAMC,iBAAiB,GAAG,IAAAC,iBAAU,EAACC,gBAAiB,CAAC;EAEvD,IAAAC,gBAAS,EAAC,MAAM;IACdL,QAAQ,CAAC;MAAEM,IAAI,EAAE,eAAe;MAAEC,QAAQ,EAAEV;IAAK,CAAC,CAAC;IAEnD,OAAO,MAAM;MACXG,QAAQ,CAAC;QAAEM,IAAI,EAAE,iBAAiB;QAAEC,QAAQ,EAAEV;MAAK,CAAC,CAAC;IACvD,CAAC;EACH,CAAC,EAAE,CAACA,IAAI,EAAEG,QAAQ,CAAC,CAAC;EAEpB,IAAAK,gBAAS,EAAC,MAAM;IACdL,QAAQ,CAAC;MACPM,IAAI,EAAE,8BAA8B;MACpCC,QAAQ,EAAEV,IAAI;MACdW,KAAK,EAAEN;IACT,CAAC,CAAC;EACJ,CAAC,EAAE,CAACL,IAAI,EAAEG,QAAQ,EAAEE,iBAAiB,CAAC,CAAC;EAEvC,oBACE,IAAAV,WAAA,CAAAiB,GAAA,EAAClB,eAAA,CAAAI,OAAU;IAACE,IAAI,EAAEA,IAAK;IAACE,KAAK,EAAEA,KAAM;IAAAD,QAAA,EAClCA;EAAQ,CACC,CAAC;AAEjB,CAAC;AAAC,IAAAY,QAAA,GAAAC,OAAA,CAAAhB,OAAA,GAEaC,mBAAmB","ignoreList":[]}

package/lib/commonjs/teleport/PortalHostView.js

@@ -0,0 +1,40 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = require("react");
+var _portalRegistry = require("./portal-registry.js");
+var _jsxRuntime = require("react/jsx-runtime");
+/**
+ * COPIED FROM react-native-teleport 1.2.0 — `src/views/PortalHost/index.tsx`
+ * MIT, Copyright (c) 2025 Kiryl Ziusko. Full licence in `NOTICE` at the root.
+ *
+ * Changed: import paths only, for this flat directory.
+ */
+
+function PortalHost({
+  name,
+  children,
+  style
+}) {
+  const {
+    registerHost
+  } = (0, _portalRegistry.usePortalRegistryContext)();
+  (0, _react.useEffect)(() => {
+    return () => {
+      registerHost(name, null);
+    };
+  }, [name, registerHost]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+    style: {
+      ...style,
+      pointerEvents: "none"
+    },
+    ref: ref => registerHost(name, ref),
+    children: children
+  });
+}
+var _default = exports.default = /*#__PURE__*/(0, _react.memo)(PortalHost);
+//# sourceMappingURL=PortalHostView.js.map

package/lib/commonjs/teleport/PortalHostView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_portalRegistry","_jsxRuntime","PortalHost","name","children","style","registerHost","usePortalRegistryContext","useEffect","jsx","pointerEvents","ref","_default","exports","default","memo"],"sourceRoot":"../../../src","sources":["teleport/PortalHostView.tsx"],"mappings":";;;;;;AAMA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,eAAA,GAAAD,OAAA;AAA6D,IAAAE,WAAA,GAAAF,OAAA;AAP7D;AACA;AACA;AACA;AACA;AACA;;AAKA,SAASG,UAAUA,CAAC;EAAEC,IAAI;EAAEC,QAAQ;EAAEC;AAAuB,CAAC,EAAE;EAC9D,MAAM;IAAEC;EAAa,CAAC,GAAG,IAAAC,wCAAwB,EAAC,CAAC;EAEnD,IAAAC,gBAAS,EAAC,MAAM;IACd,OAAO,MAAM;MACXF,YAAY,CAACH,IAAI,EAAE,IAAI,CAAC;IAC1B,CAAC;EACH,CAAC,EAAE,CAACA,IAAI,EAAEG,YAAY,CAAC,CAAC;EAExB,oBACE,IAAAL,WAAA,CAAAQ,GAAA;IACEJ,KAAK,EAAE;MAAE,GAAGA,KAAK;MAAEK,aAAa,EAAE;IAAO,CAAyB;IAClEC,GAAG,EAAGA,GAAG,IAAKL,YAAY,CAACH,IAAI,EAAEQ,GAAG,CAAE;IAAAP,QAAA,EAErCA;EAAQ,CACN,CAAC;AAEV;AAAC,IAAAQ,QAAA,GAAAC,OAAA,CAAAC,OAAA,gBAEc,IAAAC,WAAI,EAACb,UAAU,CAAC","ignoreList":[]}

package/lib/commonjs/teleport/PortalHostView.native.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _PortalHostViewNativeComponent = _interopRequireDefault(require("./specs/PortalHostViewNativeComponent.js"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * COPIED FROM react-native-teleport 1.2.0 — `src/views/PortalHost/index.native.tsx`
+ * MIT, Copyright (c) 2025 Kiryl Ziusko. Full licence in `NOTICE` at the root.
+ *
+ * Changed: import paths only, for this flat directory.
+ */
+
+const PortalHost = props => {
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PortalHostViewNativeComponent.default, {
+    pointerEvents: "box-none",
+    ...props
+  });
+};
+var _default = exports.default = PortalHost;
+//# sourceMappingURL=PortalHostView.native.js.map

package/lib/commonjs/teleport/PortalHostView.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_PortalHostViewNativeComponent","_interopRequireDefault","require","_jsxRuntime","e","__esModule","default","PortalHost","props","jsx","pointerEvents","_default","exports"],"sourceRoot":"../../../src","sources":["teleport/PortalHostView.native.tsx"],"mappings":";;;;;;AAMA,IAAAA,8BAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA8E,IAAAC,WAAA,GAAAD,OAAA;AAAA,SAAAD,uBAAAG,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AAN9E;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMG,UAAU,GAAIC,KAAsB,IAAK;EAC7C,oBAAO,IAAAL,WAAA,CAAAM,GAAA,EAACT,8BAAA,CAAAM,OAAyB;IAACI,aAAa,EAAC,UAAU;IAAA,GAAKF;EAAK,CAAG,CAAC;AAC1E,CAAC;AAAC,IAAAG,QAAA,GAAAC,OAAA,CAAAN,OAAA,GAEaC,UAAU","ignoreList":[]}

package/lib/commonjs/teleport/PortalProvider.js

@@ -0,0 +1,57 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = PortalProvider;
+var _PortalHost = _interopRequireDefault(require("./PortalHost.js"));
+var _PortalProviderView = _interopRequireDefault(require("./PortalProviderView"));
+var _portalManager = require("./portal-manager.js");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * COPIED FROM react-native-teleport 1.2.0 — `src/PortalProvider.tsx`
+ * MIT, Copyright (c) 2025 Kiryl Ziusko. Full licence in `NOTICE` at the root.
+ *
+ * Changed: import paths only, for this flat directory.
+ */
+
+/**
+ * Wraps your app with this component to use the teleport API.
+ *
+ * This component provides a context/registry for all Portals so that you can use imperative API, such as `usePortal` hook to manage Portals.
+ *
+ * @category components
+ * @example
+ * ```tsx
+ * import { PortalProvider } from "react-native-teleport";
+ * export default function App() {
+ *   return (
+ *     <PortalProvider>
+ *       //* your main application code goes here
+ *     </PortalProvider>
+ *   );
+ * }
+ */
+function PortalProvider({
+  children
+}) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PortalProviderView.default, {
+    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_portalManager.PortalManagerProvider, {
+      children: [children, /*#__PURE__*/(0, _jsxRuntime.jsx)(_PortalHost.default, {
+        name: "root",
+        style: styles.root
+      })]
+    })
+  });
+}
+const styles = {
+  root: {
+    position: "absolute",
+    top: 0,
+    bottom: 0,
+    left: 0,
+    right: 0
+  }
+};
+//# sourceMappingURL=PortalProvider.js.map

package/lib/commonjs/teleport/PortalProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_PortalHost","_interopRequireDefault","require","_PortalProviderView","_portalManager","_jsxRuntime","e","__esModule","default","PortalProvider","children","jsx","jsxs","PortalManagerProvider","name","style","styles","root","position","top","bottom","left","right"],"sourceRoot":"../../../src","sources":["teleport/PortalProvider.tsx"],"mappings":";;;;;;AAMA,IAAAA,WAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,mBAAA,GAAAF,sBAAA,CAAAC,OAAA;AACA,IAAAE,cAAA,GAAAF,OAAA;AAAyD,IAAAG,WAAA,GAAAH,OAAA;AAAA,SAAAD,uBAAAK,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA;AARzD;AACA;AACA;AACA;AACA;AACA;;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACe,SAASG,cAAcA,CAAC;EAAEC;AAA8B,CAAC,EAAE;EACxE,oBACE,IAAAL,WAAA,CAAAM,GAAA,EAACR,mBAAA,CAAAK,OAAoB;IAAAE,QAAA,eACnB,IAAAL,WAAA,CAAAO,IAAA,EAACR,cAAA,CAAAS,qBAAqB;MAAAH,QAAA,GACnBA,QAAQ,eACT,IAAAL,WAAA,CAAAM,GAAA,EAACX,WAAA,CAAAQ,OAAU;QAACM,IAAI,EAAC,MAAM;QAACC,KAAK,EAAEC,MAAM,CAACC;MAAK,CAAE,CAAC;IAAA,CACzB;EAAC,CACJ,CAAC;AAE3B;AAEA,MAAMD,MAAM,GAAG;EACbC,IAAI,EAAE;IACJC,QAAQ,EAAE,UAAU;IACpBC,GAAG,EAAE,CAAC;IACNC,MAAM,EAAE,CAAC;IACTC,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE;EACT;AACF,CAAU","ignoreList":[]}

package/lib/commonjs/teleport/PortalProviderView.js

@@ -0,0 +1,59 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = PortalProvider;
+var _react = require("react");
+var _portalRegistry = require("./portal-registry.js");
+var _jsxRuntime = require("react/jsx-runtime");
+/**
+ * COPIED FROM react-native-teleport 1.2.0 — `src/views/PortalProvider/index.tsx`
+ * MIT, Copyright (c) 2025 Kiryl Ziusko. Full licence in `NOTICE` at the root.
+ *
+ * Changed: import paths only, for this flat directory.
+ */
+
+function PortalProvider({
+  children
+}) {
+  const hostsRef = (0, _react.useRef)(new Map());
+  const pendingPortalsRef = (0, _react.useRef)(new Map());
+  const registerHost = (0, _react.useCallback)((name, node) => {
+    if (node) {
+      hostsRef.current.set(name, node);
+    } else {
+      hostsRef.current.delete(name);
+    }
+    const callbacks = pendingPortalsRef.current.get(name);
+    if (callbacks) {
+      callbacks.forEach(callback => callback());
+    }
+  }, []);
+  const getHost = (0, _react.useCallback)(name => hostsRef.current.get(name) ?? null, []);
+  const registerPendingPortal = (0, _react.useCallback)((name, callback) => {
+    const callbacks = pendingPortalsRef.current.get(name) ?? new Set();
+    callbacks.add(callback);
+    pendingPortalsRef.current.set(name, callbacks);
+  }, []);
+  const unregisterPendingPortal = (0, _react.useCallback)((name, callback) => {
+    const callbacks = pendingPortalsRef.current.get(name);
+    if (callbacks) {
+      callbacks.delete(callback);
+      if (callbacks.size === 0) {
+        pendingPortalsRef.current.delete(name);
+      }
+    }
+  }, []);
+  const value = (0, _react.useMemo)(() => ({
+    registerHost,
+    getHost,
+    registerPendingPortal,
+    unregisterPendingPortal
+  }), [registerHost, getHost, registerPendingPortal, unregisterPendingPortal]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_portalRegistry.PortalRegistryContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+//# sourceMappingURL=PortalProviderView.js.map

package/lib/commonjs/teleport/PortalProviderView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_portalRegistry","_jsxRuntime","PortalProvider","children","hostsRef","useRef","Map","pendingPortalsRef","registerHost","useCallback","name","node","current","set","delete","callbacks","get","forEach","callback","getHost","registerPendingPortal","Set","add","unregisterPendingPortal","size","value","useMemo","jsx","PortalRegistryContext","Provider"],"sourceRoot":"../../../src","sources":["teleport/PortalProviderView.tsx"],"mappings":";;;;;;AAMA,IAAAA,MAAA,GAAAC,OAAA;AACA,IAAAC,eAAA,GAAAD,OAAA;AAA0D,IAAAE,WAAA,GAAAF,OAAA;AAP1D;AACA;AACA;AACA;AACA;AACA;;AAKe,SAASG,cAAcA,CAAC;EAAEC;AAA8B,CAAC,EAAE;EACxE,MAAMC,QAAQ,GAAG,IAAAC,aAAM,EAA2B,IAAIC,GAAG,CAAC,CAAC,CAAC;EAC5D,MAAMC,iBAAiB,GAAG,IAAAF,aAAM,EAA+B,IAAIC,GAAG,CAAC,CAAC,CAAC;EAEzE,MAAME,YAAY,GAAG,IAAAC,kBAAW,EAAC,CAACC,IAAY,EAAEC,IAAwB,KAAK;IAC3E,IAAIA,IAAI,EAAE;MACRP,QAAQ,CAACQ,OAAO,CAACC,GAAG,CAACH,IAAI,EAAEC,IAAI,CAAC;IAClC,CAAC,MAAM;MACLP,QAAQ,CAACQ,OAAO,CAACE,MAAM,CAACJ,IAAI,CAAC;IAC/B;IAEA,MAAMK,SAAS,GAAGR,iBAAiB,CAACK,OAAO,CAACI,GAAG,CAACN,IAAI,CAAC;IACrD,IAAIK,SAAS,EAAE;MACbA,SAAS,CAACE,OAAO,CAAEC,QAAQ,IAAKA,QAAQ,CAAC,CAAC,CAAC;IAC7C;EACF,CAAC,EAAE,EAAE,CAAC;EACN,MAAMC,OAAO,GAAG,IAAAV,kBAAW,EACxBC,IAAY,IAAKN,QAAQ,CAACQ,OAAO,CAACI,GAAG,CAACN,IAAI,CAAC,IAAI,IAAI,EACpD,EACF,CAAC;EACD,MAAMU,qBAAqB,GAAG,IAAAX,kBAAW,EACvC,CAACC,IAAY,EAAEQ,QAAoB,KAAK;IACtC,MAAMH,SAAS,GAAGR,iBAAiB,CAACK,OAAO,CAACI,GAAG,CAACN,IAAI,CAAC,IAAI,IAAIW,GAAG,CAAC,CAAC;IAClEN,SAAS,CAACO,GAAG,CAACJ,QAAQ,CAAC;IACvBX,iBAAiB,CAACK,OAAO,CAACC,GAAG,CAACH,IAAI,EAAEK,SAAS,CAAC;EAChD,CAAC,EACD,EACF,CAAC;EACD,MAAMQ,uBAAuB,GAAG,IAAAd,kBAAW,EACzC,CAACC,IAAY,EAAEQ,QAAoB,KAAK;IACtC,MAAMH,SAAS,GAAGR,iBAAiB,CAACK,OAAO,CAACI,GAAG,CAACN,IAAI,CAAC;IACrD,IAAIK,SAAS,EAAE;MACbA,SAAS,CAACD,MAAM,CAACI,QAAQ,CAAC;MAC1B,IAAIH,SAAS,CAACS,IAAI,KAAK,CAAC,EAAE;QACxBjB,iBAAiB,CAACK,OAAO,CAACE,MAAM,CAACJ,IAAI,CAAC;MACxC;IACF;EACF,CAAC,EACD,EACF,CAAC;EAED,MAAMe,KAAK,GAAG,IAAAC,cAAO,EACnB,OAAO;IACLlB,YAAY;IACZW,OAAO;IACPC,qBAAqB;IACrBG;EACF,CAAC,CAAC,EACF,CAACf,YAAY,EAAEW,OAAO,EAAEC,qBAAqB,EAAEG,uBAAuB,CACxE,CAAC;EAED,oBACE,IAAAtB,WAAA,CAAA0B,GAAA,EAAC3B,eAAA,CAAA4B,qBAAqB,CAACC,QAAQ;IAACJ,KAAK,EAAEA,KAAM;IAAAtB,QAAA,EAC1CA;EAAQ,CACqB,CAAC;AAErC","ignoreList":[]}

package/lib/commonjs/teleport/PortalProviderView.native.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = PortalProvider;
+/**
+ * COPIED FROM react-native-teleport 1.2.0 — `src/views/PortalProvider/index.native.tsx`
+ * MIT, Copyright (c) 2025 Kiryl Ziusko. Full licence in `NOTICE` at the root.
+ *
+ * Changed: nothing — byte-for-byte, only its path.
+ */
+
+function PortalProvider({
+  children
+}) {
+  return children;
+}
+//# sourceMappingURL=PortalProviderView.native.js.map

package/lib/commonjs/teleport/PortalProviderView.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PortalProvider","children"],"sourceRoot":"../../../src","sources":["teleport/PortalProviderView.native.tsx"],"mappings":";;;;;;AAAA;AACA;AACA;AACA;AACA;AACA;;AAGe,SAASA,cAAcA,CAAC;EAAEC;AAA8B,CAAC,EAAE;EACxE,OAAOA,QAAQ;AACjB","ignoreList":[]}

package/lib/commonjs/teleport/PortalView.js

@@ -0,0 +1,83 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = Portal;
+var _react = require("react");
+var _reactDom = require("react-dom");
+var _portalRegistry = require("./portal-registry.js");
+var _jsxRuntime = require("react/jsx-runtime");
+/**
+ * COPIED FROM react-native-teleport 1.2.0 — `src/views/Portal/index.tsx`
+ * MIT, Copyright (c) 2025 Kiryl Ziusko. Full licence in `NOTICE` at the root.
+ *
+ * Changed: import paths only, for this flat directory.
+ */
+/// <reference lib="dom" />
+
+const supportsMoveBefore = typeof Element !== "undefined" && "moveBefore" in Element.prototype;
+function moveElementTo(parent, child, before = null) {
+  if (supportsMoveBefore && child.parentNode) {
+    parent.moveBefore(child, before);
+    return;
+  }
+  if (child.parentNode) {
+    child.parentNode.removeChild(child);
+  }
+  parent.insertBefore(child, before);
+}
+function Portal({
+  hostName,
+  children,
+  style
+}) {
+  const {
+    getHost,
+    registerPendingPortal,
+    unregisterPendingPortal
+  } = (0, _portalRegistry.usePortalRegistryContext)();
+  const elRef = (0, _react.useRef)(null);
+  if (!elRef.current) {
+    elRef.current = document.createElement("div");
+  }
+  const sentinelRef = (0, _react.useRef)(null);
+  (0, _react.useLayoutEffect)(() => {
+    if (elRef.current && style) {
+      Object.assign(elRef.current.style, style);
+    }
+  }, [style]);
+  const teleportToHost = (0, _react.useCallback)(() => {
+    const el = elRef.current;
+    if (!el) return;
+    const hostNode = hostName ? getHost(hostName) : null;
+    if (hostNode) {
+      // teleport view to the host
+      moveElementTo(hostNode, el);
+    } else if (sentinelRef.current && sentinelRef.current.parentElement) {
+      // keep view locally
+      const parent = sentinelRef.current.parentElement;
+      moveElementTo(parent, el, sentinelRef.current);
+    }
+  }, [hostName, getHost]);
+  (0, _react.useLayoutEffect)(() => {
+    teleportToHost();
+    if (!hostName) return;
+    registerPendingPortal(hostName, teleportToHost);
+    return () => {
+      unregisterPendingPortal(hostName, teleportToHost);
+    };
+  }, [hostName, registerPendingPortal, unregisterPendingPortal, teleportToHost]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [/*#__PURE__*/(0, _reactDom.createPortal)(children, elRef.current), /*#__PURE__*/(0, _jsxRuntime.jsx)("div", {
+      ref: sentinelRef,
+      style: styles.anchor
+    })]
+  });
+}
+const styles = {
+  anchor: {
+    display: "contents"
+  }
+};
+//# sourceMappingURL=PortalView.js.map

package/lib/commonjs/teleport/PortalView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_reactDom","_portalRegistry","_jsxRuntime","supportsMoveBefore","Element","prototype","moveElementTo","parent","child","before","parentNode","moveBefore","removeChild","insertBefore","Portal","hostName","children","style","getHost","registerPendingPortal","unregisterPendingPortal","usePortalRegistryContext","elRef","useRef","current","document","createElement","sentinelRef","useLayoutEffect","Object","assign","teleportToHost","useCallback","el","hostNode","parentElement","jsxs","Fragment","createPortal","jsx","ref","styles","anchor","display"],"sourceRoot":"../../../src","sources":["teleport/PortalView.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/teleport/PortalView.native.js

@@ -0,0 +1,14 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _PortalViewNativeComponent.default;
+  }
+});
+var _PortalViewNativeComponent = _interopRequireDefault(require("./specs/PortalViewNativeComponent.js"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+//# sourceMappingURL=PortalView.native.js.map

package/lib/commonjs/teleport/PortalView.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_PortalViewNativeComponent","_interopRequireDefault","require","e","__esModule","default"],"sourceRoot":"../../../src","sources":["teleport/PortalView.native.tsx"],"mappings":";;;;;;;;;;;AAMA,IAAAA,0BAAA,GAAAC,sBAAA,CAAAC,OAAA;AAA4D,SAAAD,uBAAAE,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}

package/lib/commonjs/teleport/index.js

@@ -0,0 +1,35 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "Portal", {
+  enumerable: true,
+  get: function () {
+    return _Portal.default;
+  }
+});
+Object.defineProperty(exports, "PortalHost", {
+  enumerable: true,
+  get: function () {
+    return _PortalHost.default;
+  }
+});
+Object.defineProperty(exports, "PortalProvider", {
+  enumerable: true,
+  get: function () {
+    return _PortalProvider.default;
+  }
+});
+Object.defineProperty(exports, "usePortal", {
+  enumerable: true,
+  get: function () {
+    return _usePortal.default;
+  }
+});
+var _PortalHost = _interopRequireDefault(require("./PortalHost.js"));
+var _Portal = _interopRequireDefault(require("./Portal.js"));
+var _PortalProvider = _interopRequireDefault(require("./PortalProvider.js"));
+var _usePortal = _interopRequireDefault(require("./use-portal.js"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+//# sourceMappingURL=index.js.map

package/lib/commonjs/teleport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_PortalHost","_interopRequireDefault","require","_Portal","_PortalProvider","_usePortal","e","__esModule","default"],"sourceRoot":"../../../src","sources":["teleport/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBA,IAAAA,WAAA,GAAAC,sBAAA,CAAAC,OAAA;AACA,IAAAC,OAAA,GAAAF,sBAAA,CAAAC,OAAA;AACA,IAAAE,eAAA,GAAAH,sBAAA,CAAAC,OAAA;AACA,IAAAG,UAAA,GAAAJ,sBAAA,CAAAC,OAAA;AAAoD,SAAAD,uBAAAK,CAAA,WAAAA,CAAA,IAAAA,CAAA,CAAAC,UAAA,GAAAD,CAAA,KAAAE,OAAA,EAAAF,CAAA","ignoreList":[]}