@interactors/core 0.3.0 → 1.0.0-rc1.2

package/src/specification.ts

@@ -8,42 +8,20 @@ import { MaybeMatcher } from './matcher';
 
 export type EmptyObject = Record<never, never>;
 
-export interface ExistsAssertionsImplementation {
-
-  /**
-   * An assertion which checks that an element matching the interactor exists.
-   * Throws an error if the element does not exist.
-   *
-   * ## Example
-   *
-   * ``` typescript
-   * await Link('Next').exists();
-   * ```
-   */
-  exists(): ReadonlyInteraction<void> & FilterObject<boolean, Element>;
-
-  /**
-   * An assertion which checks that an element matching the interactor does not
-   * exist. Throws an error if the element exists.
-   *
-   * ## Example
-   *
-   * ``` typescript
-   * await Link('Next').absent();
-   * ```
-   */
-  absent(): ReadonlyInteraction<void> & FilterObject<boolean, Element>;
-}
-
-export interface BaseInteractor<E extends Element, F extends FilterParams<any, any>> {
+/**
+ * Instances of an interactor returned by an {@link InteractorConstructor}, use
+ * this class as its base. They are also extended with any additional actions
+ * defined in their {@link InteractorSpecification}.
+ */
+export interface Interactor<E extends Element, F extends FilterParams<any, any>> {
   /**
    * @hidden
    */
   options: InteractorOptions<E, any, any>;
 
-  /**
-   * @returns a human readable description of this interactor
-   */
+   /**
+    * @returns a human readable description of this interactor
+    */
   description: string;
 
   /**
@@ -78,6 +56,30 @@ export interface BaseInteractor<E extends Element, F extends FilterParams<any, a
    */
   assert(fn: (element: E) => void): ReadonlyInteraction<void>;
 
+  /**
+   * An assertion which checks that an element matching the interactor exists.
+   * Throws an error if the element does not exist.
+   *
+   * ## Example
+   *
+   * ``` typescript
+   * await Link('Next').exists();
+   * ```
+   */
+  exists(): ReadonlyInteraction<void> & FilterObject<boolean, Element>;
+
+  /**
+   * An assertion which checks that an element matching the interactor does not
+   * exist. Throws an error if the element exists.
+   *
+   * ## Example
+   *
+   * ``` typescript
+   * await Link('Next').absent();
+   * ```
+   */
+  absent(): ReadonlyInteraction<void> & FilterObject<boolean, Element>;
+
   /**
    * Checks that there is one element matching the interactor, and that this
    * element matches the given filters. The available filters are defined by
@@ -102,18 +104,6 @@ export interface BaseInteractor<E extends Element, F extends FilterParams<any, a
    */
   is(filters: F): ReadonlyInteraction<void>;
 
-  /**
-   * @hidden
-   */
-  apply: FilterFn<string, Element>;
-}
-
-/**
- * Instances of an interactor returned by an {@link InteractorConstructor}, use
- * this class as its base. They are also extended with any additional actions
- * defined in their {@link InteractorSpecification}.
- */
-export interface Interactor<E extends Element, F extends FilterParams<any, any>> extends BaseInteractor<E, F>, ExistsAssertionsImplementation {
   /**
    * Returns a copy of the given interactor which is scoped to this interactor.
    * When there are multiple matches for an interactor, this makes it possible
@@ -130,10 +120,15 @@ export interface Interactor<E extends Element, F extends FilterParams<any, any>>
    * @returns a scoped copy of the initial interactor
    * @typeParam T the type of the interactor that we are going to scope
    */
-   find<T extends Interactor<any, any>>(interactor: T): T;
+  find<T extends Interactor<any, any>>(interactor: T): T;
+
+  /**
+   * @hidden
+   */
+  apply: FilterFn<string, Element>;
 }
 
-export type ActionFn<E extends Element> = (interactor: Interactor<E, EmptyObject>, ...args: any[]) => Promise<unknown>;
+export type ActionFn<E extends Element, I extends Interactor<E, any>> = (interactor: I, ...args: any[]) => Promise<unknown>;
 
 export type FilterFn<T, E extends Element> = (element: E) => T;
 
@@ -146,11 +141,11 @@ export type FilterDefinition<T, E extends Element> = FilterFn<T, E> | FilterObje
 
 export type Filters<E extends Element> = Record<string, FilterDefinition<unknown, E>>;
 
-export type Actions<E extends Element> = Record<string, ActionFn<E>>;
+export type Actions<E extends Element, I extends Interactor<E, any>> = Record<string, ActionFn<E, I>>;
 
 export type SelectorFn<E extends Element> = (parentElement: Element) => E[];
 
-export type InteractorSpecification<E extends Element, F extends Filters<E>, A extends Actions<E>> = {
+export type InteractorSpecification<E extends Element, F extends Filters<E>, A extends Actions<E, Interactor<E, EmptyObject>>> = {
   /**
    * The CSS selector that this interactor uses to find matching elements
    */
@@ -166,8 +161,8 @@ export type InteractorSpecification<E extends Element, F extends Filters<E>, A e
   locator?: FilterDefinition<string, E>;
 }
 
-export type ActionMethods<E extends Element, A extends Actions<E>> = {
-  [P in keyof A]: A[P] extends ((interactor: Interactor<E, EmptyObject>, ...args: infer TArgs) => Promise<infer TReturn>)
+export type ActionMethods<E extends Element, A extends Actions<E, I>, I extends Interactor<E, any>> = {
+  [P in keyof A]: A[P] extends ((interactor: I, ...args: infer TArgs) => Promise<infer TReturn>)
     ? ((...args: TArgs) => Interaction<TReturn>)
     : never;
 }
@@ -202,11 +197,11 @@ export type FilterParams<E extends Element, F extends Filters<E>> = keyof F exte
  * @typeParam F the filters of this interactor, this is usually inferred from the specification
  * @typeParam A the actions of this interactor, this is usually inferred from the specification
  */
-export interface InteractorConstructor<E extends Element, FP extends FilterParams<any, any>, FM extends FilterMethods<any, any>, AM extends ActionMethods<any, any>> {
+export interface InteractorConstructor<E extends Element, FP extends FilterParams<any, any>, FM extends FilterMethods<any, any>, AM extends ActionMethods<any, any, any>> {
   selector(value: string | SelectorFn<E>): InteractorConstructor<E, FP, FM, AM>;
   locator(value: FilterDefinition<string, E>): InteractorConstructor<E, FP, FM, AM>;
   filters<FR extends Filters<E>>(filters: FR): InteractorConstructor<E, MergeObjects<FP, FilterParams<E, FR>>, MergeObjects<FM, FilterMethods<E, FR>>, AM>;
-  actions<AR extends Actions<E>>(actions: AR): InteractorConstructor<E, FP, FM, MergeObjects<AM, ActionMethods<E, AR>>>;
+  actions<I extends Interactor<E, FP> & FM & AM, AR extends Actions<E, I>>(actions: AR): InteractorConstructor<E, FP, FM, MergeObjects<AM, ActionMethods<E, AR, I>>>;
   extend<ER extends E = E>(name: string): InteractorConstructor<ER, FP, FM, AM>;
 
   /**
@@ -244,7 +239,7 @@ export interface InteractorConstructor<E extends Element, FP extends FilterParam
   (value: MaybeMatcher<string>, filters?: FP): Interactor<E, FP> & FM & AM;
 }
 
-export type InteractorOptions<E extends Element, F extends Filters<E>, A extends Actions<E>> = {
+export type InteractorOptions<E extends Element, F extends Filters<E>, A extends Actions<E, Interactor<E, EmptyObject>>> = {
   name: string;
   specification: InteractorSpecification<E, F, A>;
   locator?: Locator<E>;

package/dist/cjs/dispatch.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.dispatchClick = exports.dispatchKeyUp = exports.dispatchKeyDown = exports.dispatchInput = exports.dispatchChange = void 0;
-function dispatchChange(element) {
-    var _a;
-    let Event = ((_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.Event) || window.Event;
-    return element.dispatchEvent(new Event('change', { bubbles: true, cancelable: false }));
-}
-exports.dispatchChange = dispatchChange;
-function dispatchInput(element, options = {}) {
-    var _a;
-    let InputEvent = ((_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.InputEvent) || window.InputEvent;
-    return element.dispatchEvent(new InputEvent('input', Object.assign({ bubbles: true, cancelable: false }, options)));
-}
-exports.dispatchInput = dispatchInput;
-function dispatchKeyDown(element, options = {}) {
-    var _a;
-    let KeyboardEvent = ((_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.KeyboardEvent) || window.KeyboardEvent;
-    return element.dispatchEvent(new KeyboardEvent('keydown', Object.assign({ bubbles: true, cancelable: true }, options)));
-}
-exports.dispatchKeyDown = dispatchKeyDown;
-function dispatchKeyUp(element, options = {}) {
-    var _a;
-    let KeyboardEvent = ((_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.KeyboardEvent) || window.KeyboardEvent;
-    return element.dispatchEvent(new KeyboardEvent('keyup', Object.assign({ bubbles: true, cancelable: true }, options)));
-}
-exports.dispatchKeyUp = dispatchKeyUp;
-function dispatchClick(element, options = {}) {
-    var _a;
-    let MouseEvent = ((_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.MouseEvent) || window.MouseEvent;
-    return element.dispatchEvent(new MouseEvent('click', Object.assign({ bubbles: true, cancelable: true }, options)));
-}
-exports.dispatchClick = dispatchClick;
-//# sourceMappingURL=dispatch.js.map

package/dist/cjs/dispatch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/dispatch.ts"],"names":[],"mappings":";;;AAAA,SAAgB,cAAc,CAAC,OAAoB;;IACjD,IAAI,KAAK,GAAG,CAAA,MAAA,OAAO,CAAC,aAAa,CAAC,WAAW,0CAAE,KAAK,KAAI,MAAM,CAAC,KAAK,CAAC;IACrE,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC;AAHD,wCAGC;AAED,SAAgB,aAAa,CAAC,OAAoB,EAAE,UAA0B,EAAE;;IAC9E,IAAI,UAAU,GAAG,CAAA,MAAA,OAAO,CAAC,aAAa,CAAC,WAAW,0CAAE,UAAU,KAAI,MAAM,CAAC,UAAU,CAAC;IACpF,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACtH,CAAC;AAHD,sCAGC;AAED,SAAgB,eAAe,CAAC,OAAoB,EAAE,UAA6B,EAAE;;IACnF,IAAI,aAAa,GAAG,CAAA,MAAA,OAAO,CAAC,aAAa,CAAC,WAAW,0CAAE,aAAa,KAAI,MAAM,CAAC,aAAa,CAAC;IAC7F,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1H,CAAC;AAHD,0CAGC;AAED,SAAgB,aAAa,CAAC,OAAoB,EAAE,UAA6B,EAAE;;IACjF,IAAI,aAAa,GAAG,CAAA,MAAA,OAAO,CAAC,aAAa,CAAC,WAAW,0CAAE,aAAa,KAAI,MAAM,CAAC,aAAa,CAAC;IAC7F,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACxH,CAAC;AAHD,sCAGC;AAED,SAAgB,aAAa,CAAC,OAAoB,EAAE,UAA0B,EAAE;;IAC9E,IAAI,UAAU,GAAG,CAAA,MAAA,OAAO,CAAC,aAAa,CAAC,WAAW,0CAAE,UAAU,KAAI,MAAM,CAAC,UAAU,CAAC;IACpF,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACrH,CAAC;AAHD,sCAGC"}

package/dist/cjs/element/fill-in.js

@@ -1,71 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fillIn = void 0;
-const dispatch_1 = require("../dispatch");
-// do a best effort at determining the key code
-function guessCode(letter) {
-    if (letter.match(/^[a-zA-Z]$/)) {
-        return `Key${letter.toUpperCase()}`;
-    }
-    else if (letter.match(/^[0-9]$/)) {
-        return `Digit${letter}`;
-    }
-}
-function clearText(element) {
-    if (element.value.length) {
-        setValue(element, "");
-        dispatch_1.dispatchInput(element, { inputType: 'deleteContentBackward', data: null });
-    }
-}
-function enterText(element, value) {
-    for (let letter of value) {
-        if (dispatch_1.dispatchKeyDown(element, { key: letter, code: guessCode(letter) })) {
-            // don't change the value if the keydown event was stopped
-            setValue(element, element.value + letter);
-            // input is not dispatched if the keydown event was stopped
-            dispatch_1.dispatchInput(element, { inputType: 'insertText', data: letter });
-        }
-        // keyup is always dispatched
-        dispatch_1.dispatchKeyUp(element, { key: letter, code: guessCode(letter) });
-    }
-}
-/**
- * Use the prototype setter of the element in order to set the value, that way any behavior that monkey patches
- * the element itself is circumvented. This has the effect of the value just "magically" appearing on the input
- * element just like it does when the browser sets the value because of the default action of an event.
- * We have to do this because React actually does do this monkey-patching as an optimization. Basically, they
- * short-circuit syncing the react state whenever someone sets input.value and then ignore the next `change` event.
- *
- * See https://github.com/cypress-io/cypress/issues/536
- */
-function setValue(element, value) {
-    let property = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(element), 'value');
-    if (property && property.set) {
-        property.set.call(element, value);
-    }
-    else {
-        // if the value property on the element protoype is not present
-        // then there are worse problems. But this is very typesafe!
-        element.value = value;
-    }
-}
-/**
- * Fill in text into an element by emulating how a user would do it, first
- * focusing the element, then filling in the text letter by letter, generating
- * the appropriate keyboard events.
- *
- * @param element The element to fill in text in
- * @param value The text value to fill in
- */
-function fillIn(element, value) {
-    let originalValue = element.value;
-    element.focus();
-    clearText(element);
-    enterText(element, value);
-    if (originalValue !== value) {
-        dispatch_1.dispatchChange(element);
-    }
-    element.blur();
-}
-exports.fillIn = fillIn;
-//# sourceMappingURL=fill-in.js.map

package/dist/cjs/element/fill-in.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fill-in.js","sourceRoot":"","sources":["../../../src/element/fill-in.ts"],"names":[],"mappings":";;;AAAA,0CAA4F;AAI5F,+CAA+C;AAC/C,SAAS,SAAS,CAAC,MAAc;IAC/B,IAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE;QAC7B,OAAO,MAAM,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;KACrC;SAAM,IAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;QACjC,OAAO,QAAQ,MAAM,EAAE,CAAC;KACzB;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAyB;IAC1C,IAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE;QACvB,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtB,wBAAa,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,uBAAuB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;KAC5E;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAyB,EAAE,KAAa;IACzD,KAAI,IAAI,MAAM,IAAI,KAAK,EAAE;QACvB,IAAG,0BAAe,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;YACrE,0DAA0D;YAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;YAC1C,2DAA2D;YAC3D,wBAAa,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;SACnE;QACD,6BAA6B;QAC7B,wBAAa,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;KAClE;AACH,CAAC;AAGD;;;;;;;;GAQG;AACH,SAAS,QAAQ,CAAC,OAAyB,EAAE,KAAa;IACxD,IAAI,QAAQ,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACxF,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,EAAE;QAC5B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;KACnC;SAAM;QACL,+DAA+D;QAC/D,4DAA4D;QAC5D,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;KACvB;AACH,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,MAAM,CAAC,OAAyB,EAAE,KAAa;IAC7D,IAAI,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;IAElC,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,SAAS,CAAC,OAAO,CAAC,CAAC;IACnB,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE1B,IAAG,aAAa,KAAK,KAAK,EAAE;QAC1B,yBAAc,CAAC,OAAO,CAAC,CAAC;KACzB;IAED,OAAO,CAAC,IAAI,EAAE,CAAC;AACjB,CAAC;AAbD,wBAaC"}

package/dist/cjs/focused.js

@@ -1,47 +0,0 @@
-"use strict";
-/* eslint-disable @typescript-eslint/no-explicit-any */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.blur = exports.focus = exports.focused = void 0;
-/**
- * Helper function for focused filters, returns whether the given element is focused.
- */
-function focused(element) {
-    console.warn("usage of the focused() helper is deprecated, and will be removed from the public API. Instead, switch your interactor to extend the `HTML` interactor to inherit the `focused` filter");
-    return element.ownerDocument.activeElement === element;
-}
-exports.focused = focused;
-/**
- * Helper function for focus action, performs `element.focus()` on the selected element.
- *
- * Can be used with object property value shorthand in your interactor actions.
- *
- * ```js
- * actions: {
- *   focus,
- * }
- * ```
- */
-async function focus(interactor) {
-    console.warn("usage of the focus() helper is deprecated, and will be removed from the public API. Instead, switch your interactor to extend the `HTML` interactor to inherit the `focus()` action");
-    await interactor.perform((element) => element.focus());
-}
-exports.focus = focus;
-;
-/**
- * Helper function for blur action, performs `element.blur()` on the selected element.
- *
- * Can be used with object property value shorthand in your interactor actions.
- *
- * ```js
- * actions: {
- *   focus,
- * }
- * ```
- */
-async function blur(interactor) {
-    console.warn("usage of the blur() helper is deprecated, and will be removed from the public API. Instead, switch your interactor to extend the `HTML` interactor to inherit the `blur()` action");
-    await interactor.perform((element) => element.blur());
-}
-exports.blur = blur;
-;
-//# sourceMappingURL=focused.js.map

package/dist/cjs/focused.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"focused.js","sourceRoot":"","sources":["../../src/focused.ts"],"names":[],"mappings":";AAAA,uDAAuD;;;AAIvD;;GAEG;AACH,SAAgB,OAAO,CAAC,OAAgB;IACtC,OAAO,CAAC,IAAI,CAAC,uLAAuL,CAAC,CAAC;IACtM,OAAO,OAAO,CAAC,aAAa,CAAC,aAAa,KAAK,OAAO,CAAC;AACzD,CAAC;AAHD,0BAGC;AAED;;;;;;;;;;GAUG;AACI,KAAK,UAAU,KAAK,CAAwB,UAA8B;IAC/E,OAAO,CAAC,IAAI,CAAC,qLAAqL,CAAC,CAAC;IACpM,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;AACxD,CAAC;AAHD,sBAGC;AAAA,CAAC;AAEF;;;;;;;;;;GAUG;AACI,KAAK,UAAU,IAAI,CAAwB,UAA8B;IAC9E,OAAO,CAAC,IAAI,CAAC,mLAAmL,CAAC,CAAC;IAClM,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AACvD,CAAC;AAHD,oBAGC;AAAA,CAAC"}

package/dist/cjs/perform.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.perform = void 0;
-function perform(fn) {
-    console.warn('`perform` is deprecated, please use `({ perform }) => perform(...)` instead!');
-    return async (interactor, ...args) => {
-        return await interactor.perform(element => {
-            fn(element, ...args);
-        });
-    };
-}
-exports.perform = perform;
-//# sourceMappingURL=perform.js.map

package/dist/cjs/perform.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"perform.js","sourceRoot":"","sources":["../../src/perform.ts"],"names":[],"mappings":";;;AAGA,SAAgB,OAAO,CAA2E,EAAoC;IACpI,OAAO,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;IAC7F,OAAO,KAAK,EAAE,UAA4B,EAAE,GAAG,IAAO,EAAE,EAAE;QACxD,OAAO,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YACxC,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAPD,0BAOC"}

package/dist/dispatch.d.ts

@@ -1,6 +0,0 @@
-export declare function dispatchChange(element: HTMLElement): boolean;
-export declare function dispatchInput(element: HTMLElement, options?: InputEventInit): boolean;
-export declare function dispatchKeyDown(element: HTMLElement, options?: KeyboardEventInit): boolean;
-export declare function dispatchKeyUp(element: HTMLElement, options?: KeyboardEventInit): boolean;
-export declare function dispatchClick(element: HTMLElement, options?: MouseEventInit): boolean;
-//# sourceMappingURL=dispatch.d.ts.map

package/dist/dispatch.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../src/dispatch.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAG5D;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAGzF;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAG9F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAG5F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAGzF"}

package/dist/element/fill-in.d.ts

@@ -1,12 +0,0 @@
-declare type TextFieldElement = HTMLInputElement | HTMLTextAreaElement;
-/**
- * Fill in text into an element by emulating how a user would do it, first
- * focusing the element, then filling in the text letter by letter, generating
- * the appropriate keyboard events.
- *
- * @param element The element to fill in text in
- * @param value The text value to fill in
- */
-export declare function fillIn(element: TextFieldElement, value: string): void;
-export {};
-//# sourceMappingURL=fill-in.d.ts.map

package/dist/element/fill-in.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fill-in.d.ts","sourceRoot":"","sources":["../../src/element/fill-in.ts"],"names":[],"mappings":"AAEA,aAAK,gBAAgB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAoD/D;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAarE"}

package/dist/esm/dispatch.js

@@ -1,26 +0,0 @@
-export function dispatchChange(element) {
-    var _a;
-    let Event = ((_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.Event) || window.Event;
-    return element.dispatchEvent(new Event('change', { bubbles: true, cancelable: false }));
-}
-export function dispatchInput(element, options = {}) {
-    var _a;
-    let InputEvent = ((_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.InputEvent) || window.InputEvent;
-    return element.dispatchEvent(new InputEvent('input', Object.assign({ bubbles: true, cancelable: false }, options)));
-}
-export function dispatchKeyDown(element, options = {}) {
-    var _a;
-    let KeyboardEvent = ((_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.KeyboardEvent) || window.KeyboardEvent;
-    return element.dispatchEvent(new KeyboardEvent('keydown', Object.assign({ bubbles: true, cancelable: true }, options)));
-}
-export function dispatchKeyUp(element, options = {}) {
-    var _a;
-    let KeyboardEvent = ((_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.KeyboardEvent) || window.KeyboardEvent;
-    return element.dispatchEvent(new KeyboardEvent('keyup', Object.assign({ bubbles: true, cancelable: true }, options)));
-}
-export function dispatchClick(element, options = {}) {
-    var _a;
-    let MouseEvent = ((_a = element.ownerDocument.defaultView) === null || _a === void 0 ? void 0 : _a.MouseEvent) || window.MouseEvent;
-    return element.dispatchEvent(new MouseEvent('click', Object.assign({ bubbles: true, cancelable: true }, options)));
-}
-//# sourceMappingURL=dispatch.js.map

package/dist/esm/dispatch.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dispatch.js","sourceRoot":"","sources":["../../src/dispatch.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,OAAoB;;IACjD,IAAI,KAAK,GAAG,CAAA,MAAA,OAAO,CAAC,aAAa,CAAC,WAAW,0CAAE,KAAK,KAAI,MAAM,CAAC,KAAK,CAAC;IACrE,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,UAA0B,EAAE;;IAC9E,IAAI,UAAU,GAAG,CAAA,MAAA,OAAO,CAAC,aAAa,CAAC,WAAW,0CAAE,UAAU,KAAI,MAAM,CAAC,UAAU,CAAC;IACpF,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACtH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAoB,EAAE,UAA6B,EAAE;;IACnF,IAAI,aAAa,GAAG,CAAA,MAAA,OAAO,CAAC,aAAa,CAAC,WAAW,0CAAE,aAAa,KAAI,MAAM,CAAC,aAAa,CAAC;IAC7F,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1H,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,UAA6B,EAAE;;IACjF,IAAI,aAAa,GAAG,CAAA,MAAA,OAAO,CAAC,aAAa,CAAC,WAAW,0CAAE,aAAa,KAAI,MAAM,CAAC,aAAa,CAAC;IAC7F,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACxH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAoB,EAAE,UAA0B,EAAE;;IAC9E,IAAI,UAAU,GAAG,CAAA,MAAA,OAAO,CAAC,aAAa,CAAC,WAAW,0CAAE,UAAU,KAAI,MAAM,CAAC,UAAU,CAAC;IACpF,OAAO,OAAO,CAAC,aAAa,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACrH,CAAC"}

package/dist/esm/element/fill-in.js

@@ -1,67 +0,0 @@
-import { dispatchChange, dispatchInput, dispatchKeyDown, dispatchKeyUp } from '../dispatch';
-// do a best effort at determining the key code
-function guessCode(letter) {
-    if (letter.match(/^[a-zA-Z]$/)) {
-        return `Key${letter.toUpperCase()}`;
-    }
-    else if (letter.match(/^[0-9]$/)) {
-        return `Digit${letter}`;
-    }
-}
-function clearText(element) {
-    if (element.value.length) {
-        setValue(element, "");
-        dispatchInput(element, { inputType: 'deleteContentBackward', data: null });
-    }
-}
-function enterText(element, value) {
-    for (let letter of value) {
-        if (dispatchKeyDown(element, { key: letter, code: guessCode(letter) })) {
-            // don't change the value if the keydown event was stopped
-            setValue(element, element.value + letter);
-            // input is not dispatched if the keydown event was stopped
-            dispatchInput(element, { inputType: 'insertText', data: letter });
-        }
-        // keyup is always dispatched
-        dispatchKeyUp(element, { key: letter, code: guessCode(letter) });
-    }
-}
-/**
- * Use the prototype setter of the element in order to set the value, that way any behavior that monkey patches
- * the element itself is circumvented. This has the effect of the value just "magically" appearing on the input
- * element just like it does when the browser sets the value because of the default action of an event.
- * We have to do this because React actually does do this monkey-patching as an optimization. Basically, they
- * short-circuit syncing the react state whenever someone sets input.value and then ignore the next `change` event.
- *
- * See https://github.com/cypress-io/cypress/issues/536
- */
-function setValue(element, value) {
-    let property = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(element), 'value');
-    if (property && property.set) {
-        property.set.call(element, value);
-    }
-    else {
-        // if the value property on the element protoype is not present
-        // then there are worse problems. But this is very typesafe!
-        element.value = value;
-    }
-}
-/**
- * Fill in text into an element by emulating how a user would do it, first
- * focusing the element, then filling in the text letter by letter, generating
- * the appropriate keyboard events.
- *
- * @param element The element to fill in text in
- * @param value The text value to fill in
- */
-export function fillIn(element, value) {
-    let originalValue = element.value;
-    element.focus();
-    clearText(element);
-    enterText(element, value);
-    if (originalValue !== value) {
-        dispatchChange(element);
-    }
-    element.blur();
-}
-//# sourceMappingURL=fill-in.js.map

package/dist/esm/element/fill-in.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fill-in.js","sourceRoot":"","sources":["../../../src/element/fill-in.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI5F,+CAA+C;AAC/C,SAAS,SAAS,CAAC,MAAc;IAC/B,IAAG,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE;QAC7B,OAAO,MAAM,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;KACrC;SAAM,IAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;QACjC,OAAO,QAAQ,MAAM,EAAE,CAAC;KACzB;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAyB;IAC1C,IAAG,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE;QACvB,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACtB,aAAa,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,uBAAuB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;KAC5E;AACH,CAAC;AAED,SAAS,SAAS,CAAC,OAAyB,EAAE,KAAa;IACzD,KAAI,IAAI,MAAM,IAAI,KAAK,EAAE;QACvB,IAAG,eAAe,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE;YACrE,0DAA0D;YAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;YAC1C,2DAA2D;YAC3D,aAAa,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;SACnE;QACD,6BAA6B;QAC7B,aAAa,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;KAClE;AACH,CAAC;AAGD;;;;;;;;GAQG;AACH,SAAS,QAAQ,CAAC,OAAyB,EAAE,KAAa;IACxD,IAAI,QAAQ,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACxF,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,EAAE;QAC5B,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;KACnC;SAAM;QACL,+DAA+D;QAC/D,4DAA4D;QAC5D,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;KACvB;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,OAAyB,EAAE,KAAa;IAC7D,IAAI,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;IAElC,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,SAAS,CAAC,OAAO,CAAC,CAAC;IACnB,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAE1B,IAAG,aAAa,KAAK,KAAK,EAAE;QAC1B,cAAc,CAAC,OAAO,CAAC,CAAC;KACzB;IAED,OAAO,CAAC,IAAI,EAAE,CAAC;AACjB,CAAC"}

package/dist/esm/focused.js

@@ -1,41 +0,0 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
-/**
- * Helper function for focused filters, returns whether the given element is focused.
- */
-export function focused(element) {
-    console.warn("usage of the focused() helper is deprecated, and will be removed from the public API. Instead, switch your interactor to extend the `HTML` interactor to inherit the `focused` filter");
-    return element.ownerDocument.activeElement === element;
-}
-/**
- * Helper function for focus action, performs `element.focus()` on the selected element.
- *
- * Can be used with object property value shorthand in your interactor actions.
- *
- * ```js
- * actions: {
- *   focus,
- * }
- * ```
- */
-export async function focus(interactor) {
-    console.warn("usage of the focus() helper is deprecated, and will be removed from the public API. Instead, switch your interactor to extend the `HTML` interactor to inherit the `focus()` action");
-    await interactor.perform((element) => element.focus());
-}
-;
-/**
- * Helper function for blur action, performs `element.blur()` on the selected element.
- *
- * Can be used with object property value shorthand in your interactor actions.
- *
- * ```js
- * actions: {
- *   focus,
- * }
- * ```
- */
-export async function blur(interactor) {
-    console.warn("usage of the blur() helper is deprecated, and will be removed from the public API. Instead, switch your interactor to extend the `HTML` interactor to inherit the `blur()` action");
-    await interactor.perform((element) => element.blur());
-}
-;
-//# sourceMappingURL=focused.js.map

package/dist/esm/focused.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"focused.js","sourceRoot":"","sources":["../../src/focused.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAIvD;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAgB;IACtC,OAAO,CAAC,IAAI,CAAC,uLAAuL,CAAC,CAAC;IACtM,OAAO,OAAO,CAAC,aAAa,CAAC,aAAa,KAAK,OAAO,CAAC;AACzD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAwB,UAA8B;IAC/E,OAAO,CAAC,IAAI,CAAC,qLAAqL,CAAC,CAAC;IACpM,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;AACxD,CAAC;AAAA,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAwB,UAA8B;IAC9E,OAAO,CAAC,IAAI,CAAC,mLAAmL,CAAC,CAAC;IAClM,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AACvD,CAAC;AAAA,CAAC"}

package/dist/esm/perform.js

@@ -1,9 +0,0 @@
-export function perform(fn) {
-    console.warn('`perform` is deprecated, please use `({ perform }) => perform(...)` instead!');
-    return async (interactor, ...args) => {
-        return await interactor.perform(element => {
-            fn(element, ...args);
-        });
-    };
-}
-//# sourceMappingURL=perform.js.map

package/dist/esm/perform.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"perform.js","sourceRoot":"","sources":["../../src/perform.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,OAAO,CAA2E,EAAoC;IACpI,OAAO,CAAC,IAAI,CAAC,8EAA8E,CAAC,CAAC;IAC7F,OAAO,KAAK,EAAE,UAA4B,EAAE,GAAG,IAAO,EAAE,EAAE;QACxD,OAAO,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YACxC,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/focused.d.ts

@@ -1,30 +0,0 @@
-import { Interactor } from './specification';
-/**
- * Helper function for focused filters, returns whether the given element is focused.
- */
-export declare function focused(element: Element): boolean;
-/**
- * Helper function for focus action, performs `element.focus()` on the selected element.
- *
- * Can be used with object property value shorthand in your interactor actions.
- *
- * ```js
- * actions: {
- *   focus,
- * }
- * ```
- */
-export declare function focus<E extends HTMLElement>(interactor: Interactor<E, any>): Promise<void>;
-/**
- * Helper function for blur action, performs `element.blur()` on the selected element.
- *
- * Can be used with object property value shorthand in your interactor actions.
- *
- * ```js
- * actions: {
- *   focus,
- * }
- * ```
- */
-export declare function blur<E extends HTMLElement>(interactor: Interactor<E, any>): Promise<void>;
-//# sourceMappingURL=focused.d.ts.map

package/dist/focused.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"focused.d.ts","sourceRoot":"","sources":["../src/focused.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAGjD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhG;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,IAAI,CAAC,CAAC,SAAS,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/F"}

package/dist/perform.d.ts

@@ -1,3 +0,0 @@
-import { Interactor, FilterParams } from './specification';
-export declare function perform<E extends Element, F extends FilterParams<any, any>, T extends unknown[]>(fn: (element: E, ...args: T) => void): (interactor: Interactor<E, F>, ...args: T) => Promise<void>;
-//# sourceMappingURL=perform.d.ts.map

package/dist/perform.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"perform.d.ts","sourceRoot":"","sources":["../src/perform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE3D,wBAAgB,OAAO,CAAC,CAAC,SAAS,OAAO,EAAE,CAAC,SAAS,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAOnM"}

package/src/dispatch.ts

@@ -1,24 +0,0 @@
-export function dispatchChange(element: HTMLElement): boolean {
-  let Event = element.ownerDocument.defaultView?.Event || window.Event;
-  return element.dispatchEvent(new Event('change', { bubbles: true, cancelable: false }));
-}
-
-export function dispatchInput(element: HTMLElement, options: InputEventInit = {}): boolean {
-  let InputEvent = element.ownerDocument.defaultView?.InputEvent || window.InputEvent;
-  return element.dispatchEvent(new InputEvent('input', Object.assign({ bubbles: true, cancelable: false }, options)));
-}
-
-export function dispatchKeyDown(element: HTMLElement, options: KeyboardEventInit = {}): boolean {
-  let KeyboardEvent = element.ownerDocument.defaultView?.KeyboardEvent || window.KeyboardEvent;
-  return element.dispatchEvent(new KeyboardEvent('keydown', Object.assign({ bubbles: true, cancelable: true }, options)));
-}
-
-export function dispatchKeyUp(element: HTMLElement, options: KeyboardEventInit = {}): boolean {
-  let KeyboardEvent = element.ownerDocument.defaultView?.KeyboardEvent || window.KeyboardEvent;
-  return element.dispatchEvent(new KeyboardEvent('keyup', Object.assign({ bubbles: true, cancelable: true }, options)));
-}
-
-export function dispatchClick(element: HTMLElement, options: MouseEventInit = {}): boolean {
-  let MouseEvent = element.ownerDocument.defaultView?.MouseEvent || window.MouseEvent;
-  return element.dispatchEvent(new MouseEvent('click', Object.assign({ bubbles: true, cancelable: true }, options)));
-}