@taqwright/taqwright 0.0.24

package/dist/bin/inspect.d.ts

@@ -0,0 +1,9 @@
+export interface InspectCliOptions {
+    config?: string;
+    project?: string;
+    port?: string;
+    host?: string;
+    open?: boolean;
+    record?: boolean;
+}
+export declare function runInspect(opts: InspectCliOptions): Promise<void>;

package/dist/bin/inspect.js

@@ -0,0 +1,91 @@
+import { spawn } from 'node:child_process';
+import { dirname } from 'node:path';
+import { findConfigFile, loadTaqwrightConfig, getUseOptions } from '../config.js';
+import { buildCapabilities } from '../capabilities.js';
+import { isPortOpen } from '../auto-appium.js';
+import { startInspectorServer } from '../inspector/server.js';
+export async function runInspect(opts) {
+    const defaults = await resolveDefaults(opts);
+    const host = opts.host ?? 'localhost';
+    const port = await pickFreePort(opts.port ? Number(opts.port) : 4280, host);
+    const handle = await startInspectorServer({ defaults, host, port });
+    let shuttingDown = false;
+    const shutdown = async (code = 0) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        console.log('\ntaqwright inspect: shutting down…');
+        try {
+            await handle.session.cleanup();
+        }
+        catch {
+        }
+        try {
+            await handle.close();
+        }
+        catch {
+        }
+        process.exit(code);
+    };
+    process.on('SIGINT', () => void shutdown(0));
+    process.on('SIGTERM', () => void shutdown(0));
+    console.log(`taqwright inspect: ready at ${handle.url}`);
+    console.log('Press Ctrl+C to stop.');
+    if (opts.open !== false)
+        openBrowser(handle.url);
+}
+async function resolveDefaults(opts) {
+    const configPath = opts.config ?? (await findConfigFile());
+    const projectRoot = configPath ? dirname(configPath) : undefined;
+    const baseFallback = {
+        project: undefined,
+        projectRoot,
+        testDir: 'tests',
+        appium: { host: 'localhost', port: 4723, path: '/' },
+        capabilities: {
+            platformName: 'Android',
+            'appium:automationName': 'UiAutomator2',
+            'appium:noReset': true,
+            'appium:newCommandTimeout': 240,
+        },
+        recordOnConnect: !!opts.record,
+    };
+    if (!configPath)
+        return baseFallback;
+    const cfg = await loadTaqwrightConfig(dirname(configPath));
+    const useOpts = getUseOptions(cfg, opts.project);
+    if (!useOpts) {
+        console.log('taqwright inspect: no project resolved from config — using built-in defaults.');
+        return { ...baseFallback, testDir: cfg?.testDir ?? 'tests' };
+    }
+    const projectName = opts.project ?? cfg?.projects.find((p) => p.use === useOpts)?.name ?? cfg?.projects[0]?.name;
+    return {
+        project: projectName,
+        projectRoot,
+        testDir: cfg?.testDir ?? 'tests',
+        appium: {
+            host: useOpts.appium?.host ?? 'localhost',
+            port: useOpts.appium?.port ?? 4723,
+            path: useOpts.appium?.path ?? '/',
+        },
+        capabilities: buildCapabilities(useOpts),
+        recordOnConnect: !!opts.record,
+    };
+}
+async function pickFreePort(preferred, host) {
+    for (let p = preferred; p < preferred + 20; p++) {
+        if (!(await isPortOpen(host, p)))
+            return p;
+    }
+    return preferred;
+}
+function openBrowser(url) {
+    const cmd = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';
+    const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
+    try {
+        const child = spawn(cmd, args, { stdio: 'ignore', detached: true });
+        child.unref();
+    }
+    catch {
+    }
+}

package/dist/bin/report-branding.d.ts

@@ -0,0 +1,2 @@
+export declare function brandReportHtml(html: string): string;
+export declare function brandReportDir(dir: string): void;

