@absolutejs/absolute 0.20.0-beta.34 → 0.20.0-beta.36

package/dist/cli/index.js

@@ -458,6 +458,7 @@ var registeredPids, exitHandlerRegistered = false, instanceFilePath = (pid) => j
     frameworks: toStringArray(parsed.frameworks),
     host: typeof parsed.host === "string" ? parsed.host : "localhost",
     https: parsed.https === true,
+    ...typeof parsed.iosRemoteMac === "string" ? { iosRemoteMac: parsed.iosRemoteMac } : {},
     logFile: typeof parsed.logFile === "string" ? parsed.logFile : null,
     name: typeof parsed.name === "string" ? parsed.name : "unknown",
     pid: parsed.pid,
@@ -2634,22 +2635,22 @@ var isRecord2 = (value) => typeof value === "object" && value !== null && !Array
       stdout: ""
     };
   }
-}, ignoredFingerprintDirectories, fingerprintFiles = async (root, current = root) => {
+}, ignoredFingerprintDirectories, fingerprintFiles = async (root, current = root, options = {}) => {
   const entries = await readdir2(current, { withFileTypes: true });
   const nested = await Promise.all(entries.sort((left, right) => left.name.localeCompare(right.name)).map(async (entry) => {
     const path = join9(current, entry.name);
     const projectRelative = relative3(root, path).replaceAll("\\", "/");
-    const ignored = entry.isDirectory() && (ignoredFingerprintDirectories.has(entry.name) || projectRelative === "App/App/public");
+    const ignored = entry.isDirectory() && (ignoredFingerprintDirectories.has(entry.name) || projectRelative === "App/App/public" && options.includePublicBundle !== true);
     if (ignored)
       return [];
     if (entry.isDirectory())
-      return fingerprintFiles(root, path);
+      return fingerprintFiles(root, path, options);
     return entry.isFile() ? [path] : [];
   }));
   return nested.flat();
-}, fingerprintAbsoluteIosNativeProject = async (nativeDirectory) => {
+}, fingerprintAbsoluteIosNativeProject = async (nativeDirectory, options = {}) => {
   const hasher = createHash3("sha256");
-  const files = await fingerprintFiles(nativeDirectory);
+  const files = await fingerprintFiles(nativeDirectory, nativeDirectory, options);
   const contents = await Promise.all(files.map((file) => readFile4(file)));
   files.forEach((file, index) => {
     hasher.update(relative3(nativeDirectory, file).replaceAll("\\", "/"));
@@ -3298,7 +3299,7 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
       return;
     });
   }
