@kraken-e2e/driver-ios 1.0.0

package/dist/appium-server.d.ts

@@ -0,0 +1,23 @@
+import type { Logger } from '@kraken-e2e/contracts';
+/**
+ * Idempotent: refreshes symlinks every start (pnpm store paths move); version
+ * bumps change the generated package.json, which changes its md5 and triggers
+ * Appium's manifest re-sync.
+ */
+export declare function prepareAppiumHome(homeDir: string, driverPackages: readonly string[]): void;
+/** Allocates an OS-assigned free port (hazard 1: appium dies on EADDRINUSE). */
+export declare function allocatePort(): Promise<number>;
+export interface AppiumServerHandle {
+    readonly port: number;
+    close(): Promise<void>;
+}
+export interface StartServerOptions {
+    readonly homeDir: string;
+    readonly driverPackages: readonly string[];
+    readonly logFile: string;
+    readonly logger: Logger;
+    /** Appium 3 scoped syntax, e.g. 'uiautomator2:adb_shell'. */
+    readonly allowInsecure?: readonly string[];
+}
+export declare function startAppiumServer(options: StartServerOptions): Promise<AppiumServerHandle>;
+//# sourceMappingURL=appium-server.d.ts.map

package/dist/appium-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appium-server.d.ts","sourceRoot":"","sources":["../src/appium-server.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAWpD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAkC1F;AAED,gFAAgF;AAChF,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAapD;AAeD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+DhG"}

package/dist/appium-server.js

