metro 0.84.0 → 0.84.2

package/src/DeltaBundler/Serializers/helpers/getSourceMapInfo.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<cd7e523b4fdfbff33e663b21c4529401>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/Serializers/helpers/getSourceMapInfo.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {Module} from '../../types';
+import type {
+  FBSourceFunctionMap,
+  MetroSourceMapSegmentTuple,
+} from 'metro-source-map';
+
+declare function getSourceMapInfo(
+  module: Module,
+  options: {
+    readonly excludeSource: boolean;
+    readonly shouldAddToIgnoreList: ($$PARAM_0$$: Module) => boolean;
+    getSourceUrl: null | undefined | ((module: Module) => string);
+  },
+): {
+  readonly map: Array<MetroSourceMapSegmentTuple>;
+  readonly functionMap: null | undefined | FBSourceFunctionMap;
+  readonly code: string;
+  readonly path: string;
+  readonly source: string;
+  readonly lineCount: number;
+  readonly isIgnored: boolean;
+};
+export default getSourceMapInfo;

package/src/DeltaBundler/Serializers/helpers/getTransitiveDependencies.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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<55bd91c160900bb31ffe72e2ddfad85d>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/Serializers/helpers/getTransitiveDependencies.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {ReadOnlyGraph} from '../../types';
+
+declare function getTransitiveDependencies<T>(
+  path: string,
+  graph: ReadOnlyGraph<T>,
+): Set<string>;
+export default getTransitiveDependencies;

package/src/DeltaBundler/Serializers/helpers/js.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<f61e17deebe7e34585ad214ae287e704>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/Serializers/helpers/js.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {MixedOutput, Module} from '../../types';
+import type {JsOutput} from 'metro-transform-worker';
+
+export type Options = Readonly<{
+  createModuleId: ($$PARAM_0$$: string) => number | string;
+  dev: boolean;
+  includeAsyncPaths: boolean;
+  projectRoot: string;
+  serverRoot: string;
+  sourceUrl: null | undefined | string;
+}>;
+export declare function wrapModule(module: Module, options: Options): string;
+export declare function getModuleParams(
+  module: Module,
+  options: Options,
+): Array<unknown>;
+export declare function getJsOutput(
+  module: Readonly<{output: ReadonlyArray<MixedOutput>; path?: string}>,
+): JsOutput;
+export declare function isJsModule(module: Module): boolean;

package/src/DeltaBundler/Serializers/helpers/processModules.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<1c5fe56fba9dbedcde1dbaeb5a486467>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/Serializers/helpers/processModules.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {Module} from '../../types';
+
+declare function processModules(
+  modules: ReadonlyArray<Module>,
+  $$PARAM_1$$: Readonly<{
+    filter?: (module: Module) => boolean;
+    createModuleId: ($$PARAM_0$$: string) => number;
+    dev: boolean;
+    includeAsyncPaths: boolean;
+    projectRoot: string;
+    serverRoot: string;
+    sourceUrl: null | undefined | string;
+  }>,
+): ReadonlyArray<[Module, string]>;
+export default processModules;

package/src/DeltaBundler/Serializers/hmrJSBundle.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<d8ccae61344526a4f6da61987b3dad9b>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/Serializers/hmrJSBundle.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {DeltaResult, ReadOnlyGraph} from '../types';
+import type {HmrModule} from 'metro-runtime/src/modules/types';
+
+type Options = Readonly<{
+  clientUrl: URL;
+  createModuleId: ($$PARAM_0$$: string) => number;
+  includeAsyncPaths: boolean;
+  projectRoot: string;
+  serverRoot: string;
+}>;
+declare function hmrJSBundle(
+  delta: DeltaResult,
+  graph: ReadOnlyGraph,
+  options: Options,
+): {
+  readonly added: ReadonlyArray<HmrModule>;
+  readonly deleted: ReadonlyArray<number>;
+  readonly modified: ReadonlyArray<HmrModule>;
+};
+export default hmrJSBundle;

