feather-testing-core 0.2.0 → 0.4.0

package/dist/rtl/driver.js

@@ -1,54 +1,79 @@
 import { fireEvent, screen, waitFor, within as rtlWithin, } from "@testing-library/react";
 import userEvent from "@testing-library/user-event";
+import { BrowserOnlyVerbError } from "../errors.js";
 /**
  * RTL adapter implementing the subset of TestDriver that applies in JSDOM.
  * Navigation methods (visit, assertPath, refutePath) are not supported.
+ *
+ * Everything a host adapter is likely to specialize is `protected`: the
+ * label-to-control lookup (`findField`), the scoped-driver factory
+ * (`scoped`), and the `user` / `root` / `lastFormElement` state the verbs
+ * share. Subclass it rather than reimplementing the DSL when an app's markup
+ * needs a different lookup — that is how feather-testing-postgres binds this
+ * driver to markup whose labels are wrapper siblings rather than `htmlFor`
+ * targets.
  */
 export class RTLDriver {
     user;
+    /** The element every query and selector in this driver resolves against. */
+    root;
     container;
     lastFormElement = null;
-    constructor(user, container) {
+    /** Per-lookup timeout in ms; undefined leaves RTL's own default in place. */
+    timeout;
+    constructor(user, container, timeout) {
         this.user = user ?? userEvent.setup();
-        this.container = container ? rtlWithin(container) : screen;
+        this.root = container ?? document.body;
+        this.container = rtlWithin(this.root);
+        this.timeout = timeout;
     }
     rootElement() {
-        return this.container === screen
-            ? document.body
-            : (this.container
-                .container ?? document.body);
+        return this.root;
     }
-    async findFieldByLabelOrPlaceholder(label) {
+    /** Options forwarded to every async query and waitFor call. */
+    waitOpts() {
+        return this.timeout === undefined ? {} : { timeout: this.timeout };
+    }
+    /**
+     * The single label-addressed lookup: every labelled verb goes through it,
+     * so overriding this one method retargets them all.
+     */
+    async findField(label) {
         try {
-            return await this.container.findByLabelText(label);
+            return await this.container.findByLabelText(label, undefined, this.waitOpts());
         }
         catch {
-            return await this.container.findByPlaceholderText(label);
+            return await this.container.findByPlaceholderText(label, undefined, this.waitOpts());
         }
     }
+    /** Subclasses override this so within() yields a driver of their own type. */
+    scoped(element) {
+        return new RTLDriver(this.user, element, this.timeout);
+    }
     async visit() {
         throw new Error("visit() is not available in the RTL adapter. Render the desired component directly.");
     }
     async click(text) {
-        const element = await this.container.findByText(text);
+        const element = await this.container.findByText(text, undefined, this.waitOpts());
         await this.user.click(element);
     }
     async clickLink(text) {
-        const link = await this.container.findByRole("link", { name: text });
+        const link = await this.container.findByRole("link", { name: text }, this.waitOpts());
         await this.user.click(link);
     }
     async clickButton(text) {
-        const button = await this.container.findByRole("button", { name: text });
+        const button = await this.container.findByRole("button", { name: text }, this.waitOpts());
         await this.user.click(button);
     }
     async fillIn(label, value) {
-        const input = await this.findFieldByLabelOrPlaceholder(label);
+        const input = await this.findField(label);
         await this.user.clear(input);
-        await this.user.type(input, value);
+        if (value)
+            await this.user.type(input, value);
         this.lastFormElement = input.closest("form");
     }
     async selectOption(label, option) {
-        const select = await this.container.findByLabelText(label);
+        const select = await this.findField(label);
         const optionEl = Array.from(select.querySelectorAll("option")).find((o) => o.textContent?.trim() === option);
         if (!optionEl) {
             throw new Error(`selectOption('${label}', '${option}'): no <option> with text '${option}' found.`);
@@ -57,21 +82,21 @@ export class RTLDriver {
         this.lastFormElement = select.closest("form");
     }
     async check(label) {
-        const checkbox = await this.container.findByLabelText(label);
+        const checkbox = await this.findField(label);
         if (!checkbox.checked) {
             await this.user.click(checkbox);
         }
         this.lastFormElement = checkbox.closest("form");
     }
     async uncheck(label) {
-        const checkbox = await this.container.findByLabelText(label);
+        const checkbox = await this.findField(label);
         if (checkbox.checked) {
             await this.user.click(checkbox);
         }
         this.lastFormElement = checkbox.closest("form");
     }
     async choose(label) {
-        const radio = await this.container.findByRole("radio", { name: label });
+        const radio = await this.container.findByRole("radio", { name: label }, this.waitOpts());
         await this.user.click(radio);
         this.lastFormElement = radio.closest("form");
     }
@@ -92,14 +117,30 @@ export class RTLDriver {
             this.lastFormElement.requestSubmit();
         }
     }
-    async upload(label, path) {
-        const input = await this.container.findByLabelText(label);
+    async attachFile(label, path) {
+        const input = await this.findField(label);
         // JSDOM has no filesystem access; synthesize a File from the basename.
         const name = path.split(/[\\/]/).pop() ?? path;
         const file = new File([""], name);
         await this.user.upload(input, file);
         this.lastFormElement = input.closest("form");
     }
+    /** @deprecated Older name for {@link RTLDriver.attachFile}. */
+    async upload(label, path) {
+        await this.attachFile(label, path);
+    }
+    /**
+     * Keys are named the Playwright way ('Enter', 'Control+A') and translated
+     * to user-event's keyboard syntax, so one spec reads the same on both
+     * adapters.
+     */
+    async pressKey(key) {
+        await this.user.keyboard(toKeyboardSyntax(key));
+    }
+    async hover(text) {
+        const element = await this.container.findByText(text, undefined, this.waitOpts());
+        await this.user.hover(element);
+    }
     async dropFile(selector, path) {
         const target = this.rootElement().querySelector(selector);
         if (!target) {
@@ -122,7 +163,7 @@ export class RTLDriver {
         throw new Error("refuteHas() with CSS selectors is not recommended in RTL. Use refuteText() instead.");
     }
     async assertText(text) {
-        await this.container.findByText(text);
+        await this.container.findByText(text, undefined, this.waitOpts());
     }
     async refuteText(text) {
         await waitFor(() => {
@@ -130,44 +171,44 @@ export class RTLDriver {
             if (el) {
                 throw new Error(`Expected NOT to find text '${text}', but it was present.`);
             }
-        });
+        }, this.waitOpts());
     }
     async assertValue(label, value) {
-        const field = await this.findFieldByLabelOrPlaceholder(label);
+        const field = await this.findField(label);
         await waitFor(() => {
             const actual = field.value;
             if (actual !== value) {
                 throw new Error(`assertValue('${label}', '${value}'): expected value '${value}', but found '${actual}'.`);
             }
-        });
+        }, this.waitOpts());
     }
     async assertChecked(label) {
-        const checkbox = await this.container.findByLabelText(label);
+        const checkbox = await this.findField(label);
         await waitFor(() => {
             if (!checkbox.checked) {
                 throw new Error(`assertChecked('${label}'): expected checkbox to be checked, but it was not.`);
             }
-        });
+        }, this.waitOpts());
     }
     async refuteChecked(label) {
-        const checkbox = await this.container.findByLabelText(label);
+        const checkbox = await this.findField(label);
         await waitFor(() => {
             if (checkbox.checked) {
                 throw new Error(`refuteChecked('${label}'): expected checkbox NOT to be checked, but it was.`);
             }
-        });
+        }, this.waitOpts());
     }
     async assertSelected(label, optionLabel) {
-        const select = (await this.container.findByLabelText(label));
+        const select = (await this.findField(label));
         await waitFor(() => {
             const selected = select.selectedOptions[0]?.textContent?.trim();
             if (selected !== optionLabel) {
                 throw new Error(`assertSelected('${label}', '${optionLabel}'): expected selected option '${optionLabel}', but found '${selected ?? "(none)"}'.`);
             }
-        });
+        }, this.waitOpts());
     }
     async assertOptions(label, optionLabels) {
-        const select = (await this.container.findByLabelText(label));
+        const select = (await this.findField(label));
         await waitFor(() => {
             const actual = Array.from(select.querySelectorAll("option")).map((o) => o.textContent?.trim() ?? "");
             const matches = actual.length === optionLabels.length &&
@@ -175,7 +216,7 @@ export class RTLDriver {
             if (!matches) {
                 throw new Error(`assertOptions('${label}'): expected options [${optionLabels.join(", ")}], but found [${actual.join(", ")}].`);
             }
-        });
+        }, this.waitOpts());
     }
     async assertPath() {
         throw new Error("assertPath() is not available in the RTL adapter (no real URL in JSDOM).");
@@ -183,16 +224,75 @@ export class RTLDriver {
     async refutePath() {
         throw new Error("refutePath() is not available in the RTL adapter (no real URL in JSDOM).");
     }
+    async assertDownload(_expected, _trigger, _opts) {
+        throw new BrowserOnlyVerbError("assertDownload()", "Assert the request the download would make, or move this case to a " +
+            "Playwright spec where a real browser can accept the file.");
+    }
+    async until(description, predicate, opts) {
+        await waitFor(async () => {
+            if (!(await predicate(this.context()))) {
+                throw new Error(`until: ${description} — condition was still not met.`);
+            }
+        }, {
+            ...this.waitOpts(),
+            ...(opts?.timeout === undefined ? {} : { timeout: opts.timeout }),
+            ...(opts?.interval === undefined ? {} : { interval: opts.interval }),
+        });
+    }
     async step(fn) {
-        await fn({ user: this.user, container: this.container });
+        await fn(this.context());
+    }
+    /** raw() hands over the scoped query object — `within(root)`, i.e. screen
+     * when the driver is unscoped. */
+    async raw(fn) {
+        await fn(this.container);
+    }
+    /** The adapter context handed to step(), until(), and friends. */
+    context() {
+        return { user: this.user, container: this.container };
     }
     async within(selector) {
         const element = this.rootElement().querySelector(selector);
         if (!element)
             throw new Error(`within('${selector}'): element not found`);
-        return new RTLDriver(this.user, element);
+        return this.scoped(element);
     }
     async debug() {
-        screen.debug();
+        screen.debug(this.rootElement());
+    }
+}
+/** Playwright key names -> user-event keyboard syntax. */
+const KEY_ALIASES = {
+    Ctrl: "Control",
+    Cmd: "Meta",
+    Command: "Meta",
+    Space: " ",
+};
+const MODIFIERS = new Set(["Control", "Shift", "Alt", "Meta"]);
+/**
+ * 'Enter' -> '{Enter}', 'a' -> 'a', 'Control+A' -> '{Control>}A{/Control}'.
+ * Printable characters are typed literally with user-event's own `{` and `[`
+ * escapes applied, so a key name never turns into a descriptor by accident.
+ */
+export function toKeyboardSyntax(key) {
+    const parts = key.split("+").map((p) => KEY_ALIASES[p] ?? p);
+    const target = parts.pop();
+    if (target === undefined || target === "") {
+        throw new Error(`pressKey('${key}'): no key to press.`);
+    }
+    const held = parts.filter((p) => MODIFIERS.has(p));
+    if (held.length !== parts.length) {
+        throw new Error(`pressKey('${key}'): '${parts.find((p) => !MODIFIERS.has(p))}' is not a ` +
+            "modifier. Use Control, Shift, Alt, or Meta.");
     }
+    const pressed = target.length === 1
+        ? target.replace(/[{[]/g, (c) => c + c)
+        : `{${target}}`;
+    return (held.map((m) => `{${m}>}`).join("") +
+        pressed +
+        held
+            .slice()
+            .reverse()
+            .map((m) => `{/${m}}`)
+            .join(""));
 }

package/dist/rtl/index.d.ts

@@ -1,7 +1,8 @@
 import { Session } from "../session.js";
-import { type RTLStepContext } from "./driver.js";
+import { type RTLQueries, type RTLStepContext } from "./driver.js";
 export { Session } from "../session.js";
-export { StepError } from "../errors.js";
-export { RTLDriver, type RTLStepContext } from "./driver.js";
-export declare function createSession(): Session<RTLStepContext>;
+export { StepError, BrowserOnlyVerbError } from "../errors.js";
+export { RTLDriver, type RTLQueries, type RTLStepContext, } from "./driver.js";
+export type { AssertHasOptions, DownloadOptions, TestDriver, UntilOptions, UntilPredicate, } from "../types.js";
+export declare function createSession(): Session<RTLStepContext, RTLQueries>;
 //# sourceMappingURL=index.d.ts.map

package/dist/rtl/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rtl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7D,wBAAgB,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC,CAEvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rtl/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAa,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAE9E,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EACL,SAAS,EACT,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,wBAAgB,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,UAAU,CAAC,CAEnE"}

package/dist/rtl/index.js

@@ -1,8 +1,8 @@
 import { Session } from "../session.js";
 import { RTLDriver } from "./driver.js";
 export { Session } from "../session.js";
-export { StepError } from "../errors.js";
-export { RTLDriver } from "./driver.js";
+export { StepError, BrowserOnlyVerbError } from "../errors.js";
+export { RTLDriver, } from "./driver.js";
 export function createSession() {
     return new Session(new RTLDriver());
 }

package/dist/session.d.ts

@@ -1,10 +1,10 @@
-import type { AssertHasOptions, AssertPathOptions, TestDriver } from "./types.js";
-export declare class Session<TContext = unknown> implements PromiseLike<void> {
+import type { AssertHasOptions, AssertPathOptions, DownloadOptions, TestDriver, UntilOptions, UntilPredicate } from "./types.js";
+export declare class Session<TContext = unknown, TNative = unknown> implements PromiseLike<void> {
     private driver;
     private steps;
     private executedSteps;
     private stepIndex;
-    constructor(driver: TestDriver<TContext>);
+    constructor(driver: TestDriver<TContext, TNative>);
     then<TResult1 = void, TResult2 = never>(onfulfilled?: ((value: void) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
     private executeSteps;
     private enqueue;
@@ -18,8 +18,15 @@ export declare class Session<TContext = unknown> implements PromiseLike<void> {
     uncheck(label: string): this;
     choose(label: string): this;
     submit(): this;
+    /** Set a file input, found by its label, to the file at `path`. */
+    attachFile(label: string, path: string): this;
+    /** @deprecated Older name for {@link Session.attachFile}. */
     upload(label: string, path: string): this;
     dropFile(selector: string, path: string): this;
+    /** Press a key on the focused element, e.g. 'Enter' or 'Control+A'. */
+    pressKey(key: string): this;
+    /** Hover the element with this text. */
+    hover(text: string): this;
     assertText(text: string): this;
     refuteText(text: string): this;
     assertValue(label: string, value: string): this;
@@ -31,6 +38,24 @@ export declare class Session<TContext = unknown> implements PromiseLike<void> {
     refuteHas(selector: string, opts?: AssertHasOptions): this;
     assertPath(path: string, opts?: AssertPathOptions): this;
     refutePath(path: string): this;
+    /**
+     * Assert that running `trigger` makes the browser offer a download whose
+     * suggested filename matches `expected`. The trigger is a callback because
+     * the wait has to be armed before the click that starts the download.
+     *
+     * Browser-only: the RTL adapter throws a BrowserOnlyVerbError.
+     */
+    assertDownload(expected: string | RegExp, trigger: (scoped: Session<TContext, TNative>) => Session<TContext, TNative> | PromiseLike<unknown>, opts?: DownloadOptions): this;
+    /**
+     * Wait for a condition instead of sleeping. `description` is mandatory: it
+     * is what the chain trace prints, so a timeout reads
+     * `[FAILED] until: the export finishes` rather than naming a mechanism.
+     *
+     * The predicate receives the adapter's context ({ page, scope } for
+     * Playwright, { user, container } for RTL) and may be sync or async; it
+     * is polled until it returns something truthy or the budget is spent.
+     */
+    until(description: string, predicate: UntilPredicate<TContext>, opts?: UntilOptions): this;
     /**
      * Queue a named custom step. `fn` receives the adapter's context
      * ({ page, scope } for Playwright, { user, container } for RTL), so a
@@ -38,7 +63,19 @@ export declare class Session<TContext = unknown> implements PromiseLike<void> {
      * StepError output like any built-in step.
      */
     step(name: string, fn: (context: TContext) => Promise<unknown>): this;
-    within(selector: string, fn: (scoped: Session<TContext>) => Session<TContext>): this;
+    /**
+     * Drop to the driver itself — Playwright's `page`, RTL's scoped queries —
+     * without leaving the chain. `label` is mandatory and registers as a named
+     * step, so an escape hatch still names intent in the trace instead of
+     * ending it: `[FAILED] raw('drag the card to Done')`.
+     */
+    raw(label: string, fn: (native: TNative) => unknown | Promise<unknown>): this;
+    /**
+     * `fn` must either return the scoped session — so its queued steps run — or
+     * a promise it already awaited. Returning anything else would silently drop
+     * the scoped chain, which is why the callback's return type is not `unknown`.
+     */
+    within(selector: string, fn: (scoped: Session<TContext, TNative>) => Session<TContext, TNative> | PromiseLike<unknown>): this;
     debug(): this;
 }
 //# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAEjB,UAAU,EACX,MAAM,YAAY,CAAC;AAGpB,qBAAa,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAE,YAAW,WAAW,CAAC,IAAI,CAAC;IAKvD,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,SAAS,CAAK;gBAEF,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC;IAEhD,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EACpC,WAAW,CAAC,EACR,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GACnD,IAAI,EACR,UAAU,CAAC,EACP,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GACvD,IAAI,GACP,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAIjB,YAAY;IAuB1B,OAAO,CAAC,OAAO;IAOf,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM7B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM/B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMjD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM3B,MAAM,IAAI,IAAI;IAId,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ9C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM/C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAOxD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI;IAO1D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAO1D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAO1D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAMxD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ9B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAMrE,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,GACnD,IAAI;IAUP,KAAK,IAAI,IAAI;CAGd"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EAEf,UAAU,EACV,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAsBpB,qBAAa,OAAO,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,CACxD,YAAW,WAAW,CAAC,IAAI,CAAC;IAMhB,OAAO,CAAC,MAAM;IAJ1B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,SAAS,CAAK;gBAEF,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC;IAEzD,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EACpC,WAAW,CAAC,EACR,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GACnD,IAAI,EACR,UAAU,CAAC,EACP,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GACvD,IAAI,GACP,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAIjB,YAAY;IAuB1B,OAAO,CAAC,OAAO;IAOf,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM7B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM/B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM1C,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMjD,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI1B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAM3B,MAAM,IAAI,IAAI;IAId,mEAAmE;IACnE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAM7C,6DAA6D;IAC7D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAQzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9C,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI3B,wCAAwC;IACxC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9B,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM/C,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMlC,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAOxD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI;IAO1D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAO1D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAO1D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAMxD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM9B;;;;;;OAMG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,GAAG,MAAM,EACzB,OAAO,EAAE,CACP,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAC/B,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,EACtD,IAAI,CAAC,EAAE,eAAe,GACrB,IAAI;IAcP;;;;;;;;OAQG;IACH,KAAK,CACH,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,EACnC,IAAI,CAAC,EAAE,YAAY,GAClB,IAAI;IASP;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAIrE;;;;;OAKG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAO7E;;;;OAIG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CACF,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAC/B,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,GACrD,IAAI;IAUP,KAAK,IAAI,IAAI;CAGd"}

package/dist/session.js

@@ -1,4 +1,19 @@
 import { StepError } from "./errors.js";
+/**
+ * Verbs that take a human description exist so a failure names intent rather
+ * than mechanics. An empty description defeats that, so it is rejected where
+ * the mistake is — at the call site, before the chain runs.
+ */
+function requireDescription(verb, value) {
+    if (typeof value !== "string" || value.trim() === "") {
+        throw new Error(`feather-testing-core: ${verb}() requires a non-empty description as its ` +
+            "first argument — it is what the chain trace prints when the step fails.");
+    }
+}
+/** How a string-or-regex expectation reads in the chain trace. */
+function describe(expected) {
+    return typeof expected === "string" ? expected : String(expected);
+}
 export class Session {
     driver;
     steps = [];
@@ -62,12 +77,27 @@ export class Session {
     submit() {
         return this.enqueue("submit()", () => this.driver.submit());
     }
+    /** Set a file input, found by its label, to the file at `path`. */
+    attachFile(label, path) {
+        return this.enqueue(`attachFile('${label}', '${path}')`, () => this.driver.attachFile(label, path));
+    }
+    /** @deprecated Older name for {@link Session.attachFile}. */
     upload(label, path) {
-        return this.enqueue(`upload('${label}', '${path}')`, () => this.driver.upload(label, path));
+        return this.enqueue(`upload('${label}', '${path}')`, () => this.driver.upload
+            ? this.driver.upload(label, path)
+            : this.driver.attachFile(label, path));
     }
     dropFile(selector, path) {
         return this.enqueue(`dropFile('${selector}', '${path}')`, () => this.driver.dropFile(selector, path));
     }
+    /** Press a key on the focused element, e.g. 'Enter' or 'Control+A'. */
+    pressKey(key) {
+        return this.enqueue(`pressKey('${key}')`, () => this.driver.pressKey(key));
+    }
+    /** Hover the element with this text. */
+    hover(text) {
+        return this.enqueue(`hover('${text}')`, () => this.driver.hover(text));
+    }
     // --- Assertions ---
     assertText(text) {
         return this.enqueue(`assertText('${text}')`, () => this.driver.assertText(text));
@@ -109,6 +139,32 @@ export class Session {
     refutePath(path) {
         return this.enqueue(`refutePath('${path}')`, () => this.driver.refutePath(path));
     }
+    /**
+     * Assert that running `trigger` makes the browser offer a download whose
+     * suggested filename matches `expected`. The trigger is a callback because
+     * the wait has to be armed before the click that starts the download.
+     *
+     * Browser-only: the RTL adapter throws a BrowserOnlyVerbError.
+     */
+    assertDownload(expected, trigger, opts) {
+        return this.enqueue(`assertDownload('${describe(expected)}')`, () => this.driver.assertDownload(expected, async () => {
+            await trigger(new Session(this.driver));
+        }, opts));
+    }
+    // --- Waiting ---
+    /**
+     * Wait for a condition instead of sleeping. `description` is mandatory: it
+     * is what the chain trace prints, so a timeout reads
+     * `[FAILED] until: the export finishes` rather than naming a mechanism.
+     *
+     * The predicate receives the adapter's context ({ page, scope } for
+     * Playwright, { user, container } for RTL) and may be sync or async; it
+     * is polled until it returns something truthy or the budget is spent.
+     */
+    until(description, predicate, opts) {
+        requireDescription("until", description);
+        return this.enqueue(`until: ${description}`, () => this.driver.until(description, predicate, opts));
+    }
     // --- Escape hatch ---
     /**
      * Queue a named custom step. `fn` receives the adapter's context
@@ -119,7 +175,22 @@ export class Session {
     step(name, fn) {
         return this.enqueue(`step('${name}')`, () => this.driver.step(fn));
     }
+    /**
+     * Drop to the driver itself — Playwright's `page`, RTL's scoped queries —
+     * without leaving the chain. `label` is mandatory and registers as a named
+     * step, so an escape hatch still names intent in the trace instead of
+     * ending it: `[FAILED] raw('drag the card to Done')`.
+     */
+    raw(label, fn) {
+        requireDescription("raw", label);
+        return this.enqueue(`raw('${label}')`, () => this.driver.raw(fn));
+    }
     // --- Scoping ---
+    /**
+     * `fn` must either return the scoped session — so its queued steps run — or
+     * a promise it already awaited. Returning anything else would silently drop
+     * the scoped chain, which is why the callback's return type is not `unknown`.
+     */
     within(selector, fn) {
         return this.enqueue(`within('${selector}')`, async () => {
             const scopedDriver = await this.driver.within(selector);

package/dist/types.d.ts

@@ -7,16 +7,31 @@ export interface AssertHasOptions {
 export interface AssertPathOptions {
     queryParams?: Record<string, string>;
 }
+export interface UntilOptions {
+    /** Overall budget in ms. Defaults to the adapter's own wait timeout. */
+    timeout?: number;
+    /** Gap between polls in ms. Defaults to the adapter's own cadence. */
+    interval?: number;
+}
+export interface DownloadOptions {
+    /** How long to wait for the download to start, in ms. */
+    timeout?: number;
+}
 export interface QueuedStep {
     name: string;
     action: () => Promise<void>;
     index: number;
 }
+/** A condition polled by `until()`; may be sync or async. */
+export type UntilPredicate<TContext> = (context: TContext) => unknown | Promise<unknown>;
 /**
  * TContext is the adapter-specific context handed to custom step() callbacks
  * (e.g. { page, scope } for Playwright, { user, container } for RTL).
+ *
+ * TNative is the adapter's own driving handle, handed to raw() callbacks:
+ * Playwright's `Page`, RTL's scoped query object.
  */
-export interface TestDriver<TContext = unknown> {
+export interface TestDriver<TContext = unknown, TNative = unknown> {
     visit(path: string): Promise<void>;
     click(text: string): Promise<void>;
     clickLink(text: string): Promise<void>;
@@ -27,8 +42,12 @@ export interface TestDriver<TContext = unknown> {
     uncheck(label: string): Promise<void>;
     choose(label: string): Promise<void>;
     submit(): Promise<void>;
-    upload(label: string, path: string): Promise<void>;
+    attachFile(label: string, path: string): Promise<void>;
+    /** @deprecated The older name for {@link TestDriver.attachFile}. */
+    upload?(label: string, path: string): Promise<void>;
     dropFile(selector: string, path: string): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    hover(text: string): Promise<void>;
     assertHas(selector: string, opts?: AssertHasOptions): Promise<void>;
     refuteHas(selector: string, opts?: AssertHasOptions): Promise<void>;
     assertText(text: string): Promise<void>;
@@ -40,8 +59,21 @@ export interface TestDriver<TContext = unknown> {
     assertOptions(label: string, optionLabels: string[]): Promise<void>;
     assertPath(path: string, opts?: AssertPathOptions): Promise<void>;
     refutePath(path: string): Promise<void>;
+    /**
+     * Run `trigger` and assert the browser offers a download whose suggested
+     * filename matches `expected`. Browser-only: the RTL adapter throws.
+     */
+    assertDownload(expected: string | RegExp, trigger: () => Promise<void>, opts?: DownloadOptions): Promise<void>;
+    /**
+     * Poll `predicate` until it returns something truthy, or fail once the
+     * timeout is spent. `description` is what the chain trace prints, so it
+     * has to say what is being awaited in plain language.
+     */
+    until(description: string, predicate: UntilPredicate<TContext>, opts?: UntilOptions): Promise<void>;
     step(fn: (context: TContext) => Promise<unknown>): Promise<void>;
-    within(selector: string): Promise<TestDriver<TContext>>;
+    /** Hand the caller the adapter's own driving handle, untyped by the DSL. */
+    raw(fn: (native: TNative) => unknown | Promise<unknown>): Promise<void>;
+    within(selector: string): Promise<TestDriver<TContext, TNative>>;
     debug(): Promise<void>;
     /**
      * Optional hook: wrap a queued step's execution (e.g. in Playwright's

package/dist/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feather-testing-core",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Phoenix Test-inspired fluent testing DSL for Playwright and React Testing Library",
   "license": "MIT",
   "repository": {
@@ -32,6 +32,11 @@
       "types": "./dist/rtl/index.d.ts",
       "import": "./dist/rtl/index.js",
       "default": "./dist/rtl/index.js"
+    },
+    "./eslint-plugin": {
+      "types": "./dist/eslint-plugin/index.d.ts",
+      "import": "./dist/eslint-plugin/index.js",
+      "default": "./dist/eslint-plugin/index.js"
     }
   },
   "files": [
@@ -57,7 +62,8 @@
     "build": "tsc",
     "test": "vitest run",
     "test:pw": "playwright test",
-    "test:all": "vitest run && playwright test"
+    "test:all": "vitest run && playwright test",
+    "lint": "npm run build && eslint ."
   },
   "devDependencies": {
     "@playwright/test": "^1.58.0",
@@ -67,6 +73,8 @@
     "@types/node": "^26.1.2",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
+    "@typescript-eslint/parser": "^8.68.0",
+    "eslint": "^9.39.5",
     "jsdom": "^28.1.0",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",