@@ -0,0 +1,144 @@
+/**
+ * Embedded Appium server lifecycle (ADR-0008, mechanism live-verified against
+ * appium@3.5.2):
+ *
+ * SYNTHESIZED PROJECT-MODE HOME — we generate an APPIUM_HOME whose
+ * package.json declares the EXACT appium+driver versions resolved from THIS
+ * package's own dependency tree (lockfile-governed, ADR-0001 §5.10) and
+ * symlink the resolved packages into its node_modules. Appium's project-mode
+ * manifest auto-discovers them; no `appium driver install` ever runs
+ * (`--source=local` is verified broken: it shells to `npm link`, which fires
+ * the drivers' `prepare` scripts and fails on published tarballs).
+ *
+ * Live-verified hazards handled here:
+ * - EADDRINUSE calls process.exit(1) even with throwInsteadOfExit → we
+ *   allocate the port ourselves immediately before boot.
+ * - main() installs its own SIGINT/SIGTERM handlers that process.exit(0) →
+ *   we strip them so the Kraken CLI owns signals (ADR-0001 §5.11).
+ */
+import { mkdirSync, renameSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { createServer } from 'node:net';
+import { dirname, join } from 'node:path';
+import { KrakenError } from '@kraken-e2e/contracts';
+const require_ = createRequire(import.meta.url);
+function resolvedPackage(name) {
+    const packageJsonPath = require_.resolve(`${name}/package.json`);
+    const { version } = require_(packageJsonPath);
+    return { dir: dirname(packageJsonPath), version };
+}
+/**
+ * Idempotent: refreshes symlinks every start (pnpm store paths move); version
+ * bumps change the generated package.json, which changes its md5 and triggers
+ * Appium's manifest re-sync.
+ */
+export function prepareAppiumHome(homeDir, driverPackages) {
+    const nodeModules = join(homeDir, 'node_modules');
+    mkdirSync(nodeModules, { recursive: true });
+    const appium = resolvedPackage('appium');
+    const dependencies = { appium: appium.version };
+    for (const name of [...driverPackages, 'appium']) {
+        const resolved = name === 'appium' ? appium : resolvedPackage(name);
+        if (name !== 'appium')
+            dependencies[name] = resolved.version;
+        const linkPath = join(nodeModules, name);
+        mkdirSync(dirname(linkPath), { recursive: true });
+        // Concurrent-run-safe replace: symlink to a temp name, rename over the
+        // target (atomic on POSIX) — a plain rm+symlink pair races a sibling run.
+        const tempLink = `${linkPath}.tmp-${process.pid}`;
+        rmSync(tempLink, { force: true });
+        symlinkSync(resolved.dir, tempLink, 'dir');
+        rmSync(linkPath, { recursive: true, force: true });
+        renameSync(tempLink, linkPath);
+    }
+    writeFileSync(join(homeDir, 'package.json'), `${JSON.stringify({
+        name: 'kraken-appium-home',
+        private: true,
+        description: 'Generated by Kraken — appium project-mode home (ADR-0008). Do not edit.',
+        dependencies,
+    }, null, 2)}\n`);
+}
+/** Allocates an OS-assigned free port (hazard 1: appium dies on EADDRINUSE). */
+export async function allocatePort() {
+    return new Promise((resolve, reject) => {
+        const probe = createServer();
+        probe.once('error', reject);
+        probe.listen(0, '127.0.0.1', () => {
+            const address = probe.address();
+            const port = typeof address === 'object' && address !== null ? address.port : undefined;
+            probe.close(() => {
+                if (port === undefined)
+                    reject(new Error('could not allocate a port'));
+                else
+                    resolve(port);
+            });
+        });
+    });
+}
+function stripAddedSignalHandlers(before) {
+    for (const signal of ['SIGINT', 'SIGTERM']) {
+        for (const listener of process.listeners(signal)) {
+            if (!before[signal].includes(listener)) {
+                process.removeListener(signal, listener);
+            }
+        }
+    }
+}
+export async function startAppiumServer(options) {
+    prepareAppiumHome(options.homeDir, options.driverPackages);
+    mkdirSync(dirname(options.logFile), { recursive: true });
+    // Import-safety rule (ADR-0001 §5.5): appium loads HERE, never at top level.
+    // Non-literal specifier: appium ships raw .ts type sources that explode under
+    // strict verbatimModuleSyntax; we type the surface we use by hand instead.
+    const appiumSpecifier = 'appium';
+    // The package is CJS — named ESM imports fail; use the default namespace.
+    const appiumModule = (await import(appiumSpecifier));
+    const main = appiumModule.default?.main ?? appiumModule.main;
+    if (!main) {
+        throw new KrakenError('KRK-DRIVER-START-FAILED', 'appium package has no main() export.');
+    }
+    // Allocate AFTER the (slow, seconds-cold) appium import so the port-reuse
+    // race window stays microseconds — appium process.exit(1)s on EADDRINUSE.
+    const port = await allocatePort();
+    // Hazard 2: strip the SIGINT/SIGTERM handlers main() installs.
+    const before = {
+        SIGINT: process.listeners('SIGINT'),
+        SIGTERM: process.listeners('SIGTERM'),
+    };
+    options.logger.info('starting embedded Appium server', {
+        port,
+        home: options.homeDir,
+        logFile: options.logFile,
+    });
+    let server;
+    try {
+        server = (await main({
+            subcommand: 'server',
+            port,
+            address: '127.0.0.1',
+            appiumHome: options.homeDir,
+            throwInsteadOfExit: true,
+            // Quiet console (the TUI owns stdout), full debug into the log file.
+            loglevel: 'error:debug',
+            logFile: options.logFile,
+            ...(options.allowInsecure !== undefined ? { allowInsecure: [...options.allowInsecure] } : {}),
+        }));
+    }
+    catch (cause) {
+        stripAddedSignalHandlers(before);
+        throw KrakenError.wrap(cause, 'KRK-DRIVER-START-FAILED', 'embedded Appium failed to start');
+    }
+    // Appium registers its handlers in a continuation AFTER main() resolves
+    // (live-verified) — wait one macrotask before stripping.
+    await new Promise((resolve) => setImmediate(resolve));
+    stripAddedSignalHandlers(before);
+    options.logger.info('Appium server ready', { port });
+    return {
+        port,
+        close: async () => {
+            await server.close();
+            options.logger.info('Appium server stopped', { port });
+        },
+    };
+}
+//# sourceMappingURL=appium-server.js.map

package/dist/appium-server.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,15 @@
+import type { DoctorCheck } from '@kraken-e2e/contracts';
+/** Injectable so doctor checks are unit-testable without Xcode. */
+export type CommandRunner = (command: string, args: readonly string[]) => {
+    status: number | null;
+    stdout: string;
+};
+export declare const spawnRunner: CommandRunner;
+/**
+ * Kraken-specific iOS checks (ADR-0001 §5.13). These only ever run on macOS —
+ * on other hosts the driver is host-gated off before checks are collected.
+ * The classic student trap is covered explicitly: a fresh Xcode passes binary
+ * checks yet has ZERO simulator runtimes (separate downloads since Xcode 14).
+ */
+export declare function iosDoctorChecks(run?: CommandRunner): readonly DoctorCheck[];
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,CAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,KACpB;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/C,eAAO,MAAM,WAAW,EAAE,aAGzB,CAAC;AAKF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,aAA2B,GAAG,SAAS,WAAW,EAAE,CAwExF"}

package/dist/doctor.js

@@ -0,0 +1,86 @@
+import { spawnSync } from 'node:child_process';
+export const spawnRunner = (command, args) => {
+    const result = spawnSync(command, [...args], { encoding: 'utf8', timeout: 30_000 });
+    return { status: result.status, stdout: `${result.stdout ?? ''}${result.stderr ?? ''}` };
+};
+/** Xcode majors fully supported by appium-xcuitest-driver 11.x (ADR-0001 §4). */
+const SUPPORTED_XCODE_MAJORS = [16, 26];
+/**
+ * Kraken-specific iOS checks (ADR-0001 §5.13). These only ever run on macOS —
+ * on other hosts the driver is host-gated off before checks are collected.
+ * The classic student trap is covered explicitly: a fresh Xcode passes binary
+ * checks yet has ZERO simulator runtimes (separate downloads since Xcode 14).
+ */
+export function iosDoctorChecks(run = spawnRunner) {
+    return [
+        {
+            id: 'ios.xcode',
+            title: `Xcode present and inside the xcuitest-driver support window (${SUPPORTED_XCODE_MAJORS.join('.x / ')}.x)`,
+            run: async () => {
+                const selected = run('xcode-select', ['-p']);
+                if (selected.status !== 0) {
+                    return {
+                        status: 'fail',
+                        detail: 'no developer directory selected',
+                        fix: 'Install Xcode from the App Store, then: sudo xcode-select -s /Applications/Xcode.app/Contents/Developer',
+                    };
+                }
+                const version = run('xcodebuild', ['-version']);
+                const major = Number.parseInt(/Xcode\s+(\d+)/.exec(version.stdout)?.[1] ?? '0', 10);
+                if (version.status !== 0 || major === 0) {
+                    return {
+                        status: 'fail',
+                        detail: 'xcodebuild did not run',
+                        fix: 'Open Xcode once to finish first-launch setup, then re-run kraken doctor.',
+                    };
+                }
+                if (!SUPPORTED_XCODE_MAJORS.includes(major)) {
+                    return {
+                        status: major < 16 ? 'fail' : 'warn',
+                        detail: `Xcode ${major} found`,
+                        fix: `appium-xcuitest-driver 11.x fully supports the latest two Xcode majors ` +
+                            `(${SUPPORTED_XCODE_MAJORS.join(', ')}). Upgrade/downgrade Xcode or expect breakage — ` +
+                            'this window moves every September (ADR-0001 §8.3).',
+                    };
+                }
+                return { status: 'ok', detail: version.stdout.split('\n')[0] ?? `Xcode ${major}` };
+            },
+        },
+        {
+            id: 'ios.simulator-runtimes',
+            title: 'An iOS simulator runtime is installed (separate download since Xcode 14)',
+            run: async () => {
+                const result = run('xcrun', ['simctl', 'list', 'runtimes']);
+                const runtimes = result.stdout.split('\n').filter((line) => line.trim().startsWith('iOS '));
+                if (result.status !== 0 || runtimes.length === 0) {
+                    return {
+                        status: 'fail',
+                        detail: 'no iOS simulator runtime found',
+                        fix: 'Download one: xcodebuild -downloadPlatform iOS (or Xcode → Settings → Components). A fresh Xcode install ships with ZERO runtimes.',
+                    };
+                }
+                return {
+                    status: 'ok',
+                    detail: runtimes.map((line) => line.trim().split(' (')[0]).join(', '),
+                };
+            },
+        },
+        {
+            id: 'ios.simulators',
+            title: 'At least one iPhone simulator is available',
+            run: async () => {
+                const result = run('xcrun', ['simctl', 'list', 'devices', 'available']);
+                const iphones = result.stdout.split('\n').filter((line) => line.includes('iPhone'));
+                if (result.status !== 0 || iphones.length === 0) {
+                    return {
+                        status: 'fail',
+                        detail: 'no available iPhone simulators',
+                        fix: 'Create one: xcrun simctl create "iPhone 16" (or Xcode → Devices and Simulators).',
+                    };
+                }
+                return { status: 'ok', detail: `${iphones.length} iPhone simulator(s) available` };
+            },
+        },
+    ];
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export interface IosDriverOptions {
+    /** Default simulator for actors without a device (appium:deviceName). */
+    readonly deviceName?: string;
+    /** Default appium:platformVersion (e.g. '18.6'). */
+    readonly platformVersion?: string;
+    /**
+     * Prebuilt WebDriverAgent .app for simulators (appium:prebuiltWDAPath +
+     * usePreinstalledWDA — requires iOS 17+). Skips the slow first-session
+     * xcodebuild. Fetch one with: appium driver run xcuitest download-wda.
+     */
+    readonly prebuiltWDAPath?: string;
+    /** Appium 3 scoped insecure features. */
+    readonly allowInsecure?: readonly string[];
+    /** Extra capabilities merged into every session. */
+    readonly capabilities?: Readonly<Record<string, unknown>>;
+}
+export declare const ios: (opts?: IosDriverOptions | undefined) => import("@kraken-e2e/contracts").KrakenDriver<IosDriverOptions>;
+export default ios;
+export { allocatePort, prepareAppiumHome, startAppiumServer } from './appium-server.js';
+export { iosDoctorChecks } from './doctor.js';
+export { toIosSelector } from './locators.js';
+export { manifest } from './manifest.js';
+export { IosUserSession } from './wdio-session.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,yCAAyC;IACzC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,oDAAoD;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3D;AAED,eAAO,MAAM,GAAG,yGAqFd,CAAC;AAEH,eAAe,GAAG,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,97 @@
+/**
+ * @kraken-e2e/driver-ios — iOS driver (Appium 3 + XCUITest, ADR-0008).
+ *
+ * macOS-ONLY at runtime (Apple platform restriction — enforced by the
+ * registry via /manifest hostRequirements, C4b). IMPORT-SAFETY RULE
+ * (ADR-0001 §5.5): this entry must still be importable on every host —
+ * appium and webdriverio load DYNAMICALLY inside start()/createSession().
+ */
+import { join } from 'node:path';
+import { defineDriver } from '@kraken-e2e/contracts';
+import { allocatePort, startAppiumServer } from './appium-server.js';
+import { iosDoctorChecks } from './doctor.js';
+import { manifest } from './manifest.js';
+import { IosUserSession } from './wdio-session.js';
+export const ios = defineDriver((opts = {}) => {
+    let server;
+    return {
+        manifest,
+        doctor: iosDoctorChecks(),
+        async start(host, services) {
+            if (server) {
+                // Double start would silently leak the first embedded server.
+                throw new Error('driver-ios: already started — call stop() first.');
+            }
+            const projectRoot = host.projectRoot ?? process.cwd();
+            server = await startAppiumServer({
+                homeDir: join(projectRoot, '.kraken', 'appium', 'ios-home'),
+                driverPackages: ['appium-xcuitest-driver'],
+                logFile: join(services.artifactsDir, 'appium-ios.log'),
+                logger: services.logger,
+                ...(opts.allowInsecure !== undefined ? { allowInsecure: opts.allowInsecure } : {}),
+            });
+        },
+        async createSession(actor, services) {
+            if (!server) {
+                throw new Error('driver-ios: start() must run before createSession().');
+            }
+            const config = actor.config;
+            // OS-assigned free ports (see driver-android note: fixed-base counters
+            // collide across concurrent runs on one machine).
+            const wdaLocalPort = await allocatePort();
+            const mjpegServerPort = await allocatePort();
+            const prebuiltWDAPath = typeof config['prebuiltWDAPath'] === 'string'
+                ? config['prebuiltWDAPath']
+                : opts.prebuiltWDAPath;
+            const capabilities = {
+                platformName: 'iOS',
+                'appium:automationName': 'XCUITest',
+                'appium:wdaLocalPort': wdaLocalPort,
+                'appium:mjpegServerPort': mjpegServerPort,
+                'appium:newCommandTimeout': 300,
+                // First-session xcodebuild of WDA can take minutes on a laptop.
+                'appium:wdaLaunchTimeout': 120_000,
+                'appium:deviceName': config['deviceName'] ?? opts.deviceName ?? 'iPhone 16',
+                ...(typeof config['platformVersion'] === 'string' || opts.platformVersion !== undefined
+                    ? {
+                        'appium:platformVersion': config['platformVersion'] ?? opts.platformVersion,
+                    }
+                    : {}),
+                ...(typeof config['udid'] === 'string' ? { 'appium:udid': config['udid'] } : {}),
+                ...(typeof config['app'] === 'string' ? { 'appium:app': config['app'] } : {}),
+                ...(typeof config['bundleId'] === 'string'
+                    ? { 'appium:bundleId': config['bundleId'] }
+                    : {}),
+                ...(prebuiltWDAPath !== undefined
+                    ? { 'appium:usePreinstalledWDA': true, 'appium:prebuiltWDAPath': prebuiltWDAPath }
+                    : {}),
+                ...opts.capabilities,
+                ...(typeof config['capabilities'] === 'object' && config['capabilities'] !== null
+                    ? config['capabilities']
+                    : {}),
+            };
+            services.logger.info('creating iOS session', { actor: actor.id, wdaLocalPort });
+            const { remote } = await import('webdriverio');
+            const browser = await remote({
+                hostname: '127.0.0.1',
+                port: server.port,
+                capabilities: capabilities,
+                logLevel: 'error',
+                connectionRetryTimeout: 300_000,
+                connectionRetryCount: 1,
+            });
+            return new IosUserSession(browser, actor, services);
+        },
+        async stop() {
+            await server?.close();
+            server = undefined;
+        },
+    };
+});
+export default ios;
+export { allocatePort, prepareAppiumHome, startAppiumServer } from './appium-server.js';
+export { iosDoctorChecks } from './doctor.js';
+export { toIosSelector } from './locators.js';
+export { manifest } from './manifest.js';
+export { IosUserSession } from './wdio-session.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/locators.d.ts

@@ -0,0 +1,16 @@
+import type { TargetLocator } from '@kraken-e2e/contracts';
+/**
+ * Portable locator strategies → XCUITest selectors (ADR-0002 D1 mapping:
+ * testId → accessibility identifier, a11y → accessibility identifier,
+ * text → label/value predicate).
+ */
+export declare function toIosSelector(target: TargetLocator): string;
+/**
+ * HID keyboard usages (page 0x07) for the semantic keys — the FAITHFUL iOS
+ * implementation (contract 2.0), live-verified on iOS 18.6: Return commits
+ * and dismisses the keyboard, Escape performs UIKit's hardware-Escape cancel,
+ * Tab behaves as hardware Tab. Injected device-level via WDA's
+ * performIoHidEvent — no hardware-keyboard setting required.
+ */
+export declare const IOS_HID_KEY_USAGES: Readonly<Record<import('@kraken-e2e/contracts').SemanticKey, number>>;
+//# sourceMappingURL=locators.d.ts.map

package/dist/locators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locators.d.ts","sourceRoot":"","sources":["../src/locators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAgB3D;AAED;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CACvC,MAAM,CAAC,OAAO,uBAAuB,EAAE,WAAW,EAAE,MAAM,CAAC,CAK5D,CAAC"}

package/dist/locators.js

@@ -0,0 +1,35 @@
+/**
+ * Portable locator strategies → XCUITest selectors (ADR-0002 D1 mapping:
+ * testId → accessibility identifier, a11y → accessibility identifier,
+ * text → label/value predicate).
+ */
+export function toIosSelector(target) {
+    switch (target.by) {
+        case 'testId':
+        case 'a11y':
+            return `~${target.value}`;
+        case 'text': {
+            const escaped = target.value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+            return target.exact
+                ? `-ios predicate string:label == "${escaped}" OR value == "${escaped}"`
+                : `-ios predicate string:label CONTAINS "${escaped}" OR value CONTAINS "${escaped}"`;
+        }
+        case 'native':
+            // Explicitly non-portable: any raw WebdriverIO/Appium selector string
+            // (class chains, predicates, xpath).
+            return target.value;
+    }
+}
+/**
+ * HID keyboard usages (page 0x07) for the semantic keys — the FAITHFUL iOS
+ * implementation (contract 2.0), live-verified on iOS 18.6: Return commits
+ * and dismisses the keyboard, Escape performs UIKit's hardware-Escape cancel,
+ * Tab behaves as hardware Tab. Injected device-level via WDA's
+ * performIoHidEvent — no hardware-keyboard setting required.
+ */
+export const IOS_HID_KEY_USAGES = {
+    enter: 0x28, // Keyboard Return
+    escape: 0x29, // Keyboard Escape
+    tab: 0x2b, // Keyboard Tab
+};
+//# sourceMappingURL=locators.js.map

package/dist/locators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locators.js","sourceRoot":"","sources":["../src/locators.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAqB;IACjD,QAAQ,MAAM,CAAC,EAAE,EAAE,CAAC;QAClB,KAAK,QAAQ,CAAC;QACd,KAAK,MAAM;YACT,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5B,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACzE,OAAO,MAAM,CAAC,KAAK;gBACjB,CAAC,CAAC,mCAAmC,OAAO,kBAAkB,OAAO,GAAG;gBACxE,CAAC,CAAC,yCAAyC,OAAO,wBAAwB,OAAO,GAAG,CAAC;QACzF,CAAC;QACD,KAAK,QAAQ;YACX,sEAAsE;YACtE,qCAAqC;YACrC,OAAO,MAAM,CAAC,KAAK,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAE3B;IACF,KAAK,EAAE,IAAI,EAAE,kBAAkB;IAC/B,MAAM,EAAE,IAAI,EAAE,kBAAkB;IAChC,GAAG,EAAE,IAAI,EAAE,eAAe;CAC3B,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The /manifest subpath (ADR-0001 §5.5): ZERO heavy imports — on non-macOS
+ * hosts the registry reads THIS and hard-disables the driver with an explicit
+ * message; the main entry (and its Appium/Xcode-touching dependencies) is
+ * never imported there. NOTE: this package must NEVER set npm's "os" field —
+ * it would break `pnpm install` for non-mac teammates sharing the lockfile
+ * (ADR-0001 §5.10).
+ */
+import { type DriverManifest } from '@kraken-e2e/contracts';
+export declare const manifest: DriverManifest;
+export default manifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE9E,eAAO,MAAM,QAAQ,EAAE,cAetB,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,26 @@
+/**
+ * The /manifest subpath (ADR-0001 §5.5): ZERO heavy imports — on non-macOS
+ * hosts the registry reads THIS and hard-disables the driver with an explicit
+ * message; the main entry (and its Appium/Xcode-touching dependencies) is
+ * never imported there. NOTE: this package must NEVER set npm's "os" field —
+ * it would break `pnpm install` for non-mac teammates sharing the lockfile
+ * (ADR-0001 §5.10).
+ */
+import { CONTRACT_VERSION } from '@kraken-e2e/contracts';
+export const manifest = {
+    kind: 'kraken-driver',
+    id: 'ios',
+    platforms: ['ios'],
+    version: '0.0.0',
+    contract: CONTRACT_VERSION,
+    platformLabel: 'iOS (XCUITest via Appium 3)',
+    hostRequirements: { platforms: ['darwin'] },
+    disabledFix: 'The iOS driver requires macOS: XCUITest and WebDriverAgent are Apple platform ' +
+        'restrictions, not a Kraken limitation. Android and Web drivers work on this host.',
+    setupHints: [
+        'Install Xcode (16+ / 26.x recommended) and an iOS simulator runtime',
+        'Run: kraken doctor',
+    ],
+};
+export default manifest;
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,gBAAgB,EAAuB,MAAM,uBAAuB,CAAC;AAE9E,MAAM,CAAC,MAAM,QAAQ,GAAmB;IACtC,IAAI,EAAE,eAAe;IACrB,EAAE,EAAE,KAAK;IACT,SAAS,EAAE,CAAC,KAAK,CAAC;IAClB,OAAO,EAAE,OAAO;IAChB,QAAQ,EAAE,gBAAgB;IAC1B,aAAa,EAAE,6BAA6B;IAC5C,gBAAgB,EAAE,EAAE,SAAS,EAAE,CAAC,QAAQ,CAAC,EAAE;IAC3C,WAAW,EACT,gFAAgF;QAChF,mFAAmF;IACrF,UAAU,EAAE;QACV,qEAAqE;QACrE,oBAAoB;KACrB;CACF,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/dist/wdio-session.d.ts

@@ -0,0 +1,59 @@
+import { type ArtifactRef, type CoreOperation, type DriverServices, type ResolvedActor, type SemanticKey, type SessionWaitOptions, type TargetLocator, type UserSession, type WaitState } from '@kraken-e2e/contracts';
+/** Same narrow WDIO slice as driver-android (kept per-driver: contracts-only edges). */
+export interface WdioBrowserLike {
+    $(selector: string): Promise<WdioElementLike>;
+    execute(script: string, args?: unknown): Promise<unknown>;
+    takeScreenshot(): Promise<string>;
+    getPageSource(): Promise<string>;
+    deleteSession(): Promise<void>;
+}
+export interface WdioElementLike {
+    readonly error?: {
+        message?: string;
+    };
+    elementId?: string | undefined;
+    click(): Promise<void>;
+    setValue(text: string): Promise<void>;
+    getText(): Promise<string>;
+    isDisplayed(): Promise<boolean>;
+    isExisting(): Promise<boolean>;
+    waitForDisplayed(options?: {
+        timeout?: number;
+        interval?: number;
+        reverse?: boolean;
+    }): Promise<unknown>;
+    waitForExist(options?: {
+        timeout?: number;
+        interval?: number;
+    }): Promise<unknown>;
+}
+/**
+ * UserSession adapter for XCUITest. All 11 core operations are supported —
+ * pressKey included, via device-level HID keyboard events (contract 2.0):
+ * the M1 gate first BLOCKED on a pressKey asymmetry, the mandated research
+ * found the faithful mechanism, and SemanticKey was redefined (back removed —
+ * an Android-only concept). Governance working as designed (ADR-0001 §5.4).
+ */
+export declare class IosUserSession implements UserSession {
+    #private;
+    private readonly browser;
+    private readonly services;
+    readonly actorId: string;
+    readonly driverId = "ios";
+    readonly platform: string;
+    readonly capabilities: Readonly<Record<CoreOperation, 'supported' | 'unsupported'>>;
+    constructor(browser: WdioBrowserLike, actor: ResolvedActor, services: DriverServices);
+    tap(target: TargetLocator): Promise<void>;
+    typeText(target: TargetLocator, text: string): Promise<void>;
+    readText(target: TargetLocator): Promise<string>;
+    waitFor(target: TargetLocator, state: WaitState, opts?: SessionWaitOptions): Promise<void>;
+    isDisplayed(target: TargetLocator): Promise<boolean>;
+    scrollIntoView(target: TargetLocator): Promise<void>;
+    pressKey(key: SemanticKey): Promise<void>;
+    navigate(destination: string): Promise<void>;
+    screenshot(): Promise<ArtifactRef>;
+    source(): Promise<string>;
+    dispose(): Promise<void>;
+    native<K extends never>(kind: K): never;
+}
+//# sourceMappingURL=wdio-session.d.ts.map

package/dist/wdio-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wdio-session.d.ts","sourceRoot":"","sources":["../src/wdio-session.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,aAAa,EAClB,KAAK,cAAc,EAEnB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,SAAS,EACf,MAAM,uBAAuB,CAAC;AAI/B,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1D,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,gBAAgB,CAAC,OAAO,CAAC,EAAE;QACzB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrB,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACnF;AAID;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,WAAW;;IAW9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAZ3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,SAAS;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,WAAW,GAAG,aAAa,CAAC,CAAC,CAAC;gBAOjE,OAAO,EAAE,eAAe,EACzC,KAAK,EAAE,aAAa,EACH,QAAQ,EAAE,cAAc;IA4BrC,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5D,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhD,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1F,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAQpD,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;IAUlC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAIzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK;CAMxC"}