babel-plugin-react-compiler 0.0.0-experimental-3452ff1-20250321 → 0.0.0-experimental-3cea1f4-20250324

package/dist/index.d.ts

@@ -72,6 +72,7 @@ type FunctionType = {
     kind: 'Function';
     shapeId: string | null;
     return: Type;
+    isConstructor: boolean;
 };
 type ObjectType = {
     kind: 'Object';
@@ -541,14 +542,15 @@ declare class Environment {
     config: EnvironmentConfig;
     fnType: ReactFunctionType;
     compilerMode: CompilerMode;
-    useMemoCacheIdentifier: string;
-    hasLoweredContextAccess: boolean;
+    programContext: ProgramContext;
     hasFireRewrite: boolean;
-    constructor(scope: Scope, fnType: ReactFunctionType, compilerMode: CompilerMode, config: EnvironmentConfig, contextIdentifiers: Set<t.Identifier>, logger: Logger | null, filename: string | null, code: string | null, useMemoCacheIdentifier: string);
+    hasInferredEffect: boolean;
+    constructor(scope: Scope, fnType: ReactFunctionType, compilerMode: CompilerMode, config: EnvironmentConfig, contextIdentifiers: Set<t.Identifier>, logger: Logger | null, filename: string | null, code: string | null, programContext: ProgramContext);
     get isInferredMemoEnabled(): boolean;
     get nextIdentifierId(): IdentifierId;
     get nextBlockId(): BlockId;
     get nextScopeId(): ScopeId;
+    get scope(): Scope;
     logErrors(errors: Result<void, CompilerError>): void;
     isContextIdentifier(node: t.Identifier): boolean;
     isHoistedIdentifier(node: t.Identifier): boolean;
@@ -1073,6 +1075,12 @@ type CallExpression = {
     loc: SourceLocation;
     typeArguments?: Array<t.FlowType>;
 };
+type NewExpression = {
+    kind: 'NewExpression';
+    callee: Place;
+    args: Array<Place | SpreadPattern>;
+    loc: SourceLocation;
+};
 type LoadLocal = {
     kind: 'LoadLocal';
     place: Place;
@@ -1113,12 +1121,7 @@ type InstructionValue = LoadLocal | LoadContext | {
     left: Place;
     right: Place;
     loc: SourceLocation;
-} | {
-    kind: 'NewExpression';
-    callee: Place;
-    args: Array<Place | SpreadPattern>;
-    loc: SourceLocation;
-} | CallExpression | MethodCall | {
+} | NewExpression | CallExpression | MethodCall | {
     kind: 'UnaryExpression';
     operator: Exclude<t.UnaryExpression['operator'], 'throw' | 'delete'>;
     value: Place;
@@ -1302,6 +1305,12 @@ type MutableRange = {
     start: InstructionId;
     end: InstructionId;
 };
+type NonLocalImportSpecifier = {
+    kind: 'ImportSpecifier';
+    name: string;
+    module: string;
+    imported: string;
+};
 type NonLocalBinding = {
     kind: 'ImportDefault';
     name: string;
@@ -1310,12 +1319,7 @@ type NonLocalBinding = {
     kind: 'ImportNamespace';
     name: string;
     module: string;
-} | {
-    kind: 'ImportSpecifier';
-    name: string;
-    module: string;
-    imported: string;
-} | {
+} | NonLocalImportSpecifier | {
     kind: 'ModuleLocal';
     name: string;
 } | {
@@ -1367,6 +1371,7 @@ declare enum Effect {
     Freeze = "freeze",
     Read = "read",
     Capture = "capture",
+    ConditionallyMutateIterator = "mutate-iterator?",
     ConditionallyMutate = "mutate?",
     Mutate = "mutate",
     Store = "store"
@@ -1507,7 +1512,7 @@ type CodegenFunction = {
         fn: CodegenFunction;
         type: ReactFunctionType | null;
     }>;
-    hasLoweredContextAccess: boolean;
+    hasInferredEffect: boolean;
     hasFireRewrite: boolean;
 };
 
@@ -1530,7 +1535,7 @@ type CompilerPipelineValue = {
     name: string;
     value: string;
 };
-declare function compileFn(func: NodePath<t.FunctionDeclaration | t.ArrowFunctionExpression | t.FunctionExpression>, config: EnvironmentConfig, fnType: ReactFunctionType, mode: CompilerMode, useMemoCacheIdentifier: string, logger: Logger | null, filename: string | null, code: string | null): CodegenFunction;
+declare function compileFn(func: NodePath<t.FunctionDeclaration | t.ArrowFunctionExpression | t.FunctionExpression>, config: EnvironmentConfig, fnType: ReactFunctionType, mode: CompilerMode, programContext: ProgramContext, logger: Logger | null, filename: string | null, code: string | null): CodegenFunction;
 
 declare const PanicThresholdOptionsSchema: z.ZodEnum<["all_errors", "critical_errors", "none"]>;
 type PanicThresholdOptions = z.infer<typeof PanicThresholdOptionsSchema>;
@@ -1603,6 +1608,22 @@ type Logger = {
 };
 declare function parsePluginOptions(obj: unknown): PluginOptions;
 
+declare class ProgramContext {
+    scope: Scope;
+    reactRuntimeModule: string;
+    hookPattern: string | null;
+    knownReferencedNames: Set<string>;
+    imports: Map<string, Map<string, NonLocalImportSpecifier>>;
+    constructor(program: NodePath$1<t.Program>, reactRuntimeModule: CompilerReactTarget, hookPattern: string | null);
+    isHookName(name: string): boolean;
+    hasReference(name: string): boolean;
+    newUid(name: string): string;
+    addMemoCacheImport(): NonLocalImportSpecifier;
+    addImportSpecifier({ source: module, importSpecifierName: specifier }: ExternalFunction, nameHint?: string): NonLocalImportSpecifier;
+    addNewReference(name: string): void;
+    assertGlobalBinding(name: string, localScope?: Scope): Result<void, CompilerError>;
+}
+
 type CompilerPass = {
     opts: PluginOptions;
     filename: string | null;
@@ -1630,4 +1651,4 @@ declare global {
     let __DEV__: boolean | null | undefined;
 }
 
-export { CompilerError, CompilerErrorDetail, type CompilerErrorDetailOptions, type CompilerPipelineValue, CompilerSuggestionOperation, Effect, type EnvironmentConfig, ErrorSeverity, type ExternalFunction, type Hook, type Logger, type LoggerEvent, OPT_IN_DIRECTIVES, OPT_OUT_DIRECTIVES, type PluginOptions, type SourceLocation, ValueKind, compileFn as compile, compileProgram, BabelPluginReactCompiler as default, findDirectiveDisablingMemoization, findDirectiveEnablingMemoization, parseConfigPragmaForTests, parsePluginOptions, printHIR, printReactiveFunction, runBabelPluginReactCompiler, validateEnvironmentConfig };
+export { CompilerError, CompilerErrorDetail, type CompilerErrorDetailOptions, type CompilerPipelineValue, CompilerSuggestionOperation, Effect, type EnvironmentConfig, ErrorSeverity, type ExternalFunction, type Hook, type Logger, type LoggerEvent, OPT_IN_DIRECTIVES, OPT_OUT_DIRECTIVES, type PluginOptions, ProgramContext, type SourceLocation, ValueKind, compileFn as compile, compileProgram, BabelPluginReactCompiler as default, findDirectiveDisablingMemoization, findDirectiveEnablingMemoization, parseConfigPragmaForTests, parsePluginOptions, printHIR, printReactiveFunction, runBabelPluginReactCompiler, validateEnvironmentConfig };