bippy 0.6.0 → 0.6.1-dev.03b829a

package/LICENSE

@@ -1,4 +1,4 @@
-Copyright 2024 Aiden Bai
+Copyright 2024-present Aiden Bai
 
 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:
 

package/README.md

@@ -1,7 +1,7 @@
 > [!WARNING]
 > ⚠️⚠️⚠️ **this project may break production apps and cause unexpected behavior** ⚠️⚠️⚠️
 >
-> this project uses react internals, which can change at any time. it is not recommended to depend on internals unless you really, _really_ have to. by proceeding, you acknowledge the risk of breaking your own code or apps that use your code.
+> this project uses react internals, which can change at any time. we don't recommend depending on internals unless you really, _really_ have to. by proceeding, you acknowledge the risk of breaking your own code or apps that use your code.
 
 # <img src="https://github.com/aidenybai/bippy/blob/main/.github/public/bippy.png?raw=true" width="60" align="center" /> bippy
 
@@ -10,17 +10,17 @@
 
 bippy is a toolkit to **hack into react internals**
 
-by default, you cannot access react internals. bippy bypasses this by "pretending" to be react devtools, giving you access to the fiber tree and other internals.
+by default, you cannot access react internals. bippy bypasses this by “pretending” to be react devtools, giving you access to the fiber tree and other internals.
 
-- works outside of react – no react code modification needed
+- works outside of react: no react code modification needed
 - utility functions that work across modern react (v17-19)
 - no prior react source code knowledge required
 
 ```jsx
-import { onCommitFiberRoot, traverseFiber } from "bippy"; // must be imported BEFORE react
+import { instrument, traverseFiber } from "bippy"; // must be imported BEFORE react
 
 instrument({
-  onCommitFiberRoot: (root) => {
+  onCommitFiberRoot(rendererID, root) {
     traverseFiber(root.current, (fiber) => {
       // prints every fiber in the current React tree
       console.log("fiber:", fiber);
@@ -33,7 +33,7 @@ instrument({
 
 bippy allows you to **access** and **use** react fibers **outside** of react components.
 
-a react fiber is a "unit of execution." this means react will do something based on the data in a fiber. each fiber either represents a composite (function/class component) or a host (dom element).
+a react fiber is a “unit of execution.” this means react will do something based on the data in a fiber. each fiber either represents a composite (function/class component) or a host (dom element).
 
 > here is a [live visualization](https://jser.pro/ddir/rie?reactVersion=18.3.1&snippetKey=hq8jm2ylzb9u8eh468) of what the fiber tree looks like, and here is a [deep dive article](https://jser.dev/2023-07-18-how-react-rerenders/).
 
@@ -74,14 +74,14 @@ here, the `child`, `sibling`, and `return` properties are pointers to other fibe
 
 additionally, `memoizedProps`, `memoizedState`, and `dependencies` are the fiber's props, state, and contexts.
 
-while all of the information is there, it's not super easy to work with, and changes frequently across different versions of react. bippy simplifies this by providing utility functions like:
+while all of the information is there, it's awkward to work with, and changes frequently across different versions of react. bippy simplifies this by providing utility functions like:
 
 - `traverseRenderedFibers` to detect renders and `traverseFiber` to traverse the overall fiber tree
   - _(instead of `child`, `sibling`, and `return` pointers)_
 - `traverseProps`, `traverseState`, and `traverseContexts` to traverse the fiber's props, state, and contexts
   - _(instead of `memoizedProps`, `memoizedState`, and `dependencies`)_
 
-however, fibers aren't directly accessible by the user. so, we have to hack our way around to accessing it.
+however, react doesn't expose fibers to you directly. so, we have to hack our way around to access them.
 
 luckily, react [reads from a property](https://github.com/facebook/react/blob/6a4b46cd70d2672bc4be59dcb5b8dede22ed0cef/packages/react-reconciler/src/ReactFiberDevToolsHook.js#L48) in the window object: `window.__REACT_DEVTOOLS_GLOBAL_HOOK__` and runs handlers on it when certain events happen. this property must exist before react's bundle is executed. this is intended for react devtools, but we can use it to our advantage.
 
@@ -107,9 +107,7 @@ interface __REACT_DEVTOOLS_GLOBAL_HOOK__ {
 bippy works by monkey-patching `window.__REACT_DEVTOOLS_GLOBAL_HOOK__` with our own custom handlers. bippy simplifies this by providing utility functions like:
 
 - `instrument` to safely patch `window.__REACT_DEVTOOLS_GLOBAL_HOOK__`
-  - _(instead of directly mutating `onCommitFiberRoot`, ...)_
-- `secure` to wrap your handlers in a try/catch and determine if handlers are safe to run
-  - _(instead of rawdogging `window.__REACT_DEVTOOLS_GLOBAL_HOOK__` handlers, which may crash your app)_
+  - _(instead of directly mutating `onCommitFiberRoot`, …)_
 - `traverseRenderedFibers` to traverse the fiber tree and determine which fibers have actually rendered
   - _(instead of `child`, `sibling`, and `return` pointers)_
 - `traverseFiber` to traverse the fiber tree, regardless of whether it has rendered
@@ -121,13 +119,13 @@ bippy works by monkey-patching `window.__REACT_DEVTOOLS_GLOBAL_HOOK__` with our
 
 we recommend installing via npm.
 
-this package should be imported before a React app runs. this will add a special object to the global which is used by React for providing its internals to the tool for analysis (React Devtools does the same). as soon as React library is loaded and attached to the tool, bippy starts collecting data about what is going on in React's internals.
+import this package before your react app runs. it adds a special object to the global scope that react reports its internals to (react devtools uses the same mechanism). as soon as react loads and attaches, bippy starts collecting data about what is going on in react's internals.
 
 ```shell
 npm install bippy
 ```
 
-since bippy needs to be imported before react, some bundlers require specific configuration to ensure the correct import order.
+since bippy must load before react, some bundlers need specific configuration to get the import order right.
 
 ### next.js
 
@@ -153,9 +151,9 @@ import { createRoot } from "react-dom/client";
 // ... rest of your code
 ```
 