-}, fingerprintAbsoluteIosDevProject = async (project) => fingerprintAbsoluteIosNativeProject(project.nativeDirectory), simulatorInventory = (xcrun, capture) => {
+}, fingerprintAbsoluteIosDevProject = async (project, options = {}) => fingerprintAbsoluteIosNativeProject(project.nativeDirectory, options), simulatorInventory = (xcrun, capture) => {
   const result = capture([
     xcrun,
     "simctl",
@@ -3670,10 +3671,13 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
     transition("syncing");
     await requireSuccess2([project.cap, "sync", "ios"], "Capacitor iOS synchronization", run, { cwd: project.projectRoot, signal: options.signal });
     transition("configuring");
-    await writeDevProjection(project, options.port, options.https === true, serverHost);
+    if (options.embeddedBundle !== true)
+      await writeDevProjection(project, options.port, options.https === true, serverHost);
     throwIfAborted2(options.signal);
     const fingerprintStartedAt = performance.now();
-    const fingerprintPromise = fingerprintAbsoluteIosDevProject(project).then((fingerprint2) => {
+    const fingerprintPromise = fingerprintAbsoluteIosDevProject(project, {
+      includePublicBundle: options.embeddedBundle === true
+    }).then((fingerprint2) => {
       timings.fingerprinting = performance.now() - fingerprintStartedAt;
       return fingerprint2;
     });
@@ -3734,7 +3738,7 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
       await requireSuccess2(iosLaunchCommand(project, udid, deviceIdentifier !== undefined), "iOS app launch", run, { signal: options.signal });
     transition("ready");
     timings.total = performance.now() - startedAt;
-    log(`iOS ${targetKind} connected with HMR on port ${options.port} in ${getDurationString(timings.total)} (${nativeCacheHit ? "native cache hit" : "native build installed"}).`);
+    log(options.embeddedBundle === true ? `iOS ${targetKind} connected with the embedded bundle and backend on port ${options.port} in ${getDurationString(timings.total)} (${nativeCacheHit ? "native cache hit" : "native build installed"}).` : `iOS ${targetKind} connected with HMR on port ${options.port} in ${getDurationString(timings.total)} (${nativeCacheHit ? "native cache hit" : "native build installed"}).`);
     log(`iOS startup: ${timingSummary(timings)}.`);
     let closed = false;
     const close = async () => {
@@ -3923,6 +3927,17 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, PROFILE_NAME, SSH_DESTI
   if (result.exitCode !== 0)
     throw new Error(`${label} failed: ${(result.stderr || result.stdout).trim() || `status ${result.exitCode}`}`);
   return result.stdout.trim();
+}, captureAbsoluteRemoteMacCommand = async (profile, command, transport) => {
+  if (command.length === 0)
+    throw new TypeError("A Remote Mac command cannot be empty.");
+  if (command.some((argument) => /[\r\n\0]/u.test(argument)))
+    throw new TypeError("Remote Mac command arguments cannot contain controls.");
+  const capture = transport?.capture ?? defaultTransport.capture;
+  return capture([
+    ...absoluteRemoteMacSshBase(profile),
+    "/bin/sh -lc",
+    shellQuote(command.map((argument) => shellQuote(argument)).join(" "))
+  ]);
 }, getAbsoluteRemoteMacProfile = async (name, profilePath) => {
   const store = await loadStore(profilePath);
   const selected = name ?? process.env.ABSOLUTE_IOS_REMOTE ?? store.defaultProfile;
@@ -18432,6 +18447,44 @@ var init_androidRelease = __esm(() => {
   init_androidEmulatorController();
 });
 
+// src/mobile/iosDeviceAcceptance.ts
+var absoluteIosDeviceAcceptanceCommands = (options) => {
+  const xcrun = options.xcrun ?? "/usr/bin/xcrun";
+  const prefix = [xcrun, "devicectl", "device"];
+  return {
+    apps: [...prefix, "info", "apps", "--device", options.device],
+    details: [...prefix, "info", "details", "--device", options.device],
+    launch: [
+      ...prefix,
+      "process",
+      "launch",
+      "--terminate-existing",
+      "--device",
+      options.device,
+      options.appId
+    ]
+  };
+}, requireSuccess3 = (result, message) => {
+  if (result.exitCode !== 0)
+    throw new Error(message);
+  return result;
+}, testAbsoluteIosPhysicalDevice = async (options) => {
+  const commands = absoluteIosDeviceAcceptanceCommands(options);
+  requireSuccess3(await options.capture(commands.details), "The selected physical iOS device is unavailable. Pair it in Xcode Device Hub, trust this Mac, unlock it, and enable Developer Mode.");
+  const apps = requireSuccess3(await options.capture(commands.apps), "AbsoluteJS could not inspect installed apps on the physical iOS device.");
+  if (!apps.stdout.includes(options.appId))
+    throw new Error("The AbsoluteJS app is not installed on the selected physical iOS device. Start bun dev with the same --ios-device value first.");
+  const now = options.now ?? performance.now.bind(performance);
+  const startedAt = now();
+  requireSuccess3(await options.capture(commands.launch), "AbsoluteJS could not relaunch the app on the physical iOS device.");
+  await options.waitForHmr();
+  return {
+    hmrConnected: true,
+    installed: true,
+    relaunchMs: Math.round(now() - startedAt)
+  };
+};
+
 // src/mobile/iosConformance.ts
 import { readFile as readFile18, stat as stat3 } from "fs/promises";
 var HMR_LINE, parseAbsoluteIosHmrLog = (line) => {
@@ -18502,6 +18555,15 @@ var secretPattern, bearerPattern, coordinatePattern, nativeCredentialPattern, sa
   if (run.hmr)
     hmrResult = run.hmr.outcome === "failed" ? "FAIL" : "PASS";
   const routeDetails = run.routes?.length ? ` Routes: ${run.routes.join(", ")}.` : "";
+  let artifactDetails = "No target screenshot was captured.";
+  let artifactResult = "FAIL";
+  if (run.screenshot) {
+    artifactDetails = "A target screenshot was captured. Visually review it before sharing this directory.";
+    artifactResult = "PASS";
+  } else if (run.targetKind === "device") {
+    artifactDetails = "Physical-device screen capture was intentionally skipped; use Xcode Device Hub for manual visual evidence.";
+    artifactResult = "SKIPPED";
+  }
   const checks = [
     {
       details: `Captured host, toolchain, Bun, and AbsoluteJS metadata for ${target}.`,
@@ -18520,10 +18582,10 @@ var secretPattern, bearerPattern, coordinatePattern, nativeCredentialPattern, sa
       result: hmrResult
     },
     {
-      details: run.screenshot ? "A target screenshot was captured. Visually review it before sharing this directory." : "No target screenshot was captured.",
+      details: artifactDetails,
       ...evidence ? { evidence } : {},
       id: "AUTO-ARTIFACT-01",
-      result: run.screenshot ? "PASS" : "FAIL"
+      result: artifactResult
     }
   ];
   if (run.upgrade) {
@@ -18556,15 +18618,30 @@ var secretPattern, bearerPattern, coordinatePattern, nativeCredentialPattern, sa
       result: Object.values(syncMigration.state).every(Boolean) ? "PASS" : "FAIL"
     });
   }
+  if (run.deviceAcceptance) {
+    checks.push({
+      details: `The installed physical-device app relaunched and reconnected to native HMR in ${run.deviceAcceptance.relaunchMs}ms.`,
+      id: "AUTO-DEVICE-01",
+      result: "PASS"
+    }, {
+      details: run.deviceAcceptance.https ? "The physical app reached the HTTPS development server and established native HMR; this proves the active app session accepted the development trust path." : "Physical-device acceptance did not use HTTPS.",
+      id: "AUTO-DEVICE-HTTPS-01",
+      result: run.deviceAcceptance.https ? "PASS" : "FAIL"
+    }, {
+      details: run.deviceAcceptance.remote ? "The lifecycle commands ran on the paired Remote Mac and HMR returned through the active relay." : "The acceptance run used the local Mac.",
+      id: "AUTO-DEVICE-REMOTE-01",
+      result: run.deviceAcceptance.remote ? "PASS" : "SKIPPED"
+    });
+  }
   return checks;
 }, createAbsoluteNativeTestReport = (options) => ({
   automatedChecks: options.automatedChecks ?? createAbsoluteNativeAutomatedChecks(options.run),
   generatedAt: options.generatedAt ?? new Date().toISOString(),
-  manualChecks: options.manualChecks.map(([id, details]) => ({
+  manualChecks: options.manualChecks.map(([id, details]) => options.manualCheckResults?.[id] ?? {
     details,
     id,
     result: "NOT_RUN"
-  })),
+  }),
   metadata: options.metadata,
   overallResult: options.run.status === "fail" ? "FAIL" : "INCOMPLETE",
   platform: options.run.platform,
@@ -18626,10 +18703,18 @@ var init_nativeTestReport = __esm(() => {
 
 // src/mobile/iosTestReport.ts
 var MANUAL_CHECKS, readPackageVersionForIosReport, sanitizeIosReportText, writeAbsoluteIosPartnerReport, createAbsoluteIosPartnerReport = (options) => {
-  const { udid, ...run } = options.run;
+  const { targetId, targetKind, ...run } = options.run;
+  const physicalResults = targetKind === "device" && run.deviceAcceptance ? {
+    "DEVICEDEV-01": {
+      details: "AbsoluteJS selected a physical target from the running development session without using Simulator.",
+      id: "DEVICEDEV-01",
+      result: "PASS"
+    }
+  } : undefined;
   return createAbsoluteNativeTestReport({
     ...options.generatedAt ? { generatedAt: options.generatedAt } : {},
     manualChecks: MANUAL_CHECKS,
+    ...physicalResults ? { manualCheckResults: physicalResults } : {},
     metadata: {
       absolutejsVersion: options.absolutejsVersion,
       bunVersion: options.bunVersion,
@@ -18640,8 +18725,8 @@ var MANUAL_CHECKS, readPackageVersionForIosReport, sanitizeIosReportText, writeA
     run: {
       ...run,
       platform: "ios",
-      targetId: udid,
-      targetKind: "simulator"
+      targetId,
+      targetKind
     }
   });
 };
@@ -18658,6 +18743,10 @@ var init_iosTestReport = __esm(() => {
     ["SETUP-05", "Confirm generated iOS project signing and Xcode warnings."],
     ["DEV-01", "Record cold and warm bun dev startup timings."],
     ["DEV-02", "Complete route traversal, HMR, relaunch, and recovery checks."],
+    ...Array.from({ length: 10 }, (_, index) => [
+      `DEVICEDEV-${String(index + 1).padStart(2, "0")}`,
+      `Complete physical-device development runbook check DEVICEDEV-${String(index + 1).padStart(2, "0")}.`
+    ]),
     ["CAP-01", "Complete automatic device-capability provisioning checks."],
     ...Array.from({ length: 8 }, (_, index) => [
       `SYSUI-${String(index + 1).padStart(2, "0")}`,
@@ -19835,7 +19924,7 @@ Emulator setup verification:`);
   if (!instance?.logFile)
     throw new TypeError("The selected dev server has no session log. Run `bun dev` normally before requesting --wait-for-hmr.");
   if (!args.includes("--json"))
-    console.log("iOS simulator is ready. Save a source edit now; waiting for a native HMR acknowledgement\u2026");
+    console.log("iOS app is ready. Save a source edit now; waiting for a native HMR acknowledgement\u2026");
   return waitForAbsoluteIosHmrLog({
     logPath: instance.logFile,
     timeoutMs
@@ -19845,7 +19934,7 @@ Emulator setup verification:`);
     console.log(JSON.stringify(report, null, 2));
     return;
   }
-  console.log(`\u2713 iOS simulator ${report.udid}: ${report.appId} launched; screenshot ${report.screenshot}.`);
+  console.log(report.target === "device" ? `\u2713 Physical iOS app ${report.appId} relaunched and reconnected to HMR; no device identifier or screenshot was recorded.` : `\u2713 iOS simulator ${report.targetId}: ${report.appId} launched; screenshot ${report.screenshot}.`);
   if (!report.hmrApply)
     return;
   const timing = report.hmrApply.serverMs === undefined ? "" : ` (server ${report.hmrApply.serverMs}ms, client ${report.hmrApply.clientMs}ms)`;
@@ -19856,6 +19945,41 @@ Emulator setup verification:`);
   if (!xcrun)
     throw new TypeError("iOS simulator tools are unavailable. Run this command on macOS after `absolute mobile doctor ios --fix`.");
   return xcrun;
+}, runningIosDevice = (instance) => {
+  if (!instance)
+    return;
+  const index = instance.command.indexOf("--ios-device");
+  return index === NOT_FOUND3 ? undefined : instance.command[index + 1];
+}, physicalIosCapture = async (options) => {
+  const remoteName = valueAfter(options.args, "--remote");
+  if (remoteName && options.instance.iosRemoteMac && remoteName !== options.instance.iosRemoteMac)
+    throw new TypeError("--remote must match the Remote Mac used by the running bun dev session.");
+  const selectedRemoteName = remoteName ?? options.instance.iosRemoteMac;
+  const remote = process.platform === "darwin" && !selectedRemoteName ? undefined : await getAbsoluteRemoteMacProfile(selectedRemoteName);
+  if (process.platform !== "darwin" && !remote)
+    throw new TypeError("Physical iOS acceptance requires macOS or a paired Remote Mac.");
+  if (remote) {
+    const macos = await captureAbsoluteRemoteMacCommand(remote, [
+      "/usr/bin/sw_vers",
+      "-productVersion"
+    ]);
+    if (macos.exitCode !== 0)
+      throw new Error("Remote Mac version inspection failed.");
+    return {
+      macosVersion: macos.stdout.trim(),
+      remote: true,
+      xcodeVersion: remote.xcodeVersion,
+      xcrun: "/usr/bin/xcrun",
+      capture: (command) => captureAbsoluteRemoteMacCommand(remote, command)
+    };
+  }
+  return {
+    macosVersion: requireCapturedCommand(["/usr/bin/sw_vers", "-productVersion"], "macOS version inspection").stdout.trim(),
+    remote: false,
+    xcodeVersion: requireCapturedCommand(["/usr/bin/xcodebuild", "-version"], "Xcode version inspection").stdout.trim(),
+    xcrun: "/usr/bin/xcrun",
+    capture: async (command) => captureCommand4(command)
+  };
 }, selectIosSimulator = (xcrun, explicitUdid) => {
   const result = captureCommand4([
     xcrun,
@@ -19961,12 +20085,124 @@ Emulator setup verification:`);
   const reportRoot = nativeReportRoot(options.args, options.projectRoot, "ios");
   if (!reportRoot)
     return;
-  const metadata = await iosReportMetadata(options.xcrun);
+  const metadata = options.metadata ?? (options.xcrun ? await iosReportMetadata(options.xcrun) : undefined);
+  if (!metadata)
+    throw new Error("iOS report metadata could not be inspected.");
   const paths = await writeAbsoluteIosPartnerReport(reportRoot, createAbsoluteIosPartnerReport({ ...metadata, run: options.run }));
   const print = options.args.includes("--json") ? console.error : console.log;
   print(`iOS partner report: ${paths.markdownPath}`);
   print(`Return this report directory: ${paths.directory}`);
   return paths;
+}, testPhysicalIos = async (options) => {
+  const {
+    args,
+    device,
+    https,
+    instance,
+    mobile,
+    port,
+    projectRoot,
+    timeoutMs
+  } = options;
+  const transport = await physicalIosCapture({ args, instance });
+  const reportRoot = nativeReportRoot(args, projectRoot, "ios");
+  const startedAt = performance.now();
+  try {
+    const acceptance = await testAbsoluteIosPhysicalDevice({
+      appId: mobile.appId,
+      capture: transport.capture,
+      device,
+      xcrun: transport.xcrun,
+      waitForHmr: () => waitForIosHmrClient({ https, port, timeoutMs })
+    });
+    const hmrApply = await waitForRequestedIosHmr(args, instance, timeoutMs);
+    const report = {
+      appId: mobile.appId,
+      durationMs: Math.round(performance.now() - startedAt),
+      ...hmrApply ? { hmrApply } : {},
+      hmrConnected: true,
+      platform: "ios",
+      port,
+      provider: "capacitor",
+      status: "pass",
+      target: "device",
+      targetId: "physical-device"
+    };
+    sendTelemetryEvent("mobile:ios-device-conformance", {
+      durationMs: report.durationMs,
+      platform: report.platform,
+      provider: report.provider,
+      remote: transport.remote,
+      success: true,
+      waitedForHmr: args.includes("--wait-for-hmr")
+    });
+    printIosTestReport(report, args.includes("--json"));
+    await writeRequestedIosReport({
+      args,
+      metadata: {
+        absolutejsVersion: await absolutejsVersionForReport(),
+        bunVersion: Bun.version,
+        macosVersion: transport.macosVersion,
+        xcodeVersion: transport.xcodeVersion
+      },
+      projectRoot,
+      run: {
+        appId: report.appId,
+        deviceAcceptance: {
+          https: true,
+          relaunchMs: acceptance.relaunchMs,
+          remote: transport.remote
+        },
+        durationMs: report.durationMs,
+        ...hmrApply ? {
+          hmr: {
+            durationMs: hmrApply.duration,
+            outcome: hmrApply.outcome,
+            ...hmrApply.clientMs === undefined ? {} : { clientMs: hmrApply.clientMs },
+            ...hmrApply.serverMs === undefined ? {} : { serverMs: hmrApply.serverMs }
+          }
+        } : {},
+        hmrConnected: true,
+        port,
+        status: "pass",
+        targetId: "physical-device",
+        targetKind: "device"
+      }
+    });
+    return report;
+  } catch (error) {
+    const durationMs = Math.round(performance.now() - startedAt);
+    sendTelemetryEvent("mobile:ios-device-conformance", {
+      durationMs,
+      platform: "ios",
+      provider: "capacitor",
+      remote: transport.remote,
+      success: false,
+      waitedForHmr: args.includes("--wait-for-hmr")
+    });
+    if (reportRoot)
+      await writeRequestedIosReport({
+        args,
+        metadata: {
+          absolutejsVersion: await absolutejsVersionForReport(),
+          bunVersion: Bun.version,
+          macosVersion: transport.macosVersion,
+          xcodeVersion: transport.xcodeVersion
+        },
+        projectRoot,
+        run: {
+          appId: mobile.appId,
+          durationMs,
+          error: sanitizeIosReportText(error instanceof Error ? error.message : String(error)),
+          hmrConnected: false,
+          port,
+          status: "fail",
+          targetId: "physical-device",
+          targetKind: "device"
+        }
+      });
+    throw error;
+  }
 }, testIos = async (args) => {
   const { mobile, projectRoot } = await loadMobile(valueAfter(args, "--config"));
   const { https, instance, port } = requireIosTestContext(args, projectRoot);
@@ -19975,6 +20211,35 @@ Emulator setup verification:`);
   if (args.includes("--route"))
     throw new TypeError("iOS simulator route selection is not exposed through simctl; configure mobile.entry for the native route matrix.");
   const timeoutMs = androidTestTimeout(args);
+  const requestedDevice = valueAfter(args, "--device");
+  if (args.includes("--device") && !requestedDevice)
+    throw new TypeError("mobile test ios --device requires a device identifier or name.");
+  if (requestedDevice && (valueAfter(args, "--udid") || valueAfter(args, "--serial")))
+    throw new TypeError("mobile test ios --device cannot be combined with a simulator selector.");
+  if (!requestedDevice && args.includes("--remote"))
+    throw new TypeError("mobile test ios --remote is available only with --device.");
+  if (requestedDevice) {
+    const device = normalizeAbsoluteIosDeviceIdentifier(requestedDevice);
+    const activeDevice = runningIosDevice(instance);
+    if (!activeDevice)
+      throw new TypeError("The selected dev server is not running a physical iOS session. Start bun dev with --ios-device first.");
+    if (activeDevice !== device)
+      throw new TypeError("--device must match the --ios-device value used by the running bun dev session.");
+    if (!https)
+      throw new TypeError("Physical iOS acceptance requires dev.https: true so the report can prove the native trust path.");
+    if (!instance)
+      throw new TypeError("Physical iOS acceptance requires a registered bun dev session.");
+    return testPhysicalIos({
+      args,
+      device,
+      https,
+      instance,
+      mobile,
+      port,
+      projectRoot,
+      timeoutMs
+    });
+  }
   const xcrun = await requireIosXcrun();
   const simulator = selectIosSimulator(xcrun, valueAfter(args, "--udid") ?? valueAfter(args, "--serial"));
   const reportRoot = nativeReportRoot(args, projectRoot, "ios");
@@ -20012,7 +20277,8 @@ Emulator setup verification:`);
       provider: "capacitor",
       screenshot,
       status: "pass",
-      udid: simulator.udid
+      target: "simulator",
+      targetId: simulator.udid
     };
     sendTelemetryEvent("mobile:ios-conformance", {
       durationMs: report.durationMs,
@@ -20040,7 +20306,8 @@ Emulator setup verification:`);
         port: report.port,
         screenshot: report.screenshot,
         status: report.status,
-        udid: report.udid
+        targetId: report.targetId,
+        targetKind: report.target
       },
       xcrun
     });
@@ -20073,7 +20340,8 @@ Emulator setup verification:`);
         port,
         ...screenshot ? { screenshot } : {},
         status: "fail",
-        udid: simulator.udid
+        targetId: simulator.udid,
+        targetKind: "simulator"
       },
       xcrun
     });
@@ -20133,7 +20401,7 @@ Emulator setup verification:`);
     await publishIos(args.slice(2));
     return;
   }
-  throw new TypeError("Usage: absolute mobile <pair mac <name> <user@host> [--port n] [--workspace path] | remotes [--json] | unpair mac <name> | init [--no-native] [--force] | sync [ios|android] | associations [--outdir dir] [--verify] | doctor [ios|android|release] [--remote name] [--json|--fix [--yes]] | build <android|ios> [server-entry] [--outdir dir] [--web-outdir dir] [--unsigned] | publish android [server-entry] [--registry module] [--channel name] [--play-track track] [--play-status completed|draft|halted|in-progress] [--play-rollout fraction] [--play-name name] [--play-notes language=text] [--play-update-priority 0..5] [--play-hold-review] [--play-cancel-existing-review] [--outdir dir] [--web-outdir dir] [--unsigned] | publish ios [server-entry] [--registry module] [--channel name] [--testflight-group name-or-id] [--testflight-notes locale=text] [--testflight-submit-review] [--outdir dir] [--web-outdir dir] [--unsigned] | test android [--route path] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--serial id] [--artifacts dir] [--json] | test ios [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--udid id] [--artifacts dir] [--json]> [--config path]");
+  throw new TypeError("Usage: absolute mobile <pair mac <name> <user@host> [--port n] [--workspace path] | remotes [--json] | unpair mac <name> | init [--no-native] [--force] | sync [ios|android] | associations [--outdir dir] [--verify] | doctor [ios|android|release] [--remote name] [--json|--fix [--yes]] | build <android|ios> [server-entry] [--outdir dir] [--web-outdir dir] [--unsigned] | publish android [server-entry] [--registry module] [--channel name] [--play-track track] [--play-status completed|draft|halted|in-progress] [--play-rollout fraction] [--play-name name] [--play-notes language=text] [--play-update-priority 0..5] [--play-hold-review] [--play-cancel-existing-review] [--outdir dir] [--web-outdir dir] [--unsigned] | publish ios [server-entry] [--registry module] [--channel name] [--testflight-group name-or-id] [--testflight-notes locale=text] [--testflight-submit-review] [--outdir dir] [--web-outdir dir] [--unsigned] | test android [--route path] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--serial id] [--artifacts dir] [--json] | test ios [--device identifier [--remote name] | --udid id] [--wait-for-hmr] [--report [dir]] [--timeout ms] [--port n] [--artifacts dir] [--json]> [--config path]");
 };
 var init_mobile = __esm(() => {
   init_dependencies();
@@ -20154,6 +20422,7 @@ var init_mobile = __esm(() => {
   init_androidRelease();
   init_iosRelease();
   init_iosSimulatorController();
+  init_iosPhysicalDeviceTransport();
   init_iosConformance();
   init_iosTestReport();
   init_androidTestReport();
@@ -21683,6 +21952,7 @@ var dev = async (serverEntry, configPath2, options = {}) => {
     frameworks: [],
     host: resolvedDev.host,
     https: httpsEnabled,
+    ...selectedRemoteMacProfile ? { iosRemoteMac: selectedRemoteMacProfile.name } : {},
     logFile: instanceLogFile,
     name: resolveProjectName(process.cwd()),
     pid: instancePid,