package/src/DeltaBundler/Serializers/sourceMapGenerator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<49bc83c20821024a7b77f5d5c3168d62>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/Serializers/sourceMapGenerator.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {Module} from '../types';
+
+import {fromRawMappings, fromRawMappingsNonBlocking} from 'metro-source-map';
+
+export type SourceMapGeneratorOptions = Readonly<{
+  excludeSource: boolean;
+  processModuleFilter: (module: Module) => boolean;
+  shouldAddToIgnoreList: (module: Module) => boolean;
+  getSourceUrl: null | undefined | ((module: Module) => string);
+}>;
+declare function sourceMapGenerator(
+  modules: ReadonlyArray<Module>,
+  options: SourceMapGeneratorOptions,
+): ReturnType<typeof fromRawMappings>;
+declare function sourceMapGeneratorNonBlocking(
+  modules: ReadonlyArray<Module>,
+  options: SourceMapGeneratorOptions,
+): ReturnType<typeof fromRawMappingsNonBlocking>;
+export {sourceMapGenerator, sourceMapGeneratorNonBlocking};

package/src/DeltaBundler/Serializers/sourceMapObject.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<cb907f1a9aa40efd505a19826a21be6d>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/Serializers/sourceMapObject.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {Module} from '../types';
+import type {SourceMapGeneratorOptions} from './sourceMapGenerator';
+import type {MixedSourceMap} from 'metro-source-map';
+
+declare function sourceMapObject(
+  modules: ReadonlyArray<Module>,
+  options: SourceMapGeneratorOptions,
+): MixedSourceMap;
+declare function sourceMapObjectNonBlocking(
+  modules: ReadonlyArray<Module>,
+  options: SourceMapGeneratorOptions,
+): Promise<MixedSourceMap>;
+export {sourceMapObject, sourceMapObjectNonBlocking};

package/src/DeltaBundler/Serializers/sourceMapString.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<578dd38524928420df15b0aba8f32e77>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/Serializers/sourceMapString.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {Module} from '../types';
+import type {SourceMapGeneratorOptions} from './sourceMapGenerator';
+
+declare function sourceMapString(
+  modules: ReadonlyArray<Module>,
+  options: SourceMapGeneratorOptions,
+): string;
+declare function sourceMapStringNonBlocking(
+  modules: ReadonlyArray<Module>,
+  options: SourceMapGeneratorOptions,
+): Promise<string>;
+export {sourceMapString, sourceMapStringNonBlocking};

package/src/DeltaBundler/Transformer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<15f603afc860c64c7acc5a6cfe2a6717>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/Transformer.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {TransformResult, TransformResultWithSource} from '../DeltaBundler';
+import type {TransformOptions} from './Worker';
+import type {ConfigT} from 'metro-config';
+
+import WorkerFarm from './WorkerFarm';
+import {Cache} from 'metro-cache';
+
+type GetOrComputeSha1Fn = (
+  $$PARAM_0$$: string,
+) => Promise<Readonly<{content?: Buffer; sha1: string}>>;
+declare class Transformer {
+  _config: ConfigT;
+  _cache: Cache<TransformResult>;
+  _baseHash: string;
+  _getSha1: GetOrComputeSha1Fn;
+  _workerFarm: WorkerFarm;
+  constructor(
+    config: ConfigT,
+    opts: Readonly<{getOrComputeSha1: GetOrComputeSha1Fn}>,
+  );
+  transformFile(
+    filePath: string,
+    transformerOptions: TransformOptions,
+    fileBuffer?: Buffer,
+  ): Promise<TransformResultWithSource>;
+  end(): Promise<void>;
+}
+export default Transformer;

package/src/DeltaBundler/Worker.d.ts

@@ -0,0 +1,44 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<36640ae81894592fbdc160fac081bdbf>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/Worker.flow.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {TransformResult} from './types';
+import type {LogEntry} from 'metro-core/private/Logger';
+import type {
+  JsTransformerConfig,
+  JsTransformOptions,
+} from 'metro-transform-worker';
+
+export type {JsTransformOptions as TransformOptions} from 'metro-transform-worker';
+export type TransformerConfig = {
+  transformerPath: string;
+  transformerConfig: JsTransformerConfig;
+};
+type Data = Readonly<{
+  result: TransformResult;
+  sha1: string;
+  transformFileStartLogEntry: LogEntry;
+  transformFileEndLogEntry: LogEntry;
+}>;
+export declare const transform: (
+  filename: string,
+  transformOptions: JsTransformOptions,
+  projectRoot: string,
+  transformerConfig: TransformerConfig,
+  fileBuffer?: Buffer,
+) => Promise<Data>;
+export declare type transform = typeof transform;
+export type Worker = {readonly transform: typeof transform};

