doc-detective 4.19.0 → 4.20.0

package/dist/core/tests/appSurface.d.ts

@@ -0,0 +1,106 @@
+import { resolveHeavyDepPath, resolveHeavyDepPathInCache, resolveHeavyDepSource, ensureRuntimeInstalled } from "../../runtime/loader.js";
+export { classifyAppIdentifier, defaultAppSurfaceName, classifyNativeSelector, buildUiaLocator, createAppSessionState, appSurfacePreflight, isAppDriverRequired, stepTargetsAppSurface, resolveAppSurfaceRef, startAppSurface, findAppElement, buildAppLocator, closeAppSurface, teardownAppSession, invalidateStaleAppiumManifest, };
+export type { AppSessionState, AppSurfaceEntry };
+type AppIdentifierKind = "path" | "aumid" | "id";
+declare function classifyAppIdentifier(app: string): AppIdentifierKind;
+declare function defaultAppSurfaceName(app: string): string;
+type NativeSelectorKind = "xpath" | "accessibilityId" | "css";
+declare function classifyNativeSelector(selector: string): NativeSelectorKind;
+declare function buildUiaLocator(criteria: {
+    elementText?: string;
+    elementId?: string;
+    elementTestId?: string;
+    elementAria?: {
+        role?: string;
+        name?: string;
+    } | string;
+    [key: string]: any;
+}): {
+    strategy: string;
+    value: string;
+} | null;
+interface AppSurfaceEntry {
+    name: string;
+    appId: string;
+    driver: any;
+    launchedByUs: boolean;
+}
+interface AppSessionState {
+    server?: {
+        port: number;
+        process: any;
+    };
+    appiumEntry?: string;
+    appiumHome?: string;
+    surfaces: Map<string, AppSurfaceEntry>;
+    activeApp?: string;
+    recordingHost: {
+        state: {
+            recordings: any[];
+        };
+    };
+}
+declare function createAppSessionState(): AppSessionState;
+declare function isAppDriverRequired({ test }: {
+    test: any;
+}): boolean;
+declare function stepTargetsAppSurface(step: any): boolean;
+declare function resolveAppSurfaceRef(surface: any, appSession?: AppSessionState): {
+    entry?: AppSurfaceEntry;
+    window?: any;
+    error?: string;
+} | null;
+declare function invalidateStaleAppiumManifest(home: string): void;
+declare function appSurfacePreflight({ config, platform, deps, }: {
+    config: any;
+    platform: string;
+    deps?: {
+        resolveSource?: typeof resolveHeavyDepSource;
+        resolvePath?: typeof resolveHeavyDepPath;
+        resolvePathInCache?: typeof resolveHeavyDepPathInCache;
+        ensureInstalled?: typeof ensureRuntimeInstalled;
+    };
+}): Promise<{
+    ok: true;
+    appiumEntry: string;
+    appiumHome: string;
+} | {
+    ok: false;
+    reason: string;
+}>;
+declare function buildAppLocator(criteria: {
+    selector?: string;
+    [key: string]: any;
+}): {
+    strategy: string;
+    value: string;
+} | {
+    error: string;
+};
+declare function findAppElement({ driver, criteria, timeout, }: {
+    driver: any;
+    criteria: any;
+    timeout?: number;
+}): Promise<{
+    element?: any;
+    error?: string;
+}>;
+declare function startAppSurface({ config, step, appSession, platform, serverDeps, }: {
+    config: any;
+    step: any;
+    appSession: AppSessionState;
+    platform: string;
+    serverDeps: {
+        startServer: (appiumEntry: string, appiumHome: string) => Promise<{
+            port: number;
+            process: any;
+        }>;
+        startDriver: (capabilities: any, port: number) => Promise<any>;
+    };
+}): Promise<any>;
+declare function closeAppSurface({ entry, appSession, }: {
+    entry: AppSurfaceEntry;
+    appSession: AppSessionState;
+}): Promise<void>;
+declare function teardownAppSession(appSession: AppSessionState | undefined, killServer: (pid: number | undefined) => Promise<void>): Promise<void>;
+//# sourceMappingURL=appSurface.d.ts.map

