metro 0.76.1 → 0.76.3

package/types/IncrementalBundler.d.ts

@@ -1,97 +0,0 @@
-/**
- * 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 {
-  Options as DeltaBundlerOptions,
-  ReadOnlyDependencies,
-  TransformInputOptions,
-} from './DeltaBundler/types';
-import {ResolverInputOptions} from './shared/types';
-import type {ConfigT} from 'metro-config';
-import type {GraphId} from './lib/getGraphId';
-import DeltaBundler, {DeltaResult, Graph, Module} from './DeltaBundler';
-import type Bundler from './Bundler';
-
-export type RevisionId = string;
-
-export type OutputGraph = Graph<void>;
-
-export interface OtherOptions {
-  readonly onProgress: DeltaBundlerOptions<void>['onProgress'];
-  readonly shallow: boolean;
-}
-
-export interface GraphRevision {
-  readonly id: RevisionId;
-  readonly date: Date;
-  readonly graphId: GraphId;
-  readonly graph: OutputGraph;
-  readonly prepend: ReadonlyArray<Module<void>>;
-}
-
-export interface IncrementalBundlerOptions {
-  readonly hasReducedPerformance?: boolean;
-  readonly watch?: boolean;
-}
-
-export default class IncrementalBundler {
-  static revisionIdFromString: (str: string) => RevisionId;
-  constructor(config: ConfigT, options?: IncrementalBundlerOptions);
-
-  end(): void;
-  getBundler(): Bundler;
-  getDeltaBundler(): DeltaBundler<void>;
-  getRevision(revisionId: RevisionId): Promise<GraphRevision> | null;
-  getRevisionByGraphId(graphId: GraphId): Promise<GraphRevision> | null;
-
-  buildGraphForEntries(
-    entryFiles: ReadonlyArray<string>,
-    transformOptions: TransformInputOptions,
-    resolverOptions: ResolverInputOptions,
-    otherOptions?: OtherOptions,
-  ): Promise<OutputGraph>;
-
-  getDependencies(
-    entryFiles: ReadonlyArray<string>,
-    transformOptions: TransformInputOptions,
-    resolverOptions: ResolverInputOptions,
-    otherOptions?: OtherOptions,
-  ): Promise<ReadOnlyDependencies<void>>;
-
-  buildGraph(
-    entryFile: string,
-    transformOptions: TransformInputOptions,
-    resolverOptions: ResolverInputOptions,
-    otherOptions?: OtherOptions,
-  ): Promise<
-    Readonly<{graph: OutputGraph; prepend: ReadonlyArray<Module<void>>}>
-  >;
-
-  initializeGraph(
-    entryFile: string,
-    transformOptions: TransformInputOptions,
-    resolverOptions: ResolverInputOptions,
-    otherOptions?: OtherOptions,
-  ): Promise<{
-    delta: DeltaResult<void>;
-    revision: GraphRevision;
-  }>;
-
-  updateGraph(
-    revision: GraphRevision,
-    reset: boolean,
-  ): Promise<{
-    delta: DeltaResult<void>;
-    revision: GraphRevision;
-  }>;
-
-  endGraph(graphId: GraphId): Promise<void>;
-  ready(): Promise<void>;
-}

package/types/ModuleGraph/worker/collectDependencies.d.ts

@@ -1,27 +0,0 @@
-/**
- * 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
- */
-
-export type ContextMode = 'sync' | 'eager' | 'lazy' | 'lazy-once';
-
-export interface ContextFilter {
-  pattern: string;
-  flags: string;
-}
-
-export interface RequireContextParams {
-  /* Should search for files recursively. Optional, default `true` when `require.context` is used */
-  readonly recursive: boolean;
-  /* Filename filter pattern for use in `require.context`. Optional, default `.*` (any file) when `require.context` is used */
-  readonly filter: Readonly<ContextFilter>;
-  /** Mode for resolving dynamic dependencies. Defaults to `sync` */
-  readonly mode: ContextMode;
-}
-
-export type DynamicRequiresBehavior = 'throwAtRuntime' | 'reject';

package/types/Server/MultipartResponse.d.ts