-the import order is critical: bippy must be imported before any react packages.
+the import order is critical: import bippy before any react packages.
 
-> **note for library maintainers**: if you're building a library and want to define your own utility functions while minimizing bundle size, you can use `bippy/install-hook-only` (~90 bytes) instead of the main `bippy` export. this only installs the react devtools hook without importing any utility functions, allowing you to import only what you need from `bippy/core` or define your own fiber utilities. that said, the full `bippy` package is only ~4kb gzipped, so bundle size is rarely a concern.
+> **note for library maintainers**: if you're building a library and want to define your own utility functions while minimizing bundle size, you can use `bippy/install-hook-only` (~90 bytes) instead of the main `bippy` export. this only installs the react devtools hook without importing any utility functions, allowing you to import only what you need from `bippy/core` or define your own fiber utilities. that said, the full `bippy` package is only ~4 KB gzipped, so bundle size is rarely a concern.
 
 > ```typescript
 > import "bippy/install-hook-only"; // only installs the hook
@@ -170,29 +168,32 @@ the import order is critical: bippy must be imported before any react packages.
 
 ### instrument
 
-patches `window.__REACT_DEVTOOLS_GLOBAL_HOOK__` with your handlers. must be imported before react, and must be initialized to properly run any other methods.
+patches `window.__REACT_DEVTOOLS_GLOBAL_HOOK__` with your handlers. import bippy before react, and call `instrument` before any other methods.
 
-> use with the `secure` function to prevent uncaught errors from crashing your app.
+bippy patches each hook event once and dispatches it to a set of listeners, so multiple `instrument` calls compose instead of replacing each other. `instrument` returns an unsubscribe function that removes exactly the handlers you registered (also a `Disposable`, so it works with `using`).
 
 ```typescript
-import { instrument, secure } from "bippy"; // must be imported BEFORE react
+import { instrument } from "bippy"; // must be imported BEFORE react
 import * as React from "react";
 
-instrument(
-  secure({
-    onCommitFiberRoot(rendererID, root) {
-      console.log("root ready to commit", root);
-    },
-    onPostCommitFiberRoot(rendererID, root) {
-      console.log("root with effects committed", root);
-    },
-    onCommitFiberUnmount(rendererID, fiber) {
-      console.log("fiber unmounted", fiber);
-    },
-  }),
-);
+const unsubscribe = instrument({
+  onCommitFiberRoot(rendererID, root) {
+    console.log("root ready to commit", root);
+  },
+  onPostCommitFiberRoot(rendererID, root) {
+    console.log("root with effects committed", root);
+  },
+  onCommitFiberUnmount(rendererID, fiber) {
+    console.log("fiber unmounted", fiber);
+  },
+});
+
+// later, stop listening (other instrument() subscribers keep working)
+unsubscribe();
 ```
 
+instrumentation, React DevTools, and hook-listener failures propagate unchanged. callback dispatch stops at the failure so the caller controls error handling. failures created by bippy, such as unsupported hooks and source-map timeouts, use the exported `BippyError` subclasses.
+
 ### getRDTHook
 
 returns the `window.__REACT_DEVTOOLS_GLOBAL_HOOK__` object. great for advanced use cases, such as accessing or modifying the `renderers` property.
@@ -209,18 +210,16 @@ console.log(hook);
 not every fiber in the fiber tree renders. `traverseRenderedFibers` allows you to traverse the fiber tree and determine which fibers have actually rendered.
 
 ```typescript
-import { instrument, secure, traverseRenderedFibers } from "bippy"; // must be imported BEFORE react
+import { instrument, traverseRenderedFibers } from "bippy"; // must be imported BEFORE react
 import * as React from "react";
 
-instrument(
-  secure({
-    onCommitFiberRoot(rendererID, root) {
-      traverseRenderedFibers(root, (fiber) => {
-        console.log("fiber rendered", fiber);
-      });
-    },
-  }),
-);
+instrument({
+  onCommitFiberRoot(rendererID, root) {
+    traverseRenderedFibers(root, (fiber) => {
+      console.log("fiber rendered", fiber);
+    });
+  },
+});
 ```
 
 ### traverseFiber
@@ -228,18 +227,16 @@ instrument(
 calls a callback on every fiber in the fiber tree.
 
 ```typescript
