@lingxia/test 0.18.0 → 0.20.0

package/dist/clock.d.ts

@@ -0,0 +1,30 @@
+import type { ClockDriver, HostRunAutomation } from "@lingxia/types/automation";
+import type { TestClock } from "./types.js";
+/** The fixture surface the clock wrapper needs. */
+export interface ClockHost {
+    act<T>(name: string, detail: string, op: () => T | Promise<T>): Promise<T>;
+    diagnostic(phase: string, message: string, level?: "info"): void | Promise<void>;
+}
+/**
+ * Clocks one spec installed, by lxapp id. The runner uninstalls them when
+ * the spec ends, so the next spec starts on real time; an app that closed or
+ * reopened since is back on real time already.
+ */
+export declare class ClockScope {
+    readonly apps: Set<string>;
+    /** Test timers still pending when the spec's clocks were uninstalled. */
+    dropped: number;
+    private automation;
+    track(appid: string, automation: () => HostRunAutomation): void;
+    /** Uninstall every tracked clock; rejects naming those that failed. */
+    reclaim(diagnostic: (phase: string, message: string, level?: "info") => void | Promise<void>): Promise<void>;
+}
+/**
+ * `resolve` reads the raw driver lazily, inside each traced call: a host
+ * without the test clock then fails that call, never the `t.app.clock` read.
+ */
+export declare function wrapClock(resolve: () => {
+    driver: ClockDriver | undefined;
+    appid: () => Promise<string>;
+}, host: ClockHost, scope: ClockScope, automation: () => HostRunAutomation): TestClock;
+//# sourceMappingURL=clock.d.ts.map

package/dist/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../src/clock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,WAAW,EAMX,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,mDAAmD;AACnD,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3E,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClF;AAeD;;;;GAIG;AACH,qBAAa,UAAU;IACrB,QAAQ,CAAC,IAAI,cAAqB;IAClC,yEAAyE;IACzE,OAAO,SAAK;IACZ,OAAO,CAAC,UAAU,CAAwC;IAE1D,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,GAAG,IAAI;IAK/D,uEAAuE;IACjE,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAqBnH;AAmBD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM;IAAE,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,EAChF,IAAI,EAAE,SAAS,EACf,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,MAAM,iBAAiB,GAClC,SAAS,CA2BX"}

package/dist/clock.js