@@ -1,31 +0,0 @@
-/**
- * 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, ServerResponse} from 'http';
-
-export type Data = string | Buffer | Uint8Array;
-export interface Headers {
-  [name: string]: string | number;
-}
-
-export default class MultipartResponse {
-  static wrapIfSupported(
-    req: IncomingMessage,
-    res: ServerResponse,
-  ): MultipartResponse | ServerResponse;
-  static serializeHeaders(headers: Headers): string;
-  res: ServerResponse;
-  headers: Headers;
-  constructor(res: ServerResponse);
-  writeChunk(headers: Headers | null, data?: Data, isLast?: boolean): void;
-  writeHead(status: number, headers?: Headers): void;
-  setHeader(name: string, value: string | number): void;
-  end(data?: Data): void;
-}

package/types/Server.d.ts

@@ -1,113 +0,0 @@
-/**
- * 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 {AssetData} from './Asset';
-import type {RamBundleInfo} from './DeltaBundler/Serializers/getRamBundleInfo';
-import IncrementalBundler, {RevisionId} from './IncrementalBundler';
-import type {GraphId} from './lib/getGraphId';
-import type MultipartResponse from './Server/MultipartResponse';
-import type {
-  BundleOptions,
-  GraphOptions,
-  SplitBundleOptions,
-} from './shared/types';
-import type {IncomingMessage, ServerResponse} from 'http';
-import type {
-  CustomTransformOptions,
-  TransformProfile,
-} from 'metro-babel-transformer';
-import type {ConfigT, RootPerfLogger} from 'metro-config';
-import type {CustomResolverOptions} from 'metro-resolver';
-
-export interface SegmentLoadData {
-  [index: number]: [number[], number | null];
-}
-
-export interface BundleMetadata {
-  hash: string;
-  otaBuildNumber: string | null;
-  mobileConfigs: string[];
-  segmentHashes: string[];
-  segmentLoadData: SegmentLoadData;
-}
-
-export interface ProcessStartContext extends SplitBundleOptions {
-  readonly buildNumber: number;
-  readonly bundleOptions: BundleOptions;
-  readonly graphId: GraphId;
-  readonly graphOptions: GraphOptions;
-  readonly mres: MultipartResponse | ServerResponse;
-  readonly req: IncomingMessage;
-  readonly revisionId?: RevisionId | null;
-  readonly bundlePerfLogger: RootPerfLogger;
-}
-
-export interface ProcessDeleteContext {
-  readonly graphId: GraphId;
-  readonly req: IncomingMessage;
-  readonly res: ServerResponse;
-}
-
-export interface ProcessEndContext<T> extends ProcessStartContext {
-  readonly result: T;
-}
-
-export type ServerOptions = Readonly<{
-  hasReducedPerformance?: boolean;
-  onBundleBuilt?: (bundlePath: string) => void;
-  watch?: boolean;
-}>;
-
-export interface DefaultGraphOptions {
-  customResolverOptions: CustomResolverOptions;
-  customTransformOptions: CustomTransformOptions;
-  dev: boolean;
-  hot: boolean;
-  minify: boolean;
-  runtimeBytecodeVersion?: number;
-  unstable_transformProfile: TransformProfile;
-}
-
-export interface DefaultBundleOptions extends DefaultGraphOptions {
-  excludeSource: false;
-  inlineSourceMap: false;
-  modulesOnly: false;
-  onProgress: null;
-  runModule: true;
-  shallow: false;
-  sourceMapUrl: null;
-  sourceUrl: null;
-}
-
-export default class Server {
-  static DEFAULT_GRAPH_OPTIONS: DefaultGraphOptions;
-  static DEFAULT_BUNDLE_OPTIONS: BundleOptions;
-  constructor(config: ConfigT, options?: ServerOptions);
-  end(): void;
-  getBundler(): IncrementalBundler;
-  getCreateModuleId(): (path: string) => number;
-  build(options: BundleOptions): Promise<{
-    code: string;
-    map: string;
-  }>;
-  getRamBundleInfo(options: BundleOptions): Promise<RamBundleInfo>;
-  getAssets(options: BundleOptions): Promise<ReadonlyArray<AssetData>>;
-  getOrderedDependencyPaths(options: {
-    readonly dev: boolean;
-    readonly entryFile: string;
-    readonly minify: boolean;
-    readonly platform: string;
-  }): Promise<string[]>;
-  processRequest(
-    IncomingMessage: IncomingMessage,
-    ServerResponse: ServerResponse,
-    next: (e: Error | null) => unknown,
-  ): void;
-}

package/types/index.d.ts

@@ -1,151 +0,0 @@
-/**
- * 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
- */
-
-export * from './Asset';
-export * from './DeltaBundler/types';
-export * from './ModuleGraph/worker/collectDependencies';
-export * from './Server';
-export * from './lib/reporting';
-
-import type {Server as HttpServer} from 'http';
-import type {Server as HttpsServer} from 'https';
-import type {
-  ConfigT,
-  InputConfigT,
-  loadConfig,
-  MetroConfig,
-  Middleware,
-} from 'metro-config';
-import type {CustomTransformOptions} from 'metro-babel-transformer';
-import type {ReadOnlyGraph} from './DeltaBundler/types';
-import type {Server} from 'ws';
-import Yargs = require('yargs');
-import type {default as MetroServer, ServerOptions} from './Server';
-import type {OutputOptions, RequestOptions} from './shared/types';
-
-export {HttpServer, HttpsServer};
-
-interface MetroMiddleWare {
-  attachHmrServer: (httpServer: HttpServer | HttpsServer) => void;
-  end: () => void;
-  metroServer: MetroServer;
-  middleware: Middleware;
-}
-
-export interface RunMetroOptions extends ServerOptions {
-  waitForBundler?: boolean;
-}
-
-export interface RunServerOptions {
-  hasReducedPerformance?: boolean;
-  host?: string;
-  onError?: (error: Error & {code?: string}) => void;
-  onReady?: (server: HttpServer | HttpsServer) => void;
-  runInspectorProxy?: boolean;
-  secureServerOptions?: Record<string, unknown>;
-
-  /** @deprecated since version 0.61 */
-  secure?: boolean;
-
-  /** @deprecated since version 0.61 */
-  secureCert?: string;
-
-  /** @deprecated since version 0.61 */
-  secureKey?: string;
-
-  waitForBundler?: boolean;
-  watch?: boolean;
-  websocketEndpoints?: {
-    [path: string]: Server;
-  };
-}
-
-export interface RunBuildOptions {
-  entry: string;
-  dev?: boolean;
-  out?: string;
-  onBegin?: () => void;
-  onComplete?: () => void;
-  onProgress?: (transformedFileCount: number, totalFileCount: number) => void;
-  minify?: boolean;
-  output?: {
-    build: (
-      server: MetroServer,
-      options: RequestOptions,
-    ) => Promise<{
-      code: string;
-      map: string;
-    }>;
-    save: (
-      entry: {
-        code: string;
-        map: string;
-      },
-      options: OutputOptions,
-      postSave: (...args: string[]) => void,
-    ) => Promise<unknown>;
-  };
-  platform?: string;
-  sourceMap?: boolean;
-  sourceMapUrl?: string;
-}
-
-interface BuildGraphOptions {
-  entries: ReadonlyArray<string>;
-  customTransformOptions?: CustomTransformOptions;
-  dev?: boolean;
-  minify?: boolean;
-  onProgress?: (transformedFileCount: number, totalFileCount: number) => void;
-  platform?: string;
-  type?: 'module' | 'script';
-}
-
-export {MetroConfig};
-
-export function runMetro(
-  config: InputConfigT,
-  options?: RunMetroOptions,
-): Promise<MetroServer>;
-
-export {loadConfig};
-
-export function createConnectMiddleWare(
-  config: ConfigT,
-  options?: RunMetroOptions,
-): Promise<MetroMiddleWare>;
-
-export function runServer(
-  config: ConfigT,
-  options: RunServerOptions,
-): Promise<HttpServer | HttpsServer>;
-
-export function runBuild(
-  config: ConfigT,
-  options: RunBuildOptions,
-): Promise<void>;
-
-export function buildGraph(
-  config: ConfigT,
-  options: BuildGraphOptions,
-): Promise<ReadOnlyGraph<void>>;
-
-type BuildCommandOptions = Record<string, unknown> | null;
-type ServeCommandOptions = Record<string, unknown> | null;
-
-interface AttachMetroCLIOptions {
-  build?: BuildCommandOptions;
-  serve?: ServeCommandOptions;
-  dependencies?: unknown;
-}
-
-export function attachMetroCli(
-  yargs: typeof Yargs,
-  options?: AttachMetroCLIOptions,
-): typeof Yargs;

