metro 0.84.0 → 0.84.2

package/src/shared/output/RamBundle/buildSourcemapWithMetadata.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<<669a46ab2a802ea2b93d98edf337fff0>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/RamBundle/buildSourcemapWithMetadata.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {ModuleGroups, ModuleTransportLike} from '../../types';
+import type {IndexMap} from 'metro-source-map';
+
+type Params = {
+  fixWrapperOffset: boolean;
+  lazyModules: ReadonlyArray<ModuleTransportLike>;
+  moduleGroups: null | undefined | ModuleGroups;
+  startupModules: ReadonlyArray<ModuleTransportLike>;
+};
+declare const $$EXPORT_DEFAULT_DECLARATION$$: ($$PARAM_0$$: Params) => IndexMap;
+declare type $$EXPORT_DEFAULT_DECLARATION$$ =
+  typeof $$EXPORT_DEFAULT_DECLARATION$$;
+export default $$EXPORT_DEFAULT_DECLARATION$$;

package/src/shared/output/RamBundle/magic-number.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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<<94cd41a2f04528e81f82e6c2feadaf52>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/RamBundle/magic-number.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+declare const $$EXPORT_DEFAULT_DECLARATION$$: 0xfb0bd1e5;
+declare type $$EXPORT_DEFAULT_DECLARATION$$ =
+  typeof $$EXPORT_DEFAULT_DECLARATION$$;
+export default $$EXPORT_DEFAULT_DECLARATION$$;

package/src/shared/output/RamBundle/util.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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<<cb3371e2f23da9cd30e08ed76ec4f7db>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/RamBundle/util.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {ModuleGroups, ModuleTransportLike} from '../../types';
+import type {BasicSourceMap, IndexMap} from 'metro-source-map';
+
+import countLines from '../../../lib/countLines';
+
+declare function lineToLineSourceMap(
+  source: string,
+  filename?: string,
+): BasicSourceMap;
+type CombineOptions = {fixWrapperOffset: boolean};
+declare function combineSourceMaps(
+  modules: ReadonlyArray<ModuleTransportLike>,
+  moduleGroups?: ModuleGroups,
+  options?: null | undefined | CombineOptions,
+): IndexMap;
+declare function combineSourceMapsAddingOffsets(
+  modules: ReadonlyArray<ModuleTransportLike>,
+  x_metro_module_paths: Array<string>,
+  moduleGroups?: null | undefined | ModuleGroups,
+  options?: null | undefined | CombineOptions,
+): IndexMap;
+declare const joinModules: (
+  modules: ReadonlyArray<{readonly code: string}>,
+) => string;
+export {
+  combineSourceMaps,
+  combineSourceMapsAddingOffsets,
+  countLines,
+  joinModules,
+  lineToLineSourceMap,
+};

package/src/shared/output/RamBundle/write-sourcemap.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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<<000f29900c01342de92d247507075575>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/RamBundle/write-sourcemap.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+declare function writeSourcemap(
+  fileName: string,
+  contents: string,
+  log: (...args: Array<string>) => void,
+): Promise<unknown>;
+export default writeSourcemap;

package/src/shared/output/RamBundle.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 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<<bef82861a3de459220bf62515fd5900c>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/RamBundle.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {RamBundleInfo} from '../../DeltaBundler/Serializers/getRamBundleInfo';
+import type {OutputOptions, RequestOptions} from '../types';
+
+import Server from '../../Server';
+
+export declare function build(
+  packagerClient: Server,
+  requestOptions: RequestOptions,
+): Promise<RamBundleInfo>;
+export declare function save(
+  bundle: RamBundleInfo,
+  options: OutputOptions,
+  log: (x: string) => void,
+): Promise<unknown>;
+export declare const formatName: 'bundle';
+export declare type formatName = typeof formatName;

package/src/shared/output/bundle.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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<<d9877b2ba27e8e3f279901c80c7ad895>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/bundle.flow.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {AssetData} from '../../Assets';
+import type {BuildOptions, OutputOptions, RequestOptions} from '../types';
+
+import Server from '../../Server';
+
+export declare function build(
+  packagerClient: Server,
+  requestOptions: RequestOptions,
+  buildOptions?: BuildOptions,
+): Promise<{code: string; map: string; assets?: ReadonlyArray<AssetData>}>;
+export declare function save(
+  bundle: {code: string; map: string},
+  options: OutputOptions,
+  log: ($$PARAM_0$$: string) => void,
+): Promise<unknown>;
+export declare const formatName: 'bundle';
+export declare type formatName = typeof formatName;

package/src/shared/output/meta.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 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<<17ae3fc242dc6b3915a72d04dad032b8>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/meta.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+declare function meta(
+  code: Buffer | string,
+  encoding?: 'ascii' | 'utf16le' | 'utf8',
+): Buffer;
+export default meta;

package/src/shared/output/unbundle.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.
+ *
+ * @noformat
+ * @oncall react_native
+ * @generated SignedSource<<12b27507f799c8170067738c227bb2f3>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/unbundle.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+export * from './RamBundle';

package/src/shared/output/writeFile.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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<<37de849e415f8aa1e94b73289a573ee3>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/writeFile.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+declare function writeFile(
+  filePath: string,
+  data: string | Buffer | Uint8Array,
+  encoding?: string,
+): Promise<void>;
+export default writeFile;