@@ -0,0 +1,99 @@
+/** The host's record, as a plain object of exactly these keys. */
+function clockState({ now, pending }) {
+    return { now, pending };
+}
+function clockAdvance({ now, pending, fired }) {
+    return { now, pending, fired };
+}
+function droppedNote(dropped, when) {
+    return `${when} dropped ${dropped} pending test timer${dropped === 1 ? "" : "s"}; they never fired`;
+}
+/**
+ * Clocks one spec installed, by lxapp id. The runner uninstalls them when
+ * the spec ends, so the next spec starts on real time; an app that closed or
+ * reopened since is back on real time already.
+ */
+export class ClockScope {
+    constructor() {
+        this.apps = new Set();
+        /** Test timers still pending when the spec's clocks were uninstalled. */
+        this.dropped = 0;
+    }
+    track(appid, automation) {
+        this.apps.add(appid);
+        this.automation = automation;
+    }
+    /** Uninstall every tracked clock; rejects naming those that failed. */
+    async reclaim(diagnostic) {
+        const automation = this.automation;
+        if (!automation)
+            return;
+        const failed = [];
+        for (const id of [...this.apps]) {
+            // Select the app again: a profile rollback may have reopened it.
+            // Raw driver: the fixture is closed by now.
+            try {
+                const result = await automation().lxapp(id).clock.uninstall();
+                this.dropped += result.dropped;
+                // The spec installed this clock: removing it is expected, not a warning.
+                if (result.dropped > 0)
+                    await diagnostic("clock", droppedNote(result.dropped, `the spec's end uninstalled the test clock of ${id} and`), "info");
+                this.apps.delete(id);
+            }
+            catch (error) {
+                // A closed app took its Logic, and the clock with it.
+                if (appGone(error)) {
+                    this.apps.delete(id);
+                    continue;
+                }
+                failed.push(`${id}: ${String(error?.message ?? error)}`);
+            }
+        }
+        if (failed.length > 0)
+            throw new Error(`test clocks were not uninstalled (${failed.join("; ")})`);
+    }
+}
+/** The host's answer for an app that is not running. */
+function appGone(error) {
+    return /lxapp is not active:/.test(String(error?.message ?? error));
+}
+/** `install({ now })` / `setSystemTime` detail for the trace. */
+function describeTime(time) {
+    if (time === undefined)
+        return "";
+    if (time instanceof Date)
+        return Number.isNaN(time.getTime()) ? "Invalid Date" : time.toISOString();
+    return String(time);
+}
+/** A `Date` crosses to the host as epoch milliseconds. */
+function toWire(time) {
+    return time instanceof Date ? time.getTime() : time;
+}
+/**
+ * `resolve` reads the raw driver lazily, inside each traced call: a host
+ * without the test clock then fails that call, never the `t.app.clock` read.
+ */
+export function wrapClock(resolve, host, scope, automation) {
+    const driver = () => resolve().driver;
+    return {
+        install: (options) => host.act("clock.install", describeTime(options?.now), async () => {
+            const clock = driver();
+            const now = options?.now === undefined ? undefined : toWire(options.now);
+            // An explicit `undefined` argument is not "no options" to the host:
+            // omit it instead.
+            const result = await (now === undefined ? clock.install() : clock.install({ now }));
+            scope.track(await resolve().appid(), automation);
+            return clockState(result);
+        }),
+        tick: (ms) => host.act("clock.tick", `${ms}ms`, async () => clockAdvance(await driver().tick(ms))),
+        runAll: (options) => host.act("clock.runAll", options?.maxTimers === undefined ? "" : `max ${options.maxTimers}`, async () => clockAdvance(await (options === undefined ? driver().runAll() : driver().runAll(options)))),
+        setSystemTime: (time) => host.act("clock.setSystemTime", describeTime(time), async () => clockState(await driver().setSystemTime(toWire(time)))),
+        uninstall: () => host.act("clock.uninstall", "", async () => {
+            const result = await driver().uninstall();
+            scope.dropped += result.dropped;
+            if (result.dropped > 0)
+                await host.diagnostic("clock", droppedNote(result.dropped, "clock.uninstall"), "info");
+        }),
+    };
+}
+//# sourceMappingURL=clock.js.map

package/dist/clock.js.map

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

package/dist/coverage.d.ts

@@ -0,0 +1,25 @@
+import type { CaseRecord, CoverageSummary } from "./report-types.js";
+/** One requirement of a `--covers-manifest` file, as lxdev sends it. */
+export interface ManifestEntry {
+    id: string;
+    title?: string;
+}
+/** A registered spec, whether or not this selection ran it. */
+export interface RegisteredCover {
+    id: string;
+    title: string;
+    covers: readonly string[];
+}
+/**
+ * `control.coversManifest` is a JSON list of `{ id, title? }`; lxdev has
+ * already read and checked the file. Anything else is a broken control.
+ */
+export declare function parseManifest(raw: string | undefined): ManifestEntry[] | undefined;
+/**
+ * Which manifest ids the suite covers, by which specs and with what outcome;
+ * which have no spec at all; and which `covers` ids are not in the manifest.
+ * A spec registered but outside this selection still covers its ids, as
+ * `not_run`, so a filtered run never reports a false hole.
+ */
+export declare function coverageSummary(manifest: readonly ManifestEntry[], cases: readonly CaseRecord[], registered: readonly RegisteredCover[]): CoverageSummary;
+//# sourceMappingURL=coverage.d.ts.map

package/dist/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../src/coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAgB,eAAe,EAAc,MAAM,mBAAmB,CAAC;AAE/F,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+DAA+D;AAC/D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,EAAE,GAAG,SAAS,CAclF;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,SAAS,aAAa,EAAE,EAClC,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,UAAU,EAAE,SAAS,eAAe,EAAE,GACrC,eAAe,CAmCjB"}

package/dist/coverage.js

