@appium/coresim 1.0.0

package/lib/src/commands/misc.d.ts

@@ -0,0 +1,15 @@
+import type { NativeSimctl } from '../native-simctl.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        shake(udid: string): Promise<void>;
+    }
+}
+/**
+ * Simulates a shake gesture (e.g. to trigger "Shake to Undo" or a shake-triggered debug menu) —
+ * the same Darwin notification (see darwin-notification.ts) Simulator.app's own Device > Shake
+ * menu item posts.
+ *
+ * @param udid — UDID of the target device
+ */
+export declare function shake(this: NativeSimctl, udid: string): Promise<void>;
+//# sourceMappingURL=misc.d.ts.map

package/lib/src/commands/misc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../../src/commands/misc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAEtD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACpC;CACF;AAID;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E"}

package/lib/src/commands/misc.js

@@ -0,0 +1,12 @@
+const SHAKE_NOTIFICATION_NAME = 'com.apple.UIKit.SimulatorShake';
+/**
+ * Simulates a shake gesture (e.g. to trigger "Shake to Undo" or a shake-triggered debug menu) —
+ * the same Darwin notification (see darwin-notification.ts) Simulator.app's own Device > Shake
+ * menu item posts.
+ *
+ * @param udid — UDID of the target device
+ */
+export async function shake(udid) {
+    await this.postDarwinNotification(udid, SHAKE_NOTIFICATION_NAME);
+}
+//# sourceMappingURL=misc.js.map

package/lib/src/commands/misc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../../src/commands/misc.ts"],"names":[],"mappings":"AAQA,MAAM,uBAAuB,GAAG,gCAAgC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAqB,IAAY;IAC1D,MAAM,IAAI,CAAC,sBAAsB,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;AACnE,CAAC"}

package/lib/src/commands/pasteboard.d.ts

@@ -0,0 +1,24 @@
+import type { NativeSimctl } from '../native-simctl.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        getPasteboard(udid: string): Promise<string>;
+        setPasteboard(udid: string, content: string): Promise<void>;
+    }
+}
+/**
+ * Reads the device's current pasteboard content — the native equivalent of `simctl pbpaste`
+ * (see native/sim_pasteboard.mm for which private CoreSimulator API this uses). Rejects with
+ * `NativeSimUnavailableError` if neither is present.
+ *
+ * @param udid — UDID of the device to read from; must be booted
+ * @returns the pasteboard's string content, or `""` if it holds no string-typed content
+ */
+export declare function getPasteboard(this: NativeSimctl, udid: string): Promise<string>;
+/**
+ * Sets the device's pasteboard content — the native equivalent of `simctl pbcopy`.
+ *
+ * @param udid — UDID of the target device; must be booted
+ * @param content — string content to set
+ */
+export declare function setPasteboard(this: NativeSimctl, udid: string, content: string): Promise<void>;
+//# sourceMappingURL=pasteboard.d.ts.map

package/lib/src/commands/pasteboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pasteboard.d.ts","sourceRoot":"","sources":["../../../src/commands/pasteboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAGtD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7D;CACF;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErF;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpG"}

package/lib/src/commands/pasteboard.js

@@ -0,0 +1,22 @@
+import { runCatchingAsync } from '../utils/index.js';
+/**
+ * Reads the device's current pasteboard content — the native equivalent of `simctl pbpaste`
+ * (see native/sim_pasteboard.mm for which private CoreSimulator API this uses). Rejects with
+ * `NativeSimUnavailableError` if neither is present.
+ *
+ * @param udid — UDID of the device to read from; must be booted
+ * @returns the pasteboard's string content, or `""` if it holds no string-typed content
+ */
+export async function getPasteboard(udid) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).getPasteboard());
+}
+/**
+ * Sets the device's pasteboard content — the native equivalent of `simctl pbcopy`.
+ *
+ * @param udid — UDID of the target device; must be booted
+ * @param content — string content to set
+ */
+export async function setPasteboard(udid, content) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).setPasteboard(content));
+}
+//# sourceMappingURL=pasteboard.js.map

