@flotrace/runtime-core 2.0.0
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/README.md +33 -0
- package/dist/index.d.mts +1465 -0
- package/dist/index.d.ts +1465 -0
- package/dist/index.js +3685 -0
- package/dist/index.mjs +3617 -0
- package/package.json +57 -0
package/README.md
ADDED
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
# @flotrace/runtime-core
|
|
2
|
+
|
|
3
|
+
Platform-agnostic core for the FloTrace runtime — fiber walker, hook/effect inspectors, state-store trackers, serializer, and WebSocket client. Shared by [`@flotrace/runtime`](https://www.npmjs.com/package/@flotrace/runtime) (web) and [`@flotrace/runtime-native`](https://www.npmjs.com/package/@flotrace/runtime-native) (React Native).
|
|
4
|
+
|
|
5
|
+
> **You probably don't want this package directly.**
|
|
6
|
+
> Install `@flotrace/runtime` for a web React app or `@flotrace/runtime-native` for React Native. Those adapters depend on `runtime-core` and provide the wiring (provider, network tracker, platform-specific hooks) you need.
|
|
7
|
+
|
|
8
|
+
`runtime-core` is published as a public package so adapters can pin a compatible version. It has no runtime dependency on `window` / `document` / `XMLHttpRequest` — all platform-specific features live in the adapters.
|
|
9
|
+
|
|
10
|
+
## What's inside
|
|
11
|
+
|
|
12
|
+
| Module | Purpose |
|
|
13
|
+
|---|---|
|
|
14
|
+
| `fiberTreeWalker` | Incremental fiber walk, diffed tree emission, pluggable `pruneSubtree` / `frameworkComponentNames` / `hostComponentSkipPrefixes` options for platform adapters. |
|
|
15
|
+
| `hookInspector` / `effectInspector` | Classify hooks and effects from a fiber; diff deps between commits. |
|
|
16
|
+
| `zustandTracker` / `reduxTracker` / `tanstackQueryTracker` | Duck-typed subscribers for the major state libraries. |
|
|
17
|
+
| `timelineTracker` | Per-component lifecycle events. |
|
|
18
|
+
| `cascadeAnalyzer` / `propDrillingAnalyzer` | Render-cascade tracing + prop-drilling chain detection. |
|
|
19
|
+
| `serializer` | Safe JSON serialization (depth 5, circular refs, truncation). |
|
|
20
|
+
| `websocketClient` | Singleton WS client with reconnect, batching, auth-token support. |
|
|
21
|
+
|
|
22
|
+
## Version compatibility
|
|
23
|
+
|
|
24
|
+
`@flotrace/runtime-core@0.1.x` is the companion release for:
|
|
25
|
+
|
|
26
|
+
- `@flotrace/runtime@0.2.x`
|
|
27
|
+
- `@flotrace/runtime-native@0.1.x`
|
|
28
|
+
|
|
29
|
+
Use matching minor versions when pinning across all three.
|
|
30
|
+
|
|
31
|
+
## License
|
|
32
|
+
|
|
33
|
+
MIT
|