@absolutejs/absolute 0.20.0-beta.97 → 0.20.0-beta.99

package/CHANGELOG.md

@@ -6,6 +6,20 @@ This file is generated by `absolute-changelog` from the entries in
 `changelog/`. Edit an entry, not this file — and add new ones under
 `changelog/unreleased/`.
 
+## 0.20.0-beta.99 — 2026-09-15
+
+### Fixed
+
+- **Expo development recovers from Metro startup port races** (`AbsoluteExpoDevPhaseTiming`, `AbsoluteExpoDevSession`, `StartAbsoluteExpoDevOptions`, `startAbsoluteExpoDevSession`)
+  AbsoluteJS retries a newly allocated loopback port without prompting, propagates the final port through local, WSL, and Remote Mac native targets, preserves it across rebuilds, and emits only a categorical reason plus bounded retry count.
+
+## 0.20.0-beta.98 — 2026-09-15
+
+### Added
+
+- **Expo Android development now has a performance and accessibility quality gate** (`DEFAULT_ABSOLUTE_EXPO_ANDROID_QUALITY_BUDGETS`, `parseAbsoluteAndroidAccessibilityHierarchy`, `parseAbsoluteExpoAndroidLaunchTiming`, `parseAbsoluteExpoAndroidMemory`)
+  An installed API 36 gate measures cold and warm launch, bridge and all-framework HMR p95, memory growth, native rebuild/reconnect, and native plus embedded-web accessibility while emitting only sanitized timing artifacts.
+
 ## 0.20.0-beta.97 — 2026-09-15
 
 ### Fixed

package/changelog.json