package/dist/core/tests/appSurface.d.ts.map

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

package/dist/core/tests/appSurface.js

@@ -0,0 +1,521 @@
+// Native app surfaces (phase A1 of docs/design/native-app-surfaces.md).
+// The top half is pure helpers — identifier classification, default surface
+// naming, native-selector escape-hatch classification, and the per-platform
+// semantic-locator mappings (A1 ships the Windows/UIA column) — unit-testable
+// without a Windows host. The bottom half is the runtime: the per-context app
+// session (its own Appium server, homed where the native driver is
+// installed), the preflight that converts environment gaps into SKIPs, and
+// the app-side implementations of startSurface / find / click / type /
+// screenshot / closeSurface.
+import fs from "node:fs";
+import path from "node:path";
+import { resolveHeavyDepPath, resolveHeavyDepPathInCache, resolveHeavyDepSource, ensureRuntimeInstalled, } from "../../runtime/loader.js";
+import { appiumHomeForDriverPath } from "../appium.js";
+import { getRuntimeDir } from "../../runtime/cacheDir.js";
+import { log } from "../utils.js";
+import { resolveCropGeometry } from "./ffmpegRecorder.js";
+import { validate } from "../../common/src/validate.js";
+export { classifyAppIdentifier, defaultAppSurfaceName, classifyNativeSelector, buildUiaLocator, createAppSessionState, appSurfacePreflight, isAppDriverRequired, stepTargetsAppSurface, resolveAppSurfaceRef, startAppSurface, findAppElement, buildAppLocator, closeAppSurface, teardownAppSession, 
+// Exported as a test seam: the manifest-staleness rules are load-bearing
+// (a stale manifest makes the lazily-installed driver invisible to Appium).
+invalidateStaleAppiumManifest, };
+// Classify an `app` identifier by syntax — never by a user-supplied type enum:
+// a `!` marks a UWP AppUserModelID, a path separator (or drive prefix) marks a
+// filesystem path, a reverse-DNS token marks a bundle/package/desktop-file id,
+// and anything else is treated as a (relative) executable path.
+function classifyAppIdentifier(app) {
+    if (app.includes("!"))
+        return "aumid";
+    if (/[\\/]/.test(app) || /^[A-Za-z]:/.test(app))
+        return "path";
+    if (/^[A-Za-z0-9_-]+(\.[A-Za-z0-9_-]+){2,}$/.test(app))
+        return "id";
+    return "path";
+}
+// The default surface-registry name for an app: the executable basename
+// without extension for paths (`notepad.exe` → `notepad`,
+// `Calculator.app` → `Calculator`), the final dot-segment for reverse-DNS ids
+// (`com.apple.TextEdit` → `TextEdit`), and the package family name's app token
+// (before the publisher-hash suffix) for AUMIDs
+// (`Microsoft.WindowsCalculator_8wekyb3d8bbwe!App` → `WindowsCalculator`).
+function defaultAppSurfaceName(app) {
+    const kind = classifyAppIdentifier(app);
+    if (kind === "aumid") {
+        const familyName = app.split("!")[0];
+        const lastSegment = familyName.split(".").pop() ?? familyName;
+        return lastSegment.split("_")[0] || app;
+    }
+    if (kind === "id") {
+        return app.split(".").pop() || app;
+    }
+    const basename = app.split(/[\\/]/).pop() ?? app;
+    const withoutExtension = basename.replace(/\.[A-Za-z0-9]+$/, "");
+    return withoutExtension || basename;
+}
+// The `selector` escape hatch on app surfaces accepts platform-native
+// locators, detected by syntax: `//…`/`(…` is XPath (every native driver
+// speaks it), `~…` is an accessibility id. Anything else is CSS — browser-only,
+// so callers reject it on app surfaces with a pointer to these forms.
+function classifyNativeSelector(selector) {
+    if (selector.startsWith("//") || selector.startsWith("("))
+        return "xpath";
+    if (selector.startsWith("~"))
+        return "accessibilityId";
+    return "css";
+}
+// Escape a value for embedding in an XPath string literal. Values without
+// double quotes embed directly; values with them use concat() (XPath 1.0 has
+// no character escaping inside literals).
+function xpathLiteral(value) {
+    if (!value.includes('"'))
+        return `"${value}"`;
+    const parts = value
+        .split('"')
+        .map((part) => `"${part}"`)
+        .join(`, '"', `);
+    return `concat(${parts})`;
+}
+// Map an ARIA-ish role to a UIA ControlType tag (XPath element name in the
+// Windows driver's XML view). Unknown roles pass through capitalized so new
+// control types work without a table update.
+function uiaControlType(role) {
+    const known = {
+        button: "Button",
+        checkbox: "CheckBox",
+        combobox: "ComboBox",
+        dialog: "Window",
+        document: "Document",
+        link: "Hyperlink",
+        list: "List",
+        listitem: "ListItem",
+        menu: "Menu",
+        menuitem: "MenuItem",
+        radio: "RadioButton",
+        slider: "Slider",
+        tab: "TabItem",
+        table: "Table",
+        text: "Text",
+        textbox: "Edit",
+        toolbar: "ToolBar",
+        tree: "Tree",
+        treeitem: "TreeItem",
+        window: "Window",
+    };
+    return (known[role.toLowerCase()] ?? role.charAt(0).toUpperCase() + role.slice(1));
+}
+// Build a Windows (UIA) locator from the shared semantic element fields —
+// the A1 column of the design's mapping table: elementText → @Name,
+// elementId → AutomationId, elementAria → ControlType (+ @Name),
+// elementTestId → AutomationId. Returns null when no supported field is
+// present (the caller reports which fields ARE supported on app surfaces).
+// A lone elementId/elementTestId uses the driver's "accessibility id"
+// strategy (the AutomationId fast path); anything combined compiles to XPath.
+function buildUiaLocator(criteria) {
+    const automationId = criteria.elementId ?? criteria.elementTestId;
+    const aria = typeof criteria.elementAria === "string"
+        ? { name: criteria.elementAria }
+        : criteria.elementAria;
+    const predicates = [];
+    if (automationId !== undefined)
+        predicates.push(`@AutomationId=${xpathLiteral(automationId)}`);
+    if (criteria.elementText !== undefined)
+        predicates.push(`@Name=${xpathLiteral(criteria.elementText)}`);
+    // elementText and elementAria's name both map to @Name on Windows; when
+    // they carry the same value, one predicate suffices (two would be
+    // redundant; two DIFFERENT values are rejected upstream in buildAppLocator
+    // as an impossible match).
+    if (aria?.name !== undefined && aria.name !== criteria.elementText)
+        predicates.push(`@Name=${xpathLiteral(aria.name)}`);
+    const tag = aria?.role ? uiaControlType(aria.role) : undefined;
+    if (!tag && predicates.length === 0)
+        return null;
+    // Fast path: a lone AutomationId maps to the accessibility id strategy.
+    // (predicates.length === 1 with automationId set already implies no
+    // elementText/aria-name predicate joined it.)
+    if (automationId !== undefined && predicates.length === 1 && !tag) {
+        return { strategy: "accessibility id", value: automationId };
+    }
+    const predicate = predicates.length ? `[${predicates.join(" and ")}]` : "";
+    return { strategy: "xpath", value: `//${tag ?? "*"}${predicate}` };
+}
+// ---------------------------------------------------------------------------
+// Runtime: app sessions, preflight, and app-side step implementations.
+// ---------------------------------------------------------------------------
+const APP_DRIVER_PACKAGE = "appium-novawindows-driver";
+function createAppSessionState() {
+    return { surfaces: new Map(), recordingHost: { state: { recordings: [] } } };
+}
+// Steps that provision or (by object form) target an app surface. Used by
+// runContext to decide whether the app preflight must run for this test.
+function isAppDriverRequired({ test }) {
+    if (!Array.isArray(test?.steps))
+        return false;
+    return test.steps.some((step) => typeof step?.startSurface !== "undefined" || stepTargetsAppSurface(step));
+}
+// True when any action payload in the step names an app surface with the
+// object form ({ app: … }). The bare-string form is identity-only and
+// resolves against the registries at runtime instead.
+function stepTargetsAppSurface(step) {
+    if (!step || typeof step !== "object")
+        return false;
+    return Object.values(step).some((payload) => payload &&
+        typeof payload === "object" &&
+        payload.surface &&
+        typeof payload.surface === "object" &&
+        typeof payload.surface.app === "string");
+}
+// Resolve a step's `surface` reference to a registered app surface, or null
+// when the reference isn't an app reference (browser/process/engine) or names
+// nothing in the registry. Object form is authoritative; a bare string only
+// matches when the registry actually holds that name.
+function resolveAppSurfaceRef(surface, appSession) {
+    if (!appSession)
+        return null;
+    if (surface && typeof surface === "object" && typeof surface.app === "string") {
+        const entry = appSession.surfaces.get(surface.app.trim());
+        if (!entry) {
+            return {
+                error: `No app surface named "${surface.app}" is open. Open it first with startSurface.`,
+            };
+        }
+        return { entry, window: surface.window };
+    }
+    if (typeof surface === "string") {
+        const entry = appSession.surfaces.get(surface.trim());
+        if (entry)
+            return { entry };
+    }
+    return null;
+}
+// Appium discovers extensions by scanning <APPIUM_HOME>/node_modules — but
+// only when its manifest cache (node_modules/.cache/appium/extensions.yaml)
+// doesn't exist yet; an existing manifest is trusted as-is. A driver
+// lazy-installed into a home whose manifest predates it is therefore
+// invisible ("Could not find a driver for automationName …") even though the
+// package is right there. Deleting the manifest cache makes the next server
+// start rebuild it from what's actually installed. No-op when the manifest
+// is absent or already lists the driver.
+function invalidateStaleAppiumManifest(home) {
+    const cacheDir = path.join(home, "node_modules", ".cache", "appium");
+    try {
+        const manifest = fs.readFileSync(path.join(cacheDir, "extensions.yaml"), "utf8");
+        if (!manifest.includes(APP_DRIVER_PACKAGE)) {
+            fs.rmSync(cacheDir, { recursive: true, force: true });
+        }
+    }
+    catch {
+        // Manifest absent/unreadable — appium builds it fresh on start.
+    }
+}
+// Preflight for app surfaces: platform support and driver availability.
+// Returns { ok: true } or a skip reason — an unmet environment is a gating
+// fact (SKIPPED), never a FAIL, matching the `requires` gate semantics.
+// Installing the driver (and, when needed, an Appium copy in the same home)
+// happens here so the failure mode is a clean skip before any step runs.
+async function appSurfacePreflight({ config, platform, deps = {}, }) {
+    if (platform !== "windows") {
+        return {
+            ok: false,
+            reason: `Skipping context on '${platform}': native app surfaces run on Windows only in this phase. Gate the test with runOn platforms (["windows"]) so this skip is intentional.`,
+        };
+    }
+    const ctx = { cacheDir: config?.cacheDir };
+    const resolveSource = deps.resolveSource ?? resolveHeavyDepSource;
+    const resolvePath = deps.resolvePath ?? resolveHeavyDepPath;
+    const resolvePathInCache = deps.resolvePathInCache ?? resolveHeavyDepPathInCache;
+    const ensureInstalled = deps.ensureInstalled ?? ensureRuntimeInstalled;
+    let source = resolveSource(APP_DRIVER_PACKAGE, ctx);
+    if (!source) {
+        try {
+            await ensureInstalled([APP_DRIVER_PACKAGE], { ctx });
+        }
+        catch (error) {
+            return {
+                ok: false,
+                reason: `Skipping context: the Windows app driver (${APP_DRIVER_PACKAGE}) is not installed and could not be installed (${error?.message ?? error}). Install it with \`doc-detective install runtime ${APP_DRIVER_PACKAGE}\` or check network access.`,
+            };
+        }
+        source = resolveSource(APP_DRIVER_PACKAGE, ctx);
+        if (!source) {
+            return {
+                ok: false,
+                reason: `Skipping context: the Windows app driver (${APP_DRIVER_PACKAGE}) did not resolve after install. Inspect the runtime cache and reinstall with \`doc-detective install runtime ${APP_DRIVER_PACKAGE}\`.`,
+            };
+        }
+    }
+    // Appium discovers drivers in <APPIUM_HOME>/node_modules, so the server
+    // must be homed where the driver actually lives. A shim-resolved driver
+    // shares the shim's home with appium; a cache-resolved driver needs an
+    // appium copy in the cache too (a one-time install).
+    if (source === "shim") {
+        const driverEntry = resolvePath(APP_DRIVER_PACKAGE, ctx);
+        const home = driverEntry ? appiumHomeForDriverPath(driverEntry) : null;
+        const appiumEntry = resolvePath("appium", ctx);
+        if (home && appiumEntry) {
+            invalidateStaleAppiumManifest(home);
+            return { ok: true, appiumEntry, appiumHome: home };
+        }
+        // Fall through to the cache path when the shim layout is unexpected —
+        // logged so a spurious cache-side Appium install is diagnosable.
+        log(config, "debug", `The Windows app driver resolved from the shim but its Appium home/entry did not (home: ${home}, appium: ${appiumEntry}); falling back to a cache-side Appium install.`);
+    }
+    if (!resolvePathInCache("appium", ctx)) {
+        try {
+            await ensureInstalled(["appium"], { ctx, force: true });
+        }
+        catch (error) {
+            return {
+                ok: false,
+                reason: `Skipping context: Appium could not be installed alongside the Windows app driver (${error?.message ?? error}).`,
+            };
+        }
+    }
+    const appiumEntry = resolvePathInCache("appium", ctx);
+    if (!appiumEntry) {
+        return {
+            ok: false,
+            reason: `Skipping context: Appium did not resolve from the runtime cache after install.`,
+        };
+    }
+    const appiumHome = getRuntimeDir(ctx);
+    invalidateStaleAppiumManifest(appiumHome);
+    return { ok: true, appiumEntry, appiumHome };
+}
+// Build a driver locator from a step's element criteria (the shared semantic
+// fields) or the native `selector` escape hatch. Returns the locator or an
+// error message naming what is unsupported on app surfaces.
+function buildAppLocator(criteria) {
+    if (typeof criteria.selector === "string") {
+        const kind = classifyNativeSelector(criteria.selector);
+        if (kind === "xpath")
+            return { strategy: "xpath", value: criteria.selector };
+        if (kind === "accessibilityId")
+            return {
+                strategy: "accessibility id",
+                value: criteria.selector.slice(1),
+            };
+        return {
+            error: `CSS selectors are browser-only. On app surfaces, use the semantic fields (elementText, elementId, elementAria) or a native locator: an XPath (//Button[@Name="Save"]) or an accessibility id (~SaveButton).`,
+        };
+    }
+    const unsupported = ["elementClass", "elementAttribute"].filter((field) => criteria[field] !== undefined);
+    if (unsupported.length) {
+        return {
+            error: `${unsupported.join(" and ")} ${unsupported.length > 1 ? "are" : "is"} not supported on app surfaces; use elementText, elementId, elementAria, or a native selector.`,
+        };
+    }
+    // elementText and elementAria's accessible name both map to the SAME
+    // property (@Name) on Windows, so two different values can never match one
+    // element — surface the conflict instead of failing silently as not-found.
+    const ariaName = typeof criteria.elementAria === "string"
+        ? criteria.elementAria
+        : criteria.elementAria?.name;
+    if (criteria.elementText !== undefined &&
+        ariaName !== undefined &&
+        criteria.elementText !== ariaName) {
+        return {
+            error: `elementText ("${criteria.elementText}") and elementAria ("${ariaName}") both map to the accessible Name on app surfaces but have different values — no element can match both. Specify one of them.`,
+        };
+    }
+    const locator = buildUiaLocator(criteria);
+    if (!locator) {
+        return {
+            error: "No app-mappable element criteria specified. Use elementText, elementId, elementTestId, elementAria, or a native selector.",
+        };
+    }
+    return locator;
+}
+// Locate an element on an app surface's driver session. Waits up to `timeout`
+// for existence. Returns the wdio element or an error string.
+async function findAppElement({ driver, criteria, timeout = 5000, }) {
+    const locator = buildAppLocator(criteria);
+    if ("error" in locator)
+        return { error: locator.error };
+    const selector = locator.strategy === "accessibility id"
+        ? `~${locator.value}`
+        : locator.value;
+    // Locate and wait in separate try blocks: driver.$() normally returns a
+    // lazy handle without touching the session, so a throw there means the
+    // session itself is broken (app crash, dead server) — a driver error, not
+    // a criteria miss. Only the waitForExist timeout is the not-found path.
+    let element;
+    try {
+        element = await driver.$(selector);
+    }
+    catch (error) {
+        return {
+            error: `App driver error while locating an element (locator: ${selector}): ${error?.message ?? error}`,
+        };
+    }
+    try {
+        await element.waitForExist({ timeout });
+        return { element };
+    }
+    catch {
+        return {
+            error: `No element matched ${JSON.stringify(criteria)} on the app surface within ${timeout}ms (locator: ${selector}).`,
+        };
+    }
+}
+// The startSurface step (app branch): launch the app through the native
+// driver, wait for readiness, and register the surface. Starts the app
+// session's Appium server on first use.
+async function startAppSurface({ config, step, appSession, platform, serverDeps, }) {
+    const result = { status: "PASS", description: "", outputs: {} };
+    // Validate the step payload like every other handler, so a malformed
+    // descriptor (e.g. missing `app`) fails cleanly instead of throwing.
+    const isValidStep = validate({ schemaKey: "step_v3", object: step });
+    if (!isValidStep.valid) {
+        result.status = "FAIL";
+        result.description = `Invalid step definition: ${isValidStep.errors}`;
+        return result;
+    }
+    step = isValidStep.object;
+    const descriptor = step.startSurface;
+    // Reserved fields land in later phases — fail with the roadmap named
+    // rather than silently ignoring what the author asked for.
+    for (const field of ["device", "install", "activity"]) {
+        if (descriptor[field] !== undefined) {
+            result.status = "FAIL";
+            result.description = `startSurface.${field} is reserved for the mobile phases of the native app roadmap (docs/design/native-app-surfaces.md) and is not implemented yet.`;
+            return result;
+        }
+    }
+    if (descriptor.env !== undefined) {
+        result.status = "FAIL";
+        result.description = `startSurface.env is not supported by the Windows app driver. Set environment variables in the shell that launches Doc Detective, or launch the app via runShell instead.`;
+        return result;
+    }
+    if (platform !== "windows") {
+        result.status = "FAIL";
+        result.description = `startSurface (app) runs on Windows only in this phase. Gate the test with runOn platforms (["windows"]).`;
+        return result;
+    }
+    const appId = descriptor.app.trim();
+    const name = (descriptor.name ?? defaultAppSurfaceName(appId)).trim();
+    if (appSession.surfaces.has(name)) {
+        result.status = "FAIL";
+        result.description = `An app surface named "${name}" is already open. Pass a distinct startSurface.name.`;
+        return result;
+    }
+    // First app surface in this context: bring up the app Appium server.
+    if (!appSession.server) {
+        if (!appSession.appiumEntry || !appSession.appiumHome) {
+            result.status = "FAIL";
+            result.description =
+                "App session is not preflighted; this is a runner bug (runContext must run appSurfacePreflight before app steps).";
+            return result;
+        }
+        try {
+            appSession.server = await serverDeps.startServer(appSession.appiumEntry, appSession.appiumHome);
+        }
+        catch (error) {
+            // Post-preflight server-start failures (port race, resource pressure)
+            // become a clean step FAIL instead of a context-level exception.
+            result.status = "FAIL";
+            result.description = `Couldn't start the app automation server: ${error?.message ?? error}`;
+            return result;
+        }
+    }
+    const capabilities = {
+        platformName: "Windows",
+        "appium:automationName": "NovaWindows",
+        "appium:app": appId,
+        "appium:newCommandTimeout": 600,
+        "wdio:enforceWebDriverClassic": true,
+    };
+    if (Array.isArray(descriptor.args) && descriptor.args.length) {
+        // NovaWindows (like WinAppDriver) takes appArguments as a single string.
+        capabilities["appium:appArguments"] = descriptor.args.join(" ");
+    }
+    if (descriptor.workingDirectory && descriptor.workingDirectory !== ".") {
+        capabilities["appium:appWorkingDir"] = path.resolve(descriptor.workingDirectory);
+    }
+    Object.assign(capabilities, descriptor.driverOptions ?? {});
+    let driver;
+    try {
+        driver = await serverDeps.startDriver(capabilities, appSession.server.port);
+    }
+    catch (error) {
+        result.status = "FAIL";
+        result.description = `Couldn't launch app "${appId}": ${error?.message ?? error}. Check the path/AUMID and that the session is interactive.`;
+        return result;
+    }
+    // Startup readiness: fixed delay and/or an element that must exist.
+    const timeout = descriptor.timeout ?? 60000;
+    if (descriptor.waitUntil?.delayMs) {
+        await new Promise((resolve) => setTimeout(resolve, descriptor.waitUntil.delayMs));
+    }
+    if (descriptor.waitUntil?.find) {
+        const found = await findAppElement({
+            driver,
+            criteria: descriptor.waitUntil.find,
+            timeout,
+        });
+        if (found.error) {
+            try {
+                await driver.deleteSession();
+            }
+            catch {
+                // best-effort: the launch failed readiness; don't mask that error
+            }
+            result.status = "FAIL";
+            result.description = `App "${appId}" launched but never became ready: ${found.error}`;
+            return result;
+        }
+    }
+    appSession.surfaces.set(name, {
+        name,
+        appId,
+        driver,
+        launchedByUs: true,
+    });
+    appSession.activeApp = name;
+    // Late-bind window crops: an autoRecord capture in an app-only context
+    // starts before any app window exists, so it records the full display with
+    // a pending marker. The first app surface to open supplies its window rect
+    // as the crop — scoping the recording to the app under test — which the
+    // stop-side transcode then applies.
+    const pendingHandles = (appSession.recordingHost?.state?.recordings ?? []).filter((handle) => handle?.pendingAppWindowCrop && !handle.crop);
+    for (const handle of pendingHandles) {
+        try {
+            handle.crop = await resolveCropGeometry({ driver, target: "window" });
+            handle.pendingAppWindowCrop = false;
+        }
+        catch (error) {
+            log(config, "warning", `Couldn't resolve the app window geometry for the active recording; it stays full-display. ${error?.message ?? error}`);
+        }
+    }
+    log(config, "debug", `Opened app surface "${name}" (${appId}).`);
+    result.description = `Opened app surface "${name}" (${appId}).`;
+    result.outputs = { name, app: appId };
+    return result;
+}
+// Close a registered app surface: end its driver session (which terminates
+// the app when the driver launched it) and deregister it.
+async function closeAppSurface({ entry, appSession, }) {
+    appSession.surfaces.delete(entry.name);
+    if (appSession.activeApp === entry.name)
+        appSession.activeApp = undefined;
+    try {
+        await entry.driver.deleteSession();
+    }
+    catch {
+        // Idempotent: the app/session may already be gone.
+    }
+}
+// Context teardown: close every remaining app surface, then stop the app
+// session's Appium server. Killing only what we launched is the driver's
+// contract (deleteSession terminates driver-launched apps).
+async function teardownAppSession(appSession, killServer) {
+    if (!appSession)
+        return;
+    for (const entry of [...appSession.surfaces.values()]) {
+        await closeAppSurface({ entry, appSession });
+    }
+    if (appSession.server) {
+        await killServer(appSession.server.process?.pid);
+        appSession.server = undefined;
+    }
+}
+//# sourceMappingURL=appSurface.js.map

package/dist/core/tests/appSurface.js.map

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