package/dist/bin/report-branding.js

@@ -0,0 +1,42 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { TAQWRIGHT_FAVICON_DATA_URI } from '../branding-assets.js';
+const SENTINEL = '<!--taqwright-branding-->';
+const REPORT_TITLE = 'Taqwright Test Report';
+function injectionMarkup() {
+    const icon = JSON.stringify(TAQWRIGHT_FAVICON_DATA_URI);
+    const title = JSON.stringify(REPORT_TITLE);
+    const script = `(function(){` +
+        `var ICON=${icon};var TITLE=${title};` +
+        `function apply(){try{` +
+        `document.title=TITLE;` +
+        `var links=document.head?document.head.querySelectorAll('link[rel~="icon"]'):[];` +
+        `for(var i=0;i<links.length;i++){var el=links[i];if(el.hasAttribute('data-tw-icon'))continue;if(el.parentNode)el.parentNode.removeChild(el);}` +
+        `if(document.head&&!document.head.querySelector('link[data-tw-icon]')){` +
+        `var l=document.createElement('link');l.setAttribute('rel','icon');l.setAttribute('type','image/png');l.setAttribute('href',ICON);l.setAttribute('data-tw-icon','');document.head.appendChild(l);}` +
+        `}catch(e){}}` +
+        `apply();` +
+        `document.addEventListener('DOMContentLoaded',apply);` +
+        `window.addEventListener('load',apply);` +
+        `try{var mo=new MutationObserver(apply);mo.observe(document.head||document.documentElement,{childList:true});}catch(e){}` +
+        `var n=0,t=setInterval(function(){apply();if(++n>10)clearInterval(t);},500);` +
+        `})();`;
+    return `${SENTINEL}<script>${script}</script>`;
+}
+export function brandReportHtml(html) {
+    if (html.includes(SENTINEL))
+        return html;
+    const idx = html.indexOf('</head>');
+    if (idx === -1)
+        return html;
+    return html.slice(0, idx) + injectionMarkup() + html.slice(idx);
+}
+export function brandReportDir(dir) {
+    const file = join(dir, 'index.html');
+    if (!existsSync(file))
+        return;
+    const html = readFileSync(file, 'utf8');
+    const branded = brandReportHtml(html);
+    if (branded !== html)
+        writeFileSync(file, branded);
+}

package/dist/branding-assets.d.ts

@@ -0,0 +1 @@
+export declare const TAQWRIGHT_FAVICON_DATA_URI = "data:image/png;base64,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";

package/dist/branding-assets.js

@@ -0,0 +1 @@
+export const TAQWRIGHT_FAVICON_DATA_URI = 'data:image/png;base64,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';

package/dist/capabilities-helpers.d.ts

@@ -0,0 +1,7 @@
+export interface IosParallelCapsOptions {
+    useNewWDA?: boolean;
+    wdaStartupRetries?: number;
+    wdaConnectionTimeout?: number;
+    wdaLaunchTimeout?: number;
+}
+export declare function iosParallelCaps(slot: number, opts?: IosParallelCapsOptions): Record<string, unknown>;

package/dist/capabilities-helpers.js

@@ -0,0 +1,14 @@
+export function iosParallelCaps(slot, opts = {}) {
+    if (!Number.isInteger(slot) || slot < 0) {
+        throw new Error(`iosParallelCaps: slot must be a non-negative integer, got ${slot}`);
+    }
+    return {
+        'appium:wdaLocalPort': 8100 + slot,
+        'appium:mjpegServerPort': 9100 + slot,
+        'appium:derivedDataPath': `/tmp/wda-${slot}`,
+        'appium:useNewWDA': opts.useNewWDA ?? true,
+        'appium:wdaStartupRetries': opts.wdaStartupRetries ?? 4,
+        'appium:wdaConnectionTimeout': opts.wdaConnectionTimeout ?? 360_000,
+        'appium:wdaLaunchTimeout': opts.wdaLaunchTimeout ?? 120_000,
+    };
+}