package/types/lib/CountingSet.d.ts

@@ -1,48 +0,0 @@
-/**
- * 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
- */
-
-export interface ReadOnlyCountingSet<T> extends Iterable<T> {
-  has(item: T): boolean;
-  [Symbol.iterator](): Iterator<T>;
-  readonly size: number;
-  count(item: T): number;
-  forEach<ThisT>(
-    callbackFn: (
-      this: ThisT,
-      value: T,
-      key: T,
-      set: ReadOnlyCountingSet<T>,
-    ) => unknown,
-    thisArg: ThisT,
-  ): void;
-}
-
-export default class CountingSet<T> implements ReadOnlyCountingSet<T> {
-  constructor(items?: Iterable<T>);
-  get size(): number;
-  has(item: T): boolean;
-  add(item: T): void;
-  delete(item: T): void;
-  keys(): Iterator<T>;
-  values(): Iterator<T>;
-  [Symbol.iterator](): Iterator<T>;
-  count(item: T): number;
-  clear(): void;
-  forEach<ThisT>(
-    callbackFn: (
-      this: ThisT,
-      value: T,
-      key: T,
-      set: ReadOnlyCountingSet<T>,
-    ) => unknown,
-    thisArg: ThisT,
-  ): void;
-  toJSON(): unknown;
-}