package/lib/src/commands/pasteboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pasteboard.js","sourceRoot":"","sources":["../../../src/commands/pasteboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AASnD;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAqB,IAAY;IAClE,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAqB,IAAY,EAAE,OAAe;IACnF,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7F,CAAC"}

package/lib/src/commands/permissions.d.ts

@@ -0,0 +1,48 @@
+import type { NativeSimctl } from '../native-simctl.js';
+import type { SimPermissionService, SimPermissionStatus } from '../types.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        grantPermission(udid: string, service: SimPermissionService, bundleId: string): Promise<void>;
+        revokePermission(udid: string, service: SimPermissionService, bundleId: string): Promise<void>;
+        resetPermission(udid: string, service: SimPermissionService, bundleId: string): Promise<void>;
+        getPermission(udid: string, service: SimPermissionService, bundleId: string): Promise<SimPermissionStatus>;
+    }
+}
+/**
+ * Grants a privacy permission to the given app on the given device, by writing directly to the
+ * simulator's own TCC (privacy) database — see CLAUDE.md for why this bypasses CoreSimulator's own
+ * privacy API.
+ *
+ * @param udid — UDID of the target device
+ * @param service — permission to grant, e.g. `"camera"`, `"contacts"`, `"photos"`
+ * @param bundleId — bundle identifier of the app the permission applies to
+ */
+export declare function grantPermission(this: NativeSimctl, udid: string, service: SimPermissionService, bundleId: string): Promise<void>;
+/**
+ * Revokes a previously granted privacy permission from the given app.
+ *
+ * @param udid — UDID of the target device
+ * @param service — permission to revoke (see {@link grantPermission})
+ * @param bundleId — bundle identifier of the app the permission applies to
+ */
+export declare function revokePermission(this: NativeSimctl, udid: string, service: SimPermissionService, bundleId: string): Promise<void>;
+/**
+ * Resets a privacy permission for the given app to its default (unprompted) state.
+ *
+ * @param udid — UDID of the target device
+ * @param service — permission to reset (see {@link grantPermission})
+ * @param bundleId — bundle identifier of the app the permission applies to
+ */
+export declare function resetPermission(this: NativeSimctl, udid: string, service: SimPermissionService, bundleId: string): Promise<void>;
+/**
+ * Reads a privacy permission's current status directly from the simulator's own TCC database —
+ * there's no CoreSimulator getter for this, only the setters {@link grantPermission}/
+ * {@link revokePermission}/{@link resetPermission} write to (see CLAUDE.md).
+ *
+ * @param udid — UDID of the device to read from
+ * @param service — permission to check (see {@link grantPermission})
+ * @param bundleId — bundle identifier of the app the permission applies to
+ * @returns `'unset'` if the app has never been prompted/decided for this permission
+ */
+export declare function getPermission(this: NativeSimctl, udid: string, service: SimPermissionService, bundleId: string): Promise<SimPermissionStatus>;
+//# sourceMappingURL=permissions.d.ts.map

package/lib/src/commands/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/commands/permissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAC,oBAAoB,EAAE,mBAAmB,EAAC,MAAM,aAAa,CAAC;AAG3E,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9F,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/F,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9F,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;KAC5G;CACF;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAK9B"}

package/lib/src/commands/permissions.js

