metro 0.84.0 → 0.84.2

package/src/lib/reporting.d.ts

@@ -0,0 +1,135 @@
+/**
+ * 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<<1ff95f1ad6bb911f3d2c2bc41d59bc1a>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/lib/reporting.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+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/splitBundleOptions.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<<cf1e935fe7a5b1c8573b53b1c1921e70>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/lib/splitBundleOptions.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+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,42 @@
+/**
+ * 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<<dfdfdf9ddb80994cc031e3767a87b56f>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/lib/transformHelpers.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+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/node-haste/DependencyGraph/ModuleResolution.d.ts

@@ -0,0 +1,133 @@
+/**
+ * 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<<d5224d8913b7e0c52ac84b215b356422>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/node-haste/DependencyGraph/ModuleResolution.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {
+  BundlerResolution,
+  TransformResultDependency,
+} from '../../DeltaBundler/types';
+import type {Reporter} from '../../lib/reporting';
+import type {ResolverInputOptions} from '../../shared/types';
+import type {
+  CustomResolver,
+  DoesFileExist,
+  FileCandidates,
+  FileSystemLookup,
+  Resolution,
+  ResolveAsset,
+} from 'metro-resolver';
+import type {PackageForModule, PackageJson} from 'metro-resolver/private/types';
+
+export type DirExistsFn = (filePath: string) => boolean;
+export type Packageish = {path: string; read(): PackageJson};
+export type Moduleish = {readonly path: string};
+export type PackageishCache<TPackage> = {
+  getPackage(
+    name: string,
+    platform?: string,
+    supportsNativePlatform?: boolean,
+  ): TPackage;
+  getPackageOf(
+    absolutePath: string,
+  ): null | undefined | {pkg: TPackage; packageRelativePath: string};
+};
+type Options<TPackage> = Readonly<{
+  assetExts: ReadonlySet<string>;
+  dirExists: DirExistsFn;
+  disableHierarchicalLookup: boolean;
+  doesFileExist: DoesFileExist;
+  emptyModulePath: string;
+  extraNodeModules: null | undefined | object;
+  fileSystemLookup: FileSystemLookup;
+  getHasteModulePath: (
+    name: string,
+    platform: null | undefined | string,
+  ) => null | undefined | string;
+  getHastePackagePath: (
+    name: string,
+    platform: null | undefined | string,
+  ) => null | undefined | string;
+  mainFields: ReadonlyArray<string>;
+  packageCache: PackageishCache<TPackage>;
+  nodeModulesPaths: ReadonlyArray<string>;
+  preferNativePlatform: boolean;
+  projectRoot: string;
+  reporter: Reporter;
+  resolveAsset: ResolveAsset;
+  resolveRequest: null | undefined | CustomResolver;
+  sourceExts: ReadonlyArray<string>;
+  unstable_conditionNames: ReadonlyArray<string>;
+  unstable_conditionsByPlatform: Readonly<{
+    [platform: string]: ReadonlyArray<string>;
+  }>;
+  unstable_enablePackageExports: boolean;
+  unstable_incrementalResolution: boolean;
+}>;
+export declare class ModuleResolver<TPackage extends Packageish> {
+  _options: Options<TPackage>;
+  _projectRootFakeModulePath: string;
+  _cachedEmptyModule: null | undefined | BundlerResolution;
+  constructor(options: Options<TPackage>);
+  _getEmptyModule(): BundlerResolution;
+  resolveDependency(
+    originModulePath: string,
+    dependency: TransformResultDependency,
+    allowHaste: boolean,
+    platform: string | null,
+    resolverOptions: ResolverInputOptions,
+  ): BundlerResolution;
+  _getPackage: (packageJsonPath: string) => null | undefined | PackageJson;
+  _getPackageForModule: (
+    absolutePath: string,
+  ) => null | undefined | PackageForModule;
+  /**
+   * TODO: Return Resolution instead of coercing to BundlerResolution here
+   */
+  _getFileResolvedModule(resolution: Resolution): BundlerResolution;
+  _logWarning: (message: string) => void;
+  _removeRoot(candidates: FileCandidates): FileCandidates;
+}
+export declare class UnableToResolveError extends Error {
+  /**
+   * File path of the module that tried to require a module, ex. `/js/foo.js`.
+   */
+  originModulePath: string;
+  /**
+   * The name of the module that was required, no necessarily a path,
+   * ex. `./bar`, or `invariant`.
+   */
+  targetModuleName: string;
+  /**
+   * Original error that causes this error
+   */
+  cause: null | undefined | Error;
+  /**
+   * Fixed type field in common with other Metro build errors.
+   */
+  readonly type: 'UnableToResolveError';
+  constructor(
+    originModulePath: string,
+    targetModuleName: string,
+    message: string,
+    options?: Readonly<{
+      dependency?: null | undefined | TransformResultDependency;
+      cause?: Error;
+    }>,
+  );
+  buildCodeFrameMessage(
+    dependency: null | undefined | TransformResultDependency,
+  ): null | undefined | string;
+}