package/src/DeltaBundler/WorkerFarm.d.ts

@@ -0,0 +1,77 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<bbd52f1dc5e4a9253455034b585115ac>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/WorkerFarm.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {TransformResult} from '../DeltaBundler';
+import type {TransformerConfig, TransformOptions, Worker} from './Worker';
+import type {ConfigT} from 'metro-config';
+import type {Readable} from 'stream';
+
+type WorkerInterface = Readonly<
+  Omit<
+    Worker,
+    keyof {
+      end(): void | Promise<void>;
+      getStdout(): Readable;
+      getStderr(): Readable;
+    }
+  > & {
+    end(): void | Promise<void>;
+    getStdout(): Readable;
+    getStderr(): Readable;
+  }
+>;
+type TransformerResult = Readonly<{result: TransformResult; sha1: string}>;
+declare class WorkerFarm {
+  _config: ConfigT;
+  _transformerConfig: TransformerConfig;
+  _worker: WorkerInterface | Worker;
+  constructor(config: ConfigT, transformerConfig: TransformerConfig);
+  kill(): Promise<void>;
+  transform(
+    filename: string,
+    options: TransformOptions,
+    fileBuffer?: Buffer,
+  ): Promise<TransformerResult>;
+  _makeFarm(
+    absoluteWorkerPath: string,
+    exposedMethods: ReadonlyArray<string>,
+    numWorkers: number,
+  ): WorkerInterface;
+  _computeWorkerKey(
+    method: string,
+    filename: string,
+  ): null | undefined | string;
+  _formatGenericError(
+    err: Readonly<{message: string; stack?: string}>,
+    filename: string,
+  ): TransformError;
+  _formatBabelError(
+    err: Readonly<{
+      message: string;
+      stack?: string;
+      type?: string;
+      codeFrame?: unknown;
+      loc: {line?: number; column?: number};
+    }>,
+    filename: string,
+  ): TransformError;
+}
+export default WorkerFarm;
+declare class TransformError extends SyntaxError {
+  type: string;
+  constructor(message: string);
+}

package/src/DeltaBundler/buildSubgraph.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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.
+ *
+ * @noformat
+ * @generated SignedSource<<1e334cd36bb429700b82654f1ddab0a0>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/buildSubgraph.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {RequireContext} from '../lib/contextModule';
+import type {
+  ModuleData,
+  ResolvedDependency,
+  ResolveFn,
+  TransformFn,
+} from './types';
+
+type Parameters<T> = Readonly<{
+  resolve: ResolveFn;
+  transform: TransformFn<T>;
+  shouldTraverse: ($$PARAM_0$$: ResolvedDependency) => boolean;
+}>;
+export declare function buildSubgraph<T>(
+  entryPaths: ReadonlySet<string>,
+  resolvedContexts: ReadonlyMap<string, null | undefined | RequireContext>,
+  $$PARAM_2$$: Parameters<T>,
+): Promise<{
+  moduleData: Map<string, ModuleData<T>>;
+  errors: Map<string, Error>;
+}>;

package/src/DeltaBundler/getTransformCacheKey.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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<1a82c2238a94514c16e7bb93bf49d8c9>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/getTransformCacheKey.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {TransformerConfig} from './Worker';
+
+declare function getTransformCacheKey(opts: {
+  readonly cacheVersion: string;
+  readonly projectRoot: string;
+  readonly transformerConfig: TransformerConfig;
+}): string;
+export default getTransformCacheKey;

package/src/DeltaBundler/mergeDeltas.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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<46981e9bc1ef3945b99b147cbdf9ec5d>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/DeltaBundler/mergeDeltas.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {DeltaBundle} from 'metro-runtime/src/modules/types';
+
+declare function mergeDeltas(
+  delta1: DeltaBundle,
+  delta2: DeltaBundle,
+): DeltaBundle;
+export default mergeDeltas;