@@ -0,0 +1,84 @@
+import { runCatchingAsync } from '../utils/index.js';
+/**
+ * Grants a privacy permission to the given app on the given device, by writing directly to the
+ * simulator's own TCC (privacy) database — see CLAUDE.md for why this bypasses CoreSimulator's own
+ * privacy API.
+ *
+ * @param udid — UDID of the target device
+ * @param service — permission to grant, e.g. `"camera"`, `"contacts"`, `"photos"`
+ * @param bundleId — bundle identifier of the app the permission applies to
+ */
+export async function grantPermission(udid, service, bundleId) {
+    return runCatchingAsync(async () => {
+        const tccIdentifier = toTCCIdentifier(service);
+        return (await this._findDevice(udid)).grantPermission(tccIdentifier, bundleId);
+    });
+}
+/**
+ * Revokes a previously granted privacy permission from the given app.
+ *
+ * @param udid — UDID of the target device
+ * @param service — permission to revoke (see {@link grantPermission})
+ * @param bundleId — bundle identifier of the app the permission applies to
+ */
+export async function revokePermission(udid, service, bundleId) {
+    return runCatchingAsync(async () => {
+        const tccIdentifier = toTCCIdentifier(service);
+        return (await this._findDevice(udid)).revokePermission(tccIdentifier, bundleId);
+    });
+}
+/**
+ * Resets a privacy permission for the given app to its default (unprompted) state.
+ *
+ * @param udid — UDID of the target device
+ * @param service — permission to reset (see {@link grantPermission})
+ * @param bundleId — bundle identifier of the app the permission applies to
+ */
+export async function resetPermission(udid, service, bundleId) {
+    return runCatchingAsync(async () => {
+        const tccIdentifier = toTCCIdentifier(service);
+        return (await this._findDevice(udid)).resetPermission(tccIdentifier, bundleId);
+    });
+}
+/**
+ * Reads a privacy permission's current status directly from the simulator's own TCC database —
+ * there's no CoreSimulator getter for this, only the setters {@link grantPermission}/
+ * {@link revokePermission}/{@link resetPermission} write to (see CLAUDE.md).
+ *
+ * @param udid — UDID of the device to read from
+ * @param service — permission to check (see {@link grantPermission})
+ * @param bundleId — bundle identifier of the app the permission applies to
+ * @returns `'unset'` if the app has never been prompted/decided for this permission
+ */
+export async function getPermission(udid, service, bundleId) {
+    return runCatchingAsync(async () => {
+        const tccIdentifier = toTCCIdentifier(service);
+        return (await this._findDevice(udid)).getPermission(tccIdentifier, bundleId);
+    });
+}
+// Maps a friendly service name to the internal TCC service identifier its row in the simulator's
+// own TCC.db is keyed on (see native/tcc_privacy.h). `location` is deliberately absent: it isn't a
+// plain TCC row (CoreLocation simulation has its own subsystem), so it isn't supported by this
+// TCC.db-based implementation.
+const SERVICE_TO_TCC_IDENTIFIER = {
+    calendar: 'kTCCServiceCalendar',
+    camera: 'kTCCServiceCamera',
+    contacts: 'kTCCServiceAddressBook',
+    health: 'kTCCServiceMSO',
+    homekit: 'kTCCServiceWillow',
+    medialibrary: 'kTCCServiceMediaLibrary',
+    microphone: 'kTCCServiceMicrophone',
+    motion: 'kTCCServiceMotion',
+    photos: 'kTCCServicePhotos',
+    reminders: 'kTCCServiceReminders',
+    siri: 'kTCCServiceSiri',
+    speech: 'kTCCServiceSpeechRecognition',
+};
+function toTCCIdentifier(service) {
+    const identifier = SERVICE_TO_TCC_IDENTIFIER[service];
+    if (!identifier) {
+        throw new Error(`'${service}' is not a supported permission. Supported: ${Object.keys(SERVICE_TO_TCC_IDENTIFIER).join(', ')}`);
+    }
+    return identifier;
+}
+//# sourceMappingURL=permissions.js.map

package/lib/src/commands/permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.js","sourceRoot":"","sources":["../../../src/commands/permissions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AAWnD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAEnC,IAAY,EACZ,OAA6B,EAC7B,QAAgB;IAEhB,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAEpC,IAAY,EACZ,OAA6B,EAC7B,QAAgB;IAEhB,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,gBAAgB,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAEnC,IAAY,EACZ,OAA6B,EAC7B,QAAgB;IAEhB,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAEjC,IAAY,EACZ,OAA6B,EAC7B,QAAgB;IAEhB,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE;QACjC,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QAC/C,OAAO,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iGAAiG;AACjG,mGAAmG;AACnG,+FAA+F;AAC/F,+BAA+B;AAC/B,MAAM,yBAAyB,GAAyC;IACtE,QAAQ,EAAE,qBAAqB;IAC/B,MAAM,EAAE,mBAAmB;IAC3B,QAAQ,EAAE,wBAAwB;IAClC,MAAM,EAAE,gBAAgB;IACxB,OAAO,EAAE,mBAAmB;IAC5B,YAAY,EAAE,yBAAyB;IACvC,UAAU,EAAE,uBAAuB;IACnC,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,mBAAmB;IAC3B,SAAS,EAAE,sBAAsB;IACjC,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,8BAA8B;CACvC,CAAC;AAEF,SAAS,eAAe,CAAC,OAA6B;IACpD,MAAM,UAAU,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,IAAI,OAAO,+CAA+C,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9G,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/lib/src/commands/process.d.ts