package/src/node-haste/DependencyGraph/createFileMap.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<<c008adad2ea747972e2f301a6375b447>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/node-haste/DependencyGraph/createFileMap.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {ConfigT} from 'metro-config';
+import type {HasteMap} from 'metro-file-map';
+
+import MetroFileMap, {DependencyPlugin} from 'metro-file-map';
+
+declare function createFileMap(
+  config: ConfigT,
+  options?: Readonly<{
+    extractDependencies?: boolean;
+    watch?: boolean;
+    throwOnModuleCollision?: boolean;
+    cacheFilePrefix?: string;
+  }>,
+): {
+  fileMap: MetroFileMap;
+  hasteMap: HasteMap;
+  dependencyPlugin: null | undefined | DependencyPlugin;
+};
+export default createFileMap;

package/src/node-haste/DependencyGraph.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 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<<eb945b3566e9ed370894adaada197736>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/node-haste/DependencyGraph.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {
+  BundlerResolution,
+  TransformResultDependency,
+} from '../DeltaBundler/types';
+import type {ResolverInputOptions} from '../shared/types';
+import type Package from './Package';
+import type {ConfigT} from 'metro-config';
+import type {
+  ChangeEvent,
+  FileSystem,
+  HasteMap,
+  HealthCheckResult,
+  WatcherStatus,
+  default as MetroFileMap,
+} from 'metro-file-map';
+
+import {ModuleResolver} from './DependencyGraph/ModuleResolution';
+import {PackageCache} from './PackageCache';
+import EventEmitter from 'events';
+
+declare class DependencyGraph extends EventEmitter {
+  _config: ConfigT;
+  _haste: MetroFileMap;
+  _fileSystem: FileSystem;
+  _hasteMap: HasteMap;
+  _moduleResolver: ModuleResolver<Package>;
+  _resolutionCache: Map<
+    string | symbol,
+    Map<
+      string | symbol,
+      Map<string | symbol, Map<string | symbol, BundlerResolution>>
+    >
+  >;
+  _initializedPromise: Promise<void>;
+  constructor(
+    config: ConfigT,
+    options?: {
+      readonly hasReducedPerformance?: boolean;
+      readonly watch?: boolean;
+    },
+  );
+  _onWatcherHealthCheck(result: HealthCheckResult): void;
+  _onWatcherStatus(status: WatcherStatus): void;
+  ready(): Promise<void>;
+  _onHasteChange($$PARAM_0$$: ChangeEvent): void;
+  _createModuleResolver(): void;
+  _getClosestPackage(
+    absoluteModulePath: string,
+  ): null | undefined | {packageJsonPath: string; packageRelativePath: string};
+  _createPackageCache(): PackageCache;
+  getAllFiles(): Array<string>;
+  /**
+   * Used when watcher.unstable_lazySha1 is true
+   */
+  getOrComputeSha1(
+    mixedPath: string,
+  ): Promise<{content?: Buffer; sha1: string}>;
+  getWatcher(): EventEmitter;
+  end(): void;
+  /** Given a search context, return a list of file paths matching the query. */
+  matchFilesWithContext(
+    from: string,
+    context: Readonly<{recursive: boolean; filter: RegExp}>,
+  ): Iterable<string>;
+  resolveDependency(
+    originModulePath: string,
+    dependency: TransformResultDependency,
+    platform: string | null,
+    resolverOptions: ResolverInputOptions,
+    $$PARAM_4$$?: {assumeFlatNodeModules: boolean},
+  ): BundlerResolution;
+  doesFileExist: (filePath: string) => boolean;
+  getHasteName(filePath: string): string;
+  getDependencies(filePath: string): Array<string>;
+}
+export default DependencyGraph;

package/src/node-haste/Package.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 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<<17776d35467f02c7e07dcde4be309545>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/node-haste/Package.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import type {PackageJson} from 'metro-resolver/private/types';
+
+declare class Package {
+  path: string;
+  _root: string;
+  _content: null | undefined | PackageJson;
+  constructor($$PARAM_0$$: {file: string});
+  invalidate(): void;
+  read(): PackageJson;
+}
+export default Package;

