@absolutejs/absolute 0.20.0-beta.33 → 0.20.0-beta.35

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,
@@ -2844,17 +2845,109 @@ var init_iosRelease = __esm(() => {
   ]);
 });
 
+// src/mobile/iosPhysicalDeviceTransport.ts
+import { randomUUID as randomUUID2, X509Certificate } from "crypto";
+import { createServer as createServer3 } from "http";
+import {
+  connect as connectTcp,
+  createServer as createTcpServer,
+  isIP
+} from "net";
+import { readFile as readFile5 } from "fs/promises";
+var closeServer = (server) => new Promise((resolve7, reject) => {
+  server.close((error) => {
+    if (error)
+      reject(error);
+    else
+      resolve7();
+  });
+}), listen = (server, port) => new Promise((resolve7, reject) => {
+  server.once("error", reject);
+  server.listen(port, "0.0.0.0", () => {
+    server.off("error", reject);
+    const address = server.address();
+    if (!address || typeof address === "string") {
+      reject(new Error("Could not determine the iOS device helper port."));
+      return;
+    }
+    resolve7(address.port);
+  });
+}), findEphemeralPort = async () => {
+  const probe = createTcpServer();
+  const port = await new Promise((resolve7, reject) => {
+    probe.once("error", reject);
+    probe.listen(0, "127.0.0.1", () => {
+      const address = probe.address();
+      if (!address || typeof address === "string") {
+        reject(new Error("Could not allocate the iOS CA enrollment port."));
+        return;
+      }
+      resolve7(address.port);
+    });
+  });
+  await closeServer(probe);
+  return port;
+}, normalizeAbsoluteIosDeviceHost = (value) => {
+  const normalized = value.trim();
+  if (!normalized || normalized.length > 253 || /[\0\s/?#]/u.test(normalized))
+    throw new TypeError("Physical iOS development requires a valid LAN host.");
+  return normalized;
+}, normalizeAbsoluteIosDeviceIdentifier = (value) => {
+  const normalized = value.trim();
+  if (!normalized || normalized.length > 256 || /[\0\r\n]/u.test(normalized))
+    throw new TypeError("--ios-device requires a valid Xcode device identifier or name.");
+  return normalized;
+}, urlForHost = (protocol, host, port) => {
+  const url = new URL(`${protocol}://localhost:${port}`);
+  const normalizedHost = normalizeAbsoluteIosDeviceHost(host);
+  url.hostname = isIP(normalizedHost) === 6 ? `[${normalizedHost}]` : normalizedHost;
+  return url;
+}, startAbsoluteIosCaEnrollmentServer = async (options) => {
+  const certificate = new X509Certificate(await readFile5(options.certificateAuthorityPath));
+  const certificateBytes = certificate.raw;
+  const token = randomUUID2().replaceAll("-", "");
+  const certificatePath = `/${token}/absolutejs-development-ca.cer`;
+  const server = createServer3((request, response) => {
+    if (request.method !== "GET" || request.url !== certificatePath) {
+      response.writeHead(404, {
+        "Cache-Control": "no-store",
+        "Content-Type": "text/plain; charset=utf-8"
+      });
+      response.end("Not found.");
+      return;
+    }
+    response.writeHead(200, {
+      "Cache-Control": "no-store",
+      "Content-Disposition": 'attachment; filename="absolutejs-development-ca.cer"',
+      "Content-Length": String(certificateBytes.byteLength),
+      "Content-Type": "application/x-x509-ca-cert",
+      "X-Content-Type-Options": "nosniff"
+    });
+    response.end(certificateBytes);
+  });
+  const port = await findEphemeralPort();
+  await listen(server, port);
+  const url = urlForHost("http", options.displayHost, port);
+  url.pathname = certificatePath;
+  return {
+    url: url.href,
+    close: () => closeServer(server)
+  };
+};
+var init_iosPhysicalDeviceTransport = () => {};
+
 // src/mobile/iosSimulatorController.ts
-import { createHash as createHash4, randomUUID as randomUUID2 } from "crypto";
+import { createHash as createHash4, randomUUID as randomUUID3 } from "crypto";
 import {
   access as access5,
   copyFile as copyFile3,
   mkdir as mkdir4,
-  readFile as readFile5,
+  readFile as readFile6,
   rename as rename4,
   rm as rm4,
   writeFile as writeFile4
 } from "fs/promises";
+import { isIP as isIP2 } from "net";
 import { dirname as dirname5, isAbsolute as isAbsolute3, join as join10, relative as relative4, resolve as resolve7, sep as sep3 } from "path";
 var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000, BOOT_POLL_MS = 1000, DEV_JOURNAL_FORMAT2 = 1, NATIVE_CACHE_FORMAT2 = 1, isRecord3 = (value) => typeof value === "object" && value !== null && !Array.isArray(value), pathExists4 = async (path) => {
   try {
@@ -2965,7 +3058,24 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
     options.certificateAuthorityPath
   ], "iOS Simulator development CA trust", run, { signal: options.signal });
   log("Installed the AbsoluteJS development CA into this iOS Simulator trust store.");
-}, requireCapturedSuccess = (result, label) => {
+}, iosLaunchCommand = (project, udid, physical) => physical ? [
+  project.xcrun,
+  "devicectl",
+  "device",
+  "process",
+  "launch",
+  "--terminate-existing",
+  "--device",
+  udid,
+  project.config.appId
+] : [
+  project.xcrun,
+  "simctl",
+  "launch",
+  "--terminate-running-process",
+  udid,
+  project.config.appId
+], requireCapturedSuccess = (result, label) => {
   if (result.exitCode !== 0) {
     throw new Error(`${label} failed: ${result.stderr.trim() || result.stdout.trim() || `status ${result.exitCode}`}`);
   }
@@ -3088,7 +3198,7 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
     await rm4(paths.root, { force: true, recursive: true });
     return false;
   }
-  const journal = await readFile5(paths.journal, "utf8").then((source) => parseJournal2(JSON.parse(source))).catch(() => null);
+  const journal = await readFile6(paths.journal, "utf8").then((source) => parseJournal2(JSON.parse(source))).catch(() => null);
   if (!journal || !isInside2(projectRoot, journal.nativeConfigPath) || !isInside2(projectRoot, journal.infoPath) || !isInside2(paths.root, journal.configBackupPath) || !isInside2(paths.root, journal.infoBackupPath)) {
     throw new Error(`Refusing unsafe or invalid iOS dev journal at ${paths.journal}.`);
   }
@@ -3117,14 +3227,14 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
 		<key>NSAllowsArbitraryLoads</key>
 		<true/>
 	</dict>`);
-}, writeDevProjection = async (project, port, https) => {
+}, writeDevProjection = async (project, port, https, serverHost = "localhost") => {
   const paths = journalPaths2(project.projectRoot);
   await repairAbsoluteIosDevSession(project.projectRoot);
   const nativeConfigPath = join10(project.nativeDirectory, "App", "App", "capacitor.config.json");
   const infoPath = join10(project.nativeDirectory, "App", "App", "Info.plist");
   const [configSource, infoSource] = await Promise.all([
-    readFile5(nativeConfigPath, "utf8"),
-    readFile5(infoPath, "utf8")
+    readFile6(nativeConfigPath, "utf8"),
+    readFile6(infoPath, "utf8")
   ]);
   const parsed = JSON.parse(configSource);
   if (!isRecord3(parsed))
@@ -3146,6 +3256,7 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
     flag: "wx"
   });
   const developmentUrl = new URL(`${https ? "https" : "http"}://localhost:${port}${project.config.entry}`);
+  developmentUrl.hostname = isIP2(serverHost) === 6 ? `[${serverHost}]` : serverHost;
   developmentUrl.searchParams.set("__absolute_target", "capacitor-ios");
   const existingServer = parsed.server;
   parsed.server = {
@@ -3173,9 +3284,9 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
       String(identity)
     ]))
   };