@@ -0,0 +1,16 @@
+import type { NativeSimctl } from '../native-simctl.js';
+import type { SimProcessInfo } from '../types.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        listProcesses(udid: string): Promise<SimProcessInfo[]>;
+    }
+}
+/**
+ * Lists currently-running processes/launchd jobs on the given (booted) device, by spawning
+ * `launchctl list` inside it and parsing its `PID / Status / Label` output. A `-` PID column
+ * (registered but not running) is dropped; an app process's `name` is its bundle identifier.
+ *
+ * @param udid — UDID of the device to inspect; must be booted
+ */
+export declare function listProcesses(this: NativeSimctl, udid: string): Promise<SimProcessInfo[]>;
+//# sourceMappingURL=process.d.ts.map

package/lib/src/commands/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../src/commands/process.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,aAAa,CAAC;AAGhD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;KACxD;CACF;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA8C/F"}

package/lib/src/commands/process.js

@@ -0,0 +1,68 @@
+import { once } from 'node:events';
+import { runCatchingAsync } from '../utils/index.js';
+/**
+ * Lists currently-running processes/launchd jobs on the given (booted) device, by spawning
+ * `launchctl list` inside it and parsing its `PID / Status / Label` output. A `-` PID column
+ * (registered but not running) is dropped; an app process's `name` is its bundle identifier.
+ *
+ * @param udid — UDID of the device to inspect; must be booted
+ */
+export async function listProcesses(udid) {
+    return runCatchingAsync(async () => {
+        const device = await this._findDevice(udid);
+        // The guest runtime ships its own launchctl, distinct from the host's /bin/launchctl (see
+        // CLAUDE.md) — spawn() takes a literal path, so resolve it via RuntimeRoot ourselves.
+        const launchctlPath = `${device.runtimeRootPath()}/bin/launchctl`;
+        const proc = await this.spawnProcess(udid, launchctlPath, { arguments: [launchctlPath, 'list'] });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (chunk) => {
+            stdout += chunk;
+        });
+        proc.stderr.on('data', (chunk) => {
+            stderr += chunk;
+        });
+        // stdout/stderr are plain net.Sockets over raw fds — an unhandled 'error' on either would
+        // crash the whole process, not just reject this promise, so race it in as a real rejection.
+        const streamError = Promise.race([once(proc.stdout, 'error'), once(proc.stderr, 'error')]).then(([err]) => {
+            throw err;
+        });
+        // 'exit' can fire before the stdout stream has finished delivering its buffered data (see
+        // spawnProcess's own integration test) — wait for both before parsing.
+        const [[code, signal]] = await Promise.race([
+            Promise.all([once(proc, 'exit'), once(proc.stdout, 'end')]),
+            streamError,
+        ]);
+        if (code !== 0) {
+            const reason = signal ? `signal ${signal}` : `exit code ${code}`;
+            throw new Error(`'launchctl list' failed with ${reason}${stderr.trim() ? `: ${stderr.trim()}` : ''}`);
+        }
+        const result = [];
+        for (const line of stdout.split('\n')) {
+            const trimmedLine = line.trim();
+            if (!trimmedLine) {
+                continue;
+            }
+            const [pidText, , label] = trimmedLine.split(/\s+/);
+            const pid = Number.parseInt(pidText, 10);
+            if (!pid || !label) {
+                continue;
+            }
+            result.push({ pid, group: extractGroup(label), name: extractName(label) });
+        }
+        return result;
+    });
+}
+function extractGroup(label) {
+    const colonIdx = label.indexOf(':');
+    return colonIdx >= 0 ? label.slice(0, colonIdx) : null;
+}
+function extractName(label) {
+    let name = label.includes(':') ? label.slice(label.indexOf(':') + 1) : label;
+    const bracketIdx = name.indexOf('[');
+    if (bracketIdx >= 0) {
+        name = name.slice(0, bracketIdx);
+    }
+    return name;
+}
+//# sourceMappingURL=process.js.map

