bippy 0.6.1-dev.0597fd5 → 0.6.1-dev.28d99bb

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +223 -463
  3. package/dist/core.cjs +1 -1
  4. package/dist/core.d.cts +46 -110
  5. package/dist/core.d.ts +46 -110
  6. package/dist/core.js +1 -1
  7. package/dist/core2.cjs +9 -0
  8. package/dist/core2.d.cts +11 -3
  9. package/dist/core2.d.ts +11 -3
  10. package/dist/core2.js +9 -0
  11. package/dist/errors.d.cts +410 -0
  12. package/dist/errors.d.ts +410 -0
  13. package/dist/index.cjs +1 -1
  14. package/dist/index.d.cts +14 -3
  15. package/dist/index.d.ts +14 -3
  16. package/dist/index.js +1 -1
  17. package/dist/install-hook-only.cjs +1 -1
  18. package/dist/install-hook-only.d.cts +9 -1
  19. package/dist/install-hook-only.d.ts +9 -1
  20. package/dist/install-hook-only.js +1 -1
  21. package/dist/rdt-hook.cjs +1 -1
  22. package/dist/rdt-hook.js +1 -1
  23. package/dist/source.cjs +14 -5
  24. package/dist/source.d.cts +86 -69
  25. package/dist/source.d.ts +86 -69
  26. package/dist/source.js +14 -5
  27. package/package.json +26 -17
  28. package/src/core.ts +341 -684
  29. package/src/errors.ts +34 -0
  30. package/src/index.ts +1 -0
  31. package/src/install-hook-only.ts +2 -2
  32. package/src/rdt-hook.ts +160 -161
  33. package/src/react-internals/generated/react-work-tags.ts +318 -0
  34. package/src/react-internals/index.ts +67 -0
  35. package/src/react-internals/semver.ts +80 -0
  36. package/src/react-internals/types.ts +186 -0
  37. package/src/react.ts +76 -0
  38. package/src/source/constants.ts +1 -1
  39. package/src/source/error-stack.ts +11 -0
  40. package/src/source/get-display-name-from-source.ts +44 -40
  41. package/src/source/get-source.ts +43 -26
  42. package/src/source/index.ts +11 -1
  43. package/src/source/inspect-hooks.ts +220 -207
  44. package/src/source/owner-stack.ts +119 -174
  45. package/src/source/parse-debug-stack.ts +4 -4
  46. package/src/source/parse-hook-names.ts +14 -53
  47. package/src/source/parse-stack.ts +14 -31
  48. package/src/source/renderer-dispatchers.ts +30 -0
  49. package/src/source/symbolication.ts +709 -120
  50. package/dist/get-source.cjs +0 -19
  51. package/dist/get-source.js +0 -19
  52. package/dist/index.iife.js +0 -9
  53. package/dist/install-hook-only.iife.js +0 -9
  54. package/dist/react-refresh.cjs +0 -9
  55. package/dist/react-refresh.d.cts +0 -66
  56. package/dist/react-refresh.d.ts +0 -66
  57. package/dist/react-refresh.js +0 -9
  58. package/dist/unsubscribe.d.cts +0 -298
  59. package/dist/unsubscribe.d.ts +0 -298
  60. package/src/react-refresh/constants.ts +0 -9
  61. package/src/react-refresh/detect-hmr-transport.ts +0 -33
  62. package/src/react-refresh/index.ts +0 -173
  63. package/src/react-refresh/metro-hmr-transport.ts +0 -188
  64. package/src/react-refresh/next-webpack-hmr-transport.ts +0 -72
  65. package/src/react-refresh/normalize-hmr-file-path.ts +0 -24
  66. package/src/react-refresh/types.ts +0 -7
  67. package/src/react-refresh/vite-hmr-transport.ts +0 -116
  68. package/src/types.ts +0 -438
  69. package/src/unsubscribe.ts +0 -17
package/src/core.ts CHANGED
@@ -1,71 +1,59 @@
1
- // [!!!] IMPORTANT: do not import React in this file
2
- // since it will be executed before the react devtools hook is created
1
+ // React must remain a type-only import because this module loads immediately after the DevTools hook.
3
2
 
4
3
  import type * as React from "react";
5
4
 
6
5
  import type {
7
- ContextDependency,
8
6
  Fiber,
9
7
  FiberRoot,
10
- MemoizedState,
8
+ HostFiber,
11
9
  ReactDevToolsGlobalHook,
12
10
  ReactRenderer,
13
- } from "./types.js";
11
+ } from "./react-internals/index.js";
14
12
 
15
13
  import {
16
14
  _onActiveListeners,
17
15
  BIPPY_INSTRUMENTATION_STRING,
16
+ createUnsubscribe,
18
17
  getRDTHook,
19
18
  hasRDTHook,
20
- isReactRefresh,
21
19
  isRealReactDevtools,
22
- onRendererInject,
20
+ onRDTHookReplace,
23
21
  } from "./rdt-hook.js";
24
- import { toUnsubscribe, type Unsubscribe } from "./unsubscribe.js";
25
-
26
- // https://github.com/facebook/react/blob/main/packages/react-reconciler/src/ReactWorkTags.js
27
- export const FunctionComponentTag = 0;
28
- export const ClassComponentTag = 1;
29
- export const HostRootTag = 3;
30
- export const HostPortalTag = 4;
31
- export const HostComponentTag = 5;
32
- export const HostTextTag = 6;
33
- export const FragmentTag = 7;
34
- export const ContextConsumerTag = 9;
35
- export const ForwardRefTag = 11;
36
- export const SuspenseComponentTag = 13;
37
- export const MemoComponentTag = 14;
38
- export const SimpleMemoComponentTag = 15;
39
- export const LazyComponentTag = 16;
40
- export const DehydratedSuspenseComponentTag = 18;
41
- export const SuspenseListComponentTag = 19;
42
- export const OffscreenComponentTag = 22;
43
- export const LegacyHiddenComponentTag = 23;
44
- export const HostHoistableTag = 26;
45
- export const HostSingletonTag = 27;
46
- export const ActivityComponentTag = 28;
47
- export const ViewTransitionComponentTag = 30;
48
-
49
- export const CONCURRENT_MODE_NUMBER = 0xeacf;
50
- export const ELEMENT_TYPE_SYMBOL_STRING = "Symbol(react.element)";
51
- export const TRANSITIONAL_ELEMENT_TYPE_SYMBOL_STRING = "Symbol(react.transitional.element)";
52
- export const CONCURRENT_MODE_SYMBOL_STRING = "Symbol(react.concurrent_mode)";
53
- export const DEPRECATED_ASYNC_MODE_SYMBOL_STRING = "Symbol(react.async_mode)";
54
- export const CONCURRENT_MODE_SYMBOL_DESCRIPTION = "react.concurrent_mode";
55
- export const DEPRECATED_ASYNC_MODE_SYMBOL_DESCRIPTION = "react.async_mode";
56
-
57
- // https://github.com/facebook/react/blob/main/packages/react-reconciler/src/ReactFiberFlags.js
58
- const PerformedWork = 0b1;
59
- const Placement = 0b10;
60
- const Hydrating = 0b1000000000000;
61
- const Update = 0b100;
62
- const Cloned = 0b1000;
63
- const ChildDeletion = 0b10000;
64
- const ContentReset = 0b100000;
65
- const Snapshot = 0b10000000000;
66
- const Visibility = 0b10000000000000;
67
- const MutationMask =
68
- Placement | Update | ChildDeletion | ContentReset | Hydrating | Visibility | Snapshot;
22
+ import type { Unsubscribe } from "./rdt-hook.js";
23
+ import {
24
+ getReactWorkTagsForFiber,
25
+ MutationMask,
26
+ ReactBuildType,
27
+ ReactFiberFlags,
28
+ ReactSymbols,
29
+ setReactWorkTagsForFiber,
30
+ } from "./react-internals/index.js";
31
+
32
+ export {
33
+ BippyError,
34
+ BippyHookInspectionError,
35
+ BippyHookRenderError,
36
+ BippySourceMapError,
37
+ BippyUnsupportedHookError,
38
+ } from "./errors.js";
39
+
40
+ const isComponentType = (value: unknown): value is React.ComponentType<unknown> =>
41
+ typeof value === "function";
42
+
43
+ const getTypeName = (value: object): string | null => {
44
+ const displayName = "displayName" in value ? value.displayName : null;
45
+ if (typeof displayName === "string" && displayName) return displayName;
46
+ const name = "name" in value ? value.name : null;
47
+ return typeof name === "string" && name ? name : null;
48
+ };
49
+
50
+ interface FiberSelector {
51
+ (node: Fiber): boolean | Promise<boolean | void> | void;
52
+ }
53
+
54
+ export interface RenderHandler {
55
+ (fiber: Fiber, phase: RenderPhase): unknown;
56
+ }
69
57
 