-}, readNativeCache2 = (projectRoot) => readFile5(nativeCachePath2(projectRoot), "utf8").then((source) => parseNativeCache2(JSON.parse(source))).catch(() => null), writeNativeCache2 = async (projectRoot, cache) => {
+}, readNativeCache2 = (projectRoot) => readFile6(nativeCachePath2(projectRoot), "utf8").then((source) => parseNativeCache2(JSON.parse(source))).catch(() => null), writeNativeCache2 = async (projectRoot, cache) => {
   const destination = nativeCachePath2(projectRoot);
-  const temporary = `${destination}.${process.pid}.${randomUUID2()}.tmp`;
+  const temporary = `${destination}.${process.pid}.${randomUUID3()}.tmp`;
   await mkdir4(dirname5(destination), { recursive: true });
   try {
     await writeFile4(temporary, `${JSON.stringify(cache, null, "\t")}
@@ -3257,6 +3368,29 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
     "app"
   ]);
   return result.exitCode === 0 && result.stdout.trim() ? result.stdout.trim() : undefined;
+}, validatePhysicalIosDevice = (project, identifier, capture) => {
+  const result = capture([
+    project.xcrun,
+    "devicectl",
+    "device",
+    "info",
+    "details",
+    "--device",
+    identifier
+  ]);
+  if (result.exitCode !== 0)
+    throw new Error(`Physical iOS device ${JSON.stringify(identifier)} is unavailable: ${result.stderr.trim() || result.stdout.trim() || "pair it in Xcode Device Hub, trust this Mac, unlock it, and enable Developer Mode."}`);
+}, physicalIosAppIsInstalled = (project, identifier, capture) => {
+  const result = capture([
+    project.xcrun,
+    "devicectl",
+    "device",
+    "info",
+    "apps",
+    "--device",
+    identifier
+  ]);
+  return result.exitCode === 0 && result.stdout.includes(project.config.appId);
 }, buildIosDebugApp = async (project, udid, fingerprint, run, signal) => {
   const derivedDataPath = join10(project.projectRoot, ".absolutejs", "mobile", "ios-derived-data", createHash4("sha256").update(project.config.appId).digest("hex").slice(0, 16));
   await mkdir4(derivedDataPath, { recursive: true });
@@ -3278,6 +3412,59 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
   if (!await pathExists4(appPath))
     throw new Error(`Xcode did not produce the simulator app at ${appPath}.`);
   return appPath;
+}, buildPhysicalIosDebugApp = async (project, identifier, run, signal) => {
+  const derivedDataPath = join10(project.projectRoot, ".absolutejs", "mobile", "ios-derived-data", createHash4("sha256").update(project.config.appId).digest("hex").slice(0, 16));
+  await mkdir4(derivedDataPath, { recursive: true });
+  await requireSuccess2([
+    project.xcodebuild,
+    "-workspace",
+    join10(project.nativeDirectory, "App", "App.xcworkspace"),
+    "-scheme",
+    "App",
+    "-configuration",
+    "Debug",
+    "-destination",
+    `platform=iOS,id=${identifier}`,
+    "-derivedDataPath",
+    derivedDataPath,
+    "-allowProvisioningUpdates",
+    "build"
+  ], "iOS physical-device build (configure automatic signing and a Development Team in Xcode if this is the first run)", run, { cwd: project.nativeDirectory, signal });
+  const appPath = join10(derivedDataPath, "Build", "Products", "Debug-iphoneos", "App.app");
+  if (!await pathExists4(appPath))
+    throw new Error(`Xcode did not produce the physical-device app at ${appPath}.`);
+  return appPath;
+}, ensurePhysicalIosDebugApp = async (options) => {
+  const cacheHit = options.cache?.appId === options.project.config.appId && options.cache.fingerprint === options.fingerprint && options.cache.installations[options.identifier] === options.fingerprint && physicalIosAppIsInstalled(options.project, options.identifier, options.capture);
+  if (cacheHit) {
+    options.log(`iOS native app is unchanged on the selected physical device; skipped Xcode build and install.`);
+    return true;
+  }
+  options.log("iOS native inputs changed or the physical-device install is stale; rebuilding.");
+  options.transition("building");
+  const appPath = await buildPhysicalIosDebugApp(options.project, options.identifier, options.run, options.signal);
+  throwIfAborted2(options.signal);
+  options.transition("installing");
+  await requireSuccess2([
+    options.project.xcrun,
+    "devicectl",
+    "device",
+    "install",
+    "app",
+    "--device",
+    options.identifier,
+    appPath
+  ], "iOS physical-device app installation", options.run, { signal: options.signal });
+  await writeNativeCache2(options.project.projectRoot, {
+    appId: options.project.config.appId,
+    fingerprint: options.fingerprint,
+    format: NATIVE_CACHE_FORMAT2,
+    installations: {
+      ...options.cache?.appId === options.project.config.appId ? options.cache.installations : {},
+      [options.identifier]: options.fingerprint
+    }
+  }).catch((error) => options.log(`iOS native cache could not be saved: ${error instanceof Error ? error.message : String(error)}`));
+  return false;
 }, ensureIosDebugApp = async (options) => {
   const installed = installedAppIdentity(options.project, options.udid, options.capture);
   const cacheHit = options.cache?.appId === options.project.config.appId && options.cache.fingerprint === options.fingerprint && installed !== undefined && options.cache.installations[options.udid] === installed;
@@ -3317,7 +3504,18 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
   if (!options.nativeLog)
     return null;
   const start = options.startNativeLogs ?? defaultStartNativeLogs;
-  return start([
+  const command = options.deviceIdentifier ? [
+    project.xcrun,
+    "devicectl",
+    "device",
+    "process",
+    "launch",
+    "--console",
+    "--terminate-existing",
+    "--device",
+    udid,
+    project.config.appId
+  ] : [
     project.xcrun,
     "simctl",
     "spawn",
@@ -3330,7 +3528,8 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
     "debug",
     "--predicate",
     'process == "App"'
-  ], { signal: options.signal }, (line) => {
+  ];
+  return start(command, { signal: options.signal }, (line) => {
     const entry = parseAbsoluteIosLogLine(line);
     if (entry)
       options.nativeLog?.(entry);
@@ -3340,12 +3539,13 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
   return duration === undefined ? null : `${label} ${getDurationString(duration)}`;
 }).filter((value) => value !== null).join(", "), prepareAbsoluteIosDevProject = async (config, options) => {
   if (detectAbsoluteMobileHost() !== "macos")
-    throw new Error("iOS simulation requires macOS and Xcode.");
+    throw new Error("iOS development requires macOS and Xcode.");
+  const target = options.target ?? "simulator";
   const projectRoot = resolve7(options.projectRoot);
   const checks = await inspectAbsoluteMobileToolchain({ host: "macos" });
-  const failed = checks.filter((check) => check.platform === "ios" && (check.status === "fail" || check.status === "warn"));
+  const failed = checks.filter((check) => check.platform === "ios" && !(target === "device" && check.id === "ios.runtime") && (check.status === "fail" || check.status === "warn"));
   if (failed.length > 0)
-    throw new Error(`iOS simulation is not ready: ${failed.map(({ label }) => label).join(", ")}.`);
+    throw new Error(`iOS ${target} development is not ready: ${failed.map(({ label }) => label).join(", ")}.`);
   const xcrun = checks.find((check) => check.id === "ios.xcrun")?.path;
   const xcodebuild = checks.find((check) => check.id === "ios.xcodebuild")?.path;
   if (!xcrun || !xcodebuild)
@@ -3375,8 +3575,53 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
     xcodebuild,
     xcrun
   };
+}, preparePhysicalIosTarget = async (options) => {
+  options.transition("connecting");
+  validatePhysicalIosDevice(options.project, options.deviceIdentifier, options.capture);
+  if (!options.startOptions.https)
+    return {
+      caEnrollmentServer: null,
+      startedSimulator: false,
+      udid: options.deviceIdentifier
+    };
+  if (!options.startOptions.certificateAuthorityPath)
+    throw new Error("Physical iOS HTTPS development requires the AbsoluteJS development CA certificate.");
+  options.transition("enrolling-trust");
+  const startEnrollment = options.startOptions.startCaEnrollmentServer ?? startAbsoluteIosCaEnrollmentServer;
+  const caEnrollmentServer = await startEnrollment({
+    certificateAuthorityPath: options.startOptions.certificateAuthorityPath,
+    displayHost: options.serverHost
+  });
+  options.log(`On the iOS device, open ${caEnrollmentServer.url}, install the AbsoluteJS development CA profile, then enable it under Settings > General > About > Certificate Trust Settings. This public CA endpoint exists only for this dev session.`);
+  return {
+    caEnrollmentServer,
+    startedSimulator: false,
+    udid: options.deviceIdentifier
+  };
+}, prepareIosSimulatorTarget = async (options) => {
+  options.transition("booting");
+  const managed = await ensureManagedSimulator(options.project, options.capture);
+  const { device } = managed;
+  const startedSimulator = managed.created || device.state !== "Booted";
+  bootSimulator(options.project, device, options.capture);
+  options.spawn([
+    "open",
+    "-a",
+    "Simulator",
+    "--args",
+    "-CurrentDeviceUDID",
+    device.udid
+  ]);
+  options.transition("connecting");
+  await waitForBootedSimulator(options.project, device.udid, options.capture, options.sleep, options.startOptions.signal);
+  await requireSuccess2([options.project.xcrun, "simctl", "bootstatus", device.udid, "-b"], "iOS simulator boot readiness", options.run, { signal: options.startOptions.signal });
+  await trustIosSimulatorDevelopmentCa(options.startOptions, device.udid, options.run, options.log);
+  return { caEnrollmentServer: null, startedSimulator, udid: device.udid };
 }, startAbsoluteIosDevSession = async (options) => {
   const { project } = options;
+  const deviceIdentifier = options.deviceIdentifier ? normalizeAbsoluteIosDeviceIdentifier(options.deviceIdentifier) : undefined;
+  const targetKind = deviceIdentifier ? "device" : "simulator";
+  const serverHost = deviceIdentifier ? normalizeAbsoluteIosDeviceHost(options.serverHost ?? "") : "localhost";
   const capture = options.capture ?? defaultCapture3;
   const run = options.run ?? defaultRun3;
   const sleep = options.sleep ?? Bun.sleep;
@@ -3404,6 +3649,7 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
     options.onStateChange?.(next);
   };
   let nativeLogs = null;
+  let caEnrollmentServer = null;
   const closeLogs = async () => {
     const stream = nativeLogs;
     nativeLogs = null;
@@ -3411,39 +3657,66 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
       return;
     });
   };
+  const relaunchTarget = async (udid) => {
+    if (deviceIdentifier && options.nativeLog) {
+      await closeLogs();
+      nativeLogs = attachNativeLogs(project, udid, options);
+      return;
+    }
+    await requireSuccess2(iosLaunchCommand(project, udid, deviceIdentifier !== undefined), "iOS app relaunch", run, { signal: options.signal });
+  };
   try {
     await repairAbsoluteIosDevSession(project.projectRoot);
     throwIfAborted2(options.signal);
     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);
+    await writeDevProjection(project, options.port, options.https === true, serverHost);
     throwIfAborted2(options.signal);
     const fingerprintStartedAt = performance.now();
     const fingerprintPromise = fingerprintAbsoluteIosDevProject(project).then((fingerprint2) => {
       timings.fingerprinting = performance.now() - fingerprintStartedAt;
       return fingerprint2;
     });
-    transition("booting");
-    const { created, device } = await ensureManagedSimulator(project, capture);
-    const startedSimulator = created || device.state !== "Booted";
-    bootSimulator(project, device, capture);
-    spawn([
-      "open",
-      "-a",
-      "Simulator",
-      "--args",
-      "-CurrentDeviceUDID",
-      device.udid
-    ]);
-    transition("connecting");
-    await waitForBootedSimulator(project, device.udid, capture, sleep, options.signal);
-    await requireSuccess2([project.xcrun, "simctl", "bootstatus", device.udid, "-b"], "iOS simulator boot readiness", run, { signal: options.signal });
-    await trustIosSimulatorDevelopmentCa(options, device.udid, run, log);
+    const target = deviceIdentifier ? await preparePhysicalIosTarget({
+      capture,
+      deviceIdentifier,
+      log,
+      project,
+      serverHost,
+      startOptions: options,
+      transition
+    }) : await prepareIosSimulatorTarget({
+      capture,
+      log,
+      project,
+      run,
+      sleep,
+      spawn,
+      startOptions: options,
+      transition
+    });
+    const {
+      caEnrollmentServer: targetCaEnrollmentServer,
+      startedSimulator,
+      udid
+    } = target;
+    caEnrollmentServer = targetCaEnrollmentServer;
     const fingerprint = await fingerprintPromise;
     transition("checking-native");
-    const nativeCacheHit = await ensureIosDebugApp({
-      cache: await readNativeCache2(project.projectRoot),
+    const cache = await readNativeCache2(project.projectRoot);
+    const nativeCacheHit = deviceIdentifier ? await ensurePhysicalIosDebugApp({
+      cache,
+      capture,
+      fingerprint,
+      identifier: deviceIdentifier,
+      log,
+      project,
+      run,
+      signal: options.signal,
+      transition
+    }) : await ensureIosDebugApp({
+      cache,
       capture,
       fingerprint,
       log,
@@ -3451,24 +3724,18 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
       run,
       signal: options.signal,
       transition,
-      udid: device.udid
+      udid
     });
     throwIfAborted2(options.signal);
     if (options.nativeLog)
       transition("streaming-logs");
-    nativeLogs = attachNativeLogs(project, device.udid, options);
+    nativeLogs = attachNativeLogs(project, udid, options);
     transition("launching");
-    await requireSuccess2([
-      project.xcrun,
-      "simctl",
-      "launch",
-      "--terminate-running-process",
-      device.udid,
-      project.config.appId
-    ], "iOS app launch", run, { signal: options.signal });
+    if (!deviceIdentifier || !nativeLogs)
+      await requireSuccess2(iosLaunchCommand(project, udid, deviceIdentifier !== undefined), "iOS app launch", run, { signal: options.signal });
     transition("ready");
     timings.total = performance.now() - startedAt;
-    log(`iOS simulator connected (${device.udid}) with HMR on port ${options.port} in ${getDurationString(timings.total)} (${nativeCacheHit ? "native cache hit" : "native build installed"}).`);
+    log(`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 () => {
@@ -3477,6 +3744,10 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
       closed = true;
       transition("closing");
       await closeLogs();
+      await caEnrollmentServer?.close().catch(() => {
+        return;
+      });
+      caEnrollmentServer = null;
       await repairAbsoluteIosDevSession(project.projectRoot);
       transition("closed");
     };
@@ -3484,8 +3755,9 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
       close,
       nativeCacheHit,
       startedSimulator,
+      targetKind,
       timings: { ...timings },
-      udid: device.udid,
+      udid,
       rebuild: async () => {
         if (closed)
           throw new Error("iOS development session is closed.");
@@ -3498,22 +3770,17 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
           throw new Error("iOS development session is closed.");
         transition("launching");
         try {
-          await requireSuccess2([
-            project.xcrun,
-            "simctl",
-            "launch",
-            "--terminate-running-process",
-            device.udid,
-            project.config.appId
-          ], "iOS app relaunch", run, { signal: options.signal });
+          await relaunchTarget(udid);
           transition("ready");
-          log(`iOS app relaunched on ${device.udid}.`);
+          log(`iOS app relaunched on the selected ${targetKind}.`);
         } catch (error) {
           transition("failed");
           throw error;
         }
       },
       screenshot: async (destination) => {
+        if (deviceIdentifier)
+          throw new Error("Physical iOS screenshots are captured in Xcode Device Hub; the CLI never records a device screen automatically.");
         const resolved = resolve7(project.projectRoot, destination);
         if (!isInside2(project.projectRoot, resolved))
           throw new Error("iOS screenshot destination must remain inside the project.");
@@ -3522,7 +3789,7 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
           project.xcrun,
           "simctl",
           "io",
-          device.udid,
+          udid,
           "screenshot",
           resolved
         ], "iOS simulator screenshot", run, { signal: options.signal });
@@ -3535,6 +3802,9 @@ var ABSOLUTE_IOS_SIMULATOR_NAME = "AbsoluteJS iPhone", BOOT_TIMEOUT_MS = 180000,
   } catch (error) {
     transition("failed");
     await closeLogs();
+    await caEnrollmentServer?.close().catch(() => {
+      return;
+    });
     await repairAbsoluteIosDevSession(project.projectRoot);
     throw error;
   }
@@ -3543,6 +3813,7 @@ var init_iosSimulatorController = __esm(() => {
   init_emulatorDoctor();
   init_capacitorProject();
   init_iosRelease();
+  init_iosPhysicalDeviceTransport();
   init_getDurationString();
   SECRET_VALUE = /((?:authorization|cookie|password|secret|token|oauth[_-]?code)\s*[:=]\s*)([^\s,;]+)/giu;
   BEARER_VALUE = new RegExp(String.raw`\bBearer\s+[A-Za-z0-9._~+/-]+=*`, "giu");
@@ -3554,6 +3825,7 @@ var init_iosSimulatorController = __esm(() => {
     ["fingerprinting", "fingerprint"],
     ["booting", "simulator"],
     ["connecting", "device ready"],
+    ["enrolling-trust", "HTTPS trust"],
     ["checking-native", "app check"],
     ["building", "Xcode"],
     ["installing", "install"],
@@ -3566,9 +3838,10 @@ var init_iosSimulatorController = __esm(() => {
 var ABSOLUTE_REMOTE_MAC_EVENT_PREFIX = "ABSOLUTE_REMOTE_MAC\t", ABSOLUTE_REMOTE_MAC_PROTOCOL_VERSION = 1;
 
 // src/mobile/remoteMacProtocol.ts
-import { createHash as createHash5, randomUUID as randomUUID3 } from "crypto";
-import { chmod, mkdir as mkdir5, readFile as readFile6, rename as rename5, writeFile as writeFile5 } from "fs/promises";
+import { createHash as createHash5, randomUUID as randomUUID4 } from "crypto";
+import { chmod, mkdir as mkdir5, readFile as readFile7, rename as rename5, writeFile as writeFile5 } from "fs/promises";
 import { homedir as homedir4 } from "os";
+import { isIP as isIP3 } from "net";
 import {
   dirname as dirname6,
   isAbsolute as isAbsolute4,
@@ -3583,7 +3856,7 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, PROFILE_NAME, SSH_DESTI
   profiles: {}
 }), loadStore = async (path = defaultProfilePath()) => {
   try {
-    const parsed = JSON.parse(await readFile6(path, "utf8"));
+    const parsed = JSON.parse(await readFile7(path, "utf8"));
     if (parsed.format !== PROFILE_FORMAT || typeof parsed.profiles !== "object" || parsed.profiles === null || Array.isArray(parsed.profiles))
       throw new Error("Unsupported remote Mac profile format.");
     for (const [key, profile] of Object.entries(parsed.profiles)) {
@@ -3600,7 +3873,7 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, PROFILE_NAME, SSH_DESTI
   }
 }, saveStore = async (store, path = defaultProfilePath()) => {
   await mkdir5(dirname6(path), { recursive: true });
-  const temporary = `${path}.${randomUUID3()}.tmp`;
+  const temporary = `${path}.${randomUUID4()}.tmp`;
   await writeFile5(temporary, `${JSON.stringify(store, null, 2)}
 `, {
     mode: 384
@@ -3651,6 +3924,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;
@@ -3682,6 +3966,18 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, PROFILE_NAME, SSH_DESTI
   if (!xcodeVersion?.startsWith("Xcode "))
     throw new Error("The remote Mac must have full Xcode installed and selected.");
   return { bunPath, home, os: operatingSystem, xcodeVersion };
+}, inspectAbsoluteRemoteMacLanHost = async (profile, transport) => {
+  const capture = transport?.capture ?? defaultTransport.capture;
+  const script = `default_interface="$(/sbin/route -n get default 2>/dev/null | /usr/bin/awk '/interface:/{print $2; exit}')"; for interface in "$default_interface" en0 en1; do [ -n "$interface" ] || continue; address="$(/usr/sbin/ipconfig getifaddr "$interface" 2>/dev/null || true)"; if [ -n "$address" ]; then printf '%s\\n' "$address"; exit 0; fi; done; exit 1`;
+  const result = await capture([
+    ...absoluteRemoteMacSshBase(profile),
+    "/bin/sh -lc",
+    shellQuote(script)
+  ]);
+  const host = requireRemoteSuccess(result, "Remote Mac LAN address discovery").trim();
+  if (isIP3(host) === 0)
+    throw new Error("The Remote Mac did not report a device-reachable LAN address.");
+  return host;
 }, listAbsoluteRemoteMacProfiles = async (profilePath) => {
   const store = await loadStore(profilePath);
   return {
@@ -3748,7 +4044,7 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, PROFILE_NAME, SSH_DESTI
   ]);
   if (verified.exitCode === 0)
     return { ...artifact, remotePath, uploaded: false };
-  const temporary = posix.join(directory, `.agent-${randomUUID3()}.tmp`);
+  const temporary = posix.join(directory, `.agent-${randomUUID4()}.tmp`);
   const installScript = [
     "set -eu",
     "umask 077",
@@ -3835,7 +4131,7 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, PROFILE_NAME, SSH_DESTI
 }), absoluteRemoteProjectSyncCommands = (project) => {
   const current = project.remoteProjectRoot;
   const parent = posix.dirname(current);
-  const staging = posix.join(parent, `.incoming-${randomUUID3()}`);
+  const staging = posix.join(parent, `.incoming-${randomUUID4()}`);
   const previous = posix.join(parent, ".previous");
   const script = [
     "set -eu",
@@ -3924,7 +4220,13 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, PROFILE_NAME, SSH_DESTI
   await syncProject(options.project);
   const syncDuration = performance.now() - syncStartedAt;
   const encodedConfig = Buffer.from(JSON.stringify(portableMobileConfig(options.project))).toString("base64url");
-  const encodedCertificateAuthority = options.certificateAuthorityPath ? (await readFile6(options.certificateAuthorityPath)).toString("base64url") : undefined;
+  const encodedCertificateAuthority = options.certificateAuthorityPath ? (await readFile7(options.certificateAuthorityPath)).toString("base64url") : undefined;
+  const physicalDevice = options.deviceIdentifier !== undefined;
+  let relayPort;
+  if (physicalDevice)
+    relayPort = options.port <= 49151 ? options.port + 16384 : options.port - 16384;
+  if (physicalDevice && !options.serverHost)
+    throw new Error("Remote physical iOS development requires the Remote Mac LAN host.");
   const remoteCommand = [
     `cd ${shellQuote(options.project.remoteProjectRoot)}`,
     "&&",
@@ -3939,14 +4241,22 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, PROFILE_NAME, SSH_DESTI
       "--certificate-authority",
       shellQuote(encodedCertificateAuthority)
     ] : [],
-    ...options.https ? ["--https"] : []
+    ...options.https ? ["--https"] : [],
+    ...options.deviceIdentifier ? [
+      "--ios-device",
+      shellQuote(options.deviceIdentifier),
+      "--server-host",
+      shellQuote(options.serverHost ?? ""),
+      "--relay-port",
+      String(relayPort)
+    ] : []
   ].join(" ");
   const command = [
     ...absoluteRemoteMacSshBase(options.project.profile),
     "-o",
     "ExitOnForwardFailure=yes",
     "-R",
-    `${options.port}:127.0.0.1:${options.port}`,
+    physicalDevice ? `127.0.0.1:${relayPort}:127.0.0.1:${options.port}` : `${options.port}:127.0.0.1:${options.port}`,
     "/bin/sh -lc",
     shellQuote(remoteCommand)
   ];
@@ -4034,7 +4344,7 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, PROFILE_NAME, SSH_DESTI
   };
   options.log?.(`Remote Mac connected (${options.project.profile.name}); agent ${agent.uploaded ? "uploaded" : "cache hit"}, project synced, and iOS ready in ${totalDuration.toFixed(2)}ms.`);
   const request = (commandName) => {
-    const id = randomUUID3();
+    const id = randomUUID4();
     const response = new Promise((resolve8, reject) => pending.set(id, { reject, resolve: resolve8 }));
     process2.stdin.write(`${JSON.stringify({ command: commandName, id, v: 1 })}
 `);
@@ -4067,6 +4377,7 @@ var PROFILE_FORMAT = 1, REMOTE_STDIN_FLUSH_ATTEMPTS = 3, PROFILE_NAME, SSH_DESTI
     close,
     nativeCacheHit: currentReady.nativeCacheHit,
     startedSimulator: currentReady.startedSimulator,
+    targetKind: currentReady.targetKind,
     timings: currentReady.timings,
     udid: currentReady.udid,
     rebuild: async () => {
@@ -4136,8 +4447,8 @@ import {
   readFileSync as readFileSync7,
   rmSync
 } from "fs";
-import { X509Certificate } from "crypto";
-import { isIP } from "net";
+import { X509Certificate as X509Certificate2 } from "crypto";
+import { isIP as isIP4 } from "net";
 import { platform as platform2 } from "os";
 import { join as join12 } from "path";
 var CERT_DIR, CERT_PATH, KEY_PATH, CERT_VALIDITY_DAYS = 365, DEFAULT_CERTIFICATE_HOSTS, CERTIFICATE_HOSTNAME_PATTERN, devLog = (msg) => console.log(`\x1B[2m${new Date().toLocaleTimeString()}\x1B[0m \x1B[36m[dev]\x1B[0m ${msg}`), devWarn = (msg) => console.log(`\x1B[2m${new Date().toLocaleTimeString()}\x1B[0m \x1B[33m[dev]\x1B[0m \x1B[33m${msg}\x1B[0m`), certFilesExist = () => existsSync4(CERT_PATH) && existsSync4(KEY_PATH), normalizeDevCertificateHosts = (hosts = []) => {
@@ -4146,7 +4457,7 @@ var CERT_DIR, CERT_PATH, KEY_PATH, CERT_VALIDITY_DAYS = 365, DEFAULT_CERTIFICATE
     const value = host.trim().toLowerCase();
     if (!value || value === "0.0.0.0" || value === "::")
       continue;
-    if (isIP(value) === 0 && !CERTIFICATE_HOSTNAME_PATTERN.test(value)) {
+    if (isIP4(value) === 0 && !CERTIFICATE_HOSTNAME_PATTERN.test(value)) {
       throw new TypeError(`Invalid development certificate host: ${host}`);
     }
     normalized.add(value);
@@ -4155,10 +4466,10 @@ var CERT_DIR, CERT_PATH, KEY_PATH, CERT_VALIDITY_DAYS = 365, DEFAULT_CERTIFICATE
 }, certificateIsUsable = (hosts) => {
   try {
     const certPem = readFileSync7(CERT_PATH, "utf-8");
-    const certificate = new X509Certificate(certPem);
+    const certificate = new X509Certificate2(certPem);
     if (new Date(certificate.validTo).getTime() <= Date.now())
       return false;
-    return normalizeDevCertificateHosts(hosts).every((host) => isIP(host) ? certificate.checkIP(host) !== undefined : certificate.checkHost(host) !== undefined);
+    return normalizeDevCertificateHosts(hosts).every((host) => isIP4(host) ? certificate.checkIP(host) !== undefined : certificate.checkHost(host) !== undefined);
   } catch {
     return false;
   }
@@ -4186,7 +4497,7 @@ var CERT_DIR, CERT_PATH, KEY_PATH, CERT_VALIDITY_DAYS = 365, DEFAULT_CERTIFICATE
     throw new Error(`mkcert failed: ${err}`);
   }
 }, generateSelfSigned = (hosts = []) => {
-  const subjectAlternativeNames = normalizeDevCertificateHosts(hosts).map((host) => `${isIP(host) ? "IP" : "DNS"}:${host}`).join(",");
+  const subjectAlternativeNames = normalizeDevCertificateHosts(hosts).map((host) => `${isIP4(host) ? "IP" : "DNS"}:${host}`).join(",");
   const proc = Bun.spawnSync([
     "openssl",
     "req",
@@ -5834,7 +6145,7 @@ var normalizeSlug = (str) => str.trim().replace(/\s+/g, "-").replace(/[^A-Za-z0-
 
 // src/mobile/buildRelease.ts
 import { createHash as createHash8 } from "crypto";
-import { mkdir as mkdir7, readFile as readFile7, writeFile as writeFile6 } from "fs/promises";
+import { mkdir as mkdir7, readFile as readFile8, writeFile as writeFile6 } from "fs/promises";
 import { basename as basename6, dirname as dirname9, extname as extname3, join as join16, relative as relative9, resolve as resolve13 } from "path";
 var sha256 = (bytes) => createHash8("sha256").update(bytes).digest("hex"), STATIC_SCRIPT_PATTERN, rewriteStaticScriptPaths = (source, manifest) => source.replace(STATIC_SCRIPT_PATTERN, (match, prefix, path, suffix) => {
   if (path.endsWith("/htmx.min.js"))
@@ -5856,7 +6167,7 @@ var sha256 = (bytes) => createHash8("sha256").update(bytes).digest("hex"), STATI
   }
   let resolvedAssetPath = resolveAssetPath(buildDirectory, assetPath);
   if (metadata.framework === "html" || metadata.framework === "htmx") {
-    const source = await readFile7(resolvedAssetPath, "utf8");
+    const source = await readFile8(resolvedAssetPath, "utf8");
     const rewritten = rewriteStaticScriptPaths(source, manifest);
     const documentHash = sha256(new TextEncoder().encode(rewritten));
     resolvedAssetPath = join16(buildDirectory, ".absolutejs", "mobile-pages", `${documentHash}.html`);
@@ -5870,8 +6181,8 @@ var sha256 = (bytes) => createHash8("sha256").update(bytes).digest("hex"), STATI
   ].map((key) => manifest[key]).find((path) => typeof path === "string");
   const resolvedStylePath = styleAssetPath ? resolveAssetPath(buildDirectory, styleAssetPath) : undefined;
   const [bytes, styleBytes] = await Promise.all([
-    readFile7(resolvedAssetPath),
-    resolvedStylePath ? readFile7(resolvedStylePath) : undefined
+    readFile8(resolvedAssetPath),
+    resolvedStylePath ? readFile8(resolvedStylePath) : undefined
   ]);
   const bundlePath = `/${relative9(resolve13(buildDirectory), resolvedAssetPath).replaceAll("\\", "/")}`;
   const styleBundlePath = resolvedStylePath ? `/${relative9(resolve13(buildDirectory), resolvedStylePath).replaceAll("\\", "/")}` : undefined;
@@ -5890,7 +6201,7 @@ var sha256 = (bytes) => createHash8("sha256").update(bytes).digest("hex"), STATI
 }, buildAbsoluteMobileCompatibilityRelease = async (options) => {
   const [captured, producerBytes] = await Promise.all([
     captureAbsoluteMobileRouteGraph(options.app),
-    readFile7(options.producerPath)
+    readFile8(options.producerPath)
   ]);
   if (captured.length === 0) {
     throw new TypeError("No instrumented AbsoluteJS mobile page routes were found in the finalized Elysia route graph.");
@@ -6070,7 +6381,7 @@ import {
   copyFile as copyFile4,
   mkdir as mkdir8,
   mkdtemp as mkdtemp3,
-  readFile as readFile8,
+  readFile as readFile9,
   rename as rename6,
   rm as rm5,
   writeFile as writeFile7
@@ -6128,7 +6439,7 @@ var MANIFEST_FILE = "absolute-mobile-manifest.json", BOOTSTRAP_FILE = "absolute-
   const packageName = specifier.startsWith("@") ? segments.slice(0, 2).join("/") : segments[0] ?? "";
   const subpath = specifier.slice(packageName.length);
   const packageDirectory = join17(resolve14(projectRoot), "node_modules", packageName);
-  const manifest = JSON.parse(await readFile8(join17(packageDirectory, "package.json"), "utf8"));
+  const manifest = JSON.parse(await readFile9(join17(packageDirectory, "package.json"), "utf8"));
   const exports = typeof manifest === "object" && manifest !== null ? Reflect.get(manifest, "exports") : undefined;
   const entry = typeof exports === "object" && exports !== null ? Reflect.get(exports, subpath ? `.${subpath}` : ".") : undefined;
   const target = importEntryTarget(entry);
@@ -6230,7 +6541,7 @@ void startAbsoluteMobileShell(${push ? `{ createAuth: (config, options) => creat
     ...localStylePath ? { localStylePath } : {}
   };
 }, absoluteClientImports = async (sourcePath, buildDirectory) => {
-  const source = await readFile8(sourcePath, "utf8");
+  const source = await readFile9(sourcePath, "utf8");
   const extension = extname4(sourcePath).toLowerCase();
   let scriptLoader;
   if (extension === ".tsx")
@@ -6372,7 +6683,7 @@ import {
   access as access6,
   mkdir as mkdir9,
   mkdtemp as mkdtemp4,
-  readFile as readFile9,
+  readFile as readFile10,
   rename as rename7,
   rm as rm6,
   writeFile as writeFile8
@@ -6472,7 +6783,7 @@ var ABSOLUTE_MOBILE_MATERIALIZED_BUNDLE_FORMAT = 1, CURRENT_BUNDLE_FILE = "curre
 }, readAbsoluteMobileMaterializedReleases = async (root) => {
   const resolvedRoot = resolvePath2(root);
   try {
-    const serialized = await readFile9(join18(resolvedRoot, CURRENT_BUNDLE_FILE), "utf8");
+    const serialized = await readFile10(join18(resolvedRoot, CURRENT_BUNDLE_FILE), "utf8");
     const parsed = JSON.parse(serialized);
     const index = parseBundleIndex(parsed);
     const bundleRoot = join18(resolvedRoot, BUNDLES_DIRECTORY, index.bundleId);
@@ -7174,7 +7485,7 @@ var init_deviceCapabilities = __esm(() => {
 });
 
 // src/mobile/buildPipeline.ts
-import { readFile as readFile10 } from "fs/promises";
+import { readFile as readFile11 } from "fs/promises";
 import { join as join21, resolve as resolve17 } from "path";
 import { pathToFileURL } from "url";
 var isElysiaApp = (value) => typeof value === "object" && value !== null && typeof Reflect.get(value, "compile") === "function" && Array.isArray(Reflect.get(value, "routes")), isStringRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value) && Object.values(value).every((entry) => typeof entry === "string"), serverExportName = (loaded, app) => {
@@ -7208,7 +7519,7 @@ var isElysiaApp = (value) => typeof value === "object" && value !== null && type
   const mobile = normalizeAbsoluteMobileConfig(options.mobile, options.projectRoot);
   const root = join21(buildDirectory, ".absolutejs", "mobile-compatibility");
   const [manifestSource, previous] = await Promise.all([
-    readFile10(join21(buildDirectory, "manifest.json"), "utf8"),
+    readFile11(join21(buildDirectory, "manifest.json"), "utf8"),
     readAbsoluteMobileMaterializedReleases(root)
   ]);
   const manifest = JSON.parse(manifestSource);
@@ -10914,8 +11225,8 @@ export { value };
   host2.getSourceFile = (fileName, languageVersion, onError, shouldCreate) => fileName === virtualPath ? ts6.createSourceFile(fileName, source, languageVersion, true) : getSourceFile(fileName, languageVersion, onError, shouldCreate);
   const fileExists = host2.fileExists.bind(host2);
   host2.fileExists = (fileName) => fileName === virtualPath ? true : fileExists(fileName);
-  const readFile11 = host2.readFile.bind(host2);
-  host2.readFile = (fileName) => fileName === virtualPath ? source : readFile11(fileName);
+  const readFile12 = host2.readFile.bind(host2);
+  host2.readFile = (fileName) => fileName === virtualPath ? source : readFile12(fileName);
   const program = ts6.createProgram([virtualPath], options, host2);
   const checker = program.getTypeChecker();
   const sourceFile = program.getSourceFile(virtualPath);
@@ -16538,10 +16849,10 @@ var init_compile = __esm(() => {
 });
 
 // src/mobile/nativeDeepLinks.ts
-import { readFile as readFile11, rename as rename8, writeFile as writeFile9 } from "fs/promises";
+import { readFile as readFile12, rename as rename8, writeFile as writeFile9 } from "fs/promises";
 import { join as join46 } from "path";
 var START_MARKER = "<!-- absolutejs:deep-links:start -->", END_MARKER = "<!-- absolutejs:deep-links:end -->", IOS_ENTITLEMENTS = "App/AbsoluteJS.entitlements", NOT_FOUND = -1, escapeXml = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;"), writeChangedFile = async (path, source) => {
-  const current = await readFile11(path, "utf8");
+  const current = await readFile12(path, "utf8");
   if (current === source)
     return false;
   const temporary = `${path}.${crypto.randomUUID()}.tmp`;
@@ -16589,7 +16900,7 @@ ${hosts}
 `;
 }, configureAndroid = async (config) => {
   const path = join46(config.nativeProjectDirectory, "android/app/src/main/AndroidManifest.xml");
-  const source = await readFile11(path, "utf8");
+  const source = await readFile12(path, "utf8");
   const mainActivity = source.indexOf('android:name=".MainActivity"');
   if (mainActivity === NOT_FOUND) {
     throw new TypeError("Android MainActivity was not found.");
@@ -16613,7 +16924,7 @@ ${hosts}
 	${END_MARKER}
 `, configureIosInfo = async (config) => {
   const path = join46(config.nativeProjectDirectory, "ios/App/App/Info.plist");
-  const source = await readFile11(path, "utf8");
+  const source = await readFile12(path, "utf8");
   const region = config.deepLinkScheme ? iosSchemeRegion(config.deepLinkScheme) : `	${START_MARKER}
 	${END_MARKER}
 `;
@@ -16637,7 +16948,7 @@ ${domains}
   const path = join46(config.nativeProjectDirectory, "ios/App/AbsoluteJS.entitlements");
   let current = "";
   try {
-    current = await readFile11(path, "utf8");
+    current = await readFile12(path, "utf8");
   } catch (error) {
     if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
       throw error;
@@ -16652,7 +16963,7 @@ ${domains}
   return true;
 }, configureIosProject = async (config) => {
   const path = join46(config.nativeProjectDirectory, "ios/App/App.xcodeproj/project.pbxproj");
-  const source = await readFile11(path, "utf8");
+  const source = await readFile12(path, "utf8");
   const declarations = [
     ...source.matchAll(/CODE_SIGN_ENTITLEMENTS = ([^;]+);/g)
   ].map((match) => match[1]);
@@ -16690,10 +17001,10 @@ ${domains}
 var init_nativeDeepLinks = () => {};
 
 // src/mobile/nativeDeviceCapabilities.ts
-import { readFile as readFile12, rename as rename9, writeFile as writeFile10 } from "fs/promises";
+import { readFile as readFile13, rename as rename9, writeFile as writeFile10 } from "fs/promises";
 import { join as join47 } from "path";
 var START_MARKER2 = "<!-- absolutejs:device-capabilities:start -->", END_MARKER2 = "<!-- absolutejs:device-capabilities:end -->", NOT_FOUND2 = -1, IOS_PRIVACY_FILE_REFERENCE = "A85D0C000000000000000001", IOS_PRIVACY_BUILD_FILE = "A85D0C000000000000000002", PUSH_START_MARKER = "absolutejs:push-notifications:start", PUSH_END_MARKER = "absolutejs:push-notifications:end", escapeXml2 = (value) => value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("'", "&apos;").replaceAll("<", "&lt;").replaceAll(">", "&gt;"), writeChangedFile2 = async (path, source) => {
-  const current = await readFile12(path, "utf8");
+  const current = await readFile13(path, "utf8");
   if (current === source)
     return false;
   const temporary = `${path}.${crypto.randomUUID()}.tmp`;
@@ -16711,7 +17022,7 @@ var START_MARKER2 = "<!-- absolutejs:device-capabilities:start -->", END_MARKER2
   return writeChangedFile2(path, source);
 }, optionalSource = async (path) => {
   try {
-    return await readFile12(path, "utf8");
+    return await readFile13(path, "utf8");
   } catch (error) {
     if (typeof error === "object" && error !== null && Reflect.get(error, "code") === "ENOENT")
       return null;
@@ -16819,7 +17130,7 @@ ${entries}
   if (requirements.iosPrivacyAccessedApis.length === 0)
     return false;
   const projectPath = join47(config.nativeProjectDirectory, "ios/App/App.xcodeproj/project.pbxproj");
-  const project = await readFile12(projectPath, "utf8");
+  const project = await readFile13(projectPath, "utf8");
   return writeChangedFile2(projectPath, addIosPrivacyProjectReference(project));
 }, addIosPrivacyProjectReference = (source) => {
   const fileMatch = source.match(/([A-F0-9]{24}) \/\* PrivacyInfo\.xcprivacy \*\/ = \{isa = PBXFileReference;/u);
@@ -16870,7 +17181,7 @@ ${next.slice(index)}`;
   return next;
 }, configureIos2 = async (config, plan) => {
   const path = join47(config.nativeProjectDirectory, "ios/App/App/Info.plist");
-  const source = await readFile12(path, "utf8");
+  const source = await readFile13(path, "utf8");
   const requirements = absoluteDeviceNativeRequirements(plan);
   const existingSystemBars = source.match(/<key>UIViewControllerBasedStatusBarAppearance<\/key>\s*<(true|false)\s*\/>/u);
   const ownedStart = source.indexOf(START_MARKER2);
@@ -16960,7 +17271,7 @@ ${content}
   return `${source.slice(0, insertion)}${region}${source.slice(insertion)}`;
 }, configureAndroid2 = async (config, plan) => {
   const path = join47(config.nativeProjectDirectory, "android/app/src/main/AndroidManifest.xml");
-  const source = await readFile12(path, "utf8");
+  const source = await readFile13(path, "utf8");
   const permissions = absoluteDeviceNativeRequirements(plan).androidPermissions;
   const content = permissions.map((permission) => `    <uses-permission android:name="${escapeXml2(permission)}" />`).join(`
 `);
@@ -17019,10 +17330,10 @@ var init_nativeDeviceCapabilities = __esm(() => {
 });
 
 // src/mobile/nativeBackgroundSync.ts
-import { readFile as readFile13, rename as rename10, writeFile as writeFile11 } from "fs/promises";
+import { readFile as readFile14, rename as rename10, writeFile as writeFile11 } from "fs/promises";
 import { join as join48 } from "path";
 var writeChanged = async (path, source) => {
-  const current = await readFile13(path, "utf8");
+  const current = await readFile14(path, "utf8");
   if (current === source)
     return false;
   const temporary = `${path}.${crypto.randomUUID()}.tmp`;
@@ -17104,10 +17415,10 @@ ${makeRegion(values)}	</array>
     return { changed: false };
   const identifier = `${config.appId}.absolutejs.background-sync`;
   const infoPath = join48(config.nativeProjectDirectory, "ios/App/App/Info.plist");
-  const info2 = await readFile13(infoPath, "utf8");
+  const info2 = await readFile14(infoPath, "utf8");
   const nextInfo = ensurePlistArrayValues(ensurePlistArrayValues(info2, "BGTaskSchedulerPermittedIdentifiers", [identifier], "background-sync-identifiers"), "UIBackgroundModes", ["fetch", "processing"], "background-sync-modes");
   const delegatePath = join48(config.nativeProjectDirectory, "ios/App/App/AppDelegate.swift");
-  let delegate = await readFile13(delegatePath, "utf8");
+  let delegate = await readFile14(delegatePath, "utf8");
   if (!delegate.includes("import AbsoluteSyncCapacitor")) {
     const importIndex = delegate.lastIndexOf("import Capacitor");
     if (importIndex < 0)
@@ -17141,7 +17452,7 @@ var init_nativeBackgroundSync = __esm(() => {
 import {
   access as access7,
   mkdir as mkdir10,
-  readFile as readFile14,
+  readFile as readFile15,
   rename as rename11,
   rm as rm7,
   writeFile as writeFile12
@@ -17199,7 +17510,7 @@ var OWNERSHIP_FILE = ".absolutejs-mobile-associations.json", HTTP_OK = 200, VERI
 }, writeAtomic = async (path, source) => {
   let current;
   try {
-    current = await readFile14(path, "utf8");
+    current = await readFile15(path, "utf8");
   } catch (error) {
     if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
       throw error;
@@ -17222,7 +17533,7 @@ var OWNERSHIP_FILE = ".absolutejs-mobile-associations.json", HTTP_OK = 200, VERI
   const path = resolve37(root, OWNERSHIP_FILE);
   let ownership;
   try {
-    ownership = JSON.parse(await readFile14(path, "utf8"));
+    ownership = JSON.parse(await readFile15(path, "utf8"));
   } catch {
     throw new TypeError(`Association output ${root} already exists and is not owned by AbsoluteJS.`);
   }
@@ -17735,7 +18046,7 @@ var DEFAULT_ROUTE_TIMEOUT_MS = 30000, DEFAULT_HMR_TIMEOUT_MS = 30000, routeExpre
 };
 
 // src/mobile/releaseDoctor.ts
-import { access as access8, readFile as readFile15, readdir as readdir4 } from "fs/promises";
+import { access as access8, readFile as readFile16, readdir as readdir4 } from "fs/promises";
 import { dirname as dirname29, extname as extname8, join as join49, relative as relative24 } from "path";
 var HMR_ASSET_PATTERN, RELEASE_ASSET_EXTENSIONS, pathExists5 = async (path) => {
   try {
@@ -17749,7 +18060,7 @@ var HMR_ASSET_PATTERN, RELEASE_ASSET_EXTENSIONS, pathExists5 = async (path) => {
     return findHmrAsset(path);
   if (!isFile2 || !RELEASE_ASSET_EXTENSIONS.has(extname8(path)))
     return;
-  const source = await readFile15(path, "utf8");
+  const source = await readFile16(path, "utf8");
   return HMR_ASSET_PATTERN.test(source) ? path : undefined;
 }, findHmrAsset = async (root) => {
   if (!await pathExists5(root))
@@ -17788,18 +18099,18 @@ var HMR_ASSET_PATTERN, RELEASE_ASSET_EXTENSIONS, pathExists5 = async (path) => {
   if (!await pathExists5(nativeConfigPath)) {
     return fail5("android.capacitor-config", "The generated Android Capacitor config is missing.", nativeConfigPath, "Run `absolute mobile sync android` before release validation.");
   }
-  const unsafe = isUnsafeCapacitorConfig(await readFile15(nativeConfigPath, "utf8"));
+  const unsafe = isUnsafeCapacitorConfig(await readFile16(nativeConfigPath, "utf8"));
   return unsafe ? fail5("android.capacitor-config", "Android Capacitor config contains a development server URL, cleartext transport, navigation allowlist, or invalid JSON.", nativeConfigPath, "Run `absolute mobile sync android`; do not ship development transport overrides.") : pass("android.capacitor-config", "Android Capacitor config contains no development transport overrides.", nativeConfigPath);
 }, manifestReleaseCheck = async (manifestPath) => {
   if (!await pathExists5(manifestPath)) {
     return fail5("android.cleartext", "The Android manifest is missing.", manifestPath, "Run `absolute mobile sync android` before release validation.");
   }
-  const source = await readFile15(manifestPath, "utf8");
+  const source = await readFile16(manifestPath, "utf8");
   const cleartext = /android:usesCleartextTraffic=["']true["']/u.test(source);
   const networkConfigName = source.match(/android:networkSecurityConfig=["']@xml\/([a-z0-9_]+)["']/u)?.[1];
   const networkConfigPath = networkConfigName ? join49(dirname29(manifestPath), "res", "xml", `${networkConfigName}.xml`) : undefined;
   const developmentTrustReference = /android:networkSecurityConfig=["']@xml\/absolutejs_dev_network_security["']/u.test(source);
-  const developmentTrustContents = networkConfigPath ? await readFile15(networkConfigPath, "utf8").then((value) => value.includes("@raw/absolutejs_dev_ca")).catch(() => false) : false;
+  const developmentTrustContents = networkConfigPath ? await readFile16(networkConfigPath, "utf8").then((value) => value.includes("@raw/absolutejs_dev_ca")).catch(() => false) : false;
   const developmentTrust = developmentTrustReference || developmentTrustContents;
   return cleartext || developmentTrust ? fail5("android.cleartext", developmentTrust ? "Android still references the AbsoluteJS development certificate authority." : "Android explicitly permits cleartext traffic.", manifestPath, "Run `absolute mobile sync android`; do not ship development transport or trust overrides.") : pass("android.cleartext", "Android does not explicitly permit cleartext traffic.", manifestPath);
 }, hmrAssetsReleaseCheck = async (publicRoot) => {
@@ -17831,7 +18142,7 @@ var HMR_ASSET_PATTERN, RELEASE_ASSET_EXTENSIONS, pathExists5 = async (path) => {
   if (!config.platforms.includes("android") || permissions.length === 0)
     return;
   const path = join49(config.nativeProjectDirectory, "android/app/src/main/AndroidManifest.xml");
-  const source = await readFile15(path, "utf8");
+  const source = await readFile16(path, "utf8");
   const missing = permissions.filter((permission) => !source.includes(`android:name="${permission}"`) && !source.includes(`android:name='${permission}'`));
   if (missing.length === 0)
     return;
@@ -17840,7 +18151,7 @@ var HMR_ASSET_PATTERN, RELEASE_ASSET_EXTENSIONS, pathExists5 = async (path) => {
   if (!config.platforms.includes("ios") || purposes.length === 0)
     return;
   const path = join49(config.nativeProjectDirectory, "ios/App/App/Info.plist");
-  const source = await readFile15(path, "utf8");
+  const source = await readFile16(path, "utf8");
   const missing = purposes.filter((purpose) => !source.includes(`<key>${IOS_USAGE_KEYS[purpose]}</key>`));
   if (missing.length === 0)
     return;
@@ -17893,7 +18204,7 @@ var HMR_ASSET_PATTERN, RELEASE_ASSET_EXTENSIONS, pathExists5 = async (path) => {
   }
   if (!await pathExists5(nativeConfigPath)) {
     checks.push(fail5("ios.capacitor-config", "The generated iOS Capacitor config is missing.", nativeConfigPath, "Run `absolute mobile sync ios` before release validation."));
-  } else if (isUnsafeCapacitorConfig(await readFile15(nativeConfigPath, "utf8"))) {
+  } else if (isUnsafeCapacitorConfig(await readFile16(nativeConfigPath, "utf8"))) {
     checks.push(fail5("ios.capacitor-config", "iOS Capacitor config contains a development server URL, cleartext transport, navigation allowlist, or invalid JSON.", nativeConfigPath, "Run `absolute mobile sync ios`; do not ship development transport overrides."));
   } else {
     checks.push(pass("ios.capacitor-config", "iOS Capacitor config contains no development transport overrides.", nativeConfigPath));
@@ -17901,7 +18212,7 @@ var HMR_ASSET_PATTERN, RELEASE_ASSET_EXTENSIONS, pathExists5 = async (path) => {
   if (!await pathExists5(infoPath)) {
     checks.push(fail5("ios.transport-security", "The iOS Info.plist is missing.", infoPath, "Run `absolute mobile sync ios` before release validation."));
   } else {
-    const info2 = await readFile15(infoPath, "utf8");
+    const info2 = await readFile16(infoPath, "utf8");
     checks.push(/<key>NSAllowsArbitraryLoads<\/key>\s*<true\s*\/>/u.test(info2) ? fail5("ios.transport-security", "iOS App Transport Security permits arbitrary network loads.", infoPath, "Remove NSAllowsArbitraryLoads from the release Info.plist.") : pass("ios.transport-security", "iOS App Transport Security does not permit arbitrary loads.", infoPath));
   }
   const hmrAsset = await findHmrAsset(publicRoot);
@@ -17954,7 +18265,7 @@ import {
   copyFile as copyFile5,
   mkdir as mkdir12,
   mkdtemp as mkdtemp5,
-  readFile as readFile16,
+  readFile as readFile17,
   rename as rename12,
   rm as rm8,
   stat as stat2,
@@ -18010,7 +18321,7 @@ var ABSOLUTE_ANDROID_RELEASE_FORMAT = 1, isRecord13 = (value) => typeof value ==
     artifactPath
   ]);
   return result.exitCode === 0 && /jar verified/iu.test(result.stdout);
-}, sha256File2 = async (path) => createHash12("sha256").update(await readFile16(path)).digest("hex"), safeOutputDirectory2 = (projectRoot, requested) => {
+}, sha256File2 = async (path) => createHash12("sha256").update(await readFile17(path)).digest("hex"), safeOutputDirectory2 = (projectRoot, requested) => {
   const root = resolve39(projectRoot);
   const output = resolve39(root, requested ?? ".absolutejs/mobile/releases/android");
   const projectRelative = relative25(root, output);
@@ -18023,7 +18334,7 @@ var ABSOLUTE_ANDROID_RELEASE_FORMAT = 1, isRecord13 = (value) => typeof value ==
   const artifactName = "app-release.aab";
   const destination = join50(releaseRoot, artifactName);
   if (await pathExists6(releaseRoot)) {
-    const existing = requireManifestIdentity(JSON.parse(await readFile16(join50(releaseRoot, "release.json"), "utf8")), metadata);
+    const existing = requireManifestIdentity(JSON.parse(await readFile17(join50(releaseRoot, "release.json"), "utf8")), metadata);
     const [installedBytes, installedSha256] = await Promise.all([
       stat2(destination).then(({ size }) => size),
       sha256File2(destination)
@@ -18070,7 +18381,7 @@ var ABSOLUTE_ANDROID_RELEASE_FORMAT = 1, isRecord13 = (value) => typeof value ==
   const host2 = options.host ?? detectAbsoluteMobileHost();
   const androidRoot = options.androidRoot ?? process.env.ANDROID_HOME ?? process.env.ANDROID_SDK_ROOT ?? absoluteManagedAndroidSdkRoot(host2);
   const nativeDirectory = join50(options.config.nativeProjectDirectory, "android");
-  const manifest = requireManifest2(JSON.parse(await readFile16(join50(options.config.bundleDirectory, "absolute-mobile-manifest.json"), "utf8")));
+  const manifest = requireManifest2(JSON.parse(await readFile17(join50(options.config.bundleDirectory, "absolute-mobile-manifest.json"), "utf8")));
   if (manifest.appId !== options.config.appId) {
     throw new TypeError("Embedded mobile manifest appId does not match mobile.appId.");
   }
@@ -18133,8 +18444,46 @@ 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 readFile17, stat as stat3 } from "fs/promises";
+import { readFile as readFile18, stat as stat3 } from "fs/promises";
 var HMR_LINE, parseAbsoluteIosHmrLog = (line) => {
   const match = HMR_LINE.exec(line);
   if (!match)
@@ -18169,7 +18518,7 @@ var HMR_LINE, parseAbsoluteIosHmrLog = (line) => {
     if (Date.now() > deadline)
       throw new Error(`No iOS native HMR acknowledgement was observed within ${timeoutMs}ms.`);
     options.signal?.throwIfAborted();
-    const contents = await readFile17(options.logPath).catch(() => Buffer.alloc(0));
+    const contents = await readFile18(options.logPath).catch(() => Buffer.alloc(0));
     if (contents.byteLength < offset) {
       offset = 0;
       buffered = "";
@@ -18193,7 +18542,7 @@ var init_iosConformance = __esm(() => {
 });
 
 // src/mobile/nativeTestReport.ts
-import { mkdir as mkdir13, readFile as readFile18, writeFile as writeFile15 } from "fs/promises";
+import { mkdir as mkdir13, readFile as readFile19, writeFile as writeFile15 } from "fs/promises";
 import { join as join51 } from "path";
 var secretPattern, bearerPattern, coordinatePattern, nativeCredentialPattern, sanitizeNativeReportText = (value) => value.replace(nativeCredentialPattern, "[REDACTED]").replace(bearerPattern, "Bearer [REDACTED]").replace(secretPattern, "$1$2[REDACTED]").replace(coordinatePattern, "$1$2[REDACTED]").replace(/(https?:\/\/[^\s?#]+)[?#][^\s]*/giu, "$1?[REDACTED]"), markdownCell = (value) => sanitizeNativeReportText(value).replaceAll("|", "\\|").replaceAll(`
 `, "<br>"), createAbsoluteNativeAutomatedChecks = (run) => {
@@ -18203,6 +18552,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}.`,
@@ -18221,10 +18579,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) {
@@ -18257,22 +18615,37 @@ 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,
   reportVersion: 1,
   run: options.run
 }), readPackageVersionForNativeReport = async (packageJsonPath) => {
-  const manifest = JSON.parse(await readFile18(packageJsonPath, "utf8"));
+  const manifest = JSON.parse(await readFile19(packageJsonPath, "utf8"));
   if (typeof manifest !== "object" || manifest === null)
     return "unknown";
   const version2 = Reflect.get(manifest, "version");
@@ -18327,10 +18700,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,
@@ -18341,8 +18722,8 @@ var MANUAL_CHECKS, readPackageVersionForIosReport, sanitizeIosReportText, writeA
     run: {
       ...run,
       platform: "ios",
-      targetId: udid,
-      targetKind: "simulator"
+      targetId,
+      targetKind
     }
   });
 };
@@ -18359,6 +18740,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")}`,
@@ -18613,11 +18998,11 @@ var exports_mobile = {};
 __export(exports_mobile, {
   runMobile: () => runMobile
 });
-import { access as access11, mkdir as mkdir14, readFile as readFile19, writeFile as writeFile16 } from "fs/promises";
+import { access as access11, mkdir as mkdir14, readFile as readFile20, writeFile as writeFile16 } from "fs/promises";
 import { join as join52, resolve as resolve41 } from "path";
 import { createInterface } from "readline/promises";
 var NOT_FOUND3 = -1, isRecord15 = (value) => typeof value === "object" && value !== null && !Array.isArray(value), CAPACITOR_PACKAGES, CAPACITOR_PACKAGE_SPECS, CAPACITOR_SYNC_PACKAGE_SPECS, packageNameFromSpec = (spec) => spec.slice(0, spec.lastIndexOf("@")), directProjectPackages = async (projectRoot) => {
-  const manifest = JSON.parse(await readFile19(join52(projectRoot, "package.json"), "utf8"));
+  const manifest = JSON.parse(await readFile20(join52(projectRoot, "package.json"), "utf8"));
   if (!isRecord15(manifest))
     throw new TypeError("Application package.json must contain an object.");
   const names = new Set;
@@ -18630,7 +19015,7 @@ var NOT_FOUND3 = -1, isRecord15 = (value) => typeof value === "object" && value
   return names;
 }, resolvedPackageVersion = async (projectRoot, packageName) => {
   try {
-    const manifest = JSON.parse(await readFile19(join52(projectRoot, "node_modules", packageName, "package.json"), "utf8"));
+    const manifest = JSON.parse(await readFile20(join52(projectRoot, "node_modules", packageName, "package.json"), "utf8"));
     return isRecord15(manifest) && typeof manifest.version === "string" ? manifest.version : undefined;
   } catch {
     return;
@@ -19536,7 +19921,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
@@ -19546,7 +19931,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)`;
@@ -19557,6 +19942,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,
@@ -19662,12 +20082,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);
@@ -19676,6 +20208,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");
@@ -19713,7 +20274,8 @@ Emulator setup verification:`);
       provider: "capacitor",
       screenshot,
       status: "pass",
-      udid: simulator.udid
+      target: "simulator",
+      targetId: simulator.udid
     };
     sendTelemetryEvent("mobile:ios-conformance", {
       durationMs: report.durationMs,
@@ -19741,7 +20303,8 @@ Emulator setup verification:`);
         port: report.port,
         screenshot: report.screenshot,
         status: report.status,
-        udid: report.udid
+        targetId: report.targetId,
+        targetKind: report.target
       },
       xcrun
     });
@@ -19774,7 +20337,8 @@ Emulator setup verification:`);
         port,
         ...screenshot ? { screenshot } : {},
         status: "fail",
-        udid: simulator.udid
+        targetId: simulator.udid,
+        targetKind: "simulator"
       },
       xcrun
     });
@@ -19834,7 +20398,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();
@@ -19855,6 +20419,7 @@ var init_mobile = __esm(() => {
   init_androidRelease();
   init_iosRelease();
   init_iosSimulatorController();
+  init_iosPhysicalDeviceTransport();
   init_iosConformance();
   init_iosTestReport();
   init_androidTestReport();
@@ -21208,13 +21773,15 @@ var androidToolchainReady = (checks, target = "emulator") => {
   ]);
   return checks.every((check) => check.platform !== "android" || target === "device" && deviceOnlyChecks.has(check.id) || check.status !== "fail" && check.status !== "warn");
 };
-var iosToolchainReady = (checks) => checks.every((check) => check.platform !== "ios" || check.status !== "fail" && check.status !== "warn");
+var iosToolchainReady = (checks, target = "simulator") => checks.every((check) => check.platform !== "ios" || target === "device" && check.id === "ios.runtime" || check.status !== "fail" && check.status !== "warn");
 var dev = async (serverEntry, configPath2, options = {}) => {
   let httpsEnabled = false;
   let devCertificateAuthorityPath = null;
   let resolvedDev;
   let buildDirectory = resolve8(process.cwd(), "build");
   let mobileConfig;
+  let iosPhysicalServerHost;
+  let selectedRemoteMacProfile;
   try {
     const config = await loadConfig(configPath2);
     mobileConfig = config?.mobile;
@@ -21229,17 +21796,35 @@ var dev = async (serverEntry, configPath2, options = {}) => {
     resolvedDev = resolveDevConfig(undefined);
     httpsEnabled = resolvedDev.https;
   }
-  if (options.androidDevice && ["localhost", "127.0.0.1", "::1"].includes(resolvedDev.host)) {
+  if ((options.androidDevice || options.iosDevice && detectAbsoluteMobileHost() === "macos") && ["localhost", "127.0.0.1", "::1"].includes(resolvedDev.host)) {
     resolvedDev.host = "0.0.0.0";
   }
-  if (httpsEnabled)
-    devCertificateAuthorityPath = await setupHttpsCert(options.androidDevice ? [mobileReachableHost(resolvedDev.host)] : [resolvedDev.host]);
-  if (options.androidDevice && !mobileConfig) {
-    throw new TypeError("--android-device requires an absolute.config.ts mobile configuration.");
+  if ((options.androidDevice || options.iosDevice) && !mobileConfig) {
+    throw new TypeError("Physical-device development requires an absolute.config.ts mobile configuration.");
   }
   if (options.androidDevice && mobileConfig?.platforms && !mobileConfig.platforms.includes("android")) {
     throw new TypeError("--android-device requires android in mobile.platforms.");
   }
+  if (options.iosDevice && mobileConfig?.platforms && !mobileConfig.platforms.includes("ios")) {
+    throw new TypeError("--ios-device requires ios in mobile.platforms.");
+  }
+  if (options.iosDevice) {
+    if (detectAbsoluteMobileHost() === "macos")
+      iosPhysicalServerHost = mobileReachableHost(resolvedDev.host);
+    else {
+      selectedRemoteMacProfile = await getAbsoluteRemoteMacProfile();
+      if (!selectedRemoteMacProfile)
+        throw new Error("--ios-device requires macOS or a paired Remote Mac.");
+      iosPhysicalServerHost = await inspectAbsoluteRemoteMacLanHost(selectedRemoteMacProfile);
+    }
+  }
+  if (httpsEnabled) {
+    const certificateHosts = [
+      ...options.androidDevice ? [mobileReachableHost(resolvedDev.host)] : [],
+      ...iosPhysicalServerHost ? [iosPhysicalServerHost] : []
+    ];
+    devCertificateAuthorityPath = await setupHttpsCert(certificateHosts.length > 0 ? certificateHosts : [resolvedDev.host]);
+  }
   let androidDevProject = null;
   let iosDevProject = null;
   const mobileInteractive = options.mobile !== false && process.env.ABSOLUTE_NO_MOBILE !== "1" && process.stdin.isTTY === true && process.stdout.isTTY === true;
@@ -21275,9 +21860,9 @@ var dev = async (serverEntry, configPath2, options = {}) => {
       }
       if (normalized.platforms.includes("ios")) {
         if (detectAbsoluteMobileHost() !== "macos") {
-          const remote = await getAbsoluteRemoteMacProfile();
+          const remote = selectedRemoteMacProfile ?? await getAbsoluteRemoteMacProfile();
           if (!remote) {
-            console.log(cliTag("\x1B[33m", "iOS simulator skipped. Pair a Mac with `absolute mobile pair mac <name> <user@host>`."));
+            console.log(cliTag("\x1B[33m", "iOS target skipped. Pair a Mac with `absolute mobile pair mac <name> <user@host>`."));
           } else {
             const nativeDirectory = join13(normalized.nativeProjectDirectory, "ios");
             if (!existsSync5(nativeDirectory)) {
@@ -21288,12 +21873,13 @@ var dev = async (serverEntry, configPath2, options = {}) => {
             }
           }
         } else {
-          let ready = iosToolchainReady(await inspectAbsoluteMobileToolchain());
+          const iosTarget = options.iosDevice ? "device" : "simulator";
+          let ready = iosToolchainReady(await inspectAbsoluteMobileToolchain(), iosTarget);
           if (!ready) {
-            const install = await confirmPrompt("iOS simulation is not configured. Install the missing simulator runtime now?");
+            const install = await confirmPrompt(options.iosDevice ? "Physical iOS development is not configured. Open the guided Xcode setup now?" : "iOS simulation is not configured. Install the missing simulator runtime now?");
             if (install) {
               await fixAbsoluteMobileEmulatorToolchain("ios");
-              ready = iosToolchainReady(await inspectAbsoluteMobileToolchain());
+              ready = iosToolchainReady(await inspectAbsoluteMobileToolchain(), iosTarget);
             } else {
               console.log(cliTag("\x1B[33m", "Mobile simulator skipped. Run `absolute mobile doctor ios --fix` when ready."));
             }
@@ -21307,7 +21893,8 @@ var dev = async (serverEntry, configPath2, options = {}) => {
             if (existsSync5(nativeDirectory) || createNativeProject) {
               iosDevProject = await prepareAbsoluteIosDevProject(normalized, {
                 createNativeProject,
-                projectRoot: process.cwd()
+                projectRoot: process.cwd(),
+                target: iosTarget
               });
             }
           }
@@ -21351,7 +21938,8 @@ var dev = async (serverEntry, configPath2, options = {}) => {
     serverEntry,
     ...configPath2 ? ["--config", configPath2] : [],
     ...options.mobile === false ? ["--no-mobile"] : [],
-    ...options.androidDevice ? ["--android-device", options.androidDevice] : []
+    ...options.androidDevice ? ["--android-device", options.androidDevice] : [],
+    ...options.iosDevice ? ["--ios-device", options.iosDevice] : []
   ].filter((part) => part.length > 0);
   registerInstance({
     command: relaunchCommand,
@@ -21361,6 +21949,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,
@@ -21523,6 +22112,7 @@ var dev = async (serverEntry, configPath2, options = {}) => {
       platform: "ios",
       provider: "capacitor",
       startedSimulator: session.startedSimulator,
+      target: session.targetKind,
       timings: session.timings
     });
     if (session.timings.building === undefined)
@@ -21533,14 +22123,17 @@ var dev = async (serverEntry, configPath2, options = {}) => {
       installMs: session.timings.installing,
       platform: "ios",
       provider: "capacitor",
-      success: true
+      success: true,
+      target: session.targetKind
     });
   };
   const openIosDevSession = (iosProject) => {
     const sessionOptions = {
       certificateAuthorityPath: devCertificateAuthorityPath ?? undefined,
+      deviceIdentifier: options.iosDevice,
       https: httpsEnabled,
       port,
+      serverHost: iosPhysicalServerHost,
       signal: iosDevAbort.signal,
       log: (message) => printNativeOutput(cliTag("\x1B[35m", message)),
       nativeLog: (entry) => printNativeOutput(iosLogTag(entry)),
@@ -21554,7 +22147,7 @@ var dev = async (serverEntry, configPath2, options = {}) => {
         iosDevState = state;
         if (state === "ready" || state === "closed")
           return;
-        printNativeOutput(cliTag("\x1B[35m", `iOS simulator: ${state}.`));
+        printNativeOutput(cliTag("\x1B[35m", `iOS ${options.iosDevice ? "device" : "simulator"}: ${state}.`));
       }
     };
     if (iosProject.remote)
@@ -21593,6 +22186,7 @@ var dev = async (serverEntry, configPath2, options = {}) => {
           provider: "capacitor",
           rootInputChanged: change.rootInputChanged,
           success: true,
+          target: replacement.targetKind,
           timings: replacement.timings
         });
       },
@@ -21603,7 +22197,8 @@ var dev = async (serverEntry, configPath2, options = {}) => {
           host: iosTelemetryHost(iosProject),
           platform: "ios",
           provider: "capacitor",
-          success: false
+          success: false,
+          target: options.iosDevice ? "device" : "simulator"
         });
       }
     });
@@ -21630,9 +22225,10 @@ var dev = async (serverEntry, configPath2, options = {}) => {
         phase: iosDevState,
         platform: "ios",
         provider: "capacitor",
+        target: options.iosDevice ? "device" : "simulator",
         timings: iosPhaseTimings
       });
-      console.error(cliTag("\x1B[31m", `iOS simulator failed: ${error instanceof Error ? error.message : String(error)}`));
+      console.error(cliTag("\x1B[31m", `iOS ${options.iosDevice ? "device" : "simulator"} failed: ${error instanceof Error ? error.message : String(error)}`));
     }).finally(() => {
       iosDevStart = null;
     });
@@ -23982,16 +24578,24 @@ if (command === "dev") {
   sendTelemetryEvent("cli:command", { command });
   const configPath2 = parseNamedArg("--config");
   const androidDevice = parseNamedArg("--android-device");
+  const iosDevice = parseNamedArg("--ios-device");
   if (args.includes("--android-device") && !androidDevice) {
     throw new TypeError("--android-device requires an ADB device serial.");
   }
   if (androidDevice && args.includes("--no-mobile")) {
     throw new TypeError("--android-device cannot be combined with --no-mobile.");
   }
-  const positionalArgs2 = stripNamedArgs("--config", "--android-device").filter((arg) => arg !== "--no-mobile");
+  if (args.includes("--ios-device") && !iosDevice) {
+    throw new TypeError("--ios-device requires an Xcode device identifier or name.");
+  }
+  if (iosDevice && args.includes("--no-mobile")) {
+    throw new TypeError("--ios-device cannot be combined with --no-mobile.");
+  }
+  const positionalArgs2 = stripNamedArgs("--config", "--android-device", "--ios-device").filter((arg) => arg !== "--no-mobile");
   const serverEntry = positionalArgs2[0] ?? DEFAULT_SERVER_ENTRY;
   await dev(serverEntry, configPath2, {
     androidDevice,
+    iosDevice,
     mobile: !args.includes("--no-mobile")
   });
 } else if (command === "start") {
@@ -24150,13 +24754,13 @@ if (command === "dev") {
   console.error(message);
   console.error("Usage: absolute <command>");
   console.error("Commands:");
-  console.error("  dev [entry] [--no-mobile] [--android-device serial] Start web and configured mobile development");
+  console.error("  dev [entry] [--no-mobile] [--android-device serial] [--ios-device identifier] Start web and configured mobile development");
   console.error("  workspace dev [--no-tui] Start multi-service workspace dev");
   console.error("  build [--outdir dir] [--profile] Build production assets");
   console.error("  prepare [entry] [--outdir dir] Build production assets and server without launching");
   console.error("  start [entry] [--outdir dir] [--prebuilt] Start production server");
   console.error("  compile [entry] [--outdir dir] [--outfile path] Compile standalone executable");
-  console.error("  mobile <init|sync|pair|remotes|doctor|test> Manage Capacitor projects, local or remote simulators, guided setup, and deep links");
+  console.error("  mobile <init|sync|pair|remotes|doctor|test> Manage Capacitor projects, simulators, physical devices, Remote Macs, guided setup, and deep links");
   console.error("  config [--port n] Open the unified config UI (ESLint, tsconfig, Prettier)");
   console.error("  db <backup|restore|seed> Backup/restore any Postgres DB (ORM-agnostic, upsert by PK) or run the seed script");
   console.error("  doctor [--fix] [--json] Diagnose the project (bun, type graph, config, framework dirs, env, port)");