metro 0.76.2 → 0.76.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metro",
-  "version": "0.76.2",
+  "version": "0.76.3",
   "description": "🚇 The JavaScript bundler for React Native.",
   "main": "src/index.js",
   "bin": "src/cli.js",
@@ -34,22 +34,22 @@
     "invariant": "^2.2.4",
     "jest-worker": "^27.2.0",
     "lodash.throttle": "^4.1.1",
-    "metro-babel-transformer": "0.76.2",
-    "metro-cache": "0.76.2",
-    "metro-cache-key": "0.76.2",
-    "metro-config": "0.76.2",
-    "metro-core": "0.76.2",
-    "metro-file-map": "0.76.2",
-    "metro-inspector-proxy": "0.76.2",
-    "metro-minify-terser": "0.76.2",
-    "metro-minify-uglify": "0.76.2",
-    "metro-react-native-babel-preset": "0.76.2",
-    "metro-resolver": "0.76.2",
-    "metro-runtime": "0.76.2",
-    "metro-source-map": "0.76.2",
-    "metro-symbolicate": "0.76.2",
-    "metro-transform-plugins": "0.76.2",
-    "metro-transform-worker": "0.76.2",
+    "metro-babel-transformer": "0.76.3",
+    "metro-cache": "0.76.3",
+    "metro-cache-key": "0.76.3",
+    "metro-config": "0.76.3",
+    "metro-core": "0.76.3",
+    "metro-file-map": "0.76.3",
+    "metro-inspector-proxy": "0.76.3",
+    "metro-minify-terser": "0.76.3",
+    "metro-minify-uglify": "0.76.3",
+    "metro-react-native-babel-preset": "0.76.3",
+    "metro-resolver": "0.76.3",
+    "metro-runtime": "0.76.3",
+    "metro-source-map": "0.76.3",
+    "metro-symbolicate": "0.76.3",
+    "metro-transform-plugins": "0.76.3",
+    "metro-transform-worker": "0.76.3",
     "mime-types": "^2.1.27",
     "node-fetch": "^2.2.0",
     "nullthrows": "^1.1.1",
@@ -67,10 +67,10 @@
     "dedent": "^0.7.0",
     "jest-snapshot": "^26.5.2",
     "jest-snapshot-serializer-raw": "^1.2.0",
-    "metro-babel-register": "0.76.2",
-    "metro-memory-fs": "0.76.2",
-    "metro-react-native-babel-preset": "0.76.2",
-    "metro-react-native-babel-transformer": "0.76.2",
+    "metro-babel-register": "0.76.3",
+    "metro-memory-fs": "0.76.3",
+    "metro-react-native-babel-preset": "0.76.3",
+    "metro-react-native-babel-transformer": "0.76.3",
     "mock-req": "^0.2.0",
     "mock-res": "^0.6.0",
     "stack-trace": "^0.0.10"

package/src/DeltaBundler/Graph.js

@@ -86,17 +86,11 @@ const nullthrows = require("nullthrows");
 
 // TODO: Convert to a Flow enum
 