package/lib/src/commands/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../../src/commands/process.ts"],"names":[],"mappings":"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"}

package/lib/src/commands/screenshot.d.ts

@@ -0,0 +1,29 @@
+import type { NativeSimctl } from '../native-simctl.js';
+import type { ScreenshotOptions, SimDisplayInfo } from '../types.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        getScreenshot(udid: string, options?: ScreenshotOptions): Promise<Buffer>;
+        getDisplays(udid: string): Promise<SimDisplayInfo[]>;
+    }
+}
+/**
+ * Captures a device display as an image — the native equivalent of `simctl io <udid> screenshot`
+ * (see native/sim_screenshot.mm for how this reads the framebuffer directly, with no temp file or
+ * subprocess). Rejects if the resolved display has no renderable surface yet (e.g. not booted), or
+ * if `options.displayId` doesn't match any display from {@link getDisplays}.
+ *
+ * @param udid — UDID of the device to capture; must be booted
+ * @param options — `format` (defaults to `'png'`), `displayId` (defaults to the primary display),
+ * and `quality` (JPEG only, 0-100 percent)
+ * @returns image data encoded as `options.format`
+ */
+export declare function getScreenshot(this: NativeSimctl, udid: string, options?: ScreenshotOptions): Promise<Buffer>;
+/**
+ * Lists the device's renderable displays — the same information `simctl io <udid> enumerate`
+ * reports for its own `--display` selection. Most devices report exactly one (the primary
+ * display); a device with a secondary display (e.g. tvOS's TVOut) reports more than one.
+ *
+ * @param udid — UDID of the device to inspect; must be booted
+ */
+export declare function getDisplays(this: NativeSimctl, udid: string): Promise<SimDisplayInfo[]>;
+//# sourceMappingURL=screenshot.d.ts.map

package/lib/src/commands/screenshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../../src/commands/screenshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAC,iBAAiB,EAAE,cAAc,EAAC,MAAM,aAAa,CAAC;AAGnE,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1E,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;KACtD;CACF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAE7F"}

package/lib/src/commands/screenshot.js

@@ -0,0 +1,30 @@
+import { runCatchingAsync } from '../utils/index.js';
+/**
+ * Captures a device display as an image — the native equivalent of `simctl io <udid> screenshot`
+ * (see native/sim_screenshot.mm for how this reads the framebuffer directly, with no temp file or
+ * subprocess). Rejects if the resolved display has no renderable surface yet (e.g. not booted), or
+ * if `options.displayId` doesn't match any display from {@link getDisplays}.
+ *
+ * @param udid — UDID of the device to capture; must be booted
+ * @param options — `format` (defaults to `'png'`), `displayId` (defaults to the primary display),
+ * and `quality` (JPEG only, 0-100 percent)
+ * @returns image data encoded as `options.format`
+ */
+export async function getScreenshot(udid, options = {}) {
+    if (options.quality !== undefined &&
+        (!Number.isFinite(options.quality) || options.quality < 0 || options.quality > 100)) {
+        throw new RangeError(`quality must be a number between 0 and 100, got ${options.quality}`);
+    }
+    return runCatchingAsync(async () => (await this._findDevice(udid)).screenshot(options));
+}
+/**
+ * Lists the device's renderable displays — the same information `simctl io <udid> enumerate`
+ * reports for its own `--display` selection. Most devices report exactly one (the primary
+ * display); a device with a secondary display (e.g. tvOS's TVOut) reports more than one.
+ *
+ * @param udid — UDID of the device to inspect; must be booted
+ */
+export async function getDisplays(udid) {
+    return runCatchingAsync(async () => (await this._findDevice(udid)).getDisplays());
+}
+//# sourceMappingURL=screenshot.js.map

