babel-plugin-react-compiler 19.0.0-beta-aeaed83-20250323 → 19.0.0-beta-e993439-20250405

package/dist/index.d.ts

@@ -542,14 +542,16 @@ 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;
+    inferredEffectLocations: Set<SourceLocation>;
+    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;
@@ -1125,13 +1127,18 @@ type InstructionValue = LoadLocal | LoadContext | {
     operator: Exclude<t.UnaryExpression['operator'], 'throw' | 'delete'>;
     value: Place;
     loc: SourceLocation;
-} | {
+} | ({
     kind: 'TypeCastExpression';
     value: Place;
-    typeAnnotation: t.FlowType | t.TSType;
     type: Type;
     loc: SourceLocation;
-} | JsxExpression | {
+} & ({
+    typeAnnotation: t.FlowType;
+    typeAnnotationKind: 'cast';
+} | {
+    typeAnnotation: t.TSType;
+    typeAnnotationKind: 'as' | 'satisfies';
+})) | JsxExpression | {
     kind: 'ObjectExpression';
     properties: Array<ObjectProperty | SpreadPattern>;
     loc: SourceLocation;
@@ -1304,6 +1311,12 @@ type MutableRange = {
     start: InstructionId;
     end: InstructionId;
 };
+type NonLocalImportSpecifier = {
+    kind: 'ImportSpecifier';
+    name: string;
+    module: string;
+    imported: string;
+};
 type NonLocalBinding = {
     kind: 'ImportDefault';
     name: string;
@@ -1312,12 +1325,7 @@ type NonLocalBinding = {
     kind: 'ImportNamespace';
     name: string;
     module: string;
-} | {
-    kind: 'ImportSpecifier';
-    name: string;
-    module: string;
-    imported: string;
-} | {
+} | NonLocalImportSpecifier | {
     kind: 'ModuleLocal';
     name: string;
 } | {
@@ -1430,6 +1438,7 @@ type InstructionId = number & {
 type Options = {
     indent: number;
 };
+declare function printFunctionWithOutlined(fn: HIRFunction): string;
 declare function printHIR(ir: HIR, options?: Options | null): string;
 
 declare enum ErrorSeverity {
@@ -1510,10 +1519,12 @@ type CodegenFunction = {
         fn: CodegenFunction;
         type: ReactFunctionType | null;
     }>;
-    hasLoweredContextAccess: boolean;
+    hasInferredEffect: boolean;
+    inferredEffectLocations: Set<SourceLocation>;
     hasFireRewrite: boolean;
 };
 
+declare function printReactiveFunctionWithOutlined(fn: ReactiveFunction): string;
 declare function printReactiveFunction(fn: ReactiveFunction): string;
 
 type CompilerPipelineValue = {
@@ -1533,7 +1544,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>;
@@ -1606,6 +1617,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;
@@ -1622,6 +1649,7 @@ type CompileProgramResult = {
         fn: BabelFn;
         error: CompilerError;
     }>;
+    inferredEffectLocations: Set<t.SourceLocation>;
 };
 declare function compileProgram(program: NodePath$1<t.Program>, pass: CompilerPass): CompileProgramResult | null;
 
@@ -1633,4 +1661,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, printFunctionWithOutlined, printHIR, printReactiveFunction, printReactiveFunctionWithOutlined, runBabelPluginReactCompiler, validateEnvironmentConfig };