package/dist/capabilities.d.ts

@@ -0,0 +1,6 @@
+import type { Capabilities } from '@wdio/types';
+import { type TaqwrightUseOptions } from './types/index.js';
+export declare function buildCapabilities(use: TaqwrightUseOptions): Capabilities.RequestedStandaloneCapabilities;
+export declare const LOCAL_EMULATOR_CAP_KEYS: string[];
+export declare function omitLocalEmulatorCaps(caps: Record<string, unknown>): Record<string, unknown>;
+export declare function appiumRemoteOptions(use: TaqwrightUseOptions): Capabilities.RemoteConfig;

package/dist/capabilities.js

@@ -0,0 +1,86 @@
+import { Platform } from './types/index.js';
+export function buildCapabilities(use) {
+    const isIOS = use.platform === Platform.IOS;
+    const caps = {
+        platformName: isIOS ? 'iOS' : 'Android',
+        'appium:automationName': isIOS ? 'XCUITest' : 'UiAutomator2',
+        'appium:newCommandTimeout': use.appium?.newCommandTimeout ?? 240,
+        'appium:noReset': true,
+    };
+    const provider = use.device.provider;
+    const userCaps = use.capabilities ?? {};
+    const autoStartDevice = use.appium?.autoStartDevice !== false;
+    const androidAutoBoot = autoStartDevice &&
+        !isIOS &&
+        provider === 'emulator' &&
+        typeof use.device.name === 'string' &&
+        use.device.name.length > 0;
+    const declaredUdid = use.device.udid;
+    if (declaredUdid && !(androidAutoBoot && !('appium:udid' in userCaps))) {
+        caps['appium:udid'] = declaredUdid;
+    }
+    if (use.device.name) {
+        caps['appium:deviceName'] =
+            typeof use.device.name === 'string' ? use.device.name : use.device.name.source;
+    }
+    if (use.device.osVersion) {
+        caps['appium:platformVersion'] = use.device.osVersion;
+    }
+    if (use.buildPath) {
+        caps['appium:app'] = use.buildPath;
+    }
+    if (use.appBundleId) {
+        if (isIOS)
+            caps['appium:bundleId'] = use.appBundleId;
+        else
+            caps['appium:appPackage'] = use.appBundleId;
+    }
+    const isCloudProvider_ = provider === 'browserstack' || provider === 'lambdatest';
+    if (use.resetBetweenTests &&
+        use.buildPath &&
+        use.appBundleId &&
+        !isCloudProvider_ &&
+        !('appium:autoLaunch' in userCaps)) {
+        caps['appium:autoLaunch'] = false;
+    }
+    if (androidAutoBoot) {
+        caps['appium:avd'] = use.device.name;
+        if (!('appium:avdLaunchTimeout' in userCaps)) {
+            caps['appium:avdLaunchTimeout'] = 120_000;
+        }
+        if (!('appium:avdReadyTimeout' in userCaps)) {
+            caps['appium:avdReadyTimeout'] = 120_000;
+        }
+    }
+    else if (autoStartDevice && isIOS && provider === 'emulator') {
+        if (!('appium:simulatorStartupTimeout' in userCaps)) {
+            caps['appium:simulatorStartupTimeout'] = 120_000;
+        }
+    }
+    if (isIOS && !('appium:forceSimulatorSoftwareKeyboardPresence' in userCaps)) {
+        caps['appium:forceSimulatorSoftwareKeyboardPresence'] = true;
+    }
+    return { ...caps, ...userCaps };
+}
+export const LOCAL_EMULATOR_CAP_KEYS = [
+    'appium:avd',
+    'appium:avdLaunchTimeout',
+    'appium:avdReadyTimeout',
+];
+export function omitLocalEmulatorCaps(caps) {
+    const out = {};
+    for (const [k, v] of Object.entries(caps)) {
+        if (!LOCAL_EMULATOR_CAP_KEYS.includes(k))
+            out[k] = v;
+    }
+    return out;
+}
+export function appiumRemoteOptions(use) {
+    return {
+        hostname: use.appium?.host ?? 'localhost',
+        port: use.appium?.port ?? 4723,
+        path: use.appium?.path ?? '/',
+        logLevel: use.appium?.logLevel ?? 'warn',
+        capabilities: buildCapabilities(use),
+    };
+}

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+import type { PlaywrightTestConfig } from '@playwright/test';
+import { Platform, type TaqwrightConfig, type TaqwrightProjectConfig } from './types/index.js';
+export declare const TAQWRIGHT_KEY = "__taqwright__";
+export interface PlaywrightConfigWithEmbedded extends PlaywrightTestConfig {
+    [TAQWRIGHT_KEY]?: TaqwrightConfig;
+}
+export declare function findConfigFile(cwd?: string): Promise<string | undefined>;
+export declare function loadTaqwrightConfig(cwd?: string): Promise<TaqwrightConfig | undefined>;
+export declare function loadPlaywrightConfig(cwd?: string): Promise<PlaywrightConfigWithEmbedded>;
+export declare function effectiveWorkers(project: TaqwrightProjectConfig, config: TaqwrightConfig): number;
+export declare function resolveCliWorkers(config: TaqwrightConfig, projectFilter: string[], userWorkers?: string | number): number | undefined;
+export declare function defineConfig(config: TaqwrightConfig): PlaywrightConfigWithEmbedded;
+export declare function findParallelMisconfig(config: TaqwrightConfig): string | null;
+export declare function findAutoStartDeviceMisconfig(config: TaqwrightConfig): string | null;
+export declare function findAutoDiscoverMisconfig(config: TaqwrightConfig): string | null;
+export declare function getUseOptions(config: TaqwrightConfig | undefined, projectName?: string): TaqwrightConfig['projects'][number]['use'] | undefined;
+export { Platform };