package/types/lib/TerminalReporter.d.ts

@@ -1,27 +0,0 @@
-/**
- * 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 {ReportableEvent} from './reporting';
-import {Terminal} from 'metro-core';
-
-export type TerminalReportableEvent =
-  | ReportableEvent
-  | {
-      buildID: string;
-      type: 'bundle_transform_progressed_throttled';
-      transformedFileCount: number;
-      totalFileCount: number;
-    };
-
-export class TerminalReporter {
-  constructor(terminal: Terminal);
-  readonly terminal: Terminal;
-  update(event: TerminalReportableEvent): void;
-}

package/types/lib/contextModule.d.ts

@@ -1,22 +0,0 @@
-/**
- * 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 {ContextMode} from '../ModuleGraph/worker/collectDependencies';
-
-export interface RequireContext {
-  /* Should search for files recursively. Optional, default `true` when `require.context` is used */
-  readonly recursive: boolean;
-  /* Filename filter pattern for use in `require.context`. Optional, default `.*` (any file) when `require.context` is used */
-  readonly filter: RegExp;
-  /** Mode for resolving dynamic dependencies. Defaults to `sync` */
-  readonly mode: ContextMode;
-  /** Absolute path of the directory to search in */
-  readonly from: string;
-}

package/types/lib/reporting.d.ts

@@ -1,140 +0,0 @@
-/**
- * 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 {HealthCheckResult, WatcherStatus} from 'metro-file-map';
-
-export type GlobalCacheDisabledReason = 'too_many_errors' | 'too_many_misses';
-
-export interface BundleDetails {
-  bundleType: string;
-  dev: boolean;
-  entryFile: string;
-  minify: boolean;
-  platform?: string;
-  runtimeBytecodeVersion?: number;
-}
-
-/**
- * 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;
-    }
-  | {
-      buildID: string;
-      type: 'bundle_build_done';
-    }
-  | {
-      buildID: string;
-      type: 'bundle_build_failed';
-    }
-  | {
-      buildID: string;
-      bundleDetails: BundleDetails;
-      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: 'global_cache_error';
-      error: Error;
-    }
-  | {
-      type: 'global_cache_disabled';
-      reason: GlobalCacheDisabledReason;
-    }
-  | {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: unknown[];
-    }
-  | {
-      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 interface Reporter {
-  update: (event: ReportableEvent) => void;
-}