Code Unpacked · Walkthrough

React Compiler: from source policy to safe memoization

A source-backed review of the complete compiler import, with 12 deep-dive chapters and explicit boundaries for tests, runtime compatibility, playground and Rust WIP.

Overview · Overview

Purpose

Review the 3,669-file import by following its semantic boundaries: eligibility and failure policy; HIR/SSA and effect inference; React-rule validation; scope/dependency safety; cache codegen and native/compat runtime; diagnostic consumers and behavioral test harness. Start with the high-priority topics in this order, use the source map for detail, and keep the unused Rust lane separate.

Evidence (55 references)
compiler/docs/DESIGN_GOALS.md:5–55 · compiler/packages/babel-plugin-react-compiler/src/Babel/BabelPlugin.ts:20–51 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts:140–195 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts:318–380 · packages/react-reconciler/src/ReactFiberHooks.js:1119–1200 · compiler/docs/DEVELOPMENT_GUIDE.md:5–28 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Program.ts:216–269 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Program.ts:464–525 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Gating.ts:12–49 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Program.ts:782–846 · compiler/packages/babel-plugin-react-compiler/src/HIR/BuildHIR.ts:69–139 · compiler/packages/babel-plugin-react-compiler/src/SSA/EnterSSA.ts:130–179 · compiler/packages/babel-plugin-react-compiler/src/TypeInference/InferTypes.ts:53–83 · compiler/packages/babel-plugin-react-compiler/src/Inference/InferReferenceEffects.ts:57–98 · compiler/packages/babel-plugin-react-compiler/src/Inference/InferMutableRanges.ts:16–55 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts:191–223 · compiler/packages/babel-plugin-react-compiler/src/HIR/Environment.ts:151–226 · compiler/packages/babel-plugin-react-compiler/src/Validation/ValidateHooksUsage.ts:79–129 · compiler/packages/babel-plugin-react-compiler/src/Validation/ValidateNoSetStateInRender.ts:14–44 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts:425–437 · compiler/packages/babel-plugin-react-compiler/src/Validation/ValidatePreservedManualMemoization.ts:34–49 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/InferReactiveScopeVariables.ts:28–71 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/InferReactiveScopeVariables.ts:84–125 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Pipeline.ts:246–284 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/FlattenScopesWithHooksOrUse.ts:24–72 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/PropagateScopeDependencies.ts:42–74 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/DeriveMinimalDependencies.ts:13–53 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/DeriveMinimalDependencies.ts:127–149 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/PropagateScopeDependencies.ts:143–156 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/CodegenReactiveFunction.ts:72–133 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/CodegenReactiveFunction.ts:453–500 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/CodegenReactiveFunction.ts:502–549 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/CodegenReactiveFunction.ts:586–624 · compiler/packages/babel-plugin-react-compiler/src/ReactiveScopes/CodegenReactiveFunction.ts:676–701 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Program.ts:429–461 · packages/react/compiler-runtime.js:1–10 · packages/react/src/ReactHooks.js:190–194 · compiler/packages/react-compiler-runtime/src/index.ts:8–45 · compiler/packages/react-compiler-runtime/package.json:1–17 · compiler/packages/react-compiler-runtime/src/index.ts:191–199 · compiler/packages/eslint-plugin-react-compiler/src/rules/ReactCompilerRule.ts:36–56 · compiler/packages/eslint-plugin-react-compiler/src/rules/ReactCompilerRule.ts:116–163 · compiler/packages/eslint-plugin-react-compiler/src/rules/ReactCompilerRule.ts:217–228 · compiler/packages/react-compiler-healthcheck/src/checks/reactCompiler.ts:19–65 · compiler/packages/babel-plugin-react-compiler/src/Entrypoint/Program.ts:300–341 · compiler/packages/snap/src/runner.ts:71–113 · compiler/packages/snap/src/compiler.ts:32–66 · compiler/packages/snap/src/runner-worker.ts:130–180 · compiler/packages/snap/src/sprout/index.ts:31–63 · compiler/packages/snap/src/sprout/evaluator.ts:114–142 · .github/workflows/compiler-typescript.yml:46–88 · compiler/apps/playground/components/Editor/EditorImpl.tsx:45–95 · compiler/apps/playground/components/Editor/EditorImpl.tsx:166–220 · compiler/apps/playground/lib/stores/store.ts:18–66 · compiler/crates/react_napi/src/lib.rs:82–121

Use ← → to navigate, Space to play or pause, and Home / End to jump. Start with the overview, then open a deep-dive chapter.

Coverage and evidence

3673 captured files · 7002 source references. Coverage describes the supplied snapshot; it does not establish complete runtime behavior.

Limits of this explanation