-import { instrument, secure, traverseFiber } from "bippy"; // must be imported BEFORE react
+import { instrument, traverseFiber } from "bippy"; // must be imported BEFORE react
 import * as React from "react";
 
-instrument(
-  secure({
-    onCommitFiberRoot(rendererID, root) {
-      traverseFiber(root.current, (fiber) => {
-        console.log(fiber);
-      });
-    },
-  }),
-);
+instrument({
+  onCommitFiberRoot(rendererID, root) {
+    traverseFiber(root.current, (fiber) => {
+      console.log(fiber);
+    });
+  },
+});
 ```
 
 ### traverseProps
@@ -342,16 +339,14 @@ import { memo } from "react";
 const RealComponent = () => {
   return <div>hello</div>;
 };
-const MemoizedComponent = memo(() => {
-  return <div>hello</div>;
-});
+const MemoizedComponent = memo(RealComponent);
 
 console.log(getType(fiberForMemoizedComponent) === RealComponent);
 ```
 
 ### getNearestHostFiber / getNearestHostFibers
 
-getNearestHostFiber returns the closest host fiber above or below a given fiber. getNearestHostFibers(fiber) returns all host fibers associated with the provided fiber and its subtree.
+`getNearestHostFiber` returns the closest host fiber above or below a given fiber. `getNearestHostFibers` returns all host fibers associated with the provided fiber and its subtree.
 
 ```jsx
 import { getNearestHostFiber, getNearestHostFibers } from "bippy";
@@ -433,28 +428,6 @@ const latestFiber = getLatestFiber(getFiberFromHostInstance(document.querySelect
 console.log(latestFiber);
 ```
 
-### getFiberSource
-
-returns the source code location of a fiber.
-
-```typescript
-import { getFiberSource } from "bippy/source";
-
-const fiber = getFiberFromHostInstance(document.querySelector("div"));
-
-console.log(await getFiberSource(fiber));
-```
-
-> note: in order to get accurate source locations in react >= 19, you need to add this in your `tsconfig.json`:
->
-> ```json
-> {
->   "compilerOptions": {
->     "jsxImportSource": "bippy/dist"
->   }
-> }
-> ```
-
 ### overrideProps
 
 overrides component props at runtime by modifying the fiber's props.
@@ -472,7 +445,7 @@ overrideProps(fiber, {
 });
 ```
 
-the function accepts a fiber and a partial object containing the props to override. nested objects are automatically flattened into property paths.
+the function accepts a fiber and a partial object containing the props to override. bippy automatically flattens nested objects into property paths.
 
 ### overrideHookState
 
@@ -493,7 +466,7 @@ overrideHookState(fiber, 1, {
 });
 ```
 
-the hook id parameter corresponds to the order of hooks in the component (0-indexed). the function can accept either a primitive value or an object for nested state updates.
+the hook id parameter corresponds to the order of hooks in the component (0-indexed). pass either a primitive value or an object for nested state updates.
 
 ### overrideContext
 
@@ -519,26 +492,13 @@ the function traverses up the fiber tree to find the context provider matching t
 
 ### getSource
 
-gets the source code location of a composite fiber.
+gets the source code location of any fiber with development source metadata. resolution is based on fiber debug data and source maps, so it is independent of the renderer's host instances and works with DOM, native, terminal, canvas, PDF, and custom reconcilers.
 
 ```typescript
 import { getSource } from "bippy/source";
 
-// random fiber on the DOM
-const hostFiber = getFiberFromHostInstance(document.querySelector("div"));
-
-// get nearest composite fiber up the tree
-const compositeFiber = traverseFiber(
-  hostFiber,
-  (fiber) => {
-    if (isCompositeFiber(fiber)) {
-      return fiber;
-    }
-  },
-  true,
-);
-
-const source = await getSource(compositeFiber);
+const fiber = getFiberFromHostInstance(hostInstance);
+const source = await getSource(fiber);
 // {
 //   columnNumber: 12,
 //   fileName: 'path/to/file.tsx',
@@ -549,17 +509,38 @@ const source = await getSource(compositeFiber);
 > **caveats:**
 >
 > - only available in dev mode
-> - only works for composite fibers (function/class components)
-> - captures the location where the component is _used_, not where it's _defined_
-> - in react 18, resolves `_debugSource` directly (see [react#31981](https://github.com/facebook/react/issues/31981))
-> - in react >18, `_debugSource` is not available for host fibers
+> - source availability is controlled by react and the renderer; production builds normally remove debug metadata
+> - captures the location where the element is _used_; definition locations are recovered when react exposes an owned child debug stack
+> - react 18 requires `_debugSource` from the JSX source transform (see [react#31981](https://github.com/facebook/react/issues/31981))
+> - react 19 uses `_debugStack` and works for both composite and host fibers
+> - source-map fetching is optional; runtimes without `fetch` still receive the unsymbolicated source location
+
+`getSourceMap` accepts an optional fetch implementation plus request limits, an abort signal, and a timeout. its cache is scoped to the fetch implementation so credentials or virtual file systems cannot leak results into each other.
+
+### getOwnerStack / getParentStack
+
+returns a symbolicated stack of components above a fiber.
+
+`getOwnerStack` walks the chain of components that _created_ this fiber's JSX (react's `_debugOwner` chain), with exact creation-site locations on react 19, including server component owners. wrappers that merely render `{children}` don't appear. it automatically falls back to `getParentStack` when no usable owner frames exist (e.g. react <19).
+
+`getParentStack` walks _all_ ancestors in the render tree (the fiber's `return` chain), including `{children}` wrappers. works on every react version.
+
+```typescript
+import { getOwnerStack, getParentStack } from "bippy/source";
+
+const ownerFrames = await getOwnerStack(fiber);
+// [{ functionName: "Button", fileName: "src/button.tsx", lineNumber: 12, ... }, ...]
+
+const parentFrames = await getParentStack(fiber);
+// includes every wrapper between the fiber and the root
+```
 
 ## example
 
 here's a mini toy version of [`react-scan`](https://github.com/aidenybai/react-scan) that highlights renders in your app.
 
 ```javascript