@@ -0,0 +1,92 @@
+/**
+ * `control.coversManifest` is a JSON list of `{ id, title? }`; lxdev has
+ * already read and checked the file. Anything else is a broken control.
+ */
+export function parseManifest(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed))
+        throw new Error("coversManifest control must be a JSON list");
+    const seen = new Set();
+    return parsed.map((entry, index) => {
+        const record = (entry && typeof entry === "object" ? entry : {});
+        if (typeof record.id !== "string" || record.id.length === 0) {
+            throw new Error(`coversManifest entry ${index} has no id`);
+        }
+        if (seen.has(record.id))
+            throw new Error(`coversManifest lists ${JSON.stringify(record.id)} twice`);
+        seen.add(record.id);
+        return typeof record.title === "string" ? { id: record.id, title: record.title } : { id: record.id };
+    });
+}
+const BROKEN = new Set(["failed", "timeout", "xpass"]);
+/**
+ * Which manifest ids the suite covers, by which specs and with what outcome;
+ * which have no spec at all; and which `covers` ids are not in the manifest.
+ * A spec registered but outside this selection still covers its ids, as
+ * `not_run`, so a filtered run never reports a false hole.
+ */
+export function coverageSummary(manifest, cases, registered) {
+    const ran = new Map();
+    for (const item of cases) {
+        const list = ran.get(item.id) ?? [];
+        list.push(item);
+        ran.set(item.id, list);
+    }
+    const specsFor = (id) => registered
+        .filter((spec) => spec.covers.includes(id))
+        .map((spec) => ({ id: spec.id, title: spec.title, status: outcome(ran.get(spec.id)) }));
+    const known = new Set(manifest.map((entry) => entry.id));
+    const ids = manifest.map((entry) => {
+        const specs = specsFor(entry.id);
+        return { ...entry, status: rollUp(specs), specs };
+    });
+    const unknown = new Map();
+    for (const spec of registered) {
+        for (const id of spec.covers) {
+            if (known.has(id))
+                continue;
+            const list = unknown.get(id) ?? [];
+            if (!list.includes(spec.id))
+                list.push(spec.id);
+            unknown.set(id, list);
+        }
+    }
+    const covered = ids.filter((entry) => entry.specs.length > 0);
+    return {
+        total: manifest.length,
+        covered: covered.length,
+        passing: covered.filter((entry) => entry.status === "passed").length,
+        failing: covered.filter((entry) => entry.status === "failed").length,
+        uncovered: ids.filter((entry) => entry.specs.length === 0).map(({ id, title }) => (title ? { id, title } : { id })),
+        unknown: [...unknown.entries()].sort(([a], [b]) => a.localeCompare(b)).map(([id, specs]) => ({ id, specs })),
+        ids,
+    };
+}
+/** A spec's outcome across its executions (repeats): any break wins. */
+function outcome(executions) {
+    if (!executions || executions.length === 0)
+        return "not_run";
+    const broken = executions.find((item) => BROKEN.has(item.status));
+    if (broken)
+        return broken.status;
+    if (executions.some((item) => item.status === "passed"))
+        return "passed";
+    return executions[0].status;
+}
+/** An id is `failed` if any spec broke, `passed` if one passed, else what is left. */
+function rollUp(specs) {
+    if (specs.length === 0)
+        return "uncovered";
+    if (specs.some((spec) => BROKEN.has(spec.status)))
+        return "failed";
+    if (specs.some((spec) => spec.status === "passed"))
+        return "passed";
+    if (specs.some((spec) => spec.status === "xfail"))
+        return "xfail";
+    if (specs.some((spec) => spec.status === "skipped"))
+        return "skipped";
+    return "not_run";
+}
+//# sourceMappingURL=coverage.js.map

package/dist/coverage.js.map

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

package/dist/deadline.d.ts