package/src/shared/types.d.ts

@@ -0,0 +1,152 @@
+/**
+ * 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<<31593693c0cafcd55eaf4885efddc6be>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/types.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {
+  Options as DeltaBundlerOptions,
+  TransformInputOptions,
+} from '../DeltaBundler/types';
+import type {TransformProfile} from 'metro-babel-transformer';
+import type {CustomResolverOptions} from 'metro-resolver';
+import type {
+  MetroSourceMapSegmentTuple,
+  MixedSourceMap,
+} from 'metro-source-map';
+import type {
+  CustomTransformOptions,
+  MinifierOptions,
+} from 'metro-transform-worker';
+
+type MetroSourceMapOrMappings =
+  | MixedSourceMap
+  | Array<MetroSourceMapSegmentTuple>;
+export declare enum SourcePathsMode {
+  Absolute = 'absolute',
+  ServerUrl = 'url-server',
+}
+export declare namespace SourcePathsMode {
+  export function cast(value: string | null | undefined): SourcePathsMode;
+  export function isValid(
+    value: string | null | undefined,
+  ): value is SourcePathsMode;
+  export function members(): IterableIterator<SourcePathsMode>;
+  export function getName(value: SourcePathsMode): string;
+}
+export type ReadonlySourceLocation = Readonly<{
+  start: Readonly<{line: number; column: number}>;
+  end: Readonly<{line: number; column: number}>;
+}>;
+export type BundleOptions = {
+  readonly customResolverOptions: CustomResolverOptions;
+  customTransformOptions: CustomTransformOptions;
+  dev: boolean;
+  entryFile: string;
+  readonly excludeSource: boolean;
+  readonly inlineSourceMap: boolean;
+  readonly lazy: boolean;
+  minify: boolean;
+  readonly modulesOnly: boolean;
+  onProgress:
+    | null
+    | undefined
+    | ((doneCont: number, totalCount: number) => unknown);
+  readonly platform: null | undefined | string;
+  readonly runModule: boolean;
+  readonly shallow: boolean;
+  sourceMapUrl: null | undefined | string;
+  sourceUrl: null | undefined | string;
+  createModuleIdFactory?: () => (path: string) => number;
+  readonly unstable_transformProfile: TransformProfile;
+  readonly sourcePaths: SourcePathsMode;
+};
+export type BuildOptions = Readonly<{withAssets?: boolean}>;
+export type ResolverInputOptions = Readonly<{
+  customResolverOptions?: CustomResolverOptions;
+  dev: boolean;
+}>;
+export type SerializerOptions = {
+  readonly sourceMapUrl: null | undefined | string;
+  readonly sourceUrl: null | undefined | string;
+  readonly runModule: boolean;
+  readonly excludeSource: boolean;
+  readonly inlineSourceMap: boolean;
+  readonly modulesOnly: boolean;
+  readonly sourcePaths: SourcePathsMode;
+};
+export type GraphOptions = {
+  readonly lazy: boolean;
+  readonly shallow: boolean;
+};
+export type SplitBundleOptions = Readonly<{
+  entryFile: string;
+  resolverOptions: ResolverInputOptions;
+  transformOptions: TransformInputOptions;
+  serializerOptions: SerializerOptions;
+  graphOptions: GraphOptions;
+  onProgress: DeltaBundlerOptions['onProgress'];
+}>;
+export type ModuleGroups = {
+  groups: Map<number, Set<number>>;
+  modulesById: Map<number, ModuleTransportLike>;
+  modulesInGroups: Set<number>;
+};
+export type ModuleTransportLike = {
+  readonly code: string;
+  readonly id: number;
+  readonly map: null | undefined | MetroSourceMapOrMappings;
+  readonly name?: string;
+  readonly sourcePath: string;
+};
+export type ModuleTransportLikeStrict = {
+  readonly code: string;
+  readonly id: number;
+  readonly map: null | undefined | MetroSourceMapOrMappings;
+  readonly name?: string;
+  readonly sourcePath: string;
+};
+export type RamModuleTransport = Omit<
+  ModuleTransportLikeStrict,
+  keyof {readonly source: string; readonly type: string}
+> & {readonly source: string; readonly type: string};
+export type OutputOptions = {
+  bundleOutput: string;
+  bundleEncoding?: 'utf8' | 'utf16le' | 'ascii';
+  dev?: boolean;
+  indexedRamBundle?: boolean;
+  platform: string;
+  sourcemapOutput?: string;
+  sourcemapSourcesRoot?: string;
+  sourcemapUseAbsolutePath?: boolean;
+};
+type SafeOptionalProps<T> = {
+  [K in keyof T]: T[K] extends void ? void | T[K] : T[K];
+};
+export type RequestOptions = Readonly<
+  SafeOptionalProps<{
+    entryFile: string;
+    inlineSourceMap?: boolean;
+    sourceMapUrl?: string;
+    dev?: boolean;
+    minify: boolean;
+    platform: string;
+    createModuleIdFactory?: () => (path: string) => number;
+    onProgress?: (transformedFileCount: number, totalFileCount: number) => void;
+    customResolverOptions?: CustomResolverOptions;
+    customTransformOptions?: CustomTransformOptions;
+    unstable_transformProfile?: TransformProfile;
+  }>
+>;
+export type {MinifierOptions};