70
58
  /**
71
59
  * Returns `true` if object is a React Element.
@@ -74,19 +62,17 @@ const MutationMask =
74
62
  */
75
63
  export const isValidElement = (element: unknown): element is React.ReactElement =>
76
64
  typeof element === "object" &&
77
- element != null &&
65
+ element !== null &&
78
66
  "$$typeof" in element &&
79
- // react 18 uses Symbol.for('react.element'), react 19 uses Symbol.for('react.transitional.element')
80
- [ELEMENT_TYPE_SYMBOL_STRING, TRANSITIONAL_ELEMENT_TYPE_SYMBOL_STRING].includes(
81
- String(element.$$typeof),
82
- );
67
+ (String(element.$$typeof) === ReactSymbols.LEGACY_ELEMENT_SYMBOL_STRING ||
68
+ String(element.$$typeof) === ReactSymbols.ELEMENT_SYMBOL_STRING);
83
69
 
84
70
  /**
85
71
  * Returns `true` if object is a React Fiber.
86
72
  */
87
- export const isValidFiber = (fiber: unknown): fiber is Fiber =>
73
+ export const isFiber = (fiber: unknown): fiber is Fiber =>
88
74
  typeof fiber === "object" &&
89
- fiber != null &&
75
+ fiber !== null &&
90
76
  "tag" in fiber &&
91
77
  "stateNode" in fiber &&
92
78
  "return" in fiber &&
@@ -94,21 +80,27 @@ export const isValidFiber = (fiber: unknown): fiber is Fiber =>
94
80
  "sibling" in fiber &&
95
81
  "flags" in fiber;
96
82
 
83
+ const isFiberRoot = (fiberRoot: unknown): fiberRoot is FiberRoot =>
84
+ typeof fiberRoot === "object" &&
85
+ fiberRoot !== null &&
86
+ "current" in fiberRoot &&
87
+ isFiber(fiberRoot.current);
88
+
97
89
  /**
98
90
  * Returns `true` if fiber is a host fiber. Host fibers are DOM nodes in react-dom, `View` in react-native, etc.
99
91
  *
100
92
  * @see https://reactnative.dev/architecture/glossary#host-view-tree-and-host-view
101
93
  */