-import { instrument, secure, getNearestHostFiber, traverseRenderedFibers } from "bippy"; // must be imported BEFORE react
+import { instrument, getNearestHostFiber, traverseRenderedFibers } from "bippy"; // must be imported BEFORE react
 
 const highlightFiber = (fiber) => {
   if (!(fiber.stateNode instanceof HTMLElement)) return;
@@ -583,55 +564,64 @@ const highlightFiber = (fiber) => {
  * `instrument` is a function that installs the react DevTools global
  * hook and allows you to set up custom handlers for react fiber events.
  */
-instrument(
+instrument({
   /**
-   * `secure` is a function that wraps your handlers in a try/catch
-   * and prevents it from crashing the app. it also prevents it from
-   * running on unsupported react versions and during production.
-   *
-   * this is not required but highly recommended to provide "safeguards"
-   * in case something breaks.
+   * `onCommitFiberRoot` is a handler that is called when react is
+   * ready to commit a fiber root. this means that react is has
+   * rendered your entire app and is ready to apply changes to
+   * the host tree (e.g. via DOM mutations).
    */
-  secure({
+  onCommitFiberRoot(rendererID, root) {
     /**
-     * `onCommitFiberRoot` is a handler that is called when react is
-     * ready to commit a fiber root. this means that react is has
-     * rendered your entire app and is ready to apply changes to
-     * the host tree (e.g. via DOM mutations).
+     * `traverseRenderedFibers` traverses the fiber tree and determines which
+     * fibers have actually rendered.
+     *
+     * A fiber tree contains many fibers that may have not rendered. this
+     * can be because it bailed out (e.g. `useMemo`) or because it wasn't
+     * actually rendered (if <Child> re-rendered, then <Parent> didn't
+     * actually render, but exists in the fiber tree).
      */
-    onCommitFiberRoot(rendererID, root) {
+    traverseRenderedFibers(root, (fiber) => {
       /**
-       * `traverseRenderedFibers` traverses the fiber tree and determines which
-       * fibers have actually rendered.
+       * `getNearestHostFiber` is a utility function that finds the
+       * nearest host fiber to a given fiber.
        *
-       * A fiber tree contains many fibers that may have not rendered. this
-       * can be because it bailed out (e.g. `useMemo`) or because it wasn't
-       * actually rendered (if <Child> re-rendered, then <Parent> didn't
-       * actually render, but exists in the fiber tree).
+       * a host fiber for `react-dom` is a fiber that has a DOM element
+       * as its `stateNode`.
        */
-      traverseRenderedFibers(root, (fiber) => {
-        /**
-         * `getNearestHostFiber` is a utility function that finds the
-         * nearest host fiber to a given fiber.
-         *
-         * a host fiber for `react-dom` is a fiber that has a DOM element
-         * as its `stateNode`.
-         */
-        const hostFiber = getNearestHostFiber(fiber);
-        highlightFiber(hostFiber);
-      });
-    },
-  }),
-);
+      const hostFiber = getNearestHostFiber(fiber);
+      highlightFiber(hostFiber);
+    });
+  },
+});
 ```
 
+## renderer support
+
+bippy observes renderers through the React DevTools global hook. a renderer is automatically supported when it injects its reconciler and forwards commits to that hook.
+
+| level         | renderers                                        | coverage                                                                                                                |
+| ------------- | ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------- |
+| automatic     | React DOM, Remotion                              | unit matrix and browser e2e                                                                                             |
+| automatic     | React Native Fabric, React Native Skia           | iOS and Android Detox e2e                                                                                               |
+| automatic     | React Three Fiber, Ink, react-nil                | unit matrix                                                                                                             |
+| automatic     | `@opentui/react`, `@pixi/react`, React BabylonJS | unit matrix with non-DOM host instances                                                                                 |
+| compatibility | `@react-pdf/renderer`                            | its real reconciler root is forwarded through a synthetic DevTools hook bridge because react-pdf does not inject itself |
+| compatibility | React Konva                                      | its exported reconciler is injected by a test bridge because upstream automatic injection is disabled                   |
+
+compatibility entries are not zero-config support claims. the bridge implementations in [`packages/bippy/tests/renderer-adapters.tsx`](packages/bippy/tests/renderer-adapters.tsx) verify bippy's fiber APIs against the real host trees while keeping the missing upstream DevTools integration explicit. React Native Windows, macOS, and NativeScript are not currently asserted.
+
+terminal renderers must load bippy before their reconciler initializes. importing `bippy` first works in Node and Bun; `bippy/install-hook-only` is also available as a minimal prelude when application import order is controlled elsewhere. the test suite verifies OpenTUI in clean Node and Bun processes and verifies that Ink can replace the hook with full React DevTools without losing either renderer.
+
+`@testing-library/react` is a React DOM testing utility, not a renderer. bippy uses it throughout the test suite, including hydration, event-driven updates, portals, unmounts, and error-boundary recovery.
+
 ## glossary
 
-- fiber: a "unit of execution" in react, representing a component or dom element
+- fiber: a “unit of execution” in react, representing a component or dom element
 - commit: the process of applying changes to the host tree (e.g. DOM mutations)
 - render: the process of building the fiber tree by executing component function/classes
 - host tree: the tree of UI elements that react mutates (e.g. DOM elements)
-- reconciler (or "renderer"): custom bindings for react, e.g. react-dom, react-native, react-three-fiber, etc to mutate the host tree
+- reconciler (or “renderer”): custom bindings for react, e.g. react-dom, react-native, react-three-fiber, etc to mutate the host tree
 - `rendererID`: the id of the reconciler, starting at 1 (can be from multiple reconciler instances)
 - `root`: a special `FiberRoot` type that contains the container fiber (the one you pass to `ReactDOM.createRoot`) in the `current` property
 - `onCommitFiberRoot`: called when react is ready to commit a fiber root
@@ -640,7 +630,7 @@ instrument(
 
 ## misc
 
-bippy was initially created for [react-scan](https://github.com/aidenybai/react-scan), which is deployed with proper safeguards to ensure it's only used in development or error-guarded in production.
+we initially created bippy for [react-scan](https://github.com/aidenybai/react-scan), which ships with safeguards so it only runs in development or error-guarded in production.
 
 if you're seeking more robust solutions, you might consider [its-fine](https://github.com/pmndrs/its-fine) for accessing fibers within react using hooks, or [react-devtools-inline](https://www.npmjs.com/package/react-devtools-inline) for a headful interface.
 

package/dist/core.cjs

@@ -6,4 +6,4 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./rdt-hook.cjs`),t=60111,n=`Symbol(react.concurrent_mode)`,r=`Symbol(react.async_mode)`,i=13366,a=e=>typeof e==`object`&&!!e&&`$$typeof`in e&&[`Symbol(react.element)`,`Symbol(react.transitional.element)`].includes(String(e.$$typeof)),o=e=>typeof e==`object`&&!!e&&`tag`in e&&`stateNode`in e&&`return`in e&&`child`in e&&`sibling`in e&&`flags`in e,s=e=>{switch(e.tag){case 5:case 26:case 27:return!0;default:return typeof e.type==`string`}},c=e=>{switch(e.tag){case 1:case 11:case 0:case 14:case 15:return!0;default:return!1}},l=e=>!e||typeof e!=`object`?!1:`pendingProps`in e&&!(`containerInfo`in e),ee=(e,t)=>{try{let n=e.dependencies,r=e.alternate?.dependencies;if(!n||!r||typeof n!=`object`||!(`firstContext`in n)||typeof r!=`object`||!(`firstContext`in r))return!1;let i=n.firstContext,a=r.firstContext;for(;i&&typeof i==`object`&&`memoizedValue`in i||a&&typeof a==`object`&&`memoizedValue`in a;){if(t(i,a)===!0)return!0;i=i?.next,a=a?.next}}catch{}return!1},u=(e,t)=>{try{let n=e.memoizedState,r=e.alternate?.memoizedState;for(;n||r;){if(t(n,r)===!0)return!0;n=n?.next,r=r?.next}}catch{}return!1},d=(e,t)=>{try{let n=e.memoizedProps,r=e.alternate?.memoizedProps||{};for(let e of Object.keys(n))if(t(e,n[e],r[e])===!0)return!0;for(let e of Object.keys(r))if(!(e in n)&&t(e,n[e],r[e])===!0)return!0}catch{}return!1},f=e=>{let t=e.memoizedProps,n=e.alternate?.memoizedProps||{},r=e.flags??e.effectTag??0;switch(e.tag){case 1:case 9:case 11:case 0:case 14:case 15:return(r&1)==1;default:return e.alternate?n!==t||e.alternate.memoizedState!==e.memoizedState||e.alternate.ref!==e.ref:!0}},p=e=>!!(e.flags&(i|8)||e.subtreeFlags&(i|8)),te=e=>{let t=[],n=[e];for(;n.length;){let e=n.pop();e&&(s(e)&&p(e)&&f(e)&&t.push(e),e.child&&n.push(e.child),e.sibling&&n.push(e.sibling))}return t},ne=e=>{let t=[],n=e;for(;n.return;)t.push(n),n=n.return;return t},m=e=>{switch(e.tag){case 18:return!0;case 7:case 6:case 23:case 22:return!0;case 3:return!1;default:{let i=typeof e.type==`object`&&e.type!==null?e.type.$$typeof:e.type;if(typeof i==`symbol`)return i.description===`react.concurrent_mode`||i.description===`react.async_mode`;switch(i){case t:case n:case r:return!0;default:return!1}}}},h=(e,t=!1)=>{let n=_(e,s,t);return n||=_(e,s,!t),n},g=e=>{let t=[],n=[];for(s(e)?t.push(e):e.child&&n.push(e.child);n.length;){let e=n.pop();if(!e)break;s(e)?t.push(e):e.child&&n.push(e.child),e.sibling&&n.push(e.sibling)}return t};function _(e,t,n=!1){if(!e)return null;let r=t(e);if(r instanceof Promise)return(async()=>{if(await r===!0)return e;let i=n?e.return:e.child;for(;i;){let e=await y(i,t,n);if(e)return e;i=n?null:i.sibling}return null})();if(r===!0)return e;let i=n?e.return:e.child;for(;i;){let e=v(i,t,n);if(e)return e;i=n?null:i.sibling}return null}const v=(e,t,n=!1)=>{if(!e)return null;if(t(e)===!0)return e;let r=n?e.return:e.child;for(;r;){let e=v(r,t,n);if(e)return e;r=n?null:r.sibling}return null},y=async(e,t,n=!1)=>{if(!e)return null;if(await t(e)===!0)return e;let r=n?e.return:e.child;for(;r;){let e=await y(r,t,n);if(e)return e;r=n?null:r.sibling}return null},b=e=>{let t=e?.actualDuration??0,n=t,r=e?.child??null;for(;t>0&&r!=null;)n-=r.actualDuration??0,r=r.sibling;return{selfTime:n,totalTime:t}},x=e=>!!e.updateQueue?.memoCache,S=e=>{let t=e;return typeof t==`function`?t:typeof t==`object`&&t?S(t.type||t.render):null},re=e=>{let t=e;if(typeof t==`string`)return t;if(typeof t!=`function`&&!(typeof t==`object`&&t))return null;let n=t.displayName||t.name||null;if(n)return n;let r=S(t);return r&&(r.displayName||r.name)||null},ie=e=>{try{if(typeof e.version==`string`&&e.bundleType>0)return`development`}catch{}return`production`},ae=()=>{let t=globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;return!!t?._instrumentationIsActive||e.l(t)||e.c(t)},C=new Set,w=e=>{let t=e.alternate;if(!t)return e;if(t.actualStartTime&&e.actualStartTime)return t.actualStartTime>e.actualStartTime?t:e;for(let t of C){let n=_(t.current,t=>{if(t===e)return!0});if(n)return n}return e};let T=0;const E=new WeakMap,D=(e,t=T++)=>{E.set(e,t)},O=e=>{let t=E.get(e);return!t&&e.alternate&&(t=E.get(e.alternate)),t||(t=T++,D(e,t)),t},k=(e,t,n)=>{let r=t;for(;r!=null;){if(E.has(r)||O(r),!m(r)&&f(r)&&e(r,`mount`),r.tag===13)if(r.memoizedState!==null){let t=r.child,n=t?t.sibling:null;if(n){let t=n.child;t!==null&&k(e,t,!1)}}else{let t=null;r.child!==null&&(t=r.child.child),t!==null&&k(e,t,!1)}else r.child!=null&&k(e,r.child,!0);r=n?r.sibling:null}},A=(e,t,n,r)=>{if(E.has(t)||O(t),!n)return;E.has(n)||O(n);let i=t.tag===13,a=!m(t);a&&f(t)&&e(t,`update`);let o=i&&n.memoizedState!==null,s=i&&t.memoizedState!==null;if(o&&s){let r=t.child?.sibling??null,i=n.child?.sibling??null;r!==null&&i!==null&&A(e,r,i,t)}else if(o&&!s){let n=t.child;n!==null&&k(e,n,!0)}else if(!o&&s){M(e,n);let r=t.child?.sibling??null;r!==null&&k(e,r,!0)}else if(t.child!==n.child){let n=t.child;for(;n;){if(n.alternate){let i=n.alternate;A(e,n,i,a?t:r)}else k(e,n,!1);n=n.sibling}}},j=(e,t)=>{(t.tag===3||!m(t))&&e(t,`unmount`)},M=(e,t)=>{let n=t.tag===13&&t.memoizedState!==null,r=t.child;for(n&&(r=(t.child?.sibling??null)?.child??null);r!==null;)r.return!==null&&(j(e,r),M(e,r)),r=r.sibling};let oe=0;const N=new WeakMap,se=(e,t)=>{let n=`current`in e?e.current:e,r=N.get(e);r||(r={id:oe++,prevFiber:null},N.set(e,r));let{prevFiber:i}=r;if(!n)j(t,n);else if(i!==null){let e=i&&i.memoizedState!=null&&i.memoizedState.element!=null&&i.memoizedState.isDehydrated!==!0,r=n.memoizedState!=null&&n.memoizedState.element!=null&&n.memoizedState.isDehydrated!==!0;!e&&r?k(t,n,!1):e&&r?A(t,n,n.alternate,null):e&&!r&&j(t,n)}else k(t,n,!0);r.prevFiber=n},P=new Set;let F=!1;const I=()=>{if(F||!e.a())return;let t=e.i();if(t?.renderers){F=!0,Q(t);for(let e of t.renderers.values())P.add(e);e.u(e=>{P.add(e)})}},L=t=>{if(!e.a())return null;let n=t;for(;n.return;)n=n.return;let r=Z.get(n.stateNode);return r===void 0?null:e.i().renderers?.get(r)??null},R=e=>{I();let t=L(e);return t?[t]:Array.from(P)},z=(e,t,n,r)=>{for(let i of e)try{i.overrideProps?.(t,n,r)}catch{}},B=(e,t)=>{let n=e.memoizedState;for(let e=0;e<t;e++){if(!n?.next)return null;n=n.next}let r=n?.queue;return H(r)&&typeof r.dispatch==`function`?r.dispatch:null},V=(e,t)=>{let n=e;for(;n;){let e=n.type;if(e===t||e?.Provider===t)return n;n=n.return}return null},H=e=>Object.prototype.toString.call(e)===`[object Object]`&&(Object.getPrototypeOf(e)===Object.prototype||Object.getPrototypeOf(e)===null),U=(e,t=[])=>{if(!H(e))return[{path:t,value:e}];let n=[];for(let r in e){let i=e[r],a=t.concat(r);H(i)?n.push(...U(i,a)):n.push({path:a,value:i})}return n},W=e=>H(e)?U(e):[{path:[],value:e}],G=(e,t)=>{let n=R(e);for(let{path:r,value:i}of W(t))z(n,e,r,i)},ce=(e,t,n)=>{let r=R(e).filter(e=>!!e.overrideHookState),i=W(n);if(r.length>0){let n=String(t);for(let t of r)for(let{path:r,value:a}of i)try{t.overrideHookState?.(e,n,r,a)}catch{}return}if(H(n))return;let a=B(e,t);if(a)try{a(n)}catch{}},le=(e,t,n)=>{let r=V(e,t);if(!r)return;let i=R(r);for(let{path:e,value:t}of W(n))z(i,r,[`value`,...e],t),r.alternate&&z(i,r.alternate,[`value`,...e],t)},K=new Set,q=new Set,J=new Set,Y=new Set,X=new WeakMap,Z=new WeakMap,Q=e=>{let t=X.get(e)??{};if(X.set(e,t),!t.onCommitFiberRoot||e.onCommitFiberRoot!==t.onCommitFiberRoot){let n=e.onCommitFiberRoot,r=(t,i,a)=>{if(n?.(t,i,a),X.get(e)?.onCommitFiberRoot===r){C.add(i),Z.set(i,t);for(let e of K)e(t,i,a)}};t.onCommitFiberRoot=r,e.onCommitFiberRoot=r}if(!t.onCommitFiberUnmount||e.onCommitFiberUnmount!==t.onCommitFiberUnmount){let n=e.onCommitFiberUnmount,r=(t,i)=>{if(n?.(t,i),X.get(e)?.onCommitFiberUnmount===r)for(let e of q)e(t,i)};t.onCommitFiberUnmount=r,e.onCommitFiberUnmount=r}if(!t.onPostCommitFiberRoot||e.onPostCommitFiberRoot!==t.onPostCommitFiberRoot){let n=e.onPostCommitFiberRoot,r=(t,i)=>{if(n?.(t,i),X.get(e)?.onPostCommitFiberRoot===r)for(let e of J)e(t,i)};t.onPostCommitFiberRoot=r,e.onPostCommitFiberRoot=r}if(!t.onScheduleFiberRoot||e.onScheduleFiberRoot!==t.onScheduleFiberRoot){let n=e.onScheduleFiberRoot,r=(t,i,a)=>{if(n?.(t,i,a),X.get(e)?.onScheduleFiberRoot===r)for(let e of Y)e(t,i,a)};t.onScheduleFiberRoot=r,e.onScheduleFiberRoot=r}},ue=t=>{let n=e.i(t.onActive);n._instrumentationSource=t.name??e.t,Q(n);let{onActive:r,onCommitFiberRoot:i,onCommitFiberUnmount:a,onPostCommitFiberRoot:o,onScheduleFiberRoot:s}=t;return i&&K.add(i),a&&q.add(a),o&&J.add(o),s&&Y.add(s),e.m(()=>{r&&e.n.delete(r),i&&K.delete(i),a&&q.delete(a),o&&J.delete(o),s&&Y.delete(s)})},$=new Set,de=e=>e.startsWith(`__reactContainer$`)||e.startsWith(`__reactInternalInstance$`)||e.startsWith(`__reactFiber`),fe=e=>{let t=globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;if(t?.renderers)for(let n of t.renderers.values())try{let t=n.findFiberByHostInstance?.(e);if(t)return t}catch{}if(typeof e==`object`&&e){if(`_reactRootContainer`in e)return e._reactRootContainer?._internalRoot?.current?.child;let t=e.__internalInstanceHandle??e._internalInstanceHandle;if(l(t))return t;let n=e;for(let e of $){let t=n[e];if(t)return t}for(let e of Object.keys(n))if(de(e))return $.add(e),n[e]||null}return null};exports.ActivityComponentTag=28,exports.BIPPY_INSTRUMENTATION_STRING=e.t,exports.CONCURRENT_MODE_NUMBER=t,exports.CONCURRENT_MODE_SYMBOL_DESCRIPTION=`react.concurrent_mode`,exports.CONCURRENT_MODE_SYMBOL_STRING=n,exports.ClassComponentTag=1,exports.ContextConsumerTag=9,exports.DEPRECATED_ASYNC_MODE_SYMBOL_DESCRIPTION=`react.async_mode`,exports.DEPRECATED_ASYNC_MODE_SYMBOL_STRING=r,exports.DehydratedSuspenseComponentTag=18,exports.ELEMENT_TYPE_SYMBOL_STRING=`Symbol(react.element)`,exports.ForwardRefTag=11,exports.FragmentTag=7,exports.FunctionComponentTag=0,exports.HostComponentTag=5,exports.HostHoistableTag=26,exports.HostPortalTag=4,exports.HostRootTag=3,exports.HostSingletonTag=27,exports.HostTextTag=6,exports.LazyComponentTag=16,exports.LegacyHiddenComponentTag=23,exports.MemoComponentTag=14,exports.OffscreenComponentTag=22,exports.SimpleMemoComponentTag=15,exports.SuspenseComponentTag=13,exports.SuspenseListComponentTag=19,exports.TRANSITIONAL_ELEMENT_TYPE_SYMBOL_STRING=`Symbol(react.transitional.element)`,exports.ViewTransitionComponentTag=30,exports._fiberRoots=C,exports._onActiveListeners=e.n,exports._renderers=e.r,exports.detectReactBuildType=ie,exports.didFiberCommit=p,exports.didFiberRender=f,exports.getDisplayName=re,exports.getFiberFromHostInstance=fe,exports.getFiberId=O,exports.getFiberStack=ne,exports.getLatestFiber=w,exports.getMutatedHostFibers=te,exports.getNearestHostFiber=h,exports.getNearestHostFibers=g,exports.getRDTHook=e.i,exports.getTimings=b,exports.getType=S,exports.hasMemoCache=x,exports.hasRDTHook=e.a,exports.installRDTHook=e.o,exports.instrument=ue,exports.isClientEnvironment=e.s,exports.isCompositeFiber=c,exports.isFiber=l,exports.isHostFiber=s,exports.isInstrumentationActive=ae,exports.isReactRefresh=e.c,exports.isRealReactDevtools=e.l,exports.isValidElement=a,exports.isValidFiber=o,exports.onRendererInject=e.u,exports.overrideContext=le,exports.overrideHookState=ce,exports.overrideProps=G,exports.patchRDTHook=e.d,exports.safelyInstallRDTHook=e.f,exports.setFiberId=D,exports.toUnsubscribe=e.m,exports.traverseContexts=ee,exports.traverseFiber=_,exports.traverseProps=d,exports.traverseRenderedFibers=se,exports.traverseState=u,exports.version=e.p;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rdt-hook.cjs"),t=require("./core2.cjs");exports.BIPPY_INSTRUMENTATION_STRING=e.t,exports.BippyError=t.M,exports.BippyHookInspectionError=t.N,exports.BippyHookRenderError=t.P,exports.BippySourceMapError=t.F,exports.BippyUnsupportedHookError=t.I,exports.ReactSymbols=t.R,exports._fiberRoots=t.t,exports._onActiveListeners=e.n,exports._renderers=e.r,exports.detectReactBuildType=t.n,exports.didFiberCommit=t.r,exports.didFiberRender=t.i,exports.getDisplayName=t.a,exports.getFiberFromHostInstance=t.o,exports.getFiberId=t.s,exports.getFiberStack=t.c,exports.getLatestFiber=t.l,exports.getMutatedHostFibers=t.u,exports.getNearestHostFiber=t.d,exports.getNearestHostFibers=t.f,exports.getRDTHook=e.a,exports.getReactWorkTags=t.z,exports.getTimings=t.p,exports.getType=t.m,exports.hasMemoCache=t.h,exports.hasRDTHook=e.o,exports.installRDTHook=e.s,exports.instrument=t.g,exports.isCompositeFiber=t._,exports.isFiber=t.v,exports.isHostFiber=t.y,exports.isInstrumentationActive=t.b,exports.isRealReactDevtools=e.c,exports.isValidElement=t.x,exports.isValidFiber=t.S,exports.onRendererInject=e.u,exports.overrideContext=t.C,exports.overrideHookState=t.w,exports.overrideProps=t.T,exports.patchRDTHook=e.d,exports.setFiberId=t.E,exports.traverseContexts=t.D,exports.traverseFiber=t.O,exports.traverseProps=t.k,exports.traverseRenderedFibers=t.A,exports.traverseState=t.j,exports.version=e.f;