-function getInternalOptions({
-  transform,
-  resolve,
-  onProgress,
-  experimentalImportBundleSupport,
-  shallow,
-}) {
+function getInternalOptions({ transform, resolve, onProgress, lazy, shallow }) {
   let numProcessed = 0;
   let total = 0;
   return {
-    experimentalImportBundleSupport,
+    lazy,
     transform,
     resolve,
     onDependencyAdd: () => onProgress && onProgress(numProcessed, ++total),
@@ -286,10 +280,7 @@ class Graph {
       // Don't add a node for the module if the graph is shallow (single-module).
     } else if (dependency.data.data.asyncType === "weak") {
       // Exclude weak dependencies from the bundle.
-    } else if (
-      options.experimentalImportBundleSupport &&
-      dependency.data.data.asyncType != null
-    ) {
+    } else if (options.lazy && dependency.data.data.asyncType != null) {
       // Don't add a node for the module if we are traversing async dependencies
       // lazily (and this is an async dependency). Instead, record it in
       // importBundleNodes.
@@ -338,10 +329,7 @@ class Graph {
       // Weak dependencies are excluded from the bundle.
       return;
     }
-    if (
-      options.experimentalImportBundleSupport &&
-      dependency.data.data.asyncType != null
-    ) {
+    if (options.lazy && dependency.data.data.asyncType != null) {
       this._decrementImportBundleReference(dependency, parentModule);
     }
     const module = this.dependencies.get(absolutePath);
@@ -515,7 +503,7 @@ class Graph {
     );
     invariant(
       importBundleNode.inverseDependencies.has(parentModule.path),
-      "experimentalImportBundleSupport: import bundle inverse references"
+      "lazy: import bundle inverse references"
     );
     importBundleNode.inverseDependencies.delete(parentModule.path);
     if (importBundleNode.inverseDependencies.size === 0) {
@@ -667,8 +655,7 @@ function dependenciesEqual(a, b, options) {
   return (
     a === b ||
     (a.absolutePath === b.absolutePath &&
-      (!options.experimentalImportBundleSupport ||
-        a.data.data.asyncType === b.data.data.asyncType) &&
+      (!options.lazy || a.data.data.asyncType === b.data.data.asyncType) &&
       contextParamsEqual(a.data.data.contextParams, b.data.data.contextParams))
   );
 }

package/src/DeltaBundler/Graph.js.flow

@@ -94,7 +94,7 @@ type Delta = $ReadOnly<{
 }>;
 
 type InternalOptions<T> = $ReadOnly<{
-  experimentalImportBundleSupport: boolean,
+  lazy: boolean,
   onDependencyAdd: () => mixed,
   onDependencyAdded: () => mixed,
   resolve: Options<T>['resolve'],
@@ -106,14 +106,14 @@ function getInternalOptions<T>({
   transform,
   resolve,
   onProgress,
-  experimentalImportBundleSupport,
+  lazy,
   shallow,
 }: Options<T>): InternalOptions<T> {
   let numProcessed = 0;
   let total = 0;
 
   return {
-    experimentalImportBundleSupport,
+    lazy,
     transform,
     resolve,
     onDependencyAdd: () => onProgress && onProgress(numProcessed, ++total),
@@ -357,10 +357,7 @@ export class Graph<T = MixedOutput> {
       // Don't add a node for the module if the graph is shallow (single-module).
     } else if (dependency.data.data.asyncType === 'weak') {
       // Exclude weak dependencies from the bundle.
-    } else if (
-      options.experimentalImportBundleSupport &&
-      dependency.data.data.asyncType != null
-    ) {
+    } else if (options.lazy && dependency.data.data.asyncType != null) {
       // Don't add a node for the module if we are traversing async dependencies
       // lazily (and this is an async dependency). Instead, record it in
       // importBundleNodes.
@@ -421,10 +418,7 @@ export class Graph<T = MixedOutput> {
       return;
     }
 
-    if (
-      options.experimentalImportBundleSupport &&
-      dependency.data.data.asyncType != null
-    ) {
+    if (options.lazy && dependency.data.data.asyncType != null) {
       this._decrementImportBundleReference(dependency, parentModule);
     }
 
@@ -629,7 +623,7 @@ export class Graph<T = MixedOutput> {
     );
     invariant(
       importBundleNode.inverseDependencies.has(parentModule.path),
-      'experimentalImportBundleSupport: import bundle inverse references',
+      'lazy: import bundle inverse references',
     );
     importBundleNode.inverseDependencies.delete(parentModule.path);
     if (importBundleNode.inverseDependencies.size === 0) {
@@ -784,13 +778,12 @@ export class Graph<T = MixedOutput> {
 function dependenciesEqual(
   a: Dependency,
   b: Dependency,
-  options: $ReadOnly<{experimentalImportBundleSupport: boolean, ...}>,
+  options: $ReadOnly<{lazy: boolean, ...}>,
 ): boolean {
   return (
     a === b ||
     (a.absolutePath === b.absolutePath &&
-      (!options.experimentalImportBundleSupport ||
-        a.data.data.asyncType === b.data.data.asyncType) &&
+      (!options.lazy || a.data.data.asyncType === b.data.data.asyncType) &&
       contextParamsEqual(a.data.data.contextParams, b.data.data.contextParams))
   );
 }

package/src/DeltaBundler/types.d.ts

@@ -139,7 +139,7 @@ export interface Options<T = MixedOutput> {
   readonly onProgress:
     | ((numProcessed: number, total: number) => unknown)
     | null;
-  readonly experimentalImportBundleSupport: boolean;
+  readonly lazy: boolean;
   readonly unstable_allowRequireContext: boolean;
   readonly shallow: boolean;
 }

package/src/DeltaBundler/types.flow.js.flow

@@ -130,7 +130,7 @@ export type Options<T = MixedOutput> = {
   +transform: TransformFn<T>,
   +transformOptions: TransformInputOptions,
   +onProgress: ?(numProcessed: number, total: number) => mixed,
-  +experimentalImportBundleSupport: boolean,
+  +lazy: boolean,
   +unstable_allowRequireContext: boolean,
   +unstable_enablePackageExports: boolean,
   +shallow: boolean,

package/src/HmrServer.js

@@ -79,8 +79,7 @@ class HmrServer {
     const graphId = getGraphId(resolvedEntryFilePath, transformOptions, {
       resolverOptions,
       shallow: graphOptions.shallow,
-      experimentalImportBundleSupport:
-        this._config.server.experimentalImportBundleSupport,
+      lazy: graphOptions.lazy,
       unstable_allowRequireContext:
         this._config.transformer.unstable_allowRequireContext,
     });
@@ -120,6 +119,7 @@ class HmrServer {
         clients: new Set([client]),
         clientUrl,
         revisionId: id,
+        graphOptions,
         unlisten: () => unlisten(),
       };
       this._clientGroups.set(id, clientGroup);
@@ -279,7 +279,7 @@ class HmrServer {
       const hmrUpdate = hmrJSBundle(delta, revision.graph, {
         clientUrl: group.clientUrl,
         createModuleId: this._createModuleId,
-        includeAsyncPaths: this._config.server.experimentalImportBundleSupport,
+        includeAsyncPaths: group.graphOptions.lazy,
         projectRoot: this._config.projectRoot,
         serverRoot:
           this._config.server.unstable_serverRoot ?? this._config.projectRoot,

package/src/HmrServer.js.flow

@@ -11,6 +11,7 @@
 'use strict';
 
 import type IncrementalBundler, {RevisionId} from './IncrementalBundler';
+import type {GraphOptions} from './shared/types.flow';
 import type {ConfigT, RootPerfLogger} from 'metro-config';
 import type {
   HmrClientMessage,
@@ -48,6 +49,7 @@ type ClientGroup = {
   clientUrl: EntryPointURL,
   revisionId: RevisionId,
   +unlisten: () => void,
+  +graphOptions: GraphOptions,
 };
 
 function send(sendFns: Array<(string) => void>, message: HmrMessage): void {
@@ -123,8 +125,7 @@ class HmrServer<TClient: Client> {
     const graphId = getGraphId(resolvedEntryFilePath, transformOptions, {
       resolverOptions,
       shallow: graphOptions.shallow,
-      experimentalImportBundleSupport:
-        this._config.server.experimentalImportBundleSupport,
+      lazy: graphOptions.lazy,
       unstable_allowRequireContext:
         this._config.transformer.unstable_allowRequireContext,
     });
@@ -167,6 +168,7 @@ class HmrServer<TClient: Client> {
         clients: new Set([client]),
         clientUrl,
         revisionId: id,
+        graphOptions,
         unlisten: (): void => unlisten(),
       };
 
@@ -356,7 +358,7 @@ class HmrServer<TClient: Client> {
       const hmrUpdate = hmrJSBundle(delta, revision.graph, {
         clientUrl: group.clientUrl,
         createModuleId: this._createModuleId,
-        includeAsyncPaths: this._config.server.experimentalImportBundleSupport,
+        includeAsyncPaths: group.graphOptions.lazy,
         projectRoot: this._config.projectRoot,
         serverRoot:
           this._config.server.unstable_serverRoot ?? this._config.projectRoot,

package/src/IncrementalBundler.js

@@ -59,6 +59,7 @@ class IncrementalBundler {
     otherOptions = {
       onProgress: null,
       shallow: false,
+      lazy: false,
     }
   ) {
     const absoluteEntryFiles = await this._getAbsoluteEntryFiles(entryFiles);
@@ -78,8 +79,7 @@ class IncrementalBundler {
       ),
       transformOptions,
       onProgress: otherOptions.onProgress,
-      experimentalImportBundleSupport:
-        this._config.server.experimentalImportBundleSupport,
+      lazy: otherOptions.lazy,
       unstable_allowRequireContext:
         this._config.transformer.unstable_allowRequireContext,
       unstable_enablePackageExports:
@@ -101,6 +101,7 @@ class IncrementalBundler {
     otherOptions = {
       onProgress: null,
       shallow: false,
+      lazy: false,
     }
   ) {
     const absoluteEntryFiles = await this._getAbsoluteEntryFiles(entryFiles);
@@ -122,8 +123,7 @@ class IncrementalBundler {
         ),
         transformOptions,
         onProgress: otherOptions.onProgress,
-        experimentalImportBundleSupport:
-          this._config.server.experimentalImportBundleSupport,
+        lazy: otherOptions.lazy,
         unstable_allowRequireContext:
           this._config.transformer.unstable_allowRequireContext,
         unstable_enablePackageExports:
@@ -140,6 +140,7 @@ class IncrementalBundler {
     otherOptions = {
       onProgress: null,
       shallow: false,
+      lazy: false,
     }
   ) {
     const graph = await this.buildGraphForEntries(
@@ -171,13 +172,13 @@ class IncrementalBundler {
     otherOptions = {
       onProgress: null,
       shallow: false,
+      lazy: false,
     }
   ) {
     const graphId = getGraphId(entryFile, transformOptions, {
       resolverOptions,
       shallow: otherOptions.shallow,
-      experimentalImportBundleSupport:
-        this._config.server.experimentalImportBundleSupport,
+      lazy: otherOptions.lazy,
       unstable_allowRequireContext:
         this._config.transformer.unstable_allowRequireContext,
     });

package/src/IncrementalBundler.js.flow

@@ -38,6 +38,7 @@ export type OutputGraph = Graph<>;
 type OtherOptions = $ReadOnly<{
   onProgress: $PropertyType<DeltaBundlerOptions<>, 'onProgress'>,
   shallow: boolean,
+  lazy: boolean,
 }>;
 
 export type GraphRevision = {
@@ -107,6 +108,7 @@ class IncrementalBundler {
     otherOptions?: OtherOptions = {
       onProgress: null,
       shallow: false,
+      lazy: false,
     },
   ): Promise<OutputGraph> {
     const absoluteEntryFiles = await this._getAbsoluteEntryFiles(entryFiles);
@@ -127,8 +129,7 @@ class IncrementalBundler {
       ),
       transformOptions,
       onProgress: otherOptions.onProgress,
-      experimentalImportBundleSupport:
-        this._config.server.experimentalImportBundleSupport,
+      lazy: otherOptions.lazy,
       unstable_allowRequireContext:
         this._config.transformer.unstable_allowRequireContext,
       unstable_enablePackageExports:
@@ -153,6 +154,7 @@ class IncrementalBundler {
     otherOptions?: OtherOptions = {
       onProgress: null,
       shallow: false,
+      lazy: false,
     },
   ): Promise<ReadOnlyDependencies<>> {
     const absoluteEntryFiles = await this._getAbsoluteEntryFiles(entryFiles);
@@ -175,8 +177,7 @@ class IncrementalBundler {
         ),
         transformOptions,
         onProgress: otherOptions.onProgress,
-        experimentalImportBundleSupport:
-          this._config.server.experimentalImportBundleSupport,
+        lazy: otherOptions.lazy,
         unstable_allowRequireContext:
           this._config.transformer.unstable_allowRequireContext,
         unstable_enablePackageExports:
@@ -195,6 +196,7 @@ class IncrementalBundler {
     otherOptions?: OtherOptions = {
       onProgress: null,
       shallow: false,
+      lazy: false,
     },
   ): Promise<{+graph: OutputGraph, +prepend: $ReadOnlyArray<Module<>>}> {
     const graph = await this.buildGraphForEntries(
@@ -229,6 +231,7 @@ class IncrementalBundler {
     otherOptions?: OtherOptions = {
       onProgress: null,
       shallow: false,
+      lazy: false,
     },
   ): Promise<{
     delta: DeltaResult<>,
@@ -238,8 +241,7 @@ class IncrementalBundler {
     const graphId = getGraphId(entryFile, transformOptions, {
       resolverOptions,
       shallow: otherOptions.shallow,
-      experimentalImportBundleSupport:
-        this._config.server.experimentalImportBundleSupport,
+      lazy: otherOptions.lazy,
       unstable_allowRequireContext:
         this._config.transformer.unstable_allowRequireContext,
     });

package/src/Server.js

@@ -106,6 +106,7 @@ class Server {
       {
         onProgress,
         shallow: graphOptions.shallow,
+        lazy: graphOptions.lazy,
       }
     );
     const entryPoint = this._getEntryPointAbsolutePath(entryFile);
@@ -122,7 +123,7 @@ class Server {
       createModuleId: this._createModuleId,
       getRunModuleStatement: this._config.serializer.getRunModuleStatement,
       dev: transformOptions.dev,
-      includeAsyncPaths: this._config.server.experimentalImportBundleSupport,
+      includeAsyncPaths: graphOptions.lazy,
       projectRoot: this._config.projectRoot,
       modulesOnly: serializerOptions.modulesOnly,
       runBeforeMainModule:
@@ -186,6 +187,7 @@ class Server {
       {
         onProgress,
         shallow: graphOptions.shallow,
+        lazy: graphOptions.lazy,
       }
     );
     const entryPoint = this._getEntryPointAbsolutePath(entryFile);
@@ -204,7 +206,7 @@ class Server {
       excludeSource: serializerOptions.excludeSource,
       getRunModuleStatement: this._config.serializer.getRunModuleStatement,
       getTransformOptions: this._config.transformer.getTransformOptions,
-      includeAsyncPaths: this._config.server.experimentalImportBundleSupport,
+      includeAsyncPaths: graphOptions.lazy,
       platform: transformOptions.platform,
       projectRoot: this._config.projectRoot,
       modulesOnly: serializerOptions.modulesOnly,
@@ -230,6 +232,7 @@ class Server {
       {
         onProgress,
         shallow: false,
+        lazy: false,
       }
     );
     return await getAssets(dependencies, {
@@ -261,6 +264,7 @@ class Server {
       {
         onProgress,
         shallow: false,
+        lazy: false,
       }
     );
     const platform =
@@ -436,12 +440,11 @@ class Server {
         transformOptions,
       });
       const graphId = getGraphId(resolvedEntryFilePath, transformOptions, {
-        experimentalImportBundleSupport:
-          this._config.server.experimentalImportBundleSupport,
         unstable_allowRequireContext:
           this._config.transformer.unstable_allowRequireContext,
         resolverOptions,
         shallow: graphOptions.shallow,
+        lazy: graphOptions.lazy,
       });
 
       // For resources that support deletion, handle the DELETE method.
@@ -640,6 +643,7 @@ class Server {
             {
               onProgress,
               shallow: graphOptions.shallow,
+              lazy: graphOptions.lazy,
             }
           ));
       bundlePerfLogger.point("resolvingAndTransformingDependencies_end");
@@ -665,8 +669,7 @@ class Server {
           processModuleFilter: this._config.serializer.processModuleFilter,
           createModuleId: this._createModuleId,
           getRunModuleStatement: this._config.serializer.getRunModuleStatement,
-          includeAsyncPaths:
-            this._config.server.experimentalImportBundleSupport,
+          includeAsyncPaths: graphOptions.lazy,
           dev: transformOptions.dev,
           projectRoot: this._config.projectRoot,
           modulesOnly: serializerOptions.modulesOnly,
@@ -773,6 +776,7 @@ class Server {
           {
             onProgress,
             shallow: graphOptions.shallow,
+            lazy: graphOptions.lazy,
           }
         ));
       } else {
@@ -822,6 +826,7 @@ class Server {
         {
           onProgress,
           shallow: false,
+          lazy: false,
         }
       );
       return await getAssets(dependencies, {
@@ -964,12 +969,11 @@ class Server {
       transformOptions,
     });
     const graphId = getGraphId(resolvedEntryFilePath, transformOptions, {
-      experimentalImportBundleSupport:
-        this._config.server.experimentalImportBundleSupport,
       unstable_allowRequireContext:
         this._config.transformer.unstable_allowRequireContext,
       resolverOptions,
       shallow: graphOptions.shallow,
+      lazy: graphOptions.lazy,
     });
     let revision;
     const revPromise = this._bundler.getRevisionByGraphId(graphId);
@@ -981,6 +985,7 @@ class Server {
         {
           onProgress,
           shallow: graphOptions.shallow,
+          lazy: graphOptions.lazy,
         }
       ));
     } else {
@@ -1033,6 +1038,7 @@ class Server {
     ...Server.DEFAULT_GRAPH_OPTIONS,
     excludeSource: false,
     inlineSourceMap: false,
+    lazy: false,
     modulesOnly: false,
     onProgress: null,
     runModule: true,

package/src/Server.js.flow

@@ -201,6 +201,7 @@ class Server {
       {
         onProgress,
         shallow: graphOptions.shallow,
+        lazy: graphOptions.lazy,
       },
     );
 
@@ -219,7 +220,7 @@ class Server {
       createModuleId: this._createModuleId,
       getRunModuleStatement: this._config.serializer.getRunModuleStatement,
       dev: transformOptions.dev,
-      includeAsyncPaths: this._config.server.experimentalImportBundleSupport,
+      includeAsyncPaths: graphOptions.lazy,
       projectRoot: this._config.projectRoot,
       modulesOnly: serializerOptions.modulesOnly,
       runBeforeMainModule:
@@ -282,7 +283,11 @@ class Server {
       entryFile,
       transformOptions,
       resolverOptions,
-      {onProgress, shallow: graphOptions.shallow},
+      {
+        onProgress,
+        shallow: graphOptions.shallow,
+        lazy: graphOptions.lazy,
+      },
     );
 
     const entryPoint = this._getEntryPointAbsolutePath(entryFile);
@@ -302,7 +307,7 @@ class Server {
       excludeSource: serializerOptions.excludeSource,
       getRunModuleStatement: this._config.serializer.getRunModuleStatement,
       getTransformOptions: this._config.transformer.getTransformOptions,
-      includeAsyncPaths: this._config.server.experimentalImportBundleSupport,
+      includeAsyncPaths: graphOptions.lazy,
       platform: transformOptions.platform,
       projectRoot: this._config.projectRoot,
       modulesOnly: serializerOptions.modulesOnly,
@@ -327,7 +332,7 @@ class Server {
       [entryFile],
       transformOptions,
       resolverOptions,
-      {onProgress, shallow: false},
+      {onProgress, shallow: false, lazy: false},
     );
 
     return await getAssets(dependencies, {
@@ -364,7 +369,7 @@ class Server {
       entryFile,
       transformOptions,
       resolverOptions,
-      {onProgress, shallow: false},
+      {onProgress, shallow: false, lazy: false},
     );
 
     const platform =
@@ -596,12 +601,11 @@ class Server {
         transformOptions,
       });
       const graphId = getGraphId(resolvedEntryFilePath, transformOptions, {
-        experimentalImportBundleSupport:
-          this._config.server.experimentalImportBundleSupport,
         unstable_allowRequireContext:
           this._config.transformer.unstable_allowRequireContext,
         resolverOptions,
         shallow: graphOptions.shallow,
+        lazy: graphOptions.lazy,
       });
 
       // For resources that support deletion, handle the DELETE method.
@@ -830,6 +834,7 @@ class Server {
             {
               onProgress,
               shallow: graphOptions.shallow,
+              lazy: graphOptions.lazy,
             },
           ));
       bundlePerfLogger.point('resolvingAndTransformingDependencies_end');
@@ -856,8 +861,7 @@ class Server {
           processModuleFilter: this._config.serializer.processModuleFilter,
           createModuleId: this._createModuleId,
           getRunModuleStatement: this._config.serializer.getRunModuleStatement,
-          includeAsyncPaths:
-            this._config.server.experimentalImportBundleSupport,
+          includeAsyncPaths: graphOptions.lazy,
           dev: transformOptions.dev,
           projectRoot: this._config.projectRoot,
           modulesOnly: serializerOptions.modulesOnly,
@@ -974,7 +978,11 @@ class Server {
           entryFile,
           transformOptions,
           resolverOptions,
-          {onProgress, shallow: graphOptions.shallow},
+          {
+            onProgress,
+            shallow: graphOptions.shallow,
+            lazy: graphOptions.lazy,
+          },
         ));
       } else {
         ({revision} = await this._bundler.updateGraph(await revPromise, false));
@@ -1028,7 +1036,7 @@ class Server {
         [entryFile],
         transformOptions,
         resolverOptions,
-        {onProgress, shallow: false},
+        {onProgress, shallow: false, lazy: false},
       );
 
       return await getAssets(dependencies, {
@@ -1177,12 +1185,11 @@ class Server {
     });
 
     const graphId = getGraphId(resolvedEntryFilePath, transformOptions, {
-      experimentalImportBundleSupport:
-        this._config.server.experimentalImportBundleSupport,
       unstable_allowRequireContext:
         this._config.transformer.unstable_allowRequireContext,
       resolverOptions,
       shallow: graphOptions.shallow,
+      lazy: graphOptions.lazy,
     });
     let revision;
     const revPromise = this._bundler.getRevisionByGraphId(graphId);
@@ -1191,7 +1198,11 @@ class Server {
         resolvedEntryFilePath,
         transformOptions,
         resolverOptions,
-        {onProgress, shallow: graphOptions.shallow},
+        {
+          onProgress,
+          shallow: graphOptions.shallow,
+          lazy: graphOptions.lazy,
+        },
       ));
     } else {
       ({revision} = await this._bundler.updateGraph(await revPromise, false));
@@ -1266,6 +1277,7 @@ class Server {
     ...typeof Server.DEFAULT_GRAPH_OPTIONS,
     excludeSource: false,
     inlineSourceMap: false,
+    lazy: false,
     modulesOnly: false,
     onProgress: null,
     runModule: true,
@@ -1276,6 +1288,7 @@ class Server {
     ...Server.DEFAULT_GRAPH_OPTIONS,
     excludeSource: false,
     inlineSourceMap: false,
+    lazy: false,
     modulesOnly: false,
     onProgress: null,
     runModule: true,

package/src/index.flow.js

@@ -36,6 +36,8 @@ const { parse } = require("url");
 exports.Terminal = Terminal;
 async function getConfig(config) {
   const defaultConfig = await getDefaultConfig(config.projectRoot);
+  // $FlowFixMe[incompatible-variance]
+  // $FlowFixMe[incompatible-call]
   return mergeConfig(defaultConfig, config);
 }
 async function runMetro(config, options) {
@@ -78,6 +80,8 @@ exports.loadConfig = loadConfig;
 exports.mergeConfig = mergeConfig;
 exports.resolveConfig = resolveConfig;
 const createConnectMiddleware = async function (config, options) {
+  // $FlowFixMe[incompatible-variance]
+  // $FlowFixMe[incompatible-call]
   const metroServer = await runMetro(config, options);
   let enhancedMiddleware = metroServer.processRequest;
 
@@ -254,6 +258,8 @@ exports.runBuild = async (
     sourceMapUrl,
   }
 ) => {
+  // $FlowFixMe[incompatible-variance]
+  // $FlowFixMe[incompatible-call]
   const metroServer = await runMetro(config, {
     watch: false,
   });

package/src/index.flow.js.flow

@@ -143,6 +143,8 @@ export type {MetroConfig};
 
 async function getConfig(config: InputConfigT): Promise<ConfigT> {
   const defaultConfig = await getDefaultConfig(config.projectRoot);
+  // $FlowFixMe[incompatible-variance]
+  // $FlowFixMe[incompatible-call]
   return mergeConfig(defaultConfig, config);
 }
 
@@ -198,6 +200,8 @@ const createConnectMiddleware = async function (
   config: ConfigT,
   options?: RunMetroOptions,
 ): Promise<MetroMiddleWare> {
+  // $FlowFixMe[incompatible-variance]
+  // $FlowFixMe[incompatible-call]
   const metroServer = await runMetro(config, options);
 
   let enhancedMiddleware: Middleware = metroServer.processRequest;
@@ -392,6 +396,8 @@ exports.runBuild = async (
   map: string,
   ...
 }> => {
+  // $FlowFixMe[incompatible-variance]
+  // $FlowFixMe[incompatible-call]
   const metroServer = await runMetro(config, {
     watch: false,
   });

package/src/integration_tests/basic_bundle/loadBundleAsyncForTest.js

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ *
+ * @format
+ */
+
+"use strict";
+
+const key = `${global.__METRO_GLOBAL_PREFIX__ ?? ""}__loadBundleAsync`;
+global[key] = async function loadBundleAsyncForTest(path) {
+  await __DOWNLOAD_AND_EXEC_FOR_TESTS__(path);
+};

package/src/integration_tests/basic_bundle/loadBundleAsyncForTest.js.flow

@@ -0,0 +1,20 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @flow strict-local
+ * @format
+ */
+
+'use strict';
+
+declare var __METRO_GLOBAL_PREFIX__: string;
+declare var __DOWNLOAD_AND_EXEC_FOR_TESTS__: (path: string) => Promise<mixed>;
+
+const key = `${global.__METRO_GLOBAL_PREFIX__ ?? ''}__loadBundleAsync`;
+
+global[key] = async function loadBundleAsyncForTest(path: string) {
+  await __DOWNLOAD_AND_EXEC_FOR_TESTS__(path);
+};

package/src/integration_tests/execBundle.js

@@ -13,5 +13,8 @@
 
 const vm = require("vm");
 module.exports = function execBundle(code, context = {}) {
+  if (vm.isContext(context)) {
+    return vm.runInContext(code, context);
+  }
   return vm.runInNewContext(code, context);
 };

package/src/integration_tests/execBundle.js.flow

@@ -13,6 +13,9 @@
 
 const vm = require('vm');
 
-module.exports = function execBundle(code: string, context: {...} = {}): mixed {
+module.exports = function execBundle(code: string, context: any = {}): mixed {
+  if (vm.isContext(context)) {
+    return vm.runInContext(code, context);
+  }
   return vm.runInNewContext(code, context);
 };

package/src/integration_tests/metro.config.js

@@ -45,4 +45,9 @@ module.exports = {
       ramGroups: [],
     }),
   },
+  serializer: {
+    getPolyfills: () => [
+      require.resolve("./basic_bundle/loadBundleAsyncForTest"),
+    ],
+  },
 };

package/src/lib/getGraphId.js

@@ -15,12 +15,7 @@ const canonicalize = require("metro-core/src/canonicalize");
 function getGraphId(
   entryFile,
   options,
-  {
-    shallow,
-    experimentalImportBundleSupport,
-    unstable_allowRequireContext,
-    resolverOptions,
-  }
+  { shallow, lazy, unstable_allowRequireContext, resolverOptions }
 ) {
   return JSON.stringify(
     {
@@ -35,7 +30,7 @@ function getGraphId(
         unstable_disableES6Transforms: options.unstable_disableES6Transforms,
         platform: options.platform != null ? options.platform : null,
         type: options.type,
-        experimentalImportBundleSupport,
+        lazy,
         unstable_allowRequireContext,
         shallow,
         unstable_transformProfile:

package/src/lib/getGraphId.js.flow

@@ -23,12 +23,12 @@ function getGraphId(
   options: TransformInputOptions,
   {
     shallow,
-    experimentalImportBundleSupport,
+    lazy,
     unstable_allowRequireContext,
     resolverOptions,
   }: $ReadOnly<{
     shallow: boolean,
-    experimentalImportBundleSupport: boolean,
+    lazy: boolean,
     unstable_allowRequireContext: boolean,
     resolverOptions: ResolverInputOptions,
   }>,
@@ -46,7 +46,7 @@ function getGraphId(
         unstable_disableES6Transforms: options.unstable_disableES6Transforms,
         platform: options.platform != null ? options.platform : null,
         type: options.type,
-        experimentalImportBundleSupport,
+        lazy,
         unstable_allowRequireContext,
         shallow,
         unstable_transformProfile:

package/src/lib/getPrependedScripts.js

@@ -57,8 +57,7 @@ async function getPrependedScripts(
         config.transformer.unstable_allowRequireContext,
       transformOptions,
       onProgress: null,
-      experimentalImportBundleSupport:
-        config.server.experimentalImportBundleSupport,
+      lazy: false,
       unstable_enablePackageExports:
         config.resolver.unstable_enablePackageExports,
       shallow: false,

package/src/lib/getPrependedScripts.js.flow

@@ -67,8 +67,7 @@ async function getPrependedScripts(
         config.transformer.unstable_allowRequireContext,
       transformOptions,
       onProgress: null,
-      experimentalImportBundleSupport:
-        config.server.experimentalImportBundleSupport,
+      lazy: false,
       unstable_enablePackageExports:
         config.resolver.unstable_enablePackageExports,
       shallow: false,

package/src/lib/parseOptionsFromUrl.js

@@ -45,6 +45,7 @@ module.exports = function parseOptionsFromUrl(requestUrl, platforms) {
     excludeSource: getBoolean(query, "excludeSource", false),
     hot: true,
     inlineSourceMap: getBoolean(query, "inlineSourceMap", false),
+    lazy: getBoolean(query, "lazy", false),
     minify: getBoolean(query, "minify", false),
     modulesOnly: getBoolean(query, "modulesOnly", false),
     onProgress: null,

package/src/lib/parseOptionsFromUrl.js.flow

@@ -60,6 +60,7 @@ module.exports = function parseOptionsFromUrl(
     excludeSource: getBoolean(query, 'excludeSource', false),
     hot: true,
     inlineSourceMap: getBoolean(query, 'inlineSourceMap', false),
+    lazy: getBoolean(query, 'lazy', false),
     minify: getBoolean(query, 'minify', false),
     modulesOnly: getBoolean(query, 'modulesOnly', false),
     onProgress: null,

package/src/lib/splitBundleOptions.js

@@ -39,6 +39,7 @@ function splitBundleOptions(options) {
     },
     graphOptions: {
       shallow: options.shallow,
+      lazy: options.lazy,
     },
     onProgress: options.onProgress,
   };

package/src/lib/splitBundleOptions.js.flow

@@ -41,6 +41,7 @@ function splitBundleOptions(options: BundleOptions): SplitBundleOptions {
     },
     graphOptions: {
       shallow: options.shallow,
+      lazy: options.lazy,
     },
     onProgress: options.onProgress,
   };

package/src/lib/transformHelpers.js

@@ -67,8 +67,7 @@ async function calcTransformerOptions(
       ),
       transformOptions: options,
       onProgress: null,
-      experimentalImportBundleSupport:
-        config.server.experimentalImportBundleSupport,
+      lazy: false,
       unstable_allowRequireContext:
         config.transformer.unstable_allowRequireContext,
       unstable_enablePackageExports:

package/src/lib/transformHelpers.js.flow

@@ -85,8 +85,7 @@ async function calcTransformerOptions(
       ),
       transformOptions: options,
       onProgress: null,
-      experimentalImportBundleSupport:
-        config.server.experimentalImportBundleSupport,
+      lazy: false,
       unstable_allowRequireContext:
         config.transformer.unstable_allowRequireContext,
       unstable_enablePackageExports:

package/src/shared/types.d.ts

@@ -46,6 +46,7 @@ export interface BundleOptions {
   readonly excludeSource: boolean;
   readonly hot: boolean;
   readonly inlineSourceMap: boolean;
+  readonly lazy: boolean;
   minify: boolean;
   readonly modulesOnly: boolean;
   onProgress?: (doneCont: number, totalCount: number) => unknown;
@@ -73,6 +74,7 @@ export interface SerializerOptions {
 }
 
 export interface GraphOptions {
+  readonly lazy: boolean;
   readonly shallow: boolean;
 }
 

package/src/shared/types.flow.js.flow

@@ -50,6 +50,7 @@ export type BundleOptions = {
   +excludeSource: boolean,
   +hot: boolean,
   +inlineSourceMap: boolean,
+  +lazy: boolean,
   minify: boolean,
   +modulesOnly: boolean,
   onProgress: ?(doneCont: number, totalCount: number) => mixed,
@@ -76,6 +77,7 @@ export type SerializerOptions = {
 };
 
 export type GraphOptions = {
+  +lazy: boolean,
   +shallow: boolean,
 };