package/lib/src/commands/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","sourceRoot":"","sources":["../../../src/commands/screenshot.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,gBAAgB,EAAC,MAAM,mBAAmB,CAAC;AASnD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAEjC,IAAY,EACZ,UAA6B,EAAE;IAE/B,IACE,OAAO,CAAC,OAAO,KAAK,SAAS;QAC7B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,GAAG,GAAG,CAAC,EACnF,CAAC;QACD,MAAM,IAAI,UAAU,CAAC,mDAAmD,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAqB,IAAY;IAChE,OAAO,gBAAgB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AACpF,CAAC"}

package/lib/src/commands/spawn.d.ts

@@ -0,0 +1,48 @@
+import { EventEmitter } from 'node:events';
+import { Socket } from 'node:net';
+import type { NativeSimctl } from '../native-simctl.js';
+import type { SpawnOptions } from '../types.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        spawnProcess(udid: string, path: string, options?: SpawnOptions): Promise<SpawnedProcess>;
+    }
+}
+interface SpawnedProcessEvents {
+    exit: [code: number | null, signal: NodeJS.Signals | null];
+}
+/**
+ * A process spawned on a simulator device via `NativeSimctl.spawnProcess`. The simulator shares
+ * the host kernel and filesystem, so `pid` is a real host OS process id — {@link kill} just calls
+ * Node's own `process.kill()`, no native call needed. `stdout`/`stderr` stream live output as the
+ * process runs; `'exit'` fires exactly once, with a decoded `(code, signal)` pair mirroring
+ * `child_process.ChildProcess`'s own semantics (exactly one of the two is non-null).
+ */
+export declare class SpawnedProcess extends EventEmitter<SpawnedProcessEvents> {
+    readonly pid: number;
+    readonly stdout: Socket;
+    readonly stderr: Socket;
+    exitCode: number | null;
+    signalCode: NodeJS.Signals | null;
+    constructor(pid: number, stdoutFd: number, stderrFd: number);
+    /** Whether the process has neither exited nor been killed yet. */
+    get running(): boolean;
+    /**
+     * Sends a signal to the process — a thin wrapper over `process.kill()`. A no-op returning
+     * `false` once exit has already been observed, rather than risking `process.kill()` throwing
+     * `ESRCH` on an already-reaped pid or, worse, hitting an unrelated process if the pid has since
+     * been recycled by the OS.
+     */
+    kill(signal?: NodeJS.Signals | number): boolean;
+}
+/**
+ * Native equivalent of `simctl spawn`. Streams live stdout/stderr and eventually reports an
+ * exit code/signal — see {@link SpawnedProcess}.
+ *
+ * @param udid — UDID of the target device
+ * @param path — path to the executable to spawn; not auto-prepended to `options.arguments`
+ * @param options — see {@link SpawnOptions}
+ * @returns a handle to the spawned process
+ */
+export declare function spawnProcess(this: NativeSimctl, udid: string, path: string, options?: SpawnOptions): Promise<SpawnedProcess>;
+export {};
+//# sourceMappingURL=spawn.d.ts.map

package/lib/src/commands/spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.d.ts","sourceRoot":"","sources":["../../../src/commands/spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AACzC,OAAO,EAAC,MAAM,EAAC,MAAM,UAAU,CAAC;AAGhC,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAG9C,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;KAC3F;CACF;AAYD,UAAU,oBAAoB;IAC5B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC5D;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,YAAY,CAAC,oBAAoB,CAAC;IAOlE,QAAQ,CAAC,GAAG,EAAE,MAAM;IANtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC/B,UAAU,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI,CAAQ;gBAG9B,GAAG,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM;IAiBlB,kEAAkE;IAClE,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;OAKG;IACH,IAAI,CAAC,MAAM,GAAE,MAAM,CAAC,OAAO,GAAG,MAAkB,GAAG,OAAO;CAa3D;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,cAAc,CAAC,CA+BzB"}