package/src/node-haste/PackageCache.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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<<eaea6d7e01d54353f700cdadd60c4bf2>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/node-haste/PackageCache.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+import Package from './Package';
+
+type GetClosestPackageFn = (
+  absoluteFilePath: string,
+) => null | undefined | {packageJsonPath: string; packageRelativePath: string};
+export declare class PackageCache {
+  _getClosestPackage: GetClosestPackageFn;
+  _packageCache: {[filePath: string]: Package};
+  _packagePathAndSubpathByModulePath: {
+    [filePath: string]:
+      | null
+      | undefined
+      | {packageJsonPath: string; packageRelativePath: string};
+  };
+  _modulePathsByPackagePath: {
+    [filePath: string]: Set<string>;
+  };
+  constructor(options: {getClosestPackage: GetClosestPackageFn});
+  getPackage(filePath: string): Package;
+  getPackageOf(
+    absoluteModulePath: string,
+  ): null | undefined | {pkg: Package; packageRelativePath: string};
+  invalidate(filePath: string): void;
+}

package/src/node-haste/lib/AssetPaths.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<<31b3384bffa191e4c3c9916d93df8571>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/node-haste/lib/AssetPaths.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+export type AssetPath = {
+  assetName: string;
+  name: string;
+  platform: null | undefined | string;
+  resolution: number;
+  type: string;
+};
+/**
+ * Return `null` if the `filePath` doesn't have a valid extension, required
+ * to describe the type of an asset.
+ */
+export declare function tryParse(
+  filePath: string,
+  platforms: ReadonlySet<string>,
+): null | undefined | AssetPath;
+export declare function parse(
+  filePath: string,
+  platforms: ReadonlySet<string>,
+): AssetPath;

package/src/node-haste/lib/parsePlatformFilePath.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<<61c16b5ef31517dc44347558a4dd431a>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/node-haste/lib/parsePlatformFilePath.js
+ * To regenerate, run:
+ *   js1 build metro-ts-defs (internal) OR
+ *   yarn run build-ts-defs (OSS) 
+ */
+
+type PlatformFilePathParts = {
+  dirPath: string;
+  baseName: string;
+  platform: null | undefined | string;
+  extension: null | undefined | string;
+};
+/**
+ * Extract the components of a file path that can have a platform specifier: Ex.
+ * `index.ios.js` is specific to the `ios` platform and has the extension `js`.
+ */
+declare function parsePlatformFilePath(
+  filePath: string,
+  platforms: ReadonlySet<string>,
+): PlatformFilePathParts;
+export default parsePlatformFilePath;

package/src/shared/output/RamBundle/as-assets.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<<02d7f6eec9c93d02612c9b2fdef18cef>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/RamBundle/as-assets.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} from '../../types';
+/**
+ * Saves all JS modules of an app as single files
+ * The startup code (prelude, polyfills etc.) are written to the file
+ * designated by the `bundleOuput` option.
+ * All other modules go into a 'js-modules' folder that in the same parent
+ * directory as the startup file.
+ */
+declare function saveAsAssets(
+  bundle: RamBundleInfo,
+  options: OutputOptions,
+  log: (...args: Array<string>) => void,
+): Promise<unknown>;
+export default saveAsAssets;

package/src/shared/output/RamBundle/as-indexed-file.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<<cf05d2127a356bae7e3789c2fefa25d3>>
+ *
+ * This file was translated from Flow by scripts/generateTypeScriptDefinitions.js
+ * Original file: packages/metro/src/shared/output/RamBundle/as-indexed-file.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 {
+  ModuleGroups,
+  ModuleTransportLike,
+  OutputOptions,
+} from '../../types';
+/**
+ * Saves all JS modules of an app as a single file, separated with null bytes.
+ * The file begins with an offset table that contains module ids and their
+ * lengths/offsets.
+ * The module id for the startup code (prelude, polyfills etc.) is the
+ * empty string.
+ */
+export declare function save(
+  bundle: RamBundleInfo,
+  options: OutputOptions,
+  log: (...args: Array<string>) => void,
+): Promise<unknown>;
+export declare function buildTableAndContents(
+  startupCode: string,
+  modules: ReadonlyArray<ModuleTransportLike>,
+  moduleGroups: ModuleGroups,
+  encoding?: 'utf8' | 'utf16le' | 'ascii',
+): Array<Buffer>;
+export declare function createModuleGroups(
+  groups: Map<number, Set<number>>,
+  modules: ReadonlyArray<ModuleTransportLike>,
+): ModuleGroups;