metro 0.83.4 → 0.83.5

package/src/lib/formatBundlingError.js

@@ -20,11 +20,7 @@ var _fs = _interopRequireDefault(require("fs"));
 var _metroCore = require("metro-core");
 var _serializeError = _interopRequireDefault(require("serialize-error"));
 function _interopRequireDefault(e) {
-  return e && e.__esModule
-    ? e
-    : {
-        default: e,
-      };
+  return e && e.__esModule ? e : { default: e };
 }
 function formatBundlingError(error) {
   if (error instanceof _metroCore.AmbiguousModuleResolutionError) {

package/src/lib/getAppendScripts.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type {Module} from '../DeltaBundler';
+
+type Options<T extends number | string> = Readonly<{
+  asyncRequireModulePath: string;
+  createModuleId: ($$PARAM_0$$: string) => T;
+  getRunModuleStatement: (moduleId: T, globalPrefix: string) => string;
+  globalPrefix: string;
+  inlineSourceMap: null | undefined | boolean;
+  runBeforeMainModule: ReadonlyArray<string>;
+  runModule: boolean;
+  shouldAddToIgnoreList: ($$PARAM_0$$: Module) => boolean;
+  sourceMapUrl: null | undefined | string;
+  sourceUrl: null | undefined | string;
+  getSourceUrl: null | undefined | (($$PARAM_0$$: Module) => string);
+}>;
+declare function getAppendScripts<T extends number | string>(
+  entryPoint: string,
+  modules: ReadonlyArray<Module>,
+  options: Options<T>,
+): ReadonlyArray<Module>;
+export default getAppendScripts;

package/src/lib/getAppendScripts.js

@@ -12,11 +12,7 @@ var _CountingSet = _interopRequireDefault(require("./CountingSet"));
 var _countLines = _interopRequireDefault(require("./countLines"));
 var _nullthrows = _interopRequireDefault(require("nullthrows"));
 function _interopRequireDefault(e) {
-  return e && e.__esModule
-    ? e
-    : {
-        default: e,
-      };
+  return e && e.__esModule ? e : { default: e };
 }
 function getAppendScripts(entryPoint, modules, options) {
   const output = [];

package/src/lib/getGraphId.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type {TransformInputOptions} from '../DeltaBundler/types';
+import type {ResolverInputOptions} from '../shared/types';
+
+export declare type GraphId = string;
+declare function getGraphId(
+  entryFile: string,
+  options: TransformInputOptions,
+  $$PARAM_2$$: Readonly<{
+    shallow: boolean;
+    lazy: boolean;
+    unstable_allowRequireContext: boolean;
+    resolverOptions: ResolverInputOptions;
+  }>,
+): GraphId;
+export default getGraphId;

package/src/lib/getGraphId.js

@@ -8,11 +8,7 @@ var _canonicalize = _interopRequireDefault(
   require("metro-core/private/canonicalize"),
 );
 function _interopRequireDefault(e) {
-  return e && e.__esModule
-    ? e
-    : {
-        default: e,
-      };
+  return e && e.__esModule ? e : { default: e };
 }
 function getGraphId(
   entryFile,

package/src/lib/getPreludeCode.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+declare function getPreludeCode($$PARAM_0$$: {
+  readonly extraVars?: {[$$Key$$: string]: unknown};
+  readonly isDev: boolean;
+  readonly globalPrefix: string;
+  readonly requireCycleIgnorePatterns: ReadonlyArray<RegExp>;
+  readonly unstable_forceFullRefreshPatterns: ReadonlyArray<RegExp>;
+}): string;
+export default getPreludeCode;

package/src/lib/getPrependedScripts.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type Bundler from '../Bundler';
+import type {Module, default as DeltaBundler} from '../DeltaBundler';
+import type {TransformInputOptions} from '../DeltaBundler/types';
+import type {ResolverInputOptions} from '../shared/types';
+import type {ConfigT} from 'metro-config';
+
+declare function getPrependedScripts(
+  config: ConfigT,
+  options: Omit<TransformInputOptions, 'type'>,
+  resolverOptions: ResolverInputOptions,
+  bundler: Bundler,
+  deltaBundler: DeltaBundler,
+): Promise<ReadonlyArray<Module>>;
+export default getPrependedScripts;

package/src/lib/getPrependedScripts.js

@@ -19,10 +19,7 @@ function _interopRequireWildcard(e, t) {
     if (!t && e && e.__esModule) return e;
     var o,
       i,
-      f = {
-        __proto__: null,
-        default: e,
-      };
+      f = { __proto__: null, default: e };
     if (null === e || ("object" != typeof e && "function" != typeof e))
       return f;
     if ((o = t ? n : r)) {
@@ -42,11 +39,7 @@ function _interopRequireWildcard(e, t) {
   })(e, t);
 }
 function _interopRequireDefault(e) {
-  return e && e.__esModule
-    ? e
-    : {
-        default: e,
-      };
+  return e && e.__esModule ? e : { default: e };
 }
 async function getPrependedScripts(
   config,

package/src/lib/isResolvedDependency.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type {Dependency, ResolvedDependency} from '../DeltaBundler/types';
+
+export declare function isResolvedDependency(
+  dep: Dependency,
+): dep is ResolvedDependency;

package/src/lib/logToConsole.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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
+ */
+
+import type {Terminal} from 'metro-core';
+
+declare const $$EXPORT_DEFAULT_DECLARATION$$: (
+  terminal: Terminal,
+  level: string,
+  ...data: Array<unknown>
+) => void;
+declare type $$EXPORT_DEFAULT_DECLARATION$$ =
+  typeof $$EXPORT_DEFAULT_DECLARATION$$;
+export default $$EXPORT_DEFAULT_DECLARATION$$;

package/src/lib/logToConsole.js

@@ -7,11 +7,7 @@ exports.default = void 0;
 var _chalk = _interopRequireDefault(require("chalk"));
 var _util = _interopRequireDefault(require("util"));
 function _interopRequireDefault(e) {
-  return e && e.__esModule
-    ? e
-    : {
-        default: e,
-      };
+  return e && e.__esModule ? e : { default: e };
 }
 const groupStack = [];
 let collapsedGuardTimer;

package/src/lib/parseBundleOptionsFromBundleRequestUrl.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type {BundleOptions} from '../shared/types';
+
+declare function parseBundleOptionsFromBundleRequestUrl(
+  rawNonJscSafeUrlEncodedUrl: string,
+  platforms: Set<string>,
+): Omit<BundleOptions, keyof {bundleType: string}> & {bundleType: string};
+export default parseBundleOptionsFromBundleRequestUrl;

package/src/lib/parseBundleOptionsFromBundleRequestUrl.js

@@ -24,10 +24,7 @@ function _interopRequireWildcard(e, t) {
     if (!t && e && e.__esModule) return e;
     var o,
       i,
-      f = {
-        __proto__: null,
-        default: e,
-      };
+      f = { __proto__: null, default: e };
     if (null === e || ("object" != typeof e && "function" != typeof e))
       return f;
     if ((o = t ? n : r)) {
@@ -47,11 +44,7 @@ function _interopRequireWildcard(e, t) {
   })(e, t);
 }
 function _interopRequireDefault(e) {
-  return e && e.__esModule
-    ? e
-    : {
-        default: e,
-      };
+  return e && e.__esModule ? e : { default: e };
 }
 const debug = require("debug")(
   "Metro:Server:parseBundleOptionsFromBundleRequestUrl",

package/src/lib/parseCustomResolverOptions.d.ts

@@ -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
+ * @oncall react_native
+ */
+
+import type {CustomResolverOptions} from 'metro-resolver';
+
+declare function parseCustomResolverOptions(
+  searchParams: URLSearchParams,
+): CustomResolverOptions;
+export default parseCustomResolverOptions;

package/src/lib/parseCustomTransformOptions.d.ts

@@ -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
+ * @oncall react_native
+ */
+
+import type {CustomTransformOptions} from 'metro-transform-worker';
+
+declare function parseCustomTransformOptions(
+  searchParams: URLSearchParams,
+): CustomTransformOptions;
+export default parseCustomTransformOptions;

package/src/lib/parseJsonBody.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type {IncomingMessage} from 'http';
+
+export type JsonData =
+  | {[$$Key$$: string]: JsonData}
+  | Array<JsonData>
+  | string
+  | number
+  | boolean
+  | null;
+/**
+ * Attempt to parse a request body as JSON.
+ */
+declare function parseJsonBody(
+  req: IncomingMessage,
+  options?: {strict?: boolean},
+): Promise<JsonData>;
+export default parseJsonBody;

package/src/lib/pathUtils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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
+ */
+
+export declare const normalizePathSeparatorsToPosix: (
+  $$PARAM_0$$: string,
+) => string;
+export declare type normalizePathSeparatorsToPosix =
+  typeof normalizePathSeparatorsToPosix;

package/src/lib/pathUtils.js

@@ -13,10 +13,7 @@ function _interopRequireWildcard(e, t) {
     if (!t && e && e.__esModule) return e;
     var o,
       i,
-      f = {
-        __proto__: null,
-        default: e,
-      };
+      f = { __proto__: null, default: e };
     if (null === e || ("object" != typeof e && "function" != typeof e))
       return f;
     if ((o = t ? n : r)) {

package/src/lib/relativizeSourceMap.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type {MixedSourceMap} from 'metro-source-map';
+
+declare function relativizeSourceMapInline(
+  sourceMap: MixedSourceMap,
+  sourcesRoot: string,
+): void;
+export default relativizeSourceMapInline;

package/src/lib/relativizeSourceMap.js

@@ -6,11 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.default = relativizeSourceMapInline;
 var _path = _interopRequireDefault(require("path"));
 function _interopRequireDefault(e) {
-  return e && e.__esModule
-    ? e
-    : {
-        default: e,
-      };
+  return e && e.__esModule ? e : { default: e };
 }
 function relativizeSourceMapInline(sourceMap, sourcesRoot) {
   if (sourceMap.mappings === undefined) {

package/src/lib/reporting.d.ts

@@ -0,0 +1,128 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type {Terminal} from 'metro-core';
+import type {HealthCheckResult, WatcherStatus} from 'metro-file-map';
+import type {CustomResolverOptions} from 'metro-resolver';
+import type {CustomTransformOptions} from 'metro-transform-worker';
+
+export type BundleDetails = {
+  bundleType: string;
+  customResolverOptions: CustomResolverOptions;
+  customTransformOptions: CustomTransformOptions;
+  dev: boolean;
+  entryFile: string;
+  minify: boolean;
+  platform: null | undefined | string;
+};
+/**
+ * A tagged union of all the actions that may happen and we may want to
+ * report to the tool user.
+ */
+export type ReportableEvent =
+  | {port: number; hasReducedPerformance: boolean; type: 'initialize_started'}
+  | {type: 'initialize_failed'; port: number; error: Error}
+  | {type: 'initialize_done'; port: number}
+  | {buildID: string; type: 'bundle_build_done'}
+  | {buildID: string; type: 'bundle_build_failed'}
+  | {type: 'bundle_save_log'; message: string}
+  | {
+      buildID: string;
+      bundleDetails: BundleDetails;
+      isPrefetch?: boolean;
+      type: 'bundle_build_started';
+    }
+  | {error: Error; type: 'bundling_error'}
+  | {type: 'dep_graph_loading'; hasReducedPerformance: boolean}
+  | {type: 'dep_graph_loaded'}
+  | {
+      buildID: string;
+      type: 'bundle_transform_progressed';
+      transformedFileCount: number;
+      totalFileCount: number;
+    }
+  | {type: 'cache_read_error'; error: Error}
+  | {type: 'cache_write_error'; error: Error}
+  | {type: 'transform_cache_reset'}
+  | {type: 'worker_stdout_chunk'; chunk: string}
+  | {type: 'worker_stderr_chunk'; chunk: string}
+  | {type: 'hmr_client_error'; error: Error}
+  | {
+      type: 'client_log';
+      level:
+        | 'trace'
+        | 'info'
+        | 'warn'
+        | 'log'
+        | 'group'
+        | 'groupCollapsed'
+        | 'groupEnd'
+        | 'debug';
+      data: Array<unknown>;
+    }
+  | {type: 'resolver_warning'; message: string}
+  | {type: 'server_listening'; port: number; address: string; family: string}
+  | {type: 'transformer_load_started'}
+  | {type: 'transformer_load_done'}
+  | {type: 'transformer_load_failed'; error: Error}
+  | {type: 'watcher_health_check_result'; result: HealthCheckResult}
+  | {type: 'watcher_status'; status: WatcherStatus};
+/**
+ * Code across the application takes a reporter as an option and calls the
+ * update whenever one of the ReportableEvent happens. Code does not directly
+ * write to the standard output, because a build would be:
+ *
+ *   1. ad-hoc, embedded into another tool, in which case we do not want to
+ *   pollute that tool's own output. The tool is free to present the
+ *   warnings/progress we generate any way they want, by specifing a custom
+ *   reporter.
+ *   2. run as a background process from another tool, in which case we want
+ *   to expose updates in a way that is easily machine-readable, for example
+ *   a JSON-stream. We don't want to pollute it with textual messages.
+ *
+ * We centralize terminal reporting into a single place because we want the
+ * output to be robust and consistent. The most common reporter is
+ * TerminalReporter, that should be the only place in the application should
+ * access the `terminal` module (nor the `console`).
+ */
+export type Reporter = {update(event: ReportableEvent): void};
+/**
+ * A standard way to log a warning to the terminal. This should not be called
+ * from some arbitrary Metro logic, only from the reporters. Instead of
+ * calling this, add a new type of ReportableEvent instead, and implement a
+ * proper handler in the reporter(s).
+ */
+export declare function logWarning(
+  terminal: Terminal,
+  format: string,
+  ...args: Array<unknown>
+): void;
+/**
+ * Similar to `logWarning`, but for messages that require the user to act.
+ */
+export declare function logError(
+  terminal: Terminal,
+  format: string,
+  ...args: Array<unknown>
+): void;
+/**
+ * Similar to `logWarning`, but for informational messages.
+ */
+export declare function logInfo(
+  terminal: Terminal,
+  format: string,
+  ...args: Array<unknown>
+): void;
+/**
+ * A reporter that does nothing. Errors and warnings will be swallowed, that
+ * is generally not what you want.
+ */
+export declare const nullReporter: {update(): void};
+export declare type nullReporter = typeof nullReporter;

package/src/lib/reporting.js

@@ -10,11 +10,7 @@ exports.nullReporter = void 0;
 var _chalk = _interopRequireDefault(require("chalk"));
 var _util = _interopRequireDefault(require("util"));
 function _interopRequireDefault(e) {
-  return e && e.__esModule
-    ? e
-    : {
-        default: e,
-      };
+  return e && e.__esModule ? e : { default: e };
 }
 function logWarning(terminal, format, ...args) {
   const str = _util.default.format(format, ...args);

package/src/lib/splitBundleOptions.d.ts

@@ -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
+ * @oncall react_native
+ */
+
+import type {BundleOptions, SplitBundleOptions} from '../shared/types';
+/**
+ * Splits a BundleOptions object into smaller, more manageable parts.
+ */
+declare function splitBundleOptions(options: BundleOptions): SplitBundleOptions;
+export default splitBundleOptions;

package/src/lib/transformHelpers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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
+ * @oncall react_native
+ */
+
+import type Bundler from '../Bundler';
+import type {TransformFn, default as DeltaBundler} from '../DeltaBundler';
+import type {
+  BundlerResolution,
+  TransformInputOptions,
+  TransformResultDependency,
+} from '../DeltaBundler/types';
+import type {ResolverInputOptions} from '../shared/types';
+import type {ConfigT} from 'metro-config';
+
+export declare function getTransformFn(
+  entryFiles: ReadonlyArray<string>,
+  bundler: Bundler,
+  deltaBundler: DeltaBundler,
+  config: ConfigT,
+  options: TransformInputOptions,
+  resolverOptions: ResolverInputOptions,
+): Promise<TransformFn>;
+export declare function getResolveDependencyFn(
+  bundler: Bundler,
+  platform: null | undefined | string,
+  resolverOptions: ResolverInputOptions,
+): Promise<
+  (from: string, dependency: TransformResultDependency) => BundlerResolution
+>;

package/src/lib/transformHelpers.js

@@ -10,11 +10,7 @@ var _isAssetFile = _interopRequireDefault(
   require("metro-resolver/private/utils/isAssetFile"),
 );
 function _interopRequireDefault(e) {
-  return e && e.__esModule
-    ? e
-    : {
-        default: e,
-      };
+  return e && e.__esModule ? e : { default: e };
 }
 const baseIgnoredInlineRequires = [
   "React",