xcodebuild-axi 0.1.10 → 0.1.12

package/dist/src/commands/sim.d.ts

@@ -1,3 +1,21 @@
-export declare const SIM_HELP = "usage: xcodebuild-axi sim [list|boot|shutdown|erase] [name|udid] [flags]\nInspects and drives simulators. With no subcommand, lists the booted ones.\nsubcommands[4]:\n  list                 every available simulator\n  boot <name|udid>     boot one, or no-op if it is already booted\n  shutdown <name|udid> shut one down, or no-op if it already is; --all for every booted one\n  erase <name|udid>    erase one back to factory state; --all for every shut-down one\nflags[3]:\n  --runtime <name>     filter the list, e.g. \"iOS 26.5\"\n  --booted             list only booted simulators\n  --all                apply shutdown or erase to every eligible simulator\nexamples:\n  xcodebuild-axi sim\n  xcodebuild-axi sim list --runtime \"iOS 26.5\"\n  xcodebuild-axi sim boot \"iPhone 17 Pro\"\n  xcodebuild-axi sim shutdown --all\n";
-export declare const SIM_FLAGS: readonly ["--runtime", "--booted", "--all"];
+import { type InstalledApp } from "../simctl.js";
+export declare const SIM_HELP = "usage: xcodebuild-axi sim [subcommand] [name|udid] [app] [flags]\nInspects and drives simulators. With no subcommand, lists the booted ones.\nsubcommands[18]:\n  list                 every available simulator\n  boot <name|udid>     boot one, or no-op if it is already booted\n  shutdown <name|udid> shut one down, or no-op if it already is; --all for every booted one\n  erase <name|udid>    erase one back to factory state; --all for every shut-down one\n  apps <name|udid>     the apps installed on it; --system to include Apple's\n  install <name|udid> [path.app]   install an app; without a path, the one\n                       this project builds for that simulator\n  launch <name|udid> [bundle-id]   launch it; without an id, this project's\n  terminate <name|udid> [bundle-id] stop it, or no-op if it is not running\n  uninstall <name|udid> [bundle-id] remove it\n  create <name> <model>  create a device; --runtime picks the OS\n  delete <name|udid>   delete one; --unavailable for every orphaned device\n  screenshot <name|udid> [path]    save a PNG of its screen\n  video <name|udid> [path]         record its screen; --seconds sets how long\n  open <name|udid> <url>           open a URL on it, deep links included\n  privacy <name|udid> <grant|revoke|reset> <service> [bundle-id]\n                       answer a permission prompt before it appears\n  push <name|udid> [bundle-id] [payload.json]\n                       send a push; --message writes the payload for you\n  status-bar <name|udid> [pin|clear]  freeze the status bar for a screenshot\n  ui <name|udid> [light|dark|<setting> <value>]  read or set appearance,\n                       contrast and content size\nflags[14]:\n  --runtime <name>     filter the list, e.g. \"iOS 26.5\"\n  --booted             list only booted simulators\n  --all                apply shutdown or erase to every eligible simulator\n  --system             include Apple's own apps in `apps`\n  --scheme <name>      which scheme's app to install or launch\n  --relaunch           with launch: stop a running copy first\n  --unavailable        with delete: every device whose runtime is gone\n  --seconds <n>        with video: how long to record (default: 10)\n  --yes                required to delete every simulator at once\n  --message <text>     with push: the alert body to send\n  --title <text>       with push: the alert title\n  --time <string>      with status-bar: the clock, e.g. \"9:41\"\n  --battery <0-100>    with status-bar: the battery level\n  --bars <0-4>         with status-bar: wifi and cellular signal strength\nnote:\n  install, launch, terminate and uninstall take the app as a path or a bundle\n  id, and work it out from the project in the current directory when it is\n  left off \u2014 the point of them is the loop from a build to a running app, and\n  a DerivedData path is not something worth typing.\nexamples:\n  xcodebuild-axi sim\n  xcodebuild-axi sim list --runtime \"iOS 26.5\"\n  xcodebuild-axi sim boot \"iPhone 17 Pro\"\n  xcodebuild-axi sim install \"iPhone 17 Pro\"\n  xcodebuild-axi sim launch \"iPhone 17 Pro\" --relaunch\n  xcodebuild-axi sim apps \"iPhone 17 Pro\"\n  xcodebuild-axi sim screenshot \"iPhone 17 Pro\"\n  xcodebuild-axi sim create \"Test iPhone\" \"iPhone 17 Pro\" --runtime \"iOS 26.5\"\n  xcodebuild-axi sim open \"iPhone 17 Pro\" myapp://checkout\n  xcodebuild-axi sim privacy \"iPhone 17 Pro\" grant photos\n  xcodebuild-axi sim status-bar \"iPhone 17 Pro\" pin\n  xcodebuild-axi sim ui \"iPhone 17 Pro\" dark\n";
+export declare const SIM_FLAGS: readonly ["--runtime", "--booted", "--all", "--system", "--scheme", "--relaunch", "--unavailable", "--seconds", "--yes", "--message", "--title", "--time", "--battery", "--bars"];
 export declare function simCommand(args: string[]): Promise<string>;
+export declare function appRow(app: InstalledApp): Record<string, unknown>;
+/** A payload is the argument with a path in it; a bundle id is the other one. */
+export declare function isPayloadPath(value: string): boolean;
+/**
+ * `sim ui <device> dark` rather than `sim ui <device> appearance dark`: the
+ * setting is unambiguous from the value, and the short form is the one anyone
+ * types. Everything else names the setting first, the way simctl does.
+ */
+export declare function uiSetting(setting: string, value: string | undefined): [string, string | undefined];
+/**
+ * simctl reports its overrides as prose — one line per group, several
+ * `Key: Value` pairs to a line. Flattening them into fields is what makes the
+ * answer readable next to the flags that set them.
+ */
+export declare function statusRows(stdout: string): Record<string, string | number>;
+/** The individual overrides, for the cases `pin` does not cover. */
+export declare function statusOverrides(args: string[]): string[];