babel-plugin-react-compiler 0.0.0-experimental-81466cb-20250822 → 0.0.0-experimental-3868508-20250826

package/dist/index.js

@@ -56639,7 +56639,7 @@ var require_invariant = __commonJS({
   "../../node_modules/invariant/invariant.js"(exports2, module2) {
     "use strict";
     var NODE_ENV = process.env.NODE_ENV;
-    var invariant4 = function(condition, format, a, b, c2, d, e, f) {
+    var invariant5 = function(condition, format, a, b, c2, d, e, f) {
       if (NODE_ENV !== "production") {
         if (format === void 0) {
           throw new Error("invariant requires an error message argument");
@@ -56665,7 +56665,7 @@ var require_invariant = __commonJS({
         throw error;
       }
     };
-    module2.exports = invariant4;
+    module2.exports = invariant5;
   }
 });
 
@@ -59289,7 +59289,7 @@ module.exports = __toCommonJS(index_exports);
 // src/Babel/RunReactCompilerBabelPlugin.ts
 var import_core = __toESM(require_lib10());
 var BabelParser = __toESM(require_lib4());
-var import_invariant3 = __toESM(require_invariant());
+var import_invariant4 = __toESM(require_invariant());
 
 // src/Entrypoint/Gating.ts
 var t = __toESM(require("@babel/types"));
@@ -59532,6 +59532,7 @@ function hasOwnProperty2(obj, key2) {
 }
 
 // src/CompilerError.ts
+var import_invariant = __toESM(require_invariant());
 var ErrorSeverity = /* @__PURE__ */ ((ErrorSeverity2) => {
   ErrorSeverity2["InvalidJS"] = "InvalidJS";
   ErrorSeverity2["UnsupportedJS"] = "UnsupportedJS";
@@ -59926,14 +59927,23 @@ var ErrorCategory = /* @__PURE__ */ ((ErrorCategory2) => {
   ErrorCategory2["FBT"] = "FBT";
   return ErrorCategory2;
 })(ErrorCategory || {});
+var RULE_NAME_PATTERN = /^[a-z]+(-[a-z]+)*$/;
 function getRuleForCategory(category) {
+  const rule = getRuleForCategoryImpl(category);
+  (0, import_invariant.default)(
+    RULE_NAME_PATTERN.test(rule.name),
+    `Invalid rule name, got '${rule.name}' but rules must match ${RULE_NAME_PATTERN.toString()}`
+  );
+  return rule;
+}
+function getRuleForCategoryImpl(category) {
   switch (category) {
     case "AutomaticEffectDependencies" /* AutomaticEffectDependencies */: {
       return {
         category,
         name: "automatic-effect-dependencies",
         description: "Verifies that automatic effect dependencies are compiled if opted-in",
-        recommended: true
+        recommended: false
       };
     }
     case "CapitalizedCalls" /* CapitalizedCalls */: {
@@ -59948,7 +59958,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "config",
-        description: "Validates the configuration",
+        description: "Validates the compiler configuration options",
         recommended: true
       };
     }
@@ -59972,7 +59982,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "set-state-in-effect",
-        description: "Validates against calling setState synchronously in an effect",
+        description: "Validates against calling setState synchronously in an effect, which can lead to re-renders that degrade performance",
         recommended: true
       };
     }
@@ -59980,7 +59990,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "error-boundaries",
-        description: "Validates usage of error boundaries instead of try/catch for errors in JSX",
+        description: "Validates usage of error boundaries instead of try/catch for errors in child components",
         recommended: true
       };
     }
@@ -60004,7 +60014,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "gating",
-        description: "Validates configuration of gating mode",
+        description: "Validates configuration of [gating mode](https://react.dev/reference/react-compiler/gating)",
         recommended: true
       };
     }
@@ -60012,7 +60022,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "globals",
-        description: "Validates against assignment/mutation of globals during render",
+        description: "Validates against assignment/mutation of globals during render, part of ensuring that [side effects must render outside of render](https://react.dev/reference/rules/components-and-hooks-must-be-pure#side-effects-must-run-outside-of-render)",
         recommended: true
       };
     }
@@ -60033,7 +60043,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "immutability",
-        description: "Validates that immutable values (props, state, etc) are not mutated",
+        description: "Validates against mutating props, state, and other values that [are immutable](https://react.dev/reference/rules/components-and-hooks-must-be-pure#props-and-state-are-immutable)",
         recommended: true
       };
     }
@@ -60049,7 +60059,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "preserve-manual-memoization",
-        description: "Validates that existing manual memoized is preserved by the compiler",
+        description: "Validates that existing manual memoized is preserved by the compiler. React Compiler will only compile components and hooks if its inference [matches or exceeds the existing manual memoization](https://react.dev/learn/react-compiler/introduction#what-should-i-do-about-usememo-usecallback-and-reactmemo)",
         recommended: true
       };
     }
