@rehearsal-labs/retest 0.1.0 → 0.3.0

package/README.md

@@ -25,7 +25,7 @@ There is no Playwright, Puppeteer or Selenium underneath. Retest is early, and t
 
 ## Quick start
 
-You need Node.js 24.12 or later, on macOS or Linux.
+You need Node.js 24.12 or later, on macOS, Linux or Windows x64. Windows also needs Retest's process supervisor, which [the guide](docs/guide.md#windows) says how to install.
 
 ```sh
 npm install --save-dev @rehearsal-labs/retest typescript @types/node
@@ -72,22 +72,29 @@ npx retest install --list     # what is pinned for this machine; downloads nothi
 npx retest install firefox    # also chromium, webkit and electron
 ```
 
-On macOS on Apple silicon, Retest pins Chrome for Testing, Firefox 133, Playwright's WebKit build 2359 and Electron 44.5.1. On Linux x64 it pins Chrome for Testing only. A Firefox target finds the installed build by itself. Give a Chromium, WebKit or Electron target the path that `retest install` prints.
+On macOS on Apple silicon, Retest pins Chrome for Testing, Firefox 158.0.1, WebKit build 2359 and Electron 44.5.1. On Windows x64 it pins Chrome for Testing, Firefox 158.0.1 and Electron 44.5.1. On Linux x64 it pins Chrome for Testing only. A Firefox target finds the installed build by itself. Give a Chromium, WebKit or Electron target the path that `retest install` prints.
 
 ## What runs today
 
 | | |
 | --- | --- |
-| Browsers | Chrome and Chromium. Firefox 133 and WebKit build 2359 on macOS on Apple silicon |
+| Browsers | Chrome and Chromium. Firefox 158.0.1 on macOS on Apple silicon and on Windows x64. WebKit build 2359 on macOS on Apple silicon |
 | iOS simulator apps | Find, tap, fill and check elements through WebDriverAgent, built on your Mac from a pinned commit |
 | macOS apps | Find, click, fill and check elements through the macOS runner of appium-mac2-driver |
-| Electron apps | The app's first window, driven like a Chrome page. Checked with Electron 44.5.1 on macOS |
+| Electron apps | The app's first window, driven like a Chrome page. Checked with Electron 44.5.1 on macOS and Windows |
 | One test across platforms | An iOS simulator app, a macOS app and web apps in the same test |
 | AI checks | `test.evaluate` asks a judge you choose whether a screenshot, text or recorded frames meet a requirement |