@@ -0,0 +1,82 @@
+/**
+ * A fixture call or budget ran out: `t.waitFor`, `waitForCall`, a driver
+ * call raced against an action budget or timing out itself (its own code is
+ * `cause.code` and `data.driverCode`), cleanup, or the spec itself.
+ */
+export declare class TimeoutError extends Error {
+    readonly name = "TimeoutError";
+    readonly code: "E_TIMEOUT";
+    data?: unknown;
+}
+/**
+ * One timeout code at the fixture boundary: a driver rejection that timed
+ * out becomes a `TimeoutError` whose `cause` is the driver's error; anything
+ * else passes through.
+ */
+export declare function asFixtureTimeout(error: unknown): unknown;
+/**
+ * The budget of one retrying action or assertion. The requested timeout is
+ * clamped to what is left of the spec (or cleanup) budget, so an action never
+ * outlives the spec silently, and every driver call is raced against what is
+ * left of it, so a call that never returns fails the action by name instead of
+ * surfacing as an anonymous spec timeout.
+ *
+ * JS can only stop waiting: a native call that blocks the JS thread cannot be
+ * preempted, and a call abandoned here may still complete in the app.
+ */
+export declare class ActionDeadline {
+    readonly started: number;
+    readonly timeout: number;
+    /** The timeout the caller asked for, when the spec budget cut it. */
+    readonly clampedFrom: number | undefined;
+    /** The budget's timer fired: a timer can fire a millisecond before `Date.now()` agrees. */
+    private lapsed;
+    constructor(requested: number, room?: number);
+    elapsed(): number;
+    remaining(): number;
+    expired(): boolean;
+    /** One line explaining a clamp, or `undefined` when the timeout is as asked. */
+    clampNote(): string | undefined;
+    /**
+     * Race `op` against the rest of this budget. On expiry the rejection names
+     * the call and `context()` (the action, its target and location); the
+     * abandoned promise is left to settle on its own.
+     */
+    call<T>(label: string, op: () => T | Promise<T>, context: () => string): Promise<T>;
+}
+/** The stable `code` of a driver rejection, when it carries one. */
+export declare function errorCode(error: unknown): string | undefined;
+/**
+ * Errors the page drivers raise while a page is being replaced: the target is
+ * not the active instance yet, or its WebView is not attached. They occur
+ * before anything reaches the page, so retrying them is safe. Matched by code
+ * (`E_PAGE_NOT_ACTIVE`, `E_PAGE_NOT_READY`), plus WebView2's
+ * `ERROR_INVALID_STATE` (`0x8007139F`) while a navigation replaces the
+ * document, which carries no code of its own.
+ */
+export declare function isTransientPageError(error: unknown): boolean;
+/**
+ * The subset of transient errors that are raised while resolving the target
+ * page, before input dispatch. A WebView2 script error during dispatch is
+ * ambiguous (the input may have landed), so it is not in this set.
+ */
+export declare function isPreDispatchPageError(error: unknown): boolean;
+/**
+ * The element was missing or not interactable at dispatch: the native side
+ * refused before any input reached the page, so a retry is safe.
+ */
+export declare function isElementRefusal(error: unknown): boolean;
+/**
+ * The transport between the test runtime and the app dropped a call: the
+ * socket would block or was reset, or the channel closed under it. Only an
+ * idempotent read may be retried on it; for input it is ambiguous, since the
+ * call may have landed before the reply was lost.
+ */
+export declare function isTransientTransportError(error: unknown): boolean;
+/**
+ * Match the public error or a preserved cause, without changing either: an
+ * error's `cause`, or the `data.cause` a driver reports for what the app
+ * rejected with (a page action, an `lx.*` error thrown in `logic.eval`).
+ */
+export declare function matchesErrorCode(error: unknown, expected: string): boolean;
+//# sourceMappingURL=deadline.d.ts.map

package/dist/deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../src/deadline.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAkB,IAAI,kBAAkB;IACxC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IACrC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAKD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQxD;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,OAAO,SAAc;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,2FAA2F;IAC3F,OAAO,CAAC,MAAM,CAAS;gBAEX,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,MAAiC;IAMtE,OAAO,IAAI,MAAM;IAIjB,SAAS,IAAI,MAAM;IAInB,OAAO,IAAI,OAAO;IAIlB,gFAAgF;IAChF,SAAS,IAAI,MAAM,GAAG,SAAS;IAM/B;;;;OAIG;IACG,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CA8B1F;AAED,oEAAoE;AACpE,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAG5D;AAKD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAI5D;AAOD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG9D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAGxD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAa1E"}

package/dist/deadline.js