package/dist/config.js

@@ -0,0 +1,235 @@
+import { access } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { Platform } from './types/index.js';
+export const TAQWRIGHT_KEY = '__taqwright__';
+const CONFIG_FILES = [
+    'taqwright.config.ts',
+    'taqwright.config.mts',
+    'taqwright.config.js',
+    'taqwright.config.mjs',
+];
+export async function findConfigFile(cwd = process.cwd()) {
+    let dir = resolve(cwd);
+    while (true) {
+        for (const name of CONFIG_FILES) {
+            const candidate = join(dir, name);
+            try {
+                await access(candidate);
+                return candidate;
+            }
+            catch {
+            }
+        }
+        const parent = resolve(dir, '..');
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+async function importConfigFile(filePath) {
+    const mod = await import(pathToFileURL(filePath).href);
+    let config = mod.default ?? mod;
+    if (config && typeof config === 'object' && 'default' in config) {
+        config = config.default;
+    }
+    return config;
+}
+export async function loadTaqwrightConfig(cwd) {
+    const file = await findConfigFile(cwd);
+    if (!file)
+        return undefined;
+    const cfg = await importConfigFile(file);
+    return cfg[TAQWRIGHT_KEY];
+}
+export async function loadPlaywrightConfig(cwd) {
+    const file = await findConfigFile(cwd);
+    if (!file)
+        return {};
+    return importConfigFile(file);
+}
+export function effectiveWorkers(project, config) {
+    return project.workers ?? config.workers ?? 1;
+}
+export function resolveCliWorkers(config, projectFilter, userWorkers) {
+    if (userWorkers !== undefined) {
+        const n = typeof userWorkers === 'number' ? userWorkers : Number.parseInt(userWorkers, 10);
+        return Number.isFinite(n) ? n : undefined;
+    }
+    let target;
+    if (projectFilter.length === 1) {
+        target = config.projects.find((p) => p.name === projectFilter[0]);
+    }
+    else if (projectFilter.length === 0 && config.projects.length === 1) {
+        target = config.projects[0];
+    }
+    return target ? effectiveWorkers(target, config) : undefined;
+}
+export function defineConfig(config) {
+    if (!config.projects || config.projects.length === 0) {
+        throw new Error('taqwright defineConfig: at least one project is required');
+    }
+    const parallelMisconfig = findParallelMisconfig(config);
+    if (parallelMisconfig)
+        throw new Error(parallelMisconfig);
+    const autoStartMisconfig = findAutoStartDeviceMisconfig(config);
+    if (autoStartMisconfig)
+        throw new Error(autoStartMisconfig);
+    const autoDiscoverMisconfig = findAutoDiscoverMisconfig(config);
+    if (autoDiscoverMisconfig)
+        throw new Error(autoDiscoverMisconfig);
+    const hasAutoDiscover = config.projects.some((p) => p.use.device.autoDiscover === true);
+    const hasAndroidPoolAutoBoot = config.projects.some((p) => {
+        const device = p.use.device;
+        return (p.use.platform === Platform.ANDROID &&
+            device.provider === 'emulator' &&
+            Array.isArray(device.pool) &&
+            device.pool.length > 0 &&
+            device.pool.every((e) => typeof e.name === 'string' && e.name.length > 0) &&
+            p.use.appium?.autoStartDevice !== false);
+    });
+    let globalSetup = config.globalSetup;
+    if (hasAutoDiscover || hasAndroidPoolAutoBoot) {
+        const internal = fileURLToPath(new URL('./discovery-setup.js', import.meta.url));
+        const existing = config.globalSetup
+            ? Array.isArray(config.globalSetup)
+                ? config.globalSetup
+                : [config.globalSetup]
+            : [];
+        globalSetup = [internal, ...existing];
+    }
+    const pwConfig = {
+        workers: Math.max(1, ...config.projects.map((p) => effectiveWorkers(p, config))),
+        fullyParallel: config.fullyParallel ?? false,
+        forbidOnly: config.forbidOnly,
+        timeout: config.timeout,
+        retries: config.retries,
+        outputDir: config.outputDir,
+        testDir: config.testDir,
+        testMatch: config.testMatch,
+        testIgnore: config.testIgnore,
+        reporter: config.reporter,
+        globalSetup,
+        globalTeardown: config.globalTeardown,
+        projects: config.projects.map((p) => ({
+            name: p.name,
+            timeout: p.timeout,
+            retries: p.retries,
+            testDir: p.testDir,
+            testMatch: p.testMatch,
+            testIgnore: p.testIgnore,
+            outputDir: p.outputDir,
+            grep: p.grep,
+            grepInvert: p.grepInvert,
+            dependencies: p.dependencies,
+            use: {
+                taqwrightProject: p.name,
+            },
+        })),
+        [TAQWRIGHT_KEY]: config,
+    };
+    return pwConfig;
+}
+export function findParallelMisconfig(config) {
+    const problems = [];
+    for (const project of config.projects) {
+        const workers = effectiveWorkers(project, config);
+        if (workers <= 1)
+            continue;
+        const device = project.use.device;
+        if (device.provider !== 'emulator' && device.provider !== 'local-device') {
+            continue;
+        }
+        if (device.autoDiscover === true)
+            continue;
+        const pool = device.pool;
+        if (!pool || pool.length === 0) {
+            problems.push(`\`workers\` is ${workers} but project "${project.name}" ` +
+                `(provider: ${device.provider}) has no \`device.pool\`. Parallel ` +
+                `runs need a \`device.pool\` with at least ${workers} entries — ` +
+                `add one, or set \`workers: 1\`. Without a pool, multiple workers ` +
+                `collide on one device.`);
+        }
+        else if (pool.length < workers) {
+            problems.push(`\`workers\` is ${workers} but project "${project.name}"'s ` +
+                `\`device.pool\` has only ${pool.length} ` +
+                `entr${pool.length === 1 ? 'y' : 'ies'}. Grow it to at least ` +
+                `${workers}, or lower \`workers\`.`);
+        }
+    }
+    return problems.length ? `taqwright: ${problems.join('\ntaqwright: ')}` : null;
+}
+export function findAutoStartDeviceMisconfig(config) {
+    const problems = [];
+    for (const project of config.projects) {
+        const use = project.use;
+        if (use.appium?.autoStartDevice !== true)
+            continue;
+        const device = use.device;
+        if (device.provider !== 'emulator' || use.platform !== Platform.ANDROID) {
+            continue;
+        }
+        if (device.autoDiscover === true)
+            continue;
+        const pool = device.pool;
+        const ok = pool
+            ? pool.every((e) => typeof e.name === 'string' && e.name.length > 0)
+            : typeof device.name === 'string' && device.name.length > 0;
+        if (!ok) {
+            problems.push(`\`appium.autoStartDevice\` is set on project "${project.name}" ` +
+                `but it has no concrete AVD name to boot. autoStartDevice needs ` +
+                `a string \`device.name\` (or a string \`name\` on every ` +
+                `\`device.pool\` entry) equal to the AVD id (e.g. ` +
+                `'Pixel_7_API_34' — see \`emulator -list-avds\`). A RegExp ` +
+                `\`device.name\` can't be booted. Set a string name, or remove ` +
+                `\`appium.autoStartDevice\`.`);
+        }
+    }
+    return problems.length ? `taqwright: ${problems.join('\ntaqwright: ')}` : null;
+}
+export function findAutoDiscoverMisconfig(config) {
+    const problems = [];
+    for (const project of config.projects) {
+        const device = project.use.device;
+        if (device.autoDiscover !== true)
+            continue;
+        if (device.provider !== 'emulator' && device.provider !== 'local-device') {
+            problems.push(`\`device.autoDiscover\` is set on project "${project.name}" but its ` +
+                `provider is "${device.provider}". Auto-discovery is for local ` +
+                `providers only (emulator / local-device); cloud grids manage their ` +
+                `own device queueing — remove \`autoDiscover\`.`);
+            continue;
+        }
+        if ((device.pool && device.pool.length > 0) || device.udid) {
+            problems.push(`\`device.autoDiscover\` on project "${project.name}" is mutually ` +
+                `exclusive with \`device.${device.pool?.length ? 'pool' : 'udid'}\` — ` +
+                `set one or the other. autoDiscover resolves the device set for you.`);
+            continue;
+        }
+        if (device.provider === 'local-device' && project.use.platform === Platform.IOS) {
+            problems.push(`\`device.autoDiscover\` on project "${project.name}" is not yet ` +
+                `supported for local-device + iOS — there's no multi-device ` +
+                `enumerator for physical iPhones. Set \`device.udid\` or \`device.pool\`.`);
+            continue;
+        }
+        if (device.provider === 'emulator' &&
+            project.use.platform === Platform.ANDROID &&
+            project.use.appium?.autoStartDevice === false) {
+            problems.push(`\`device.autoDiscover\` on project "${project.name}" needs ` +
+                `\`appium.autoStartDevice\` to boot/attach AVDs, but it's set to ` +
+                `false. Remove \`appium.autoStartDevice: false\`.`);
+        }
+    }
+    return problems.length ? `taqwright: ${problems.join('\ntaqwright: ')}` : null;
+}
+export function getUseOptions(config, projectName) {
+    if (!config)
+        return undefined;
+    if (projectName) {
+        const match = config.projects.find((p) => p.name === projectName);
+        if (match)
+            return match.use;
+    }
+    return config.projects[0]?.use;
+}
+export { Platform };

package/dist/discovery-setup.d.ts

@@ -0,0 +1 @@
+export default function autoDiscoverGlobalSetup(): Promise<void>;

package/dist/discovery-setup.js

@@ -0,0 +1,61 @@
+import { Platform } from './types/index.js';
+import { loadTaqwrightConfig, effectiveWorkers } from './config.js';
+import { discoverAssignableDevices, selectDevicePool, resolvedPoolEnvKey, } from './discovery.js';
+import { startIosSimulator, ensureAndroidAvdReady } from './inspector/devices.js';
+import { logger } from './logger.js';
+export default async function autoDiscoverGlobalSetup() {
+    const config = await loadTaqwrightConfig();
+    if (!config)
+        return;
+    for (const project of config.projects) {
+        const device = project.use.device;
+        const autoStartDevice = project.use.appium?.autoStartDevice !== false;
+        const isAutoDiscover = device.autoDiscover === true &&
+            (device.provider === 'emulator' || device.provider === 'local-device');
+        const isStaticAndroidPool = !device.autoDiscover &&
+            device.provider === 'emulator' &&
+            project.use.platform === Platform.ANDROID &&
+            Array.isArray(device.pool) &&
+            device.pool.length > 0 &&
+            autoStartDevice;
+        if (!isAutoDiscover && !isStaticAndroidPool)
+            continue;
+        if (isStaticAndroidPool) {
+            for (const entry of device.pool) {
+                if (typeof entry.name !== 'string' || !entry.name)
+                    continue;
+                await ensureAndroidAvdReady(entry.name).catch((err) => {
+                    logger.warn(`taqwright: could not pre-boot AVD ${entry.name} — ${err.message}`);
+                });
+            }
+            logger.log(`taqwright: pre-booted ${device.pool.length} emulator(s) for project "${project.name}".`);
+            continue;
+        }
+        const workers = effectiveWorkers(project, config);
+        const opts = {
+            platform: project.use.platform,
+            provider: device.provider,
+            osVersion: device.osVersion,
+            name: device.name,
+        };
+        const slots = await discoverAssignableDevices(opts);
+        const pool = selectDevicePool(slots, workers);
+        if (project.use.platform === Platform.IOS) {
+            for (const entry of pool) {
+                await startIosSimulator(entry.udid).catch((err) => {
+                    logger.warn(`taqwright: could not pre-boot simulator ${entry.udid} — ${err.message}`);
+                });
+            }
+        }
+        else if (device.provider === 'emulator' && autoStartDevice) {
+            for (const entry of pool) {
+                const avd = entry.name ?? entry.udid.replace(/^avd:/, '');
+                await ensureAndroidAvdReady(avd).catch((err) => {
+                    logger.warn(`taqwright: could not pre-boot AVD ${avd} — ${err.message}`);
+                });
+            }
+        }
+        process.env[resolvedPoolEnvKey(project.name)] = JSON.stringify(pool);
+        logger.log(`taqwright: autoDiscover resolved ${pool.length} device(s) for project "${project.name}".`);
+    }
+}

package/dist/discovery.d.ts

@@ -0,0 +1,17 @@
+import { Platform, type DevicePoolEntry } from './types/index.js';
+import { type DeviceListing } from './inspector/devices.js';
+export interface AssignableSlot {
+    udid: string;
+    name?: string;
+    osVersion?: string;
+}
+export interface DiscoverOpts {
+    platform: Platform;
+    provider: 'emulator' | 'local-device';
+    osVersion?: string;
+    name?: string | RegExp;
+}
+export declare function toAssignableSlots(listing: DeviceListing, opts: DiscoverOpts): AssignableSlot[];
+export declare function selectDevicePool(slots: AssignableSlot[], workers: number): DevicePoolEntry[];
+export declare function discoverAssignableDevices(opts: DiscoverOpts): Promise<AssignableSlot[]>;
+export declare function resolvedPoolEnvKey(projectName: string | undefined): string;