babel-plugin-react-compiler 19.1.0-rc.1-76db730-20250421 → 19.1.0-rc.2

package/dist/index.d.ts

@@ -242,6 +242,7 @@ declare const EnvironmentConfigSchema: z.ZodObject<{
     validateNoCapitalizedCalls: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
     validateBlocklistedImports: z.ZodDefault<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
     validateNoImpureFunctionsInRender: z.ZodDefault<z.ZodBoolean>;
+    validateNoFreezingKnownMutableFunctions: z.ZodDefault<z.ZodBoolean>;
     enableAssumeHooksFollowRulesOfReact: z.ZodDefault<z.ZodBoolean>;
     enableTransitivelyFreezeFunctionExpressions: z.ZodDefault<z.ZodBoolean>;
     enableEmitFreeze: z.ZodDefault<z.ZodNullable<z.ZodObject<{
@@ -402,6 +403,7 @@ declare const EnvironmentConfigSchema: z.ZodObject<{
     validateNoCapitalizedCalls: string[] | null;
     validateBlocklistedImports: string[] | null;
     validateNoImpureFunctionsInRender: boolean;
+    validateNoFreezingKnownMutableFunctions: boolean;
     enableAssumeHooksFollowRulesOfReact: boolean;
     enableTransitivelyFreezeFunctionExpressions: boolean;
     enableEmitFreeze: {
@@ -486,6 +488,7 @@ declare const EnvironmentConfigSchema: z.ZodObject<{
     validateNoCapitalizedCalls?: string[] | null | undefined;
     validateBlocklistedImports?: string[] | null | undefined;
     validateNoImpureFunctionsInRender?: boolean | undefined;
+    validateNoFreezingKnownMutableFunctions?: boolean | undefined;
     enableAssumeHooksFollowRulesOfReact?: boolean | undefined;
     enableTransitivelyFreezeFunctionExpressions?: boolean | undefined;
     enableEmitFreeze?: {
@@ -529,9 +532,6 @@ declare const EnvironmentConfigSchema: z.ZodObject<{
     } | null | undefined;
 }>;
 type EnvironmentConfig = z.infer<typeof EnvironmentConfigSchema>;
-declare function parseConfigPragmaForTests(pragma: string, defaults: {
-    compilationMode: CompilationMode;
-}): PluginOptions;
 type PartialEnvironmentConfig = Partial<EnvironmentConfig>;
 type ReactFunctionType = 'Component' | 'Hook' | 'Other';
 declare class Environment {
@@ -1107,7 +1107,7 @@ type InstructionValue = LoadLocal | LoadContext | {
 } | StoreLocal | {
     kind: 'StoreContext';
     lvalue: {
-        kind: InstructionKind.Reassign;
+        kind: InstructionKind.Reassign | InstructionKind.Const | InstructionKind.Let | InstructionKind.Function;
         place: Place;
     };
     value: Place;
@@ -1555,10 +1555,10 @@ type PluginOptions = {
     panicThreshold: PanicThresholdOptions;
     noEmit: boolean;
     compilationMode: CompilationMode;
-    eslintSuppressionRules?: Array<string> | null | undefined;
+    eslintSuppressionRules: Array<string> | null | undefined;
     flowSuppressions: boolean;
     ignoreUseNoForget: boolean;
-    sources?: Array<string> | ((filename: string) => boolean) | null;
+    sources: Array<string> | ((filename: string) => boolean) | null;
     enableReanimatedCheck: boolean;
     target: CompilerReactTarget;
 };
@@ -1575,7 +1575,7 @@ declare const CompilerReactTargetSchema: z.ZodUnion<[z.ZodLiteral<"17">, z.ZodLi
 type CompilerReactTarget = z.infer<typeof CompilerReactTargetSchema>;
 declare const CompilationModeSchema: z.ZodEnum<["infer", "syntax", "annotation", "all"]>;
 type CompilationMode = z.infer<typeof CompilationModeSchema>;
-type LoggerEvent = CompileSuccessEvent | CompileErrorEvent | CompileDiagnosticEvent | CompileSkipEvent | PipelineErrorEvent | TimingEvent;
+type LoggerEvent = CompileSuccessEvent | CompileErrorEvent | CompileDiagnosticEvent | CompileSkipEvent | PipelineErrorEvent | TimingEvent | AutoDepsDecorationsEvent | AutoDepsEligibleEvent;
 type CompileErrorEvent = {
     kind: 'CompileError';
     fnLoc: t.SourceLocation | null;
@@ -1611,28 +1611,22 @@ type TimingEvent = {
     kind: 'Timing';
     measurement: PerformanceMeasure;
 };
+type AutoDepsDecorationsEvent = {
+    kind: 'AutoDepsDecorations';
+    fnLoc: t.SourceLocation;
+    decorations: Array<t.SourceLocation>;
+};
+type AutoDepsEligibleEvent = {
+    kind: 'AutoDepsEligible';
+    fnLoc: t.SourceLocation;
+    depArrayLoc: t.SourceLocation;
+};
 type Logger = {
     logEvent: (filename: string | null, event: LoggerEvent) => void;
     debugLogIRs?: (value: CompilerPipelineValue) => void;
 };
 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;
@@ -1641,20 +1635,66 @@ type CompilerPass = {
 };
 declare const OPT_IN_DIRECTIVES: Set<string>;
 declare const OPT_OUT_DIRECTIVES: Set<string>;
-declare function findDirectiveEnablingMemoization(directives: Array<t.Directive>): Array<t.Directive>;
-declare function findDirectiveDisablingMemoization(directives: Array<t.Directive>): Array<t.Directive>;
+declare function findDirectiveEnablingMemoization(directives: Array<t.Directive>): t.Directive | null;
+declare function findDirectiveDisablingMemoization(directives: Array<t.Directive>): t.Directive | null;
 type BabelFn = NodePath$1<t.FunctionDeclaration> | NodePath$1<t.FunctionExpression> | NodePath$1<t.ArrowFunctionExpression>;
-type CompileProgramResult = {
+type CompileProgramMetadata = {
     retryErrors: Array<{
         fn: BabelFn;
         error: CompilerError;
     }>;
     inferredEffectLocations: Set<t.SourceLocation>;
 };
-declare function compileProgram(program: NodePath$1<t.Program>, pass: CompilerPass): CompileProgramResult | null;
+declare function compileProgram(program: NodePath$1<t.Program>, pass: CompilerPass): CompileProgramMetadata | null;
+
+type SuppressionRange = {
+    disableComment: t.Comment;
+    enableComment: t.Comment | null;
+    source: SuppressionSource;
+};
+type SuppressionSource = 'Eslint' | 'Flow';
+
+type ProgramContextOptions = {
+    program: NodePath$1<t.Program>;
+    suppressions: Array<SuppressionRange>;
+    opts: PluginOptions;
+    filename: string | null;
+    code: string | null;
+    hasModuleScopeOptOut: boolean;
+};
+declare class ProgramContext {
+    scope: Scope;
+    opts: PluginOptions;
+    filename: string | null;
+    code: string | null;
+    reactRuntimeModule: string;
+    suppressions: Array<SuppressionRange>;
+    hasModuleScopeOptOut: boolean;
+    alreadyCompiled: WeakSet<object> | Set<object>;
+    knownReferencedNames: Set<string>;
+    imports: Map<string, Map<string, NonLocalImportSpecifier>>;
+    retryErrors: Array<{
+        fn: BabelFn;
+        error: CompilerError;
+    }>;
+    inferredEffectLocations: Set<t.SourceLocation>;
+    constructor({ program, suppressions, opts, filename, code, hasModuleScopeOptOut, }: ProgramContextOptions);
+    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>;
+    logEvent(event: LoggerEvent): void;
+}
 
 declare function runBabelPluginReactCompiler(text: string, file: string, language: 'flow' | 'typescript', options: Partial<PluginOptions> | null, includeAst?: boolean): BabelCore.BabelFileResult;
 
+declare function parseConfigPragmaForTests(pragma: string, defaults: {
+    compilationMode: CompilationMode;
+}): PluginOptions;
+
 declare function BabelPluginReactCompiler(_babel: typeof BabelCore): BabelCore.PluginObj;
 
 declare global {