package/lib/src/commands/spawn.js

@@ -0,0 +1,108 @@
+import { EventEmitter } from 'node:events';
+import { Socket } from 'node:net';
+import { constants as osConstants } from 'node:os';
+import { runCatchingAsync } from '../utils/index.js';
+// Some signal numbers have more than one name (e.g. SIGABRT/SIGIOT are both 6) — built with a
+// for-of rather than Object.fromEntries so the *first* name Node lists for a number wins instead
+// of whichever happens to be last, which would otherwise make an aborted process unpredictably
+// report as the obscure historical alias (confirmed: this reversed Object.fromEntries reported a
+// real SIGABRT as 'SIGIOT').
+const SIGNAL_NAME_BY_NUMBER = {};
+for (const [name, num] of Object.entries(osConstants.signals)) {
+    SIGNAL_NAME_BY_NUMBER[num] ??= name;
+}
+/**
+ * A process spawned on a simulator device via `NativeSimctl.spawnProcess`. The simulator shares
+ * the host kernel and filesystem, so `pid` is a real host OS process id — {@link kill} just calls
+ * Node's own `process.kill()`, no native call needed. `stdout`/`stderr` stream live output as the
+ * process runs; `'exit'` fires exactly once, with a decoded `(code, signal)` pair mirroring
+ * `child_process.ChildProcess`'s own semantics (exactly one of the two is non-null).
+ */
+export class SpawnedProcess extends EventEmitter {
+    pid;
+    stdout;
+    stderr;
+    exitCode = null;
+    signalCode = null;
+    constructor(pid, stdoutFd, stderrFd) {
+        super();
+        this.pid = pid;
+        // `net.Socket` (not `fs.createReadStream`) deliberately: these fds are blocking NSPipe read
+        // ends, and fs's reads always run as blocking syscalls on the shared libuv threadpool (default
+        // size 4) regardless of the fd's actual type — a single quiet process's idle stdout+stderr
+        // reads permanently occupy 2 of those 4 workers until output or EOF arrives, and two quiet
+        // processes exhaust the pool entirely, stalling unrelated fs work *and* this addon's own
+        // AsyncWorkers (confirmed empirically: an unrelated fs.readFile took 8+ seconds instead of
+        // ~1ms while two quiet spawned processes' output was being read this way). A pipe fd is
+        // recognized by libuv as a named-pipe handle regardless of whether it's an anonymous pipe(2),
+        // so wrapping it in a Socket gets real event-driven (kqueue/epoll) I/O instead, exactly like
+        // Node's own child_process does for a child's stdio pipes.
+        this.stdout = new Socket({ fd: stdoutFd, readable: true, writable: false });
+        this.stderr = new Socket({ fd: stderrFd, readable: true, writable: false });
+    }
+    /** Whether the process has neither exited nor been killed yet. */
+    get running() {
+        return this.exitCode === null && this.signalCode === null;
+    }
+    /**
+     * Sends a signal to the process — a thin wrapper over `process.kill()`. A no-op returning
+     * `false` once exit has already been observed, rather than risking `process.kill()` throwing
+     * `ESRCH` on an already-reaped pid or, worse, hitting an unrelated process if the pid has since
+     * been recycled by the OS.
+     */
+    kill(signal = 'SIGTERM') {
+        if (!this.running) {
+            return false;
+        }
+        return process.kill(this.pid, signal);
+    }
+    /** @internal Invoked once by NativeSimctl when the native termination callback fires. */
+    _handleExit(code, signal) {
+        this.exitCode = code;
+        this.signalCode = signal === null ? null : (SIGNAL_NAME_BY_NUMBER[signal] ?? null);
+        this.emit('exit', this.exitCode, this.signalCode);
+    }
+}
+/**
+ * Native equivalent of `simctl spawn`. Streams live stdout/stderr and eventually reports an
+ * exit code/signal — see {@link SpawnedProcess}.
+ *
+ * @param udid — UDID of the target device
+ * @param path — path to the executable to spawn; not auto-prepended to `options.arguments`
+ * @param options — see {@link SpawnOptions}
+ * @returns a handle to the spawned process
+ */
+export async function spawnProcess(udid, path, options = {}) {
+    return runCatchingAsync(async () => {
+        const device = await this._findDevice(udid);
+        // The native termination callback (delivered via a ThreadSafeFunction/GCD path) and
+        // device.spawn()'s own promise resolution (an AsyncWorker completion) are independent async
+        // signals with no guaranteed relative order — a process that exits almost immediately can have
+        // its termination callback fire before the promise below resolves and `proc` exists. Buffer the
+        // exit args in that case and deliver them once the handle is constructed, rather than assuming
+        // the callback always arrives second.
+        let proc;
+        let pendingExit;
+        const { pid, stdoutFd, stderrFd } = await device.spawn(path, options, (code, signal) => {
+            if (proc) {
+                proc._handleExit(code, signal);
+            }
+            else {
+                pendingExit = [code, signal];
+            }
+        });
+        proc = new SpawnedProcess(pid, stdoutFd, stderrFd);
+        if (pendingExit) {
+            // Delivering this synchronously would emit 'exit' before spawnProcess()'s own promise has
+            // even resolved — a caller doing `const proc = await sim.spawnProcess(...); proc.on('exit', ...)`
+            // would never see it, since its listener can't be attached until after that await returns.
+            // setImmediate defers past both promise-resolution microtasks and any synchronous listener
+            // setup that runs right after them, guaranteeing the listener is attached first.
+            const exitArgs = pendingExit;
+            const deliverTo = proc;
+            setImmediate(() => deliverTo._handleExit(...exitArgs));
+        }
+        return proc;
+    });
+}
+//# sourceMappingURL=spawn.js.map

