metro-runtime 0.83.3 → 0.83.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metro-runtime",
-  "version": "0.83.3",
+  "version": "0.83.4",
   "description": "🚇 Module required for evaluating Metro bundles.",
   "exports": {
     "./package.json": "./package.json",
@@ -28,9 +28,9 @@
   },
   "devDependencies": {
     "@babel/core": "^7.25.2",
-    "react": "19.1.1",
+    "react": "19.2.3",
     "react-refresh": "^0.14.0",
-    "react-test-renderer": "19.1.1"
+    "react-test-renderer": "19.2.3"
   },
   "engines": {
     "node": ">=20.19.4"

package/src/modules/HMRClient.js.flow

@@ -183,9 +183,9 @@ function mergeUpdates(base: HmrUpdate, next: HmrUpdate): HmrUpdate {
   const result = {
     isInitialUpdate: next.isInitialUpdate,
     revisionId: next.revisionId,
-    added: ([]: Array<HmrModule>),
-    modified: ([]: Array<HmrModule>),
-    deleted: ([]: Array<number>),
+    added: [] as Array<HmrModule>,
+    modified: [] as Array<HmrModule>,
+    deleted: [] as Array<number>,
   };
   deletedIDs.forEach(id => {
     result.deleted.push(id);

package/src/modules/asyncRequire.js.flow

@@ -10,14 +10,14 @@
  */
 
 type MetroRequire = {
-  (number): mixed,
+  (number): unknown,
   importAll: <T>(number) => T,
   ...
 };
 
 declare var require: MetroRequire;
 
-type DependencyMapPaths = ?$ReadOnly<{[moduleID: number | string]: mixed}>;
+type DependencyMapPaths = ?Readonly<{[moduleID: number | string]: unknown}>;
 
 declare var __METRO_GLOBAL_PREFIX__: string;
 
@@ -25,7 +25,7 @@ function maybeLoadBundle(
   moduleID: number,
   paths: DependencyMapPaths,
 ): void | Promise<void> {
-  const loadBundle: (bundlePath: mixed) => Promise<void> =
+  const loadBundle: (bundlePath: unknown) => Promise<void> =
     global[`${__METRO_GLOBAL_PREFIX__}__loadBundleAsync`];
 
   if (loadBundle != null) {

package/src/modules/types.js.flow

@@ -9,7 +9,7 @@
  * @oncall react_native
  */
 
-export type ModuleMap = $ReadOnlyArray<[number, string]>;
+export type ModuleMap = ReadonlyArray<[number, string]>;
 
 export type Bundle = {
   +modules: ModuleMap,
@@ -20,17 +20,17 @@ export type Bundle = {
 export type DeltaBundle = {
   +added: ModuleMap,
   +modified: ModuleMap,
-  +deleted: $ReadOnlyArray<number>,
+  +deleted: ReadonlyArray<number>,
 };
 
 export type BundleVariant =
-  | {+base: true, +revisionId: string, ...Bundle}
-  | {+base: false, +revisionId: string, ...DeltaBundle};
+  | Readonly<{...Bundle, base: true, revisionId: string}>
+  | Readonly<{...DeltaBundle, base: false, revisionId: string}>;
 
 export type BundleMetadata = {
   +pre: number,
   +post: number,
-  +modules: $ReadOnlyArray<[number, number]>,
+  +modules: ReadonlyArray<[number, number]>,
 };
 
 export type FormattedError = {
@@ -46,10 +46,10 @@ export type HmrModule = {
 };
 
 export type HmrUpdate = {
-  +added: $ReadOnlyArray<HmrModule>,
-  +deleted: $ReadOnlyArray<number>,
+  +added: ReadonlyArray<HmrModule>,
+  +deleted: ReadonlyArray<number>,
   +isInitialUpdate: boolean,
-  +modified: $ReadOnlyArray<HmrModule>,
+  +modified: ReadonlyArray<HmrModule>,
   +revisionId: string,
 };
 
@@ -79,7 +79,7 @@ export type HmrClientMessage =
         | 'groupCollapsed'
         | 'groupEnd'
         | 'debug',
-      +data: Array<mixed>,
+      +data: Array<unknown>,
     }
   | {
       +type: 'log-opt-in',

package/src/modules/vendor/eventemitter3.js.flow

@@ -9,7 +9,7 @@
  */
 'use strict';
 
-declare type ListenerFn = (...args: any[]) => mixed;
+declare type ListenerFn = (...args: any[]) => unknown;
 declare class EventEmitter {
   static constructor(): EventEmitter;
   static prefixed: string | boolean;

package/src/polyfills/require.js

@@ -371,6 +371,21 @@ if (__DEV__) {
       }
       throw unknownModuleError(id);
     }
+    const forceFullRefreshPatterns =
+      global[__METRO_GLOBAL_PREFIX__ + "__unstable_forceFullRefreshPatterns"];
+    if (
+      forceFullRefreshPatterns != null &&
+      Array.isArray(forceFullRefreshPatterns) &&
+      mod.verboseName != null &&
+      forceFullRefreshPatterns.some((pattern) =>
+        pattern.test(mod.verboseName ?? ""),
+      )
+    ) {
+      performFullRefresh("Module matched unstable_forceFullRefreshPatterns", {
+        source: mod,
+      });
+      return;
+    }
     if (!mod.hasError && !mod.isInitialized) {
       mod.factory = factory;
       mod.dependencyMap = dependencyMap;

package/src/polyfills/require.js.flow

@@ -23,7 +23,7 @@ declare var __METRO_GLOBAL_PREFIX__: string;
 type ArrayIndexable<T> = interface {
   +[indexer: number]: T,
 };
-type DependencyMap = $ReadOnly<
+type DependencyMap = Readonly<
   ArrayIndexable<ModuleID> & {
     paths?: {[id: ModuleID]: string},
   },
@@ -80,8 +80,8 @@ export type DefineFn = (
 type VerboseModuleNameForDev = string;
 type ModuleDefiner = (moduleId: ModuleID) => void;
 
-global.__r = (metroRequire: RequireFn);
-global[`${__METRO_GLOBAL_PREFIX__}__d`] = (define: DefineFn);
+global.__r = metroRequire as RequireFn;
+global[`${__METRO_GLOBAL_PREFIX__}__d`] = define as DefineFn;
 global.__c = clear;
 global.__registerSegment = registerSegment;
 
@@ -222,7 +222,7 @@ function metroRequire(
 
 // We print require cycles unless they match a pattern in the
 // `requireCycleIgnorePatterns` configuration.
-function shouldPrintRequireCycle(modules: $ReadOnlyArray<?string>): boolean {
+function shouldPrintRequireCycle(modules: ReadonlyArray<?string>): boolean {
   const regExps =
     global[__METRO_GLOBAL_PREFIX__ + '__requireCycleIgnorePatterns'];
   if (!Array.isArray(regExps)) {
@@ -291,7 +291,7 @@ function metroImportAll(
   if (exports && exports.__esModule) {
     importedAll = exports;
   } else {
-    importedAll = ({}: {[string]: any});
+    importedAll = {} as {[string]: any};
 
     // Refrain from using Object.assign, it has to work in ES3 environments.
     if (exports) {
@@ -387,7 +387,7 @@ const definingSegmentByModuleID: Map<ModuleID, number> = new Map();
 function registerSegment(
   segmentId: number,
   moduleDefiner: ModuleDefiner,
-  moduleIds: ?$ReadOnlyArray<ModuleID>,
+  moduleIds: ?ReadonlyArray<ModuleID>,
 ): void {
   moduleDefinersBySegmentID[segmentId] = moduleDefiner;
   if (__DEV__) {
@@ -594,6 +594,28 @@ if (__DEV__) {
       throw unknownModuleError(id);
     }
 
+    // Some modules have known issues with hot reloading where their side effects
+    // (such as style registration) don't properly re-execute in the correct
+    // dependency order. The `unstable_forceFullRefreshPatterns` configuration allows
+    // specifying patterns for modules that should trigger a full refresh
+    // instead of attempting hot reload.
+    const forceFullRefreshPatterns =
+      global[__METRO_GLOBAL_PREFIX__ + '__unstable_forceFullRefreshPatterns'];
+
+    if (
+      forceFullRefreshPatterns != null &&
+      Array.isArray(forceFullRefreshPatterns) &&
+      mod.verboseName != null &&
+      forceFullRefreshPatterns.some(pattern =>
+        pattern.test(mod.verboseName ?? ''),
+      )
+    ) {
+      performFullRefresh('Module matched unstable_forceFullRefreshPatterns', {
+        source: mod,
+      });
+      return;
+    }
+
     if (!mod.hasError && !mod.isInitialized) {
       // The module hasn't actually been executed yet,
       // so we can always safely replace it.
@@ -799,8 +821,8 @@ if (__DEV__) {
     earlyStop: T => boolean,
   ): Array<T> {
     const result = [];
-    const visited = new Set<mixed>();
-    const stack = new Set<mixed>();
+    const visited = new Set<unknown>();
+    const stack = new Set<unknown>();
     function traverseDependentNodes(node: T): void {
       if (stack.has(node)) {
         throw CYCLE_DETECTED;
@@ -902,7 +924,7 @@ if (__DEV__) {
 
   const performFullRefresh = (
     reason: string,
-    modules: $ReadOnly<{
+    modules: Readonly<{
       source?: ModuleDefinition,
       failed?: ModuleDefinition,
     }>,
@@ -996,7 +1018,7 @@ if (__DEV__) {
   var getRefreshBoundarySignature = (
     Refresh: any,
     moduleExports: Exports,
-  ): Array<mixed> => {
+  ): Array<unknown> => {
     const signature = [];
     signature.push(Refresh.getFamilyByType(moduleExports));
     if (moduleExports == null || typeof moduleExports !== 'object') {