@@ -2,6 +2,40 @@
 	"contract": 1,
 	"name": "@absolutejs/absolute",
 	"releases": [
+		{
+			"changes": [
+				{
+					"detail": "AbsoluteJS retries a newly allocated loopback port without prompting, propagates the final port through local, WSL, and Remote Mac native targets, preserves it across rebuilds, and emits only a categorical reason plus bounded retry count.",
+					"kind": "fixed",
+					"summary": "Expo development recovers from Metro startup port races",
+					"symbols": [
+						"AbsoluteExpoDevPhaseTiming",
+						"AbsoluteExpoDevSession",
+						"StartAbsoluteExpoDevOptions",
+						"startAbsoluteExpoDevSession"
+					]
+				}
+			],
+			"date": "2026-09-15",
+			"version": "0.20.0-beta.99"
+		},
+		{
+			"changes": [
+				{
+					"detail": "An installed API 36 gate measures cold and warm launch, bridge and all-framework HMR p95, memory growth, native rebuild/reconnect, and native plus embedded-web accessibility while emitting only sanitized timing artifacts.",
+					"kind": "added",
+					"summary": "Expo Android development now has a performance and accessibility quality gate",
+					"symbols": [
+						"DEFAULT_ABSOLUTE_EXPO_ANDROID_QUALITY_BUDGETS",
+						"parseAbsoluteAndroidAccessibilityHierarchy",
+						"parseAbsoluteExpoAndroidLaunchTiming",
+						"parseAbsoluteExpoAndroidMemory"
+					]
+				}
+			],
+			"date": "2026-09-15",
+			"version": "0.20.0-beta.98"
+		},
 		{
 			"changes": [
 				{

package/dist/angular/components/core/streamingSlotRegistrar.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-VPql4f/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-lbMe6j/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");

package/dist/angular/components/core/streamingSlotRegistry.js

@@ -1,7 +1,7 @@
 // @bun
 var __require = import.meta.require;
 
-// .angular-partial-tmp-VPql4f/src/core/streamingSlotRegistrar.ts
+// .angular-partial-tmp-lbMe6j/src/core/streamingSlotRegistrar.ts
 var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
 var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
 var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");
@@ -48,7 +48,7 @@ var warnMissingStreamingSlotCollector = (primitiveName) => {
   getWarningController()?.maybeWarn(primitiveName);
 };
 
-// .angular-partial-tmp-VPql4f/src/core/streamingSlotRegistry.ts
+// .angular-partial-tmp-lbMe6j/src/core/streamingSlotRegistry.ts
 var STREAMING_SLOT_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotAsyncLocalStorage");
 var isObjectRecord2 = (value) => Boolean(value) && typeof value === "object";
 var isAsyncLocalStorage = (value) => isObjectRecord2(value) && ("getStore" in value) && typeof value.getStore === "function" && ("run" in value) && typeof value.run === "function";

package/dist/cli/{dev-r8dztrp8.js → dev-r4vwdz6b.js}

@@ -1287,7 +1287,7 @@ var loadAbsoluteMobileDevModules = async () => {
   ] = await Promise.all([
     import("./config-vy04mqce.js"),
     import("./expoProject-ceey4cfg.js"),
-    import("./expoDevController-a0jk8d43.js"),
+    import("./expoDevController-8wyrcy6a.js"),
     import("./nativeAuth-zx4tsb1f.js"),
     import("./androidEmulatorController-nybhzc6c.js"),
     import("./emulatorDoctor-y2nqmaha.js"),
@@ -2174,13 +2174,15 @@ var dev = async (serverEntry, configPath, options = {}) => {
       platforms: [],
       signal: expoDevAbort.signal,
       log: (message) => printNativeOutput(cliTag("\x1B[35m", `Expo ${message}`)),
-      onPhaseTiming: ({ durationMs, phase }) => {
+      onPhaseTiming: ({ durationMs, phase, reason, retryCount }) => {
         sendTelemetryEvent("mobile:expo-dev-phase", {
           durationMs: Math.round(durationMs),
           host: mobile.detectAbsoluteMobileHost(),
           phase,
           platform: expoTelemetryPlatform(phase),
-          provider: "expo"
+          provider: "expo",
+          reason,
+          retryCount
         });
       },
       onStateChange: (state) => {
@@ -2193,7 +2195,7 @@ var dev = async (serverEntry, configPath, options = {}) => {
       metroSession = session;
       return session;
     });
-    const localNativeStart = metroStart.then(async () => {
+    const localNativeStart = metroStart.then(async (metro) => {
       if (project.platforms.length === 0)
         return;
       const session = await mobile.startAbsoluteExpoDevSession({
@@ -2205,17 +2207,19 @@ var dev = async (serverEntry, configPath, options = {}) => {
         iosDevice: options.iosDevice,
         iosOrigin,
         metro: "external",
-        metroPort: expoMetroPort,
+        metroPort: metro.metroPort,
         platforms: project.platforms,
         signal: expoDevAbort.signal,
         log: (message) => printNativeOutput(cliTag("\x1B[35m", `Expo ${message}`)),
-        onPhaseTiming: ({ durationMs, phase }) => {
+        onPhaseTiming: ({ durationMs, phase, reason, retryCount }) => {
           sendTelemetryEvent("mobile:expo-dev-phase", {
             durationMs: Math.round(durationMs),
             host: mobile.detectAbsoluteMobileHost(),
             phase,
             platform: expoTelemetryPlatform(phase),
-            provider: "expo"
+            provider: "expo",
+            reason,
+            retryCount
           });
         },
         onStateChange: (state) => {
@@ -2229,24 +2233,31 @@ var dev = async (serverEntry, configPath, options = {}) => {
       return session;
     });
     const remoteIosProject = project.remoteIos;
-    const remoteStart = remoteIosProject ? metroStart.then(async () => {
+    const remoteStart = remoteIosProject ? metroStart.then(async (metro) => {
       const session = await mobile.startAbsoluteRemoteExpoIosDevSession({
         certificateAuthorityPath: devCertificateAuthorityPath ?? undefined,
         deviceIdentifier: options.iosDevice,
         https: httpsEnabled,
-        metroPort: expoMetroPort,
+        metroPort: metro.metroPort,
         port,
         project: remoteIosProject,
         serverHost: options.iosDevice ? iosPhysicalServerHost : undefined,
         signal: expoDevAbort.signal,
         log: (message) => printNativeOutput(cliTag("\x1B[35m", `Expo [remote-ios] ${message}`)),
-        onPhaseTiming: ({ durationMs, phase }) => {
+        onPhaseTiming: ({
+          durationMs,
+          phase,
+          reason,
+          retryCount
+        }) => {
           sendTelemetryEvent("mobile:expo-dev-phase", {
             durationMs: Math.round(durationMs),
             host: "remote-macos",
             phase,
             platform: expoTelemetryPlatform(phase),
-            provider: "expo"
+            provider: "expo",
+            reason,
+            retryCount
           });
         },
         onStateChange: (state) => {

package/dist/cli/{expoDevController-a0jk8d43.js → expoDevController-8wyrcy6a.js}

@@ -15,9 +15,39 @@ import"./index-mywsk201.js";
 // src/mobile/expoDevController.ts
 import { spawn } from "child_process";
 import { access } from "fs/promises";
+import { createServer } from "net";
 import { join, resolve as resolvePath } from "path";
 var METRO_READY_TIMEOUT_MS = 120000;
+var METRO_START_MAX_ATTEMPTS = 4;
+var MAX_TCP_PORT = 65535;
 var PROCESS_CLOSE_TIMEOUT_MS = 2000;
+var allocateAvailableMetroPort = () => new Promise((resolve, reject) => {
+  const server = createServer();
+  server.unref();
+  server.once("error", reject);
+  server.listen(0, "127.0.0.1", () => {
+    const address = server.address();
+    if (!address || typeof address === "string") {
+      server.close();
+      reject(new Error("Failed to allocate a replacement Metro port."));
+      return;
+    }
+    server.close((error) => {
+      if (error)
+        reject(error);
+      else
+        resolve(address.port);
+    });
+  });
+});
+var metroPortConflict = (line) => /(?:EADDRINUSE|address already in use|port \d+ is being used by another process)/iu.test(line);
+
+class MetroStartupError extends Error {
+  constructor(exitCode, conflict) {
+    super(`Expo Metro exited with status ${exitCode}.`);
+    this.conflict = conflict;
+  }
+}
 var preserveWindowsSubstRealpaths = `
 const fs = require('node:fs');
 const path = require('node:path');
@@ -512,7 +542,7 @@ var parseBootedAbsoluteExpoIosSimulators = (source) => {
   });
 };
 var startAbsoluteExpoDevSession = async (options) => {
-  const plan = planAbsoluteExpoDevSession(options.config, options);
+  let plan = planAbsoluteExpoDevSession(options.config, options);
   const executable = options.executable ?? await absoluteExpoExecutable(plan.project);
   const run = options.spawnProcess ?? spawn;
   const host = options.host ?? detectAbsoluteMobileHost();
@@ -527,9 +557,9 @@ var startAbsoluteExpoDevSession = async (options) => {
     caEnrollmentServer = null;
     await server?.close();
   };
-  const publishTiming = (phase, durationMs) => {
+  const publishTiming = (phase, durationMs, details = {}) => {
     timings[phase] = (timings[phase] ?? 0) + durationMs;
-    options.onPhaseTiming?.({ durationMs, phase });
+    options.onPhaseTiming?.({ durationMs, phase, ...details });
   };
   const setState = (state) => {
     options.onStateChange?.(state);
@@ -537,8 +567,8 @@ var startAbsoluteExpoDevSession = async (options) => {
   if (options.signal?.aborted)
     throw abortError();
   const prepareCommand = plan.commands.find((command) => command.role === "native-prepare");
-  const metroCommand = plan.commands.find((command) => command.role === "metro");
-  const nativeCommands = plan.commands.filter((command) => command.role === "native-build");
+  let metroCommand = plan.commands.find((command) => command.role === "metro");
+  let nativeCommands = plan.commands.filter((command) => command.role === "native-build");
   const runPrepareCommand = async (command) => {
     setState("preparing-native");
     const prepareStarted = performance.now();
@@ -569,41 +599,67 @@ var startAbsoluteExpoDevSession = async (options) => {
   if (managedMetro)
     setState("starting-metro");
   const metroStarted = performance.now();
-  const metro = metroCommand ? run(executable, metroCommand.args, {
-    cwd: plan.project,
-    env: { ...process.env, ...metroCommand.env },
-    stdio: ["ignore", "pipe", "pipe"]
-  }) : undefined;
-  let metroReady = false;
-  let resolveMetro;
-  const metroPromise = new Promise((resolve, reject) => {
-    if (!metro) {
-      resolve();
-      return;
-    }
+  let metro;
+  let metroRetryCount = 0;
+  const attemptedMetroPorts = [plan.metroPort];
+  const waitForMetroReady = (child) => new Promise((resolve, reject) => {
+    let ready = false;
+    let conflict = false;
     const timeout = setTimeout(() => {
       reject(new Error("Expo Metro did not become ready within 120 seconds."));
     }, METRO_READY_TIMEOUT_MS);
-    resolveMetro = () => {
-      clearTimeout(timeout);
-      resolve();
-    };
-    metro.once("exit", (code) => {
-      if (!metroReady) {
+    forwardLines(child, (line) => {
+      if (line)
+        log(`[metro] ${line}`);
+      if (metroPortConflict(line))
+        conflict = true;
+      if (!ready && /(?:Waiting on|Metro waiting on|Dev server ready)/iu.test(line)) {
+        ready = true;
         clearTimeout(timeout);
-        reject(new Error(`Expo Metro exited with status ${code ?? 1}.`));
+        resolve();
       }
     });
+    child.once("exit", (code) => {
+      if (ready)
+        return;
+      clearTimeout(timeout);
+      reject(new MetroStartupError(code ?? 1, conflict));
+    });
   });
-  if (metro)
-    forwardLines(metro, (line) => {
-      if (line)
-        log(`[metro] ${line}`);
-      if (!metroReady && /(?:Waiting on|Metro waiting on|Dev server ready)/iu.test(line)) {
-        metroReady = true;
-        resolveMetro?.();
-      }
+  const startManagedMetro = async () => {
+    if (!metroCommand)
+      return;
+    if (options.signal?.aborted)
+      throw abortError();
+    metro = run(executable, metroCommand.args, {
+      cwd: plan.project,
+      env: { ...process.env, ...metroCommand.env },
+      stdio: ["ignore", "pipe", "pipe"]
     });
+    try {
+      await waitForMetroReady(metro);
+    } catch (error) {
+      if (!(error instanceof MetroStartupError) || !error.conflict || attemptedMetroPorts.length >= METRO_START_MAX_ATTEMPTS) {
+        throw error;
+      }
+      await stopProcess(metro);
+      const allocate = options.allocateMetroPort ?? allocateAvailableMetroPort;
+      const replacementPort = await allocate(attemptedMetroPorts);
+      if (!Number.isSafeInteger(replacementPort) || replacementPort < 1 || replacementPort > MAX_TCP_PORT || attemptedMetroPorts.includes(replacementPort)) {
+        throw new Error("Could not allocate a distinct replacement Metro port.", { cause: error });
+      }
+      attemptedMetroPorts.push(replacementPort);
+      metroRetryCount += 1;
+      log("Metro port was claimed during startup; retrying automatically on a new port.");
+      plan = planAbsoluteExpoDevSession(options.config, {
+        ...options,
+        metroPort: replacementPort
+      });
+      metroCommand = plan.commands.find((command) => command.role === "metro");
+      nativeCommands = plan.commands.filter((command) => command.role === "native-build");
+      await startManagedMetro();
+    }
+  };
   const abort = () => {
     if (metro)
       stopProcess(metro);
@@ -618,7 +674,7 @@ var startAbsoluteExpoDevSession = async (options) => {
     const state = platform === "android" ? "building-android" : "building-ios";
     setState(state);
     const started = performance.now();
-    const invocation = platform === "android" && host === "wsl" ? encodedWindowsExpoAndroidCommand(plan.project, options.androidRoot ?? absoluteManagedAndroidSdkRoot(host), options.config.appId, command.args, capture, options.metroPort, options.androidDevice) : [executable, ...command.args];
+    const invocation = platform === "android" && host === "wsl" ? encodedWindowsExpoAndroidCommand(plan.project, options.androidRoot ?? absoluteManagedAndroidSdkRoot(host), options.config.appId, command.args, capture, plan.metroPort, options.androidDevice) : [executable, ...command.args];
     if (platform === "android" && host === "wsl") {
       log("[android] Mirroring native inputs to the Windows host for accelerated Expo build and launch.");
     }
@@ -646,7 +702,7 @@ var startAbsoluteExpoDevSession = async (options) => {
     if (platform === "android" && host !== "wsl") {
       const androidRoot = options.androidRoot ?? process.env.ANDROID_HOME ?? process.env.ANDROID_SDK_ROOT ?? absoluteManagedAndroidSdkRoot(host);
       const adb = options.androidAdb ?? join(androidRoot, "platform-tools", host === "windows" ? "adb.exe" : "adb");
-      connectLocalExpoAndroid(adb, options.config.appId, options.metroPort, capture, options.androidDevice);
+      connectLocalExpoAndroid(adb, options.config.appId, plan.metroPort, capture, options.androidDevice);
       log("Connected the Expo Android development client to Metro.");
     }
     if (platform === "ios" && options.certificateAuthorityPath && options.iosOrigin && new URL(options.iosOrigin).protocol === "https:" && !options.iosDevice) {
@@ -684,7 +740,7 @@ var startAbsoluteExpoDevSession = async (options) => {
         "simctl",
         "openurl",
         "booted",
-        expoDevelopmentClientUrl(options.config.appId, options.metroHost ?? "localhost", options.metroPort)
+        expoDevelopmentClientUrl(options.config.appId, options.metroHost ?? "localhost", plan.metroPort)
       ], utilityOptions);
       if (connectExit !== 0)
         throw new Error(`Expo iOS Simulator Metro connection exited with status ${connectExit}.`);
@@ -717,9 +773,14 @@ var startAbsoluteExpoDevSession = async (options) => {
   };
   try {
     await startPhysicalIosEnrollment();
-    await metroPromise;
+    await startManagedMetro();
     if (managedMetro)
-      publishTiming("starting-metro", performance.now() - metroStarted);
+      publishTiming("starting-metro", performance.now() - metroStarted, {
+        ...metroRetryCount > 0 ? {
+          reason: "metro-port-conflict",
+          retryCount: metroRetryCount
+        } : {}
+      });
     await runNativeCommands(nativeCommands);
     setState("ready");
     let closed = false;

package/dist/cli/index.js

@@ -58,7 +58,7 @@ if (command === "dev") {
   }
   const positionalArgs = stripNamedArgs("--config", "--android-device", "--ios-device").filter((arg) => arg !== "--no-mobile" && arg !== "--eager");
   const serverEntry = positionalArgs[0] ?? DEFAULT_SERVER_ENTRY;
-  const { dev } = await import("./dev-r8dztrp8.js");
+  const { dev } = await import("./dev-r4vwdz6b.js");
   await dev(serverEntry, configPath, {
     androidDevice,
     eager: args.includes("--eager"),