102
- export const isHostFiber = (fiber: Fiber): boolean => {
94
+ export const isHostFiber = (fiber: Fiber): fiber is HostFiber => {
95
+ const workTags = getReactWorkTagsForFiber(fiber);
103
96
  switch (fiber.tag) {
104
- case HostComponentTag:
105
- // @ts-expect-error: it exists
106
- case HostHoistableTag:
107
- // @ts-expect-error: it exists
108
- case HostSingletonTag:
97
+ case workTags.HostComponent:
98
+ case workTags.HostText:
99
+ case workTags.HostHoistable:
100
+ case workTags.HostSingleton:
109
101
  return true;
110
102
  default:
111
- return typeof fiber.type === "string";
103
+ return false;
112
104
  }
113
105
  };
114
106
 
@@ -118,128 +110,36 @@ export const isHostFiber = (fiber: Fiber): boolean => {
118
110
  * @see https://reactnative.dev/architecture/glossary#react-composite-components
119
111
  */
120
112
  export const isCompositeFiber = (fiber: Fiber): boolean => {
113
+ const workTags = getReactWorkTagsForFiber(fiber);
121
114
  switch (fiber.tag) {
122
- case ClassComponentTag:
123
- case ForwardRefTag:
124
- case FunctionComponentTag:
125
- case MemoComponentTag:
126
- case SimpleMemoComponentTag:
115
+ case workTags.ClassComponent:
116
+ case workTags.ForwardRef:
117
+ case workTags.FunctionComponent:
118
+ case workTags.MemoComponent:
119
+ case workTags.SimpleMemoComponent:
127
120
  return true;
128
121
  default:
129
122
  return false;
130
123
  }
131
124
  };
132
125
 
133
- /**
134
- * Returns `true` if the object is a {@link Fiber}
135
- */
136
- export const isFiber = (maybeFiber: unknown): maybeFiber is Fiber => {
137
- if (!maybeFiber || typeof maybeFiber !== "object") return false;
138
- // this is a fast check. pendingProps will ALWAYS exist in fiber
139
- // `containerInfo` is in FiberRootNode, not FiberNode
140
- return "pendingProps" in maybeFiber && !("containerInfo" in maybeFiber);
141
- };
142
-
143
- /**
144
- * Traverses up or down a {@link Fiber}'s contexts, return `true` to stop and select the current and previous context value.
145
- */
146
- export const traverseContexts = (
147
- fiber: Fiber,
148
- selector: (
149
- nextValue: ContextDependency<unknown> | null | undefined,
150
- prevValue: ContextDependency<unknown> | null | undefined,
151
- ) => boolean | void,
152
- ): boolean => {
153
- try {
154
- const nextDependencies = fiber.dependencies;
155
- const prevDependencies = fiber.alternate?.dependencies;
156
-
157
- if (!nextDependencies || !prevDependencies) return false;
158
- if (
159
- typeof nextDependencies !== "object" ||
160
- !("firstContext" in nextDependencies) ||
161
- typeof prevDependencies !== "object" ||
162
- !("firstContext" in prevDependencies)
163
- ) {
164
- return false;
165
- }
166
- let nextContext: ContextDependency<unknown> | null | undefined = nextDependencies.firstContext;
167
- let prevContext: ContextDependency<unknown> | null | undefined = prevDependencies.firstContext;
168
- while (
169
- (nextContext && typeof nextContext === "object" && "memoizedValue" in nextContext) ||
170
- (prevContext && typeof prevContext === "object" && "memoizedValue" in prevContext)
171
- ) {
172
- if (selector(nextContext, prevContext) === true) return true;
173
-
174
- nextContext = nextContext?.next;
175
- prevContext = prevContext?.next;
176
- }
177
- } catch {}
178
- return false;
179
- };
180
-
181
- /**
182
- * Traverses up or down a {@link Fiber}'s states, return `true` to stop and select the current and previous state value. This stores both state values and effects.
183
- */
184
- export const traverseState = (
185
- fiber: Fiber,
186
- selector: (
187
- nextValue: MemoizedState | null | undefined,
188
- prevValue: MemoizedState | null | undefined,
189
- ) => boolean | void,
190
- ): boolean => {
191
- try {
192
- let nextState: MemoizedState | null | undefined = fiber.memoizedState;
193
- let prevState: MemoizedState | null | undefined = fiber.alternate?.memoizedState;
194
-
195
- while (nextState || prevState) {
196
- if (selector(nextState, prevState) === true) return true;
197
-
198
- nextState = nextState?.next;
199
- prevState = prevState?.next;
200
- }
201
- } catch {}
202
- return false;
203
- };
204
-
205
- /**
206
- * Traverses up or down a {@link Fiber}'s props, return `true` to stop and select the current and previous props value.
207
- */
208
- export const traverseProps = (
209
- fiber: Fiber,
210
- selector: (propName: string, nextValue: unknown, prevValue: unknown) => boolean | void,
211
- ): boolean => {
212
- try {
213
- const nextProps = fiber.memoizedProps;
214
- const prevProps = fiber.alternate?.memoizedProps || {};
215
-
216
- for (const propName of Object.keys(nextProps)) {
217
- if (selector(propName, nextProps[propName], prevProps[propName]) === true) return true;
218
- }
219
- for (const propName of Object.keys(prevProps)) {
220
- if (propName in nextProps) continue;
221
- if (selector(propName, nextProps[propName], prevProps[propName]) === true) return true;
222
- }
223
- } catch {}
224
- return false;
225
- };
226
-
227
126
  /**
228
127
  * Returns `true` if the {@link Fiber} has rendered. Note that this does not mean the fiber has rendered in the current commit, just that it has rendered in the past.
229
128
  */
230
129
  export const didFiberRender = (fiber: Fiber): boolean => {
231
130
  const nextProps = fiber.memoizedProps;
232
131
  const prevProps = fiber.alternate?.memoizedProps || {};
233
- const flags = fiber.flags ?? (fiber as unknown as { effectTag: number }).effectTag ?? 0;
132
+ const flags = fiber.flags ?? fiber.effectTag ?? 0;
133
+ const workTags = getReactWorkTagsForFiber(fiber);
234
134
 
235
135
  switch (fiber.tag) {
236
- case ClassComponentTag:
237
- case ContextConsumerTag:
238
- case ForwardRefTag:
239
- case FunctionComponentTag:
240
- case MemoComponentTag:
241
- case SimpleMemoComponentTag: {
242
- return (flags & PerformedWork) === PerformedWork;
136
+ case workTags.ClassComponent:
137
+ case workTags.ContextConsumer:
138
+ case workTags.ForwardRef:
139
+ case workTags.FunctionComponent:
140
+ case workTags.MemoComponent:
141
+ case workTags.SimpleMemoComponent: {
142
+ return (flags & ReactFiberFlags.PerformedWork) === ReactFiberFlags.PerformedWork;
243
143
  }
244
144
  default:
245
145
  // Host nodes (DOM, root, etc.)
@@ -257,57 +157,18 @@ export const didFiberRender = (fiber: Fiber): boolean => {
257
157
  */
258
158
  export const didFiberCommit = (fiber: Fiber): boolean => {
259
159
  return Boolean(
260
- (fiber.flags & (MutationMask | Cloned)) !== 0 ||
261
- (fiber.subtreeFlags & (MutationMask | Cloned)) !== 0,
160
+ (fiber.flags & (MutationMask | ReactFiberFlags.Cloned)) !== 0 ||
161
+ (fiber.subtreeFlags & (MutationMask | ReactFiberFlags.Cloned)) !== 0,
262
162
  );
263
163
  };
264
164
 
265
- /**
266
- * Returns all host {@link Fiber}s that have committed and rendered.
267
- */
268
- export const getMutatedHostFibers = (fiber: Fiber): Fiber[] => {
269
- const mutations: Fiber[] = [];
270
- const stack: Fiber[] = [fiber];
271
-
272
- while (stack.length) {
273
- const node = stack.pop();
274
- if (!node) continue;
275
-
276
- if (isHostFiber(node) && didFiberCommit(node) && didFiberRender(node)) {
277
- mutations.push(node);
278
- }
279
-
280
- if (node.child) stack.push(node.child);
281
- if (node.sibling) stack.push(node.sibling);
282
- }
283
-
284
- return mutations;
285
- };
286
-
287
- /**
288
- * Returns the stack of {@link Fiber}s from the current fiber to the root fiber.
289
- *
290
- * @example
291
- * ```ts
292
- * [fiber, fiber.return, fiber.return.return, ...]
293
- * ```
294
- */
295
- export const getFiberStack = (fiber: Fiber): Fiber[] => {
296
- const stack: Fiber[] = [];
297
- let currentFiber = fiber;
298
- while (currentFiber.return) {
299
- stack.push(currentFiber);
300
- currentFiber = currentFiber.return as Fiber;
301
- }
302
- return stack;
303
- };
304
-
305
165
  /**
306
166
  * Returns `true` if the {@link Fiber} should be filtered out during reconciliation.
307
167
  */
308
168
  const shouldFilterFiber = (fiber: Fiber): boolean => {
169
+ const workTags = getReactWorkTagsForFiber(fiber);
309
170
  switch (fiber.tag) {
310
- case DehydratedSuspenseComponentTag:
171
+ case workTags.DehydratedSuspenseComponent:
311
172
  // TODO: ideally we would show dehydrated Suspense immediately.
312
173
  // However, it has some special behavior (like disconnecting
313
174
  // an alternate and turning into real Suspense) which breaks DevTools.
@@ -315,13 +176,13 @@ const shouldFilterFiber = (fiber: Fiber): boolean => {
315
176
  // https://github.com/bvaughn/react-devtools-experimental/issues/197
316
177
  return true;
317
178
 
318
- case FragmentTag:
319
- case HostTextTag:
320
- case LegacyHiddenComponentTag:
321
- case OffscreenComponentTag:
179
+ case workTags.Fragment:
180
+ case workTags.HostText:
181
+ case workTags.LegacyHiddenComponent:
182
+ case workTags.OffscreenComponent:
322
183
  return true;
323
184
 
324
- case HostRootTag:
185
+ case workTags.HostRoot:
325
186
  // It is never valid to filter the root element.
326
187
  return false;
327
188
 
@@ -331,15 +192,15 @@ const shouldFilterFiber = (fiber: Fiber): boolean => {
331
192
 
332
193
  if (typeof symbolOrNumber === "symbol") {
333
194
  return (
334
- symbolOrNumber.description === CONCURRENT_MODE_SYMBOL_DESCRIPTION ||
335
- symbolOrNumber.description === DEPRECATED_ASYNC_MODE_SYMBOL_DESCRIPTION
195
+ symbolOrNumber.description === ReactSymbols.CONCURRENT_MODE_SYMBOL_DESCRIPTION ||
196
+ symbolOrNumber.description === ReactSymbols.DEPRECATED_ASYNC_MODE_SYMBOL_DESCRIPTION
336
197
  );
337
198
  }
338
199
 
339
200
  switch (symbolOrNumber) {
340
- case CONCURRENT_MODE_NUMBER:
341
- case CONCURRENT_MODE_SYMBOL_STRING:
342
- case DEPRECATED_ASYNC_MODE_SYMBOL_STRING:
201
+ case ReactSymbols.CONCURRENT_MODE_NUMBER:
202
+ case ReactSymbols.CONCURRENT_MODE_SYMBOL_STRING:
203
+ case ReactSymbols.DEPRECATED_ASYNC_MODE_SYMBOL_STRING:
343
204
  return true;
344
205
 
345
206
  default:
@@ -349,47 +210,6 @@ const shouldFilterFiber = (fiber: Fiber): boolean => {
349
210
  }
350
211
  };
351
212
 
352
- /**
353
- * Returns the nearest host {@link Fiber} to the current {@link Fiber}.
354
- */
355
- export const getNearestHostFiber = (fiber: Fiber, ascending = false): Fiber | null => {
356
- let hostFiber = traverseFiber(fiber, isHostFiber, ascending);
357
- if (!hostFiber) {
358
- hostFiber = traverseFiber(fiber, isHostFiber, !ascending);
359
- }
360
- return hostFiber;
361
- };
362
-
363
- /**
364
- * Returns all host {@link Fiber}s in the tree that are associated with the current {@link Fiber}.
365
- */
366
- export const getNearestHostFibers = (fiber: Fiber): Fiber[] => {
367
- const hostFibers: Fiber[] = [];
368
- const stack: Fiber[] = [];
369
-
370
- if (isHostFiber(fiber)) {
371
- hostFibers.push(fiber);
372
- } else if (fiber.child) {
373
- stack.push(fiber.child);
374
- }
375
-
376
- while (stack.length) {
377
- const currentNode = stack.pop();
378
- if (!currentNode) break;
379
- if (isHostFiber(currentNode)) {
380
- hostFibers.push(currentNode);
381
- } else if (currentNode.child) {
382
- stack.push(currentNode.child);
383
- }
384
-
385
- if (currentNode.sibling) {
386
- stack.push(currentNode.sibling);
387
- }
388
- }
389
-
390
- return hostFibers;
391
- };
392
-
393
213
  /**
394
214
  * Traverses up or down a {@link Fiber}, return `true` to stop and select a node.
395
215
  */
@@ -405,144 +225,86 @@ export function traverseFiber(
405
225
  ): Promise<Fiber | null>;
406
226
  export function traverseFiber(
407
227
  fiber: Fiber | null,
408
- selector: (node: Fiber) => boolean | Promise<boolean | void> | void,
228
+ selector: FiberSelector,
229
+ ascending?: boolean,
230
+ ): Fiber | null | Promise<Fiber | null>;
231
+ export function traverseFiber(
232
+ fiber: Fiber | null,
233
+ selector: FiberSelector,
409
234
  ascending = false,
410
235
  ): Fiber | null | Promise<Fiber | null> {
411
236
  if (!fiber) return null;
412
237
 
413
- const firstResult = selector(fiber);
414
- if (firstResult instanceof Promise) {
415
- return (async () => {
416
- if ((await firstResult) === true) return fiber;
417
-
418
- let child = ascending ? fiber.return : fiber.child;
419
- while (child) {
420
- const match = await traverseFiberAsync(
421
- child,
422
- selector as (node: Fiber) => Promise<boolean | void>,
423
- ascending,
424
- );
425
- if (match) return match;
426
- child = ascending ? null : child.sibling;
427
- }
428
- return null;
429
- })();
238
+ const selection = selector(fiber);
239
+ if (isPromiseLike<boolean | void>(selection)) {
240
+ return Promise.resolve(selection).then((didSelectFiber) =>
241
+ didSelectFiber === true ? fiber : traverseFiberChildren(fiber, selector, ascending),
242
+ );
430
243
  }
244
+ if (selection === true) return fiber;
431
245
 
432
- if (firstResult === true) return fiber;
433
-
434
- let child = ascending ? fiber.return : fiber.child;
435
- while (child) {
436
- const match = traverseFiberSync(child, selector as (node: Fiber) => boolean | void, ascending);
437
- if (match) return match;
438
- child = ascending ? null : child.sibling;
439
- }
440
- return null;
246
+ return traverseFiberChildren(fiber, selector, ascending);
441
247
  }
442
248
 
443
- const traverseFiberSync = (
444
- fiber: Fiber | null,
445
- selector: (node: Fiber) => boolean | void,
446
- ascending = false,
447
- ): Fiber | null => {
448
- if (!fiber) return null;
449
- if (selector(fiber) === true) return fiber;
450
-
451
- let child = ascending ? fiber.return : fiber.child;
452
- while (child) {
453
- const match = traverseFiberSync(child, selector, ascending);
454
- if (match) return match;
249
+ const isPromiseLike = <Result>(value: unknown): value is PromiseLike<Result> =>
250
+ (typeof value === "object" || typeof value === "function") &&
251
+ value !== null &&
252
+ "then" in value &&
253
+ typeof value.then === "function";
455
254
 
456
- child = ascending ? null : child.sibling;
457
- }
458
- return null;
255
+ const traverseFiberChildren = (
256
+ fiber: Fiber,
257
+ selector: FiberSelector,
258
+ ascending: boolean,
259
+ ): Fiber | null | Promise<Fiber | null> => {
260
+ const firstChild = ascending ? fiber.return : fiber.child;
261
+ return traverseFiberSiblings(firstChild, selector, ascending);
459
262
  };
460
263
 
461
- const traverseFiberAsync = async (
264
+ const traverseFiberSiblings = (
462
265
  fiber: Fiber | null,
463
- selector: (node: Fiber) => Promise<boolean | void>,
464
- ascending = false,
465
- ): Promise<Fiber | null> => {
266
+ selector: FiberSelector,
267
+ ascending: boolean,
268
+ ): Fiber | null | Promise<Fiber | null> => {
466
269
  if (!fiber) return null;
467
- if ((await selector(fiber)) === true) return fiber;
468
-
469
- let child = ascending ? fiber.return : fiber.child;
470
- while (child) {
471
- const match = await traverseFiberAsync(child, selector, ascending);
472
- if (match) return match;
473
270
 
474
- child = ascending ? null : child.sibling;
475
- }
476
- return null;
477
- };
478
-
479
- /**
480
- * Returns the timings of the {@link Fiber}.
481
- *
482
- * @example
483
- * ```ts
484
- * const { selfTime, totalTime } = getTimings(fiber);
485
- * console.log(selfTime, totalTime);
486
- * ```
487
- */
488
- export const getTimings = (fiber?: Fiber | null): { selfTime: number; totalTime: number } => {
489
- const totalTime = fiber?.actualDuration ?? 0;
490
- let selfTime = totalTime;
491
- // TODO: calculate a DOM time, which is just host component summed up
492
- let child = fiber?.child ?? null;
493
- while (totalTime > 0 && child != null) {
494
- selfTime -= child.actualDuration ?? 0;
495
- child = child.sibling;
271
+ const nextSibling = ascending ? null : fiber.sibling;
272
+ const match = traverseFiber(fiber, selector, ascending);
273
+ if (isPromiseLike<Fiber | null>(match)) {
274
+ return Promise.resolve(match).then(
275
+ (resolvedMatch) => resolvedMatch ?? traverseFiberSiblings(nextSibling, selector, ascending),
276
+ );
496
277
  }
497
- return { selfTime, totalTime };
278
+ return match ?? traverseFiberSiblings(nextSibling, selector, ascending);
498
279
  };
499
280
 
500
281
  /**
501
282
  * Returns `true` if the {@link Fiber} uses React Compiler's memo cache.
502
283
  */
503
284
  export const hasMemoCache = (fiber: Fiber): boolean => {
504
- return Boolean((fiber.updateQueue as unknown as { memoCache: unknown })?.memoCache);
285
+ return Boolean(fiber.updateQueue?.memoCache);
505
286
  };
506
287
 
507
- type FiberType =
508
- | React.ComponentType<unknown>
509
- | React.ForwardRefExoticComponent<unknown>
510
- | React.MemoExoticComponent<React.ComponentType<unknown>>;
511
-
512
288
  /**
513
289
  * Returns the type (e.g. component definition) of the {@link Fiber}
514
290
  */
515
291
  export const getType = (type: unknown): null | React.ComponentType<unknown> => {
516
- const currentType = type as FiberType;
517
- if (typeof currentType === "function") {
518
- return currentType;
519
- }
520
- if (typeof currentType === "object" && currentType) {
521
- // memo / forwardRef case
522
- return getType(
523
- (currentType as React.MemoExoticComponent<React.ComponentType<unknown>>).type ||
524
- (currentType as { render: React.ComponentType<unknown> }).render,
525
- );
526
- }
527
- return null;
292
+ if (isComponentType(type)) return type;
293
+ if (typeof type !== "object" || type === null) return null;
294
+ return getType(Reflect.get(type, "type") ?? Reflect.get(type, "render"));
528
295
  };
529
296
 
530
297
  /**
531
298
  * Returns the display name of the {@link Fiber} type.
532
299
  */
533
300
  export const getDisplayName = (type: unknown): null | string => {
534
- const currentType = type as FiberType;
535
- if (typeof currentType === "string") {
536
- return currentType;
537
- }
538
- if (typeof currentType !== "function" && !(typeof currentType === "object" && currentType)) {
539
- return null;
540
- }
541
- const name = currentType.displayName || currentType.name || null;
301
+ if (typeof type === "string") return type;
302
+ if ((typeof type !== "function" && typeof type !== "object") || type === null) return null;
303
+ const name = getTypeName(type);
542
304
  if (name) return name;
543
- const unwrappedType = getType(currentType);
305
+ const unwrappedType = getType(type);
544
306
  if (!unwrappedType) return null;
545
- return unwrappedType.displayName || unwrappedType.name || null;
307
+ return getTypeName(unwrappedType);
546
308
  };
547
309
 
548
310
  /**
@@ -550,7 +312,10 @@ export const getDisplayName = (type: unknown): null | string => {
550
312
  */
551
313
  export const detectReactBuildType = (renderer: ReactRenderer): "development" | "production" => {
552
314
  try {
553
- if (typeof renderer.version === "string" && renderer.bundleType > 0) {
315
+ if (
316
+ typeof renderer.version === "string" &&
317
+ renderer.bundleType === ReactBuildType.Development
318
+ ) {
554
319
  return "development";
555
320
  }
556
321
  } catch {}
@@ -562,14 +327,11 @@ export const detectReactBuildType = (renderer: ReactRenderer): "development" | "
562
327
  */
563
328
  export const isInstrumentationActive = (): boolean => {
564
329
  const rdtHook = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
565
- return (
566
- Boolean(rdtHook?._instrumentationIsActive) ||
567
- isRealReactDevtools(rdtHook) ||
568
- isReactRefresh(rdtHook)
569
- );
330
+ return Boolean(rdtHook?._instrumentationIsActive) || isRealReactDevtools(rdtHook);
570
331
  };
571
332
 
572
333
  export const _fiberRoots = new Set<FiberRoot>();
334
+ const rootRendererIds = new WeakMap<FiberRoot, number>();
573
335
 
574
336
  /**
575
337
  * Returns the latest fiber (since it may be double-buffered).
@@ -582,37 +344,54 @@ export const getLatestFiber = (fiber: Fiber): Fiber => {
582
344
  }
583
345
  for (const root of _fiberRoots) {
584
346
  const latestFiber = traverseFiber(root.current, (innerFiber) => {
585
- if (innerFiber === fiber) return true;
347
+ if (innerFiber === fiber || innerFiber === alternate) return true;
586
348
  });
587
349
  if (latestFiber) return latestFiber;
588
350
  }
589
351
  return fiber;
590
352
  };
591
353
 
592
- export type RenderHandler = <S>(fiber: Fiber, phase: RenderPhase, state?: S) => unknown;
354
+ /**
355
+ * Returns the renderer that owns the {@link Fiber}.
356
+ */
357
+ export const getRenderer = (fiber: Fiber): ReactRenderer | null => {
358
+ if (!hasRDTHook()) return null;
359
+
360
+ let rootFiber = fiber;
361
+ while (rootFiber.return) {
362
+ rootFiber = rootFiber.return;
363
+ }
364
+
365
+ const fiberRoot = rootFiber.stateNode;
366
+ if (!isFiberRoot(fiberRoot)) return null;
367
+
368
+ const rendererID = rootRendererIds.get(fiberRoot);
369
+ if (rendererID === undefined) return null;
370
+ return getRDTHook().renderers.get(rendererID) ?? null;
371
+ };
593
372
 
594
373
  export type RenderPhase = "mount" | "unmount" | "update";
595
374
 
596
- let fiberId = 0;
375
+ let nextFiberId = 0;
597
376
  const fiberIdMap = new WeakMap<Fiber, number>();
598
377
 
599
- export const setFiberId = (fiber: Fiber, id: number = fiberId++): void => {
600
- fiberIdMap.set(fiber, id);
378
+ export const setFiberId = (fiber: Fiber, fiberId: number = nextFiberId++): void => {
379
+ fiberIdMap.set(fiber, fiberId);
380
+ if (Number.isSafeInteger(fiberId) && fiberId >= nextFiberId) {
381
+ nextFiberId = fiberId + 1;
382
+ }
601
383
  };
602
384
 
603
- // react fibers are double buffered, so the alternate fiber may
604
- // be switched to the current fiber and vice versa.
605
- // fiber === fiber.alternate.alternate
606
385
  export const getFiberId = (fiber: Fiber): number => {
607
- let id = fiberIdMap.get(fiber);
608
- if (id === undefined && fiber.alternate) {
609
- id = fiberIdMap.get(fiber.alternate);
386
+ let currentFiberId = fiberIdMap.get(fiber);
387
+ if (currentFiberId === undefined && fiber.alternate) {
388
+ currentFiberId = fiberIdMap.get(fiber.alternate);
610
389
  }
611
- if (id === undefined) {
612
- id = fiberId++;
613
- setFiberId(fiber, id);
390
+ if (currentFiberId === undefined) {
391
+ currentFiberId = nextFiberId++;
392
+ setFiberId(fiber, currentFiberId);
614
393
  }
615
- return id;
394
+ return currentFiberId;
616
395
  };
617
396
 
618
397
  const mountFiberRecursively = (
@@ -622,16 +401,14 @@ const mountFiberRecursively = (
622
401
  ): void => {
623
402
  let fiber: Fiber | null = firstChild;
624
403
 
625
- while (fiber != null) {
626
- if (!fiberIdMap.has(fiber)) {
627
- getFiberId(fiber);
628
- }
404
+ while (fiber !== null) {
405
+ getFiberId(fiber);
629
406
  const shouldIncludeInTree = !shouldFilterFiber(fiber);
630
407
  if (shouldIncludeInTree && didFiberRender(fiber)) {
631
408
  onRender(fiber, "mount");
632
409
  }
633
410
 
634
- if (fiber.tag === SuspenseComponentTag) {
411
+ if (fiber.tag === getReactWorkTagsForFiber(fiber).SuspenseComponent) {
635
412
  const isTimedOut = fiber.memoizedState !== null;
636
413
  if (isTimedOut) {
637
414
  // Special case: if Suspense mounts in a timed-out state,
@@ -646,18 +423,12 @@ const mountFiberRecursively = (
646
423
  }
647
424
  }
648
425
  } else {
649
- let primaryChild: Fiber | null = null;
650
- const areSuspenseChildrenConditionallyWrapped = (OffscreenComponentTag as number) === -1;
651
- if (areSuspenseChildrenConditionallyWrapped) {
652
- primaryChild = fiber.child;
653
- } else if (fiber.child !== null) {
654
- primaryChild = fiber.child.child;
655
- }
426
+ const primaryChild = fiber.child?.child ?? null;
656
427
  if (primaryChild !== null) {
657
428
  mountFiberRecursively(onRender, primaryChild, false);
658
429
  }
659
430
  }
660
- } else if (fiber.child != null) {
431
+ } else if (fiber.child !== null) {
661
432
  mountFiberRecursively(onRender, fiber.child, true);
662
433
  }
663
434
  fiber = traverseSiblings ? fiber.sibling : null;
@@ -667,18 +438,13 @@ const mountFiberRecursively = (
667
438
  const updateFiberRecursively = (
668
439
  onRender: RenderHandler,
669
440
  nextFiber: Fiber,
670
- prevFiber: Fiber,
671
- parentFiber: Fiber | null,
441
+ prevFiber: Fiber | null,
672
442
  ): void => {
673
- if (!fiberIdMap.has(nextFiber)) {
674
- getFiberId(nextFiber);
675
- }
443
+ getFiberId(nextFiber);
676
444
  if (!prevFiber) return;
677
- if (!fiberIdMap.has(prevFiber)) {
678
- getFiberId(prevFiber);
679
- }
445
+ getFiberId(prevFiber);
680
446
 
681
- const isSuspense = nextFiber.tag === SuspenseComponentTag;
447
+ const isSuspense = nextFiber.tag === getReactWorkTagsForFiber(nextFiber).SuspenseComponent;
682
448
 
683
449
  const shouldIncludeInTree = !shouldFilterFiber(nextFiber);
684
450
  if (shouldIncludeInTree && didFiberRender(nextFiber)) {
@@ -707,7 +473,7 @@ const updateFiberRecursively = (
707
473
  const prevFallbackChildSet = prevFiber.child?.sibling ?? null;
708
474
 
709
475
  if (nextFallbackChildSet !== null && prevFallbackChildSet !== null) {
710
- updateFiberRecursively(onRender, nextFallbackChildSet, prevFallbackChildSet, nextFiber);
476
+ updateFiberRecursively(onRender, nextFallbackChildSet, prevFallbackChildSet);
711
477
  }
712
478
  } else if (prevDidTimeout && !nextDidTimeOut) {
713
479
  // Fallback -> Primary:
@@ -746,14 +512,7 @@ const updateFiberRecursively = (
746
512
  // Schedule updates and mounts depending on whether alternates exist.
747
513
  // We don't track deletions here because they are reported separately.
748
514
  if (nextChild.alternate) {
749
- const prevChild = nextChild.alternate;
750
-
751
- updateFiberRecursively(
752
- onRender,
753
- nextChild,
754
- prevChild,
755
- shouldIncludeInTree ? nextFiber : parentFiber,
756
- );
515
+ updateFiberRecursively(onRender, nextChild, nextChild.alternate);
757
516
  } else {
758
517
  mountFiberRecursively(onRender, nextChild, false);
759
518
  }
@@ -765,7 +524,7 @@ const updateFiberRecursively = (
765
524
  };
766
525
 
767
526
  const unmountFiber = (onRender: RenderHandler, fiber: Fiber): void => {
768
- const isRoot = fiber.tag === HostRootTag;
527
+ const isRoot = fiber.tag === getReactWorkTagsForFiber(fiber).HostRoot;
769
528
 
770
529
  if (isRoot || !shouldFilterFiber(fiber)) {
771
530
  onRender(fiber, "unmount");
@@ -774,7 +533,8 @@ const unmountFiber = (onRender: RenderHandler, fiber: Fiber): void => {
774
533
 
775
534
  const unmountFiberChildrenRecursively = (onRender: RenderHandler, fiber: Fiber): void => {
776
535
  // We might meet a nested Suspense on our way.
777
- const isTimedOutSuspense = fiber.tag === SuspenseComponentTag && fiber.memoizedState !== null;
536
+ const isTimedOutSuspense =
537
+ fiber.tag === getReactWorkTagsForFiber(fiber).SuspenseComponent && fiber.memoizedState !== null;
778
538
  let child = fiber.child;
779
539
 
780
540
  if (isTimedOutSuspense) {
@@ -798,11 +558,9 @@ const unmountFiberChildrenRecursively = (onRender: RenderHandler, fiber: Fiber):
798
558
  }
799
559
  };
800
560
 
801
- let commitId = 0;
802
561
  const rootInstanceMap = new WeakMap<
803
- FiberRoot,
562
+ Fiber | FiberRoot,
804
563
  {
805
- id: number;
806
564
  prevFiber: Fiber | null;
807
565
  }
808
566
  >();
@@ -814,37 +572,39 @@ const rootInstanceMap = new WeakMap<
814
572
  * console.log(phase)
815
573
  * })
816
574
  */
817
- export const traverseRenderedFibers = (root: FiberRoot, onRender: RenderHandler): void => {
575
+ export const traverseRenderedFibers = (root: Fiber | FiberRoot, onRender: RenderHandler): void => {
818
576
  const fiber = "current" in root ? root.current : root;
819
577
 
820
578
  let rootInstance = rootInstanceMap.get(root);
821
579
 
822
580
  if (!rootInstance) {
823
- rootInstance = { id: commitId++, prevFiber: null };
581
+ rootInstance = { prevFiber: null };
824
582
  rootInstanceMap.set(root, rootInstance);
825
583
  }
826
584
 
827
585
  const { prevFiber } = rootInstance;
828
- // if fiberRoot don't have current instance, means it's been unmounted
829
586
  if (!fiber) {
830
- unmountFiber(onRender, fiber);
587
+ if (prevFiber) {
588
+ unmountFiber(onRender, prevFiber);
589
+ }
831
590
  } else if (prevFiber !== null) {
832
591
  const wasMounted =
833
- prevFiber &&
834
- prevFiber.memoizedState != null &&
835
- prevFiber.memoizedState.element != null &&
592
+ prevFiber.memoizedState !== null &&
593
+ prevFiber.memoizedState.element !== null &&
594
+ prevFiber.memoizedState.element !== undefined &&
836
595
  // A dehydrated root is not considered mounted
837
596
  prevFiber.memoizedState.isDehydrated !== true;
838
597
  const isMounted =
839
- fiber.memoizedState != null &&
840
- fiber.memoizedState.element != null &&
598
+ fiber.memoizedState !== null &&
599
+ fiber.memoizedState.element !== null &&
600
+ fiber.memoizedState.element !== undefined &&
841
601
  // A dehydrated root is not considered mounted
842
602
  fiber.memoizedState.isDehydrated !== true;
843
603
 
844
604
  if (!wasMounted && isMounted) {
845
605
  mountFiberRecursively(onRender, fiber, false);
846
606
  } else if (wasMounted && isMounted) {
847
- updateFiberRecursively(onRender, fiber, fiber.alternate, null);
607
+ updateFiberRecursively(onRender, fiber, fiber.alternate);
848
608
  } else if (wasMounted && !isMounted) {
849
609
  unmountFiber(onRender, fiber);
850
610
  }
@@ -855,191 +615,25 @@ export const traverseRenderedFibers = (root: FiberRoot, onRender: RenderHandler)
855
615
  rootInstance.prevFiber = fiber;
856
616
  };
857
617
 
858
- const overrideRenderers = new Set<ReactRenderer>();
859
- let areOverrideRenderersWired = false;
860
-
861
- const wireOverrideRenderers = (): void => {
862
- if (areOverrideRenderersWired) return;
863
- if (!hasRDTHook()) return;
864
- const rdtHook = getRDTHook();
865
- if (!rdtHook?.renderers) return;
866
- areOverrideRenderersWired = true;
867
-
868
- ensureHookDispatchesToListeners(rdtHook);
869
- for (const renderer of rdtHook.renderers.values()) {
870
- overrideRenderers.add(renderer);
871
- }
872
- onRendererInject((renderer) => {
873
- overrideRenderers.add(renderer);
874
- });
875
- };
876
-
877
- const getRootRenderer = (fiber: Fiber): ReactRenderer | null => {
878
- if (!hasRDTHook()) return null;
879
- let hostRootFiber = fiber;
880
- while (hostRootFiber.return) {
881
- hostRootFiber = hostRootFiber.return;
882
- }
883
- const rendererId = rootRendererIds.get(hostRootFiber.stateNode);
884
- if (rendererId === undefined) return null;
885
- return getRDTHook().renderers?.get(rendererId) ?? null;
886
- };
887
-
888
- // dispatch to the renderer that owns the fiber's root when known; renderers
889
- // that never committed through bippy's hook patch fall back to "try all",
890
- // which matches the pre-ownership behavior for single-renderer apps
891
- const resolveOverrideRenderers = (fiber: Fiber): ReactRenderer[] => {
892
- wireOverrideRenderers();
893
- const rootRenderer = getRootRenderer(fiber);
894
- if (rootRenderer) return [rootRenderer];
895
- return Array.from(overrideRenderers);
896
- };
897
-
898
- const applyPropsOverride = (
899
- renderers: ReactRenderer[],
900
- fiber: Fiber,
901
- path: string[],
902
- value: unknown,
903
- ): void => {
904
- for (const renderer of renderers) {
905
- try {
906
- renderer.overrideProps?.(fiber, path, value);
907
- } catch {}
908
- }
909
- };
910
-
911
- const getHookStateDispatch = (
912
- fiber: Fiber,
913
- hookIndex: number,
914
- ): ((value: unknown) => void) | null => {
915
- let hookState = fiber.memoizedState;
916
- for (let i = 0; i < hookIndex; i++) {
917
- if (!hookState?.next) return null;
918
- hookState = hookState.next;
919
- }
920
- const queue = hookState?.queue;
921
- if (isPOJO(queue) && typeof queue.dispatch === "function") {
922
- return queue.dispatch as (value: unknown) => void;
923
- }
924
- return null;
925
- };
926
-
927
- const findContextProviderFiber = (fiber: Fiber, contextType: unknown): Fiber | null => {
928
- let currentFiber: Fiber | null = fiber;
929
- while (currentFiber) {
930
- const fiberType = currentFiber.type;
931
- if (fiberType === contextType || fiberType?.Provider === contextType) {
932
- return currentFiber;
933
- }
934
- currentFiber = currentFiber.return;
935
- }
936
- return null;
937
- };
938
-
939
- const isPOJO = (maybePOJO: unknown): maybePOJO is Record<string, unknown> => {
940
- return (
941
- Object.prototype.toString.call(maybePOJO) === "[object Object]" &&
942
- (Object.getPrototypeOf(maybePOJO) === Object.prototype ||
943
- Object.getPrototypeOf(maybePOJO) === null)
944
- );
945
- };
946
-
947
- const buildPathsFromValue = (
948
- maybePOJO: Record<string, unknown>,
949
- basePath: string[] = [],
950
- ): Array<{ path: string[]; value: unknown }> => {
951
- if (!isPOJO(maybePOJO)) {
952
- return [{ path: basePath, value: maybePOJO }];
953
- }
954
-
955
- const paths: Array<{ path: string[]; value: unknown }> = [];
956
-
957
- for (const key in maybePOJO) {
958
- const value = maybePOJO[key];
959
- const path = basePath.concat(key);
960
-
961
- if (isPOJO(value)) {
962
- paths.push(...buildPathsFromValue(value, path));
963
- } else {
964
- paths.push({ path, value });
965
- }
966
- }
967
-
968
- return paths;
969
- };
970
-
971
- const buildValueWrites = (partialValue: unknown): Array<{ path: string[]; value: unknown }> =>
972
- isPOJO(partialValue) ? buildPathsFromValue(partialValue) : [{ path: [], value: partialValue }];
973
-
974
- export const overrideProps = (fiber: Fiber, partialValue: Record<string, unknown>) => {
975
- const renderers = resolveOverrideRenderers(fiber);
976
- for (const { path, value } of buildValueWrites(partialValue)) {
977
- applyPropsOverride(renderers, fiber, path, value);
978
- }
979
- };
980
-
981
- export const overrideHookState = (fiber: Fiber, id: number, partialValue: unknown) => {
982
- const renderers = resolveOverrideRenderers(fiber).filter((renderer) =>
983
- Boolean(renderer.overrideHookState),
984
- );
985
- const writes = buildValueWrites(partialValue);
986
-
987
- if (renderers.length > 0) {
988
- const hookId = String(id);
989
- for (const renderer of renderers) {
990
- for (const { path, value } of writes) {
991
- try {
992
- renderer.overrideHookState?.(fiber, hookId, path, value);
993
- } catch {}
994
- }
995
- }
996
- return;
997
- }
998
-
999
- // production renderers don't expose overrideHookState; dispatching through
1000
- // the hook's own queue still works there, but only for whole-value writes
1001
- // (a path write through dispatch would replace the entire hook state)
1002
- if (isPOJO(partialValue)) return;
1003
- const dispatch = getHookStateDispatch(fiber, id);
1004
- if (!dispatch) return;
1005
- try {
1006
- dispatch(partialValue);
1007
- } catch {}
1008
- };
1009
-
1010
- export const overrideContext = (fiber: Fiber, contextType: unknown, partialValue: unknown) => {
1011
- const providerFiber = findContextProviderFiber(fiber, contextType);
1012
- if (!providerFiber) return;
1013
- const renderers = resolveOverrideRenderers(providerFiber);
1014
- for (const { path, value } of buildValueWrites(partialValue)) {
1015
- applyPropsOverride(renderers, providerFiber, ["value", ...path], value);
1016
- if (providerFiber.alternate) {
1017
- applyPropsOverride(renderers, providerFiber.alternate, ["value", ...path], value);
1018
- }
1019
- }
1020
- };
1021
-
1022
618
  export interface InstrumentationOptions {
1023
619
  name?: string;
1024
620
  onActive?: () => unknown;
1025
- onCommitFiberRoot?: (rendererID: number, root: FiberRoot, priority: number | void) => unknown;
621
+ onCommitFiberRoot?: (
622
+ rendererID: number,
623
+ root: FiberRoot,
624
+ priority: number | void,
625
+ didError?: boolean,
626
+ ) => unknown;
1026
627
  onCommitFiberUnmount?: (rendererID: number, fiber: Fiber) => unknown;
1027
628
  onPostCommitFiberRoot?: (rendererID: number, root: FiberRoot) => unknown;
1028
629
  onScheduleFiberRoot?: (rendererID: number, root: FiberRoot, children: React.ReactNode) => unknown;
1029
630
  }
1030
631
 
1031
- const commitFiberRootListeners = new Set<
1032
- NonNullable<InstrumentationOptions["onCommitFiberRoot"]>
1033
- >();
1034
- const commitFiberUnmountListeners = new Set<
1035
- NonNullable<InstrumentationOptions["onCommitFiberUnmount"]>
1036
- >();
1037
- const postCommitFiberRootListeners = new Set<
1038
- NonNullable<InstrumentationOptions["onPostCommitFiberRoot"]>
1039
- >();
1040
- const scheduleFiberRootListeners = new Set<
1041
- NonNullable<InstrumentationOptions["onScheduleFiberRoot"]>
1042
- >();
632
+ interface InstrumentationSubscription {
633
+ options: InstrumentationOptions;
634
+ }
635
+
636
+ const instrumentationSubscriptions = new Set<InstrumentationSubscription>();
1043
637
 
1044
638
  interface HookDispatchers {
1045
639
  onCommitFiberRoot: ReactDevToolsGlobalHook["onCommitFiberRoot"];
@@ -1049,15 +643,14 @@ interface HookDispatchers {
1049
643
  }
1050
644
 
1051
645
  const hookDispatchers = new WeakMap<ReactDevToolsGlobalHook, Partial<HookDispatchers>>();
1052
-
1053
- const rootRendererIds = new WeakMap<FiberRoot, number>();
646
+ let didSubscribeToHookReplacements = false;
1054
647
 
1055
648
  // each hook event is dispatched from a single re-installable wrapper. If
1056
649
  // something overwrites the hook method (devtools, direct assignment), the
1057
650
  // next instrument() call installs a fresh wrapper over it; a superseded
1058
651
  // wrapper still forwards the previous chain but skips the listeners so
1059
652
  // they never fire twice.
1060
- const ensureHookDispatchesToListeners = (rdtHook: ReactDevToolsGlobalHook): void => {
653
+ const setHookEventDispatchers = (rdtHook: ReactDevToolsGlobalHook): void => {
1061
654
  const dispatchers = hookDispatchers.get(rdtHook) ?? {};
1062
655
  hookDispatchers.set(rdtHook, dispatchers);
1063
656
 
@@ -1070,13 +663,29 @@ const ensureHookDispatchesToListeners = (rdtHook: ReactDevToolsGlobalHook): void
1070
663
  rendererID,
1071
664
  root,
1072
665
  priority,
666
+ didError,
1073
667
  ) => {
1074
- prevOnCommitFiberRoot?.(rendererID, root, priority);
668
+ if (prevOnCommitFiberRoot) {
669
+ prevOnCommitFiberRoot.call(rdtHook, rendererID, root, priority, didError);
670
+ }
1075
671
  if (hookDispatchers.get(rdtHook)?.onCommitFiberRoot !== dispatchCommitFiberRoot) return;
1076
- _fiberRoots.add(root);
1077
- rootRendererIds.set(root, rendererID);
1078
- for (const listener of commitFiberRootListeners) {
1079
- listener(rendererID, root, priority);
672
+ setReactWorkTagsForFiber(root.current, rdtHook.renderers.get(rendererID));
673
+ const rootMemoizedState = root.current.memoizedState;
674
+ const isUnmounting =
675
+ rootMemoizedState === null ||
676
+ rootMemoizedState.element === null ||
677
+ rootMemoizedState.element === undefined;
678
+ if (isUnmounting) {
679
+ _fiberRoots.delete(root);
680
+ rootRendererIds.delete(root);
681
+ } else {
682
+ _fiberRoots.add(root);
683
+ rootRendererIds.set(root, rendererID);
684
+ }
685
+ for (const { options } of instrumentationSubscriptions) {
686
+ if (options.onCommitFiberRoot) {
687
+ options.onCommitFiberRoot(rendererID, root, priority, didError);
688
+ }
1080
689
  }
1081
690
  };
1082
691
  dispatchers.onCommitFiberRoot = dispatchCommitFiberRoot;
@@ -1092,12 +701,17 @@ const ensureHookDispatchesToListeners = (rdtHook: ReactDevToolsGlobalHook): void
1092
701
  rendererID,
1093
702
  fiber,
1094
703
  ) => {
1095
- prevOnCommitFiberUnmount?.(rendererID, fiber);
704
+ setReactWorkTagsForFiber(fiber, rdtHook.renderers.get(rendererID));
705
+ if (prevOnCommitFiberUnmount) {
706
+ prevOnCommitFiberUnmount.call(rdtHook, rendererID, fiber);
707
+ }
1096
708
  if (hookDispatchers.get(rdtHook)?.onCommitFiberUnmount !== dispatchCommitFiberUnmount) {
1097
709
  return;
1098
710
  }
1099
- for (const listener of commitFiberUnmountListeners) {
1100
- listener(rendererID, fiber);
711
+ for (const { options } of instrumentationSubscriptions) {
712
+ if (options.onCommitFiberUnmount) {
713
+ options.onCommitFiberUnmount(rendererID, fiber);
714
+ }
1101
715
  }
1102
716
  };
1103
717
  dispatchers.onCommitFiberUnmount = dispatchCommitFiberUnmount;
@@ -1113,12 +727,16 @@ const ensureHookDispatchesToListeners = (rdtHook: ReactDevToolsGlobalHook): void
1113
727
  rendererID,
1114
728
  root,
1115
729
  ) => {
1116
- prevOnPostCommitFiberRoot?.(rendererID, root);
730
+ if (prevOnPostCommitFiberRoot) {
731
+ prevOnPostCommitFiberRoot.call(rdtHook, rendererID, root);
732
+ }
1117
733
  if (hookDispatchers.get(rdtHook)?.onPostCommitFiberRoot !== dispatchPostCommitFiberRoot) {
1118
734
  return;
1119
735
  }
1120
- for (const listener of postCommitFiberRootListeners) {
1121
- listener(rendererID, root);
736
+ for (const { options } of instrumentationSubscriptions) {
737
+ if (options.onPostCommitFiberRoot) {
738
+ options.onPostCommitFiberRoot(rendererID, root);
739
+ }
1122
740
  }
1123
741
  };
1124
742
  dispatchers.onPostCommitFiberRoot = dispatchPostCommitFiberRoot;
@@ -1135,10 +753,14 @@ const ensureHookDispatchesToListeners = (rdtHook: ReactDevToolsGlobalHook): void
1135
753
  root,
1136
754
  children,
1137
755
  ) => {
1138
- prevOnScheduleFiberRoot?.(rendererID, root, children);
756
+ if (prevOnScheduleFiberRoot) {
757
+ prevOnScheduleFiberRoot.call(rdtHook, rendererID, root, children);
758
+ }
1139
759
  if (hookDispatchers.get(rdtHook)?.onScheduleFiberRoot !== dispatchScheduleFiberRoot) return;
1140
- for (const listener of scheduleFiberRootListeners) {
1141
- listener(rendererID, root, children);
760
+ for (const { options } of instrumentationSubscriptions) {
761
+ if (options.onScheduleFiberRoot) {
762
+ options.onScheduleFiberRoot(rendererID, root, children);
763
+ }
1142
764
  }
1143
765
  };
1144
766
  dispatchers.onScheduleFiberRoot = dispatchScheduleFiberRoot;
@@ -1146,13 +768,24 @@ const ensureHookDispatchesToListeners = (rdtHook: ReactDevToolsGlobalHook): void
1146
768
  }
1147
769
  };
1148
770
 
771
+ const wireHookEventDispatchers = (rdtHook: ReactDevToolsGlobalHook): void => {
772
+ if (!didSubscribeToHookReplacements) {
773
+ onRDTHookReplace(setHookEventDispatchers);
774
+ didSubscribeToHookReplacements = true;
775
+ }
776
+ setHookEventDispatchers(rdtHook);
777
+ };
778
+
779
+ if (hasRDTHook()) {
780
+ wireHookEventDispatchers(getRDTHook());
781
+ }
782
+
1149
783
  /**
1150
784
  * Instruments the DevTools hook. Each hook event is patched once and
1151
785
  * dispatches to a set of listeners, so multiple `instrument` calls compose
1152
786
  * without stacking patches. Returns an unsubscribe function that removes
1153
787
  * exactly the handlers this call registered.
1154
- * The returned function is also a `Disposable`, so it composes with other
1155
- * bippy subscriptions through `using`.
788
+ * The unsubscribe function can also be disposed through `using`.
1156
789
  * @example
1157
790
  * const unsubscribe = instrument({
1158
791
  * onActive() {
@@ -1166,35 +799,19 @@ const ensureHookDispatchesToListeners = (rdtHook: ReactDevToolsGlobalHook): void
1166
799
  */
1167
800
  export const instrument = (options: InstrumentationOptions): Unsubscribe => {
1168
801
  const rdtHook = getRDTHook(options.onActive);
1169
-
1170
802
  rdtHook._instrumentationSource = options.name ?? BIPPY_INSTRUMENTATION_STRING;
1171
803
 
1172
- ensureHookDispatchesToListeners(rdtHook);
1173
-
1174
- const {
1175
- onActive,
1176
- onCommitFiberRoot,
1177
- onCommitFiberUnmount,
1178
- onPostCommitFiberRoot,
1179
- onScheduleFiberRoot,
1180
- } = options;
1181
- if (onCommitFiberRoot) commitFiberRootListeners.add(onCommitFiberRoot);
1182
- if (onCommitFiberUnmount) commitFiberUnmountListeners.add(onCommitFiberUnmount);
1183
- if (onPostCommitFiberRoot) postCommitFiberRootListeners.add(onPostCommitFiberRoot);
1184
- if (onScheduleFiberRoot) scheduleFiberRootListeners.add(onScheduleFiberRoot);
1185
-
1186
- return toUnsubscribe(() => {
1187
- if (onActive) _onActiveListeners.delete(onActive);
1188
- if (onCommitFiberRoot) commitFiberRootListeners.delete(onCommitFiberRoot);
1189
- if (onCommitFiberUnmount) commitFiberUnmountListeners.delete(onCommitFiberUnmount);
1190
- if (onPostCommitFiberRoot) postCommitFiberRootListeners.delete(onPostCommitFiberRoot);
1191
- if (onScheduleFiberRoot) scheduleFiberRootListeners.delete(onScheduleFiberRoot);
804
+ wireHookEventDispatchers(rdtHook);
805
+ const subscription: InstrumentationSubscription = { options };
806
+ instrumentationSubscriptions.add(subscription);
807
+
808
+ return createUnsubscribe(() => {
809
+ if (options.onActive) _onActiveListeners.delete(options.onActive);
810
+ instrumentationSubscriptions.delete(subscription);
1192
811
  });
1193
812
  };
1194
813
 
1195
- // React stamps fibers under per-renderer random-suffix keys (`__reactFiber$<suffix>`);
1196
- // caching discovered keys makes repeat lookups a single property read instead of a
1197
- // scan over every own key of the element.
814
+ // React uses per-renderer suffixes for host-instance Fiber keys, so discovered keys are cached.
1198
815
  const knownFiberPropertyKeys = new Set<string>();
1199
816
 
1200
817
  const isFiberPropertyKey = (key: string): boolean =>
@@ -1202,7 +819,38 @@ const isFiberPropertyKey = (key: string): boolean =>
1202
819
  key.startsWith("__reactInternalInstance$") ||
1203
820
  key.startsWith("__reactFiber");
1204
821
 
1205
- export const getFiberFromHostInstance = <T>(hostInstance: T): Fiber | null => {
822
+ const getLegacyRootFiber = (hostInstance: object): Fiber | null => {
823
+ const reactRootContainer = Reflect.get(hostInstance, "_reactRootContainer");
824
+ if (typeof reactRootContainer !== "object" || reactRootContainer === null) return null;
825
+ const internalRoot = Reflect.get(reactRootContainer, "_internalRoot");
826
+ if (typeof internalRoot !== "object" || internalRoot === null) return null;
827
+ const current = Reflect.get(internalRoot, "current");
828
+ if (typeof current !== "object" || current === null) return null;
829
+ const child = Reflect.get(current, "child");
830
+ return isFiber(child) ? child : null;
831
+ };
832
+
833
+ const getInternalInstanceHandle = (hostInstance: object): Fiber | null => {
834
+ const internalInstanceHandle =
835
+ Reflect.get(hostInstance, "__internalInstanceHandle") ??
836
+ Reflect.get(hostInstance, "_internalInstanceHandle");
837
+ return isFiber(internalInstanceHandle) ? internalInstanceHandle : null;
838
+ };
839
+
840
+ const getPublicHostInstance = (stateNode: unknown): unknown => {
841
+ if (typeof stateNode !== "object" || stateNode === null) return stateNode;
842
+ const canonical = Reflect.get(stateNode, "canonical");
843
+ if (typeof canonical === "object" && canonical !== null) {
844
+ const publicInstance = Reflect.get(canonical, "publicInstance");
845
+ if (typeof publicInstance === "object" && publicInstance !== null) {
846
+ return publicInstance;
847
+ }
848
+ }
849
+ const nativeTag = Reflect.get(stateNode, "_nativeTag");
850
+ return typeof nativeTag === "number" ? nativeTag : stateNode;
851
+ };
852
+
853
+ export const getFiber = <T>(hostInstance: T): Fiber | null => {
1206
854
  const rdtHook = globalThis.__REACT_DEVTOOLS_GLOBAL_HOOK__;
1207
855
  if (rdtHook?.renderers) {
1208
856
  for (const renderer of rdtHook.renderers.values()) {
@@ -1213,42 +861,38 @@ export const getFiberFromHostInstance = <T>(hostInstance: T): Fiber | null => {
1213
861
  }
1214
862
  }
1215
863
 
1216
- if (typeof hostInstance === "object" && hostInstance != null) {
1217
- if ("_reactRootContainer" in hostInstance) {
1218
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
1219
- return (hostInstance._reactRootContainer as any)?._internalRoot?.current?.child;
1220
- }
864
+ if (typeof hostInstance === "object" && hostInstance !== null) {
865
+ const legacyRootFiber = getLegacyRootFiber(hostInstance);
866
+ if (legacyRootFiber) return legacyRootFiber;
1221
867
 
1222
- // React Native Fabric public instances (ReactNativeElement /
1223
- // ReactFabricHostComponent) store their fiber as the "internal instance
1224
- // handle" instead of a __reactFiber$-prefixed key
1225
- const fabricInstanceHandle =
1226
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
1227
- (hostInstance as any).__internalInstanceHandle ??
1228
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
1229
- (hostInstance as any)._internalInstanceHandle;
1230
- if (isFiber(fabricInstanceHandle)) {
1231
- return fabricInstanceHandle;
1232
- }
868
+ const internalInstanceHandle = getInternalInstanceHandle(hostInstance);
869
+ if (internalInstanceHandle) return internalInstanceHandle;
1233
870
 
1234
- const hostInstanceRecord = hostInstance as Record<string, unknown>;
1235
871
  for (const knownKey of knownFiberPropertyKeys) {
1236
- const fiber = hostInstanceRecord[knownKey];
1237
- if (fiber) return fiber as Fiber;
872
+ const fiber = Reflect.get(hostInstance, knownKey);
873
+ if (isFiber(fiber)) return fiber;
1238
874
  }
1239
875
 
1240
- for (const key of Object.keys(hostInstanceRecord)) {
876
+ for (const key of Object.keys(hostInstance)) {
1241
877
  if (isFiberPropertyKey(key)) {
1242
878
  knownFiberPropertyKeys.add(key);
1243
- return (hostInstanceRecord[key] || null) as Fiber | null;
879
+ const fiber = Reflect.get(hostInstance, key);
880
+ if (isFiber(fiber)) return fiber;
1244
881
  }
1245
882
  }
883
+ }
1246
884
 
885
+ if (
886
+ hostInstance !== null &&
887
+ hostInstance !== undefined &&
888
+ (typeof hostInstance === "object" || typeof hostInstance === "number")
889
+ ) {
1247
890
  for (const fiberRoot of _fiberRoots) {
1248
- if (getRootRenderer(fiberRoot.current)?.findFiberByHostInstance) continue;
1249
891
  const fiber = traverseFiber(
1250
892
  fiberRoot.current,
1251
- (candidateFiber) => candidateFiber.stateNode === hostInstance,
893
+ (candidateFiber) =>
894
+ isHostFiber(candidateFiber) &&
895
+ getPublicHostInstance(candidateFiber.stateNode) === hostInstance,
1252
896
  );
1253
897
  if (fiber) return fiber;
1254
898
  }
@@ -1256,6 +900,19 @@ export const getFiberFromHostInstance = <T>(hostInstance: T): Fiber | null => {
1256
900
  return null;
1257
901
  };
1258
902
 
1259
- export * from "./rdt-hook.js";
1260
- export * from "./unsubscribe.js";
1261
- export type * from "./types.js";
903
+ export const getFiberFromHostInstance = getFiber;
904
+
905
+ export {
906
+ BIPPY_INSTRUMENTATION_STRING,
907
+ _onActiveListeners,
908
+ _renderers,
909
+ getRDTHook,
910
+ hasRDTHook,
911
+ installRDTHook,
912
+ isRealReactDevtools,
913
+ onRendererInject,
914
+ patchRDTHook,
915
+ version,
916
+ } from "./rdt-hook.js";
917
+ export type { Unsubscribe } from "./rdt-hook.js";
918
+ export * from "./react-internals/index.js";