@@ -0,0 +1,184 @@
+import { runnerClearTimeout, runnerSetTimeout } from "./pending.js";
+/**
+ * A fixture call or budget ran out: `t.waitFor`, `waitForCall`, a driver
+ * call raced against an action budget or timing out itself (its own code is
+ * `cause.code` and `data.driverCode`), cleanup, or the spec itself.
+ */
+export class TimeoutError extends Error {
+    constructor() {
+        super(...arguments);
+        this.name = "TimeoutError";
+        this.code = "E_TIMEOUT";
+    }
+}
+/** The driver codes a fixture call reports as `E_TIMEOUT`. */
+const DRIVER_TIMEOUT_CODES = new Set(["E_AUTOMATION_TIMEOUT", "E_EVAL_TIMEOUT", "E_DESKTOP_TIMEOUT"]);
+/**
+ * One timeout code at the fixture boundary: a driver rejection that timed
+ * out becomes a `TimeoutError` whose `cause` is the driver's error; anything
+ * else passes through.
+ */
+export function asFixtureTimeout(error) {
+    const code = errorCode(error);
+    if (code === undefined || !DRIVER_TIMEOUT_CODES.has(code))
+        return error;
+    const timeout = new TimeoutError(error instanceof Error ? error.message : String(error));
+    const data = error.data;
+    timeout.data = data && typeof data === "object" ? { ...data, driverCode: code } : { driverCode: code };
+    timeout.cause = error;
+    return timeout;
+}
+/**
+ * The budget of one retrying action or assertion. The requested timeout is
+ * clamped to what is left of the spec (or cleanup) budget, so an action never
+ * outlives the spec silently, and every driver call is raced against what is
+ * left of it, so a call that never returns fails the action by name instead of
+ * surfacing as an anonymous spec timeout.
+ *
+ * JS can only stop waiting: a native call that blocks the JS thread cannot be
+ * preempted, and a call abandoned here may still complete in the app.
+ */
+export class ActionDeadline {
+    constructor(requested, room = Number.POSITIVE_INFINITY) {
+        this.started = Date.now();
+        /** The budget's timer fired: a timer can fire a millisecond before `Date.now()` agrees. */
+        this.lapsed = false;
+        const available = Math.max(1, Math.floor(room));
+        this.timeout = requested > available ? available : requested;
+        this.clampedFrom = requested > available ? requested : undefined;
+    }
+    elapsed() {
+        return Date.now() - this.started;
+    }
+    remaining() {
+        return this.timeout - this.elapsed();
+    }
+    expired() {
+        return this.lapsed || this.remaining() <= 0;
+    }
+    /** One line explaining a clamp, or `undefined` when the timeout is as asked. */
+    clampNote() {
+        return this.clampedFrom === undefined
+            ? undefined
+            : `timeout ${this.clampedFrom}ms was clamped to ${this.timeout}ms, the time left in the spec's budget`;
+    }
+    /**
+     * Race `op` against the rest of this budget. On expiry the rejection names
+     * the call and `context()` (the action, its target and location); the
+     * abandoned promise is left to settle on its own.
+     */
+    async call(label, op, context) {
+        const ms = this.remaining();
+        const expired = () => new TimeoutError([
+            `${label} was not started because the ${this.timeout}ms action budget expired.`,
+            this.clampNote(),
+            context(),
+        ].filter(Boolean).join("\n"));
+        if (ms <= 0)
+            throw expired();
+        const task = Promise.resolve().then(() => {
+            if (this.expired())
+                throw expired();
+            return op();
+        });
+        let handle;
+        const expiry = new Promise((_, reject) => {
+            handle = runnerSetTimeout(() => {
+                this.lapsed = true;
+                task.catch(() => { });
+                reject(new TimeoutError([
+                    `${label} did not return within ${ms}ms, the rest of the ${this.timeout}ms action budget.`,
+                    this.clampNote(),
+                    context(),
+                ].filter(Boolean).join("\n")));
+            }, ms);
+        });
+        try {
+            return await Promise.race([task, expiry]);
+        }
+        finally {
+            if (handle !== undefined)
+                runnerClearTimeout(handle);
+        }
+    }
+}
+/** The stable `code` of a driver rejection, when it carries one. */
+export function errorCode(error) {
+    const code = error && typeof error === "object" ? error.code : undefined;
+    return typeof code === "string" ? code : undefined;
+}
+/** Page-readiness codes: the target was not reached, so a retry is safe. */
+const PAGE_NOT_READY_CODES = new Set(["E_PAGE_NOT_ACTIVE", "E_PAGE_NOT_READY"]);
+/**
+ * Errors the page drivers raise while a page is being replaced: the target is
+ * not the active instance yet, or its WebView is not attached. They occur
+ * before anything reaches the page, so retrying them is safe. Matched by code
+ * (`E_PAGE_NOT_ACTIVE`, `E_PAGE_NOT_READY`), plus WebView2's
+ * `ERROR_INVALID_STATE` (`0x8007139F`) while a navigation replaces the
+ * document, which carries no code of its own.
+ */
+export function isTransientPageError(error) {
+    const code = errorCode(error);
+    if (code !== undefined && PAGE_NOT_READY_CODES.has(code))
+        return true;
+    return isWebView2InvalidState(error);
+}
+function isWebView2InvalidState(error) {
+    const message = error instanceof Error ? error.message : typeof error === "string" ? error : "";
+    return /0x8007139f/i.test(message);
+}
+/**
+ * The subset of transient errors that are raised while resolving the target
+ * page, before input dispatch. A WebView2 script error during dispatch is
+ * ambiguous (the input may have landed), so it is not in this set.
+ */
+export function isPreDispatchPageError(error) {
+    const code = errorCode(error);
+    return code !== undefined && PAGE_NOT_READY_CODES.has(code);
+}
+/**
+ * The element was missing or not interactable at dispatch: the native side
+ * refused before any input reached the page, so a retry is safe.
+ */
+export function isElementRefusal(error) {
+    const code = errorCode(error);
+    return code === "E_ELEMENT_NOT_FOUND" || code === "E_ELEMENT_NOT_INTERACTABLE";
+}
+/**
+ * The transport between the test runtime and the app dropped a call: the
+ * socket would block or was reset, or the channel closed under it. Only an
+ * idempotent read may be retried on it; for input it is ambiguous, since the
+ * call may have landed before the reply was lost.
+ */
+export function isTransientTransportError(error) {
+    if (errorCode(error) === "E_TRANSPORT")
+        return true;
+    const message = error instanceof Error ? error.message : typeof error === "string" ? error : "";
+    if (!message)
+        return false;
+    return /os error (?:11|35|54|104)\b|resource temporarily unavailable|connection reset|broken pipe|channel closed|websocket (?:closed|disconnected|frame)/i
+        .test(message);
+}
+/**
+ * Match the public error or a preserved cause, without changing either: an
+ * error's `cause`, or the `data.cause` a driver reports for what the app
+ * rejected with (a page action, an `lx.*` error thrown in `logic.eval`).
+ */
+export function matchesErrorCode(error, expected) {
+    const seen = new Set();
+    const pending = [error];
+    while (pending.length > 0) {
+        const next = pending.pop();
+        if (next === null || typeof next !== "object" || seen.has(next))
+            continue;
+        if (errorCode(next) === expected)
+            return true;
+        seen.add(next);
+        pending.push(next.cause);
+        const data = next.data;
+        if (data && typeof data === "object")
+            pending.push(data.cause);
+    }
+    return false;
+}
+//# sourceMappingURL=deadline.js.map