+| Layout checks | Overlapping elements, cut-off text, an element past the viewport's right edge and sideways scroll, each measured in pixels. Checked on Chrome on macOS |
+| Screenshot baselines | A page or an element compared to a saved image, pixel by pixel, with the difference in the report. Checked on Chrome on macOS |
+| Test inboxes | A test reads a one-time code and a sign-in link from a mailbox your config reads, types and opens them, and never holds either. Checked on Chrome. [The guide](docs/guide.md#inboxes) says how |
+| Files | Upload by path or content, intercept the file picker, save downloads as artifacts. Checked on Chrome on macOS |
+| Dialogs and popups | Accept or dismiss alert, confirm, prompt and beforeunload; drive a page the app opens. Checked on Chrome on macOS |
+| Mocked responses and drag | Answer a request with your own response or refuse it; drag an element onto another. Checked on Chrome on macOS |
 | Playwright test files | `retest run --playwright` runs `.spec.ts` files unchanged, for the methods [the guide](docs/guide.md#run-playwright-test-files) lists |
 | Linux | Chrome and Chromium only, checked inside Docker |
+| Windows x64 | Chrome, Chromium, Firefox and Electron, with recordings on Chrome. Nothing a run starts outlives Retest. Checked on Windows Server 2025 on GitHub's runner |
 
-Not yet: Android apps, Windows, Safari, and real phones or tablets.
+Not yet: Android apps, Safari, and real phones or tablets. [The guide](docs/guide.md#windows) says what Windows does not run yet.
 
 ## One test across platforms
 

package/dist/agent/session.d.ts

@@ -1,6 +1,7 @@
 import type { InputDispatch, OwnedBrowser, OwnedPage, SessionIdentity, WebEngine, WebRuntimeIdentity } from '../browser/contract.ts';
 import type { FrameSource } from '../media/capture.ts';
 import type { CommandResult, Observation, PageCommand } from '../protocol/commands.ts';
+import type { DialogAnswered, DialogType } from '../protocol/dialogs.ts';
 import type { Failure } from '../protocol/failures.ts';
 import type { HostCheck, HostCheckRecord } from '../protocol/host-check.ts';
 import type { LocatorRecipe } from '../protocol/locator.ts';
@@ -61,6 +62,18 @@ export type AgentAction = {
     readonly result: CommandResult;
     readonly input: InputDispatch;
     readonly locator?: LocatorRecipe;
+    readonly dialogs?: readonly AgentDialog[];
+};
+/**
+ * A JavaScript dialog the page showed that Retest answered, since an agent session takes no dialog: its kind, its text,
+ * redacted, how Retest answered it, and `words`, a sentence for the agent. One that showed between calls is named in the
+ * answer of the next action or look, under `dialogs`; one that showed during an action is named in its failure.
+ */
+export type AgentDialog = {
+    readonly type: DialogType;
+    readonly message: string;
+    readonly answered: DialogAnswered;
+    readonly words: string;
 };
 /** An element a look listed: its reference, and its text and visibility as the look saw them, redacted. */
 export type LookedElement = {
@@ -81,12 +94,14 @@ export type AgentLook = {
     readonly page?: PageFacts;
 };
 /** A look's answer: the look, or why there is none. */
-export type AgentObserved = {
+export type AgentObserved = ({
     readonly ok: true;
     readonly look: AgentLook;
 } | {
     readonly ok: false;
     readonly failure: Failure;
+}) & {
+    readonly dialogs?: readonly AgentDialog[];
 };
 /** A look at the page itself: its id and session, and the page's address and title, redacted. It lists no element. */
 export type AgentPageLook = {
@@ -95,12 +110,14 @@ export type AgentPageLook = {
     readonly url: string | null;
     readonly title: string | null;
 };
-export type AgentObservedPage = {
+export type AgentObservedPage = ({
     readonly ok: true;
     readonly page: AgentPageLook;
 } | {
     readonly ok: false;
     readonly failure: Failure;
+}) & {
+    readonly dialogs?: readonly AgentDialog[];
 };
 /** A durable recipe made from a reference, or why a read could not prove it finds the referenced element. */
 export type AgentRecipe = {
@@ -258,6 +275,8 @@ export declare class AgentSession {
     /** The session whose saved state this one started from, when it started from one. */
     readonly restoredFrom: string | undefined;
     constructor(parts: SessionParts);
+    /** Every JavaScript dialog the session's page showed, which Retest answered, in order. */
+    get answeredDialogs(): readonly AgentDialog[];
     /** The session's id, which every look, reference and frame it serves carries. */
     get sessionId(): string;
     /** The app the session plays, as its host named it. */

package/dist/agent/session.d.ts.map

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

package/dist/agent/session.js

@@ -1,8 +1,10 @@
+import { withPickerAdvice } from "../browser/file-chooser.js";
 import { Deadline, smallestBudget } from "../protocol/deadline.js";
 import { describeCommand, pageCommandSchema } from "../protocol/commands.js";
+import { unwaitedDialogMessage, withDialogWords } from "../protocol/dialogs.js";
 import { errorMessage, failure, failureSchema } from "../protocol/failures.js";
 import { parseKey } from "../protocol/keys.js";
-import { describeLocator, locatorProblem, locatorSteps } from "../protocol/locator.js";
+import { describeLocator, everyStep, locatorProblem } from "../protocol/locator.js";
 import { selectCommandProblem } from "../protocol/option-choices.js";
 import { isPlainObject, parse } from "../protocol/schema.js";
 import { scrollProblem } from "../protocol/scroll-delta.js";
@@ -55,6 +57,11 @@ export class AgentSession {
     #running = new Set();
     #sources = new Set();
     #listeners = [];
+    // Every dialog Retest answered on the session's page, and those not named in an answer yet.
+    #answeredDialogs = [];
+    #dialogsSince = [];
+    // The command on the page now, as a dialog that shows meanwhile names it.
+    #onPage;
     #ended = Promise.withResolvers();
     #holdTimer;
     #leaseTimer;
@@ -81,13 +88,17 @@ export class AgentSession {
         this.#listeners.push(parts.page.onNavigation((navigation) => {
             if (navigation.document === 'new')
                 this.#looks.nextDocument();
-        }), parts.browser.onDisconnect((reason) => void this.#finish({ kind: 'lost', reason: failure('session_lost', `The browser of session ${parts.identity.sessionId} was lost: ${reason}`) })));
+        }), parts.browser.onDisconnect((reason) => void this.#finish({ kind: 'lost', reason: failure('session_lost', `The browser of session ${parts.identity.sessionId} was lost: ${reason}`) })), parts.page.onUnwaitedDialog?.((dialog) => this.#heardDialog(dialog)) ?? (() => undefined));
         this.#holdTimer = setTimeout(() => {
             const reason = failure('timeout', `Session ${parts.identity.sessionId} held its browser for its whole ${parts.holdMs} ms hold, so Retest ended it.`);
             void this.#finish({ kind: 'held_too_long', reason: { ...reason, details: { holdMs: parts.holdMs } } });
         }, timerMs(parts.holdMs));
         this.#renewLease();
     }
+    /** Every JavaScript dialog the session's page showed, which Retest answered, in order. */
+    get answeredDialogs() {
+        return [...this.#answeredDialogs];
+    }
     /** The session's id, which every look, reference and frame it serves carries. */
     get sessionId() {
         return this.identity.sessionId;
@@ -141,13 +152,13 @@ export class AgentSession {
             const startedOn = this.#looks.generation;
             const read = await this.#readOne(locator, timeoutMs, signal);
             if (!read.ok)
-                return read;
+                return { ...read, ...this.#dialogsNamed() };
             // The look keeps a copy of the locator, so a caller that changes its own object later cannot move a reference.
             const look = this.#looks.serve(structuredClone(locator), read.observation, startedOn, read.keys);
             const observation = this.#host.redactor.redactObservation(look.observation);
             const elements = observation.items.map((item, element) => ({ ref: { sessionId: this.sessionId, observationId: look.observationId, element }, text: item.text, visible: item.visible }));
             const page = read.page === undefined ? {} : { page: this.#redactedPage(read.page) };
-            return { ok: true, look: { sessionId: this.sessionId, observationId: look.observationId, locator: structuredClone(look.locator), observation, elements, ...page } };
+            return { ok: true, look: { sessionId: this.sessionId, observationId: look.observationId, locator: structuredClone(look.locator), observation, elements, ...page }, ...this.#dialogsNamed() };
         });
     }
     /** Reads the page's address and title once. */
@@ -155,11 +166,11 @@ export class AgentSession {
         return this.#inLane('look', (problem) => ({ ok: false, failure: problem }), async (signal) => {
             const answer = await this.#call({ kind: 'observePage' }, this.#budget(this.#host.timeouts.action, options), signal);
             if (!answer.result.ok)
-                return { ok: false, failure: this.#host.redactor.redactFailure(answer.result.failure) };
+                return { ok: false, failure: this.#agentFailure(answer.result.failure), ...this.#dialogsNamed() };
             if (answer.result.kind !== 'observePage')
                 return { ok: false, failure: failure('test_error', 'The page answered a look at the page with another kind of answer.') };
             const { url, title } = this.#host.redactor.redactPageLook(answer.result.observation);
-            return { ok: true, page: { sessionId: this.sessionId, observationId: this.#looks.servePage(), url, title } };
+            return { ok: true, page: { sessionId: this.sessionId, observationId: this.#looks.servePage(), url, title }, ...this.#dialogsNamed() };
         });
     }
     /**
@@ -193,7 +204,10 @@ export class AgentSession {
             if (!browserCommand.ok)
                 return { ...notSent(browserCommand.failure), ...located };
             const answer = pin === undefined ? await this.#call(browserCommand.command, deadline.commandTimeoutMs, signal) : await this.#callPinned(browserCommand.command, pin, deadline.commandTimeoutMs, signal);
-            return { result: this.#host.redactor.redactCommandResult(answer.result), input: answer.input, ...located };
+            // A picker nobody waited for is answered by what an agent session can do, which gives no page files.
+            const advised = withPickerAdvice(answer.result, 'This agent session cannot give a page files.');
+            const result = advised.ok ? this.#host.redactor.redactCommandResult(advised) : { ok: false, failure: this.#agentFailure(advised.failure) };
+            return { result, input: answer.input, ...located, ...this.#dialogsNamed() };
         });
     }
     /**
@@ -395,7 +409,7 @@ export class AgentSession {
     async #freshLook(ref, look, deadline, signal) {
         const answer = await this.#call({ kind: 'observe', locator: look.locator }, deadline.commandTimeoutMs, signal);
         if (!answer.result.ok)
-            return { ok: false, failure: this.#host.redactor.redactFailure(answer.result.failure) };
+            return { ok: false, failure: this.#agentFailure(answer.result.failure) };
         if (answer.result.kind !== 'observe')
             return { ok: false, failure: failure('test_error', 'The page answered a look with another kind of answer.') };
         if (this.#looks.generation !== look.generation)
@@ -454,7 +468,7 @@ export class AgentSession {
         }
         const answer = await this.#call({ kind: 'observe', locator }, timeoutMs, signal);
         if (!answer.result.ok)
-            return { ok: false, failure: this.#host.redactor.redactFailure(answer.result.failure) };
+            return { ok: false, failure: this.#agentFailure(answer.result.failure) };
         if (answer.result.kind !== 'observe')
             return { ok: false, failure: failure('test_error', 'The page answered a look with another kind of answer.') };
         return { ok: true, observation: answer.result.observation, ...(answer.result.page === undefined ? {} : { page: answer.result.page }) };
@@ -483,11 +497,28 @@ export class AgentSession {
         if (command.kind === 'swipe' || command.kind === 'nativeKeyboard' || command.kind === 'nativeAlert' || command.kind === 'tap' || command.kind === 'observe' || command.kind === 'observePage') {
             return { ok: false, failure: failure('unsupported', `An agent session does not send ${describeCommand(command)}.`) };
         }
+        // A file input takes files only from a test, whose run keeps what it gives; an agent session keeps none.
+        if (command.kind === 'setInputFiles' || command.kind === 'setChooserFiles')
+            return { ok: false, failure: failure('unsupported', `An agent session does not send ${describeCommand(command)}.`) };
+        // An agent's action is pinned to the one element it read, and a drag acts on two.
+        if (command.kind === 'dragTo')
+            return { ok: false, failure: failure('unsupported', `An agent session does not send ${describeCommand(command)}.`) };
+        // An agent session holds the page it opened for its whole lease, so it never closes it.
+        if (command.kind === 'close')
+            return { ok: false, failure: failure('unsupported', `An agent session does not send ${describeCommand(command)}: its page stays open for its lease.`) };
+        // A screenshot comparison's picture belongs to a test's check, which keeps its baseline; an agent session keeps none.
+        if (command.kind === 'observeScreenshot')
+            return { ok: false, failure: failure('unsupported', `An agent session does not send ${describeCommand(command)}.`) };
+        // An agent session holds no inbox, so it has no message whose code or link a command could name.
+        if (command.kind === 'goto')
+            return typeof command.url === 'string' ? { ok: true, command: { kind: 'goto', url: command.url } } : { ok: false, failure: failure('unsupported', 'An agent session holds no inbox, so Retest opened no link from one.') };
         if (command.kind !== 'fill')
             return { ok: true, command };
         const { locator, value } = command;
         if (typeof value === 'string')
             return { ok: true, command: { kind: 'fill', locator, value } };
+        if (!('secret' in value))
+            return { ok: false, failure: failure('unsupported', 'An agent session holds no inbox, so Retest typed no code from one.') };
         const secrets = this.#host.secrets;
         if (secrets === undefined)
             return { ok: false, failure: failure('usage', `secret(${JSON.stringify(value.secret)}) needs a host that holds secrets. This agent host holds none.`) };
@@ -505,6 +536,7 @@ export class AgentSession {
         const page = this.#page;
         this.#tokens += 1;
         const token = this.#tokens;
+        this.#onPage = describeCommand(command);
         try {
             if (hasDispatch(page))
                 return await page.dispatch(command, timeoutMs, signal, token);
@@ -516,6 +548,31 @@ export class AgentSession {
             const message = `The browser call for ${describeCommand(command)} failed: ${errorMessage(error)}`;
             return { result: { ok: false, failure: failure(looking ? 'session_lost' : 'outcome_unknown', message) }, input: looking ? 'not_sent' : 'unknown' };
         }
+        finally {
+            this.#onPage = undefined;
+        }
+    }
+    // A failure the page gave, redacted, with a dialog Retest answered meanwhile named in words for an agent, which can
+    // wrap nothing in page.dialog(): the dialog's text is redacted before it is quoted.
+    #agentFailure(problem) {
+        return this.#host.redactor.redactFailure(withDialogWords(problem, (text) => this.#host.redactor.redact(text), 'agent'));
+    }
+    // A dialog the page showed is kept for the session's record, and one that showed between calls waits to be named in
+    // the next answer; one that showed during an action is named in that action's own failure.
+    #heardDialog(dialog) {
+        const message = this.#host.redactor.redact(dialog.message);
+        const parts = { type: dialog.type, text: message, answered: dialog.answered, popup: dialog.popup === true, reader: 'agent' };
+        const words = unwaitedDialogMessage(dialog.during ? { ...parts, command: this.#host.redactor.redact(this.#onPage ?? 'act on the page') } : parts);
+        const told = { type: dialog.type, message, answered: dialog.answered, words };
+        this.#answeredDialogs.push(told);
+        if (!dialog.during)
+            this.#dialogsSince.push(told);
+    }
+    // The dialogs not named in an answer yet, for the answer being given, and none from then on.
+    #dialogsNamed() {
+        const named = this.#dialogsSince;
+        this.#dialogsSince = [];
+        return named.length === 0 ? {} : { dialogs: named };
     }
     // The driver's pinned call, with a throw read as the page's answer as for any other call.
     async #callPinned(command, key, timeoutMs, signal) {
@@ -523,12 +580,16 @@ export class AgentSession {
         if (identity === undefined)
             return { result: { ok: false, failure: failure('unsupported', `The ${this.engine} driver cannot pin an element.`) }, input: 'not_sent' };
         this.#tokens += 1;
+        this.#onPage = describeCommand(command);
         try {
             return await identity.dispatchTo(command, key, timeoutMs, signal, this.#tokens);
         }
         catch (error) {
             return { result: { ok: false, failure: failure('outcome_unknown', `The browser call for ${describeCommand(command)} failed: ${errorMessage(error)}`) }, input: 'unknown' };
         }
+        finally {
+            this.#onPage = undefined;
+        }
     }
     #locatorProblem(locator) {
         return locatorProblem(locator) ?? this.#secretLocatorProblem(locator);
@@ -657,9 +718,10 @@ function commandProblem(command) {
         return scrollProblem(command);
     return undefined;
 }
-// What each step of a locator matches against the page, as the runner reads it for the same guard.
+// What each step of a locator matches against the page, the steps of its frames included, as the runner reads it for
+// the same guard.
 function matchedTexts(locator) {
-    return locatorSteps(locator).flatMap((step) => {
+    return everyStep(locator).flatMap((step) => {
         switch (step.by) {
             case 'testId':
                 return [];

package/dist/api/app-page.d.ts

@@ -1,5 +1,7 @@
-import type { LocatorDialect, LocatorRecipe } from '../protocol/locator.ts';
-import type { Alert, Locator, NativeKeyboard, NativeLocatorStep, Page } from './page.ts';
+import type { FrameRecipe, LocatorDialect, LocatorRecipe } from '../protocol/locator.ts';
+import type { AppDialog } from './dialog.ts';
+import type { InboxLink } from './inbox.ts';
+import type { Alert, Download, FileChooser, Frame, Locator, NativeKeyboard, NativeLocatorStep, Page } from './page.ts';
 import type { TestRun } from './test-run.ts';
 import { Secret } from './secret.ts';
 /** The test, app and recipe behind a locator, for assertions. */
@@ -26,7 +28,7 @@ export declare class AppPage implements Page<true> {
     readonly keyboard: AppKeyboard;
     readonly alert: AppAlert;
     constructor(run: TestRun, app: string, dialect?: LocatorDialect);
-    goto(url: string, options?: unknown): Promise<void>;
+    goto(url: string | InboxLink, options?: unknown): Promise<void>;
     getByTestId(id: string): AppLocator;
     getByRole(role: string, options?: unknown): AppLocator;
     getByLabel(text: string | RegExp, options?: unknown): AppLocator;
@@ -37,10 +39,42 @@ export declare class AppPage implements Page<true> {
     goBack(options?: unknown): Promise<void>;
     goForward(options?: unknown): Promise<void>;
     url(): Promise<string>;
+    frame(locator: unknown): AppFrame;
     title(): Promise<string>;
     scroll(delta: unknown, options?: unknown): Promise<void>;
+    fileChooser(action: unknown, options?: unknown): Promise<FileChooser>;
+    download(action: unknown, options?: unknown): Promise<Download>;
+    dialog(action: unknown, options?: unknown): Promise<AppDialog>;
+    popup(action: unknown, options?: unknown): Promise<AppPage>;
+    close(options?: unknown): Promise<void>;
+    route(pattern: unknown, answer: unknown): Promise<void>;
+    unroute(pattern: unknown): Promise<void>;
     swipe(direction: unknown, options?: unknown): Promise<void>;
 }
+/** Where a frame is opened from: the test and app, the frames already on the way to it, and the rules it finds by. */
+type FrameOwner = {
+    readonly run: TestRun;
+    readonly app: string;
+    readonly path: FrameRecipe[] | undefined;
+    readonly dialect: LocatorDialect | undefined;
+};
+/**
+ * A frame of one app's page, by the path of frames that leads to it from the page. Its locators carry that path, so
+ * every command finds the frame again on its way to the element, and find by the rules the page finds by.
+ */
+export declare class AppFrame implements Frame<true> {
+    #private;
+    constructor(owner: FrameOwner & {
+        readonly path: FrameRecipe[];
+    });
+    getByTestId(id: string): AppLocator;
+    getByRole(role: string, options?: unknown): AppLocator;
+    getByLabel(text: string | RegExp, options?: unknown): AppLocator;
+    getByText(text: string | RegExp, options?: unknown): AppLocator;
+    getByPlaceholder(text: string | RegExp, options?: unknown): AppLocator;
+    locator(selector: string): AppLocator;
+    frame(locator: unknown): AppFrame;
+}
 /** A locator on one app's page. */
 export declare class AppLocator implements Locator<true> {
     #private;
@@ -62,6 +96,8 @@ export declare class AppLocator implements Locator<true> {
     check(options?: unknown): Promise<void>;
     uncheck(options?: unknown): Promise<void>;
     scroll(delta: unknown, options?: unknown): Promise<void>;
+    dragTo(target: unknown, options?: unknown): Promise<void>;
+    setInputFiles(files: unknown, options?: unknown): Promise<void>;
     tap(options?: unknown): Promise<void>;
     swipe(direction: unknown, options?: unknown): Promise<void>;
 }

package/dist/api/app-page.d.ts.map

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

package/dist/api/app-page.js

@@ -3,13 +3,19 @@ import { Deadline } from "../protocol/deadline.js";
 import { withLocation } from "../protocol/failures.js";
 import { parseKey } from "../protocol/keys.js";
 import { pageAddress } from "../protocol/locator-checks.js";
+import { framePathOf, sameFramePath } from "../protocol/locator.js";
 import { recordedTitle } from "../protocol/page-facts.js";
 import { isPlainObject } from "../protocol/schema.js";
 import { listWords } from "../shared/list-words.js";
 import { readScrollArgument, readSelectArgument } from "./action-arguments.js";
+import { readOpening, waitForDialog } from "./dialog.js";
+import { readDragOptions } from "./drag.js";
+import { download, fileChooser, setInputFiles } from "./files.js";
 import { formatValue } from "./format-value.js";
+import { inboxCodeReference, inboxLinkReference } from "./inbox.js";
 import { cssRecipe, pickedRecipe, roleRecipe, scopedRecipe, testIdRecipe, textRecipe } from "./locator-recipes.js";
 import { misuse } from "./misuse.js";
+import { route, unroute } from "./route.js";
 import { Secret } from "./secret.js";
 let readTarget;
 let readPageTarget;
@@ -39,6 +45,9 @@ export class AppPage {
     }
     goto(url, options) {
         const location = this.#run.location();
+        const link = inboxLinkReference(url);
+        if (link !== undefined)
+            return this.#run.action(this.#app, { kind: 'goto', url: link }, location, options);
         if (typeof url !== 'string')
             throw misuse(`goto() takes a URL string, received ${formatValue(url)}.`, this.#run);
         return this.#run.action(this.#app, { kind: 'goto', url }, location, options);
@@ -79,6 +88,10 @@ export class AppPage {
             return parsed === null ? '' : pageAddress(parsed);
         });
     }
+    // The frame's element is found from this page, so its locator must be one of this page's own.
+    frame(locator) {
+        return openFrame({ run: this.#run, app: this.#app, path: undefined, dialect: this.#dialect }, locator);
+    }
     title() {
         const location = this.#run.location();
         return this.#run.read(this.#app, 'page.title()', location, () => this.#title(location));
@@ -86,6 +99,31 @@ export class AppPage {
     scroll(delta, options) {
         return scroll({ run: this.#run, app: this.#app }, delta, options);
     }
+    fileChooser(action, options) {
+        return fileChooser({ run: this.#run, app: this.#app }, action, options);
+    }
+    download(action, options) {
+        return download({ run: this.#run, app: this.#app }, action, options);
+    }
+    dialog(action, options) {
+        return waitForDialog({ run: this.#run, app: this.#app }, action, options);
+    }
+    // A popup is an app's page of its own, by the name the parent gave it, and finds by the rules this page finds by.
+    popup(action, options) {
+        const location = this.#run.location();
+        const read = readOpening('popup', this.#run, action, options);
+        const wait = { app: this.#app, label: 'page.popup()', location, timeoutMs: read.timeoutMs, action: read.action };
+        return this.#run.waitForPopup(wait, (popup) => new AppPage(this.#run, popup.app, this.#dialect));
+    }
+    close(options) {
+        return this.#run.action(this.#app, { kind: 'close' }, this.#run.location(), options);
+    }
+    route(pattern, answer) {
+        return route({ run: this.#run, app: this.#app }, pattern, answer);
+    }
+    unroute(pattern) {
+        return unroute({ run: this.#run, app: this.#app }, pattern);
+    }
     swipe(direction, options) {
         return swipe({ run: this.#run, app: this.#app }, direction, options);
     }
@@ -122,6 +160,43 @@ export class AppPage {
         }
     }
 }
+/**
+ * A frame of one app's page, by the path of frames that leads to it from the page. Its locators carry that path, so
+ * every command finds the frame again on its way to the element, and find by the rules the page finds by.
+ */
+export class AppFrame {
+    #owner;
+    constructor(owner) {
+        this.#owner = owner;
+    }
+    getByTestId(id) {
+        return this.#locator(testIdRecipe(id));
+    }
+    getByRole(role, options) {
+        return this.#locator(roleRecipe(role, options));
+    }
+    getByLabel(text, options) {
+        return this.#locator(textRecipe('label', text, options));
+    }
+    getByText(text, options) {
+        return this.#locator(textRecipe('text', text, options));
+    }
+    getByPlaceholder(text, options) {
+        return this.#locator(textRecipe('placeholder', text, options));
+    }
+    locator(selector) {
+        return this.#locator(cssRecipe(selector));
+    }
+    frame(locator) {
+        return openFrame(this.#owner, locator);
+    }
+    #locator(built) {
+        const { run, app, path, dialect } = this.#owner;
+        if ('problem' in built)
+            throw misuse(built.problem, run);
+        return new AppLocator({ run, app, recipe: { ...built.recipe, ...(dialect === undefined ? {} : { dialect }), frame: path } });
+    }
+}
 /** A locator on one app's page. */
 export class AppLocator {
     #target;
@@ -134,6 +209,10 @@ export class AppLocator {
     fill(value, options) {
         const { run, app, recipe } = this.#target;
         const location = run.location();
+        // A code from an inbox is a secret too, so it is told apart first.
+        const code = inboxCodeReference(value);
+        if (code !== undefined)
+            return run.action(app, { kind: 'fill', locator: recipe, value: code }, location, options);
         if (value instanceof Secret)
             return run.action(app, { kind: 'fill', locator: recipe, value: { secret: value.name } }, location, options);
         if (typeof value !== 'string')
@@ -197,6 +276,23 @@ export class AppLocator {
     scroll(delta, options) {
         return scroll(this.#target, delta, options);
     }
+    // The target is another locator of the same test's same app, whose recipe goes with the source's in one command.
+    dragTo(target, options) {
+        const { run, app, recipe } = this.#target;
+        const location = run.location();
+        const into = locatorTarget(target);
+        if (into === undefined)
+            throw misuse(`dragTo() takes the locator of the element to drop on, such as page.getByTestId('done'), received ${formatValue(target)}.`, run);
+        if (into.run !== run || into.app !== app)
+            throw misuse(`dragTo() drops on an element of the same page. The target is a locator of ${into.app === app ? 'another test' : `the app ${into.app}`}.`, run);
+        const read = readDragOptions(options);
+        if (!read.ok)
+            throw misuse(read.problem, run);
+        return run.action(app, { kind: 'dragTo', locator: recipe, target: into.recipe, ...read.steps }, location, read.call);
+    }
+    setInputFiles(files, options) {
+        return setInputFiles(this.#target, files, options);
+    }
     tap(options) {
         const { run, app, recipe } = this.#target;
         return run.action(app, { kind: 'tap', locator: recipe }, run.location(), options);
@@ -282,6 +378,18 @@ export function pageTarget(value) {
 export function withPlaywrightRules(value) {
     return value instanceof AppPage ? (pageByPlaywrightRules?.(value) ?? value) : value;
 }
+// A frame is opened by the locator of its element, made on the page or frame `frame()` is called on, of the same app.
+function openFrame(owner, value) {
+    const target = locatorTarget(value);
+    const { run, app } = owner;
+    if (target === undefined)
+        throw misuse(`frame() takes the locator of an <iframe> or a <frame>, such as page.locator('iframe#payment'), received ${formatValue(value)}.`, run);
+    if (target.run !== run || target.app !== app)
+        throw misuse(`frame() takes a locator of the page it is called on, and this one is of the app ${JSON.stringify(target.app)}.`, run);
+    if (!sameFramePath(target.recipe.frame, owner.path))
+        throw misuse('frame() takes a locator made on the page or frame it is called on, and this one was made on another frame.', run);
+    return new AppFrame({ run, app, path: framePathOf(target.recipe), dialect: owner.dialect });
+}
 // A key `parseKey` refuses is never sent. The parent reads the key again, since it trusts nothing the test process checked.
 function press({ run, app, recipe }, key, options) {
     const location = run.location();