@@ -60057,7 +60067,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "purity",
-        description: "Validates that the component/hook is pure, and does not call known-impure functions",
+        description: "Validates that [components/hooks are pure](https://react.dev/reference/rules/components-and-hooks-must-be-pure) by checking that they do not call known-impure functions",
         recommended: true
       };
     }
@@ -60065,7 +60075,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "refs",
-        description: "Validates correct usage of refs, not reading/writing during render",
+        description: 'Validates correct usage of refs, not reading/writing during render. See the "pitfalls" section in [`useRef()` usage](https://react.dev/reference/react/useRef#usage)',
         recommended: true
       };
     }
@@ -60073,7 +60083,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "set-state-in-render",
-        description: "Validates against setting state during render",
+        description: "Validates against setting state during render, which can trigger additional renders and potential infinite render loops",
         recommended: true
       };
     }
@@ -60081,7 +60091,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "static-components",
-        description: "Validates that components are static, not recreated every render",
+        description: "Validates that components are static, not recreated every render. Components that are recreated dynamically can reset state and trigger excessive re-rendering",
         recommended: true
       };
     }
@@ -60113,7 +60123,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "unsupported-syntax",
-        description: "Validates against syntax that we do not plan to support",
+        description: "Validates against syntax that we do not plan to support in React Compiler",
         recommended: true
       };
     }
@@ -60121,7 +60131,7 @@ function getRuleForCategory(category) {
       return {
         category,
         name: "use-memo",
-        description: "Validates usage of the useMemo() hook",
+        description: "Validates usage of the useMemo() hook against common mistakes. See [`useMemo()` docs](https://react.dev/reference/react/useMemo) for more information.",
         recommended: true
       };
     }
@@ -67278,7 +67288,7 @@ function validateMutableRange(place, range, description) {
 }
 
 // src/HIR/BuildHIR.ts
-var import_invariant = __toESM(require_invariant());
+var import_invariant2 = __toESM(require_invariant());
 
 // src/HIR/HIRBuilder.ts
 function newBlock(id, kind) {
@@ -71947,7 +71957,7 @@ function isReorderableExpression(builder, expr, allowLocalIdentifiers) {
       if (body.node.type === "BlockStatement") {
         return body.node.body.length === 0;
       } else {
-        (0, import_invariant.default)(body.isExpression(), "Expected an expression");
+        (0, import_invariant2.default)(body.isExpression(), "Expected an expression");
         return isReorderableExpression(
           builder,
           body,
@@ -72900,7 +72910,7 @@ function gatherCapturedContext(fn, componentScope) {
       while (current.isJSXMemberExpression()) {
         current = current.get("object");
       }
-      (0, import_invariant.default)(
+      (0, import_invariant2.default)(
         current.isJSXIdentifier(),
         "Invalid logic in gatherCapturedDeps"
       );
@@ -94442,7 +94452,7 @@ function validateNoJSXInTryStatement(fn) {
 }
 
 // src/Optimization/OutlineJsx.ts
-var import_invariant2 = __toESM(require_invariant());
+var import_invariant3 = __toESM(require_invariant());
 function outlineJSX(fn) {
   const outlinedFns = [];
   outlineJsxImpl(fn, outlinedFns);
@@ -94735,7 +94745,7 @@ function emitUpdatedJsx(jsx, oldToNewProps) {
     const { value } = instr;
     const newProps = [];
     for (const prop of value.props) {
-      (0, import_invariant2.default)(
+      (0, import_invariant3.default)(
         prop.kind === "JsxAttribute",
         `Expected only attributes but found ${prop.kind}`
       );
@@ -94743,7 +94753,7 @@ function emitUpdatedJsx(jsx, oldToNewProps) {
         continue;
       }
       const newProp = oldToNewProps.get(prop.place.identifier.id);
-      (0, import_invariant2.default)(
+      (0, import_invariant3.default)(
         newProp !== void 0,
         `Expected a new property for ${printIdentifier(prop.place.identifier)}`
       );
@@ -94762,7 +94772,7 @@ function emitUpdatedJsx(jsx, oldToNewProps) {
           continue;
         }
         const newChild = oldToNewProps.get(child.identifier.id);
-        (0, import_invariant2.default)(
+        (0, import_invariant3.default)(
           newChild !== void 0,
           `Expected a new prop for ${printIdentifier(child.identifier)}`
         );
@@ -97781,7 +97791,7 @@ function runBabelPluginReactCompiler(text, file, language, options, includeAst =
     configFile: false,
     babelrc: false
   });
-  (0, import_invariant3.default)(
+  (0, import_invariant4.default)(
     (result == null ? void 0 : result.code) != null,
     `Expected BabelPluginReactForget to codegen successfully, got: ${result}`
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "babel-plugin-react-compiler",
-  "version": "0.0.0-experimental-81466cb-20250822",
+  "version": "0.0.0-experimental-3868508-20250826",
   "description": "Babel plugin for React Compiler.",
   "main": "dist/index.js",
   "license": "MIT",