package/dist/deadline.js.map

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

package/dist/dialogs.d.ts

@@ -0,0 +1,28 @@
+import type { DialogDriver, LxAppDriver } from "@lingxia/types/automation";
+import type { TestDialogs } from "./types.js";
+/** The fixture surface the dialogs wrapper needs. */
+export interface DialogsHost {
+    act<T>(name: string, detail: string, op: () => T | Promise<T>): Promise<T>;
+}
+/**
+ * `resolve` reads the raw driver lazily, inside each traced call: a host
+ * without dialog watching fails that call, never the `t.app.dialogs` read.
+ */
+export declare function wrapDialogs(resolve: () => DialogDriver, host: DialogsHost, ensure: () => Promise<void>): TestDialogs;
+/** One spec's watch of the app under test's dialogs. */
+export interface DialogWatch {
+    /** Resolves the first dialog that found no answer; never resolves otherwise. */
+    readonly unanswered: Promise<string>;
+    /**
+     * Stop watching, through `driver` (the app under test as selected now: a
+     * profile switch reopens it); what the spec queued and no dialog used, or
+     * `undefined` when nothing is left.
+     */
+    end(driver: LxAppDriver): Promise<string | undefined>;
+}
+/**
+ * Watch the app's dialogs for the spec that starts now. `undefined` on a
+ * host without dialog watching. A refused watch fails spec setup.
+ */
+export declare function watchDialogs(driver: LxAppDriver): DialogWatch | undefined;
+//# sourceMappingURL=dialogs.d.ts.map

package/dist/dialogs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogs.d.ts","sourceRoot":"","sources":["../src/dialogs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EAEZ,WAAW,EAEZ,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC5E;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,CA8BpH;AAED,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CA6BzE"}