package/lib/src/commands/spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn.js","sourceRoot":"","sources":["../../../src/commands/spawn.ts"],"names":[],"mappings":"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"}

package/lib/src/commands/ui.d.ts

@@ -0,0 +1,42 @@
+import type { NativeSimctl } from '../native-simctl.js';
+declare module '../native-simctl.js' {
+    interface NativeSimctl {
+        getAppearance(udid: string): Promise<number>;
+        setAppearance(udid: string, style: number): Promise<void>;
+        getIncreaseContrast(udid: string): Promise<number>;
+        setIncreaseContrast(udid: string, enabled: boolean): Promise<void>;
+        getContentSize(udid: string): Promise<number>;
+        setContentSize(udid: string, category: number): Promise<void>;
+    }
+}
+/**
+ * @param udid — UDID of the device to read from
+ * @returns the device's current UI appearance style, as a raw `UIUserInterfaceStyle` value
+ */
+export declare function getAppearance(this: NativeSimctl, udid: string): Promise<number>;
+/**
+ * @param udid — UDID of the target device
+ * @param style — a raw `UIUserInterfaceStyle` value to apply
+ */
+export declare function setAppearance(this: NativeSimctl, udid: string, style: number): Promise<void>;
+/**
+ * @param udid — UDID of the device to read from
+ * @returns the device's current Increase Contrast accessibility setting
+ */
+export declare function getIncreaseContrast(this: NativeSimctl, udid: string): Promise<number>;
+/**
+ * @param udid — UDID of the target device
+ * @param enabled — whether Increase Contrast should be enabled
+ */
+export declare function setIncreaseContrast(this: NativeSimctl, udid: string, enabled: boolean): Promise<void>;
+/**
+ * @param udid — UDID of the device to read from
+ * @returns the device's current Dynamic Type content size category
+ */
+export declare function getContentSize(this: NativeSimctl, udid: string): Promise<number>;
+/**
+ * @param udid — UDID of the target device
+ * @param category — the Dynamic Type content size category to apply
+ */
+export declare function setContentSize(this: NativeSimctl, udid: string, category: number): Promise<void>;
+//# sourceMappingURL=ui.d.ts.map

package/lib/src/commands/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/commands/ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,qBAAqB,CAAC;AAGtD,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,YAAY;QACpB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACnD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACnE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC9C,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC/D;CACF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErF;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAElG;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3F;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3G;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAEtF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtG"}