@bugsee/react-native 0.0.0-stage → 7.0.0-beta1
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.
- package/BugseeReactNative.podspec +95 -0
- package/LICENSE +21 -0
- package/README.md +552 -2
- package/android/build.gradle +162 -0
- package/android/consumer-rules.pro +2 -0
- package/android/src/main/AndroidManifest.xml +33 -0
- package/android/src/main/java/com/bugsee/reactnative/AppearanceBridge.java +82 -0
- package/android/src/main/java/com/bugsee/reactnative/AttributeBridge.java +209 -0
- package/android/src/main/java/com/bugsee/reactnative/BreadcrumbFilterBridge.java +443 -0
- package/android/src/main/java/com/bugsee/reactnative/BridgeJson.java +168 -0
- package/android/src/main/java/com/bugsee/reactnative/BugseeModule.java +1869 -0
- package/android/src/main/java/com/bugsee/reactnative/BugseeOptionEnums.java +136 -0
- package/android/src/main/java/com/bugsee/reactnative/BugseePackage.java +42 -0
- package/android/src/main/java/com/bugsee/reactnative/BugseeReactNativeWrapper.java +200 -0
- package/android/src/main/java/com/bugsee/reactnative/BugseeStatusMapper.java +66 -0
- package/android/src/main/java/com/bugsee/reactnative/BugseeTokens.java +22 -0
- package/android/src/main/java/com/bugsee/reactnative/ConsoleEchoDedup.java +202 -0
- package/android/src/main/java/com/bugsee/reactnative/CreatedReports.java +127 -0
- package/android/src/main/java/com/bugsee/reactnative/DataRequestBridge.java +375 -0
- package/android/src/main/java/com/bugsee/reactnative/ExceptionBridge.java +88 -0
- package/android/src/main/java/com/bugsee/reactnative/ExceptionExecutors.java +33 -0
- package/android/src/main/java/com/bugsee/reactnative/LogFilterBridge.java +375 -0
- package/android/src/main/java/com/bugsee/reactnative/NetworkEvents.java +227 -0
- package/android/src/main/java/com/bugsee/reactnative/NetworkFilterBridge.java +498 -0
- package/android/src/main/java/com/bugsee/reactnative/PluginEndpoint.java +48 -0
- package/android/src/main/java/com/bugsee/reactnative/ReactNativeWebException.java +19 -0
- package/android/src/main/java/com/bugsee/reactnative/ReactNativeWrapperInitProvider.java +61 -0
- package/android/src/main/java/com/bugsee/reactnative/ReactRootOriginTracker.java +867 -0
- package/android/src/main/java/com/bugsee/reactnative/ReportArgs.java +58 -0
- package/android/src/main/java/com/bugsee/reactnative/ReportHandlerBridge.java +336 -0
- package/android/src/main/java/com/bugsee/reactnative/ReportHandlerDeadlines.java +57 -0
- package/android/src/main/java/com/bugsee/reactnative/ReportOps.java +287 -0
- package/android/src/main/java/com/bugsee/reactnative/SecureRectanglePulls.java +113 -0
- package/android/src/main/java/com/bugsee/reactnative/SecureRectangleStore.java +692 -0
- package/android/src/main/java/com/bugsee/reactnative/SpanHandles.java +143 -0
- package/android/src/main/java/com/bugsee/reactnative/WrapperChannelHolder.java +137 -0
- package/android/src/main/java/com/bugsee/reactnative/WrapperEventBus.java +110 -0
- package/android/src/main/java/com/bugsee/reactnative/WrapperRegistrar.java +54 -0
- package/app.plugin.js +4 -0
- package/ios/BGSRNConsoleCapture.h +52 -0
- package/ios/BGSRNConsoleCapture.mm +344 -0
- package/ios/BugseeModule.h +25 -0
- package/ios/BugseeModule.mm +2728 -0
- package/ios/Package.swift +71 -0
- package/ios/Support/Package.resolved +14 -0
- package/ios/Support/Package.swift +44 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNAttributes.m +52 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNCreatedReportOps.m +236 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNCreatedReports.m +184 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNDataRequestBridge.m +431 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNErrorMessage.m +40 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNEventBus.m +70 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNExceptions.m +63 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNGuardedEmit.mm +32 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNJSON.m +40 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNLaunchHold.m +147 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNMainThread.m +23 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNNetworkEvents.m +159 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNNetworkFilter.m +155 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNPluginEndpoint.m +21 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNReactRootOriginTracker.m +63 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNReactWindow.m +251 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNReportArgs.m +47 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNReportDeadlines.m +8 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNReportHandlerBridge.m +308 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNReportOps.m +345 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNSecureRectangles.m +508 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNSettleOnce.m +62 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNSpanHandles.m +136 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNStatusMapper.m +18 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNTokens.m +9 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNValues.m +5 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNWrapper.m +54 -0
- package/ios/Support/Sources/BugseeRNSupport/BGSRNWrapperChannelHolder.m +59 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNAttributes.h +63 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNCreatedReportOps.h +51 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNCreatedReports.h +81 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNDataRequestBridge.h +118 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNErrorMessage.h +30 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNEventBus.h +45 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNExceptions.h +31 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNGuardedEmit.h +31 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNJSON.h +25 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNLaunchHold.h +86 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNMainThread.h +32 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNNetworkEvents.h +28 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNNetworkFilter.h +28 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNPluginEndpoint.h +17 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReactRootOriginTracker.h +48 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReactWindow.h +135 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReportArgs.h +17 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReportDeadlines.h +37 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReportHandlerBridge.h +94 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNReportOps.h +86 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNSecureRectangles.h +198 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNSettleOnce.h +25 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNSpanHandles.h +49 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNStatusMapper.h +26 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNTokens.h +14 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNValues.h +18 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNWrapper.h +40 -0
- package/ios/Support/Sources/BugseeRNSupport/include/BGSRNWrapperChannelHolder.h +74 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNAttributesTests.m +194 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNCreatedReportOpsTests.m +274 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNCreatedReportsTests.m +240 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNDataRequestBridgeTests.m +685 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNErrorMessageTests.m +102 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNEventBusTests.m +136 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNExceptionsTests.m +68 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNFakeReport.h +41 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNFakeReport.m +166 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNGuardedEmitTests.mm +85 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNJSONTests.m +281 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNLaunchHoldTests.m +230 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNMainThreadTests.m +97 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNNetworkEventsTests.m +99 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNNetworkFilterTests.m +134 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNPluginEndpointTests.m +38 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReactRootOriginTrackerTests.m +210 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReactWindowTests.m +548 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReportArgsTests.m +51 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReportDeadlinesTests.m +22 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReportHandlerBridgeTests.m +382 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNReportOpsTests.m +295 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNSecureRectanglesTests.m +568 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNSettleOnceTests.m +134 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNSpanHandlesTests.m +153 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNStatusMapperTests.m +81 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNValuesTests.m +32 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNWrapperChannelHolderTests.m +205 -0
- package/ios/Support/Tests/BugseeRNSupportTests/BGSRNWrapperTests.m +66 -0
- package/ios/react-native-spm-prefix.h +10 -0
- package/native-versions.json +10 -0
- package/package.json +62 -3
- package/plugin/build/bundle-phase.d.ts +41 -0
- package/plugin/build/bundle-phase.js +116 -0
- package/plugin/build/bundle-phase.js.map +1 -0
- package/plugin/build/dsym-script.d.ts +32 -0
- package/plugin/build/dsym-script.js +159 -0
- package/plugin/build/dsym-script.js.map +1 -0
- package/plugin/build/endpoint.d.ts +30 -0
- package/plugin/build/endpoint.js +69 -0
- package/plugin/build/endpoint.js.map +1 -0
- package/plugin/build/gradle.d.ts +65 -0
- package/plugin/build/gradle.js +1066 -0
- package/plugin/build/gradle.js.map +1 -0
- package/plugin/build/index.d.ts +85 -0
- package/plugin/build/index.js +217 -0
- package/plugin/build/index.js.map +1 -0
- package/plugin/build/manifest.d.ts +48 -0
- package/plugin/build/manifest.js +69 -0
- package/plugin/build/manifest.js.map +1 -0
- package/plugin/build/native-versions.baked.json +4 -0
- package/plugin/build/native-versions.d.ts +10 -0
- package/plugin/build/native-versions.js +27 -0
- package/plugin/build/native-versions.js.map +1 -0
- package/plugin/build/pbx-string.d.ts +8 -0
- package/plugin/build/pbx-string.js +31 -0
- package/plugin/build/pbx-string.js.map +1 -0
- package/plugin/build/podfile.d.ts +3 -0
- package/plugin/build/podfile.js +28 -0
- package/plugin/build/podfile.js.map +1 -0
- package/plugin/build/properties.d.ts +19 -0
- package/plugin/build/properties.js +41 -0
- package/plugin/build/properties.js.map +1 -0
- package/plugin/build/scheme.d.ts +20 -0
- package/plugin/build/scheme.js +107 -0
- package/plugin/build/scheme.js.map +1 -0
- package/react-native.config.js +26 -0
- package/scripts/bugsee-sourcemaps.gradle +201 -0
- package/scripts/bugsee-xcode.sh +83 -0
- package/scripts/compose-then-inject.js +113 -0
- package/scripts/hermes-sourcemaps.js +634 -0
- package/scripts/hermesc-preserve-js.cmd +6 -0
- package/scripts/hermesc-preserve-js.js +200 -0
- package/scripts/hermesc-preserve-js.sh +7 -0
- package/src/NativeBugsee.ts +622 -0
- package/src/apm/notify.ts +58 -0
- package/src/apm/span.ts +403 -0
- package/src/apm/types.ts +57 -0
- package/src/appearance/report.ts +171 -0
- package/src/architecture.ts +48 -0
- package/src/attributes/errors.ts +39 -0
- package/src/attributes/validate.ts +150 -0
- package/src/breadcrumbs/add.ts +58 -0
- package/src/breadcrumbs/data.ts +33 -0
- package/src/breadcrumbs/filter.ts +215 -0
- package/src/breadcrumbs/types.ts +64 -0
- package/src/bridge/json.ts +110 -0
- package/src/console/capture.ts +180 -0
- package/src/console/dedup.ts +175 -0
- package/src/data/validate.ts +259 -0
- package/src/errorName.ts +32 -0
- package/src/exceptions/ErrorBoundary.tsx +92 -0
- package/src/exceptions/RootErrorReporter.tsx +61 -0
- package/src/exceptions/debugIds.ts +118 -0
- package/src/exceptions/handlers.ts +236 -0
- package/src/exceptions/options.ts +85 -0
- package/src/exceptions/payload.ts +456 -0
- package/src/exceptions/report.ts +170 -0
- package/src/exceptions/sha1.ts +148 -0
- package/src/exceptions/stack.ts +355 -0
- package/src/index.ts +944 -0
- package/src/logs/filter.ts +90 -0
- package/src/logs/log.ts +36 -0
- package/src/network/add.ts +165 -0
- package/src/network/filter.ts +198 -0
- package/src/options/AndroidLaunchOptions.ts +78 -0
- package/src/options/BugseeLaunchOptions.ts +190 -0
- package/src/options/IOSLaunchOptions.ts +57 -0
- package/src/options/android-options-manifest.json +646 -0
- package/src/options/createDefaultLaunchOptions.ts +29 -0
- package/src/options/endpoint.ts +58 -0
- package/src/options/enums.ts +104 -0
- package/src/options/ios-enums.json +19 -0
- package/src/options/keys.ts +39 -0
- package/src/options/option-enums.json +34 -0
- package/src/options/option-keys.json +107 -0
- package/src/report/BugseeReport.ts +264 -0
- package/src/report/CreatedReport.ts +127 -0
- package/src/report/dispatcher.ts +95 -0
- package/src/report/errors.ts +48 -0
- package/src/report/fields.ts +40 -0
- package/src/report/types.ts +157 -0
- package/src/report/validate.ts +197 -0
- package/src/secure/BugseeSecure.tsx +202 -0
- package/src/secure/ancestry.ts +622 -0
- package/src/secure/drivers.ts +342 -0
- package/src/secure/followEvents.ts +57 -0
- package/src/secure/hold.ts +99 -0
- package/src/secure/measureLoop.ts +323 -0
- package/src/secure/nativeAnimation.ts +1005 -0
- package/src/secure/rectangles.ts +93 -0
- package/src/secure/registry.ts +237 -0
- package/src/secure/surface.ts +83 -0
- package/src/secure/tracker.ts +723 -0
- package/src/secure/transition.ts +488 -0
- package/src/secure/unit.ts +22 -0
- package/src/status.ts +16 -0
- package/src/version.ts +9 -0
- package/src/viewtree/anchor.tsx +105 -0
- package/src/viewtree/constants.ts +20 -0
- package/src/viewtree/fiber.ts +251 -0
- package/src/viewtree/requests.ts +347 -0
- package/src/viewtree/walk.ts +902 -0
- package/src/wrapper/channel.ts +33 -0
- package/src/wrapper/collect.ts +52 -0
- package/src/wrapper/events.ts +45 -0
- package/src/wrapper/identity.ts +54 -0
- package/src/wrapper/lifecycle-events.ts +89 -0
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
import { useLayoutEffect, useRef } from 'react';
|
|
2
|
+
import type { ComponentRef, ReactElement, ReactNode } from 'react';
|
|
3
|
+
import { View } from 'react-native';
|
|
4
|
+
import type { LayoutChangeEvent, ViewProps } from 'react-native';
|
|
5
|
+
import { SecureTracker } from './tracker';
|
|
6
|
+
|
|
7
|
+
export interface BugseeSecureProps extends ViewProps {
|
|
8
|
+
/** While false, nothing is redacted and nothing is measured. Default true. */
|
|
9
|
+
enabled?: boolean;
|
|
10
|
+
children?: ReactNode;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* Keeps Bugsee from recording whatever it wraps, for as long as it is mounted
|
|
15
|
+
* and enabled.
|
|
16
|
+
*
|
|
17
|
+
* It measures its own view in the window on mount, on every layout and every
|
|
18
|
+
* `SECURE_REMEASURE_MS` (an ancestor scrolling moves it without a layout
|
|
19
|
+
* event), and publishes that rectangle through the shared registry, so it
|
|
20
|
+
* never disturbs what `Bugsee.setSecureRectangles` set or another instance
|
|
21
|
+
* holds.
|
|
22
|
+
*
|
|
23
|
+
* Only the part that is on screen is published: the rectangle is cut to every
|
|
24
|
+
* ancestor that clips it, up to its surface's root (a ScrollView's viewport,
|
|
25
|
+
* or a view styled `overflow: 'hidden'`). A view scrolled fully out of sight
|
|
26
|
+
* publishes nothing, so it does not mask, or drop the taps on, whatever is
|
|
27
|
+
* shown there instead (a bottom tab bar, say).
|
|
28
|
+
*
|
|
29
|
+
* Nothing is measured, and in the end nothing published, while a
|
|
30
|
+
* react-native-screens screen above it is inactive in the committed tree
|
|
31
|
+
* (`activityState` 0 under a screens container, such as an inactive tab that
|
|
32
|
+
* stays mounted): that hides a view without changing its layout. A view
|
|
33
|
+
* hidden by `display: 'none'` or a hidden `<Activity>` measures 0x0, which
|
|
34
|
+
* publishes nothing anyway.
|
|
35
|
+
*
|
|
36
|
+
* Coverage is added at once and removed late. What it measures describes the
|
|
37
|
+
* shadow tree, which native draws a frame or more later (a LayoutAnimation
|
|
38
|
+
* only at its end), so what it stopped covering, by shrinking, moving or
|
|
39
|
+
* being hidden, stays published for `SECURE_SHRINK_HOLD_MS`. Growth is never
|
|
40
|
+
* delayed.
|
|
41
|
+
*
|
|
42
|
+
* Kept up to date within a frame where it matters, at a cost bounded by what
|
|
43
|
+
* moves: a view that moves, was just shown or is clipped re-measures every
|
|
44
|
+
* frame until it has stayed put for `STEADY_FRAMES` frames; a clipped view
|
|
45
|
+
* that is still is woken the frame its ScrollView's content (watched once a
|
|
46
|
+
* frame for every view under it) moves; a withdrawn view asks every frame,
|
|
47
|
+
* once per screen, whether its screens still hide it, and is back the frame
|
|
48
|
+
* they do not.
|
|
49
|
+
*
|
|
50
|
+
* Unmounting removes it late too: native draws the view until it mounts the
|
|
51
|
+
* commit that removed it, so what it covered stays published for
|
|
52
|
+
* `SECURE_SHRINK_HOLD_MS`.
|
|
53
|
+
*
|
|
54
|
+
* Native transitions draw it where no measurement can follow, so for
|
|
55
|
+
* `SECURE_TRANSITION_HOLD_MS` from the commit that starts one it also covers
|
|
56
|
+
* where they can. While a react-native-screens stack pushes or pops a
|
|
57
|
+
* screen, a view on that screen, or on the screen it uncovers or covers,
|
|
58
|
+
* covers by the screen's `stackAnimation`: its band across the screen for a
|
|
59
|
+
* sideways slide, the column below it for a slide from the bottom, itself
|
|
60
|
+
* for a fade, and the whole screen for the platform default or anything
|
|
61
|
+
* else. A view in a `<Modal animationType="slide">` covers the band below
|
|
62
|
+
* it while the Modal slides in or out (also when `visible` turns false on a
|
|
63
|
+
* Modal that stays mounted). A screen replaced on its stack (`replace`) is
|
|
64
|
+
* animated out by the incoming screen's animation, and covered by it. A view
|
|
65
|
+
* that mounts, or is shown, in a screen or Modal still within the hold from
|
|
66
|
+
* its push or opening is covered too (content that arrives after a spinner),
|
|
67
|
+
* and re-measured every frame until it settles, so a Modal laid out again
|
|
68
|
+
* once its dialog is up is followed within a frame; so is a view first shown
|
|
69
|
+
* on the screen a pop uncovers (mounted while that screen was hidden, or
|
|
70
|
+
* during the pop), for the rest of the pop's hold. Each stack keeps what any
|
|
71
|
+
* view saw of its recent pushes and pops. When a screen or Modal came or
|
|
72
|
+
* went is known only if a `<BugseeSecure>` saw it (one on it, or on another
|
|
73
|
+
* screen of its stack); otherwise the first view to look takes it as
|
|
74
|
+
* happening then, once per change (a stack read for the first time is
|
|
75
|
+
* compared with its render before).
|
|
76
|
+
*
|
|
77
|
+
* A native-driven `Animated` transform above it (`useNativeDriver: true`)
|
|
78
|
+
* never reaches the shadow tree, so it also covers every place that
|
|
79
|
+
* transform can draw it, joined with where it is measured: translations and
|
|
80
|
+
* scales (about `transformOrigin`) bounded from the animated value, its
|
|
81
|
+
* running timing animation, interpolations, `diffClamp` and arithmetic
|
|
82
|
+
* nodes. A value a native event is attached to (an `Animated.event` in an
|
|
83
|
+
* `Animated` component's props, such as an `Animated.ScrollView`'s
|
|
84
|
+
* `onScroll` or a gesture handler's `onGestureEvent`, or one attached with
|
|
85
|
+
* `Animated.attachNativeEvent`, as React Native's ScrollView does for its
|
|
86
|
+
* sticky headers) moves wherever the scroll or the gesture takes it, for as
|
|
87
|
+
* long as it is attached, idle or not, whatever animated it before. It is
|
|
88
|
+
* bounded only where that is provable: through an interpolation that clamps,
|
|
89
|
+
* or extends a flat last segment, at both ends (within its outputs, eased);
|
|
90
|
+
* through `diffClamp`; and, on Android, as a ScrollView's `contentOffset`
|
|
91
|
+
* (vertical or horizontal), within the offsets the ScrollView can reach
|
|
92
|
+
* (from its measured content and viewport, and a fling's overrun past either
|
|
93
|
+
* end, `SCROLL_OVERRUN`), unless it is under a scale other than 1, or inside
|
|
94
|
+
* that ScrollView's own content (a sticky header: its content moves by the
|
|
95
|
+
* same offset, natively ahead of the shadow tree). What cannot
|
|
96
|
+
* be bounded (any other event's value, an iOS ScrollView's offset, a rotation, a
|
|
97
|
+
* spring, a node React Native renamed) covers the whole surface, cut by the
|
|
98
|
+
* clipping ancestors above it, for as long as it cannot be. A view under a
|
|
99
|
+
* running native animation is re-measured every frame. When JS moves a value
|
|
100
|
+
* above it (starts an animation on it, the first with the native driver
|
|
101
|
+
* included, which makes it native and commits nothing; sets, resets or
|
|
102
|
+
* offsets it), the view is measured and published in that same JS task,
|
|
103
|
+
* before React Native hands the change to the UI thread; what native does to
|
|
104
|
+
* a still native value on its own (an animation ending) is seen by the next
|
|
105
|
+
* JS frame. A transform animated from JS (`useNativeDriver: false`) moves the
|
|
106
|
+
* view every frame through Fabric with no wrapped call: the view is
|
|
107
|
+
* re-measured every frame while the animation runs, and an idle value driven
|
|
108
|
+
* from JS keeps no frame loop running. Other styles a JS animation moves
|
|
109
|
+
* (`top`, `left`, a size) are followed by the 100 ms re-measure only.
|
|
110
|
+
*
|
|
111
|
+
* What drives a native value is followed from when the package is first
|
|
112
|
+
* evaluated (its entry imports `secure/followEvents` for that, so Metro's
|
|
113
|
+
* `inlineRequires` does not defer it to the first `<BugseeSecure>`; it does
|
|
114
|
+
* defer the entry to its first use: import the package, or call
|
|
115
|
+
* `Bugsee.launch`, at the top of `index.js`): the
|
|
116
|
+
* events attached to it, and its being made native. A native value made
|
|
117
|
+
* native before that, or left wherever its last event took it, is unbounded
|
|
118
|
+
* until it next animates. Where React Native's internals cannot be followed
|
|
119
|
+
* (React Native moved them), no still native value is trusted: every one is
|
|
120
|
+
* unbounded.
|
|
121
|
+
*
|
|
122
|
+
* Known limits: Reanimated runs its animations on the UI thread, out of
|
|
123
|
+
* JS's sight; a Reanimated component whose style sets a transform through
|
|
124
|
+
* an animated style, sets a shared value inline, or uses a CSS animation or
|
|
125
|
+
* transition covers the whole surface, cut by the clipping ancestors above
|
|
126
|
+
* it; anything else Reanimated moves (an animated style that adds a
|
|
127
|
+
* transform only later, layout animations, `entering`/`exiting`, shared
|
|
128
|
+
* transitions) is not seen. An interactive back gesture moves a mounted
|
|
129
|
+
* screen with nothing JS sees. The cover published as JS starts a native
|
|
130
|
+
* animation and the animation itself reach native separately; under heavy
|
|
131
|
+
* load the UI thread could still draw its first frame before the cover lands.
|
|
132
|
+
* A native event attached without `Animated` (code that calls React
|
|
133
|
+
* Native's native Animated module itself) is not seen, and its value is
|
|
134
|
+
* taken where JS last had it.
|
|
135
|
+
*
|
|
136
|
+
* Fails closed: a measurement that throws or is rejected leaves the last
|
|
137
|
+
* rectangle published, and an ancestor that cannot be read or measured cuts
|
|
138
|
+
* nothing off it. Only `enabled={false}` removes it at once.
|
|
139
|
+
*
|
|
140
|
+
* Known limit: how an ancestor clips is read from its committed React props.
|
|
141
|
+
* An `overflow` changed natively, through `setNativeProps` or a native-driven
|
|
142
|
+
* style, is not seen: a view still believed clipped by an ancestor that no
|
|
143
|
+
* longer clips publishes only the part inside the old clip.
|
|
144
|
+
*
|
|
145
|
+
* Fabric `measureInWindow` is relative to the measured node's nearest
|
|
146
|
+
* `RootNodeKind` ancestor: the app's root, or the content of the `<Modal>`
|
|
147
|
+
* it is in. The rectangle is published under that surface's key (the Modal
|
|
148
|
+
* host's tag, read off the fiber tree once per mount), so native translates
|
|
149
|
+
* it by that surface's origin at pull time. No native call is made to find
|
|
150
|
+
* the surface. On iOS that origin includes the window's place on its screen
|
|
151
|
+
* (Stage Manager, Split View, iPhone Duo side by side), where the SDK draws.
|
|
152
|
+
*
|
|
153
|
+
* A plain function component on purpose (no `memo`, no `forwardRef`): the view
|
|
154
|
+
* tree walk recognises it by identity.
|
|
155
|
+
*/
|
|
156
|
+
/** No dependencies: an effect that runs once per mount. */
|
|
157
|
+
// Stryker disable next-line ArrayDeclaration -- any constant list runs it once per mount alike
|
|
158
|
+
const ONCE_PER_MOUNT: readonly unknown[] = [];
|
|
159
|
+
|
|
160
|
+
export function BugseeSecure(props: BugseeSecureProps): ReactElement {
|
|
161
|
+
const { enabled = true, onLayout, ...rest } = props;
|
|
162
|
+
const ref = useRef<ComponentRef<typeof View>>(null);
|
|
163
|
+
// This instance's registry key. An object, so it can never collide with a
|
|
164
|
+
// manual owner or with another instance.
|
|
165
|
+
const token = useRef<object>({}).current;
|
|
166
|
+
// Measures and publishes for this instance while it is mounted and
|
|
167
|
+
// enabled. It reads the view through the ref, so one is as good as any.
|
|
168
|
+
const tracker = useRef<SecureTracker | null>(null);
|
|
169
|
+
tracker.current ??= new SecureTracker(() => ref.current, token);
|
|
170
|
+
|
|
171
|
+
// Set while the instance unmounts. Declared before the effect below, so on
|
|
172
|
+
// unmount its cleanup runs first; a change of `enabled` alone never runs it.
|
|
173
|
+
// Stryker disable next-line BooleanLiteral -- the effect below sets it before any cleanup can read it
|
|
174
|
+
const unmounting = useRef(false);
|
|
175
|
+
useLayoutEffect(() => {
|
|
176
|
+
unmounting.current = false;
|
|
177
|
+
return () => {
|
|
178
|
+
unmounting.current = true;
|
|
179
|
+
};
|
|
180
|
+
}, ONCE_PER_MOUNT);
|
|
181
|
+
|
|
182
|
+
// A layout effect, not a passive one: it runs in the commit, so on Fabric
|
|
183
|
+
// the first rectangle is registered before the first frame is painted
|
|
184
|
+
// rather than after it, and the cleanup of an unmount can still read which
|
|
185
|
+
// fibers that commit deletes.
|
|
186
|
+
useLayoutEffect(() => {
|
|
187
|
+
if (!enabled) {
|
|
188
|
+
return undefined;
|
|
189
|
+
}
|
|
190
|
+
const current = tracker.current as SecureTracker;
|
|
191
|
+
current.start();
|
|
192
|
+
return () => (unmounting.current ? current.depart() : current.stop());
|
|
193
|
+
// Only `enabled`: the tracker is created once per instance.
|
|
194
|
+
}, [enabled]);
|
|
195
|
+
|
|
196
|
+
const handleLayout = (event: LayoutChangeEvent): void => {
|
|
197
|
+
onLayout?.(event);
|
|
198
|
+
(tracker.current as SecureTracker).measure();
|
|
199
|
+
};
|
|
200
|
+
|
|
201
|
+
return <View {...rest} ref={ref} collapsable={false} onLayout={handleLayout} />;
|
|
202
|
+
}
|